@geminixiang/mikan 1.0.0-beta.3 → 1.0.0-beta.30

package/dist/harness/session-store.d.ts

@@ -1,12 +1,12 @@
 import type { AgentMessage } from "@earendil-works/pi-agent-core";
 import type { ImageContent, TextContent } from "@earendil-works/pi-ai";
 import { type SessionContext, type SessionEntry, type SessionFileEntry, type SessionHeader } from "./types.js";
-/** Parse JSONL content tolerantly: malformed lines are skipped. */
+/** Parse JSONL content tolerantly for compatibility with existing read-only callers. */
 export declare function parseSessionFileEntries(content: string): SessionFileEntry[];
 /**
- * Load a session file. Returns no entries when the file is missing or its
- * first parseable line is not a valid session header (mirrors the tolerant
- * read behavior mikan has relied on). Throws only on I/O errors.
+ * Load and validate a session file. Missing and whitespace-only files return
+ * no entries. A malformed final non-empty line is ignored as a crash tail;
+ * all other malformed JSON and invalid tree relationships throw.
  */
 export declare function loadSessionFileEntries(filePath: string): SessionFileEntry[];
 /**
@@ -22,6 +22,7 @@ export declare class SessionStore {
     private readonly sessionId;
     private header;
     private headerOnDisk;
+    private rewriteBeforeAppend;
     private entries;
     private byId;
     private leafId;
@@ -39,7 +40,10 @@ export declare class SessionStore {
     static create(path: string, cwd: string, options?: {
         id?: string;
     }): SessionStore;
-    getSessionFile(): string;
+    /** Create an ephemeral session that never writes a session file. */
+    static inMemory(cwd?: string): SessionStore;
+    getSessionFile(): string | undefined;
+    isPersisted(): boolean;
     getCwd(): string;
     /** Session header as read from disk, or null when the file had none. */
     getHeader(): SessionHeader | null;

package/dist/harness/session-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAkBpB,mEAAmE;AACnE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAmB3E;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAM3E;AAQD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAuB;IAErC,OAAO,eAiBN;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAW5D;IAED,kFAAkF;IAClF,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY,CAUhF;IAED,cAAc,IAAI,MAAM,CAEvB;IAED,MAAM,IAAI,MAAM,CAEf;IAED,wEAAwE;IACxE,SAAS,IAAI,aAAa,GAAG,IAAI,CAEhC;IAED,8EAA8E;IAC9E,YAAY,IAAI,MAAM,CAErB;IAED,SAAS,IAAI,MAAM,GAAG,IAAI,CAEzB;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE7C;IAED,qEAAqE;IACrE,UAAU,IAAI,YAAY,EAAE,CAE3B;IAED,iDAAiD;IACjD,cAAc,IAAI,MAAM,GAAG,SAAS,CAMnC;IAED;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAUzC;IAED;;;OAGG;IACH,mBAAmB,IAAI,cAAc,CAEpC;IAED,kFAAkF;IAClF,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAE3C;IAED,0EAA0E;IAC1E,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAE5D;IAED,sEAAsE;IACtE,wBAAwB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,MAAM,CAER;IAED,0CAA0C;IAC1C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtC;IAED,8DAA8D;IAC9D,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,EACxB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE,OAAO,GACjB,MAAM,CASR;IAED,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,OAAO;CAiBhB"}
+{"version":3,"file":"session-store.d.ts","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"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"}

package/dist/harness/session-store.js

@@ -26,7 +26,7 @@ function generateEntryId(byId) {
     }
     return randomUUID();
 }
-/** Parse JSONL content tolerantly: malformed lines are skipped. */
+/** Parse JSONL content tolerantly for compatibility with existing read-only callers. */
 export function parseSessionFileEntries(content) {
     const entries = [];
     for (const line of content.split("\n")) {
@@ -42,7 +42,7 @@ export function parseSessionFileEntries(content) {
             }
         }
         catch {
-            // Skip malformed lines
+            // This compatibility parser is intentionally tolerant. SessionStore.open is not.
         }
     }
     return entries;
