rea-agents - v2.0.0
    Preparing search index...

    Function traceApplicationFeature

    • Trace a literal feature through a bounded, authority-preserving JAG.

      Returns {
          coverage: {
              frontier_node_ids: string[];
              omitted_edges: number;
              omitted_nodes: number;
              omitted_paths: number;
              omitted_seed_matches: number;
              scanned_nodes: number;
              source_graph_status: "unknown" | "unavailable" | "complete" | "partial";
              status: "truncated" | "partial" | "complete-within-source" | "no-match";
              total_seed_matches: number;
          };
          direction: "incoming"
          | "outgoing"
          | "both";
          evidence_links: string[];
          graph:
              | {
                  coverage: {
                      limits: {
                          name: string;
                          unit: | "bytes"
                          | "other"
                          | "items"
                          | "depth"
                          | "milliseconds"
                          | "characters"
                          | "instructions";
                          value: number;
                      }[];
                      omitted_count: number
                      | null;
                      status: "unknown" | "unavailable" | "complete" | "partial";
                      truncated: boolean;
                  };
                  edges: {
                      edge_id: string;
                      evidence: {
                          artifact: | { artifact_id: string; available: true; sha256: string }
                          | {
                              available: false;
                              detail: string;
                              reason:
                                  | "unknown"
                                  | "truncated"
                                  | "unresolved"
                                  | "not-applicable"
                                  | "not-observed"
                                  | "not-approved"
                                  | "provider-unavailable";
                          };
                          authority: | "unknown"
                          | "controlled-replay"
                          | "historical-reference"
                          | "artifact-bytes"
                          | "ast-static-analysis"
                          | "static-relationship-inference"
                          | "passive-cdp-runtime"
                          | "cross-layer-reconciliation"
                          | "cross-version-comparison"
                          | "native-analysis-provider"
                          | "managed-static-analysis"
                          | "user-assertion";
                          confidence: "unknown"
                          | "exact"
                          | "low"
                          | "medium"
                          | "high";
                          coverage: {
                              limits: {
                                  name: string;
                                  unit:
                                      | "bytes"
                                      | "other"
                                      | "items"
                                      | "depth"
                                      | "milliseconds"
                                      | "characters"
                                      | "instructions";
                                  value: number;
                              }[];
                              omitted_count: number
                              | null;
                              status: "unknown" | "unavailable" | "complete" | "partial";
                              truncated: boolean;
                          };
                          evidence_ids: string[];
                          extractor: {
                              executable_sha256: string
                              | null;
                              name: string;
                              operation: string;
                              version: string;
                          };
                          limitations: string[];
                          location: | {
                              available: false;
                              detail: string;
                              reason: | "unknown"
                              | "truncated"
                              | "unresolved"
                              | "not-applicable"
                              | "not-observed"
                              | "not-approved"
                              | "provider-unavailable";
                          }
                          | {
                              available: true;
                              value: | {
                                  end: { column: ...; line: ... };
                                  kind: "source-range";
                                  source: string;
                                  start: { column: ...; line: ... };
                              }
                              | { end: number; kind: "file-offset-range"; start: number }
                              | { kind: "artifact-path"; path: string }
                              | { kind: "url"; url: string }
                              | {
                                  capture_sha256: string;
                                  frame_key: (...) | (...);
                                  kind: "runtime";
                                  script_key: (...) | (...);
                                  target_key: string;
                              }
                              | { address: string; kind: "native-address"; symbol: (...)
                              | (...) }
                              | {
                                  export_path: string;
                                  kind: "package-export";
                                  package_name: string;
                              };
                          };
                          state: "unknown"
                          | "observed"
                          | "inferred"
                          | "unavailable";
                      };
                      identifier_strategy: {
                          stability: "relationship-exact";
                          strategy: "semantic-content-sha256";
                      };
                      properties: Record<string, JSONType>;
                      relation:
                          | "contains"
                          | "loads"
                          | "calls"
                          | "imports"
                          | "maps_to"
                          | "exposes"
                          | "sends"
                          | "invokes"
                          | "handles"
                          | "persists_to"
                          | "observed_as"
                          | "changed_from";
                      source_node_id: string;
                      target_node_id: string;
                  }[];
                  graph_id: string;
                  limitations: string[];
                  nodes: {
                      identity: | {
                          sha256: string;
                          stability: "global-exact";
                          strategy: "content-digest";
                      }
                      | {
                          original_source: string;
                          source_map_sha256: string;
                          source_sha256: string
                          | null;
                          stability: "source-map-exact";
                          strategy: "source-map-original";
                      }
                      | {
                          artifact_sha256: string;
                          path: string;
                          stability: "artifact-version";
                          strategy: "canonical-path";
                      }
                      | {
                          algorithm: string;
                          basis: (
                              | "imports"
                              | "exports"
                              | "syntax-tree"
                              | "control-flow"
                              | "literals"
                              | "api-usage"
                          )[];
                          fingerprint_sha256: string;
                          stability: "cross-version-inference";
                          strategy: "structural-fingerprint";
                      }
                      | {
                          artifact_sha256: string;
                          key: string;
                          namespace: string;
                          stability: "artifact-version";
                          strategy: "artifact-local-key";
                      }
                      | {
                          capture_sha256: string;
                          runtime_key: string;
                          stability: "capture-only";
                          strategy: "runtime-instance";
                      }
                      | {
                          observation_sha256: string;
                          scope: string;
                          stability: "observation-only";
                          strategy: "observation-fingerprint";
                      };
                      kind: | "unknown"
                      | "target"
                      | "native-addon"
                      | "source-map"
                      | "artifact"
                      | "package"
                      | "installer"
                      | "asar-entry"
                      | "electron-main"
                      | "electron-preload"
                      | "electron-renderer"
                      | "electron-utility"
                      | "javascript-asset"
                      | "javascript-chunk"
                      | "javascript-module"
                      | "source-module"
                      | "browser-window"
                      | "frame"
                      | "context-bridge-api"
                      | "ipc-channel"
                      | "ipc-handler"
                      | "worker"
                      | "service-worker"
                      | "endpoint"
                      | "storage"
                      | "native-export"
                      | "managed-assembly"
                      | "managed-module"
                      | "managed-type"
                      | "managed-method"
                      | "managed-field"
                      | "managed-pinvoke-import"
                      | "managed-native-implementation"
                      | "runtime-script-instance";
                      node_id: string;
                      observations: {
                          evidence: {
                              artifact: | {
                                  artifact_id: string;
                                  available: true;
                                  sha256: string;
                              }
                              | {
                                  available: false;
                                  detail: string;
                                  reason: (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...);
                              };
                              authority: | "unknown"
                              | "controlled-replay"
                              | "historical-reference"
                              | "artifact-bytes"
                              | "ast-static-analysis"
                              | "static-relationship-inference"
                              | "passive-cdp-runtime"
                              | "cross-layer-reconciliation"
                              | "cross-version-comparison"
                              | "native-analysis-provider"
                              | "managed-static-analysis"
                              | "user-assertion";
                              confidence: "unknown"
                              | "exact"
                              | "low"
                              | "medium"
                              | "high";
                              coverage: {
                                  limits: { name: ...; unit: ...; value: ... }[];
                                  omitted_count: number | null;
                                  status: "unknown" | "unavailable" | "complete" | "partial";
                                  truncated: boolean;
                              };
                              evidence_ids: string[];
                              extractor: {
                                  executable_sha256: string
                                  | null;
                                  name: string;
                                  operation: string;
                                  version: string;
                              };
                              limitations: string[];
                              location: | {
                                  available: false;
                                  detail: string;
                                  reason: (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...);
                              }
                              | {
                                  available: true;
                                  value: (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...)
                                  | (...);
                              };
                              state: "unknown"
                              | "observed"
                              | "inferred"
                              | "unavailable";
                          };
                          identifier_strategy: {
                              stability: "observation-exact";
                              strategy: "semantic-content-sha256";
                          };
                          label: string
                          | null;
                          observation_id: string;
                          properties: Record<string, JSONType>;
                      }[];
                  }[];
                  root_node_ids: string[];
                  schema: "JavaScriptApplicationGraph";
                  schema_version: 1;
              }
              | null;
          limitations: string[];
          native_handoffs: {
              artifact_path: string
              | null;
              artifact_sha256: string;
              evidence_ids: string[];
              export_node_ids: string[];
              native_node_id: string;
              providers: { id: string; name: string; version: string | null }[];
              recommended_tools: (
                  | "open_binary"
                  | "binary_overview"
                  | "analyze_function"
                  | "search_procedures"
                  | "xrefs"
              )[];
              requested_exports: string[];
              status: "evidence-linked"
              | "requires-provider-analysis";
          }[];
          paths: {
              authorities: string[];
              contains_inference: boolean;
              edge_ids: string[];
              end_kind: string;
              end_node_id: string;
              node_ids: string[];
              path_id: string;
              start_node_id: string;
          }[];
          schema_version: 1;
          seed: {
              case_sensitive: boolean;
              kind: | "string"
              | "module"
              | "native-export"
              | "route"
              | "node-id"
              | "api"
              | "channel";
              match: "exact"
              | "contains"
              | null;
              value: string;
          };
          seed_matches: {
              basis: "identity"
              | "label"
              | "node-id"
              | "property";
              field: string;
              kind: string;
              node_id: string;
          }[];
          source_evidence_id: string;
          source_graph_id: string;
          summary: {
              inferred_facts: number;
              matched_seeds: number;
              native_handoffs: number;
              observed_facts: number;
              terminal_paths: number;
              traced_edges: number;
              traced_nodes: number;
              unavailable_facts: number;
              unknown_facts: number;
          };
          trace_id: string;
      }