@nanhara/hara 0.110.0 → 0.112.0

package/CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to `@nanhara/hara`.
 > Versioning (pre-1.0, SemVer-style): the **minor** (middle) number bumps for a **new feature**; the
 > **patch** (last) number bumps for **optimizations/fixes of existing features**.
 
+## 0.112.0 — /jobs: see (and manage) what's running in the background
+
+- **`/jobs` — a user-facing view of the agent's background shell jobs** (dev servers, watchers, long
+  builds started via `bash {background:true}`). hara already tracked these for the *agent* (the `job`
+  tool), but the *user* had no way to glance and see "what's running back there" — the way codex and
+  Claude Code surface it. Now: `/jobs` lists them (id · status · age · command), `/jobs tail <id>`
+  shows recent output, `/jobs kill <id>` stops one. Works in the TUI and the readline REPL.
+- **Status row shows a `⚙ N bg` indicator** when background jobs are running, so a preview server /
+  watcher humming along is visible at a glance (live while working; `/jobs` is the on-demand truth).
+
+## 0.111.0 — an interactive /model picker: ↑↓ a model, ←→ its thinking
+
+- **`/model` (no argument) now opens an interactive picker** built on the provider registry — the
+  "one key, many models" flow. It pulls the endpoint's **live model list** (`GET /models`; a coding-plan
+  key exposes ~10: Qwen / GLM / Kimi / MiniMax / …), and you drive it with the arrow keys:
+  - **↑↓** move through the models,
+  - **←→** set the **thinking level** for this endpoint — the levels come from the registry's reasoning
+    style, so a DashScope/Ollama endpoint shows `off / on` (the real speedup toggle) while an
+    OpenAI/Anthropic one shows `off / low / medium / high`,
+  - **⏎** applies (switches the model, sets the dial, rebuilds the provider, persists to the session),
+    **esc** cancels.
+  Endpoints that don't enumerate models still let you set the thinking level (and `/model <id>` still
+  switches directly, as before). TUI only; the readline REPL keeps the text form.
+
 ## 0.110.0 — a provider registry: one key, many platforms, the right wire + thinking control for each
 
 - **hara now speaks each platform its own way, chosen from a data-driven registry (a dictionary), not

package/dist/index.js

@@ -43,6 +43,22 @@ import { EXPLORE_SYSTEM } from "./tools/agent.js";
 import { createAnthropicProvider } from "./providers/anthropic.js";
 import { createOpenAIProvider } from "./providers/openai.js";
 import { resolvePlatform } from "./providers/registry.js";
+import { listModels } from "./providers/models.js";
+import { listJobs, tailJob, killJob } from "./exec/jobs.js";
+/** Render the background-job list for /jobs (user-facing view of what the agent has running in the
+ *  background — dev servers, watchers, long tasks). Mirrors codex/Claude-Code process visibility. */
+function renderBgJobs() {
+    const js = listJobs();
+    if (!js.length)
+        return "(no background jobs — the agent starts them with bash {background:true})";
+    const age = (ms) => (ms < 60_000 ? `${Math.round(ms / 1000)}s` : `${Math.round(ms / 60_000)}m`);
+    const rows = js.map((j) => {
+        const st = j.status === "running" ? "▶ running" : j.status === "killed" ? "✕ killed" : `● exited${j.code != null ? ` (${j.code})` : ""}`;
+        const cmd = j.command.length > 64 ? j.command.slice(0, 64) + "…" : j.command;
+        return `  ${j.id}  ${st}  ${age(j.ageMs).padStart(4)}  ${cmd}`;
+    });
+    return `Background jobs — /jobs tail <id> · /jobs kill <id>:\n${rows.join("\n")}`;
+}
 import { qwenDeviceLogin, getValidQwenAuth } from "./providers/qwen-oauth.js";
 import { loadAgentsMd, hasAgentsMd, INIT_PROMPT, findProjectRoot } from "./context/agents-md.js";
 import { getEmbedder } from "./search/embed.js";
@@ -2516,6 +2532,14 @@ program.action(async (opts) => {
             },
         },
         { name: "usage", desc: "show token usage this session", run: () => void out(statusLine(cfg.model, stats.input, stats.output) + "\n") },
