agents-inc 0.174.0 → 0.176.0

package/dist/{chunk-FQF6VHO3.js → chunk-FACDJH6O.js}

@@ -1,19 +1,11 @@
 #!/usr/bin/env node
 import {
-  getSkillEntryDisplayName,
   typedValues
-} from "./chunk-AIBVAYHS.js";
+} from "./chunk-UE4Z3YMB.js";
 import {
-  CLI_COLORS,
-  EJECT_SOURCE,
-  UI_SYMBOLS,
   isActiveAt,
   isGlobalTombstone
-} from "./chunk-WUSEZFER.js";
-
-// src/cli/components/common/skill-agent-summary.tsx
-import { Box, Text } from "ink";
-import "react";
+} from "./chunk-U46LYYRA.js";
 
 // src/cli/lib/configuration/scope-diff.ts
 import { difference, indexBy, partition, unique } from "remeda";
@@ -116,6 +108,12 @@ function toRemovedSkillRow(skill) {
 function toRemovedAgentRow(agent) {
   return { name: agent.name, status: "removed" };
 }
+function namedByActiveEntries(entries) {
+  return indexBy(
+    entries.filter((entry) => !entry.excluded),
+    ({ id }) => id
+  );
+}
 var AGENT_SETTINGS = [
   ["model", (agent) => agent.model],
   ["codex model", (agent) => agent.codexModel],
@@ -137,8 +135,7 @@ function namedByEntries(change, before, after) {
   return { ...change, namedBy };
 }
 function activeEntriesOf(skillIds, skills) {
-  const active = skills.filter((entry) => !entry.excluded && skillIds.includes(entry.id));
-  return indexBy(active, ({ id }) => id);
+  return namedByActiveEntries(skills.filter((entry) => skillIds.includes(entry.id)));
 }
 function agentStateIn(config, name) {
   const agent = config.agents.find((entry) => entry.name === name && !entry.excluded);
@@ -164,100 +161,10 @@ function assignedSkillIds(rows) {
   return unique(typedValues(rows ?? {}).flatMap((assignments) => assignments.map(({ id }) => id)));
 }
 
-// src/cli/components/common/skill-agent-summary.tsx
-import { jsx, jsxs } from "react/jsx-runtime";
-var TableHeader = ({ children }) => /* @__PURE__ */ jsx(Text, { bold: true, color: CLI_COLORS.WARNING, children });
-var ScopeLabel = ({ children }) => /* @__PURE__ */ jsx(Text, { color: CLI_COLORS.WHITE, backgroundColor: CLI_COLORS.LABEL_BG, children: ` ${children} ` });
-var EjectIcon = () => /* @__PURE__ */ jsxs(Text, { color: CLI_COLORS.WARNING, children: [
-  " ",
-  UI_SYMBOLS.EJECT
-] });
-var DIFF_PREFIX = {
-  added: `${UI_SYMBOLS.ADDED} `,
-  "mode-changed": `${UI_SYMBOLS.CHANGED} `,
-  overwritten: `${UI_SYMBOLS.OVERWRITTEN} `,
-  changed: `${UI_SYMBOLS.CHANGED} `,
-  removed: `${UI_SYMBOLS.REMOVED} `,
-  unchanged: `${UI_SYMBOLS.BULLET} `
-};
-var DIFF_COLOR = {
-  added: CLI_COLORS.SUCCESS,
-  "mode-changed": CLI_COLORS.WARNING,
-  overwritten: CLI_COLORS.WARNING,
-  changed: CLI_COLORS.WARNING,
-  removed: CLI_COLORS.ERROR,
-  unchanged: CLI_COLORS.NEUTRAL
-};
-var NAME_GUTTER_COLUMNS = 3;
-var SkillRow = ({ row }) => /* @__PURE__ */ jsxs(Box, { width: "50%", paddingRight: NAME_GUTTER_COLUMNS, children: [
-  /* @__PURE__ */ jsx(Box, { flexShrink: 0, children: /* @__PURE__ */ jsx(Text, { color: DIFF_COLOR[row.status], children: DIFF_PREFIX[row.status] }) }),
-  /* @__PURE__ */ jsxs(Text, { color: DIFF_COLOR[row.status], children: [
-    getSkillEntryDisplayName(row),
-    row.source === EJECT_SOURCE && /* @__PURE__ */ jsx(EjectIcon, {})
-  ] })
-] });
-var AgentRow = ({ row }) => /* @__PURE__ */ jsxs(Text, { color: DIFF_COLOR[row.status], children: [
-  DIFF_PREFIX[row.status],
-  row.name
-] });
-var skillRowKey = (row) => row.status === "removed" ? `removed-${row.id}` : row.id;
-var agentRowKey = (row) => row.status === "removed" ? `removed-${row.name}` : row.name;
-var SkillAgentSummary = ({
-  skillConfigs,
-  agentConfigs,
-  ...baseline
-}) => {
-  const diff = computeScopeDiff({
-    currentSkills: skillConfigs,
-    currentAgents: agentConfigs,
-    ...baseline
-  });
-  if (!diff.hasContent) return null;
-  return /* @__PURE__ */ jsxs(Box, { flexDirection: "row", width: "100%", children: [
-    /* @__PURE__ */ jsxs(
-      Box,
-      {
-        flexDirection: "column",
-        borderStyle: "single",
-        flexGrow: 2,
-        flexBasis: 0,
-        borderRight: true,
-        borderTop: false,
-        borderBottom: false,
-        borderLeft: false,
-        borderColor: CLI_COLORS.NEUTRAL,
-        borderRightDimColor: true,
-        children: [
-          /* @__PURE__ */ jsx(TableHeader, { children: "Skills" }),
-          diff.projectSkillRows.length > 0 && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
-            /* @__PURE__ */ jsx(ScopeLabel, { children: "Project" }),
-            /* @__PURE__ */ jsx(Box, { flexWrap: "wrap", children: diff.projectSkillRows.map((row) => /* @__PURE__ */ jsx(SkillRow, { row }, skillRowKey(row))) })
-          ] }),
-          diff.globalSkillRows.length > 0 && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
-            /* @__PURE__ */ jsx(ScopeLabel, { children: "Global" }),
-            /* @__PURE__ */ jsx(Box, { flexWrap: "wrap", children: diff.globalSkillRows.map((row) => /* @__PURE__ */ jsx(SkillRow, { row }, skillRowKey(row))) })
-          ] })
-        ]
-      }
-    ),
-    /* @__PURE__ */ jsxs(Box, { flexDirection: "column", flexGrow: 1, flexBasis: 0, marginLeft: 1, paddingLeft: 1, children: [
-      /* @__PURE__ */ jsx(TableHeader, { children: "Agents" }),
-      diff.projectAgentRows.length > 0 && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
-        /* @__PURE__ */ jsx(ScopeLabel, { children: "Project" }),
-        /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: diff.projectAgentRows.map((row) => /* @__PURE__ */ jsx(AgentRow, { row }, agentRowKey(row))) })
-      ] }),
-      diff.globalAgentRows.length > 0 && /* @__PURE__ */ jsxs(Box, { flexDirection: "column", marginTop: 1, children: [
-        /* @__PURE__ */ jsx(ScopeLabel, { children: "Global" }),
-        /* @__PURE__ */ jsx(Box, { flexDirection: "column", children: diff.globalAgentRows.map((row) => /* @__PURE__ */ jsx(AgentRow, { row }, agentRowKey(row))) })
-      ] })
-    ] })
-  ] });
-};
-
 export {
   computeScopeDiff,
   formatScopeTag,
-  agentChangesAmong,
-  SkillAgentSummary
+  namedByActiveEntries,
+  agentChangesAmong
 };
