@spotpatch/shared 1.9.0 → 1.11.0

package/dist/external-agent-node.d.cts

@@ -0,0 +1,556 @@
+import { z } from 'zod';
+import { E as EXTERNAL_HANDOFF_LIMITS, A as ActiveAdapterSummary, D as DispatchSummary, a as ExternalHandoffSnapshot } from './external-handoff--lT9XQEw.cjs';
+
+declare const SPOTPATCH_BRIDGE_TOKEN_HEADER: "X-SpotPatch-Bridge-Token";
+declare const SPOTPATCH_BRIDGE_PATHS: Readonly<{
+    status: "/bridge/v1/status";
+    current: "/bridge/v1/handoff/current";
+    wait: "/bridge/v1/handoff/wait";
+    ack: "/bridge/v1/handoff/ack";
+    activeClaim: "/bridge/v1/active/claim";
+    activeHeartbeat: "/bridge/v1/active/heartbeat";
+    activeReport: "/bridge/v1/active/report";
+    activeRelease: "/bridge/v1/active/release";
+}>;
+declare const EXTERNAL_HANDOFF_PROJECT_KEY_SALT: "spotpatch-external-agent-project-v1";
+declare const externalHandoffDescriptorSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    brokerProtocolVersion: z.ZodLiteral<2>;
+    projectKey: z.ZodString;
+    sessionId: z.ZodString;
+    framework: z.ZodEnum<{
+        vite: "vite";
+        next: "next";
+    }>;
+    endpoint: z.ZodURL;
+    bridgeToken: z.ZodString;
+    pid: z.ZodNumber;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const bridgeStatusRequestSchema: z.ZodObject<{}, z.core.$strict>;
+declare const bridgeCurrentRequestSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const bridgeWaitRequestSchema: z.ZodObject<{
+    afterCursor: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>;
+declare const bridgeAckRequestSchema: z.ZodObject<{
+    cursor: z.ZodString;
+    connectorInstanceId: z.ZodString;
+}, z.core.$strict>;
+declare const bridgeActiveClaimRequestSchema: z.ZodObject<{
+    adapterKind: z.ZodEnum<{
+        "claude-channel": "claude-channel";
+        "codex-app-server": "codex-app-server";
+    }>;
+    connectorInstanceId: z.ZodString;
+}, z.core.$strict>;
+declare const bridgeActiveHeartbeatRequestSchema: z.ZodObject<{
+    leaseToken: z.ZodString;
+}, z.core.$strict>;
+declare const bridgeActiveReportRequestSchema: z.ZodObject<{
+    leaseToken: z.ZodString;
+    cursor: z.ZodString;
+    phase: z.ZodEnum<{
+        dispatching: "dispatching";
+        dispatched: "dispatched";
+        working: "working";
+        completed: "completed";
+        failed: "failed";
+        "delivery-unknown": "delivery-unknown";
+    }>;
+}, z.core.$strict>;
+declare const bridgeActiveReleaseRequestSchema: z.ZodObject<{
+    leaseToken: z.ZodString;
+}, z.core.$strict>;
+declare const bridgeStatusSchema: z.ZodObject<{
+    brokerProtocolVersion: z.ZodLiteral<2>;
+    projectKey: z.ZodString;
+    sessionId: z.ZodString;
+    framework: z.ZodEnum<{
+        vite: "vite";
+        next: "next";
+    }>;
+    current: z.ZodNullable<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>>;
+}, z.core.$strict>;
+declare const bridgeCurrentResultSchema: z.ZodObject<{
+    outcome: z.ZodLiteral<"handoff">;
+    snapshot: 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>;
+}, z.core.$strict>;
+declare const bridgeWaitResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    outcome: z.ZodLiteral<"handoff">;
+    snapshot: 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>;
+}, z.core.$strict>, z.ZodObject<{
+    outcome: z.ZodLiteral<"timeout">;
+}, z.core.$strict>], "outcome">;
+declare const bridgeAckResultSchema: z.ZodObject<{
+    summary: 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>;
+}, z.core.$strict>;
+declare const bridgeActiveClaimResultSchema: z.ZodObject<{
+    leaseToken: z.ZodString;
+    heartbeatIntervalMs: z.ZodLiteral<3000>;
+    baselineCursor: z.ZodNullable<z.ZodString>;
+    activeAdapter: z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            busy: "busy";
+            blocked: "blocked";
+        }>;
+        canDispatch: z.ZodBoolean;
+        connectedAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const bridgeActiveStateResultSchema: z.ZodObject<{
+    activeAdapter: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            busy: "busy";
+            blocked: "blocked";
+        }>;
+        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<{
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            completed: "completed";
+            failed: "failed";
+            "delivery-unknown": "delivery-unknown";
+            queued: "queued";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const bridgeActiveHeartbeatResultSchema: z.ZodObject<{
+    activeAdapter: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            busy: "busy";
+            blocked: "blocked";
+        }>;
+        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<{
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            completed: "completed";
+            failed: "failed";
+            "delivery-unknown": "delivery-unknown";
+            queued: "queued";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const bridgeActiveReportResultSchema: z.ZodObject<{
+    activeAdapter: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            busy: "busy";
+            blocked: "blocked";
+        }>;
+        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<{
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            completed: "completed";
+            failed: "failed";
+            "delivery-unknown": "delivery-unknown";
+            queued: "queued";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const bridgeActiveReleaseResultSchema: z.ZodObject<{
+    activeAdapter: z.ZodNullable<z.ZodObject<{
+        kind: z.ZodEnum<{
+            "claude-channel": "claude-channel";
+            "codex-app-server": "codex-app-server";
+        }>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            busy: "busy";
+            blocked: "blocked";
+        }>;
+        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<{
+            dispatching: "dispatching";
+            dispatched: "dispatched";
+            working: "working";
+            completed: "completed";
+            failed: "failed";
+            "delivery-unknown": "delivery-unknown";
+            queued: "queued";
+        }>;
+        updatedAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type ExternalHandoffDescriptor = z.infer<typeof externalHandoffDescriptorSchema>;
+type BridgeStatus = z.infer<typeof bridgeStatusSchema>;
+type BridgeWaitResult = Readonly<{
+    outcome: "handoff";
+    snapshot: ExternalHandoffSnapshot;
+}> | Readonly<{
+    outcome: "timeout";
+}>;
+interface BridgeActiveClaimResult {
+    readonly leaseToken: string;
+    readonly heartbeatIntervalMs: typeof EXTERNAL_HANDOFF_LIMITS.activeHeartbeatIntervalMs;
+    readonly baselineCursor: string | null;
+    readonly activeAdapter: ActiveAdapterSummary;
+}
+interface BridgeActiveStateResult {
+    readonly activeAdapter: ActiveAdapterSummary | null;
+    readonly dispatch: DispatchSummary | null;
+}
+declare function resolveExternalHandoffRuntimeDirectory(create: boolean): Promise<string>;
+declare function computeExternalHandoffProjectKey(root: string): Promise<string>;
+
+export { type BridgeActiveClaimResult, type BridgeActiveStateResult, type BridgeStatus, type BridgeWaitResult, EXTERNAL_HANDOFF_PROJECT_KEY_SALT, type ExternalHandoffDescriptor, SPOTPATCH_BRIDGE_PATHS, SPOTPATCH_BRIDGE_TOKEN_HEADER, bridgeAckRequestSchema, bridgeAckResultSchema, bridgeActiveClaimRequestSchema, bridgeActiveClaimResultSchema, bridgeActiveHeartbeatRequestSchema, bridgeActiveHeartbeatResultSchema, bridgeActiveReleaseRequestSchema, bridgeActiveReleaseResultSchema, bridgeActiveReportRequestSchema, bridgeActiveReportResultSchema, bridgeActiveStateResultSchema, bridgeCurrentRequestSchema, bridgeCurrentResultSchema, bridgeStatusRequestSchema, bridgeStatusSchema, bridgeWaitRequestSchema, bridgeWaitResultSchema, computeExternalHandoffProjectKey, externalHandoffDescriptorSchema, resolveExternalHandoffRuntimeDirectory };