@standardagents/builder 0.29.2 → 0.30.0

package/dist/plugin.d.ts

@@ -5,6 +5,7 @@ interface AgentPluginOptions {
     toolsDir?: string;
     hooksDir?: string;
     apiDir?: string;
+    usersDir?: string;
     modelsDir?: string;
     providersDir?: string;
     promptsDir?: string;

package/dist/plugin.js

@@ -1186,8 +1186,9 @@ function createHmrReloader() {
       const isPromptFile = file.startsWith(dirs.promptsDir) && file.endsWith(".ts");
       const isAgentFile = file.startsWith(dirs.agentsDir) && file.endsWith(".ts");
       const isEffectFile = file.startsWith(dirs.effectsDir) && file.endsWith(".ts");
+      const isUserEndpointFile = file.startsWith(dirs.usersDir) && file.endsWith(".ts");
       const isConfigFile = isModelFile || isProviderFile || isPromptFile || isAgentFile || isEffectFile;
-      if (!isToolFile && !isThreadApiFile && !isHookFile && !isConfigFile) return;
+      if (!isToolFile && !isThreadApiFile && !isHookFile && !isConfigFile && !isUserEndpointFile) return;
       reloader.invalidateSourceFileModule(server, file);
       if (isConfigFile || isToolFile) regenerateTypes();
       if (isToolFile) await reloader.reloadToolsModule(server);
@@ -3213,6 +3214,35 @@ function parseRequestBody(req) {
     req.on("error", reject);
   });
 }
+function scanUsersDirectory(dir) {
+  const results = [];
+  if (!fs8__default.existsSync(dir)) return results;
+  const walk = (current, prefix) => {
+    let entries;
+    try {
+      entries = fs8__default.readdirSync(current, { withFileTypes: true });
+    } catch (error) {
+      console.error(`Error scanning users directory ${current}:`, error);
+      return;
+    }
+    for (const entry of entries) {
+      const fullPath = path8__default.join(current, entry.name);
+      if (entry.isDirectory()) {
+        walk(fullPath, prefix ? `${prefix}/${entry.name}` : entry.name);
+        continue;
+      }
+      if (!entry.name.endsWith(".ts") || entry.name.endsWith(".d.ts")) continue;
+      const base = entry.name.slice(0, -3);
+      const key = prefix ? `${prefix}/${base}` : base;
+      results.push({
+        key,
+        importPath: "./" + path8__default.relative(process.cwd(), fullPath).replace(/\\/g, "/")
+      });
+    }
+  };
+  walk(dir, "");
+  return results;
+}
 
 // src/plugin/agent-api-middleware.ts
 async function handleAgentApiRequest(context) {
@@ -6806,9 +6836,10 @@ function createDevMiddleware(server, context) {
   });
 }
 async function loadBuilderVirtualModule(context) {
-  const { toolsDir, hooksDir, modelsDir, promptsDir, agentsDir, effectsDir, hmr } = context;
+  const { toolsDir, hooksDir, modelsDir, promptsDir, agentsDir, effectsDir, usersDir, hmr } = context;
   const tools = await scanToolsDirectory(toolsDir);
   const hooks = await scanHooksDirectory(hooksDir);
+  const userEndpoints = scanUsersDirectory(usersDir);
   const models = await scanModelsDirectory(modelsDir);
   const prompts = await scanPromptsDirectory(promptsDir);
   const agents = await scanAgentsDirectory(agentsDir);
@@ -6910,6 +6941,17 @@ async function loadBuilderVirtualModule(context) {
   },`;
     }
   }).join("\n");
+  const userEndpointsCode = userEndpoints.map(({ key, importPath }) => {
+    const absPath = toAbsolutePath(importPath);
+    return `  "${key}": async () => {
+    try {
+      return (await import("${absPath}")).default;
+    } catch (error) {
+      console.error('Failed to import user endpoint ${key}:', error);
+      throw error;
+    }
+  },`;
+  }).join("\n");
   return `// Consolidated virtual module: virtual:@standardagents/builder /* v${hmr.versions.builder} */
 // Provides DurableThread, DurableAgentBuilder, ThreadWatchdog, and router
 import { DurableThread as _BaseDurableThread } from '@standardagents/builder/runtime';
@@ -6955,6 +6997,10 @@ const _effects = {
 ${effectsCode}
 };
 
+const _userEndpoints = {
+${userEndpointsCode}
+};
+
 /**
  * DurableThread with all virtual module methods already implemented.
  * Exported by the generated AgentBuilder Worker entry; user projects do not
@@ -7044,10 +7090,21 @@ export class CodeExecutionBridge extends _BaseCodeExecutionBridge {}
 export class ThreadWatchdog extends _BaseThreadWatchdog {}
 
 /**
- * Per-user hub companion. Coordination only (persistent daemon socket, wake
- * signal, sharded account KV); needs no virtual-module registries.
+ * Per-user hub companion: persistent daemon socket, wake signal, sharded
+ * account KV \u2014 and the USER SCOPE (spec: Users): packaged user endpoints from
+ * the users/ directory executed under per-user serialization, the user event
+ * stream, and user lifecycle hooks (filtered from the shared hooks registry
+ * by hook type at dispatch).
  */
-export class DurableUserHub extends _BaseDurableUserHub {}
+export class DurableUserHub extends _BaseDurableUserHub {
+  userEndpoints() {
+    return _userEndpoints;
+  }
+
+  userHooks() {
+    return _hooks;
+  }
+}
 `;
 }
 async function loadRegistryVirtualModule(context) {
@@ -8103,6 +8160,7 @@ function agentbuilder(options = {}) {
   const promptsDir = options.promptsDir ? path8__default.resolve(process.cwd(), options.promptsDir) : path8__default.resolve(process.cwd(), "agents/prompts");
   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 usersDir = options.usersDir ? path8__default.resolve(process.cwd(), options.usersDir) : path8__default.resolve(process.cwd(), "agents/users");
   const outputDir = path8__default.resolve(process.cwd(), ".agents");
   const generatedWorkerEntry = path8__default.join(outputDir, "worker.ts");
   const isProviderPackageInstalled = (packageName) => {
@@ -8165,6 +8223,7 @@ export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, ThreadWatchdog
     toolsDir,
     hooksDir,
     threadApiDir,
+    usersDir,
     modelsDir,
     providersDir,
     promptsDir,
@@ -8175,6 +8234,7 @@ export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, ThreadWatchdog
     toolsDir,
     hooksDir,
     threadApiDir,
+    usersDir,
     modelsDir,
     providersDir,
     promptsDir,
@@ -8262,6 +8322,7 @@ export { CodeExecutionBridge, DurableAgentBuilder, DurableThread, ThreadWatchdog
       this.addWatchFile(promptsDir);
       this.addWatchFile(agentsDir);
       this.addWatchFile(effectsDir);
+      this.addWatchFile(usersDir);
     },
     configureServer(server) {
       createDevMiddleware(server, devMiddlewareContext);