@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/discord/gateway.js

@@ -0,0 +1,315 @@
+import { errorMessage } from '../error-message.js';
+/**
+ * A minimal Discord gateway client (#680): the inbound half of the Discord integration, which
+ * until now was outbound-only — a webhook `POST` can notify, but it cannot read a reply (#627).
+ *
+ * Deliberately hand-rolled over the global `WebSocket` rather than pulling in `discord.js`. The
+ * package has three runtime dependencies and builds everything else on node builtins behind
+ * injectable seams; a client library for the handful of opcodes below would be the largest
+ * dependency in the package by an order of magnitude.
+ *
+ * Implements only what a chat bot needs: identify, heartbeat, resume, and message events.
+ */
+/** Gateway opcodes we act on. */
+export const OP = {
+    dispatch: 0,
+    heartbeat: 1,
+    identify: 2,
+    resume: 6,
+    reconnect: 7,
+    invalidSession: 9,
+    hello: 10,
+    heartbeatAck: 11,
+};
+/**
+ * Gateway intents. `MESSAGE_CONTENT` is privileged: it must be enabled on the application in
+ * Discord's developer portal, or the gateway connects and every message arrives with an empty
+ * `content`. That failure is silent, which is why {@link DiscordGateway} logs it explicitly.
+ */
+export const INTENTS = {
+    guildMessages: 1 << 9,
+    directMessages: 1 << 12,
+    messageContent: 1 << 15,
+};
+/** The intents a chat bot needs: messages in channels and DMs, plus their text. */
+export const CHAT_INTENTS = INTENTS.guildMessages | INTENTS.directMessages | INTENTS.messageContent;
+/** The default gateway endpoint. v10, JSON encoding (no `zlib-stream`, no `etf`). */
+const GATEWAY_URL = 'wss://gateway.discord.gg/?v=10&encoding=json';
+/** Reconnect backoff bounds. A failed connect must not become a tight loop against Discord. */
+const RECONNECT_MS = 1_000;
+const RECONNECT_MAX_MS = 60_000;
+/** A {@link SocketFactory} over the global `WebSocket` (node >= 22 ships one). */
+function nodeSocketFactory() {
+    return url => {
+        const ws = new WebSocket(url);
+        return {
+            send: data => ws.send(data),
+            close: () => ws.close(),
+            onMessage: handler => ws.addEventListener('message', event => handler(String(event.data))),
+            onClose: handler => ws.addEventListener('close', () => handler()),
+            onError: handler => ws.addEventListener('error', err => handler(err)),
+        };
+    };
+}
+/** The default {@link IntervalFactory}: unref'd, so a heartbeat never keeps the daemon alive. */
+function nodeIntervalFactory() {
+    return (fn, ms) => {
+        const timer = setInterval(fn, ms);
+        timer.unref?.();
+        return { stop: () => clearInterval(timer) };
+    };
+}
+/** The default {@link DelayFactory}: unref'd, so a pending reconnect never keeps the daemon alive. */
+function nodeDelayFactory() {
+    return (fn, ms) => {
+        const timer = setTimeout(fn, ms);
+        timer.unref?.();
+        return { stop: () => clearTimeout(timer) };
+    };
+}
+/**
+ * A connected Discord bot session. Owns the socket, the heartbeat, and the resume state; hands
+ * every chat message to its {@link GatewayHandlers}.
+ *
+ * Errors are swallowed into `onLog` rather than thrown: a notifier must never take the daemon
+ * down, which is the same contract the intervention/activity watchers follow.
+ */
+export class DiscordGateway {
+    token;
+    handlers;
+    deps;
+    socket;
+    heartbeat;
+    sequence;
+    sessionId;
+    resumeUrl;
+    acked = true;
+    selfId;
+    /** Set by {@link stop}, so a socket closing on our own terms never reconnects. */
+    stopped = false;
+    /** Consecutive reconnects, for the backoff. Reset once a connection actually works. */
+    attempts = 0;
+    pendingReconnect;
+    constructor(token, handlers, deps = {}) {
+        this.token = token;
+        this.handlers = handlers;
+        this.deps = deps;
+    }
+    /** Open the connection and identify. Safe to call once; use {@link stop} to end it. */
+    connect() {
+        this.stopped = false;
+        this.open(this.deps.url ?? GATEWAY_URL);
+    }
+    /**
+     * Close the connection for good. This is what takes the bot offline on `Ctrl+C` (#680): the
+     * daemon calls it from its shutdown block, and no reconnect follows.
+     */
+    stop() {
+        this.stopped = true;
+        this.heartbeat?.stop();
+        this.heartbeat = undefined;
+        this.pendingReconnect?.stop();
+        this.pendingReconnect = undefined;
+        try {
+            this.socket?.close();
+        }
+        catch {
+            // Already closing; nothing to do.
+        }
+        this.socket = undefined;
+    }
+    /** Our own user id once READY has landed. */
+    get userId() {
+        return this.selfId;
+    }
+    open(url) {
+        const factory = this.deps.socket ?? nodeSocketFactory();
+        let socket;
+        try {
+            socket = factory(url);
+        }
+        catch (err) {
+            this.log(`could not open the Discord gateway: ${errText(err)}`);
+            // No socket means no onClose will ever fire, so returning here would end reconnection
+            // for the daemon's lifetime (#942). Fall through to the same backoff a failed
+            // connection takes; `stop()` still wins because reopen() checks `stopped`.
+            this.reopen();
+            return;
+        }
+        this.socket = socket;
+        socket.onMessage(data => this.receive(data));
+        socket.onError(err => this.log(`Discord gateway error: ${errText(err)}`));
+        socket.onClose(() => this.reopen());
+    }
+    /**
+     * A closed socket we did not close ourselves: resume if we can, else identify fresh.
+     *
+     * Backed off, and that is not a nicety: a connection that fails immediately (offline, a bad
+     * token) closes as fast as it opens, so reconnecting inline is a tight loop that pins a core
+     * and gets the bot rate-limited. Doubles to a cap, and resets once a connection works.
+     */
+    reopen() {
+        this.heartbeat?.stop();
+        this.heartbeat = undefined;
+        if (this.stopped)
+            return;
+        const wait = Math.min(RECONNECT_MS * 2 ** this.attempts, RECONNECT_MAX_MS);
+        this.attempts++;
+        const schedule = this.deps.delay ?? nodeDelayFactory();
+        this.pendingReconnect?.stop();
+        this.pendingReconnect = schedule(() => {
+            if (this.stopped)
+                return;
+            this.open(this.resumeUrl ?? this.deps.url ?? GATEWAY_URL);
+        }, wait);
+    }
+    receive(raw) {
+        let payload;
+        try {
+            payload = JSON.parse(raw);
+        }
+        catch {
+            return; // A frame we cannot read is not a frame we can act on.
+        }
+        if (typeof payload.s === 'number')
+            this.sequence = payload.s;
+        switch (payload.op) {
+            case OP.hello:
+                this.onHello(payload.d);
+                return;
+            case OP.heartbeatAck:
+                this.acked = true;
+                return;
+            case OP.heartbeat:
+                this.sendHeartbeat();
+                return;
+            case OP.reconnect:
+                // Discord asked us to move; close and let onClose resume us.
+                this.socket?.close();
+                return;
+            case OP.invalidSession:
+                // The session is gone: drop it so the reconnect identifies fresh instead of resuming.
+                this.sessionId = undefined;
+                this.resumeUrl = undefined;
+                this.socket?.close();
+                return;
+            case OP.dispatch:
+                this.onDispatch(payload.t, payload.d);
+                return;
+            default:
+                return;
+        }
+    }
+    onHello(data) {
+        const interval = asRecord(data)?.['heartbeat_interval'];
+        const ms = typeof interval === 'number' && interval > 0 ? interval : 45_000;
+        const schedule = this.deps.interval ?? nodeIntervalFactory();
+        this.acked = true;
+        this.heartbeat = schedule(() => {
+            // A missed ACK means the connection is a zombie: drop it and let onClose resume.
+            if (!this.acked) {
+                this.log('Discord gateway missed a heartbeat ack; reconnecting');
+                this.socket?.close();
+                return;
+            }
+            this.acked = false;
+            this.sendHeartbeat();
+        }, ms);
+        if (this.sessionId)
+            this.resume();
+        else
+            this.identify();
+    }
+    identify() {
+        this.send({
+            op: OP.identify,
+            d: {
+                token: this.token,
+                intents: CHAT_INTENTS,
+                properties: { os: process.platform, browser: 'the-framework', device: 'the-framework' },
+            },
+        });
+    }
+    resume() {
+        this.send({ op: OP.resume, d: { token: this.token, session_id: this.sessionId, seq: this.sequence ?? 0 } });
+    }
+    sendHeartbeat() {
+        this.send({ op: OP.heartbeat, d: this.sequence ?? null });
+    }
+    onDispatch(type, data) {
+        if (type === 'READY') {
+            this.attempts = 0; // A connection that reached READY is healthy; start the backoff over.
+            const d = asRecord(data);
+            this.sessionId = asString(d?.['session_id']);
+            const resume = asString(d?.['resume_gateway_url']);
+            // Discord's resume url carries no query, so keep our version/encoding on it.
+            if (resume)
+                this.resumeUrl = `${resume}?v=10&encoding=json`;
+            this.selfId = asString(asRecord(d?.['user'])?.['id']);
+            if (this.selfId)
+                this.handlers.onReady?.(this.selfId);
+            return;
+        }
+        if (type === 'RESUMED')
+            return;
+        if (type !== 'MESSAGE_CREATE')
+            return;
+        const message = parseMessage(data);
+        if (!message)
+            return;
+        // Never act on a bot's message, our own most of all: two bots replying to each other is an
+        // unbounded loop that costs real money.
+        if (message.fromBot || message.authorId === this.selfId)
+            return;
+        if (!message.content.trim()) {
+            this.log('a Discord message arrived with no content: enable the MESSAGE CONTENT intent for the bot');
+            return;
+        }
+        this.handlers.onMessage(message);
+    }
+    send(payload) {
+        try {
+            this.socket?.send(JSON.stringify(payload));
+        }
+        catch (err) {
+            this.log(`could not send to the Discord gateway: ${errText(err)}`);
+        }
+    }
+    log(message) {
+        this.handlers.onLog?.(message);
+    }
+}
+/** Narrow a MESSAGE_CREATE payload; `undefined` when it is not a shape we can use. */
+export function parseMessage(data) {
+    const d = asRecord(data);
+    if (!d)
+        return undefined;
+    const author = asRecord(d['author']);
+    const id = asString(d['id']);
+    const channelId = asString(d['channel_id']);
+    const authorId = asString(author?.['id']);
+    if (!id || !channelId || !authorId)
+        return undefined;
+    const message = {
+        id,
+        channelId,
+        content: asString(d['content']) ?? '',
+        authorId,
+        authorName: asString(author?.['global_name']) ?? asString(author?.['username']) ?? authorId,
+        fromBot: author?.['bot'] === true,
+    };
+    const replyTo = asString(asRecord(d['referenced_message'])?.['id']);
+    if (replyTo)
+        message.replyToId = replyTo;
+    return message;
+}
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+function asString(value) {
+    return typeof value === 'string' && value ? value : undefined;
+}
+function errText(err) {
+    return errorMessage(err);
+}
+//# sourceMappingURL=gateway.js.map

