@spotpatch/shared 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1183 @@
+import { z } from 'zod';
+
+declare const ERROR_CODES: {
+    readonly INVALID_REQUEST: "INVALID_REQUEST";
+    readonly INVALID_TOKEN: "INVALID_TOKEN";
+    readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+    readonly SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND";
+    readonly SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT";
+    readonly SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE";
+    readonly EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED";
+    readonly AI_DISABLED: "AI_DISABLED";
+    readonly PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+    readonly PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED";
+    readonly PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED";
+    readonly MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED";
+    readonly MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED";
+    readonly PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED";
+    readonly AGENT_BUSY: "AGENT_BUSY";
+    readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
+    readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+    readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
+    readonly TOOL_DENIED: "TOOL_DENIED";
+    readonly PATCH_REJECTED: "PATCH_REJECTED";
+    readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+    readonly APPLY_CONFLICT: "APPLY_CONFLICT";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+};
+type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];
+
+declare class SpotPatchError extends Error {
+    readonly code: ErrorCode;
+    constructor(code: ErrorCode, message?: ErrorCode, options?: ErrorOptions);
+}
+
+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 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 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;
+}
+
+type AiProviderProtocol = "responses" | "chat-completions";
+type AgentApplyMode = "review" | "auto";
+interface AiModelProfile {
+    readonly label: string;
+    readonly model: string;
+}
+interface OpenAICompatibleProviderOptions {
+    readonly type: "openai-compatible";
+    readonly label: string;
+    readonly protocol: AiProviderProtocol;
+    readonly baseURL: string;
+    readonly apiKeyEnv: string;
+    readonly models: Readonly<Record<string, AiModelProfile>>;
+    readonly defaultModel: string;
+}
+interface AgentCheckDefinition {
+    readonly label: string;
+    readonly command: string;
+    readonly args?: readonly string[];
+    readonly required?: boolean;
+    readonly timeoutMs?: number;
+}
+interface AgentLimits {
+    readonly maxTurns: number;
+    readonly maxToolCalls: number;
+    readonly maxChangedFiles: number;
+    readonly maxDiffBytes: number;
+    readonly maxReadBytesPerFile: number;
+    readonly maxToolOutputCharacters: number;
+    readonly maxProviderResponseBytes: number;
+    readonly providerConnectTimeoutMs: number;
+    readonly providerFirstByteTimeoutMs: number;
+    readonly providerIdleTimeoutMs: number;
+    readonly checkTimeoutMs: number;
+    readonly jobTimeoutMs: number;
+}
+declare const DEFAULT_AGENT_LIMITS: Readonly<{
+    maxTurns: number;
+    maxToolCalls: number;
+    maxChangedFiles: number;
+    maxDiffBytes: number;
+    maxReadBytesPerFile: number;
+    maxToolOutputCharacters: number;
+    maxProviderResponseBytes: number;
+    providerConnectTimeoutMs: number;
+    providerFirstByteTimeoutMs: number;
+    providerIdleTimeoutMs: number;
+    checkTimeoutMs: number;
+    jobTimeoutMs: number;
+}>;
+interface AiExecutionOptions {
+    readonly isolation?: "git-worktree";
+    readonly applyMode?: AgentApplyMode;
+    readonly checks?: Readonly<Record<string, AgentCheckDefinition>>;
+    readonly limits?: Partial<AgentLimits>;
+}
+interface AiOptions {
+    readonly providers: Readonly<Record<string, OpenAICompatibleProviderOptions>>;
+    readonly defaultProvider: string;
+    readonly execution?: AiExecutionOptions;
+}
+interface ResolvedAiModelProfile extends AiModelProfile {
+    readonly id: string;
+}
+interface ResolvedOpenAICompatibleProviderOptions {
+    readonly id: string;
+    readonly type: "openai-compatible";
+    readonly label: string;
+    readonly protocol: AiProviderProtocol;
+    readonly baseURL: string;
+    readonly apiKeyEnv: string;
+    readonly models: Readonly<Record<string, ResolvedAiModelProfile>>;
+    readonly defaultModel: string;
+}
+interface ResolvedAgentCheckDefinition {
+    readonly id: string;
+    readonly label: string;
+    readonly command: string;
+    readonly args: readonly string[];
+    readonly required: boolean;
+    readonly timeoutMs: number;
+}
+interface ResolvedAiExecutionOptions {
+    readonly isolation: "git-worktree";
+    readonly applyMode: AgentApplyMode;
+    readonly checks: Readonly<Record<string, ResolvedAgentCheckDefinition>>;
+    readonly limits: Readonly<AgentLimits>;
+}
+interface ResolvedAiOptions {
+    readonly providers: Readonly<Record<string, ResolvedOpenAICompatibleProviderOptions>>;
+    readonly defaultProvider: string;
+    readonly execution: ResolvedAiExecutionOptions;
+}
+interface RuntimeAiModelProfile {
+    readonly id: string;
+    readonly label: string;
+}
+interface RuntimeAiProviderProfile {
+    readonly id: string;
+    readonly label: string;
+    readonly protocol: AiProviderProtocol;
+    readonly models: readonly RuntimeAiModelProfile[];
+    readonly defaultModel: string;
+}
+type RuntimeAiConfig = Readonly<{
+    enabled: false;
+}> | Readonly<{
+    enabled: true;
+    providers: readonly RuntimeAiProviderProfile[];
+    defaultProvider: string;
+    applyMode: AgentApplyMode;
+}>;
+declare const AGENT_JOB_STATUSES: readonly ["queued", "preparing", "running", "validating", "awaiting-review", "applying", "applied", "completed", "cancelling", "cancelled", "reverting", "reverted", "failed"];
+type AgentJobStatus = (typeof AGENT_JOB_STATUSES)[number];
+declare const AGENT_CAPABILITY_STATES: readonly ["unknown", "probing", "agent-ready", "prompt-only", "unavailable"];
+type AgentCapabilityState = (typeof AGENT_CAPABILITY_STATES)[number];
+interface AgentCapabilitySnapshot {
+    readonly providerProfileId: string;
+    readonly providerLabel: string;
+    readonly modelProfileId: string;
+    readonly modelLabel: string;
+    readonly protocol: AiProviderProtocol;
+    readonly state: AgentCapabilityState;
+    readonly authenticated: boolean;
+    readonly modelAvailable: boolean;
+    readonly toolCalling: boolean;
+    readonly toolResultContinuation: boolean;
+    readonly streaming: boolean;
+    readonly checkedAt?: string;
+    readonly errorCode?: ErrorCode;
+}
+declare const AGENT_FILE_CHANGE_KINDS: readonly ["added", "modified", "deleted"];
+type AgentFileChangeKind = (typeof AGENT_FILE_CHANGE_KINDS)[number];
+declare const AGENT_CHECK_STATUSES: readonly ["passed", "failed", "cancelled", "timed-out"];
+type AgentCheckStatus = (typeof AGENT_CHECK_STATUSES)[number];
+interface AgentChangedFile {
+    readonly relativePath: string;
+    readonly kind: AgentFileChangeKind;
+    readonly additions: number;
+    readonly deletions: number;
+}
+interface AgentCheckResult {
+    readonly checkId: string;
+    readonly label: string;
+    readonly status: AgentCheckStatus;
+    readonly durationMs: number;
+    readonly output: string;
+}
+interface AgentJobSnapshot {
+    readonly jobId: string;
+    readonly status: AgentJobStatus;
+    readonly providerProfileId: string;
+    readonly providerLabel: string;
+    readonly modelProfileId: string;
+    readonly modelLabel: string;
+    readonly phaseMessage: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly canCancel: boolean;
+    readonly canApply: boolean;
+    readonly canRevert: boolean;
+    readonly errorCode?: ErrorCode;
+}
+interface AgentJobResult {
+    readonly jobId: string;
+    readonly summary: string;
+    readonly diff: string;
+    readonly files: readonly AgentChangedFile[];
+    readonly checks: readonly AgentCheckResult[];
+}
+interface AgentJobResultResponse {
+    readonly snapshot: AgentJobSnapshot;
+    readonly result?: AgentJobResult;
+}
+
+declare const SOURCE_MARKER_ATTRIBUTE: "data-spotpatch-source";
+interface SourceMarker {
+    readonly fileId: string;
+    readonly line: number;
+    readonly column: number;
+}
+declare function formatSourceMarker(marker: SourceMarker): string;
+declare function parseSourceMarker(value: string | null): SourceMarker | undefined;
+
+declare const SPOTPATCH_API_BASE: "/__spotpatch/v1";
+declare const SPOTPATCH_TOKEN_HEADER: "X-SpotPatch-Token";
+declare const SPOTPATCH_ENDPOINTS: Readonly<{
+    sourceContext: "/__spotpatch/v1/source-context";
+    openEditor: "/__spotpatch/v1/open-editor";
+    agentCapability: "/__spotpatch/v1/agent/capability";
+    agentJobs: "/__spotpatch/v1/agent/jobs";
+}>;
+type AgentJobAction = "events" | "result" | "cancel" | "apply" | "revert";
+declare function getAgentJobEndpoint(jobId: string, action: AgentJobAction): string;
+
+declare const sourceContextRequestSchema: z.ZodObject<{
+    fileId: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    maxLines: z.ZodNumber;
+}, z.core.$strict>;
+declare const openEditorRequestSchema: z.ZodObject<{
+    fileId: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+}, z.core.$strict>;
+declare const spotTargetContextRequestSchema: z.ZodObject<{
+    instruction: z.ZodString;
+    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>;
+        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>;
+declare const spotAnnotationRequestSchema: 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;
+        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>;
+            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>;
+declare const agentCapabilityRequestSchema: z.ZodObject<{
+    providerProfileId: z.ZodString;
+    modelProfileId: z.ZodString;
+}, z.core.$strict>;
+declare const agentJobCreateRequestSchema: z.ZodObject<{
+    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;
+            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>;
+                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>;
+    providerProfileId: z.ZodString;
+    modelProfileId: z.ZodString;
+    providerDataConsent: z.ZodLiteral<true>;
+}, z.core.$strict>;
+declare const agentJobActionRequestSchema: z.ZodObject<{}, z.core.$strict>;
+type SourceContextRequest = z.infer<typeof sourceContextRequestSchema>;
+type OpenEditorRequest = z.infer<typeof openEditorRequestSchema>;
+type AgentCapabilityRequest = z.infer<typeof agentCapabilityRequestSchema>;
+interface AgentJobCreateRequest {
+    readonly annotation: SpotAnnotation;
+    readonly providerProfileId: string;
+    readonly modelProfileId: string;
+    readonly providerDataConsent: true;
+}
+
+interface AgentJobEventBase {
+    readonly schemaVersion: 1;
+    readonly sequence: number;
+    readonly jobId: string;
+    readonly status: AgentJobStatus;
+    readonly timestamp: string;
+}
+type AgentJobEvent = (AgentJobEventBase & {
+    readonly type: "snapshot";
+    readonly data: Readonly<{
+        snapshot: AgentJobSnapshot;
+    }>;
+}) | (AgentJobEventBase & {
+    readonly type: "phase";
+    readonly data: Readonly<{
+        message: string;
+    }>;
+}) | (AgentJobEventBase & {
+    readonly type: "tool";
+    readonly data: Readonly<{
+        toolCallId: string;
+        toolName: string;
+        state: "started" | "succeeded" | "failed";
+        relativePath?: string;
+        checkLabel?: string;
+    }>;
+}) | (AgentJobEventBase & {
+    readonly type: "check";
+    readonly data: Readonly<{
+        result: AgentCheckResult;
+    }>;
+}) | (AgentJobEventBase & {
+    readonly type: "result-ready";
+    readonly data: Readonly<{
+        hasResult: true;
+    }>;
+}) | (AgentJobEventBase & {
+    readonly type: "error";
+    readonly data: Readonly<{
+        code: ErrorCode;
+        message: string;
+    }>;
+});
+
+declare const agentCapabilitySnapshotSchema: z.ZodObject<{
+    providerProfileId: z.ZodString;
+    providerLabel: z.ZodString;
+    modelProfileId: z.ZodString;
+    modelLabel: z.ZodString;
+    protocol: z.ZodEnum<{
+        responses: "responses";
+        "chat-completions": "chat-completions";
+    }>;
+    state: z.ZodEnum<{
+        unknown: "unknown";
+        probing: "probing";
+        "agent-ready": "agent-ready";
+        "prompt-only": "prompt-only";
+        unavailable: "unavailable";
+    }>;
+    authenticated: z.ZodBoolean;
+    modelAvailable: z.ZodBoolean;
+    toolCalling: z.ZodBoolean;
+    toolResultContinuation: z.ZodBoolean;
+    streaming: z.ZodBoolean;
+    checkedAt: z.ZodOptional<z.ZodISODateTime>;
+    errorCode: z.ZodOptional<z.ZodEnum<{
+        readonly INVALID_REQUEST: "INVALID_REQUEST";
+        readonly INVALID_TOKEN: "INVALID_TOKEN";
+        readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+        readonly SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND";
+        readonly SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT";
+        readonly SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE";
+        readonly EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED";
+        readonly AI_DISABLED: "AI_DISABLED";
+        readonly PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+        readonly PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED";
+        readonly PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED";
+        readonly MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED";
+        readonly MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED";
+        readonly PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED";
+        readonly AGENT_BUSY: "AGENT_BUSY";
+        readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
+        readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+        readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
+        readonly TOOL_DENIED: "TOOL_DENIED";
+        readonly PATCH_REJECTED: "PATCH_REJECTED";
+        readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+        readonly APPLY_CONFLICT: "APPLY_CONFLICT";
+        readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    }>>;
+}, z.core.$strict>;
+declare const agentChangedFileSchema: z.ZodObject<{
+    relativePath: z.ZodString;
+    kind: z.ZodEnum<{
+        added: "added";
+        modified: "modified";
+        deleted: "deleted";
+    }>;
+    additions: z.ZodNumber;
+    deletions: z.ZodNumber;
+}, z.core.$strict>;
+declare const agentCheckResultSchema: z.ZodObject<{
+    checkId: z.ZodString;
+    label: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        failed: "failed";
+        passed: "passed";
+        "timed-out": "timed-out";
+    }>;
+    durationMs: z.ZodNumber;
+    output: z.ZodString;
+}, z.core.$strict>;
+declare const agentJobSnapshotSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    providerProfileId: z.ZodString;
+    providerLabel: z.ZodString;
+    modelProfileId: z.ZodString;
+    modelLabel: z.ZodString;
+    phaseMessage: z.ZodString;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    canCancel: z.ZodBoolean;
+    canApply: z.ZodBoolean;
+    canRevert: z.ZodBoolean;
+    errorCode: z.ZodOptional<z.ZodEnum<{
+        readonly INVALID_REQUEST: "INVALID_REQUEST";
+        readonly INVALID_TOKEN: "INVALID_TOKEN";
+        readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+        readonly SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND";
+        readonly SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT";
+        readonly SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE";
+        readonly EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED";
+        readonly AI_DISABLED: "AI_DISABLED";
+        readonly PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+        readonly PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED";
+        readonly PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED";
+        readonly MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED";
+        readonly MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED";
+        readonly PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED";
+        readonly AGENT_BUSY: "AGENT_BUSY";
+        readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
+        readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+        readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
+        readonly TOOL_DENIED: "TOOL_DENIED";
+        readonly PATCH_REJECTED: "PATCH_REJECTED";
+        readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+        readonly APPLY_CONFLICT: "APPLY_CONFLICT";
+        readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    }>>;
+}, z.core.$strict>;
+declare const agentJobResultSchema: z.ZodObject<{
+    jobId: z.ZodString;
+    summary: z.ZodString;
+    diff: z.ZodString;
+    files: z.ZodArray<z.ZodObject<{
+        relativePath: z.ZodString;
+        kind: z.ZodEnum<{
+            added: "added";
+            modified: "modified";
+            deleted: "deleted";
+        }>;
+        additions: z.ZodNumber;
+        deletions: z.ZodNumber;
+    }, z.core.$strict>>;
+    checks: z.ZodArray<z.ZodObject<{
+        checkId: z.ZodString;
+        label: z.ZodString;
+        status: z.ZodEnum<{
+            cancelled: "cancelled";
+            failed: "failed";
+            passed: "passed";
+            "timed-out": "timed-out";
+        }>;
+        durationMs: z.ZodNumber;
+        output: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const agentJobResultResponseSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        jobId: z.ZodString;
+        status: z.ZodEnum<{
+            queued: "queued";
+            preparing: "preparing";
+            running: "running";
+            validating: "validating";
+            "awaiting-review": "awaiting-review";
+            applying: "applying";
+            applied: "applied";
+            completed: "completed";
+            cancelling: "cancelling";
+            cancelled: "cancelled";
+            reverting: "reverting";
+            reverted: "reverted";
+            failed: "failed";
+        }>;
+        providerProfileId: z.ZodString;
+        providerLabel: z.ZodString;
+        modelProfileId: z.ZodString;
+        modelLabel: z.ZodString;
+        phaseMessage: z.ZodString;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        canCancel: z.ZodBoolean;
+        canApply: z.ZodBoolean;
+        canRevert: z.ZodBoolean;
+        errorCode: z.ZodOptional<z.ZodEnum<{
+            readonly INVALID_REQUEST: "INVALID_REQUEST";
+            readonly INVALID_TOKEN: "INVALID_TOKEN";
+            readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+            readonly SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND";
+            readonly SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT";
+            readonly SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE";
+            readonly EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED";
+            readonly AI_DISABLED: "AI_DISABLED";
+            readonly PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+            readonly PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED";
+            readonly PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED";
+            readonly MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED";
+            readonly MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED";
+            readonly PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED";
+            readonly AGENT_BUSY: "AGENT_BUSY";
+            readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
+            readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+            readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
+            readonly TOOL_DENIED: "TOOL_DENIED";
+            readonly PATCH_REJECTED: "PATCH_REJECTED";
+            readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+            readonly APPLY_CONFLICT: "APPLY_CONFLICT";
+            readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+        }>>;
+    }, z.core.$strict>;
+    result: z.ZodOptional<z.ZodObject<{
+        jobId: z.ZodString;
+        summary: z.ZodString;
+        diff: z.ZodString;
+        files: z.ZodArray<z.ZodObject<{
+            relativePath: z.ZodString;
+            kind: z.ZodEnum<{
+                added: "added";
+                modified: "modified";
+                deleted: "deleted";
+            }>;
+            additions: z.ZodNumber;
+            deletions: z.ZodNumber;
+        }, z.core.$strict>>;
+        checks: z.ZodArray<z.ZodObject<{
+            checkId: z.ZodString;
+            label: z.ZodString;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                failed: "failed";
+                passed: "passed";
+                "timed-out": "timed-out";
+            }>;
+            durationMs: z.ZodNumber;
+            output: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const agentJobEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+    type: z.ZodLiteral<"snapshot">;
+    data: z.ZodObject<{
+        snapshot: z.ZodObject<{
+            jobId: z.ZodString;
+            status: z.ZodEnum<{
+                queued: "queued";
+                preparing: "preparing";
+                running: "running";
+                validating: "validating";
+                "awaiting-review": "awaiting-review";
+                applying: "applying";
+                applied: "applied";
+                completed: "completed";
+                cancelling: "cancelling";
+                cancelled: "cancelled";
+                reverting: "reverting";
+                reverted: "reverted";
+                failed: "failed";
+            }>;
+            providerProfileId: z.ZodString;
+            providerLabel: z.ZodString;
+            modelProfileId: z.ZodString;
+            modelLabel: z.ZodString;
+            phaseMessage: z.ZodString;
+            createdAt: z.ZodISODateTime;
+            updatedAt: z.ZodISODateTime;
+            canCancel: z.ZodBoolean;
+            canApply: z.ZodBoolean;
+            canRevert: z.ZodBoolean;
+            errorCode: z.ZodOptional<z.ZodEnum<{
+                readonly INVALID_REQUEST: "INVALID_REQUEST";
+                readonly INVALID_TOKEN: "INVALID_TOKEN";
+                readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+                readonly SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND";
+                readonly SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT";
+                readonly SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE";
+                readonly EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED";
+                readonly AI_DISABLED: "AI_DISABLED";
+                readonly PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+                readonly PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED";
+                readonly PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED";
+                readonly MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED";
+                readonly MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED";
+                readonly PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED";
+                readonly AGENT_BUSY: "AGENT_BUSY";
+                readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
+                readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+                readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
+                readonly TOOL_DENIED: "TOOL_DENIED";
+                readonly PATCH_REJECTED: "PATCH_REJECTED";
+                readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+                readonly APPLY_CONFLICT: "APPLY_CONFLICT";
+                readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+            }>>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+    type: z.ZodLiteral<"phase">;
+    data: z.ZodObject<{
+        message: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+    type: z.ZodLiteral<"tool">;
+    data: z.ZodObject<{
+        toolCallId: z.ZodString;
+        toolName: z.ZodString;
+        state: z.ZodEnum<{
+            failed: "failed";
+            started: "started";
+            succeeded: "succeeded";
+        }>;
+        relativePath: z.ZodOptional<z.ZodString>;
+        checkLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+    type: z.ZodLiteral<"check">;
+    data: z.ZodObject<{
+        result: z.ZodObject<{
+            checkId: z.ZodString;
+            label: z.ZodString;
+            status: z.ZodEnum<{
+                cancelled: "cancelled";
+                failed: "failed";
+                passed: "passed";
+                "timed-out": "timed-out";
+            }>;
+            durationMs: z.ZodNumber;
+            output: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+    type: z.ZodLiteral<"result-ready">;
+    data: z.ZodObject<{
+        hasResult: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+}, z.core.$strict>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        preparing: "preparing";
+        running: "running";
+        validating: "validating";
+        "awaiting-review": "awaiting-review";
+        applying: "applying";
+        applied: "applied";
+        completed: "completed";
+        cancelling: "cancelling";
+        cancelled: "cancelled";
+        reverting: "reverting";
+        reverted: "reverted";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+    type: z.ZodLiteral<"error">;
+    data: z.ZodObject<{
+        code: z.ZodEnum<{
+            readonly INVALID_REQUEST: "INVALID_REQUEST";
+            readonly INVALID_TOKEN: "INVALID_TOKEN";
+            readonly ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED";
+            readonly SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND";
+            readonly SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT";
+            readonly SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE";
+            readonly EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED";
+            readonly AI_DISABLED: "AI_DISABLED";
+            readonly PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+            readonly PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED";
+            readonly PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED";
+            readonly MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED";
+            readonly MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED";
+            readonly PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED";
+            readonly AGENT_BUSY: "AGENT_BUSY";
+            readonly AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED";
+            readonly AGENT_CANCELLED: "AGENT_CANCELLED";
+            readonly WORKTREE_DIRTY: "WORKTREE_DIRTY";
+            readonly TOOL_DENIED: "TOOL_DENIED";
+            readonly PATCH_REJECTED: "PATCH_REJECTED";
+            readonly VALIDATION_FAILED: "VALIDATION_FAILED";
+            readonly APPLY_CONFLICT: "APPLY_CONFLICT";
+            readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+        }>;
+        message: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>], "type">;
+
+interface ApiSuccess<T> {
+    readonly ok: true;
+    readonly data: T;
+}
+interface ApiFailure {
+    readonly ok: false;
+    readonly error: Readonly<{
+        code: ErrorCode;
+        message: string;
+    }>;
+}
+type ApiResponse<T> = ApiSuccess<T> | ApiFailure;
+
+export { AGENT_CAPABILITY_STATES, AGENT_CHECK_STATUSES, AGENT_FILE_CHANGE_KINDS, AGENT_JOB_STATUSES, type AgentApplyMode, type AgentCapabilityRequest, type AgentCapabilitySnapshot, type AgentCapabilityState, type AgentChangedFile, type AgentCheckDefinition, type AgentCheckResult, type AgentCheckStatus, type AgentFileChangeKind, type AgentJobAction, type AgentJobCreateRequest, type AgentJobEvent, type AgentJobResult, type AgentJobResultResponse, type AgentJobSnapshot, type AgentJobStatus, type AgentLimits, type AiExecutionOptions, type AiModelProfile, type AiOptions, type AiProviderProtocol, type ApiFailure, type ApiResponse, type ApiSuccess, type CodeContext, type ContextBudget, DEFAULT_AGENT_LIMITS, ERROR_CODES, type ElementContext, type ErrorCode, MAX_ANNOTATION_INSTRUCTION_CHARACTERS, MAX_ANNOTATION_TARGETS, MAX_TARGET_INSTRUCTION_CHARACTERS, type MatchedStyleRule, type OpenAICompatibleProviderOptions, type OpenEditorRequest, type PageContext, type ReactContext, type ResolvedAgentCheckDefinition, type ResolvedAiExecutionOptions, type ResolvedAiModelProfile, type ResolvedAiOptions, type ResolvedOpenAICompatibleProviderOptions, type RuntimeAiConfig, type RuntimeAiModelProfile, type RuntimeAiProviderProfile, SOURCE_MARKER_ATTRIBUTE, SPOTPATCH_API_BASE, SPOTPATCH_ENDPOINTS, SPOTPATCH_LOCALES, SPOTPATCH_LOCALE_PREFERENCES, SPOTPATCH_TOKEN_HEADER, type SourceConfidence, type SourceContextRequest, type SourceMarker, type SourceOrigin, type SourceRef, type SpotAnnotation, SpotPatchError, type SpotPatchLocale, type SpotPatchLocalePreference, type SpotTargetContext, type StyleContext, agentCapabilityRequestSchema, agentCapabilitySnapshotSchema, agentChangedFileSchema, agentCheckResultSchema, agentJobActionRequestSchema, agentJobCreateRequestSchema, agentJobEventSchema, agentJobResultResponseSchema, agentJobResultSchema, agentJobSnapshotSchema, formatSourceMarker, getAgentJobEndpoint, isSensitiveName, openEditorRequestSchema, parseSourceMarker, redactSensitiveText, sanitizeUrl, sourceContextRequestSchema, spotAnnotationRequestSchema, spotTargetContextRequestSchema };