@vellumai/plugin-api 0.11.10-dev.202609100223.953b0c6 → 0.11.10-dev.202609100822.c03f0a4

package/index.d.ts

@@ -4238,6 +4238,18 @@ declare interface BaseSubscriberEntry {
  */
 export declare function buildMessageExcerpt(rawContent: string, query: string): Promise<string>;
 
+/**
+ * The turn-cancellation guard every side-effecting tool calls, host tools and
+ * plugin tools alike. It lives on the plugin API surface because that is the
+ * only module a plugin may import from, and the guard must be one
+ * implementation rather than a copy per side of the boundary.
+ */
+/** The slice of a tool's context this guard reads. */
+export declare interface CancellableToolContext {
+    /** Cooperative cancellation signal for the turn, when the caller supplies one. */
+    signal?: AbortSignal;
+}
+
 /**
  * Conversation-type axis within an adapter (the "channel-type" cascade
  * level): direct message, private channel/group, public channel. Adapters
@@ -7410,6 +7422,22 @@ export declare interface ThinkingContent {
     signature: string;
 }
 
+/**
+ * Stop a side-effecting tool whose turn was cancelled before it acted.
+ *
+ * Call this immediately before the step that changes something the user would
+ * notice: a write, a create/update/delete, a message send, a process spawn, a
+ * paid provider call. The agent loop tells the model an aborted batch was
+ * cancelled, so anything that lands after the abort is work the model believes
+ * never happened.
+ *
+ * Throws the signal's own reason, which is the daemon's tagged abort reason
+ * for a conversation abort and a `DOMException` named `AbortError` for a plain
+ * one. The tool executor recognizes both and reports the call as an expected
+ * cancellation rather than a tool failure.
+ */
+export declare function throwIfCancelled(context: CancellableToolContext): void;
+
 /** Discriminated container so future tools can add their own metadata. */
 declare interface ToolActivityMetadata {
     webSearch?: WebSearchMetadata;

package/index.js

@@ -61,4 +61,5 @@ export const stringifyMessageContent = api.stringifyMessageContent;
 export const sweepOrphanedGraphNodePoints = api.sweepOrphanedGraphNodePoints;
 export const syncMessageToDisk = api.syncMessageToDisk;
 export const synthesizeText = api.synthesizeText;
+export const throwIfCancelled = api.throwIfCancelled;
 export const updateMessageMetadata = api.updateMessageMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.11.10-dev.202609100223.953b0c6",
+  "version": "0.11.10-dev.202609100822.c03f0a4",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",