@kenkaiiii/ggcoder 5.11.0 → 5.12.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";
@@ -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;
@@ -1039,6 +1045,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 +2144,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,
                                 };