@ouro.bot/cli 0.1.0-alpha.422 → 0.1.0-alpha.425

package/dist/heart/daemon/cli-help.js

@@ -94,8 +94,8 @@ exports.COMMAND_REGISTRY = {
     config: {
         category: "Agents",
         description: "View or change agent configuration",
-        usage: "ouro config <subcommand> --agent <name>",
-        example: "ouro config models --agent ouroboros",
+        usage: "ouro config <subcommand> [--agent <name>]",
+        example: "ouro config models",
         subcommands: ["model", "models"],
     },
     changelog: {
@@ -159,27 +159,27 @@ exports.COMMAND_REGISTRY = {
     auth: {
         category: "Auth",
         description: "Set up, verify, or switch agent credentials",
-        usage: "ouro auth [verify|switch] --agent <name> [--provider <provider>]",
-        example: "ouro auth --agent ouroboros",
+        usage: "ouro auth [verify|switch] [--agent <name>] [--provider <provider>]",
+        example: "ouro auth",
         subcommands: ["verify", "switch"],
     },
     connect: {
         category: "Auth",
-        description: "Connect integrations and local senses such as Perplexity search and BlueBubbles iMessage",
-        usage: "ouro connect [perplexity|bluebubbles] --agent <name>",
-        example: "ouro connect perplexity --agent ouroboros",
-        subcommands: ["perplexity", "bluebubbles"],
+        description: "Connect providers, portable integrations, and local senses from one guided bay",
+        usage: "ouro connect [providers|perplexity|embeddings|teams|bluebubbles] [--agent <name>]",
+        example: "ouro connect",
+        subcommands: ["providers", "perplexity", "embeddings", "teams", "bluebubbles"],
     },
     use: {
         category: "Auth",
         description: "Choose this machine's provider/model lane for an agent",
-        usage: "ouro use --agent <name> --lane outward|inner --provider <provider> --model <model> [--force]",
+        usage: "ouro use [--agent <name>] --lane outward|inner --provider <provider> --model <model> [--force]",
         example: "ouro use --agent ouroboros --lane outward --provider minimax --model MiniMax-M2.5",
     },
     check: {
         category: "Auth",
         description: "Run a live check for this machine's selected provider/model lane",
-        usage: "ouro check --agent <name> --lane outward|inner",
+        usage: "ouro check [--agent <name>] --lane outward|inner",
         example: "ouro check --agent ouroboros --lane outward",
     },
     repair: {
@@ -191,15 +191,15 @@ exports.COMMAND_REGISTRY = {
     provider: {
         category: "Auth",
         description: "Refresh daemon provider credentials from an agent vault",
-        usage: "ouro provider refresh --agent <name>",
+        usage: "ouro provider refresh [--agent <name>]",
         example: "ouro provider refresh --agent ouroboros",
         subcommands: ["refresh"],
     },
     vault: {
         category: "Auth",
         description: "Create, replace, recover, unlock, inspect, and populate the agent credential vault",
-        usage: "ouro vault <create|replace|recover|unlock|status|config> --agent <name>",
-        example: "ouro vault status --agent ouroboros",
+        usage: "ouro vault <create|replace|recover|unlock|status|config> [--agent <name>]",
+        example: "ouro vault status",
         subcommands: ["create", "replace", "recover", "unlock", "status", "config set", "config status"],
     },
     thoughts: {
@@ -244,8 +244,8 @@ exports.COMMAND_REGISTRY = {
     setup: {
         category: "System",
         description: "Register MCP server and hooks for a dev tool",
-        usage: "ouro setup --tool <claude-code|codex> --agent <name>",
-        example: "ouro setup --tool claude-code --agent ouroboros",
+        usage: "ouro setup --tool <claude-code|codex> [--agent <name>]",
+        example: "ouro setup --tool claude-code",
     },
     hook: {
         category: "System",
@@ -256,71 +256,86 @@ exports.COMMAND_REGISTRY = {
     bluebubbles: {
         category: "System",
         description: "BlueBubbles integration commands",
-        usage: "ouro bluebubbles replay --agent <name> --message-guid <guid> [--event-type <type>] [--json]",
-        example: "ouro bluebubbles replay --agent ouroboros --message-guid abc123",
+        usage: "ouro bluebubbles replay [--agent <name>] --message-guid <guid> [--event-type <type>] [--json]",
+        example: "ouro bluebubbles replay --message-guid abc123",
         subcommands: ["replay"],
     },
 };
 const SUBCOMMAND_HELP = {
     "auth verify": {
         description: "Verify agent provider credentials without changing provider/model lanes",
-        usage: "ouro auth verify --agent <name> [--provider <provider>]",
-        example: "ouro auth verify --agent ouroboros --provider openai-codex",
+        usage: "ouro auth verify [--agent <name>] [--provider <provider>]",
+        example: "ouro auth verify --provider openai-codex",
     },
     "auth switch": {
         description: "Switch local provider/model lanes after credentials are available",
-        usage: "ouro auth switch --agent <name> --provider <provider> [--facing human|agent]",
-        example: "ouro auth switch --agent ouroboros --provider minimax",
+        usage: "ouro auth switch [--agent <name>] --provider <provider> [--facing human|agent]",
+        example: "ouro auth switch --provider minimax",
     },
     "connect perplexity": {
         description: "Connect Perplexity search for this agent",
-        usage: "ouro connect perplexity --agent <name>",
-        example: "ouro connect perplexity --agent ouroboros",
+        usage: "ouro connect perplexity [--agent <name>]",
+        example: "ouro connect perplexity",
+    },
+    "connect providers": {
+        description: "Open provider auth from the connect bay without remembering the auth command",
+        usage: "ouro connect providers [--agent <name>]",
+        example: "ouro connect providers",
+    },
+    "connect embeddings": {
+        description: "Connect memory embeddings for this agent",
+        usage: "ouro connect embeddings [--agent <name>]",
+        example: "ouro connect embeddings",
+    },
+    "connect teams": {
+        description: "Connect Microsoft Teams credentials and enable the Teams sense",
+        usage: "ouro connect teams [--agent <name>]",
+        example: "ouro connect teams",
     },
     "connect bluebubbles": {
         description: "Attach BlueBubbles iMessage to this machine only",
-        usage: "ouro connect bluebubbles --agent <name>",
-        example: "ouro connect bluebubbles --agent ouroboros",
+        usage: "ouro connect bluebubbles [--agent <name>]",
+        example: "ouro connect bluebubbles",
     },
     "provider refresh": {
         description: "Reload this agent's provider credentials from its vault into daemon memory",
-        usage: "ouro provider refresh --agent <name>",
-        example: "ouro provider refresh --agent ouroboros",
+        usage: "ouro provider refresh [--agent <name>]",
+        example: "ouro provider refresh",
     },
     "vault create": {
         description: "Create an agent credential vault and store local unlock material",
-        usage: "ouro vault create --agent <name> --email <email> [--server <url>] [--store <store>]",
-        example: "ouro vault create --agent ouroboros --email ouroboros@ouro.bot",
+        usage: "ouro vault create [--agent <name>] --email <email> [--server <url>] [--store <store>]",
+        example: "ouro vault create --email ouroboros@ouro.bot",
     },
     "vault replace": {
         description: "Create an empty agent vault at the stable agent email when no unlock secret or JSON export exists",
-        usage: "ouro vault replace --agent <name> [--email <email>] [--server <url>] [--store <store>]",
-        example: "ouro vault replace --agent ouroboros",
+        usage: "ouro vault replace [--agent <name>] [--email <email>] [--server <url>] [--store <store>]",
+        example: "ouro vault replace",
     },
     "vault recover": {
         description: "Create an agent vault at the stable agent email and import local JSON credential exports",
-        usage: "ouro vault recover --agent <name> --from <json> [--from <json> ...] [--email <email>] [--server <url>] [--store <store>]",
-        example: "ouro vault recover --agent ouroboros --from ./credentials.json",
+        usage: "ouro vault recover [--agent <name>] --from <json> [--from <json> ...] [--email <email>] [--server <url>] [--store <store>]",
+        example: "ouro vault recover --from ./credentials.json",
     },
     "vault unlock": {
         description: "Unlock an existing agent credential vault on this machine",
-        usage: "ouro vault unlock --agent <name> [--store <store>]",
-        example: "ouro vault unlock --agent ouroboros",
+        usage: "ouro vault unlock [--agent <name>] [--store <store>]",
+        example: "ouro vault unlock",
     },
     "vault status": {
         description: "Show whether this machine can unlock an agent credential vault",
-        usage: "ouro vault status --agent <name> [--store <store>]",
-        example: "ouro vault status --agent ouroboros",
+        usage: "ouro vault status [--agent <name>] [--store <store>]",
+        example: "ouro vault status",
     },
     "vault config set": {
         description: "Write runtime configuration into the agent credential vault without printing values",
-        usage: "ouro vault config set --agent <name> --key <path> [--value <value>] [--scope agent|machine]",
-        example: "ouro vault config set --agent ouroboros --key teams.clientSecret",
+        usage: "ouro vault config set [--agent <name>] --key <path> [--value <value>] [--scope agent|machine]",
+        example: "ouro vault config set --key teams.clientSecret",
     },
     "vault config status": {
         description: "List runtime configuration keys stored in the agent credential vault",
-        usage: "ouro vault config status --agent <name> [--scope agent|machine|all]",
-        example: "ouro vault config status --agent ouroboros --scope all",
+        usage: "ouro vault config status [--agent <name>] [--scope agent|machine|all]",
+        example: "ouro vault config status --scope all",
     },
 };
 // ── Levenshtein distance ──

package/dist/heart/daemon/cli-parse.js

@@ -74,25 +74,25 @@ function usage() {
         "  ouro dev [--repo-path <path>] [--clone [--clone-path <path>]]",
         "  ouro stop|down|status|logs|hatch",
         "  ouro status --agent <name>",
-        "  ouro use --agent <name> --lane outward|inner --provider <provider> --model <model> [--force]",
-        "  ouro check --agent <name> --lane outward|inner",
+        "  ouro use [--agent <name>] --lane outward|inner --provider <provider> --model <model> [--force]",
+        "  ouro check [--agent <name>] --lane outward|inner",
         "  ouro repair [--agent <name>]",
-        "  ouro provider refresh --agent <name>",
+        "  ouro provider refresh [--agent <name>]",
         "  ouro outlook [--json]",
         "  ouro -v|--version",
-        "  ouro config model --agent <name> <model-name>",
-        "  ouro config models --agent <name>",
-        "  ouro auth --agent <name> [--provider <provider>]",
-        "  ouro connect [perplexity|bluebubbles] --agent <name>",
-        "  ouro auth verify --agent <name> [--provider <provider>]",
-        "  ouro auth switch --agent <name> --provider <provider>",
-        "  ouro vault create --agent <name> --email <email> [--server <url>] [--store <store>]",
-        "  ouro vault replace --agent <name> [--email <email>] [--server <url>] [--store <store>]",
-        "  ouro vault recover --agent <name> --from <json> [--from <json>] [--email <email>] [--server <url>] [--store <store>]",
-        "  ouro vault unlock --agent <name> [--store auto|macos-keychain|windows-dpapi|linux-secret-service|plaintext-file]",
-        "  ouro vault status --agent <name> [--store auto|macos-keychain|windows-dpapi|linux-secret-service|plaintext-file]",
-        "  ouro vault config set --agent <name> --key <path> [--value <value>] [--scope agent|machine]",
-        "  ouro vault config status --agent <name> [--scope agent|machine|all]",
+        "  ouro config model [--agent <name>] <model-name>",
+        "  ouro config models [--agent <name>]",
+        "  ouro auth [--agent <name>] [--provider <provider>]",
+        "  ouro connect [providers|perplexity|embeddings|teams|bluebubbles] [--agent <name>]",
+        "  ouro auth verify [--agent <name>] [--provider <provider>]",
+        "  ouro auth switch [--agent <name>] --provider <provider>",
+        "  ouro vault create [--agent <name>] --email <email> [--server <url>] [--store <store>]",
+        "  ouro vault replace [--agent <name>] [--email <email>] [--server <url>] [--store <store>]",
+        "  ouro vault recover [--agent <name>] --from <json> [--from <json>] [--email <email>] [--server <url>] [--store <store>]",
+        "  ouro vault unlock [--agent <name>] [--store auto|macos-keychain|windows-dpapi|linux-secret-service|plaintext-file]",
+        "  ouro vault status [--agent <name>] [--store auto|macos-keychain|windows-dpapi|linux-secret-service|plaintext-file]",
+        "  ouro vault config set [--agent <name>] --key <path> [--value <value>] [--scope agent|machine]",
+        "  ouro vault config status [--agent <name>] [--scope agent|machine|all]",
         "  ouro chat <agent>",
         "  ouro msg --to <agent> [--session <id>] [--task <ref>] <message>",
         "  ouro poke <agent> --task <task-id>",
@@ -100,7 +100,7 @@ function usage() {
         "  ouro habit list [--agent <name>]",
         "  ouro habit create [--agent <name>] <name> [--cadence <interval>]",
         "  ouro link <agent> --friend <id> --provider <provider> --external-id <external-id>",
-        "  ouro bluebubbles replay --agent <name> --message-guid <guid> [--event-type new-message|updated-message] [--json]",
+        "  ouro bluebubbles replay [--agent <name>] --message-guid <guid> [--event-type new-message|updated-message] [--json]",
         "  ouro task board [<status>] [--agent <name>]",
         "  ouro task create <title> [--type <type>] [--agent <name>]",
         "  ouro task update <id> <status> [--agent <name>]",
@@ -415,15 +415,21 @@ function parseAuthCommand(args) {
             }
         }
         /* v8 ignore stop */
-        /* v8 ignore next -- defensive: agent always provided in tests @preserve */
-        if (!agent)
-            throw new Error(`Usage\n${usage()}`);
         if (subcommand === "switch") {
             if (!provider)
                 throw new Error(`auth switch requires --provider.\n${usage()}`);
-            return facing ? { kind: "auth.switch", agent, provider, facing } : { kind: "auth.switch", agent, provider };
+            return {
+                kind: "auth.switch",
+                ...(agent ? { agent } : {}),
+                provider,
+                ...(facing ? { facing } : {}),
+            };
         }
-        return provider ? { kind: "auth.verify", agent, provider } : { kind: "auth.verify", agent };
+        return {
+            kind: "auth.verify",
+            ...(agent ? { agent } : {}),
+            ...(provider ? { provider } : {}),
+        };
     }
     const { agent, rest } = extractAgentFlag(args);
     let provider;
@@ -437,15 +443,11 @@ function parseAuthCommand(args) {
             continue;
         }
     }
-    if (!agent) {
-        throw new Error([
-            "Usage:",
-            "  ouro auth --agent <name> [--provider <provider>]     Set up credentials",
-            "  ouro auth verify --agent <name> [--provider <p>]     Verify credentials work",
-            "  ouro auth switch --agent <name> --provider <p>       Switch active provider",
-        ].join("\n"));
-    }
-    return provider ? { kind: "auth.run", agent, provider } : { kind: "auth.run", agent };
+    return {
+        kind: "auth.run",
+        ...(agent ? { agent } : {}),
+        ...(provider ? { provider } : {}),
+    };
 }
 function isVaultUnlockStoreKind(value) {
     return value === "auto" || value === "macos-keychain" || value === "windows-dpapi" || value === "linux-secret-service" || value === "plaintext-file";
@@ -487,7 +489,7 @@ function parseVaultCommand(args) {
             }
             const value = rest[i + 1];
             if (!value)
-                throw new Error("Usage: ouro vault recover --agent <name> --from <json> [--from <json> ...]");
+                throw new Error("Usage: ouro vault recover [--agent <name>] --from <json> [--from <json> ...]");
             sources.push(value);
             i += 1;
             continue;
@@ -496,15 +498,15 @@ function parseVaultCommand(args) {
             generateUnlockSecret = true;
             continue;
         }
-        throw new Error("Usage: ouro vault create|replace|recover|unlock|status --agent <name>");
+        throw new Error("Usage: ouro vault create|replace|recover|unlock|status [--agent <name>]");
     }
-    if (!agent || (sub !== "create" && sub !== "replace" && sub !== "recover" && sub !== "unlock" && sub !== "status")) {
-        throw new Error("Usage: ouro vault create|replace|recover|unlock|status --agent <name>");
+    if (sub !== "create" && sub !== "replace" && sub !== "recover" && sub !== "unlock" && sub !== "status") {
+        throw new Error("Usage: ouro vault create|replace|recover|unlock|status [--agent <name>]");
     }
     if (sub === "create") {
         return {
             kind: "vault.create",
-            agent,
+            ...(agent ? { agent } : {}),
             ...(email ? { email } : {}),
             ...(serverUrl ? { serverUrl } : {}),
             ...(store ? { store } : {}),
@@ -514,7 +516,7 @@ function parseVaultCommand(args) {
     if (sub === "replace") {
         return {
             kind: "vault.replace",
-            agent,
+            ...(agent ? { agent } : {}),
             ...(email ? { email } : {}),
             ...(serverUrl ? { serverUrl } : {}),
             ...(store ? { store } : {}),
@@ -523,11 +525,11 @@ function parseVaultCommand(args) {
     }
     if (sub === "recover") {
         if (sources.length === 0) {
-            throw new Error("Usage: ouro vault recover --agent <name> --from <json> [--from <json> ...]");
+            throw new Error("Usage: ouro vault recover [--agent <name>] --from <json> [--from <json> ...]");
         }
         return {
             kind: "vault.recover",
-            agent,
+            ...(agent ? { agent } : {}),
             sources,
             ...(email ? { email } : {}),
             ...(serverUrl ? { serverUrl } : {}),
@@ -536,9 +538,9 @@ function parseVaultCommand(args) {
         };
     }
     if (sub === "unlock") {
-        return { kind: "vault.unlock", agent, ...(store ? { store } : {}) };
+        return { kind: "vault.unlock", ...(agent ? { agent } : {}), ...(store ? { store } : {}) };
     }
-    return { kind: "vault.status", agent, ...(store ? { store } : {}) };
+    return { kind: "vault.status", ...(agent ? { agent } : {}), ...(store ? { store } : {}) };
 }
 function parseVaultConfigCommand(args) {
     const sub = args[0];
@@ -567,41 +569,45 @@ function parseVaultConfigCommand(args) {
             i += 1;
             continue;
         }
-        throw new Error("Usage: ouro vault config set --agent <name> --key <path> [--value <value>] OR ouro vault config status --agent <name>");
+        throw new Error("Usage: ouro vault config set [--agent <name>] --key <path> [--value <value>] OR ouro vault config status [--agent <name>]");
     }
-    if (!agent || (sub !== "set" && sub !== "status")) {
-        throw new Error("Usage: ouro vault config set --agent <name> --key <path> [--value <value>] OR ouro vault config status --agent <name>");
+    if (sub !== "set" && sub !== "status") {
+        throw new Error("Usage: ouro vault config set [--agent <name>] --key <path> [--value <value>] OR ouro vault config status [--agent <name>]");
     }
     if (sub === "status") {
         if (key || value) {
-            throw new Error("Usage: ouro vault config status --agent <name>");
+            throw new Error("Usage: ouro vault config status [--agent <name>]");
         }
-        return { kind: "vault.config.status", agent, ...(scope ? { scope } : {}) };
+        return { kind: "vault.config.status", ...(agent ? { agent } : {}), ...(scope ? { scope } : {}) };
     }
     if (scope === "all")
         throw new Error("vault config --scope all is only valid for status");
     if (!key) {
-        throw new Error("Usage: ouro vault config set --agent <name> --key <path> [--value <value>]");
+        throw new Error("Usage: ouro vault config set [--agent <name>] --key <path> [--value <value>]");
     }
-    return { kind: "vault.config.set", agent, key, ...(value !== undefined ? { value } : {}), ...(scope ? { scope } : {}) };
+    return { kind: "vault.config.set", ...(agent ? { agent } : {}), key, ...(value !== undefined ? { value } : {}), ...(scope ? { scope } : {}) };
 }
 function normalizeConnectTarget(value) {
     if (!value)
         return undefined;
+    if (value === "providers" || value === "provider" || value === "auth")
+        return "providers";
     if (value === "perplexity" || value === "perplexity-search")
         return "perplexity";
+    if (value === "embeddings" || value === "embedding" || value === "memory" || value === "note-search" || value === "notes")
+        return "embeddings";
+    if (value === "teams" || value === "msteams" || value === "microsoft-teams")
+        return "teams";
     if (value === "bluebubbles" || value === "imessage" || value === "messages")
         return "bluebubbles";
-    throw new Error("Usage: ouro connect [perplexity|bluebubbles] --agent <name>");
+    throw new Error("Usage: ouro connect [providers|perplexity|embeddings|teams|bluebubbles] [--agent <name>]");
 }
 function parseConnectCommand(args) {
     const { agent, rest } = extractAgentFlag(args);
-    if (!agent)
-        throw new Error("Usage: ouro connect --agent <name> [perplexity|bluebubbles]");
     if (rest.length > 1)
-        throw new Error("Usage: ouro connect [perplexity|bluebubbles] --agent <name>");
+        throw new Error("Usage: ouro connect [providers|perplexity|embeddings|teams|bluebubbles] [--agent <name>]");
     const target = normalizeConnectTarget(rest[0]);
-    return { kind: "connect", agent, ...(target ? { target } : {}) };
+    return { kind: "connect", ...(agent ? { agent } : {}), ...(target ? { target } : {}) };
 }
 function parseProviderUseCommand(args) {
     const { agent, rest: afterAgent } = extractAgentFlag(args);
@@ -615,7 +621,7 @@ function parseProviderUseCommand(args) {
         if (token === "--provider") {
             const value = rest[i + 1];
             if (!isAgentProvider(value))
-                throw new Error(`Usage: ouro use --agent <name> --lane outward|inner --provider <provider> --model <model>`);
+                throw new Error("Usage: ouro use [--agent <name>] --lane outward|inner --provider <provider> --model <model>");
             provider = value;
             i += 1;
             continue;
@@ -629,15 +635,15 @@ function parseProviderUseCommand(args) {
             force = true;
             continue;
         }
-        throw new Error("Usage: ouro use --agent <name> --lane outward|inner --provider <provider> --model <model> [--force]");
+        throw new Error("Usage: ouro use [--agent <name>] --lane outward|inner --provider <provider> --model <model> [--force]");
     }
     const resolvedLane = lane ?? (facing ? facingToProviderLane(facing) : undefined);
-    if (!agent || !resolvedLane || !provider || !model) {
-        throw new Error("Usage: ouro use --agent <name> --lane outward|inner --provider <provider> --model <model> [--force]");
+    if (!resolvedLane || !provider || !model) {
+        throw new Error("Usage: ouro use [--agent <name>] --lane outward|inner --provider <provider> --model <model> [--force]");
     }
     return {
         kind: "provider.use",
-        agent,
+        ...(agent ? { agent } : {}),
         lane: resolvedLane,
         provider,
         model,
@@ -650,12 +656,12 @@ function parseProviderCheckCommand(args) {
     const { facing, rest: afterFacing } = extractFacingFlag(afterAgent);
     const { lane, rest } = extractLaneFlag(afterFacing);
     const resolvedLane = lane ?? (facing ? facingToProviderLane(facing) : undefined);
-    if (!agent || !resolvedLane || rest.length > 0) {
-        throw new Error("Usage: ouro check --agent <name> --lane outward|inner");
+    if (!resolvedLane || rest.length > 0) {
+        throw new Error("Usage: ouro check [--agent <name>] --lane outward|inner");
     }
     return {
         kind: "provider.check",
-        agent,
+        ...(agent ? { agent } : {}),
         lane: resolvedLane,
         ...(facing ? { legacyFacing: facing } : {}),
     };
@@ -663,10 +669,10 @@ function parseProviderCheckCommand(args) {
 function parseProviderCommand(args) {
     const sub = args[0];
     const { agent, rest } = extractAgentFlag(args.slice(1));
-    if (sub === "refresh" && agent && rest.length === 0) {
-        return { kind: "provider.refresh", agent };
+    if (sub === "refresh" && rest.length === 0) {
+        return { kind: "provider.refresh", ...(agent ? { agent } : {}) };
     }
-    throw new Error("Usage: ouro provider refresh --agent <name>");
+    throw new Error("Usage: ouro provider refresh [--agent <name>]");
 }
 function parseReminderCommand(args) {
     const { agent, rest: cleaned } = extractAgentFlag(args);
@@ -830,17 +836,18 @@ function parseConfigCommand(args) {
     if (!sub)
         throw new Error(`Usage\n${usage()}`);
     if (sub === "model") {
-        if (!agent)
-            throw new Error("--agent is required for config model");
         const modelName = rest[0];
         if (!modelName)
-            throw new Error(`Usage: ouro config model --agent <name> <model-name>`);
-        return facing ? { kind: "config.model", agent, modelName, facing } : { kind: "config.model", agent, modelName };
+            throw new Error("Usage: ouro config model [--agent <name>] <model-name>");
+        return {
+            kind: "config.model",
+            ...(agent ? { agent } : {}),
+            modelName,
+            ...(facing ? { facing } : {}),
+        };
     }
     if (sub === "models") {
-        if (!agent)
-            throw new Error("--agent is required for config models");
-        return { kind: "config.models", agent };
+        return { kind: "config.models", ...(agent ? { agent } : {}) };
     }
     throw new Error(`Usage\n${usage()}`);
 }
@@ -931,13 +938,13 @@ function parseSetupCommand(args) {
             continue;
         }
     }
+    if (args.includes("--agent") && !agent)
+        throw new Error("setup requires --agent <name>");
     if (!tool)
         throw new Error("setup requires --tool (claude-code | codex)");
     if (tool !== "claude-code" && tool !== "codex")
         throw new Error(`Unknown tool: ${tool}. Supported: claude-code, codex`);
-    if (!agent)
-        throw new Error("setup requires --agent <name>");
-    return { kind: "setup", tool, agent };
+    return { kind: "setup", tool, ...(agent ? { agent } : {}) };
 }
 function parseBlueBubblesCommand(args) {
     const subcommand = args[0];
@@ -970,13 +977,11 @@ function parseBlueBubblesCommand(args) {
             continue;
         }
     }
-    if (!agent)
-        throw new Error("bluebubbles replay requires --agent <name>");
     if (!messageGuid)
         throw new Error("bluebubbles replay requires --message-guid <guid>");
     return {
         kind: "bluebubbles.replay",
-        agent,
+        ...(agent ? { agent } : {}),
         messageGuid,
         eventType,
         ...(json ? { json: true } : {}),

package/dist/heart/daemon/up-progress.js

@@ -20,6 +20,7 @@ const RESET = "\x1b[0m";
 const BOLD = "\x1b[1m";
 const DIM = "\x1b[2m";
 const GREEN = "\x1b[38;2;46;204;64m";
+const RED = "\x1b[38;2;255;106;106m";
 // ── UpProgress class ──
 class UpProgress {
     write;
@@ -109,7 +110,7 @@ class UpProgress {
             return;
         }
         const elapsedMs = this.now() - this.currentPhase.startedAt;
-        this.completed.push({ label, detail });
+        this.completed.push({ status: "success", label, detail });
         this.currentPhase = null;
         this.currentDetail = null;
         this.stopAutoRender();
@@ -137,6 +138,41 @@ class UpProgress {
             this.write(`  \u2713 ${label}${detailStr}\n`);
         }
     }
+    failPhase(label, detail) {
+        if (!this.currentPhase) {
+            return;
+        }
+        const elapsedMs = this.now() - this.currentPhase.startedAt;
+        this.completed.push({ status: "failure", label, detail });
+        this.currentPhase = null;
+        this.currentDetail = null;
+        this.stopAutoRender();
+        if (this.eventScope === "command") {
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "daemon",
+                event: "daemon.cli_progress_phase_failed",
+                message: `phase failed: ${label}`,
+                meta: { command: this.commandName, phase: label, detail: detail ?? null, elapsedMs },
+            });
+        }
+        else {
+            (0, runtime_1.emitNervesEvent)({
+                level: "warn",
+                component: "daemon",
+                event: "daemon.up_phase_failed",
+                message: `phase failed: ${label}`,
+                meta: { phase: label, detail: detail ?? null, elapsedMs },
+            });
+        }
+        if (this.isTTY) {
+            this.flushRender();
+        }
+        else {
+            const detailStr = detail ? ` \u2014 ${detail}` : "";
+            this.write(`  \u2717 ${label}${detailStr}\n`);
+        }
+    }
     /**
      * Build an ANSI string for in-place terminal display. Returns empty
      * string in non-TTY mode (output is written eagerly in completePhase).
@@ -149,7 +185,12 @@ class UpProgress {
         // Completed phases
         for (const phase of this.completed) {
             const detailStr = phase.detail ? ` ${DIM}\u2014 ${phase.detail}${RESET}` : "";
-            lines.push(`  ${GREEN}\u2713${RESET} ${phase.label}${detailStr}`);
+            if (phase.status === "failure") {
+                lines.push(`  ${RED}\u2717${RESET} ${phase.label}${detailStr}`);
+            }
+            else {
+                lines.push(`  ${GREEN}\u2713${RESET} ${phase.label}${detailStr}`);
+            }
         }
         // Current phase with spinner
         if (this.currentPhase) {

package/dist/mind/prompt.js

@@ -451,8 +451,8 @@ function senseRuntimeGuidance(channel, preReadStatusLines) {
     lines.push("- running = enabled and currently active");
     lines.push("- error = enabled but unhealthy");
     lines.push("If asked how to enable another sense, I explain the relevant agent.json senses entry and required agent-vault runtime/config fields instead of guessing.");
-    lines.push("teams setup truth: enable `senses.teams.enabled`, then store `teams.clientId`, `teams.clientSecret`, and `teams.tenantId` in the agent vault runtime/config item.");
-    lines.push("bluebubbles setup truth: run `ouro connect bluebubbles --agent <agent>`; it stores this machine's BlueBubbles URL/password/listener config in the agent vault machine runtime item.");
+    lines.push("teams setup truth: run `ouro connect teams --agent <agent>` from the connect bay; it stores Teams runtime/config fields and enables `senses.teams.enabled`.");
+    lines.push("bluebubbles setup truth: run `ouro connect bluebubbles --agent <agent>` from the connect bay; it stores this machine's BlueBubbles URL/password/listener config in the agent vault machine runtime item.");
     if (channel === "cli") {
         lines.push("cli is interactive: it is available when the user opens it, not something `ouro up` daemonizes.");
     }