@agentdeck/bridge 1.0.24 → 1.2.0

package/dist/relayed-usage.js

@@ -0,0 +1,103 @@
+import { mergeRelayedSessionUsage } from './usage-event.js';
+import { pickBestCodexRateLimits } from './codex-rate-limits-live.js';
+/**
+ * Decide what the daemon broadcasts when a session bridge relays a
+ * `usage_update`, and keep that decision out of the callback it used to be
+ * inlined in.
+ *
+ * A session bridge broadcasts usage on EVERY state change. In daemon-first mode
+ * its snapshot usually has no model context, so the Claude quota model gate
+ * (`isClaudeSubscriptionModel`) yields no percents and the event carries
+ * `usageStale=true`. Forwarding that bare event verbatim clobbered the daemon's
+ * own authoritative aggregate on the dashboard: the Claude gauge blanked to
+ * "No usage data" on every state tick (the Codex gauge, which ignores global
+ * staleness, stayed put — hence the Claude-only flicker).
+ *
+ * Suppressing the relay instead is NOT an option: `usage_update` is the ONLY
+ * carrier of per-session tokens / cost / duration (`state_update` has none of
+ * those fields), and the daemon's own `buildUsage()` reads a UsageTracker that
+ * no PTY ever feeds, so its session half is zeros. Dropping the event would
+ * blank the session numbers for every focus that legitimately carries no Claude
+ * quota — Codex, OpenCode, API billing.
+ *
+ * So the event is split by HALF, not by event: the ACCOUNT half (quota, scoped
+ * caps, extra usage, subscriptions, Codex/Ollama, `usageStale`) comes from the
+ * daemon's authoritative aggregate, the SESSION half from the relay.
+ *
+ * ## Why the Claude-bearing branch is not just the same merge
+ *
+ * When the relay carries Claude percentages the event already holds the account
+ * half the merge exists to protect, so it goes out as-is — except for
+ * `codexRateLimits`, which is the one account-half field a session bridge
+ * cannot compute as well as the daemon. A bridge keeps host processes off by
+ * design, so it has only the passive rollout read; the daemon additionally
+ * holds a throttled `codex app-server` reading. They agree whenever a
+ * plan-matching rollout exists. When none does, the daemon holds a live
+ * snapshot with real windows while the bridge holds a mismatched one that
+ * `normalizeCodexRateLimits` voids to a windowless block — and successive
+ * events then alternated between a real Codex window and a voided one, which
+ * reads as a flickering/blanking Codex gauge on every surface (issue #253).
+ *
+ * The two blocks are RECONCILED rather than one overwriting the other, by the
+ * same `pickBestCodexRateLimits` rule the daemon already applies to its own two
+ * readings. Both inputs arrive already normalized against the same `auth.json`
+ * by their own producer, so no account tier is read here: voiding has already
+ * stripped `capturedAt` from a mismatched block, which is exactly what makes it
+ * lose to a stamped one under plan-agnostic newest-wins. That matters in both
+ * directions — the daemon's block is normally the better one, but a bridge that
+ * just read a newer rollout than the daemon's last build still wins on recency.
+ *
+ * Recency rules WITHIN a limit family, not across one, and this call site is
+ * where that distinction bites hardest. A bridge has only the passive read, so
+ * once the account's weekly quota is exhausted its block is the per-model pool
+ * wearing the account's `limit_id` — and always seconds old, because the rollout
+ * is appended every couple of seconds while Codex works. So a cross-family
+ * disagreement is resolved toward the daemon's block rather than by age.
+ *
+ * But only when the daemon actually HAS that answer. `lastBuiltCodexRateLimits`
+ * is the daemon's last published value, which is the app-server reading only
+ * when it won its own pick — a daemon whose PATH carries no `codex` binary holds
+ * nothing but a rollout read, exactly like the bridge. Deciding a cross-family
+ * disagreement between two rollout reads by which process is holding one is not
+ * a rule, and with the roles reversed (the daemon on the mislabelled pool line,
+ * the bridge on the account line) it would invert the fix it exists to deliver.
+ * So `ownLiveFamilyAuthorityExpiresAtMs` gates the guard — an instant, judged
+ * against this event's clock, because the flag is produced by a usage build and
+ * consumed here later; without it the tie falls back to recency as before. A second bound applies whenever the guard does fire: a
+ * block with no weekly window — the synthetic credit gauge, a voided snapshot —
+ * can never reject anything, so a windowless block cannot displace a windowed
+ * one. Inside one family nothing changes: the fresher rollout still wins.
+ *
+ * ## Why `buildOwnUsage` is a thunk
+ *
+ * `BridgeCore.buildUsage()` is the call that arms the throttled `codex
+ * app-server` spawn gate and re-derives the whole account half. It must run on
+ * the merged branch only — the Claude-bearing branch is the daemon's most
+ * flicker-sensitive path, and its entire history is about not clobbering the
+ * dashboard. Passing it as a thunk puts that in the signature instead of in a
+ * comment, so a test can assert it was never called.
+ *
+ * `ownCodexRateLimits` is the block from the daemon's own last built usage
+ * event — a remembered value, never a fresh build, so reading it costs nothing
+ * and cannot arm the spawn. Null before the daemon has built one, in which case
+ * the relayed block stands, which is the pre-#253 behaviour.
+ */
+export function resolveRelayedUsageEvent(input) {
+    const { relayed, ownCodexRateLimits, ownLiveFamilyAuthorityExpiresAtMs = null, nowMs = Date.now(), buildOwnUsage, } = input;
+    const hasClaudeData = relayed.fiveHourPercent != null || relayed.sevenDayPercent != null;
+    if (!hasClaudeData) {
+        return mergeRelayedSessionUsage(buildOwnUsage(), relayed);
+    }
+    const relayedCodex = (relayed.codexRateLimits ?? null);
+    const best = pickBestCodexRateLimits(relayedCodex, ownCodexRateLimits, undefined, nowMs, {
+        liveOwnsFamilyAuthority: ownLiveFamilyAuthorityExpiresAtMs != null && nowMs < ownLiveFamilyAuthorityExpiresAtMs,
+    });
+    // Identity, not deep-equality: the picker returns one of its two arguments, so
+    // an unchanged pick must leave the relayed event object untouched — including
+    // an absent `codexRateLimits` key, which under retain-on-absent merging is
+    // "no information" and must not become an explicit `undefined`.
+    if (best === relayedCodex)
+        return relayed;
+    return { ...relayed, codexRateLimits: best ?? undefined };
+}
+//# sourceMappingURL=relayed-usage.js.map

