@get-bb/plugin-sdk 0.4.9 → 0.4.11

package/bundled-types/bb-plugin-sdk-provider-bridge.d.ts

@@ -6,6 +6,7 @@
 // and read the real source: https://github.com/get-bb/bb
 
 import { z } from 'zod';
+import { Writable, Readable } from 'node:stream';
 
 declare const acpReasoningCliSchema: z.ZodObject<{
     defaultLevel: z.ZodOptional<z.ZodEnum<{
@@ -243,6 +244,24 @@ declare const claudeTaskToolOutputSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$loose>]>;
 type ClaudeTaskToolOutput = z.infer<typeof claudeTaskToolOutputSchema>;
 
+declare const threadEventItemPresentationSchema: z.ZodObject<{
+    detail: z.ZodOptional<z.ZodString>;
+    icon: z.ZodObject<{
+        glyph: z.ZodString;
+    }, z.core.$strip>;
+    label: z.ZodObject<{
+        completed: z.ZodString;
+        pending: z.ZodString;
+    }, z.core.$strip>;
+    suppress: z.ZodOptional<z.ZodBoolean>;
+    tint: z.ZodOptional<z.ZodObject<{
+        dark: z.ZodString;
+        light: z.ZodString;
+    }, z.core.$strip>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type ThreadEventItemPresentation = z.infer<typeof threadEventItemPresentationSchema>;
+
 declare function toPositiveNumber(value: unknown): number | undefined;
 
 declare const pendingInteractionCommandActionSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -410,6 +429,26 @@ declare const pendingInteractionApprovalSubjectSchema: z.ZodDiscriminatedUnion<[
     kind: z.ZodLiteral<"plan">;
     plan: z.ZodString;
     planFilePath: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    itemId: z.ZodString;
+    kind: z.ZodLiteral<"tool_use">;
+    presentation: z.ZodObject<{
+        detail: z.ZodOptional<z.ZodString>;
+        icon: z.ZodObject<{
+            glyph: z.ZodString;
+        }, z.core.$strip>;
+        label: z.ZodObject<{
+            completed: z.ZodString;
+            pending: z.ZodString;
+        }, z.core.$strip>;
+        suppress: z.ZodOptional<z.ZodBoolean>;
+        tint: z.ZodOptional<z.ZodObject<{
+            dark: z.ZodString;
+            light: z.ZodString;
+        }, z.core.$strip>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    tool: z.ZodString;
 }, z.core.$strip>], "kind">;
 type PendingInteractionApprovalSubject = z.infer<typeof pendingInteractionApprovalSubjectSchema>;
 declare const approvalPendingInteractionPayloadSchema: z.ZodObject<{
@@ -483,6 +522,26 @@ declare const approvalPendingInteractionPayloadSchema: z.ZodObject<{
         kind: z.ZodLiteral<"plan">;
         plan: z.ZodString;
         planFilePath: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        itemId: z.ZodString;
+        kind: z.ZodLiteral<"tool_use">;
+        presentation: z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        tool: z.ZodString;
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>;
 type ApprovalPendingInteractionPayload = z.infer<typeof approvalPendingInteractionPayloadSchema>;
@@ -594,6 +653,26 @@ declare const pendingInteractionPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
         kind: z.ZodLiteral<"plan">;
         plan: z.ZodString;
         planFilePath: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        itemId: z.ZodString;
+        kind: z.ZodLiteral<"tool_use">;
+        presentation: z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        tool: z.ZodString;
     }, z.core.$strip>], "kind">;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"user_question">;
@@ -611,6 +690,37 @@ declare const pendingInteractionPayloadSchema: z.ZodDiscriminatedUnion<[z.ZodObj
     }, z.core.$strip>>;
 }, z.core.$strip>], "kind">;
 type PendingInteractionPayload = z.infer<typeof pendingInteractionPayloadSchema>;
+/**
+ * The open request family. A plain union rather than a discriminated one
+ * because the plugin member's `kind` is a namespace pattern, not a literal;
+ * the core literals (`user_question`, `plan_review`) contain no "/" so the
+ * members never overlap.
+ */
+declare const interactionRequestPayloadSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<"user_question">;
+    questions: z.ZodArray<z.ZodObject<{
+        allowFreeText: z.ZodBoolean;
+        id: z.ZodString;
+        multiSelect: z.ZodBoolean;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>>>;
+        prompt: z.ZodString;
+        shortLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    itemId: z.ZodString;
+    kind: z.ZodLiteral<"plan_review">;
+    plan: z.ZodString;
+    planFilePath: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    data: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+    title: z.ZodString;
+}, z.core.$strip>]>;
+type InteractionRequestPayload = z.infer<typeof interactionRequestPayloadSchema>;
 type AnyPendingInteractionPayload = PendingInteractionPayload | PluginPendingInteractionPayload;
 declare function isApprovalPendingInteractionPayload(payload: AnyPendingInteractionPayload): payload is ApprovalPendingInteractionPayload;
 declare function isUserQuestionPendingInteractionPayload(payload: AnyPendingInteractionPayload): payload is UserQuestionPendingInteractionPayload;
@@ -685,6 +795,178 @@ type PendingInteractionResolution = z.infer<typeof pendingInteractionResolutionS
 declare function isApprovalPendingInteractionResolution(resolution: PendingInteractionResolution): resolution is ApprovalPendingInteractionResolution;
 declare function isUserQuestionPendingInteractionResolution(resolution: PendingInteractionResolution): resolution is UserQuestionPendingInteractionResolution;
 
