@phnx-labs/agents-cli 1.22.114 → 1.22.116

package/dist/commands/feed.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { ensureFeedPublishHook, listAskStats, listBlocks, recordNotified, buildDeclaredBlock, publishBlock, } from '../lib/feed/feed.js';
+import { ensureFeedPublishHook, listAskStats, listBlocks, recordNotified, buildDeclaredBlock, deriveBlockState, publishBlock, } from '../lib/feed/feed.js';
 import { ensureActivityLogHook, readRecentActivity, formatActivityLine, formatProgressUpdate, mergeActivityEvents, parseActivityPayload, } from '../lib/feed/activity.js';
 import { projectKeyFromCwd } from '../lib/project-key.js';
 import { postFeedStatus } from '../lib/feed-post.js';
@@ -16,7 +16,7 @@ import { gatherRemoteAgentsJson } from '../lib/remote-agents-json.js';
 import { loadPolicy, applyPolicyToBlock, isPhoneUrgent } from '../lib/feed-policy.js';
 import { notifyUrgentBlock } from '../lib/notify.js';
 import { registerFeedWatchCommand } from './feed-watch.js';
-import { claimAndRouteAttentionAnswer, forwardFeedAnswer } from '../lib/feed/answer.js';
+import { AnswerError, answerOwnerIsLocal, checkAnswerDelivery, claimAndRouteAttentionAnswer, forwardFeedAnswer, parseAttentionKey, } from '../lib/feed/answer.js';
 import { gcMailbox } from '../lib/mailbox-gc.js';
 import { isValidMailboxId } from '../lib/mailbox.js';
 import { getActiveSessions } from '../lib/session/active.js';
