funolio-agent 0.1.0

package/dist/subagent/orchestrator.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Phase 3K: Sub-Agent Orchestrator
+ * Coordinates sub-agent spawning, dependency resolution, and result merging.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentOrchestrator = void 0;
+const events_1 = require("events");
+const queue_1 = require("./queue");
+/**
+ * SubAgentOrchestrator takes decomposed checkpoints and runs them
+ * as parallel sub-agents with dependency tracking.
+ */
+class SubAgentOrchestrator extends events_1.EventEmitter {
+    queue;
+    config;
+    parentTaskId = '';
+    constructor(config) {
+        super();
+        this.config = config;
+        this.queue = new queue_1.SubAgentQueue(config.userId, config.tier, config.redisUrl);
+        // Forward queue events
+        this.queue.on('task-started', (task) => this.emit('subtask-started', task));
+        this.queue.on('task-completed', (task, result) => this.emit('subtask-completed', task, result));
+        this.queue.on('task-failed', (task, error) => this.emit('subtask-failed', task, error));
+        this.queue.on('all-complete', (results) => this.emit('all-complete', results));
+        this.queue.on('task-ready', (task) => this.handleTaskReady(task));
+    }
+    /**
+     * Initialize the orchestrator and underlying queue.
+     */
+    async initialize() {
+        await this.queue.initialize();
+    }
+    /**
+     * Execute a set of decomposed steps as sub-agents.
+     * Identifies parallelizable steps and manages dependencies.
+     */
+    async executeSteps(parentTaskId, steps) {
+        this.parentTaskId = parentTaskId;
+        // Analyze which steps can run in parallel
+        const { parallel, sequential } = this.analyzeParallelism(steps);
+        console.log(`[SubAgent] Decomposed into ${steps.length} steps: ${parallel.length} parallel, ${sequential.length} sequential`);
+        // Create SubAgentTask for each step
+        const subTasks = steps.map((step, index) => ({
+            id: `${parentTaskId}-sub-${index}`,
+            parentTaskId,
+            checkpointIndex: index,
+            prompt: step.prompt,
+            status: 'pending',
+            dependsOn: (step.dependsOn || []).map((depIdx) => `${parentTaskId}-sub-${depIdx}`),
+            tokenBudget: 4000, // default per sub-task
+            createdAt: Date.now(),
+        }));
+        // Submit to queue
+        const jobDataTemplate = {
+            userId: this.config.userId,
+            projectId: this.config.projectId,
+            llmConfig: this.config.llmConfig,
+            parentContext: {
+                projectDir: this.config.projectDir,
+                facts: this.config.facts,
+                files: this.config.files,
+            },
+        };
+        await this.queue.submitTasks(subTasks, jobDataTemplate);
+        return subTasks;
+    }
+    /**
+     * Analyze steps to identify which can run in parallel.
+     */
+    analyzeParallelism(steps) {
+        const parallel = [];
+        const sequential = [];
+        for (let i = 0; i < steps.length; i++) {
+            if (!steps[i].dependsOn || steps[i].dependsOn.length === 0) {
+                parallel.push(i);
+            }
+            else {
+                sequential.push(i);
+            }
+        }
+        return { parallel, sequential };
+    }
+    /** Handle when a dependent task becomes ready */
+    async handleTaskReady(task) {
+        // Re-submit just this task
+        const jobData = {
+            subTask: task,
+            userId: this.config.userId,
+            projectId: this.config.projectId,
+            llmConfig: this.config.llmConfig,
+            parentContext: {
+                projectDir: this.config.projectDir,
+                facts: this.config.facts,
+                files: this.config.files,
+            },
+        };
+        // The queue will handle enqueuing
+        task.status = 'waiting';
+        this.emit('subtask-enqueued', task);
+    }
+    /**
+     * Merge results from all sub-agents into a single summary.
+     */
+    mergeResults() {
+        const tasks = this.queue.getTaskStatuses();
+        const completed = tasks.filter((t) => t.status === 'completed');
+        const failed = tasks.filter((t) => t.status === 'failed');
+        let summary = `## Sub-Agent Results\n\n`;
+        summary += `**${completed.length}/${tasks.length}** sub-tasks completed`;
+        if (failed.length > 0) {
+            summary += ` (${failed.length} failed)`;
+        }
+        summary += '\n\n';
+        for (const task of tasks) {
+            const icon = task.status === 'completed' ? '✅' : task.status === 'failed' ? '❌' : '⏳';
+            summary += `${icon} **Step ${task.checkpointIndex + 1}:** ${task.prompt.slice(0, 100)}\n`;
+            if (task.result) {
+                summary += `   Result: ${task.result.slice(0, 200)}\n`;
+            }
+            if (task.error) {
+                summary += `   Error: ${task.error}\n`;
+            }
+            summary += '\n';
+        }
+        return summary;
+    }
+    /** Get dependency graph for UI visualization */
+    getDependencyGraph() {
+        return this.queue.buildDependencyGraph();
+    }
+    /** Get all task statuses */
+    getStatuses() {
+        return this.queue.getTaskStatuses();
+    }
+    /** Cancel all running sub-agents */
+    async cancelAll() {
+        const tasks = this.queue.getTaskStatuses();
+        for (const task of tasks) {
+            if (task.status === 'pending' || task.status === 'waiting' || task.status === 'running') {
+                await this.queue.cancelTask(task.id);
+            }
+        }
+    }
+    /** Shutdown */
+    async shutdown() {
+        await this.queue.shutdown();
+    }
+}
+exports.SubAgentOrchestrator = SubAgentOrchestrator;
+//# sourceMappingURL=orchestrator.js.map

