@vellumai/plugin-api 0.10.12-dev.202607271108.d02cf25 → 0.10.12-dev.202607271505.0de19b2

package/index.d.ts

@@ -532,6 +532,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 gemini: "gemini";
                 fireworks: "fireworks";
                 together: "together";
+                poolside: "poolside";
                 openrouter: "openrouter";
                 "vercel-ai-gateway": "vercel-ai-gateway";
                 ollama: "ollama";
@@ -670,6 +671,7 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 gemini: "gemini";
                 fireworks: "fireworks";
                 together: "together";
+                poolside: "poolside";
                 openrouter: "openrouter";
                 "vercel-ai-gateway": "vercel-ai-gateway";
                 ollama: "ollama";
@@ -1129,11 +1131,17 @@ declare const AssistantConfigSchema: z.ZodObject<{
     maxStepsPerSession: z.ZodDefault<z.ZodNumber>;
 }, z.core.$strip>;
 
+/**
+ * Inferred TypeScript union for every event currently covered by
+ * `AssistantEventSchema`. Consumers should reference this single type
+ * rather than re-listing the individual member types — as each new
+ * event migrates into the schema, it appears here automatically.
+ */
+export declare type AssistantEvent = z.infer<typeof AssistantEventSchema>;
+
 export declare type AssistantEventCallback = (event: AssistantEventEnvelope) => void | Promise<void>;
 
-declare type AssistantEventEnvelope = z.infer<typeof AssistantEventEnvelopeSchema>;
-export { AssistantEventEnvelope as AssistantEvent }
-export { AssistantEventEnvelope }
+export declare type AssistantEventEnvelope = z.infer<typeof AssistantEventEnvelopeSchema>;
 
 /**
  * SSE wire envelope wrapping every outbound event from the daemon.
@@ -2401,19 +2409,7 @@ export declare class AssistantEventHub {
      * Fanout is isolated: a throwing or rejecting subscriber does not abort
      * delivery to remaining subscribers.
      */
-    publish(event: AssistantEventEnvelope, options?: {
-        targetCapability?: HostProxyCapability;
-        targetClientId?: string;
-        targetInterfaceId?: InterfaceId;
-        /**
-         * Skip the subscriber with this `clientId`. Used for self-echo
-         * suppression on `sync_changed`: the route handler echoes the
-         * originating tab's `X-Vellum-Client-Id` back on the event, and the
-         * hub uses it here to avoid re-delivering the invalidation to the
-         * tab that already mutated its own optimistic state.
-         */
-        excludeClientId?: string;
-    }): Promise<void>;
+    publish(event: AssistantEventEnvelope, options?: AssistantEventPublishOptions): Promise<void>;
     /**
      * Return the active client subscriber with the given clientId, or
      * `undefined` if no such subscriber exists.
@@ -2474,6 +2470,1238 @@ export declare class AssistantEventHub {
 /** The plugin-facing event hub. See module docs. */
 export declare const assistantEventHub: PluginEventHub;
 
