@monoes/cli 1.0.0

package/bin/cli.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+/**
+ * @monobrain/cli - CLI Entry Point
+ *
+ * Monobrain Command Line Interface
+ *
+ * Auto-detects MCP mode when stdin is piped and no args provided.
+ * This allows: echo '{"jsonrpc":"2.0",...}' | npx @monobrain/cli
+ */
+
+import { randomUUID } from 'crypto';
+
+// Check if we should run in MCP server mode
+// Conditions:
+//   1. stdin is being piped AND no CLI arguments provided (auto-detect)
+//   2. stdin is being piped AND args are "mcp start" (explicit, e.g. npx monobrain@alpha mcp start)
+const cliArgs = process.argv.slice(2);
+const isExplicitMCP = cliArgs.length >= 1 && cliArgs[0] === 'mcp' && (cliArgs.length === 1 || cliArgs[1] === 'start');
+const isMCPMode = !process.stdin.isTTY && (process.argv.length === 2 || isExplicitMCP);
+
+if (isMCPMode) {
+  // Run MCP server mode
+  const { listMCPTools, callMCPTool, hasTool } = await import('../dist/src/mcp-client.js');
+
+  const VERSION = '3.0.0';
+  const sessionId = `mcp-${Date.now()}-${randomUUID().slice(0, 8)}`;
+
+  console.error(
+    `[${new Date().toISOString()}] INFO [monobrain-mcp] (${sessionId}) Starting in stdio mode`
+  );
+
+  let buffer = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', async (chunk) => {
+    buffer += chunk;
+    let lines = buffer.split('\n');
+    buffer = lines.pop() || '';
+
+    for (const line of lines) {
+      if (line.trim()) {
+        try {
+          const message = JSON.parse(line);
+          const response = await handleMessage(message);
+          if (response) {
+            console.log(JSON.stringify(response));
+          }
+        } catch (error) {
+          console.log(JSON.stringify({
+            jsonrpc: '2.0',
+            id: null,
+            error: { code: -32700, message: 'Parse error' },
+          }));
+        }
+      }
+    }
+  });
+
+  process.stdin.on('end', () => {
+    process.exit(0);
+  });
+
+  async function handleMessage(message) {
+    if (!message.method) {
+      return {
+        jsonrpc: '2.0',
+        id: message.id,
+        error: { code: -32600, message: 'Invalid Request: missing method' },
+      };
+    }
+
+    const params = message.params || {};
+
+    switch (message.method) {
+      case 'initialize':
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {
+            protocolVersion: '2024-11-05',
+            serverInfo: { name: 'monobrain', version: VERSION },
+            capabilities: {
+              tools: { listChanged: true },
+              resources: { subscribe: true, listChanged: true },
+            },
+          },
+        };
+
+      case 'tools/list': {
+        const tools = listMCPTools();
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {
+            tools: tools.map(tool => ({
+              name: tool.name,
+              description: tool.description,
+              inputSchema: tool.inputSchema,
+            })),
+          },
+        };
+      }
+
+      case 'tools/call': {
+        const toolName = params.name;
+        const toolParams = params.arguments || {};
+
+        if (!hasTool(toolName)) {
+          return {
+            jsonrpc: '2.0',
+            id: message.id,
+            error: { code: -32601, message: `Tool not found: ${toolName}` },
+          };
+        }
+
+        try {
+          const result = await callMCPTool(toolName, toolParams, { sessionId });
+          return {
+            jsonrpc: '2.0',
+            id: message.id,
+            result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] },
+          };
+        } catch (error) {
+          return {
+            jsonrpc: '2.0',
+            id: message.id,
+            error: {
+              code: -32603,
+              message: error instanceof Error ? error.message : 'Tool execution failed',
+            },
+          };
+        }
+      }
+
+      case 'notifications/initialized':
+        return null;
+
+      case 'ping':
+        return { jsonrpc: '2.0', id: message.id, result: {} };
+
+      default:
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          error: { code: -32601, message: `Method not found: ${message.method}` },
+        };
+    }
+  }
+} else {
+  // Run normal CLI mode
+  const { CLI } = await import('../dist/src/index.js');
+  const cli = new CLI();
+  cli.run().catch((error) => {
+    console.error('Fatal error:', error.message);
+    process.exit(1);
+  });
+}

