@vellumai/plugin-api 0.12.2-dev.202609211820.22f71b0 → 0.12.2-dev.202609212016.fb4c53e

package/index.d.ts

@@ -3669,6 +3669,50 @@ declare const AssistantEventEnvelopeSchema: z.ZodObject<{
                 errorMessage: z.ZodOptional<z.ZodString>;
                 mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>;
+            recall: z.ZodOptional<z.ZodObject<{
+                query: z.ZodString;
+                depth: z.ZodEnum<{
+                    standard: "standard";
+                    fast: "fast";
+                    deep: "deep";
+                }>;
+                sources: z.ZodArray<z.ZodEnum<{
+                    workspace: "workspace";
+                    memory: "memory";
+                    conversations: "conversations";
+                }>>;
+                answer: z.ZodOptional<z.ZodString>;
+                evidence: z.ZodArray<z.ZodObject<{
+                    source: z.ZodEnum<{
+                        workspace: "workspace";
+                        memory: "memory";
+                        conversations: "conversations";
+                    }>;
+                    title: z.ZodString;
+                    locator: z.ZodString;
+                    excerpt: z.ZodString;
+                    timestampMs: z.ZodOptional<z.ZodNumber>;
+                    path: z.ZodOptional<z.ZodString>;
+                    conversationId: z.ZodOptional<z.ZodString>;
+                    messageId: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+                searchedSources: z.ZodArray<z.ZodObject<{
+                    source: z.ZodEnum<{
+                        workspace: "workspace";
+                        memory: "memory";
+                        conversations: "conversations";
+                    }>;
+                    status: z.ZodEnum<{
+                        searched: "searched";
+                        degraded: "degraded";
+                    }>;
+                    evidenceCount: z.ZodNumber;
+                    error: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            remember: z.ZodOptional<z.ZodObject<{
+                facts: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         answeredQuestion: z.ZodOptional<z.ZodObject<{
             requestId: z.ZodString;
@@ -5260,6 +5304,50 @@ declare const AssistantEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             errorMessage: z.ZodOptional<z.ZodString>;
             mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
+        recall: z.ZodOptional<z.ZodObject<{
+            query: z.ZodString;
+            depth: z.ZodEnum<{
+                standard: "standard";
+                fast: "fast";
+                deep: "deep";
+            }>;
+            sources: z.ZodArray<z.ZodEnum<{
+                workspace: "workspace";
+                memory: "memory";
+                conversations: "conversations";
+            }>>;
+            answer: z.ZodOptional<z.ZodString>;
+            evidence: z.ZodArray<z.ZodObject<{
+                source: z.ZodEnum<{
+                    workspace: "workspace";
+                    memory: "memory";
+                    conversations: "conversations";
+                }>;
+                title: z.ZodString;
+                locator: z.ZodString;
+                excerpt: z.ZodString;
+                timestampMs: z.ZodOptional<z.ZodNumber>;
+                path: z.ZodOptional<z.ZodString>;
+                conversationId: z.ZodOptional<z.ZodString>;
+                messageId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            searchedSources: z.ZodArray<z.ZodObject<{
+                source: z.ZodEnum<{
+                    workspace: "workspace";
+                    memory: "memory";
+                    conversations: "conversations";
+                }>;
+                status: z.ZodEnum<{
+                    searched: "searched";
+                    degraded: "degraded";
+                }>;
+                evidenceCount: z.ZodNumber;
+                error: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+        remember: z.ZodOptional<z.ZodObject<{
+            facts: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
     }, z.core.$strip>>;
     answeredQuestion: z.ZodOptional<z.ZodObject<{
         requestId: z.ZodString;
@@ -12342,6 +12430,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 +18200,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;
@@ -23576,6 +23681,50 @@ declare const ToolActivityMetadataSchema: z.ZodObject<{
         errorMessage: z.ZodOptional<z.ZodString>;
         mayRequireJavaScript: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>>;
+    recall: z.ZodOptional<z.ZodObject<{
+        query: z.ZodString;
+        depth: z.ZodEnum<{
+            standard: "standard";
+            fast: "fast";
+            deep: "deep";
+        }>;
+        sources: z.ZodArray<z.ZodEnum<{
+            workspace: "workspace";
+            memory: "memory";
+            conversations: "conversations";
+        }>>;
+        answer: z.ZodOptional<z.ZodString>;
+        evidence: z.ZodArray<z.ZodObject<{
+            source: z.ZodEnum<{
+                workspace: "workspace";
+                memory: "memory";
+                conversations: "conversations";
+            }>;
+            title: z.ZodString;
+            locator: z.ZodString;
+            excerpt: z.ZodString;
+            timestampMs: z.ZodOptional<z.ZodNumber>;
+            path: z.ZodOptional<z.ZodString>;
+            conversationId: z.ZodOptional<z.ZodString>;
+            messageId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        searchedSources: z.ZodArray<z.ZodObject<{
+            source: z.ZodEnum<{
+                workspace: "workspace";
+                memory: "memory";
+                conversations: "conversations";
+            }>;
+            status: z.ZodEnum<{
+                searched: "searched";
+                degraded: "degraded";
+            }>;
+            evidenceCount: z.ZodNumber;
+            error: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    remember: z.ZodOptional<z.ZodObject<{
+        facts: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 
 /**
@@ -24369,6 +24518,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.202609212016.fb4c53e",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",