@team-agent/installer 0.5.73 → 0.5.74

package/crates/team-agent/src/tmux_backend.rs

@@ -378,6 +378,63 @@ impl TmuxBackend {
         self.run_ok(&argv)
     }
 
+    /// Set the pane-instance nonce only when the pane option is unset. tmux
+    /// serializes commands at the server, so concurrent first claims have one
+    /// winner; losers read back that winner instead of persisting a stale nonce.
+    pub(crate) fn set_pane_binding_nonce_if_unset(
+        &self,
+        pane: &PaneId,
+        nonce: &str,
+    ) -> Result<String, TransportError> {
+        let argv = self.tmux_argv(&[
+            "tmux".to_string(),
+            "set-option".to_string(),
+            "-p".to_string(),
+            "-o".to_string(),
+            "-t".to_string(),
+            pane.as_str().to_string(),
+            TMUX_PANE_BINDING_NONCE_OPTION.to_string(),
+            nonce.to_string(),
+        ]);
+        let output = self.runner.run(&argv)?;
+        if output.success {
+            return Ok(nonce.to_string());
+        }
+        if output
+            .stderr
+            .to_ascii_lowercase()
+            .contains("already set")
+        {
+            return self.read_pane_binding_nonce(pane);
+        }
+        Err(subprocess_error(argv, output))
+    }
+
+    fn read_pane_binding_nonce(&self, pane: &PaneId) -> Result<String, TransportError> {
+        let argv = self.tmux_argv(&[
+            "tmux".to_string(),
+            "show-options".to_string(),
+            "-p".to_string(),
+            "-v".to_string(),
+            "-t".to_string(),
+            pane.as_str().to_string(),
+            TMUX_PANE_BINDING_NONCE_OPTION.to_string(),
+        ]);
+        let output = self.runner.run(&argv)?;
+        if !output.success {
+            return Err(subprocess_error(argv, output));
+        }
+        let nonce = output.stdout.trim();
+        if nonce.is_empty() {
+            return Err(TransportError::Subprocess {
+                argv,
+                code: output.code,
+                stderr: "pane binding nonce remained unset after conditional write".to_string(),
+            });
+        }
+        Ok(nonce.to_string())
+    }
+
     /// Backend with an injected runner (tests: canned/recording tmux output). Shared default socket.
     /// ---
     /// purpose: 用注入的 runner 构造后端(测试用录制/罐装 tmux 输出),绑共享默认 socket

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-agent/installer",
-  "version": "0.5.73",
+  "version": "0.5.74",
   "description": "npx installer for Team Agent",
   "keywords": [
     "codex",
@@ -20,9 +20,9 @@
     "team-agent-installer": "npm/install.mjs"
   },
   "optionalDependencies": {
-    "@team-agent/cli-darwin-arm64": "0.5.73",
-    "@team-agent/cli-darwin-x64": "0.5.73",
-    "@team-agent/cli-linux-x64": "0.5.73"
+    "@team-agent/cli-darwin-arm64": "0.5.74",
+    "@team-agent/cli-darwin-x64": "0.5.74",
+    "@team-agent/cli-linux-x64": "0.5.74"
   },
   "scripts": {
     "postinstall": "node npm/bincheck.mjs",

package/skills/team-agent/SKILL.md

@@ -27,10 +27,13 @@ For a Pi worker, use this existing three-step flow:
 
 Pi roles preserve the direct Pi login, model defaults, extensions/plugins, skills, context, trust, and tools. Team Agent adds only per-seat identity/session isolation. `model` and `effort` are optional explicit pass-throughs. Use the shared role schema, a block-style `tools` list containing `mcp_team`, and the required boolean `dangerously_skip_permissions`.
 
+Pi tool contract: use only `mcp_team`, `fs_read`, `fs_list`, `fs_write`, and `execute_bash`. Do not copy `provider_builtin`, `git_diff`, or `network` from a generic Codex role; Pi cannot map those categories. `compile`/`validate` rejects unsupported Pi categories before quick-start persists runtime state.
+
 ## Operate
 
 - Send: `team-agent send TO MESSAGE` using an in-team short name or fully qualified `<workspace>::<team>/<agent>`; these are co-equal positional TO forms. For example, `team-agent send reviewer "..."` uses an in-team short name. Do not poll after success.
 - Inspect: `team-agent status` or `team-agent status --json`; `ok: true` with `ready: false` is not a crash.
+- `quick-start` / `restart` / `claim-leader` JSON is compact by default (`ok`, `status`/`reason`, next action, attach/send, and `readiness.all_workers_spawned`); pass `--detail` only for internal diagnostics.
 - On a structured failure with an `action`, run that action first, then stop. Never guess flags.
 - Never rewrite a user-supplied model id or read `.env` files.
 

package/skills/team-agent/command-coverage.json

@@ -67,6 +67,13 @@
       "owner": "runtime-owner:leader-channel",
       "plan": "Execute in a hermetic leader fixture and bind assertions to owner/receiver persistence or a precise zero-write refusal."
     },
