@iowarp/clio-coder 0.4.5 → 0.4.7

package/dist/chunk-CXQ37WJH.js

@@ -1,45 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  require_dist
-} from "./chunk-B5GGDIHT.js";
-import {
-  __toESM,
-  init_esm_shims
-} from "./chunk-ECBHH7LU.js";
-
-// src/domains/agents/frontmatter.ts
-init_esm_shims();
-var import_yaml = __toESM(require_dist(), 1);
-function parseFrontmatter(raw, sourcePath) {
-  const opening = raw.match(/^---\r?\n/);
-  if (!opening) {
-    throw new Error(`frontmatter: ${sourcePath}: missing YAML frontmatter opening delimiter`);
-  }
-  const closeRegex = /\r?\n---(?:\r?\n|$)/g;
-  closeRegex.lastIndex = opening[0].length;
-  const closing = closeRegex.exec(raw);
-  if (!closing) {
-    throw new Error(`frontmatter: ${sourcePath}: missing YAML frontmatter closing delimiter`);
-  }
-  const frontmatterText = raw.slice(opening[0].length, closing.index);
-  const body = raw.slice(closing.index + closing[0].length);
-  let parsed;
-  try {
-    parsed = import_yaml.default.parse(frontmatterText);
-  } catch (err) {
-    const reason = err instanceof Error ? err.message : String(err);
-    throw new Error(`frontmatter: ${sourcePath}: invalid YAML frontmatter (${reason})`);
-  }
-  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`frontmatter: ${sourcePath}: frontmatter must be a YAML object`);
-  }
-  return {
-    frontmatter: parsed,
-    body
-  };
-}
-
-export {
-  parseFrontmatter
-};
-//# sourceMappingURL=chunk-CXQ37WJH.js.map

package/dist/chunk-EQEJJ53P.js

