duocode 0.1.0

package/dist/tools/approval.js

@@ -0,0 +1,172 @@
+import { renderFileChange } from "./diff_display.js";
+/**
+ * Sensible default: reads auto-approved, writes/executes require user approval.
+ */
+export const DEFAULT_APPROVAL_POLICY = {
+    defaultDecision: "ask",
+    categoryDefaults: {
+        read: "allow",
+        search: "allow",
+        ask: "allow",
+        write: "ask",
+        execute: "ask",
+    },
+    rules: [
+        // Never allow writing to sensitive paths
+        { tool: "*", category: "write", decision: "deny", pathPattern: "**.env" },
+        { tool: "*", category: "write", decision: "deny", pathPattern: "**.pem" },
+        { tool: "*", category: "write", decision: "deny", pathPattern: "**credentials**" },
+        { tool: "*", category: "write", decision: "deny", pathPattern: "**secret**" },
+        // Deny dangerous commands
+        { tool: "run_command", decision: "deny", pathPattern: "rm -rf *" },
+    ],
+};
+// ── Glob Matching ─────────────────────────────────────────────────
+function matchesGlob(value, pattern) {
+    // Simple glob: * matches any sequence, ** matches across slashes
+    const regex = pattern
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        .replace(/\*\*/g, "{{DOUBLESTAR}}")
+        .replace(/\*/g, "[^/]*")
+        .replace(/\{\{DOUBLESTAR\}\}/g, ".*");
+    return new RegExp(`^${regex}$`).test(value);
+}
+export class ApprovalEngine {
+    policy;
+    sessionOverrides = new Map();
+    autoApproveAll = false;
+    constructor(policy = DEFAULT_APPROVAL_POLICY) {
+        this.policy = { ...policy };
+    }
+    /**
+     * Toggle auto-approve mode (skips all checks, allows everything).
+     */
+    setAutoApprove(value) {
+        this.autoApproveAll = value;
+    }
+    getAutoApprove() {
+        return this.autoApproveAll;
+    }
+    /**
+     * Set a session-level override for a specific tool.
+     * "allow-always" persists for the session.
+     */
+    setToolOverride(toolName, decision) {
+        this.sessionOverrides.set(toolName, decision);
+    }
+    clearOverrides() {
+        this.sessionOverrides.clear();
+    }
+    getPolicy() {
+        return this.policy;
+    }
+    updatePolicy(patch) {
+        if (patch.defaultDecision !== undefined)
+            this.policy.defaultDecision = patch.defaultDecision;
+        if (patch.categoryDefaults !== undefined)
+            this.policy.categoryDefaults = patch.categoryDefaults;
+        if (patch.rules !== undefined)
+            this.policy.rules = patch.rules;
+    }
+    /**
+     * Evaluate whether an action should proceed without asking the user.
+     * Returns the decision without prompting.
+     */
+    evaluate(action) {
+        if (this.autoApproveAll)
+            return "allow";
+        // Session override for this exact tool
+        const override = this.sessionOverrides.get(action.tool);
+        if (override)
+            return override;
+        // Check rules in order
+        for (const rule of this.policy.rules) {
+            if (rule.tool !== "*" && rule.tool !== action.tool)
+                continue;
+            if (rule.category && rule.category !== action.category)
+                continue;
+            if (rule.pathPattern) {
+                const pathValue = extractPathFromAction(action);
+                if (pathValue && matchesGlob(pathValue, rule.pathPattern)) {
+                    return rule.decision;
+                }
+                // Rule has pathPattern but action has no path — skip
+                continue;
+            }
+            return rule.decision;
+        }
+        // Category default
+        const catDefault = this.policy.categoryDefaults[action.category];
+        if (catDefault)
+            return catDefault;
+        return this.policy.defaultDecision;
+    }
+    /**
+     * Check approval and prompt user if needed.
+     * Returns true if the action should proceed, false if denied.
+     */
+    async check(action, promptFn, fileChange, renderOpts) {
+        const decision = this.evaluate(action);
+        if (decision === "allow")
+            return true;
+        if (decision === "deny")
+            return false;
+        // decision === "ask" — prompt the user
+        let displayText = formatActionSummary(action);
+        if (fileChange) {
+            displayText += "\n\n" + renderFileChange(fileChange, renderOpts);
+        }
+        return promptFn(action, displayText);
+    }
+}
+// ── Display Helpers ───────────────────────────────────────────────
+const R = "\x1b[0m";
+const B = "\x1b[1m";
+const DM = "\x1b[2m";
+const YLW = "\x1b[93m";
+const CYN = "\x1b[96m";
+function extractPathFromAction(action) {
+    const input = action.input;
+    if (typeof input.path === "string")
+        return input.path;
+    if (typeof input.filePath === "string")
+        return input.filePath;
+    if (typeof input.file_path === "string")
+        return input.file_path;
+    if (typeof input.command === "string")
+        return input.command;
+    return null;
+}
+export function formatActionSummary(action) {
+    const icon = categoryIcon(action.category);
+    const path = extractPathFromAction(action);
+    const pathStr = path ? ` ${DM}${path}${R}` : "";
+    return `${YLW}${B}${icon} ${action.tool}${R}${pathStr}\n  ${DM}${action.summary}${R}`;
+}
+function categoryIcon(category) {
+    switch (category) {
+        case "read": return "[R]";
+        case "write": return "[W]";
+        case "execute": return "[X]";
+        case "search": return "[S]";
+        case "ask": return "[?]";
+    }
+}
+/**
+ * Format a batch of actions into a compact approval prompt.
+ */
+export function formatBatchSummary(actions) {
+    const lines = [
+        `${CYN}${B}Pending actions${R} ${DM}(${actions.length})${R}`,
+        "",
+    ];
+    for (let i = 0; i < actions.length; i++) {
+        const a = actions[i];
+        const icon = categoryIcon(a.category);
+        const path = extractPathFromAction(a);
+        lines.push(`  ${B}${i + 1}.${R} ${YLW}${icon}${R} ${a.tool}${path ? ` ${DM}${path}${R}` : ""}`);
+        lines.push(`     ${DM}${a.summary}${R}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=approval.js.map

package/dist/tools/approval.js.map

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

package/dist/tools/checkpoint.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Checkpoint system: snapshot working directory before tool execution.
+ * Supports git-based (stash create) and copy-based fallback.
+ * Also provides /undo and /undo list commands.
+ */
+export interface CheckpointEntry {
+    id: number;
+    timestamp: number;
+    strategy: "git" | "copy";
+    /** Git stash ref (for git strategy) */
+    stashRef?: string;
+    /** Copy directory path (for copy strategy) */
+    copyDir?: string;
+    /** Files that were affected */
+    files: string[];
+    /** Human-readable label */
+    label: string;
+}
+export declare class CheckpointManager {
+    private readonly projectRoot;
+    private readonly checkpointDir;
+    private stack;
+    private redoStack;
+    private nextId;
+    private gitRepoCache;
+    constructor(projectRoot: string);
+    private isGitRepo;
+    /**
+     * Create a checkpoint of the current working directory state.
+     * Uses git stash create if in a git repo, otherwise copies files.
+     */
+    create(label: string): CheckpointEntry | null;
+    private createGitCheckpoint;
+    private createCopyCheckpoint;
+    private cleanupRedoStack;
+    private pushCheckpoint;
+    /**
+     * Undo to the most recent checkpoint (or N steps back).
+     */
+    undo(steps?: number): CheckpointEntry | null;
+    /**
+     * Redo the most recently undone checkpoint.
+     */
+    redo(): CheckpointEntry | null;
+    private restoreCheckpoint;
+    private restoreGitCheckpoint;
+    private restoreCopyCheckpoint;
+    private cleanupCopyDir;
+    /**
+     * Get the checkpoint history (most recent first).
+     */
+    getHistory(): readonly CheckpointEntry[];
+    /**
+     * Get the redo stack (most recent first).
+     */
+    getRedoHistory(): readonly CheckpointEntry[];
+    /**
+     * Number of checkpoints available for undo.
+     */
+    get undoCount(): number;
+    /**
+     * Number of checkpoints available for redo.
+     */
+    get redoCount(): number;
+}

package/dist/tools/checkpoint.js

@@ -0,0 +1,342 @@
+/**
+ * Checkpoint system: snapshot working directory before tool execution.
+ * Supports git-based (stash create) and copy-based fallback.
+ * Also provides /undo and /undo list commands.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { execSync, execFileSync } from "node:child_process";
+// ── Helpers ─────────────────────────────────────────────────────
+function isGitRepo(cwd) {
+    try {
+        execSync("git rev-parse --is-inside-work-tree", {
+            cwd,
+            stdio: "pipe",
+            timeout: 5000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getGitChangedFiles(cwd) {
+    try {
+        const out = execSync("git diff --name-only HEAD 2>/dev/null || git diff --name-only", {
+            cwd,
+            stdio: "pipe",
+            timeout: 5000,
+        }).toString().trim();
+        if (!out)
+            return [];
+        return out.split("\n").filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+function getGitUntrackedFiles(cwd) {
+    try {
+        const out = execSync("git ls-files --others --exclude-standard", {
+            cwd,
+            stdio: "pipe",
+            timeout: 5000,
+        }).toString().trim();
+        if (!out)
+            return [];
+        return out.split("\n").filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/** Validate a path stays within the project root (prevents traversal). */
+function isWithinRoot(root, filePath) {
+    const resolved = path.resolve(root, filePath);
+    return resolved.startsWith(root + path.sep) || resolved === root;
+}
+// ── CheckpointManager ──────────────────────────────────────────
+const MAX_CHECKPOINTS = 20;
+export class CheckpointManager {
+    projectRoot;
+    checkpointDir;
+    stack = [];
+    redoStack = [];
+    nextId = 1;
+    gitRepoCache = null;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.checkpointDir = path.join(projectRoot, ".duocode", "checkpoints");
+    }
+    isGitRepo() {
+        if (this.gitRepoCache === null) {
+            this.gitRepoCache = isGitRepo(this.projectRoot);
+        }
+        return this.gitRepoCache;
+    }
+    /**
+     * Create a checkpoint of the current working directory state.
+     * Uses git stash create if in a git repo, otherwise copies files.
+     */
+    create(label) {
+        if (this.isGitRepo()) {
+            return this.createGitCheckpoint(label);
+        }
+        return this.createCopyCheckpoint(label);
+    }
+    createGitCheckpoint(label) {
+        const changedFiles = getGitChangedFiles(this.projectRoot);
+        const untrackedFiles = getGitUntrackedFiles(this.projectRoot);
+        const allFiles = [...changedFiles, ...untrackedFiles];
+        if (allFiles.length === 0)
+            return null; // Nothing to checkpoint
+        // Stage untracked files temporarily for stash to capture them
+        let addedUntracked = false;
+        if (untrackedFiles.length > 0) {
+            try {
+                // Use execFileSync to prevent command injection via filenames
+                execFileSync("git", ["add", "--intent-to-add", ...untrackedFiles], {
+                    cwd: this.projectRoot,
+                    stdio: "pipe",
+                    timeout: 5000,
+                });
+                addedUntracked = true;
+            }
+            catch {
+                // Continue without untracked files in stash
+            }
+        }
+        try {
+            // git stash create — creates a stash ref without modifying working tree
+            const ref = execSync("git stash create", {
+                cwd: this.projectRoot,
+                stdio: "pipe",
+                timeout: 10000,
+            }).toString().trim();
+            if (!ref)
+                return null; // No changes to stash
+            const entry = {
+                id: this.nextId++,
+                timestamp: Date.now(),
+                strategy: "git",
+                stashRef: ref,
+                files: allFiles,
+                label,
+            };
+            this.pushCheckpoint(entry);
+            return entry;
+        }
+        catch {
+            // Fall back to copy-based
+            return this.createCopyCheckpoint(label);
+        }
+        finally {
+            // Undo the intent-to-add for untracked files
+            if (addedUntracked) {
+                try {
+                    execFileSync("git", ["reset", "HEAD", ...untrackedFiles], {
+                        cwd: this.projectRoot,
+                        stdio: "pipe",
+                        timeout: 5000,
+                    });
+                }
+                catch {
+                    // Best effort
+                }
+            }
+        }
+    }
+    createCopyCheckpoint(label) {
+        const timestamp = Date.now();
+        const copyDir = path.join(this.checkpointDir, String(timestamp));
+        if (!fs.existsSync(this.checkpointDir)) {
+            fs.mkdirSync(this.checkpointDir, { recursive: true });
+        }
+        fs.mkdirSync(copyDir, { recursive: true });
+        // Get list of files to copy from git (if available)
+        let files;
+        if (this.isGitRepo()) {
+            files = [...getGitChangedFiles(this.projectRoot), ...getGitUntrackedFiles(this.projectRoot)];
+        }
+        else {
+            // Without git, no reliable way to know which files are "changed"
+            // Return null to avoid creating an empty checkpoint
+            return null;
+        }
+        if (files.length === 0)
+            return null;
+        for (const relFile of files) {
+            // Guard against path traversal
+            if (!isWithinRoot(this.projectRoot, relFile))
+                continue;
+            const srcPath = path.join(this.projectRoot, relFile);
+            if (!fs.existsSync(srcPath))
+                continue;
+            const destPath = path.join(copyDir, relFile);
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            fs.copyFileSync(srcPath, destPath);
+        }
+        const entry = {
+            id: this.nextId++,
+            timestamp,
+            strategy: "copy",
+            copyDir,
+            files,
+            label,
+        };
+        this.pushCheckpoint(entry);
+        return entry;
+    }
+    cleanupRedoStack() {
+        for (const entry of this.redoStack) {
+            if (entry.strategy === "copy" && entry.copyDir) {
+                this.cleanupCopyDir(entry.copyDir);
+            }
+        }
+        this.redoStack = [];
+    }
+    pushCheckpoint(entry) {
+        this.stack.push(entry);
+        // Clear redo stack (with cleanup) when a new checkpoint is created
+        this.cleanupRedoStack();
+        // Enforce max size
+        while (this.stack.length > MAX_CHECKPOINTS) {
+            const removed = this.stack.shift();
+            if (removed?.strategy === "copy" && removed.copyDir) {
+                this.cleanupCopyDir(removed.copyDir);
+            }
+        }
+    }
+    /**
+     * Undo to the most recent checkpoint (or N steps back).
+     */
+    undo(steps = 1) {
+        if (steps < 1 || this.stack.length === 0)
+            return null;
+        const actualSteps = Math.min(steps, this.stack.length);
+        let restored = null;
+        for (let i = 0; i < actualSteps; i++) {
+            const entry = this.stack.pop();
+            if (!entry)
+                break;
+            this.redoStack.push(entry);
+            restored = entry;
+        }
+        if (!restored)
+            return null;
+        this.restoreCheckpoint(restored);
+        return restored;
+    }
+    /**
+     * Redo the most recently undone checkpoint.
+     */
+    redo() {
+        if (this.redoStack.length === 0)
+            return null;
+        // Pop the redo entry BEFORE create() clears the redo stack
+        const entry = this.redoStack.pop();
+        // Save remaining redo stack — create() will clear it
+        const savedRedo = [...this.redoStack];
+        this.create("pre-redo");
+        // Restore the redo stack (create → pushCheckpoint cleared it)
+        this.redoStack = savedRedo;
+        this.restoreCheckpoint(entry);
+        return entry;
+    }
+    restoreCheckpoint(entry) {
+        if (entry.strategy === "git" && entry.stashRef) {
+            this.restoreGitCheckpoint(entry);
+        }
+        else if (entry.strategy === "copy" && entry.copyDir) {
+            this.restoreCopyCheckpoint(entry);
+        }
+    }
+    restoreGitCheckpoint(entry) {
+        // Validate stash ref is a hex SHA (prevent injection)
+        if (!entry.stashRef || !/^[0-9a-f]{7,40}$/i.test(entry.stashRef))
+            return;
+        try {
+            // Restore files from the stash ref without dropping it
+            for (const file of entry.files) {
+                try {
+                    // Use execFileSync to prevent command injection via filenames
+                    execFileSync("git", ["checkout", entry.stashRef, "--", file], {
+                        cwd: this.projectRoot,
+                        stdio: "pipe",
+                        timeout: 5000,
+                    });
+                }
+                catch {
+                    // File might not exist in the stash (e.g., new file that was deleted)
+                }
+            }
+        }
+        catch {
+            // Fallback: try applying the whole stash
+            try {
+                execFileSync("git", ["stash", "apply", entry.stashRef], {
+                    cwd: this.projectRoot,
+                    stdio: "pipe",
+                    timeout: 10000,
+                });
+            }
+            catch {
+                // Best effort — stash may conflict
+            }
+        }
+    }
+    restoreCopyCheckpoint(entry) {
+        if (!entry.copyDir || !fs.existsSync(entry.copyDir))
+            return;
+        for (const relFile of entry.files) {
+            // Guard against path traversal
+            if (!isWithinRoot(this.projectRoot, relFile))
+                continue;
+            const srcPath = path.join(entry.copyDir, relFile);
+            const destPath = path.join(this.projectRoot, relFile);
+            if (!fs.existsSync(srcPath))
+                continue;
+            const destDir = path.dirname(destPath);
+            if (!fs.existsSync(destDir)) {
+                fs.mkdirSync(destDir, { recursive: true });
+            }
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+    cleanupCopyDir(dir) {
+        try {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+        catch {
+            // Best effort
+        }
+    }
+    /**
+     * Get the checkpoint history (most recent first).
+     */
+    getHistory() {
+        return [...this.stack].reverse();
+    }
+    /**
+     * Get the redo stack (most recent first).
+     */
+    getRedoHistory() {
+        return [...this.redoStack].reverse();
+    }
+    /**
+     * Number of checkpoints available for undo.
+     */
+    get undoCount() {
+        return this.stack.length;
+    }
+    /**
+     * Number of checkpoints available for redo.
+     */
+    get redoCount() {
+        return this.redoStack.length;
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

package/dist/tools/checkpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../src/tools/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAkB5D,mEAAmE;AAEnE,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,QAAQ,CAAC,qCAAqC,EAAE;YAC9C,GAAG;YACH,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,+DAA+D,EAAE;YACpF,GAAG;YACH,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAW;IACvC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,QAAQ,CAAC,0CAA0C,EAAE;YAC/D,GAAG;YACH,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,0EAA0E;AAC1E,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9C,OAAO,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,IAAI,CAAC;AACnE,CAAC;AAED,kEAAkE;AAElE,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,MAAM,OAAO,iBAAiB;IACX,WAAW,CAAS;IACpB,aAAa,CAAS;IAC/B,KAAK,GAAsB,EAAE,CAAC;IAC9B,SAAS,GAAsB,EAAE,CAAC;IAClC,MAAM,GAAG,CAAC,CAAC;IACX,YAAY,GAAmB,IAAI,CAAC;IAE5C,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;IACzE,CAAC;IAEO,SAAS;QACf,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAa;QAClB,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAEO,mBAAmB,CAAC,KAAa;QACvC,MAAM,YAAY,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC1D,MAAM,cAAc,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,cAAc,CAAC,CAAC;QAEtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;QAEhE,8DAA8D;QAC9D,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,8DAA8D;gBAC9D,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,cAAc,CAAC,EAAE;oBACjE,GAAG,EAAE,IAAI,CAAC,WAAW;oBACrB,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;gBACH,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,wEAAwE;YACxE,MAAM,GAAG,GAAG,QAAQ,CAAC,kBAAkB,EAAE;gBACvC,GAAG,EAAE,IAAI,CAAC,WAAW;gBACrB,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,KAAK;aACf,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAErB,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,CAAC,sBAAsB;YAE7C,MAAM,KAAK,GAAoB;gBAC7B,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;gBACjB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,GAAG;gBACb,KAAK,EAAE,QAAQ;gBACf,KAAK;aACN,CAAC;YAEF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;YAC1B,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;gBAAS,CAAC;YACT,6CAA6C;YAC7C,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC;oBACH,YAAY,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,EAAE;wBACxD,GAAG,EAAE,IAAI,CAAC,WAAW;wBACrB,KAAK,EAAE,MAAM;wBACb,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,cAAc;gBAChB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,KAAa;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;YACvC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE3C,oDAAoD;QACpD,IAAI,KAAe,CAAC;QACpB,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACrB,KAAK,GAAG,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QAC/F,CAAC;aAAM,CAAC;YACN,iEAAiE;YACjE,oDAAoD;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEpC,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,+BAA+B;YAC/B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;gBAAE,SAAS;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,KAAK,GAAoB;YAC7B,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;YACjB,SAAS;YACT,QAAQ,EAAE,MAAM;YAChB,OAAO;YACP,KAAK;YACL,KAAK;SACN,CAAC;QAEF,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB;QACtB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC/C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;IACtB,CAAC;IAEO,cAAc,CAAC,KAAsB;QAC3C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,mEAAmE;QACnE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,mBAAmB;QACnB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,OAAO,EAAE,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAK,GAAG,CAAC;QACZ,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvD,IAAI,QAAQ,GAA2B,IAAI,CAAC;QAE5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK;gBAAE,MAAM;YAClB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;QAED,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAE3B,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE7C,2DAA2D;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAG,CAAC;QAEpC,qDAAqD;QACrD,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxB,8DAA8D;QAC9D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,iBAAiB,CAAC,KAAsB;QAC9C,IAAI,KAAK,CAAC,QAAQ,KAAK,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/C,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACtD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,KAAsB;QACjD,sDAAsD;QACtD,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAAE,OAAO;QAEzE,IAAI,CAAC;YACH,uDAAuD;YACvD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,8DAA8D;oBAC9D,YAAY,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;wBAC5D,GAAG,EAAE,IAAI,CAAC,WAAW;wBACrB,KAAK,EAAE,MAAM;wBACb,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;gBACL,CAAC;gBAAC,MAAM,CAAC;oBACP,sEAAsE;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yCAAyC;YACzC,IAAI,CAAC;gBACH,YAAY,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE;oBACtD,GAAG,EAAE,IAAI,CAAC,WAAW;oBACrB,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,KAAK;iBACf,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,mCAAmC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAEO,qBAAqB,CAAC,KAAsB;QAClD,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;YAAE,OAAO;QAE5D,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAClC,+BAA+B;YAC/B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC;gBAAE,SAAS;YACvD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,CAAC;YACD,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,GAAW;QAChC,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;IAC/B,CAAC;CACF"}

package/dist/tools/definitions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Core tool definitions for the agentic executor.
+ * Each tool has a JSON Schema input definition that models use
+ * to produce structured tool calls.
+ */
+import type { ToolDefinition } from "../providers/base.js";
+export declare const TOOL_READ_FILE: ToolDefinition;
+export declare const TOOL_WRITE_FILE: ToolDefinition;
+export declare const TOOL_EDIT_FILE: ToolDefinition;
+export declare const TOOL_LIST_DIRECTORY: ToolDefinition;
+export declare const TOOL_SEARCH_FILES: ToolDefinition;
+export declare const TOOL_RUN_COMMAND: ToolDefinition;
+export declare const ALL_TOOLS: ToolDefinition[];