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

package/dist/adapters/telegram/context.js

@@ -1,22 +1,10 @@
-import * as log from "../../log.js";
-import { createChatResponseErrorReporter, formatToolArgs, splitText } from "../shared.js";
-import { BufferedResponseStream, OrderedResponseOperations } from "../streaming.js";
 import { deriveSessionKey } from "../../sessions/session-key.js";
+import { createBufferedResponder } from "../buffered-responder.js";
+import { createChatResponseErrorReporter, formatToolArgs } from "../shared.js";
 import { sanitizeTelegramHtml } from "./html.js";
 // Telegram message length limit is 4096 chars; 3800 leaves headroom for HTML escapes.
 const MAX_LENGTH = 3800;
 const formatTelegramContinuation = (partNum) => `(continued ${partNum})`;
-async function notifyError(bot, chatId, label, err, report) {
-    const errMsg = err instanceof Error ? err.message : String(err);
-    log.logWarning(`Telegram ${label} error`, errMsg);
-    report?.();
-    try {
-        await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errMsg}`);
-    }
-    catch {
-        // ignore secondary failure
-    }
-}
 function formatToolResult(result) {
     const argsFormatted = formatToolArgs(result.args);
     const duration = (result.durationMs / 1000).toFixed(1);
@@ -24,17 +12,6 @@ function formatToolResult(result) {
     return [title, argsFormatted, result.result].filter(Boolean).join("\n\n");
 }
 export function createTelegramAdapters(event, bot) {
-    let messageId = null;
-    let accumulatedText = "";
-    const responseOperations = new OrderedResponseOperations();
-    let typingInterval = null;
-    let typingFailureWarned = false;
-    function stopTyping() {
-        if (typingInterval !== null) {
-            clearInterval(typingInterval);
-            typingInterval = null;
-        }
-    }
     const conversationId = event.conversationId;
     const chatId = parseInt(conversationId);
     const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;
@@ -50,145 +27,50 @@ export function createTelegramAdapters(event, bot) {
     };
     // The bot's getMessagingInfo() is the single authority for platform info.
     const platform = bot.getMessagingInfo();
-    async function sendContinuation(text) {
-        await bot.postMessageRaw(chatId, text);
-    }
-    async function sendOrUpdate(displayText) {
-        if (messageId !== null) {
-            await bot.updateMessage(conversationId, String(messageId), displayText);
-        }
-        else if (replyToId !== null) {
-            messageId = await bot.postReply(chatId, replyToId, displayText);
-        }
-        else {
-            messageId = await bot.postMessageRaw(chatId, displayText);
-        }
-    }
+    let currentResponseId = null;
     const reportResponseError = createChatResponseErrorReporter(() => ({
         platform: "telegram",
         conversationId,
         chatId,
         messageId: message.id,
         sessionKey: message.sessionKey,
-        responseMessageId: messageId,
+        responseMessageId: currentResponseId,
         replyToId,
         conversationKind: message.conversationKind,
     }));
-    const sendSplitText = async (text, firstPart) => {
-        const [head, ...tail] = splitText(text, MAX_LENGTH, formatTelegramContinuation);
-        await firstPart(head);
-        for (const part of tail) {
-            await sendContinuation(part);
-        }
-    };
-    const stream = new BufferedResponseStream({
-        flush: async (text) => {
-            await sendSplitText(text, sendOrUpdate);
-        },
-        finish: async (text) => {
-            stopTyping();
-            await sendSplitText(text, sendOrUpdate);
-        },
-    });
-    const queueTelegramSend = (label, work, report) => responseOperations.run(work, (err) => notifyError(bot, chatId, label, err, () => report(err)));
-    const responder = {
-        respond: async (text) => {
-            await queueTelegramSend("respond", async () => {
-                const sanitized = sanitizeTelegramHtml(text);
-                accumulatedText = accumulatedText ? `${accumulatedText}\n${sanitized}` : sanitized;
-                stream.setText(accumulatedText);
-                await sendSplitText(accumulatedText, sendOrUpdate);
-                if (messageId !== null) {
-                    bot.logBotResponse(conversationId, text, String(messageId));
-                }
-            }, (err) => reportResponseError(err, "respond", {
-                phase: messageId ? "update" : "initial_post",
-                textLength: text.length,
-                accumulatedLength: accumulatedText.length,
-            }));
-        },
-        appendResponseDelta: async (delta) => {
-            await queueTelegramSend("appendResponseDelta", async () => {
-                const sanitized = sanitizeTelegramHtml(delta);
-                await stream.append(sanitized);
-                accumulatedText = stream.getText();
-                if (messageId !== null) {
-                    bot.logBotResponse(conversationId, delta, String(messageId));
-                }
-            }, (err) => reportResponseError(err, "respond", {
-                textLength: delta.length,
-                accumulatedLength: stream.getText().length,
-            }));
-        },
-        finishResponse: async (finalText) => {
-            await queueTelegramSend("finishResponse", async () => {
-                await stream.finish(finalText === undefined ? undefined : sanitizeTelegramHtml(finalText));
-                accumulatedText = stream.getText();
-            }, (err) => reportResponseError(err, "set_working", {
-                finalTextLength: finalText?.length,
-            }));
+    const { responder } = createBufferedResponder({
+        label: "Telegram",
+        maxLength: MAX_LENGTH,
+        formatContinuation: formatTelegramContinuation,
+        errorPrefix: "Error: ",
+        sanitize: sanitizeTelegramHtml,
+        streaming: true,
+        typing: {
+            // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)
+            send: () => bot.sendTyping(chatId),
+            intervalMs: 4000,
         },
-        replaceResponse: async (text) => {
-            await queueTelegramSend("replaceResponse", async () => {
-                accumulatedText = sanitizeTelegramHtml(text);
-                stream.setText(accumulatedText);
-                await sendSplitText(accumulatedText, sendOrUpdate);
-            }, (err) => reportResponseError(err, "replace_response", {
-                textLength: text.length,
-                hadExistingResponse: Boolean(messageId),
-            }));
+        formatToolResult,
+        reportError: reportResponseError,
+        notifySendFailure: async (errorMessage) => {
+            await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errorMessage}`);
         },