+/** Targeting/suppression options for {@link AssistantEventHub.publish}. */
+export declare type AssistantEventPublishOptions = z.infer<typeof AssistantEventPublishOptionsSchema>;
+
+declare const AssistantEventPublishOptionsSchema: z.ZodObject<{
+    targetCapability: z.ZodOptional<z.ZodEnum<{
+        host_bash: "host_bash";
+        host_file: "host_file";
+        host_cu: "host_cu";
+        host_browser: "host_browser";
+        host_app_control: "host_app_control";
+        host_ui_snapshot: "host_ui_snapshot";
+    }>>;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    targetInterfaceId: z.ZodOptional<z.ZodEnum<{
+        telegram: "telegram";
+        phone: "phone";
+        whatsapp: "whatsapp";
+        slack: "slack";
+        email: "email";
+        a2a: "a2a";
+        macos: "macos";
+        ios: "ios";
+        cli: "cli";
+        web: "web";
+        "chrome-extension": "chrome-extension";
+        route: "route";
+    }>>;
+    excludeClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+
+/**
+ * Canonical SSE event schema for the assistant runtime.
+ *
+ * Discriminated union over the `type` field. Each member is the
+ * canonical wire-contract schema for a single event type, defined
+ * alongside the daemon code that emits it. Consumers (web client,
+ * gateway, evals) parse incoming events with this single schema
+ * rather than maintaining their own dispatch table.
+ *
+ * Add new events by exporting their schema from `./events/` and
+ * appending them to the union below. See `./README.md` for the full
+ * migration recipe.
+ */
+declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"acp_session_completed">;
+    acpSessionId: z.ZodString;
+    stopReason: z.ZodEnum<{
+        cancelled: "cancelled";
+        end_turn: "end_turn";
+        max_tokens: "max_tokens";
+        max_turn_requests: "max_turn_requests";
+        refusal: "refusal";
+    }>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"acp_session_error">;
+    acpSessionId: z.ZodString;
+    error: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"acp_session_spawned">;
+    acpSessionId: z.ZodString;
+    agent: z.ZodString;
+    parentConversationId: z.ZodString;
+    parentToolUseId: z.ZodOptional<z.ZodString>;
+    task: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"acp_session_update">;
+    acpSessionId: z.ZodString;
+    updateType: z.ZodEnum<{
+        agent_message_chunk: "agent_message_chunk";
+        agent_thought_chunk: "agent_thought_chunk";
+        user_message_chunk: "user_message_chunk";
+        tool_call: "tool_call";
+        tool_call_update: "tool_call_update";
+        plan: "plan";
+    }>;
+    content: z.ZodOptional<z.ZodString>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    toolTitle: z.ZodOptional<z.ZodString>;
+    toolKind: z.ZodOptional<z.ZodString>;
+    toolStatus: z.ZodOptional<z.ZodString>;
+    rawInput: z.ZodOptional<z.ZodUnknown>;
+    rawOutput: z.ZodOptional<z.ZodUnknown>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    messageId: z.ZodOptional<z.ZodString>;
+    seq: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"acp_session_usage">;
+    acpSessionId: z.ZodString;
+    usedTokens: z.ZodNumber;
+    contextSize: z.ZodNumber;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    costAmount: z.ZodOptional<z.ZodNumber>;
+    costCurrency: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"app_files_changed">;
+    appId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant_activity_state">;
+    conversationId: z.ZodString;
+    activityVersion: z.ZodNumber;
+    phase: z.ZodEnum<{
+        thinking: "thinking";
+        idle: "idle";
+        streaming: "streaming";
+        tool_running: "tool_running";
+        awaiting_confirmation: "awaiting_confirmation";
+    }>;
+    anchor: z.ZodEnum<{
+        assistant_turn: "assistant_turn";
+        user_turn: "user_turn";
+        global: "global";
+    }>;
+    reason: z.ZodEnum<{
+        thinking_delta: "thinking_delta";
+        message_dequeued: "message_dequeued";
+        first_text_delta: "first_text_delta";
+        tool_use_start: "tool_use_start";
+        preview_start: "preview_start";
+        tool_result_received: "tool_result_received";
+        confirmation_requested: "confirmation_requested";
+        confirmation_resolved: "confirmation_resolved";
+        context_compacting: "context_compacting";
+        message_complete: "message_complete";
+        generation_cancelled: "generation_cancelled";
+        error_terminal: "error_terminal";
+    }>;
+    requestId: z.ZodOptional<z.ZodString>;
+    statusText: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant_status">;
+    version: z.ZodOptional<z.ZodString>;
+    keyFingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant_text_delta">;
+    text: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant_thinking_delta">;
+    thinking: z.ZodString;
+    messageId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    timestampMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"assistant_turn_start">;
+    messageId: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"avatar_updated">;
+    avatarPath: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"background_tool_completed">;
+    id: z.ZodString;
+    conversationId: z.ZodString;
+    status: z.ZodEnum<{
+        cancelled: "cancelled";
+        completed: "completed";
+        failed: "failed";
+    }>;
+    exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    output: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"background_tool_started">;
+    id: z.ZodString;
+    toolName: z.ZodString;
+    conversationId: z.ZodString;
+    command: z.ZodString;
+    startedAt: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"bookmark.created">;
+    bookmark: z.ZodObject<{
+        id: z.ZodString;
+        messageId: z.ZodString;
+        conversationId: z.ZodString;
+        conversationTitle: z.ZodNullable<z.ZodString>;
+        messagePreview: z.ZodString;
+        messageRole: z.ZodString;
+        messageCreatedAt: z.ZodNumber;
+        createdAt: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"bookmark.deleted">;
+    messageId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"client_settings_update">;
+    key: z.ZodString;
+    value: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"compaction_circuit_closed">;
+    conversationId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"compaction_circuit_open">;
+    conversationId: z.ZodString;
+    reason: z.ZodLiteral<"3_consecutive_failures">;
+    openUntil: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"config_changed">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"confirmation_request">;
+    requestId: z.ZodString;
+    toolName: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    riskLevel: z.ZodString;
+    riskReason: z.ZodOptional<z.ZodString>;
+    isContainerized: z.ZodOptional<z.ZodBoolean>;
+    executionTarget: z.ZodOptional<z.ZodEnum<{
+        sandbox: "sandbox";
+        host: "host";
+    }>>;
+    allowlistOptions: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodString;
+        pattern: z.ZodString;
+    }, z.core.$strip>>;
+    scopeOptions: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        scope: z.ZodString;
+    }, z.core.$strip>>;
+    directoryScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        scope: z.ZodString;
+    }, z.core.$strip>>>;
+    diff: z.ZodOptional<z.ZodObject<{
+        filePath: z.ZodString;
+        oldContent: z.ZodString;
+        newContent: z.ZodString;
+        isNewFile: z.ZodBoolean;
+    }, z.core.$strip>>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    persistentDecisionsAllowed: z.ZodOptional<z.ZodBoolean>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    acpToolKind: z.ZodOptional<z.ZodString>;
+    acpOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        optionId: z.ZodString;
+        name: z.ZodString;
+        kind: z.ZodEnum<{
+            allow_once: "allow_once";
+            allow_always: "allow_always";
+            reject_once: "reject_once";
+            reject_always: "reject_always";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"confirmation_state_changed">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+    state: z.ZodEnum<{
+        timed_out: "timed_out";
+        pending: "pending";
+        approved: "approved";
+        denied: "denied";
+        resolved_stale: "resolved_stale";
+    }>;
+    source: z.ZodEnum<{
+        button: "button";
+        inline_nl: "inline_nl";
+        auto_deny: "auto_deny";
+        timeout: "timeout";
+        system: "system";
+    }>;
+    causedByRequestId: z.ZodOptional<z.ZodString>;
+    decisionText: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"contact_request">;
+    requestId: z.ZodString;
+    channel: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"contacts_changed">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"context_compacted">;
+    conversationId: z.ZodString;
+    previousEstimatedInputTokens: z.ZodNumber;
+    estimatedInputTokens: z.ZodNumber;
+    maxInputTokens: z.ZodNumber;
+    thresholdTokens: z.ZodNumber;
+    compactedMessages: z.ZodNumber;
+    summaryCalls: z.ZodNumber;
+    summaryInputTokens: z.ZodNumber;
+    summaryOutputTokens: z.ZodNumber;
+    summaryModel: z.ZodString;
+    summaryCharCount: z.ZodOptional<z.ZodNumber>;
+    summaryHeaderCount: z.ZodOptional<z.ZodNumber>;
+    summaryHadMemoryEcho: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation_error">;
+    conversationId: z.ZodString;
+    code: z.ZodEnum<{
+        PROVIDER_NETWORK: "PROVIDER_NETWORK";
+        PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
+        MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
+        PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
+        PROVIDER_API: "PROVIDER_API";
+        IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
+        PROVIDER_BILLING: "PROVIDER_BILLING";
+        PROVIDER_ORDERING: "PROVIDER_ORDERING";
+        PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
+        PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+        PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
+        MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
+        CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
+        BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
+        MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
+        CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
+        CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
+        DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    userMessage: z.ZodString;
+    retryable: z.ZodBoolean;
+    debugDetails: z.ZodOptional<z.ZodString>;
+    errorCategory: z.ZodOptional<z.ZodString>;
+    connectionName: z.ZodOptional<z.ZodString>;
+    profileName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation_inference_profile_updated">;
+    conversationId: z.ZodString;
+    profile: z.ZodNullable<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation_list_invalidated">;
+    reason: z.ZodEnum<{
+        created: "created";
+        renamed: "renamed";
+        deleted: "deleted";
+        reordered: "reordered";
+        seen_changed: "seen_changed";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation_notice">;
+    conversationId: z.ZodString;
+    source: z.ZodEnum<{
+        memory_v3: "memory_v3";
+    }>;
+    code: z.ZodEnum<{
+        PROVIDER_NETWORK: "PROVIDER_NETWORK";
+        PROVIDER_RATE_LIMIT: "PROVIDER_RATE_LIMIT";
+        MANAGED_USAGE_LIMIT: "MANAGED_USAGE_LIMIT";
+        PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED";
+        PROVIDER_API: "PROVIDER_API";
+        IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
+        PROVIDER_BILLING: "PROVIDER_BILLING";
+        PROVIDER_ORDERING: "PROVIDER_ORDERING";
+        PROVIDER_WEB_SEARCH: "PROVIDER_WEB_SEARCH";
+        PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED";
+        PROVIDER_INVALID_KEY: "PROVIDER_INVALID_KEY";
+        MANAGED_KEY_INVALID: "MANAGED_KEY_INVALID";
+        CONTEXT_TOO_LARGE: "CONTEXT_TOO_LARGE";
+        BUDGET_YIELD_UNRECOVERED: "BUDGET_YIELD_UNRECOVERED";
+        MAX_TOKENS_REACHED: "MAX_TOKENS_REACHED";
+        CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
+        CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
+        DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
+        UNKNOWN: "UNKNOWN";
+    }>;
+    userMessage: z.ZodString;
+    errorCategory: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"conversation_title_updated">;
+    conversationId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"disk_pressure_status_changed">;
+    status: z.ZodObject<{
+        enabled: z.ZodBoolean;
+        state: z.ZodEnum<{
+            unknown: "unknown";
+            disabled: "disabled";
+            critical: "critical";
+            ok: "ok";
+            warning: "warning";
+        }>;
+        locked: z.ZodBoolean;
+        acknowledged: z.ZodBoolean;
+        overrideActive: z.ZodBoolean;
+        effectivelyLocked: z.ZodBoolean;
+        lockId: z.ZodNullable<z.ZodString>;
+        usagePercent: z.ZodNullable<z.ZodNumber>;
+        thresholdPercent: z.ZodNumber;
+        path: z.ZodNullable<z.ZodString>;
+        lastCheckedAt: z.ZodNullable<z.ZodString>;
+        blockedCapabilities: z.ZodArray<z.ZodEnum<{
+            "agent-turns": "agent-turns";
+            "background-work": "background-work";
+            "remote-ingress": "remote-ingress";
+        }>>;
+        error: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document_comment_created">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    comment: z.ZodObject<{
+        id: z.ZodString;
+        surfaceId: z.ZodString;
+        author: z.ZodString;
+        content: z.ZodString;
+        anchorStart: z.ZodOptional<z.ZodNumber>;
+        anchorEnd: z.ZodOptional<z.ZodNumber>;
+        anchorText: z.ZodOptional<z.ZodString>;
+        parentCommentId: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        createdAt: z.ZodNumber;
+        updatedAt: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document_comment_deleted">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    commentId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document_comment_reopened">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    commentId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document_comment_resolved">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    commentId: z.ZodString;
+    resolvedBy: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document_editor_show">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    title: z.ZodString;
+    initialContent: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"document_editor_update">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    markdown: z.ZodString;
+    mode: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodString>;
+    errorCategory: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"generation_cancelled">;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"generation_handoff">;
+    conversationId: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodOptional<z.ZodString>;
+    queuedCount: z.ZodNumber;
+    messageId: z.ZodOptional<z.ZodString>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        filename: z.ZodString;
+        mimeType: z.ZodString;
+        data: z.ZodString;
+        sourceType: z.ZodOptional<z.ZodEnum<{
+            host_file: "host_file";
+            sandbox_file: "sandbox_file";
+            tool_block: "tool_block";
+        }>>;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+        thumbnailData: z.ZodOptional<z.ZodString>;
+        fileBacked: z.ZodOptional<z.ZodBoolean>;
+        filePath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat_alert">;
+    title: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"heartbeat_conversation_created">;
+    conversationId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"home_feed_updated">;
+    updatedAt: z.ZodString;
+    newItemCount: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"hook_event">;
+    conversationId: z.ZodOptional<z.ZodString>;
+    hookName: z.ZodString;
+    owner: z.ZodObject<{
+        kind: z.ZodEnum<{
+            plugin: "plugin";
+            workspace: "workspace";
+        }>;
+        id: z.ZodString;
+    }, z.core.$strip>;
+    detail: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_app_control_cancel">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_app_control_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    toolName: z.ZodString;
+    input: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        tool: z.ZodLiteral<"start">;
+        app: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"observe">;
+        app: z.ZodString;
+        settle_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"press">;
+        app: z.ZodString;
+        key: z.ZodString;
+        modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        duration_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"combo">;
+        app: z.ZodString;
+        keys: z.ZodArray<z.ZodString>;
+        duration_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"sequence">;
+        app: z.ZodString;
+        steps: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            modifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            duration_ms: z.ZodOptional<z.ZodNumber>;
+            gap_ms: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"type">;
+        app: z.ZodString;
+        text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"click">;
+        app: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            middle: "middle";
+        }>>;
+        double: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"drag">;
+        app: z.ZodString;
+        from_x: z.ZodNumber;
+        from_y: z.ZodNumber;
+        to_x: z.ZodNumber;
+        to_y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            right: "right";
+            middle: "middle";
+        }>>;
+    }, z.core.$strip>, z.ZodObject<{
+        tool: z.ZodLiteral<"stop">;
+        app: z.ZodOptional<z.ZodString>;
+        reason: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>], "tool">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_bash_cancel">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_bash_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    command: z.ZodString;
+    working_dir: z.ZodOptional<z.ZodString>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    targetClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_browser_cancel">;
+    requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_browser_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    cdpMethod: z.ZodString;
+    cdpParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    cdpSessionId: z.ZodOptional<z.ZodString>;
+    timeout_seconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_cu_cancel">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_cu_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    stepNumber: z.ZodNumber;
+    reasoning: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_file_cancel">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"host_file_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    operation: z.ZodLiteral<"read">;
+    path: z.ZodString;
+    offset: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_file_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    operation: z.ZodLiteral<"write">;
+    path: z.ZodString;
+    content: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_file_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    operation: z.ZodLiteral<"edit">;
+    path: z.ZodString;
+    old_string: z.ZodString;
+    new_string: z.ZodString;
+    replace_all: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>], "operation">, z.ZodObject<{
+    type: z.ZodLiteral<"host_transfer_cancel">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"host_transfer_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    direction: z.ZodLiteral<"to_host">;
+    transferId: z.ZodString;
+    destPath: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    sha256: z.ZodString;
+    overwrite: z.ZodBoolean;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_transfer_request">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    targetClientId: z.ZodOptional<z.ZodString>;
+    direction: z.ZodLiteral<"to_sandbox">;
+    transferId: z.ZodString;
+    sourcePath: z.ZodString;
+}, z.core.$strip>], "direction">, z.ZodObject<{
+    type: z.ZodLiteral<"host_ui_snapshot_cancel">;
+    requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"host_ui_snapshot_request">;
+    requestId: z.ZodString;
+    view: z.ZodEnum<{
+        sampler: "sampler";
+        chat: "chat";
+    }>;
+    tokens: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"identity_changed">;
+    name: z.ZodString;
+    role: z.ZodString;
+    personality: z.ZodString;
+    emoji: z.ZodString;
+    home: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"interaction_resolved">;
+    requestId: z.ZodString;
+    conversationId: z.ZodString;
+    state: z.ZodEnum<{
+        cancelled: "cancelled";
+        superseded: "superseded";
+        approved: "approved";
+        rejected: "rejected";
+        answered: "answered";
+    }>;
+    kind: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"memory_recalled">;
+    provider: z.ZodString;
+    model: z.ZodString;
+    degradation: z.ZodOptional<z.ZodObject<{
+        semanticUnavailable: z.ZodBoolean;
+        reason: z.ZodString;
+        fallbackSources: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    semanticHits: z.ZodNumber;
+    tier1Count: z.ZodNumber;
+    tier2Count: z.ZodNumber;
+    hybridSearchLatencyMs: z.ZodNumber;
+    sparseVectorUsed: z.ZodBoolean;
+    mergedCount: z.ZodNumber;
+    selectedCount: z.ZodNumber;
+    injectedTokens: z.ZodNumber;
+    latencyMs: z.ZodNumber;
+    topCandidates: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        type: z.ZodString;
+        kind: z.ZodString;
+        finalScore: z.ZodNumber;
+        semantic: z.ZodNumber;
+        recency: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"memory_status">;
+    enabled: z.ZodBoolean;
+    degraded: z.ZodBoolean;
+    degradation: z.ZodOptional<z.ZodObject<{
+        semanticUnavailable: z.ZodBoolean;
+        reason: z.ZodString;
+        fallbackSources: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    reason: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message_complete">;
+    messageId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<{
+        main: "main";
+        aux: "aux";
+    }>>;
+    attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        filename: z.ZodString;
+        mimeType: z.ZodString;
+        data: z.ZodString;
+        sourceType: z.ZodOptional<z.ZodEnum<{
+            host_file: "host_file";
+            sandbox_file: "sandbox_file";
+            tool_block: "tool_block";
+        }>>;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+        thumbnailData: z.ZodOptional<z.ZodString>;
+        fileBacked: z.ZodOptional<z.ZodBoolean>;
+        filePath: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    attachmentWarnings: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message_dequeued">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message_queued">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+    position: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message_queued_deleted">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message_request_complete">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+    runStillActive: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"message_steered">;
+    conversationId: z.ZodString;
+    requestId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"model_info">;
+    conversationId: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+    provider: z.ZodString;
+    configuredProviders: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    availableModels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+    }, z.core.$strip>>>;
+    allProviders: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        displayName: z.ZodString;
+        models: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            displayName: z.ZodString;
+        }, z.core.$strip>>;
+        defaultModel: z.ZodString;
+        apiKeyUrl: z.ZodOptional<z.ZodString>;
+        apiKeyPlaceholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"navigate_settings">;
+    tab: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"notification_conversation_created">;
+    conversationId: z.ZodString;
+    title: z.ZodString;
+    sourceEventName: z.ZodString;
+    targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
+    groupId: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+    silent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"notification_intent">;
+    sourceEventName: z.ZodString;
+    title: z.ZodString;
+    body: z.ZodString;
+    deliveryId: z.ZodOptional<z.ZodString>;
+    deepLinkMetadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    targetGuardianPrincipalId: z.ZodOptional<z.ZodString>;
+    silent: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"oauth_connect_result">;
+    success: z.ZodBoolean;
+    service: z.ZodOptional<z.ZodString>;
+    grantedScopes: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    accountInfo: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"open_conversation">;
+    conversationId: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    anchorMessageId: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"open_panel">;
+    panelType: z.ZodString;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    surfaceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"open_url">;
+    url: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"platform_disconnected">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"question_request">;
+    requestId: z.ZodString;
+    questions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        options: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        freeTextPlaceholder: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    question: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    options: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    freeTextPlaceholder: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"recording_pause">;
+    recordingId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"recording_resume">;
+    recordingId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"recording_start">;
+    recordingId: z.ZodString;
+    attachToConversationId: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodObject<{
+        captureScope: z.ZodOptional<z.ZodEnum<{
+            display: "display";
+            window: "window";
+        }>>;
+        displayId: z.ZodOptional<z.ZodString>;
+        windowId: z.ZodOptional<z.ZodNumber>;
+        includeAudio: z.ZodOptional<z.ZodBoolean>;
+        includeMicrophone: z.ZodOptional<z.ZodBoolean>;
+        promptForSource: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    operationToken: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"recording_stop">;
+    recordingId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"relationship_state_updated">;
+    updatedAt: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"schedule_conversation_created">;
+    conversationId: z.ZodString;
+    scheduleJobId: z.ZodString;
+    title: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"secret_request">;
+    requestId: z.ZodString;
+    service: z.ZodString;
+    field: z.ZodString;
+    label: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    purpose: z.ZodOptional<z.ZodString>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowedDomains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowOneTimeSend: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"service_group_update_complete">;
+    installedVersion: z.ZodString;
+    success: z.ZodBoolean;
+    rolledBackToVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"service_group_update_progress">;
+    statusMessage: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"service_group_update_starting">;
+    targetVersion: z.ZodString;
+    expectedDowntimeSeconds: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"show_platform_login">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"skills_state_changed">;
+    name: z.ZodString;
+    state: z.ZodEnum<{
+        enabled: "enabled";
+        disabled: "disabled";
+        installed: "installed";
+        uninstalled: "uninstalled";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"sounds_config_updated">;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_event">;
+    conversationId: z.ZodString;
+    subagentId: z.ZodString;
+    event: z.ZodObject<{
+        type: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodString>;
+        input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        toolName: z.ZodOptional<z.ZodString>;
+        isError: z.ZodOptional<z.ZodBoolean>;
+        toolUseId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_spawned">;
+    subagentId: z.ZodString;
+    parentConversationId: z.ZodString;
+    label: z.ZodString;
+    objective: z.ZodString;
+    isFork: z.ZodOptional<z.ZodBoolean>;
+    parentToolUseId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"subagent_status_changed">;
+    subagentId: z.ZodString;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        pending: "pending";
+        running: "running";
+        awaiting_input: "awaiting_input";
+        aborted: "aborted";
+        interrupted: "interrupted";
+    }>;
+    error: z.ZodOptional<z.ZodString>;
+    usage: z.ZodOptional<z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        estimatedCost: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"sync_changed">;
+    tags: z.ZodArray<z.ZodString>;
+    originClientId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_input_delta">;
+    toolName: z.ZodString;
+    content: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_output_chunk">;
+    chunk: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    subType: z.ZodOptional<z.ZodEnum<{
+        status: "status";
+        tool_start: "tool_start";
+        tool_complete: "tool_complete";
+    }>>;
+    subToolName: z.ZodOptional<z.ZodString>;
+    subToolInput: z.ZodOptional<z.ZodString>;
+    subToolIsError: z.ZodOptional<z.ZodBoolean>;
+    subToolId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_result">;
+    toolName: z.ZodString;
+    result: z.ZodString;
+    isError: z.ZodOptional<z.ZodBoolean>;
+    diff: z.ZodOptional<z.ZodObject<{
+        filePath: z.ZodString;
+        oldContent: z.ZodString;
+        newContent: z.ZodString;
+        isNewFile: z.ZodBoolean;
+    }, z.core.$strip>>;
+    status: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    imageData: z.ZodOptional<z.ZodString>;
+    imageDataList: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    riskLevel: z.ZodOptional<z.ZodString>;
+    riskReason: z.ZodOptional<z.ZodString>;
+    matchedTrustRuleId: z.ZodOptional<z.ZodString>;
+    isContainerized: z.ZodOptional<z.ZodBoolean>;
+    riskScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pattern: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>>;
+    riskAllowlistOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodString;
+        pattern: z.ZodString;
+    }, z.core.$strip>>>;
+    riskDirectoryScopeOptions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        scope: z.ZodString;
+    }, z.core.$strip>>>;
+    approvalMode: z.ZodOptional<z.ZodString>;
+    approvalReason: z.ZodOptional<z.ZodString>;
+    riskThreshold: z.ZodOptional<z.ZodString>;
+    activityMetadata: z.ZodOptional<z.ZodObject<{
+        webSearch: z.ZodOptional<z.ZodObject<{
+            query: z.ZodString;
+            provider: z.ZodEnum<{
+                "anthropic-native": "anthropic-native";
+                brave: "brave";
+                perplexity: "perplexity";
+                tavily: "tavily";
+                firecrawl: "firecrawl";
+            }>;
+            resultCount: z.ZodNumber;
+            durationMs: z.ZodNumber;
+            results: z.ZodArray<z.ZodObject<{
+                rank: z.ZodNumber;
+                title: z.ZodString;
+                url: z.ZodString;
+                domain: z.ZodString;
+                faviconUrl: z.ZodOptional<z.ZodString>;
+                snippet: z.ZodOptional<z.ZodString>;
+                age: z.ZodOptional<z.ZodString>;
+                score: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            errorMessage: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        webFetch: z.ZodOptional<z.ZodObject<{
+            url: z.ZodString;
+            finalUrl: z.ZodString;
+            provider: z.ZodOptional<z.ZodEnum<{
+                default: "default";
+                firecrawl: "firecrawl";
+            }>>;
+            status: z.ZodNumber;
+            contentType: z.ZodOptional<z.ZodString>;
+            byteCount: z.ZodNumber;
+            charCount: z.ZodNumber;
+            truncated: z.ZodBoolean;
+            title: z.ZodOptional<z.ZodString>;
+            domain: z.ZodString;
+            faviconUrl: z.ZodOptional<z.ZodString>;
+            redirectCount: z.ZodNumber;
+            durationMs: z.ZodNumber;
+            errorMessage: z.ZodOptional<z.ZodString>;
+            mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    errorCode: z.ZodOptional<z.ZodString>;
+    completedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_use_preview_start">;
+    toolUseId: z.ZodString;
+    toolName: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    previewStartedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_use_start">;
+    toolName: z.ZodString;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    previewStartedAt: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_complete">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    summary: z.ZodString;
+    submittedData: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_dismiss">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_show">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    surfaceType: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        style: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+            destructive: "destructive";
+        }>>;
+        data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    display: z.ZodOptional<z.ZodEnum<{
+        inline: "inline";
+        panel: "panel";
+    }>>;
+    messageId: z.ZodOptional<z.ZodString>;
+    persistent: z.ZodOptional<z.ZodBoolean>;
+    toolCallId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_undo_result">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    success: z.ZodBoolean;
+    remainingUndos: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"ui_surface_update">;
+    conversationId: z.ZodString;
+    surfaceId: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"usage_progress">;
+    conversationId: z.ZodString;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    estimatedCost: z.ZodNumber;
+    model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"usage_update">;
+    conversationId: z.ZodString;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNumber>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNumber>;
+    totalInputTokens: z.ZodNumber;
+    totalOutputTokens: z.ZodNumber;
+    estimatedCost: z.ZodNumber;
+    model: z.ZodString;
+    contextWindowTokens: z.ZodOptional<z.ZodNumber>;
+    contextWindowMaxTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"user_message_echo">;
+    text: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    messageId: z.ZodOptional<z.ZodString>;
+    requestId: z.ZodOptional<z.ZodString>;
+    clientMessageId: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"workflow_completed">;
+    runId: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+        running: "running";
+        aborted: "aborted";
+        interrupted: "interrupted";
+        cap_exceeded: "cap_exceeded";
+    }>;
+    agentsSpawned: z.ZodNumber;
+    inputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"workflow_leaf_finished">;
+    runId: z.ZodString;
+    conversationId: z.ZodString;
+    seq: z.ZodNumber;
+    status: z.ZodEnum<{
+        completed: "completed";
+        failed: "failed";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+    outputTokens: z.ZodOptional<z.ZodNumber>;
+    resultSummary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"workflow_leaf_started">;
+    runId: z.ZodString;
+    conversationId: z.ZodString;
+    seq: z.ZodNumber;
+    label: z.ZodOptional<z.ZodString>;
+    phase: z.ZodOptional<z.ZodString>;
+    promptSummary: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"workflow_progress">;
+    runId: z.ZodString;
+    conversationId: z.ZodOptional<z.ZodString>;
+    agentsSpawned: z.ZodNumber;
+    phase: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"workflow_started">;
+    runId: z.ZodString;
+    conversationId: z.ZodString;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>], "type">;
+
 /** Opaque handle returned by `subscribe`. Call `dispose()` to remove the subscription. */
 export declare interface AssistantEventSubscription {
     dispose(): void;
@@ -4116,10 +5344,7 @@ declare type ProxyToolResolver = (toolName: string, input: Record<string, unknow
  * delivery to the rest). Rejects if the event is non-serializable or is a
  * host-proxy control event, which plugins may not publish.
  */
-export declare function publishEvent(event: AssistantEventEnvelope, options?: PublishEventOptions): Promise<void>;
-
-/** Publish options, mirroring the hub's `publish` options (targeting, self-echo suppression). */
-export declare type PublishEventOptions = NonNullable<Parameters<PluginEventHub["publish"]>[1]>;
+export declare function publishEvent(event: AssistantEventEnvelope, options?: AssistantEventPublishOptions): Promise<void>;
 
 /**
  * Remove every previously-refused exchange from a working history: for each

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.12-dev.202607271108.d02cf25",
+  "version": "0.10.12-dev.202607271505.0de19b2",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",