@cdoing/core 0.1.0

package/dist/agents/coordinator.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Multi-Agent Coordinator — Orchestrates multiple sub-agents for complex tasks.
+ *
+ * The coordinator pattern splits complex tasks into subtasks, assigns each
+ * to a specialized sub-agent, and merges results.
+ *
+ * Architecture:
+ *   User Request
+ *       │
+ *   ┌───▼───┐
+ *   │Coordinator│ ← Breaks task into subtasks
+ *   └───┬───┘
+ *       │
+ *   ┌───┼───┬───┐
+ *   │   │   │   │
+ *   ▼   ▼   ▼   ▼
+ *  Agent Agent Agent Agent  ← Run in parallel
+ *   │   │   │   │
+ *   └───┼───┴───┘
+ *       │
+ *   ┌───▼───┐
+ *   │ Merge  │ ← Combine results
+ *   └───────┘
+ *
+ * Learning note: This is the Scatter-Gather pattern. The coordinator
+ * "scatters" work to sub-agents and "gathers" their results. This is
+ * particularly effective for:
+ *   - Searching across many files simultaneously
+ *   - Making independent changes to different files
+ *   - Running analysis tasks that don't depend on each other
+ */
+/**
+ * A subtask assigned to a sub-agent.
+ */
+export interface Subtask {
+    /** Unique subtask ID */
+    id: string;
+    /** Description of what this subtask should accomplish */
+    description: string;
+    /** System prompt override for this subtask's agent */
+    systemPrompt?: string;
+    /** Whether this subtask can run in parallel with others */
+    parallel: boolean;
+    /** Dependencies: IDs of subtasks that must complete first */
+    dependsOn: string[];
+    /** Current status */
+    status: "pending" | "running" | "completed" | "failed";
+    /** Result of the subtask (populated after completion) */
+    result?: string;
+    /** Error message if the subtask failed */
+    error?: string;
+}
+/**
+ * Callback interface for coordinator events.
+ */
+export interface CoordinatorCallbacks {
+    /** Called when a subtask starts */
+    onSubtaskStart: (subtask: Subtask) => void;
+    /** Called when a subtask completes */
+    onSubtaskComplete: (subtask: Subtask) => void;
+    /** Called when a subtask fails */
+    onSubtaskError: (subtask: Subtask, error: Error) => void;
+    /** Called when all subtasks are complete */
+    onAllComplete: (results: Subtask[]) => void;
+}
+/**
+ * The function signature for running a sub-agent.
+ * This is provided by the AgentRunner — we don't import it directly
+ * to avoid circular dependencies between core and ai packages.
+ */
+export type SubAgentRunner = (prompt: string, systemPrompt?: string) => Promise<string>;
+export declare class AgentCoordinator {
+    private subtasks;
+    private runAgent;
+    constructor(runAgent: SubAgentRunner);
+    /**
+     * Add a subtask to the coordinator.
+     */
+    addSubtask(description: string, options?: {
+        systemPrompt?: string;
+        parallel?: boolean;
+        dependsOn?: string[];
+    }): Subtask;
+    /**
+     * Execute all subtasks respecting dependencies and parallelism.
+     *
+     * Algorithm:
+     *   1. Find all subtasks whose dependencies are met
+     *   2. Run parallel-safe ones concurrently
+     *   3. Run sequential ones in order
+     *   4. Repeat until all done
+     *
+     * Learning note: This is a topological sort execution — we process
+     * subtasks in dependency order, maximizing parallelism where possible.
+     */
+    execute(callbacks?: Partial<CoordinatorCallbacks>): Promise<Subtask[]>;
+    /**
+     * Run a single subtask using the sub-agent runner.
+     */
+    private runSubtask;
+    /**
+     * Get all subtask results as a formatted summary.
+     */
+    getSummary(): string;
+    /**
+     * Get all subtasks.
+     */
+    getSubtasks(): Subtask[];
+    /**
+     * Clear all subtasks.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/agents/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../src/agents/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,yDAAyD;IACzD,WAAW,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAElB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,qBAAqB;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IAEvD,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE3C,sCAAsC;IACtC,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAE9C,kCAAkC;IAClC,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEzD,4CAA4C;IAC5C,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CAC7C;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAExF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAiB;gBAErB,QAAQ,EAAE,cAAc;IAIpC;;OAEG;IACH,UAAU,CACR,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,GACA,OAAO;IAcV;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAmD5E;;OAEG;YACW,UAAU;IAmBxB;;OAEG;IACH,UAAU,IAAI,MAAM;IAqBpB;;OAEG;IACH,WAAW,IAAI,OAAO,EAAE;IAIxB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/agents/coordinator.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * Multi-Agent Coordinator — Orchestrates multiple sub-agents for complex tasks.
+ *
+ * The coordinator pattern splits complex tasks into subtasks, assigns each
+ * to a specialized sub-agent, and merges results.
+ *
+ * Architecture:
+ *   User Request
+ *       │
+ *   ┌───▼───┐
+ *   │Coordinator│ ← Breaks task into subtasks
+ *   └───┬───┘
+ *       │
+ *   ┌───┼───┬───┐
+ *   │   │   │   │
+ *   ▼   ▼   ▼   ▼
+ *  Agent Agent Agent Agent  ← Run in parallel
+ *   │   │   │   │
+ *   └───┼───┴───┘
+ *       │
+ *   ┌───▼───┐
+ *   │ Merge  │ ← Combine results
+ *   └───────┘
+ *
+ * Learning note: This is the Scatter-Gather pattern. The coordinator
+ * "scatters" work to sub-agents and "gathers" their results. This is
+ * particularly effective for:
+ *   - Searching across many files simultaneously
+ *   - Making independent changes to different files
+ *   - Running analysis tasks that don't depend on each other
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentCoordinator = void 0;
+class AgentCoordinator {
+    subtasks = [];
+    runAgent;
+    constructor(runAgent) {
+        this.runAgent = runAgent;
+    }
+    /**
+     * Add a subtask to the coordinator.
+     */
+    addSubtask(description, options) {
+        const subtask = {
+            id: `subtask_${this.subtasks.length + 1}`,
+            description,
+            systemPrompt: options?.systemPrompt,
+            parallel: options?.parallel ?? true,
+            dependsOn: options?.dependsOn || [],
+            status: "pending",
+        };
+        this.subtasks.push(subtask);
+        return subtask;
+    }
+    /**
+     * Execute all subtasks respecting dependencies and parallelism.
+     *
+     * Algorithm:
+     *   1. Find all subtasks whose dependencies are met
+     *   2. Run parallel-safe ones concurrently
+     *   3. Run sequential ones in order
+     *   4. Repeat until all done
+     *
+     * Learning note: This is a topological sort execution — we process
+     * subtasks in dependency order, maximizing parallelism where possible.
+     */
+    async execute(callbacks) {
+        const completed = new Set();
+        while (completed.size < this.subtasks.length) {
+            // Find ready subtasks (all dependencies met)
+            const ready = this.subtasks.filter((t) => t.status === "pending" &&
+                t.dependsOn.every((dep) => completed.has(dep)));
+            if (ready.length === 0) {
+                // No ready tasks but not all complete — there's a dependency cycle
+                const stuck = this.subtasks.filter((t) => t.status === "pending");
+                for (const t of stuck) {
+                    t.status = "failed";
+                    t.error = "Dependency cycle detected";
+                }
+                break;
+            }
+            // Separate parallel and sequential tasks
+            const parallelTasks = ready.filter((t) => t.parallel);
+            const sequentialTasks = ready.filter((t) => !t.parallel);
+            // Run parallel tasks concurrently
+            if (parallelTasks.length > 0) {
+                await Promise.all(parallelTasks.map((task) => this.runSubtask(task, callbacks)));
+                for (const task of parallelTasks) {
+                    if (task.status === "completed") {
+                        completed.add(task.id);
+                    }
+                }
+            }
+            // Run sequential tasks one at a time
+            for (const task of sequentialTasks) {
+                await this.runSubtask(task, callbacks);
+                if (task.status === "completed") {
+                    completed.add(task.id);
+                }
+            }
+        }
+        callbacks?.onAllComplete?.(this.subtasks);
+        return this.subtasks;
+    }
+    /**
+     * Run a single subtask using the sub-agent runner.
+     */
+    async runSubtask(subtask, callbacks) {
+        subtask.status = "running";
+        callbacks?.onSubtaskStart?.(subtask);
+        try {
+            const result = await this.runAgent(subtask.description, subtask.systemPrompt);
+            subtask.result = result;
+            subtask.status = "completed";
+            callbacks?.onSubtaskComplete?.(subtask);
+        }
+        catch (err) {
+            subtask.status = "failed";
+            subtask.error = err instanceof Error ? err.message : String(err);
+            callbacks?.onSubtaskError?.(subtask, err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    /**
+     * Get all subtask results as a formatted summary.
+     */
+    getSummary() {
+        const lines = ["## Agent Coordinator Results\n"];
+        for (const task of this.subtasks) {
+            const icon = task.status === "completed" ? "✅"
+                : task.status === "failed" ? "❌"
+                    : task.status === "running" ? "⏳"
+                        : "⬜";
+            lines.push(`${icon} **${task.description}**`);
+            if (task.result) {
+                lines.push(`   ${task.result.substring(0, 200)}`);
+            }
+            if (task.error) {
+                lines.push(`   Error: ${task.error}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    /**
+     * Get all subtasks.
+     */
+    getSubtasks() {
+        return [...this.subtasks];
+    }
+    /**
+     * Clear all subtasks.
+     */
+    clear() {
+        this.subtasks = [];
+    }
+}
+exports.AgentCoordinator = AgentCoordinator;
+//# sourceMappingURL=coordinator.js.map

package/dist/agents/coordinator.js.map

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

package/dist/context-providers/clipboard.d.ts

@@ -0,0 +1,13 @@
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+/**
+ * @clip — pastes clipboard content into the prompt.
+ * Works on macOS (pbpaste), Linux with xclip/xsel/wl-paste.
+ */
+export declare class ClipboardContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(_arg?: string, _opts?: ContextResolveOptions): Promise<ContextResult>;
+}
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/context-providers/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../src/context-providers/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErF;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,EAAE,SAAe;IACjB,OAAO,SAAW;IAClB,WAAW,SAA8C;IACzD,WAAW,UAAS;IAEd,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;CAkCpF"}

package/dist/context-providers/clipboard.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClipboardContextProvider = void 0;
+const child_process_1 = require("child_process");
+/**
+ * @clip — pastes clipboard content into the prompt.
+ * Works on macOS (pbpaste), Linux with xclip/xsel/wl-paste.
+ */
+class ClipboardContextProvider {
+    id = "clipboard";
+    trigger = "@clip";
+    description = "Paste clipboard content into the message";
+    requiresArg = false;
+    async resolve(_arg, _opts) {
+        let content = "";
+        try {
+            const platform = process.platform;
+            if (platform === "darwin") {
+                content = (0, child_process_1.execSync)("pbpaste", { encoding: "utf8" });
+            }
+            else if (platform === "linux") {
+                // Try wl-paste (Wayland), then xclip, then xsel
+                try {
+                    content = (0, child_process_1.execSync)("wl-paste --no-newline 2>/dev/null", { encoding: "utf8" });
+                }
+                catch {
+                    try {
+                        content = (0, child_process_1.execSync)("xclip -selection clipboard -o 2>/dev/null", { encoding: "utf8" });
+                    }
+                    catch {
+                        content = (0, child_process_1.execSync)("xsel --clipboard --output 2>/dev/null", { encoding: "utf8" });
+                    }
+                }
+            }
+            else {
+                return { label: "Clipboard", content: "", metadata: { source: "unsupported platform" } };
+            }
+        }
+        catch {
+            return { label: "Clipboard", content: "(clipboard is empty or unavailable)" };
+        }
+        const trimmed = content.trim();
+        if (!trimmed)
+            return { label: "Clipboard", content: "(clipboard is empty)" };
+        return {
+            label: "Clipboard",
+            content: `<clipboard>\n${trimmed}\n</clipboard>`,
+            metadata: { source: "system clipboard", itemCount: trimmed.split("\n").length },
+        };
+    }
+}
+exports.ClipboardContextProvider = ClipboardContextProvider;
+//# sourceMappingURL=clipboard.js.map

package/dist/context-providers/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../src/context-providers/clipboard.ts"],"names":[],"mappings":";;;AAAA,iDAAyC;AAGzC;;;GAGG;AACH,MAAa,wBAAwB;IACnC,EAAE,GAAG,WAAW,CAAC;IACjB,OAAO,GAAG,OAAO,CAAC;IAClB,WAAW,GAAG,0CAA0C,CAAC;IACzD,WAAW,GAAG,KAAK,CAAC;IAEpB,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,KAA6B;QACxD,IAAI,OAAO,GAAG,EAAE,CAAC;QAEjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;YAClC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC1B,OAAO,GAAG,IAAA,wBAAQ,EAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YACtD,CAAC;iBAAM,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBAChC,gDAAgD;gBAChD,IAAI,CAAC;oBACH,OAAO,GAAG,IAAA,wBAAQ,EAAC,mCAAmC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChF,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,CAAC;wBACH,OAAO,GAAG,IAAA,wBAAQ,EAAC,2CAA2C,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACxF,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,GAAG,IAAA,wBAAQ,EAAC,uCAAuC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBACpF,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,EAAE,CAAC;YAC3F,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAE7E,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,gBAAgB,OAAO,gBAAgB;YAChD,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE;SAChF,CAAC;IACJ,CAAC;CACF;AAxCD,4DAwCC"}

package/dist/context-providers/codebase.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Codebase Context Provider — @codebase
+ *
+ * Semantic search across the entire repository.
+ * Finds the most relevant files/code for a given query.
+ *
+ * How it works:
+ *   1. User types @codebase followed by a search query
+ *   2. We search file names and content using glob + grep
+ *   3. Rank results by relevance (filename match > content match)
+ *   4. Return the top N most relevant code snippets
+ *
+ * Learning note: This is a text-based search approach (not embedding-based).
+ * For true semantic search, you'd want vector embeddings + a vector DB.
+ * But text search with smart ranking gets you 80% of the way there
+ * and works offline without any setup.
+ *
+ * Future enhancement: Add optional embedding-based indexing for
+ * projects that configure it.
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class CodebaseContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+    /**
+     * Search the codebase for a query string.
+     * Uses ripgrep (rg) if available for fast searching,
+     * otherwise falls back to a simple Node.js file walker.
+     */
+    private search;
+    /**
+     * Fast search using ripgrep (rg).
+     * Learning note: ripgrep respects .gitignore by default,
+     * which is exactly what we want.
+     */
+    private searchWithRipgrep;
+    /**
+     * Simple fallback search using Node.js file system.
+     * Slower but works everywhere without external dependencies.
+     */
+    private searchSimple;
+}
+//# sourceMappingURL=codebase.d.ts.map

package/dist/context-providers/codebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase.d.ts","sourceRoot":"","sources":["../../src/context-providers/codebase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AA2BrF,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,EAAE,SAAc;IAChB,OAAO,SAAe;IACtB,WAAW,SAAkD;IAC7D,WAAW,UAAQ;IAEb,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAyDpF;;;;OAIG;YACW,MAAM;IAapB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAoEzB;;;OAGG;IACH,OAAO,CAAC,YAAY;CAgErB"}