@geminixiang/mikan 1.0.0-beta.76 → 1.0.0-beta.78

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

@@ -1 +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"]}
+{"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\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    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    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\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}\n"]}

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

@@ -33,16 +33,10 @@ export declare class TelegramMessagingBot implements MessagingBot {
     uploadFile(channel: string, filePath: string, title?: string): Promise<void>;
     logToFile(channel: string, entry: object): void;
     logBotResponse(channel: string, text: string, ts: string): void;
-    /**
-     * Process attachments from a Telegram message
-     * Downloads files before returning metadata so the agent can read them immediately
-     * Returns format compatible with ConversationMessage: { name: string, localPath: string }[]
-     */
     processAttachments(chatId: string, message: Message): Promise<{
         name: string;
         localPath: string;
     }[]>;
-    /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */
     private telegramFileItem;
     private getQueue;
     private extractMessageContext;

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

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

package/dist/adapters/telegram/bot.js

@@ -9,28 +9,10 @@ import { COMMAND_MANIFEST, telegramCommandMenu } from "../commands/manifest.js";
 import { processMessageIntake } from "../intake.js";
 import { createTelegramAdapters } from "./context.js";
 import { createOfficeAddress } from "../../office/index.js";
-// grammY surfaces Telegram errors as `GrammyError` with `error_code` mirroring
-// the Bot API. 429 is the rate-limit status; the response also includes
-// `parameters.retry_after` but exponential backoff is good enough here.
 function telegramIsRateLimited(err) {
     return err.error_code === 429;
 }
 const telegramRetry = (fn) => withRetry(fn, { isRateLimited: telegramIsRateLimited });
-// ============================================================================
-// TelegramMessagingBot
-// ============================================================================
-/**
- * A response as a Telegram rich message.
- *
- * Telegram parses the markdown into native blocks itself — a GFM table becomes
- * a real table, `##` a heading, a fence a code block. That is why this adapter
- * has no converter of its own: unlike Slack and Discord, nothing here has to be
- * translated before sending.
- *
- * It replaces the HTML pipeline, and with it the escape-and-retry dance that
- * existed only because a model writing HTML by hand regularly produced markup
- * Telegram rejected.
- */
 function richMessage(markdown) {
     return { markdown };
 }
@@ -50,22 +32,16 @@ export class TelegramMessagingBot {
             log.logWarning("Telegram error", err instanceof Error ? err.message : String(err));
         });
     }