+        { name: "jobs", desc: "list/tail/kill background shell jobs (dev servers, watchers)", run: (a) => {
+                const [sub, jid] = (a || "").trim().split(/\s+/);
+                if (sub === "kill" && jid)
+                    return void out((killJob(jid) ? `✕ killed ${jid}` : `no running job ${jid}`) + "\n");
+                if (sub === "tail" && jid)
+                    return void out((tailJob(jid) ?? `no job ${jid}`) + "\n");
+                out(renderBgJobs() + "\n");
+            } },
         { name: "doctor", desc: "check your hara setup", run: () => void out(runDoctor(cfg) + "\n") },
         {
             name: "roles",
@@ -2877,24 +2901,28 @@ program.action(async (opts) => {
                         const force = parts.some((p) => p === "--force" || p === "all" || p === "-f");
                         const id = parts.find((p) => p !== "--force" && p !== "all" && p !== "-f");
                         if (!id) {
-                            const __force = isSessionForceModel();
-                            const __lines = [`model: ${cfg.provider}:${cfg.model}`];
-                            if (meta.model && meta.model !== cfg.model) {
-                                __lines.push(`session pinned: ${meta.model} (cfg drift — /model ${meta.model} to re-pin)`);
-                            }
-                            else {
-                                __lines.push(`session pinned: ${meta.model || "(none)"}${__force ? " · forced (all roles use session model)" : ""}`);
+                            // Bare /model → the interactive picker: the endpoint's live model list (↑↓) + its thinking
+                            // level (←→, per the registry's reasoning style). Falls back to typing an id if the endpoint
+                            // doesn't enumerate models.
+                            const bURL = cfg.baseURL ?? providerDefaultBaseURL(cfg.provider);
+                            const models = await listModels(bURL, cfg.apiKey ?? "");
+                            const style = resolvePlatform(cfg.provider, bURL).reasoning;
+                            const chosen = await h.pickModel({ models, style, current: cfg.model, effort: cfg.reasoningEffort });
+                            if (!chosen)
+                                return; // esc — no change
+                            if (chosen.model) {
+                                cfg.model = chosen.model;
+                                meta.model = chosen.model;
                             }
-                            const __roles = loadRoles(cwd);
-                            if (__roles.length) {
-                                __lines.push("roles:");
-                                for (const r of __roles) {
-                                    const eff = __force ? cfg.model : (r.model || cfg.model);
-                                    const tag = __force && r.model && r.model !== cfg.model ? " (overridden by --force)" : r.model ? " (role pin)" : " (session)";
-                                    __lines.push(`  ${r.id}: ${eff}${tag}`);
-                                }
-                            }
-                            return void h.sink.notice(__lines.join("\n"));
+                            cfg.reasoningEffort = chosen.effort;
+                            visionProvider = undefined;
+                            remindedVision = false;
+                            const p2 = await buildProvider(cfg);
+                            if (!p2)
+                                return void h.sink.notice("(could not rebuild provider)");
+                            provider = p2;
+                            saveSession(meta, history);
+                            return void h.sink.notice(`(model → ${cfg.provider}:${cfg.model} · thinking ${chosen.effort ?? "default"})`);
                         }
                         cfg.model = id;
                         meta.model = id;
@@ -2985,6 +3013,14 @@ program.action(async (opts) => {
                     }
                     if (nm === "usage")
                         return void h.sink.notice(`tokens — ↑${stats.input} ↓${stats.output}`);
+                    if (nm === "jobs") {
+                        const [sub, jid] = (arg || "").trim().split(/\s+/);
+                        if (sub === "kill" && jid)
+                            return void h.sink.notice(killJob(jid) ? `✕ killed ${jid}` : `no running job ${jid}`);
+                        if (sub === "tail" && jid)
+                            return void h.sink.notice(tailJob(jid) ?? `no job ${jid}`);
+                        return void h.sink.notice(renderBgJobs());
+                    }
                     if (nm === "doctor")
                         return void h.sink.notice(runDoctor(cfg).replace(/\[[0-9;]*m/g, ""));
                     if (nm === "vision")

package/dist/providers/models.js

@@ -0,0 +1,21 @@
+// Model discovery — "what can this key run?" A coding-plan / OpenAI-compatible key usually exposes many
+// models (Qwen, GLM, Kimi, …) via `GET {baseURL}/models`; the /model picker lists them so you switch by
+// arrow keys, not by memorizing ids. Best-effort: many endpoints don't implement it → [] and the picker
+// falls back to typing an id. `fetchImpl` is injected so this stays pure/testable.
+export async function listModels(baseURL, apiKey, fetchImpl = fetch) {
+    if (!baseURL)
+        return []; // SDK-default hosts (anthropic/openai) — no custom endpoint to enumerate
+    try {
+        const url = baseURL.replace(/\/+$/, "") + "/models";
+        const r = await fetchImpl(url, { headers: { Authorization: `Bearer ${apiKey}` } });
+        if (!r.ok)
+            return [];
+        const j = (await r.json());
+        const ids = (j?.data ?? []).map((m) => m?.id).filter((x) => typeof x === "string" && x.length > 0);
+        // Stable order + de-dup so the picker list doesn't jump around between opens.
+        return [...new Set(ids)].sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}

package/dist/tui/App.js

@@ -18,6 +18,8 @@ import { accent } from "./theme.js";
 import { renderMarkdown } from "../md.js";
 import { clearTodos, currentTodos, onTodosChange } from "../tools/todo.js";
 import { onTurnPhase, turnPhase } from "../agent/phase.js";
+import { listJobs } from "../exec/jobs.js";
+import { ModelPicker } from "./model-picker.js";
 let _id = 0;
 const nid = () => ++_id;
 const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
@@ -267,14 +269,19 @@ function StatusRow({ working, todos, queued }) {
         const id = setInterval(() => setFrame((x) => x + 1), SPINNER_FRAME_MS);
         return () => clearInterval(id);
     }, [working]);
+    // Background-job indicator — so the user can SEE what's running in the background (a preview server, a
+    // watcher) without asking. Live while working (spinner ticks re-render); best-effort at idle (/jobs is
+    // the authoritative on-demand view). Re-read each render.
+    const bg = listJobs().filter((j) => j.status === "running").length;
+    const bgTag = bg ? ` · ⚙ ${bg} bg (/jobs)` : "";
     if (!working) {
-        return (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `  ${IDLE_HINTS}` }) }));
+        return (_jsx(Box, { marginTop: 1, children: _jsx(Text, { dimColor: true, children: `  ${IDLE_HINTS}${bgTag}` }) }));
     }
     const frames = "⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏";
     const elapsedSec = Math.floor((Date.now() - startRef.current) / 1000);
     // Pre-first-token honesty (codex-parity): "waiting for the model" reads very differently from a
     // generic "working" when the network is slow — the user knows the request is out, not dead.
-    const verb = phase === "waiting" ? `waiting for the model… ${elapsedSec}s · esc to interrupt` : spinnerVerb(todos, elapsedSec);
+    const verb = (phase === "waiting" ? `waiting for the model… ${elapsedSec}s · esc to interrupt` : spinnerVerb(todos, elapsedSec)) + bgTag;
     return (_jsxs(Box, { marginTop: 1, children: [_jsx(Text, { color: "yellow", children: frames[frame % frames.length] }), _jsx(Text, { dimColor: true, children: ` ${verb} · ⏎ queues${queued ? ` (${queued})` : ""}` })] }));
 }
 // Short per-mode descriptions for the ONE-ROW mode line (the old two-row ModeBar's long sentences
@@ -344,6 +351,7 @@ export function App({ initialStatus, model, cwd, header, onSubmit, cycleApproval
     const [askText, setAskText] = useState(null);
     const [reasoningOpen, setReasoningOpen] = useState(false);
     const [showTranscript, setShowTranscript] = useState(false); // Ctrl+T full-transcript overlay
+    const [picker, setPicker] = useState(null); // /model picker overlay
     const [modeSelector, setModeSelector] = useState(false); // transient approval selector: shift+tab pops it, auto-hides
     const modeSelectorTimerRef = useRef(null);
     // Live checklist mirror: TodoPanel reads this, and `Working` derives its spinner verb from the
@@ -515,13 +523,14 @@ export function App({ initialStatus, model, cwd, header, onSubmit, cycleApproval
             return askTextFn(question);
         };
         const setApprovalFn = (m) => setStatus((s) => ({ ...s, approval: m }));
+        const pickModelFn = (o) => new Promise((resolve) => setPicker({ ...o, resolve }));
         // Enter the conversation flow INSTANTLY: yield one macrotask so ink paints the committed message +
         // cleared input + spinner BEFORE the turn's synchronous prep runs (reading @-files, base64-encoding
         // images) and before the model's slow first token. Without this, that sync prep blocks ink's flush,
         // so pressing Enter leaves the message stuck in the input box for seconds ("回车一直不动"). One tick.
         await new Promise((resolve) => setTimeout(resolve, 0));
         try {
-            await onSubmit(t, { sink, confirm: confirmFn, select: selectFn, ask: askFn, setApproval: setApprovalFn, signal: ctrl.signal, exit, approval: statusRef.current.approval, drainQueue }, images);
+            await onSubmit(t, { sink, confirm: confirmFn, select: selectFn, ask: askFn, pickModel: pickModelFn, setApproval: setApprovalFn, signal: ctrl.signal, exit, approval: statusRef.current.approval, drainQueue }, images);
         }
         catch (e) {
             pushCurrent("notice", `error: ${e instanceof Error ? e.message : String(e)}`);
@@ -563,6 +572,8 @@ export function App({ initialStatus, model, cwd, header, onSubmit, cycleApproval
             return setShowTranscript((x) => !x); // open/close the full-transcript overlay
         if (showTranscript)
             return; // while open, the overlay's own useInput owns every key (scroll / esc)
+        if (picker)
+            return; // the /model picker overlay owns input (↑↓ model, ←→ thinking, ⏎, esc) while open
         // Free-text question awaiting an answer: Esc cancels (empty answer); all other keys belong to the InputBox.
         if (askText) {
             if (key.escape) {
@@ -624,5 +635,13 @@ export function App({ initialStatus, model, cwd, header, onSubmit, cycleApproval
     });
     if (showTranscript)
         return _jsx(Transcript, { items: [...history, ...current], onClose: () => setShowTranscript(false) });
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: header ? [{ id: -1, kind: "notice", text: "" }, ...history] : history, children: (item) => (item.id === -1 ? _jsx(HeaderCard, { ...header }, "hdr") : _jsx(Block, { item: item }, item.id)) }), current.map((item) => (_jsx(Block, { item: item, open: reasoningOpen, liveRows: liveRows }, item.id))), _jsx(TodoPanel, { todos: todos }), prompt && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: `  ${stripAnsi(prompt.title)}` }), prompt.options.map((o, i) => (_jsx(Text, { color: i === promptSel ? "cyan" : undefined, bold: i === promptSel, children: (i === promptSel ? " ❯ " : "   ") + `${i + 1}. ` + o.label }, i))), _jsx(Text, { dimColor: true, children: `   ↑↓ or 1–${prompt.options.length} to choose · Enter · Esc cancels` })] })), askText && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: `  ? ${stripAnsi(askText.title)}` }), _jsx(Text, { dimColor: true, children: "   type your answer below · Enter to send · Esc cancels" })] })), pool.length > 0 && !prompt && !askText && (_jsx(Box, { flexDirection: "column", children: pool.map((l, i) => (_jsx(Text, { color: accent(), children: `  › ${l.length > 72 ? l.slice(0, 72) + "…" : l}` }, i))) })), modeSelector ? _jsx(ModeLine, { approval: status.approval }) : _jsx(StatusRow, { working: working, todos: todos, queued: pool.length }), _jsx(InputBox, { status: status, cwd: cwd, model: model, route: header?.routeHost, isActive: !prompt, vim: vim, onSubmit: handleSubmit, onClipboardImage: onClipboardImage })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Static, { items: header ? [{ id: -1, kind: "notice", text: "" }, ...history] : history, children: (item) => (item.id === -1 ? _jsx(HeaderCard, { ...header }, "hdr") : _jsx(Block, { item: item }, item.id)) }), current.map((item) => (_jsx(Block, { item: item, open: reasoningOpen, liveRows: liveRows }, item.id))), _jsx(TodoPanel, { todos: todos }), picker && (_jsx(ModelPicker, { models: picker.models, style: picker.style, current: picker.current, effort: picker.effort, onSelect: (model, effort) => {
+                    const r = picker.resolve;
+                    setPicker(null);
+                    r({ model, effort });
+                }, onCancel: () => {
+                    const r = picker.resolve;
+                    setPicker(null);
+                    r(null);
+                } })), prompt && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: `  ${stripAnsi(prompt.title)}` }), prompt.options.map((o, i) => (_jsx(Text, { color: i === promptSel ? "cyan" : undefined, bold: i === promptSel, children: (i === promptSel ? " ❯ " : "   ") + `${i + 1}. ` + o.label }, i))), _jsx(Text, { dimColor: true, children: `   ↑↓ or 1–${prompt.options.length} to choose · Enter · Esc cancels` })] })), askText && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: `  ? ${stripAnsi(askText.title)}` }), _jsx(Text, { dimColor: true, children: "   type your answer below · Enter to send · Esc cancels" })] })), pool.length > 0 && !prompt && !askText && (_jsx(Box, { flexDirection: "column", children: pool.map((l, i) => (_jsx(Text, { color: accent(), children: `  › ${l.length > 72 ? l.slice(0, 72) + "…" : l}` }, i))) })), modeSelector ? _jsx(ModeLine, { approval: status.approval }) : _jsx(StatusRow, { working: working, todos: todos, queued: pool.length }), _jsx(InputBox, { status: status, cwd: cwd, model: model, route: header?.routeHost, isActive: !prompt, vim: vim, onSubmit: handleSubmit, onClipboardImage: onClipboardImage })] }));
 }

