@standardagents/builder 0.12.9 → 0.13.0-next.c55f029

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-pLkJx8vg.js';
-export { D as DiscoveredPackage } from './types-pLkJx8vg.js';
-export { P as PackageDiscoveryService, d as discoverPackages } from './discovery-CpMs68Yx.js';
+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 '@standardagents/spec';
 
 /**
@@ -57,6 +57,36 @@ declare class PackingService {
         generatedReadme: string;
         agentDescription?: string;
     }>;
+    /**
+     * Analyze thread endpoints from agents/api and include them as packed constituents.
+     *
+     * Thread endpoints are not directly referenced by agent/prompt definitions, so we
+     * include all endpoint modules discovered under agents/api.
+     */
+    private analyzeThreadEndpoints;
+    /**
+     * Recursively scan agents/api for endpoint source files.
+     *
+     * Returns endpoint keys like:
+     * - `status.get`
+     * - `admin/users/[userId]/sync.post`
+     */
+    private scanThreadEndpointFiles;
+    /**
+     * Analyze effects from agents/effects and include them as packed constituents.
+     *
+     * Effects are referenced by string names at runtime via scheduleEffect(), so we
+     * include all effect modules discovered under agents/effects.
+     */
+    private analyzeEffects;
+    /**
+     * Recursively scan agents/effects for effect source files.
+     *
+     * Returns effect keys like:
+     * - `send_email`
+     * - `notifications/digest`
+     */
+    private scanEffectFiles;
     /**
      * Recursively analyze a prompt and its dependencies.
      */
@@ -87,6 +117,8 @@ declare class PackingService {
      *
      * The packing format creates:
      * - dist/{type}/{name}.js - Individual bundled files per constituent
+     * - dist/effects/** - Packed effect modules
+     * - dist/thread-endpoints/** - Packed thread endpoint modules
      * - dist/index.js - Re-exports and lazy loaders
      * - dist/index.d.ts - TypeScript type definitions
      * - package.json - With standardagent field and dependencies

package/dist/packing.js

@@ -533,13 +533,17 @@ var PackingService = class {
         tools: [],
         models: [],
         hooks: [],
-        agents: []
+        effects: [],
+        agents: [],
+        threadEndpoints: []
       },
       shared: {
         prompts: [],
         tools: [],
         models: [],
-        hooks: []
+        hooks: [],
+        effects: [],
+        threadEndpoints: []
       },
       warnings: [],
       errors: []
@@ -564,6 +568,8 @@ var PackingService = class {
     if (agentPrompts.sideB) {
       await this.analyzePrompt(agentPrompts.sideB, agentsDir, analysis, /* @__PURE__ */ new Set(), `agent:${agentName}`);
     }
+    await this.analyzeThreadEndpoints(agentsDir, analysis);
+    await this.analyzeEffects(agentsDir, analysis);
     await this.checkSharedItems(agentsDir, analysis);
     return analysis;
   }
@@ -601,6 +607,138 @@ var PackingService = class {
     );
     return { generatedReadme, agentDescription };
   }
