@songsid/agend 2.1.12-beta.1 → 2.1.12-beta.2

package/dist/backend/session-signals.js

@@ -0,0 +1,430 @@
+/**
+ * Detection-signal seam: the shared base for #1209 / #1217a / #1210 / #1215.
+ *
+ * A read-only, query-only observation layer answering ONE question without
+ * pane pixels: did the CLI itself re-engage a turn since the checkpoint
+ * (double-drive guard)? Per-backend adapters discover the workspace's session
+ * in the CLI's own session store and produce a `TurnFingerprint`; the
+ * backend-agnostic `compareFingerprints` diffs a pre-action checkpoint
+ * against a post-action read.
+ *
+ * RED LINE: this seam never touches the idle/busy state machine.
+ * `readinessFromStore` always returns `unknown` — the pane stays the
+ * busyness authority, exactly as today. Nothing here drives, resumes, or
+ * writes any CLI state; every read is out-of-band and defensive (an absent
+ * field is null, never an exception).
+ *
+ * SYNC I/O WARNING: every read below is synchronous blocking file/database
+ * I/O. Never resolve fingerprints on the fleet event loop or inside a tool
+ * handler — use a bounded worker context.
+ *
+ * What counts as re-engagement: a new TURN, not a store write. CLIs
+ * bookkeep without turns (claude `cost-state`/`ai-title`, codex threads-row
+ * touches, muse `session.workspace_branch.observed`), so both the mtime and
+ * the tail path are gated on turn-shaped journal entries (`isTurnKind`):
+ * file mtime is recorded for grace bookkeeping but never drives the verdict
+ * alone. Kinds this seam does not recognise default to bookkeeping — a new
+ * turn vocabulary delays detection to the next recognised write instead of
+ * fabricating or blocking on it.
+ *
+ * Daemon exclusion covers BOTH paths: the daemon's own action (e.g. a resume)
+ * writes tail entries too, so a turn tail counts only past
+ * `max(before.tail, daemonCausedMtimeMs) + tailSkewMs`. The skew (default 2s:
+ * filesystem timestamp granularity plus entry-ts vs flush-mtime reorder —
+ * a live codex tail was observed 2ms AFTER its row mtime) keeps a
+ * daemon-caused tail from reading as someone else's turn.
+ *
+ * Tail-timestamp fields were verified against live stores, not assumed:
+ * - claude-code 2.1.289 transcript JSONL: user/assistant/system entries carry
+ *   ISO `timestamp`, but the tail is usually bookkeeping (`cost-state`,
+ *   `last-prompt`, `mode`, `ai-title`, …) with NO timestamp — so the reader
+ *   scans backwards for the newest timestamped TURN entry instead of taking
+ *   the last line.
+ * - codex rollout JSONL: every line of a lived-in 53k-line rollout carries
+ *   top-level ISO `timestamp`; `type` + `payload.type` name the kind
+ *   (`response_item:message`, `event_msg:task_started`, `turn_context`,
+ *   `token_usage_record`, …). threads row verified with `updated_at_ms` /
+ *   `recency_at_ms` epoch millis.
+ * - muse 1.4.x `session.jsonl`: entries carry NO `timestamp` at all — time is
+ *   `recorded_at` in epoch MICROseconds, kind is `payload_type` (plus inner
+ *   `payload.kind` for the `runtime.session` envelope: `task`/`run` are the
+ *   turn frames, surveyed live over 49k lines); the first line is a
+ *   `retained_frame` wrapper with neither.
+ *
+ * Flush grace and its residual: a CLI that just re-engaged may not have
+ * flushed its store yet, so a checkpoint taken too early reads `quiet` for a
+ * live turn. Inside `flushGraceMs` after the daemon's own write the seam
+ * answers `unknown` instead of `quiet`. Residual, by design and bounded: a
+ * re-engagement that flushes after this compare is caught by the NEXT
+ * checkpoint compare (at most one grace period of delayed detection, never a
+ * fabricated verdict). A re-engagement that never writes to the session store
+ * is invisible to this seam. Callers MUST re-compare across checkpoints; a
+ * single `quiet` inside the grace window must never authorize driving.
+ *
+ * kiro-classic `data.sqlite3` and KAS are deliberately NOT covered here: the
+ * classic schema needs its own round (see #1210) and the spike's KAS field
+ * assumptions were never verified against a live store.
+ */
+import { closeSync, openSync, readFileSync, readSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { claudeProjectKey } from "./claude-code.js";
+import { findExactCwdCodexSession, openCodexStateReadonly, rolloutRecordsTurn } from "./codex-session-lookup.js";
+import { museSessionCwd, museSessionDirs } from "./muse.js";
+/**
+ * How long after the daemon's own store write a `quiet` read is untrustworthy.
+ * 10 s matches the transcript-marker wait bound (#758): a journal flush lands
+ * well inside it, while the window stays short enough to schedule around.
+ */
+export const DEFAULT_FLUSH_GRACE_MS = 10_000;
+/**
+ * Entry-ts vs daemon-mtime skew bound (ms). A daemon-caused tail must clear
+ * the daemon's own mtime by more than this to count as someone else's turn.
+ */
+export const DEFAULT_TAIL_SKEW_MS = 2_000;
+/** Epoch microseconds at or above this are muse `recorded_at`, not millis. */
+const MICROSECONDS_FLOOR = 1e14;
+/**
+ * Parse an ISO instant, epoch millis, or epoch micros (muse `recorded_at`);
+ * anything else is null. Numbers below the micros floor pass through as
+ * millis; what no tailed store emits (e.g. epoch seconds) is out of scope.
+ */
+export function asTimestampMs(v) {
+    if (typeof v === "number") {
+        if (!Number.isFinite(v))
+            return null;
+        return v >= MICROSECONDS_FLOOR ? v / 1000 : v;
+    }
+    if (typeof v === "string") {
+        const ms = Date.parse(v);
+        return Number.isFinite(ms) ? ms : null;
+    }
+    return null;
+}
+function str(v) {
+    return typeof v === "string" && v !== "" ? v : null;
+}
+/**
+ * Best-effort kind of one journal entry across the three store shapes:
+ * claude `type`/`subtype`, codex `type` + `payload.type`, muse `payload_type`
+ * (+ inner `payload.kind` for the `runtime.session` envelope).
+ */
+export function entryKind(entry) {
+    const payload = entry.payload;
+    const payloadObj = payload && typeof payload === "object" && !Array.isArray(payload)
+        ? payload
+        : null;
+    const base = str(entry.type) ?? str(entry.kind) ?? str(entry.payload_type)
+        ?? str(payloadObj?.type) ?? str(payloadObj?.payload_type) ?? str(payloadObj?.kind);
+    if (!base)
+        return null;
+    const detail = str(entry.subtype) ?? str(payloadObj?.kind) ?? str(entry.payload_type)
+        ?? str(payloadObj?.type) ?? str(payloadObj?.payload_type);
+    return detail && detail !== base ? `${base}:${detail}` : base;
+}
+/** Newest timestamp one journal entry carries across the three store shapes. */
+export function entryTimestampMs(entry) {
+    return asTimestampMs(entry.recorded_at ?? entry.timestamp ?? entry.time ?? entry.createdAt ?? entry.lastModifiedAt);
+}
+/**
+ * Whether a tail kind proves a turn ran (as opposed to CLI bookkeeping).
+ * Unrecognised kinds default to bookkeeping: a new turn vocabulary delays
+ * detection instead of blocking legitimate resumes on false positives.
+ */
+export function isTurnKind(backend, kind) {
+    if (!kind)
+        return false;
+    if (backend === "claude")
+        return kind === "user" || kind === "assistant";
+    if (backend === "codex") {
+        return kind === "response_item" || kind.startsWith("response_item:")
+            || kind.startsWith("event_msg:task_");
+    }
+    if (kind === "command.invoked" || kind === "session.resumed")
+        return true;
+    if (kind.startsWith("runtime.user_intent."))
+        return true;
+    if (kind.startsWith("tool_batch.effect."))
+        return true;
+    return kind === "runtime.session.task" || kind === "runtime.session.task_source_committed"
+        || kind === "runtime.session:task" || kind === "runtime.session:run";
+}
+/** Bytes scanned back from the end of a journal looking for tail entries. */
+const TAIL_SCAN_BYTES = 1024 * 1024;
+/**
+ * Read-only tail of a JSONL journal: the newest `want` parseable entries
+ * within the last 1 MB, newest first. A truncated line at the window edge or
+ * a corrupt line is skipped, never fatal. Windowed by design: when the tail
+ * itself is one entry larger than the window, the read still returns the
+ * file mtime with an empty entry list (detection delayed, never fabricated).
+ * Synchronous blocking I/O — see the module warning.
+ */
+export function readJsonlTailEntries(path, want = 8) {
+    if (!(want >= 1))
+        want = 1;
+    try {
+        const st = statSync(path);
+        if (!st.isFile())
+            return null;
+        const window = Math.min(st.size, TAIL_SCAN_BYTES);
+        const buf = Buffer.alloc(window);
+        const fd = openSync(path, "r");
+        try {
+            readSync(fd, buf, 0, window, st.size - window);
+        }
+        finally {
+            try {
+                closeSync(fd);
+            }
+            catch { /* already closed */ }
+        }
+        const lines = buf.toString("utf8").split("\n");
+        const entries = [];
+        for (let i = lines.length - 1; i >= 0 && entries.length < want; i--) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            try {
+                const parsed = JSON.parse(line);
+                if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+                    entries.push(parsed);
+                }
+            }
+            catch { /* partial line at the window edge or corrupt: skip */ }
+        }
+        return { entries, mtimeMs: st.mtimeMs };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Newest timestamped TURN entry of a tail: skips timestamp-less bookkeeping
+ * (claude `cost-state`/`last-prompt`, muse `retained_frame`) AND timestamped
+ * non-turn writes (codex `token_count`, muse `workspace_branch.observed`).
+ * Null when no turn entry carries time.
+ */
+export function tailEvidence(entries, backend) {
+    for (const entry of entries) {
+        const kind = entryKind(entry);
+        if (!isTurnKind(backend, kind))
+            continue;
+        const timestampMs = entryTimestampMs(entry);
+        if (timestampMs !== null)
+            return { timestampMs, kind };
+    }
+    return null;
+}
+/**
+ * Backend-agnostic re-engagement verdict. A changed session id means the
+ * store now belongs to a different conversation (feeds #1217a). Otherwise
+ * only a TURN-tail advance past the daemon's own writes (plus skew) means
+ * the CLI wrote on its own — plain mtime movement is bookkeeping until a
+ * turn entry says otherwise. Inside the flush-grace window after a daemon
+ * write, `quiet` is withheld as `unknown` (see module doc).
+ */
+export function compareFingerprints(before, after, options = {}) {
+    if (!before || !after || before.storeMtimeMs < 0 || after.storeMtimeMs < 0)
+        return "unknown";
+    if (before.sessionId && after.sessionId && before.sessionId !== after.sessionId)
+        return "reengaged";
+    const daemonCausedMtimeMs = options.daemonCausedMtimeMs ?? -1;
+    const tailSkewMs = Math.max(0, options.tailSkewMs ?? DEFAULT_TAIL_SKEW_MS);
+    const afterTail = after.tailTimestampMs;
+    const pastBefore = afterTail !== null
+        && (before.tailTimestampMs === null || afterTail > before.tailTimestampMs);
+    const pastDaemon = afterTail !== null
+        && (daemonCausedMtimeMs < 0 || afterTail > daemonCausedMtimeMs + tailSkewMs);
+    if (pastBefore && pastDaemon)
+        return "reengaged";
+    if (daemonCausedMtimeMs >= 0) {
+        const nowMs = options.nowMs ?? Date.now();
+        const flushGraceMs = options.flushGraceMs ?? DEFAULT_FLUSH_GRACE_MS;
+        if (nowMs - daemonCausedMtimeMs <= flushGraceMs)
+            return "unknown";
+    }
+    return "quiet";
+}
+/**
+ * Store-corroborated busyness, by design always unknown: append-only journals
+ * carry no verified completion semantics, so a store alone cannot say "busy"
+ * vs "ready" — it can only say "wrote recently". The pane stays authoritative;
+ * this seam MUST NOT feed the idle/busy state machine.
+ */
+export function readinessFromStore(_fp) {
+    return {
+        readiness: "unknown",
+        reason: "append-only journal without verified completion entries; pane stays authoritative",
+    };
+}
+/**
+ * Newest `<sessionId>.jsonl` of `~/.claude/projects/<key>/` plus its newest
+ * timestamped TURN tail entry. The session id is discovered from the store,
+ * never caller-supplied, so a conversation switch surfaces as an id change.
+ */
+export function claudeFingerprint(r) {
+    const dir = join(r.configDir, "projects", claudeProjectKey(r.cwd));
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return null;
+    }
+    let bestFile = null;
+    let bestMtime = -1;
+    for (const name of names) {
+        if (!name.endsWith(".jsonl"))
+            continue;
+        try {
+            const m = statSync(join(dir, name)).mtimeMs;
+            if (m > bestMtime) {
+                bestMtime = m;
+                bestFile = name;
+            }
+        }
+        catch { /* raced with deletion */ }
+    }
+    if (!bestFile)
+        return null;
+    const tail = readJsonlTailEntries(join(dir, bestFile));
+    const evidence = tail && tailEvidence(tail.entries, "claude");
+    return {
+        sessionId: bestFile.slice(0, -".jsonl".length),
+        storeMtimeMs: tail?.mtimeMs ?? bestMtime,
+        tailTimestampMs: evidence?.timestampMs ?? null,
+        tailKind: evidence?.kind ?? null,
+    };
+}
+/**
+ * The exact-cwd session from `state_5.sqlite` (same lookup as #984: newest
+ * interactive thread of this directory, never `--last`), then its threads
+ * row (`updated_at_ms`/`recency_at_ms`) plus rollout tail. The database is
+ * opened read-only (never created, checkpointed, or migrated); an unknown
+ * session or a schema that no longer matches is null (unknown), never a
+ * guess. The session id is discovered from the store, never caller-supplied.
+ */
+export function codexFingerprint(r) {
+    const openDb = r.openDb ?? ((path) => openCodexStateReadonly(path));
+    const rolloutTail = r.rolloutTail ?? ((path) => readJsonlTailEntries(path));
+    const rolloutHasTurn = r.rolloutHasTurn ?? rolloutRecordsTurn;
+    const discoveryOpen = (path) => {
+        let db = null;
+        try {
+            db = openDb(path);
+        }
+        catch { /* fall through to throw */ }
+        if (!db)
+            throw new Error(`codex state unreadable: ${path}`);
+        return db;
+    };
+    let sessionId;
+    try {
+        const lookup = findExactCwdCodexSession(r.stateDbPath, r.cwd, discoveryOpen, rolloutHasTurn);
+        if (lookup.kind !== "found")
+            return null;
+        sessionId = lookup.id;
+    }
+    catch {
+        return null;
+    }
+    let db = null;
+    try {
+        try {
+            db = openDb(r.stateDbPath);
+        }
+        catch {
+            return null;
+        }
+        if (!db)
+            return null;
+        const row = db.prepare("SELECT updated_at_ms, recency_at_ms, rollout_path FROM threads WHERE id = ?").get(sessionId);
+        if (!row)
+            return null;
+        let tailTimestampMs = null;
+        let tailKind = null;
+        let fileMtime = -1;
+        if (typeof row.rollout_path === "string") {
+            const tail = rolloutTail(row.rollout_path);
+            if (tail) {
+                fileMtime = tail.mtimeMs;
+                const evidence = tailEvidence(tail.entries, "codex");
+                tailTimestampMs = evidence?.timestampMs ?? null;
+                tailKind = evidence?.kind ?? null;
+            }
+        }
+        const storeMtimeMs = Math.max(typeof row.updated_at_ms === "number" ? row.updated_at_ms : -1, typeof row.recency_at_ms === "number" ? row.recency_at_ms : -1, fileMtime);
+        return storeMtimeMs < 0
+            ? null
+            : { sessionId, storeMtimeMs, tailTimestampMs, tailKind };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch { /* already closed */ }
+    }
+}
+/** Session-id pattern, mirroring muse.ts (MuseBackend session ids are UUIDs). */
+const MUSE_SESSION_ID_RE = /^[0-9a-fA-F-]{8,}$/;
+/** Log head scanned for the workspace marker, mirroring muse.ts. */
+const MUSE_SESSION_HEAD_BYTES = 65_536;
+/**
+ * The most recently active session started in this working directory,
+ * mirroring MuseBackend.getSessionId (workspace read out of each session's
+ * own log, activity = newest inner-file mtime), plus its newest timestamped
+ * TURN tail entry. The session id is discovered from the store, never
+ * caller-supplied, so a conversation switch surfaces as an id change.
+ */
+export function museFingerprint(r) {
+    if (!r.cwd)
+        return null;
+    let bestId = null;
+    let bestDir = "";
+    let bestActivity = -1;
+    for (const sessionDir of museSessionDirs(r.sessionsRoot)) {
+        const name = sessionDir.slice(sessionDir.lastIndexOf("/") + 1);
+        if (!MUSE_SESSION_ID_RE.test(name))
+            continue;
+        let head;
+        try {
+            head = readFileSync(join(sessionDir, "session.jsonl"), { encoding: "utf-8", flag: "r" })
+                .slice(0, MUSE_SESSION_HEAD_BYTES);
+        }
+        catch {
+            continue;
+        }
+        if (museSessionCwd(head) !== r.cwd)
+            continue;
+        let activity = -1;
+        try {
+            for (const f of readdirSync(sessionDir)) {
+                try {
+                    const m = statSync(join(sessionDir, f)).mtimeMs;
+                    if (m > activity)
+                        activity = m;
+                }
+                catch { /* raced with deletion */ }
+            }
+        }
+        catch { /* unreadable */ }
+        if (activity > bestActivity) {
+            bestActivity = activity;
+            bestId = name;
+            bestDir = sessionDir;
+        }
+    }
+    if (!bestId)
+        return null;
+    const tail = readJsonlTailEntries(join(bestDir, "session.jsonl"));
+    const evidence = tail && tailEvidence(tail.entries, "muse");
+    return {
+        sessionId: bestId,
+        storeMtimeMs: bestActivity,
+        tailTimestampMs: evidence?.timestampMs ?? null,
+        tailKind: evidence?.kind ?? null,
+    };
+}
+//# sourceMappingURL=session-signals.js.map

