wherever-dev 0.21.1 → 0.22.1

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 +28 -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 +222 -0
  31. package/dist/assistant-tools.d.ts.map +1 -0
  32. package/dist/assistant-tools.js +411 -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 +427 -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 +235 -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 +275 -0
  51. package/dist/telegram-channel.d.ts.map +1 -0
  52. package/dist/telegram-channel.js +702 -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 +140 -0
  63. package/dist/telegram-replies.d.ts.map +1 -0
  64. package/dist/telegram-replies.js +474 -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.hWfYEET-.css +1 -0
  76. package/public/_app/immutable/chunks/Cuh9gHb6.js +2 -0
  77. package/public/_app/immutable/chunks/Cuh9gHb6.js.map +1 -0
  78. package/public/_app/immutable/chunks/DEUwJYqt.js +2 -0
  79. package/public/_app/immutable/chunks/{BQ9B_G4h.js.map → DEUwJYqt.js.map} +1 -1
  80. package/public/_app/immutable/chunks/DSPDB3Gw.js +2 -0
  81. package/public/_app/immutable/chunks/{BUONgvl4.js.map → DSPDB3Gw.js.map} +1 -1
  82. package/public/_app/immutable/entry/{app.BZO7Xckk.js → app.BkV4f8p8.js} +3 -3
  83. package/public/_app/immutable/entry/{app.BZO7Xckk.js.map → app.BkV4f8p8.js.map} +1 -1
  84. package/public/_app/immutable/entry/start.D5TsAoxn.js +2 -0
  85. package/public/_app/immutable/entry/start.D5TsAoxn.js.map +1 -0
  86. package/public/_app/immutable/nodes/{0.Czz2XmZU.js → 0.DR4K9Ylw.js} +3 -3
  87. package/public/_app/immutable/nodes/{0.Czz2XmZU.js.map → 0.DR4K9Ylw.js.map} +1 -1
  88. package/public/_app/immutable/nodes/{1.DDvrriUW.js → 1.DdqkeKC4.js} +2 -2
  89. package/public/_app/immutable/nodes/{1.DDvrriUW.js.map → 1.DdqkeKC4.js.map} +1 -1
  90. package/public/_app/immutable/nodes/2.n5lfdeec.js +122 -0
  91. package/public/_app/immutable/nodes/2.n5lfdeec.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,352 @@
