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 { JsonValue } from "../domain/jsonValue.js";
import { err, type Result } from "../domain/result.js";
import type { ProviderStartupDeadline } from "../process/ProviderDeadline.js";
import type { GhidraRequestOptions } from "./GhidraClientTypes.js";
import {
GHIDRA_STARTUP_DEADLINE_ELAPSED,
type GhidraSessionError,
type GhidraSessionFailureFactory,
} from "./GhidraSessionError.js";
import type { GhidraSessionInfo } from "./GhidraSessionValues.js";
/** Inputs needed to complete the post-connection bridge handshake. */
export interface GhidraStartupHandshakeOptions {
readonly deadline: ProviderStartupDeadline;
readonly request: (
method: string,
params: JsonValue,
options: GhidraRequestOptions,
) => Promise<Result<JsonValue, GhidraSessionError>>;
readonly parseSessionInfo: (
value: JsonValue,
) => Result<GhidraSessionInfo, GhidraSessionError>;
readonly failure: GhidraSessionFailureFactory;
readonly startupTimeoutMs: number;
}
/** Ping and validate the bridge after its socket is attached. */
export async function completeGhidraStartupHandshake(
options: GhidraStartupHandshakeOptions,
): Promise<Result<GhidraSessionInfo, GhidraSessionError>> {
const ping = await options.request(
"ping",
{},
{
signal: options.deadline.signal,
timeoutMs: options.deadline.remainingMs(),
},
);
if (!ping.ok) {
const failure =
ping.error.kind === "cancelled" &&
options.deadline.interruption !== undefined
? interruptionFailure(options)
: ping.error;
return err(failure);
}
const parsed = options.parseSessionInfo(ping.value);
if (!parsed.ok || parsed.value.analysis_timed_out) {
const failure = parsed.ok
? options.failure(
"analysis_timeout",
"Ghidra auto-analysis reached its per-file deadline",
)
: parsed.error;
return err(failure);
}
return parsed;
}
const interruptionFailure = (
options: GhidraStartupHandshakeOptions,
): GhidraSessionError =>
options.deadline.interruption === "cancelled"
? options.failure(
"cancelled",
"Ghidra startup was cancelled",
options.deadline.signal.reason,
{ cancellation: { reason: options.deadline.signal.reason } },
)
: options.failure("timeout", GHIDRA_STARTUP_DEADLINE_ELAPSED, undefined, {
timeoutMs: options.startupTimeoutMs,
});