package/dist/subagent/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/subagent/orchestrator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mCAAsC;AACtC,mCAAwC;AAiCxC;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,qBAAY;IAC5C,KAAK,CAAgB;IACrB,MAAM,CAAqB;IAC3B,YAAY,GAAW,EAAE,CAAC;IAElC,YAAY,MAA0B;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,qBAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAE5E,uBAAuB;QACvB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAChG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/E,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,YAAoB,EAAE,KAAuB;QAC9D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QAEjC,0CAA0C;QAC1C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAEhE,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,cAAc,UAAU,CAAC,MAAM,aAAa,CAAC,CAAC;QAE9H,oCAAoC;QACpC,MAAM,QAAQ,GAAmB,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3D,EAAE,EAAE,GAAG,YAAY,QAAQ,KAAK,EAAE;YAClC,YAAY;YACZ,eAAe,EAAE,KAAK;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,SAA2B;YACnC,SAAS,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,YAAY,QAAQ,MAAM,EAAE,CAAC;YAClF,WAAW,EAAE,IAAI,EAAE,uBAAuB;YAC1C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC,CAAC;QAEJ,kBAAkB;QAClB,MAAM,eAAe,GAAqC;YACxD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,aAAa,EAAE;gBACb,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBACxB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;aACzB;SACF,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC;QACxD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,KAAuB;QAIhD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,UAAU,GAAa,EAAE,CAAC;QAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5D,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAED,iDAAiD;IACzC,KAAK,CAAC,eAAe,CAAC,IAAkB;QAC9C,2BAA2B;QAC3B,MAAM,OAAO,GAAoB;YAC/B,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,aAAa,EAAE;gBACb,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBACxB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;aACzB;SACF,CAAC;QAEF,kCAAkC;QAClC,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QAE1D,IAAI,OAAO,GAAG,0BAA0B,CAAC;QACzC,OAAO,IAAI,KAAK,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,wBAAwB,CAAC;QACzE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,IAAI,KAAK,MAAM,CAAC,MAAM,UAAU,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,MAAM,CAAC;QAElB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACtF,OAAO,IAAI,GAAG,IAAI,WAAW,IAAI,CAAC,eAAe,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC;YAC1F,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,OAAO,IAAI,cAAc,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC;YACzD,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,OAAO,IAAI,aAAa,IAAI,CAAC,KAAK,IAAI,CAAC;YACzC,CAAC;YACD,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,gDAAgD;IAChD,kBAAkB;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;IAC3C,CAAC;IAED,4BAA4B;IAC5B,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;IACtC,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,SAAS;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;QAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACxF,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,eAAe;IACf,KAAK,CAAC,QAAQ;QACZ,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;CACF;AAhKD,oDAgKC"}