package/bin/mcp-server.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+/**
+ * @monobrain/cli - MCP Server Entry Point
+ *
+ * Direct stdio MCP server for Claude Code integration.
+ * This entry point handles stdin/stdout directly for MCP protocol
+ * without any CLI formatting output that would corrupt the protocol.
+ */
+
+import { randomUUID } from 'crypto';
+import { listMCPTools, callMCPTool, hasTool } from '../dist/src/mcp-client.js';
+
+const VERSION = '3.0.0';
+const sessionId = `mcp-${Date.now()}-${randomUUID().slice(0, 8)}`;
+
+// Log to stderr (doesn't corrupt stdout for MCP protocol)
+console.error(
+  `[${new Date().toISOString()}] INFO [monobrain-mcp] (${sessionId}) Starting in stdio mode`
+);
+console.error(JSON.stringify({
+  arch: process.arch,
+  mode: 'mcp-stdio',
+  nodeVersion: process.version,
+  pid: process.pid,
+  platform: process.platform,
+  protocol: 'stdio',
+  sessionId,
+  version: VERSION,
+}));
+
+// Handle stdin messages
+let buffer = '';
+
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', async (chunk) => {
+  buffer += chunk;
+
+  // Process complete JSON messages (newline-delimited)
+  let lines = buffer.split('\n');
+  buffer = lines.pop() || ''; // Keep incomplete line in buffer
+
+  for (const line of lines) {
+    if (line.trim()) {
+      try {
+        const message = JSON.parse(line);
+        const response = await handleMessage(message);
+        if (response) {
+          console.log(JSON.stringify(response));
+        }
+      } catch (error) {
+        console.error(
+          `[${new Date().toISOString()}] ERROR [monobrain-mcp] Failed to parse:`,
+          error instanceof Error ? error.message : String(error)
+        );
+        // Send parse error response
+        console.log(JSON.stringify({
+          jsonrpc: '2.0',
+          id: null,
+          error: { code: -32700, message: 'Parse error' },
+        }));
+      }
+    }
+  }
+});
+
+process.stdin.on('end', () => {
+  console.error(
+    `[${new Date().toISOString()}] INFO [monobrain-mcp] (${sessionId}) stdin closed, shutting down...`
+  );
+  process.exit(0);
+});
+
+// Handle process termination
+process.on('SIGINT', () => {
+  console.error(`[${new Date().toISOString()}] INFO [monobrain-mcp] Received SIGINT`);
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  console.error(`[${new Date().toISOString()}] INFO [monobrain-mcp] Received SIGTERM`);
+  process.exit(0);
+});
+
+/**
+ * Handle MCP message
+ */
+async function handleMessage(message) {
+  if (!message.method) {
+    return {
+      jsonrpc: '2.0',
+      id: message.id,
+      error: { code: -32600, message: 'Invalid Request: missing method' },
+    };
+  }
+
+  const params = message.params || {};
+
+  try {
+    switch (message.method) {
+      case 'initialize':
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {
+            protocolVersion: '2024-11-05',
+            serverInfo: { name: 'monobrain', version: VERSION },
+            capabilities: {
+              tools: { listChanged: true },
+              resources: { subscribe: true, listChanged: true },
+            },
+          },
+        };
+
+      case 'tools/list': {
+        const tools = listMCPTools();
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {
+            tools: tools.map(tool => ({
+              name: tool.name,
+              description: tool.description,
+              inputSchema: tool.inputSchema,
+            })),
+          },
+        };
+      }
+
+      case 'tools/call': {
+        const toolName = params.name;
+        const toolParams = params.arguments || {};
+
+        if (!hasTool(toolName)) {
+          return {
+            jsonrpc: '2.0',
+            id: message.id,
+            error: { code: -32601, message: `Tool not found: ${toolName}` },
+          };
+        }
+
+        try {
+          const result = await callMCPTool(toolName, toolParams, { sessionId });
+          return {
+            jsonrpc: '2.0',
+            id: message.id,
+            result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] },
+          };
+        } catch (error) {
+          return {
+            jsonrpc: '2.0',
+            id: message.id,
+            error: {
+              code: -32603,
+              message: error instanceof Error ? error.message : 'Tool execution failed',
+            },
+          };
+        }
+      }
+
+      case 'notifications/initialized':
+        console.error(`[${new Date().toISOString()}] INFO [monobrain-mcp] Client initialized`);
+        return null; // No response for notifications
+
+      case 'ping':
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          result: {},
+        };
+
+      default:
+        return {
+          jsonrpc: '2.0',
+          id: message.id,
+          error: { code: -32601, message: `Method not found: ${message.method}` },
+        };
+    }
+  } catch (error) {
+    console.error(`[${new Date().toISOString()}] ERROR [monobrain-mcp] ${message.method}:`, error);
+    return {
+      jsonrpc: '2.0',
+      id: message.id,
+      error: {
+        code: -32603,
+        message: error instanceof Error ? error.message : 'Internal error',
+      },
+    };
+  }
+}

