@ghostmind-dev/agent 0.1.0 → 0.2.0

package/README.md

@@ -12,10 +12,12 @@ It is a **library**: import it, give it tools, run it. No server, no service, no
 
 ```
             @ghostmind-dev/agent   (engine: loop, model + Jev, guide, budget, hooks, events)
-             /            |              \
-      an app's agent   another app's   an ensemble work node
+             /                    |                        \
+   a node in ensemble      the `agent` command      imported by an app (Potion, later)
 ```
 
+**One core, three ways in.** The same engine runs inside an ensemble `work` node, behind a terminal REPL, or imported into an app. Each keeps its own tools, prompts and approvals.
+
 **Share the engine, not the agent.** What makes an agent *yours* is its tools, prompts, memory and approvals, and each app keeps those. What every app needs, and what is hard to get right, is the loop: the guards that stop a model looping, stalling, inventing tool calls or overspending. That lives here once.
 
 ## Quick start
@@ -131,6 +133,25 @@ The same `go | pause | stop` vocabulary as ensemble's `guard(step)`, so one supe
 
 `src/` never names an app: no app database, no app link format, no app wording in prompts. If a line of the engine would only make sense for one app, it belongs behind a seam. `test/boundary.test.mts` enforces it, along with zero runtime dependencies and no hardcoded model ids. Jev's `jev-latest` alias is the one default.
 