+    {
+      "command": "team-agent claim-leader --detail",
+      "bucket": "declared_gap",
+      "covered": false,
+      "owner": "runtime-owner:leader-channel",
+      "plan": "Execute the exact argv and bind assertions to detail-only topology_convergence, owner_epoch, and checked_paths fields."
+    },
     {
       "command": "team-agent claude",
       "bucket": "declared_gap",
@@ -233,6 +240,13 @@
         }
       }
     },
+    {
+      "command": "team-agent quick-start --json --detail",
+      "bucket": "declared_gap",
+      "covered": false,
+      "owner": "runtime-owner:lifecycle",
+      "plan": "Execute the exact argv and bind assertions to detail-only receiver, topology, and coordinator diagnostics while keeping compact default JSON."
+    },
     {
       "command": "team-agent quick-start <dir>",
       "bucket": "covered",
@@ -308,6 +322,13 @@
       "owner": "runtime-owner:restart",
       "plan": "Execute a representative team selector and bind assertions to selected-team restart and sibling preservation."
     },
+    {
+      "command": "team-agent restart --json --detail",
+      "bucket": "declared_gap",
+      "covered": false,
+      "owner": "runtime-owner:restart",
+      "plan": "Execute the exact argv and bind assertions to detail-only coordinator diagnostics while keeping compact default JSON."
+    },
     {
       "command": "team-agent send --task task_initial \"Start\"",
       "bucket": "declared_gap",

package/skills/team-agent/references/team-agent-operator.md

@@ -96,6 +96,8 @@ EOF
 team-agent quick-start .team/current
 ```
 
+That copy-paste role is Codex-specific. Provider tool categories are not portable: Pi roles must contain `mcp_team` and may use only `fs_read`, `fs_list`, `fs_write`, and `execute_bash`; do not carry `provider_builtin`, `git_diff`, or `network` into a Pi role. `team-agent compile`/`validate` rejects an unsupported Pi category before quick-start persists runtime state, and the error names the category to remove.
+
 YAML lists must be block style. Use `tools:\n  - fs_read`; do not use `tools: [fs_read, mcp_team]`.
 
 Display choices (set `display_backend:` in `TEAM.md` to opt in):
@@ -122,9 +124,11 @@ team-agent claim-leader --help
 Observed (exit 0):
 
 ```text
-usage: team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json]
+usage: team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json] [--detail]
 ```
 
+Default JSON for `quick-start`, `restart`, and `claim-leader` is compact: `ok`, `status`/`reason`, next action, attach/send. `quick-start` keeps a short `readiness` object with `all_workers_spawned`. Pass `--detail` for internal receiver/topology/coordinator diagnostics.
+
 Run `claim-leader` only from the **leader** pane. From a worker pane it refuses and prints a structured `action` (see Failure Rules).
 
 ## Provider Capability Matrix
@@ -264,7 +268,7 @@ team-agent shutdown --help
 Observed (all exit 0):
 
 ```text
-usage: team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json]
+usage: team-agent restart [WORKSPACE] [--team TEAM] [--allow-fresh] [--session-converge-deadline SECONDS] [--json] [--detail]
 usage: team-agent add-agent AGENT --role-file FILE [--force] [--workspace WORKSPACE] [--team TEAM] [--no-display] [--json]
 usage: team-agent shutdown [--workspace WORKSPACE] [--team TEAM] [--keep-logs] [--json]
 ```
@@ -480,6 +484,7 @@ team-agent approvals <agent_id>
 team-agent approvals [coder]
 team-agent attach-leader
 team-agent claim-leader
+team-agent claim-leader --detail
 team-agent claude
 team-agent clone-agent <source> --as <new>
 team-agent codex
@@ -501,12 +506,14 @@ team-agent quick-start ./roles --team-id alpha
 team-agent quick-start .team/alpha
 team-agent quick-start .team/current
 team-agent quick-start <dir>
+team-agent quick-start --json --detail
 team-agent remove-agent <agent> --workspace . --confirm
 team-agent reset-agent <agent> --discard-session
 team-agent restart
 team-agent restart .
 team-agent restart . --allow-fresh
 team-agent restart . --team <session_name_or_team_name>
+team-agent restart --json --detail
 team-agent send --task task_initial "Start"
 team-agent send --watch-result
 team-agent send --watch-result coder "Do the bounded task"