package/bin/preinstall.cjs

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+// Preinstall hook — no-op (cache repair removed in 3.1.0-alpha.53)

package/dist/src/agents/halt-signal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Halt Signal (Task 35)
+ *
+ * JSONL-based broadcast/check for swarm-level halt signals.
+ * When an agent triggers a cascade halt, other agents in the same swarm
+ * can query whether a halt has been issued.
+ */
+import type { TerminationReason } from '../../../shared/src/types/termination.js';
+/** Record written to the JSONL halt log. */
+export interface HaltRecord {
+    id: string;
+    swarmId: string;
+    sourceAgentId: string;
+    reason: TerminationReason;
+    haltedAt: string;
+}
+/**
+ * Broadcast a halt signal for a swarm.
+ */
+export declare function broadcast(swarmId: string, sourceAgentId: string, reason: TerminationReason, filePath?: string): HaltRecord;
+/**
+ * Check whether any halt signal exists for the given swarm.
+ */
+export declare function isHalted(swarmId: string, filePath?: string): boolean;
+//# sourceMappingURL=halt-signal.d.ts.map

package/dist/src/agents/halt-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"halt-signal.d.ts","sourceRoot":"","sources":["../../../src/agents/halt-signal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAElF,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID;;GAEG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,CAAC,EAAE,MAAM,GAChB,UAAU,CAiBZ;AAED;;GAEG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAgBT"}

package/dist/src/agents/halt-signal.js

@@ -0,0 +1,50 @@
+/**
+ * Halt Signal (Task 35)
+ *
+ * JSONL-based broadcast/check for swarm-level halt signals.
+ * When an agent triggers a cascade halt, other agents in the same swarm
+ * can query whether a halt has been issued.
+ */
+import { randomUUID } from 'crypto';
+import { existsSync, mkdirSync, appendFileSync, readFileSync } from 'fs';
+import { join, dirname } from 'path';
+const DEFAULT_FILE = () => join(process.cwd(), 'data', 'halt-signals.jsonl');
+/**
+ * Broadcast a halt signal for a swarm.
+ */
+export function broadcast(swarmId, sourceAgentId, reason, filePath) {
+    const target = filePath ?? DEFAULT_FILE();
+    const dir = dirname(target);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const record = {
+        id: randomUUID(),
+        swarmId,
+        sourceAgentId,
+        reason,
+        haltedAt: new Date().toISOString(),
+    };
+    appendFileSync(target, JSON.stringify(record) + '\n', 'utf-8');
+    return record;
+}
+/**
+ * Check whether any halt signal exists for the given swarm.
+ */
+export function isHalted(swarmId, filePath) {
+    const target = filePath ?? DEFAULT_FILE();
+    if (!existsSync(target)) {
+        return false;
+    }
+    const raw = readFileSync(target, 'utf-8').trim();
+    if (!raw)
+        return false;
+    return raw
+        .split('\n')
+        .filter(Boolean)
+        .some((line) => {
+        const rec = JSON.parse(line);
+        return rec.swarmId === swarmId;
+    });
+}
+//# sourceMappingURL=halt-signal.js.map

