cmdr-agent 1.0.0

package/dist/src/config/schema.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Configuration schema — Zod validation for cmdr config.
+ */
+import { z } from 'zod';
+export declare const McpServerSchema: z.ZodObject<{
+    name: z.ZodString;
+    url: z.ZodString;
+    apiKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    url: string;
+    apiKey?: string | undefined;
+}, {
+    name: string;
+    url: string;
+    apiKey?: string | undefined;
+}>;
+export declare const CmdrConfigSchema: z.ZodObject<{
+    ollamaUrl: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    defaultModel: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    defaultProvider: z.ZodOptional<z.ZodDefault<z.ZodEnum<["ollama", "openai", "anthropic"]>>>;
+    maxConcurrency: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    contextBudget: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    autoCompact: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    permissions: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        allowBash: z.ZodDefault<z.ZodBoolean>;
+        allowFileWrite: z.ZodDefault<z.ZodBoolean>;
+        allowNetwork: z.ZodDefault<z.ZodBoolean>;
+        sandboxDir: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        allowBash: boolean;
+        allowFileWrite: boolean;
+        allowNetwork: boolean;
+        sandboxDir?: string | undefined;
+    }, {
+        allowBash?: boolean | undefined;
+        allowFileWrite?: boolean | undefined;
+        allowNetwork?: boolean | undefined;
+        sandboxDir?: string | undefined;
+    }>>>;
+    mcp: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        servers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            url: z.ZodString;
+            apiKey: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            url: string;
+            apiKey?: string | undefined;
+        }, {
+            name: string;
+            url: string;
+            apiKey?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        servers: {
+            name: string;
+            url: string;
+            apiKey?: string | undefined;
+        }[];
+    }, {
+        servers?: {
+            name: string;
+            url: string;
+            apiKey?: string | undefined;
+        }[] | undefined;
+    }>>>;
+    plugins: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
+    spinner: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        verbs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        mode: z.ZodDefault<z.ZodEnum<["append", "replace"]>>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "replace" | "append";
+        verbs?: string[] | undefined;
+    }, {
+        verbs?: string[] | undefined;
+        mode?: "replace" | "append" | undefined;
+    }>>>;
+    telemetry: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    ollamaUrl?: string | undefined;
+    defaultModel?: string | undefined;
+    defaultProvider?: "ollama" | "openai" | "anthropic" | undefined;
+    maxConcurrency?: number | undefined;
+    contextBudget?: number | undefined;
+    autoCompact?: boolean | undefined;
+    permissions?: {
+        allowBash: boolean;
+        allowFileWrite: boolean;
+        allowNetwork: boolean;
+        sandboxDir?: string | undefined;
+    } | undefined;
+    mcp?: {
+        servers: {
+            name: string;
+            url: string;
+            apiKey?: string | undefined;
+        }[];
+    } | undefined;
+    plugins?: string[] | undefined;
+    spinner?: {
+        mode: "replace" | "append";
+        verbs?: string[] | undefined;
+    } | undefined;
+    telemetry?: boolean | undefined;
+}, {
+    ollamaUrl?: string | undefined;
+    defaultModel?: string | undefined;
+    defaultProvider?: "ollama" | "openai" | "anthropic" | undefined;
+    maxConcurrency?: number | undefined;
+    contextBudget?: number | undefined;
+    autoCompact?: boolean | undefined;
+    permissions?: {
+        allowBash?: boolean | undefined;
+        allowFileWrite?: boolean | undefined;
+        allowNetwork?: boolean | undefined;
+        sandboxDir?: string | undefined;
+    } | undefined;
+    mcp?: {
+        servers?: {
+            name: string;
+            url: string;
+            apiKey?: string | undefined;
+        }[] | undefined;
+    } | undefined;
+    plugins?: string[] | undefined;
+    spinner?: {
+        verbs?: string[] | undefined;
+        mode?: "replace" | "append" | undefined;
+    } | undefined;
+    telemetry?: boolean | undefined;
+}>;
+export type CmdrConfigInput = z.input<typeof CmdrConfigSchema>;
+export type CmdrConfigParsed = z.output<typeof CmdrConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/src/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAA;AAEF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBjB,CAAA;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAC9D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAA"}

package/dist/src/config/schema.js

