@geminixiang/mikan 1.0.0-beta.7 → 1.0.0-beta.71

package/dist/adapters/slack/tool-pack.js

@@ -0,0 +1,45 @@
+import { createSlackBlockKitTool } from "./tools/blockkit.js";
+/**
+ * Slack capability pack: tools that post platform-native surfaces (Block Kit)
+ * the response renderer deliberately does not produce. bindRun enables the
+ * tools only for slack-named conversations so multi-platform processes stay
+ * safe.
+ */
+export function createSlackToolPack(ops) {
+    const { tool: blockkitTool, setSlackBlockKitOps } = createSlackBlockKitTool();
+    const ownedMessageTs = new Set();
+    let boundTarget;
+    return {
+        tools: [blockkitTool],
+        bindRun({ conversationId, platformName, threadTs }) {
+            if (platformName !== "slack") {
+                setSlackBlockKitOps(null);
+                return;
+            }
+            const target = `${conversationId}:${threadTs ?? "top-level"}`;
+            if (boundTarget !== target) {
+                ownedMessageTs.clear();
+                boundTarget = target;
+            }
+            setSlackBlockKitOps({
+                postBlocks: async (args) => {
+                    if (args.threadTs !== undefined && args.threadTs !== threadTs) {
+                        throw new Error("slack_blockkit cannot post outside the active conversation thread");
+                    }
+                    const result = await ops.postBlocks(conversationId, { ...args, threadTs });
+                    ownedMessageTs.add(result.ts);
+                    return result;
+                },
+                updateBlocks: async (args) => {
+                    if (!ownedMessageTs.has(args.ts) &&
+                        !ops.ownsBlockKitMessage(conversationId, args.ts, threadTs)) {
+                        throw new Error("slack_blockkit can only update messages posted by this tool");
+                    }
+                    await ops.updateBlocks(conversationId, { ...args, threadTs });
+                    ownedMessageTs.add(args.ts);
+                },
+            });
+        },
+    };
+}
+//# sourceMappingURL=tool-pack.js.map

package/dist/adapters/slack/tool-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-pack.js","sourceRoot":"","sources":["../../../src/adapters/slack/tool-pack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAI9D;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAqB;IACvD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAC9E,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,IAAI,WAA+B,CAAC;IAEpC,OAAO;QACL,KAAK,EAAE,CAAC,YAAY,CAAC;QACrB,OAAO,CAAC,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE;YAChD,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;gBAC7B,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,MAAM,MAAM,GAAG,GAAG,cAAc,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;YAC9D,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBAC3B,cAAc,CAAC,KAAK,EAAE,CAAC;gBACvB,WAAW,GAAG,MAAM,CAAC;YACvB,CAAC;YACD,mBAAmB,CAAC;gBAClB,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBACzB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;wBAC9D,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;oBACvF,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,UAAU,CAAC,cAAc,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC3E,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC9B,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;oBAC3B,IACE,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC5B,CAAC,GAAG,CAAC,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,EAC3D,CAAC;wBACD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;oBACjF,CAAC;oBACD,MAAM,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC9D,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9B,CAAC;aACF,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { PlatformToolPack } from \"../../harness/tools/types.js\";\nimport { createSlackBlockKitTool } from \"./tools/blockkit.js\";\nexport type { PlatformSlackOps } from \"./types.js\";\nimport type { PlatformSlackOps } from \"./types.js\";\n\n/**\n * Slack capability pack: tools that post platform-native surfaces (Block Kit)\n * the response renderer deliberately does not produce. bindRun enables the\n * tools only for slack-named conversations so multi-platform processes stay\n * safe.\n */\nexport function createSlackToolPack(ops: PlatformSlackOps): PlatformToolPack {\n  const { tool: blockkitTool, setSlackBlockKitOps } = createSlackBlockKitTool();\n  const ownedMessageTs = new Set<string>();\n  let boundTarget: string | undefined;\n\n  return {\n    tools: [blockkitTool],\n    bindRun({ conversationId, platformName, threadTs }) {\n      if (platformName !== \"slack\") {\n        setSlackBlockKitOps(null);\n        return;\n      }\n      const target = `${conversationId}:${threadTs ?? \"top-level\"}`;\n      if (boundTarget !== target) {\n        ownedMessageTs.clear();\n        boundTarget = target;\n      }\n      setSlackBlockKitOps({\n        postBlocks: async (args) => {\n          if (args.threadTs !== undefined && args.threadTs !== threadTs) {\n            throw new Error(\"slack_blockkit cannot post outside the active conversation thread\");\n          }\n          const result = await ops.postBlocks(conversationId, { ...args, threadTs });\n          ownedMessageTs.add(result.ts);\n          return result;\n        },\n        updateBlocks: async (args) => {\n          if (\n            !ownedMessageTs.has(args.ts) &&\n            !ops.ownsBlockKitMessage(conversationId, args.ts, threadTs)\n          ) {\n            throw new Error(\"slack_blockkit can only update messages posted by this tool\");\n          }\n          await ops.updateBlocks(conversationId, { ...args, threadTs });\n          ownedMessageTs.add(args.ts);\n        },\n      });\n    },\n  };\n}\n"]}

