Agent Context · Add file · llms.txt

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"
  }
}