+  /**
+   * Analyze thread endpoints from agents/api and include them as packed constituents.
+   *
+   * Thread endpoints are not directly referenced by agent/prompt definitions, so we
+   * include all endpoint modules discovered under agents/api.
+   */
+  async analyzeThreadEndpoints(agentsDir, analysis) {
+    const apiDir = path2.join(agentsDir, "api");
+    const endpoints = this.scanThreadEndpointFiles(apiDir);
+    for (const endpoint of endpoints) {
+      if (analysis.constituents.threadEndpoints.some((item) => item.name === endpoint.name)) {
+        continue;
+      }
+      analysis.constituents.threadEndpoints.push({
+        name: endpoint.name,
+        filePath: endpoint.filePath,
+        discoveredVia: "thread-endpoint",
+        sharedWith: []
+      });
+    }
+  }
+  /**
+   * Recursively scan agents/api for endpoint source files.
+   *
+   * Returns endpoint keys like:
+   * - `status.get`
+   * - `admin/users/[userId]/sync.post`
+   */
+  scanThreadEndpointFiles(apiDir, relativeDir = "") {
+    if (!fs2.existsSync(apiDir)) {
+      return [];
+    }
+    const endpoints = [];
+    const currentDir = relativeDir ? path2.join(apiDir, relativeDir) : apiDir;
+    if (!fs2.existsSync(currentDir)) {
+      return endpoints;
+    }
+    const entries = fs2.readdirSync(currentDir, { withFileTypes: true });
+    if (entries.length > 0 && typeof entries[0] === "string") {
+      return endpoints;
+    }
+    for (const entry of entries) {
+      const entryName = typeof entry === "string" ? entry : entry.name;
+      const isDirectory = typeof entry === "string" ? false : entry.isDirectory();
+      const isFile = typeof entry === "string" ? true : entry.isFile();
+      const entryRelative = relativeDir ? path2.posix.join(relativeDir.replace(/\\/g, "/"), entryName) : entryName;
+      const absolutePath = path2.join(apiDir, entryRelative);
+      if (isDirectory) {
+        endpoints.push(...this.scanThreadEndpointFiles(apiDir, entryRelative));
+        continue;
+      }
+      if (!isFile) {
+        continue;
+      }
+      if (!entryName.endsWith(".ts")) {
+        continue;
+      }
+      const endpointKey = entryRelative.replace(/\.ts$/, "").replace(/\\/g, "/");
+      endpoints.push({
+        name: endpointKey,
+        filePath: absolutePath
+      });
+    }
+    endpoints.sort((a, b) => a.name.localeCompare(b.name));
+    return endpoints;
+  }
+  /**
+   * Analyze effects from agents/effects and include them as packed constituents.
+   *
+   * Effects are referenced by string names at runtime via scheduleEffect(), so we
+   * include all effect modules discovered under agents/effects.
+   */
+  async analyzeEffects(agentsDir, analysis) {
+    const effectsDir = path2.join(agentsDir, "effects");
+    const effects = this.scanEffectFiles(effectsDir);
+    for (const effect of effects) {
+      if (analysis.constituents.effects.some((item) => item.name === effect.name)) {
+        continue;
+      }
+      analysis.constituents.effects.push({
+        name: effect.name,
+        filePath: effect.filePath,
+        discoveredVia: "effect",
+        sharedWith: []
+      });
+    }
+  }
+  /**
+   * Recursively scan agents/effects for effect source files.
+   *
+   * Returns effect keys like:
+   * - `send_email`
+   * - `notifications/digest`
+   */
+  scanEffectFiles(effectsDir, relativeDir = "") {
+    if (!fs2.existsSync(effectsDir)) {
+      return [];
+    }
+    const effects = [];
+    const currentDir = relativeDir ? path2.join(effectsDir, relativeDir) : effectsDir;
+    if (!fs2.existsSync(currentDir)) {
+      return effects;
+    }
+    const entries = fs2.readdirSync(currentDir, { withFileTypes: true });
+    if (entries.length > 0 && typeof entries[0] === "string") {
+      return effects;
+    }
+    for (const entry of entries) {
+      const entryName = typeof entry === "string" ? entry : entry.name;
+      const isDirectory = typeof entry === "string" ? false : entry.isDirectory();
+      const isFile = typeof entry === "string" ? true : entry.isFile();
+      const entryRelative = relativeDir ? path2.posix.join(relativeDir.replace(/\\/g, "/"), entryName) : entryName;
+      const absolutePath = path2.join(effectsDir, entryRelative);
+      if (isDirectory) {
+        effects.push(...this.scanEffectFiles(effectsDir, entryRelative));
+        continue;
+      }
+      if (!isFile || !entryName.endsWith(".ts")) {
+        continue;
+      }
+      if (entryName === "CLAUDE.md" || entryName === "AGENTS.md" || entryName.startsWith("_")) {
+        continue;
+      }
+      const effectKey = entryRelative.replace(/\.ts$/, "").replace(/\\/g, "/");
+      effects.push({
+        name: effectKey,
+        filePath: absolutePath
+      });
+    }
+    effects.sort((a, b) => a.name.localeCompare(b.name));
+    return effects;
+  }
   /**
    * Recursively analyze a prompt and its dependencies.
    */