-//# sourceMappingURL=chunk-FQF6VHO3.js.map
+//# sourceMappingURL=chunk-FACDJH6O.js.map

package/dist/chunk-FACDJH6O.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/configuration/scope-diff.ts"],"sourcesContent":["import { difference, indexBy, partition, unique } from \"remeda\";\nimport type { AgentScopeConfig, SkillConfig, SkillScope } from \"../../types/config\";\nimport type { AgentName, SkillId, StackAgentConfig } from \"../../types/index\";\nimport { typedValues } from \"../../utils/typed-object\";\nimport { isActiveAt, isGlobalTombstone, type ScopedEntry } from \"./scope-predicates\";\n\nexport type ScopeDiffInput = {\n  currentSkills: SkillConfig[];\n  currentAgents: AgentScopeConfig[];\n  installedSkillConfigs: SkillConfig[] | null;\n  installedAgentConfigs: AgentScopeConfig[] | null;\n  isInitMode: boolean;\n  /** Skills whose files the run writes over where they stand. */\n  overwrittenSkillIds?: ReadonlySet<SkillId>;\n  /** Sub-agents that keep their slot and still change. */\n  changedAgentNames?: ReadonlySet<AgentName>;\n};\n\nexport type DiffRowStatus =\n  \"added\" | \"mode-changed\" | \"overwritten\" | \"changed\" | \"removed\" | \"unchanged\";\n\nexport type SkillDiffRow = {\n  id: SkillId;\n  source: string;\n  status: Exclude<DiffRowStatus, \"changed\">;\n  /** The name the entry the row was drawn from records; absent where it records none. */\n  displayName?: string;\n};\n\nexport type AgentDiffRow = {\n  name: AgentName;\n  status: Exclude<DiffRowStatus, \"mode-changed\" | \"overwritten\">;\n};\n\nexport type ScopeDiff = {\n  projectSkillRows: SkillDiffRow[];\n  globalSkillRows: SkillDiffRow[];\n  projectAgentRows: AgentDiffRow[];\n  globalAgentRows: AgentDiffRow[];\n  hasContent: boolean;\n};\n\nconst NOTHING: ReadonlySet<never> = new Set();\n\n/** One scope's share of a roster's diff: the entries listed with a status, then the removals. */\ntype ScopeEntries<Entry> = { listed: Entry[]; removed: Entry[] };\n\ntype RosterDiff<Entry> = Record<SkillScope, ScopeEntries<Entry>>;\n\n/**\n * A tombstone occupies its (id, scope) slot without filling it: it silences a global install at\n * project scope. Slot checks count tombstones; removal and `~` read the active baseline only.\n */\nexport function computeScopeDiff(input: ScopeDiffInput): ScopeDiff {\n  const { currentSkills, currentAgents, installedSkillConfigs, installedAgentConfigs, isInitMode } =\n    input;\n  const overwritten = input.overwrittenSkillIds ?? NOTHING;\n  const changed = input.changedAgentNames ?? NOTHING;\n\n  const skills = diffRoster(currentSkills, installedSkillConfigs, (skill) => skill.id, isInitMode);\n  const agents = diffRoster(\n    currentAgents,\n    installedAgentConfigs,\n    (agent) => agent.name,\n    isInitMode,\n  );\n  const skillRow = skillRowClassifier(installedSkillConfigs, overwritten);\n  const agentRow = agentRowClassifier(installedAgentConfigs, changed);\n\n  const projectSkillRows = rowsOf(skills.project, skillRow, toRemovedSkillRow);\n  const globalSkillRows = rowsOf(skills.global, skillRow, toRemovedSkillRow);\n  const projectAgentRows = rowsOf(agents.project, agentRow, toRemovedAgentRow);\n  const globalAgentRows = rowsOf(agents.global, agentRow, toRemovedAgentRow);\n\n  const hasContent = [projectSkillRows, globalSkillRows, projectAgentRows, globalAgentRows].some(\n    (rows) => rows.length > 0,\n  );\n\n  return { projectSkillRows, globalSkillRows, projectAgentRows, globalAgentRows, hasContent };\n}\n\nfunction diffRoster<Entry extends ScopedEntry>(\n  current: Entry[],\n  installed: Entry[] | null,\n  identityOf: (entry: Entry) => string,\n  isInitMode: boolean,\n): RosterDiff<Entry> {\n  // The installs the baseline actually records; tombstones are not installs.\n  const activeBaseline = (installed ?? []).filter((entry) => !entry.excluded);\n  const vacated = vacatedInstalls(activeBaseline, current, identityOf);\n  const projectEntries = current.filter((entry) => isActiveAt(entry, \"project\"));\n  const claimedByProject = new Set(projectEntries.map(identityOf));\n  // A vacated global the project claims is inherited: listed once under Global, never removed.\n  const [inheritedGlobals, removedGlobals] = partition(\n    vacated.filter((entry) => entry.scope === \"global\"),\n    (entry) => claimedByProject.has(identityOf(entry)),\n  );\n\n  return {\n    project: {\n      listed: projectEntries,\n      removed: vacated.filter((entry) => entry.scope === \"project\"),\n    },\n    global: {\n      listed: [\n        ...current.filter((entry) => isActiveAt(entry, \"global\")),\n        ...inheritedGlobals,\n        ...current.filter(isGlobalTombstone),\n      ],\n      removed: isInitMode ? [] : removedGlobals,\n    },\n  };\n}\n\n/** Baseline installs whose slot nothing in current, active or tombstone, occupies. */\nfunction vacatedInstalls<Entry extends ScopedEntry>(\n  activeBaseline: Entry[],\n  current: Entry[],\n  identityOf: (entry: Entry) => string,\n): Entry[] {\n  const slotOf = (entry: Entry) => slotKey(identityOf(entry), entry.scope);\n  const occupiedSlots = new Set(current.map(slotOf));\n  return activeBaseline.filter((install) => !occupiedSlots.has(slotOf(install)));\n}\n\nfunction rowsOf<Entry, Row>(\n  entries: ScopeEntries<Entry>,\n  toRow: (entry: Entry) => Row,\n  toRemovedRow: (entry: Entry) => Row,\n): Row[] {\n  return [...entries.listed.map(toRow), ...entries.removed.map(toRemovedRow)];\n}\n\n/** The `(id, scope)` SLOT key this module diffs on, rather than the id alone. */\nfunction slotKey(identity: string, scope: SkillScope | undefined): string {\n  return `${identity}:${scope}`;\n}\n\nexport function formatScopeTag(scope: SkillScope): \"[G]\" | \"[P]\" {\n  return scope === \"global\" ? \"[G]\" : \"[P]\";\n}\n\nfunction skillRowClassifier(\n  installed: SkillConfig[] | null,\n  overwritten: ReadonlySet<SkillId>,\n): (skill: SkillConfig) => SkillDiffRow {\n  const installedSlots = installed\n    ? new Set(installed.map((skill) => slotKey(skill.id, skill.scope)))\n    : null;\n  const installedOriginBySlot = installed\n    ? new Map(\n        installed\n          .filter((skill) => !skill.excluded)\n          .map((skill) => [slotKey(skill.id, skill.scope), skill.origin]),\n      )\n    : null;\n  return (skill) => ({\n    id: skill.id,\n    source: skill.origin,\n    status: skillStatus(skill, installedSlots, installedOriginBySlot, overwritten),\n    ...recordedNameOf(skill),\n  });\n}\n\nfunction recordedNameOf(skill: SkillConfig): Pick<SkillDiffRow, \"displayName\"> {\n  return skill.displayName === undefined ? {} : { displayName: skill.displayName };\n}\n\nfunction agentRowClassifier(\n  installed: AgentScopeConfig[] | null,\n  changed: ReadonlySet<AgentName>,\n): (agent: AgentScopeConfig) => AgentDiffRow {\n  const installedSlots = installed\n    ? new Set(installed.map((agent) => slotKey(agent.name, agent.scope)))\n    : null;\n  return (agent) => ({ name: agent.name, status: agentStatus(agent, installedSlots, changed) });\n}\n\n/**\n * Compares `origin`, which is where a skill's install mode is recorded. An overwrite outranks a\n * mode change: a copy its plugin replaces is deleted, not merely switched. A mask is never written.\n */\nfunction skillStatus(\n  skill: SkillConfig,\n  installedSlots: Set<string> | null,\n  installedOriginBySlot: Map<string, string> | null,\n  overwritten: ReadonlySet<SkillId>,\n): SkillDiffRow[\"status\"] {\n  const slot = slotKey(skill.id, skill.scope);\n  if (installedSlots === null || !installedSlots.has(slot)) return \"added\";\n  if (!skill.excluded && overwritten.has(skill.id)) return \"overwritten\";\n\n  const installedOrigin = installedOriginBySlot?.get(slot);\n  const modeChanged = installedOrigin != null && installedOrigin !== skill.origin;\n  return modeChanged ? \"mode-changed\" : \"unchanged\";\n}\n\n/** A mask is never the sub-agent that changes: its active half is. */\nfunction agentStatus(\n  agent: AgentScopeConfig,\n  installedSlots: Set<string> | null,\n  changed: ReadonlySet<AgentName>,\n): AgentDiffRow[\"status\"] {\n  const isNew = installedSlots === null || !installedSlots.has(slotKey(agent.name, agent.scope));\n  if (isNew) return \"added\";\n  return !agent.excluded && changed.has(agent.name) ? \"changed\" : \"unchanged\";\n}\n\nfunction toRemovedSkillRow(skill: SkillConfig): SkillDiffRow {\n  return { id: skill.id, source: skill.origin, status: \"removed\", ...recordedNameOf(skill) };\n}\n\nfunction toRemovedAgentRow(agent: AgentScopeConfig): AgentDiffRow {\n  return { name: agent.name, status: \"removed\" };\n}\n\n/** The entry each skill is named by, as a panel row drawn from that entry names it. */\nexport type NamedBy = Partial<Record<SkillId, Pick<SkillConfig, \"id\" | \"displayName\">>>;\n\nexport function namedByActiveEntries(\n  entries: readonly Pick<SkillConfig, \"id\" | \"displayName\" | \"excluded\">[],\n): NamedBy {\n  return indexBy(\n    entries.filter((entry) => !entry.excluded),\n    ({ id }) => id,\n  );\n}\n\n/** A sub-agent that keeps its slot and still changes: the skills its rows gain and lose, and its retunes. */\nexport type AgentChange = {\n  name: AgentName;\n  scope: SkillScope;\n  gains: SkillId[];\n  loses: SkillId[];\n  settings: SettingChange[];\n  /** The run's entry for a skill it gains, the install's for one it loses. */\n  namedBy?: NamedBy;\n};\n\n/** `undefined` where the setting is left to its default. */\nexport type SettingChange = {\n  setting: AgentSetting;\n  from: string | undefined;\n  to: string | undefined;\n};\n\ntype AgentSetting = \"model\" | \"codex model\" | \"effort\";\n\nconst AGENT_SETTINGS: ReadonlyArray<\n  [AgentSetting, (agent: AgentScopeConfig) => string | undefined]\n> = [\n  [\"model\", (agent) => agent.model],\n  [\"codex model\", (agent) => agent.codexModel],\n  [\"effort\", (agent) => agent.effort],\n];\n\n/** One sub-agent as a config records it: its entry and its skill rows. */\nexport type AgentState = { agent: AgentScopeConfig; rows: StackAgentConfig | undefined };\n\ntype AgentsAndRows = {\n  agents: AgentScopeConfig[];\n  skills: SkillConfig[];\n  stack?: Partial<Record<string, StackAgentConfig>>;\n};\n\n/** How each named sub-agent moves between two configs; one either config lacks is not named. */\nexport function agentChangesAmong(\n  names: readonly AgentName[],\n  before: AgentsAndRows,\n  after: AgentsAndRows,\n): AgentChange[] {\n  return names.flatMap((name) => {\n    const was = agentStateIn(before, name);\n    const is = agentStateIn(after, name);\n    if (was === undefined || is === undefined) return [];\n    return [namedByEntries(agentChange(was, is), before.skills, after.skills)];\n  });\n}\n\nfunction namedByEntries(\n  change: AgentChange,\n  before: SkillConfig[],\n  after: SkillConfig[],\n): AgentChange {\n  const namedBy = {\n    ...activeEntriesOf(change.loses, before),\n    ...activeEntriesOf(change.gains, after),\n  };\n  return { ...change, namedBy };\n}\n\nfunction activeEntriesOf(skillIds: readonly SkillId[], skills: SkillConfig[]): NamedBy {\n  return namedByActiveEntries(skills.filter((entry) => skillIds.includes(entry.id)));\n}\n\n/** Its active entry, never the mask a project's own copy leaves; `undefined` where none is. */\nfunction agentStateIn(config: AgentsAndRows, name: AgentName): AgentState | undefined {\n  const agent = config.agents.find((entry) => entry.name === name && !entry.excluded);\n  return agent === undefined ? undefined : { agent, rows: config.stack?.[name] };\n}\n\nexport function agentChange(before: AgentState, after: AgentState): AgentChange {\n  const beforeIds = assignedSkillIds(before.rows);\n  const afterIds = assignedSkillIds(after.rows);\n\n  return {\n    name: after.agent.name,\n    scope: after.agent.scope,\n    gains: difference(afterIds, beforeIds),\n    loses: difference(beforeIds, afterIds),\n    settings: settingChanges(before.agent, after.agent),\n  };\n}\n\nfunction settingChanges(before: AgentScopeConfig, after: AgentScopeConfig): SettingChange[] {\n  return AGENT_SETTINGS.filter(([, read]) => read(before) !== read(after)).map(\n    ([setting, read]) => ({ setting, from: read(before), to: read(after) }),\n  );\n}\n\nfunction assignedSkillIds(rows: StackAgentConfig | undefined): SkillId[] {\n  return unique(typedValues(rows ?? {}).flatMap((assignments) => assignments.map(({ id }) => id)));\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-TVEDNGVP.js → chunk-H6WUOW5F.js}