@@ -0,0 +1,35 @@
+/**
+ * Configuration schema — Zod validation for cmdr config.
+ */
+import { z } from 'zod';
+export const McpServerSchema = z.object({
+    name: z.string(),
+    url: z.string().url(),
+    apiKey: z.string().optional(),
+});
+export const CmdrConfigSchema = z.object({
+    ollamaUrl: z.string().url().default('http://localhost:11434'),
+    defaultModel: z.string().default('qwen2.5-coder:14b'),
+    defaultProvider: z.enum(['ollama', 'openai', 'anthropic']).default('ollama'),
+    maxConcurrency: z.number().int().min(1).max(16).default(2),
+    contextBudget: z.number().int().min(1024).default(32768),
+    autoCompact: z.boolean().default(true),
+    permissions: z.object({
+        allowBash: z.boolean().default(true),
+        allowFileWrite: z.boolean().default(true),
+        allowNetwork: z.boolean().default(false),
+        sandboxDir: z.string().optional(),
+    }).default({}),
+    mcp: z.object({
+        servers: z.array(McpServerSchema).default([]),
+    }).default({}),
+    plugins: z.array(z.string()).default([]),
+    // Spinner customization
+    spinner: z.object({
+        verbs: z.array(z.string()).optional(),
+        mode: z.enum(['append', 'replace']).default('append'),
+    }).optional(),
+    // Telemetry opt-in
+    telemetry: z.boolean().default(false),
+}).partial();
+//# sourceMappingURL=schema.js.map

package/dist/src/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC;IAC7D,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,mBAAmB,CAAC;IACrD,eAAe,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAC5E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACxD,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACpC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;QACzC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAClC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACd,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC;QACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KAC9C,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACd,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACxC,wBAAwB;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QACrC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;KACtD,CAAC,CAAC,QAAQ,EAAE;IACb,mBAAmB;IACnB,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACtC,CAAC,CAAC,OAAO,EAAE,CAAA"}