package/dist/relayed-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relayed-usage.js","sourceRoot":"","sources":["../src/relayed-usage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAaxC;IACC,MAAM,EACJ,OAAO,EACP,kBAAkB,EAClB,iCAAiC,GAAG,IAAI,EACxC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,EAClB,aAAa,GACd,GAAG,KAAK,CAAC;IAEV,MAAM,aAAa,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,IAAI,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACzF,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,wBAAwB,CAAC,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,IAAI,CAA2B,CAAC;IACjF,MAAM,IAAI,GAAG,uBAAuB,CAAC,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,KAAK,EAAE;QACvF,uBAAuB,EACrB,iCAAiC,IAAI,IAAI,IAAI,KAAK,GAAG,iCAAiC;KACzF,CAAC,CAAC;IACH,+EAA+E;IAC/E,8EAA8E;IAC9E,2EAA2E;IAC3E,gEAAgE;IAChE,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,OAAgC,CAAC;IACnE,OAAO,EAAE,GAAI,OAAiC,EAAE,eAAe,EAAE,IAAI,IAAI,SAAS,EAAE,CAAC;AACvF,CAAC"}

package/dist/session-aggregator.d.ts

@@ -25,6 +25,9 @@ export interface EnrichedSession {
     contextPercent?: number;
     totalTokens?: number;
     question?: string;
+    /** Supporting lines under `question` (reason approval is required, cwd,
+     *  originating session key). Mirrors `SessionInfo.questionDetail`. */
+    questionDetail?: string;
     requestId?: string;
     promptType?: 'yes_no' | 'yes_no_always' | 'multi_select' | 'diff_review';
     options?: PromptOption[];

package/dist/session-aggregator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-aggregator.d.ts","sourceRoot":"","sources":["../src/session-aggregator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-aggregator.d.ts","sourceRoot":"","sources":["../src/session-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wGAAwG;IACxG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;0EACsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,CAAC;IACzE,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB;;kFAE8E;IAC9E,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kHAAkH;IAClH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;yFACqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;6EAEyE;IACzE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;oFAEgF;IAChF,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAaD,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAIzI;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAUhJ;AAED,uFAAuF;AACvF,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAG9D;AAoBD;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,YAAY,EAAE,EACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CA2C5B;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,MAAM,EACrB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,eAAe,EAAE,CAAC,CAI5B"}

package/dist/session-aggregator.js.map

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

package/dist/session-registry.d.ts

@@ -171,6 +171,7 @@ export declare function probeDaemonHealth(port: number): Promise<{
     mode?: string;
     pid?: number;
     isSwift?: boolean;
+    build?: string;
     sameSocketControl?: boolean;
     pairingToken?: string;
     posture?: {

package/dist/session-registry.d.ts.map

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

package/dist/surface-protocol.d.ts

@@ -0,0 +1,84 @@
+export declare const SURFACE_PROTOCOL_MAJOR: 1;
+export declare const PORTABLE_READER_PROFILE: "portable-reader/v1";
+export declare const OTA_RESUME_PARTIAL_CAPABILITY: "ota.resume-206";
+export declare const AGENTDECK_FIRMWARE_PRODUCT_ID: "dev.agentdeck.dashboard-firmware";
+export declare const POCKET_DAILY_PRODUCT_ID: "io.pocketdaily.reader";
+export declare const SURFACE_SERVER_VERSION: string;
+declare const PROFILE_CAPABILITIES: {
+    readonly 'dashboard-live/v1': Set<string>;
+    readonly 'companion-control/v1': Set<string>;
+    readonly "portable-reader/v1": Set<string>;
+    readonly 'display-only/v1': Set<string>;
+};
+export type SurfaceProfileId = keyof typeof PROFILE_CAPABILITIES;
+export interface SurfaceIdentity {
+    protocol: 1;
+    profile: SurfaceProfileId;
+    clientId: string;
+    clientVersion: string;
+    productId: string;
+    capabilities: string[];
+    board: string;
+    updateChannel: string;
+}
+export interface SurfaceOffer {
+    protocol?: unknown;
+    clientId?: unknown;
+    clientVersion?: unknown;
+    productId?: unknown;
+    profiles?: unknown;
+}
+export interface SurfaceWelcome {
+    type: 'surface_welcome';
+    protocol: 1;
+    profile: SurfaceProfileId;
+    capabilities: string[];
+    serverVersion: string;
+}
+export interface SurfaceNegotiation {
+    clientId: string;
+    clientVersion: string;
+    productId: string;
+    profile: SurfaceProfileId;
+    capabilities: string[];
+    welcome: SurfaceWelcome;
+}
+export declare class SurfaceProtocolError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+type HeaderRecord = Record<string, string | string[] | undefined>;
+export interface SurfaceOtaIdentity {
+    productId: string;
+    board: string;
+    updateChannel: string;
+}
+/** Validate an OTA namespace independently of an HTTP request. Staging and
+ * serving both call this so a product-aware image can never fall back to a
+ * board-only namespace. */
+export declare function validateSurfaceOtaIdentity(identity: SurfaceOtaIdentity): SurfaceOtaIdentity;
+/** Parse the all-or-nothing HTTP Surface declaration. No Surface headers is
+ * the legacy baseline; one or more headers means all eight must be valid. */
+export declare function parseHttpSurfaceIdentity(headers: HeaderRecord, requiredCapability?: string): SurfaceIdentity | undefined;
+/** Select the resumable OTA response shape without guessing from a client
+ * version. Legacy clients append `?from=` bodies but only accept status 200;
+ * negotiated clients explicitly opt into the standard 206 response. */
+export declare function pullOtaResponseStatus(from: number, identity: Pick<SurfaceIdentity, 'capabilities'> | undefined): 200 | 206;
+/** A product-aware request may repeat the tuple in the query, but repetition
+ * is correlation, not override: every supplied member must match the headers. */
+export declare function validateSurfaceQueryTuple(identity: SurfaceIdentity, params: URLSearchParams): void;
+export declare function negotiateSurface(offer: SurfaceOffer): SurfaceNegotiation;
+export declare function surfaceErrorBody(error: SurfaceProtocolError): {
+    error: string;
+    message: string;
+};
+export declare function isPortableReaderProfile(profile: string | undefined): boolean;
+/** Public WS event boundary for a negotiated profile. The portable profile is
+ * deliberately pull-first and does not inherit private dashboard broadcasts. */
+export declare function surfaceAllowsEvent(profile: SurfaceProfileId, eventType: string): boolean;
+/** Additive projection switch: negotiated headers are preferred, while the
+ * historical query remains valid for old Pocket builds. */
+export declare function usesPortableReaderProjection(identity: SurfaceIdentity | undefined, params: URLSearchParams): boolean;
+export {};
+//# sourceMappingURL=surface-protocol.d.ts.map

package/dist/surface-protocol.d.ts.map

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

package/dist/surface-protocol.js

@@ -0,0 +1,237 @@
+import { createRequire } from 'node:module';
+import { ESP32_BOARDS } from '@agentdeck/shared';
+export const SURFACE_PROTOCOL_MAJOR = 1;
+export const PORTABLE_READER_PROFILE = 'portable-reader/v1';
+export const OTA_RESUME_PARTIAL_CAPABILITY = 'ota.resume-206';
+export const AGENTDECK_FIRMWARE_PRODUCT_ID = 'dev.agentdeck.dashboard-firmware';
+export const POCKET_DAILY_PRODUCT_ID = 'io.pocketdaily.reader';
+const packageJson = createRequire(import.meta.url)('../package.json');
+export const SURFACE_SERVER_VERSION = packageJson.version;
+const PROFILE_CAPABILITIES = {
+    'dashboard-live/v1': new Set([
+        'sessions.read', 'usage.read', 'timeline.read', 'display-state.read',
+    ]),
+    'companion-control/v1': new Set([
+        'sessions.read', 'usage.read', 'session.focus', 'permission.decide',
+        'prompt.select', 'session.prompt', 'session.interrupt', 'session.escape', 'review.run',
+    ]),
+    [PORTABLE_READER_PROFILE]: new Set([
+        'feed.pull', 'feed.conditional', 'outbox.push', 'glance.read',
+        'weather.snapshot.read', 'weather.cues.display', 'weather.cues.notify',
+        'learning.pack.read', 'learning.pack.update',
+        'font.pack.read', 'font.pack.update',
+        'ota.feed', OTA_RESUME_PARTIAL_CAPABILITY, 'device.telemetry',
+        // Deliberately no inbox.ws until the public invalidation runtime exists.
+    ]),
+    'display-only/v1': new Set([
+        'sessions.read', 'usage.read', 'timeline.read', 'display-state.read',
+    ]),
+};
+const PRODUCT_RULES = {
+    [POCKET_DAILY_PRODUCT_ID]: {
+        profiles: new Set([PORTABLE_READER_PROFILE]),
+        boards: new Set(['xteink_x3', 'xteink_x4']),
+        channels: new Set(['stable']),
+    },
+    [AGENTDECK_FIRMWARE_PRODUCT_ID]: {
+        profiles: new Set([PORTABLE_READER_PROFILE]),
+        boards: new Set(ESP32_BOARDS.map((board) => board.id)),
+        channels: new Set(['stable']),
+    },
+};
+const HEADER_NAMES = {
+    protocol: 'agentdeck-surface-protocol',
+    profile: 'agentdeck-surface-profile',
+    clientId: 'agentdeck-client-id',
+    clientVersion: 'agentdeck-client-version',
+    productId: 'agentdeck-product-id',
+    capabilities: 'agentdeck-capabilities',
+    board: 'agentdeck-board',
+    updateChannel: 'agentdeck-update-channel',
+};
+export class SurfaceProtocolError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+    }
+}
+function header(headers, name) {
+    const raw = headers[name];
+    if (Array.isArray(raw))
+        return raw.length === 1 ? raw[0]?.trim() : undefined;
+    return typeof raw === 'string' ? raw.trim() : undefined;
+}
+function boundedToken(value, label, max = 128) {
+    if (!value || value.length > max || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value)) {
+        throw new SurfaceProtocolError(400, 'surface_identity_invalid', `${label} is malformed`);
+    }
+    return value;
+}
+function knownProfile(value) {
+    if (!Object.prototype.hasOwnProperty.call(PROFILE_CAPABILITIES, value)) {
+        throw new SurfaceProtocolError(406, 'surface_profile_unsupported', `Surface profile "${value}" is not supported`);
+    }
+    return value;
+}
+function capabilityIntersection(profile, offered) {
+    if (!Array.isArray(offered))
+        return [];
+    const known = PROFILE_CAPABILITIES[profile];
+    const out = [];
+    for (const value of offered) {
+        if (typeof value !== 'string' || !known.has(value) || out.includes(value))
+            continue;
+        out.push(value);
+    }
+    return out;
+}
+function validateProductTuple(identity) {
+    const rule = PRODUCT_RULES[identity.productId];
+    if (!rule) {
+        throw new SurfaceProtocolError(422, 'surface_product_unsupported', `Surface product "${identity.productId}" is not registered`);
+    }
+    if (!rule.profiles.has(identity.profile)) {
+        throw new SurfaceProtocolError(409, 'surface_product_profile_mismatch', 'Surface product and profile do not match');
+    }
+    if (rule.boards !== '*' && !rule.boards.has(identity.board)) {
+        throw new SurfaceProtocolError(409, 'surface_product_board_mismatch', 'Surface product and board do not match');
+    }
+    if (!rule.channels.has(identity.updateChannel)) {
+        throw new SurfaceProtocolError(409, 'surface_product_channel_mismatch', 'Surface product and update channel do not match');
+    }
+}
+/** Validate an OTA namespace independently of an HTTP request. Staging and
+ * serving both call this so a product-aware image can never fall back to a
+ * board-only namespace. */
+export function validateSurfaceOtaIdentity(identity) {
+    const bounded = {
+        productId: boundedToken(identity.productId, 'productId'),
+        board: boundedToken(identity.board, 'board', 96),
+        updateChannel: boundedToken(identity.updateChannel, 'updateChannel', 48),
+    };
+    validateProductTuple({ ...bounded, profile: PORTABLE_READER_PROFILE });
+    return bounded;
+}
+/** Parse the all-or-nothing HTTP Surface declaration. No Surface headers is
+ * the legacy baseline; one or more headers means all eight must be valid. */
+export function parseHttpSurfaceIdentity(headers, requiredCapability) {
+    const values = Object.fromEntries(Object.entries(HEADER_NAMES).map(([key, name]) => [key, header(headers, name)]));
+    const present = Object.values(values).filter((value) => value !== undefined).length;
+    if (present === 0)
+        return undefined;
+    if (present !== Object.keys(HEADER_NAMES).length) {
+        throw new SurfaceProtocolError(400, 'surface_identity_incomplete', 'All eight AgentDeck Surface identity headers are required');
+    }
+    if (values.protocol !== String(SURFACE_PROTOCOL_MAJOR)) {
+        throw new SurfaceProtocolError(426, 'surface_protocol_unsupported', `Surface protocol ${values.protocol} is not supported`);
+    }
+    const profile = knownProfile(values.profile);
+    if (profile !== PORTABLE_READER_PROFILE) {
+        throw new SurfaceProtocolError(406, 'surface_profile_route_mismatch', 'This HTTP route requires portable-reader/v1');
+    }
+    const offeredCapabilities = values.capabilities.split(',').map((value) => value.trim()).filter(Boolean);
+    const capabilities = capabilityIntersection(profile, offeredCapabilities);
+    if (requiredCapability && !capabilities.includes(requiredCapability)) {
+        throw new SurfaceProtocolError(403, 'surface_capability_required', `Capability "${requiredCapability}" was not granted`);
+    }
+    const identity = {
+        protocol: SURFACE_PROTOCOL_MAJOR,
+        profile,
+        clientId: boundedToken(values.clientId, 'AgentDeck-Client-Id'),
+        clientVersion: boundedToken(values.clientVersion, 'AgentDeck-Client-Version', 96),
+        productId: boundedToken(values.productId, 'AgentDeck-Product-Id'),
+        capabilities,
+        board: boundedToken(values.board, 'AgentDeck-Board', 96),
+        updateChannel: boundedToken(values.updateChannel, 'AgentDeck-Update-Channel', 48),
+    };
+    validateProductTuple(identity);
+    return identity;
+}
+/** Select the resumable OTA response shape without guessing from a client
+ * version. Legacy clients append `?from=` bodies but only accept status 200;
+ * negotiated clients explicitly opt into the standard 206 response. */
+export function pullOtaResponseStatus(from, identity) {
+    return from > 0 && identity?.capabilities.includes(OTA_RESUME_PARTIAL_CAPABILITY) === true
+        ? 206 : 200;
+}
+/** A product-aware request may repeat the tuple in the query, but repetition
+ * is correlation, not override: every supplied member must match the headers. */
+export function validateSurfaceQueryTuple(identity, params) {
+    const query = {
+        productId: params.get('productId'),
+        board: params.get('board'),
+        updateChannel: params.get('updateChannel'),
+    };
+    for (const [field, value] of Object.entries(query)) {
+        if (value !== null && value !== identity[field]) {
+            throw new SurfaceProtocolError(409, 'surface_query_identity_mismatch', `Query ${field} does not match Surface identity`);
+        }
+    }
+}
+export function negotiateSurface(offer) {
+    if (offer.protocol !== SURFACE_PROTOCOL_MAJOR) {
+        throw new SurfaceProtocolError(426, 'surface_protocol_unsupported', `Surface protocol ${String(offer.protocol)} is not supported`);
+    }
+    const clientId = boundedToken(String(offer.clientId ?? ''), 'surface.clientId');
+    const clientVersion = boundedToken(String(offer.clientVersion ?? ''), 'surface.clientVersion', 96);
+    const productId = boundedToken(String(offer.productId ?? ''), 'surface.productId');
+    if (!Array.isArray(offer.profiles) || offer.profiles.length === 0) {
+        throw new SurfaceProtocolError(406, 'surface_profile_unsupported', 'At least one Surface profile offer is required');
+    }
+    let selected;
+    for (const raw of offer.profiles) {
+        if (!raw || typeof raw !== 'object')
+            continue;
+        const profile = raw;
+        if (typeof profile.id !== 'string' || !Object.prototype.hasOwnProperty.call(PROFILE_CAPABILITIES, profile.id))
+            continue;
+        const id = profile.id;
+        selected = { id, capabilities: capabilityIntersection(id, profile.capabilities) };
+        break;
+    }
+    if (!selected) {
+        throw new SurfaceProtocolError(406, 'surface_profile_unsupported', 'No offered Surface profile is supported');
+    }
+    if (selected.id === PORTABLE_READER_PROFILE) {
+        const rule = PRODUCT_RULES[productId];
+        if (!rule || !rule.profiles.has(selected.id)) {
+            throw new SurfaceProtocolError(422, 'surface_product_unsupported', 'Portable-reader product is not registered');
+        }
+    }
+    return {
+        clientId,
+        clientVersion,
+        productId,
+        profile: selected.id,
+        capabilities: selected.capabilities,
+        welcome: {
+            type: 'surface_welcome',
+            protocol: SURFACE_PROTOCOL_MAJOR,
+            profile: selected.id,
+            capabilities: selected.capabilities,
+            serverVersion: SURFACE_SERVER_VERSION,
+        },
+    };
+}
+export function surfaceErrorBody(error) {
+    return { error: error.code, message: error.message };
+}
+export function isPortableReaderProfile(profile) {
+    return profile === PORTABLE_READER_PROFILE;
+}
+/** Public WS event boundary for a negotiated profile. The portable profile is
+ * deliberately pull-first and does not inherit private dashboard broadcasts. */
+export function surfaceAllowsEvent(profile, eventType) {
+    if (profile !== PORTABLE_READER_PROFILE)
+        return true;
+    return eventType === 'surface_welcome' || eventType === 'connection' || eventType === 'device_info_request';
+}
+/** Additive projection switch: negotiated headers are preferred, while the
+ * historical query remains valid for old Pocket builds. */
+export function usesPortableReaderProjection(identity, params) {
+    return identity !== undefined || params.get('surface') === 'pocket-reader';
+}
+//# sourceMappingURL=surface-protocol.js.map