package/dist/discord/gateway.js.map

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

package/dist/discord/live-run.d.ts

@@ -0,0 +1,31 @@
+import type { FrameworkEvent } from '../events.js';
+import { type StoreFs } from '../store/index.js';
+import type { Gate, RunSnapshot } from './routing.js';
+/**
+ * Turn a project's on-disk run state into the {@link RunSnapshot} routing decides against (#680).
+ *
+ * The parked gate needs its options, and those are not on the run meta: `pendingChoice` carries
+ * only the gate's id and title, because that is all the dashboard's rail needed. The options live
+ * in the `choice` event, so answering "2" from chat means reading the run's event log — through
+ * the store's own reader, so this surface cannot keep a drifted copy of the torn-line policy.
+ *
+ * Known constraint (#945): chat models ONE live run per project. A project can run several
+ * sessions at once since #736, and `snapshotLiveRun` picks the first running meta the store
+ * lists — the newest by id, since `readLiveMetas` sorts newest-first — so a chat message always
+ * routes to the newest running run, which is not necessarily the one the user means. This is an
+ * accepted MVP limit of the chat surface, not an oversight — lifting it means letting the bot
+ * list and target runs, which is #945's real fix. Do not "fix" the pick order here; a different
+ * deterministic pick is no better when the user cannot choose.
+ */
+/**
+ * The still-open gate with this id, or `undefined` when it was already answered. A gate is open
+ * when its `choice` event has no later `choice-resolved` for the same id — otherwise a chat reply
+ * would answer a question the dashboard already closed.
+ */
+export declare function openGate(events: FrameworkEvent[], gateId: string): Gate | undefined;
+/**
+ * The project's live run, with its parked gate resolved. `undefined` when nothing is running.
+ * Forgiving throughout: a chat integration must never fail on unreadable run state.
+ */
+export declare function snapshotLiveRun(projectId: string, projectCwd: string, fs?: StoreFs): Promise<RunSnapshot | undefined>;
+//# sourceMappingURL=live-run.d.ts.map