package/dist/src/agents/halt-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"halt-signal.js","sourceRoot":"","sources":["../../../src/agents/halt-signal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAYrC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,OAAe,EACf,aAAqB,EACrB,MAAyB,EACzB,QAAiB;IAEjB,MAAM,MAAM,GAAG,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAe;QACzB,EAAE,EAAE,UAAU,EAAE;QAChB,OAAO;QACP,aAAa;QACb,MAAM;QACN,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACnC,CAAC;IAEF,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,QAAiB;IAEjB,MAAM,MAAM,GAAG,QAAQ,IAAI,YAAY,EAAE,CAAC;IAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IAEvB,OAAO,GAAG;SACP,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;QAC3C,OAAO,GAAG,CAAC,OAAO,KAAK,OAAO,CAAC;IACjC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/src/agents/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Agent utilities — prompt versioning, experiment routing, managed agents.
+ *
+ * @module @monobrain/cli/agents
+ */
+export { PromptExperimentRouter } from './prompt-experiment.js';
+export type { ResolvedPrompt } from './prompt-experiment.js';
+export { PromptVersionManager } from './prompt-version-manager.js';
+export { spawnAndAwait } from './managed-agent.js';
+export type { AgentRunResult, ManagedAgentOptions } from './managed-agent.js';
+export { check as checkTermination, persistEvent } from './termination-watcher.js';
+export type { AgentRunState } from './termination-watcher.js';
+export { broadcast as broadcastHalt, isHalted } from './halt-signal.js';
+export type { HaltRecord } from './halt-signal.js';
+export { buildRegistry } from './registry-builder.js';
+export { RegistryQuery } from './registry-query.js';
+export type { RegistryValidationResult, RegistryConflict } from './registry-query.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/agents/index.js

@@ -0,0 +1,13 @@
+/**
+ * Agent utilities — prompt versioning, experiment routing, managed agents.
+ *
+ * @module @monobrain/cli/agents
+ */
+export { PromptExperimentRouter } from './prompt-experiment.js';
+export { PromptVersionManager } from './prompt-version-manager.js';
+export { spawnAndAwait } from './managed-agent.js';
+export { check as checkTermination, persistEvent } from './termination-watcher.js';
+export { broadcast as broadcastHalt, isHalted } from './halt-signal.js';
+export { buildRegistry } from './registry-builder.js';
+export { RegistryQuery } from './registry-query.js';
+//# sourceMappingURL=index.js.map

package/dist/src/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,KAAK,IAAI,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAGnF,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/agents/managed-agent.d.ts

@@ -0,0 +1,41 @@
+export interface AgentRunResult {
+    agentSlug: string;
+    taskId: string;
+    output: string;
+    status: 'success' | 'error' | 'timeout';
+    durationMs: number;
+    tokens?: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+    error?: string;
+}
+export interface ManagedAgentOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+}
+/**
+ * Simulates spawn-and-await by creating a taskId, delegating to a runner function,
+ * and applying timeout.
+ */
+export declare function spawnAndAwait(agentSlug: string, task: string, runner: (agentSlug: string, taskId: string, task: string) => Promise<string>, options?: ManagedAgentOptions): Promise<AgentRunResult>;
+export declare class ManagedAgent {
+    private readonly agentSlug;
+    private readonly runner;
+    private readonly options;
+    constructor(agentSlug: string, runner: (agentSlug: string, taskId: string, task: string) => Promise<string>, options?: ManagedAgentOptions);
+    run(task: string): Promise<AgentRunResult>;
+    /** Generate an MCP-style tool descriptor for this agent */
+    toToolDescriptor(): {
+        name: string;
+        description: string;
+        inputSchema: Record<string, unknown>;
+    };
+    static create(agentSlug: string, runner: (slug: string, id: string, task: string) => Promise<string>, options?: ManagedAgentOptions): ManagedAgent;
+}
+/** Run multiple agents in parallel */
+export declare function runBatch(agents: Array<{
+    agentSlug: string;
+    task: string;
+}>, runner: (agentSlug: string, taskId: string, task: string) => Promise<string>, options?: ManagedAgentOptions): Promise<AgentRunResult[]>;
+//# sourceMappingURL=managed-agent.d.ts.map

package/dist/src/agents/managed-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-agent.d.ts","sourceRoot":"","sources":["../../../src/agents/managed-agent.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5E,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,cAAc,CAAC,CAyBzB;AAED,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5E,OAAO,GAAE,mBAAwB;IAG9C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIhD,2DAA2D;IAC3D,gBAAgB,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAgB/F,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACnE,OAAO,CAAC,EAAE,mBAAmB,GAC5B,YAAY;CAGhB;AAED,sCAAsC;AACtC,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,KAAK,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAClD,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EAC5E,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,cAAc,EAAE,CAAC,CAI3B"}

package/dist/src/agents/managed-agent.js