+declare const threadEventItemStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    interrupted: "interrupted";
+    pending: "pending";
+}>;
+type ThreadEventItemStatus = z.infer<typeof threadEventItemStatusSchema>;
+declare const threadEventTurnStatusSchema: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    interrupted: "interrupted";
+}>;
+type ThreadEventTurnStatus = z.infer<typeof threadEventTurnStatusSchema>;
+declare const providerErrorCategorySchema: z.ZodEnum<{
+    "active-turn-not-steerable": "active-turn-not-steerable";
+    "bad-request": "bad-request";
+    "budget-exceeded": "budget-exceeded";
+    "connection-failed": "connection-failed";
+    "context-window-exceeded": "context-window-exceeded";
+    "max-output-tokens": "max-output-tokens";
+    "max-turns": "max-turns";
+    "rate-limit": "rate-limit";
+    "stream-disconnected": "stream-disconnected";
+    "structured-output-retries": "structured-output-retries";
+    "thread-rollback-failed": "thread-rollback-failed";
+    "too-many-failed-attempts": "too-many-failed-attempts";
+    billing: "billing";
+    internal: "internal";
+    overloaded: "overloaded";
+    policy: "policy";
+    sandbox: "sandbox";
+    unauthorized: "unauthorized";
+    unknown: "unknown";
+}>;
+type ProviderErrorCategory = z.infer<typeof providerErrorCategorySchema>;
+declare const providerErrorInfoSchema: z.ZodObject<{
+    category: z.ZodEnum<{
+        "active-turn-not-steerable": "active-turn-not-steerable";
+        "bad-request": "bad-request";
+        "budget-exceeded": "budget-exceeded";
+        "connection-failed": "connection-failed";
+        "context-window-exceeded": "context-window-exceeded";
+        "max-output-tokens": "max-output-tokens";
+        "max-turns": "max-turns";
+        "rate-limit": "rate-limit";
+        "stream-disconnected": "stream-disconnected";
+        "structured-output-retries": "structured-output-retries";
+        "thread-rollback-failed": "thread-rollback-failed";
+        "too-many-failed-attempts": "too-many-failed-attempts";
+        billing: "billing";
+        internal: "internal";
+        overloaded: "overloaded";
+        policy: "policy";
+        sandbox: "sandbox";
+        unauthorized: "unauthorized";
+        unknown: "unknown";
+    }>;
+    httpStatusCode: z.ZodNullable<z.ZodNumber>;
+    providerCode: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type ProviderErrorInfo = z.infer<typeof providerErrorInfoSchema>;
+declare const providerRateLimitStatusSchema: z.ZodEnum<{
+    allowed: "allowed";
+    blocked: "blocked";
+    unknown: "unknown";
+    warning: "warning";
+}>;
+type ProviderRateLimitStatus = z.infer<typeof providerRateLimitStatusSchema>;
+declare const providerRateLimitWindowSchema: z.ZodObject<{
+    label: z.ZodNullable<z.ZodString>;
+    providerKey: z.ZodNullable<z.ZodString>;
+    resetsAtMs: z.ZodNullable<z.ZodNumber>;
+    status: z.ZodEnum<{
+        allowed: "allowed";
+        blocked: "blocked";
+        unknown: "unknown";
+        warning: "warning";
+    }>;
+}, z.core.$strip>;
+type ProviderRateLimitWindow = z.infer<typeof providerRateLimitWindowSchema>;
+declare const providerRateLimitStateSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        "spend-control": "spend-control";
+        "subscription-window": "subscription-window";
+        credits: "credits";
+        unknown: "unknown";
+    }>;
+    overageReason: z.ZodNullable<z.ZodString>;
+    overageStatus: z.ZodNullable<z.ZodEnum<{
+        allowed: "allowed";
+        rejected: "rejected";
+        unavailable: "unavailable";
+        warning: "warning";
+    }>>;
+    providerId: z.ZodString;
+    reachedReason: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        allowed: "allowed";
+        blocked: "blocked";
+        unknown: "unknown";
+        warning: "warning";
+    }>;
+    windows: z.ZodArray<z.ZodObject<{
+        label: z.ZodNullable<z.ZodString>;
+        providerKey: z.ZodNullable<z.ZodString>;
+        resetsAtMs: z.ZodNullable<z.ZodNumber>;
+        status: z.ZodEnum<{
+            allowed: "allowed";
+            blocked: "blocked";
+            unknown: "unknown";
+            warning: "warning";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type ProviderRateLimitState = z.infer<typeof providerRateLimitStateSchema>;
+declare const threadEventPlanStepSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        completed: "completed";
+        failed: "failed";
+        pending: "pending";
+    }>>;
+    step: z.ZodString;
+}, z.core.$strip>;
+type ThreadEventPlanStep = z.infer<typeof threadEventPlanStepSchema>;
+/**
+ * How a `search` item looked for things: `content` searches inside files
+ * (grep, Claude `Grep`), `path` matches file names (Claude `Glob`, `fd`),
+ * `list` enumerates a directory (`ls`, codex `list_dir`).
+ */
+declare const threadEventSearchModeSchema: z.ZodEnum<{
+    content: "content";
+    list: "list";
+    path: "path";
+}>;
+type ThreadEventSearchMode = z.infer<typeof threadEventSearchModeSchema>;
+declare const threadEventUserContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    text: z.ZodString;
+    type: z.ZodLiteral<"text">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"image">;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodLiteral<"localImage">;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodLiteral<"localFile">;
+}, z.core.$strip>], "type">;
+type ThreadEventUserContent = z.infer<typeof threadEventUserContentSchema>;
+declare const threadEventTokenUsageBreakdownSchema: z.ZodObject<{
+    cachedInputTokens: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    reasoningOutputTokens: z.ZodNumber;
+    totalTokens: z.ZodNumber;
+}, z.core.$strip>;
+type ThreadEventTokenUsageBreakdown = z.infer<typeof threadEventTokenUsageBreakdownSchema>;
+declare const threadEventContextWindowUsageSchema: z.ZodObject<{
+    estimated: z.ZodBoolean;
+    modelContextWindow: z.ZodNullable<z.ZodNumber>;
+    usedTokens: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strip>;
+type ThreadEventContextWindowUsage = z.infer<typeof threadEventContextWindowUsageSchema>;
+declare const providerRawEventSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    jsonrpc: z.ZodLiteral<"2.0">;
+    method: z.ZodString;
+    params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
+}, z.core.$strip>;
+type ProviderRawEvent = z.infer<typeof providerRawEventSchema>;
+
 /**
  * Order is load-bearing: `reasoningRank` (index) drives model-switch
  * reconciliation. "none" (no extended thinking) sits at the bottom — only
@@ -867,166 +1149,11 @@ type RuntimePermissionPolicy = z.infer<typeof runtimePermissionPolicySchema>;
 declare const clientTurnRequestIdSchema: z.ZodString;
 type ClientTurnRequestId = z.infer<typeof clientTurnRequestIdSchema>;
 
-declare const threadEventItemStatusSchema: z.ZodEnum<{
-    completed: "completed";
-    failed: "failed";
-    interrupted: "interrupted";
-    pending: "pending";
-}>;
-type ThreadEventItemStatus = z.infer<typeof threadEventItemStatusSchema>;
-declare const threadEventTurnStatusSchema: z.ZodEnum<{
-    completed: "completed";
-    failed: "failed";
-    interrupted: "interrupted";
-}>;
-type ThreadEventTurnStatus = z.infer<typeof threadEventTurnStatusSchema>;
-declare const providerErrorCategorySchema: z.ZodEnum<{
-    "active-turn-not-steerable": "active-turn-not-steerable";
-    "bad-request": "bad-request";
-    "budget-exceeded": "budget-exceeded";
-    "connection-failed": "connection-failed";
-    "context-window-exceeded": "context-window-exceeded";
-    "max-output-tokens": "max-output-tokens";
-    "max-turns": "max-turns";
-    "rate-limit": "rate-limit";
-    "stream-disconnected": "stream-disconnected";
-    "structured-output-retries": "structured-output-retries";
-    "thread-rollback-failed": "thread-rollback-failed";
-    "too-many-failed-attempts": "too-many-failed-attempts";
-    billing: "billing";
-    internal: "internal";
-    overloaded: "overloaded";
-    policy: "policy";
-    sandbox: "sandbox";
-    unauthorized: "unauthorized";
-    unknown: "unknown";
-}>;
-type ProviderErrorCategory = z.infer<typeof providerErrorCategorySchema>;
-declare const providerErrorInfoSchema: z.ZodObject<{
-    category: z.ZodEnum<{
-        "active-turn-not-steerable": "active-turn-not-steerable";
-        "bad-request": "bad-request";
-        "budget-exceeded": "budget-exceeded";
-        "connection-failed": "connection-failed";
-        "context-window-exceeded": "context-window-exceeded";
-        "max-output-tokens": "max-output-tokens";
-        "max-turns": "max-turns";
-        "rate-limit": "rate-limit";
-        "stream-disconnected": "stream-disconnected";
-        "structured-output-retries": "structured-output-retries";
-        "thread-rollback-failed": "thread-rollback-failed";
-        "too-many-failed-attempts": "too-many-failed-attempts";
-        billing: "billing";
-        internal: "internal";
-        overloaded: "overloaded";
-        policy: "policy";
-        sandbox: "sandbox";
-        unauthorized: "unauthorized";
-        unknown: "unknown";
-    }>;
-    httpStatusCode: z.ZodNullable<z.ZodNumber>;
-    providerCode: z.ZodNullable<z.ZodString>;
-}, z.core.$strip>;
-type ProviderErrorInfo = z.infer<typeof providerErrorInfoSchema>;
-declare const providerRateLimitStatusSchema: z.ZodEnum<{
-    allowed: "allowed";
-    blocked: "blocked";
-    unknown: "unknown";
-    warning: "warning";
-}>;
-type ProviderRateLimitStatus = z.infer<typeof providerRateLimitStatusSchema>;
-declare const providerRateLimitWindowSchema: z.ZodObject<{
-    label: z.ZodNullable<z.ZodString>;
-    providerKey: z.ZodNullable<z.ZodString>;
-    resetsAtMs: z.ZodNullable<z.ZodNumber>;
-    status: z.ZodEnum<{
-        allowed: "allowed";
-        blocked: "blocked";
-        unknown: "unknown";
-        warning: "warning";
-    }>;
-}, z.core.$strip>;
-type ProviderRateLimitWindow = z.infer<typeof providerRateLimitWindowSchema>;
-declare const providerRateLimitStateSchema: z.ZodObject<{
-    kind: z.ZodEnum<{
-        "spend-control": "spend-control";
-        "subscription-window": "subscription-window";
-        credits: "credits";
-        unknown: "unknown";
-    }>;
-    overageReason: z.ZodNullable<z.ZodString>;
-    overageStatus: z.ZodNullable<z.ZodEnum<{
-        allowed: "allowed";
-        rejected: "rejected";
-        unavailable: "unavailable";
-        warning: "warning";
-    }>>;
-    providerId: z.ZodString;
-    reachedReason: z.ZodNullable<z.ZodString>;
-    status: z.ZodEnum<{
-        allowed: "allowed";
-        blocked: "blocked";
-        unknown: "unknown";
-        warning: "warning";
-    }>;
-    windows: z.ZodArray<z.ZodObject<{
-        label: z.ZodNullable<z.ZodString>;
-        providerKey: z.ZodNullable<z.ZodString>;
-        resetsAtMs: z.ZodNullable<z.ZodNumber>;
-        status: z.ZodEnum<{
-            allowed: "allowed";
-            blocked: "blocked";
-            unknown: "unknown";
-            warning: "warning";
-        }>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-type ProviderRateLimitState = z.infer<typeof providerRateLimitStateSchema>;
-declare const threadEventPlanStepSchema: z.ZodObject<{
-    status: z.ZodOptional<z.ZodEnum<{
-        active: "active";
-        completed: "completed";
-        failed: "failed";
-        pending: "pending";
-    }>>;
-    step: z.ZodString;
-}, z.core.$strip>;
-type ThreadEventPlanStep = z.infer<typeof threadEventPlanStepSchema>;
-declare const threadEventUserContentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    text: z.ZodString;
-    type: z.ZodLiteral<"text">;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"image">;
-    url: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    path: z.ZodString;
-    type: z.ZodLiteral<"localImage">;
-}, z.core.$strip>, z.ZodObject<{
-    path: z.ZodString;
-    type: z.ZodLiteral<"localFile">;
-}, z.core.$strip>], "type">;
-type ThreadEventUserContent = z.infer<typeof threadEventUserContentSchema>;
-declare const threadEventTokenUsageBreakdownSchema: z.ZodObject<{
-    cachedInputTokens: z.ZodNumber;
-    inputTokens: z.ZodNumber;
-    outputTokens: z.ZodNumber;
-    reasoningOutputTokens: z.ZodNumber;
-    totalTokens: z.ZodNumber;
-}, z.core.$strip>;
-type ThreadEventTokenUsageBreakdown = z.infer<typeof threadEventTokenUsageBreakdownSchema>;
-declare const threadEventContextWindowUsageSchema: z.ZodObject<{
-    estimated: z.ZodBoolean;
-    modelContextWindow: z.ZodNullable<z.ZodNumber>;
-    usedTokens: z.ZodNullable<z.ZodNumber>;
-}, z.core.$strip>;
-type ThreadEventContextWindowUsage = z.infer<typeof threadEventContextWindowUsageSchema>;
-declare const providerRawEventSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-    jsonrpc: z.ZodLiteral<"2.0">;
-    method: z.ZodString;
-    params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
-}, z.core.$strip>;
-type ProviderRawEvent = z.infer<typeof providerRawEventSchema>;
+/** A namespaced extension kind, `"<pluginId>/<name>"`. */
+type ExtensionKind = `${string}/${string}`;
+declare function isExtensionKind(value: string): value is ExtensionKind;
+/** Parses to the {@link ExtensionKind} type, so consumers can split it. */
+declare const extensionKindSchema: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
 
 declare const modelReasoningEffortSchema: z.ZodObject<{
     description: z.ZodString;
@@ -1074,10 +1201,67 @@ declare const availableModelSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 type AvailableModel = z.infer<typeof availableModelSchema>;
+/**
+ * Typed recovery hints a provider bridge raises instead of error text the
+ * runtime would otherwise have to pattern-match (`provider/recovery`, see
+ * `providerRecoveryNotificationSchema` in @bb/provider-bridge-protocol).
+ *
+ * - `sessionArchived`: the provider refused because its session is archived;
+ *   the runtime unarchives and retries.
+ * - `authRequired`: credentials are missing or expired; typed error plus a
+ *   health refresh.
+ * - `restartRecommended`: the bridge wants a fresh process; the runtime
+ *   restarts it and resumes the session.
+ * - `staleTurn`: the steer or stop named a turn that is no longer live; the
+ *   runtime drops it.
+ * - `rateLimited`: the provider throttled the request; the runtime schedules
+ *   a retry.
+ *
+ * No consumer yet: WS4 (runtime cleanup) acts on these.
+ */
+declare const providerRecoveryKindValues: readonly ["sessionArchived", "authRequired", "restartRecommended", "staleTurn", "rateLimited"];
+declare const providerRecoveryKindSchema: z.ZodEnum<{
+    authRequired: "authRequired";
+    rateLimited: "rateLimited";
+    restartRecommended: "restartRecommended";
+    sessionArchived: "sessionArchived";
+    staleTurn: "staleTurn";
+}>;
+type ProviderRecoveryKind = z.infer<typeof providerRecoveryKindSchema>;
+/**
+ * A bb-injected tool handed to a provider bridge at session construction.
+ *
+ * `presentation` is how a call to this tool reads as a timeline row (grammar
+ * v3, docs/provider-plugin-api.md §3): the bridge stamps it on the
+ * `item.open`/`item.close` for the call beside `server: "bb"`, so no core
+ * table of bb tool names is needed to label the row. The server resolves it
+ * once, at its boundary, for every tool it injects — from the owning
+ * plugin's declaration, falling back to a generic label and the plugin's
+ * glyph. Optional on the wire while the grammar migrates (A1, additive then
+ * delete): a definition recorded before the field existed carries none, and
+ * a bridge then presents the call generically; the stabilization pass makes
+ * it required.
+ */
 declare const dynamicToolSchema: z.ZodObject<{
     description: z.ZodString;
     inputSchema: z.ZodUnknown;
     name: z.ZodString;
+    presentation: z.ZodOptional<z.ZodObject<{
+        detail: z.ZodOptional<z.ZodString>;
+        icon: z.ZodObject<{
+            glyph: z.ZodString;
+        }, z.core.$strip>;
+        label: z.ZodObject<{
+            completed: z.ZodString;
+            pending: z.ZodString;
+        }, z.core.$strip>;
+        suppress: z.ZodOptional<z.ZodBoolean>;
+        tint: z.ZodOptional<z.ZodObject<{
+            dark: z.ZodString;
+            light: z.ZodString;
+        }, z.core.$strip>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 type DynamicTool = z.infer<typeof dynamicToolSchema>;
 
@@ -1115,6 +1299,16 @@ declare function normalizeProviderCommandOutput(args: {
  * Handles strings, arrays of text blocks, and `{ content: [...] }` wrappers.
  */
 declare function extractResultText(content: unknown): string;
+/** The empty breakdown a bridge's per-session usage accumulator starts from. */
+declare const ZERO_TOKEN_USAGE: ThreadEventTokenUsageBreakdown;
+/**
+ * Sum a turn's usage into a running total, field by field. The `usage` delta
+ * carries both the turn's usage and the session total; a provider that only
+ * reports per-turn usage keeps the total itself with this, starting from
+ * {@link ZERO_TOKEN_USAGE} at every session construction (the same boundary
+ * as the `session.reset` delta).
+ */
+declare function addTokenUsage(total: ThreadEventTokenUsageBreakdown, last: ThreadEventTokenUsageBreakdown): ThreadEventTokenUsageBreakdown;
 
 type BridgeJsonRpcId = string | number;
 type BridgeJsonRpcResponse$1 = {
@@ -1148,6 +1342,35 @@ declare function runBridgeRequest<TRequest extends {
     sendError: (id: BridgeJsonRpcId, code: number, message: string) => void;
 }): void;
 
+interface BridgeRecorderChildStreams {
+    stdin?: Writable | null;
+    stdout?: Readable | null;
+}
+/**
+ * Whether this process records. A bridge whose provider pipe is owned by an
+ * SDK (Claude's Agent SDK) checks this to decide whether to take the spawn
+ * over; bridges that spawn their child themselves just call
+ * `experimental_recordProviderChildIo`.
+ */
+declare function experimental_isProviderBridgeRecording(): boolean;
+/**
+ * Tee the provider child a bridge just spawned into the recording, scoped to
+ * the bb thread it serves (null for process-level children such as a
+ * model-list probe). A no-op unless record mode is on, so bridges call it
+ * unconditionally right after `spawn()`.
+ */
+declare function experimental_recordProviderChildIo(child: BridgeRecorderChildStreams, scope: {
+    threadId: string | null;
+}): void;
+
+/**
+ * The environment a bridge hands its provider child when it wants the child
+ * to see the bridge's own environment (ACP agents and the Claude CLI need
+ * `BB_CLI` and friends so `bb` works inside their shells). Two variables are
+ * bridge-process facts that must never leak downward: the Electron node flag,
+ * and the record-mode directory — a recorded provider child that happened to
+ * be a bb bridge itself would otherwise start recording too.
+ */
 declare function withoutBridgeRuntimeEnv(env: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 
 /**
@@ -1195,10 +1418,39 @@ declare const jsonRpcErrorResponseSchema: z.ZodObject<{
 }, z.core.$strip>;
 type BridgeJsonRpcResponse = z.infer<typeof jsonRpcSuccessResponseSchema> | z.infer<typeof jsonRpcErrorResponseSchema>;
 declare function decodeBridgeJsonRpcResponse(input: unknown): BridgeJsonRpcResponse | null;
+/** An image on a tool call result, split out of an `inputImage` data URL. */
+interface BridgeToolCallImage {
+    data: string;
+    mimeType: string;
+}
+/**
+ * A tool result block in the one shape every consumer already accepts: MCP's
+ * `CallToolResult.content` (claude-code and acp) and pi's `AgentToolResult.content`
+ * declare the same two members with the same field names.
+ */
+type BridgeToolCallContent = {
+    type: "text";
+    text: string;
+} | {
+    type: "image";
+    data: string;
+    mimeType: string;
+};
 declare function decodeToolCallResponsePayload(result: unknown): {
     content: string;
+    contentBlocks: BridgeToolCallContent[];
+    images: BridgeToolCallImage[];
     isError: boolean;
 };
+/**
+ * Renders a decoded payload as tool result blocks, dropping empty text so an
+ * image-only result carries the image alone.
+ */
+declare function buildBridgeToolCallContent(result: {
+    content: string;
+    contentBlocks?: BridgeToolCallContent[];
+    images?: BridgeToolCallImage[];
+}): BridgeToolCallContent[];
 
 /**
  * Structural contracts shared by the runtime's generic adapter and the bridge
@@ -1296,6 +1548,10 @@ declare function mimeTypeFromExtension(filePath: string): string;
 
 interface BridgeToolCallResult {
     content: string;
+    /** Ordered provider result blocks; absent on local transport failures. */
+    contentBlocks?: BridgeToolCallContent[];
+    /** Absent on the failure paths below, which have no image to report. */
+    images?: BridgeToolCallImage[];
     isError?: boolean;
 }
 interface ForwardBridgeToolCallArgs {
@@ -1477,13 +1733,85 @@ declare const textBlockSchema: z.ZodObject<{
  *   `thread/event`.
  */
 declare const PROVIDER_BRIDGE_PROTOCOL_VERSION: 2;
+/**
+ * The `thread/delta` grammar versions. The grammar is versioned separately
+ * from the JSON-RPC envelope (see `grammarVersions` in handshake.ts): v2 was
+ * the narrow grammar that shipped with protocol version 2; v3 adds the core
+ * item kinds `fileRead`, `search`, `delegation` and `planSteps`, declarative
+ * `presentation` on `item.open`/`item.close`, plugin extension kinds
+ * (`extension` items, `extension.state`), and replaces v2's two streaming
+ * dialects and two usage dialects with one of each (`item.textDelta`/
+ * `item.textClose`, `usage` + `contextWindow`). A bridge reports the range
+ * it speaks; the runtime reports the range its assembler accepts; both emit
+ * the highest common version. The runtime's assembler speaks v3 only; a
+ * bridge that predates `grammarVersions` reads as `[2, 2]` and is refused at
+ * the handshake.
+ */
+declare const THREAD_DELTA_GRAMMAR_V2: 2;
+declare const THREAD_DELTA_GRAMMAR_V3: 3;
 
+/**
+ * The inclusive `[min, max]` range of `thread/delta` grammar versions a bridge
+ * speaks. Distinct from the JSON-RPC `protocolVersion`: the envelope can stay
+ * put while the delta vocabulary grows, and a bridge that speaks both v2 and
+ * v3 says so here instead of forcing a daemon bump.
+ */
+declare const bridgeGrammarVersionsSchema: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+type BridgeGrammarVersions = z.infer<typeof bridgeGrammarVersionsSchema>;
+/**
+ * How the bridge delivers `turn/steer` while a turn is live. `inject` feeds
+ * the steer text into the running model loop (claude, codex); `queue` holds
+ * it for the next prompt boundary (ACP v1 cancels the live prompt and
+ * re-prompts with the queued text). The runtime sends `turn/steer` either
+ * way; the mode is what the composer tells the user and what WS4's recovery
+ * logic keys `staleTurn` on.
+ */
+declare const bridgeSteerModeSchema: z.ZodEnum<{
+    inject: "inject";
+    queue: "queue";
+}>;
+type BridgeSteerMode = z.infer<typeof bridgeSteerModeSchema>;
+/**
+ * Session-behavior facts the bridge reports at `initialize`. These are
+ * deliberately NOT provider declarations: the code that implements a feature
+ * is the code that reports it, so a handshake fact cannot drift from behavior
+ * the way a declared boolean can.
+ *
+ * Every field defaults on parse so an older bridge that omits a capability is
+ * read as not having it — absence is a definite "no", never an error, and the
+ * parsed object always carries explicit values internally.
+ *
+ * The schema is loose: unknown capability fields from a newer bridge pass
+ * through untouched so a newer plugin works against an older runtime.
+ */
+declare const bridgeCapabilitiesSchema: z.ZodObject<{
+    approvalEnforcedBy: z.ZodDefault<z.ZodEnum<{
+        provider: "provider";
+        runtime: "runtime";
+    }>>;
+    fork: z.ZodDefault<z.ZodEnum<{
+        checkpoint: "checkpoint";
+        none: "none";
+        tip: "tip";
+    }>>;
+    grammarVersions: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    sessionRestore: z.ZodDefault<z.ZodBoolean>;
+    steerMode: z.ZodDefault<z.ZodEnum<{
+        inject: "inject";
+        queue: "queue";
+    }>>;
+    threadArchive: z.ZodDefault<z.ZodBoolean>;
+    threadGoalClear: z.ZodDefault<z.ZodBoolean>;
+    threadRename: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$loose>;
+type BridgeCapabilities = z.infer<typeof bridgeCapabilitiesSchema>;
 /** Runtime → bridge `initialize` params. */
 declare const initializeParamsSchema: z.ZodObject<{
     client: z.ZodObject<{
         name: z.ZodString;
         version: z.ZodString;
     }, z.core.$strip>;
+    grammarVersions: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
     protocolVersion: z.ZodNumber;
 }, z.core.$loose>;
 /** Bridge → runtime `initialize` result. */
@@ -1498,7 +1826,12 @@ declare const initializeResultSchema: z.ZodObject<{
             none: "none";
             tip: "tip";
         }>>;
+        grammarVersions: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
         sessionRestore: z.ZodDefault<z.ZodBoolean>;
+        steerMode: z.ZodDefault<z.ZodEnum<{
+            inject: "inject";
+            queue: "queue";
+        }>>;
         threadArchive: z.ZodDefault<z.ZodBoolean>;
         threadGoalClear: z.ZodDefault<z.ZodBoolean>;
         threadRename: z.ZodDefault<z.ZodBoolean>;
@@ -1525,6 +1858,7 @@ declare const bridgeExecutionOptionsSchema: z.ZodIntersection<z.ZodObject<{
     envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     instructions: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
+    promptMode: z.ZodOptional<z.ZodLiteral<"plan">>;
     providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     reasoningLevel: z.ZodOptional<z.ZodEnum<{
         high: "high";
@@ -1564,6 +1898,261 @@ declare const bridgeExecutionOptionsSchema: z.ZodIntersection<z.ZodObject<{
 }, z.core.$strip>], "permissionMode">>;
 type BridgeExecutionOptions = z.infer<typeof bridgeExecutionOptionsSchema>;
 
+/**
+ * Sessionless provider maintenance query. `providerOptions` carries the same
+ * provider-scoped statics as model/list (notably an ACP launch spec), while
+ * `providerId` lets one bridge implementation serve several provider ids.
+ */
+declare const experimental_providerMaintenanceParamsSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+type ExperimentalProviderMaintenanceParams = z.infer<typeof experimental_providerMaintenanceParamsSchema>;
+declare const experimental_providerInstallationRequirementSchema: z.ZodEnum<{
+    thread_rewind: "thread_rewind";
+}>;
+type ExperimentalProviderInstallationRequirement = z.infer<typeof experimental_providerInstallationRequirementSchema>;
+declare const experimental_providerInstallationStatusParamsSchema: z.ZodObject<{
+    cwd: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    requirement: z.ZodOptional<z.ZodEnum<{
+        thread_rewind: "thread_rewind";
+    }>>;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationStatusParams = z.infer<typeof experimental_providerInstallationStatusParamsSchema>;
+/**
+ * Cheap, host-local readiness reported by a provider implementation. Network
+ * usage and update checks deliberately live outside this result so choosing a
+ * provider for the composer never waits on them.
+ */
+declare const experimental_providerHealthSchema: z.ZodObject<{
+    accountEmail: z.ZodNullable<z.ZodString>;
+    canInstall: z.ZodBoolean;
+    canUpdate: z.ZodBoolean;
+    installedVersion: z.ZodNullable<z.ZodString>;
+    loginCommand: z.ZodNullable<z.ZodString>;
+    minimumSupportedVersion: z.ZodNullable<z.ZodString>;
+    planLabel: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        expired: "expired";
+        not_installed: "not_installed";
+        ready: "ready";
+        unauthenticated: "unauthenticated";
+        unknown: "unknown";
+        unsupported_version: "unsupported_version";
+    }>;
+    statusMessage: z.ZodNullable<z.ZodString>;
+}, z.core.$loose>;
+type ExperimentalProviderHealth = z.infer<typeof experimental_providerHealthSchema>;
+/** One usage window reported by a provider subscription. */
+declare const experimental_providerUsageWindowSchema: z.ZodObject<{
+    cost: z.ZodOptional<z.ZodObject<{
+        limitUsdCents: z.ZodNumber;
+        usedUsdCents: z.ZodNumber;
+    }, z.core.$strip>>;
+    label: z.ZodString;
+    resetsAt: z.ZodNullable<z.ZodString>;
+    usedPercent: z.ZodNumber;
+}, z.core.$loose>;
+type ExperimentalProviderUsageWindow = z.infer<typeof experimental_providerUsageWindowSchema>;
+/** Live usage for one provider, normalized by that provider's bridge. */
+declare const experimental_providerUsageSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    accountEmail: z.ZodNullable<z.ZodString>;
+    planLabel: z.ZodNullable<z.ZodString>;
+    status: z.ZodLiteral<"ok">;
+    windows: z.ZodArray<z.ZodObject<{
+        cost: z.ZodOptional<z.ZodObject<{
+            limitUsdCents: z.ZodNumber;
+            usedUsdCents: z.ZodNumber;
+        }, z.core.$strip>>;
+        label: z.ZodString;
+        resetsAt: z.ZodNullable<z.ZodString>;
+        usedPercent: z.ZodNumber;
+    }, z.core.$loose>>;
+}, z.core.$loose>, z.ZodObject<{
+    status: z.ZodLiteral<"not_installed">;
+}, z.core.$loose>, z.ZodObject<{
+    status: z.ZodLiteral<"unauthenticated">;
+}, z.core.$loose>, z.ZodObject<{
+    status: z.ZodLiteral<"expired">;
+}, z.core.$loose>, z.ZodObject<{
+    accountEmail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    message: z.ZodString;
+    planLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    status: z.ZodLiteral<"error">;
+}, z.core.$loose>], "status">;
+type ExperimentalProviderUsage = z.infer<typeof experimental_providerUsageSchema>;
+declare const experimental_providerHealthResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    supported: z.ZodLiteral<false>;
+}, z.core.$loose>, z.ZodObject<{
+    health: z.ZodObject<{
+        accountEmail: z.ZodNullable<z.ZodString>;
+        canInstall: z.ZodBoolean;
+        canUpdate: z.ZodBoolean;
+        installedVersion: z.ZodNullable<z.ZodString>;
+        loginCommand: z.ZodNullable<z.ZodString>;
+        minimumSupportedVersion: z.ZodNullable<z.ZodString>;
+        planLabel: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<{
+            expired: "expired";
+            not_installed: "not_installed";
+            ready: "ready";
+            unauthenticated: "unauthenticated";
+            unknown: "unknown";
+            unsupported_version: "unsupported_version";
+        }>;
+        statusMessage: z.ZodNullable<z.ZodString>;
+    }, z.core.$loose>;
+    supported: z.ZodLiteral<true>;
+}, z.core.$loose>], "supported">;
+type ExperimentalProviderHealthResult = z.infer<typeof experimental_providerHealthResultSchema>;
+declare const experimental_providerUsageResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    supported: z.ZodLiteral<false>;
+}, z.core.$loose>, z.ZodObject<{
+    supported: z.ZodLiteral<true>;
+    usage: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        accountEmail: z.ZodNullable<z.ZodString>;
+        planLabel: z.ZodNullable<z.ZodString>;
+        status: z.ZodLiteral<"ok">;
+        windows: z.ZodArray<z.ZodObject<{
+            cost: z.ZodOptional<z.ZodObject<{
+                limitUsdCents: z.ZodNumber;
+                usedUsdCents: z.ZodNumber;
+            }, z.core.$strip>>;
+            label: z.ZodString;
+            resetsAt: z.ZodNullable<z.ZodString>;
+            usedPercent: z.ZodNumber;
+        }, z.core.$loose>>;
+    }, z.core.$loose>, z.ZodObject<{
+        status: z.ZodLiteral<"not_installed">;
+    }, z.core.$loose>, z.ZodObject<{
+        status: z.ZodLiteral<"unauthenticated">;
+    }, z.core.$loose>, z.ZodObject<{
+        status: z.ZodLiteral<"expired">;
+    }, z.core.$loose>, z.ZodObject<{
+        accountEmail: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        message: z.ZodString;
+        planLabel: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        status: z.ZodLiteral<"error">;
+    }, z.core.$loose>], "status">;
+}, z.core.$loose>], "supported">;
+type ExperimentalProviderUsageResult = z.infer<typeof experimental_providerUsageResultSchema>;
+declare const experimental_providerInstallationActionKindSchema: z.ZodEnum<{
+    install: "install";
+    update: "update";
+}>;
+type ExperimentalProviderInstallationActionKind = z.infer<typeof experimental_providerInstallationActionKindSchema>;
+/**
+ * An installation action that a provider currently knows how to perform.
+ * Only the display command crosses the product boundary; the executable plan
+ * is resolved afresh by `provider/installation/run` on the host.
+ */
+declare const experimental_providerInstallationActionSchema: z.ZodObject<{
+    command: z.ZodString;
+    kind: z.ZodEnum<{
+        install: "install";
+        update: "update";
+    }>;
+    label: z.ZodEnum<{
+        Install: "Install";
+        Update: "Update";
+    }>;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationAction = z.infer<typeof experimental_providerInstallationActionSchema>;
+declare const experimental_providerInstallationSourceSchema: z.ZodEnum<{
+    external: "external";
+    notInstalled: "notInstalled";
+    npmGlobal: "npmGlobal";
+}>;
+type ExperimentalProviderInstallationSource = z.infer<typeof experimental_providerInstallationSourceSchema>;
+/** Provider-owned installation and update state for one host. */
+declare const experimental_providerInstallationStatusSchema: z.ZodObject<{
+    currentVersion: z.ZodNullable<z.ZodString>;
+    executableName: z.ZodString;
+    executablePath: z.ZodNullable<z.ZodString>;
+    installAction: z.ZodNullable<z.ZodObject<{
+        command: z.ZodString;
+        kind: z.ZodEnum<{
+            install: "install";
+            update: "update";
+        }>;
+        label: z.ZodEnum<{
+            Install: "Install";
+            Update: "Update";
+        }>;
+    }, z.core.$loose>>;
+    installSource: z.ZodEnum<{
+        external: "external";
+        notInstalled: "notInstalled";
+        npmGlobal: "npmGlobal";
+    }>;
+    installed: z.ZodBoolean;
+    latestVersion: z.ZodNullable<z.ZodString>;
+    minimumSupportedVersion: z.ZodNullable<z.ZodString>;
+    needsUpdate: z.ZodBoolean;
+    npmGlobalPackageVersion: z.ZodNullable<z.ZodString>;
+    npmPackageName: z.ZodNullable<z.ZodString>;
+    versionUnsupported: z.ZodBoolean;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationStatus = z.infer<typeof experimental_providerInstallationStatusSchema>;
+declare const experimental_providerInstallationRunParamsSchema: z.ZodObject<{
+    action: z.ZodEnum<{
+        install: "install";
+        update: "update";
+    }>;
+    cwd: z.ZodOptional<z.ZodString>;
+    providerId: z.ZodString;
+    providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationRunParams = z.infer<typeof experimental_providerInstallationRunParamsSchema>;
+/**
+ * A typed process plan. The provider chooses the executable and arguments;
+ * the daemon chooses the environment and cwd and owns process supervision.
+ */
+declare const experimental_providerInstallationCommandSchema: z.ZodObject<{
+    args: z.ZodArray<z.ZodString>;
+    command: z.ZodString;
+    displayCommand: z.ZodString;
+}, z.core.$loose>;
+type ExperimentalProviderInstallationCommand = z.infer<typeof experimental_providerInstallationCommandSchema>;
+declare const experimental_providerInstallationVerificationSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"installed">;
+}, z.core.$loose>, z.ZodObject<{
+    kind: z.ZodLiteral<"version_changed">;
+    previousVersion: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    kind: z.ZodLiteral<"version_at_least">;
+    version: z.ZodString;
+}, z.core.$loose>], "kind">;
+type ExperimentalProviderInstallationVerification = z.infer<typeof experimental_providerInstallationVerificationSchema>;
+/**
+ * `available: false` handles a stale action safely: status may have changed
+ * between rendering a button and the daemon resolving the execution plan.
+ */
+declare const experimental_providerInstallationRunResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    available: z.ZodLiteral<false>;
+    message: z.ZodString;
+}, z.core.$loose>, z.ZodObject<{
+    available: z.ZodLiteral<true>;
+    command: z.ZodObject<{
+        args: z.ZodArray<z.ZodString>;
+        command: z.ZodString;
+        displayCommand: z.ZodString;
+    }, z.core.$loose>;
+    verification: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"installed">;
+    }, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"version_changed">;
+        previousVersion: z.ZodString;
+    }, z.core.$loose>, z.ZodObject<{
+        kind: z.ZodLiteral<"version_at_least">;
+        version: z.ZodString;
+    }, z.core.$loose>], "kind">;
+}, z.core.$loose>], "available">;
+type ExperimentalProviderInstallationRunResult = z.infer<typeof experimental_providerInstallationRunResultSchema>;
+
 /**
  * Canonical runtime → bridge request methods. One vocabulary for every
  * provider: a bridge maps these to its provider's native dialect internally
@@ -1574,6 +2163,10 @@ type BridgeExecutionOptions = z.infer<typeof bridgeExecutionOptionsSchema>;
 declare const BRIDGE_REQUEST_METHODS: {
     readonly initialize: "initialize";
     readonly modelList: "model/list";
+    readonly experimentalProviderHealth: "provider/health";
+    readonly experimentalProviderUsage: "provider/usage";
+    readonly experimentalProviderInstallationStatus: "provider/installation/status";
+    readonly experimentalProviderInstallationRun: "provider/installation/run";
     readonly threadStart: "thread/start";
     readonly threadResume: "thread/resume";
     readonly threadFork: "thread/fork";
@@ -1597,6 +2190,22 @@ declare const threadStartParamsSchema: z.ZodObject<{
         description: z.ZodString;
         inputSchema: z.ZodUnknown;
         name: z.ZodString;
+        presentation: z.ZodOptional<z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     input: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         mentions: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -1687,6 +2296,7 @@ declare const threadStartParamsSchema: z.ZodObject<{
         envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         instructions: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        promptMode: z.ZodOptional<z.ZodLiteral<"plan">>;
         providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         reasoningLevel: z.ZodOptional<z.ZodEnum<{
             high: "high";
@@ -1733,6 +2343,22 @@ declare const threadResumeParamsSchema: z.ZodObject<{
         description: z.ZodString;
         inputSchema: z.ZodUnknown;
         name: z.ZodString;
+        presentation: z.ZodOptional<z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     instructionMode: z.ZodEnum<{
         append: "append";
@@ -1742,6 +2368,7 @@ declare const threadResumeParamsSchema: z.ZodObject<{
         envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         instructions: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        promptMode: z.ZodOptional<z.ZodLiteral<"plan">>;
         providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         reasoningLevel: z.ZodOptional<z.ZodEnum<{
             high: "high";
@@ -1789,6 +2416,22 @@ declare const threadForkParamsSchema: z.ZodObject<{
         description: z.ZodString;
         inputSchema: z.ZodUnknown;
         name: z.ZodString;
+        presentation: z.ZodOptional<z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>>;
     instructionMode: z.ZodEnum<{
         append: "append";
@@ -1798,6 +2441,7 @@ declare const threadForkParamsSchema: z.ZodObject<{
         envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         instructions: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        promptMode: z.ZodOptional<z.ZodLiteral<"plan">>;
         providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         reasoningLevel: z.ZodOptional<z.ZodEnum<{
             high: "high";
@@ -1956,6 +2600,7 @@ declare const turnStartParamsSchema: z.ZodObject<{
         envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         instructions: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        promptMode: z.ZodOptional<z.ZodLiteral<"plan">>;
         providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         reasoningLevel: z.ZodOptional<z.ZodEnum<{
             high: "high";
@@ -2084,6 +2729,7 @@ declare const turnSteerParamsSchema: z.ZodObject<{
         envVars: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
         instructions: z.ZodOptional<z.ZodString>;
         model: z.ZodOptional<z.ZodString>;
+        promptMode: z.ZodOptional<z.ZodLiteral<"plan">>;
         providerOptions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
         reasoningLevel: z.ZodOptional<z.ZodEnum<{
             high: "high";
@@ -2152,10 +2798,42 @@ declare const skillsConfigureParamsSchema: z.ZodObject<{
 declare const BRIDGE_NOTIFICATION_METHODS: {
     readonly threadIdentity: "thread/identity";
     readonly sessionReplaced: "session/replaced";
-    readonly threadOpenWork: "thread/openWork";
     readonly providerRaw: "provider/raw";
+    readonly providerRecovery: "provider/recovery";
     readonly error: "error";
 };
+/**
+ * A typed recovery hint: the bridge tells the runtime WHAT went wrong in the
+ * runtime's own vocabulary, so the runtime never matches provider error text
+ * (the codex regex set, the account-restart list, the archive idempotency
+ * string match all go away in WS4). A runtime signal, not a timeline item —
+ * the user-visible consequence, when there is one, is the `provider/error`
+ * delta the bridge emits alongside, and the timeline stays free of
+ * "restarting the bridge" noise. Lives here with `session/replaced` rather
+ * than in `thread/delta` for the same reason `provider/raw` does: it is
+ * consumed by the runtime's recovery logic, never persisted.
+ *
+ * `threadId` is absent for provider-wide conditions (`authRequired`,
+ * `rateLimited` at the account level) and present when the hint is about one
+ * session (`sessionArchived`, `staleTurn`). `retryable` says whether the
+ * runtime may retry the failed command after acting on the hint.
+ *
+ * Additive: no consumer yet. WS4 (runtime cleanup) acts on each kind; until
+ * then the runtime ignores the method like any unknown notification.
+ */
+declare const providerRecoveryNotificationSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        authRequired: "authRequired";
+        rateLimited: "rateLimited";
+        restartRecommended: "restartRecommended";
+        sessionArchived: "sessionArchived";
+        staleTurn: "staleTurn";
+    }>;
+    message: z.ZodString;
+    retryable: z.ZodBoolean;
+    threadId: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type ProviderRecoveryNotification = z.infer<typeof providerRecoveryNotificationSchema>;
 
 /**
  * Bridge → runtime requests: the two channels where the provider needs an
@@ -2192,6 +2870,35 @@ declare const BRIDGE_JSON_RPC_ERRORS: {
 };
 
 declare const THREAD_DELTA_NOTIFICATION_METHOD = "thread/delta";
+/**
+ * Declarative presentation a bridge attaches to an item at `item.open` (and
+ * re-states on `item.close`, whose item is the full terminal shape). The
+ * assembler persists it on the canonical item so the row renders after the
+ * plugin is uninstalled or upgraded, and so mobile renders every kind without
+ * plugin code. The same schema as the persisted field
+ * (`threadEventItemPresentationSchema` in @bb/domain) — one vocabulary, no
+ * translation.
+ *
+ * Optional in grammar v3 so v2 bridges still validate; a later workstream
+ * makes it required once every first-party bridge attaches it.
+ */
+declare const deltaPresentationSchema: z.ZodObject<{
+    detail: z.ZodOptional<z.ZodString>;
+    icon: z.ZodObject<{
+        glyph: z.ZodString;
+    }, z.core.$strip>;
+    label: z.ZodObject<{
+        completed: z.ZodString;
+        pending: z.ZodString;
+    }, z.core.$strip>;
+    suppress: z.ZodOptional<z.ZodBoolean>;
+    tint: z.ZodOptional<z.ZodObject<{
+        dark: z.ZodString;
+        light: z.ZodString;
+    }, z.core.$strip>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type DeltaPresentation = z.infer<typeof deltaPresentationSchema>;
 /**
  * Provider-native join key for an item. `providerItemId` is the provider's
  * own id (a tool-call id); `channel` distinguishes provider-anonymous item
@@ -2307,6 +3014,105 @@ declare const deltaBackgroundTaskShapeSchema: z.ZodObject<{
     workflowName: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type DeltaBackgroundTaskShape = z.infer<typeof deltaBackgroundTaskShapeSchema>;
+/**
+ * A file the agent read (grammar v3). Claude `Read` is the top generic tool in
+ * the production corpus — 7,568 calls rendered as opaque `tool` rows — and
+ * codex reads files through `cat`/`sed -n` commands the bridge already
+ * classifies as read intents. `cmd` carries that native shell form when the
+ * read ran through a command rather than a structured tool.
+ */
+declare const deltaFileReadShapeSchema: z.ZodObject<{
+    cmd: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    type: z.ZodLiteral<"fileRead">;
+}, z.core.$strip>;
+type DeltaFileReadShape = z.infer<typeof deltaFileReadShapeSchema>;
+/**
+ * Grep, glob and directory listing as one shape (grammar v3), discriminated
+ * by `mode`: `content` searches inside files (Claude `Grep`, `rg`), `path`
+ * matches file names (Claude `Glob`, `fd`), `list` enumerates a directory
+ * (`ls`, codex `list_dir`). `query` is the pattern — text or a regex for
+ * `content`, a glob for `path`, an optional filter for `list` (empty when the
+ * whole directory is listed); `path` is the root the search ran under when
+ * the provider named one; `cmd` is the native shell form when it ran through
+ * a command.
+ */
+declare const deltaSearchShapeSchema: z.ZodObject<{
+    cmd: z.ZodOptional<z.ZodString>;
+    mode: z.ZodEnum<{
+        content: "content";
+        list: "list";
+        path: "path";
+    }>;
+    path: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    type: z.ZodLiteral<"search">;
+}, z.core.$strip>;
+type DeltaSearchShape = z.infer<typeof deltaSearchShapeSchema>;
+/**
+ * Delegated work (grammar v3): one shape for the three encodings in the
+ * production data — codex `spawnAgent`/`wait` tool calls, the Claude `Agent`
+ * tool with nested child turns, and backgrounded `local_agent` background
+ * tasks — and for what the `thread/openWork` notification used to report,
+ * since an open delegation IS open work. `childRef` is the provider-native child id; the
+ * child's own deltas link back through `parentRef`. `background: true` marks
+ * a delegation that outlives its turn: the assembler routes its progress and
+ * close to the thread-scoped `item/delegation/*` events exactly as it does
+ * for `backgroundTask`. The terminal `status` rides `item.close`, as
+ * for `command` and `tool`; `summary` is the child's terminal summary.
+ */
+declare const deltaDelegationShapeSchema: z.ZodObject<{
+    background: z.ZodBoolean;
+    childRef: z.ZodString;
+    label: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"delegation">;
+}, z.core.$strip>;
+type DeltaDelegationShape = z.infer<typeof deltaDelegationShapeSchema>;
+/**
+ * A structured plan snapshot as an item (grammar v3): codex `update_plan`
+ * (295 production threads, discarded by the UI while it only rode the
+ * turn-level `turn.plan`), ACP `plan` updates, and Claude
+ * `TaskCreate`/`TaskUpdate`/`TodoWrite`. Each snapshot carries the full step
+ * list and supersedes the previous one. The turn-level `turn.plan` delta is
+ * gone: every in-repo bridge speaks this form, and the persisted
+ * `turn/plan/updated` event type stays as read-only history.
+ */
+declare const deltaPlanStepsShapeSchema: z.ZodObject<{
+    explanation: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+        }>>;
+        step: z.ZodString;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"planSteps">;
+}, z.core.$strip>;
+type DeltaPlanStepsShape = z.infer<typeof deltaPlanStepsShapeSchema>;
+/**
+ * A plugin-defined item kind outside the core vocabulary (grammar v3).
+ * `kind` is the namespaced `"<pluginId>/<name>"` the plugin declared in its
+ * provider registration (`extensionKinds`); only the namespace shape is
+ * validated here. The payload is opaque JSON at this layer: the assembler
+ * copies it onto the canonical item, and the server validates it against the
+ * plugin's declared item schema for `kind` at ingest, persisting a
+ * `provider/unhandled` in its place on a miss.
+ *
+ * The shape carries no presentation of its own: presentation lives in ONE
+ * place, the `item.open`/`item.close` delta's `presentation` field, and for
+ * an extension shape that field is REQUIRED (enforced by the delta schema
+ * below) — an extension item has no core renderer, so the declarative base
+ * is the only thing every client can show.
+ */
+declare const deltaExtensionShapeSchema: z.ZodObject<{
+    kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+    payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    type: z.ZodLiteral<"extension">;
+}, z.core.$strip>;
+type DeltaExtensionShape = z.infer<typeof deltaExtensionShapeSchema>;
 declare const deltaItemShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     aggregatedOutput: z.ZodOptional<z.ZodString>;
     command: z.ZodString;
