@phnx-labs/agents-cli 1.20.3 → 1.20.5

package/dist/lib/plugins.js

@@ -11,11 +11,12 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import { execFileSync } from 'child_process';
-import { getPluginsDir, getTrashPluginsDir } from './state.js';
+import { getPluginsDir, getTrashPluginsDir, getExtraPluginsDir, getProjectPluginsDir } from './state.js';
 import { listInstalledVersions, getVersionHomePath } from './versions.js';
-import { AGENTS, PLUGINS_CAPABLE_AGENTS } from './agents.js';
+import { AGENTS, agentConfigDirName } from './agents.js';
+import { capableAgents, isCapable } from './capabilities.js';
 import { shouldInstallCommandAsSkill, installCommandSkillToVersion } from './command-skills.js';
-import { copyPluginToMarketplace, syncMarketplaceManifest, registerMarketplace, unregisterMarketplace, enablePluginInSettings, disablePluginInSettings, removePluginFromMarketplace, marketplaceIsEmpty, removeEmptyMarketplaceDir, isInstalledInMarketplace, marketplaceRoot, } from './plugin-marketplace.js';
+import { copyPluginToMarketplace, syncMarketplaceManifest, registerMarketplace, unregisterMarketplace, addPluginToSettings, removePluginFromSettings, removePluginFromMarketplace, marketplaceIsEmpty, removeEmptyMarketplaceDir, isInstalledInMarketplace, marketplaceRoot, discoverMarketplaces, marketplaceNameFor, MARKETPLACE_NAME, PROJECT_MARKETPLACE_NAME, } from './plugin-marketplace.js';
 const PLUGIN_MANIFEST_DIR = '.claude-plugin';
 const PLUGIN_MANIFEST_FILE = 'plugin.json';
 const USER_CONFIG_FILE = '.user-config.json';
@@ -43,11 +44,15 @@ function isPluginRootEntry(pluginsDir, entry) {
     }
 }
 /**
- * Discover all plugins in ~/.agents/plugins/.
+ * Discover all plugins in a given plugins directory (e.g. ~/.agents/plugins/,
+ * ~/.agents/.system/plugins/, <cwd>/.agents/plugins/, ~/.agents-<alias>/plugins/).
  * A valid plugin has a .claude-plugin/plugin.json manifest.
+ *
+ * `spec` stamps marketplace provenance onto each discovered plugin. Callers that
+ * scan a single source dir without a marketplace identity (e.g. project-launch)
+ * may omit it; those plugins default to the user marketplace.
  */
