@standardagents/builder 0.10.1-next.bbd142a → 0.11.0-next.41deba4

package/dist/plugin.d.ts

@@ -8,6 +8,7 @@ interface AgentPluginOptions {
     modelsDir?: string;
     promptsDir?: string;
     agentsDir?: string;
+    effectsDir?: string;
 }
 declare function agentbuilder(options?: AgentPluginOptions): Plugin;
 

package/dist/plugin.js

@@ -813,16 +813,6 @@ function generatePromptFile(data) {
     const toolsCode = formatToolsArray(data.tools);
     lines.push(`  tools: ${toolsCode},`);
   }
-  if (data.handoffAgents && data.handoffAgents.length > 0) {
-    const agentsStr = data.handoffAgents.map((a) => `'${escapeString2(a)}'`).join(", ");
-    lines.push(`  handoffAgents: [${agentsStr}],`);
-  }
-  if (data.beforeTool) {
-    lines.push(`  beforeTool: '${escapeString2(data.beforeTool)}',`);
-  }
-  if (data.afterTool) {
-    lines.push(`  afterTool: '${escapeString2(data.afterTool)}',`);
-  }
   if (data.reasoning && hasNonNullProperties(data.reasoning)) {
     const reasoningCode = formatReasoningConfig(data.reasoning);
     lines.push(`  reasoning: ${reasoningCode},`);
@@ -987,7 +977,7 @@ function generateAgentFile(data) {
   if (data.type && data.type !== "ai_human") {
     lines.push(`  type: '${data.type}',`);
   }
-  if (data.maxSessionTurns !== void 0) {
+  if (data.maxSessionTurns !== void 0 && data.maxSessionTurns !== null) {
     lines.push(`  maxSessionTurns: ${data.maxSessionTurns},`);
   }
   lines.push(`  sideA: ${formatSideConfig(data.sideA)},`);
@@ -1000,9 +990,6 @@ function generateAgentFile(data) {
   if (data.toolDescription) {
     lines.push(`  toolDescription: '${escapeString3(data.toolDescription)}',`);
   }
-  if (data.tags && data.tags.length > 0) {
-    lines.push(`  tags: ${JSON.stringify(data.tags)},`);
-  }
   lines.push(`});`);
   lines.push("");
   return lines.join("\n");
@@ -1022,11 +1009,11 @@ function formatSideConfig(config) {
   if (config.stopToolResponseProperty) {
     parts.push(`    stopToolResponseProperty: '${escapeString3(config.stopToolResponseProperty)}',`);
   }
-  if (config.maxTurns !== void 0) {
-    parts.push(`    maxTurns: ${config.maxTurns},`);
+  if (config.maxSteps !== void 0) {
+    parts.push(`    maxSteps: ${config.maxSteps},`);
   }
-  if (config.endConversationTool) {
-    parts.push(`    endConversationTool: '${escapeString3(config.endConversationTool)}',`);
+  if (config.endSessionTool) {
+    parts.push(`    endSessionTool: '${escapeString3(config.endSessionTool)}',`);
   }
   if (config.manualStopCondition !== void 0) {
     parts.push(`    manualStopCondition: ${config.manualStopCondition},`);
@@ -1126,7 +1113,7 @@ function validateModelData(data) {
   if (!data.provider || typeof data.provider !== "string") {
     return "Model provider is required and must be a string";
   }
-  const validProviders = ["openai", "openrouter", "anthropic", "google"];
+  const validProviders = ["openai", "openrouter", "anthropic", "google", "test"];
   if (!validProviders.includes(data.provider)) {
     return `Invalid provider '${data.provider}'. Must be one of: ${validProviders.join(", ")}`;
   }
@@ -1173,11 +1160,8 @@ function transformPromptData(data) {
     required_schema: "requiredSchema",
     include_chat: "includeChat",
     include_past_tools: "includePastTools",
-    before_tool: "beforeTool",
-    after_tool: "afterTool",
     parallel_tool_calls: "parallelToolCalls",
     tool_choice: "toolChoice",
-    handoff_agents: "handoffAgents",
     reasoning_effort: "reasoningEffort",
     reasoning_max_tokens: "reasoningMaxTokens",
     reasoning_exclude: "reasoningExclude",
@@ -1328,9 +1312,6 @@ function validatePromptData(data) {
   if (data.tools !== void 0 && !Array.isArray(data.tools)) {
     return "tools must be an array";
   }
-  if (data.handoffAgents !== void 0 && !Array.isArray(data.handoffAgents)) {
-    return "handoffAgents must be an array";
-  }
   if (data.reasoning !== void 0) {
     if (typeof data.reasoning !== "object") {
       return "reasoning must be an object";
@@ -1375,11 +1356,11 @@ function transformAgentData(data) {
   if (data.side_a_stop_tool_response_property) {
     transformed.sideA.stopToolResponseProperty = data.side_a_stop_tool_response_property;
   }
-  if (data.side_a_max_turns !== void 0) {
-    transformed.sideA.maxTurns = data.side_a_max_turns;
+  if (data.side_a_max_steps !== void 0) {
+    transformed.sideA.maxSteps = data.side_a_max_steps;
   }
-  if (data.side_a_end_conversation_tool) {
-    transformed.sideA.endConversationTool = data.side_a_end_conversation_tool;
+  if (data.side_a_end_session_tool) {
+    transformed.sideA.endSessionTool = data.side_a_end_session_tool;
   }
   if (data.side_a_manual_stop_condition !== void 0) {
     transformed.sideA.manualStopCondition = data.side_a_manual_stop_condition;
@@ -1400,11 +1381,11 @@ function transformAgentData(data) {
     if (data.side_b_stop_tool_response_property) {
       transformed.sideB.stopToolResponseProperty = data.side_b_stop_tool_response_property;
     }
-    if (data.side_b_max_turns !== void 0) {
-      transformed.sideB.maxTurns = data.side_b_max_turns;
+    if (data.side_b_max_steps !== void 0) {
+      transformed.sideB.maxSteps = data.side_b_max_steps;
     }
-    if (data.side_b_end_conversation_tool) {
-      transformed.sideB.endConversationTool = data.side_b_end_conversation_tool;
+    if (data.side_b_end_session_tool) {
+      transformed.sideB.endSessionTool = data.side_b_end_session_tool;
     }
     if (data.side_b_manual_stop_condition !== void 0) {
       transformed.sideB.manualStopCondition = data.side_b_manual_stop_condition;
@@ -1416,9 +1397,6 @@ function transformAgentData(data) {
   if (data.tool_description) {
     transformed.toolDescription = data.tool_description;
   }
-  if (data.tags) {
-    transformed.tags = data.tags;
-  }
   return transformed;
 }
 function getAgentFilePath(agentsDir, name) {
@@ -1606,9 +1584,9 @@ function validateAgentData(data) {
   if (data.sideA.stopTool && !data.sideA.stopToolResponseProperty) {
     return "sideA.stopToolResponseProperty is required when sideA.stopTool is set";
   }
-  if (data.sideA.maxTurns !== void 0) {
-    if (typeof data.sideA.maxTurns !== "number" || data.sideA.maxTurns <= 0) {
-      return "sideA.maxTurns must be a positive number";
+  if (data.sideA.maxSteps !== void 0) {
+    if (typeof data.sideA.maxSteps !== "number" || data.sideA.maxSteps <= 0) {
+      return "sideA.maxSteps must be a positive number";
     }
   }
   if (data.type === "dual_ai") {
@@ -1621,30 +1599,20 @@ function validateAgentData(data) {
     if (data.sideB.stopTool && !data.sideB.stopToolResponseProperty) {
       return "sideB.stopToolResponseProperty is required when sideB.stopTool is set";
     }
-    if (data.sideB.maxTurns !== void 0) {
-      if (typeof data.sideB.maxTurns !== "number" || data.sideB.maxTurns <= 0) {
-        return "sideB.maxTurns must be a positive number";
+    if (data.sideB.maxSteps !== void 0) {
+      if (typeof data.sideB.maxSteps !== "number" || data.sideB.maxSteps <= 0) {
+        return "sideB.maxSteps must be a positive number";
       }
     }
   }
   if (data.exposeAsTool && !data.toolDescription) {
     return "toolDescription is required when exposeAsTool is true";
   }
-  if (data.maxSessionTurns !== void 0) {
+  if (data.maxSessionTurns !== void 0 && data.maxSessionTurns !== null) {
     if (typeof data.maxSessionTurns !== "number" || data.maxSessionTurns <= 0) {
       return "maxSessionTurns must be a positive number";
     }
   }
-  if (data.tags !== void 0) {
-    if (!Array.isArray(data.tags)) {
-      return "tags must be an array";
-    }
-    for (const tag of data.tags) {
-      if (typeof tag !== "string") {
-        return "Each tag must be a string";
-      }
-    }
-  }
   return null;
 }
 
@@ -1668,6 +1636,8 @@ var VIRTUAL_PROMPTS_ID = "virtual:@standardagents-prompts";
 var RESOLVED_VIRTUAL_PROMPTS_ID = "\0" + VIRTUAL_PROMPTS_ID;
 var VIRTUAL_AGENTS_ID = "virtual:@standardagents-agents";
 var RESOLVED_VIRTUAL_AGENTS_ID = "\0" + VIRTUAL_AGENTS_ID;
+var VIRTUAL_EFFECTS_ID = "virtual:@standardagents-effects";
+var RESOLVED_VIRTUAL_EFFECTS_ID = "\0" + VIRTUAL_EFFECTS_ID;
 var VIRTUAL_BUILDER_ID = "virtual:@standardagents/builder";
 var RESOLVED_VIRTUAL_BUILDER_ID = "\0" + VIRTUAL_BUILDER_ID;
 function scanApiDirectory(dir, baseRoute = "") {
@@ -1843,6 +1813,33 @@ async function scanPromptsDirectory(dir) {
 async function scanAgentsDirectory(dir) {
   return scanConfigDirectory(dir, /export\s+default\s+defineAgent/);
 }
+async function scanEffectsDirectory(dir) {
+  const effects = [];
+  if (!fs2.existsSync(dir)) {
+    return effects;
+  }
+  const entries = await fs2.promises.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    if (entry.isFile() && entry.name.endsWith(".ts")) {
+      const fileName = entry.name.replace(".ts", "");
+      const filePath = path3.join(dir, entry.name);
+      const importPath = "./" + path3.relative(process.cwd(), filePath).replace(/\\/g, "/");
+      if (fileName === "CLAUDE" || fileName.startsWith("_")) {
+        continue;
+      }
+      try {
+        const content = fs2.readFileSync(filePath, "utf-8");
+        if (!content.includes("defineEffect")) {
+          continue;
+        }
+      } catch {
+        continue;
+      }
+      effects.push({ name: fileName, importPath });
+    }
+  }
+  return effects;
+}
 function parseRequestBody(req) {
   return new Promise((resolve, reject) => {
     let body = "";
@@ -1873,6 +1870,7 @@ function agentbuilder(options = {}) {
   const modelsDir = options.modelsDir ? path3.resolve(process.cwd(), options.modelsDir) : path3.resolve(process.cwd(), "agents/models");
   const promptsDir = options.promptsDir ? path3.resolve(process.cwd(), options.promptsDir) : path3.resolve(process.cwd(), "agents/prompts");
   const agentsDir = options.agentsDir ? path3.resolve(process.cwd(), options.agentsDir) : path3.resolve(process.cwd(), "agents/agents");
+  const effectsDir = options.effectsDir ? path3.resolve(process.cwd(), options.effectsDir) : path3.resolve(process.cwd(), "agents/effects");
   const outputDir = path3.resolve(process.cwd(), ".agents");
   const typeGenConfig = {
     modelsDir,
@@ -2063,11 +2061,10 @@ function agentbuilder(options = {}) {
         // WASM image processing deps - must be excluded to avoid pre-bundle cache issues
         "@cf-wasm/photon",
         "@cf-wasm/photon/workerd",
+        "@standardagents/sip",
+        // sip's jsquash dependencies (WASM-based decoders)
         "@jsquash/avif",
-        "@jsquash/jpeg",
-        "@jsquash/png",
-        "@jsquash/webp",
-        "@standardagents/sip"
+        "@jsquash/webp"
       ];
       const depsToInclude = [
         "zod",
@@ -2102,11 +2099,10 @@ function agentbuilder(options = {}) {
         // WASM image processing deps
         "@cf-wasm/photon",
         "@cf-wasm/photon/workerd",
+        "@standardagents/sip",
+        // sip's jsquash dependencies (WASM-based decoders)
         "@jsquash/avif",
-        "@jsquash/jpeg",
-        "@jsquash/png",
-        "@jsquash/webp",
-        "@standardagents/sip"
+        "@jsquash/webp"
       ];
       const depsToInclude = [
         "zod",
@@ -2147,6 +2143,9 @@ function agentbuilder(options = {}) {
       if (id === VIRTUAL_AGENTS_ID) {
         return RESOLVED_VIRTUAL_AGENTS_ID;
       }
+      if (id === VIRTUAL_EFFECTS_ID) {
+        return RESOLVED_VIRTUAL_EFFECTS_ID;
+      }
       if (id === VIRTUAL_BUILDER_ID) {
         return RESOLVED_VIRTUAL_BUILDER_ID;
       }
@@ -2464,6 +2463,31 @@ ${agentsCode}
 };
 
 export const agentNames = ${JSON.stringify(agents.filter((a) => !a.error).map((a) => a.name))};
+`;
+      }
+      if (id === RESOLVED_VIRTUAL_EFFECTS_ID) {
+        const effects = await scanEffectsDirectory(effectsDir);
+        const effectsCode = effects.map(({ name, importPath, error }) => {
+          if (error) {
+            const escapedError = error.replace(/"/g, '\\"').replace(/\n/g, "\\n");
+            return `  "${name}": async () => { throw new Error("${escapedError}"); },`;
+          } else {
+            return `  "${name}": async () => {
+    try {
+      return (await import("${importPath}")).default;
+    } catch (error) {
+      console.error('Failed to import effect ${name}:', error);
+      throw error;
+    }
+  },`;
+          }
+        }).join("\n");
+        return `// Virtual agent effects module
+export const effects = {
+${effectsCode}
+};
+
+export const effectNames = ${JSON.stringify(effects.filter((e) => !e.error).map((e) => e.name))};
 `;
       }
       if (id === RESOLVED_VIRTUAL_BUILDER_ID) {
@@ -2472,6 +2496,7 @@ export const agentNames = ${JSON.stringify(agents.filter((a) => !a.error).map((a
         const models = await scanModelsDirectory(modelsDir);
         const prompts = await scanPromptsDirectory(promptsDir);
         const agents = await scanAgentsDirectory(agentsDir);
+        const effects = await scanEffectsDirectory(effectsDir);
         const toAbsolutePath = (relativePath) => {
           if (relativePath.startsWith("./")) {
             return path3.resolve(process.cwd(), relativePath).replace(/\\/g, "/");
@@ -2550,6 +2575,22 @@ export const agentNames = ${JSON.stringify(agents.filter((a) => !a.error).map((a
       console.error('Failed to import agent ${name}:', error);
       throw error;
     }
+  },`;
+          }
+        }).join("\n");
+        const effectsCode = effects.map(({ name, importPath, error }) => {
+          const absPath = toAbsolutePath(importPath);
+          if (error) {
+            const escapedError = error.replace(/"/g, '\\"').replace(/\n/g, "\\n");
+            return `  "${name}": async () => { throw new Error("${escapedError}"); },`;
+          } else {
+            return `  "${name}": async () => {
+    try {
+      return (await import("${absPath}")).default;
+    } catch (error) {
+      console.error('Failed to import effect ${name}:', error);
+      throw error;
+    }
   },`;
           }
         }).join("\n");
@@ -2587,6 +2628,10 @@ const _agents = {
 ${agentsCode}
 };
 
+const _effects = {
+${effectsCode}
+};
+
 /**
  * DurableThread with all virtual module methods already implemented.
  * Simply extend this class in your agents/Thread.ts file.
@@ -2621,6 +2666,10 @@ export class DurableThread extends _BaseDurableThread {
   agents() {
     return _agents;
   }
+
+  effects() {
+    return _effects;
+  }
 }
 
 /**
@@ -2647,6 +2696,10 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
   agents() {
     return _agents;
   }
+
+  effects() {
+    return _effects;
+  }
 }
 `;
       }
@@ -2659,6 +2712,7 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
       this.addWatchFile(modelsDir);
       this.addWatchFile(promptsDir);
       this.addWatchFile(agentsDir);
+      this.addWatchFile(effectsDir);
     },
     configureServer(server) {
       server.watcher.on("add", async (file) => {
@@ -2903,20 +2957,12 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
                 const getIncludePastTools = (c) => c.match(/includePastTools:\s*(true|false)/)?.[1] === "true";
                 const getParallelToolCalls = (c) => c.match(/parallelToolCalls:\s*(true|false)/)?.[1] === "true";
                 const getToolChoice = (c) => c.match(/toolChoice:\s*['"]([^'"]+)['"]/)?.[1];
-                const getBeforeTool = (c) => c.match(/beforeTool:\s*['"]([^'"]+)['"]/)?.[1];
-                const getAfterTool = (c) => c.match(/afterTool:\s*['"]([^'"]+)['"]/)?.[1];
                 const getTools = (c) => {
                   const match = c.match(/tools:\s*\[([^\]]*)\]/);
                   if (!match) return [];
                   const items = match[1].match(/['"]([^'"]+)['"]/g);
                   return items ? items.map((s) => s.replace(/['"]/g, "")) : [];
                 };
-                const getHandoffAgents = (c) => {
-                  const match = c.match(/handoffAgents:\s*\[([^\]]*)\]/);
-                  if (!match) return [];
-                  const items = match[1].match(/['"]([^'"]+)['"]/g);
-                  return items ? items.map((s) => s.replace(/['"]/g, "")) : [];
-                };
                 const getPrompt = (c) => {
                   const backtickMatch = c.match(/prompt:\s*`([\s\S]*?)`/);
                   if (backtickMatch) return backtickMatch[1];
@@ -2944,10 +2990,7 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
                   include_past_tools: getIncludePastTools(content),
                   parallel_tool_calls: getParallelToolCalls(content),
                   tool_choice: getToolChoice(content) || "auto",
-                  before_tool: getBeforeTool(content) || null,
-                  after_tool: getAfterTool(content) || null,
                   tools: getTools(content),
-                  prompts: getHandoffAgents(content),
                   reasoning: null,
                   // Complex to parse
                   created_at: Math.floor(Date.now() / 1e3)