@spotpatch/shared 1.9.0 → 1.10.0

package/dist/index.d.cts

@@ -1,6 +1,10 @@
-import { R as ReportCompleteness, C as ComponentDataFlowReport, P as PageDataFlowReport, S as SPOTPATCH_API_BASE, a as RuntimeDataFlowConfig } from './data-flow-runtime-zwbvImvl.cjs';
-export { A as AgentJobAction, b as AnalysisBaseline, c as AssociationKind, d as ComponentIdentity, D as DATA_FLOW_ASSOCIATION_KINDS, e as DATA_FLOW_DIAGNOSTIC_CODES, f as DATA_FLOW_EXECUTION_STATES, g as DATA_FLOW_FRESHNESS_STATES, h as DATA_FLOW_PROOF_STATES, i as DATA_FLOW_SCHEMA_VERSION, j as DATA_FLOW_URL_QUERY_KEY_LIMIT, k as DEFAULT_DATA_FLOW_LIMITS, l as DEFAULT_RUNTIME_DATA_FLOW_LIMITS, m as DataDependency, n as DataFlowCapability, o as DataFlowCapabilityReason, p as DataFlowDiagnostic, q as DataFlowDiagnosticCode, r as DataFlowLimits, s as DataParameter, t as DataResponseDescriptor, E as EvidenceRef, u as EvidenceSourceRef, v as ExecutionState, F as FreshnessState, N as NetworkObservation, w as ProofState, x as RequestOrigin, y as RuntimeDataFlowLimits, z as SPOTPATCH_ENDPOINTS, B as SPOTPATCH_TOKEN_HEADER, G as SanitizedObservedUrl, H as componentDataFlowReportSchema, I as dataDependencySchema, J as getAgentJobEndpoint, K as networkObservationSchema, L as pageDataFlowReportSchema, M as runtimeDataFlowConfigSchema } from './data-flow-runtime-zwbvImvl.cjs';
+import { C as ContextBudget, y as SPOTPATCH_LOCALE_PREFERENCES, S as SpotAnnotation } from './external-handoff-CWoooqhp.cjs';
+export { A as ActiveAdapterSummary, z as CodeContext, D as DispatchSummary, b as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS, c as EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES, d as EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION, e as EXTERNAL_HANDOFF_DISPATCH_PHASES, f as EXTERNAL_HANDOFF_FRAMEWORKS, E as EXTERNAL_HANDOFF_LIMITS, g as EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES, h as EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION, i as EXTERNAL_HANDOFF_STATES, B as ElementContext, j as ExternalHandoffActiveAdapterKind, k as ExternalHandoffActiveAdapterState, l as ExternalHandoffCapability, m as ExternalHandoffDispatchPhase, n as ExternalHandoffFramework, o as ExternalHandoffPublishDelivery, p as ExternalHandoffPublishRequest, q as ExternalHandoffPublishResult, r as ExternalHandoffReportableDispatchPhase, s as ExternalHandoffResolveDeliveryRequest, a as ExternalHandoffSnapshot, t as ExternalHandoffState, u as ExternalHandoffStatusRequest, v as ExternalHandoffStatusResult, w as ExternalHandoffSummary, M as MAX_ANNOTATION_INSTRUCTION_CHARACTERS, F as MAX_ANNOTATION_TARGETS, G as MAX_TARGET_INSTRUCTION_CHARACTERS, H as MatchedStyleRule, P as PageContext, R as ReactContext, I as SPOTPATCH_LOCALES, J as SourceConfidence, K as SourceOrigin, L as SourceRef, x as SpotPatchLocale, N as SpotPatchLocalePreference, O as SpotTargetContext, Q as StyleContext, T as activeAdapterSummarySchema, U as dispatchSummarySchema, V as externalHandoffCapabilityRequestSchema, W as externalHandoffCapabilitySchema, X as externalHandoffPublishDeliverySchema, Y as externalHandoffPublishRequestSchema, Z as externalHandoffPublishResultSchema, _ as externalHandoffReportableDispatchPhaseSchema, $ as externalHandoffResolveDeliveryRequestSchema, a0 as externalHandoffSnapshotSchema, a1 as externalHandoffStatusRequestSchema, a2 as externalHandoffStatusResultSchema, a3 as externalHandoffSummarySchema } from './external-handoff-CWoooqhp.cjs';
+import { R as ReportCompleteness, C as ComponentDataFlowReport, P as PageDataFlowReport, a as RuntimeDataFlowConfig } from './data-flow-runtime-BMm3F-eV.cjs';
+export { A as AnalysisBaseline, b as AssociationKind, c as ComponentIdentity, D as DATA_FLOW_ASSOCIATION_KINDS, d as DATA_FLOW_DIAGNOSTIC_CODES, e as DATA_FLOW_EXECUTION_STATES, f as DATA_FLOW_FRESHNESS_STATES, g as DATA_FLOW_PROOF_STATES, h as DATA_FLOW_SCHEMA_VERSION, i as DATA_FLOW_URL_QUERY_KEY_LIMIT, j as DEFAULT_DATA_FLOW_LIMITS, k as DEFAULT_RUNTIME_DATA_FLOW_LIMITS, l as DataDependency, m as DataFlowCapability, n as DataFlowCapabilityReason, o as DataFlowDiagnostic, p as DataFlowDiagnosticCode, q as DataFlowLimits, r as DataParameter, s as DataResponseDescriptor, E as EvidenceRef, t as EvidenceSourceRef, u as ExecutionState, F as FreshnessState, N as NetworkObservation, v as ProofState, w as RequestOrigin, x as RuntimeDataFlowLimits, S as SanitizedObservedUrl, y as componentDataFlowReportSchema, z as dataDependencySchema, B as networkObservationSchema, G as pageDataFlowReportSchema, H as runtimeDataFlowConfigSchema } from './data-flow-runtime-BMm3F-eV.cjs';
 import { z } from 'zod';
