cmdr-agent 2.1.2 → 2.3.0

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

@@ -0,0 +1,61 @@
+/**
+ * Hooks — shell-based pre/post hooks for tool and command lifecycle.
+ *
+ * Hooks are defined in .cmdr.toml under [hooks]:
+ *   [hooks]
+ *   "pre:tool:bash" = "echo 'About to run bash tool'"
+ *   "post:tool:file_write" = "./scripts/lint-changed.sh"
+ *   "pre:command:commit" = "npm test"
+ *   "session:end" = "./scripts/cleanup.sh"
+ *
+ * Hook types:
+ *   pre:tool:<name>   — runs before a tool executes (can block on non-zero exit)
+ *   post:tool:<name>  — runs after a tool completes
+ *   pre:command:<name> — runs before a slash command
+ *   post:command:<name> — runs after a slash command
+ *   session:start     — runs when session begins
+ *   session:end       — runs when session ends
+ *
+ * Hooks receive context via environment variables:
+ *   CMDR_HOOK_TYPE, CMDR_TOOL_NAME, CMDR_TOOL_INPUT (JSON), CMDR_CWD
+ */
+export interface HookConfig {
+    [pattern: string]: string;
+}
+export interface HookResult {
+    success: boolean;
+    output?: string;
+    error?: string;
+}
+export declare class HookManager {
+    private hooks;
+    private cwd;
+    constructor(hookConfig?: HookConfig, cwd?: string);
+    /** Register hooks from config. */
+    loadConfig(config: HookConfig): void;
+    /** Find matching hooks for a given event pattern. */
+    private findHooks;
+    /** Execute a hook command. Returns result with success/failure info. */
+    private executeHook;
+    /**
+     * Run pre-tool hooks. Returns false if a hook blocks execution (non-zero exit).
+     */
+    runPreTool(toolName: string, input: Record<string, unknown>): Promise<{
+        allowed: boolean;
+        output?: string;
+    }>;
+    /** Run post-tool hooks (informational — cannot block). */
+    runPostTool(toolName: string, input: Record<string, unknown>, success: boolean): Promise<void>;
+    /** Run session lifecycle hooks. */
+    runSessionHook(type: 'session:start' | 'session:end'): Promise<void>;
+    /** Wire hooks into the EventBus for automatic firing. */
+    wireEventBus(): void;
+    /** Get the number of registered hooks. */
+    get count(): number;
+    /** List all registered hook patterns. */
+    list(): Array<{
+        pattern: string;
+        command: string;
+    }>;
+}
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/core/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,MAAM,WAAW,UAAU;IACzB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,GAAG,CAAQ;gBAEP,UAAU,GAAE,UAAe,EAAE,GAAG,GAAE,MAAsB;IAOpE,kCAAkC;IAClC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAMpC,qDAAqD;IACrD,OAAO,CAAC,SAAS;IAUjB,wEAAwE;IACxE,OAAO,CAAC,WAAW;IAmBnB;;OAEG;IACG,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAqBjD,0DAA0D;IACpD,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAiBhB,mCAAmC;IAC7B,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E,yDAAyD;IACzD,YAAY,IAAI,IAAI;IAepB,0CAA0C;IAC1C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,yCAAyC;IACzC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAGpD"}

package/dist/src/core/hooks.js