package/dist/subagent/queue.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Phase 3K: Sub-Agent Queue
+ * BullMQ queue setup for sub-agent job processing on Upstash Redis.
+ */
+import { EventEmitter } from 'events';
+import { SubAgentTask, SubAgentJobData, CheckpointWithDependencies } from './types';
+/**
+ * SubAgentQueue manages the lifecycle of sub-agent tasks.
+ *
+ * In production, this uses BullMQ with Upstash Redis.
+ * The queue is created per-user to enforce tier-based concurrency.
+ *
+ * Note: BullMQ dependency (bullmq package) is optional —
+ * when not available, falls back to in-process execution.
+ */
+export declare class SubAgentQueue extends EventEmitter {
+    private userId;
+    private tier;
+    private tasks;
+    private queue;
+    private worker;
+    private redisUrl;
+    constructor(userId: string, tier?: string, redisUrl?: string);
+    /** Get concurrency limit for user's tier */
+    get concurrencyLimit(): number;
+    /**
+     * Initialize BullMQ queue and worker.
+     * Falls back to in-process if BullMQ/Redis not available.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Submit sub-agent tasks for a parent task.
+     * Respects dependency ordering — only enqueues tasks whose dependencies are met.
+     */
+    submitTasks(tasks: SubAgentTask[], jobDataTemplate: Omit<SubAgentJobData, 'subTask'>): Promise<void>;
+    /**
+     * Enqueue tasks whose dependencies are all satisfied.
+     */
+    private enqueueReadyTasks;
+    /**
+     * Process a sub-agent job — this runs in the BullMQ worker.
+     * Each sub-agent gets its own LLM conversation context.
+     */
+    private processJob;
+    /** In-process fallback when BullMQ is not available */
+    private processJobInProcess;
+    /** Handle successful job completion */
+    private handleJobComplete;
+    /** Handle failed job */
+    private handleJobFailed;
+    /** Check if completed task unlocks dependents */
+    private checkAndEnqueueDependents;
+    /** Check if all tasks in the batch are complete */
+    private checkAllComplete;
+    /** Get current status of all tasks */
+    getTaskStatuses(): SubAgentTask[];
+    /** Cancel a specific task */
+    cancelTask(taskId: string): Promise<void>;
+    /** Build dependency graph for UI visualization */
+    buildDependencyGraph(): CheckpointWithDependencies[];
+    /** Parse Redis URL to BullMQ connection options */
+    private parseRedisConnection;
+    /** Shutdown queue and worker */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=queue.d.ts.map

package/dist/subagent/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../src/subagent/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,YAAY,EACZ,eAAe,EAIf,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,KAAK,CAAwC;IACrD,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAgB;gBAEpB,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAe,EAAE,QAAQ,CAAC,EAAE,MAAM;IAOpE,4CAA4C;IAC5C,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CjC;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1G;;OAEG;YACW,iBAAiB;IA2B/B;;;OAGG;YACW,UAAU;IA+CxB,uDAAuD;YACzC,mBAAmB;IASjC,uCAAuC;IACvC,OAAO,CAAC,iBAAiB;IAgBzB,wBAAwB;IACxB,OAAO,CAAC,eAAe;IAWvB,iDAAiD;IACjD,OAAO,CAAC,yBAAyB;IAiBjC,mDAAmD;IACnD,OAAO,CAAC,gBAAgB;IAUxB,sCAAsC;IACtC,eAAe,IAAI,YAAY,EAAE;IAIjC,6BAA6B;IACvB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,kDAAkD;IAClD,oBAAoB,IAAI,0BAA0B,EAAE;IAgBpD,mDAAmD;IACnD,OAAO,CAAC,oBAAoB;IAW5B,gCAAgC;IAC1B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/subagent/queue.js

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * Phase 3K: Sub-Agent Queue
+ * BullMQ queue setup for sub-agent job processing on Upstash Redis.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubAgentQueue = void 0;
+const events_1 = require("events");
+const types_1 = require("./types");
+/**
+ * SubAgentQueue manages the lifecycle of sub-agent tasks.
+ *
+ * In production, this uses BullMQ with Upstash Redis.
+ * The queue is created per-user to enforce tier-based concurrency.
+ *
+ * Note: BullMQ dependency (bullmq package) is optional —
+ * when not available, falls back to in-process execution.
+ */
+class SubAgentQueue extends events_1.EventEmitter {
+    userId;
+    tier;
+    tasks = new Map();
+    queue = null; // BullMQ Queue instance
+    worker = null; // BullMQ Worker instance
+    redisUrl;
+    constructor(userId, tier = 'free', redisUrl) {
+        super();
+        this.userId = userId;
+        this.tier = tier;
+        this.redisUrl = redisUrl || process.env.UPSTASH_REDIS_URL || null;
+    }
+    /** Get concurrency limit for user's tier */
+    get concurrencyLimit() {
+        return types_1.TIER_CONCURRENCY[this.tier] || 1;
+    }
+    /**
+     * Initialize BullMQ queue and worker.
+     * Falls back to in-process if BullMQ/Redis not available.
+     */
+    async initialize() {
+        if (!this.redisUrl) {
+            console.log('[SubAgent] No Redis URL — using in-process execution');
+            return;
+        }
+        try {
+            // Dynamic import to keep bullmq optional
+            // @ts-ignore — bullmq is an optional peer dependency
+            const { Queue, Worker } = await Promise.resolve(`${'bullmq'}`).then(s => __importStar(require(s)));
+            const connection = this.parseRedisConnection(this.redisUrl);
+            this.queue = new Queue(`subagent:${this.userId}`, { connection });
+            this.worker = new Worker(`subagent:${this.userId}`, async (job) => {
+                return this.processJob(job.data);
+            }, {
+                connection,
+                concurrency: this.concurrencyLimit,
+            });
+            this.worker.on('completed', (job, result) => {
+                this.handleJobComplete(result);
+            });
+            this.worker.on('failed', (job, err) => {
+                const subTaskId = job?.data?.subTask?.id;
+                if (subTaskId) {
+                    this.handleJobFailed(subTaskId, err.message);
+                }
+            });
+            console.log(`[SubAgent] Queue initialized for user ${this.userId} (tier: ${this.tier}, concurrency: ${this.concurrencyLimit})`);
+        }
+        catch (err) {
+            console.log(`[SubAgent] BullMQ not available, using in-process: ${err.message}`);
+        }
+    }
+    /**
+     * Submit sub-agent tasks for a parent task.
+     * Respects dependency ordering — only enqueues tasks whose dependencies are met.
+     */
+    async submitTasks(tasks, jobDataTemplate) {
+        for (const task of tasks) {
+            this.tasks.set(task.id, task);
+        }
+        // Enqueue tasks with no dependencies (or all deps already completed)
+        await this.enqueueReadyTasks(jobDataTemplate);
+    }
+    /**
+     * Enqueue tasks whose dependencies are all satisfied.
+     */
+    async enqueueReadyTasks(jobDataTemplate) {
+        for (const [id, task] of this.tasks) {
+            if (task.status !== 'pending')
+                continue;
+            const depsReady = task.dependsOn.every((depId) => {
+                const dep = this.tasks.get(depId);
+                return dep && dep.status === 'completed';
+            });
+            if (depsReady) {
+                task.status = 'waiting';
+                const jobData = { ...jobDataTemplate, subTask: task };
+                if (this.queue) {
+                    await this.queue.add(`subtask-${task.id}`, jobData, {
+                        jobId: task.id,
+                        attempts: 2,
+                        backoff: { type: 'exponential', delay: 5000 },
+                    });
+                }
+                else {
+                    // In-process fallback
+                    this.processJobInProcess(jobData);
+                }
+            }
+        }
+    }
+    /**
+     * Process a sub-agent job — this runs in the BullMQ worker.
+     * Each sub-agent gets its own LLM conversation context.
+     */
+    async processJob(data) {
+        const { subTask, llmConfig, parentContext } = data;
+        const task = this.tasks.get(subTask.id) || subTask;
+        task.status = 'running';
+        task.startedAt = Date.now();
+        this.emit('task-started', task);
+        try {
+            // Create isolated LLM conversation for this sub-agent
+            const { createProvider } = await Promise.resolve().then(() => __importStar(require('../providers/index')));
+            const provider = createProvider(llmConfig.provider, {
+                apiKey: llmConfig.apiKey,
+                model: llmConfig.model,
+            });
+            // Build system prompt with parent context
+            let systemPrompt = 'You are a Funolio sub-agent working on a specific sub-task. Focus only on your assigned task.';
+            if (parentContext.facts.length > 0) {
+                systemPrompt += '\n\nRelevant context:\n' + parentContext.facts.map((f) => `- ${f}`).join('\n');
+            }
+            const response = await provider.chat({
+                messages: [{ role: 'user', content: subTask.prompt }],
+                system: systemPrompt,
+            });
+            const result = {
+                subTaskId: subTask.id,
+                status: 'completed',
+                result: response.content,
+                tokensUsed: (response.usage?.inputTokens || 0) + (response.usage?.outputTokens || 0),
+                completedAt: Date.now(),
+            };
+            return result;
+        }
+        catch (err) {
+            return {
+                subTaskId: subTask.id,
+                status: 'failed',
+                error: err.message,
+                tokensUsed: 0,
+                completedAt: Date.now(),
+            };
+        }
+    }
+    /** In-process fallback when BullMQ is not available */
+    async processJobInProcess(data) {
+        try {
+            const result = await this.processJob(data);
+            this.handleJobComplete(result);
+        }
+        catch (err) {
+            this.handleJobFailed(data.subTask.id, err.message);
+        }
+    }
+    /** Handle successful job completion */
+    handleJobComplete(result) {
+        const task = this.tasks.get(result.subTaskId);
+        if (task) {
+            task.status = 'completed';
+            task.result = result.result;
+            task.completedAt = result.completedAt;
+            this.emit('task-completed', task, result);
+        }
+        // Check if this unlocks dependent tasks
+        this.checkAndEnqueueDependents(result.subTaskId);
+        // Check if all tasks are done
+        this.checkAllComplete();
+    }
+    /** Handle failed job */
+    handleJobFailed(subTaskId, error) {
+        const task = this.tasks.get(subTaskId);
+        if (task) {
+            task.status = 'failed';
+            task.error = error;
+            task.completedAt = Date.now();
+            this.emit('task-failed', task, error);
+        }
+        this.checkAllComplete();
+    }
+    /** Check if completed task unlocks dependents */
+    checkAndEnqueueDependents(completedId) {
+        // Find tasks that depend on the completed one and re-check readiness
+        for (const [id, task] of this.tasks) {
+            if (task.status === 'pending' && task.dependsOn.includes(completedId)) {
+                const allDepsReady = task.dependsOn.every((depId) => {
+                    const dep = this.tasks.get(depId);
+                    return dep && dep.status === 'completed';
+                });
+                if (allDepsReady) {
+                    // This task is now ready — but we need the job data template
+                    // Emit event for the orchestrator to handle
+                    this.emit('task-ready', task);
+                }
+            }
+        }
+    }
+    /** Check if all tasks in the batch are complete */
+    checkAllComplete() {
+        const allDone = Array.from(this.tasks.values()).every((t) => t.status === 'completed' || t.status === 'failed' || t.status === 'cancelled');
+        if (allDone) {
+            const results = Array.from(this.tasks.values());
+            this.emit('all-complete', results);
+        }
+    }
+    /** Get current status of all tasks */
+    getTaskStatuses() {
+        return Array.from(this.tasks.values());
+    }
+    /** Cancel a specific task */
+    async cancelTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (task && (task.status === 'pending' || task.status === 'waiting')) {
+            task.status = 'cancelled';
+            this.emit('task-cancelled', task);
+        }
+    }
+    /** Build dependency graph for UI visualization */
+    buildDependencyGraph() {
+        return Array.from(this.tasks.values()).map((t) => ({
+            desc: t.prompt,
+            status: t.status,
+            result: t.result,
+            subAgentId: t.id,
+            dependsOn: t.dependsOn
+                .map((depId) => {
+                const dep = this.tasks.get(depId);
+                return dep ? dep.checkpointIndex : -1;
+            })
+                .filter((i) => i >= 0),
+            parallel: t.dependsOn.length === 0,
+        }));
+    }
+    /** Parse Redis URL to BullMQ connection options */
+    parseRedisConnection(url) {
+        const parsed = new URL(url);
+        return {
+            host: parsed.hostname,
+            port: parseInt(parsed.port || '6379', 10),
+            password: parsed.password || undefined,
+            username: parsed.username || undefined,
+            tls: parsed.protocol === 'rediss:' ? {} : undefined,
+        };
+    }
+    /** Shutdown queue and worker */
+    async shutdown() {
+        if (this.worker)
+            await this.worker.close();
+        if (this.queue)
+            await this.queue.close();
+        this.tasks.clear();
+    }
+}
+exports.SubAgentQueue = SubAgentQueue;
+//# sourceMappingURL=queue.js.map

