@cotal-ai/connector-core 0.48.2 → 0.50.0

package/dist/agent.d.ts

@@ -85,7 +85,17 @@ export interface ExactDrainResult {
  * NOT the same as `disconnected`, and it is not a stopped session either. `stopped` is terminal and
  * is not a fault at all.
  */
-export type ConnectionState = "ready" | "degraded" | "connecting" | "disconnected" | "stopped";
+export type ConnectionState = "ready" | "stalled" | "degraded" | "connecting" | "disconnected" | "stopped";
+/**
+ * How long a non-empty automatic queue may make no progress before this session stops calling
+ * itself `ready` (#1233).
+ *
+ * Generous on purpose. A healthy seat commits automatic deliveries within seconds of the turn that
+ * carries them, and the incident this bound exists for ran for HOURS: 27 deliveries held 13.8h
+ * behind timed-out soft interrupts, reported `ready` throughout. Ten minutes is far outside normal
+ * turn length and far inside the window in which an operator still has a healthy seat to save.
+ */
+export declare const AUTOMATIC_QUEUE_STALL_MS = 600000;
 export declare class MeshAgent extends EventEmitter {
     readonly ep: CotalEndpoint;
     readonly config: AgentConfig;
@@ -123,6 +133,22 @@ export declare class MeshAgent extends EventEmitter {
      *  This is measured only after the backing acknowledgements succeed, never inferred from a read
      *  attempt or from an empty inbox. */
     private _lastInboxDrainedAt?;
+    /** Wall-clock time of the latest drain that committed at least one AUTOMATIC delivery.
+     *
+     *  Deliberately separate from {@link _lastInboxDrainedAt}, and #1233 is why: on a host-mode
+     *  connector the tool inbox and the connector-managed automatic queue are different queues, and
+     *  the measured seat was draining the first every few minutes while the second had not moved in
+     *  13.8 hours. A progress mark that counts a pull-only drain as progress would have reported that
+     *  seat as making progress, which is the exact lie this field exists to refuse. */
+    private _lastAutomaticDrainedAt?;
+    /** The latest commit that took the OLDEST automatic delivery then queued (#1526).
+     *
+     *  Distinct from {@link _lastAutomaticDrainedAt}, and the distinction is the defect: any automatic
+     *  commit used to count, so a seat that kept committing fresh arrivals over a head it could not
+     *  deliver reset its own stall clock on every turn and reported `ready` indefinitely, while the
+     *  entries at the front of its queue aged past two hours. A queue drains when its head moves; a
+     *  queue that serves only its newest arrivals is not draining, it is skipping. */
+    private _lastAutomaticHeadDrainedAt?;
     /** Latest connection failure, retained until the endpoint binds so a bounded readiness gate can
      * explain why an otherwise healthy host never joined the mesh. */
     private lastConnectionError?;
@@ -172,15 +198,73 @@ export declare class MeshAgent extends EventEmitter {
     get transportConnected(): boolean;
     /** Latest pre-bind failure. A successful bind clears it; stop preserves it for post-mortem diagnosis. */
     get connectionIssue(): string | undefined;
+    /** #1356: the space's presence bucket has been refusing writes since this time, or `undefined`.
+     *
+     *  Deliberately NOT folded into {@link connectionIssue}. That field has a defined relationship to
+     *  readiness which existing callers already read, and a bound endpoint surviving refused heartbeats
+     *  IS still ready — the neighbouring decision at the `warning` listener is correct and stands. This
+     *  is a distinct fact that can be true at the same time as `ready`, which is the actual shape of the
+     *  incident: connected, serving, and silently unable to publish presence.
+     *
+     *  Presence writes are the CANARY, not the scope — see CotalEndpoint.presenceWriteFailure. */
+    get presenceWriteFailure(): {
+        since: number;
+        forMs: number;
+        error?: string;
+        bucket: string;
+    } | undefined;
     /** The latest successful, non-empty inbox drain in this session. */
     get lastInboxDrainedAt(): number | undefined;
+    /** The latest drain that committed at least one AUTOMATIC (connector-managed) delivery. */
+    get lastAutomaticDrainedAt(): number | undefined;
+    /** The latest drain that committed the automatic delivery that was then at the FRONT of the queue
+     *  (#1526). This is the fact {@link automaticQueueStalledForMs} measures progress by; the looser
+     *  {@link lastAutomaticDrainedAt} is still reported beside it, because the two disagreeing is
+     *  precisely the shape of a wedged head being served around. */
+    get lastAutomaticHeadDrainedAt(): number | undefined;
+    /** The receive key of the oldest still-queued automatic delivery: the queue's head, and the entry
+     *  whose commit counts as progress. */
+    private oldestAutomaticKey;
+    /** Record head progress when this batch takes the current head of the automatic queue. Call
+     *  BEFORE the batch leaves {@link inbox}, since the head is read from the live queue. */
+    private noteAutomaticHeadProgress;
+    /**
+     * How long a non-empty automatic queue has been making no progress, or `undefined`.
+     *
+     * PROGRESS AT THE HEAD, not depth and not throughput. The queue is not stalled because it is deep;
+     * it is stalled because the entries at the front of it are not coming off. The clock therefore
+     * starts at the later of the arrival of the oldest still-queued delivery and the last commit that
+     * took the queue's head, so a seat that is steadily draining keeps resetting it however busy it
+     * is, and a seat that has not moved its head since that queue formed accrues from the moment it
+     * formed.
+     *
+     * Keyed on the HEAD rather than on any automatic commit (#1526). The reported session held 96
+     * deliveries with the oldest over two hours old and reported `ready` throughout: it was committing
+     * fresh arrivals, and under a looser measure each of those reset the clock for the backlog behind
+     * them. A seat that serves only its newest traffic is skipping its queue, not draining it, and the
+     * messages that are actually undelivered are the ones the measure must speak for.
+     *
+     * Measured from the oldest ARRIVAL rather than from session start so a session that never drained
+     * anything is still measurable — that is precisely the shape of a seat whose first soft interrupt
+     * timed out.
+     */
+    automaticQueueStalledForMs(now?: number): number | undefined;
     /** Whether {@link stop} has been called. Terminal, and never cleared: a stopped session does not
      *  serve again. This is the ONLY way to tell a deliberate shutdown from a lost connection, because
      *  `stop()` clears readiness and transport together, so those two read identically in both cases. */
     get stopping(): boolean;
     /** The three liveness facts combined, in one place. Every combination maps, so a caller never has
      *  to guess what an unlisted pair means, and a caller that disagrees with this reading can still
-     *  read {@link connected}, {@link transportConnected} and {@link stopping} directly. */
+     *  read {@link connected}, {@link transportConnected} and {@link stopping} directly.
+     *
+     *  `stalled` is the fourth fact and it is not about the connection at all — see
+     *  {@link automaticQueueStalledForMs}. It is reported HERE, ahead of `ready`, because #1233 was
+     *  not a caller misreading the facts: a seat holding 27 undeliverable messages for 13.8 hours
+     *  answered this question with `ready`, and every operator who asked it was told the seat was
+     *  fine. A status that reads healthy while the thing it describes is not happening is the defect,
+     *  so the one word a caller acts on has to move. It is ordered below `degraded` deliberately: a
+     *  dead socket is the more specific and more actionable fault, and reporting the queue symptom
+     *  over its own cause would hide it. */
     get connectionState(): ConnectionState;
     /** Wait for the endpoint's real post-bind connection signal. `start()` deliberately stays
      * background for connectors whose MCP surface must boot while the broker is absent; a host that
@@ -552,6 +636,11 @@ export declare class MeshAgent extends EventEmitter {
         name: string;
         prompt: string;
         model?: string;
+        role?: string;
+        agent?: string;
+        subscribe?: string[];
+        allowSubscribe?: string[];
+        allowPublish?: string[];
         announce?: string;
     }): Promise<ControlReply & {
         announceError?: string;

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}

package/dist/agent.js

@@ -100,6 +100,16 @@ function sleep(ms) {
 function ingestDedupKey(id) {
     return id === "" ? undefined : id;
 }
+/**
+ * How long a non-empty automatic queue may make no progress before this session stops calling
+ * itself `ready` (#1233).
+ *
+ * Generous on purpose. A healthy seat commits automatic deliveries within seconds of the turn that
+ * carries them, and the incident this bound exists for ran for HOURS: 27 deliveries held 13.8h
+ * behind timed-out soft interrupts, reported `ready` throughout. Ten minutes is far outside normal
+ * turn length and far inside the window in which an operator still has a healthy seat to save.
+ */
+export const AUTOMATIC_QUEUE_STALL_MS = 600_000;
 /** An `ask` relayed as a turn: the record the run needs, the attempt it is on, the previous
  *  refusal when there was one, and the command that answers it (`cotal run answer`, the same door
  *  a checkpoint is answered through). Empty when the payload carries no ask. */
@@ -171,6 +181,22 @@ export class MeshAgent extends EventEmitter {
      *  This is measured only after the backing acknowledgements succeed, never inferred from a read
      *  attempt or from an empty inbox. */
     _lastInboxDrainedAt;
+    /** Wall-clock time of the latest drain that committed at least one AUTOMATIC delivery.
+     *
+     *  Deliberately separate from {@link _lastInboxDrainedAt}, and #1233 is why: on a host-mode
+     *  connector the tool inbox and the connector-managed automatic queue are different queues, and
+     *  the measured seat was draining the first every few minutes while the second had not moved in
+     *  13.8 hours. A progress mark that counts a pull-only drain as progress would have reported that
+     *  seat as making progress, which is the exact lie this field exists to refuse. */
+    _lastAutomaticDrainedAt;
+    /** The latest commit that took the OLDEST automatic delivery then queued (#1526).
+     *
+     *  Distinct from {@link _lastAutomaticDrainedAt}, and the distinction is the defect: any automatic
+     *  commit used to count, so a seat that kept committing fresh arrivals over a head it could not
+     *  deliver reset its own stall clock on every turn and reported `ready` indefinitely, while the
+     *  entries at the front of its queue aged past two hours. A queue drains when its head moves; a
+     *  queue that serves only its newest arrivals is not draining, it is skipping. */
+    _lastAutomaticHeadDrainedAt;
     /** Latest connection failure, retained until the endpoint binds so a bounded readiness gate can
      * explain why an otherwise healthy host never joined the mesh. */
     lastConnectionError;
@@ -230,6 +256,7 @@ export class MeshAgent extends EventEmitter {
             pass: config.pass,
             creds: config.creds,
             lifecycleUid: config.lifecycleUid,
+            acceptedToken: config.acceptedToken,
             // USER MODE: the endpoint execs the spawner-provided argv per bearer refresh — the exchange
             // protocol lives entirely behind that command, this runtime just runs it and reads a line.
             bearer: config.userAuth ? () => execBearerCmd(config.userAuth.bearerCmd) : undefined,
@@ -302,10 +329,82 @@ export class MeshAgent extends EventEmitter {
     get connectionIssue() {
         return this.lastConnectionError;
     }
+    /** #1356: the space's presence bucket has been refusing writes since this time, or `undefined`.
+     *
+     *  Deliberately NOT folded into {@link connectionIssue}. That field has a defined relationship to
+     *  readiness which existing callers already read, and a bound endpoint surviving refused heartbeats
+     *  IS still ready — the neighbouring decision at the `warning` listener is correct and stands. This
+     *  is a distinct fact that can be true at the same time as `ready`, which is the actual shape of the
+     *  incident: connected, serving, and silently unable to publish presence.
+     *
+     *  Presence writes are the CANARY, not the scope — see CotalEndpoint.presenceWriteFailure. */
+    get presenceWriteFailure() {
+        return this.ep.presenceWriteFailure();
+    }
     /** The latest successful, non-empty inbox drain in this session. */
     get lastInboxDrainedAt() {
         return this._lastInboxDrainedAt;
     }
+    /** The latest drain that committed at least one AUTOMATIC (connector-managed) delivery. */
+    get lastAutomaticDrainedAt() {
+        return this._lastAutomaticDrainedAt;
+    }
+    /** The latest drain that committed the automatic delivery that was then at the FRONT of the queue
+     *  (#1526). This is the fact {@link automaticQueueStalledForMs} measures progress by; the looser
+     *  {@link lastAutomaticDrainedAt} is still reported beside it, because the two disagreeing is
+     *  precisely the shape of a wedged head being served around. */
+    get lastAutomaticHeadDrainedAt() {
+        return this._lastAutomaticHeadDrainedAt;
+    }
+    /** The receive key of the oldest still-queued automatic delivery: the queue's head, and the entry
+     *  whose commit counts as progress. */
+    oldestAutomaticKey() {
+        let head;
+        for (const pending of this.inbox) {
+            if (pending.pullOnly)
+                continue;
+            if (head === undefined || pending.receivedAt < head.receivedAt)
+                head = pending;
+        }
+        return head?.item.recvKey;
+    }
+    /** Record head progress when this batch takes the current head of the automatic queue. Call
+     *  BEFORE the batch leaves {@link inbox}, since the head is read from the live queue. */
+    noteAutomaticHeadProgress(selected) {
+        const head = this.oldestAutomaticKey();
+        if (head === undefined)
+            return;
+        if (selected.some((p) => !p.pullOnly && p.item.recvKey === head))
+            this._lastAutomaticHeadDrainedAt = Date.now();
+    }
+    /**
+     * How long a non-empty automatic queue has been making no progress, or `undefined`.
+     *
+     * PROGRESS AT THE HEAD, not depth and not throughput. The queue is not stalled because it is deep;
+     * it is stalled because the entries at the front of it are not coming off. The clock therefore
+     * starts at the later of the arrival of the oldest still-queued delivery and the last commit that
+     * took the queue's head, so a seat that is steadily draining keeps resetting it however busy it
+     * is, and a seat that has not moved its head since that queue formed accrues from the moment it
+     * formed.
+     *
+     * Keyed on the HEAD rather than on any automatic commit (#1526). The reported session held 96
+     * deliveries with the oldest over two hours old and reported `ready` throughout: it was committing
+     * fresh arrivals, and under a looser measure each of those reset the clock for the backlog behind
+     * them. A seat that serves only its newest traffic is skipping its queue, not draining it, and the
+     * messages that are actually undelivered are the ones the measure must speak for.
+     *
+     * Measured from the oldest ARRIVAL rather than from session start so a session that never drained
+     * anything is still measurable — that is precisely the shape of a seat whose first soft interrupt
+     * timed out.
+     */
+    automaticQueueStalledForMs(now = Date.now()) {
+        const oldest = this.oldestAutomaticReceivedAt();
+        if (oldest === undefined)
+            return undefined;
+        const since = Math.max(oldest, this._lastAutomaticHeadDrainedAt ?? 0);
+        const held = now - since;
+        return held > 0 ? held : 0;
+    }
     /** Whether {@link stop} has been called. Terminal, and never cleared: a stopped session does not
      *  serve again. This is the ONLY way to tell a deliberate shutdown from a lost connection, because
      *  `stop()` clears readiness and transport together, so those two read identically in both cases. */
@@ -314,12 +413,25 @@ export class MeshAgent extends EventEmitter {
     }
     /** The three liveness facts combined, in one place. Every combination maps, so a caller never has
      *  to guess what an unlisted pair means, and a caller that disagrees with this reading can still
-     *  read {@link connected}, {@link transportConnected} and {@link stopping} directly. */
+     *  read {@link connected}, {@link transportConnected} and {@link stopping} directly.
+     *
+     *  `stalled` is the fourth fact and it is not about the connection at all — see
+     *  {@link automaticQueueStalledForMs}. It is reported HERE, ahead of `ready`, because #1233 was
+     *  not a caller misreading the facts: a seat holding 27 undeliverable messages for 13.8 hours
+     *  answered this question with `ready`, and every operator who asked it was told the seat was
+     *  fine. A status that reads healthy while the thing it describes is not happening is the defect,
+     *  so the one word a caller acts on has to move. It is ordered below `degraded` deliberately: a
+     *  dead socket is the more specific and more actionable fault, and reporting the queue symptom
+     *  over its own cause would hide it. */
     get connectionState() {
         if (this._stopping)
             return "stopped";
-        if (this._connected)
-            return this._transportConnected ? "ready" : "degraded";
+        if (this._connected) {
+            if (!this._transportConnected)
+                return "degraded";
+            const held = this.automaticQueueStalledForMs();
+            return held !== undefined && held >= AUTOMATIC_QUEUE_STALL_MS ? "stalled" : "ready";
+        }
         return this._transportConnected ? "connecting" : "disconnected";
     }
     /** Wait for the endpoint's real post-bind connection signal. `start()` deliberately stays
@@ -382,7 +494,26 @@ export class MeshAgent extends EventEmitter {
                 if (this._stopping)
                     return;
                 this.lastConnectionError = error.message;
-                this.log(`mesh unreachable (${error.message}); retrying in ${retryMs}ms`);
+                // #1356: "mesh unreachable" was asserted unconditionally, including while this same object
+                // held `transportConnected: true` — measured against a presence bucket whose writes the
+                // broker refuses: broker up, TCP connected, every sibling stream writable, and the operator
+                // told the mesh was down. An anonymous error makes an operator look; a wrong one makes them
+                // look in the wrong place. Both facts are already here, so report the one that is true.
+                // The presence sentence CLAIMS the transport is fine, so it is reachable only while a live
+                // transport observation says so. The endpoint clears the record whenever a connection is torn
+                // down, which is the primary guard; this is the second one, for a transport that drops without
+                // a teardown running. Belt and braces, because the failure this replaced was a confident wrong
+                // answer and the cost of one redundant check is lower than the cost of another.
+                const presence = this._transportConnected ? this.ep.presenceWriteFailure() : undefined;
+                // "for 0s" on the first retry read like a broken template. Report a sub-second age as "<1s"
+                // rather than rounding it up to a duration that has not elapsed yet.
+                const forS = presence === undefined ? "" : presence.forMs < 1000 ? "<1" : String(Math.round(presence.forMs / 1000));
+                const diagnosis = presence
+                    ? `connected, but this space's presence bucket "${presence.bucket}" has refused every write for ${forS}s (${presence.error ?? error.message}) - the transport is fine and the fault is not the network`
+                    : this._transportConnected
+                        ? `transport is connected but the mesh bind did not complete (${error.message})`
+                        : `mesh unreachable (${error.message})`;
+                this.log(`${diagnosis}; retrying in ${retryMs}ms`);
                 await sleep(retryMs);
             }
         }
@@ -420,7 +551,19 @@ export class MeshAgent extends EventEmitter {
         try {
             await this.ep.reconnect();
             // _connected is set by the endpoint's "connection" event on the successful rebind, not here.
-            return { ok: true, message: `Reconnected ✓ (${this.config.name}@${this.config.space})` };
+            //
+            // #1233: a rebuilt connection is NOT a served queue. The measured seat's transport was up the
+            // whole time, so this call rebound a connection that was never broken and answered
+            // "Reconnected ✓" over 27 deliveries it had not touched — a recovery path reporting success
+            // while doing nothing, which sent the operator looking for a different remedy. The rebind is
+            // still reported honestly as a success, because it succeeded; what is added is the fact that
+            // makes the reply actionable, from the same measurement the state uses.
+            const held = this.automaticQueueStalledForMs();
+            const queued = this.inboxCount("automatic");
+            const stalled = held !== undefined && held >= AUTOMATIC_QUEUE_STALL_MS && queued > 0
+                ? ` Note: this session's ${queued} queued automatic ${queued === 1 ? "delivery has" : "deliveries have"} made no progress for ${Math.round(held / 60_000)} minutes. Reconnecting did not deliver ${queued === 1 ? "it" : "them"}: the connection was not what was holding ${queued === 1 ? "it" : "them"} up.`
+                : "";
+            return { ok: true, message: `Reconnected ✓ (${this.config.name}@${this.config.space})${stalled}` };
         }
         catch (e) {
             return { ok: false, message: `Reconnect failed: ${e.message}. Still retrying automatically — or run /reconnect to retry now.` };
@@ -738,14 +881,23 @@ export class MeshAgent extends EventEmitter {
         const eligible = this.inbox.filter((p) => this.inScope(p, scope));
         const n = limit && limit > 0 ? Math.min(limit, eligible.length) : eligible.length;
         const selected = eligible.slice(0, n);
+        // Head progress is read from the LIVE queue, so it must be recorded while the batch is still in
+        // it (#1526).
+        this.noteAutomaticHeadProgress(selected);
         // Remove by OBJECT IDENTITY, not by a set of wire ids (#624): the id-less entries share "", so
         // an id set would remove every id-less neighbor beyond the limit and outside the scope while
         // acking only the selected — silent loss by selection. Identity removes exactly what was taken.
         const taken = new Set(selected);
         this.inbox = this.inbox.filter((p) => !taken.has(p));
+        const automatic = selected.some((p) => !p.pullOnly);
         const items = this.commitPending(selected);
         if (items.length)
             this._lastInboxDrainedAt = Date.now();
+        // Automatic progress is recorded from the SELECTED entries' own classification, not from the
+        // returned items: `commitPending` returns `InboxItem`s, which do not carry `pullOnly`, and
+        // counting a pull-only drain as automatic progress is the #1233 lie in miniature.
+        if (items.length && automatic)
+            this._lastAutomaticDrainedAt = Date.now();
         return items;
     }
     /** Ack exact surfaced deliveries without assuming they still form the physical inbox prefix.
@@ -759,6 +911,7 @@ export class MeshAgent extends EventEmitter {
         const requested = [...new Set(keys)];
         const wanted = new Set(requested);
         const selected = this.inbox.filter((p) => wanted.has(p.item.recvKey));
+        this.noteAutomaticHeadProgress(selected);
         const present = new Set(selected.map((p) => p.item.recvKey));
         const pullOnly = new Map(selected.map((p) => [p.item.recvKey, p.pullOnly]));
         for (const id of requested) {
@@ -767,9 +920,12 @@ export class MeshAgent extends EventEmitter {
                 pullOnly.set(id, remembered.pullOnly);
         }
         this.inbox = this.inbox.filter((p) => !present.has(p.item.recvKey));
+        const automatic = selected.some((p) => !p.pullOnly);
         const items = this.commitPending(selected);
         if (items.length)
             this._lastInboxDrainedAt = Date.now();
+        if (items.length && automatic)
+            this._lastAutomaticDrainedAt = Date.now();
         for (const id of requested) {
             // A MINTED key (an id-less delivery) is never handled-authority: its wire id is "", which
             // markHandled already refuses, so skipping it here is the same at-least-once stance rather
@@ -1468,8 +1624,18 @@ export class MeshAgent extends EventEmitter {
             if (!isConcreteChannel(def.announce))
                 throw new Error(`announce: "${def.announce}" is a wildcard — announce to one concrete channel`);
         }
-        // role is policy — set at spawn, never via definePersona; the manager ignores it regardless.
-        const args = { name: def.name, model: def.model, persona: def.prompt };
+        // Explicit role / agent / grants ride with the prompt. A leading frontmatter block in `prompt`
+        // is merged by the manager (this layer forwards the fields; it does not wrap).
+        const args = {
+            name: def.name,
+            model: def.model,
+            persona: def.prompt,
+            role: def.role,
+            agent: def.agent,
+            subscribe: def.subscribe,
+            allowSubscribe: def.allowSubscribe,
+            allowPublish: def.allowPublish,
+        };
         const reply = await this.managerInvoke("define-persona", args);
         if (!reply.ok || !def.announce)
             return reply;