@geminixiang/mama 0.2.0-beta.2 → 0.2.0-beta.20

package/dist/adapters/slack/session.js

@@ -0,0 +1,66 @@
+import { resolveChatSessionKey } from "../../session-policy.js";
+export function formatSlackSessionKey(ref) {
+    return ref.kind === "channel" ? ref.channelId : `${ref.channelId}:${ref.anchorTs}`;
+}
+export function parseSlackSessionKey(sessionKey) {
+    const separator = sessionKey.indexOf(":");
+    if (separator === -1) {
+        return { kind: "channel", channelId: sessionKey };
+    }
+    return {
+        kind: "fork",
+        channelId: sessionKey.slice(0, separator),
+        anchorTs: sessionKey.slice(separator + 1),
+    };
+}
+export function isSlackForkSessionKey(sessionKey) {
+    return parseSlackSessionKey(sessionKey).kind === "fork";
+}
+export function resolveSlackSessionRef(channelId, threadTs) {
+    return threadTs
+        ? { kind: "fork", channelId, anchorTs: threadTs }
+        : { kind: "channel", channelId };
+}
+export function resolveSlackSessionKey(channelId, threadTs) {
+    const conversationKind = channelId.startsWith("D") ? "direct" : "shared";
+    const sessionKey = resolveChatSessionKey({
+        conversationId: channelId,
+        conversationKind,
+        messageId: channelId,
+        threadTs,
+        persistentTopLevel: true,
+        scopeDirectThreads: true,
+    });
+    return formatSlackSessionKey(parseSlackSessionKey(sessionKey));
+}
+export function resolveSlackRootTs(messageTs, threadTs) {
+    return threadTs || messageTs;
+}
+export function isSlackMessageTs(ts) {
+    return typeof ts === "string" && /^\d+\.\d+$/.test(ts);
+}
+export function resolveSlackResponseRootTs(event) {
+    return event.thread_ts ?? (isSlackMessageTs(event.ts) ? resolveSlackRootTs(event.ts) : undefined);
+}
+export function planSlackAdapterSession(event, options = {}) {
+    const sessionKey = event.sessionKey ?? resolveSlackSessionKey(event.conversationId, event.thread_ts);
+    return {
+        sessionKey,
+        rootTs: options.initialMessageTs ?? resolveSlackResponseRootTs(event),
+        initialMessageTs: options.initialMessageTs,
+        isThreaded: !!event.thread_ts,
+    };
+}
+export function planSlackEventForkRun(event, anchorTs) {
+    if (!anchorTs || event.thread_ts) {
+        return { event };
+    }
+    return {
+        event: {
+            ...event,
+            sessionKey: resolveSlackSessionKey(event.conversationId, anchorTs),
+        },
+        initialMessageTs: anchorTs,
+    };
+}
+//# sourceMappingURL=session.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../../src/adapters/slack/session.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAyBhE,MAAM,UAAU,qBAAqB,CAAC,GAAoB;IACxD,OAAO,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACpD,CAAC;IACD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QACzC,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,oBAAoB,CAAC,UAAU,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,QAAiB;IACzE,OAAO,QAAQ;QACb,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;QACjD,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,QAAiB;IACzE,MAAM,gBAAgB,GAAqB,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3F,MAAM,UAAU,GAAG,qBAAqB,CAAC;QACvC,cAAc,EAAE,SAAS;QACzB,gBAAgB;QAChB,SAAS,EAAE,SAAS;QACpB,QAAQ;QACR,kBAAkB,EAAE,IAAI;QACxB,kBAAkB,EAAE,IAAI;KACzB,CAAC,CAAC;IACH,OAAO,qBAAqB,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,QAAiB;IACrE,OAAO,QAAQ,IAAI,SAAS,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAsB;IACrD,OAAO,OAAO,EAAE,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,KAAsD;IAEtD,OAAO,KAAK,CAAC,SAAS,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,KAA4B,EAC5B,OAAO,GAAkC,EAAE;IAE3C,MAAM,UAAU,GACd,KAAK,CAAC,UAAU,IAAI,sBAAsB,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IAEpF,OAAO;QACL,UAAU;QACV,MAAM,EAAE,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC,KAAK,CAAC;QACrE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAQ,EACR,QAAiB;IAEjB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,OAAO;QACL,KAAK,EAAE;YACL,GAAG,KAAK;YACR,UAAU,EAAE,sBAAsB,CAAC,KAAK,CAAC,cAAc,EAAE,QAAQ,CAAC;SACnE;QACD,gBAAgB,EAAE,QAAQ;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["import type { ConversationKind } from \"../../adapter.js\";\nimport { resolveChatSessionKey } from \"../../session-policy.js\";\n\ninterface SlackSessionEventLike {\n  conversationId: string;\n  ts: string;\n  thread_ts?: string;\n  sessionKey?: string;\n}\n\nexport type SlackSessionRef =\n  | { kind: \"channel\"; channelId: string }\n  | { kind: \"fork\"; channelId: string; anchorTs: string };\n\nexport interface SlackAdapterSessionPlan {\n  sessionKey: string;\n  rootTs?: string;\n  initialMessageTs?: string;\n  isThreaded: boolean;\n}\n\nexport interface SlackEventForkRunPlan<T extends SlackSessionEventLike> {\n  event: T;\n  initialMessageTs?: string;\n}\n\nexport function formatSlackSessionKey(ref: SlackSessionRef): string {\n  return ref.kind === \"channel\" ? ref.channelId : `${ref.channelId}:${ref.anchorTs}`;\n}\n\nexport function parseSlackSessionKey(sessionKey: string): SlackSessionRef {\n  const separator = sessionKey.indexOf(\":\");\n  if (separator === -1) {\n    return { kind: \"channel\", channelId: sessionKey };\n  }\n  return {\n    kind: \"fork\",\n    channelId: sessionKey.slice(0, separator),\n    anchorTs: sessionKey.slice(separator + 1),\n  };\n}\n\nexport function isSlackForkSessionKey(sessionKey: string): boolean {\n  return parseSlackSessionKey(sessionKey).kind === \"fork\";\n}\n\nexport function resolveSlackSessionRef(channelId: string, threadTs?: string): SlackSessionRef {\n  return threadTs\n    ? { kind: \"fork\", channelId, anchorTs: threadTs }\n    : { kind: \"channel\", channelId };\n}\n\nexport function resolveSlackSessionKey(channelId: string, threadTs?: string): string {\n  const conversationKind: ConversationKind = channelId.startsWith(\"D\") ? \"direct\" : \"shared\";\n  const sessionKey = resolveChatSessionKey({\n    conversationId: channelId,\n    conversationKind,\n    messageId: channelId,\n    threadTs,\n    persistentTopLevel: true,\n    scopeDirectThreads: true,\n  });\n  return formatSlackSessionKey(parseSlackSessionKey(sessionKey));\n}\n\nexport function resolveSlackRootTs(messageTs: string, threadTs?: string): string {\n  return threadTs || messageTs;\n}\n\nexport function isSlackMessageTs(ts: string | undefined): ts is string {\n  return typeof ts === \"string\" && /^\\d+\\.\\d+$/.test(ts);\n}\n\nexport function resolveSlackResponseRootTs(\n  event: Pick<SlackSessionEventLike, \"ts\" | \"thread_ts\">,\n): string | undefined {\n  return event.thread_ts ?? (isSlackMessageTs(event.ts) ? resolveSlackRootTs(event.ts) : undefined);\n}\n\nexport function planSlackAdapterSession(\n  event: SlackSessionEventLike,\n  options: { initialMessageTs?: string } = {},\n): SlackAdapterSessionPlan {\n  const sessionKey =\n    event.sessionKey ?? resolveSlackSessionKey(event.conversationId, event.thread_ts);\n\n  return {\n    sessionKey,\n    rootTs: options.initialMessageTs ?? resolveSlackResponseRootTs(event),\n    initialMessageTs: options.initialMessageTs,\n    isThreaded: !!event.thread_ts,\n  };\n}\n\nexport function planSlackEventForkRun<T extends SlackSessionEventLike>(\n  event: T,\n  anchorTs?: string,\n): SlackEventForkRunPlan<T> {\n  if (!anchorTs || event.thread_ts) {\n    return { event };\n  }\n\n  return {\n    event: {\n      ...event,\n      sessionKey: resolveSlackSessionKey(event.conversationId, anchorTs),\n    },\n    initialMessageTs: anchorTs,\n  };\n}\n"]}

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