+## The `agent` command
+
+The package ships a terminal chat on the core, in the spirit of opencode. Use it to try the engine, or as a small agent in any folder:
+
+```bash
+export OPENROUTER_API_KEY=sk-or-...
+npx @ghostmind-dev/agent --models glm            # tool-capable models, cheapest first
+npx @ghostmind-dev/agent -m <model-id>           # chat in the current folder
+npx @ghostmind-dev/agent -m <model-id> -p "what does this repo do?"   # one turn, then exit
+```
+
+**What the agent can do:**
+- **Files:** read, list and search freely. Writing or editing a file asks first. It can't reach outside the folder it started in.
+- **Shell:** every command asks first.
+- **MCP servers:** from `.mcp.json` (Claude Code's format). This needs `@ghostmind-dev/ensemble` installed alongside, an *optional* peer dependency, so the package keeps zero runtime dependencies.
+- **Skills:** from `.claude/skills`. Jev picks which one a task needs.
+
+It shows every tool call, Jev checkpoint and cost, and logs each session to `~/.agent-cli/sessions/`. There's no default model on purpose: pass `-m` or set `AGENT_MODEL`. `agent --help` lists the options. In this repo, `cli/scripts/agent.sh` runs it from source with the key from Vault (see [`cli/Readme.md`](cli/Readme.md)).
+
 ## Development
 
 ```

package/dist/cli/files.d.ts

@@ -0,0 +1,5 @@
+import type { Toolset } from '../index.ts';
+/** A path inside the root, or an error that says why not. */
+export declare function inside(root: string, path: unknown): string;
+export declare function fileToolset(root: string): Toolset;
+//# sourceMappingURL=files.d.ts.map

package/dist/cli/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/cli/files.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAa,OAAO,EAAE,MAAM,aAAa,CAAC;AAKtD,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAK1D;AAmDD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoFjD"}

package/dist/cli/files.js

@@ -0,0 +1,167 @@
+/**
+ * Files — read, list, search, write and edit, confined to one root (the directory the CLI runs in).
+ *
+ * Reads run freely; writes and edits are CHANGES, so the core asks for approval with a one-line
+ * account before they run. Every path is resolved against the root and refused if it escapes it,
+ * so a model cannot read `~/.ssh` by asking for `../../.ssh`.
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+const READ_CAP = 2000; // lines
+const SKIP = new Set(['node_modules', '.git', 'dist', '.next', '.venv', '__pycache__']);
+/** A path inside the root, or an error that says why not. */
+export function inside(root, path) {
+    const p = String(path ?? '.').trim() || '.';
+    const full = resolve(root, p);
+    if (full !== root && !full.startsWith(root + sep))
+        throw new Error(`"${p}" is outside the working directory (${root}).`);
+    return full;
+}
+const rel = (root, full) => relative(root, full) || '.';
+function listDir(root, dir, depth) {
+    const out = [];
+    const walk = (d, level) => {
+        let entries;
+        try {
+            entries = readdirSync(d).sort();
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (out.length >= 500)
+                return;
+            const full = join(d, name);
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            const indent = '  '.repeat(level);
+            if (st.isDirectory()) {
+                out.push(`${indent}${name}/${SKIP.has(name) ? '  (skipped)' : ''}`);
+                if (level + 1 < depth && !SKIP.has(name))
+                    walk(full, level + 1);
+            }
+            else
+                out.push(`${indent}${name}  ${st.size}b`);
+        }
+    };
+    walk(dir, 0);
+    if (out.length >= 500)
+        out.push('…(truncated at 500 entries)');
+    return out;
+}
+function ripgrep(root, pattern, path, glob, signal) {
+    return new Promise((ok, fail) => {
+        const args = ['--line-number', '--no-heading', '--color=never', '--max-count=20', '--max-columns=300', ...(glob ? ['--glob', glob] : []), '--', pattern, path];
+        const child = spawn('rg', args, { cwd: root, signal });
+        let out = '';
+        let err = '';
+        child.stdout.on('data', d => (out += d));
+        child.stderr.on('data', d => (err += d));
+        child.on('error', fail);
+        child.on('close', code => {
+            if (code === 0)
+                ok(out);
+            else if (code === 1)
+                ok('');
+            else
+                fail(new Error(err.trim() || `rg exited with ${code}`));
+        });
+    });
+}
+export function fileToolset(root) {
+    const tools = [
+        {
+            name: 'list_dir',
+            description: 'List a directory in the working directory as a tree (depth 1–4, default 2). Skips node_modules, .git, dist.',
+            parameters: { type: 'object', properties: { path: { type: 'string' }, depth: { type: 'number' } } },
+            run: async (a) => {
+                const dir = inside(root, a.path);
+                if (!statSync(dir).isDirectory())
+                    throw new Error(`${rel(root, dir)} is not a directory.`);
+                const depth = Math.min(4, Math.max(1, Number(a.depth) || 2));
+                return `${rel(root, dir)}/\n${listDir(root, dir, depth).join('\n')}`;
+            },
+        },
+        {
+            name: 'read_file',
+            description: `Read a text file, with line numbers. \`offset\` (1-based line) and \`limit\` (lines, default ${READ_CAP}) read part of a long file.`,
+            parameters: { type: 'object', properties: { path: { type: 'string' }, offset: { type: 'number' }, limit: { type: 'number' } }, required: ['path'] },
+            run: async (a) => {
+                const file = inside(root, a.path);
+                const lines = readFileSync(file, 'utf8').split('\n');
+                const from = Math.max(1, Number(a.offset) || 1);
+                const count = Math.max(1, Number(a.limit) || READ_CAP);
+                const slice = lines.slice(from - 1, from - 1 + count).map((l, i) => `${String(from + i).padStart(5)}  ${l}`);
+                const more = from - 1 + count < lines.length ? `\n…(${lines.length - (from - 1 + count)} more lines; read on with offset ${from + count})` : '';
+                return `${rel(root, file)} (${lines.length} lines)\n${slice.join('\n')}${more}`;
+            },
+        },
+        {
+            name: 'search',
+            description: 'Search file contents with a regular expression (ripgrep). Optional `path` to narrow, `glob` to filter files (e.g. "*.ts"). Returns file:line:text, at most 20 matches per file.',
+            parameters: { type: 'object', properties: { pattern: { type: 'string' }, path: { type: 'string' }, glob: { type: 'string' } }, required: ['pattern'] },
+            run: async (a, ctx) => {
+                const where = inside(root, a.path);
+                const out = await ripgrep(root, String(a.pattern ?? ''), rel(root, where), a.glob ? String(a.glob) : undefined, ctx.signal);
+                if (!out.trim())
+                    return 'No matches.';
+                const lines = out.trim().split('\n');
+                return lines.length > 300 ? `${lines.slice(0, 300).join('\n')}\n…(${lines.length - 300} more matches; narrow the search)` : lines.join('\n');
+            },
+        },
+        {
+            name: 'write_file',
+            description: 'Create or overwrite a file with `content`. Asks the person first.',
+            parameters: { type: 'object', properties: { path: { type: 'string' }, content: { type: 'string' } }, required: ['path', 'content'] },
+            write: {
+                describe: a => {
+                    const file = inside(root, a.path);
+                    const n = String(a.content ?? '').split('\n').length;
+                    return `${existsSync(file) ? 'Overwrite' : 'Create'} ${rel(root, file)} (${n} lines)`;
+                },
+            },
+            run: async (a) => {
+                const file = inside(root, a.path);
+                mkdirSync(dirname(file), { recursive: true });
+                writeFileSync(file, String(a.content ?? ''));
+                return `Wrote ${rel(root, file)}.`;
+            },
+        },
+        {
+            name: 'edit_file',
+            description: 'Replace exact text in a file: `old` must appear exactly once (or pass `all: true`). Copy `old` from read_file output without the line numbers. Asks the person first.',
+            parameters: { type: 'object', properties: { path: { type: 'string' }, old: { type: 'string' }, new: { type: 'string' }, all: { type: 'boolean' } }, required: ['path', 'old', 'new'] },
+            write: {
+                describe: a => {
+                    const file = inside(root, a.path);
+                    const oldText = String(a.old ?? '');
+                    const count = existsSync(file) ? readFileSync(file, 'utf8').split(oldText).length - 1 : 0;
+                    const first = (s) => JSON.stringify(s.split('\n')[0].slice(0, 60));
+                    return `Edit ${rel(root, file)}: replace ${a.all ? `${count} occurrence(s) of` : ''} ${first(oldText)} → ${first(String(a.new ?? ''))}`;
+                },
+            },
+            run: async (a) => {
+                const file = inside(root, a.path);
+                const text = readFileSync(file, 'utf8');
+                const oldText = String(a.old ?? '');
+                if (!oldText)
+                    throw new Error('`old` is empty.');
+                const count = text.split(oldText).length - 1;
+                if (count === 0)
+                    throw new Error('`old` was not found. Read the file again and copy the text exactly (without line numbers).');
+                if (count > 1 && !a.all)
+                    throw new Error(`\`old\` appears ${count} times. Add surrounding lines to make it unique, or pass all: true.`);
+                writeFileSync(file, a.all ? text.split(oldText).join(String(a.new ?? '')) : text.replace(oldText, () => String(a.new ?? '')));
+                return `Edited ${rel(root, file)} (${a.all ? count : 1} replacement${(a.all ? count : 1) > 1 ? 's' : ''}).`;
+            },
+        },
+    ];
+    return { name: 'files', description: `Files in the working directory (${root}).`, tools };
+}
+//# sourceMappingURL=files.js.map

