@agentdeck/bridge 1.0.1 → 1.0.3

package/dist/card-feed.js

@@ -0,0 +1,277 @@
+/**
+ * Card Feed pull sync (M6) — the HTTP counterpart to the WS live mode for
+ * wake-sync-sleep battery clients (XTeink X3/X4). Pure builders/appliers; the
+ * HTTP routes live in daemon-server.ts. Contract: shared/src/protocol.ts
+ * § Card Feed Pull Sync + docs/esp32-client-contract.md § Pull sync.
+ *
+ * M6 derives every card from a live session (the same rows `sessions_list`
+ * broadcasts). M7 generalizes to daemon card modules (NUDGE / QUEST / …) that
+ * will produce `day`-class cards; until then no producer emits `day`.
+ */
+import { CARD_FEED_IDLE_PULL_SEC, CARD_FEED_ACTIVE_PULL_SEC, } from '@agentdeck/shared';
+import { buildModuleCards, applyModuleChoice, DEFAULT_CARD_MODULES, } from './card-modules.js';
+/** A pulled permission gate is answerable only while the PreToolUse long-poll
+ *  still holds the hook open (~60s) — pulled copies are honest about that. */
+export const PERMISSION_GATE_TTL_MS = 60_000;
+/** Awaiting PTY prompts stay interactive until the awaiting backstop reaps
+ *  them (AWAITING_STUCK_TIMEOUT_MS) — same 10 min bound. */
+export const AWAITING_PROMPT_TTL_MS = 10 * 60 * 1000;
+const isAwaitingState = (s) => typeof s.state === 'string' && s.state.startsWith('awaiting');
+/** Offline-validity class for a session-derived card. Permission gates and
+ *  interactive prompts are `live` (grey out offline, TTL-expire); everything
+ *  else is a read-only `info` row. */
+export function classifySessionCard(s, now) {
+    if (s.requestId)
+        return { actionClass: 'live', expiresAt: now + PERMISSION_GATE_TTL_MS };
+    if (isAwaitingState(s))
+        return { actionClass: 'live', expiresAt: now + AWAITING_PROMPT_TTL_MS };
+    return { actionClass: 'info' };
+}
+export function buildCardFeed(sessions, now = Date.now(), modules = DEFAULT_CARD_MODULES) {
+    const cards = sessions.map((s) => ({
+        cardId: `session:${s.id}`,
+        ...classifySessionCard(s, now),
+        session: s,
+    }));
+    // Module cards (M7) come after the session projections: what is happening
+    // outranks what the daemon wants to say about it. A client that predates
+    // modules skips bodies it doesn't recognise.
+    cards.push(...buildModuleCards({ sessions, now }, modules));
+    const active = sessions.some((s) => s.state === 'processing' || isAwaitingState(s));
+    const d = new Date(now);
+    const serverHm = `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+    return {
+        type: 'card_feed',
+        rev: 1,
+        serverTime: now,
+        serverHm,
+        nextPullSec: active ? CARD_FEED_ACTIVE_PULL_SEC : CARD_FEED_IDLE_PULL_SEC,
+        cards,
+    };
+}
+const OUTBOX_ACTIONS = new Set([
+    'permission_decision', 'select_option', 'respond', 'send_prompt', 'dismiss', 'card_choice',
+]);
+function sessionIdOf(d) {
+    if (typeof d.sessionId === 'string' && d.sessionId)
+        return d.sessionId;
+    if (typeof d.cardId === 'string' && d.cardId.startsWith('session:'))
+        return d.cardId.slice('session:'.length);
+    return undefined;
+}
+function applyOne(d, deps) {
+    const cardId = typeof d.cardId === 'string' ? d.cardId : '';
+    const fail = (status, reason) => ({ cardId, status, reason });
+    if (!cardId || typeof d.action !== 'string' || !OUTBOX_ACTIONS.has(d.action)) {
+        return fail('rejected', 'malformed decision');
+    }
+    // Device-local dismissal — acknowledged so the device can drop it; the
+    // daemon has nothing to mutate (dismissal memory lives on the device).
+    if (d.action === 'dismiss')
+        return { cardId, status: 'applied' };
+    // Module card (M7): the authoring module owns what the choice means. This is
+    // the `day` class in practice — the press may have happened hours ago and
+    // offline, so nothing here is validated against live session state.
+    if (d.action === 'card_choice') {
+        const outcome = applyModuleChoice(d, { sessions: deps.sessions, now: deps.now ?? Date.now() }, deps.modules);
+        return { cardId, status: outcome.status, ...(outcome.reason ? { reason: outcome.reason } : {}) };
+    }
+    if (d.action === 'permission_decision') {
+        if (typeof d.requestId !== 'string' || !d.requestId || (d.decision !== 'allow' && d.decision !== 'deny')) {
+            return fail('rejected', 'requestId and decision required');
+        }
+        // A gate that is no longer held must NOT be re-resolved — the terminal
+        // already answered it, or the hook long-poll gave up. Honest expiry.
+        if (!deps.isPendingRequest(d.requestId))
+            return fail('expired', 'permission gate no longer pending');
+        deps.dispatch({ type: 'permission_decision', requestId: d.requestId, decision: d.decision });
+        return { cardId, status: 'applied' };
+    }
+    const sessionId = sessionIdOf(d);
+    if (!sessionId)
+        return fail('rejected', 'sessionId required');
+    const session = deps.sessions.find((s) => s.id === sessionId);
+    if (!session)
+        return fail('unknown_card', 'session not in current roster');
+    if (d.action === 'select_option' || d.action === 'respond') {
+        // Option decisions answer a *specific* prompt. The session must still be
+        // awaiting, and when the device echoed the question it must match the
+        // session's current one — an hour-old index must never press a different,
+        // newer prompt.
+        if (!isAwaitingState(session) && !session.requestId) {
+            return fail('expired', 'session is no longer awaiting');
+        }
+        if (typeof d.question === 'string' && d.question && session.question && d.question !== session.question) {
+            return fail('expired', 'prompt changed since the decision was recorded');
+        }
+        if (d.action === 'select_option') {
+            if (typeof d.index !== 'number' || !Number.isInteger(d.index) || d.index < 0) {
+                return fail('rejected', 'index required');
+            }
+            deps.dispatch({ type: 'select_option', index: d.index, sessionId });
+        }
+        else {
+            if (typeof d.value !== 'string' || !d.value)
+                return fail('rejected', 'value required');
+            deps.dispatch({ type: 'session_command', sessionId, command: { type: 'respond', value: d.value } });
+        }
+        return { cardId, status: 'applied' };
+    }
+    // send_prompt — deliverable to any alive session; observed sessions queue
+    // it as a turn-end directive via the session_command steering path.
+    if (typeof d.text !== 'string' || !d.text)
+        return fail('rejected', 'text required');
+    deps.dispatch({ type: 'session_command', sessionId, command: { type: 'send_prompt', text: d.text } });
+    return { cardId, status: 'applied' };
+}
+// ===== Pull observability — the only trace a sleeping client leaves =====
+//
+// A wake-sync-sleep client that has nothing queued sends exactly one request
+// per wake: `GET /feed`. It carries no board id and no body, so without this
+// the daemon cannot answer the question the power ladder is judged by — *did
+// the timer wake actually fire, and how far did the internal clock drift?*
+// The tracker turns each pull into that measurement by comparing the gap
+// against the cadence the daemon itself advertised on the previous pull.
+/** Observed cadence within this fraction of the advertised `nextPullSec`
+ *  counts as honoured — the device really slept and its timer really woke it.
+ *  The XTeink boards run a drifty internal timer (no usable RTC alarm), so
+ *  the band is generous; anything outside it is a wake worth looking at. */
+export const PULL_CADENCE_TOLERANCE = 0.25;
+/** `::ffff:192.168.68.77` and `::1` are the same peers as their v4 forms. */
+export function normalizeClientIp(ip) {
+    const s = (ip || '').trim();
+    if (s.startsWith('::ffff:'))
+        return s.slice('::ffff:'.length);
+    if (s === '::1')
+        return '127.0.0.1';
+    return s;
+}
+/** In-memory (daemon-lifetime) record of card-feed pulls, keyed by client IP.
+ *  Deliberately not persisted: it answers "is the cadence working *now*". */
+export class FeedPullTracker {
+    states = new Map();
+    history = [];
+    historyLimit;
+    /** Kept past the WiFi registry's 1h TTL: a client that sleeps for an hour
+     *  ages out of the roster but must not lose its name here. */
+    boards = new Map();
+    intervalWindow = 16;
+    constructor(opts = {}) {
+        this.historyLimit = opts.historyLimit ?? 32;
+    }
+    /** Bind a board id to a client IP (outbox `board`, or a WiFi WS lookup). */
+    noteBoard(client, board) {
+        const ip = normalizeClientIp(client);
+        if (!ip || !board)
+            return;
+        this.boards.set(ip, board);
+        const st = this.states.get(ip);
+        if (st)
+            st.board = board;
+    }
+    record(client, info) {
+        const ip = normalizeClientIp(client);
+        const at = info.now ?? Date.now();
+        const prev = this.states.get(ip);
+        const board = this.boards.get(ip) ?? prev?.board;
+        const event = { client: ip, at, cards: info.cards, nextPullSec: info.nextPullSec };
+        if (board)
+            event.board = board;
+        if (prev) {
+            const sinceLastSec = Math.round((at - prev.lastPullAt) / 1000);
+            event.sinceLastSec = sinceLastSec;
+            const expectedSec = prev.lastNextPullSec;
+            if (expectedSec > 0) {
+                event.expectedSec = expectedSec;
+                event.driftPct = Math.round(((sinceLastSec - expectedSec) / expectedSec) * 1000) / 1000;
+                event.cadenceHonoured = Math.abs(event.driftPct) <= PULL_CADENCE_TOLERANCE;
+            }
+            prev.pulls += 1;
+            prev.lastPullAt = at;
+            prev.lastNextPullSec = info.nextPullSec;
+            prev.lastIntervalSec = sinceLastSec;
+            prev.intervals.push(sinceLastSec);
+            if (prev.intervals.length > this.intervalWindow)
+                prev.intervals.shift();
+            if (event.cadenceHonoured)
+                prev.cadenceHonouredCount += 1;
+            if (board)
+                prev.board = board;
+        }
+        else {
+            this.states.set(ip, {
+                board,
+                pulls: 1,
+                firstPullAt: at,
+                lastPullAt: at,
+                lastNextPullSec: info.nextPullSec,
+                intervals: [],
+                cadenceHonouredCount: 0,
+            });
+        }
+        this.history.push(event);
+        if (this.history.length > this.historyLimit)
+            this.history.shift();
+        return event;
+    }
+    /** Most recent pulls, newest first. */
+    recent(limit = 8) {
+        return this.history.slice(-limit).reverse();
+    }
+    clients() {
+        const out = [];
+        for (const [client, st] of this.states) {
+            const sorted = [...st.intervals].sort((a, b) => a - b);
+            const median = sorted.length
+                ? (sorted.length % 2
+                    ? sorted[(sorted.length - 1) / 2]
+                    : Math.round((sorted[sorted.length / 2 - 1] + sorted[sorted.length / 2]) / 2))
+                : undefined;
+            out.push({
+                client,
+                ...(st.board ? { board: st.board } : {}),
+                pulls: st.pulls,
+                firstPullAt: st.firstPullAt,
+                lastPullAt: st.lastPullAt,
+                lastNextPullSec: st.lastNextPullSec,
+                ...(st.lastIntervalSec !== undefined ? { lastIntervalSec: st.lastIntervalSec } : {}),
+                ...(median !== undefined ? { medianIntervalSec: median } : {}),
+                cadenceHonouredCount: st.cadenceHonouredCount,
+            });
+        }
+        return out.sort((a, b) => b.lastPullAt - a.lastPullAt);
+    }
+}
+/** One-line log form. `+3.2%` is the sleeping client's timer drift against the
+ *  cadence the daemon advertised — the M6 power-ladder verification signal. */
+export function formatFeedPull(ev) {
+    const who = ev.board ? `${ev.board} (${ev.client})` : ev.client;
+    const head = `card feed pull from ${who}: ${ev.cards} card${ev.cards === 1 ? '' : 's'}, next ${ev.nextPullSec}s`;
+    if (ev.sinceLastSec === undefined)
+        return `${head} — first pull`;
+    if (ev.expectedSec === undefined)
+        return `${head} — ${ev.sinceLastSec}s since last pull`;
+    const pct = `${ev.driftPct !== undefined && ev.driftPct >= 0 ? '+' : ''}${((ev.driftPct ?? 0) * 100).toFixed(1)}%`;
+    const verdict = ev.cadenceHonoured ? 'cadence ok' : 'off cadence';
+    return `${head} — ${ev.sinceLastSec}s since last pull (expected ${ev.expectedSec}s, ${pct}, ${verdict})`;
+}
+/** Apply a pushed outbox batch. Results keep request order; every decision is
+ *  acknowledged (the device deletes acknowledged entries regardless of
+ *  status — a rejection is terminal, not retryable). */
+export function applyOutboxDecisions(req, deps) {
+    const decisions = Array.isArray(req?.decisions) ? req.decisions : [];
+    const results = decisions.map((d) => {
+        try {
+            return applyOne(d ?? {}, deps);
+        }
+        catch (err) {
+            return {
+                cardId: typeof d?.cardId === 'string' ? d.cardId : '',
+                status: 'error',
+                reason: err instanceof Error ? err.message : String(err),
+            };
+        }
+    });
+    return { ok: results.every((r) => r.status !== 'error'), results };
+}
+//# sourceMappingURL=card-feed.js.map

package/dist/card-feed.js.map

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

package/dist/card-modules.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Card modules (M7) — the daemon's own card producers.
+ *
+ * M6 cards are all projections of a live session: the daemon reports what is
+ * happening and the device renders it. A module card inverts that — the daemon
+ * *authors* a card (a checkpoint, a digest, a nudge) and the device carries it
+ * as a prepared decision, answerable even while offline.
+ *
+ * Contract: shared/src/protocol.ts § Card modules. Two rules hold here and are
+ * enforced structurally rather than by convention, because a firmware that
+ * receives a malformed card has no good move:
+ *
+ *  1. **≤4 choices, always.** Slot 1 of the four front buttons is the device's
+ *     own *Later*, so a module binds at most three. `sealModuleCard` clamps.
+ *  2. **Bytes, not characters.** Every text field is trimmed to a UTF-8 byte
+ *     budget on a code-point boundary — a firmware `char[]` truncates
+ *     mid-sequence into broken glyphs otherwise.
+ *
+ * Routing: a module card's `cardId` is `module:<moduleId>:<key>`, which is how
+ * an outbox `card_choice` recorded hours ago finds its way back to the module
+ * that authored it.
+ */
+import type { SessionInfo, FeedCard, CardChoice, CardModuleId, CardActionClass, OutboxDecision, OutboxDecisionStatus } from '@agentdeck/shared';
+/** Text budgets, in UTF-8 bytes, matched to the device's card buffers
+ *  (`question[160]`, `PromptOption.label[80]` in the fork's agent_state.h).
+ *  A re-port that grows a buffer bumps these together with it. */
+export declare const CARD_TITLE_MAX_BYTES = 24;
+export declare const CARD_QUESTION_MAX_BYTES = 160;
+export declare const CARD_CONTEXT_LINE_MAX_BYTES = 96;
+export declare const CARD_CHOICE_LABEL_MAX_BYTES = 40;
+export declare const CARD_ID_PREFIX = "module:";
+export declare function moduleCardId(module: CardModuleId, key: string): string;
+/** Split `module:<moduleId>:<key>`. Returns undefined for session card ids. */
+export declare function parseModuleCardId(cardId: string): {
+    module: string;
+    key: string;
+} | undefined;
+/** What a module returns; ids/limits are applied by `sealModuleCard`. */
+export interface ModuleCardDraft {
+    /** Unique within the module. Combined into `module:<id>:<key>`. */
+    key: string;
+    actionClass: CardActionClass;
+    expiresAt?: number;
+    title: string;
+    question: string;
+    context?: string[];
+    choices?: CardChoice[];
+    sessionId?: string;
+}
+/**
+ * The single chokepoint every module card passes through. Clamps rather than
+ * rejects: a module that over-produces should still show its question, minus
+ * the parts that cannot fit a four-button e-ink card.
+ */
+export declare function sealModuleCard(module: CardModuleId, draft: ModuleCardDraft): FeedCard;
+export interface CardModuleContext {
+    /** The same enriched roster `sessions_list` broadcasts. */
+    sessions: SessionInfo[];
+    now: number;
+}
+export interface CardChoiceOutcome {
+    status: OutboxDecisionStatus;
+    reason?: string;
+}
+export interface CardModule {
+    id: CardModuleId;
+    /** Cards this module wants in the feed right now. Called per pull, so it
+     *  must be cheap and must not block. */
+    build(ctx: CardModuleContext): ModuleCardDraft[];
+    /** Apply a choice the user pressed, possibly hours ago and offline. Modules
+     *  that produce no choices need not implement it. The returned status is
+     *  terminal — the device drops the decision either way. */
+    apply?(decision: OutboxDecision & {
+        choiceId?: string;
+    }, key: string, ctx: CardModuleContext): CardChoiceOutcome;
+}
+export declare const threadModule: CardModule;
+/** Modules that run by default. Order is feed order after the session cards. */
+export declare const DEFAULT_CARD_MODULES: CardModule[];
+/** Build every module's cards, sealed. A module that throws is skipped — one
+ *  bad producer must not cost the device its whole feed. */
+export declare function buildModuleCards(ctx: CardModuleContext, modules?: CardModule[]): FeedCard[];
+/** Route a `card_choice` decision back to the module that authored the card. */
+export declare function applyModuleChoice(decision: OutboxDecision & {
+    choiceId?: string;
+}, ctx: CardModuleContext, modules?: CardModule[]): CardChoiceOutcome;
+//# sourceMappingURL=card-modules.d.ts.map

package/dist/card-modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-modules.d.ts","sourceRoot":"","sources":["../src/card-modules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EAER,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAO3B;;kEAEkE;AAClE,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAC9C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAM7F;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,eAAe,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,QAAQ,CA4BrF;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,YAAY,CAAC;IACjB;4CACwC;IACxC,KAAK,CAAC,GAAG,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAAC;IACjD;;+DAE2D;IAC3D,KAAK,CAAC,CACJ,QAAQ,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EAChD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,iBAAiB,GACrB,iBAAiB,CAAC;CACtB;AA6BD,eAAO,MAAM,YAAY,EAAE,UAiC1B,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,oBAAoB,EAAE,UAAU,EAAmB,CAAC;AAEjE;4DAC4D;AAC5D,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,UAAU,EAAyB,GAC3C,QAAQ,EAAE,CAYZ;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAChD,GAAG,EAAE,iBAAiB,EACtB,OAAO,GAAE,UAAU,EAAyB,GAC3C,iBAAiB,CAgBnB"}

package/dist/card-modules.js

@@ -0,0 +1,179 @@
+/**
+ * Card modules (M7) — the daemon's own card producers.
+ *
+ * M6 cards are all projections of a live session: the daemon reports what is
+ * happening and the device renders it. A module card inverts that — the daemon
+ * *authors* a card (a checkpoint, a digest, a nudge) and the device carries it
+ * as a prepared decision, answerable even while offline.
+ *
+ * Contract: shared/src/protocol.ts § Card modules. Two rules hold here and are
+ * enforced structurally rather than by convention, because a firmware that
+ * receives a malformed card has no good move:
+ *
+ *  1. **≤4 choices, always.** Slot 1 of the four front buttons is the device's
+ *     own *Later*, so a module binds at most three. `sealModuleCard` clamps.
+ *  2. **Bytes, not characters.** Every text field is trimmed to a UTF-8 byte
+ *     budget on a code-point boundary — a firmware `char[]` truncates
+ *     mid-sequence into broken glyphs otherwise.
+ *
+ * Routing: a module card's `cardId` is `module:<moduleId>:<key>`, which is how
+ * an outbox `card_choice` recorded hours ago finds its way back to the module
+ * that authored it.
+ */
+import { CARD_MAX_CHOICES, CARD_MAX_CONTEXT_LINES, truncateUtf8Bytes, } from '@agentdeck/shared';
+/** Text budgets, in UTF-8 bytes, matched to the device's card buffers
+ *  (`question[160]`, `PromptOption.label[80]` in the fork's agent_state.h).
+ *  A re-port that grows a buffer bumps these together with it. */
+export const CARD_TITLE_MAX_BYTES = 24;
+export const CARD_QUESTION_MAX_BYTES = 160;
+export const CARD_CONTEXT_LINE_MAX_BYTES = 96;
+export const CARD_CHOICE_LABEL_MAX_BYTES = 40;
+export const CARD_ID_PREFIX = 'module:';
+export function moduleCardId(module, key) {
+    return `${CARD_ID_PREFIX}${module}:${key}`;
+}
+/** Split `module:<moduleId>:<key>`. Returns undefined for session card ids. */
+export function parseModuleCardId(cardId) {
+    if (typeof cardId !== 'string' || !cardId.startsWith(CARD_ID_PREFIX))
+        return undefined;
+    const rest = cardId.slice(CARD_ID_PREFIX.length);
+    const sep = rest.indexOf(':');
+    if (sep <= 0)
+        return undefined;
+    return { module: rest.slice(0, sep), key: rest.slice(sep + 1) };
+}
+/**
+ * The single chokepoint every module card passes through. Clamps rather than
+ * rejects: a module that over-produces should still show its question, minus
+ * the parts that cannot fit a four-button e-ink card.
+ */
+export function sealModuleCard(module, draft) {
+    const choices = (draft.choices ?? [])
+        .filter((c) => c && typeof c.id === 'string' && c.id && typeof c.label === 'string' && c.label)
+        .slice(0, CARD_MAX_CHOICES)
+        .map((c) => ({
+        id: c.id,
+        label: truncateUtf8Bytes(c.label, CARD_CHOICE_LABEL_MAX_BYTES),
+        ...(c.intent ? { intent: c.intent } : {}),
+    }));
+    const context = (draft.context ?? [])
+        .filter((l) => typeof l === 'string' && l.length > 0)
+        .slice(0, CARD_MAX_CONTEXT_LINES)
+        .map((l) => truncateUtf8Bytes(l, CARD_CONTEXT_LINE_MAX_BYTES));
+    const body = {
+        module,
+        title: truncateUtf8Bytes(draft.title, CARD_TITLE_MAX_BYTES),
+        question: truncateUtf8Bytes(draft.question, CARD_QUESTION_MAX_BYTES),
+        ...(context.length ? { context } : {}),
+        ...(choices.length ? { choices } : {}),
+        ...(draft.sessionId ? { sessionId: draft.sessionId } : {}),
+    };
+    return {
+        cardId: moduleCardId(module, draft.key),
+        actionClass: draft.actionClass,
+        ...(draft.expiresAt !== undefined ? { expiresAt: draft.expiresAt } : {}),
+        module: body,
+    };
+}
+// ===== THREAD — the reference module =====
+//
+// The checkpoint card: where the open threads stopped. It is `info` (no
+// choices) and derives entirely from the live roster, so it introduces no new
+// state, no persistence and no product policy — its job is to prove the module
+// path end to end. NUDGE / QUEST (the first `day`-class, answerable modules)
+// need a store and an authoring path, and are deliberately not guessed at here.
+/** A thread is worth checkpointing only if it is a real, alive session. */
+const THREAD_MAX_LINES = CARD_MAX_CONTEXT_LINES;
+function threadLine(s) {
+    const project = s.projectName || s.agentType || 'session';
+    if (typeof s.state === 'string' && s.state.startsWith('awaiting')) {
+        return `${project} — waiting on you`;
+    }
+    if (s.state === 'processing') {
+        const mins = typeof s.elapsedSec === 'number' && s.elapsedSec > 0 ? Math.round(s.elapsedSec / 60) : 0;
+        const tool = typeof s.currentTool === 'string' && s.currentTool ? ` ${s.currentTool}` : '';
+        return `${project} — working${tool}${mins > 0 ? ` ${mins}m` : ''}`;
+    }
+    // Idle: what it was last doing is the checkpoint — that is the whole point of
+    // the card. `currentTask` is the daemon-computed milestone line.
+    const task = typeof s.currentTask === 'string' && s.currentTask ? s.currentTask : '';
+    return task ? `${project} — ${task}` : `${project} — idle`;
+}
+export const threadModule = {
+    id: 'thread',
+    build(ctx) {
+        const alive = ctx.sessions.filter((s) => s.alive !== false);
+        if (alive.length === 0)
+            return [];
+        // Attention first, then work in progress, then the rest: the top lines are
+        // the ones worth reading if only the first line is legible across a room.
+        const rank = (s) => {
+            if (typeof s.state === 'string' && s.state.startsWith('awaiting'))
+                return 0;
+            if (s.state === 'processing')
+                return 1;
+            return 2;
+        };
+        const ordered = [...alive].sort((a, b) => rank(a) - rank(b));
+        const shown = ordered.slice(0, THREAD_MAX_LINES);
+        const hidden = ordered.length - shown.length;
+        const waiting = alive.filter((s) => typeof s.state === 'string' && s.state.startsWith('awaiting')).length;
+        const question = waiting > 0
+            ? `${waiting} of ${alive.length} threads need you`
+            : `${alive.length} thread${alive.length === 1 ? '' : 's'} open`;
+        const context = shown.map((s) => threadLine(s));
+        // An honest count beats a silently truncated list — the device shows one
+        // screen, so say what did not fit rather than implying this is all of it.
+        if (hidden > 0)
+            context[context.length - 1] = `${context[context.length - 1]} (+${hidden} more)`;
+        return [{
+                key: 'open',
+                actionClass: 'info',
+                title: 'THREAD',
+                question,
+                context,
+            }];
+    },
+};
+/** Modules that run by default. Order is feed order after the session cards. */
+export const DEFAULT_CARD_MODULES = [threadModule];
+/** Build every module's cards, sealed. A module that throws is skipped — one
+ *  bad producer must not cost the device its whole feed. */
+export function buildModuleCards(ctx, modules = DEFAULT_CARD_MODULES) {
+    const out = [];
+    for (const m of modules) {
+        let drafts;
+        try {
+            drafts = m.build(ctx) ?? [];
+        }
+        catch {
+            continue;
+        }
+        for (const d of drafts)
+            out.push(sealModuleCard(m.id, d));
+    }
+    return out;
+}
+/** Route a `card_choice` decision back to the module that authored the card. */
+export function applyModuleChoice(decision, ctx, modules = DEFAULT_CARD_MODULES) {
+    const parsed = parseModuleCardId(decision.cardId);
+    if (!parsed)
+        return { status: 'rejected', reason: 'not a module card id' };
+    if (typeof decision.choiceId !== 'string' || !decision.choiceId) {
+        return { status: 'rejected', reason: 'choiceId required' };
+    }
+    const mod = modules.find((m) => m.id === parsed.module);
+    // Unknown module, or a read-only one: the card is gone as far as the daemon
+    // is concerned, which is terminal for the device either way.
+    if (!mod)
+        return { status: 'unknown_card', reason: `no module '${parsed.module}'` };
+    if (!mod.apply)
+        return { status: 'rejected', reason: `module '${parsed.module}' takes no choices` };
+    try {
+        return mod.apply(decision, parsed.key, ctx);
+    }
+    catch (err) {
+        return { status: 'error', reason: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=card-modules.js.map

package/dist/card-modules.js.map

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

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyLpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAOtF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAoBD,QAAA,MAAM,OAAO,SAAgB,CAAC;AAg6D9B,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA2LpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAM,CAAC;AAOtF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElE;AAoBD,QAAA,MAAM,OAAO,SAAgB,CAAC;AA4/D9B,wBAAsB,MAAM,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}