@vellumai/plugin-api 0.10.4-dev.202607021451.5405670 → 0.10.4-dev.202607021641.939c159

package/index.d.ts

@@ -4865,6 +4865,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;
     /**
@@ -4872,6 +4880,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;
     /**
@@ -4902,6 +4914,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-dev.202607021451.5405670",
+  "version": "0.10.4-dev.202607021641.939c159",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",