package/dist/cli/files.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":""}

package/dist/cli/main.js

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+/**
+ * `agent` — a terminal REPL to test the agent core, in the spirit of opencode.
+ *
+ *   agent                                   chat in the current directory
+ *   agent -p "what does this repo do?"      one turn, then exit (exit code 1 unless done)
+ *   agent --model <id> --guidance close --max-usd 0.2 --yes --verbose
+ *
+ * The agent gets: files (read/list/search, and write/edit with approval), the shell (each command
+ * approved), MCP servers from `.mcp.json`, and skills from `.claude/skills`. Every tool call, Jev
+ * checkpoint, level change and cost is printed, and every event is logged to
+ * ~/.agent-cli/sessions/<time>.jsonl.
+ *
+ * Config is plain environment: OPENROUTER_API_KEY (required), AGENT_MODEL and AGENT_MAX_USD
+ * (defaults for --model and --max-usd). In the agent repo, cli/scripts/agent.sh supplies them through
+ * varlock. There is no default model on purpose: pick one with --model (see `agent --models`).
+ */
+import { homedir } from 'node:os';
+import { join, resolve } from 'node:path';
+import { parseArgs } from 'node:util';
+import { createInterface } from 'node:readline/promises';
+import { dirSkills, modelCatalog, openrouter } from "../index.js";
+import { connectAll } from "./mcp.js";
+import { createSession } from "./session.js";
+import { fileToolset } from "./files.js";
+import { shellToolset } from "./shell.js";
+import { c, printer, summary } from "./ui.js";
+const { values: flags, positionals } = parseArgs({
+    options: {
+        prompt: { type: 'string', short: 'p' },
+        model: { type: 'string', short: 'm' },
+        guidance: { type: 'string', short: 'g' },
+        'max-usd': { type: 'string' },
+        cwd: { type: 'string' },
+        yes: { type: 'boolean', short: 'y' },
+        verbose: { type: 'boolean', short: 'v' },
+        'no-mcp': { type: 'boolean' },
+        'no-skills': { type: 'boolean' },
+        'no-shell': { type: 'boolean' },
+        models: { type: 'boolean' },
+        help: { type: 'boolean', short: 'h' },
+    },
+    allowPositionals: true,
+});
+const HELP = `agent — test the agent core from a terminal
+
+  agent [options]            chat in the current directory
+  agent -p "…" [options]     one turn, then exit
+
+  agent --models [filter]    tool-capable OpenRouter models, cheapest first
+
+  -m, --model <id>           OpenRouter model (default: $AGENT_MODEL; required)
+  -g, --guidance <level>     auto | off | light | normal | close | N   (default: auto)
+      --max-usd <n>          USD cap per turn (default: $AGENT_MAX_USD)
+      --cwd <dir>            working directory (default: here)
+  -y, --yes                  approve every change and command without asking
+  -v, --verbose              longer tool results, and the transient lines said to the model
+      --no-mcp --no-skills --no-shell
+
+In the chat:  /help  /model [id]  /models [filter]  /guidance [level]  /budget [usd]
+              /cost  /tools  /mcp  /skills  /auto  /log  /clear  /exit      Ctrl+C stops a turn`;
+if (flags.help) {
+    console.log(HELP);
+    process.exit(0);
+}
+async function listModels(filter, write) {
+    const cards = (await modelCatalog()).filter(m => m.tools && (!filter || m.id.includes(filter) || m.name.toLowerCase().includes(filter.toLowerCase())));
+    cards.sort((a, b) => a.completion - b.completion);
+    for (const m of cards.slice(0, 20))
+        write(`${m.id.padEnd(48)} ${c.dim(`$${(m.completion * 1e6).toFixed(2)}/M out · ${Math.round(m.context / 1000)}k ctx`)}\n`);
+    write(c.dim(`${cards.length} tool-capable models${filter ? ` matching "${filter}"` : ''}, cheapest first\n`));
+}
+if (flags.models) {
+    await listModels(positionals[0], s => process.stdout.write(s));
+    process.exit(0);
+}
+const parseGuidance = (s) => {
+    if (!s)
+        return 'auto';
+    if (['auto', 'off', 'light', 'normal', 'close'].includes(s))
+        return s;
+    const n = Number(s);
+    return Number.isFinite(n) && n >= 1 ? n : null;
+};
+const root = resolve(flags.cwd ?? process.cwd());
+const model = flags.model ?? process.env.AGENT_MODEL;
+const guidance = parseGuidance(flags.guidance);
+if (guidance === null) {
+    console.error(`--guidance must be auto, off, light, normal, close or a number`);
+    process.exit(2);
+}
+if (!process.env.OPENROUTER_API_KEY) {
+    console.error('OPENROUTER_API_KEY is not set. Export it, or in the agent repo run cli/scripts/agent.sh (varlock).');
+    process.exit(2);
+}
+if (!model) {
+    console.error('No model: pass --model <id> or set AGENT_MODEL. See `agent --models` for tool-capable models, cheapest first.');
+    process.exit(2);
+}
+const oneShot = flags.prompt !== undefined;
+const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: process.stdin.isTTY });
+const out = (s) => process.stdout.write(s);
+const print = printer(out, { stream: true, verbose: !!flags.verbose });
+// ── tools ──
+const toolsets = [fileToolset(root), ...(flags['no-shell'] ? [] : [shellToolset(root)])];
+let mcp = [];
+if (!flags['no-mcp']) {
+    mcp = await connectAll(root, text => out(c.yellow(`${text}\n`)));
+    for (const m of mcp)
+        if (m.toolset)
+            toolsets.push(m.toolset);
+}
+const skills = flags['no-skills'] ? undefined : dirSkills(join(root, '.claude', 'skills'), join(homedir(), '.claude', 'skills'));
+// ── approvals ──
+const ask = async (req) => {
+    if (!process.stdin.isTTY)
+        return 'no';
+    if (print.midLine())
+        out('\n');
+    const a = (await rl.question(`${c.yellow('?')} ${c.bold(req.summary)}\n  ${c.dim('allow? [y]es / [n]o / [a]lways for')} ${req.tool} ${c.dim('›')} `)).trim().toLowerCase();
+    return a.startsWith('a') ? 'always' : a.startsWith('y') ? 'yes' : 'no';
+};
+const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+const session = createSession({
+    provider: openrouter({ model, headers: { 'X-Title': 'agent-cli' } }),
+    model,
+    root,
+    toolsets,
+    skills,
+    guidance,
+    maxUsd: Number(flags['max-usd'] ?? process.env.AGENT_MAX_USD ?? 0.5),
+    ask,
+    onEvent: print,
+    logPath: join(homedir(), '.agent-cli', 'sessions', `${stamp}.jsonl`),
+    profilesPath: join(homedir(), '.agent-cli', 'profiles.json'),
+    autoApprove: !!flags.yes,
+});
+// ── one turn ──
+let running = null;
+async function turn(text) {
+    running = new AbortController();
+    try {
+        const r = await session.send(text, running.signal);
+        if (print.midLine())
+            out('\n');
+        out(`${summary(r, session.total)}\n`);
+        return r;
+    }
+    catch (error) {
+        if (print.midLine())
+            out('\n');
+        out(`${c.red('error')} ${error instanceof Error ? error.message : String(error)}\n`);
+        return null;
+    }
+    finally {
+        running = null;
+    }
+}
+rl.on('SIGINT', () => {
+    if (running) {
+        running.abort();
+        out(c.yellow('\n(stopping…)\n'));
+    }
+    else {
+        out('\n');
+        rl.close();
+        process.exit(0);
+    }
+});
+if (oneShot) {
+    const r = await turn(flags.prompt);
+    rl.close();
+    for (const m of mcp)
+        m.session?.close();
+    process.exit(r && ['done', 'greeted', 'chatted'].includes(r.status) ? 0 : 1);
+}
+// ── the REPL ──
+out(`${c.bold('agent')} ${c.dim(`· ${model ?? '(no model)'} · guidance ${String(guidance)} · $${session.maxUsd}/turn · ${root}`)}\n`);
+const tools = toolsets.flatMap(s => s.tools.map(t => t.name));
+out(c.dim(`tools: ${tools.length} (${toolsets.map(s => `${s.name} ${s.tools.length}`).join(', ')}) · /help for commands\n`));
+for (const m of mcp)
+    if (!m.ok)
+        out(c.yellow(`mcp ${m.name}: ${m.error}\n`));
+async function command(line) {
+    const [cmd, ...rest] = line.slice(1).split(/\s+/);
+    const arg = rest.join(' ').trim();
+    switch (cmd) {
+        case 'help':
+            out(`${HELP}\n`);
+            break;
+        case 'exit':
+        case 'quit':
+            return false;
+        case 'model':
+            if (arg)
+                session.model = arg;
+            out(`model: ${session.model}\n`);
+            break;
+        case 'models':
+            await listModels(arg || undefined, out);
+            break;
+        case 'guidance': {
+            const g = parseGuidance(arg || undefined);
+            if (arg && g === null)
+                out('auto | off | light | normal | close | N\n');
+            else if (arg)
+                session.guidance = g;
+            out(`guidance: ${String(session.guidance)}\n`);
+            break;
+        }
+        case 'budget':
+            if (arg && Number(arg) > 0)
+                session.maxUsd = Number(arg);
+            out(`budget: $${session.maxUsd} per turn\n`);
+            break;
+        case 'cost':
+            out(`session: $${session.total.toFixed(5)} over ${session.turns} turn(s)\n`);
+            break;
+        case 'tools':
+            for (const s of toolsets)
+                out(`${c.bold(s.name)}: ${s.tools.map(t => (t.write ? `${t.name}*` : t.name)).join(', ')}\n`);
+            out(c.dim('* asks approval\n'));
+            break;
+        case 'mcp':
+            if (!mcp.length)
+                out('no MCP servers (add them to .mcp.json or ~/.agent-cli/mcp.json)\n');
+            for (const m of mcp)
+                out(`${m.name}: ${m.ok ? c.green(`${m.tools} tools`) : c.red(m.error ?? 'failed')}\n`);
+            break;
+        case 'skills': {
+            const list = skills ? await skills.list() : [];
+            if (!list.length)
+                out('no skills (.claude/skills here or in ~)\n');
+            for (const s of list)
+                out(`${c.bold(s.name)} ${c.dim(s.description.slice(0, 100))}\n`);
+            break;
+        }
+        case 'auto':
+            session.autoApprove = !session.autoApprove;
+            out(`auto-approve: ${session.autoApprove ? c.yellow('on — every change and command runs without asking') : 'off'}\n`);
+            break;
+        case 'log':
+            out(`${session.logPath}\n`);
+            break;
+        case 'clear':
+            session.clear();
+            out('new conversation\n');
+            break;
+        default:
+            out(`unknown command /${cmd} — /help\n`);
+    }
+    return true;
+}
+for (;;) {
+    let line;
+    try {
+        line = (await rl.question(c.cyan('› '))).trim();
+    }
+    catch {
+        break;
+    }
+    if (!line)
+        continue;
+    if (line.startsWith('/')) {
+        if (!(await command(line)))
+            break;
+        continue;
+    }
+    await turn(line);
+}
+rl.close();
+for (const m of mcp)
+    m.session?.close();
+process.exit(0);
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/mcp.d.ts