package/dist/discord/live-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-run.d.ts","sourceRoot":"","sources":["../../src/discord/live-run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,EAA4C,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC1F,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAenF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,EAAE,GAAE,OAAuB,GAC1B,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAWlC"}

package/dist/discord/live-run.js

@@ -0,0 +1,57 @@
+import { nodeStoreFs, readEventLog, readLiveMetas } from '../store/index.js';
+/**
+ * Turn a project's on-disk run state into the {@link RunSnapshot} routing decides against (#680).
+ *
+ * The parked gate needs its options, and those are not on the run meta: `pendingChoice` carries
+ * only the gate's id and title, because that is all the dashboard's rail needed. The options live
+ * in the `choice` event, so answering "2" from chat means reading the run's event log — through
+ * the store's own reader, so this surface cannot keep a drifted copy of the torn-line policy.
+ *
+ * Known constraint (#945): chat models ONE live run per project. A project can run several
+ * sessions at once since #736, and `snapshotLiveRun` picks the first running meta the store
+ * lists — the newest by id, since `readLiveMetas` sorts newest-first — so a chat message always
+ * routes to the newest running run, which is not necessarily the one the user means. This is an
+ * accepted MVP limit of the chat surface, not an oversight — lifting it means letting the bot
+ * list and target runs, which is #945's real fix. Do not "fix" the pick order here; a different
+ * deterministic pick is no better when the user cannot choose.
+ */
+/**
+ * The still-open gate with this id, or `undefined` when it was already answered. A gate is open
+ * when its `choice` event has no later `choice-resolved` for the same id — otherwise a chat reply
+ * would answer a question the dashboard already closed.
+ */
+export function openGate(events, gateId) {
+    let gate;
+    for (const event of events) {
+        if (event.kind === 'choice' && event.id === gateId) {
+            gate = {
+                id: event.id,
+                title: event.title,
+                options: event.options.map(option => ({ id: option.id, label: option.label })),
+                ...(event.multi ? { multi: true } : {}),
+            };
+        }
+        else if (event.kind === 'choice-resolved' && event.id === gateId) {
+            gate = undefined;
+        }
+    }
+    return gate;
+}
+/**
+ * The project's live run, with its parked gate resolved. `undefined` when nothing is running.
+ * Forgiving throughout: a chat integration must never fail on unreadable run state.
+ */
+export async function snapshotLiveRun(projectId, projectCwd, fs = nodeStoreFs()) {
+    const metas = await readLiveMetas(projectCwd, fs).catch(() => []);
+    const running = metas.find(meta => meta.status === 'running');
+    if (!running)
+        return undefined;
+    const snapshot = { projectId, runId: running.id };
+    if (running.pendingChoice) {
+        const gate = openGate(await readEventLog(running.cwd, fs), running.pendingChoice.id);
+        if (gate)
+            snapshot.gate = gate;
+    }
+    return snapshot;
+}
+//# sourceMappingURL=live-run.js.map

