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

package/dist/adapters/slack/types.d.ts

@@ -1,6 +1,7 @@
-import type { ConversationKind } from "../../adapter.js";
-import type { Attachment } from "../../store.js";
+import type { ConversationKind, OfficeAddress } from "../../adapter.js";
+import type { Attachment } from "../../types.js";
 export interface SlackEvent {
+    address: OfficeAddress;
     type: "mention" | "dm";
     conversationId: string;
     conversationKind: ConversationKind;
@@ -23,6 +24,8 @@ export interface SlackUser {
     id: string;
     userName: string;
     displayName: string;
+    /** From users.list is_bot; absent when the entry predates the flag. */
+    isBot?: boolean;
 }
 export interface SlackChannel {
     id: string;
@@ -81,4 +84,39 @@ export interface SlackBlockActionBody {
         name?: string;
     };
 }
+/**
+ * Host-side Slack operations for the Slack tool pack, keyed by conversation.
+ * main.ts implements these against the running SlackMessagingBot.
+ */
+export interface PlatformSlackOps {
+    postBlocks(conversationId: string, args: {
+        text: string;
+        blocks: object[];
+        threadTs?: string;
+    }): Promise<{
+        ts: string;
+    }>;
+    updateBlocks(conversationId: string, args: {
+        ts: string;
+        text: string;
+        blocks: object[];
+        threadTs?: string;
+    }): Promise<void>;
+    ownsBlockKitMessage(conversationId: string, ts: string, threadTs?: string): boolean;
+}
+/** Conversation-bound Slack Block Kit operations, provided by the host. */
+export interface SlackBlockKitOps {
+    postBlocks(args: {
+        text: string;
+        blocks: object[];
+        threadTs?: string;
+    }): Promise<{
+        ts: string;
+    }>;
+    updateBlocks(args: {
+        ts: string;
+        text: string;
+        blocks: object[];
+    }): Promise<void>;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/adapters/slack/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,8EAA8E;IAC9E,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,yGAAyG;IACzG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;CACpC;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,GAAG,UAAU;IACrD,KAAK,EAAE,CAAC,CAAC;IACT,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAOD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,gBAAgB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,SAAS,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/types.ts"],"names":[],"mappings":"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"}

package/dist/adapters/slack/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/slack/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationKind } from \"../../adapter.js\";\nimport type { Attachment } from \"../../store.js\";\n\nexport interface SlackEvent {\n  type: \"mention\" | \"dm\";\n  conversationId: string;\n  conversationKind: ConversationKind;\n  channel: string;\n  ts: string;\n  thread_ts?: string;\n  user: string;\n  text: string;\n  files?: Array<{ name?: string; url_private_download?: string; url_private?: string }>;\n  /** Processed attachments with local paths (populated after logUserMessage) */\n  attachments?: Attachment[];\n  /** Session key passed through to ConversationEvent so handleEvent uses the correct persistent session */\n  sessionKey?: string;\n}\n\nexport interface SlackUser {\n  id: string;\n  userName: string;\n  displayName: string;\n}\n\nexport interface SlackChannel {\n  id: string;\n  name: string;\n}\n\nexport interface SlackAdapterOptions {\n  initialMessageTs?: string;\n  replyMode?: \"top-level\" | \"thread\";\n}\n\nexport type SlackSessionRef =\n  | { kind: \"channel\"; channelId: string }\n  | { kind: \"thread\"; channelId: string; threadTs: string };\n\nexport interface SlackAdapterSessionPlan {\n  sessionKey: string;\n  rootTs?: string;\n  initialMessageTs?: string;\n  isThreaded: boolean;\n}\n\nexport interface SlackEventAnchorRunPlan<T = SlackEvent> {\n  event: T;\n  initialMessageTs?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Block action payload shapes (subset used by handleBlockAction /\n// handleSlackInteraction — @slack/types does not export these)\n// ---------------------------------------------------------------------------\n\nexport interface SlackBlockAction {\n  action_id: string;\n  block_id?: string;\n  type?: string;\n  value?: string;\n  selected_option?: { text?: { text?: string }; value?: string };\n  selected_options?: Array<{ text?: { text?: string }; value?: string }>;\n}\n\nexport interface SlackBlockActionBody {\n  actions?: SlackBlockAction[];\n  container?: { channel_id?: string; thread_ts?: string; message_ts?: string };\n  user?: { id?: string; username?: string; name?: string };\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/slack/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationKind, OfficeAddress } from \"../../adapter.js\";\nimport type { Attachment } from \"../../types.js\";\n\nexport interface SlackEvent {\n  address: OfficeAddress;\n  type: \"mention\" | \"dm\";\n  conversationId: string;\n  conversationKind: ConversationKind;\n  channel: string;\n  ts: string;\n  thread_ts?: string;\n  user: string;\n  text: string;\n  files?: Array<{ name?: string; url_private_download?: string; url_private?: string }>;\n  /** Processed attachments with local paths (populated after logUserMessage) */\n  attachments?: Attachment[];\n  /** Session key passed through to ConversationEvent so handleEvent uses the correct persistent session */\n  sessionKey?: string;\n}\n\nexport interface SlackUser {\n  id: string;\n  userName: string;\n  displayName: string;\n  /** From users.list is_bot; absent when the entry predates the flag. */\n  isBot?: boolean;\n}\n\nexport interface SlackChannel {\n  id: string;\n  name: string;\n}\n\nexport interface SlackAdapterOptions {\n  initialMessageTs?: string;\n  replyMode?: \"top-level\" | \"thread\";\n}\n\nexport type SlackSessionRef =\n  | { kind: \"channel\"; channelId: string }\n  | { kind: \"thread\"; channelId: string; threadTs: string };\n\nexport interface SlackAdapterSessionPlan {\n  sessionKey: string;\n  rootTs?: string;\n  initialMessageTs?: string;\n  isThreaded: boolean;\n}\n\nexport interface SlackEventAnchorRunPlan<T = SlackEvent> {\n  event: T;\n  initialMessageTs?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Block action payload shapes (subset used by handleBlockAction /\n// handleSlackInteraction — @slack/types does not export these)\n// ---------------------------------------------------------------------------\n\nexport interface SlackBlockAction {\n  action_id: string;\n  block_id?: string;\n  type?: string;\n  value?: string;\n  selected_option?: { text?: { text?: string }; value?: string };\n  selected_options?: Array<{ text?: { text?: string }; value?: string }>;\n}\n\nexport interface SlackBlockActionBody {\n  actions?: SlackBlockAction[];\n  container?: { channel_id?: string; thread_ts?: string; message_ts?: string };\n  user?: { id?: string; username?: string; name?: string };\n}\n\n/**\n * Host-side Slack operations for the Slack tool pack, keyed by conversation.\n * main.ts implements these against the running SlackMessagingBot.\n */\nexport interface PlatformSlackOps {\n  postBlocks(\n    conversationId: string,\n    args: { text: string; blocks: object[]; threadTs?: string },\n  ): Promise<{ ts: string }>;\n  updateBlocks(\n    conversationId: string,\n    args: { ts: string; text: string; blocks: object[]; threadTs?: string },\n  ): Promise<void>;\n  ownsBlockKitMessage(conversationId: string, ts: string, threadTs?: string): boolean;\n}\n\n/** Conversation-bound Slack Block Kit operations, provided by the host. */\nexport interface SlackBlockKitOps {\n  postBlocks(args: { text: string; blocks: object[]; threadTs?: string }): Promise<{ ts: string }>;\n  updateBlocks(args: { ts: string; text: string; blocks: object[] }): Promise<void>;\n}\n"]}

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

