Reverse engineer anything with agents, from app behavior down to native binaries.
TypeScript agent-skillsai-agentsbinary-analysisclaude-codeclicodexcordisdecompilerdeveloper-toolsdshdsh-pluginghidrahopperllmmcpmodel-context-protocolreareverse-engineeringstatic-analysistouhou
import type { ExecutionOptions } from "../AnalysisProvider.js";
import { createAnalysisExecutionEvidence } from "../../domain/analysisObservation.js";
import type { FirmwareAnalysisPort } from "./FirmwareAnalysisPort.js";
import {
firmwareRequestSchema,
firmwareExecutionBudgetSchema,
DEFAULT_FIRMWARE_ANALYSIS_TIMEOUT_MS,
type FirmwareOperation,
} from "../../domain/firmware/firmwareAnalysis.js";
import {
AnalysisCancelledError,
AnalysisOutputError,
} from "../../domain/analysisErrorCore.js";
import type { AnalysisError } from "../../domain/analysisErrorBase.js";
import type { Evidence } from "../../domain/evidence.js";
import { analysisInputErrorFromIssues } from "../../domain/inputIssueProjection.js";
import { err, type Result } from "../../domain/result.js";
import { completeProviderEvidence } from "../ProviderOperationExecution.js";
/** Shared CLI/MCP validation and Evidence composition for arbitrary firmware files. */
export class FirmwareAnalysisService {
constructor(readonly provider: FirmwareAnalysisPort) {}
close(): Promise<void> {
return this.provider.close?.() ?? Promise.resolve();
}
/** Execute an explicit inspection or extraction and preserve its producing identity. */
async execute(
operation: FirmwareOperation,
input: unknown,
options?: ExecutionOptions,
): Promise<Result<Evidence, AnalysisError>> {
if (options?.signal?.aborted === true)
return err(
new AnalysisCancelledError(operation, { cause: options.signal.reason }),
);
const parsed = firmwareRequestSchema.safeParse({ operation, input });
if (!parsed.success)
return err(
analysisInputErrorFromIssues(
operation,
parsed.error.issues,
{ operation, input },
{ cause: parsed.error },
),
);
const executed = await this.provider.execute(parsed.data, options);
if (!executed.ok) return executed;
const execution = executed.value;
if (execution.subject == null)
return err(
new AnalysisOutputError(
operation,
"Firmware execution did not bind its source artifact",
),
);
// Providers own normalized facts. Check only fresh execution metadata here,
// without reparsing/copying potentially large extraction inventories.
const budget = firmwareExecutionBudgetSchema.safeParse(execution.result);
if (
!budget.success ||
budget.data.analysis_timeout_ms !==
(parsed.data.input.analysis_timeout_ms ??
DEFAULT_FIRMWARE_ANALYSIS_TIMEOUT_MS)
)
return err(
new AnalysisOutputError(
operation,
"Firmware execution did not retain its selected analysis budget",
),
);
return completeProviderEvidence(
createAnalysisExecutionEvidence(
operation,
parsed.data.input,
execution,
"observed",
),
options?.signal,
);
}
}