package/dist/discord/live-run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-run.js","sourceRoot":"","sources":["../../src/discord/live-run.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAA;AAG1F;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAwB,EAAE,MAAc;IAC/D,IAAI,IAAsB,CAAA;IAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACnD,IAAI,GAAG;gBACL,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC9E,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxC,CAAA;QACH,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB,IAAI,KAAK,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACnE,IAAI,GAAG,SAAS,CAAA;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,UAAkB,EAClB,KAAc,WAAW,EAAE;IAE3B,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;IACjE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;IAC7D,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAA;IAE9B,MAAM,QAAQ,GAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAA;IAC9D,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;QACpF,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAA;IAChC,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/discord/reply-mirror.d.ts

@@ -0,0 +1,83 @@
+import type { ConversationMessage } from '../conversations.js';
+/**
+ * Sending a session's answers back to the Discord channel that asked (#932).
+ *
+ * #680 delivered the inbound half: a message in Discord reaches a run over the control channel.
+ * Nothing carried the answer back, so the bot only ever acknowledged ("Sent to the running
+ * session.") and the reply itself was visible in the dashboard alone. That makes a chat
+ * integration write-only: you can talk to the agent and never hear it.
+ *
+ * The source is the committed conversation (#908), not the event log. `events.jsonl` has no
+ * "agent reply" kind -- `log` carries rendered console lines and `driver` carries raw driver
+ * events, neither of which is the settled answer. A conversation turn is exactly the settled text
+ * the user actually read, which is precisely what belongs in a chat channel.
+ *
+ * Which channel is a binding, not a guess: the bot records `runId -> channelId` when it starts or
+ * messages a run, because that is the only moment the channel is known. A run nobody bound is
+ * simply not mirrored, so a dashboard-started session never posts into a channel that never asked
+ * about it (routing that generally is #606's job, not this).
+ *
+ * Two rules keep it from being a nuisance:
+ *
+ * The baseline is taken when the run is bound, not on the first poll. Adopting the transcript at
+ * bind time is what stops a backlog being replayed into a channel, and taking it at bind rather
+ * than at first poll closes the race where a fast agent answers before the first tick and its
+ * reply is baselined away unseen.
+ *
+ * While the bot is switched off the cursor still advances without posting, the same contract the
+ * notification watchers follow: turning it on starts from now instead of flushing everything said
+ * while it was off.
+ *
+ * Bindings are released when their run stops resolving (#941): `readConversation` answers
+ * `undefined` for a run that no longer exists (archived, or its project removed), and after a few
+ * consecutive misses the poll drops the binding. Without that, every chat-touched run stayed in
+ * the map for the daemon's lifetime and each poll scanned every project's live metas per bound
+ * run — no misposts (an archived run resolves nothing), but per-poll IO that only ever grew. The
+ * misses are counted, not acted on at first sight, so a freshly bound run whose meta is not on
+ * disk yet is not dropped by the race.
+ */
+/** Where a run's answers go. */
+export interface RunBinding {
+    channelId: string;
+}
+/** What a mirror needs from the daemon. */
+export interface ReplyMirrorOptions {
+    /**
+     * A bound run's conversation, oldest-first. Anything unreadable should resolve `[]`, not throw.
+     * `undefined` means the run itself no longer resolves (archived / project gone); after
+     * {@link UNBIND_AFTER_MISSES} consecutive misses the mirror drops the binding (#941).
+     */
+    readConversation: (runId: string) => Promise<ConversationMessage[] | undefined>;
+    /** Post one answer into a channel. Resolves whether it was delivered. */
+    post: (channelId: string, text: string) => Promise<boolean>;
+    /** Whether the bot should speak, read per poll so the toggle needs no daemon restart. */
+    enabled?: () => Promise<boolean>;
+    /** Poll cadence, ms. Default 3s: a chat reply that lands a minute late is not a reply. */
+    intervalMs?: number;
+    onLog?: (message: string) => void;
+}
+/** A running mirror. */
+export interface DiscordReplyMirror {
+    /**
+     * Start mirroring a run's answers into a channel, adopting whatever it has already said.
+     * Awaitable so the caller can bind *before* handing the run a message, which is what makes the
+     * next reply reliably new.
+     */
+    bind: (runId: string, channelId: string) => Promise<void>;
+    /** Stop mirroring a run (it ended, or its channel went away). */
+    unbind: (runId: string) => void;
+    /** Whether a run is currently mirrored. */
+    isBound: (runId: string) => boolean;
+    /** Run one poll now. Exposed so the daemon and tests can drive it deterministically. */
+    poll: () => Promise<void>;
+    stop: () => void;
+}
+/**
+ * How many consecutive unresolvable polls release a binding (#941). Generous on purpose: a
+ * run bound the instant it started has no live meta on disk until its child process boots and
+ * writes one, and dropping the binding during that window would silently unmirror a live chat.
+ * The cost of waiting longer is only how late a dead binding's poll IO stops.
+ */
+export declare const UNBIND_AFTER_MISSES = 10;
+export declare function startDiscordReplyMirror(opts: ReplyMirrorOptions): DiscordReplyMirror;
+//# sourceMappingURL=reply-mirror.d.ts.map

