@standardagents/builder 0.15.3 → 0.17.0-next.a4b7340

package/dist/packing.d.ts

@@ -1,6 +1,6 @@
-import { P as PackingAnalysis, a as PackingOptions, b as PackingResult, d as UnpackAnalysis, U as UnpackOptions, c as UnpackResult } from './types-DH3Egc5l.js';
-export { D as DiscoveredPackage } from './types-DH3Egc5l.js';
-export { P as PackageDiscoveryService, d as discoverPackages } from './discovery-DVviz3By.js';
+import { P as PackingAnalysis, a as PackingOptions, b as PackingResult, U as UnpackAnalysis, c as UnpackOptions, d as UnpackResult } from './types-Bpe7IANZ.js';
+export { D as DiscoveredPackage } from './types-Bpe7IANZ.js';
+export { P as PackageDiscoveryService, d as discoverPackages } from './discovery-DiMJWisl.js';
 import '@standardagents/spec';
 
 /**

package/dist/plugin.d.ts

@@ -1,7 +1,7 @@
-import { Plugin } from 'vite';
+import { PluginOption } from 'vite';
 
 interface AgentPluginOptions {
-    mountPoint?: string;
+    compatibilityDate?: string;
     toolsDir?: string;
     hooksDir?: string;
     apiDir?: string;
@@ -16,6 +16,7 @@ interface AgentPluginOptions {
      */
     providers?: string[];
 }
-declare function agentbuilder(options?: AgentPluginOptions): Plugin;
+declare function agentbuilder(options?: AgentPluginOptions): PluginOption[];
+declare const builder: typeof agentbuilder;
 
-export { type AgentPluginOptions, agentbuilder };
+export { type AgentPluginOptions, agentbuilder, builder };

package/dist/plugin.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'url';
 import MagicString from 'magic-string';
 import { exec } from 'child_process';
 import { promisify } from 'util';
