Variable ELECTRON_TOOL_CONTRACTSConst
ELECTRON_TOOL_CONTRACTS: readonly [
{
annotations: {
destructiveHint: false;
idempotentHint: true;
openWorldHint: true;
readOnlyHint: true;
};
description: "List Electron file:// page targets from an approved user-owned loopback CDP endpoint. Every path is canonicalized and must remain contained by an approved filesystem root, including after symlink resolution.";
examples: readonly [
{
input: {
allowed_file_roots: ["/Applications/Example.app/Contents/Resources"];
approved: true;
cdp_endpoint: "http://127.0.0.1:9223";
limit: 100;
offset: 0;
};
title: "List approved Electron file pages";
},
];
inputSchema: ZodObject<
{
allowed_file_roots: ZodPipe<
ZodArray<ZodString>,
ZodTransform<string[], string[]>,
>;
approved: ZodLiteral<true>;
cdp_endpoint: ZodPipe<ZodString, ZodTransform<string, string>>;
limit: ZodDefault<ZodNumber>;
offset: ZodDefault<ZodNumber>;
},
$strip,
>;
kind: "electron-provider";
name: "list_electron_targets";
outputSchema: ZodObject<
{
analysis_profile: ZodOptional<
ZodObject<
{
digest: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodString },
$strip,
>;
provider_profile_schema_version: ZodNumber;
schema_version: ZodLiteral<1>;
},
$strip,
>,
>;
authority: ZodEnum<
{
"analyst-inference": "analyst-inference";
"controlled-replay": "controlled-replay";
"external-service": "external-service";
"historical-reference": "historical-reference";
"shipped-artifact": "shipped-artifact";
},
>;
confidence: ZodEnum<
{ derived: "derived"; inferred: "inferred"; observed: "observed" },
>;
environment: ZodNullable<
ZodObject<
{
architecture: ZodString;
id: ZodString;
isolation: ZodEnum<
{
container: "container";
none: "none";
process: "process";
"virtual-machine": "virtual-machine";
},
>;
platform: ZodString;
},
$strip,
>,
>;
evidence_id: ZodString;
evidence_links: ZodArray<ZodString>;
limitations: ZodArray<ZodString>;
locations: ZodArray<
ZodDiscriminatedUnion<
[
ZodObject<
{ address: ZodString; kind: ZodLiteral<"address"> },
$strip,
>,
ZodObject<
{
end: ZodString;
kind: ZodLiteral<"address-range">;
start: ZodString;
},
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"artifact-path">; path: ZodString },
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"file-offset">; offset: ZodNumber },
$strip,
>,
ZodObject<
{
end: ZodNumber;
kind: ZodLiteral<"file-offset-range">;
start: ZodNumber;
},
$strip,
>,
],
"kind",
>,
>;
normalized_result: ZodObject<
{
browser: ZodObject<
{
js_version: ZodString;
product: ZodString;
protocol_version: ZodString;
revision: ZodString;
user_agent: ZodString;
},
$strip,
>;
excluded: ZodObject<
{
non_page: ZodNumber;
outside_root: ZodNumber;
unsupported_url: ZodNumber;
},
$strip,
>;
limitations: ZodArray<ZodString>;
schema_version: ZodLiteral<1>;
targets: ZodObject<
{
has_more: ZodBoolean;
items: ZodArray<
ZodObject<
{
attached: ...;
file_path: ...;
target_id: ...;
title: ...;
type: ...;
},
$strip,
>,
>;
limit: ZodNumber;
next_offset: ZodNullable<ZodNumber>;
offset: ZodNumber;
total: ZodNumber;
},
$strip,
>;
},
$strip,
>;
operation: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
predicate_type: ZodString;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodNullable<ZodString> },
$strip,
>;
raw_result: ZodNullable<ZodJSONSchema>;
schema_version: ZodLiteral<2>;
subject: ZodNullable<
ZodObject<
{
architecture: ZodNullable<
ZodEnum<
{ arm: "arm"; arm64: "arm64"; x86: "x86"; x86_64: "x86_64" },
>,
>;
digest: ZodObject<{ sha256: ZodString }, $strip>;
format: ZodEnum<
{
"analysis-database": "analysis-database";
apk: "apk";
asar: "asar";
directory: "directory";
dmg: "dmg";
elf: "elf";
entitlements: "entitlements";
file: "file";
hopper: "hopper";
ipa: "ipa";
javascript: "javascript";
"javascript-bundle": "javascript-bundle";
"mach-o": "mach-o";
"mach-o-universal": "mach-o-universal";
pe: "pe";
pkg: "pkg";
plist: "plist";
"source-map": "source-map";
unknown: "unknown";
zip: "zip";
},
>;
local_path: ZodString;
name: ZodString;
},
$strip,
>,
>;
},
$strict,
>;
},
{
annotations: {
destructiveHint: false;
idempotentHint: true;
openWorldHint: true;
readOnlyHint: true;
};
description: "Passively inspect one approved Electron file page through CDP. Returns root-confined frames, DOM structure, resource paths, and scripts without evaluating renderer JavaScript or invoking Electron APIs; script contents require separate approval.";
examples: readonly [
{
input: {
allowed_file_roots: ["/Applications/Example.app/Contents/Resources"];
approved: true;
cdp_endpoint: "http://127.0.0.1:9223";
include_script_sources: false;
limits: {
max_dom_nodes: 2000;
max_frames: 200;
max_resources: 2000;
max_script_source_bytes: 1048576;
max_scripts: 500;
max_total_script_source_bytes: 4194304;
max_workers: 500;
};
observation_ms: 100;
source_capture_approved: false;
target_id: "TARGET_ID_FROM_LIST_ELECTRON_TARGETS";
};
title: "Inspect an approved Electron page";
},
];
inputSchema: ZodObject<
{
allowed_file_roots: ZodPipe<
ZodArray<ZodString>,
ZodTransform<string[], string[]>,
>;
approved: ZodLiteral<true>;
cdp_endpoint: ZodPipe<ZodString, ZodTransform<string, string>>;
include_script_sources: ZodDefault<ZodBoolean>;
limits: ZodDefault<
ZodObject<
{
max_dom_nodes: ZodDefault<ZodNumber>;
max_frames: ZodDefault<ZodNumber>;
max_resources: ZodDefault<ZodNumber>;
max_script_source_bytes: ZodDefault<ZodNumber>;
max_scripts: ZodDefault<ZodNumber>;
max_total_script_source_bytes: ZodDefault<ZodNumber>;
max_workers: ZodDefault<ZodNumber>;
},
$strip,
>,
>;
observation_ms: ZodDefault<ZodNumber>;
source_capture_approved: ZodDefault<ZodBoolean>;
target_id: ZodString;
},
$strip,
>;
kind: "electron-provider";
name: "inspect_electron_page";
outputSchema: ZodObject<
{
analysis_profile: ZodOptional<
ZodObject<
{
digest: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodString },
$strip,
>;
provider_profile_schema_version: ZodNumber;
schema_version: ZodLiteral<1>;
},
$strip,
>,
>;
authority: ZodEnum<
{
"analyst-inference": "analyst-inference";
"controlled-replay": "controlled-replay";
"external-service": "external-service";
"historical-reference": "historical-reference";
"shipped-artifact": "shipped-artifact";
},
>;
confidence: ZodEnum<
{ derived: "derived"; inferred: "inferred"; observed: "observed" },
>;
environment: ZodNullable<
ZodObject<
{
architecture: ZodString;
id: ZodString;
isolation: ZodEnum<
{
container: "container";
none: "none";
process: "process";
"virtual-machine": "virtual-machine";
},
>;
platform: ZodString;
},
$strip,
>,
>;
evidence_id: ZodString;
evidence_links: ZodArray<ZodString>;
limitations: ZodArray<ZodString>;
locations: ZodArray<
ZodDiscriminatedUnion<
[
ZodObject<
{ address: ZodString; kind: ZodLiteral<"address"> },
$strip,
>,
ZodObject<
{
end: ZodString;
kind: ZodLiteral<"address-range">;
start: ZodString;
},
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"artifact-path">; path: ZodString },
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"file-offset">; offset: ZodNumber },
$strip,
>,
ZodObject<
{
end: ZodNumber;
kind: ZodLiteral<"file-offset-range">;
start: ZodNumber;
},
$strip,
>,
],
"kind",
>,
>;
normalized_result: ZodObject<
{
browser: ZodObject<
{
js_version: ZodString;
product: ZodString;
protocol_version: ZodString;
revision: ZodString;
user_agent: ZodString;
},
$strip,
>;
capture_window: ZodObject<
{
ended_at: ZodISODateTime;
observation_ms: ZodNumber;
started_at: ZodISODateTime;
},
$strip,
>;
completeness: ZodObject<
{
attach_limited_sections: ZodArray<
ZodEnum<
{
accessibility: ...;
console_events: ...;
console_text: ...;
dom: ...;
frames: ...;
json_body_shapes: ...;
metadata: ...;
network_initiators: ...;
network_requests: ...;
resources: ...;
screenshot: ...;
script_sources: ...;
scripts: ...;
source_maps: ...;
storage: ...;
storage_keys: ...;
timeline: ...;
webmcp_tools: ...;
websocket_connections: ...;
websocket_frames: ...;
websocket_shapes: ...;
workers: ...;
},
>,
>;
conditions: ZodArray<
ZodEnum<
{
attach_limited: ...;
complete_within_window: ...;
policy_filtered: ...;
truncated: ...;
},
>,
>;
dropped_events: ZodObject<
{
console_events: ZodNumber;
network_requests: ZodNumber;
scripts: ZodNumber;
timeline_events: ZodNumber;
total: ZodNumber;
webmcp_tools: ZodNumber;
websocket_connections: ZodNumber;
websocket_frames: ZodNumber;
},
$strip,
>;
excluded: ZodArray<
ZodObject<{ count: ...; reason: ...; section: ... }, $strip>,
>;
policy_filtered_sections: ZodArray<
ZodEnum<
{
accessibility: ...;
console_events: ...;
console_text: ...;
dom: ...;
frames: ...;
json_body_shapes: ...;
metadata: ...;
network_initiators: ...;
network_requests: ...;
resources: ...;
screenshot: ...;
script_sources: ...;
scripts: ...;
source_maps: ...;
storage: ...;
storage_keys: ...;
timeline: ...;
webmcp_tools: ...;
websocket_connections: ...;
websocket_frames: ...;
websocket_shapes: ...;
workers: ...;
},
>,
>;
status: ZodEnum<
{
attach_limited: "attach_limited";
complete_within_window: "complete_within_window";
policy_filtered: "policy_filtered";
truncated: "truncated";
},
>;
truncated_sections: ZodArray<
ZodEnum<
{
accessibility: ...;
console_events: ...;
console_text: ...;
dom: ...;
frames: ...;
json_body_shapes: ...;
metadata: ...;
network_initiators: ...;
network_requests: ...;
resources: ...;
screenshot: ...;
script_sources: ...;
scripts: ...;
source_maps: ...;
storage: ...;
storage_keys: ...;
timeline: ...;
webmcp_tools: ...;
websocket_connections: ...;
websocket_frames: ...;
websocket_shapes: ...;
workers: ...;
},
>,
>;
unavailable_sections: ZodArray<
ZodEnum<
{
accessibility: ...;
console_events: ...;
console_text: ...;
dom: ...;
frames: ...;
json_body_shapes: ...;
metadata: ...;
network_initiators: ...;
network_requests: ...;
resources: ...;
screenshot: ...;
script_sources: ...;
scripts: ...;
source_maps: ...;
storage: ...;
storage_keys: ...;
timeline: ...;
webmcp_tools: ...;
websocket_connections: ...;
websocket_frames: ...;
websocket_shapes: ...;
workers: ...;
},
>,
>;
},
$strip,
>;
dom: ZodObject<
{
nodes: ZodArray<
ZodObject<
{
attribute_names: ...;
index: ...;
node_name: ...;
node_type: ...;
node_value_length: ...;
parent_index: ...;
},
$strip,
>,
>;
total_nodes: ZodNumber;
},
$strip,
>;
frames: ZodArray<
ZodObject<
{
file_path: ZodString;
frame_id: ZodString;
parent_frame_id: ZodNullable<ZodString>;
},
$strip,
>,
>;
limitations: ZodArray<ZodString>;
resources: ZodArray<
ZodObject<
{
content_size: ZodNullable<ZodNumber>;
file_path: ZodString;
mime_type: ZodString;
resource_key: ZodString;
type: ZodString;
},
$strip,
>,
>;
schema_version: ZodLiteral<1>;
scripts: ZodObject<
{
items: ZodArray<
ZodObject<
{
cdp_hash: ...;
file_path: ...;
frame_id: ...;
is_module: ...;
language: ...;
length: ...;
script_key: ...;
source: ...;
},
$strip,
>,
>;
total: ZodNumber;
},
$strip,
>;
target: ZodObject<
{
attached: ZodBoolean;
file_path: ZodString;
target_id: ZodString;
title: ZodString;
type: ZodString;
},
$strip,
>;
workers: ZodDefault<
ZodArray<
ZodObject<
{
attached: ZodBoolean;
file_path: ZodString;
opener_target_id: ZodNullable<(...)>;
parent_frame_id: ZodNullable<(...)>;
target_id: ZodString;
type: ZodString;
},
$strip,
>,
>,
>;
},
$strip,
>;
operation: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
predicate_type: ZodString;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodNullable<ZodString> },
$strip,
>;
raw_result: ZodNullable<ZodJSONSchema>;
schema_version: ZodLiteral<2>;
subject: ZodNullable<
ZodObject<
{
architecture: ZodNullable<
ZodEnum<
{ arm: "arm"; arm64: "arm64"; x86: "x86"; x86_64: "x86_64" },
>,
>;
digest: ZodObject<{ sha256: ZodString }, $strip>;
format: ZodEnum<
{
"analysis-database": "analysis-database";
apk: "apk";
asar: "asar";
directory: "directory";
dmg: "dmg";
elf: "elf";
entitlements: "entitlements";
file: "file";
hopper: "hopper";
ipa: "ipa";
javascript: "javascript";
"javascript-bundle": "javascript-bundle";
"mach-o": "mach-o";
"mach-o-universal": "mach-o-universal";
pe: "pe";
pkg: "pkg";
plist: "plist";
"source-map": "source-map";
unknown: "unknown";
zip: "zip";
},
>;
local_path: ZodString;
name: ZodString;
},
$strip,
>,
>;
},
$strict,
>;
},
{
annotations: {
destructiveHint: false;
idempotentHint: true;
openWorldHint: false;
readOnlyHint: true;
};
description: "Statically reconstruct one approved local ASAR or extracted JavaScript application as Evidence v2 and JavaScript Application Graph v1. Maps BrowserWindow preferences, preload and contextBridge APIs, literal and dynamic IPC, handler locations, sender-validation observations, utility processes, and requested native addon bindings without executing JavaScript; source-map contents require separate approval.";
examples: readonly [
{
input: {
approved: true;
format: "auto";
input_path: "/Applications/Example.app/Contents/Resources/app.asar";
source_map_read_approved: false;
};
title: "Analyze one approved local Electron application";
},
];
inputSchema: ZodObject<
{
approved: ZodLiteral<true>;
format: ZodDefault<
ZodEnum<{ asar: "asar"; auto: "auto"; directory: "directory" }>,
>;
input_path: ZodString;
limits: ZodDefault<
ZodObject<
{
max_artifact_entry_bytes: ZodDefault<ZodNumber>;
max_ast_nodes: ZodDefault<ZodNumber>;
max_compression_ratio: ZodDefault<ZodNumber>;
max_depth: ZodDefault<ZodNumber>;
max_entries: ZodDefault<ZodNumber>;
max_findings: ZodDefault<ZodNumber>;
max_modules: ZodDefault<ZodNumber>;
max_parse_milliseconds: ZodDefault<ZodNumber>;
max_path_bytes: ZodDefault<ZodNumber>;
max_source_map_sources: ZodDefault<ZodNumber>;
max_text_file_bytes: ZodDefault<ZodNumber>;
max_text_files: ZodDefault<ZodNumber>;
max_total_artifact_bytes: ZodDefault<ZodNumber>;
max_total_text_bytes: ZodDefault<ZodNumber>;
},
$strict,
>,
>;
source_map_read_approved: ZodDefault<ZodBoolean>;
},
$strict,
>;
kind: "electron-provider";
name: "analyze_javascript_application";
outputSchema: ZodObject<
{
analysis_profile: ZodOptional<
ZodObject<
{
digest: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodString },
$strip,
>;
provider_profile_schema_version: ZodNumber;
schema_version: ZodLiteral<1>;
},
$strip,
>,
>;
authority: ZodEnum<
{
"analyst-inference": "analyst-inference";
"controlled-replay": "controlled-replay";
"external-service": "external-service";
"historical-reference": "historical-reference";
"shipped-artifact": "shipped-artifact";
},
>;
confidence: ZodEnum<
{ derived: "derived"; inferred: "inferred"; observed: "observed" },
>;
environment: ZodNullable<
ZodObject<
{
architecture: ZodString;
id: ZodString;
isolation: ZodEnum<
{
container: "container";
none: "none";
process: "process";
"virtual-machine": "virtual-machine";
},
>;
platform: ZodString;
},
$strip,
>,
>;
evidence_id: ZodString;
evidence_links: ZodArray<ZodString>;
limitations: ZodArray<ZodString>;
locations: ZodArray<
ZodDiscriminatedUnion<
[
ZodObject<
{ address: ZodString; kind: ZodLiteral<"address"> },
$strip,
>,
ZodObject<
{
end: ZodString;
kind: ZodLiteral<"address-range">;
start: ZodString;
},
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"artifact-path">; path: ZodString },
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"file-offset">; offset: ZodNumber },
$strip,
>,
ZodObject<
{
end: ZodNumber;
kind: ZodLiteral<"file-offset-range">;
start: ZodNumber;
},
$strip,
>,
],
"kind",
>,
>;
normalized_result: ZodObject<
{
format: ZodEnum<{ asar: "asar"; directory: "directory" }>;
graph: ZodObject<
{
coverage: ZodObject<
{
limits: ZodArray<(...)>;
omitted_count: ZodNullable<(...)>;
status: ZodEnum<(...)>;
truncated: ZodBoolean;
},
$strict,
>;
edges: ZodArray<
ZodObject<
{
edge_id: ...;
evidence: ...;
identifier_strategy: ...;
properties: ...;
relation: ...;
source_node_id: ...;
target_node_id: ...;
},
$strict,
>,
>;
graph_id: ZodString;
limitations: ZodArray<ZodString>;
nodes: ZodArray<
ZodObject<
{ identity: ...; kind: ...; node_id: ...; observations: ... },
$strict,
>,
>;
root_node_ids: ZodArray<ZodString>;
schema: ZodLiteral<"JavaScriptApplicationGraph">;
schema_version: ZodLiteral<1>;
},
$strict,
>;
input_path: ZodString;
inventory_graph_sha256: ZodString;
inventory_manifest_id: ZodString;
limitations: ZodArray<ZodString>;
root_artifact_sha256: ZodString;
schema_version: ZodLiteral<1>;
statistics: ZodObject<
{
findings: ZodNumber;
invalid_utf8_files: ZodNumber;
limit_omitted_text_files: ZodNumber;
modules: ZodNumber;
nested_asar_containers: ZodNumber;
omitted_text_files: ZodNumber;
parse_failures: ZodNumber;
parsed_javascript_files: ZodNumber;
policy_filtered_text_files: ZodNumber;
relevant_files: ZodNumber;
text_bytes_read: ZodNumber;
text_files_selected: ZodNumber;
truncated_scopes: ZodNumber;
visited_ast_nodes: ZodNumber;
},
$strict,
>;
summary: ZodObject<
{
browser_windows: ZodNumber;
context_bridge_apis: ZodNumber;
explicit_web_preferences: ZodNumber;
exposed_api_members: ZodNumber;
ipc: ZodObject<
{
ambiguous_renderer_transmissions: ZodNumber;
dynamic_channel_operations: ZodNumber;
literal_channels: ZodNumber;
main_handlers: ZodNumber;
operations: ZodNumber;
paired_renderer_transmissions: ZodNumber;
renderer_listeners: ZodNumber;
renderer_transmissions: ZodNumber;
unpaired_literal_renderer_transmissions: ZodNumber;
},
$strict,
>;
native_addon_bindings: ZodNumber;
preload_entrypoints: ZodNumber;
resolved_native_addon_bindings: ZodNumber;
resolved_utility_entrypoints: ZodNumber;
sender_validation_observations: ZodNumber;
utility_processes: ZodNumber;
},
$strict,
>;
},
$strict,
>;
operation: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
predicate_type: ZodString;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodNullable<ZodString> },
$strip,
>;
raw_result: ZodNullable<ZodJSONSchema>;
schema_version: ZodLiteral<2>;
subject: ZodNullable<
ZodObject<
{
architecture: ZodNullable<
ZodEnum<
{ arm: "arm"; arm64: "arm64"; x86: "x86"; x86_64: "x86_64" },
>,
>;
digest: ZodObject<{ sha256: ZodString }, $strip>;
format: ZodEnum<
{
"analysis-database": "analysis-database";
apk: "apk";
asar: "asar";
directory: "directory";
dmg: "dmg";
elf: "elf";
entitlements: "entitlements";
file: "file";
hopper: "hopper";
ipa: "ipa";
javascript: "javascript";
"javascript-bundle": "javascript-bundle";
"mach-o": "mach-o";
"mach-o-universal": "mach-o-universal";
pe: "pe";
pkg: "pkg";
plist: "plist";
"source-map": "source-map";
unknown: "unknown";
zip: "zip";
},
>;
local_path: ZodString;
name: ZodString;
},
$strip,
>,
>;
},
$strict,
>;
},
{
annotations: {
destructiveHint: false;
idempotentHint: true;
openWorldHint: false;
readOnlyHint: true;
};
description: "Reconcile verified static JavaScript application graphs with existing passive web or Electron CDP Evidence. 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.";
examples: readonly [
{
input: {
runtime_observations: (
| {
analysis_profile: {
digest: string;
parameters: Record<string, JSONType>;
provider: { id: string; name: string; version: string };
provider_profile_schema_version: number;
schema_version: 1;
};
authority: | "shipped-artifact"
| "controlled-replay"
| "historical-reference"
| "external-service"
| "analyst-inference";
confidence: "observed"
| "derived"
| "inferred";
environment:
| {
architecture: string;
id: string;
isolation: (...)
| (...)
| (...)
| (...);
platform: string;
}
| null;
evidence_id: string;
evidence_links: string[];
limitations: string[];
locations: (
| { address: ...; kind: ... }
| { end: ...; kind: ...; start: ... }
| { kind: ...; path: ... }
| { kind: ...; offset: ... }
| { end: ...; kind: ...; start: ... }
)[];
normalized_result: JSONType;
operation: string;
parameters: Record<string, JSONType>;
predicate_type: string;
provider: { id: string; name: string; version: string | null };
raw_result: JSONType;
schema_version: 2;
subject:
| {
architecture: (...)
| (...)
| (...)
| (...)
| (...);
digest: { sha256: ... };
format:
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...);
local_path: string;
name: string;
}
| null;
}
| {
authority: | "shipped-artifact"
| "controlled-replay"
| "historical-reference"
| "external-service"
| "analyst-inference";
confidence: "observed"
| "derived"
| "inferred";
environment:
| {
architecture: string;
id: string;
isolation: (...)
| (...)
| (...)
| (...);
platform: string;
}
| null;
evidence_id: string;
evidence_links: string[];
limitations: string[];
locations: (
| { address: ...; kind: ... }
| { end: ...; kind: ...; start: ... }
| { kind: ...; path: ... }
| { kind: ...; offset: ... }
| { end: ...; kind: ...; start: ... }
)[];
normalized_result: JSONType;
operation: string;
parameters: Record<string, JSONType>;
predicate_type: string;
provider: { id: string; name: string; version: string | null };
raw_result: JSONType;
schema_version: 2;
subject:
| {
architecture: (...)
| (...)
| (...)
| (...)
| (...);
digest: { sha256: ... };
format:
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...)
| (...);
local_path: string;
name: string;
}
| null;
}
)[];
static_layers: {
analysis: | {
analysis_profile: {
digest: string;
parameters: Record<(...), (...)>;
provider: { id: ...; name: ...; version: ... };
provider_profile_schema_version: number;
schema_version: 1;
};
authority: | "shipped-artifact"
| "controlled-replay"
| "historical-reference"
| "external-service"
| "analyst-inference";
confidence: "observed"
| "derived"
| "inferred";
environment:
| { architecture: ...; id: ...; isolation: ...; platform: ... }
| null;
evidence_id: string;
evidence_links: string[];
limitations: string[];
locations: ((...) | (...) | (...) | (...) | (...))[];
normalized_result: JSONType;
operation: string;
parameters: Record<string, JSONType>;
predicate_type: string;
provider: { id: string; name: string; version: (...) | (...) };
raw_result: JSONType;
schema_version: 2;
subject:
| {
architecture: ...;
digest: ...;
format: ...;
local_path: ...;
name: ...;
}
| null;
}
| {
authority: | "shipped-artifact"
| "controlled-replay"
| "historical-reference"
| "external-service"
| "analyst-inference";
confidence: "observed"
| "derived"
| "inferred";
environment:
| { architecture: ...; id: ...; isolation: ...; platform: ... }
| null;
evidence_id: string;
evidence_links: string[];
limitations: string[];
locations: ((...) | (...) | (...) | (...) | (...))[];
normalized_result: JSONType;
operation: string;
parameters: Record<string, JSONType>;
predicate_type: string;
provider: { id: string; name: string; version: (...) | (...) };
raw_result: JSONType;
schema_version: 2;
subject:
| {
architecture: ...;
digest: ...;
format: ...;
local_path: ...;
name: ...;
}
| null;
};
role: string;
}[];
};
title: "Reconcile one passive Electron capture";
},
];
inputSchema: ZodObject<
{
limits: ZodDefault<
ZodObject<
{
max_reconciliation_items: ZodDefault<ZodNumber>;
max_runtime_entities: ZodDefault<ZodNumber>;
max_static_load_states: ZodDefault<ZodNumber>;
},
$strict,
>,
>;
runtime_observations: ZodArray<
ZodObject<
{
analysis_profile: ZodOptional<
ZodObject<
{
digest: ZodString;
parameters: ZodRecord<(...), (...)>;
provider: ZodObject<(...), (...)>;
provider_profile_schema_version: ZodNumber;
schema_version: ZodLiteral<(...)>;
},
$strip,
>,
>;
authority: ZodEnum<
{
"analyst-inference": "analyst-inference";
"controlled-replay": "controlled-replay";
"external-service": "external-service";
"historical-reference": "historical-reference";
"shipped-artifact": "shipped-artifact";
},
>;
confidence: ZodEnum<
{
derived: "derived";
inferred: "inferred";
observed: "observed";
},
>;
environment: ZodNullable<
ZodObject<
{
architecture: ZodString;
id: ZodString;
isolation: ZodEnum<(...)>;
platform: ZodString;
},
$strip,
>,
>;
evidence_id: ZodString;
evidence_links: ZodArray<ZodString>;
limitations: ZodArray<ZodString>;
locations: ZodArray<
ZodDiscriminatedUnion<
[
ZodObject<(...), (...)>,
ZodObject<(...), (...)>,
ZodObject<(...), (...)>,
ZodObject<(...), (...)>,
ZodObject<(...), (...)>,
],
"kind",
>,
>;
normalized_result: ZodJSONSchema;
operation: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
predicate_type: ZodString;
provider: ZodObject<
{
id: ZodString;
name: ZodString;
version: ZodNullable<ZodString>;
},
$strip,
>;
raw_result: ZodNullable<ZodJSONSchema>;
schema_version: ZodLiteral<2>;
subject: ZodNullable<
ZodObject<
{
architecture: ZodNullable<(...)>;
digest: ZodObject<(...), (...)>;
format: ZodEnum<(...)>;
local_path: ZodString;
name: ZodString;
},
$strip,
>,
>;
},
$strict,
>,
>;
static_layers: ZodArray<
ZodObject<
{
analysis: ZodObject<
{
analysis_profile: ZodOptional<ZodObject<(...), (...)>>;
authority: ZodEnum<
{
"analyst-inference": ...;
"controlled-replay": ...;
"external-service": ...;
"historical-reference": ...;
"shipped-artifact": ...;
},
>;
confidence: ZodEnum<{ derived: ...; inferred: ...; observed: ... }>;
environment: ZodNullable<ZodObject<(...), (...)>>;
evidence_id: ZodString;
evidence_links: ZodArray<ZodString>;
limitations: ZodArray<ZodString>;
locations: ZodArray<ZodDiscriminatedUnion<(...), (...)>>;
normalized_result: ZodJSONSchema;
operation: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
predicate_type: ZodString;
provider: ZodObject<{ id: ...; name: ...; version: ... }, $strip>;
raw_result: ZodNullable<ZodJSONSchema>;
schema_version: ZodLiteral<2>;
subject: ZodNullable<ZodObject<(...), (...)>>;
},
$strict,
>;
role: ZodEnum<
{ application: "application"; assets: "assets"; cache: "cache" },
>;
runtime_mappings: ZodDefault<
ZodArray<ZodDiscriminatedUnion<[(...), (...)], "kind">>,
>;
},
$strict,
>,
>;
},
$strict,
>;
kind: "electron-provider";
name: "reconcile_javascript_runtime";
outputSchema: ZodObject<
{
analysis_profile: ZodOptional<
ZodObject<
{
digest: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodString },
$strip,
>;
provider_profile_schema_version: ZodNumber;
schema_version: ZodLiteral<1>;
},
$strip,
>,
>;
authority: ZodEnum<
{
"analyst-inference": "analyst-inference";
"controlled-replay": "controlled-replay";
"external-service": "external-service";
"historical-reference": "historical-reference";
"shipped-artifact": "shipped-artifact";
},
>;
confidence: ZodEnum<
{ derived: "derived"; inferred: "inferred"; observed: "observed" },
>;
environment: ZodNullable<
ZodObject<
{
architecture: ZodString;
id: ZodString;
isolation: ZodEnum<
{
container: "container";
none: "none";
process: "process";
"virtual-machine": "virtual-machine";
},
>;
platform: ZodString;
},
$strip,
>,
>;
evidence_id: ZodString;
evidence_links: ZodArray<ZodString>;
limitations: ZodArray<ZodString>;
locations: ZodArray<
ZodDiscriminatedUnion<
[
ZodObject<
{ address: ZodString; kind: ZodLiteral<"address"> },
$strip,
>,
ZodObject<
{
end: ZodString;
kind: ZodLiteral<"address-range">;
start: ZodString;
},
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"artifact-path">; path: ZodString },
$strip,
>,
ZodObject<
{ kind: ZodLiteral<"file-offset">; offset: ZodNumber },
$strip,
>,
ZodObject<
{
end: ZodNumber;
kind: ZodLiteral<"file-offset-range">;
start: ZodNumber;
},
$strip,
>,
],
"kind",
>,
>;
normalized_result: ZodObject<
{
coverage: ZodObject<
{
omitted_graph_items: ZodNumber;
omitted_reconciliation_items: ZodNumber;
omitted_runtime_entities: ZodNumber;
omitted_static_load_states: ZodNumber;
status: ZodEnum<
{
"complete-within-inputs": "complete-within-inputs";
partial: "partial";
truncated: "truncated";
},
>;
truncated: ZodBoolean;
},
$strict,
>;
evidence_links: ZodArray<ZodString>;
graph: ZodObject<
{
coverage: ZodObject<
{
limits: ZodArray<(...)>;
omitted_count: ZodNullable<(...)>;
status: ZodEnum<(...)>;
truncated: ZodBoolean;
},
$strict,
>;
edges: ZodArray<
ZodObject<
{
edge_id: ...;
evidence: ...;
identifier_strategy: ...;
properties: ...;
relation: ...;
source_node_id: ...;
target_node_id: ...;
},
$strict,
>,
>;
graph_id: ZodString;
limitations: ZodArray<ZodString>;
nodes: ZodArray<
ZodObject<
{ identity: ...; kind: ...; node_id: ...; observations: ... },
$strict,
>,
>;
root_node_ids: ZodArray<ZodString>;
schema: ZodLiteral<"JavaScriptApplicationGraph">;
schema_version: ZodLiteral<1>;
},
$strict,
>;
limitations: ZodArray<ZodString>;
reconciliation_id: ZodString;
reconciliations: ZodArray<
ZodObject<
{
basis: ZodEnum<
{
"artifact-path": ...;
"content-and-location": ...;
"content-sha256": ...;
"module-source-sha256": ...;
none: ...;
"operator-file-mapping": ...;
"operator-url-mapping": ...;
},
>;
candidate_static_count: ZodNumber;
candidate_static_nodes: ZodArray<ZodObject<(...), (...)>>;
confidence: ZodEnum<
{ exact: ...; high: ...; low: ...; medium: ...; unknown: ... },
>;
entity_kind: ZodEnum<
{ frame: ...; script: ...; target: ...; worker: ... },
>;
reason: ZodEnum<
{
"ambiguous-static-candidates": ...;
"captured-content-disagrees-with-static-location": ...;
"content-and-location-match": ...;
"no-authorized-location-mapping": ...;
"no-static-content-match": ...;
"reconciliation-limit-reached": ...;
"runtime-frame-unattributed": ...;
"static-or-runtime-coverage-incomplete": ...;
"unique-content-match": ...;
"unique-location-match": ...;
},
>;
reconciliation_id: ZodString;
runtime_evidence_id: ZodString;
runtime_node_id: ZodString;
static_layer_id: ZodNullable<ZodString>;
static_node_id: ZodNullable<ZodString>;
status: ZodEnum<
{ ambiguous: ...; matched: ...; unknown: ...; unmatched: ... },
>;
},
$strict,
>,
>;
runtime_captures: ZodArray<
ZodObject<
{
capture_sha256: ZodString;
evidence_id: ZodString;
frames: ZodNumber;
kind: ZodEnum<{ browser: ...; electron: ... }>;
scripts: ZodNumber;
scripts_complete_within_scope: ZodBoolean;
target_key: ZodString;
target_location: ZodString;
target_node_id: ZodString;
workers: ZodNumber;
},
$strict,
>,
>;
schema_version: ZodLiteral<1>;
source_map_authority: ZodObject<
{
limitation: ZodString;
runtime_script_declarations: ZodNumber;
static_layers_with_read_approval: ZodNumber;
used_for_primary_matching: ZodLiteral<false>;
},
$strict,
>;
static_layers: ZodArray<
ZodObject<
{
evidence_id: ZodString;
format: ZodEnum<{ asar: ...; directory: ... }>;
graph_id: ZodString;
input_path: ZodString;
layer_id: ZodString;
role: ZodEnum<{ application: ...; assets: ...; cache: ... }>;
root_artifact_sha256: ZodString;
runtime_mappings: ZodArray<ZodDiscriminatedUnion<(...), (...)>>;
},
$strict,
>,
>;
static_load_states: ZodArray<
ZodObject<
{
kind: ZodEnum<
{
"javascript-asset": ...;
"javascript-chunk": ...;
"javascript-module": ...;
},
>;
reason: ZodEnum<
{
"containing-asset-was-loaded": ...;
"layer-outside-runtime-scope": ...;
"not-observed-in-bounded-capture": ...;
"runtime-script-correspondence": ...;
"static-or-runtime-coverage-incomplete": ...;
},
>;
runtime_node_ids: ZodArray<ZodString>;
static_layer_id: ZodString;
static_node_id: ZodString;
status: ZodEnum<
{
loaded: ...;
"not-observed-in-capture": ...;
"resident-in-loaded-asset": ...;
unknown: ...;
},
>;
},
$strict,
>,
>;
summary: ZodObject<
{
ambiguous: ZodNumber;
matched: ZodNumber;
runtime_frames: ZodNumber;
runtime_scripts: ZodNumber;
runtime_targets: ZodNumber;
runtime_workers: ZodNumber;
static_loaded: ZodNumber;
static_not_observed: ZodNumber;
static_resident: ZodNumber;
static_unknown: ZodNumber;
unknown: ZodNumber;
unmatched: ZodNumber;
},
$strict,
>;
},
$strict,
>;
operation: ZodString;
parameters: ZodRecord<ZodString, ZodJSONSchema>;
predicate_type: ZodString;
provider: ZodObject<
{ id: ZodString; name: ZodString; version: ZodNullable<ZodString> },
$strip,
>;
raw_result: ZodNullable<ZodJSONSchema>;
schema_version: ZodLiteral<2>;
subject: ZodNullable<
ZodObject<
{
architecture: ZodNullable<
ZodEnum<
{ arm: "arm"; arm64: "arm64"; x86: "x86"; x86_64: "x86_64" },
>,
>;
digest: ZodObject<{ sha256: ZodString }, $strip>;
format: ZodEnum<
{
"analysis-database": "analysis-database";
apk: "apk";
asar: "asar";
directory: "directory";
dmg: "dmg";
elf: "elf";
entitlements: "entitlements";
file: "file";
hopper: "hopper";
ipa: "ipa";
javascript: "javascript";
"javascript-bundle": "javascript-bundle";
"mach-o": "mach-o";
"mach-o-universal": "mach-o-universal";
pe: "pe";
pkg: "pkg";
plist: "plist";
"source-map": "source-map";
unknown: "unknown";
zip: "zip";
},
>;
local_path: ZodString;
name: ZodString;
},
$strip,
>,
>;
},
$strict,
>;
},
] = ...
Root-confined Electron file-page discovery and inspection contracts.