@vellumai/plugin-api 0.12.2-dev.202609170320.2f82e57 → 0.12.2-dev.202609170629.61d51c8

package/index.d.ts

@@ -602,6 +602,9 @@ declare const AssistantConfigSchema: z.ZodObject<{
                 bm25NormK: z.ZodDefault<z.ZodUnion<readonly [z.ZodNumber, z.ZodNull]>>;
                 bypassForCore: z.ZodDefault<z.ZodBoolean>;
             }, z.core.$strip>>;
+            poolLog: z.ZodDefault<z.ZodObject<{
+                captureInput: z.ZodDefault<z.ZodBoolean>;
+            }, z.core.$strip>>;
         }, z.core.$strip>>;
         retrospective: z.ZodDefault<z.ZodObject<{
             enabled: z.ZodDefault<z.ZodBoolean>;
@@ -4573,6 +4576,34 @@ export declare interface ConversationRow {
  */
 export declare type ConversationsClearedContext = BaseHookContext;
 
+/**
+ * Per-conversation record of what the most recent live turn sent to the
+ * provider that a fork wake cannot re-derive (`conversation_tool_surfaces`).
+ *
+ * The provider prompt cache is a byte-exact prefix match over
+ * `tools -> system -> messages`, so a background wake that forks a
+ * conversation can only reuse the source's cached prefix by sending the SAME
+ * tools array under the SAME system prompt. Re-deriving either on the fork
+ * cannot guarantee that: the fork may run in another process (a different
+ * tool registry), with no connected clients (different host-tool gates),
+ * under a presence the persisted message stamps do not encode, or under a
+ * wake scope that cannot spawn subagents where the source could (the system
+ * prompt's delegation section). Recording the resolved values and replaying
+ * them verbatim can.
+ */
+/** What a live turn sent that a replaying fork reproduces verbatim. */
+export declare interface ConversationToolSurface {
+    /** The tool definitions the turn sent, exactly as resolved. */
+    tools: ToolDefinition_2[];
+    /**
+     * Whether the turn's system prompt rendered the parallel-delegation
+     * section (`01-parallel-tasks`), which the prompt derives from the same
+     * resolved tool surface plus the turn's channel. `null` when unknown: the
+     * turn ran on a system-prompt override, or the row predates the column.
+     */
+    delegateIndependentTasks: boolean | null;
+}
+
 /** Read-side alias of {@link ConversationCreateType}. */
 declare type ConversationType = ConversationCreateType;
 
@@ -4782,7 +4813,10 @@ export declare function getConversationProcessingStartedAt(id: string): Promise<
 
 /**
  * The tool definitions the conversation's most recent live turn sent to the
- * provider, or `null` when none has been recorded.
+ * provider, or `null` when none has been recorded. A projection of
+ * {@link getRecordedConversationToolSurface}: a fork replaying the source's
+ * request needs the whole record, whose delegation-section state the system
+ * prompt tier of the provider cache prefix depends on.
  */
 export declare function getConversationToolSurface(conversationId: string): Promise<ToolDefinition_2[] | null>;
 
@@ -4807,6 +4841,14 @@ export declare function getMessages(conversationId: string): Promise<MessageRow[
  */
 export declare function getModelProfiles(): ModelProfileInfo[];
 
+/**
+ * What the conversation's most recent live turn sent to the provider that a
+ * replaying fork reproduces verbatim (its tool definitions and the
+ * delegation-section state of its system prompt), or `null` when none has
+ * been recorded.
+ */
+export declare function getRecordedConversationToolSurface(conversationId: string): Promise<ConversationToolSurface | null>;
+
 /**
  * Returns the workspace root for user-facing state.
  *

package/index.js

@@ -30,6 +30,7 @@ export const getConversationToolSurface = api.getConversationToolSurface;
 export const getDocument = api.getDocument;
 export const getMessages = api.getMessages;
 export const getModelProfiles = api.getModelProfiles;
+export const getRecordedConversationToolSurface = api.getRecordedConversationToolSurface;
 export const getWorkspaceDir = api.getWorkspaceDir;
 export const hasLexicalTokens = api.hasLexicalTokens;
 export const indexDocument = api.indexDocument;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vellumai/plugin-api",
-  "version": "0.12.2-dev.202609170320.2f82e57",
+  "version": "0.12.2-dev.202609170629.61d51c8",
   "description": "Public TypeScript authoring contract for Vellum assistant plugins.",
   "license": "MIT",
   "type": "module",