@@ -2,7 +2,7 @@
 import {
   execCommand,
   getErrorMessage
-} from "./chunk-E45IT3HC.js";
+} from "./chunk-ENET4IF6.js";
 
 // src/cli/utils/open-url.ts
 function browserOpenerCommand(platform, url) {
@@ -32,4 +32,4 @@ async function openUrl(url) {
 export {
   openUrl
 };
-//# sourceMappingURL=chunk-TVEDNGVP.js.map
+//# sourceMappingURL=chunk-H6WUOW5F.js.map

package/dist/{chunk-7BHDKEGK.js → chunk-JNRACLNS.js}

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   getLocalAgentDefinitions
-} from "./chunk-IXVGBUWI.js";
+} from "./chunk-EC3JXT23.js";
 import {
   loadMergedAgents
-} from "./chunk-E45IT3HC.js";
+} from "./chunk-ENET4IF6.js";
 
 // src/cli/lib/operations/project/load-agent-defs.ts
 async function loadAgentDefs() {
@@ -20,4 +20,4 @@ async function loadAgentDefs() {
 export {
   loadAgentDefs
 };
-//# sourceMappingURL=chunk-7BHDKEGK.js.map
+//# sourceMappingURL=chunk-JNRACLNS.js.map

package/dist/{chunk-IAQFZFWD.js → chunk-JTMSFBCA.js}

@@ -1,12 +1,23 @@
 #!/usr/bin/env node
 import {
+  namedByActiveEntries
+} from "./chunk-FACDJH6O.js";
+import {
+  ConfigLoadError,
+  FailedLeavingPluginsSwitchedOnError,
+  INFO_MESSAGES,
+  PluginsLeftSwitchedOnError,
   STATUS_MESSAGES,
   addedToGlobalSubAgents,
   buildMarketplacePluginRef,
+  chooseProviderForThisRun,
   claimSlug,
+  codexPluginLeftSwitchedOn,
   completedWithFailures,
+  configDeclaresNothing,
   copy,
   defaultUsageGuidance,
+  detectInstallations,
   directoryExists,
   fetchMarketplace,
   fileExists,
@@ -16,6 +27,7 @@ import {
   getErrorMessage,
   getStackSkillIds,
   glob,
+  holdsAConfigDeclaringNothing,
   hostAt,
   installationConfigsUnreadable,
   isHomeDirectory,
@@ -24,6 +36,7 @@ import {
   loadStackById,
   parseFrontmatter,
   pluginsInstalled,
+  pluginsLeftSwitchedOn,
   propagatedRecompileSummary,
   providerInUse,
   providerToNameAt,
@@ -44,13 +57,13 @@ import {
   sharedConfigProjectScopeAtHome,
   skillAssignedToNoAgent,
   skillMetadataUnusableDetail,
+  skippedSkills,
   skippedUnknownAgents,
-  skippedUnknownSkills,
   validateSkillPath,
   verbose,
   warn,
   writeFile
-} from "./chunk-E45IT3HC.js";
+} from "./chunk-ENET4IF6.js";
 import {
   BUILT_IN_MATRIX,
   getCategoryDomain,
@@ -60,22 +73,24 @@ import {
   typedEntries,
   typedKeys,
   typedValues
-} from "./chunk-AIBVAYHS.js";
+} from "./chunk-UE4Z3YMB.js";
 import {
   CLI_COLORS,
   CLI_INVOKE_COMMAND,
   DEFAULT_BRANDING,
+  EDITOR_URL,
   EJECT_SOURCE,
   GITHUB_PREFIX,
   GITHUB_SOURCE,
   LOCAL_SKILLS_PATH,
   MIN_TERMINAL_SIZE,
+  PROVIDERS,
   STANDARD_FILES,
   externalIdsNamingNoDirectory,
   isActiveAt,
   orderDomains,
   seedExternalSkillSchema
-} from "./chunk-WUSEZFER.js";
+} from "./chunk-U46LYYRA.js";
 
 // src/cli/utils/terminal.ts
 function clearTerminalScreen() {
@@ -103,8 +118,100 @@ var EXIT_CODES = {
   COMPLETED_WITH_FAILURES: 5
 };
 
-// src/cli/lib/seed/external-skills.ts
+// src/cli/lib/installation/provider-flag.ts
 import os from "os";
+import { Flags } from "@oclif/core";
+function providerFlag() {
+  return Flags.string({
+    description: "Which provider's installation this run is about",
+    helpValue: `<${PROVIDERS.join("|")}>`,
+    options: [...PROVIDERS]
+  });
+}
+function providerNamedBy(flagValue) {
+  if (flagValue === void 0) return void 0;
+  return PROVIDERS.find((provider) => provider === flagValue);
+}
+var PROVIDER_FLAG = "--provider";
+var PROVIDER_FLAG_WITH_ITS_VALUE = `${PROVIDER_FLAG}=`;
+var END_OF_FLAGS = "--";
+function providerNamedIn(argv) {
+  const end = argv.indexOf(END_OF_FLAGS);
+  const flags = end === -1 ? argv : argv.slice(0, end);
+  const spaced = flags.indexOf(PROVIDER_FLAG);
+  if (spaced !== -1) return providerNamedBy(flags[spaced + 1]);
+  const joined = flags.find((token) => token.startsWith(PROVIDER_FLAG_WITH_ITS_VALUE));
+  return providerNamedBy(joined?.slice(PROVIDER_FLAG_WITH_ITS_VALUE.length));
+}
+function providerNeedsAConfigurationToInstall() {
+  return `--provider names which installation to create and needs the configuration to create it from, so it is only meaningful beside --from. Build one at ${EDITOR_URL}, then run '${CLI_INVOKE_COMMAND} init --from <id> --provider <provider>'.`;
+}
+function ambiguousInstallation(subject, providers, scopeRoot) {
+  return `${scopeRoot} holds ${providers.length} installations \u2014 ${providers.join(" and ")} \u2014 so ${subject} cannot tell which one you mean. Name it with --provider <${providers.join("|")}>. Nothing has been changed.`;
+}
+async function installationsInPlay(cwd) {
+  const found = await detectInstallations(cwd);
+  const inTheProject = atScope(found, "project");
+  if (inTheProject.length > 0) return { scopeRoot: cwd, providers: providersOf(inTheProject) };
+  return { scopeRoot: os.homedir(), providers: providersOf(atScope(found, "global")) };
+}
+function atScope(found, scope) {
+  return found.filter((installation) => installation.scope === scope);
+}
+function providersOf(installations) {
+  return installations.map((installation) => installation.provider);
+}
+async function refuseAnAmbiguousInstallation(cwd, subject, named, onAmbiguous) {
+  if (named !== void 0) {
+    chooseProviderForThisRun(named);
+    return;
+  }
+  const { scopeRoot, providers } = await installationsInPlay(cwd);
+  if (providers.length <= 1) return;
+  onAmbiguous(ambiguousInstallation(subject, providers, scopeRoot));
+}
+async function holdsOnlyAConfigDeclaringNothing(cwd) {
+  if (!await holdsAConfigDeclaringNothing(cwd)) return false;
+  return atScope(await detectInstallations(cwd), "project").length === 0;
+}
+async function homeHoldsAnInstallationFor(cwd, named) {
+  const atHome = providersOf(atScope(await detectInstallations(cwd), "global")).filter(
+    (provider) => named === void 0 || provider === named
+  );
+  const declaringContent = await Promise.all(atHome.map(homeConfigDeclaresContent));
+  return declaringContent.includes(true);
+}
+async function homeConfigDeclaresContent(provider) {
+  try {
+    return !await configDeclaresNothing(os.homedir(), provider);
+  } catch (error) {
+    if (error instanceof ConfigLoadError) return true;
+    throw error;
+  }
+}
+async function providersInPlay(cwd) {
+  return (await installationsInPlay(cwd)).providers;
+}
+async function installationToName(cwd, named) {
+  if (named !== void 0) return named;
+  const providers = await providersInPlay(cwd);
+  return providers.length > 1 ? providers : void 0;
+}
+async function ambiguityFinding(cwd) {
+  const { scopeRoot, providers } = await installationsInPlay(cwd);
+  if (providers.length <= 1) return null;
+  return ambiguousInstallation("every command that acts on one", providers, scopeRoot);
+}
+async function otherInstallationsInThisScope(cwd) {
+  const { scopeRoot, providers } = await installationsInPlay(cwd);
+  const showing = providerInUse(scopeRoot);
+  const others = providers.filter((provider) => provider !== showing);
+  if (others.length === 0) return null;
+  return `${scopeRoot} holds ${providers.length} installations \u2014 ${providers.join(" and ")} \u2014 and this is the ${showing} one. Show another with --provider <${providers.join("|")}>.`;
+}
+
+// src/cli/lib/seed/external-skills.ts
+import os2 from "os";
 import path from "path";
 import { mkdtemp } from "fs/promises";
 
@@ -326,9 +433,38 @@ function notADirectoryNameError(ids) {
     "A skill id is the directory the skill is written into, so an id holding a path separator, or naming '.' or '..', would be written somewhere other than a directory of its own, and one holding a control character would hand it to the terminal wherever that directory is named. Re-share it with each skill above added again, which mints an id \u2014 'external-<category>-<name>' \u2014 that names one directory."
   ].join("\n");
 }
+var DIRECTORY_NAME_MAX_BYTES = 255;
+function overrunsADirectoryName(id) {
+  return Buffer.byteLength(id, "utf8") > DIRECTORY_NAME_MAX_BYTES;
+}
+function externalIdsTooLongForADirectory(payload) {
+  return Object.keys(payload.external ?? {}).filter(overrunsADirectoryName);
+}
+function tooLongForADirectoryError(ids) {
+  return [
+    "This configuration cannot be installed: these skills travel inside it under ids longer than a directory name may be:",
+    ...ids.map((id) => `  ${JSON.stringify(id)}`),
+    `A skill id is the directory the skill is written into, and a directory name may hold at most ${String(DIRECTORY_NAME_MAX_BYTES)} bytes, so none of these could be written. Re-share it without each skill above.`
+  ].join("\n");
+}
+var CARRIED_ID_PREFIX = "external-";
+function externalIdsLackingThePrefix(payload) {
+  return Object.keys(payload.external ?? {}).filter((id) => !id.startsWith(CARRIED_ID_PREFIX));
+}
+function lacksThePrefixError(ids) {
+  return [
+    "This configuration cannot be installed: these skills travel inside it under ids that do not start with 'external-':",
+    ...ids.map((id) => `  ${id}`),
+    "A skill id is the directory the skill installs into, and no marketplace may publish under the name 'external', so an id starting 'external-' is the only kind that can never take the place of a marketplace's skill. Re-share it with each skill above added again, which mints such an id \u2014 'external-<category>-<name>'."
+  ].join("\n");
+}
 function registerExternalSkills(payload, matrix2, projectDir) {
   const notDirectoryNames = externalIdsNamingNoDirectory(payload);
   if (notDirectoryNames.length > 0) throw new Error(notADirectoryNameError(notDirectoryNames));
+  const tooLong = externalIdsTooLongForADirectory(payload);
+  if (tooLong.length > 0) throw new Error(tooLongForADirectoryError(tooLong));
+  const unprefixed = externalIdsLackingThePrefix(payload);
+  if (unprefixed.length > 0) throw new Error(lacksThePrefixError(unprefixed));
   const externals = selectedExternals(payload);
   const asPlugin = askedForAsPlugin(externals);
   const colliding = claimingACatalogueId(externals, matrix2);
@@ -344,7 +480,7 @@ async function writeExternalSkills(installs) {
 var SCRATCH_DIR_PREFIX = "agents-inc-carried-";
 async function carriedSkillsThatDiffer(installs) {
   if (installs.length === 0) return [];
-  const scratch = await mkdtemp(path.join(os.tmpdir(), SCRATCH_DIR_PREFIX));
+  const scratch = await mkdtemp(path.join(os2.tmpdir(), SCRATCH_DIR_PREFIX));
   try {
     const written = await Promise.all(
       installs.map(async (install) => writeExternalSkill(await scratchCopyOf(install, scratch)))
@@ -495,7 +631,7 @@ async function readCarriedSkills(owned) {
 }
 
 // src/cli/lib/seed/seed-apply.ts
-import os2 from "os";
+import os3 from "os";
 import { isDeepEqual, omit, partition, pick } from "remeda";
 var NOTHING_KEPT = {
   authoredSkillIds: [],
@@ -572,7 +708,7 @@ function withAgentKeptRows(carried, agent, keptRows, payloadRows) {
   };
 }
 async function readInstalledGlobal(projectDir) {
-  const loaded = await loadProjectConfigFromDir(os2.homedir(), providerInUse(projectDir));
+  const loaded = await loadProjectConfigFromDir(os3.homedir(), providerInUse(projectDir));
   return loaded?.config ?? null;
 }
 var NO_GLOBAL_ENTRIES = { skillIds: [], agentNames: [] };
@@ -750,8 +886,12 @@ function entriesActiveAt(skills, agents, scope) {
     agentNames: agents.filter((agent) => isActiveAt(agent, scope)).map((agent) => agent.name)
   };
 }
+function panelRowEntries(held) {
+  return namedByActiveEntries(held.result.skills);
+}
 function joinedStatement(held) {
-  return held.joined.length === 0 ? [] : [addedToGlobalSubAgents(held.joined)];
+  if (held.joined.length === 0) return [];
+  return [addedToGlobalSubAgents(held.joined, panelRowEntries(held))];
 }
 function projectScopedContent(result) {
   return entriesActiveAt(result.skills, result.agentConfigs, "project");
@@ -769,19 +909,37 @@ import { unique } from "remeda";
 // src/cli/lib/operations/source/ensure-marketplace.ts
 async function ensureMarketplace(sourceResult, host) {
   const marketplace = await resolveMarketplaceName(sourceResult);
-  if (marketplace === null) return { marketplace: null, registered: false };
+  if (marketplace === null) return { marketplace: null, registered: false, leftOn: [] };
   const exists = await host.marketplaceExists(marketplace);
   if (!exists) {
     const marketplaceSource = sourceResult.sourceConfig.source.replace(/^github:/, "");
     await host.addMarketplace(marketplaceSource);
-    return { marketplace, registered: true };
+    return { marketplace, registered: true, leftOn: [] };
   }
+  const outcome = await refreshOutcome(marketplace, host);
+  warnOfShortfalls(outcome);
+  return { marketplace, registered: false, leftOn: outcome.leftOn };
+}
+async function refreshOutcome(marketplace, host) {
   try {
     await host.refreshMarketplace(marketplace);
-  } catch {
-    warn("Could not update marketplace \u2014 continuing with cached version");
+    return { refreshed: true, leftOn: [] };
+  } catch (error) {
+    return outcomeOfRefusal(error);
+  }
+}
+function outcomeOfRefusal(error) {
+  if (error instanceof PluginsLeftSwitchedOnError) return { refreshed: true, leftOn: error.leftOn };
+  if (error instanceof FailedLeavingPluginsSwitchedOnError) {
+    return { refreshed: false, leftOn: error.leftOn };
+  }
+  return { refreshed: false, leftOn: [] };
+}
+function warnOfShortfalls({ refreshed, leftOn }) {
+  if (!refreshed) warn("Could not update marketplace \u2014 continuing with cached version");
+  for (const { pluginKey, configFile, reason } of leftOn) {
+    warn(codexPluginLeftSwitchedOn(pluginKey, configFile, reason));
   }
-  return { marketplace, registered: false };
 }
 async function resolveMarketplaceName(sourceResult) {
   if (sourceResult.marketplace) return sourceResult.marketplace;
@@ -805,7 +963,12 @@ async function requireMarketplace(sourceResult, purpose, host) {
       error: `Cannot ${purpose}: marketplace could not be resolved from '${sourceResult.sourceConfig.source}'. Plugin install mode requires a marketplace \u2014 fix the marketplace or switch the affected skills to eject mode.`
     };
   }
-  return { ok: true, marketplace: mpResult.marketplace, registered: mpResult.registered };
+  return {
+    ok: true,
+    marketplace: mpResult.marketplace,
+    registered: mpResult.registered,
+    leftOn: mpResult.leftOn
+  };
 }
 
 // src/cli/lib/operations/skills/install-plugin-skills.ts
@@ -839,6 +1002,10 @@ async function installPluginSkills(skills, marketplace, projectDir) {
 var TERMINAL_RESIZE_POLL_MS = 500;
 var terminalColumns = () => process.stdout.columns ?? MIN_TERMINAL_SIZE.COLS;
 var terminalRows = () => process.stdout.rows ?? MIN_TERMINAL_SIZE.ROWS;
+function sayFirst(line) {
+  process.stderr.write(`${line}
+`);
+}
 function isTerminalBigEnough() {
   return isTerminalLargeEnough(terminalColumns(), terminalRows());
 }
@@ -872,10 +1039,27 @@ function hasActiveProjectEntry(skills, skillId) {
 var BaseCommand = class extends Command {
   /** Non-empty decides the exit code; see {@link exitIfWorkIncomplete}. */
   incompleteWork = [];
+  /** Warned of by the refresh that left them; non-empty fails the run, as in `update`. */
+  switchesLeftOn = [];
   async init() {
     await super.init();
     await this.ensureTerminalSize();
   }
+  /**
+   * Called first where a command starts work on the installation in play, which for a project whose
+   * config declares nothing is the global one, or none where HOME holds none the run could work on.
+   */
+  async sayWhenTheGlobalInstallationStandsIn(named) {
+    if (!await holdsOnlyAConfigDeclaringNothing(process.cwd())) return;
+    const standsIn = await homeHoldsAnInstallationFor(process.cwd(), named);
+    sayFirst(
+      standsIn ? INFO_MESSAGES.GLOBAL_INSTALLATION_STANDS_IN : INFO_MESSAGES.NO_GLOBAL_INSTALLATION_STANDS_IN
+    );
+  }
+  /** For a command that never works on the global installation: `line` says what it does instead. */
+  async sayWhenTheProjectsConfigDeclaresNothing(line) {
+    if (await holdsOnlyAConfigDeclaringNothing(process.cwd())) sayFirst(line);
+  }
   async ensureTerminalSize() {
     if (isTerminalBigEnough()) return;
     clearTerminalScreen();
@@ -908,6 +1092,7 @@ var BaseCommand = class extends Command {
     if (!required.ok) {
       this.error(required.error, { exit: EXIT_CODES.ERROR });
     }
+    this.switchesLeftOn.push(...required.leftOn);
     if (required.registered) {
       onRegistered?.(required.marketplace);
     }
@@ -971,10 +1156,11 @@ var BaseCommand = class extends Command {
     this.log(propagatedRecompileSummary(rewrittenCount + unchangedCount, failedCount));
   }
   reportUnassignedSkills(config, selected) {
+    const namedBy = namedByActiveEntries(selected);
     for (const { skillId, blockedBy } of findUnassignedSkills(config, selected)) {
-      this.warn(skillAssignedToNoAgent(skillId));
+      this.warn(skillAssignedToNoAgent(skillId, namedBy));
       if (blockedBy.length > 0) {
-        this.warn(scopeBlockedStackAssignment(blockedBy, skillId));
+        this.warn(scopeBlockedStackAssignment(blockedBy, skillId, namedBy));
       }
     }
   }
@@ -1014,14 +1200,17 @@ var BaseCommand = class extends Command {
     if (!isHomeDirectory(projectDir) || installsAtHome(result)) return;
     const { skillIds, agentNames } = projectScopedContent(result);
     const provider = providerToNameAt(projectDir, providerInUse(projectDir));
-    this.error(sharedConfigProjectScopeAtHome(skillIds, agentNames, installedHere, provider), {
-      exit: EXIT_CODES.ERROR
-    });
+    const namedBy = namedByActiveEntries(result.skills);
+    this.error(
+      sharedConfigProjectScopeAtHome(skillIds, agentNames, installedHere, provider, namedBy),
+      { exit: EXIT_CODES.ERROR }
+    );
   }
-  warnOfSkippedEntries(mapping) {
+  /** `unloadedSkillIds`: skills the marketplace ships and could not load, never unknown ones. */
+  warnOfSkippedEntries(mapping, unloadedSkillIds) {
     const { skippedSkillIds, skippedAgentNames, agentsOnlySkippedSkillsCarried } = mapping;
     if (skippedSkillIds.length > 0) {
-      this.warn(skippedUnknownSkills(skippedSkillIds, agentsOnlySkippedSkillsCarried));
+      this.warn(skippedSkills(skippedSkillIds, agentsOnlySkippedSkillsCarried, unloadedSkillIds));
     }
     if (skippedAgentNames.length > 0) this.warn(skippedUnknownAgents(skippedAgentNames));
   }
@@ -1068,17 +1257,34 @@ var BaseCommand = class extends Command {
   }
   /** Every command that records must call this; `this.exit` skips the `Error:` framing. */
   exitIfWorkIncomplete() {
+    this.listIncompleteWork();
+    this.failIfPluginsLeftSwitchedOn();
+    if (this.hasIncompleteWork) this.exit(EXIT_CODES.COMPLETED_WITH_FAILURES);
+  }
+  listIncompleteWork() {
     if (!this.hasIncompleteWork) return;
     this.log(`
 ${chalk.hex(CLI_COLORS.WARNING)(completedWithFailures(this.incompleteWork))}
 `);
-    this.exit(EXIT_CODES.COMPLETED_WITH_FAILURES);
+  }
+  failIfPluginsLeftSwitchedOn() {
+    if (this.switchesLeftOn.length === 0) return;
+    const pluginKeys = this.switchesLeftOn.map(({ pluginKey }) => pluginKey);
+    this.error(pluginsLeftSwitchedOn(pluginKeys), { exit: EXIT_CODES.ERROR });
   }
 };
 
 export {
   clearTerminalScreen,
   EXIT_CODES,
+  providerFlag,
+  providerNamedBy,
+  providerNamedIn,
+  providerNeedsAConfigurationToInstall,
+  refuseAnAmbiguousInstallation,
+  installationToName,
+  ambiguityFinding,
+  otherInstallationsInThisScope,
   registerExternalSkills,
   writeExternalSkills,
   carriedSkillsThatDiffer,
@@ -1089,8 +1295,9 @@ export {
   restoreInstalledGlobal,
   sameAssignments,
   notInstalledGlobally,
+  panelRowEntries,
   joinedStatement,
   installsAtHome,
   BaseCommand
 };
-//# sourceMappingURL=chunk-IAQFZFWD.js.map
+//# sourceMappingURL=chunk-JTMSFBCA.js.map