+import { cloudflare } from '@cloudflare/vite-plugin';
 
 // src/plugin.ts
 var TSCONFIG_CONTENT = `{
@@ -373,14 +374,9 @@ declare module 'virtual:@standardagents/builder' {
 
   /**
    * DurableThread with all virtual module methods pre-implemented.
-   * Extend this class in your agents/Thread.ts file.
-   *
-   * @example
-   * \`\`\`typescript
-   * import { DurableThread } from 'virtual:@standardagents/builder'
-   *
-   * export class Thread extends DurableThread {}
-   * \`\`\`
+   * The generated AgentBuilder Worker entry exports this class automatically;
+   * projects should not create agents/Thread.ts unless they are intentionally
+   * taking over the Worker surface.
    */
   export class DurableThread extends BaseDurableThread {
     // Virtual module registry methods
@@ -551,14 +547,9 @@ declare module 'virtual:@standardagents/builder' {
 
   /**
    * DurableAgentBuilder with all virtual module methods pre-implemented.
-   * Extend this class in your agents/AgentBuilder.ts file.
-   *
-   * @example
-   * \`\`\`typescript
-   * import { DurableAgentBuilder } from 'virtual:@standardagents/builder'
-   *
-   * export class AgentBuilder extends DurableAgentBuilder {}
-   * \`\`\`
+   * The generated AgentBuilder Worker entry exports this class automatically;
+   * projects should not create agents/AgentBuilder.ts unless they are
+   * intentionally taking over the Worker surface.
    */
   export class DurableAgentBuilder extends BaseDurableAgentBuilder {
     // Virtual module registry methods
@@ -716,7 +707,7 @@ declare module 'virtual:@standardagents/builder' {
       providerUserId: string
     ): Promise<User | null>;
 
-    // Edit lock methods (for GitHub integration)
+    // Edit lock methods
     acquireEditLock(params: {
       locked_by: string;
       lock_reason: string;
@@ -6542,14 +6533,12 @@ function readRawRequestBody(req) {
     req.on("error", reject);
   });
 }
-function injectUiConfigIntoHtml(htmlContent, mountPoint) {
-  const configScript = `<script>window.__AGENTBUILDER_CONFIG__ = { mountPoint: "${mountPoint}", devMode: true };</script>`;
-  const assetPrefix = mountPoint === "/" ? "/" : `${mountPoint}/`;
-  return htmlContent.replace(/\/agents\//g, assetPrefix).replace("</head>", `${configScript}</head>`);
+function injectUiConfigIntoHtml(htmlContent) {
+  const configScript = `<script>window.__AGENTBUILDER_CONFIG__ = { devMode: true };</script>`;
+  return htmlContent.replace(/\/agents\//g, "/").replace("</head>", `${configScript}</head>`);
 }
 function createDevMiddleware(server, context) {
   const {
-    mountPoint,
     toolsDir,
     hooksDir,
     modelsDir,
@@ -6569,17 +6558,14 @@ function createDevMiddleware(server, context) {
   });
   server.middlewares.use(async (req, res, next) => {
     const url = req.url;
-    if (!url || !url.startsWith(mountPoint)) {
+    if (!url || !url.startsWith("/")) {
       next();
       return;
     }
-    let pathWithoutMount = url.slice(mountPoint.length) || "/";
-    if (!pathWithoutMount.startsWith("/")) {
-      pathWithoutMount = "/" + pathWithoutMount;
-    }
+    let pathWithoutMount = url;
     const method = req.method?.toUpperCase();
     const legacyMountPoint = "/agentbuilder";
-    if (mountPoint === "/" && (pathWithoutMount === legacyMountPoint || pathWithoutMount.startsWith(`${legacyMountPoint}/`))) {
+    if (pathWithoutMount === legacyMountPoint || pathWithoutMount.startsWith(`${legacyMountPoint}/`)) {
       const normalizedPath = pathWithoutMount.slice(legacyMountPoint.length) || "/";
       if (normalizedPath.startsWith("/api/")) {
         req.url = normalizedPath;
@@ -6664,7 +6650,7 @@ function createDevMiddleware(server, context) {
         const contentType = proxyRes.headers.get("content-type") || "";
         if (contentType.includes("text/html")) {
           const htmlBody = await proxyRes.text();
-          const injectedHtml = Buffer.from(injectUiConfigIntoHtml(htmlBody, mountPoint));
+          const injectedHtml = Buffer.from(injectUiConfigIntoHtml(htmlBody));
           res.setHeader("content-length", String(injectedHtml.byteLength));
           res.end(injectedHtml);
           return;
@@ -6676,7 +6662,7 @@ function createDevMiddleware(server, context) {
         console.error("[agentbuilder] Failed to proxy to UI dev server:", error);
       }
     }
-    const clientPath = mountPoint === "/" && pathWithoutMount.startsWith("/agents/") ? pathWithoutMount.slice("/agents".length) || "/" : pathWithoutMount;
+    const clientPath = pathWithoutMount.startsWith("/agents/") ? pathWithoutMount.slice("/agents".length) || "/" : pathWithoutMount;
     const isStaticAsset = clientPath.startsWith("/assets/") || clientPath.startsWith("/vendor.js") || clientPath.startsWith("/vue.js") || clientPath.startsWith("/monaco.js") || clientPath.startsWith("/index.js") || clientPath.startsWith("/index.css") || clientPath.match(/\.(js|css|png|jpg|jpeg|gif|svg|woff|woff2|ttf|eot|ico)$/);
     {
       const currentDir = path8__default.dirname(fileURLToPath(import.meta.url));
@@ -6698,7 +6684,7 @@ function createDevMiddleware(server, context) {
           const ext = path8__default.extname(filePath).toLowerCase();
           if (ext === ".html") {
             content = Buffer.from(
-              injectUiConfigIntoHtml(content.toString(), mountPoint)
+              injectUiConfigIntoHtml(content.toString())
             );
           }
           const mimeTypes = {
@@ -6874,7 +6860,8 @@ ${effectsCode}
 
 /**
  * DurableThread with all virtual module methods already implemented.
- * Simply extend this class in your agents/Thread.ts file.
+ * Exported by the generated AgentBuilder Worker entry; user projects do not
+ * need an agents/Thread.ts file for the standard hosted/runtime path.
  */
 export class DurableThread extends _BaseDurableThread {
   constructor(ctx, env) {
@@ -6918,7 +6905,8 @@ export class DurableThread extends _BaseDurableThread {
 
 /**
  * DurableAgentBuilder with all virtual module methods already implemented.
- * Simply extend this class in your agents/AgentBuilder.ts file.
+ * Exported by the generated AgentBuilder Worker entry; user projects do not
+ * need an agents/AgentBuilder.ts file for the standard hosted/runtime path.
  */
 export class DurableAgentBuilder extends _BaseDurableAgentBuilder {
   tools() {
@@ -7124,7 +7112,7 @@ export function getVisibleToolNames() {
 `;
 }
 async function loadRoutesVirtualModule(context) {
-  const { mountPoint, threadApiDir, rou3Code, hmr } = context;
+  const { threadApiDir, rou3Code, hmr } = context;
   const threadRoutes = scanApiDirectory(threadApiDir);
   const toAbsolutePath = (inputPath) => path8__default.resolve(process.cwd(), inputPath).replace(/\\/g, "/");
   const threadRouteCode = threadRoutes.map(({ method, route, importPath }) => {
@@ -7186,8 +7174,6 @@ import { registry } from "virtual:@standardagents-registry";
 import { requireAuth, createThreadEndpointHandler } from "@standardagents/builder/runtime";
 import { isThreadEndpoint } from "@standardagents/spec";
 
-const MOUNT_POINT = "${mountPoint}";
-
 // Routes that don't require authentication
 const PUBLIC_ROUTES = [
   '/api/auth/bootstrap',
@@ -7286,11 +7272,6 @@ export async function router(request, env) {
   const url = new URL(request.url);
   const pathname = url.pathname;
 
-  // Check if request is under mount point
-  if (!pathname.startsWith(MOUNT_POINT)) {
-    return null;
-  }
-
   // Handle CORS preflight requests
   if (request.method === "OPTIONS") {
     return new Response(null, {
@@ -7299,11 +7280,7 @@ export async function router(request, env) {
     });
   }
 
-  // Strip mount point prefix for route matching, ensuring we keep the leading slash
-  let routePath = pathname.slice(MOUNT_POINT.length) || "/";
-  if (!routePath.startsWith('/')) {
-    routePath = '/' + routePath;
-  }
+  const routePath = pathname || "/";
 
   // Handle API routes
   const router = createRouter();
@@ -7381,32 +7358,29 @@ ${packedThreadRouteCode}
 
 async function serveUI(pathname, env) {
   try {
-    const clientPath =
-      MOUNT_POINT === "/" && pathname.startsWith("/agents/")
-        ? pathname.slice("/agents".length) || "/"
-        : pathname;
+    const clientPath = pathname.startsWith("/agents/")
+      ? pathname.slice("/agents".length) || "/"
+      : pathname;
 
-    // Use Cloudflare Workers Assets binding (automatically created from wrangler assets config)
+    // Use the Cloudflare Workers Assets binding created by builder()'s generated
+    // Cloudflare Vite plugin config.
     if (env.ASSETS) {
       try {
         // 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
-        // Handle root mountPoint "/" specially to avoid double slashes
-        const mountPrefix = MOUNT_POINT === "/" ? "" : MOUNT_POINT;
-        const assetUrl = \`http://localhost\${mountPrefix}\${clientPath}\`;
+        const assetUrl = \`http://localhost\${clientPath}\`;
         let response = await env.ASSETS.fetch(assetUrl);
 
         // If not found, fall back to index.html for SPA routing
         const isIndexHtml = response.status === 404 || clientPath === "/" || !clientPath.includes(".");
         if (isIndexHtml) {
-          response = await env.ASSETS.fetch(\`http://localhost\${mountPrefix}/index.html\`);
+          response = await env.ASSETS.fetch(\`http://localhost/index.html\`);
 
-          // Transform HTML to use configured mount point
+          // Transform standalone UI asset URLs to root. AgentBuilder owns the
+          // entire Worker surface and has no configurable mount point.
           if (response.status === 200) {
             const html = await response.text();
-            // Replace default /agents/ paths with configured mount point
-            const modifiedHtml = html.replace(/\\/agents\\//g, \`\${MOUNT_POINT}/\`);
+            const modifiedHtml = html.replace(/\\/agents\\//g, "/");
             return new Response(modifiedHtml, {
               headers: {
                 "Content-Type": "text/html; charset=utf-8",
@@ -7443,7 +7417,6 @@ async function serveUI(pathname, env) {
 // src/plugin/virtual-modules.ts
 async function loadVirtualModule(id, context) {
   const {
-    mountPoint,
     toolsDir,
     hooksDir,
     threadApiDir,
@@ -7515,7 +7488,6 @@ export const config = {
   modelsDir: "${relativeModelsDir}",
   promptsDir: "${relativePromptsDir}",
   agentsDir: "${relativeAgentsDir}",
-  mountPoint: "${mountPoint}",
 };`;
   }
   if (id === RESOLVED_VIRTUAL_MODELS_ID) {
@@ -7640,6 +7612,7 @@ ${allProviders.map((p) => `  "${p.name}": async () => (await import("${p.package
     return loadBuilderVirtualModule(context);
   }
 }
+var DEFAULT_AGENTBUILDER_COMPATIBILITY_DATE = "2025-08-13";
 var depsToExclude = [
   "@standardagents/builder",
   "@standardagents/builder/runtime",
@@ -7707,6 +7680,77 @@ function createPluginViteConfig(pluginModuleUrl) {
     }
   };
 }
+function createAgentBuilderWorkerConfig(options) {
+  const compatibilityDate = options.compatibilityDate ?? DEFAULT_AGENTBUILDER_COMPATIBILITY_DATE;
+  return {
+    // This object is the generated Cloudflare Worker config for customer apps.
+    // Future agents: update this instead of reintroducing wrangler.jsonc in the
+    // generated project template. Customer repos should only need builder()
+    // in vite.config.ts plus their agents/ source tree.
+    main: options.workerEntry,
+    compatibility_date: compatibilityDate,
+    compatibility_flags: ["nodejs_compat", "enable_ctx_exports"],
+    observability: {
+      enabled: true
+    },
+    worker_loaders: [
+      {
+        binding: "AGENT_BUILDER_CODE_LOADER"
+      }
+    ],
+    vars: {
+      // Future agents: keep this aligned with compatibility_date unless code
+      // execution needs a deliberately different Dynamic Worker date.
+      AGENT_BUILDER_CODE_COMPATIBILITY_DATE: compatibilityDate
+    },
+    assets: {
+      // The builder's client UI is emitted as Vite assets and then wrapped by
+      // the hosted platform when deploying through Workers for Platforms.
+      directory: "dist/client",
+      not_found_handling: "single-page-application",
+      binding: "ASSETS",
+      run_worker_first: ["/**"]
+    },
+    durable_objects: {
+      bindings: [
+        {
+          name: "AGENT_BUILDER_THREAD",
+          class_name: "DurableThread"
+        },
+        {
+          name: "AGENT_BUILDER",
+          class_name: "DurableAgentBuilder"
+        }
+      ]
+    },
+    migrations: [
+      {
+        tag: "v1",
+        new_sqlite_classes: ["DurableThread"]
+      },
+      {
+        tag: "v2",
+        new_sqlite_classes: ["DurableAgentBuilder"]
+      }
+    ]
+  };
+}
+function applyAgentBuilderWorkerConfig(config, options) {
+  const generated = createAgentBuilderWorkerConfig(options);
+  const existingVars = config.vars && typeof config.vars === "object" ? config.vars : {};
+  Object.assign(config, generated);
+  config.vars = {
+    ...existingVars,
+    ...generated.vars ?? {}
+  };
+}
+function createAgentBuilderCloudflarePlugins(options) {
+  return cloudflare({
+    config(config) {
+      applyAgentBuilderWorkerConfig(config, options);
+    }
+  });
+}
 function applyPluginEnvironmentConfig(config) {
   config.optimizeDeps = config.optimizeDeps || {};
   config.optimizeDeps.exclude = [
@@ -7733,13 +7777,6 @@ function applyPluginEnvironmentConfig(config) {
 
 // src/plugin.ts
 function agentbuilder(options = {}) {
-  let mountPoint = options.mountPoint || "/agents";
-  if (!mountPoint.startsWith("/")) {
-    mountPoint = "/" + mountPoint;
-  }
-  if (mountPoint.endsWith("/") && mountPoint.length > 1) {
-    mountPoint = mountPoint.slice(0, -1);
-  }
   const toolsDir = options.toolsDir ? path8__default.resolve(process.cwd(), options.toolsDir) : path8__default.resolve(process.cwd(), "agents/tools");
   const hooksDir = options.hooksDir ? path8__default.resolve(process.cwd(), options.hooksDir) : path8__default.resolve(process.cwd(), "agents/hooks");
   const threadApiDir = options.apiDir ? path8__default.resolve(process.cwd(), options.apiDir) : path8__default.resolve(process.cwd(), "agents/api");
@@ -7748,6 +7785,7 @@ function agentbuilder(options = {}) {
   const agentsDir = options.agentsDir ? path8__default.resolve(process.cwd(), options.agentsDir) : path8__default.resolve(process.cwd(), "agents/agents");
   const effectsDir = options.effectsDir ? path8__default.resolve(process.cwd(), options.effectsDir) : path8__default.resolve(process.cwd(), "agents/effects");
   const outputDir = path8__default.resolve(process.cwd(), ".agents");
+  const generatedWorkerEntry = path8__default.join(outputDir, "worker.ts");
   const installedProviders = buildInstalledProviderCatalog(options.providers || []);
   const installedProviderPackageMap = buildProviderPackageMap(options.providers || []);
   const typeGenConfig = {
@@ -7763,6 +7801,25 @@ function agentbuilder(options = {}) {
       generateTypes(typeGenConfig);
     }
   }
+  function writeGeneratedWorkerEntry() {
+    const content = `// Generated by @standardagents/builder.
+// Future agents: update builder/src/plugin.ts when changing this entrypoint.
+import { CodeExecutionBridge, DurableAgentBuilder, DurableThread, router } from "virtual:@standardagents/builder";
+
+export default {
+  async fetch(request: Request, env: Parameters<typeof router>[1]) {
+    const response = await router(request, env);
+    return response ?? new Response(null, { status: 404 });
+  },
+};
+
+export { CodeExecutionBridge, DurableAgentBuilder, DurableThread };
+`;
+    fs8__default.mkdirSync(outputDir, { recursive: true });
+    if (!fs8__default.existsSync(generatedWorkerEntry) || fs8__default.readFileSync(generatedWorkerEntry, "utf-8") !== content) {
+      fs8__default.writeFileSync(generatedWorkerEntry, content);
+    }
+  }
   const __filename = fileURLToPath(import.meta.url);
   const __dirname = path8__default.dirname(__filename);
   const rou3Path = path8__default.join(__dirname, "../dist/rou3.js");
@@ -7783,7 +7840,6 @@ function agentbuilder(options = {}) {
     effectsDir
   };
   const virtualModuleContext = {
-    mountPoint,
     toolsDir,
     hooksDir,
     threadApiDir,
@@ -7796,7 +7852,6 @@ function agentbuilder(options = {}) {
     hmr
   };
   const devMiddlewareContext = {
-    mountPoint,
     toolsDir,
     hooksDir,
     modelsDir,
@@ -7808,11 +7863,14 @@ function agentbuilder(options = {}) {
     sourceDirs,
     regenerateTypes
   };
-  return {
+  const workerEntry = path8__default.relative(process.cwd(), generatedWorkerEntry).split(path8__default.sep).join("/");
+  const corePlugin = {
     name: "vite-plugin-agent",
     enforce: "pre",
     config() {
-      return createPluginViteConfig(import.meta.url);
+      writeGeneratedWorkerEntry();
+      const viteConfig = createPluginViteConfig(import.meta.url);
+      return viteConfig;
     },
     // Apply exclusions and inclusions to ALL environments including Cloudflare worker
     configEnvironment(_name, config) {
@@ -7860,6 +7918,7 @@ function agentbuilder(options = {}) {
       return loadVirtualModule(id, virtualModuleContext);
     },
     buildStart() {
+      writeGeneratedWorkerEntry();
       regenerateTypes();
       this.addWatchFile(toolsDir);
       this.addWatchFile(threadApiDir);
@@ -7877,8 +7936,7 @@ function agentbuilder(options = {}) {
     },
     writeBundle(options2, bundle) {
       const outDir = options2.dir || "dist";
-      const mountPath = mountPoint.slice(1);
-      const mountDir = mountPath ? path8__default.join(outDir, "../client", mountPath) : path8__default.join(outDir, "../client");
+      const mountDir = path8__default.join(outDir, "../client");
       const currentDir = path8__default.dirname(fileURLToPath(import.meta.url));
       const isInDist = currentDir.endsWith("dist");
       const clientDir = path8__default.resolve(
@@ -7901,10 +7959,9 @@ function agentbuilder(options = {}) {
           } else {
             let content = fs8__default.readFileSync(srcPath);
             if (entry.name === "index.html") {
-              const configScript = `<script>window.__AGENTBUILDER_CONFIG__ = { mountPoint: "${mountPoint}" };</script>`;
+              const configScript = `<script>window.__AGENTBUILDER_CONFIG__ = {};</script>`;
               let htmlContent = content.toString();
-              const assetPrefix = mountPoint === "/" ? "/" : `${mountPoint}/`;
-              htmlContent = htmlContent.replace(/\/agents\//g, assetPrefix);
+              htmlContent = htmlContent.replace(/\/agents\//g, "/");
               htmlContent = htmlContent.replace("</head>", `${configScript}</head>`);
               content = Buffer.from(htmlContent);
             }
@@ -7915,8 +7972,16 @@ function agentbuilder(options = {}) {
       copyRecursive(clientDir, mountDir);
     }
   };
+  return [
+    corePlugin,
+    ...createAgentBuilderCloudflarePlugins({
+      workerEntry,
+      compatibilityDate: options.compatibilityDate ?? DEFAULT_AGENTBUILDER_COMPATIBILITY_DATE
+    })
+  ];
 }
+var builder = agentbuilder;
 
-export { agentbuilder };
+export { agentbuilder, builder };
 //# sourceMappingURL=plugin.js.map
 //# sourceMappingURL=plugin.js.map