@geminixiang/mikan 1.0.0-beta.76 → 1.0.0-beta.78

package/dist/harness/skills.js

@@ -1,7 +1,6 @@
 import { existsSync, lstatSync, readdirSync, readFileSync, statSync } from "node:fs";
 import { basename, dirname, join } from "node:path";
 import * as log from "../log.js";
-/** Register skills under their prompt-side paths; a later source overrides an earlier one. */
 function addSkills(skillMap, skills, rewritePath) {
     for (const skill of skills) {
         skill.filePath = rewritePath(skill.filePath);
@@ -9,7 +8,6 @@ function addSkills(skillMap, skills, rewritePath) {
         skillMap.set(skill.name, skill);
     }
 }
-/** Conversation skill entries that are symlinks are refused, and reported to the prompt. */
 function skippedSymlinkPaths(diagnostics, translatePath) {
     const skipped = [];
     for (const diagnostic of diagnostics) {
@@ -22,8 +20,6 @@ function skippedSymlinkPaths(diagnostics, translatePath) {
 }
 export function loadMikanSkills(office, workspacePath, projection) {
     const skillMap = new Map();
-    // workspacePath is the runtime-side root (e.g. /workspace); host paths under
-    // the workspace root translate onto it for prompt references.
     const hostWorkspacePath = office.workspace.root;
     const translatePath = (hostPath) => hostPath.startsWith(hostWorkspacePath)
         ? workspacePath + hostPath.slice(hostWorkspacePath.length)
@@ -44,10 +40,6 @@ export function loadMikanSkills(office, workspacePath, projection) {
 }
 const MAX_NAME_LENGTH = 64;
 const MAX_DESCRIPTION_LENGTH = 1024;
-/**
- * Parse simple `key: value` YAML frontmatter delimited by `---` lines.
- * Quoted values are unquoted; nested structures are not supported.
- */
 export function parseFrontmatter(content) {
     const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
     if (!match)
@@ -69,7 +61,6 @@ export function parseFrontmatter(content) {
     }
     return { values, body: content.slice(match[0].length) };
 }
-/** Exposed so the admin portal can validate a skill draft before writing it. */
 export function validateSkill(name, description) {
     const errors = [];
     if (name.length > MAX_NAME_LENGTH) {
@@ -125,12 +116,6 @@ function loadSkillFromFile(filePath, source) {
         return { skills: [], diagnostics };
     }
 }
-/**
- * Load skills from a directory tree.
- * - A directory containing `SKILL.md` is a skill root; no further recursion.
- * - Direct `.md` children of the top-level directory load as skills.
- * - Dot-directories and `node_modules` are skipped.
- */
 export function loadSkillsFromDir(options) {
     const rejectSymlinks = options.rejectSymlinks === true;
     if (rejectSymlinks && isSymlink(options.dir)) {
@@ -235,10 +220,6 @@ function escapeXml(str) {
         .replace(/"/g, """)
         .replace(/'/g, "'");
 }
-/**
- * Format skills for a system prompt using the Agent Skills XML block.
- * Skills with `disableModelInvocation` are excluded.
- */
 export function formatSkillsForPrompt(skills) {
     const visible = skills.filter((skill) => !skill.disableModelInvocation);
     if (visible.length === 0)
@@ -255,7 +236,6 @@ export function formatSkillsForPrompt(skills) {
         lines.push(`    <name>${escapeXml(skill.name)}</name>`);
         lines.push(`    <description>${escapeXml(skill.description)}</description>`);
         if (skill.inline) {
-            // Inline skills carry their body: the agent cannot read their file.
             lines.push(`    <instructions>${escapeXml(skill.content)}</instructions>`);
         }
         else {

package/dist/harness/skills.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/harness/skills.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Office } from \"../office/index.js\";\nimport type { MikanSkill, SkillDiagnostic, LoadSkillsResult } from \"./types.js\";\nimport type { WorkspaceProjection } from \"../office/types.js\";\nimport { existsSync, lstatSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\n\nimport * as log from \"../log.js\";\n\n/** Register skills under their prompt-side paths; a later source overrides an earlier one. */\nfunction addSkills(\n  skillMap: Map<string, MikanSkill>,\n  skills: MikanSkill[],\n  rewritePath: (path: string) => string,\n): void {\n  for (const skill of skills) {\n    skill.filePath = rewritePath(skill.filePath);\n    skill.baseDir = rewritePath(skill.baseDir);\n    skillMap.set(skill.name, skill);\n  }\n}\n\n/** Conversation skill entries that are symlinks are refused, and reported to the prompt. */\nfunction skippedSymlinkPaths(\n  diagnostics: SkillDiagnostic[],\n  translatePath: (path: string) => string,\n): string[] {\n  const skipped: string[] = [];\n  for (const diagnostic of diagnostics) {\n    if (diagnostic.code !== \"symlink\") continue;\n    log.logWarning(\"Skipping conversation skill entry (symlink)\", diagnostic.path);\n    skipped.push(translatePath(diagnostic.path));\n  }\n  return skipped;\n}\n\nexport function loadMikanSkills(\n  office: Office,\n  workspacePath: string,\n  projection: WorkspaceProjection,\n): { skills: MikanSkill[]; skippedSkillLinks: string[] } {\n  const skillMap = new Map<string, MikanSkill>();\n\n  // workspacePath is the runtime-side root (e.g. /workspace); host paths under\n  // the workspace root translate onto it for prompt references.\n  const hostWorkspacePath = office.workspace.root;\n  const translatePath = (hostPath: string): string =>\n    hostPath.startsWith(hostWorkspacePath)\n      ? workspacePath + hostPath.slice(hostWorkspacePath.length)\n      : hostPath;\n\n  const workspaceSkillsDir = projection.promptSources.globalSkillsDir;\n  if (workspaceSkillsDir) {\n    const loaded = loadSkillsFromDir({ dir: workspaceSkillsDir, source: \"workspace\" });\n    addSkills(skillMap, loaded.skills, translatePath);\n  }\n\n  const conversationSkills = loadSkillsFromDir({\n    dir: projection.promptSources.conversationSkillsDir,\n    source: \"channel\",\n    rejectSymlinks: true,\n  });\n  const skippedSkillLinks = skippedSymlinkPaths(conversationSkills.diagnostics, translatePath);\n  addSkills(skillMap, conversationSkills.skills, translatePath);\n\n  return { skills: Array.from(skillMap.values()), skippedSkillLinks };\n}\nexport type { LoadSkillsResult } from \"./types.js\";\nexport type { MikanSkill } from \"./types.js\";\nexport type { SkillDiagnostic } from \"./types.js\";\n\nconst MAX_NAME_LENGTH = 64;\n\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\ninterface Frontmatter {\n  values: Record<string, string>;\n  body: string;\n}\n\n/**\n * Parse simple `key: value` YAML frontmatter delimited by `---` lines.\n * Quoted values are unquoted; nested structures are not supported.\n */\nexport function parseFrontmatter(content: string): Frontmatter {\n  const match = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?/);\n  if (!match) return { values: {}, body: content };\n\n  const values: Record<string, string> = {};\n  for (const line of (match[1] ?? \"\").split(/\\r?\\n/)) {\n    const separator = line.indexOf(\":\");\n    if (separator === -1) continue;\n    const key = line.slice(0, separator).trim();\n    if (!key) continue;\n    let value = line.slice(separator + 1).trim();\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n    values[key] = value;\n  }\n  return { values, body: content.slice(match[0].length) };\n}\n\n/** Exposed so the admin portal can validate a skill draft before writing it. */\nexport function validateSkill(name: string, description: string): string[] {\n  const errors: string[] = [];\n  if (name.length > MAX_NAME_LENGTH) {\n    errors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);\n  }\n  if (\n    !/^[a-z0-9-]+$/.test(name) ||\n    name.startsWith(\"-\") ||\n    name.endsWith(\"-\") ||\n    name.includes(\"--\")\n  ) {\n    errors.push(\"name must be lowercase a-z, 0-9 and single hyphens, not at the edges\");\n  }\n  if (description.length > MAX_DESCRIPTION_LENGTH) {\n    errors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);\n  }\n  return errors;\n}\n\nfunction loadSkillFromFile(filePath: string, source: string): LoadSkillsResult {\n  const diagnostics: SkillDiagnostic[] = [];\n  try {\n    const raw = readFileSync(filePath, \"utf-8\");\n    const { values, body } = parseFrontmatter(raw);\n    const skillDir = dirname(filePath);\n    const name = values.name || basename(skillDir);\n    const description = values.description ?? \"\";\n\n    if (!description.trim()) {\n      diagnostics.push({ type: \"warning\", message: \"description is required\", path: filePath });\n      return { skills: [], diagnostics };\n    }\n    for (const error of validateSkill(name, description)) {\n      diagnostics.push({ type: \"warning\", message: error, path: filePath });\n    }\n\n    return {\n      skills: [\n        {\n          name,\n          description,\n          content: body.trim(),\n          filePath,\n          baseDir: skillDir,\n          source,\n          disableModelInvocation: values[\"disable-model-invocation\"] === \"true\",\n        },\n      ],\n      diagnostics,\n    };\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : \"failed to parse skill file\",\n      path: filePath,\n    });\n    return { skills: [], diagnostics };\n  }\n}\n\n/**\n * Load skills from a directory tree.\n * - A directory containing `SKILL.md` is a skill root; no further recursion.\n * - Direct `.md` children of the top-level directory load as skills.\n * - Dot-directories and `node_modules` are skipped.\n */\nexport function loadSkillsFromDir(options: {\n  dir: string;\n  source: string;\n  /**\n   * Refuse to follow symlinks on any path this load would read, skipping the\n   * offending entry with a `code: \"symlink\"` diagnostic instead of loading\n   * it. For untrusted trees (conversation offices) the host must never\n   * follow an agent-created link; entries the loader never reads — dot\n   * directories, vendored node_modules — cannot disqualify anything.\n   */\n  rejectSymlinks?: boolean;\n}): LoadSkillsResult {\n  const rejectSymlinks = options.rejectSymlinks === true;\n  if (rejectSymlinks && isSymlink(options.dir)) {\n    return {\n      skills: [],\n      diagnostics: [\n        {\n          type: \"warning\",\n          code: \"symlink\",\n          message: \"Skills directory is a symlink; skipped\",\n          path: options.dir,\n        },\n      ],\n    };\n  }\n  return loadSkillsFromDirInternal(options.dir, options.source, true, rejectSymlinks);\n}\n\nfunction isSymlink(path: string): boolean {\n  try {\n    return lstatSync(path).isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction symlinkDiagnostic(path: string): SkillDiagnostic {\n  return {\n    type: \"warning\",\n    code: \"symlink\",\n    message: \"Skill entry is a symlink; skipped\",\n    path,\n  };\n}\n\nfunction loadSkillsFromDirInternal(\n  dir: string,\n  source: string,\n  includeRootFiles: boolean,\n  rejectSymlinks: boolean,\n): LoadSkillsResult {\n  const skills: MikanSkill[] = [];\n  const diagnostics: SkillDiagnostic[] = [];\n  if (!existsSync(dir)) return { skills, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return { skills, diagnostics };\n  }\n\n  const skillFile = entries.find((entry) => entry.name === \"SKILL.md\" && isFileLike(dir, entry));\n  if (skillFile) {\n    if (rejectSymlinks && skillFile.isSymbolicLink()) {\n      diagnostics.push(symlinkDiagnostic(join(dir, skillFile.name)));\n      return { skills, diagnostics };\n    }\n    return loadSkillFromFile(join(dir, skillFile.name), source);\n  }\n\n  for (const entry of entries) {\n    if (entry.name.startsWith(\".\") || entry.name === \"node_modules\") continue;\n    const fullPath = join(dir, entry.name);\n\n    const directory = isDirectoryLike(dir, entry);\n    if (!directory && !(includeRootFiles && entry.name.endsWith(\".md\") && isFileLike(dir, entry)))\n      continue;\n    if (rejectSymlinks && entry.isSymbolicLink()) {\n      diagnostics.push(symlinkDiagnostic(fullPath));\n      continue;\n    }\n    const result = directory\n      ? loadSkillsFromDirInternal(fullPath, source, false, rejectSymlinks)\n      : loadSkillFromFile(fullPath, source);\n    skills.push(...result.skills);\n    diagnostics.push(...result.diagnostics);\n  }\n  return { skills, diagnostics };\n}\n\nfunction isFileLike(\n  dir: string,\n  entry: { name: string; isFile(): boolean; isSymbolicLink(): boolean },\n): boolean {\n  if (entry.isFile()) return true;\n  if (!entry.isSymbolicLink()) return false;\n  try {\n    return statSync(join(dir, entry.name)).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction isDirectoryLike(\n  dir: string,\n  entry: { name: string; isDirectory(): boolean; isSymbolicLink(): boolean },\n): boolean {\n  if (entry.isDirectory()) return true;\n  if (!entry.isSymbolicLink()) return false;\n  try {\n    return statSync(join(dir, entry.name)).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n}\n\n/**\n * Format skills for a system prompt using the Agent Skills XML block.\n * Skills with `disableModelInvocation` are excluded.\n */\nexport function formatSkillsForPrompt(skills: MikanSkill[]): string {\n  const visible = skills.filter((skill) => !skill.disableModelInvocation);\n  if (visible.length === 0) return \"\";\n\n  const lines = [\n    \"\\n\\nThe following skills provide specialized instructions for specific tasks.\",\n    \"Use the read tool to load a skill's file when the task matches its description.\",\n    \"When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.\",\n    \"\",\n    \"<available_skills>\",\n  ];\n  for (const skill of visible) {\n    lines.push(\"  <skill>\");\n    lines.push(`    <name>${escapeXml(skill.name)}</name>`);\n    lines.push(`    <description>${escapeXml(skill.description)}</description>`);\n    if (skill.inline) {\n      // Inline skills carry their body: the agent cannot read their file.\n      lines.push(`    <instructions>${escapeXml(skill.content)}</instructions>`);\n    } else {\n      lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);\n    }\n    lines.push(\"  </skill>\");\n  }\n  lines.push(\"</available_skills>\");\n  return lines.join(\"\\n\");\n}\n"]}
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/harness/skills.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Office } from \"../office/index.js\";\nimport type { MikanSkill, SkillDiagnostic, LoadSkillsResult } from \"./types.js\";\nimport type { WorkspaceProjection } from \"../office/types.js\";\nimport { existsSync, lstatSync, readdirSync, readFileSync, statSync } from \"node:fs\";\nimport { basename, dirname, join } from \"node:path\";\n\nimport * as log from \"../log.js\";\n\nfunction addSkills(\n  skillMap: Map<string, MikanSkill>,\n  skills: MikanSkill[],\n  rewritePath: (path: string) => string,\n): void {\n  for (const skill of skills) {\n    skill.filePath = rewritePath(skill.filePath);\n    skill.baseDir = rewritePath(skill.baseDir);\n    skillMap.set(skill.name, skill);\n  }\n}\n\nfunction skippedSymlinkPaths(\n  diagnostics: SkillDiagnostic[],\n  translatePath: (path: string) => string,\n): string[] {\n  const skipped: string[] = [];\n  for (const diagnostic of diagnostics) {\n    if (diagnostic.code !== \"symlink\") continue;\n    log.logWarning(\"Skipping conversation skill entry (symlink)\", diagnostic.path);\n    skipped.push(translatePath(diagnostic.path));\n  }\n  return skipped;\n}\n\nexport function loadMikanSkills(\n  office: Office,\n  workspacePath: string,\n  projection: WorkspaceProjection,\n): { skills: MikanSkill[]; skippedSkillLinks: string[] } {\n  const skillMap = new Map<string, MikanSkill>();\n\n  const hostWorkspacePath = office.workspace.root;\n  const translatePath = (hostPath: string): string =>\n    hostPath.startsWith(hostWorkspacePath)\n      ? workspacePath + hostPath.slice(hostWorkspacePath.length)\n      : hostPath;\n\n  const workspaceSkillsDir = projection.promptSources.globalSkillsDir;\n  if (workspaceSkillsDir) {\n    const loaded = loadSkillsFromDir({ dir: workspaceSkillsDir, source: \"workspace\" });\n    addSkills(skillMap, loaded.skills, translatePath);\n  }\n\n  const conversationSkills = loadSkillsFromDir({\n    dir: projection.promptSources.conversationSkillsDir,\n    source: \"channel\",\n    rejectSymlinks: true,\n  });\n  const skippedSkillLinks = skippedSymlinkPaths(conversationSkills.diagnostics, translatePath);\n  addSkills(skillMap, conversationSkills.skills, translatePath);\n\n  return { skills: Array.from(skillMap.values()), skippedSkillLinks };\n}\nexport type { LoadSkillsResult } from \"./types.js\";\nexport type { MikanSkill } from \"./types.js\";\nexport type { SkillDiagnostic } from \"./types.js\";\n\nconst MAX_NAME_LENGTH = 64;\n\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\ninterface Frontmatter {\n  values: Record<string, string>;\n  body: string;\n}\n\nexport function parseFrontmatter(content: string): Frontmatter {\n  const match = content.match(/^---\\r?\\n([\\s\\S]*?)\\r?\\n---\\r?\\n?/);\n  if (!match) return { values: {}, body: content };\n\n  const values: Record<string, string> = {};\n  for (const line of (match[1] ?? \"\").split(/\\r?\\n/)) {\n    const separator = line.indexOf(\":\");\n    if (separator === -1) continue;\n    const key = line.slice(0, separator).trim();\n    if (!key) continue;\n    let value = line.slice(separator + 1).trim();\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n    values[key] = value;\n  }\n  return { values, body: content.slice(match[0].length) };\n}\n\nexport function validateSkill(name: string, description: string): string[] {\n  const errors: string[] = [];\n  if (name.length > MAX_NAME_LENGTH) {\n    errors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);\n  }\n  if (\n    !/^[a-z0-9-]+$/.test(name) ||\n    name.startsWith(\"-\") ||\n    name.endsWith(\"-\") ||\n    name.includes(\"--\")\n  ) {\n    errors.push(\"name must be lowercase a-z, 0-9 and single hyphens, not at the edges\");\n  }\n  if (description.length > MAX_DESCRIPTION_LENGTH) {\n    errors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);\n  }\n  return errors;\n}\n\nfunction loadSkillFromFile(filePath: string, source: string): LoadSkillsResult {\n  const diagnostics: SkillDiagnostic[] = [];\n  try {\n    const raw = readFileSync(filePath, \"utf-8\");\n    const { values, body } = parseFrontmatter(raw);\n    const skillDir = dirname(filePath);\n    const name = values.name || basename(skillDir);\n    const description = values.description ?? \"\";\n\n    if (!description.trim()) {\n      diagnostics.push({ type: \"warning\", message: \"description is required\", path: filePath });\n      return { skills: [], diagnostics };\n    }\n    for (const error of validateSkill(name, description)) {\n      diagnostics.push({ type: \"warning\", message: error, path: filePath });\n    }\n\n    return {\n      skills: [\n        {\n          name,\n          description,\n          content: body.trim(),\n          filePath,\n          baseDir: skillDir,\n          source,\n          disableModelInvocation: values[\"disable-model-invocation\"] === \"true\",\n        },\n      ],\n      diagnostics,\n    };\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : \"failed to parse skill file\",\n      path: filePath,\n    });\n    return { skills: [], diagnostics };\n  }\n}\n\nexport function loadSkillsFromDir(options: {\n  dir: string;\n  source: string;\n  rejectSymlinks?: boolean;\n}): LoadSkillsResult {\n  const rejectSymlinks = options.rejectSymlinks === true;\n  if (rejectSymlinks && isSymlink(options.dir)) {\n    return {\n      skills: [],\n      diagnostics: [\n        {\n          type: \"warning\",\n          code: \"symlink\",\n          message: \"Skills directory is a symlink; skipped\",\n          path: options.dir,\n        },\n      ],\n    };\n  }\n  return loadSkillsFromDirInternal(options.dir, options.source, true, rejectSymlinks);\n}\n\nfunction isSymlink(path: string): boolean {\n  try {\n    return lstatSync(path).isSymbolicLink();\n  } catch {\n    return false;\n  }\n}\n\nfunction symlinkDiagnostic(path: string): SkillDiagnostic {\n  return {\n    type: \"warning\",\n    code: \"symlink\",\n    message: \"Skill entry is a symlink; skipped\",\n    path,\n  };\n}\n\nfunction loadSkillsFromDirInternal(\n  dir: string,\n  source: string,\n  includeRootFiles: boolean,\n  rejectSymlinks: boolean,\n): LoadSkillsResult {\n  const skills: MikanSkill[] = [];\n  const diagnostics: SkillDiagnostic[] = [];\n  if (!existsSync(dir)) return { skills, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch {\n    return { skills, diagnostics };\n  }\n\n  const skillFile = entries.find((entry) => entry.name === \"SKILL.md\" && isFileLike(dir, entry));\n  if (skillFile) {\n    if (rejectSymlinks && skillFile.isSymbolicLink()) {\n      diagnostics.push(symlinkDiagnostic(join(dir, skillFile.name)));\n      return { skills, diagnostics };\n    }\n    return loadSkillFromFile(join(dir, skillFile.name), source);\n  }\n\n  for (const entry of entries) {\n    if (entry.name.startsWith(\".\") || entry.name === \"node_modules\") continue;\n    const fullPath = join(dir, entry.name);\n\n    const directory = isDirectoryLike(dir, entry);\n    if (!directory && !(includeRootFiles && entry.name.endsWith(\".md\") && isFileLike(dir, entry)))\n      continue;\n    if (rejectSymlinks && entry.isSymbolicLink()) {\n      diagnostics.push(symlinkDiagnostic(fullPath));\n      continue;\n    }\n    const result = directory\n      ? loadSkillsFromDirInternal(fullPath, source, false, rejectSymlinks)\n      : loadSkillFromFile(fullPath, source);\n    skills.push(...result.skills);\n    diagnostics.push(...result.diagnostics);\n  }\n  return { skills, diagnostics };\n}\n\nfunction isFileLike(\n  dir: string,\n  entry: { name: string; isFile(): boolean; isSymbolicLink(): boolean },\n): boolean {\n  if (entry.isFile()) return true;\n  if (!entry.isSymbolicLink()) return false;\n  try {\n    return statSync(join(dir, entry.name)).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction isDirectoryLike(\n  dir: string,\n  entry: { name: string; isDirectory(): boolean; isSymbolicLink(): boolean },\n): boolean {\n  if (entry.isDirectory()) return true;\n  if (!entry.isSymbolicLink()) return false;\n  try {\n    return statSync(join(dir, entry.name)).isDirectory();\n  } catch {\n    return false;\n  }\n}\n\nfunction escapeXml(str: string): string {\n  return str\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n}\n\nexport function formatSkillsForPrompt(skills: MikanSkill[]): string {\n  const visible = skills.filter((skill) => !skill.disableModelInvocation);\n  if (visible.length === 0) return \"\";\n\n  const lines = [\n    \"\\n\\nThe following skills provide specialized instructions for specific tasks.\",\n    \"Use the read tool to load a skill's file when the task matches its description.\",\n    \"When a skill file references a relative path, resolve it against the skill directory (parent of SKILL.md / dirname of the path) and use that absolute path in tool commands.\",\n    \"\",\n    \"<available_skills>\",\n  ];\n  for (const skill of visible) {\n    lines.push(\"  <skill>\");\n    lines.push(`    <name>${escapeXml(skill.name)}</name>`);\n    lines.push(`    <description>${escapeXml(skill.description)}</description>`);\n    if (skill.inline) {\n      lines.push(`    <instructions>${escapeXml(skill.content)}</instructions>`);\n    } else {\n      lines.push(`    <location>${escapeXml(skill.filePath)}</location>`);\n    }\n    lines.push(\"  </skill>\");\n  }\n  lines.push(\"</available_skills>\");\n  return lines.join(\"\\n\");\n}\n"]}

package/dist/harness/subagent-profiles.d.ts

@@ -1,8 +1,4 @@
 import type { LoadSubagentProfilesResult } from "./types.js";
 export type { LoadSubagentProfilesResult, SubagentProfileDiagnostic } from "./types.js";
-/**
- * Load the built-in profiles, then patch them with `<workspaceDir>/agents/*.md`.
- * Malformed files are reported and skipped, leaving the built-in in place.
- */
 export declare function loadSubagentProfiles(workspaceDir: string): LoadSubagentProfilesResult;
 //# sourceMappingURL=subagent-profiles.d.ts.map

package/dist/harness/subagent-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-profiles.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EACV,0BAA0B,EAI3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAwQxF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,0BAA0B,CAiCrF"}
+{"version":3,"file":"subagent-profiles.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,0BAA0B,EAI3B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAkQxF,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,0BAA0B,CAiCrF"}

package/dist/harness/subagent-profiles.js

@@ -1,22 +1,3 @@
-/**
- * Subagent profiles: the curated capability sets a subagent may be launched
- * with.
- *
- * Profiles exist because the two halves of a subagent definition have
- * different owners. What a profile *does* — its tools, required evidence,
- * prompt and budget — is portable, so it ships as a built-in below and is
- * versioned with the code. Which model runs it is per-installation, so it is
- * overridden by `<workspaceDir>/agents/<name>.md`.
- *
- * A workspace file therefore *patches* the built-in of the same name rather
- * than replacing it: overriding only `model:` must not force an operator to
- * restate the tools and prompt, because a restated copy silently drifts from
- * the built-in it was cloned from. A file whose name matches no built-in
- * defines a new profile and must supply `tools` itself.
- *
- * A malformed file is reported as a diagnostic and skipped, never thrown:
- * these are hand-edited, and one typo must not take the whole workspace down.
- */
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { basename, join } from "node:path";
 import { parseFrontmatter } from "./skills.js";
@@ -172,7 +153,6 @@ const THINKING_LEVELS = new Set([
     "high",
     "xhigh",
 ]);
-/** Parse a comma-separated tool list. The literal `none` is an empty grant. */
 function csv(value) {
     if (value.trim() === "none")
         return [];
@@ -210,17 +190,12 @@ function parseNonNegativeNumber(value, field) {
     }
     return parsed;
 }
-/** Apply `field` from frontmatter onto `patch` only when the file sets it. */
 function applyField(patch, values, key, field, parse) {
     const raw = values[key];
     if (raw === undefined)
         return;
     patch[field] = parse(raw);
 }
-/**
- * Build the overlay a single file contributes. Throws with a human-readable
- * message on malformed input; the caller turns that into a diagnostic.
- */
 function parseProfilePatch(filePath, base) {
     const { values, body } = parseFrontmatter(readFileSync(filePath, "utf-8"));
     const name = basename(filePath, ".md");
@@ -250,10 +225,6 @@ function parseProfilePatch(filePath, base) {
     };
     return merged;
 }
-/**
- * Load the built-in profiles, then patch them with `<workspaceDir>/agents/*.md`.
- * Malformed files are reported and skipped, leaving the built-in in place.
- */
 export function loadSubagentProfiles(workspaceDir) {
     const dir = join(workspaceDir, "agents");
     const profiles = new Map(BUILTIN_PROFILES.map((profile) => [profile.name, profile]));

package/dist/harness/subagent-profiles.js.map

@@ -1 +1 @@
-{"version":3,"file":"subagent-profiles.js","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subagent profiles: the curated capability sets a subagent may be launched\n * with.\n *\n * Profiles exist because the two halves of a subagent definition have\n * different owners. What a profile *does* — its tools, required evidence,\n * prompt and budget — is portable, so it ships as a built-in below and is\n * versioned with the code. Which model runs it is per-installation, so it is\n * overridden by `<workspaceDir>/agents/<name>.md`.\n *\n * A workspace file therefore *patches* the built-in of the same name rather\n * than replacing it: overriding only `model:` must not force an operator to\n * restate the tools and prompt, because a restated copy silently drifts from\n * the built-in it was cloned from. A file whose name matches no built-in\n * defines a new profile and must supply `tools` itself.\n *\n * A malformed file is reported as a diagnostic and skipped, never thrown:\n * these are hand-edited, and one typo must not take the whole workspace down.\n */\nimport { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type {\n  LoadSubagentProfilesResult,\n  SubagentModelSpec,\n  SubagentProfile,\n  SubagentProfileDiagnostic,\n} from \"./types.js\";\n\nexport type { LoadSubagentProfilesResult, SubagentProfileDiagnostic } from \"./types.js\";\nimport { parseFrontmatter } from \"./skills.js\";\n\nconst BUILTIN_PROFILES: SubagentProfile[] = [\n  {\n    name: \"worker\",\n    description: \"Completes a bounded general-purpose task without adding domain assumptions\",\n    systemPrompt: [\n      \"You are a general-purpose worker responsible for one clearly bounded delegated task.\",\n      \"\",\n      \"Use `read` and `bash` to inspect the actual workspace state, and use `edit` or `write` only when the assignment requires changes. Follow applicable skill instructions, preserve behavior outside the stated scope, and do not invent requirements or broaden the task. Verify concrete outputs before reporting success; if the assignment lacks information or a required capability, state the limitation instead of guessing.\",\n      \"\",\n      \"Keep verbose discovery and command output in this isolated run. Return the completed result, files or artifacts changed, verification performed, and any unresolved blocker.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"software-engineer\",\n    description:\n      \"Owns software investigation, implementation, integration, and technical verification\",\n    systemPrompt: [\n      \"You are the software engineer responsible for one delegated technical outcome.\",\n      \"\",\n      \"Apply the relevant engineering and vendor skill instructions. Use `bash` to inspect repositories, run development tools, diagnose browser or integration behavior, and make only changes explicitly included in the assignment. Trace failures to their technical cause, preserve existing contracts outside scope, and verify work with the narrowest meaningful checks. Do not treat plausible output as evidence of success.\",\n      \"\",\n      \"Keep source discovery, build logs, browser traces, and repetitive diagnostics in this isolated run. Return the implemented or diagnosed outcome, decisive technical evidence, changed artifact paths when applicable, verification results, and remaining engineering risk.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"devops-engineer\",\n    description:\n      \"Owns cloud access, environments, deployments, and production workflow reliability\",\n    systemPrompt: [\n      \"You are the DevOps engineer responsible for one delegated infrastructure or production-operations outcome.\",\n      \"\",\n      \"Apply the relevant setup, GCP, repository-access, service-status, and production workflow skill instructions. Use `bash` to inspect current state before acting. Respect the named project, environment, principal, and resource scope; protect credentials; prefer least privilege; and check idempotency before writes, retries, or provisioning. Do not broaden access or repeat a non-idempotent operation without explicit authorization and evidence that it is needed.\",\n      \"\",\n      \"Keep verbose CLI, API, and job logs in this isolated run. Return the resulting state, affected resources or job identifiers, verification performed, and concrete follow-up or rollback information.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"event\", \"sandbox\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"data-scientist\",\n    description:\n      \"Owns metric definition, data analysis, reconciliation, and defensible conclusions\",\n    systemPrompt: [\n      \"You are the data scientist responsible for answering one delegated quantitative question.\",\n      \"\",\n      \"Apply the relevant Metabase, GAM, accounting, billing, reporting, and parser skill instructions. Use `bash` to run the prescribed queries and analysis tools. Establish the time range, timezone, filters, dimensions, population, and metric definitions before interpreting results. Reconcile totals and cross-check consequential figures when practical. Separate source values, derived calculations, and inference; never fill missing data with guesses.\",\n      \"\",\n      \"Keep verbose rows and query output in this isolated run. Return the conclusion, key figures with units and scope, methodology and checks, and limitations that affect confidence.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"account-manager\",\n    description:\n      \"Owns existing-client onboarding, account coordination, and delivery follow-through\",\n    systemPrompt: [\n      \"You are the account manager responsible for one delegated existing-client outcome.\",\n      \"\",\n      \"Apply the relevant onboarding, publisher account, slot, workspace, meeting, and communication skill instructions. Use `bash` to inspect the current customer and account state before acting. Preserve supplied commercial and technical requirements, coordinate dependencies, avoid duplicate account changes, and clearly distinguish completed work from items awaiting another owner. Do not invent customer approval or make an external commitment beyond the assignment.\",\n      \"\",\n      \"Keep verbose records and operational output in this isolated run. Return the customer-facing outcome, account or artifact identifiers, decisions and blockers, and the next owner and action where follow-through remains.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"event\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"business-development\",\n    description:\n      \"Owns prospect research, qualification, contact discovery, and outreach preparation\",\n    systemPrompt: [\n      \"You are the business development specialist responsible for one delegated growth opportunity.\",\n      \"\",\n      \"Apply the relevant prospecting, website sampling, contact-finding, email-validation, and client-approach skill instructions. Use `bash` to gather and verify public evidence. Evaluate fit against the supplied criteria, distinguish verified contacts from inferred ones, and preserve source URLs. Do not contact prospects, submit forms, or represent that outreach occurred unless the assignment explicitly authorizes it.\",\n      \"\",\n      \"Keep raw pages, candidate lists, and repetitive validation output in this isolated run. Return qualified opportunities, supporting evidence, confidence and disqualifiers, and a concise recommended next action.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"creative-producer\",\n    description: \"Owns media deliverables from creative brief through verified production output\",\n    systemPrompt: [\n      \"You are the creative producer responsible for one delegated media deliverable.\",\n      \"\",\n      \"Apply the relevant source acquisition, storyboard, video, image, speech, lipsync, and generation-provider skill instructions. Use `bash` to run the prescribed production tools, and `generate_image` for image deliverables. Confirm the brief, audience, format, dimensions, duration, language, and source inputs; use discovery commands rather than guessing provider or model identifiers. Preserve provenance and generation parameters, and verify that claimed outputs exist and match the requested technical properties.\",\n      \"\",\n      \"Keep generation logs, intermediate assets, and provider polling in this isolated run. Return deliverable paths or external identifiers, a concise production summary, verification results, and unresolved creative, quality, or rights constraints.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"generate_image\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"ad-operations-specialist\",\n    description:\n      \"Owns ad serving setup, delivery diagnostics, policy checks, and operational health\",\n    systemPrompt: [\n      \"You are the ad operations specialist responsible for one delegated advertising-delivery outcome.\",\n      \"\",\n      \"Apply the relevant GAM, ads.txt, player detection, targeting, behavior, monitoring, and policy skill instructions. Use `bash` to run the prescribed browser and reporting tools. Establish the site, account, slot, time window, geography, device, and consent conditions; distinguish configuration, eligibility, request, impression, and playback evidence. Reproduce dynamic behavior when practical, and do not change live serving configuration unless explicitly authorized.\",\n      \"\",\n      \"Keep browser traces, HAR data, report rows, and repetitive diagnostics in this isolated run. Return the operational conclusion, decisive delivery evidence, affected inventory, remediation or escalation owner, and uncertainty that could change the diagnosis.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"summarizer\",\n    description:\n      \"Synthesizes supplied task input and upstream DAG dependency output without claiming external verification\",\n    systemPrompt: [\n      \"You synthesize only the task text and structured dependency input supplied to this run — typically the combined output of upstream DAG nodes that did their own investigation.\",\n      \"\",\n      \"Do not claim to have inspected files, executed commands, accessed URLs, or verified external state. Clearly distinguish dependency-provided facts from your own analysis. If the supplied evidence is insufficient, state the limitation instead of inventing details. `jev` is your only tool: use it to classify, rank, or check claims against the supplied input when the volume is large or a calibrated probability helps.\",\n    ].join(\"\\n\"),\n    tools: [\"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n];\n\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\n  \"off\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n]);\n\n/** Parse a comma-separated tool list. The literal `none` is an empty grant. */\nfunction csv(value: string): string[] {\n  if (value.trim() === \"none\") return [];\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((item) => item.trim())\n        .filter(Boolean),\n    ),\n  ];\n}\n\nfunction parseModel(value: string): SubagentModelSpec {\n  const separator = value.indexOf(\"/\");\n  if (separator <= 0 || separator === value.length - 1) {\n    throw new Error(`model must be provider/id, got ${value}`);\n  }\n  return { provider: value.slice(0, separator), id: value.slice(separator + 1) };\n}\n\nfunction parseThinking(value: string): ThinkingLevel {\n  if (!THINKING_LEVELS.has(value as ThinkingLevel)) {\n    throw new Error(`unknown thinking level: ${value}`);\n  }\n  return value as ThinkingLevel;\n}\n\nfunction parsePositiveInteger(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(`${field} must be a positive integer`);\n  }\n  return parsed;\n}\n\nfunction parseNonNegativeNumber(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new Error(`${field} must be a non-negative number`);\n  }\n  return parsed;\n}\n\n/** Apply `field` from frontmatter onto `patch` only when the file sets it. */\nfunction applyField<K extends keyof SubagentProfile>(\n  patch: Partial<SubagentProfile>,\n  values: Record<string, string>,\n  key: string,\n  field: K,\n  parse: (value: string) => SubagentProfile[K],\n): void {\n  const raw = values[key];\n  if (raw === undefined) return;\n  patch[field] = parse(raw);\n}\n\n/**\n * Build the overlay a single file contributes. Throws with a human-readable\n * message on malformed input; the caller turns that into a diagnostic.\n */\nfunction parseProfilePatch(filePath: string, base: SubagentProfile | undefined): SubagentProfile {\n  const { values, body } = parseFrontmatter(readFileSync(filePath, \"utf-8\"));\n  const name = basename(filePath, \".md\");\n  const patch: Partial<SubagentProfile> = {};\n\n  applyField(patch, values, \"description\", \"description\", (value) => value.trim());\n  applyField(patch, values, \"tools\", \"tools\", csv);\n  applyField(patch, values, \"model\", \"model\", parseModel);\n  applyField(patch, values, \"thinking\", \"thinkingLevel\", parseThinking);\n  applyField(patch, values, \"max_turns\", \"maxTurns\", (v) => parsePositiveInteger(v, \"max_turns\"));\n  applyField(patch, values, \"max_tokens\", \"maxTokens\", (v) =>\n    parsePositiveInteger(v, \"max_tokens\"),\n  );\n  applyField(patch, values, \"max_cost_usd\", \"maxCostUsd\", (v) =>\n    parseNonNegativeNumber(v, \"max_cost_usd\"),\n  );\n  applyField(patch, values, \"max_duration_ms\", \"maxDurationMs\", (v) =>\n    parsePositiveInteger(v, \"max_duration_ms\"),\n  );\n\n  const systemPrompt = body.trim() || base?.systemPrompt;\n  if (!base && patch.tools === undefined) {\n    throw new Error(`tools is required for a new profile (no built-in named ${name})`);\n  }\n  if (!systemPrompt) {\n    throw new Error(`a new profile needs prompt text in the file body`);\n  }\n\n  const merged: SubagentProfile = {\n    ...base,\n    ...patch,\n    name,\n    description: patch.description || base?.description || name,\n    systemPrompt,\n    tools: patch.tools ?? base?.tools ?? [],\n  };\n  return merged;\n}\n\n/**\n * Load the built-in profiles, then patch them with `<workspaceDir>/agents/*.md`.\n * Malformed files are reported and skipped, leaving the built-in in place.\n */\nexport function loadSubagentProfiles(workspaceDir: string): LoadSubagentProfilesResult {\n  const dir = join(workspaceDir, \"agents\");\n  const profiles = new Map(BUILTIN_PROFILES.map((profile) => [profile.name, profile]));\n  const diagnostics: SubagentProfileDiagnostic[] = [];\n  if (!existsSync(dir)) return { profiles, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : String(error),\n      path: dir,\n    });\n    return { profiles, diagnostics };\n  }\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n    const filePath = join(dir, entry.name);\n    try {\n      const profile = parseProfilePatch(filePath, profiles.get(basename(entry.name, \".md\")));\n      profiles.set(profile.name, profile);\n    } catch (error) {\n      diagnostics.push({\n        type: \"warning\",\n        message: error instanceof Error ? error.message : String(error),\n        path: filePath,\n      });\n    }\n  }\n  return { profiles, diagnostics };\n}\n"]}
+{"version":3,"file":"subagent-profiles.js","sourceRoot":"","sources":["../../src/harness/subagent-profiles.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { basename, join } from \"node:path\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type {\n  LoadSubagentProfilesResult,\n  SubagentModelSpec,\n  SubagentProfile,\n  SubagentProfileDiagnostic,\n} from \"./types.js\";\n\nexport type { LoadSubagentProfilesResult, SubagentProfileDiagnostic } from \"./types.js\";\nimport { parseFrontmatter } from \"./skills.js\";\n\nconst BUILTIN_PROFILES: SubagentProfile[] = [\n  {\n    name: \"worker\",\n    description: \"Completes a bounded general-purpose task without adding domain assumptions\",\n    systemPrompt: [\n      \"You are a general-purpose worker responsible for one clearly bounded delegated task.\",\n      \"\",\n      \"Use `read` and `bash` to inspect the actual workspace state, and use `edit` or `write` only when the assignment requires changes. Follow applicable skill instructions, preserve behavior outside the stated scope, and do not invent requirements or broaden the task. Verify concrete outputs before reporting success; if the assignment lacks information or a required capability, state the limitation instead of guessing.\",\n      \"\",\n      \"Keep verbose discovery and command output in this isolated run. Return the completed result, files or artifacts changed, verification performed, and any unresolved blocker.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"software-engineer\",\n    description:\n      \"Owns software investigation, implementation, integration, and technical verification\",\n    systemPrompt: [\n      \"You are the software engineer responsible for one delegated technical outcome.\",\n      \"\",\n      \"Apply the relevant engineering and vendor skill instructions. Use `bash` to inspect repositories, run development tools, diagnose browser or integration behavior, and make only changes explicitly included in the assignment. Trace failures to their technical cause, preserve existing contracts outside scope, and verify work with the narrowest meaningful checks. Do not treat plausible output as evidence of success.\",\n      \"\",\n      \"Keep source discovery, build logs, browser traces, and repetitive diagnostics in this isolated run. Return the implemented or diagnosed outcome, decisive technical evidence, changed artifact paths when applicable, verification results, and remaining engineering risk.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"devops-engineer\",\n    description:\n      \"Owns cloud access, environments, deployments, and production workflow reliability\",\n    systemPrompt: [\n      \"You are the DevOps engineer responsible for one delegated infrastructure or production-operations outcome.\",\n      \"\",\n      \"Apply the relevant setup, GCP, repository-access, service-status, and production workflow skill instructions. Use `bash` to inspect current state before acting. Respect the named project, environment, principal, and resource scope; protect credentials; prefer least privilege; and check idempotency before writes, retries, or provisioning. Do not broaden access or repeat a non-idempotent operation without explicit authorization and evidence that it is needed.\",\n      \"\",\n      \"Keep verbose CLI, API, and job logs in this isolated run. Return the resulting state, affected resources or job identifiers, verification performed, and concrete follow-up or rollback information.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"edit\", \"write\", \"event\", \"sandbox\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"data-scientist\",\n    description:\n      \"Owns metric definition, data analysis, reconciliation, and defensible conclusions\",\n    systemPrompt: [\n      \"You are the data scientist responsible for answering one delegated quantitative question.\",\n      \"\",\n      \"Apply the relevant Metabase, GAM, accounting, billing, reporting, and parser skill instructions. Use `bash` to run the prescribed queries and analysis tools. Establish the time range, timezone, filters, dimensions, population, and metric definitions before interpreting results. Reconcile totals and cross-check consequential figures when practical. Separate source values, derived calculations, and inference; never fill missing data with guesses.\",\n      \"\",\n      \"Keep verbose rows and query output in this isolated run. Return the conclusion, key figures with units and scope, methodology and checks, and limitations that affect confidence.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"account-manager\",\n    description:\n      \"Owns existing-client onboarding, account coordination, and delivery follow-through\",\n    systemPrompt: [\n      \"You are the account manager responsible for one delegated existing-client outcome.\",\n      \"\",\n      \"Apply the relevant onboarding, publisher account, slot, workspace, meeting, and communication skill instructions. Use `bash` to inspect the current customer and account state before acting. Preserve supplied commercial and technical requirements, coordinate dependencies, avoid duplicate account changes, and clearly distinguish completed work from items awaiting another owner. Do not invent customer approval or make an external commitment beyond the assignment.\",\n      \"\",\n      \"Keep verbose records and operational output in this isolated run. Return the customer-facing outcome, account or artifact identifiers, decisions and blockers, and the next owner and action where follow-through remains.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"event\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"business-development\",\n    description:\n      \"Owns prospect research, qualification, contact discovery, and outreach preparation\",\n    systemPrompt: [\n      \"You are the business development specialist responsible for one delegated growth opportunity.\",\n      \"\",\n      \"Apply the relevant prospecting, website sampling, contact-finding, email-validation, and client-approach skill instructions. Use `bash` to gather and verify public evidence. Evaluate fit against the supplied criteria, distinguish verified contacts from inferred ones, and preserve source URLs. Do not contact prospects, submit forms, or represent that outreach occurred unless the assignment explicitly authorizes it.\",\n      \"\",\n      \"Keep raw pages, candidate lists, and repetitive validation output in this isolated run. Return qualified opportunities, supporting evidence, confidence and disqualifiers, and a concise recommended next action.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"creative-producer\",\n    description: \"Owns media deliverables from creative brief through verified production output\",\n    systemPrompt: [\n      \"You are the creative producer responsible for one delegated media deliverable.\",\n      \"\",\n      \"Apply the relevant source acquisition, storyboard, video, image, speech, lipsync, and generation-provider skill instructions. Use `bash` to run the prescribed production tools, and `generate_image` for image deliverables. Confirm the brief, audience, format, dimensions, duration, language, and source inputs; use discovery commands rather than guessing provider or model identifiers. Preserve provenance and generation parameters, and verify that claimed outputs exist and match the requested technical properties.\",\n      \"\",\n      \"Keep generation logs, intermediate assets, and provider polling in this isolated run. Return deliverable paths or external identifiers, a concise production summary, verification results, and unresolved creative, quality, or rights constraints.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\", \"generate_image\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"ad-operations-specialist\",\n    description:\n      \"Owns ad serving setup, delivery diagnostics, policy checks, and operational health\",\n    systemPrompt: [\n      \"You are the ad operations specialist responsible for one delegated advertising-delivery outcome.\",\n      \"\",\n      \"Apply the relevant GAM, ads.txt, player detection, targeting, behavior, monitoring, and policy skill instructions. Use `bash` to run the prescribed browser and reporting tools. Establish the site, account, slot, time window, geography, device, and consent conditions; distinguish configuration, eligibility, request, impression, and playback evidence. Reproduce dynamic behavior when practical, and do not change live serving configuration unless explicitly authorized.\",\n      \"\",\n      \"Keep browser traces, HAR data, report rows, and repetitive diagnostics in this isolated run. Return the operational conclusion, decisive delivery evidence, affected inventory, remediation or escalation owner, and uncertainty that could change the diagnosis.\",\n    ].join(\"\\n\"),\n    tools: [\"read\", \"bash\", \"write\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n  {\n    name: \"summarizer\",\n    description:\n      \"Synthesizes supplied task input and upstream DAG dependency output without claiming external verification\",\n    systemPrompt: [\n      \"You synthesize only the task text and structured dependency input supplied to this run — typically the combined output of upstream DAG nodes that did their own investigation.\",\n      \"\",\n      \"Do not claim to have inspected files, executed commands, accessed URLs, or verified external state. Clearly distinguish dependency-provided facts from your own analysis. If the supplied evidence is insufficient, state the limitation instead of inventing details. `jev` is your only tool: use it to classify, rank, or check claims against the supplied input when the volume is large or a calibrated probability helps.\",\n    ].join(\"\\n\"),\n    tools: [\"jev\"],\n    thinkingLevel: \"high\",\n    maxTurns: 100,\n    maxTokens: 1_000_000,\n    maxCostUsd: 10,\n  },\n];\n\nconst THINKING_LEVELS = new Set<ThinkingLevel>([\n  \"off\",\n  \"minimal\",\n  \"low\",\n  \"medium\",\n  \"high\",\n  \"xhigh\",\n]);\n\nfunction csv(value: string): string[] {\n  if (value.trim() === \"none\") return [];\n  return [\n    ...new Set(\n      value\n        .split(\",\")\n        .map((item) => item.trim())\n        .filter(Boolean),\n    ),\n  ];\n}\n\nfunction parseModel(value: string): SubagentModelSpec {\n  const separator = value.indexOf(\"/\");\n  if (separator <= 0 || separator === value.length - 1) {\n    throw new Error(`model must be provider/id, got ${value}`);\n  }\n  return { provider: value.slice(0, separator), id: value.slice(separator + 1) };\n}\n\nfunction parseThinking(value: string): ThinkingLevel {\n  if (!THINKING_LEVELS.has(value as ThinkingLevel)) {\n    throw new Error(`unknown thinking level: ${value}`);\n  }\n  return value as ThinkingLevel;\n}\n\nfunction parsePositiveInteger(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isInteger(parsed) || parsed <= 0) {\n    throw new Error(`${field} must be a positive integer`);\n  }\n  return parsed;\n}\n\nfunction parseNonNegativeNumber(value: string, field: string): number {\n  const parsed = Number(value);\n  if (!Number.isFinite(parsed) || parsed < 0) {\n    throw new Error(`${field} must be a non-negative number`);\n  }\n  return parsed;\n}\n\nfunction applyField<K extends keyof SubagentProfile>(\n  patch: Partial<SubagentProfile>,\n  values: Record<string, string>,\n  key: string,\n  field: K,\n  parse: (value: string) => SubagentProfile[K],\n): void {\n  const raw = values[key];\n  if (raw === undefined) return;\n  patch[field] = parse(raw);\n}\n\nfunction parseProfilePatch(filePath: string, base: SubagentProfile | undefined): SubagentProfile {\n  const { values, body } = parseFrontmatter(readFileSync(filePath, \"utf-8\"));\n  const name = basename(filePath, \".md\");\n  const patch: Partial<SubagentProfile> = {};\n\n  applyField(patch, values, \"description\", \"description\", (value) => value.trim());\n  applyField(patch, values, \"tools\", \"tools\", csv);\n  applyField(patch, values, \"model\", \"model\", parseModel);\n  applyField(patch, values, \"thinking\", \"thinkingLevel\", parseThinking);\n  applyField(patch, values, \"max_turns\", \"maxTurns\", (v) => parsePositiveInteger(v, \"max_turns\"));\n  applyField(patch, values, \"max_tokens\", \"maxTokens\", (v) =>\n    parsePositiveInteger(v, \"max_tokens\"),\n  );\n  applyField(patch, values, \"max_cost_usd\", \"maxCostUsd\", (v) =>\n    parseNonNegativeNumber(v, \"max_cost_usd\"),\n  );\n  applyField(patch, values, \"max_duration_ms\", \"maxDurationMs\", (v) =>\n    parsePositiveInteger(v, \"max_duration_ms\"),\n  );\n\n  const systemPrompt = body.trim() || base?.systemPrompt;\n  if (!base && patch.tools === undefined) {\n    throw new Error(`tools is required for a new profile (no built-in named ${name})`);\n  }\n  if (!systemPrompt) {\n    throw new Error(`a new profile needs prompt text in the file body`);\n  }\n\n  const merged: SubagentProfile = {\n    ...base,\n    ...patch,\n    name,\n    description: patch.description || base?.description || name,\n    systemPrompt,\n    tools: patch.tools ?? base?.tools ?? [],\n  };\n  return merged;\n}\n\nexport function loadSubagentProfiles(workspaceDir: string): LoadSubagentProfilesResult {\n  const dir = join(workspaceDir, \"agents\");\n  const profiles = new Map(BUILTIN_PROFILES.map((profile) => [profile.name, profile]));\n  const diagnostics: SubagentProfileDiagnostic[] = [];\n  if (!existsSync(dir)) return { profiles, diagnostics };\n\n  let entries;\n  try {\n    entries = readdirSync(dir, { withFileTypes: true });\n  } catch (error) {\n    diagnostics.push({\n      type: \"warning\",\n      message: error instanceof Error ? error.message : String(error),\n      path: dir,\n    });\n    return { profiles, diagnostics };\n  }\n\n  for (const entry of entries) {\n    if (!entry.isFile() || !entry.name.endsWith(\".md\")) continue;\n    const filePath = join(dir, entry.name);\n    try {\n      const profile = parseProfilePatch(filePath, profiles.get(basename(entry.name, \".md\")));\n      profiles.set(profile.name, profile);\n    } catch (error) {\n      diagnostics.push({\n        type: \"warning\",\n        message: error instanceof Error ? error.message : String(error),\n        path: filePath,\n      });\n    }\n  }\n  return { profiles, diagnostics };\n}\n"]}

package/dist/harness/subagent.d.ts

@@ -8,7 +8,6 @@ export declare const DEFAULT_SUBAGENT_BUDGET: {
     readonly maxCostUsd: 10;
     readonly maxDurationMs: number;
 };
-/** Time allowed for an aborted subagent to settle before detached cleanup. */
 export declare const SUBAGENT_ABORT_GRACE_MS = 100;
 interface RunSubagentOptions<TOutputSchema extends TSchema | undefined = undefined> {
     request: SubagentRunRequest<TOutputSchema>;
@@ -18,47 +17,23 @@ interface RunSubagentOptions<TOutputSchema extends TSchema | undefined = undefin
     workspaceDir: string;
     availableTools: MikanHarnessTool[];
     profiles?: ReadonlyMap<string, SubagentProfile>;
-    /** Sandbox-backed execution env; may be omitted when no native execution tools are granted. */
     toolContext?: ExecutionToolContext;
-    /** Process-wide launch pool shared by all parent runs. */
     slots?: SubagentSlotPool;
-    /** Host-snapshotted parent transcript; never sourced from the public request. */
     parentMessages?: AgentMessage[];
-    /** Usage attribution sink snapshotted when this invocation begins. */
     onUsage?: SubagentUsageSink;
-    /**
-     * Called as the run's visible activity changes, so a caller can show what
-     * this subagent is doing rather than only that it started. Best-effort: a
-     * throwing sink is logged and the run continues.
-     */
     onActivity?: (activity: string) => void;
 }
-/**
- * Execute one non-recursive, fresh subagent run. Never rejects: every
- * failure — including request validation — is a result with a terminal
- * status, so batch callers (`tasks` / `dag`) can never orphan in-flight
- * sibling runs on one bad request. Usage is reported once, after the
- * underlying run settles; an aborted run may report it from detached cleanup.
- */
 export declare function runSubagent<TOutputSchema extends TSchema | undefined = undefined>(options: RunSubagentOptions<TOutputSchema>): Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>>;
-/** Default process-wide ceiling on concurrently live subagent sessions. */
 export declare const DEFAULT_GLOBAL_SUBAGENT_SLOTS = 8;
-/** Async slot pool: at most `capacity` concurrent holders, FIFO waiters. */
 export declare class SubagentSlotPool {
     readonly capacity: number;
     private held;
     private waiters;
     constructor(capacity: number);
-    /** Currently held slots (for tests and capacity reporting). */
     get inFlight(): number;
-    /**
-     * Resolve with a release function once a slot frees up. Call the release
-     * exactly once; releasing hands the slot to the oldest waiter.
-     */
     acquire(signal?: AbortSignal): Promise<() => void>;
     private releaser;
 }
-/** A pool that never blocks — the default when no shared ceiling is wired. */
 export declare function unboundedSlotPool(): SubagentSlotPool;
 export {};
 //# sourceMappingURL=subagent.d.ts.map

package/dist/harness/subagent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/harness/subagent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAe,KAAK,GAAG,EAAyB,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAWpB,eAAO,MAAM,uBAAuB;aAClC,QAAQ,EAAE,GAAG;aACb,UAAU,EAAE,EAAE;aACd,aAAa;CACL,CAAC;AAEX,8EAA8E;AAC9E,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAqG3C,UAAU,kBAAkB,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IAChF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD,+FAA+F;IAC/F,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,0DAA0D;IAC1D,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,iFAAiF;IACjF,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AA8OD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACrF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAc9D;AAiWD,2EAA2E;AAC3E,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,4EAA4E;AAC5E,qBAAa,gBAAgB;IAQf,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAPrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAIP;IAER,YAAqB,QAAQ,EAAE,MAAM,EAIpC;IAED,+DAA+D;IAC/D,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;;OAGG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAiBvD;IAED,OAAO,CAAC,QAAQ;CAcjB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD"}
+{"version":3,"file":"subagent.d.ts","sourceRoot":"","sources":["../../src/harness/subagent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAe,KAAK,GAAG,EAAyB,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAEf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAEjB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAWpB,eAAO,MAAM,uBAAuB;aAClC,QAAQ,EAAE,GAAG;aACb,UAAU,EAAE,EAAE;aACd,aAAa;CACL,CAAC;AAEX,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAyF3C,UAAU,kBAAkB,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IAChF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAChD,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAmND,wBAAsB,WAAW,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACrF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAc9D;AAkVD,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAE/C,qBAAa,gBAAgB;IAQf,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAPrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAIP;IAER,YAAqB,QAAQ,EAAE,MAAM,EAIpC;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAEK,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAiBvD;IAED,OAAO,CAAC,QAAQ;CAcjB;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,CAEpD"}

package/dist/harness/subagent.js

@@ -13,7 +13,6 @@ export const DEFAULT_SUBAGENT_BUDGET = {
     maxCostUsd: 10,
     maxDurationMs: 10 * 60 * 1000,
 };
-/** Time allowed for an aborted subagent to settle before detached cleanup. */
 export const SUBAGENT_ABORT_GRACE_MS = 100;
 const SCHEMA_STRUCTURAL_KEYS = new Set([
     "type",
@@ -53,18 +52,6 @@ function hydrateObject(schema, options) {
     }
     return Type.Object(props, options);
 }
-/**
- * outputSchema arrives over the subagent tool as plain JSON (tool-call
- * arguments never carry TypeBox's Kind symbol), but Value.Check dispatches
- * purely on schema[Kind] and throws ValueCheckUnknownTypeError for anything
- * without it. Hydrate plain JSON Schema into real TypeBox schema nodes so
- * validation runs instead of throwing; schemas built with TypeBox already
- * carry Kind and pass through untouched.
- *
- * Unsupported keywords ($ref, not, patternProperties, if/then/else) degrade to
- * a permissive Unknown — fail-open by design: outputSchema is advisory output
- * validation, not a security boundary.
- */
 function hydrateSchema(schema) {
     if (isRecord(schema) && Kind in schema)
         return schema;
@@ -111,16 +98,6 @@ function hydrateSchema(schema) {
             return Type.Unknown(options);
     }
 }
-/**
- * Translate a subagent session's event stream into short activity lines.
- *
- * The stream was always there — nothing subscribed to it, so every subagent
- * was silent for its whole run and a slow step looked identical to a hung one.
- *
- * Text is reported as a growing character count rather than its content: it
- * proves liveness during a long single-turn generation, which is the case with
- * nothing else to show, without putting a half-written answer on screen.
- */
 function reportSubagentActivity(session, onActivity) {
     let characters = 0;
     let reportedAt = 0;
@@ -155,8 +132,6 @@ function reportSubagentActivity(session, onActivity) {
             if (delta?.type !== "text_delta" || !delta.delta)
                 return;
             characters += delta.delta.length;
-            // Coarse steps: deltas arrive per token, and one report each would churn
-            // the dashboard for no added information.
             if (characters - reportedAt < ACTIVITY_CHARS_STEP)
                 return;
             reportedAt = characters;
@@ -164,13 +139,10 @@ function reportSubagentActivity(session, onActivity) {
             return;
         }
         if (event.type === "auto_retry_start") {
-            // The most valuable line here: a retry is the usual reason a run goes
-            // quiet for minutes, and it was completely invisible.
             report("retrying after an error");
         }
     });
 }
-/** How much new text earns a fresh activity line during a long generation. */
 const ACTIVITY_CHARS_STEP = 250;
 function resolveBudget(budget) {
     const resolved = { ...DEFAULT_SUBAGENT_BUDGET, ...budget };
@@ -260,12 +232,6 @@ function normalizedParentContext(request, messages) {
         "</parent_reference_context>",
     ].join("\n");
 }
-/**
- * The evidence policy has to name the actual grant. Told to "use granted
- * tools" while holding none, a model will write a tool call as prose and
- * hand that text back as its answer — which then flows to dependent DAG
- * nodes as if it were a finding.
- */
 function groundingPolicy(toolNames) {
     if (toolNames.length === 0) {
         return [
@@ -295,12 +261,6 @@ function buildSystemPrompt(base, outputSchema, toolNames) {
         JSON.stringify(outputSchema),
     ].join("\n");
 }
-/**
- * Every SubagentRunResult's metric fields are born here — one derivation from
- * the session's run stats, so adding a metric is one edit and no terminal
- * site can drift (the abort branch once shipped without toolCallCounts). The
- * terminal sites state only what differs: status, error, text.
- */
 function baseRunResult(runId, model, startedAt, stats) {
     const usage = stats?.usage ?? createEmptyUsage();
     return {
@@ -318,13 +278,6 @@ function baseRunResult(runId, model, startedAt, stats) {
 function finalAssistant(messages) {
     return messages.findLast((message) => message.role === "assistant");
 }
-/**
- * Execute one non-recursive, fresh subagent run. Never rejects: every
- * failure — including request validation — is a result with a terminal
- * status, so batch callers (`tasks` / `dag`) can never orphan in-flight
- * sibling runs on one bad request. Usage is reported once, after the
- * underlying run settles; an aborted run may report it from detached cleanup.
- */
 export async function runSubagent(options) {
     const execution = await executeBoundedSubagentRun(options);
     if (execution.cleanup) {
@@ -396,12 +349,6 @@ async function executeBoundedSubagentRun(options) {
     }
 }
 function noop() { }
-/**
- * Expand `request.profile` into the concrete capability set it names. Most
- * profile budgets are caps that callers may only tighten. Token budgets are
- * different: the effective allowance is the larger of the profile default and
- * the caller's request.
- */
 function resolveProfile(request, options) {
     if (!request.profile)
         return request;
@@ -579,7 +526,7 @@ async function executeSubagentRun(options) {
         if (terminalSignal)
             return;
         terminalSignal = reason;
-        run?.session.abort();
+        run?.session.abort(reason);
         notifyAbort();
     };
     const onAbort = () => abort("cancelled");
@@ -613,20 +560,10 @@ async function executeSubagentRun(options) {
         request.signal?.removeEventListener("abort", onAbort);
     }
 }
-/**
- * Process-wide subagent fan-out account. The per-conversation queues
- * serialize agent runs, and each run's subagent tool bounds its own fan-out
- * — but without a shared ceiling, N busy conversations hold N × per-run-cap
- * live subagent sessions. Every subagent launch draws a slot from one shared
- * pool; the per-run cap and this global ceiling are the two bounds, enforced
- * where each concrete subagent session is launched.
- */
 function abortError() {
     return new DOMException("The operation was aborted", "AbortError");
 }
-/** Default process-wide ceiling on concurrently live subagent sessions. */
 export const DEFAULT_GLOBAL_SUBAGENT_SLOTS = 8;
-/** Async slot pool: at most `capacity` concurrent holders, FIFO waiters. */
 export class SubagentSlotPool {
     constructor(capacity) {
         this.capacity = capacity;
@@ -636,14 +573,9 @@ export class SubagentSlotPool {
             throw new Error(`SubagentSlotPool capacity must be >= 1, got ${capacity}`);
         }
     }
-    /** Currently held slots (for tests and capacity reporting). */
     get inFlight() {
         return this.held;
     }
-    /**
-     * Resolve with a release function once a slot frees up. Call the release
-     * exactly once; releasing hands the slot to the oldest waiter.
-     */
     async acquire(signal) {
         if (signal?.aborted)
             throw abortError();
@@ -680,7 +612,6 @@ export class SubagentSlotPool {
         };
     }
 }
-/** A pool that never blocks — the default when no shared ceiling is wired. */
 export function unboundedSlotPool() {
     return new SubagentSlotPool(Number.MAX_SAFE_INTEGER);
 }