@@ -1,399 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  loadSkills
-} from "./chunk-T7FDXNRU.js";
-import {
-  parseFrontmatter
-} from "./chunk-CXQ37WJH.js";
-import {
-  enabledExtensionResourceRoots
-} from "./chunk-22PQ4TX4.js";
-import {
-  assertAgentSpecPolicy,
-  isAgentAudience,
-  isAgentCapabilityClass,
-  isAgentCategory,
-  isAgentLatencyClass,
-  isAgentProduct,
-  isAgentProjectContextTier,
-  isShadowAgent,
-  normalizeAgentSpec,
-  parseResultContract
-} from "./chunk-OQM5IVJY.js";
-import {
-  resolvePackageRoot
-} from "./chunk-E3LEPLQ2.js";
-import {
-  clioConfigDir
-} from "./chunk-CTTI7G3T.js";
-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, path3) {
-  if (typeof value !== "string" || value.trim().length === 0)
-    throw new Error(`agent recipe: ${path3} must be a non-empty string`);
-  return value;
-}
-function requiredStringArray(value, path3) {
-  if (!Array.isArray(value)) throw new Error(`agent recipe: ${path3} must be an array of strings`);
-  const entries = value.map((entry, index) => requiredString(entry, `${path3}[${index}]`));
-  if (new Set(entries).size !== entries.length) throw new Error(`agent recipe: ${path3} must not contain duplicates`);
-  return entries;
-}
-function enumValue(value, path3, predicate) {
-  if (!predicate(value)) throw new Error(`agent recipe: ${path3} 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/agents/registry.ts
-init_esm_shims();
-import { existsSync, readdirSync, readFileSync, realpathSync } from "node:fs";
-import path2 from "node:path";
-var RESERVED_CUSTOM_AGENT_IDS = /* @__PURE__ */ new Set(["worker", "delegate", "auto"]);
-function resolveBoundSkills(recipe, source) {
-  if (recipe.skills.length === 0) return { ...recipe, boundSkillPaths: [] };
-  const packageSkills = path2.resolve(source.dir, "..", "..", "..", "..", "skills");
-  if (source.source === "extension" && source.skillRoot === void 0) {
-    throw new Error(`agent recipe: ${recipe.filepath}: extension declares bound skills but no skills resource root`);
-  }
-  const skills = source.source === "extension" ? loadSkills({
-    cwd: source.cwd ?? process.cwd(),
-    disableDiscovery: true,
-    explicitSkillPaths: source.skillRoot === void 0 ? [] : [source.skillRoot]
-  }) : loadSkills({
-    cwd: source.cwd ?? process.cwd(),
-    ...source.source === "builtin" && existsSync(packageSkills) ? { explicitSkillPaths: [packageSkills] } : {}
-  });
-  if (source.source === "extension" && source.skillRoot !== void 0) {
-    const canonicalRoot = realpathSync(source.skillRoot);
-    for (const skill of skills.items) {
-      const relative = path2.relative(canonicalRoot, realpathSync(skill.filePath));
-      if (relative === ".." || relative.startsWith(`..${path2.sep}`) || path2.isAbsolute(relative)) {
-        throw new Error(`agent recipe: ${recipe.filepath}: bound skill escapes its extension: ${skill.filePath}`);
-      }
-    }
-  }
-  const byName = new Map(skills.items.map((skill) => [skill.name, skill.filePath]));
-  const missing = recipe.skills.filter((skill) => !byName.has(skill));
-  if (missing.length > 0) {
-    throw new Error(`agent recipe: ${recipe.filepath}: bound skill(s) unavailable: ${missing.join(", ")}`);
-  }
-  const boundSkillPaths = recipe.skills.map((skill) => {
-    const filePath = byName.get(skill);
-    if (filePath === void 0) throw new Error(`agent recipe: ${recipe.filepath}: bound skill unavailable: ${skill}`);
-    return filePath;
-  });
-  return { ...recipe, boundSkillPaths };
-}
-function loadRecipesFromDir(source, diagnostics = []) {
-  let entries;
-  try {
-    entries = readdirSync(source.dir, { withFileTypes: true });
-  } catch (err) {
-    const error = err;
-    if (error.code === "ENOENT" || error.code === "ENOTDIR") return [];
-    throw err;
-  }
-  const recipes = [];
-  for (const entry of entries) {
-    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-    const filepath = path2.join(source.dir, entry.name);
-    try {
-      const id = recipeIdFromPath(filepath, source.dir);
-      const raw = readFileSync(filepath, "utf8");
-      const { frontmatter, body } = parseFrontmatter(raw, filepath);
-      const parsedRecipe = parseAgentRecipeSchema({ id, source: source.source, filepath, body, frontmatter });
-      const recipe = resolveBoundSkills(parsedRecipe, source);
-      assertAgentSpecPolicy(normalizeAgentSpec(recipe));
-      recipes.push(recipe);
-    } catch (error) {
-      if (source.source === "builtin") throw error;
-      const message = error instanceof Error ? error.message : String(error);
-      diagnostics.push({ source: source.source, filepath, message });
-      process.stderr.write(`[clio-coder:agents] quarantine path=${filepath} source=${source.source} reason=${message}
-`);
-    }
-  }
-  recipes.sort((left, right) => left.id.localeCompare(right.id));
-  return recipes;
-}
-function mergeRecipes(...sources) {
-  const byId = /* @__PURE__ */ new Map();
-  const builtinById = /* @__PURE__ */ new Map();
-  for (const group of sources) {
-    for (const recipe of group) {
-      if (recipe.source === "builtin") builtinById.set(recipe.id, recipe);
-    }
-  }
-  for (const group of sources) {
-    for (const recipe of group) {
-      if (recipe.source !== "builtin" && RESERVED_CUSTOM_AGENT_IDS.has(recipe.id)) {
-        process.stderr.write(`[clio-coder:agents] ignore id=${recipe.id} by=${recipe.source} reason=reserved-agent-id
-`);
-        continue;
-      }
-      const builtin = builtinById.get(recipe.id);
-      if (recipe.source === "extension" && builtin) {
-        process.stderr.write(`[clio-coder:agents] ignore override id=${recipe.id} by=extension reason=reserved-builtin
-`);
-        continue;
-      }
-      if (recipe.source === "user" && builtin && isShadowAgent(normalizeAgentSpec(builtin))) {
-        process.stderr.write(`[clio-coder:agents] ignore override id=${recipe.id} by=user reason=reserved-shadow
-`);
-        continue;
-      }
-      if (recipe.source === "project" && builtin) {
-        process.stderr.write(`[clio-coder:agents] ignore override id=${recipe.id} by=project reason=reserved-builtin
-`);
-        continue;
-      }
-      if (byId.has(recipe.id)) process.stderr.write(`[clio-coder:agents] override id=${recipe.id} by=${recipe.source}
-`);
-      byId.set(recipe.id, recipe);
-    }
-  }
-  return Array.from(byId.values()).sort((left, right) => left.id.localeCompare(right.id));
-}
-function discoverAgentRecipes(cwd = process.cwd(), diagnostics = []) {
-  const builtin = loadRecipesFromDir(
-    {
-      dir: path2.join(resolvePackageRoot(), "src", "domains", "agents", "builtins"),
-      source: "builtin",
-      cwd
-    },
-    diagnostics
-  );
-  const skillRoots = new Map(enabledExtensionResourceRoots("skills", cwd).map((root) => [root.source, root.path]));
-  const extensionRecipes = enabledExtensionResourceRoots("agents", cwd).sort((left, right) => left.source.localeCompare(right.source)).map((root) => {
-    const skillRoot = skillRoots.get(root.source);
-    return loadRecipesFromDir(
-      {
-        dir: root.path,
-        source: "extension",
-        cwd,
-        origin: root.source,
-        ...skillRoot === void 0 ? {} : { skillRoot }
-      },
-      diagnostics
-    );
-  });
-  const user = loadRecipesFromDir({ dir: path2.join(clioConfigDir(), "agents"), source: "user", cwd }, diagnostics);
-  const project = loadRecipesFromDir(
-    { dir: path2.join(cwd, ".clio-coder", "agents"), source: "project", cwd },
-    diagnostics
-  );
-  return mergeRecipes(builtin, ...extensionRecipes, user, project);
-}
-
-export {
-  parseAgentRecipeSchema,
-  discoverAgentRecipes
-};
-//# sourceMappingURL=chunk-EQEJJ53P.js.map

package/dist/chunk-KTFSFCVN.js

@@ -1,46 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  typebox_exports
-} from "./chunk-GH5ZR6JP.js";
-import {
-  ToolNames
-} from "./chunk-EHOSNVVM.js";
-import {
-  StringEnum
-} from "./chunk-5CMARGPF.js";
-import {
-  init_esm_shims
-} from "./chunk-ECBHH7LU.js";
-
-// src/tools/context/surface.ts
-init_esm_shims();
-var contextToolSurface = {
-  name: ToolNames.Context,
-  description: "Environment context: scope=workspace returns the git/project snapshot, scope=docs searches Clio's bundled documentation (omit query to list the corpus), scope=skills lists installed and marketplace skills or loads an installed one by name, scope=recall returns an exact persisted evicted or summarized tool result by ref; omit ref to discover historical results by query with bounded limit/offset pages. For repository code and the repo's generated wiki use code_nav (mode=wiki).",
-  parameters: typebox_exports.Object({
-    scope: StringEnum(["workspace", "docs", "skills", "recall"], { description: "Context source." }),
-    query: typebox_exports.Optional(
-      typebox_exports.String({
-        description: "scope=docs: question or terms. scope=recall without ref: path, tool, or ref terms; omit to list."
-      })
-    ),
-    name: typebox_exports.Optional(typebox_exports.String({ description: "scope=skills: skill name to load; omit to list." })),
-    limit: typebox_exports.Optional(
-      typebox_exports.Number({
-        description: "scope=docs: max sections (default 5, max 12). scope=recall: max refs (default 8, max 12)."
-      })
-    ),
-    ref: typebox_exports.Optional(typebox_exports.String({ description: "scope=recall: exact persisted result ref; omit for discovery." })),
-    offset: typebox_exports.Optional(
-      typebox_exports.Number({ description: "scope=recall discovery: zero-based offset; follow nextOffset (default 0)." })
-    ),
-    include_tree: typebox_exports.Optional(typebox_exports.Boolean({ description: "scope=skills: list files under the skill base_dir." }))
-  }),
-  baseActionClass: "read",
-  executionMode: "parallel"
-};
-
-export {
-  contextToolSurface
-};
-//# sourceMappingURL=chunk-KTFSFCVN.js.map

package/dist/chunk-QRFXEO6Y.js

@@ -1,17 +0,0 @@
-import { createRequire as __clioCreateRequire } from "node:module"; const require = __clioCreateRequire(import.meta.url);
-import {
-  init_esm_shims
-} from "./chunk-ECBHH7LU.js";
-
-// src/engine/tui-primitives.ts
-init_esm_shims();
-import { ProcessTerminal, TuiAltScreen, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
-
-export {
-  ProcessTerminal,
-  TuiAltScreen,
-  truncateToWidth,
-  visibleWidth,
-  wrapTextWithAnsi
-};
-//# sourceMappingURL=chunk-QRFXEO6Y.js.map