diff --git a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequest.html b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequest.html index 89de45da1..51b2f155a 100644 --- a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequest.html +++ b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequest.html @@ -25,7 +25,7 @@
  • Optionallookup: EvidenceLookup

    • Returns Result<
        {
            left: {
                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;
            };
            left_native_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: "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;
            }[];
            limits: {
                max_candidate_nodes: number;
                max_comparison_items: number;
                max_graph_edges: number;
                max_graph_nodes: number;
            };
            right: {
                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;
            };
            right_native_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: "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;
            }[];
            unknown_registry_approved?: true;
        },
        AnalysisError,
    >

    +
  • Defined in src/application/ApplicationWorkflowEvidenceResolver.ts:90
    • diff --git a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequestValidated.html b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequestValidated.html index cfeefe088..d335dc3b8 100644 --- a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequestValidated.html +++ b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareApplicationVersionsRequestValidated.html @@ -25,7 +25,7 @@
  • Optionallookup: EvidenceLookup

    • Returns Result<
        {
            left: {
                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;
            };
            left_native_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: "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;
            }[];
            limits: {
                max_candidate_nodes: number;
                max_comparison_items: number;
                max_graph_edges: number;
                max_graph_nodes: number;
            };
            right: {
                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;
            };
            right_native_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: "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;
            }[];
            unknown_registry_approved?: true;
        },
        AnalysisError,
    >

    +
  • Defined in src/application/ApplicationWorkflowEvidenceResolver.ts:101
    • diff --git a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequest.html b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequest.html index fd3340041..21fd27cff 100644 --- a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequest.html +++ b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequest.html @@ -25,7 +25,7 @@
  • Optionallookup: EvidenceLookup

    • Returns Result<
        {
            left: {
                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;
            };
            left_export_name: string;
            left_module_path: string;
            limits: {
                max_candidate_exports: number;
                max_changes: number;
                max_return_variants: number;
            };
            right: {
                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;
            };
            right_export_name: string;
            right_module_path: string;
            unknown_registry_approved?: true;
        },
        AnalysisError,
    >

    +
  • Defined in src/application/ApplicationWorkflowEvidenceResolver.ts:142
    • diff --git a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequestValidated.html b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequestValidated.html index 8dd46ee35..4ba2c059e 100644 --- a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequestValidated.html +++ b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveCompareJavaScriptExportShapesRequestValidated.html @@ -25,7 +25,7 @@
  • Optionallookup: EvidenceLookup

    • Returns Result<
        {
            left: {
                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;
            };
            left_export_name: string;
            left_module_path: string;
            limits: {
                max_candidate_exports: number;
                max_changes: number;
                max_return_variants: number;
            };
            right: {
                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;
            };
            right_export_name: string;
            right_module_path: string;
            unknown_registry_approved?: true;
        },
        AnalysisError,
    >

    +
  • Defined in src/application/ApplicationWorkflowEvidenceResolver.ts:153
    • diff --git a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequest.html b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequest.html index b65698c31..c481ce2c2 100644 --- a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequest.html +++ b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequest.html @@ -25,7 +25,7 @@
  • Optionallookup: EvidenceLookup

    • Returns Result<
        {
            application: {
                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;
            };
            direction: "incoming"
            | "outgoing"
            | "both";
            limits: {
                max_depth: number;
                max_edges: number;
                max_nodes: number;
                max_paths: number;
                max_seed_matches: number;
            };
            native_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: "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;
            }[];
            seed: {
                case_sensitive: boolean;
                kind: | "string"
                | "module"
                | "native-export"
                | "node-id"
                | "route"
                | "api"
                | "channel";
                match: "exact"
                | "contains"
                | null;
                value: string;
            };
        },
        AnalysisError,
    >

    +
  • Defined in src/application/ApplicationWorkflowEvidenceResolver.ts:45
    • diff --git a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequestValidated.html b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequestValidated.html index a091f2cb2..c543ad393 100644 --- a/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequestValidated.html +++ b/docs/api/functions/application_ApplicationWorkflowEvidenceResolver.resolveTraceApplicationFeatureRequestValidated.html @@ -25,7 +25,7 @@
  • Optionallookup: EvidenceLookup

    • Returns Result<
        {
            application: {
                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;
            };
            direction: "incoming"
            | "outgoing"
            | "both";
            limits: {
                max_depth: number;
                max_edges: number;
                max_nodes: number;
                max_paths: number;
                max_seed_matches: number;
            };
            native_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: "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;
            }[];
            seed: {
                case_sensitive: boolean;
                kind: | "string"
                | "module"
                | "native-export"
                | "node-id"
                | "route"
                | "api"
                | "channel";
                match: "exact"
                | "contains"
                | null;
                value: string;
            };
        },
        AnalysisError,
    >

    +
  • Defined in src/application/ApplicationWorkflowEvidenceResolver.ts:56
    • diff --git a/docs/api/functions/application_DirectAnalysisStatus.runCapabilityStatus.html b/docs/api/functions/application_DirectAnalysisStatus.runCapabilityStatus.html index 8635eb505..0f8697021 100644 --- a/docs/api/functions/application_DirectAnalysisStatus.runCapabilityStatus.html +++ b/docs/api/functions/application_DirectAnalysisStatus.runCapabilityStatus.html @@ -25,7 +25,7 @@
  • detail: "summary" | "full" = "summary"

    • Returns Promise<JSONType>

    +
  • Defined in src/application/DirectAnalysisStatus.ts:56
    • diff --git a/docs/api/functions/application_DirectAnalysisStatus.runProviderStatus.html b/docs/api/functions/application_DirectAnalysisStatus.runProviderStatus.html index e36df5d92..de9f3fcd0 100644 --- a/docs/api/functions/application_DirectAnalysisStatus.runProviderStatus.html +++ b/docs/api/functions/application_DirectAnalysisStatus.runProviderStatus.html @@ -25,7 +25,7 @@
  • detail: "summary" | "full" = "summary"

    • Returns Promise<JSONType>

    +
  • Defined in src/application/DirectAnalysisStatus.ts:30
    • diff --git a/docs/api/functions/application_DoctorProjection.projectDoctorReport.html b/docs/api/functions/application_DoctorProjection.projectDoctorReport.html index cbf6f27ad..1bca733d2 100644 --- a/docs/api/functions/application_DoctorProjection.projectDoctorReport.html +++ b/docs/api/functions/application_DoctorProjection.projectDoctorReport.html @@ -25,7 +25,7 @@
  • detail: "summary" | "full"

    • Returns
        | DoctorReport
        | {
            environment_healthy: boolean;
            failed_scope_checks: {
                classification: | "unsupported_host"
                | "healthy"
                | "missing_dependency"
                | "missing_analysis_engine"
                | "config_drift";
                detail?: string;
                name: string;
                remediation?: string;
            }[];
            healthy: boolean;
            hopper_path?: string;
            identity: | {
                catalog: {
                    counts: {
                        cli_commands: number;
                        mcp_prompts: number;
                        mcp_resource_templates: 9;
                        mcp_resources: 2;
                        mcp_tools: number;
                    };
                    digests: {
                        combined_sha256: string;
                        prompts_sha256: string;
                        resources_sha256: string;
                        tools_sha256: string;
                    };
                };
                cli_package_version: string;
                expected_skill_version: string;
                installations: {
                    paths: readonly string[];
                    state: "unknown"
                    | "single"
                    | "multiple";
                };
                registrations: readonly ClientRegistrationStatus[];
                skill: {
                    installed_catalog_digest: string
                    | null;
                    installed_tool_count: number | null;
                    installed_version: string | null;
                    remediation: string | null;
                    state: "missing" | "aligned" | "stale";
                };
            }
            | null;
            informational_drift_count: number;
            providers: {
                available: boolean;
                configured: boolean;
                failed_checks: {
                    classification: | "unsupported_host"
                    | "healthy"
                    | "missing_dependency"
                    | "missing_analysis_engine"
                    | "config_drift";
                    detail?: string;
                    name: string;
                    remediation?: string;
                }[];
                id: string;
                provider_version: string
                | null;
            }[];
            scope: DoctorScopeReport;
        }

    +
  • Defined in src/application/DoctorProjection.ts:4
    • diff --git a/docs/api/functions/application_DoctorScope.normalizeDoctorScope.html b/docs/api/functions/application_DoctorScope.normalizeDoctorScope.html index b66fb6c07..c72d56a84 100644 --- a/docs/api/functions/application_DoctorScope.normalizeDoctorScope.html +++ b/docs/api/functions/application_DoctorScope.normalizeDoctorScope.html @@ -25,7 +25,7 @@
  • target: string | undefined

    • Returns DoctorScopeReport

    +
  • Defined in src/application/DoctorScope.ts:33
    • diff --git a/docs/api/functions/application_DoctorScope.scopeDoctorChecks.html b/docs/api/functions/application_DoctorScope.scopeDoctorChecks.html index 693939f8b..8f8ad030a 100644 --- a/docs/api/functions/application_DoctorScope.scopeDoctorChecks.html +++ b/docs/api/functions/application_DoctorScope.scopeDoctorChecks.html @@ -24,7 +24,7 @@
  • input: DoctorScopeInput

    • Returns {
        healthy: boolean;
        informationalChecks: readonly DoctorCheck[];
        scopeChecks: readonly DoctorCheck[];
    }

    +
  • Defined in src/application/DoctorScope.ts:45
    • diff --git a/docs/api/functions/application_EvidenceReferenceResolver.resolveEvidenceReferences.html b/docs/api/functions/application_EvidenceReferenceResolver.resolveEvidenceReferences.html index c4290681a..df01468e5 100644 --- a/docs/api/functions/application_EvidenceReferenceResolver.resolveEvidenceReferences.html +++ b/docs/api/functions/application_EvidenceReferenceResolver.resolveEvidenceReferences.html @@ -26,7 +26,7 @@
  • Optionalexpected: readonly EvidenceSemanticIdentity[]

    • Returns Result<
        (
            | {
                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;
            }
        )[],
        EvidenceReferenceError,
    >

    +
  • Defined in src/application/EvidenceReferenceResolver.ts:15
    • diff --git a/docs/api/functions/application_JavaScriptReturnShapeProjection.projectJavaScriptExportReturnShapes.html b/docs/api/functions/application_JavaScriptReturnShapeProjection.projectJavaScriptExportReturnShapes.html index 47b78bdb1..0f7aef13e 100644 --- a/docs/api/functions/application_JavaScriptReturnShapeProjection.projectJavaScriptExportReturnShapes.html +++ b/docs/api/functions/application_JavaScriptReturnShapeProjection.projectJavaScriptExportReturnShapes.html @@ -24,7 +24,7 @@
  • input: {
        baseCoverage: {
            limits: {
                name: string;
                unit:
                    | "other"
                    | "items"
                    | "bytes"
                    | "depth"
                    | "milliseconds"
                    | "characters"
                    | "instructions";
                value: number;
            }[];
            omitted_count: number
            | null;
            status: "unknown" | "unavailable" | "complete" | "partial";
            truncated: boolean;
        };
        ir: JavaScriptSemanticIr;
        link: JavaScriptSemanticModuleLink;
        modulePath: string;
    }

    • Returns JavaScriptReturnShapeProjection | null

    +
  • Defined in src/application/JavaScriptReturnShapeProjection.ts:24
    • diff --git a/docs/api/functions/browser_CdpEndpoint.cdpTargetWebSocket.html b/docs/api/functions/browser_CdpEndpoint.cdpTargetWebSocket.html index 0fad1cebf..20d0df7cd 100644 --- a/docs/api/functions/browser_CdpEndpoint.cdpTargetWebSocket.html +++ b/docs/api/functions/browser_CdpEndpoint.cdpTargetWebSocket.html @@ -26,7 +26,7 @@
  • operation: BrowserObservationOperation

    • Returns CdpWebSocketEndpoint

    +
  • Defined in src/browser/CdpEndpoint.ts:175
    • diff --git a/docs/api/functions/browser_CdpEndpoint.hasCdpTargetWebSocket.html b/docs/api/functions/browser_CdpEndpoint.hasCdpTargetWebSocket.html index e9d63fd36..82d17de7e 100644 --- a/docs/api/functions/browser_CdpEndpoint.hasCdpTargetWebSocket.html +++ b/docs/api/functions/browser_CdpEndpoint.hasCdpTargetWebSocket.html @@ -25,7 +25,7 @@
  • target: CdpEndpointTarget

    • Returns boolean

    +
  • Defined in src/browser/CdpEndpoint.ts:186
    • diff --git a/docs/api/functions/domain_javascriptExportShapeComparison.compareJavaScriptExportShapes.html b/docs/api/functions/domain_javascriptExportShapeComparison.compareJavaScriptExportShapes.html index 736c01b6f..6d4a4b4d8 100644 --- a/docs/api/functions/domain_javascriptExportShapeComparison.compareJavaScriptExportShapes.html +++ b/docs/api/functions/domain_javascriptExportShapeComparison.compareJavaScriptExportShapes.html @@ -24,7 +24,7 @@
  • input: JavaScriptExportShapeComparisonProjectionInput

    • Returns {
        changes: {
            change_id: string;
            discriminant:
                | { path: string; value: string
                | number
                | boolean
                | null }
                | null;
            evidence_links: [string, string];
            left:
                | { availability: "absent" }
                | { availability: "literal"; value: string | number | boolean | null }
                | { availability: "union"; values: (string | number | boolean | null)[] }
                | { availability: "unknown"; reason: string };
            left_source_range:
                | {
                    end: { column: number; line: number };
                    start: { column: number; line: number };
                }
                | null;
            limitations: string[];
            path: string;
            right: | { availability: "absent" }
            | { availability: "literal"; value: string | number | boolean | null }
            | { availability: "union"; values: (string | number | boolean | null)[] }
            | { availability: "unknown"; reason: string };
            right_source_range:
                | {
                    end: { column: number; line: number };
                    start: { column: number; line: number };
                }
                | null;
            status: "unknown"
            | "added"
            | "removed"
            | "changed";
        }[];
        comparison_id: string;
        coverage: {
            left_graph_status: "unknown"
            | "unavailable"
            | "complete"
            | "partial";
            left_omitted_fields: number;
            left_omitted_property_coverage: number;
            left_source_omitted_variants: number | null;
            omitted_candidates: number;
            omitted_changes: number;
            omitted_left_variants: number;
            omitted_right_variants: number;
            paired_variants: number;
            right_graph_status: "unknown" | "unavailable" | "complete" | "partial";
            right_omitted_fields: number;
            right_omitted_property_coverage: number;
            right_source_omitted_variants: number | null;
            status: "truncated" | "partial" | "complete-within-inputs";
            unpaired_left_variants: number;
            unpaired_right_variants: number;
        };
        evidence_links: [string, string];
        left: {
            candidates: {
                export_name: string;
                matches_requested_export: boolean;
                matches_requested_module: boolean;
                module_path: string;
                node_id: string;
            }[];
            evidence_id: string;
            graph_id: string;
            omitted_candidates: number;
            requested_export_name: string;
            requested_module_path: string;
            selected_node_id: string
            | null;
            status: "unavailable" | "missing" | "ambiguous" | "selected";
        };
        limitations: string[];
        right: {
            candidates: {
                export_name: string;
                matches_requested_export: boolean;
                matches_requested_module: boolean;
                module_path: string;
                node_id: string;
            }[];
            evidence_id: string;
            graph_id: string;
            omitted_candidates: number;
            requested_export_name: string;
            requested_module_path: string;
            selected_node_id: string
            | null;
            status: "unavailable" | "missing" | "ambiguous" | "selected";
        };
        runtime_validation: {
            automatically_started: false;
            recommended_tool: "run_controlled_replay";
            required_for: "runtime-semantics";
        };
        schema_version: 1;
        summary: {
            added: number;
            changed: number;
            removed: number;
            unknown: number;
        };
    }

    +
  • Defined in src/domain/javascriptExportShapeComparison.ts:32
    • diff --git a/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.canonicalExportShapeValue.html b/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.canonicalExportShapeValue.html index f4e7ea436..65cd7b271 100644 --- a/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.canonicalExportShapeValue.html +++ b/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.canonicalExportShapeValue.html @@ -24,7 +24,7 @@
  • value: unknown

    • Returns string

    +
  • Defined in src/domain/javascriptExportShapeComparisonIdentity.ts:6
    • diff --git a/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.digestExportShapeValue.html b/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.digestExportShapeValue.html index e77647c00..1abe4e866 100644 --- a/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.digestExportShapeValue.html +++ b/docs/api/functions/domain_javascriptExportShapeComparisonIdentity.digestExportShapeValue.html @@ -24,7 +24,7 @@
  • value: unknown

    • Returns string

    +
  • Defined in src/domain/javascriptExportShapeComparisonIdentity.ts:16
    • diff --git a/docs/api/functions/domain_javascriptExportShapeSelection.retainJavaScriptExportShapes.html b/docs/api/functions/domain_javascriptExportShapeSelection.retainJavaScriptExportShapes.html index b7a3111fd..c0e94c5cb 100644 --- a/docs/api/functions/domain_javascriptExportShapeSelection.retainJavaScriptExportShapes.html +++ b/docs/api/functions/domain_javascriptExportShapeSelection.retainJavaScriptExportShapes.html @@ -25,7 +25,7 @@
  • maximum: number

    • Returns RetainedJavaScriptExportShapes

    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:102
    • diff --git a/docs/api/functions/domain_javascriptExportShapeSelection.selectJavaScriptExport.html b/docs/api/functions/domain_javascriptExportShapeSelection.selectJavaScriptExport.html index 8690ed415..c471be415 100644 --- a/docs/api/functions/domain_javascriptExportShapeSelection.selectJavaScriptExport.html +++ b/docs/api/functions/domain_javascriptExportShapeSelection.selectJavaScriptExport.html @@ -25,7 +25,7 @@
  • maxCandidates: number

    • Returns SelectedJavaScriptExport

    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:45
    • diff --git a/docs/api/functions/domain_javascriptExportShapeVariants.buildJavaScriptExportShapeChanges.html b/docs/api/functions/domain_javascriptExportShapeVariants.buildJavaScriptExportShapeChanges.html index 476a43fe4..c7de3df4d 100644 --- a/docs/api/functions/domain_javascriptExportShapeVariants.buildJavaScriptExportShapeChanges.html +++ b/docs/api/functions/domain_javascriptExportShapeVariants.buildJavaScriptExportShapeChanges.html @@ -24,7 +24,7 @@
  • input: ChangeBuildInput

    • Returns {
        change_id: string;
        discriminant:
            | { path: string; value: string
            | number
            | boolean
            | null }
            | null;
        evidence_links: [string, string];
        left:
            | { availability: "absent" }
            | { availability: "literal"; value: string | number | boolean | null }
            | { availability: "union"; values: (string | number | boolean | null)[] }
            | { availability: "unknown"; reason: string };
        left_source_range:
            | {
                end: { column: number; line: number };
                start: { column: number; line: number };
            }
            | null;
        limitations: string[];
        path: string;
        right: | { availability: "absent" }
        | { availability: "literal"; value: string | number | boolean | null }
        | { availability: "union"; values: (string | number | boolean | null)[] }
        | { availability: "unknown"; reason: string };
        right_source_range:
            | {
                end: { column: number; line: number };
                start: { column: number; line: number };
            }
            | null;
        status: "unknown"
        | "added"
        | "removed"
        | "changed";
    }[]

    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:83
    • diff --git a/docs/api/functions/domain_javascriptExportShapeVariants.compareJavaScriptExportShapeChanges.html b/docs/api/functions/domain_javascriptExportShapeVariants.compareJavaScriptExportShapeChanges.html index 1654bfe90..8ab8a37c0 100644 --- a/docs/api/functions/domain_javascriptExportShapeVariants.compareJavaScriptExportShapeChanges.html +++ b/docs/api/functions/domain_javascriptExportShapeVariants.compareJavaScriptExportShapeChanges.html @@ -25,7 +25,7 @@
  • right: {
        change_id: string;
        discriminant:
            | { path: string; value: string
            | number
            | boolean
            | null }
            | null;
        evidence_links: [string, string];
        left:
            | { availability: "absent" }
            | { availability: "literal"; value: string | number | boolean | null }
            | { availability: "union"; values: (string | number | boolean | null)[] }
            | { availability: "unknown"; reason: string };
        left_source_range:
            | {
                end: { column: number; line: number };
                start: { column: number; line: number };
            }
            | null;
        limitations: string[];
        path: string;
        right: | { availability: "absent" }
        | { availability: "literal"; value: string | number | boolean | null }
        | { availability: "union"; values: (string | number | boolean | null)[] }
        | { availability: "unknown"; reason: string };
        right_source_range:
            | {
                end: { column: number; line: number };
                start: { column: number; line: number };
            }
            | null;
        status: "unknown"
        | "added"
        | "removed"
        | "changed";
    }

    • Returns number

    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:116
    • diff --git a/docs/api/functions/domain_javascriptExportShapeVariants.hasPartialJavaScriptExportPropertyCoverage.html b/docs/api/functions/domain_javascriptExportShapeVariants.hasPartialJavaScriptExportPropertyCoverage.html index 8a049861f..fecb32e36 100644 --- a/docs/api/functions/domain_javascriptExportShapeVariants.hasPartialJavaScriptExportPropertyCoverage.html +++ b/docs/api/functions/domain_javascriptExportShapeVariants.hasPartialJavaScriptExportPropertyCoverage.html @@ -24,7 +24,7 @@
  • shapes: readonly {
        fields: {
            path: string;
            reason: string | null;
            state: "unknown" | "union" | "literal";
            value:
                | string
                | number
                | boolean
                | (string | number | boolean | null)[]
                | null;
        }[];
        property_coverage: {
            omitted: number
            | null;
            path: string;
            status: "complete" | "partial";
        }[];
        source_range: {
            end: { column: number; line: number };
            start: { column: number; line: number };
        };
        value_status: | "object"
        | "unknown"
        | "array"
        | "union"
        | "literal"
        | "ambiguous"
        | "cycle"
        | "limit-reached";
    }[]

    • Returns boolean

    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:126
    • diff --git a/docs/api/functions/domain_javascriptExportShapeVariants.pairJavaScriptExportShapeVariants.html b/docs/api/functions/domain_javascriptExportShapeVariants.pairJavaScriptExportShapeVariants.html index 3247bcba3..f87f450f2 100644 --- a/docs/api/functions/domain_javascriptExportShapeVariants.pairJavaScriptExportShapeVariants.html +++ b/docs/api/functions/domain_javascriptExportShapeVariants.pairJavaScriptExportShapeVariants.html @@ -25,7 +25,7 @@
  • right: readonly {
        fields: {
            path: string;
            reason: string | null;
            state: "unknown" | "union" | "literal";
            value:
                | string
                | number
                | boolean
                | (string | number | boolean | null)[]
                | null;
        }[];
        property_coverage: {
            omitted: number
            | null;
            path: string;
            status: "complete" | "partial";
        }[];
        source_range: {
            end: { column: number; line: number };
            start: { column: number; line: number };
        };
        value_status: | "object"
        | "unknown"
        | "array"
        | "union"
        | "literal"
        | "ambiguous"
        | "cycle"
        | "limit-reached";
    }[]

    • Returns JavaScriptExportShapePairing

    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:36
    • diff --git a/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveCandidates.html b/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveCandidates.html index b92f6905e..ea2dcd8b9 100644 --- a/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveCandidates.html +++ b/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveCandidates.html @@ -24,7 +24,7 @@
  • value: JavaScriptSemanticValue

    • Returns readonly JavaScriptSemanticPrimitive[] | null

    +
  • Defined in src/domain/javascriptSemanticPrimitives.ts:40
    • diff --git a/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveSet.html b/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveSet.html index 1887c9998..e2a4e954a 100644 --- a/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveSet.html +++ b/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveSet.html @@ -25,7 +25,7 @@
  • state: JavaScriptSemanticAnalysisState

    • Returns JavaScriptSemanticValue

    +
  • Defined in src/domain/javascriptSemanticPrimitives.ts:15
    • diff --git a/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveValue.html b/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveValue.html index 844af7d7c..7028f5ebf 100644 --- a/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveValue.html +++ b/docs/api/functions/domain_javascriptSemanticPrimitives.semanticPrimitiveValue.html @@ -24,7 +24,7 @@
  • node: Node

    • Returns { found: true; value: JavaScriptSemanticPrimitive } | { found: false }

    +
  • Defined in src/domain/javascriptSemanticPrimitives.ts:50
    • diff --git a/docs/api/functions/domain_javascriptSemanticProvenance.reachSemanticValueLimit.html b/docs/api/functions/domain_javascriptSemanticProvenance.reachSemanticValueLimit.html index 975aba52c..c0a8eb445 100644 --- a/docs/api/functions/domain_javascriptSemanticProvenance.reachSemanticValueLimit.html +++ b/docs/api/functions/domain_javascriptSemanticProvenance.reachSemanticValueLimit.html @@ -25,7 +25,7 @@
  • limit: keyof JavaScriptSemanticLimits

    • Returns void

    +
  • Defined in src/domain/javascriptSemanticProvenance.ts:51
    • diff --git a/docs/api/functions/domain_javascriptSemanticProvenance.semanticLimitProvenance.html b/docs/api/functions/domain_javascriptSemanticProvenance.semanticLimitProvenance.html index b1bb4201d..bc580413d 100644 --- a/docs/api/functions/domain_javascriptSemanticProvenance.semanticLimitProvenance.html +++ b/docs/api/functions/domain_javascriptSemanticProvenance.semanticLimitProvenance.html @@ -25,7 +25,7 @@
  • limit: "maxValueDepth" | "maxUnionValues"

    • Returns JavaScriptBindingProvenance

    +
  • Defined in src/domain/javascriptSemanticProvenance.ts:42
    • diff --git a/docs/api/functions/domain_javascriptSemanticProvenance.semanticOriginsProvenance.html b/docs/api/functions/domain_javascriptSemanticProvenance.semanticOriginsProvenance.html index 52e4b9620..37f0e329e 100644 --- a/docs/api/functions/domain_javascriptSemanticProvenance.semanticOriginsProvenance.html +++ b/docs/api/functions/domain_javascriptSemanticProvenance.semanticOriginsProvenance.html @@ -25,7 +25,7 @@
  • state: JavaScriptSemanticAnalysisState

    • Returns JavaScriptBindingProvenance

    +
  • Defined in src/domain/javascriptSemanticProvenance.ts:17
    • diff --git a/docs/api/functions/domain_javascriptSemanticProvenance.semanticPrimitiveKey.html b/docs/api/functions/domain_javascriptSemanticProvenance.semanticPrimitiveKey.html index bb34f619d..026ca979f 100644 --- a/docs/api/functions/domain_javascriptSemanticProvenance.semanticPrimitiveKey.html +++ b/docs/api/functions/domain_javascriptSemanticProvenance.semanticPrimitiveKey.html @@ -24,7 +24,7 @@
  • value: JavaScriptSemanticPrimitive

    • Returns string

    +
  • Defined in src/domain/javascriptSemanticProvenance.ts:63
    • diff --git a/docs/api/functions/domain_javascriptSemanticProvenance.semanticProvenance.html b/docs/api/functions/domain_javascriptSemanticProvenance.semanticProvenance.html index 502a4e701..5216ffdbc 100644 --- a/docs/api/functions/domain_javascriptSemanticProvenance.semanticProvenance.html +++ b/docs/api/functions/domain_javascriptSemanticProvenance.semanticProvenance.html @@ -26,7 +26,7 @@
  • reason: string | null

    • Returns JavaScriptBindingProvenance

    +
  • Defined in src/domain/javascriptSemanticProvenance.ts:10
    • diff --git a/docs/api/functions/domain_javascriptSemanticProvenance.uniqueSemanticOrigins.html b/docs/api/functions/domain_javascriptSemanticProvenance.uniqueSemanticOrigins.html index e40255200..908b962a5 100644 --- a/docs/api/functions/domain_javascriptSemanticProvenance.uniqueSemanticOrigins.html +++ b/docs/api/functions/domain_javascriptSemanticProvenance.uniqueSemanticOrigins.html @@ -24,7 +24,7 @@
  • origins: readonly JavaScriptModuleOrigin[]

    • Returns JavaScriptModuleOrigin[]

    +
  • Defined in src/domain/javascriptSemanticProvenance.ts:30
    • diff --git a/docs/api/functions/domain_javascriptSemanticReturns.collectSemanticReturns.html b/docs/api/functions/domain_javascriptSemanticReturns.collectSemanticReturns.html index a316be08d..304483f2a 100644 --- a/docs/api/functions/domain_javascriptSemanticReturns.collectSemanticReturns.html +++ b/docs/api/functions/domain_javascriptSemanticReturns.collectSemanticReturns.html @@ -26,7 +26,7 @@
  • parserPartial: boolean

    • Returns JavaScriptSemanticCallable[]

    +
  • Defined in src/domain/javascriptSemanticReturns.ts:28
    • diff --git a/docs/api/functions/domain_javascriptSemanticReturns.flattenSemanticReturnValue.html b/docs/api/functions/domain_javascriptSemanticReturns.flattenSemanticReturnValue.html index fdf31d1a5..0453338f2 100644 --- a/docs/api/functions/domain_javascriptSemanticReturns.flattenSemanticReturnValue.html +++ b/docs/api/functions/domain_javascriptSemanticReturns.flattenSemanticReturnValue.html @@ -24,7 +24,7 @@
  • value: JavaScriptSemanticValue

    • Returns {
        fields: readonly {
            path: string;
            reason: string | null;
            state: "unknown" | "union" | "literal";
            value: unknown;
        }[];
        propertyCoverage: readonly {
            omitted: number
            | null;
            path: string;
            status: "complete" | "partial";
        }[];
    }

    +
  • Defined in src/domain/javascriptSemanticReturns.ts:191
    • diff --git a/docs/api/functions/domain_javascriptSemanticReturns.resolveSemanticModuleCallables.html b/docs/api/functions/domain_javascriptSemanticReturns.resolveSemanticModuleCallables.html index cb7ea9d1e..d5ac184fd 100644 --- a/docs/api/functions/domain_javascriptSemanticReturns.resolveSemanticModuleCallables.html +++ b/docs/api/functions/domain_javascriptSemanticReturns.resolveSemanticModuleCallables.html @@ -25,7 +25,7 @@
  • callables: readonly JavaScriptSemanticCallable[]

    • Returns JavaScriptSemanticModuleLink[]

    +
  • Defined in src/domain/javascriptSemanticReturns.ts:80
    • diff --git a/docs/api/functions/hopper_HopperProcessDiagnostic.hopperLauncherFailureDiagnostic.html b/docs/api/functions/hopper_HopperProcessDiagnostic.hopperLauncherFailureDiagnostic.html index fce80fce4..094ffb45f 100644 --- a/docs/api/functions/hopper_HopperProcessDiagnostic.hopperLauncherFailureDiagnostic.html +++ b/docs/api/functions/hopper_HopperProcessDiagnostic.hopperLauncherFailureDiagnostic.html @@ -24,7 +24,7 @@
  • event: {
        code: number | null;
        signal: Signals | null;
        snapshot: ProviderProcessSnapshot;
        type: "exit";
    }

    • Returns HopperStartupDiagnostic | undefined

    +
  • Defined in src/hopper/HopperProcessDiagnostic.ts:9
    • diff --git a/docs/api/functions/hopper_LinuxPrivateDisplayDiagnostic.parseLinuxPrivateDisplayDiagnostic.html b/docs/api/functions/hopper_LinuxPrivateDisplayDiagnostic.parseLinuxPrivateDisplayDiagnostic.html index 66ee88719..aeaf0e783 100644 --- a/docs/api/functions/hopper_LinuxPrivateDisplayDiagnostic.parseLinuxPrivateDisplayDiagnostic.html +++ b/docs/api/functions/hopper_LinuxPrivateDisplayDiagnostic.parseLinuxPrivateDisplayDiagnostic.html @@ -25,7 +25,7 @@
  • truncated: boolean

    • Returns LinuxPrivateDisplayDiagnosticParse

    +
  • Defined in src/hopper/LinuxPrivateDisplayDiagnostic.ts:56
    • diff --git a/docs/api/functions/hopper_LinuxPrivateDisplayProbe.selectLinuxPrivateDisplayStrategy.html b/docs/api/functions/hopper_LinuxPrivateDisplayProbe.selectLinuxPrivateDisplayStrategy.html index 07acd36fc..d10a21fc9 100644 --- a/docs/api/functions/hopper_LinuxPrivateDisplayProbe.selectLinuxPrivateDisplayStrategy.html +++ b/docs/api/functions/hopper_LinuxPrivateDisplayProbe.selectLinuxPrivateDisplayStrategy.html @@ -24,7 +24,7 @@
  • options: {
        helperPath: string;
        runProbe?: LinuxPrivateDisplayProbeRunner;
        signal?: AbortSignal;
        timeoutMs?: number;
    }

    • Returns Promise<LinuxPrivateDisplaySelection>

    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:59
    • diff --git a/docs/api/functions/server_registerApplicationTools_compareExportShapes.registerCompareJavaScriptExportShapesTool.html b/docs/api/functions/server_registerApplicationTools_compareExportShapes.registerCompareJavaScriptExportShapesTool.html index ad0222195..9f9cfadd9 100644 --- a/docs/api/functions/server_registerApplicationTools_compareExportShapes.registerCompareJavaScriptExportShapesTool.html +++ b/docs/api/functions/server_registerApplicationTools_compareExportShapes.registerCompareJavaScriptExportShapesTool.html @@ -25,7 +25,7 @@
  • options: ApplicationToolRegistration

    • Returns void

    +
  • Defined in src/server/registerApplicationTools/compareExportShapes.ts:18
    • diff --git a/docs/api/interfaces/application_DoctorScope.DoctorScopeReport.html b/docs/api/interfaces/application_DoctorScope.DoctorScopeReport.html index 91d662bea..91ea046cf 100644 --- a/docs/api/interfaces/application_DoctorScope.DoctorScopeReport.html +++ b/docs/api/interfaces/application_DoctorScope.DoctorScopeReport.html @@ -16,7 +16,7 @@
    interface DoctorScopeReport {
        clients: readonly string[];
        mode: "explicit" | "audit-wide";
        providers: readonly string[];
        skill: boolean;
        target: string | null;
    }
    +
  • Defined in src/application/DoctorScope.ts:10
    • @@ -37,27 +37,27 @@
    clients: readonly string[]
    +
  • Defined in src/application/DoctorScope.ts:12
    • mode: "explicit" | "audit-wide"
    +
  • Defined in src/application/DoctorScope.ts:11
    • providers: readonly string[]
    +
  • Defined in src/application/DoctorScope.ts:13
    • skill: boolean
    +
  • Defined in src/application/DoctorScope.ts:14
    • target: string | null
    +
  • Defined in src/application/DoctorScope.ts:15
    • diff --git a/docs/api/interfaces/application_EvidenceReferenceResolver.EvidenceSemanticIdentity.html b/docs/api/interfaces/application_EvidenceReferenceResolver.EvidenceSemanticIdentity.html index 184c8a605..d45502d47 100644 --- a/docs/api/interfaces/application_EvidenceReferenceResolver.EvidenceSemanticIdentity.html +++ b/docs/api/interfaces/application_EvidenceReferenceResolver.EvidenceSemanticIdentity.html @@ -16,7 +16,7 @@
    interface EvidenceSemanticIdentity {
        operation: string;
        predicate: string;
    }
    +
  • Defined in src/application/EvidenceReferenceResolver.ts:6
    • @@ -34,12 +34,12 @@
    operation: string
    +
  • Defined in src/application/EvidenceReferenceResolver.ts:7
    • predicate: string
    +
  • Defined in src/application/EvidenceReferenceResolver.ts:8
    • diff --git a/docs/api/interfaces/application_JavaScriptReturnShapeProjection.JavaScriptReturnShapeProjection.html b/docs/api/interfaces/application_JavaScriptReturnShapeProjection.JavaScriptReturnShapeProjection.html index c6e1d44ba..6abaf861b 100644 --- a/docs/api/interfaces/application_JavaScriptReturnShapeProjection.JavaScriptReturnShapeProjection.html +++ b/docs/api/interfaces/application_JavaScriptReturnShapeProjection.JavaScriptReturnShapeProjection.html @@ -13,7 +13,7 @@

    Interface JavaScriptReturnShapeProjection

    interface JavaScriptReturnShapeProjection {
        coverage: {
            limits: {
                name: string;
                unit:
                    | "other"
                    | "items"
                    | "bytes"
                    | "depth"
                    | "milliseconds"
                    | "characters"
                    | "instructions";
                value: number;
            }[];
            omitted_count: number
            | null;
            status: "unknown" | "unavailable" | "complete" | "partial";
            truncated: boolean;
        };
        limitations: readonly string[];
        properties: ReturnType<typeof jsonObjectSchema.parse>;
        range: JavaScriptSourceRange;
    }
    +
  • Defined in src/application/JavaScriptReturnShapeProjection.ts:16
    • @@ -33,22 +33,22 @@
    coverage: {
        limits: {
            name: string;
            unit:
                | "other"
                | "items"
                | "bytes"
                | "depth"
                | "milliseconds"
                | "characters"
                | "instructions";
            value: number;
        }[];
        omitted_count: number
        | null;
        status: "unknown" | "unavailable" | "complete" | "partial";
        truncated: boolean;
    }
    +
  • Defined in src/application/JavaScriptReturnShapeProjection.ts:19
    • limitations: readonly string[]
    +
  • Defined in src/application/JavaScriptReturnShapeProjection.ts:20
    • properties: ReturnType<typeof jsonObjectSchema.parse>
    +
  • Defined in src/application/JavaScriptReturnShapeProjection.ts:17
    • range: JavaScriptSourceRange
    +
  • Defined in src/application/JavaScriptReturnShapeProjection.ts:18
    • diff --git a/docs/api/interfaces/domain_javascriptExportShapeComparison.JavaScriptExportShapeComparisonProjectionInput.html b/docs/api/interfaces/domain_javascriptExportShapeComparison.JavaScriptExportShapeComparisonProjectionInput.html index 169c0ad81..b8c1370bf 100644 --- a/docs/api/interfaces/domain_javascriptExportShapeComparison.JavaScriptExportShapeComparisonProjectionInput.html +++ b/docs/api/interfaces/domain_javascriptExportShapeComparison.JavaScriptExportShapeComparisonProjectionInput.html @@ -16,7 +16,7 @@
    interface JavaScriptExportShapeComparisonProjectionInput {
        left: JavaScriptExportShapeSideInput;
        limits: {
            max_candidate_exports: number;
            max_changes: number;
            max_return_variants: number;
        };
        right: JavaScriptExportShapeSideInput;
    }
    +
  • Defined in src/domain/javascriptExportShapeComparison.ts:25
    • @@ -35,17 +35,17 @@
    left: JavaScriptExportShapeSideInput
    +
  • Defined in src/domain/javascriptExportShapeComparison.ts:26
    • limits: {
        max_candidate_exports: number;
        max_changes: number;
        max_return_variants: number;
    }
    +
  • Defined in src/domain/javascriptExportShapeComparison.ts:28
    • right: JavaScriptExportShapeSideInput
    +
  • Defined in src/domain/javascriptExportShapeComparison.ts:27
    • diff --git a/docs/api/interfaces/domain_javascriptExportShapeSelection.JavaScriptExportShapeSideInput.html b/docs/api/interfaces/domain_javascriptExportShapeSelection.JavaScriptExportShapeSideInput.html index 349cfe374..e8b43ca08 100644 --- a/docs/api/interfaces/domain_javascriptExportShapeSelection.JavaScriptExportShapeSideInput.html +++ b/docs/api/interfaces/domain_javascriptExportShapeSelection.JavaScriptExportShapeSideInput.html @@ -16,7 +16,7 @@
    interface JavaScriptExportShapeSideInput {
        evidenceId: string;
        exportName: string;
        graph: {
            coverage: {
                limits: {
                    name: string;
                    unit:
                        | "other"
                        | "items"
                        | "bytes"
                        | "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:
                                | "other"
                                | "items"
                                | "bytes"
                                | "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: number; line: number };
                            kind: "source-range";
                            source: string;
                            start: { column: number; line: number };
                        }
                        | { end: number; kind: "file-offset-range"; start: number }
                        | { kind: "artifact-path"; path: string }
                        | { kind: "url"; url: string }
                        | {
                            capture_sha256: string;
                            frame_key: string | null;
                            kind: "runtime";
                            script_key: string | null;
                            target_key: string;
                        }
                        | { address: string; kind: "native-address"; symbol: string
                        | null }
                        | { 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:
                                | "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:
                                    | "other"
                                    | "items"
                                    | "bytes"
                                    | "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: "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;
        };
        modulePath: string;
    }
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:16
    • @@ -36,22 +36,22 @@
    evidenceId: string
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:17
    • exportName: string
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:20
    • graph: {
        coverage: {
            limits: {
                name: string;
                unit:
                    | "other"
                    | "items"
                    | "bytes"
                    | "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:
                            | "other"
                            | "items"
                            | "bytes"
                            | "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: number; line: number };
                        kind: "source-range";
                        source: string;
                        start: { column: number; line: number };
                    }
                    | { end: number; kind: "file-offset-range"; start: number }
                    | { kind: "artifact-path"; path: string }
                    | { kind: "url"; url: string }
                    | {
                        capture_sha256: string;
                        frame_key: string | null;
                        kind: "runtime";
                        script_key: string | null;
                        target_key: string;
                    }
                    | { address: string; kind: "native-address"; symbol: string
                    | null }
                    | { 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:
                            | "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:
                                | "other"
                                | "items"
                                | "bytes"
                                | "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: "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;
    }
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:18
    • modulePath: string
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:19
    • diff --git a/docs/api/interfaces/domain_javascriptExportShapeSelection.RetainedJavaScriptExportShapes.html b/docs/api/interfaces/domain_javascriptExportShapeSelection.RetainedJavaScriptExportShapes.html index 3ba786e5d..1bf170d46 100644 --- a/docs/api/interfaces/domain_javascriptExportShapeSelection.RetainedJavaScriptExportShapes.html +++ b/docs/api/interfaces/domain_javascriptExportShapeSelection.RetainedJavaScriptExportShapes.html @@ -16,7 +16,7 @@
    interface RetainedJavaScriptExportShapes {
        omitted: number;
        shapes: readonly {
            fields: {
                path: string;
                reason: string | null;
                state: "unknown" | "union" | "literal";
                value:
                    | string
                    | number
                    | boolean
                    | (string | number | boolean | null)[]
                    | null;
            }[];
            property_coverage: {
                omitted: number
                | null;
                path: string;
                status: "complete" | "partial";
            }[];
            source_range: {
                end: { column: number; line: number };
                start: { column: number; line: number };
            };
            value_status: | "object"
            | "unknown"
            | "array"
            | "union"
            | "literal"
            | "ambiguous"
            | "cycle"
            | "limit-reached";
        }[];
    }
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:39
    • @@ -34,12 +34,12 @@
    omitted: number
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:41
    • shapes: readonly {
        fields: {
            path: string;
            reason: string | null;
            state: "unknown" | "union" | "literal";
            value:
                | string
                | number
                | boolean
                | (string | number | boolean | null)[]
                | null;
        }[];
        property_coverage: {
            omitted: number
            | null;
            path: string;
            status: "complete" | "partial";
        }[];
        source_range: {
            end: { column: number; line: number };
            start: { column: number; line: number };
        };
        value_status: | "object"
        | "unknown"
        | "array"
        | "union"
        | "literal"
        | "ambiguous"
        | "cycle"
        | "limit-reached";
    }[]
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:40
    • diff --git a/docs/api/interfaces/domain_javascriptExportShapeSelection.SelectedJavaScriptExport.html b/docs/api/interfaces/domain_javascriptExportShapeSelection.SelectedJavaScriptExport.html index d092e64b0..c75580974 100644 --- a/docs/api/interfaces/domain_javascriptExportShapeSelection.SelectedJavaScriptExport.html +++ b/docs/api/interfaces/domain_javascriptExportShapeSelection.SelectedJavaScriptExport.html @@ -16,7 +16,7 @@
    interface SelectedJavaScriptExport {
        limitations: readonly string[];
        observationComplete: boolean;
        projection:
            | {
                callable_id: string;
                callable_kind: "function"
                | "method"
                | "class";
                exported_name: string;
                module_path: string;
                return_shape_coverage: {
                    omitted_fields: number;
                    omitted_property_coverage: number;
                    omitted_return_sites: number | null;
                    projection_complete: boolean;
                    retained_return_sites: number;
                    status: "truncated" | "complete" | "partial";
                };
                semantic_role: "export-return-shapes";
                static_return_shapes: {
                    fields: {
                        path: string;
                        reason: string
                        | null;
                        state: "unknown" | "union" | "literal";
                        value:
                            | string
                            | number
                            | boolean
                            | (string | number | boolean | null)[]
                            | null;
                    }[];
                    property_coverage: {
                        omitted: number
                        | null;
                        path: string;
                        status: "complete" | "partial";
                    }[];
                    source_range: {
                        end: { column: number; line: number };
                        start: { column: number; line: number };
                    };
                    value_status: | "object"
                    | "unknown"
                    | "array"
                    | "union"
                    | "literal"
                    | "ambiguous"
                    | "cycle"
                    | "limit-reached";
                }[];
            }
            | null;
        selection: {
            candidates: {
                export_name: string;
                matches_requested_export: boolean;
                matches_requested_module: boolean;
                module_path: string;
                node_id: string;
            }[];
            evidence_id: string;
            graph_id: string;
            omitted_candidates: number;
            requested_export_name: string;
            requested_module_path: string;
            selected_node_id: string
            | null;
            status: "unavailable" | "missing" | "ambiguous" | "selected";
        };
    }
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:31
    • @@ -36,22 +36,22 @@
    limitations: readonly string[]
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:35
    • observationComplete: boolean
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:34
    • projection:
        | {
            callable_id: string;
            callable_kind: "function"
            | "method"
            | "class";
            exported_name: string;
            module_path: string;
            return_shape_coverage: {
                omitted_fields: number;
                omitted_property_coverage: number;
                omitted_return_sites: number | null;
                projection_complete: boolean;
                retained_return_sites: number;
                status: "truncated" | "complete" | "partial";
            };
            semantic_role: "export-return-shapes";
            static_return_shapes: {
                fields: {
                    path: string;
                    reason: string
                    | null;
                    state: "unknown" | "union" | "literal";
                    value:
                        | string
                        | number
                        | boolean
                        | (string | number | boolean | null)[]
                        | null;
                }[];
                property_coverage: {
                    omitted: number
                    | null;
                    path: string;
                    status: "complete" | "partial";
                }[];
                source_range: {
                    end: { column: number; line: number };
                    start: { column: number; line: number };
                };
                value_status: | "object"
                | "unknown"
                | "array"
                | "union"
                | "literal"
                | "ambiguous"
                | "cycle"
                | "limit-reached";
            }[];
        }
        | null
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:33
    • selection: {
        candidates: {
            export_name: string;
            matches_requested_export: boolean;
            matches_requested_module: boolean;
            module_path: string;
            node_id: string;
        }[];
        evidence_id: string;
        graph_id: string;
        omitted_candidates: number;
        requested_export_name: string;
        requested_module_path: string;
        selected_node_id: string
        | null;
        status: "unavailable" | "missing" | "ambiguous" | "selected";
    }
    +
  • Defined in src/domain/javascriptExportShapeSelection.ts:32
    • diff --git a/docs/api/interfaces/domain_javascriptExportShapeVariants.JavaScriptExportShapePairing.html b/docs/api/interfaces/domain_javascriptExportShapeVariants.JavaScriptExportShapePairing.html index 665dd2c78..1d6639bfe 100644 --- a/docs/api/interfaces/domain_javascriptExportShapeVariants.JavaScriptExportShapePairing.html +++ b/docs/api/interfaces/domain_javascriptExportShapeVariants.JavaScriptExportShapePairing.html @@ -16,7 +16,7 @@
    interface JavaScriptExportShapePairing {
        pairs: readonly VariantPair[];
        unpairedLeft: readonly number[];
        unpairedRight: readonly number[];
    }
    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:29
    • @@ -35,17 +35,17 @@
    pairs: readonly VariantPair[]
    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:30
    • unpairedLeft: readonly number[]
    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:31
    • unpairedRight: readonly number[]
    +
  • Defined in src/domain/javascriptExportShapeVariants.ts:32
    • diff --git a/docs/api/interfaces/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeProcessResult.html b/docs/api/interfaces/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeProcessResult.html index 57c040548..8edb67967 100644 --- a/docs/api/interfaces/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeProcessResult.html +++ b/docs/api/interfaces/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeProcessResult.html @@ -13,7 +13,7 @@

    Interface LinuxPrivateDisplayProbeProcessResult

    interface LinuxPrivateDisplayProbeProcessResult {
        cancelled: boolean;
        cleanupIncomplete: boolean;
        exitCode: number | null | undefined;
        stderr: string;
        stderrBytes: number;
        stderrTruncated: boolean;
        timedOut: boolean;
    }
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:26
    • @@ -36,37 +36,37 @@
    cancelled: boolean
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:32
    • cleanupIncomplete: boolean
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:33
    • exitCode: number | null | undefined
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:27
    • stderr: string
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:28
    • stderrBytes: number
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:29
    • stderrTruncated: boolean
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:30
    • timedOut: boolean
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:31
    • diff --git a/docs/api/types/application_EvidenceReferenceResolver.EvidenceLookup.html b/docs/api/types/application_EvidenceReferenceResolver.EvidenceLookup.html index 83f271ce2..ae0ac44d3 100644 --- a/docs/api/types/application_EvidenceReferenceResolver.EvidenceLookup.html +++ b/docs/api/types/application_EvidenceReferenceResolver.EvidenceLookup.html @@ -27,7 +27,7 @@
  • evidenceId: string

    • Returns Evidence | undefined

    +
  • Defined in src/application/EvidenceReferenceResolver.ts:12
    • diff --git a/docs/api/types/contracts_applicationWorkflowInputContracts.CompareApplicationVersionsRequest.html b/docs/api/types/contracts_applicationWorkflowInputContracts.CompareApplicationVersionsRequest.html index 580981dbb..dc297df7e 100644 --- a/docs/api/types/contracts_applicationWorkflowInputContracts.CompareApplicationVersionsRequest.html +++ b/docs/api/types/contracts_applicationWorkflowInputContracts.CompareApplicationVersionsRequest.html @@ -13,7 +13,7 @@

    Type Alias CompareApplicationVersionsRequest

    CompareApplicationVersionsRequest: z.output<
        typeof compareApplicationVersionsRequestSchema,
    >
    +
  • Defined in src/contracts/applicationWorkflowInputContracts.ts:125
    • diff --git a/docs/api/types/contracts_applicationWorkflowInputContracts.CompareJavaScriptExportShapesRequest.html b/docs/api/types/contracts_applicationWorkflowInputContracts.CompareJavaScriptExportShapesRequest.html index 0d3b92aab..b81ee0759 100644 --- a/docs/api/types/contracts_applicationWorkflowInputContracts.CompareJavaScriptExportShapesRequest.html +++ b/docs/api/types/contracts_applicationWorkflowInputContracts.CompareJavaScriptExportShapesRequest.html @@ -13,7 +13,7 @@

    Type Alias CompareJavaScriptExportShapesRequest

    CompareJavaScriptExportShapesRequest: z.output<
        typeof compareJavaScriptExportShapesRequestSchema,
    >
    +
  • Defined in src/contracts/applicationWorkflowInputContracts.ts:128
    • diff --git a/docs/api/types/contracts_applicationWorkflowInputContracts.TraceApplicationFeatureRequest.html b/docs/api/types/contracts_applicationWorkflowInputContracts.TraceApplicationFeatureRequest.html index 37e94ac77..3518e8e1a 100644 --- a/docs/api/types/contracts_applicationWorkflowInputContracts.TraceApplicationFeatureRequest.html +++ b/docs/api/types/contracts_applicationWorkflowInputContracts.TraceApplicationFeatureRequest.html @@ -13,7 +13,7 @@

    Type Alias TraceApplicationFeatureRequest

    TraceApplicationFeatureRequest: z.output<
        typeof traceApplicationFeatureRequestSchema,
    >
    +
  • Defined in src/contracts/applicationWorkflowInputContracts.ts:122
    • diff --git a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.CompareJavaScriptExportShapesInput.html b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.CompareJavaScriptExportShapesInput.html index 05d26575b..402436834 100644 --- a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.CompareJavaScriptExportShapesInput.html +++ b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.CompareJavaScriptExportShapesInput.html @@ -13,7 +13,7 @@

    Type Alias CompareJavaScriptExportShapesInput

    CompareJavaScriptExportShapesInput: z.output<
        typeof compareJavaScriptExportShapesInputSchema,
    >
    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:297
    • diff --git a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonChange.html b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonChange.html index 8e9d2d996..446057d92 100644 --- a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonChange.html +++ b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonChange.html @@ -13,7 +13,7 @@

    Type Alias JavaScriptExportShapeComparisonChange

    JavaScriptExportShapeComparisonChange: z.output<typeof comparisonChangeSchema>
    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:306
    • diff --git a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonResult.html b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonResult.html index 7cb2e50b0..93ab96c5d 100644 --- a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonResult.html +++ b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.JavaScriptExportShapeComparisonResult.html @@ -13,7 +13,7 @@

    Type Alias JavaScriptExportShapeComparisonResult

    JavaScriptExportShapeComparisonResult: z.output<
        typeof javaScriptExportShapeComparisonResultSchema,
    >
    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:303
    • diff --git a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.ProjectedExportReturnShapes.html b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.ProjectedExportReturnShapes.html index be156989a..a9d32c0e6 100644 --- a/docs/api/types/domain_javascriptExportShapeComparisonSchemas.ProjectedExportReturnShapes.html +++ b/docs/api/types/domain_javascriptExportShapeComparisonSchemas.ProjectedExportReturnShapes.html @@ -13,7 +13,7 @@

    Type Alias ProjectedExportReturnShapes

    ProjectedExportReturnShapes: z.output<typeof projectedExportReturnShapesSchema>
    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:300
    • diff --git a/docs/api/types/hopper_LinuxPrivateDisplayDiagnostic.LinuxPrivateDisplayDiagnosticParse.html b/docs/api/types/hopper_LinuxPrivateDisplayDiagnostic.LinuxPrivateDisplayDiagnosticParse.html index 919076b2a..efa3a71a9 100644 --- a/docs/api/types/hopper_LinuxPrivateDisplayDiagnostic.LinuxPrivateDisplayDiagnosticParse.html +++ b/docs/api/types/hopper_LinuxPrivateDisplayDiagnostic.LinuxPrivateDisplayDiagnosticParse.html @@ -13,7 +13,7 @@

    Type Alias LinuxPrivateDisplayDiagnosticParse

    LinuxPrivateDisplayDiagnosticParse:
        | { ok: true; value: HopperStartupDiagnostic }
        | {
            ok: false;
            reason:
                | "diagnostic_missing"
                | "diagnostic_multiple"
                | "diagnostic_malformed"
                | "diagnostic_truncated";
        }
    +
  • Defined in src/hopper/LinuxPrivateDisplayDiagnostic.ts:44
    • diff --git a/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeRunner.html b/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeRunner.html index 72da72c82..c116c3c60 100644 --- a/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeRunner.html +++ b/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayProbeRunner.html @@ -26,7 +26,7 @@
  • options: { helperPath: string; signal?: AbortSignal; timeoutMs: number }

    • Returns Promise<LinuxPrivateDisplayProbeProcessResult>

    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:36
    • diff --git a/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayRunnableStrategy.html b/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayRunnableStrategy.html index 91bd663b9..fdec7db7b 100644 --- a/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayRunnableStrategy.html +++ b/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplayRunnableStrategy.html @@ -13,7 +13,7 @@

    Type Alias LinuxPrivateDisplayRunnableStrategy

    LinuxPrivateDisplayRunnableStrategy: Exclude<
        HopperPrivateDisplayStrategy,
        "unavailable",
    >
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:21
    • diff --git a/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplaySelection.html b/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplaySelection.html index 85f99c73f..73c29faf3 100644 --- a/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplaySelection.html +++ b/docs/api/types/hopper_LinuxPrivateDisplayProbe.LinuxPrivateDisplaySelection.html @@ -13,7 +13,7 @@

    Type Alias LinuxPrivateDisplaySelection

    LinuxPrivateDisplaySelection:
        | {
            diagnostic: HopperStartupDiagnostic;
            ok: true;
            strategy: LinuxPrivateDisplayRunnableStrategy;
        }
        | {
            diagnostic: HopperStartupDiagnostic;
            exitCode: number;
            ok: false;
            strategy: "unavailable";
        }
    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:45
    • diff --git a/docs/api/variables/contracts_applicationWorkflowInputContracts.compareApplicationVersionsRequestSchema.html b/docs/api/variables/contracts_applicationWorkflowInputContracts.compareApplicationVersionsRequestSchema.html index 7f7fed421..fd7bf2a2e 100644 --- a/docs/api/variables/contracts_applicationWorkflowInputContracts.compareApplicationVersionsRequestSchema.html +++ b/docs/api/variables/contracts_applicationWorkflowInputContracts.compareApplicationVersionsRequestSchema.html @@ -15,7 +15,7 @@

    MCP/CLI comparison request accepting full Evidence or ledger references.

    +
  • Defined in src/contracts/applicationWorkflowInputContracts.ts:51
    • diff --git a/docs/api/variables/contracts_applicationWorkflowInputContracts.compareJavaScriptExportShapesRequestSchema.html b/docs/api/variables/contracts_applicationWorkflowInputContracts.compareJavaScriptExportShapesRequestSchema.html index 85fc205bc..34e9f5657 100644 --- a/docs/api/variables/contracts_applicationWorkflowInputContracts.compareJavaScriptExportShapesRequestSchema.html +++ b/docs/api/variables/contracts_applicationWorkflowInputContracts.compareJavaScriptExportShapesRequestSchema.html @@ -15,7 +15,7 @@

    MCP/CLI export-shape request accepting full Evidence or ledger references.

    +
  • Defined in src/contracts/applicationWorkflowInputContracts.ts:89
    • diff --git a/docs/api/variables/contracts_applicationWorkflowInputContracts.traceApplicationFeatureRequestSchema.html b/docs/api/variables/contracts_applicationWorkflowInputContracts.traceApplicationFeatureRequestSchema.html index fa6907475..bb87d4399 100644 --- a/docs/api/variables/contracts_applicationWorkflowInputContracts.traceApplicationFeatureRequestSchema.html +++ b/docs/api/variables/contracts_applicationWorkflowInputContracts.traceApplicationFeatureRequestSchema.html @@ -15,7 +15,7 @@

    MCP/CLI trace request accepting full Evidence or a ledger reference.

    +
  • Defined in src/contracts/applicationWorkflowInputContracts.ts:27
    • diff --git a/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.compareJavaScriptExportShapesInputSchema.html b/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.compareJavaScriptExportShapesInputSchema.html index 6342fe5e7..f9452ce2a 100644 --- a/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.compareJavaScriptExportShapesInputSchema.html +++ b/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.compareJavaScriptExportShapesInputSchema.html @@ -15,7 +15,7 @@

    Two authenticated application graphs, exact export selectors, and bounds.

    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:64
    • diff --git a/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.javaScriptExportShapeComparisonResultSchema.html b/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.javaScriptExportShapeComparisonResultSchema.html index c78a7454d..8102a495f 100644 --- a/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.javaScriptExportShapeComparisonResultSchema.html +++ b/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.javaScriptExportShapeComparisonResultSchema.html @@ -15,7 +15,7 @@

    Bounded static export-return comparison with explicit unknown semantics.

    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:248
    • diff --git a/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.projectedExportReturnShapesSchema.html b/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.projectedExportReturnShapesSchema.html index aef129a7c..0024a0975 100644 --- a/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.projectedExportReturnShapesSchema.html +++ b/docs/api/variables/domain_javascriptExportShapeComparisonSchemas.projectedExportReturnShapesSchema.html @@ -15,7 +15,7 @@

    Strict graph-observation payload produced by static return-shape recovery.

    +
  • Defined in src/domain/javascriptExportShapeComparisonSchemas.ts:165
    • diff --git a/docs/api/variables/hopper_LinuxPrivateDisplayDiagnostic.LINUX_PRIVATE_DISPLAY_DIAGNOSTIC_PREFIX.html b/docs/api/variables/hopper_LinuxPrivateDisplayDiagnostic.LINUX_PRIVATE_DISPLAY_DIAGNOSTIC_PREFIX.html index f2d01d271..bdab9249f 100644 --- a/docs/api/variables/hopper_LinuxPrivateDisplayDiagnostic.LINUX_PRIVATE_DISPLAY_DIAGNOSTIC_PREFIX.html +++ b/docs/api/variables/hopper_LinuxPrivateDisplayDiagnostic.LINUX_PRIVATE_DISPLAY_DIAGNOSTIC_PREFIX.html @@ -13,7 +13,7 @@

    Variable LINUX_PRIVATE_DISPLAY_DIAGNOSTIC_PREFIXConst

    LINUX_PRIVATE_DISPLAY_DIAGNOSTIC_PREFIX: "REA_X11_DIAGNOSTIC_V1="
    +
  • Defined in src/hopper/LinuxPrivateDisplayDiagnostic.ts:8
    • diff --git a/docs/api/variables/hopper_LinuxPrivateDisplayProbe.runLinuxPrivateDisplayProbe.html b/docs/api/variables/hopper_LinuxPrivateDisplayProbe.runLinuxPrivateDisplayProbe.html index efa32f8bc..c2a8cea66 100644 --- a/docs/api/variables/hopper_LinuxPrivateDisplayProbe.runLinuxPrivateDisplayProbe.html +++ b/docs/api/variables/hopper_LinuxPrivateDisplayProbe.runLinuxPrivateDisplayProbe.html @@ -15,7 +15,7 @@

    Run one helper probe in an owned process group with a hard output bound.

    +
  • Defined in src/hopper/LinuxPrivateDisplayProbe.ts:103
    • diff --git a/src/browser/CdpEndpoint.ts b/src/browser/CdpEndpoint.ts index eee428f20..4c9d61739 100644 --- a/src/browser/CdpEndpoint.ts +++ b/src/browser/CdpEndpoint.ts @@ -112,7 +112,7 @@ export const discoverCdpEndpoint = async ( targets: targets.map((target) => ({ id: target.id, type: target.type, - title: sanitizeTargetTitle(target.title), + title: sanitizeTargetTitle(target.title, target.url), url: target.url, attached: target.attached, ...targetWebSocket(endpoint, target, operation), @@ -120,18 +120,57 @@ export const discoverCdpEndpoint = async ( }; }; -const sanitizeTargetTitle = (value: string): string => { +const sanitizeTargetTitle = (value: string, targetUrl: string): string => { let url: URL; try { url = new URL(value); } catch { - return value; + return sanitizeTargetUrlAlias(value, targetUrl); } return url.protocol === "http:" || url.protocol === "https:" ? sanitizeBrowserUrl(value).url.slice(0, 16_384) - : value; + : sanitizeTargetUrlAlias(value, targetUrl); }; +const sanitizeTargetUrlAlias = (value: string, targetUrl: string): string => { + let parsed: URL; + try { + parsed = new URL(targetUrl); + } catch { + return value; + } + const markers = [parsed.origin, `//${parsed.host}`, parsed.host]; + if (parsed.pathname !== "/") markers.push(parsed.pathname); + const candidatePattern = new RegExp( + `(?:${markers.map(escapeRegExp).join("|")})[^\\s<>"']*`, + "gu", + ); + return value + .replace(candidatePattern, (candidate) => + sanitizeSameOriginTitleUrl(candidate, parsed), + ) + .slice(0, 16_384); +}; + +const sanitizeSameOriginTitleUrl = (candidate: string, target: URL): string => { + let parsed: URL; + try { + parsed = candidate.startsWith("//") + ? new URL(`${target.protocol}${candidate}`) + : candidate.startsWith(target.host) + ? new URL(`${target.protocol}//${candidate}`) + : new URL(candidate, target.origin); + } catch { + return candidate; + } + return parsed.origin === target.origin && parsed.search !== "" + ? sanitizeBrowserUrl(parsed.href).url + : candidate; +}; + +const escapeRegExp = (value: string): string => + value.replaceAll(/[.*+?^${}()|[\]\\]/gu, "\\$&"); + /** Select a browser attachment socket or a direct socket for one page target. */ export const cdpTargetWebSocket = ( discovery: CdpEndpointDiscovery, diff --git a/tests/cdpBrowserProvider.test.ts b/tests/cdpBrowserProvider.test.ts index 4d9160555..6c4f682ec 100644 --- a/tests/cdpBrowserProvider.test.ts +++ b/tests/cdpBrowserProvider.test.ts @@ -53,35 +53,40 @@ describe("CdpBrowserProvider", () => { expect(JSON.stringify(result.value)).not.toContain("page-secret"); }); - it("sanitizes URL-shaped transitional target titles", async () => { - const browser = await startFakeCdpBrowser({ - urlShapedAllowedTitle: true, - }); - browsers.push(browser); - const provider = new CdpBrowserProvider(); - const input = { - cdp_endpoint: browser.endpoint, - allowed_origins: [browser.allowedOrigin], - approved: true as const, - target_id: "allowed-page", - }; - const listed = await provider.listTargets( - listBrowserTargetsInputSchema.parse(input), - ); - if (!listed.ok) throw listed.error; - expect(listed.value.targets.items[0]?.title).toBe( - `${browser.allowedOrigin}/app?startup=%5BREDACTED%5D`, - ); + it.each([ + ["absolute", true, ""], + ["host/path", "host-path", ""], + ["root-relative", "root-relative", ""], + ["prefixed host/path", "prefixed", "Loading "], + ] as const)( + "sanitizes %s transitional target titles", + async (_label, urlShapedAllowedTitle, prefix) => { + const browser = await startFakeCdpBrowser({ urlShapedAllowedTitle }); + browsers.push(browser); + const provider = new CdpBrowserProvider(); + const input = { + cdp_endpoint: browser.endpoint, + allowed_origins: [browser.allowedOrigin], + approved: true as const, + target_id: "allowed-page", + }; + const expected = `${prefix}${browser.allowedOrigin}/app?startup=%5BREDACTED%5D`; + const listed = await provider.listTargets( + listBrowserTargetsInputSchema.parse(input), + ); + if (!listed.ok) throw listed.error; + expect(listed.value.targets.items[0]?.title).toBe(expected); - const inspected = await provider.inspectPage( - inspectWebPageInputSchema.parse({ ...input, observation_ms: 0 }), - ); - if (!inspected.ok) throw inspected.error; - expect(inspected.value.target.title).toBe( - `${browser.allowedOrigin}/app?startup=%5BREDACTED%5D`, - ); - expect(JSON.stringify({ listed, inspected })).not.toContain("title-secret"); - }); + const inspected = await provider.inspectPage( + inspectWebPageInputSchema.parse({ ...input, observation_ms: 0 }), + ); + if (!inspected.ok) throw inspected.error; + expect(inspected.value.target.title).toBe(expected); + expect(JSON.stringify({ listed, inspected })).not.toContain( + "title-secret", + ); + }, + ); it("uses page-scoped discovery sockets as direct target transports", async () => { const browser = await startFakeCdpBrowser({ diff --git a/tests/fixtures/fakeCdpBrowser.ts b/tests/fixtures/fakeCdpBrowser.ts index c941ab8e3..bb630bd82 100644 --- a/tests/fixtures/fakeCdpBrowser.ts +++ b/tests/fixtures/fakeCdpBrowser.ts @@ -62,7 +62,11 @@ interface FakeOptions { readonly webMcpChildLeavesScope?: boolean; readonly electronFileUrl?: string; readonly duplicateElectronInventory?: boolean; - readonly urlShapedAllowedTitle?: boolean; + readonly urlShapedAllowedTitle?: + | boolean + | "host-path" + | "root-relative" + | "prefixed"; } /** Start a real HTTP/WebSocket fake at the same seams as a user-owned browser. */ @@ -226,10 +230,7 @@ const targets = ( { id: "allowed-page", type: "page", - title: - options.urlShapedAllowedTitle === true - ? `http://127.0.0.1:${String(port)}/app?startup=title-secret#fragment` - : "Inspectable application", + title: allowedPageTitle(port, options.urlShapedAllowedTitle), url: `http://127.0.0.1:${String(port)}/app?token=page-secret#fragment`, attached: false, ...(options.omitTargetWebSocket === true @@ -333,6 +334,19 @@ const targets = ( ]), ]; +const allowedPageTitle = ( + port: number, + style: FakeOptions["urlShapedAllowedTitle"], +): string => { + const suffix = "/app?startup=title-secret#fragment"; + const host = `127.0.0.1:${String(port)}`; + if (style === true) return `http://${host}${suffix}`; + if (style === "host-path") return `${host}${suffix}`; + if (style === "root-relative") return suffix; + if (style === "prefixed") return `Loading ${host}${suffix}`; + return "Inspectable application"; +}; + const parseCommand = (text: string): FakeCdpCommand => { const value: unknown = JSON.parse(text); if (typeof value !== "object" || value === null)