@cotal-ai/connector-core 0.53.0 → 0.55.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 +37 -4
- package/dist/agent.d.ts.map +1 -1
- package/dist/agent.js +245 -84
- package/dist/agent.js.map +1 -1
- package/dist/agui-holder.d.ts +2 -1
- package/dist/agui-holder.d.ts.map +1 -1
- package/dist/agui-holder.js +3 -2
- package/dist/agui-holder.js.map +1 -1
- package/dist/config.d.ts +2 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +5 -1
- package/dist/config.js.map +1 -1
- package/dist/docs-bundle.generated.js +27 -27
- package/dist/docs-bundle.generated.js.map +1 -1
- package/dist/durable-source.d.ts +31 -0
- package/dist/durable-source.d.ts.map +1 -1
- package/dist/durable-source.js +43 -5
- package/dist/durable-source.js.map +1 -1
- package/dist/manager-call.d.ts +17 -0
- package/dist/manager-call.d.ts.map +1 -0
- package/dist/manager-call.js +103 -0
- package/dist/manager-call.js.map +1 -0
- package/dist/orientation.d.ts +5 -0
- package/dist/orientation.d.ts.map +1 -1
- package/dist/orientation.js +18 -1
- package/dist/orientation.js.map +1 -1
- package/dist/tool-specs.d.ts.map +1 -1
- package/dist/tool-specs.js +43 -7
- package/dist/tool-specs.js.map +1 -1
- package/package.json +2 -2
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"docs-bundle.generated.js","sourceRoot":"","sources":["../src/docs-bundle.generated.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,SAAS,EAAE,QAAQ;IACnB,eAAe,EAAE,mEAAmE;IACpF,OAAO,EAAE;QACP;YACE,MAAM,EAAE,eAAe;YACvB,OAAO,EAAE,eAAe;YACxB,MAAM,EAAE,0BAA0B;YAClC,SAAS,EAAE,+FAA+F;YAC1G,MAAM,EAAE,k5IAAk5I;SAC35I;QACD;YACE,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,0BAA0B;YAClC,SAAS,EAAE,gHAAgH;YAC3H,MAAM,EAAE,
|
|
1
|
+
{"version":3,"file":"docs-bundle.generated.js","sourceRoot":"","sources":["../src/docs-bundle.generated.ts"],"names":[],"mappings":"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"}
|
package/dist/durable-source.d.ts
CHANGED
|
@@ -135,6 +135,37 @@ export declare class JsonlFileSource<T = unknown> implements DurableSource<T> {
|
|
|
135
135
|
* connector would duplicate the opaque cursor format and eventually drift from it.
|
|
136
136
|
*/
|
|
137
137
|
readFromBeginning(): Promise<SourceRead<T>>;
|
|
138
|
+
/** Cursor at byte zero for this file's current identity. */
|
|
139
|
+
cursorAtBeginning(): Promise<string>;
|
|
140
|
+
read(cursor: string | undefined): Promise<SourceRead<T>>;
|
|
141
|
+
}
|
|
142
|
+
/**
|
|
143
|
+
* Substitutes a captured boundary for the caller's cursor on the ONE read where that cursor is
|
|
144
|
+
* `undefined` — a virgin log positioning itself for the first time.
|
|
145
|
+
*
|
|
146
|
+
* **Why this exists.** A lazily-built emitter's source otherwise positions itself on its own FIRST
|
|
147
|
+
* read, and that read happens only after everything else the bind does first: a mesh wait, the
|
|
148
|
+
* write-ahead log's directory, the subject frontier, the log open, a channel resolve, a
|
|
149
|
+
* single-replica preflight. Anything the session writes to its record file during that window lands
|
|
150
|
+
* behind the position the source discovers later, is treated as already published, and is dropped —
|
|
151
|
+
* silently, under a line that has by then already announced the stream as started. Measured on the
|
|
152
|
+
* Codex connector, the shape this wrapper first closed there: 17ms and 36ms on an idle machine, and
|
|
153
|
+
* a whole turn lost at a widened window.
|
|
154
|
+
*
|
|
155
|
+
* So the boundary is captured by the caller BEFORE the bind announces itself, and substituted here,
|
|
156
|
+
* on the one read that would otherwise ask the source where it currently ends.
|
|
157
|
+
*
|
|
158
|
+
* **The limit, stated once.** This positions only a log with no cursor. A log that already carries
|
|
159
|
+
* one is a resume, and passes through to the inner source untouched: a cursor written by a live
|
|
160
|
+
* emitter is the honest one, and overwriting it would re-read or skip a live session's records
|
|
161
|
+
* depending on which one it disagreed with. Nothing is written into the log by this wrapper itself;
|
|
162
|
+
* it only changes what is asked for, never what is stored.
|
|
163
|
+
*/
|
|
164
|
+
export declare class BoundStartSource<T> implements DurableSource<T> {
|
|
165
|
+
private readonly inner;
|
|
166
|
+
private readonly start;
|
|
167
|
+
readonly kind: string;
|
|
168
|
+
constructor(inner: DurableSource<T>, start: string);
|
|
138
169
|
read(cursor: string | undefined): Promise<SourceRead<T>>;
|
|
139
170
|
}
|
|
140
171
|
//# sourceMappingURL=durable-source.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"durable-source.d.ts","sourceRoot":"","sources":["../src/durable-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC;IACT,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6FAA6F;AAC7F,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAGvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,gBAAgB;gBAEA,IAAI,EAAE,MAAM;IAEzC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAQ1B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;mBACkB,MAAM;IAO3B,mGAAmG;mBAC9E,oBAAoB;IAgBzC;;;;;;;;;;;OAWG;IACG,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"durable-source.d.ts","sourceRoot":"","sources":["../src/durable-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC;IACT,2FAA2F;IAC3F,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,6FAA6F;AAC7F,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;CAC1D;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAGvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,QAAQ,CAAC,IAAI,gBAAgB;gBAEA,IAAI,EAAE,MAAM;IAEzC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAQ1B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;mBACkB,MAAM;IAO3B,mGAAmG;mBAC9E,oBAAoB;IAgBzC;;;;;;;;;;;OAWG;IACG,iBAAiB,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAOjD,4DAA4D;IACtD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAUpC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAwH/D;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;IAIxD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGH,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,KAAK,EAAE,MAAM;IAKhC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;CAGzD"}
|
package/dist/durable-source.js
CHANGED
|
@@ -124,18 +124,21 @@ export class JsonlFileSource {
|
|
|
124
124
|
* connector would duplicate the opaque cursor format and eventually drift from it.
|
|
125
125
|
*/
|
|
126
126
|
async readFromBeginning() {
|
|
127
|
+
const cursor = await this.cursorAtBeginning();
|
|
128
|
+
// A replacement between the two opens is detected by `read`'s file-identity check. Appends are
|
|
129
|
+
// ordinary: starting at zero still means consuming every complete record now present.
|
|
130
|
+
return this.read(cursor);
|
|
131
|
+
}
|
|
132
|
+
/** Cursor at byte zero for this file's current identity. */
|
|
133
|
+
async cursorAtBeginning() {
|
|
127
134
|
const fh = await open(this.path, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
|
|
128
|
-
let cursor;
|
|
129
135
|
try {
|
|
130
136
|
const st = await fh.stat();
|
|
131
|
-
|
|
137
|
+
return `${String(st.dev)}:${String(st.ino)}:0:${await JsonlFileSource.sealAt(fh, 0)}`;
|
|
132
138
|
}
|
|
133
139
|
finally {
|
|
134
140
|
await fh.close();
|
|
135
141
|
}
|
|
136
|
-
// A replacement between the two opens is detected by `read`'s file-identity check. Appends are
|
|
137
|
-
// ordinary: starting at zero still means consuming every complete record now present.
|
|
138
|
-
return this.read(cursor);
|
|
139
142
|
}
|
|
140
143
|
async read(cursor) {
|
|
141
144
|
// O_NOFOLLOW: a symlinked source is REFUSED, not followed.
|
|
@@ -242,4 +245,39 @@ export class JsonlFileSource {
|
|
|
242
245
|
}
|
|
243
246
|
}
|
|
244
247
|
}
|
|
248
|
+
/**
|
|
249
|
+
* Substitutes a captured boundary for the caller's cursor on the ONE read where that cursor is
|
|
250
|
+
* `undefined` — a virgin log positioning itself for the first time.
|
|
251
|
+
*
|
|
252
|
+
* **Why this exists.** A lazily-built emitter's source otherwise positions itself on its own FIRST
|
|
253
|
+
* read, and that read happens only after everything else the bind does first: a mesh wait, the
|
|
254
|
+
* write-ahead log's directory, the subject frontier, the log open, a channel resolve, a
|
|
255
|
+
* single-replica preflight. Anything the session writes to its record file during that window lands
|
|
256
|
+
* behind the position the source discovers later, is treated as already published, and is dropped —
|
|
257
|
+
* silently, under a line that has by then already announced the stream as started. Measured on the
|
|
258
|
+
* Codex connector, the shape this wrapper first closed there: 17ms and 36ms on an idle machine, and
|
|
259
|
+
* a whole turn lost at a widened window.
|
|
260
|
+
*
|
|
261
|
+
* So the boundary is captured by the caller BEFORE the bind announces itself, and substituted here,
|
|
262
|
+
* on the one read that would otherwise ask the source where it currently ends.
|
|
263
|
+
*
|
|
264
|
+
* **The limit, stated once.** This positions only a log with no cursor. A log that already carries
|
|
265
|
+
* one is a resume, and passes through to the inner source untouched: a cursor written by a live
|
|
266
|
+
* emitter is the honest one, and overwriting it would re-read or skip a live session's records
|
|
267
|
+
* depending on which one it disagreed with. Nothing is written into the log by this wrapper itself;
|
|
268
|
+
* it only changes what is asked for, never what is stored.
|
|
269
|
+
*/
|
|
270
|
+
export class BoundStartSource {
|
|
271
|
+
inner;
|
|
272
|
+
start;
|
|
273
|
+
kind;
|
|
274
|
+
constructor(inner, start) {
|
|
275
|
+
this.inner = inner;
|
|
276
|
+
this.start = start;
|
|
277
|
+
this.kind = inner.kind;
|
|
278
|
+
}
|
|
279
|
+
read(cursor) {
|
|
280
|
+
return this.inner.read(cursor ?? this.start);
|
|
281
|
+
}
|
|
282
|
+
}
|
|
245
283
|
//# sourceMappingURL=durable-source.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"durable-source.js","sourceRoot":"","sources":["../src/durable-source.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"durable-source.js","sourceRoot":"","sources":["../src/durable-source.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { type EpAttributedReply, type EpCaller, type EpVerbTarget } from "@cotal-ai/core";
|
|
2
|
+
import type { AgentConfig } from "./config.js";
|
|
3
|
+
type ManagerConfig = Pick<AgentConfig, "space" | "servers" | "tls" | "lifecycleUid" | "userAuth" | "managerInstanceId">;
|
|
4
|
+
/** Decode only the routing coordinates. The broker verifies the signed bearer before any call. */
|
|
5
|
+
export declare function managerCallerBinding(bearer: string, config: ManagerConfig): {
|
|
6
|
+
caller: EpCaller;
|
|
7
|
+
instanceId: string;
|
|
8
|
+
};
|
|
9
|
+
/** A control connection never replaces the seat's presence, messages or standing bearer source. */
|
|
10
|
+
export declare function invokeUserManager(config: ManagerConfig, bearer: string, command: string, args: Record<string, unknown> | undefined, opts?: {
|
|
11
|
+
target?: EpVerbTarget;
|
|
12
|
+
deadlineMs?: number;
|
|
13
|
+
follow?: boolean;
|
|
14
|
+
signal?: AbortSignal;
|
|
15
|
+
}): Promise<EpAttributedReply>;
|
|
16
|
+
export {};
|
|
17
|
+
//# sourceMappingURL=manager-call.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manager-call.d.ts","sourceRoot":"","sources":["../src/manager-call.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,KAAK,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,cAAc,GAAG,UAAU,GAAG,mBAAmB,CAAC,CAAC;AAExH,kGAAkG;AAClG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAuBpH;AAED,mGAAmG;AACnG,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACzC,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,YAAY,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAO,GAChG,OAAO,CAAC,iBAAiB,CAAC,CAmE5B"}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import { randomUUID } from "node:crypto";
|
|
2
|
+
import { BASELINE_LIFECYCLE_ENDPOINT, assertLifecycleToken, dialerFor, invokeCommand, replyRefusedBeforeEffect, resolveService, standaloneConnectOpts, } from "@cotal-ai/core";
|
|
3
|
+
/** Decode only the routing coordinates. The broker verifies the signed bearer before any call. */
|
|
4
|
+
export function managerCallerBinding(bearer, config) {
|
|
5
|
+
let payload;
|
|
6
|
+
try {
|
|
7
|
+
const parts = bearer.split(".");
|
|
8
|
+
if (parts.length !== 3)
|
|
9
|
+
throw new Error("invalid JWT");
|
|
10
|
+
payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf8"));
|
|
11
|
+
}
|
|
12
|
+
catch {
|
|
13
|
+
throw new Error("manager control exchange returned an invalid bearer");
|
|
14
|
+
}
|
|
15
|
+
const user = config.userAuth;
|
|
16
|
+
const act = payload?.act;
|
|
17
|
+
if (!user || !act || act.view !== "manager-caller" || payload.sub !== user.owner ||
|
|
18
|
+
act.owner !== user.owner || act.actor !== user.actor || act.lifecycleUid !== config.lifecycleUid ||
|
|
19
|
+
!(payload.aud === config.space || (Array.isArray(payload.aud) && payload.aud.length === 1 && payload.aud[0] === config.space)))
|
|
20
|
+
throw new Error("manager control exchange returned different space, principal, lifecycle or view coordinates");
|
|
21
|
+
if (typeof act.managerInstanceId !== "string")
|
|
22
|
+
throw new Error("manager control exchange returned no concrete manager instance");
|
|
23
|
+
const instanceId = assertLifecycleToken(act.managerInstanceId, "managerInstanceId");
|
|
24
|
+
if (config.managerInstanceId !== undefined && instanceId !== config.managerInstanceId)
|
|
25
|
+
throw new Error("manager control exchange selected a different manager instance");
|
|
26
|
+
if (typeof act.lifecycleUid !== "string")
|
|
27
|
+
throw new Error("manager control exchange returned no lifecycle UID");
|
|
28
|
+
return { caller: { owner: user.owner, actor: user.actor, uid: act.lifecycleUid }, instanceId };
|
|
29
|
+
}
|
|
30
|
+
/** A control connection never replaces the seat's presence, messages or standing bearer source. */
|
|
31
|
+
export async function invokeUserManager(config, bearer, command, args, opts = {}) {
|
|
32
|
+
opts.signal?.throwIfAborted();
|
|
33
|
+
const { caller, instanceId } = managerCallerBinding(bearer, config);
|
|
34
|
+
const nc = await dialerFor(config.servers)({
|
|
35
|
+
servers: config.servers,
|
|
36
|
+
...standaloneConnectOpts({ bearer, sentinelCreds: config.userAuth.sentinelCreds, tls: config.tls }),
|
|
37
|
+
maxReconnectAttempts: 0,
|
|
38
|
+
timeout: Math.min(opts.deadlineMs ?? 10_000, 2_000),
|
|
39
|
+
});
|
|
40
|
+
const onAbort = () => { void nc.close(); };
|
|
41
|
+
opts.signal?.addEventListener("abort", onAbort, { once: true });
|
|
42
|
+
try {
|
|
43
|
+
// An in-flight dial has no connection handle to close yet. A late result never publishes.
|
|
44
|
+
opts.signal?.throwIfAborted();
|
|
45
|
+
const endpoint = BASELINE_LIFECYCLE_ENDPOINT;
|
|
46
|
+
const resolve = () => resolveService(nc, config.space, endpoint, caller, { instanceId, deadlineMs: opts.deadlineMs ?? 10_000, signal: opts.signal });
|
|
47
|
+
let service = await resolve();
|
|
48
|
+
if (opts.follow && !service.commands.has("goal-result")) {
|
|
49
|
+
return {
|
|
50
|
+
reply: {
|
|
51
|
+
v: 1,
|
|
52
|
+
id: randomUUID(),
|
|
53
|
+
ok: false,
|
|
54
|
+
data: undefined,
|
|
55
|
+
error: {
|
|
56
|
+
code: "failed-precondition",
|
|
57
|
+
message: `manager instance ${service.responder.instanceId} does not support "goal-result"; upgrade manager to enable durable goal following (SPEC 13.6)`,
|
|
58
|
+
outcome: "not-executed",
|
|
59
|
+
},
|
|
60
|
+
},
|
|
61
|
+
responder: { endpoint, instanceId: service.responder.instanceId, epoch: service.responder.epoch },
|
|
62
|
+
};
|
|
63
|
+
}
|
|
64
|
+
const invoke = async () => {
|
|
65
|
+
const result = await invokeCommand(nc, config.space, service, command, args, opts);
|
|
66
|
+
if (result.reply.ok === false && replyRefusedBeforeEffect(result.reply.error)) {
|
|
67
|
+
try {
|
|
68
|
+
service = await resolve();
|
|
69
|
+
if (opts.follow && !service.commands.has("goal-result")) {
|
|
70
|
+
throw new Error(`manager instance ${service.responder.instanceId} does not support "goal-result"; upgrade manager to enable durable goal following (SPEC 13.6)`);
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
catch (error) {
|
|
74
|
+
return { ...result, reply: { ...result.reply, error: {
|
|
75
|
+
...result.reply.error,
|
|
76
|
+
message: `${command} WAS NOT RUN; manager instance ${instanceId} refused before effects, and re-resolution failed: ${error instanceof Error ? error.message : String(error)}`,
|
|
77
|
+
} } };
|
|
78
|
+
}
|
|
79
|
+
// Keep the second invoke outside the catch: it may execute and must never inherit the
|
|
80
|
+
// first attempt's not-executed verdict if its response is lost.
|
|
81
|
+
return invokeCommand(nc, config.space, service, command, args, opts);
|
|
82
|
+
}
|
|
83
|
+
return result;
|
|
84
|
+
};
|
|
85
|
+
return await invoke();
|
|
86
|
+
}
|
|
87
|
+
finally {
|
|
88
|
+
opts.signal?.removeEventListener("abort", onAbort);
|
|
89
|
+
let timer;
|
|
90
|
+
try {
|
|
91
|
+
await Promise.race([
|
|
92
|
+
nc.drain().catch(() => nc.close()),
|
|
93
|
+
new Promise((resolve) => { timer = setTimeout(resolve, 2_000); timer.unref(); }),
|
|
94
|
+
]);
|
|
95
|
+
}
|
|
96
|
+
finally {
|
|
97
|
+
if (timer !== undefined)
|
|
98
|
+
clearTimeout(timer);
|
|
99
|
+
await nc.close();
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
//# sourceMappingURL=manager-call.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"manager-call.js","sourceRoot":"","sources":["../src/manager-call.ts"],"names":[],"mappings":"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"}
|
package/dist/orientation.d.ts
CHANGED
|
@@ -65,6 +65,11 @@ export interface Orientation {
|
|
|
65
65
|
present: number;
|
|
66
66
|
summary: string;
|
|
67
67
|
};
|
|
68
|
+
/** This endpoint's own presence-publish health. A stuck writer makes the peer snapshot last-known. */
|
|
69
|
+
presence: {
|
|
70
|
+
live: boolean;
|
|
71
|
+
detail?: string;
|
|
72
|
+
};
|
|
68
73
|
status: PresenceStatus;
|
|
69
74
|
attention: AttentionMode;
|
|
70
75
|
unread: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGzD;;2DAE2D;AAC3D,eAAO,MAAM,qBAAqB,QAEmC,CAAC;AAEtE;;;2GAG2G;AAC3G,eAAO,MAAM,gBAAgB,QAIiE,CAAC;AAE/F;;2FAE2F;AAC3F,eAAO,MAAM,cAAc,QAIuC,CAAC;AAEnE,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,gGAAgG;IAChG,CAAC,EAAE,CAAC,CAAC;IACL;oFACgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3G,MAAM,EAAE;QACN,8FAA8F;QAC9F,QAAQ,EAAE,OAAO,CAAC;QAClB,wDAAwD;QACxD,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,sEAAsE;QACtE,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,kFAAkF;QAClF,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,kGAAkG;IAClG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mGAAmG;IACnG,KAAK,EAAE;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,IAAI,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAC5D,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,mEAAmE;IACnE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACxF;AAgBD;;wFAEwF;AACxF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,eAAe,EAAE,EAC/B,WAAW,EAAE,MAAM,GAClB,WAAW,
|
|
1
|
+
{"version":3,"file":"orientation.d.ts","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGzD;;2DAE2D;AAC3D,eAAO,MAAM,qBAAqB,QAEmC,CAAC;AAEtE;;;2GAG2G;AAC3G,eAAO,MAAM,gBAAgB,QAIiE,CAAC;AAE/F;;2FAE2F;AAC3F,eAAO,MAAM,cAAc,QAIuC,CAAC;AAEnE,qFAAqF;AACrF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,gGAAgG;IAChG,CAAC,EAAE,CAAC,CAAC;IACL;oFACgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3G,MAAM,EAAE;QACN,8FAA8F;QAC9F,QAAQ,EAAE,OAAO,CAAC;QAClB,wDAAwD;QACxD,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,sEAAsE;QACtE,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,kFAAkF;QAClF,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,kGAAkG;IAClG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,mGAAmG;IACnG,KAAK,EAAE;QAAE,IAAI,EAAE,eAAe,EAAE,CAAC;QAAC,IAAI,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAC5D,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,sGAAsG;IACtG,QAAQ,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,mEAAmE;IACnE,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACxF;AAgBD;;wFAEwF;AACxF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,WAAW,EACnB,YAAY,EAAE,eAAe,EAAE,EAC/B,WAAW,EAAE,MAAM,GAClB,WAAW,CA4Db;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,GAAG,MAAM,CAoCxD"}
|
package/dist/orientation.js
CHANGED
|
@@ -49,6 +49,15 @@ export function buildOrientation(agent, config, visibleTools, generatedAt) {
|
|
|
49
49
|
const summary = peers.length
|
|
50
50
|
? shown.join(", ") + (peers.length > shown.length ? `, +${peers.length - shown.length} more` : "")
|
|
51
51
|
: "no other peers present";
|
|
52
|
+
const writeFailure = agent.transportConnected ? agent.presenceWriteFailure : undefined;
|
|
53
|
+
// #1229: the roster's trust state, not just the writer's health, decides liveness. A stuck
|
|
54
|
+
// writer keeps precedence; otherwise an `unpopulated` or `stale` view carries the same shape.
|
|
55
|
+
const view = agent.presenceView();
|
|
56
|
+
const viewDetail = view.state === "unpopulated"
|
|
57
|
+
? "the presence watch has not completed its initial snapshot, so the peer list may be partial"
|
|
58
|
+
: view.state === "stale"
|
|
59
|
+
? `the presence view has been silent since ${new Date(view.staleSince).toISOString()}, so the peer list is last-known`
|
|
60
|
+
: undefined;
|
|
52
61
|
return {
|
|
53
62
|
v: 1,
|
|
54
63
|
generatedAt,
|
|
@@ -65,6 +74,14 @@ export function buildOrientation(agent, config, visibleTools, generatedAt) {
|
|
|
65
74
|
capabilities: config.capabilities ?? [],
|
|
66
75
|
tools: { core, more },
|
|
67
76
|
peers: { present: peers.length, summary },
|
|
77
|
+
presence: writeFailure?.stuck
|
|
78
|
+
? {
|
|
79
|
+
live: false,
|
|
80
|
+
detail: `bucket ${JSON.stringify(writeFailure.bucket)} has refused ${writeFailure.consecutiveFailures} consecutive writes for ${writeFailure.forMs}ms`,
|
|
81
|
+
}
|
|
82
|
+
: viewDetail
|
|
83
|
+
? { live: false, detail: viewDetail }
|
|
84
|
+
: { live: true },
|
|
68
85
|
status: agent.status,
|
|
69
86
|
attention: agent.attention,
|
|
70
87
|
unread: { total: agent.inboxCount() },
|
|
@@ -95,7 +112,7 @@ export function renderOrientation(o) {
|
|
|
95
112
|
];
|
|
96
113
|
if (aclDiffers)
|
|
97
114
|
lines.push(` • may join (read ACL): ${fmt(o.access.readAcl)}`);
|
|
98
|
-
lines.push(` • post: ${o.access.post.length ? fmt(o.access.post) : "— (read-only; no post channels)"}`, ` • capabilities: ${o.capabilities.length ? o.capabilities.join(", ") : "none beyond defaults"}`, "", `Tools — core loop: ${o.tools.core.map((t) => t.name).join(", ") || "—"}`, `Tools — more: ${o.tools.more.map((t) => t.name).join(", ") || "—"}`, "", `Right now (snapshot @ ${new Date(o.generatedAt).toISOString()}):`, ` • status: ${honestStatus(o.status)} · attention: ${o.attention}`, ` • peers present: ${o.peers.present} — ${o.peers.summary}`, ` • unread: ${o.unread.total}`, "", `Act → read: ${o.actions.read} · reply on a channel: ${o.actions.replyChannel} · ` +
|
|
115
|
+
lines.push(` • post: ${o.access.post.length ? fmt(o.access.post) : "— (read-only; no post channels)"}`, ` • capabilities: ${o.capabilities.length ? o.capabilities.join(", ") : "none beyond defaults"}`, "", `Tools — core loop: ${o.tools.core.map((t) => t.name).join(", ") || "—"}`, `Tools — more: ${o.tools.more.map((t) => t.name).join(", ") || "—"}`, "", `Right now (snapshot @ ${new Date(o.generatedAt).toISOString()}):`, ` • status: ${honestStatus(o.status)} · attention: ${o.attention}`, ` • peers present: ${o.peers.present} — ${o.peers.summary}`, ` • presence view: ${o.presence.live ? "live" : `NOT LIVE — ${o.presence.detail}`}`, ` • unread: ${o.unread.total}`, "", `Act → read: ${o.actions.read} · reply on a channel: ${o.actions.replyChannel} · ` +
|
|
99
116
|
`private: ${o.actions.replyPrivate} · ask a role: ${o.actions.askRole}`);
|
|
100
117
|
return lines.join("\n");
|
|
101
118
|
}
|
package/dist/orientation.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;2DAE2D;AAC3D,MAAM,CAAC,MAAM,qBAAqB,GAChC,uIAAuI;IACvI,mEAAmE,CAAC;AAEtE;;;2GAG2G;AAC3G,MAAM,CAAC,MAAM,gBAAgB,GAC3B,qGAAqG;IACrG,qGAAqG;IACrG,mGAAmG;IACnG,4FAA4F,CAAC;AAE/F;;2FAE2F;AAC3F,MAAM,CAAC,MAAM,cAAc,GACzB,6FAA6F;IAC7F,2FAA2F;IAC3F,gGAAgG;IAChG,gEAAgE,CAAC;
|
|
1
|
+
{"version":3,"file":"orientation.js","sourceRoot":"","sources":["../src/orientation.ts"],"names":[],"mappings":"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"}
|
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,EAAE,MAAM,YAAY,CAAC;AAE7E,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI5F;yDACyD;AACzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgDD;;;;;;;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,CAoBzF;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;mGACmG;AACnG;;;;;;;;;;;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;AAyJD,+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,
|
|
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;AAE7E,OAAO,EAA+C,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAI5F;yDACyD;AACzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgDD;;;;;;;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,CAoBzF;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;mGACmG;AACnG;;;;;;;;;;;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;AAyJD,+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,CAwgCzF"}
|
package/dist/tool-specs.js
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
*/
|
|
10
10
|
import { execFileSync } from "node:child_process";
|
|
11
11
|
import { z } from "zod";
|
|
12
|
-
import { isConcreteChannel, channelInAllow, AmbiguousPeerError, isPermissionDenied, renderLifecycleBlocked, LANG_PROBLEM_DETAIL_KIND } from "@cotal-ai/core";
|
|
12
|
+
import { isConcreteChannel, channelInAllow, AmbiguousPeerError, assertLifecycleToken, isPermissionDenied, renderLifecycleBlocked, LANG_PROBLEM_DETAIL_KIND } from "@cotal-ai/core";
|
|
13
13
|
import { afterRecallMark } from "./agent.js";
|
|
14
14
|
import { attributionSafe, fmtBody, fmtItem, fmtFrom } from "./framing.js";
|
|
15
15
|
import { FEEDBACK_URL, PUBLIC_FEEDBACK_URL, isAuthed } from "./config.js";
|
|
@@ -469,6 +469,8 @@ export function cotalToolSpecs(config, source = "connector") {
|
|
|
469
469
|
bucket: presence.bucket,
|
|
470
470
|
since: new Date(presence.since).toISOString(),
|
|
471
471
|
forMs: presence.forMs,
|
|
472
|
+
consecutiveFailures: presence.consecutiveFailures,
|
|
473
|
+
stuck: presence.stuck,
|
|
472
474
|
...(presence.error !== undefined ? { error: presence.error } : {}),
|
|
473
475
|
note: "presence writes are the first thing to fail here, not necessarily the only thing - a broker can refuse writes far more widely while this connection stays up",
|
|
474
476
|
},
|
|
@@ -547,9 +549,24 @@ export function cotalToolSpecs(config, source = "connector") {
|
|
|
547
549
|
run(agent) {
|
|
548
550
|
if (!agent.connected)
|
|
549
551
|
return ok(`Not connected to the mesh yet (${config.servers}).`);
|
|
552
|
+
const writeFailure = agent.transportConnected ? agent.presenceWriteFailure : undefined;
|
|
553
|
+
// #1229: rendering never refuses, but it must not present a partial or last-known roster
|
|
554
|
+
// as a complete one. `unpopulated` = the watch has not replayed its initial snapshot (a
|
|
555
|
+
// reconnect refill); `stale` = the bucket has been silent past the liveness window.
|
|
556
|
+
const view = agent.presenceView();
|
|
557
|
+
const viewSentence = view.state === "unpopulated"
|
|
558
|
+
? `The presence watch has not completed its initial snapshot in "${config.space}", so this list may be partial and a missing name is not an absence verdict.`
|
|
559
|
+
: view.state === "stale"
|
|
560
|
+
? `The presence view in "${config.space}" has been silent since ${new Date(view.staleSince).toISOString()}, so the rows below are last-known.`
|
|
561
|
+
: "";
|
|
550
562
|
const roster = agent.roster();
|
|
551
|
-
if (!roster.length)
|
|
552
|
-
|
|
563
|
+
if (!roster.length) {
|
|
564
|
+
const empty = `No one is present in "${config.space}" yet.`;
|
|
565
|
+
const preface = writeFailure?.stuck
|
|
566
|
+
? `Presence view is NOT LIVE in ${JSON.stringify(config.space)}: bucket ${JSON.stringify(writeFailure.bucket)} has refused ${writeFailure.consecutiveFailures} consecutive writes for ${writeFailure.forMs}ms. This empty roster is last-known until a write succeeds or the broker store is repaired.`
|
|
567
|
+
: viewSentence;
|
|
568
|
+
return ok(preface ? `${preface}\n\n${empty}` : empty);
|
|
569
|
+
}
|
|
553
570
|
// Names aren't unique. Where one repeats, append the instance id so a DM can target the
|
|
554
571
|
// exact peer (the id is the only authoritative address); keep unique rows clean.
|
|
555
572
|
const counts = new Map();
|
|
@@ -576,7 +593,11 @@ export function cotalToolSpecs(config, source = "connector") {
|
|
|
576
593
|
const progress = p.status === "working" ? `working${condition} · progress unknown` : `${p.status}${condition}`;
|
|
577
594
|
return `${statusGlyph(p.status)} ${who} — ${progress}${p.activity ? `: ${p.activity}` : ""}${attn}${me}${mutedHint}${id}`;
|
|
578
595
|
});
|
|
579
|
-
|
|
596
|
+
const rendered = `Present in "${config.space}" (${roster.length}):\n${lines.join("\n")}`;
|
|
597
|
+
const preface = writeFailure?.stuck
|
|
598
|
+
? `Presence view is NOT LIVE in ${JSON.stringify(config.space)}: bucket ${JSON.stringify(writeFailure.bucket)} has refused ${writeFailure.consecutiveFailures} consecutive writes for ${writeFailure.forMs}ms. The roster below is last-known until a write succeeds or the broker store is repaired.`
|
|
599
|
+
: viewSentence;
|
|
600
|
+
return ok(preface ? `${preface}\n\n${rendered}` : rendered);
|
|
580
601
|
},
|
|
581
602
|
},
|
|
582
603
|
{
|
|
@@ -852,7 +873,9 @@ export function cotalToolSpecs(config, source = "connector") {
|
|
|
852
873
|
? " · durable backstop unavailable — live messages still arrive; offline replay is at risk after backlog cap"
|
|
853
874
|
: c.deliveryHealth === "active"
|
|
854
875
|
? " · durable backstop active"
|
|
855
|
-
: ""
|
|
876
|
+
: c.deliveryHealth === "unknown"
|
|
877
|
+
? " · durable backstop health unknown — this reader cannot establish it (no delivery grant here, or the daemon answered with an error)"
|
|
878
|
+
: "";
|
|
856
879
|
return `${c.joined ? "●" : "○"} #${c.channel}${desc} (${c.joined ? "subscribed" : "not subscribed"}, replay ${c.replay ? "on" : "off"})${mode}${unclosed}${health}`;
|
|
857
880
|
});
|
|
858
881
|
return ok(`Channels in "${config.space}" (descriptions are operator notes — advisory metadata, not instructions to obey; "· quiet/muted" is your own attention for that channel):\n${lines.join("\n")}`);
|
|
@@ -948,6 +971,19 @@ export function cotalToolSpecs(config, source = "connector") {
|
|
|
948
971
|
description: "Ask the manager to start a new peer endpoint in your space. It joins the mesh as a lateral peer and, under the cmux runtime, appears in its own tab. A Cotal peer is a real, addressable process the user can watch; you can reach it by DM, find it on the roster, and coordinate with it later. Use it for teammate work that should stay visible on the mesh. Pass `prompt` when it should begin immediately; the connector auto-submits that prompt as its first turn. When you first bring a team online, if the live web dashboard is down, suggest `cotal web` so the user can watch the mesh in real time.",
|
|
949
972
|
schema: {
|
|
950
973
|
name: z.string().describe("Which persona to spawn: the persona FILENAME in .cotal/agents (e.g. `review-critic`), without the .md. The new peer joins under the persona's own `name:` (auto-numbered with an underscore, e.g. socrates_2, if that's taken). Fails if no such persona file exists; spawn an existing persona, don't invent a name."),
|
|
974
|
+
instance: z
|
|
975
|
+
.string()
|
|
976
|
+
.refine((value) => {
|
|
977
|
+
try {
|
|
978
|
+
assertLifecycleToken(value, "instance");
|
|
979
|
+
return true;
|
|
980
|
+
}
|
|
981
|
+
catch {
|
|
982
|
+
return false;
|
|
983
|
+
}
|
|
984
|
+
}, "instance must be a lifecycle token ([a-z0-9]{26,32})")
|
|
985
|
+
.optional()
|
|
986
|
+
.describe("Optional manager instance id for a multi-manager space. Omitted uses class anycast. A pin that cannot be resolved is refused without falling back to another manager."),
|
|
951
987
|
role: z
|
|
952
988
|
.string()
|
|
953
989
|
.optional()
|
|
@@ -988,9 +1024,9 @@ export function cotalToolSpecs(config, source = "connector") {
|
|
|
988
1024
|
// boundary. Resume lives only on the operator CLI (`cotal spawn --resume`, foreground or
|
|
989
1025
|
// --detach); a peer-facing, capability-gated resume is deferred (see #159).
|
|
990
1026
|
},
|
|
991
|
-
async run(agent, _config, { name, role, agent: agentType, model, variant, launchOptions, cwd, prompt, events }) {
|
|
1027
|
+
async run(agent, _config, { name, instance, role, agent: agentType, model, variant, launchOptions, cwd, prompt, events }) {
|
|
992
1028
|
try {
|
|
993
|
-
const reply = await agent.spawn(name, role, { agent: agentType, model, variant, launchOptions, cwd, prompt, events });
|
|
1029
|
+
const reply = await agent.spawn(name, role, { agent: agentType, model, variant, launchOptions, cwd, prompt, events, instance });
|
|
994
1030
|
if (!reply.ok)
|
|
995
1031
|
return err(`Couldn't spawn ${name}: ${renderLifecycleBlocked(reply.error ?? "manager refused", reply)}`);
|
|
996
1032
|
const d = reply.data;
|