@vellumai/plugin-api 0.11.11-staging.2 → 0.11.11-staging.3

package/index.d.ts

@@ -5731,6 +5731,17 @@ export declare function parseMessageMetadata(metadataJson: string | null): Promi
  */
 declare function parseMessageMetadata_2(metadataJson: string | null): MessageMetadata_2 | undefined;
 
+/**
+ * Read the `surfaceId` out of a `ui_show` tool result, or `undefined` when the
+ * content is not a surface envelope.
+ *
+ * Trailing prose after the JSON object is tolerated: guidance belongs in a
+ * `note` field, but a caller that appends it instead must not silently cost
+ * the reader its `surfaceId`: losing the id makes a live progress surface
+ * invisible to the completion nudge, and the user watches it spin forever.
+ */
+export declare function parseSurfaceShowResultId(content: string): string | undefined;
+
 /**
  * Plugin-facing facade over the host's system-card writer: a daemon-authored
  * transcript notice, persisted as an assistant row stamped

package/index.js

@@ -42,6 +42,7 @@ export const listInstalledSkills = api.listInstalledSkills;
 export const mediaBlockAttachmentId = api.mediaBlockAttachmentId;
 export const openTranscriptionSession = api.openTranscriptionSession;
 export const parseMessageMetadata = api.parseMessageMetadata;
+export const parseSurfaceShowResultId = api.parseSurfaceShowResultId;
 export const persistSystemCard = api.persistSystemCard;
 export const publishEvent = api.publishEvent;
 export const quarantineRefusedExchanges = api.quarantineRefusedExchanges;

package/package.json

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