charness 3.6.1 → 3.8.0

package/dist/trackers/taskAgentSlots.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskAgentSlots = exports.taskAgentStartFailureLimit = void 0;
+const sessionKey_1 = require("../sessionKey");
+const taskAgentLimit_1 = require("./taskAgentLimit");
+/**
+ * @description The slots of the tracker task agents (decision D10): ONE cap for the whole bot on how many tracker
+ * conversations are working on a hand-over at once, and ONE persisted FIFO list of those that wait for a slot. The cap
+ * itself is `taskAgentLimit.ts`; this module is the bookkeeping behind it.
+ *
+ * A slot is a tracker CONVERSATION with an OPEN hand-over request (origin `trackerEvent`) — one agent, however many people's
+ * hand-overs it holds at once; a mention request (answer only) never takes one. The slots in use are read off the request
+ * ledger on every question, so nothing about them is stored: a request that closes — an answer, a cancel — frees its slot at
+ * once, and a restart cannot get the count wrong. A request the wake-up engine gave up on (`isWakeStopped`: the alert is out
+ * and the issue handed back) is not an agent at work and holds no slot either.
+ *
+ * A connector asks {@link TaskAgentSlots.checkIn} before it opens a hand-over request. `granted` — it may open it now, and the
+ * slot is RESERVED until the connector says the request is open ({@link TaskAgentSlots.noteStarted}) or gave up
+ * ({@link TaskAgentSlots.noteStartFailed}), so two connectors polling at once never share the last free slot. `queued` — no
+ * slot is free (or someone waits ahead): the conversation joins the list, oldest first, and asks again at its next poll. It is
+ * granted only when it is within the free slots counted from the HEAD of the list, so the order of the list is the order of
+ * the starts, whatever order a poll happens to return the issues in.
+ *
+ * A place whose last start FAILED (the issue could not be fetched, the folder not bound) does not count as ahead of the places
+ * behind it, so one broken issue never holds the others up; after {@link taskAgentStartFailureLimit} failed starts in a row it
+ * moves to the end of the list.
+ */
+/** The request origin that holds a slot. */
+const slotHoldingOriginKind = 'trackerEvent';
+/** How many starts of one waiting issue may fail in a row before it moves to the end of the wait list. */
+exports.taskAgentStartFailureLimit = 3;
+class TaskAgentSlots {
+    deps;
+    now;
+    /** Conversations a `granted` answer was given to and whose request is not open yet; memory only. */
+    reservedConversationKeys = new Set();
+    /** Per waiting conversation, how many starts failed in a row (absent = none); memory only, so a restart gives every place a fresh start. */
+    failedStartCounts = new Map();
+    /** The cap as the last read saw it; `null` before the first read. */
+    lastReadMaxConcurrent = null;
+    slotFreedListeners = new Set();
+    constructor(deps) {
+        this.deps = deps;
+        this.now = deps.now ?? Date.now;
+    }
+    /** The conversations that hold a slot now: an open, not given-up hand-over request, or a reservation. */
+    getOccupiedConversationKeys() {
+        const occupied = new Set(this.reservedConversationKeys);
+        for (const { key, request } of this.deps.ledger.listOpenRequests()) {
+            if (request.origin.kind === slotHoldingOriginKind && !request.isWakeStopped)
+                occupied.add((0, sessionKey_1.keyToString)(key));
+        }
+        return occupied;
+    }
+    /** The wait list without the conversations that hold a slot already (a start whose entry was not dropped yet). */
+    getWaitingEntries(occupied) {
+        return this.deps.store.getTaskAgentWaitList().filter((entry) => !occupied.has(entry.conversationKey));
+    }
+    /**
+     * @description May `key`'s conversation open a hand-over request now? `triggerId` names the hand-over for the logs. A
+     * conversation that holds a slot already — a newer hand-over of the same issue supersedes its open request — needs no new one.
+     * A `queued` answer that changes the list (a new place, a newer trigger) saves it, flushed: a restart right after keeps the place.
+     */
+    async checkIn(key, triggerId) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        // A check-in is made by the poll that deals with every waiting issue, so a raised cap needs no wake-up here.
+        const maxConcurrent = this.readMaxConcurrent(false);
+        const occupied = this.getOccupiedConversationKeys();
+        const waiting = this.getWaitingEntries(occupied);
+        const ownIndex = waiting.findIndex((entry) => entry.conversationKey === conversationKey);
+        const placesAhead = ownIndex === -1 ? waiting : waiting.slice(0, ownIndex);
+        // A place whose last start failed does not hold up the ones behind it.
+        const position = placesAhead.filter((entry) => !this.failedStartCounts.has(entry.conversationKey)).length;
+        const freeCount = maxConcurrent === taskAgentLimit_1.taskAgentsNoLimit ? Number.POSITIVE_INFINITY : maxConcurrent - occupied.size;
+        if (occupied.has(conversationKey) || position < freeCount) {
+            this.reservedConversationKeys.add(conversationKey);
+            return { kind: 'granted' };
+        }
+        const isNewlyQueued = ownIndex === -1;
+        let isListChanged = isNewlyQueued;
+        if (isNewlyQueued) {
+            waiting.push({ conversationKey, triggerId, queuedAt: this.now() });
+        }
+        else if (waiting[ownIndex].triggerId !== triggerId) {
+            // A newer hand-over of the issue replaces the waiting one and keeps its place.
+            waiting[ownIndex] = { ...waiting[ownIndex], triggerId };
+            isListChanged = true;
+        }
+        // Every poll asks again for a waiting issue: only a change is written.
+        if (isListChanged) {
+            this.deps.store.setTaskAgentWaitList(waiting);
+            await this.deps.store.flush();
+        }
+        return { kind: 'queued', isNewlyQueued, aheadCount: position, maxConcurrent };
+    }
+    /** @description The granted conversation's request is open (and counted by the ledger now): drop the reservation and its place in the list. */
+    noteStarted(key) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        this.reservedConversationKeys.delete(conversationKey);
+        this.removeWaiting((entry) => entry.conversationKey === conversationKey);
+    }
+    /**
+     * @description The granted conversation could not open its request: the slot goes back and a place in the list (if any) stays, but
+     * the place no longer holds up the ones behind it. The {@link taskAgentStartFailureLimit}th failure in a row moves it to the end
+     * of the list (logged once) and gives it a fresh start there. A conversation with no place has nothing to move: it asks again at its next poll.
+     */
+    noteStartFailed(key) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        this.reservedConversationKeys.delete(conversationKey);
+        const waitList = this.deps.store.getTaskAgentWaitList();
+        const place = waitList.find((entry) => entry.conversationKey === conversationKey);
+        if (!place)
+            return;
+        const failedCount = (this.failedStartCounts.get(conversationKey) ?? 0) + 1;
+        if (failedCount < exports.taskAgentStartFailureLimit) {
+            this.failedStartCounts.set(conversationKey, failedCount);
+            return;
+        }
+        this.failedStartCounts.delete(conversationKey);
+        this.deps.store.setTaskAgentWaitList([...waitList.filter((entry) => entry !== place), place]);
+        console.warn(`[tasks] ${conversationKey} failed to start ${exports.taskAgentStartFailureLimit} times in a row; it moves to the end of the wait list`);
+    }
+    /** @description The conversation no longer waits (its hand-over was withdrawn, refused or handled another way): drop its place. */
+    dropWaiting(key) {
+        const conversationKey = (0, sessionKey_1.keyToString)(key);
+        this.removeWaiting((entry) => entry.conversationKey === conversationKey);
+    }
+    /**
+     * @description Drop the places of `platform`'s conversations that `checkIsStillWaiting` no longer vouches for — a connector's
+     * poll calls it after a complete poll with what it found (an issue that left the hand-over statuses is no longer waiting).
+     */
+    pruneWaiting(platform, checkIsStillWaiting) {
+        this.removeWaiting((entry) => {
+            const key = (0, sessionKey_1.tryKeyFromString)(entry.conversationKey);
+            return key !== null && key.platform === platform && !checkIsStillWaiting(key);
+        });
+    }
+    /** @description Drop the places of conversations nobody in this process serves any more (a connector taken out of `CONNECTORS`): they could never start and would hold up the others. */
+    dropUnserved(checkIsServed) {
+        this.removeWaiting((entry) => {
+            const key = (0, sessionKey_1.tryKeyFromString)(entry.conversationKey);
+            return key === null || !checkIsServed(key);
+        });
+    }
+    removeWaiting(checkIsRemoved) {
+        const waitList = this.deps.store.getTaskAgentWaitList();
+        const kept = waitList.filter((entry) => !checkIsRemoved(entry));
+        if (kept.length === waitList.length)
+            return;
+        for (const entry of waitList) {
+            if (checkIsRemoved(entry))
+                this.failedStartCounts.delete(entry.conversationKey);
+        }
+        this.deps.store.setTaskAgentWaitList(kept);
+    }
+    /**
+     * @description The cap, the conversations working and the conversations waiting. Reading the cap here notices a raise like any read
+     * outside a poll (see {@link TaskAgentSlots.noteLimitMayHaveChanged}).
+     */
+    getStatus() {
+        const maxConcurrent = this.readMaxConcurrent(true);
+        const occupied = this.getOccupiedConversationKeys();
+        return { maxConcurrent, runningCount: occupied.size, waitingCount: this.getWaitingEntries(occupied).length };
+    }
+    /**
+     * The cap in force. `isWakingOnRaise`: when it went up since the last read and somebody waits, the listeners are woken — a raise
+     * is room for the waiting issues, found by whoever reads it first (the `/task_agents` screen, a hand edit of `settings.json`).
+     */
+    readMaxConcurrent(isWakingOnRaise) {
+        const maxConcurrent = this.deps.getMaxConcurrent();
+        const previous = this.lastReadMaxConcurrent;
+        this.lastReadMaxConcurrent = maxConcurrent;
+        if (isWakingOnRaise && previous !== null && (0, taskAgentLimit_1.checkIsTaskAgentLimitRaised)(previous, maxConcurrent))
+            this.wakeListenersWhileWaiting();
+        return maxConcurrent;
+    }
+    /**
+     * @description The cap may have changed — General's value was just written: read it, and wake the listeners when it went up while
+     * somebody waits. A hand edit of `settings.json` is noticed the same way, by the first read that is not a poll's own check-in.
+     */
+    noteLimitMayHaveChanged() {
+        this.readMaxConcurrent(true);
+    }
+    /**
+     * @description Be told when a slot may have freed while someone waits for one (a connector polls again at once, instead of at
+     * its next interval). Returns the function that stops the listening.
+     */
+    onSlotFreed(listener) {
+        this.slotFreedListeners.add(listener);
+        return () => {
+            this.slotFreedListeners.delete(listener);
+        };
+    }
+    /**
+     * @description The request ledger's word that a request closed: a hand-over that is not merely replaced by a newer one of its
+     * conversation may have freed a slot, which wakes the listeners — only while somebody waits. It runs inside the ledger's own
+     * close, so the listeners get the news, not the state: they act after the close completed.
+     */
+    noteRequestClosed(closed) {
+        if (closed.origin.kind !== slotHoldingOriginKind || closed.closeReason === 'superseded')
+            return;
+        this.wakeListenersWhileWaiting();
+    }
+    /**
+     * @description The request ledger's word that the wake-up engine gave up on a request (it stays open, but holds no slot any more):
+     * the same wake-up as a close.
+     */
+    noteRequestWakeStopped(request) {
+        if (request.origin.kind !== slotHoldingOriginKind)
+            return;
+        this.wakeListenersWhileWaiting();
+    }
+    wakeListenersWhileWaiting() {
+        if (this.deps.store.getTaskAgentWaitList().length === 0)
+            return;
+        for (const listener of this.slotFreedListeners) {
+            try {
+                listener();
+            }
+            catch (error) {
+                console.warn(`[tasks] a slot listener failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+    }
+}
+exports.TaskAgentSlots = TaskAgentSlots;
+//# sourceMappingURL=taskAgentSlots.js.map

package/dist/trackers/taskAgentSlots.js.map

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

package/dist/trackers/types.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @name TaskAgentWaitEntry
+ * @description One tracker conversation waiting for a slot (`taskAgentSlots.ts`), as persisted in `state.json`
+ * `taskAgentWaitList`: oldest first, one entry per conversation.
+ */
+export interface TaskAgentWaitEntry {
+    /** The conversation's serialized `SessionKey`. */
+    conversationKey: string;
+    /** The tracker's id of the hand-over that is waiting (the connector's trigger id), for the logs. */
+    triggerId: string;
+    /** Epoch ms the conversation joined the list. */
+    queuedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/trackers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/trackers/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/trackers/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/trackers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/trackers/types.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -232,6 +232,38 @@ export interface PendingQuestionState {
     answers: (string[] | null)[];
     /** Index into `data.questions` of the question currently on screen. */
     currentIndex: number;
+    /**
+     * The message the question on screen (`currentIndex`) was FIRST asked in: the record that stays in the topic, with its text
+     * and «asked again below», however often the question is put at the bottom again — a copy an earlier re-post made is deleted
+     * when the next one lands, so a waiting question leaves the original and the live copy. Kept here, in the saved state, so a
+     * restart does not lose which message is the original. Empty until the question is posted, cleared when the question
+     * advances to the next one, and absent in a state that predates it (the message found then is taken for the original,
+     * which is never deleted).
+     */
+    originalMessageId?: number | null;
+}
+/**
+ * @description A question the idle compaction re-asked (D1), as it is kept across a bot restart: the id of the message
+ * that carries its `reask_<i>` buttons and the question they answer. Kept so those buttons still work after a restart
+ * while the conversation sleeps, and so a restart that finds the conversation released can close the message.
+ *
+ * It is saved from the moment the idle compaction starts, when the re-ask is not posted yet: `isPosted: false`, and
+ * `messageId` is then the message the question waited in (its buttons are off, and it has no result yet). A restart that
+ * finds such a record asks the question again when the conversation can still be resumed (the old message then says «asked
+ * again below»), and closes that message as unanswered when it is gone.
+ */
+export interface ReAskedQuestionRecord {
+    messageId: number;
+    question: OpenCodeQuestion;
+    /** `false` while the re-ask is not posted yet; absent once it is. */
+    isPosted?: boolean;
+    /**
+     * Of a posted re-ask: the message the question waited in, which the copy replaces, and whether its result («asked again
+     * below») has LANDED. The post is saved before that edit is made, so a restart between the two finds the old message
+     * without a note and finishes it.
+     */
+    predecessorMessageId?: number | null;
+    isPredecessorClosed?: boolean;
 }
 /**
  * @description Classification of a provider-side API error surfaced by either
@@ -262,6 +294,12 @@ export interface AgentApiErrorClass {
      * wait-for-reset: the bot marks the account exhausted until the operator acts and moves along the fallback chain.
      */
     isBalanceExhausted?: boolean;
+    /**
+     * The error was read while an adopted session replayed the tail its process wrote while the bot was down: it ended a
+     * turn BEFORE this bot started, not just now. The boot recovery owns such an episode (it reads the error's own time off
+     * the transcript, where the replay can only read the clock); the bot must not handle its replayed copy again.
+     */
+    isReplayed?: boolean;
 }
 /**
  * @description The bot's per-thread record of an armed auto-retry after a
@@ -693,6 +731,20 @@ export interface AgentAdapter extends EventEmitter {
      * tmux TUI and OpenCode are never auto-stopped (L-D8).
      */
     suspendSession?(key: SessionKey): Promise<void>;
+    /**
+     * @description {@link stopSession}, resolving once the stop is DONE: the process gone and the session dropped, so
+     * `checkIsActive` is false and a start under the same key finds nothing running. Optional: a backend whose `stopSession`
+     * already finishes at once (or only queues its teardown) omits it. `/quit` waits on it before it says «stopped».
+     */
+    stopSessionAndWait?(key: SessionKey): Promise<void>;
+    /**
+     * @description Resolves once an ADOPTED session (one that outlived a bot restart) has replayed what its process wrote
+     * while the bot was down — at once for any other session. A prompt forwarded before that would reset the answer and
+     * error state the replayed frames still use. Optional: only the json-stream Claude backend adopts a process and replays.
+     */
+    whenAdoptReplayed?(key: SessionKey): Promise<void>;
+    /** Whether an adopted session is still replaying the downtime tail — {@link whenAdoptReplayed} would wait. */
+    checkIsAdoptReplayPending?(key: SessionKey): boolean;
     checkIsActive(key: SessionKey): boolean;
     /**
      * @description Read runtime metadata for the live session without sending the
@@ -803,12 +855,19 @@ export interface AgentAdapter extends EventEmitter {
     /**
      * Make every active OpenCode directory's instance load the bot's compaction
      * plugin (`utils/openCodeCompactPlugin.ts`): install the plugin file, then
-     * recreate each IDLE directory instance that predates it. Recreating drops the
+     * recreate each IDLE directory instance that predates it or loaded an older
+     * version of it. Recreating drops the
      * directory's runtime MCP registrations, so the boot caller must run
      * {@link reconcileSchedulerMcpForActiveSessions} AFTER this resolves. Best-effort,
      * never rejects; a busy directory is left for the next boot.
      */
     activateCompactionPluginForActiveSessions?(): Promise<void>;
+    /**
+     * Boot step (OpenCode) for the skills the bot gives its agents (`utils/agentPlugin.ts`): replace a server started
+     * without the bot's skills folder once nothing works in it — before {@link activateCompactionPluginForActiveSessions},
+     * whose reconcile then restores what a replacement drops. Best-effort, never rejects; busy → the next boot retries.
+     */
+    activateAgentSkillsForServer?(): Promise<void>;
     /**
      * Heal the bot-owned MCP server `serverName` INSIDE one live session: read the
      * status the backend holds for it and reconnect it when it reports `failed`.
@@ -875,14 +934,15 @@ export interface AgentAdapter extends EventEmitter {
     compactContext?(key: SessionKey, instruction?: string): Promise<CompactionResult>;
     /**
      * Whether this backend's own compaction prompt already receives the
-     * loaded-skills guidance for this thread's session, so the bot must leave it
+     * resume guidance (the loaded skills and the next-steps checklist) for this
+     * thread's session, so the bot must leave it
      * out of the `compactContext` instruction. OpenCode: true when the server
-     * loaded the bot's compaction plugin (`utils/openCodeCompactPlugin.ts`), which
+     * loaded the CURRENT bot compaction plugin (`utils/openCodeCompactPlugin.ts`), which
      * cannot see the instruction and so cannot skip a duplicate itself. Optional —
      * absent means "no", and the Claude backends leave it unset because their
      * `PreCompact` hook skips a compaction that already carries the guidance.
      */
-    checkHasCompactionSkillsHook?(key: SessionKey): Promise<boolean>;
+    checkHasCompactionResumeHook?(key: SessionKey): Promise<boolean>;
     /**
      * Whether this backend's OWN compaction summary already reaches the topic as
      * ordinary agent output, so the bot must NOT post a second copy of it.
@@ -942,6 +1002,14 @@ export interface AgentAdapter extends EventEmitter {
      * adapters omit it. Best-effort — never blocks the prompt that follows.
      */
     detachRunningSubagents?(key: SessionKey): Promise<boolean>;
+    /**
+     * Queue `text` into the turn the session is working on RIGHT NOW, as a note the agent reads between its steps —
+     * without starting a new turn: the response being streamed goes on as one message, and nothing of the turn's state
+     * is reset. Resolves `false`, posting nothing, when the session is not busy, or when the turn waits out a provider
+     * retry (a note must never cut that wait short). Optional: only OpenCode reads a prompt mid-turn (the shared todo
+     * lists' mid-turn board, `todos/midTurn.ts`).
+     */
+    queueNoteIntoRunningTurn?(key: SessionKey, text: string): Promise<boolean>;
     /**
      * @description Read the last `limit` conversational turns (user/assistant
      * messages with renderable text, oldest→newest) of `sessionId` from the
@@ -953,6 +1021,14 @@ export interface AgentAdapter extends EventEmitter {
      * session). Used by `resumeSession` to post the short resume context block.
      */
     getRecentTurns?(key: SessionKey, workDir: string, sessionId: string, limit: number): Promise<RecentTurn[]>;
+    /**
+     * @description The summary the backend's own compaction left in the conversation `sessionId` (the newest one), read
+     * from its transcript whether or not the session runs; `null` when it holds none or cannot be read. Never part of
+     * {@link getRecentTurns} — it is not something the user said — so the surfaces that show turns do not show it. Used
+     * by the context bridge of a cross-backend switch, which hands it to the next agent as context. Optional: only a
+     * backend whose transcript carries the summary implements it.
+     */
+    getSessionCompactionSummary?(key: SessionKey, workDir: string, sessionId: string): Promise<string | null>;
     /**
      * @description Assemble the post-restart recap for `sessionId`: how many
      * assistant messages were produced while the bot was down (vs the persisted

package/dist/types.d.ts.map

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

package/dist/utils/adoptReplayGate.d.ts

@@ -0,0 +1,16 @@
+import { type SessionKey } from '../sessionKey';
+import type { AgentAdapter } from '../types';
+/**
+ * How long a forward waits for an adopted session's replay before it goes out anyway. The first poll after an adopt
+ * comes in 300 ms and reads the whole downtime tail at once; this only bounds a tail that cannot be read, so a prompt is
+ * never held for good behind a session that never settles.
+ */
+export declare const adoptReplayGateMaxWaitMs = 30000;
+/**
+ * @description The wait before a prompt is forwarded to a session: an adopted one first replays what its process wrote
+ * while the bot was down. A prompt written meanwhile resets the answer and the error slot the replayed frames still use,
+ * so the replayed text would join the new reply's message and a replayed error would take the new turn's slot. Settles at
+ * once for a session that was not adopted and for an adapter that never adopts. `maxWaitMs` is a test seam.
+ */
+export declare function waitForAdoptedReplay(adapter: Pick<AgentAdapter, 'whenAdoptReplayed'>, key: SessionKey, maxWaitMs?: number): Promise<void>;
+//# sourceMappingURL=adoptReplayGate.d.ts.map

package/dist/utils/adoptReplayGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoptReplayGate.d.ts","sourceRoot":"","sources":["../../src/utils/adoptReplayGate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,mBAAmB,CAAC,EAChD,GAAG,EAAE,UAAU,EACf,SAAS,SAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/utils/adoptReplayGate.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adoptReplayGateMaxWaitMs = void 0;
+exports.waitForAdoptedReplay = waitForAdoptedReplay;
+const sessionKey_1 = require("../sessionKey");
+/**
+ * How long a forward waits for an adopted session's replay before it goes out anyway. The first poll after an adopt
+ * comes in 300 ms and reads the whole downtime tail at once; this only bounds a tail that cannot be read, so a prompt is
+ * never held for good behind a session that never settles.
+ */
+exports.adoptReplayGateMaxWaitMs = 30_000;
+/**
+ * @description The wait before a prompt is forwarded to a session: an adopted one first replays what its process wrote
+ * while the bot was down. A prompt written meanwhile resets the answer and the error slot the replayed frames still use,
+ * so the replayed text would join the new reply's message and a replayed error would take the new turn's slot. Settles at
+ * once for a session that was not adopted and for an adapter that never adopts. `maxWaitMs` is a test seam.
+ */
+async function waitForAdoptedReplay(adapter, key, maxWaitMs = exports.adoptReplayGateMaxWaitMs) {
+    if (!adapter.whenAdoptReplayed)
+        return;
+    let timer;
+    let outcome;
+    try {
+        outcome = await Promise.race([
+            adapter.whenAdoptReplayed(key).then(() => 'replayed'),
+            new Promise((resolve) => { timer = setTimeout(() => resolve('timedOut'), maxWaitMs); }),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (outcome === 'timedOut')
+        console.warn(`[adopt] ${(0, sessionKey_1.keyToString)(key)}: the replay of the downtime tail did not finish in ${maxWaitMs} ms; the prompt goes out without waiting`);
+}
+//# sourceMappingURL=adoptReplayGate.js.map

package/dist/utils/adoptReplayGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adoptReplayGate.js","sourceRoot":"","sources":["../../src/utils/adoptReplayGate.ts"],"names":[],"mappings":";;;AAgBA,oDAiBC;AAjCD,8CAA6D;AAG7D;;;;GAIG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC;AAE/C;;;;;GAKG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAgD,EAChD,GAAe,EACf,SAAS,GAAG,gCAAwB;IAEpC,IAAI,CAAC,OAAO,CAAC,iBAAiB;QAAE,OAAO;IACvC,IAAI,KAAiC,CAAC;IACtC,IAAI,OAAgC,CAAC;IACrC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAC3B,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAmB,CAAC;YAC9D,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,EAAE,GAAG,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;SACpG,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,WAAW,IAAA,wBAAW,EAAC,GAAG,CAAC,uDAAuD,SAAS,0CAA0C,CAAC,CAAC;AAClL,CAAC"}

package/dist/utils/agentEnvironment.d.ts

@@ -20,8 +20,12 @@
  * `IS_SANDBOX` lets Claude Code run `--dangerously-skip-permissions` as root,
  * which the whole bot in a rootless Docker container is (the image sets it);
  * without it every agent there refuses to start. It holds no secret.
+ * `XDG_CACHE_HOME` is a path: with it the agent and the bot (and the other agents) use ONE local cache —
+ * `charness remote-run` keeps its ssh control sockets, the last probe of each runner and its record of
+ * which project a job came from there; without it a tracker agent's cache followed `HOME` while the bot's
+ * did not, and what one wrote the other could not read.
  */
-export declare const agentEnvironmentNames: readonly ["HOME", "PATH", "USER", "LOGNAME", "SHELL", "LANG", "LC_ALL", "LC_CTYPE", "TERM", "TMPDIR", "TZ", "IS_SANDBOX"];
+export declare const agentEnvironmentNames: readonly ["HOME", "PATH", "USER", "LOGNAME", "SHELL", "LANG", "LC_ALL", "LC_CTYPE", "TERM", "TMPDIR", "TZ", "IS_SANDBOX", "XDG_CACHE_HOME"];
 /** @description Remember which variables came from the instance's `ENV_FILE`: none of them reaches an agent. */
 export declare function addEnvFileVariableNames(names: Iterable<string>): void;
 /** @description Forget the recorded names — for tests only, so each case starts from a process that loaded no env file. */
@@ -29,7 +33,7 @@ export declare function resetEnvFileVariableNamesForTests(): void;
 /**
  * @description The allowlisted variables `env` holds, minus any the `ENV_FILE`
  * set — an instance file that sets `PATH` leaves the agent on the shell's default
- * search path rather than handing it a value from the file.
+ * search path rather than handing it a value from the file (`XDG_CACHE_HOME` excepted, see above).
  */
 export declare function getAgentEnvironment(env?: NodeJS.ProcessEnv): Record<string, string>;
 /** @description Set (or, with `null`, clear) the folder {@link addAgentBinDirToPath} puts first on the PATH. */

package/dist/utils/agentEnvironment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentEnvironment.d.ts","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,2HAaxB,CAAC;AAKX,gHAAgH;AAChH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAErE;AAED,2HAA2H;AAC3H,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhG;AAQD,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGhG"}
+{"version":3,"file":"agentEnvironment.d.ts","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB,6IAcxB,CAAC;AAYX,gHAAgH;AAChH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,IAAI,CAErE;AAED,2HAA2H;AAC3H,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOhG;AAQD,gHAAgH;AAChH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGhG"}

package/dist/utils/agentEnvironment.js

@@ -62,6 +62,10 @@ const path = __importStar(require("path"));
  * `IS_SANDBOX` lets Claude Code run `--dangerously-skip-permissions` as root,
  * which the whole bot in a rootless Docker container is (the image sets it);
  * without it every agent there refuses to start. It holds no secret.
+ * `XDG_CACHE_HOME` is a path: with it the agent and the bot (and the other agents) use ONE local cache —
+ * `charness remote-run` keeps its ssh control sockets, the last probe of each runner and its record of
+ * which project a job came from there; without it a tracker agent's cache followed `HOME` while the bot's
+ * did not, and what one wrote the other could not read.
  */
 exports.agentEnvironmentNames = [
     'HOME',
@@ -76,7 +80,14 @@ exports.agentEnvironmentNames = [
     'TMPDIR',
     'TZ',
     'IS_SANDBOX',
+    'XDG_CACHE_HOME',
 ];
+/**
+ * Allowlisted names that reach the agent even when the instance's `ENV_FILE` set them: a PATH or TZ from that file is the instance's own
+ * business, but `XDG_CACHE_HOME` is a path the BOT then follows too — and the agent must follow the bot, or the two keep separate
+ * `charness remote-run` caches (probes, ssh connections, job records) and cannot read each other's. It holds no secret.
+ */
+const namesPassedEvenFromEnvFile = new Set(['XDG_CACHE_HOME']);
 /** Names the instance's `ENV_FILE` set — recorded by the env loader on every load (the hot worker loads it again). */
 const envFileVariableNames = new Set();
 /** @description Remember which variables came from the instance's `ENV_FILE`: none of them reaches an agent. */
@@ -91,13 +102,13 @@ function resetEnvFileVariableNamesForTests() {
 /**
  * @description The allowlisted variables `env` holds, minus any the `ENV_FILE`
  * set — an instance file that sets `PATH` leaves the agent on the shell's default
- * search path rather than handing it a value from the file.
+ * search path rather than handing it a value from the file (`XDG_CACHE_HOME` excepted, see above).
  */
 function getAgentEnvironment(env = process.env) {
     const environment = {};
     for (const name of exports.agentEnvironmentNames) {
         const value = env[name];
-        if (value !== undefined && !envFileVariableNames.has(name))
+        if (value !== undefined && (!envFileVariableNames.has(name) || namesPassedEvenFromEnvFile.has(name)))
             environment[name] = value;
     }
     return environment;

package/dist/utils/agentEnvironment.js.map

@@ -1 +1 @@
-{"version":3,"file":"agentEnvironment.js","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,0DAEC;AAGD,8EAEC;AAOD,kDAOC;AASD,kDAEC;AAMD,oDAGC;AAtFD,2CAA6B;AAE7B;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACU,QAAA,qBAAqB,GAAG;IACnC,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,YAAY;CACJ,CAAC;AAEX,sHAAsH;AACtH,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C,gHAAgH;AAChH,SAAgB,uBAAuB,CAAC,KAAuB;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,2HAA2H;AAC3H,SAAgB,iCAAiC;IAC/C,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,6BAAqB,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACxF,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,yHAAyH;AACzH,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,gHAAgH;AAChH,SAAgB,mBAAmB,CAAC,GAAkB;IACpD,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,WAAmC;IACtE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,GAAG,WAAW,GAAG,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,CAAC;AAC5G,CAAC"}
+{"version":3,"file":"agentEnvironment.js","sourceRoot":"","sources":["../../src/utils/agentEnvironment.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyDA,0DAEC;AAGD,8EAEC;AAOD,kDAOC;AASD,kDAEC;AAMD,oDAGC;AAlGD,2CAA6B;AAE7B;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;;;;GAeG;AACU,QAAA,qBAAqB,GAAG;IACnC,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,MAAM;IACN,QAAQ;IACR,UAAU;IACV,MAAM;IACN,QAAQ;IACR,IAAI;IACJ,YAAY;IACZ,gBAAgB;CACR,CAAC;AAEX;;;;GAIG;AACH,MAAM,0BAA0B,GAAwB,IAAI,GAAG,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;AAEpF,sHAAsH;AACtH,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C,gHAAgH;AAChH,SAAgB,uBAAuB,CAAC,KAAuB;IAC7D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,2HAA2H;AAC3H,SAAgB,iCAAiC;IAC/C,oBAAoB,CAAC,KAAK,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACtE,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,IAAI,IAAI,6BAAqB,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAClI,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,2EAA2E;AAC3E,MAAM,gBAAgB,GAAG,8BAA8B,CAAC;AAExD,yHAAyH;AACzH,IAAI,WAAW,GAAkB,IAAI,CAAC;AAEtC,gHAAgH;AAChH,SAAgB,mBAAmB,CAAC,GAAkB;IACpD,WAAW,GAAG,GAAG,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,WAAmC;IACtE,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAC7C,OAAO,EAAE,GAAG,WAAW,EAAE,IAAI,EAAE,GAAG,WAAW,GAAG,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,IAAI,IAAI,gBAAgB,EAAE,EAAE,CAAC;AAC5G,CAAC"}