@standardagents/builder 0.10.1-dev.d2d335e → 0.10.1-next.9e1860c

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

@@ -1,7 +1,6 @@
 import fs2 from 'fs';
 import path3 from 'path';
 import { fileURLToPath } from 'url';
-import { createRequire } from 'module';
 
 // src/plugin.ts
 var TSCONFIG_CONTENT = `{
@@ -398,6 +397,9 @@ declare module 'virtual:@standardagents/builder' {
     listThreads(params?: {
       agent_name?: string;
       user_id?: string;
+      search?: string;
+      startDate?: number;
+      endDate?: number;
       limit?: number;
       offset?: number;
     }): Promise<{ threads: ThreadRegistryEntry[]; total: number }>;
@@ -813,16 +815,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},`);
@@ -1000,9 +992,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 +1011,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 +1115,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 +1162,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 +1314,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 +1358,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 +1383,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 +1399,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 +1586,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,9 +1601,9 @@ 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";
       }
     }
   }
@@ -1635,21 +1615,10 @@ function validateAgentData(data) {
       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;
 }
 
 // src/plugin.ts
-createRequire(import.meta.url);
 var VIRTUAL_TOOLS_ID = "virtual:@standardagents-tools";
 var RESOLVED_VIRTUAL_TOOLS_ID = "\0" + VIRTUAL_TOOLS_ID;
 var VIRTUAL_ROUTES_ID = "virtual:@standardagents-routes";
@@ -1668,6 +1637,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 +1814,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 +1871,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,
@@ -2072,7 +2071,15 @@ function agentbuilder(options = {}) {
         "zod",
         "openai"
       ];