@@ -0,0 +1,140 @@
+/**
+ * Hooks — shell-based pre/post hooks for tool and command lifecycle.
+ *
+ * Hooks are defined in .cmdr.toml under [hooks]:
+ *   [hooks]
+ *   "pre:tool:bash" = "echo 'About to run bash tool'"
+ *   "post:tool:file_write" = "./scripts/lint-changed.sh"
+ *   "pre:command:commit" = "npm test"
+ *   "session:end" = "./scripts/cleanup.sh"
+ *
+ * Hook types:
+ *   pre:tool:<name>   — runs before a tool executes (can block on non-zero exit)
+ *   post:tool:<name>  — runs after a tool completes
+ *   pre:command:<name> — runs before a slash command
+ *   post:command:<name> — runs after a slash command
+ *   session:start     — runs when session begins
+ *   session:end       — runs when session ends
+ *
+ * Hooks receive context via environment variables:
+ *   CMDR_HOOK_TYPE, CMDR_TOOL_NAME, CMDR_TOOL_INPUT (JSON), CMDR_CWD
+ */
+import { execSync } from 'node:child_process';
+import { globalEventBus } from './event-bus.js';
+const HOOK_TIMEOUT_MS = 30_000;
+export class HookManager {
+    hooks = new Map();
+    cwd;
+    constructor(hookConfig = {}, cwd = process.cwd()) {
+        this.cwd = cwd;
+        for (const [pattern, command] of Object.entries(hookConfig)) {
+            this.hooks.set(pattern, command);
+        }
+    }
+    /** Register hooks from config. */
+    loadConfig(config) {
+        for (const [pattern, command] of Object.entries(config)) {
+            this.hooks.set(pattern, command);
+        }
+    }
+    /** Find matching hooks for a given event pattern. */
+    findHooks(pattern) {
+        const matches = [];
+        for (const [hookPattern, command] of this.hooks) {
+            if (hookPattern === pattern) {
+                matches.push({ pattern: hookPattern, command });
+            }
+        }
+        return matches;
+    }
+    /** Execute a hook command. Returns result with success/failure info. */
+    executeHook(command, env) {
+        try {
+            const output = execSync(command, {
+                cwd: this.cwd,
+                timeout: HOOK_TIMEOUT_MS,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: { ...process.env, ...env },
+            }).toString().trim();
+            return { success: true, output };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return { success: false, error: message };
+        }
+    }
+    /**
+     * Run pre-tool hooks. Returns false if a hook blocks execution (non-zero exit).
+     */
+    async runPreTool(toolName, input) {
+        const hooks = this.findHooks(`pre:tool:${toolName}`);
+        if (hooks.length === 0)
+            return { allowed: true };
+        const env = {
+            CMDR_HOOK_TYPE: 'pre:tool',
+            CMDR_TOOL_NAME: toolName,
+            CMDR_TOOL_INPUT: JSON.stringify(input),
+            CMDR_CWD: this.cwd,
+        };
+        for (const hook of hooks) {
+            const result = this.executeHook(hook.command, env);
+            if (!result.success) {
+                return { allowed: false, output: result.error };
+            }
+        }
+        return { allowed: true };
+    }
+    /** Run post-tool hooks (informational — cannot block). */
+    async runPostTool(toolName, input, success) {
+        const hooks = this.findHooks(`post:tool:${toolName}`);
+        if (hooks.length === 0)
+            return;
+        const env = {
+            CMDR_HOOK_TYPE: 'post:tool',
+            CMDR_TOOL_NAME: toolName,
+            CMDR_TOOL_INPUT: JSON.stringify(input),
+            CMDR_TOOL_SUCCESS: String(success),
+            CMDR_CWD: this.cwd,
+        };
+        for (const hook of hooks) {
+            this.executeHook(hook.command, env);
+        }
+    }
+    /** Run session lifecycle hooks. */
+    async runSessionHook(type) {
+        const hooks = this.findHooks(type);
+        if (hooks.length === 0)
+            return;
+        const env = {
+            CMDR_HOOK_TYPE: type,
+            CMDR_CWD: this.cwd,
+        };
+        for (const hook of hooks) {
+            this.executeHook(hook.command, env);
+        }
+    }
+    /** Wire hooks into the EventBus for automatic firing. */
+    wireEventBus() {
+        globalEventBus.on('tool:before', async (data) => {
+            await this.runPreTool(data.name, data.input);
+        });
+        globalEventBus.on('tool:after', async (data) => {
+            await this.runPostTool(data.name, {}, !data.result.isError);
+        });
+        globalEventBus.on('session:start', async () => {
+            await this.runSessionHook('session:start');
+        });
+        globalEventBus.on('session:end', async () => {
+            await this.runSessionHook('session:end');
+        });
+    }
+    /** Get the number of registered hooks. */
+    get count() {
+        return this.hooks.size;
+    }
+    /** List all registered hook patterns. */
+    list() {
+        return Array.from(this.hooks.entries()).map(([pattern, command]) => ({ pattern, command }));
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/core/hooks.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,8 +3,33 @@
  *
  * 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';
+/**
+ * Pattern rule: "Tool(specifier)" format.
+ * Examples:
+ *   allow: ["bash(npm run *)", "file_read(src/**)"]
+ *   deny:  ["bash(curl *)", "file_read(.env)"]
+ *   ask:   ["bash(git push *)"]
+ *
+ * Priority: deny > ask > allow (most restrictive wins).
+ */
+export interface PermissionRule {
+    /** 'allow' auto-approves, 'deny' auto-blocks, 'ask' always prompts. */
+    action: 'allow' | 'deny' | 'ask';
+    /** Tool name to match. */
+    tool: string;
+    /** Optional glob pattern for the tool's primary argument. */
+    pattern?: string;
+}
+/**
+ * Parse a permission rule string like "bash(npm run *)" into structured form.
+ */
+export declare function parsePermissionRule(rule: string, action: 'allow' | 'deny' | 'ask'): PermissionRule;
 export declare function classifyTool(toolName: string): ToolRiskLevel;
 export declare class PermissionManager {
     private mode;
@@ -12,22 +37,68 @@ 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;
+    /** Pattern-based permission rules (Tool(pattern) syntax). */
+    private permissionRules;
+    /** 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;
+    /** Add a pattern permission rule (e.g. "bash(npm run *)" with action "allow"). */
+    addPermissionRule(ruleString: string, action: 'allow' | 'deny' | 'ask'): void;
+    /** Load permission rules from config format: { allow: [...], deny: [...], ask: [...] } */
+    loadPermissionRules(config: {
+        allow?: string[];
+        deny?: string[];
+        ask?: string[];
+    }): 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;
+    /**
+     * Check pattern-based permission rules.
+     * Priority: deny > ask > allow (most restrictive wins).
+     * Returns 'allow', 'deny', 'ask', or undefined if no matching rule.
+     */
+    private checkPermissionRules;
+    /**
+     * Extract the primary argument from tool input for pattern matching.
+     * Each tool type uses a different "primary" argument.
+     */
+    private getPrimaryArg;
     /**
      * 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.
+     * Pattern deny rules auto-block without prompting.
      */
     gate(toolName: string, input: Record<string, unknown>, approvalCallback: ApprovalCallback): Promise<'allow' | 'deny'>;
     /** Reset session-allowed set (e.g. on /clear). */

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;AAiCnG;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IAChC,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,cAAc,CAUlG;AAkCD,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,6DAA6D;IAC7D,OAAO,CAAC,eAAe,CAAuB;IAC9C,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;IA0BnC,iDAAiD;YACnC,YAAY;IAgB1B,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,kFAAkF;IAClF,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;IAI7E,0FAA0F;IAC1F,mBAAmB,CAAC,MAAM,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,IAAI;IAYxF;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAWtB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAmC5B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAsBzE;;;;OAIG;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;IAsB5B,kDAAkD;IAClD,YAAY,IAAI,IAAI;CAGrB"}