@phosphorco/bb-cross-references 0.1.1 → 0.3.0

package/dist/types/evidence-v2.d.ts

@@ -0,0 +1,1080 @@
+/** Pure V2 evidence wire. V1 schemas and projection meanings are independent. */
+import { z } from 'zod';
+export declare const MENTION_V2_LIMITS: Readonly<{
+    responseBytes: 1048576;
+    inputBytes: 65536;
+    pageSize: 100;
+    cursorBytes: 4096;
+    excerptCodePoints: 320;
+    excerptBytes: 1280;
+    rowBytes: 131072;
+    readMs: 2000;
+    callMs: 5000;
+    lookupMs: 1500;
+    lookupCalls: 8;
+}>;
+export declare const MENTION_V2_METHODS: Readonly<{
+    readonly list: "crossReferencesV2ListMentions";
+    readonly resolve: "crossReferencesV2ResolveLookup";
+}>;
+/** UTF16 offsets may address only complete code points. No normalization or
+ * replacement: a genuine U+FFFD remains ordinary source text. */
+export declare function isUtf16CodePointBoundary(text: string, offset: number): boolean;
+export declare const identityInputV2Schema: z.ZodObject<{
+    provider: z.ZodString;
+    keys: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const resourceOutputV2Schema: z.ZodObject<{
+    presentation: z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        detail: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    provider: z.ZodString;
+    keys: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$loose>;
+export declare const safeAuthoredHrefSchema: z.ZodString;
+export declare const mentionQueryV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"resource">;
+    target: z.ZodObject<{
+        provider: z.ZodString;
+        keys: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>;
+    relation: z.ZodEnum<{
+        self: "self";
+        "github-pr-family": "github-pr-family";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"authored-url">;
+    href: z.ZodString;
+}, z.core.$strict>], "kind">;
+export declare const listMentionsInputV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    query: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"resource">;
+        target: z.ZodObject<{
+            provider: z.ZodString;
+            keys: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>;
+        relation: z.ZodEnum<{
+            self: "self";
+            "github-pr-family": "github-pr-family";
+        }>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"authored-url">;
+        href: z.ZodString;
+    }, z.core.$strict>], "kind">;
+    source: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        keys: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+    producerPluginId: z.ZodOptional<z.ZodString>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    ifSnapshot: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const spanOutputV2Schema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, z.core.$loose>;
+export declare const excerptV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    state: z.ZodLiteral<"ready">;
+    text: z.ZodString;
+    sourceSpan: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$loose>;
+    matchSpan: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$loose>;
+    clippedBefore: z.ZodBoolean;
+    clippedAfter: z.ZodBoolean;
+    matchClippedBefore: z.ZodBoolean;
+    matchClippedAfter: z.ZodBoolean;
+    codecVersion: z.ZodLiteral<1>;
+}, z.core.$loose>, z.ZodObject<{
+    state: z.ZodLiteral<"unavailable">;
+    reason: z.ZodEnum<{
+        "not-materialized": "not-materialized";
+        "indivisible-word": "indivisible-word";
+        "no-eligible-context": "no-eligible-context";
+    }>;
+    codecVersion: z.ZodLiteral<1>;
+}, z.core.$loose>], "state">;
+/** Strict internal record; the store validates binding to admitted source bytes. */
+export declare const excerptRecordV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    sourceSpan: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strict>;
+    matchSpan: z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strict>;
+    state: z.ZodLiteral<"ready">;
+    text: z.ZodString;
+    clippedBefore: z.ZodBoolean;
+    clippedAfter: z.ZodBoolean;
+    matchClippedBefore: z.ZodBoolean;
+    matchClippedAfter: z.ZodBoolean;
+    codecVersion: z.ZodLiteral<1>;
+}, z.core.$strict>, z.ZodObject<{
+    state: z.ZodLiteral<"unavailable">;
+    reason: z.ZodEnum<{
+        "indivisible-word": "indivisible-word";
+        "no-eligible-context": "no-eligible-context";
+    }>;
+    codecVersion: z.ZodLiteral<1>;
+}, z.core.$strict>], "state">;
+export declare const locatorOutputV2Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"conversation">;
+    threadId: z.ZodString;
+    messageId: z.ZodString;
+    messageSeq: z.ZodNumber;
+    anchorSeq: z.ZodNullable<z.ZodNumber>;
+    role: z.ZodEnum<{
+        user: "user";
+        assistant: "assistant";
+    }>;
+}, z.core.$loose>;
+/** Future item/locator/excerpt enums occupy a slot; malformed known items still reject. */
+export declare const mentionItemV2Schema: z.ZodPipe<z.ZodUnknown, z.ZodTransform<{
+    [x: string]: unknown;
+    kind: "occurrence";
+    evidenceRevision: number;
+    occurrenceKey: string;
+    locator: {
+        [x: string]: unknown;
+        kind: "conversation";
+        threadId: string;
+        messageId: string;
+        messageSeq: number;
+        anchorSeq: number | null;
+        role: "user" | "assistant";
+    };
+    sourceContentRevision: string;
+    span: {
+        [x: string]: unknown;
+        start: number;
+        end: number;
+    };
+    excerpt: {
+        [x: string]: unknown;
+        state: "ready";
+        text: string;
+        sourceSpan: {
+            [x: string]: unknown;
+            start: number;
+            end: number;
+        };
+        matchSpan: {
+            [x: string]: unknown;
+            start: number;
+            end: number;
+        };
+        clippedBefore: boolean;
+        clippedAfter: boolean;
+        matchClippedBefore: boolean;
+        matchClippedAfter: boolean;
+        codecVersion: 1;
+    } | {
+        [x: string]: unknown;
+        state: "unavailable";
+        reason: "not-materialized" | "indivisible-word" | "no-eligible-context";
+        codecVersion: 1;
+    };
+    messageCreatedAt: number;
+    observedAt: number;
+    confirmation: "observed" | "retained-unconfirmed";
+    provenance: {
+        [x: string]: unknown;
+        pluginId: string;
+        origin: "builtin" | "contributed";
+        confidence: "high" | "medium" | "low";
+        recognition: {
+            [x: string]: unknown;
+            basis: "explicit" | "text-url" | "existing-link" | "git-remote" | "context";
+            explanation: string;
+            evidence?: {
+                [x: string]: unknown;
+                span?: {
+                    [x: string]: unknown;
+                    start: number;
+                    end: number;
+                } | undefined;
+                link?: number | undefined;
+                remote?: string | undefined;
+            } | undefined;
+        };
+        source: {
+            [x: string]: unknown;
+            provider: string;
+            id: string;
+            kind?: string | undefined;
+        };
+        authoredHref?: string | undefined;
+        verifiedFile?: {
+            [x: string]: unknown;
+            kind: "workspace";
+            environmentId: string;
+            path: string;
+        } | {
+            [x: string]: unknown;
+            kind: "thread-storage";
+            threadId: string;
+            path: string;
+        } | undefined;
+    };
+    authoredUrlState: "unknown" | "exact" | "not-url";
+    source: {
+        [x: string]: unknown;
+        presentation: {
+            [x: string]: unknown;
+            label: string;
+            url?: string | undefined;
+            detail?: string | undefined;
+        };
+        provider: string;
+        keys: Record<string, string>;
+    };
+    target: {
+        [x: string]: unknown;
+        presentation: {
+            [x: string]: unknown;
+            label: string;
+            url?: string | undefined;
+            detail?: string | undefined;
+        };
+        provider: string;
+        keys: Record<string, string>;
+    };
+    producerPluginId: string;
+    graphRevision: number;
+    cap: {
+        [x: string]: unknown;
+        state: "unknown" | "uncapped" | "capped";
+        limit: 100 | null;
+        sourceHistoryUnknown: boolean | null;
+    };
+} | {
+    [x: string]: unknown;
+    kind: "claim-without-evidence";
+    reason: "legacy" | "producer-no-evidence" | "not-yet-collected";
+    matchBasis: "primary-resource" | "primary-url-identity";
+    source: {
+        [x: string]: unknown;
+        presentation: {
+            [x: string]: unknown;
+            label: string;
+            url?: string | undefined;
+            detail?: string | undefined;
+        };
+        provider: string;
+        keys: Record<string, string>;
+    };
+    target: {
+        [x: string]: unknown;
+        presentation: {
+            [x: string]: unknown;
+            label: string;
+            url?: string | undefined;
+            detail?: string | undefined;
+        };
+        provider: string;
+        keys: Record<string, string>;
+    };
+    producerPluginId: string;
+    graphRevision: number;
+    cap: {
+        [x: string]: unknown;
+        state: "unknown" | "uncapped" | "capped";
+        limit: 100 | null;
+        sourceHistoryUnknown: boolean | null;
+    };
+} | {
+    [x: string]: unknown;
+    kind: "unsupported";
+    reason: "unsupported-format";
+    source: {
+        [x: string]: unknown;
+        presentation: {
+            [x: string]: unknown;
+            label: string;
+            url?: string | undefined;
+            detail?: string | undefined;
+        };
+        provider: string;
+        keys: Record<string, string>;
+    };
+    target: {
+        [x: string]: unknown;
+        presentation: {
+            [x: string]: unknown;
+            label: string;
+            url?: string | undefined;
+            detail?: string | undefined;
+        };
+        provider: string;
+        keys: Record<string, string>;
+    };
+    producerPluginId: string;
+    graphRevision: number;
+    cap: {
+        [x: string]: unknown;
+        state: "unknown" | "uncapped" | "capped";
+        limit: 100 | null;
+        sourceHistoryUnknown: boolean | null;
+    };
+}, unknown>>;
+export declare const mentionCountsV2Schema: z.ZodObject<{
+    retainedOccurrences: z.ZodNumber;
+    confirmedOccurrences: z.ZodNumber;
+    unconfirmedOccurrences: z.ZodNumber;
+    producerClaims: z.ZodNumber;
+    indexedSources: z.ZodNumber;
+    claimsWithoutLocations: z.ZodNumber;
+    excerptUnavailable: z.ZodNumber;
+}, z.core.$loose>;
+export declare const coverageV2Schema: z.ZodObject<{
+    scope: z.ZodLiteral<"known-sources">;
+    collectionIncomplete: z.ZodBoolean;
+    retentionLimited: z.ZodBoolean;
+    capHistoryUnknown: z.ZodBoolean;
+    legacyClaimsPresent: z.ZodBoolean;
+    evidenceStateUnknown: z.ZodBoolean;
+    authoredUrlCoverage: z.ZodObject<{
+        state: z.ZodEnum<{
+            "complete-for-known-locations": "complete-for-known-locations";
+            partial: "partial";
+        }>;
+        unknownLocations: z.ZodNumber;
+        scope: z.ZodLiteral<"known-locations">;
+        watermark: z.ZodString;
+    }, z.core.$loose>;
+    reasons: z.ZodArray<z.ZodString>;
+    reasonsClipped: z.ZodBoolean;
+    checkedAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$loose>;
+export declare const listMentionsOutputV2Schema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    status: z.ZodLiteral<"page">;
+    snapshot: z.ZodString;
+    items: z.ZodArray<z.ZodPipe<z.ZodUnknown, z.ZodTransform<{
+        [x: string]: unknown;
+        kind: "occurrence";
+        evidenceRevision: number;
+        occurrenceKey: string;
+        locator: {
+            [x: string]: unknown;
+            kind: "conversation";
+            threadId: string;
+            messageId: string;
+            messageSeq: number;
+            anchorSeq: number | null;
+            role: "user" | "assistant";
+        };
+        sourceContentRevision: string;
+        span: {
+            [x: string]: unknown;
+            start: number;
+            end: number;
+        };
+        excerpt: {
+            [x: string]: unknown;
+            state: "ready";
+            text: string;
+            sourceSpan: {
+                [x: string]: unknown;
+                start: number;
+                end: number;
+            };
+            matchSpan: {
+                [x: string]: unknown;
+                start: number;
+                end: number;
+            };
+            clippedBefore: boolean;
+            clippedAfter: boolean;
+            matchClippedBefore: boolean;
+            matchClippedAfter: boolean;
+            codecVersion: 1;
+        } | {
+            [x: string]: unknown;
+            state: "unavailable";
+            reason: "not-materialized" | "indivisible-word" | "no-eligible-context";
+            codecVersion: 1;
+        };
+        messageCreatedAt: number;
+        observedAt: number;
+        confirmation: "observed" | "retained-unconfirmed";
+        provenance: {
+            [x: string]: unknown;
+            pluginId: string;
+            origin: "builtin" | "contributed";
+            confidence: "high" | "medium" | "low";
+            recognition: {
+                [x: string]: unknown;
+                basis: "explicit" | "text-url" | "existing-link" | "git-remote" | "context";
+                explanation: string;
+                evidence?: {
+                    [x: string]: unknown;
+                    span?: {
+                        [x: string]: unknown;
+                        start: number;
+                        end: number;
+                    } | undefined;
+                    link?: number | undefined;
+                    remote?: string | undefined;
+                } | undefined;
+            };
+            source: {
+                [x: string]: unknown;
+                provider: string;
+                id: string;
+                kind?: string | undefined;
+            };
+            authoredHref?: string | undefined;
+            verifiedFile?: {
+                [x: string]: unknown;
+                kind: "workspace";
+                environmentId: string;
+                path: string;
+            } | {
+                [x: string]: unknown;
+                kind: "thread-storage";
+                threadId: string;
+                path: string;
+            } | undefined;
+        };
+        authoredUrlState: "unknown" | "exact" | "not-url";
+        source: {
+            [x: string]: unknown;
+            presentation: {
+                [x: string]: unknown;
+                label: string;
+                url?: string | undefined;
+                detail?: string | undefined;
+            };
+            provider: string;
+            keys: Record<string, string>;
+        };
+        target: {
+            [x: string]: unknown;
+            presentation: {
+                [x: string]: unknown;
+                label: string;
+                url?: string | undefined;
+                detail?: string | undefined;
+            };
+            provider: string;
+            keys: Record<string, string>;
+        };
+        producerPluginId: string;
+        graphRevision: number;
+        cap: {
+            [x: string]: unknown;
+            state: "unknown" | "uncapped" | "capped";
+            limit: 100 | null;
+            sourceHistoryUnknown: boolean | null;
+        };
+    } | {
+        [x: string]: unknown;
+        kind: "claim-without-evidence";
+        reason: "legacy" | "producer-no-evidence" | "not-yet-collected";
+        matchBasis: "primary-resource" | "primary-url-identity";
+        source: {
+            [x: string]: unknown;
+            presentation: {
+                [x: string]: unknown;
+                label: string;
+                url?: string | undefined;
+                detail?: string | undefined;
+            };
+            provider: string;
+            keys: Record<string, string>;
+        };
+        target: {
+            [x: string]: unknown;
+            presentation: {
+                [x: string]: unknown;
+                label: string;
+                url?: string | undefined;
+                detail?: string | undefined;
+            };
+            provider: string;
+            keys: Record<string, string>;
+        };
+        producerPluginId: string;
+        graphRevision: number;
+        cap: {
+            [x: string]: unknown;
+            state: "unknown" | "uncapped" | "capped";
+            limit: 100 | null;
+            sourceHistoryUnknown: boolean | null;
+        };
+    } | {
+        [x: string]: unknown;
+        kind: "unsupported";
+        reason: "unsupported-format";
+        source: {
+            [x: string]: unknown;
+            presentation: {
+                [x: string]: unknown;
+                label: string;
+                url?: string | undefined;
+                detail?: string | undefined;
+            };
+            provider: string;
+            keys: Record<string, string>;
+        };
+        target: {
+            [x: string]: unknown;
+            presentation: {
+                [x: string]: unknown;
+                label: string;
+                url?: string | undefined;
+                detail?: string | undefined;
+            };
+            provider: string;
+            keys: Record<string, string>;
+        };
+        producerPluginId: string;
+        graphRevision: number;
+        cap: {
+            [x: string]: unknown;
+            state: "unknown" | "uncapped" | "capped";
+            limit: 100 | null;
+            sourceHistoryUnknown: boolean | null;
+        };
+    }, unknown>>>;
+    counts: z.ZodObject<{
+        retainedOccurrences: z.ZodNumber;
+        confirmedOccurrences: z.ZodNumber;
+        unconfirmedOccurrences: z.ZodNumber;
+        producerClaims: z.ZodNumber;
+        indexedSources: z.ZodNumber;
+        claimsWithoutLocations: z.ZodNumber;
+        excerptUnavailable: z.ZodNumber;
+    }, z.core.$loose>;
+    coverage: z.ZodObject<{
+        scope: z.ZodLiteral<"known-sources">;
+        collectionIncomplete: z.ZodBoolean;
+        retentionLimited: z.ZodBoolean;
+        capHistoryUnknown: z.ZodBoolean;
+        legacyClaimsPresent: z.ZodBoolean;
+        evidenceStateUnknown: z.ZodBoolean;
+        authoredUrlCoverage: z.ZodObject<{
+            state: z.ZodEnum<{
+                "complete-for-known-locations": "complete-for-known-locations";
+                partial: "partial";
+            }>;
+            unknownLocations: z.ZodNumber;
+            scope: z.ZodLiteral<"known-locations">;
+            watermark: z.ZodString;
+        }, z.core.$loose>;
+        reasons: z.ZodArray<z.ZodString>;
+        reasonsClipped: z.ZodBoolean;
+        checkedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$loose>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>, z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    status: z.ZodLiteral<"not-modified">;
+    snapshot: z.ZodString;
+    coverage: z.ZodObject<{
+        scope: z.ZodLiteral<"known-sources">;
+        collectionIncomplete: z.ZodBoolean;
+        retentionLimited: z.ZodBoolean;
+        capHistoryUnknown: z.ZodBoolean;
+        legacyClaimsPresent: z.ZodBoolean;
+        evidenceStateUnknown: z.ZodBoolean;
+        authoredUrlCoverage: z.ZodObject<{
+            state: z.ZodEnum<{
+                "complete-for-known-locations": "complete-for-known-locations";
+                partial: "partial";
+            }>;
+            unknownLocations: z.ZodNumber;
+            scope: z.ZodLiteral<"known-locations">;
+            watermark: z.ZodString;
+        }, z.core.$loose>;
+        reasons: z.ZodArray<z.ZodString>;
+        reasonsClipped: z.ZodBoolean;
+        checkedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$loose>;
+}, z.core.$loose>, z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    status: z.ZodLiteral<"restart">;
+    reason: z.ZodLiteral<"snapshot-changed">;
+    snapshot: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    status: z.ZodLiteral<"unavailable">;
+    reason: z.ZodEnum<{
+        "index-warming": "index-warming";
+        "read-budget": "read-budget";
+    }>;
+    retryable: z.ZodBoolean;
+}, z.core.$loose>], "status">;
+export declare const lookupContextV2Schema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    threadId: z.ZodOptional<z.ZodString>;
+    environmentId: z.ZodOptional<z.ZodString>;
+    git: z.ZodOptional<z.ZodObject<{
+        branch: z.ZodOptional<z.ZodString>;
+        upstream: z.ZodOptional<z.ZodObject<{
+            remote: z.ZodString;
+            branch: z.ZodString;
+        }, z.core.$strict>>;
+        remotes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    locale: z.ZodOptional<z.ZodString>;
+    timeZone: z.ZodOptional<z.ZodString>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        href: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const resolveLookupInputV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    text: z.ZodString;
+    mode: z.ZodEnum<{
+        recognize: "recognize";
+        "exact-url": "exact-url";
+    }>;
+    context: z.ZodOptional<z.ZodObject<{
+        projectId: z.ZodOptional<z.ZodString>;
+        threadId: z.ZodOptional<z.ZodString>;
+        environmentId: z.ZodOptional<z.ZodString>;
+        git: z.ZodOptional<z.ZodObject<{
+            branch: z.ZodOptional<z.ZodString>;
+            upstream: z.ZodOptional<z.ZodObject<{
+                remote: z.ZodString;
+                branch: z.ZodString;
+            }, z.core.$strict>>;
+            remotes: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                url: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        locale: z.ZodOptional<z.ZodString>;
+        timeZone: z.ZodOptional<z.ZodString>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            href: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const resolveLookupOutputV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    state: z.ZodEnum<{
+        ready: "ready";
+        ambiguous: "ambiguous";
+        unrecognized: "unrecognized";
+        incomplete: "incomplete";
+    }>;
+    options: z.ZodArray<z.ZodObject<{
+        query: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"resource">;
+            target: z.ZodObject<{
+                provider: z.ZodString;
+                keys: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$loose>;
+            relation: z.ZodEnum<{
+                self: "self";
+                "github-pr-family": "github-pr-family";
+            }>;
+        }, z.core.$loose>, z.ZodObject<{
+            kind: z.ZodLiteral<"authored-url">;
+            href: z.ZodString;
+        }, z.core.$loose>], "kind">;
+        label: z.ZodString;
+        inputSpan: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$loose>;
+        basis: z.ZodEnum<{
+            supplier: "supplier";
+            native: "native";
+            "stored-codec": "stored-codec";
+        }>;
+        reasons: z.ZodArray<z.ZodString>;
+    }, z.core.$loose>>;
+    reasons: z.ZodArray<z.ZodString>;
+}, z.core.$loose>;
+export declare const crossReferencesV2RpcSchemas: {
+    readonly crossReferencesV2ListMentions: {
+        readonly input: z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            query: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                kind: z.ZodLiteral<"resource">;
+                target: z.ZodObject<{
+                    provider: z.ZodString;
+                    keys: z.ZodRecord<z.ZodString, z.ZodString>;
+                }, z.core.$strict>;
+                relation: z.ZodEnum<{
+                    self: "self";
+                    "github-pr-family": "github-pr-family";
+                }>;
+            }, z.core.$strict>, z.ZodObject<{
+                kind: z.ZodLiteral<"authored-url">;
+                href: z.ZodString;
+            }, z.core.$strict>], "kind">;
+            source: z.ZodOptional<z.ZodObject<{
+                provider: z.ZodString;
+                keys: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strict>>;
+            producerPluginId: z.ZodOptional<z.ZodString>;
+            pageSize: z.ZodOptional<z.ZodNumber>;
+            cursor: z.ZodOptional<z.ZodString>;
+            ifSnapshot: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+        readonly output: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            status: z.ZodLiteral<"page">;
+            snapshot: z.ZodString;
+            items: z.ZodArray<z.ZodPipe<z.ZodUnknown, z.ZodTransform<{
+                [x: string]: unknown;
+                kind: "occurrence";
+                evidenceRevision: number;
+                occurrenceKey: string;
+                locator: {
+                    [x: string]: unknown;
+                    kind: "conversation";
+                    threadId: string;
+                    messageId: string;
+                    messageSeq: number;
+                    anchorSeq: number | null;
+                    role: "user" | "assistant";
+                };
+                sourceContentRevision: string;
+                span: {
+                    [x: string]: unknown;
+                    start: number;
+                    end: number;
+                };
+                excerpt: {
+                    [x: string]: unknown;
+                    state: "ready";
+                    text: string;
+                    sourceSpan: {
+                        [x: string]: unknown;
+                        start: number;
+                        end: number;
+                    };
+                    matchSpan: {
+                        [x: string]: unknown;
+                        start: number;
+                        end: number;
+                    };
+                    clippedBefore: boolean;
+                    clippedAfter: boolean;
+                    matchClippedBefore: boolean;
+                    matchClippedAfter: boolean;
+                    codecVersion: 1;
+                } | {
+                    [x: string]: unknown;
+                    state: "unavailable";
+                    reason: "not-materialized" | "indivisible-word" | "no-eligible-context";
+                    codecVersion: 1;
+                };
+                messageCreatedAt: number;
+                observedAt: number;
+                confirmation: "observed" | "retained-unconfirmed";
+                provenance: {
+                    [x: string]: unknown;
+                    pluginId: string;
+                    origin: "builtin" | "contributed";
+                    confidence: "high" | "medium" | "low";
+                    recognition: {
+                        [x: string]: unknown;
+                        basis: "explicit" | "text-url" | "existing-link" | "git-remote" | "context";
+                        explanation: string;
+                        evidence?: {
+                            [x: string]: unknown;
+                            span?: {
+                                [x: string]: unknown;
+                                start: number;
+                                end: number;
+                            } | undefined;
+                            link?: number | undefined;
+                            remote?: string | undefined;
+                        } | undefined;
+                    };
+                    source: {
+                        [x: string]: unknown;
+                        provider: string;
+                        id: string;
+                        kind?: string | undefined;
+                    };
+                    authoredHref?: string | undefined;
+                    verifiedFile?: {
+                        [x: string]: unknown;
+                        kind: "workspace";
+                        environmentId: string;
+                        path: string;
+                    } | {
+                        [x: string]: unknown;
+                        kind: "thread-storage";
+                        threadId: string;
+                        path: string;
+                    } | undefined;
+                };
+                authoredUrlState: "unknown" | "exact" | "not-url";
+                source: {
+                    [x: string]: unknown;
+                    presentation: {
+                        [x: string]: unknown;
+                        label: string;
+                        url?: string | undefined;
+                        detail?: string | undefined;
+                    };
+                    provider: string;
+                    keys: Record<string, string>;
+                };
+                target: {
+                    [x: string]: unknown;
+                    presentation: {
+                        [x: string]: unknown;
+                        label: string;
+                        url?: string | undefined;
+                        detail?: string | undefined;
+                    };
+                    provider: string;
+                    keys: Record<string, string>;
+                };
+                producerPluginId: string;
+                graphRevision: number;
+                cap: {
+                    [x: string]: unknown;
+                    state: "unknown" | "uncapped" | "capped";
+                    limit: 100 | null;
+                    sourceHistoryUnknown: boolean | null;
+                };
+            } | {
+                [x: string]: unknown;
+                kind: "claim-without-evidence";
+                reason: "legacy" | "producer-no-evidence" | "not-yet-collected";
+                matchBasis: "primary-resource" | "primary-url-identity";
+                source: {
+                    [x: string]: unknown;
+                    presentation: {
+                        [x: string]: unknown;
+                        label: string;
+                        url?: string | undefined;
+                        detail?: string | undefined;
+                    };
+                    provider: string;
+                    keys: Record<string, string>;
+                };
+                target: {
+                    [x: string]: unknown;
+                    presentation: {
+                        [x: string]: unknown;
+                        label: string;
+                        url?: string | undefined;
+                        detail?: string | undefined;
+                    };
+                    provider: string;
+                    keys: Record<string, string>;
+                };
+                producerPluginId: string;
+                graphRevision: number;
+                cap: {
+                    [x: string]: unknown;
+                    state: "unknown" | "uncapped" | "capped";
+                    limit: 100 | null;
+                    sourceHistoryUnknown: boolean | null;
+                };
+            } | {
+                [x: string]: unknown;
+                kind: "unsupported";
+                reason: "unsupported-format";
+                source: {
+                    [x: string]: unknown;
+                    presentation: {
+                        [x: string]: unknown;
+                        label: string;
+                        url?: string | undefined;
+                        detail?: string | undefined;
+                    };
+                    provider: string;
+                    keys: Record<string, string>;
+                };
+                target: {
+                    [x: string]: unknown;
+                    presentation: {
+                        [x: string]: unknown;
+                        label: string;
+                        url?: string | undefined;
+                        detail?: string | undefined;
+                    };
+                    provider: string;
+                    keys: Record<string, string>;
+                };
+                producerPluginId: string;
+                graphRevision: number;
+                cap: {
+                    [x: string]: unknown;
+                    state: "unknown" | "uncapped" | "capped";
+                    limit: 100 | null;
+                    sourceHistoryUnknown: boolean | null;
+                };
+            }, unknown>>>;
+            counts: z.ZodObject<{
+                retainedOccurrences: z.ZodNumber;
+                confirmedOccurrences: z.ZodNumber;
+                unconfirmedOccurrences: z.ZodNumber;
+                producerClaims: z.ZodNumber;
+                indexedSources: z.ZodNumber;
+                claimsWithoutLocations: z.ZodNumber;
+                excerptUnavailable: z.ZodNumber;
+            }, z.core.$loose>;
+            coverage: z.ZodObject<{
+                scope: z.ZodLiteral<"known-sources">;
+                collectionIncomplete: z.ZodBoolean;
+                retentionLimited: z.ZodBoolean;
+                capHistoryUnknown: z.ZodBoolean;
+                legacyClaimsPresent: z.ZodBoolean;
+                evidenceStateUnknown: z.ZodBoolean;
+                authoredUrlCoverage: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        "complete-for-known-locations": "complete-for-known-locations";
+                        partial: "partial";
+                    }>;
+                    unknownLocations: z.ZodNumber;
+                    scope: z.ZodLiteral<"known-locations">;
+                    watermark: z.ZodString;
+                }, z.core.$loose>;
+                reasons: z.ZodArray<z.ZodString>;
+                reasonsClipped: z.ZodBoolean;
+                checkedAt: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>;
+            nextCursor: z.ZodNullable<z.ZodString>;
+        }, z.core.$loose>, z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            status: z.ZodLiteral<"not-modified">;
+            snapshot: z.ZodString;
+            coverage: z.ZodObject<{
+                scope: z.ZodLiteral<"known-sources">;
+                collectionIncomplete: z.ZodBoolean;
+                retentionLimited: z.ZodBoolean;
+                capHistoryUnknown: z.ZodBoolean;
+                legacyClaimsPresent: z.ZodBoolean;
+                evidenceStateUnknown: z.ZodBoolean;
+                authoredUrlCoverage: z.ZodObject<{
+                    state: z.ZodEnum<{
+                        "complete-for-known-locations": "complete-for-known-locations";
+                        partial: "partial";
+                    }>;
+                    unknownLocations: z.ZodNumber;
+                    scope: z.ZodLiteral<"known-locations">;
+                    watermark: z.ZodString;
+                }, z.core.$loose>;
+                reasons: z.ZodArray<z.ZodString>;
+                reasonsClipped: z.ZodBoolean;
+                checkedAt: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>;
+        }, z.core.$loose>, z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            status: z.ZodLiteral<"restart">;
+            reason: z.ZodLiteral<"snapshot-changed">;
+            snapshot: z.ZodString;
+        }, z.core.$loose>, z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            status: z.ZodLiteral<"unavailable">;
+            reason: z.ZodEnum<{
+                "index-warming": "index-warming";
+                "read-budget": "read-budget";
+            }>;
+            retryable: z.ZodBoolean;
+        }, z.core.$loose>], "status">;
+    };
+    readonly crossReferencesV2ResolveLookup: {
+        readonly input: z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            text: z.ZodString;
+            mode: z.ZodEnum<{
+                recognize: "recognize";
+                "exact-url": "exact-url";
+            }>;
+            context: z.ZodOptional<z.ZodObject<{
+                projectId: z.ZodOptional<z.ZodString>;
+                threadId: z.ZodOptional<z.ZodString>;
+                environmentId: z.ZodOptional<z.ZodString>;
+                git: z.ZodOptional<z.ZodObject<{
+                    branch: z.ZodOptional<z.ZodString>;
+                    upstream: z.ZodOptional<z.ZodObject<{
+                        remote: z.ZodString;
+                        branch: z.ZodString;
+                    }, z.core.$strict>>;
+                    remotes: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        url: z.ZodString;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+                locale: z.ZodOptional<z.ZodString>;
+                timeZone: z.ZodOptional<z.ZodString>;
+                links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    href: z.ZodString;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>;
+        readonly output: z.ZodObject<{
+            version: z.ZodLiteral<2>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                ambiguous: "ambiguous";
+                unrecognized: "unrecognized";
+                incomplete: "incomplete";
+            }>;
+            options: z.ZodArray<z.ZodObject<{
+                query: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"resource">;
+                    target: z.ZodObject<{
+                        provider: z.ZodString;
+                        keys: z.ZodRecord<z.ZodString, z.ZodString>;
+                    }, z.core.$loose>;
+                    relation: z.ZodEnum<{
+                        self: "self";
+                        "github-pr-family": "github-pr-family";
+                    }>;
+                }, z.core.$loose>, z.ZodObject<{
+                    kind: z.ZodLiteral<"authored-url">;
+                    href: z.ZodString;
+                }, z.core.$loose>], "kind">;
+                label: z.ZodString;
+                inputSpan: z.ZodObject<{
+                    start: z.ZodNumber;
+                    end: z.ZodNumber;
+                }, z.core.$loose>;
+                basis: z.ZodEnum<{
+                    supplier: "supplier";
+                    native: "native";
+                    "stored-codec": "stored-codec";
+                }>;
+                reasons: z.ZodArray<z.ZodString>;
+            }, z.core.$loose>>;
+            reasons: z.ZodArray<z.ZodString>;
+        }, z.core.$loose>;
+    };
+};
+export declare const mentionsChangedV2Schema: z.ZodObject<{
+    version: z.ZodLiteral<2>;
+    producerPluginId: z.ZodString;
+    sourceIdentityDigest: z.ZodString;
+    graphRevision: z.ZodNumber;
+    evidenceRevision: z.ZodNullable<z.ZodNumber>;
+    affectedIdentityDigests: z.ZodArray<z.ZodString>;
+    scopeListClipped: z.ZodBoolean;
+}, z.core.$loose>;
+export declare const MENTIONS_V2_CHANNEL = "cross-references-mentions-v2-changed";
+export type MentionQueryV2 = z.infer<typeof mentionQueryV2Schema>;
+export type ListMentionsInputV2 = z.infer<typeof listMentionsInputV2Schema>;
+export type ListMentionsOutputV2 = z.infer<typeof listMentionsOutputV2Schema>;
+export type ResolveLookupInputV2 = z.infer<typeof resolveLookupInputV2Schema>;
+export type ResolveLookupOutputV2 = z.infer<typeof resolveLookupOutputV2Schema>;
+export type ExcerptRecordV2 = z.infer<typeof excerptRecordV2Schema>;
+export type ExcerptV2 = z.infer<typeof excerptV2Schema>;
+export type MentionsChangedV2 = z.infer<typeof mentionsChangedV2Schema>;