aurix-ai 2.4.0 → 2.5.0

package/dist/tools/SpawnAgent.js

@@ -0,0 +1,97 @@
+// Orchestrator: lets the main agent fan out work to parallel sub-agents.
+// Each sub-agent is a fresh AgentLoop with the same tools MINUS spawn_agent
+// (prevents infinite recursion), run with a concurrency cap to respect rate
+// limits. No langchain — pure native AgentLoop + provider.
+const MAX_CONCURRENCY = 3;
+const MAX_AGENTS = 12;
+const SUBAGENT_MAX_ITERATIONS = 40;
+// Build a registry for sub-agents: clone parent tools, drop spawn_agent.
+function buildSubRegistry(parent, RegistryClass) {
+    const sub = new RegistryClass();
+    for (const t of parent.list()) {
+        if (t.name === 'spawn_agent')
+            continue;
+        sub.register(t);
+    }
+    return sub;
+}
+// Run async jobs with a bounded concurrency. Preserves input order in results.
+async function runBounded(items, limit, fn) {
+    const results = new Array(items.length);
+    let next = 0;
+    const workers = new Array(Math.min(limit, items.length)).fill(0).map(async () => {
+        while (true) {
+            const i = next++;
+            if (i >= items.length)
+                return;
+            results[i] = await fn(items[i], i);
+        }
+    });
+    await Promise.all(workers);
+    return results;
+}
+// Drain a sub-agent's run() generator and collect its final text output.
+async function collectAgentResult(agent, prompt) {
+    let lastText = '';
+    const chunks = [];
+    try {
+        for await (const evt of agent.run(prompt)) {
+            if (evt.type === 'text' && evt.data) {
+                lastText = evt.data;
+                chunks.push(evt.data);
+            }
+            else if (evt.type === 'error') {
+                return `[sub-agent error] ${evt.data}`;
+            }
+            else if (evt.type === 'done') {
+                break;
+            }
+        }
+    }
+    catch (e) {
+        return `[sub-agent crashed] ${e?.message || String(e)}`;
+    }
+    // prefer the final assistant message; fall back to the joined stream
+    return lastText || chunks.join('\n') || '(sub-agent produced no output)';
+}
+export function createSpawnAgentTool(config, registry) {
+    return {
+        name: 'spawn_agent',
+        description: `Run one or more autonomous sub-agents in parallel to handle independent subtasks, then collect their results. Use this to decompose a large task (research many files, check many candidates, run independent investigations) and cover them concurrently. Each sub-agent has the same tools as you EXCEPT it cannot spawn further agents. Up to ${MAX_AGENTS} sub-agents; at most ${MAX_CONCURRENCY} run at once. Each "task" string is a complete, self-contained instruction for one sub-agent — be specific about what to do and what to report back.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                tasks: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'List of self-contained task prompts, one per sub-agent. Each runs independently and in parallel.',
+                },
+            },
+            required: ['tasks'],
+        },
+        async execute(args) {
+            const rawTasks = args.tasks;
+            if (!Array.isArray(rawTasks) || rawTasks.length === 0) {
+                return 'Error: spawn_agent requires a non-empty "tasks" array of prompt strings.';
+            }
+            const tasks = rawTasks.map(t => String(t)).filter(t => t.trim().length > 0).slice(0, MAX_AGENTS);
+            if (tasks.length === 0)
+                return 'Error: all tasks were empty.';
+            // Lazy imports to avoid a circular dependency (AgentLoop imports tools).
+            const { AgentLoop } = await import('../agent/AgentLoop.js');
+            const { ToolRegistry } = await import('./Registry.js');
+            const subRegistry = buildSubRegistry(registry, ToolRegistry);
+            const results = await runBounded(tasks, MAX_CONCURRENCY, async (prompt) => {
+                const sub = new AgentLoop(config, subRegistry);
+                if (typeof sub.setMaxIterations === 'function')
+                    sub.setMaxIterations(SUBAGENT_MAX_ITERATIONS);
+                return collectAgentResult(sub, prompt);
+            });
+            const out = results
+                .map((r, i) => `## Sub-agent ${i + 1}\nTask: ${tasks[i].slice(0, 120)}\n\n${r}`)
+                .join('\n\n---\n\n');
+            return `Spawned ${tasks.length} sub-agent(s) (max ${MAX_CONCURRENCY} concurrent). Results:\n\n${out}`;
+        },
+    };
+}
+//# sourceMappingURL=SpawnAgent.js.map

package/dist/tools/SpawnAgent.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aurix-ai",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "Open-source terminal AI agent for coding, deep research, automation, and multi-platform task execution.",
   "type": "module",
   "main": "dist/index.js",