REA MCP tools
All 139 tools exposed by REA 6.3.0 at https://rea.ahmad.wtf/mcp, generated from the server's live tools/list.
Files must be inside the container: put them in ./targets and refer to them as /targets/<file>.
Not everything works in this container: it only has Ghidra. The 21 tools whose description mentions
Hopper (cursor/document tools such as current_address) and the browser and macOS-specific tools will
return unsupported here.
Every call returns structured output with an evidence_id; pass that to evidence tools to inspect or cite results.
Index
| # | Tool | Summary |
|---|---|---|
| 1 | annotate_native_function |
Atomically update one function name and/or entry comments, read them back, and return a refreshed complete function dossier |
| 2 | inspect_native_load_image |
Verify the provider's loaded DOS MZ or explicitly selected COM image against its immutable target snapshot: complete original/modified source-byte digests, header/module file mappings and memory digests, relocations and external entry |
| 3 | inspect_native_data_type |
Inspect one recovered type by exact database category path or defined typed data address |
| 4 | inspect_native_instruction |
Inspect one exact instruction address: decoded bytes, mnemonic, ordered operand tokens, flow and typed references |
| 5 | resolve_native_call_targets |
Resolve one explicit static call site using typed provider call references |
| 6 | address_name |
Resolve the primary analyzed name at a code or data address |
| 7 | comment |
Read the regular analysis comment at an address, defaulting to the current cursor |
| 8 | current_address |
Return Hopper's current cursor address for the selected document |
| 9 | current_procedure |
Return the analyzed procedure containing Hopper's current cursor |
| 10 | current_document |
Return the document currently selected by REA's Hopper bridge |
| 11 | goto_address |
Move Hopper's GUI cursor to a mapped address and return the observed cursor address |
| 12 | inline_comment |
Read the inline instruction comment at an address, defaulting to the current cursor |
| 13 | list_bookmarks |
List every bookmark in the selected Hopper document as address and name pairs; unnamed bookmarks retain a null name |
| 14 | list_documents |
List provider program or document identities |
| 15 | list_names |
List every analyzed memory and external symbol as address/value pairs |
| 16 | list_procedures |
List every analyzed procedure as address/value pairs after provider analysis |
| 17 | list_segments |
List segments or memory blocks using exclusive end addresses |
| 18 | list_strings |
List every provider-defined string object, or filter to one address, as address/value pairs with encoding, terminator status, and byte length when available |
| 19 | next_address |
Return the next analyzed object address after an explicit address or current cursor |
| 20 | prev_address |
Return the previous analyzed object start before an explicit address or current cursor |
| 21 | procedure_address |
Resolve an unambiguous procedure symbol name or provider-normalized address to its canonical entry address |
| 22 | procedure_assembly |
Return assembly for one analyzed procedure identified by symbol or hexadecimal address |
| 23 | procedure_callees |
Return the provider's resolved direct callees for one procedure identified by symbol or address |
| 24 | procedure_callers |
Return the provider's resolved direct callers for one procedure identified by symbol or address |
| 25 | procedure_info |
Return provider metadata for one procedure identified by symbol or address: entrypoint, signature, locals, size, block count, and complete inclusive body ranges when observed |
| 26 | read_function_instructions |
Return every raw instruction for one analyzed procedure |
| 27 | read_bytes |
Read analyzed bytes from one provider-normalized virtual address |
| 28 | address_to_file_offset |
Map one provider-normalized virtual address to its original nonnegative file offset |
| 29 | procedure_references |
Return every raw incoming or outgoing reference edge for one procedure |
| 30 | procedure_pseudo_code |
Decompile one analyzed procedure by symbol name or provider-normalized address |
| 31 | resolve_containing_procedure |
Resolve an arbitrary address, including an interior instruction or exact external entry, to its provider-analyzed containing procedure |
| 32 | search_procedures |
Search every analyzed procedure name using literal matching by default or regex when requested |
| 33 | search_strings |
Search every analyzed string object using literal matching by default or regex when requested |
| 34 | set_address_name |
Assign an analyst name to one mapped hexadecimal address and report whether the native edit succeeded and exact readback matched |
| 35 | set_addresses_names |
Assign analyst names to multiple mapped addresses in one call and return per-address edit/readback success booleans |
| 36 | set_bookmark |
Create or replace a bookmark at a mapped hexadecimal address and report success |
| 37 | set_comment |
Write a regular analysis comment at a hexadecimal address and return whether readback matched |
| 38 | set_inline_comment |
Write an inline instruction comment at a hexadecimal address and return whether readback matched |
| 39 | unset_bookmark |
Remove the bookmark at a mapped hexadecimal address and return whether it is absent |
| 40 | xrefs |
Return analyzed references to a code or data address |
| 41 | trace_native_values |
Trace a bounded static dependency graph from one explicit native procedure |
| 42 | inspect_native_dispatch_metadata |
Inspect the bound provider's name inventory for Objective-C class/method symbols and Swift mangled symbols, returning at most max_records decoded names |
| 43 | get_objc_classes |
Discover and deduplicate Objective-C class labels, optionally filtering by literal substring |
| 44 | get_objc_protocols |
Discover and deduplicate Objective-C and Swift protocol labels |
| 45 | batch_decompile |
Decompile each explicit procedure symbol or address concurrently |
| 46 | get_call_graph |
Resolve one symbol or address to its canonical procedure entry, then traverse the bound provider's caller or callee relationships until the reachable graph is exhausted |
| 47 | analyze_swift_types |
Categorize analyzed Swift procedure names using their manglings or same-address Swift symbol aliases |
| 48 | find_xrefs_to_name |
Resolve an exact name against the bound provider's name inventory and return a resolved or unresolved result |
| 49 | binary_overview |
Return native-binary metadata, every segment with its length, and exhaustive procedure/string counts |
| 50 | analyze_function |
Build a dossier for one native function identified by symbol or provider-returned address |
| 51 | inspect_native_api |
Analyze a native API boundary in one function identified by symbol or provider-returned address |
| 52 | trace_feature |
Trace the complete literal query, preserving spaces, through every matching string and procedure, their xrefs, and truthful containing-procedure resolution |
| 53 | trace_call_path |
Resolve start and optional goal symbols or addresses to canonical procedure entries, then trace direct callers or callees until the graph is exhausted or the goal is reached |
| 54 | trace_native_ui_action |
Trace one unique compiled UI action, object ID, native symbol or exact function address through authored connections, encoded or symbolized Objective-C handlers, and bounded static call references |
| 55 | observe_native_ui |
Observe an already-running native app by PID and window ID, bound to the active Mach-O target |
| 56 | capture_native_ui_scenario |
Run selected-element press, increment/decrement scroll, AXValue text entry and bounded wait steps in one exact native app window |
| 57 | observe_native_calls |
Launch the active Mach-O as an owned process under LLDB and record each entry into caller-selected functions or Objective-C methods: thread, module, symbol, load and file address, raw argument registers, selector, receiver class and optional caller frames |
| 58 | inspect_macho |
Inspect Mach-O slices, load commands, imports, exports, dependencies, build metadata, segments, sections, permissions, and exact command provenance without launching Hopper |
| 59 | inspect_signature |
Inspect the active artifact's code-signing identity, hashes, authorities, requirements, entitlements, hardened-runtime state, and exact command provenance |
| 60 | inspect_plist |
Parse Info.plist from the active artifact by default, or pass any local plist path |
| 61 | list_architectures |
List thin or universal Mach-O slices with offsets, sizes, alignment, explicit coverage, and native-tool provenance |
| 62 | demangle_swift |
Demangle an ordered list of single-line Swift symbols without requiring Hopper |
| 63 | inspect_artifact |
Inspect an active archive or application package in one call |
| 64 | extract_artifact |
Extract all regular files from the active archive or application package into a fresh temporary directory chosen by REA |
| 65 | decode_interface_builder |
Decode compiled storyboard and nib archives inside the active Apple app bundle, including keyed property lists and NIBArchive object tables, into a bounded object, hierarchy, and connection graph |
| 66 | inspect_keyed_archive |
Inspect one Foundation NSKeyedArchiver plist in the active app bundle as original object-table nodes, class descriptors, named roots, and UID edges |
| 67 | inspect_asset_catalog |
Inspect compiled Assets.car metadata in an active Apple app bundle |
| 68 | trace_dylib_resolution |
Trace how dyld would resolve each Mach-O dylib load for the active Mach-O, or for every executable in the active .app bundle (the main app, XPC services, extensions, login items, helpers) |
| 69 | inspect_managed_artifact |
Open and classify an explicit managed PE/CLI path, or inspect the active managed target, then inventory exact assembly/module identity, target framework evidence, references, resources, and custom attributes without loading or executing target code |
| 70 | inspect_managed_members |
Inspect PE/CLI metadata members, signatures, raw CIL hashes, decoded-instruction-tuple hashes, separately reported exception regions, call edges, and field-access anchors without loading or executing target code |
| 71 | inspect_managed_native_boundaries |
Inspect PE/CLI ModuleRef, ImplMap/PInvoke declarations, CLI native-header indicators, and non-IL method implementation flags without loading or executing target code |
| 72 | compare_managed_members |
Compare two authenticated inspect_managed_members Evidence records using unique-only tiers: exact CIL/signature, exact declared type, name, and raw signature (decoded or not), and decoded structural method shape |
| 73 | verify_managed_native_boundaries |
Verify managed P/Invoke/native-boundary declarations against authenticated native export or function Evidence without executing managed code or translating managed metadata tokens into native addresses |
| 74 | import_managed_reconstruction |
Import decompiler-produced managed reconstruction against authenticated inspect_managed_members Evidence |
| 75 | project_managed_application_graph |
Project authenticated managed artifact, member, and native-boundary Evidence into the provider-neutral application graph without executing managed code, loading assemblies, or translating managed metadata tokens to native addresses |
| 76 | inspect_android_package |
Inspect a local APK's package, SDK and permission declarations, decoded manifest and class/resource counts |
| 77 | search_android_classes |
Search complete decompiler class names in an explicit local APK by case-sensitive substring |
| 78 | inspect_android_class |
Inspect one exact Android class's parsed methods, fields and inner classes, including synthetic members |
| 79 | inspect_android_method |
Decompile one Android method with smali fallback |
| 80 | trace_android_references |
Trace incoming static references to an exact Android class or unique method |
| 81 | inspect_binary_layout |
Inspect an explicit local binary without launching it as a host process |
| 82 | inspect_analysis_view |
Inspect a selected view of completed binary-layout or JavaScript application Evidence without repeating analysis |
| 83 | inspect_evm_interface |
Inspect an explicit local flat EVM bytecode carrier and infer dispatch selectors, argument strings and mutability without executing the target or accessing a chain/RPC endpoint |
| 84 | inspect_recorded_crash |
Inspect a supplied Linux ELF64 amd64 little-endian core without launching its target or attaching to any live PID |
| 85 | inspect_firmware_regions |
Inspect signature candidates in a local firmware file with Binwalk 3.1.x (verified with 3.1.0) |
| 86 | extract_firmware |
Extract caller-selected firmware bytes with Unblob 26.6.x (verified with 26.6.4) into an absent output directory |
| 87 | trace_web_module_imports |
Trace one exported website script's outgoing native ES imports/re-exports, using exact URL and optional selected import-map context |
| 88 | trace_web_source_location |
Trace one generated position in an exported website script through an explicitly paired local source map |
| 89 | observe_web_execution |
Instrument one selected CDP page for a finite, externally driven precise coverage window |
| 90 | inspect_web_event_listeners |
Inspect listeners registered directly on the first main-document CSS match in one selected CDP page |
| 91 | inspect_web_network_capture |
Inspect retained local HAR 1.2 or native mitmproxy capture records without contacting recorded URLs |
| 92 | recover_javascript_sources |
Recover readable modules from one local UTF-8 JavaScript script/bundle into an absent directory, using caller-supplied Wakaru 1.13.0 on Linux x64 |
| 93 | export_web_scripts |
Export JavaScript bytes already retained in one local inspect_web_page or capture_browser_scenario JSON capture (normalized result or complete Evidence) |
| 94 | list_browser_targets |
List page targets exposed by the selected loopback Chrome DevTools Protocol endpoint |
| 95 | inspect_web_page |
Passively inspect one selected page target through CDP without evaluating JavaScript, navigating, clicking, closing, or mutating the page |
| 96 | analyze_web_bundle |
Capture JavaScript source from one selected CDP page and statically derive a chunk graph, route and endpoint candidates, vendor fingerprints, page-declared WebMCP metadata, and optionally fetch source maps from the selected target origin or explicitly requested origins |
| 97 | observe_web_session |
Arm a CDP observation window of the requested duration while the user operates the page |
| 98 | discover_webmcp_tools |
Passively inventory every page-registered WebMCP tool and its complete structural input-schema summary using the experimental CDP WebMCP domain |
| 99 | compare_web_captures |
Compare passive web captures by providing before and after, each with the complete inspect_web_page normalized_result in inspection and an optional complete discover_webmcp_tools normalized_result in webmcp; or compare recorded scenarios by passing complete capture_browser_scenario normalized_result objects in before_scenario and after_scenario with an optional normalization policy |
| 100 | capture_web_screenshot |
Capture the current visible viewport of one configured page as an inline, content-addressed PNG artifact |
| 101 | compare_web_screenshots |
Compare two self-verifying PNG screenshot artifacts with local pixel metrics |
| 102 | capture_browser_scenario |
Run a controlled browser scenario when passive observation cannot exercise the application |
| 103 | list_electron_targets |
List every Electron file:// page target from a selected loopback CDP endpoint |
| 104 | inspect_electron_page |
Passively inspect one Electron file page by supplying its loopback CDP endpoint and target ID |
| 105 | analyze_javascript_application |
Reconstruct one local ASAR or extracted JavaScript application as an inline application graph without executing it |
| 106 | reconcile_javascript_runtime |
Reconcile verified static JavaScript application graphs with existing passive web/Electron CDP, passive V8 Inspector, or provider-owned active Electron Evidence |
| 107 | capture_electron_scenario |
Use this for a provider-owned Electron run when passive CDP or Inspector observation cannot exercise application behavior |
| 108 | list_javascript_runtime_targets |
List every eligible Node/Electron V8 Inspector target from an explicit literal-loopback endpoint |
| 109 | observe_javascript_runtime |
Attach passively to one Node/Electron V8 Inspector target by supplying its loopback Inspector endpoint and target ID |
| 110 | trace_application_feature |
Trace a typed literal seed through every reachable part of an authenticated JavaScript Application Graph supplied as inline Evidence or exact same-session retained references |
| 111 | trace_javascript_semantics |
Trace static JavaScript data-flow, direct call/return, and closure relations from inline application Evidence or an exact same-session retained reference |
| 112 | compare_application_versions |
Compare two authenticated JavaScript Application Graph versions supplied as inline Evidence or exact same-session retained references |
| 113 | compare_source_to_bundle |
Compare a cryptographically committed HistoricalSourceGraph with authenticated JavaScript Application Graph Evidence supplied inline or by exact same-session retained reference |
| 114 | compare_javascript_export_shapes |
Compare static return shapes for one exact module/export selector on each authenticated JavaScript Application Graph supplied as inline Evidence or exact same-session retained references |
| 115 | build_reconstruction_obligation_ledger |
Generate the complete deterministic ReconstructionObligationLedger from an authenticated Evidence bundle, reviewed obligations, and an explicit reconstruction manifest |
| 116 | evaluate_reconstruction_coverage |
Evaluate inline evidence-backed reconstruction coverage against one named boundary |
| 117 | project_android_application_graph |
Project authenticated APK inventory_artifact Evidence into an execution-free Android application inventory |
| 118 | project_apple_application_graph |
Project authenticated IPA, macOS .app directory, ZIP, or DMG inventory Evidence into an execution-free Apple application inventory |
| 119 | open_binary |
Open a local executable, application bundle, archive, JavaScript, source map, plist, or analysis database after validation |
| 120 | close_binary |
Drain earlier provider requests, optionally write a provider-neutral analysis snapshot atomically to the caller-supplied path, then close the active target and every provider resource started for it |
| 121 | binary_session |
Report the complete current target, provider, capability availability, client-feature, analysis, and server-identity status without starting analysis |
| 122 | export_evidence_bundle |
Atomically write the session's deterministic Evidence bundle to the requested local path |
| 123 | import_evidence_bundle |
Read the JSON bundle at the supplied local path, validate every Evidence ID and canonical manifest, then atomically merge it |
| 124 | get_evidence_bundle |
Return every Evidence record and residual unknown currently retained by this session as one inline bundle for direct inspection or follow-up workflows |
| 125 | capture_process_scenario |
Run one caller-selected command under a PTY and return process capture Evidence with residual unknowns |
| 126 | compare_process_captures |
Compare two compatible process capture observations across terminal, interaction, lifecycle, process, filesystem, command-shim, HTTP, and WebSocket evidence |
| 127 | compare_artifacts |
Compare complete artifact inventories by logical occurrence path, content identity, metadata, and graph relations |
| 128 | compare_functions |
Compare two explicit sets of analyze_function Evidence across identity, exact provider text, calls, references, strings, and address-normalized CFG topology |
| 129 | compare_bundles |
Compare two canonical Evidence bundles by exact record membership, explicit one-to-one observation pairs, and complete residual-unknown revision histories |
| 130 | find_changed_behavior |
Aggregate validated process and artifact comparison Evidence |
| 131 | build_call_path |
Build every shortest direct-callee path inline from complete analyze_function Evidence records using exact canonical addresses |
| 132 | correlate_static_and_runtime |
Evaluate every explicit caller-declared hypothesis between exact static comparison findings and runtime comparison dimensions |
| 133 | verify_reconstruction |
Verify a finite typed behavioral and structural specification against a canonical Evidence bundle |
| 134 | list_unknowns |
List every current residual-unknown head in deterministic ID order, with optional exact status, severity, and domain filters |
| 135 | record_unknown |
Create one deterministic residual unknown and immutable mutation evidence |
| 136 | update_unknown |
Append one immutable full-state revision and mutation evidence |
| 137 | verify_unknown_resolution |
Revalidate the current residual-unknown head against live bundled evidence, exact authority/confidence/environment requirements, and revision integrity |
| 138 | get_navigation_context |
Return the selected document, current address, and containing/current procedure in one provider-neutral result |
| 139 | inspect_address_context |
Inspect one explicit reproducible address for its analyzed name, containing procedure, regular and inline comments, and matching bookmarks |
Tools
annotate_native_function
Annotate Native Function · idempotent
Atomically update one function name and/or entry comments, read them back, and return a refreshed complete function dossier. Ghidra changes its ephemeral session analysis database only; original executable bytes remain unchanged. Empty comment text clears that comment. Edits remain available to subsequent MCP calls until close; CLI returns the updated dossier before discarding its session. Invalid edits roll back the entire operation. Windows P0 and providers without this capability are unsupported.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | Value for procedure. |
name |
string | Exact name used by this operation. | |
comment |
string | Regular entry comment; empty text clears it | |
inline_comment |
string | Inline entry comment; empty text clears it |
Example:
{
"name": "annotate_native_function",
"arguments": {
"procedure": "0x10100",
"name": "entry",
"comment": "Analyst observation"
}
}
inspect_native_load_image
Inspect Native Load Image · idempotent
Verify the provider's loaded DOS MZ or explicitly selected COM image against its immutable target snapshot: complete original/modified source-byte digests, header/module file mappings and memory digests, relocations and external entry. Returns measured observations and independent checks with mismatch coordinates. COM verification includes its imposed entry register context and does not claim PSP/runtime coverage. Overlay and uninitialized coverage remain explicit; other formats return unsupported. Does not execute or modify the target.
No parameters.
Example:
{
"name": "inspect_native_load_image",
"arguments": {}
}
inspect_native_data_type
Inspect Native Data Type · idempotent
Inspect one recovered type by exact database category path or defined typed data address. Returns observed size, alignment, packing, fields, bitfields, enum values, and child type identities; source-level authority and flexible-tail semantics remain unknown unless substantiated.
| Parameter | Type | Required | Description |
|---|---|---|---|
type |
string | Value for type. | |
address |
string | Value for address. | |
document |
string | Exact provider document or program identity. |
Example:
{
"name": "inspect_native_data_type",
"arguments": {
"type": "/MyStruct"
}
}
inspect_native_instruction
Inspect Native Instruction · idempotent
Inspect one exact instruction address: decoded bytes, mnemonic, ordered operand tokens, flow and typed references. Memory addressing decomposition is unavailable when the provider supplies only tokens. Data, interior instruction addresses and undecodable bytes are distinct outcomes.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | Value for address. |
document |
string | Exact provider document or program identity. |
Example:
{
"name": "inspect_native_instruction",
"arguments": {
"address": "0x1000"
}
}
resolve_native_call_targets
Resolve Native Call Targets · idempotent
Resolve one explicit static call site using typed provider call references. Preserves ambiguous targets as candidates and unresolved computed calls as unknown; does not execute code or traverse a call graph.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | Value for address. |
document |
string | Exact provider document or program identity. |
Example:
{
"name": "resolve_native_call_targets",
"arguments": {
"address": "0x1000"
}
}
address_name
Address Name · idempotent
Resolve the primary analyzed name at a code or data address. Headless providers require an explicit address; GUI providers may default to their current cursor. Null means the provider has no primary name at that address.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "address_name",
"arguments": {}
}
comment
Comment · idempotent
Read the regular analysis comment at an address, defaulting to the current cursor. This is read-only and returns null when no comment exists; use set_comment to persist a finding.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "comment",
"arguments": {}
}
current_address
Current Address · idempotent
Return Hopper's current cursor address for the selected document. Use only for interactive navigation state; prefer explicit addresses in reproducible investigations.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "current_address",
"arguments": {}
}
current_procedure
Current Procedure · idempotent
Return the analyzed procedure containing Hopper's current cursor. This uses GUI cursor state and is not a procedure-name lookup.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "current_procedure",
"arguments": {}
}
current_document
Current Document · idempotent
Return the document currently selected by REA's Hopper bridge.
No parameters.
Example:
{
"name": "current_document",
"arguments": {}
}
goto_address
Goto Address · idempotent
Move Hopper's GUI cursor to a mapped address and return the observed cursor address. Interior coordinates snap to the containing analyzed object's start. Unmapped destinations fail without moving the cursor. This changes navigation state but not analysis data; use explicit-address tools for headless workflows.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "goto_address",
"arguments": {
"address": "0x1000"
}
}
inline_comment
Inline Comment · idempotent
Read the inline instruction comment at an address, defaulting to the current cursor. Returns null when absent; use set_inline_comment to write one.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "inline_comment",
"arguments": {}
}
list_bookmarks
List Bookmarks · idempotent
List every bookmark in the selected Hopper document as address and name pairs; unnamed bookmarks retain a null name. Use bookmarks as analyst-authored navigation aids; this does not discover code references.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "list_bookmarks",
"arguments": {}
}
list_documents
List Documents · idempotent
List provider program or document identities. Hopper may expose several documents; a Ghidra headless session contains exactly its one imported Program.
No parameters.
Example:
{
"name": "list_documents",
"arguments": {}
}
list_names
List Names · idempotent
List every analyzed memory and external symbol as address/value pairs. Provider metadata distinguishes Ghidra primary, dynamic, external, type, and source facts when available.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "list_names",
"arguments": {}
}
list_procedures
List Procedures · idempotent
List every analyzed procedure as address/value pairs after provider analysis. Ghidra metadata distinguishes thunks and external functions; use returned addresses in later function operations.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "list_procedures",
"arguments": {}
}
list_segments
List Segments · idempotent
List segments or memory blocks using exclusive end addresses. Ghidra reports block permissions, address space, image base, initialization, and overlay facts; Hopper marks unavailable permissions explicitly.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "list_segments",
"arguments": {}
}
list_strings
List Strings · idempotent
List every provider-defined string object, or filter to one address, as address/value pairs with encoding, terminator status, and byte length when available. Hopper reads complete typed objects and retains its original display text as provider_value; long literals may span adjacent unterminated objects.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "list_strings",
"arguments": {}
}
next_address
Next Address · idempotent
Return the next analyzed object address after an explicit address or current cursor. This is a navigation primitive, not instruction-flow or CFG analysis.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "next_address",
"arguments": {}
}
prev_address
Prev Address · idempotent
Return the previous analyzed object start before an explicit address or current cursor. This is a navigation primitive and may fail at document boundaries; data objects and instructions remain distinct from control flow.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "prev_address",
"arguments": {}
}
procedure_address
Procedure Address · idempotent
Resolve an unambiguous procedure symbol name or provider-normalized address to its canonical entry address. External address spaces remain explicit.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_address",
"arguments": {
"procedure": "main"
}
}
procedure_assembly
Procedure Assembly · idempotent
Return assembly for one analyzed procedure identified by symbol or hexadecimal address. Use when pseudocode loses calling-convention or instruction-level detail; output is currently returned as one unpaginated string.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_assembly",
"arguments": {
"procedure": "main"
}
}
procedure_callees
Procedure Callees · idempotent
Return the provider's resolved direct callees for one procedure identified by symbol or address. Unresolved indirect calls may be absent; use analyze_function and typed references to preserve available edge uncertainty.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_callees",
"arguments": {
"procedure": "main"
}
}
procedure_callers
Procedure Callers · idempotent
Return the provider's resolved direct callers for one procedure identified by symbol or address. Results reflect completed static analysis and may omit unresolved indirect references.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_callers",
"arguments": {
"procedure": "main"
}
}
procedure_info
Procedure Info · idempotent
Return provider metadata for one procedure identified by symbol or address: entrypoint, signature, locals, size, block count, and complete inclusive body ranges when observed. Hopper locals preserve observed names and signed stack displacements; source types remain unknown. Body byte count and enclosing span remain distinct; unavailable extent is explicit.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_info",
"arguments": {
"procedure": "main"
}
}
read_function_instructions
Read Function Instructions · idempotent
Return every raw instruction for one analyzed procedure. Instruction text is provider-specific.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The document name |
Example:
{
"name": "read_function_instructions",
"arguments": {
"procedure": "main"
}
}
read_bytes
Read Bytes · idempotent
Read analyzed bytes from one provider-normalized virtual address. The hexadecimal payload reports the exact returned length; incomplete reads remain explicit and unsupported provider APIs return typed capability unavailability.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
length |
integer | Value for length. | |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "read_bytes",
"arguments": {
"address": "0x1000",
"length": 16
}
}
address_to_file_offset
Address To File Offset · idempotent
Map one provider-normalized virtual address to its original nonnegative file offset. Hopper verifies the original bytes against the selected executable digest and translates FAT image-relative offsets using the loaded header. Results preserve the provider coordinate, image base, and source path. Unmapped addresses fail explicitly; changed or unavailable sources return typed errors retaining native mapping facts as partial evidence.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "address_to_file_offset",
"arguments": {
"address": "0x1000"
}
}
procedure_references
Procedure References · idempotent
Return every raw incoming or outgoing reference edge for one procedure. Endpoint procedures are resolved only from provider containment. Ghidra preserves detailed reference flags. Hopper preserves native CallReference classifications and exact endpoints while leaving unavailable detailed flags explicit.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
direction |
"incoming" | "outgoing" |
Direction in which to traverse or compare relationships. | |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_references",
"arguments": {
"procedure": "main",
"direction": "outgoing"
}
}
procedure_pseudo_code
Procedure Pseudo Code · idempotent
Decompile one analyzed procedure by symbol name or provider-normalized address. Returns provider-specific pseudocode, never original source or cross-provider text equivalence, and may return null; request procedure_assembly when instruction precision matters.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | The procedure name or address |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "procedure_pseudo_code",
"arguments": {
"procedure": "main"
}
}
resolve_containing_procedure
Resolve Containing Procedure · idempotent
Resolve an arbitrary address, including an interior instruction or exact external entry, to its provider-analyzed containing procedure. A negative result distinguishes outside segments from not in a procedure and is never guessed from nearby symbols.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "resolve_containing_procedure",
"arguments": {
"address": "0x1000"
}
}
search_procedures
Search Procedures · idempotent
Search every analyzed procedure name using literal matching by default or regex when requested. Results are deterministic and complete. Hopper regex mode uses ECMAScript Unicode syntax in a cancellable worker; a matching deadline leaves its API usable.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern |
string | yes | The literal text or regex pattern to search for |
mode |
"literal" | "regex" |
Operation mode that selects the requested behavior. | |
case_sensitive |
boolean | Whether to match case | |
document |
string | The document name |
Example:
{
"name": "search_procedures",
"arguments": {
"pattern": "main",
"mode": "literal",
"case_sensitive": false
}
}
search_strings
Search Strings · idempotent
Search every analyzed string object using literal matching by default or regex when requested. Results are deterministic and complete over the native inventory. Hopper retains typed byte decoding, native display, and explicit decoding unknowns. Adjacent long-literal fragments match independently. Hopper regex mode uses ECMAScript Unicode syntax in a cancellable worker; a matching deadline leaves its API usable.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern |
string | yes | The literal text or regex pattern to search for |
mode |
"literal" | "regex" |
Operation mode that selects the requested behavior. | |
case_sensitive |
boolean | Whether to match case | |
document |
string | The document name |
Example:
{
"name": "search_strings",
"arguments": {
"pattern": "authorization failed",
"mode": "literal",
"case_sensitive": false
}
}
set_address_name
Set Address Name · idempotent
Assign an analyst name to one mapped hexadecimal address and report whether the native edit succeeded and exact readback matched. Hopper rejects symbol names exceeding 1024 UTF-16 code units before mutation, and rejects names owned by another address; use set_addresses_names to explicitly move or swap labels among selected addresses. This mutates analysis metadata.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
name |
string | yes | Exact name used by this operation. |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "set_address_name",
"arguments": {
"address": "0x1000",
"name": "entry"
}
}
set_addresses_names
Set Addresses Names · idempotent
Assign analyst names to multiple mapped addresses in one call and return per-address edit/readback success booleans. Hopper validates mapped destinations, native string representations, its 1024 UTF-16 code-unit symbol-name limit, and unique destinations/names before applying edits. Existing labels may move or swap only among explicitly selected addresses; unselected label owners remain unchanged. This mutates analysis metadata; verify failures individually.
| Parameter | Type | Required | Description |
|---|---|---|---|
names |
object | yes | Value for names. |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "set_addresses_names",
"arguments": {
"names": {
"0x1000": "entry"
}
}
}
set_bookmark
Set Bookmark · idempotent
Create or replace a bookmark at a mapped hexadecimal address and report success. This mutates navigation metadata; bookmarks are analyst-authored navigation aids, not binary evidence.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
name |
string | Exact name used by this operation. | |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "set_bookmark",
"arguments": {
"address": "0x1000"
}
}
set_comment
Set Comment · idempotent
Write a regular analysis comment at a hexadecimal address and return whether readback matched. An empty comment clears it. This mutates the Hopper document; use comments to record evidence IDs or reasoning.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
comment |
string | yes | Exact analyst comment text to write. |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "set_comment",
"arguments": {
"address": "0x1000",
"comment": "validated entry point"
}
}
set_inline_comment
Set Inline Comment · idempotent
Write an inline instruction comment at a hexadecimal address and return whether readback matched. An empty comment clears it; Hopper may flatten newlines, producing false on exact readback. This mutates analysis metadata.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
comment |
string | yes | Exact analyst comment text to write. |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "set_inline_comment",
"arguments": {
"address": "0x1000",
"comment": "calls parser"
}
}
unset_bookmark
Unset Bookmark · destructive, idempotent
Remove the bookmark at a mapped hexadecimal address and return whether it is absent. Hopper also permits removing an existing legacy bookmark outside mapped memory. This mutates navigation metadata and does not alter binary bytes.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
document |
string | The active target's provider document name; use open_binary to switch targets |
Example:
{
"name": "unset_bookmark",
"arguments": {
"address": "0x1000"
}
}
xrefs
Xrefs · idempotent
Return analyzed references to a code or data address. Hopper may default to its current cursor; headless providers such as Ghidra require an explicit address. Use to connect strings, globals, selectors, and functions; bare addresses are untyped and indirect references may be incomplete.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | The active target's provider document name; use open_binary to switch targets | |
address |
string | A provider-normalized address; default memory uses 0x-prefixed hexadecimal |
Example:
{
"name": "xrefs",
"arguments": {}
}
trace_native_values
Trace Native Values · idempotent
Trace a bounded static dependency graph from one explicit native procedure. Includes high-p-code def-use, constants, operators, memory and branch operations, resolved call edges, and derived argument/parameter and return/output bindings. Missing bindings, alias semantics, persistent state and RNG roles remain unknown. Budgets bound depth, decompilations, graph size and payloads; nodes are paginated.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | Value for procedure. |
max_depth |
integer | Maximum permitted depth for this operation. | |
max_functions |
integer | Maximum permitted functions for this operation. | |
max_call_sites |
integer | Maximum permitted call sites for this operation. | |
max_nodes |
integer | Maximum permitted nodes for this operation. | |
max_edges |
integer | Maximum permitted edges for this operation. | |
offset |
integer | Value for offset. | |
limit |
integer | Value for limit. |
Example:
{
"name": "trace_native_values",
"arguments": {
"procedure": "0x1000",
"max_depth": 3,
"max_functions": 16,
"max_call_sites": 256,
"max_nodes": 5000,
"max_edges": 10000,
"offset": 0,
"limit": 1000
}
}
inspect_native_dispatch_metadata
Inspect Native Dispatch Metadata · idempotent
Inspect the bound provider's name inventory for Objective-C class/method symbols and Swift mangled symbols, returning at most max_records decoded names. Includes target SHA-256 when available, provider identity/version, analysis-profile digest, facet coverage, and per-record Evidence. This is symbol-level evidence, not runtime metadata: ivar layouts, protocol conformances, witness/class tables, and relative pointers are explicitly marked unsupported unless a provider supplies those decoders. The provider controls how its name inventory is acquired.
| Parameter | Type | Required | Description |
|---|---|---|---|
max_records |
integer | Maximum permitted records for this operation. |
Example:
{
"name": "inspect_native_dispatch_metadata",
"arguments": {
"max_records": 5000
}
}
get_objc_classes
Get Objc Classes · idempotent
Discover and deduplicate Objective-C class labels, optionally filtering by literal substring.
| Parameter | Type | Required | Description |
|---|---|---|---|
pattern |
string | Literal text or regular expression used to filter matching results. |
Example:
{
"name": "get_objc_classes",
"arguments": {
"pattern": ""
}
}
get_objc_protocols
Get Objc Protocols · idempotent
Discover and deduplicate Objective-C and Swift protocol labels.
No parameters.
Example:
{
"name": "get_objc_protocols",
"arguments": {}
}
batch_decompile
Batch Decompile · idempotent
Decompile each explicit procedure symbol or address concurrently. Preserves each input selector in address and reports the observed canonical entry and entry label in procedure; identity or label failures remain explicit without discarding usable pseudocode. Returns ordered per-item success or error results and aggregate counts.
| Parameter | Type | Required | Description |
|---|---|---|---|
addresses |
string[] | Ordered provider-normalized procedure addresses to analyze. |
Example:
{
"name": "batch_decompile",
"arguments": {
"addresses": []
}
}
get_call_graph
Get Call Graph · idempotent
Resolve one symbol or address to its canonical procedure entry, then traverse the bound provider's caller or callee relationships until the reachable graph is exhausted. Every node uses a canonical address and has an ok/error status; failures use safe typed projections. Unresolved indirect calls may be missing and results are not a whole-program CFG.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | A procedure symbol or address to resolve to its canonical entry |
direction |
"forward" | "backward" |
Direction in which to traverse or compare relationships. |
Example:
{
"name": "get_call_graph",
"arguments": {
"address": "0x1000",
"direction": "forward"
}
}
analyze_swift_types
Analyze Swift Types · idempotent
Categorize analyzed Swift procedure names using their manglings or same-address Swift symbol aliases. Decodes legacy and literal modern nominal contexts into classes, structs, enums, protocols, and extensions. Preserves provider names and supporting mangled_names; unresolved categories appear in other and in unclassified, which remains inline even under category filters. Returns deduplicated procedure-name counts, not unique source types, plus identification limitations. Optionally select one category and/or apply a case-sensitive literal filter to provider names or supporting manglings; for example, use {category: "structs", pattern: "Pair"}.
| Parameter | Type | Required | Description |
|---|---|---|---|
category |
"classes" | "structs" | "enums" | "protocols" | "extensions" | "other" |
Limit categorized results to one Swift category; unresolved category observations remain in unclassified. | |
pattern |
string | Case-sensitive literal filter applied to provider procedure names and their supporting Swift manglings. |
Example:
{
"name": "analyze_swift_types",
"arguments": {
"category": "classes",
"pattern": "Account"
}
}
find_xrefs_to_name
Find Xrefs To Name · idempotent
Resolve an exact name against the bound provider's name inventory and return a resolved or unresolved result. Unresolved names use the stable name_not_found reason; this xref workflow returns address-only projections.
| Parameter | Type | Required | Description |
|---|---|---|---|
name |
string | yes | Exact name used by this operation. |
Example:
{
"name": "find_xrefs_to_name",
"arguments": {
"name": "malloc"
}
}
binary_overview
Binary Overview · idempotent
Return native-binary metadata, every segment with its length, and exhaustive procedure/string counts. Use search_procedures, list_procedures, or analyze_function directly when you already know which procedure to inspect.
No parameters.
Example:
{
"name": "binary_overview",
"arguments": {}
}
analyze_function
Analyze Function · idempotent
Build a dossier for one native function identified by symbol or provider-returned address. Returns identity with complete inclusive body ranges or explicit unknown, provider-specific pseudocode and assembly, comments, calls, references, referenced strings/names, local CFG blocks, and available native API boundary observations.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | A procedure name or address |
Example:
{
"name": "analyze_function",
"arguments": {
"procedure": "main"
}
}
inspect_native_api
Inspect Native Api
Analyze a native API boundary in one function identified by symbol or provider-returned address. Returns confidence, evidence, jump-table dispatch/data/case mappings, separately evidenced default targets, unsupported branches, and residual unknowns. Null case values mean unresolved cases, never a known default.
| Parameter | Type | Required | Description |
|---|---|---|---|
procedure |
string | yes | A procedure name or address |
Example:
{
"name": "inspect_native_api",
"arguments": {
"procedure": "main"
}
}
trace_feature
Trace Feature
Trace the complete literal query, preserving spaces, through every matching string and procedure, their xrefs, and truthful containing-procedure resolution. Returns observations, operation count, and residual unknowns without inferring reference kinds.
| Parameter | Type | Required | Description |
|---|---|---|---|
query |
string | yes | Non-empty feature or text query to investigate. |
case_sensitive |
boolean | Whether text matching distinguishes uppercase and lowercase. |
Example:
{
"name": "trace_feature",
"arguments": {
"query": "license",
"case_sensitive": false
}
}
trace_call_path
Trace Call Path
Resolve start and optional goal symbols or addresses to canonical procedure entries, then trace direct callers or callees until the graph is exhausted or the goal is reached. Results use canonical addresses; Evidence preserves supplied selectors. Returns visited nodes, direct-call edges, a shortest traversal path, provider failures, and residual unknowns; unresolved indirect calls remain unknown.
| Parameter | Type | Required | Description |
|---|---|---|---|
start |
string | yes | A starting procedure symbol or address |
goal |
string | An optional destination procedure symbol or address | |
direction |
"forward" | "backward" |
Direction in which to traverse or compare relationships. |
Example:
{
"name": "trace_call_path",
"arguments": {
"start": "0x1000",
"goal": "0x1100",
"direction": "forward"
}
}
trace_native_ui_action
Trace Native Ui Action · idempotent
Trace one unique compiled UI action, object ID, native symbol or exact function address through authored connections, encoded or symbolized Objective-C handlers, and bounded static call references. Typed direct and resolved indirect calls, ambiguous candidates, inferred untyped provider callees, and targetless sites remain distinct. Runtime reachability is unknown; use trace_native_values for recovered value dependencies.
| Parameter | Type | Required | Description |
|---|---|---|---|
action |
string | yes | A unique compiled UI action selector, interface object ID, native symbol or exact function address |
max_depth |
integer | Maximum permitted depth for this operation. | |
max_nodes |
integer | Maximum permitted nodes for this operation. | |
max_edges |
integer | Maximum permitted edges for this operation. |
Example:
{
"name": "trace_native_ui_action",
"arguments": {
"action": "buildTapped:",
"max_depth": 8,
"max_nodes": 250,
"max_edges": 500
}
}
observe_native_ui
Observe Native Ui · idempotent
Observe an already-running native app by PID and window ID, bound to the active Mach-O target. Captures a bounded accessibility tree and selected-window screenshot; OS permission denial fails without broad capture or target launch.
| Parameter | Type | Required | Description |
|---|---|---|---|
pid |
integer | yes | Value for pid. |
window_id |
integer | yes | Value for window id. |
screenshot |
boolean | Value for screenshot. | |
accessibility |
boolean | Value for accessibility. | |
max_nodes |
integer | Maximum accessibility nodes per capture; increase for large windows. |
Example:
{
"name": "observe_native_ui",
"arguments": {
"pid": 123,
"window_id": 456
}
}
capture_native_ui_scenario
Capture Native Ui Scenario · destructive
Run selected-element press, increment/decrement scroll, AXValue text entry and bounded wait steps in one exact native app window. Returns ordered before/after captures and action/capture failures. Actions can change app data, network activity and persistent state; application state is left as-is and restoration is not attempted.
| Parameter | Type | Required | Description |
|---|---|---|---|
pid |
integer | yes | Value for pid. |
window_id |
integer | yes | Value for window id. |
screenshot |
boolean | Value for screenshot. | |
accessibility |
boolean | Value for accessibility. | |
max_nodes |
integer | Maximum accessibility nodes per capture; increase for large windows. | |
steps |
object{kind, path} | object{kind, path, direction} | object{kind, path, text} | object{kind, milliseconds}[] | yes | Value for steps. |
Example:
{
"name": "capture_native_ui_scenario",
"arguments": {
"pid": 123,
"window_id": 456,
"steps": [
{
"kind": "wait",
"milliseconds": 100
}
]
}
}
observe_native_calls
Observe Native Calls
Launch the active Mach-O as an owned process under LLDB and record each entry into caller-selected functions or Objective-C methods: thread, module, symbol, load and file address, raw argument registers, selector, receiver class and optional caller frames. Every hit auto-continues. No expression is evaluated and no other process is attached. The process is killed when max_events or duration_ms is reached; exit status, captured stdout/stderr, unresolved breakpoints and limitations are returned inline. The process runs with the current user's permissions and may change files, show UI or use the network. A hardened-runtime target needs the get-task-allow entitlement.
| Parameter | Type | Required | Description |
|---|---|---|---|
breakpoints |
object{kind, name, module} | object{kind, selector, class_name, method_type}[] | yes | Value for breakpoints. |
arguments |
string[] | Value for arguments. | |
environment |
object | Overrides on top of the environment REA runs with. | |
working_directory |
string | Value for working directory. | |
duration_ms |
integer | Observation window; the process is killed if it is still running. | |
max_events |
integer | Stop observing and kill the process after this many recorded entries. | |
argument_registers |
integer | Integer argument registers to record per entry (arm64 has 8, x86_64 has 6). | |
backtrace_frames |
integer | Caller frames to record per entry. |
Example:
{
"name": "observe_native_calls",
"arguments": {
"breakpoints": [
{
"kind": "objc-method",
"class_name": "NSURLSession",
"selector": "dataTaskWithRequest:completionHandler:"
},
{
"kind": "function",
"name": "open",
"module": "libsystem_kernel.dylib"
}
],
"arguments": [
"--help"
],
"duration_ms": 5000,
"backtrace_frames": 4
}
}
inspect_macho
Inspect Macho · idempotent
Inspect Mach-O slices, load commands, imports, exports, dependencies, build metadata, segments, sections, permissions, and exact command provenance without launching Hopper.
No parameters.
Example:
{
"name": "inspect_macho",
"arguments": {}
}
inspect_signature
Inspect Signature · idempotent
Inspect the active artifact's code-signing identity, hashes, authorities, requirements, entitlements, hardened-runtime state, and exact command provenance.
No parameters.
Example:
{
"name": "inspect_signature",
"arguments": {}
}
inspect_plist
Inspect Plist · idempotent
Parse Info.plist from the active artifact by default, or pass any local plist path. Returns normalized JSON rather than plutil text.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | Local filesystem path used by this operation. |
Example:
{
"name": "inspect_plist",
"arguments": {
"path": "/Applications/Example.app/Contents/Info.plist"
}
}
list_architectures
List Architectures · idempotent
List thin or universal Mach-O slices with offsets, sizes, alignment, explicit coverage, and native-tool provenance.
No parameters.
Example:
{
"name": "list_architectures",
"arguments": {}
}
demangle_swift
Demangle Swift · idempotent
Demangle an ordered list of single-line Swift symbols without requiring Hopper. Each input returns demangled, unchanged, or invalid status.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols |
string[] | yes | Ordered Swift symbols to demangle. |
Example:
{
"name": "demangle_swift",
"arguments": {
"symbols": [
"$s4Test3fooyyF"
]
}
}
inspect_artifact
Inspect Artifact · idempotent
Inspect an active archive or application package in one call. Returns the complete content-addressed artifact graph, source Evidence, observations, relationships, integrity contradictions, hypotheses, unexplored branches, limitations, and next probes inline. Read-only DMG mounting is used automatically on supported macOS hosts. Integrity mismatches fail by default; record-and-continue keeps mismatches explicitly untrusted. It does not extract files; use extract_artifact to materialize its regular contents.
| Parameter | Type | Required | Description |
|---|---|---|---|
integrity_policy |
"fail" | "record-and-continue" |
Value for integrity policy. |
Example:
{
"name": "inspect_artifact",
"arguments": {}
}
extract_artifact
Extract Artifact
Extract all regular files from the active archive or application package into a fresh temporary directory chosen by REA. The result includes its location. Rejects traversal and symlink escapes, never overwrites, enforces archive integrity checks, and verifies cleanup.
No parameters.
Example:
{
"name": "extract_artifact",
"arguments": {}
}
decode_interface_builder
Decode Interface Builder · idempotent
Decode compiled storyboard and nib archives inside the active Apple app bundle, including keyed property lists and NIBArchive object tables, into a bounded object, hierarchy, and connection graph. This is static archive parsing; unrecognized archive classes and unresolved code handlers remain explicit unknowns.
| Parameter | Type | Required | Description |
|---|---|---|---|
max_documents |
integer | Maximum permitted documents for this operation. | |
max_objects |
integer | Maximum permitted objects for this operation. | |
max_connections |
integer | Maximum permitted connections for this operation. |
Example:
{
"name": "decode_interface_builder",
"arguments": {}
}
inspect_keyed_archive
Inspect Keyed Archive · idempotent
Inspect one Foundation NSKeyedArchiver plist in the active app bundle as original object-table nodes, class descriptors, named roots, and UID edges. Preserves shared and cyclic references without instantiating classes. The path is relative to the bundle; root selection and object pagination preserve original identities.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | Local filesystem path used by this operation. | |
root |
string | Value for root. | |
offset |
integer | Value for offset. | |
limit |
integer | Value for limit. |
Example:
{
"name": "inspect_keyed_archive",
"arguments": {
"path": "Contents/Resources/Model.plist"
}
}
inspect_asset_catalog
Inspect Asset Catalog · idempotent
Inspect compiled Assets.car metadata in an active Apple app bundle. Returns stable paginated catalog and rendition records with raw assetutil metadata and catalog digests; rendition bytes are not extracted.
| Parameter | Type | Required | Description |
|---|---|---|---|
offset |
integer | Value for offset. | |
limit |
integer | Value for limit. |
Example:
{
"name": "inspect_asset_catalog",
"arguments": {
"offset": 0,
"limit": 1000
}
}
trace_dylib_resolution
Trace Dylib Resolution · idempotent
Trace how dyld would resolve each Mach-O dylib load for the active Mach-O, or for every executable in the active .app bundle (the main app, XPC services, extensions, login items, helpers). Expands @executable_path, @loader_path, and @rpath through each process's LC_RPATH stack in dependents-first load order, and reports every candidate path with its outcome, the resolved image and digest, weak, re-export, and upward flags, and derived findings such as unresolved required loads or absent earlier @rpath candidates. Pure header parsing: nothing is executed, and absolute or system paths outside the analyzed root stay undetermined. Select roots or one architecture to narrow large bundles.
| Parameter | Type | Required | Description |
|---|---|---|---|
roots |
string[] | Value for roots. | |
architecture |
"arm64" | "arm64e" | "x86_64" |
Value for architecture. |
Example:
{
"name": "trace_dylib_resolution",
"arguments": {
"roots": [
"Contents/MacOS/App"
],
"architecture": "arm64"
}
}
inspect_managed_artifact
Inspect Managed Artifact · idempotent
Open and classify an explicit managed PE/CLI path, or inspect the active managed target, then inventory exact assembly/module identity, target framework evidence, references, resources, and custom attributes without loading or executing target code. Returns complete inline inventories when metadata is admitted and explicit partial or malformed coverage otherwise.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | Explicit absolute managed PE/CLI path; omit to reuse the previously selected managed target |
Example:
{
"name": "inspect_managed_artifact",
"arguments": {
"path": "/tmp/Example.dll"
}
}
inspect_managed_members
Inspect Managed Members · idempotent
Inspect PE/CLI metadata members, signatures, raw CIL hashes, decoded-instruction-tuple hashes, separately reported exception regions, call edges, and field-access anchors without loading or executing target code. Metadata tokens are reported as build-local coordinates bound to the artifact SHA-256 and MVID; the tuple hash does not resolve them or fully commit control flow.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | Explicit absolute managed PE/CLI path; omit to reuse the previously selected managed target |
Example:
{
"name": "inspect_managed_members",
"arguments": {}
}
inspect_managed_native_boundaries
Inspect Managed Native Boundaries · idempotent
Inspect PE/CLI ModuleRef, ImplMap/PInvoke declarations, CLI native-header indicators, and non-IL method implementation flags without loading or executing target code. Results are managed declarations and degraded native-boundary observations, not verified native exports or addresses.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | Explicit absolute managed PE/CLI path; omit to reuse the previously selected managed target |
Example:
{
"name": "inspect_managed_native_boundaries",
"arguments": {}
}
compare_managed_members
Compare Managed Members · idempotent
Compare two authenticated inspect_managed_members Evidence records using unique-only tiers: exact CIL/signature, exact declared type, name, and raw signature (decoded or not), and decoded structural method shape. Names alone are never a matching basis; a member whose signature was not decoded, or whose same-named counterpart's was not, stays unknown rather than added or removed. Metadata tokens remain build-local coordinates bound to each artifact SHA-256 and MVID, and the tuple digest does not itself remap them.
| Parameter | Type | Required | Description |
|---|---|---|---|
left |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Left-hand input used for comparison or differential execution. |
right |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Right-hand input used for comparison or differential execution. |
Example:
{
"name": "compare_managed_members",
"arguments": {
"left": {
"evidence_id": "ev_02289275cea97cf1c81300ee88411304f8fddbcd1771b605c81ae7f24e5cd137",
"subject": null,
"provider": {
"id": "rea-dotnet-static",
"name": "REA managed static analysis provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inspect_managed_members",
"parameters": {},
"raw_result": null,
"normalized_result": {
"artifact": {
"path": "/examples/00000000.dll",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"byte_length": 4096,
"format": "pe"
},
"module": {
"name": "Example.dll",
"generation": 0,
"mvid": "00112233-4455-6677-8899-aabbccddeeff",
"enc_id": null,
"enc_base_id": null,
"token": "0x00000001",
"row_offset": 0
},
"metadata": {
"status": "complete",
"version": "v4.0.30319",
"table_row_counts": {}
},
"identity_scope": {
"token_identity": "build-local",
"requires_artifact_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"requires_mvid": "00112233-4455-6677-8899-aabbccddeeff"
},
"types": [],
"fields": [],
"methods": [],
"member_refs": [],
"call_edges": [],
"field_accesses": [],
"coverage": {
"state": "complete",
"issues": []
},
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
},
"right": {
"evidence_id": "ev_7fe06eb739584efd812aa391409cb32ccf705e56740d79b93db0e8ef38d5af3e",
"subject": null,
"provider": {
"id": "rea-dotnet-static",
"name": "REA managed static analysis provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inspect_managed_members",
"parameters": {},
"raw_result": null,
"normalized_result": {
"artifact": {
"path": "/examples/11111111.dll",
"sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"byte_length": 4096,
"format": "pe"
},
"module": {
"name": "Example.dll",
"generation": 0,
"mvid": "ffeeddcc-bbaa-4988-9766-554433221100",
"enc_id": null,
"enc_base_id": null,
"token": "0x00000001",
"row_offset": 0
},
"metadata": {
"status": "complete",
"version": "v4.0.30319",
"table_row_counts": {}
},
"identity_scope": {
"token_identity": "build-local",
"requires_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"requires_mvid": "ffeeddcc-bbaa-4988-9766-554433221100"
},
"types": [],
"fields": [],
"methods": [],
"member_refs": [],
"call_edges": [],
"field_accesses": [],
"coverage": {
"state": "complete",
"issues": []
},
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
}
}
}
verify_managed_native_boundaries
Verify Managed Native Boundaries · idempotent
Verify managed P/Invoke/native-boundary declarations against authenticated native export or function Evidence without executing managed code or translating managed metadata tokens into native addresses. The workflow preserves declaration-only, verified, inferred, contradicted, and unresolved states.
| Parameter | Type | Required | Description |
|---|---|---|---|
managed_boundaries |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Value for managed boundaries. |
native_observations |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Native function or export Evidence records |
Example:
{
"name": "verify_managed_native_boundaries",
"arguments": {
"managed_boundaries": {
"evidence_id": "ev_874dd90c538bb78a6eb5415d39ef0ad7a4a9512a24d71d47f5c2ca17d353eac7",
"subject": null,
"provider": {
"id": "rea-dotnet-static",
"name": "REA managed static analysis provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inspect_managed_native_boundaries",
"parameters": {},
"raw_result": null,
"normalized_result": {
"artifact": {
"path": "/examples/ManagedInterop.exe",
"sha256": "6666666666666666666666666666666666666666666666666666666666666666",
"byte_length": 8192,
"format": "pe"
},
"module": {
"name": "ManagedInterop.exe",
"generation": 0,
"mvid": "00112233-4455-4677-8899-aabbccddeeff",
"enc_id": null,
"enc_base_id": null,
"token": "0x00000001",
"row_offset": 0
},
"metadata": {
"status": "complete",
"version": "v4.0.30319",
"table_row_counts": {}
},
"identity_scope": {
"token_identity": "build-local",
"requires_artifact_sha256": "6666666666666666666666666666666666666666666666666666666666666666",
"requires_mvid": "00112233-4455-4677-8899-aabbccddeeff"
},
"cli_native": {
"il_only": true,
"requires_32bit": false,
"strong_name_signed": false,
"native_entry_point": false,
"ready_to_run_signature": false,
"managed_native_header_rva": 0,
"managed_native_header_size": 0
},
"module_refs": [
{
"token": "0x1a000001",
"row_offset": 256,
"name": "nativehelper.dll"
}
],
"pinvoke_imports": [
{
"token": "0x1c000001",
"row_offset": 288,
"mapping_flags": 0,
"mapping_flags_hex": "0x0000",
"member_token": "0x06000001",
"member_kind": "method",
"member_name": "OpenNative",
"import_name": "open_native",
"import_scope_token": "0x1a000001",
"import_scope_name": "nativehelper.dll",
"no_mangle": true,
"char_set": "not-specified",
"call_convention": "cdecl",
"supports_last_error": false,
"best_fit": "assembly-default",
"throw_on_unmappable_char": "assembly-default",
"verification": "managed-declaration-only"
}
],
"native_implementations": [],
"summary": {
"module_ref_count": 1,
"pinvoke_import_count": 1,
"native_implementation_count": 0,
"ready_to_run": false,
"mixed_mode_or_native_header": false
},
"coverage": {
"state": "complete",
"issues": []
},
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
},
"native_observations": [
{
"evidence_id": "ev_501cc9df113b004af205a0d495a1c0bb5ae0aea2fbecbfdfd0ec4c9d2482480e",
"subject": {
"name": "nativehelper.dll",
"digest": {
"sha256": "7777777777777777777777777777777777777777777777777777777777777777"
},
"format": "mach-o",
"architecture": "x86_64",
"local_path": "/examples/nativehelper.dll"
},
"provider": {
"id": "native-macos",
"name": "REA native macOS provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inspect_macho",
"parameters": {},
"raw_result": null,
"normalized_result": {
"format": "mach-o",
"endian": "little",
"word_size": 64,
"file_type": "dylib",
"flags": [],
"uuid": null,
"entrypoints": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"architectures": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"build_metadata": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"load_commands": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"dependencies": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"imports": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"exports": {
"items": [
{
"name": "open_native",
"address": "0x1000",
"weak": false,
"reexport": false,
"source": "nm"
}
],
"total": 1,
"exhaustive": true,
"limitations": []
},
"segments": {
"items": [],
"total": 0,
"exhaustive": true,
"limitations": []
},
"provenance": [],
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
]
}
}
import_managed_reconstruction
Import Managed Reconstruction · idempotent
Import decompiler-produced managed reconstruction against authenticated inspect_managed_members Evidence. The workflow locks each method to artifact SHA-256, MVID, metadata token, signature hash, and the limited decoded-IL tuple hash, records the decompiler identity and options, and marks C# or pseudocode as analyst inference rather than canonical byte observation.
| Parameter | Type | Required | Description |
|---|---|---|---|
static_members |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Value for static members. |
decompiler |
object{name, version, family, executable_sha256, options} | yes | Value for decompiler. |
methods |
object{token, signature_sha256, normalized_il_sha256, reconstruction}[] | yes | Value for methods. |
notes |
string[] | Value for notes. |
Example:
{
"name": "import_managed_reconstruction",
"arguments": {
"static_members": {
"evidence_id": "ev_eda7b2f9c87c6c06501a79da58c41e8a78955042aee08f414b447901fe92b44b",
"subject": null,
"provider": {
"id": "rea-dotnet-static",
"name": "REA managed static analysis provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inspect_managed_members",
"parameters": {},
"raw_result": null,
"normalized_result": {
"artifact": {
"path": "/examples/22222222.dll",
"sha256": "2222222222222222222222222222222222222222222222222222222222222222",
"byte_length": 4096,
"format": "pe"
},
"module": {
"name": "Example.dll",
"generation": 0,
"mvid": "11112222-3333-4444-9555-666677778888",
"enc_id": null,
"enc_base_id": null,
"token": "0x00000001",
"row_offset": 0
},
"metadata": {
"status": "complete",
"version": "v4.0.30319",
"table_row_counts": {}
},
"identity_scope": {
"token_identity": "build-local",
"requires_artifact_sha256": "2222222222222222222222222222222222222222222222222222222222222222",
"requires_mvid": "11112222-3333-4444-9555-666677778888"
},
"types": [],
"fields": [],
"methods": [
{
"token": "0x06000001",
"row_offset": 128,
"declaring_type_token": "0x02000001",
"declaring_type": "Example.Program",
"name": "Main",
"rva": 8192,
"impl_flags": 0,
"flags": 22,
"signature": {
"raw_length": 3,
"raw_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"kind": "method",
"parse_status": "decoded",
"calling_convention": "default",
"generic_parameter_count": 0,
"parameter_count": 0,
"return_type": "void",
"parameter_types": [],
"field_type": null,
"issue": null
},
"body": {
"status": "present",
"header_format": "tiny",
"rva": 8192,
"file_offset": 512,
"max_stack": 8,
"init_locals": false,
"local_var_sig_token": null,
"il_size": 1,
"il_sha256": "4444444444444444444444444444444444444444444444444444444444444444",
"normalized_il_sha256": "5555555555555555555555555555555555555555555555555555555555555555",
"instruction_count": 1,
"decoded_instruction_count": 1,
"truncated_instructions": 0,
"opcode_counts": {
"ret": 1
},
"anchors": [],
"exception_regions": [],
"issue": null
}
}
],
"member_refs": [],
"call_edges": [],
"field_accesses": [],
"coverage": {
"state": "complete",
"issues": []
},
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
},
"decompiler": {
"name": "ilspycmd",
"version": "9.1.0.7988",
"family": "ilspy",
"executable_sha256": null,
"options": [
"--disable-updatecheck",
"--type",
"Example.Program"
]
},
"methods": [
{
"token": "0x06000001",
"signature_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"normalized_il_sha256": "5555555555555555555555555555555555555555555555555555555555555555",
"reconstruction": {
"kind": "decompiled-csharp",
"language": "csharp",
"text": "internal static void Main() { }",
"source_path": "/examples/Example.Program.cs",
"start_line": 1,
"end_line": 1
}
}
],
"notes": [
"Synthetic example only; decompiler output is imported as inference."
]
}
}
project_managed_application_graph
Project Managed Application Graph · idempotent
Project authenticated managed artifact, member, and native-boundary Evidence into the provider-neutral application graph without executing managed code, loading assemblies, or translating managed metadata tokens to native addresses. The graph preserves managed static observations as managed-specific nodes linked to source Evidence.
| Parameter | Type | Required | Description |
|---|---|---|---|
managed_artifact |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | Value for managed artifact. | |
managed_members |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | Value for managed members. | |
managed_native_boundaries |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | Value for managed native boundaries. |
Example:
{
"name": "project_managed_application_graph",
"arguments": {
"managed_members": {
"evidence_id": "ev_eda7b2f9c87c6c06501a79da58c41e8a78955042aee08f414b447901fe92b44b",
"subject": null,
"provider": {
"id": "rea-dotnet-static",
"name": "REA managed static analysis provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inspect_managed_members",
"parameters": {},
"raw_result": null,
"normalized_result": {
"artifact": {
"path": "/examples/22222222.dll",
"sha256": "2222222222222222222222222222222222222222222222222222222222222222",
"byte_length": 4096,
"format": "pe"
},
"module": {
"name": "Example.dll",
"generation": 0,
"mvid": "11112222-3333-4444-9555-666677778888",
"enc_id": null,
"enc_base_id": null,
"token": "0x00000001",
"row_offset": 0
},
"metadata": {
"status": "complete",
"version": "v4.0.30319",
"table_row_counts": {}
},
"identity_scope": {
"token_identity": "build-local",
"requires_artifact_sha256": "2222222222222222222222222222222222222222222222222222222222222222",
"requires_mvid": "11112222-3333-4444-9555-666677778888"
},
"types": [],
"fields": [],
"methods": [
{
"token": "0x06000001",
"row_offset": 128,
"declaring_type_token": "0x02000001",
"declaring_type": "Example.Program",
"name": "Main",
"rva": 8192,
"impl_flags": 0,
"flags": 22,
"signature": {
"raw_length": 3,
"raw_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"kind": "method",
"parse_status": "decoded",
"calling_convention": "default",
"generic_parameter_count": 0,
"parameter_count": 0,
"return_type": "void",
"parameter_types": [],
"field_type": null,
"issue": null
},
"body": {
"status": "present",
"header_format": "tiny",
"rva": 8192,
"file_offset": 512,
"max_stack": 8,
"init_locals": false,
"local_var_sig_token": null,
"il_size": 1,
"il_sha256": "4444444444444444444444444444444444444444444444444444444444444444",
"normalized_il_sha256": "5555555555555555555555555555555555555555555555555555555555555555",
"instruction_count": 1,
"decoded_instruction_count": 1,
"truncated_instructions": 0,
"opcode_counts": {
"ret": 1
},
"anchors": [],
"exception_regions": [],
"issue": null
}
}
],
"member_refs": [],
"call_edges": [],
"field_accesses": [],
"coverage": {
"state": "complete",
"issues": []
},
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
}
}
}
inspect_android_package
Inspect Android Package · idempotent
Inspect a local APK's package, SDK and permission declarations, decoded manifest and class/resource counts. Does not execute the APK or verify signatures. Requires a caller-supplied JADX MCP JAR and JDK; uses one worker in an isolated temporary workspace.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Local APK path; the target is never executed |
Example:
{
"name": "inspect_android_package",
"arguments": {
"path": "/tmp/Example.apk"
}
}
search_android_classes
Search Android Classes · idempotent
Search complete decompiler class names in an explicit local APK by case-sensitive substring. Empty query inventories all classes. Retains artifact and engine identity; no APK execution.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Local APK path; the target is never executed |
query |
string | yes | Case-sensitive class-name substring; empty lists all classes |
Example:
{
"name": "search_android_classes",
"arguments": {
"path": "/tmp/Example.apk",
"query": "Activity"
}
}
inspect_android_class
Inspect Android Class · idempotent
Inspect one exact Android class's parsed methods, fields and inner classes, including synthetic members. Returns display signatures and explicit unknown DEX descriptors without generating source. Overload indices remain consistent within the artifact and engine session.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Local APK path; the target is never executed |
class_name |
string | yes | Exact fully qualified class name |
Example:
{
"name": "inspect_android_class",
"arguments": {
"path": "/tmp/Example.apk",
"class_name": "example.MainActivity"
}
}
inspect_android_method
Inspect Android Method · idempotent
Decompile one Android method with smali fallback. Requires explicit overload_index when multiple methods share a name. Reports representation, fallback markers and source truncation; never treats display signatures as exact DEX identities.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Local APK path; the target is never executed |
class_name |
string | yes | Exact fully qualified class name |
method_name |
string | yes | Value for method name. |
overload_index |
integer | Explicit index among same-name methods; required when ambiguous |
Example:
{
"name": "inspect_android_method",
"arguments": {
"path": "/tmp/Example.apk",
"class_name": "example.MainActivity",
"method_name": "onCreate"
}
}
trace_android_references
Trace Android References · idempotent
Trace incoming static references to an exact Android class or unique method. Overloaded method reference queries are explicitly unsupported by the current engine. Source lines and DEX offsets remain unknown; no runtime calls are inferred.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Local APK path; the target is never executed |
class_name |
string | yes | Exact fully qualified class name |
method_name |
string | Omit for class references; ambiguous overloaded methods are unsupported |
Example:
{
"name": "trace_android_references",
"arguments": {
"path": "/tmp/Example.apk",
"class_name": "example.MainActivity"
}
}
inspect_binary_layout
Inspect Binary Layout · idempotent
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute filesystem path to the selected binary |
Example:
{
"name": "inspect_binary_layout",
"arguments": {
"path": "/artifacts/application.elf"
}
}
inspect_analysis_view
Inspect Analysis View · idempotent
Inspect a selected view of completed binary-layout or JavaScript application Evidence without repeating analysis. Use an exact same-session retained evidence_id or portable inline Evidence. Select a summary, layout mitigations/linkage facet, one section/symbol/module, or a stable page with a positive limit. Module pages contain JavaScript assets, bundled modules and source modules; use node_id when paths are ambiguous or unavailable. Returns selected facts inline with artifact identity, parent Evidence ID, a distinct view digest, coverage, limitations and unknowns. Actual serialized size determines MCP transport admission; choose a smaller page or export the retained Evidence when needed.
| Parameter | Type | Required | Description |
|---|---|---|---|
source |
object{kind, evidence_id} | object{kind, evidence} | yes | Value for source. |
view |
object{kind} | object{kind, facet} | object{kind, collection, selector} | object{kind, collection, offset, limit} | yes | Value for view. |
Example:
{
"name": "inspect_analysis_view",
"arguments": {
"source": {
"kind": "retained-evidence",
"evidence_id": "ev_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"view": {
"kind": "summary"
}
}
}
inspect_evm_interface
Inspect Evm Interface · idempotent
Inspect an explicit local flat EVM bytecode carrier and infer dispatch selectors, argument strings and mutability without executing the target or accessing a chain/RPC endpoint. Choose raw or hex encoding explicitly. Returns original carrier and decoded-byte SHA-256, full bytecode and interface candidates inline as inferred Evidence; bytecode kind, hardfork, deployed authenticity and discovery completeness remain unknown. Initial real-verified Linux x64 profile uses unchanged bundled EVMole 0.9.3/WASM in a bounded owned worker; EOF-style EF00 containers are unsupported. No signature lookup, wallet action or transaction broadcast.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute path to caller-selected local bytecode carrier |
encoding |
"raw" | "hex" |
yes | Raw bytes or UTF-8 hex with optional 0x prefix and outer ASCII whitespace |
Example:
{
"name": "inspect_evm_interface",
"arguments": {
"path": "/artifacts/runtime.hex",
"encoding": "hex"
}
}
inspect_recorded_crash
Inspect Recorded Crash · idempotent
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.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute filesystem path to a supplied Linux ELF core |
include_debugger_context |
boolean | Add core-only mapping candidates through caller-supplied GDB/pwndbg |
Example:
{
"name": "inspect_recorded_crash",
"arguments": {
"path": "/artifacts/crash.core"
}
}
inspect_firmware_regions
Inspect Firmware Regions · idempotent
Inspect signature candidates in a local firmware file with Binwalk 3.1.x (verified with 3.1.0). Returns offsets, reported lengths, descriptions and raw confidence values. Length validation and runtime addresses remain unknown. No extraction or target execution. Linux, caller-supplied tool and util-linux prlimit required; 128 MiB input limit, one worker and 120-second deadline.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute local firmware file; never executed. Relative paths are rejected. |
Example:
{
"name": "inspect_firmware_regions",
"arguments": {
"path": "/tmp/firmware.bin"
}
}
extract_firmware
Extract Firmware
Extract caller-selected firmware bytes with Unblob 26.6.x (verified with 26.6.4) into an absent output directory. Returns verified child paths/digests, task derivations, unknown chunks and extraction diagnostics inline. Preserves the default sandbox; publishes regular files only. Linux, caller-supplied tool, format-specific extractors and util-linux prlimit required. No mounts or extracted-code execution. Select a returned native file with open_binary for Ghidra analysis; decompressed offsets are not original-file addresses.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute local firmware file; never executed. Relative paths are rejected. |
output_directory |
string | yes | Absolute, absent output directory; parent must exist |
range |
object{offset, length} | Explicit file-byte interval; omit to extract the whole file | |
max_depth |
integer | Extraction depth; reaching it yields partial analysis | |
max_output_bytes |
integer | Staging file-byte budget, checked during extraction; transient overshoot is possible | |
max_output_files |
integer | Staging entry budget, including directories and links |
Example:
{
"name": "extract_firmware",
"arguments": {
"path": "/tmp/firmware.bin",
"output_directory": "/tmp/firmware-output",
"range": {
"offset": 64,
"length": 4096
}
}
}
trace_web_module_imports
Trace Web Module Imports · idempotent
Trace one exported website script's outgoing native ES imports/re-exports, using exact URL and optional selected import-map context. Reads a local export_web_scripts manifest and verifies the selected source's SHA-256/size; returns source positions, native resolved URLs or exact errors, every matching captured candidate and explicit unknown execution. Query/fragment identities are preserved. Computed imports and bundler IDs remain unknown. Select importer_url for unknown inline/document-base context. Caller-supplied Chromium executes only a trusted REA resolver stub in an owned context with page requests locally fulfilled/blocked; no captured application execution or asset refetch. Requires absolute REA_BROWSER_EXECUTABLE for literal imports. 32 MiB manifest, 16 MiB source, 4 MiB map and 20-second native deadline; cleanup may extend the deadline.
| Parameter | Type | Required | Description |
|---|---|---|---|
manifest_path |
string | yes | Absolute path to an export_web_scripts manifest |
script_index |
integer | yes | Zero-based index in manifest.scripts |
importer_url |
string | Explicit HTTP(S) module URL; useful when captured inline/base context is unknown | |
import_map |
object{path, base_url} | Value for import map. |
Example:
{
"name": "trace_web_module_imports",
"arguments": {
"manifest_path": "/analysis/exported-scripts/manifest.json",
"script_index": 0,
"import_map": {
"path": "/analysis/import-map.json",
"base_url": "https://example.test/app/"
}
}
}
trace_web_source_location
Trace Web Source Location · idempotent
Trace one generated position in an exported website script through an explicitly paired local source map. Verifies manifest, selected script and map SHA-256/byte identities; returns every equal-position mapping, reported source/root, resolved source URL, embedded sourcesContent and original position inline. One-based lines and zero-based UTF-16 columns; greatest generated position <= requested across lines. Duplicate sources and generated-only mappings remain distinct. Caller-selected pairing does not establish deployment authenticity or execution. Regular maps and inline indexed sections only; external section URLs are unsupported. No network access or application execution; uses the pinned upstream codec in an owned Node process with private temporary files, independent 192 MiB old-generation heap and 20-second deadline. 4 MiB map, 32 MiB reply; complete evidence or actionable resource failure. Cleanup may extend the deadline.
| Parameter | Type | Required | Description |
|---|---|---|---|
manifest_path |
string | yes | Absolute export_web_scripts manifest path |
script_index |
integer | yes | Zero-based index in manifest.scripts |
source_map |
object{path, url} | yes | Value for source map. |
generated_position |
object{line, column} | yes | Value for generated position. |
Example:
{
"name": "trace_web_source_location",
"arguments": {
"manifest_path": "/analysis/scripts/manifest.json",
"script_index": 0,
"source_map": {
"path": "/analysis/app.js.map",
"url": "https://example.test/app.js.map"
},
"generated_position": {
"line": 1,
"column": 25
}
}
}
observe_web_execution
Observe Web Execution · destructive
Instrument one selected CDP page for a finite, externally driven precise coverage window. Resets execution counters and prevents optimized execution until stopped. Returns complete nested UTF-16 ranges/counts, independently hashed script text and request initiator associations by session script ID. Does not navigate, click, evaluate selected code or close the externally owned page. Navigation ends document-scoped collection; workers and UI causality remain outside this claim. Emits an actual armed progress notification before external actions.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
observation_ms |
integer | Value for observation ms. |
Example:
{
"name": "observe_web_execution",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS",
"observation_ms": 10000
}
}
inspect_web_event_listeners
Inspect Web Event Listeners · idempotent
Inspect listeners registered directly on the first main-document CSS match in one selected CDP page. Returns event flags, native callback locations, source ownership and exact script text/digests inline. Does not dispatch events, evaluate JavaScript or invoke handlers. Delegated ancestor/framework listeners and execution history remain unknown. Releases REA's object group and transport, preserving the external page.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
selector |
string | yes | Value for selector. |
Example:
{
"name": "inspect_web_event_listeners",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS",
"selector": "#submit"
}
}
inspect_web_network_capture
Inspect Web Network Capture · idempotent
Inspect retained local HAR 1.2 or native mitmproxy capture records without contacting recorded URLs. Returns original ordinals, pointers/byte ranges, preserved producer fields, precise numeric representations and exact exposed binary bytes inline. Excludes known transport credentials and explicitly marked values. Decodes every record before optional ordinal selection; malformed or oversized captures return no partial success. Duplicate HAR members are invalid; prototype-named members such as proto are preserved as ordinary own JSON members without prototype mutation. Uses pinned upstream parsers, owned temporary files and bounded offline processes. Native mitmproxy requires caller-supplied mitmdump 12.2.3 on Linux. Browser transaction IDs, runtime attribution and original bytes of HAR Unicode text remain unknown.
| Parameter | Type | Required | Description |
|---|---|---|---|
capture_path |
string | yes | Absolute local HAR or mitmproxy capture path. |
format |
"har" | "mitmproxy" |
yes | Declared input artifact format. |
record_ordinals |
integer[] | Zero-based producer record ordinals, in caller-selected order. Omit to inspect every record. | |
sensitive_values |
string[] | Literal text excluded from capture payloads, byte/numeric projections, producer coordinates, artifact paths/digests and diagnostic text. Declaration strings are never persisted in Evidence parameters. Canonical contract keys, enums and provider identities remain intact. |
Example:
{
"name": "inspect_web_network_capture",
"arguments": {
"capture_path": "/captures/session.har",
"format": "har",
"record_ordinals": [
0,
2
]
}
}
recover_javascript_sources
Recover Javascript Sources
Recover readable modules from one local UTF-8 JavaScript script/bundle into an absent directory, using caller-supplied Wakaru 1.13.0 on Linux x64. Returns original/derived digests, extraction byte ranges, emitted source maps, warnings and analysis_input inline. Structural splitting may fall back to one module; original names and runtime equivalence remain unknown. No application code execution. Requires util-linux prlimit; one worker, 1 GiB address-space ceiling, 120-second deadline, 64 MiB input, 128 MiB output, 10000 entries and 8 MiB per diagnostic/report stream.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute path to a UTF-8 JavaScript file; never executed |
output_directory |
string | yes | Absolute absent output directory; parent must exist |
extraction_mode |
"structural" | "heuristic" | "inspection" |
Structural module boundaries, heuristic fallback, or finer inspection-only regions | |
rewrite_level |
"minimal" | "standard" | "aggressive" |
Upstream syntax recovery level; runtime equivalence remains unverified |
Example:
{
"name": "recover_javascript_sources",
"arguments": {
"path": "/tmp/web-scripts/app.js",
"output_directory": "/tmp/recovered-app"
}
}
export_web_scripts
Export Web Scripts
Export JavaScript bytes already retained in one local inspect_web_page or capture_browser_scenario JSON capture (normalized result or complete Evidence). Writes scripts and a digest-verified manifest into an absent absolute output_directory. Returns all source URLs, script or transaction/event references, unavailable states, and an analysis_input for analyze_javascript_application when any bytes were exported. Include script sources in inspect_web_page or select capture.network.response_body in scenarios. No refetch or execution. Safe unambiguous URL layouts preserve relative module paths; versions, query variants, inline scripts, and path collisions are isolated with explicit resolution limitations.
| Parameter | Type | Required | Description |
|---|---|---|---|
capture_path |
string | yes | Absolute filesystem path to saved inspect_web_page or capture_browser_scenario JSON, normalized result or complete Evidence |
output_directory |
string | yes | Absolute absent filesystem directory for verified scripts and manifest; parent directory must exist |
Example:
{
"name": "export_web_scripts",
"arguments": {
"capture_path": "/analysis/capture.json",
"output_directory": "/analysis/exported-scripts"
}
}
list_browser_targets
List Browser Targets · idempotent
List page targets exposed by the selected loopback Chrome DevTools Protocol endpoint. Optionally filter by exact origin. URLs preserve query values and fragments; only URL userinfo credentials are removed.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. |
Example:
{
"name": "list_browser_targets",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222"
}
}
inspect_web_page
Inspect Web Page · idempotent
Passively inspect one selected page target through CDP without evaluating JavaScript, navigating, clicking, closing, or mutating the page. If no origin filter is supplied, capture is scoped to the target's current origin. Returns DOM structure, accessibility, scripts, resources, attach-window network and console metadata, workers, and redacted storage inventory as Evidence.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
observation_ms |
integer | Value for observation ms. | |
include_accessibility_text |
boolean | Whether to include accessibility text in the result. | |
include_console_text |
boolean | Whether to include console text in the result. | |
include_json_body_shapes |
boolean | Whether to include json body shapes in the result. | |
include_websocket_shapes |
boolean | Whether to include websocket shapes in the result. | |
include_storage_keys |
boolean | Whether to include storage keys in the result. | |
include_storage_fingerprints |
boolean | Whether to include storage fingerprints in the result. | |
include_script_sources |
false | true |
Whether to include script sources in the result. |
Example:
{
"name": "inspect_web_page",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS"
}
}
analyze_web_bundle
Analyze Web Bundle · idempotent
Capture JavaScript source from one selected CDP page and statically derive a chunk graph, route and endpoint candidates, vendor fingerprints, page-declared WebMCP metadata, and optionally fetch source maps from the selected target origin or explicitly requested origins. JavaScript is parsed but never executed.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
observation_ms |
integer | Value for observation ms. | |
include_accessibility_text |
boolean | Whether to include accessibility text in the result. | |
include_console_text |
boolean | Whether to include console text in the result. | |
include_json_body_shapes |
boolean | Whether to include json body shapes in the result. | |
include_websocket_shapes |
boolean | Whether to include websocket shapes in the result. | |
include_storage_keys |
boolean | Whether to include storage keys in the result. | |
include_storage_fingerprints |
boolean | Whether to include storage fingerprints in the result. | |
include_script_sources |
true |
Whether to include script sources in the result. | |
fetch_source_maps |
boolean | Value for fetch source maps. |
Example:
{
"name": "analyze_web_bundle",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS",
"observation_ms": 500,
"include_accessibility_text": false,
"include_script_sources": true,
"include_storage_keys": false,
"fetch_source_maps": false
}
}
observe_web_session
Observe Web Session · idempotent
Arm a CDP observation window of the requested duration while the user operates the page. By default it follows the selected target's current origin; an explicit origin list controls which origins may be retained. Records navigation, redirect, lifecycle, and failure events.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
observation_ms |
integer | Value for observation ms. |
Example:
{
"name": "observe_web_session",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS",
"observation_ms": 10000
}
}
discover_webmcp_tools
Discover Webmcp Tools · idempotent
Passively inventory every page-registered WebMCP tool and its complete structural input-schema summary using the experimental CDP WebMCP domain. Metadata is page-declared-untrusted; REA never registers or invokes discovered tools.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
observation_ms |
integer | Value for observation ms. |
Example:
{
"name": "discover_webmcp_tools",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS",
"observation_ms": 100
}
}
compare_web_captures
Compare Web Captures · idempotent
Compare passive web captures by providing before and after, each with the complete inspect_web_page normalized_result in inspection and an optional complete discover_webmcp_tools normalized_result in webmcp; or compare recorded scenarios by passing complete capture_browser_scenario normalized_result objects in before_scenario and after_scenario with an optional normalization policy. Use exactly one input group. Scenario comparison aligns exact step IDs, records deterministic literal normalization, and returns every artifact-level difference plus alignment failures inline. Missing or truncated evidence never proves equality.
| Parameter | Type | Required | Description |
|---|---|---|---|
before |
object{inspection, webmcp} | The earlier or left-hand observation to compare. | |
after |
object{inspection, webmcp} | The later or right-hand observation to compare. | |
before_scenario |
object{browser, scenario, duration_ms, steps, events, completeness, limitations} | Earlier complete normalized_result from capture_browser_scenario. | |
after_scenario |
object{browser, scenario, duration_ms, steps, events, completeness, limitations} | Later complete normalized_result from capture_browser_scenario. | |
normalization |
object{rules} | Exact-literal rules committed in the comparison result. |
Example:
{
"name": "compare_web_captures",
"arguments": {
"before_scenario": {
"browser": {
"mode": "connect",
"process_ownership": "external",
"cleanup": "disconnected-external",
"product": "Chromium",
"version": "149"
},
"scenario": {
"start_origin": "https://app.example.test",
"action_count": 1,
"secret_references": [],
"network_content": {
"request_body": false,
"response_body": false,
"header_values": false
}
},
"duration_ms": 10,
"steps": [
{
"step_index": 0,
"step_id": "scenario_start",
"action": "scenario_start",
"status": "completed",
"elapsed_ms": 0,
"before_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"after_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"error": null,
"event_sequence_start": 1,
"event_sequence_end": 0,
"artifacts": {
"screenshot": {
"state": "not_requested"
},
"dom": {
"state": "not_requested"
},
"accessibility": {
"state": "not_requested"
},
"url": {
"state": "not_requested"
},
"history": {
"state": "not_requested"
},
"storage": {
"state": "not_requested"
}
},
"completeness": {
"status": "complete",
"equality_eligible": true,
"missing_sections": [],
"truncated_sections": []
}
},
{
"step_index": 1,
"step_id": "open-settings",
"action": "click",
"status": "completed",
"elapsed_ms": 10,
"before_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"after_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"error": null,
"event_sequence_start": 1,
"event_sequence_end": 0,
"artifacts": {
"screenshot": {
"state": "not_requested"
},
"dom": {
"state": "not_requested"
},
"accessibility": {
"state": "not_requested"
},
"url": {
"state": "not_requested"
},
"history": {
"state": "not_requested"
},
"storage": {
"state": "not_requested"
}
},
"completeness": {
"status": "complete",
"equality_eligible": true,
"missing_sections": [],
"truncated_sections": []
}
}
],
"events": {
"retained": 0,
"dropped": 0,
"items": []
},
"completeness": {
"status": "complete",
"equality_eligible": true,
"missing_sections": [],
"truncated_sections": []
},
"limitations": []
},
"after_scenario": {
"browser": {
"mode": "connect",
"process_ownership": "external",
"cleanup": "disconnected-external",
"product": "Chromium",
"version": "149"
},
"scenario": {
"start_origin": "https://app.example.test",
"action_count": 1,
"secret_references": [],
"network_content": {
"request_body": false,
"response_body": false,
"header_values": false
}
},
"duration_ms": 10,
"steps": [
{
"step_index": 0,
"step_id": "scenario_start",
"action": "scenario_start",
"status": "completed",
"elapsed_ms": 0,
"before_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"after_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"error": null,
"event_sequence_start": 1,
"event_sequence_end": 0,
"artifacts": {
"screenshot": {
"state": "not_requested"
},
"dom": {
"state": "not_requested"
},
"accessibility": {
"state": "not_requested"
},
"url": {
"state": "not_requested"
},
"history": {
"state": "not_requested"
},
"storage": {
"state": "not_requested"
}
},
"completeness": {
"status": "complete",
"equality_eligible": true,
"missing_sections": [],
"truncated_sections": []
}
},
{
"step_index": 1,
"step_id": "open-settings",
"action": "click",
"status": "completed",
"elapsed_ms": 10,
"before_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"after_url": {
"url": "https://app.example.test/",
"origin": "https://app.example.test",
"query_parameter_names": [],
"redacted": false
},
"error": null,
"event_sequence_start": 1,
"event_sequence_end": 0,
"artifacts": {
"screenshot": {
"state": "not_requested"
},
"dom": {
"state": "not_requested"
},
"accessibility": {
"state": "not_requested"
},
"url": {
"state": "not_requested"
},
"history": {
"state": "not_requested"
},
"storage": {
"state": "not_requested"
}
},
"completeness": {
"status": "complete",
"equality_eligible": true,
"missing_sections": [],
"truncated_sections": []
}
}
],
"events": {
"retained": 0,
"dropped": 0,
"items": []
},
"completeness": {
"status": "complete",
"equality_eligible": true,
"missing_sections": [],
"truncated_sections": []
},
"limitations": []
},
"normalization": {
"rules": [
{
"rule_id": "volatile-build-id",
"artifacts": [
"dom",
"accessibility"
],
"match": "build-123",
"replacement": "[BUILD_ID]"
}
]
}
}
}
capture_web_screenshot
Capture Web Screenshot · idempotent
Capture the current visible viewport of one configured page as an inline, content-addressed PNG artifact. The operation never scrolls, navigates, or evaluates page JavaScript.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
allowed_origins |
string[] | Value for allowed origins. | |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
Example:
{
"name": "capture_web_screenshot",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9222",
"target_id": "TARGET_ID_FROM_LIST_BROWSER_TARGETS"
}
}
compare_web_screenshots
Compare Web Screenshots · idempotent
Compare two self-verifying PNG screenshot artifacts with local pixel metrics. Returns exact changed-pixel ratios and channel deltas without OCR or external services.
| Parameter | Type | Required | Description |
|---|---|---|---|
before |
object{sha256, bytes, media_type, data_base64} | yes | The earlier or left-hand observation to compare. |
after |
object{sha256, bytes, media_type, data_base64} | yes | The later or right-hand observation to compare. |
channel_threshold |
integer | Value for channel threshold. |
Example:
{
"name": "compare_web_screenshots",
"arguments": {
"before": {
"sha256": "153cf6c9a526a63053a37b10234c2fd85df38887c2dc0a800d90abfa6631d01c",
"bytes": 70,
"media_type": "image/png",
"data_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PzWvWQAAAABJRU5ErkJggg=="
},
"after": {
"sha256": "153cf6c9a526a63053a37b10234c2fd85df38887c2dc0a800d90abfa6631d01c",
"bytes": 70,
"media_type": "image/png",
"data_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8/5+hHgAHggJ/PzWvWQAAAABJRU5ErkJggg=="
},
"channel_threshold": 0
}
}
capture_browser_scenario
Capture Browser Scenario · destructive
Run a controlled browser scenario when passive observation cannot exercise the application. Launch the selected executable or connect to a loopback CDP target, provide a start URL and actions, and select storage or artifacts when needed. Environment, empty storage, and a URL-only final capture are defaults. capture.network selects request_body, response_body, and header_values independently; selected content is returned inline with transaction and event references, byte digests, and explicit unavailable states. Credentials and declared secrets are redacted. Agents can run their own local fixture servers to control application responses. Actions run until completion or cancellation unless timeout_ms is set. Results are returned inline.
| Parameter | Type | Required | Description |
|---|---|---|---|
browser |
object{mode, executable_path, headless} | object{mode, cdp_endpoint, target_id} | yes | Required launch/connect selection. Launch uses the selected executable and an owned temporary profile; connect uses one loopback CDP endpoint and target. |
start_url |
object{url, query} | yes | Required initial HTTP(S) URL. Query values must be declared separately as public literals or secret references. |
environment |
object{viewport, locale, timezone, color_scheme, reduced_motion, service_workers} | Optional deterministic browser settings. Defaults to 1280x720, en-US, UTC, light mode, reduced motion, and blocked service workers. | |
actions |
object{step_id, timeout_ms, action, destination, wait_until} | object{step_id, timeout_ms, action, locator, button, click_count} | object{step_id, timeout_ms, action, locator, value} | object{step_id, timeout_ms, action, locator, key} | object{step_id, timeout_ms, action, locator} | object{step_id, timeout_ms, action, locator, state} | object{step_id, action, duration_ms}[] | yes | Required sequence of explicit browser actions. |
storage |
object{cookies, local_storage, session_storage} | Optional initial cookies, local storage, or session storage. Defaults to empty; every supplied value and origin must be declared and within the allowed origins. | |
secrets |
object{secret_id, environment_variable}[] | Optional environment-variable references for values used in actions, URLs, storage, or replay, and for redacting matching observed text. Secret values are never supplied inline. | |
capture |
object{after_each_step, at_end, events, network} | Optional retained artifacts and event families. Defaults to only a final sanitized URL; request screenshots, DOM, accessibility, history, storage, and event capture explicitly. |
Example:
{
"name": "capture_browser_scenario",
"arguments": {
"browser": {
"mode": "launch",
"executable_path": "/opt/chromium/chrome"
},
"start_url": {
"url": "https://app.example.test/",
"query": []
},
"actions": [
{
"step_id": "settle",
"action": "wait_for_timeout",
"duration_ms": 250
}
]
}
}
list_electron_targets
List Electron Targets · idempotent
List every Electron file:// page target from a selected loopback CDP endpoint. Local file paths are canonicalized after symlink resolution. Selecting an endpoint exposes every eligible target and its local path metadata.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
Example:
{
"name": "list_electron_targets",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9223"
}
}
inspect_electron_page
Inspect Electron Page · idempotent
Passively inspect one Electron file page by supplying its loopback CDP endpoint and target ID. The provider rechecks that the target currently exists at that endpoint and is a local file page. Returns frames, DOM structure, resource paths, and scripts without evaluating renderer JavaScript or invoking Electron APIs. The selected endpoint exposes every local file page and its metadata to this tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
cdp_endpoint |
string | yes | Literal loopback Chrome DevTools Protocol endpoint. |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
observation_ms |
integer | Value for observation ms. | |
include_script_sources |
false | true |
Whether to include script sources in the result. |
Example:
{
"name": "inspect_electron_page",
"arguments": {
"cdp_endpoint": "http://127.0.0.1:9223",
"target_id": "TARGET_ID_FROM_LIST_ELECTRON_TARGETS"
}
}
analyze_javascript_application
Analyze Javascript Application · idempotent
Reconstruct one local ASAR or extracted JavaScript application as an inline application graph without executing it. Returns recovered graph nodes, edges, semantic relations, integrity contradictions, limitations, and coverage. Integrity mismatches fail by default; record-and-continue retains observed bytes as untrusted and marks graph coverage partial.
| Parameter | Type | Required | Description |
|---|---|---|---|
input_path |
string | yes | Local filesystem path for input. |
format |
"auto" | "asar" | "directory" |
Declared input artifact format. | |
integrity_policy |
"fail" | "record-and-continue" |
Value for integrity policy. |
Example:
{
"name": "analyze_javascript_application",
"arguments": {
"input_path": "/Applications/Example.app/Contents/Resources/app.asar",
"format": "auto",
"integrity_policy": "fail"
}
}
reconcile_javascript_runtime
Reconcile Javascript Runtime · idempotent
Reconcile verified static JavaScript application graphs with existing passive web/Electron CDP, passive V8 Inspector, or provider-owned active Electron Evidence. Active Electron captures contribute an explicitly partial target-only runtime record; they never invent renderer scripts, frames, workers, or execution claims. Exact captured-source digests take priority over caller-declared file/URL mappings; target, frame, script, and worker ambiguity remains explicit, and source-map authority stays separate.
| Parameter | Type | Required | Description |
|---|---|---|---|
static_layers |
object{role, analysis, runtime_mappings}[] | yes | Value for static layers. |
runtime_observations |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Value for runtime observations. |
Example:
{
"name": "reconcile_javascript_runtime",
"arguments": {
"static_layers": [
{
"analysis": {
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"subject": {
"name": "app",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "directory",
"architecture": null,
"local_path": "/Applications/Example.app/Contents/Resources/app"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/Applications/Example.app/Contents/Resources/app",
"format": "directory",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"inventory_manifest_id": "agm_2222222222222222222222222222222222222222222222222222222222222222",
"inventory_graph_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"nodes": [
{
"node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"identity": {
"strategy": "content-digest",
"stability": "global-exact",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"observations": [
{
"label": "renderer.js",
"source_map_reference": null,
"properties": {
"path": "renderer.js",
"bytes": 29
},
"evidence": {
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": []
},
"observation_id": "jag_observation_fca009266d0c5ec856e03358df5eb70f339655f7772026e82f9e85151e73bd85",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1"
},
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"application_graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1",
"root_node_ids": [
"jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a"
],
"evidence_contexts": [
{
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": [],
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"module_path": "renderer.js",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"label": "renderer.js",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7",
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
}
},
"node_id": "jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": 0,
"omitted_relations": 0,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
}
]
},
"limitations": [
"Semantic relations are unavailable in this minimal example."
],
"graph_id": "jsrg_c7fb354de642c93da6c2f4a52ac1d69bc02c01d7adf4ae36c4e1418c2c86468f"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 29,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 1,
"findings": 0,
"modules": 0,
"parse_failures": 0
},
"limitations": []
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
}
],
"runtime_observations": [
{
"evidence_id": "ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5",
"subject": null,
"provider": {
"id": "rea-cdp-electron",
"name": "REA Electron file-page CDP observation provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.electron-page-inspection",
"operation": "inspect_electron_page",
"parameters": {
"cdp_endpoint": "http://127.0.0.1:9223",
"target_id": "example-target",
"include_script_sources": true
},
"raw_result": null,
"normalized_result": {
"browser": {
"product": "Electron/example",
"protocol_version": "1.3",
"revision": "example",
"user_agent": "Electron example",
"js_version": "1"
},
"target": {
"target_id": "example-target",
"type": "page",
"title": "Example",
"file_path": "/Applications/Example.app/Contents/Resources/app/index.html",
"attached": false
},
"capture_window": {
"started_at": "2026-07-15T00:00:00.000Z",
"ended_at": "2026-07-15T00:00:00.100Z",
"observation_ms": 100
},
"completeness": {
"status": "complete_within_window",
"conditions": [
"complete_within_window"
],
"policy_filtered_sections": [],
"attach_limited_sections": [],
"truncated_sections": [],
"unavailable_sections": [],
"excluded": [],
"dropped_events": {
"scripts": 0,
"network_requests": 0,
"console_events": 0,
"websocket_connections": 0,
"websocket_frames": 0,
"webmcp_tools": 0,
"timeline_events": 0,
"total": 0
}
},
"frames": [],
"dom": {
"total_nodes": 0,
"nodes": []
},
"scripts": {
"total": 1,
"items": [
{
"script_key": "electron_script_4444444444444444444444444444444444444444444444444444444444444444",
"frame_id": null,
"file_path": "/Applications/Example.app/Contents/Resources/app/renderer.js",
"cdp_hash": "example",
"length": 29,
"is_module": true,
"language": "JavaScript",
"source": {
"included": true,
"artifact": {
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"bytes": 29,
"media_type": "text/javascript",
"charset": "utf-8",
"text": "export const example = true;\n"
}
}
}
]
},
"resources": [],
"workers": [],
"limitations": [
"Example passive capture."
]
},
"confidence": "observed",
"authority": "external-service",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
}
]
}
}
capture_electron_scenario
Capture Electron Scenario · destructive
Use this for a provider-owned Electron run when passive CDP or Inspector observation cannot exercise application behavior. REA owns startup and teardown, accepts caller-defined click/wait actions plus window-targeted renderer reload/crash and synthetic open-url/second-instance delivery, and returns correlated window/WebContents/process/preload/session/navigation/shell/IPC evidence without retaining payload values. Actions wait for completion or request cancellation; a missing click target can keep the request pending. Results identify observed and unavailable event families, coverage status, action targets, and truncation. Cleanup failures retain collected observations with explicit cleanup uncertainty. External shell, navigation, permission, download, popup, updater, and OS-integration effects are blocked and recorded. Use passive Electron tools for observation-only work.
| Parameter | Type | Required | Description |
|---|---|---|---|
executable_path |
string | yes | Absolute local filesystem path for the Electron executable; relative paths are rejected. |
application_path |
string | yes | Absolute local filesystem path for the Electron application; relative paths are rejected. |
application_root |
string | Absolute local filesystem root for application-relative paths; omit to derive it from the application path. Relative paths are rejected. | |
args |
string[] | Value for args. | |
actions |
object{step_id, kind, selector, window_index} | object{step_id, kind, duration_ms, window_index} | object{step_id, kind, window_index} | object{step_id, kind, delivery, url}[] | Value for actions. |
Example:
{
"name": "capture_electron_scenario",
"arguments": {
"executable_path": "/Applications/Electron.app/Contents/MacOS/Electron",
"application_path": "/Applications/Example.app/Contents/Resources/main.js",
"args": [],
"actions": [
{
"step_id": "exercise-ipc",
"kind": "click",
"selector": "#run"
}
]
}
}
list_javascript_runtime_targets
List Javascript Runtime Targets · idempotent
List every eligible Node/Electron V8 Inspector target from an explicit literal-loopback endpoint. Node discovery file locations that cannot be verified are preserved as unresolved reported URLs; they do not prove filesystem identity. Listing does not attach to targets.
| Parameter | Type | Required | Description |
|---|---|---|---|
inspector_endpoint |
string | yes | Value for inspector endpoint. |
Example:
{
"name": "list_javascript_runtime_targets",
"arguments": {
"inspector_endpoint": "http://127.0.0.1:9229"
}
}
observe_javascript_runtime
Observe Javascript Runtime · idempotent
Attach passively to one Node/Electron V8 Inspector target by supplying its loopback Inspector endpoint and target ID. The provider rechecks target presence and attachability; a Node discovery file location may remain unresolved. Loaded script locations are validated independently from Debugger.scriptParsed. Captures script and Runtime execution-context metadata. REA never evaluates, pauses, resumes, reads source, or instruments the target; require/import edges, EventEmitter activity, and Electron IPC remain explicit unknowns. Reconcile the result with static Application Graph Evidence using reconcile_javascript_runtime. The selected endpoint exposes every target it serves to this tool.
| Parameter | Type | Required | Description |
|---|---|---|---|
inspector_endpoint |
string | yes | Value for inspector endpoint. |
target_id |
string | yes | Exact CDP target identifier selected from the endpoint's target listing. |
runtime_kind |
"node" | "electron-main" | "electron-preload" | "electron-renderer" |
Value for runtime kind. | |
observation_ms |
integer | Value for observation ms. |
Example:
{
"name": "observe_javascript_runtime",
"arguments": {
"inspector_endpoint": "http://127.0.0.1:9229",
"target_id": "TARGET_ID_FROM_LIST_JAVASCRIPT_RUNTIME_TARGETS"
}
}
trace_application_feature
Trace Application Feature · idempotent
Trace a typed literal seed through every reachable part of an authenticated JavaScript Application Graph supplied as inline Evidence or exact same-session retained references. Original static, native, passive-runtime, inferred, and unknown authorities remain distinct; native addon handoffs never open a provider or execute the application.
| Parameter | Type | Required | Description |
|---|---|---|---|
native_observations |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | Value for native observations. | |
seed |
object{kind, value, match, case_sensitive} | yes | Value for seed. |
direction |
"outgoing" | "incoming" | "both" |
Direction in which to traverse or compare relationships. | |
application |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Value for application. |
Example:
{
"name": "trace_application_feature",
"arguments": {
"application": {
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"subject": {
"name": "app",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "directory",
"architecture": null,
"local_path": "/Applications/Example.app/Contents/Resources/app"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/Applications/Example.app/Contents/Resources/app",
"format": "directory",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"inventory_manifest_id": "agm_2222222222222222222222222222222222222222222222222222222222222222",
"inventory_graph_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"nodes": [
{
"node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"identity": {
"strategy": "content-digest",
"stability": "global-exact",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"observations": [
{
"label": "renderer.js",
"source_map_reference": null,
"properties": {
"path": "renderer.js",
"bytes": 29
},
"evidence": {
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": []
},
"observation_id": "jag_observation_fca009266d0c5ec856e03358df5eb70f339655f7772026e82f9e85151e73bd85",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1"
},
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"application_graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1",
"root_node_ids": [
"jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a"
],
"evidence_contexts": [
{
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": [],
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"module_path": "renderer.js",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"label": "renderer.js",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7",
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
}
},
"node_id": "jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": 0,
"omitted_relations": 0,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
}
]
},
"limitations": [
"Semantic relations are unavailable in this minimal example."
],
"graph_id": "jsrg_c7fb354de642c93da6c2f4a52ac1d69bc02c01d7adf4ae36c4e1418c2c86468f"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 29,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 1,
"findings": 0,
"modules": 0,
"parse_failures": 0
},
"limitations": []
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
},
"seed": {
"kind": "module",
"value": "renderer.js",
"match": "exact",
"case_sensitive": false
},
"direction": "both"
}
}
trace_javascript_semantics
Trace Javascript Semantics · idempotent
Trace static JavaScript data-flow, direct call/return, and closure relations from inline application Evidence or an exact same-session retained reference. Dynamic or unsupported semantics remain explicit unknowns; static reachability never claims runtime execution.
| Parameter | Type | Required | Description |
|---|---|---|---|
application |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Value for application. |
query |
object{seed, direction, allowed_relations, include_ambiguous_dynamic_edges, expected} | yes | Non-empty feature or text query to investigate. |
Example:
{
"name": "trace_javascript_semantics",
"arguments": {
"application": {
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"subject": {
"name": "app",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "directory",
"architecture": null,
"local_path": "/Applications/Example.app/Contents/Resources/app"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/Applications/Example.app/Contents/Resources/app",
"format": "directory",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"inventory_manifest_id": "agm_2222222222222222222222222222222222222222222222222222222222222222",
"inventory_graph_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"nodes": [
{
"node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"identity": {
"strategy": "content-digest",
"stability": "global-exact",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"observations": [
{
"label": "renderer.js",
"source_map_reference": null,
"properties": {
"path": "renderer.js",
"bytes": 29
},
"evidence": {
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": []
},
"observation_id": "jag_observation_fca009266d0c5ec856e03358df5eb70f339655f7772026e82f9e85151e73bd85",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1"
},
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"application_graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1",
"root_node_ids": [
"jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a"
],
"evidence_contexts": [
{
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": [],
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"module_path": "renderer.js",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"label": "renderer.js",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7",
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
}
},
"node_id": "jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": 0,
"omitted_relations": 0,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
}
]
},
"limitations": [
"Semantic relations are unavailable in this minimal example."
],
"graph_id": "jsrg_c7fb354de642c93da6c2f4a52ac1d69bc02c01d7adf4ae36c4e1418c2c86468f"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 29,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 1,
"findings": 0,
"modules": 0,
"parse_failures": 0
},
"limitations": []
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
},
"query": {
"seed": {
"kind": "semantic-node",
"node_id": "jsrg_node_0000000000000000000000000000000000000000000000000000000000000000"
},
"direction": "backward-provenance"
}
}
}
compare_application_versions
Compare Application Versions · idempotent
Compare two authenticated JavaScript Application Graph versions supplied as inline Evidence or exact same-session retained references. Uses unique-only exact digest, module source digest, source-map identity, structural fingerprint, and non-module semantic-key tiers. Reports added, removed, changed, ambiguous, and unknown entities plus the complete matching changed_from graph without fuzzy or module-ordinal pairing.
| Parameter | Type | Required | Description |
|---|---|---|---|
left_native_observations |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | Value for left native observations. | |
right_native_observations |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | Value for right native observations. | |
left |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Left-hand input used for comparison or differential execution. |
right |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Right-hand input used for comparison or differential execution. |
Example:
{
"name": "compare_application_versions",
"arguments": {
"left": {
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"subject": {
"name": "app",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "directory",
"architecture": null,
"local_path": "/Applications/Example.app/Contents/Resources/app"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/Applications/Example.app/Contents/Resources/app",
"format": "directory",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"inventory_manifest_id": "agm_2222222222222222222222222222222222222222222222222222222222222222",
"inventory_graph_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"nodes": [
{
"node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"identity": {
"strategy": "content-digest",
"stability": "global-exact",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"observations": [
{
"label": "renderer.js",
"source_map_reference": null,
"properties": {
"path": "renderer.js",
"bytes": 29
},
"evidence": {
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": []
},
"observation_id": "jag_observation_fca009266d0c5ec856e03358df5eb70f339655f7772026e82f9e85151e73bd85",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1"
},
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"application_graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1",
"root_node_ids": [
"jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a"
],
"evidence_contexts": [
{
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": [],
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"module_path": "renderer.js",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"label": "renderer.js",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7",
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
}
},
"node_id": "jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": 0,
"omitted_relations": 0,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
}
]
},
"limitations": [
"Semantic relations are unavailable in this minimal example."
],
"graph_id": "jsrg_c7fb354de642c93da6c2f4a52ac1d69bc02c01d7adf4ae36c4e1418c2c86468f"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 29,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 1,
"findings": 0,
"modules": 0,
"parse_failures": 0
},
"limitations": []
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
},
"right": {
"evidence_id": "ev_9f00812ddb4282f613a8623a6267c8c6e0d5fd14a0f9ccaf003331a3445778ac",
"subject": null,
"provider": {
"id": "rea-javascript-runtime-reconciliation",
"name": "REA JavaScript runtime reconciliation",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-runtime-reconciliation",
"operation": "reconcile_javascript_runtime",
"parameters": {
"static_layers": [
{
"role": "application",
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"runtime_mappings": []
}
],
"runtime_evidence_ids": [
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
]
},
"raw_result": null,
"normalized_result": {
"reconciliation_id": "jrr_e6e17991191b1de8750f69a855151758786c3b289869f79796d653a93c69f2cd",
"static_layers": [
{
"layer_id": "jrl_0010c93c08f7dfc6cd9aa276ba5b3471db0a91a7e18c1715dd951801f2ebfa65",
"role": "application",
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"input_path": "/Applications/Example.app/Contents/Resources/app",
"format": "directory",
"runtime_mappings": []
}
],
"runtime_captures": [
{
"evidence_id": "ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"kind": "electron",
"target_node_id": "jag_node_f360c35c86d4893fcf83ef0fdef92cebd688fba883aa39698a1c12dd5a237265",
"target_key": "example-target",
"target_location": "/Applications/Example.app/Contents/Resources/app/index.html",
"frames": 0,
"scripts": 1,
"workers": 0,
"scripts_complete_within_scope": true
}
],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"jag_node_f360c35c86d4893fcf83ef0fdef92cebd688fba883aa39698a1c12dd5a237265"
],
"nodes": [
{
"node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"identity": {
"strategy": "content-digest",
"stability": "global-exact",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"observations": [
{
"label": "renderer.js",
"source_map_reference": null,
"properties": {
"path": "renderer.js",
"bytes": 29
},
"evidence": {
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": []
},
"observation_id": "jag_observation_fca009266d0c5ec856e03358df5eb70f339655f7772026e82f9e85151e73bd85",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
},
{
"node_id": "jag_node_af8ea5d1909955f39da1d844b2cad8f2f68c34b7d575ded6d04c00fa4095a88e",
"kind": "runtime-script-instance",
"identity": {
"strategy": "runtime-instance",
"stability": "capture-only",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"runtime_key": "electron_script_4444444444444444444444444444444444444444444444444444444444444444"
},
"observations": [
{
"label": "/Applications/Example.app/Contents/Resources/app/renderer.js",
"source_map_reference": null,
"properties": {
"location": "/Applications/Example.app/Contents/Resources/app/renderer.js",
"cdp_hash": "example",
"length": 29,
"is_module": true,
"language": "JavaScript",
"source_sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"evidence": {
"authority": "passive-cdp-runtime",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "runtime",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"target_key": "example-target",
"frame_key": null,
"script_key": "electron_script_4444444444444444444444444444444444444444444444444444444444444444"
}
},
"extractor": {
"name": "rea-cdp-electron",
"version": "1",
"operation": "inspect_electron_page",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"The entity was observed only within one bounded passive CDP capture."
],
"evidence_ids": [
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
]
},
"observation_id": "jag_observation_a4fabe6b4d4b0482904c0eb38b80159e41448f8e2ce3cd3de9d33d07c0538e93",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
},
{
"node_id": "jag_node_f360c35c86d4893fcf83ef0fdef92cebd688fba883aa39698a1c12dd5a237265",
"kind": "target",
"identity": {
"strategy": "runtime-instance",
"stability": "capture-only",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"runtime_key": "example-target"
},
"observations": [
{
"label": "Example",
"source_map_reference": null,
"properties": {
"runtime_type": "page",
"location": "/Applications/Example.app/Contents/Resources/app/index.html",
"attached": false
},
"evidence": {
"authority": "passive-cdp-runtime",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": false,
"reason": "not-applicable",
"detail": "This runtime entity has no standalone artifact bytes."
},
"location": {
"available": true,
"value": {
"kind": "runtime",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"target_key": "example-target",
"frame_key": null,
"script_key": null
}
},
"extractor": {
"name": "rea-cdp-electron",
"version": "1",
"operation": "inspect_electron_page",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"The entity was observed only within one bounded passive CDP capture."
],
"evidence_ids": [
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
]
},
"observation_id": "jag_observation_f48f7d5c3f6290694dd789985d2f7ea396e3a1479d14f74243c90ea7e3219009",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [
{
"source_node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"target_node_id": "jag_node_af8ea5d1909955f39da1d844b2cad8f2f68c34b7d575ded6d04c00fa4095a88e",
"relation": "observed_as",
"properties": {
"reconciliation_id": "jrr_item_12ae61e57a124a9831583f75b1606d1855c6dbe1003863dc1ae9db5ddadfc6b1",
"basis": "content-and-location",
"static_layer_id": "jrl_0010c93c08f7dfc6cd9aa276ba5b3471db0a91a7e18c1715dd951801f2ebfa65"
},
"evidence": {
"authority": "cross-layer-reconciliation",
"state": "inferred",
"confidence": "high",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "runtime",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"target_key": "example-target",
"frame_key": null,
"script_key": "electron_script_4444444444444444444444444444444444444444444444444444444444444444"
}
},
"extractor": {
"name": "rea-javascript-runtime-reconciliation",
"version": "1",
"operation": "reconcile_javascript_runtime",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Equal content digests establish byte identity, not execution causality.",
"Passive script parsing or target presence does not prove feature execution."
],
"evidence_ids": [
"ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
]
},
"edge_id": "jag_edge_475588e3cf45a81d932824230e6399840ec4bba14188c3a551f223d869ba45d2",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "relationship-exact"
}
},
{
"source_node_id": "jag_node_f360c35c86d4893fcf83ef0fdef92cebd688fba883aa39698a1c12dd5a237265",
"target_node_id": "jag_node_af8ea5d1909955f39da1d844b2cad8f2f68c34b7d575ded6d04c00fa4095a88e",
"relation": "loads",
"properties": {
"basis": "passive-cdp-observation"
},
"evidence": {
"authority": "passive-cdp-runtime",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": false,
"reason": "not-applicable",
"detail": "The relationship is runtime metadata, not standalone bytes."
},
"location": {
"available": true,
"value": {
"kind": "runtime",
"capture_sha256": "a4dd260f01b45e3df92482755baed7a1922b4af2226edc7f896bdbc4d2bbbd9c",
"target_key": "example-target",
"frame_key": null,
"script_key": "electron_script_4444444444444444444444444444444444444444444444444444444444444444"
}
},
"extractor": {
"name": "rea-cdp-electron",
"version": "1",
"operation": "inspect_electron_page",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"The relationship was observed only within one bounded passive CDP capture."
],
"evidence_ids": [
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
]
},
"edge_id": "jag_edge_ed3d33fede6e33c5740c1d1af8080bdbbb9265b2f1462b7c8d06c1f55b4a31b6",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "relationship-exact"
}
}
],
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-layer observed_as edges are inferences; digest equality proves byte identity only.",
"Runtime presence is bounded to passive capture windows and does not prove feature execution.",
"Source-map relationships retain their original static authority and are not promoted into runtime matches."
],
"graph_id": "jag_04a2282d812e4c692864523c4bbf479084ee5e51ad26afa24795027085d49345"
},
"summary": {
"runtime_targets": 1,
"runtime_frames": 0,
"runtime_scripts": 1,
"runtime_workers": 0,
"matched": 1,
"ambiguous": 0,
"unmatched": 1,
"unknown": 0,
"static_loaded": 1,
"static_resident": 0,
"static_not_observed": 0,
"static_unknown": 0
},
"reconciliations": [
{
"reconciliation_id": "jrr_item_0d0441146a748e6ca1dde6cf4999fe9ee2a89131c405bef0b2a94d26f81eb36b",
"entity_kind": "target",
"runtime_evidence_id": "ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5",
"runtime_node_id": "jag_node_f360c35c86d4893fcf83ef0fdef92cebd688fba883aa39698a1c12dd5a237265",
"basis": "none",
"confidence": "unknown",
"reason": "no-static-content-match",
"candidate_static_count": 0,
"candidate_static_nodes": [],
"static_layer_id": null,
"static_node_id": null,
"status": "unmatched"
},
{
"reconciliation_id": "jrr_item_12ae61e57a124a9831583f75b1606d1855c6dbe1003863dc1ae9db5ddadfc6b1",
"entity_kind": "script",
"runtime_evidence_id": "ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5",
"runtime_node_id": "jag_node_af8ea5d1909955f39da1d844b2cad8f2f68c34b7d575ded6d04c00fa4095a88e",
"basis": "content-and-location",
"confidence": "high",
"reason": "content-and-location-match",
"candidate_static_count": 1,
"candidate_static_nodes": [
{
"static_layer_id": "jrl_0010c93c08f7dfc6cd9aa276ba5b3471db0a91a7e18c1715dd951801f2ebfa65",
"static_node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
}
],
"static_layer_id": "jrl_0010c93c08f7dfc6cd9aa276ba5b3471db0a91a7e18c1715dd951801f2ebfa65",
"static_node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"status": "matched"
}
],
"static_load_states": [
{
"static_layer_id": "jrl_0010c93c08f7dfc6cd9aa276ba5b3471db0a91a7e18c1715dd951801f2ebfa65",
"static_node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"status": "loaded",
"runtime_node_ids": [
"jag_node_af8ea5d1909955f39da1d844b2cad8f2f68c34b7d575ded6d04c00fa4095a88e"
],
"reason": "runtime-script-correspondence"
}
],
"source_map_authority": {
"used_for_primary_matching": false,
"static_layer_count": 1,
"runtime_script_declarations": 0,
"limitation": "Source-map declarations and original-source content retain separate static authority and are not used as primary runtime byte matches."
},
"coverage": {
"status": "complete-within-inputs",
"truncated": false,
"omitted_runtime_entities": 0,
"omitted_reconciliation_items": 0,
"omitted_static_load_states": 0,
"omitted_graph_items": 0
},
"evidence_links": [
"ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
],
"limitations": [
"A static module resident in an observed bundle is not reported as executed.",
"Caller-declared file and URL mappings are inference inputs and do not expand CDP origin or filesystem-root authority.",
"Digest equality establishes byte identity but not code reachability, module initialization, or feature execution.",
"Not-observed means absent from the bounded captures in scope, never globally unloaded.",
"Only caller-supplied, semantically verified Evidence records were reconciled.",
"Source-map authority remains separate from passive runtime authority."
]
},
"confidence": "inferred",
"authority": "analyst-inference",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation.",
"A static module resident in an observed bundle is not reported as executed.",
"Caller-declared file and URL mappings are inference inputs and do not expand CDP origin or filesystem-root authority.",
"Digest equality establishes byte identity but not code reachability, module initialization, or feature execution.",
"Not-observed means absent from the bounded captures in scope, never globally unloaded.",
"Only caller-supplied, semantically verified Evidence records were reconciled.",
"Source-map authority remains separate from passive runtime authority."
],
"locations": [],
"evidence_links": [
"ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"ev_53ba014a9d2fb6c6195d1f46a510ce6debe5665298fe30d432ec18a11d1682d5"
]
}
}
}
compare_source_to_bundle
Compare Source To Bundle · idempotent
Compare a cryptographically committed HistoricalSourceGraph with authenticated JavaScript Application Graph Evidence supplied inline or by exact same-session retained reference. Uses explicit exact-digest, source-map path, current-path, suffix, and basename signals with stable weights. Classifies unchanged, modified, removed, split, merged, duplicated, and unknown; incomplete coverage and ambiguous weak signals never become absence or forced matches.
| Parameter | Type | Required | Description |
|---|---|---|---|
reference |
object{schema, authority, root_alias, root_sha256, inventory_state, entries, relationships, parse_failures, exclusions, languages, manifests, vcs, provenance, limitations} | yes | Value for reference. |
application |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Value for application. |
Example:
{
"name": "compare_source_to_bundle",
"arguments": {
"reference": {
"schema": "HistoricalSourceGraph",
"authority": "historical-reference",
"root_alias": "$REFERENCE_ROOT",
"root_sha256": "683969414c3e674a368392213c78021322fb39609b0c57f346b22da6464b2110",
"inventory_state": "complete",
"entries": [
{
"path": "src",
"classifications": [
"source"
],
"limitations": [],
"kind": "directory",
"tree_state": "enumerated"
},
{
"path": "src/main.ts",
"classifications": [
"source"
],
"limitations": [],
"kind": "file",
"language": "TypeScript",
"sha256": "2222222222222222222222222222222222222222222222222222222222222222",
"size": 128,
"content_state": "hashed"
}
],
"relationships": [],
"parse_failures": [],
"exclusions": [],
"languages": [
"TypeScript"
],
"manifests": [],
"vcs": {
"kind": "none",
"head": null,
"dirty": null
},
"provenance": {
"importer": "rea",
"importer_version": "1",
"caller": "contract-example"
},
"limitations": []
},
"application": {
"evidence_id": "ev_484083018645bb1153594d9fff5f13245bf6ba4fdad53cedb20c4ec70b24e4d9",
"subject": {
"name": "app",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "directory",
"architecture": null,
"local_path": "/Applications/Example.app/Contents/Resources/app"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/Applications/Example.app/Contents/Resources/app",
"format": "directory",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"inventory_manifest_id": "agm_2222222222222222222222222222222222222222222222222222222222222222",
"inventory_graph_sha256": "3333333333333333333333333333333333333333333333333333333333333333",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"nodes": [
{
"node_id": "jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e",
"kind": "javascript-asset",
"identity": {
"strategy": "content-digest",
"stability": "global-exact",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"observations": [
{
"label": "renderer.js",
"source_map_reference": null,
"properties": {
"path": "renderer.js",
"bytes": 29
},
"evidence": {
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": []
},
"observation_id": "jag_observation_fca009266d0c5ec856e03358df5eb70f339655f7772026e82f9e85151e73bd85",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1"
},
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"application_graph_id": "jag_747d455785494c1295e2ab7102b6b146bf6611ef1eb19fa82ba3e7813c59cce1",
"root_node_ids": [
"jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a"
],
"evidence_contexts": [
{
"authority": "artifact-bytes",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64",
"sha256": "c4c0d760a4c84f0e182de99f6ef89ef10831f8170e486c4d4bd934924151ba64"
},
"extractor": {
"name": "rea-javascript-application",
"version": "1",
"operation": "inventory-relevant-file",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [],
"evidence_ids": [],
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"module_path": "renderer.js",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_3c82da5492d90eb5b0bee41c1a994d88b7ba98c0b4955270d70e57a76e224c2e"
],
"label": "renderer.js",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_9b2d2964b87a3f7ad34048aa27fcf5b52065176def0ffb615260f4b185828fe7",
"location": {
"available": true,
"value": {
"kind": "artifact-path",
"path": "renderer.js"
}
}
},
"node_id": "jsrg_node_9476602f1f74433a2bd3dadb040a25734d203b8f831b31a8d96f7efdfc5cd66a",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": 0,
"omitted_relations": 0,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": 0,
"unknown_ids": []
}
]
},
"limitations": [
"Semantic relations are unavailable in this minimal example."
],
"graph_id": "jsrg_c7fb354de642c93da6c2f4a52ac1d69bc02c01d7adf4ae36c4e1418c2c86468f"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 29,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 1,
"findings": 0,
"modules": 0,
"parse_failures": 0
},
"limitations": []
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
}
}
compare_javascript_export_shapes
Compare Javascript Export Shapes · idempotent
Compare static return shapes for one exact module/export selector on each authenticated JavaScript Application Graph supplied as inline Evidence or exact same-session retained references. Variants pair only by reciprocal unique literal discriminants. Each retained variant lists observed return-property names even when values stay unknown. Presence (present, absent, or unknown-coverage) is separate from value resolution: a name present on only one paired shape is added or removed when parent-property coverage is complete on both sides, including when the static value is unresolved. Dynamic values, incomplete parent coverage, and unpaired variants remain unknown. Reports JSON Pointer changes without executing JavaScript; runtime behavior requires a separate agent-run probe.
| Parameter | Type | Required | Description |
|---|---|---|---|
left_module_path |
string | yes | Local filesystem path for left module. |
left_export_name |
string | yes | Value for left export name. |
right_module_path |
string | yes | Local filesystem path for right module. |
right_export_name |
string | yes | Value for right export name. |
left |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Left-hand input used for comparison or differential execution. |
right |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | object{kind, evidence_id} | yes | Right-hand input used for comparison or differential execution. |
Example:
{
"name": "compare_javascript_export_shapes",
"arguments": {
"left": {
"evidence_id": "ev_0b4487c2b087928fbb7856b85a69609a94439fa3e16b02a6dec038274b7a9d98",
"subject": {
"name": "left",
"digest": {
"sha256": "5005ebc2f35719a2fc014f19a81c669f3a1ab471b7245ef6985a111b6845a747"
},
"format": "directory",
"architecture": null,
"local_path": "/examples/javascript-export-presence/left"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/examples/javascript-export-presence/left",
"format": "directory",
"root_artifact_sha256": "5005ebc2f35719a2fc014f19a81c669f3a1ab471b7245ef6985a111b6845a747",
"inventory_manifest_id": "agm_f30ded9a83d43a3980417bbe63dfad569e83386f243c4d6a01af0166372cb9e6",
"inventory_graph_sha256": "4b8aceaf67e43fd8317ec1f5fd1df5235f8fa402335accf011683e008c6bc62c",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_320f378de976a7f69f83c78b2b3d2c0349ac163371397770205a3f7789e1bd4e"
],
"nodes": [
{
"node_id": "jag_node_320f378de976a7f69f83c78b2b3d2c0349ac163371397770205a3f7789e1bd4e",
"kind": "javascript-module",
"identity": {
"strategy": "artifact-local-key",
"stability": "artifact-version",
"artifact_sha256": "b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510",
"namespace": "module-export",
"key": "5005ebc2f35719a2fc014f19a81c669f3a1ab471b7245ef6985a111b6845a747:parser.mjs:default"
},
"observations": [
{
"label": "parser.mjs:default",
"source_map_reference": null,
"properties": {
"semantic_role": "export-binding",
"module_path": "parser.mjs",
"relationship_kind": "export",
"exported_name": "default",
"local_name": null,
"imported_name": null,
"declared_specifier": null
},
"evidence": {
"authority": "ast-static-analysis",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510",
"sha256": "b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510"
},
"location": {
"available": true,
"value": {
"kind": "source-range",
"source": "parser.mjs",
"start": {
"line": 1,
"column": 0
},
"end": {
"line": 1,
"column": 59
}
}
},
"extractor": {
"name": "rea-javascript-artifact-reconstruction",
"version": "1",
"operation": "recover-module-export",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-function mutation and dynamic property resolution remain unknown.",
"Local call, argument, return, and closure relations are static candidates and do not prove runtime invocation.",
"Promise ownership covers explicit unshadowed Promise construction, static factories, aggregation, chaining, and await syntax only.",
"Return sites include only direct callable returns; nested callable returns remain separate.",
"Values and aliases were recovered from inert syntax only; no JavaScript was executed."
],
"evidence_ids": []
},
"observation_id": "jag_observation_6f5d78b98cd987442ec01aea39f87ae1f0e0895c815cf361abe87146bef48c7d",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
},
{
"label": "parser.mjs:default:return-shapes",
"source_map_reference": null,
"properties": {
"semantic_role": "export-return-shapes",
"module_path": "parser.mjs",
"exported_name": "default",
"callable_id": "callable:function:15:58",
"callable_kind": "function",
"static_return_shapes": [
{
"source_range": {
"start": {
"line": 1,
"column": 22
},
"end": {
"line": 1,
"column": 57
}
},
"value_status": "object",
"fields": [
{
"path": "/count",
"presence": "present",
"state": "unknown",
"value": null,
"reason": "Unsupported CallExpression value."
},
{
"path": "/kind",
"presence": "present",
"state": "literal",
"value": "results",
"reason": null
}
],
"property_coverage": [
{
"path": "",
"status": "complete",
"omitted": 0
}
]
}
],
"return_shape_coverage": {
"status": "complete",
"retained_return_sites": 1,
"omitted_return_sites": 0,
"omitted_fields": 0,
"omitted_property_coverage": 0,
"projection_complete": true
}
},
"evidence": {
"authority": "static-relationship-inference",
"state": "inferred",
"confidence": "high",
"artifact": {
"available": true,
"artifact_id": "art_b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510",
"sha256": "b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510"
},
"location": {
"available": true,
"value": {
"kind": "source-range",
"source": "parser.mjs",
"start": {
"line": 1,
"column": 15
},
"end": {
"line": 1,
"column": 58
}
}
},
"extractor": {
"name": "rea-javascript-artifact-reconstruction",
"version": "1",
"operation": "recover-export-return-shapes",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-function mutation and dynamic property resolution remain unknown.",
"Local call, argument, return, and closure relations are static candidates and do not prove runtime invocation.",
"Promise ownership covers explicit unshadowed Promise construction, static factories, aggregation, chaining, and await syntax only.",
"Return shapes are inferred from inert syntax and do not prove runtime behavior.",
"Return sites include only direct callable returns; nested callable returns remain separate.",
"Values and aliases were recovered from inert syntax only; no JavaScript was executed."
],
"evidence_ids": []
},
"observation_id": "jag_observation_ef3f5c9e633944cdabce0afce19e52b4592df60c27b82aeaaed612fdee5645e7",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "partial",
"truncated": false,
"omitted_count": null,
"limits": []
},
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"graph_id": "jag_1e5c46c102d63a76eb8d61e88fe0bafb60fe83b9e6331217510f2016ee02b450"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 60,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 12,
"findings": 1,
"modules": 0,
"parse_failures": 0
},
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "5005ebc2f35719a2fc014f19a81c669f3a1ab471b7245ef6985a111b6845a747",
"application_graph_id": "jag_1e5c46c102d63a76eb8d61e88fe0bafb60fe83b9e6331217510f2016ee02b450",
"root_node_ids": [
"jsrg_node_c37a11afe215128178c9fe5acf0931b8a69db4290e656cd3fcf65e523dc530ea"
],
"evidence_contexts": [
{
"authority": "ast-static-analysis",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510",
"sha256": "b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510"
},
"extractor": {
"name": "rea-javascript-artifact-reconstruction",
"version": "1",
"operation": "recover-module-export",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-function mutation and dynamic property resolution remain unknown.",
"Local call, argument, return, and closure relations are static candidates and do not prove runtime invocation.",
"Promise ownership covers explicit unshadowed Promise construction, static factories, aggregation, chaining, and await syntax only.",
"Return sites include only direct callable returns; nested callable returns remain separate.",
"Values and aliases were recovered from inert syntax only; no JavaScript was executed."
],
"evidence_ids": [],
"context_id": "jsrg_evidence_d3d664e557162561d1ac2425b45f8c7773381b2de921ad18c60104ce09bf6fea"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "b5bf7df6d7f66939ba133f63687274c7b20cd8949e3638abc2f052bcd7459510",
"module_path": "parser.mjs",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_320f378de976a7f69f83c78b2b3d2c0349ac163371397770205a3f7789e1bd4e"
],
"label": "parser.mjs",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_d3d664e557162561d1ac2425b45f8c7773381b2de921ad18c60104ce09bf6fea",
"location": {
"available": true,
"value": {
"kind": "source-range",
"source": "parser.mjs",
"start": {
"line": 1,
"column": 0
},
"end": {
"line": 1,
"column": 59
}
}
}
},
"node_id": "jsrg_node_c37a11afe215128178c9fe5acf0931b8a69db4290e656cd3fcf65e523dc530ea",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": null,
"omitted_relations": null,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
}
]
},
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"graph_id": "jsrg_4f40eb98067d747c7e659367d91bb2aeb6da760c581c6d6fd92c8ec5909d30d2"
}
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"locations": [],
"evidence_links": []
},
"right": {
"evidence_id": "ev_cf256c5b0677120f8b19243bc797b187b6d4749da10d5e1600ced727e2d16094",
"subject": {
"name": "right",
"digest": {
"sha256": "269ae72a601ad5ac02f1c2dda6ff9accffa2d2e4f4a9e406facee0d5a78a5377"
},
"format": "directory",
"architecture": null,
"local_path": "/examples/javascript-export-presence/right"
},
"provider": {
"id": "rea-javascript-application",
"name": "REA JavaScript application analyzer",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.javascript-application-analysis",
"operation": "analyze_javascript_application",
"parameters": {},
"raw_result": null,
"normalized_result": {
"input_path": "/examples/javascript-export-presence/right",
"format": "directory",
"root_artifact_sha256": "269ae72a601ad5ac02f1c2dda6ff9accffa2d2e4f4a9e406facee0d5a78a5377",
"inventory_manifest_id": "agm_d3ceaa1af38fb3474070ca25c0d4644282e5fb7d5824cee3e3a81391481e9fc1",
"inventory_graph_sha256": "3e9bc926951480c35385efe5650d9d781631bd74c37a523d543b5fbe06b01ce6",
"integrity_contradictions": [],
"graph": {
"schema": "JavaScriptApplicationGraph",
"root_node_ids": [
"jag_node_b0d3c92dc3d9a4f1de6cf31caffd19def5c5edccd4d041bcc1fc9ce460ce837e"
],
"nodes": [
{
"node_id": "jag_node_b0d3c92dc3d9a4f1de6cf31caffd19def5c5edccd4d041bcc1fc9ce460ce837e",
"kind": "javascript-module",
"identity": {
"strategy": "artifact-local-key",
"stability": "artifact-version",
"artifact_sha256": "d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6",
"namespace": "module-export",
"key": "269ae72a601ad5ac02f1c2dda6ff9accffa2d2e4f4a9e406facee0d5a78a5377:parser.mjs:default"
},
"observations": [
{
"label": "parser.mjs:default:return-shapes",
"source_map_reference": null,
"properties": {
"semantic_role": "export-return-shapes",
"module_path": "parser.mjs",
"exported_name": "default",
"callable_id": "callable:function:15:58",
"callable_kind": "function",
"static_return_shapes": [
{
"source_range": {
"start": {
"line": 1,
"column": 22
},
"end": {
"line": 1,
"column": 57
}
},
"value_status": "object",
"fields": [
{
"path": "/kind",
"presence": "present",
"state": "literal",
"value": "results",
"reason": null
},
{
"path": "/total",
"presence": "present",
"state": "unknown",
"value": null,
"reason": "Unsupported CallExpression value."
}
],
"property_coverage": [
{
"path": "",
"status": "complete",
"omitted": 0
}
]
}
],
"return_shape_coverage": {
"status": "complete",
"retained_return_sites": 1,
"omitted_return_sites": 0,
"omitted_fields": 0,
"omitted_property_coverage": 0,
"projection_complete": true
}
},
"evidence": {
"authority": "static-relationship-inference",
"state": "inferred",
"confidence": "high",
"artifact": {
"available": true,
"artifact_id": "art_d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6",
"sha256": "d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6"
},
"location": {
"available": true,
"value": {
"kind": "source-range",
"source": "parser.mjs",
"start": {
"line": 1,
"column": 15
},
"end": {
"line": 1,
"column": 58
}
}
},
"extractor": {
"name": "rea-javascript-artifact-reconstruction",
"version": "1",
"operation": "recover-export-return-shapes",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-function mutation and dynamic property resolution remain unknown.",
"Local call, argument, return, and closure relations are static candidates and do not prove runtime invocation.",
"Promise ownership covers explicit unshadowed Promise construction, static factories, aggregation, chaining, and await syntax only.",
"Return shapes are inferred from inert syntax and do not prove runtime behavior.",
"Return sites include only direct callable returns; nested callable returns remain separate.",
"Values and aliases were recovered from inert syntax only; no JavaScript was executed."
],
"evidence_ids": []
},
"observation_id": "jag_observation_c99c393d4f418755ced02d7be3d4ee5fe63ad629873bd1e65b64861193902b78",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
},
{
"label": "parser.mjs:default",
"source_map_reference": null,
"properties": {
"semantic_role": "export-binding",
"module_path": "parser.mjs",
"relationship_kind": "export",
"exported_name": "default",
"local_name": null,
"imported_name": null,
"declared_specifier": null
},
"evidence": {
"authority": "ast-static-analysis",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6",
"sha256": "d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6"
},
"location": {
"available": true,
"value": {
"kind": "source-range",
"source": "parser.mjs",
"start": {
"line": 1,
"column": 0
},
"end": {
"line": 1,
"column": 59
}
}
},
"extractor": {
"name": "rea-javascript-artifact-reconstruction",
"version": "1",
"operation": "recover-module-export",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-function mutation and dynamic property resolution remain unknown.",
"Local call, argument, return, and closure relations are static candidates and do not prove runtime invocation.",
"Promise ownership covers explicit unshadowed Promise construction, static factories, aggregation, chaining, and await syntax only.",
"Return sites include only direct callable returns; nested callable returns remain separate.",
"Values and aliases were recovered from inert syntax only; no JavaScript was executed."
],
"evidence_ids": []
},
"observation_id": "jag_observation_f84843cec4a0d0177d8620541d74fc4f0c3496c6bf40298c0bf47890f5e4e73b",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "observation-exact"
}
}
]
}
],
"edges": [],
"coverage": {
"status": "partial",
"truncated": false,
"omitted_count": null,
"limits": []
},
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"graph_id": "jag_68d8e46aba428a0a9f9bf46a54367778a77155c511b0052ec298981e45dcf23a"
},
"summary": {
"browser_windows": 0,
"explicit_web_preferences": 0,
"preload_entrypoints": 0,
"context_bridge_apis": 0,
"exposed_api_members": 0,
"ipc": {
"operations": 0,
"literal_channels": 0,
"dynamic_channel_operations": 0,
"renderer_transmissions": 0,
"renderer_listeners": 0,
"main_handlers": 0,
"paired_renderer_transmissions": 0,
"ambiguous_renderer_transmissions": 0,
"unpaired_literal_renderer_transmissions": 0
},
"sender_validation_observations": 0,
"utility_processes": 0,
"resolved_utility_entrypoints": 0,
"native_addon_bindings": 0,
"resolved_native_addon_bindings": 0
},
"statistics": {
"relevant_files": 1,
"nested_asar_containers": 0,
"text_bytes_read": 60,
"invalid_utf8_files": 0,
"parsed_javascript_files": 1,
"visited_ast_nodes": 12,
"findings": 1,
"modules": 0,
"parse_failures": 0
},
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"semantic_graph": {
"schema": "JavaScriptSemanticRelationGraph",
"root_artifact_sha256": "269ae72a601ad5ac02f1c2dda6ff9accffa2d2e4f4a9e406facee0d5a78a5377",
"application_graph_id": "jag_68d8e46aba428a0a9f9bf46a54367778a77155c511b0052ec298981e45dcf23a",
"root_node_ids": [
"jsrg_node_2c28d60513b1e4d26dfd91fa9b200262c587680673c36352959bd13307405cb0"
],
"evidence_contexts": [
{
"authority": "ast-static-analysis",
"state": "observed",
"confidence": "exact",
"artifact": {
"available": true,
"artifact_id": "art_d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6",
"sha256": "d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6"
},
"extractor": {
"name": "rea-javascript-artifact-reconstruction",
"version": "1",
"operation": "recover-module-export",
"executable_sha256": null
},
"coverage": {
"status": "complete",
"truncated": false,
"omitted_count": 0,
"limits": []
},
"limitations": [
"Cross-function mutation and dynamic property resolution remain unknown.",
"Local call, argument, return, and closure relations are static candidates and do not prove runtime invocation.",
"Promise ownership covers explicit unshadowed Promise construction, static factories, aggregation, chaining, and await syntax only.",
"Return sites include only direct callable returns; nested callable returns remain separate.",
"Values and aliases were recovered from inert syntax only; no JavaScript was executed."
],
"evidence_ids": [],
"context_id": "jsrg_evidence_a7fc451794f5d5b3d4e4561fd793eecca6bc0fa1b8fcd891e89429ef8e5e106d"
}
],
"nodes": [
{
"kind": "module",
"identity": {
"artifact_sha256": "d1bdab25090a0e146d1bd5e507c03f84b4530c3c2018217513a3d881b6cae6d6",
"module_path": "parser.mjs",
"source_range": null,
"role_key": "example-module"
},
"function_node_id": null,
"application_node_ids": [
"jag_node_b0d3c92dc3d9a4f1de6cf31caffd19def5c5edccd4d041bcc1fc9ce460ce837e"
],
"label": "parser.mjs",
"properties": {},
"evidence": {
"context_id": "jsrg_evidence_a7fc451794f5d5b3d4e4561fd793eecca6bc0fa1b8fcd891e89429ef8e5e106d",
"location": {
"available": true,
"value": {
"kind": "source-range",
"source": "parser.mjs",
"start": {
"line": 1,
"column": 0
},
"end": {
"line": 1,
"column": 59
}
}
}
},
"node_id": "jsrg_node_2c28d60513b1e4d26dfd91fa9b200262c587680673c36352959bd13307405cb0",
"identifier_strategy": {
"strategy": "semantic-content-sha256",
"stability": "artifact-version"
}
}
],
"relations": [],
"fingerprints": [],
"unknowns": [],
"coverage": {
"status": "unknown",
"truncated": false,
"omitted_nodes": null,
"omitted_relations": null,
"limits": [],
"families": [
{
"family": "boundary",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "call-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "child-process",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "closure",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "configuration",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "data-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "event",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "object-flow",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "promise-ownership",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "request",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "resource-lifecycle",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
},
{
"family": "timer",
"status": "unknown",
"retained_relations": 0,
"omitted_relations": null,
"unknown_ids": []
}
]
},
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"graph_id": "jsrg_1d7d94b1b9fb8eeb42d3c9beeb9da8a9d7dc151d50d990cc35116c335b84ce0d"
}
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [
"This example retains export and return-shape facts only; other application and semantic relationships are omitted."
],
"locations": [],
"evidence_links": []
},
"left_module_path": "parser.mjs",
"left_export_name": "default",
"right_module_path": "parser.mjs",
"right_export_name": "default"
}
}
build_reconstruction_obligation_ledger
Build Reconstruction Obligation Ledger · idempotent
Generate the complete deterministic ReconstructionObligationLedger from an authenticated Evidence bundle, reviewed obligations, and an explicit reconstruction manifest. Static candidates remain candidates; duplicate ownership, missing original or reconstruction cases, missing parser/type, weak verifier authority, unenumerated claims, contradictions, dependencies, and residual unknowns fail closed. The inline result carries the full-ledger closure digest and typed per-obligation diagnostics.
| Parameter | Type | Required | Description |
|---|---|---|---|
evidence_bundle |
object{artifacts, providers, environments, scenarios, captures, unknowns, records} | yes | Value for evidence bundle. |
reviewed_obligations |
object{obligation_id, obligation_version, title, application_layer, family, target, required, required_case_kinds, required_original_authority, required_fixture_authority, required_verifier_authority, requires_parser_type, dependency_obligation_ids, residual_unknown_ids, unavailable_authority, required_next_evidence, disposition, review_evidence_ids}[] | yes | Value for reviewed obligations. |
manifest |
object{bindings, contradictions} | yes | Value for manifest. |
Example:
{
"name": "build_reconstruction_obligation_ledger",
"arguments": {
"evidence_bundle": {
"artifacts": [],
"providers": [],
"environments": [],
"scenarios": [],
"captures": [],
"unknowns": [],
"records": []
},
"reviewed_obligations": [],
"manifest": {
"bindings": [],
"contradictions": []
}
}
}
evaluate_reconstruction_coverage
Evaluate Reconstruction Coverage · read-only, idempotent
Evaluate inline evidence-backed reconstruction coverage against one named boundary. Missing ownership or inventory is partial; stale, weak, truncated, skipped, or unresolved proof is unknown; contradictions, failed proof, missing owners, and authority routing fail closed.
| Parameter | Type | Required | Description |
|---|---|---|---|
coverage |
object{evidence_bundle, artifacts, surfaces, owners, claims, verifier_contracts, verifier_results, residual_unknown_ids, contradictions, package_proofs, boundaries} | yes | Exact reconstruction-coverage commitment to verify. |
boundary_id |
string | yes | Exact reconstruction boundary identifier to evaluate. |
Example:
{
"name": "evaluate_reconstruction_coverage",
"arguments": {
"coverage": {
"evidence_bundle": {
"artifacts": [],
"providers": [],
"environments": [],
"scenarios": [],
"captures": [],
"unknowns": [],
"records": []
},
"artifacts": [],
"surfaces": [],
"owners": [],
"claims": [],
"verifier_contracts": [],
"verifier_results": [],
"residual_unknown_ids": [],
"contradictions": [],
"package_proofs": [],
"boundaries": [
{
"boundary_id": "replacement.cli",
"title": "CLI replacement",
"required_surface_ids": [
"cli.help"
],
"required_claim_ids": [
"claim.cli.help"
],
"required_package_proof_kinds": [
"clean-install",
"authority-independence"
],
"allowed_dispositions": [],
"allowed_unknown_ids": []
}
]
},
"boundary_id": "replacement.cli"
}
}
project_android_application_graph
Project Android Application Graph · idempotent
Project authenticated APK inventory_artifact Evidence into an execution-free Android application inventory. Reports exact component paths and hashes, runtime-family hints, and path-based bridge hypotheses without decoding DEX, executing the APK, or claiming observed runtime calls.
| Parameter | Type | Required | Description |
|---|---|---|---|
inventory_evidence |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Value for inventory evidence. |
Example:
{
"name": "project_android_application_graph",
"arguments": {
"inventory_evidence": [
{
"evidence_id": "ev_eb0c0bbf0545fb045602385a510181fea70e84e93cdd07516e684ba4b9845ab6",
"subject": {
"name": "Fixture.apk",
"digest": {
"sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
"format": "apk",
"architecture": null,
"local_path": "Fixture.apk"
},
"provider": {
"id": "rea-artifact-graph",
"name": "REA safe artifact graph provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inventory_artifact",
"parameters": {},
"raw_result": null,
"normalized_result": {
"manifest": {
"manifest_id": "agm_68e9ab0a3f0c9f89af73d02270b2d7a6ea96772c38eef8dfc108625000eef765",
"root_artifact_id": "art_91d55c997599a1b301a52f2ad8559a9f2bfa28927d7cb2c391f3cedf6072ccdd",
"root_sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"root_format": "apk",
"graph_sha256": "7ebb568a904bf6d82531616e98a8f9dfc8d2b26ab50121af041be207436c40da",
"node_count": 1,
"occurrence_count": 1,
"edge_count": 0
},
"nodes": [
{
"artifact_id": "art_91d55c997599a1b301a52f2ad8559a9f2bfa28927d7cb2c391f3cedf6072ccdd",
"format": "zip",
"sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"size": 1,
"media_type": null,
"architecture": null,
"content_state": "materialized",
"limitations": []
}
],
"occurrences": [
{
"occurrence_id": "occ_385f341599a469f680d89371fd8d26bf235e4bd95e29f941f69830343ea72c5a",
"artifact_id": "art_91d55c997599a1b301a52f2ad8559a9f2bfa28927d7cb2c391f3cedf6072ccdd",
"parent_occurrence_id": null,
"logical_path": ".",
"entry_kind": "file",
"artifact_kind": "resource",
"artifact_format": "apk",
"declared_size": 1,
"compressed_size": null,
"executable": false,
"encrypted": false,
"hash_status": "verified",
"source_location": null,
"limitations": []
}
],
"edges": [],
"provenance": [],
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
]
}
}
project_apple_application_graph
Project Apple Application Graph · idempotent
Project authenticated IPA, macOS .app directory, ZIP, or DMG inventory Evidence into an execution-free Apple application inventory. Reports application roots, nested bundles with path-convention roles (app extensions, XPC services, login items, privileged helpers, system extensions, frameworks), launchd plists, exact component paths and hashes, runtime-family hints, and path-based bridge hypotheses without parsing plist/CMS semantics or claiming observed runtime calls.
| Parameter | Type | Required | Description |
|---|---|---|---|
inventory_evidence |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Value for inventory evidence. |
Example:
{
"name": "project_apple_application_graph",
"arguments": {
"inventory_evidence": [
{
"evidence_id": "ev_e41a9a8167ae28762aaa07afdf362a30fb1c483dfaec668d4344d0644e7dc013",
"subject": {
"name": "Fixture.ipa",
"digest": {
"sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb"
},
"format": "ipa",
"architecture": null,
"local_path": "Fixture.ipa"
},
"provider": {
"id": "rea-artifact-graph",
"name": "REA safe artifact graph provider",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inventory_artifact",
"parameters": {},
"raw_result": null,
"normalized_result": {
"manifest": {
"manifest_id": "agm_3eacacb0e9a992990991ae7ff4662a0e1f6b0a447b77b799d80137593733cff6",
"root_artifact_id": "art_b42a19aa08c8eda5b54ff7dedca16546a342bfe20da65c1377403feb7a74a960",
"root_sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"root_format": "ipa",
"graph_sha256": "b585c7a8d4b61cc4cb6bf9ead48721e4d1bd3a2aded157038f56466717aab27a",
"node_count": 1,
"occurrence_count": 1,
"edge_count": 0
},
"nodes": [
{
"artifact_id": "art_b42a19aa08c8eda5b54ff7dedca16546a342bfe20da65c1377403feb7a74a960",
"format": "zip",
"sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
"size": 1,
"media_type": null,
"architecture": null,
"content_state": "materialized",
"limitations": []
}
],
"occurrences": [
{
"occurrence_id": "occ_fc32a68378230630d05886e51a1e327af55b3a1d89f5365e07587e7e9ed1cce6",
"artifact_id": "art_b42a19aa08c8eda5b54ff7dedca16546a342bfe20da65c1377403feb7a74a960",
"parent_occurrence_id": null,
"logical_path": ".",
"entry_kind": "file",
"artifact_kind": "resource",
"artifact_format": "ipa",
"declared_size": 1,
"compressed_size": null,
"executable": false,
"encrypted": false,
"hash_status": "verified",
"source_location": null,
"limitations": []
}
],
"edges": [],
"provenance": [],
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
]
}
}
open_binary
Open Binary · idempotent
Open a local executable, application bundle, archive, JavaScript, source map, plist, or analysis database after validation. format=dos-com explicitly interprets 1..65280 headerless bytes as a DOS COM analysis image; omission preserves header-based detection. provider_id selects one deep provider or deterministic auto selection; the binding remains stable until close or an explicit switch, with no failure fallback. Reopening the same target and profile retains its active database and metadata edits. An optional analysis snapshot is imported atomically and must match the binary identity, concrete provider, and canonical analysis profile exactly; importing into a session with metadata mutations requires closing and reopening it first.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute local filesystem path for the analysis target; relative paths are rejected. |
format |
"dos-com" |
Explicit headerless DOS COM interpretation; omission preserves header-based detection | |
provider_id |
"auto" | string |
Exact deep-analysis provider ID, or automatic selection when omitted. | |
snapshot_path |
string | Absolute local filesystem path for the analysis snapshot; relative paths are rejected. |
Example:
{
"name": "open_binary",
"arguments": {
"path": "/tmp/fixture"
}
}
close_binary
Close Binary · destructive
Drain earlier provider requests, optionally write a provider-neutral analysis snapshot atomically to the caller-supplied path, then close the active target and every provider resource started for it. Later provider requests wait until this lifecycle operation finishes. Existing files require explicit overwrite; a failed save leaves the session open so cached analysis is not lost. Metadata edits prevent immutable snapshot saves until the session is recreated; export_evidence_bundle preserves mutable observations before closing without a snapshot.
| Parameter | Type | Required | Description |
|---|---|---|---|
snapshot_path |
string | Absolute local filesystem path for the analysis snapshot; relative paths are rejected. | |
overwrite |
boolean | Whether an existing destination may be replaced. |
Example:
{
"name": "close_binary",
"arguments": {
"overwrite": false
}
}
binary_session
Binary Session · read-only, idempotent
Report the complete current target, provider, capability availability, client-feature, analysis, and server-identity status without starting analysis.
| Parameter | Type | Required | Description |
|---|---|---|---|
expected_package_version |
string | Expected package version used to reject stale or mismatched input. | |
expected_catalog_digest |
string | Expected catalog digest used to reject stale or mismatched input. | |
expected_server_path |
string | Absolute local filesystem path expected for the running server; relative paths are rejected. |
Example:
{
"name": "binary_session",
"arguments": {}
}
export_evidence_bundle
Export Evidence Bundle · destructive, idempotent
Atomically write the session's deterministic Evidence bundle to the requested local path. Existing files require overwrite: true; records and manifests use canonical byte-stable ordering.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute local filesystem path for the exported evidence bundle; relative paths are rejected. |
overwrite |
boolean | Whether an existing destination may be replaced. |
Example:
{
"name": "export_evidence_bundle",
"arguments": {
"path": "/tmp/evidence.json",
"overwrite": false
}
}
import_evidence_bundle
Import Evidence Bundle · idempotent
Read the JSON bundle at the supplied local path, validate every Evidence ID and canonical manifest, then atomically merge it. Imported content is data only and is never executed.
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | yes | Absolute local filesystem path for the evidence bundle to import; relative paths are rejected. |
Example:
{
"name": "import_evidence_bundle",
"arguments": {
"path": "/tmp/evidence.json"
}
}
get_evidence_bundle
Get Evidence Bundle · read-only, idempotent
Return every Evidence record and residual unknown currently retained by this session as one inline bundle for direct inspection or follow-up workflows.
No parameters.
Example:
{
"name": "get_evidence_bundle",
"arguments": {}
}
capture_process_scenario
Capture Process Scenario
Run one caller-selected command under a PTY and return process capture Evidence with residual unknowns. A command name resolves through the inherited PATH; the working directory defaults to the caller's current directory; host environment variables are inherited with scenario overrides. Environment keys cannot contain '=' or NUL, and REA_PROCESS_RUN_ID is reserved for process ownership. Filesystem snapshots are opt-in through filesystem_observation_paths. The target runs with the current user's permissions; this is not a security sandbox.
| Parameter | Type | Required | Description |
|---|---|---|---|
executable |
string | yes | Command name or executable path to run. |
arguments |
string[] | Value for arguments. | |
working_directory |
string | Value for working directory. | |
environment |
object | Value for environment. | |
filesystem_observation_paths |
string[] | Value for filesystem observation paths. | |
terminal |
object{columns, rows, scrollback} | Value for terminal. | |
events |
object{at_ms, type, data, sensitive} | object{at_ms, type, columns, rows} | object{at_ms, type, signal}[] | Value for events. | |
timeout_ms |
integer | Value for timeout ms. | |
idle_timeout_ms |
integer | Value for idle timeout ms. | |
settle_ms |
integer | Value for settle ms. | |
limits |
object{output_bytes, files, file_bytes, processes, filesystem_depth} | Resource budgets that bound execution and retained output for this operation. | |
normalization |
object{paths, pids, ports, time_bucket_ms, patterns} | Value for normalization. |
Example:
{
"name": "capture_process_scenario",
"arguments": {
"executable": "/usr/bin/true",
"arguments": [],
"working_directory": "/tmp",
"environment": {},
"filesystem_observation_paths": [],
"terminal": {
"columns": 80,
"rows": 24,
"scrollback": 1000
},
"events": [],
"timeout_ms": 30000,
"idle_timeout_ms": 30000,
"settle_ms": 100,
"limits": {
"output_bytes": 1000000,
"files": 10000,
"file_bytes": 10000000,
"processes": 1000,
"filesystem_depth": 16
},
"normalization": {
"paths": false,
"pids": true,
"ports": true,
"time_bucket_ms": 10,
"patterns": []
}
}
}
compare_process_captures
Compare Process Captures · idempotent
Compare two compatible process capture observations across terminal, interaction, lifecycle, process, filesystem, command-shim, HTTP, and WebSocket evidence. Optional trace_spec validates exact events against an explicit partial order or finite trace language; concurrency is never inferred from timestamps or broad sorting. Missing, journal-free, or truncated observations are never treated as equivalent.
| Parameter | Type | Required | Description |
|---|---|---|---|
left |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Left-hand input used for comparison or differential execution. |
right |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Right-hand input used for comparison or differential execution. |
trace_spec |
object{events, language} | Value for trace spec. | |
max_capture_age_ms |
integer | Maximum permitted capture age ms for this operation. |
Example:
{
"name": "compare_process_captures",
"arguments": {
"left": {
"evidence_id": "ev_b6ee3183062783c970e2a237f4a62a85b0582760bf0bae8739669a620f131405",
"subject": null,
"provider": {
"id": "rea-process",
"name": "REA deterministic process harness",
"version": "3"
},
"analysis_profile": null,
"predicate_type": "rea.process-capture",
"operation": "capture_process_scenario",
"parameters": {
"scenario": "reference"
},
"raw_result": null,
"normalized_result": {
"manifest": {
"rea_version": "1.1.0",
"provider_version": "3",
"platform": "fixture",
"architecture": "fixture",
"pty_backend": "node-pty",
"started_at": "2026-01-01T00:00:00.000Z",
"completed_at": "2026-01-01T00:00:00.001Z",
"scenario": {
"executable_sha256": "0000000000000000000000000000000000000000000000000000000000000000"
},
"comparison_contract": {},
"full_scenario_sha256": "e9fb6dbb12060cb724e2c6360da0d406b8dcb13ed91769105f92efe312491fc7",
"comparison_contract_sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
"selected_executable_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"executable_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"executable_identity": {
"state": "path_metadata_unchanged",
"reason": null
},
"normalization_sha256": "60a27b2d1ee5aa73bf2e5cb2deaed2e9cc548f961ad2e3772c981828b643cc43"
},
"normalization": {
"paths": true,
"pids": true,
"ports": true,
"time_bucket_ms": 10,
"patterns": []
},
"frames": [],
"rendered_frames": [],
"interaction_events": [],
"exit": {
"code": 0,
"signal": null,
"reason": "exited"
},
"settlement": {
"state": "quiesced",
"elapsed_ms": 50,
"cleanup_outcome": "not_required"
},
"process_samples": [],
"filesystem_checkpoints": [
{
"name": "before",
"at_ms": 0,
"files": [],
"effects": [],
"truncated": false
},
{
"name": "after_settlement",
"at_ms": 50,
"files": [],
"effects": [],
"truncated": false
}
],
"event_journal": [],
"files_before": [],
"files_after": [],
"filesystem_effects": [],
"truncated": false,
"truncation_details": {
"raw_terminal": {
"budget_bytes": 1000000,
"observed_bytes": 0,
"retained_bytes": 0,
"observed_frames": 0,
"retained_frames": 0
},
"rendered_terminal": {
"budget_bytes": 1000000,
"observed_bytes": 0,
"retained_bytes": 0,
"observed_frames": 0,
"retained_frames": 0
},
"filesystem_before": {
"files_limit": 10000,
"depth_limit": 16,
"enumeration_truncated": false,
"enumeration_reasons": [],
"hash_budget_bytes": 10000000,
"hashed_bytes": 0,
"hash_omissions": []
},
"filesystem_after": {
"files_limit": 10000,
"depth_limit": 16,
"enumeration_truncated": false,
"enumeration_reasons": [],
"hash_budget_bytes": 10000000,
"hashed_bytes": 0,
"hash_omissions": []
},
"process": {
"sample_limit": 1000,
"sampling_partial": false,
"retained_samples": 0,
"sample_limit_reached": false,
"sampling_failures": 0,
"first_sampling_failure": null,
"coverage": "sampled"
}
},
"limitations": [],
"residual_unknowns": [],
"cleanup": {
"owned_process_group": "verified",
"temporary_root": "removed"
}
},
"confidence": "observed",
"authority": "controlled-replay",
"environment": {
"id": "fixture-linux",
"platform": "linux",
"architecture": "x86_64",
"isolation": "container"
},
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
},
"right": {
"evidence_id": "ev_c340a15fc8ea89a2d6d5f644ae3f1effd798266ada8a19b1cd9aa635f8262484",
"subject": null,
"provider": {
"id": "rea-process",
"name": "REA deterministic process harness",
"version": "3"
},
"analysis_profile": null,
"predicate_type": "rea.process-capture",
"operation": "capture_process_scenario",
"parameters": {
"scenario": "reconstruction"
},
"raw_result": null,
"normalized_result": {
"manifest": {
"rea_version": "1.1.0",
"provider_version": "3",
"platform": "fixture",
"architecture": "fixture",
"pty_backend": "node-pty",
"started_at": "2026-01-01T00:00:00.000Z",
"completed_at": "2026-01-01T00:00:00.001Z",
"scenario": {
"executable_sha256": "0000000000000000000000000000000000000000000000000000000000000000"
},
"comparison_contract": {},
"full_scenario_sha256": "e9fb6dbb12060cb724e2c6360da0d406b8dcb13ed91769105f92efe312491fc7",
"comparison_contract_sha256": "44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a",
"selected_executable_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"executable_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"executable_identity": {
"state": "path_metadata_unchanged",
"reason": null
},
"normalization_sha256": "60a27b2d1ee5aa73bf2e5cb2deaed2e9cc548f961ad2e3772c981828b643cc43"
},
"normalization": {
"paths": true,
"pids": true,
"ports": true,
"time_bucket_ms": 10,
"patterns": []
},
"frames": [],
"rendered_frames": [],
"interaction_events": [],
"exit": {
"code": 0,
"signal": null,
"reason": "exited"
},
"settlement": {
"state": "quiesced",
"elapsed_ms": 50,
"cleanup_outcome": "not_required"
},
"process_samples": [],
"filesystem_checkpoints": [
{
"name": "before",
"at_ms": 0,
"files": [],
"effects": [],
"truncated": false
},
{
"name": "after_settlement",
"at_ms": 50,
"files": [],
"effects": [],
"truncated": false
}
],
"event_journal": [],
"files_before": [],
"files_after": [],
"filesystem_effects": [],
"truncated": false,
"truncation_details": {
"raw_terminal": {
"budget_bytes": 1000000,
"observed_bytes": 0,
"retained_bytes": 0,
"observed_frames": 0,
"retained_frames": 0
},
"rendered_terminal": {
"budget_bytes": 1000000,
"observed_bytes": 0,
"retained_bytes": 0,
"observed_frames": 0,
"retained_frames": 0
},
"filesystem_before": {
"files_limit": 10000,
"depth_limit": 16,
"enumeration_truncated": false,
"enumeration_reasons": [],
"hash_budget_bytes": 10000000,
"hashed_bytes": 0,
"hash_omissions": []
},
"filesystem_after": {
"files_limit": 10000,
"depth_limit": 16,
"enumeration_truncated": false,
"enumeration_reasons": [],
"hash_budget_bytes": 10000000,
"hashed_bytes": 0,
"hash_omissions": []
},
"process": {
"sample_limit": 1000,
"sampling_partial": false,
"retained_samples": 0,
"sample_limit_reached": false,
"sampling_failures": 0,
"first_sampling_failure": null,
"coverage": "sampled"
}
},
"limitations": [],
"residual_unknowns": [],
"cleanup": {
"owned_process_group": "verified",
"temporary_root": "removed"
}
},
"confidence": "observed",
"authority": "controlled-replay",
"environment": {
"id": "fixture-linux",
"platform": "linux",
"architecture": "x86_64",
"isolation": "container"
},
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": []
}
}
}
compare_artifacts
Compare Artifacts · idempotent
Compare complete artifact inventories by logical occurrence path, content identity, metadata, and graph relations. Pass the inventory Evidence nested in each inspect_artifact result as left and right. Every delta cites both inputs, and gaps yield truncated or unknown, never equivalence. Returns every change inline.
| Parameter | Type | Required | Description |
|---|---|---|---|
left |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Left-hand input used for comparison or differential execution. |
right |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Right-hand input used for comparison or differential execution. |
Example:
{
"name": "compare_artifacts",
"arguments": {
"left": {
"evidence_id": "ev_ee7363eddc0589a8f839194d942318da71ce54bd5618029838210f7bacfb36b9",
"subject": {
"name": "fixture-left",
"digest": {
"sha256": "0000000000000000000000000000000000000000000000000000000000000000"
},
"format": "file",
"architecture": null,
"local_path": "fixture-left"
},
"provider": {
"id": "rea-artifact",
"name": "REA artifact graph",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inventory_artifact",
"parameters": {},
"raw_result": null,
"normalized_result": {
"manifest": {
"manifest_id": "agm_727bc5fdb1d6903999f625d154e51878703ba15a815325cf0e0d5713d50ac51f",
"root_artifact_id": "art_2827b82d5d864b615b237ca45cf8a10fc5c14a1b73ba5bb8b358dddefc8e9f8c",
"root_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"root_format": "file",
"graph_sha256": "e19ef8b0841fb52c596216b250b45c817cad47702b40d75022647ebbb34243ee",
"node_count": 1,
"occurrence_count": 1,
"edge_count": 0
},
"nodes": [
{
"artifact_id": "art_2827b82d5d864b615b237ca45cf8a10fc5c14a1b73ba5bb8b358dddefc8e9f8c",
"format": "file",
"sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"size": 1,
"media_type": null,
"architecture": null,
"content_state": "materialized",
"limitations": []
}
],
"occurrences": [
{
"occurrence_id": "occ_273bef4da5057c50b27edf034ffce68d5d9c0c5795778fc3ff41e4e6b3ef5586",
"artifact_id": "art_2827b82d5d864b615b237ca45cf8a10fc5c14a1b73ba5bb8b358dddefc8e9f8c",
"parent_occurrence_id": null,
"logical_path": ".",
"entry_kind": "file",
"artifact_kind": "resource",
"artifact_format": "file",
"declared_size": 1,
"compressed_size": null,
"executable": false,
"encrypted": false,
"hash_status": "verified",
"source_location": null,
"limitations": []
}
],
"edges": [],
"provenance": [],
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
},
"right": {
"evidence_id": "ev_ef585457f00cc380df291922a9c024821232e3fd356a823d27d135c5449df16a",
"subject": {
"name": "fixture-right",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "file",
"architecture": null,
"local_path": "fixture-right"
},
"provider": {
"id": "rea-artifact",
"name": "REA artifact graph",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "inventory_artifact",
"parameters": {},
"raw_result": null,
"normalized_result": {
"manifest": {
"manifest_id": "agm_9ff809a884f3419d241f1618bff671e983c50dd72153f6b3b4bdc3766bb91fcf",
"root_artifact_id": "art_96f554e44817506903722ba66b6b001897989fe181ef986478bc023e1fedf4b1",
"root_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"root_format": "file",
"graph_sha256": "844b92c0ba0ba803e029f47c47ae68a4acc64342ba012bee525377dad76b045a",
"node_count": 1,
"occurrence_count": 1,
"edge_count": 0
},
"nodes": [
{
"artifact_id": "art_96f554e44817506903722ba66b6b001897989fe181ef986478bc023e1fedf4b1",
"format": "file",
"sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"size": 1,
"media_type": null,
"architecture": null,
"content_state": "materialized",
"limitations": []
}
],
"occurrences": [
{
"occurrence_id": "occ_4257a159555da426a3dd9e420ba59795ef3d87d0b1fd93e5cc7d969539519364",
"artifact_id": "art_96f554e44817506903722ba66b6b001897989fe181ef986478bc023e1fedf4b1",
"parent_occurrence_id": null,
"logical_path": ".",
"entry_kind": "file",
"artifact_kind": "resource",
"artifact_format": "file",
"declared_size": 1,
"compressed_size": null,
"executable": false,
"encrypted": false,
"hash_status": "verified",
"source_location": null,
"limitations": []
}
],
"edges": [],
"provenance": [],
"limitations": []
},
"confidence": "observed",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
}
}
compare_functions
Compare Functions · idempotent
Compare two explicit sets of analyze_function Evidence across identity, exact provider text, calls, references, strings, and address-normalized CFG topology. Missing or provider-incompatible facets remain truncated or unknown; every conclusion cites both Evidence sets.
| Parameter | Type | Required | Description |
|---|---|---|---|
left |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Left-hand input used for comparison or differential execution. |
right |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links} | yes | Right-hand input used for comparison or differential execution. |
Example:
{
"name": "compare_functions",
"arguments": {
"left": {
"evidence_id": "ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"subject": {
"name": "function-0",
"digest": {
"sha256": "0000000000000000000000000000000000000000000000000000000000000000"
},
"format": "mach-o",
"architecture": null,
"local_path": "/tmp/function-0"
},
"provider": {
"id": "rea-workflow",
"name": "REA composed investigation workflow",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "analyze_function",
"parameters": {
"procedure": "main"
},
"raw_result": null,
"normalized_result": {
"procedure": {
"address": "0x1000",
"name": "main",
"classification": null,
"body": {
"available": false,
"reason": "The fixture omits function-body extent observations."
},
"signature": "int main(void)",
"locals": []
},
"pseudocode": "return 0;",
"assembly": [],
"comments": [],
"callers": [],
"callees": [],
"incoming_references": [],
"outgoing_references": [],
"referenced_strings": [],
"referenced_names": [],
"basic_blocks": [
{
"start": "0x1000",
"end": "0x1001",
"successors": []
}
],
"native_api": null,
"native_value_flow": null,
"limitations": [
"The fixture omits native API and value-flow observations."
]
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
},
"right": {
"evidence_id": "ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459",
"subject": {
"name": "function-1",
"digest": {
"sha256": "1111111111111111111111111111111111111111111111111111111111111111"
},
"format": "mach-o",
"architecture": null,
"local_path": "/tmp/function-1"
},
"provider": {
"id": "rea-workflow",
"name": "REA composed investigation workflow",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "analyze_function",
"parameters": {
"procedure": "main"
},
"raw_result": null,
"normalized_result": {
"procedure": {
"address": "0x1000",
"name": "main",
"classification": null,
"body": {
"available": false,
"reason": "The fixture omits function-body extent observations."
},
"signature": "int main(void)",
"locals": []
},
"pseudocode": "return 1;",
"assembly": [],
"comments": [],
"callers": [],
"callees": [],
"incoming_references": [],
"outgoing_references": [],
"referenced_strings": [],
"referenced_names": [],
"basic_blocks": [
{
"start": "0x1000",
"end": "0x1001",
"successors": []
}
],
"native_api": null,
"native_value_flow": null,
"limitations": [
"The fixture omits native API and value-flow observations."
]
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
}
}
compare_bundles
Compare Bundles · idempotent
Compare two canonical Evidence bundles by exact record membership, explicit one-to-one observation pairs, and complete residual-unknown revision histories. Missing bundle members describe omission only, never behavioral equivalence; output is digest-anchored and returns every change inline.
| Parameter | Type | Required | Description |
|---|---|---|---|
left_bundle_path |
string | yes | Local filesystem path for left bundle. |
right_bundle_path |
string | yes | Local filesystem path for right bundle. |
record_pairs |
object{left_evidence_id, right_evidence_id}[] | Value for record pairs. |
Example:
{
"name": "compare_bundles",
"arguments": {
"left_bundle_path": "/tmp/left-evidence.json",
"right_bundle_path": "/tmp/right-evidence.json",
"record_pairs": []
}
}
find_changed_behavior
Find Changed Behavior · idempotent
Aggregate validated process and artifact comparison Evidence. Runtime observations remain distinct from static behavior candidates; missing or incomplete comparisons produce unresolved findings, never causal claims. Returns every finding inline.
| Parameter | Type | Required | Description |
|---|---|---|---|
comparisons |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Validated comparison Evidence records to aggregate. |
Example:
{
"name": "find_changed_behavior",
"arguments": {
"comparisons": [
{
"evidence_id": "ev_08e84218426740f661900853924dcf6c6374615bebb07ea6833879bd6ab35828",
"subject": null,
"provider": {
"id": "rea-function-comparison",
"name": "REA function comparison",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.function-comparison",
"operation": "compare_functions",
"parameters": {
"left_evidence_id": "ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"right_evidence_id": "ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
},
"raw_result": null,
"normalized_result": {
"status": "changed",
"function_match": {
"status": "matched",
"method": "symbol",
"left_name": "main",
"right_name": "main"
},
"left_subject_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"right_subject_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"summary": {
"unchanged": 7,
"changed": 1,
"unknown": 0
},
"dimensions": [
{
"dimension": "identity",
"left_count": null,
"right_count": null,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "dd190a914de1bdf8f4bba97a2e74b439585874c567f28eb0ff41bc5388c66d65",
"right_digest": "dd190a914de1bdf8f4bba97a2e74b439585874c567f28eb0ff41bc5388c66d65",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "pseudocode",
"left_count": 9,
"right_count": 9,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "changed",
"left_digest": "64abdfe133a114158fa0e185d0edec784e6ccf13a166a0fed8bc18bb0cc72554",
"right_digest": "c8e26d77640903b2d4c765ebcb7f7170b64dd320dd3911abbe8346e07cd593d1",
"text_delta": {
"added_lines": 1,
"removed_lines": 1,
"hunks": 2
},
"conclusion_kind": "derived_relationship"
},
{
"dimension": "assembly",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [
"Assembly is opaque provider text; relocation normalization is unavailable."
],
"status": "unchanged",
"left_digest": "12ae32cb1ec02d01eda3581b127c1fee3b0dc53572ed6baf239721a03d82e126",
"right_digest": "12ae32cb1ec02d01eda3581b127c1fee3b0dc53572ed6baf239721a03d82e126",
"text_delta": {
"added_lines": 0,
"removed_lines": 0,
"hunks": 0
},
"conclusion_kind": "derived_relationship"
},
{
"dimension": "comments",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "calls",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "references",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "strings_names",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "cfg",
"left_count": 1,
"right_count": 1,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "e947121f0d4cb8d2a2468a75a44872a29aa1239e6401712df80cfa36bf7df7a0",
"right_digest": "e947121f0d4cb8d2a2468a75a44872a29aa1239e6401712df80cfa36bf7df7a0",
"text_delta": null,
"conclusion_kind": "derived_relationship"
}
],
"changes": [
{
"dimension": "pseudocode",
"left_count": 9,
"right_count": 9,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "changed",
"left_digest": "64abdfe133a114158fa0e185d0edec784e6ccf13a166a0fed8bc18bb0cc72554",
"right_digest": "c8e26d77640903b2d4c765ebcb7f7170b64dd320dd3911abbe8346e07cd593d1",
"text_delta": {
"added_lines": 1,
"removed_lines": 1,
"hunks": 2
},
"conclusion_kind": "derived_relationship"
}
],
"limitations": [
"Left: The fixture omits native API and value-flow observations.",
"Right: The fixture omits native API and value-flow observations."
]
},
"confidence": "derived",
"authority": "analyst-inference",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
]
}
]
}
}
build_call_path
Build Call Path · idempotent
Build every shortest direct-callee path inline from complete analyze_function Evidence records using exact canonical addresses. Missing dossiers and provider mixing remain unknown; every node and edge cites source Evidence.
| Parameter | Type | Required | Description |
|---|---|---|---|
functions |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Value for functions. |
start |
object{address} | yes | Value for start. |
goal |
object{address} | yes | Value for goal. |
Example:
{
"name": "build_call_path",
"arguments": {
"functions": [
{
"evidence_id": "ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"subject": {
"name": "function-0",
"digest": {
"sha256": "0000000000000000000000000000000000000000000000000000000000000000"
},
"format": "mach-o",
"architecture": null,
"local_path": "/tmp/function-0"
},
"provider": {
"id": "rea-workflow",
"name": "REA composed investigation workflow",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.analysis",
"operation": "analyze_function",
"parameters": {
"procedure": "main"
},
"raw_result": null,
"normalized_result": {
"procedure": {
"address": "0x1000",
"name": "main",
"classification": null,
"body": {
"available": false,
"reason": "The fixture omits function-body extent observations."
},
"signature": "int main(void)",
"locals": []
},
"pseudocode": "return 0;",
"assembly": [],
"comments": [],
"callers": [],
"callees": [],
"incoming_references": [],
"outgoing_references": [],
"referenced_strings": [],
"referenced_names": [],
"basic_blocks": [
{
"start": "0x1000",
"end": "0x1001",
"successors": []
}
],
"native_api": null,
"native_value_flow": null,
"limitations": [
"The fixture omits native API and value-flow observations."
]
},
"confidence": "derived",
"authority": "shipped-artifact",
"environment": null,
"limitations": [],
"locations": [],
"evidence_links": []
}
],
"start": {
"address": "0x1000"
},
"goal": {
"address": "0x1000"
}
}
}
correlate_static_and_runtime
Correlate Static And Runtime · idempotent
Evaluate every explicit caller-declared hypothesis between exact static comparison findings and runtime comparison dimensions. Similar names or paths are never auto-matched, consistent cochange never proves causality, and unknown or truncated inputs remain unresolved. Returns all correlations and their complete Evidence closure inline.
| Parameter | Type | Required | Description |
|---|---|---|---|
static_comparisons |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Value for static comparisons. |
runtime_comparisons |
object{evidence_id, subject, provider, analysis_profile, predicate_type, operation, parameters, raw_result, normalized_result, confidence, authority, environment, limitations, locations, evidence_links}[] | yes | Value for runtime comparisons. |
mappings |
object{static, runtime, side_alignment, hypothesis}[] | yes | Value for mappings. |
Example:
{
"name": "correlate_static_and_runtime",
"arguments": {
"static_comparisons": [
{
"evidence_id": "ev_08e84218426740f661900853924dcf6c6374615bebb07ea6833879bd6ab35828",
"subject": null,
"provider": {
"id": "rea-function-comparison",
"name": "REA function comparison",
"version": "1"
},
"analysis_profile": null,
"predicate_type": "rea.function-comparison",
"operation": "compare_functions",
"parameters": {
"left_evidence_id": "ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"right_evidence_id": "ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
},
"raw_result": null,
"normalized_result": {
"status": "changed",
"function_match": {
"status": "matched",
"method": "symbol",
"left_name": "main",
"right_name": "main"
},
"left_subject_sha256": "0000000000000000000000000000000000000000000000000000000000000000",
"right_subject_sha256": "1111111111111111111111111111111111111111111111111111111111111111",
"summary": {
"unchanged": 7,
"changed": 1,
"unknown": 0
},
"dimensions": [
{
"dimension": "identity",
"left_count": null,
"right_count": null,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "dd190a914de1bdf8f4bba97a2e74b439585874c567f28eb0ff41bc5388c66d65",
"right_digest": "dd190a914de1bdf8f4bba97a2e74b439585874c567f28eb0ff41bc5388c66d65",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "pseudocode",
"left_count": 9,
"right_count": 9,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "changed",
"left_digest": "64abdfe133a114158fa0e185d0edec784e6ccf13a166a0fed8bc18bb0cc72554",
"right_digest": "c8e26d77640903b2d4c765ebcb7f7170b64dd320dd3911abbe8346e07cd593d1",
"text_delta": {
"added_lines": 1,
"removed_lines": 1,
"hunks": 2
},
"conclusion_kind": "derived_relationship"
},
{
"dimension": "assembly",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [
"Assembly is opaque provider text; relocation normalization is unavailable."
],
"status": "unchanged",
"left_digest": "12ae32cb1ec02d01eda3581b127c1fee3b0dc53572ed6baf239721a03d82e126",
"right_digest": "12ae32cb1ec02d01eda3581b127c1fee3b0dc53572ed6baf239721a03d82e126",
"text_delta": {
"added_lines": 0,
"removed_lines": 0,
"hunks": 0
},
"conclusion_kind": "derived_relationship"
},
{
"dimension": "comments",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "calls",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "references",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "strings_names",
"left_count": 0,
"right_count": 0,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"right_digest": "4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945",
"text_delta": null,
"conclusion_kind": "derived_relationship"
},
{
"dimension": "cfg",
"left_count": 1,
"right_count": 1,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "unchanged",
"left_digest": "e947121f0d4cb8d2a2468a75a44872a29aa1239e6401712df80cfa36bf7df7a0",
"right_digest": "e947121f0d4cb8d2a2468a75a44872a29aa1239e6401712df80cfa36bf7df7a0",
"text_delta": null,
"conclusion_kind": "derived_relationship"
}
],
"changes": [
{
"dimension": "pseudocode",
"left_count": 9,
"right_count": 9,
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
],
"limitations": [],
"status": "changed",
"left_digest": "64abdfe133a114158fa0e185d0edec784e6ccf13a166a0fed8bc18bb0cc72554",
"right_digest": "c8e26d77640903b2d4c765ebcb7f7170b64dd320dd3911abbe8346e07cd593d1",
"text_delta": {
"added_lines": 1,
"removed_lines": 1,
"hunks": 2
},
"conclusion_kind": "derived_relationship"
}
],
"limitations": [
"Left: The fixture omits native API and value-flow observations.",
"Right: The fixture omits native API and value-flow observations."
]
},
"confidence": "derived",
"authority": "analyst-inference",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": [
"ev_9040dcea4aee23f8bfd419e31275b85bc894b0cac03a036c1448a934a4420e3b",
"ev_58175b2b15ca88757f14f536abcf13a7dab92595403dc934842114a2d6134459"
]
}
],
"runtime_comparisons": [
{
"evidence_id": "ev_5f5ed94fee174c3957930ff6e992c9618fa1757001cf04d824846ab1124636a5",
"subject": null,
"provider": {
"id": "rea-process",
"name": "REA deterministic process harness",
"version": "3"
},
"analysis_profile": null,
"predicate_type": "rea.process-comparison",
"operation": "compare_process_captures",
"parameters": {
"left_evidence_id": "ev_b6ee3183062783c970e2a237f4a62a85b0582760bf0bae8739669a620f131405",
"right_evidence_id": "ev_c340a15fc8ea89a2d6d5f644ae3f1effd798266ada8a19b1cd9aa635f8262484",
"left_normalization": {
"paths": true,
"pids": true,
"ports": true,
"time_bucket_ms": 10,
"patterns": []
},
"right_normalization": {
"paths": true,
"pids": true,
"ports": true,
"time_bucket_ms": 10,
"patterns": []
}
},
"raw_result": null,
"normalized_result": {
"status": "unchanged",
"terminal": "unchanged",
"interaction": "unchanged",
"exit": "unchanged",
"filesystem": "unchanged",
"process": "unchanged",
"first_divergence": {
"status": "none"
},
"limitations": []
},
"confidence": "derived",
"authority": "analyst-inference",
"environment": null,
"limitations": [
"Artifact identity is unavailable for this observation."
],
"locations": [],
"evidence_links": [
"ev_b6ee3183062783c970e2a237f4a62a85b0582760bf0bae8739669a620f131405",
"ev_c340a15fc8ea89a2d6d5f644ae3f1effd798266ada8a19b1cd9aa635f8262484"
]
}
],
"mappings": [
{
"static": {
"comparison_evidence_id": "ev_08e84218426740f661900853924dcf6c6374615bebb07ea6833879bd6ab35828",
"selector": {
"kind": "function",
"dimension": "pseudocode"
}
},
"runtime": {
"comparison_evidence_id": "ev_5f5ed94fee174c3957930ff6e992c9618fa1757001cf04d824846ab1124636a5",
"dimension": "terminal"
},
"side_alignment": "left_to_left",
"hypothesis": {
"statement": "Static implementation changed without terminal change.",
"expected_pattern": "static_only"
}
}
]
}
}
verify_reconstruction
Verify Reconstruction · idempotent
Verify a finite typed behavioral and structural specification against a canonical Evidence bundle. Pass means every declared claim has complete comparable authority—not global source equivalence; changed claims fail and missing, limited, or unresolved evidence stays unknown.
| Parameter | Type | Required | Description |
|---|---|---|---|
specification |
object{name, claims} | yes | Value for specification. |
Example:
{
"name": "verify_reconstruction",
"arguments": {
"specification": {
"name": "Terminal compatibility",
"claims": [
{
"claim_id": "terminal-output",
"title": "Terminal output remains equivalent",
"comparison_evidence_id": "ev_5f5ed94fee174c3957930ff6e992c9618fa1757001cf04d824846ab1124636a5",
"kind": "behavioral",
"dimension": "terminal"
}
]
}
}
}
list_unknowns
List Unknowns · read-only, idempotent
List every current residual-unknown head in deterministic ID order, with optional exact status, severity, and domain filters. Results are complete and inline. This is read-only; unresolved, contradicted, and non-truth dispositions remain distinct.
| Parameter | Type | Required | Description |
|---|---|---|---|
status |
"open" | "investigating" | "blocked" | "contradicted" | "resolved" |
Current lifecycle or verification status. | |
severity |
"low" | "medium" | "high" | "critical" |
Value for severity. | |
domain |
string | Value for domain. |
Example:
{
"name": "list_unknowns",
"arguments": {}
}
record_unknown
Record Unknown
Create one deterministic residual unknown and immutable mutation evidence. Validates all evidence and relationship references, and rejects duplicate stable identity.
| Parameter | Type | Required | Description |
|---|---|---|---|
question |
string | yes | Concrete unresolved question to retain for later investigation. |
severity |
"low" | "medium" | "high" | "critical" |
yes | Value for severity. |
domain |
string | yes | Value for domain. |
required_authority |
"shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null |
yes | Value for required authority. |
required_confidence |
"observed" | "derived" | "inferred" |
yes | Value for required confidence. |
required_environment |
object{id, platform, architecture, isolation} | null | yes | Value for required environment. |
recommended_probes |
object{operation, rationale}[] | yes | Value for recommended probes. |
relationships |
object{type, unknown_id}[] | yes | Value for relationships. |
supporting_evidence_ids |
string[] | Ordered Evidence identifiers for the supporting observations. | |
contradicting_evidence_ids |
string[] | Ordered Evidence identifiers for the contradicting observations. |
Example:
{
"name": "record_unknown",
"arguments": {
"question": "Does this branch require an unavailable external service?",
"severity": "medium",
"domain": "protocol",
"required_authority": "controlled-replay",
"required_confidence": "observed",
"required_environment": null,
"recommended_probes": [
{
"operation": "capture_process_scenario",
"rationale": "Replay branch."
}
],
"relationships": [],
"supporting_evidence_ids": [],
"contradicting_evidence_ids": []
}
}
update_unknown
Update Unknown
Append one immutable full-state revision and mutation evidence. Requires exact expected_revision; stale concurrent writers fail instead of overwriting newer analysis.
| Parameter | Type | Required | Description |
|---|---|---|---|
unknown_id |
string | yes | Exact residual-unknown identifier. |
expected_revision |
integer | yes | Expected revision used to reject stale or mismatched input. |
status |
"open" | "investigating" | "blocked" | "contradicted" | "resolved" |
yes | Current lifecycle or verification status. |
severity |
"low" | "medium" | "high" | "critical" |
yes | Value for severity. |
supporting_evidence_ids |
string[] | yes | Ordered Evidence identifiers for the supporting observations. |
contradicting_evidence_ids |
string[] | yes | Ordered Evidence identifiers for the contradicting observations. |
required_authority |
"shipped-artifact" | "controlled-replay" | "historical-reference" | "external-service" | "analyst-inference" | null |
yes | Value for required authority. |
required_confidence |
"observed" | "derived" | "inferred" |
yes | Value for required confidence. |
required_environment |
object{id, platform, architecture, isolation} | null | yes | Value for required environment. |
recommended_probes |
object{operation, rationale}[] | yes | Value for recommended probes. |
relationships |
object{type, unknown_id}[] | yes | Value for relationships. |
resolution |
object{disposition, rationale, evidence_ids} | null | yes | Value for resolution. |
Example:
{
"name": "update_unknown",
"arguments": {
"unknown_id": "unk_0000000000000000000000000000000000000000000000000000000000000000",
"expected_revision": 1,
"status": "investigating",
"severity": "medium",
"supporting_evidence_ids": [],
"contradicting_evidence_ids": [],
"required_authority": "controlled-replay",
"required_confidence": "observed",
"required_environment": null,
"recommended_probes": [],
"relationships": [],
"resolution": null
}
}
verify_unknown_resolution
Verify Unknown Resolution · read-only, idempotent
Revalidate the current residual-unknown head against live bundled evidence, exact authority/confidence/environment requirements, and revision integrity. Withdrawn and out-of-scope dispositions are not truth claims.
| Parameter | Type | Required | Description |
|---|---|---|---|
unknown_id |
string | yes | Exact residual-unknown identifier. |
Example:
{
"name": "verify_unknown_resolution",
"arguments": {
"unknown_id": "unk_0000000000000000000000000000000000000000000000000000000000000000"
}
}
get_navigation_context
Get Navigation Context · idempotent
Return the selected document, current address, and containing/current procedure in one provider-neutral result. The result reflects sequential provider observations, not an atomic cursor snapshot; a cursor outside any procedure returns procedure: null.
| Parameter | Type | Required | Description |
|---|---|---|---|
document |
string | Exact provider document or program identity. |
Example:
{
"name": "get_navigation_context",
"arguments": {}
}
inspect_address_context
Inspect Address Context · idempotent
Inspect one explicit reproducible address for its analyzed name, containing procedure, regular and inline comments, and matching bookmarks. Each unsupported facet returns a typed unavailable outcome; use xrefs, assembly, or pseudocode for those deeper views.
| Parameter | Type | Required | Description |
|---|---|---|---|
address |
string | yes | Value for address. |
document |
string | Exact provider document or program identity. |
Example:
{
"name": "inspect_address_context",
"arguments": {
"address": "0x1000"
}
}