@@ -2346,20 +3152,131 @@ declare const deltaItemShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     summary: z.ZodArray<z.ZodString>;
     type: z.ZodLiteral<"reasoning">;
 }, z.core.$strip>, z.ZodObject<{
-    text: z.ZodString;
-    type: z.ZodLiteral<"plan">;
+    text: z.ZodString;
+    type: z.ZodLiteral<"plan">;
+}, z.core.$strip>, z.ZodObject<{
+    queries: z.ZodArray<z.ZodString>;
+    type: z.ZodLiteral<"webSearch">;
+}, z.core.$strip>, z.ZodObject<{
+    pattern: z.ZodNullable<z.ZodString>;
+    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodLiteral<"webFetch">;
+    url: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    path: z.ZodString;
+    type: z.ZodLiteral<"imageView">;
+}, z.core.$strip>, z.ZodObject<{
+    description: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+    familyId: z.ZodString;
+    outputFile: z.ZodOptional<z.ZodString>;
+    skipTranscript: z.ZodBoolean;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        interrupted: "interrupted";
+        pending: "pending";
+    }>;
+    summary: z.ZodOptional<z.ZodString>;
+    taskStatus: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        killed: "killed";
+        paused: "paused";
+        pending: "pending";
+        running: "running";
+        stopped: "stopped";
+    }>;
+    taskType: z.ZodString;
+    type: z.ZodLiteral<"backgroundTask">;
+    usage: z.ZodOptional<z.ZodObject<{
+        durationMs: z.ZodNumber;
+        toolUses: z.ZodNumber;
+        totalTokens: z.ZodNumber;
+    }, z.core.$strip>>;
+    workflow: z.ZodOptional<z.ZodObject<{
+        agents: z.ZodArray<z.ZodObject<{
+            agentType: z.ZodOptional<z.ZodString>;
+            attempt: z.ZodNumber;
+            cached: z.ZodBoolean;
+            durationMs: z.ZodOptional<z.ZodNumber>;
+            error: z.ZodOptional<z.ZodString>;
+            index: z.ZodNumber;
+            isolation: z.ZodOptional<z.ZodString>;
+            label: z.ZodString;
+            lastProgressAt: z.ZodNumber;
+            lastToolName: z.ZodOptional<z.ZodString>;
+            lastToolSummary: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+            phaseIndex: z.ZodOptional<z.ZodNumber>;
+            phaseTitle: z.ZodOptional<z.ZodString>;
+            promptPreview: z.ZodOptional<z.ZodString>;
+            queuedAt: z.ZodOptional<z.ZodNumber>;
+            resultPreview: z.ZodOptional<z.ZodString>;
+            startedAt: z.ZodOptional<z.ZodNumber>;
+            state: z.ZodEnum<{
+                done: "done";
+                failed: "failed";
+                queued: "queued";
+                running: "running";
+                skipped: "skipped";
+            }>;
+            tokens: z.ZodOptional<z.ZodNumber>;
+            toolCalls: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        phases: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            kind: z.ZodOptional<z.ZodString>;
+            title: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    workflowName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    cmd: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    type: z.ZodLiteral<"fileRead">;
 }, z.core.$strip>, z.ZodObject<{
-    queries: z.ZodArray<z.ZodString>;
-    type: z.ZodLiteral<"webSearch">;
+    cmd: z.ZodOptional<z.ZodString>;
+    mode: z.ZodEnum<{
+        content: "content";
+        list: "list";
+        path: "path";
+    }>;
+    path: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    type: z.ZodLiteral<"search">;
 }, z.core.$strip>, z.ZodObject<{
-    pattern: z.ZodNullable<z.ZodString>;
-    prompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    type: z.ZodLiteral<"webFetch">;
-    url: z.ZodString;
+    background: z.ZodBoolean;
+    childRef: z.ZodString;
+    label: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"delegation">;
 }, z.core.$strip>, z.ZodObject<{
-    path: z.ZodString;
-    type: z.ZodLiteral<"imageView">;
+    explanation: z.ZodOptional<z.ZodString>;
+    steps: z.ZodArray<z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            active: "active";
+            completed: "completed";
+            failed: "failed";
+            pending: "pending";
+        }>>;
+        step: z.ZodString;
+    }, z.core.$strip>>;
+    type: z.ZodLiteral<"planSteps">;
 }, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+    payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+    type: z.ZodLiteral<"extension">;