@@ -171,7 +171,10 @@ function renderBlock(b, localHost, indent = '') {
     const cost = b.costOfDelay ? chalk.gray(`cost:${b.costOfDelay}`) : '';
     const rank = b.delayRank ? chalk.gray(`rank:${Math.round(b.delayRank.score)}`) : '';
     // Shared fleet-comms glyphs: ▲ open ask, ✓ answered (see comms-render GLYPH).
-    const marker = b.answer
+    // A PENDING claim carries an answer record while the block is still open, so
+    // the delivered glyph is driven by the canonical state, not by `b.answer`
+    // being set — a claimed-but-undelivered ask must keep reading as needs-you.
+    const marker = deriveBlockState(b) !== 'open'
         ? chalk.green(GLYPH.delivered)
         : b.kind === 'control'
             ? chalk.red('!')
@@ -197,7 +200,9 @@ function renderBlock(b, localHost, indent = '') {
     if (b.answer) {
         const verified = b.answer.verified ? chalk.green(GLYPH.delivered) : chalk.yellow('?');
         const who = b.answer.answeredFrom + (b.answer.answeredBy ? ` (${b.answer.answeredBy})` : '');
-        console.log(`${indent}  ${chalk.green('answered')} by ${who} ${verified}`);
+        const pending = deriveBlockState(b) === 'open';
+        const label = pending ? chalk.yellow('claimed (delivery unconfirmed)') : chalk.green('answered');
+        console.log(`${indent}  ${label} by ${who} ${verified}`);
     }
     if (b.parkedAt) {
         console.log(`${indent}  ${chalk.red('hard-parked')} ${relTime(b.parkedAt)}`);
@@ -314,6 +319,23 @@ export async function loadSessionMetasForFeedEnrichment(load) {
         throw err;
     }
 }
+/**
+ * One human line per answer outcome. The three states the operator has to tell
+ * apart are a real receipt, a hand-off no rail can confirm, and a refusal —
+ * never collapsed into a single "Delivered" (PHNX-3999).
+ */
+function renderAnswerResult(result) {
+    switch (result.status) {
+        case 'failed':
+            return `Not delivered: ${result.reason ?? 'unknown failure'} — answering again is safe.`;
+        case 'unknown':
+            return `Delivery unconfirmed: ${result.reason ?? 'no rail reported a receipt.'} Run \`agents feed answer ${result.attentionKey} --check\` rather than resending.`;
+        case 'already_answered':
+            return `Already answered — ${result.receipt?.status ?? 'claimed'}${result.receipt ? ` as ${result.receipt.msgId}` : ''} at ${result.receipt?.at ?? result.attempt}.`;
+        default:
+            return `Delivered ${result.receipt?.msgId} (${result.receipt?.status}).`;
+    }
+}
 export function registerFeedCommand(program) {
     const feed = program
         .command('feed')
@@ -334,23 +356,52 @@ export function registerFeedCommand(program) {
         .option('--choice <choice-id>', 'Stable choice id from the attention item')
         .option('--text <answer>', 'Free-text answer')
         .option('--as <operator>', 'Verified operator id for high-consequence answers')
+        .option('--check', 'Read-only: report this item\'s delivery state without claiming, routing or resending')
+        .option('--attempt <at>', 'With --check: the attempt timestamp being checked, so a newer one is reported as such')
         .option('--json', 'Emit the delivery result as JSON')
         .action(async (attentionKey, opts, invoked) => {
+        const wantsJson = Boolean(opts.json || invoked.parent?.opts()?.json);
         try {
-            const ownerHost = attentionKey.slice(0, attentionKey.indexOf('/'));
-            const result = ownerHost && ownerHost !== machineId()
-                ? await forwardFeedAnswer({ host: ownerHost, attentionKey, choiceId: opts.choice, text: opts.text, operatorId: opts.as })
-                : await claimAndRouteAttentionAnswer({
-                    attentionKey, choiceId: opts.choice, text: opts.text,
-                    operator: { id: opts.as, verified: Boolean(opts.as), label: opts.as },
-                });
-            if (opts.json || invoked.parent?.opts()?.json)
+            // The key's own host decides the rail; `answerOwnerIsLocal` normalizes
+            // both sides so a `.local` suffix is not read as a different machine.
+            const { host: ownerHost } = parseAttentionKey(attentionKey);
+            const local = answerOwnerIsLocal(ownerHost);
+            if (opts.check && (opts.choice != null || opts.text != null)) {
+                throw new AnswerError('--check is read-only; it takes no --choice or --text.', 'empty_answer');
+            }
+            if (opts.attempt != null && !opts.check) {
+                throw new AnswerError('--attempt only applies to --check.', 'empty_answer');
+            }
+            const result = opts.check
+                ? (local
+                    ? checkAnswerDelivery(attentionKey, undefined, opts.attempt)
+                    : await forwardFeedAnswer({ host: ownerHost, attentionKey, check: true, attempt: opts.attempt, operatorId: opts.as }))
+                : local
+                    ? await claimAndRouteAttentionAnswer({
+                        attentionKey, choiceId: opts.choice, text: opts.text,
+                        operator: { id: opts.as, verified: Boolean(opts.as), label: opts.as },
+                    })
+                    : await forwardFeedAnswer({ host: ownerHost, attentionKey, choiceId: opts.choice, text: opts.text, operatorId: opts.as });
+            if (wantsJson)
                 console.log(JSON.stringify(result));
             else
-                console.log(result.status === 'delivered' ? `Delivered ${result.receipt.msgId}.` : `Already answered (${result.receipt.at}).`);
+                console.log(renderAnswerResult(result));
         }
         catch (error) {
-            invoked.error(`error: ${error instanceof Error ? error.message : String(error)}`);
+            // A failure is a first-class outcome for the operator UI, not a parse
+            // error: `--json` still gets a result object it can branch on, with a
+            // non-zero exit so a scripted caller sees the failure too.
+            const message = error instanceof Error ? error.message : String(error);
+            if (wantsJson) {
+                const failure = {
+                    status: 'failed', delivery: 'failed', resolved: false, reason: message,
+                    code: error instanceof AnswerError ? error.code : 'rail_failed', attentionKey,
+                };
+                console.log(JSON.stringify(failure));
+                process.exitCode = 1;
+                return;
+            }
+            invoked.error(`error: ${message}`);
         }
     });
     feed

package/dist/commands/focus.js

@@ -136,7 +136,7 @@ export function registerFocusCommand(program) {
       # Resolve latest on yosemite-s0, then pick from that version's sessions
       agents sessions focus claude@latest --device yosemite-s0
 
-      # Attach only — refuse if nothing is joinable (old sessions go)
+      # Attach only — refuse if nothing is joinable
       agents sessions focus a1b2c3d4 --attach-only
 
       # Pick from live sessions on this machine only

package/dist/commands/go.d.ts

@@ -1,23 +1,6 @@
-/**
- * `agents sessions go [id]` — DEPRECATED alias for `agents sessions focus --attach-only`.
- *
- * `go` was "attach or refuse" (never fork/resume). `focus --attach-only` is exactly
- * that behavior, so `go` now prints a deprecation notice and delegates to `focusAction`.
- *
- * This file still owns the shared reach engine that `focus` imports:
- *   - `gatherLiveTargets` / `pickLiveTarget` / `buildLivePool` — live-session discovery + picker
- *   - `jumpTo` — the side-effecting jump: attach the already-running terminal
- *       local tmux    -> attach (switch-client when already inside tmux)
- *       local Ghostty -> focus its tab (Cmd+<n> via System Events; tab # from ghostty-tabs)
- *       remote tmux   -> ssh -tt + tmux attach (pane->session resolved on the remote)
- *       otherwise     -> hand off to the `UnreachableFallback` (attach-only refuses; focus resumes)
- *   - `refuseFallback` — the attach-only fallback (remote -> login shell; local -> refuse)
- */
-import type { Command } from 'commander';
 import { type ActiveSession } from '../lib/session/active.js';
 import type { SessionMeta } from '../lib/session/types.js';
 import { type LiveStatusFilter } from './sessions.js';
-export declare function registerGoCommand(program: Command): void;
 /**
  * Scope a live-session pool by device and live status. Pure so the `focus`
  * device/status filters are unit-testable without touching the sweep. `hosts`

package/dist/commands/go.js

@@ -1,10 +1,6 @@
 /**
- * `agents sessions go [id]` — DEPRECATED alias for `agents sessions focus --attach-only`.
- *
- * `go` was "attach or refuse" (never fork/resume). `focus --attach-only` is exactly
- * that behavior, so `go` now prints a deprecation notice and delegates to `focusAction`.
- *
- * This file still owns the shared reach engine that `focus` imports:
+ * The shared live-session reach engine that `sessions focus` / `resume --attach-only`
+ * import ("attach or refuse", never fork/resume):
  *   - `gatherLiveTargets` / `pickLiveTarget` / `buildLivePool` — live-session discovery + picker
  *   - `jumpTo` — the side-effecting jump: attach the already-running terminal
  *       local tmux    -> attach (switch-client when already inside tmux)
@@ -26,7 +22,6 @@ import { dedupeByMachineSession, mergeLocalFirst, pickSessionInteractive, matche
 import { buildPreview } from './sessions-picker.js';
 import { multiItemPicker } from '../lib/picker.js';
 import { isPromptCancelled } from './utils.js';
-import { focusAction } from './focus.js';
 import { machineId } from '../lib/session/sync/config.js';
 import { attachTmux, runTmux } from '../lib/tmux/binary.js';
 import { ensureSessionHookRepaired, paneExitStatus, teardownIfAgentExited } from '../lib/tmux/session.js';
@@ -36,18 +31,6 @@ import { connectionEndedNotice } from '../lib/hosts/reconnect.js';
 import { enumerateGhosttyTabs, assignGhosttyTabs } from '../lib/session/ghostty-tabs.js';
 import { addressabilityRecoveryHint } from '../lib/terminal/resolve.js';
 const execFileAsync = promisify(execFile);
-export function registerGoCommand(program) {
-    program
-        .command('go', { hidden: true })
-        .argument('[id]', 'Short/full session id to jump to; omit for an interactive picker')
-        .option('--local', 'Only this machine (skip the cross-host sweep)')
-        .description('Deprecated — use `agents sessions resume --attach-only` instead.')
-        .action(async (id, opts) => {
-        console.warn(chalk.yellow('`agents sessions go` is deprecated — use `agents sessions resume --attach-only` instead:'));
-        console.warn(chalk.gray(`  agents sessions resume ${id ?? '<id>'} --attach-only`));
-        await focusAction(id, { local: opts.local, attachOnly: true });
-    });
-}
 /**
  * Scope a live-session pool by device and live status. Pure so the `focus`
  * device/status filters are unit-testable without touching the sweep. `hosts`

package/dist/commands/logs.js

@@ -263,7 +263,7 @@ export function registerLogsCommand(program) {
         .action((id, opts) => runLogs(id, opts));
     addEventsReadOptions(logsCmd
         .command('audit')
-        .description('Alias for `agents events --audit`'), false)
+        .description('Alias for `agents events audit`'))
         .addHelpText('after', `
 Examples:
   agents logs audit                          Recent activity across everything

package/dist/commands/mcp.js

@@ -5,14 +5,14 @@ import ora from 'ora';
 import { checkbox } from '@inquirer/prompts';
 import { capableAgents, isCapable } from '../lib/capabilities.js';
 import { emit } from '../lib/feed/events.js';
-import { AGENTS, getAllCliStates, resolveAgentName, formatAgentError, registerMcpToTargets, unregisterMcpFromTargets, listInstalledMcpsWithScope, parseMcpConfig, getMcpConfigPathForHome, agentLabel, } from '../lib/agents.js';
+import { AGENTS, getAllCliStates, resolveAgentName, formatAgentError, unregisterMcpFromTargets, listInstalledMcpsWithScope, parseMcpConfig, getMcpConfigPathForHome, agentLabel, } from '../lib/agents.js';
 import { readManifest, writeManifest, createDefaultManifest } from '../lib/manifest.js';
 import { listMcpServerConfigs, discoverMcpConfigsFromRepo, installMcpConfigCentrally, isProjectMcpTrusted, trustProjectMcp, untrustProjectMcp, getMcpTrustStorePath, } from '../lib/mcp.js';
 import { cloneRepo } from '../lib/git.js';
 import { getMcpDir, getProjectAgentsDir } from '../lib/state.js';
-import { getEffectiveHome, getGlobalDefault, listInstalledVersions, getVersionHomePath, resolveInstalledAgentTargets, resolveConfiguredAgentTargets, syncResourcesToVersion, } from '../lib/installations/versions.js';
+import { getEffectiveHome, getGlobalDefault, listInstalledVersions, getVersionHomePath, resolveInstalledAgentTargets, syncResourcesToVersion, } from '../lib/installations/versions.js';
 import { getUserAgentsDir } from '../lib/state.js';
-import { isPromptCancelled, isInteractiveTerminal, requireInteractiveSelection, promptRemovalTargets, parseCommaSeparatedList, ensureAgentVersionsInstalled, resolveAgentTargetsAutoInstalling, resolveInstalledAgentTargetsAutoInstalling, VersionNotInstalledError, resolveListFilterOrExit, } from './utils.js';
+import { isPromptCancelled, isInteractiveTerminal, requireInteractiveSelection, promptRemovalTargets, parseCommaSeparatedList, ensureAgentVersionsInstalled, resolveAgentTargetsAutoInstalling, VersionNotInstalledError, resolveListFilterOrExit, } from './utils.js';
 import { showResourceList, buildTargetsSection, } from './resource-view.js';
 /**
  * Parse a comma-separated --agents string into validated agent IDs and
@@ -137,12 +137,12 @@ Examples:
   agents mcp add my-api https://api.example.com --transport http --agents claude
 
   # Apply servers from manifest to specific agents
-  agents mcp register --agents codex@0.116.0
+  agents sync --mcp codex@0.116.0
 
 When to use:
   - After install: 'agents mcp add <server>' to connect a new service
-  - Version upgrade: 'agents mcp register' to sync servers to the new version
-  - Team setup: commit mcp config to .agents and run 'agents mcp register'
+  - Version upgrade: 'agents sync --mcp' to sync servers to the new version
+  - Team setup: commit mcp config to .agents and run 'agents sync --mcp'
 `);
     withAliases(mcpCmd
         .command('list [agent]'), 'list')
@@ -220,7 +220,7 @@ When to use:
     });
     mcpCmd
         .command('add <name> [command_or_url...]')
-        .description('Add an MCP server to the manifest (run "agents mcp register" afterward to apply)')
+        .description('Add an MCP server to the manifest (run "agents sync --mcp" afterward to apply)')
         .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0', capableAgents('mcp').join(','))
         .option('-s, --scope <scope>', 'user (global) or project (repo-specific)', 'user')
         .option('-t, --transport <type>', 'stdio (default) or http', 'stdio')
@@ -336,7 +336,7 @@ Examples:
         writeManifest(localPath, manifest);
         emit('mcp.add', { module: 'mcp', server: name });
         console.log(chalk.green(`Added MCP server '${name}' to manifest`));
-        console.log(chalk.gray('Run: agents mcp register to apply'));
+        console.log(chalk.gray('Run: agents sync --mcp to apply'));
     });
     withAliases(mcpCmd
         .command('remove [name]'), 'remove')
@@ -565,81 +565,6 @@ Examples:
         }
         console.log();
     });
-    // Deprecated: superseded by `agents sync --mcp`. Kept as a warned, functional
-    // alias so old muscle-memory and scripts don't break.
-    mcpCmd
-        .command('register [name]', { hidden: true })
-        .description('Deprecated — use `agents sync --mcp` instead.')
-        .option('-a, --agents <list>', 'Override manifest targets: claude, codex@0.116.0')
-        .option('-y, --yes', 'Auto-install any missing agent versions without prompting')
-        .addHelpText('after', `
-Examples:
-  # Register all servers from manifest
-  agents mcp register
-
-  # Register a specific server
-  agents mcp register notion
-
-  # Register to specific agents (overrides manifest config)
-  agents mcp register --agents codex@0.116.0
-`)
-        .action(async (name, options) => {
-        console.warn(chalk.yellow('`agents mcp register` is deprecated — use `agents sync --mcp` instead:'));
-        console.warn(chalk.gray('  all servers:     agents sync --mcp'));
-        console.warn(chalk.gray('  specific server: agents sync --mcp <name>'));
-        const localPath = getUserAgentsDir();
-        const manifest = readManifest(localPath);
-        if (!manifest?.mcp) {
-            console.log(chalk.yellow('No MCP servers in manifest'));
-            return;
-        }
-        const entries = name
-            ? (() => {
-                const config = manifest.mcp?.[name];
-                return config ? [[name, config]] : [];
-            })()
-            : Object.entries(manifest.mcp);
-        if (entries.length === 0) {
-            console.log(chalk.yellow(`MCP server '${name}' not found in manifest`));
-            return;
-        }
-        for (const [mcpName, config] of entries) {
-            const transport = config.transport || 'stdio';
-            const commandOrUrl = transport === 'http' ? config.url : config.command;
-            if (!commandOrUrl) {
-                console.log(`\n  ${chalk.cyan(mcpName)}: ${chalk.yellow(`missing ${transport === 'http' ? 'url' : 'command'}`)}`);
-                continue;
-            }
-            console.log(`\n  ${chalk.cyan(mcpName)}:`);
-            let targets;
-            if (options.agents) {
-                const resolved = await resolveInstalledAgentTargetsAutoInstalling(options.agents, capableAgents('mcp'), { yes: options.yes });
-                if (!resolved) {
-                    console.log(chalk.gray('  Cancelled.'));
-                    continue;
-                }
-                targets = resolved;
-            }
-            else {
-                targets = resolveConfiguredAgentTargets(config.agents, config.agentVersions, capableAgents('mcp'));
-            }
-            const results = await registerMcpToTargets(targets, mcpName, commandOrUrl, config.scope || 'user', transport, { headers: config.headers });
-            const applied = results.filter(r => r.success).length;
-            for (const result of results) {
-                if (result.success) {
-                    console.log(`    ${chalk.green('+')} ${formatTargetLabel(result.agentId, result.version)}`);
-                }
-                else if (result.error?.startsWith('skipped:')) {
-                    console.log(`    ${chalk.yellow('-')} ${formatTargetLabel(result.agentId, result.version)}: ${result.error}`);
-                }
-                else {
-                    console.log(`    ${chalk.red('x')} ${formatTargetLabel(result.agentId, result.version)}: ${result.error}`);
-                }
-            }
-            if (applied > 0)
-                emit('mcp.register', { module: 'mcp', server: mcpName, applied });
-        }
-    });
 }
 async function installMcpsFromRepoSource(source, options) {
     const spinner = ora('Cloning repository...').start();

package/dist/commands/memory.js

@@ -7,9 +7,9 @@
 import { withAliases } from '../lib/verbs.js';
 import chalk from 'chalk';
 import * as fs from 'fs';
-import { listMemoryFacts, addMemoryFact, removeMemoryFact, readMemoryFact, ensureUserMemoryDir, getUserMemoryDir, syncMemoryToVersionHome, } from '../lib/memory.js';
+import { listMemoryFacts, addMemoryFact, removeMemoryFact, readMemoryFact, getUserMemoryDir, syncMemoryToVersionHome, } from '../lib/memory.js';
 import { capableAgents } from '../lib/capabilities.js';
-import { resolveAgentName, formatAgentError, agentLabel, ALL_AGENT_IDS } from '../lib/agents.js';
+import { ALL_AGENT_IDS } from '../lib/agents.js';
 import { listInstalledVersions, getVersionHomePath, } from '../lib/installations/versions.js';
 import { supports } from '../lib/capabilities.js';
 import { setHelpSections } from '../lib/help.js';
@@ -33,7 +33,7 @@ export function registerMemoryCommands(program) {
       agents memory remove preferred-editor
 
       # Fan out to all capable installed agent versions
-      agents memory sync
+      agents sync --memory
     `,
         notes: `
       Memory is the knowledge store (learned facts), distinct from rules
@@ -84,7 +84,7 @@ export function registerMemoryCommands(program) {
             }
         }
         else {
-            console.log(chalk.gray('  Run: agents memory sync  (or agents sync) to fan out'));
+            console.log(chalk.gray('  Run: agents sync --memory to fan out'));
         }
     });
     withAliases(memoryCmd
@@ -111,49 +111,6 @@ export function registerMemoryCommands(program) {
         console.log(chalk.dim(`# ${fact.name}  [${fact.layer}]  ${fact.path}`));
         console.log(fs.readFileSync(fact.path, 'utf-8'));
     });
-    // Deprecated: superseded by `agents sync --memory`. Kept as a warned, functional
-    // alias so old muscle-memory and scripts don't break.
-    memoryCmd
-        .command('sync [agent]', { hidden: true })
-        .description('Deprecated — use `agents sync --memory` instead.')
-        .option('-a, --agent <agent>', 'Limit to one agent (or agent@version)')
-        .action(async (agentArg, options) => {
-        console.warn(chalk.yellow('`agents memory sync` is deprecated — use `agents sync --memory` instead:'));
-        console.warn(chalk.gray('  all agents:  agents sync --memory'));
-        console.warn(chalk.gray('  one agent:   agents sync --memory <agent>'));
-        ensureUserMemoryDir();
-        const input = agentArg || options.agent;
-        if (input) {
-            const parts = input.split('@');
-            const resolved = resolveAgentName(parts[0]);
-            if (!resolved) {
-                console.error(chalk.red(formatAgentError(parts[0], capableAgents('memory'))));
-                process.exit(1);
-            }
-            const agent = resolved;
-            const versions = parts[1]
-                ? [parts[1]]
-                : listInstalledVersions(agent);
-            if (versions.length === 0) {
-                console.log(chalk.yellow(`No installed versions of ${agentLabel(agent)}`));
-                return;
-            }
-            for (const version of versions) {
-                const home = getVersionHomePath(agent, version);
-                const facts = syncMemoryToVersionHome(agent, home, process.cwd());
-                console.log(chalk.green(`Synced ${facts.length} fact(s) → ${agent}@${version}`));
-            }
-            return;
-        }
-        const results = syncAllMemory(process.cwd());
-        if (results.length === 0) {
-            console.log(chalk.gray('No memory-capable agent versions installed.'));
-            return;
-        }
-        for (const r of results) {
-            console.log(chalk.green(`Synced ${r.facts.length} fact(s) → ${r.agent}@${r.version}`));
-        }
-    });
 }
 function syncAllMemory(cwd) {
     const out = [];

package/dist/commands/message.js

@@ -153,17 +153,17 @@ async function deliverViaHostReroute(route, text, opts) {
  * injected input a running agent consumes, never a notification a human reads.
  * Mirrors SHARED_NOTES in commands/send.ts so an agent reading either --help
  * sees the same three-plane map and doesn't reach for `message` when it means
- * `send`/`notify`.
+ * `send`.
  */
 const CONTROL_PLANE_NOTES = `
   Planes (do not mix them up):
     message / sessions inject  - CONTROL a running agent (mailbox answer, terminal keystroke, or resume by runtime)
-    send / notify              - DELIVER a message to a human recipient over a channel provider
-    feed post                  - RECORD progress / milestones (optional broadcast may call send/notify)
+    send                       - DELIVER a message to a human recipient over a channel provider
+    feed post                  - RECORD progress / milestones (optional broadcast may call send)
 
   <text> here is consumed BY THE TARGET AGENT (an answer, a keystroke, or the
   argument to a resume) -- it is not a notification a person reads on their
-  phone. To reach the operator instead, use \`agents send\` / \`agents notify\`
+  phone. To reach the operator instead, use \`agents send --to owner\`
   (or a feed.broadcast \`channel:\` sink).
 `;
 export function registerMessageCommand(program) {

package/dist/commands/plugins.js

@@ -48,7 +48,7 @@ Examples:
   agents plugins view rush-toolkit
 
   # Sync a plugin to specific agents
-  agents plugins sync rush-toolkit claude
+  agents sync --plugin rush-toolkit claude
 
   # Remove a plugin from all agents and delete its source
   agents plugins remove rush-toolkit
@@ -283,98 +283,6 @@ Examples:
         }
         console.log();
     });
-    // Deprecated: superseded by `agents sync --plugin <name>`. Kept as a warned,
-    // functional alias so old muscle-memory and scripts don't break.
-    pluginsCmd
-        .command('sync <name> [agent]', { hidden: true })
-        .description('Deprecated — use `agents sync --plugin <name>` instead.')
-        .option('--allow-exec-surfaces', 'Enable the plugin even when it ships hooks/, .mcp.json, bin/, scripts/, settings.json, or permissions/')
-        .addHelpText('after', `
-Examples:
-  # Sync a plugin to every installed version of an agent
-  agents plugins sync rush-toolkit claude
-
-  # Sync to one specific version (parity with 'agents sync')
-  agents plugins sync rush-toolkit claude@2.1.142
-
-  # Sync to all supported agents (every installed version of each)
-  agents plugins sync rush-toolkit
-
-  # Re-affirm consent for a hooks-bearing plugin
-  agents plugins sync hivemind claude --allow-exec-surfaces
-`)
-        .action(async (name, agentArg, options) => {
-        console.warn(chalk.yellow('`agents plugins sync` is deprecated — use `agents sync --plugin` instead:'));
-        console.warn(chalk.gray(`  agents sync --plugin ${name}`));
-        const plugin = getPlugin(name);
-        if (!plugin) {
-            console.log(chalk.red(`Plugin '${name}' not found`));
-            process.exit(1);
-        }
-        // Accept the same "agent@version" form as `agents sync`. Splitting here
-        // also means an unknown spec is reported cleanly rather than crashing
-        // isCapable() with a bare "claude@2.1.168".
-        let versionArg;
-        let agentName = agentArg;
-        if (agentArg && agentArg.includes('@')) {
-            const at = agentArg.lastIndexOf('@');
-            agentName = agentArg.slice(0, at);
-            versionArg = agentArg.slice(at + 1);
-        }
-        // Determine target agents
-        let targetAgents;
-        if (agentName) {
-            const agentId = agentName;
-            if (!isCapable(agentId, 'plugins')) {
-                console.log(chalk.red(`Agent '${agentName}' does not support plugins`));
-                process.exit(1);
-            }
-            if (!pluginSupportsAgent(plugin, agentId)) {
-                console.log(chalk.red(`Plugin '${name}' does not support ${agentLabel(agentId)}`));
-                process.exit(1);
-            }
-            targetAgents = [agentId];
-        }
-        else {
-            if (versionArg) {
-                console.log(chalk.red(`A version (@${versionArg}) requires naming the agent, e.g. claude@${versionArg}`));
-                process.exit(1);
-            }
-            targetAgents = capableAgents('plugins').filter(a => pluginSupportsAgent(plugin, a));
-        }
-        const allowExec = options.allowExecSurfaces === true;
-        for (const agentId of targetAgents) {
-            const versions = listInstalledVersions(agentId);
-            if (versions.length === 0)
-                continue;
-            // Default to EVERY installed version. The previous behaviour synced only
-            // the global default, which silently skipped non-default versions used
-            // by balanced rotation -- so a rotated version would lack the plugin's
-            // slash commands. An explicit agent@version narrows back to one.
-            let targetVersions;
-            if (versionArg) {
-                if (!versions.includes(versionArg)) {
-                    console.log(chalk.red(`${agentLabel(agentId)} has no installed version ${versionArg} (installed: ${versions.join(', ')})`));
-                    process.exit(1);
-                }
-                targetVersions = [versionArg];
-            }
-            else {
-                targetVersions = versions;
-            }
-            for (const version of targetVersions) {
-                const didSync = allowExec
-                    ? syncPluginToVersion(plugin, agentId, getVersionHomePath(agentId, version), { allowExecSurfaces: true, version }).success
-                    : syncResourcesToVersion(agentId, version, { plugins: [name] }).plugins.length > 0;
-                if (didSync) {
-                    console.log(chalk.green(`Synced ${name} to ${agentLabel(agentId)}@${version}${allowExec ? ' (exec surfaces enabled)' : ''}`));
-                }
-                else {
-                    console.log(chalk.gray(`${name} already synced to ${agentLabel(agentId)}@${version}`));
-                }
-            }
-        }
-    });
     // agents plugins remove [name]
     withAliases(pluginsCmd
         .command('remove [name]'), 'remove')

package/dist/commands/repo.js

@@ -31,8 +31,6 @@ function resolveRepoPath(target) {
 import { applyExtraAliasToVersions, ensureAgentsDir, getExtraRepoDir, getSystemAgentsDir, getUserAgentsDir, readMeta, resolveExtraRepoDir, updateMeta, } from '../lib/state.js';
 import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo, adoptUserRepoIfNeeded, recordUserRepoRemote, resolveUserRepoRemoteUrl, getRemoteUrl, sameGitRemote, displayHomePath, syncRepoGit, } from '../lib/git.js';
 import { DEFAULT_SYSTEM_REPO } from '../lib/types.js';
-import { ALL_AGENT_IDS, isAgentName, resolveAgentName } from '../lib/agents.js';
-import { refresh } from '../lib/refresh.js';
 import { capableAgents } from '../lib/capabilities.js';
 import { getGlobalDefault, getVersionHomePath, listInstalledVersions } from '../lib/installations/versions.js';
 import { syncAllMarketplaces } from '../lib/plugins/plugin-marketplace.js';
@@ -1230,48 +1228,6 @@ Examples:
             }
         }
     });
