@phnx-labs/agents-cli 1.22.34 → 1.22.37

package/dist/commands/open.js

@@ -0,0 +1,57 @@
+import chalk from 'chalk';
+import { parseAgentsUrl } from '../lib/deeplink/url.js';
+import { registerAgentsUrlScheme, unregisterAgentsUrlScheme, agentsUrlSchemeStatus, } from '../lib/deeplink/register.js';
+export function registerOpenCommand(program) {
+    const open = program
+        .command('open [url]')
+        .description('Resume a session from an agents:// deep link, or register/unregister/status the OS URL-scheme handler.')
+        .action(async (url) => {
+        if (!url) {
+            open.help();
+            return;
+        }
+        await handleUrl(url);
+    });
+    open
+        .command('register')
+        .description('Register the agents:// URL scheme with the OS so artifact links resume sessions (idempotent).')
+        .action(() => {
+        const status = registerAgentsUrlScheme();
+        if (status.registered) {
+            console.log(chalk.green('agents:// scheme registered.') + chalk.gray(` ${status.detail}`));
+        }
+        else {
+            console.log(chalk.yellow('Could not register the agents:// scheme.') + chalk.gray(` ${status.detail}`));
+            process.exitCode = 1;
+        }
+    });
+    open
+        .command('unregister')
+        .description('Remove the agents:// URL scheme handler.')
+        .action(() => {
+        const status = unregisterAgentsUrlScheme();
+        console.log(chalk.gray(status.detail));
+    });
+    open
+        .command('status')
+        .description('Report whether the agents:// URL scheme handler is registered.')
+        .action(() => {
+        const status = agentsUrlSchemeStatus();
+        const label = status.registered ? chalk.green('registered') : chalk.yellow('not registered');
+        console.log(`agents:// handler: ${label} ${chalk.gray(`(${status.platform})`)}`);
+        console.log(chalk.gray(`  ${status.detail}`));
+        if (!status.registered)
+            process.exitCode = 1;
+    });
+}
+async function handleUrl(url) {
+    const parsed = parseAgentsUrl(url);
+    if ('error' in parsed) {
+        console.error(chalk.red(`Not a valid agents:// link: ${parsed.error}`));
+        process.exitCode = 2;
+        return;
+    }
+    // Lazy-import the resume dispatcher so `register`/`status` stay cold-start cheap.
+    const { dispatchSessionLifecycleInPlace } = await import('./sessions-resume.js');
+    await dispatchSessionLifecycleInPlace(parsed.id, parsed.host ? [parsed.host] : []);
+}

package/dist/commands/packages.js

@@ -6,15 +6,13 @@
  * hooks from configured registries or GitHub sources.
  */
 import * as fs from 'fs';
-import * as path from 'path';
 import chalk from 'chalk';
 import ora from 'ora';
-import { getAgentsDir, getEnabledExtraRepos } from '../lib/state.js';
 import { AGENTS, getAllCliStates, agentLabel, } from '../lib/agents.js';
 import { capableAgents } from '../lib/capabilities.js';
 import { DEFAULT_REGISTRIES } from '../lib/types.js';
-import { getRegistries, setRegistry, removeRegistry, search as searchRegistries, resolvePackage, validatedNpmSpec, validatedPyPISpec, buildSkillIndex, verifySkillIntegrity, parseOwnerRepoFromRemote, } from '../lib/registry.js';
-import { cloneRepo, commitAndPush, getCurrentBranch, getRemoteUrl, isGitRepo } from '../lib/git.js';
+import { getRegistries, setRegistry, removeRegistry, search as searchRegistries, resolvePackage, validatedNpmSpec, validatedPyPISpec, verifySkillIntegrity, } from '../lib/registry.js';
+import { cloneRepo } from '../lib/git.js';
 import { discoverCommands, resolveCommandSource, installCommand, installCommandCentrally, } from '../lib/commands.js';
 import { discoverSkillsFromRepo, installSkill, installSkillCentrally, } from '../lib/skills.js';
 import { discoverHooksFromRepo, installHooks, installHooksCentrally, } from '../lib/hooks.js';