-        respondDiagnostic: async (text, options) => {
-            await queueTelegramSend("respondDiagnostic", async () => {
-                const prefix = options?.style === "error" ? "Error: " : "";
-                await sendSplitText(sanitizeTelegramHtml(`${prefix}${text}`), sendContinuation);
-            }, (err) => reportResponseError(err, "respond_diagnostic", {
-                textLength: text.length,
-                style: options?.style,
-            }));
+        post: async (text) => {
+            const id = replyToId !== null
+                ? await bot.postReply(chatId, replyToId, text)
+                : await bot.postMessageRaw(chatId, text);
+            currentResponseId = String(id);
+            return currentResponseId;
         },
-        respondToolResult: async (result) => {
-            await responder.respondDiagnostic(formatToolResult(result));
+        update: (id, text) => bot.updateMessage(conversationId, id, text),
+        postExtra: (text) => bot.postMessageRaw(chatId, text),
+        delete: async (id) => {
+            await bot.deleteMessageRaw(chatId, Number(id));
+            currentResponseId = null;
         },
-        setTyping: async (isTyping) => {
-            const onTypingError = (err) => {
-                if (typingFailureWarned)
-                    return;
-                typingFailureWarned = true;
-                log.logWarning("Telegram sendTyping failed (further occurrences suppressed for this session)", err instanceof Error ? err.message : String(err));
-            };
-            if (isTyping && typingInterval === null) {
-                // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)
-                bot.sendTyping(chatId).catch(onTypingError);
-                typingInterval = setInterval(() => {
-                    bot.sendTyping(chatId).catch(onTypingError);
-                }, 4000);
-            }
-            else if (!isTyping) {
-                stopTyping();
-            }
-        },
-        setWorking: async (working) => {
-            if (!working)
-                stopTyping();
-        },
-        uploadFile: async (filePath, title) => {
-            await bot.uploadFile(conversationId, filePath, title);
-        },
-        deleteResponse: async () => {
-            await responseOperations.run(async () => {
-                if (messageId !== null) {
-                    try {
-                        await bot.deleteMessageRaw(chatId, messageId);
-                    }
-                    catch {
-                        // Ignore errors
-                    }
-                    messageId = null;
-                }
-            });
-        },
-    };
+        logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),
+        uploadFile: (filePath, title) => bot.uploadFile(conversationId, filePath, title),
+    });
     return { message, responder, platform };
 }
 //# sourceMappingURL=context.js.map