+import { b as SPOTPATCH_API_BASE } from './endpoints-BT-Bl1WS.cjs';
+export { A as AgentJobAction, S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER, g as getAgentJobEndpoint } from './endpoints-BT-Bl1WS.cjs';
 
 declare const ERROR_CODES: {
     readonly INVALID_REQUEST: "INVALID_REQUEST";
@@ -23,6 +27,24 @@ declare const ERROR_CODES: {
     readonly AGENT_BUSY: "AGENT_BUSY";
     readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
     readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+    readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+    readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+    readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+    readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+    readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+    readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+    readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+    readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+    readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+    readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+    readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+    readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+    readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+    readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+    readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+    readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+    readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+    readonly SESSION_CLOSED: "SESSION_CLOSED";
     readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
     readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
     readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -41,6 +63,8 @@ declare const ERROR_CODES: {
     readonly INTERNAL_ERROR: "INTERNAL_ERROR";
 };
 type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+declare const ERROR_CODE_VALUES: readonly ("INVALID_REQUEST" | "INVALID_TOKEN" | "ORIGIN_NOT_ALLOWED" | "SOURCE_NOT_FOUND" | "SOURCE_OUTSIDE_ROOT" | "SOURCE_TOO_LARGE" | "EDITOR_OPEN_FAILED" | "DATA_FLOW_DISABLED" | "DATA_FLOW_SOURCE_STALE" | "DATA_FLOW_ANALYSIS_CANCELLED" | "AI_DISABLED" | "PROVIDER_NOT_CONFIGURED" | "PROVIDER_AUTH_FAILED" | "PROVIDER_PROTOCOL_UNSUPPORTED" | "MODEL_NOT_ALLOWED" | "MODEL_TOOL_CALL_UNSUPPORTED" | "PROVIDER_RATE_LIMITED" | "AGENT_BUSY" | "AGENT_LIMIT_EXCEEDED" | "AGENT_CANCELLED" | "EXTERNAL_HANDOFF_DISABLED" | "EXTERNAL_HANDOFF_UNAVAILABLE" | "HANDOFF_VALIDATION_FAILED" | "HANDOFF_SOURCE_STALE" | "HANDOFF_NOT_FOUND" | "HANDOFF_EXPIRED" | "HANDOFF_CURSOR_INVALID" | "HANDOFF_RESPONSE_TOO_LARGE" | "BRIDGE_UNAUTHORIZED" | "BRIDGE_PROTOCOL_MISMATCH" | "BRIDGE_BUSY" | "EXTERNAL_AGENT_BUSY" | "ACTIVE_ADAPTER_CONFLICT" | "ACTIVE_ADAPTER_LEASE_INVALID" | "ACTIVE_DISPATCH_INVALID" | "SESSION_NOT_FOUND" | "SESSION_AMBIGUOUS" | "SESSION_CLOSED" | "WORKTREE_DIRTY" | "WORKTREE_NOT_REPOSITORY" | "WORKTREE_OPERATION_IN_PROGRESS" | "WORKTREE_CONFLICTED" | "WORKTREE_LOCAL_CHANGES_TOO_LARGE" | "WORKTREE_UNTRACKED_UNSUPPORTED" | "WORKTREE_LOCAL_CHANGES_UNSUPPORTED" | "TOOL_DENIED" | "TOOL_INPUT_INVALID" | "TOOL_ARGUMENTS_INVALID" | "TOOL_CALL_ID_CONFLICT" | "TOOL_PATH_DENIED" | "PATCH_REJECTED" | "VALIDATION_FAILED" | "APPLY_CONFLICT" | "INTERNAL_ERROR")[];
+declare function isErrorCode(value: unknown): value is ErrorCode;
 
 declare class SpotPatchError extends Error {
     readonly code: ErrorCode;
@@ -51,107 +75,6 @@ declare function isSensitiveName(name: string): boolean;
 declare function redactSensitiveText(value: string): string;
 declare function sanitizeUrl(value: string, baseUrl: string): string;
 
-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;
-}
-
 /**
  * Syntax names shared by the compiler and Node analyzer.
  *
@@ -391,6 +314,9 @@ interface RuntimeConfigBase {
     readonly dataFlow: RuntimeDataFlowConfig;
     readonly debug: boolean;
     readonly editor: (typeof SPOTPATCH_EDITOR_PREFERENCES)[number];
+    readonly externalAgent: Readonly<{
+        enabled: boolean;
+    }>;
     readonly frameworkVersion: string;
     readonly locale: (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];
     readonly maxTargets: number;
@@ -867,10 +793,10 @@ declare const agentCapabilitySnapshotSchema: z.ZodObject<{
     }>;
     state: z.ZodEnum<{
         unknown: "unknown";
-        unavailable: "unavailable";
         probing: "probing";
         "agent-ready": "agent-ready";
         "prompt-only": "prompt-only";
+        unavailable: "unavailable";
     }>;
     authenticated: z.ZodBoolean;
     modelAvailable: z.ZodBoolean;
@@ -899,6 +825,24 @@ declare const agentCapabilitySnapshotSchema: z.ZodObject<{
         readonly AGENT_BUSY: "AGENT_BUSY";
         readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
         readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+        readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+        readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+        readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+        readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+        readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+        readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+        readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+        readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+        readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+        readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+        readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+        readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+        readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+        readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+        readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+        readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+        readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+        readonly SESSION_CLOSED: "SESSION_CLOSED";
         readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
         readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
         readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -953,6 +897,24 @@ declare const agentWorkspaceHealthSnapshotSchema: z.ZodObject<{
         readonly AGENT_BUSY: "AGENT_BUSY";
         readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
         readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+        readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+        readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+        readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+        readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+        readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+        readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+        readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+        readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+        readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+        readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+        readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+        readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+        readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+        readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+        readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+        readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+        readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+        readonly SESSION_CLOSED: "SESSION_CLOSED";
         readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
         readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
         readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -1041,6 +1003,24 @@ declare const agentJobSnapshotSchema: z.ZodObject<{
         readonly AGENT_BUSY: "AGENT_BUSY";
         readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
         readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+        readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+        readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+        readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+        readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+        readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+        readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+        readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+        readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+        readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+        readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+        readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+        readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+        readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+        readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+        readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+        readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+        readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+        readonly SESSION_CLOSED: "SESSION_CLOSED";
         readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
         readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
         readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -1135,6 +1115,24 @@ declare const agentJobResultResponseSchema: z.ZodObject<{
             readonly AGENT_BUSY: "AGENT_BUSY";
             readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
             readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+            readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+            readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+            readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+            readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+            readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+            readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+            readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+            readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+            readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+            readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+            readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+            readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+            readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+            readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+            readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+            readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+            readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+            readonly SESSION_CLOSED: "SESSION_CLOSED";
             readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
             readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
             readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -1251,6 +1249,24 @@ declare const agentJobEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
                 readonly AGENT_BUSY: "AGENT_BUSY";
                 readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
                 readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+                readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+                readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+                readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+                readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+                readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+                readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+                readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+                readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+                readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+                readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+                readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+                readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+                readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+                readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+                readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+                readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+                readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+                readonly SESSION_CLOSED: "SESSION_CLOSED";
                 readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
                 readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
                 readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -1429,6 +1445,24 @@ declare const agentJobEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             readonly AGENT_BUSY: "AGENT_BUSY";
             readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
             readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+            readonly EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED";
+            readonly EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE";
+            readonly HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED";
+            readonly HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE";
+            readonly HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND";
+            readonly HANDOFF_EXPIRED: "HANDOFF_EXPIRED";
+            readonly HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID";
+            readonly HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE";
+            readonly BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED";
+            readonly BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH";
+            readonly BRIDGE_BUSY: "BRIDGE_BUSY";
+            readonly EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY";
+            readonly ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT";
+            readonly ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID";
+            readonly ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID";
+            readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+            readonly SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS";
+            readonly SESSION_CLOSED: "SESSION_CLOSED";
             readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
             readonly WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY";
             readonly WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS";
@@ -1465,4 +1499,4 @@ type ApiResponse<T> = ApiSuccess<T> | ApiFailure;
 
 declare const SPOTPATCH_REPOSITORY_URL: "https://github.com/huanglvjing/spotpatch";
 
-export { AGENT_APPLY_MODES, AGENT_CAPABILITY_STATES, AGENT_CHECK_STATUSES, AGENT_FILE_CHANGE_KINDS, AGENT_JOB_STATUSES, AGENT_WORKSPACE_SNAPSHOT_LIMITS, AGENT_WORKSPACE_STATES, type AgentApplyMode, type AgentCapabilityRequest, type AgentCapabilitySnapshot, type AgentCapabilityState, type AgentChangedFile, type AgentCheckDefinition, type AgentCheckResult, type AgentCheckStatus, type AgentFileChangeKind, type AgentJobCreateRequest, type AgentJobEvent, type AgentJobResult, type AgentJobResultResponse, type AgentJobSnapshot, type AgentJobStatus, type AgentLimits, type AgentWorkingTreeMode, type AgentWorkspaceChangeSummary, type AgentWorkspaceHealthSnapshot, type AgentWorkspaceState, type AiExecutionOptions, type AiModelProfile, type AiOptions, type AiProviderAuthentication, type AiProviderProtocol, type ApiFailure, type ApiResponse, type ApiSuccess, type CodeContext, ComponentDataFlowReport, type ContextBudget, DATA_FLOW_QUERY_ADAPTER_MODULES, DATA_FLOW_QUERY_HOOK_NAMES, DATA_FLOW_TRPC_CLIENT_FACTORY_NAMES, DATA_FLOW_TRPC_PROXY_FACTORY_NAMES, DATA_FLOW_TRPC_REQUEST_METHODS, DATA_FLOW_TRPC_ROOT_FACTORY_NAMES, DEFAULT_AGENT_LIMITS, type DataFlowCollectionLimitOptions, type DataFlowComponentReportRequest, type DataFlowPageReportRequest, ERROR_CODES, type EditorOpenResult, type ElementContext, type ErrorCode, MAX_ANNOTATION_INSTRUCTION_CHARACTERS, MAX_ANNOTATION_TARGETS, MAX_TARGET_INSTRUCTION_CHARACTERS, type MatchedStyleRule, type OpenAICompatibleProviderOptions, type OpenEditorRequest, type PageContext, PageDataFlowReport, type ReactContext, ReportCompleteness, type ResolvedAgentCheckDefinition, type ResolvedAiExecutionOptions, type ResolvedAiModelProfile, type ResolvedAiOptions, type ResolvedOpenAICompatibleProviderOptions, type RuntimeAiConfig, type RuntimeAiModelProfile, type RuntimeAiProviderProfile, type RuntimeBootstrapRequest, RuntimeDataFlowConfig, SOURCE_MARKER_ATTRIBUTE, SPOTPATCH_API_BASE, SPOTPATCH_EDITOR_PREFERENCES, SPOTPATCH_LOCALES, SPOTPATCH_LOCALE_PREFERENCES, SPOTPATCH_NEXT_BUNDLERS, SPOTPATCH_NEXT_ROUTER_KINDS, SPOTPATCH_REPOSITORY_URL, type SourceConfidence, type SourceContextRequest, type SourceMarker, type SourceOrigin, type SourceRef, type SpotAnnotation, type SpotPatchEditorPreference, SpotPatchError, type SpotPatchLocale, type SpotPatchLocalePreference, type SpotPatchNextBundler, type SpotPatchNextRouterKind, type SpotPatchRuntimeConfig, type SpotTargetContext, type StyleContext, agentCapabilityRequestSchema, agentCapabilitySnapshotSchema, agentChangedFileSchema, agentCheckResultSchema, agentJobActionRequestSchema, agentJobCreateRequestSchema, agentJobEventSchema, agentJobResultResponseSchema, agentJobResultSchema, agentJobSnapshotSchema, agentWorkspaceHealthRequestSchema, agentWorkspaceHealthSnapshotSchema, dataFlowComponentReportRequestSchema, dataFlowPageReportRequestSchema, formatSourceMarker, isSensitiveName, limitDataFlowReportCollections, openEditorRequestSchema, parseSourceMarker, redactSensitiveText, runtimeBootstrapRequestSchema, runtimeConfigSchema, sanitizeUrl, sourceContextRequestSchema, spotAnnotationRequestSchema, spotTargetContextRequestSchema };
+export { AGENT_APPLY_MODES, AGENT_CAPABILITY_STATES, AGENT_CHECK_STATUSES, AGENT_FILE_CHANGE_KINDS, AGENT_JOB_STATUSES, AGENT_WORKSPACE_SNAPSHOT_LIMITS, AGENT_WORKSPACE_STATES, type AgentApplyMode, type AgentCapabilityRequest, type AgentCapabilitySnapshot, type AgentCapabilityState, type AgentChangedFile, type AgentCheckDefinition, type AgentCheckResult, type AgentCheckStatus, type AgentFileChangeKind, type AgentJobCreateRequest, type AgentJobEvent, type AgentJobResult, type AgentJobResultResponse, type AgentJobSnapshot, type AgentJobStatus, type AgentLimits, type AgentWorkingTreeMode, type AgentWorkspaceChangeSummary, type AgentWorkspaceHealthSnapshot, type AgentWorkspaceState, type AiExecutionOptions, type AiModelProfile, type AiOptions, type AiProviderAuthentication, type AiProviderProtocol, type ApiFailure, type ApiResponse, type ApiSuccess, ComponentDataFlowReport, ContextBudget, DATA_FLOW_QUERY_ADAPTER_MODULES, DATA_FLOW_QUERY_HOOK_NAMES, DATA_FLOW_TRPC_CLIENT_FACTORY_NAMES, DATA_FLOW_TRPC_PROXY_FACTORY_NAMES, DATA_FLOW_TRPC_REQUEST_METHODS, DATA_FLOW_TRPC_ROOT_FACTORY_NAMES, DEFAULT_AGENT_LIMITS, type DataFlowCollectionLimitOptions, type DataFlowComponentReportRequest, type DataFlowPageReportRequest, ERROR_CODES, ERROR_CODE_VALUES, type EditorOpenResult, type ErrorCode, type OpenAICompatibleProviderOptions, type OpenEditorRequest, PageDataFlowReport, ReportCompleteness, type ResolvedAgentCheckDefinition, type ResolvedAiExecutionOptions, type ResolvedAiModelProfile, type ResolvedAiOptions, type ResolvedOpenAICompatibleProviderOptions, type RuntimeAiConfig, type RuntimeAiModelProfile, type RuntimeAiProviderProfile, type RuntimeBootstrapRequest, RuntimeDataFlowConfig, SOURCE_MARKER_ATTRIBUTE, SPOTPATCH_API_BASE, SPOTPATCH_EDITOR_PREFERENCES, SPOTPATCH_LOCALE_PREFERENCES, SPOTPATCH_NEXT_BUNDLERS, SPOTPATCH_NEXT_ROUTER_KINDS, SPOTPATCH_REPOSITORY_URL, type SourceContextRequest, type SourceMarker, SpotAnnotation, type SpotPatchEditorPreference, SpotPatchError, type SpotPatchNextBundler, type SpotPatchNextRouterKind, type SpotPatchRuntimeConfig, agentCapabilityRequestSchema, agentCapabilitySnapshotSchema, agentChangedFileSchema, agentCheckResultSchema, agentJobActionRequestSchema, agentJobCreateRequestSchema, agentJobEventSchema, agentJobResultResponseSchema, agentJobResultSchema, agentJobSnapshotSchema, agentWorkspaceHealthRequestSchema, agentWorkspaceHealthSnapshotSchema, dataFlowComponentReportRequestSchema, dataFlowPageReportRequestSchema, formatSourceMarker, isErrorCode, isSensitiveName, limitDataFlowReportCollections, openEditorRequestSchema, parseSourceMarker, redactSensitiveText, runtimeBootstrapRequestSchema, runtimeConfigSchema, sanitizeUrl, sourceContextRequestSchema, spotAnnotationRequestSchema, spotTargetContextRequestSchema };