@vellumai/plugin-api 0.10.4-staging.2 → 0.10.5-dev.202607022248.91fa053

package/index.d.ts

@@ -252,47 +252,7 @@ declare interface AssistantAttention {
 }
 
 /** Daemon-side specialization of the generic event envelope. */
-export declare type AssistantEvent = AssistantEvent_2<ServerMessage>;
-
-/**
- * Assistant Events -- shared types and SSE framing helpers.
- *
- * This module is intentionally free of imports from `assistant/` or any
- * other repo-local module so it can be consumed by both the daemon and
- * isolated skill processes without circular references.
- *
- * The `AssistantEvent` interface is generic over the `message` payload so
- * the neutral package does not need to know about the daemon-side
- * `ServerMessage` discriminated union. Consumers that want narrower
- * typing can re-export a specialized alias, e.g.:
- *
- *   type AssistantEvent = BaseAssistantEvent<ServerMessage>;
- */
-/**
- * A single assistant event wrapping an outbound message payload.
- *
- * Generic over the payload type so the neutral package has zero dependency
- * on daemon-side message schemas. The `TMessage` default of `unknown`
- * keeps the package importable without a type argument when the caller
- * does not care about message narrowing.
- */
-declare interface AssistantEvent_2<TMessage = unknown> {
-    /** Globally unique event identifier (UUID). */
-    id: string;
-    /** Resolved conversation id when available. */
-    conversationId?: string;
-    /**
-     * Monotonic per-conversation sequence number. Assigned by the daemon at
-     * publish time for conversation-scoped events; absent for unscoped
-     * broadcasts. Clients track the highest observed `seq` per conversation
-     * and pass it back on reconnect to request replay of missed events.
-     */
-    seq?: number;
-    /** ISO-8601 timestamp of when the event was emitted. */
-    emittedAt: string;
-    /** Outbound message payload. */
-    message: TMessage;
-}
+export declare type AssistantEvent = BaseAssistantEvent<ServerMessage>;
 
 export declare type AssistantEventCallback = (event: AssistantEvent) => void | Promise<void>;
 
@@ -431,12 +391,8 @@ export declare class AssistantEventHub {
     hasCapacity(): boolean;
 }
 
