@iowarp/clio-coder 0.4.8 → 0.4.9

package/dist/{chunk-EXKUF426.js → chunk-7FBCRWVT.js}

@@ -30,7 +30,7 @@ import {
   isAgentProduct,
   isAgentProjectContextTier,
   parseResultContract
-} from "./chunk-ARRUMZ7X.js";
+} from "./chunk-I47EJPYL.js";
 import {
   extensionContentDigest,
   isSemanticVersion
@@ -38,7 +38,7 @@ import {
 import {
   readSettings,
   updateSettings
-} from "./chunk-PGEFOTJB.js";
+} from "./chunk-FPS4R2RN.js";
 import {
   warnLegacyNaming
 } from "./chunk-DVNAPPXU.js";
@@ -48,14 +48,14 @@ import {
 } from "./chunk-5EQO5NWP.js";
 import {
   ToolNames
-} from "./chunk-WLHX3MM5.js";
+} from "./chunk-V4XJWDHR.js";
 import {
   require_dist
 } from "./chunk-B5GGDIHT.js";
 import {
   buildSafeToolEnv,
   runCommandVector
-} from "./chunk-GJ24ODAX.js";
+} from "./chunk-XTQ7MEJG.js";
 import {
   withStateFileLockSync
 } from "./chunk-DVJL77SO.js";
@@ -73,234 +73,13 @@ import {
   init_esm_shims
 } from "./chunk-ECBHH7LU.js";
 
