import { isAbsolute } from "node:path"; import type { ExecutionOptions } from "../AnalysisProvider.js"; import type { BinaryLayoutPort } from "./BinaryLayoutPort.js"; import type { AnalysisError } from "../../domain/analysisErrorBase.js"; import { AnalysisCancelledError, AnalysisInputError, AnalysisOutputError, } from "../../domain/analysisErrorCore.js"; import { createEvidence, type Evidence } from "../../domain/evidence.js"; import { inspectBinaryLayoutInputSchema, binaryLayoutSchema, } from "../../domain/native/binaryLayout.js"; import { analysisInputErrorFromIssues } from "../../domain/inputIssueProjection.js"; import { err, ok, type Result } from "../../domain/result.js"; import { completeProviderEvidence } from "../ProviderOperationExecution.js"; const OPERATION = "inspect_binary_layout"; /** Shared CLI/MCP validation and Evidence composition for offline layout inspection. */ export class BinaryLayoutService { constructor(readonly provider: BinaryLayoutPort) {} close(): Promise { return this.provider.close?.() ?? Promise.resolve(); } /** Bind complete observations to the caller-selected artifact before creating Evidence. */ async inspect( rawInput: unknown, options?: ExecutionOptions, ): Promise> { return this.#inspect(rawInput, options, (input) => this.provider.inspect(input, options), ); } /** Complete the owned one-shot lifecycle before validating and publishing Evidence. */ inspectAndClose( rawInput: unknown, options?: ExecutionOptions, ): Promise> { return this.#inspect(rawInput, options, (input) => this.provider.inspectAndClose(input, options), ); } async #inspect( rawInput: unknown, options: ExecutionOptions | undefined, inspect: ( input: Parameters[0], ) => ReturnType, ): Promise> { if (options?.signal?.aborted) return err( new AnalysisCancelledError(OPERATION, { cause: options.signal.reason, }), ); const input = inspectBinaryLayoutInputSchema.safeParse(rawInput); if (!input.success) return err( analysisInputErrorFromIssues(OPERATION, input.error.issues, rawInput, { cause: input.error, }), ); if (!isAbsolute(input.data.path)) return err( new AnalysisInputError(OPERATION, undefined, [ { path: ["path"], reason: "invalid_format", message: "Expected an absolute filesystem path on this host.", }, ]), ); const inspected = await inspect(input.data); if (!inspected.ok) return inspected; const diagnostics = binaryLayoutSchema.shape.diagnostics.safeParse( inspected.value.diagnostics, ); const outputOptions = diagnostics.success ? { capturedOutput: diagnostics.data } : undefined; const report = binaryLayoutSchema.safeParse(inspected.value); if (!report.success || report.data.artifact.path !== input.data.path) return err( new AnalysisOutputError( OPERATION, "Binary layout provider returned malformed evidence or changed the selected artifact identity.", outputOptions, ), ); const value = report.data; return completeProviderEvidence( createEvidence( { path: value.artifact.path, format: "elf", architecture: "x86_64", sha256: value.artifact.sha256, }, this.provider.identity, { operation: OPERATION, parameters: { path: input.data.path, ...(input.data.pwntools_timeout_ms === undefined ? {} : { pwntools_timeout_ms: input.data.pwntools_timeout_ms }), }, result: value, // The decoded report is the only representation; do not repeat it. rawResult: null, confidence: "observed", limitations: value.limitations, locations: [{ kind: "artifact-path", path: value.artifact.path }], }, ), options?.signal, outputOptions?.capturedOutput, ); } }