+}, z.core.$strip>], "type">;
+type DeltaItemShape = z.infer<typeof deltaItemShapeSchema>;
+type DeltaItemShapeType = DeltaItemShape["type"];
+/**
+ * The re-embedded snapshot an `item.progress` may carry for work that
+ * outlives its turn. `backgroundTask` is the v2 form; `delegation` joins it in
+ * v3 for background delegations (the assembler routes it to
+ * `item/delegation/progress`).
+ */
+declare const deltaProgressSnapshotSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     description: z.ZodString;
     error: z.ZodOptional<z.ZodString>;
     familyId: z.ZodString;
@@ -2425,16 +3342,20 @@ declare const deltaItemShapeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     workflowName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    background: z.ZodBoolean;
+    childRef: z.ZodString;
+    label: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"delegation">;
 }, z.core.$strip>], "type">;
-type DeltaItemShape = z.infer<typeof deltaItemShapeSchema>;
-declare const deltaMessageChannelSchema: z.ZodEnum<{
-    assistant: "assistant";
-    reasoning: "reasoning";
-}>;
-type DeltaMessageChannel = z.infer<typeof deltaMessageChannelSchema>;
+type DeltaProgressSnapshot = z.infer<typeof deltaProgressSnapshotSchema>;
 /**
- * Item-keyed text channels (codex): channels that synthesize a delta-first
- * `item/started` for an unknown item id.
+ * The streamed-text channels: which text item a stream feeds and which of its
+ * fields the text lands in. `agentMessage` and `plan` items have one text;
+ * a `reasoning` item has `summary` (`reasoningSummary`) and `content`
+ * (`reasoningText`). A delta for an unknown item key synthesizes the
+ * channel's `item/started`.
  */
 declare const deltaTextChannelSchema: z.ZodEnum<{
     agentMessage: "agentMessage";
@@ -2617,6 +3538,42 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         workflowName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        cmd: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        type: z.ZodLiteral<"fileRead">;
+    }, z.core.$strip>, z.ZodObject<{
+        cmd: z.ZodOptional<z.ZodString>;
+        mode: z.ZodEnum<{
+            content: "content";
+            list: "list";
+            path: "path";
+        }>;
+        path: z.ZodOptional<z.ZodString>;
+        query: z.ZodString;
+        type: z.ZodLiteral<"search">;
+    }, z.core.$strip>, z.ZodObject<{
+        background: z.ZodBoolean;
+        childRef: z.ZodString;
+        label: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"delegation">;
+    }, z.core.$strip>, z.ZodObject<{
+        explanation: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodObject<{
+            status: z.ZodOptional<z.ZodEnum<{
+                active: "active";
+                completed: "completed";
+                failed: "failed";
+                pending: "pending";
+            }>>;
+            step: z.ZodString;
+        }, z.core.$strip>>;
+        type: z.ZodLiteral<"planSteps">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+        payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        type: z.ZodLiteral<"extension">;
     }, z.core.$strip>], "type">;
     key: z.ZodObject<{
         channel: z.ZodOptional<z.ZodString>;
@@ -2633,6 +3590,22 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>;
         rawType: z.ZodString;
     }, z.core.$strip>>;
