@geminixiang/mikan 1.0.0-beta.4 → 1.0.0-beta.41

package/dist/sessions/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"crypto\";\nimport { existsSync, mkdirSync, rmSync } from \"fs\";\nimport { basename, dirname, join } from \"path\";\nimport { SessionStore } from \"../harness/index.js\";\nimport { isRecord, parseJsonValue, readTextFileIfExists } from \"../utils/file-guards.js\";\nimport { atomicWritePrivateFile } from \"../utils/fs-atomic.js\";\nimport { isPlatformHistorySession } from \"./metadata.js\";\nexport type { ResolvedSessionScope, ThreadRootMessage } from \"./types.js\";\n\n/**\n * Returns the shared session directory for a conversation.\n * Channel sessions use a current pointer within this directory.\n * Thread sessions are stored as fixed files within the same directory.\n */\nexport function getChannelSessionDir(channelDir: string): string {\n  return join(channelDir, \"sessions\");\n}\n\n/**\n * Resolves the current active session file for a session directory.\n * Reads the \"current\" pointer file; creates a new session if none exists\n * or the pointed-to file is missing.\n */\nexport function resolveSessionFile(sessionDir: string): string {\n  const existing = tryResolveCurrentSession(sessionDir);\n  if (existing) return existing;\n  return createNewSessionFile(sessionDir);\n}\n\n/**\n * Resolve the current active session file for a session directory.\n * Creates a fully initialized persistent session with the provided cwd when none exists.\n */\nexport function resolveManagedSessionFile(sessionDir: string, cwd: string): string {\n  const existingPath = getCurrentSessionPath(sessionDir);\n  if (existingPath && !isPlatformHistorySession(existingPath)) return existingPath;\n  return createManagedSessionFile(sessionDir, cwd);\n}\n\n/**\n * Extracts the short UUID from a session file path.\n * e.g. \"2026-04-05T00-00_7b54cf90.jsonl\" → \"7b54cf90\"\n */\nexport function extractSessionUuid(sessionFile: string): string {\n  return basename(sessionFile).replace(\".jsonl\", \"\").split(\"_\").pop()!;\n}\n\n/**\n * Extracts the thread/suffix part of a session key.\n * \"channelId:threadId\" → \"threadId\", \"channelId\" → \"channelId\"\n */\nexport function extractSessionSuffix(sessionKey: string): string {\n  const parts = sessionKey.split(\":\");\n  return parts.length > 1 ? parts[parts.length - 1] : sessionKey;\n}\n\n/**\n * Creates an empty timestamped file and updates the \"current\" pointer.\n * Used only by tests for placeholder-file scenarios.\n *\n * Order matters: write the session file first, then atomic-rename the pointer\n * last so a crash mid-create never leaves \"current\" pointing at a missing file.\n */\nexport function createNewSessionFile(sessionDir: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const filename = createSessionFilename();\n  const filePath = join(sessionDir, filename);\n  atomicWritePrivateFile(filePath, \"\");\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n  return filePath;\n}\n\n/**\n * Creates a new persistent session file with a proper SessionManager header and cwd.\n * Also updates the \"current\" pointer. Header is written before the pointer flips so a\n * partial create cannot leave \"current\" pointing at a missing file.\n */\nexport function createManagedSessionFile(sessionDir: string, cwd: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const sessionId = randomUUID();\n  const sessionFile = join(sessionDir, createSessionFilename(sessionId));\n  writeSessionHeader(sessionFile, cwd, sessionId);\n  setCurrentPointer(sessionDir, sessionFile);\n  return sessionFile;\n}\n\n/**\n * Open a session file with an explicit cwd, even if the file does not exist yet.\n * This avoids SessionStore.open() falling back to process.cwd() for fresh sessions.\n */\nexport function openManagedSession(sessionFile: string, cwd: string): SessionStore {\n  if (shouldRecreatePreinitializedSession(sessionFile)) {\n    rmSync(sessionFile, { force: true });\n  }\n\n  return SessionStore.open(sessionFile, cwd);\n}\n\nfunction createSessionFilename(sessionId = randomUUID()): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  return `${timestamp}_${sessionId.slice(0, 8)}.jsonl`;\n}\n\nfunction setCurrentPointer(sessionDir: string, sessionFilePath: string): void {\n  const filename = sessionFilePath.split(\"/\").pop()!;\n  mkdirSync(sessionDir, { recursive: true });\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n}\n\n/**\n * Creates or overwrites a fixed-path session file with a valid session header.\n */\nexport function createManagedSessionFileAtPath(sessionFile: string, cwd: string): string {\n  writeSessionHeader(sessionFile, cwd);\n  return sessionFile;\n}\n\nfunction writeSessionHeader(sessionFile: string, cwd: string, sessionId = randomUUID()): void {\n  const sessionDir = dirname(sessionFile);\n  mkdirSync(sessionDir, { recursive: true });\n  const header = {\n    type: \"session\",\n    version: 3,\n    id: sessionId,\n    timestamp: new Date().toISOString(),\n    cwd,\n  };\n  atomicWritePrivateFile(sessionFile, `${JSON.stringify(header)}\\n`);\n}\n\n/**\n * Returns the fixed session file path for a Slack thread.\n */\nexport function getThreadSessionFile(channelDir: string, sessionKey: string): string {\n  return join(getChannelSessionDir(channelDir), `${extractSessionSuffix(sessionKey)}.jsonl`);\n}\n\nfunction hasSessionHeader(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const lines = raw.split(\"\\n\");\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed) continue;\n      const entry = parseSessionEntry(trimmed);\n      return entry.type === \"session\";\n    }\n  } catch {\n    return false;\n  }\n  return false;\n}\n\nfunction shouldRecreatePreinitializedSession(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const entries = raw\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map(parseSessionEntry);\n\n    return entries.length === 1 && entries[0]?.type === \"session\";\n  } catch {\n    return false;\n  }\n}\n\nfunction parseSessionEntry(line: string): { type?: string } {\n  return parseJsonValue(\n    line,\n    (value): value is { type?: string } => isRecord(value),\n    (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n  );\n}\n\nfunction getCurrentSessionPath(sessionDir: string): string | null {\n  const pointerFile = join(sessionDir, \"current\");\n  const filename = readTextFileIfExists(pointerFile)?.trim();\n  if (!filename) return null;\n  return join(sessionDir, filename);\n}\n\n/**\n * Try to resolve an existing current session file.\n * Returns null if no current pointer exists or the pointed file has no valid session header.\n */\nexport function tryResolveCurrentSession(sessionDir: string): string | null {\n  const fullPath = getCurrentSessionPath(sessionDir);\n  if (fullPath && existsSync(fullPath) && hasSessionHeader(fullPath)) return fullPath;\n  return null;\n}\n\n/**\n * Try to resolve an existing thread session file.\n * Returns the file path if found, or null if no valid thread session exists yet.\n */\nexport function tryResolveThreadSession(sessionFile: string): string | null {\n  return existsSync(sessionFile) && hasSessionHeader(sessionFile) ? sessionFile : null;\n}\n\n/**\n * Resolve the channel's current session file path.\n * Returns null if no channel session exists.\n */\nexport function resolveChannelSessionFile(channelDir: string): string | null {\n  return tryResolveCurrentSession(getChannelSessionDir(channelDir));\n}\n"]}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { existsSync, lstatSync, mkdirSync, readdirSync, rmSync } from \"node:fs\";\nimport { basename, dirname, join, relative, resolve, sep } from \"node:path\";\nimport { SessionStore } from \"../harness/index.js\";\nimport {\n  atomicWritePrivateFile,\n  isRecord,\n  parseJsonValue,\n  readTextFileIfExists,\n} from \"../utils/file-guards.js\";\nimport { officeSessionsDir } from \"../office/index.js\";\nimport { assertSessionSuffix, threadSuffixOf } from \"./session-key.js\";\nexport type { ResolvedSessionScope, ThreadRootMessage } from \"./types.js\";\nexport type { MikanSessionHeader } from \"./types.js\";\nimport type { MikanSessionHeader } from \"./types.js\";\n\nexport function isPlatformHistorySession(sessionFile: string): boolean {\n  try {\n    const header = SessionStore.open(sessionFile).getHeader() as MikanSessionHeader | null;\n    return header?.source?.kind === \"platform-history\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Resolves the current active session file for a session directory.\n * Reads the \"current\" pointer file; creates a new session if none exists\n * or the pointed-to file is missing.\n */\nexport function resolveSessionFile(sessionDir: string): string {\n  const existing = tryResolveCurrentSession(sessionDir);\n  if (existing) return existing;\n  return createNewSessionFile(sessionDir);\n}\n\n/**\n * Resolve the current active session file for a session directory.\n * Creates a fully initialized persistent session with the provided cwd when none exists.\n */\nexport function resolveManagedSessionFile(sessionDir: string, cwd: string): string {\n  const existingPath = getCurrentSessionPath(sessionDir);\n  if (existingPath && !isPlatformHistorySession(existingPath)) return existingPath;\n  return createManagedSessionFile(sessionDir, cwd);\n}\n\n/**\n * Extracts the short UUID from a session file path.\n * e.g. \"2026-04-05T00-00_7b54cf90.jsonl\" → \"7b54cf90\"\n */\nexport function extractSessionUuid(sessionFile: string): string {\n  return basename(sessionFile).replace(\".jsonl\", \"\").split(\"_\").pop()!;\n}\n\n/**\n * Extracts the thread/suffix part of a session key.\n * \"channelId:threadId\" → \"threadId\", \"channelId\" → \"channelId\"\n */\nexport function extractSessionSuffix(sessionKey: string): string {\n  return assertSessionSuffix(threadSuffixOf(sessionKey) ?? sessionKey);\n}\n\n/**\n * Resolve one child path and prove it remains inside its owning directory.\n * Identity validation is the first guard; containment is defense in depth for\n * every session path derived from platform-controlled values.\n */\nfunction resolveChildPath(root: string, child: string): string {\n  const resolvedRoot = resolve(root);\n  const resolvedChild = resolve(resolvedRoot, child);\n  const relation = relative(resolvedRoot, resolvedChild);\n  if (!relation || relation === \"..\" || relation.startsWith(`..${sep}`)) {\n    throw new Error(`Session path escapes its owning directory: ${JSON.stringify(child)}`);\n  }\n  return resolvedChild;\n}\n\n/**\n * Creates an empty timestamped file and updates the \"current\" pointer.\n * Used only by tests for placeholder-file scenarios.\n *\n * Order matters: write the session file first, then atomic-rename the pointer\n * last so a crash mid-create never leaves \"current\" pointing at a missing file.\n */\nexport function createNewSessionFile(sessionDir: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const filename = createSessionFilename();\n  const filePath = join(sessionDir, filename);\n  atomicWritePrivateFile(filePath, \"\");\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n  return filePath;\n}\n\n/**\n * Creates a new persistent session file with a proper SessionManager header and cwd.\n * Also updates the \"current\" pointer. Header is written before the pointer flips so a\n * partial create cannot leave \"current\" pointing at a missing file.\n */\nexport function createManagedSessionFile(sessionDir: string, cwd: string): string {\n  mkdirSync(sessionDir, { recursive: true });\n  const sessionId = randomUUID();\n  const sessionFile = join(sessionDir, createSessionFilename(sessionId));\n  writeSessionHeader(sessionFile, cwd, sessionId);\n  setCurrentPointer(sessionDir, sessionFile);\n  return sessionFile;\n}\n\n/**\n * Open a session file with an explicit cwd, even if the file does not exist yet.\n * This avoids SessionStore.open() falling back to process.cwd() for fresh sessions.\n */\nexport function openManagedSession(sessionFile: string, cwd: string): SessionStore {\n  if (shouldRecreatePreinitializedSession(sessionFile)) {\n    rmSync(sessionFile, { force: true });\n  }\n\n  return SessionStore.open(sessionFile, cwd);\n}\n\nfunction createSessionFilename(sessionId = randomUUID()): string {\n  const timestamp = new Date().toISOString().replace(/[:.]/g, \"-\");\n  return `${timestamp}_${sessionId.slice(0, 8)}.jsonl`;\n}\n\nfunction setCurrentPointer(sessionDir: string, sessionFilePath: string): void {\n  const filename = sessionFilePath.split(\"/\").pop()!;\n  mkdirSync(sessionDir, { recursive: true });\n  atomicWritePrivateFile(join(sessionDir, \"current\"), filename);\n}\n\n/**\n * Creates or overwrites a fixed-path session file with a valid session header.\n */\nexport interface ParentSessionRef {\n  path: string;\n  id: string;\n}\n\nexport function createManagedSessionFileAtPath(\n  sessionFile: string,\n  cwd: string,\n  parent?: ParentSessionRef,\n): string {\n  writeSessionHeader(sessionFile, cwd, undefined, parent);\n  return sessionFile;\n}\n\nfunction writeSessionHeader(\n  sessionFile: string,\n  cwd: string,\n  sessionId = randomUUID(),\n  parent?: ParentSessionRef,\n): void {\n  mkdirSync(dirname(sessionFile), { recursive: true });\n  // The header format (and its version) is owned by the harness store; this\n  // layer only decides the path and the id.\n  SessionStore.create(sessionFile, cwd, {\n    id: sessionId,\n    ...(parent ? { parentSession: parent.path, parentSessionId: parent.id } : {}),\n  });\n}\n\n/**\n * Returns the fixed session file path for a Slack thread.\n */\nexport function getThreadSessionFile(channelDir: string, sessionKey: string): string {\n  const sessionDir = officeSessionsDir(channelDir);\n  return resolveChildPath(sessionDir, `${extractSessionSuffix(sessionKey)}.jsonl`);\n}\n\nfunction isRegularSessionFile(sessionFile: string): boolean {\n  try {\n    return lstatSync(sessionFile).isFile();\n  } catch {\n    return false;\n  }\n}\n\nfunction hasSessionHeader(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const lines = raw.split(\"\\n\");\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (!trimmed) continue;\n      const entry = parseSessionEntry(trimmed);\n      return entry.type === \"session\";\n    }\n  } catch {\n    return false;\n  }\n  return false;\n}\n\nfunction shouldRecreatePreinitializedSession(sessionFile: string): boolean {\n  try {\n    const raw = readTextFileIfExists(sessionFile);\n    if (raw === undefined) return false;\n    const entries = raw\n      .split(\"\\n\")\n      .map((line) => line.trim())\n      .filter(Boolean)\n      .map(parseSessionEntry);\n\n    if (entries.length !== 1 || entries[0]?.type !== \"session\") return false;\n    // Sessions with lineage metadata are fully initialized — preserve them.\n    const h = entries[0] as { parentSession?: unknown; parentSessionId?: unknown };\n    if (h.parentSession || h.parentSessionId) return false;\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction parseSessionEntry(line: string): { type?: string } {\n  return parseJsonValue(\n    line,\n    (value): value is { type?: string } => isRecord(value),\n    (detail) => (detail === \"unexpected JSON shape\" ? \"expected a JSON object\" : detail),\n  );\n}\n\nfunction getCurrentSessionPath(sessionDir: string): string | null {\n  const pointerFile = join(sessionDir, \"current\");\n  const filename = readTextFileIfExists(pointerFile)?.trim();\n  if (!filename) return null;\n  try {\n    return resolveChildPath(sessionDir, filename);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Try to resolve an existing current session file.\n * Returns null if no current pointer exists or the pointed file has no valid session header.\n */\nexport function tryResolveCurrentSession(sessionDir: string): string | null {\n  const fullPath = getCurrentSessionPath(sessionDir);\n  if (fullPath && isRegularSessionFile(fullPath) && hasSessionHeader(fullPath)) return fullPath;\n  return null;\n}\n\n/**\n * Try to resolve an existing thread session file.\n * Returns the file path if found, or null if no valid thread session exists yet.\n */\nexport function tryResolveThreadSession(sessionFile: string): string | null {\n  return isRegularSessionFile(sessionFile) && hasSessionHeader(sessionFile) ? sessionFile : null;\n}\n\n/**\n * Resolve the channel's current session file path.\n * Returns null if no channel session exists.\n */\nexport function resolveChannelSessionFile(channelDir: string): string | null {\n  return tryResolveCurrentSession(officeSessionsDir(channelDir));\n}\n\n// Matches timestamped main session filenames; thread sessions use bare threadTs.\nconst MAIN_SESSION_FILENAME = /^\\d{4}-\\d{2}-\\d{2}T.+_[0-9a-f]{8}\\.jsonl$/i;\n\n/**\n * Resolve the main session file that was active when a thread was created.\n * Uses the thread's Slack timestamp to find the main session whose creation\n * time is the latest one at or before that moment — stable across rotations.\n * Falls back to resolveChannelSessionFile when threadTs is absent or unparseable.\n * Returns both path and session UUID so callers can store a UUID-stable reference.\n */\nexport function resolveParentSessionForThread(\n  channelDir: string,\n  threadTs: string | undefined,\n): ParentSessionRef | null {\n  if (threadTs !== undefined) {\n    const threadTimeMs = Number(threadTs) * 1000;\n    if (Number.isFinite(threadTimeMs)) {\n      const best = findMainSessionActiveAtTime(channelDir, threadTimeMs);\n      if (best) return best;\n    }\n  }\n  const path = resolveChannelSessionFile(channelDir);\n  if (!path) return null;\n  const id = readSessionHeaderSummary(path)?.id;\n  return id ? { path, id } : null;\n}\n\nfunction findMainSessionActiveAtTime(\n  channelDir: string,\n  targetMs: number,\n): ParentSessionRef | null {\n  const sessionDir = officeSessionsDir(channelDir);\n  if (!existsSync(sessionDir)) return null;\n\n  let best: ParentSessionRef | null = null;\n  let bestCreatedMs = -Infinity;\n\n  for (const name of readdirSync(sessionDir)) {\n    if (!MAIN_SESSION_FILENAME.test(name)) continue;\n    const filePath = join(sessionDir, name);\n    const summary = readSessionHeaderSummary(filePath);\n    if (!summary) continue;\n    if (summary.timestampMs <= targetMs && summary.timestampMs > bestCreatedMs) {\n      bestCreatedMs = summary.timestampMs;\n      best = { path: filePath, id: summary.id };\n    }\n  }\n  return best;\n}\n\nfunction readSessionHeaderSummary(filePath: string): { id: string; timestampMs: number } | null {\n  try {\n    const raw = readTextFileIfExists(filePath);\n    if (!raw) return null;\n    const firstLine = raw.slice(0, raw.indexOf(\"\\n\")).trim();\n    if (!firstLine) return null;\n    const entry = parseSessionEntry(firstLine);\n    const { id, timestamp } = entry as { id?: unknown; timestamp?: unknown };\n    if (typeof id !== \"string\" || typeof timestamp !== \"string\") return null;\n    const timestampMs = new Date(timestamp).getTime();\n    return Number.isFinite(timestampMs) ? { id, timestampMs } : null;\n  } catch {\n    return null;\n  }\n}\n"]}

