agents-inc 0.170.2 → 0.172.0

package/dist/{chunk-HACRR422.js → chunk-MOL2J5HS.js}

@@ -6,7 +6,7 @@ import {
   hostAt,
   loadInstalledConfig,
   refuseUnofferedPlacements
-} from "./chunk-GAKVZNTX.js";
+} from "./chunk-VILFCMRN.js";
 
 // src/cli/lib/hosts/configured-placements.ts
 async function unofferablePlacementsFound(cwd) {
@@ -36,4 +36,4 @@ async function configuredSkillsAt(root) {
 export {
   unofferablePlacementsFound
 };
-//# sourceMappingURL=chunk-HACRR422.js.map
+//# sourceMappingURL=chunk-MOL2J5HS.js.map

package/dist/{chunk-BBDGYJHX.js → chunk-N33AKFLR.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   SCROLL_VIEWPORT
-} from "./chunk-7C3PFRBU.js";
+} from "./chunk-MHAQWMNJ.js";
 
 // src/cli/components/common/scroll-affordance.tsx
 import { Box, Text } from "ink";
@@ -21,4 +21,4 @@ var ScrollAffordance = ({ hiddenAbove, hiddenBelow }) => {
 export {
   ScrollAffordance
 };
-//# sourceMappingURL=chunk-BBDGYJHX.js.map
+//# sourceMappingURL=chunk-N33AKFLR.js.map

package/dist/{chunk-5BNX73OU.js → chunk-NISWBQNS.js}

@@ -1,36 +1,43 @@
 #!/usr/bin/env node
 import {
   listAgentMdFiles
-} from "./chunk-2YA4DDRM.js";
+} from "./chunk-LUKDDHSI.js";
 import {
   agentCodec,
   agentFrontmatterValidationSchema,
   agentPluginName,
+  clearEarlierBuild,
+  computeShippedHash,
   computeStringHash,
   copy,
-  determinePluginVersion,
   directoryExists,
-  ensureDir,
   extractFrontmatter,
   formatZodIssues,
   generateAgentPluginManifest,
   getErrorMessage,
   getPluginAgentsDir,
   getPluginManifestPath,
+  holdsContentNoBuildMade,
+  isPathWithin,
   log,
+  readEarlierBuild,
   readFile,
   verbose,
+  versionAfterRebuild,
   warn,
   writeContentHash,
   writePluginManifest
-} from "./chunk-GAKVZNTX.js";
+} from "./chunk-VILFCMRN.js";
 import {
   plural
-} from "./chunk-AUNRHWH4.js";
+} from "./chunk-7OG635DK.js";
 import {
+  DEFAULT_VERSION,
   DIRS,
+  PLUGIN_MANIFEST_DIR,
+  PLUGIN_MANIFEST_FILE,
   PROJECT_ROOT
-} from "./chunk-7C3PFRBU.js";
+} from "./chunk-MHAQWMNJ.js";
 
 // src/cli/lib/agents/agent-fetcher.ts
 import path from "path";
@@ -65,39 +72,53 @@ function parseAgentFrontmatter(content) {
     frontmatter: { name: result.data.name, description: result.data.description }
   };
 }