@@ -328,109 +326,6 @@ When to use:
         }
     });
     // ==========================================================================
-    // PUBLISH COMMAND (self-hosted, git-index skill registry)
-    // ==========================================================================
-    program
-        .command('publish')
-        .description('Generate a skills-index.json for a git repo and push it, making its skills discoverable via agents search/install')
-        .option('--repo <alias>', 'Publish an extra repo added via `agents repo add` (default: your ~/.agents repo)')
-        .option('--name <name>', 'Registry name to suggest in the output (default: the repo name)')
-        .option('--branch <branch>', 'Branch to push the index to and reference in the raw URL (default: the repo\'s current branch)')
-        .option('--dry-run', 'Write the index and print the URL without committing or pushing')
-        .addHelpText('after', `
-Publish walks a repo's skills/ directory, records a sha256 of every SKILL.md,
-and writes skills-index.json at the repo root — a flat index that 'agents search'
-and 'agents install' can consume directly from raw.githubusercontent.com. No
-hosted infrastructure: the index is just a file committed to your GitHub repo.
-
-Examples:
-  # Publish your ~/.agents repo's skills
-  agents publish
-
-  # Publish an extra repo added via 'agents repo add'
-  agents publish --repo team-skills
-
-  # Preview the index without pushing
-  agents publish --dry-run
-
-After publishing, share the printed 'agents registry add skill ...' command so
-others can search and install your skills. Installs verify each SKILL.md against
-the sha256 in the index and abort on mismatch.
-`)
-        .action(async (options) => {
-        // Resolve the target repo: an extra repo by alias, else the primary ~/.agents repo.
-        let repoDir;
-        if (options.repo) {
-            const extra = getEnabledExtraRepos().find((r) => r.alias === options.repo);
-            if (!extra) {
-                console.log(chalk.red(`No enabled extra repo aliased '${options.repo}'.`));
-                console.log(chalk.gray('Add one with: agents repo add <source> --as <alias>'));
-                process.exit(1);
-            }
-            repoDir = extra.dir;
-        }
-        else {
-            repoDir = getAgentsDir();
-        }
-        if (!isGitRepo(repoDir)) {
-            console.log(chalk.red(`${repoDir} is not a git repository.`));
-            console.log(chalk.gray('publish commits + pushes the index, so the repo needs a GitHub remote.'));
-            process.exit(1);
-        }
-        const remoteUrl = await getRemoteUrl(repoDir);
-        const repoSlug = remoteUrl ? parseOwnerRepoFromRemote(remoteUrl) : null;
-        if (!repoSlug) {
-            console.log(chalk.red(`Could not resolve an 'owner/repo' from the git remote of ${repoDir}.`));
-            console.log(chalk.gray(`  Remote: ${remoteUrl || '(none)'} — publish needs a GitHub origin.`));
-            process.exit(1);
-        }
-        const spinner = ora('Building skills index...').start();
-        const index = buildSkillIndex(repoDir, repoSlug, { generatedAt: new Date().toISOString() });
-        spinner.stop();
-        if (index.skills.length === 0) {
-            console.log(chalk.yellow(`No skills found under ${repoDir}/skills.`));
-            console.log(chalk.gray('Add a skill (a directory with a SKILL.md) and re-run publish.'));
-            process.exit(1);
-        }
-        const indexPath = path.join(repoDir, 'skills-index.json');
-        fs.writeFileSync(indexPath, JSON.stringify(index, null, 2) + '\n', 'utf-8');
-        console.log(chalk.bold(`\nIndexed ${index.skills.length} skill(s) into skills-index.json:`));
-        for (const s of index.skills) {
-            console.log(`  ${chalk.cyan(s.name)} ${chalk.gray(`sha256:${s.sha256?.slice(0, 12)}…`)}`);
-        }
-        // The branch the URL references must be the branch the index actually
-        // lands on. In a real push that's whatever commitAndPush reports back
-        // (the requested --branch, else the checked-out branch); in a dry run we
-        // resolve it the same way without pushing.
-        let urlBranch;
-        if (options.dryRun) {
-            urlBranch = options.branch || (await getCurrentBranch(repoDir));
-            console.log(chalk.gray(`\nDry run — wrote ${indexPath} but did not commit or push.`));
-        }
-        else {
-            const pushSpinner = ora('Committing and pushing skills-index.json...').start();
-            const result = await commitAndPush(repoDir, 'chore: update skills-index.json (agents publish)', options.branch);
-            if (!result.success) {
-                pushSpinner.fail(`Push failed: ${result.error}`);
-                console.log(chalk.gray('The index was written locally — commit and push it manually to publish.'));
-                process.exit(1);
-            }
-            // commitAndPush always reports the pushed branch on success; the `??`
-            // only satisfies the optional return type, it is not a behavior path.
-            urlBranch = result.branch ?? (await getCurrentBranch(repoDir));
-            pushSpinner.succeed(`Pushed skills-index.json to ${urlBranch}`);
-        }
-        const rawUrl = `https://raw.githubusercontent.com/${repoSlug}/${urlBranch}/skills-index.json`;
-        const registryName = options.name || repoSlug.split('/')[1] || 'my-skills';
-        console.log(chalk.bold('\nPublished. Share these with anyone who wants your skills:\n'));
-        console.log(chalk.gray('  Index URL:'));
-        console.log(`    ${rawUrl}`);
-        console.log(chalk.gray('\n  Register + search + install:'));
-        console.log(`    ${chalk.green(`agents registry add skill ${registryName} ${rawUrl}`)}`);
-        console.log(`    ${chalk.green(`agents search ${index.skills[0].name} --type skill`)}`);
-        console.log(`    ${chalk.green(`agents install skill:${index.skills[0].name} --agents claude,codex,cursor`)}`);
-    });
-    // ==========================================================================
     // INSTALL COMMAND (unified package installation)
     // ==========================================================================
     program