package/dist/tui/model-picker.js

@@ -0,0 +1,62 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The /model picker: ↑↓ choose a model (from the key's live /models list), ←→ set the thinking level for
+// this endpoint, ⏎ apply, esc cancel. Built on the provider registry — the reasoning STYLE (from the
+// endpoint) decides which levels ←→ offers. The nav math is pure + exported for tests; the component is a
+// thin ink shell over it (like the Transcript overlay).
+import { Box, Text, useInput } from "ink";
+import { useState } from "react";
+/** The levels ←→ cycles for a style. Binary thinking toggles (DashScope enable_thinking, Ollama think)
+ *  show off/on; graded styles (OpenAI/Anthropic effort/budget) show the full dial; `none` → no control. */
+export function levelsFor(style) {
+    if (style === "none")
+        return [];
+    if (style === "enable_thinking" || style === "ollama_think")
+        return ["off", "high"]; // "high" renders as "on"
+    return ["off", "low", "medium", "high"];
+}
+/** Label a level for display — binary styles read as on/off, graded ones as the level name. */
+export function levelLabel(style, e) {
+    if (style === "enable_thinking" || style === "ollama_think")
+        return e === "off" ? "off" : "on";
+    return String(e);
+}
+/** Pure navigation: ↑↓ moves through models (wrapping); ←→ cycles the thinking level for the endpoint's
+ *  style. No-ops when there are no models / the style has no levels. Exported for tests. */
+export function movePicker(s, key, modelCount, style) {
+    if (key === "up" || key === "down") {
+        if (modelCount <= 0)
+            return s;
+        const d = key === "down" ? 1 : -1;
+        return { ...s, modelIdx: (s.modelIdx + d + modelCount) % modelCount };
+    }
+    const levels = levelsFor(style);
+    if (!levels.length)
+        return s;
+    const cur = Math.max(0, levels.indexOf(s.effort));
+    const d = key === "right" ? 1 : -1;
+    return { ...s, effort: levels[(cur + d + levels.length) % levels.length] };
+}
+export function ModelPicker({ models, style, current, effort, onSelect, onCancel, }) {
+    const start = Math.max(0, models.indexOf(current ?? ""));
+    const [s, setS] = useState({ modelIdx: start, effort });
+    useInput((_input, key) => {
+        if (key.escape)
+            return onCancel();
+        if (key.return)
+            return onSelect(models[s.modelIdx] ?? current ?? "", s.effort);
+        if (key.upArrow)
+            setS((p) => movePicker(p, "up", models.length, style));
+        else if (key.downArrow)
+            setS((p) => movePicker(p, "down", models.length, style));
+        else if (key.leftArrow)
+            setS((p) => movePicker(p, "left", models.length, style));
+        else if (key.rightArrow)
+            setS((p) => movePicker(p, "right", models.length, style));
+    });
+    const hasLevels = levelsFor(style).length > 0;
+    const dial = hasLevels ? `thinking ◀ ${levelLabel(style, s.effort)} ▶` : "";
+    return (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: "yellow", children: `  pick a model  ·  ↑↓ model  ·  ${hasLevels ? "←→ thinking  ·  " : ""}⏎ apply  ·  esc` }), models.length === 0 ? (_jsx(Text, { dimColor: true, children: "   (this endpoint doesn't list models — use /model <id> to set one directly)" })) : (models.map((m, i) => {
+                const on = i === s.modelIdx;
+                return (_jsxs(Box, { children: [_jsx(Text, { color: on ? "cyan" : undefined, bold: on, children: (on ? " ❯ " : "   ") + m }), on && hasLevels ? _jsx(Text, { dimColor: true, children: "   " + dial }) : null] }, m));
+            }))] }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nanhara/hara",
-  "version": "0.110.0",
+  "version": "0.112.0",
   "description": "hara — a coding agent CLI that runs like an engineering org.",
   "bin": {
     "hara": "dist/index.js"