-// src/domains/agents/recipe.ts
-init_esm_shims();
-import path from "node:path";
-var AGENT_BUDGET_KEYS = ["toolCalls", "readReserve", "synthesis", "maximum"];
-function parseAgentBudgetPhase(value, prefix, relationTarget) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(`${prefix} must be a non-null YAML object`);
-  }
-  const record = value;
-  for (const key of Object.keys(record)) {
-    if (key !== "toolCalls" && key !== "readReserve") throw new Error(`${prefix}.${key} is unknown`);
-  }
-  for (const key of ["toolCalls", "readReserve"]) {
-    if (!Object.hasOwn(record, key)) throw new Error(`${prefix}.${key} is required`);
-  }
-  const toolCalls = record.toolCalls;
-  if (typeof toolCalls !== "number" || !Number.isSafeInteger(toolCalls)) {
-    throw new Error(`${prefix}.toolCalls must be a finite safe integer`);
-  }
-  if (toolCalls <= 0) throw new Error(`${prefix}.toolCalls must be greater than 0`);
-  const readReserve = record.readReserve;
-  if (typeof readReserve !== "number" || !Number.isSafeInteger(readReserve)) {
-    throw new Error(`${prefix}.readReserve must be a finite safe integer`);
-  }
-  if (readReserve < 0) throw new Error(`${prefix}.readReserve must be greater than or equal to 0`);
-  if (readReserve >= toolCalls) throw new Error(`${prefix}.readReserve must be less than ${relationTarget}`);
-  return { toolCalls, readReserve };
-}
-function parseAgentBudget(value, sourcePath) {
-  if (value === void 0) return void 0;
-  const prefix = `agent budget: ${sourcePath}: budget`;
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(`${prefix} must be a non-null YAML object`);
-  }
-  const record = value;
-  for (const key of Object.keys(record)) {
-    if (!AGENT_BUDGET_KEYS.includes(key)) {
-      throw new Error(`${prefix}.${key} is unknown`);
-    }
-  }
-  for (const key of ["toolCalls", "readReserve", "synthesis"]) {
-    if (!Object.hasOwn(record, key)) throw new Error(`${prefix}.${key} is required`);
-  }
-  const phase = parseAgentBudgetPhase(
-    { toolCalls: record.toolCalls, readReserve: record.readReserve },
-    prefix,
-    "budget.toolCalls"
-  );
-  const synthesis = record.synthesis;
-  if (typeof synthesis !== "boolean") throw new Error(`${prefix}.synthesis must be a boolean`);
-  const maximum = record.maximum === void 0 ? void 0 : parseAgentBudgetPhase(record.maximum, `${prefix}.maximum`, "budget.maximum.toolCalls");
-  if (maximum !== void 0) {
-    if (maximum.toolCalls < phase.toolCalls) {
-      throw new Error(`${prefix}.maximum.toolCalls must be greater than or equal to budget.toolCalls`);
-    }
-    if (maximum.readReserve < phase.readReserve) {
-      throw new Error(`${prefix}.maximum.readReserve must be greater than or equal to budget.readReserve`);
-    }
-  }
-  return { ...phase, synthesis, ...maximum === void 0 ? {} : { maximum } };
-}
-function recipeIdFromPath(absPath, rootDir) {
-  const resolvedRoot = path.resolve(rootDir);
-  const resolvedPath = path.resolve(absPath);
-  const relPath = path.relative(resolvedRoot, resolvedPath);
-  if (relPath === "" || relPath.startsWith("..") || path.isAbsolute(relPath)) {
-    throw new Error(`recipe: path must live under rootDir (${resolvedPath} not under ${resolvedRoot})`);
-  }
-  if (path.dirname(relPath) !== ".") {
-    throw new Error(`recipe: recipes must live directly under rootDir (${resolvedPath})`);
-  }
-  if (path.extname(relPath) !== ".md") {
-    throw new Error(`recipe: recipe files must end in .md (${resolvedPath})`);
-  }
-  const id = path.basename(relPath, ".md");
-  if (id === "") {
-    throw new Error(`recipe: recipe filename must not be empty (${resolvedPath})`);
-  }
-  return id;
-}
-
-// src/domains/agents/recipe-schema.ts
-init_esm_shims();
-var RECIPE_KEYS = [
-  "version",
-  "name",
-  "description",
-  "tools",
-  "skills",
-  "audience",
-  "category",
-  "capabilityClass",
-  "latencyClass",
-  "projectContextTier",
-  "budget",
-  "resultContract",
-  "tags"
-];
-var OPTIONAL_RECIPE_KEYS = ["product"];
-var ALL_RECIPE_KEYS = [...RECIPE_KEYS, ...OPTIONAL_RECIPE_KEYS];
-function requiredString(value, path6) {
-  if (typeof value !== "string" || value.trim().length === 0)
-    throw new Error(`agent recipe: ${path6} must be a non-empty string`);
-  return value;
-}
-function requiredStringArray(value, path6) {
-  if (!Array.isArray(value)) throw new Error(`agent recipe: ${path6} must be an array of strings`);
-  const entries = value.map((entry, index) => requiredString(entry, `${path6}[${index}]`));
-  if (new Set(entries).size !== entries.length) throw new Error(`agent recipe: ${path6} must not contain duplicates`);
-  return entries;
-}
-function enumValue(value, path6, predicate) {
-  if (!predicate(value)) throw new Error(`agent recipe: ${path6} has an unsupported value`);
-  return value;
-}
-function parseAudience(value, source, filepath) {
-  const audience = enumValue(value, `${filepath}: audience`, isAgentAudience);
-  if (source === "builtin") {
-    if (audience === "custom") {
-      throw new Error(`agent recipe: ${filepath}: a builtin recipe must not declare audience 'custom'`);
-    }
-    return audience;
-  }
-  if (audience !== "custom") {
-    throw new Error(
-      `agent recipe: ${filepath}: a ${source} recipe must declare audience 'custom', not '${audience}'; audience follows where the recipe was discovered and cannot be claimed in frontmatter`
-    );
-  }
-  return audience;
-}
-function parseTools(value, filepath) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) {
-    throw new Error(`agent recipe: ${filepath}: tools must be a { required, optional } object`);
-  }
-  const record = value;
-  if (Object.keys(record).some((key) => key !== "required" && key !== "optional")) {
-    throw new Error(`agent recipe: ${filepath}: tools has an unknown key`);
-  }
-  if (!("required" in record) || !("optional" in record)) {
-    throw new Error(`agent recipe: ${filepath}: tools.required and tools.optional are required`);
-  }
-  if (!Array.isArray(record.required) || !Array.isArray(record.optional)) {
-    throw new Error(`agent recipe: ${filepath}: tools.required and tools.optional must be arrays`);
-  }
-  const required = record.required.map((entry, index) => {
-    const entryPath = `${filepath}: tools.required[${index}]`;
-    if (typeof entry === "string") return requiredString(entry, entryPath);
-    if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
-      throw new Error(`agent recipe: ${entryPath} must be a tool name or { anyOf: [...] }`);
-    }
-    const group = entry;
-    if (Object.keys(group).length !== 1 || !("anyOf" in group)) {
-      throw new Error(`agent recipe: ${entryPath} must contain only anyOf`);
-    }
-    const anyOf = requiredStringArray(group.anyOf, `${entryPath}.anyOf`);
-    if (anyOf.length === 0) throw new Error(`agent recipe: ${entryPath}.anyOf must not be empty`);
-    return { anyOf };
-  });
-  const optional = requiredStringArray(record.optional, `${filepath}: tools.optional`);
-  const tools = [
-    ...required.flatMap((requirement) => typeof requirement === "string" ? [requirement] : requirement.anyOf),
-    ...optional
-  ];
-  if (new Set(tools).size !== tools.length)
-    throw new Error(`agent recipe: ${filepath}: tools contains duplicate requirements`);
-  return { tools, toolRequirements: { required, optional } };
-}
-function parseAgentRecipeSchema(input) {
-  const { frontmatter, filepath } = input;
-  for (const key of Object.keys(frontmatter)) {
-    if (!ALL_RECIPE_KEYS.includes(key)) {
-      throw new Error(`agent recipe: ${filepath}: unknown key '${key}'`);
-    }
-  }
-  for (const key of RECIPE_KEYS) {
-    if (!(key in frontmatter)) throw new Error(`agent recipe: ${filepath}: ${key} is required`);
-  }
-  if (frontmatter.version !== 1) throw new Error(`agent recipe: ${filepath}: version must be the supported integer 1`);
-  if (input.body.trim().length === 0) throw new Error(`agent recipe: ${filepath}: persona body must not be empty`);
-  const parsedTools = parseTools(frontmatter.tools, filepath);
-  const budget = parseAgentBudget(frontmatter.budget, filepath);
-  if (budget === void 0) throw new Error(`agent recipe: ${filepath}: budget is required`);
-  return {
-    version: 1,
-    id: input.id,
-    name: requiredString(frontmatter.name, `${filepath}: name`),
-    description: requiredString(frontmatter.description, `${filepath}: description`),
-    tools: parsedTools.tools,
-    toolRequirements: parsedTools.toolRequirements,
-    skills: requiredStringArray(frontmatter.skills, `${filepath}: skills`),
-    boundSkillPaths: [],
-    audience: parseAudience(frontmatter.audience, input.source, filepath),
-    category: enumValue(frontmatter.category, `${filepath}: category`, isAgentCategory),
-    capabilityClass: enumValue(
-      frontmatter.capabilityClass,
-      `${filepath}: capabilityClass`,
-      isAgentCapabilityClass
-    ),
-    latencyClass: enumValue(
-      frontmatter.latencyClass,
-      `${filepath}: latencyClass`,
-      isAgentLatencyClass
-    ),
-    projectContextTier: enumValue(
-      frontmatter.projectContextTier,
-      `${filepath}: projectContextTier`,
-      isAgentProjectContextTier
-    ),
-    budget,
-    resultContract: parseResultContract(frontmatter.resultContract, filepath),
-    // Optional, but not lenient. A misspelled product silently costs the run
-    // the delivery tools its reserve window was supposed to keep, and the
-    // only symptom is a blocked tool call deep in a dispatch log.
-    ...frontmatter.product === void 0 ? {} : { product: enumValue(frontmatter.product, `${filepath}: product`, isAgentProduct) },
-    tags: requiredStringArray(frontmatter.tags, `${filepath}: tags`),
-    source: input.source,
-    filepath,
-    body: input.body
-  };
-}
-
 // src/domains/plugins/catalog.ts
 init_esm_shims();
 var import_yaml = __toESM(require_dist(), 1);
 import { execFileSync } from "node:child_process";
 import { existsSync, mkdtempSync, readFileSync, realpathSync, rmSync, statSync } from "node:fs";
 import { homedir, tmpdir } from "node:os";
