@cotal-ai/connector-core 0.163.3 → 0.163.5

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.
@@ -28,22 +28,11 @@
28
28
  */
29
29
  import { randomUUID } from "node:crypto";
30
30
  import { constants } from "node:fs";
31
- import { lstat, open, readdir, rename, unlink } from "node:fs/promises";
32
- import { dirname, join } from "node:path";
31
+ import { lstat, open, rename, unlink } from "node:fs/promises";
32
+ import { dirname } from "node:path";
33
+ import { EVENT_SUBJECT_RECORD_VERSION, SubjectFrontierCorruptError, readEventSubjectRecord, recoverEventSubjectTip, recordedEventTip, } from "@cotal-ai/core";
34
+ export { SubjectFrontierCorruptError } from "@cotal-ai/core";
33
35
  import { fsyncDir } from "./agui-wal-path.js";
34
- /** The document on disk. Versioned, because a shape change must be refused rather than misread. */
35
- const SUBJECT_FRONTIER_VERSION = 1;
36
- /** Every refusal is one of these, so a caller never mistakes it for an I/O blip. */
37
- export class SubjectFrontierCorruptError extends Error {
38
- path;
39
- invariant;
40
- constructor(path, invariant, detail) {
41
- super(`subject frontier ${path}: expected ${invariant} — ${detail}`);
42
- this.path = path;
43
- this.invariant = invariant;
44
- this.name = "SubjectFrontierCorruptError";
45
- }
46
- }
47
36
  /**
48
37
  * The record on disk is not the one this view was opened from, so this writer's number is not the
49
38
  * one to write.
@@ -84,48 +73,6 @@ export class FileSubjectFrontier {
84
73
  get tip() {
85
74
  return this.doc.tip;
86
75
  }
87
- /**
88
- * Read the record's bytes with no follow, or `undefined` when it is absent.
89
- *
90
- * SHARED BY `open` AND BY {@link readDiskTip} on purpose, the same reason {@link parse} is
91
- * shared: the read side has exactly one policy about what a subject.json is allowed to be, and a
92
- * second copy would drift. `lstat` first so a symlink is refused before any content is read
93
- * (following it would hand a writer another file's tip through the record's own name); the open
94
- * itself adds `O_NOFOLLOW` for the TOCTOU window between that `lstat` and the open. The portable
95
- * `?? 0` shape follows {@link recoverTipFromThreadLogs}: Windows has no `O_NOFOLLOW` and a
96
- * junction is not a symlink to `lstat`, so on that platform the `lstat` refusal alone is the
97
- * coverage, exactly as it is for the scan.
98
- */
99
- static async readRecord(path) {
100
- let st;
101
- try {
102
- st = await lstat(path);
103
- }
104
- catch (e) {
105
- if (e.code === "ENOENT")
106
- return undefined;
107
- throw e;
108
- }
109
- if (st.isSymbolicLink())
110
- throw new SubjectFrontierCorruptError(path, "a real subject record, never a symlink", "the writer never wrote a symlink");
111
- try {
112
- const fh = await open(path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
113
- try {
114
- return await fh.readFile();
115
- }
116
- finally {
117
- await fh.close();
118
- }
119
- }
120
- catch (e) {
121
- const code = e.code;
122
- if (code === "ENOENT")
123
- return undefined;
124
- if (code === "ELOOP")
125
- throw new SubjectFrontierCorruptError(path, "a real subject record, never a symlink", "the record became a symlink between the check and the open");
126
- throw e;
127
- }
128
- }
129
76
  /**
130
77
  * Open, or create a virgin record.
131
78
  *
@@ -136,71 +83,21 @@ export class FileSubjectFrontier {
136
83
  * mechanism exists to remove.
137
84
  */
138
85
  static async open(path, opts) {
139
- const bytes = await FileSubjectFrontier.readRecord(path);
140
- if (bytes === undefined) {
86
+ const record = await readEventSubjectRecord(path, opts);
87
+ if (record === undefined) {
141
88
  // ABSENT, so this record has never existed. Before calling the principal virgin, look at the
142
- // thread logs that already sit beside it. See {@link recoverTipFromThreadLogs}.
143
- const recovered = await FileSubjectFrontier.recoverTipFromThreadLogs(dirname(path), opts.principal);
144
- const fresh = new FileSubjectFrontier(path, { v: SUBJECT_FRONTIER_VERSION, space: opts.space, principal: opts.principal, tip: 0 });
89
+ // thread logs that already sit beside it. Recovery is persisted only by this writer.
90
+ const recovered = await recoverEventSubjectTip(dirname(path), opts.principal);
91
+ const fresh = new FileSubjectFrontier(path, { v: EVENT_SUBJECT_RECORD_VERSION, space: opts.space, principal: opts.principal, tip: 0 });
145
92
  if (recovered > 0)
146
93
  await fresh.write({ ...fresh.doc, tip: recovered });
147
94
  return fresh;
148
95
  }
149
- return new FileSubjectFrontier(path, FileSubjectFrontier.parse(path, bytes, opts));
96
+ return new FileSubjectFrontier(path, record);
150
97
  }
151
98
  /** Inspect acknowledged state without writing a recovered record or taking the emitter's lock. */
152
99
  static async recordedTip(path, opts) {
153
- const bytes = await FileSubjectFrontier.readRecord(path);
154
- return bytes === undefined
155
- ? FileSubjectFrontier.recoverTipFromThreadLogs(dirname(path), opts.principal)
156
- : FileSubjectFrontier.parse(path, bytes, opts).tip;
157
- }
158
- /**
159
- * Bytes to a validated document, or a refusal.
160
- *
161
- * SHARED BY `open` AND BY THE RE-READ IN {@link advance} on purpose. A record that went corrupt
162
- * underneath a live writer has to meet the same wall as one that was corrupt at boot; validating
163
- * only on the way in would let a writer that opened a good file overwrite a bad one, which
164
- * destroys the evidence of whatever produced it.
165
- */
166
- static parse(path, bytes, opts) {
167
- let raw;
168
- try {
169
- // FATAL decode, never `readFile(path, "utf8")`: Node's default substitutes U+FFFD for invalid
170
- // bytes, so a corrupted file arrives as a changed-but-parseable document. For a record whose
171
- // whole posture is that an unreadable state fails loud, "quietly altered and accepted" is the
172
- // one outcome it must not produce.
173
- raw = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
174
- }
175
- catch {
176
- throw new SubjectFrontierCorruptError(path, "valid UTF-8", "invalid UTF-8 bytes; refusing rather than substituting U+FFFD");
177
- }
178
- if (raw.length === 0)
179
- throw new SubjectFrontierCorruptError(path, "a non-empty file", "the file is zero bytes — distinct from missing, and never treated as virgin");
180
- let parsed;
181
- try {
182
- parsed = JSON.parse(raw);
183
- }
184
- catch (e) {
185
- throw new SubjectFrontierCorruptError(path, "parseable JSON", e.message);
186
- }
187
- const d = parsed;
188
- if (d?.v !== SUBJECT_FRONTIER_VERSION)
189
- throw new SubjectFrontierCorruptError(path, `v === ${SUBJECT_FRONTIER_VERSION}`, String(d?.v));
190
- if (d.space !== opts.space)
191
- throw new SubjectFrontierCorruptError(path, "space matches", `file=${String(d.space)} caller=${opts.space}`);
192
- // The principal is the whole key of this record: a file belonging to another identity would
193
- // hand this writer another principal's tip, which is a fabricated frontier of exactly the kind
194
- // the write-ahead log refuses for the same reason.
195
- //
196
- // A BYTE COMPARE, NOT A DECODED ONE: `assertValidOwnerToken` and `principalKey` fold nothing,
197
- // and the principal directory is `h(principal)` over the exact bytes, so a decoded or
198
- // case-folded compare here would accept a key that names a different directory on disk.
199
- if (d.principal !== opts.principal)
200
- throw new SubjectFrontierCorruptError(path, "principal matches", `file=${String(d.principal)} caller=${opts.principal}`);
201
- if (!isFrontierTip(d.tip))
202
- throw new SubjectFrontierCorruptError(path, "tip is a safe non-negative integer below Number.MAX_SAFE_INTEGER", String(d.tip));
203
- return { v: d.v, space: d.space, principal: d.principal, tip: d.tip };
100
+ return recordedEventTip(path, opts);
204
101
  }
205
102
  async advance(seq) {
206
103
  return this.serialize(async () => {
@@ -236,10 +133,7 @@ export class FileSubjectFrontier {
236
133
  * number, and a number taken from a document that failed its own shape checks is not evidence.
237
134
  */
238
135
  async readDiskTip() {
239
- const bytes = await FileSubjectFrontier.readRecord(this.path);
240
- if (bytes === undefined)
241
- return undefined;
242
- return FileSubjectFrontier.parse(this.path, bytes, { space: this.doc.space, principal: this.doc.principal }).tip;
136
+ return (await readEventSubjectRecord(this.path, { space: this.doc.space, principal: this.doc.principal }))?.tip;
243
137
  }
244
138
  /**
245
139
  * One mutation at a time on THIS instance.
@@ -259,151 +153,6 @@ export class FileSubjectFrontier {
259
153
  this.chain = next.catch(() => undefined);
260
154
  return next;
261
155
  }
262
- /**
263
- * Recover the tip from the THREAD LOGS beside this record, for an installation upgrading from a
264
- * release where this record did not exist.
265
- *
266
- * **EVERY THREAD LOG OF THE PRINCIPAL IS SCANNED.** Upgrading restarts the seat, so the first
267
- * session after the upgrade is a NEW thread with a virgin log, while the sequences the principal
268
- * was assigned sit in the logs of its PREVIOUS threads. The recovered tip is the highest of them.
269
- *
270
- * **ONLY WHEN THE RECORD IS ABSENT, NEVER WHEN IT READS ZERO.** A record holding zero is what
271
- * abandonment writes after a filtered purge, and re-seeding it from a thread log would silently
272
- * undo the abandonment and restore an expectation the subject no longer has. Missing and zero are
273
- * different states and this is the second place in this plane where conflating them is the bug.
274
- *
275
- * A sibling that cannot be read or does not parse is FATAL rather than skipped. Skipping it
276
- * under-counts the tip, which produces a permanent halt later with a message about a moved tip,
277
- * pointing at everything except the file that was quietly ignored here.
278
- */
279
- static async recoverTipFromThreadLogs(principalDir, principal) {
280
- let entries;
281
- try {
282
- entries = await readdir(principalDir, { withFileTypes: true });
283
- }
284
- catch (e) {
285
- if (e.code === "ENOENT")
286
- return 0;
287
- throw e;
288
- }
289
- let best = 0;
290
- for (const ent of entries) {
291
- // THE SCAN MAY NOT BE WALKED OUTSIDE THE PRINCIPAL DIRECTORY. The writer that creates these
292
- // directories refuses a symlinked component (`ensureDirNoSymlink`), so a symlink here is a
293
- // state it cannot produce, and following one would take a tip from a log belonging to some
294
- // other tree. The create path and the recovery path have to agree about that or the guard is
295
- // only on the half nobody attacks.
296
- if (ent.isSymbolicLink())
297
- throw new SubjectFrontierCorruptError(join(principalDir, ent.name), "a real directory beside the record, never a symlink", "following it would carry this scan outside the principal directory, and the writer that creates these directories refuses a symlinked component for the same reason");
298
- if (!ent.isDirectory())
299
- continue; // the record itself, the lock, anything else that is not a thread
300
- const walPath = join(principalDir, ent.name, "wal.json");
301
- // The entry check above clears the DIRECTORY and stops there, so a real thread directory
302
- // holding a symlinked `wal.json` reaches the same foreign log by one more hop. Two layers,
303
- // and they are not redundant:
304
- //
305
- // - `lstat` is the GRADED guard and the portable one. It decides the refusal on every
306
- // platform, which matters because `O_NOFOLLOW` does not exist on Windows and a guard that
307
- // silently evaporates there is worse than one that was never claimed.
308
- // - `O_NOFOLLOW` narrows the window between the `lstat` and the `open`, where the file could
309
- // be replaced by a link. It applies to the FINAL COMPONENT ONLY, so a thread directory
310
- // swapped for a link in that same window is still followed; closing that would take an
311
- // `openat` walk per component, which this scan does not do. NO CELL CAN GRADE EITHER
312
- // WINDOW, and the mutation config says so rather than registering a mutant that would
313
- // survive and be explained away.
314
- let st;
315
- try {
316
- st = await lstat(walPath);
317
- }
318
- catch (e) {
319
- const code = e.code;
320
- if (code === "ENOENT" || code === "ENOTDIR")
321
- continue; // not a thread directory
322
- throw e;
323
- }
324
- if (st.isSymbolicLink())
325
- throw new SubjectFrontierCorruptError(walPath, "a real thread log, never a symlink", "following it would read a log this principal's writer never wrote");
326
- // A HARD link is not a symlink and neither check above sees one, so a log hardlinked into
327
- // this directory from elsewhere reads as an ordinary file and hands over its tip. The writer
328
- // creates each log fresh, so more than one name for it is a state it cannot produce, which
329
- // is the same reason the symlink is refused rather than resolved.
330
- if (st.nlink > 1)
331
- throw new SubjectFrontierCorruptError(walPath, "a thread log with exactly one name", `it has ${st.nlink}, so the same file is reachable from outside this principal's directory and its tip is not this principal's to read`);
332
- let raw;
333
- try {
334
- const fh = await open(walPath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
335
- try {
336
- raw = await fh.readFile();
337
- }
338
- finally {
339
- await fh.close();
340
- }
341
- }
342
- catch (e) {
343
- const code = e.code;
344
- if (code === "ENOENT" || code === "ENOTDIR")
345
- continue;
346
- if (code === "ELOOP")
347
- throw new SubjectFrontierCorruptError(walPath, "a real thread log, never a symlink", "the file became a symlink between the check and the open");
348
- throw e;
349
- }
350
- let doc;
351
- try {
352
- doc = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(raw));
353
- }
354
- catch (e) {
355
- throw new SubjectFrontierCorruptError(walPath, "a readable thread log while recovering the subject tip", e.message);
356
- }
357
- // A log under another principal's directory is not ours to read a tip from. It cannot happen
358
- // in the shipped layout, which is why it is checked: a recovery component must refuse the
359
- // states its own writer cannot produce.
360
- if (doc.principal !== principal)
361
- throw new SubjectFrontierCorruptError(walPath, `a thread log for principal ${principal}`, `found ${String(doc.principal)}`);
362
- const seq = doc.frontier?.lastSubjectSeq;
363
- if (!isSafeNonNegInt(seq))
364
- throw new SubjectFrontierCorruptError(walPath, "frontier.lastSubjectSeq is a safe non-negative integer", String(seq));
365
- if (seq > best)
366
- best = seq;
367
- // AN ACKED PENDING HOLDS A SEQUENCE THE BROKER ASSIGNED AND THE FRONTIER DOES NOT.
368
- //
369
- // A log that took an ack and died before folding keeps the assigned sequence in
370
- // `pending.ackSeq`, which `EventWal` requires to be strictly AHEAD of
371
- // `frontier.lastSubjectSeq` (that is the crash window the acked state exists to survive).
372
- // Reading the frontier alone recovers the older number, persists it, and hands the next
373
- // publish an expectation the subject passed some time ago. The session that could fold it
374
- // will never run again, because upgrading forks the session id, so this log is the only
375
- // place that sequence survives. Under-counting here is the same defect this file fixes,
376
- // reintroduced at the one boundary the file exists for.
377
- const pending = doc.pending;
378
- if (pending && pending.state === "acked") {
379
- const acked = pending.ackSeq;
380
- if (!isSafeNonNegInt(acked))
381
- throw new SubjectFrontierCorruptError(walPath, "an acked pending carries a safe non-negative ackSeq", String(acked));
382
- if (!(acked > seq))
383
- throw new SubjectFrontierCorruptError(walPath, "an acked pending is ahead of the frontier it will fold into", `ackSeq=${acked} frontier.lastSubjectSeq=${seq}`);
384
- if (acked > best)
385
- best = acked;
386
- }
387
- // A `sent_unacked` PENDING IS PASSED OVER DELIBERATELY, AND NOT BECAUSE NOTHING WAS ASSIGNED.
388
- //
389
- // Whether the broker assigned a sequence to such a frame is the one thing the state does not
390
- // know: the frame went out and the acknowledgement was never observed, so the subject may or
391
- // may not have taken it. What is certain is structural and about the log rather than the
392
- // broker: `sent_unacked` carries no `ackSeq` at all, and a document that pairs the two is
393
- // refused as contradicting its own tag. There is therefore no sequence in it to fold, and
394
- // inventing one, `frontier.lastSubjectSeq + 1` for instance, would assert an assignment
395
- // nobody saw.
396
- //
397
- // The residue is real and is left standing on purpose. If the broker did assign a sequence to
398
- // that frame, this scan recovers a number one short of the tip, and the next publish halts on
399
- // a moved tip rather than publishing into a gap or overwriting anything. That is the safe
400
- // direction of the two, it is the halt the emitter's `cas-loss` message explains, and its
401
- // remedy is the one that message names. The owning session would have republished the frozen
402
- // id and let the broker deduplicate, but that session is exactly what an upgrade forks away
403
- // from, which is why the case reaches here at all.
404
- }
405
- return best;
406
- }
407
156
  async reset() {
408
157
  // UNCONDITIONAL, and deliberately not re-read. Abandonment is the one thing that legitimately
409
158
  // takes the tip backwards, so a record that moved under this writer is not an obstacle to it:
@@ -427,7 +176,7 @@ export class FileSubjectFrontier {
427
176
  // A planted link at the record's name must never receive the rename: that would leave the
428
177
  // link's TARGET holding the stale document while this principal's own history moved on.
429
178
  // Absence is fine (creation stays legal); only a symlink is refused, the same class {@link
430
- // readRecord} throws on the read side, so the create and read paths agree about links here too.
179
+ // readEventSubjectRecord} throws on the read side, so the create and read paths agree about links here too.
431
180
  let st;
432
181
  try {
433
182
  st = await lstat(this.path);
@@ -1 +1 @@
1
- {"version":3,"file":"subject-frontier.js","sourceRoot":"","sources":["../src/subject-frontier.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"subject-frontier.js","sourceRoot":"","sources":["../src/subject-frontier.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"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"}
@@ -266,7 +266,13 @@ export function renderInbox(opts) {
266
266
  const budget = opts.budget ?? INBOX_WINDOW_CHARS;
267
267
  const peek = opts.peek ?? false;
268
268
  const warning = opts.warning ?? "";
269
- const rank = (i) => (i.kind !== "channel" ? 0 : i.historical ? 2 : 1);
269
+ const rank = (i) => {
270
+ // A peek does not clear, so an old direct message that fills the window must not hide a current
271
+ // mention. A clearing read keeps direct messages ahead of channel traffic.
272
+ if (peek && i.mentionsMe && !i.historical)
273
+ return -1;
274
+ return i.kind !== "channel" ? 0 : i.historical ? 2 : 1;
275
+ };
270
276
  const ordered = [...opts.items].sort((a, b) => rank(a) - rank(b)); // stable: receive order within a rank
271
277
  // WHY THIS AGREES WITH THE ASSEMBLED REPLY, and what would break the agreement. Deliverability is
272
278
  // decided here and delivery is decided by `assemble`, and the two can only agree because both
@@ -1002,7 +1008,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
1002
1008
  {
1003
1009
  name: "cotal_inbox",
1004
1010
  title: "Cotal: read incoming messages",
1005
- description: "Read messages other agents have sent you since you last checked: channel broadcasts, direct messages, and role requests. It clears ONLY what it actually returns to you (nothing at all when peek is true), and one call carries at most a receivable window: direct messages and role requests first, then channel traffic, with replayed history last. Anything that does not fit stays buffered and is named in the reply, so call again for the next batch. A single message larger than one whole response is delivered in parts: once no smaller mail is waiting, each call carries the next part of it, a peek shows the current part without moving on, and the message is cleared only after its last part goes out. In focus mode it also pulls back the channel chatter held since you entered focus. If exclusion tracking makes a channel's focus recall unsafe, new non-historical mentions on that unmuted channel wake to pull their buffered bodies, never automatic injection, including on quiet channels. Ambient handling is unchanged, and the incomplete-recall warning still names unsafe channels. " +
1011
+ description: "Read messages other agents have sent you since you last checked: channel broadcasts, direct messages, and role requests. It clears ONLY what it actually returns to you (nothing at all when peek is true), and one call carries at most a receivable window: direct messages and role requests first, then channel traffic, with replayed history last. A peek shows a current mention of you before older direct messages that fill that window, and still clears nothing. Anything that does not fit stays buffered and is named in the reply, so call again for the next batch. A single message larger than one whole response is delivered in parts: once no smaller mail is waiting, each call carries the next part of it, a peek shows the current part without moving on, and the message is cleared only after its last part goes out. In focus mode it also pulls back the channel chatter held since you entered focus. If exclusion tracking makes a channel's focus recall unsafe, new non-historical mentions on that unmuted channel wake to pull their buffered bodies, never automatic injection, including on quiet channels. Ambient handling is unchanged, and the incomplete-recall warning still names unsafe channels. " +
1006
1012
  "When the connection is not ready, the reply says so and still returns locally buffered messages; an empty local buffer does not prove no new mesh messages exist. Exhausted channel drop tracking is reported even with an empty inbox; non-historical mentions on unmuted channels wake to pull their buffered bodies while ambient traffic stays suppressed. " +
1007
1013
  "If your stored copies reached their limit, 1000 unless an operator set another, the reply says earlier channel posts may have been dropped and that channel history may still hold them. A peek keeps that line for the next read.",
1008
1014
  schema: {