@@ -0,0 +1,28 @@
+import { type McpLike, type Toolset } from '../index.ts';
+/** The parts of ensemble's McpServerSpec this reads and writes (kept local: ensemble is optional). */
+export type McpServerSpec = {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    url: string;
+    transport?: 'auto' | 'streamable-http' | 'sse' | 'websocket';
+    headers?: Record<string, string>;
+};
+type McpSession = McpLike & {
+    close(): void;
+};
+export declare const ENSEMBLE = "@ghostmind-dev/ensemble";
+export declare const WRITE_VERBS: RegExp;
+export declare function mcpConfig(cwd: string): Record<string, McpServerSpec>;
+export interface McpConnection {
+    name: string;
+    ok: boolean;
+    tools: number;
+    error?: string;
+    session?: McpSession;
+    toolset?: Toolset;
+}
+export declare function connectAll(cwd: string, onLogin: (text: string) => void): Promise<McpConnection[]>;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

package/dist/cli/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/cli/mcp.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAc,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAErE,sGAAsG;AACtG,MAAM,MAAM,aAAa,GACrB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,KAAK,GAAG,WAAW,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEpH,KAAK,UAAU,GAAG,OAAO,GAAG;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CAAC;AAG9C,eAAO,MAAM,QAAQ,4BAA4B,CAAC;AAqBlD,eAAO,MAAM,WAAW,QAAyM,CAAC;AAElO,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAiBpE;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAmBvG"}

