@phnx-labs/agents-cli 1.20.50 → 1.20.51

package/dist/commands/repo.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import { visibleWidth, padVisible } from '../lib/format.js';
 import ora from 'ora';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -26,7 +27,7 @@ function resolveRepoPath(target) {
     return path.join(HOME, `.agents-${trimmed}`);
 }
 import { applyExtraAliasToVersions, ensureAgentsDir, getExtraRepoDir, getSystemAgentsDir, getUserAgentsDir, readMeta, resolveExtraRepoDir, updateMeta, } from '../lib/state.js';
-import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin } from '../lib/git.js';
+import { parseSource, pullRepo, commitAndPush, isGitRepo, isSystemRepoOrigin, adoptRepo } 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';
@@ -218,14 +219,6 @@ async function diffResourceEntries(git, range) {
     }
     return out;
 }
-/** Visible character width of a string with embedded ANSI color codes. */
-function visibleWidth(s) {
-    return s.replace(/\[[0-9;]*m/g, '').length;
-}
-/** Pad string with trailing spaces to a target visible column width. */
-function padVisible(s, width) {
-    return s + ' '.repeat(Math.max(0, width - visibleWidth(s)));
-}
 /**
  * Read one repo's status into structured data: branch, resource-level sync (what
  * a pull/push would move), resource-level local edits, and remote URL + commit.
@@ -752,9 +745,9 @@ export function registerRepoCommands(program) {
         await toggle(alias, false);
     });
     repoCmd
-        .command('pull [alias]')
-        .description('Pull updates. Aliases: "system" (~/.agents/.system/), "user" (~/.agents/), or any registered extra. No arg pulls all.')
-        .action(async (alias) => {
+        .command('pull [alias] [url]')
+        .description('Pull updates. Aliases: "system" (~/.agents/.system/), "user" (~/.agents/), or any registered extra. No arg pulls all. Pass a git URL to git-back a not-yet-cloned user repo: "agents repo pull user <url>".')
+        .action(async (alias, url) => {
         const targets = collectRepoTargets(alias);
         if (!targets) {
             process.exitCode = 1;
@@ -766,8 +759,34 @@ export function registerRepoCommands(program) {
         }
         for (const t of targets) {
             if (!fs.existsSync(t.dir) || !isGitRepo(t.dir)) {
-                console.log(chalk.yellow(`  ${t.alias}: not a git repo, skipping`));
-                continue;
+                // A plain (never-cloned) user repo — setup makes ~/.agents a bare dir and
+                // never git-clones it (state.ts ensureAgentsDir), so a fresh/Windows box
+                // silently falls out of config sync. If a URL was passed, git-back it in
+                // place (keeping local files, backing up any that differ); else guide the
+                // user. Only the USER repo gets this — system is cloned by setup, extras
+                // by `repo add`.
+                if (t.alias === 'user' && url) {
+                    const spinner = ora(`Git-backing ${t.dir} from ${url}...`).start();
+                    const res = await adoptRepo(url, t.dir);
+                    if (!res.success) {
+                        spinner.fail(`user: could not git-back — ${res.error}`);
+                        process.exitCode = 1;
+                        continue;
+                    }
+                    spinner.succeed(`user: git-backed -> ${res.commit}`);
+                    if (res.backedUp.length > 0) {
+                        console.log(chalk.yellow(`  backed up ${res.backedUp.length} locally-modified file(s) to ${res.backupDir}`));
+                        console.log(chalk.gray(`  (${res.backedUp.slice(0, 5).join(', ')}${res.backedUp.length > 5 ? ', …' : ''})`));
+                    }
+                    // Now a git repo — fall through to the normal pull below.
+                }
+                else {
+                    console.log(chalk.yellow(`  ${t.alias}: not a git repo, skipping`));
+                    if (t.alias === 'user') {
+                        console.log(chalk.gray('  git-back it from your config remote: agents repo pull user <git-url>'));
+                    }
+                    continue;
+                }
             }
             if (t.alias === 'system') {
                 // Skip system repo unless explicitly requested

package/dist/commands/resource-view.d.ts

@@ -58,3 +58,4 @@ export declare function resourceLayout(cols: number, o: {
 }): ResourceLayout;
 /** Build the sync targets section showing version pills grouped by agent. */
 export declare function buildTargetsSection(targets: SyncTarget[]): string;
+/** Pad a string to a fixed width, accounting for ANSI escape codes in length calculation. */

package/dist/commands/resource-view.js

@@ -7,6 +7,7 @@
  * filtering, and paging.
  */
 import chalk from 'chalk';
+import { truncate, padVisible } from '../lib/format.js';
 import { agentLabel } from '../lib/agents.js';
 import { itemPicker } from '../lib/picker.js';
 import { isInteractiveTerminal, isPromptCancelled, printWithPager } from './utils.js';
@@ -65,15 +66,15 @@ function filterRows(rows, query) {
 }
 /** Row label rendered inside the picker list. */
 function formatPickerRow(row, opts) {
-    const name = chalk.cyan(padRight(row.name, 22));
+    const name = chalk.cyan(padVisible(row.name, 22));
     const extra = opts.extraLabel
-        ? chalk.gray(padRight(row.extra ?? '-', 10))
+        ? chalk.gray(padVisible(row.extra ?? '-', 10))
         : '';
     const extra2 = opts.extra2Label
-        ? chalk.gray(padRight(row.extra2 ?? '-', 16))
+        ? chalk.gray(padVisible(row.extra2 ?? '-', 16))
         : '';
     const descRaw = row.description ? truncate(row.description, 40) : '';
-    const desc = padRight(chalk.gray(descRaw), 42);
+    const desc = padVisible(chalk.gray(descRaw), 42);
     const sync = formatSyncSummary(row.targets, opts);
     return `${name} ${extra}${extra2}${desc} ${sync}`;
 }
@@ -252,16 +253,3 @@ function formatVersionPill(t) {
     }
 }
 /** Pad a string to a fixed width, accounting for ANSI escape codes in length calculation. */