package/dist/src/config/telemetry.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Telemetry — opt-in anonymous session telemetry.
+ *
+ * No data is sent unless the user explicitly enables it in ~/.cmdr/config.toml:
+ *   [telemetry]
+ *   enabled = true
+ *
+ * When enabled, session summaries are written to ~/.cmdr/telemetry/ as JSON
+ * for the user's own analysis. No network calls are made.
+ */
+export interface TelemetryEvent {
+    readonly id: string;
+    readonly timestamp: string;
+    readonly sessionId: string;
+    readonly event: string;
+    readonly data: Record<string, unknown>;
+}
+export declare class Telemetry {
+    private enabled;
+    private readonly sessionId;
+    private readonly dir;
+    /** Enable or disable telemetry. */
+    setEnabled(enabled: boolean): void;
+    isEnabled(): boolean;
+    /**
+     * Record a telemetry event to disk.
+     * Only writes if telemetry is enabled. No data leaves the machine.
+     */
+    record(event: string, data: Record<string, unknown>): Promise<void>;
+    /**
+     * Record a session summary at exit.
+     */
+    recordSessionEnd(summary: {
+        model: string;
+        turns: number;
+        totalTokens: number;
+        toolCalls: number;
+        durationSeconds: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/src/config/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../../../src/config/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwC;IAE5D,mCAAmC;IACnC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE;QAC9B,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,eAAe,EAAE,MAAM,CAAA;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlB"}

package/dist/src/config/telemetry.js

@@ -0,0 +1,57 @@
+/**
+ * Telemetry — opt-in anonymous session telemetry.
+ *
+ * No data is sent unless the user explicitly enables it in ~/.cmdr/config.toml:
+ *   [telemetry]
+ *   enabled = true
+ *
+ * When enabled, session summaries are written to ~/.cmdr/telemetry/ as JSON
+ * for the user's own analysis. No network calls are made.
+ */
+import { writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { homedir } from 'os';
+import { randomUUID } from 'crypto';
+export class Telemetry {
+    enabled = false;
+    sessionId = randomUUID();
+    dir = join(homedir(), '.cmdr', 'telemetry');
+    /** Enable or disable telemetry. */
+    setEnabled(enabled) {
+        this.enabled = enabled;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Record a telemetry event to disk.
+     * Only writes if telemetry is enabled. No data leaves the machine.
+     */
+    async record(event, data) {
+        if (!this.enabled)
+            return;
+        const entry = {
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+            sessionId: this.sessionId,
+            event,
+            data,
+        };
+        try {
+            await mkdir(this.dir, { recursive: true });
+            const filename = `${this.sessionId}.jsonl`;
+            const line = JSON.stringify(entry) + '\n';
+            await writeFile(join(this.dir, filename), line, { flag: 'a' });
+        }
+        catch {
+            // best-effort — never break the REPL for telemetry
+        }
+    }
+    /**
+     * Record a session summary at exit.
+     */
+    async recordSessionEnd(summary) {
+        await this.record('session_end', summary);
+    }
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/src/config/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../../src/config/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAUnC,MAAM,OAAO,SAAS;IACZ,OAAO,GAAG,KAAK,CAAA;IACN,SAAS,GAAG,UAAU,EAAE,CAAA;IACxB,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,CAAA;IAE5D,mCAAmC;IACnC,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAA6B;QACvD,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEzB,MAAM,KAAK,GAAmB;YAC5B,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK;YACL,IAAI;SACL,CAAA;QAED,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAC1C,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,SAAS,QAAQ,CAAA;YAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAA;YACzC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,mDAAmD;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAMtB;QACC,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;CACF"}

package/dist/src/core/agent-pool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * AgentPool — parallel agent execution with semaphore-controlled concurrency.
+ */
+import { Agent } from './agent.js';
+import type { AgentConfig, AgentRunResult, LLMAdapter } from './types.js';
+import type { ToolRegistry } from '../tools/registry.js';
+import type { PermissionManager } from './permissions.js';
+export interface PoolOptions {
+    readonly maxConcurrency: number;
+    readonly cwd?: string;
+}
+export declare class AgentPool {
+    private readonly adapter;
+    private readonly toolRegistry;
+    private readonly options;
+    private readonly permissionManager?;
+    private readonly agents;
+    private readonly semaphore;
+    private readonly cwd;
+    constructor(adapter: LLMAdapter, toolRegistry: ToolRegistry, options: PoolOptions, permissionManager?: PermissionManager | undefined);
+    /** Create or get an agent by config. */
+    getOrCreate(config: AgentConfig): Agent;
+    /** Run a task on a named agent, respecting concurrency limits. */
+    runTask(agentName: string, task: string): Promise<AgentRunResult>;
+    /** Run tasks in parallel across multiple agents. */
+    runParallel(assignments: Array<{
+        agentName: string;
+        task: string;
+    }>): Promise<Map<string, AgentRunResult>>;
+    /** Get the current load of each agent. */
+    getLoads(): Array<{
+        name: string;
+        status: string;
+    }>;
+    /** Get all agents in the pool. */
+    getAgents(): Map<string, Agent>;
+    /** Reset all agents. */
+    resetAll(): void;
+}
+//# sourceMappingURL=agent-pool.d.ts.map

package/dist/src/core/agent-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-pool.d.ts","sourceRoot":"","sources":["../../../src/core/agent-pool.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,KAAK,EACV,WAAW,EAAE,cAAc,EAAE,UAAU,EACxC,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGzD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qBAAa,SAAS;IAMlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IARrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAQ;gBAGT,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,WAAW,EACpB,iBAAiB,CAAC,EAAE,iBAAiB,YAAA;IAMxD,wCAAwC;IACxC,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,KAAK;IASvC,kEAAkE;IAC5D,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAMvE,oDAAoD;IAC9C,WAAW,CACf,WAAW,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,GACtD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAYvC,0CAA0C;IAC1C,QAAQ,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAOnD,kCAAkC;IAClC,SAAS,IAAI,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;IAI/B,wBAAwB;IACxB,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/src/core/agent-pool.js

@@ -0,0 +1,66 @@
+/**
+ * AgentPool — parallel agent execution with semaphore-controlled concurrency.
+ */
+import { Agent } from './agent.js';
+import { Semaphore } from '../scheduling/semaphore.js';
+export class AgentPool {
+    adapter;
+    toolRegistry;
+    options;
+    permissionManager;
+    agents = new Map();
+    semaphore;
+    cwd;
+    constructor(adapter, toolRegistry, options, permissionManager) {
+        this.adapter = adapter;
+        this.toolRegistry = toolRegistry;
+        this.options = options;
+        this.permissionManager = permissionManager;
+        this.semaphore = new Semaphore(options.maxConcurrency);
+        this.cwd = options.cwd ?? process.cwd();
+    }
+    /** Create or get an agent by config. */
+    getOrCreate(config) {
+        let agent = this.agents.get(config.name);
+        if (!agent) {
+            agent = new Agent(config, this.adapter, this.toolRegistry, this.cwd, this.permissionManager);
+            this.agents.set(config.name, agent);
+        }
+        return agent;
+    }
+    /** Run a task on a named agent, respecting concurrency limits. */
+    async runTask(agentName, task) {
+        const agent = this.agents.get(agentName);
+        if (!agent)
+            throw new Error(`Agent "${agentName}" not found in pool`);
+        return this.semaphore.run(() => agent.run(task));
+    }
+    /** Run tasks in parallel across multiple agents. */
+    async runParallel(assignments) {
+        const results = new Map();
+        const promises = assignments.map(async ({ agentName, task }) => {
+            const result = await this.runTask(agentName, task);
+            results.set(agentName, result);
+        });
+        await Promise.all(promises);
+        return results;
+    }
+    /** Get the current load of each agent. */
+    getLoads() {
+        return Array.from(this.agents.entries()).map(([name, agent]) => ({
+            name,
+            status: agent.getState().status,
+        }));
+    }
+    /** Get all agents in the pool. */
+    getAgents() {
+        return new Map(this.agents);
+    }
+    /** Reset all agents. */
+    resetAll() {
+        for (const agent of this.agents.values()) {
+            agent.reset();
+        }
+    }
+}
+//# sourceMappingURL=agent-pool.js.map

package/dist/src/core/agent-pool.js.map

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

package/dist/src/core/agent-runner.d.ts

@@ -0,0 +1,51 @@
+/**
+ * AgentRunner — the core conversation loop engine for cmdr.
+ *
+ * Drives: LLM call -> tool extraction -> parallel execution -> tool results -> loop
+ */
+import type { LLMMessage, ToolCallRecord, TokenUsage, StreamEvent, ToolResult, LLMAdapter, ApprovalCallback } from '../core/types.js';
+import type { ToolRegistry } from '../tools/registry.js';
+import type { ToolExecutor } from '../tools/executor.js';
+import type { PermissionManager } from './permissions.js';
+export interface RunnerOptions {
+    readonly model: string;
+    readonly systemPrompt?: string;
+    readonly maxTurns?: number;
+    readonly maxTokens?: number;
+    readonly temperature?: number;
+    readonly abortSignal?: AbortSignal;
+    readonly allowedTools?: readonly string[];
+    readonly agentName?: string;
+    readonly agentRole?: string;
+    readonly cwd?: string;
+}
+export interface RunCallbacks {
+    readonly onToolCall?: (name: string, input: Record<string, unknown>) => void;
+    readonly onToolResult?: (name: string, result: ToolResult) => void;
+    readonly onMessage?: (message: LLMMessage) => void;
+    readonly onText?: (text: string) => void;
+    /** If provided, the runner will ask for approval before executing write/dangerous tools. */
+    readonly onToolApproval?: ApprovalCallback;
+}
+export interface RunResult {
+    readonly messages: LLMMessage[];
+    readonly output: string;
+    readonly toolCalls: ToolCallRecord[];
+    readonly tokenUsage: TokenUsage;
+    readonly turns: number;
+}
+export declare class AgentRunner {
+    private readonly adapter;
+    private readonly toolRegistry;
+    private readonly toolExecutor;
+    private readonly options;
+    private readonly permissionManager?;
+    private readonly maxTurns;
+    constructor(adapter: LLMAdapter, toolRegistry: ToolRegistry, toolExecutor: ToolExecutor, options: RunnerOptions, permissionManager?: PermissionManager | undefined);
+    /** Run a complete conversation, collecting all stream events internally. */
+    run(messages: LLMMessage[], callbacks?: RunCallbacks): Promise<RunResult>;
+    /** Run the conversation and yield StreamEvents incrementally.
+     *  Uses the adapter's stream() for real-time token-by-token output. */
+    stream(initialMessages: LLMMessage[], callbacks?: RunCallbacks): AsyncGenerator<StreamEvent>;
+}
+//# sourceMappingURL=agent-runner.d.ts.map

package/dist/src/core/agent-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../src/core/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EACnD,UAAU,EAA+B,gBAAgB,EAC1D,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAOzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAA;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IAC5E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAA;IAClD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,4FAA4F;IAC5F,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAA;CAC3C;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAA;IACpC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AA8BD,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAPrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAGd,OAAO,EAAE,UAAU,EACnB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,aAAa,EACtB,iBAAiB,CAAC,EAAE,iBAAiB,YAAA;IAKxD,4EAA4E;IACtE,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,SAAS,GAAE,YAAiB,GAAG,OAAO,CAAC,SAAS,CAAC;IAkBnF;2EACuE;IAChE,MAAM,CACX,eAAe,EAAE,UAAU,EAAE,EAC7B,SAAS,GAAE,YAAiB,GAC3B,cAAc,CAAC,WAAW,CAAC;CAwN/B"}