@spotpatch/shared 1.12.0 → 1.14.0

package/dist/contextual-ask-BpbkpFFf.d.ts

@@ -0,0 +1,1476 @@
+import { z } from 'zod';
+
+declare const CONTEXTUAL_ASK_SCHEMA_VERSION: 1;
+declare const CONTEXTUAL_ASK_LIMITS: Readonly<{
+    readonly maximumTargets: 20;
+    readonly maximumQuestionCharacters: 4000;
+    readonly maximumAnswerCharacters: 40000;
+    readonly maximumAnswerBlocks: 40;
+    readonly maximumSources: 64;
+    readonly maximumReadFiles: 32;
+    readonly maximumReadBytesPerFile: number;
+    readonly maximumReadBytesTotal: number;
+    readonly maximumToolCalls: 48;
+    readonly maximumModelTurns: 12;
+    readonly jobTimeoutMs: 300000;
+    readonly resultTtlMs: 900000;
+    readonly maximumActiveJobsPerSession: 1;
+    readonly maximumRetainedResultsPerSession: 1;
+    readonly maximumRetainedEvents: 256;
+    readonly maximumEventSubscribers: 4;
+    readonly eventHeartbeatMs: 15000;
+    readonly maximumRequestBodyBytes: number;
+    readonly maximumSearchQueryCharacters: 256;
+    readonly maximumSearchResults: 64;
+    readonly maximumSearchPreviewCharacters: 500;
+    readonly capabilityTimeoutMs: 30000;
+    readonly maximumIdCharacters: 128;
+    readonly maximumProfileIdCharacters: 64;
+    readonly maximumLabelCharacters: 256;
+    readonly maximumRelativePathCharacters: 1024;
+    readonly maximumLanguageCharacters: 64;
+    readonly maximumPhaseMessageCharacters: 1024;
+    readonly maximumExecutors: 32;
+    readonly maximumModels: 800;
+    readonly contentHashHexCharacters: 64;
+}>;
+declare const CONTEXTUAL_ASK_EXECUTOR_KINDS: readonly ["configured-key", "managed-codex"];
+type ContextualAskExecutorKind = (typeof CONTEXTUAL_ASK_EXECUTOR_KINDS)[number];
+declare const CONTEXTUAL_ASK_EXECUTOR_STATES: readonly ["ready", "degraded", "unavailable"];
+type ContextualAskExecutorState = (typeof CONTEXTUAL_ASK_EXECUTOR_STATES)[number];
+declare const ASK_JOB_STATUSES: readonly ["queued", "authorizing", "running", "cancelling", "answered", "cancelled", "failed"];
+type AskJobStatus = (typeof ASK_JOB_STATUSES)[number];
+declare const ASK_ANSWER_WARNING_CODES: readonly ["insufficient-evidence", "partial-context", "source-truncated", "source-stale"];
+type AskAnswerWarningCode = (typeof ASK_ANSWER_WARNING_CODES)[number];
+/** Warnings an executor may declare from its own evidence assessment. */
+declare const ASK_EXECUTOR_ANSWER_WARNING_CODES: readonly ["insufficient-evidence", "partial-context"];
+type AskExecutorAnswerWarningCode = (typeof ASK_EXECUTOR_ANSWER_WARNING_CODES)[number];
+declare const ASK_READ_ACTIVITY_STATES: readonly ["started", "succeeded", "failed"];
+type AskReadActivityState = (typeof ASK_READ_ACTIVITY_STATES)[number];
+declare const ASK_FILE_COUNT_BUCKETS: readonly ["one", "few", "many"];
+type AskFileCountBucket = (typeof ASK_FILE_COUNT_BUCKETS)[number];
+declare const ASK_SOURCE_CONFIDENCES: readonly ["exact", "probable", "approximate"];
+type AskSourceConfidence = (typeof ASK_SOURCE_CONFIDENCES)[number];
+declare const CONTEXTUAL_ASK_PERMISSION_PROFILE: "spotpatch-ask-readonly";
+
+declare const contextualAskExecutorPreferenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"configured-key">;
+    providerProfileId: z.ZodString;
+    modelProfileId: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"managed-codex">;
+}, z.core.$strict>], "kind">;
+declare const contextualAskOptionsSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+    defaultExecutor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"configured-key">;
+        providerProfileId: z.ZodString;
+        modelProfileId: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"managed-codex">;
+    }, z.core.$strict>], "kind">>;
+}, z.core.$strict>]>;
+declare const spotSelectionTargetSchema: z.ZodObject<{
+    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";
+            "astro-host": "astro-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";
+                "astro-host": "astro-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>;
+    warnings: z.ZodArray<z.ZodString>;
+    code: z.ZodOptional<z.ZodObject<{
+        relativePath: z.ZodString;
+        language: z.ZodEnum<{
+            tsx: "tsx";
+            jsx: "jsx";
+            astro: "astro";
+        }>;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+        excerpt: z.ZodString;
+        boundary: z.ZodEnum<{
+            component: "component";
+            "nearby-lines": "nearby-lines";
+        }>;
+    }, z.core.$strict>>;
+    targetId: z.ZodString;
+    page: z.ZodObject<{
+        url: z.ZodString;
+        pathname: z.ZodString;
+        title: z.ZodString;
+        viewportWidth: z.ZodNumber;
+        viewportHeight: z.ZodNumber;
+        devicePixelRatio: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+declare const spotSelectionContextSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    selectionId: z.ZodString;
+    locale: z.ZodEnum<{
+        "en-US": "en-US";
+        "zh-CN": "zh-CN";
+    }>;
+    targets: z.ZodArray<z.ZodObject<{
+        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";
+                "astro-host": "astro-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";
+                    "astro-host": "astro-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>;
+        warnings: z.ZodArray<z.ZodString>;
+        code: z.ZodOptional<z.ZodObject<{
+            relativePath: z.ZodString;
+            language: z.ZodEnum<{
+                tsx: "tsx";
+                jsx: "jsx";
+                astro: "astro";
+            }>;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+            excerpt: z.ZodString;
+            boundary: z.ZodEnum<{
+                component: "component";
+                "nearby-lines": "nearby-lines";
+            }>;
+        }, z.core.$strict>>;
+        targetId: z.ZodString;
+        page: z.ZodObject<{
+            url: z.ZodString;
+            pathname: z.ZodString;
+            title: z.ZodString;
+            viewportWidth: z.ZodNumber;
+            viewportHeight: z.ZodNumber;
+            devicePixelRatio: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const askDraftOriginSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"contextual-ask">;
+    askJobId: z.ZodString;
+    question: z.ZodString;
+    answerDigest: z.ZodString;
+    sourceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+declare const spotAskTaskEnvelopeSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        kind: z.ZodLiteral<"ask">;
+        question: z.ZodString;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    selection: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        selectionId: z.ZodString;
+        locale: z.ZodEnum<{
+            "en-US": "en-US";
+            "zh-CN": "zh-CN";
+        }>;
+        targets: z.ZodArray<z.ZodObject<{
+            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";
+                    "astro-host": "astro-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";
+                        "astro-host": "astro-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>;
+            warnings: z.ZodArray<z.ZodString>;
+            code: z.ZodOptional<z.ZodObject<{
+                relativePath: z.ZodString;
+                language: z.ZodEnum<{
+                    tsx: "tsx";
+                    jsx: "jsx";
+                    astro: "astro";
+                }>;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                excerpt: z.ZodString;
+                boundary: z.ZodEnum<{
+                    component: "component";
+                    "nearby-lines": "nearby-lines";
+                }>;
+            }, z.core.$strict>>;
+            targetId: z.ZodString;
+            page: z.ZodObject<{
+                url: z.ZodString;
+                pathname: z.ZodString;
+                title: z.ZodString;
+                viewportWidth: z.ZodNumber;
+                viewportHeight: z.ZodNumber;
+                devicePixelRatio: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const spotChangeTaskEnvelopeSchema: z.ZodObject<{
+    task: z.ZodObject<{
+        kind: z.ZodLiteral<"change">;
+        instructions: z.ZodArray<z.ZodObject<{
+            targetId: z.ZodString;
+            instruction: z.ZodString;
+        }, z.core.$strict>>;
+        origin: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"contextual-ask">;
+            askJobId: z.ZodString;
+            question: z.ZodString;
+            answerDigest: z.ZodString;
+            sourceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    selection: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        selectionId: z.ZodString;
+        locale: z.ZodEnum<{
+            "en-US": "en-US";
+            "zh-CN": "zh-CN";
+        }>;
+        targets: z.ZodArray<z.ZodObject<{
+            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";
+                    "astro-host": "astro-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";
+                        "astro-host": "astro-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>;
+            warnings: z.ZodArray<z.ZodString>;
+            code: z.ZodOptional<z.ZodObject<{
+                relativePath: z.ZodString;
+                language: z.ZodEnum<{
+                    tsx: "tsx";
+                    jsx: "jsx";
+                    astro: "astro";
+                }>;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                excerpt: z.ZodString;
+                boundary: z.ZodEnum<{
+                    component: "component";
+                    "nearby-lines": "nearby-lines";
+                }>;
+            }, z.core.$strict>>;
+            targetId: z.ZodString;
+            page: z.ZodObject<{
+                url: z.ZodString;
+                pathname: z.ZodString;
+                title: z.ZodString;
+                viewportWidth: z.ZodNumber;
+                viewportHeight: z.ZodNumber;
+                devicePixelRatio: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const spotTaskEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
+    task: z.ZodObject<{
+        kind: z.ZodLiteral<"ask">;
+        question: z.ZodString;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    selection: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        selectionId: z.ZodString;
+        locale: z.ZodEnum<{
+            "en-US": "en-US";
+            "zh-CN": "zh-CN";
+        }>;
+        targets: z.ZodArray<z.ZodObject<{
+            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";
+                    "astro-host": "astro-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";
+                        "astro-host": "astro-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>;
+            warnings: z.ZodArray<z.ZodString>;
+            code: z.ZodOptional<z.ZodObject<{
+                relativePath: z.ZodString;
+                language: z.ZodEnum<{
+                    tsx: "tsx";
+                    jsx: "jsx";
+                    astro: "astro";
+                }>;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                excerpt: z.ZodString;
+                boundary: z.ZodEnum<{
+                    component: "component";
+                    "nearby-lines": "nearby-lines";
+                }>;
+            }, z.core.$strict>>;
+            targetId: z.ZodString;
+            page: z.ZodObject<{
+                url: z.ZodString;
+                pathname: z.ZodString;
+                title: z.ZodString;
+                viewportWidth: z.ZodNumber;
+                viewportHeight: z.ZodNumber;
+                devicePixelRatio: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    task: z.ZodObject<{
+        kind: z.ZodLiteral<"change">;
+        instructions: z.ZodArray<z.ZodObject<{
+            targetId: z.ZodString;
+            instruction: z.ZodString;
+        }, z.core.$strict>>;
+        origin: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodLiteral<"contextual-ask">;
+            askJobId: z.ZodString;
+            question: z.ZodString;
+            answerDigest: z.ZodString;
+            sourceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    taskId: z.ZodString;
+    selection: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        selectionId: z.ZodString;
+        locale: z.ZodEnum<{
+            "en-US": "en-US";
+            "zh-CN": "zh-CN";
+        }>;
+        targets: z.ZodArray<z.ZodObject<{
+            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";
+                    "astro-host": "astro-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";
+                        "astro-host": "astro-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>;
+            warnings: z.ZodArray<z.ZodString>;
+            code: z.ZodOptional<z.ZodObject<{
+                relativePath: z.ZodString;
+                language: z.ZodEnum<{
+                    tsx: "tsx";
+                    jsx: "jsx";
+                    astro: "astro";
+                }>;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+                excerpt: z.ZodString;
+                boundary: z.ZodEnum<{
+                    component: "component";
+                    "nearby-lines": "nearby-lines";
+                }>;
+            }, z.core.$strict>>;
+            targetId: z.ZodString;
+            page: z.ZodObject<{
+                url: z.ZodString;
+                pathname: z.ZodString;
+                title: z.ZodString;
+                viewportWidth: z.ZodNumber;
+                viewportHeight: z.ZodNumber;
+                devicePixelRatio: z.ZodNumber;
+            }, z.core.$strict>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    createdAt: z.ZodISODateTime;
+}, z.core.$strict>]>;
+declare const askAnswerWarningSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        "insufficient-evidence": "insufficient-evidence";
+        "partial-context": "partial-context";
+        "source-truncated": "source-truncated";
+        "source-stale": "source-stale";
+    }>;
+}, z.core.$strict>;
+declare const askDraftCitationSchema: z.ZodObject<{
+    handleId: z.ZodString;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+}, z.core.$strict>;
+declare const askAnswerDraftBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"paragraph">;
+    text: z.ZodString;
+    citations: z.ZodArray<z.ZodObject<{
+        handleId: z.ZodString;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"list">;
+    items: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        citations: z.ZodArray<z.ZodObject<{
+            handleId: z.ZodString;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"code">;
+    code: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    citations: z.ZodArray<z.ZodObject<{
+        handleId: z.ZodString;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>], "kind">;
+declare const askAnswerDraftSchema: z.ZodObject<{
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"paragraph">;
+        text: z.ZodString;
+        citations: z.ZodArray<z.ZodObject<{
+            handleId: z.ZodString;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"list">;
+        items: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            citations: z.ZodArray<z.ZodObject<{
+                handleId: z.ZodString;
+                startLine: z.ZodNumber;
+                endLine: z.ZodNumber;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"code">;
+        code: z.ZodString;
+        language: z.ZodOptional<z.ZodString>;
+        citations: z.ZodArray<z.ZodObject<{
+            handleId: z.ZodString;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>], "kind">>;
+    warnings: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            "insufficient-evidence": "insufficient-evidence";
+            "partial-context": "partial-context";
+        }>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const askAnswerBlockSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"paragraph">;
+    text: z.ZodString;
+    sourceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"list">;
+    items: z.ZodArray<z.ZodObject<{
+        text: z.ZodString;
+        sourceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"code">;
+    code: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    sourceIds: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "kind">;
+declare const askSourceReferenceSchema: z.ZodObject<{
+    sourceId: z.ZodString;
+    label: z.ZodString;
+    relativePath: z.ZodString;
+    fileId: z.ZodString;
+    startLine: z.ZodNumber;
+    endLine: z.ZodNumber;
+    confidence: z.ZodEnum<{
+        exact: "exact";
+        probable: "probable";
+        approximate: "approximate";
+    }>;
+    targetIds: z.ZodArray<z.ZodString>;
+    sourceVersion: z.ZodOptional<z.ZodString>;
+    contentHash: z.ZodString;
+}, z.core.$strict>;
+declare const askAnswerResultSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    jobId: z.ZodString;
+    selectionId: z.ZodString;
+    contextHash: z.ZodString;
+    executor: z.ZodObject<{
+        executorId: z.ZodString;
+        kind: z.ZodEnum<{
+            "configured-key": "configured-key";
+            "managed-codex": "managed-codex";
+        }>;
+        label: z.ZodString;
+        modelLabel: z.ZodString;
+    }, z.core.$strict>;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"paragraph">;
+        text: z.ZodString;
+        sourceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"list">;
+        items: z.ZodArray<z.ZodObject<{
+            text: z.ZodString;
+            sourceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"code">;
+        code: z.ZodString;
+        language: z.ZodOptional<z.ZodString>;
+        sourceIds: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>], "kind">>;
+    sources: z.ZodArray<z.ZodObject<{
+        sourceId: z.ZodString;
+        label: z.ZodString;
+        relativePath: z.ZodString;
+        fileId: z.ZodString;
+        startLine: z.ZodNumber;
+        endLine: z.ZodNumber;
+        confidence: z.ZodEnum<{
+            exact: "exact";
+            probable: "probable";
+            approximate: "approximate";
+        }>;
+        targetIds: z.ZodArray<z.ZodString>;
+        sourceVersion: z.ZodOptional<z.ZodString>;
+        contentHash: z.ZodString;
+    }, z.core.$strict>>;
+    warnings: z.ZodArray<z.ZodObject<{
+        code: z.ZodEnum<{
+            "insufficient-evidence": "insufficient-evidence";
+            "partial-context": "partial-context";
+            "source-truncated": "source-truncated";
+            "source-stale": "source-stale";
+        }>;
+    }, z.core.$strict>>;
+    createdAt: z.ZodISODateTime;
+    expiresAt: z.ZodISODateTime;
+}, z.core.$strict>;
+declare const contextualAskExecutorCapabilitySchema: z.ZodObject<{
+    executorId: z.ZodString;
+    kind: z.ZodEnum<{
+        "configured-key": "configured-key";
+        "managed-codex": "managed-codex";
+    }>;
+    label: z.ZodString;
+    requestedModelLabel: z.ZodString;
+    effectiveModelLabel: z.ZodString;
+    models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    state: z.ZodEnum<{
+        ready: "ready";
+        degraded: "degraded";
+        unavailable: "unavailable";
+    }>;
+    providerDataConsentRequired: z.ZodBoolean;
+    readOnlyProven: z.ZodBoolean;
+    errorCode: z.ZodOptional<z.ZodEnum<{
+        ASK_DISABLED: "ASK_DISABLED";
+        ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+        ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+        ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+        ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+        ASK_TIMEOUT: "ASK_TIMEOUT";
+        ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+        ASK_BUSY: "ASK_BUSY";
+        ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+        ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+        ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+        ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+        ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+        ASK_CANCELLED: "ASK_CANCELLED";
+        ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+        ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+    }>>;
+}, z.core.$strict>;
+declare const contextualAskCapabilitySchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    enabled: z.ZodBoolean;
+    executors: z.ZodArray<z.ZodObject<{
+        executorId: z.ZodString;
+        kind: z.ZodEnum<{
+            "configured-key": "configured-key";
+            "managed-codex": "managed-codex";
+        }>;
+        label: z.ZodString;
+        requestedModelLabel: z.ZodString;
+        effectiveModelLabel: z.ZodString;
+        models: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        state: z.ZodEnum<{
+            ready: "ready";
+            degraded: "degraded";
+            unavailable: "unavailable";
+        }>;
+        providerDataConsentRequired: z.ZodBoolean;
+        readOnlyProven: z.ZodBoolean;
+        errorCode: z.ZodOptional<z.ZodEnum<{
+            ASK_DISABLED: "ASK_DISABLED";
+            ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+            ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+            ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+            ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+            ASK_TIMEOUT: "ASK_TIMEOUT";
+            ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+            ASK_BUSY: "ASK_BUSY";
+            ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+            ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+            ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+            ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+            ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+            ASK_CANCELLED: "ASK_CANCELLED";
+            ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+            ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+        }>>;
+    }, z.core.$strict>>;
+    safety: z.ZodObject<{
+        selectionRequired: z.ZodLiteral<true>;
+        singleTurn: z.ZodLiteral<true>;
+        writesAllowed: z.ZodLiteral<false>;
+        historyStored: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+    checkedAt: z.ZodISODateTime;
+}, z.core.$strict>;
+type ContextualAskExecutorPreference = z.infer<typeof contextualAskExecutorPreferenceSchema>;
+type ContextualAskOptions = z.infer<typeof contextualAskOptionsSchema>;
+type SpotSelectionTarget = z.infer<typeof spotSelectionTargetSchema>;
+type SpotSelectionContext = z.infer<typeof spotSelectionContextSchema>;
+type AskDraftOrigin = z.infer<typeof askDraftOriginSchema>;
+type SpotAskTaskEnvelope = z.infer<typeof spotAskTaskEnvelopeSchema>;
+type SpotChangeTaskEnvelope = z.infer<typeof spotChangeTaskEnvelopeSchema>;
+type SpotTaskEnvelope = z.infer<typeof spotTaskEnvelopeSchema>;
+type AskAnswerWarning = z.infer<typeof askAnswerWarningSchema>;
+type AskDraftCitation = z.infer<typeof askDraftCitationSchema>;
+type AskAnswerDraftBlock = z.infer<typeof askAnswerDraftBlockSchema>;
+type AskAnswerDraft = z.infer<typeof askAnswerDraftSchema>;
+type AskAnswerBlock = z.infer<typeof askAnswerBlockSchema>;
+type AskSourceReference = z.infer<typeof askSourceReferenceSchema>;
+type AskAnswerResult = z.infer<typeof askAnswerResultSchema>;
+type ContextualAskExecutorCapability = z.infer<typeof contextualAskExecutorCapabilitySchema>;
+type ContextualAskCapability = z.infer<typeof contextualAskCapabilitySchema>;
+
+declare const contextualAskCapabilityRequestSchema: z.ZodObject<{}, z.core.$strict>;
+declare const askJobCreateRequestSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    requestId: z.ZodString;
+    envelope: z.ZodObject<{
+        task: z.ZodObject<{
+            kind: z.ZodLiteral<"ask">;
+            question: z.ZodString;
+        }, z.core.$strict>;
+        schemaVersion: z.ZodLiteral<1>;
+        taskId: z.ZodString;
+        selection: z.ZodObject<{
+            schemaVersion: z.ZodLiteral<1>;
+            selectionId: z.ZodString;
+            locale: z.ZodEnum<{
+                "en-US": "en-US";
+                "zh-CN": "zh-CN";
+            }>;
+            targets: z.ZodArray<z.ZodObject<{
+                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";
+                        "astro-host": "astro-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";
+                            "astro-host": "astro-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>;
+                warnings: z.ZodArray<z.ZodString>;
+                code: z.ZodOptional<z.ZodObject<{
+                    relativePath: z.ZodString;
+                    language: z.ZodEnum<{
+                        tsx: "tsx";
+                        jsx: "jsx";
+                        astro: "astro";
+                    }>;
+                    startLine: z.ZodNumber;
+                    endLine: z.ZodNumber;
+                    excerpt: z.ZodString;
+                    boundary: z.ZodEnum<{
+                        component: "component";
+                        "nearby-lines": "nearby-lines";
+                    }>;
+                }, z.core.$strict>>;
+                targetId: z.ZodString;
+                page: z.ZodObject<{
+                    url: z.ZodString;
+                    pathname: z.ZodString;
+                    title: z.ZodString;
+                    viewportWidth: z.ZodNumber;
+                    viewportHeight: z.ZodNumber;
+                    devicePixelRatio: z.ZodNumber;
+                }, z.core.$strict>;
+            }, z.core.$strict>>;
+            createdAt: z.ZodISODateTime;
+        }, z.core.$strict>;
+        createdAt: z.ZodISODateTime;
+    }, z.core.$strict>;
+    executorId: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    providerDataConsent: z.ZodLiteral<true>;
+}, z.core.$strict>;
+declare const askJobActionRequestSchema: z.ZodObject<{}, z.core.$strict>;
+declare const askJobEventsRequestSchema: z.ZodObject<{
+    afterSequence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+declare const askJobSnapshotSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    jobId: z.ZodString;
+    selectionId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        authorizing: "authorizing";
+        running: "running";
+        cancelling: "cancelling";
+        answered: "answered";
+        cancelled: "cancelled";
+        failed: "failed";
+    }>;
+    executor: z.ZodObject<{
+        executorId: z.ZodString;
+        kind: z.ZodEnum<{
+            "configured-key": "configured-key";
+            "managed-codex": "managed-codex";
+        }>;
+        label: z.ZodString;
+        modelLabel: z.ZodString;
+    }, z.core.$strict>;
+    phaseMessage: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+    canCancel: z.ZodBoolean;
+    errorCode: z.ZodOptional<z.ZodEnum<{
+        ASK_DISABLED: "ASK_DISABLED";
+        ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+        ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+        ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+        ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+        ASK_TIMEOUT: "ASK_TIMEOUT";
+        ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+        ASK_BUSY: "ASK_BUSY";
+        ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+        ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+        ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+        ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+        ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+        ASK_CANCELLED: "ASK_CANCELLED";
+        ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+        ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+    }>>;
+}, z.core.$strict>;
+declare const askJobResultResponseSchema: z.ZodObject<{
+    snapshot: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        jobId: z.ZodString;
+        selectionId: z.ZodString;
+        status: z.ZodEnum<{
+            queued: "queued";
+            authorizing: "authorizing";
+            running: "running";
+            cancelling: "cancelling";
+            answered: "answered";
+            cancelled: "cancelled";
+            failed: "failed";
+        }>;
+        executor: z.ZodObject<{
+            executorId: z.ZodString;
+            kind: z.ZodEnum<{
+                "configured-key": "configured-key";
+                "managed-codex": "managed-codex";
+            }>;
+            label: z.ZodString;
+            modelLabel: z.ZodString;
+        }, z.core.$strict>;
+        phaseMessage: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        canCancel: z.ZodBoolean;
+        errorCode: z.ZodOptional<z.ZodEnum<{
+            ASK_DISABLED: "ASK_DISABLED";
+            ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+            ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+            ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+            ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+            ASK_TIMEOUT: "ASK_TIMEOUT";
+            ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+            ASK_BUSY: "ASK_BUSY";
+            ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+            ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+            ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+            ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+            ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+            ASK_CANCELLED: "ASK_CANCELLED";
+            ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+            ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+        }>>;
+    }, z.core.$strict>;
+    result: z.ZodOptional<z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        jobId: z.ZodString;
+        selectionId: z.ZodString;
+        contextHash: z.ZodString;
+        executor: z.ZodObject<{
+            executorId: z.ZodString;
+            kind: z.ZodEnum<{
+                "configured-key": "configured-key";
+                "managed-codex": "managed-codex";
+            }>;
+            label: z.ZodString;
+            modelLabel: z.ZodString;
+        }, z.core.$strict>;
+        blocks: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"paragraph">;
+            text: z.ZodString;
+            sourceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"list">;
+            items: z.ZodArray<z.ZodObject<{
+                text: z.ZodString;
+                sourceIds: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"code">;
+            code: z.ZodString;
+            language: z.ZodOptional<z.ZodString>;
+            sourceIds: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>], "kind">>;
+        sources: z.ZodArray<z.ZodObject<{
+            sourceId: z.ZodString;
+            label: z.ZodString;
+            relativePath: z.ZodString;
+            fileId: z.ZodString;
+            startLine: z.ZodNumber;
+            endLine: z.ZodNumber;
+            confidence: z.ZodEnum<{
+                exact: "exact";
+                probable: "probable";
+                approximate: "approximate";
+            }>;
+            targetIds: z.ZodArray<z.ZodString>;
+            sourceVersion: z.ZodOptional<z.ZodString>;
+            contentHash: z.ZodString;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodObject<{
+            code: z.ZodEnum<{
+                "insufficient-evidence": "insufficient-evidence";
+                "partial-context": "partial-context";
+                "source-truncated": "source-truncated";
+                "source-stale": "source-stale";
+            }>;
+        }, z.core.$strict>>;
+        createdAt: z.ZodISODateTime;
+        expiresAt: z.ZodISODateTime;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+declare const askJobEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"snapshot">;
+    snapshot: z.ZodObject<{
+        schemaVersion: z.ZodLiteral<1>;
+        jobId: z.ZodString;
+        selectionId: z.ZodString;
+        status: z.ZodEnum<{
+            queued: "queued";
+            authorizing: "authorizing";
+            running: "running";
+            cancelling: "cancelling";
+            answered: "answered";
+            cancelled: "cancelled";
+            failed: "failed";
+        }>;
+        executor: z.ZodObject<{
+            executorId: z.ZodString;
+            kind: z.ZodEnum<{
+                "configured-key": "configured-key";
+                "managed-codex": "managed-codex";
+            }>;
+            label: z.ZodString;
+            modelLabel: z.ZodString;
+        }, z.core.$strict>;
+        phaseMessage: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodISODateTime;
+        updatedAt: z.ZodISODateTime;
+        canCancel: z.ZodBoolean;
+        errorCode: z.ZodOptional<z.ZodEnum<{
+            ASK_DISABLED: "ASK_DISABLED";
+            ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+            ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+            ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+            ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+            ASK_TIMEOUT: "ASK_TIMEOUT";
+            ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+            ASK_BUSY: "ASK_BUSY";
+            ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+            ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+            ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+            ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+            ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+            ASK_CANCELLED: "ASK_CANCELLED";
+            ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+            ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+        }>>;
+    }, z.core.$strict>;
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        authorizing: "authorizing";
+        running: "running";
+        cancelling: "cancelling";
+        answered: "answered";
+        cancelled: "cancelled";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"phase">;
+    message: z.ZodString;
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        authorizing: "authorizing";
+        running: "running";
+        cancelling: "cancelling";
+        answered: "answered";
+        cancelled: "cancelled";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"read-activity">;
+    activity: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"source">;
+        sourceId: z.ZodString;
+        relativePath: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"file-count">;
+        bucket: z.ZodEnum<{
+            one: "one";
+            few: "few";
+            many: "many";
+        }>;
+    }, z.core.$strict>], "kind">;
+    state: z.ZodEnum<{
+        failed: "failed";
+        started: "started";
+        succeeded: "succeeded";
+    }>;
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        authorizing: "authorizing";
+        running: "running";
+        cancelling: "cancelling";
+        answered: "answered";
+        cancelled: "cancelled";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"answer-ready">;
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        authorizing: "authorizing";
+        running: "running";
+        cancelling: "cancelling";
+        answered: "answered";
+        cancelled: "cancelled";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    errorCode: z.ZodEnum<{
+        ASK_DISABLED: "ASK_DISABLED";
+        ASK_SELECTION_REQUIRED: "ASK_SELECTION_REQUIRED";
+        ASK_SELECTION_STALE: "ASK_SELECTION_STALE";
+        ASK_QUESTION_INVALID: "ASK_QUESTION_INVALID";
+        ASK_EXECUTOR_UNAVAILABLE: "ASK_EXECUTOR_UNAVAILABLE";
+        ASK_TIMEOUT: "ASK_TIMEOUT";
+        ASK_CONSENT_REQUIRED: "ASK_CONSENT_REQUIRED";
+        ASK_BUSY: "ASK_BUSY";
+        ASK_IDEMPOTENCY_CONFLICT: "ASK_IDEMPOTENCY_CONFLICT";
+        ASK_SOURCE_SCOPE_DENIED: "ASK_SOURCE_SCOPE_DENIED";
+        ASK_LIMIT_EXCEEDED: "ASK_LIMIT_EXCEEDED";
+        ASK_ANSWER_INVALID: "ASK_ANSWER_INVALID";
+        ASK_WRITE_ATTEMPTED: "ASK_WRITE_ATTEMPTED";
+        ASK_CANCELLED: "ASK_CANCELLED";
+        ASK_RESULT_EXPIRED: "ASK_RESULT_EXPIRED";
+        ASK_PROTOCOL_INCOMPATIBLE: "ASK_PROTOCOL_INCOMPATIBLE";
+    }>;
+    schemaVersion: z.ZodLiteral<1>;
+    sequence: z.ZodNumber;
+    jobId: z.ZodString;
+    status: z.ZodEnum<{
+        queued: "queued";
+        authorizing: "authorizing";
+        running: "running";
+        cancelling: "cancelling";
+        answered: "answered";
+        cancelled: "cancelled";
+        failed: "failed";
+    }>;
+    timestamp: z.ZodISODateTime;
+}, z.core.$strict>], "type">;
+type ContextualAskCapabilityRequest = z.infer<typeof contextualAskCapabilityRequestSchema>;
+type AskJobCreateRequest = z.infer<typeof askJobCreateRequestSchema>;
+type AskJobActionRequest = z.infer<typeof askJobActionRequestSchema>;
+type AskJobEventsRequest = z.infer<typeof askJobEventsRequestSchema>;
+type AskJobSnapshot = z.infer<typeof askJobSnapshotSchema>;
+type AskJobResultResponse = z.infer<typeof askJobResultResponseSchema>;
+type AskJobEvent = z.infer<typeof askJobEventSchema>;
+
+export { askJobEventsRequestSchema as $, ASK_ANSWER_WARNING_CODES as A, type ContextualAskCapabilityRequest as B, CONTEXTUAL_ASK_EXECUTOR_KINDS as C, type ContextualAskExecutorCapability as D, type ContextualAskExecutorKind as E, type ContextualAskExecutorState as F, type SpotChangeTaskEnvelope as G, type SpotSelectionContext as H, type SpotSelectionTarget as I, type SpotTaskEnvelope as J, type AskAnswerDraft as K, type AskAnswerDraftBlock as L, type AskDraftCitation as M, CONTEXTUAL_ASK_PERMISSION_PROFILE as N, type ContextualAskExecutorPreference as O, type ContextualAskOptions as P, askAnswerBlockSchema as Q, askAnswerDraftBlockSchema as R, type SpotAskTaskEnvelope as S, askAnswerDraftSchema as T, askAnswerResultSchema as U, askAnswerWarningSchema as V, askDraftCitationSchema as W, askDraftOriginSchema as X, askJobActionRequestSchema as Y, askJobCreateRequestSchema as Z, askJobEventSchema as _, ASK_EXECUTOR_ANSWER_WARNING_CODES as a, askJobResultResponseSchema as a0, askJobSnapshotSchema as a1, askSourceReferenceSchema as a2, contextualAskCapabilityRequestSchema as a3, contextualAskCapabilitySchema as a4, contextualAskExecutorCapabilitySchema as a5, contextualAskExecutorPreferenceSchema as a6, contextualAskOptionsSchema as a7, spotAskTaskEnvelopeSchema as a8, spotChangeTaskEnvelopeSchema as a9, spotSelectionContextSchema as aa, spotSelectionTargetSchema as ab, spotTaskEnvelopeSchema as ac, ASK_FILE_COUNT_BUCKETS as b, ASK_JOB_STATUSES as c, ASK_READ_ACTIVITY_STATES as d, ASK_SOURCE_CONFIDENCES as e, type AskAnswerBlock as f, type AskAnswerResult as g, type AskAnswerWarning as h, type AskAnswerWarningCode as i, type AskDraftOrigin as j, type AskExecutorAnswerWarningCode as k, type AskFileCountBucket as l, type AskJobActionRequest as m, type AskJobCreateRequest as n, type AskJobEvent as o, type AskJobEventsRequest as p, type AskJobResultResponse as q, type AskJobSnapshot as r, type AskJobStatus as s, type AskReadActivityState as t, type AskSourceConfidence as u, type AskSourceReference as v, CONTEXTUAL_ASK_EXECUTOR_STATES as w, CONTEXTUAL_ASK_LIMITS as x, CONTEXTUAL_ASK_SCHEMA_VERSION as y, type ContextualAskCapability as z };