@geminixiang/mikan 1.0.0-beta.6 → 1.0.0-beta.60

package/dist/harness/skills.d.ts

@@ -1,31 +1,13 @@
-/** A loaded skill. `baseDir` is the directory containing the skill file. */
-export interface MikanSkill {
-    name: string;
-    description: string;
-    /** Full skill instructions (file content without frontmatter). */
-    content: string;
-    filePath: string;
-    baseDir: string;
-    /** Where the skill was loaded from (e.g. "workspace", "channel"). */
-    source: string;
-    /** Exclude from model-visible skill lists. */
-    disableModelInvocation?: boolean;
-    /**
-     * Embed the skill body in the prompt instead of referencing its file path.
-     * Used for skills whose files the agent cannot read at runtime (e.g.
-     * extension skills under the host-only state dir in sandbox modes).
-     */
-    inline?: boolean;
-}
-export interface SkillDiagnostic {
-    type: "warning";
-    message: string;
-    path: string;
-}
-export interface LoadSkillsResult {
+import type { Office } from "../office/index.js";
+import type { MikanSkill, LoadSkillsResult } from "./types.js";
+import type { WorkspaceProjection } from "../office/types.js";
+export declare function loadMikanSkills(office: Office, workspacePath: string, projection: WorkspaceProjection): {
     skills: MikanSkill[];
-    diagnostics: SkillDiagnostic[];
-}
+    skippedSkillLinks: string[];
+};
+export type { LoadSkillsResult } from "./types.js";
+export type { MikanSkill } from "./types.js";
+export type { SkillDiagnostic } from "./types.js";
 interface Frontmatter {
     values: Record<string, string>;
     body: string;
@@ -44,11 +26,18 @@ export declare function parseFrontmatter(content: string): Frontmatter;
 export declare function loadSkillsFromDir(options: {
     dir: string;
     source: string;
+    /**
+     * Refuse to follow symlinks on any path this load would read, skipping the
+     * offending entry with a `code: "symlink"` diagnostic instead of loading
+     * it. For untrusted trees (conversation offices) the host must never
+     * follow an agent-created link; entries the loader never reads — dot
+     * directories, vendored node_modules — cannot disqualify anything.
+     */
+    rejectSymlinks?: boolean;
 }): LoadSkillsResult;
 /**
  * Format skills for a system prompt using the Agent Skills XML block.
  * Skills with `disableModelInvocation` are excluded.
  */
 export declare function formatSkillsForPrompt(skills: MikanSkill[]): string;
-export {};
 //# sourceMappingURL=skills.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/harness/skills.ts"],"names":[],"mappings":"AAeA,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,eAAe,EAAE,CAAC;CAChC;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAoB7D;AAkED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAE5F;AAgFD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAyBlE"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/harness/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAmB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAiC9D,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,GAC9B;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BvD;AACD,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAoB7D;AA8DD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,gBAAgB,CAgBnB;AAoGD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAyBlE"}

package/dist/harness/skills.js

@@ -1,14 +1,47 @@
-/**
- * Skill loading for the mikan harness.
- *
- * Skills follow the Agent Skills layout: a directory containing a `SKILL.md`
- * with YAML frontmatter (`name`, `description`), or standalone `.md` files in
- * the root of a skills directory. Discovery mirrors the behavior mikan's
- * system prompt documents: a directory with a `SKILL.md` is a skill root
- * (no further recursion), other directories are traversed.
- */
-import { existsSync, readdirSync, readFileSync, statSync } from "fs";
-import { basename, dirname, join } from "path";
+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);
+        skill.baseDir = rewritePath(skill.baseDir);
+        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) {
+        if (diagnostic.code !== "symlink")
+            continue;
+        log.logWarning("Skipping conversation skill entry (symlink)", diagnostic.path);
+        skipped.push(translatePath(diagnostic.path));
+    }
+    return skipped;
+}
+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)
+        : hostPath;
+    const workspaceSkillsDir = projection.promptSources.globalSkillsDir;
+    if (workspaceSkillsDir) {
+        const loaded = loadSkillsFromDir({ dir: workspaceSkillsDir, source: "workspace" });
+        addSkills(skillMap, loaded.skills, translatePath);
+    }
+    const conversationSkills = loadSkillsFromDir({
+        dir: projection.promptSources.conversationSkillsDir,
+        source: "channel",
+        rejectSymlinks: true,
+    });
+    const skippedSkillLinks = skippedSymlinkPaths(conversationSkills.diagnostics, translatePath);
+    addSkills(skillMap, conversationSkills.skills, translatePath);
+    return { skills: Array.from(skillMap.values()), skippedSkillLinks };
+}
 const MAX_NAME_LENGTH = 64;
 const MAX_DESCRIPTION_LENGTH = 1024;
 /**
@@ -20,7 +53,7 @@ export function parseFrontmatter(content) {
     if (!match)
         return { values: {}, body: content };
     const values = {};
-    for (const line of match[1].split(/\r?\n/)) {
+    for (const line of (match[1] ?? "").split(/\r?\n/)) {
         const separator = line.indexOf(":");
         if (separator === -1)
             continue;
@@ -62,21 +95,23 @@ function loadSkillFromFile(filePath, source) {
         const description = values.description ?? "";
         if (!description.trim()) {
             diagnostics.push({ type: "warning", message: "description is required", path: filePath });
-            return { skill: null, diagnostics };
+            return { skills: [], diagnostics };
         }
         for (const error of validateSkill(name, description)) {
             diagnostics.push({ type: "warning", message: error, path: filePath });
         }
         return {
-            skill: {
-                name,
-                description,
-                content: body.trim(),
-                filePath,
-                baseDir: skillDir,
-                source,
-                disableModelInvocation: values["disable-model-invocation"] === "true",
-            },
+            skills: [
+                {
+                    name,
+                    description,
+                    content: body.trim(),
+                    filePath,
+                    baseDir: skillDir,
+                    source,
+                    disableModelInvocation: values["disable-model-invocation"] === "true",
+                },
+            ],
             diagnostics,
         };
     }
@@ -86,7 +121,7 @@ function loadSkillFromFile(filePath, source) {
             message: error instanceof Error ? error.message : "failed to parse skill file",
             path: filePath,
         });
-        return { skill: null, diagnostics };
+        return { skills: [], diagnostics };
     }
 }
 /**
@@ -96,9 +131,39 @@ function loadSkillFromFile(filePath, source) {
  * - Dot-directories and `node_modules` are skipped.
  */
 export function loadSkillsFromDir(options) {
-    return loadSkillsFromDirInternal(options.dir, options.source, true);
+    const rejectSymlinks = options.rejectSymlinks === true;
+    if (rejectSymlinks && isSymlink(options.dir)) {
+        return {
+            skills: [],
+            diagnostics: [
+                {
+                    type: "warning",
+                    code: "symlink",
+                    message: "Skills directory is a symlink; skipped",
+                    path: options.dir,
+                },
+            ],
+        };
+    }
+    return loadSkillsFromDirInternal(options.dir, options.source, true, rejectSymlinks);
 }
