import type { InvestigationRecordPort } from "../investigation/InvestigationRecordPort.js"; import type { ExecutableFormatHint } from "../../domain/dosCom.js"; import type { BinaryTarget } from "../../domain/binaryTargetTypes.js"; import type { JsonValue } from "../../domain/jsonValue.js"; import type { AnalysisSnapshot } from "../../domain/analysisSnapshot.js"; import type { AnalysisProfileCommitment } from "../../domain/analysisProfile.js"; import type { AnalysisProviderSelector } from "../../contracts/providerSelection.js"; import type { AnalysisError } from "../../domain/analysisErrorBase.js"; import type { Result } from "../../domain/result.js"; import type { EvidenceIntegrityError } from "../../domain/evidenceErrors.js"; import type { WorkflowSnapshotRecordInput } from "./BinarySessionRecords.js"; import type { AnalysisOperation, AnalysisOperationPort, ExecutionOptions, ProviderIdentity, } from "../AnalysisProvider.js"; /** Receipt for an atomically saved snapshot followed by provider cleanup. */ export interface SavedAnalysisSnapshot { readonly path: string; readonly bytes: number; /** Eligible primitive query bindings. */ readonly primitive_entries: number; /** Eligible composed workflow bindings, separate from primitive queries. */ readonly workflow_entries: number; /** All retained Evidence records, including observations without a replay binding. */ readonly evidence_records: number; } /** Target lifecycle used by CLI and MCP without exposing a concrete provider. */ export interface BinarySessionPort extends AnalysisOperationPort, InvestigationRecordPort { /** Hold the active target binding through a complete composed operation. */ withAdmittedAnalysis( operationName: string, signal: AbortSignal | undefined, operation: (analysis: AnalysisOperationPort) => Promise, ): Promise>; open( path: string, options?: { readonly signal?: AbortSignal; readonly targetKind?: BinaryTarget["kind"]; readonly formatHint?: ExecutableFormatHint; readonly snapshot?: AnalysisSnapshot; readonly providerId?: AnalysisProviderSelector; }, ): Promise>; close( options?: Pick & { readonly retainProviderDocuments?: boolean; }, ): Promise>; /** Save a snapshot and close while excluding later provider requests. */ closeWithSnapshot( path: string, overwrite: boolean, options?: Pick, ): Promise>; status(): JsonValue; activeTarget(): BinaryTarget | undefined; exportAnalysisSnapshot(): Result; importAnalysisSnapshot( snapshot: AnalysisSnapshot, ): Result; providerIdentity(operation?: AnalysisOperation): ProviderIdentity; analysisProfile( operation?: AnalysisOperation, ): AnalysisProfileCommitment | undefined; allowsSnapshotReplay(operation: AnalysisOperation): boolean; recordWorkflowSnapshot( input: WorkflowSnapshotRecordInput, ): Result; onAvailabilityChanged?(listener: () => void | Promise): () => void; onAnalysisSnapshotChanged?(listener: () => void | Promise): () => void; }