@namzu/cli 0.0.3 → 0.2.0

package/dist/commands/run-stream.js

@@ -0,0 +1,326 @@
+/**
+ * `namzu run-stream [--session <key>] "<prompt>"` — headless STREAMING
+ * one-shot. Same engine as `run`, but instead of buffering the final text it
+ * emits one compact NDJSON line per `AgentEvent` to stdout
+ * (`{"kind":"delta","text":…}`, `{"kind":"tool-start",…}`,
+ * `{"kind":"error","message":…}`, `{"kind":"done"}`). A host process (the
+ * clawtool desktop) line-scans stdout and renders the turn live — the
+ * equivalent of the TUI, driven from another runtime.
+ *
+ * History: with `--session <key>` the turn is bound to a persisted
+ * conversation in the cwd's `.namzu` store (keyed by the embedder's own
+ * session id), so prior turns are loaded as context and the new
+ * user+assistant pair is appended — that's what lets a reopened session show
+ * its past messages (`namzu history --session <key>`). Without `--session`,
+ * prior history may be supplied on stdin as a JSON `Message[]` and nothing is
+ * persisted (stateless one-shot).
+ *
+ * Status lines never hit stdout (logger silenced) so every stdout line is a
+ * valid JSON event. Provider/credential failures are emitted as a final
+ * `{"kind":"error",…}` line (exit 0) so the host surfaces them in-band.
+ */
+import { configureLogger } from '@namzu/sdk';
+import { appendMessages, loadConversation, openSessions, resolveConversation, } from '../integrations/sessions/store.js';
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return '';
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString('utf8');
+}
+function defaultPrefs(detected) {
+    const first = detected[0];
+    return first ? { version: 2, provider: first.entry.id, subagents: { active: [] } } : null;
+}
+function parseRunStreamFlags(rawArgs) {
+    const out = {
+        session: null,
+        model: null,
+        provider: null,
+        instance: null,
+        skills: [],
+        rest: [],
+    };
+    const take = (a, name, set, i) => {
+        if (a === `--${name}` && i.v + 1 < rawArgs.length) {
+            set(rawArgs[++i.v]);
+            return true;
+        }
+        if (a.startsWith(`--${name}=`)) {
+            set(a.slice(name.length + 3));
+            return true;
+        }
+        return false;
+    };
+    for (const idx = { v: 0 }; idx.v < rawArgs.length; idx.v++) {
+        const a = rawArgs[idx.v];
+        if (take(a, 'session', (v) => {
+            out.session = v.trim() || null;
+        }, idx))
+            continue;
+        if (take(a, 'model', (v) => {
+            out.model = v.trim() || null;
+        }, idx))
+            continue;
+        if (take(a, 'provider', (v) => {
+            out.provider = v.trim() || null;
+        }, idx))
+            continue;
+        if (take(a, 'instance', (v) => {
+            out.instance = v.trim() || null;
+        }, idx))
+            continue;
+        if (take(a, 'skills', (v) => {
+            out.skills = v
+                .split(',')
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }, idx))
+            continue;
+        out.rest.push(a);
+    }
+    return out;
+}
+/** Parse stdin as a prior Message[]; tolerate the UI's {role,content} shape. */
+function parsePriorMessages(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return [];
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (!Array.isArray(parsed))
+            return [];
+        const out = [];
+        for (const m of parsed) {
+            if (!m || typeof m !== 'object')
+                continue;
+            const role = m.role;
+            const content = m.content;
+            if ((role === 'user' || role === 'assistant') && typeof content === 'string') {
+                const ts = m.timestamp;
+                out.push({ role, content, timestamp: typeof ts === 'number' ? ts : Date.now() });
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+export const runStreamCommand = {
+    name: 'run-stream',
+    description: 'Run a single prompt and stream AgentEvents as NDJSON (for host UIs)',
+    passThrough: true,
+    handler: async ({ rawArgs }) => {
+        const write = (o) => {
+            process.stdout.write(`${JSON.stringify(o)}\n`);
+        };
+        const fail = (message) => {
+            write({ kind: 'error', message });
+            write({ kind: 'done' });
+            return 0;
+        };
+        const flags = parseRunStreamFlags(rawArgs);
+        const sessionKey = flags.session;
+        const prompt = flags.rest.join(' ').trim();
+        if (!prompt)
+            return fail('no prompt — pass it as an argument');
+        // Resolve the persisted conversation (if a session key was given) so we
+        // load prior turns as context and can append this turn afterward. Falls
+        // back to stdin-supplied history when running stateless.
+        let cli = null;
+        let conversationId = null;
+        let prior = [];
+        if (sessionKey) {
+            try {
+                cli = await openSessions(process.cwd());
+                conversationId = await resolveConversation(cli, sessionKey);
+                prior = await loadConversation(cli, conversationId);
+            }
+            catch {
+                cli = null; // persistence unavailable — run stateless rather than fail
+            }
+        }
+        if (!cli) {
+            prior = parsePriorMessages(await readStdin());
+        }
+        configureLogger({ level: 'silent' });
+        const { probeAgentSession, createAgentSession } = await import('../tui/agent.js');
+        const probe = await probeAgentSession();
+        let prefs = probe.preferences ?? defaultPrefs(probe.detected);
+        if (!prefs) {
+            return fail('no LLM provider available — set a credential (e.g. ANTHROPIC_API_KEY) or run `namzu` to pick one');
+        }
+        // --provider/--model override the persona's configured provider+model for
+        // this run, so the Namzu tab's picks win over ~/.namzu/preferences.json.
+        if (flags.provider)
+            prefs = { ...prefs, provider: flags.provider };
+        if (flags.model)
+            prefs = { ...prefs, model: flags.model };
+        const session = await createAgentSession(prefs, probe.detected);
+        if (!session.hasProvider)
+            return fail(session.errorHint ?? 'agent is not ready');
+        // --skills <a,b,c>: load the named skills' bodies and inject them as the
+        // turn's extra system context (the same channel the TUI's /skill uses).
+        let extraSystem;
+        if (flags.skills.length > 0) {
+            try {
+                const { discoverSkills, loadSkillBody, composeSkillsPrompt } = await import('../skills/store.js');
+                const all = discoverSkills({ cwd: process.cwd() });
+                const wanted = new Set(flags.skills);
+                const active = all
+                    .filter((s) => wanted.has(s.name))
+                    .map((s) => ({ name: s.name, body: loadSkillBody(s) }));
+                extraSystem = composeSkillsPrompt(active) ?? undefined;
+            }
+            catch {
+                // skills unavailable — run without them rather than fail the turn.
+            }
+        }
+        const userMessage = { role: 'user', content: prompt, timestamp: Date.now() };
+        const messages = [...prior, userMessage];
+        let assistantText = '';
+        try {
+            for await (const event of session.send(messages, extraSystem ? { extraSystem } : undefined)) {
+                if (event.kind === 'delta')
+                    assistantText += event.text;
+                write(event);
+            }
+        }
+        catch (err) {
+            return fail(err instanceof Error ? err.message : String(err));
+        }
+        // Persist the turn so a later `history --session <key>` (and the next
+        // turn's context) sees it. Best-effort — a store failure must not lose
+        // the reply the user already saw stream.
+        if (cli && conversationId) {
+            try {
+                const assistant = {
+                    role: 'assistant',
+                    content: assistantText,
+                    timestamp: Date.now(),
+                };
+                await appendMessages(cli, conversationId, [userMessage, assistant]);
+            }
+            catch {
+                // non-fatal
+            }
+        }
+        write({ kind: 'done' });
+        return 0;
+    },
+};
+export const historyCommand = {
+    name: 'history',
+    description: "Print a session's persisted messages as JSON (for host UIs)",
+    passThrough: true,
+    handler: async ({ rawArgs }) => {
+        const key = parseRunStreamFlags(rawArgs).session;
+        if (!key) {
+            process.stdout.write('[]\n');
+            return 0;
+        }
+        try {
+            const cli = await openSessions(process.cwd());
+            const map = await import('../integrations/sessions/store.js');
+            // Resolve WITHOUT creating: only emit history for an existing mapping.
+            const existing = await resolveExisting(cli, key);
+            if (!existing) {
+                process.stdout.write('[]\n');
+                return 0;
+            }
+            const messages = await loadConversation(cli, existing);
+            const out = messages
+                .filter((m) => (m.role === 'user' || m.role === 'assistant') && m.content)
+                .map((m) => ({ role: m.role, content: m.content }));
+            process.stdout.write(`${JSON.stringify(out)}\n`);
+            void map;
+            return 0;
+        }
+        catch {
+            process.stdout.write('[]\n');
+            return 0;
+        }
+    },
+};
+// skills-json — read-only skill discovery for a host UI (the Namzu tab's skill
+// chips). Prints the cwd-resolved skills as a JSON array of {name, description,
+// source}. Distinct from the milestone-owned `skills` management command; this
+// is the thin enumeration the desktop polls. Empty array on any failure.
+export const skillsJSONCommand = {
+    name: 'skills-json',
+    description: 'Print discovered skills as JSON (for host UIs)',
+    passThrough: true,
+    handler: async () => {
+        try {
+            const { discoverSkills } = await import('../skills/store.js');
+            const skills = discoverSkills({ cwd: process.cwd() }).map((s) => ({
+                name: s.name,
+                description: s.description,
+                source: s.source,
+            }));
+            process.stdout.write(`${JSON.stringify(skills)}\n`);
+        }
+        catch {
+            process.stdout.write('[]\n');
+        }
+        return 0;
+    },
+};
+// providers-json — read-only provider+model discovery for a host UI (the Namzu
+// tab's provider/model pickers). Emits every PROVIDER_REGISTRY entry with
+// detection state + a best-effort live model list. Distinct from the `providers`
+// profile-management command. Empty models[] → the host falls back to a
+// free-text model field seeded with `default`. Never throws.
+export const providersJSONCommand = {
+    name: 'providers-json',
+    description: 'Print providers + per-provider models as JSON (for host UIs)',
+    passThrough: true,
+    handler: async () => {
+        try {
+            const { configureLogger } = await import('@namzu/sdk');
+            configureLogger({ level: 'silent' });
+            const { PROVIDER_REGISTRY, ALL_PROVIDER_IDS, findDetected } = await import('../integrations/providers/index.js');
+            const { probeAgentSession, listProviderModels } = await import('../tui/agent.js');
+            const probe = await probeAgentSession();
+            const out = [];
+            for (const id of ALL_PROVIDER_IDS) {
+                const entry = PROVIDER_REGISTRY[id];
+                const det = findDetected(probe.detected, id) ?? null;
+                const models = det ? await listProviderModels(id, det).catch(() => []) : [];
+                out.push({
+                    provider: id,
+                    label: entry.label,
+                    detected: Boolean(det),
+                    default: entry.defaultModel,
+                    models,
+                });
+            }
+            // Detected providers first, so the picker defaults to a usable one.
+            out.sort((a, b) => Number(b.detected) - Number(a.detected));
+            process.stdout.write(`${JSON.stringify(out)}\n`);
+        }
+        catch {
+            process.stdout.write('[]\n');
+        }
+        return 0;
+    },
+};
+/** Look up an existing desktop-key → conversation mapping without creating one. */
+async function resolveExisting(cli, key) {
+    const { readFileSync } = await import('node:fs');
+    const { join } = await import('node:path');
+    try {
+        const raw = JSON.parse(readFileSync(join(cli.root, 'desktop-sessions.json'), 'utf8'));
+        const id = raw?.[key];
+        if (typeof id === 'string' && (await cli.store.getSession(id, cli.tenantId))) {
+            return id;
+        }
+    }
+    catch {
+        // no map / wiped
+    }
+    return null;
+}
+//# sourceMappingURL=run-stream.js.map

package/dist/commands/run-stream.js.map

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

package/dist/commands/run.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `namzu run "<prompt>"` — headless one-shot. Runs a single prompt through
+ * the same agent the TUI uses and prints the reply to stdout, for scripts
+ * and CI (the equivalent of claude-code's `--print`). The prompt comes from
+ * the arguments, or from stdin when piped. Status lines go to stderr (info,
+ * suppressed by `--quiet`); only the answer hits stdout.
+ *
+ * Non-interactive, so there's no approval prompt — tools auto-run, but the
+ * safety gate still hard-denies catastrophic commands. One-shots use an
+ * ephemeral session and are not added to `/resume` history.
+ */
+import type { CommandDef } from './types.js';
+export declare const runCommand: CommandDef;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAc5C,eAAO,MAAM,UAAU,EAAE,UAmDxB,CAAA"}

package/dist/commands/run.js

@@ -0,0 +1,73 @@
+/**
+ * `namzu run "<prompt>"` — headless one-shot. Runs a single prompt through
+ * the same agent the TUI uses and prints the reply to stdout, for scripts
+ * and CI (the equivalent of claude-code's `--print`). The prompt comes from
+ * the arguments, or from stdin when piped. Status lines go to stderr (info,
+ * suppressed by `--quiet`); only the answer hits stdout.
+ *
+ * Non-interactive, so there's no approval prompt — tools auto-run, but the
+ * safety gate still hard-denies catastrophic commands. One-shots use an
+ * ephemeral session and are not added to `/resume` history.
+ */
+import { configureLogger } from '@namzu/sdk';
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return '';
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString('utf8');
+}
+function defaultPrefs(detected) {
+    const first = detected[0];
+    return first ? { version: 2, provider: first.entry.id, subagents: { active: [] } } : null;
+}
+export const runCommand = {
+    name: 'run',
+    description: 'Run a single prompt headlessly and print the reply (for scripts/CI)',
+    passThrough: true,
+    handler: async ({ ctx, rawArgs }) => {
+        let prompt = rawArgs.join(' ').trim();
+        if (!prompt)
+            prompt = (await readStdin()).trim();
+        if (!prompt) {
+            ctx.formatter.error({ message: 'no prompt — pass it as an argument or pipe it via stdin' });
+            return 2;
+        }
+        configureLogger({ level: 'silent' });
+        const { probeAgentSession, createAgentSession } = await import('../tui/agent.js');
+        const probe = await probeAgentSession();
+        const prefs = probe.preferences ?? defaultPrefs(probe.detected);
+        if (!prefs) {
+            ctx.formatter.error({
+                message: 'no LLM provider available — set a credential (e.g. ANTHROPIC_API_KEY) or run `namzu` to pick one',
+            });
+            return 1;
+        }
+        const session = await createAgentSession(prefs, probe.detected);
+        if (!session.hasProvider) {
+            ctx.formatter.error({ message: session.errorHint ?? 'agent is not ready' });
+            return 1;
+        }
+        ctx.formatter.info(`namzu · ${session.providerSummary}${session.modelSummary ? ` · ${session.modelSummary}` : ''}`);
+        let text = '';
+        let failed = null;
+        for await (const event of session.send([
+            { role: 'user', content: prompt, timestamp: Date.now() },
+        ])) {
+            if (event.kind === 'delta')
+                text += event.text;
+            else if (event.kind === 'tool-start')
+                ctx.formatter.info(`⏺ ${event.toolName} ${event.summary}`);
+            else if (event.kind === 'error')
+                failed = event.message;
+        }
+        if (failed) {
+            ctx.formatter.error({ message: failed });
+            return 1;
+        }
+        ctx.formatter.print(ctx.formatter.name === 'json' ? { text: text.trim() } : text.trim());
+        return 0;
+    },
+};
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/stubs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stub commands that advertise the future surface of the CLI.
+ *
+ * Each stub corresponds to a milestone in the M0→M7 plan and exits 0 after
+ * printing a structured marker. The implementations themselves land in
+ * their respective milestone sessions (see docs.local/sessions/).
+ */
+import type { CommandDef } from './types.js';
+export declare const skillsCommand: CommandDef;
+export declare const serveCommand: CommandDef;
+export declare const stubCommands: readonly CommandDef[];
+//# sourceMappingURL=stubs.d.ts.map

package/dist/commands/stubs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.d.ts","sourceRoot":"","sources":["../../src/commands/stubs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAkB,MAAM,YAAY,CAAA;AAa5D,eAAO,MAAM,aAAa,EAAE,UAI3B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,UAS1B,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAAkC,CAAA"}

package/dist/commands/stubs.js

@@ -0,0 +1,32 @@
+/**
+ * Stub commands that advertise the future surface of the CLI.
+ *
+ * Each stub corresponds to a milestone in the M0→M7 plan and exits 0 after
+ * printing a structured marker. The implementations themselves land in
+ * their respective milestone sessions (see docs.local/sessions/).
+ */
+function stubHandler(milestone, what) {
+    return async ({ ctx }) => {
+        ctx.formatter.print({
+            stub: true,
+            milestone,
+            message: `${milestone} will implement ${what}.`,
+        });
+        return 0;
+    };
+}
+export const skillsCommand = {
+    name: 'skills',
+    description: 'Manage agentskills.io-compatible skills (M5)',
+    handler: stubHandler('M5', 'the skills subsystem'),
+};
+export const serveCommand = {
+    name: 'serve',
+    description: 'Cross-agent coordination is provided by clawtool (no separate namzu daemon)',
+    handler: async ({ ctx }) => {
+        ctx.formatter.info('namzu uses clawtool as its coordination daemon — it registers as a BIAM peer automatically. There is no separate `namzu serve`; just run `namzu`. Use /agents to see peers.');
+        return 0;
+    },
+};
+export const stubCommands = [skillsCommand, serveCommand];
+//# sourceMappingURL=stubs.js.map

package/dist/commands/stubs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stubs.js","sourceRoot":"","sources":["../../src/commands/stubs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,SAAS,WAAW,CAAC,SAAiB,EAAE,IAAY;IACnD,OAAO,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACxB,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC;YACnB,IAAI,EAAE,IAAI;YACV,SAAS;YACT,OAAO,EAAE,GAAG,SAAS,mBAAmB,IAAI,GAAG;SAC/C,CAAC,CAAA;QACF,OAAO,CAAC,CAAA;IACT,CAAC,CAAA;AACF,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAe;IACxC,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,8CAA8C;IAC3D,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,sBAAsB,CAAC;CAClD,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAAe;IACvC,IAAI,EAAE,OAAO;IACb,WAAW,EAAE,6EAA6E;IAC1F,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QAC1B,GAAG,CAAC,SAAS,CAAC,IAAI,CACjB,6KAA6K,CAC7K,CAAA;QACD,OAAO,CAAC,CAAA;IACT,CAAC;CACD,CAAA;AAED,MAAM,CAAC,MAAM,YAAY,GAA0B,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA"}

package/dist/commands/tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `namzu tools` — real implementation, replacing the M0 stub.
+ *
+ * Subcommands:
+ *   - `ls`           List tools clawtool exposes (auto-spawns daemon).
+ *   - `run <name>`   Invoke a tool by name with JSON arguments.
+ *   - `sync-types`   Generate local TS stubs via `clawtool tools export-typescript`.
+ *
+ * The command runs in passThrough mode — its own Commander instance parses
+ * the subcommand args. This keeps the top-level shell free of vendor-tool
+ * coupling and lets us expand the surface later (e.g. `tools search`)
+ * without touching the outer registry.
+ */
+import type { CommandDef } from './types.js';
+export declare const toolsCommand: CommandDef;
+//# sourceMappingURL=tools.d.ts.map

package/dist/commands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/commands/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAA;AA4F5D,eAAO,MAAM,YAAY,EAAE,UA2D1B,CAAA"}