import type { ExecutionOptions } from "../../ports/AnalysisProvider.js"; import type { JavaScriptRuntimeObservationPort } from "../../ports/javascript/JavaScriptRuntimeObservationPort.js"; import { createJavaScriptRuntimeObservationEvidence } from "./JavaScriptRuntimeObservationEvidence.js"; import type { Evidence } from "../../domain/evidence.js"; import { AnalysisCapabilityUnavailableError, AnalysisOutputError, cancelledBy, } from "../../domain/analysisErrorCore.js"; import type { AnalysisError } from "../../domain/analysisErrorBase.js"; import type { ListJavaScriptRuntimeTargetsInput, ObserveJavaScriptRuntimeInput, JavaScriptRuntimeObservation, } from "../../domain/javascript/javascriptRuntimeObservation.js"; import { err, ok, type Result } from "../../domain/result.js"; import { completeProviderEvidence, keepIncompleteObservation, } from "../ProviderOperationExecution.js"; import { javascriptRuntimeObservationSchema, javascriptRuntimeTargetListSchema, } from "../../domain/javascript/javascriptRuntimeObservation.js"; /** List targets exposed by the explicitly selected loopback Inspector. */ export const listJavaScriptRuntimeTargets = async ( provider: JavaScriptRuntimeObservationPort | undefined, input: ListJavaScriptRuntimeTargetsInput, options: ExecutionOptions = {}, ): Promise> => { const ready = requireProvider(provider, "list_javascript_runtime_targets"); if (!ready.ok) return ready; if (options.signal?.aborted) return err(cancelledBy("list_javascript_runtime_targets", options.signal)); const result = await ready.value.listTargets(input, options); if (!result.ok) return result; const report = javascriptRuntimeTargetListSchema.safeParse(result.value); if (!report.success) return err( new AnalysisOutputError( "list_javascript_runtime_targets", "Inspector returned a malformed target list.", { cause: report.error }, ), ); return runtimeEvidence( "list_javascript_runtime_targets", input, report.data, ready.value.identity(), options, ); }; /** Observe one attach-only Inspector target selected by the request. */ export const observeJavaScriptRuntime = async ( provider: JavaScriptRuntimeObservationPort | undefined, input: ObserveJavaScriptRuntimeInput, options: ExecutionOptions = {}, ): Promise> => { const ready = requireProvider(provider, "observe_javascript_runtime"); if (!ready.ok) return ready; if (options.signal?.aborted) return err(cancelledBy("observe_javascript_runtime", options.signal)); const result = await ready.value.observe(input, options); if (!result.ok) { const partial = result.error.partialObservation; if ( partial !== undefined && !("evidence_id" in partial) && !("kind" in partial) ) { const report = javascriptRuntimeObservationSchema.safeParse(partial); if (report.success) { const mismatch = runtimeSelectionFailure(input, report.data); if (mismatch !== undefined) { result.error.retainSecondaryFailure(mismatch); return err( keepIncompleteObservation( result.error, "observe_javascript_runtime", "Inspector retained a non-JSON incomplete observation.", ), ); } result.error.partialObservation = createJavaScriptRuntimeObservationEvidence( "observe_javascript_runtime", input, report.data, ready.value.identity(), ); return result; } } return err( keepIncompleteObservation( result.error, "observe_javascript_runtime", "Inspector retained a non-JSON incomplete observation.", ), ); } const report = javascriptRuntimeObservationSchema.safeParse(result.value); if (!report.success) return err( new AnalysisOutputError( "observe_javascript_runtime", "Inspector returned a malformed runtime observation.", { cause: report.error }, ), ); const mismatch = runtimeSelectionFailure(input, report.data); if (mismatch !== undefined) return err(mismatch.retainPartialObservation(report.data)); return runtimeEvidence( "observe_javascript_runtime", input, report.data, ready.value.identity(), options, ); }; /** Shape-valid observations still must identify the caller-selected request. */ const runtimeSelectionFailure = ( input: ObserveJavaScriptRuntimeInput, report: JavaScriptRuntimeObservation, ): AnalysisOutputError | undefined => report.target.target_id !== input.target_id || report.capture.observation_ms !== input.observation_ms || report.target.runtime_kind !== (input.runtime_kind ?? "unknown") || report.target.runtime_kind_authority !== (input.runtime_kind === undefined ? "not-declared" : "caller-declared-unverified") ? new AnalysisOutputError( "observe_javascript_runtime", "Inspector changed the selected target, observation window, or caller-declared runtime kind.", ) : undefined; const requireProvider = ( provider: JavaScriptRuntimeObservationPort | undefined, operation: "list_javascript_runtime_targets" | "observe_javascript_runtime", ): Result => provider === undefined ? err( new AnalysisCapabilityUnavailableError( "rea-v8-inspector", operation, "V8 Inspector observation provider is not configured", ), ) : ok(provider); const runtimeEvidence = ( operation: Parameters[0], input: Parameters[1], result: Parameters[2], provider: Parameters[3], options: ExecutionOptions, ): Result => { return completeProviderEvidence( createJavaScriptRuntimeObservationEvidence( operation, input, result, provider, ), options.signal, ); };