-import path2 from "node:path";
+import path from "node:path";
 function parsePluginGithubSource(source) {
   const match = /^https:\/\/github\.com\/([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)\/tree\/([A-Za-z0-9_.-]+)(?:\/(.*?))?\/?$/.exec(source);
   if (!match?.[1] || !match[2] || !match[3]) return void 0;
@@ -310,7 +89,7 @@ function parsePluginGithubSource(source) {
   return { url: `https://github.com/${match[1]}/${match[2]}.git`, ref: match[3], subdir };
 }
 function pluginLocalPath(source, cwd = process.cwd()) {
-  return path2.resolve(cwd, source.startsWith("~/") ? path2.join(homedir(), source.slice(2)) : source);
+  return path.resolve(cwd, source.startsWith("~/") ? path.join(homedir(), source.slice(2)) : source);
 }
 function fetchPluginSource(source, cwd = process.cwd()) {
   const local = pluginLocalPath(source, cwd);
@@ -321,7 +100,7 @@ function fetchPluginSource(source, cwd = process.cwd()) {
     throw new Error(
       `unsupported plugin source: ${source}; use a local directory or https://github.com/owner/repo/tree/ref/path`
     );
-  const temp = mkdtempSync(path2.join(tmpdir(), "clio-coder-plugin-"));
+  const temp = mkdtempSync(path.join(tmpdir(), "clio-coder-plugin-"));
   const cleanup = () => rmSync(temp, { recursive: true, force: true });
   try {
     execFileSync(
@@ -334,13 +113,13 @@ function fetchPluginSource(source, cwd = process.cwd()) {
         env: buildSafeToolEnv({ GIT_TERMINAL_PROMPT: "0", GIT_CONFIG_NOSYSTEM: "1" })
       }
     );
-    const root = path2.join(temp, remote.subdir);
+    const root = path.join(temp, remote.subdir);
     if (!existsSync(root) || !statSync(root).isDirectory())
       throw new Error(`plugin source has no directory ${remote.subdir || "."}: ${source}`);
-    const relative = path2.relative(realpathSync(temp), realpathSync(root));
-    if (relative === ".." || relative.startsWith(`..${path2.sep}`) || path2.isAbsolute(relative))
+    const relative = path.relative(realpathSync(temp), realpathSync(root));
+    if (relative === ".." || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative))
       throw new Error("plugin source escapes repository");
-    if (!remote.subdir) rmSync(path2.join(temp, ".git"), { recursive: true, force: true });
+    if (!remote.subdir) rmSync(path.join(temp, ".git"), { recursive: true, force: true });
     return { root, cleanup };
   } catch (error) {
     cleanup();
@@ -406,7 +185,7 @@ function readPluginCatalog(file, diagnostics) {
           kind: item.kind,
           name: item.name,
           description: item.description,
-          sourceUrl: remote ? item.sourceUrl : path2.resolve(path2.dirname(file), item.sourceUrl),
+          sourceUrl: remote ? item.sourceUrl : path.resolve(path.dirname(file), item.sourceUrl),
           version: item.version,
           sha256: item.sha256,
           origin: "catalog",
@@ -415,7 +194,7 @@ function readPluginCatalog(file, diagnostics) {
           ...Array.isArray(item.triggers) ? { triggers: item.triggers.filter((value) => typeof value === "string") } : {},
           ...Array.isArray(item.requires) ? { requires: item.requires } : {},
           ...provides ? { provides } : {},
-          index: path2.resolve(file)
+          index: path.resolve(file)
         }
       ];
     });
@@ -425,7 +204,7 @@ function readPluginCatalog(file, diagnostics) {
   }
 }
 function bundledLibraryIndexPath() {
-  return path2.join(resolvePackageRoot(), "library", "registry.yaml");
+  return path.join(resolvePackageRoot(), "library", "registry.yaml");
 }
 function bundledPluginCatalog(diagnostics) {
   try {
@@ -440,10 +219,10 @@ function bundledPluginCatalog(diagnostics) {
 init_esm_shims();
 var import_yaml2 = __toESM(require_dist(), 1);
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import path3 from "node:path";
+import path2 from "node:path";
 function catalogPath() {
   const configured = readSettings().integrations.library.catalog;
-  return path3.resolve(configured ?? path3.join(clioConfigDir(), "library.yaml"));
+  return path2.resolve(configured ?? path2.join(clioConfigDir(), "library.yaml"));
 }
 function parseCatalog(filePath, diagnostics) {
   return readPluginCatalog(filePath, diagnostics).map((entry) => ({ ...entry, origin: "index" }));
@@ -464,13 +243,13 @@ function discoverLibrary(options = {}) {
   const diagnostics = [];
   const bundledPlugins = bundledPluginCatalog(diagnostics);
   const privatePath = catalogPath();
-  const primary = options.catalog ? parseCatalog(path3.resolve(options.catalog), diagnostics) : [];
+  const primary = options.catalog ? parseCatalog(path2.resolve(options.catalog), diagnostics) : [];
   const privateEntries = parseCatalog(privatePath, diagnostics);
   const byRef = /* @__PURE__ */ new Map();
   for (const entry of [
     ...bundledPlugins,
     ...privateEntries,
-    ...parseCatalog(path3.join(options.cwd ?? process.cwd(), ".clio-coder", "library.yaml"), diagnostics),
+    ...parseCatalog(path2.join(options.cwd ?? process.cwd(), ".clio-coder", "library.yaml"), diagnostics),
     ...primary
   ])
     byRef.set(libraryEntryRef(entry), entry);
@@ -566,7 +345,7 @@ function registerLibraryPackage(source, options = {}) {
     origin: "index",
     ...manifest.clio.requires ? { requires: manifest.clio.requires } : {}
   };
-  const file = options.scope === "project" ? path3.join(options.cwd ?? process.cwd(), ".clio-coder", "library.yaml") : catalogPath();
+  const file = options.scope === "project" ? path2.join(options.cwd ?? process.cwd(), ".clio-coder", "library.yaml") : catalogPath();
   withStateFileLockSync(file, () => {
     const diagnostics = [];
     const before = existsSync2(file) ? readFileSync2(file, "utf8") : void 0;
@@ -608,7 +387,7 @@ function installedPlugin(entry, options = {}) {
 }
 function libraryInstallPath(entry, options = {}) {
   if (!/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(entry.name)) throw new Error(`invalid library entry name: ${entry.name}`);
-  return installedPlugin(entry, options)?.rootPath ?? path3.join(pluginBaseDir(options.scope ?? "user", options.cwd ?? process.cwd()), entry.name);
+  return installedPlugin(entry, options)?.rootPath ?? path2.join(pluginBaseDir(options.scope ?? "user", options.cwd ?? process.cwd()), entry.name);
 }
 function libraryEntryInstalled(entry, options = {}) {
   return installedPlugin(entry, options) !== void 0;
@@ -659,7 +438,7 @@ function planLibraryInstall(entry, options = {}) {
     if (entry.sha256 && sha2562 !== entry.sha256) throw new Error(`plugin_pin_mismatch: ${entry.name}`);
     return {
       entry: { ...entry, ...candidate.manifest.version ? { version: candidate.manifest.version } : {} },
-      path: path3.join(pluginBaseDir(options.scope ?? "user", options.cwd ?? process.cwd()), entry.name),
+      path: path2.join(pluginBaseDir(options.scope ?? "user", options.cwd ?? process.cwd()), entry.name),
       sha256: sha2562,
       sourceRoot: fetched.root,
       cleanup: fetched.cleanup,
@@ -823,7 +602,7 @@ async function syncLibrary(direction, runner = runCommandVector) {
   const settings = readSettings().integrations.library;
   if (!settings.sync) throw new Error("library_sync_disabled");
   const remote = confirmedRemote();
-  const cwd = path3.dirname(catalogPath());
+  const cwd = path2.dirname(catalogPath());
   const remoteResult = await runner("git", ["remote", "get-url", "library"], { cwd, workspaceRoot: cwd });
   if (remoteResult.exitCode !== 0 || remoteResult.stdout.trim() !== remote)
     throw new Error("library_remote_unconfirmed");
@@ -841,14 +620,14 @@ async function syncLibrary(direction, runner = runCommandVector) {
 // src/domains/resources/skills/marketplace.ts
 init_esm_shims();
 import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync4 } from "node:fs";
-import path5 from "node:path";
+import path4 from "node:path";
 
 // src/domains/resources/skills/loader.ts
 init_esm_shims();
 import { createHash } from "node:crypto";
 import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3, realpathSync as realpathSync2 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import path4 from "node:path";
+import path3 from "node:path";
 var MAX_NAME_LENGTH = 64;
 var MAX_DESCRIPTION_LENGTH = 1024;
 var MAX_SKILL_BYTES = 1024 * 1024;
@@ -908,7 +687,7 @@ function defaultSkillRoots(input = {}) {
   for (const kind of INTEROP_AGENT_KINDS) {
     if (kind.userSkillRoot === void 0 || kind.skillSource === void 0) continue;
     roots.push({
-      path: path4.join(home, kind.userSkillRoot),
+      path: path3.join(home, kind.userSkillRoot),
       scope: "user",
       source: kind.skillSource,
       origin: `${kind.skillSource}-user`,
@@ -919,7 +698,7 @@ function defaultSkillRoots(input = {}) {
   }
   if (configDir) {
     roots.push({
-      path: path4.join(configDir, "skills"),
+      path: path3.join(configDir, "skills"),
       scope: "user",
       source: "clio-coder",
       origin: "config",
@@ -931,7 +710,7 @@ function defaultSkillRoots(input = {}) {
   for (const kind of INTEROP_AGENT_KINDS) {
     if (kind.projectSkillRoot === void 0 || kind.skillSource === void 0) continue;
     roots.push({
-      path: path4.join(cwd, kind.projectSkillRoot),
+      path: path3.join(cwd, kind.projectSkillRoot),
       scope: "project",
       source: kind.skillSource,
       origin: `${kind.skillSource}-project`,
@@ -941,7 +720,7 @@ function defaultSkillRoots(input = {}) {
     });
   }
   roots.push({
-    path: path4.join(cwd, ".clio-coder", "skills"),
+    path: path3.join(cwd, ".clio-coder", "skills"),
     scope: "project",
     source: "clio-coder",
     origin: "project",
@@ -1015,7 +794,7 @@ function declaredToolSurface(frontmatter, key, filePath, diagnostics) {
   return tools.length > 0 ? tools : void 0;
 }
 function validationSubject(filePath) {
-  return path4.basename(filePath) === "SKILL.md" ? path4.basename(path4.dirname(filePath)) : path4.basename(filePath, ".md");
+  return path3.basename(filePath) === "SKILL.md" ? path3.basename(path3.dirname(filePath)) : path3.basename(filePath, ".md");
 }
 function validateNameFormat(name) {
   const errors = [];
@@ -1100,11 +879,11 @@ function canonicalizePath(filePath) {
   try {
     return realpathSync2.native(filePath);
   } catch {
-    return path4.resolve(filePath);
+    return path3.resolve(filePath);
   }
 }
 function pathIsInside(candidate, anchor) {
-  return candidate === anchor || candidate.startsWith(anchor + path4.sep);
+  return candidate === anchor || candidate.startsWith(anchor + path3.sep);
 }
 function containmentAnchor(root) {
   if (root.containment === void 0) return null;
@@ -1190,7 +969,7 @@ function loadSkillFile(filePath, root) {
   }
   for (const message of validateNameFormat(name)) diagnostics.push({ type: "warning", message, path: filePath });
   if (!description) return { candidate: null, diagnostics };
-  const baseDir = path4.dirname(filePath);
+  const baseDir = path3.dirname(filePath);
   const scope = root.scope;
   const sourceInfo = {
     path: filePath,
@@ -1246,7 +1025,7 @@ function collectSkills(root, dir, diagnostics, includeRootFiles, anchor = contai
   }
   const skillEntry = entries.find((entry) => entry.name === "SKILL.md" && entry.isFile());
   if (skillEntry) {
-    const skillPath = path4.join(dir, skillEntry.name);
+    const skillPath = path3.join(dir, skillEntry.name);
     if (escapesContainment(skillPath, anchor, diagnostics)) return [];
     const loaded = loadSkillFile(skillPath, root);
     diagnostics.push(...loaded.diagnostics);
@@ -1255,8 +1034,8 @@ function collectSkills(root, dir, diagnostics, includeRootFiles, anchor = contai
   const candidates = [];
   for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
     if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-    const fullPath = path4.join(dir, entry.name);
-    if (entry.isDirectory() || entry.isSymbolicLink() && existsSync3(path4.join(fullPath, "SKILL.md"))) {
+    const fullPath = path3.join(dir, entry.name);
+    if (entry.isDirectory() || entry.isSymbolicLink() && existsSync3(path3.join(fullPath, "SKILL.md"))) {
       candidates.push(...collectSkills(root, fullPath, diagnostics, false, anchor));
       continue;
     }
@@ -1284,15 +1063,15 @@ function explicitSkillRoot(filePath) {
   };
 }
 function loadExplicitSkillPath(inputPath, diagnostics, packageRoots, cwd) {
-  const resolved = path4.resolve(inputPath);
+  const resolved = path3.resolve(inputPath);
   const identity = canonicalizePath(resolved);
   const owner = packageRoots.find((candidate) => {
-    const relative = path4.relative(canonicalizePath(candidate.path), identity);
-    return relative !== ".." && !relative.startsWith(`..${path4.sep}`) && !path4.isAbsolute(relative);
+    const relative = path3.relative(canonicalizePath(candidate.path), identity);
+    return relative !== ".." && !relative.startsWith(`..${path3.sep}`) && !path3.isAbsolute(relative);
   });
   if (!owner && ["user", "project"].some((scope) => {
-    const relative = path4.relative(canonicalizePath(pluginBaseDir(scope, cwd)), identity);
-    return relative !== ".." && !relative.startsWith(`..${path4.sep}`) && !path4.isAbsolute(relative);
+    const relative = path3.relative(canonicalizePath(pluginBaseDir(scope, cwd)), identity);
+    return relative !== ".." && !relative.startsWith(`..${path3.sep}`) && !path3.isAbsolute(relative);
   })) {
     diagnostics.push({
       type: "warning",
@@ -1313,7 +1092,7 @@ function loadExplicitSkillPath(inputPath, diagnostics, packageRoots, cwd) {
     diagnostics.push({ type: "warning", message: `explicit skill path does not exist: ${resolved}`, path: resolved });
     return [];
   }
-  const skillFile = path4.basename(resolved) === "SKILL.md" || resolved.endsWith(".md") ? resolved : path4.join(resolved, "SKILL.md");
+  const skillFile = path3.basename(resolved) === "SKILL.md" || resolved.endsWith(".md") ? resolved : path3.join(resolved, "SKILL.md");
   if (!existsSync3(skillFile)) {
     const packages = collectSkills(root, resolved, diagnostics, false);
     if (packages.length > 0) return packages;
@@ -1532,21 +1311,21 @@ function parsePendingSkillRequests(input, skills, options = {}) {
 var MARKETPLACE_UNCONFIGURED = "no local skill marketplace catalog or index configured";
 function packageCatalogDir() {
   try {
-    return path5.join(resolvePackageRoot(), "library", "skills");
+    return path4.join(resolvePackageRoot(), "library", "skills");
   } catch {
     return null;
   }
 }
 function packageIndexPath() {
   try {
-    return path5.join(resolvePackageRoot(), "library", "skills", "skill-marketplace.json");
+    return path4.join(resolvePackageRoot(), "library", "skills", "skill-marketplace.json");
   } catch {
     return null;
   }
 }
 function defaultIndexPath() {
   try {
-    const configured = path5.join(clioConfigDir(), "skill-marketplace.json");
+    const configured = path4.join(clioConfigDir(), "skill-marketplace.json");
     if (existsSync4(configured)) return configured;
   } catch {
   }
@@ -1590,7 +1369,7 @@ function parseMarketplaceIndex(indexPath, diagnostics = []) {
       const kind = record.kind === "agent" || record.kind === "prompt" || record.kind === "fleet" ? record.kind : "skill";
       const requires = Array.isArray(record.requires) ? record.requires.filter((entry) => typeof entry === "string") : void 0;
       const overlay = optionalString(record.overlay);
-      if (overlay && (path5.isAbsolute(overlay) || overlay.split("/").includes(".."))) {
+      if (overlay && (path4.isAbsolute(overlay) || overlay.split("/").includes(".."))) {
         diagnostics.push(`skill marketplace index entry has an overlay outside the package: ${skill.name}`);
         return [];
       }
@@ -1622,11 +1401,11 @@ function looksLikeSkillCatalog(dir) {
   try {
     return readdirSync2(dir, { withFileTypes: true }).some((entry) => {
       if (!entry.isDirectory()) return false;
-      const child = path5.join(dir, entry.name);
-      if (existsSync4(path5.join(child, "SKILL.md"))) return true;
+      const child = path4.join(dir, entry.name);
+      if (existsSync4(path4.join(child, "SKILL.md"))) return true;
       try {
         return readdirSync2(child, { withFileTypes: true }).some(
-          (inner) => inner.isDirectory() && existsSync4(path5.join(child, inner.name, "SKILL.md"))
+          (inner) => inner.isDirectory() && existsSync4(path4.join(child, inner.name, "SKILL.md"))
         );
       } catch {
         return false;
@@ -1638,19 +1417,19 @@ function looksLikeSkillCatalog(dir) {
 }
 function resolveCatalogDir(options) {
   if (options.catalogDir === null) return null;
-  if (options.catalogDir) return path5.resolve(options.catalogDir);
+  if (options.catalogDir) return path4.resolve(options.catalogDir);
   const fromEnv = process.env.CLIO_CODER_SKILL_CATALOG_DIR;
-  if (fromEnv && fromEnv.trim().length > 0) return path5.resolve(fromEnv.trim());
-  const repoLibraryCatalog = path5.join(options.cwd ?? process.cwd(), "library", "skills");
+  if (fromEnv && fromEnv.trim().length > 0) return path4.resolve(fromEnv.trim());
+  const repoLibraryCatalog = path4.join(options.cwd ?? process.cwd(), "library", "skills");
   if (looksLikeSkillCatalog(repoLibraryCatalog)) return repoLibraryCatalog;
-  const repoCatalog = path5.join(options.cwd ?? process.cwd(), "skills");
+  const repoCatalog = path4.join(options.cwd ?? process.cwd(), "skills");
   if (looksLikeSkillCatalog(repoCatalog)) return repoCatalog;
   const bundled = packageCatalogDir();
   return bundled && looksLikeSkillCatalog(bundled) ? bundled : null;
 }
 function catalogCategory(catalogDir, baseDir) {
-  const rel = path5.relative(catalogDir, baseDir);
-  const category = path5.dirname(rel);
+  const rel = path4.relative(catalogDir, baseDir);
+  const category = path4.dirname(rel);
   if (rel.length === 0 || rel.startsWith("..") || category === "." || category.startsWith("..")) return void 0;
   return category;
 }
@@ -1713,7 +1492,7 @@ function getMarketplaceSkills(options = {}) {
 }
 function marketplaceInstallShaping(skill) {
   const shaping = {};
-  if (skill.overlay) shaping.overlay = path5.join(resolvePackageRoot(), skill.overlay);
+  if (skill.overlay) shaping.overlay = path4.join(resolvePackageRoot(), skill.overlay);
   if (skill.exclude && skill.exclude.length > 0) shaping.exclude = [...skill.exclude];
   return shaping;
 }
@@ -1754,9 +1533,228 @@ function installSkill(input) {
   };
 }
 
+// src/domains/agents/recipe.ts
+init_esm_shims();
+import path5 from "node:path";
+var AGENT_BUDGET_KEYS = ["toolCalls", "readReserve", "synthesis", "maximum"];
+function parseAgentBudgetPhase(value, prefix, relationTarget) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`${prefix} must be a non-null YAML object`);
+  }
+  const record = value;
+  for (const key of Object.keys(record)) {
+    if (key !== "toolCalls" && key !== "readReserve") throw new Error(`${prefix}.${key} is unknown`);
+  }
+  for (const key of ["toolCalls", "readReserve"]) {
+    if (!Object.hasOwn(record, key)) throw new Error(`${prefix}.${key} is required`);
+  }
+  const toolCalls = record.toolCalls;
+  if (typeof toolCalls !== "number" || !Number.isSafeInteger(toolCalls)) {
+    throw new Error(`${prefix}.toolCalls must be a finite safe integer`);
+  }
+  if (toolCalls <= 0) throw new Error(`${prefix}.toolCalls must be greater than 0`);
+  const readReserve = record.readReserve;
+  if (typeof readReserve !== "number" || !Number.isSafeInteger(readReserve)) {
+    throw new Error(`${prefix}.readReserve must be a finite safe integer`);
+  }
+  if (readReserve < 0) throw new Error(`${prefix}.readReserve must be greater than or equal to 0`);
+  if (readReserve >= toolCalls) throw new Error(`${prefix}.readReserve must be less than ${relationTarget}`);
+  return { toolCalls, readReserve };
+}
+function parseAgentBudget(value, sourcePath) {
+  if (value === void 0) return void 0;
+  const prefix = `agent budget: ${sourcePath}: budget`;
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`${prefix} must be a non-null YAML object`);
+  }
+  const record = value;
+  for (const key of Object.keys(record)) {
+    if (!AGENT_BUDGET_KEYS.includes(key)) {
+      throw new Error(`${prefix}.${key} is unknown`);
+    }
+  }
+  for (const key of ["toolCalls", "readReserve", "synthesis"]) {
+    if (!Object.hasOwn(record, key)) throw new Error(`${prefix}.${key} is required`);
+  }
+  const phase = parseAgentBudgetPhase(
+    { toolCalls: record.toolCalls, readReserve: record.readReserve },
+    prefix,
+    "budget.toolCalls"
+  );
+  const synthesis = record.synthesis;
+  if (typeof synthesis !== "boolean") throw new Error(`${prefix}.synthesis must be a boolean`);
+  const maximum = record.maximum === void 0 ? void 0 : parseAgentBudgetPhase(record.maximum, `${prefix}.maximum`, "budget.maximum.toolCalls");
+  if (maximum !== void 0) {
+    if (maximum.toolCalls < phase.toolCalls) {
+      throw new Error(`${prefix}.maximum.toolCalls must be greater than or equal to budget.toolCalls`);
+    }
+    if (maximum.readReserve < phase.readReserve) {
+      throw new Error(`${prefix}.maximum.readReserve must be greater than or equal to budget.readReserve`);
+    }
+  }
+  return { ...phase, synthesis, ...maximum === void 0 ? {} : { maximum } };
+}
+function recipeIdFromPath(absPath, rootDir) {
+  const resolvedRoot = path5.resolve(rootDir);
+  const resolvedPath = path5.resolve(absPath);
+  const relPath = path5.relative(resolvedRoot, resolvedPath);
+  if (relPath === "" || relPath.startsWith("..") || path5.isAbsolute(relPath)) {
+    throw new Error(`recipe: path must live under rootDir (${resolvedPath} not under ${resolvedRoot})`);
+  }
+  if (path5.dirname(relPath) !== ".") {
+    throw new Error(`recipe: recipes must live directly under rootDir (${resolvedPath})`);
+  }
+  if (path5.extname(relPath) !== ".md") {
+    throw new Error(`recipe: recipe files must end in .md (${resolvedPath})`);
+  }
+  const id = path5.basename(relPath, ".md");
+  if (id === "") {
+    throw new Error(`recipe: recipe filename must not be empty (${resolvedPath})`);
+  }
+  return id;
+}
+
+// src/domains/agents/recipe-schema.ts
+init_esm_shims();
+var RECIPE_KEYS = [
+  "version",
+  "name",
+  "description",
+  "tools",
+  "skills",
+  "audience",
+  "category",
+  "capabilityClass",
+  "latencyClass",
+  "projectContextTier",
+  "budget",
+  "resultContract",
+  "tags"
+];
+var OPTIONAL_RECIPE_KEYS = ["product"];
+var ALL_RECIPE_KEYS = [...RECIPE_KEYS, ...OPTIONAL_RECIPE_KEYS];
+function requiredString(value, path6) {
+  if (typeof value !== "string" || value.trim().length === 0)
+    throw new Error(`agent recipe: ${path6} must be a non-empty string`);
+  return value;
+}
+function requiredStringArray(value, path6) {
+  if (!Array.isArray(value)) throw new Error(`agent recipe: ${path6} must be an array of strings`);
+  const entries = value.map((entry, index) => requiredString(entry, `${path6}[${index}]`));
+  if (new Set(entries).size !== entries.length) throw new Error(`agent recipe: ${path6} must not contain duplicates`);
+  return entries;
+}
+function enumValue(value, path6, predicate) {
+  if (!predicate(value)) throw new Error(`agent recipe: ${path6} has an unsupported value`);
+  return value;
+}
+function parseAudience(value, source, filepath) {
+  const audience = enumValue(value, `${filepath}: audience`, isAgentAudience);
+  if (source === "builtin") {
+    if (audience === "custom") {
+      throw new Error(`agent recipe: ${filepath}: a builtin recipe must not declare audience 'custom'`);
+    }
+    return audience;
+  }
+  if (audience !== "custom") {
+    throw new Error(
+      `agent recipe: ${filepath}: a ${source} recipe must declare audience 'custom', not '${audience}'; audience follows where the recipe was discovered and cannot be claimed in frontmatter`
+    );
+  }
+  return audience;
+}
+function parseTools(value, filepath) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`agent recipe: ${filepath}: tools must be a { required, optional } object`);
+  }
+  const record = value;
+  if (Object.keys(record).some((key) => key !== "required" && key !== "optional")) {
+    throw new Error(`agent recipe: ${filepath}: tools has an unknown key`);
+  }
+  if (!("required" in record) || !("optional" in record)) {
+    throw new Error(`agent recipe: ${filepath}: tools.required and tools.optional are required`);
+  }
+  if (!Array.isArray(record.required) || !Array.isArray(record.optional)) {
+    throw new Error(`agent recipe: ${filepath}: tools.required and tools.optional must be arrays`);
+  }
+  const required = record.required.map((entry, index) => {
+    const entryPath = `${filepath}: tools.required[${index}]`;
+    if (typeof entry === "string") return requiredString(entry, entryPath);
+    if (entry === null || typeof entry !== "object" || Array.isArray(entry)) {
+      throw new Error(`agent recipe: ${entryPath} must be a tool name or { anyOf: [...] }`);
+    }
+    const group = entry;
+    if (Object.keys(group).length !== 1 || !("anyOf" in group)) {
+      throw new Error(`agent recipe: ${entryPath} must contain only anyOf`);
+    }
+    const anyOf = requiredStringArray(group.anyOf, `${entryPath}.anyOf`);
+    if (anyOf.length === 0) throw new Error(`agent recipe: ${entryPath}.anyOf must not be empty`);
+    return { anyOf };
+  });
+  const optional = requiredStringArray(record.optional, `${filepath}: tools.optional`);
+  const tools = [
+    ...required.flatMap((requirement) => typeof requirement === "string" ? [requirement] : requirement.anyOf),
+    ...optional
+  ];
+  if (new Set(tools).size !== tools.length)
+    throw new Error(`agent recipe: ${filepath}: tools contains duplicate requirements`);
+  return { tools, toolRequirements: { required, optional } };
+}
+function parseAgentRecipeSchema(input) {
+  const { frontmatter, filepath } = input;
+  for (const key of Object.keys(frontmatter)) {
+    if (!ALL_RECIPE_KEYS.includes(key)) {
+      throw new Error(`agent recipe: ${filepath}: unknown key '${key}'`);
+    }
+  }
+  for (const key of RECIPE_KEYS) {
+    if (!(key in frontmatter)) throw new Error(`agent recipe: ${filepath}: ${key} is required`);
+  }
+  if (frontmatter.version !== 1) throw new Error(`agent recipe: ${filepath}: version must be the supported integer 1`);
+  if (input.body.trim().length === 0) throw new Error(`agent recipe: ${filepath}: persona body must not be empty`);
+  const parsedTools = parseTools(frontmatter.tools, filepath);
+  const budget = parseAgentBudget(frontmatter.budget, filepath);
+  if (budget === void 0) throw new Error(`agent recipe: ${filepath}: budget is required`);
+  return {
+    version: 1,
+    id: input.id,
+    name: requiredString(frontmatter.name, `${filepath}: name`),
+    description: requiredString(frontmatter.description, `${filepath}: description`),
+    tools: parsedTools.tools,
+    toolRequirements: parsedTools.toolRequirements,
+    skills: requiredStringArray(frontmatter.skills, `${filepath}: skills`),
+    boundSkillPaths: [],
+    audience: parseAudience(frontmatter.audience, input.source, filepath),
+    category: enumValue(frontmatter.category, `${filepath}: category`, isAgentCategory),
+    capabilityClass: enumValue(
+      frontmatter.capabilityClass,
+      `${filepath}: capabilityClass`,
+      isAgentCapabilityClass
+    ),
+    latencyClass: enumValue(
+      frontmatter.latencyClass,
+      `${filepath}: latencyClass`,
+      isAgentLatencyClass
+    ),
+    projectContextTier: enumValue(
+      frontmatter.projectContextTier,
+      `${filepath}: projectContextTier`,
+      isAgentProjectContextTier
+    ),
+    budget,
+    resultContract: parseResultContract(frontmatter.resultContract, filepath),
+    // Optional, but not lenient. A misspelled product silently costs the run
+    // the delivery tools its reserve window was supposed to keep, and the
+    // only symptom is a blocked tool call deep in a dispatch log.
+    ...frontmatter.product === void 0 ? {} : { product: enumValue(frontmatter.product, `${filepath}: product`, isAgentProduct) },
+    tags: requiredStringArray(frontmatter.tags, `${filepath}: tags`),
+    source: input.source,
+    filepath,
+    body: input.body
+  };
+}
+
 export {
-  recipeIdFromPath,
-  parseAgentRecipeSchema,
   parsePluginGithubSource,
   pluginLocalPath,
   fetchPluginSource,
@@ -1796,6 +1794,8 @@ export {
   SKILL_SURFACE_CLEAR_ARG,
   parseSkillCommand,
   expandSkillInvocationInput,
-  parsePendingSkillRequests
+  parsePendingSkillRequests,
+  recipeIdFromPath,
+  parseAgentRecipeSchema
 };
-//# sourceMappingURL=chunk-EXKUF426.js.map
+//# sourceMappingURL=chunk-7FBCRWVT.js.map