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

    Function parseInvestigationWorkspace

    • Parse a workspace and verify identities, revision digest, and references.

      Parameters

      • input: unknown

      Returns {
          bundle: {
              artifacts: {
                  architecture: "x86" | "x86_64" | "arm" | "arm64" | null;
                  digest: { sha256: string };
                  format:
                      | "unknown"
                      | "file"
                      | "directory"
                      | "javascript"
                      | "source-map"
                      | "plist"
                      | "entitlements"
                      | "dmg"
                      | "zip"
                      | "pkg"
                      | "asar"
                      | "javascript-bundle"
                      | "mach-o-universal"
                      | "mach-o"
                      | "elf"
                      | "pe"
                      | "hopper"
                      | "analysis-database"
                      | "ipa"
                      | "apk";
              }[];
              bundle_version: 2;
              captures: { evidence_id: string; predicate_type: string }[];
              environments: {
                  architecture: string;
                  id: string;
                  isolation: "process" | "none" | "container" | "virtual-machine";
                  platform: string;
              }[];
              providers: { id: string; name: string; version: string
              | null }[];
              records: (
                  | {
                      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: "process"
                              | "none"
                              | "container"
                              | "virtual-machine";
                              platform: string;
                          }
                          | null;
                      evidence_id: string;
                      evidence_links: string[];
                      limitations: string[];
                      locations: (
                          | { address: string; kind: "address" }
                          | { end: string; kind: "address-range"; start: string }
                          | { kind: "artifact-path"; path: string }
                          | { kind: "file-offset"; offset: number }
                          | { end: number; kind: "file-offset-range"; start: number }
                      )[];
                      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: "x86"
                              | "x86_64"
                              | "arm"
                              | "arm64"
                              | null;
                              digest: { sha256: string };
                              format:
                                  | "unknown"
                                  | "file"
                                  | "directory"
                                  | "javascript"
                                  | "source-map"
                                  | "plist"
                                  | "entitlements"
                                  | "dmg"
                                  | "zip"
                                  | "pkg"
                                  | "asar"
                                  | "javascript-bundle"
                                  | "mach-o-universal"
                                  | "mach-o"
                                  | "elf"
                                  | "pe"
                                  | "hopper"
                                  | "analysis-database"
                                  | "ipa"
                                  | "apk";
                              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: "process"
                              | "none"
                              | "container"
                              | "virtual-machine";
                              platform: string;
                          }
                          | null;
                      evidence_id: string;
                      evidence_links: string[];
                      limitations: string[];
                      locations: (
                          | { address: string; kind: "address" }
                          | { end: string; kind: "address-range"; start: string }
                          | { kind: "artifact-path"; path: string }
                          | { kind: "file-offset"; offset: number }
                          | { end: number; kind: "file-offset-range"; start: number }
                      )[];
                      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: "x86"
                              | "x86_64"
                              | "arm"
                              | "arm64"
                              | null;
                              digest: { sha256: string };
                              format:
                                  | "unknown"
                                  | "file"
                                  | "directory"
                                  | "javascript"
                                  | "source-map"
                                  | "plist"
                                  | "entitlements"
                                  | "dmg"
                                  | "zip"
                                  | "pkg"
                                  | "asar"
                                  | "javascript-bundle"
                                  | "mach-o-universal"
                                  | "mach-o"
                                  | "elf"
                                  | "pe"
                                  | "hopper"
                                  | "analysis-database"
                                  | "ipa"
                                  | "apk";
                              local_path: string;
                              name: string;
                          }
                          | null;
                  }
              )[];
              scenarios: {
                  authority: "controlled-replay";
                  evidence_id: string;
                  operation: string;
              }[];
              unknowns: {
                  contradicting_evidence_ids: string[];
                  domain: string;
                  mutation_evidence_ids: string[];
                  previous_revision_digest: string
                  | null;
                  question: string;
                  recommended_probes: { operation: string; rationale: string }[];
                  registry_version: 1;
                  relationships: {
                      type: "depends-on" | "related-to" | "contradicts";
                      unknown_id: string;
                  }[];
                  required_authority: | "shipped-artifact"
                  | "controlled-replay"
                  | "historical-reference"
                  | "external-service"
                  | "analyst-inference"
                  | null;
                  required_confidence: "observed"
                  | "derived"
                  | "inferred";
                  required_environment:
                      | {
                          architecture: string
                          | null;
                          id: string | null;
                          isolation: "process" | "none" | "container" | "virtual-machine" | null;
                          platform: string | null;
                      }
                      | null;
                  resolution: | {
                      disposition: "verified";
                      evidence_ids: string[];
                      rationale: string;
                  }
                  | {
                      disposition: "withdrawn"
                      | "out-of-scope";
                      evidence_ids: string[];
                      rationale: string;
                  }
                  | null;
                  revision: number;
                  revision_digest: string;
                  scope_digest: string
                  | null;
                  severity: "low" | "medium" | "high" | "critical";
                  status:
                      | "open"
                      | "investigating"
                      | "blocked"
                      | "contradicted"
                      | "resolved";
                  supporting_evidence_ids: string[];
                  unknown_id: string;
              }[];
          };
          name: string;
          previous_revision_digest: string
          | null;
          revision: number;
          revision_digest: string;
          runs: (
              | {
                  comparison_evidence_id: string
                  | null;
                  completed_stages: (
                      | "inventory_left"
                      | "inventory_right"
                      | "compare_artifacts"
                      | "find_changed_behavior"
                  )[];
                  integrity_continue_approved: boolean;
                  integrity_policy: "fail"
                  | "record-and-continue";
                  left: {
                      format:
                          | "unknown"
                          | "file"
                          | "directory"
                          | "javascript"
                          | "source-map"
                          | "plist"
                          | "entitlements"
                          | "dmg"
                          | "zip"
                          | "pkg"
                          | "asar"
                          | "javascript-bundle"
                          | "mach-o-universal"
                          | "mach-o"
                          | "elf"
                          | "pe"
                          | "hopper"
                          | "analysis-database"
                          | "ipa"
                          | "apk";
                      graph_sha256: string;
                      manifest_id: string;
                      root_sha256: string;
                  };
                  left_inventory_evidence_ids: string[];
                  limitations: string[];
                  max_integrity_mismatches: number;
                  options: {
                      change_limit: number;
                      max_compression_ratio: number;
                      max_depth: number;
                      max_entries: number;
                      max_entry_bytes: number;
                      max_path_bytes: number;
                      max_total_bytes: number;
                      page_size: number;
                  };
                  request_sha256: string;
                  result_evidence_id: string
                  | null;
                  right: {
                      format:
                          | "unknown"
                          | "file"
                          | "directory"
                          | "javascript"
                          | "source-map"
                          | "plist"
                          | "entitlements"
                          | "dmg"
                          | "zip"
                          | "pkg"
                          | "asar"
                          | "javascript-bundle"
                          | "mach-o-universal"
                          | "mach-o"
                          | "elf"
                          | "pe"
                          | "hopper"
                          | "analysis-database"
                          | "ipa"
                          | "apk";
                      graph_sha256: string;
                      manifest_id: string;
                      root_sha256: string;
                  };
                  right_inventory_evidence_ids: string[];
                  run_id: string;
                  schema_version: 1;
                  status: "complete"
                  | "running";
              }
              | {
                  comparison_evidence_id: string
                  | null;
                  completed_stages: (
                      | "inventory_left"
                      | "inventory_right"
                      | "compare_artifacts"
                      | "find_changed_behavior"
                  )[];
                  integrity_continue_approved: boolean;
                  integrity_policy: "fail"
                  | "record-and-continue";
                  left: {
                      format:
                          | "unknown"
                          | "file"
                          | "directory"
                          | "javascript"
                          | "source-map"
                          | "plist"
                          | "entitlements"
                          | "dmg"
                          | "zip"
                          | "pkg"
                          | "asar"
                          | "javascript-bundle"
                          | "mach-o-universal"
                          | "mach-o"
                          | "elf"
                          | "pe"
                          | "hopper"
                          | "analysis-database"
                          | "ipa"
                          | "apk";
                      graph_sha256: string;
                      manifest_id: string;
                      root_sha256: string;
                  };
                  left_inventory_evidence_ids: string[];
                  legacy_request_identity: true;
                  limitations: string[];
                  max_integrity_mismatches: number;
                  options: {
                      change_limit: number;
                      max_compression_ratio: number;
                      max_depth: number;
                      max_entries: number;
                      max_entry_bytes: number;
                      max_path_bytes: number;
                      max_total_bytes: number;
                      page_size: number;
                  };
                  request_sha256: string;
                  result_evidence_id: string
                  | null;
                  right: {
                      format:
                          | "unknown"
                          | "file"
                          | "directory"
                          | "javascript"
                          | "source-map"
                          | "plist"
                          | "entitlements"
                          | "dmg"
                          | "zip"
                          | "pkg"
                          | "asar"
                          | "javascript-bundle"
                          | "mach-o-universal"
                          | "mach-o"
                          | "elf"
                          | "pe"
                          | "hopper"
                          | "analysis-database"
                          | "ipa"
                          | "apk";
                      graph_sha256: string;
                      manifest_id: string;
                      root_sha256: string;
                  };
                  right_inventory_evidence_ids: string[];
                  run_id: string;
                  schema_version: 1;
                  status: "complete"
                  | "running";
              }
          )[];
          workspace_id: string;
          workspace_version: 1;
      }