@kenkaiiii/ggcoder 5.11.0 → 5.13.0

package/README.md

@@ -150,23 +150,36 @@ Plus built-in workflows that ship with the binary:
 
 GG Coder comes with a focused set of tools. Each one is small, well-described, and earns its place in the prompt.
 
-| Tool | What it does |
-|---|---|
-| `bash` | Run shell commands |
-| `read` | Read file contents |
-| `write` | Write files |
-| `edit` | Surgical string replacements |
-| `grep` | Search file contents (regex) |
-| `find` | Find files by glob pattern |
-| `ls` | List directory contents |
-| `web_fetch` | Fetch URL content |
-| `screenshot` | Open a URL / dev server in a headless browser and capture a PNG so the agent can see the rendered page |
-| `subagent` | Spawn parallel sub-agents |
+| Tool                              | What it does                                                                                           |
+| --------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `bash`                            | Run shell commands                                                                                     |
+| `read`                            | Read file contents                                                                                     |
+| `write`                           | Write files                                                                                            |
+| `edit`                            | Surgical string replacements                                                                           |
+| `grep`                            | Search file contents (regex)                                                                           |
+| `find`                            | Find files by glob pattern                                                                             |
+| `ls`                              | List directory contents                                                                                |
+| `web_fetch`                       | Fetch URL content                                                                                      |
+| `screenshot`                      | Open a URL / dev server in a headless browser and capture a PNG so the agent can see the rendered page |
+| `subagent`                        | Run one blocking, isolated child task (backward-compatible)                                            |
+| `spawn_agent` / `wait_agent`      | Launch persistent child turns concurrently and collect results                                         |
+| `send_message` / `followup_task`  | Steer a running child or reuse an idle child's context                                                 |
+| `list_agents` / `interrupt_agent` | Inspect or interrupt persistent children                                                               |
 
 The `screenshot` tool needs the optional `playwright` dependency plus a one-time `npx playwright install chromium`. Without it the tool returns an install hint instead of failing the turn. Captured images render inline in graphics-capable terminals (kitty, Ghostty, WezTerm, iTerm2); other terminals show a text line.
 
 Plus the [Grep MCP](https://grep.dev) for searching across 1M+ public GitHub repos. Add your own MCPs in settings if you need more — but start lean.
 
+### Async subagent lifecycle
+
+`subagent` remains blocking. The async suite launches persistent NDJSON worker processes, so a parent can start up to four active child turns, keep working, steer them, and wait for any or all results. Up to eight idle workers remain available for follow-up; bounded snapshots retain the latest 20 agents.
+
+Only GPT-5.6 Sol/Terra at **Ultra** delegates proactively. Lower Sol/Terra levels use async agents only when the user or project/skill instructions request delegation; other models receive no proactive policy.
+
+Children share the parent working directory, not isolated worktrees. Parallel writes must target disjoint files or subsystems. Async fan-out is one level deep, child output is bounded, idle workers reap after 10 minutes, and workers are not resumable after a CLI/app restart.
+
+Parent cancellation interrupts active children. Session disposal shuts down every worker process alongside background commands, LSP servers, and MCP connections.
+
 ---
 
 ## 🪄 Custom commands

package/dist/app-sidecar.js

@@ -20,6 +20,7 @@ import { randomUUID } from "node:crypto";
 import { parseArgs } from "node:util";
 import { formatError } from "@kenkaiiii/gg-ai";
 import { runJsonMode } from "./modes/json-mode.js";
+import { runSubagentWorkerMode } from "./modes/subagent-worker-mode.js";
 import { AgentSession } from "./core/agent-session.js";
 import { buildKenSystemPrompt, buildKenAutopilotSystemPrompt } from "./core/ken-prompt.js";
 import { buildKenDigest, buildKenAutopilotContext, buildKenAutopilotPlanContext, } from "./core/ken-context.js";
@@ -46,7 +47,7 @@ import { loadCustomCommands } from "./core/custom-commands.js";
 import { discoverProjects, listRecentSessions } from "./core/project-discovery.js";
 import { loadTasksSync, saveTasksSync, pruneDoneTasksSync, getNextPendingTask, markTaskInProgress, } from "./core/tasks-store.js";
 import { initLogger, log } from "./core/logger.js";
-import { RADIO_STATIONS, getCurrentStation, playRadio, stopRadio } from "./core/radio.js";
+import { RADIO_STATIONS, getCurrentStation, getRadioVolume, playRadio, setRadioVolume, stopRadio, } from "./core/radio.js";
 import { enrichProcessPath } from "./core/shell-path.js";
 import { downscaleForPreview, validateVisionImage } from "./utils/image.js";
 import { startServeMode } from "./modes/serve-mode.js";
@@ -457,6 +458,11 @@ function daemonJson(res, status, body) {
     res.end(JSON.stringify(body));
 }
 async function main() {
+    // Hidden persistent-worker dispatch must win before strict JSON/server parsing.
+    if (process.argv.includes("--subagent-worker")) {
+        await runSubagentWorkerMode();
+        return;
+    }
     // Sub-agent JSON-mode dispatch must win before any sidecar/server setup.
     if (await runJsonModeIfRequested())
         return;
@@ -681,16 +687,40 @@ async function main() {
         process.stdout.write(`GG_APP_LISTENING ${addr.port}\n`);
         log("INFO", "app-sidecar", "daemon listening", { port: String(addr.port), host });
     });
-    const shutdown = async () => {
+    const shellPid = process.ppid;
+    let shuttingDown = false;
+    async function shutdown() {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        clearInterval(parentWatch);
         // Radio playback is app-wide (one stream across all windows), so it stops
         // at the daemon level, not per session.
         stopRadio();
         await Promise.all([...sessions.values()].map((c) => c.dispose().catch(() => { })));
         server.close();
         process.exit(0);
-    };
+    }
     process.on("SIGINT", () => void shutdown());
     process.on("SIGTERM", () => void shutdown());
+    process.once("exit", stopRadio);
+    // Tauri can disappear without delivering a signal (force-quit, dev runner
+    // teardown, crash). Detect reparenting or a dead shell so the daemon and its
+    // radio player do not survive as audible orphans.
+    const parentWatch = setInterval(() => {
+        let parentAlive = process.ppid === shellPid;
+        if (parentAlive && shellPid > 1) {
+            try {
+                process.kill(shellPid, 0);
+            }
+            catch (error) {
+                parentAlive = error.code === "EPERM";
+            }
+        }
+        if (!parentAlive)
+            void shutdown();
+    }, 1_000);
+    parentWatch.unref?.();
 }
 /** Ken's read-only tool allow-list. Excludes every mutating tool (write/edit/
  *  bash/tasks/subagent/generate_image/enter_plan/exit_plan/task_*) so the mentor
@@ -1039,6 +1069,7 @@ async function createSession(deps, opts) {
     });
     session.eventBus.on("model_change", (d) => broadcast("model_change", d));
     session.eventBus.on("hook", (d) => broadcast("hook", d));
+    session.eventBus.on("subagent_state", (d) => broadcast("subagent_state", d));
     session.eventBus.on("compaction_start", (d) => broadcast("compaction_start", d));
     session.eventBus.on("compaction_end", (d) => broadcast("compaction_end", d));
     let running = false;
@@ -2137,12 +2168,17 @@ async function createSession(deps, opts) {
                     }
                     // Assistant tool_call blocks: detect sub-agent delegations.
                     if (msg.role === "assistant" && typeof msg.content !== "string") {
-                        const subagentCalls = msg.content.filter((c) => c.type === "tool_call" && c.name === "subagent");
+                        const subagentCalls = msg.content.filter((c) => c.type === "tool_call" && (c.name === "subagent" || c.name === "spawn_agent"));
                         if (subagentCalls.length > 0) {
                             const agents = subagentCalls.map((c) => {
                                 const result = toolResultMap.get(c.id);
                                 return {
-                                    agentName: typeof c.args?.agent === "string" ? c.args.agent : undefined,
+                                    agentName: c.name === "spawn_agent" && typeof c.args?.task_name === "string"
+                                        ? c.args.task_name
+                                        : typeof c.args?.agent === "string"
+                                            ? c.args.agent
+                                            : undefined,
+                                    // Async workers are intentionally non-resumable; restored rows are historical.
                                     status: result?.isError ? "error" : "done",
                                     toolUseCount: 0,
                                 };
@@ -2427,7 +2463,34 @@ async function createSession(deps, opts) {
         // duplicate audio across windows (the original per-window goal), now for
         // free. (To restore per-window radio, key playback by sessionId.)
         if (method === "GET" && url === "/radio") {
-            json(res, 200, { stations: RADIO_STATIONS, current: getCurrentStation() });
+            json(res, 200, {
+                stations: RADIO_STATIONS,
+                current: getCurrentStation(),
+                volume: getRadioVolume(),
+            });
+            return;
+        }
+        if (method === "POST" && url === "/radio/volume") {
+            void readBody(req).then((raw) => {
+                let volume;
+                try {
+                    volume = Number(JSON.parse(raw).volume);
+                }
+                catch {
+                    json(res, 400, { error: "invalid JSON body" });
+                    return;
+                }
+                if (!Number.isFinite(volume)) {
+                    json(res, 400, { error: "volume must be a number" });
+                    return;
+                }
+                const result = setRadioVolume(volume);
+                if (!result.ok) {
+                    json(res, 400, { error: result.error ?? "Radio volume failed to update." });
+                    return;
+                }
+                json(res, 200, { current: getCurrentStation(), volume: getRadioVolume() });
+            });
             return;
         }
         if (method === "POST" && url === "/radio") {