@@ -1,4 +1,4 @@
-import type { AgentTool } from "@mariozechner/pi-agent-core";
+import type { AgentTool } from "@earendil-works/pi-agent-core";
 declare const attachSchema: import("@sinclair/typebox").TObject<{
     label: import("@sinclair/typebox").TString;
     path: import("@sinclair/typebox").TString;

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

@@ -1 +1 @@
-{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAI7D,QAAA,MAAM,YAAY;;;;EAIhB,CAAC;AAEH,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAC;IACrC,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CACtF,CA0CA","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { basename, extname, resolve as resolvePath } from \"path\";\n\nconst attachSchema = Type.Object({\n  label: Type.String({ description: \"Brief description of what you're sharing (shown to user)\" }),\n  path: Type.String({ description: \"Path to the file to attach\" }),\n  title: Type.Optional(Type.String({ description: \"Title for the file (defaults to filename)\" })),\n});\n\nexport function createAttachTool(): {\n  tool: AgentTool<typeof attachSchema>;\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n} {\n  let uploadFn: ((filePath: string, title?: string) => Promise<void>) | null = null;\n\n  const tool: AgentTool<typeof attachSchema> = {\n    name: \"attach\",\n    label: \"attach\",\n    description:\n      \"Attach a file to your response. Use this to share files, images, or documents with the user. Only files from /workspace/ can be attached.\",\n    parameters: attachSchema,\n    execute: async (\n      _toolCallId: string,\n      { path, title }: { label: string; path: string; title?: string },\n      signal?: AbortSignal,\n    ) => {\n      if (!uploadFn) {\n        throw new Error(\"Upload function not configured\");\n      }\n\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      const absolutePath = resolvePath(path);\n      const base = basename(absolutePath);\n      const ext = extname(base);\n      const fileName = title ? (ext && !title.endsWith(ext) ? `${title}${ext}` : title) : base;\n\n      await uploadFn(absolutePath, fileName);\n\n      return {\n        content: [{ type: \"text\" as const, text: `Attached file: ${fileName}` }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setUploadFunction: (fn) => {\n      uploadFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAI/D,QAAA,MAAM,YAAY;;;;EAIhB,CAAC;AAEH,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,EAAE,SAAS,CAAC,OAAO,YAAY,CAAC,CAAC;IACrC,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CACtF,CA0CA","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { basename, extname, resolve as resolvePath } from \"path\";\n\nconst attachSchema = Type.Object({\n  label: Type.String({ description: \"Brief description of what you're sharing (shown to user)\" }),\n  path: Type.String({ description: \"Path to the file to attach\" }),\n  title: Type.Optional(Type.String({ description: \"Title for the file (defaults to filename)\" })),\n});\n\nexport function createAttachTool(): {\n  tool: AgentTool<typeof attachSchema>;\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n} {\n  let uploadFn: ((filePath: string, title?: string) => Promise<void>) | null = null;\n\n  const tool: AgentTool<typeof attachSchema> = {\n    name: \"attach\",\n    label: \"attach\",\n    description:\n      \"Attach a file to your response. Use this to share files, images, or documents with the user. Only files from /workspace/ can be attached.\",\n    parameters: attachSchema,\n    execute: async (\n      _toolCallId: string,\n      { path, title }: { label: string; path: string; title?: string },\n      signal?: AbortSignal,\n    ) => {\n      if (!uploadFn) {\n        throw new Error(\"Upload function not configured\");\n      }\n\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      const absolutePath = resolvePath(path);\n      const base = basename(absolutePath);\n      const ext = extname(base);\n      const fileName = title ? (ext && !title.endsWith(ext) ? `${title}${ext}` : title) : base;\n\n      await uploadFn(absolutePath, fileName);\n\n      return {\n        content: [{ type: \"text\" as const, text: `Attached file: ${fileName}` }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setUploadFunction: (fn) => {\n      uploadFn = fn;\n    },\n  };\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/attach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AAEjE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC;IAC/F,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IAChE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAAC;CAChG,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB;IAI9B,IAAI,QAAQ,GAAiE,IAAI,CAAC;IAElF,MAAM,IAAI,GAAmC;QAC3C,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,2IAA2I;QAC7I,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,KAAK,EACZ,WAAmB,EACnB,EAAE,IAAI,EAAE,KAAK,EAAmD,EAChE,MAAoB,EACpB,EAAE;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEzF,MAAM,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAEvC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,QAAQ,EAAE,EAAE,CAAC;gBACxE,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE;YACxB,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@mariozechner/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { basename, extname, resolve as resolvePath } from \"path\";\n\nconst attachSchema = Type.Object({\n  label: Type.String({ description: \"Brief description of what you're sharing (shown to user)\" }),\n  path: Type.String({ description: \"Path to the file to attach\" }),\n  title: Type.Optional(Type.String({ description: \"Title for the file (defaults to filename)\" })),\n});\n\nexport function createAttachTool(): {\n  tool: AgentTool<typeof attachSchema>;\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n} {\n  let uploadFn: ((filePath: string, title?: string) => Promise<void>) | null = null;\n\n  const tool: AgentTool<typeof attachSchema> = {\n    name: \"attach\",\n    label: \"attach\",\n    description:\n      \"Attach a file to your response. Use this to share files, images, or documents with the user. Only files from /workspace/ can be attached.\",\n    parameters: attachSchema,\n    execute: async (\n      _toolCallId: string,\n      { path, title }: { label: string; path: string; title?: string },\n      signal?: AbortSignal,\n    ) => {\n      if (!uploadFn) {\n        throw new Error(\"Upload function not configured\");\n      }\n\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      const absolutePath = resolvePath(path);\n      const base = basename(absolutePath);\n      const ext = extname(base);\n      const fileName = title ? (ext && !title.endsWith(ext) ? `${title}${ext}` : title) : base;\n\n      await uploadFn(absolutePath, fileName);\n\n      return {\n        content: [{ type: \"text\" as const, text: `Attached file: ${fileName}` }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setUploadFunction: (fn) => {\n      uploadFn = fn;\n    },\n  };\n}\n"]}
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../../src/adapters/slack/tools/attach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AAEjE,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/B,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,0DAA0D,EAAE,CAAC;IAC/F,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;IAChE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC,CAAC;CAChG,CAAC,CAAC;AAEH,MAAM,UAAU,gBAAgB;IAI9B,IAAI,QAAQ,GAAiE,IAAI,CAAC;IAElF,MAAM,IAAI,GAAmC;QAC3C,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,QAAQ;QACf,WAAW,EACT,2IAA2I;QAC7I,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,KAAK,EACZ,WAAmB,EACnB,EAAE,IAAI,EAAE,KAAK,EAAmD,EAChE,MAAoB,EACpB,EAAE;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACvC,CAAC;YAED,MAAM,YAAY,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;YACpC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEzF,MAAM,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAEvC,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,kBAAkB,QAAQ,EAAE,EAAE,CAAC;gBACxE,OAAO,EAAE,SAAS;aACnB,CAAC;QACJ,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE;YACxB,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { AgentTool } from \"@earendil-works/pi-agent-core\";\nimport { Type } from \"@sinclair/typebox\";\nimport { basename, extname, resolve as resolvePath } from \"path\";\n\nconst attachSchema = Type.Object({\n  label: Type.String({ description: \"Brief description of what you're sharing (shown to user)\" }),\n  path: Type.String({ description: \"Path to the file to attach\" }),\n  title: Type.Optional(Type.String({ description: \"Title for the file (defaults to filename)\" })),\n});\n\nexport function createAttachTool(): {\n  tool: AgentTool<typeof attachSchema>;\n  setUploadFunction: (fn: (filePath: string, title?: string) => Promise<void>) => void;\n} {\n  let uploadFn: ((filePath: string, title?: string) => Promise<void>) | null = null;\n\n  const tool: AgentTool<typeof attachSchema> = {\n    name: \"attach\",\n    label: \"attach\",\n    description:\n      \"Attach a file to your response. Use this to share files, images, or documents with the user. Only files from /workspace/ can be attached.\",\n    parameters: attachSchema,\n    execute: async (\n      _toolCallId: string,\n      { path, title }: { label: string; path: string; title?: string },\n      signal?: AbortSignal,\n    ) => {\n      if (!uploadFn) {\n        throw new Error(\"Upload function not configured\");\n      }\n\n      if (signal?.aborted) {\n        throw new Error(\"Operation aborted\");\n      }\n\n      const absolutePath = resolvePath(path);\n      const base = basename(absolutePath);\n      const ext = extname(base);\n      const fileName = title ? (ext && !title.endsWith(ext) ? `${title}${ext}` : title) : base;\n\n      await uploadFn(absolutePath, fileName);\n\n      return {\n        content: [{ type: \"text\" as const, text: `Attached file: ${fileName}` }],\n        details: undefined,\n      };\n    },\n  };\n\n  return {\n    tool,\n    setUploadFunction: (fn) => {\n      uploadFn = fn;\n    },\n  };\n}\n"]}

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,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAUhF,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwDD,qBAAa,WAAY,YAAW,GAAG;IACrC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAa;IAEhC,YAAY,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAQ7E;IAMK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB3B;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,CAsB5E;IAED,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAerC;IAED,eAAe,IAAI,YAAY,CAQ9B;IAMK,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAclE;IAEK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE;IAEK,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBvF;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,CAIjF;IAED,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI9C;IAED,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAS9D;IAED;;;;OAIG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,GAAG,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAyBhD;YAKa,mBAAmB;IAgDjC,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,qBAAqB;IAmC7B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,kBAAkB;CA8H3B","sourcesContent":["import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, join } from \"path\";\nimport { Bot as GrammyBot, InputFile } from \"grammy\";\nimport type { Bot, BotEvent, BotHandler, PlatformInfo } from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { formatAlreadyWorking, formatNothingRunning } from \"../../ui-copy.js\";\nimport { createTelegramAdapters } from \"./context.js\";\nimport { escapeTelegramHtml } from \"./html.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface TelegramEvent extends BotEvent {\n  type: \"message\" | \"command\";\n  userName?: string;\n}\n\ninterface MessageContext {\n  msg: any;\n  text: string;\n  chatId: string;\n  chatType: string;\n  conversationKind: \"direct\" | \"shared\";\n  userId: string;\n  userName: string;\n  msgId: string;\n  threadTs: string | undefined;\n  sessionKey: string;\n}\n\n// ============================================================================\n// Per-channel queue for sequential processing\n// ============================================================================\n\ntype QueuedWork = () => Promise<void>;\n\nclass ChannelQueue {\n  private queue: QueuedWork[] = [];\n  private processing = false;\n\n  enqueue(work: QueuedWork): void {\n    this.queue.push(work);\n    this.processNext();\n  }\n\n  size(): number {\n    return this.queue.length;\n  }\n\n  private async processNext(): Promise<void> {\n    if (this.processing || this.queue.length === 0) return;\n    this.processing = true;\n    const work = this.queue.shift()!;\n    try {\n      await work();\n    } catch (err) {\n      log.logWarning(\"Telegram queue error\", err instanceof Error ? err.message : String(err));\n    }\n    this.processing = false;\n    this.processNext();\n  }\n}\n\n// ============================================================================\n// TelegramBot\n// ============================================================================\n\nfunction isTelegramHtmlParseError(message: string): boolean {\n  return message.includes(\"can't parse entities\");\n}\n\nexport class TelegramBot implements Bot {\n  private client: GrammyBot;\n  private handler: BotHandler;\n  private botToken: string;\n  private workingDir: string;\n  private botUserId: string | null = null;\n  private botUsername: string | null = null;\n  private queues = new Map<string, ChannelQueue>();\n  private startupTime: number = 0;\n\n  constructor(handler: BotHandler, config: { token: string; workingDir: string }) {\n    this.handler = handler;\n    this.botToken = config.token;\n    this.workingDir = config.workingDir;\n    this.client = new GrammyBot(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 Bot)\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    await this.client.api.setMyCommands([\n      { command: \"start\", description: \"Welcome message\" },\n      { command: \"help\", description: \"Show available commands\" },\n      { command: \"login\", description: \"Store credentials in your private vault\" },\n      { command: \"stop\", description: \"Stop ongoing conversation\" },\n      { command: \"new\", description: \"Reset conversation history and start fresh\" },\n    ]);\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();\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 updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    try {\n      await this.client.api.editMessageText(parseInt(channel), parseInt(ts), text, {\n        parse_mode: \"HTML\",\n      });\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      if (msg.includes(\"message is not modified\")) {\n        return;\n      }\n      if (!isTelegramHtmlParseError(msg)) {\n        throw err;\n      }\n      await this.client.api.editMessageText(\n        parseInt(channel),\n        parseInt(ts),\n        escapeTelegramHtml(text),\n        {\n          parse_mode: \"HTML\",\n        },\n      );\n    }\n  }\n\n  enqueueEvent(event: BotEvent): 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 adapters = createTelegramAdapters(event as TelegramEvent, this, true);\n      return this.handler.handleEvent(event, this, adapters, true);\n    });\n    return true;\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"telegram\",\n      formattingGuide:\n        '## 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>',\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    try {\n      const result = await this.client.api.sendMessage(chatId, text, { parse_mode: \"HTML\" });\n      return result.message_id;\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      if (!isTelegramHtmlParseError(msg)) {\n        throw err;\n      }\n      const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(text), {\n        parse_mode: \"HTML\",\n      });\n      return result.message_id;\n    }\n  }\n\n  async postPlainMessage(chatId: number, text: string): Promise<void> {\n    await this.client.api.sendMessage(chatId, text);\n  }\n\n  async postReply(chatId: number, replyToMessageId: number, text: string): Promise<number> {\n    try {\n      const result = await this.client.api.sendMessage(chatId, text, {\n        parse_mode: \"HTML\",\n        reply_parameters: { message_id: replyToMessageId },\n      });\n      return result.message_id;\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      if (!isTelegramHtmlParseError(msg)) {\n        throw err;\n      }\n      const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(text), {\n        parse_mode: \"HTML\",\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    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  logToFile(channel: string, entry: object): void {\n    const dir = join(this.workingDir, channel);\n    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });\n    appendFileSync(join(dir, \"log.jsonl\"), `${JSON.stringify(entry)}\\n`);\n  }\n\n  logBotResponse(channel: string, text: string, ts: string): void {\n    this.logToFile(channel, {\n      date: new Date().toISOString(),\n      ts,\n      user: \"bot\",\n      text,\n      attachments: [],\n      isBot: true,\n    });\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 ChatMessage: { name: string, localPath: string }[]\n   */\n  async processAttachments(\n    chatId: string,\n    message: any,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const downloads: Array<Promise<{ name: string; localPath: string } | null>> = [];\n\n    // Handle photos (take the largest size for best quality)\n    if (message.photo && message.photo.length > 0) {\n      const photos = message.photo;\n      const photo = photos[photos.length - 1]; // Largest photo\n      const fileId = photo.file_id;\n\n      downloads.push(this.processTelegramFile(chatId, fileId, `photo_${message.message_id}.jpg`));\n    }\n\n    // Handle documents\n    if (message.document) {\n      const doc = message.document;\n      const fileId = doc.file_id;\n      const fileName = doc.file_name ?? `document_${message.message_id}`;\n\n      downloads.push(this.processTelegramFile(chatId, fileId, fileName));\n    }\n\n    const attachments = await Promise.all(downloads);\n    return attachments.filter(\n      (attachment): attachment is { name: string; localPath: string } => attachment !== null,\n    );\n  }\n\n  /**\n   * Download a file from Telegram and return attachment metadata\n   */\n  private async processTelegramFile(\n    chatId: string,\n    fileId: string,\n    originalName: string,\n  ): Promise<{ name: string; localPath: string } | null> {\n    try {\n      // Get file info from Telegram\n      const file = await this.client.api.getFile(fileId);\n      if (!file.file_path) {\n        log.logWarning(\"Telegram file has no path\", fileId);\n        return null;\n      }\n\n      // Generate local filename\n      const ts = Date.now();\n      const sanitizedName = originalName.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${ts}_${sanitizedName}`;\n      const localPath = `${chatId}/attachments/${filename}`;\n      const fullDir = join(this.workingDir, chatId, \"attachments\");\n\n      if (!existsSync(fullDir)) mkdirSync(fullDir, { recursive: true });\n\n      // Construct download URL\n      const downloadUrl = `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`;\n\n      // Download the file\n      const response = await fetch(downloadUrl);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      writeFileSync(join(fullDir, filename), Buffer.from(buffer));\n\n      return {\n        name: originalName,\n        localPath: localPath,\n      };\n    } catch (err) {\n      log.logWarning(`Failed to process Telegram file`, `${originalName}: ${err}`);\n      return null;\n    }\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): ChannelQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new ChannelQueue();\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private extractMessageContext(msg: any): 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    // Private chats: single session per chat (no per-message splitting)\n    // Groups: per-thread sessions (use reply chain or unique message id)\n    const sessionKey = chatType === \"private\" ? chatId : `${chatId}:${threadTs ?? msgId}`;\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 isAddressedToBot(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 isStopText(text: string): boolean {\n    return /^\\/?stop(?:@\\w+)?$/i.test(text.trim());\n  }\n\n  private resolveStopTarget(mc: MessageContext): string | null {\n    if (this.handler.isRunning(mc.sessionKey)) return mc.sessionKey;\n\n    if (this.handler.isRunning(mc.chatId)) return mc.chatId;\n\n    if (mc.chatType === \"private\") return null;\n\n    const runningInChat = this.handler\n      .getRunningSessions()\n      .map((session) => session.sessionKey)\n      .filter((sessionKey) => sessionKey === mc.chatId || sessionKey.startsWith(`${mc.chatId}:`));\n\n    return runningInChat.length === 1 ? runningInChat[0] : null;\n  }\n\n  private setupEventHandlers(): void {\n    // --- Slash commands (registered before catch-all so grammY intercepts them) ---\n\n    this.client.command(\"start\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      await this.postMessageRaw(\n        parseInt(mc.chatId),\n        [\n          \"<b>Welcome!</b>\",\n          \"\",\n          \"I'm an AI coding agent. Send me a message or use these commands:\",\n          \"\",\n          \"/new — Reset conversation history and start fresh\",\n          \"/stop — Stop the current conversation\",\n          \"/help — Show available commands\",\n          \"/login — Store credentials in your private vault\",\n        ].join(\"\\n\"),\n      );\n    });\n\n    this.client.command(\"help\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      await this.postMessageRaw(\n        parseInt(mc.chatId),\n        [\n          \"<b>Available commands:</b>\",\n          \"\",\n          \"/start — Welcome message\",\n          \"/help — Show this help\",\n          \"/login — Store credentials in your private vault\",\n          \"/stop — Stop ongoing conversation\",\n          \"/new — Reset conversation history and start fresh\",\n          \"\",\n          \"You can also send a regular message to chat with the agent.\",\n        ].join(\"\\n\"),\n      );\n    });\n\n    this.client.command(\"stop\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      const stopTarget = this.resolveStopTarget(mc);\n      if (stopTarget) {\n        await this.handler.handleStop(stopTarget, mc.chatId, this);\n      } else {\n        await this.postMessage(mc.chatId, formatNothingRunning(\"telegram\"));\n      }\n    });\n\n    this.client.command(\"new\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      await this.handler.handleNew(mc.sessionKey, mc.chatId, this);\n    });\n\n    // --- Catch-all for regular (non-command) messages ---\n\n    this.client.on(\"message\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n\n      const cleanedText = this.cleanText(mc.text);\n      const addressedToBot = this.isAddressedToBot(mc.text, mc.chatType);\n\n      if (this.isStopText(cleanedText)) {\n        this.logToFile(mc.chatId, {\n          date: new Date(mc.msg.date * 1000).toISOString(),\n          ts: mc.msgId,\n          user: mc.userId,\n          userName: mc.userName,\n          text: cleanedText,\n          attachments: [],\n          isBot: false,\n        });\n\n        const stopTarget = this.resolveStopTarget(mc);\n        if (stopTarget) {\n          await this.handler.handleStop(stopTarget, mc.chatId, this);\n        } else if (addressedToBot || mc.chatType === \"private\") {\n          await this.postMessage(mc.chatId, formatNothingRunning(\"telegram\"));\n        }\n        return;\n      }\n\n      // In groups, only respond when addressed to bot\n      if (!addressedToBot) return;\n\n      // Process attachments\n      const processedAttachments = await this.processAttachments(mc.chatId, mc.msg);\n\n      const event: TelegramEvent = {\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        attachments: processedAttachments,\n      };\n\n      // Log the message\n      this.logToFile(mc.chatId, {\n        date: new Date(mc.msg.date * 1000).toISOString(),\n        ts: mc.msgId,\n        user: mc.userId,\n        userName: mc.userName,\n        text: cleanedText,\n        attachments: processedAttachments,\n        isBot: false,\n      });\n\n      if (this.handler.isRunning(mc.sessionKey)) {\n        await this.postMessage(mc.chatId, formatAlreadyWorking(\"telegram\", \"/stop\"));\n      } else {\n        this.getQueue(mc.sessionKey).enqueue(() => {\n          const adapters = createTelegramAdapters(event, this, false);\n          return this.handler.handleEvent(event, this, adapters, false);\n        });\n      }\n    });\n  }\n}\n"]}
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA8BhF,MAAM,WAAW,aAAc,SAAQ,QAAQ;IAC7C,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuBD,qBAAa,WAAY,YAAW,GAAG;IACrC,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,WAAW,CAAa;IAEhC,YAAY,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,EAQ7E;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,QAAQ,GAAG,OAAO,CAerC;IAED,eAAe,IAAI,YAAY,CAQ9B;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,GAAG,GACX,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAyBhD;YAKa,mBAAmB;IAgDjC,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,qBAAqB;IAsC7B,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;CA+H3B","sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"fs\";\nimport { basename, join } from \"path\";\nimport { Bot as GrammyBot, InputFile } from \"grammy\";\nimport type { Bot, BotEvent, BotHandler, PlatformInfo } from \"../../adapter.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../session-policy.js\";\nimport { evaluateAutoReplyPolicy } from \"../../trigger.js\";\nimport { formatAlreadyWorking, formatNothingRunning } from \"../../ui-copy.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  ChannelQueue,\n  resolveOnlyScopedStopTarget,\n  resolveStopTarget,\n  withRetry,\n} from \"../shared.js\";\nimport { createTelegramAdapters } from \"./context.js\";\nimport { escapeTelegramHtml } from \"./html.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 interface TelegramEvent extends BotEvent {\n  type: \"message\" | \"command\";\n  userName?: string;\n}\n\ninterface MessageContext {\n  msg: any;\n  text: string;\n  chatId: string;\n  chatType: string;\n  conversationKind: \"direct\" | \"shared\";\n  userId: string;\n  userName: string;\n  msgId: string;\n  threadTs: string | undefined;\n  sessionKey: string;\n}\n\n// ============================================================================\n// TelegramBot\n// ============================================================================\n\nfunction isTelegramHtmlParseError(message: string): boolean {\n  return message.includes(\"can't parse entities\");\n}\n\nexport class TelegramBot implements Bot {\n  private client: GrammyBot;\n  private handler: BotHandler;\n  private botToken: string;\n  private workingDir: string;\n  private botUserId: string | null = null;\n  private botUsername: string | null = null;\n  private queues = new Map<string, ChannelQueue>();\n  private startupTime: number = 0;\n\n  constructor(handler: BotHandler, config: { token: string; workingDir: string }) {\n    this.handler = handler;\n    this.botToken = config.token;\n    this.workingDir = config.workingDir;\n    this.client = new GrammyBot(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 Bot)\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    await this.client.api.setMyCommands([\n      { command: \"login\", description: \"Store credentials in your private vault\" },\n      { command: \"session\", description: \"Open the current session in the web viewer\" },\n      { command: \"model\", description: \"Switch this conversation's LLM model\" },\n      { command: \"sandbox\", description: \"Show or boost sandbox limits\" },\n      { command: \"stop\", description: \"Stop ongoing conversation\" },\n      { command: \"new\", description: \"Reset conversation history and start fresh\" },\n    ]);\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 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), text, {\n          parse_mode: \"HTML\",\n        });\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        if (msg.includes(\"message is not modified\")) {\n          return;\n        }\n        if (!isTelegramHtmlParseError(msg)) {\n          throw err;\n        }\n        await this.client.api.editMessageText(\n          parseInt(channel),\n          parseInt(ts),\n          escapeTelegramHtml(text),\n          {\n            parse_mode: \"HTML\",\n          },\n        );\n      }\n    });\n  }\n\n  enqueueEvent(event: BotEvent): 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 adapters = createTelegramAdapters(event as TelegramEvent, this);\n      return this.handler.handleEvent(event, this, adapters);\n    });\n    return true;\n  }\n\n  getPlatformInfo(): PlatformInfo {\n    return {\n      name: \"telegram\",\n      formattingGuide:\n        '## 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>',\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      try {\n        const result = await this.client.api.sendMessage(chatId, text, { parse_mode: \"HTML\" });\n        return result.message_id;\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        if (!isTelegramHtmlParseError(msg)) {\n          throw err;\n        }\n        const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(text), {\n          parse_mode: \"HTML\",\n        });\n        return result.message_id;\n      }\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      try {\n        const result = await this.client.api.sendMessage(chatId, text, {\n          parse_mode: \"HTML\",\n          reply_parameters: { message_id: replyToMessageId },\n        });\n        return result.message_id;\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        if (!isTelegramHtmlParseError(msg)) {\n          throw err;\n        }\n        const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(text), {\n          parse_mode: \"HTML\",\n          reply_parameters: { message_id: replyToMessageId },\n        });\n        return result.message_id;\n      }\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.workingDir, channel, entry);\n  }\n\n  logBotResponse(channel: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workingDir, 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 ChatMessage: { name: string, localPath: string }[]\n   */\n  async processAttachments(\n    chatId: string,\n    message: any,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const downloads: Array<Promise<{ name: string; localPath: string } | null>> = [];\n\n    // Handle photos (take the largest size for best quality)\n    if (message.photo && message.photo.length > 0) {\n      const photos = message.photo;\n      const photo = photos[photos.length - 1]; // Largest photo\n      const fileId = photo.file_id;\n\n      downloads.push(this.processTelegramFile(chatId, fileId, `photo_${message.message_id}.jpg`));\n    }\n\n    // Handle documents\n    if (message.document) {\n      const doc = message.document;\n      const fileId = doc.file_id;\n      const fileName = doc.file_name ?? `document_${message.message_id}`;\n\n      downloads.push(this.processTelegramFile(chatId, fileId, fileName));\n    }\n\n    const attachments = await Promise.all(downloads);\n    return attachments.filter(\n      (attachment): attachment is { name: string; localPath: string } => attachment !== null,\n    );\n  }\n\n  /**\n   * Download a file from Telegram and return attachment metadata\n   */\n  private async processTelegramFile(\n    chatId: string,\n    fileId: string,\n    originalName: string,\n  ): Promise<{ name: string; localPath: string } | null> {\n    try {\n      // Get file info from Telegram\n      const file = await this.client.api.getFile(fileId);\n      if (!file.file_path) {\n        log.logWarning(\"Telegram file has no path\", fileId);\n        return null;\n      }\n\n      // Generate local filename\n      const ts = Date.now();\n      const sanitizedName = originalName.replace(/[^a-zA-Z0-9._-]/g, \"_\");\n      const filename = `${ts}_${sanitizedName}`;\n      const localPath = `${chatId}/attachments/${filename}`;\n      const fullDir = join(this.workingDir, chatId, \"attachments\");\n\n      if (!existsSync(fullDir)) mkdirSync(fullDir, { recursive: true });\n\n      // Construct download URL\n      const downloadUrl = `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`;\n\n      // Download the file\n      const response = await fetch(downloadUrl);\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      const buffer = await response.arrayBuffer();\n      writeFileSync(join(fullDir, filename), Buffer.from(buffer));\n\n      return {\n        name: originalName,\n        localPath: localPath,\n      };\n    } catch (err) {\n      log.logWarning(`Failed to process Telegram file`, `${originalName}: ${err}`);\n      return null;\n    }\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): ChannelQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new ChannelQueue(\"Telegram\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private extractMessageContext(msg: any): 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 isAddressedToBot(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 isStopText(text: string): boolean {\n    return /^\\/?stop(?:@\\w+)?$/i.test(text.trim());\n  }\n\n  private resolveStopTarget(mc: MessageContext): string | null {\n    const directTarget = resolveStopTarget({\n      handler: this.handler,\n      conversationId: mc.chatId,\n      sessionKey: mc.sessionKey,\n    });\n    if (directTarget) return directTarget;\n    return resolveOnlyScopedStopTarget(this.handler, mc.chatId);\n  }\n\n  private setupEventHandlers(): void {\n    // --- Slash commands (registered before catch-all so grammY intercepts them) ---\n\n    this.client.command(\"stop\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      const stopTarget = this.resolveStopTarget(mc);\n      if (stopTarget) {\n        await this.handler.handleStop(stopTarget, mc.chatId, this);\n      } else {\n        await this.postMessage(mc.chatId, formatNothingRunning(\"telegram\"));\n      }\n    });\n\n    this.client.command(\"new\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      await this.handler.handleNewCommand(mc.sessionKey, mc.chatId, this);\n    });\n\n    this.client.command(\"sandbox\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n      const cleanedText = this.cleanText(mc.text).replace(/^\\/sandbox(?:@\\w+)?/i, \"/pi-sandbox\");\n      const event: TelegramEvent = {\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: cleanedText,\n        attachments: [],\n      };\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: cleanedText,\n        attachments: [],\n        isBot: false,\n      });\n      const adapters = createTelegramAdapters(event, this);\n      await this.handler.handleEvent(event, this, adapters);\n    });\n\n    // --- Catch-all for regular (non-command) messages ---\n\n    this.client.on(\"message\", async (ctx) => {\n      const mc = this.extractMessageContext(ctx.message);\n      if (!mc) return;\n\n      const cleanedText = this.cleanText(mc.text);\n      const addressedToBot = this.isAddressedToBot(mc.text, mc.chatType);\n\n      if (this.isStopText(cleanedText)) {\n        this.logToFile(mc.chatId, {\n          date: new Date(mc.msg.date * 1000).toISOString(),\n          ts: mc.msgId,\n          user: mc.userId,\n          userName: mc.userName,\n          text: cleanedText,\n          attachments: [],\n          isBot: false,\n        });\n\n        const stopTarget = this.resolveStopTarget(mc);\n        if (stopTarget) {\n          await this.handler.handleStop(stopTarget, mc.chatId, this);\n        } else if (addressedToBot || mc.chatType === \"private\") {\n          await this.postMessage(mc.chatId, formatNothingRunning(\"telegram\"));\n        }\n        return;\n      }\n\n      const isAutoReplyCandidate = mc.chatType !== \"private\" && !addressedToBot;\n\n      const eventBase: TelegramEvent = {\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      };\n\n      const triggerResult = isAutoReplyCandidate\n        ? await evaluateAutoReplyPolicy({ event: eventBase, workingDir: this.workingDir })\n        : ({ trigger: true, reason: \"addressed\" } as const);\n\n      const 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        isBot: false,\n      };\n\n      if (!triggerResult.trigger) {\n        this.logToFile(mc.chatId, { ...logEntryBase, attachments: [] });\n        return;\n      }\n\n      const processedAttachments = await this.processAttachments(mc.chatId, mc.msg);\n      const event: TelegramEvent = { ...eventBase, attachments: processedAttachments };\n\n      this.logToFile(mc.chatId, { ...logEntryBase, attachments: processedAttachments });\n\n      if (this.handler.isRunning(mc.sessionKey)) {\n        await this.postMessage(mc.chatId, formatAlreadyWorking(\"telegram\", \"/stop\"));\n      } else {\n        this.getQueue(mc.sessionKey).enqueue(() => {\n          const adapters = createTelegramAdapters(event, this);\n          return this.handler.handleEvent(event, this, adapters);\n        });\n      }\n    });\n  }\n}\n"]}

