@vellumai/plugin-api 0.12.2-dev.202609211820.22f71b0 → 0.12.2-dev.202609211913.b0ee78c

package/index.d.ts

@@ -12342,6 +12342,13 @@ declare type InterfaceId = (typeof INTERFACE_IDS)[number];
  */
 export declare const INTERNAL_NUDGE_OUTPUT_SUPPRESSION = " This notice is internal: do not repeat, quote, describe, or acknowledge it, and do not narrate whether you will continue or whether the turn is done. Reply with only the content the user should see.";
 
+/**
+ * Failed-parse tool result for executors that validate their own input (the
+ * pre-execution gate in `ToolApprovalHandler` produces the same message, so
+ * the error reads identically whichever layer catches it first).
+ */
+export declare function invalidToolInputResult(toolName: string, error: z.ZodError): ToolExecutionResult;
+
 /** Whether the conversation currently has a turn in flight. */
 export declare function isConversationProcessing(id: string): Promise<boolean>;
 
@@ -18105,6 +18112,16 @@ generated: undefined;
 dialect: "sqlite";
 }>;
 
+/**
+ * Wrap an optional field's schema so an explicit `null` parses as "omitted"
+ * (`undefined`). Models routinely send `null` for optional fields they mean
+ * to skip, and executors read such fields via `input.x ?? fallback`, where
+ * null and absent are equivalent — validation must not reject null there.
+ * The derived JSON Schema is the inner schema's (the null-tolerance is
+ * runtime slack, not advertised contract).
+ */
+export declare function nullAsOmitted<T extends z.ZodType>(schema: T): z.ZodPipe<z.ZodTransform<{} | undefined, unknown>, z.ZodOptional<T>>;
+
 declare const oauthApps: SQLiteTableWithColumns<    {
 name: "oauth_apps";
 schema: undefined;
@@ -24369,6 +24386,37 @@ export declare interface ToolUseContent {
     };
 }
 
+/**
+ * Derive a tool's LLM-facing `input_schema` from its Zod input schema, so the
+ * schema the model sees and the validation the executor runs share one source
+ * and cannot drift (`TOOL_INPUT_SCHEMAS` in `../tool-input-schemas.ts` holds
+ * the executor-side half).
+ *
+ * Conversion uses Zod 4's native `z.toJSONSchema` (mirroring
+ * `workflows/leaf-runner.ts`), then adjusts the output for the tool-definition
+ * context:
+ *
+ * - The `$schema` marker is dropped — tool definitions don't carry one.
+ * - `additionalProperties` values of `false` / `{}` are dropped. They are
+ *   authoring artifacts of `z.object` / `z.looseObject`, not intentional
+ *   contract: runtime validation never rejects unknown keys (registry schemas
+ *   must tolerate injected fields like `activity`, see
+ *   `schema-transforms.ts`), so advertising `additionalProperties: false`
+ *   would claim a strictness the runtime doesn't enforce.
+ *
+ * `advertiseRequired` names fields to mark required in the advertised schema
+ * even though the Zod schema treats them as optional. This is the one
+ * sanctioned divergence, and only in the tolerant direction: the model is told
+ * to always send the field (e.g. `activity`, which drives status UX), but a
+ * call that omits it still executes rather than failing on a field the tool
+ * doesn't need. Naming `activity` there also records the schema as carrying
+ * the daemon's own status field (`declareDaemonActivityField`), so a surface
+ * that renders no activity text can drop it from the advertised copy.
+ */
+export declare function toToolInputSchema(schema: z.ZodType, opts?: {
+    advertiseRequired?: readonly string[];
+}): Record<string, unknown>;
+
 /**
  * Trust classification of an inbound actor, ordered most- to least-trusted.
  * The one declaration of the vocabulary: the gateway classifies with it and

package/index.js

@@ -35,6 +35,7 @@ export const getRecordedConversationToolSurface = api.getRecordedConversationToo
 export const getWorkspaceDir = api.getWorkspaceDir;
 export const hasLexicalTokens = api.hasLexicalTokens;
 export const indexDocument = api.indexDocument;
+export const invalidToolInputResult = api.invalidToolInputResult;
 export const isConversationProcessing = api.isConversationProcessing;
 export const isMaxTokensStopReason = api.isMaxTokensStopReason;
 export const isToolResultMessage = api.isToolResultMessage;
@@ -44,6 +45,7 @@ export const listCatalogSkills = api.listCatalogSkills;
 export const listConversations = api.listConversations;
 export const listInstalledSkills = api.listInstalledSkills;
 export const mediaBlockAttachmentId = api.mediaBlockAttachmentId;
+export const nullAsOmitted = api.nullAsOmitted;
 export const openTranscriptionSession = api.openTranscriptionSession;
 export const parseMessageMetadata = api.parseMessageMetadata;
 export const parseSurfaceShowResultId = api.parseSurfaceShowResultId;
@@ -67,4 +69,5 @@ export const sweepOrphanedGraphNodePoints = api.sweepOrphanedGraphNodePoints;
 export const syncMessageToDisk = api.syncMessageToDisk;
 export const synthesizeText = api.synthesizeText;
 export const throwIfCancelled = api.throwIfCancelled;
+export const toToolInputSchema = api.toToolInputSchema;
 export const updateMessageMetadata = api.updateMessageMetadata;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.12.2-dev.202609211820.22f71b0",
+  "version": "0.12.2-dev.202609211913.b0ee78c",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",