package/dist/commands/plugins.js

@@ -282,10 +282,11 @@ Examples:
         }
         console.log();
     });
-    // agents plugins sync <name> [agent]
+    // 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]')
-        .description('Apply a plugin to an agent. Syncs every installed version (pass agent@version to target one).')
+        .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:
@@ -302,6 +303,8 @@ Examples:
   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`));

package/dist/commands/profiles.d.ts

@@ -25,6 +25,7 @@ export interface AddProfileOptions {
     model?: string;
     baseUrl?: string;
     authProvider?: string;
+    account?: string;
     version?: string;
     keyStdin?: boolean;
     force?: boolean;

package/dist/commands/profiles.js

@@ -16,9 +16,8 @@ import { parseBundleValue, secretsKeychainItem } from '../lib/secrets/index.js';
 import { readBundle } from '../lib/secrets/bundles.js';
 import { isInteractiveTerminal } from './utils.js';
 import { getAgentsInvocation } from '../lib/daemon.js';
-import { getActiveResourceProfileName, getResourceProfilePreset, listResourceProfileNames, setActiveResourceProfile, upsertResourceProfilePreset, validateResourceProfileName, } from '../lib/resource-profiles.js';
-import { AGENTS, ALL_AGENT_IDS } from '../lib/agents.js';
-import { listInstalledVersions, syncResourcesToVersion } from '../lib/versions.js';
+import { ALL_AGENT_IDS } from '../lib/agents.js';
+import { findAccount } from '../lib/account-registry.js';
 /**
  * Pure helper: builds a Profile from collected wizard inputs. Extracted so the
  * shape of preset->profile mapping for the `create` wizard is unit-testable
@@ -159,6 +158,9 @@ export async function applyFromSecrets(profile, spec, explicitAuthProvider, opts
  */
 export async function addProfile(name, opts, label = 'Profile') {
     validateProfileName(name);
+    const account = opts.account ? findAccount(opts.account) : null;
+    if (opts.account && !account)
+        throw new Error(`Unknown account '${opts.account}'.`);
     if (profileExists(name) && !opts.force) {
         throw new Error(`${label} '${name}' already exists. Use --force to overwrite.`);
     }
@@ -190,6 +192,10 @@ export async function addProfile(name, opts, label = 'Profile') {
             provider: opts.authProvider,
             authEnvVar,
         });
+        if (account) {
+            profile.account = account.id;
+            profile.provider = account.provider;
+        }
         if (opts.fromSecrets)
             await applyFromSecrets(profile, opts.fromSecrets, opts.authProvider);
         writeProfile(profile);
@@ -204,10 +210,14 @@ export async function addProfile(name, opts, label = 'Profile') {
         throw new Error(`No preset '${presetName}'.\nAvailable presets: ${listPresets().map((p) => p.name).join(', ')}\n` +
             'Or build a custom harness: --host <agent> --model <id>.');
     }
-    if (!opts.fromSecrets && !preset.authOptional) {
+    if (!account && !opts.fromSecrets && !preset.authOptional) {
         await ensureProviderToken(preset.provider, preset.signupUrl, opts.keyStdin);
     }
     const profile = profileFromPreset(name, preset, opts.version);
+    if (account) {
+        profile.account = account.id;
+        profile.provider = account.provider;
+    }
     if (opts.fromSecrets)
         await applyFromSecrets(profile, opts.fromSecrets, opts.authProvider);
     writeProfile(profile);
@@ -221,141 +231,8 @@ function renderProfileRow(p) {
     const provider = p.provider || (p.auth?.keychainItem?.split('.')[1]) || '-';
     return `${chalk.cyan(p.name.padEnd(16))} ${host.padEnd(14)} ${provider.padEnd(12)} ${chalk.gray(model)}`;
 }
-function splitList(value) {
-    if (value === undefined)
-        return undefined;
-    return value.split(',').map((part) => part.trim()).filter(Boolean);
-}
-function buildResourceProfileFromOptions(existing, opts) {
-    const next = { ...(existing ?? {}) };
-    if (opts.description !== undefined)
-        next.description = opts.description || undefined;
-    const keys = ['commands', 'skills', 'hooks', 'subagents', 'plugins', 'workflows', 'permissions', 'mcp'];
-    for (const key of keys) {
-        const parsed = splitList(opts[key]);
-        if (parsed !== undefined)
-            next[key] = parsed;
-    }
-    const secrets = splitList(opts.secrets);
-    if (secrets !== undefined)
-        next.secrets = secrets;
-    if (opts.rules !== undefined)
-        next.rules = opts.rules || undefined;
-    return next;
-}
-function printResourceProfile(name, preset, activeName) {
-    const activeMark = activeName === name ? '*' : ' ';
-    const description = preset.description ? `  ${chalk.gray(preset.description)}` : '';
-    console.log(`${activeMark} ${chalk.cyan(name)}${description}`);
-}
-function syncInstalledVersionsForActiveProfile(cwd) {
-    let synced = 0;
-    for (const agent of Object.keys(AGENTS)) {
-        for (const version of listInstalledVersions(agent)) {
-            syncResourcesToVersion(agent, version, undefined, { cwd, force: true });
-            synced++;
-        }
-    }
-    return synced;
-}
-function registerResourceProfileCommands(program) {
-    const cmd = program
-        .command('profile')
-        .description('Activate top-level resource profiles across commands, skills, hooks, rules, MCP, permissions, and secrets.');
-    cmd
-        .command('list')
-        .alias('ls')
-        .description('List top-level resource profiles')
-        .action(() => {
-        const names = listResourceProfileNames();
-        if (names.length === 0) {
-            console.log(chalk.gray('No resource profiles configured.'));
-            console.log(chalk.gray('Try: agents profile set work --skills user:code-review --secrets work'));
-            return;
-        }
-        const active = getActiveResourceProfileName();
-        for (const name of names) {
-            printResourceProfile(name, getResourceProfilePreset(name), active);
-        }
-    });
-    cmd
-        .command('status')
-        .description('Show the active top-level resource profile')
-        .action(() => {
-        const active = getActiveResourceProfileName();
-        if (!active) {
-            console.log(chalk.gray('No resource profile active.'));
-            return;
-        }
-        const preset = getResourceProfilePreset(active);
-        console.log(chalk.bold(active));
-        if (!preset) {
-            console.log(chalk.red('Configured active profile is missing from profiles.presets.'));
-            return;
-        }
-        if (preset.description)
-            console.log(chalk.gray(preset.description));
-        for (const [key, value] of Object.entries(preset)) {
-            if (key === 'description')
-                continue;
-            console.log(`${key}: ${Array.isArray(value) ? value.join(', ') : value}`);
-        }
-    });
-    cmd
-        .command('set <name>')
-        .alias('define')
-        .description('Create or update a top-level resource profile')
-        .option('--description <text>', 'Free-form description')
-        .option('--commands <patterns>', 'Comma-separated command selectors, e.g. system:commit,user:*')
-        .option('--skills <patterns>', 'Comma-separated skill selectors')
-        .option('--hooks <patterns>', 'Comma-separated hook selectors')
-        .option('--subagents <patterns>', 'Comma-separated subagent selectors')
-        .option('--plugins <patterns>', 'Comma-separated plugin selectors')
-        .option('--workflows <patterns>', 'Comma-separated workflow selectors')
-        .option('--permissions <patterns>', 'Comma-separated permission group selectors')
-        .option('--mcp <patterns>', 'Comma-separated MCP server selectors')
-        .option('--rules <preset>', 'Rules preset to compose while active')
-        .option('--secrets <names>', 'Comma-separated secrets bundles, or "*"')
-        .action((name, opts) => {
-        try {
-            validateResourceProfileName(name);
-            const preset = buildResourceProfileFromOptions(getResourceProfilePreset(name), opts);
-            upsertResourceProfilePreset(name, preset);
-            console.log(chalk.green(`Profile '${name}' saved.`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('use <name>')
-        .description('Activate a top-level resource profile and reconcile installed versions')
-        .action((name) => {
-        try {
-            setActiveResourceProfile(name);
-            const synced = syncInstalledVersionsForActiveProfile(process.cwd());
-            console.log(chalk.green(`Profile '${name}' active.`));
-            console.log(chalk.gray(`Reconciled ${synced} installed version${synced === 1 ? '' : 's'}.`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('clear')
-        .description('Clear the active top-level resource profile and reconcile installed versions')
-        .action(() => {
-        setActiveResourceProfile(null);
-        const synced = syncInstalledVersionsForActiveProfile(process.cwd());
-        console.log(chalk.green('Resource profile cleared.'));
-        console.log(chalk.gray(`Reconciled ${synced} installed version${synced === 1 ? '' : 's'}.`));
-    });
-}
 /** Register the `agents profiles` command tree. */
 export function registerProfilesCommands(program) {
-    registerResourceProfileCommands(program);
     const cmd = program
         .command('profiles')
         .description('Named bundles of (host CLI, endpoint, model, auth) — run Kimi/DeepSeek/Qwen/etc through Claude Code without a proxy.')
@@ -427,28 +304,6 @@ Examples:
   # Fully remove the OpenRouter key from Keychain
   agents profiles logout openrouter
 `);