-    // ==========================================================================
-    // Public API (implements MessagingBot)
-    // ==========================================================================
     async start() {
         this.stopped = false;
         const me = await this.client.api.getMe();
         this.botUserId = String(me.id);
         this.botUsername = me.username ?? null;
         this.startupTime = Date.now();
-        // Menu registration derives from the command manifest; routing is
-        // separate (native handlers below + intake/dispatch for the rest).
         await this.client.api.setMyCommands(telegramCommandMenu());
         if (this.stopped)
             return;
         this.setupEventHandlers();
-        // Start polling in background (bot.start() runs indefinitely)
         this.client.start().catch((err) => {
             log.logWarning("Telegram polling error", err instanceof Error ? err.message : String(err));
         });
@@ -87,9 +63,6 @@ export class TelegramMessagingBot {
         return String(result);
     }
     async addReaction(channel, messageTs, emoji) {
-        // Telegram reactions are set via setMessageReaction with a Unicode emoji;
-        // the `react` tool and prompt speak Slack-style short names, so translate
-        // here rather than push that mapping onto every caller.
         await telegramRetry(async () => {
             await this.client.api.setMessageReaction(parseInt(channel), parseInt(messageTs), [
                 { type: "emoji", emoji: shortNameToUnicodeEmoji(emoji) },
@@ -103,8 +76,6 @@ export class TelegramMessagingBot {
             }
             catch (err) {
                 const msg = err instanceof Error ? err.message : String(err);
-                // Editing to identical content is something streaming asks for
-                // constantly; it is a no-op, not a failure.
                 if (msg.includes("message is not modified"))
                     return;
                 throw err;
@@ -114,7 +85,7 @@ export class TelegramMessagingBot {
     enqueueEvent(event) {
         if (this.stopped)
             return false;
-        const conversationId = event.conversationId;
+        const conversationId = event.address.conversationId;
         const queue = this.getQueue(conversationId);
         if (queue.size() >= 5) {
             log.logWarning(`Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`);
@@ -135,9 +106,6 @@ export class TelegramMessagingBot {
             users: [],
         };
     }
-    // ==========================================================================
-    // Internal helpers (used by context.ts)
-    // ==========================================================================
     async postMessageRaw(chatId, text) {
         return telegramRetry(async () => {
             const result = await this.client.api.sendRichMessage(chatId, richMessage(text));
@@ -176,14 +144,8 @@ export class TelegramMessagingBot {
     logBotResponse(channel, text, ts) {
         appendBotResponseLog(this.workspace.office(createOfficeAddress("telegram", channel)), text, ts);
     }
-    /**
-     * Process attachments from a Telegram message
-     * Downloads files before returning metadata so the agent can read them immediately
-     * Returns format compatible with ConversationMessage: { name: string, localPath: string }[]
-     */
     async processAttachments(chatId, message) {
         const items = [];
-        // Photos: take the largest size for best quality.
         const photo = message.photo?.[message.photo.length - 1];
         if (photo) {
             items.push(this.telegramFileItem(photo.file_id, `photo_${message.message_id}.jpg`));
@@ -199,7 +161,6 @@ export class TelegramMessagingBot {
         }
         return saved.map((item) => ({ name: item.original, localPath: item.localPath }));
     }
-    /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */
     telegramFileItem(fileId, name) {
         return {
             name,
@@ -211,9 +172,6 @@ export class TelegramMessagingBot {
             },
         };
     }
-    // ==========================================================================
-    // Private - Event Handlers
-    // ==========================================================================
     getQueue(channelId) {
         let queue = this.queues.get(channelId);
         if (!queue) {
@@ -272,10 +230,6 @@ export class TelegramMessagingBot {
         return text.replace(new RegExp(`@${this.botUsername}`, "gi"), "").trim();
     }
     setupEventHandlers() {
-        // --- Slash commands (registered before catch-all so grammY intercepts them) ---
-        // The manifest's telegramCommand flag is the inventory; magic words (e.g.
-        // `stop`) are deliberately never native handlers — they belong to
-        // conversation intake, so the catch-all below must receive them.
         for (const entry of COMMAND_MANIFEST) {
             if (!entry.telegramCommand || entry.magicWord)
                 continue;
@@ -283,8 +237,6 @@ export class TelegramMessagingBot {
                 const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
                 if (!mc)
                     return;
-                // Handler grammars accept the user's spelling directly (manifest
-                // slash forms), so it is logged and dispatched as-is.
                 const commandText = this.cleanText(mc.text);
                 const event = createConversationEvent({
                     platform: "telegram",
@@ -312,7 +264,6 @@ export class TelegramMessagingBot {
                 await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));
             }));
         }
-        // --- Catch-all for regular (non-command) messages ---
         this.client.on("message", (ctx) => this.intake.run(async () => {
             const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;
             if (!mc)

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

@@ -1 +1 @@
-{"version":3,"file":"bot.js","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename } from \"node:path\";\nimport { Bot as GrammyMessagingBot, InputFile } from \"grammy\";\nimport type { Message } from \"grammy/types\";\nimport type {\n  ConversationEvent,\n  MessagingEventHandler,\n  ConversationKind,\n  MessagingInfo,\n} from \"../index.js\";\nimport { createConversationEvent, type MessagingBot } from \"../index.js\";\nimport type { TelegramEvent } from \"./types.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/session-key.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  MessagingEventQueue,\n  MessagingIntakeTracker,\n  downloadUrlToFile,\n  withRetry,\n  saveIncomingAttachments,\n  shortNameToUnicodeEmoji,\n  type IncomingAttachment,\n} from \"../shared.js\";\nimport { COMMAND_MANIFEST, telegramCommandMenu } from \"../commands/manifest.js\";\nimport { processMessageIntake } from \"../intake.js\";\nimport { createTelegramAdapters } from \"./context.js\";\nimport { createOfficeAddress, type Workspace } from \"../../office/index.js\";\n\n// grammY surfaces Telegram errors as `GrammyError` with `error_code` mirroring\n// the Bot API. 429 is the rate-limit status; the response also includes\n// `parameters.retry_after` but exponential backoff is good enough here.\nfunction telegramIsRateLimited(err: Error): boolean {\n  return (err as { error_code?: number }).error_code === 429;\n}\n\nconst telegramRetry = <T>(fn: () => Promise<T>): Promise<T> =>\n  withRetry(fn, { isRateLimited: telegramIsRateLimited });\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport type { TelegramEvent } from \"./types.js\";\n\ninterface MessageContext {\n  msg: Message;\n  text: string;\n  chatId: string;\n  chatType: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName: string;\n  msgId: string;\n  threadTs: string | undefined;\n  sessionKey: string;\n}\n\n// ============================================================================\n// TelegramMessagingBot\n// ============================================================================\n\n/**\n * A response as a Telegram rich message.\n *\n * Telegram parses the markdown into native blocks itself — a GFM table becomes\n * a real table, `##` a heading, a fence a code block. That is why this adapter\n * has no converter of its own: unlike Slack and Discord, nothing here has to be\n * translated before sending.\n *\n * It replaces the HTML pipeline, and with it the escape-and-retry dance that\n * existed only because a model writing HTML by hand regularly produced markup\n * Telegram rejected.\n */\nfunction richMessage(markdown: string): { markdown: string } {\n  return { markdown };\n}\n\nexport class TelegramMessagingBot implements MessagingBot {\n  private client: GrammyMessagingBot;\n  private handler: MessagingEventHandler;\n  private botToken: string;\n  private workspace: Workspace;\n  private botUserId: string | null = null;\n  private botUsername: string | null = null;\n  private stopped = false;\n  private queues = new Map<string, MessagingEventQueue>();\n  private intake = new MessagingIntakeTracker(\"Telegram\");\n  private startupTime: number = 0;\n\n  constructor(handler: MessagingEventHandler, config: { token: string; workspace: Workspace }) {\n    this.handler = handler;\n    this.botToken = config.token;\n    this.workspace = config.workspace;\n    this.client = new GrammyMessagingBot(config.token);\n    this.client.catch((err) => {\n      log.logWarning(\"Telegram error\", err instanceof Error ? err.message : String(err));\n    });\n  }\n\n  // ==========================================================================\n  // Public API (implements MessagingBot)\n  // ==========================================================================\n\n  async start(): Promise<void> {\n    this.stopped = false;\n    const me = await this.client.api.getMe();\n    this.botUserId = String(me.id);\n    this.botUsername = me.username ?? null;\n    this.startupTime = Date.now();\n\n    // Menu registration derives from the command manifest; routing is\n    // separate (native handlers below + intake/dispatch for the rest).\n    await this.client.api.setMyCommands(telegramCommandMenu());\n    if (this.stopped) return;\n\n    this.setupEventHandlers();\n\n    // Start polling in background (bot.start() runs indefinitely)\n    this.client.start().catch((err) => {\n      log.logWarning(\"Telegram polling error\", err instanceof Error ? err.message : String(err));\n    });\n\n    log.logConnected(\"Telegram\");\n    log.logInfo(`Telegram bot started as @${this.botUsername ?? this.botUserId}`);\n  }\n\n  async stop(): Promise<void> {\n    this.stopped = true;\n    try {\n      await this.client.stop();\n    } finally {\n      await this.intake.close();\n      await Promise.all([...this.queues.values()].map((queue) => queue.close()));\n    }\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    const result = await this.postMessageRaw(parseInt(channel), text);\n    return String(result);\n  }\n\n  async addReaction(channel: string, messageTs: string, emoji: string): Promise<void> {\n    // Telegram reactions are set via setMessageReaction with a Unicode emoji;\n    // the `react` tool and prompt speak Slack-style short names, so translate\n    // here rather than push that mapping onto every caller.\n    await telegramRetry(async () => {\n      await this.client.api.setMessageReaction(parseInt(channel), parseInt(messageTs), [\n        { type: \"emoji\", emoji: shortNameToUnicodeEmoji(emoji) as never },\n      ]);\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      try {\n        await this.client.api.editMessageText(parseInt(channel), parseInt(ts), richMessage(text));\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        // Editing to identical content is something streaming asks for\n        // constantly; it is a no-op, not a failure.\n        if (msg.includes(\"message is not modified\")) return;\n        throw err;\n      }\n    });\n  }\n\n  enqueueEvent(event: ConversationEvent): boolean {\n    if (this.stopped) return false;\n    const conversationId = event.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    return queue.enqueue(() => {\n      const context = createTelegramAdapters(event as TelegramEvent, this);\n      return this.handler.handleEvent(event, this, context);\n    });\n  }\n\n  getMessagingInfo(): MessagingInfo {\n    return {\n      name: \"telegram\",\n      trustModel: \"membership\",\n      formattingGuide:\n        \"## Telegram Formatting (Markdown)\\nWrite ordinary Markdown — headings, lists, tables, code fences, quotes and links all render natively. Nothing needs converting by hand.\",\n      channels: [],\n      users: [],\n    };\n  }\n\n  // ==========================================================================\n  // Internal helpers (used by context.ts)\n  // ==========================================================================\n\n  async postMessageRaw(chatId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text));\n      return result.message_id;\n    });\n  }\n\n  async postPlainMessage(chatId: number, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      await this.client.api.sendMessage(chatId, text);\n    });\n  }\n\n  async postReply(chatId: number, replyToMessageId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text), {\n        reply_parameters: { message_id: replyToMessageId },\n      });\n      return result.message_id;\n    });\n  }\n\n  async deleteMessageRaw(chatId: number, messageId: number): Promise<void> {\n    await this.client.api.deleteMessage(chatId, messageId);\n  }\n\n  async sendTyping(chatId: number): Promise<void> {\n    await this.client.api.sendChatAction(chatId, \"typing\");\n  }\n\n  async uploadFile(channel: string, filePath: string, title?: string): Promise<void> {\n    return telegramRetry(async () => {\n      const fileName = title ?? basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await this.client.api.sendDocument(parseInt(channel), new InputFile(fileContent, fileName));\n    });\n  }\n\n  logToFile(channel: string, entry: object): void {\n    appendChannelLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), entry);\n  }\n\n  logBotResponse(channel: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), text, ts);\n  }\n\n  /**\n   * Process attachments from a Telegram message\n   * Downloads files before returning metadata so the agent can read them immediately\n   * Returns format compatible with ConversationMessage: { name: string, localPath: string }[]\n   */\n  async processAttachments(\n    chatId: string,\n    message: Message,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const items: IncomingAttachment[] = [];\n\n    // Photos: take the largest size for best quality.\n    const photo = message.photo?.[message.photo.length - 1];\n    if (photo) {\n      items.push(this.telegramFileItem(photo.file_id, `photo_${message.message_id}.jpg`));\n    }\n    if (message.document) {\n      const doc = message.document;\n      items.push(\n        this.telegramFileItem(doc.file_id, doc.file_name ?? `document_${message.message_id}`),\n      );\n    }\n\n    const office = this.workspace.office(createOfficeAddress(\"telegram\", chatId));\n    const { saved, failed } = await saveIncomingAttachments(office, items);\n    for (const failure of failed) {\n      log.logWarning(`Failed to process Telegram file`, `${failure.name}: ${failure.error}`);\n    }\n    return saved.map((item) => ({ name: item.original, localPath: item.localPath }));\n  }\n\n  /** One Telegram file as a saveIncomingAttachments item; failures skip, never throw. */\n  private telegramFileItem(fileId: string, name: string): IncomingAttachment {\n    return {\n      name,\n      download: async (destPath) => {\n        const file = await this.client.api.getFile(fileId);\n        if (!file.file_path) throw new Error(`Telegram file has no path: ${fileId}`);\n        await downloadUrlToFile(\n          `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`,\n          destPath,\n        );\n      },\n    };\n  }\n\n  // ==========================================================================\n  // Private - Event Handlers\n  // ==========================================================================\n\n  private getQueue(channelId: string): MessagingEventQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new MessagingEventQueue(\"Telegram\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private extractMessageContext(msg: Message): MessageContext | null {\n    if (!msg) return null;\n    if (msg.date * 1000 < this.startupTime) return null;\n    if (msg.from?.is_bot) return null;\n\n    const text = msg.text ?? msg.caption ?? \"\";\n    if (!text && !msg.document && !msg.photo) return null;\n\n    const chatId = String(msg.chat.id);\n    const chatType = msg.chat.type;\n    const userId = String(msg.from?.id ?? \"unknown\");\n    const userName = msg.from?.username ?? msg.from?.first_name ?? userId;\n    const msgId = String(msg.message_id);\n    const replyToId = msg.reply_to_message?.message_id;\n    const threadTs = replyToId ? String(replyToId) : undefined;\n    const conversationKind = chatType === \"private\" ? \"direct\" : \"shared\";\n\n    const sessionKey = resolveChatSessionKey({\n      conversationId: chatId,\n      conversationKind,\n      messageId: msgId,\n      threadTs,\n    });\n\n    return {\n      msg,\n      text,\n      chatId,\n      chatType,\n      conversationKind,\n      userId,\n      userName,\n      msgId,\n      threadTs,\n      sessionKey,\n    };\n  }\n\n  private isAddressedToMessagingBot(text: string, chatType: string): boolean {\n    if (chatType === \"private\") return true;\n    if (!this.botUsername) return false;\n    return text.toLowerCase().includes(`@${this.botUsername.toLowerCase()}`);\n  }\n\n  private cleanText(text: string): string {\n    if (!this.botUsername) return text.trim();\n    return text.replace(new RegExp(`@${this.botUsername}`, \"gi\"), \"\").trim();\n  }\n\n  private setupEventHandlers(): void {\n    // --- Slash commands (registered before catch-all so grammY intercepts them) ---\n    // The manifest's telegramCommand flag is the inventory; magic words (e.g.\n    // `stop`) are deliberately never native handlers — they belong to\n    // conversation intake, so the catch-all below must receive them.\n    for (const entry of COMMAND_MANIFEST) {\n      if (!entry.telegramCommand || entry.magicWord) continue;\n      this.client.command(entry.name, (ctx) =>\n        this.intake.run(async () => {\n          const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n          if (!mc) return;\n          // Handler grammars accept the user's spelling directly (manifest\n          // slash forms), so it is logged and dispatched as-is.\n          const commandText = this.cleanText(mc.text);\n          const event = createConversationEvent({\n            platform: \"telegram\",\n            type: \"command\",\n            conversationId: mc.chatId,\n            conversationKind: mc.conversationKind,\n            ts: mc.msgId,\n            thread_ts: mc.threadTs,\n            sessionKey: mc.sessionKey,\n            user: mc.userId,\n            userName: mc.userName,\n            text: commandText,\n            attachments: [],\n          }) as TelegramEvent;\n          this.logToFile(mc.chatId, {\n            date: new Date(mc.msg.date * 1000).toISOString(),\n            ts: mc.msgId,\n            ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n            user: mc.userId,\n            userName: mc.userName,\n            text: commandText,\n            attachments: [],\n            isMessagingBot: false,\n          });\n          await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));\n        }),\n      );\n    }\n\n    // --- Catch-all for regular (non-command) messages ---\n\n    this.client.on(\"message\", (ctx) =>\n      this.intake.run(async () => {\n        const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n        if (!mc) return;\n\n        const cleanedText = this.cleanText(mc.text);\n        const addressedToMessagingBot = this.isAddressedToMessagingBot(mc.text, mc.chatType);\n        const addressed = mc.chatType === \"private\" || addressedToMessagingBot;\n\n        const eventBase = createConversationEvent({\n          platform: \"telegram\",\n          type: \"message\",\n          conversationId: mc.chatId,\n          conversationKind: mc.conversationKind,\n          ts: mc.msgId,\n          thread_ts: mc.threadTs,\n          sessionKey: mc.sessionKey,\n          user: mc.userId,\n          userName: mc.userName,\n          text: cleanedText,\n        }) as TelegramEvent;\n\n        await processMessageIntake({\n          eventBase,\n          addressed,\n          magicWord: {\n            addressed: addressedToMessagingBot || mc.chatType === \"private\",\n            scopeFallback: \"always\",\n          },\n          busyPolicy: \"reject\",\n          logEntryBase: {\n            date: new Date(mc.msg.date * 1000).toISOString(),\n            ts: mc.msgId,\n            ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n            user: mc.userId,\n            userName: mc.userName,\n            text: cleanedText,\n            isMessagingBot: false,\n          },\n          log: (entry) => this.logToFile(mc.chatId, entry),\n          processAttachments: () => this.processAttachments(mc.chatId, mc.msg),\n          queueKey: mc.sessionKey,\n          enqueue: (queueKey, work) => this.getQueue(queueKey).enqueue(work),\n          handler: this.handler,\n          bot: this,\n          createContext: (event) => createTelegramAdapters(event, this),\n        });\n      }),\n    );\n  }\n}\n"]}
+{"version":3,"file":"bot.js","sourceRoot":"","sources":["../../../src/adapters/telegram/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,GAAG,IAAI,kBAAkB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAQ9D,OAAO,EAAE,uBAAuB,EAAqB,MAAM,aAAa,CAAC;AAEzE,OAAO,KAAK,GAAG,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,SAAS,EACT,uBAAuB,EACvB,uBAAuB,GAExB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAkB,MAAM,uBAAuB,CAAC;AAE5E,SAAS,qBAAqB,CAAC,GAAU;IACvC,OAAQ,GAA+B,CAAC,UAAU,KAAK,GAAG,CAAC;AAC7D,CAAC;AAED,MAAM,aAAa,GAAG,CAAI,EAAoB,EAAc,EAAE,CAC5D,SAAS,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,qBAAqB,EAAE,CAAC,CAAC;AAiB1D,SAAS,WAAW,CAAC,QAAgB;IACnC,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,OAAO,oBAAoB;IAY/B,YAAY,OAA8B,EAAE,MAA+C;QAPnF,cAAS,GAAkB,IAAI,CAAC;QAChC,gBAAW,GAAkB,IAAI,CAAC;QAClC,YAAO,GAAG,KAAK,CAAC;QAChB,WAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;QAChD,WAAM,GAAG,IAAI,sBAAsB,CAAC,UAAU,CAAC,CAAC;QAChD,gBAAW,GAAW,CAAC,CAAC;QAG9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACxB,GAAG,CAAC,UAAU,CAAC,gBAAgB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,QAAQ,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE9B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,mBAAmB,EAAE,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAE1B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YAChC,GAAG,CAAC,UAAU,CAAC,wBAAwB,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7F,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC7B,GAAG,CAAC,OAAO,CAAC,4BAA4B,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAAY;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,SAAiB,EAAE,KAAa;QACjE,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE;gBAC/E,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,uBAAuB,CAAC,KAAK,CAAU,EAAE;aAClE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,EAAU,EAAE,IAAY;QAC3D,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC;oBAAE,OAAO;gBACpD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,YAAY,CAAC,KAAwB;QACnC,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QAC5C,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,UAAU,CACZ,wBAAwB,cAAc,iBAAiB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CACrF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,OAAO,CAAC,wBAAwB,cAAc,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;QACtF,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;YACxB,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAsB,EAAE,IAAI,CAAC,CAAC;YACrE,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;QACd,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,UAAU,EAAE,YAAY;YACxB,eAAe,EACb,4KAA4K;YAC9K,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;SACV,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,IAAY;QAC/C,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,IAAY;QACjD,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,gBAAwB,EAAE,IAAY;QACpE,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE;gBAC9E,gBAAgB,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE;aACnD,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,UAAU,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,SAAiB;QACtD,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,QAAgB,EAAE,KAAc;QAChE,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,QAAQ,GAAG,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC3C,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAAe,EAAE,KAAa;QACtC,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3F,CAAC;IAED,cAAc,CAAC,OAAe,EAAE,IAAY,EAAE,EAAU;QACtD,oBAAoB,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,MAAc,EACd,OAAgB;QAEhB,MAAM,KAAK,GAAyB,EAAE,CAAC;QAEvC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACxD,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,OAAO,CAAC,UAAU,MAAM,CAAC,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;YAC7B,KAAK,CAAC,IAAI,CACR,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,IAAI,YAAY,OAAO,CAAC,UAAU,EAAE,CAAC,CACtF,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9E,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,uBAAuB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvE,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;YAC7B,GAAG,CAAC,UAAU,CAAC,iCAAiC,EAAE,GAAG,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACnF,CAAC;IAEO,gBAAgB,CAAC,MAAc,EAAE,IAAY;QACnD,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE;gBAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnD,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;gBAC7E,MAAM,iBAAiB,CACrB,oCAAoC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,EACrE,QAAQ,CACT,CAAC;YACJ,CAAC;SACF,CAAC;IACJ,CAAC;IAEO,QAAQ,CAAC,SAAiB;QAChC,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,IAAI,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,qBAAqB,CAAC,GAAY;QACxC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,IAAI,GAAG,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC;QACpD,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM;YAAE,OAAO,IAAI,CAAC;QAElC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;QAC3C,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,SAAS,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,UAAU,IAAI,MAAM,CAAC;QACtE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAC;QACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3D,MAAM,gBAAgB,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAEtE,MAAM,UAAU,GAAG,qBAAqB,CAAC;YACvC,cAAc,EAAE,MAAM;YACtB,gBAAgB;YAChB,SAAS,EAAE,KAAK;YAChB,QAAQ;SACT,CAAC,CAAC;QAEH,OAAO;YACL,GAAG;YACH,IAAI;YACJ,MAAM;YACN,QAAQ;YACR,gBAAgB;YAChB,MAAM;YACN,QAAQ;YACR,KAAK;YACL,QAAQ;YACR,UAAU;SACX,CAAC;IACJ,CAAC;IAEO,yBAAyB,CAAC,IAAY,EAAE,QAAgB;QAC9D,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,KAAK,CAAC;QACpC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAEO,SAAS,CAAC,IAAY;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3E,CAAC;IAEO,kBAAkB;QACxB,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,SAAS;gBAAE,SAAS;YACxD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CACtC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;gBACzB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACxE,IAAI,CAAC,EAAE;oBAAE,OAAO;gBAChB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;gBAC5C,MAAM,KAAK,GAAG,uBAAuB,CAAC;oBACpC,QAAQ,EAAE,UAAU;oBACpB,IAAI,EAAE,SAAS;oBACf,cAAc,EAAE,EAAE,CAAC,MAAM;oBACzB,gBAAgB,EAAE,EAAE,CAAC,gBAAgB;oBACrC,EAAE,EAAE,EAAE,CAAC,KAAK;oBACZ,SAAS,EAAE,EAAE,CAAC,QAAQ;oBACtB,UAAU,EAAE,EAAE,CAAC,UAAU;oBACzB,IAAI,EAAE,EAAE,CAAC,MAAM;oBACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;oBACrB,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,EAAE;iBAChB,CAAkB,CAAC;gBACpB,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE;oBACxB,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;oBAChD,EAAE,EAAE,EAAE,CAAC,KAAK;oBACZ,GAAG,CAAC,EAAE,CAAC,gBAAgB,KAAK,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrF,IAAI,EAAE,EAAE,CAAC,MAAM;oBACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;oBACrB,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,EAAE;oBACf,cAAc,EAAE,KAAK;iBACtB,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;YACnF,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE;YACzB,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACxE,IAAI,CAAC,EAAE;gBAAE,OAAO;YAEhB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,uBAAuB,GAAG,IAAI,CAAC,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC;YACrF,MAAM,SAAS,GAAG,EAAE,CAAC,QAAQ,KAAK,SAAS,IAAI,uBAAuB,CAAC;YAEvE,MAAM,SAAS,GAAG,uBAAuB,CAAC;gBACxC,QAAQ,EAAE,UAAU;gBACpB,IAAI,EAAE,SAAS;gBACf,cAAc,EAAE,EAAE,CAAC,MAAM;gBACzB,gBAAgB,EAAE,EAAE,CAAC,gBAAgB;gBACrC,EAAE,EAAE,EAAE,CAAC,KAAK;gBACZ,SAAS,EAAE,EAAE,CAAC,QAAQ;gBACtB,UAAU,EAAE,EAAE,CAAC,UAAU;gBACzB,IAAI,EAAE,EAAE,CAAC,MAAM;gBACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;gBACrB,IAAI,EAAE,WAAW;aAClB,CAAkB,CAAC;YAEpB,MAAM,oBAAoB,CAAC;gBACzB,SAAS;gBACT,SAAS;gBACT,SAAS,EAAE;oBACT,SAAS,EAAE,uBAAuB,IAAI,EAAE,CAAC,QAAQ,KAAK,SAAS;oBAC/D,aAAa,EAAE,QAAQ;iBACxB;gBACD,UAAU,EAAE,QAAQ;gBACpB,YAAY,EAAE;oBACZ,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;oBAChD,EAAE,EAAE,EAAE,CAAC,KAAK;oBACZ,GAAG,CAAC,EAAE,CAAC,gBAAgB,KAAK,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACrF,IAAI,EAAE,EAAE,CAAC,MAAM;oBACf,QAAQ,EAAE,EAAE,CAAC,QAAQ;oBACrB,IAAI,EAAE,WAAW;oBACjB,cAAc,EAAE,KAAK;iBACtB;gBACD,GAAG,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;gBAChD,kBAAkB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC;gBACpE,QAAQ,EAAE,EAAE,CAAC,UAAU;gBACvB,OAAO,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;gBAClE,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,EAAE,IAAI;gBACT,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { basename } from \"node:path\";\nimport { Bot as GrammyMessagingBot, InputFile } from \"grammy\";\nimport type { Message } from \"grammy/types\";\nimport type {\n  ConversationEvent,\n  MessagingEventHandler,\n  ConversationKind,\n  MessagingInfo,\n} from \"../index.js\";\nimport { createConversationEvent, type MessagingBot } from \"../index.js\";\nimport type { TelegramEvent } from \"./types.js\";\nimport * as log from \"../../log.js\";\nimport { resolveChatSessionKey } from \"../../sessions/session-key.js\";\nimport {\n  appendBotResponseLog,\n  appendChannelLog,\n  MessagingEventQueue,\n  MessagingIntakeTracker,\n  downloadUrlToFile,\n  withRetry,\n  saveIncomingAttachments,\n  shortNameToUnicodeEmoji,\n  type IncomingAttachment,\n} from \"../shared.js\";\nimport { COMMAND_MANIFEST, telegramCommandMenu } from \"../commands/manifest.js\";\nimport { processMessageIntake } from \"../intake.js\";\nimport { createTelegramAdapters } from \"./context.js\";\nimport { createOfficeAddress, type Workspace } from \"../../office/index.js\";\n\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\nexport type { TelegramEvent } from \"./types.js\";\n\ninterface MessageContext {\n  msg: Message;\n  text: string;\n  chatId: string;\n  chatType: string;\n  conversationKind: ConversationKind;\n  userId: string;\n  userName: string;\n  msgId: string;\n  threadTs: string | undefined;\n  sessionKey: string;\n}\n\nfunction richMessage(markdown: string): { markdown: string } {\n  return { markdown };\n}\n\nexport class TelegramMessagingBot implements MessagingBot {\n  private client: GrammyMessagingBot;\n  private handler: MessagingEventHandler;\n  private botToken: string;\n  private workspace: Workspace;\n  private botUserId: string | null = null;\n  private botUsername: string | null = null;\n  private stopped = false;\n  private queues = new Map<string, MessagingEventQueue>();\n  private intake = new MessagingIntakeTracker(\"Telegram\");\n  private startupTime: number = 0;\n\n  constructor(handler: MessagingEventHandler, config: { token: string; workspace: Workspace }) {\n    this.handler = handler;\n    this.botToken = config.token;\n    this.workspace = config.workspace;\n    this.client = new GrammyMessagingBot(config.token);\n    this.client.catch((err) => {\n      log.logWarning(\"Telegram error\", err instanceof Error ? err.message : String(err));\n    });\n  }\n\n  async start(): Promise<void> {\n    this.stopped = false;\n    const me = await this.client.api.getMe();\n    this.botUserId = String(me.id);\n    this.botUsername = me.username ?? null;\n    this.startupTime = Date.now();\n\n    await this.client.api.setMyCommands(telegramCommandMenu());\n    if (this.stopped) return;\n\n    this.setupEventHandlers();\n\n    this.client.start().catch((err) => {\n      log.logWarning(\"Telegram polling error\", err instanceof Error ? err.message : String(err));\n    });\n\n    log.logConnected(\"Telegram\");\n    log.logInfo(`Telegram bot started as @${this.botUsername ?? this.botUserId}`);\n  }\n\n  async stop(): Promise<void> {\n    this.stopped = true;\n    try {\n      await this.client.stop();\n    } finally {\n      await this.intake.close();\n      await Promise.all([...this.queues.values()].map((queue) => queue.close()));\n    }\n  }\n\n  async postMessage(channel: string, text: string): Promise<string> {\n    const result = await this.postMessageRaw(parseInt(channel), text);\n    return String(result);\n  }\n\n  async addReaction(channel: string, messageTs: string, emoji: string): Promise<void> {\n    await telegramRetry(async () => {\n      await this.client.api.setMessageReaction(parseInt(channel), parseInt(messageTs), [\n        { type: \"emoji\", emoji: shortNameToUnicodeEmoji(emoji) as never },\n      ]);\n    });\n  }\n\n  async updateMessage(channel: string, ts: string, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      try {\n        await this.client.api.editMessageText(parseInt(channel), parseInt(ts), richMessage(text));\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        if (msg.includes(\"message is not modified\")) return;\n        throw err;\n      }\n    });\n  }\n\n  enqueueEvent(event: ConversationEvent): boolean {\n    if (this.stopped) return false;\n    const conversationId = event.address.conversationId;\n    const queue = this.getQueue(conversationId);\n    if (queue.size() >= 5) {\n      log.logWarning(\n        `Event queue full for ${conversationId}, discarding: ${event.text.substring(0, 50)}`,\n      );\n      return false;\n    }\n    log.logInfo(`Enqueueing event for ${conversationId}: ${event.text.substring(0, 50)}`);\n    return queue.enqueue(() => {\n      const context = createTelegramAdapters(event as TelegramEvent, this);\n      return this.handler.handleEvent(event, this, context);\n    });\n  }\n\n  getMessagingInfo(): MessagingInfo {\n    return {\n      name: \"telegram\",\n      trustModel: \"membership\",\n      formattingGuide:\n        \"## Telegram Formatting (Markdown)\\nWrite ordinary Markdown — headings, lists, tables, code fences, quotes and links all render natively. Nothing needs converting by hand.\",\n      channels: [],\n      users: [],\n    };\n  }\n\n  async postMessageRaw(chatId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text));\n      return result.message_id;\n    });\n  }\n\n  async postPlainMessage(chatId: number, text: string): Promise<void> {\n    return telegramRetry(async () => {\n      await this.client.api.sendMessage(chatId, text);\n    });\n  }\n\n  async postReply(chatId: number, replyToMessageId: number, text: string): Promise<number> {\n    return telegramRetry(async () => {\n      const result = await this.client.api.sendRichMessage(chatId, richMessage(text), {\n        reply_parameters: { message_id: replyToMessageId },\n      });\n      return result.message_id;\n    });\n  }\n\n  async deleteMessageRaw(chatId: number, messageId: number): Promise<void> {\n    await this.client.api.deleteMessage(chatId, messageId);\n  }\n\n  async sendTyping(chatId: number): Promise<void> {\n    await this.client.api.sendChatAction(chatId, \"typing\");\n  }\n\n  async uploadFile(channel: string, filePath: string, title?: string): Promise<void> {\n    return telegramRetry(async () => {\n      const fileName = title ?? basename(filePath);\n      const fileContent = readFileSync(filePath);\n      await this.client.api.sendDocument(parseInt(channel), new InputFile(fileContent, fileName));\n    });\n  }\n\n  logToFile(channel: string, entry: object): void {\n    appendChannelLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), entry);\n  }\n\n  logBotResponse(channel: string, text: string, ts: string): void {\n    appendBotResponseLog(this.workspace.office(createOfficeAddress(\"telegram\", channel)), text, ts);\n  }\n\n  async processAttachments(\n    chatId: string,\n    message: Message,\n  ): Promise<{ name: string; localPath: string }[]> {\n    const items: IncomingAttachment[] = [];\n\n    const photo = message.photo?.[message.photo.length - 1];\n    if (photo) {\n      items.push(this.telegramFileItem(photo.file_id, `photo_${message.message_id}.jpg`));\n    }\n    if (message.document) {\n      const doc = message.document;\n      items.push(\n        this.telegramFileItem(doc.file_id, doc.file_name ?? `document_${message.message_id}`),\n      );\n    }\n\n    const office = this.workspace.office(createOfficeAddress(\"telegram\", chatId));\n    const { saved, failed } = await saveIncomingAttachments(office, items);\n    for (const failure of failed) {\n      log.logWarning(`Failed to process Telegram file`, `${failure.name}: ${failure.error}`);\n    }\n    return saved.map((item) => ({ name: item.original, localPath: item.localPath }));\n  }\n\n  private telegramFileItem(fileId: string, name: string): IncomingAttachment {\n    return {\n      name,\n      download: async (destPath) => {\n        const file = await this.client.api.getFile(fileId);\n        if (!file.file_path) throw new Error(`Telegram file has no path: ${fileId}`);\n        await downloadUrlToFile(\n          `https://api.telegram.org/file/bot${this.botToken}/${file.file_path}`,\n          destPath,\n        );\n      },\n    };\n  }\n\n  private getQueue(channelId: string): MessagingEventQueue {\n    let queue = this.queues.get(channelId);\n    if (!queue) {\n      queue = new MessagingEventQueue(\"Telegram\");\n      this.queues.set(channelId, queue);\n    }\n    return queue;\n  }\n\n  private extractMessageContext(msg: Message): MessageContext | null {\n    if (!msg) return null;\n    if (msg.date * 1000 < this.startupTime) return null;\n    if (msg.from?.is_bot) return null;\n\n    const text = msg.text ?? msg.caption ?? \"\";\n    if (!text && !msg.document && !msg.photo) return null;\n\n    const chatId = String(msg.chat.id);\n    const chatType = msg.chat.type;\n    const userId = String(msg.from?.id ?? \"unknown\");\n    const userName = msg.from?.username ?? msg.from?.first_name ?? userId;\n    const msgId = String(msg.message_id);\n    const replyToId = msg.reply_to_message?.message_id;\n    const threadTs = replyToId ? String(replyToId) : undefined;\n    const conversationKind = chatType === \"private\" ? \"direct\" : \"shared\";\n\n    const sessionKey = resolveChatSessionKey({\n      conversationId: chatId,\n      conversationKind,\n      messageId: msgId,\n      threadTs,\n    });\n\n    return {\n      msg,\n      text,\n      chatId,\n      chatType,\n      conversationKind,\n      userId,\n      userName,\n      msgId,\n      threadTs,\n      sessionKey,\n    };\n  }\n\n  private isAddressedToMessagingBot(text: string, chatType: string): boolean {\n    if (chatType === \"private\") return true;\n    if (!this.botUsername) return false;\n    return text.toLowerCase().includes(`@${this.botUsername.toLowerCase()}`);\n  }\n\n  private cleanText(text: string): string {\n    if (!this.botUsername) return text.trim();\n    return text.replace(new RegExp(`@${this.botUsername}`, \"gi\"), \"\").trim();\n  }\n\n  private setupEventHandlers(): void {\n    for (const entry of COMMAND_MANIFEST) {\n      if (!entry.telegramCommand || entry.magicWord) continue;\n      this.client.command(entry.name, (ctx) =>\n        this.intake.run(async () => {\n          const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n          if (!mc) return;\n          const commandText = this.cleanText(mc.text);\n          const event = createConversationEvent({\n            platform: \"telegram\",\n            type: \"command\",\n            conversationId: mc.chatId,\n            conversationKind: mc.conversationKind,\n            ts: mc.msgId,\n            thread_ts: mc.threadTs,\n            sessionKey: mc.sessionKey,\n            user: mc.userId,\n            userName: mc.userName,\n            text: commandText,\n            attachments: [],\n          }) as TelegramEvent;\n          this.logToFile(mc.chatId, {\n            date: new Date(mc.msg.date * 1000).toISOString(),\n            ts: mc.msgId,\n            ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n            user: mc.userId,\n            userName: mc.userName,\n            text: commandText,\n            attachments: [],\n            isMessagingBot: false,\n          });\n          await this.handler.handleEvent(event, this, createTelegramAdapters(event, this));\n        }),\n      );\n    }\n\n    this.client.on(\"message\", (ctx) =>\n      this.intake.run(async () => {\n        const mc = ctx.message ? this.extractMessageContext(ctx.message) : null;\n        if (!mc) return;\n\n        const cleanedText = this.cleanText(mc.text);\n        const addressedToMessagingBot = this.isAddressedToMessagingBot(mc.text, mc.chatType);\n        const addressed = mc.chatType === \"private\" || addressedToMessagingBot;\n\n        const eventBase = createConversationEvent({\n          platform: \"telegram\",\n          type: \"message\",\n          conversationId: mc.chatId,\n          conversationKind: mc.conversationKind,\n          ts: mc.msgId,\n          thread_ts: mc.threadTs,\n          sessionKey: mc.sessionKey,\n          user: mc.userId,\n          userName: mc.userName,\n          text: cleanedText,\n        }) as TelegramEvent;\n\n        await processMessageIntake({\n          eventBase,\n          addressed,\n          magicWord: {\n            addressed: addressedToMessagingBot || mc.chatType === \"private\",\n            scopeFallback: \"always\",\n          },\n          busyPolicy: \"reject\",\n          logEntryBase: {\n            date: new Date(mc.msg.date * 1000).toISOString(),\n            ts: mc.msgId,\n            ...(mc.conversationKind === \"shared\" && mc.threadTs ? { threadTs: mc.threadTs } : {}),\n            user: mc.userId,\n            userName: mc.userName,\n            text: cleanedText,\n            isMessagingBot: false,\n          },\n          log: (entry) => this.logToFile(mc.chatId, entry),\n          processAttachments: () => this.processAttachments(mc.chatId, mc.msg),\n          queueKey: mc.sessionKey,\n          enqueue: (queueKey, work) => this.getQueue(queueKey).enqueue(work),\n          handler: this.handler,\n          bot: this,\n          createContext: (event) => createTelegramAdapters(event, this),\n        });\n      }),\n    );\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAcpE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,oBAAoB,GACxB,mBAAmB,CAiErB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAIvE,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAWpE,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,oBAAoB,GACxB,mBAAmB,CA6DrB"}

package/dist/adapters/telegram/context.js

@@ -2,9 +2,6 @@ import { createConversationMessage } from "../index.js";
 import { deriveSessionKey } from "../../sessions/session-key.js";
 import { createProgressiveRenderer } from "../progressive-renderer.js";
 import { formatToolArgs } from "../shared.js";
-// A rich message allows far more than the 4096 a plain message did; this stays
-// well inside it, and the headroom is now for the continuation marker alone
-// rather than for HTML escapes that no longer happen.
 const MAX_LENGTH = 30000;
 function formatToolResult(result) {
     const argsFormatted = formatToolArgs(result.args);
@@ -13,7 +10,7 @@ function formatToolResult(result) {
     return [title, argsFormatted, result.result].filter(Boolean).join("\n\n");
 }
 export function createTelegramAdapters(event, bot) {
-    const conversationId = event.conversationId;
+    const conversationId = event.address.conversationId;
     const chatId = parseInt(conversationId);
     const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;
     const message = createConversationMessage({
@@ -29,7 +26,6 @@ export function createTelegramAdapters(event, bot) {
         attachments: event.attachments,
         threadTs: event.thread_ts,
     });
-    // The bot's getMessagingInfo() is the single authority for platform info.
     const platform = bot.getMessagingInfo();
     const { responder } = createProgressiveRenderer({
         label: "Telegram",
@@ -38,7 +34,6 @@ export function createTelegramAdapters(event, bot) {
         errorPrefix: "Error: ",
         supportsDeltas: true,
         typing: {
-            // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)
             send: () => bot.sendTyping(chatId),
             intervalMs: 4000,
         },
@@ -63,8 +58,6 @@ export function createTelegramAdapters(event, bot) {
             return String(id);
         },
         update: (id, text) => bot.updateMessage(conversationId, id, text),
-        // Returns the id so the renderer can edit this overflow message on the
-        // next redraw instead of posting another copy of the tail.
         postExtra: (text) => bot.postMessageRaw(chatId, text),
         delete: (id) => bot.deleteMessageRaw(chatId, Number(id)),
         logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),

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

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"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","sourcesContent":["import { createConversationMessage } from \"../index.js\";\nimport type { ChatToolResult, ConversationContext } from \"../index.js\";\nimport { deriveSessionKey } from \"../../sessions/session-key.js\";\nimport { createProgressiveRenderer } from \"../progressive-renderer.js\";\nimport { formatToolArgs } from \"../shared.js\";\nimport type { TelegramMessagingBot, TelegramEvent } from \"./bot.js\";\n\n// A rich message allows far more than the 4096 a plain message did; this stays\n// well inside it, and the headroom is now for the continuation marker alone\n// rather than for HTML escapes that no longer happen.\nconst MAX_LENGTH = 30000;\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  const title = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName}${result.label ? `: ${result.label}` : \"\"} (${duration}s)`;\n  return [title, argsFormatted, result.result].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function createTelegramAdapters(\n  event: TelegramEvent,\n  bot: TelegramMessagingBot,\n): ConversationContext {\n  const conversationId = event.conversationId;\n  const chatId = parseInt(conversationId);\n  const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;\n\n  const message = createConversationMessage({\n    platform: \"telegram\",\n    conversationId,\n    address: event.address,\n    id: event.ts,\n    sessionKey: deriveSessionKey(event),\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  });\n\n  // The bot's getMessagingInfo() is the single authority for platform info.\n  const platform = bot.getMessagingInfo();\n\n  const { responder } = createProgressiveRenderer({\n    label: \"Telegram\",\n    maxLength: MAX_LENGTH,\n    formatContinuation: (partNum: number): string => `(continued ${partNum})`,\n    errorPrefix: \"Error: \",\n    supportsDeltas: true,\n    typing: {\n      // Send immediately and repeat every 4s (Telegram clears indicator after ~5s)\n      send: () => bot.sendTyping(chatId),\n      intervalMs: 4000,\n    },\n    formatToolResult,\n    responseErrorContext: (responseId) => ({\n      platform: \"telegram\",\n      conversationId,\n      chatId,\n      messageId: message.id,\n      sessionKey: message.sessionKey,\n      responseMessageId: responseId,\n      replyToId,\n      conversationKind: message.conversationKind,\n    }),\n    notifySendFailure: async (errorMessage) => {\n      await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errorMessage}`);\n    },\n    post: async (text) => {\n      const id =\n        replyToId !== null\n          ? await bot.postReply(chatId, replyToId, text)\n          : await bot.postMessageRaw(chatId, text);\n      return String(id);\n    },\n    update: (id, text) => bot.updateMessage(conversationId, id, text),\n    // Returns the id so the renderer can edit this overflow message on the\n    // next redraw instead of posting another copy of the tail.\n    postExtra: (text) => bot.postMessageRaw(chatId, text),\n    delete: (id) => bot.deleteMessageRaw(chatId, Number(id)),\n    logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),\n    uploadFile: (filePath, title) => bot.uploadFile(conversationId, filePath, title),\n    react: (emoji) => bot.addReaction(conversationId, event.ts, emoji),\n  });\n\n  return { address: message.address, message, responder, platform };\n}\n"]}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/adapters/telegram/context.ts"],"names":[],"mappings":"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","sourcesContent":["import { createConversationMessage } from \"../index.js\";\nimport type { ChatToolResult, ConversationContext } from \"../index.js\";\nimport { deriveSessionKey } from \"../../sessions/session-key.js\";\nimport { createProgressiveRenderer } from \"../progressive-renderer.js\";\nimport { formatToolArgs } from \"../shared.js\";\nimport type { TelegramMessagingBot, TelegramEvent } from \"./bot.js\";\n\nconst MAX_LENGTH = 30000;\n\nfunction formatToolResult(result: ChatToolResult): string {\n  const argsFormatted = formatToolArgs(result.args);\n  const duration = (result.durationMs / 1000).toFixed(1);\n  const title = `${result.isError ? \"Error\" : \"Done\"} ${result.toolName}${result.label ? `: ${result.label}` : \"\"} (${duration}s)`;\n  return [title, argsFormatted, result.result].filter(Boolean).join(\"\\n\\n\");\n}\n\nexport function createTelegramAdapters(\n  event: TelegramEvent,\n  bot: TelegramMessagingBot,\n): ConversationContext {\n  const conversationId = event.address.conversationId;\n  const chatId = parseInt(conversationId);\n  const replyToId = event.thread_ts ? parseInt(event.thread_ts) : null;\n\n  const message = createConversationMessage({\n    platform: \"telegram\",\n    conversationId,\n    address: event.address,\n    id: event.ts,\n    sessionKey: deriveSessionKey(event),\n    conversationKind: event.conversationKind,\n    userId: event.user,\n    userName: event.userName,\n    text: event.text,\n    attachments: event.attachments,\n    threadTs: event.thread_ts,\n  });\n\n  const platform = bot.getMessagingInfo();\n\n  const { responder } = createProgressiveRenderer({\n    label: \"Telegram\",\n    maxLength: MAX_LENGTH,\n    formatContinuation: (partNum: number): string => `(continued ${partNum})`,\n    errorPrefix: \"Error: \",\n    supportsDeltas: true,\n    typing: {\n      send: () => bot.sendTyping(chatId),\n      intervalMs: 4000,\n    },\n    formatToolResult,\n    responseErrorContext: (responseId) => ({\n      platform: \"telegram\",\n      conversationId,\n      chatId,\n      messageId: message.id,\n      sessionKey: message.sessionKey,\n      responseMessageId: responseId,\n      replyToId,\n      conversationKind: message.conversationKind,\n    }),\n    notifySendFailure: async (errorMessage) => {\n      await bot.postPlainMessage(chatId, `⚠️ 發送失敗：${errorMessage}`);\n    },\n    post: async (text) => {\n      const id =\n        replyToId !== null\n          ? await bot.postReply(chatId, replyToId, text)\n          : await bot.postMessageRaw(chatId, text);\n      return String(id);\n    },\n    update: (id, text) => bot.updateMessage(conversationId, id, text),\n    postExtra: (text) => bot.postMessageRaw(chatId, text),\n    delete: (id) => bot.deleteMessageRaw(chatId, Number(id)),\n    logBotResponse: (text, id) => bot.logBotResponse(conversationId, text, id),\n    uploadFile: (filePath, title) => bot.uploadFile(conversationId, filePath, title),\n    react: (emoji) => bot.addReaction(conversationId, event.ts, emoji),\n  });\n\n  return { address: message.address, message, responder, platform };\n}\n"]}

package/dist/adapters/types.d.ts

@@ -19,17 +19,13 @@ export interface ChatResponseErrorContext {
 }
 export type ChatResponseErrorReporter = (err: unknown, operation: ChatResponseErrorOperation, extra?: Record<string, unknown>) => void;
 export interface RetryOptions {
-    /** Predicate that returns true when an error is worth retrying (rate limit, transient 5xx, etc.). */
     isRateLimited: (err: Error) => boolean;
-    /** Total attempts including the first call. */
     maxAttempts?: number;
     baseDelayMs?: number;
 }
 export interface ResolveStopTargetInput {
     handler: MessagingEventHandler;
-    /** The office whose runtime state may be stopped. */
     address: OfficeAddress;
-    /** Session key derived from the current message; checked first when present. */
     sessionKey?: string;
 }
 export interface HandleTooLongInput {
@@ -46,24 +42,11 @@ interface ProgressiveStreamTransport {
     start(text: string): Promise<string>;
     append(messageId: string, delta: string): Promise<void>;
     stop(messageId: string): Promise<void>;
-    /**
-     * Withhold an append until this many characters have accumulated. A
-     * streaming transport is usually rate-limited per call rather than per byte,
-     * so forwarding every token spends the budget on latency nobody perceives.
-     * The final render flushes whatever is left before stopping, so buffering
-     * can never drop text. Omit for no buffering.
-     */
     minDeltaChars?: number;
 }
 export interface ProgressiveRendererPlatform {
     label: string;
     maxLength: number;
-    /**
-     * Shortest gap between redraws of a streaming response, measured from the
-     * end of the previous one. Platforms meter edits per channel at different
-     * rates; the default suits the tightest of them. Zero redraws on every
-     * delta, which only a platform with no such limit can afford.
-     */
     flushIntervalMs?: number;
     initialResponseId?: string | null;
     formatContinuation: (partNum: number) => string;
@@ -74,15 +57,10 @@ export interface ProgressiveRendererPlatform {
     prepareSource?: (text: string, working: boolean) => string;
     onWorkingChanged?: (working: boolean, responseId: string | null) => Promise<void>;
     setTyping?: (isTyping: boolean, responseId: string | null) => Promise<void>;
-    /** Terminal hook. Awaited, so it may finish sending before the run ends. */
     onFinish?: (text: string, responseId: string | null) => void | Promise<void>;
-    /** Whether `respond` calls are complete messages that should be logged immediately. */
     logIntermediateResponses?: boolean;
-    /** Whether the platform accepts incremental response deltas. */
     supportsDeltas?: boolean;
-    /** Native stream operations, when this reply target supports them. */
     stream?: ProgressiveStreamTransport;
-    /** Re-render a finished response when the provisional stream lacked structure. */
     needsCanonicalRender?: (text: string) => boolean;
     formatSubagentProgress?: (progress: SubagentProgressSnapshot) => string;
     typing?: {
@@ -91,7 +69,6 @@ export interface ProgressiveRendererPlatform {
         stopOnSend?: boolean;
     };
     formatToolResult: (result: ChatToolResult) => string;
-    /** Stable platform context plus the current response identity for error reporting. */
     responseErrorContext?: (responseId: string | null) => Omit<ChatResponseErrorContext, "operation" | "extra">;
     notifySendFailure?: (errorMessage: string) => Promise<void>;
     post: (text: string) => Promise<string>;
@@ -106,51 +83,23 @@ export interface ProgressiveRendererPlatform {
     uploadFile?: (filePath: string, title?: string) => Promise<void>;
     uploadFallbackNote?: (name: string) => string;
     react?: (emoji: string) => Promise<void>;
-    /**
-     * Whether a send failure is a length rejection, as opposed to a rate limit
-     * or an outage. Without this the fallback swallows every error, so a
-     * transient 429 gets reported to the reader as "message too long" and the
-     * response is truncated for no reason.
-     */
     isTooLongError?: (err: unknown) => boolean;
-    /** Handle a Slack-style length rejection and return the canonical fallback text. */
     handleTooLong?: (input: HandleTooLongInput) => Promise<{
         text: string;
         prefixLength?: number;
     }>;
 }
-/** How intake resolved a message. Callers branch on this instead of passing callbacks. */
 export type MessageIntakeOutcome = "magic-word" | "not-triggered" | "rejected-busy" | "enqueued";
-/** Platform policy for the magic-word step, stated as data. */
 export interface MagicWordIntakeOptions {
-    /**
-     * Raw user-typed text to match when `eventBase.text` is decorated for the
-     * agent (e.g. GitHub review-comment framing). Defaults to `eventBase.text`.
-     */
     text?: string;
-    /**
-     * Whether the message addressed the bot (mention, DM, slash form). The idle
-     * "Nothing running." reply is suppressed for unaddressed messages.
-     */
     addressed: boolean;
-    /**
-     * How far a stop may widen when the direct session key is not running:
-     * "top-level" widens to the single running scoped session only from the
-     * persistent conversation session, "always" widens unconditionally,
-     * "never" stops only exact matches.
-     */
     scopeFallback: "top-level" | "always" | "never";
 }
-/** One platform file to save into an office's attachments directory. */
 export interface IncomingAttachment {
-    /** Original file name as the platform reports it. */
     name: string;
-    /** Epoch ms used in the stored filename; defaults to the time of saving. */
     timestampMs?: number;
-    /** Fetch the file and write it to destPath (the parent directory exists). */
     download(destPath: string): Promise<void>;
 }
-/** Outcome of saving incoming attachments; error policy stays with the adapter. */
 export interface SavedAttachments {
     saved: Attachment[];
     failed: {
@@ -160,13 +109,8 @@ export interface SavedAttachments {
 }
 export interface MessageIntakeOptions<TEvent extends ConversationEvent> {
     eventBase: TEvent;
-    /** Explicit DM, mention, command or supported thread continuation. */
     addressed: boolean;
     magicWord: MagicWordIntakeOptions;
-    /**
-     * "reject" bounces a new message while its session is already running
-     * (with an "Already working" reply); "queue" lines it up behind the run.
-     */
     busyPolicy: "queue" | "reject";
     logEntryBase: Record<string, unknown>;
     log?: (entry: Record<string, unknown>) => void;
@@ -181,7 +125,6 @@ export interface MessageIntakeOptions<TEvent extends ConversationEvent> {
 export interface MarkdownTable {
     headers: string[];
     rows: string[][];
-    /** Source line span, so a caller can slice the prose around it. */
     startLine: number;
     endLine: number;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}