package/dist/surface-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-protocol.js","sourceRoot":"","sources":["../src/surface-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAU,CAAC;AACjD,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAA6B,CAAC;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAG,gBAAyB,CAAC;AACvE,MAAM,CAAC,MAAM,6BAA6B,GAAG,kCAA2C,CAAC;AACzF,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAgC,CAAC;AAExE,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,OAAO,CAAC;AAE1D,MAAM,oBAAoB,GAAG;IAC3B,mBAAmB,EAAE,IAAI,GAAG,CAAC;QAC3B,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB;KACrE,CAAC;IACF,sBAAsB,EAAE,IAAI,GAAG,CAAC;QAC9B,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB;QACnE,eAAe,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY;KACvF,CAAC;IACF,CAAC,uBAAuB,CAAC,EAAE,IAAI,GAAG,CAAC;QACjC,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,aAAa;QAC7D,uBAAuB,EAAE,sBAAsB,EAAE,qBAAqB;QACtE,oBAAoB,EAAE,sBAAsB;QAC5C,gBAAgB,EAAE,kBAAkB;QACpC,UAAU,EAAE,6BAA6B,EAAE,kBAAkB;QAC7D,yEAAyE;KAC1E,CAAC;IACF,iBAAiB,EAAE,IAAI,GAAG,CAAC;QACzB,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB;KACrE,CAAC;CACM,CAAC;AAUX,MAAM,aAAa,GAAuC;IACxD,CAAC,uBAAuB,CAAC,EAAE;QACzB,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC5C,MAAM,EAAE,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC3C,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;KAC9B;IACD,CAAC,6BAA6B,CAAC,EAAE;QAC/B,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC5C,MAAM,EAAE,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACtD,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;KAC9B;CACF,CAAC;AAEF,MAAM,YAAY,GAAG;IACnB,QAAQ,EAAE,4BAA4B;IACtC,OAAO,EAAE,2BAA2B;IACpC,QAAQ,EAAE,qBAAqB;IAC/B,aAAa,EAAE,0BAA0B;IACzC,SAAS,EAAE,sBAAsB;IACjC,YAAY,EAAE,wBAAwB;IACtC,KAAK,EAAE,iBAAiB;IACxB,aAAa,EAAE,0BAA0B;CACjC,CAAC;AAsCX,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAElC;IACA;IAFX,YACW,MAAc,EACd,IAAY,EACrB,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAQ;IAIvB,CAAC;CACF;AAID,SAAS,MAAM,CAAC,OAAqB,EAAE,IAAY;IACjD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,OAAO,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa,EAAE,GAAG,GAAG,GAAG;IAC3D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAChF,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,0BAA0B,EAAE,GAAG,KAAK,eAAe,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,oBAAoB,KAAK,oBAAoB,CAAC,CAAC;IACpH,CAAC;IACD,OAAO,KAAyB,CAAC;AACnC,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAyB,EAAE,OAAgB;IACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,oBAAoB,CAAC,OAAO,CAAwB,CAAC;IACnE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpF,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAQD,SAAS,oBAAoB,CAAC,QAAoF;IAChH,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,oBAAoB,QAAQ,CAAC,SAAS,qBAAqB,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,kCAAkC,EAAE,0CAA0C,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,gCAAgC,EAAE,wCAAwC,CAAC,CAAC;IAClH,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,kCAAkC,EAAE,iDAAiD,CAAC,CAAC;IAC7H,CAAC;AACH,CAAC;AAED;;2BAE2B;AAC3B,MAAM,UAAU,0BAA0B,CAAC,QAA4B;IACrE,MAAM,OAAO,GAAG;QACd,SAAS,EAAE,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;QACxD,KAAK,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QAChD,aAAa,EAAE,YAAY,CAAC,QAAQ,CAAC,aAAa,EAAE,eAAe,EAAE,EAAE,CAAC;KACzE,CAAC;IACF,oBAAoB,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;6EAC6E;AAC7E,MAAM,UAAU,wBAAwB,CACtC,OAAqB,EACrB,kBAA2B;IAE3B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CACvB,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACpF,IAAI,OAAO,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,OAAO,KAAK,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;QACjD,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,2DAA2D,CAAC,CAAC;IAClI,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,8BAA8B,EAAE,oBAAoB,MAAM,CAAC,QAAQ,mBAAmB,CAAC,CAAC;IAC9H,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,OAAQ,CAAC,CAAC;IAC9C,IAAI,OAAO,KAAK,uBAAuB,EAAE,CAAC;QACxC,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,gCAAgC,EAAE,6CAA6C,CAAC,CAAC;IACvH,CAAC;IACD,MAAM,mBAAmB,GAAG,MAAM,CAAC,YAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACzG,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IAC1E,IAAI,kBAAkB,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,eAAe,kBAAkB,mBAAmB,CAAC,CAAC;IAC3H,CAAC;IACD,MAAM,QAAQ,GAAoB;QAChC,QAAQ,EAAE,sBAAsB;QAChC,OAAO;QACP,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,QAAS,EAAE,qBAAqB,CAAC;QAC/D,aAAa,EAAE,YAAY,CAAC,MAAM,CAAC,aAAc,EAAE,0BAA0B,EAAE,EAAE,CAAC;QAClF,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,SAAU,EAAE,sBAAsB,CAAC;QAClE,YAAY;QACZ,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAM,EAAE,iBAAiB,EAAE,EAAE,CAAC;QACzD,aAAa,EAAE,YAAY,CAAC,MAAM,CAAC,aAAc,EAAE,0BAA0B,EAAE,EAAE,CAAC;KACnF,CAAC;IACF,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;uEAEuE;AACvE,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,QAA2D;IAE3D,OAAO,IAAI,GAAG,CAAC,IAAI,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,6BAA6B,CAAC,KAAK,IAAI;QACxF,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AAChB,CAAC;AAED;iFACiF;AACjF,MAAM,UAAU,yBAAyB,CAAC,QAAyB,EAAE,MAAuB;IAC1F,MAAM,KAAK,GAAG;QACZ,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC;QAClC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC;KAC3C,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,QAAQ,CAAC,KAA2B,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,iCAAiC,EAAE,SAAS,KAAK,kCAAkC,CAAC,CAAC;QAC3H,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAmB;IAClD,IAAI,KAAK,CAAC,QAAQ,KAAK,sBAAsB,EAAE,CAAC;QAC9C,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,8BAA8B,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IACrI,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAChF,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,uBAAuB,EAAE,EAAE,CAAC,CAAC;IACnG,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACnF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,gDAAgD,CAAC,CAAC;IACvH,CAAC;IACD,IAAI,QAAsE,CAAC;IAC3E,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,OAAO,GAAG,GAA+C,CAAC;QAChE,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,EAAE,CAAC;YAAE,SAAS;QACxH,MAAM,EAAE,GAAG,OAAO,CAAC,EAAsB,CAAC;QAC1C,QAAQ,GAAG,EAAE,EAAE,EAAE,YAAY,EAAE,sBAAsB,CAAC,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAClF,MAAM;IACR,CAAC;IACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,yCAAyC,CAAC,CAAC;IAChH,CAAC;IACD,IAAI,QAAQ,CAAC,EAAE,KAAK,uBAAuB,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;QACtC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,6BAA6B,EAAE,2CAA2C,CAAC,CAAC;QAClH,CAAC;IACH,CAAC;IACD,OAAO;QACL,QAAQ;QACR,aAAa;QACb,SAAS;QACT,OAAO,EAAE,QAAQ,CAAC,EAAE;QACpB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,OAAO,EAAE;YACP,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,sBAAsB;YAChC,OAAO,EAAE,QAAQ,CAAC,EAAE;YACpB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,aAAa,EAAE,sBAAsB;SACtC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAA2B;IAC1D,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,OAAO,OAAO,KAAK,uBAAuB,CAAC;AAC7C,CAAC;AAED;gFACgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,OAAyB,EAAE,SAAiB;IAC7E,IAAI,OAAO,KAAK,uBAAuB;QAAE,OAAO,IAAI,CAAC;IACrD,OAAO,SAAS,KAAK,iBAAiB,IAAI,SAAS,KAAK,YAAY,IAAI,SAAS,KAAK,qBAAqB,CAAC;AAC9G,CAAC;AAED;2DAC2D;AAC3D,MAAM,UAAU,4BAA4B,CAC1C,QAAqC,EACrC,MAAuB;IAEvB,OAAO,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,eAAe,CAAC;AAC7E,CAAC"}