package/dist/cli/mcp.js

@@ -0,0 +1,86 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * MCP servers, from the same `.mcp.json` Claude Code reads.
+ *
+ * The connection is ensemble's `connect()` (stdio, Streamable HTTP, SSE, WebSocket, and every auth
+ * mode including OAuth logins), used here as a third-party library: the agent core speaks no MCP wire
+ * protocol, it only takes a session shaped `{ name, listTools, call }`.
+ *
+ * Ensemble is an OPTIONAL peer dependency, loaded only when a server is configured: the package keeps
+ * zero runtime dependencies, and files, shell and skills work without it. Without it, each server is
+ * reported with the install command.
+ *
+ * Config is read from `<cwd>/.mcp.json`, then `~/.agent-cli/mcp.json` (the first definition of a name
+ * wins). A server that fails to connect is reported and skipped; it never stops the CLI.
+ *
+ * Which MCP calls are CHANGES is not something servers say reliably, so the CLI guesses from the
+ * tool's name (create_, update_, delete_…) and asks approval for those. `/auto` skips all approvals.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { mcpToolset } from "../index.js";
+export const ENSEMBLE = '@ghostmind-dev/ensemble';
+/** ensemble's connect(), or null when it is not installed. */
+async function loadConnect() {
+    try {
+        const mod = (await import(__rewriteRelativeImportExtension(ENSEMBLE)));
+        return mod.connect ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export const WRITE_VERBS = /^(create|update|delete|remove|write|set|add|edit|append|trash|apply|send|put|patch|move|rename|upload|restore|link|unlink|pin|unpin|publish|deploy|run|execute|insert|drop|merge|close|archive)[_-]/i;
+export function mcpConfig(cwd) {
+    const out = {};
+    for (const file of [join(cwd, '.mcp.json'), join(homedir(), '.agent-cli', 'mcp.json')]) {
+        if (!existsSync(file))
+            continue;
+        let servers = {};
+        try {
+            servers = JSON.parse(readFileSync(file, 'utf8')).mcpServers ?? {};
+        }
+        catch {
+            continue;
+        }
+        for (const [name, s] of Object.entries(servers)) {
+            if (name in out)
+                continue;
+            if (s.url)
+                out[name] = { url: s.url, transport: s.type === 'sse' ? 'sse' : s.type === 'ws' ? 'websocket' : 'auto', ...(s.headers ? { headers: s.headers } : {}) };
+            else if (s.command)
+                out[name] = { command: s.command, ...(s.args ? { args: s.args } : {}), ...(s.env ? { env: s.env } : {}) };
+        }
+    }
+    return out;
+}
+export async function connectAll(cwd, onLogin) {
+    const specs = mcpConfig(cwd);
+    if (!Object.keys(specs).length)
+        return [];
+    const connect = await loadConnect();
+    if (!connect)
+        return Object.keys(specs).map(name => ({ name, ok: false, tools: 0, error: `MCP needs ${ENSEMBLE}: npm install -g ${ENSEMBLE} (or add it next to this package)` }));
+    return Promise.all(Object.entries(specs).map(async ([name, spec]) => {
+        try {
+            // Interactive: an OAuth server (Potion) may open a browser to log in the first time.
+            const session = await connect(name, spec, { interactive: true, prompt: onLogin });
+            const toolset = await mcpToolset(session, {
+                writes: (tool, args) => (WRITE_VERBS.test(tool) ? `${name}.${tool}(${JSON.stringify(args).slice(0, 160)})` : null),
+            });
+            return { name, ok: true, tools: toolset.tools.length, session, toolset };
+        }
+        catch (error) {
+            return { name, ok: false, tools: 0, error: error instanceof Error ? error.message : String(error) };
+        }
+    }));
+}
+//# sourceMappingURL=mcp.js.map

package/dist/cli/mcp.js.map

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

package/dist/cli/session.d.ts

@@ -0,0 +1,34 @@
+import { type AgentEvent, type AgentResult, type ApprovalRequest, type Guidance, type ModelProvider, type SkillSource, type Toolset } from '../index.ts';
+export type Answer = 'yes' | 'no' | 'always';
+export interface SessionOptions {
+    provider: ModelProvider;
+    model?: string;
+    root: string;
+    toolsets: Toolset[];
+    skills?: SkillSource;
+    guidance: Guidance;
+    maxUsd: number;
+    /** Ask the person about one change. */
+    ask: (request: ApprovalRequest) => Promise<Answer>;
+    onEvent: (event: AgentEvent) => void;
+    /** Every event of every turn, one JSON line each. */
+    logPath?: string;
+    /** Per-model guide profiles, so the guide learns across sessions. */
+    profilesPath?: string;
+    autoApprove?: boolean;
+}
+export declare function createSession(o: SessionOptions): {
+    send: (text: string, signal?: AbortSignal) => Promise<AgentResult>;
+    readonly total: number;
+    readonly turns: number;
+    model: string | undefined;
+    guidance: Guidance;
+    maxUsd: number;
+    autoApprove: boolean;
+    readonly always: string[];
+    readonly logPath: string | undefined;
+    events: () => readonly import("../events.ts").LoggedEvent[];
+    clear(): void;
+};
+export type Session = ReturnType<typeof createSession>;
+//# sourceMappingURL=session.d.ts.map

package/dist/cli/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/cli/session.ts"],"names":[],"mappings":"AASA,OAAO,EAKL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,GAAG,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACrC,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AASD,wBAAgB,aAAa,CAAC,CAAC,EAAE,cAAc;iBAcnB,MAAM,WAAW,WAAW,KAAG,OAAO,CAAC,WAAW,CAAC;;;WA6C7D,MAAM,GAAG,SAAS;cAMhB,QAAQ;YAMV,MAAM;iBAMD,OAAO;;;;;EAc7B;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/cli/session.js

@@ -0,0 +1,109 @@
+/**
+ * A conversation with the agent core: history across turns, approvals, the event log, costs.
+ *
+ * Kept apart from the terminal (main.ts) so it can be driven by a test with a scripted model. The
+ * agent here is a generic command-line agent: its words are the core's defaults plus a few lines
+ * about working in a directory on the person's machine, and its tools are what the CLI was given.
+ */
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { defaultPrompts, eventLog, fileProfiles, runAgent, } from "../index.js";
+const SYSTEM_EXTRA = (root) => [
+    `You are a command-line agent on the person's machine, working in ${root}. Paths are relative to it.`,
+    'Look before you answer: list, search and read files instead of guessing what they contain. Quote paths and line numbers you actually read.',
+    'To change a file, read it first, then use edit_file with an exact passage (or write_file for a new file). Every change and every shell command waits for the person\'s approval.',
+    'Keep answers short and concrete. Say what you changed, and what you could not do.',
+];
+export function createSession(o) {
+    let history = [];
+    let total = 0;
+    let model = o.model;
+    let guidance = o.guidance;
+    let maxUsd = o.maxUsd;
+    let autoApprove = o.autoApprove ?? false;
+    const always = new Set();
+    const turns = [];
+    if (o.logPath)
+        mkdirSync(dirname(o.logPath), { recursive: true });
+    const log = eventLog({ onAppend: e => void (o.logPath && appendFileSync(o.logPath, `${JSON.stringify(e)}\n`)) });
+    const profiles = o.profilesPath ? fileProfiles(o.profilesPath) : undefined;
+    async function send(text, signal) {
+        const result = await runAgent({
+            provider: o.provider,
+            model,
+            task: {
+                goal: text,
+                context: { cwd: o.root, platform: process.platform, today: new Date().toISOString().slice(0, 10) },
+                expectation: 'A direct, short answer to the request, grounded in what the tools returned. When something was changed, say exactly what.',
+                welcome: 'Hi. Ask me about this directory, or to change something in it.',
+            },
+            toolsets: o.toolsets,
+            skills: o.skills,
+            prompts: { system: [...defaultPrompts.system, ...SYSTEM_EXTRA(o.root)] },
+            history,
+            guidance,
+            guide: profiles ? { profiles } : undefined,
+            budget: { maxUsd, maxSteps: 16, maxToolCalls: 30 },
+            approve: async (request) => {
+                if (autoApprove || always.has(request.tool))
+                    return true;
+                const a = await o.ask(request);
+                if (a === 'always')
+                    always.add(request.tool);
+                return a !== 'no';
+            },
+            stream: true,
+            signal,
+            log,
+            onEvent: o.onEvent,
+        });
+        history = result.messages.filter(m => m.role !== 'system');
+        total += result.cost;
+        turns.push(result);
+        return result;
+    }
+    return {
+        send,
+        get total() {
+            return total;
+        },
+        get turns() {
+            return turns.length;
+        },
+        get model() {
+            return model;
+        },
+        set model(id) {
+            model = id;
+        },
+        get guidance() {
+            return guidance;
+        },
+        set guidance(g) {
+            guidance = g;
+        },
+        get maxUsd() {
+            return maxUsd;
+        },
+        set maxUsd(v) {
+            maxUsd = v;
+        },
+        get autoApprove() {
+            return autoApprove;
+        },
+        set autoApprove(v) {
+            autoApprove = v;
+        },
+        get always() {
+            return [...always];
+        },
+        get logPath() {
+            return o.logPath;
+        },
+        events: () => log.entries(),
+        clear() {
+            history = [];
+        },
+    };
+}
+//# sourceMappingURL=session.js.map

package/dist/cli/session.js.map

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

package/dist/cli/shell.d.ts

@@ -0,0 +1,8 @@
+import type { Toolset } from '../index.ts';
+export declare function runCommand(command: string, cwd: string, timeoutS: number, signal: AbortSignal): Promise<{
+    code: number | null;
+    output: string;
+    timedOut: boolean;
+}>;
+export declare function shellToolset(root: string): Toolset;
+//# sourceMappingURL=shell.d.ts.map

package/dist/cli/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/cli/shell.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAqBnK;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBlD"}

package/dist/cli/shell.js

@@ -0,0 +1,52 @@
+/**
+ * Shell — one command at a time, in the working directory, each approved by the person first.
+ *
+ * Every command is a change as far as the loop is concerned (it can do anything), so the core asks
+ * `approve` with the command itself as the sentence. Output is capped, and a command that outlives
+ * its timeout — or the turn's Stop — is killed.
+ */
+import { spawn } from 'node:child_process';
+const OUT_CAP = 12_000;
+export function runCommand(command, cwd, timeoutS, signal) {
+    return new Promise(ok => {
+        const child = spawn('bash', ['-lc', command], { cwd, env: process.env, signal });
+        let output = '';
+        let timedOut = false;
+        const add = (d) => {
+            if (output.length < OUT_CAP * 2)
+                output += d.toString();
+        };
+        child.stdout.on('data', add);
+        child.stderr.on('data', add);
+        const timer = setTimeout(() => {
+            timedOut = true;
+            child.kill('SIGKILL');
+        }, timeoutS * 1000);
+        const done = (code) => {
+            clearTimeout(timer);
+            ok({ code, output: output.length > OUT_CAP ? `${output.slice(0, OUT_CAP / 2)}\n…(cut)…\n${output.slice(-OUT_CAP / 2)}` : output, timedOut });
+        };
+        child.on('close', done);
+        child.on('error', () => done(null));
+    });
+}
+export function shellToolset(root) {
+    return {
+        name: 'shell',
+        description: `Shell commands in ${root}.`,
+        tools: [
+            {
+                name: 'run_command',
+                description: 'Run one bash command in the working directory and get its output and exit code. Default timeout 60 s (max 600). Asks the person first.',
+                parameters: { type: 'object', properties: { command: { type: 'string' }, timeout_s: { type: 'number' } }, required: ['command'] },
+                write: { describe: a => `Run: ${String(a.command ?? '')}` },
+                run: async (a, ctx) => {
+                    const t = Math.min(600, Math.max(1, Number(a.timeout_s) || 60));
+                    const r = await runCommand(String(a.command ?? ''), root, t, ctx.signal);
+                    return `${r.timedOut ? `(killed after ${t}s)\n` : ''}exit ${r.code ?? 'none'}\n${r.output || '(no output)'}`;
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=shell.js.map

package/dist/cli/shell.js.map

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

package/dist/cli/ui.d.ts

@@ -0,0 +1,29 @@
+/**
+ * What the person sees: the agent's events as terminal lines, with plain ANSI (no dependency).
+ *
+ * The CLI is a test bench, so it shows the engine's inner life that an app would hide: every tool
+ * call and result, every Jev checkpoint with its probability and what the loop did, level changes,
+ * nudges, and each turn's status, steps and cost.
+ */
+import type { AgentEvent, AgentResult } from '../index.ts';
+export declare const c: {
+    dim: (s: string) => string;
+    bold: (s: string) => string;
+    red: (s: string) => string;
+    green: (s: string) => string;
+    yellow: (s: string) => string;
+    blue: (s: string) => string;
+    magenta: (s: string) => string;
+    cyan: (s: string) => string;
+};
+export interface Printer {
+    (event: AgentEvent): void;
+    /** Whether text has been streamed since the last newline. */
+    midLine(): boolean;
+}
+export declare function printer(write: (s: string) => void, options: {
+    stream: boolean;
+    verbose: boolean;
+}): Printer;
+export declare function summary(r: AgentResult, total: number): string;
+//# sourceMappingURL=ui.d.ts.map

package/dist/cli/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/cli/ui.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI3D,eAAO,MAAM,CAAC;aADsB,MAAM;cAAN,MAAM;aAAN,MAAM;eAAN,MAAM;gBAAN,MAAM;cAAN,MAAM;iBAAN,MAAM;cAAN,MAAM;CAUzC,CAAC;AAOF,MAAM,WAAW,OAAO;IACtB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,IAAI,OAAO,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAuD3G;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/cli/ui.js

@@ -0,0 +1,83 @@
+const tty = process.stdout.isTTY && !process.env.NO_COLOR;
+const paint = (code) => (s) => (tty ? `\x1b[${code}m${s}\x1b[0m` : s);
+export const c = {
+    dim: paint('2'),
+    bold: paint('1'),
+    red: paint('31'),
+    green: paint('32'),
+    yellow: paint('33'),
+    blue: paint('34'),
+    magenta: paint('35'),
+    cyan: paint('36'),
+};
+const short = (s, n) => {
+    const one = s.replace(/\s+/g, ' ').trim();
+    return one.length > n ? `${one.slice(0, n)}…` : one;
+};
+export function printer(write, options) {
+    let mid = false;
+    const line = (s) => {
+        if (mid)
+            write('\n');
+        mid = false;
+        write(`${s}\n`);
+    };
+    const print = ((e) => {
+        switch (e.type) {
+            case 'delta':
+                if (options.stream) {
+                    write(e.text);
+                    mid = !e.text.endsWith('\n');
+                }
+                return;
+            case 'message':
+                if (!options.stream)
+                    line(e.text);
+                return;
+            case 'skills':
+                if (e.names.length)
+                    line(c.cyan(`· skills picked by Jev: ${e.names.join(', ')}`));
+                return;
+            case 'opening':
+                if (e.path !== 'task')
+                    line(c.cyan(`· Jev: ${e.path} (${e.confidence.toFixed(2)})`));
+                return;
+            case 'tool_call':
+                line(c.blue(`→ ${e.name}`) + c.dim(` ${short(JSON.stringify(e.args), 140)}`));
+                return;
+            case 'tool_result':
+                line(`  ${e.ok ? c.green('✓') : c.red('✗')} ${c.dim(short(e.result, options.verbose ? 600 : 120))}`);
+                return;
+            case 'checkpoint': {
+                const p = e.p === null ? '—' : e.p.toFixed(2);
+                const what = e.choice ? `${e.choice} ` : '';
+                const col = e.action === 'pass' || e.action === 'none' ? c.dim : c.magenta;
+                line(col(`· Jev ${e.at} ${what}p=${p} → ${e.action} [${e.level}]`));
+                return;
+            }
+            case 'guidance':
+                line(c.magenta(`· guidance ${e.from ?? 'start'} → ${e.level} (${e.reason})`));
+                return;
+            case 'nudge':
+                line(c.yellow(`↺ ${short(e.reason, 160)}`));
+                return;
+            case 'hook':
+                if (e.verdict !== 'go')
+                    line(c.yellow(`· ${e.hook}: ${e.verdict}${e.reason ? ` (${e.reason})` : ''}`));
+                return;
+            case 'context':
+                if (options.verbose && e.transient)
+                    line(c.dim(`  [said to the model] ${short(String(e.message.content ?? ''), 200)}`));
+                return;
+            default:
+                return;
+        }
+    });
+    print.midLine = () => mid;
+    return print;
+}
+export function summary(r, total) {
+    const tone = r.status === 'done' || r.status === 'greeted' || r.status === 'chatted' ? c.green : r.status === 'needs_person' || r.status === 'paused' ? c.yellow : c.red;
+    return c.dim(`${tone(r.status)} · ${r.steps} steps · ${r.toolCalls} tool calls · $${r.cost.toFixed(5)} (session $${total.toFixed(5)})${r.reason ? ` · ${r.reason}` : ''}`);
+}
+//# sourceMappingURL=ui.js.map

package/dist/cli/ui.js.map

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

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@ghostmind-dev/agent",
-  "version": "0.1.0",
-  "description": "The agent engine every app builds its own agent from: the tool loop and its guards, a model seam (OpenRouter + Jev), budgets with a USD cap, go/pause/stop hooks, and an append-only event log. A library, not a service.",
+  "version": "0.2.0",
+  "description": "The agent engine every app builds its own agent from: the tool loop and its guards, a model seam (OpenRouter + Jev), the Jev guide, budgets with a USD cap, go/pause/stop hooks, and an append-only event log. A library, plus an `agent` command line to try it.",
   "type": "module",
   "license": "MIT",
+  "bin": {
+    "agent": "dist/cli/main.js"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -26,7 +29,8 @@
     "mcp",
     "agent-skills",
     "hooks",
-    "budget"
+    "budget",
+    "cli"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json",
@@ -37,8 +41,8 @@
     "bench": "node bench/guidance.mts",
     "prepublishOnly": "npm run typecheck && npm test"
   },
-  "dependencies": {},
   "devDependencies": {
+    "@ghostmind-dev/ensemble": "^0.31.0",
     "@types/node": "^22.10.0",
     "typescript": "^5.7.0"
   },
@@ -46,5 +50,13 @@
     "node": ">=22.18.0"
   },
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts"
+  "types": "./dist/index.d.ts",
+  "peerDependencies": {
+    "@ghostmind-dev/ensemble": ">=0.31.0"
+  },
+  "peerDependenciesMeta": {
+    "@ghostmind-dev/ensemble": {
+      "optional": true
+    }
+  }
 }