-function loadSkillsFromDirInternal(dir, source, includeRootFiles) {
+function isSymlink(path) {
+    try {
+        return lstatSync(path).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+function symlinkDiagnostic(path) {
+    return {
+        type: "warning",
+        code: "symlink",
+        message: "Skill entry is a symlink; skipped",
+        path,
+    };
+}
+function loadSkillsFromDirInternal(dir, source, includeRootFiles, rejectSymlinks) {
     const skills = [];
     const diagnostics = [];
     if (!existsSync(dir))
@@ -112,27 +177,27 @@ function loadSkillsFromDirInternal(dir, source, includeRootFiles) {
     }
     const skillFile = entries.find((entry) => entry.name === "SKILL.md" && isFileLike(dir, entry));
     if (skillFile) {
-        const result = loadSkillFromFile(join(dir, skillFile.name), source);
-        if (result.skill)
-            skills.push(result.skill);
-        diagnostics.push(...result.diagnostics);
-        return { skills, diagnostics };
+        if (rejectSymlinks && skillFile.isSymbolicLink()) {
+            diagnostics.push(symlinkDiagnostic(join(dir, skillFile.name)));
+            return { skills, diagnostics };
+        }
+        return loadSkillFromFile(join(dir, skillFile.name), source);
     }
     for (const entry of entries) {
         if (entry.name.startsWith(".") || entry.name === "node_modules")
             continue;
         const fullPath = join(dir, entry.name);
-        if (isDirectoryLike(dir, entry)) {
-            const subResult = loadSkillsFromDirInternal(fullPath, source, false);
-            skills.push(...subResult.skills);
-            diagnostics.push(...subResult.diagnostics);
+        const directory = isDirectoryLike(dir, entry);
+        if (!directory && !(includeRootFiles && entry.name.endsWith(".md") && isFileLike(dir, entry)))
             continue;
-        }
-        if (!includeRootFiles || !entry.name.endsWith(".md") || !isFileLike(dir, entry))
+        if (rejectSymlinks && entry.isSymbolicLink()) {
+            diagnostics.push(symlinkDiagnostic(fullPath));
             continue;
-        const result = loadSkillFromFile(fullPath, source);
-        if (result.skill)
-            skills.push(result.skill);
+        }
+        const result = directory
+            ? loadSkillsFromDirInternal(fullPath, source, false, rejectSymlinks)
+            : loadSkillFromFile(fullPath, source);
+        skills.push(...result.skills);
         diagnostics.push(...result.diagnostics);
     }
     return { skills, diagnostics };

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":["/**\n * Skill loading for the mikan harness.\n *\n * Skills follow the Agent Skills layout: a directory containing a `SKILL.md`\n * with YAML frontmatter (`name`, `description`), or standalone `.md` files in\n * the root of a skills directory. Discovery mirrors the behavior mikan's\n * system prompt documents: a directory with a `SKILL.md` is a skill root\n * (no further recursion), other directories are traversed.\n */\nimport { existsSync, readdirSync, readFileSync, statSync } from \"fs\";\nimport { basename, dirname, join } from \"path\";\n\nconst MAX_NAME_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\n/** A loaded skill. `baseDir` is the directory containing the skill file. */\nexport interface MikanSkill {\n  name: string;\n  description: string;\n  /** Full skill instructions (file content without frontmatter). */\n  content: string;\n  filePath: string;\n  baseDir: string;\n  /** Where the skill was loaded from (e.g. \"workspace\", \"channel\"). */\n  source: string;\n  /** Exclude from model-visible skill lists. */\n  disableModelInvocation?: boolean;\n  /**\n   * Embed the skill body in the prompt instead of referencing its file path.\n   * Used for skills whose files the agent cannot read at runtime (e.g.\n   * extension skills under the host-only state dir in sandbox modes).\n   */\n  inline?: boolean;\n}\n\nexport interface SkillDiagnostic {\n  type: \"warning\";\n  message: string;\n  path: string;\n}\n\nexport interface LoadSkillsResult {\n  skills: MikanSkill[];\n  diagnostics: SkillDiagnostic[];\n}\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\nfunction 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(\n  filePath: string,\n  source: string,\n): {\n  skill: MikanSkill | null;\n  diagnostics: SkillDiagnostic[];\n} {\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 { skill: null, diagnostics };\n    }\n    for (const error of validateSkill(name, description)) {\n      diagnostics.push({ type: \"warning\", message: error, path: filePath });\n    }\n\n    return {\n      skill: {\n        name,\n        description,\n        content: body.trim(),\n        filePath,\n        baseDir: skillDir,\n        source,\n        disableModelInvocation: values[\"disable-model-invocation\"] === \"true\",\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 { skill: null, 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: { dir: string; source: string }): LoadSkillsResult {\n  return loadSkillsFromDirInternal(options.dir, options.source, true);\n}\n\nfunction loadSkillsFromDirInternal(\n  dir: string,\n  source: string,\n  includeRootFiles: 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    const result = loadSkillFromFile(join(dir, skillFile.name), source);\n    if (result.skill) skills.push(result.skill);\n    diagnostics.push(...result.diagnostics);\n    return { skills, diagnostics };\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    if (isDirectoryLike(dir, entry)) {\n      const subResult = loadSkillsFromDirInternal(fullPath, source, false);\n      skills.push(...subResult.skills);\n      diagnostics.push(...subResult.diagnostics);\n      continue;\n    }\n    if (!includeRootFiles || !entry.name.endsWith(\".md\") || !isFileLike(dir, entry)) continue;\n\n    const result = loadSkillFromFile(fullPath, source);\n    if (result.skill) skills.push(result.skill);\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\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\nfunction 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"]}

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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +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;AA8PxF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,0BAA0B,CAiCrF"}