@agentex/agent 0.0.1 → 0.0.3

package/dist/utils/skills.js

@@ -1,6 +1,358 @@
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import * as os from "node:os";
+/**
+ * Native per-runtime directories. Only used when includeNativeDirs is enabled.
+ * These are in addition to the two standard channels.
+ * Claude and Codex are excluded since they ARE the standard channels.
+ */
+const NATIVE_DIRS = {
+    gemini: {
+        global: path.join(os.homedir(), ".gemini", "skills"),
+        workspace: (cwd) => path.join(cwd, ".gemini", "skills"),
+    },
+    cursor: {
+        global: path.join(os.homedir(), ".cursor", "skills"),
+        workspace: (cwd) => path.join(cwd, ".cursor", "skills"),
+    },
+    opencode: {
+        global: path.join(os.homedir(), ".config", "opencode", "skills"),
+        workspace: (cwd) => path.join(cwd, ".opencode", "skills"),
+    },
+    pi: {
+        global: path.join(os.homedir(), ".pi", "agent", "skills"),
+        workspace: (cwd) => path.join(cwd, ".pi", "skills"),
+    },
+};
+// ---------------------------------------------------------------------------
+// Path resolution
+// ---------------------------------------------------------------------------
+/** Resolve the standard skill discovery paths (both channels). */
+function resolveStandardPaths(location, cwd) {
+    if (location === "workspace") {
+        if (!cwd)
+            throw new Error("cwd is required when location is 'workspace'");
+        return [
+            { target: "agents", skillsHome: path.join(cwd, ".agents", "skills") },
+            { target: "claude", skillsHome: path.join(cwd, ".claude", "skills") },
+        ];
+    }
+    return [
+        { target: "agents", skillsHome: path.join(os.homedir(), ".agents", "skills") },
+        { target: "claude", skillsHome: path.join(os.homedir(), ".claude", "skills") },
+    ];
+}
+/** Resolve native per-runtime paths (for includeNativeDirs). */
+function resolveNativePaths(location, cwd) {
+    const results = [];
+    for (const [runtime, dirs] of Object.entries(NATIVE_DIRS)) {
+        if (location === "workspace") {
+            if (!cwd)
+                continue;
+            results.push({ target: runtime, skillsHome: dirs.workspace(cwd) });
+        }
+        else {
+            results.push({ target: runtime, skillsHome: dirs.global });
+        }
+    }
+    return results;
+}
+/** Build the full list of install/remove targets. */
+function resolveTargets(location, cwd, includeNativeDirs) {
+    const targets = resolveStandardPaths(location, cwd);
+    if (includeNativeDirs) {
+        targets.push(...resolveNativePaths(location, cwd));
+    }
+    return targets;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Install skill directories into agent discovery paths via idempotent symlinks.
+ *
+ * By default, installs into the two standard channels:
+ * - `.agents/skills/` — discovered by Codex, Gemini, Cursor, OpenCode, Pi
+ * - `.claude/skills/` — discovered by Claude Code
+ *
+ * Set `includeNativeDirs: true` to also install into each runtime's
+ * native directory (e.g. `.gemini/skills/`, `.cursor/skills/`).
+ *
+ * @example
+ * ```typescript
+ * // Global install (home directory)
+ * await installSkills(["~/.myapp/skills/code-review"]);
+ * // Creates ~/.agents/skills/code-review + ~/.claude/skills/code-review
+ *
+ * // Workspace install (project-local)
+ * await installSkills(skillDirs, { location: "workspace", cwd: "/path/to/project" });
+ * // Creates {cwd}/.agents/skills/... + {cwd}/.claude/skills/...
+ * ```
+ */
+export async function installSkills(skillDirs, options) {
+    const entries = [];
+    const location = options?.location ?? "global";
+    const targets = resolveTargets(location, options?.cwd, options?.includeNativeDirs);
+    for (const { target, skillsHome } of targets) {
+        await fs.mkdir(skillsHome, { recursive: true });
+        for (const dir of skillDirs) {
+            const resolved = path.resolve(dir);
+            const name = path.basename(resolved);
+            const symlink = path.join(skillsHome, name);
+            try {
+                const status = await ensureSkillSymlink(resolved, symlink);
+                entries.push({ target, skillName: name, status, targetPath: symlink });
+            }
+            catch (err) {
+                entries.push({
+                    target,
+                    skillName: name,
+                    status: "error",
+                    targetPath: symlink,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    return {
+        entries,
+        installed: entries.filter((e) => e.status === "created").length,
+        skipped: entries.filter((e) => e.status === "skipped").length,
+        conflicts: entries.filter((e) => e.status === "conflict").length,
+        errors: entries.filter((e) => e.status === "error").length,
+    };
+}
+/**
+ * Remove skill symlinks from agent discovery paths.
+ *
+ * Only removes symlinks that point to the specified source directories.
+ * User-installed skills or skills from other apps are never touched.
+ */
+export async function removeSkills(skillDirs, options) {
+    const entries = [];
+    const location = options?.location ?? "global";
+    const targets = resolveTargets(location, options?.cwd, options?.includeNativeDirs);
+    for (const { target, skillsHome } of targets) {
+        for (const dir of skillDirs) {
+            const resolved = path.resolve(dir);
+            const name = path.basename(resolved);
+            const symlink = path.join(skillsHome, name);
+            try {
+                const stat = await fs.lstat(symlink);
+                if (!stat.isSymbolicLink()) {
+                    entries.push({ target, skillName: name, status: "conflict", targetPath: symlink });
+                    continue;
+                }
+                const existing = await fs.readlink(symlink);
+                const resolvedExisting = path.resolve(path.dirname(symlink), existing);
+                if (resolvedExisting !== resolved) {
+                    entries.push({ target, skillName: name, status: "conflict", targetPath: symlink });
+                    continue;
+                }
+                await fs.unlink(symlink);
+                entries.push({ target, skillName: name, status: "removed", targetPath: symlink });
+            }
+            catch (err) {
+                if (err.code === "ENOENT") {
+                    entries.push({ target, skillName: name, status: "not_found", targetPath: symlink });
+                }
+                else {
+                    entries.push({
+                        target,
+                        skillName: name,
+                        status: "error",
+                        targetPath: symlink,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                }
+            }
+        }
+    }
+    return {
+        entries,
+        removed: entries.filter((e) => e.status === "removed").length,
+    };
+}
+/**
+ * List skills installed in the standard discovery channels.
+ *
+ * Returns a record keyed by channel ("agents", "claude") with the skills
+ * found in each. If `includeNativeDirs` is true, also includes native
+ * runtime directories (keyed by runtime name).
+ *
+ * @example
+ * ```typescript
+ * const skills = await listInstalledSkills();
+ * // { agents: [...], claude: [...] }
+ *
+ * const skills = await listInstalledSkills({ location: "workspace", cwd: "/my/project" });
+ * // { agents: [...], claude: [...] }
+ * ```
+ */
+export async function listInstalledSkills(options) {
+    const location = options?.location ?? "global";
+    const targets = resolveTargets(location, options?.cwd, options?.includeNativeDirs);
+    const result = {};
+    for (const { target, skillsHome } of targets) {
+        let dirEntries;
+        try {
+            dirEntries = await fs.readdir(skillsHome);
+        }
+        catch {
+            result[target] = [];
+            continue;
+        }
+        const skills = [];
+        for (const name of dirEntries) {
+            const fullPath = path.join(skillsHome, name);
+            try {
+                const stat = await fs.lstat(fullPath);
+                if (stat.isSymbolicLink()) {
+                    const linkTarget = await fs.readlink(fullPath);
+                    skills.push({
+                        name,
+                        sourcePath: path.resolve(path.dirname(fullPath), linkTarget),
+                        isSymlink: true,
+                    });
+                }
+                else if (stat.isDirectory()) {
+                    skills.push({ name, sourcePath: fullPath, isSymlink: false });
+                }
+            }
+            catch {
+                // Skip unreadable entries
+            }
+        }
+        result[target] = skills;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Convenience resolvers (exported for low-level use / escape hatch)
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the global (home-directory) skills path for a standard channel.
+ */
+export function resolveSkillsHome(channel) {
+    switch (channel) {
+        case "agents":
+            return path.join(os.homedir(), ".agents", "skills");
+        case "claude":
+            return path.join(os.homedir(), ".claude", "skills");
+    }
+}
+/**
+ * Resolve the workspace-relative skills path for a standard channel.
+ */
+export function resolveSkillsWorkspace(channel, cwd) {
+    switch (channel) {
+        case "agents":
+            return path.join(cwd, ".agents", "skills");
+        case "claude":
+            return path.join(cwd, ".claude", "skills");
+    }
+}
+/**
+ * Resolve the native per-runtime skills path (home directory).
+ * Returns null for runtimes that use standard channels (claude → .claude/, codex → .agents/).
+ */
+export function resolveNativeSkillsHome(runtime) {
+    const entry = NATIVE_DIRS[runtime];
+    return entry?.global ?? null;
+}
+/**
+ * Resolve the native per-runtime skills path (workspace).
+ * Returns null for runtimes that use standard channels.
+ */
+export function resolveNativeSkillsWorkspace(runtime, cwd) {
+    const entry = NATIVE_DIRS[runtime];
+    return entry ? entry.workspace(cwd) : null;
+}
+// ---------------------------------------------------------------------------
+// Low-level helpers
+// ---------------------------------------------------------------------------
+/**
+ * Idempotent symlink creation. Returns the outcome:
+ * - "created": new symlink was created
+ * - "skipped": symlink already exists and points to the correct source
+ * - "conflict": symlink exists but points elsewhere (not overwritten)
+ */
+export async function ensureSkillSymlink(source, target) {
+    try {
+        const stat = await fs.lstat(target);
+        if (stat.isSymbolicLink()) {
+            const existing = await fs.readlink(target);
+            const resolvedExisting = path.resolve(path.dirname(target), existing);
+            if (resolvedExisting === path.resolve(source)) {
+                return "skipped";
+            }
+            return "conflict";
+        }
+        return "conflict";
+    }
+    catch {
+        await fs.symlink(source, target, "dir");
+        return "created";
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers (used by provider execute functions)
+// ---------------------------------------------------------------------------
+/**
+ * Place skills into a home-directory-based skills folder via idempotent symlinks.
+ * Used internally by provider execute functions for native runtime injection.
+ *
+ * Returns the skills home path, or null if no skills were provided.
+ */
+export async function injectHomeSkills(skillDirs, runtime) {
+    if (skillDirs.length === 0)
+        return null;
+    const entry = NATIVE_DIRS[runtime];
+    const skillsHome = entry?.global ?? null;
+    if (!skillsHome)
+        return null;
+    await fs.mkdir(skillsHome, { recursive: true });
+    for (const dir of skillDirs) {
+        const name = path.basename(dir);
+        const target = path.join(skillsHome, name);
+        try {
+            await ensureSkillSymlink(dir, target);
+        }
+        catch (err) {
+            console.warn(`Failed to inject skill "${name}" into ${skillsHome}: ${err}`);
+        }
+    }
+    return skillsHome;
+}
+/**
+ * Place skills into {cwd}/.agents/skills/ via idempotent symlinks.
+ * Used internally by codex provider.
+ *
+ * Returns the skills directory path, or null if no skills were provided.
+ */
+export async function injectWorkspaceSkills(skillDirs, cwd) {
+    if (skillDirs.length === 0)
+        return null;
+    const skillsHome = path.join(cwd, ".agents", "skills");
+    await fs.mkdir(skillsHome, { recursive: true });
+    for (const dir of skillDirs) {
+        const name = path.basename(dir);
+        const target = path.join(skillsHome, name);
+        try {
+            await ensureSkillSymlink(dir, target);
+        }
+        catch (err) {
+            console.warn(`Failed to inject skill "${name}" into ${skillsHome}: ${err}`);
+        }
+    }
+    return skillsHome;
+}
+/**
+ * Build an ephemeral tmpdir with .claude/skills/ containing symlinks.
+ * Used by Claude provider — passed via --add-dir, cleaned up after execution.
+ *
+ * Returns the tmpdir path (caller must clean up with cleanupSkillsDir).
+ */
 export async function buildSkillsDir(skillDirs, runtime) {
     const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), "agentex-skills-"));
     let skillsRoot;

package/dist/utils/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/utils/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAmB,EAAE,OAAqB;IAC7E,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE3E,IAAI,UAAkB,CAAC;IACvB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,4BAA4B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAAc;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC"}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/utils/skills.ts"],"names":[],"mappings":"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"}

package/dist/utils/workspace.d.ts

@@ -0,0 +1,55 @@
+export interface WorkspaceOptions {
+    /** Isolation strategy */
+    strategy: "worktree";
+    /** Base branch to create worktree from (default: current HEAD) */
+    baseBranch?: string;
+    /** Custom branch name (default: auto-generated) */
+    branchName?: string;
+    /** Custom directory for the worktree (default: os.tmpdir()) */
+    targetDir?: string;
+}
+export interface DiffOptions {
+    /** Ref to compare against (default: the base branch used when creating the worktree). */
+    base?: string;
+    /**
+     * What to include in the diff:
+     * - "all"         — committed + uncommitted + untracked (default)
+     * - "committed"   — only changes committed to the worktree branch vs base
+     * - "uncommitted" — only staged + unstaged changes in the working tree
+     * - "untracked"   — only new files not yet tracked by git
+     */
+    scope?: "all" | "committed" | "uncommitted" | "untracked";
+    /** Return `--stat` summary instead of full patch. */
+    stat?: boolean;
+}
+export interface PreparedWorkspace {
+    /** Path to the worktree directory — use as `cwd` for execute() */
+    cwd: string;
+    /** Branch name created for this worktree */
+    branch: string;
+    /** The strategy that was used */
+    strategy: "worktree";
+    /** The original repo path */
+    originalCwd: string;
+    /**
+     * Get a unified diff of changes in this worktree.
+     *
+     * With no arguments, returns everything that changed (committed + uncommitted + untracked).
+     * Use `options.scope` to narrow, `options.base` to compare against a different ref,
+     * or `options.stat` for a summary.
+     */
+    diff(options?: DiffOptions | string): Promise<string>;
+    /** Remove the worktree and optionally delete the branch */
+    cleanup(options?: {
+        deleteBranch?: boolean;
+    }): Promise<void>;
+}
+/**
+ * Create an isolated workspace for agent execution.
+ *
+ * Uses `git worktree add` to create a lightweight checkout on a new branch.
+ * The worktree shares git history with the original repo, so diffs, merges,
+ * and PRs all work normally.
+ */
+export declare function prepareWorkspace(cwd: string, options: WorkspaceOptions): Promise<PreparedWorkspace>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/utils/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/utils/workspace.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,gBAAgB;IAC/B,yBAAyB;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,yFAAyF;IACzF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;IAC1D,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,QAAQ,EAAE,UAAU,CAAC;IACrB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,2DAA2D;IAC3D,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,iBAAiB,CAAC,CA0F5B"}

package/dist/utils/workspace.js

@@ -0,0 +1,89 @@
+import * as os from "node:os";
+import * as path from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { uuidv7 } from "./uuid.js";
+const exec = promisify(execFile);
+/**
+ * Create an isolated workspace for agent execution.
+ *
+ * Uses `git worktree add` to create a lightweight checkout on a new branch.
+ * The worktree shares git history with the original repo, so diffs, merges,
+ * and PRs all work normally.
+ */
+export async function prepareWorkspace(cwd, options) {
+    // Validate git repo
+    try {
+        await exec("git", ["rev-parse", "--git-dir"], { cwd });
+    }
+    catch {
+        throw new Error(`Not a git repository: ${cwd}`);
+    }
+    const shortId = uuidv7().slice(0, 8);
+    const branch = options.branchName ?? `agentex/${Date.now()}-${shortId}`;
+    const targetDir = options.targetDir ?? path.join(os.tmpdir(), `agentex-ws-${shortId}`);
+    // Create worktree
+    const worktreeArgs = ["worktree", "add", targetDir, "-b", branch];
+    if (options.baseBranch) {
+        worktreeArgs.push(options.baseBranch);
+    }
+    await exec("git", worktreeArgs, { cwd });
+    const baseBranch = options.baseBranch ?? "main";
+    return {
+        cwd: targetDir,
+        branch,
+        strategy: "worktree",
+        originalCwd: cwd,
+        async diff(optionsOrBase) {
+            const opts = typeof optionsOrBase === "string"
+                ? { base: optionsOrBase }
+                : optionsOrBase ?? {};
+            const diffBase = opts.base ?? baseBranch;
+            const scope = opts.scope ?? "all";
+            const statFlag = opts.stat ? ["--stat"] : [];
+            const parts = [];
+            // Committed changes: base...branch (only commits on the branch)
+            if (scope === "all" || scope === "committed") {
+                const { stdout } = await exec("git", ["diff", ...statFlag, `${diffBase}...${branch}`], { cwd });
+                if (stdout.trim())
+                    parts.push(stdout);
+            }
+            // Uncommitted changes: staged + unstaged vs HEAD
+            if (scope === "all" || scope === "uncommitted") {
+                const { stdout } = await exec("git", ["diff", ...statFlag, "HEAD"], { cwd: targetDir });
+                if (stdout.trim())
+                    parts.push(stdout);
+            }
+            // Untracked files: new files not yet staged
+            if (scope === "all" || scope === "untracked") {
+                const { stdout: untrackedRaw } = await exec("git", ["ls-files", "--others", "--exclude-standard"], { cwd: targetDir });
+                const untrackedFiles = untrackedRaw.split("\n").filter(Boolean);
+                if (opts.stat) {
+                    // Stat mode: just list filenames with (new) marker
+                    for (const f of untrackedFiles) {
+                        parts.push(` ${f} (new file)`);
+                    }
+                }
+                else if (untrackedFiles.length > 0) {
+                    // Full diff: use git diff with --no-index against /dev/null in a single call
+                    // Stage temporarily, diff, then unstage — faster than per-file diff
+                    await exec("git", ["add", "--intent-to-add", ...untrackedFiles], { cwd: targetDir });
+                    const { stdout } = await exec("git", ["diff", ...untrackedFiles], { cwd: targetDir });
+                    await exec("git", ["reset", "HEAD", ...untrackedFiles], { cwd: targetDir });
+                    if (stdout.trim())
+                        parts.push(stdout);
+                }
+            }
+            return parts.join("\n");
+        },
+        async cleanup(opts) {
+            await exec("git", ["worktree", "remove", targetDir, "--force"], { cwd });
+            if (opts?.deleteBranch) {
+                await exec("git", ["branch", "-D", branch], { cwd }).catch(() => {
+                    // Branch may already be deleted or not exist
+                });
+            }
+        },
+    };
+}
+//# sourceMappingURL=workspace.js.map

package/dist/utils/workspace.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentex/agent",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Programmatic execution of AI coding agents (Claude Code, Codex, OpenClaw)",
   "type": "module",
   "exports": {
@@ -19,7 +19,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "smoke": "tsx scripts/smoke.ts"
+    "smoke": "tsx scripts/smoke.ts",
+    "smoke:mock": "tsx scripts/smoke.ts --mock"
   },
   "keywords": [
     "ai",
@@ -37,7 +38,9 @@
     "node": ">=18.0.0"
   },
   "devDependencies": {
+    "@mariozechner/pi-coding-agent": "^0.62.0",
     "@types/node": "^25.3.5",
+    "opencode-ai": "^1.3.2",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0"