-/**
- * Singleton hub shared across the entire runtime process.
- *
- * Import and use this in daemon send paths and the SSE route.
- */
-export declare const assistantEventHub: AssistantEventHub;
+/** The plugin-facing event hub. See module docs. */
+export declare const assistantEventHub: PluginEventHub;
 
 /** Opaque handle returned by `subscribe`. Call `dispose()` to remove the subscription. */
 export declare interface AssistantEventSubscription {
@@ -531,6 +487,52 @@ declare const AvatarUpdatedEventSchema: z.ZodObject<{
     avatarPath: z.ZodString;
 }, z.core.$strip>;
 
+declare interface BackgroundToolCompleted {
+    type: "background_tool_completed";
+    id: string;
+    conversationId: string;
+    status: "completed" | "failed" | "cancelled";
+    exitCode?: number | null;
+    output?: string;
+    completedAt: number;
+}
+
+declare type _BackgroundToolsServerMessages = BackgroundToolStarted | BackgroundToolCompleted;
+
+declare interface BackgroundToolStarted {
+    type: "background_tool_started";
+    id: string;
+    toolName: string;
+    conversationId: string;
+    command: string;
+    startedAt: number;
+}
+
+/**
+ * A single assistant event wrapping an outbound message payload.
+ *
+ * Generic over the payload type. The `TMessage` default of `unknown` keeps
+ * the envelope nameable without a type argument when the caller does not
+ * care about message narrowing.
+ */
+declare interface BaseAssistantEvent<TMessage = unknown> {
+    /** Globally unique event identifier (UUID). */
+    id: string;
+    /** Resolved conversation id when available. */
+    conversationId?: string;
+    /**
+     * Monotonic per-conversation sequence number. Assigned by the daemon at
+     * publish time for conversation-scoped events; absent for unscoped
+     * broadcasts. Clients track the highest observed `seq` per conversation
+     * and pass it back on reconnect to request replay of missed events.
+     */
+    seq?: number;
+    /** ISO-8601 timestamp of when the event was emitted. */
+    emittedAt: string;
+    /** Outbound message payload. */
+    message: TMessage;
+}
+
 declare interface BaseSubscriberEntry {
     filter: AssistantEventFilter;
     callback: AssistantEventCallback;
@@ -1009,7 +1011,6 @@ declare const ConversationErrorEventSchema: z.ZodObject<{
         CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
         CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
         DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-        REGENERATE_FAILED: "REGENERATE_FAILED";
         UNKNOWN: "UNKNOWN";
     }>;
     userMessage: z.ZodString;
@@ -1120,7 +1121,6 @@ declare const ConversationNoticeEventSchema: z.ZodObject<{
         CONVERSATION_ABORTED: "CONVERSATION_ABORTED";
         CONVERSATION_PROCESSING_FAILED: "CONVERSATION_PROCESSING_FAILED";
         DISK_SPACE_CRITICAL: "DISK_SPACE_CRITICAL";
-        REGENERATE_FAILED: "REGENERATE_FAILED";
         UNKNOWN: "UNKNOWN";
     }>;
     userMessage: z.ZodString;
@@ -1200,9 +1200,9 @@ declare const DiskPressureStatusChangedEventSchema: z.ZodObject<{
     status: z.ZodObject<{
         enabled: z.ZodBoolean;
         state: z.ZodEnum<{
-            ok: "ok";
             unknown: "unknown";
             disabled: "disabled";
+            ok: "ok";
             warning: "warning";
             critical: "critical";
         }>;
@@ -1390,27 +1390,26 @@ declare const ErrorEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 
 /**
- * Tool-related type declarations shared between the daemon and any
- * skill-side package that needs to describe tools, permission risk, or tool
- * execution results on the wire.
+ * Tool-related type declarations: the neutral leaf module describing
+ * tools, permission risk, and tool execution results.
  *
- * Pure type-level declarations only (+ the `RiskLevel` enum, which is a value
- * but is safely cross-package). No runtime helpers live here — the assistant
- * keeps all behavior functions in `assistant/src/tools/` and re-exports the
- * types from this file.
+ * Pure type-level declarations only (+ the `RiskLevel` enum, which is a
+ * value). No runtime helpers live here — the assistant keeps all behavior
+ * functions in `assistant/src/tools/` and re-exports the types from this
+ * file. This module imports nothing, so it can sit at the bottom of the
+ * import graph and be consumed by `tools/types.ts`, `providers/types.ts`,
+ * and `permissions/types.ts` without creating cycles.
  *
  * Heavy daemon-internal references (CES client, host-proxy classes, trust
  * classifications, interface IDs, content blocks, CES `ApprovalRequired`)
- * are held as opaque `unknown` / broadened-`string` placeholders on this
- * side so the contracts package never reaches into the assistant or the
- * service-contracts runtime. The assistant redeclares `Tool`, `ToolContext`,
- * `ToolExecutionResult`, `ToolExecutedEvent`, `ToolLifecycleEvent`,
- * `ToolLifecycleEventHandler`, and `ProxyToolResolver` in
- * `assistant/src/tools/types.ts` with the concrete types in place, so
- * existing call sites keep their full type information. The two sides are
- * structurally independent — no inheritance, no intersection — which
- * avoids TypeScript's contravariance mismatches on lifecycle-event
- * handlers.
+ * are held as opaque `unknown` / broadened-`string` placeholders here. The
+ * assistant redeclares `Tool`, `ToolContext`, `ToolExecutionResult`,
+ * `ToolExecutedEvent`, `ToolLifecycleEvent`, `ToolLifecycleEventHandler`,
+ * and `ProxyToolResolver` in `assistant/src/tools/types.ts` with the
+ * concrete types in place, so existing call sites keep their full type
+ * information. The two sides are structurally independent — no inheritance,
+ * no intersection — which avoids TypeScript's contravariance mismatches on
+ * lifecycle-event handlers.
  */
 declare type ExecutionTarget = "sandbox" | "host";
 
@@ -2257,7 +2256,7 @@ declare interface IntegrationListResponse {
     }>;
 }
 
-declare type _IntegrationsServerMessages = SlackWebhookConfigResponse | IngressConfigResponse | PlatformConfigResponse | VercelApiConfigResponse | TelegramConfigResponse | ChannelVerificationSessionResponse | IntegrationListResponse | IntegrationConnectResult | OAuthConnectResultResponse | OpenUrlEvent | NavigateSettingsEvent | ShowPlatformLogin | PlatformDisconnected;
+declare type _IntegrationsServerMessages = SlackWebhookConfigResponse | IngressConfigResponse | PlatformConfigResponse | VercelApiConfigResponse | TelegramConfigResponse | ChannelVerificationSessionResponse | IntegrationListResponse | IntegrationConnectResult | OAuthConnectResultResponse | OpenUrlEvent | OpenPanelEvent | NavigateSettingsEvent | ShowPlatformLogin | PlatformDisconnected;
 
 declare type InteractionResolvedEvent = z.infer<typeof InteractionResolvedEventSchema>;
 
@@ -2354,8 +2353,6 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     styleAnalyzer: "styleAnalyzer";
     inviteInstructionGenerator: "inviteInstructionGenerator";
     skillCategoryInference: "skillCategoryInference";
-    meetConsentMonitor: "meetConsentMonitor";
-    meetChatOpportunity: "meetChatOpportunity";
     inference: "inference";
     vision: "vision";
     trustRuleSuggestion: "trustRuleSuggestion";
@@ -2364,139 +2361,6 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     workflowLeaf: "workflowLeaf";
 }>;
 
-/**
- * The assistant successfully posted a chat message into the meeting via
- * the bot's `/send_chat` endpoint. Emitted once per successful send so
- * SSE-subscribed clients can render the outbound chat without waiting for
- * the bot to echo it back through the transcript/chat stream.
- */
-declare interface MeetChatSent {
-    type: "meet.chat_sent";
-    meetingId: string;
-    /** The text that was posted into the meeting's chat. */
-    text: string;
-}
-
-/** The bot hit a non-recoverable error (container crash, join failure, etc.). */
-declare interface MeetError {
-    type: "meet.error";
-    meetingId: string;
-    /** Human-readable error detail. */
-    detail: string;
-}
-
-/** The bot has successfully joined and is live in the meeting. */
-declare interface MeetJoined {
-    type: "meet.joined";
-    meetingId: string;
-}
-
-/** The bot has started attempting to join a meeting. */
-declare interface MeetJoining {
-    type: "meet.joining";
-    meetingId: string;
-    /** The Meet URL the bot was asked to join. */
-    url: string;
-}
-
-/** The bot has left the meeting. */
-declare interface MeetLeft {
-    type: "meet.left";
-    meetingId: string;
-    /** Free-form reason passed to `leave()` (e.g. "user-requested", "timeout"). */
-    reason: string;
-}
-
-/**
- * Meet — server → client push messages for live meeting state.
- *
- * Emitted by the assistant daemon as the Meet-bot progresses through its
- * lifecycle (joining → joined → left) and as in-meeting state changes
- * (participants, active speaker, transcript chunks).
- *
- * Keep payloads small and client-actionable: these events power the
- * macOS "In meeting" status panel and the conversation bridge's live
- * transcript feed. A client that missed an event can always refetch
- * authoritative state from the daemon's HTTP routes.
- */
-/** A single participant in a meeting. Shape mirrors the wire-level type. */
-declare interface MeetParticipant {
-    /** Stable participant identifier (provider-specific). */
-    id: string;
-    /** Display name of the participant. */
-    name: string;
-    /** Whether the participant is the meeting host. */
-    isHost?: boolean;
-    /** Whether the participant is the bot itself. */
-    isSelf?: boolean;
-}
-
-/** Participants joined and/or left the meeting since the last snapshot. */
-declare interface MeetParticipantChanged {
-    type: "meet.participant_changed";
-    meetingId: string;
-    /** Participants who joined since the last snapshot. */
-    joined: MeetParticipant[];
-    /** Participants who left since the last snapshot. */
-    left: MeetParticipant[];
-}
-
-declare type _MeetServerMessages = MeetJoining | MeetJoined | MeetParticipantChanged | MeetSpeakerChanged | MeetTranscriptChunk | MeetLeft | MeetChatSent | MeetError | MeetSpeakingStarted | MeetSpeakingEnded;
-
-/** The active speaker in the meeting changed. */
-declare interface MeetSpeakerChanged {
-    type: "meet.speaker_changed";
-    meetingId: string;
-    /** Stable speaker identifier for the new active speaker. */
-    speakerId: string;
-    /** Display name of the new active speaker. */
-    speakerName: string;
-}
-
-/**
- * The assistant has finished (or cancelled) a TTS playback stream. Fired
- * after the bot-side playback request settles — whether normally, via an
- * explicit cancel, or due to an upstream error.
- */
-declare interface MeetSpeakingEnded {
-    type: "meet.speaking_ended";
-    meetingId: string;
-    /** Opaque stream identifier — matches `meet.speaking_started.streamId`. */
-    streamId: string;
-    /** Why the stream ended: natural completion, caller-initiated cancel, or an upstream error. */
-    reason: "completed" | "cancelled" | "error";
-}
-
-/**
- * The assistant has begun speaking into the meeting via the TTS bridge. Fired
- * once per {@link MeetSessionManager.speak} invocation immediately before the
- * synthesis stream starts flowing to the bot's `/play_audio` endpoint. Useful
- * for clients that want to render a "speaking …" indicator.
- */
-declare interface MeetSpeakingStarted {
-    type: "meet.speaking_started";
-    meetingId: string;
-    /** Opaque stream identifier — matches `meet.speaking_ended.streamId`. */
-    streamId: string;
-}
-
-/**
- * A finalized chunk of transcribed speech. Interim chunks are filtered
- * out before publication so clients only render stable text.
- */
-declare interface MeetTranscriptChunk {
-    type: "meet.transcript_chunk";
-    meetingId: string;
-    /** The transcribed text. */
-    text: string;
-    /** Human-readable speaker label, if the ASR provided one. */
-    speakerLabel?: string;
-    /** Stable speaker identifier across the meeting, if available. */
-    speakerId?: string;
-    /** ASR confidence in [0, 1], if available. */
-    confidence?: number;
-}
-
 declare interface MemoryRecalled {
     type: "memory_recalled";
     provider: string;
@@ -2795,6 +2659,16 @@ declare interface OpenConversation {
     focus?: boolean;
 }
 
+declare type OpenPanelEvent = z.infer<typeof OpenPanelEventSchema>;
+
+declare const OpenPanelEventSchema: 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>;
+
 declare type OpenUrlEvent = z.infer<typeof OpenUrlEventSchema>;
 
 declare const OpenUrlEventSchema: z.ZodObject<{
@@ -2836,6 +2710,13 @@ declare interface PlatformDisconnected {
     type: "platform_disconnected";
 }
 
+/**
+ * The subset of {@link AssistantEventHub} workspace plugins may use. Picking
+ * method signatures off the class keeps the facade in sync with the hub while
+ * statically withholding everything else.
+ */
+export declare type PluginEventHub = Pick<AssistantEventHub, "subscribe" | "publish" | "hasSubscribersForEvent">;
+
 /**
  * Minimal pino-compatible logger surface handed to plugin hooks. The host
  * supplies a pino child logger bound to `{ plugin: <name> }`; this
@@ -3454,6 +3335,14 @@ declare interface SecretPromptResult {
     delivery: SecretDelivery;
     /** When set, the prompt could not be delivered and the value is null due to a delivery failure (not user cancellation). */
     error?: "unsupported_channel";
+    /**
+     * Why `value` is null. `"cancelled"` = the user explicitly dismissed the
+     * prompt (a valid flow, not a failure); `"timed_out"` = no response within
+     * the permission-timeout window. Only meaningful when `value` is null and
+     * `error` is unset. Lets callers distinguish a deliberate cancel from a
+     * genuine failure instead of treating both as an error.
+     */
+    reason?: "cancelled" | "timed_out";
 }
 
 declare type SecretRequestEvent = z.infer<typeof SecretRequestEventSchema>;
@@ -3571,7 +3460,7 @@ declare interface SensitiveOutputBinding {
 
 declare type SensitiveOutputKind = "invite_code";
 
-declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MeetServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
+declare type ServerMessage = _ConversationsServerMessages | _MessagesServerMessages | _SurfacesServerMessages | _SkillsServerMessages | _AppsServerMessages | _IntegrationsServerMessages | _ComputerUseServerMessages | _ContactsServerMessages | _WorkItemsServerMessages | _SubagentsServerMessages | _DocumentsServerMessages | _DocumentCommentsServerMessages | _GuardianActionsServerMessages | _SyncInvalidationServerMessages | _HomeServerMessages | _HostAppControlServerMessages | _HostBashServerMessages | _HostBrowserServerMessages | _HostCuServerMessages | _HostFileServerMessages | _HostTransferServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";
@@ -3646,22 +3535,34 @@ declare interface ShowPlatformLogin {
 }
 
 /**
- * Context passed to the `shutdown` hook during daemon teardown. Kept
- * intentionally narrower than {@link InitContext} — most teardown
- * paths only need to know which assistant version they're shutting
- * down against (e.g. for version-conditional cleanup of state files
- * written by a previous boot).
+ * Context passed to the `shutdown` hook. Kept intentionally narrower than
+ * {@link InitContext} — teardown paths only need to know which assistant
+ * version they're shutting down against (e.g. for version-conditional cleanup
+ * of state files written by a previous boot) and {@link ShutdownReason why}
+ * they're being torn down (so a plugin can, e.g., delete its state on
+ * `uninstall` but preserve it across a plain `shutdown`).
  *
- * Additional fields may be added as concrete plugin needs surface; the
- * `assistantVersion` field mirrors the init context's so plugins that
- * stash a version stamp at init can compare against the same name on
- * tear-down without keeping their own copy.
+ * The `assistantVersion` field mirrors the init context's so plugins that stash
+ * a version stamp at init can compare against the same name on tear-down
+ * without keeping their own copy.
  */
 export declare interface ShutdownContext {
     /** Assistant semver for compatibility checks inside the plugin. */
     assistantVersion: string;
+    /** Why the plugin is shutting down. */
+    reason: ShutdownReason;
 }
 
+/**
+ * Why a plugin's `shutdown` hook is firing.
+ *
+ * - `shutdown` — the daemon is tearing down (process exit).
+ * - `uninstall` — the plugin's directory was removed at runtime.
+ * - `disable` — the plugin was disabled at runtime (e.g. a `.disabled`
+ *   sentinel was added, or a feature flag turned it off).
+ */
+declare type ShutdownReason = "shutdown" | "uninstall" | "disable";
+
 declare interface SignBundlePayloadRequest {
     type: "sign_bundle_payload";
     requestId: string;
@@ -3870,7 +3771,7 @@ declare interface SubagentSpawned {
 
 declare type _SubagentsServerMessages = SubagentSpawned | SubagentStatusChanged | SubagentDetailResponse;
 
-declare type SubagentStatus = "pending" | "running" | "awaiting_input" | "completed" | "failed" | "aborted";
+declare type SubagentStatus = "pending" | "running" | "awaiting_input" | "completed" | "failed" | "aborted" | "interrupted";
 
 declare interface SubagentStatusChanged {
     type: "subagent_status_changed";
@@ -4226,6 +4127,18 @@ export declare interface ToolContext {
      * @legacy
      */
     sourceActorPrincipalId?: string;
+    /**
+     * The conversation's effective per-chat plugin scope, as produced by
+     * `getEffectiveEnabledPluginSet`: `null` means no per-chat restriction;
+     * otherwise a Set of allowed plugin ids (the user's selection unioned with
+     * the always-on first-party defaults). Skill-surface tools that resolve
+     * skills by id outside the per-turn projection — `skill_load` (body load)
+     * and `find_similar_skills` (discovery) — read this to drop skills owned by
+     * plugins outside the conversation's scope. Populated per tool call from the
+     * live conversation state.
+     * @legacy
+     */
+    enabledPluginSet?: Set<string> | null;
 }
 
 /**
@@ -4694,32 +4607,22 @@ declare const TraceEventSchema: z.ZodObject<{
     }>;
     status: z.ZodOptional<z.ZodEnum<{
         error: "error";
-        info: "info";
         success: "success";
         warning: "warning";
+        info: "info";
     }>>;
     summary: z.ZodString;
     attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
 }, z.core.$strip>;
 
-/**
- * Trust classification for an inbound actor.
- *
- * - `'guardian'`: The sender matches the active guardian binding for this
- *   (assistant, channel). Guardians have full control-plane access and
- *   self-approve tool invocations.
- * - `'trusted_contact'`: The sender is an active contact with a channel
- *   (not the guardian). Trusted contacts can invoke tools but require
- *   guardian approval for sensitive operations.
- * - `'unverified_contact'`: The sender matches a contact channel whose
- *   status is `pending` or `unverified` — known to the guardian but not yet
- *   verified. Treated identically to `trusted_contact` for every downstream
- *   capability/tool/approval decision; the distinction is admission-only.
- * - `'unknown'`: The sender has no contact record, no identity could be
- *   established, or the sender is a blocked/revoked contact. Unknown
- *   actors are fail-closed with no escalation path.
- */
-declare type TrustClass = "guardian" | "trusted_contact" | "unverified_contact" | "unknown";
+declare type TrustClass = z.infer<typeof trustClassSchema>;
+
+declare const trustClassSchema: z.ZodEnum<{
+    unknown: "unknown";
+    guardian: "guardian";
+    trusted_contact: "trusted_contact";
+    unverified_contact: "unverified_contact";
+}>;
 
 declare interface UiSurfaceComplete {
     type: "ui_surface_complete";
@@ -4963,6 +4866,14 @@ export declare interface UserPromptSubmitContext {
      * attach turn-scoped metadata to the originating message (e.g. recording an
      * injected memory block so it survives a conversation reload) key off this
      * row id rather than the in-memory message arrays, whose entries carry no id.
+     *
+     * @deprecated This field is always identical to {@link requestId}; use
+     *   `requestId` instead. Every path that starts an agent loop persists the
+     *   triggering user message under the turn's request ID before running, so
+     *   the message row id and the request's correlation ID are the same UUID.
+     *   This holds for the standard submit, queue-drain, subagent, voice, wake,
+     *   and conversation-analysis paths alike. This field will be removed in a
+     *   future API version.
      */
     readonly userMessageId: string;
     /**
@@ -4970,6 +4881,10 @@ export declare interface UserPromptSubmitContext {
      * runtime injection forward it onto the injector turn context so the
      * assembled blocks are attributed to the originating request; it is fixed
      * for the turn and cannot be recovered from the message arrays.
+     *
+     * As of the requestId/userMessageId merge, this value is also the
+     * persisted row ID of the user message, so hooks that previously
+     * keyed off {@link userMessageId} can use `requestId` directly.
      */
     readonly requestId: string;
     /**
@@ -5000,6 +4915,13 @@ export declare interface UserPromptSubmitContext {
      * it from the message arrays.
      */
     readonly prompt: string;
+    /**
+     * True when the triggering message is a transcript-suppressed machine
+     * signal (`metadata.hidden` — e.g. the channel-setup wizard-close marker)
+     * rather than something the user typed. Hooks that treat `prompt` as
+     * user speech (e.g. title generation) should skip these turns.
+     */
+    readonly isHiddenPrompt?: boolean;
     /**
      * The user's original message list, immutable for the hook. Plugins
      * may snapshot or compare against this but MUST NOT mutate it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.10.4-staging.2",
+  "version": "0.10.5-dev.202607022248.91fa053",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",