-function padRight(s, width) {
-    // Strip ANSI for length calc
-    const raw = s.replace(/\x1b\[[0-9;]*m/g, '');
-    if (raw.length >= width)
-        return s;
-    return s + ' '.repeat(width - raw.length);
-}
-/** Truncate a string to a maximum length, appending an ellipsis if needed. */
-function truncate(s, max) {
-    if (s.length <= max)
-        return s;
-    return s.slice(0, max - 1) + '…';
-}

package/dist/commands/secrets.d.ts

@@ -9,6 +9,7 @@ import { type Command } from 'commander';
 import { SSH_TARGET_RE, assertValidSshTarget } from '../lib/ssh-exec.js';
 import { quoteWin32ExecArg } from '../lib/platform/index.js';
 import { type SecretsBundle, type SecretsPolicy } from '../lib/secrets/bundles.js';
+/** Read all available data from stdin synchronously, trimmed. */
 /**
  * Read the raw `.env` text for `import --from <path|->`. A `-` reads the .env
  * from stdin (the SSH push path: `export --host` pipes the resolved dotenv over

package/dist/commands/secrets.js

@@ -7,6 +7,7 @@
  */
 import { Option } from 'commander';
 import chalk from 'chalk';
+import { padVisible, readStdinSync } from '../lib/format.js';
 import { terminalWidth, truncateToWidth, stringWidth } from '../lib/session/width.js';
 import * as fs from 'fs';
 import { SSH_TARGET_RE, assertValidSshTarget, sshExec } from '../lib/ssh-exec.js';
@@ -125,23 +126,6 @@ async function resolveVault(vaultOpt) {
     });
 }
 /** Read all available data from stdin synchronously, trimmed. */
