@vellumai/plugin-api 0.11.7-dev.202608301911.907e905 → 0.11.7-dev.202608302213.8788231

package/index.d.ts

@@ -4030,6 +4030,26 @@ export declare interface AssistantEventSubscription {
     readonly connectionId: string;
 }
 
+/**
+ * The `_attachmentId` property as a spreadable fragment, or nothing when there
+ * is no usable id.
+ *
+ * Every producer of a media block faces the same choice: it either knows the
+ * attachment row the block came from, or it does not, and the field has to be
+ * absent rather than present-and-empty in the second case. This helper is the
+ * one place that decision lives, so every producer answers it the same way.
+ * Callers pass whatever id they hold: the source block's own
+ * ({@link ImageContent._attachmentId}) when carrying it across a rebuild, or an
+ * upload's row id when stamping a fresh block.
+ *
+ * Empty counts as absent, matching the read side, which requires a non-empty
+ * string before it will treat the field as an id (see
+ * `daemon/handlers/shared.ts`).
+ */
+export declare function attachmentIdFragment(attachmentId: string | undefined): {
+    _attachmentId?: string;
+};
+
 export declare interface AudioEmbeddingInput {
     type: "audio";
     data: Buffer;
@@ -4744,6 +4764,19 @@ declare type HostProxyCapability = (typeof HOST_PROXY_CAPABILITIES)[number];
 export declare interface ImageContent {
     type: "image";
     source: MediaSource_2;
+    /**
+     * Internal id linking a base64 image block to a row in the attachments table,
+     * the same correlation {@link FileContent._attachmentId} carries. A live turn
+     * sends its uploads inline while persisting them as references, so this is
+     * the only handle on the in-memory copy of an image whose stored form is a
+     * `workspace_ref`; camera-frame retention matches on it. Redundant once the
+     * block is a reference (use `source.attachmentId`).
+     *
+     * Never reaches a provider: every client builds its image payload out of
+     * `source` alone (see the `case "image"` arms of the Anthropic, Gemini, and
+     * both OpenAI clients), so top-level fields are dropped by construction.
+     */
+    _attachmentId?: string;
 }
 
 export declare interface ImageEmbeddingInput {
@@ -5032,11 +5065,11 @@ declare interface LiveVoiceErrorServerFrame extends LiveVoiceServerFrameBase {
      * daemons predating the field.
      *
      * It exists so an `unknown_type` is attributable. A client that sends more
-     * than one optional frame (today: `update_config` and `attach_image`) gets
-     * the same code for either, and without this has to assume which one was
-     * refused. The wrong assumption is silent in both directions: settings stop
-     * applying for a session, or a photo the user watched themselves take is
-     * dropped with nothing said.
+     * than one optional frame (today: `update_config`, `attach_image`,
+     * `attach_frame`, and `text`) gets the same code for any of them, and
+     * without this has to assume which one was refused. The wrong assumption is
+     * silent in both directions: settings stop applying for a session, or a
+     * photo the user watched themselves take is dropped with nothing said.
      */
     readonly frameType?: string;
     /**
@@ -5314,6 +5347,21 @@ declare const LLMCallSiteEnum: z.ZodEnum<{
     workflowLeaf: "workflowLeaf";
 }>;
 
+/**
+ * The attachment row a media block came from, whichever of the two shapes it
+ * is in, or undefined for a block that came from none (tool-generated and
+ * assistant-authored media).
+ *
+ * A reference names its row on `source.attachmentId`; an inline block has
+ * nowhere to put it but the top-level `_attachmentId`. Both are the same fact,
+ * so anything asking "which attachment is this?" has to read both or it goes
+ * blind on half the histories. Reading only `_attachmentId` in particular is
+ * the sharp edge: it is absent on every reference block, so a rebuild that
+ * flattens a reference to inline bytes drops the link unless it derives the id
+ * through here first.
+ */
+export declare function mediaBlockAttachmentId(block: ImageContent | FileContent): string | undefined;
+
 declare type MediaSource_2 = Base64MediaSource | WorkspaceRefMediaSource;
 
 export declare interface Message {

package/index.js

@@ -11,6 +11,7 @@ export const TtsSynthesisError = api.TtsSynthesisError;
 export const VOICE_ESCALATION_CONTINUATION_MESSAGE_KIND = api.VOICE_ESCALATION_CONTINUATION_MESSAGE_KIND;
 export const addMessage = api.addMessage;
 export const assistantEventHub = api.assistantEventHub;
+export const attachmentIdFragment = api.attachmentIdFragment;
 export const buildMessageExcerpt = api.buildMessageExcerpt;
 export const createLiveVoiceConnection = api.createLiveVoiceConnection;
 export const deleteConversation = api.deleteConversation;
@@ -38,6 +39,7 @@ export const lastToolResultUserMessageIndex = api.lastToolResultUserMessageIndex
 export const listCatalogSkills = api.listCatalogSkills;
 export const listConversations = api.listConversations;
 export const listInstalledSkills = api.listInstalledSkills;
+export const mediaBlockAttachmentId = api.mediaBlockAttachmentId;
 export const openTranscriptionSession = api.openTranscriptionSession;
 export const parseMessageMetadata = api.parseMessageMetadata;
 export const persistSystemCard = api.persistSystemCard;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.7-dev.202608301911.907e905",
+  "version": "0.11.7-dev.202608302213.8788231",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",