package/dist/subagent/queue.js.map

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

package/dist/subagent/types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Phase 3K: Sub-Agent System Types
+ */
+/** Concurrency limits by subscription tier */
+export declare const TIER_CONCURRENCY: Record<string, number>;
+/** Status of a sub-agent job */
+export type SubAgentStatus = 'pending' | 'waiting' | 'running' | 'completed' | 'failed' | 'cancelled';
+/** A sub-agent task within a parent task decomposition */
+export interface SubAgentTask {
+    id: string;
+    parentTaskId: string;
+    /** Index in the parent's checkpoint list */
+    checkpointIndex: number;
+    prompt: string;
+    status: SubAgentStatus;
+    /** IDs of sub-agent tasks this depends on */
+    dependsOn: string[];
+    /** Token budget for this sub-task */
+    tokenBudget: number;
+    /** Results when completed */
+    result?: string;
+    error?: string;
+    /** Timestamps */
+    createdAt: number;
+    startedAt?: number;
+    completedAt?: number;
+}
+/** Job data passed to BullMQ worker */
+export interface SubAgentJobData {
+    subTask: SubAgentTask;
+    userId: string;
+    projectId: string;
+    /** LLM config for this sub-agent */
+    llmConfig: {
+        provider: string;
+        model: string;
+        apiKey: string;
+    };
+    /** Context passed from parent */
+    parentContext: {
+        projectDir: string;
+        facts: string[];
+        files: string[];
+    };
+}
+/** Result returned by the BullMQ worker */
+export interface SubAgentJobResult {
+    subTaskId: string;
+    status: 'completed' | 'failed';
+    result?: string;
+    error?: string;
+    tokensUsed: number;
+    completedAt: number;
+}
+/** Dependency graph node for checkpoint tracking */
+export interface DependencyNode {
+    id: string;
+    checkpointIndex: number;
+    description: string;
+    dependsOn: string[];
+    status: SubAgentStatus;
+    result?: string;
+}
+/** Serialized into Task.checkpoints JSONB */
+export interface CheckpointWithDependencies {
+    desc: string;
+    expectedOutput?: string;
+    timeout?: number;
+    status: string;
+    result?: string;
+    /** Sub-agent tracking */
+    subAgentId?: string;
+    dependsOn?: number[];
+    parallel?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/subagent/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/subagent/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAKnD,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEtG,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,SAAS,EAAE;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,iCAAiC;IACjC,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6CAA6C;AAC7C,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/subagent/types.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Phase 3K: Sub-Agent System Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TIER_CONCURRENCY = void 0;
+/** Concurrency limits by subscription tier */
+exports.TIER_CONCURRENCY = {
+    free: 1,
+    personal: 2,
+    pro: 5,
+    team: 10,
+};
+//# sourceMappingURL=types.js.map

package/dist/subagent/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/subagent/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,8CAA8C;AACjC,QAAA,gBAAgB,GAA2B;IACtD,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,EAAE;CACT,CAAC"}

package/dist/tools/edit-file.d.ts

@@ -0,0 +1,3 @@
+import { ToolDefinition } from '../types';
+export declare const editFileTool: ToolDefinition;
+//# sourceMappingURL=edit-file.d.ts.map

package/dist/tools/edit-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../src/tools/edit-file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAA2B,MAAM,UAAU,CAAC;AAGnE,eAAO,MAAM,YAAY,EAAE,cA8E1B,CAAC"}