package/dist/discord/reply-mirror.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reply-mirror.d.ts","sourceRoot":"","sources":["../../src/discord/reply-mirror.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,EAAE,GAAG,SAAS,CAAC,CAAA;IAC/E,yEAAyE;IACzE,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3D,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED,wBAAwB;AACxB,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,iEAAiE;IACjE,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,2CAA2C;IAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;IACnC,wFAAwF;IACxF,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,IAAI,EAAE,MAAM,IAAI,CAAA;CACjB;AAaD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAA;AAErC,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAoEpF"}

package/dist/discord/reply-mirror.js

@@ -0,0 +1,84 @@
+/** How often answers are checked for. A chat reply has to feel like a reply. */
+const REPLY_POLL_MS = 3_000;
+/**
+ * How many consecutive unresolvable polls release a binding (#941). Generous on purpose: a
+ * run bound the instant it started has no live meta on disk until its child process boots and
+ * writes one, and dropping the binding during that window would silently unmirror a live chat.
+ * The cost of waiting longer is only how late a dead binding's poll IO stops.
+ */
+export const UNBIND_AFTER_MISSES = 10;
+export function startDiscordReplyMirror(opts) {
+    const bound = new Map();
+    let stopped = false;
+    let running = false;
+    const bind = async (runId, channelId) => {
+        if (stopped)
+            return;
+        // Adopt the transcript as it stands, so only what is said from here on is mirrored. Read at
+        // bind time on purpose: deferring it to the first poll would swallow a reply that beat the tick.
+        const existing = (await opts.readConversation(runId).catch(() => undefined)) ?? [];
+        bound.set(runId, { channelId, next: existing.length, misses: 0 });
+    };
+    const poll = async () => {
+        if (stopped || running)
+            return;
+        running = true;
+        try {
+            // Read once per poll rather than per run: it gates posting, not observing.
+            const on = opts.enabled ? await opts.enabled().catch(() => false) : true;
+            for (const [runId, state] of [...bound]) {
+                if (stopped)
+                    break;
+                // A throw is a transient read failure and costs one poll; `undefined` is the run itself
+                // being gone, and enough of those in a row release the binding (#941).
+                const messages = await opts.readConversation(runId).catch(() => []);
+                if (messages === undefined) {
+                    state.misses++;
+                    if (state.misses >= UNBIND_AFTER_MISSES) {
+                        bound.delete(runId);
+                        opts.onLog?.(`stopped mirroring ${runId}: its run no longer resolves`);
+                    }
+                    continue;
+                }
+                state.misses = 0;
+                if (messages.length <= state.next)
+                    continue;
+                const fresh = messages.slice(state.next);
+                // Advance first, and unconditionally: a turn we chose not to post (the bot is off, or it
+                // is the user's own message coming back) must not be reconsidered next poll.
+                state.next = messages.length;
+                if (!on)
+                    continue;
+                for (const message of fresh) {
+                    // Only the agent's side. Echoing the user's own message back at them is noise, and a
+                    // turn that arrived *from* Discord is already on their screen.
+                    if (message.role !== 'agent')
+                        continue;
+                    const text = message.text.trim();
+                    if (!text)
+                        continue;
+                    const delivered = await opts.post(state.channelId, text).catch(() => false);
+                    if (!delivered)
+                        opts.onLog?.(`could not deliver a reply for ${runId}`);
+                }
+            }
+        }
+        finally {
+            running = false;
+        }
+    };
+    const timer = setInterval(() => void poll(), opts.intervalMs ?? REPLY_POLL_MS);
+    timer.unref?.();
+    return {
+        bind,
+        unbind: runId => void bound.delete(runId),
+        isBound: runId => bound.has(runId),
+        poll,
+        stop: () => {
+            stopped = true;
+            bound.clear();
+            clearInterval(timer);
+        },
+    };
+}
+//# sourceMappingURL=reply-mirror.js.map