-function readStdinSync() {
-    const chunks = [];
-    const buf = Buffer.alloc(65536);
-    while (true) {
-        let bytesRead;
-        try {
-            bytesRead = fs.readSync(0, buf, 0, buf.length, null);
-        }
-        catch {
-            break;
-        }
-        if (bytesRead === 0)
-            break;
-        chunks.push(Buffer.from(buf.subarray(0, bytesRead)));
-    }
-    return Buffer.concat(chunks).toString('utf-8').trim();
-}
 /**
  * Read the raw `.env` text for `import --from <path|->`. A `-` reads the .env
  * from stdin (the SSH push path: `export --host` pipes the resolved dotenv over
@@ -257,17 +241,6 @@ async function browseRemote(targets, args, tty) {
         process.exit(1);
 }
 /** Strip ANSI escape sequences so padding can be computed on visible width. */
-function visibleWidth(s) {
-    // eslint-disable-next-line no-control-regex
-    return s.replace(/\x1b\[[0-9;]*m/g, '').length;
-}
-/** padEnd that respects ANSI color codes (chalk-wrapped strings have invisible bytes). */
-function padVisible(s, n) {
-    const w = visibleWidth(s);
-    if (w >= n)
-        return s;
-    return s + ' '.repeat(n - w);
-}
 /** Render an ISO-8601 timestamp as a compact relative age: "now", "5m", "1h", "3d", "2w", "4mo", "1y". */
 function relativeAge(iso) {
     const t = Date.parse(iso);

package/dist/commands/sessions-picker.js

@@ -7,6 +7,7 @@
  */
 import fs from 'node:fs';
 import chalk from 'chalk';
+import { truncate, humanDuration } from '../lib/format.js';
 import { parseSession, sanitizeForTerminal } from '../lib/session/parse.js';
 import { cleanSessionPrompt, extractSessionTopic } from '../lib/session/prompt.js';
 import { linkPath, relativeToCwd } from '../lib/session/render.js';
@@ -154,21 +155,6 @@ function extractTiming(events) {
     const dur = Number.isNaN(lastMs) ? undefined : humanDuration(Math.max(0, lastMs - firstMs));
     return { startedAgo: ago, duration: dur };
 }
-function humanDuration(ms) {
-    const s = Math.floor(ms / 1000);
-    if (s < 60)
-        return `${s}s`;
-    const m = Math.floor(s / 60);
-    if (m < 60)
-        return `${m}m`;
-    const h = Math.floor(m / 60);
-    const mm = m % 60;
-    if (h < 24)
-        return mm ? `${h}h ${mm}m` : `${h}h`;
-    const d = Math.floor(h / 24);
-    const hh = h % 24;
-    return hh ? `${d}d ${hh}h` : `${d}d`;
-}
 function countMessages(events) {
     return events.filter(e => e.type === 'message').length;
 }
@@ -364,9 +350,6 @@ function renderTodos(todos, termWidth) {
     }
     return out;
 }
-function truncate(s, max) {
-    return s.length > max ? s.slice(0, max - 1) + '…' : s;
-}
 /** Show an interactive session picker and return the selected session with its action (resume or view). */
 export async function sessionPicker(config) {
     const picked = await itemPicker({

package/dist/commands/sessions.js

@@ -12,6 +12,7 @@ import * as os from 'os';
 import * as path from 'path';
 import { spawn } from 'child_process';
 import chalk from 'chalk';
+import { truncate, padRight } from '../lib/format.js';
 import ora from 'ora';
 import { SESSION_AGENTS } from '../lib/session/types.js';
 import { discoverArtifacts, readArtifact, resolveArtifact } from '../lib/session/artifacts.js';
@@ -1349,8 +1350,11 @@ async function renderSession(session, mode, filters, options = {}) {
         process.stdout.write(renderMarkdown(renderConversationMarkdown(events, { redact: options.noRedact !== true })));
         return;
     }
-    // json — no header, raw events only (pipeable)
-    process.stdout.write(renderJson(events));
+    // json — normalized events plus the durable session signals from the state
+    // engine (plan text, PR, worktree, ticket). Pre-1.20.51 emitted a bare event
+    // array; consumers that JSON.parse this now read `output.events` for the
+    // array. See issue #743 (plan surfaced) and CHANGELOG for the shape change.
+    process.stdout.write(renderJson(events, session));
 }
 function renderTopicCell(label, topic, query, visibleWidth, paddedWidth) {
     const lbl = (label ?? '').trim();
@@ -2289,9 +2293,3 @@ function formatAbsoluteTime(isoTimestamp) {
     const mm = String(d.getMinutes()).padStart(2, '0');
     return `${months[d.getMonth()]} ${d.getDate()} ${hh}:${mm}`;
 }
-function padRight(s, width) {
-    return s.length >= width ? s : s + ' '.repeat(width - s.length);
-}
-function truncate(s, max) {
-    return s.length > max ? s.slice(0, max - 1) + '.' : s;
-}

package/dist/commands/teams-picker.js

@@ -7,6 +7,7 @@
  * activity for each team.
  */
 import chalk from 'chalk';
+import { relTime, truncate, humanDuration } from '../lib/format.js';
 import { itemPicker } from '../lib/picker.js';
 const AGENT_LABEL = {
     claude: 'Claude',
@@ -26,23 +27,6 @@ function statusColor(status) {
         default: return chalk.white;
     }
 }
-function relTime(iso) {
-    const secs = Math.floor((Date.now() - new Date(iso).getTime()) / 1000);
-    if (secs < 10)
-        return 'just now';
-    if (secs < 60)
-        return `${secs}s ago`;
-    if (secs < 3600)
-        return `${Math.floor(secs / 60)}m ago`;
-    if (secs < 86400)
-        return `${Math.floor(secs / 3600)}h ago`;
-    return `${Math.floor(secs / 86400)}d ago`;
-}
-function truncate(s, n) {
-    if (s.length <= n)
-        return s;
-    return s.slice(0, n - 1) + '…';
-}
 function firstLine(s) {
     // Collapse to the first non-empty line so multi-line messages (markdown,
     // code blocks) render cleanly inside a one-line preview slot.
@@ -120,21 +104,6 @@ function formatComposition(agents) {
         .map(([type, n]) => (n === 1 ? type : `${type}×${n}`));
     return parts.join(' ');
 }
-function humanDuration(ms) {
-    const s = Math.floor(ms / 1000);
-    if (s < 60)
-        return `${s}s`;
-    const m = Math.floor(s / 60);
-    if (m < 60)
-        return `${m}m`;
-    const h = Math.floor(m / 60);
-    const mm = m % 60;
-    if (h < 24)
-        return mm ? `${h}h${mm}m` : `${h}h`;
-    const d = Math.floor(h / 24);
-    const hh = h % 24;
-    return hh ? `${d}d${hh}h` : `${d}d`;
-}
 function runtimeSpan(t) {
     const startMs = new Date(t.created_at).getTime();
     const endMs = new Date(t.modified_at).getTime();

package/dist/commands/teams.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import { die, relTime, truncate, isJsonMode, padRight } from '../lib/format.js';
 import * as fs from 'fs/promises';
 import { addHostOption } from '../lib/hosts/option.js';
 import * as path from 'path';
@@ -48,13 +49,6 @@ const VALID_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max', 'auto'];
 const VALID_CLOUD_PROVIDERS = ['rush', 'codex', 'factory'];
 // Auto-enable JSON mode when piped / not a TTY so AI agent consumers get
 // parseable output by default.
-function isJsonMode(opts) {
-    return Boolean(opts.json) || !process.stdout.isTTY;
-}
-function die(msg, code = 1) {
-    console.error(chalk.red(msg));
-    process.exit(code);
-}
 function statusColor(status) {
     switch (status) {
         case 'pending': return chalk.blue;
@@ -65,23 +59,6 @@ function statusColor(status) {
         default: return chalk.white;
     }
 }
-function relTime(iso) {
-    const secs = Math.floor((Date.now() - new Date(iso).getTime()) / 1000);
-    if (secs < 10)
-        return 'just now';
-    if (secs < 60)
-        return `${secs}s ago`;
-    if (secs < 3600)
-        return `${Math.floor(secs / 60)}m ago`;
-    if (secs < 86400)
-        return `${Math.floor(secs / 3600)}h ago`;
-    return `${Math.floor(secs / 86400)}d ago`;
-}
-function truncate(s, n) {
-    if (s.length <= n)
-        return s;
-    return s.slice(0, n - 1) + '…';
-}
 function compactPrompt(s, n = 160) {
     return truncate(s.replace(/\s+/g, ' ').trim(), n);
 }
@@ -98,9 +75,6 @@ function formatTimestamp(iso) {
         minute: '2-digit',
     });
 }
-function padRight(s, width) {
-    return s.length >= width ? s : s + ' '.repeat(width - s.length);
-}
 function fullName(type, version) {
     const name = AGENT_NAMES[type];
     return version ? `${name} ${version}` : name;

package/dist/commands/tmux.js

@@ -21,6 +21,7 @@
  *   agents tmux kill-all       [--yes]
  */
 import chalk from 'chalk';
+import { truncate } from '../lib/format.js';
 import * as path from 'path';
 import { setHelpSections } from '../lib/help.js';
 import { assertTmuxAvailable, attachTmux, capturePane, createSession, getDefaultSocketPath, getTmuxVersion, hasSession, isTmuxInstalled, killAll, killSession, listSessions, readSessionMeta, sendKeys, splitPane, TmuxCommandError, TmuxSessionError, TmuxUnavailableError, } from '../lib/tmux/index.js';
@@ -395,9 +396,6 @@ function formatAge(secs) {
     const h = Math.floor(m / 60);
     return `${h}h ${m % 60}m`;
 }
-function truncate(s, n) {
-    return s.length > n ? `${s.slice(0, n - 1)}…` : s;
-}
 function printMeta(m) {
     console.log(`  ${chalk.bold('name')}       ${m.name}`);
     console.log(`  ${chalk.bold('socket')}     ${m.socket}`);

package/dist/commands/view.js

@@ -1,5 +1,6 @@
 import { addHostOption } from '../lib/hosts/option.js';
 import chalk from 'chalk';
+import { visibleWidth, termLink } from '../lib/format.js';
 import ora from 'ora';
 import * as fs from 'fs';
 import * as path from 'path';
@@ -67,12 +68,6 @@ function profileKindAndModel(model, planWidth) {
     const kind = 'profile'.padEnd(Math.max(planWidth, 'profile'.length));
     return `${kind}  ${model}`;
 }
-function termLink(text, filePath) {
-    if (!process.stdout.isTTY)
-        return text;
-    const url = `file://${filePath}`;
-    return `\x1b]8;;${url}\x1b\\${text}\x1b]8;;\x1b\\`;
-}
 /**
  * Resolve a resource path to something the IDE can open inline. When `p` is a
  * directory, OSC 8 file:// links cause IDEs (Cursor/VS Code) to open it as a
@@ -112,9 +107,6 @@ function formatLastActive(date) {
         return chalk.gray(`${days}d ago`);
     return chalk.gray(`${days}d ago`);
 }
-function visibleWidth(s) {
-    return s.replace(/\u001b\[[0-9;]*m/g, '').length;
-}
 function compareVersions(a, b) {
     const partsA = a.split('.').map(Number);
     const partsB = b.split('.').map(Number);

package/dist/commands/worktree.js

@@ -1,4 +1,5 @@
 import chalk from 'chalk';
+import { die } from '../lib/format.js';
 import { execFile } from 'child_process';
 import { promisify } from 'util';
 import * as fs from 'fs/promises';
@@ -8,10 +9,6 @@ import { setHelpSections } from '../lib/help.js';
 const execFileAsync = promisify(execFile);
 const WORKTREE_SUBDIR = path.join('.agents', 'worktrees');
 const BRANCH_PREFIX = 'agents/';
-function die(msg, code = 1) {
-    console.error(chalk.red(msg));
-    process.exit(code);
-}
 function isValidTerminalId(id) {
     // Allow letters, digits, dot, dash, underscore. Reject anything else so a
     // hostile or buggy caller can't inject path traversal or shell metachars.

package/dist/lib/agents.d.ts

@@ -52,8 +52,6 @@ export declare function getCliPath(agentId: AgentId): Promise<string | null>;
 export declare function getCliState(agentId: AgentId): Promise<CliState>;
 /** Resolve CLI state for all registered agents in parallel. */
 export declare function getAllCliStates(): Promise<Partial<Record<AgentId, CliState>>>;
-/** Check whether the agent's config directory exists on disk. */
-export declare function isConfigured(agentId: AgentId): boolean;
 /** Info about an existing unmanaged agent installation. */
 export interface UnmanagedInstall {
     agentId: AgentId;
@@ -128,8 +126,6 @@ export declare function resolveLastActive(agentId: AgentId, base: string, config
  * Used during init to show approximate session count to user.
  */
 export declare function countSessionFiles(agentId: AgentId): number;
-/** Check whether a named MCP server is registered with the agent's CLI. */
-export declare function isMcpRegistered(agentId: AgentId, mcpName: string): Promise<boolean>;
 /** Register an MCP server with an agent's CLI via `mcp add`. */
 export declare function registerMcp(agentId: AgentId, name: string, command: string, scope?: 'user' | 'project', transport?: string, options?: {
     home?: string;

package/dist/lib/agents.js

@@ -21,6 +21,7 @@ import { latestFileMtimeMs } from './fs-walk.js';
 import { damerauLevenshtein } from './fuzzy.js';
 import { getCacheDir, getVersionsDir, getShimsDir, getCliVersionCachePath } from './state.js';
 import { resolveVersion, getVersionHomePath, getBinaryPath } from './versions.js';
+import { supports } from './capabilities.js';
 const execFileAsync = promisify(execFile);
 const HOME = os.homedir();
 /**
@@ -212,7 +213,7 @@ export const AGENTS = {
         // Claude Code has no headless Anthropic-hosted dispatch CLI (only
         // --remote-control, which bridges a *local* session). Its cloud is Rush.
         cloudProvider: 'rush',
-        capabilities: { hooks: true, mcp: true, allowlist: true, skills: true, commands: true, plugins: true, subagents: true, rules: { file: 'CLAUDE.md' }, workflows: true, modes: ['plan', 'edit', 'auto', 'skip'], rulesImports: true },
+        capabilities: { hooks: true, mcp: true, mcpHttp: true, mcpHeaders: true, allowlist: true, skills: true, commands: true, plugins: true, subagents: true, rules: { file: 'CLAUDE.md' }, workflows: true, modes: ['plan', 'edit', 'auto', 'skip'], rulesImports: true },
     },
     // codex hooks: gated to >= 0.116.0 (introduced [features] codex_hooks flag).
     codex: {
@@ -232,7 +233,7 @@ export const AGENTS = {
         variableSyntax: '$ARGUMENTS',
         supportsHooks: true,
         cloudProvider: 'codex',
-        capabilities: { hooks: { since: '0.116.0' }, mcp: true, allowlist: false, skills: true, commands: { until: '0.117.0' }, plugins: { since: '0.128.0' }, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit', 'skip'] },
+        capabilities: { hooks: { since: '0.116.0' }, mcp: true, mcpHttp: true, mcpHeaders: false, allowlist: false, skills: true, commands: { until: '0.117.0' }, plugins: { since: '0.128.0' }, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit', 'skip'] },
     },
     gemini: {
         id: 'gemini',
@@ -261,7 +262,7 @@ export const AGENTS = {
             url: 'https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/',
         },
         // gemini hooks: shipped in v0.26.0 (Jan 2026); older binaries silently ignore the `hooks` key.
-        capabilities: { hooks: { since: '0.26.0' }, mcp: true, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'GEMINI.md' }, workflows: false, modes: ['plan', 'edit', 'skip'], rulesImports: true },
+        capabilities: { hooks: { since: '0.26.0' }, mcp: true, mcpHttp: true, mcpHeaders: false, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'GEMINI.md' }, workflows: false, modes: ['plan', 'edit', 'skip'], rulesImports: true },
     },
     cursor: {
         id: 'cursor',
@@ -279,7 +280,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '$ARGUMENTS',
         supportsHooks: false,
-        capabilities: { hooks: false, mcp: true, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: '.cursorrules' }, workflows: false, modes: ['edit', 'skip'] },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: '.cursorrules' }, workflows: false, modes: ['edit', 'skip'] },
     },
     opencode: {
         id: 'opencode',
@@ -296,7 +297,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '$ARGUMENTS',
         supportsHooks: false,
-        capabilities: { hooks: false, mcp: true, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit'] },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit'] },
     },
     openclaw: {
         id: 'openclaw',
@@ -314,7 +315,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '{{ARGUMENTS}}',
         supportsHooks: true,
-        capabilities: { hooks: true, mcp: true, allowlist: false, skills: true, commands: false, plugins: true, subagents: true, rules: { file: 'workspace/AGENTS.md' }, workflows: false, modes: ['plan', 'edit', 'skip'] },
+        capabilities: { hooks: true, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: true, commands: false, plugins: true, subagents: true, rules: { file: 'workspace/AGENTS.md' }, workflows: false, modes: ['plan', 'edit', 'skip'] },
     },
     copilot: {
         id: 'copilot',
@@ -336,7 +337,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '$ARGUMENTS',
         supportsHooks: false,
-        capabilities: { hooks: false, mcp: true, allowlist: false, skills: true, commands: true, plugins: true, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit', 'auto', 'skip'] },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: true, commands: true, plugins: true, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit', 'auto', 'skip'] },
     },
     amp: {
         id: 'amp',
@@ -353,7 +354,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '$ARGUMENTS',
         supportsHooks: false,
-        capabilities: { hooks: false, mcp: true, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit'] },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['plan', 'edit'] },
     },
     kiro: {
         id: 'kiro',
@@ -371,7 +372,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '$ARGUMENTS',
         supportsHooks: false,
-        capabilities: { hooks: false, mcp: true, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['edit'] },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: true, commands: true, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['edit'] },
     },
     goose: {
         id: 'goose',
@@ -389,7 +390,7 @@ export const AGENTS = {
         format: 'markdown',
         variableSyntax: '$ARGUMENTS',
         supportsHooks: false,
-        capabilities: { hooks: false, mcp: true, allowlist: false, skills: false, commands: false, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['edit'] },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: false, skills: false, commands: false, plugins: false, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['edit'] },
     },
     // Google Antigravity CLI (`agy`) — official replacement for Gemini CLI as of IO 2026.
     // configDir nests inside `~/.gemini/` since agy shares the parent dir with the Gemini
@@ -418,7 +419,7 @@ export const AGENTS = {
         variableSyntax: '{{args}}',
         supportsHooks: true,
         cloudProvider: 'antigravity',
-        capabilities: { hooks: true, mcp: true, allowlist: true, skills: true, commands: true, plugins: true, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['edit', 'skip'], rulesImports: false },
+        capabilities: { hooks: true, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: true, skills: true, commands: true, plugins: true, subagents: false, rules: { file: 'AGENTS.md' }, workflows: false, modes: ['edit', 'skip'], rulesImports: false },
     },
     // xAI Grok Build CLI (`grok`) — early beta, SuperGrok Heavy. Auth via OAuth on
     // first launch, or XAI_API_KEY env var for headless. MCP servers configured inline
@@ -445,6 +446,8 @@ export const AGENTS = {
         capabilities: {
             hooks: true,
             mcp: true,
+            mcpHttp: false,
+            mcpHeaders: false,
             allowlist: true, // maps to Grok's granular Bash/Edit/Write/Read/Grep/WebFetch/MCPTool rules
             skills: true,
             commands: false, // covered by skills
@@ -481,6 +484,8 @@ export const AGENTS = {
         capabilities: {
             hooks: true,
             mcp: true,
+            mcpHttp: false,
+            mcpHeaders: false,
             allowlist: true,
             skills: true,
             commands: false,
@@ -540,6 +545,8 @@ export const AGENTS = {
         capabilities: {
             hooks: true,
             mcp: true,
+            mcpHttp: false,
+            mcpHeaders: false,
             allowlist: false,
             skills: false,
             commands: true,
@@ -708,11 +715,6 @@ export async function getAllCliStates() {
     }
     return states;
 }
-/** Check whether the agent's config directory exists on disk. */
-export function isConfigured(agentId) {
-    const agent = AGENTS[agentId];
-    return fs.existsSync(agent.configDir);
-}
 /**
  * Agents that `agents setup` probes for pre-existing native installations
  * (i.e., a config dir present before agents-cli took over). Add an agent here
@@ -1310,31 +1312,16 @@ function buildIdentityKey(agentId, parts) {
         return null;
     return `${agentId}:${encoded.join(':')}`;
 }
-/** Check whether a named MCP server is registered with the agent's CLI. */
-export async function isMcpRegistered(agentId, mcpName) {
-    const agent = AGENTS[agentId];
-    if (!agent.capabilities.mcp || !(await isCliInstalled(agentId))) {
-        return false;
-    }
-    try {
-        const { stdout } = await execFileAsync(agent.cliCommand, ['mcp', 'list']);
-        return stdout.toLowerCase().includes(mcpName.toLowerCase());
-    }
-    catch {
-        /* mcp list command failed */
-        return false;
-    }
-}
 /** Register an MCP server with an agent's CLI via `mcp add`. */
 export async function registerMcp(agentId, name, command, scope = 'user', transport = 'stdio', options) {
     const agent = AGENTS[agentId];
     if (!agent.capabilities.mcp) {
         return { success: false, error: 'Agent does not support MCP' };
     }
-    if (transport === 'http' && agentId !== 'claude' && agentId !== 'codex' && agentId !== 'gemini') {
+    if (transport === 'http' && !supports(agentId, 'mcpHttp').ok) {
         return { success: false, error: 'skipped: agent does not support HTTP MCP registration' };
     }
-    if (transport === 'http' && options?.headers && Object.keys(options.headers).length > 0 && agentId !== 'claude') {
+    if (transport === 'http' && options?.headers && Object.keys(options.headers).length > 0 && !supports(agentId, 'mcpHeaders').ok) {
         return { success: false, error: 'skipped: HTTP MCP headers are only supported for Claude registration' };
     }
     if (!options?.binary && !(await isCliInstalled(agentId))) {

package/dist/lib/auto-dispatch-linear.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Concrete Linear gateway for auto-dispatch.
+ *
+ * Talks to the Linear GraphQL API. The API key is read from the LINEAR_API_KEY
+ * env var, falling back to the macOS keychain generic-password `linear-api-key`
+ * (how the rest of the stack stores it). If no key is resolvable, the gateway is
+ * absent and the daemon skips auto-dispatch entirely.
+ *
+ * "Started" (Doing) and "unstarted" (Todo) are Linear state *types*, so we never
+ * hardcode a team's custom state names. `startIssue` resolves the team's first
+ * started-type state (cached per team) and moves the issue there — the existing
+ * factory webhook turns that transition into a real run.
+ */
+import type { LinearGateway } from './auto-dispatch.js';
+/** Resolve the Linear API key from env or (on macOS) the keychain. Null if absent. */
+export declare function resolveLinearApiKey(): string | null;
+/** Build a real Linear gateway, or null when no API key is configured. */
+export declare function createLinearGateway(): LinearGateway | null;