package/dist/adapters/slack/tools/blockkit.d.ts

@@ -0,0 +1,14 @@
+import type { AgentTool } from "@earendil-works/pi-agent-core";
+export type { SlackBlockKitOps } from "../types.js";
+import type { SlackBlockKitOps } from "../types.js";
+declare const blockkitSchema: import("@sinclair/typebox").TObject<{
+    blocks: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnknown>;
+    text: import("@sinclair/typebox").TString;
+    thread_ts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    update_ts: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare function createSlackBlockKitTool(): {
+    tool: AgentTool<typeof blockkitSchema>;
+    setSlackBlockKitOps: (ops: SlackBlockKitOps | null) => void;
+};
+//# sourceMappingURL=blockkit.d.ts.map

package/dist/adapters/slack/tools/blockkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockkit.d.ts","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/blockkit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMpD,QAAA,MAAM,cAAc;;;;;EAoBlB,CAAC;AAyCH,wBAAgB,uBAAuB,IAAI;IACzC,IAAI,EAAE,SAAS,CAAC,OAAO,cAAc,CAAC,CAAC;IACvC,mBAAmB,EAAE,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,CAAC;CAC7D,CAgEA"}

package/dist/adapters/slack/tools/blockkit.js

@@ -0,0 +1,106 @@
+import { Type } from "@sinclair/typebox";
+/** Slack's own ceilings: 50 blocks per message, and a payload well under 64KB. */
+const MAX_BLOCKS = 50;
+const MAX_ARGUMENT_BYTES = 64 * 1024;
+const blockkitSchema = Type.Object({
+    blocks: Type.Array(Type.Unknown(), {
+        maxItems: MAX_BLOCKS,
+        description: `Slack Block Kit blocks (max ${MAX_BLOCKS}). Use {type:'markdown', text} for prose, {type:'table'} for tables, and actions/section blocks for buttons and select menus.`,
+    }),
+    text: Type.String({
+        description: "Plain-text fallback shown in notifications and screen readers",
+    }),
+    thread_ts: Type.Optional(Type.String({
+        description: "Optional active-thread TS. Posts are always constrained to the current conversation thread.",
+    })),
+    update_ts: Type.Optional(Type.String({
+        description: "Update a message previously posted by slack_blockkit in this conversation instead of posting a new one.",
+    })),
+});
+/**
+ * Reject a runaway payload before schema validation sees it.
+ *
+ * `prepareArguments` runs ahead of validation, which reports a failure by
+ * embedding the entire argument object in its message. A malformed multi-
+ * hundred-KB `blocks` array therefore lands in the session twice — once as the
+ * call, once echoed back as the result — and every later reader pays for it.
+ * Only a bounded result belongs there, so the size complaint stays short and
+ * never quotes what it rejected.
+ */
+function guardBlockKitArguments(args) {
+    if (!args || typeof args !== "object")
+        return args;
+    const bytes = Buffer.byteLength(JSON.stringify(args) ?? "", "utf-8");
+    if (bytes > MAX_ARGUMENT_BYTES) {
+        throw new Error(`slack_blockkit arguments are ${Math.round(bytes / 1024)}KB, over the ${MAX_ARGUMENT_BYTES / 1024}KB limit. ` +
+            "Post a short message and attach the long content as a file instead.");
+    }
+    const blocks = args.blocks;
+    if (Array.isArray(blocks) && blocks.length > MAX_BLOCKS) {
+        throw new Error(`slack_blockkit accepts at most ${MAX_BLOCKS} blocks, got ${blocks.length}.`);
+    }
+    return args;
+}
+function formatSlackApiError(err) {
+    const data = err?.data;
+    if (!data?.error)
+        return err instanceof Error ? err : new Error(String(err));
+    const details = data.response_metadata?.messages?.length
+        ? `\n${data.response_metadata.messages.join("\n")}`
+        : "";
+    return new Error(`Slack rejected the request: ${data.error}${details}\nFix the blocks JSON and retry.`);
+}
+export function createSlackBlockKitTool() {
+    let boundOps = null;
+    const tool = {
+        name: "slack_blockkit",
+        label: "slack_blockkit",
+        description: "Post an interactive Slack Block Kit message (buttons, select menus, custom layouts) to the current conversation, or update one previously posted with this tool. Normal replies already render Markdown — use this only when you need interactive elements or a layout Markdown cannot express. When a user clicks a button or picks an option, you receive a new message '[Slack action] <action_id>: <value>' — choose descriptive action_ids and values so the interaction tells you what to do. Returns the message ts; pass it back as update_ts to edit the message later (e.g. refreshing vote tallies). After handling an interaction, update the message via update_ts to replace the buttons with the outcome (e.g. '✅ approved') — buttons stay clickable otherwise and repeated clicks re-trigger the action. If Slack rejects the blocks, the error includes its validation messages — fix the JSON and retry.",
+        parameters: blockkitSchema,
+        prepareArguments: guardBlockKitArguments,
+        execute: async (_toolCallId, { blocks, text, thread_ts, update_ts, }, signal) => {
+            const ops = boundOps;
+            if (!ops) {
+                throw new Error("slack_blockkit is only available in Slack conversations");
+            }
+            if (signal?.aborted) {
+                throw new Error("Operation aborted");
+            }
+            try {
+                if (update_ts) {
+                    await ops.updateBlocks({ ts: update_ts, text, blocks: blocks });
+                    return {
+                        content: [
+                            { type: "text", text: `Updated Block Kit message (ts: ${update_ts}).` },
+                        ],
+                        details: undefined,
+                    };
+                }
+                const { ts } = await ops.postBlocks({
+                    text,
+                    blocks: blocks,
+                    threadTs: thread_ts,
+                });
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Posted Block Kit message (ts: ${ts}). Interactive elements will arrive as "[Slack action] <action_id>: <value>" messages; pass ts back as update_ts to edit this message.`,
+                        },
+                    ],
+                    details: undefined,
+                };
+            }
+            catch (err) {
+                throw formatSlackApiError(err);
+            }
+        },
+    };
+    return {
+        tool,
+        setSlackBlockKitOps: (ops) => {
+            boundOps = ops;
+        },
+    };
+}
+//# sourceMappingURL=blockkit.js.map

package/dist/adapters/slack/tools/blockkit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockkit.js","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/blockkit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nexport type { SlackBlockKitOps } from \"../types.js\";\nimport type { SlackBlockKitOps } from \"../types.js\";\n\n/** Slack's own ceilings: 50 blocks per message, and a payload well under 64KB. */\nconst MAX_BLOCKS = 50;\nconst MAX_ARGUMENT_BYTES = 64 * 1024;\n\nconst blockkitSchema = Type.Object({\n  blocks: Type.Array(Type.Unknown(), {\n    maxItems: MAX_BLOCKS,\n    description: `Slack Block Kit blocks (max ${MAX_BLOCKS}). Use {type:'markdown', text} for prose, {type:'table'} for tables, and actions/section blocks for buttons and select menus.`,\n  }),\n  text: Type.String({\n    description: \"Plain-text fallback shown in notifications and screen readers\",\n  }),\n  thread_ts: Type.Optional(\n    Type.String({\n      description:\n        \"Optional active-thread TS. Posts are always constrained to the current conversation thread.\",\n    }),\n  ),\n  update_ts: Type.Optional(\n    Type.String({\n      description:\n        \"Update a message previously posted by slack_blockkit in this conversation instead of posting a new one.\",\n    }),\n  ),\n});\n\n/**\n * Reject a runaway payload before schema validation sees it.\n *\n * `prepareArguments` runs ahead of validation, which reports a failure by\n * embedding the entire argument object in its message. A malformed multi-\n * hundred-KB `blocks` array therefore lands in the session twice — once as the\n * call, once echoed back as the result — and every later reader pays for it.\n * Only a bounded result belongs there, so the size complaint stays short and\n * never quotes what it rejected.\n */\nfunction guardBlockKitArguments(args: unknown): unknown {\n  if (!args || typeof args !== \"object\") return args;\n  const bytes = Buffer.byteLength(JSON.stringify(args) ?? \"\", \"utf-8\");\n  if (bytes > MAX_ARGUMENT_BYTES) {\n    throw new Error(\n      `slack_blockkit arguments are ${Math.round(bytes / 1024)}KB, over the ${MAX_ARGUMENT_BYTES / 1024}KB limit. ` +\n        \"Post a short message and attach the long content as a file instead.\",\n    );\n  }\n  const blocks = (args as { blocks?: unknown }).blocks;\n  if (Array.isArray(blocks) && blocks.length > MAX_BLOCKS) {\n    throw new Error(`slack_blockkit accepts at most ${MAX_BLOCKS} blocks, got ${blocks.length}.`);\n  }\n  return args;\n}\n\nfunction formatSlackApiError(err: unknown): Error {\n  const data = (\n    err as { data?: { error?: string; response_metadata?: { messages?: string[] } } } | undefined\n  )?.data;\n  if (!data?.error) return err instanceof Error ? err : new Error(String(err));\n  const details = data.response_metadata?.messages?.length\n    ? `\\n${data.response_metadata.messages.join(\"\\n\")}`\n    : \"\";\n  return new Error(\n    `Slack rejected the request: ${data.error}${details}\\nFix the blocks JSON and retry.`,\n  );\n}\n\nexport function createSlackBlockKitTool(): {\n  tool: AgentTool<typeof blockkitSchema>;\n  setSlackBlockKitOps: (ops: SlackBlockKitOps | null) => void;\n} {\n  let boundOps: SlackBlockKitOps | null = null;\n\n  const tool: AgentTool<typeof blockkitSchema> = {\n    name: \"slack_blockkit\",\n    label: \"slack_blockkit\",\n    description:\n      \"Post an interactive Slack Block Kit message (buttons, select menus, custom layouts) to the current conversation, or update one previously posted with this tool. Normal replies already render Markdown — use this only when you need interactive elements or a layout Markdown cannot express. When a user clicks a button or picks an option, you receive a new message '[Slack action] <action_id>: <value>' — choose descriptive action_ids and values so the interaction tells you what to do. Returns the message ts; pass it back as update_ts to edit the message later (e.g. refreshing vote tallies). After handling an interaction, update the message via update_ts to replace the buttons with the outcome (e.g. '✅ approved') — buttons stay clickable otherwise and repeated clicks re-trigger the action. If Slack rejects the blocks, the error includes its validation messages — fix the JSON and retry.\",\n    parameters: blockkitSchema,\n    prepareArguments: guardBlockKitArguments as (args: unknown) => typeof blockkitSchema.static,\n    execute: async (\n      _toolCallId: string,\n      {\n        blocks,\n        text,\n        thread_ts,\n        update_ts,\n      }: { blocks: unknown[]; text: string; thread_ts?: string; update_ts?: string },\n      signal?: AbortSignal,\n    ) => {\n      const ops = boundOps;\n      if (!ops) {\n        throw new Error(\"slack_blockkit is only available in Slack conversations\");\n      }\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      try {\n        if (update_ts) {\n          await ops.updateBlocks({ ts: update_ts, text, blocks: blocks as object[] });\n          return {\n            content: [\n              { type: \"text\" as const, text: `Updated Block Kit message (ts: ${update_ts}).` },\n            ],\n            details: undefined,\n          };\n        }\n        const { ts } = await ops.postBlocks({\n          text,\n          blocks: blocks as object[],\n          threadTs: thread_ts,\n        });\n        return {\n          content: [\n            {\n              type: \"text\" as const,\n              text: `Posted Block Kit message (ts: ${ts}). Interactive elements will arrive as \"[Slack action] <action_id>: <value>\" messages; pass ts back as update_ts to edit this message.`,\n            },\n          ],\n          details: undefined,\n        };\n      } catch (err) {\n        throw formatSlackApiError(err);\n      }\n    },\n  };\n\n  return {\n    tool,\n    setSlackBlockKitOps: (ops) => {\n      boundOps = ops;\n    },\n  };\n}\n"]}

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 "../index.js";
+import type { Attachment } from "../../types.js";
 export interface SlackEvent {
+    address: OfficeAddress;
     type: "mention" | "dm";
     conversationId: string;
     conversationKind: ConversationKind;
@@ -23,10 +24,16 @@ 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;
     name: string;
+    /** Slack's own channel privacy flag; absent for DM entries and unknown channels. */
+    isPrivate?: boolean;
+    /** Slack Connect / externally shared channel — visible outside this workspace. */
+    isExternallyShared?: boolean;
 }
 export interface SlackAdapterOptions {
     initialMessageTs?: string;
@@ -81,4 +88,68 @@ 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>;
+}
+export interface AssistantThreadPayload {
+    user_id?: string;
+    channel_id?: string;
+    thread_ts?: string;
+    context?: AgentContext;
+}
+/**
+ * Which channel the person is viewing beside the pane. Slack spells this
+ * `context` on `app_home_opened` and `app_context_changed`, and `app_context`
+ * on `message.im` — the asymmetry is Slack's, normalized here.
+ */
+export interface AgentContext {
+    channel_id?: string;
+    team_id?: string;
+    enterprise_id?: string | null;
+}
+export interface SuggestedPrompt {
+    title: string;
+    message: string;
+}
+/** What the adapter needs from the bot to serve this surface. */
+export interface AssistantSurfaceOps {
+    postInThread(channel: string, threadTs: string, text: string): Promise<string>;
+    /** `threadTs` omitted pins the prompts to the DM instead of one thread. */
+    setSuggestedPrompts(channel: string, threadTs: string | undefined, prompts: SuggestedPrompt[]): Promise<void>;
+    setTitle(channel: string, threadTs: string, title: string): Promise<void>;
+    /** Human-readable channel name for context, when the bot knows it. */
+    channelName(channelId: string): string | undefined;
+}
 //# 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 \"../index.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  /** Slack's own channel privacy flag; absent for DM entries and unknown channels. */\n  isPrivate?: boolean;\n  /** Slack Connect / externally shared channel — visible outside this workspace. */\n  isExternallyShared?: boolean;\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\n// ── assistant pane surface ──────────────────────────────────────────────────\n\nexport interface AssistantThreadPayload {\n  user_id?: string;\n  channel_id?: string;\n  thread_ts?: string;\n  context?: AgentContext;\n}\n\n/**\n * Which channel the person is viewing beside the pane. Slack spells this\n * `context` on `app_home_opened` and `app_context_changed`, and `app_context`\n * on `message.im` — the asymmetry is Slack's, normalized here.\n */\nexport interface AgentContext {\n  channel_id?: string;\n  team_id?: string;\n  enterprise_id?: string | null;\n}\n\nexport interface SuggestedPrompt {\n  title: string;\n  message: string;\n}\n\n/** What the adapter needs from the bot to serve this surface. */\nexport interface AssistantSurfaceOps {\n  postInThread(channel: string, threadTs: string, text: string): Promise<string>;\n  /** `threadTs` omitted pins the prompts to the DM instead of one thread. */\n  setSuggestedPrompts(\n    channel: string,\n    threadTs: string | undefined,\n    prompts: SuggestedPrompt[],\n  ): Promise<void>;\n  setTitle(channel: string, threadTs: string, title: string): Promise<void>;\n  /** Human-readable channel name for context, when the bot knows it. */\n  channelName(channelId: string): string | undefined;\n}\n"]}

package/dist/adapters/slack/update-diagnostics.d.ts

@@ -0,0 +1,14 @@
+import type { KnownBlock } from "@slack/types";
+/** Best-effort telemetry: must not mask an API error or fail a successful update. */
+export declare function recordSlackUpdate(owner: object, target: {
+    channel: string;
+    ts: string;
+}, source: string, payload: {
+    text: string;
+    blocks: KnownBlock[];
+}, outcome: {
+    error: unknown;
+} | {
+    success: true;
+}): void;
+//# sourceMappingURL=update-diagnostics.d.ts.map

package/dist/adapters/slack/update-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-diagnostics.d.ts","sourceRoot":"","sources":["../../../src/adapters/slack/update-diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqG/C,qFAAqF;AACrF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,EAC/C,OAAO,EAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAC9C,IAAI,CAmCN"}

package/dist/adapters/slack/update-diagnostics.js

@@ -0,0 +1,134 @@
+import { recordDiagnosticEvent } from "../../observability/index.js";
+// Diagnostic correlation only: eviction never changes transport behavior.
+const pending = new WeakMap();
+const MAX_PENDING = 128;
+const RETENTION_MS = 10 * 60_000;
+const ERROR_CODES = new Set([
+    "block_mismatch",
+    "invalid_blocks",
+    "msg_too_long",
+    "ratelimited",
+    "rate_limited",
+]);
+const BLOCK_TYPES = new Set([
+    "markdown",
+    "table",
+    "section",
+    "context",
+    "divider",
+    "actions",
+    "rich_text",
+]);
+function record(value) {
+    return value !== null && typeof value === "object" ? value : {};
+}
+function syntax(source) {
+    const trimmed = source.trimStart();
+    const fences = source.split("\n").filter((line) => /^\s*(`{3,}|~{3,})/.test(line));
+    return {
+        leadingConstruct: /^(?:`{3,}|~{3,})/.test(trimmed)
+            ? "fence"
+            : trimmed.startsWith("|")
+                ? "table_like"
+                : /^#{1,6}(?:\s|$)/.test(trimmed)
+                    ? "heading"
+                    : /^[*_-]/.test(trimmed)
+                        ? "list_or_emphasis"
+                        : /^[[<]/.test(trimmed)
+                            ? "link_like"
+                            : "other",
+        fenceLineCount: fences.length,
+        fenceWithWorkingSuffix: fences.some((line) => /^\s*(?:`{3,}|~{3,}) +\.\.\.\s*$/.test(line)),
+    };
+}
+function shape(source, payload) {
+    return {
+        sourceLength: source.length,
+        fallbackLength: payload.text.length,
+        blockCount: payload.blocks.length,
+        ...syntax(source),
+        // Flat arrays survive the existing Sentry depth limit. No text or identifiers.
+        blockTypes: payload.blocks
+            .slice(0, 50)
+            .map((block) => (BLOCK_TYPES.has(block.type) ? block.type : "other")),
+        markdownLengths: payload.blocks
+            .filter((block) => block.type === "markdown")
+            .slice(0, 50)
+            .map((block) => block.text.length),
+        tableRows: payload.blocks
+            .filter((block) => block.type === "table")
+            .slice(0, 50)
+            .map((block) => block.rows.length),
+        tableMaxColumns: payload.blocks
+            .filter((block) => block.type === "table")
+            .slice(0, 50)
+            .map((block) => Math.max(0, ...block.rows.map((row) => row.length))),
+    };
+}
+function validation(error) {
+    const data = record(record(error).data);
+    const messages = record(data.response_metadata).messages;
+    const details = Array.isArray(messages)
+        ? messages.slice(0, 10).filter((item) => typeof item === "string")
+        : [];
+    return {
+        errorCode: typeof data.error === "string" && ERROR_CODES.has(data.error) ? data.error : "other",
+        validationCount: Array.isArray(messages) ? messages.length : 0,
+        // Never copy a free-form Slack validation message: it can quote user content.
+        validationCategories: details.map((message) => /must be less than|maximum|too long/i.test(message)
+            ? "limit"
+            : /missing|required/i.test(message)
+                ? "required"
+                : /invalid|unsupported|not allowed/i.test(message)
+                    ? "invalid"
+                    : "other"),
+        blockIndices: details
+            .flatMap((message) => [...message.matchAll(/\/blocks\/(\d{1,3})(?=\/|\]|\s|$)/g)]
+            .slice(0, 10)
+            .map((match) => Number(match[1])))
+            .slice(0, 10),
+    };
+}
+/** Best-effort telemetry: must not mask an API error or fail a successful update. */
+export function recordSlackUpdate(owner, target, source, payload, outcome) {
+    try {
+        const { channel, ts } = target;
+        const now = Date.now();
+        let failures = pending.get(owner);
+        if (failures)
+            for (const [key, value] of failures) {
+                if (now - value.at >= RETENTION_MS)
+                    failures.delete(key);
+            }
+        const key = `${channel}:${ts}`;
+        const previous = failures?.get(key);
+        if ("success" in outcome && !previous)
+            return;
+        const attempts = (previous?.attempts ?? 0) + ("error" in outcome ? 1 : 0);
+        if ("error" in outcome) {
+            if (!failures) {
+                failures = new Map();
+                pending.set(owner, failures);
+            }
+            failures.delete(key);
+            failures.set(key, { at: now, attempts });
+            if (failures.size > MAX_PENDING)
+                failures.delete(failures.keys().next().value);
+        }
+        else {
+            failures?.delete(key);
+        }
+        recordDiagnosticEvent("error" in outcome ? "slack.update.rejected" : "slack.update.recovered", {
+            operation: "chat.update",
+            channelId: channel,
+            responseMessageId: ts,
+            failedAttempts: attempts,
+            ...shape(source, payload),
+            ...("error" in outcome ? validation(outcome.error) : {}),
+        });
+    }
+    catch {
+        // Observability must never change delivery or retry semantics.
+    }
+}
+//# sourceMappingURL=update-diagnostics.js.map

package/dist/adapters/slack/update-diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-diagnostics.js","sourceRoot":"","sources":["../../../src/adapters/slack/update-diagnostics.ts"],"names":[],"mappings":"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","sourcesContent":["import { recordDiagnosticEvent } from \"../../observability/index.js\";\nimport type { KnownBlock } from \"@slack/types\";\n\n// Diagnostic correlation only: eviction never changes transport behavior.\nconst pending = new WeakMap<object, Map<string, { at: number; attempts: number }>>();\nconst MAX_PENDING = 128;\nconst RETENTION_MS = 10 * 60_000;\nconst ERROR_CODES = new Set([\n  \"block_mismatch\",\n  \"invalid_blocks\",\n  \"msg_too_long\",\n  \"ratelimited\",\n  \"rate_limited\",\n]);\nconst BLOCK_TYPES = new Set([\n  \"markdown\",\n  \"table\",\n  \"section\",\n  \"context\",\n  \"divider\",\n  \"actions\",\n  \"rich_text\",\n]);\n\nfunction record(value: unknown): Record<string, unknown> {\n  return value !== null && typeof value === \"object\" ? (value as Record<string, unknown>) : {};\n}\n\nfunction syntax(source: string) {\n  const trimmed = source.trimStart();\n  const fences = source.split(\"\\n\").filter((line) => /^\\s*(`{3,}|~{3,})/.test(line));\n  return {\n    leadingConstruct: /^(?:`{3,}|~{3,})/.test(trimmed)\n      ? \"fence\"\n      : trimmed.startsWith(\"|\")\n        ? \"table_like\"\n        : /^#{1,6}(?:\\s|$)/.test(trimmed)\n          ? \"heading\"\n          : /^[*_-]/.test(trimmed)\n            ? \"list_or_emphasis\"\n            : /^[[<]/.test(trimmed)\n              ? \"link_like\"\n              : \"other\",\n    fenceLineCount: fences.length,\n    fenceWithWorkingSuffix: fences.some((line) => /^\\s*(?:`{3,}|~{3,}) +\\.\\.\\.\\s*$/.test(line)),\n  };\n}\n\nfunction shape(source: string, payload: { text: string; blocks: KnownBlock[] }) {\n  return {\n    sourceLength: source.length,\n    fallbackLength: payload.text.length,\n    blockCount: payload.blocks.length,\n    ...syntax(source),\n    // Flat arrays survive the existing Sentry depth limit. No text or identifiers.\n    blockTypes: payload.blocks\n      .slice(0, 50)\n      .map((block) => (BLOCK_TYPES.has(block.type) ? block.type : \"other\")),\n    markdownLengths: payload.blocks\n      .filter((block) => block.type === \"markdown\")\n      .slice(0, 50)\n      .map((block) => block.text.length),\n    tableRows: payload.blocks\n      .filter((block) => block.type === \"table\")\n      .slice(0, 50)\n      .map((block) => block.rows.length),\n    tableMaxColumns: payload.blocks\n      .filter((block) => block.type === \"table\")\n      .slice(0, 50)\n      .map((block) => Math.max(0, ...block.rows.map((row) => row.length))),\n  };\n}\n\nfunction validation(error: unknown) {\n  const data = record(record(error).data);\n  const messages = record(data.response_metadata).messages;\n  const details = Array.isArray(messages)\n    ? messages.slice(0, 10).filter((item): item is string => typeof item === \"string\")\n    : [];\n  return {\n    errorCode: typeof data.error === \"string\" && ERROR_CODES.has(data.error) ? data.error : \"other\",\n    validationCount: Array.isArray(messages) ? messages.length : 0,\n    // Never copy a free-form Slack validation message: it can quote user content.\n    validationCategories: details.map((message) =>\n      /must be less than|maximum|too long/i.test(message)\n        ? \"limit\"\n        : /missing|required/i.test(message)\n          ? \"required\"\n          : /invalid|unsupported|not allowed/i.test(message)\n            ? \"invalid\"\n            : \"other\",\n    ),\n    blockIndices: details\n      .flatMap((message) =>\n        [...message.matchAll(/\\/blocks\\/(\\d{1,3})(?=\\/|\\]|\\s|$)/g)]\n          .slice(0, 10)\n          .map((match) => Number(match[1])),\n      )\n      .slice(0, 10),\n  };\n}\n\n/** Best-effort telemetry: must not mask an API error or fail a successful update. */\nexport function recordSlackUpdate(\n  owner: object,\n  target: { channel: string; ts: string },\n  source: string,\n  payload: { text: string; blocks: KnownBlock[] },\n  outcome: { error: unknown } | { success: true },\n): void {\n  try {\n    const { channel, ts } = target;\n    const now = Date.now();\n    let failures = pending.get(owner);\n    if (failures)\n      for (const [key, value] of failures) {\n        if (now - value.at >= RETENTION_MS) failures.delete(key);\n      }\n    const key = `${channel}:${ts}`;\n    const previous = failures?.get(key);\n    if (\"success\" in outcome && !previous) return;\n    const attempts = (previous?.attempts ?? 0) + (\"error\" in outcome ? 1 : 0);\n    if (\"error\" in outcome) {\n      if (!failures) {\n        failures = new Map();\n        pending.set(owner, failures);\n      }\n      failures.delete(key);\n      failures.set(key, { at: now, attempts });\n      if (failures.size > MAX_PENDING) failures.delete(failures.keys().next().value!);\n    } else {\n      failures?.delete(key);\n    }\n    recordDiagnosticEvent(\"error\" in outcome ? \"slack.update.rejected\" : \"slack.update.recovered\", {\n      operation: \"chat.update\",\n      channelId: channel,\n      responseMessageId: ts,\n      failedAttempts: attempts,\n      ...shape(source, payload),\n      ...(\"error\" in outcome ? validation(outcome.error) : {}),\n    });\n  } catch {\n    // Observability must never change delivery or retry semantics.\n  }\n}\n"]}

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

@@ -1,20 +1,25 @@
 import type { Message } from "grammy/types";
-import type { MessagingBot, ConversationEvent, MessagingEventHandler, MessagingInfo } from "../../adapter.js";
+import type { ConversationEvent, MessagingEventHandler, MessagingInfo } from "../index.js";
+import { type MessagingBot } from "../index.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 stopped;
     private queues;
+    private intake;
     private startupTime;
     constructor(handler: MessagingEventHandler, config: {
         token: string;
-        workingDir: 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>;
@@ -37,16 +42,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,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,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":"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"}