-    cmd
-        .command('use <name>')
-        .description('Alias for `agents profile use <name>`')
-        .action((name) => {
-        try {
-            setActiveResourceProfile(name);
-            const synced = syncInstalledVersionsForActiveProfile(process.cwd());
-            console.log(chalk.green(`Profile '${name}' active.`));
-            console.log(chalk.gray(`Reconciled ${synced} installed version${synced === 1 ? '' : 's'}.`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('status')
-        .description('Alias for `agents profile status`')
-        .action(() => {
-        const active = getActiveResourceProfileName();
-        console.log(active ? active : chalk.gray('No resource profile active.'));
-    });
     cmd
         .command('list')
         .alias('ls')
@@ -609,6 +464,7 @@ Examples:
         .description('Add a profile. If <name> matches a built-in preset, the preset is applied. Prompts for API key (once per provider).')
         .option('--preset <preset>', 'Use a named preset (defaults to <name> if a preset by that name exists)')
         .option('--version <version>', 'Pin the host CLI version (e.g., 2.1.113)')
+        .option('--account <name>', 'Attach an existing durable credential account')
         .option('--key-stdin', 'Read API key from stdin instead of prompting (for scripts/CI)')
         .option('--force', 'Overwrite an existing profile with the same name')
         .addHelpText('after', '\nTo build a custom harness from a host CLI + model in one shot, use `agents harness add`.\n')
@@ -617,7 +473,7 @@ Examples:
         // device routing (see lib/hosts/passthrough.ts). The host+model one-shot
         // lives on `agents harness add`, which owns its own `--host`.
         try {
-            await addProfile(name, { preset: opts.preset, version: opts.version, keyStdin: opts.keyStdin, force: opts.force }, 'Profile');
+            await addProfile(name, { preset: opts.preset, version: opts.version, account: opts.account, keyStdin: opts.keyStdin, force: opts.force }, 'Profile');
         }
         catch (err) {
             console.error(chalk.red(err.message));

package/dist/commands/projects.d.ts

@@ -8,9 +8,18 @@
  * lifecycle state, plan completion, open PRs, and tickets in flight.
  */
 import type { Command } from 'commander';
+import { type ProjectRepo } from '../lib/projects.js';
 import { type LinearMilestone } from '../lib/linear-project-counts.js';
 /** Recursion guard: a peer answering a probe fan-out never re-fans-out itself. */
 export declare const PROJECTS_NO_FANOUT_ENV = "AGENTS_PROJECTS_LOCAL";
+/**
+ * Render `agents projects for-cwd`'s output for a resolved (or absent)
+ * project name — `--json` always prints `{"name": ...}` even on no match, so
+ * a scripted caller can distinguish "ran and found nothing" from a crash;
+ * the plain-text form prints nothing on no match. Returns '' when nothing
+ * should be printed.
+ */
+export declare function formatForCwdOutput(name: string | undefined, json: boolean): string;
 /**
  * One compact trailing note for peers that didn't answer the `--fleet`
  * fan-out — unreachable, running an agents-cli too old to carry `projects
@@ -28,6 +37,25 @@ export declare function formatFleetSkippedNote(skipped: string[]): string;
  * expected answer here (`undefined`), not something to report.
  */
 export declare function originSlug(cwd: string): string | undefined;
+/**
+ * Turn a `--dir` / `--add-dir` value into a `repos[]` row.
+ *
+ * The slug comes from the DIRECTORY'S OWN origin remote, never from its path:
+ * a checkout at `~/src/github.com/muqsitnawaz/agents-cli` whose origin is
+ * `phnx-labs/agents-cli` must record the remote it actually pushes to. Pass
+ * `slugOverride` for a directory with no origin (a vendored tree, a fresh
+ * `git init`).
+ *
+ * The stored `path` is left for `writeProjectDef` to normalize home-relative,
+ * so the same definition re-roots on every machine.
+ */
+export declare function projectRepoFromDir(dir: string, slugOverride?: string): {
+    ok: true;
+    repo: ProjectRepo;
+} | {
+    ok: false;
+    error: string;
+};
 /** One `projects list` row, pre-render. */
 export interface ProjectListRow {
     name: string;