-async function compileAgentPlugin(options) {
-  const { agentPath, outputDir } = options;
-  const fileName = path2.basename(agentPath);
+async function assertClearable(pluginDir, agentPath) {
+  const agent = `Agent '${path2.basename(agentPath)}'`;
+  const file = `File: ${agentPath}`;
+  if (isPathWithin(agentPath, pluginDir)) {
+    throw new Error(
+      `${agent} would be built into ${pluginDir}, which holds its own source, so building it would overwrite that source. Build into an output directory outside the agents directory. ${file}`
+    );
+  }
+  if (await holdsContentNoBuildMade(pluginDir)) {
+    throw new Error(
+      `${agent} would be built into ${pluginDir}, which holds no ${path2.join(PLUGIN_MANIFEST_DIR, PLUGIN_MANIFEST_FILE)} and is not empty, so no earlier build made it and a rebuild would delete what it holds. Move its contents out, or build into another output directory. ${file}`
+    );
+  }
+}
+async function readAgentToBuild(agentPath) {
   const content = await readFile(agentPath);
   const parsed = parseAgentFrontmatter(content);
   if (!parsed.ok) {
     throw new Error(
-      `Agent '${fileName}' has invalid or missing YAML frontmatter: ${parsed.reason}. File: ${agentPath}`
+      `Agent '${path2.basename(agentPath)}' has invalid or missing YAML frontmatter: ${parsed.reason}. File: ${agentPath}`
     );
   }
-  const agentName = parsed.frontmatter.name;
-  verbose(`Compiling agent plugin: ${agentName} from ${agentPath}`);
+  return { content, frontmatter: parsed.frontmatter };
+}
+async function copyAgentInto(pluginDir, agentPath, agentName) {
+  const pluginAgentFile = `${agentName}${agentCodec("claude").extension}`;
+  await copy(agentPath, path2.join(getPluginAgentsDir(pluginDir), pluginAgentFile));
+  verbose(`  Copied agent ${path2.basename(agentPath)} -> agents/${pluginAgentFile}`);
+}
+async function compileAgentPlugin(options) {
+  const { agentPath, outputDir } = options;
+  const { content, frontmatter } = await readAgentToBuild(agentPath);
+  const agentName = frontmatter.name;
   const pluginDir = path2.join(outputDir, agentPluginName(agentName));
-  const agentsDir = getPluginAgentsDir(pluginDir);
-  await ensureDir(pluginDir);
-  await ensureDir(agentsDir);
-  const newHash = computeStringHash(content);
-  const { version, contentHash } = await determinePluginVersion(
-    newHash,
-    pluginDir,
-    getPluginManifestPath
+  await assertClearable(pluginDir, agentPath);
+  verbose(`Compiling agent plugin: ${agentName} from ${agentPath}`);
+  const manifestAt = (version) => generateAgentPluginManifest({ agentName, description: frontmatter.description, version });
+  const earlierBuild = await readEarlierBuild(pluginDir, getPluginManifestPath);
+  await clearEarlierBuild(pluginDir);
+  await writePluginManifest(pluginDir, manifestAt(earlierBuild?.version ?? DEFAULT_VERSION));
+  await writeContentHash(pluginDir, computeStringHash(content), getPluginManifestPath);
+  await copyAgentInto(pluginDir, agentPath, agentName);
+  const manifest = manifestAt(
+    versionAfterRebuild(earlierBuild, await computeShippedHash(pluginDir))
   );
-  const manifest = generateAgentPluginManifest({
-    agentName,
-    description: parsed.frontmatter.description,
-    version
-  });
   await writePluginManifest(pluginDir, manifest);
-  await writeContentHash(pluginDir, contentHash, getPluginManifestPath);
-  verbose(`  Wrote plugin.json for ${agentName} (v${version})`);
-  const pluginAgentFile = `${agentName}${agentCodec("claude").extension}`;
-  await copy(agentPath, path2.join(agentsDir, pluginAgentFile));
-  verbose(`  Copied agent ${fileName} -> agents/${pluginAgentFile}`);
+  verbose(`  Wrote plugin.json for ${agentName} (v${manifest.version})`);
   return {
     pluginPath: pluginDir,
     manifest,
@@ -136,4 +157,4 @@ export {
   compileAllAgentPlugins,
   printAgentCompilationSummary
 };
-//# sourceMappingURL=chunk-5BNX73OU.js.map
+//# sourceMappingURL=chunk-NISWBQNS.js.map

package/dist/chunk-NISWBQNS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/lib/agents/agent-fetcher.ts","../src/cli/lib/agents/agent-plugin-compiler.ts"],"sourcesContent":["import path from \"path\";\nimport { directoryExists } from \"../../utils/fs\";\nimport { verbose } from \"../../utils/logger\";\nimport { PROJECT_ROOT, DIRS } from \"../../consts\";\nimport type { AgentSourcePaths } from \"../../types\";\n\nexport async function getLocalAgentDefinitions(): Promise<AgentSourcePaths> {\n  const agentsDir = path.join(PROJECT_ROOT, DIRS.agents);\n\n  if (!(await directoryExists(agentsDir))) {\n    throw new Error(\n      `Agent partials not found at '${agentsDir}'. Ensure the CLI is properly installed.`,\n    );\n  }\n\n  verbose(`Agent partials loaded from CLI: ${agentsDir}`);\n\n  return {\n    agentsDir,\n    sourcePath: PROJECT_ROOT,\n  };\n}\n","import path from \"path\";\nimport { getErrorMessage } from \"../../utils/errors\";\nimport { readFile, copy, isPathWithin } from \"../../utils/fs\";\nimport { log, verbose, warn } from \"../../utils/logger\";\nimport {\n  agentPluginName,\n  clearEarlierBuild,\n  generateAgentPluginManifest,\n  getPluginAgentsDir,\n  holdsContentNoBuildMade,\n  writePluginManifest,\n  getPluginManifestPath,\n} from \"../plugins\";\nimport { listAgentMdFiles } from \"./list-compiled-agents\";\nimport { agentCodec } from \"../installation/install-layout\";\nimport {\n  computeShippedHash,\n  computeStringHash,\n  readEarlierBuild,\n  versionAfterRebuild,\n  writeContentHash,\n} from \"../versioning\";\nimport { extractFrontmatter } from \"../../utils/frontmatter\";\nimport { plural } from \"../../utils/string\";\nimport { DEFAULT_VERSION, PLUGIN_MANIFEST_DIR, PLUGIN_MANIFEST_FILE } from \"../../consts\";\nimport type { AgentFrontmatter, PluginManifest } from \"../../types\";\nimport { agentFrontmatterValidationSchema, formatZodIssues } from \"../schemas\";\n\ntype AgentPluginOptions = {\n  agentPath: string;\n  outputDir: string;\n};\n\ntype CompiledAgentPlugin = {\n  pluginPath: string;\n  manifest: PluginManifest;\n  agentName: string;\n};\n\n/** Carries the reason out, so the throw in `compileAgentPlugin` names what actually went wrong. */\ntype AgentFrontmatterParse =\n  | { ok: true; frontmatter: Pick<AgentFrontmatter, \"name\" | \"description\"> }\n  | { ok: false; reason: string };\n\nconst NO_FRONTMATTER_REASON = \"no YAML frontmatter block\";\n\nfunction parseAgentFrontmatter(content: string): AgentFrontmatterParse {\n  const raw = extractFrontmatter(content);\n  if (!raw) {\n    return { ok: false, reason: NO_FRONTMATTER_REASON };\n  }\n\n  const result = agentFrontmatterValidationSchema.safeParse(raw);\n  if (!result.success) {\n    return { ok: false, reason: formatZodIssues(result.error.issues) };\n  }\n\n  return {\n    ok: true,\n    frontmatter: { name: result.data.name, description: result.data.description },\n  };\n}\n\n/**\n * A plugin's folder is cleared before each build, so it must not hold the agent's own source, nor\n * files no build made. The name needs no check: the frontmatter schema holds it to kebab-case.\n */\nasync function assertClearable(pluginDir: string, agentPath: string): Promise<void> {\n  const agent = `Agent '${path.basename(agentPath)}'`;\n  const file = `File: ${agentPath}`;\n\n  if (isPathWithin(agentPath, pluginDir)) {\n    throw new Error(\n      `${agent} would be built into ${pluginDir}, which holds its own source, so building it would overwrite that source. Build into an output directory outside the agents directory. ${file}`,\n    );\n  }\n  if (await holdsContentNoBuildMade(pluginDir)) {\n    throw new Error(\n      `${agent} would be built into ${pluginDir}, which holds no ${path.join(PLUGIN_MANIFEST_DIR, PLUGIN_MANIFEST_FILE)} and is not empty, so no earlier build made it and a rebuild would delete what it holds. Move its contents out, or build into another output directory. ${file}`,\n    );\n  }\n}\n\n/** A plugin is built from the agent's frontmatter, so one that is absent or invalid refuses. */\nasync function readAgentToBuild(\n  agentPath: string,\n): Promise<{ content: string; frontmatter: Pick<AgentFrontmatter, \"name\" | \"description\"> }> {\n  const content = await readFile(agentPath);\n  const parsed = parseAgentFrontmatter(content);\n\n  if (!parsed.ok) {\n    throw new Error(\n      `Agent '${path.basename(agentPath)}' has invalid or missing YAML frontmatter: ${parsed.reason}. ` +\n        `File: ${agentPath}`,\n    );\n  }\n\n  return { content, frontmatter: parsed.frontmatter };\n}\n\nasync function copyAgentInto(\n  pluginDir: string,\n  agentPath: string,\n  agentName: string,\n): Promise<void> {\n  const pluginAgentFile = `${agentName}${agentCodec(\"claude\").extension}`;\n  await copy(agentPath, path.join(getPluginAgentsDir(pluginDir), pluginAgentFile));\n  verbose(`  Copied agent ${path.basename(agentPath)} -> agents/${pluginAgentFile}`);\n}\n\nasync function compileAgentPlugin(options: AgentPluginOptions): Promise<CompiledAgentPlugin> {\n  const { agentPath, outputDir } = options;\n  const { content, frontmatter } = await readAgentToBuild(agentPath);\n\n  const agentName = frontmatter.name;\n  const pluginDir = path.join(outputDir, agentPluginName(agentName));\n  await assertClearable(pluginDir, agentPath);\n\n  verbose(`Compiling agent plugin: ${agentName} from ${agentPath}`);\n\n  const manifestAt = (version: string): PluginManifest =>\n    generateAgentPluginManifest({ agentName, description: frontmatter.description, version });\n\n  // Read before the clear: what the earlier build shipped decides whether the version moves.\n  const earlierBuild = await readEarlierBuild(pluginDir, getPluginManifestPath);\n  await clearEarlierBuild(pluginDir);\n\n  // At the earlier build's version, so the version alone cannot set the two builds apart; and\n  // first, so a build that stops halfway leaves a folder the next build may clear.\n  await writePluginManifest(pluginDir, manifestAt(earlierBuild?.version ?? DEFAULT_VERSION));\n\n  // Nothing reads it back. Every plugin built so far ships it, so dropping it would bump them all.\n  await writeContentHash(pluginDir, computeStringHash(content), getPluginManifestPath);\n\n  await copyAgentInto(pluginDir, agentPath, agentName);\n\n  const manifest = manifestAt(\n    versionAfterRebuild(earlierBuild, await computeShippedHash(pluginDir)),\n  );\n  await writePluginManifest(pluginDir, manifest);\n  verbose(`  Wrote plugin.json for ${agentName} (v${manifest.version})`);\n\n  return {\n    pluginPath: pluginDir,\n    manifest,\n    agentName,\n  };\n}\n\nexport async function compileAllAgentPlugins(\n  agentsDir: string,\n  outputDir: string,\n): Promise<CompiledAgentPlugin[]> {\n  const results: CompiledAgentPlugin[] = [];\n\n  const agentMdFiles = await listAgentMdFiles(agentsDir);\n\n  for (const agentFile of agentMdFiles) {\n    const agentPath = path.join(agentsDir, agentFile);\n\n    try {\n      const result = await compileAgentPlugin({\n        agentPath,\n        outputDir,\n      });\n      results.push(result);\n      log(`  [OK] ${agentPluginName(result.agentName)}`);\n    } catch (error) {\n      const errorMessage = getErrorMessage(error);\n      warn(`Failed to compile agent from '${agentFile}': ${errorMessage}`);\n    }\n  }\n\n  return results;\n}\n\nexport function printAgentCompilationSummary(results: CompiledAgentPlugin[]): void {\n  log(`\\nCompiled ${plural(results.length, \"agent plugin\")}:`);\n  for (const result of results) {\n    log(`  - ${agentPluginName(result.agentName)} (v${result.manifest.version})`);\n  }\n}\n"],"mappings":"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","names":["path","path"]}