@geminixiang/mikan 1.0.0-beta.2 → 1.0.0-beta.21

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: 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 | null;\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 | null, cwd: string, fileEntries: SessionFileEntry[]) {\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.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  /** 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) {\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"]}

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

@@ -0,0 +1,34 @@
+import type { AgentTool, ThinkingLevel } from "@earendil-works/pi-agent-core";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import { type TSchema } from "@sinclair/typebox";
+import type { MikanModels } from "./models.js";
+import type { SubagentRunOutput, SubagentRunRequest, SubagentRunResult } from "./types.js";
+interface RunSubagentOptions<TOutputSchema extends TSchema | undefined = undefined> {
+    request: SubagentRunRequest<TOutputSchema>;
+    defaultModel: Model<Api>;
+    thinkingLevel: ThinkingLevel;
+    models: MikanModels;
+    workspaceDir: string;
+    availableTools: AgentTool[];
+    /**
+     * The one seam through which a run's spend reaches its initiator (e.g. the
+     * parent session's budget). Called exactly once per run with the final
+     * totals — on every terminal path, including never-reject failures —
+     * before the result is returned. Errors thrown here are logged and
+     * swallowed to preserve the never-reject contract.
+     */
+    onUsage?: (usage: {
+        tokens: number;
+        costUsd: number;
+    }) => void | Promise<void>;
+}
+/**
+ * Execute one non-recursive, fresh subagent run. Never rejects: every
+ * failure — including request validation — is a result with a terminal
+ * status, so batch callers (`tasks` / `dag`) can never orphan in-flight
+ * sibling runs on one bad request. The run's spend is reported through
+ * `onUsage` before the result is returned.
+ */
+export declare function runSubagent<TOutputSchema extends TSchema | undefined = undefined>(options: RunSubagentOptions<TOutputSchema>): Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>>;
+export {};
+//# sourceMappingURL=subagent-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-runner.d.ts","sourceRoot":"","sources":["../../src/harness/subagent-runner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,SAAS,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC5F,OAAO,KAAK,EAAE,GAAG,EAAoB,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,KAAK,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAgHpB,UAAU,kBAAkB,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS;IAChF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChF;AAiFD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,aAAa,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACrF,OAAO,EAAE,kBAAkB,CAAC,aAAa,CAAC,GACzC,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,aAAa,CAAC,CAAC,CAAC,CAQ9D"}

package/dist/harness/subagent-runner.js