@@ -0,0 +1,66 @@
+import { randomBytes } from 'node:crypto';
+/**
+ * Simulates spawn-and-await by creating a taskId, delegating to a runner function,
+ * and applying timeout.
+ */
+export async function spawnAndAwait(agentSlug, task, runner, options = {}) {
+    const { timeoutMs = 120_000 } = options;
+    const startedAt = Date.now();
+    const taskId = `managed-${Date.now().toString(36)}-${randomBytes(4).toString('hex')}`;
+    try {
+        const output = await Promise.race([
+            runner(agentSlug, taskId, task),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Timeout after ${timeoutMs}ms`)), timeoutMs)),
+        ]);
+        return {
+            agentSlug, taskId, output, status: 'success',
+            durationMs: Date.now() - startedAt,
+        };
+    }
+    catch (err) {
+        const isTimeout = String(err).includes('Timeout');
+        return {
+            agentSlug, taskId, output: '',
+            status: isTimeout ? 'timeout' : 'error',
+            durationMs: Date.now() - startedAt,
+            error: String(err),
+        };
+    }
+}
+export class ManagedAgent {
+    agentSlug;
+    runner;
+    options;
+    constructor(agentSlug, runner, options = {}) {
+        this.agentSlug = agentSlug;
+        this.runner = runner;
+        this.options = options;
+    }
+    async run(task) {
+        return spawnAndAwait(this.agentSlug, task, this.runner, this.options);
+    }
+    /** Generate an MCP-style tool descriptor for this agent */
+    toToolDescriptor() {
+        const toolName = `agent_${this.agentSlug.replace(/-/g, '_')}`;
+        return {
+            name: toolName,
+            description: `Delegate a task to the ${this.agentSlug} specialist agent`,
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    task: { type: 'string', description: 'Task description' },
+                    timeoutMs: { type: 'number', description: 'Timeout in ms (default 120000)' },
+                },
+                required: ['task'],
+            },
+        };
+    }
+    static create(agentSlug, runner, options) {
+        return new ManagedAgent(agentSlug, runner, options);
+    }
+}
+/** Run multiple agents in parallel */
+export async function runBatch(agents, runner, options = {}) {
+    return Promise.all(agents.map(({ agentSlug, task }) => spawnAndAwait(agentSlug, task, runner, options)));
+}
+//# sourceMappingURL=managed-agent.js.map

package/dist/src/agents/managed-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-agent.js","sourceRoot":"","sources":["../../../src/agents/managed-agent.ts"],"names":[],"mappings":"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"}

package/dist/src/agents/prompt-experiment.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PromptExperimentRouter - A/B traffic splitting for prompt versions
+ *
+ * Checks for an active experiment on the given agent slug and probabilistically
+ * routes to the candidate or control version. Falls back to the active version
+ * when no experiment is running.
+ *
+ * @module @monobrain/cli/agents/prompt-experiment
+ */
+import type { PromptVersionStore } from '../../../memory/src/prompt-version-store.js';
+export interface ResolvedPrompt {
+    prompt: string;
+    version: string;
+    isCandidate: boolean;
+    agentSlug: string;
+}
+export declare class PromptExperimentRouter {
+    private readonly store;
+    constructor(store: PromptVersionStore);
+    resolvePromptForSpawn(agentSlug: string): ResolvedPrompt;
+}
+//# sourceMappingURL=prompt-experiment.d.ts.map

package/dist/src/agents/prompt-experiment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-experiment.d.ts","sourceRoot":"","sources":["../../../src/agents/prompt-experiment.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAEtD,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;CAoCzD"}

package/dist/src/agents/prompt-experiment.js

@@ -0,0 +1,49 @@
+/**
+ * PromptExperimentRouter - A/B traffic splitting for prompt versions
+ *
+ * Checks for an active experiment on the given agent slug and probabilistically
+ * routes to the candidate or control version. Falls back to the active version
+ * when no experiment is running.
+ *
+ * @module @monobrain/cli/agents/prompt-experiment
+ */
+export class PromptExperimentRouter {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    resolvePromptForSpawn(agentSlug) {
+        const experiment = this.store.getExperiment(agentSlug);
+        if (experiment) {
+            const useCandidate = Math.random() < experiment.trafficPct;
+            const targetVersion = useCandidate ? experiment.candidate : experiment.control;
+            const versions = this.store.listVersions(agentSlug);
+            const found = versions.find((v) => v.version === targetVersion);
+            if (found) {
+                return {
+                    prompt: found.prompt,
+                    version: found.version,
+                    isCandidate: useCandidate,
+                    agentSlug,
+                };
+            }
+        }
+        // Fallback to active version
+        const active = this.store.getActive(agentSlug);
+        if (active) {
+            return {
+                prompt: active.prompt,
+                version: active.version,
+                isCandidate: false,
+                agentSlug,
+            };
+        }
+        return {
+            prompt: '',
+            version: '',
+            isCandidate: false,
+            agentSlug,
+        };
+    }
+}
+//# sourceMappingURL=prompt-experiment.js.map