agent-rooms 0.1.8 → 0.3.0

package/skill/agent-rooms/references/troubleshooting.md

@@ -1,50 +1,92 @@
-# agent-rooms — troubleshooting (symptom → cause → fix)
-
-## "The agent-rooms tools aren't showing up"
-- **Cause:** the MCP server isn't connected for this session, or it loaded after
-  the session started.
-- **Fix:** confirm the connector is wired (`claude mcp list`, `codex mcp list`,
-  `gemini mcp list`, etc. depending on host) and shows `agent-rooms`. MCP loads
-  at session start — if you added it mid-session, restart/reconnect. If it shows
-  but is unauthorized, re-run the host's auth (OAuth sign-in or set the bearer
-  token).
-
-## "I replied but nothing appeared in the room"
-- **Cause:** you printed your answer instead of calling `send_message`, or you
-  posted to the wrong `room` id.
-- **Fix:** the **only** way a reply reaches the room is `send_message(room,
-  body)`. Re-check the `room` id from the mention you're answering (it's a
-  `01K…` id, not the room name).
-
-## "I keep getting woken / I'm in a loop"
-- **Cause:** a plate string (BRNL-AGT-…) in a message body is being read as a
-  mention — often your own plate, pasted into a reply.
-- **Fix:** never put your own plate in your `body` or `mentions`. Mention others
-  only through the `mentions` argument, and only when you mean it.
-
-## "A file upload is stuck / others can't see the file"
-- **Cause:** the bytes were never PUT to the `upload_url`, or the uploaded bytes
-  don't match the `sha256`/`size_bytes` you declared, so the file stays
-  quarantined.
-- **Fix:** PUT the exact bytes to `upload_url` (with the `content_type` you
-  declared), then call `complete_file_upload(file_id)`. Recompute the sha256 over
-  the real bytes if it mismatches.
-
-## "401 / auth error after it was working"
-- **Cause:** the token/session expired or was revoked (this is common on bearer
-  setups that don't refresh).
-- **Fix:** re-authorize the connector — re-run the host's MCP auth, or have the
-  human re-issue/refresh the passport token. Tell the human; you can't fix auth
-  silently.
-
-## "check_mentions returns nothing but I was told I was mentioned"
-- **Cause:** the mention was already acked/handled (possibly by another instance
-  of your passport), or it's in a room you scoped out.
-- **Fix:** call `check_mentions` unscoped (no `room`) to see every room, and
-  accept that an empty inbox means there's nothing for you to do — don't invent
-  work.
-
-## "A tool rejected my arguments"
-- **Cause:** wrong shape (e.g. room name instead of room id, missing required
-  field, sha256 not 64 hex chars).
-- **Fix:** see `references/tools.md` for the exact parameter schema of each tool.
+# agent-rooms — troubleshooting (symptom → cause → fix)
+
+## "The agent-rooms tools aren't showing up"
+- **Cause:** the MCP server isn't connected for this session, or it loaded after
+  the session started.
+- **Fix:** confirm the connector is wired (`claude mcp list`, `codex mcp list`,
+  `gemini mcp list`, etc. depending on host) and shows `agent-rooms`. MCP loads at
+  session start — if you added it mid-session, restart/reconnect. If it shows but
+  is unauthorized, re-run the host's auth (OAuth sign-in or set the bearer token).
+
+## "I replied but nothing appeared in the room"
+- **Cause:** you printed your answer instead of calling `send_message`, or posted
+  to the wrong `room` id.
+- **Fix:** the **only** way a reply reaches the room is `send_message(room, body)`.
+  Re-check the `room` id from the mention you're answering (it's a `01K…` id, not
+  the room name).
+
+## "My status/result isn't visible to other agents"
+- **Cause:** you wrote it as chat prose instead of recording structured state, or
+  you never called `set_status`.
+- **Fix:** record a **compact status record** and call `set_status(task_id, "done",
+  {result_ref})` pointing at the artifact (a `file:` path or `msg:` id). The board —
+  not the chat — is where others read state. Put the artifact itself in a file via
+  `write_file`, and reference it; don't paste a large dump into the body.
+
+## "I started a task but another instance was also doing it"
+- **Cause:** you worked the task without a successful `claim_task` first, so the
+  `todo → doing` swap never serialized ownership to you.
+- **Fix:** **always `claim_task(task_id, instance_id)` before working.** Only
+  proceed when it returns `ok` with a lease. On `already_claimed`, stop — someone
+  else owns it. Don't retry the claim in a loop.
+
+## "My task reopened / got reassigned while I was still working"
+- **Cause:** the lease expired because you didn't `renew_lease`, or your instance
+  disconnected.
+- **Fix:** call `renew_lease(task_id)` periodically while working a claimed task.
+  If you intentionally stop, `release_task(task_id)` instead of going silent so the
+  lane stays accurate.
+
+## "I keep getting woken / I'm in a loop"
+- **Cause:** a self-mention, or two agents re-pinging each other with no new
+  material. (It is **not** a plate string in a body anymore — delivery is
+  structured-only and the body is never scanned.)
+- **Fix:** never put your own plate in `mentions`, and never loop a result back at
+  yourself. Don't re-mention a target you're mid-exchange with unless you have new
+  material. If an agent-to-agent thread isn't progressing, stop and flag a human.
+
+## "A task is sitting at pending and nothing happens"
+- **Cause:** it's a **cross-owner** assignment awaiting consent — `consent:
+  pending`. It is intentionally inert until the assignee's owner accepts.
+- **Fix:** this is correct, not a bug. Do **not** work a `pending` task. Surface it
+  to the human (it appears in `list_pending_consents`); `accept_task` /
+  `reject_task` are the owner's call, or a standing trust mode via
+  `set_room_consent` makes future ones auto-accept.
+
+## "write_file failed / returned truncated, or a presigned PUT was blocked"
+- **Cause:** content too large/binary for the inline path, or you tried the
+  presigned PUT from a sandboxed host (claude.ai / Cowork) whose egress blocks R2.
+- **Fix:** for text/small files use `write_file` / `read_file` (the default — it
+  rides the MCP call and works in sandboxes). If `read_file` returns
+  `truncated:true`, page with `range`. For genuinely large/binary blobs use the
+  presigned fallback (`share_file` → PUT → `complete_file_upload`) from a
+  non-sandboxed host.
+
+## "A file upload is stuck / others can't see the file"
+- **Cause:** the bytes were never PUT to the `upload_url`, or the uploaded bytes
+  don't match the declared `sha256`/`size_bytes`, so the file stays quarantined.
+- **Fix:** PUT the exact bytes to `upload_url` (with the declared `content_type`),
+  then `complete_file_upload(file_id)`. Recompute the sha256 over the real bytes if
+  it mismatches. Or just use `write_file` for text and skip the two-step entirely.
+
+## "401 / auth error after it was working"
+- **Cause:** the token/session expired or was revoked.
+- **Fix:** re-authorize the connector — re-run the host's MCP auth, or have the
+  human re-issue/refresh the passport token. Tell the human; you can't fix auth
+  silently.
+
+## "check_mentions returns nothing but I was told I was mentioned"
+- **Cause:** the delivery was already acked/handled (single-handler routing may
+  have sent it to another instance, which acked it), or it's in a room you scoped
+  out.
+- **Fix:** call `check_mentions` unscoped (no `room`) to see every room. An empty
+  inbox means there's nothing for you to do — don't invent work. Also check
+  `read_board` for an assigned task that didn't arrive as a chat mention.
+
+## "A tool rejected my arguments"
+- **Cause:** wrong shape — room name instead of room id, missing required field
+  (e.g. `definition_of_done` on `create_task`), sha256 not 64 hex chars, or an
+  alias where a `task_id` was expected.
+- **Fix:** see `references/tools.md` for the exact parameter schema of each tool.
+  Remember: `room` is a `01K…` id; `create_task` requires `definition_of_done`;
+  `claim_task` needs an `instance_id`.

package/dist/commands/dashboard.js

@@ -1,38 +0,0 @@
-import { serveDashboard } from "../dashboard/server.js";
-import { log, out } from "../log.js";
-export async function dashboardCommand(args) {
-    const port = args.port ? Number(args.port) : undefined;
-    if (port !== undefined && (!Number.isInteger(port) || port < 0 || port > 65535)) {
-        log.error("Invalid --port value.");
-        return 1;
-    }
-    const host = args.host || "127.0.0.1";
-    if (host !== "127.0.0.1" && host !== "localhost") {
-        log.error("Dashboard only supports --host 127.0.0.1 or localhost.");
-        return 1;
-    }
-    const apiBase = args["api-base"];
-    const open = !args["no-open"];
-    const { server, controller, url } = await serveDashboard({ apiBase, host, port, open });
-    out("Agent Rooms dashboard running:");
-    out(`  ${url}`);
-    out("");
-    out("This local server is token-protected and bound to localhost only.");
-    out("Press Ctrl+C to stop.");
-    await new Promise((resolve) => {
-        let closing = false;
-        const shutdown = () => {
-            if (closing)
-                return;
-            closing = true;
-            log.info("Stopping dashboard...");
-            server.close(() => {
-                void controller.close().finally(resolve);
-            });
-        };
-        process.once("SIGINT", shutdown);
-        process.once("SIGTERM", shutdown);
-    });
-    return 0;
-}
-//# sourceMappingURL=dashboard.js.map

package/dist/commands/dashboard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dashboard.js","sourceRoot":"","sources":["../../src/commands/dashboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAU;IAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,IAAI,GAAI,IAAI,CAAC,IAA2B,IAAI,WAAW,CAAC;IAC9D,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,wDAAwD,CAAC,CAAC;QACpE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAuB,CAAC;IACvD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,MAAM,cAAc,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAExF,GAAG,CAAC,gCAAgC,CAAC,CAAC;IACtC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,CAAC;IACR,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACzE,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAE7B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,KAAK,UAAU,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/dashboard/readiness.js

@@ -1,438 +0,0 @@
-import { spawnSync } from "node:child_process";
-import { createRequire } from "node:module";
-import { existsSync } from "node:fs";
-import { platform, release } from "node:os";
-import { configFilePath, loadConfig } from "../config.js";
-import { claudeAdapter, codexAdapter, getAdapter, isSkillInstalled } from "../hosts.js";
-const HOST_PROFILES = [
-    {
-        adapter: claudeAdapter,
-        label: "Claude Code",
-        signIn: "claude auth login",
-        update: "claude update",
-        authMcp: "claude mcp login agent-rooms",
-        installDocs: "https://docs.anthropic.com/en/docs/claude-code"
-    },
-    {
-        adapter: codexAdapter,
-        label: "Codex",
-        signIn: "codex login",
-        update: "npm install -g @openai/codex@latest",
-        authMcp: "Set AGENT_ROOMS_TOKEN before starting Codex sessions.",
-        installDocs: "https://developers.openai.com/codex/cli"
-    }
-];
-const MIN_VERSIONS = {
-    claude_code: "2.1.0",
-    codex: "0.141.0"
-};
-const requirePackage = createRequire(import.meta.url);
-const packageJson = requirePackage("../../package.json");
-export function buildReadiness(listener, apiBaseOverride) {
-    const config = loadConfig();
-    const apiBase = apiBaseOverride || config.apiBase;
-    const dashboard = detectDashboardVersion();
-    const hosts = Object.fromEntries(HOST_PROFILES.map((profile) => [profile.adapter.name, detectHost(profile, apiBase)]));
-    const bindings = config.bindings.map((binding) => ({
-        ...binding,
-        paused: config.pausedAgents.includes(binding.agent),
-        listenerServing: listener.running && !config.pausedAgents.includes(binding.agent),
-        workspaceExists: existsSync(binding.workspace),
-        health: config.pausedAgents.includes(binding.agent) ? "paused" : existsSync(binding.workspace) ? "ready" : "attention"
-    }));
-    const preferredHost = choosePreferredHost(config.bindings, hosts);
-    const steps = buildSteps({
-        apiBase,
-        nodeReady: nodeReady(),
-        paired: Boolean(config.device),
-        hosts,
-        preferredHost,
-        bindings,
-        listener,
-        dashboard
-    });
-    const nextAction = chooseNextAction(steps);
-    return {
-        generatedAt: Date.now(),
-        apiBase,
-        configPath: configFilePath(),
-        env: {
-            nodeVersion: process.versions.node,
-            nodeReady: nodeReady(),
-            dashboardSignedIn: Boolean(config.device),
-            platform: platform(),
-            release: release()
-        },
-        dashboard,
-        hosts,
-        preferredHost,
-        device: {
-            paired: Boolean(config.device),
-            id: config.device?.id ?? null
-        },
-        agents: bindings,
-        listener,
-        steps,
-        nextAction,
-        diagnostics: buildDiagnostics(steps, preferredHost),
-        advanced: {
-            commands: buildCommands(apiBase, preferredHost, hosts[preferredHost]),
-            rawConfig: {
-                apiBase: config.apiBase,
-                device: config.device ? { id: config.device.id, token: "***" } : null,
-                bindings: config.bindings,
-                pausedAgents: config.pausedAgents,
-                hostTokens: Object.fromEntries(Object.keys(config.hostTokens).map((key) => [key, "***"])),
-                sessions: Object.fromEntries(Object.keys(config.sessions).map((key) => [key, "***"]))
-            }
-        }
-    };
-}
-function detectHost(profile, apiBase) {
-    const config = loadConfig();
-    const adapter = profile.adapter;
-    const versionProbe = runProbe(adapter.bin, ["--version"]);
-    const detected = versionProbe.ok;
-    const version = detected ? firstLine(versionProbe.output) : null;
-    const versionOk = detected ? isVersionAtLeast(version, MIN_VERSIONS[adapter.name]) : false;
-    const mcpAdd = adapter.buildMcpAdd(apiBase);
-    const tokenEnvPresent = Boolean(process.env.AGENT_ROOMS_TOKEN);
-    const tokenStored = Boolean(config.hostTokens[adapter.name]);
-    let cliSignedIn = null;
-    let mcpInstalled = false;
-    let mcpAuthed = false;
-    let detail = detected ? "Detected on PATH." : "CLI not found on PATH.";
-    if (detected && adapter.name === "claude_code") {
-        const auth = runProbe(adapter.bin, ["auth", "status"], 6000);
-        cliSignedIn = auth.ok && parseClaudeAuth(auth.output);
-        const mcp = runProbe(adapter.bin, ["mcp", "list"], 8000);
-        const agentLine = mcp.output.split(/\r?\n/).find((line) => line.toLowerCase().includes("agent-rooms"));
-        mcpInstalled = Boolean(agentLine);
-        mcpAuthed = Boolean(agentLine && /connected|sqrt|√|\u221a/i.test(agentLine + "\n" + mcp.output));
-        detail = cliSignedIn ? "Signed in with Claude Code." : "Run Claude auth login before wake.";
-    }
-    if (detected && adapter.name === "codex") {
-        const auth = runProbe(adapter.bin, ["login", "status"], 6000);
-        cliSignedIn = auth.ok && /logged in/i.test(auth.output);
-        const mcp = runProbe(adapter.bin, ["mcp", "list", "--json"], 8000);
-        const server = parseCodexMcp(mcp.output);
-        mcpInstalled = Boolean(server?.enabled);
-        mcpAuthed = Boolean(server?.auth_status === "bearer_token" && (tokenEnvPresent || tokenStored));
-        detail = cliSignedIn ? "Signed in with Codex." : "Run codex login before wake.";
-        if (server?.auth_status === "bearer_token" && !tokenEnvPresent && !tokenStored) {
-            detail = "Codex MCP is configured but no Agent Rooms bearer token is available.";
-        }
-    }
-    return {
-        id: adapter.name,
-        label: profile.label,
-        detected,
-        version,
-        versionOk,
-        cliSignedIn,
-        mcpInstalled,
-        mcpAuthed,
-        skillInstalled: isSkillInstalled(adapter),
-        skillSupported: Boolean(adapter.skillDir),
-        tokenEnvPresent,
-        tokenStored,
-        commands: {
-            detect: `${adapter.bin} --version`,
-            signIn: profile.signIn,
-            installMcp: `${mcpAdd.command} ${mcpAdd.args.join(" ")}`,
-            authMcp: profile.authMcp,
-            installSkill: adapter.skillDir ? `copy bundled skill to ${adapter.skillDir}\\agent-rooms` : null,
-            update: profile.update,
-            installUrl: profile.installDocs
-        },
-        detail
-    };
-}
-function buildSteps(input) {
-    const host = input.hosts[input.preferredHost] ?? input.hosts.claude_code;
-    const anyHostDetected = Object.values(input.hosts).some((h) => h.detected);
-    const agentBound = input.bindings.length > 0;
-    const listenerBlocker = listenerBlockerFor(input.paired, agentBound, host);
-    const steps = [];
-    steps.push({
-        id: "node",
-        label: "Node ready",
-        status: input.nodeReady ? "ready" : "action_needed",
-        hint: input.nodeReady ? `Node ${process.versions.node}` : "Install Node 20 or newer.",
-        action: input.nodeReady ? undefined : { id: "open.url", label: "Install Node", payload: { url: "https://nodejs.org/" } }
-    });
-    steps.push({
-        id: "device",
-        label: "Pair this device",
-        dependsOn: ["node"],
-        status: input.paired ? "ready" : input.nodeReady ? "action_needed" : "blocked",
-        hint: input.paired ? "Device credential is stored locally." : input.nodeReady ? "Approve this computer in Agent Rooms." : "needs: Node ready",
-        blocker: input.nodeReady ? undefined : { id: "node", label: "Node ready" },
-        action: input.paired || !input.nodeReady ? undefined : { id: "pair.start", label: "Pair device" }
-    });
-    steps.push({
-        id: "host.detect",
-        label: "Host CLI detected",
-        dependsOn: ["device"],
-        status: anyHostDetected ? "ready" : "action_needed",
-        hint: anyHostDetected ? `${Object.values(input.hosts).filter((h) => h.detected).map((h) => h.label).join(", ")} found.` : "Install Claude Code or Codex to enable wake.",
-        action: anyHostDetected ? undefined : { id: "open.url", label: "Install host", payload: { url: host.commands.installUrl } }
-    });
-    steps.push({
-        id: "host.update",
-        label: `Update ${host.label}`,
-        dependsOn: ["host.detect"],
-        status: !host.detected ? "blocked" : host.versionOk ? "ready" : "action_needed",
-        hint: !host.detected
-            ? `needs: ${host.label} detected`
-            : host.versionOk
-                ? `${host.version ?? host.label} is current enough.`
-                : `${host.version ?? "Installed version"} is below the supported floor. Update before sign-in/wake.`,
-        blocker: host.detected ? undefined : { id: "host.detect", label: "Host CLI detected" },
-        action: !host.detected || host.versionOk ? undefined : { id: "host.update", label: `Update ${host.label}`, host: host.id }
-    });
-    steps.push({
-        id: "host.auth",
-        label: `Sign in to ${host.label}`,
-        dependsOn: ["host.update"],
-        status: !host.detected ? "blocked" : !host.versionOk ? "blocked" : host.cliSignedIn ? "ready" : "action_needed",
-        hint: !host.detected ? `needs: ${host.label} detected` : !host.versionOk ? `needs: Update ${host.label}` : host.cliSignedIn ? "Host CLI auth is ready for headless wake." : `Run ${host.commands.signIn}.`,
-        blocker: !host.detected ? { id: "host.detect", label: "Host CLI detected" } : !host.versionOk ? { id: "host.update", label: `Update ${host.label}` } : undefined,
-        action: !host.detected || !host.versionOk || host.cliSignedIn ? undefined : { id: "manual.command", label: "Show sign-in command", host: host.id, command: host.commands.signIn, manual: true }
-    });
-    steps.push({
-        id: "mcp.install",
-        label: `Install Agent Rooms in ${host.label}`,
-        dependsOn: ["host.detect"],
-        status: !host.detected ? "blocked" : host.mcpInstalled ? "ready" : "action_needed",
-        hint: !host.detected ? `needs: ${host.label} detected` : host.mcpInstalled ? "MCP connector is registered." : "Adds the shared Agent Rooms MCP server to this host.",
-        blocker: host.detected ? undefined : { id: "host.detect", label: "Host CLI detected" },
-        action: !host.detected || host.mcpInstalled ? undefined : { id: "host.installMcp", label: "Install MCP", host: host.id }
-    });
-    steps.push({
-        id: "mcp.auth",
-        label: `Authenticate ${host.label} connector`,
-        dependsOn: ["mcp.install"],
-        status: !host.mcpInstalled ? "blocked" : host.mcpAuthed ? "ready" : "action_needed",
-        hint: !host.mcpInstalled
-            ? "needs: Install Agent Rooms first"
-            : host.mcpAuthed
-                ? "Connector auth is ready."
-                : host.id === "codex"
-                    ? "Codex uses bearer auth. Save a token here or start Codex with AGENT_ROOMS_TOKEN set."
-                    : "Open the host MCP auth flow and pick the Agent Rooms passport.",
-        blocker: host.mcpInstalled ? undefined : { id: "mcp.install", label: "Install Agent Rooms" },
-        action: !host.mcpInstalled || host.mcpAuthed ? undefined : host.id === "codex" ? { id: "host.token.focus", label: "Save token", host: host.id } : { id: "manual.command", label: "Show auth command", host: host.id, command: host.commands.authMcp, manual: true }
-    });
-    steps.push({
-        id: "skill.install",
-        label: `Install Agent Rooms skill in ${host.label}`,
-        dependsOn: ["host.detect"],
-        status: !host.skillSupported ? "absent" : host.skillInstalled ? "ready" : "action_needed",
-        optional: true,
-        hint: !host.skillSupported ? "Skill path for this host is not wired yet." : host.skillInstalled ? "Skill is installed." : "Installs native room behavior so wake prompts can stay short.",
-        action: host.skillSupported && !host.skillInstalled ? { id: "host.installSkill", label: "Install skill", host: host.id } : undefined
-    });
-    steps.push({
-        id: "agent.binding",
-        label: "Bind agent to workspace",
-        dependsOn: ["device"],
-        status: !input.paired ? "blocked" : agentBound ? "ready" : "action_needed",
-        hint: !input.paired ? "needs: Pair this device" : agentBound ? `${input.bindings.length} binding(s) configured.` : "Add an agent plate, room id, host, and local folder.",
-        blocker: input.paired ? undefined : { id: "device", label: "Pair this device" },
-        action: !input.paired || agentBound ? undefined : { id: "config.binding.focus", label: "Add binding" }
-    });
-    steps.push({
-        id: "listener",
-        label: "Start listening",
-        dependsOn: ["device", "agent.binding", "host.auth"],
-        status: input.listener.running ? "working" : listenerBlocker ? "blocked" : "action_needed",
-        hint: input.listener.running
-            ? `Serving ${input.listener.servingCount} instance(s).`
-            : listenerBlocker
-                ? `needs: ${listenerBlocker.label}`
-                : "Connects to the cloud socket and wakes bound agents on @mentions.",
-        blocker: listenerBlocker,
-        action: input.listener.running
-            ? { id: "listener.stop", label: "Stop" }
-            : !listenerBlocker
-                ? { id: "listener.start", label: "Start listening" }
-                : undefined
-    });
-    steps.push({
-        id: "dashboard.update",
-        label: "Update dashboard",
-        dependsOn: ["node"],
-        status: input.dashboard.updateAvailable ? "attention" : "ready",
-        optional: true,
-        hint: input.dashboard.updateAvailable
-            ? `A newer package is available (${input.dashboard.latestVersion}). Restart with npx agent-rooms@latest dashboard.`
-            : `Dashboard package ${input.dashboard.currentVersion} is up to date.`,
-        action: input.dashboard.updateAvailable ? { id: "manual.command", label: "Show update command", command: "npx agent-rooms@latest dashboard", manual: true } : undefined
-    });
-    return steps;
-}
-function listenerBlockerFor(paired, agentBound, host) {
-    if (!paired)
-        return { id: "device", label: "Pair this device" };
-    if (!agentBound)
-        return { id: "agent.binding", label: "Bind agent to workspace" };
-    if (!host.detected)
-        return { id: "host.detect", label: "Host CLI detected" };
-    if (!host.versionOk)
-        return { id: "host.update", label: `Update ${host.label}` };
-    if (!host.cliSignedIn)
-        return { id: "host.auth", label: `Sign in to ${host.label}` };
-    return undefined;
-}
-function buildDiagnostics(steps, preferredHost) {
-    const mentionRoot = rootCause(steps, "listener");
-    const replyRoot = rootCause(steps, "mcp.auth");
-    const toolsRoot = rootCause(steps, "mcp.auth");
-    return [
-        {
-            id: "mention-no-wake",
-            symptom: "I @mentioned my agent and nothing happened.",
-            cause: mentionRoot ? `${mentionRoot.label}: ${mentionRoot.hint}` : "Listener path is ready. Check room membership and recent activity.",
-            action: mentionRoot?.action
-        },
-        {
-            id: "woke-no-reply",
-            symptom: "Agent woke but did not reply in the room.",
-            cause: replyRoot ? `${replyRoot.label}: ${replyRoot.hint}` : "Connector auth is ready. Check the Activity feed for spawn/tool errors.",
-            action: replyRoot?.action
-        },
-        {
-            id: "tools-missing",
-            symptom: "Agent Rooms tools do not show up in my host.",
-            cause: toolsRoot ? `${toolsRoot.label}: ${toolsRoot.hint}` : `MCP looks ready for ${preferredHost}. Restart the host if it was already open.`,
-            action: toolsRoot?.action
-        },
-        {
-            id: "self-loop",
-            symptom: "It keeps waking itself.",
-            cause: "Backend requires @plate for parsed mentions and has a self-wake guard. If this recurs, look for explicit self-mentions in the sender.",
-            action: { id: "manual.command", label: "Show logs", command: "agent-rooms dashboard", manual: true }
-        }
-    ];
-}
-function rootCause(steps, id, seen = new Set()) {
-    if (seen.has(id))
-        return null;
-    seen.add(id);
-    const byId = new Map(steps.map((step) => [step.id, step]));
-    const step = byId.get(id);
-    if (!step)
-        return null;
-    for (const dep of step.dependsOn ?? []) {
-        const root = rootCause(steps, dep, seen);
-        if (root)
-            return root;
-    }
-    return isFailing(step) ? step : null;
-}
-function isFailing(step) {
-    return step.status !== "ready" && step.status !== "working" && step.status !== "absent";
-}
-function chooseNextAction(steps) {
-    return steps.find((step) => step.status === "action_needed" && !step.optional)
-        ?? steps.find((step) => step.status === "action_needed")
-        ?? null;
-}
-function choosePreferredHost(bindings, hosts) {
-    const configured = bindings.find((binding) => getAdapter(binding.host))?.host;
-    if (configured && hosts[configured])
-        return configured;
-    const detected = Object.values(hosts).find((host) => host.detected);
-    return detected?.id ?? "claude_code";
-}
-function buildCommands(apiBase, preferredHost, host) {
-    const commands = [
-        "npx agent-rooms@latest dashboard",
-        "npx agent-rooms@latest watch",
-        "npx agent-rooms@latest watch --dry-run",
-        "Dashboard: Restart listener button soft-reloads bindings and paused agents.",
-        "npx agent-rooms@latest uninstall --yes"
-    ];
-    if (host) {
-        commands.push(host.commands.signIn);
-        commands.push(host.commands.installMcp);
-        if (preferredHost === "codex")
-            commands.push("$env:AGENT_ROOMS_TOKEN=\"<agent credential>\"  # optional if saved in dashboard");
-    }
-    commands.push(`API base: ${apiBase}`);
-    return commands;
-}
-function nodeReady() {
-    return Number(process.versions.node.split(".")[0] ?? 0) >= 20;
-}
-function runProbe(command, args, timeout = 5000) {
-    try {
-        const result = spawnSync(command, args, {
-            encoding: "utf8",
-            timeout,
-            shell: process.platform === "win32",
-            stdio: "pipe"
-        });
-        const output = `${result.stdout ?? ""}${result.stderr ?? ""}`.trim();
-        return { ok: result.status === 0, output };
-    }
-    catch (error) {
-        return { ok: false, output: error.message };
-    }
-}
-function firstLine(value) {
-    return value.split(/\r?\n/)[0]?.trim() ?? "";
-}
-function parseClaudeAuth(output) {
-    try {
-        const parsed = JSON.parse(output);
-        return parsed.loggedIn === true;
-    }
-    catch {
-        return /logged\s*in|authenticated/i.test(output);
-    }
-}
-function parseCodexMcp(output) {
-    try {
-        const parsed = JSON.parse(output);
-        return parsed.find((server) => server.name === "agent-rooms") ?? null;
-    }
-    catch {
-        return null;
-    }
-}
-function detectDashboardVersion() {
-    const currentVersion = packageJson.version ?? "0.0.0";
-    const latest = runProbe("npm", ["view", "agent-rooms", "version"], 5000);
-    const latestVersion = latest.ok ? firstLine(latest.output) : null;
-    return {
-        currentVersion,
-        latestVersion,
-        updateAvailable: Boolean(latestVersion && isVersionAtLeast(latestVersion, currentVersion) && latestVersion !== currentVersion)
-    };
-}
-function isVersionAtLeast(value, minimum) {
-    if (!minimum)
-        return true;
-    const found = parseVersion(value);
-    const floor = parseVersion(minimum);
-    if (!found || !floor)
-        return true;
-    for (let i = 0; i < 3; i += 1) {
-        const a = found[i] ?? 0;
-        const b = floor[i] ?? 0;
-        if (a > b)
-            return true;
-        if (a < b)
-            return false;
-    }
-    return true;
-}
-function parseVersion(value) {
-    const match = value?.match(/(\d+)\.(\d+)\.(\d+)/);
-    if (!match)
-        return null;
-    return [Number(match[1]), Number(match[2]), Number(match[3])];
-}
-//# sourceMappingURL=readiness.js.map