viber-channel 0.8.25 → 0.8.28

package/lib/capabilities.ts

@@ -44,40 +44,70 @@ export function capabilitiesText(channelVersion: string | null = null): string {
 		"  viber-gateway launch-team <template> --prefix <p> [--team <t>] [--env dev|staging]",
 		"                            [--cwd <dir>]",
 		"  → --env defaults to staging (the stable channel: agents register with no trust",
-		"    prompt; use it for working teams). --team defaults to the PREFIX (so dissolve",
-		"    --team <prefix> when you omitted it). Each agent is named <prefix>-<role>.",
-		"    Built-in template: dev-team (dev lead + 2 reviewers).",
+		"    prompt; use it for working teams). Built-in template: dev-team (dev lead + 2",
+		"    reviewers). NAMES: each agent is <prefix>-<role>, the team is --team, else the",
+		"    prefix. Example: template dev-team, --prefix i700 → agents i700-dev-lead,",
+		"    i700-review-opus, i700-review-codex, all in team \"i700\".",
+		"  ⚠ TRAP — --team DEFAULTS TO THE PREFIX. If you launch a child with a prefix that",
+		"    is (or collides with) YOUR OWN team name, the child JOINS YOUR TEAM, and a later",
+		"    `dissolve --team <that name>` stops and revokes EVERY other member of it (it",
+		"    skips only you, its caller). So: give the child a DISTINCT --team, and dissolve",
+		"    one agent with `dissolve --agent <launch-id>`, never --team on a shared team",
+		"    (it acts only on members launched from that registry). What must be unique is",
+		"    the full LABEL <prefix>-<role>: same label = same identity and lock (#293).",
+		"    E.g. w651-agent (prefix w651) may launch a role child with --prefix w651: label",
+		"    w651-child differs, so that is fine — but pass a distinct --team (w651-child).",
+		"WHICH \"dev-team\"? The name is resolved per path, not globally:",
+		"  launch-team → the entry of .viber/agent-teams.json with that name if any (it",
+		"  REPLACES the built-in entirely), else the built-in. The web (New team / Add agent)",
+		"  → the owner's database template of that name. Same name, possibly three rosters.",
+		"  When you copy a web template into agent-teams.json, give it a DISTINCT name.",
 		"  Output is verbose; only these lines matter:",
 		"    team: verdict COMPLETE|INCOMPLET — N member(s)",
-		"    member <launch-id>: <outcome>   one per agent; launched = success, keep the id",
-		"                                    for dissolve --agent. Anything else (existing,",
-		"                                    unknown, no-outcome-published): read the counts",
+		"    member <agent-name>: launch <launch-id> — spec … (<runtime>)",
+		"                          printed first: maps each agent NAME to its launch-id",
+		"    member <launch-id>: <outcome>",
+		"                          printed after: launched = success; anything else",
+		"                          (existing, unknown, no-outcome-published): read the counts",
 		"    INCOMPLET: read missing / mayHaveTree / treeUnknown — mayHaveTree means a process",
 		"    tree may exist anyway: dissolve it before relaunching.",
 		"    team: REFUSED before anything was created — <why> (nothing was launched)",
+		"  Keep the launch-id: it is what `dissolve --agent` takes — format",
+		"  launch-<32 hex> (e.g. launch-03f927dc283f94f521b06ee573a9f582); from Viber app",
+		"  0.7.22 on, the bare 32 hex is accepted too (older: pass the launch- prefix);",
+		"  read it on the \"member launch-…: launched\" line.",
 		"  ONLINE DELAY: up to ~45 s after the agent has started, plus the runtime boot",
 		"  (runner beat every 30 s + coverage re-read every 15 s). An empty list_agents right",
-		"  after launching is NOT a failure: wait and list again.",
-		"ONE AGENT ALONE = a one-role team. launch-team has no --name and there is no solo",
-		"shortcut: add a one-role template to .viber/agent-teams.json once (merged with the",
+		"  after launching is NOT a failure. Wait simply: call list_agents with",
+		"  label_prefix \"<prefix>-\" and online: true every ~10 s, for at most ~60 s; past",
+		"  that, check that the Viber app is running.",
+		"ONE AGENT ALONE = a one-role team. KNOWN LIMIT: launch-team has no --name and no solo",
+		"shortcut: add a one-role template to .viber/agent-teams.json (merged with the",
 		"built-ins; an entry with a built-in's name REPLACES it entirely), then launch it:",
 		"  {\"teams\":{\"solo\":{\"roles\":[{\"role\":\"dev\",\"runtime\":\"claude\",",
 		"   \"permission\":\"read-write\",\"rolePrompt\":\"You are the dev of {prefix}.\"}]}}}",
-		"  viber-gateway launch-team solo --prefix g1     → agent \"g1-dev\", team \"g1\"",
+		"  viber-gateway launch-team solo --prefix g1 --team g1-solo",
+		"                                   → agent \"g1-dev\", team \"g1-solo\"",
 		"  runtime: claude|codex|gemma · permission: read-only|read-write (gemma: read-only",
 		"  only; all roles of one template must share one permission) · count optional;",
 		"  model: leave it OUT (runtime default) UNLESS the owner explicitly asks for one.",
+		"  CLEAN UP: .viber/agent-teams.json is SHARED by everyone launching from that",
+		"  folder — once launched, remove the entry you added (the running agent does not",
+		"  need it; only a new launch-team would).",
 		"  (On the web, sidebar ⋯ → Add agent launches ONE named agent without a template edit.)",
 		"",
 		"DISSOLVE (stops the processes, then revokes the proven-stopped instances):",
 		"  viber-gateway dissolve --team <t> | --agent <launch-id>  --dir <registry>",
 		"                         [--auth <auth.json>] [--base-url <url>]",
 		"  --dir is REQUIRED, no default (exit 2 without it; refused under %TEMP%). For agents",
-		"  launched by the app or launch-team, pass it in full (PowerShell):",
-		"    --dir \"$env:LOCALAPPDATA\\Viber\\.viber\\gateway-registry\"",
+		"  launched by the app or launch-team, pass it in full:",
+		"    PowerShell:  --dir \"$env:LOCALAPPDATA\\Viber\\.viber\\gateway-registry\"",
+		"    bash:        --dir \"$LOCALAPPDATA/Viber/.viber/gateway-registry\"",
 		"  (the app home is %LOCALAPPDATA%\\Viber unless VIBER_APP_HOME is set).",
 		"  --auth defaults to VIBER_AUTH_FILE, else .viber/auth.json; --base-url to",
 		"  VIBER_BASE_URL, else https://viber.dgypx.dev (the stable backend) — in dev pass both.",
+		"  An id matching no record prints \"no record <id>\" and EXITS 2: nothing",
+		"  was dissolved. Read the exit code directly, never through a pipe (| tail gives 0).",
 		"  It never kills its caller. LIMIT: an agent already dead whose stop it cannot prove",
 		"  is reported \"stop NOT proven, not revoked\" — revoke it from the web sidebar instead.",
 		"",
@@ -93,6 +123,10 @@ export function capabilitiesText(channelVersion: string | null = null): string {
 		"relaunch the label repeats and the old id is dead) + message_agent.",
 		"ORCHESTRATOR (#307): only the OWNER can mark an instance orchestrator (web project",
 		"page). Then list_agents/message_agent cover ALL the owner's projects.",
+		"AM I ORCHESTRATOR? Call team_templates with action list: a list means yes; a 403",
+		"means no, and its detail says why — flag not set (ask the owner to turn it on) or",
+		"\"this agent is closed\" (the flag will not help). Do not retry. With the flag, list_agents",
+		"entries also carry a `project` field.",
 		"",
 		"TEAM TEMPLATES (team_templates tool, orchestrator only; 403 otherwise, do not retry):",
 		"acts on ALL the owner's templates, across every project — only on the owner's",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "viber-channel",
-  "version": "0.8.25",
+  "version": "0.8.28",
   "description": "Voice + text MCP channel between a Claude Code session and the Viber UI (https://viber.dgypx.dev). Push transcripts to Claude; send_message tool delivers text back to the UI.",
   "type": "module",
   "bin": {