agents-inc 0.154.0 → 0.155.0

package/dist/{chunk-5MFJ24VM.js → chunk-H6UTKTLK.js}

@@ -1,54 +1,58 @@
 #!/usr/bin/env node
 import {
   SelectList
-} from "./chunk-XGMOXMS4.js";
+} from "./chunk-TBOVYLQJ.js";
 import {
-  promptValue
-} from "./chunk-OJJLYHM3.js";
+  seedToWizardResult
+} from "./chunk-MO5FGLVS.js";
+import {
+  runWizardSession
+} from "./chunk-IXRZAHZF.js";
+import {
+  useTerminalDimensions
+} from "./chunk-HG4JPXJT.js";
 import {
   Spinner
 } from "./chunk-ZBPEFQ4G.js";
 import {
-  runWizardSession
-} from "./chunk-QUDQTO3O.js";
+  fetchSeedConfig,
+  registerExternalSkills,
+  writeExternalSkills
+} from "./chunk-PMUABBPG.js";
 import {
-  useTerminalDimensions
-} from "./chunk-MJFIO5SX.js";
+  promptValue
+} from "./chunk-JCPANDNR.js";
 import {
   compileAgentsAllScopes,
   loadSource,
   writeProjectConfig
-} from "./chunk-XMEIVWAS.js";
+} from "./chunk-WUQ3MTPF.js";
 import {
   discoverInstalledSkills
-} from "./chunk-ZU6DAR4S.js";
-import {
-  copyLocalSkills
-} from "./chunk-UW44KSYL.js";
+} from "./chunk-5QZAK6J7.js";
 import {
   loadAgentDefs
-} from "./chunk-PRJD5MMQ.js";
+} from "./chunk-MHRC3KRX.js";
+import {
+  copyLocalSkills
+} from "./chunk-F2AMBBIA.js";
 import {
   render
 } from "./chunk-JFLVEFFP.js";
-import {
-  orderDomains
-} from "./chunk-QQTYMW7N.js";
 import {
   BaseCommand,
   EXIT_CODES
-} from "./chunk-FMYHWKGG.js";
+} from "./chunk-YO2LTXB4.js";
 import {
   clearTerminalScreen
-} from "./chunk-K3O3YQYG.js";
+} from "./chunk-G47TDUK3.js";
 import {
-  DEFAULT_SELECTION_OPTIONS,
   INSTALL_MODE_DESCRIPTIONS,
   INSTALL_MODE_LABELS,
   STATUS_MESSAGES,
   SUCCESS_MESSAGES,
-  activeAgentNames,
   buildAgentScopeMap,
+  carriedSkillsWritten,
   deriveInstallMode,
   detectGlobalInstallation,
   detectInstallation,
@@ -56,26 +60,20 @@ import {
   getInstallationInfo,
   globalScopedAgentsHint,
   isHomeDirectory,
-  isScopePairCompatible,
   loadProjectConfig,
-  loadProjectConfigFromDir,
   resolveInstallPaths,
-  seedPayloadSchema,
   sharedConfigExistingInstall,
   sharedConfigGlobalInstall,
-  validateSelection
-} from "./chunk-CBF4ZYV3.js";
+  skippedUnknownAgents,
+  skippedUnknownSkills
+} from "./chunk-WCAUUBHO.js";
 import {
-  AGENT_NAMES,
   fileExists,
   getErrorMessage,
   readFileSafe,
   settingsFileSchema,
   warn
-} from "./chunk-4VCWL2IG.js";
-import {
-  getCategoryDomain
-} from "./chunk-IPJOMAWC.js";
+} from "./chunk-XAXJWXI4.js";
 import {
   ASCII_LOGO,
   CLAUDE_DIR,
@@ -83,173 +81,17 @@ import {
   CLI_COLORS,
   CLI_INVOKE_COMMAND,
   DEFAULT_BRANDING,
-  DEFAULT_PUBLIC_SOURCE_NAME,
   EDIT_PROJECT_SETUP_FLAG,
   EJECT_SOURCE,
   MAX_CONFIG_FILE_SIZE,
   STANDARD_FILES
-} from "./chunk-R54KIGN2.js";
+} from "./chunk-IO5YBKHV.js";
 
 // src/cli/commands/init.tsx