@@ -1,21 +1,24 @@
 import type { Message } from "grammy/types";
-import type { MessagingBot, ConversationEvent, MessagingEventHandler, MessagingInfo } from "../../adapter.js";
+import type { ConversationEvent, MessagingEventHandler, MessagingInfo } from "../../adapter.js";
+import { type MessagingBot } from "../../adapter.js";
+import { type Workspace } from "../../office/index.js";
 export type { TelegramEvent } from "./types.js";
 export declare class TelegramMessagingBot implements MessagingBot {
     private client;
     private handler;
     private botToken;
-    private workingDir;
+    private workspace;
     private botUserId;
     private botUsername;
     private queues;
     private startupTime;
     constructor(handler: MessagingEventHandler, config: {
         token: string;
-        workingDir: string;
+        workspace: Workspace;
     });
     start(): 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>;
     enqueueEvent(event: ConversationEvent): boolean;
     getMessagingInfo(): MessagingInfo;
@@ -36,16 +39,12 @@ export declare class TelegramMessagingBot implements MessagingBot {
         name: string;
         localPath: string;
     }[]>;
-    /**
-     * Download a file from Telegram and return attachment metadata
-     */
-    private processTelegramFile;
+    /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */
+    private telegramFileItem;
     private getQueue;
     private extractMessageContext;
     private isAddressedToMessagingBot;
     private cleanText;
-    private isStopText;
-    private resolveStopTarget;
     private setupEventHandlers;
 }
 //# sourceMappingURL=bot.d.ts.map

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,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EAErB,aAAa,EACd,MAAM,kBAAkB,CAAC;AAgC1B,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuBhD,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,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,UAAU,EAAE,MAAM,CAAA;KAAE,EAQxF;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAwB3B;IAEK,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;IAEK,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB5E;IAED,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAe9C;IAED,gBAAgB,IAAI,aAAa,CAQhC;IAMK,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgBlE;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,CAoBvF;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,CAyBhD;IAED;;OAEG;YACW,mBAAmB;IAwCjC,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,qBAAqB;IAsC7B,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;CAyH3B"}
+{"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;CAuH3B"}

