@blokjs/shared 2.0.1 → 2.2.0

package/dist/GraphContracts.d.ts

@@ -0,0 +1,1643 @@
+import { z } from "zod";
+import type { RepositoryIdentity } from "./WorkflowBindingContracts.js";
+/** Version of the provider-neutral graph contract. */
+export declare const GRAPH_CONTRACT_VERSION: "1";
+export declare const GRAPH_RESULT_STATES: readonly ["fresh", "stale", "missing", "truncated", "partial", "unsupported", "conflict"];
+export declare const GRAPH_FRESHNESS_STATES: readonly ["fresh", "stale", "unknown"];
+export declare const GRAPH_RELATION_KINDS: readonly ["defines", "contains", "calls", "imports", "exports", "references", "extends", "implements", "overrides", "tests"];
+export declare const GRAPH_SYMBOL_KINDS: readonly ["file", "module", "namespace", "class", "interface", "enum", "function", "method", "property", "variable", "type", "unknown"];
+export declare const GRAPH_SEARCH_KINDS: readonly ["symbol", "file", "module", "text"];
+export declare const GRAPH_INDEX_SOURCES: readonly ["authoritative", "uncommitted-overlay", "provider"];
+export declare const GRAPH_RELATION_DIRECTIONS: readonly ["inbound", "outbound", "both"];
+export declare const GRAPH_MAX_STRING_LENGTH = 512;
+export declare const GRAPH_MAX_PATH_LENGTH = 1024;
+export declare const GRAPH_MAX_ITEMS = 500;
+export declare const GRAPH_MAX_FILES_PER_INDEX = 500;
+export declare const GRAPH_MAX_INDEX_BYTES: number;
+export declare const GRAPH_MAX_RESPONSE_BYTES: number;
+export declare const GRAPH_MAX_DEPTH = 32;
+export type GraphResultState = (typeof GRAPH_RESULT_STATES)[number];
+export type GraphFreshnessState = (typeof GRAPH_FRESHNESS_STATES)[number];
+export type GraphRelationKind = (typeof GRAPH_RELATION_KINDS)[number];
+export type GraphSymbolKind = (typeof GRAPH_SYMBOL_KINDS)[number];
+export type GraphSearchKind = (typeof GRAPH_SEARCH_KINDS)[number];
+export type GraphIndexSource = (typeof GRAPH_INDEX_SOURCES)[number];
+export type GraphRelationDirection = (typeof GRAPH_RELATION_DIRECTIONS)[number];
+/** Graph scope reuses the provider-neutral repository identity from bindings. */
+export type GraphRepositoryIdentity = RepositoryIdentity;
+export interface GraphWorktreeIdentity {
+    readonly id: string;
+    readonly branch?: string;
+    readonly commit?: string;
+    readonly dirty?: boolean;
+    readonly overlay?: "clean" | "uncommitted" | "unknown";
+}
+export interface GraphScope {
+    readonly repository: GraphRepositoryIdentity;
+    readonly worktree?: GraphWorktreeIdentity;
+    readonly commit?: string;
+    /** Known current hashes keyed by normalized repository-relative path. */
+    readonly contentHashes?: Readonly<Record<string, string>>;
+}
+export interface GraphRange {
+    readonly start: {
+        readonly line: number;
+        readonly column?: number;
+    };
+    readonly end?: {
+        readonly line: number;
+        readonly column?: number;
+    };
+}
+export interface GraphLocation {
+    readonly path: string;
+    readonly range?: GraphRange;
+    readonly language?: string;
+    readonly contentHash?: string;
+}
+/** Evidence that a response came from a particular derived index. */
+export interface GraphProvenance {
+    readonly source: "derived-index";
+    readonly provider: string;
+    readonly providerVersion?: string;
+    readonly indexVersion: string;
+    readonly repository: GraphRepositoryIdentity;
+    readonly worktree?: GraphWorktreeIdentity;
+    readonly commit?: string;
+    readonly contentHash?: string;
+    readonly path?: string;
+    readonly range?: GraphRange;
+    readonly indexedAt?: string;
+}
+export interface GraphFreshness {
+    readonly state: GraphFreshnessState;
+    readonly indexedAt?: string;
+    readonly checkedAt: string;
+    readonly indexedCommit?: string;
+    readonly observedCommit?: string;
+    readonly indexedContentHash?: string;
+    readonly observedContentHash?: string;
+    readonly reason?: string;
+}
+export interface GraphResultStatus {
+    readonly primary: GraphResultState;
+    /** Multiple states are allowed, for example stale + truncated. */
+    readonly states: readonly GraphResultState[];
+    readonly complete: boolean;
+}
+export type GraphErrorCategory = "provider-unavailable" | "invalid-query" | "not-found" | "unsupported" | "stale" | "conflict" | "limit-exceeded" | "cancelled" | "index-failed" | "internal";
+export interface GraphError {
+    readonly code: string;
+    readonly category: GraphErrorCategory;
+    readonly message: string;
+    readonly retryable: boolean;
+    readonly guidance: "reread-authoritative-source" | "retry" | "narrow-query" | "inspect-provider" | "none";
+    readonly path?: string;
+}
+export interface GraphSymbol {
+    readonly id: string;
+    readonly name: string;
+    readonly kind: GraphSymbolKind;
+    readonly location: GraphLocation;
+    readonly language?: string;
+    readonly signature?: string;
+    readonly containerId?: string;
+    readonly exported?: boolean;
+}
+export interface GraphRelation {
+    readonly id: string;
+    readonly from: string;
+    readonly to: string;
+    readonly kind: GraphRelationKind;
+    readonly location?: GraphLocation;
+}
+export interface GraphSearchHit {
+    readonly id: string;
+    readonly kind: GraphSearchKind;
+    readonly name: string;
+    readonly score: number;
+    readonly symbol?: GraphSymbol;
+    readonly location?: GraphLocation;
+}
+export interface GraphQueryResponse<T> {
+    readonly version: typeof GRAPH_CONTRACT_VERSION;
+    /** Graph data is navigation evidence only; it is never mutation authority. */
+    readonly authority: "navigation-only";
+    readonly items: readonly T[];
+    readonly status: GraphResultStatus;
+    readonly freshness: GraphFreshness;
+    readonly provenance?: GraphProvenance;
+    readonly errors: readonly GraphError[];
+    readonly nextCursor?: string;
+}
+export interface GraphSearchRequest {
+    readonly scope: GraphScope;
+    readonly query: string;
+    readonly kinds?: readonly GraphSearchKind[];
+    readonly pathPrefix?: string;
+    readonly limit?: number;
+    readonly cursor?: string;
+}
+export interface GraphSymbolRequest {
+    readonly scope: GraphScope;
+    readonly symbolId?: string;
+    readonly name?: string;
+    readonly path?: string;
+    readonly limit?: number;
+}
+export interface GraphRelationRequest {
+    readonly scope: GraphScope;
+    readonly symbolId: string;
+    readonly direction?: GraphRelationDirection;
+    readonly kinds?: readonly GraphRelationKind[];
+    readonly depth?: number;
+    readonly limit?: number;
+}
+export interface GraphImpactRequest {
+    readonly scope: GraphScope;
+    readonly symbolId: string;
+    readonly direction?: "inbound" | "outbound";
+    readonly relationKinds?: readonly GraphRelationKind[];
+    readonly maxDepth?: number;
+    readonly limit?: number;
+}
+export interface GraphFreshnessRequest {
+    readonly scope: GraphScope;
+    readonly paths?: readonly string[];
+}
+export interface GraphIndexFile {
+    readonly path: string;
+    readonly contentHash: string;
+    readonly source?: GraphIndexSource;
+    readonly language?: string;
+    readonly symbols: readonly GraphSymbol[];
+    readonly relations: readonly GraphRelation[];
+}
+export interface GraphIndexRequest {
+    readonly scope: GraphScope;
+    readonly files: readonly GraphIndexFile[];
+    readonly indexVersion?: string;
+    readonly reason?: "initial" | "changed-files" | "branch-switch" | "committed-patch" | "manual";
+}
+export interface GraphIndexResponse {
+    readonly version: typeof GRAPH_CONTRACT_VERSION;
+    readonly authority: "navigation-only";
+    readonly indexedFiles: readonly string[];
+    readonly skippedFiles: readonly string[];
+    readonly status: GraphResultStatus;
+    readonly freshness: GraphFreshness;
+    readonly provenance?: GraphProvenance;
+    readonly errors: readonly GraphError[];
+}
+export interface GraphQueryOptions {
+    readonly signal?: AbortSignal;
+}
+export interface GraphProvider {
+    readonly id: string;
+    readonly version: string;
+    search(request: GraphSearchRequest, options?: GraphQueryOptions): Promise<GraphQueryResponse<GraphSearchHit>>;
+    findSymbol(request: GraphSymbolRequest, options?: GraphQueryOptions): Promise<GraphQueryResponse<GraphSymbol>>;
+    relations(request: GraphRelationRequest, options?: GraphQueryOptions): Promise<GraphQueryResponse<GraphRelation>>;
+    impact(request: GraphImpactRequest, options?: GraphQueryOptions): Promise<GraphQueryResponse<GraphSymbol>>;
+    freshness(request: GraphFreshnessRequest, options?: GraphQueryOptions): Promise<GraphQueryResponse<GraphLocation>>;
+    index(request: GraphIndexRequest, options?: GraphQueryOptions): Promise<GraphIndexResponse>;
+}
+/**
+ * H3-03 deliberately exposes only a read interface for the authoritative
+ * source. #927 supplies the implementation. No graph provider receives a
+ * write method or a mutation-authorizing return type.
+ */
+export interface AuthoritativeSourceReader {
+    read(request: AuthoritativeSourceReadRequest): Promise<AuthoritativeSourceSnapshot>;
+}
+export interface AuthoritativeSourceReadRequest {
+    readonly scope: GraphScope;
+    readonly path: string;
+    readonly expected?: {
+        readonly commit?: string;
+        readonly contentHash?: string;
+    };
+    readonly signal?: AbortSignal;
+}
+export interface AuthoritativeSourceSnapshot {
+    readonly scope: GraphScope;
+    readonly path: string;
+    readonly contentHash: string;
+    readonly commit?: string;
+    readonly bytes: number;
+    readonly content: string;
+}
+export declare class GraphContractError extends Error {
+    readonly errors: readonly string[];
+    constructor(errors: readonly string[]);
+}
+export declare const GraphRepositoryIdentitySchema: z.ZodObject<{
+    provider: z.ZodString;
+    id: z.ZodString;
+    revision: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    provider: string;
+    revision?: string | undefined;
+}, {
+    id: string;
+    provider: string;
+    revision?: string | undefined;
+}>;
+export declare const GraphWorktreeIdentitySchema: z.ZodObject<{
+    id: z.ZodString;
+    branch: z.ZodOptional<z.ZodString>;
+    commit: z.ZodOptional<z.ZodString>;
+    dirty: z.ZodOptional<z.ZodBoolean>;
+    overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    dirty?: boolean | undefined;
+    commit?: string | undefined;
+    branch?: string | undefined;
+    overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+}, {
+    id: string;
+    dirty?: boolean | undefined;
+    commit?: string | undefined;
+    branch?: string | undefined;
+    overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+}>;
+export declare const GraphScopeSchema: z.ZodObject<{
+    repository: z.ZodObject<{
+        provider: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    }, {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    }>;
+    worktree: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        dirty: z.ZodOptional<z.ZodBoolean>;
+        overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    }, {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    }>>;
+    commit: z.ZodOptional<z.ZodString>;
+    contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+}, "strip", z.ZodTypeAny, {
+    repository: {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    };
+    commit?: string | undefined;
+    worktree?: {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    } | undefined;
+    contentHashes?: Record<string, string> | undefined;
+}, {
+    repository: {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    };
+    commit?: string | undefined;
+    worktree?: {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    } | undefined;
+    contentHashes?: Record<string, string> | undefined;
+}>;
+export declare const GraphRangeSchema: z.ZodObject<{
+    start: z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        column?: number | undefined;
+    }, {
+        line: number;
+        column?: number | undefined;
+    }>;
+    end: z.ZodOptional<z.ZodObject<{
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        line: number;
+        column?: number | undefined;
+    }, {
+        line: number;
+        column?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    start: {
+        line: number;
+        column?: number | undefined;
+    };
+    end?: {
+        line: number;
+        column?: number | undefined;
+    } | undefined;
+}, {
+    start: {
+        line: number;
+        column?: number | undefined;
+    };
+    end?: {
+        line: number;
+        column?: number | undefined;
+    } | undefined;
+}>;
+export declare const GraphLocationSchema: z.ZodObject<{
+    path: z.ZodString;
+    range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column?: number | undefined;
+        }, {
+            line: number;
+            column?: number | undefined;
+        }>;
+        end: z.ZodOptional<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column?: number | undefined;
+        }, {
+            line: number;
+            column?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    }, {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    }>>;
+    language: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    contentHash?: string | undefined;
+    range?: {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    } | undefined;
+    language?: string | undefined;
+}, {
+    path: string;
+    contentHash?: string | undefined;
+    range?: {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    } | undefined;
+    language?: string | undefined;
+}>;
+export declare const GraphProvenanceSchema: z.ZodObject<{
+    source: z.ZodLiteral<"derived-index">;
+    provider: z.ZodString;
+    providerVersion: z.ZodOptional<z.ZodString>;
+    indexVersion: z.ZodString;
+    repository: z.ZodObject<{
+        provider: z.ZodString;
+        id: z.ZodString;
+        revision: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    }, {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    }>;
+    worktree: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        branch: z.ZodOptional<z.ZodString>;
+        commit: z.ZodOptional<z.ZodString>;
+        dirty: z.ZodOptional<z.ZodBoolean>;
+        overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    }, {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    }>>;
+    commit: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    path: z.ZodOptional<z.ZodString>;
+    range: z.ZodOptional<z.ZodObject<{
+        start: z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column?: number | undefined;
+        }, {
+            line: number;
+            column?: number | undefined;
+        }>;
+        end: z.ZodOptional<z.ZodObject<{
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            line: number;
+            column?: number | undefined;
+        }, {
+            line: number;
+            column?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    }, {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    }>>;
+    indexedAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    repository: {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    };
+    provider: string;
+    source: "derived-index";
+    indexVersion: string;
+    path?: string | undefined;
+    commit?: string | undefined;
+    contentHash?: string | undefined;
+    worktree?: {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    } | undefined;
+    range?: {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    } | undefined;
+    providerVersion?: string | undefined;
+    indexedAt?: string | undefined;
+}, {
+    repository: {
+        id: string;
+        provider: string;
+        revision?: string | undefined;
+    };
+    provider: string;
+    source: "derived-index";
+    indexVersion: string;
+    path?: string | undefined;
+    commit?: string | undefined;
+    contentHash?: string | undefined;
+    worktree?: {
+        id: string;
+        dirty?: boolean | undefined;
+        commit?: string | undefined;
+        branch?: string | undefined;
+        overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+    } | undefined;
+    range?: {
+        start: {
+            line: number;
+            column?: number | undefined;
+        };
+        end?: {
+            line: number;
+            column?: number | undefined;
+        } | undefined;
+    } | undefined;
+    providerVersion?: string | undefined;
+    indexedAt?: string | undefined;
+}>;
+export declare const GraphFreshnessSchema: z.ZodObject<{
+    state: z.ZodEnum<["fresh", "stale", "unknown"]>;
+    indexedAt: z.ZodOptional<z.ZodString>;
+    checkedAt: z.ZodString;
+    indexedCommit: z.ZodOptional<z.ZodString>;
+    observedCommit: z.ZodOptional<z.ZodString>;
+    indexedContentHash: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    observedContentHash: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    checkedAt: string;
+    state: "unknown" | "fresh" | "stale";
+    reason?: string | undefined;
+    indexedAt?: string | undefined;
+    indexedCommit?: string | undefined;
+    observedCommit?: string | undefined;
+    indexedContentHash?: string | undefined;
+    observedContentHash?: string | undefined;
+}, {
+    checkedAt: string;
+    state: "unknown" | "fresh" | "stale";
+    reason?: string | undefined;
+    indexedAt?: string | undefined;
+    indexedCommit?: string | undefined;
+    observedCommit?: string | undefined;
+    indexedContentHash?: string | undefined;
+    observedContentHash?: string | undefined;
+}>;
+export declare const GraphResultStatusSchema: z.ZodEffects<z.ZodObject<{
+    primary: z.ZodEnum<["fresh", "stale", "missing", "truncated", "partial", "unsupported", "conflict"]>;
+    states: z.ZodArray<z.ZodEnum<["fresh", "stale", "missing", "truncated", "partial", "unsupported", "conflict"]>, "many">;
+    complete: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    primary: "missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict";
+    states: ("missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict")[];
+    complete: boolean;
+}, {
+    primary: "missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict";
+    states: ("missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict")[];
+    complete: boolean;
+}>, {
+    primary: "missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict";
+    states: ("missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict")[];
+    complete: boolean;
+}, {
+    primary: "missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict";
+    states: ("missing" | "fresh" | "stale" | "truncated" | "partial" | "unsupported" | "conflict")[];
+    complete: boolean;
+}>;
+export declare const GraphErrorSchema: z.ZodObject<{
+    code: z.ZodString;
+    category: z.ZodEnum<["provider-unavailable", "invalid-query", "not-found", "unsupported", "stale", "conflict", "limit-exceeded", "cancelled", "index-failed", "internal"]>;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+    guidance: z.ZodEnum<["reread-authoritative-source", "retry", "narrow-query", "inspect-provider", "none"]>;
+    path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    message: string;
+    category: "cancelled" | "stale" | "unsupported" | "conflict" | "provider-unavailable" | "invalid-query" | "not-found" | "limit-exceeded" | "index-failed" | "internal";
+    retryable: boolean;
+    guidance: "reread-authoritative-source" | "retry" | "narrow-query" | "inspect-provider" | "none";
+    path?: string | undefined;
+}, {
+    code: string;
+    message: string;
+    category: "cancelled" | "stale" | "unsupported" | "conflict" | "provider-unavailable" | "invalid-query" | "not-found" | "limit-exceeded" | "index-failed" | "internal";
+    retryable: boolean;
+    guidance: "reread-authoritative-source" | "retry" | "narrow-query" | "inspect-provider" | "none";
+    path?: string | undefined;
+}>;
+export declare const GraphSymbolSchema: z.ZodType<GraphSymbol, z.ZodTypeDef, GraphSymbol>;
+export declare const GraphRelationSchema: z.ZodType<GraphRelation, z.ZodTypeDef, GraphRelation>;
+export declare const GraphSearchHitSchema: z.ZodType<GraphSearchHit, z.ZodTypeDef, GraphSearchHit>;
+export declare const GraphSearchRequestSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    query: z.ZodString;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["symbol", "file", "module", "text"]>, "many">>;
+    pathPrefix: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    query: string;
+    limit?: number | undefined;
+    kinds?: ("symbol" | "file" | "module" | "text")[] | undefined;
+    pathPrefix?: string | undefined;
+    cursor?: string | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    query: string;
+    limit?: number | undefined;
+    kinds?: ("symbol" | "file" | "module" | "text")[] | undefined;
+    pathPrefix?: string | undefined;
+    cursor?: string | undefined;
+}>;
+export declare const GraphSymbolRequestSchema: z.ZodEffects<z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    symbolId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    path?: string | undefined;
+    limit?: number | undefined;
+    name?: string | undefined;
+    symbolId?: string | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    path?: string | undefined;
+    limit?: number | undefined;
+    name?: string | undefined;
+    symbolId?: string | undefined;
+}>, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    path?: string | undefined;
+    limit?: number | undefined;
+    name?: string | undefined;
+    symbolId?: string | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    path?: string | undefined;
+    limit?: number | undefined;
+    name?: string | undefined;
+    symbolId?: string | undefined;
+}>;
+export declare const GraphRelationRequestSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    symbolId: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<["inbound", "outbound", "both"]>>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["defines", "contains", "calls", "imports", "exports", "references", "extends", "implements", "overrides", "tests"]>, "many">>;
+    depth: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    symbolId: string;
+    limit?: number | undefined;
+    depth?: number | undefined;
+    kinds?: ("defines" | "contains" | "calls" | "imports" | "exports" | "references" | "extends" | "implements" | "overrides" | "tests")[] | undefined;
+    direction?: "inbound" | "outbound" | "both" | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    symbolId: string;
+    limit?: number | undefined;
+    depth?: number | undefined;
+    kinds?: ("defines" | "contains" | "calls" | "imports" | "exports" | "references" | "extends" | "implements" | "overrides" | "tests")[] | undefined;
+    direction?: "inbound" | "outbound" | "both" | undefined;
+}>;
+export declare const GraphImpactRequestSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    symbolId: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<["inbound", "outbound"]>>;
+    relationKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<["defines", "contains", "calls", "imports", "exports", "references", "extends", "implements", "overrides", "tests"]>, "many">>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    symbolId: string;
+    limit?: number | undefined;
+    direction?: "inbound" | "outbound" | undefined;
+    relationKinds?: ("defines" | "contains" | "calls" | "imports" | "exports" | "references" | "extends" | "implements" | "overrides" | "tests")[] | undefined;
+    maxDepth?: number | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    symbolId: string;
+    limit?: number | undefined;
+    direction?: "inbound" | "outbound" | undefined;
+    relationKinds?: ("defines" | "contains" | "calls" | "imports" | "exports" | "references" | "extends" | "implements" | "overrides" | "tests")[] | undefined;
+    maxDepth?: number | undefined;
+}>;
+export declare const GraphFreshnessRequestSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    paths?: string[] | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    paths?: string[] | undefined;
+}>;
+export declare const GraphIndexFileSchema: z.ZodType<GraphIndexFile>;
+export declare const GraphIndexRequestSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    files: z.ZodArray<z.ZodType<GraphIndexFile, z.ZodTypeDef, GraphIndexFile>, "many">;
+    indexVersion: z.ZodOptional<z.ZodString>;
+    reason: z.ZodOptional<z.ZodEnum<["initial", "changed-files", "branch-switch", "committed-patch", "manual"]>>;
+}, "strip", z.ZodTypeAny, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    files: GraphIndexFile[];
+    reason?: "initial" | "changed-files" | "branch-switch" | "committed-patch" | "manual" | undefined;
+    indexVersion?: string | undefined;
+}, {
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    files: GraphIndexFile[];
+    reason?: "initial" | "changed-files" | "branch-switch" | "committed-patch" | "manual" | undefined;
+    indexVersion?: string | undefined;
+}>;
+export declare const AuthoritativeSourceReadRequestSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    path: z.ZodString;
+    expected: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        commit: z.ZodOptional<z.ZodString>;
+        contentHash: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strip", z.ZodTypeAny, {
+        commit?: string | undefined;
+        contentHash?: string | undefined;
+    }, {
+        commit?: string | undefined;
+        contentHash?: string | undefined;
+    }>, {
+        commit?: string | undefined;
+        contentHash?: string | undefined;
+    }, {
+        commit?: string | undefined;
+        contentHash?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    expected?: {
+        commit?: string | undefined;
+        contentHash?: string | undefined;
+    } | undefined;
+}, {
+    path: string;
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    expected?: {
+        commit?: string | undefined;
+        contentHash?: string | undefined;
+    } | undefined;
+}>;
+export declare const AuthoritativeSourceSnapshotSchema: z.ZodObject<{
+    scope: z.ZodObject<{
+        repository: z.ZodObject<{
+            provider: z.ZodString;
+            id: z.ZodString;
+            revision: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }, {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        }>;
+        worktree: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            branch: z.ZodOptional<z.ZodString>;
+            commit: z.ZodOptional<z.ZodString>;
+            dirty: z.ZodOptional<z.ZodBoolean>;
+            overlay: z.ZodOptional<z.ZodEnum<["clean", "uncommitted", "unknown"]>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }, {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        }>>;
+        commit: z.ZodOptional<z.ZodString>;
+        contentHashes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodString, string, string>>>;
+    }, "strip", z.ZodTypeAny, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }, {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    }>;
+    path: z.ZodString;
+    contentHash: z.ZodEffects<z.ZodString, string, string>;
+    commit: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodNumber;
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    contentHash: string;
+    bytes: number;
+    content: string;
+    commit?: string | undefined;
+}, {
+    path: string;
+    scope: {
+        repository: {
+            id: string;
+            provider: string;
+            revision?: string | undefined;
+        };
+        commit?: string | undefined;
+        worktree?: {
+            id: string;
+            dirty?: boolean | undefined;
+            commit?: string | undefined;
+            branch?: string | undefined;
+            overlay?: "unknown" | "clean" | "uncommitted" | undefined;
+        } | undefined;
+        contentHashes?: Record<string, string> | undefined;
+    };
+    contentHash: string;
+    bytes: number;
+    content: string;
+    commit?: string | undefined;
+}>;
+export declare function parseGraphScope(value: unknown): GraphScope;
+export declare function parseGraphSearchRequest(value: unknown): GraphSearchRequest;
+export declare function parseGraphSymbolRequest(value: unknown): GraphSymbolRequest;
+export declare function parseGraphRelationRequest(value: unknown): GraphRelationRequest;
+export declare function parseGraphImpactRequest(value: unknown): GraphImpactRequest;
+export declare function parseGraphFreshnessRequest(value: unknown): GraphFreshnessRequest;
+export declare function parseGraphIndexRequest(value: unknown): GraphIndexRequest;
+export declare function parseAuthoritativeSourceReadRequest(value: unknown): AuthoritativeSourceReadRequest;
+export declare function parseGraphQueryResponse<T>(itemSchema: z.ZodType<T>, value: unknown): GraphQueryResponse<T>;
+export declare function parseGraphIndexResponse(value: unknown): GraphIndexResponse;
+export declare function serializeGraphContract(value: unknown): string;