@@ -824,6 +962,8 @@ var PackingService = class {
    *
    * The packing format creates:
    * - dist/{type}/{name}.js - Individual bundled files per constituent
+   * - dist/effects/** - Packed effect modules
+   * - dist/thread-endpoints/** - Packed thread endpoint modules
    * - dist/index.js - Re-exports and lazy loaders
    * - dist/index.d.ts - TypeScript type definitions
    * - package.json - With standardagent field and dependencies
@@ -876,6 +1016,8 @@ var PackingService = class {
       fs2.mkdirSync(path2.join(pkgOutputDir, "dist", "tools"), { recursive: true });
       fs2.mkdirSync(path2.join(pkgOutputDir, "dist", "models"), { recursive: true });
       fs2.mkdirSync(path2.join(pkgOutputDir, "dist", "hooks"), { recursive: true });
+      fs2.mkdirSync(path2.join(pkgOutputDir, "dist", "effects"), { recursive: true });
+      fs2.mkdirSync(path2.join(pkgOutputDir, "dist", "thread-endpoints"), { recursive: true });
       const seenItems = /* @__PURE__ */ new Set();
       const allItems = [];
       for (const a of analysis.constituents.agents) {
@@ -913,6 +1055,20 @@ var PackingService = class {
           allItems.push({ ...h, type: "hook" });
         }
       }
+      for (const effect of analysis.constituents.effects) {
+        const key = `effect:${effect.name}`;
+        if (!seenItems.has(key)) {
+          seenItems.add(key);
+          allItems.push({ ...effect, type: "effect" });
+        }
+      }
+      for (const endpoint of analysis.constituents.threadEndpoints) {
+        const key = `thread-endpoint:${endpoint.name}`;
+        if (!seenItems.has(key)) {
+          seenItems.add(key);
+          allItems.push({ ...endpoint, type: "thread-endpoint" });
+        }
+      }
       const externalDeps = /* @__PURE__ */ new Map();
       for (const item of allItems) {
         const outputPath = path2.join(
@@ -921,6 +1077,7 @@ var PackingService = class {
           this.getTypeDir(item.type),
           `${item.name}.js`
         );
+        fs2.mkdirSync(path2.dirname(outputPath), { recursive: true });
         const deps = await this.bundleFile(item.filePath, outputPath, rootDir);
         for (const [depName, depVersion] of deps) {
           if (!externalDeps.has(depName)) {
@@ -941,6 +1098,8 @@ var PackingService = class {
         finalPackageName,
         version,
         agentName,
+        this.deduplicateConstituents(analysis).effects.map((effect) => effect.name),
+        this.deduplicateConstituents(analysis).threadEndpoints.map((endpoint) => endpoint.name),
         externalDeps,
         rootDir,
         license,
@@ -978,7 +1137,7 @@ var PackingService = class {
         result.filesRemoved = [];
         for (const item of allItems) {
           const selection = itemSelections?.find((s) => s.name === item.name && s.type === item.type);
-          const shouldRemove = selection ? selection.mode === "extract" : removeOriginals && item.sharedWith.length === 0;
+          const shouldRemove = selection ? selection.mode === "extract" : removeOriginals && item.sharedWith.length === 0 && item.type !== "thread-endpoint" && item.type !== "effect";
           if (shouldRemove && fs2.existsSync(item.filePath)) {
             fs2.unlinkSync(item.filePath);
             result.filesRemoved.push(item.filePath);
@@ -1111,6 +1270,10 @@ var PackingService = class {
         return "models";
       case "hook":
         return "hooks";
+      case "effect":
+        return "effects";
+      case "thread-endpoint":
+        return "thread-endpoints";
     }
   }
   /**
@@ -1130,7 +1293,9 @@ var PackingService = class {
       prompts: dedupe(analysis.constituents.prompts),
       tools: dedupe(analysis.constituents.tools),
       models: dedupe(analysis.constituents.models),
-      hooks: dedupe(analysis.constituents.hooks)
+      hooks: dedupe(analysis.constituents.hooks),
+      effects: dedupe(analysis.constituents.effects),
+      threadEndpoints: dedupe(analysis.constituents.threadEndpoints)
     };
   }
   /**
@@ -1175,6 +1340,9 @@ var PackingService = class {
     for (const hook of constituents.hooks) {
       lines.push(`export { default as ${this.quoteName(hook.name)} } from './hooks/${hook.name}.js';`);
     }
+    for (const effect of constituents.effects) {
+      lines.push(`export { default as ${this.quoteName(effect.name)} } from './effects/${effect.name}.js';`);
+    }
     lines.push("");
     lines.push("// Registry exports for lazy loading");
     lines.push("export const agents = {");
@@ -1207,6 +1375,18 @@ var PackingService = class {
     }
     lines.push("};");
     lines.push("");
+    lines.push("export const effects = {");
+    for (const effect of constituents.effects) {
+      lines.push(`  ${this.quoteName(effect.name)}: async () => (await import('./effects/${effect.name}.js')).default,`);
+    }
+    lines.push("};");
+    lines.push("");
+    lines.push("export const threadEndpoints = {");
+    for (const endpoint of constituents.threadEndpoints) {
+      lines.push(`  ${this.quoteName(endpoint.name)}: async () => (await import('./thread-endpoints/${endpoint.name}.js')).default,`);
+    }
+    lines.push("};");
+    lines.push("");
     lines.push("export const __meta = " + JSON.stringify(meta, null, 2) + ";");
     lines.push("");
     return lines.join("\n");
@@ -1222,6 +1402,9 @@ var PackingService = class {
       "  PromptDefinition,",
       "  ToolDefinition,",
       "  ModelDefinition,",
+      "  EffectDefinition,",
+      "  Controller,",
+      "  MarkedThreadEndpoint,",
       "  PackedMeta,",
       "} from '@standardagents/spec';",
       "",
@@ -1253,6 +1436,11 @@ var PackingService = class {
         lines.push(`export declare const ${hook.name}: unknown;`);
       }
     }
+    for (const effect of constituents.effects) {
+      if (this.isValidIdentifier(effect.name)) {
+        lines.push(`export declare const ${effect.name}: EffectDefinition<any, any>;`);
+      }
+    }
     lines.push("");
     lines.push("export declare const agents: {");
     for (const agent of constituents.agents) {
@@ -1284,6 +1472,18 @@ var PackingService = class {
     }
     lines.push("};");
     lines.push("");
+    lines.push("export declare const effects: {");
+    for (const effect of constituents.effects) {
+      lines.push(`  readonly ${this.quoteName(effect.name)}: DefinitionLoader<EffectDefinition<any, any>>;`);
+    }
+    lines.push("};");
+    lines.push("");
+    lines.push("export declare const threadEndpoints: {");
+    for (const endpoint of constituents.threadEndpoints) {
+      lines.push(`  readonly ${this.quoteName(endpoint.name)}: DefinitionLoader<MarkedThreadEndpoint | Controller>;`);
+    }
+    lines.push("};");
+    lines.push("");
     lines.push("export declare const __meta: PackedMeta;");
     lines.push("");
     return lines.join("\n");
@@ -1291,7 +1491,7 @@ var PackingService = class {
   /**
    * Generate the package.json file with dependencies.
    */
-  generatePackageJson(packageName, version, agentName, externalDeps, rootDir, license, licenseOwner) {
+  generatePackageJson(packageName, version, agentName, effects, threadEndpoints, externalDeps, rootDir, license, licenseOwner) {
     const dependencies = {
       "@standardagents/spec": this.resolvePackageVersion("@standardagents/spec", rootDir)
     };
@@ -1312,7 +1512,9 @@ var PackingService = class {
       },
       keywords: ["standardagent"],
       standardagent: {
-        entryAgents: [agentName]
+        entryAgents: [agentName],
+        ...effects.length > 0 ? { effects } : {},
+        ...threadEndpoints.length > 0 ? { threadEndpoints } : {}
       },
       files: license ? ["dist", "LICENSE", "README.md"] : ["dist", "README.md"],
       dependencies
@@ -1696,12 +1898,16 @@ var PackageDiscoveryService = class {
       if (!pkgJson.standardagent?.entryAgents) {
         return null;
       }
+      const effects = Array.isArray(pkgJson.standardagent.effects) && pkgJson.standardagent.effects.every((effectName) => typeof effectName === "string") ? pkgJson.standardagent.effects : void 0;
+      const threadEndpoints = Array.isArray(pkgJson.standardagent.threadEndpoints) && pkgJson.standardagent.threadEndpoints.every((endpoint) => typeof endpoint === "string") ? pkgJson.standardagent.threadEndpoints : void 0;
       return {
         packageId: pkgJson.name || pkgName,
         version: pkgJson.version || "0.0.0",
         source: "npm",
         path: pkgDir,
         entryAgents: pkgJson.standardagent.entryAgents,
+        ...effects ? { effects } : {},
+        ...threadEndpoints ? { threadEndpoints } : {},
         description: pkgJson.description
       };
     } catch (error) {
@@ -1761,12 +1967,16 @@ var PackageDiscoveryService = class {
       if (!pkgJson.standardagent?.entryAgents) {
         return null;
       }
+      const effects = Array.isArray(pkgJson.standardagent.effects) && pkgJson.standardagent.effects.every((effectName) => typeof effectName === "string") ? pkgJson.standardagent.effects : void 0;
+      const threadEndpoints = Array.isArray(pkgJson.standardagent.threadEndpoints) && pkgJson.standardagent.threadEndpoints.every((endpoint) => typeof endpoint === "string") ? pkgJson.standardagent.threadEndpoints : void 0;
       return {
         packageId: pkgJson.name || dirName,
         version: pkgJson.version || "0.0.0",
         source: "local",
         path: pkgDir,
         entryAgents: pkgJson.standardagent.entryAgents,
+        ...effects ? { effects } : {},
+        ...threadEndpoints ? { threadEndpoints } : {},
         description: pkgJson.description
       };
     } catch (error) {
@@ -1792,7 +2002,10 @@ var PackageDiscoveryService = class {
       return false;
     }
     const f = field;
-    return Array.isArray(f.entryAgents) && f.entryAgents.length > 0 && f.entryAgents.every((e) => typeof e === "string");
+    const hasValidEntryAgents = Array.isArray(f.entryAgents) && f.entryAgents.length > 0 && f.entryAgents.every((e) => typeof e === "string");
+    const hasValidEffects = f.effects === void 0 || Array.isArray(f.effects) && f.effects.every((effectName) => typeof effectName === "string");
+    const hasValidThreadEndpoints = f.threadEndpoints === void 0 || Array.isArray(f.threadEndpoints) && f.threadEndpoints.every((endpoint) => typeof endpoint === "string");
+    return hasValidEntryAgents && hasValidEffects && hasValidThreadEndpoints;
   }
   /**
    * Get a package by ID.
@@ -1827,7 +2040,27 @@ var TYPE_TO_DIR = {
   prompt: "prompts",
   tool: "tools",
   model: "models",
-  hook: "hooks"
+  hook: "hooks",
+  effect: "effects",
+  "thread-endpoint": "thread-endpoints"
+};
+var TYPE_TO_TARGET_DIR = {
+  agent: "agents",
+  prompt: "prompts",
+  tool: "tools",
+  model: "models",
+  hook: "hooks",
+  effect: "effects",
+  "thread-endpoint": "api"
+};
+var TYPE_TO_REGISTRY_NAME = {
+  agent: "agents",
+  prompt: "prompts",
+  tool: "tools",
+  model: "models",
+  hook: "hooks",
+  effect: "effects",
+  "thread-endpoint": "threadEndpoints"
 };
 var UnpackingService = class {
   /**
@@ -1869,7 +2102,7 @@ var UnpackingService = class {
       const agentsDir = path2.join(rootDir, "agents");
       const itemsWithRelations = [];
       for (const item of registryItems) {
-        const targetPath = path2.join(agentsDir, TYPE_TO_DIR[item.type], `${item.name}.ts`);
+        const targetPath = path2.join(agentsDir, TYPE_TO_TARGET_DIR[item.type], `${item.name}.ts`);
         const sourcePath = path2.join(pkg.path, "dist", TYPE_TO_DIR[item.type], `${item.name}.js`);
         const existsGlobally = this.fileExists(targetPath);
         const sourceExists = fs2.existsSync(sourcePath);
@@ -1887,7 +2120,7 @@ var UnpackingService = class {
           action: existsGlobally ? "skip" : "generate"
         });
         for (const child of children) {
-          const childTargetPath = path2.join(agentsDir, TYPE_TO_DIR[child.type], `${child.name}.ts`);
+          const childTargetPath = path2.join(agentsDir, TYPE_TO_TARGET_DIR[child.type], `${child.name}.ts`);
           const childSourcePath = path2.join(pkg.path, "dist", TYPE_TO_DIR[child.type], `${child.name}.js`);
           const childExists = this.fileExists(childTargetPath);
           const childSourceExists = fs2.existsSync(childSourcePath);
@@ -2074,7 +2307,7 @@ var UnpackingService = class {
       true
     );
     const items = [];
-    const registryTypes = ["agent", "prompt", "tool", "model", "hook"];
+    const registryTypes = ["agent", "prompt", "tool", "model", "hook", "effect", "thread-endpoint"];
     function visit(node) {
       if (ts.isVariableStatement(node) && node.modifiers?.some((m) => m.kind === ts.SyntaxKind.ExportKeyword)) {
         for (const decl of node.declarationList.declarations) {
@@ -2082,7 +2315,7 @@ var UnpackingService = class {
           const varName = decl.name.text;
           let itemType = null;
           for (const type of registryTypes) {
-            if (varName === TYPE_TO_DIR[type]) {
+            if (varName === TYPE_TO_REGISTRY_NAME[type]) {
               itemType = type;
               break;
             }