mirror of
https://github.com/morluto/rea.git
synced 2026-10-26 17:35:11 +00:00
Kaoru0822andClaude Opus 5.5
5156ba44c5
inspect_binary_layout accepts the same optional detail input as analyze_javascript_application. The default complete delivery is unchanged; detail "summary" retains the complete layout Evidence in the session and returns its inspect_analysis_view summary, whose parent_evidence_id selects sections, symbols, mitigations or linkage later. Both tools share one detail schema and output projection. Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
65 lines
4.0 KiB
TypeScript
65 lines
4.0 KiB
TypeScript
import {
|
|
inspectRecordedCrashInputSchema,
|
|
recordedCrashSchema,
|
|
} from "../../domain/native/recordedCrash.js";
|
|
import {
|
|
inspectBinaryLayoutInputSchema,
|
|
binaryLayoutSchema,
|
|
} from "../../domain/native/binaryLayout.js";
|
|
import {
|
|
analysisDetailOutputSchemaOf,
|
|
analysisDetailSchema,
|
|
} from "../analysisDetail.js";
|
|
import type { ToolContract } from "../toolContractTypes.js";
|
|
import { toolContractMetadata } from "../toolEffects.js";
|
|
import { evidenceResultOf } from "../toolOutputSchemaPrimitives.js";
|
|
|
|
/** Caller-selected delivery of completed binary layout Evidence. */
|
|
export const inspectBinaryLayoutRequestSchema =
|
|
inspectBinaryLayoutInputSchema.extend({ detail: analysisDetailSchema });
|
|
|
|
/** Offline binary diagnostics are independent of macOS process/UI providers. */
|
|
export const BINARY_DIAGNOSTICS_TOOL_CONTRACTS = [
|
|
{
|
|
name: "inspect_binary_layout",
|
|
...toolContractMetadata("inspect_binary_layout"),
|
|
kind: "native-provider",
|
|
description:
|
|
"Inspect an explicit local binary without launching it as a host process. Returns file-backed section/segment ranges, linked addresses, original symbol/REL/RELA table identities, complete encoded RELR tables and upstream-derived offsets with unknown per-word locations/addends, raw name bytes, dependency/interpreter names and static mitigation inferences inline with artifact SHA-256 Evidence. Initial profile: ELF64 x86-64 little-endian EXEC/DYN/REL on Linux x64 via caller-supplied Python with unchanged pwntools 4.15.0, pyelftools 0.33 and Unicorn 2.1.2. Runtime addresses/library paths, overall relocation inventory completeness and complete derived GOT/PLT coverage remain unknown. Zero executable entry values mean absence; relocatable entries are not applicable. Upstream can emulate PLT instructions with Unicorn for derived static maps. Uses bounded complete output and owned temporary files/processes; malformed, unsupported or oversized objects return no partial success. Select detail summary to retain the complete layout Evidence in this session and receive only its summary view, then inspect sections, symbols, mitigations or linkage with inspect_analysis_view.",
|
|
inputSchema: inspectBinaryLayoutRequestSchema,
|
|
outputSchema: analysisDetailOutputSchemaOf(binaryLayoutSchema),
|
|
examples: [
|
|
{
|
|
title: "Inspect ELF linked and file layout",
|
|
input: { path: "/artifacts/application.elf" },
|
|
},
|
|
{
|
|
title: "Retain the complete layout and return its summary view",
|
|
input: { path: "/artifacts/application.elf", detail: "summary" },
|
|
},
|
|
],
|
|
},
|
|
{
|
|
name: "inspect_recorded_crash",
|
|
...toolContractMetadata("inspect_recorded_crash"),
|
|
kind: "native-provider",
|
|
description:
|
|
"Inspect a supplied Linux ELF64 amd64 little-endian core without launching its target or attaching to any live PID. Returns all recorded segments, raw note owners/descriptors and source ranges, every Linux CORE PRSTATUS thread/register and SIGINFO fields inline with SHA-256 Evidence. Historical PID is recorded metadata; current process/file identity, note coverage and signal-thread associations stay unknown. Optionally add derived core-only GDB/pwndbg mapping candidates through explicit BYO configuration; zero map flags mean unknown permissions. Uses the same stable snapshot for both stages, bounded complete output and owned cleanup. Initial Linux x64 profile: unchanged pwntools 4.15.0/pyelftools 0.33/Unicorn 2.1.2; optional unchanged pwndbg 2026.09.15. No implicit executable/library pairing, GDB command language, host configuration changes or dependency installation.",
|
|
inputSchema: inspectRecordedCrashInputSchema,
|
|
outputSchema: evidenceResultOf(recordedCrashSchema),
|
|
examples: [
|
|
{
|
|
title: "Inspect recorded registers and signal evidence",
|
|
input: { path: "/artifacts/crash.core" },
|
|
},
|
|
{
|
|
title: "Add core-only debugger mapping candidates",
|
|
input: {
|
|
path: "/artifacts/crash.core",
|
|
include_debugger_context: true,
|
|
},
|
|
},
|
|
],
|
|
},
|
|
] as const satisfies readonly ToolContract[];
|