package/dist/adapters/telegram/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ConversationMessage,\n  ConversationResponder,\n  ChatToolResult,\n  MessagingInfo,\n} from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { createChatResponseErrorReporter, formatToolArgs, splitText } from \"../shared.js\";\nimport { BufferedResponseStream, OrderedResponseOperations } from \"../streaming.js\";\nimport { deriveSessionKey } from \"../../sessions/session-key.js\";\nimport { sanitizeTelegramHtml } from \"./html.js\";\nimport type { TelegramMessagingBot, TelegramEvent } from \"./bot.js\";\n\n// Telegram message length limit is 4096 chars; 3800 leaves headroom for HTML escapes.\nconst MAX_LENGTH = 3800;\n\nconst formatTelegramContinuation = (partNum: number): string => `(continued ${partNum})`;\n\nasync function notifyError(\n  bot: TelegramMessagingBot,\n  chatId: number,\n  label: string,\n  err: unknown,\n  report?: () => void,\n): Promise<void> {\n  const errMsg = err instanceof Error ? err.message : String(err);\n  log.logWarning(`Telegram ${label} error`, errMsg);\n  report?.();\n  try {\n    await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errMsg}`);\n  } catch {\n    // ignore secondary failure\n  }\n}\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  const title = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName}${result.label ? `: ${result.label}` : \"\"} (${duration}s)`;\n  return [title, argsFormatted, result.result].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function createTelegramAdapters(\n  event: TelegramEvent,\n  bot: TelegramMessagingBot,\n): {\n  message: ConversationMessage;\n  responder: ConversationResponder;\n  platform: MessagingInfo;\n} {\n  let messageId: number | null = null;\n  let accumulatedText = \"\";\n  const responseOperations = new OrderedResponseOperations();\n  let typingInterval: ReturnType<typeof setInterval> | null = null;\n  let typingFailureWarned = false;\n\n  function stopTyping() {\n    if (typingInterval !== null) {\n      clearInterval(typingInterval);\n      typingInterval = null;\n    }\n  }\n\n  const conversationId = event.conversationId;\n  const chatId = parseInt(conversationId);\n  const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;\n\n  const message: ConversationMessage = {\n    id: event.ts,\n    sessionKey: deriveSessionKey(event),\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  };\n\n  // The bot's getMessagingInfo() is the single authority for platform info.\n  const platform: MessagingInfo = bot.getMessagingInfo();\n\n  async function sendContinuation(text: string): Promise<void> {\n    await bot.postMessageRaw(chatId, text);\n  }\n\n  async function sendOrUpdate(displayText: string): Promise<void> {\n    if (messageId !== null) {\n      await bot.updateMessage(conversationId, String(messageId), displayText);\n    } else if (replyToId !== null) {\n      messageId = await bot.postReply(chatId, replyToId, displayText);\n    } else {\n      messageId = await bot.postMessageRaw(chatId, displayText);\n    }\n  }\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"telegram\",\n    conversationId,\n    chatId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: messageId,\n    replyToId,\n    conversationKind: message.conversationKind,\n  }));\n\n  const sendSplitText = async (\n    text: string,\n    firstPart: (part: string) => Promise<void>,\n  ): Promise<void> => {\n    const [head, ...tail] = splitText(text, MAX_LENGTH, formatTelegramContinuation);\n    await firstPart(head);\n    for (const part of tail) {\n      await sendContinuation(part);\n    }\n  };\n\n  const stream = new BufferedResponseStream({\n    flush: async (text) => {\n      await sendSplitText(text, sendOrUpdate);\n    },\n    finish: async (text) => {\n      stopTyping();\n      await sendSplitText(text, sendOrUpdate);\n    },\n  });\n\n  const queueTelegramSend = (\n    label: string,\n    work: () => Promise<void>,\n    report: (err: unknown) => void,\n  ): Promise<void> =>\n    responseOperations.run(work, (err) => notifyError(bot, chatId, label, err, () => report(err)));\n\n  const responder: ConversationResponder = {\n    respond: async (text: string) => {\n      await queueTelegramSend(\n        \"respond\",\n        async () => {\n          const sanitized = sanitizeTelegramHtml(text);\n          accumulatedText = accumulatedText ? `${accumulatedText}\\n${sanitized}` : sanitized;\n          stream.setText(accumulatedText);\n          await sendSplitText(accumulatedText, sendOrUpdate);\n          if (messageId !== null) {\n            bot.logBotResponse(conversationId, text, String(messageId));\n          }\n        },\n        (err) =>\n          reportResponseError(err, \"respond\", {\n            phase: messageId ? \"update\" : \"initial_post\",\n            textLength: text.length,\n            accumulatedLength: accumulatedText.length,\n          }),\n      );\n    },\n\n    appendResponseDelta: async (delta: string) => {\n      await queueTelegramSend(\n        \"appendResponseDelta\",\n        async () => {\n          const sanitized = sanitizeTelegramHtml(delta);\n          await stream.append(sanitized);\n          accumulatedText = stream.getText();\n          if (messageId !== null) {\n            bot.logBotResponse(conversationId, delta, String(messageId));\n          }\n        },\n        (err) =>\n          reportResponseError(err, \"respond\", {\n            textLength: delta.length,\n            accumulatedLength: stream.getText().length,\n          }),\n      );\n    },\n\n    finishResponse: async (finalText?: string) => {\n      await queueTelegramSend(\n        \"finishResponse\",\n        async () => {\n          await stream.finish(\n            finalText === undefined ? undefined : sanitizeTelegramHtml(finalText),\n          );\n          accumulatedText = stream.getText();\n        },\n        (err) =>\n          reportResponseError(err, \"set_working\", {\n            finalTextLength: finalText?.length,\n          }),\n      );\n    },\n\n    replaceResponse: async (text: string) => {\n      await queueTelegramSend(\n        \"replaceResponse\",\n        async () => {\n          accumulatedText = sanitizeTelegramHtml(text);\n          stream.setText(accumulatedText);\n          await sendSplitText(accumulatedText, sendOrUpdate);\n        },\n        (err) =>\n          reportResponseError(err, \"replace_response\", {\n            textLength: text.length,\n            hadExistingResponse: Boolean(messageId),\n          }),\n      );\n    },\n\n    respondDiagnostic: async (text: string, options?: { style?: \"muted\" | \"error\" }) => {\n      await queueTelegramSend(\n        \"respondDiagnostic\",\n        async () => {\n          const prefix = options?.style === \"error\" ? \"Error: \" : \"\";\n          await sendSplitText(sanitizeTelegramHtml(`${prefix}${text}`), sendContinuation);\n        },\n        (err) =>\n          reportResponseError(err, \"respond_diagnostic\", {\n            textLength: text.length,\n            style: options?.style,\n          }),\n      );\n    },\n\n    respondToolResult: async (result: ChatToolResult) => {\n      await responder.respondDiagnostic(formatToolResult(result));\n    },\n\n    setTyping: async (isTyping: boolean) => {\n      const onTypingError = (err: unknown): void => {\n        if (typingFailureWarned) return;\n        typingFailureWarned = true;\n        log.logWarning(\n          \"Telegram sendTyping failed (further occurrences suppressed for this session)\",\n          err instanceof Error ? err.message : String(err),\n        );\n      };\n      if (isTyping && typingInterval === null) {\n        // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)\n        bot.sendTyping(chatId).catch(onTypingError);\n        typingInterval = setInterval(() => {\n          bot.sendTyping(chatId).catch(onTypingError);\n        }, 4000);\n      } else if (!isTyping) {\n        stopTyping();\n      }\n    },\n\n    setWorking: async (working: boolean) => {\n      if (!working) stopTyping();\n    },\n\n    uploadFile: async (filePath: string, title?: string) => {\n      await bot.uploadFile(conversationId, filePath, title);\n    },\n\n    deleteResponse: async () => {\n      await responseOperations.run(async () => {\n        if (messageId !== null) {\n          try {\n            await bot.deleteMessageRaw(chatId, messageId);\n          } catch {\n            // Ignore errors\n          }\n          messageId = null;\n        }\n      });\n    },\n  };\n\n  return { message, responder, platform };\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ChatToolResult,\n  ConversationMessage,\n  ConversationResponder,\n  MessagingInfo,\n} from \"../../adapter.js\";\nimport { deriveSessionKey } from \"../../sessions/session-key.js\";\nimport { createBufferedResponder } from \"../buffered-responder.js\";\nimport { createChatResponseErrorReporter, formatToolArgs } from \"../shared.js\";\nimport { sanitizeTelegramHtml } from \"./html.js\";\nimport type { TelegramMessagingBot, TelegramEvent } from \"./bot.js\";\n\n// Telegram message length limit is 4096 chars; 3800 leaves headroom for HTML escapes.\nconst MAX_LENGTH = 3800;\n\nconst formatTelegramContinuation = (partNum: number): string => `(continued ${partNum})`;\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  const title = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName}${result.label ? `: ${result.label}` : \"\"} (${duration}s)`;\n  return [title, argsFormatted, result.result].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function createTelegramAdapters(\n  event: TelegramEvent,\n  bot: TelegramMessagingBot,\n): {\n  message: ConversationMessage;\n  responder: ConversationResponder;\n  platform: MessagingInfo;\n} {\n  const conversationId = event.conversationId;\n  const chatId = parseInt(conversationId);\n  const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;\n\n  const message: ConversationMessage = {\n    id: event.ts,\n    sessionKey: deriveSessionKey(event),\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  };\n\n  // The bot's getMessagingInfo() is the single authority for platform info.\n  const platform: MessagingInfo = bot.getMessagingInfo();\n\n  let currentResponseId: string | null = null;\n\n  const reportResponseError = createChatResponseErrorReporter(() => ({\n    platform: \"telegram\",\n    conversationId,\n    chatId,\n    messageId: message.id,\n    sessionKey: message.sessionKey,\n    responseMessageId: currentResponseId,\n    replyToId,\n    conversationKind: message.conversationKind,\n  }));\n\n  const { responder } = createBufferedResponder({\n    label: \"Telegram\",\n    maxLength: MAX_LENGTH,\n    formatContinuation: formatTelegramContinuation,\n    errorPrefix: \"Error: \",\n    sanitize: sanitizeTelegramHtml,\n    streaming: true,\n    typing: {\n      // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)\n      send: () => bot.sendTyping(chatId),\n      intervalMs: 4000,\n    },\n    formatToolResult,\n    reportError: reportResponseError,\n    notifySendFailure: async (errorMessage) => {\n      await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errorMessage}`);\n    },\n    post: async (text) => {\n      const id =\n        replyToId !== null\n          ? await bot.postReply(chatId, replyToId, text)\n          : await bot.postMessageRaw(chatId, text);\n      currentResponseId = String(id);\n      return currentResponseId;\n    },\n    update: (id, text) => bot.updateMessage(conversationId, id, text),\n    postExtra: (text) => bot.postMessageRaw(chatId, text),\n    delete: async (id) => {\n      await bot.deleteMessageRaw(chatId, Number(id));\n      currentResponseId = null;\n    },\n    logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),\n    uploadFile: (filePath, title) => bot.uploadFile(conversationId, filePath, title),\n  });\n\n  return { message, responder, platform };\n}\n"]}

