wherever-dev 0.21.1 → 0.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/dist/assistant-channels.d.ts +242 -0
  3. package/dist/assistant-channels.d.ts.map +1 -0
  4. package/dist/assistant-channels.js +270 -0
  5. package/dist/assistant-channels.js.map +1 -0
  6. package/dist/assistant-controller.d.ts +228 -0
  7. package/dist/assistant-controller.d.ts.map +1 -0
  8. package/dist/assistant-controller.js +314 -0
  9. package/dist/assistant-controller.js.map +1 -0
  10. package/dist/assistant-cron.d.ts +87 -0
  11. package/dist/assistant-cron.d.ts.map +1 -0
  12. package/dist/assistant-cron.js +352 -0
  13. package/dist/assistant-cron.js.map +1 -0
  14. package/dist/assistant-folder.d.ts +161 -0
  15. package/dist/assistant-folder.d.ts.map +1 -0
  16. package/dist/assistant-folder.js +333 -0
  17. package/dist/assistant-folder.js.map +1 -0
  18. package/dist/assistant-schedule.d.ts +236 -0
  19. package/dist/assistant-schedule.d.ts.map +1 -0
  20. package/dist/assistant-schedule.js +454 -0
  21. package/dist/assistant-schedule.js.map +1 -0
  22. package/dist/assistant-scheduler.d.ts +210 -0
  23. package/dist/assistant-scheduler.d.ts.map +1 -0
  24. package/dist/assistant-scheduler.js +472 -0
  25. package/dist/assistant-scheduler.js.map +1 -0
  26. package/dist/assistant-tool-text.d.ts +40 -0
  27. package/dist/assistant-tool-text.d.ts.map +1 -0
  28. package/dist/assistant-tool-text.js +102 -0
  29. package/dist/assistant-tool-text.js.map +1 -0
  30. package/dist/assistant-tools.d.ts +207 -0
  31. package/dist/assistant-tools.d.ts.map +1 -0
  32. package/dist/assistant-tools.js +390 -0
  33. package/dist/assistant-tools.js.map +1 -0
  34. package/dist/cli-requests.d.ts +90 -0
  35. package/dist/cli-requests.d.ts.map +1 -0
  36. package/dist/cli-requests.js +75 -0
  37. package/dist/cli-requests.js.map +1 -0
  38. package/dist/index.js +396 -7
  39. package/dist/index.js.map +1 -1
  40. package/dist/protocol.d.ts +43 -0
  41. package/dist/protocol.d.ts.map +1 -1
  42. package/dist/reply-routing.d.ts +106 -0
  43. package/dist/reply-routing.d.ts.map +1 -0
  44. package/dist/reply-routing.js +174 -0
  45. package/dist/reply-routing.js.map +1 -0
  46. package/dist/session-pool.d.ts +232 -4
  47. package/dist/session-pool.d.ts.map +1 -1
  48. package/dist/session-pool.js +446 -100
  49. package/dist/session-pool.js.map +1 -1
  50. package/dist/telegram-channel.d.ts +272 -0
  51. package/dist/telegram-channel.d.ts.map +1 -0
  52. package/dist/telegram-channel.js +701 -0
  53. package/dist/telegram-channel.js.map +1 -0
  54. package/dist/telegram-files.d.ts +101 -0
  55. package/dist/telegram-files.d.ts.map +1 -0
  56. package/dist/telegram-files.js +145 -0
  57. package/dist/telegram-files.js.map +1 -0
  58. package/dist/telegram-pairing.d.ts +119 -0
  59. package/dist/telegram-pairing.d.ts.map +1 -0
  60. package/dist/telegram-pairing.js +97 -0
  61. package/dist/telegram-pairing.js.map +1 -0
  62. package/dist/telegram-replies.d.ts +94 -0
  63. package/dist/telegram-replies.d.ts.map +1 -0
  64. package/dist/telegram-replies.js +329 -0
  65. package/dist/telegram-replies.js.map +1 -0
  66. package/dist/telegram-token.d.ts +55 -0
  67. package/dist/telegram-token.d.ts.map +1 -0
  68. package/dist/telegram-token.js +86 -0
  69. package/dist/telegram-token.js.map +1 -0
  70. package/dist/web-push.d.ts +167 -0
  71. package/dist/web-push.d.ts.map +1 -0
  72. package/dist/web-push.js +387 -0
  73. package/dist/web-push.js.map +1 -0
  74. package/package.json +1 -1
  75. package/public/_app/immutable/assets/0.BkzT3rFr.css +1 -0
  76. package/public/_app/immutable/chunks/CExVgK9Z.js +2 -0
  77. package/public/_app/immutable/chunks/CExVgK9Z.js.map +1 -0
  78. package/public/_app/immutable/chunks/CkOw6fRa.js +2 -0
  79. package/public/_app/immutable/chunks/{BQ9B_G4h.js.map → CkOw6fRa.js.map} +1 -1
  80. package/public/_app/immutable/chunks/DyHllYtq.js +2 -0
  81. package/public/_app/immutable/chunks/{BUONgvl4.js.map → DyHllYtq.js.map} +1 -1
  82. package/public/_app/immutable/entry/{app.BZO7Xckk.js → app.D3PEFbtP.js} +3 -3
  83. package/public/_app/immutable/entry/{app.BZO7Xckk.js.map → app.D3PEFbtP.js.map} +1 -1
  84. package/public/_app/immutable/entry/start.BR00Qps5.js +2 -0
  85. package/public/_app/immutable/entry/start.BR00Qps5.js.map +1 -0
  86. package/public/_app/immutable/nodes/{0.Czz2XmZU.js → 0.DG3L8hMN.js} +3 -3
  87. package/public/_app/immutable/nodes/{0.Czz2XmZU.js.map → 0.DG3L8hMN.js.map} +1 -1
  88. package/public/_app/immutable/nodes/{1.DDvrriUW.js → 1.BCpuoZxW.js} +2 -2
  89. package/public/_app/immutable/nodes/{1.DDvrriUW.js.map → 1.BCpuoZxW.js.map} +1 -1
  90. package/public/_app/immutable/nodes/2.D2auiZW1.js +122 -0
  91. package/public/_app/immutable/nodes/2.D2auiZW1.js.map +1 -0
  92. package/public/_app/version.json +1 -1
  93. package/public/index.html +11 -11
  94. package/public/service-worker.js +1 -1
  95. package/public/_app/immutable/assets/0.BKJ49K71.css +0 -1
  96. package/public/_app/immutable/chunks/BQ9B_G4h.js +0 -2
  97. package/public/_app/immutable/chunks/BUONgvl4.js +0 -2
  98. package/public/_app/immutable/chunks/DauELski.js +0 -2
  99. package/public/_app/immutable/chunks/DauELski.js.map +0 -1
  100. package/public/_app/immutable/entry/start.DWD60uNu.js +0 -2
  101. package/public/_app/immutable/entry/start.DWD60uNu.js.map +0 -1
  102. package/public/_app/immutable/nodes/2.C7E8EMKX.js +0 -120
  103. package/public/_app/immutable/nodes/2.C7E8EMKX.js.map +0 -1
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Telegram REPLY delivery (task `telegram-conversation`): turns the pool events
3
+ * whose current destination is `telegram` (ADR 0014, handed over by the channel
4
+ * dispatcher) into Telegram messages. The mechanics are ported from the MIT
5
+ * `badlogic/pi-telegram` extension (`index.ts`):
6
+ *
7
+ * - STREAMING: while an assistant message streams (`message_update`), its text
8
+ * is shown as a DRAFT with `sendMessageDraft`; at its `message_end` the final
9
+ * text is sent as a real message and the draft is cleared (an empty draft).
10
+ * When the Bot API refuses drafts (an older Bot API, a self-hosted server),
11
+ * the preview falls back to `sendMessage` + `editMessageText`, and that is
12
+ * remembered for every later reply (`draftSupport`).
13
+ * - THROTTLE: the first preview of a message goes out at once (the user sees
14
+ * the assistant started); later ones at most every `throttleMs` (750 ms).
15
+ * - SPLITTING: text longer than `TELEGRAM_TEXT_LIMIT` is split by paragraph,
16
+ * then by line, then hard (never inside a surrogate pair). A preview is
17
+ * truncated to the limit; the final message is sent in parts.
18
+ * - ENDS: an assistant message with no text (tool calls only) sends nothing;
19
+ * an ABORTED one (`stop`) clears its draft (a fallback preview message stays
20
+ * as it was); an ERROR one is reported as `⚠️ The assistant failed: ...`.
21
+ *
22
+ * - FILES (task `telegram-files`): a successful `attach_file` call's
23
+ * `tool_execution_end` sends its file (`sendPhoto` / `sendDocument`, by
24
+ * telegram-files.ts's `attachmentPlan`), or a clear note when it is too large
25
+ * or Telegram refuses it. It joins the same serial chain, so the file lands
26
+ * after the text the assistant wrote before the call.
27
+ *
28
+ * One stream per session file (a reply in an old session, after a reset, never
29
+ * mixes with the new one), and every Bot API call of every stream goes through
30
+ * ONE serial chain, so the messages arrive in the order the events did.
31
+ *
32
+ * Decision (recorded in work/notes/observations/telegram-conversation-decisions.md):
33
+ * EACH assistant message with text is delivered at its own `message_end` (a
34
+ * turn with tool calls in between may send several messages), rather than only
35
+ * the last one at `agent_end` as pi-telegram does: per-message routing (ADR
36
+ * 0014) can change the destination in the middle of a run (a steer), so the
37
+ * natural unit is the message, and `message_start` is not forwarded for CLI
38
+ * sessions.
39
+ */
40
+ /**
41
+ * The longest text sent in one message. Telegram's limit is 4096 characters;
42
+ * JavaScript lengths are UTF-16 code units (never fewer than Telegram counts),
43
+ * and the margin keeps every part safely UNDER the limit.
44
+ */
45
+ export declare const TELEGRAM_TEXT_LIMIT = 4000;
46
+ export declare const PREVIEW_THROTTLE_MS = 750;
47
+ export type BotCall = <T>(method: string, params: Record<string, unknown>) => Promise<T>;
48
+ /** A multipart Bot API call sending one local file in `fileField` (`sendPhoto` / `sendDocument`). */
49
+ export type BotUpload = (method: string, fields: Record<string, string>, fileField: string, filePath: string, fileName: string) => Promise<unknown>;
50
+ export interface TelegramRepliesOptions {
51
+ call: BotCall;
52
+ /** Sends attached files; without it an `attach_file` is not delivered. */
53
+ upload?: BotUpload;
54
+ /** The paired chat (null while unpaired: nothing is sent). */
55
+ chatId: () => string | null;
56
+ throttleMs?: number;
57
+ log?: Pick<Console, 'log' | 'warn' | 'error'>;
58
+ }
59
+ /** Split `text` into parts of at most `limit` UTF-16 units (paragraph, line, then hard). */
60
+ export declare function splitTelegramText(text: string, limit?: number): string[];
61
+ /** The text blocks of a pi message's `content`, joined and trimmed. */
62
+ export declare function assistantText(content: unknown): string;
63
+ export declare class TelegramReplies {
64
+ private readonly call;
65
+ private readonly upload;
66
+ private readonly chatId;
67
+ private readonly throttleMs;
68
+ private readonly log;
69
+ private readonly streams;
70
+ private draftSupport;
71
+ private nextDraftId;
72
+ private chain;
73
+ private timers;
74
+ constructor(opts: TelegramRepliesOptions);
75
+ /** One pool event whose destination is Telegram. */
76
+ handle(sessionFile: string, event: {
77
+ type: string;
78
+ [k: string]: unknown;
79
+ }): void;
80
+ /** Resolves once every pending preview and send has run (tests, shutdown). */
81
+ idle(): Promise<void>;
82
+ /** Drop every stream's pending preview (the channel stopped). */
83
+ stop(): void;
84
+ private streamFor;
85
+ private enqueue;
86
+ private allocateDraftId;
87
+ /** Show the stream's pending text (draft, else the fallback preview message). */
88
+ private flush;
89
+ private finish;
90
+ /** An `attach_file`'s file: sent as a photo or a document, else a note saying why not. */
91
+ private sendAttachment;
92
+ private clearDraft;
93
+ }
94
+ //# sourceMappingURL=telegram-replies.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telegram-replies.d.ts","sourceRoot":"","sources":["../src/telegram-replies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,OAAO,CAAC;AACxC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAGvC,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAEzF,qGAAqG;AACrG,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpJ,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,OAAO,CAAC;IACd,0EAA0E;IAC1E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CAC/C;AAYD,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAsB,GAAG,MAAM,EAAE,CA+BrF;AAuBD,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAQtD;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA0C;IAC9D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,YAAY,CAAsD;IAC1E,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,MAAM,CAAK;gBAEP,IAAI,EAAE,sBAAsB;IAQxC,oDAAoD;IACpD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI;IAwChF,8EAA8E;IACxE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,iEAAiE;IACjE,IAAI,IAAI,IAAI;IAYZ,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,eAAe;IAKvB,iFAAiF;YACnE,KAAK;YA6BL,MAAM;IA2BpB,0FAA0F;YAC5E,cAAc;YA8Bd,UAAU;CAQzB"}
@@ -0,0 +1,329 @@
1
+ /**
2
+ * Telegram REPLY delivery (task `telegram-conversation`): turns the pool events
3
+ * whose current destination is `telegram` (ADR 0014, handed over by the channel
4
+ * dispatcher) into Telegram messages. The mechanics are ported from the MIT
5
+ * `badlogic/pi-telegram` extension (`index.ts`):
6
+ *
7
+ * - STREAMING: while an assistant message streams (`message_update`), its text
8
+ * is shown as a DRAFT with `sendMessageDraft`; at its `message_end` the final
9
+ * text is sent as a real message and the draft is cleared (an empty draft).
10
+ * When the Bot API refuses drafts (an older Bot API, a self-hosted server),
11
+ * the preview falls back to `sendMessage` + `editMessageText`, and that is
12
+ * remembered for every later reply (`draftSupport`).
13
+ * - THROTTLE: the first preview of a message goes out at once (the user sees
14
+ * the assistant started); later ones at most every `throttleMs` (750 ms).
15
+ * - SPLITTING: text longer than `TELEGRAM_TEXT_LIMIT` is split by paragraph,
16
+ * then by line, then hard (never inside a surrogate pair). A preview is
17
+ * truncated to the limit; the final message is sent in parts.
18
+ * - ENDS: an assistant message with no text (tool calls only) sends nothing;
19
+ * an ABORTED one (`stop`) clears its draft (a fallback preview message stays
20
+ * as it was); an ERROR one is reported as `⚠️ The assistant failed: ...`.
21
+ *
22
+ * - FILES (task `telegram-files`): a successful `attach_file` call's
23
+ * `tool_execution_end` sends its file (`sendPhoto` / `sendDocument`, by
24
+ * telegram-files.ts's `attachmentPlan`), or a clear note when it is too large
25
+ * or Telegram refuses it. It joins the same serial chain, so the file lands
26
+ * after the text the assistant wrote before the call.
27
+ *
28
+ * One stream per session file (a reply in an old session, after a reset, never
29
+ * mixes with the new one), and every Bot API call of every stream goes through
30
+ * ONE serial chain, so the messages arrive in the order the events did.
31
+ *
32
+ * Decision (recorded in work/notes/observations/telegram-conversation-decisions.md):
33
+ * EACH assistant message with text is delivered at its own `message_end` (a
34
+ * turn with tool calls in between may send several messages), rather than only
35
+ * the last one at `agent_end` as pi-telegram does: per-message routing (ADR
36
+ * 0014) can change the destination in the middle of a run (a steer), so the
37
+ * natural unit is the message, and `message_start` is not forwarded for CLI
38
+ * sessions.
39
+ */
40
+ import { attachedFileOf, attachmentFailedNote, attachmentPlan, attachmentTooLargeNote, fileSize } from './telegram-files.js';
41
+ /**
42
+ * The longest text sent in one message. Telegram's limit is 4096 characters;
43
+ * JavaScript lengths are UTF-16 code units (never fewer than Telegram counts),
44
+ * and the margin keeps every part safely UNDER the limit.
45
+ */
46
+ export const TELEGRAM_TEXT_LIMIT = 4000;
47
+ export const PREVIEW_THROTTLE_MS = 750;
48
+ const DRAFT_ID_MAX = 2_147_483_647;
49
+ /** Split `text` into parts of at most `limit` UTF-16 units (paragraph, line, then hard). */
50
+ export function splitTelegramText(text, limit = TELEGRAM_TEXT_LIMIT) {
51
+ if (text.length <= limit)
52
+ return [text];
53
+ const out = [];
54
+ let current = '';
55
+ const pushPart = (part, sep) => {
56
+ const candidate = current.length === 0 ? part : `${current}${sep}${part}`;
57
+ if (candidate.length <= limit) {
58
+ current = candidate;
59
+ return;
60
+ }
61
+ if (current.trim().length > 0)
62
+ out.push(current);
63
+ current = part;
64
+ };
65
+ for (const paragraph of text.replace(/\r\n/g, '\n').split(/\n\n+/)) {
66
+ if (paragraph.length === 0)
67
+ continue;
68
+ if (paragraph.length <= limit) {
69
+ pushPart(paragraph, '\n\n');
70
+ continue;
71
+ }
72
+ // A long paragraph: by line, then hard. Its pieces join with '\n'.
73
+ let first = true;
74
+ for (const line of paragraph.split('\n')) {
75
+ const pieces = line.length <= limit ? [line] : hardSplit(line, limit);
76
+ for (const piece of pieces) {
77
+ pushPart(piece, first ? '\n\n' : '\n');
78
+ first = false;
79
+ }
80
+ }
81
+ }
82
+ if (current.trim().length > 0)
83
+ out.push(current);
84
+ return out;
85
+ }
86
+ function hardSplit(line, limit) {
87
+ const out = [];
88
+ let i = 0;
89
+ while (i < line.length) {
90
+ let j = Math.min(line.length, i + limit);
91
+ // Never end a part on a high surrogate (it would split a pair).
92
+ if (j < line.length && /[\uD800-\uDBFF]/.test(line[j - 1]))
93
+ j -= 1;
94
+ out.push(line.slice(i, j));
95
+ i = j;
96
+ }
97
+ return out;
98
+ }
99
+ /** The first `limit` units of `text`, never ending inside a surrogate pair. */
100
+ function truncate(text, limit = TELEGRAM_TEXT_LIMIT) {
101
+ if (text.length <= limit)
102
+ return text;
103
+ let j = limit;
104
+ if (/[\uD800-\uDBFF]/.test(text[j - 1]))
105
+ j -= 1;
106
+ return text.slice(0, j);
107
+ }
108
+ /** The text blocks of a pi message's `content`, joined and trimmed. */
109
+ export function assistantText(content) {
110
+ if (typeof content === 'string')
111
+ return content.trim();
112
+ if (!Array.isArray(content))
113
+ return '';
114
+ return content
115
+ .filter((b) => !!b && typeof b === 'object' && b.type === 'text' && typeof b.text === 'string')
116
+ .map((b) => b.text)
117
+ .join('')
118
+ .trim();
119
+ }
120
+ export class TelegramReplies {
121
+ call;
122
+ upload;
123
+ chatId;
124
+ throttleMs;
125
+ log;
126
+ streams = new Map();
127
+ draftSupport = 'unknown';
128
+ nextDraftId = 0;
129
+ chain = Promise.resolve();
130
+ timers = 0;
131
+ constructor(opts) {
132
+ this.call = opts.call;
133
+ this.upload = opts.upload;
134
+ this.chatId = opts.chatId;
135
+ this.throttleMs = opts.throttleMs ?? PREVIEW_THROTTLE_MS;
136
+ this.log = opts.log ?? console;
137
+ }
138
+ /** One pool event whose destination is Telegram. */
139
+ handle(sessionFile, event) {
140
+ const attached = attachedFileOf(event);
141
+ if (attached) {
142
+ this.enqueue(() => this.sendAttachment(attached.path, attached.filename));
143
+ return;
144
+ }
145
+ const message = event.message;
146
+ if (!message || message.role !== 'assistant')
147
+ return;
148
+ if (event.type === 'message_update') {
149
+ const stream = this.streamFor(sessionFile);
150
+ stream.pending = assistantText(message.content);
151
+ if (!stream.pending)
152
+ return;
153
+ if (!stream.flushed && !stream.timer) {
154
+ stream.flushed = true;
155
+ this.enqueue(() => this.flush(stream));
156
+ }
157
+ else if (!stream.timer) {
158
+ this.timers += 1;
159
+ stream.timer = setTimeout(() => {
160
+ this.timers -= 1;
161
+ stream.timer = undefined;
162
+ this.enqueue(() => this.flush(stream));
163
+ }, this.throttleMs);
164
+ }
165
+ return;
166
+ }
167
+ if (event.type === 'message_end') {
168
+ const stream = this.streams.get(sessionFile);
169
+ this.streams.delete(sessionFile);
170
+ if (stream?.timer) {
171
+ clearTimeout(stream.timer);
172
+ stream.timer = undefined;
173
+ this.timers -= 1;
174
+ }
175
+ const text = assistantText(message.content);
176
+ const stopReason = typeof message.stopReason === 'string' ? message.stopReason : undefined;
177
+ const errorMessage = typeof message.errorMessage === 'string' ? message.errorMessage : undefined;
178
+ this.enqueue(() => this.finish(stream, text, stopReason, errorMessage));
179
+ }
180
+ }
181
+ /** Resolves once every pending preview and send has run (tests, shutdown). */
182
+ async idle() {
183
+ for (;;) {
184
+ const chain = this.chain;
185
+ await chain;
186
+ if (this.timers > 0) {
187
+ await new Promise((r) => setTimeout(r, Math.max(5, this.throttleMs)));
188
+ continue;
189
+ }
190
+ if (chain === this.chain)
191
+ return;
192
+ }
193
+ }
194
+ /** Drop every stream's pending preview (the channel stopped). */
195
+ stop() {
196
+ for (const s of this.streams.values()) {
197
+ if (s.timer) {
198
+ clearTimeout(s.timer);
199
+ this.timers -= 1;
200
+ }
201
+ }
202
+ this.streams.clear();
203
+ }
204
+ // -------------------------------------------------------------------------
205
+ streamFor(sessionFile) {
206
+ let s = this.streams.get(sessionFile);
207
+ if (!s) {
208
+ s = { mode: this.draftSupport === 'unsupported' ? 'message' : 'draft', pending: '', lastSent: '', flushed: false };
209
+ this.streams.set(sessionFile, s);
210
+ }
211
+ return s;
212
+ }
213
+ enqueue(op) {
214
+ this.chain = this.chain.then(op).catch((err) => this.log.warn(`[wherever] telegram: reply delivery failed: ${errMessage(err)}`));
215
+ }
216
+ allocateDraftId() {
217
+ this.nextDraftId = this.nextDraftId >= DRAFT_ID_MAX ? 1 : this.nextDraftId + 1;
218
+ return this.nextDraftId;
219
+ }
220
+ /** Show the stream's pending text (draft, else the fallback preview message). */
221
+ async flush(stream) {
222
+ const chatId = this.chatId();
223
+ if (!chatId)
224
+ return;
225
+ const text = truncate(stream.pending.trim());
226
+ if (!text || text === stream.lastSent)
227
+ return;
228
+ if (stream.mode === 'draft' && this.draftSupport !== 'unsupported') {
229
+ stream.draftId ??= this.allocateDraftId();
230
+ try {
231
+ await this.call('sendMessageDraft', { chat_id: chatId, draft_id: stream.draftId, text });
232
+ this.draftSupport = 'supported';
233
+ stream.lastSent = text;
234
+ return;
235
+ }
236
+ catch (err) {
237
+ this.log.log(`[wherever] telegram: sendMessageDraft unavailable (${errMessage(err)}); falling back to sendMessage + editMessageText`);
238
+ this.draftSupport = 'unsupported';
239
+ stream.mode = 'message';
240
+ stream.draftId = undefined;
241
+ }
242
+ }
243
+ stream.mode = 'message';
244
+ if (stream.messageId === undefined) {
245
+ const sent = await this.call('sendMessage', { chat_id: chatId, text });
246
+ stream.messageId = sent?.message_id;
247
+ }
248
+ else {
249
+ await this.call('editMessageText', { chat_id: chatId, message_id: stream.messageId, text });
250
+ }
251
+ stream.lastSent = text;
252
+ }
253
+ async finish(stream, text, stopReason, errorMessage) {
254
+ const chatId = this.chatId();
255
+ if (!chatId)
256
+ return;
257
+ if (stopReason === 'aborted') {
258
+ await this.clearDraft(chatId, stream);
259
+ return;
260
+ }
261
+ if (text) {
262
+ const parts = splitTelegramText(text);
263
+ let rest = parts;
264
+ if (stream?.mode === 'message' && stream.messageId !== undefined) {
265
+ // The fallback preview message becomes the first part.
266
+ if (parts[0] !== stream.lastSent) {
267
+ await this.call('editMessageText', { chat_id: chatId, message_id: stream.messageId, text: parts[0] });
268
+ }
269
+ rest = parts.slice(1);
270
+ }
271
+ for (const part of rest)
272
+ await this.call('sendMessage', { chat_id: chatId, text: part });
273
+ await this.clearDraft(chatId, stream);
274
+ }
275
+ else {
276
+ await this.clearDraft(chatId, stream);
277
+ }
278
+ if (stopReason === 'error') {
279
+ await this.call('sendMessage', { chat_id: chatId, text: `⚠️ The assistant failed: ${errorMessage || 'unknown error'}` });
280
+ }
281
+ }
282
+ /** An `attach_file`'s file: sent as a photo or a document, else a note saying why not. */
283
+ async sendAttachment(filePath, filename) {
284
+ const chatId = this.chatId();
285
+ if (!chatId || !this.upload)
286
+ return;
287
+ const size = fileSize(filePath);
288
+ if (size === null) {
289
+ await this.call('sendMessage', { chat_id: chatId, text: attachmentFailedNote(filename, 'the file is no longer there') });
290
+ return;
291
+ }
292
+ const plan = attachmentPlan(filePath, size);
293
+ if (plan.kind === 'too-large') {
294
+ await this.call('sendMessage', { chat_id: chatId, text: attachmentTooLargeNote(filename, size, plan.limit, filePath) });
295
+ return;
296
+ }
297
+ if (plan.kind === 'photo') {
298
+ try {
299
+ await this.upload('sendPhoto', { chat_id: chatId }, 'photo', filePath, filename);
300
+ return;
301
+ }
302
+ catch (err) {
303
+ // Telegram refuses some images as photos (dimensions, ratio): send the file as is.
304
+ this.log.log(`[wherever] telegram: sendPhoto refused ${filename} (${errMessage(err)}); sending it as a document`);
305
+ }
306
+ }
307
+ try {
308
+ await this.upload('sendDocument', { chat_id: chatId }, 'document', filePath, filename);
309
+ }
310
+ catch (err) {
311
+ this.log.warn(`[wherever] telegram: sending ${filename} failed: ${errMessage(err)}`);
312
+ await this.call('sendMessage', { chat_id: chatId, text: attachmentFailedNote(filename, errMessage(err)) });
313
+ }
314
+ }
315
+ async clearDraft(chatId, stream) {
316
+ if (stream?.mode !== 'draft' || stream.draftId === undefined)
317
+ return;
318
+ try {
319
+ await this.call('sendMessageDraft', { chat_id: chatId, draft_id: stream.draftId, text: '' });
320
+ }
321
+ catch {
322
+ // An empty draft only hides the preview; nothing to do on failure.
323
+ }
324
+ }
325
+ }
326
+ function errMessage(err) {
327
+ return err instanceof Error ? err.message : String(err);
328
+ }
329
+ //# sourceMappingURL=telegram-replies.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telegram-replies.js","sourceRoot":"","sources":["../src/telegram-replies.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,55 @@
1
+ /**
2
+ * The assistant's Telegram BOT TOKEN: resolved in ADR 0007's shape, failing per
3
+ * ADR 0018 (an optional channel's unreadable secret disables THAT channel, it
4
+ * never fails the server).
5
+ *
6
+ * Resolution, first non-empty wins (never argv: there is no flag):
7
+ * 1. `WHEREVER_TELEGRAM_TOKEN`, trimmed;
8
+ * 2. `WHEREVER_TELEGRAM_TOKEN_FILE`, the trimmed CONTENT of that file (the
9
+ * sops-nix / systemd `LoadCredential=` shape);
10
+ * 3. `assistantTelegram.token` in `config.json` (the config dir may be a
11
+ * `0400` secret file, ADR 0006).
12
+ *
13
+ * Decision (recorded in work/notes/observations/telegram-token-and-pairing-decisions.md):
14
+ * a set token file that cannot be read, or is empty, is an ERROR that disables
15
+ * Telegram; it does NOT fall through to the config value. ADR 0007's reasoning
16
+ * for its own token file holds here too: the operator asked for the file, so a
17
+ * file that did not arrive is a failed secret render to report, not a cue to
18
+ * quietly use an older value from the config.
19
+ *
20
+ * Both variables are captured and DELETED from `process.env` at startup
21
+ * (`takeTelegramTokenEnv`, beside the auth-token scrub in `parseArgs`), whether
22
+ * or not Telegram is enabled: the agent's `bash` inherits the server's
23
+ * environment. The FILE is read only by `resolveTelegramToken`, which the
24
+ * server calls only while the assistant is active AND Telegram is enabled.
25
+ */
26
+ export declare const TELEGRAM_TOKEN_ENV = "WHEREVER_TELEGRAM_TOKEN";
27
+ export declare const TELEGRAM_TOKEN_FILE_ENV = "WHEREVER_TELEGRAM_TOKEN_FILE";
28
+ export declare const TELEGRAM_TOKEN_CONFIG_KEY = "assistantTelegram.token";
29
+ /** The two environment variables as captured at startup (before the scrub). */
30
+ export interface TelegramTokenEnv {
31
+ token?: string;
32
+ tokenFile?: string;
33
+ }
34
+ /** Capture both variables, then delete them from `env` (the scrub). */
35
+ export declare function takeTelegramTokenEnv(env?: Record<string, string | undefined>): TelegramTokenEnv;
36
+ export type TelegramTokenResult = {
37
+ ok: true;
38
+ token: string;
39
+ source: string;
40
+ warnings: string[];
41
+ } | {
42
+ ok: false;
43
+ error: string;
44
+ warnings: string[];
45
+ };
46
+ export interface ResolveTelegramTokenInput {
47
+ env: TelegramTokenEnv;
48
+ configToken?: unknown;
49
+ /** Reads a file as UTF-8 (throws when it cannot). */
50
+ readFile: (path: string) => string;
51
+ homedir?: string;
52
+ }
53
+ /** Pure resolution (the file read is injected). Never logs: the caller does. */
54
+ export declare function resolveTelegramToken(input: ResolveTelegramTokenInput): TelegramTokenResult;
55
+ //# sourceMappingURL=telegram-token.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telegram-token.d.ts","sourceRoot":"","sources":["../src/telegram-token.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,uBAAuB,iCAAiC,CAAC;AACtE,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,gBAAgB,CAK5G;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAC/D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAErD,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,gBAAgB,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qDAAqD;IACrD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,mBAAmB,CAwC1F"}
@@ -0,0 +1,86 @@
1
+ import os from 'node:os';
2
+ import path from 'node:path';
3
+ /**
4
+ * The assistant's Telegram BOT TOKEN: resolved in ADR 0007's shape, failing per
5
+ * ADR 0018 (an optional channel's unreadable secret disables THAT channel, it
6
+ * never fails the server).
7
+ *
8
+ * Resolution, first non-empty wins (never argv: there is no flag):
9
+ * 1. `WHEREVER_TELEGRAM_TOKEN`, trimmed;
10
+ * 2. `WHEREVER_TELEGRAM_TOKEN_FILE`, the trimmed CONTENT of that file (the
11
+ * sops-nix / systemd `LoadCredential=` shape);
12
+ * 3. `assistantTelegram.token` in `config.json` (the config dir may be a
13
+ * `0400` secret file, ADR 0006).
14
+ *
15
+ * Decision (recorded in work/notes/observations/telegram-token-and-pairing-decisions.md):
16
+ * a set token file that cannot be read, or is empty, is an ERROR that disables
17
+ * Telegram; it does NOT fall through to the config value. ADR 0007's reasoning
18
+ * for its own token file holds here too: the operator asked for the file, so a
19
+ * file that did not arrive is a failed secret render to report, not a cue to
20
+ * quietly use an older value from the config.
21
+ *
22
+ * Both variables are captured and DELETED from `process.env` at startup
23
+ * (`takeTelegramTokenEnv`, beside the auth-token scrub in `parseArgs`), whether
24
+ * or not Telegram is enabled: the agent's `bash` inherits the server's
25
+ * environment. The FILE is read only by `resolveTelegramToken`, which the
26
+ * server calls only while the assistant is active AND Telegram is enabled.
27
+ */
28
+ export const TELEGRAM_TOKEN_ENV = 'WHEREVER_TELEGRAM_TOKEN';
29
+ export const TELEGRAM_TOKEN_FILE_ENV = 'WHEREVER_TELEGRAM_TOKEN_FILE';
30
+ export const TELEGRAM_TOKEN_CONFIG_KEY = 'assistantTelegram.token';
31
+ /** Capture both variables, then delete them from `env` (the scrub). */
32
+ export function takeTelegramTokenEnv(env = process.env) {
33
+ const taken = { token: env[TELEGRAM_TOKEN_ENV], tokenFile: env[TELEGRAM_TOKEN_FILE_ENV] };
34
+ delete env[TELEGRAM_TOKEN_ENV];
35
+ delete env[TELEGRAM_TOKEN_FILE_ENV];
36
+ return taken;
37
+ }
38
+ /** Pure resolution (the file read is injected). Never logs: the caller does. */
39
+ export function resolveTelegramToken(input) {
40
+ const warnings = [];
41
+ const blank = (name, v) => {
42
+ if (v !== undefined && v.length > 0 && v.trim().length === 0) {
43
+ warnings.push(`${name} is set but contains only whitespace; treating it as NOT SET (a secret meant to be rendered here did not arrive)`);
44
+ }
45
+ };
46
+ const envToken = input.env.token;
47
+ if (envToken && envToken.trim())
48
+ return { ok: true, token: envToken.trim(), source: TELEGRAM_TOKEN_ENV, warnings };
49
+ blank(TELEGRAM_TOKEN_ENV, envToken);
50
+ const file = input.env.tokenFile;
51
+ if (file && file.trim()) {
52
+ const p = expandTilde(file.trim(), input.homedir ?? os.homedir());
53
+ let contents;
54
+ try {
55
+ contents = input.readFile(p);
56
+ }
57
+ catch (err) {
58
+ return {
59
+ ok: false,
60
+ error: `${TELEGRAM_TOKEN_FILE_ENV} is set to ${p} but it could not be read (${err instanceof Error ? err.message : String(err)})`,
61
+ warnings,
62
+ };
63
+ }
64
+ const trimmed = contents.trim();
65
+ if (!trimmed)
66
+ return { ok: false, error: `${TELEGRAM_TOKEN_FILE_ENV} (${p}) is empty`, warnings };
67
+ return { ok: true, token: trimmed, source: `${TELEGRAM_TOKEN_FILE_ENV} (${p})`, warnings };
68
+ }
69
+ blank(TELEGRAM_TOKEN_FILE_ENV, file);
70
+ if (typeof input.configToken === 'string' && input.configToken.trim()) {
71
+ return { ok: true, token: input.configToken.trim(), source: TELEGRAM_TOKEN_CONFIG_KEY, warnings };
72
+ }
73
+ return {
74
+ ok: false,
75
+ error: `no bot token: set ${TELEGRAM_TOKEN_ENV}, ${TELEGRAM_TOKEN_FILE_ENV} or ${TELEGRAM_TOKEN_CONFIG_KEY}`,
76
+ warnings,
77
+ };
78
+ }
79
+ function expandTilde(p, home) {
80
+ if (p === '~')
81
+ return home;
82
+ if (p.startsWith('~/'))
83
+ return path.join(home, p.slice(2));
84
+ return p;
85
+ }
86
+ //# sourceMappingURL=telegram-token.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"telegram-token.js","sourceRoot":"","sources":["../src/telegram-token.ts"],"names":[],"mappings":"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"}