wherever-dev 0.21.0 → 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.
- package/CHANGELOG.md +26 -0
- package/dist/assistant-channels.d.ts +242 -0
- package/dist/assistant-channels.d.ts.map +1 -0
- package/dist/assistant-channels.js +270 -0
- package/dist/assistant-channels.js.map +1 -0
- package/dist/assistant-controller.d.ts +228 -0
- package/dist/assistant-controller.d.ts.map +1 -0
- package/dist/assistant-controller.js +314 -0
- package/dist/assistant-controller.js.map +1 -0
- package/dist/assistant-cron.d.ts +87 -0
- package/dist/assistant-cron.d.ts.map +1 -0
- package/dist/assistant-cron.js +352 -0
- package/dist/assistant-cron.js.map +1 -0
- package/dist/assistant-folder.d.ts +161 -0
- package/dist/assistant-folder.d.ts.map +1 -0
- package/dist/assistant-folder.js +333 -0
- package/dist/assistant-folder.js.map +1 -0
- package/dist/assistant-schedule.d.ts +236 -0
- package/dist/assistant-schedule.d.ts.map +1 -0
- package/dist/assistant-schedule.js +454 -0
- package/dist/assistant-schedule.js.map +1 -0
- package/dist/assistant-scheduler.d.ts +210 -0
- package/dist/assistant-scheduler.d.ts.map +1 -0
- package/dist/assistant-scheduler.js +472 -0
- package/dist/assistant-scheduler.js.map +1 -0
- package/dist/assistant-tool-text.d.ts +40 -0
- package/dist/assistant-tool-text.d.ts.map +1 -0
- package/dist/assistant-tool-text.js +102 -0
- package/dist/assistant-tool-text.js.map +1 -0
- package/dist/assistant-tools.d.ts +207 -0
- package/dist/assistant-tools.d.ts.map +1 -0
- package/dist/assistant-tools.js +390 -0
- package/dist/assistant-tools.js.map +1 -0
- package/dist/attach-file-tool.d.ts +20 -1
- package/dist/attach-file-tool.d.ts.map +1 -1
- package/dist/attach-file-tool.js +45 -3
- package/dist/attach-file-tool.js.map +1 -1
- package/dist/cli-requests.d.ts +90 -0
- package/dist/cli-requests.d.ts.map +1 -0
- package/dist/cli-requests.js +75 -0
- package/dist/cli-requests.js.map +1 -0
- package/dist/download-grants.d.ts +12 -0
- package/dist/download-grants.d.ts.map +1 -0
- package/dist/download-grants.js +76 -0
- package/dist/download-grants.js.map +1 -0
- package/dist/index.js +431 -20
- package/dist/index.js.map +1 -1
- package/dist/protocol.d.ts +43 -0
- package/dist/protocol.d.ts.map +1 -1
- package/dist/reply-routing.d.ts +106 -0
- package/dist/reply-routing.d.ts.map +1 -0
- package/dist/reply-routing.js +174 -0
- package/dist/reply-routing.js.map +1 -0
- package/dist/session-pool.d.ts +243 -4
- package/dist/session-pool.d.ts.map +1 -1
- package/dist/session-pool.js +464 -100
- package/dist/session-pool.js.map +1 -1
- package/dist/telegram-channel.d.ts +272 -0
- package/dist/telegram-channel.d.ts.map +1 -0
- package/dist/telegram-channel.js +701 -0
- package/dist/telegram-channel.js.map +1 -0
- package/dist/telegram-files.d.ts +101 -0
- package/dist/telegram-files.d.ts.map +1 -0
- package/dist/telegram-files.js +145 -0
- package/dist/telegram-files.js.map +1 -0
- package/dist/telegram-pairing.d.ts +119 -0
- package/dist/telegram-pairing.d.ts.map +1 -0
- package/dist/telegram-pairing.js +97 -0
- package/dist/telegram-pairing.js.map +1 -0
- package/dist/telegram-replies.d.ts +94 -0
- package/dist/telegram-replies.d.ts.map +1 -0
- package/dist/telegram-replies.js +329 -0
- package/dist/telegram-replies.js.map +1 -0
- package/dist/telegram-token.d.ts +55 -0
- package/dist/telegram-token.d.ts.map +1 -0
- package/dist/telegram-token.js +86 -0
- package/dist/telegram-token.js.map +1 -0
- package/dist/web-push.d.ts +167 -0
- package/dist/web-push.d.ts.map +1 -0
- package/dist/web-push.js +387 -0
- package/dist/web-push.js.map +1 -0
- package/package.json +1 -1
- package/public/_app/immutable/assets/0.BkzT3rFr.css +1 -0
- package/public/_app/immutable/chunks/CExVgK9Z.js +2 -0
- package/public/_app/immutable/chunks/CExVgK9Z.js.map +1 -0
- package/public/_app/immutable/chunks/CkOw6fRa.js +2 -0
- package/public/_app/immutable/chunks/{idnZrCTB.js.map → CkOw6fRa.js.map} +1 -1
- package/public/_app/immutable/chunks/DyHllYtq.js +2 -0
- package/public/_app/immutable/chunks/{DJMI34rR.js.map → DyHllYtq.js.map} +1 -1
- package/public/_app/immutable/entry/{app.CF_gzWKW.js → app.D3PEFbtP.js} +3 -3
- package/public/_app/immutable/entry/{app.CF_gzWKW.js.map → app.D3PEFbtP.js.map} +1 -1
- package/public/_app/immutable/entry/start.BR00Qps5.js +2 -0
- package/public/_app/immutable/entry/start.BR00Qps5.js.map +1 -0
- package/public/_app/immutable/nodes/{0.CIIhZFWl.js → 0.DG3L8hMN.js} +3 -3
- package/public/_app/immutable/nodes/{0.CIIhZFWl.js.map → 0.DG3L8hMN.js.map} +1 -1
- package/public/_app/immutable/nodes/{1.D4WVeMej.js → 1.BCpuoZxW.js} +2 -2
- package/public/_app/immutable/nodes/{1.D4WVeMej.js.map → 1.BCpuoZxW.js.map} +1 -1
- package/public/_app/immutable/nodes/2.D2auiZW1.js +122 -0
- package/public/_app/immutable/nodes/2.D2auiZW1.js.map +1 -0
- package/public/_app/version.json +1 -1
- package/public/index.html +11 -11
- package/public/service-worker.js +1 -1
- package/public/_app/immutable/assets/0.BKJ49K71.css +0 -1
- package/public/_app/immutable/chunks/CkzyFwPn.js +0 -2
- package/public/_app/immutable/chunks/CkzyFwPn.js.map +0 -1
- package/public/_app/immutable/chunks/DJMI34rR.js +0 -2
- package/public/_app/immutable/chunks/idnZrCTB.js +0 -2
- package/public/_app/immutable/entry/start.GpPJ13Gr.js +0 -2
- package/public/_app/immutable/entry/start.GpPJ13Gr.js.map +0 -1
- package/public/_app/immutable/nodes/2._KcrsFWH.js +0 -120
- package/public/_app/immutable/nodes/2._KcrsFWH.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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"}
|