cmdr-agent 2.1.1 → 2.2.0

package/dist/src/core/event-bus.d.ts

@@ -0,0 +1,129 @@
+/**
+ * EventBus — typed pub/sub event system for cmdr lifecycle events.
+ *
+ * Provides a decoupled communication layer beyond plugin hooks.
+ * Supports:
+ *  - Typed event emission and subscription
+ *  - One-time listeners
+ *  - Wildcard subscriptions
+ *  - Async handlers
+ */
+import type { TokenUsage, ToolResult } from './types.js';
+export interface CmdrEvents {
+    'session:start': {
+        sessionId: string;
+    };
+    'session:end': {
+        sessionId: string;
+        messageCount: number;
+        totalTokens: TokenUsage;
+    };
+    'session:compact': {
+        before: number;
+        after: number;
+        tokensSaved: number;
+    };
+    'turn:start': {
+        turn: number;
+        model: string;
+    };
+    'turn:end': {
+        turn: number;
+        tokenUsage: TokenUsage;
+        toolCallCount: number;
+    };
+    'tool:before': {
+        name: string;
+        input: Record<string, unknown>;
+    };
+    'tool:after': {
+        name: string;
+        result: ToolResult;
+        durationMs: number;
+    };
+    'tool:error': {
+        name: string;
+        error: string;
+    };
+    'tool:denied': {
+        name: string;
+        reason: string;
+    };
+    'llm:request': {
+        model: string;
+        messageCount: number;
+    };
+    'llm:response': {
+        model: string;
+        usage: TokenUsage;
+        stopReason: string;
+    };
+    'llm:stream:text': {
+        chunk: string;
+    };
+    'llm:error': {
+        model: string;
+        error: string;
+    };
+    'memory:read': {
+        scope: string;
+    };
+    'memory:write': {
+        scope: string;
+        bytes: number;
+    };
+    'memory:consolidate': {
+        entriesBefore: number;
+        entriesAfter: number;
+    };
+    'agent:start': {
+        name: string;
+        task: string;
+    };
+    'agent:complete': {
+        name: string;
+        success: boolean;
+        turns: number;
+    };
+    'agent:error': {
+        name: string;
+        error: string;
+    };
+    'user:message': {
+        text: string;
+        tokenEstimate: number;
+    };
+    'user:command': {
+        command: string;
+        args: string;
+    };
+    'user:abort': {};
+}
+export type EventName = keyof CmdrEvents;
+type Listener<T> = (data: T) => void | Promise<void>;
+export declare class EventBus {
+    private listeners;
+    private wildcardListeners;
+    /** Subscribe to a specific event. Returns an unsubscribe function. */
+    on<E extends EventName>(event: E, handler: Listener<CmdrEvents[E]>): () => void;
+    /** Subscribe to a specific event, auto-remove after first fire. */
+    once<E extends EventName>(event: E, handler: Listener<CmdrEvents[E]>): () => void;
+    /** Subscribe to ALL events (wildcard). */
+    onAny(handler: Listener<{
+        event: string;
+        data: unknown;
+    }>): () => void;
+    /** Emit an event to all listeners. */
+    emit<E extends EventName>(event: E, data: CmdrEvents[E]): Promise<void>;
+    /** Remove all listeners for a specific event. */
+    off<E extends EventName>(event: E): void;
+    /** Remove ALL listeners. */
+    removeAll(): void;
+    /** Get count of listeners for an event. */
+    listenerCount(event: EventName): number;
+    private addListener;
+}
+/** Singleton event bus for the cmdr process. */
+export declare const globalEventBus: EventBus;
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/src/core/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/core/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAc,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAMpE,MAAM,WAAW,UAAU;IAEzB,eAAe,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,aAAa,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,UAAU,CAAA;KAAE,CAAA;IACnF,iBAAiB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;IAGzE,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;IAG3E,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAA;IAC/D,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAG/C,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IACtD,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACxE,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAG7C,aAAa,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,cAAc,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD,oBAAoB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;IAGrE,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACnE,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAG9C,cAAc,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,cAAc,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACjD,YAAY,EAAE,EAAE,CAAA;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,UAAU,CAAA;AAExC,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAWpD,qBAAa,QAAQ;IACnB,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,iBAAiB,CAAwD;IAEjF,sEAAsE;IACtE,EAAE,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAI/E,mEAAmE;IACnE,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAIjF,0CAA0C;IAC1C,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,MAAM,IAAI;IAStE,sCAAsC;IAChC,IAAI,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC7E,iDAAiD;IACjD,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIxC,4BAA4B;IAC5B,SAAS,IAAI,IAAI;IAKjB,2CAA2C;IAC3C,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAIvC,OAAO,CAAC,WAAW;CAcpB;AAED,gDAAgD;AAChD,eAAO,MAAM,cAAc,UAAiB,CAAA"}