+    presentation: z.ZodOptional<z.ZodObject<{
+        detail: z.ZodOptional<z.ZodString>;
+        icon: z.ZodObject<{
+            glyph: z.ZodString;
+        }, z.core.$strip>;
+        label: z.ZodObject<{
+            completed: z.ZodString;
+            pending: z.ZodString;
+        }, z.core.$strip>;
+        suppress: z.ZodOptional<z.ZodBoolean>;
+        tint: z.ZodOptional<z.ZodObject<{
+            dark: z.ZodString;
+            light: z.ZodString;
+        }, z.core.$strip>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     providerTurnId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     aggregatedOutput: z.ZodOptional<z.ZodString>;
@@ -2756,6 +3729,42 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         workflowName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        cmd: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
+        type: z.ZodLiteral<"fileRead">;
+    }, z.core.$strip>, z.ZodObject<{
+        cmd: z.ZodOptional<z.ZodString>;
+        mode: z.ZodEnum<{
+            content: "content";
+            list: "list";
+            path: "path";
+        }>;
+        path: z.ZodOptional<z.ZodString>;
+        query: z.ZodString;
+        type: z.ZodLiteral<"search">;
+    }, z.core.$strip>, z.ZodObject<{
+        background: z.ZodBoolean;
+        childRef: z.ZodString;
+        label: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"delegation">;
+    }, z.core.$strip>, z.ZodObject<{
+        explanation: z.ZodOptional<z.ZodString>;
+        steps: z.ZodArray<z.ZodObject<{
+            status: z.ZodOptional<z.ZodEnum<{
+                active: "active";
+                completed: "completed";
+                failed: "failed";
+                pending: "pending";
+            }>>;
+            step: z.ZodString;
+        }, z.core.$strip>>;
+        type: z.ZodLiteral<"planSteps">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+        payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+        type: z.ZodLiteral<"extension">;
     }, z.core.$strip>], "type">;
     key: z.ZodObject<{
         channel: z.ZodOptional<z.ZodString>;
@@ -2772,6 +3781,22 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>;
         rawType: z.ZodString;
     }, z.core.$strip>>;