-export function discoverPlugins() {
-    const pluginsDir = getPluginsDir();
+export function discoverPluginsInDir(pluginsDir, spec = { kind: 'user' }) {
     if (!fs.existsSync(pluginsDir)) {
         return [];
     }
@@ -60,15 +65,32 @@ export function discoverPlugins() {
         const manifest = loadPluginManifest(pluginRoot);
         if (!manifest)
             continue;
-        plugins.push(buildDiscoveredPlugin(pluginRoot, manifest));
+        plugins.push(buildDiscoveredPlugin(pluginRoot, manifest, spec));
     }
     return plugins;
 }
-export function buildDiscoveredPlugin(pluginRoot, manifest) {
+/**
+ * Discover every plugin across ALL marketplaces — the user repo (~/.agents/),
+ * each enabled extra repo (~/.agents-<alias>/), and the project repo
+ * (<cwd>/.agents/) — stamping marketplace provenance onto each.
+ *
+ * Plugin names are NOT deduplicated across marketplaces: a `code` plugin in both
+ * the user repo and an extra repo yields two entries (`code@agents-cli` and
+ * `code@agents-<alias>`), each installing into its own marketplace directory.
+ */
+export function discoverPlugins(opts = {}) {
+    const out = [];
+    for (const dm of discoverMarketplaces(opts)) {
+        out.push(...discoverPluginsInDir(dm.pluginsRoot, dm.spec));
+    }
+    return out;
+}
+export function buildDiscoveredPlugin(pluginRoot, manifest, spec = { kind: 'user' }) {
     return {
         name: manifest.name,
         root: pluginRoot,
         manifest,
+        marketplace: marketplaceNameFor(spec),
         skills: discoverPluginSkills(pluginRoot),
         hooks: discoverPluginHooks(pluginRoot),
         scripts: discoverPluginScripts(pluginRoot),
@@ -151,7 +173,7 @@ export function getPlugin(name) {
  * Otherwise defaults to all plugin-capable agents.
  */
 export function pluginSupportsAgent(plugin, agent) {
-    if (!PLUGINS_CAPABLE_AGENTS.includes(agent))
+    if (!isCapable(agent, 'plugins'))
         return false;
     if (plugin.manifest.agents && plugin.manifest.agents.length > 0) {
         return plugin.manifest.agents.includes(agent);
@@ -274,7 +296,7 @@ function pluginHasNonPermissionSettings(pluginRoot) {
  *   ${user_config.<key>}       -> value from plugin's .user-config.json
  */
 export function expandPluginVars(str, pluginRoot, pluginName, agentId, versionHome, userConfig) {
-    const dataDir = path.join(versionHome, `.${agentId}`, 'plugin-data', pluginName);
+    const dataDir = path.join(versionHome, agentConfigDirName(agentId), 'plugin-data', pluginName);
     let result = str
         .replace(/\$\{CLAUDE_PLUGIN_ROOT\}/g, pluginRoot)
         .replace(/\$\{CLAUDE_PLUGIN_DATA\}/g, dataDir);
@@ -319,6 +341,42 @@ export function checkPluginDependencies(manifest) {
     const installed = new Set(discoverPlugins().map(p => p.name));
     return manifest.dependencies.filter(dep => !installed.has(dep));
 }
+// ─── Marketplace routing ──────────────────────────────────────────────────────
+/**
+ * Reconstruct a MarketplaceSpec from a marketplace name. The inverse of
+ * marketplaceNameFor(): "agents-cli" → user, "agents-project" → project,
+ * "agents-<alias>" → extra. The per-version marketplace operations only key off
+ * the name (never spec.root), but we resolve the real source root anyway so the
+ * spec is honest for any caller that inspects it.
+ */
+function marketplaceSpecForName(name, cwd = process.cwd()) {
+    if (!name || name === MARKETPLACE_NAME)
+        return { kind: 'user' };
+    if (name === PROJECT_MARKETPLACE_NAME) {
+        return { kind: 'project', root: getProjectPluginsDir(cwd) ?? '' };
+    }
+    const alias = name.slice('agents-'.length);
+    return { kind: 'extra', alias, root: getExtraPluginsDir(alias) };
+}
+/**
+ * List the marketplace names that have been synthesized under a version home
+ * (i.e. the directories beneath .{agent}/plugins/marketplaces/). Used by
+ * removal/orphan/diff passes that must touch every marketplace a version
+ * carries, not just the user one.
+ */
+function listVersionMarketplaceNames(agent, versionHome) {
+    const dir = path.join(versionHome, `.${agent}`, 'plugins', 'marketplaces');
+    if (!fs.existsSync(dir))
+        return [];
+    try {
+        return fs.readdirSync(dir, { withFileTypes: true })
+            .filter(d => d.isDirectory() && !d.name.startsWith('.'))
+            .map(d => d.name);
+    }
+    catch {
+        return [];
+    }
+}
 // ─── Main sync entry point ────────────────────────────────────────────────────
 /**
  * Sync a plugin to a specific agent version's home directory.
@@ -352,8 +410,13 @@ export function syncPluginToVersion(plugin, agent, versionHome, options = {}) {
         return result;
     }
     const userConfig = loadUserConfig(plugin.name);
+    // Route every marketplace op through the plugin's own marketplace, so a plugin
+    // discovered in an extra/project repo installs under its own
+    // marketplaces/<name>/ tree — never the user marketplace.
+    const spec = marketplaceSpecForName(plugin.marketplace);
+    const marketplaceName = marketplaceNameFor(spec);
     // 1. Copy plugin to native marketplace install dir.
-    const installDir = copyPluginToMarketplace(plugin, agent, versionHome);
+    const installDir = copyPluginToMarketplace(plugin, spec, agent, versionHome);
     // 2. Pre-expand ${user_config.*} in the copy. Leave ${CLAUDE_PLUGIN_ROOT} /
     //    ${CLAUDE_PLUGIN_DATA} alone — Claude expands those natively at runtime.
     if (Object.keys(userConfig).length > 0) {
@@ -371,16 +434,20 @@ export function syncPluginToVersion(plugin, agent, versionHome, options = {}) {
         }
     }
     // 3-5. Synthesize manifest, register marketplace, enable plugin.
-    syncMarketplaceManifest(agent, versionHome);
-    registerMarketplace(agent, versionHome);
-    enablePluginInSettings(plugin.name, agent, versionHome, {
-        allowExecSurfaces: options.allowExecSurfaces === true,
-    });
+    syncMarketplaceManifest(spec, agent, versionHome);
+    registerMarketplace(spec, agent, versionHome);
+    // Trust gate: plugins with executable surfaces (hooks/, bin/, scripts/,
+    // .mcp.json, settings.json, permissions/) are only auto-enabled when the
+    // caller explicitly opts in. addPluginToSettings does no gating — that moved
+    // here, where plugin capabilities are inspected.
+    if (options.allowExecSurfaces === true || !hasPluginExecSurfaces(inspectPluginCapabilities(plugin.root))) {
+        addPluginToSettings(plugin.name, marketplaceName, agent, versionHome);
+    }
     // 5b. Convert plugin commands/ to skills for agents that dropped command support
     //     (Codex >= 0.117.0). Skill name is prefixed with plugin name to avoid
     //     collision with standalone command skills.
     if (options.version && shouldInstallCommandAsSkill(agent, options.version) && plugin.commands.length > 0) {
-        const agentDir = path.join(versionHome, `.${AGENTS[agent].id}`);
+        const agentDir = path.join(versionHome, agentConfigDirName(agent));
         const skillSourceDirs = [path.join(agentDir, 'skills')];
         for (const cmd of plugin.commands) {
             const srcPath = path.join(plugin.root, 'commands', `${cmd}.md`);
@@ -465,7 +532,7 @@ function expandUserConfigInDir(dir, userConfig) {
  */
 function migrateLegacyFlatLayout(plugin, agent, versionHome) {
     const prefix = `${plugin.name}--`;
-    const agentRoot = path.join(versionHome, `.${agent}`);
+    const agentRoot = path.join(versionHome, agentConfigDirName(agent));
     // 1. skills
     const skillsDir = path.join(agentRoot, 'skills');
     if (fs.existsSync(skillsDir)) {
@@ -598,9 +665,9 @@ function migrateLegacyFlatLayout(plugin, agent, versionHome) {
  * they're treated as stale and migrated away on the next sync.
  */
 export function isPluginSynced(plugin, agent, versionHome) {
-    if (!PLUGINS_CAPABLE_AGENTS.includes(agent))
+    if (!isCapable(agent, 'plugins'))
         return false;
-    return isInstalledInMarketplace(plugin.name, agent, versionHome);
+    return isInstalledInMarketplace(plugin.name, marketplaceSpecForName(plugin.marketplace), agent, versionHome);
 }
 // ─── Removal ─────────────────────────────────────────────────────────────────
 /**
@@ -619,19 +686,26 @@ export function removePluginFromVersion(pluginName, pluginRoot, agent, versionHo
         permissions: 0,
         mcp: 0,
     };
-    // 1. Remove the plugin from the marketplace install dir + disable it.
-    const removed = removePluginFromMarketplace(pluginName, agent, versionHome);
-    if (removed) {
-        result.skills.push(pluginName);
+    // 1. Remove the plugin from every marketplace it's installed under. A name can
+    //    appear in more than one (collision across repos), so we sweep them all.
+    let removedAny = false;
+    for (const name of listVersionMarketplaceNames(agent, versionHome)) {
+        const spec = marketplaceSpecForName(name);
+        if (removePluginFromMarketplace(pluginName, name, agent, versionHome)) {
+            removedAny = true;
+        }
+        removePluginFromSettings(pluginName, name, agent, versionHome);
+        // Refresh marketplace.json so it reflects what's left under plugins/.
+        syncMarketplaceManifest(spec, agent, versionHome);
+        // If we just removed the last plugin, drop the marketplace dir and the
+        // known_marketplaces.json entry too.
+        if (marketplaceIsEmpty(name, agent, versionHome)) {
+            removeEmptyMarketplaceDir(name, agent, versionHome);
+            unregisterMarketplace(name, agent, versionHome);
+        }
     }
-    disablePluginInSettings(pluginName, agent, versionHome);
-    // 2. Refresh marketplace.json so it reflects what's left under plugins/.
-    syncMarketplaceManifest(agent, versionHome);
-    // 3. If we just removed the last plugin, drop the marketplace dir and the
-    //    known_marketplaces.json entry too.
-    if (marketplaceIsEmpty(agent, versionHome)) {
-        removeEmptyMarketplaceDir(agent, versionHome);
-        unregisterMarketplace(agent, versionHome);
+    if (removedAny) {
+        result.skills.push(pluginName);
     }
     // 4. Strip any legacy dual-dash entries from prior agents-cli versions.
     cleanLegacyFlatLayout(pluginName, pluginRoot, agent, versionHome, result);
@@ -643,7 +717,7 @@ export function removePluginFromVersion(pluginName, pluginRoot, agent, versionHo
  */
 function cleanLegacyFlatLayout(pluginName, pluginRoot, agent, versionHome, result) {
     const prefix = `${pluginName}--`;
-    const agentRoot = path.join(versionHome, `.${agent}`);
+    const agentRoot = path.join(versionHome, agentConfigDirName(agent));
     const skillsDir = path.join(agentRoot, 'skills');
     if (fs.existsSync(skillsDir)) {
         for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
@@ -786,9 +860,13 @@ function cleanLegacyFlatLayout(pluginName, pluginRoot, agent, versionHome, resul
  */
 export function cleanOrphanedPluginSkills(agent, versionHome, activePluginNames, version) {
     const removed = [];
-    // 1. Walk the native marketplace install dir and trash entries no longer active.
-    const mktPluginsDir = path.join(marketplaceRoot(agent, versionHome), 'plugins');
-    if (fs.existsSync(mktPluginsDir)) {
+    // 1. Walk every marketplace's install dir and trash entries no longer active.
+    for (const name of listVersionMarketplaceNames(agent, versionHome)) {
+        const spec = marketplaceSpecForName(name);
+        const mktPluginsDir = path.join(marketplaceRoot(name, agent, versionHome), 'plugins');
+        if (!fs.existsSync(mktPluginsDir))
+            continue;
+        let trashedHere = false;
         for (const entry of fs.readdirSync(mktPluginsDir, { withFileTypes: true })) {
             if (!entry.isDirectory() || entry.name.startsWith('.'))
                 continue;
@@ -800,22 +878,23 @@ export function cleanOrphanedPluginSkills(agent, versionHome, activePluginNames,
                 const trashDest = path.join(trashDir, stamp);
                 fs.mkdirSync(trashDir, { recursive: true, mode: 0o700 });
                 fs.renameSync(path.join(mktPluginsDir, entry.name), trashDest);
-                disablePluginInSettings(entry.name, agent, versionHome);
+                removePluginFromSettings(entry.name, name, agent, versionHome);
                 removed.push(entry.name);
+                trashedHere = true;
             }
             catch { /* skip on error */ }
         }
         // Keep manifest in sync with on-disk state and drop the marketplace if empty.
-        if (removed.length > 0) {
-            syncMarketplaceManifest(agent, versionHome);
-            if (marketplaceIsEmpty(agent, versionHome)) {
-                removeEmptyMarketplaceDir(agent, versionHome);
-                unregisterMarketplace(agent, versionHome);
+        if (trashedHere) {
+            syncMarketplaceManifest(spec, agent, versionHome);
+            if (marketplaceIsEmpty(name, agent, versionHome)) {
+                removeEmptyMarketplaceDir(name, agent, versionHome);
+                unregisterMarketplace(name, agent, versionHome);
             }
         }
     }
     // 2. Sweep legacy dual-dash skills directories from older agents-cli versions.
-    const skillsDir = path.join(versionHome, `.${agent}`, 'skills');
+    const skillsDir = path.join(versionHome, agentConfigDirName(agent), 'skills');
     if (fs.existsSync(skillsDir)) {
         for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
             if (!entry.isDirectory())
@@ -843,8 +922,10 @@ export function diffVersionPlugins(agent, version) {
     const versionHome = getVersionHomePath(agent, version);
     const activePlugins = new Set(discoverPlugins().map(p => p.name));
     const orphans = [];
-    const mktPluginsDir = path.join(marketplaceRoot(agent, versionHome), 'plugins');
-    if (fs.existsSync(mktPluginsDir)) {
+    for (const name of listVersionMarketplaceNames(agent, versionHome)) {
+        const mktPluginsDir = path.join(marketplaceRoot(name, agent, versionHome), 'plugins');
+        if (!fs.existsSync(mktPluginsDir))
+            continue;
         for (const entry of fs.readdirSync(mktPluginsDir, { withFileTypes: true })) {
             if (!entry.isDirectory() || entry.name.startsWith('.'))
                 continue;
@@ -854,7 +935,7 @@ export function diffVersionPlugins(agent, version) {
         }
     }
     // Also surface legacy dual-dash skill dirs as orphans during migration period.
-    const skillsDir = path.join(versionHome, `.${agent}`, 'skills');
+    const skillsDir = path.join(versionHome, agentConfigDirName(agent), 'skills');
     if (fs.existsSync(skillsDir)) {
         for (const entry of fs.readdirSync(skillsDir, { withFileTypes: true })) {
             if (!entry.isDirectory())
@@ -872,9 +953,9 @@ export function diffVersionPlugins(agent, version) {
 }
 export function iterPluginsCapableVersions(filter) {
     const pairs = [];
-    const agents = filter?.agent ? [filter.agent] : PLUGINS_CAPABLE_AGENTS;
+    const agents = filter?.agent ? [filter.agent] : capableAgents('plugins');
     for (const agent of agents) {
-        if (!PLUGINS_CAPABLE_AGENTS.includes(agent))
+        if (!isCapable(agent, 'plugins'))
             continue;
         const versions = listInstalledVersions(agent);
         for (const version of versions) {
@@ -887,7 +968,7 @@ export function iterPluginsCapableVersions(filter) {
 }
 export function removePluginSkillFromVersion(agent, version, skillName) {
     const versionHome = getVersionHomePath(agent, version);
-    const skillPath = path.join(versionHome, `.${agent}`, 'skills', skillName);
+    const skillPath = path.join(versionHome, agentConfigDirName(agent), 'skills', skillName);
     if (!fs.existsSync(skillPath)) {
         return { success: true };
     }

package/dist/lib/profiles-presets.js

@@ -10,13 +10,13 @@
 //
 // Important limitation of Claude Code + non-Anthropic models via OpenRouter:
 // Claude Code sends `thinking:{type:"enabled"}` in its Anthropic payload by
-// default, and its `--print` consolidation returns empty text when a response
-// contains thinking/redacted_thinking blocks — even when the model *also*
-// emits a text block. This means reasoning models work fine in interactive
-// `claude` mode (same env vars) but `agents run <profile> --print` sees
-// empty stdout.
+// default, and its headless output consolidation returns empty text when a
+// response contains thinking/redacted_thinking blocks — even when the model
+// *also* emits a text block. This means reasoning models work fine in
+// interactive `claude` mode (same env vars) but headless invocations
+// (`agents run <profile> "<prompt>"`) see empty stdout.
 //
-// Presets flagged "print-safe" use non-reasoning variants that ignore
+// Presets flagged "headless-safe" use non-reasoning variants that ignore
 // thinking:enabled. Presets flagged "reasoning" are the leaderboard leaders
 // but are best invoked interactively.
 const OPENROUTER_BASE = 'https://openrouter.ai/api';
@@ -30,7 +30,7 @@ export const PRESETS = [
     // ----- Top coding (via OpenRouter) -----
     {
         name: 'kimi',
-        description: 'Kimi K2.5 via OpenRouter (262K ctx, $0.38/$1.72 per 1M). Top Kimi: 99% HumanEval, 76.8% SWE-bench. REASONING — works interactively, but `agents run --print` returns empty stdout. Use `kimi-chat` preset for scripting.',
+        description: 'Kimi K2.5 via OpenRouter (262K ctx, $0.38/$1.72 per 1M). Top Kimi: 99% HumanEval, 76.8% SWE-bench. REASONING — works interactively, but `agents run kimi "<prompt>"` (headless) returns empty stdout. Use `kimi-chat` preset for scripting.',
         ...OPENROUTER_AUTH,
         env: {
             ANTHROPIC_BASE_URL: OPENROUTER_BASE,
@@ -40,7 +40,7 @@ export const PRESETS = [
     },
     {
         name: 'kimi-chat',
-        description: 'Kimi K2 0905 via OpenRouter (262K ctx, $0.40/$2.00 per 1M). Non-reasoning sibling of K2.5 — slightly older but PRINT-SAFE, works end-to-end with `agents run --print` and in scripts/automation.',
+        description: 'Kimi K2 0905 via OpenRouter (262K ctx, $0.40/$2.00 per 1M). Non-reasoning sibling of K2.5 — slightly older but HEADLESS-SAFE, works end-to-end with `agents run kimi-chat "<prompt>"` and in scripts/automation.',
         ...OPENROUTER_AUTH,
         env: {
             ANTHROPIC_BASE_URL: OPENROUTER_BASE,
@@ -50,7 +50,7 @@ export const PRESETS = [
     },
     {
         name: 'minimax',
-        description: 'MiniMax M2.5 via OpenRouter (230B params). #1 SWE-bench Verified (80.2%) on Apr 2026 leaderboards. REASONING — works interactively, --print returns empty.',
+        description: 'MiniMax M2.5 via OpenRouter (230B params). #1 SWE-bench Verified (80.2%) on Apr 2026 leaderboards. REASONING — works interactively, headless `agents run` returns empty stdout.',
         ...OPENROUTER_AUTH,
         env: {
             ANTHROPIC_BASE_URL: OPENROUTER_BASE,
@@ -60,7 +60,7 @@ export const PRESETS = [
     },
     {
         name: 'glm',
-        description: 'GLM 5 via OpenRouter (80K ctx, $0.72/$2.30 per 1M). #1 Chatbot Arena ELO (1451) among open-weight models on BenchLM.ai (Apr 2026). Prompt-complexity-dependent reasoning — Claude Code\'s 38K system prompt typically triggers thinking blocks, so --print is unreliable. Interactive use is fine.',
+        description: 'GLM 5 via OpenRouter (80K ctx, $0.72/$2.30 per 1M). #1 Chatbot Arena ELO (1451) among open-weight models on BenchLM.ai (Apr 2026). Prompt-complexity-dependent reasoning — Claude Code\'s 38K system prompt typically triggers thinking blocks, so headless invocations are unreliable. Interactive use is fine.',
         ...OPENROUTER_AUTH,
         env: {
             ANTHROPIC_BASE_URL: OPENROUTER_BASE,
@@ -70,7 +70,7 @@ export const PRESETS = [
     },
     {
         name: 'qwen',
-        description: 'Qwen3 Coder Next via OpenRouter (256K ctx, $0.15/$0.80 per 1M, sparse MoE 80B/3B active). Latest coding-specific Qwen (Feb 2026). PRINT-SAFE — works with `agents run --print`.',
+        description: 'Qwen3 Coder Next via OpenRouter (256K ctx, $0.15/$0.80 per 1M, sparse MoE 80B/3B active). Latest coding-specific Qwen (Feb 2026). HEADLESS-SAFE — works with `agents run qwen "<prompt>"`.',
         ...OPENROUTER_AUTH,
         env: {
             ANTHROPIC_BASE_URL: OPENROUTER_BASE,
@@ -80,7 +80,7 @@ export const PRESETS = [
     },
     {
         name: 'deepseek',
-        description: 'DeepSeek Chat V3 (0324) via OpenRouter. Latest DeepSeek Chat variant that ignores thinking:enabled. PRINT-SAFE. The newer V3.2 / V3.1-Terminus / V3.2-Speciale are reasoning variants — use `--model deepseek/deepseek-v3.2` to override if you want those for interactive use.',
+        description: 'DeepSeek Chat V3 (0324) via OpenRouter. Latest DeepSeek Chat variant that ignores thinking:enabled. HEADLESS-SAFE. The newer V3.2 / V3.1-Terminus / V3.2-Speciale are reasoning variants — use `--model deepseek/deepseek-v3.2` to override if you want those for interactive use.',
         ...OPENROUTER_AUTH,
         env: {
             ANTHROPIC_BASE_URL: OPENROUTER_BASE,

package/dist/lib/project-launch.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Launch-time project compile. Invoked by the agent shim's hot path (via
+ * `agents sync --launch`) between version resolve and binary exec.
+ *
+ * Three responsibilities, all skip-fast when there's nothing to do:
+ *
+ * 1. Compile project rules from `<cwd>/.agents/rules/` into `<cwd>/AGENTS.md`
+ *    (+ per-agent symlinks). Delegates to compileRulesForProject, which is
+ *    the same helper management-side `agents sync` uses.
+ *
+ * 2. Mirror project resources from `<cwd>/.agents/{subagents,commands,skills}`
+ *    into the agent's workspace-local discovery dirs (`<cwd>/.claude/agents/`,
+ *    `<cwd>/.claude/commands/`, `<cwd>/.claude/skills/`). File-level symlinks
+ *    so edits in the source dir are live without re-sync. Skips any dest
+ *    entry that already exists and isn't one of our symlinks (don't-clobber).
+ *    v1: claude-only. Other agents have varying workspace conventions (amp
+ *    uses `~/.config/amp`, antigravity uses `~/.gemini/antigravity-cli`,
+ *    codex/gemini/cursor lack subagent support entirely) — they're follow-up
+ *    material. NOTE: `.mcp.json` is intentionally NOT auto-symlinked from
+ *    the launch path — that's a supply-chain surface (cloning a hostile
+ *    repo would auto-register an attacker MCP server). Belongs to full
+ *    `agents sync` with explicit opt-in, not the hot path.
+ *
+ * 3. Synthesize four scope-grouped plugin marketplaces under the version's
+ *    `<versionHome>/.{agent}/plugins/marketplaces/` (for plugin-capable agents):
+ *      - agents-cli         ← ~/.agents/plugins/*           (user scope, legacy name)
+ *      - agents-system      ← ~/.agents/.system/plugins/*
+ *      - extras-<alias>     ← ~/.agents-<alias>/plugins/*   (per enabled extra)
+ *      - agents-project     ← <cwd>/.agents/plugins/*
+ *    Each plugin is copied in (skip-fast via mtime cache), the marketplace
+ *    catalog is rewritten only when contents change, and the marketplace is
+ *    registered in known_marketplaces.json. Upstream marketplaces like
+ *    "claude-plugins-official" are left untouched. Project- and extras-
+ *    scope plugins do NOT auto-enable exec surfaces (.mcp.json, hooks, bin/,
+ *    scripts/) — user must explicitly `agents plugins enable` them.
+ *
+ * Heavy work (version-home reconciliation, hook registration, MCP merging)
+ * stays in `agents sync` without --launch and is NOT touched here. The
+ * launch path is filesystem-only and skip-fast: sub-50ms when no source
+ * has changed, scales linearly only with newly-modified plugins on the
+ * change path.
+ */
+import type { AgentId } from './types.js';
+import { pluginInstallDir } from './plugin-marketplace.js';
+export interface LaunchSyncOptions {
+    agent: AgentId;
+    version: string;
+    cwd: string;
+}
+export interface LaunchSyncResult {
+    /** Project rules were re-compiled into cwd/AGENTS.md (+ per-agent symlinks). */
+    rulesCompiled: boolean;
+    /** Number of workspace resource symlinks created or refreshed. */
+    workspaceLinks: number;
+    /** Workspace resource paths we left alone because they exist and aren't ours. */
+    workspaceSkipped: string[];
+    /** Map of marketplace name → plugin names installed under it. */
+    marketplaces: Record<string, string[]>;
+}
+/**
+ * Run the launch-time project compile. Safe to call on every agent launch:
+ * each step is idempotent and skips when its inputs are missing.
+ */
+export declare function runLaunchSync(opts: LaunchSyncOptions): LaunchSyncResult;
+export { pluginInstallDir };