-import os from "os";
 import "react";
 import { Flags } from "@oclif/core";
 import { Box as Box2, Text as Text2, useApp } from "ink";
 
-// src/cli/lib/seed/fetch-seed.ts
-var SEED_API_URL = process.env.AGENTS_INC_API_URL ?? "https://api.agentsinc.sh";
-var SEED_USER_AGENT = "agents-inc-cli";
-async function fetchSeedConfig(id) {
-  const url = `${SEED_API_URL}/configs/${encodeURIComponent(id)}`;
-  let response;
-  try {
-    response = await fetch(url, {
-      headers: { accept: "application/json", "user-agent": SEED_USER_AGENT }
-    });
-  } catch {
-    return { ok: false, error: `Could not reach ${SEED_API_URL} \u2014 check your connection.` };
-  }
-  if (response.status === 404) {
-    return { ok: false, error: `No configuration found for id '${id}'.` };
-  }
-  if (!response.ok) {
-    return { ok: false, error: `Fetching configuration failed (HTTP ${response.status}).` };
-  }
-  let body;
-  try {
-    body = await response.json();
-  } catch {
-    return { ok: false, error: "The configuration store returned something that is not JSON." };
-  }
-  const parsed = seedPayloadSchema.safeParse(body);
-  if (!parsed.success) {
-    return {
-      ok: false,
-      error: `Configuration '${id}' does not match the expected format \u2014 it may have been created by a newer version.`
-    };
-  }
-  return { ok: true, payload: parsed.data };
-}
-
-// src/cli/lib/seed/seed-to-wizard.ts
-var KNOWN_AGENTS = new Set(AGENT_NAMES);
-function sourceForSkill(skill) {
-  return skill?.availableSources?.find((s) => s.primary)?.name ?? DEFAULT_PUBLIC_SOURCE_NAME;
-}
-function addToDomainSelections(selections, domain, category, skillId) {
-  const categorySelections = selections[domain] ??= {};
-  const skillList = categorySelections[category] ??= [];
-  if (!skillList.includes(skillId)) skillList.push(skillId);
-}
-function addToAgentStack(stack, agent, category, assignment) {
-  const agentStack = stack[agent] ??= {};
-  const assignments = agentStack[category] ??= [];
-  assignments.push(assignment);
-}
-function toSkillAssignment(skillId, load) {
-  return { id: skillId, preloaded: load === "preloaded" };
-}
-function readAgentMap(agents) {
-  const known = /* @__PURE__ */ new Map();
-  const switchedOff = /* @__PURE__ */ new Set();
-  const unknown = [];
-  for (const [name, entry] of Object.entries(agents)) {
-    if (!KNOWN_AGENTS.has(name)) unknown.push(name);
-    else if (entry.on === false) switchedOff.add(name);
-    else known.set(name, entry);
-  }
-  return { known, switchedOff, unknown };
-}
-function seedAgentScope(entry) {
-  return entry?.scope ?? DEFAULT_SELECTION_OPTIONS.scope;
-}
-function agentScopeConfig(name, entry) {
-  return {
-    name,
-    scope: seedAgentScope(entry),
-    ...entry?.model !== void 0 && { model: entry.model },
-    ...entry?.effort !== void 0 && { effort: entry.effort }
-  };
-}
-function unwritableAssignmentsError(assignments) {
-  return [
-    "This configuration cannot be installed: a project-scoped skill never reaches a sub-agent that rests at global scope, so these assignments have nowhere to be written:",
-    ...assignments.map(({ skillId, agent }) => `  ${skillId} -> ${agent}`),
-    "Re-share it with each sub-agent above pinned to the project, or each skill above at global scope."
-  ].join("\n");
-}
-function seedToWizardResult(payload, matrix) {
-  const domainSelections = {};
-  const assignedStack = {};
-  const skills = [];
-  const skippedSkillIds = [];
-  const unwritable = [];
-  const agentNames = /* @__PURE__ */ new Set();
-  const agentMap = readAgentMap(payload.agents);
-  const skippedAgentNames = new Set(agentMap.unknown);
-  for (const [skillId, entry] of Object.entries(payload.skills)) {
-    const skill = matrix.skills[skillId];
-    const domain = skill?.category ? getCategoryDomain(skill.category) : void 0;
-    if (!skill?.category || !domain) {
-      skippedSkillIds.push(skillId);
-      continue;
-    }
-    const id = skillId;
-    const category = skill.category;
-    addToDomainSelections(domainSelections, domain, category, id);
-    skills.push({
-      id,
-      scope: entry.scope,
-      // "eject" is a source in its own right; anything else names the marketplace it came from.
-      source: entry.install === "eject" ? "eject" : sourceForSkill(skill)
-    });
-    for (const [agentName, load] of Object.entries(entry.assignments)) {
-      if (agentMap.switchedOff.has(agentName)) continue;
-      if (!KNOWN_AGENTS.has(agentName)) {
-        skippedAgentNames.add(agentName);
-        continue;
-      }
-      const agent = agentName;
-      if (!isScopePairCompatible(entry.scope, seedAgentScope(agentMap.known.get(agent)))) {
-        unwritable.push({ skillId: id, agent });
-        continue;
-      }
-      agentNames.add(agent);
-      addToAgentStack(assignedStack, agent, category, toSkillAssignment(id, load));
-    }
-  }
-  if (unwritable.length > 0) throw new Error(unwritableAssignmentsError(unwritable));
-  for (const [name, entry] of agentMap.known) {
-    if (entry.on === true) agentNames.add(name);
-  }
-  const selectedAgents = [...agentNames];
-  return {
-    result: {
-      skills,
-      selectedAgents,
-      agentConfigs: selectedAgents.map((name) => agentScopeConfig(name, agentMap.known.get(name))),
-      assignedStack,
-      selectedStackId: payload.stackId,
-      domainSelections,
-      selectedDomains: orderDomains(Object.keys(domainSelections)),
-      // Nothing was dropped from a *saved config* — the skipped ids came off the wire and are
-      // reported to the user directly, so there is no config removal to explain.
-      unresolvableSkillIds: [],
-      cancelled: false,
-      // Revalidated here rather than taken on trust from the app that built the payload. That app
-      // validated against ITS catalog; this one skips ids it does not know and carries its own
-      // relationship rules, so a configuration that was consistent where it was authored can
-      // arrive with a requirement genuinely unmet. Running the same validator the wizard runs
-      // makes that this catalog's verdict on what it can install — reported through the spine
-      // `init` already has, beside the skips that explain it — rather than a fault in what was
-      // shared.
-      validation: validateSelection(skills.map((skill) => skill.id))
-    },
-    skippedSkillIds,
-    skippedAgentNames: [...skippedAgentNames]
-  };
-}
-
 // src/cli/lib/permission-checker.tsx
 import "react";
 import "zod";