+    presentation: z.ZodOptional<z.ZodObject<{
+        detail: z.ZodOptional<z.ZodString>;
+        icon: z.ZodObject<{
+            glyph: z.ZodString;
+        }, z.core.$strip>;
+        label: z.ZodObject<{
+            completed: z.ZodString;
+            pending: z.ZodString;
+        }, z.core.$strip>;
+        suppress: z.ZodOptional<z.ZodBoolean>;
+        tint: z.ZodOptional<z.ZodObject<{
+            dark: z.ZodString;
+            light: z.ZodString;
+        }, z.core.$strip>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     providerTurnId: z.ZodOptional<z.ZodString>;
     resultText: z.ZodOptional<z.ZodString>;
     status: z.ZodEnum<{
@@ -2780,28 +3805,6 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         interrupted: "interrupted";
         pending: "pending";
     }>;
-}, z.core.$strip>, z.ZodObject<{
-    explanation: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"turn.plan">;
-    noTurnFallback: z.ZodOptional<z.ZodObject<{
-        raw: z.ZodObject<{
-            id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-            jsonrpc: z.ZodLiteral<"2.0">;
-            method: z.ZodString;
-            params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
-        }, z.core.$strip>;
-        rawType: z.ZodString;
-    }, z.core.$strip>>;
-    providerTurnId: z.ZodOptional<z.ZodString>;
-    steps: z.ZodArray<z.ZodObject<{
-        status: z.ZodOptional<z.ZodEnum<{
-            active: "active";
-            completed: "completed";
-            failed: "failed";
-            pending: "pending";
-        }>>;
-        step: z.ZodString;
-    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     flush: z.ZodOptional<z.ZodBoolean>;
     key: z.ZodObject<{
@@ -2821,7 +3824,7 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         rawType: z.ZodString;
     }, z.core.$strip>>;
     providerTurnId: z.ZodOptional<z.ZodString>;
-    snapshot: z.ZodOptional<z.ZodObject<{
+    snapshot: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
         description: z.ZodString;
         error: z.ZodOptional<z.ZodString>;
         familyId: z.ZodString;
@@ -2887,13 +3890,26 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }, z.core.$strip>>;
         }, z.core.$strip>>;
         workflowName: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        background: z.ZodBoolean;
+        childRef: z.ZodString;
+        label: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+        type: z.ZodLiteral<"delegation">;
+    }, z.core.$strip>], "type">>;
 }, z.core.$strip>, z.ZodObject<{
     channel: z.ZodEnum<{
-        assistant: "assistant";
-        reasoning: "reasoning";
+        agentMessage: "agentMessage";
+        plan: "plan";
+        reasoningSummary: "reasoningSummary";
+        reasoningText: "reasoningText";
     }>;
-    kind: z.ZodLiteral<"message.delta">;
+    key: z.ZodObject<{
+        channel: z.ZodOptional<z.ZodString>;
+        parentRef: z.ZodOptional<z.ZodString>;
+        providerItemId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    kind: z.ZodLiteral<"item.textDelta">;
     noTurnFallback: z.ZodOptional<z.ZodObject<{
         raw: z.ZodObject<{
             id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -2903,27 +3919,8 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strip>;
         rawType: z.ZodString;
     }, z.core.$strip>>;
-    parentRef: z.ZodOptional<z.ZodString>;
-    streamKey: z.ZodString;
+    providerTurnId: z.ZodOptional<z.ZodString>;
     text: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-    channel: z.ZodEnum<{
-        assistant: "assistant";
-        reasoning: "reasoning";
-    }>;
-    kind: z.ZodLiteral<"message.close">;
-    noTurnFallback: z.ZodOptional<z.ZodObject<{
-        raw: z.ZodObject<{
-            id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-            jsonrpc: z.ZodLiteral<"2.0">;
-            method: z.ZodString;
-            params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
-        }, z.core.$strip>;
-        rawType: z.ZodString;
-    }, z.core.$strip>>;
-    parentRef: z.ZodOptional<z.ZodString>;
-    streamKey: z.ZodOptional<z.ZodString>;
-    text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     channel: z.ZodEnum<{
         agentMessage: "agentMessage";
@@ -2936,7 +3933,7 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         parentRef: z.ZodOptional<z.ZodString>;
         providerItemId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
-    kind: z.ZodLiteral<"item.textDelta">;
+    kind: z.ZodLiteral<"item.textClose">;
     noTurnFallback: z.ZodOptional<z.ZodObject<{
         raw: z.ZodObject<{
             id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -2947,7 +3944,7 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         rawType: z.ZodString;
     }, z.core.$strip>>;
     providerTurnId: z.ZodOptional<z.ZodString>;
-    text: z.ZodString;
+    text: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     channel: z.ZodEnum<{
         command: "command";
@@ -2988,17 +3985,7 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }, z.core.$strip>>;
     text: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"usage.turn">;
-    modelContextWindow: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    tokens: z.ZodObject<{
-        cachedInputTokens: z.ZodNumber;
-        inputTokens: z.ZodNumber;
-        outputTokens: z.ZodNumber;
-        reasoningOutputTokens: z.ZodNumber;
-        totalTokens: z.ZodNumber;
-    }, z.core.$strip>;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"usage.exact">;
+    kind: z.ZodLiteral<"usage">;
     last: z.ZodObject<{
         cachedInputTokens: z.ZodNumber;
         inputTokens: z.ZodNumber;
@@ -3022,6 +4009,7 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     }>;
     estimated: z.ZodBoolean;
     kind: z.ZodLiteral<"contextWindow">;
+    providerTurnId: z.ZodOptional<z.ZodString>;
     size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     used: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
@@ -3051,19 +4039,9 @@ declare const threadDeltaSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     kind: z.ZodLiteral<"thread.name">;
     name: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"thread.goal">;
-    objective: z.ZodString;
-    status: z.ZodEnum<{
-        active: "active";
-        budgetLimited: "budgetLimited";
-        complete: "complete";
-        paused: "paused";
-    }>;
-    timeUsedSeconds: z.ZodNumber;
-    tokenBudget: z.ZodNullable<z.ZodNumber>;
-    tokensUsed: z.ZodNumber;
-}, z.core.$strip>, z.ZodObject<{
-    kind: z.ZodLiteral<"thread.goalCleared">;
+    extensionKind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+    kind: z.ZodLiteral<"extension.state">;
+    payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"provider.rateLimits">;
     rateLimits: z.ZodObject<{
@@ -3340,6 +4318,42 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
             workflowName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            cmd: z.ZodOptional<z.ZodString>;
+            path: z.ZodString;
+            type: z.ZodLiteral<"fileRead">;
+        }, z.core.$strip>, z.ZodObject<{
+            cmd: z.ZodOptional<z.ZodString>;
+            mode: z.ZodEnum<{
+                content: "content";
+                list: "list";
+                path: "path";
+            }>;
+            path: z.ZodOptional<z.ZodString>;
+            query: z.ZodString;
+            type: z.ZodLiteral<"search">;
+        }, z.core.$strip>, z.ZodObject<{
+            background: z.ZodBoolean;
+            childRef: z.ZodString;
+            label: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"delegation">;
+        }, z.core.$strip>, z.ZodObject<{
+            explanation: z.ZodOptional<z.ZodString>;
+            steps: z.ZodArray<z.ZodObject<{
+                status: z.ZodOptional<z.ZodEnum<{
+                    active: "active";
+                    completed: "completed";
+                    failed: "failed";
+                    pending: "pending";
+                }>>;
+                step: z.ZodString;
+            }, z.core.$strip>>;
+            type: z.ZodLiteral<"planSteps">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+            payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+            type: z.ZodLiteral<"extension">;
         }, z.core.$strip>], "type">;
         key: z.ZodObject<{
             channel: z.ZodOptional<z.ZodString>;
@@ -3356,6 +4370,22 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             }, z.core.$strip>;
             rawType: z.ZodString;
         }, z.core.$strip>>;
+        presentation: z.ZodOptional<z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         providerTurnId: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         aggregatedOutput: z.ZodOptional<z.ZodString>;
@@ -3479,6 +4509,42 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
             workflowName: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            cmd: z.ZodOptional<z.ZodString>;
+            path: z.ZodString;
+            type: z.ZodLiteral<"fileRead">;
+        }, z.core.$strip>, z.ZodObject<{
+            cmd: z.ZodOptional<z.ZodString>;
+            mode: z.ZodEnum<{
+                content: "content";
+                list: "list";
+                path: "path";
+            }>;
+            path: z.ZodOptional<z.ZodString>;
+            query: z.ZodString;
+            type: z.ZodLiteral<"search">;
+        }, z.core.$strip>, z.ZodObject<{
+            background: z.ZodBoolean;
+            childRef: z.ZodString;
+            label: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"delegation">;
+        }, z.core.$strip>, z.ZodObject<{
+            explanation: z.ZodOptional<z.ZodString>;
+            steps: z.ZodArray<z.ZodObject<{
+                status: z.ZodOptional<z.ZodEnum<{
+                    active: "active";
+                    completed: "completed";
+                    failed: "failed";
+                    pending: "pending";
+                }>>;
+                step: z.ZodString;
+            }, z.core.$strip>>;
+            type: z.ZodLiteral<"planSteps">;
+        }, z.core.$strip>, z.ZodObject<{
+            kind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+            payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
+            type: z.ZodLiteral<"extension">;
         }, z.core.$strip>], "type">;
         key: z.ZodObject<{
             channel: z.ZodOptional<z.ZodString>;
@@ -3495,6 +4561,22 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             }, z.core.$strip>;
             rawType: z.ZodString;
         }, z.core.$strip>>;
