mirror of
https://github.com/morluto/rea.git
synced 2026-11-21 06:04:03 +00:00
128 lines
4.7 KiB
TypeScript
128 lines
4.7 KiB
TypeScript
import { crc32 } from "node:zlib";
|
|
import { writeFile } from "node:fs/promises";
|
|
import { join } from "node:path";
|
|
import { expect } from "vitest";
|
|
import { contractNamed } from "../../../src/cli/contractCliDescription.js";
|
|
import { BINARY_DIAGNOSTICS_TOOL_CONTRACTS } from "../../../src/contracts/native/binaryDiagnosticsToolContracts.js";
|
|
import { createServer } from "../../../src/server/createServer.js";
|
|
import {
|
|
debuglinkSection,
|
|
elfDebugCandidateFixture,
|
|
elfDebugLinkFixture,
|
|
FIXTURE_BUILD_ID_HEX,
|
|
FIXTURE_DEBUG_NAME,
|
|
} from "../../../src/native/elf/ElfDebugLink.fixture.js";
|
|
import { createTestBinarySession } from "../../fixtures/binarySession.js";
|
|
import { createTestTempDirectory } from "../../fixtures/temporaryDirectory.js";
|
|
import { mcpTest, type TestMcp } from "../../support/mcp/mcpFixture.js";
|
|
|
|
const debugLinkContract = contractNamed(
|
|
BINARY_DIAGNOSTICS_TOOL_CONTRACTS,
|
|
"inspect_elf_debug_link",
|
|
);
|
|
|
|
const connect = async (mcp: TestMcp) => {
|
|
const session = createTestBinarySession(() => {
|
|
throw new Error("ELF debug-link inspection must not start a deep provider");
|
|
});
|
|
const client = await mcp.connect(createServer({ kind: "session", session }));
|
|
return { client, session };
|
|
};
|
|
|
|
mcpTest(
|
|
"advertises inspect_elf_debug_link and reads an ELF32 big-endian image",
|
|
async ({ mcp }) => {
|
|
const { client, session } = await connect(mcp);
|
|
try {
|
|
const advertised = (await client.listTools()).tools.find(
|
|
(tool) => tool.name === "inspect_elf_debug_link",
|
|
);
|
|
expect(advertised?.annotations).toMatchObject({
|
|
readOnlyHint: false,
|
|
idempotentHint: true,
|
|
});
|
|
const root = await createTestTempDirectory("rea-elf-debug-link-mcp-");
|
|
const path = join(root, "prog");
|
|
await writeFile(
|
|
path,
|
|
elfDebugLinkFixture({ bits: 32, little: false, machine: 20 }),
|
|
);
|
|
const response = await client.callTool({
|
|
name: "inspect_elf_debug_link",
|
|
arguments: { path },
|
|
});
|
|
expect(response.isError, JSON.stringify(response.content)).not.toBe(true);
|
|
const evidence = debugLinkContract.outputSchema.parse(
|
|
response.structuredContent,
|
|
);
|
|
expect(evidence.normalized_result).toMatchObject({
|
|
format: "elf32",
|
|
byte_order: "big",
|
|
machine: 20,
|
|
debuglink: {
|
|
status: "present",
|
|
crc32_hex: "12345678",
|
|
filename: {
|
|
text: FIXTURE_DEBUG_NAME,
|
|
trust: "observed-untrusted",
|
|
},
|
|
},
|
|
build_id: { hex: FIXTURE_BUILD_ID_HEX },
|
|
});
|
|
const identity = evidence.subject.identity;
|
|
expect(identity.kind).toBe("file");
|
|
if (identity.kind === "file")
|
|
expect(identity.architecture).toBe("powerpc");
|
|
expect(evidence.normalized_result.verification).toBeNull();
|
|
expect(evidence.parameters).toEqual({ path });
|
|
const explicit = await client.callTool({
|
|
name: "inspect_elf_debug_link",
|
|
arguments: { path, max_entries: 32 },
|
|
});
|
|
expect(explicit.isError).not.toBe(true);
|
|
const selected = debugLinkContract.outputSchema.parse(
|
|
explicit.structuredContent,
|
|
);
|
|
expect(selected.parameters).toEqual({ path, max_entries: 32 });
|
|
expect(selected.normalized_result).toEqual(evidence.normalized_result);
|
|
expect(selected.evidence_id).not.toBe(evidence.evidence_id);
|
|
} finally {
|
|
await session.close();
|
|
}
|
|
},
|
|
);
|
|
|
|
mcpTest("verifies one caller-selected debug file", async ({ mcp }) => {
|
|
const { client, session } = await connect(mcp);
|
|
try {
|
|
const root = await createTestTempDirectory("rea-elf-debug-link-mcp-match-");
|
|
const candidate = elfDebugCandidateFixture();
|
|
const imagePath = join(root, "prog");
|
|
const candidatePath = join(root, "prog.debug");
|
|
await writeFile(
|
|
imagePath,
|
|
elfDebugLinkFixture({
|
|
debuglink: debuglinkSection(FIXTURE_DEBUG_NAME, crc32(candidate), true),
|
|
}),
|
|
);
|
|
await writeFile(candidatePath, candidate);
|
|
const response = await client.callTool({
|
|
name: "inspect_elf_debug_link",
|
|
arguments: { path: imagePath, candidate_path: candidatePath },
|
|
});
|
|
expect(response.isError, JSON.stringify(response.content)).not.toBe(true);
|
|
const evidence = debugLinkContract.outputSchema.parse(
|
|
response.structuredContent,
|
|
);
|
|
expect(evidence.normalized_result.verification?.status).toBe("matches");
|
|
expect(evidence.normalized_result.candidate?.debug_info).toBe("present");
|
|
const meta = "_meta" in response ? response._meta : undefined;
|
|
if (meta !== undefined)
|
|
expect(meta).toMatchObject({
|
|
provenance: { untrusted_content: true, source: "analysis_target" },
|
|
});
|
|
} finally {
|
|
await session.close();
|
|
}
|
|
});
|