package/dist/src/core/event-bus.js

@@ -0,0 +1,103 @@
+/**
+ * EventBus — typed pub/sub event system for cmdr lifecycle events.
+ *
+ * Provides a decoupled communication layer beyond plugin hooks.
+ * Supports:
+ *  - Typed event emission and subscription
+ *  - One-time listeners
+ *  - Wildcard subscriptions
+ *  - Async handlers
+ */
+// ---------------------------------------------------------------------------
+// EventBus implementation
+// ---------------------------------------------------------------------------
+export class EventBus {
+    listeners = new Map();
+    wildcardListeners = [];
+    /** Subscribe to a specific event. Returns an unsubscribe function. */
+    on(event, handler) {
+        return this.addListener(event, handler, false);
+    }
+    /** Subscribe to a specific event, auto-remove after first fire. */
+    once(event, handler) {
+        return this.addListener(event, handler, true);
+    }
+    /** Subscribe to ALL events (wildcard). */
+    onAny(handler) {
+        const entry = { handler, once: false };
+        this.wildcardListeners.push(entry);
+        return () => {
+            const idx = this.wildcardListeners.indexOf(entry);
+            if (idx !== -1)
+                this.wildcardListeners.splice(idx, 1);
+        };
+    }
+    /** Emit an event to all listeners. */
+    async emit(event, data) {
+        // Specific listeners
+        const entries = this.listeners.get(event);
+        if (entries) {
+            const toRemove = [];
+            for (let i = 0; i < entries.length; i++) {
+                try {
+                    await entries[i].handler(data);
+                }
+                catch {
+                    // Don't let listener errors propagate
+                }
+                if (entries[i].once)
+                    toRemove.push(i);
+            }
+            // Remove one-time listeners in reverse order
+            for (let i = toRemove.length - 1; i >= 0; i--) {
+                entries.splice(toRemove[i], 1);
+            }
+        }
+        // Wildcard listeners
+        const wcToRemove = [];
+        for (let i = 0; i < this.wildcardListeners.length; i++) {
+            try {
+                await this.wildcardListeners[i].handler({ event, data });
+            }
+            catch {
+                // Don't let listener errors propagate
+            }
+            if (this.wildcardListeners[i].once)
+                wcToRemove.push(i);
+        }
+        for (let i = wcToRemove.length - 1; i >= 0; i--) {
+            this.wildcardListeners.splice(wcToRemove[i], 1);
+        }
+    }
+    /** Remove all listeners for a specific event. */
+    off(event) {
+        this.listeners.delete(event);
+    }
+    /** Remove ALL listeners. */
+    removeAll() {
+        this.listeners.clear();
+        this.wildcardListeners = [];
+    }
+    /** Get count of listeners for an event. */
+    listenerCount(event) {
+        return (this.listeners.get(event)?.length ?? 0);
+    }
+    addListener(event, handler, once) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, []);
+        }
+        const entry = { handler: handler, once };
+        this.listeners.get(event).push(entry);
+        return () => {
+            const entries = this.listeners.get(event);
+            if (entries) {
+                const idx = entries.indexOf(entry);
+                if (idx !== -1)
+                    entries.splice(idx, 1);
+            }
+        };
+    }
+}
+/** Singleton event bus for the cmdr process. */
+export const globalEventBus = new EventBus();
+//# sourceMappingURL=event-bus.js.map

package/dist/src/core/event-bus.js.map

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

package/dist/src/core/orchestrator.d.ts

