@spotpatch/shared 1.8.0 → 1.10.0

package/dist/external-handoff-CWoooqhp.d.cts

@@ -0,0 +1,720 @@
+import { z } from 'zod';
+
+interface ContextBudget {
+    readonly totalCharacters: number;
+    readonly domCharacters: number;
+    readonly cssCharacters: number;
+    readonly codeCharacters: number;
+    readonly maxCodeLines: number;
+    readonly maxComponentDepth: number;
+}
+interface CodeContext {
+    readonly relativePath: string;
+    readonly language: "tsx" | "jsx";
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly excerpt: string;
+    readonly boundary: "component" | "nearby-lines";
+}
+
+type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
+type SourceOrigin = "jsx-host" | "react-fiber" | "dom-ancestor" | "none";
+interface SourceRef {
+    readonly fileId?: string;
+    readonly relativePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly origin: SourceOrigin;
+    readonly confidence: SourceConfidence;
+}
+interface ReactContext {
+    readonly supported: boolean;
+    readonly version?: string;
+    readonly componentName?: string;
+    readonly componentSourceId?: string;
+    readonly sourceVersion?: string;
+    readonly componentStack: readonly string[];
+    readonly source?: SourceRef;
+}
+
+interface MatchedStyleRule {
+    readonly selector: string;
+    readonly declarations: string;
+    readonly source?: string;
+    readonly media?: string;
+}
+interface StyleContext {
+    readonly classNames: readonly string[];
+    readonly inlineStyle?: string;
+    readonly matchedRules: readonly MatchedStyleRule[];
+    readonly computed: Readonly<Record<string, string>>;
+    readonly warnings: readonly string[];
+}
+
+interface PageContext {
+    readonly url: string;
+    readonly pathname: string;
+    readonly title: string;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    readonly devicePixelRatio: number;
+}
+interface ElementContext {
+    readonly tagName: string;
+    readonly selector: string;
+    readonly sanitizedHtml: string;
+    readonly textPreview?: string;
+    readonly role?: string;
+    readonly rect: Readonly<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+/** Protocol hard limit. Runtime configuration may choose a smaller limit. */
+declare const MAX_ANNOTATION_TARGETS = 20;
+/** Each target owns its requested change; the UI enforces the same bound. */
+declare const MAX_TARGET_INSTRUCTION_CHARACTERS = 2000;
+/** Keeps the complete, atomic user intent within the prompt and request budgets. */
+declare const MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4000;
+declare const SPOTPATCH_LOCALES: readonly ["en-US", "zh-CN"];
+type SpotPatchLocale = (typeof SPOTPATCH_LOCALES)[number];
+declare const SPOTPATCH_LOCALE_PREFERENCES: readonly ["auto", "en-US", "zh-CN"];
+type SpotPatchLocalePreference = (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];
+interface SpotTargetContext {
+    readonly instruction: string;
+    readonly page?: Readonly<PageContext>;
+    readonly source: SourceRef;
+    readonly react: ReactContext;
+    readonly element: ElementContext;
+    readonly styles: StyleContext;
+    readonly code?: CodeContext;
+    readonly warnings: readonly string[];
+}
+interface SpotAnnotation {
+    readonly schemaVersion: 3;
+    readonly id: string;
+    readonly locale: SpotPatchLocale;
+    readonly page: Readonly<PageContext>;
+    readonly targets: readonly SpotTargetContext[];
+    readonly createdAt: string;
+}
+
+declare const EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION: 1;
+declare const EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION: 2;
+declare const EXTERNAL_HANDOFF_STATES: readonly ["available", "expired", "superseded"];
+declare const EXTERNAL_HANDOFF_FRAMEWORKS: readonly ["vite", "next"];
+declare const EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS: readonly ["claude-channel", "codex-app-server"];
+declare const EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES: readonly ["ready", "busy", "blocked"];
+declare const EXTERNAL_HANDOFF_DISPATCH_PHASES: readonly ["queued", "dispatching", "dispatched", "working", "completed", "failed", "delivery-unknown"];
+declare const EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES: readonly ["dispatching", "dispatched", "working", "completed", "failed", "delivery-unknown"];
+declare const EXTERNAL_HANDOFF_LIMITS: Readonly<{
+    readonly maximumSnapshotBytes: number;
+    readonly maximumPublishBodyBytes: number;
+    readonly maximumBrokerRequestBytes: number;
+    readonly maximumDescriptorBytes: number;
+    readonly maximumHistorySummaries: 8;
+    readonly maximumConnectorReceipts: 64;
+    readonly handoffTtlMs: number;
+    readonly defaultWaitMs: 20000;
+    readonly maximumWaitMs: 25000;
+    readonly maximumWaiters: 8;
+    readonly maximumDescriptorsPerScan: 32;
+    readonly maximumProjectAncestors: 64;
+    readonly maximumBrokerHeaderBytes: number;
+    readonly maximumBrokerSockets: 32;
+    readonly brokerDiscoveryTimeoutMs: 750;
+    readonly brokerRequestTimeoutMs: 2000;
+    readonly brokerWaitGraceMs: 2000;
+    readonly maximumSetupConfigBytes: number;
+    readonly maximumRequestIdRecords: 16;
+    readonly requestIdTtlMs: number;
+    readonly activeHeartbeatIntervalMs: 3000;
+    readonly activeLeaseDurationMs: 10000;
+    readonly activeTransportWriteTimeoutMs: 5000;
+    readonly activeDispatchTimeoutMs: number;
+    readonly activeStatusPollMs: 1000;
+}>;
+type ExternalHandoffState = (typeof EXTERNAL_HANDOFF_STATES)[number];
+type ExternalHandoffFramework = (typeof EXTERNAL_HANDOFF_FRAMEWORKS)[number];
+type ExternalHandoffActiveAdapterKind = (typeof EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS)[number];
+type ExternalHandoffActiveAdapterState = (typeof EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES)[number];
+type ExternalHandoffDispatchPhase = (typeof EXTERNAL_HANDOFF_DISPATCH_PHASES)[number];
+type ExternalHandoffReportableDispatchPhase = (typeof EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES)[number];
+
+declare const externalHandoffReportableDispatchPhaseSchema: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    dispatching: "dispatching";
+    dispatched: "dispatched";
+    working: "working";
+    "delivery-unknown": "delivery-unknown";
+}>;
+declare const externalHandoffSummarySchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    framework: z.ZodEnum<{
+        vite: "vite";
+        next: "next";
+    }>;
+    revision: z.ZodNumber;
+    cursor: z.ZodString;
+    targetCount: z.ZodNumber;
+    page: z.ZodObject<{
+        origin: z.ZodString;
+        pathname: z.ZodString;
+    }, z.core.$strict>;
+    publishedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+    state: z.ZodEnum<{
+        available: "available";
+        expired: "expired";
+        superseded: "superseded";
+    }>;
+    pickupCount: z.ZodNumber;
+    pickedUpAt: z.ZodOptional<z.ZodISODateTime>;
+}, z.core.$strict>;
+declare const externalHandoffSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    cursor: z.ZodString;
+    session: z.ZodObject<{
+        id: z.ZodString;
+        framework: z.ZodEnum<{
+            vite: "vite";
+            next: "next";
+        }>;
+    }, z.core.$strict>;
+    revision: z.ZodNumber;
+    publishedAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+    annotation: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<3>;
+        id: z.ZodString;
+        locale: z.ZodEnum<{
+            "en-US": "en-US";
+            "zh-CN": "zh-CN";
+        }>;
+        page: z.ZodObject<{
+            url: z.ZodString;
+            pathname: z.ZodString;
+            title: z.ZodString;
+            viewportWidth: z.ZodNumber;
+            viewportHeight: z.ZodNumber;
+            devicePixelRatio: z.ZodNumber;
+        }, z.core.$strict>;
+        targets: z.ZodArray<z.ZodObject<{
+            instruction: z.ZodString;
+            page: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                pathname: z.ZodString;
+                title: z.ZodString;
+                viewportWidth: z.ZodNumber;
+                viewportHeight: z.ZodNumber;
+                devicePixelRatio: z.ZodNumber;
+            }, z.core.$strict>>;
+            source: z.ZodObject<{
+                fileId: z.ZodOptional<z.ZodString>;
+                relativePath: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+                origin: z.ZodEnum<{
+                    "jsx-host": "jsx-host";
+                    "react-fiber": "react-fiber";
+                    "dom-ancestor": "dom-ancestor";
+                    none: "none";
+                }>;
+                confidence: z.ZodEnum<{
+                    exact: "exact";
+                    probable: "probable";
+                    approximate: "approximate";
+                    unknown: "unknown";
+                }>;
+            }, z.core.$strict>;
+            react: z.ZodObject<{
+                supported: z.ZodBoolean;
+                version: z.ZodOptional<z.ZodString>;
+                componentName: z.ZodOptional<z.ZodString>;
+                componentSourceId: z.ZodOptional<z.ZodString>;
+                sourceVersion: z.ZodOptional<z.ZodString>;
+                componentStack: z.ZodArray<z.ZodString>;
+                source: z.ZodOptional<z.ZodObject<{
+                    fileId: z.ZodOptional<z.ZodString>;
+                    relativePath: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                    origin: z.ZodEnum<{
+                        "jsx-host": "jsx-host";
+                        "react-fiber": "react-fiber";
+                        "dom-ancestor": "dom-ancestor";
+                        none: "none";
+                    }>;
+                    confidence: z.ZodEnum<{
+                        exact: "exact";
+                        probable: "probable";
+                        approximate: "approximate";
+                        unknown: "unknown";
+                    }>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            element: z.ZodObject<{
+                tagName: z.ZodString;
+                selector: z.ZodString;
+                sanitizedHtml: z.ZodString;
+                textPreview: z.ZodOptional<z.ZodString>;
+                role: z.ZodOptional<z.ZodString>;
+                rect: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            styles: z.ZodObject<{
+                classNames: z.ZodArray<z.ZodString>;
+                inlineStyle: z.ZodOptional<z.ZodString>;
+                matchedRules: z.ZodArray<z.ZodObject<{
+                    selector: z.ZodString;
+                    declarations: z.ZodString;
+                    source: z.ZodOptional<z.ZodString>;
+                    media: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                computed: z.ZodRecord<z.ZodString, z.ZodString>;
+                warnings: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            code: z.ZodOptional<z.ZodObject<{
+                relativePath: z.ZodString;
+                language: z.ZodEnum<{
+                    tsx: "tsx";
+                    jsx: "jsx";
+                }>;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                excerpt: z.ZodString;
+                boundary: z.ZodEnum<{
+                    component: "component";
+                    "nearby-lines": "nearby-lines";
+                }>;
+            }, z.core.$strict>>;
+            warnings: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const activeAdapterSummarySchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "claude-channel": "claude-channel";
+        "codex-app-server": "codex-app-server";
+    }>;
+    state: z.ZodEnum<{
+        ready: "ready";
+        blocked: "blocked";
+        busy: "busy";
+    }>;
+    canDispatch: z.ZodBoolean;
+    connectedAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const dispatchSummarySchema: z.ZodObject<{
+    adapterKind: z.ZodEnum<{
+        "claude-channel": "claude-channel";
+        "codex-app-server": "codex-app-server";
+    }>;
+    revision: z.ZodNumber;
+    phase: z.ZodEnum<{
+        queued: "queued";
+        completed: "completed";
+        failed: "failed";
+        dispatching: "dispatching";
+        dispatched: "dispatched";
+        working: "working";
+        "delivery-unknown": "delivery-unknown";
+    }>;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const externalHandoffCapabilityRequestSchema: z.ZodObject<{}, z.core.$strict>;
+declare const externalHandoffPublishRequestSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    annotation: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<3>;
+        id: z.ZodString;
+        locale: z.ZodEnum<{
+            "en-US": "en-US";
+            "zh-CN": "zh-CN";
+        }>;
+        page: z.ZodObject<{
+            url: z.ZodString;
+            pathname: z.ZodString;
+            title: z.ZodString;
+            viewportWidth: z.ZodNumber;
+            viewportHeight: z.ZodNumber;
+            devicePixelRatio: z.ZodNumber;
+        }, z.core.$strict>;
+        targets: z.ZodArray<z.ZodObject<{
+            instruction: z.ZodString;
+            page: z.ZodOptional<z.ZodObject<{
+                url: z.ZodString;
+                pathname: z.ZodString;
+                title: z.ZodString;
+                viewportWidth: z.ZodNumber;
+                viewportHeight: z.ZodNumber;
+                devicePixelRatio: z.ZodNumber;
+            }, z.core.$strict>>;
+            source: z.ZodObject<{
+                fileId: z.ZodOptional<z.ZodString>;
+                relativePath: z.ZodOptional<z.ZodString>;
+                line: z.ZodOptional<z.ZodNumber>;
+                column: z.ZodOptional<z.ZodNumber>;
+                origin: z.ZodEnum<{
+                    "jsx-host": "jsx-host";
+                    "react-fiber": "react-fiber";
+                    "dom-ancestor": "dom-ancestor";
+                    none: "none";
+                }>;
+                confidence: z.ZodEnum<{
+                    exact: "exact";
+                    probable: "probable";
+                    approximate: "approximate";
+                    unknown: "unknown";
+                }>;
+            }, z.core.$strict>;
+            react: z.ZodObject<{
+                supported: z.ZodBoolean;
+                version: z.ZodOptional<z.ZodString>;
+                componentName: z.ZodOptional<z.ZodString>;
+                componentSourceId: z.ZodOptional<z.ZodString>;
+                sourceVersion: z.ZodOptional<z.ZodString>;
+                componentStack: z.ZodArray<z.ZodString>;
+                source: z.ZodOptional<z.ZodObject<{
+                    fileId: z.ZodOptional<z.ZodString>;
+                    relativePath: z.ZodOptional<z.ZodString>;
+                    line: z.ZodOptional<z.ZodNumber>;
+                    column: z.ZodOptional<z.ZodNumber>;
+                    origin: z.ZodEnum<{
+                        "jsx-host": "jsx-host";
+                        "react-fiber": "react-fiber";
+                        "dom-ancestor": "dom-ancestor";
+                        none: "none";
+                    }>;
+                    confidence: z.ZodEnum<{
+                        exact: "exact";
+                        probable: "probable";
+                        approximate: "approximate";
+                        unknown: "unknown";
+                    }>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>;
+            element: z.ZodObject<{
+                tagName: z.ZodString;
+                selector: z.ZodString;
+                sanitizedHtml: z.ZodString;
+                textPreview: z.ZodOptional<z.ZodString>;
+                role: z.ZodOptional<z.ZodString>;
+                rect: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>;
+            styles: z.ZodObject<{
+                classNames: z.ZodArray<z.ZodString>;
+                inlineStyle: z.ZodOptional<z.ZodString>;
+                matchedRules: z.ZodArray<z.ZodObject<{
+                    selector: z.ZodString;
+                    declarations: z.ZodString;
+                    source: z.ZodOptional<z.ZodString>;
+                    media: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>>;
+                computed: z.ZodRecord<z.ZodString, z.ZodString>;
+                warnings: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            code: z.ZodOptional<z.ZodObject<{
+                relativePath: z.ZodString;
+                language: z.ZodEnum<{
+                    tsx: "tsx";
+                    jsx: "jsx";
+                }>;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                excerpt: z.ZodString;
+                boundary: z.ZodEnum<{
+                    component: "component";
+                    "nearby-lines": "nearby-lines";
+                }>;
+            }, z.core.$strict>>;
+            warnings: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const externalHandoffStatusRequestSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const externalHandoffResolveDeliveryRequestSchema: z.ZodObject<{
+    cursor: z.ZodString;
+    confirmation: z.ZodLiteral<"workspace-reviewed">;
+}, z.core.$strict>;
+declare const externalHandoffCapabilitySchema: z.ZodObject<{
+    enabled: z.ZodLiteral<true>;
+    brokerReady: z.ZodBoolean;
+    activeWaitCount: z.ZodNumber;
+    snapshotSchemaVersion: z.ZodLiteral<1>;
+    brokerProtocolVersion: z.ZodLiteral<2>;
+    activeAdapter: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            blocked: "blocked";
+            busy: "busy";
+        }>;
+        canDispatch: z.ZodBoolean;
+        connectedAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    dispatch: z.ZodNullable<z.ZodObject<{
+        adapterKind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        revision: z.ZodNumber;
+        phase: z.ZodEnum<{
+            queued: "queued";
+            completed: "completed";
+            failed: "failed";
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            "delivery-unknown": "delivery-unknown";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    mode: z.ZodLiteral<"inbox">;
+}, z.core.$strict>, z.ZodObject<{
+    mode: z.ZodLiteral<"active">;
+    adapter: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            blocked: "blocked";
+            busy: "busy";
+        }>;
+        canDispatch: z.ZodBoolean;
+        connectedAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    dispatch: z.ZodObject<{
+        adapterKind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        revision: z.ZodNumber;
+        phase: z.ZodEnum<{
+            queued: "queued";
+            completed: "completed";
+            failed: "failed";
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            "delivery-unknown": "delivery-unknown";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>], "mode">;
+declare const externalHandoffPublishResultSchema: z.ZodObject<{
+    handoff: z.ZodObject<{
+        sessionId: z.ZodString;
+        framework: z.ZodEnum<{
+            vite: "vite";
+            next: "next";
+        }>;
+        revision: z.ZodNumber;
+        cursor: z.ZodString;
+        targetCount: z.ZodNumber;
+        page: z.ZodObject<{
+            origin: z.ZodString;
+            pathname: z.ZodString;
+        }, z.core.$strict>;
+        publishedAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            available: "available";
+            expired: "expired";
+            superseded: "superseded";
+        }>;
+        pickupCount: z.ZodNumber;
+        pickedUpAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    delivery: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        mode: z.ZodLiteral<"inbox">;
+    }, z.core.$strict>, z.ZodObject<{
+        mode: z.ZodLiteral<"active">;
+        adapter: z.ZodObject<{
+            kind: z.ZodEnum<{
+                "claude-channel": "claude-channel";
+                "codex-app-server": "codex-app-server";
+            }>;
+            state: z.ZodEnum<{
+                ready: "ready";
+                blocked: "blocked";
+                busy: "busy";
+            }>;
+            canDispatch: z.ZodBoolean;
+            connectedAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+        dispatch: z.ZodObject<{
+            adapterKind: z.ZodEnum<{
+                "claude-channel": "claude-channel";
+                "codex-app-server": "codex-app-server";
+            }>;
+            revision: z.ZodNumber;
+            phase: z.ZodEnum<{
+                queued: "queued";
+                completed: "completed";
+                failed: "failed";
+                dispatching: "dispatching";
+                dispatched: "dispatched";
+                working: "working";
+                "delivery-unknown": "delivery-unknown";
+            }>;
+            updatedAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+    }, z.core.$strict>], "mode">;
+    replayed: z.ZodBoolean;
+}, z.core.$strict>;
+declare const externalHandoffStatusResultSchema: z.ZodObject<{
+    handoff: z.ZodObject<{
+        sessionId: z.ZodString;
+        framework: z.ZodEnum<{
+            vite: "vite";
+            next: "next";
+        }>;
+        revision: z.ZodNumber;
+        cursor: z.ZodString;
+        targetCount: z.ZodNumber;
+        page: z.ZodObject<{
+            origin: z.ZodString;
+            pathname: z.ZodString;
+        }, z.core.$strict>;
+        publishedAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+        state: z.ZodEnum<{
+            available: "available";
+            expired: "expired";
+            superseded: "superseded";
+        }>;
+        pickupCount: z.ZodNumber;
+        pickedUpAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strict>;
+    activeAdapter: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            blocked: "blocked";
+            busy: "busy";
+        }>;
+        canDispatch: z.ZodBoolean;
+        connectedAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+    dispatch: z.ZodNullable<z.ZodObject<{
+        adapterKind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        revision: z.ZodNumber;
+        phase: z.ZodEnum<{
+            queued: "queued";
+            completed: "completed";
+            failed: "failed";
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            "delivery-unknown": "delivery-unknown";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+interface ExternalHandoffSummary {
+    readonly sessionId: string;
+    readonly framework: ExternalHandoffFramework;
+    readonly revision: number;
+    readonly cursor: string;
+    readonly targetCount: number;
+    readonly page: Readonly<{
+        origin: string;
+        pathname: string;
+    }>;
+    readonly publishedAt: string;
+    readonly expiresAt: string;
+    readonly state: ExternalHandoffState;
+    readonly pickupCount: number;
+    readonly pickedUpAt?: string | undefined;
+}
+interface ExternalHandoffSnapshot {
+    readonly schemaVersion: typeof EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION;
+    readonly cursor: string;
+    readonly session: Readonly<{
+        id: string;
+        framework: ExternalHandoffFramework;
+    }>;
+    readonly revision: number;
+    readonly publishedAt: string;
+    readonly expiresAt: string;
+    readonly annotation: SpotAnnotation;
+}
+interface ActiveAdapterSummary {
+    readonly kind: ExternalHandoffActiveAdapterKind;
+    readonly state: ExternalHandoffActiveAdapterState;
+    readonly canDispatch: boolean;
+    readonly connectedAt: string;
+    readonly updatedAt: string;
+}
+interface DispatchSummary {
+    readonly adapterKind: ExternalHandoffActiveAdapterKind;
+    readonly revision: number;
+    readonly phase: ExternalHandoffDispatchPhase;
+    readonly updatedAt: string;
+}
+type ExternalHandoffPublishDelivery = Readonly<{
+    mode: "inbox";
+}> | Readonly<{
+    mode: "active";
+    adapter: ActiveAdapterSummary;
+    dispatch: DispatchSummary;
+}>;
+interface ExternalHandoffPublishResult {
+    readonly handoff: ExternalHandoffSummary;
+    readonly delivery: ExternalHandoffPublishDelivery;
+    readonly replayed: boolean;
+}
+interface ExternalHandoffStatusResult {
+    readonly handoff: ExternalHandoffSummary;
+    readonly activeAdapter: ActiveAdapterSummary | null;
+    readonly dispatch: DispatchSummary | null;
+}
+interface ExternalHandoffCapability {
+    readonly enabled: true;
+    readonly brokerReady: boolean;
+    readonly activeWaitCount: number;
+    readonly snapshotSchemaVersion: typeof EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION;
+    readonly brokerProtocolVersion: typeof EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION;
+    readonly activeAdapter: ActiveAdapterSummary | null;
+    readonly dispatch: DispatchSummary | null;
+}
+type ExternalHandoffPublishRequest = z.infer<typeof externalHandoffPublishRequestSchema>;
+type ExternalHandoffStatusRequest = z.infer<typeof externalHandoffStatusRequestSchema>;
+type ExternalHandoffResolveDeliveryRequest = z.infer<typeof externalHandoffResolveDeliveryRequestSchema>;
+
+export { externalHandoffResolveDeliveryRequestSchema as $, type ActiveAdapterSummary as A, type ElementContext as B, type ContextBudget as C, type DispatchSummary as D, EXTERNAL_HANDOFF_LIMITS as E, MAX_ANNOTATION_TARGETS as F, MAX_TARGET_INSTRUCTION_CHARACTERS as G, type MatchedStyleRule as H, SPOTPATCH_LOCALES as I, type SourceConfidence as J, type SourceOrigin as K, type SourceRef as L, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type SpotPatchLocalePreference as N, type SpotTargetContext as O, type PageContext as P, type StyleContext as Q, type ReactContext as R, type SpotAnnotation as S, activeAdapterSummarySchema as T, dispatchSummarySchema as U, externalHandoffCapabilityRequestSchema as V, externalHandoffCapabilitySchema as W, externalHandoffPublishDeliverySchema as X, externalHandoffPublishRequestSchema as Y, externalHandoffPublishResultSchema as Z, externalHandoffReportableDispatchPhaseSchema as _, type ExternalHandoffSnapshot as a, externalHandoffSnapshotSchema as a0, externalHandoffStatusRequestSchema as a1, externalHandoffStatusResultSchema as a2, externalHandoffSummarySchema as a3, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS as b, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES as c, EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION as d, EXTERNAL_HANDOFF_DISPATCH_PHASES as e, EXTERNAL_HANDOFF_FRAMEWORKS as f, EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES as g, EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION as h, EXTERNAL_HANDOFF_STATES as i, type ExternalHandoffActiveAdapterKind as j, type ExternalHandoffActiveAdapterState as k, type ExternalHandoffCapability as l, type ExternalHandoffDispatchPhase as m, type ExternalHandoffFramework as n, type ExternalHandoffPublishDelivery as o, type ExternalHandoffPublishRequest as p, type ExternalHandoffPublishResult as q, type ExternalHandoffReportableDispatchPhase as r, type ExternalHandoffResolveDeliveryRequest as s, type ExternalHandoffState as t, type ExternalHandoffStatusRequest as u, type ExternalHandoffStatusResult as v, type ExternalHandoffSummary as w, type SpotPatchLocale as x, SPOTPATCH_LOCALE_PREFERENCES as y, type CodeContext as z };