package/dist/timeline-store.d.ts

@@ -105,7 +105,7 @@ export declare class BridgeTimelineStore {
     /** Recent entries attributed to one session, for the `query_session_timeline`
      *  poll — lets a device that connects mid-session fill its Detail view. */
     getHistoryForSession(sessionId: string, since?: number, limit?: number): TimelineEntry[];
-    updateEntryStatus(approvalId: string, status: 'approved' | 'denied'): void;
+    updateEntryStatus(approvalId: string, status: 'approved' | 'denied' | 'abandoned'): void;
     /** Update existing entry with same ts+type (1s tolerance), or add new.
      *
      *  Update path: the existing entry's session/task/run/project attribution

package/dist/timeline-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-store.d.ts","sourceRoot":"","sources":["../src/timeline-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AACtE;;;qEAGqE;AACrE,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,aAAa,CAAC;AA0B/D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAgC;IAClD;;uCAEmC;IACnC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,KAAK,CAAS;IACtB;;8EAE0E;IAC1E,OAAO,CAAC,qBAAqB,CAAS;IAEtC,wBAAwB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAI1C;;;+CAG2C;IAC3C,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAI/C,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA+D5E;;;;;wDAKoD;IACpD,OAAO,CAAC,QAAQ;IAgDhB;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IAWvB;;;;;;;OAOG;IACH,YAAY,IAAI,IAAI;IAgBpB,yEAAyE;IACzE,eAAe,IAAI,IAAI;IAQvB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAO3C;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiBvC,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAuB3C;;;;;;;;6EAQyE;IACzE,oBAAoB,IAAI,MAAM;IAwC9B;;;;;;;;;;;;;;;;eAgBW;IACX,oBAAoB,CAClB,OAAO,SAAc,EACrB,GAAG,SAAa,EAChB,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACnC,MAAM;IAsCT;+EAC2E;IAC3E,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,aAAa,EAAE;IAkBpF,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI;IAS1E;;;;;;;;;;;oEAWgE;IAChE,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA4D/E,gDAAgD;IAChD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAOhD,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAIhC,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAKvC,OAAO,CAAC,uBAAuB;CAiChC"}
+{"version":3,"file":"timeline-store.d.ts","sourceRoot":"","sources":["../src/timeline-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AACtE;;;qEAGqE;AACrE,KAAK,eAAe,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,aAAa,CAAC;AA0B/D,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,UAAU,CAAgC;IAClD;;uCAEmC;IACnC,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,KAAK,CAAS;IACtB;;8EAE0E;IAC1E,OAAO,CAAC,qBAAqB,CAAS;IAEtC,wBAAwB,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI;IAI1C;;;+CAG2C;IAC3C,aAAa,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAI/C,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA+D5E;;;;;wDAKoD;IACpD,OAAO,CAAC,QAAQ;IAiEhB;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIrC,4DAA4D;IAC5D,OAAO,CAAC,eAAe;IAWvB;;;;;;;OAOG;IACH,YAAY,IAAI,IAAI;IAgBpB,yEAAyE;IACzE,eAAe,IAAI,IAAI;IAQvB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE;IAO3C;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAiBvC,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAuB3C;;;;;;;;6EAQyE;IACzE,oBAAoB,IAAI,MAAM;IAwC9B;;;;;;;;;;;;;;;;eAgBW;IACX,oBAAoB,CAClB,OAAO,SAAc,EACrB,GAAG,SAAa,EAChB,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GACnC,MAAM;IAsCT;+EAC2E;IAC3E,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,aAAa,EAAE;IAkBpF,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,IAAI;IASxF;;;;;;;;;;;oEAWgE;IAChE,WAAW,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE;QAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IA4D/E,gDAAgD;IAChD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAOhD,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAIhC,cAAc,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAKvC,OAAO,CAAC,uBAAuB;CAiChC"}

package/dist/timeline-store.js

@@ -149,7 +149,22 @@ export class BridgeTimelineStore {
         // fan-out sessions, so the dispatch row was always the first casualty and
         // the completions below it read as unattached. Skip them here; they still
         // FIFO out with everything else once the plain tool rows are gone.
-        const toolIdx = this.entries.findIndex((e) => e.type === 'tool_exec' && !e.subagentId);
+        //
+        // OpenClaw transcript rows are the second exception, for the same reason
+        // read the other way round. This rule targets the observed-agent hook
+        // firehose — one row per internal action, measured at 87% of a live buffer.
+        // OpenClaw's tool rows are neither hooks nor a firehose: the Gateway stream
+        // carries no tool calls at all, so they are read from OpenClaw's own
+        // transcript (`openclaw-timeline-feed.ts`) and are the ONLY account of what
+        // it did, deliberately bounded at the producer (recently-active sessions
+        // only, a dozen rows per session per tick, measured traffic 28 tool calls
+        // in 3 h). Shedding them first did not thin them — it deleted them
+        // outright: `addEntry` pushes then evicts, so on a full buffer an OpenClaw
+        // row was the only plain `tool_exec` present and therefore evicted ITSELF
+        // on insertion. Measured 2026-08-23 against a live daemon and reproduced at
+        // this store: the feed emitted its row, and the buffer never held one. They
+        // still FIFO out with everything else once the plain tool rows are gone.
+        const toolIdx = this.entries.findIndex((e) => e.type === 'tool_exec' && !e.subagentId && e.agentType !== 'openclaw');
         if (toolIdx >= 0) {
             this.entries.splice(toolIdx, 1);
             return;