package/dist/backend/session-signals.js.map

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

package/dist/channel/adapters/discord.d.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from "node:events";
 import { Client, ActionRowBuilder, ButtonBuilder } from "discord.js";
-import type { ChannelAdapter, ApprovalHandle, SendOpts, SentMessage, PermissionPrompt, Choice, AlertData, AdapterHealthSnapshot, TopicPresence } from "../types.js";
+import type { ChannelAdapter, ApprovalHandle, SendOpts, SentMessage, PermissionPrompt, Choice, AlertData, AdapterHealthSnapshot, TopicPresence, StickerInfo, StickerList, StickerPreview, StickerTarget } from "../types.js";
 import type { AccessManager } from "../access-manager.js";
 /** Curated ClassicBot backends for Discord's native slash-option dropdown. */
 export declare const DISCORD_START_BACKEND_CHOICES: readonly [{
@@ -129,6 +129,24 @@ export declare class DiscordAdapter extends EventEmitter implements ChannelAdapt
     private startGatewayWatchdog;
     private checkGatewayLiveness;
     getHealthSnapshot(): AdapterHealthSnapshot;
+    /**
+     * #1231: how late a slash command was by the time it was acknowledged.
+     * `createdTimestamp` is Discord's clock (the interaction's snowflake), so
+     * "age" also carries clock skew; the defer's own round trip is local. Over
+     * half the 3 s window is worth a line: it says whether the time went in
+     * delivery (gateway, a blocked event loop) or in the acknowledgement (REST).
+     */
+    private noteSlashAckTiming;
+    /**
+     * #1231: a slash command whose acknowledgement failed. It is NOT run: the
+     * user was shown "did not respond" (or will be) and may well run it again,
+     * so running it now could do it twice. Already acknowledged (40060) means
+     * another session of this bot answered it — that one handles the command,
+     * so stay silent. Otherwise say so where the user can see it: a private
+     * follow-up when the acknowledgement did land after all, else a message in
+     * the channel, never a silent drop.
+     */
+    private reportSlashDeferFailure;
     /**
      * Update the bot's profile activity without touching any channel messages.
      * Presence is deliberately best-effort: a reconnecting or not-yet-ready
@@ -171,6 +189,25 @@ export declare class DiscordAdapter extends EventEmitter implements ChannelAdapt
         animated: boolean;
         available: boolean;
     }>>;
+    /**
+     * The server a channel belongs to (#1226): stickers are per server, and a bot can send only the stickers of the
+     * server it posts in. In the channels topology `chatId` can be the server id itself; that is the answer then.
+     */
+    private guildOfChannel;
+    /**
+     * The stickers of the server `target`'s channel is in (#1226) — the only ones this bot can send there. Discord's
+     * standard sticker packs are not listed (they are hundreds, and not what an agent picks from).
+     */
+    listStickers(target: StickerTarget): Promise<StickerList>;
+    /** A still picture of a listed sticker, from Discord's media CDN; null for a Lottie sticker (no still image). */
+    fetchStickerPreview(sticker: StickerInfo): Promise<StickerPreview | null>;
+    /**
+     * Stickers on one message (#1226): with the text's last chunk when there is text (Discord sends both together),
+     * alone otherwise. Earlier chunks of a long text go first, as plain messages.
+     */
+    sendStickers(chatId: string, stickers: string[], opts?: SendOpts & {
+        text?: string;
+    }): Promise<SentMessage>;
     /**
      * The servers this bot is a member of, primary first (#1021). A bot can
      * react with a custom emoji from any server it is in, so these are where