mirror of
https://github.com/morluto/rea.git
synced 2026-11-16 19:53:50 +00:00
* refactor(mcp): bind GDB and Cutter tools under external-mutation admission through the shared table GDB start and status, and Cutter discovery, bind as values outside admission; gdb_console and cutter_command bind on the external-mutation evidence kind (gdb_console with delivery detail), and close_gdb_session on owned-cleanup. Tests build their servers through one debugger fixture, and the Rizin lifecycle regressions now run for all three debuggers. * refactor(mcp): bind the session target, context and process capture tools through the shared table (#11640) Value bindings can return a ReducibleValue (alternatives tried when the complete value overflows) or a DetailedFailure (facts delivered beside the error's details). A new query binding reads the analysis its required admission grants. open_binary and open_bundle_resources bind as values; get_navigation_context and inspect_address_context as queries; capture_process_scenario on the analyze kind through an application owner that records its Evidence and residual unknowns.
74 lines
2.5 KiB
TypeScript
74 lines
2.5 KiB
TypeScript
import type { EvidenceLookup } from "../../src/application/EvidenceInputResolver.js";
|
|
import { silentLogger } from "../../src/logger.js";
|
|
import { EvidenceMcpServer } from "../../src/server/EvidenceMcpServer.js";
|
|
import type { ExternalMutationAdmission } from "../../src/server/externalMutationAdmission.js";
|
|
import {
|
|
registerServiceTools,
|
|
type CutterToolOptions,
|
|
type GdbToolOptions,
|
|
type RizinDebugToolOptions,
|
|
type ToolServices,
|
|
} from "../../src/server/serviceToolBindings.js";
|
|
import { createToolResultDelivery } from "../../src/server/toolResult.js";
|
|
|
|
type RecordEvidence = ConstructorParameters<typeof EvidenceMcpServer>[2];
|
|
|
|
/** Session-ledger dependencies a debugger server records into and reads. */
|
|
export interface DebuggerMcpLedger {
|
|
readonly recordEvidence?: RecordEvidence;
|
|
readonly evidenceById?: EvidenceLookup;
|
|
/** Response budget; the delivery default when omitted. */
|
|
readonly maxResponseBytes?: number;
|
|
}
|
|
|
|
/** An MCP server binding only the given debugger services from the shared table. */
|
|
const debuggerMcpServer = (
|
|
name: string,
|
|
services: Partial<ToolServices>,
|
|
{ recordEvidence, evidenceById, maxResponseBytes }: DebuggerMcpLedger,
|
|
): EvidenceMcpServer => {
|
|
const server = new EvidenceMcpServer(
|
|
{ name, version: "1" },
|
|
{},
|
|
recordEvidence,
|
|
createToolResultDelivery(maxResponseBytes),
|
|
);
|
|
registerServiceTools(server, services, {
|
|
logger: silentLogger,
|
|
recordEvidence,
|
|
evidenceById,
|
|
});
|
|
return server;
|
|
};
|
|
|
|
/** An MCP server binding only the Rizin debugger tools over `manager`. */
|
|
export const rizinDebugMcpServer = (
|
|
name: string,
|
|
manager: RizinDebugToolOptions["manager"],
|
|
session?: ExternalMutationAdmission,
|
|
recordEvidence?: RecordEvidence,
|
|
): EvidenceMcpServer =>
|
|
debuggerMcpServer(
|
|
name,
|
|
{ rizinDebug: { manager, session } },
|
|
{ recordEvidence },
|
|
);
|
|
|
|
/** An MCP server binding only the GDB session tools over `manager`. */
|
|
export const gdbMcpServer = (
|
|
name: string,
|
|
manager: GdbToolOptions["manager"],
|
|
session?: ExternalMutationAdmission,
|
|
ledger: DebuggerMcpLedger = {},
|
|
): EvidenceMcpServer =>
|
|
debuggerMcpServer(name, { gdb: { manager, session } }, ledger);
|
|
|
|
/** An MCP server binding only the Cutter tools over `service`. */
|
|
export const cutterMcpServer = (
|
|
name: string,
|
|
service: CutterToolOptions["service"],
|
|
session?: ExternalMutationAdmission,
|
|
recordEvidence?: RecordEvidence,
|
|
): EvidenceMcpServer =>
|
|
debuggerMcpServer(name, { cutter: { service, session } }, { recordEvidence });
|