@swarmify/agents-cli 1.12.0 → 1.13.1

package/dist/lib/versions.d.ts

@@ -18,6 +18,11 @@ export interface ResourceSelection {
 }
 /**
  * Available resources in ~/.agents/ for syncing.
+ *
+ * `promptcuts` is a boolean, not a list — there is at most one
+ * ~/.agents/promptcuts.yaml file. It is NOT version-scoped: the
+ * expand-promptcuts hook reads it directly, so no per-version copy
+ * is made and no sync step is needed.
  */
 export interface AvailableResources {
     commands: string[];
@@ -28,6 +33,7 @@ export interface AvailableResources {
     permissions: string[];
     subagents: string[];
     plugins: string[];
+    promptcuts: boolean;
 }
 /**
  * Get all available resources from ~/.agents/.
@@ -60,6 +66,7 @@ export declare function promptNewResourceSelection(agent: AgentId, newResources:
  * Returns the selection, or null if user cancels.
  */
 export declare function promptResourceSelection(agent: AgentId): Promise<ResourceSelection | null>;
+/** Parsed agent@version specification from CLI input. */
 export interface AgentSpec {
     agent: AgentId;
     version: string;
@@ -134,7 +141,7 @@ export declare function removeAllVersions(agent: AgentId): number;
  */
 export declare function resolveVersion(agent: AgentId, projectPath?: string): string | null;
 /**
- * Get version specified in project manifest.
+ * Get version specified in a project-root agents.yaml (not the user ~/.agents/agents.yaml).
  */
 export declare function getProjectVersion(agent: AgentId, startPath: string): string | null;
 /**
@@ -145,6 +152,7 @@ export declare function compareVersions(a: string, b: string): number;
  * Get actual version from an installed 'latest' directory.
  */
 export declare function getInstalledVersion(agent: AgentId, version: string): Promise<string | null>;
+/** Outcome of syncing resources to a version home, keyed by resource type. */
 export interface SyncResult {
     commands: boolean;
     skills: boolean;
@@ -155,6 +163,7 @@ export interface SyncResult {
     subagents: string[];
     plugins: string[];
 }
+/** Diff between central ~/.agents/ resources and what is synced to a version home. */
 export interface ResourceDiff {
     commands: {
         added: string[];
@@ -200,10 +209,12 @@ export declare function syncResourcesToVersion(agent: AgentId, version: string,
  * Otherwise returns the real HOME.
  */
 export declare function getEffectiveHome(agentId: AgentId): string;
+/** Result of resolving agent/version targets from CLI input or interactive selection. */
 export interface VersionSelectionResult {
     selectedAgents: AgentId[];
     versionSelections: Map<AgentId, string[]>;
 }
+/** Extended target result that distinguishes managed versions from direct (unmanaged) agent homes. */
 export interface InstalledAgentTargetResult {
     selectedAgents: AgentId[];
     directAgents: AgentId[];

package/dist/lib/versions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/lib/versions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/lib/versions.ts"],"names":[],"mappings":"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"}

package/dist/lib/versions.js

@@ -1,21 +1,40 @@
+/**
+ * Version management module for agents-cli.
+ *
+ * Handles installing, removing, listing, and switching between agent CLI versions.
+ * Each version is installed into an isolated directory under ~/.agents/versions/{agent}/{version}/
+ * with its own HOME directory for config isolation. Resources (commands, skills, hooks, memory,
+ * MCP servers, permissions, subagents, plugins) from ~/.agents/ are synced into version homes
+ * via copies or conversions (not symlinks).
+ *
+ * Key responsibilities:
+ * - Version lifecycle: install, remove, list, resolve (project-level or global default)
+ * - Resource discovery: scan ~/.agents/ for available resources across all types
+ * - Resource sync: copy/convert resources into a version's isolated config directory
+ * - Diff and reconciliation: detect new/unsynced resources and prompt users to sync them
+ * - Agent/version target resolution: parse agent@version specs from CLI flags
+ */
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
+import * as yaml from 'yaml';
 import { exec } from 'child_process';
 import { promisify } from 'util';
 import chalk from 'chalk';
 import * as TOML from 'smol-toml';
 import { checkbox, select } from '@inquirer/prompts';
-import { getVersionsDir, ensureAgentsDir, readMeta, writeMeta, getCommandsDir, getSkillsDir, getHooksDir, getMemoryDir, clearVersionResources, recordVersionResources, getProjectAgentsDir } from './state.js';
-import { AGENTS, getAccountEmail, MCP_CAPABLE_AGENTS, COMMANDS_CAPABLE_AGENTS, getMcpConfigPathForHome, parseMcpConfig, resolveAgentName, formatAgentError } from './agents.js';
-import { applyPermissionsToVersion as applyPermsToVersion, PERMISSIONS_CAPABLE_AGENTS, discoverPermissionGroups, buildPermissionsFromGroups, CODEX_RULES_FILENAME } from './permissions.js';
+import { getVersionsDir, ensureAgentsDir, readMeta, writeMeta, getCommandsDir, getSkillsDir, getHooksDir, getMemoryDir, clearVersionResources, recordVersionResources, getProjectAgentsDir, getPromptcutsPath } from './state.js';
+import { AGENTS, getAccountEmail, MCP_CAPABLE_AGENTS, COMMANDS_CAPABLE_AGENTS, getMcpConfigPathForHome, parseMcpConfig, resolveAgentName, formatAgentError, CODEX_HOOKS_MIN_VERSION } from './agents.js';
+import { applyPermissionsToVersion as applyPermsToVersion, PERMISSIONS_CAPABLE_AGENTS, discoverPermissionGroups, buildPermissionsFromGroups, CODEX_RULES_FILENAME, getActivePermissionSetName, readPermissionSetRecipe, PERMISSION_SET_ENV_VAR } from './permissions.js';
 import { installMcpServers } from './mcp.js';
 import { markdownToToml } from './convert.js';
-import { createVersionedAlias, removeVersionedAlias, getConfigSymlinkVersion } from './shims.js';
+import { createVersionedAlias, removeVersionedAlias, getConfigSymlinkVersion, ensureClaudeInsideSymlink } from './shims.js';
 import { listInstalledSubagents, transformSubagentForClaude, syncSubagentToOpenclaw, SUBAGENT_CAPABLE_AGENTS } from './subagents.js';
 import { registerHooksToSettings } from './hooks.js';
 import { discoverPlugins, syncPluginToVersion, isPluginSynced, pluginSupportsAgent, cleanOrphanedPluginSkills } from './plugins.js';
+import { compileMemoryForAgent } from './memory-compile.js';
 import { PLUGINS_CAPABLE_AGENTS } from './agents.js';
+/** Promisified exec for running shell commands. */
 const execAsync = promisify(exec);
 /**
  * Get all available resources from ~/.agents/.
@@ -30,6 +49,7 @@ export function getAvailableResources(cwd = process.cwd()) {
         permissions: [],
         subagents: [],
         plugins: [],
+        promptcuts: false,
     };
     const projectAgentsDir = getProjectAgentsDir(cwd);
     const userBase = path.dirname(getCommandsDir());
@@ -142,6 +162,10 @@ export function getAvailableResources(cwd = process.cwd()) {
     // Plugins (directories with .claude-plugin/plugin.json)
     const allPlugins = discoverPlugins();
     result.plugins = allPlugins.map(p => p.name);
+    // Promptcuts — single file at ~/.agents/promptcuts.yaml, not per-agent.
+    // Project-scoped .agents/promptcuts.yaml is intentionally not supported
+    // (user-global shortcuts only — they follow the user, not the repo).
+    result.promptcuts = fs.existsSync(getPromptcutsPath());
     return result;
 }
 /**
@@ -187,6 +211,7 @@ export function getActuallySyncedResources(agent, version, options = {}) {
         permissions: [],
         subagents: [],
         plugins: [],
+        promptcuts: false,
     };
     // Commands - check what files exist in version home
     const commandsDir = path.join(configDir, agentConfig.commandsSubdir);
@@ -420,6 +445,9 @@ export function getNewResources(available, actuallySynced) {
         permissions: available.permissions.filter(p => !actuallySynced.permissions.includes(p)),
         subagents: available.subagents.filter(s => !actuallySynced.subagents.includes(s)),
         plugins: available.plugins.filter(p => !actuallySynced.plugins.includes(p)),
+        // Promptcuts aren't version-scoped — the hook reads ~/.agents/promptcuts.yaml
+        // directly, so there is never a "new" per-version state to reconcile.
+        promptcuts: false,
     };
 }
 /**
@@ -885,6 +913,18 @@ export async function installVersion(agent, version, onProgress) {
         }
         // Create versioned alias (e.g., claude@2.0.65)
         createVersionedAlias(agent, installedVersion);
+        // Claude reads its global config from CLAUDE_CONFIG_DIR/.claude.json —
+        // i.e. inside the per-version .claude dir — while the rest of agents-cli
+        // manages the home-level file. Symlink INSIDE to OUTSIDE so Claude and
+        // agents-cli see the same content.
+        if (agent === 'claude') {
+            try {
+                ensureClaudeInsideSymlink(installedVersion);
+            }
+            catch {
+                /* non-fatal; the install itself succeeded */
+            }
+        }
         return { success: true, installedVersion };
     }
     catch (err) {
@@ -967,19 +1007,20 @@ export function resolveVersion(agent, projectPath) {
     return getGlobalDefault(agent);
 }
 /**
- * Get version specified in project manifest.
+ * Get version specified in a project-root agents.yaml (not the user ~/.agents/agents.yaml).
  */
 export function getProjectVersion(agent, startPath) {
+    const userAgentsYaml = path.join(os.homedir(), '.agents', 'agents.yaml');
     let dir = path.resolve(startPath);
     while (dir !== path.dirname(dir)) {
-        const manifestPath = path.join(dir, '.agents', 'agents.yaml');
-        if (fs.existsSync(manifestPath)) {
+        const manifestPath = path.join(dir, 'agents.yaml');
+        if (manifestPath !== userAgentsYaml && fs.existsSync(manifestPath)) {
             try {
                 const content = fs.readFileSync(manifestPath, 'utf-8');
-                // Simple YAML parsing for agents section (flat format: claude: "1.5.0")
-                const agentMatch = content.match(new RegExp(`^\\s+${agent}:\\s*['"]?([^'"\n]+)['"]?`, 'm'));
-                if (agentMatch) {
-                    return agentMatch[1].trim();
+                const parsed = yaml.parse(content);
+                const version = parsed?.agents?.[agent];
+                if (typeof version === 'string' && version.trim()) {
+                    return version.trim();
                 }
             }
             catch {
@@ -1267,31 +1308,48 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
     }
     // Sync hooks (if agent supports them)
     if (agentConfig.supportsHooks) {
-        const hooksToSync = selection
-            ? resolveSelection(selection.hooks, available.hooks)
-            : available.hooks;
-        if (hooksToSync.length > 0) {
-            const centralHooks = getHooksDir();
-            const projectHooksDir = projectAgentsDir ? path.join(projectAgentsDir, 'hooks') : null;
-            const hooksTarget = path.join(agentDir, 'hooks');
-            fs.mkdirSync(hooksTarget, { recursive: true });
-            const syncedHooks = [];
-            for (const hook of hooksToSync) {
-                const projectSource = projectHooksDir ? path.join(projectHooksDir, hook) : null;
-                const srcFile = projectSource && fs.existsSync(projectSource) ? projectSource : path.join(centralHooks, hook);
-                if (!fs.existsSync(srcFile))
-                    continue;
-                const destFile = path.join(hooksTarget, hook);
-                fs.copyFileSync(srcFile, destFile);
-                fs.chmodSync(destFile, 0o755);
-                syncedHooks.push(hook);
-            }
-            result.hooks = syncedHooks.length > 0;
-            if (syncedHooks.length > 0) {
-                recordVersionResources(agent, version, 'hooks', syncedHooks);
-            }
-            if (agent === 'claude') {
-                registerHooksToSettings(agent, versionHome);
+        // Version gate: Codex hooks require >= CODEX_HOOKS_MIN_VERSION
+        if (agent === 'codex' && compareVersions(version, CODEX_HOOKS_MIN_VERSION) < 0) {
+            console.warn(`hooks skipped: codex@${version} < ${CODEX_HOOKS_MIN_VERSION}`);
+        }
+        else {
+            const hooksToSync = selection
+                ? resolveSelection(selection.hooks, available.hooks)
+                : available.hooks;
+            if (hooksToSync.length > 0) {
+                const centralHooks = getHooksDir();
+                const projectHooksDir = projectAgentsDir ? path.join(projectAgentsDir, 'hooks') : null;
+                const hooksTarget = path.join(agentDir, 'hooks');
+                fs.mkdirSync(hooksTarget, { recursive: true });
+                const syncedHooks = [];
+                for (const hook of hooksToSync) {
+                    const projectSource = projectHooksDir ? path.join(projectHooksDir, hook) : null;
+                    const srcFile = projectSource && fs.existsSync(projectSource) ? projectSource : path.join(centralHooks, hook);
+                    if (!fs.existsSync(srcFile))
+                        continue;
+                    const destFile = path.join(hooksTarget, hook);
+                    fs.copyFileSync(srcFile, destFile);
+                    fs.chmodSync(destFile, 0o755);
+                    syncedHooks.push(hook);
+                }
+                // Remove orphan hook files that exist in version home but not in central
+                const centralHookNames = new Set(fs.existsSync(getHooksDir())
+                    ? fs.readdirSync(getHooksDir()).filter(f => !f.startsWith('.'))
+                    : []);
+                if (fs.existsSync(hooksTarget)) {
+                    for (const file of fs.readdirSync(hooksTarget).filter(f => !f.startsWith('.'))) {
+                        if (!centralHookNames.has(file)) {
+                            removePath(path.join(hooksTarget, file));
+                        }
+                    }
+                }
+                result.hooks = syncedHooks.length > 0;
+                if (syncedHooks.length > 0) {
+                    recordVersionResources(agent, version, 'hooks', syncedHooks);
+                }
+                if (agent === 'claude' || agent === 'codex') {
+                    registerHooksToSettings(agent, versionHome);
+                }
             }
         }
     }
@@ -1303,6 +1361,7 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
         const centralMemory = getMemoryDir();
         const projectMemoryDir = projectAgentsDir ? path.join(projectAgentsDir, 'memory') : null;
         const syncedMemory = [];
+        const agentSupportsImports = !!agentConfig.capabilities.memoryImports;
         for (const mem of memoryToSync) {
             const projectSource = projectMemoryDir ? path.join(projectMemoryDir, `${mem}.md`) : null;
             const srcFile = projectSource && fs.existsSync(projectSource)
@@ -1313,7 +1372,16 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
             const targetName = mem === 'AGENTS' ? agentConfig.instructionsFile : `${mem}.md`;
             const destFile = path.join(agentDir, targetName);
             removePath(destFile);
-            fs.copyFileSync(srcFile, destFile);
+            // For the primary memory file (AGENTS.md), agents that don't natively
+            // resolve @-imports get a compiled (inlined) copy + sidecar manifest.
+            // Everything else (secondary memory files, @-capable agents) gets a
+            // straight copy.
+            if (mem === 'AGENTS' && !agentSupportsImports) {
+                compileMemoryForAgent(agent, version);
+            }
+            else {
+                fs.copyFileSync(srcFile, destFile);
+            }
             result.memory.push(targetName);
             syncedMemory.push(mem);
         }
@@ -1321,13 +1389,28 @@ export function syncResourcesToVersion(agent, version, selection, options = {})
             recordVersionResources(agent, version, 'memory', syncedMemory);
         }
     }
-    // Apply permissions (if agent supports them)
-    // Permissions are now stored as groups in ~/.agents/permissions/groups/
+    // Apply permissions (if agent supports them).
+    // Groups live in ~/.agents/permissions/groups/. Optional recipes in
+    // ~/.agents/permissions/sets/<name>.yaml pick a subset via `includes:`.
+    // If AGENTS_PERMISSION_SET is set, we resolve that recipe and use its
+    // includes list as the group filter (intersected with groups on disk).
     const permissionGroups = discoverPermissionGroups();
     const allGroupNames = permissionGroups.map(g => g.name);
+    const activeSetName = getActivePermissionSetName();
+    let setFilteredGroups = null;
+    if (activeSetName) {
+        const recipe = readPermissionSetRecipe(activeSetName);
+        if (recipe) {
+            const available = new Set(allGroupNames);
+            setFilteredGroups = recipe.includes.filter(g => available.has(g));
+        }
+        else {
+            console.warn(`${PERMISSION_SET_ENV_VAR}=${activeSetName} but no recipe at ~/.agents/permissions/sets/${activeSetName}.yaml — falling back to all groups`);
+        }
+    }
     const permsToSync = selection
-        ? resolveSelection(selection.permissions, allGroupNames)
-        : (PERMISSIONS_CAPABLE_AGENTS.includes(agent) ? allGroupNames : []);
+        ? resolveSelection(selection.permissions, setFilteredGroups ?? allGroupNames)
+        : (PERMISSIONS_CAPABLE_AGENTS.includes(agent) ? (setFilteredGroups ?? allGroupNames) : []);
     if (permsToSync.length > 0 && PERMISSIONS_CAPABLE_AGENTS.includes(agent)) {
         // Build permissions from selected groups
         const builtPerms = buildPermissionsFromGroups(permsToSync);