package/dist/adapters/telegram/bot.js

@@ -1,37 +1,20 @@
-import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { basename, join } from "path";
 import { Bot as GrammyBot, InputFile } from "grammy";
 import * as log from "../../log.js";
+import { resolveChatSessionKey } from "../../session-policy.js";
+import { evaluateAutoReplyPolicy } from "../../trigger.js";
 import { formatAlreadyWorking, formatNothingRunning } from "../../ui-copy.js";
+import { appendBotResponseLog, appendChannelLog, ChannelQueue, resolveOnlyScopedStopTarget, resolveStopTarget, withRetry, } from "../shared.js";
 import { createTelegramAdapters } from "./context.js";
 import { escapeTelegramHtml } from "./html.js";
-class ChannelQueue {
-    constructor() {
-        this.queue = [];
-        this.processing = false;
-    }
-    enqueue(work) {
-        this.queue.push(work);
-        this.processNext();
-    }
-    size() {
-        return this.queue.length;
-    }
-    async processNext() {
-        if (this.processing || this.queue.length === 0)
-            return;
-        this.processing = true;
-        const work = this.queue.shift();
-        try {
-            await work();
-        }
-        catch (err) {
-            log.logWarning("Telegram queue error", err instanceof Error ? err.message : String(err));
-        }
-        this.processing = false;
-        this.processNext();
-    }
+// 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.
+function telegramIsRateLimited(err) {
+    return err.error_code === 429;
 }
+const telegramRetry = (fn) => withRetry(fn, { isRateLimited: telegramIsRateLimited });
 // ============================================================================
 // TelegramBot
 // ============================================================================
@@ -61,9 +44,10 @@ export class TelegramBot {
         this.botUsername = me.username ?? null;
         this.startupTime = Date.now();
         await this.client.api.setMyCommands([
-            { command: "start", description: "Welcome message" },
-            { command: "help", description: "Show available commands" },
             { 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" },
         ]);
@@ -72,7 +56,7 @@ export class TelegramBot {
         this.client.start().catch((err) => {
             log.logWarning("Telegram polling error", err instanceof Error ? err.message : String(err));
         });
-        log.logConnected();
+        log.logConnected("Telegram");
         log.logInfo(`Telegram bot started as @${this.botUsername ?? this.botUserId}`);
     }
     async postMessage(channel, text) {
@@ -80,23 +64,25 @@ export class TelegramBot {
         return String(result);
     }
     async updateMessage(channel, ts, text) {
-        try {
-            await this.client.api.editMessageText(parseInt(channel), parseInt(ts), text, {
-                parse_mode: "HTML",
-            });
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            if (msg.includes("message is not modified")) {
-                return;
+        return telegramRetry(async () => {
+            try {
+                await this.client.api.editMessageText(parseInt(channel), parseInt(ts), text, {
+                    parse_mode: "HTML",
+                });
             }
-            if (!isTelegramHtmlParseError(msg)) {
-                throw err;
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                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",
+                });
             }
-            await this.client.api.editMessageText(parseInt(channel), parseInt(ts), escapeTelegramHtml(text), {
-                parse_mode: "HTML",
-            });
-        }
+        });
     }
     enqueueEvent(event) {
         const conversationId = event.conversationId;
@@ -107,8 +93,8 @@ export class TelegramBot {
         }
         log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);
         queue.enqueue(() => {
-            const adapters = createTelegramAdapters(event, this, true);
-            return this.handler.handleEvent(event, this, adapters, true);
+            const adapters = createTelegramAdapters(event, this);
+            return this.handler.handleEvent(event, this, adapters);
         });
         return true;
     }
@@ -124,43 +110,49 @@ export class TelegramBot {
     // Internal helpers (used by context.ts)
     // ==========================================================================
     async postMessageRaw(chatId, text) {
-        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;
+        return telegramRetry(async () => {
+            try {
+                const result = await this.client.api.sendMessage(chatId, text, { parse_mode: "HTML" });
+                return result.message_id;
             }
-            const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(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;
+            }
+        });
     }
     async postPlainMessage(chatId, text) {
-        await this.client.api.sendMessage(chatId, text);
+        return telegramRetry(async () => {
+            await this.client.api.sendMessage(chatId, text);
+        });
     }
     async postReply(chatId, replyToMessageId, text) {
-        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;
+        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;
             }
-            const result = await this.client.api.sendMessage(chatId, escapeTelegramHtml(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;
+            }
+        });
     }
     async deleteMessageRaw(chatId, messageId) {
         await this.client.api.deleteMessage(chatId, messageId);
@@ -169,25 +161,17 @@ export class TelegramBot {
         await this.client.api.sendChatAction(chatId, "typing");
     }
     async uploadFile(channel, filePath, title) {
-        const fileName = title ?? basename(filePath);
-        const fileContent = readFileSync(filePath);
-        await this.client.api.sendDocument(parseInt(channel), new InputFile(fileContent, fileName));
+        return telegramRetry(async () => {
+            const fileName = title ?? basename(filePath);
+            const fileContent = readFileSync(filePath);
+            await this.client.api.sendDocument(parseInt(channel), new InputFile(fileContent, fileName));
+        });
     }
     logToFile(channel, entry) {
-        const dir = join(this.workingDir, channel);
-        if (!existsSync(dir))
-            mkdirSync(dir, { recursive: true });
-        appendFileSync(join(dir, "log.jsonl"), `${JSON.stringify(entry)}\n`);
+        appendChannelLog(this.workingDir, channel, entry);
     }
     logBotResponse(channel, text, ts) {
-        this.logToFile(channel, {
-            date: new Date().toISOString(),
-            ts,
-            user: "bot",
-            text,
-            attachments: [],
-            isBot: true,
-        });
+        appendBotResponseLog(this.workingDir, channel, text, ts);
     }
     /**
      * Process attachments from a Telegram message
@@ -257,7 +241,7 @@ export class TelegramBot {
     getQueue(channelId) {
         let queue = this.queues.get(channelId);
         if (!queue) {
-            queue = new ChannelQueue();
+            queue = new ChannelQueue("Telegram");
             this.queues.set(channelId, queue);
         }
         return queue;
@@ -280,9 +264,12 @@ export class TelegramBot {
         const replyToId = msg.reply_to_message?.message_id;
         const threadTs = replyToId ? String(replyToId) : undefined;
         const conversationKind = chatType === "private" ? "direct" : "shared";
-        // Private chats: single session per chat (no per-message splitting)
-        // Groups: per-thread sessions (use reply chain or unique message id)
-        const sessionKey = chatType === "private" ? chatId : `${chatId}:${threadTs ?? msgId}`;
+        const sessionKey = resolveChatSessionKey({
+            conversationId: chatId,
+            conversationKind,
+            messageId: msgId,
+            threadTs,
+        });
         return {
             msg,
             text,
@@ -312,51 +299,17 @@ export class TelegramBot {
         return /^\/?stop(?:@\w+)?$/i.test(text.trim());
     }
     resolveStopTarget(mc) {
-        if (this.handler.isRunning(mc.sessionKey))
-            return mc.sessionKey;
-        if (this.handler.isRunning(mc.chatId))
-            return mc.chatId;
-        if (mc.chatType === "private")
-            return null;
-        const runningInChat = this.handler
-            .getRunningSessions()
-            .map((session) => session.sessionKey)
-            .filter((sessionKey) => sessionKey === mc.chatId || sessionKey.startsWith(`${mc.chatId}:`));
-        return runningInChat.length === 1 ? runningInChat[0] : null;
+        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("start", async (ctx) => {
-            const mc = this.extractMessageContext(ctx.message);
-            if (!mc)
-                return;
-            await this.postMessageRaw(parseInt(mc.chatId), [
-                "<b>Welcome!</b>",
-                "",
-                "I'm an AI coding agent. Send me a message or use these commands:",
-                "",
-                "/new — Reset conversation history and start fresh",
-                "/stop — Stop the current conversation",
-                "/help — Show available commands",
-                "/login — Store credentials in your private vault",
-            ].join("\n"));
-        });
-        this.client.command("help", async (ctx) => {
-            const mc = this.extractMessageContext(ctx.message);
-            if (!mc)
-                return;
-            await this.postMessageRaw(parseInt(mc.chatId), [
-                "<b>Available commands:</b>",
-                "",
-                "/start — Welcome message",
-                "/help — Show this help",
-                "/login — Store credentials in your private vault",
-                "/stop — Stop ongoing conversation",
-                "/new — Reset conversation history and start fresh",
-                "",
-                "You can also send a regular message to chat with the agent.",
-            ].join("\n"));
-        });
         this.client.command("stop", async (ctx) => {
             const mc = this.extractMessageContext(ctx.message);
             if (!mc)
@@ -373,7 +326,37 @@ export class TelegramBot {
             const mc = this.extractMessageContext(ctx.message);
             if (!mc)
                 return;
-            await this.handler.handleNew(mc.sessionKey, mc.chatId, this);
+            await this.handler.handleNewCommand(mc.sessionKey, mc.chatId, this);
+        });
+        this.client.command("sandbox", async (ctx) => {
+            const mc = this.extractMessageContext(ctx.message);
+            if (!mc)
+                return;
+            const cleanedText = this.cleanText(mc.text).replace(/^\/sandbox(?:@\w+)?/i, "/pi-sandbox");
+            const event = {
+                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: cleanedText,
+                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: cleanedText,
+                attachments: [],
+                isBot: false,
+            });
+            const adapters = createTelegramAdapters(event, this);
+            await this.handler.handleEvent(event, this, adapters);
         });
         // --- Catch-all for regular (non-command) messages ---
         this.client.on("message", async (ctx) => {
@@ -401,12 +384,8 @@ export class TelegramBot {
                 }
                 return;
             }
-            // In groups, only respond when addressed to bot
-            if (!addressedToBot)
-                return;
-            // Process attachments
-            const processedAttachments = await this.processAttachments(mc.chatId, mc.msg);
-            const event = {
+            const isAutoReplyCandidate = mc.chatType !== "private" && !addressedToBot;
+            const eventBase = {
                 type: "message",
                 conversationId: mc.chatId,
                 conversationKind: mc.conversationKind,
@@ -416,25 +395,33 @@ export class TelegramBot {
                 user: mc.userId,
                 userName: mc.userName,
                 text: cleanedText,
-                attachments: processedAttachments,
             };
-            // Log the message
-            this.logToFile(mc.chatId, {
+            const triggerResult = isAutoReplyCandidate
+                ? await evaluateAutoReplyPolicy({ event: eventBase, workingDir: this.workingDir })
+                : { trigger: true, reason: "addressed" };
+            const logEntryBase = {
                 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: cleanedText,
-                attachments: processedAttachments,
                 isBot: false,
-            });
+            };
+            if (!triggerResult.trigger) {
+                this.logToFile(mc.chatId, { ...logEntryBase, attachments: [] });
+                return;
+            }
+            const processedAttachments = await this.processAttachments(mc.chatId, mc.msg);
+            const event = { ...eventBase, attachments: processedAttachments };
+            this.logToFile(mc.chatId, { ...logEntryBase, attachments: processedAttachments });
             if (this.handler.isRunning(mc.sessionKey)) {
                 await this.postMessage(mc.chatId, formatAlreadyWorking("telegram", "/stop"));
             }
             else {
                 this.getQueue(mc.sessionKey).enqueue(() => {
-                    const adapters = createTelegramAdapters(event, this, false);
-                    return this.handler.handleEvent(event, this, adapters, false);
+                    const adapters = createTelegramAdapters(event, this);
+                    return this.handler.handleEvent(event, this, adapters);
                 });
             }
         });