@staix/agent-hub 0.7.0 → 0.7.1

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.7.1
+
+- Restore native sessions while unrelated agents remain in the same worktree; the coordinator continues to fence uncertain terminal creations (#48).
+- Allow a bounded inventory refresh after closing the captured terminal before reporting uncertain shutdown (#48).
+
 ## 0.7.0
 
 - Persist queued deliveries and expose uncertain handoffs for explicit operator reconciliation (#46).

package/README.md

@@ -4,7 +4,7 @@ Native multi-agent hub for one developer's machine: Claude Code, Codex, Kimi Cod
 hub-owned local-LLM worker collaborate as peers in independent project directories, with
 task-aware model routing (Switchyard) in front of a self-hosted gateway (OmniRoute).
 
-Status: 0.7.0, control protocol 10. Durable delivery records distinguish queued
+Status: 0.7.1, control protocol 10. Durable delivery records distinguish queued
 work from uncertain execution. The [smoke checklist](docs/smoke.md) records
 verified paths and remaining prerequisites.
 
@@ -28,7 +28,7 @@ cd <your project> && ahub init && ahub up && ahub tail
 Or install the same version from GitHub:
 
 ```bash
-bun add -g github:STAIxBWLB/agent-hub#v0.7.0 && ahub setup
+bun add -g github:STAIxBWLB/agent-hub#v0.7.1 && ahub setup
 ```
 
 The installed commands remain `ahub` and `agent-hub`.

package/docs/operations.md

@@ -1,6 +1,6 @@
 # Operations guide
 
-This guide describes ahub 0.7.0 and control protocol 10. Live verification
+This guide describes ahub 0.7.1 and control protocol 10. Live verification
 results and remaining prerequisites are recorded separately in [the smoke ledger](smoke.md).
 
 ## Install and start
@@ -146,31 +146,31 @@ uncertain.
 
 ## Upgrade and crash recovery
 
-For the first upgrade from 0.6.4 (protocol 9), use the new coordinator without
+For an upgrade from 0.6.4 (protocol 9) or 0.7.0, use the patched coordinator without
 replacing the global CLI prematurely. Run from the project directory:
 
 ```bash
-bunx --package @staix/agent-hub@0.7.0 ahub upgrade --to 0.7.0 --dry-run
-bunx --package @staix/agent-hub@0.7.0 ahub upgrade --to 0.7.0 --yes
+bunx --package @staix/agent-hub@0.7.1 ahub upgrade --to 0.7.1 --dry-run
+bunx --package @staix/agent-hub@0.7.1 ahub upgrade --to 0.7.1 --yes
 ```
 
 The coordinator verifies and retains the exact target package, preserves its
 own source, and promotes the global CLI only after restored projects pass
 readback. Do not use the old protocol-9 coordinator to target protocol 10.
 
-Once the installed CLI is 0.7.0, review the current project or all registered
+Once the installed CLI is 0.7.1, review the current project or all registered
 projects first:
 
 ```bash
 ahub restart --dry-run
-ahub upgrade --to 0.7.0 --dry-run
+ahub upgrade --to 0.7.1 --dry-run
 ```
 
 Apply only after reviewing the plan:
 
 ```bash
 ahub restart --yes
-ahub upgrade --to 0.7.0 --yes
+ahub upgrade --to 0.7.1 --yes
 ahub recovery status <operation-id>
 ahub recovery resume <operation-id>
 ahub recovery abort <operation-id>

package/docs/quickstart.md

@@ -17,7 +17,7 @@ ahub setup                                # installs the Claude Code channel plu
 Or use the matching GitHub release:
 
 ```bash
-bun add -g github:STAIxBWLB/agent-hub#v0.7.0
+bun add -g github:STAIxBWLB/agent-hub#v0.7.1
 ahub setup
 ```
 

package/docs/smoke.md

@@ -523,3 +523,23 @@ pause.
   with a correlated FYI. This does not establish a real Claude inference turn.
 - Production application, attended Claude restoration and post-deploy readback
   remain pending until the tagged artifact is installed. Issue #12 remains open.
+
+
+## 0.7.0 attended production cutover and follow-up
+
+The published 0.7.0 package passed integrity staging and completed protocol 9
+to 10 recovery in the production project. Task/budget state and queued Codex
+messages were retained. General status now displays the disconnected Codex
+recipient and its two pending messages.
+
+Attended recovery exposed #48: the pre-create terminal check treated unrelated
+Codex/Qwen terminals as an ambiguous earlier Claude creation. The original
+Claude conversation was manually reattached with the captured session identity,
+the native development-channel confirmation was accepted, and recovery resume
+verified the existing replacement without creating a duplicate. The operation
+reached `completed` with its project `verified`.
+
+0.7.1 removes the redundant worktree-wide create blocker while retaining the
+coordinator's pending-create fence and returned terminal/session verification.
+Regression tests include unrelated terminals and delayed close inventory.
+The 0.7.1 attended repeat is recorded separately after application.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staix/agent-hub",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   "license": "MIT",
   "type": "module",

package/plugins/agent-hub/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-hub",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Channel between Claude Code and the agent-hub daemon: peer messages from Codex, Kimi and the local worker arrive as channel events; hub_send replies.",
   "author": {
     "name": "Young Joon Lee",

package/plugins/agent-hub/server.js

@@ -15727,7 +15727,7 @@ class ControlClient {
 // package.json
 var package_default = {
   name: "@staix/agent-hub",
-  version: "0.7.0",
+  version: "0.7.1",
   description: "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   license: "MIT",
   type: "module",

package/src/cli/terminal-recovery.ts

@@ -543,10 +543,13 @@ export async function closeTerminal(binding: TerminalBinding, timeoutMs = 600_00
   try {
     await showBinding(binding, config);
     await run(config.runner, ["terminal", "close", "--terminal", binding.handle, "--json"]);
-    const afterClose = listTerminals(await run(config.runner, ["terminal", "list", "--json"]));
-    const stillThere = afterClose.some((terminal) => terminal.handle === binding.handle || terminal.incarnationId === binding.incarnationId);
-    if (stillThere) return closeFailure(binding, [blocker("ambiguous-create", `close of terminal ${binding.handle} was not confirmed`, binding.peer, binding.handle)]);
-    return { closed: true, manualRequired: false, binding, blockers: [] };
+    const deadline = Date.now() + 5000;
+    do {
+      const afterClose = listTerminals(await run(config.runner, ["terminal", "list", "--json"]));
+      if (!afterClose.some((terminal) => terminal.handle === binding.handle || terminal.incarnationId === binding.incarnationId)) return { closed: true, manualRequired: false, binding, blockers: [] };
+      await Bun.sleep(100);
+    } while (Date.now() < deadline);
+    return closeFailure(binding, [blocker("ambiguous-create", `close of terminal ${binding.handle} was not confirmed`, binding.peer, binding.handle)]);
   } catch (error) {
     return closeFailure(binding, [error instanceof OrcaCommandError ? error.blocker : blocker("command-error", String(error), binding.peer, binding.handle)]);
   }
@@ -557,36 +560,8 @@ export async function createTerminal(binding: TerminalBinding, options?: Command
   const config = normalizeOptions(options);
   try {
     const worktreeSelector = binding.worktreeId.startsWith("id:") ? binding.worktreeId : `id:${binding.worktreeId}`;
-    // A lost create reply is an uncertain effect. Before issuing another create,
-    // reconcile terminals already present in the captured worktree. An exact
-    // session match is safe to adopt; any other occupant requires an operator
-    // decision rather than risking a duplicate native session.
-    const existing = listTerminals(await run(config.runner, ["terminal", "list", "--json"])).filter((terminal) =>
-      rootMatches(terminal.worktreePath ?? terminal.projectRoot, binding.projectRoot) &&
-      nestedString(terminal, ["worktreeId"]) === binding.worktreeId,
-    );
-    if (existing.length > 0) {
-      const matches: TerminalBinding[] = [];
-      for (const listed of existing) {
-        const handle = nestedString(listed, ["handle"]);
-        if (!handle) continue;
-        try {
-          const shown = terminalObject(await run(config.runner, ["terminal", "show", "--terminal", handle, "--json"]));
-          if (identityFrom(shown) === binding.peer && sessionFrom(shown) === binding.sessionId) {
-            const incarnationId = nestedString(shown, ["incarnationId"]);
-            const worktreeId = nestedString(shown, ["worktreeId"]);
-            if (incarnationId && worktreeId) matches.push({ ...binding, handle, incarnationId, worktreeId });
-          }
-        } catch { /* An unreadable candidate remains an ambiguity below. */ }
-      }
-      if (matches.length === 1) {
-        const recovered = matches[0]!;
-        const idle = await waitForIdle(recovered, timeoutMs, config);
-        if (!idle.satisfied) return { created: false, ready: false, manualRequired: true, blockers: idle.blockers };
-        return { created: true, ready: true, manualRequired: false, binding: recovered, newBinding: recovered, blockers: [] };
-      }
-      return { created: false, ready: false, manualRequired: true, blockers: [blocker("ambiguous-create", `an existing terminal in worktree ${binding.worktreeId} may be the result of an earlier create; refusing another create`, binding.peer)] };
-    }
+    // The coordinator journals a pending creation before this call and reconciles
+    // it on resume. Other agents in the worktree do not imply a prior create.
     const value = await run(config.runner, ["terminal", "create", "--worktree", worktreeSelector, "--command", binding.launch.command, "--title", `${binding.peer} recovery`, "--json"]);
     let created = terminalObject(value);
     const createdHandle = nestedString(created, ["handle"]);