package/dist/adapters/telegram/bot.js

@@ -1,13 +1,14 @@
-import { readFileSync } from "fs";
-import { basename, join } from "path";
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
 import { Bot as GrammyMessagingBot, InputFile } from "grammy";
+import { createConversationEvent } from "../../adapter.js";
 import * as log from "../../log.js";
-import { resolveChatSessionKey } from "../../sessions/policy.js";
-import { formatAlreadyWorking, formatNothingRunning } from "../../platform-messages.js";
-import { appendBotResponseLog, appendChannelLog, MessagingEventQueue, downloadUrlToFile, resolveOnlyScopedStopTarget, resolveStopTarget, withRetry, } from "../shared.js";
+import { resolveChatSessionKey } from "../../sessions/session-key.js";
+import { appendBotResponseLog, appendChannelLog, MessagingEventQueue, downloadUrlToFile, withRetry, saveIncomingAttachments, } from "../shared.js";
+import { telegramCommandMenu } from "../../commands/manifest.js";
 import { processMessageIntake } from "../intake.js";
 import { createTelegramAdapters } from "./context.js";
-import { escapeTelegramHtml } from "./html.js";
+import { createOfficeAddress } from "../../office/index.js";
 // grammY surfaces Telegram errors as `GrammyError` with `error_code` mirroring
 // the Bot API. 429 is the rate-limit status; the response also includes
 // `parameters.retry_after` but exponential backoff is good enough here.
