@cotal-ai/connector-core 0.23.0 → 0.25.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/dist/agent.d.ts +92 -0
- package/dist/agent.d.ts.map +1 -1
- package/dist/agent.js +109 -0
- package/dist/agent.js.map +1 -1
- package/dist/config.d.ts +36 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +126 -11
- package/dist/config.js.map +1 -1
- package/dist/control.d.ts +4 -0
- package/dist/control.d.ts.map +1 -1
- package/dist/control.js +12 -1
- package/dist/control.js.map +1 -1
- package/dist/docs-bundle.generated.d.ts.map +1 -1
- package/dist/docs-bundle.generated.js +28 -24
- package/dist/docs-bundle.generated.js.map +1 -1
- package/dist/docs.d.ts +5 -0
- package/dist/docs.d.ts.map +1 -1
- package/dist/docs.js +8 -2
- package/dist/docs.js.map +1 -1
- package/dist/launch.d.ts +89 -36
- package/dist/launch.d.ts.map +1 -1
- package/dist/launch.js +156 -65
- package/dist/launch.js.map +1 -1
- package/dist/relay.d.ts.map +1 -1
- package/dist/relay.js +52 -7
- package/dist/relay.js.map +1 -1
- package/dist/tool-specs.d.ts +61 -1
- package/dist/tool-specs.d.ts.map +1 -1
- package/dist/tool-specs.js +374 -27
- package/dist/tool-specs.js.map +1 -1
- package/package.json +3 -3
package/dist/launch.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"launch.js","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"launch.js","sourceRoot":"","sources":["../src/launch.ts"],"names":[],"mappings":"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"}
|
package/dist/relay.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAoFA,6FAA6F;AAC7F,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAuFlD"}
|
package/dist/relay.js
CHANGED
|
@@ -8,9 +8,39 @@
|
|
|
8
8
|
* entry points are one-liners over {@link runHookRelay}.
|
|
9
9
|
*/
|
|
10
10
|
import { connect } from "node:net";
|
|
11
|
-
import { hasIdentity } from "./config.js";
|
|
11
|
+
import { controlFromEnv, hasIdentity } from "./config.js";
|
|
12
12
|
import { HANDOFF_RECEIPT } from "./control.js";
|
|
13
13
|
const TIMEOUT_MS = 2000;
|
|
14
|
+
/**
|
|
15
|
+
* One bounded warning per hook process, on stderr, with no values in it.
|
|
16
|
+
*
|
|
17
|
+
* FAIL OPEN IS NOT THE SAME AS FAIL SILENT, and this relay was doing both. A hook that throws is a
|
|
18
|
+
* hook that blocked a human's session, so the catch below stays. But a material file that is
|
|
19
|
+
* missing, permissive, malformed, or contradicted by a direct carrier used to produce a hook that
|
|
20
|
+
* did nothing and said nothing: the seat runs, presence never advances, no queued peer message is
|
|
21
|
+
* ever injected, and there is no line anywhere to read. That is the same failure this connector's
|
|
22
|
+
* Python counterpart shipped, one connector over, and it is why the repair is a WARNING rather than
|
|
23
|
+
* a stricter refusal.
|
|
24
|
+
*
|
|
25
|
+
* Bounded means once per process, and the runtime starts one hook process per lifecycle event, so a
|
|
26
|
+
* genuinely broken session keeps saying so. That is the intended trade: the alternative is a single
|
|
27
|
+
* line early in a session that scrolls away, for a fault that persists until someone fixes the
|
|
28
|
+
* launch. Nothing is interpolated into the message. The variable NAMES are the diagnosis and the
|
|
29
|
+
* operator can read their own environment; a value in a hook's stderr is a disclosure in whatever
|
|
30
|
+
* captures that stream.
|
|
31
|
+
*/
|
|
32
|
+
let warned = false;
|
|
33
|
+
function warnOnce(message) {
|
|
34
|
+
if (warned)
|
|
35
|
+
return;
|
|
36
|
+
warned = true;
|
|
37
|
+
try {
|
|
38
|
+
process.stderr.write(`[cotal-connector] ${message}\n`);
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
/* a hook that cannot even warn still must not block the session */
|
|
42
|
+
}
|
|
43
|
+
}
|
|
14
44
|
function readStdin() {
|
|
15
45
|
return new Promise((resolve) => {
|
|
16
46
|
if (process.stdin.isTTY)
|
|
@@ -56,13 +86,28 @@ function done(out, confirm) {
|
|
|
56
86
|
export async function runHookRelay() {
|
|
57
87
|
if (!hasIdentity())
|
|
58
88
|
return done(""); // plain session, not a managed one — no-op
|
|
59
|
-
//
|
|
60
|
-
//
|
|
61
|
-
//
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
89
|
+
// The socket path comes from the launch env; the token comes from the launch-material file that
|
|
90
|
+
// env points at (the same file the in-agent server reads), never recomputed from public identity.
|
|
91
|
+
// A malformed or missing material file THROWS from controlFromEnv, and a hook that throws is a
|
|
92
|
+
// hook that blocked the session, so it is caught here and treated as "no control session": fail
|
|
93
|
+
// open is this relay's whole contract.
|
|
94
|
+
let control;
|
|
95
|
+
try {
|
|
96
|
+
control = controlFromEnv();
|
|
97
|
+
}
|
|
98
|
+
catch {
|
|
99
|
+
warnOnce("this session's control endpoint could not be resolved: the launch material is missing, " +
|
|
100
|
+
"unreadable, readable beyond its owner, malformed, or contradicted by direct COTAL_ variables. " +
|
|
101
|
+
"Lifecycle relays are disabled for this session, so presence will not advance and queued peer " +
|
|
102
|
+
"messages will not be injected. Check COTAL_LAUNCH_MATERIAL and COTAL_CONTROL_SOCKET.");
|
|
103
|
+
return done("");
|
|
104
|
+
}
|
|
105
|
+
// No control endpoint AT ALL is not a fault and is not warned about: a hand-driven session that
|
|
106
|
+
// sets COTAL_NAME and never had a control socket is a legitimate launch, and warning here would
|
|
107
|
+
// fire on every hook of a working session and teach the operator to ignore the channel.
|
|
108
|
+
if (!control)
|
|
65
109
|
return done("");
|
|
110
|
+
const { path, token } = control;
|
|
66
111
|
const raw = (await readStdin()).trim() || "{}";
|
|
67
112
|
let event = {};
|
|
68
113
|
try {
|
package/dist/relay.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;
|
|
1
|
+
{"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"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"}
|
package/dist/tool-specs.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { z } from "zod";
|
|
2
|
-
import type
|
|
2
|
+
import { type MeshAgent, type InboxItem } from "./agent.js";
|
|
3
3
|
import { type AgentConfig } from "./config.js";
|
|
4
4
|
/** What a Cotal tool returns: text to show the model, flagged on failure. MCP wraps it in
|
|
5
5
|
* `content`; the OpenCode plugin returns the string. */
|
|
@@ -56,6 +56,66 @@ export declare const NO_TOOL_ARGS: CotalToolInput;
|
|
|
56
56
|
export declare function refuseAnyArgs(name: string, args: unknown): string | undefined;
|
|
57
57
|
/** "name/role" (or just "name") for a message's sender. */
|
|
58
58
|
export declare function fmtFrom(i: InboxItem): string;
|
|
59
|
+
/**
|
|
60
|
+
* HOW MUCH OF THE INBOX ONE RESPONSE MAY CARRY, in characters.
|
|
61
|
+
*
|
|
62
|
+
* A read is destructive, and the payload is largest exactly where recovery happens: reconnecting
|
|
63
|
+
* brings a channel-history replay with it. Measured on a real reconnect: 200 messages, 3,490 lines,
|
|
64
|
+
* 451 KB, an order of magnitude past what a host will hand to a model, so the call both CONSUMED
|
|
65
|
+
* its contents and failed to deliver them. Whatever the host's own cap is, a response above this
|
|
66
|
+
* bound is a response the caller may never see, so it is never a response we may clear.
|
|
67
|
+
*
|
|
68
|
+
* The budget is deliberately far below the smallest plausible host cap: overshooting costs a lost
|
|
69
|
+
* message, undershooting costs one more call, and the response says so in its own text.
|
|
70
|
+
*/
|
|
71
|
+
export declare const INBOX_WINDOW_CHARS = 48000;
|
|
72
|
+
/** What one response carries, what it leaves buffered, and the exact text that says so. */
|
|
73
|
+
export interface InboxResponse {
|
|
74
|
+
/** The reply, already assembled and already inside the budget. Nothing may be appended to it. */
|
|
75
|
+
text: string;
|
|
76
|
+
/** What that text actually carries. Only these may be cleared. */
|
|
77
|
+
shown: InboxItem[];
|
|
78
|
+
/** Everything it does not carry. */
|
|
79
|
+
held: InboxItem[];
|
|
80
|
+
/** Ids no response could ever carry, whatever the window held at the time. */
|
|
81
|
+
stuck: ReadonlySet<string>;
|
|
82
|
+
}
|
|
83
|
+
/**
|
|
84
|
+
* Build one inbox response, and make it impossible for the response to outgrow its own budget.
|
|
85
|
+
*
|
|
86
|
+
* THE HISTORY THIS SHAPE COMES FROM, because it explains why it assembles rather than estimates.
|
|
87
|
+
* Three separate escapes were found here, each the same class one level further out: the items were
|
|
88
|
+
* budgeted but an oversized one was shown alone anyway; the items were budgeted but the head line
|
|
89
|
+
* and the held-note were not; the head and note were budgeted but the focus branch's recall warning
|
|
90
|
+
* was appended afterwards. Every one of them was a writer to the response body that the arithmetic
|
|
91
|
+
* did not know about. So the arithmetic is gone: this function ASSEMBLES the whole reply, measures
|
|
92
|
+
* what it actually built, and drops trailing items until the real string fits. A future writer is
|
|
93
|
+
* inside the bound by construction, because the bound is checked on the finished text.
|
|
94
|
+
*
|
|
95
|
+
* The order it drops in is the second rule: **mail before replay.** Direct messages and anycast
|
|
96
|
+
* requests are first-party traffic with a sender waiting; replayed channel history is a backfill the
|
|
97
|
+
* channel still holds. What gets dropped first is what someone else can still re-serve.
|
|
98
|
+
*
|
|
99
|
+
* And the third: **what does not fit is not cut off the end of the text.** It stays in the buffer,
|
|
100
|
+
* unacked, named in {@link heldNote}. Only `shown` may be cleared, which is #603 itself.
|
|
101
|
+
*/
|
|
102
|
+
export declare function renderInbox(opts: {
|
|
103
|
+
items: readonly InboxItem[];
|
|
104
|
+
/** The line above the messages, given whatever ends up being shown. */
|
|
105
|
+
head: (shown: readonly InboxItem[]) => string;
|
|
106
|
+
peek?: boolean;
|
|
107
|
+
/** A rider the response must carry, such as the focus branch's recall warning. */
|
|
108
|
+
warning?: string;
|
|
109
|
+
budget?: number;
|
|
110
|
+
/**
|
|
111
|
+
* Ids of a lane that must be delivered IN ORDER, with no gaps: focus recall, which a caller walks
|
|
112
|
+
* with a single mark rather than an acknowledgement per item. Stepping over one of these to fit a
|
|
113
|
+
* later one would either strand it, if the mark then passes it, or re-serve everything after it,
|
|
114
|
+
* if the mark stops short. The buffered lane has no such constraint, because each of its items is
|
|
115
|
+
* acked by id.
|
|
116
|
+
*/
|
|
117
|
+
strictIds?: ReadonlySet<string>;
|
|
118
|
+
}): InboxResponse;
|
|
59
119
|
/** Routing context for a `<channel …>` tag. Keys must be [A-Za-z0-9_] (others are dropped). */
|
|
60
120
|
export declare function channelMeta(i: InboxItem): Record<string, string>;
|
|
61
121
|
/** The full Cotal tool set for a given config. Renderers iterate this; `source` names the
|
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,KAAK,
|
|
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,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAqC,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAIlF;yDACyD;AACzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAqBD;;;;;;;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,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC;CACzF;AAUD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzF;AAED;;;;;;;;;GASG;AACH;mGACmG;AACnG,eAAO,MAAM,YAAY,EAAE,cAAmC,CAAC;AAE/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG7E;AAeD,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAG5C;AAeD;;;;;;;;;;;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,8EAA8E;IAC9E,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;CACjC,GAAG,aAAa,CAyFhB;AA0LD,+FAA+F;AAC/F,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQhE;AAED;+DAC+D;AAC/D,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,SAAc,GAAG,aAAa,EAAE,CA4rBzF"}
|