@@ -347,12 +189,12 @@ function formatDashboardText(data) {
   const lines = [
     DEFAULT_BRANDING.NAME,
     "",
-    `  Skills:  ${data.skillCount} installed`,
-    `  Agents:  ${data.agentCount} compiled`,
-    `  Mode:    ${modeLabel}`
+    `  Skills:       ${data.skillCount} installed`,
+    `  Agents:       ${data.agentCount} compiled`,
+    `  Mode:         ${modeLabel}`
   ];
   if (data.source) {
-    lines.push(`  Source:  ${data.source}`);
+    lines.push(`  Marketplace:  ${data.source}`);
   }
   lines.push("");
   lines.push(`  [Edit]  [Compile]  [Doctor]  [List]`);
@@ -388,6 +230,9 @@ async function runDashboardFlow(projectDir, config, origin, log) {
 function writesGlobalContent(result) {
   return result.skills.some((skill) => skill.scope === "global") || result.agentConfigs.some((agent) => agent.scope === "global");
 }
+function sharedConfigSourceFlags(flags, payload) {
+  return { marketplace: flags.marketplace ?? payload.marketplace };
+}
 var Init = class _Init extends BaseCommand {
   static summary = `Initialize ${DEFAULT_BRANDING.NAME} in this project`;
   static description = "Interactive wizard to set up skills and agents. Supports Plugin Mode (native install) and Eject Mode (copy to .claude/).";
@@ -398,13 +243,13 @@ var Init = class _Init extends BaseCommand {
     },
     {
       description: "Initialize from a custom marketplace",
-      command: "<%= config.bin %> <%= command.id %> --source github:org/marketplace"
+      command: "<%= config.bin %> <%= command.id %> --marketplace github:org/marketplace"
     }
   ];
   static flags = {
-    source: Flags.string({
-      char: "s",
-      description: "Skills source path or URL",
+    marketplace: Flags.string({
+      char: "m",
+      description: "Skills marketplace path or URL",
       required: false
     }),
     from: Flags.string({
@@ -431,25 +276,20 @@ var Init = class _Init extends BaseCommand {
     await this.handleInstallation(
       selection.result,
       selection.sourceResult,
-      flags,
+      selection.sourceFlags,
       selection.interactive
     );
   }
   /** The interactive producer: load the source, run the wizard, return what was chosen. */
   async selectionFromWizard(flags, projectDir) {
     const isGlobalRoot = isHomeDirectory(projectDir);
-    const { sourceResult, startupMessages, globalConfig } = await this.loadWizardInputsUnderSpinner(flags);
-    const result = await this.runWizard(
-      sourceResult,
-      startupMessages,
-      projectDir,
-      globalConfig,
-      isGlobalRoot
-    );
+    const { sourceResult, startupMessages } = await this.loadWizardInputsUnderSpinner(flags);
+    const result = await this.runWizard(startupMessages, isGlobalRoot);
     if (!result) return null;
     return {
       result,
       sourceResult,
+      sourceFlags: flags,
       // A person is already at the terminal, so the permission notice can wait for them.
       interactive: true,
       emptyMessage: "No skills selected"
@@ -469,11 +309,7 @@ var Init = class _Init extends BaseCommand {
       /* @__PURE__ */ jsx2(Spinner, { label: STATUS_MESSAGES.LOADING_SKILLS })
     );
     try {
-      const [source, globalConfig] = await Promise.all([
-        this.loadSourceOrFail(flags),
-        this.loadGlobalConfigIfExists()
-      ]);
-      return { ...source, globalConfig };
+      return await this.loadSourceOrFail(flags);
     } finally {
       clearSpinner();
       unmount();
@@ -483,8 +319,11 @@ var Init = class _Init extends BaseCommand {
    * The `--from <id>` producer: fetch and map, no wizard. Nothing here may assume a TTY — running
    * headless is most of why the flag exists.
    *
-   * It is also greenfield-only, which is what the two refusals are: a shared configuration is
-   * installed whole, so anything it would have to install over has to be uninstalled first.
+   * It is also greenfield-only, which is what two of the three refusals are: a shared
+   * configuration is installed whole, so anything it would have to install over has to be
+   * uninstalled first. The third is about the LOCATION rather than what is already in it — a
+   * global installation holds only global-scoped content, and this is the one producer that never
+   * asked. All three fire before anything is written.
    */
   async selectionFromSharedConfig(id, flags, projectDir) {
     await this.refuseInstalledProject(projectDir);
@@ -493,22 +332,22 @@ var Init = class _Init extends BaseCommand {
     if (!fetched.ok) {
       this.error(fetched.error, { exit: EXIT_CODES.ERROR });
     }
-    const { sourceResult } = await this.loadSourceOrFail(flags);
+    const sourceFlags = sharedConfigSourceFlags(flags, fetched.payload);
+    const { sourceResult } = await this.loadSourceOrFail(sourceFlags);
+    const carriedSkills = this.registerExternalSkillsOrFail(
+      fetched.payload,
+      sourceResult.matrix,
+      projectDir
+    );
     const { result, skippedSkillIds, skippedAgentNames } = this.decodeSeedOrFail(
       fetched.payload,
       sourceResult.matrix
     );
+    this.refuseProjectScopedContentAtHome(result, projectDir);
     await this.refuseBlockingGlobalInstall(result);
-    if (skippedSkillIds.length > 0) {
-      this.warn(
-        `Skipped ${skippedSkillIds.length} skill(s) this catalog does not know: ${skippedSkillIds.join(", ")}`
-      );
-    }
-    if (skippedAgentNames.length > 0) {
-      this.warn(
-        `Skipped ${skippedAgentNames.length} unknown sub-agent(s): ${skippedAgentNames.join(", ")}`
-      );
-    }
+    await this.writeCarriedSkills(carriedSkills);
+    if (skippedSkillIds.length > 0) this.warn(skippedUnknownSkills(skippedSkillIds));
+    if (skippedAgentNames.length > 0) this.warn(skippedUnknownAgents(skippedAgentNames));
     if (result.skills.length > 0) {
       this.log(
         `Installing ${result.skills.length} skill(s) across ${result.selectedAgents.length} sub-agent(s)
@@ -518,6 +357,7 @@ var Init = class _Init extends BaseCommand {
     return {
       result,
       sourceResult,
+      sourceFlags,
       interactive: false,
       emptyMessage: `Configuration '${id}' contains no skills this catalog can install.`
     };
@@ -563,21 +403,35 @@ var Init = class _Init extends BaseCommand {
       this.handleError(error);
     }
   }
+  /**
+   * Seats the catalogue entries the payload carries with it, or refuses the run.
+   *
+   * The refusal is `registerExternalSkills`' own — a carried skill asked for as a plugin, which
+   * no marketplace serves — and is reported with this command's exit code for the same reason the
+   * decode's is.
+   */
+  registerExternalSkillsOrFail(payload, matrix, projectDir) {
+    try {
+      return registerExternalSkills(payload, matrix, projectDir);
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  /** Writes the skills the payload brought with it, and says which they were. */
+  async writeCarriedSkills(carried) {
+    if (carried.length === 0) return;
+    await writeExternalSkills(carried);
+    this.log(carriedSkillsWritten(carried.map((skill) => skill.id)));
+  }
   async showDashboardIfInitialized(projectDir) {
     return runDashboardFlow(projectDir, this.config, "init", (msg) => this.log(msg));
   }
-  async loadGlobalConfigIfExists() {
-    const globalInstall = await detectGlobalInstallation();
-    if (!globalInstall) return null;
-    const loaded = await loadProjectConfigFromDir(os.homedir());
-    return loaded?.config ?? null;
-  }
   async loadSourceOrFail(flags) {
     try {
       const loaded = await loadSource({
-        // The one load that may CHOOSE a source rather than read the stored one.
+        // The one load that may CHOOSE a marketplace rather than read the stored one.
         caller: "init",
-        ...flags.source !== void 0 && { sourceFlag: flags.source },
+        ...flags.marketplace !== void 0 && { sourceFlag: flags.marketplace },
         projectDir: process.cwd(),
         captureStartupMessages: true
       });
@@ -588,24 +442,19 @@ var Init = class _Init extends BaseCommand {
       });
     }
   }
-  async runWizard(sourceResult, startupMessages, projectDir, globalConfig, isGlobalRoot) {
-    const selectedAgents = globalConfig?.agents && activeAgentNames(globalConfig.agents);
-    const globalSkills = globalConfig?.skills;
+  /**
+   * `init`'s wizard opens on an empty selection, and can open on nothing else: it is reached
+   * only once {@link showDashboardIfInitialized} has found no installation, and that check
+   * falls back to the home directory — so a global roster to hydrate from would have diverted
+   * this run to the dashboard before the wizard was built. Hydrating a saved selection is
+   * `edit`'s job, and `Edit.runEditWizard` is where it happens.
+   */
+  async runWizard(startupMessages, isGlobalRoot) {
     return runWizardSession({
-      hydrate: {
-        ...selectedAgents !== void 0 && { initialAgents: selectedAgents },
-        ...globalSkills !== void 0 && {
-          installedSkillIds: globalSkills.map((s) => s.id),
-          installedSkillConfigs: globalSkills
-        },
-        ...globalConfig?.agents !== void 0 && { installedAgentConfigs: globalConfig.agents },
-        isEditingFromGlobalScope: isGlobalRoot
-      },
+      hydrate: { isEditingFromGlobalScope: isGlobalRoot },
       props: {
         version: this.config.version,
         logo: ASCII_LOGO,
-        initialAgents: selectedAgents,
-        installedSkillIds: globalConfig?.skills.map((s) => s.id),
         startupMessages
       },
       onCancel: () => this.log("Setup cancelled"),
@@ -616,8 +465,8 @@ var Init = class _Init extends BaseCommand {
     const projectDir = process.cwd();
     const activeSkills = result.skills.filter((s) => !s.excluded);
     const installMode = deriveInstallMode(activeSkills);
-    const ejectedSkills = activeSkills.filter((s) => s.source === EJECT_SOURCE);
-    const pluginSkills = activeSkills.filter((s) => s.source !== EJECT_SOURCE);
+    const ejectedSkills = activeSkills.filter((s) => s.origin === EJECT_SOURCE);
+    const pluginSkills = activeSkills.filter((s) => s.origin !== EJECT_SOURCE);
     this.logInstallPlan(installMode, ejectedSkills, pluginSkills);
     const resolvedMarketplace = pluginSkills.length > 0 ? await this.requireMarketplaceOrExit(
       sourceResult,
@@ -626,7 +475,12 @@ var Init = class _Init extends BaseCommand {
     ) : null;
     const copyResult = installMode === "eject" || installMode === "mixed" ? await this.copyEjectSkillsStep(ejectedSkills, projectDir, sourceResult, installMode) : null;
     if (resolvedMarketplace !== null) {
-      await this.installPluginSkillsReported(pluginSkills, resolvedMarketplace, projectDir);
+      await this.installPluginSkillsReported(
+        pluginSkills,
+        resolvedMarketplace,
+        projectDir,
+        sourceResult.matrix
+      );
     }
     const pluginModeSucceeded = resolvedMarketplace !== null;
     try {
@@ -698,7 +552,7 @@ var Init = class _Init extends BaseCommand {
       wizardResult: result,
       sourceResult,
       projectDir: process.cwd(),
-      ...flags.source !== void 0 && { sourceFlag: flags.source }
+      ...flags.marketplace !== void 0 && { sourceFlag: flags.marketplace }
     });
     if (configResult.wasMerged) {
       this.log(`Merged with existing config at ${configResult.existingConfigPath}`);
@@ -850,7 +704,7 @@ async function getDashboardData(projectDir) {
   const skillCount = info?.skillCount ?? 0;
   const agentCount = info?.agentCount ?? 0;
   const mode = info?.mode ?? (activeSkills ? deriveInstallMode(activeSkills) : "eject");
-  const source = loaded?.config.source;
+  const source = loaded?.config.marketplace;
   return { skillCount, agentCount, mode, ...source !== void 0 && { source } };
 }
 
@@ -861,4 +715,4 @@ export {
   Init,
   getDashboardData
 };
-//# sourceMappingURL=chunk-5MFJ24VM.js.map
+//# sourceMappingURL=chunk-H6UTKTLK.js.map