+      const currentDir = path3.dirname(fileURLToPath(import.meta.url));
+      const isInDist = currentDir.endsWith("dist");
+      const builderClientDir = path3.resolve(
+        currentDir,
+        isInDist ? "./client" : "../dist/client"
+      );
       return {
+        // Set publicDir to builder's client assets so Cloudflare plugin preserves assets config
+        publicDir: fs2.existsSync(builderClientDir) ? builderClientDir : void 0,
         optimizeDeps: {
           // Exclude our packages from pre-bundling - they contain cloudflare:workers imports
           // that cannot be resolved during dependency optimization
@@ -2145,6 +2152,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;
       }
@@ -2223,6 +2233,48 @@ function isPublicRoute(routePath) {
   return false;
 }
 
+// CORS headers for API responses
+const CORS_HEADERS = {
+  "Access-Control-Allow-Origin": "*",
+  "Access-Control-Allow-Methods": "GET, POST, PUT, DELETE, PATCH, OPTIONS",
+  "Access-Control-Allow-Headers": "Content-Type, Authorization, X-Requested-With",
+  "Access-Control-Max-Age": "86400",
+};
+
+// Helper to create headers with CORS
+function corsHeaders(contentType) {
+  return {
+    "Content-Type": contentType,
+    ...CORS_HEADERS,
+  };
+}
+
+// Helper to add CORS headers to any Response without touching the body
+function addCorsHeaders(response) {
+  // Skip WebSocket upgrade responses - they can't be wrapped
+  if (response.status === 101) {
+    return response;
+  }
+
+  // Skip if already has CORS headers
+  if (response.headers.has("Access-Control-Allow-Origin")) {
+    return response;
+  }
+
+  // Create new headers with CORS added
+  const newHeaders = new Headers(response.headers);
+  for (const [key, value] of Object.entries(CORS_HEADERS)) {
+    newHeaders.set(key, value);
+  }
+
+  // Return new Response with same body stream (not cloned, just transferred)
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers: newHeaders,
+  });
+}
+
 export async function router(request, env) {
   const url = new URL(request.url);
   const pathname = url.pathname;
@@ -2232,6 +2284,14 @@ export async function router(request, env) {
     return null;
   }
 
+  // Handle CORS preflight requests
+  if (request.method === "OPTIONS") {
+    return new Response(null, {
+      status: 204,
+      headers: CORS_HEADERS,
+    });
+  }
+
   // Strip mount point prefix for route matching, ensuring we keep the leading slash
   let routePath = pathname.slice(MOUNT_POINT.length) || "/";
   if (!routePath.startsWith('/')) {
@@ -2266,7 +2326,7 @@ ${threadRouteCode}
 
       // If requireAuth returns a Response, it's an error (401)
       if (authResult instanceof Response) {
-        return authResult;
+        return addCorsHeaders(authResult);
       }
 
       authContext = authResult;
@@ -2285,16 +2345,17 @@ ${threadRouteCode}
     const result = await controller(context);
 
     if (result instanceof Response) {
-      return result;
+      return addCorsHeaders(result);
     }
     if (typeof result === "string") {
       return new Response(result, {
-        headers: {
-          "Content-Type": "text/plain",
-        },
+        headers: corsHeaders("text/plain"),
       });
     }
-    return Response.json(result);
+    // JSON responses get CORS headers
+    return new Response(JSON.stringify(result), {
+      headers: corsHeaders("application/json"),
+    });
   }
 
   // Serve UI for all other routes (SPA fallback)
@@ -2309,13 +2370,15 @@ async function serveUI(pathname, env) {
         // Create a proper request for the asset path
         // Use a dummy origin since we only care about the path
         // Re-add mount point since pathname was stripped by router
-        const assetUrl = \`http://localhost\${MOUNT_POINT}\${pathname}\`;
+        // Handle root mountPoint "/" specially to avoid double slashes
+        const mountPrefix = MOUNT_POINT === "/" ? "" : MOUNT_POINT;
+        const assetUrl = \`http://localhost\${mountPrefix}\${pathname}\`;
         let response = await env.ASSETS.fetch(assetUrl);
 
         // If not found, fall back to index.html for SPA routing
         const isIndexHtml = response.status === 404 || pathname === "/" || !pathname.includes(".");
         if (isIndexHtml) {
-          response = await env.ASSETS.fetch(\`http://localhost\${MOUNT_POINT}/index.html\`);
+          response = await env.ASSETS.fetch(\`http://localhost\${mountPrefix}/index.html\`);
 
           // Transform HTML to use configured mount point
           if (response.status === 200) {
@@ -2462,6 +2525,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) {
@@ -2470,6 +2558,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, "/");
@@ -2548,6 +2637,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");
@@ -2558,7 +2663,8 @@ import { DurableAgentBuilder as _BaseDurableAgentBuilder } from '@standardagents
 
 // Import sip WASM module and initializer
 // Static import allows workerd to pre-compile the WASM at bundle time
-import _sipWasm from '@standardagents/sip/dist/sip.wasm';
+// WASM is bundled in builder's dist to avoid transitive dependency resolution issues
+import _sipWasm from '@standardagents/builder/dist/sip.wasm';
 import { initWithWasmModule as _initSipWasm } from '@standardagents/sip';
 
 // Re-export router from virtual:@standardagents-routes
@@ -2585,6 +2691,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.
@@ -2619,6 +2729,10 @@ export class DurableThread extends _BaseDurableThread {
   agents() {
     return _agents;
   }
+
+  effects() {
+    return _effects;
+  }
 }
 
 /**
@@ -2645,6 +2759,10 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
   agents() {
     return _agents;
   }
+
+  effects() {
+    return _effects;
+  }
 }
 `;
       }
@@ -2657,6 +2775,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) => {
@@ -2901,20 +3020,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];
@@ -2942,10 +3053,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)
@@ -3111,6 +3219,13 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
                   const items = match[1].match(/['"]([^'"]+)['"]/g);
                   return items ? items.map((s) => s.replace(/['"]/g, "")) : [];
                 };
+                const getSidePrompt = (c, side) => {
+                  const sideRegex = new RegExp(`${side}:\\s*\\{([^}]+)\\}`, "s");
+                  const sideMatch = c.match(sideRegex);
+                  if (!sideMatch) return null;
+                  const promptMatch = sideMatch[1].match(/prompt:\s*['"]([^'"]+)['"]/);
+                  return promptMatch ? promptMatch[1] : null;
+                };
                 const name = getName(content);
                 if (!name) return null;
                 return {
@@ -3121,6 +3236,8 @@ export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
                   default_prompt: getDefaultPrompt(content) || "",
                   default_model: getDefaultModel(content) || "",
                   tools: getTools(content),
+                  side_a_agent_prompt: getSidePrompt(content, "sideA"),
+                  side_b_agent_prompt: getSidePrompt(content, "sideB"),
                   created_at: Math.floor(Date.now() / 1e3)
                 };
               } catch (error) {