@vellumai/plugin-api 0.10.4-dev.202607022227.14c7770 → 0.10.4-staging.2

package/index.d.ts

@@ -252,7 +252,47 @@ declare interface AssistantAttention {
 }
 
 /** Daemon-side specialization of the generic event envelope. */
-export declare type AssistantEvent = BaseAssistantEvent<ServerMessage>;
+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 AssistantEventCallback = (event: AssistantEvent) => void | Promise<void>;
 
@@ -391,8 +431,12 @@ export declare class AssistantEventHub {
     hasCapacity(): boolean;
 }
 
-/** The plugin-facing event hub. See module docs. */
-export declare const assistantEventHub: PluginEventHub;
+/**
+ * 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;
 
 /** Opaque handle returned by `subscribe`. Call `dispose()` to remove the subscription. */
 export declare interface AssistantEventSubscription {
@@ -487,52 +531,6 @@ 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;
@@ -1011,6 +1009,7 @@ 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;
@@ -1121,6 +1120,7 @@ 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,26 +1390,27 @@ declare const ErrorEventSchema: z.ZodObject<{
 }, z.core.$strip>;
 
 /**
- * Tool-related type declarations: the neutral leaf module describing
- * tools, permission risk, and tool execution results.
+ * 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.
  *
- * 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.
+ * 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.
  *
  * 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 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.
+ * 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.
  */
 declare type ExecutionTarget = "sandbox" | "host";
 
@@ -2256,7 +2257,7 @@ declare interface IntegrationListResponse {
     }>;
 }
 
-declare type _IntegrationsServerMessages = SlackWebhookConfigResponse | IngressConfigResponse | PlatformConfigResponse | VercelApiConfigResponse | TelegramConfigResponse | ChannelVerificationSessionResponse | IntegrationListResponse | IntegrationConnectResult | OAuthConnectResultResponse | OpenUrlEvent | OpenPanelEvent | NavigateSettingsEvent | ShowPlatformLogin | PlatformDisconnected;
+declare type _IntegrationsServerMessages = SlackWebhookConfigResponse | IngressConfigResponse | PlatformConfigResponse | VercelApiConfigResponse | TelegramConfigResponse | ChannelVerificationSessionResponse | IntegrationListResponse | IntegrationConnectResult | OAuthConnectResultResponse | OpenUrlEvent | NavigateSettingsEvent | ShowPlatformLogin | PlatformDisconnected;
 
 declare type InteractionResolvedEvent = z.infer<typeof InteractionResolvedEventSchema>;
 
@@ -2353,6 +2354,8 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     styleAnalyzer: "styleAnalyzer";
     inviteInstructionGenerator: "inviteInstructionGenerator";
     skillCategoryInference: "skillCategoryInference";
+    meetConsentMonitor: "meetConsentMonitor";
+    meetChatOpportunity: "meetChatOpportunity";
     inference: "inference";
     vision: "vision";
     trustRuleSuggestion: "trustRuleSuggestion";
@@ -2361,6 +2364,139 @@ 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;
@@ -2659,16 +2795,6 @@ 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<{
@@ -2710,13 +2836,6 @@ 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
@@ -3335,14 +3454,6 @@ 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>;
@@ -3460,7 +3571,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 | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BackgroundToolsServerMessages | _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 | _MeetServerMessages | _MemoryServerMessages | _WorkspaceServerMessages | _SchedulesServerMessages | _SettingsServerMessages | _DiagnosticsServerMessages | _InboxServerMessages | _NotificationsServerMessages | _UpgradesServerMessages | _AcpServerMessages | _BookmarksServerMessages | _WorkflowsServerMessages | DiskPressureStatusChangedEvent | SubagentEvent;
 
 export declare interface ServerToolUseContent {
     type: "server_tool_use";
@@ -3535,34 +3646,22 @@ declare interface ShowPlatformLogin {
 }
 
 /**
- * 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`).
+ * 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).
  *
- * 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.
+ * 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.
  */
 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;
@@ -3771,7 +3870,7 @@ declare interface SubagentSpawned {
 
 declare type _SubagentsServerMessages = SubagentSpawned | SubagentStatusChanged | SubagentDetailResponse;
 
-declare type SubagentStatus = "pending" | "running" | "awaiting_input" | "completed" | "failed" | "aborted" | "interrupted";
+declare type SubagentStatus = "pending" | "running" | "awaiting_input" | "completed" | "failed" | "aborted";
 
 declare interface SubagentStatusChanged {
     type: "subagent_status_changed";
@@ -4127,18 +4226,6 @@ 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;
 }
 
 /**
@@ -4607,22 +4694,32 @@ 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>;
 
-declare type TrustClass = z.infer<typeof trustClassSchema>;
-
-declare const trustClassSchema: z.ZodEnum<{
-    unknown: "unknown";
-    guardian: "guardian";
-    trusted_contact: "trusted_contact";
-    unverified_contact: "unverified_contact";
-}>;
+/**
+ * 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 interface UiSurfaceComplete {
     type: "ui_surface_complete";
@@ -4866,14 +4963,6 @@ 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;
     /**
@@ -4881,10 +4970,6 @@ 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;
     /**
@@ -4915,13 +5000,6 @@ 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-dev.202607022227.14c7770",
+  "version": "0.10.4-staging.2",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",