@clicksmith/core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2320 @@
+import { z } from 'zod';
+
+/**
+ * The current {@link CaptureBundle} schema version. Bumped whenever the wire
+ * format changes in a backward-incompatible way.
+ */
+declare const CURRENT_BUNDLE_VERSION: 5;
+/**
+ * A `source` locator is the most precise: it points at the exact file/line that
+ * rendered the element, recovered from a dev-only `data-loc` attribute injected
+ * by `@clicksmith/unplugin`.
+ */
+declare const SourceLocatorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"source">;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodOptional<z.ZodNumber>;
+    export: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "source";
+    file: string;
+    line: number;
+    column?: number | undefined;
+    export?: string | undefined;
+}, {
+    kind: "source";
+    file: string;
+    line: number;
+    column?: number | undefined;
+    export?: string | undefined;
+}>;
+/** A stable, author-provided attribute such as `data-testid` or `id`. */
+declare const AttrLocatorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"attr">;
+    attr: z.ZodString;
+    value: z.ZodString;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "attr";
+    value: string;
+    attr: string;
+    selector: string;
+}, {
+    kind: "attr";
+    value: string;
+    attr: string;
+    selector: string;
+}>;
+/** An accessibility-based locator: ARIA role + accessible name. */
+declare const BehavioralLocatorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"behavioral">;
+    role: z.ZodString;
+    name: z.ZodString;
+    nth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "behavioral";
+    role: string;
+    name: string;
+    nth?: number | undefined;
+}, {
+    kind: "behavioral";
+    role: string;
+    name: string;
+    nth?: number | undefined;
+}>;
+/** Last-resort structural locator: a CSS selector plus a DOM fingerprint. */
+declare const DomLocatorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"dom">;
+    selector: z.ZodString;
+    fingerprint: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "dom";
+    selector: string;
+    fingerprint: string;
+}, {
+    kind: "dom";
+    selector: string;
+    fingerprint: string;
+}>;
+/**
+ * Discriminated union of all locator kinds, ranked exactly
+ * `source -> attr -> behavioral -> dom` (see `locator.ts`).
+ */
+declare const LocatorSchema: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+    kind: z.ZodLiteral<"source">;
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodOptional<z.ZodNumber>;
+    export: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "source";
+    file: string;
+    line: number;
+    column?: number | undefined;
+    export?: string | undefined;
+}, {
+    kind: "source";
+    file: string;
+    line: number;
+    column?: number | undefined;
+    export?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"attr">;
+    attr: z.ZodString;
+    value: z.ZodString;
+    selector: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "attr";
+    value: string;
+    attr: string;
+    selector: string;
+}, {
+    kind: "attr";
+    value: string;
+    attr: string;
+    selector: string;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"behavioral">;
+    role: z.ZodString;
+    name: z.ZodString;
+    nth: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "behavioral";
+    role: string;
+    name: string;
+    nth?: number | undefined;
+}, {
+    kind: "behavioral";
+    role: string;
+    name: string;
+    nth?: number | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"dom">;
+    selector: z.ZodString;
+    fingerprint: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: "dom";
+    selector: string;
+    fingerprint: string;
+}, {
+    kind: "dom";
+    selector: string;
+    fingerprint: string;
+}>]>;
+declare const ElementDescriptorSchema: z.ZodObject<{
+    tag: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    iconHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    tag: string;
+    attrs: Record<string, string>;
+    role?: string | undefined;
+    text?: string | undefined;
+    label?: string | undefined;
+    iconHints?: string[] | undefined;
+}, {
+    tag: string;
+    role?: string | undefined;
+    text?: string | undefined;
+    label?: string | undefined;
+    attrs?: Record<string, string> | undefined;
+    iconHints?: string[] | undefined;
+}>;
+declare const NearContextSchema: z.ZodObject<{
+    labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    headings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    landmarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    parentText: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    labels?: string[] | undefined;
+    headings?: string[] | undefined;
+    landmarks?: string[] | undefined;
+    parentText?: string | undefined;
+}, {
+    labels?: string[] | undefined;
+    headings?: string[] | undefined;
+    landmarks?: string[] | undefined;
+    parentText?: string | undefined;
+}>;
+declare const ConditionsSchema: z.ZodObject<{
+    viewport: z.ZodObject<{
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        w: number;
+        h: number;
+    }, {
+        w: number;
+        h: number;
+    }>;
+    theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+    mediaQueries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    viewport: {
+        w: number;
+        h: number;
+    };
+    theme?: "light" | "dark" | undefined;
+    mediaQueries?: Record<string, boolean> | undefined;
+}, {
+    viewport: {
+        w: number;
+        h: number;
+    };
+    theme?: "light" | "dark" | undefined;
+    mediaQueries?: Record<string, boolean> | undefined;
+}>;
+declare const CapturedElementSchema: z.ZodObject<{
+    /** 1-based identifier surfaced to users as `#N`. Stable within a session. */
+    id: z.ZodNumber;
+    ts: z.ZodString;
+    locator: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"source">;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+        export: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    }, {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"attr">;
+        attr: z.ZodString;
+        value: z.ZodString;
+        selector: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    }, {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"behavioral">;
+        role: z.ZodString;
+        name: z.ZodString;
+        nth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    }, {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"dom">;
+        selector: z.ZodString;
+        fingerprint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    }, {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    }>]>;
+    el: z.ZodObject<{
+        tag: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        iconHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        tag: string;
+        attrs: Record<string, string>;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        iconHints?: string[] | undefined;
+    }, {
+        tag: string;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        attrs?: Record<string, string> | undefined;
+        iconHints?: string[] | undefined;
+    }>;
+    near: z.ZodDefault<z.ZodObject<{
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        headings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        landmarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        parentText: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    }, {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    }>>;
+    conditions: z.ZodObject<{
+        viewport: z.ZodObject<{
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            w: number;
+            h: number;
+        }, {
+            w: number;
+            h: number;
+        }>;
+        theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+        mediaQueries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    }, {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    }>;
+    screenshot: z.ZodOptional<z.ZodString>;
+    frameworkHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    id: number;
+    ts: string;
+    locator: {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    } | {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    } | {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    } | {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    };
+    el: {
+        tag: string;
+        attrs: Record<string, string>;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        iconHints?: string[] | undefined;
+    };
+    near: {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    };
+    conditions: {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    };
+    screenshot?: string | undefined;
+    frameworkHints?: Record<string, unknown> | undefined;
+}, {
+    id: number;
+    ts: string;
+    locator: {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    } | {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    } | {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    } | {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    };
+    el: {
+        tag: string;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        attrs?: Record<string, string> | undefined;
+        iconHints?: string[] | undefined;
+    };
+    conditions: {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    };
+    near?: {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    } | undefined;
+    screenshot?: string | undefined;
+    frameworkHints?: Record<string, unknown> | undefined;
+}>;
+declare const ExecutionModeSchema: z.ZodEnum<["plan", "edit"]>;
+declare const IsolationSchema: z.ZodEnum<["worktree", "branch", "inplace"]>;
+/**
+ * How a run should be executed. The defaults — `plan` + `worktree` + no
+ * auto-apply — are the immutable safe path. Any deviation (edit mode, inplace
+ * isolation, or auto-apply) is a risky option requiring explicit confirmation.
+ */
+declare const ExecutionOptionsSchema: z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<["plan", "edit"]>>;
+    isolation: z.ZodDefault<z.ZodEnum<["worktree", "branch", "inplace"]>>;
+    autoApply: z.ZodDefault<z.ZodBoolean>;
+    agentId: z.ZodOptional<z.ZodString>;
+    /** Git ref the sandbox should branch from. Defaults to the current HEAD. */
+    baseRef: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    mode: "plan" | "edit";
+    isolation: "worktree" | "branch" | "inplace";
+    autoApply: boolean;
+    agentId?: string | undefined;
+    baseRef?: string | undefined;
+}, {
+    mode?: "plan" | "edit" | undefined;
+    isolation?: "worktree" | "branch" | "inplace" | undefined;
+    autoApply?: boolean | undefined;
+    agentId?: string | undefined;
+    baseRef?: string | undefined;
+}>;
+declare const ElementEnrichmentSchema: z.ZodObject<{
+    elementId: z.ZodNumber;
+    reviewContext: z.ZodOptional<z.ZodString>;
+    impactRadius: z.ZodOptional<z.ZodUnknown>;
+    affectedFlows: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    elementId: number;
+    reviewContext?: string | undefined;
+    impactRadius?: unknown;
+    affectedFlows?: unknown;
+}, {
+    elementId: number;
+    reviewContext?: string | undefined;
+    impactRadius?: unknown;
+    affectedFlows?: unknown;
+}>;
+declare const EnrichmentSchema: z.ZodObject<{
+    source: z.ZodLiteral<"code-review-graph">;
+    perElement: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        elementId: z.ZodNumber;
+        reviewContext: z.ZodOptional<z.ZodString>;
+        impactRadius: z.ZodOptional<z.ZodUnknown>;
+        affectedFlows: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        elementId: number;
+        reviewContext?: string | undefined;
+        impactRadius?: unknown;
+        affectedFlows?: unknown;
+    }, {
+        elementId: number;
+        reviewContext?: string | undefined;
+        impactRadius?: unknown;
+        affectedFlows?: unknown;
+    }>, "many">>;
+    warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    source: "code-review-graph";
+    perElement: {
+        elementId: number;
+        reviewContext?: string | undefined;
+        impactRadius?: unknown;
+        affectedFlows?: unknown;
+    }[];
+    warnings: string[];
+}, {
+    source: "code-review-graph";
+    perElement?: {
+        elementId: number;
+        reviewContext?: string | undefined;
+        impactRadius?: unknown;
+        affectedFlows?: unknown;
+    }[] | undefined;
+    warnings?: string[] | undefined;
+}>;
+declare const AppContextSchema: z.ZodObject<{
+    url: z.ZodString;
+    route: z.ZodString;
+    page: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    route: string;
+    page?: string | undefined;
+}, {
+    url: string;
+    route: string;
+    page?: string | undefined;
+}>;
+/**
+ * The finalized, agent-ready payload produced when a user submits a session.
+ * Version 5.
+ */
+declare const CaptureBundleSchema: z.ZodObject<{
+    v: z.ZodLiteral<5>;
+    sessionId: z.ZodString;
+    submittedAt: z.ZodString;
+    prompt: z.ZodString;
+    app: z.ZodObject<{
+        url: z.ZodString;
+        route: z.ZodString;
+        page: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    }, {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    }>;
+    elements: z.ZodArray<z.ZodObject<{
+        /** 1-based identifier surfaced to users as `#N`. Stable within a session. */
+        id: z.ZodNumber;
+        ts: z.ZodString;
+        locator: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"source">;
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+            export: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        }, {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"attr">;
+            attr: z.ZodString;
+            value: z.ZodString;
+            selector: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        }, {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"behavioral">;
+            role: z.ZodString;
+            name: z.ZodString;
+            nth: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        }, {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"dom">;
+            selector: z.ZodString;
+            fingerprint: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        }, {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        }>]>;
+        el: z.ZodObject<{
+            tag: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            iconHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        }, {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        }>;
+        near: z.ZodDefault<z.ZodObject<{
+            labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            headings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            landmarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            parentText: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        }, {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        }>>;
+        conditions: z.ZodObject<{
+            viewport: z.ZodObject<{
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                w: number;
+                h: number;
+            }, {
+                w: number;
+                h: number;
+            }>;
+            theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+            mediaQueries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        }, {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        }>;
+        screenshot: z.ZodOptional<z.ZodString>;
+        frameworkHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        };
+        near: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }, {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        near?: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        } | undefined;
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }>, "many">;
+    execution: z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<["plan", "edit"]>>;
+        isolation: z.ZodDefault<z.ZodEnum<["worktree", "branch", "inplace"]>>;
+        autoApply: z.ZodDefault<z.ZodBoolean>;
+        agentId: z.ZodOptional<z.ZodString>;
+        /** Git ref the sandbox should branch from. Defaults to the current HEAD. */
+        baseRef: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "plan" | "edit";
+        isolation: "worktree" | "branch" | "inplace";
+        autoApply: boolean;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    }, {
+        mode?: "plan" | "edit" | undefined;
+        isolation?: "worktree" | "branch" | "inplace" | undefined;
+        autoApply?: boolean | undefined;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    }>;
+    enrichment: z.ZodOptional<z.ZodObject<{
+        source: z.ZodLiteral<"code-review-graph">;
+        perElement: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            elementId: z.ZodNumber;
+            reviewContext: z.ZodOptional<z.ZodString>;
+            impactRadius: z.ZodOptional<z.ZodUnknown>;
+            affectedFlows: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }, {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }>, "many">>;
+        warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        source: "code-review-graph";
+        perElement: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[];
+        warnings: string[];
+    }, {
+        source: "code-review-graph";
+        perElement?: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[] | undefined;
+        warnings?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    v: 5;
+    sessionId: string;
+    submittedAt: string;
+    prompt: string;
+    app: {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    };
+    elements: {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        };
+        near: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }[];
+    execution: {
+        mode: "plan" | "edit";
+        isolation: "worktree" | "branch" | "inplace";
+        autoApply: boolean;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    };
+    enrichment?: {
+        source: "code-review-graph";
+        perElement: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[];
+        warnings: string[];
+    } | undefined;
+}, {
+    v: 5;
+    sessionId: string;
+    submittedAt: string;
+    prompt: string;
+    app: {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    };
+    elements: {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        near?: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        } | undefined;
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }[];
+    execution: {
+        mode?: "plan" | "edit" | undefined;
+        isolation?: "worktree" | "branch" | "inplace" | undefined;
+        autoApply?: boolean | undefined;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    };
+    enrichment?: {
+        source: "code-review-graph";
+        perElement?: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[] | undefined;
+        warnings?: string[] | undefined;
+    } | undefined;
+}>;
+declare const SessionStatusSchema: z.ZodEnum<["active", "submitted", "expired"]>;
+/**
+ * An in-progress capture session held by the daemon before the user submits.
+ * Finalizing a session produces a {@link CaptureBundleSchema}.
+ */
+declare const SessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    expiresAt: z.ZodString;
+    status: z.ZodDefault<z.ZodEnum<["active", "submitted", "expired"]>>;
+    app: z.ZodObject<{
+        url: z.ZodString;
+        route: z.ZodString;
+        page: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    }, {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    }>;
+    elements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        /** 1-based identifier surfaced to users as `#N`. Stable within a session. */
+        id: z.ZodNumber;
+        ts: z.ZodString;
+        locator: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"source">;
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+            export: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        }, {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"attr">;
+            attr: z.ZodString;
+            value: z.ZodString;
+            selector: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        }, {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"behavioral">;
+            role: z.ZodString;
+            name: z.ZodString;
+            nth: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        }, {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"dom">;
+            selector: z.ZodString;
+            fingerprint: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        }, {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        }>]>;
+        el: z.ZodObject<{
+            tag: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            iconHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        }, {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        }>;
+        near: z.ZodDefault<z.ZodObject<{
+            labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            headings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            landmarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            parentText: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        }, {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        }>>;
+        conditions: z.ZodObject<{
+            viewport: z.ZodObject<{
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                w: number;
+                h: number;
+            }, {
+                w: number;
+                h: number;
+            }>;
+            theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+            mediaQueries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        }, {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        }>;
+        screenshot: z.ZodOptional<z.ZodString>;
+        frameworkHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        };
+        near: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }, {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        near?: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        } | undefined;
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }>, "many">>;
+    prompt: z.ZodOptional<z.ZodString>;
+    /**
+     * High-water mark of element ids ever assigned. Ensures `#N` ids are never
+     * reused, even after the highest-numbered element is removed.
+     */
+    lastElementId: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "submitted" | "expired";
+    id: string;
+    app: {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    };
+    elements: {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        };
+        near: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }[];
+    createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+    lastElementId: number;
+    prompt?: string | undefined;
+}, {
+    id: string;
+    app: {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    };
+    createdAt: string;
+    updatedAt: string;
+    expiresAt: string;
+    status?: "active" | "submitted" | "expired" | undefined;
+    prompt?: string | undefined;
+    elements?: {
+        id: number;
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        near?: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        } | undefined;
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }[] | undefined;
+    lastElementId?: number | undefined;
+}>;
+
+type SourceLocator = z.infer<typeof SourceLocatorSchema>;
+type AttrLocator = z.infer<typeof AttrLocatorSchema>;
+type BehavioralLocator = z.infer<typeof BehavioralLocatorSchema>;
+type DomLocator = z.infer<typeof DomLocatorSchema>;
+type Locator = z.infer<typeof LocatorSchema>;
+type LocatorKind = Locator['kind'];
+type ElementDescriptor = z.infer<typeof ElementDescriptorSchema>;
+type NearContext = z.infer<typeof NearContextSchema>;
+type Conditions = z.infer<typeof ConditionsSchema>;
+type CapturedElement = z.infer<typeof CapturedElementSchema>;
+type ExecutionMode = z.infer<typeof ExecutionModeSchema>;
+type Isolation = z.infer<typeof IsolationSchema>;
+type ExecutionOptions = z.infer<typeof ExecutionOptionsSchema>;
+type ElementEnrichment = z.infer<typeof ElementEnrichmentSchema>;
+type Enrichment = z.infer<typeof EnrichmentSchema>;
+type AppContext = z.infer<typeof AppContextSchema>;
+type CaptureBundle = z.infer<typeof CaptureBundleSchema>;
+type SessionStatus = z.infer<typeof SessionStatusSchema>;
+type Session = z.infer<typeof SessionSchema>;
+/**
+ * The shape the extension sends when capturing an element — everything in a
+ * {@link CapturedElement} except the daemon-assigned `id`.
+ */
+type CapturedElementInput = Omit<CapturedElement, 'id'>;
+
+/**
+ * Platform-neutral identifier helpers. These rely only on the Web Crypto API
+ * (`globalThis.crypto`), which is available in modern browsers and Node >= 20,
+ * with a deterministic-enough fallback so `core` never imports `node:crypto`.
+ */
+/** A new opaque session id, e.g. `cs_lt4f9q_a1b2c3d4`. */
+declare function newSessionId(now?: Date): string;
+/** A new opaque run id, e.g. `run_lt4f9q_a1b2c3d4`. */
+declare function newRunId(now?: Date): string;
+/**
+ * Assign the next element id for a session. Ids are 1-based, strictly
+ * increasing, and never reused — even after the highest-numbered mark is
+ * removed — so user-typed references like `#2` remain stable for the life of
+ * the session. Pass the session's high-water mark (`lastElementId`) so removal
+ * of the top id still advances the counter.
+ */
+declare function nextElementId(existingIds: readonly number[], lastSeen?: number): number;
+/** Parse a `#N` reference (e.g. `"#3"`, `"3"`, `"# 3"`) into a number. */
+declare function parseElementRef(ref: string): number | undefined;
+
+/**
+ * The canonical locator priority, best first. This ordering is a hard contract
+ * shared by the extension (which picks the best locator it can build) and the
+ * agent instructions (which teach the agent to trust higher-ranked locators).
+ */
+declare const LOCATOR_PRIORITY: readonly ["source", "attr", "behavioral", "dom"];
+/** Numeric rank of a locator kind; lower is more precise. */
+declare function locatorRank(kind: LocatorKind): number;
+/**
+ * Comparator for `Array.prototype.sort`, ordering locators best-first per
+ * {@link LOCATOR_PRIORITY}.
+ */
+declare function compareLocators(a: Locator, b: Locator): number;
+/** Return a new array of locators sorted best-first. Does not mutate input. */
+declare function rankLocators(locators: readonly Locator[]): Locator[];
+/** The single most precise locator from a list, or `undefined` if empty. */
+declare function pickBestLocator(locators: readonly Locator[]): Locator | undefined;
+/**
+ * A compact, human- and agent-readable description of a locator, suitable for
+ * embedding in instructions or logs.
+ */
+declare function describeLocator(locator: Locator): string;
+/** Whether a locator points directly at source (the strongest signal). */
+declare function isSourceResolved(locator: Locator): boolean;
+
+/** Default localhost port the daemon listens on. */
+declare const DEFAULT_DAEMON_PORT = 8722;
+/** Default localhost host. ClickSmith only ever binds loopback. */
+declare const DEFAULT_DAEMON_HOST = "127.0.0.1";
+/** Default time-to-live for an unfinished capture session: 24 hours. */
+declare const DEFAULT_SESSION_TTL_MS: number;
+/**
+ * The immutable safe defaults: plan mode, worktree isolation, no auto-apply.
+ * Any change away from these is considered a "risky option".
+ */
+declare const DEFAULT_EXECUTION_OPTIONS: ExecutionOptions;
+/**
+ * Whether a set of execution options deviates from the safe defaults and
+ * therefore requires explicit user confirmation in the extension/CLI:
+ * non-plan mode, in-place isolation, or auto-apply.
+ */
+declare function requiresConfirmation(execution: ExecutionOptions): boolean;
+/** Human-readable reasons a given execution config is considered risky. */
+declare function confirmationReasons(execution: ExecutionOptions): string[];
+
+interface CreateSessionInput {
+    app: AppContext;
+    now?: Date;
+    ttlMs?: number;
+    id?: string;
+}
+/** Create a fresh, empty, active capture session. Pure. */
+declare function createSession(input: CreateSessionInput): Session;
+/**
+ * Append a captured element to a session, assigning the next stable id. Returns
+ * a new session plus the fully-formed element (so callers know the assigned id).
+ * Pure — the input session is not mutated.
+ */
+declare function appendElement(session: Session, input: CapturedElementInput, now?: Date): {
+    session: Session;
+    element: CapturedElement;
+};
+/**
+ * Remove a captured element by id. Ids are never renumbered, keeping existing
+ * `#N` references valid. Returns the new session and whether anything changed.
+ * Pure.
+ */
+declare function removeElement(session: Session, elementId: number, now?: Date): {
+    session: Session;
+    removed: boolean;
+};
+/** Find a captured element by its `#N` id. */
+declare function findElement(session: Session, elementId: number): CapturedElement | undefined;
+/** Whether a session has passed its expiry (and was never submitted). */
+declare function isExpired(session: Session, now?: Date): boolean;
+/** Slide a session's expiry forward by `ttlMs` from `now`. Pure. */
+declare function touchSession(session: Session, now?: Date, ttlMs?: number): Session;
+interface FinalizeInput {
+    prompt: string;
+    execution?: ExecutionOptions;
+    submittedAt?: Date;
+    enrichment?: CaptureBundle['enrichment'];
+}
+/**
+ * Finalize a session into a validated v5 {@link CaptureBundle}. Throws if the
+ * session has no elements or the prompt is empty. Does not mutate the session.
+ */
+declare function finalizeSession(session: Session, input: FinalizeInput): CaptureBundle;
+
+type ValidationResult = {
+    ok: true;
+    bundle: CaptureBundle;
+} | {
+    ok: false;
+    error: z.ZodError;
+};
+/** Validate an unknown value as a {@link CaptureBundle} without throwing. */
+declare function validateBundle(value: unknown): ValidationResult;
+/** Validate and throw on failure (with a readable message). */
+declare function parseBundle(value: unknown): CaptureBundle;
+/** Deterministically serialize a bundle to JSON (stable key order, 2-space). */
+declare function serializeBundle(bundle: CaptureBundle): string;
+/** Parse a JSON string into a validated bundle. */
+declare function deserializeBundle(json: string): CaptureBundle;
+/** Whether a value claims to be the current bundle version. */
+declare function isCurrentVersion(value: unknown): boolean;
+
+/** The element payload the extension sends (everything but the daemon id). */
+declare const CapturedElementInputSchema: z.ZodObject<Omit<{
+    id: z.ZodNumber;
+    ts: z.ZodString;
+    locator: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"source">;
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodOptional<z.ZodNumber>;
+        export: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    }, {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"attr">;
+        attr: z.ZodString;
+        value: z.ZodString;
+        selector: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    }, {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"behavioral">;
+        role: z.ZodString;
+        name: z.ZodString;
+        nth: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    }, {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"dom">;
+        selector: z.ZodString;
+        fingerprint: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    }, {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    }>]>;
+    el: z.ZodObject<{
+        tag: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        label: z.ZodOptional<z.ZodString>;
+        attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        iconHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        tag: string;
+        attrs: Record<string, string>;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        iconHints?: string[] | undefined;
+    }, {
+        tag: string;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        attrs?: Record<string, string> | undefined;
+        iconHints?: string[] | undefined;
+    }>;
+    near: z.ZodDefault<z.ZodObject<{
+        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        headings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        landmarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        parentText: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    }, {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    }>>;
+    conditions: z.ZodObject<{
+        viewport: z.ZodObject<{
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            w: number;
+            h: number;
+        }, {
+            w: number;
+            h: number;
+        }>;
+        theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+        mediaQueries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    }, {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    }>;
+    screenshot: z.ZodOptional<z.ZodString>;
+    frameworkHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "id">, "strip", z.ZodTypeAny, {
+    ts: string;
+    locator: {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    } | {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    } | {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    } | {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    };
+    el: {
+        tag: string;
+        attrs: Record<string, string>;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        iconHints?: string[] | undefined;
+    };
+    near: {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    };
+    conditions: {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    };
+    screenshot?: string | undefined;
+    frameworkHints?: Record<string, unknown> | undefined;
+}, {
+    ts: string;
+    locator: {
+        kind: "source";
+        file: string;
+        line: number;
+        column?: number | undefined;
+        export?: string | undefined;
+    } | {
+        kind: "attr";
+        value: string;
+        attr: string;
+        selector: string;
+    } | {
+        kind: "behavioral";
+        role: string;
+        name: string;
+        nth?: number | undefined;
+    } | {
+        kind: "dom";
+        selector: string;
+        fingerprint: string;
+    };
+    el: {
+        tag: string;
+        role?: string | undefined;
+        text?: string | undefined;
+        label?: string | undefined;
+        attrs?: Record<string, string> | undefined;
+        iconHints?: string[] | undefined;
+    };
+    conditions: {
+        viewport: {
+            w: number;
+            h: number;
+        };
+        theme?: "light" | "dark" | undefined;
+        mediaQueries?: Record<string, boolean> | undefined;
+    };
+    near?: {
+        labels?: string[] | undefined;
+        headings?: string[] | undefined;
+        landmarks?: string[] | undefined;
+        parentText?: string | undefined;
+    } | undefined;
+    screenshot?: string | undefined;
+    frameworkHints?: Record<string, unknown> | undefined;
+}>;
+declare const CaptureRequestSchema: z.ZodObject<{
+    /** Append to this session if present; otherwise the daemon opens one. */
+    sessionId: z.ZodOptional<z.ZodString>;
+    app: z.ZodObject<{
+        url: z.ZodString;
+        route: z.ZodString;
+        page: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    }, {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    }>;
+    element: z.ZodObject<Omit<{
+        id: z.ZodNumber;
+        ts: z.ZodString;
+        locator: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"source">;
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodOptional<z.ZodNumber>;
+            export: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        }, {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"attr">;
+            attr: z.ZodString;
+            value: z.ZodString;
+            selector: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        }, {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"behavioral">;
+            role: z.ZodString;
+            name: z.ZodString;
+            nth: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        }, {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"dom">;
+            selector: z.ZodString;
+            fingerprint: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        }, {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        }>]>;
+        el: z.ZodObject<{
+            tag: z.ZodString;
+            text: z.ZodOptional<z.ZodString>;
+            role: z.ZodOptional<z.ZodString>;
+            label: z.ZodOptional<z.ZodString>;
+            attrs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            iconHints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        }, {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        }>;
+        near: z.ZodDefault<z.ZodObject<{
+            labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            headings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            landmarks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            parentText: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        }, {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        }>>;
+        conditions: z.ZodObject<{
+            viewport: z.ZodObject<{
+                w: z.ZodNumber;
+                h: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                w: number;
+                h: number;
+            }, {
+                w: number;
+                h: number;
+            }>;
+            theme: z.ZodOptional<z.ZodEnum<["light", "dark"]>>;
+            mediaQueries: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        }, {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        }>;
+        screenshot: z.ZodOptional<z.ZodString>;
+        frameworkHints: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "id">, "strip", z.ZodTypeAny, {
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        };
+        near: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }, {
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        near?: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        } | undefined;
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    app: {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    };
+    element: {
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            attrs: Record<string, string>;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            iconHints?: string[] | undefined;
+        };
+        near: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    };
+    sessionId?: string | undefined;
+}, {
+    app: {
+        url: string;
+        route: string;
+        page?: string | undefined;
+    };
+    element: {
+        ts: string;
+        locator: {
+            kind: "source";
+            file: string;
+            line: number;
+            column?: number | undefined;
+            export?: string | undefined;
+        } | {
+            kind: "attr";
+            value: string;
+            attr: string;
+            selector: string;
+        } | {
+            kind: "behavioral";
+            role: string;
+            name: string;
+            nth?: number | undefined;
+        } | {
+            kind: "dom";
+            selector: string;
+            fingerprint: string;
+        };
+        el: {
+            tag: string;
+            role?: string | undefined;
+            text?: string | undefined;
+            label?: string | undefined;
+            attrs?: Record<string, string> | undefined;
+            iconHints?: string[] | undefined;
+        };
+        conditions: {
+            viewport: {
+                w: number;
+                h: number;
+            };
+            theme?: "light" | "dark" | undefined;
+            mediaQueries?: Record<string, boolean> | undefined;
+        };
+        near?: {
+            labels?: string[] | undefined;
+            headings?: string[] | undefined;
+            landmarks?: string[] | undefined;
+            parentText?: string | undefined;
+        } | undefined;
+        screenshot?: string | undefined;
+        frameworkHints?: Record<string, unknown> | undefined;
+    };
+    sessionId?: string | undefined;
+}>;
+type CaptureRequest = z.infer<typeof CaptureRequestSchema>;
+interface CaptureResponse {
+    sessionId: string;
+    element: CapturedElement;
+}
+declare const SubmitRequestSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    prompt: z.ZodString;
+    execution: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodDefault<z.ZodEnum<["plan", "edit"]>>>;
+        isolation: z.ZodOptional<z.ZodDefault<z.ZodEnum<["worktree", "branch", "inplace"]>>>;
+        autoApply: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        agentId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        baseRef: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        mode?: "plan" | "edit" | undefined;
+        isolation?: "worktree" | "branch" | "inplace" | undefined;
+        autoApply?: boolean | undefined;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    }, {
+        mode?: "plan" | "edit" | undefined;
+        isolation?: "worktree" | "branch" | "inplace" | undefined;
+        autoApply?: boolean | undefined;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    }>>;
+    enrichment: z.ZodOptional<z.ZodObject<{
+        source: z.ZodLiteral<"code-review-graph">;
+        perElement: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            elementId: z.ZodNumber;
+            reviewContext: z.ZodOptional<z.ZodString>;
+            impactRadius: z.ZodOptional<z.ZodUnknown>;
+            affectedFlows: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }, {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }>, "many">>;
+        warnings: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        source: "code-review-graph";
+        perElement: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[];
+        warnings: string[];
+    }, {
+        source: "code-review-graph";
+        perElement?: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[] | undefined;
+        warnings?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    prompt: string;
+    execution?: {
+        mode?: "plan" | "edit" | undefined;
+        isolation?: "worktree" | "branch" | "inplace" | undefined;
+        autoApply?: boolean | undefined;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    } | undefined;
+    enrichment?: {
+        source: "code-review-graph";
+        perElement: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[];
+        warnings: string[];
+    } | undefined;
+}, {
+    sessionId: string;
+    prompt: string;
+    execution?: {
+        mode?: "plan" | "edit" | undefined;
+        isolation?: "worktree" | "branch" | "inplace" | undefined;
+        autoApply?: boolean | undefined;
+        agentId?: string | undefined;
+        baseRef?: string | undefined;
+    } | undefined;
+    enrichment?: {
+        source: "code-review-graph";
+        perElement?: {
+            elementId: number;
+            reviewContext?: string | undefined;
+            impactRadius?: unknown;
+            affectedFlows?: unknown;
+        }[] | undefined;
+        warnings?: string[] | undefined;
+    } | undefined;
+}>;
+type SubmitRequest = z.infer<typeof SubmitRequestSchema>;
+interface SubmitResponse {
+    runId: string;
+    bundle: CaptureBundle;
+}
+interface ApplyResponse {
+    applied: boolean;
+    commit?: string;
+    conflicts?: string[];
+}
+interface HealthResponse {
+    ok: true;
+    name: 'clicksmith-daemon';
+    version: string;
+    host: string;
+    port: number;
+    repoRoot: string | null;
+    activeSessions: number;
+}
+type SessionResponse = Session;
+interface RemoveElementResponse {
+    removed: boolean;
+}
+declare const RunStatusSchema: z.ZodEnum<["pending", "running", "plan-ready", "done", "applying", "applied", "error", "apply-error"]>;
+type RunStatus = z.infer<typeof RunStatusSchema>;
+interface RunSummary {
+    runId: string;
+    sessionId: string;
+    agentId: string;
+    status: RunStatus;
+    createdAt: string;
+    sandbox: SandboxInfo | null;
+}
+interface SandboxInfo {
+    isolation: 'worktree' | 'branch' | 'inplace';
+    path: string;
+    branch: string | null;
+    baseCommit: string;
+}
+/** Events streamed from daemon to the extension over the WebSocket. */
+type ServerEvent = {
+    type: 'capture-ack';
+    sessionId: string;
+    element: CapturedElement;
+} | {
+    type: 'element-removed';
+    sessionId: string;
+    elementId: number;
+} | {
+    type: 'agent-started';
+    runId: string;
+    sessionId: string;
+    agentId: string;
+    sandbox: SandboxInfo | null;
+} | {
+    type: 'agent-log';
+    runId: string;
+    stream: 'stdout' | 'stderr';
+    chunk: string;
+} | {
+    type: 'plan-ready';
+    runId: string;
+    plan?: string;
+    diff?: string;
+} | {
+    type: 'agent-done';
+    runId: string;
+    exitCode: number;
+} | {
+    type: 'agent-error';
+    runId: string;
+    message: string;
+} | {
+    type: 'apply-started';
+    runId: string;
+} | {
+    type: 'apply-done';
+    runId: string;
+    commit?: string;
+} | {
+    type: 'apply-error';
+    runId: string;
+    message: string;
+    conflicts?: string[];
+};
+type ServerEventType = ServerEvent['type'];
+/** Messages the extension may send to the daemon over the WebSocket. */
+type ClientMessage = {
+    type: 'subscribe';
+    sessionId?: string;
+} | {
+    type: 'ping';
+};
+/** Ordered list of every WS event type, useful for tests and docs. */
+declare const SERVER_EVENT_TYPES: readonly ["capture-ack", "element-removed", "agent-started", "agent-log", "plan-ready", "agent-done", "agent-error", "apply-started", "apply-done", "apply-error"];
+
+export { type AppContext, AppContextSchema, type ApplyResponse, type AttrLocator, AttrLocatorSchema, type BehavioralLocator, BehavioralLocatorSchema, CURRENT_BUNDLE_VERSION, type CaptureBundle, CaptureBundleSchema, type CaptureRequest, CaptureRequestSchema, type CaptureResponse, type CapturedElement, type CapturedElementInput, CapturedElementInputSchema, CapturedElementSchema, type ClientMessage, type Conditions, ConditionsSchema, type CreateSessionInput, DEFAULT_DAEMON_HOST, DEFAULT_DAEMON_PORT, DEFAULT_EXECUTION_OPTIONS, DEFAULT_SESSION_TTL_MS, type DomLocator, DomLocatorSchema, type ElementDescriptor, ElementDescriptorSchema, type ElementEnrichment, ElementEnrichmentSchema, type Enrichment, EnrichmentSchema, type ExecutionMode, ExecutionModeSchema, type ExecutionOptions, ExecutionOptionsSchema, type FinalizeInput, type HealthResponse, type Isolation, IsolationSchema, LOCATOR_PRIORITY, type Locator, type LocatorKind, LocatorSchema, type NearContext, NearContextSchema, type RemoveElementResponse, type RunStatus, RunStatusSchema, type RunSummary, SERVER_EVENT_TYPES, type SandboxInfo, type ServerEvent, type ServerEventType, type Session, type SessionResponse, SessionSchema, type SessionStatus, SessionStatusSchema, type SourceLocator, SourceLocatorSchema, type SubmitRequest, SubmitRequestSchema, type SubmitResponse, type ValidationResult, appendElement, compareLocators, confirmationReasons, createSession, describeLocator, deserializeBundle, finalizeSession, findElement, isCurrentVersion, isExpired, isSourceResolved, locatorRank, newRunId, newSessionId, nextElementId, parseBundle, parseElementRef, pickBestLocator, rankLocators, removeElement, requiresConfirmation, serializeBundle, touchSession, validateBundle };