@@ -18,8 +19,20 @@ const telegramRetry = (fn) => withRetry(fn, { isRateLimited: telegramIsRateLimit
 // ============================================================================
 // TelegramMessagingBot
 // ============================================================================
-function isTelegramHtmlParseError(message) {
-    return message.includes("can't parse entities");
+/**
+ * A response as a Telegram rich message.
+ *
+ * Telegram parses the markdown into native blocks itself — a GFM table becomes
+ * a real table, `##` a heading, a fence a code block. That is why this adapter
+ * has no converter of its own: unlike Slack and Discord, nothing here has to be
+ * translated before sending.
+ *
+ * It replaces the HTML pipeline, and with it the escape-and-retry dance that
+ * existed only because a model writing HTML by hand regularly produced markup
+ * Telegram rejected.
+ */
+function richMessage(markdown) {
+    return { markdown };
 }
 export class TelegramMessagingBot {
     constructor(handler, config) {
@@ -29,7 +42,7 @@ export class TelegramMessagingBot {
         this.startupTime = 0;
         this.handler = handler;
         this.botToken = config.token;
-        this.workingDir = config.workingDir;
+        this.workspace = config.workspace;
         this.client = new GrammyMessagingBot(config.token);
         this.client.catch((err) => {
             log.logWarning("Telegram error", err instanceof Error ? err.message : String(err));
@@ -43,14 +56,9 @@ export class TelegramMessagingBot {
         this.botUserId = String(me.id);
         this.botUsername = me.username ?? null;
         this.startupTime = Date.now();
-        await this.client.api.setMyCommands([
-            { command: "login", description: "Store credentials in your private vault" },
-            { command: "session", description: "Open the current session in the web viewer" },
-            { command: "model", description: "Switch this conversation's LLM model" },
-            { command: "sandbox", description: "Show or boost sandbox limits" },
-            { command: "stop", description: "Stop ongoing conversation" },
-            { command: "new", description: "Reset conversation history and start fresh" },
-        ]);
+        // Menu registration derives from the command manifest; routing is
+        // separate (native handlers below + intake/dispatch for the rest).
+        await this.client.api.setMyCommands(telegramCommandMenu());
         this.setupEventHandlers();
         // Start polling in background (bot.start() runs indefinitely)
         this.client.start().catch((err) => {
@@ -63,24 +71,28 @@ export class TelegramMessagingBot {
         const result = await this.postMessageRaw(parseInt(channel), text);
         return String(result);
     }
+    async addReaction(channel, messageTs, emoji) {
+        // Telegram reactions are set via setMessageReaction with a Unicode emoji.
+        // Short names (Slack style) won't resolve; callers should pass an emoji.
+        const name = emoji.replace(/^:|:$/g, "");
+        await telegramRetry(async () => {
+            await this.client.api.setMessageReaction(parseInt(channel), parseInt(messageTs), [
+                { type: "emoji", emoji: name },
+            ]);
+        });
+    }
     async updateMessage(channel, ts, text) {
         return telegramRetry(async () => {
             try {
-                await this.client.api.editMessageText(parseInt(channel), parseInt(ts), text, {
-                    parse_mode: "HTML",
-                });
+                await this.client.api.editMessageText(parseInt(channel), parseInt(ts), richMessage(text));
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                if (msg.includes("message is not modified")) {
+                // Editing to identical content is something streaming asks for
+                // constantly; it is a no-op, not a failure.
+                if (msg.includes("message is not modified"))
                     return;
-                }
-                if (!isTelegramHtmlParseError(msg)) {
-                    throw err;
-                }
-                await this.client.api.editMessageText(parseInt(channel), parseInt(ts), escapeTelegramHtml(text), {
-                    parse_mode: "HTML",
-                });
+                throw err;
             }
         });
     }
@@ -101,7 +113,8 @@ export class TelegramMessagingBot {
     getMessagingInfo() {
         return {
             name: "telegram",
-            formattingGuide: '## Telegram Formatting (HTML mode)\nBold: <b>text</b>, Italic: <i>text</i>, Code: <code>code</code>, Pre: <pre>code</pre>\nLinks: <a href="url">text</a>',
+            trustModel: "membership",
+            formattingGuide: "## Telegram Formatting (Markdown)\nWrite ordinary Markdown — headings, lists, tables, code fences, quotes and links all render natively. Nothing needs converting by hand.",
             channels: [],
             users: [],
         };
@@ -111,20 +124,8 @@ export class TelegramMessagingBot {
     // ==========================================================================
     async postMessageRaw(chatId, text) {
         return telegramRetry(async () => {
-            try {
-                const result = await this.client.api.sendMessage(chatId, text, { parse_mode: "HTML" });
-                return result.message_id;
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                if (!isTelegramHtmlParseError(msg)) {
-                    throw err;
-                }
-                const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(text), {
-                    parse_mode: "HTML",
-                });
-                return result.message_id;
-            }
+            const result = await this.client.api.sendRichMessage(chatId, richMessage(text));
+            return result.message_id;
         });
     }
     async postPlainMessage(chatId, text) {
@@ -134,24 +135,10 @@ export class TelegramMessagingBot {
     }
     async postReply(chatId, replyToMessageId, text) {
         return telegramRetry(async () => {
-            try {
-                const result = await this.client.api.sendMessage(chatId, text, {
-                    parse_mode: "HTML",
-                    reply_parameters: { message_id: replyToMessageId },
-                });
-                return result.message_id;
-            }
-            catch (err) {
-                const msg = err instanceof Error ? err.message : String(err);
-                if (!isTelegramHtmlParseError(msg)) {
-                    throw err;
-                }
-                const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(text), {
-                    parse_mode: "HTML",
-                    reply_parameters: { message_id: replyToMessageId },
-                });
-                return result.message_id;
-            }
+            const result = await this.client.api.sendRichMessage(chatId, richMessage(text), {
+                reply_parameters: { message_id: replyToMessageId },
+            });
+            return result.message_id;
         });
     }
     async deleteMessageRaw(chatId, messageId) {
@@ -168,10 +155,10 @@ export class TelegramMessagingBot {
         });
     }
     logToFile(channel, entry) {
-        appendChannelLog(this.workingDir, channel, entry);
+        appendChannelLog(this.workspace.office(createOfficeAddress("telegram", channel)), entry);
     }
     logBotResponse(channel, text, ts) {
-        appendBotResponseLog(this.workingDir, channel, text, ts);
+        appendBotResponseLog(this.workspace.office(createOfficeAddress("telegram", channel)), text, ts);
     }
     /**
      * Process attachments from a Telegram message
@@ -179,54 +166,34 @@ export class TelegramMessagingBot {
      * Returns format compatible with ConversationMessage: { name: string, localPath: string }[]
      */
     async processAttachments(chatId, message) {
-        const downloads = [];
-        // Handle photos (take the largest size for best quality)
-        if (message.photo && message.photo.length > 0) {
-            const photos = message.photo;
-            const photo = photos[photos.length - 1]; // Largest photo
-            const fileId = photo.file_id;
-            downloads.push(this.processTelegramFile(chatId, fileId, `photo_${message.message_id}.jpg`));
+        const items = [];
+        // Photos: take the largest size for best quality.
+        const photo = message.photo?.[message.photo.length - 1];
+        if (photo) {
+            items.push(this.telegramFileItem(photo.file_id, `photo_${message.message_id}.jpg`));
         }
-        // Handle documents
         if (message.document) {
             const doc = message.document;
-            const fileId = doc.file_id;
-            const fileName = doc.file_name ?? `document_${message.message_id}`;
-            downloads.push(this.processTelegramFile(chatId, fileId, fileName));
-        }
-        const attachments = await Promise.all(downloads);
-        return attachments.filter((attachment) => attachment !== null);
-    }
-    /**
-     * Download a file from Telegram and return attachment metadata
-     */
-    async processTelegramFile(chatId, fileId, originalName) {
-        try {
-            // Get file info from Telegram
-            const file = await this.client.api.getFile(fileId);
-            if (!file.file_path) {
-                log.logWarning("Telegram file has no path", fileId);
-                return null;
-            }
-            // Generate local filename
-            const ts = Date.now();
-            const sanitizedName = originalName.replace(/[^a-zA-Z0-9._-]/g, "_");
-            const filename = `${ts}_${sanitizedName}`;
-            const localPath = `${chatId}/attachments/${filename}`;
-            const fullDir = join(this.workingDir, chatId, "attachments");
-            // Construct download URL
-            const downloadUrl = `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`;
-            // Download the file
-            await downloadUrlToFile(downloadUrl, join(fullDir, filename));
-            return {
-                name: originalName,
-                localPath: localPath,
-            };
+            items.push(this.telegramFileItem(doc.file_id, doc.file_name ?? `document_${message.message_id}`));
         }
-        catch (err) {
-            log.logWarning(`Failed to process Telegram file`, `${originalName}: ${err}`);
-            return null;
+        const office = this.workspace.office(createOfficeAddress("telegram", chatId));
+        const { saved, failed } = await saveIncomingAttachments(office, items);
+        for (const failure of failed) {
+            log.logWarning(`Failed to process Telegram file`, `${failure.name}: ${failure.error}`);
         }
+        return saved.map((item) => ({ name: item.original, localPath: item.localPath }));
+    }
+    /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */
+    telegramFileItem(fileId, name) {
+        return {
+            name,
+            download: async (destPath) => {
+                const file = await this.client.api.getFile(fileId);
+                if (!file.file_path)
+                    throw new Error(`Telegram file has no path: ${fileId}`);
+                await downloadUrlToFile(`https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`, destPath);
+            },
+        };
     }
     // ==========================================================================
     // Private - Event Handlers
@@ -288,45 +255,49 @@ export class TelegramMessagingBot {
             return text.trim();
         return text.replace(new RegExp(`@${this.botUsername}`, "gi"), "").trim();
     }
-    isStopText(text) {
-        return /^\/?stop(?:@\w+)?$/i.test(text.trim());
-    }
-    resolveStopTarget(mc) {
-        const directTarget = resolveStopTarget({
-            handler: this.handler,
-            conversationId: mc.chatId,
-            sessionKey: mc.sessionKey,
-        });
-        if (directTarget)
-            return directTarget;
-        return resolveOnlyScopedStopTarget(this.handler, mc.chatId);
-    }
     setupEventHandlers() {
         // --- Slash commands (registered before catch-all so grammY intercepts them) ---
-        this.client.command("stop", async (ctx) => {
-            const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
-            if (!mc)
-                return;
-            const stopTarget = this.resolveStopTarget(mc);
-            if (stopTarget) {
-                await this.handler.handleStop(stopTarget, mc.chatId, this);
-            }
-            else {
-                await this.postMessage(mc.chatId, formatNothingRunning("telegram"));
-            }
-        });
+        // `/stop` is deliberately NOT registered here: it is a magic word owned by
+        // conversation intake, so the catch-all below must receive it.
         this.client.command("new", async (ctx) => {
             const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
             if (!mc)
                 return;
-            await this.handler.handleNewCommand(mc.sessionKey, mc.chatId, this);
+            const commandText = this.cleanText(mc.text);
+            const event = createConversationEvent({
+                platform: "telegram",
+                type: "command",
+                conversationId: mc.chatId,
+                conversationKind: mc.conversationKind,
+                ts: mc.msgId,
+                thread_ts: mc.threadTs,
+                sessionKey: mc.sessionKey,
+                user: mc.userId,
+                userName: mc.userName,
+                text: commandText,
+                attachments: [],
+            });
+            this.logToFile(mc.chatId, {
+                date: new Date(mc.msg.date * 1000).toISOString(),
+                ts: mc.msgId,
+                ...(mc.conversationKind === "shared" && mc.threadTs ? { threadTs: mc.threadTs } : {}),
+                user: mc.userId,
+                userName: mc.userName,
+                text: commandText,
+                attachments: [],
+                isMessagingBot: false,
+            });
+            await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));
         });
         this.client.command("sandbox", async (ctx) => {
             const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
             if (!mc)
                 return;
-            const cleanedText = this.cleanText(mc.text).replace(/^\/sandbox(?:@\w+)?/i, "/pi-sandbox");
-            const event = {
+            // The sandbox handler's grammar accepts /sandbox directly (manifest
+            // slash forms), so the user's spelling is logged and dispatched as-is.
+            const cleanedText = this.cleanText(mc.text);
+            const event = createConversationEvent({
+                platform: "telegram",
                 type: "command",
                 conversationId: mc.chatId,
                 conversationKind: mc.conversationKind,
@@ -337,7 +308,7 @@ export class TelegramMessagingBot {
                 userName: mc.userName,
                 text: cleanedText,
                 attachments: [],
-            };
+            });
             this.logToFile(mc.chatId, {
                 date: new Date(mc.msg.date * 1000).toISOString(),
                 ts: mc.msgId,
@@ -358,27 +329,9 @@ export class TelegramMessagingBot {
                 return;
             const cleanedText = this.cleanText(mc.text);
             const addressedToMessagingBot = this.isAddressedToMessagingBot(mc.text, mc.chatType);
-            if (this.isStopText(cleanedText)) {
-                this.logToFile(mc.chatId, {
-                    date: new Date(mc.msg.date * 1000).toISOString(),
-                    ts: mc.msgId,
-                    user: mc.userId,
-                    userName: mc.userName,
-                    text: cleanedText,
-                    attachments: [],
-                    isMessagingBot: false,
-                });
-                const stopTarget = this.resolveStopTarget(mc);
-                if (stopTarget) {
-                    await this.handler.handleStop(stopTarget, mc.chatId, this);
-                }
-                else if (addressedToMessagingBot || mc.chatType === "private") {
-                    await this.postMessage(mc.chatId, formatNothingRunning("telegram"));
-                }
-                return;
-            }
             const isAutoReplyCandidate = mc.chatType !== "private" && !addressedToMessagingBot;
-            const eventBase = {
+            const eventBase = createConversationEvent({
+                platform: "telegram",
                 type: "message",
                 conversationId: mc.chatId,
                 conversationKind: mc.conversationKind,
@@ -388,11 +341,16 @@ export class TelegramMessagingBot {
                 user: mc.userId,
                 userName: mc.userName,
                 text: cleanedText,
-            };
+            });
             await processMessageIntake({
                 eventBase,
-                workingDir: this.workingDir,
+                office: this.workspace.office(eventBase.address),
                 isAutoReplyCandidate,
+                magicWord: {
+                    addressed: addressedToMessagingBot || mc.chatType === "private",
+                    scopeFallback: "always",
+                },
+                busyPolicy: "reject",
                 logEntryBase: {
                     date: new Date(mc.msg.date * 1000).toISOString(),
                     ts: mc.msgId,
@@ -409,12 +367,6 @@ export class TelegramMessagingBot {
                 handler: this.handler,
                 bot: this,
                 createContext: (event) => createTelegramAdapters(event, this),
-                beforeEnqueue: async () => {
-                    if (!this.handler.isRunning(mc.sessionKey))
-                        return true;
-                    await this.postMessage(mc.chatId, formatAlreadyWorking("telegram", "/stop"));
-                    return false;
-                },
             });
         });
     }