@cotal-ai/connector-core 0.164.4 → 0.164.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.
- package/dist/agent.d.ts +4 -0
- package/dist/agent.d.ts.map +1 -1
- package/dist/agent.js +32 -1
- package/dist/agent.js.map +1 -1
- package/dist/docs-bundle.bin +0 -0
- package/dist/docs-bundle.generated.d.ts +1 -1
- package/dist/docs-bundle.generated.js +6 -6
- package/dist/docs-index.bin +0 -0
- package/dist/tool-specs.d.ts.map +1 -1
- package/dist/tool-specs.js +15 -6
- package/dist/tool-specs.js.map +1 -1
- package/dist/version.generated.d.ts +2 -0
- package/dist/version.generated.d.ts.map +1 -0
- package/dist/version.generated.js +3 -0
- package/dist/version.generated.js.map +1 -0
- package/package.json +3 -3
package/dist/docs-bundle.bin
CHANGED
|
Binary file
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { DocsBundle, DocsMetadata } from "./docs.js";
|
|
2
2
|
/** The installed Cotal version, for stamping the orientation card and other surfaces. */
|
|
3
|
-
export declare const DOCS_VERSION = "0.164.
|
|
3
|
+
export declare const DOCS_VERSION = "0.164.5";
|
|
4
4
|
export declare function loadDocsMetadata(): DocsMetadata;
|
|
5
5
|
/** Validate the coupled corpus before the index uses its UTF-16 source bounds. No body is decoded. */
|
|
6
6
|
export declare function loadDocsSourceLengths(): number[];
|
|
@@ -3,10 +3,10 @@ import { readFileSync } from "node:fs";
|
|
|
3
3
|
import { join } from "node:path";
|
|
4
4
|
import { gunzipSync } from "node:zlib";
|
|
5
5
|
/** The installed Cotal version, for stamping the orientation card and other surfaces. */
|
|
6
|
-
export const DOCS_VERSION = "0.164.
|
|
6
|
+
export const DOCS_VERSION = "0.164.5";
|
|
7
7
|
export function loadDocsMetadata() {
|
|
8
8
|
return {
|
|
9
|
-
"version": "0.164.
|
|
9
|
+
"version": "0.164.5",
|
|
10
10
|
"pages": [
|
|
11
11
|
{
|
|
12
12
|
"slug": "what-is-cotal",
|
|
@@ -796,12 +796,12 @@ function corpusData() {
|
|
|
796
796
|
if (corpusPacked)
|
|
797
797
|
return corpusPacked;
|
|
798
798
|
const packed = readFileSync(join(import.meta.dirname, "docs-bundle.bin"));
|
|
799
|
-
if (packed.length !==
|
|
799
|
+
if (packed.length !== 1250067 || createHash("sha256").update(packed).digest("hex") !== "9557ebffda90cc157e66351a78edb6fdd01c4a0ad3e3e885bab8876c206b762e")
|
|
800
800
|
throw new Error("docs data file docs-bundle.bin beside this module is not the one built with it");
|
|
801
801
|
return (corpusPacked = packed);
|
|
802
802
|
}
|
|
803
|
-
const sourceBounds = [[0, 2205], [2205, 4000], [4000, 9323], [9323,
|
|
804
|
-
const sourceLengths = [4844, 4048, 13310,
|
|
803
|
+
const sourceBounds = [[0, 2205], [2205, 4000], [4000, 9323], [9323, 31698], [31698, 36095], [36095, 40476], [40476, 44204], [44204, 51007], [51007, 55111], [55111, 64908], [64908, 69060], [69060, 73578], [73578, 75862], [75862, 79873], [79873, 112753], [112753, 128607], [128607, 144405], [144405, 162607], [162607, 179932], [179932, 195145], [195145, 211176], [211176, 235351], [235351, 241081], [241081, 252065], [252065, 272997], [272997, 277751], [277751, 316552], [316552, 326507], [326507, 357709], [357709, 375381], [375381, 399865], [399865, 430863], [430863, 445364], [445364, 447311], [447311, 456296], [456296, 473123], [473123, 481207], [481207, 485088], [485088, 488469], [488469, 491772], [491772, 493903], [493903, 496676], [496676, 502197], [502197, 504094], [504094, 507798], [507798, 519942], [519942, 528962], [528962, 532487], [532487, 539840], [539840, 544884], [544884, 547888], [547888, 558507], [558507, 561484], [561484, 570204], [570204, 573194], [573194, 578148], [578148, 590635], [590635, 603439], [603439, 610875], [610875, 618659], [618659, 622008], [622008, 624957], [624957, 632514], [632514, 636230], [636230, 638440], [638440, 641902], [641902, 645319], [645319, 646433], [646433, 648182], [648182, 651845], [651845, 656575], [656575, 663211], [663211, 673721], [673721, 687037], [687037, 688874], [688874, 702117], [702117, 707504], [707504, 711460], [711460, 713969], [713969, 719011], [719011, 733206], [733206, 740011], [740011, 747396], [747396, 748213], [748213, 752759], [752759, 758679], [758679, 762057], [762057, 766265], [766265, 771355], [771355, 776936], [776936, 780358], [780358, 783949], [783949, 789114], [789114, 792757], [792757, 806215], [806215, 809033], [809033, 811716], [811716, 814383], [814383, 816874], [816874, 820894], [820894, 825958], [825958, 828967], [828967, 900062], [900062, 903325], [903325, 904518], [904518, 911152], [911152, 919897], [919897, 930675], [930675, 939486], [939486, 944669], [944669, 1205520], [1205520, 1244855], [1244855, 1250067]];
|
|
804
|
+
const sourceLengths = [4844, 4048, 13310, 89885, 12190, 10741, 38583, 17849, 9941, 85121, 37758, 11019, 5079, 9872, 89707, 42695, 44478, 51546, 47955, 43948, 43919, 68475, 14399, 29244, 60576, 10713, 115100, 27646, 94172, 50005, 73544, 95605, 39939, 8216, 22437, 45309, 21923, 9498, 8035, 7790, 4874, 6360, 14056, 4537, 8812, 32337, 22530, 8745, 47738, 12743, 7373, 27977, 7140, 22854, 6860, 12415, 32472, 33984, 19151, 19100, 8355, 7031, 19589, 8312, 5100, 8160, 9930, 2248, 5412, 9845, 11336, 16082, 26828, 34218, 4227, 36039, 12378, 9651, 8201, 13306, 98109, 16917, 18280, 1638, 10433, 15381, 7818, 10170, 12738, 14071, 7511, 9014, 12695, 8527, 35983, 6519, 6405, 6095, 6007, 9711, 12679, 7205, 209339, 7380, 2473, 15900, 22395, 27911, 21160, 12616, 756393, 111238, 21676];
|
|
805
805
|
const decodedBodies = [];
|
|
806
806
|
/** Validate the coupled corpus before the index uses its UTF-16 source bounds. No body is decoded. */
|
|
807
807
|
export function loadDocsSourceLengths() {
|
|
@@ -834,7 +834,7 @@ export function loadDocsBundle() {
|
|
|
834
834
|
/** The compact search index of that bundle: the sibling file docs-index.bin, read, checked and unzipped on the first search. */
|
|
835
835
|
export function loadDocsIndex() {
|
|
836
836
|
const packed = readFileSync(join(import.meta.dirname, "docs-index.bin"));
|
|
837
|
-
if (packed.length !==
|
|
837
|
+
if (packed.length !== 639283 || createHash("sha256").update(packed).digest("hex") !== "592cade0f0140fae01d671e2bd39529d7908cae15bae534d05f4a6cd931f8651")
|
|
838
838
|
throw new Error("docs data file docs-index.bin beside this module is not the one built with it");
|
|
839
839
|
return gunzipSync(packed);
|
|
840
840
|
}
|
package/dist/docs-index.bin
CHANGED
|
Binary file
|
package/dist/tool-specs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,SAAS,EAAmB,MAAM,YAAY,CAAC;AAI9F,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAKzD;;gGAEgG;AAChG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA6JD;;;;;;;sGAOsG;AACtG,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAExD,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB;;;;8FAI0F;IAC1F,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CAC1G;AAED,8DAA8D;AAC9D,MAAM,WAAW,QAAQ;IACvB;2DACuD;IACvD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAUD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzF;AAED;mGACmG;AACnG,eAAO,MAAM,YAAY,EAAE,cAAmC,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG7E;AAoCD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAEzC,2FAA2F;AAC3F,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,oCAAoC;IACpC,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB;gEAC4D;IAC5D,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B,uEAAuE;IACvE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,KAAK,MAAM,CAAC;IAC9C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC;;mBAEe;IACf,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5B,GAAG,aAAa,
|
|
1
|
+
{"version":3,"file":"tool-specs.d.ts","sourceRoot":"","sources":["../src/tool-specs.ts"],"names":[],"mappings":"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"}
|
package/dist/tool-specs.js
CHANGED
|
@@ -276,12 +276,20 @@ export function renderInbox(opts) {
|
|
|
276
276
|
const budget = opts.budget ?? INBOX_WINDOW_CHARS;
|
|
277
277
|
const peek = opts.peek ?? false;
|
|
278
278
|
const warning = opts.warning ?? "";
|
|
279
|
+
const strictIds = opts.strictIds ?? new Set();
|
|
279
280
|
const rank = (i) => {
|
|
281
|
+
const current = i.mentionsMe && !i.historical;
|
|
280
282
|
// A peek does not clear, so an old direct message that fills the window must not hide a current
|
|
281
|
-
// mention. A clearing read keeps direct messages ahead of channel traffic
|
|
282
|
-
|
|
283
|
+
// mention. A clearing read keeps direct messages ahead of channel traffic, and a current mention
|
|
284
|
+
// ahead of the rest of it, so older posts do not fill the read that follows the mention's wake.
|
|
285
|
+
// The in-order recall lane keeps its order.
|
|
286
|
+
if (peek && current)
|
|
283
287
|
return -1;
|
|
284
|
-
|
|
288
|
+
if (i.kind !== "channel")
|
|
289
|
+
return 0;
|
|
290
|
+
if (current && !strictIds.has(i.recvKey))
|
|
291
|
+
return 0.5;
|
|
292
|
+
return i.historical ? 2 : 1;
|
|
285
293
|
};
|
|
286
294
|
// A peek does not clear, so an older message that fills the window must not hide a newer one of
|
|
287
295
|
// the same kind. A reply that walks an ordered lane keeps receive order so its mark stays a prefix.
|
|
@@ -336,7 +344,6 @@ export function renderInbox(opts) {
|
|
|
336
344
|
// message too large for any response must not block the mail behind it. Then assemble for real
|
|
337
345
|
// and give back trailing items until the finished string fits, which is the part no future writer
|
|
338
346
|
// to the response body can slip past.
|
|
339
|
-
const strictIds = opts.strictIds ?? new Set();
|
|
340
347
|
const shown = [];
|
|
341
348
|
let used = 0;
|
|
342
349
|
let strictGap = false; // the in-order lane stops at its first gap; the free lane steps over its own
|
|
@@ -478,13 +485,15 @@ function heldNote(held, peek = false, stuckIds = new Set(), tier = "full") {
|
|
|
478
485
|
const parts = [];
|
|
479
486
|
if (waiting) {
|
|
480
487
|
const dms = held.filter((i) => i.kind !== "channel" && !stuckIds.has(i.recvKey)).length;
|
|
488
|
+
// Direct messages can hold back the mention that woke the reader, so the note says it waits.
|
|
489
|
+
const mentions = held.filter((i) => i.mentionsMe && !i.historical && !stuckIds.has(i.recvKey)).length;
|
|
481
490
|
// Under peek nothing is cleared, so the next call returns THIS window again. Telling a peeking
|
|
482
491
|
// caller to call again for the next batch is a promise the read cannot keep, and an obedient
|
|
483
492
|
// caller loops on it forever.
|
|
484
493
|
const next = peek
|
|
485
494
|
? "A peek clears nothing, so calling again returns this same window; read without peek to take it and see the next."
|
|
486
495
|
: "Call cotal_inbox again for the next batch.";
|
|
487
|
-
parts.push(`${waiting} more message${waiting === 1 ? "" : "s"} held (${dms} direct). This response was capped at the receivable window, and nothing held was cleared. ${next}`);
|
|
496
|
+
parts.push(`${waiting} more message${waiting === 1 ? "" : "s"} held (${dms} direct${mentions ? `, ${mentions} mentioning you` : ""}). This response was capped at the receivable window, and nothing held was cleared. ${next}`);
|
|
488
497
|
}
|
|
489
498
|
if (stuck.length) {
|
|
490
499
|
const named = stuck
|
|
@@ -1034,7 +1043,7 @@ export function cotalToolSpecs(config, source = "connector", env, offered, empty
|
|
|
1034
1043
|
{
|
|
1035
1044
|
name: "cotal_inbox",
|
|
1036
1045
|
title: "Cotal: read incoming messages",
|
|
1037
|
-
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
|
|
1046
|
+
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 a current mention of you, then other channel traffic, with replayed history last. A peek shows a current mention of you before older direct messages too, and still clears nothing. A peek shows a newer direct message or role request before an older one that fills that window, and still clears nothing. When the window holds a mention back, the reply says so. 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. " +
|
|
1038
1047
|
"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. " +
|
|
1039
1048
|
"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.",
|
|
1040
1049
|
schema: {
|