@geminixiang/mikan 1.0.0-beta.46 → 1.0.0-beta.48

package/dist/adapters/telegram/bot.d.ts

@@ -10,13 +10,16 @@ export declare class TelegramMessagingBot implements MessagingBot {
     private workspace;
     private botUserId;
     private botUsername;
+    private stopped;
     private queues;
+    private intake;
     private startupTime;
     constructor(handler: MessagingEventHandler, config: {
         token: string;
         workspace: Workspace;
     });
     start(): Promise<void>;
+    stop(): Promise<void>;
     postMessage(channel: string, text: string): Promise<string>;
     addReaction(channel: string, messageTs: string, emoji: string): Promise<void>;
     updateMessage(channel: string, ts: string, text: string): Promise<void>;

package/dist/adapters/telegram/bot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EAErB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAA2B,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgB9E,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAgB5E,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAmChD,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,WAAW,CAAa;IAEhC,YAAY,OAAO,EAAE,qBAAqB,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,EAQ1F;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAmB3B;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASlF;IAEK,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY5E;IAED,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAe9C;IAED,gBAAgB,IAAI,aAAa,CAShC;IAMK,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlE;IAEK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;IAEK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOvF;IAEK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEvE;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9C;IAEK,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF;IAED,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE9C;IAED,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE9D;IAED;;;;OAIG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAqBhD;IAED,uFAAuF;IACvF,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,qBAAqB;IAsC7B,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,kBAAkB;CA2F3B"}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"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"}

package/dist/adapters/telegram/bot.js

@@ -4,7 +4,7 @@ import { Bot as GrammyMessagingBot, InputFile } from "grammy";
 import { createConversationEvent } from "../../adapter.js";
 import * as log from "../../log.js";
 import { resolveChatSessionKey } from "../../sessions/session-key.js";
-import { appendBotResponseLog, appendChannelLog, MessagingEventQueue, downloadUrlToFile, withRetry, saveIncomingAttachments, } from "../shared.js";
+import { appendBotResponseLog, appendChannelLog, MessagingEventQueue, MessagingIntakeTracker, downloadUrlToFile, withRetry, saveIncomingAttachments, } from "../shared.js";
 import { COMMAND_MANIFEST, telegramCommandMenu } from "../../commands/manifest.js";
 import { processMessageIntake } from "../intake.js";
 import { createTelegramAdapters } from "./context.js";
@@ -38,7 +38,9 @@ export class TelegramMessagingBot {
     constructor(handler, config) {
         this.botUserId = null;
         this.botUsername = null;
+        this.stopped = false;
         this.queues = new Map();
+        this.intake = new MessagingIntakeTracker("Telegram");
         this.startupTime = 0;
         this.handler = handler;
         this.botToken = config.token;
@@ -52,6 +54,7 @@ export class TelegramMessagingBot {
     // Public API (implements MessagingBot)
     // ==========================================================================
     async start() {
+        this.stopped = false;
         const me = await this.client.api.getMe();
         this.botUserId = String(me.id);
         this.botUsername = me.username ?? null;
@@ -59,6 +62,8 @@ export class TelegramMessagingBot {
         // Menu registration derives from the command manifest; routing is
         // separate (native handlers below + intake/dispatch for the rest).
         await this.client.api.setMyCommands(telegramCommandMenu());
+        if (this.stopped)
+            return;
         this.setupEventHandlers();
         // Start polling in background (bot.start() runs indefinitely)
         this.client.start().catch((err) => {
@@ -67,6 +72,16 @@ export class TelegramMessagingBot {
         log.logConnected("Telegram");
         log.logInfo(`Telegram bot started as @${this.botUsername ?? this.botUserId}`);
     }
+    async stop() {
+        this.stopped = true;
+        try {
+            await this.client.stop();
+        }
+        finally {
+            await this.intake.close();
+            await Promise.all([...this.queues.values()].map((queue) => queue.close()));
+        }
+    }
     async postMessage(channel, text) {
         const result = await this.postMessageRaw(parseInt(channel), text);
         return String(result);
@@ -97,6 +112,8 @@ export class TelegramMessagingBot {
         });
     }
     enqueueEvent(event) {
+        if (this.stopped)
+            return false;
         const conversationId = event.conversationId;
         const queue = this.getQueue(conversationId);
         if (queue.size() >= 5) {
@@ -104,11 +121,10 @@ export class TelegramMessagingBot {
             return false;
         }
         log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);
-        queue.enqueue(() => {
+        return queue.enqueue(() => {
             const context = createTelegramAdapters(event, this);
             return this.handler.handleEvent(event, this, context);
         });
-        return true;
     }
     getMessagingInfo() {
         return {
@@ -263,7 +279,7 @@ export class TelegramMessagingBot {
         for (const entry of COMMAND_MANIFEST) {
             if (!entry.telegramCommand || entry.magicWord)
                 continue;
-            this.client.command(entry.name, async (ctx) => {
+            this.client.command(entry.name, (ctx) => this.intake.run(async () => {
                 const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
                 if (!mc)
                     return;
@@ -294,10 +310,10 @@ export class TelegramMessagingBot {
                     isMessagingBot: false,
                 });
                 await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));
-            });
+            }));
         }
         // --- Catch-all for regular (non-command) messages ---
-        this.client.on("message", async (ctx) => {
+        this.client.on("message", (ctx) => this.intake.run(async () => {
             const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
             if (!mc)
                 return;
@@ -342,7 +358,7 @@ export class TelegramMessagingBot {
                 bot: this,
                 createContext: (event) => createTelegramAdapters(event, this),
             });
-        });
+        }));
     }
 }
 //# sourceMappingURL=bot.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"bot.js","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename } from \"node:path\";\nimport { Bot as GrammyMessagingBot, InputFile } from \"grammy\";\nimport type { Message } from \"grammy/types\";\nimport type {\n  ConversationEvent,\n  MessagingEventHandler,\n  ConversationKind,\n  MessagingInfo,\n} from \"../../adapter.js\";\nimport { createConversationEvent, type MessagingBot } from \"../../adapter.js\";\nimport type { TelegramEvent } from \"./types.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/session-key.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  MessagingEventQueue,\n  downloadUrlToFile,\n  withRetry,\n  saveIncomingAttachments,\n  type IncomingAttachment,\n} from \"../shared.js\";\nimport { COMMAND_MANIFEST, telegramCommandMenu } from \"../../commands/manifest.js\";\nimport { processMessageIntake } from \"../intake.js\";\nimport { createTelegramAdapters } from \"./context.js\";\nimport { createOfficeAddress, type Workspace } from \"../../office/index.js\";\n\n// grammY surfaces Telegram errors as `GrammyError` with `error_code` mirroring\n// the Bot API. 429 is the rate-limit status; the response also includes\n// `parameters.retry_after` but exponential backoff is good enough here.\nfunction telegramIsRateLimited(err: Error): boolean {\n  return (err as { error_code?: number }).error_code === 429;\n}\n\nconst telegramRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: telegramIsRateLimited });\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type { TelegramEvent } from \"./types.js\";\n\ninterface MessageContext {\n  msg: Message;\n  text: string;\n  chatId: string;\n  chatType: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName: string;\n  msgId: string;\n  threadTs: string | undefined;\n  sessionKey: string;\n}\n\n// ============================================================================\n// TelegramMessagingBot\n// ============================================================================\n\n/**\n * A response as a Telegram rich message.\n *\n * Telegram parses the markdown into native blocks itself — a GFM table becomes\n * a real table, `##` a heading, a fence a code block. That is why this adapter\n * has no converter of its own: unlike Slack and Discord, nothing here has to be\n * translated before sending.\n *\n * It replaces the HTML pipeline, and with it the escape-and-retry dance that\n * existed only because a model writing HTML by hand regularly produced markup\n * Telegram rejected.\n */\nfunction richMessage(markdown: string): { markdown: string } {\n  return { markdown };\n}\n\nexport class TelegramMessagingBot implements MessagingBot {\n  private client: GrammyMessagingBot;\n  private handler: MessagingEventHandler;\n  private botToken: string;\n  private workspace: Workspace;\n  private botUserId: string | null = null;\n  private botUsername: string | null = null;\n  private queues = new Map<string, MessagingEventQueue>();\n  private startupTime: number = 0;\n\n  constructor(handler: MessagingEventHandler, config: { token: string; workspace: Workspace }) {\n    this.handler = handler;\n    this.botToken = config.token;\n    this.workspace = config.workspace;\n    this.client = new GrammyMessagingBot(config.token);\n    this.client.catch((err) => {\n      log.logWarning(\"Telegram error\", err instanceof Error ? err.message : String(err));\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements MessagingBot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    const me = await this.client.api.getMe();\n    this.botUserId = String(me.id);\n    this.botUsername = me.username ?? null;\n    this.startupTime = Date.now();\n\n    // Menu registration derives from the command manifest; routing is\n    // separate (native handlers below + intake/dispatch for the rest).\n    await this.client.api.setMyCommands(telegramCommandMenu());\n\n    this.setupEventHandlers();\n\n    // Start polling in background (bot.start() runs indefinitely)\n    this.client.start().catch((err) => {\n      log.logWarning(\"Telegram polling error\", err instanceof Error ? err.message : String(err));\n    });\n\n    log.logConnected(\"Telegram\");\n    log.logInfo(`Telegram bot started as @${this.botUsername ?? this.botUserId}`);\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    const result = await this.postMessageRaw(parseInt(channel), text);\n    return String(result);\n  }\n\n  async addReaction(channel: string, messageTs: string, emoji: string): Promise<void> {\n    // Telegram reactions are set via setMessageReaction with a Unicode emoji.\n    // Short names (Slack style) won't resolve; callers should pass an emoji.\n    const name = emoji.replace(/^:|:$/g, \"\");\n    await telegramRetry(async () => {\n      await this.client.api.setMessageReaction(parseInt(channel), parseInt(messageTs), [\n        { type: \"emoji\", emoji: name as never },\n      ]);\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      try {\n        await this.client.api.editMessageText(parseInt(channel), parseInt(ts), richMessage(text));\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        // Editing to identical content is something streaming asks for\n        // constantly; it is a no-op, not a failure.\n        if (msg.includes(\"message is not modified\")) return;\n        throw err;\n      }\n    });\n  }\n\n  enqueueEvent(event: ConversationEvent): boolean {\n    const conversationId = event.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    queue.enqueue(() => {\n      const context = createTelegramAdapters(event as TelegramEvent, this);\n      return this.handler.handleEvent(event, this, context);\n    });\n    return true;\n  }\n\n  getMessagingInfo(): MessagingInfo {\n    return {\n      name: \"telegram\",\n      trustModel: \"membership\",\n      formattingGuide:\n        \"## Telegram Formatting (Markdown)\\nWrite ordinary Markdown — headings, lists, tables, code fences, quotes and links all render natively. Nothing needs converting by hand.\",\n      channels: [],\n      users: [],\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async postMessageRaw(chatId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text));\n      return result.message_id;\n    });\n  }\n\n  async postPlainMessage(chatId: number, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      await this.client.api.sendMessage(chatId, text);\n    });\n  }\n\n  async postReply(chatId: number, replyToMessageId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text), {\n        reply_parameters: { message_id: replyToMessageId },\n      });\n      return result.message_id;\n    });\n  }\n\n  async deleteMessageRaw(chatId: number, messageId: number): Promise<void> {\n    await this.client.api.deleteMessage(chatId, messageId);\n  }\n\n  async sendTyping(chatId: number): Promise<void> {\n    await this.client.api.sendChatAction(chatId, \"typing\");\n  }\n\n  async uploadFile(channel: string, filePath: string, title?: string): Promise<void> {\n    return telegramRetry(async () => {\n      const fileName = title ?? basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await this.client.api.sendDocument(parseInt(channel), new InputFile(fileContent, fileName));\n    });\n  }\n\n  logToFile(channel: string, entry: object): void {\n    appendChannelLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), entry);\n  }\n\n  logBotResponse(channel: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), text, ts);\n  }\n\n  /**\n   * Process attachments from a Telegram message\n   * Downloads files before returning metadata so the agent can read them immediately\n   * Returns format compatible with ConversationMessage: { name: string, localPath: string }[]\n   */\n  async processAttachments(\n    chatId: string,\n    message: Message,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const items: IncomingAttachment[] = [];\n\n    // Photos: take the largest size for best quality.\n    const photo = message.photo?.[message.photo.length - 1];\n    if (photo) {\n      items.push(this.telegramFileItem(photo.file_id, `photo_${message.message_id}.jpg`));\n    }\n    if (message.document) {\n      const doc = message.document;\n      items.push(\n        this.telegramFileItem(doc.file_id, doc.file_name ?? `document_${message.message_id}`),\n      );\n    }\n\n    const office = this.workspace.office(createOfficeAddress(\"telegram\", chatId));\n    const { saved, failed } = await saveIncomingAttachments(office, items);\n    for (const failure of failed) {\n      log.logWarning(`Failed to process Telegram file`, `${failure.name}: ${failure.error}`);\n    }\n    return saved.map((item) => ({ name: item.original, localPath: item.localPath }));\n  }\n\n  /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */\n  private telegramFileItem(fileId: string, name: string): IncomingAttachment {\n    return {\n      name,\n      download: async (destPath) => {\n        const file = await this.client.api.getFile(fileId);\n        if (!file.file_path) throw new Error(`Telegram file has no path: ${fileId}`);\n        await downloadUrlToFile(\n          `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`,\n          destPath,\n        );\n      },\n    };\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): MessagingEventQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new MessagingEventQueue(\"Telegram\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private extractMessageContext(msg: Message): MessageContext | null {\n    if (!msg) return null;\n    if (msg.date * 1000 < this.startupTime) return null;\n    if (msg.from?.is_bot) return null;\n\n    const text = msg.text ?? msg.caption ?? \"\";\n    if (!text && !msg.document && !msg.photo) return null;\n\n    const chatId = String(msg.chat.id);\n    const chatType = msg.chat.type;\n    const userId = String(msg.from?.id ?? \"unknown\");\n    const userName = msg.from?.username ?? msg.from?.first_name ?? userId;\n    const msgId = String(msg.message_id);\n    const replyToId = msg.reply_to_message?.message_id;\n    const threadTs = replyToId ? String(replyToId) : undefined;\n    const conversationKind = chatType === \"private\" ? \"direct\" : \"shared\";\n\n    const sessionKey = resolveChatSessionKey({\n      conversationId: chatId,\n      conversationKind,\n      messageId: msgId,\n      threadTs,\n    });\n\n    return {\n      msg,\n      text,\n      chatId,\n      chatType,\n      conversationKind,\n      userId,\n      userName,\n      msgId,\n      threadTs,\n      sessionKey,\n    };\n  }\n\n  private isAddressedToMessagingBot(text: string, chatType: string): boolean {\n    if (chatType === \"private\") return true;\n    if (!this.botUsername) return false;\n    return text.toLowerCase().includes(`@${this.botUsername.toLowerCase()}`);\n  }\n\n  private cleanText(text: string): string {\n    if (!this.botUsername) return text.trim();\n    return text.replace(new RegExp(`@${this.botUsername}`, \"gi\"), \"\").trim();\n  }\n\n  private setupEventHandlers(): void {\n    // --- Slash commands (registered before catch-all so grammY intercepts them) ---\n    // The manifest's telegramCommand flag is the inventory; magic words (e.g.\n    // `stop`) are deliberately never native handlers — they belong to\n    // conversation intake, so the catch-all below must receive them.\n    for (const entry of COMMAND_MANIFEST) {\n      if (!entry.telegramCommand || entry.magicWord) continue;\n      this.client.command(entry.name, async (ctx) => {\n        const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n        if (!mc) return;\n        // Handler grammars accept the user's spelling directly (manifest\n        // slash forms), so it is logged and dispatched as-is.\n        const commandText = this.cleanText(mc.text);\n        const event = createConversationEvent({\n          platform: \"telegram\",\n          type: \"command\",\n          conversationId: mc.chatId,\n          conversationKind: mc.conversationKind,\n          ts: mc.msgId,\n          thread_ts: mc.threadTs,\n          sessionKey: mc.sessionKey,\n          user: mc.userId,\n          userName: mc.userName,\n          text: commandText,\n          attachments: [],\n        }) as TelegramEvent;\n        this.logToFile(mc.chatId, {\n          date: new Date(mc.msg.date * 1000).toISOString(),\n          ts: mc.msgId,\n          ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n          user: mc.userId,\n          userName: mc.userName,\n          text: commandText,\n          attachments: [],\n          isMessagingBot: false,\n        });\n        await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));\n      });\n    }\n\n    // --- Catch-all for regular (non-command) messages ---\n\n    this.client.on(\"message\", async (ctx) => {\n      const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n      if (!mc) return;\n\n      const cleanedText = this.cleanText(mc.text);\n      const addressedToMessagingBot = this.isAddressedToMessagingBot(mc.text, mc.chatType);\n      const isAutoReplyCandidate = mc.chatType !== \"private\" && !addressedToMessagingBot;\n\n      const eventBase = createConversationEvent({\n        platform: \"telegram\",\n        type: \"message\",\n        conversationId: mc.chatId,\n        conversationKind: mc.conversationKind,\n        ts: mc.msgId,\n        thread_ts: mc.threadTs,\n        sessionKey: mc.sessionKey,\n        user: mc.userId,\n        userName: mc.userName,\n        text: cleanedText,\n      }) as TelegramEvent;\n\n      await processMessageIntake({\n        eventBase,\n        office: this.workspace.office(eventBase.address),\n        isAutoReplyCandidate,\n        magicWord: {\n          addressed: addressedToMessagingBot || mc.chatType === \"private\",\n          scopeFallback: \"always\",\n        },\n        busyPolicy: \"reject\",\n        logEntryBase: {\n          date: new Date(mc.msg.date * 1000).toISOString(),\n          ts: mc.msgId,\n          ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n          user: mc.userId,\n          userName: mc.userName,\n          text: cleanedText,\n          isMessagingBot: false,\n        },\n        log: (entry) => this.logToFile(mc.chatId, entry),\n        processAttachments: () => this.processAttachments(mc.chatId, mc.msg),\n        queueKey: mc.sessionKey,\n        enqueue: (queueKey, work) => this.getQueue(queueKey).enqueue(work),\n        handler: this.handler,\n        bot: this,\n        createContext: (event) => createTelegramAdapters(event, this),\n      });\n    });\n  }\n}\n"]}
+{"version":3,"file":"bot.js","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename } from \"node:path\";\nimport { Bot as GrammyMessagingBot, InputFile } from \"grammy\";\nimport type { Message } from \"grammy/types\";\nimport type {\n  ConversationEvent,\n  MessagingEventHandler,\n  ConversationKind,\n  MessagingInfo,\n} from \"../../adapter.js\";\nimport { createConversationEvent, type MessagingBot } from \"../../adapter.js\";\nimport type { TelegramEvent } from \"./types.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/session-key.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  MessagingEventQueue,\n  MessagingIntakeTracker,\n  downloadUrlToFile,\n  withRetry,\n  saveIncomingAttachments,\n  type IncomingAttachment,\n} from \"../shared.js\";\nimport { COMMAND_MANIFEST, telegramCommandMenu } from \"../../commands/manifest.js\";\nimport { processMessageIntake } from \"../intake.js\";\nimport { createTelegramAdapters } from \"./context.js\";\nimport { createOfficeAddress, type Workspace } from \"../../office/index.js\";\n\n// grammY surfaces Telegram errors as `GrammyError` with `error_code` mirroring\n// the Bot API. 429 is the rate-limit status; the response also includes\n// `parameters.retry_after` but exponential backoff is good enough here.\nfunction telegramIsRateLimited(err: Error): boolean {\n  return (err as { error_code?: number }).error_code === 429;\n}\n\nconst telegramRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: telegramIsRateLimited });\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type { TelegramEvent } from \"./types.js\";\n\ninterface MessageContext {\n  msg: Message;\n  text: string;\n  chatId: string;\n  chatType: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName: string;\n  msgId: string;\n  threadTs: string | undefined;\n  sessionKey: string;\n}\n\n// ============================================================================\n// TelegramMessagingBot\n// ============================================================================\n\n/**\n * A response as a Telegram rich message.\n *\n * Telegram parses the markdown into native blocks itself — a GFM table becomes\n * a real table, `##` a heading, a fence a code block. That is why this adapter\n * has no converter of its own: unlike Slack and Discord, nothing here has to be\n * translated before sending.\n *\n * It replaces the HTML pipeline, and with it the escape-and-retry dance that\n * existed only because a model writing HTML by hand regularly produced markup\n * Telegram rejected.\n */\nfunction richMessage(markdown: string): { markdown: string } {\n  return { markdown };\n}\n\nexport class TelegramMessagingBot implements MessagingBot {\n  private client: GrammyMessagingBot;\n  private handler: MessagingEventHandler;\n  private botToken: string;\n  private workspace: Workspace;\n  private botUserId: string | null = null;\n  private botUsername: string | null = null;\n  private stopped = false;\n  private queues = new Map<string, MessagingEventQueue>();\n  private intake = new MessagingIntakeTracker(\"Telegram\");\n  private startupTime: number = 0;\n\n  constructor(handler: MessagingEventHandler, config: { token: string; workspace: Workspace }) {\n    this.handler = handler;\n    this.botToken = config.token;\n    this.workspace = config.workspace;\n    this.client = new GrammyMessagingBot(config.token);\n    this.client.catch((err) => {\n      log.logWarning(\"Telegram error\", err instanceof Error ? err.message : String(err));\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements MessagingBot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    this.stopped = false;\n    const me = await this.client.api.getMe();\n    this.botUserId = String(me.id);\n    this.botUsername = me.username ?? null;\n    this.startupTime = Date.now();\n\n    // Menu registration derives from the command manifest; routing is\n    // separate (native handlers below + intake/dispatch for the rest).\n    await this.client.api.setMyCommands(telegramCommandMenu());\n    if (this.stopped) return;\n\n    this.setupEventHandlers();\n\n    // Start polling in background (bot.start() runs indefinitely)\n    this.client.start().catch((err) => {\n      log.logWarning(\"Telegram polling error\", err instanceof Error ? err.message : String(err));\n    });\n\n    log.logConnected(\"Telegram\");\n    log.logInfo(`Telegram bot started as @${this.botUsername ?? this.botUserId}`);\n  }\n\n  async stop(): Promise<void> {\n    this.stopped = true;\n    try {\n      await this.client.stop();\n    } finally {\n      await this.intake.close();\n      await Promise.all([...this.queues.values()].map((queue) => queue.close()));\n    }\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    const result = await this.postMessageRaw(parseInt(channel), text);\n    return String(result);\n  }\n\n  async addReaction(channel: string, messageTs: string, emoji: string): Promise<void> {\n    // Telegram reactions are set via setMessageReaction with a Unicode emoji.\n    // Short names (Slack style) won't resolve; callers should pass an emoji.\n    const name = emoji.replace(/^:|:$/g, \"\");\n    await telegramRetry(async () => {\n      await this.client.api.setMessageReaction(parseInt(channel), parseInt(messageTs), [\n        { type: \"emoji\", emoji: name as never },\n      ]);\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      try {\n        await this.client.api.editMessageText(parseInt(channel), parseInt(ts), richMessage(text));\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        // Editing to identical content is something streaming asks for\n        // constantly; it is a no-op, not a failure.\n        if (msg.includes(\"message is not modified\")) return;\n        throw err;\n      }\n    });\n  }\n\n  enqueueEvent(event: ConversationEvent): boolean {\n    if (this.stopped) return false;\n    const conversationId = event.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    return queue.enqueue(() => {\n      const context = createTelegramAdapters(event as TelegramEvent, this);\n      return this.handler.handleEvent(event, this, context);\n    });\n  }\n\n  getMessagingInfo(): MessagingInfo {\n    return {\n      name: \"telegram\",\n      trustModel: \"membership\",\n      formattingGuide:\n        \"## Telegram Formatting (Markdown)\\nWrite ordinary Markdown — headings, lists, tables, code fences, quotes and links all render natively. Nothing needs converting by hand.\",\n      channels: [],\n      users: [],\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async postMessageRaw(chatId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text));\n      return result.message_id;\n    });\n  }\n\n  async postPlainMessage(chatId: number, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      await this.client.api.sendMessage(chatId, text);\n    });\n  }\n\n  async postReply(chatId: number, replyToMessageId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text), {\n        reply_parameters: { message_id: replyToMessageId },\n      });\n      return result.message_id;\n    });\n  }\n\n  async deleteMessageRaw(chatId: number, messageId: number): Promise<void> {\n    await this.client.api.deleteMessage(chatId, messageId);\n  }\n\n  async sendTyping(chatId: number): Promise<void> {\n    await this.client.api.sendChatAction(chatId, \"typing\");\n  }\n\n  async uploadFile(channel: string, filePath: string, title?: string): Promise<void> {\n    return telegramRetry(async () => {\n      const fileName = title ?? basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await this.client.api.sendDocument(parseInt(channel), new InputFile(fileContent, fileName));\n    });\n  }\n\n  logToFile(channel: string, entry: object): void {\n    appendChannelLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), entry);\n  }\n\n  logBotResponse(channel: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), text, ts);\n  }\n\n  /**\n   * Process attachments from a Telegram message\n   * Downloads files before returning metadata so the agent can read them immediately\n   * Returns format compatible with ConversationMessage: { name: string, localPath: string }[]\n   */\n  async processAttachments(\n    chatId: string,\n    message: Message,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const items: IncomingAttachment[] = [];\n\n    // Photos: take the largest size for best quality.\n    const photo = message.photo?.[message.photo.length - 1];\n    if (photo) {\n      items.push(this.telegramFileItem(photo.file_id, `photo_${message.message_id}.jpg`));\n    }\n    if (message.document) {\n      const doc = message.document;\n      items.push(\n        this.telegramFileItem(doc.file_id, doc.file_name ?? `document_${message.message_id}`),\n      );\n    }\n\n    const office = this.workspace.office(createOfficeAddress(\"telegram\", chatId));\n    const { saved, failed } = await saveIncomingAttachments(office, items);\n    for (const failure of failed) {\n      log.logWarning(`Failed to process Telegram file`, `${failure.name}: ${failure.error}`);\n    }\n    return saved.map((item) => ({ name: item.original, localPath: item.localPath }));\n  }\n\n  /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */\n  private telegramFileItem(fileId: string, name: string): IncomingAttachment {\n    return {\n      name,\n      download: async (destPath) => {\n        const file = await this.client.api.getFile(fileId);\n        if (!file.file_path) throw new Error(`Telegram file has no path: ${fileId}`);\n        await downloadUrlToFile(\n          `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`,\n          destPath,\n        );\n      },\n    };\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): MessagingEventQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new MessagingEventQueue(\"Telegram\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private extractMessageContext(msg: Message): MessageContext | null {\n    if (!msg) return null;\n    if (msg.date * 1000 < this.startupTime) return null;\n    if (msg.from?.is_bot) return null;\n\n    const text = msg.text ?? msg.caption ?? \"\";\n    if (!text && !msg.document && !msg.photo) return null;\n\n    const chatId = String(msg.chat.id);\n    const chatType = msg.chat.type;\n    const userId = String(msg.from?.id ?? \"unknown\");\n    const userName = msg.from?.username ?? msg.from?.first_name ?? userId;\n    const msgId = String(msg.message_id);\n    const replyToId = msg.reply_to_message?.message_id;\n    const threadTs = replyToId ? String(replyToId) : undefined;\n    const conversationKind = chatType === \"private\" ? \"direct\" : \"shared\";\n\n    const sessionKey = resolveChatSessionKey({\n      conversationId: chatId,\n      conversationKind,\n      messageId: msgId,\n      threadTs,\n    });\n\n    return {\n      msg,\n      text,\n      chatId,\n      chatType,\n      conversationKind,\n      userId,\n      userName,\n      msgId,\n      threadTs,\n      sessionKey,\n    };\n  }\n\n  private isAddressedToMessagingBot(text: string, chatType: string): boolean {\n    if (chatType === \"private\") return true;\n    if (!this.botUsername) return false;\n    return text.toLowerCase().includes(`@${this.botUsername.toLowerCase()}`);\n  }\n\n  private cleanText(text: string): string {\n    if (!this.botUsername) return text.trim();\n    return text.replace(new RegExp(`@${this.botUsername}`, \"gi\"), \"\").trim();\n  }\n\n  private setupEventHandlers(): void {\n    // --- Slash commands (registered before catch-all so grammY intercepts them) ---\n    // The manifest's telegramCommand flag is the inventory; magic words (e.g.\n    // `stop`) are deliberately never native handlers — they belong to\n    // conversation intake, so the catch-all below must receive them.\n    for (const entry of COMMAND_MANIFEST) {\n      if (!entry.telegramCommand || entry.magicWord) continue;\n      this.client.command(entry.name, (ctx) =>\n        this.intake.run(async () => {\n          const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n          if (!mc) return;\n          // Handler grammars accept the user's spelling directly (manifest\n          // slash forms), so it is logged and dispatched as-is.\n          const commandText = this.cleanText(mc.text);\n          const event = createConversationEvent({\n            platform: \"telegram\",\n            type: \"command\",\n            conversationId: mc.chatId,\n            conversationKind: mc.conversationKind,\n            ts: mc.msgId,\n            thread_ts: mc.threadTs,\n            sessionKey: mc.sessionKey,\n            user: mc.userId,\n            userName: mc.userName,\n            text: commandText,\n            attachments: [],\n          }) as TelegramEvent;\n          this.logToFile(mc.chatId, {\n            date: new Date(mc.msg.date * 1000).toISOString(),\n            ts: mc.msgId,\n            ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n            user: mc.userId,\n            userName: mc.userName,\n            text: commandText,\n            attachments: [],\n            isMessagingBot: false,\n          });\n          await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));\n        }),\n      );\n    }\n\n    // --- Catch-all for regular (non-command) messages ---\n\n    this.client.on(\"message\", (ctx) =>\n      this.intake.run(async () => {\n        const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n        if (!mc) return;\n\n        const cleanedText = this.cleanText(mc.text);\n        const addressedToMessagingBot = this.isAddressedToMessagingBot(mc.text, mc.chatType);\n        const isAutoReplyCandidate = mc.chatType !== \"private\" && !addressedToMessagingBot;\n\n        const eventBase = createConversationEvent({\n          platform: \"telegram\",\n          type: \"message\",\n          conversationId: mc.chatId,\n          conversationKind: mc.conversationKind,\n          ts: mc.msgId,\n          thread_ts: mc.threadTs,\n          sessionKey: mc.sessionKey,\n          user: mc.userId,\n          userName: mc.userName,\n          text: cleanedText,\n        }) as TelegramEvent;\n\n        await processMessageIntake({\n          eventBase,\n          office: this.workspace.office(eventBase.address),\n          isAutoReplyCandidate,\n          magicWord: {\n            addressed: addressedToMessagingBot || mc.chatType === \"private\",\n            scopeFallback: \"always\",\n          },\n          busyPolicy: \"reject\",\n          logEntryBase: {\n            date: new Date(mc.msg.date * 1000).toISOString(),\n            ts: mc.msgId,\n            ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n            user: mc.userId,\n            userName: mc.userName,\n            text: cleanedText,\n            isMessagingBot: false,\n          },\n          log: (entry) => this.logToFile(mc.chatId, entry),\n          processAttachments: () => this.processAttachments(mc.chatId, mc.msg),\n          queueKey: mc.sessionKey,\n          enqueue: (queueKey, work) => this.getQueue(queueKey).enqueue(work),\n          handler: this.handler,\n          bot: this,\n          createContext: (event) => createTelegramAdapters(event, this),\n        });\n      }),\n    );\n  }\n}\n"]}

package/dist/agent/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/agent/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAqB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS1D,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,gBAAgB,GACzB;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CAuDvD;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7D,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2C7B"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/agent/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,KAAK,GAAG,EAAE,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAqB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAS1D,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,gBAAgB,GACzB;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,iBAAiB,EAAE,MAAM,EAAE,CAAA;CAAE,CA2DvD;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7D,YAAY,EAAE,YAAY,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2C7B"}

package/dist/agent/catalog.js

@@ -26,7 +26,11 @@ export function loadMikanSkills(office, workspacePath, projection, packages) {
     const mounted = workspacePath !== hostWorkspacePath;
     for (const { slug, dir } of packages.skillDirs) {
         const runtimeDir = packageSkillRuntimeDir(slug);
-        for (const skill of loadSkillsFromDir({ dir, source: `package:${slug}` }).skills) {
+        for (const skill of loadSkillsFromDir({
+            dir,
+            source: `package:${slug}`,
+            rejectSymlinks: true,
+        }).skills) {
             if (mounted) {
                 skill.filePath = runtimeDir + skill.filePath.slice(dir.length);
                 skill.baseDir = runtimeDir + skill.baseDir.slice(dir.length);

package/dist/agent/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/agent/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Office } from \"../office/index.js\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport { type Api, type Model } from \"@earendil-works/pi-ai\";\nimport type { MikanModels, MikanSkill, SessionStore } from \"../harness/index.js\";\nimport { loadSkillsFromDir, MikanAgentSession } from \"../harness/index.js\";\nimport { runSubagent } from \"../harness/subagent-runner.js\";\nimport { loadSubagentProfiles } from \"../harness/subagent-profiles.js\";\nimport type { WorkspaceProjection } from \"../workspace-projection/types.js\";\nimport { packageSkillRuntimeDir } from \"../packages/index.js\";\nimport type { ResolvedPackages } from \"../packages/types.js\";\nimport * as log from \"../log.js\";\nimport type { createMikanTools } from \"../tools/index.js\";\nimport { createSubagentTool } from \"../tools/index.js\";\nimport { DEFAULT_GLOBAL_SUBAGENT_SLOTS, SubagentSlotPool } from \"../harness/subagent-slots.js\";\n\n// One process-wide fan-out account: per-conversation queues serialize runs,\n// but each run can fan out up to the per-run cap — without this shared\n// ceiling, N busy conversations hold N × cap live subagent sessions.\nconst globalSubagentSlots = new SubagentSlotPool(DEFAULT_GLOBAL_SUBAGENT_SLOTS);\n\nexport function loadMikanSkills(\n  office: Office,\n  workspacePath: string,\n  projection: WorkspaceProjection,\n  packages: ResolvedPackages,\n): { skills: MikanSkill[]; skippedSkillLinks: string[] } {\n  const skillMap = new Map<string, MikanSkill>();\n\n  // workspacePath is the runtime-side root (e.g. /workspace); host paths under\n  // the workspace root translate onto it for prompt references.\n  const hostWorkspacePath = office.workspace.root;\n  const translatePath = (hostPath: string): string => {\n    if (hostPath.startsWith(hostWorkspacePath)) {\n      return workspacePath + hostPath.slice(hostWorkspacePath.length);\n    }\n    return hostPath;\n  };\n\n  // Package skills are lowest precedence. In sandbox modes they are mounted\n  // read-only outside the workspace so scripts and templates remain available.\n  const mounted = workspacePath !== hostWorkspacePath;\n  for (const { slug, dir } of packages.skillDirs) {\n    const runtimeDir = packageSkillRuntimeDir(slug);\n    for (const skill of loadSkillsFromDir({ dir, source: `package:${slug}` }).skills) {\n      if (mounted) {\n        skill.filePath = runtimeDir + skill.filePath.slice(dir.length);\n        skill.baseDir = runtimeDir + skill.baseDir.slice(dir.length);\n      }\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  const workspaceSkillsDir = projection.promptSources.globalSkillsDir;\n  if (workspaceSkillsDir) {\n    for (const skill of loadSkillsFromDir({ dir: workspaceSkillsDir, source: \"workspace\" })\n      .skills) {\n      skill.filePath = translatePath(skill.filePath);\n      skill.baseDir = translatePath(skill.baseDir);\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  const conversationSkills = loadSkillsFromDir({\n    dir: projection.promptSources.conversationSkillsDir,\n    source: \"channel\",\n    rejectSymlinks: true,\n  });\n  const skippedSkillLinks: string[] = [];\n  for (const diagnostic of conversationSkills.diagnostics) {\n    if (diagnostic.code !== \"symlink\") continue;\n    log.logWarning(\"Skipping conversation skill entry (symlink)\", diagnostic.path);\n    skippedSkillLinks.push(translatePath(diagnostic.path));\n  }\n  for (const skill of conversationSkills.skills) {\n    skill.filePath = translatePath(skill.filePath);\n    skill.baseDir = translatePath(skill.baseDir);\n    skillMap.set(skill.name, skill);\n  }\n\n  return { skills: Array.from(skillMap.values()), skippedSkillLinks };\n}\n\nexport async function createConfiguredAgentSession(params: {\n  workspaceDir: string;\n  systemPrompt: string;\n  model: Model<Api>;\n  thinkingLevel: ThinkingLevel;\n  tools: Awaited<ReturnType<typeof createMikanTools>>[\"tools\"];\n  sessionStore: SessionStore;\n  models: MikanModels;\n}): Promise<MikanAgentSession> {\n  const { workspaceDir, systemPrompt, model, thinkingLevel, tools, sessionStore, models } = params;\n  const loadedProfiles = loadSubagentProfiles(workspaceDir);\n  for (const diagnostic of loadedProfiles.diagnostics) {\n    log.logWarning(`Subagent profile ignored: ${diagnostic.path}`, diagnostic.message);\n  }\n\n  const availableToolNames = new Set(tools.map((tool) => tool.name));\n  const runnableProfiles = new Map(\n    [...loadedProfiles.profiles].filter(([, profile]) =>\n      profile.tools.every((tool) => availableToolNames.has(tool)),\n    ),\n  );\n  let session: MikanAgentSession | undefined;\n  const subagentTool = createSubagentTool(\n    (request, hooks) =>\n      runSubagent({\n        request,\n        ...(hooks?.onActivity ? { onActivity: hooks.onActivity } : {}),\n        defaultModel: model,\n        thinkingLevel,\n        models,\n        workspaceDir,\n        availableTools: tools,\n        profiles: runnableProfiles,\n        slots: globalSubagentSlots,\n        parentMessages: [...session!.messages],\n        onUsage: session!.captureExternalUsageSink(),\n      }),\n    runnableProfiles,\n  );\n\n  session = new MikanAgentSession({\n    systemPrompt,\n    model,\n    thinkingLevel,\n    tools: [...tools, subagentTool],\n    models,\n    sessionStore,\n  });\n  const reloaded = await session.reloadFromSession();\n  if (reloaded > 0) log.logInfo(`Reloaded ${reloaded} messages from session context`);\n  return session;\n}\n"]}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/agent/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Office } from \"../office/index.js\";\nimport type { ThinkingLevel } from \"@earendil-works/pi-agent-core\";\nimport { type Api, type Model } from \"@earendil-works/pi-ai\";\nimport type { MikanModels, MikanSkill, SessionStore } from \"../harness/index.js\";\nimport { loadSkillsFromDir, MikanAgentSession } from \"../harness/index.js\";\nimport { runSubagent } from \"../harness/subagent-runner.js\";\nimport { loadSubagentProfiles } from \"../harness/subagent-profiles.js\";\nimport type { WorkspaceProjection } from \"../workspace-projection/types.js\";\nimport { packageSkillRuntimeDir } from \"../packages/index.js\";\nimport type { ResolvedPackages } from \"../packages/types.js\";\nimport * as log from \"../log.js\";\nimport type { createMikanTools } from \"../tools/index.js\";\nimport { createSubagentTool } from \"../tools/index.js\";\nimport { DEFAULT_GLOBAL_SUBAGENT_SLOTS, SubagentSlotPool } from \"../harness/subagent-slots.js\";\n\n// One process-wide fan-out account: per-conversation queues serialize runs,\n// but each run can fan out up to the per-run cap — without this shared\n// ceiling, N busy conversations hold N × cap live subagent sessions.\nconst globalSubagentSlots = new SubagentSlotPool(DEFAULT_GLOBAL_SUBAGENT_SLOTS);\n\nexport function loadMikanSkills(\n  office: Office,\n  workspacePath: string,\n  projection: WorkspaceProjection,\n  packages: ResolvedPackages,\n): { skills: MikanSkill[]; skippedSkillLinks: string[] } {\n  const skillMap = new Map<string, MikanSkill>();\n\n  // workspacePath is the runtime-side root (e.g. /workspace); host paths under\n  // the workspace root translate onto it for prompt references.\n  const hostWorkspacePath = office.workspace.root;\n  const translatePath = (hostPath: string): string => {\n    if (hostPath.startsWith(hostWorkspacePath)) {\n      return workspacePath + hostPath.slice(hostWorkspacePath.length);\n    }\n    return hostPath;\n  };\n\n  // Package skills are lowest precedence. In sandbox modes they are mounted\n  // read-only outside the workspace so scripts and templates remain available.\n  const mounted = workspacePath !== hostWorkspacePath;\n  for (const { slug, dir } of packages.skillDirs) {\n    const runtimeDir = packageSkillRuntimeDir(slug);\n    for (const skill of loadSkillsFromDir({\n      dir,\n      source: `package:${slug}`,\n      rejectSymlinks: true,\n    }).skills) {\n      if (mounted) {\n        skill.filePath = runtimeDir + skill.filePath.slice(dir.length);\n        skill.baseDir = runtimeDir + skill.baseDir.slice(dir.length);\n      }\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  const workspaceSkillsDir = projection.promptSources.globalSkillsDir;\n  if (workspaceSkillsDir) {\n    for (const skill of loadSkillsFromDir({ dir: workspaceSkillsDir, source: \"workspace\" })\n      .skills) {\n      skill.filePath = translatePath(skill.filePath);\n      skill.baseDir = translatePath(skill.baseDir);\n      skillMap.set(skill.name, skill);\n    }\n  }\n\n  const conversationSkills = loadSkillsFromDir({\n    dir: projection.promptSources.conversationSkillsDir,\n    source: \"channel\",\n    rejectSymlinks: true,\n  });\n  const skippedSkillLinks: string[] = [];\n  for (const diagnostic of conversationSkills.diagnostics) {\n    if (diagnostic.code !== \"symlink\") continue;\n    log.logWarning(\"Skipping conversation skill entry (symlink)\", diagnostic.path);\n    skippedSkillLinks.push(translatePath(diagnostic.path));\n  }\n  for (const skill of conversationSkills.skills) {\n    skill.filePath = translatePath(skill.filePath);\n    skill.baseDir = translatePath(skill.baseDir);\n    skillMap.set(skill.name, skill);\n  }\n\n  return { skills: Array.from(skillMap.values()), skippedSkillLinks };\n}\n\nexport async function createConfiguredAgentSession(params: {\n  workspaceDir: string;\n  systemPrompt: string;\n  model: Model<Api>;\n  thinkingLevel: ThinkingLevel;\n  tools: Awaited<ReturnType<typeof createMikanTools>>[\"tools\"];\n  sessionStore: SessionStore;\n  models: MikanModels;\n}): Promise<MikanAgentSession> {\n  const { workspaceDir, systemPrompt, model, thinkingLevel, tools, sessionStore, models } = params;\n  const loadedProfiles = loadSubagentProfiles(workspaceDir);\n  for (const diagnostic of loadedProfiles.diagnostics) {\n    log.logWarning(`Subagent profile ignored: ${diagnostic.path}`, diagnostic.message);\n  }\n\n  const availableToolNames = new Set(tools.map((tool) => tool.name));\n  const runnableProfiles = new Map(\n    [...loadedProfiles.profiles].filter(([, profile]) =>\n      profile.tools.every((tool) => availableToolNames.has(tool)),\n    ),\n  );\n  let session: MikanAgentSession | undefined;\n  const subagentTool = createSubagentTool(\n    (request, hooks) =>\n      runSubagent({\n        request,\n        ...(hooks?.onActivity ? { onActivity: hooks.onActivity } : {}),\n        defaultModel: model,\n        thinkingLevel,\n        models,\n        workspaceDir,\n        availableTools: tools,\n        profiles: runnableProfiles,\n        slots: globalSubagentSlots,\n        parentMessages: [...session!.messages],\n        onUsage: session!.captureExternalUsageSink(),\n      }),\n    runnableProfiles,\n  );\n\n  session = new MikanAgentSession({\n    systemPrompt,\n    model,\n    thinkingLevel,\n    tools: [...tools, subagentTool],\n    models,\n    sessionStore,\n  });\n  const reloaded = await session.reloadFromSession();\n  if (reloaded > 0) log.logInfo(`Reloaded ${reloaded} messages from session context`);\n  return session;\n}\n"]}

package/dist/agent/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,cAAc,EAAE,MAAM,aAAa,CAAC;AA4hBtF,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwGxF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/agent/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAiB,cAAc,EAAE,MAAM,aAAa,CAAC;AAypBtF,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CA6FxF"}

package/dist/agent/runner.js

@@ -6,7 +6,8 @@ import { resolveConversationSettings } from "../config.js";
 import { resolveConversationPackages } from "../packages/index.js";
 import { resolveWorkspaceProjection } from "../workspace-projection/index.js";
 import * as log from "../log.js";
-import { loadMcpTools } from "../mcp/loader.js";
+import { formatMcpServerInstructions, loadMcpTools } from "../mcp/loader.js";
+import { provisionOfficeOpenConnectorToken } from "../mcp/open-connector.js";
 import { assertSandboxSupportsWorkspacePolicy, getUnresolvedSandboxPathContext, } from "../sandbox/index.js";
 import { addLifecycleBreadcrumb, updateActiveSpanAttribution } from "../observability/sentry.js";
 import { ChatHistorySync } from "../sessions/chat-history-sync.js";
@@ -24,6 +25,11 @@ function buildThreadSessionName(message) {
     const userLabel = message?.userName || message?.user || "unknown";
     return `[${userLabel}]: ${text}`;
 }
+async function resolveRunnerMcpServers(options) {
+    if (options.trustModel === "open-trigger")
+        return {};
+    return provisionOfficeOpenConnectorToken(options.office, options.platformWorkspaceId, options.servers, options.signal);
+}
 async function preparePromptContext(params) {
     const { message, platform, office, executor, resolveForRun, session } = params;
     const conversationId = office.address.conversationId;
@@ -134,36 +140,58 @@ async function buildInitialSystemPrompt(params) {
         skippedSkillLinks,
     });
 }
+async function rollbackRunnerResource(label, cleanup) {
+    try {
+        await cleanup();
+    }
+    catch (error) {
+        log.logWarning(`Runner rollback failed to ${label}`, String(error));
+    }
+}
 async function openRunnerSessionManager(params) {
     const { contextFile, runtimeWorkspaceRoot, sessionKey, threadRootMessage } = params;
     const sessionManager = await openManagedSession(contextFile, runtimeWorkspaceRoot);
-    const threadSessionName = buildThreadSessionName(threadRootMessage);
-    if (isThreadSessionKey(sessionKey) &&
-        threadSessionName &&
-        (await sessionManager.getSessionName()) !== threadSessionName) {
-        await sessionManager.setSessionName(threadSessionName);
+    try {
+        const threadSessionName = buildThreadSessionName(threadRootMessage);
+        if (isThreadSessionKey(sessionKey) &&
+            threadSessionName &&
+            (await sessionManager.getSessionName()) !== threadSessionName) {
+            await sessionManager.setSessionName(threadSessionName);
+        }
+        return sessionManager;
+    }
+    catch (error) {
+        await rollbackRunnerResource("close the session writer", () => sessionManager.close());
+        throw error;
     }
-    return sessionManager;
 }
 async function createRunnerAgentSession(params) {
-    const { workspaceDir, systemPrompt, model, agentConfig, tools, sessionManager, modelRegistry } = params;
-    const mcpResult = await loadMcpTools(agentConfig.mcpServers ?? {});
+    const { workspaceDir, systemPrompt, model, agentConfig, tools, sessionManager, modelRegistry, signal, } = params;
+    const mcpResult = await loadMcpTools(agentConfig.mcpServers ?? {}, signal);
     for (const mcpError of mcpResult.errors) {
         log.logWarning(`[${params.conversationId}] MCP server unavailable: ${mcpError.server}`, mcpError.error);
     }
     if (mcpResult.tools.length > 0) {
         log.logInfo(`[${params.conversationId}] Loaded ${mcpResult.tools.length} MCP tool(s)`);
     }
-    const session = await createConfiguredAgentSession({
-        workspaceDir,
-        systemPrompt,
-        model,
-        thinkingLevel: agentConfig.thinkingLevel,
-        tools: [...tools, ...mcpResult.tools],
-        sessionStore: sessionManager,
-        models: modelRegistry,
-    });
-    return { mcpResult, session };
+    try {
+        signal?.throwIfAborted();
+        const mcpInstructions = formatMcpServerInstructions(mcpResult.instructions);
+        const session = await createConfiguredAgentSession({
+            workspaceDir,
+            systemPrompt: mcpInstructions ? `${systemPrompt}\n\n${mcpInstructions}` : systemPrompt,
+            model,
+            thinkingLevel: agentConfig.thinkingLevel,
+            tools: [...tools, ...mcpResult.tools],
+            sessionStore: sessionManager,
+            models: modelRegistry,
+        });
+        return { mcpResult, session };
+    }
+    catch (error) {
+        await rollbackRunnerResource("dispose MCP resources", mcpResult.dispose);
+        throw error;
+    }
 }
 async function runPreparedTurn(params) {
     const { prepared, message, responder, platform, runState, session, model, agentConfig, sessionUuid, conversationId, contextFile, sessionView, } = params;
@@ -311,12 +339,73 @@ function createRunnerInterface(params) {
         },
     };
 }
+async function finishRunnerCreation(params) {
+    const { options, conversationId, conversationDir, workspaceDir, executor, resolveForRun, model, modelRegistry, agentConfig, systemPrompt, sessionManager, toolBindings, } = params;
+    const { sessionKey, office, sessionScope, sessionView } = options;
+    const { contextFile } = sessionScope;
+    let acquiredMcpResult;
+    try {
+        const sessionUuid = extractSessionUuid(contextFile);
+        const chatSessionManager = new ChatHistorySync();
+        const { mcpResult, session } = await createRunnerAgentSession({
+            workspaceDir,
+            systemPrompt,
+            model,
+            agentConfig,
+            tools: toolBindings.tools,
+            sessionManager,
+            modelRegistry,
+            conversationId,
+            signal: options.signal,
+        });
+        acquiredMcpResult = mcpResult;
+        options.signal?.throwIfAborted();
+        const runState = createRunState();
+        attachSessionEventHandlers({ session, runState, model, agentConfig });
+        return createRunnerInterface({
+            conversationId,
+            conversationDir,
+            sessionKey,
+            office,
+            sessionUuid,
+            contextFile,
+            sessionView,
+            runState,
+            executor,
+            resolveForRun,
+            session,
+            model,
+            agentConfig,
+            sessionManager,
+            chatSessionManager,
+            mcpResult,
+            toolBindings,
+        });
+    }
+    catch (error) {
+        if (acquiredMcpResult) {
+            await rollbackRunnerResource("dispose MCP resources", acquiredMcpResult.dispose);
+        }
+        await rollbackRunnerResource("close the session writer", () => sessionManager.close());
+        throw error;
+    }
+}
 export async function createRunner(options) {
-    const { sandboxConfig, sessionKey, office, sessionScope, vaultManager, provisioner, resourceController, sessionView, platformToolPackFactories, } = options;
+    options.signal?.throwIfAborted();
+    const { sandboxConfig, sessionKey, office, trustModel, sessionScope, vaultManager, provisioner, resourceController, platformToolPackFactories, } = options;
     const conversationId = office.address.conversationId;
     const conversationDir = office.dir;
     const workspaceDir = office.workspace.root;
-    const agentConfig = resolveConversationSettings(office);
+    const resolvedAgentConfig = resolveConversationSettings(office);
+    const mcpServers = await resolveRunnerMcpServers({
+        office,
+        trustModel,
+        platformWorkspaceId: options.platformWorkspaceId,
+        servers: resolvedAgentConfig.mcpServers,
+        signal: options.signal,
+    });
+    options.signal?.throwIfAborted();
+    const agentConfig = { ...resolvedAgentConfig, mcpServers };
     const projection = resolveWorkspaceProjection(office);
     // Bootstrap validation fails runner creation early. resolveForRun repeats
     // the check against the actor-specific decision before any provider call.
@@ -343,6 +432,7 @@ export async function createRunner(options) {
         projection,
         sandboxConfig,
     });
+    options.signal?.throwIfAborted();
     const { contextFile, threadRootMessage } = sessionScope;
     const sessionManager = await openRunnerSessionManager({
         contextFile,
@@ -350,38 +440,18 @@ export async function createRunner(options) {
         sessionKey,
         threadRootMessage,
     });
-    const sessionUuid = extractSessionUuid(contextFile);
-    const chatSessionManager = new ChatHistorySync();
-    const { mcpResult, session } = await createRunnerAgentSession({
-        workspaceDir,
-        systemPrompt,
-        model,
-        agentConfig,
-        tools: toolBindings.tools,
-        sessionManager,
-        modelRegistry,
-        conversationId,
-    });
-    // Mutable per-run state - event handler references this
-    const runState = createRunState();
-    attachSessionEventHandlers({ session, runState, model, agentConfig });
-    return createRunnerInterface({
+    return finishRunnerCreation({
+        options,
         conversationId,
         conversationDir,
-        sessionKey,
-        office,
-        sessionUuid,
-        contextFile,
-        sessionView,
-        runState,
+        workspaceDir,
         executor,
         resolveForRun,
-        session,
         model,
+        modelRegistry,
         agentConfig,
+        systemPrompt,
         sessionManager,
-        chatSessionManager,
-        mcpResult,
         toolBindings,
     });
 }