+        presentation: z.ZodOptional<z.ZodObject<{
+            detail: z.ZodOptional<z.ZodString>;
+            icon: z.ZodObject<{
+                glyph: z.ZodString;
+            }, z.core.$strip>;
+            label: z.ZodObject<{
+                completed: z.ZodString;
+                pending: z.ZodString;
+            }, z.core.$strip>;
+            suppress: z.ZodOptional<z.ZodBoolean>;
+            tint: z.ZodOptional<z.ZodObject<{
+                dark: z.ZodString;
+                light: z.ZodString;
+            }, z.core.$strip>>;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
         providerTurnId: z.ZodOptional<z.ZodString>;
         resultText: z.ZodOptional<z.ZodString>;
         status: z.ZodEnum<{
@@ -3503,28 +4585,6 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             interrupted: "interrupted";
             pending: "pending";
         }>;
-    }, z.core.$strip>, z.ZodObject<{
-        explanation: z.ZodOptional<z.ZodString>;
-        kind: z.ZodLiteral<"turn.plan">;
-        noTurnFallback: z.ZodOptional<z.ZodObject<{
-            raw: z.ZodObject<{
-                id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-                jsonrpc: z.ZodLiteral<"2.0">;
-                method: z.ZodString;
-                params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
-            }, z.core.$strip>;
-            rawType: z.ZodString;
-        }, z.core.$strip>>;
-        providerTurnId: z.ZodOptional<z.ZodString>;
-        steps: z.ZodArray<z.ZodObject<{
-            status: z.ZodOptional<z.ZodEnum<{
-                active: "active";
-                completed: "completed";
-                failed: "failed";
-                pending: "pending";
-            }>>;
-            step: z.ZodString;
-        }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         flush: z.ZodOptional<z.ZodBoolean>;
         key: z.ZodObject<{
@@ -3544,7 +4604,7 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             rawType: z.ZodString;
         }, z.core.$strip>>;
         providerTurnId: z.ZodOptional<z.ZodString>;
-        snapshot: z.ZodOptional<z.ZodObject<{
+        snapshot: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
             description: z.ZodString;
             error: z.ZodOptional<z.ZodString>;
             familyId: z.ZodString;
@@ -3610,13 +4670,26 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
                 }, z.core.$strip>>;
             }, z.core.$strip>>;
             workflowName: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>, z.ZodObject<{
+            background: z.ZodBoolean;
+            childRef: z.ZodString;
+            label: z.ZodString;
+            summary: z.ZodOptional<z.ZodString>;
+            type: z.ZodLiteral<"delegation">;
+        }, z.core.$strip>], "type">>;
     }, z.core.$strip>, z.ZodObject<{
         channel: z.ZodEnum<{
-            assistant: "assistant";
-            reasoning: "reasoning";
+            agentMessage: "agentMessage";
+            plan: "plan";
+            reasoningSummary: "reasoningSummary";
+            reasoningText: "reasoningText";
         }>;
-        kind: z.ZodLiteral<"message.delta">;
+        key: z.ZodObject<{
+            channel: z.ZodOptional<z.ZodString>;
+            parentRef: z.ZodOptional<z.ZodString>;
+            providerItemId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        kind: z.ZodLiteral<"item.textDelta">;
         noTurnFallback: z.ZodOptional<z.ZodObject<{
             raw: z.ZodObject<{
                 id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -3626,27 +4699,8 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             }, z.core.$strip>;
             rawType: z.ZodString;
         }, z.core.$strip>>;
-        parentRef: z.ZodOptional<z.ZodString>;
-        streamKey: z.ZodString;
+        providerTurnId: z.ZodOptional<z.ZodString>;
         text: z.ZodString;
-    }, z.core.$strip>, z.ZodObject<{
-        channel: z.ZodEnum<{
-            assistant: "assistant";
-            reasoning: "reasoning";
-        }>;
-        kind: z.ZodLiteral<"message.close">;
-        noTurnFallback: z.ZodOptional<z.ZodObject<{
-            raw: z.ZodObject<{
-                id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
-                jsonrpc: z.ZodLiteral<"2.0">;
-                method: z.ZodString;
-                params: z.ZodOptional<z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>>;
-            }, z.core.$strip>;
-            rawType: z.ZodString;
-        }, z.core.$strip>>;
-        parentRef: z.ZodOptional<z.ZodString>;
-        streamKey: z.ZodOptional<z.ZodString>;
-        text: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         channel: z.ZodEnum<{
             agentMessage: "agentMessage";
@@ -3659,7 +4713,7 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             parentRef: z.ZodOptional<z.ZodString>;
             providerItemId: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
-        kind: z.ZodLiteral<"item.textDelta">;
+        kind: z.ZodLiteral<"item.textClose">;
         noTurnFallback: z.ZodOptional<z.ZodObject<{
             raw: z.ZodObject<{
                 id: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
@@ -3670,7 +4724,7 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
             rawType: z.ZodString;
         }, z.core.$strip>>;
         providerTurnId: z.ZodOptional<z.ZodString>;
-        text: z.ZodString;
+        text: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>, z.ZodObject<{
         channel: z.ZodEnum<{
             command: "command";
@@ -3711,17 +4765,7 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
         }, z.core.$strip>>;
         text: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"usage.turn">;
-        modelContextWindow: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-        tokens: z.ZodObject<{
-            cachedInputTokens: z.ZodNumber;
-            inputTokens: z.ZodNumber;
-            outputTokens: z.ZodNumber;
-            reasoningOutputTokens: z.ZodNumber;
-            totalTokens: z.ZodNumber;
-        }, z.core.$strip>;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"usage.exact">;
+        kind: z.ZodLiteral<"usage">;
         last: z.ZodObject<{
             cachedInputTokens: z.ZodNumber;
             inputTokens: z.ZodNumber;
@@ -3745,6 +4789,7 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
         }>;
         estimated: z.ZodBoolean;
         kind: z.ZodLiteral<"contextWindow">;
+        providerTurnId: z.ZodOptional<z.ZodString>;
         size: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
         used: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>, z.ZodObject<{
@@ -3774,19 +4819,9 @@ declare const threadDeltaNotificationParamsSchema: z.ZodObject<{
         kind: z.ZodLiteral<"thread.name">;
         name: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"thread.goal">;
-        objective: z.ZodString;
-        status: z.ZodEnum<{
-            active: "active";
-            budgetLimited: "budgetLimited";
-            complete: "complete";
-            paused: "paused";
-        }>;
-        timeUsedSeconds: z.ZodNumber;
-        tokenBudget: z.ZodNullable<z.ZodNumber>;
-        tokensUsed: z.ZodNumber;
-    }, z.core.$strip>, z.ZodObject<{
-        kind: z.ZodLiteral<"thread.goalCleared">;
+        extensionKind: z.ZodString & z.ZodType<`${string}/${string}`, string, z.core.$ZodTypeInternals<`${string}/${string}`, string>>;
+        kind: z.ZodLiteral<"extension.state">;
+        payload: z.ZodType<JsonValue, unknown, z.core.$ZodTypeInternals<JsonValue, unknown>>;
     }, z.core.$strip>, z.ZodObject<{
         kind: z.ZodLiteral<"provider.rateLimits">;
         rateLimits: z.ZodObject<{
@@ -4038,5 +5073,5 @@ declare const hostDaemonAcpLaunchSpecSchema: z.ZodObject<{
 type HostDaemonAcpLaunchSpec = z.infer<typeof hostDaemonAcpLaunchSpecSchema>;
 declare function normalizeHostDaemonAcpLaunchSpec(spec: HostDaemonAcpLaunchSpec): HostDaemonAcpLaunchSpec;
 
-export { BRIDGE_INBOUND_REQUEST_METHODS, BRIDGE_JSON_RPC_ERRORS, BRIDGE_NOTIFICATION_METHODS, BRIDGE_REQUEST_METHODS, HIGH_REASONING_EFFORT, LOCAL_BASH_TASK_TYPE, LOCAL_WORKFLOW_TASK_TYPE, LOW_REASONING_EFFORT, MAX_REASONING_EFFORT, MEDIUM_REASONING_EFFORT, PROVIDER_BRIDGE_EXPORT_NAME, PROVIDER_BRIDGE_PROTOCOL_VERSION, ProviderRequestDecodeError, ProviderResponseEncodeError, THREAD_DELTA_NOTIFICATION_METHOD, ULTRACODE_REASONING_EFFORT, USER_QUESTION_MAX_OPTIONS, USER_QUESTION_MAX_QUESTIONS, XHIGH_REASONING_EFFORT, acpNativeReasoningSchema, acpPermissionCliSchema, acpReasoningCliSchema, backgroundTaskItemStatus, bashArgsSchema, bridgeRequestEnvelopeSchema, buildShellEnvOverrides, claudeTaskToolNameSchema, claudeTaskToolOutputSchema, createBridgeIo, createBridgeLineHandler, createPendingToolCallTracker, createProviderVisibilityMetadata, decodeBridgeJsonRpcResponse, decodeToolCallResponsePayload, deltaBackgroundTaskShapeSchema, deltaFileChangeSchema, deltaItemKeySchema, deltaItemShapeSchema, deltaMessageChannelSchema, deltaNoTurnFallbackSchema, deltaOutputChannelSchema, deltaTextChannelSchema, dynamicToolSchema, errorEnvelopeSchema, experimental_defineProviderBridge, extractResultText, getRawSdkMessage, getRecordProperty, getStringProperty, hostDaemonAcpLaunchSpecSchema, initializeParamsSchema, instructionModeValues, isApprovalPendingInteractionPayload, isApprovalPendingInteractionResolution, isBackgroundAgentTaskType, isRecord, isSettledBackgroundTaskStatus, isStandaloneBuiltinCompactCommand, isUserQuestionPendingInteractionPayload, isUserQuestionPendingInteractionResolution, jsonRpcEnvelopeSchema, jsonValueSchema, mimeTypeFromExtension, modelListParamsSchema, normalizeHostDaemonAcpLaunchSpec, normalizeProviderCommandOutput, pendingInteractionCommandActionSchema, pendingInteractionFileSystemPermissionsSchema, pendingInteractionMacOsPermissionsSchema, pendingInteractionNetworkPermissionsSchema, pendingInteractionRequestedPermissionProfileSchema, pendingInteractionResolutionSchema, permissionEscalationValues, providerRawEventSchema, reasoningEffortsForLevels, reasoningLevelSchema, reasoningLevelValues, removeCommandMentionsFromPromptInput, runBridgeRequest, runtimePermissionScopeValues, sanitizeInheritedChildProcessEnv, sdkMessageEnvelopeSchema, shouldAutoDenyInteractiveRequest, skillsConfigureParamsSchema, textBlockSchema, threadArchiveParamsSchema, threadContextWindowUsageEnvelopeSchema, threadDeltaNotificationParamsSchema, threadDeltaSchema, threadDiscardParamsSchema, threadForkParamsSchema, threadGoalClearParamsSchema, threadIdentityEnvelopeSchema, threadNameSetParamsSchema, threadResumeParamsSchema, threadStartParamsSchema, threadStopParamsSchema, threadUnarchiveParamsSchema, toNonNegativeNumber, toOptionalRecord, toOptionalString, toPositiveNumber, turnStartParamsSchema, turnSteerParamsSchema, withoutBridgeRuntimeEnv };
-export type { ApprovalPendingInteractionPayload, AvailableModel, BackgroundTaskStatus, BackgroundTaskUsage, BridgeExecutionOptions, BridgeJsonRpcResponse, BridgeToolCallRequest, BuildInteractiveResponseArgs, ClaudeTaskToolOutput, ClientTurnRequestId, DecodedInteractiveRequest, DeltaBackgroundTaskShape, DeltaFileChange, DeltaItemKey, DeltaItemShape, DeltaMessageChannel, DeltaNoTurnFallback, DeltaOutputChannel, DeltaTextChannel, DynamicTool, HostDaemonAcpLaunchSpec, InitializeResult, InstructionMode, JsonObject, JsonRpcMessage, JsonValue, ModelReasoningEffort, PendingInteractionApprovalDecision, PendingInteractionApprovalSubject, PendingInteractionCommandAction, PendingInteractionGrantablePermissionProfile, PendingInteractionGrantedPermissionProfile, PendingInteractionPayload, PendingInteractionRequestedPermissionProfile, PendingInteractionResolution, PendingInteractionUserQuestionQuestion, PermissionEscalation, PermissionMode, PreparedProviderCommandDispatch, PromptInput, ProviderBridgeContext, ProviderBridgeDefinition, ProviderBridgeEntry, ProviderErrorCategory, ProviderErrorInfo, ProviderInboundRequest, ProviderPostInitializeRequest, ProviderRateLimitState, ProviderRateLimitStatus, ProviderRateLimitWindow, ProviderRawEvent, ProviderRawEventCoverage, ProviderRawEventDescription, ProviderRuntimeEvent, ProviderVisibilityMetadata, ReasoningLevel, RuntimePermissionPolicy, RuntimePermissionScope, ServiceTier, ThreadDelta, ThreadDeltaKind, ThreadDeltaNotificationParams, ThreadEventContextWindowUsage, ThreadEventItemStatus, ThreadEventPlanStep, ThreadEventTokenUsageBreakdown, ThreadEventTurnStatus, ThreadEventUserContent, UserQuestionPendingInteractionPayload, UserQuestionPendingInteractionResolution, WorkflowAgentSnapshot, WorkflowAgentState, WorkflowPhaseSnapshot, WorkflowProgressSnapshot };
+export { BRIDGE_INBOUND_REQUEST_METHODS, BRIDGE_JSON_RPC_ERRORS, BRIDGE_NOTIFICATION_METHODS, BRIDGE_REQUEST_METHODS, HIGH_REASONING_EFFORT, LOCAL_BASH_TASK_TYPE, LOCAL_WORKFLOW_TASK_TYPE, LOW_REASONING_EFFORT, MAX_REASONING_EFFORT, MEDIUM_REASONING_EFFORT, PROVIDER_BRIDGE_EXPORT_NAME, PROVIDER_BRIDGE_PROTOCOL_VERSION, ProviderRequestDecodeError, ProviderResponseEncodeError, THREAD_DELTA_GRAMMAR_V2, THREAD_DELTA_GRAMMAR_V3, THREAD_DELTA_NOTIFICATION_METHOD, ULTRACODE_REASONING_EFFORT, USER_QUESTION_MAX_OPTIONS, USER_QUESTION_MAX_QUESTIONS, XHIGH_REASONING_EFFORT, ZERO_TOKEN_USAGE, acpNativeReasoningSchema, acpPermissionCliSchema, acpReasoningCliSchema, addTokenUsage, backgroundTaskItemStatus, bashArgsSchema, bridgeCapabilitiesSchema, bridgeGrammarVersionsSchema, bridgeRequestEnvelopeSchema, bridgeSteerModeSchema, buildShellEnvOverrides, claudeTaskToolNameSchema, claudeTaskToolOutputSchema, createBridgeIo, createBridgeLineHandler, createPendingToolCallTracker, createProviderVisibilityMetadata, decodeBridgeJsonRpcResponse, decodeToolCallResponsePayload, deltaBackgroundTaskShapeSchema, deltaDelegationShapeSchema, deltaExtensionShapeSchema, deltaFileChangeSchema, deltaFileReadShapeSchema, deltaItemKeySchema, deltaItemShapeSchema, deltaNoTurnFallbackSchema, deltaOutputChannelSchema, deltaPlanStepsShapeSchema, deltaPresentationSchema, deltaProgressSnapshotSchema, deltaSearchShapeSchema, deltaTextChannelSchema, dynamicToolSchema, errorEnvelopeSchema, buildBridgeToolCallContent as experimental_buildBridgeToolCallContent, experimental_defineProviderBridge, experimental_isProviderBridgeRecording, experimental_providerHealthResultSchema, experimental_providerHealthSchema, experimental_providerInstallationActionKindSchema, experimental_providerInstallationActionSchema, experimental_providerInstallationCommandSchema, experimental_providerInstallationRequirementSchema, experimental_providerInstallationRunParamsSchema, experimental_providerInstallationRunResultSchema, experimental_providerInstallationSourceSchema, experimental_providerInstallationStatusParamsSchema, experimental_providerInstallationStatusSchema, experimental_providerInstallationVerificationSchema, experimental_providerMaintenanceParamsSchema, experimental_providerUsageResultSchema, experimental_providerUsageSchema, experimental_providerUsageWindowSchema, experimental_recordProviderChildIo, extensionKindSchema, extractResultText, getRawSdkMessage, getRecordProperty, getStringProperty, hostDaemonAcpLaunchSpecSchema, initializeParamsSchema, instructionModeValues, interactionRequestPayloadSchema, isApprovalPendingInteractionPayload, isApprovalPendingInteractionResolution, isBackgroundAgentTaskType, isExtensionKind, isRecord, isSettledBackgroundTaskStatus, isStandaloneBuiltinCompactCommand, isUserQuestionPendingInteractionPayload, isUserQuestionPendingInteractionResolution, jsonRpcEnvelopeSchema, jsonValueSchema, mimeTypeFromExtension, modelListParamsSchema, normalizeHostDaemonAcpLaunchSpec, normalizeProviderCommandOutput, pendingInteractionCommandActionSchema, pendingInteractionFileSystemPermissionsSchema, pendingInteractionMacOsPermissionsSchema, pendingInteractionNetworkPermissionsSchema, pendingInteractionRequestedPermissionProfileSchema, pendingInteractionResolutionSchema, permissionEscalationValues, providerRawEventSchema, providerRecoveryKindSchema, providerRecoveryKindValues, providerRecoveryNotificationSchema, reasoningEffortsForLevels, reasoningLevelSchema, reasoningLevelValues, removeCommandMentionsFromPromptInput, runBridgeRequest, runtimePermissionScopeValues, sanitizeInheritedChildProcessEnv, sdkMessageEnvelopeSchema, shouldAutoDenyInteractiveRequest, skillsConfigureParamsSchema, textBlockSchema, threadArchiveParamsSchema, threadContextWindowUsageEnvelopeSchema, threadDeltaNotificationParamsSchema, threadDeltaSchema, threadDiscardParamsSchema, threadEventItemPresentationSchema, threadEventSearchModeSchema, threadForkParamsSchema, threadGoalClearParamsSchema, threadIdentityEnvelopeSchema, threadNameSetParamsSchema, threadResumeParamsSchema, threadStartParamsSchema, threadStopParamsSchema, threadUnarchiveParamsSchema, toNonNegativeNumber, toOptionalRecord, toOptionalString, toPositiveNumber, turnStartParamsSchema, turnSteerParamsSchema, withoutBridgeRuntimeEnv };
+export type { ApprovalPendingInteractionPayload, AvailableModel, BackgroundTaskStatus, BackgroundTaskUsage, BridgeCapabilities, BridgeExecutionOptions, BridgeGrammarVersions, BridgeJsonRpcResponse, BridgeSteerMode, BridgeToolCallRequest, BuildInteractiveResponseArgs, ClaudeTaskToolOutput, ClientTurnRequestId, DecodedInteractiveRequest, DeltaBackgroundTaskShape, DeltaDelegationShape, DeltaExtensionShape, DeltaFileChange, DeltaFileReadShape, DeltaItemKey, DeltaItemShape, DeltaItemShapeType, DeltaNoTurnFallback, DeltaOutputChannel, DeltaPlanStepsShape, DeltaPresentation, DeltaProgressSnapshot, DeltaSearchShape, DeltaTextChannel, DynamicTool, ExperimentalProviderHealth, ExperimentalProviderHealthResult, ExperimentalProviderInstallationAction, ExperimentalProviderInstallationActionKind, ExperimentalProviderInstallationCommand, ExperimentalProviderInstallationRequirement, ExperimentalProviderInstallationRunParams, ExperimentalProviderInstallationRunResult, ExperimentalProviderInstallationSource, ExperimentalProviderInstallationStatus, ExperimentalProviderInstallationStatusParams, ExperimentalProviderInstallationVerification, ExperimentalProviderMaintenanceParams, ExperimentalProviderUsage, ExperimentalProviderUsageResult, ExperimentalProviderUsageWindow, ExtensionKind, HostDaemonAcpLaunchSpec, InitializeResult, InstructionMode, InteractionRequestPayload, JsonObject, JsonRpcMessage, JsonValue, ModelReasoningEffort, PendingInteractionApprovalDecision, PendingInteractionApprovalSubject, PendingInteractionCommandAction, PendingInteractionGrantablePermissionProfile, PendingInteractionGrantedPermissionProfile, PendingInteractionPayload, PendingInteractionRequestedPermissionProfile, PendingInteractionResolution, PendingInteractionUserQuestionQuestion, PermissionEscalation, PermissionMode, PreparedProviderCommandDispatch, PromptInput, ProviderBridgeContext, ProviderBridgeDefinition, ProviderBridgeEntry, ProviderErrorCategory, ProviderErrorInfo, ProviderInboundRequest, ProviderPostInitializeRequest, ProviderRateLimitState, ProviderRateLimitStatus, ProviderRateLimitWindow, ProviderRawEvent, ProviderRawEventCoverage, ProviderRawEventDescription, ProviderRecoveryKind, ProviderRecoveryNotification, ProviderRuntimeEvent, ProviderVisibilityMetadata, ReasoningLevel, RuntimePermissionPolicy, RuntimePermissionScope, ServiceTier, ThreadDelta, ThreadDeltaKind, ThreadDeltaNotificationParams, ThreadEventContextWindowUsage, ThreadEventItemPresentation, ThreadEventItemStatus, ThreadEventPlanStep, ThreadEventSearchMode, ThreadEventTokenUsageBreakdown, ThreadEventTurnStatus, ThreadEventUserContent, UserQuestionPendingInteractionPayload, UserQuestionPendingInteractionResolution, WorkflowAgentSnapshot, WorkflowAgentState, WorkflowPhaseSnapshot, WorkflowProgressSnapshot };