-    // Deprecated: superseded by `agents sync`. `agents sync --local` runs the same
-    // reconcile stage (sync-umbrella.ts calls this exact `refresh()`), and `agents
-    // sync <agent>` targets one agent — with the added reach `refresh` lacks
-    // (all installed versions, no silent skip when there is no global default).
-    // Hidden from help; kept as a warned, functional alias so old muscle-memory and
-    // scripts don't break. Migrate callers to `agents sync`.
-    repoCmd
-        .command('refresh [agent]', { hidden: true })
-        .description('Deprecated — use `agents sync` instead.')
-        .option('-y, --yes', 'Auto-sync everything without prompting')
-        .option('--skip-clis', 'Skip CLI version install/upgrade from agents.yaml')
-        .action(async (arg, options) => {
-        console.warn(chalk.yellow('`agents repo refresh` is deprecated — use `agents sync` instead:'));
-        console.warn(chalk.gray('  all agents:  agents sync --local'));
-        console.warn(chalk.gray('  one agent:   agents sync <agent>'));
-        let agentFilter;
-        if (arg) {
-            if (!isAgentName(arg)) {
-                console.log(chalk.red(`Unknown agent "${arg}".`));
-                console.log(chalk.gray(`Available: ${ALL_AGENT_IDS.join(', ')}`));
-                process.exitCode = 1;
-                return;
-            }
-            agentFilter = resolveAgentName(arg);
-        }
-        try {
-            await refresh({
-                agentFilter,
-                skipPrompts: options.yes,
-                skipClis: options.skipClis,
-            });
-            console.log(chalk.green('\nRefresh complete'));
-        }
-        catch (err) {
-            if (isPromptCancelled(err)) {
-                console.log(chalk.yellow('\nCancelled'));
-                return;
-            }
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
     const statusCmd = repoCmd
         .command('status [alias]', { hidden: true })
         .description('Alias of `list` (kept for muscle memory). Add --devices-all to report across the fleet.')

package/dist/commands/resume.js

@@ -8,6 +8,7 @@ import chalk from 'chalk';
 import { resolveSessionMetadataValue } from './sessions.js';
 import { sessionOwnerDevice, consumeResumePinned, RESUME_PINNED_ENV } from '../lib/session/resume-owner.js';
 import { machineId } from '../lib/machine-id.js';
+import { takeOverDetachedSession } from '../lib/session/detached.js';
 const RESUME_SOURCE_ENV = 'AGENTS_RESUME_SOURCE_JSON';
 /** Inspect local archived context after the owner hop fails. Recovery still
  * requires readable content and explicit replay consent before starting a run. */
@@ -161,7 +162,9 @@ export async function runStrictResume(sessionId, prompt, options) {
         }
         return;
     }
-    process.exitCode = await delegateLocalResume(pinnedHere ? resumeLocalFallbackSource(outcome.session) : outcome.session, prompt, options);
+    const localSession = pinnedHere ? resumeLocalFallbackSource(outcome.session) : outcome.session;
+    await takeOverDetachedSession(localSession.id);
+    process.exitCode = await delegateLocalResume(localSession, prompt, options);
 }
 /**
  * Spawn the delegated local `agents run --resume` for a session this box owns