@standardagents/builder 0.12.1 → 0.12.2

package/dist/index.d.ts

@@ -83,6 +83,17 @@ declare global {
          * @deprecated Use StandardAgentSpec.Callables instead
          */
         type Callables = StandardAgentSpec.Callables;
+        /**
+         * Interface for hook ID registration.
+         * @deprecated Use StandardAgentSpec.HookIdRegistry instead
+         */
+        interface HookIdRegistry extends StandardAgentSpec.HookIdRegistry {
+        }
+        /**
+         * Union type of all hook IDs defined in agents/hooks/.
+         * @deprecated Use StandardAgentSpec.HookIds instead
+         */
+        type Hooks = StandardAgentSpec.HookIds;
     }
 }
 
@@ -1400,6 +1411,8 @@ interface PromptDefinition<N extends string = string, S extends ToolArgs = ToolA
     reasoning?: ReasoningConfig;
     /** Number of recent messages to keep actual images for. @default 10 */
     recentImageThreshold?: number;
+    /** Hook IDs to run when this prompt is active. Falls back to agent-level hooks if not set. */
+    hooks?: AgentBuilder.Hooks[];
 }
 
 /**
@@ -1628,6 +1641,10 @@ interface PromptFileData {
      * Will be converted to Zod code.
      */
     requiredSchema?: JSONSchema;
+    /**
+     * Hook IDs to associate with this prompt.
+     */
+    hooks?: string[];
 }
 /**
  * Generate a TypeScript file for a prompt definition.

package/dist/index.js

@@ -4808,7 +4808,7 @@ var init_FlowEngine = __esm({
     init_ToolExecutor();
     init_context();
     init_ThreadStateImpl();
-    FlowEngine = class {
+    FlowEngine = class _FlowEngine {
       /**
        * Main execution entry point
        * Executes an agent conversation until stopped or max steps reached
@@ -4943,6 +4943,30 @@ var init_FlowEngine = __esm({
         }
         await state.stream.close();
       }
+      /**
+       * Convert a PromptDefinition (from definePrompt) to PromptData (runtime format).
+       */
+      static convertPromptDefinition(id, def) {
+        return {
+          id,
+          name: def.name,
+          tool_description: def.toolDescription,
+          prompt: def.prompt,
+          model: def.model,
+          include_chat: def.includeChat ?? false,
+          include_past_tools: def.includePastTools ?? false,
+          parallel_tool_calls: def.parallelToolCalls ?? false,
+          tool_choice: def.toolChoice ?? "auto",
+          reasoning_effort: def.reasoning?.effort ?? null,
+          reasoning_max_tokens: def.reasoning?.maxTokens ?? null,
+          reasoning_exclude: def.reasoning?.exclude ?? false,
+          include_reasoning: def.reasoning?.include ?? false,
+          recentImageThreshold: def.recentImageThreshold ?? null,
+          _tools: def.tools ?? [],
+          _requiredSchema: def.requiredSchema ?? null,
+          _hooks: def.hooks ?? []
+        };
+      }
       /**
        * Load prompts from TypeScript configs via virtual modules.
        *
@@ -4960,23 +4984,7 @@ var init_FlowEngine = __esm({
         if (sideAPromptDef.tools?.length) {
           console.log(`[FlowEngine] Prompt tools: [${sideAPromptDef.tools.map((t) => typeof t === "string" ? t : t.name).join(", ")}]`);
         }
-        const sideAPrompt = {
-          id: sideAPromptName,
-          name: sideAPromptDef.name,
-          tool_description: sideAPromptDef.toolDescription,
-          prompt: sideAPromptDef.prompt,
-          model: sideAPromptDef.model,
-          include_chat: sideAPromptDef.includeChat ?? false,
-          include_past_tools: sideAPromptDef.includePastTools ?? false,
-          parallel_tool_calls: sideAPromptDef.parallelToolCalls ?? false,
-          tool_choice: sideAPromptDef.toolChoice ?? "auto",
-          reasoning_effort: sideAPromptDef.reasoning?.effort ?? null,
-          reasoning_max_tokens: sideAPromptDef.reasoning?.maxTokens ?? null,
-          reasoning_exclude: sideAPromptDef.reasoning?.exclude ?? false,
-          include_reasoning: sideAPromptDef.reasoning?.include ?? false,
-          _tools: sideAPromptDef.tools ?? [],
-          _requiredSchema: sideAPromptDef.requiredSchema ?? null
-        };
+        const sideAPrompt = _FlowEngine.convertPromptDefinition(sideAPromptName, sideAPromptDef);
         let sideBPrompt = null;
         const sideBPromptName = agentConfig.side_b_agent_prompt;
         if (sideBPromptName) {
@@ -4986,23 +4994,7 @@ var init_FlowEngine = __esm({
           if (sideBPromptDef.tools?.length) {
             console.log(`[FlowEngine] Prompt tools: [${sideBPromptDef.tools.map((t) => typeof t === "string" ? t : t.name).join(", ")}]`);
           }
-          sideBPrompt = {
-            id: sideBPromptName,
-            name: sideBPromptDef.name,
-            tool_description: sideBPromptDef.toolDescription,
-            prompt: sideBPromptDef.prompt,
-            model: sideBPromptDef.model,
-            include_chat: sideBPromptDef.includeChat ?? false,
-            include_past_tools: sideBPromptDef.includePastTools ?? false,
-            parallel_tool_calls: sideBPromptDef.parallelToolCalls ?? false,
-            tool_choice: sideBPromptDef.toolChoice ?? "auto",
-            reasoning_effort: sideBPromptDef.reasoning?.effort ?? null,
-            reasoning_max_tokens: sideBPromptDef.reasoning?.maxTokens ?? null,
-            reasoning_exclude: sideBPromptDef.reasoning?.exclude ?? false,
-            include_reasoning: sideBPromptDef.reasoning?.include ?? false,
-            _tools: sideBPromptDef.tools ?? [],
-            _requiredSchema: sideBPromptDef.requiredSchema ?? null
-          };
+          sideBPrompt = _FlowEngine.convertPromptDefinition(sideBPromptName, sideBPromptDef);
         }
         return { agentConfig, sideAPrompt, sideBPrompt };
       }
@@ -9021,6 +9013,10 @@ function generatePromptFile(data) {
     const reasoningCode = formatReasoningConfig(data.reasoning);
     lines.push(`  reasoning: ${reasoningCode},`);
   }
+  if (data.hooks && data.hooks.length > 0) {
+    const hooksCode = data.hooks.map((h) => `'${escapeString2(h)}'`).join(", ");
+    lines.push(`  hooks: [${hooksCode}],`);
+  }
   if (hasSchema) {
     const zodCode = jsonSchemaToZod(data.requiredSchema, 1);
     lines.push(`  requiredSchema: ${zodCode},`);