package/dist/sessions/types.d.ts

@@ -1,4 +1,6 @@
 import type { ConversationKind } from "../adapter.js";
+import type { SessionStore } from "../harness/index.js";
+import type { ConversationLogMessage } from "../types.js";
 export interface MikanSessionHeader {
     type?: string;
     version?: number;
@@ -32,7 +34,19 @@ export interface ResolvedSessionScope {
     contextFile: string;
     threadRootMessage: ThreadRootMessage | null;
 }
-export interface AgentMemoryFileManagerOptions {
+/** One parsed log.jsonl entry with its original line index. */
+export interface LogRecord {
+    message: ConversationLogMessage;
+    index: number;
+}
+/** What one sync pass actually did — the inspectable result of a sync. */
+export interface ChatSyncReport {
+    /** Log messages appended to the session in this pass. */
+    appended: number;
+    /** The log message id recorded as the new sync watermark. */
+    lastMessageId?: string;
+}
+export interface ChatHistorySyncOptions {
     recentDays?: number;
     maxTopLevelMessages?: number;
     now?: () => Date;
@@ -41,16 +55,16 @@ export interface ResolveChatSessionScopeOptions {
     conversationDir: string;
     sessionKey: string;
     cwd?: string;
-    /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */
+    /** The triggering platform message ID. History is capped before this turn to avoid future queued turns. */
     currentMessageId?: string;
     /** Rotate top-level shared sessions on biweekly Sunday boundaries. */
     rotateTopLevelSession?: boolean;
 }
-export interface SyncAgentMemoryFileManagerOptions {
+export interface SyncChatSessionOptions {
     conversationDir: string;
     sessionKey: string;
-    sessionManager: import("../harness/index.js").SessionStore;
-    /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */
+    sessionManager: SessionStore;
+    /** The triggering platform message ID. Sync is capped before this turn to avoid future queued turns. */
     currentMessageId?: string;
 }
 export interface ResetChatSessionOptions {

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAID,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C;AAID,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAC3D,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"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"}

package/dist/sessions/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\n\n// ── session metadata ─────────────────────────────────────────────────────────\n\nexport interface MikanSessionHeader {\n  type?: string;\n  version?: number;\n  id?: string;\n  timestamp?: string;\n  cwd?: string;\n  parentSession?: string;\n  source?: {\n    kind?: string;\n    file?: string;\n    recentDays?: number;\n  };\n}\n\n// ── session policy ───────────────────────────────────────────────────────────\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\n}\n\n// ── session store ────────────────────────────────────────────────────────────\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n  isMessagingBot?: boolean;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\n// ── chat session manager ─────────────────────────────────────────────────────\n\nexport interface AgentMemoryFileManagerOptions {\n  recentDays?: number;\n  maxTopLevelMessages?: number;\n  now?: () => Date;\n}\n\nexport interface ResolveChatSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n  /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */\n  currentMessageId?: string;\n  /** Rotate top-level shared sessions on biweekly Sunday boundaries. */\n  rotateTopLevelSession?: boolean;\n}\n\nexport interface SyncAgentMemoryFileManagerOptions {\n  conversationDir: string;\n  sessionKey: string;\n  sessionManager: import(\"../harness/index.js\").SessionStore;\n  /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */\n  currentMessageId?: string;\n}\n\nexport interface ResetChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface RegisterThreadSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface HasMaterializedSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n}\n\nexport interface ThreadBootstrapWaitOptions {\n  parentSessionKey: string;\n  sessionKey: string;\n  hasThreadSession: () => boolean;\n  isParentRunning: () => boolean;\n  sleep?: (ms: number) => Promise<void>;\n  pollMs?: number;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\nimport type { SessionStore } from \"../harness/index.js\";\nimport type { ConversationLogMessage } from \"../types.js\";\n\n// ── session metadata ─────────────────────────────────────────────────────────\n\nexport interface MikanSessionHeader {\n  type?: string;\n  version?: number;\n  id?: string;\n  timestamp?: string;\n  cwd?: string;\n  parentSession?: string;\n  source?: {\n    kind?: string;\n    file?: string;\n    recentDays?: number;\n  };\n}\n\n// ── session policy ───────────────────────────────────────────────────────────\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\n}\n\n// ── session store ────────────────────────────────────────────────────────────\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n  isMessagingBot?: boolean;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\n/** One parsed log.jsonl entry with its original line index. */\nexport interface LogRecord {\n  message: ConversationLogMessage;\n  index: number;\n}\n\n// ── chat history sync ────────────────────────────────────────────────────────\n\n/** What one sync pass actually did — the inspectable result of a sync. */\nexport interface ChatSyncReport {\n  /** Log messages appended to the session in this pass. */\n  appended: number;\n  /** The log message id recorded as the new sync watermark. */\n  lastMessageId?: string;\n}\n\nexport interface ChatHistorySyncOptions {\n  recentDays?: number;\n  maxTopLevelMessages?: number;\n  now?: () => Date;\n}\n\nexport interface ResolveChatSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n  /** The triggering platform message ID. History is capped before this turn to avoid future queued turns. */\n  currentMessageId?: string;\n  /** Rotate top-level shared sessions on biweekly Sunday boundaries. */\n  rotateTopLevelSession?: boolean;\n}\n\nexport interface SyncChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  sessionManager: SessionStore;\n  /** The triggering platform message ID. Sync is capped before this turn to avoid future queued turns. */\n  currentMessageId?: string;\n}\n\nexport interface ResetChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface RegisterThreadSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface HasMaterializedSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n}\n\nexport interface ThreadBootstrapWaitOptions {\n  parentSessionKey: string;\n  sessionKey: string;\n  hasThreadSession: () => boolean;\n  isParentRunning: () => boolean;\n  sleep?: (ms: number) => Promise<void>;\n  pollMs?: number;\n}\n"]}

package/dist/settings-mutation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The one writer seam for settings mutations that affect live conversations.
+ * Chat commands (/model, /sandbox) and the Admin portal are adapters here;
+ * none of them call updateConversationSettings/updateGlobalSettings directly
+ * for these keys anymore.
+ *
+ * Policy, uniform across all adapters:
+ * - llm.* changes bake into cached session runners, so a conversation-scoped
+ *   change clears the conversation's cached runners BEFORE writing — and
+ *   refuses (no write, no clear) while the conversation has a running job.
+ *   Disk and cache never disagree.
+ * - Other keys (sandbox mount, slack replyMode, limits) are re-read at use
+ *   time and write without touching runners.
+ * - Global changes always write (the Admin default surface), then clear every
+ *   idle conversation's cached runners; conversations that were busy keep
+ *   their old runner until it settles, are reported as stale, and are cleared
+ *   automatically before their next turn.
+ */
+import { type WorkspacePolicyChoice } from "./config.js";
+import type { Office } from "./office/index.js";
+import type { AgentConfig, GlobalRunnerCacheControl, OfficeAddress, RunnerCacheControl, SettingsApplyResult } from "./types.js";
+export type { GlobalRunnerCacheControl, RunnerCacheControl, SettingsApplyResult } from "./types.js";
+export declare function applyConversationSettings(runtime: RunnerCacheControl | undefined, office: Office, patch: Partial<AgentConfig>): SettingsApplyResult;
+export declare function applyGlobalSettings(runtime: GlobalRunnerCacheControl | undefined, patch: Partial<AgentConfig>): {
+    ok: true;
+    staleConversations: OfficeAddress[];
+};
+/**
+ * Door-policy changes follow the same clear-or-refuse contract as model
+ * changes: the system prompt bakes the workspace projection (layout line,
+ * memory and skill guidance), so the cached runner must clear before the
+ * write, and the container is re-provisioned on the next message when its
+ * mount signature no longer matches.
+ */
+export declare function applyConversationWorkspacePolicy(runtime: RunnerCacheControl | undefined, office: Office, choice: WorkspacePolicyChoice | null): SettingsApplyResult;
+export declare function applyGlobalWorkspacePolicy(runtime: GlobalRunnerCacheControl | undefined, choice: WorkspacePolicyChoice | null): {
+    ok: true;
+    staleConversations: OfficeAddress[];
+};
+//# sourceMappingURL=settings-mutation.d.ts.map

package/dist/settings-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-mutation.d.ts","sourceRoot":"","sources":["../src/settings-mutation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AASpG,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B,mBAAmB,CAYrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,GAAG,SAAS,EAC7C,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,aAAa,EAAE,CAAA;CAAE,CAKnD;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qBAAqB,GAAG,IAAI,GACnC,mBAAmB,CAMrB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,wBAAwB,GAAG,SAAS,EAC7C,MAAM,EAAE,qBAAqB,GAAG,IAAI,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,aAAa,EAAE,CAAA;CAAE,CAInD"}

package/dist/settings-mutation.js

@@ -0,0 +1,61 @@
+/**
+ * The one writer seam for settings mutations that affect live conversations.
+ * Chat commands (/model, /sandbox) and the Admin portal are adapters here;
+ * none of them call updateConversationSettings/updateGlobalSettings directly
+ * for these keys anymore.
+ *
+ * Policy, uniform across all adapters:
+ * - llm.* changes bake into cached session runners, so a conversation-scoped
+ *   change clears the conversation's cached runners BEFORE writing — and
+ *   refuses (no write, no clear) while the conversation has a running job.
+ *   Disk and cache never disagree.
+ * - Other keys (sandbox mount, slack replyMode, limits) are re-read at use
+ *   time and write without touching runners.
+ * - Global changes always write (the Admin default surface), then clear every
+ *   idle conversation's cached runners; conversations that were busy keep
+ *   their old runner until it settles, are reported as stale, and are cleared
+ *   automatically before their next turn.
+ */
+import { setConversationWorkspacePolicy, setGlobalWorkspacePolicy, updateConversationSettings, updateGlobalSettings, } from "./config.js";
+/** True when a patch touches keys a cached session runner bakes in. */
+function affectsCachedRunner(patch) {
+    return (patch.provider !== undefined || patch.model !== undefined || patch.thinkingLevel !== undefined);
+}
+export function applyConversationSettings(runtime, office, patch) {
+    let runtimeSwitched = null;
+    if (affectsCachedRunner(patch) && runtime) {
+        // Clear-or-refuse before writing. The clear and the write happen in the
+        // same synchronous tick, so no runner can be created in between.
+        if (!runtime.switchConversationModel(office.address, patch.provider ?? "", patch.model ?? "")) {
+            return { ok: false, reason: "busy" };
+        }
+        runtimeSwitched = true;
+    }
+    updateConversationSettings(office, patch);
+    return { ok: true, runtimeSwitched };
+}
+export function applyGlobalSettings(runtime, patch) {
+    updateGlobalSettings(patch);
+    const staleConversations = affectsCachedRunner(patch) && runtime ? runtime.refreshAllConversations().busy : [];
+    return { ok: true, staleConversations };
+}
+/**
+ * Door-policy changes follow the same clear-or-refuse contract as model
+ * changes: the system prompt bakes the workspace projection (layout line,
+ * memory and skill guidance), so the cached runner must clear before the
+ * write, and the container is re-provisioned on the next message when its
+ * mount signature no longer matches.
+ */
+export function applyConversationWorkspacePolicy(runtime, office, choice) {
+    if (runtime && !runtime.refreshConversationEnvironment(office.address)) {
+        return { ok: false, reason: "busy" };
+    }
+    setConversationWorkspacePolicy(office, choice);
+    return { ok: true, runtimeSwitched: runtime ? true : null };
+}
+export function applyGlobalWorkspacePolicy(runtime, choice) {
+    setGlobalWorkspacePolicy(choice);
+    const staleConversations = runtime ? runtime.refreshAllConversations().busy : [];
+    return { ok: true, staleConversations };
+}
+//# sourceMappingURL=settings-mutation.js.map

package/dist/settings-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-mutation.js","sourceRoot":"","sources":["../src/settings-mutation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,GAErB,MAAM,aAAa,CAAC;AAYrB,uEAAuE;AACvE,SAAS,mBAAmB,CAAC,KAA2B;IACtD,OAAO,CACL,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,CAC/F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAuC,EACvC,MAAc,EACd,KAA2B;IAE3B,IAAI,eAAe,GAAmB,IAAI,CAAC;IAC3C,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QAC1C,wEAAwE;QACxE,iEAAiE;QACjE,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACvC,CAAC;QACD,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAA6C,EAC7C,KAA2B;IAE3B,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,kBAAkB,GACtB,mBAAmB,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAuC,EACvC,MAAc,EACd,MAAoC;IAEpC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IACD,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA6C,EAC7C,MAAoC;IAEpC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["/**\n * The one writer seam for settings mutations that affect live conversations.\n * Chat commands (/model, /sandbox) and the Admin portal are adapters here;\n * none of them call updateConversationSettings/updateGlobalSettings directly\n * for these keys anymore.\n *\n * Policy, uniform across all adapters:\n * - llm.* changes bake into cached session runners, so a conversation-scoped\n *   change clears the conversation's cached runners BEFORE writing — and\n *   refuses (no write, no clear) while the conversation has a running job.\n *   Disk and cache never disagree.\n * - Other keys (sandbox mount, slack replyMode, limits) are re-read at use\n *   time and write without touching runners.\n * - Global changes always write (the Admin default surface), then clear every\n *   idle conversation's cached runners; conversations that were busy keep\n *   their old runner until it settles, are reported as stale, and are cleared\n *   automatically before their next turn.\n */\nimport {\n  setConversationWorkspacePolicy,\n  setGlobalWorkspacePolicy,\n  updateConversationSettings,\n  updateGlobalSettings,\n  type WorkspacePolicyChoice,\n} from \"./config.js\";\nimport type { Office } from \"./office/index.js\";\nimport type {\n  AgentConfig,\n  GlobalRunnerCacheControl,\n  OfficeAddress,\n  RunnerCacheControl,\n  SettingsApplyResult,\n} from \"./types.js\";\n\nexport type { GlobalRunnerCacheControl, RunnerCacheControl, SettingsApplyResult } from \"./types.js\";\n\n/** True when a patch touches keys a cached session runner bakes in. */\nfunction affectsCachedRunner(patch: Partial<AgentConfig>): boolean {\n  return (\n    patch.provider !== undefined || patch.model !== undefined || patch.thinkingLevel !== undefined\n  );\n}\n\nexport function applyConversationSettings(\n  runtime: RunnerCacheControl | undefined,\n  office: Office,\n  patch: Partial<AgentConfig>,\n): SettingsApplyResult {\n  let runtimeSwitched: boolean | null = null;\n  if (affectsCachedRunner(patch) && runtime) {\n    // Clear-or-refuse before writing. The clear and the write happen in the\n    // same synchronous tick, so no runner can be created in between.\n    if (!runtime.switchConversationModel(office.address, patch.provider ?? \"\", patch.model ?? \"\")) {\n      return { ok: false, reason: \"busy\" };\n    }\n    runtimeSwitched = true;\n  }\n  updateConversationSettings(office, patch);\n  return { ok: true, runtimeSwitched };\n}\n\nexport function applyGlobalSettings(\n  runtime: GlobalRunnerCacheControl | undefined,\n  patch: Partial<AgentConfig>,\n): { ok: true; staleConversations: OfficeAddress[] } {\n  updateGlobalSettings(patch);\n  const staleConversations =\n    affectsCachedRunner(patch) && runtime ? runtime.refreshAllConversations().busy : [];\n  return { ok: true, staleConversations };\n}\n\n/**\n * Door-policy changes follow the same clear-or-refuse contract as model\n * changes: the system prompt bakes the workspace projection (layout line,\n * memory and skill guidance), so the cached runner must clear before the\n * write, and the container is re-provisioned on the next message when its\n * mount signature no longer matches.\n */\nexport function applyConversationWorkspacePolicy(\n  runtime: RunnerCacheControl | undefined,\n  office: Office,\n  choice: WorkspacePolicyChoice | null,\n): SettingsApplyResult {\n  if (runtime && !runtime.refreshConversationEnvironment(office.address)) {\n    return { ok: false, reason: \"busy\" };\n  }\n  setConversationWorkspacePolicy(office, choice);\n  return { ok: true, runtimeSwitched: runtime ? true : null };\n}\n\nexport function applyGlobalWorkspacePolicy(\n  runtime: GlobalRunnerCacheControl | undefined,\n  choice: WorkspacePolicyChoice | null,\n): { ok: true; staleConversations: OfficeAddress[] } {\n  setGlobalWorkspacePolicy(choice);\n  const staleConversations = runtime ? runtime.refreshAllConversations().busy : [];\n  return { ok: true, staleConversations };\n}\n"]}

package/dist/subagent-progress.d.ts

@@ -0,0 +1,39 @@
+import type { SubagentProgressNode, SubagentProgressSnapshot } from "./types.js";
+/**
+ * The subagent progress snapshot module. The snapshot crosses an untyped
+ * transport (tool update `details`) between the subagent tool and the harness,
+ * so producer construction, consumer parsing, display bounds, the
+ * status→presentation tables, settling, merging, and the response-source
+ * rendering all live here — one module owns the shape end to end. Every
+ * adapter now takes the same Markdown dashboard, so nothing is exported for
+ * a caller to re-render from parts.
+ */
+/** Longest label the dashboard renders; longer ones are clamped, never rejected. */
+export declare const MAX_SUBAGENT_LABEL_CHARS = 100;
+/** Clamp a label to the display bound, ending a truncation visibly with `…`. */
+export declare function clampSubagentLabel(label: string): string;
+/** The display bounds, applied once at construction and again on parse. */
+export declare function boundSubagentProgressNode(node: SubagentProgressNode): SubagentProgressNode;
+/**
+ * Parse a snapshot back off the untyped transport. All-or-nothing: one
+ * malformed node means the payload is not ours (any tool can put anything in
+ * `details`), so the whole candidate is rejected rather than partially shown.
+ */
+export declare function parseSubagentProgressSnapshot(value: unknown): SubagentProgressSnapshot | undefined;
+/**
+ * Project a live snapshot to its end-of-tool state: nodes still pending or
+ * running settle to the tool call's outcome. Metrics spread through
+ * unchanged — an unsettled node never reported any.
+ */
+export declare function settleSubagentProgress(snapshot: SubagentProgressSnapshot, isError: boolean): SubagentProgressSnapshot;
+/**
+ * Fold concurrent or successive subagent fan-outs into the single snapshot the
+ * dashboard renders. A run can call the subagent tool more than once; picking
+ * one snapshot would drop the others' cost and status, and alternating between
+ * them makes the live view flicker. Node ids are namespaced by source because
+ * each fan-out numbers its own nodes from zero.
+ */
+export declare function mergeSubagentProgress(snapshots: readonly SubagentProgressSnapshot[]): SubagentProgressSnapshot | undefined;
+/** The dashboard as response source Markdown; adapters own any conversion. */
+export declare function renderSubagentDashboard(snapshot: SubagentProgressSnapshot): string;
+//# sourceMappingURL=subagent-progress.d.ts.map

package/dist/subagent-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-progress.d.ts","sourceRoot":"","sources":["../src/subagent-progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,wBAAwB,EAEzB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AAEH,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAoC5C,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,oBAAoB,GAAG,oBAAoB,CAU1F;AAsCD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,OAAO,GACb,wBAAwB,GAAG,SAAS,CAgBtC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE,OAAO,GACf,wBAAwB,CAS1B;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,SAAS,wBAAwB,EAAE,GAC7C,wBAAwB,GAAG,SAAS,CAYtC;AAoFD,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAOlF"}

package/dist/subagent-progress.js

@@ -0,0 +1,225 @@
+/**
+ * The subagent progress snapshot module. The snapshot crosses an untyped
+ * transport (tool update `details`) between the subagent tool and the harness,
+ * so producer construction, consumer parsing, display bounds, the
+ * status→presentation tables, settling, merging, and the response-source
+ * rendering all live here — one module owns the shape end to end. Every
+ * adapter now takes the same Markdown dashboard, so nothing is exported for
+ * a caller to re-render from parts.
+ */
+/** Longest label the dashboard renders; longer ones are clamped, never rejected. */
+export const MAX_SUBAGENT_LABEL_CHARS = 100;
+const MAX_PROFILE_CHARS = 64;
+const MAX_REASON_CHARS = 240;
+const MAX_ACTIVITY_CHARS = 80;
+const SUBAGENT_STATUS_MARKER = {
+    pending: "○",
+    running: "●",
+    completed: "✓",
+    failed: "✗",
+    cancelled: "■",
+    timeout: "◷",
+    budget_exceeded: "!",
+    invalid_output: "✗",
+    skipped: "⊘",
+};
+const SUBAGENT_STATUS_LABEL = {
+    pending: "Waiting",
+    running: "Running",
+    completed: "Completed",
+    failed: "Failed",
+    cancelled: "Cancelled",
+    timeout: "Timed out",
+    budget_exceeded: "Budget exceeded",
+    invalid_output: "Invalid output",
+    skipped: "Skipped",
+};
+/**
+ * Derived from the marker table, which `satisfies` keeps exhaustive: a new
+ * terminal status is a compile error there, and this runtime set follows —
+ * the validator can never silently drop a status the tables know about.
+ */
+const VALID_STATUSES = new Set(Object.keys(SUBAGENT_STATUS_MARKER));
+/** Clamp a label to the display bound, ending a truncation visibly with `…`. */
+export function clampSubagentLabel(label) {
+    if (label.length <= MAX_SUBAGENT_LABEL_CHARS)
+        return label;
+    return `${label.slice(0, MAX_SUBAGENT_LABEL_CHARS - 1)}…`;
+}
+/** The display bounds, applied once at construction and again on parse. */
+export function boundSubagentProgressNode(node) {
+    return {
+        ...node,
+        label: clampSubagentLabel(node.label),
+        ...(node.profile !== undefined ? { profile: node.profile.slice(0, MAX_PROFILE_CHARS) } : {}),
+        ...(node.activity !== undefined
+            ? { activity: node.activity.slice(0, MAX_ACTIVITY_CHARS) }
+            : {}),
+        ...(node.reason !== undefined ? { reason: node.reason.slice(0, MAX_REASON_CHARS) } : {}),
+    };
+}
+function parseNode(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const item = value;
+    if (typeof item.id !== "string" ||
+        typeof item.label !== "string" ||
+        typeof item.status !== "string" ||
+        !VALID_STATUSES.has(item.status)) {
+        return undefined;
+    }
+    return boundSubagentProgressNode({
+        id: item.id,
+        label: item.label,
+        status: item.status,
+        ...(typeof item.profile === "string" ? { profile: item.profile } : {}),
+        ...(typeof item.turns === "number" ? { turns: item.turns } : {}),
+        ...(typeof item.toolCalls === "number" ? { toolCalls: item.toolCalls } : {}),
+        ...(item.toolCallCounts && typeof item.toolCallCounts === "object"
+            ? {
+                toolCallCounts: Object.fromEntries(Object.entries(item.toolCallCounts).filter((entry) => typeof entry[1] === "number")),
+            }
+            : {}),
+        ...(typeof item.tokens === "number" ? { tokens: item.tokens } : {}),
+        ...(typeof item.costUsd === "number" ? { costUsd: item.costUsd } : {}),
+        ...(typeof item.durationMs === "number" ? { durationMs: item.durationMs } : {}),
+        ...(typeof item.activity === "string" ? { activity: item.activity } : {}),
+        ...(typeof item.reason === "string" ? { reason: item.reason } : {}),
+        ...(item.cleanupPending === true ? { cleanupPending: true } : {}),
+    });
+}
+/**
+ * Parse a snapshot back off the untyped transport. All-or-nothing: one
+ * malformed node means the payload is not ours (any tool can put anything in
+ * `details`), so the whole candidate is rejected rather than partially shown.
+ */
+export function parseSubagentProgressSnapshot(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const candidate = value;
+    if ((candidate.mode !== "single" && candidate.mode !== "parallel" && candidate.mode !== "dag") ||
+        !Array.isArray(candidate.nodes)) {
+        return undefined;
+    }
+    const nodes = [];
+    for (const node of candidate.nodes) {
+        const parsed = parseNode(node);
+        if (!parsed)
+            return undefined;
+        nodes.push(parsed);
+    }
+    return { mode: candidate.mode, nodes };
+}
+/**
+ * Project a live snapshot to its end-of-tool state: nodes still pending or
+ * running settle to the tool call's outcome. Metrics spread through
+ * unchanged — an unsettled node never reported any.
+ */
+export function settleSubagentProgress(snapshot, isError) {
+    return {
+        ...snapshot,
+        nodes: snapshot.nodes.map((node) => node.status !== "running" && node.status !== "pending"
+            ? node
+            : { ...node, status: isError ? "failed" : "completed" }),
+    };
+}
+/**
+ * Fold concurrent or successive subagent fan-outs into the single snapshot the
+ * dashboard renders. A run can call the subagent tool more than once; picking
+ * one snapshot would drop the others' cost and status, and alternating between
+ * them makes the live view flicker. Node ids are namespaced by source because
+ * each fan-out numbers its own nodes from zero.
+ */
+export function mergeSubagentProgress(snapshots) {
+    if (snapshots.length === 0)
+        return undefined;
+    if (snapshots.length === 1)
+        return snapshots[0];
+    const nodes = snapshots.flatMap((snapshot, index) => snapshot.nodes.map((node) => ({ ...node, id: `${index}:${node.id}` })));
+    const mode = snapshots.some((snapshot) => snapshot.mode === "dag")
+        ? "dag"
+        : nodes.length > 1
+            ? "parallel"
+            : "single";
+    return { mode, nodes };
+}
+// ---------------------------------------------------------------------------
+// Dashboard text
+// ---------------------------------------------------------------------------
+function settledCount(snapshot) {
+    return snapshot.nodes.filter((node) => node.status !== "pending" && node.status !== "running")
+        .length;
+}
+function modeLabel(snapshot) {
+    if (snapshot.mode === "dag")
+        return "DAG";
+    if (snapshot.mode === "parallel")
+        return "Parallel";
+    return "Run";
+}
+function escapeMarkdown(text) {
+    return text.replace(/([\\`*_{}[\]()<>#+\-.!|~])/g, "\\$1");
+}
+function compactNumber(value) {
+    return new Intl.NumberFormat("en", { notation: "compact", maximumFractionDigits: 1 }).format(value);
+}
+function summaryText(snapshot) {
+    const totals = snapshot.nodes.reduce((sum, node) => ({
+        turns: sum.turns + (node.turns ?? 0),
+        toolCalls: sum.toolCalls + (node.toolCalls ?? 0),
+        tokens: sum.tokens + (node.tokens ?? 0),
+        costUsd: sum.costUsd + (node.costUsd ?? 0),
+    }), { turns: 0, toolCalls: 0, tokens: 0, costUsd: 0 });
+    return [
+        totals.turns > 0 ? `${totals.turns} LLM turns` : undefined,
+        totals.toolCalls > 0 ? `${totals.toolCalls} tool calls` : undefined,
+        totals.tokens > 0 ? `${compactNumber(totals.tokens)} tokens` : undefined,
+        totals.costUsd > 0 ? `$${totals.costUsd.toFixed(4)}` : undefined,
+    ]
+        .filter(Boolean)
+        .join(" · ");
+}
+/** The dashboard's one-line summary header, unformatted. */
+function dashboardHeader(snapshot) {
+    const base = `Subagents · ${settledCount(snapshot)}/${snapshot.nodes.length} · ${modeLabel(snapshot)}`;
+    const summary = summaryText(snapshot);
+    return summary ? `${base} · ${summary}` : base;
+}
+function countLabel(count, singular) {
+    return `${count} ${singular}${count === 1 ? "" : "s"}`;
+}
+function detailText(node) {
+    const toolBreakdown = node.toolCallCounts
+        ? Object.entries(node.toolCallCounts)
+            .map(([name, count]) => `${name} ×${count}`)
+            .join(" · ")
+        : undefined;
+    const metrics = [
+        node.turns !== undefined ? countLabel(node.turns, "LLM turn") : undefined,
+        node.toolCalls !== undefined ? countLabel(node.toolCalls, "tool call") : undefined,
+        toolBreakdown,
+        node.tokens !== undefined ? `${compactNumber(node.tokens)} tokens` : undefined,
+        node.costUsd !== undefined ? `$${node.costUsd.toFixed(4)}` : undefined,
+        node.durationMs !== undefined ? `${(node.durationMs / 1000).toFixed(1)}s` : undefined,
+    ].filter(Boolean);
+    const reason = node.cleanupPending ? "Cleanup pending; usage is provisional" : node.reason;
+    // Activity is shown only while running, and that is exactly when there is
+    // nothing else: a node reports its metrics on the way out, so without this
+    // the whole of a long step reads "Running · profile" and never changes.
+    const activity = node.status === "running" ? node.activity : undefined;
+    // Profile leads the line: when a node reports no tool calls, the profile is
+    // what says whether that was the plan or a bad pick.
+    return [SUBAGENT_STATUS_LABEL[node.status], node.profile, activity, ...metrics, reason]
+        .filter(Boolean)
+        .join(" · ");
+}
+/** The dashboard as response source Markdown; adapters own any conversion. */
+export function renderSubagentDashboard(snapshot) {
+    const header = `**${dashboardHeader(snapshot)}**`;
+    const rows = snapshot.nodes.flatMap((node) => [
+        `${SUBAGENT_STATUS_MARKER[node.status]} ${escapeMarkdown(node.label)}`,
+        `└ ${detailText(node)}`,
+    ]);
+    return [header, ...rows].join("\n");
+}
+//# sourceMappingURL=subagent-progress.js.map

package/dist/subagent-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-progress.js","sourceRoot":"","sources":["../src/subagent-progress.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  SubagentProgressNode,\n  SubagentProgressSnapshot,\n  SubagentProgressStatus,\n} from \"./types.js\";\n\n/**\n * The subagent progress snapshot module. The snapshot crosses an untyped\n * transport (tool update `details`) between the subagent tool and the harness,\n * so producer construction, consumer parsing, display bounds, the\n * status→presentation tables, settling, merging, and the response-source\n * rendering all live here — one module owns the shape end to end. Every\n * adapter now takes the same Markdown dashboard, so nothing is exported for\n * a caller to re-render from parts.\n */\n\n/** Longest label the dashboard renders; longer ones are clamped, never rejected. */\nexport const MAX_SUBAGENT_LABEL_CHARS = 100;\nconst MAX_PROFILE_CHARS = 64;\nconst MAX_REASON_CHARS = 240;\nconst MAX_ACTIVITY_CHARS = 80;\n\nconst SUBAGENT_STATUS_MARKER = {\n  pending: \"○\",\n  running: \"●\",\n  completed: \"✓\",\n  failed: \"✗\",\n  cancelled: \"■\",\n  timeout: \"◷\",\n  budget_exceeded: \"!\",\n  invalid_output: \"✗\",\n  skipped: \"⊘\",\n} satisfies Record<SubagentProgressStatus, string>;\n\nconst SUBAGENT_STATUS_LABEL = {\n  pending: \"Waiting\",\n  running: \"Running\",\n  completed: \"Completed\",\n  failed: \"Failed\",\n  cancelled: \"Cancelled\",\n  timeout: \"Timed out\",\n  budget_exceeded: \"Budget exceeded\",\n  invalid_output: \"Invalid output\",\n  skipped: \"Skipped\",\n} satisfies Record<SubagentProgressStatus, string>;\n\n/**\n * Derived from the marker table, which `satisfies` keeps exhaustive: a new\n * terminal status is a compile error there, and this runtime set follows —\n * the validator can never silently drop a status the tables know about.\n */\nconst VALID_STATUSES: ReadonlySet<string> = new Set(Object.keys(SUBAGENT_STATUS_MARKER));\n\n/** Clamp a label to the display bound, ending a truncation visibly with `…`. */\nexport function clampSubagentLabel(label: string): string {\n  if (label.length <= MAX_SUBAGENT_LABEL_CHARS) return label;\n  return `${label.slice(0, MAX_SUBAGENT_LABEL_CHARS - 1)}…`;\n}\n\n/** The display bounds, applied once at construction and again on parse. */\nexport function boundSubagentProgressNode(node: SubagentProgressNode): SubagentProgressNode {\n  return {\n    ...node,\n    label: clampSubagentLabel(node.label),\n    ...(node.profile !== undefined ? { profile: node.profile.slice(0, MAX_PROFILE_CHARS) } : {}),\n    ...(node.activity !== undefined\n      ? { activity: node.activity.slice(0, MAX_ACTIVITY_CHARS) }\n      : {}),\n    ...(node.reason !== undefined ? { reason: node.reason.slice(0, MAX_REASON_CHARS) } : {}),\n  };\n}\n\nfunction parseNode(value: unknown): SubagentProgressNode | undefined {\n  if (!value || typeof value !== \"object\") return undefined;\n  const item = value as Record<keyof SubagentProgressNode, unknown>;\n  if (\n    typeof item.id !== \"string\" ||\n    typeof item.label !== \"string\" ||\n    typeof item.status !== \"string\" ||\n    !VALID_STATUSES.has(item.status)\n  ) {\n    return undefined;\n  }\n  return boundSubagentProgressNode({\n    id: item.id,\n    label: item.label,\n    status: item.status as SubagentProgressStatus,\n    ...(typeof item.profile === \"string\" ? { profile: item.profile } : {}),\n    ...(typeof item.turns === \"number\" ? { turns: item.turns } : {}),\n    ...(typeof item.toolCalls === \"number\" ? { toolCalls: item.toolCalls } : {}),\n    ...(item.toolCallCounts && typeof item.toolCallCounts === \"object\"\n      ? {\n          toolCallCounts: Object.fromEntries(\n            Object.entries(item.toolCallCounts).filter(\n              (entry): entry is [string, number] => typeof entry[1] === \"number\",\n            ),\n          ),\n        }\n      : {}),\n    ...(typeof item.tokens === \"number\" ? { tokens: item.tokens } : {}),\n    ...(typeof item.costUsd === \"number\" ? { costUsd: item.costUsd } : {}),\n    ...(typeof item.durationMs === \"number\" ? { durationMs: item.durationMs } : {}),\n    ...(typeof item.activity === \"string\" ? { activity: item.activity } : {}),\n    ...(typeof item.reason === \"string\" ? { reason: item.reason } : {}),\n    ...(item.cleanupPending === true ? { cleanupPending: true } : {}),\n  });\n}\n\n/**\n * Parse a snapshot back off the untyped transport. All-or-nothing: one\n * malformed node means the payload is not ours (any tool can put anything in\n * `details`), so the whole candidate is rejected rather than partially shown.\n */\nexport function parseSubagentProgressSnapshot(\n  value: unknown,\n): SubagentProgressSnapshot | undefined {\n  if (!value || typeof value !== \"object\") return undefined;\n  const candidate = value as { mode?: unknown; nodes?: unknown };\n  if (\n    (candidate.mode !== \"single\" && candidate.mode !== \"parallel\" && candidate.mode !== \"dag\") ||\n    !Array.isArray(candidate.nodes)\n  ) {\n    return undefined;\n  }\n  const nodes: SubagentProgressNode[] = [];\n  for (const node of candidate.nodes) {\n    const parsed = parseNode(node);\n    if (!parsed) return undefined;\n    nodes.push(parsed);\n  }\n  return { mode: candidate.mode, nodes };\n}\n\n/**\n * Project a live snapshot to its end-of-tool state: nodes still pending or\n * running settle to the tool call's outcome. Metrics spread through\n * unchanged — an unsettled node never reported any.\n */\nexport function settleSubagentProgress(\n  snapshot: SubagentProgressSnapshot,\n  isError: boolean,\n): SubagentProgressSnapshot {\n  return {\n    ...snapshot,\n    nodes: snapshot.nodes.map((node) =>\n      node.status !== \"running\" && node.status !== \"pending\"\n        ? node\n        : { ...node, status: isError ? \"failed\" : \"completed\" },\n    ),\n  };\n}\n\n/**\n * Fold concurrent or successive subagent fan-outs into the single snapshot the\n * dashboard renders. A run can call the subagent tool more than once; picking\n * one snapshot would drop the others' cost and status, and alternating between\n * them makes the live view flicker. Node ids are namespaced by source because\n * each fan-out numbers its own nodes from zero.\n */\nexport function mergeSubagentProgress(\n  snapshots: readonly SubagentProgressSnapshot[],\n): SubagentProgressSnapshot | undefined {\n  if (snapshots.length === 0) return undefined;\n  if (snapshots.length === 1) return snapshots[0];\n  const nodes = snapshots.flatMap((snapshot, index) =>\n    snapshot.nodes.map((node) => ({ ...node, id: `${index}:${node.id}` })),\n  );\n  const mode = snapshots.some((snapshot) => snapshot.mode === \"dag\")\n    ? \"dag\"\n    : nodes.length > 1\n      ? \"parallel\"\n      : \"single\";\n  return { mode, nodes };\n}\n\n// ---------------------------------------------------------------------------\n// Dashboard text\n// ---------------------------------------------------------------------------\n\nfunction settledCount(snapshot: SubagentProgressSnapshot): number {\n  return snapshot.nodes.filter((node) => node.status !== \"pending\" && node.status !== \"running\")\n    .length;\n}\n\nfunction modeLabel(snapshot: SubagentProgressSnapshot): string {\n  if (snapshot.mode === \"dag\") return \"DAG\";\n  if (snapshot.mode === \"parallel\") return \"Parallel\";\n  return \"Run\";\n}\n\nfunction escapeMarkdown(text: string): string {\n  return text.replace(/([\\\\`*_{}[\\]()<>#+\\-.!|~])/g, \"\\\\$1\");\n}\n\nfunction compactNumber(value: number): string {\n  return new Intl.NumberFormat(\"en\", { notation: \"compact\", maximumFractionDigits: 1 }).format(\n    value,\n  );\n}\n\nfunction summaryText(snapshot: SubagentProgressSnapshot): string {\n  const totals = snapshot.nodes.reduce(\n    (sum, node) => ({\n      turns: sum.turns + (node.turns ?? 0),\n      toolCalls: sum.toolCalls + (node.toolCalls ?? 0),\n      tokens: sum.tokens + (node.tokens ?? 0),\n      costUsd: sum.costUsd + (node.costUsd ?? 0),\n    }),\n    { turns: 0, toolCalls: 0, tokens: 0, costUsd: 0 },\n  );\n  return [\n    totals.turns > 0 ? `${totals.turns} LLM turns` : undefined,\n    totals.toolCalls > 0 ? `${totals.toolCalls} tool calls` : undefined,\n    totals.tokens > 0 ? `${compactNumber(totals.tokens)} tokens` : undefined,\n    totals.costUsd > 0 ? `$${totals.costUsd.toFixed(4)}` : undefined,\n  ]\n    .filter(Boolean)\n    .join(\" · \");\n}\n\n/** The dashboard's one-line summary header, unformatted. */\nfunction dashboardHeader(snapshot: SubagentProgressSnapshot): string {\n  const base = `Subagents · ${settledCount(snapshot)}/${snapshot.nodes.length} · ${modeLabel(snapshot)}`;\n  const summary = summaryText(snapshot);\n  return summary ? `${base} · ${summary}` : base;\n}\n\nfunction countLabel(count: number, singular: string): string {\n  return `${count} ${singular}${count === 1 ? \"\" : \"s\"}`;\n}\n\nfunction detailText(node: SubagentProgressNode): string {\n  const toolBreakdown = node.toolCallCounts\n    ? Object.entries(node.toolCallCounts)\n        .map(([name, count]) => `${name} ×${count}`)\n        .join(\" · \")\n    : undefined;\n  const metrics = [\n    node.turns !== undefined ? countLabel(node.turns, \"LLM turn\") : undefined,\n    node.toolCalls !== undefined ? countLabel(node.toolCalls, \"tool call\") : undefined,\n    toolBreakdown,\n    node.tokens !== undefined ? `${compactNumber(node.tokens)} tokens` : undefined,\n    node.costUsd !== undefined ? `$${node.costUsd.toFixed(4)}` : undefined,\n    node.durationMs !== undefined ? `${(node.durationMs / 1000).toFixed(1)}s` : undefined,\n  ].filter(Boolean);\n  const reason = node.cleanupPending ? \"Cleanup pending; usage is provisional\" : node.reason;\n  // Activity is shown only while running, and that is exactly when there is\n  // nothing else: a node reports its metrics on the way out, so without this\n  // the whole of a long step reads \"Running · profile\" and never changes.\n  const activity = node.status === \"running\" ? node.activity : undefined;\n  // Profile leads the line: when a node reports no tool calls, the profile is\n  // what says whether that was the plan or a bad pick.\n  return [SUBAGENT_STATUS_LABEL[node.status], node.profile, activity, ...metrics, reason]\n    .filter(Boolean)\n    .join(\" · \");\n}\n\n/** The dashboard as response source Markdown; adapters own any conversion. */\nexport function renderSubagentDashboard(snapshot: SubagentProgressSnapshot): string {\n  const header = `**${dashboardHeader(snapshot)}**`;\n  const rows = snapshot.nodes.flatMap((node) => [\n    `${SUBAGENT_STATUS_MARKER[node.status]} ${escapeMarkdown(node.label)}`,\n    `└ ${detailText(node)}`,\n  ]);\n  return [header, ...rows].join(\"\\n\");\n}\n"]}

package/dist/tools/bash.d.ts

@@ -5,6 +5,8 @@ declare const bashSchema: import("@sinclair/typebox").TObject<{
     command: import("@sinclair/typebox").TString;
     timeout: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
 }>;
-export declare function createBashTool(executor: Executor): AgentTool<typeof bashSchema>;
+export declare function createBashTool(executor: Executor, options?: {
+    hostWorkspaceRoot?: string;
+}): AgentTool<typeof bashSchema>;
 export {};
 //# sourceMappingURL=bash.d.ts.map

package/dist/tools/bash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiBpD,QAAA,MAAM,UAAU;;;;EAQd,CAAC;AAOH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC,OAAO,UAAU,CAAC,CAsE/E"}
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAmBpD,QAAA,MAAM,UAAU;;;;EAQd,CAAC;AAOH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;IAAE,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,SAAS,CAAC,OAAO,UAAU,CAAC,CAgF9B"}