1
+ /**
2
+ * Time arithmetic for the assistant scheduler (spec `assistant-session-and-channels`,
3
+ * ADR 0015): a minimal 5-field cron parser, next/previous occurrence in an IANA
4
+ * timezone, and the `at` (one-shot) parser. Pure: no clock, no timers, no I/O.
5
+ *
6
+ * WHY a hand-written parser, not a cron library (decision, recorded here): a
7
+ * new runtime dependency changes `pnpm-lock.yaml` and therefore the Nix
8
+ * `pnpmDepsHash` every consumer build checks (ADR 0008), for ~200 lines of
9
+ * well-understood code. And the timezone semantics the scheduler needs are its
10
+ * own anyway: the zone is supplied per evaluation (a follows-the-user job is
11
+ * re-evaluated in the user's CURRENT zone, which changes when they travel), and
12
+ * the DST rules below are chosen so the local-to-instant mapping is MONOTONE,
13
+ * which is what lets the search stop at the first candidate. Alternatives
14
+ * considered: `croner` (zero-dep, timezone-aware, maintained) and `cron-parser`
15
+ * (pulls in luxon). Revisit if the syntax ever needs more than the 5 fields.
16
+ *
17
+ * Syntax: `minute hour day-of-month month day-of-week`, each field a comma list
18
+ * of `*`, `n`, `a-b`, optionally with `/step` (`*\/15`, `1-30/2`, `5/10`).
19
+ * Months and weekdays accept three-letter English names; weekday 0 and 7 are
20
+ * Sunday. Macros: `@yearly` / `@annually`, `@monthly`, `@weekly`, `@daily` /
21
+ * `@midnight`, `@hourly`. Day-of-month and day-of-week follow Vixie cron: when
22
+ * BOTH are restricted (neither starts with `*`) a day matches if EITHER does,
23
+ * otherwise both must match.
24
+ *
25
+ * DST (decision): a local time that does not exist (the spring-forward gap)
26
+ * fires at the instant the gap ends, once; a local time that occurs twice (the
27
+ * fall-back overlap) fires at its FIRST occurrence only. So "30 2 * * *" still
28
+ * runs on the spring-forward day (at 03:00 local), and nothing runs twice on the
29
+ * fall-back day. The cost: a sub-hourly job does not repeat during the repeated
30
+ * hour. Alternative: Temporal's "compatible" (shift a gap time forward by the
31
+ * gap length), rejected because it is not monotone (02:30 would map AFTER 03:00).
32
+ */
33
+ export class CronParseError extends Error {
34
+ constructor(message) {
35
+ super(message);
36
+ this.name = 'CronParseError';
37
+ }
38
+ }
39
+ const MACROS = {
40
+ '@yearly': '0 0 1 1 *',
41
+ '@annually': '0 0 1 1 *',
42
+ '@monthly': '0 0 1 * *',
43
+ '@weekly': '0 0 * * 0',
44
+ '@daily': '0 0 * * *',
45
+ '@midnight': '0 0 * * *',
46
+ '@hourly': '0 * * * *',
47
+ };
48
+ const MONTH_NAMES = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec'];
49
+ const DOW_NAMES = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
50
+ const FIELDS = [
51
+ { name: 'minute', min: 0, max: 59 },
52
+ { name: 'hour', min: 0, max: 23 },
53
+ { name: 'day-of-month', min: 1, max: 31 },
54
+ { name: 'month', min: 1, max: 12, names: MONTH_NAMES, namesBase: 1 },
55
+ { name: 'day-of-week', min: 0, max: 7, names: DOW_NAMES, namesBase: 0 },
56
+ ];
57
+ function parseValue(raw, def) {
58
+ const lower = raw.toLowerCase();
59
+ if (def.names) {
60
+ const i = def.names.indexOf(lower);
61
+ if (i >= 0)
62
+ return i + (def.namesBase ?? 0);
63
+ }
64
+ if (!/^\d+$/.test(raw))
65
+ throw new CronParseError(`${def.name}: "${raw}" is not a number`);
66
+ const n = Number(raw);
67
+ if (n < def.min || n > def.max)
68
+ throw new CronParseError(`${def.name}: ${n} is outside ${def.min}-${def.max}`);
69
+ return n;
70
+ }
71
+ function parseField(field, def) {
72
+ const out = new Array(def.max + 1).fill(false);
73
+ if (field === '')
74
+ throw new CronParseError(`${def.name}: empty field`);
75
+ for (const part of field.split(',')) {
76
+ const [rangePart, stepPart, extra] = part.split('/');
77
+ if (extra !== undefined)
78
+ throw new CronParseError(`${def.name}: "${part}" has more than one "/"`);
79
+ let step = 1;
80
+ if (stepPart !== undefined) {
81
+ if (!/^\d+$/.test(stepPart) || Number(stepPart) < 1)
82
+ throw new CronParseError(`${def.name}: bad step "${stepPart}"`);
83
+ step = Number(stepPart);
84
+ }
85
+ let lo;
86
+ let hi;
87
+ if (rangePart === '*') {
88
+ lo = def.min;
89
+ hi = def.max;
90
+ }
91
+ else if (rangePart.includes('-')) {
92
+ const [a, b, more] = rangePart.split('-');
93
+ if (more !== undefined)
94
+ throw new CronParseError(`${def.name}: bad range "${rangePart}"`);
95
+ lo = parseValue(a, def);
96
+ hi = parseValue(b, def);
97
+ if (lo > hi)
98
+ throw new CronParseError(`${def.name}: range "${rangePart}" runs backwards`);
99
+ }
100
+ else {
101
+ lo = parseValue(rangePart, def);
102
+ // `5/10` means from 5 to the end, every 10.
103
+ hi = stepPart !== undefined ? def.max : lo;
104
+ }
105
+ for (let v = lo; v <= hi; v += step)
106
+ out[v] = true;
107
+ }
108
+ return out;
109
+ }
110
+ /** Parse a 5-field cron expression (or a macro). Throws `CronParseError`. */
111
+ export function parseCron(expr) {
112
+ if (typeof expr !== 'string')
113
+ throw new CronParseError('cron must be a string');
114
+ const trimmed = expr.trim();
115
+ const expanded = MACROS[trimmed.toLowerCase()] ?? trimmed;
116
+ const fields = expanded.split(/\s+/);
117
+ if (fields.length !== 5)
118
+ throw new CronParseError(`expected 5 fields (minute hour day-of-month month day-of-week), got ${fields.length}`);
119
+ const [mi, h, dom, mon, dow] = fields.map((f, i) => parseField(f, FIELDS[i]));
120
+ const daysOfWeek = dow.slice(0, 7);
121
+ if (dow[7])
122
+ daysOfWeek[0] = true;
123
+ return {
124
+ source: trimmed,
125
+ minutes: mi,
126
+ hours: h,
127
+ daysOfMonth: dom,
128
+ months: mon,
129
+ daysOfWeek,
130
+ dayOr: !fields[2].startsWith('*') && !fields[4].startsWith('*'),
131
+ };
132
+ }
133
+ // ---------------------------------------------------------------------------
134
+ // Timezones
135
+ const formatters = new Map();
136
+ function formatterFor(tz) {
137
+ let f = formatters.get(tz);
138
+ if (!f) {
139
+ f = new Intl.DateTimeFormat('en-US', {
140
+ timeZone: tz,
141
+ hourCycle: 'h23',
142
+ year: 'numeric',
143
+ month: 'numeric',
144
+ day: 'numeric',
145
+ hour: 'numeric',
146
+ minute: 'numeric',
147
+ second: 'numeric',
148
+ });
149
+ formatters.set(tz, f);
150
+ }
151
+ return f;
152
+ }
153
+ /** True when `tz` is an IANA zone name this runtime knows (e.g. `Europe/Paris`, `UTC`). */
154
+ export function isValidTimeZone(tz) {
155
+ if (typeof tz !== 'string' || tz.trim() === '')
156
+ return false;
157
+ try {
158
+ formatterFor(tz);
159
+ return true;
160
+ }
161
+ catch {
162
+ return false;
163
+ }
164
+ }
165
+ /** The system timezone (what a fresh server assumes the user is in). */
166
+ export function systemTimeZone() {
167
+ try {
168
+ const tz = Intl.DateTimeFormat().resolvedOptions().timeZone;
169
+ return isValidTimeZone(tz) ? tz : 'UTC';
170
+ }
171
+ catch {
172
+ return 'UTC';
173
+ }
174
+ }
175
+ /** The wall-clock time in `tz` at instant `ms`. */
176
+ export function wallClock(tz, ms) {
177
+ const parts = formatterFor(tz).formatToParts(new Date(ms));
178
+ const get = (type) => Number(parts.find((p) => p.type === type)?.value);
179
+ return {
180
+ year: get('year'),
181
+ month: get('month'),
182
+ day: get('day'),
183
+ hour: get('hour') % 24,
184
+ minute: get('minute'),
185
+ second: get('second'),
186
+ };
187
+ }
188
+ /** UTC offset of `tz` at instant `ms`, in ms (east positive). */
189
+ function offsetAt(tz, ms) {
190
+ const w = wallClock(tz, ms);
191
+ const asUtc = Date.UTC(w.year, w.month - 1, w.day, w.hour, w.minute, w.second);
192
+ return asUtc - (ms - (((ms % 1000) + 1000) % 1000));
193
+ }
194
+ const HOUR = 3_600_000;
195
+ const DAY = 24 * HOUR;
196
+ /**
197
+ * The instant at which `tz` shows the given local time. An overlap (fall-back)
198
+ * resolves to the EARLIER instant; a gap (spring-forward) resolves to the
199
+ * instant the gap ends. See the module JSDoc.
200
+ */
201
+ export function zonedToUtc(tz, year, month, day, hour, minute, second = 0) {
202
+ const guess = Date.UTC(year, month - 1, day, hour, minute, second);
203
+ const offBefore = offsetAt(tz, guess - DAY);
204
+ const offAfter = offsetAt(tz, guess + DAY);
205
+ const candidates = [];
206
+ for (const off of offBefore === offAfter ? [offBefore] : [offBefore, offAfter]) {
207
+ const t = guess - off;
208
+ if (offsetAt(tz, t) === off)
209
+ candidates.push(t);
210
+ }
211
+ if (candidates.length > 0)
212
+ return Math.min(...candidates);
213
+ // No exact match: the local time is in a gap. Find the first instant whose
214
+ // offset is the post-transition one, between the two readings.
215
+ const lo0 = guess - Math.max(offBefore, offAfter);
216
+ const hi0 = guess - Math.min(offBefore, offAfter);
217
+ let lo = Math.min(lo0, hi0);
218
+ let hi = Math.max(lo0, hi0);
219
+ const offLo = offsetAt(tz, lo);
220
+ while (hi - lo > 1000) {
221
+ const mid = Math.floor((lo + hi) / 2000) * 1000;
222
+ if (mid <= lo || mid >= hi)
223
+ break;
224
+ if (offsetAt(tz, mid) === offLo)
225
+ lo = mid;
226
+ else
227
+ hi = mid;
228
+ }
229
+ return hi;
230
+ }
231
+ // ---------------------------------------------------------------------------
232
+ // Occurrences
233
+ /** How far the occurrence search looks before giving up ("30 2 31 2 *" never matches). */
234
+ const SEARCH_DAYS = 366 * 30;
235
+ function civilAddDays(y, m, d, n) {
236
+ const t = new Date(Date.UTC(y, m - 1, d) + n * DAY);
237
+ return [t.getUTCFullYear(), t.getUTCMonth() + 1, t.getUTCDate()];
238
+ }
239
+ function dayMatches(spec, y, m, d) {
240
+ if (!spec.months[m])
241
+ return false;
242
+ const dow = new Date(Date.UTC(y, m - 1, d)).getUTCDay();
243
+ const domOk = spec.daysOfMonth[d] === true;
244
+ const dowOk = spec.daysOfWeek[dow] === true;
245
+ return spec.dayOr ? domOk || dowOk : domOk && dowOk;
246
+ }
247
+ function hoursOf(spec) {
248
+ const out = [];
249
+ for (let h = 0; h < 24; h++)
250
+ if (spec.hours[h])
251
+ out.push(h);
252
+ return out;
253
+ }
254
+ function minutesOf(spec) {
255
+ const out = [];
256
+ for (let m = 0; m < 60; m++)
257
+ if (spec.minutes[m])
258
+ out.push(m);
259
+ return out;
260
+ }
261
+ /** The first occurrence STRICTLY after `afterMs`, evaluated in `tz`; null when none within the search horizon. */
262
+ export function nextCronRun(spec, tz, afterMs) {
263
+ const start = wallClock(tz, afterMs);
264
+ const hours = hoursOf(spec);
265
+ const minutes = minutesOf(spec);
266
+ let [y, m, d] = [start.year, start.month, start.day];
267
+ // The day before too: a gap or overlap near midnight can map a local time of
268
+ // the previous day past `afterMs`. Cheap, and the mapping is monotone.
269
+ [y, m, d] = civilAddDays(y, m, d, -1);
270
+ for (let i = 0; i <= SEARCH_DAYS; i++) {
271
+ if (dayMatches(spec, y, m, d)) {
272
+ // On the first two days, skip hours that cannot be after `afterMs` (2 h of
273
+ // slack covers any DST shift).
274
+ const minHour = i === 1 ? start.hour - 2 : i === 0 ? 22 : -1;
275
+ for (const h of hours) {
276
+ if (h < minHour)
277
+ continue;
278
+ for (const mi of minutes) {
279
+ const t = zonedToUtc(tz, y, m, d, h, mi);
280
+ if (t > afterMs)
281
+ return t;
282
+ }
283
+ }
284
+ }
285
+ [y, m, d] = civilAddDays(y, m, d, 1);
286
+ }
287
+ return null;
288
+ }
289
+ /** The last occurrence at or before `atOrBeforeMs`, evaluated in `tz`; null when none within the search horizon. */
290
+ export function prevCronRun(spec, tz, atOrBeforeMs) {
291
+ const start = wallClock(tz, atOrBeforeMs);
292
+ const hours = hoursOf(spec).reverse();
293
+ const minutes = minutesOf(spec).reverse();
294
+ let [y, m, d] = civilAddDays(start.year, start.month, start.day, 1);
295
+ for (let i = 0; i <= SEARCH_DAYS; i++) {
296
+ if (dayMatches(spec, y, m, d)) {
297
+ const maxHour = i === 1 ? start.hour + 2 : i === 0 ? 1 : 24;
298
+ for (const h of hours) {
299
+ if (h > maxHour)
300
+ continue;
301
+ for (const mi of minutes) {
302
+ const t = zonedToUtc(tz, y, m, d, h, mi);
303
+ if (t <= atOrBeforeMs)
304
+ return t;
305
+ }
306
+ }
307
+ }
308
+ [y, m, d] = civilAddDays(y, m, d, -1);
309
+ }
310
+ return null;
311
+ }
312
+ // ---------------------------------------------------------------------------
313
+ // `at`
314
+ const AT_RE = /^(\d{4})-(\d{2})-(\d{2})[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,9}))?)?(Z|[+-]\d{2}(?::?\d{2})?)?$/i;
315
+ /** Parse an ISO 8601 date-time (`at`). Null when malformed. `"now"` is NOT handled here. */
316
+ export function parseAtString(at) {
317
+ const m = AT_RE.exec(at.trim());
318
+ if (!m)
319
+ return null;
320
+ const [year, month, day, hour, minute] = [1, 2, 3, 4, 5].map((i) => Number(m[i]));
321
+ const second = m[6] ? Number(m[6]) : 0;
322
+ const millisecond = m[7] ? Number(m[7].slice(0, 3).padEnd(3, '0')) : 0;
323
+ if (month < 1 || month > 12 || hour > 23 || minute > 59 || second > 59)
324
+ return null;
325
+ const daysInMonth = new Date(Date.UTC(year, month, 0)).getUTCDate();
326
+ if (day < 1 || day > daysInMonth)
327
+ return null;
328
+ let offsetMs = null;
329
+ const z = m[8];
330
+ if (z) {
331
+ if (z.toUpperCase() === 'Z')
332
+ offsetMs = 0;
333
+ else {
334
+ const sign = z[0] === '-' ? -1 : 1;
335
+ const digits = z.slice(1).replace(':', '');
336
+ const oh = Number(digits.slice(0, 2));
337
+ const om = digits.length > 2 ? Number(digits.slice(2, 4)) : 0;
338
+ if (oh > 23 || om > 59)
339
+ return null;
340
+ offsetMs = sign * (oh * HOUR + om * 60_000);
341
+ }
342
+ }
343
+ return { year, month, day, hour, minute, second, millisecond, offsetMs };
344
+ }
345
+ /** The instant an `at` names: its own offset when it carries one, else read as local time in `tz`. */
346
+ export function atToInstant(at, tz) {
347
+ if (at.offsetMs !== null) {
348
+ return Date.UTC(at.year, at.month - 1, at.day, at.hour, at.minute, at.second, at.millisecond) - at.offsetMs;
349
+ }
350
+ return zonedToUtc(tz, at.year, at.month, at.day, at.hour, at.minute, at.second) + at.millisecond;
351
+ }
352
+ //# sourceMappingURL=assistant-cron.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assistant-cron.js","sourceRoot":"","sources":["../src/assistant-cron.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,161 @@
1
+ /**
2
+ * The assistant FOLDER: the home and memory of the long-lived, resettable
3
+ * general-assistant session (spec `assistant-session-and-channels`, ADRs 0014 to
4
+ * 0018). This module is the opt-in foundation only: resolving `assistantFolder`
5
+ * from the config, seeding the folder once, taking the folder lock, and the
6
+ * status payload the web reads from `GET /config`. Later tasks (pointer,
7
+ * scheduler, tools, channels) gate on `AssistantStatus.active`.
8
+ *
9
+ * Opt-in: `assistantFolder` has NO default. Unset (or blank) means the feature is
10
+ * entirely off: nothing is created, locked or written, and the status says
11
+ * "not configured".
12
+ *
13
+ * Restart-only: the folder is resolved, seeded and locked ONCE, at server start
14
+ * (`startAssistantFolder`), and the resulting status is a snapshot. Editing
15
+ * `assistantFolder` in config.json takes effect on the next restart; nothing here
16
+ * re-reads the config at runtime, so a running server never "moves" its
17
+ * assistant (and its lock) under a live session.
18
+ */
19
+ /** Minimal config slice this module reads (a subset of `WhereverConfig`). */
20
+ export interface AssistantFolderConfig {
21
+ /** Folder the assistant lives in. No default; unset = feature off. Tilde (~) is expanded. */
22
+ assistantFolder?: string;
23
+ }
24
+ /** Lock file name, inside the assistant folder (ADR 0018: NOT in the state dir). */
25
+ export declare const ASSISTANT_LOCK_FILE = ".assistant.lock";
26
+ export declare const ASSISTANT_AGENTS_MD = "# Assistant\n\nYou are a long-lived general assistant. This folder is your home and your memory.\n\n## Memory\n\nThis session may be reset at any time, and a fresh session remembers nothing of this one. So save anything worth keeping into files here AS YOU GO, not at the end: `memory/` (one file per topic), `profile.md` (who the user is, their preferences), and whatever else helps. At the start of a fresh session, read them before answering.\n\n## Time\n\nUse the `assistant_schedule_*` tools for anything time-based (reminders, recurring briefings, \"check X later\"). Leave `tz` unset so the job follows the user wherever they are; set `tz` only for things pinned to a place (\"6pm her time\"). When the user tells you where they are, call `assistant_set_timezone`.\n\n## Delegate\n\nDo not block the conversation on long or slow work. DELEGATE it to an isolated job (`at: \"now\"`) that notifies the user when it is done. Anything possibly urgent must be an isolated job too, so it never waits behind a conversation.\n\n## Talking to the user\n\nThe user hears from you ONLY through your replies and `assistant_notify`. A turn that starts with `[schedule:...]` is a scheduled job, not the user talking: if the user should hear about its outcome, call `assistant_notify`.\n\nIf a `recall_search` tool is available, use it to find what was said in earlier sessions rather than asking the user to repeat themselves.\n";
27
+ export declare const ASSISTANT_JOBS_AGENTS_MD = "# Assistant job\n\nYou are an isolated job run by the assistant. Do the task you were given. Save anything worth keeping under `../memory/`. If the user should know the result, call `assistant_notify`. Do not start conversations: nobody is reading this session.\n";
28
+ export declare const ASSISTANT_GITIGNORE = "# Runtime lock held by the wherever server using this folder.\n.assistant.lock\n";
29
+ /**
30
+ * The configured assistant folder, tilde-expanded and absolute, or null when the
31
+ * feature is off (unset, empty or whitespace).
32
+ */
33
+ export declare function resolveAssistantFolder(config: AssistantFolderConfig): string | null;
34
+ /**
35
+ * Create the folder if missing and drop each seed file that does not exist yet.
36
+ * NEVER overwrites: the folder is the user's (and the agent's) to edit. Throws on
37
+ * a real I/O failure (e.g. an unwritable parent); callers decide how loud to be.
38
+ * Returns the seed files it actually wrote.
39
+ */
40
+ export declare function seedAssistantFolder(folder: string): string[];
41
+ /**
42
+ * The `createNewSession` hook, beside `maybeSeedSearchWorkspace`: if `resolvedCwd`
43
+ * IS the assistant folder, re-seed any missing file (self-healing when the user
44
+ * deleted one). `assistantFolder` is the server's START-TIME assistant folder,
45
+ * and only when this server holds the lock (undefined otherwise), so session
46
+ * creation is unchanged with the feature off and a refused server never writes
47
+ * into a folder another server owns. Best-effort: never throws.
48
+ */
49
+ export declare function maybeSeedAssistantSession(resolvedCwd: string, assistantFolder: string | undefined): void;
50
+ /**
51
+ * Who a process is, precisely enough to tell a live lock from a stale one.
52
+ * `bootId` and `startTime` are null where the platform cannot tell us (anything
53
+ * but Linux and darwin); the decision then degrades to pid-only.
54
+ */
55
+ export interface ProcessIdentity {
56
+ pid: number;
57
+ host: string;
58
+ /** Linux: /proc/sys/kernel/random/boot_id. darwin: `sysctl kern.boottime`. */
59
+ bootId: string | null;
60
+ /** Linux: /proc/<pid>/stat starttime (ticks since boot). darwin: `ps -o lstart=`. */
61
+ startTime: string | null;
62
+ }
63
+ /** On-disk shape of `<assistantFolder>/.assistant.lock`. */
64
+ export type AssistantLockRecord = ProcessIdentity & {
65
+ acquiredAt?: string;
66
+ };
67
+ /** What the probes found about the pid named in an existing lock. */
68
+ export interface PidProbe {
69
+ alive: boolean;
70
+ /** Start time of whatever process holds that pid NOW (null if dead or unknown). */
71
+ startTime: string | null;
72
+ }
73
+ export type LockDecision = {
74
+ action: 'take';
75
+ reason: 'free' | 'own';
76
+ } | {
77
+ action: 'takeover';
78
+ reason: 'dead-pid' | 'pid-reused' | 'other-boot' | 'corrupt';
79
+ } | {
80
+ action: 'refuse';
81
+ reason: 'live-lock' | 'foreign-host';
82
+ };
83
+ /**
84
+ * The PURE lock decision. `existing` is the parsed lock (null = no lock file,
85
+ * 'corrupt' = present but unparseable). `probe` describes `existing.pid` as seen
86
+ * from THIS host (ignored for a foreign host).
87
+ *
88
+ * - Another HOST: never taken over. We cannot see its processes, and a shared
89
+ * (synced / network) folder is exactly where two servers collide; the human
90
+ * removes the file by hand.
91
+ * - Same host, stale when ANY of: the boot id differs (both known), the pid is
92
+ * dead, or the pid is alive but its start time differs (both known: the pid was
93
+ * reused by an unrelated process). Otherwise it is live and refused.
94
+ * - A corrupt file is taken over: a crash mid-write is the likeliest cause, and
95
+ * refusing would wedge the assistant behind a file nobody can attribute.
96
+ */
97
+ export declare function decideAssistantLock(existing: AssistantLockRecord | null | 'corrupt', self: ProcessIdentity, probe: PidProbe): LockDecision;
98
+ /** The current boot's id, or null where unsupported. Never throws. */
99
+ export declare function readBootId(): string | null;
100
+ /** Start time of `pid`, or null if it is not running or the platform cannot say. Never throws. */
101
+ export declare function readProcessStartTime(pid: number): string | null;
102
+ /** Whether `pid` exists (EPERM means it does, owned by someone else). */
103
+ export declare function isPidAlive(pid: number): boolean;
104
+ export declare function currentProcessIdentity(): ProcessIdentity;
105
+ export type AssistantLockState = {
106
+ state: 'held';
107
+ } | {
108
+ state: 'refused';
109
+ reason: 'live-lock' | 'foreign-host';
110
+ holder: {
111
+ pid: number;
112
+ host: string;
113
+ };
114
+ message: string;
115
+ } | {
116
+ state: 'error';
117
+ message: string;
118
+ };
119
+ /**
120
+ * Take `<folder>/.assistant.lock` for this process, or report why not. The
121
+ * folder must exist. Creation is exclusive (`wx`), so two servers starting at
122
+ * the same instant cannot both win; a stale lock is unlinked and the exclusive
123
+ * create retried (a bounded loop, in case a third process slips in between).
124
+ * Logs a clear line for every refusal and takeover. Never throws.
125
+ */
126
+ export declare function acquireAssistantLock(folder: string): AssistantLockState;
127
+ /**
128
+ * Remove the lock iff it is still THIS process's (same pid and start time).
129
+ * Synchronous so it is safe from a `process.on('exit')` handler. Never throws.
130
+ */
131
+ export declare function releaseAssistantLock(folder: string): void;
132
+ /**
133
+ * The assistant status exposed to the web in `GET /config` (`assistant`), beside
134
+ * `searchFolder`. Later tasks ADD fields (current session id, Web Push, Telegram,
135
+ * timezone); keep these stable.
136
+ *
137
+ * - `configured`: `assistantFolder` is set.
138
+ * - `folder`: the resolved folder, or null.
139
+ * - `active`: configured AND this server holds the lock. Everything the
140
+ * assistant does (pointer, scheduler, channels, tools) gates on this.
141
+ * - `lock`: null when not configured.
142
+ */
143
+ export interface AssistantStatus {
144
+ configured: boolean;
145
+ folder: string | null;
146
+ active: boolean;
147
+ lock: AssistantLockState | null;
148
+ }
149
+ export interface AssistantFolderHandle {
150
+ status: AssistantStatus;
151
+ /** Release the folder lock if held. Idempotent, synchronous. */
152
+ release(): void;
153
+ }
154
+ /**
155
+ * Server-start entry point: resolve, create, lock, seed. Order matters: the
156
+ * folder is created first (the lock lives in it), then locked, and ONLY a server
157
+ * that holds the lock seeds it, so a refused server writes nothing beyond the
158
+ * mkdir of a folder that already had a lock in it.
159
+ */
160
+ export declare function startAssistantFolder(config: AssistantFolderConfig): AssistantFolderHandle;
161
+ //# sourceMappingURL=assistant-folder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"assistant-folder.d.ts","sourceRoot":"","sources":["../src/assistant-folder.ts"],"names":[],"mappings":"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"}