package/dist/agent.d.ts

@@ -14,7 +14,6 @@ import { type RuntimePathContext, type SandboxConfig } from "./sandbox/index.js"
 import type { VaultManager } from "./vault/index.js";
 import { type ResolvedSessionScope } from "./sessions/store.js";
 import type { PlatformToolPackFactory } from "./tools/types.js";
-export declare function getUnresolvedSandboxPathContext(sandboxConfig: SandboxConfig, hostWorkspaceRoot: string): RuntimePathContext;
 export declare function translateRuntimePathToHost(runtimePath: string, pathContext: RuntimePathContext): string;
 export declare function translateAttachPathToHost(filePath: string, pathContext: RuntimePathContext): string;
 export declare function buildPromptPayload(message: ConversationMessage, workspacePath: string, pathContext?: RuntimePathContext): {

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,OAAO,EAAY,KAAK,YAAY,EAAc,MAAM,uBAAuB,CAAC;AAChF,OAAO,EASL,WAAW,EAKZ,MAAM,oBAAoB,CAAC;AAM5B,OAAO,KAAK,EAEV,mBAAmB,EAIpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAEV,gBAAgB,EAChB,eAAe,EAEf,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAKrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAC;AAO5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIrD,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,qBAAqB,CAAC;AAa7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAKhE,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAER;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,CAKR;AAsDD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,aAAa,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,kBAAkB,GAC/B;IACD,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,YAAY,EAAE,CAAC;CAClC,CAaA;AAsHD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,IAAI,GAAG,MAAM,GAAG,UAAU,CAAC,GAC7D,MAAM,GAAG,SAAS,CAOpB;AA6KD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,OAAO,EACvB,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,YAAY,EAAE,MAAM,GACnB,MAAM,CAkBR;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,kBAAkB,EAAE,MAAM,GAAG,SAAS,EACtC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR;AAmnCD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,aAAa,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,oBAAoB,CAAC;IACnC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;IAC/C,WAAW,CAAC,EAAE;QACZ,UAAU,EAAE,yBAAyB,CAAC;QACtC,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,yBAAyB,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAC/D,8EAA8E;IAC9E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4SxF"}

package/dist/agent.js

@@ -9,26 +9,23 @@ import { existsSync, readFileSync } from "fs";
 import { mkdir, readFile } from "fs/promises";
 import { join, posix } from "path";
 import { resolveConversationSettings } from "./config.js";
-import { readEnv } from "./utils/env.js";
+import { effectiveStateDir } from "./cli/arg-grammar.js";
 import { ActorExecutionResolver } from "./execution-resolver.js";
 import * as log from "./log.js";
-import { createExecutor, } from "./sandbox/index.js";
-import { createMountedRuntimePathContext } from "./sandbox/path-context.js";
+import { createExecutor, getUnresolvedSandboxPathContext, } from "./sandbox/index.js";
 import { addLifecycleBreadcrumb, metricAttributes, reportUserFacingError, updateActiveSpanAttribution, } from "./observability/sentry.js";
-import { AgentMemoryFileManager } from "./sessions/agent-memory-file-manager.js";
+import { ChatHistorySync } from "./sessions/chat-history-sync.js";
 import { formatHistoryLine } from "./sessions/history-line.js";
 import { conversationIdOf, isThreadSessionKey } from "./sessions/session-key.js";
 import { extractSessionUuid, openManagedSession, } from "./sessions/store.js";
 import { HostEventStore } from "./tools/event.js";
-import { createMikanTools, createSubagentTool } from "./tools/index.js";
+import { createMikanTools, createSubagentTool, DEFAULT_GLOBAL_SUBAGENT_SLOTS, SubagentSlotPool, } from "./tools/index.js";
+// One process-wide fan-out account: per-conversation queues serialize runs,
+// but each run can fan out up to the per-run cap — without this shared
+// ceiling, N busy conversations hold N × cap live subagent sessions.
+const globalSubagentSlots = new SubagentSlotPool(DEFAULT_GLOBAL_SUBAGENT_SLOTS);
 import * as Sentry from "@sentry/node";
 import { emitAgentEvent } from "./agent-events.js";
-export function getUnresolvedSandboxPathContext(sandboxConfig, hostWorkspaceRoot) {
-    if (sandboxConfig.type === "image") {
-        return createMountedRuntimePathContext(hostWorkspaceRoot, "/workspace");
-    }
-    return createExecutor(sandboxConfig).getPathContext(hostWorkspaceRoot);
-}
 export function translateRuntimePathToHost(runtimePath, pathContext) {
     return pathContext.runtimeToHostPath?.(runtimePath) ?? runtimePath;
 }
@@ -712,6 +709,9 @@ function createRunnerExecutionContext(sandboxConfig, vaultManager, provisioner,
         readFile(path, options) {
             return activeExecutor.readFile(path, options);
         },
+        readFileBase64(path, options) {
+            return activeExecutor.readFileBase64(path, options);
+        },
         writeFile(path, content, options) {
             return activeExecutor.writeFile(path, content, options);
         },
@@ -746,20 +746,13 @@ function buildExtensionHostServices(params) {
     const { workspaceDir, vaultManager, platformNotifier, platformReactor, platformUploader, runSubagentService, } = params;
     const eventStore = HostEventStore.fromWorkspaceDir(workspaceDir);
     return {
-        stateDir: readEnv("STATE_DIR"),
+        stateDir: effectiveStateDir(),
         scheduleStore: {
             write: async (filename, payload) => {
-                // Event files tolerate a missing platform (single-platform default),
-                // so the harness payload is a valid event payload as written.
                 await eventStore.write(filename, payload);
             },
             delete: async (filename) => (await eventStore.delete(filename)).deleted,
-            list: async () => (await eventStore.list())
-                .filter((entry) => entry.payload !== null)
-                .map((entry) => ({
-                filename: entry.filename,
-                payload: entry.payload,
-            })),
+            list: async () => (await eventStore.list()).flatMap((entry) => entry.payload ? [{ filename: entry.filename, payload: entry.payload }] : []),
         },
         ...(platformNotifier ? { postMessage: platformNotifier } : {}),
         ...(platformReactor ? { addReaction: platformReactor } : {}),
@@ -777,17 +770,8 @@ async function createConfiguredAgentSession(params) {
     // Host-only dirs under the state dir: extension code runs in the mikan
     // process, so it must never load from workspace paths — those are mounted
     // into sandbox containers and agent-writable (sandbox escape otherwise).
-    let contributedTools = [];
-    const subagentTool = createSubagentTool((request) => runSubagent({
-        request,
-        defaultModel: model,
-        thinkingLevel,
-        models,
-        workspaceDir,
-        availableTools: [...tools, ...contributedTools],
-    }));
     const extensionsResult = await loadExtensions({
-        dirs: defaultExtensionDirs(conversationId, readEnv("STATE_DIR")),
+        dirs: defaultExtensionDirs(conversationId, effectiveStateDir()),
         context: { conversationId, workspaceDir, model, thinkingLevel },
         services: buildExtensionHostServices({
             workspaceDir,
@@ -805,13 +789,25 @@ async function createConfiguredAgentSession(params) {
             }),
         }),
     });
-    contributedTools = extensionsResult.registry.getContributedTools();
+    const contributedTools = extensionsResult.registry.getContributedTools();
     for (const err of extensionsResult.errors) {
         log.logWarning(`[${conversationId}] Extension load error: ${err.path}`, err.error);
     }
     if (extensionsResult.extensions.length > 0) {
         log.logInfo(`[${conversationId}] Loaded ${extensionsResult.extensions.length} extension(s): ${extensionsResult.extensions.map((extension) => extension.name).join(", ")}`);
     }
+    const subagentTool = createSubagentTool((request) => runSubagent({
+        request,
+        defaultModel: model,
+        thinkingLevel,
+        models,
+        workspaceDir,
+        availableTools: [...tools, ...contributedTools],
+        // `session` is the const below: the tool only executes inside that
+        // session's own prompt loop, and the temporal dead zone turns any
+        // earlier call into a loud error instead of a silently dropped fold.
+        onUsage: (usage) => session.foldExternalUsage(usage),
+    }), globalSubagentSlots);
     const session = new MikanAgentSession({
         systemPrompt,
         model,
@@ -1225,7 +1221,7 @@ export async function createRunner(options) {
         sessionManager.appendSessionInfo(threadSessionName);
     }
     const sessionUuid = extractSessionUuid(contextFile);
-    const chatSessionManager = new AgentMemoryFileManager();
+    const chatSessionManager = new ChatHistorySync();
     const { session, extensionSkills, extensionRegistry, disposeExtensions } = await createConfiguredAgentSession({
         conversationId,
         workspaceDir,