package/dist/discord/reply-mirror.js.map

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

package/dist/discord/rest.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The Discord REST calls the bot needs (#680). Separate from the outbound webhook posts in the
+ * intervention/activity watchers (#627): a webhook can only speak into one channel and cannot
+ * reply, so a bot that answers where it was asked has to go through the API with its token.
+ *
+ * `fetch` is a parameter, exactly as in the watchers, so tests never touch the network.
+ */
+/** Discord rejects a message over 2000 characters outright, so a long reply is trimmed. */
+export declare const MAX_CONTENT = 2000;
+/** Trim to Discord's limit, marking the cut so a truncated answer never reads as a complete one. */
+export declare function clampContent(text: string): string;
+/**
+ * Post a message to a channel as the bot. Resolves `false` on any failure — a reply that cannot
+ * be delivered must never take the daemon down.
+ */
+export declare function postMessage(token: string, channelId: string, content: string, opts?: {
+    replyToId?: string;
+    fetchImpl?: typeof fetch;
+}): Promise<boolean>;
+//# sourceMappingURL=rest.d.ts.map

package/dist/discord/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/discord/rest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,2FAA2F;AAC3F,eAAO,MAAM,WAAW,OAAO,CAAA;AAE/B,oGAAoG;AACpG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CAAO,GAC1D,OAAO,CAAC,OAAO,CAAC,CAiBlB"}