@@ -1,13 +1,22 @@
 /**
  * Orchestrator — top-level coordinator for multi-agent workflows.
  *
- * Provides runAgent(), runTeam(), and runTasks() entry points.
+ * Provides runAgent(), runTeam(), runTasks(), and coordinate() entry points.
+ * The coordinate() method adds a planning phase where an LLM decomposes a
+ * complex goal into tasks with dependencies before executing them.
  */
 import type { AgentConfig, AgentRunResult, TeamConfig, TeamRunResult, Task, LLMAdapter, OrchestratorConfig, TokenUsage } from './types.js';
 import type { ToolRegistry } from '../tools/registry.js';
 import type { PermissionManager } from './permissions.js';
 import { Team } from './team.js';
 import { TaskQueue } from '../communication/task-queue.js';
+export interface CoordinateResult {
+    success: boolean;
+    taskResults: Map<string, AgentRunResult>;
+    totalTokenUsage: TokenUsage;
+    plannedTasks: number;
+    completedTasks: number;
+}
 export declare class Orchestrator {
     private readonly adapter;
     private readonly toolRegistry;
@@ -30,6 +39,13 @@ export declare class Orchestrator {
     }>;
     /** Get the active team (if any). */
     getActiveTeam(): Team | undefined;
+    /**
+     * Coordinator mode: LLM-driven task decomposition + parallel execution.
+     * Uses the adapter to plan tasks, then executes them via runTasks().
+     */
+    coordinate(goal: string, agentConfigs: readonly AgentConfig[], options?: {
+        maxTokenBudget?: number;
+    }): Promise<CoordinateResult>;
     /** Get status of the active team. */
     getStatus(): {
         agents: Array<{

package/dist/src/core/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EACtD,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAqB,UAAU,EACpE,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAK1D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAM;gBAGvB,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,MAAM,GAAE,kBAAuB,EAC/B,GAAG,CAAC,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB;IASvC,oCAAoC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB/E,wEAAwE;IAClE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB3E;;;OAGG;IACG,QAAQ,CACZ,KAAK,EAAE,IAAI,EAAE,EACb,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;IAwD5E,oCAAoC;IACpC,aAAa,IAAI,IAAI,GAAG,SAAS;IAIjC,qCAAqC;IACrC,SAAS,IAAI;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI;IAKjH,OAAO,CAAC,IAAI;CAGb"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/core/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EACtD,IAAI,EAAE,UAAU,EAAE,kBAAkB,EAAqB,UAAU,EAEpE,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAsB1D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACxC,eAAe,EAAE,UAAU,CAAA;IAC3B,YAAY,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAM;gBAGvB,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,MAAM,GAAE,kBAAuB,EAC/B,GAAG,CAAC,EAAE,MAAM,EACZ,iBAAiB,CAAC,EAAE,iBAAiB;IASvC,oCAAoC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgB/E,wEAAwE;IAClE,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAkB3E;;;OAGG;IACG,QAAQ,CACZ,KAAK,EAAE,IAAI,EAAE,EACb,YAAY,EAAE,SAAS,WAAW,EAAE,GACnC,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAAC,UAAU,EAAE,UAAU,CAAA;KAAE,CAAC;IAwD5E,oCAAoC;IACpC,aAAa,IAAI,IAAI,GAAG,SAAS;IAIjC;;;OAGG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GACpC,OAAO,CAAC,gBAAgB,CAAC;IAsF5B,qCAAqC;IACrC,SAAS,IAAI;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAA;KAAE,GAAG,IAAI;IAKjH,OAAO,CAAC,IAAI;CAGb"}

package/dist/src/core/orchestrator.js

@@ -1,13 +1,31 @@
 /**
  * Orchestrator — top-level coordinator for multi-agent workflows.
  *
- * Provides runAgent(), runTeam(), and runTasks() entry points.
+ * Provides runAgent(), runTeam(), runTasks(), and coordinate() entry points.
+ * The coordinate() method adds a planning phase where an LLM decomposes a
+ * complex goal into tasks with dependencies before executing them.
  */
 import { Agent } from './agent.js';
 import { Team } from './team.js';
 import { TaskQueue } from '../communication/task-queue.js';
 import { Semaphore } from '../scheduling/semaphore.js';
 const ZERO_USAGE = { input_tokens: 0, output_tokens: 0 };
+const COORDINATOR_SYSTEM_PROMPT = `You are a task decomposition coordinator. Given a complex goal and a list of available agents, break the goal into concrete tasks.
+
+Output a JSON array of tasks. Each task has:
+- "id": unique short string (e.g. "t1", "t2")
+- "title": brief task description (1 line)
+- "description": detailed instructions for the agent
+- "assignee": name of the agent best suited for this task
+- "dependsOn": array of task IDs that must complete first (or empty array)
+
+Rules:
+- Minimize dependencies — parallelize when possible
+- Each task should be self-contained enough for one agent to handle
+- Assign tasks to agents based on their roles/specializations
+- Keep the total number of tasks reasonable (2-8)
+
+Output ONLY the JSON array, no other text.`;
 export class Orchestrator {
     adapter;
     toolRegistry;
@@ -96,6 +114,82 @@ export class Orchestrator {
     getActiveTeam() {
         return this.activeTeam;
     }
+    /**
+     * Coordinator mode: LLM-driven task decomposition + parallel execution.
+     * Uses the adapter to plan tasks, then executes them via runTasks().
+     */
+    async coordinate(goal, agentConfigs, options) {
+        this.emit({ type: 'message', data: 'Coordinator: planning tasks...' });
+        // Step 1: Plan — ask LLM to decompose the goal into tasks
+        const agentList = agentConfigs.map(a => `- ${a.name}: ${a.systemPrompt?.slice(0, 100) ?? 'general assistant'}`).join('\n');
+        const planMessages = [{
+                role: 'user',
+                content: [{
+                        type: 'text',
+                        text: `Available agents:\n${agentList}\n\nGoal: ${goal}`,
+                    }],
+            }];
+        const planOptions = {
+            model: this.config.defaultModel ?? agentConfigs[0]?.model ?? 'qwen3',
+            systemPrompt: COORDINATOR_SYSTEM_PROMPT,
+            maxTokens: 1024,
+            temperature: 0.3,
+        };
+        let tasks;
+        let planUsage = ZERO_USAGE;
+        try {
+            const response = await this.adapter.chat(planMessages, planOptions);
+            planUsage = response.usage;
+            const text = response.content
+                .filter((b) => b.type === 'text')
+                .map(b => b.text)
+                .join('');
+            // Parse JSON from response (handle markdown code blocks)
+            const jsonMatch = text.match(/\[[\s\S]*\]/);
+            if (!jsonMatch)
+                throw new Error('No JSON array in planner response');
+            const parsed = JSON.parse(jsonMatch[0]);
+            tasks = parsed.map(t => ({
+                id: t.id,
+                title: t.title,
+                description: t.description,
+                status: 'pending',
+                assignee: t.assignee,
+                dependsOn: t.dependsOn,
+                createdAt: new Date(),
+                updatedAt: new Date(),
+            }));
+            this.emit({ type: 'message', data: `Coordinator: planned ${tasks.length} tasks` });
+        }
+        catch (err) {
+            // Fallback: single task assigned to first agent
+            tasks = [{
+                    id: 't1',
+                    title: goal.slice(0, 80),
+                    description: goal,
+                    status: 'pending',
+                    assignee: agentConfigs[0]?.name,
+                    createdAt: new Date(),
+                    updatedAt: new Date(),
+                }];
+            this.emit({ type: 'message', data: 'Coordinator: plan failed, using single-task fallback' });
+        }
+        // Step 2: Execute
+        const { results: taskResults, totalUsage: execUsage } = await this.runTasks(tasks, agentConfigs);
+        const totalUsage = addUsage(planUsage, execUsage);
+        const completed = Array.from(taskResults.values()).filter(r => r.success).length;
+        // Check token budget
+        if (options?.maxTokenBudget && (totalUsage.input_tokens + totalUsage.output_tokens) > options.maxTokenBudget) {
+            this.emit({ type: 'message', data: 'Coordinator: token budget exceeded' });
+        }
+        return {
+            success: completed === tasks.length,
+            taskResults,
+            totalTokenUsage: totalUsage,
+            plannedTasks: tasks.length,
+            completedTasks: completed,
+        };
+    }
     /** Get status of the active team. */
     getStatus() {
         if (!this.activeTeam)

package/dist/src/core/orchestrator.js.map

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

package/dist/src/core/permissions.d.ts

@@ -3,6 +3,10 @@
  *
  * Classifies tools by risk level and gates execution on user approval
  * depending on the current permission mode.
+ *
+ * Supports fine-grained rules:
+ *   - Glob patterns for file paths (e.g. "src/**" allows all file writes under src/)
+ *   - Prefix matching for bash commands (e.g. "npm test" allows "npm test --watch")
  */
 import type { PermissionMode, ToolRiskLevel, ApprovalCallback } from './types.js';
 export declare function classifyTool(toolName: string): ToolRiskLevel;
@@ -12,19 +16,43 @@ export declare class PermissionManager {
     private sessionAllowed;
     /** Tools persisted in ~/.cmdr/settings.json. */
     private persistedAllowed;
+    /** Path-based rules for file tools. */
+    private pathRules;
+    /** Command-prefix rules for bash tool. */
+    private bashRules;
+    /** Project root for resolving relative paths in rules. */
+    private projectRoot;
     constructor(mode?: PermissionMode);
+    setProjectRoot(root: string): void;
     /** Load persisted settings from ~/.cmdr/settings.json. */
     loadSettings(): Promise<void>;
     /** Save current persisted allow-list to disk. */
     private saveSettings;
     getMode(): PermissionMode;
     setMode(mode: PermissionMode): void;
+    /** Add a path rule (e.g. allow writes to "src/**"). */
+    addPathRule(pattern: string, allow?: boolean): void;
+    /** Add a bash command rule (e.g. allow "npm test"). */
+    addBashRule(prefix: string, allow?: boolean): void;
+    /**
+     * Check if a specific file path is allowed by path rules.
+     * Returns true (allowed), false (denied), or undefined (no matching rule).
+     */
+    private checkPathRules;
+    /**
+     * Check if a bash command matches any bash rules.
+     * Returns true (allowed), false (denied), or undefined (no matching rule).
+     */
+    private checkBashRules;
+    /**
+     * Check fine-grained rules for a specific tool invocation.
+     * Returns true if auto-approved by rules, false otherwise.
+     */
+    private checkFineGrainedRules;
     /**
      * Decide whether a tool call should proceed.
-     *
-     * Returns true if auto-approved, false if the user must be prompted.
      */
-    needsApproval(toolName: string): boolean;
+    needsApproval(toolName: string, input?: Record<string, unknown>): boolean;
     /**
      * Gate a tool call. If approval is needed, calls the approvalCallback.
      * Returns the decision (allow/deny). Handles 'allow-always' by recording it.

package/dist/src/core/permissions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/core/permissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAA;AA6BnG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAI5D;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAgB;IAC5B,+DAA+D;IAC/D,OAAO,CAAC,cAAc,CAAoB;IAC1C,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAoB;gBAEhC,IAAI,GAAE,cAAyB;IAI3C,0DAA0D;IACpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC,iDAAiD;YACnC,YAAY;IAa1B,OAAO,IAAI,cAAc;IAIzB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAMnC;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAmBxC;;;OAGG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;IAkB5B,kDAAkD;IAClD,YAAY,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/core/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAoDnG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAI5D;AAyBD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAgB;IAC5B,+DAA+D;IAC/D,OAAO,CAAC,cAAc,CAAoB;IAC1C,gDAAgD;IAChD,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,uCAAuC;IACvC,OAAO,CAAC,SAAS,CAAiB;IAClC,0CAA0C;IAC1C,OAAO,CAAC,SAAS,CAAiB;IAClC,0DAA0D;IAC1D,OAAO,CAAC,WAAW,CAAwB;gBAE/B,IAAI,GAAE,cAAyB;IAI3C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC,0DAA0D;IACpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBnC,iDAAiD;YACnC,YAAY;IAe1B,OAAO,IAAI,cAAc;IAIzB,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAKnC,uDAAuD;IACvD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc,GAAG,IAAI;IAIzD,uDAAuD;IACvD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,OAAc,GAAG,IAAI;IAIxD;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAsB7B;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAsBzE;;;OAGG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,gBAAgB,EAAE,gBAAgB,GACjC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;IAkB5B,kDAAkD;IAClD,YAAY,IAAI,IAAI;CAGrB"}