@@ -0,0 +1,339 @@
+import { randomUUID } from "node:crypto";
+import { AsyncLocalStorage } from "node:async_hooks";
+import { Kind, Type } from "@sinclair/typebox";
+import { Value } from "@sinclair/typebox/value";
+import * as log from "../log.js";
+import { MikanAgentSession } from "./runner.js";
+import { SessionStore } from "./session-store.js";
+const subagentRunDepth = new AsyncLocalStorage();
+const DEFAULT_SYSTEM_PROMPT = "You are a focused subagent. Complete only the assigned task and return the result directly.";
+const DEFAULT_SUBAGENT_BUDGET = {
+    maxTurns: 8,
+    maxCostUsd: 0.5,
+    maxDurationMs: 2 * 60 * 1000,
+};
+const SCHEMA_STRUCTURAL_KEYS = new Set([
+    "type",
+    "properties",
+    "required",
+    "items",
+    "enum",
+    "const",
+    "anyOf",
+    "oneOf",
+    "allOf",
+]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function schemaOptions(node) {
+    const options = {};
+    for (const [key, value] of Object.entries(node)) {
+        if (!SCHEMA_STRUCTURAL_KEYS.has(key))
+            options[key] = value;
+    }
+    if (isRecord(options.additionalProperties)) {
+        options.additionalProperties = hydrateSchema(options.additionalProperties);
+    }
+    return options;
+}
+/**
+ * outputSchema arrives over the subagent tool as plain JSON (tool-call
+ * arguments never carry TypeBox's Kind symbol), but Value.Check dispatches
+ * purely on schema[Kind] and throws ValueCheckUnknownTypeError for anything
+ * without it. Hydrate plain JSON Schema into real TypeBox schema nodes so
+ * validation runs instead of throwing; schemas built with TypeBox already
+ * carry Kind and pass through untouched.
+ *
+ * Unsupported keywords ($ref, not, patternProperties, if/then/else) degrade to
+ * a permissive Unknown — fail-open by design: outputSchema is advisory output
+ * validation, not a security boundary.
+ */
+function hydrateSchema(schema) {
+    if (isRecord(schema) && Kind in schema)
+        return schema;
+    if (!isRecord(schema))
+        return Type.Unknown();
+    if (Array.isArray(schema.enum)) {
+        const literals = schema.enum.filter((value) => typeof value === "string" || typeof value === "number" || typeof value === "boolean");
+        return literals.length > 0
+            ? Type.Union(literals.map((value) => Type.Literal(value)))
+            : Type.Unknown();
+    }
+    if ("const" in schema) {
+        const value = schema.const;
+        return typeof value === "string" || typeof value === "number" || typeof value === "boolean"
+            ? Type.Literal(value)
+            : Type.Unknown();
+    }
+    if (Array.isArray(schema.anyOf))
+        return Type.Union(schema.anyOf.map(hydrateSchema));
+    if (Array.isArray(schema.oneOf))
+        return Type.Union(schema.oneOf.map(hydrateSchema));
+    if (Array.isArray(schema.allOf))
+        return Type.Intersect(schema.allOf.map(hydrateSchema));
+    const type = Array.isArray(schema.type)
+        ? schema.type
+        : (schema.type ?? (schema.properties ? "object" : schema.items ? "array" : undefined));
+    if (Array.isArray(type)) {
+        return Type.Union(type.map((variant) => hydrateSchema({ ...schema, type: variant })));
+    }
+    const options = schemaOptions(schema);
+    switch (type) {
+        case "object": {
+            const properties = isRecord(schema.properties) ? schema.properties : {};
+            const required = new Set(Array.isArray(schema.required) ? schema.required : []);
+            const props = {};
+            for (const [key, value] of Object.entries(properties)) {
+                const hydrated = hydrateSchema(value);
+                props[key] = required.has(key) ? hydrated : Type.Optional(hydrated);
+            }
+            return Type.Object(props, options);
+        }
+        case "array":
+            return Type.Array(schema.items !== undefined ? hydrateSchema(schema.items) : Type.Unknown(), options);
+        case "string":
+            return Type.String(options);
+        case "number":
+            return Type.Number(options);
+        case "integer":
+            return Type.Integer(options);
+        case "boolean":
+            return Type.Boolean(options);
+        case "null":
+            return Type.Null(options);
+        default:
+            return Type.Unknown(options);
+    }
+}
+function resolveBudget(budget) {
+    const resolved = { ...DEFAULT_SUBAGENT_BUDGET, ...budget };
+    const positiveIntegerFields = [
+        ["maxTurns", resolved.maxTurns],
+        ["maxTokens", resolved.maxTokens],
+        ["maxDurationMs", resolved.maxDurationMs],
+    ];
+    for (const [name, value] of positiveIntegerFields) {
+        if (value !== undefined && (!Number.isInteger(value) || value <= 0)) {
+            throw new Error(`api.subagent.run budget.${name} must be a positive integer`);
+        }
+    }
+    if (!Number.isFinite(resolved.maxCostUsd) || resolved.maxCostUsd < 0) {
+        throw new Error("api.subagent.run budget.maxCostUsd must be a non-negative number");
+    }
+    return resolved;
+}
+function selectTools(requested, available) {
+    if (!requested || requested.length === 0)
+        return [];
+    const byName = new Map();
+    for (const tool of available) {
+        if (!byName.has(tool.name))
+            byName.set(tool.name, tool);
+    }
+    const selected = [];
+    for (const name of new Set(requested)) {
+        const tool = byName.get(name);
+        if (!tool)
+            throw new Error(`Unknown or unavailable subagent tool: ${name}`);
+        selected.push(tool);
+    }
+    return selected;
+}
+function formatTask(task, input) {
+    const trimmed = task.trim();
+    if (!trimmed)
+        throw new Error("api.subagent.run requires a non-empty task");
+    if (input === undefined)
+        return trimmed;
+    let serialized;
+    try {
+        serialized = JSON.stringify(input, null, 2);
+    }
+    catch (err) {
+        throw new Error(`api.subagent.run input must be JSON-serializable: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    if (serialized === undefined) {
+        throw new Error("api.subagent.run input must be JSON-serializable");
+    }
+    return `${trimmed}\n\nInput:\n${serialized}`;
+}
+function buildSystemPrompt(base, outputSchema) {
+    const prompt = base?.trim() || DEFAULT_SYSTEM_PROMPT;
+    if (!outputSchema)
+        return prompt;
+    return [
+        prompt,
+        "",
+        "Return only one JSON value matching this JSON Schema. Do not use Markdown or code fences.",
+        JSON.stringify(outputSchema),
+    ].join("\n");
+}
+function finalAssistant(messages) {
+    for (let index = messages.length - 1; index >= 0; index--) {
+        const message = messages[index];
+        if (message.role === "assistant")
+            return message;
+    }
+    return undefined;
+}
+function assistantText(message) {
+    if (!message)
+        return "";
+    return message.content
+        .filter((part) => part.type === "text")
+        .map((part) => part.text)
+        .join("");
+}
+/**
+ * Execute one non-recursive, fresh subagent run. Never rejects: every
+ * failure — including request validation — is a result with a terminal
+ * status, so batch callers (`tasks` / `dag`) can never orphan in-flight
+ * sibling runs on one bad request. The run's spend is reported through
+ * `onUsage` before the result is returned.
+ */
+export async function runSubagent(options) {
+    const result = await executeSubagentRun(options);
+    try {
+        await options.onUsage?.({ tokens: result.tokens, costUsd: result.costUsd });
+    }
+    catch (err) {
+        log.logWarning("Subagent onUsage listener failed", String(err));
+    }
+    return result;
+}
+async function executeSubagentRun(options) {
+    const { request } = options;
+    const runId = randomUUID();
+    const startedAt = Date.now();
+    let modelSpec = request.model ?? {
+        provider: options.defaultModel.provider,
+        id: options.defaultModel.id,
+    };
+    let sessionRef;
+    let terminalSignal;
+    let timeout;
+    const abort = (reason) => {
+        if (terminalSignal)
+            return;
+        terminalSignal = reason;
+        sessionRef?.abort();
+    };
+    const onAbort = () => abort("cancelled");
+    try {
+        if ((subagentRunDepth.getStore() ?? 0) >= 1) {
+            throw new Error("Nested api.subagent.run calls are not allowed");
+        }
+        const model = request.model
+            ? options.models.resolve(request.model.provider, request.model.id)
+            : options.defaultModel;
+        modelSpec = { provider: model.provider, id: model.id };
+        const tools = selectTools(request.tools, options.availableTools);
+        const task = formatTask(request.task, request.input);
+        const budget = resolveBudget(request.budget);
+        const session = new MikanAgentSession({
+            systemPrompt: buildSystemPrompt(request.systemPrompt, request.outputSchema),
+            model,
+            thinkingLevel: options.thinkingLevel,
+            tools,
+            models: options.models,
+            sessionStore: SessionStore.inMemory(options.workspaceDir),
+            settings: { compaction: { enabled: false } },
+        });
+        sessionRef = session;
+        request.signal?.addEventListener("abort", onAbort, { once: true });
+        if (request.signal?.aborted)
+            abort("cancelled");
+        timeout = setTimeout(() => abort("timeout"), budget.maxDurationMs);
+        timeout.unref();
+        if (!terminalSignal) {
+            await subagentRunDepth.run(1, () => session.prompt(task, {
+                budget: {
+                    maxLlmCalls: budget.maxTurns,
+                    maxTokens: budget.maxTokens,
+                    maxCostUsd: budget.maxCostUsd,
+                    maxDurationMs: budget.maxDurationMs,
+                },
+            }));
+        }
+        const stats = session.getLastRunStats();
+        const assistant = finalAssistant(session.messages);
+        const text = assistantText(assistant);
+        const base = {
+            runId,
+            model: modelSpec,
+            turns: stats.llmCalls,
+            tokens: stats.tokens,
+            costUsd: stats.costUsd,
+            durationMs: Date.now() - startedAt,
+            ...(text ? { text } : {}),
+        };
+        if (terminalSignal)
+            return { ...base, status: terminalSignal };
+        if (stats.budgetExceededReason) {
+            return {
+                ...base,
+                status: "budget_exceeded",
+                error: stats.budgetExceededReason,
+            };
+        }
+        if (assistant?.stopReason === "error") {
+            return {
+                ...base,
+                status: "failed",
+                error: assistant.errorMessage || "Subagent failed",
+            };
+        }
+        if (!assistant) {
+            return { ...base, status: "failed", error: "Subagent produced no assistant response" };
+        }
+        if (request.outputSchema) {
+            let parsed;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                return { ...base, status: "invalid_output", error: "Subagent output is not valid JSON" };
+            }
+            if (!Value.Check(hydrateSchema(request.outputSchema), parsed)) {
+                return {
+                    ...base,
+                    status: "invalid_output",
+                    error: "Subagent output does not match the requested schema",
+                };
+            }
+            return {
+                ...base,
+                status: "completed",
+                output: parsed,
+            };
+        }
+        if (!text) {
+            return { ...base, status: "failed", error: "Subagent produced no text output" };
+        }
+        return {
+            ...base,
+            status: "completed",
+            output: text,
+        };
+    }
+    catch (err) {
+        const stats = sessionRef?.getLastRunStats();
+        return {
+            runId,
+            status: terminalSignal ?? "failed",
+            model: modelSpec,
+            turns: stats?.llmCalls ?? 0,
+            tokens: stats?.tokens ?? 0,
+            costUsd: stats?.costUsd ?? 0,
+            durationMs: Date.now() - startedAt,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+        request.signal?.removeEventListener("abort", onAbort);
+    }
+}
+//# sourceMappingURL=subagent-runner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-runner.js","sourceRoot":"","sources":["../../src/harness/subagent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { AgentMessage, AgentTool, ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport type { Api, AssistantMessage, Model } from \"@earendil-works/pi-ai\";\nimport { Kind, Type, type TSchema } from \"@sinclair/typebox\";\nimport { Value } from \"@sinclair/typebox/value\";\nimport * as log from \"../log.js\";\nimport type { MikanModels } from \"./models.js\";\nimport { MikanAgentSession } from \"./runner.js\";\nimport { SessionStore } from \"./session-store.js\";\nimport type {\n  SubagentModelSpec,\n  SubagentRunOutput,\n  SubagentRunRequest,\n  SubagentRunResult,\n} from \"./types.js\";\n\nconst subagentRunDepth = new AsyncLocalStorage<number>();\nconst DEFAULT_SYSTEM_PROMPT =\n  \"You are a focused subagent. Complete only the assigned task and return the result directly.\";\nconst DEFAULT_SUBAGENT_BUDGET = {\n  maxTurns: 8,\n  maxCostUsd: 0.5,\n  maxDurationMs: 2 * 60 * 1000,\n} as const;\n\nconst SCHEMA_STRUCTURAL_KEYS = new Set([\n  \"type\",\n  \"properties\",\n  \"required\",\n  \"items\",\n  \"enum\",\n  \"const\",\n  \"anyOf\",\n  \"oneOf\",\n  \"allOf\",\n]);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction schemaOptions(node: Record<string, unknown>): Record<string, unknown> {\n  const options: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(node)) {\n    if (!SCHEMA_STRUCTURAL_KEYS.has(key)) options[key] = value;\n  }\n  if (isRecord(options.additionalProperties)) {\n    options.additionalProperties = hydrateSchema(options.additionalProperties);\n  }\n  return options;\n}\n\n/**\n * outputSchema arrives over the subagent tool as plain JSON (tool-call\n * arguments never carry TypeBox's Kind symbol), but Value.Check dispatches\n * purely on schema[Kind] and throws ValueCheckUnknownTypeError for anything\n * without it. Hydrate plain JSON Schema into real TypeBox schema nodes so\n * validation runs instead of throwing; schemas built with TypeBox already\n * carry Kind and pass through untouched.\n *\n * Unsupported keywords ($ref, not, patternProperties, if/then/else) degrade to\n * a permissive Unknown — fail-open by design: outputSchema is advisory output\n * validation, not a security boundary.\n */\nfunction hydrateSchema(schema: unknown): TSchema {\n  if (isRecord(schema) && Kind in schema) return schema as TSchema;\n  if (!isRecord(schema)) return Type.Unknown();\n\n  if (Array.isArray(schema.enum)) {\n    const literals = schema.enum.filter(\n      (value): value is string | number | boolean =>\n        typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\",\n    );\n    return literals.length > 0\n      ? Type.Union(literals.map((value) => Type.Literal(value)))\n      : Type.Unknown();\n  }\n  if (\"const\" in schema) {\n    const value = schema.const;\n    return typeof value === \"string\" || typeof value === \"number\" || typeof value === \"boolean\"\n      ? Type.Literal(value)\n      : Type.Unknown();\n  }\n  if (Array.isArray(schema.anyOf)) return Type.Union(schema.anyOf.map(hydrateSchema));\n  if (Array.isArray(schema.oneOf)) return Type.Union(schema.oneOf.map(hydrateSchema));\n  if (Array.isArray(schema.allOf)) return Type.Intersect(schema.allOf.map(hydrateSchema));\n\n  const type = Array.isArray(schema.type)\n    ? schema.type\n    : (schema.type ?? (schema.properties ? \"object\" : schema.items ? \"array\" : undefined));\n  if (Array.isArray(type)) {\n    return Type.Union(type.map((variant) => hydrateSchema({ ...schema, type: variant })));\n  }\n\n  const options = schemaOptions(schema);\n  switch (type) {\n    case \"object\": {\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n      const required = new Set(Array.isArray(schema.required) ? schema.required : []);\n      const props: Record<string, TSchema> = {};\n      for (const [key, value] of Object.entries(properties)) {\n        const hydrated = hydrateSchema(value);\n        props[key] = required.has(key) ? hydrated : Type.Optional(hydrated);\n      }\n      return Type.Object(props, options);\n    }\n    case \"array\":\n      return Type.Array(\n        schema.items !== undefined ? hydrateSchema(schema.items) : Type.Unknown(),\n        options,\n      );\n    case \"string\":\n      return Type.String(options);\n    case \"number\":\n      return Type.Number(options);\n    case \"integer\":\n      return Type.Integer(options);\n    case \"boolean\":\n      return Type.Boolean(options);\n    case \"null\":\n      return Type.Null(options);\n    default:\n      return Type.Unknown(options);\n  }\n}\n\ninterface RunSubagentOptions<TOutputSchema extends TSchema | undefined = undefined> {\n  request: SubagentRunRequest<TOutputSchema>;\n  defaultModel: Model<Api>;\n  thinkingLevel: ThinkingLevel;\n  models: MikanModels;\n  workspaceDir: string;\n  availableTools: AgentTool[];\n  /**\n   * The one seam through which a run's spend reaches its initiator (e.g. the\n   * parent session's budget). Called exactly once per run with the final\n   * totals — on every terminal path, including never-reject failures —\n   * before the result is returned. Errors thrown here are logged and\n   * swallowed to preserve the never-reject contract.\n   */\n  onUsage?: (usage: { tokens: number; costUsd: number }) => void | Promise<void>;\n}\n\nfunction resolveBudget(budget: RunSubagentOptions[\"request\"][\"budget\"]) {\n  const resolved = { ...DEFAULT_SUBAGENT_BUDGET, ...budget };\n  const positiveIntegerFields = [\n    [\"maxTurns\", resolved.maxTurns],\n    [\"maxTokens\", resolved.maxTokens],\n    [\"maxDurationMs\", resolved.maxDurationMs],\n  ] as const;\n  for (const [name, value] of positiveIntegerFields) {\n    if (value !== undefined && (!Number.isInteger(value) || value <= 0)) {\n      throw new Error(`api.subagent.run budget.${name} must be a positive integer`);\n    }\n  }\n  if (!Number.isFinite(resolved.maxCostUsd) || resolved.maxCostUsd < 0) {\n    throw new Error(\"api.subagent.run budget.maxCostUsd must be a non-negative number\");\n  }\n  return resolved;\n}\n\nfunction selectTools(requested: string[] | undefined, available: AgentTool[]): AgentTool[] {\n  if (!requested || requested.length === 0) return [];\n  const byName = new Map<string, AgentTool>();\n  for (const tool of available) {\n    if (!byName.has(tool.name)) byName.set(tool.name, tool);\n  }\n  const selected: AgentTool[] = [];\n  for (const name of new Set(requested)) {\n    const tool = byName.get(name);\n    if (!tool) throw new Error(`Unknown or unavailable subagent tool: ${name}`);\n    selected.push(tool);\n  }\n  return selected;\n}\n\nfunction formatTask(task: string, input: unknown): string {\n  const trimmed = task.trim();\n  if (!trimmed) throw new Error(\"api.subagent.run requires a non-empty task\");\n  if (input === undefined) return trimmed;\n  let serialized: string | undefined;\n  try {\n    serialized = JSON.stringify(input, null, 2);\n  } catch (err) {\n    throw new Error(\n      `api.subagent.run input must be JSON-serializable: ${err instanceof Error ? err.message : String(err)}`,\n      { cause: err },\n    );\n  }\n  if (serialized === undefined) {\n    throw new Error(\"api.subagent.run input must be JSON-serializable\");\n  }\n  return `${trimmed}\\n\\nInput:\\n${serialized}`;\n}\n\nfunction buildSystemPrompt(base: string | undefined, outputSchema: TSchema | undefined): string {\n  const prompt = base?.trim() || DEFAULT_SYSTEM_PROMPT;\n  if (!outputSchema) return prompt;\n  return [\n    prompt,\n    \"\",\n    \"Return only one JSON value matching this JSON Schema. Do not use Markdown or code fences.\",\n    JSON.stringify(outputSchema),\n  ].join(\"\\n\");\n}\n\nfunction finalAssistant(messages: AgentMessage[]): AssistantMessage | undefined {\n  for (let index = messages.length - 1; index >= 0; index--) {\n    const message = messages[index];\n    if (message.role === \"assistant\") return message;\n  }\n  return undefined;\n}\n\nfunction assistantText(message: AssistantMessage | undefined): string {\n  if (!message) return \"\";\n  return message.content\n    .filter((part) => part.type === \"text\")\n    .map((part) => part.text)\n    .join(\"\");\n}\n\n/**\n * Execute one non-recursive, fresh subagent run. Never rejects: every\n * failure — including request validation — is a result with a terminal\n * status, so batch callers (`tasks` / `dag`) can never orphan in-flight\n * sibling runs on one bad request. The run's spend is reported through\n * `onUsage` before the result is returned.\n */\nexport async function runSubagent<TOutputSchema extends TSchema | undefined = undefined>(\n  options: RunSubagentOptions<TOutputSchema>,\n): Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>> {\n  const result = await executeSubagentRun(options);\n  try {\n    await options.onUsage?.({ tokens: result.tokens, costUsd: result.costUsd });\n  } catch (err) {\n    log.logWarning(\"Subagent onUsage listener failed\", String(err));\n  }\n  return result;\n}\n\nasync function executeSubagentRun<TOutputSchema extends TSchema | undefined = undefined>(\n  options: RunSubagentOptions<TOutputSchema>,\n): Promise<SubagentRunResult<SubagentRunOutput<TOutputSchema>>> {\n  const { request } = options;\n  const runId = randomUUID();\n  const startedAt = Date.now();\n  let modelSpec: SubagentModelSpec = request.model ?? {\n    provider: options.defaultModel.provider,\n    id: options.defaultModel.id,\n  };\n  let sessionRef: MikanAgentSession | undefined;\n  let terminalSignal: \"cancelled\" | \"timeout\" | undefined;\n  let timeout: NodeJS.Timeout | undefined;\n  const abort = (reason: \"cancelled\" | \"timeout\") => {\n    if (terminalSignal) return;\n    terminalSignal = reason;\n    sessionRef?.abort();\n  };\n  const onAbort = () => abort(\"cancelled\");\n\n  try {\n    if ((subagentRunDepth.getStore() ?? 0) >= 1) {\n      throw new Error(\"Nested api.subagent.run calls are not allowed\");\n    }\n    const model = request.model\n      ? options.models.resolve(request.model.provider, request.model.id)\n      : options.defaultModel;\n    modelSpec = { provider: model.provider, id: model.id };\n    const tools = selectTools(request.tools, options.availableTools);\n    const task = formatTask(request.task, request.input);\n    const budget = resolveBudget(request.budget);\n    const session = new MikanAgentSession({\n      systemPrompt: buildSystemPrompt(request.systemPrompt, request.outputSchema),\n      model,\n      thinkingLevel: options.thinkingLevel,\n      tools,\n      models: options.models,\n      sessionStore: SessionStore.inMemory(options.workspaceDir),\n      settings: { compaction: { enabled: false } },\n    });\n    sessionRef = session;\n\n    request.signal?.addEventListener(\"abort\", onAbort, { once: true });\n    if (request.signal?.aborted) abort(\"cancelled\");\n    timeout = setTimeout(() => abort(\"timeout\"), budget.maxDurationMs);\n    timeout.unref();\n\n    if (!terminalSignal) {\n      await subagentRunDepth.run(1, () =>\n        session.prompt(task, {\n          budget: {\n            maxLlmCalls: budget.maxTurns,\n            maxTokens: budget.maxTokens,\n            maxCostUsd: budget.maxCostUsd,\n            maxDurationMs: budget.maxDurationMs,\n          },\n        }),\n      );\n    }\n\n    const stats = session.getLastRunStats();\n    const assistant = finalAssistant(session.messages);\n    const text = assistantText(assistant);\n    const base = {\n      runId,\n      model: modelSpec,\n      turns: stats.llmCalls,\n      tokens: stats.tokens,\n      costUsd: stats.costUsd,\n      durationMs: Date.now() - startedAt,\n      ...(text ? { text } : {}),\n    };\n\n    if (terminalSignal) return { ...base, status: terminalSignal };\n    if (stats.budgetExceededReason) {\n      return {\n        ...base,\n        status: \"budget_exceeded\",\n        error: stats.budgetExceededReason,\n      };\n    }\n    if (assistant?.stopReason === \"error\") {\n      return {\n        ...base,\n        status: \"failed\",\n        error: assistant.errorMessage || \"Subagent failed\",\n      };\n    }\n    if (!assistant) {\n      return { ...base, status: \"failed\", error: \"Subagent produced no assistant response\" };\n    }\n\n    if (request.outputSchema) {\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(text);\n      } catch {\n        return { ...base, status: \"invalid_output\", error: \"Subagent output is not valid JSON\" };\n      }\n      if (!Value.Check(hydrateSchema(request.outputSchema), parsed)) {\n        return {\n          ...base,\n          status: \"invalid_output\",\n          error: \"Subagent output does not match the requested schema\",\n        };\n      }\n      return {\n        ...base,\n        status: \"completed\",\n        output: parsed as SubagentRunOutput<TOutputSchema>,\n      };\n    }\n\n    if (!text) {\n      return { ...base, status: \"failed\", error: \"Subagent produced no text output\" };\n    }\n    return {\n      ...base,\n      status: \"completed\",\n      output: text as SubagentRunOutput<TOutputSchema>,\n    };\n  } catch (err) {\n    const stats = sessionRef?.getLastRunStats();\n    return {\n      runId,\n      status: terminalSignal ?? \"failed\",\n      model: modelSpec,\n      turns: stats?.llmCalls ?? 0,\n      tokens: stats?.tokens ?? 0,\n      costUsd: stats?.costUsd ?? 0,\n      durationMs: Date.now() - startedAt,\n      error: err instanceof Error ? err.message : String(err),\n    };\n  } finally {\n    if (timeout) clearTimeout(timeout);\n    request.signal?.removeEventListener(\"abort\", onAbort);\n  }\n}\n"]}

package/dist/harness/types.d.ts

@@ -7,12 +7,65 @@
  * always written, so existing conversation history keeps working unchanged.
  */
 import type { BranchSummaryEntry, CompactionEntry, CustomEntry, CustomMessageEntry, MessageEntry, SessionContext, SessionInfoEntry, SessionTreeEntry } from "@earendil-works/pi-agent-core";
+import type { Static, TSchema } from "@sinclair/typebox";
 export type { BranchSummaryEntry, CompactionEntry, CustomEntry, CustomMessageEntry, SessionContext, SessionInfoEntry, };
 /** Message entry as stored in mikan session files. */
 export type SessionMessageEntry = MessageEntry;
 /** Union of entry types mikan reads and writes. Alias of pi-agent-core's tree entry. */
 export type SessionEntry = SessionTreeEntry;
 export declare const CURRENT_SESSION_VERSION = 3;
+export interface SubagentModelSpec {
+    provider: string;
+    id: string;
+}
+export interface SubagentRunBudget {
+    /** Maximum assistant/model calls in the subagent run. */
+    maxTurns?: number;
+    /** Maximum cumulative input/output/cache tokens. */
+    maxTokens?: number;
+    /** Maximum provider cost in USD. */
+    maxCostUsd?: number;
+    /** Maximum wall-clock duration. */
+    maxDurationMs?: number;
+}
+export type SubagentRunStatus = "completed" | "failed" | "cancelled" | "timeout" | "budget_exceeded" | "invalid_output";
+/** A fresh, isolated subagent run. */
+export interface SubagentRunRequest<TOutputSchema extends TSchema | undefined = undefined> {
+    task: string;
+    systemPrompt?: string;
+    /** JSON-serializable input appended to the task. */
+    input?: unknown;
+    /** Defaults to the parent runner's configured model. */
+    model?: SubagentModelSpec;
+    /** Tool names explicitly granted to the subagent. Defaults to no tools. */
+    tools?: string[];
+    /** When present, the final response must be JSON matching this schema. */
+    outputSchema?: TOutputSchema;
+    budget?: SubagentRunBudget;
+    signal?: AbortSignal;
+}
+export type SubagentRunOutput<TSchemaOrUndefined extends TSchema | undefined> = TSchemaOrUndefined extends TSchema ? Static<TSchemaOrUndefined> : string;
+interface SubagentRunMetadata {
+    runId: string;
+    /** Raw final assistant text, including when structured validation failed. */
+    text?: string;
+    model: SubagentModelSpec;
+    turns: number;
+    tokens: number;
+    costUsd: number;
+    durationMs: number;
+}
+interface SubagentRunCompletedResult<TOutput> extends SubagentRunMetadata {
+    status: "completed";
+    output: TOutput;
+    error?: never;
+}
+interface SubagentRunIncompleteResult extends SubagentRunMetadata {
+    status: Exclude<SubagentRunStatus, "completed">;
+    output?: never;
+    error?: string;
+}
+export type SubagentRunResult<TOutput = string> = SubagentRunCompletedResult<TOutput> | SubagentRunIncompleteResult;
 /**
  * First line of every session file. `cwd` records where the session was
  * started; extra fields (for example mikan's `source` marker) are preserved

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,gBAAgB,GACjB,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAE/C,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAE5C,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,sDAAsD;AACtD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"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"}

package/dist/harness/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAkCA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC","sourcesContent":["/**\n * Core types for the mikan agent harness.\n *\n * The harness is built directly on pi-agent-core and pi-ai. Session entries\n * are structurally identical to pi-agent-core's `SessionTreeEntry`, and the\n * on-disk JSONL format stays compatible with the v3 session files mikan has\n * always written, so existing conversation history keeps working unchanged.\n */\nimport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  CustomMessageEntry,\n  MessageEntry,\n  SessionContext,\n  SessionInfoEntry,\n  SessionTreeEntry,\n} from \"@earendil-works/pi-agent-core\";\n\nexport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  CustomMessageEntry,\n  SessionContext,\n  SessionInfoEntry,\n};\n\n/** Message entry as stored in mikan session files. */\nexport type SessionMessageEntry = MessageEntry;\n\n/** Union of entry types mikan reads and writes. Alias of pi-agent-core's tree entry. */\nexport type SessionEntry = SessionTreeEntry;\n\nexport const CURRENT_SESSION_VERSION = 3;\n\n/**\n * First line of every session file. `cwd` records where the session was\n * started; extra fields (for example mikan's `source` marker) are preserved\n * verbatim on read and rewrite.\n */\nexport interface SessionHeader {\n  type: \"session\";\n  version?: number;\n  id: string;\n  timestamp: string;\n  cwd: string;\n  parentSession?: string;\n  [extra: string]: unknown;\n}\n\n/** Raw file line: the header or one session entry. */\nexport type SessionFileEntry = SessionHeader | SessionEntry;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/harness/types.ts"],"names":[],"mappings":"AAmCA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC","sourcesContent":["/**\n * Core types for the mikan agent harness.\n *\n * The harness is built directly on pi-agent-core and pi-ai. Session entries\n * are structurally identical to pi-agent-core's `SessionTreeEntry`, and the\n * on-disk JSONL format stays compatible with the v3 session files mikan has\n * always written, so existing conversation history keeps working unchanged.\n */\nimport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  CustomMessageEntry,\n  MessageEntry,\n  SessionContext,\n  SessionInfoEntry,\n  SessionTreeEntry,\n} from \"@earendil-works/pi-agent-core\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\n\nexport type {\n  BranchSummaryEntry,\n  CompactionEntry,\n  CustomEntry,\n  CustomMessageEntry,\n  SessionContext,\n  SessionInfoEntry,\n};\n\n/** Message entry as stored in mikan session files. */\nexport type SessionMessageEntry = MessageEntry;\n\n/** Union of entry types mikan reads and writes. Alias of pi-agent-core's tree entry. */\nexport type SessionEntry = SessionTreeEntry;\n\nexport const CURRENT_SESSION_VERSION = 3;\n\nexport interface SubagentModelSpec {\n  provider: string;\n  id: string;\n}\n\nexport interface SubagentRunBudget {\n  /** Maximum assistant/model calls in the subagent run. */\n  maxTurns?: number;\n  /** Maximum cumulative input/output/cache tokens. */\n  maxTokens?: number;\n  /** Maximum provider cost in USD. */\n  maxCostUsd?: number;\n  /** Maximum wall-clock duration. */\n  maxDurationMs?: number;\n}\n\nexport type SubagentRunStatus =\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n  | \"timeout\"\n  | \"budget_exceeded\"\n  | \"invalid_output\";\n\n/** A fresh, isolated subagent run. */\nexport interface SubagentRunRequest<TOutputSchema extends TSchema | undefined = undefined> {\n  task: string;\n  systemPrompt?: string;\n  /** JSON-serializable input appended to the task. */\n  input?: unknown;\n  /** Defaults to the parent runner's configured model. */\n  model?: SubagentModelSpec;\n  /** Tool names explicitly granted to the subagent. Defaults to no tools. */\n  tools?: string[];\n  /** When present, the final response must be JSON matching this schema. */\n  outputSchema?: TOutputSchema;\n  budget?: SubagentRunBudget;\n  signal?: AbortSignal;\n}\n\nexport type SubagentRunOutput<TSchemaOrUndefined extends TSchema | undefined> =\n  TSchemaOrUndefined extends TSchema ? Static<TSchemaOrUndefined> : string;\n\ninterface SubagentRunMetadata {\n  runId: string;\n  /** Raw final assistant text, including when structured validation failed. */\n  text?: string;\n  model: SubagentModelSpec;\n  turns: number;\n  tokens: number;\n  costUsd: number;\n  durationMs: number;\n}\n\ninterface SubagentRunCompletedResult<TOutput> extends SubagentRunMetadata {\n  status: \"completed\";\n  output: TOutput;\n  error?: never;\n}\n\ninterface SubagentRunIncompleteResult extends SubagentRunMetadata {\n  status: Exclude<SubagentRunStatus, \"completed\">;\n  output?: never;\n  error?: string;\n}\n\nexport type SubagentRunResult<TOutput = string> =\n  | SubagentRunCompletedResult<TOutput>\n  | SubagentRunIncompleteResult;\n\n/**\n * First line of every session file. `cwd` records where the session was\n * started; extra fields (for example mikan's `source` marker) are preserved\n * verbatim on read and rewrite.\n */\nexport interface SessionHeader {\n  type: \"session\";\n  version?: number;\n  id: string;\n  timestamp: string;\n  cwd: string;\n  parentSession?: string;\n  [extra: string]: unknown;\n}\n\n/** Raw file line: the header or one session entry. */\nexport type SessionFileEntry = SessionHeader | SessionEntry;\n"]}

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { defaultCommandHandlers, dispatchCommand } from "./commands/registry.js";
 export * from "./harness/index.js";
 export type { CommandContext, CommandHandler, CommandServices } from "./commands/types.js";
-export * from "./sessions/agent-memory-file-manager.js";
+export * from "./sessions/chat-history-sync.js";
 export * from "./sessions/metadata.js";
 export * from "./sessions/policy.js";
 export * from "./sessions/store.js";
-export { createConversationRuntime, type CreateSessionSandboxOptions, type RunSessionOptions, type ConversationRuntime, type ConversationRuntimeOptions, } from "./runtime/conversation-runtime.js";
+export { createConversationRuntime, type RunSessionOptions, type ConversationRuntime, type ConversationRuntimeOptions, } from "./runtime/conversation-runtime.js";
 export type { MessagingBot, ConversationContext, ConversationEvent, MessagingEventHandler, ChatAdapter, ConversationMessage, ConversationResponder, ChatToolResult, ConversationKind, MessagingInfo, RunningSession, } from "./adapter.js";
-export { SandboxError, createExecutor, getSandboxAdapters, parseSandboxArg, validateSandbox, } from "./sandbox/index.js";
+export { SandboxError, configureGondolinRuntime, createExecutor, getSandboxAdapters, parseSandboxArg, validateSandbox, type GondolinBootstrapOptions, } from "./sandbox/index.js";
 export type { CloudflareSandboxConfig, ExecOptions, ExecResult, Executor, SandboxAdapter, SandboxConfig, } from "./sandbox/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3F,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,cAAc,oBAAoB,CAAC;AACnC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3F,cAAc,iCAAiC,CAAC;AAChD,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EACL,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,GAChC,MAAM,mCAAmC,CAAC;AAC3C,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,cAAc,EACd,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,uBAAuB,EACvB,WAAW,EACX,UAAU,EACV,QAAQ,EACR,cAAc,EACd,aAAa,GACd,MAAM,oBAAoB,CAAC"}