@@ -50,26 +50,120 @@ export function parseSessionFileEntries(content) {
 function isSessionHeader(entry) {
     return entry.type === "session" && typeof entry.id === "string";
 }
-/**
- * Load a session file. Returns no entries when the file is missing or its
- * first parseable line is not a valid session header (mirrors the tolerant
- * read behavior mikan has relied on). Throws only on I/O errors.
- */
-export function loadSessionFileEntries(filePath) {
+function corrupted(filePath, detail) {
+    return new Error(`Session file is corrupted (${detail}): ${filePath}. Refusing to open for writing.`);
+}
+function parseSessionLine(line, filePath, lineNumber) {
+    let parsed;
+    try {
+        parsed = JSON.parse(line);
+    }
+    catch {
+        throw corrupted(filePath, `line ${lineNumber} is not valid JSON`);
+    }
+    if (!parsed ||
+        typeof parsed !== "object" ||
+        typeof parsed.type !== "string") {
+        throw corrupted(filePath, `line ${lineNumber} is not a session object`);
+    }
+    return parsed;
+}
+function validateSessionTree(filePath, fileEntries) {
+    const records = fileEntries.slice(1);
+    const allIds = new Set();
+    const treeEntries = new Map();
+    for (const [index, record] of records.entries()) {
+        const lineNumber = index + 2;
+        if (isSessionHeader(record))
+            throw corrupted(filePath, `line ${lineNumber} repeats the header`);
+        const entry = record;
+        if (typeof entry.id !== "string" || !entry.id) {
+            throw corrupted(filePath, `line ${lineNumber} has no entry id`);
+        }
+        if (allIds.has(entry.id))
+            throw corrupted(filePath, `duplicate entry id ${entry.id}`);
+        allIds.add(entry.id);
+        if (entry.type !== "leaf")
+            treeEntries.set(entry.id, entry);
+    }
+    for (const [index, record] of records.entries()) {
+        const lineNumber = index + 2;
+        const entry = record;
+        if (entry.parentId !== null && typeof entry.parentId !== "string") {
+            throw corrupted(filePath, `line ${lineNumber} has an invalid parentId`);
+        }
+        if (entry.parentId === entry.id)
+            throw corrupted(filePath, `entry ${entry.id} is its own parent`);
+        if (entry.parentId !== null && !treeEntries.has(entry.parentId)) {
+            throw corrupted(filePath, `entry ${entry.id} references missing parent ${entry.parentId}`);
+        }
+        if (entry.type === "leaf") {
+            if (entry.targetId !== null && typeof entry.targetId !== "string") {
+                throw corrupted(filePath, `leaf ${entry.id} has an invalid target`);
+            }
+            if (entry.targetId !== null && !treeEntries.has(entry.targetId)) {
+                throw corrupted(filePath, `leaf ${entry.id} references missing target ${entry.targetId}`);
+            }
+        }
+    }
+    for (const entry of treeEntries.values()) {
+        const seen = new Set();
+        let current = entry;
+        while (current) {
+            if (seen.has(current.id))
+                throw corrupted(filePath, `parent cycle includes entry ${current.id}`);
+            seen.add(current.id);
+            current = current.parentId === null ? undefined : treeEntries.get(current.parentId);
+        }
+    }
+    for (const entry of treeEntries.values()) {
+        if (entry.type !== "compaction")
+            continue;
+        if (typeof entry.firstKeptEntryId !== "string" || !treeEntries.has(entry.firstKeptEntryId)) {
+            throw corrupted(filePath, `compaction ${entry.id} references missing first kept entry`);
+        }
+        let ancestorId = entry.parentId;
+        while (ancestorId !== null && ancestorId !== entry.firstKeptEntryId) {
+            ancestorId = treeEntries.get(ancestorId)?.parentId ?? null;
+        }
+        if (ancestorId === null) {
+            throw corrupted(filePath, `compaction ${entry.id} first kept entry ${entry.firstKeptEntryId} is not on its branch`);
+        }
+    }
+}
+function loadValidatedSessionFile(filePath) {
     if (!existsSync(filePath))
-        return [];
-    const entries = parseSessionFileEntries(readFileSync(filePath, "utf-8"));
-    if (entries.length === 0)
-        return entries;
+        return { entries: [], discardedCrashTail: false };
+    const nonEmptyLines = readFileSync(filePath, "utf-8")
+        .split("\n")
+        .map((line, index) => ({ text: line.trim(), number: index + 1 }))
+        .filter(({ text }) => text.length > 0);
+    if (nonEmptyLines.length === 0)
+        return { entries: [], discardedCrashTail: false };
+    const entries = [];
+    let discardedCrashTail = false;
+    for (const [index, line] of nonEmptyLines.entries()) {
+        try {
+            entries.push(parseSessionLine(line.text, filePath, line.number));
+        }
+        catch (error) {
+            if (index !== nonEmptyLines.length - 1 || index === 0)
+                throw error;
+            discardedCrashTail = true;
+        }
+    }
     if (!isSessionHeader(entries[0]))
-        return [];
-    return entries;
+        throw corrupted(filePath, "first non-empty line is not a valid header");
+    validateSessionTree(filePath, entries);
+    return { entries, discardedCrashTail };
 }
-/** True when the file exists and holds any non-whitespace content on disk. */
-function hasSessionFileContent(filePath) {
-    if (!existsSync(filePath))
-        return false;
-    return readFileSync(filePath, "utf-8").trim().length > 0;
+/**
+ * Load and validate a session file. Missing and whitespace-only files return
+ * no entries. A malformed final non-empty line is ignored as a crash tail;
+ * all other malformed JSON and invalid tree relationships throw.
+ */
+export function loadSessionFileEntries(filePath) {
+    return loadValidatedSessionFile(filePath).entries;
 }
 /**
  * Append-oriented session store over one v3 JSONL file.
@@ -79,13 +173,14 @@ function hasSessionFileContent(filePath) {
  * without a valid header gets its header materialized on the first append.
  */
 export class SessionStore {
-    constructor(sessionFile, cwd, fileEntries) {
+    constructor(sessionFile, cwd, fileEntries, rewriteBeforeAppend = false) {
         this.entries = [];
         this.byId = new Map();
         this.leafId = null;
-        this.sessionFile = resolve(sessionFile);
+        this.sessionFile = sessionFile === null ? null : resolve(sessionFile);
         this.header = fileEntries.length > 0 && isSessionHeader(fileEntries[0]) ? fileEntries[0] : null;
         this.headerOnDisk = this.header !== null;
+        this.rewriteBeforeAppend = rewriteBeforeAppend;
         this.sessionId = this.header?.id ?? randomUUID();
         this.cwd = cwd;
         for (const entry of fileEntries) {
@@ -110,14 +205,10 @@ export class SessionStore {
      * @param cwdOverride Working directory override; defaults to the header cwd.
      */
     static open(path, cwdOverride) {
-        const fileEntries = loadSessionFileEntries(path);
-        if (fileEntries.length === 0 && hasSessionFileContent(path)) {
-            throw new Error(`Session file is corrupted (no valid session header): ${path}. ` +
-                `Refusing to open to avoid overwriting existing content.`);
-        }
-        const header = fileEntries.find(isSessionHeader);
+        const loaded = loadValidatedSessionFile(path);
+        const header = loaded.entries.find(isSessionHeader);
         const cwd = cwdOverride ?? header?.cwd ?? process.cwd();
-        return new SessionStore(path, cwd, fileEntries);
+        return new SessionStore(path, cwd, loaded.entries, loaded.discardedCrashTail);
     }
     /** Create a new session file with a fresh header, replacing any existing file. */
     static create(path, cwd, options) {
@@ -131,8 +222,15 @@ export class SessionStore {
         atomicWritePrivateFile(path, `${JSON.stringify(header)}\n`);
         return new SessionStore(path, cwd, [header]);
     }
+    /** Create an ephemeral session that never writes a session file. */
+    static inMemory(cwd = process.cwd()) {
+        return new SessionStore(null, cwd, []);
+    }
     getSessionFile() {
-        return this.sessionFile;
+        return this.sessionFile ?? undefined;
+    }
+    isPersisted() {
+        return this.sessionFile !== null;
     }
     getCwd() {
         return this.cwd;
@@ -228,7 +326,9 @@ export class SessionStore {
         return entry.id;
     }
     persist(entry) {
-        if (!this.headerOnDisk) {
+        if (this.sessionFile === null)
+            return;
+        if (!this.headerOnDisk || this.rewriteBeforeAppend) {
             this.header ??= {
                 type: "session",
                 version: CURRENT_SESSION_VERSION,
@@ -240,6 +340,7 @@ export class SessionStore {
             mkdirSync(dirname(this.sessionFile), { recursive: true });
             atomicWritePrivateFile(this.sessionFile, `${lines.join("\n")}\n`);
             this.headerOnDisk = true;
+            this.rewriteBeforeAppend = false;
             return;
         }
         appendFileSync(this.sessionFile, `${JSON.stringify(entry)}\n`);

package/dist/harness/session-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mikan-owned session storage.\n *\n * Sessions are append-only trees stored as JSONL files: a `session` header\n * line followed by entries that carry `id`/`parentId` links. The format is\n * the v3 layout mikan has always written, and entry shapes are structurally\n * identical to pi-agent-core's `SessionTreeEntry`, so pi-agent-core's\n * context-building and compaction helpers operate on these entries directly.\n *\n * The store is synchronous by design: every mikan call site (session scope\n * resolution, chat-history sync, session view, admin portal) reads and\n * writes sessions inside synchronous flows.\n */\nimport { randomUUID } from \"crypto\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync } from \"fs\";\nimport { dirname, resolve } from \"path\";\nimport { buildSessionContext as buildContextFromEntries } from \"@earendil-works/pi-agent-core\";\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ImageContent, TextContent } from \"@earendil-works/pi-ai\";\nimport { atomicWritePrivateFile } from \"../utils/fs-atomic.js\";\nimport {\n  CURRENT_SESSION_VERSION,\n  type SessionContext,\n  type SessionEntry,\n  type SessionFileEntry,\n  type SessionHeader,\n} from \"./types.js\";\n\n/** Distributive omit so each entry variant keeps its own fields. */\ntype PendingSessionEntry = SessionEntry extends infer TEntry\n  ? TEntry extends SessionEntry\n    ? Omit<TEntry, \"id\" | \"parentId\" | \"timestamp\">\n    : never\n  : never;\n\n/** Generate a unique short entry id (8 hex chars, collision-checked). */\nfunction generateEntryId(byId: Map<string, SessionEntry>): string {\n  for (let i = 0; i < 100; i++) {\n    const id = randomUUID().slice(0, 8);\n    if (!byId.has(id)) return id;\n  }\n  return randomUUID();\n}\n\n/** Parse JSONL content tolerantly: malformed lines are skipped. */\nexport function parseSessionFileEntries(content: string): SessionFileEntry[] {\n  const entries: SessionFileEntry[] = [];\n  for (const line of content.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n    try {\n      const parsed: unknown = JSON.parse(trimmed);\n      if (\n        parsed &&\n        typeof parsed === \"object\" &&\n        typeof (parsed as { type?: unknown }).type === \"string\"\n      ) {\n        entries.push(parsed as SessionFileEntry);\n      }\n    } catch {\n      // Skip malformed lines\n    }\n  }\n  return entries;\n}\n\nfunction isSessionHeader(entry: SessionFileEntry): entry is SessionHeader {\n  return entry.type === \"session\" && typeof (entry as SessionHeader).id === \"string\";\n}\n\n/**\n * Load a session file. Returns no entries when the file is missing or its\n * first parseable line is not a valid session header (mirrors the tolerant\n * read behavior mikan has relied on). Throws only on I/O errors.\n */\nexport function loadSessionFileEntries(filePath: string): SessionFileEntry[] {\n  if (!existsSync(filePath)) return [];\n  const entries = parseSessionFileEntries(readFileSync(filePath, \"utf-8\"));\n  if (entries.length === 0) return entries;\n  if (!isSessionHeader(entries[0])) return [];\n  return entries;\n}\n\n/** True when the file exists and holds any non-whitespace content on disk. */\nfunction hasSessionFileContent(filePath: string): boolean {\n  if (!existsSync(filePath)) return false;\n  return readFileSync(filePath, \"utf-8\").trim().length > 0;\n}\n\n/**\n * Append-oriented session store over one v3 JSONL file.\n *\n * Reading is tolerant (missing files and malformed lines yield an empty\n * session); appends persist immediately. A session opened from a file\n * without a valid header gets its header materialized on the first append.\n */\nexport class SessionStore {\n  private readonly sessionFile: string;\n  private readonly cwd: string;\n  private readonly sessionId: string;\n  private header: SessionHeader | null;\n  private headerOnDisk: boolean;\n  private entries: SessionEntry[] = [];\n  private byId = new Map<string, SessionEntry>();\n  private leafId: string | null = null;\n\n  private constructor(sessionFile: string, cwd: string, fileEntries: SessionFileEntry[]) {\n    this.sessionFile = resolve(sessionFile);\n    this.header = fileEntries.length > 0 && isSessionHeader(fileEntries[0]) ? fileEntries[0] : null;\n    this.headerOnDisk = this.header !== null;\n    this.sessionId = this.header?.id ?? randomUUID();\n    this.cwd = cwd;\n    for (const entry of fileEntries) {\n      if (isSessionHeader(entry)) continue;\n      if (entry.type === \"leaf\") {\n        // Written by pi-agent-core JSONL sessions; mikan tracks the leaf implicitly.\n        this.leafId = entry.targetId;\n        continue;\n      }\n      this.entries.push(entry);\n      this.byId.set(entry.id, entry);\n      this.leafId = entry.id;\n    }\n  }\n\n  /**\n   * Open a session file. A missing or empty file starts an empty session\n   * whose header is written on the first append. A file that has content but\n   * no leading session header is treated as corrupted and throws, rather than\n   * being silently overwritten on the next append (which would erase the\n   * existing history). Callers on read paths already wrap this in try/catch.\n   * @param cwdOverride Working directory override; defaults to the header cwd.\n   */\n  static open(path: string, cwdOverride?: string): SessionStore {\n    const fileEntries = loadSessionFileEntries(path);\n    if (fileEntries.length === 0 && hasSessionFileContent(path)) {\n      throw new Error(\n        `Session file is corrupted (no valid session header): ${path}. ` +\n          `Refusing to open to avoid overwriting existing content.`,\n      );\n    }\n    const header = fileEntries.find(isSessionHeader);\n    const cwd = cwdOverride ?? header?.cwd ?? process.cwd();\n    return new SessionStore(path, cwd, fileEntries);\n  }\n\n  /** Create a new session file with a fresh header, replacing any existing file. */\n  static create(path: string, cwd: string, options?: { id?: string }): SessionStore {\n    const header: SessionHeader = {\n      type: \"session\",\n      version: CURRENT_SESSION_VERSION,\n      id: options?.id ?? randomUUID(),\n      timestamp: new Date().toISOString(),\n      cwd,\n    };\n    atomicWritePrivateFile(path, `${JSON.stringify(header)}\\n`);\n    return new SessionStore(path, cwd, [header]);\n  }\n\n  getSessionFile(): string {\n    return this.sessionFile;\n  }\n\n  getCwd(): string {\n    return this.cwd;\n  }\n\n  /** Session header as read from disk, or null when the file had none. */\n  getHeader(): SessionHeader | null {\n    return this.header;\n  }\n\n  /** Stable session id: the header id, or a generated id for fresh sessions. */\n  getSessionId(): string {\n    return this.sessionId;\n  }\n\n  getLeafId(): string | null {\n    return this.leafId;\n  }\n\n  getEntry(id: string): SessionEntry | undefined {\n    return this.byId.get(id);\n  }\n\n  /** All session entries (header excluded). Returns a shallow copy. */\n  getEntries(): SessionEntry[] {\n    return [...this.entries];\n  }\n\n  /** Latest user-assigned session name, if any. */\n  getSessionName(): string | undefined {\n    for (let i = this.entries.length - 1; i >= 0; i--) {\n      const entry = this.entries[i];\n      if (entry.type === \"session_info\") return entry.name?.trim() || undefined;\n    }\n    return undefined;\n  }\n\n  /**\n   * Walk from an entry to the root, returning entries in path order\n   * (root first). Defaults to the current leaf.\n   */\n  getBranch(fromId?: string): SessionEntry[] {\n    const path: SessionEntry[] = [];\n    let currentId = fromId ?? this.leafId;\n    while (currentId) {\n      const entry = this.byId.get(currentId);\n      if (!entry) break;\n      path.push(entry);\n      currentId = entry.parentId;\n    }\n    return path.toReversed();\n  }\n\n  /**\n   * Build the LLM context (messages, thinking level, model) from the current\n   * branch, resolving compaction and branch summaries along the path.\n   */\n  buildSessionContext(): SessionContext {\n    return buildContextFromEntries(this.getBranch());\n  }\n\n  /** Append a chat message as a child of the current leaf. Returns the entry id. */\n  appendMessage(message: AgentMessage): string {\n    return this.appendEntry({ type: \"message\", message });\n  }\n\n  /** Append an extension/application data entry (never sent to the LLM). */\n  appendCustomEntry(customType: string, data?: unknown): string {\n    return this.appendEntry({ type: \"custom\", customType, data });\n  }\n\n  /** Append a custom message entry that participates in LLM context. */\n  appendCustomMessageEntry(\n    customType: string,\n    content: string | (TextContent | ImageContent)[],\n    display: boolean,\n    details?: unknown,\n  ): string {\n    return this.appendEntry({ type: \"custom_message\", customType, content, display, details });\n  }\n\n  /** Record a user-visible session name. */\n  appendSessionInfo(name: string): string {\n    return this.appendEntry({ type: \"session_info\", name });\n  }\n\n  /** Persist a compaction summary produced for this session. */\n  appendCompaction(\n    summary: string,\n    firstKeptEntryId: string,\n    tokensBefore: number,\n    details?: unknown,\n    fromHook?: boolean,\n  ): string {\n    return this.appendEntry({\n      type: \"compaction\",\n      summary,\n      firstKeptEntryId,\n      tokensBefore,\n      ...(details !== undefined ? { details } : {}),\n      ...(fromHook !== undefined ? { fromHook } : {}),\n    });\n  }\n\n  private appendEntry(partial: PendingSessionEntry): string {\n    const entry = {\n      ...partial,\n      id: generateEntryId(this.byId),\n      parentId: this.leafId,\n      timestamp: new Date().toISOString(),\n    } as SessionEntry;\n    this.entries.push(entry);\n    this.byId.set(entry.id, entry);\n    this.leafId = entry.id;\n    this.persist(entry);\n    return entry.id;\n  }\n\n  private persist(entry: SessionEntry): void {\n    if (!this.headerOnDisk) {\n      this.header ??= {\n        type: \"session\",\n        version: CURRENT_SESSION_VERSION,\n        id: this.sessionId,\n        timestamp: new Date().toISOString(),\n        cwd: this.cwd,\n      };\n      const lines = [this.header, ...this.entries].map((line) => JSON.stringify(line));\n      mkdirSync(dirname(this.sessionFile), { recursive: true });\n      atomicWritePrivateFile(this.sessionFile, `${lines.join(\"\\n\")}\\n`);\n      this.headerOnDisk = true;\n      return;\n    }\n    appendFileSync(this.sessionFile, `${JSON.stringify(entry)}\\n`);\n  }\n}\n"]}
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/harness/session-store.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * mikan-owned session storage.\n *\n * Sessions are append-only trees stored as JSONL files: a `session` header\n * line followed by entries that carry `id`/`parentId` links. The format is\n * the v3 layout mikan has always written, and entry shapes are structurally\n * identical to pi-agent-core's `SessionTreeEntry`, so pi-agent-core's\n * context-building and compaction helpers operate on these entries directly.\n *\n * The store is synchronous by design: every mikan call site (session scope\n * resolution, chat-history sync, session view, admin portal) reads and\n * writes sessions inside synchronous flows.\n */\nimport { randomUUID } from \"crypto\";\nimport { appendFileSync, existsSync, mkdirSync, readFileSync } from \"fs\";\nimport { dirname, resolve } from \"path\";\nimport { buildSessionContext as buildContextFromEntries } from \"@earendil-works/pi-agent-core\";\nimport type { AgentMessage } from \"@earendil-works/pi-agent-core\";\nimport type { ImageContent, TextContent } from \"@earendil-works/pi-ai\";\nimport { atomicWritePrivateFile } from \"../utils/fs-atomic.js\";\nimport {\n  CURRENT_SESSION_VERSION,\n  type SessionContext,\n  type SessionEntry,\n  type SessionFileEntry,\n  type SessionHeader,\n} from \"./types.js\";\n\n/** Distributive omit so each entry variant keeps its own fields. */\ntype PendingSessionEntry = SessionEntry extends infer TEntry\n  ? TEntry extends SessionEntry\n    ? Omit<TEntry, \"id\" | \"parentId\" | \"timestamp\">\n    : never\n  : never;\n\n/** Generate a unique short entry id (8 hex chars, collision-checked). */\nfunction generateEntryId(byId: Map<string, SessionEntry>): string {\n  for (let i = 0; i < 100; i++) {\n    const id = randomUUID().slice(0, 8);\n    if (!byId.has(id)) return id;\n  }\n  return randomUUID();\n}\n\n/** Parse JSONL content tolerantly for compatibility with existing read-only callers. */\nexport function parseSessionFileEntries(content: string): SessionFileEntry[] {\n  const entries: SessionFileEntry[] = [];\n  for (const line of content.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (!trimmed) continue;\n    try {\n      const parsed: unknown = JSON.parse(trimmed);\n      if (\n        parsed &&\n        typeof parsed === \"object\" &&\n        typeof (parsed as { type?: unknown }).type === \"string\"\n      ) {\n        entries.push(parsed as SessionFileEntry);\n      }\n    } catch {\n      // This compatibility parser is intentionally tolerant. SessionStore.open is not.\n    }\n  }\n  return entries;\n}\n\nfunction isSessionHeader(entry: SessionFileEntry): entry is SessionHeader {\n  return entry.type === \"session\" && typeof (entry as SessionHeader).id === \"string\";\n}\n\ntype LoadedSessionFile = {\n  entries: SessionFileEntry[];\n  discardedCrashTail: boolean;\n};\n\nfunction corrupted(filePath: string, detail: string): Error {\n  return new Error(\n    `Session file is corrupted (${detail}): ${filePath}. Refusing to open for writing.`,\n  );\n}\n\nfunction parseSessionLine(line: string, filePath: string, lineNumber: number): SessionFileEntry {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(line);\n  } catch {\n    throw corrupted(filePath, `line ${lineNumber} is not valid JSON`);\n  }\n  if (\n    !parsed ||\n    typeof parsed !== \"object\" ||\n    typeof (parsed as { type?: unknown }).type !== \"string\"\n  ) {\n    throw corrupted(filePath, `line ${lineNumber} is not a session object`);\n  }\n  return parsed as SessionFileEntry;\n}\n\nfunction validateSessionTree(filePath: string, fileEntries: SessionFileEntry[]): void {\n  const records = fileEntries.slice(1);\n  const allIds = new Set<string>();\n  const treeEntries = new Map<string, SessionEntry>();\n\n  for (const [index, record] of records.entries()) {\n    const lineNumber = index + 2;\n    if (isSessionHeader(record)) throw corrupted(filePath, `line ${lineNumber} repeats the header`);\n    const entry = record as SessionEntry;\n    if (typeof entry.id !== \"string\" || !entry.id) {\n      throw corrupted(filePath, `line ${lineNumber} has no entry id`);\n    }\n    if (allIds.has(entry.id)) throw corrupted(filePath, `duplicate entry id ${entry.id}`);\n    allIds.add(entry.id);\n    if (entry.type !== \"leaf\") treeEntries.set(entry.id, entry);\n  }\n\n  for (const [index, record] of records.entries()) {\n    const lineNumber = index + 2;\n    const entry = record as SessionEntry;\n    if (entry.parentId !== null && typeof entry.parentId !== \"string\") {\n      throw corrupted(filePath, `line ${lineNumber} has an invalid parentId`);\n    }\n    if (entry.parentId === entry.id)\n      throw corrupted(filePath, `entry ${entry.id} is its own parent`);\n    if (entry.parentId !== null && !treeEntries.has(entry.parentId)) {\n      throw corrupted(filePath, `entry ${entry.id} references missing parent ${entry.parentId}`);\n    }\n    if (entry.type === \"leaf\") {\n      if (entry.targetId !== null && typeof entry.targetId !== \"string\") {\n        throw corrupted(filePath, `leaf ${entry.id} has an invalid target`);\n      }\n      if (entry.targetId !== null && !treeEntries.has(entry.targetId)) {\n        throw corrupted(filePath, `leaf ${entry.id} references missing target ${entry.targetId}`);\n      }\n    }\n  }\n\n  for (const entry of treeEntries.values()) {\n    const seen = new Set<string>();\n    let current: SessionEntry | undefined = entry;\n    while (current) {\n      if (seen.has(current.id))\n        throw corrupted(filePath, `parent cycle includes entry ${current.id}`);\n      seen.add(current.id);\n      current = current.parentId === null ? undefined : treeEntries.get(current.parentId);\n    }\n  }\n\n  for (const entry of treeEntries.values()) {\n    if (entry.type !== \"compaction\") continue;\n    if (typeof entry.firstKeptEntryId !== \"string\" || !treeEntries.has(entry.firstKeptEntryId)) {\n      throw corrupted(filePath, `compaction ${entry.id} references missing first kept entry`);\n    }\n    let ancestorId = entry.parentId;\n    while (ancestorId !== null && ancestorId !== entry.firstKeptEntryId) {\n      ancestorId = treeEntries.get(ancestorId)?.parentId ?? null;\n    }\n    if (ancestorId === null) {\n      throw corrupted(\n        filePath,\n        `compaction ${entry.id} first kept entry ${entry.firstKeptEntryId} is not on its branch`,\n      );\n    }\n  }\n}\n\nfunction loadValidatedSessionFile(filePath: string): LoadedSessionFile {\n  if (!existsSync(filePath)) return { entries: [], discardedCrashTail: false };\n  const nonEmptyLines = readFileSync(filePath, \"utf-8\")\n    .split(\"\\n\")\n    .map((line, index) => ({ text: line.trim(), number: index + 1 }))\n    .filter(({ text }) => text.length > 0);\n  if (nonEmptyLines.length === 0) return { entries: [], discardedCrashTail: false };\n\n  const entries: SessionFileEntry[] = [];\n  let discardedCrashTail = false;\n  for (const [index, line] of nonEmptyLines.entries()) {\n    try {\n      entries.push(parseSessionLine(line.text, filePath, line.number));\n    } catch (error) {\n      if (index !== nonEmptyLines.length - 1 || index === 0) throw error;\n      discardedCrashTail = true;\n    }\n  }\n  if (!isSessionHeader(entries[0]))\n    throw corrupted(filePath, \"first non-empty line is not a valid header\");\n  validateSessionTree(filePath, entries);\n  return { entries, discardedCrashTail };\n}\n\n/**\n * Load and validate a session file. Missing and whitespace-only files return\n * no entries. A malformed final non-empty line is ignored as a crash tail;\n * all other malformed JSON and invalid tree relationships throw.\n */\nexport function loadSessionFileEntries(filePath: string): SessionFileEntry[] {\n  return loadValidatedSessionFile(filePath).entries;\n}\n\n/**\n * Append-oriented session store over one v3 JSONL file.\n *\n * Reading is tolerant (missing files and malformed lines yield an empty\n * session); appends persist immediately. A session opened from a file\n * without a valid header gets its header materialized on the first append.\n */\nexport class SessionStore {\n  private readonly sessionFile: string | null;\n  private readonly cwd: string;\n  private readonly sessionId: string;\n  private header: SessionHeader | null;\n  private headerOnDisk: boolean;\n  private rewriteBeforeAppend: boolean;\n  private entries: SessionEntry[] = [];\n  private byId = new Map<string, SessionEntry>();\n  private leafId: string | null = null;\n\n  private constructor(\n    sessionFile: string | null,\n    cwd: string,\n    fileEntries: SessionFileEntry[],\n    rewriteBeforeAppend = false,\n  ) {\n    this.sessionFile = sessionFile === null ? null : resolve(sessionFile);\n    this.header = fileEntries.length > 0 && isSessionHeader(fileEntries[0]) ? fileEntries[0] : null;\n    this.headerOnDisk = this.header !== null;\n    this.rewriteBeforeAppend = rewriteBeforeAppend;\n    this.sessionId = this.header?.id ?? randomUUID();\n    this.cwd = cwd;\n    for (const entry of fileEntries) {\n      if (isSessionHeader(entry)) continue;\n      if (entry.type === \"leaf\") {\n        // Written by pi-agent-core JSONL sessions; mikan tracks the leaf implicitly.\n        this.leafId = entry.targetId;\n        continue;\n      }\n      this.entries.push(entry);\n      this.byId.set(entry.id, entry);\n      this.leafId = entry.id;\n    }\n  }\n\n  /**\n   * Open a session file. A missing or empty file starts an empty session\n   * whose header is written on the first append. A file that has content but\n   * no leading session header is treated as corrupted and throws, rather than\n   * being silently overwritten on the next append (which would erase the\n   * existing history). Callers on read paths already wrap this in try/catch.\n   * @param cwdOverride Working directory override; defaults to the header cwd.\n   */\n  static open(path: string, cwdOverride?: string): SessionStore {\n    const loaded = loadValidatedSessionFile(path);\n    const header = loaded.entries.find(isSessionHeader);\n    const cwd = cwdOverride ?? header?.cwd ?? process.cwd();\n    return new SessionStore(path, cwd, loaded.entries, loaded.discardedCrashTail);\n  }\n\n  /** Create a new session file with a fresh header, replacing any existing file. */\n  static create(path: string, cwd: string, options?: { id?: string }): SessionStore {\n    const header: SessionHeader = {\n      type: \"session\",\n      version: CURRENT_SESSION_VERSION,\n      id: options?.id ?? randomUUID(),\n      timestamp: new Date().toISOString(),\n      cwd,\n    };\n    atomicWritePrivateFile(path, `${JSON.stringify(header)}\\n`);\n    return new SessionStore(path, cwd, [header]);\n  }\n\n  /** Create an ephemeral session that never writes a session file. */\n  static inMemory(cwd = process.cwd()): SessionStore {\n    return new SessionStore(null, cwd, []);\n  }\n\n  getSessionFile(): string | undefined {\n    return this.sessionFile ?? undefined;\n  }\n\n  isPersisted(): boolean {\n    return this.sessionFile !== null;\n  }\n\n  getCwd(): string {\n    return this.cwd;\n  }\n\n  /** Session header as read from disk, or null when the file had none. */\n  getHeader(): SessionHeader | null {\n    return this.header;\n  }\n\n  /** Stable session id: the header id, or a generated id for fresh sessions. */\n  getSessionId(): string {\n    return this.sessionId;\n  }\n\n  getLeafId(): string | null {\n    return this.leafId;\n  }\n\n  getEntry(id: string): SessionEntry | undefined {\n    return this.byId.get(id);\n  }\n\n  /** All session entries (header excluded). Returns a shallow copy. */\n  getEntries(): SessionEntry[] {\n    return [...this.entries];\n  }\n\n  /** Latest user-assigned session name, if any. */\n  getSessionName(): string | undefined {\n    for (let i = this.entries.length - 1; i >= 0; i--) {\n      const entry = this.entries[i];\n      if (entry.type === \"session_info\") return entry.name?.trim() || undefined;\n    }\n    return undefined;\n  }\n\n  /**\n   * Walk from an entry to the root, returning entries in path order\n   * (root first). Defaults to the current leaf.\n   */\n  getBranch(fromId?: string): SessionEntry[] {\n    const path: SessionEntry[] = [];\n    let currentId = fromId ?? this.leafId;\n    while (currentId) {\n      const entry = this.byId.get(currentId);\n      if (!entry) break;\n      path.push(entry);\n      currentId = entry.parentId;\n    }\n    return path.toReversed();\n  }\n\n  /**\n   * Build the LLM context (messages, thinking level, model) from the current\n   * branch, resolving compaction and branch summaries along the path.\n   */\n  buildSessionContext(): SessionContext {\n    return buildContextFromEntries(this.getBranch());\n  }\n\n  /** Append a chat message as a child of the current leaf. Returns the entry id. */\n  appendMessage(message: AgentMessage): string {\n    return this.appendEntry({ type: \"message\", message });\n  }\n\n  /** Append an extension/application data entry (never sent to the LLM). */\n  appendCustomEntry(customType: string, data?: unknown): string {\n    return this.appendEntry({ type: \"custom\", customType, data });\n  }\n\n  /** Append a custom message entry that participates in LLM context. */\n  appendCustomMessageEntry(\n    customType: string,\n    content: string | (TextContent | ImageContent)[],\n    display: boolean,\n    details?: unknown,\n  ): string {\n    return this.appendEntry({ type: \"custom_message\", customType, content, display, details });\n  }\n\n  /** Record a user-visible session name. */\n  appendSessionInfo(name: string): string {\n    return this.appendEntry({ type: \"session_info\", name });\n  }\n\n  /** Persist a compaction summary produced for this session. */\n  appendCompaction(\n    summary: string,\n    firstKeptEntryId: string,\n    tokensBefore: number,\n    details?: unknown,\n    fromHook?: boolean,\n  ): string {\n    return this.appendEntry({\n      type: \"compaction\",\n      summary,\n      firstKeptEntryId,\n      tokensBefore,\n      ...(details !== undefined ? { details } : {}),\n      ...(fromHook !== undefined ? { fromHook } : {}),\n    });\n  }\n\n  private appendEntry(partial: PendingSessionEntry): string {\n    const entry = {\n      ...partial,\n      id: generateEntryId(this.byId),\n      parentId: this.leafId,\n      timestamp: new Date().toISOString(),\n    } as SessionEntry;\n    this.entries.push(entry);\n    this.byId.set(entry.id, entry);\n    this.leafId = entry.id;\n    this.persist(entry);\n    return entry.id;\n  }\n\n  private persist(entry: SessionEntry): void {\n    if (this.sessionFile === null) return;\n    if (!this.headerOnDisk || this.rewriteBeforeAppend) {\n      this.header ??= {\n        type: \"session\",\n        version: CURRENT_SESSION_VERSION,\n        id: this.sessionId,\n        timestamp: new Date().toISOString(),\n        cwd: this.cwd,\n      };\n      const lines = [this.header, ...this.entries].map((line) => JSON.stringify(line));\n      mkdirSync(dirname(this.sessionFile), { recursive: true });\n      atomicWritePrivateFile(this.sessionFile, `${lines.join(\"\\n\")}\\n`);\n      this.headerOnDisk = true;\n      this.rewriteBeforeAppend = false;\n      return;\n    }\n    appendFileSync(this.sessionFile, `${JSON.stringify(entry)}\\n`);\n  }\n}\n"]}

package/dist/harness/settings.d.ts

@@ -1,10 +1,7 @@
 import type { CompactionSettings } from "@earendil-works/pi-agent-core";
+import type { BudgetSettings, HarnessSettings, RetrySettings } from "./types.js";
 export type { CompactionSettings };
-export interface RetrySettings {
-    enabled: boolean;
-    maxRetries: number;
-    baseDelayMs: number;
-}
+export type { BudgetSettings, HarnessSettings, RetrySettings } from "./types.js";
 export declare const DEFAULT_RETRY_SETTINGS: RetrySettings;
 /**
  * Per-run resource ceilings — the harness's external circuit breakers.
@@ -17,16 +14,6 @@ export declare const DEFAULT_RETRY_SETTINGS: RetrySettings;
  * so they default to uncapped; autonomous runs (scheduled events, triggers)
  * pass {@link DEFAULT_EVENT_BUDGET}, where nobody is watching the loop.
  */
-export interface BudgetSettings {
-    /** Max cumulative tokens processed this run (input + output + cache read/write). */
-    maxTokens?: number;
-    /** Max cumulative provider cost (USD) this run. Requires a populated model cost table. */
-    maxCostUsd?: number;
-    /** Max wall-clock duration for the run, in milliseconds. */
-    maxDurationMs?: number;
-    /** Max number of LLM calls (assistant turns) this run. */
-    maxLlmCalls?: number;
-}
 /** Interactive runs are human-gated per turn — no automatic ceiling by default. */
 export declare const DEFAULT_BUDGET_SETTINGS: BudgetSettings;
 /**
@@ -34,11 +21,6 @@ export declare const DEFAULT_BUDGET_SETTINGS: BudgetSettings;
  * the loop. Deliberately generous — it is a stop-loss, not a target.
  */
 export declare const DEFAULT_EVENT_BUDGET: BudgetSettings;
-export interface HarnessSettings {
-    compaction: CompactionSettings;
-    retry: RetrySettings;
-    budget: BudgetSettings;
-}
 export declare function resolveHarnessSettings(overrides?: {
     compaction?: Partial<CompactionSettings>;
     retry?: Partial<RetrySettings>;

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

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/harness/settings.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAExE,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,EAAE,cAAmB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAIlC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAClC,GAAG,eAAe,CAMlB"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/harness/settings.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjF,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEjF,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,mFAAmF;AACnF,eAAO,MAAM,uBAAuB,EAAE,cAAmB,CAAC;AAE1D;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,cAIlC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;CAClC,GAAG,eAAe,CAMlB"}

package/dist/harness/settings.js

@@ -8,6 +8,17 @@ export const DEFAULT_RETRY_SETTINGS = {
     maxRetries: 3,
     baseDelayMs: 2000,
 };
+/**
+ * Per-run resource ceilings — the harness's external circuit breakers.
+ *
+ * An LLM cannot reliably decide on its own when to stop (the halting problem),
+ * so a runaway run has to be stopped from the outside. When any populated cap
+ * is exceeded, the run is aborted and a `budget_exceeded` event is emitted.
+ * Every field is a cap on a single `prompt()` call; an undefined field means
+ * "no cap on that axis". Interactive runs are gated turn-by-turn by a human,
+ * so they default to uncapped; autonomous runs (scheduled events, triggers)
+ * pass {@link DEFAULT_EVENT_BUDGET}, where nobody is watching the loop.
+ */
 /** Interactive runs are human-gated per turn — no automatic ceiling by default. */
 export const DEFAULT_BUDGET_SETTINGS = {};
 /**

package/dist/harness/settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/harness/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAW5E,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;CAClB,CAAC;AAwBF,mFAAmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAAmB,EAAE,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAC7B,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,CAAC;CACd,CAAC;AAQF,MAAM,UAAU,sBAAsB,CAAC,SAItC;IACC,OAAO;QACL,UAAU,EAAE,EAAE,GAAG,2BAA2B,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE;QACxE,KAAK,EAAE,EAAE,GAAG,sBAAsB,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE;QACzD,MAAM,EAAE,EAAE,GAAG,uBAAuB,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE;KAC7D,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Runtime settings for the mikan harness. mikan runs headless, so these are\n * plain values with defaults matching the behavior mikan shipped with.\n */\nimport { DEFAULT_COMPACTION_SETTINGS } from \"@earendil-works/pi-agent-core\";\nimport type { CompactionSettings } from \"@earendil-works/pi-agent-core\";\n\nexport type { CompactionSettings };\n\nexport interface RetrySettings {\n  enabled: boolean;\n  maxRetries: number;\n  baseDelayMs: number;\n}\n\nexport const DEFAULT_RETRY_SETTINGS: RetrySettings = {\n  enabled: true,\n  maxRetries: 3,\n  baseDelayMs: 2000,\n};\n\n/**\n * Per-run resource ceilings — the harness's external circuit breakers.\n *\n * An LLM cannot reliably decide on its own when to stop (the halting problem),\n * so a runaway run has to be stopped from the outside. When any populated cap\n * is exceeded, the run is aborted and a `budget_exceeded` event is emitted.\n * Every field is a cap on a single `prompt()` call; an undefined field means\n * \"no cap on that axis\". Interactive runs are gated turn-by-turn by a human,\n * so they default to uncapped; autonomous runs (scheduled events, triggers)\n * pass {@link DEFAULT_EVENT_BUDGET}, where nobody is watching the loop.\n */\nexport interface BudgetSettings {\n  /** Max cumulative tokens processed this run (input + output + cache read/write). */\n  maxTokens?: number;\n  /** Max cumulative provider cost (USD) this run. Requires a populated model cost table. */\n  maxCostUsd?: number;\n  /** Max wall-clock duration for the run, in milliseconds. */\n  maxDurationMs?: number;\n  /** Max number of LLM calls (assistant turns) this run. */\n  maxLlmCalls?: number;\n}\n\n/** Interactive runs are human-gated per turn — no automatic ceiling by default. */\nexport const DEFAULT_BUDGET_SETTINGS: BudgetSettings = {};\n\n/**\n * Ceiling for autonomous (event / trigger) runs, where no human is watching\n * the loop. Deliberately generous — it is a stop-loss, not a target.\n */\nexport const DEFAULT_EVENT_BUDGET: BudgetSettings = {\n  maxDurationMs: 10 * 60 * 1000,\n  maxLlmCalls: 50,\n  maxCostUsd: 2,\n};\n\nexport interface HarnessSettings {\n  compaction: CompactionSettings;\n  retry: RetrySettings;\n  budget: BudgetSettings;\n}\n\nexport function resolveHarnessSettings(overrides?: {\n  compaction?: Partial<CompactionSettings>;\n  retry?: Partial<RetrySettings>;\n  budget?: Partial<BudgetSettings>;\n}): HarnessSettings {\n  return {\n    compaction: { ...DEFAULT_COMPACTION_SETTINGS, ...overrides?.compaction },\n    retry: { ...DEFAULT_RETRY_SETTINGS, ...overrides?.retry },\n    budget: { ...DEFAULT_BUDGET_SETTINGS, ...overrides?.budget },\n  };\n}\n"]}
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/harness/settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAO5E,MAAM,CAAC,MAAM,sBAAsB,GAAkB;IACnD,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,mFAAmF;AACnF,MAAM,CAAC,MAAM,uBAAuB,GAAmB,EAAE,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAmB;IAClD,aAAa,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAC7B,WAAW,EAAE,EAAE;IACf,UAAU,EAAE,CAAC;CACd,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,SAItC;IACC,OAAO;QACL,UAAU,EAAE,EAAE,GAAG,2BAA2B,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE;QACxE,KAAK,EAAE,EAAE,GAAG,sBAAsB,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE;QACzD,MAAM,EAAE,EAAE,GAAG,uBAAuB,EAAE,GAAG,SAAS,EAAE,MAAM,EAAE;KAC7D,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Runtime settings for the mikan harness. mikan runs headless, so these are\n * plain values with defaults matching the behavior mikan shipped with.\n */\nimport { DEFAULT_COMPACTION_SETTINGS } from \"@earendil-works/pi-agent-core\";\nimport type { CompactionSettings } from \"@earendil-works/pi-agent-core\";\nimport type { BudgetSettings, HarnessSettings, RetrySettings } from \"./types.js\";\n\nexport type { CompactionSettings };\nexport type { BudgetSettings, HarnessSettings, RetrySettings } from \"./types.js\";\n\nexport const DEFAULT_RETRY_SETTINGS: RetrySettings = {\n  enabled: true,\n  maxRetries: 3,\n  baseDelayMs: 2000,\n};\n\n/**\n * Per-run resource ceilings — the harness's external circuit breakers.\n *\n * An LLM cannot reliably decide on its own when to stop (the halting problem),\n * so a runaway run has to be stopped from the outside. When any populated cap\n * is exceeded, the run is aborted and a `budget_exceeded` event is emitted.\n * Every field is a cap on a single `prompt()` call; an undefined field means\n * \"no cap on that axis\". Interactive runs are gated turn-by-turn by a human,\n * so they default to uncapped; autonomous runs (scheduled events, triggers)\n * pass {@link DEFAULT_EVENT_BUDGET}, where nobody is watching the loop.\n */\n/** Interactive runs are human-gated per turn — no automatic ceiling by default. */\nexport const DEFAULT_BUDGET_SETTINGS: BudgetSettings = {};\n\n/**\n * Ceiling for autonomous (event / trigger) runs, where no human is watching\n * the loop. Deliberately generous — it is a stop-loss, not a target.\n */\nexport const DEFAULT_EVENT_BUDGET: BudgetSettings = {\n  maxDurationMs: 10 * 60 * 1000,\n  maxLlmCalls: 50,\n  maxCostUsd: 2,\n};\n\nexport function resolveHarnessSettings(overrides?: {\n  compaction?: Partial<CompactionSettings>;\n  retry?: Partial<RetrySettings>;\n  budget?: Partial<BudgetSettings>;\n}): HarnessSettings {\n  return {\n    compaction: { ...DEFAULT_COMPACTION_SETTINGS, ...overrides?.compaction },\n    retry: { ...DEFAULT_RETRY_SETTINGS, ...overrides?.retry },\n    budget: { ...DEFAULT_BUDGET_SETTINGS, ...overrides?.budget },\n  };\n}\n"]}

package/dist/harness/skills.d.ts

@@ -1,31 +1,5 @@
-/** 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 {
-    skills: MikanSkill[];
-    diagnostics: SkillDiagnostic[];
-}
+import type { LoadSkillsResult, MikanSkill } from "./types.js";
+export type { LoadSkillsResult, MikanSkill, SkillDiagnostic } from "./types.js";
 interface Frontmatter {
     values: Record<string, string>;
     body: string;
@@ -50,5 +24,4 @@ export declare function loadSkillsFromDir(options: {
  * 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":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAC;AAEhF,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAKhF,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"}

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":["/**\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\";\nimport type { LoadSkillsResult, MikanSkill, SkillDiagnostic } from \"./types.js\";\n\nexport type { LoadSkillsResult, MikanSkill, SkillDiagnostic } from \"./types.js\";\n\nconst MAX_NAME_LENGTH = 64;\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(\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"]}

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