@vikrant82/opencode-cache-keepalive 0.1.6 → 0.2.0

package/dist/lib/replay-warmer.d.ts

@@ -0,0 +1,95 @@
+import type { KeepaliveConfig } from "./config";
+import type { Logger } from "./logger";
+import type { SessionWarmEntry, WarmApi, WarmStateSink } from "./types";
+type Recorded = {
+    url: string;
+    method: string;
+    headers: Headers;
+    body: string;
+    model: string;
+    api: WarmApi;
+    sentAt: number;
+    intervalMs: number;
+};
+type Session = {
+    request: Recorded;
+    entry: SessionWarmEntry;
+    timer?: ReturnType<typeof setTimeout>;
+    controller?: AbortController;
+    runningTools: Set<string>;
+    active: boolean;
+    busy: boolean;
+    realRequests: number;
+    previousPrompt?: number;
+    replayReadTokens: number;
+    pendingResume?: {
+        replays: number;
+        promptPrev: number;
+        replayReadTokens: number;
+    };
+    retries: number;
+    child: boolean;
+    stopLoggedGap?: number;
+    touchedAt: number;
+};
+type Runtime = {
+    originalFetch: typeof fetch;
+    sessions: Map<string, Session>;
+    owners: Map<string, ReplayWarmer>;
+    instancesSet: Set<ReplayWarmer>;
+    childSessions: Set<string>;
+    now: () => number;
+    loggedApis: Set<WarmApi>;
+    maxStoredBytes: number;
+    storedBytes: number;
+    hosts: Set<string>;
+    pruneTimer?: ReturnType<typeof setInterval>;
+    instances: Map<ReplayWarmer, {
+        enabled: boolean;
+        controls: Map<string, boolean>;
+        effective: Map<string, boolean>;
+        directory: string;
+        hosts: Set<string>;
+        config: KeepaliveConfig;
+        sink: WarmStateSink;
+    }>;
+};
+/** Replays allowlisted model requests at cache-refresh deadlines without generating model output. */
+export declare class ReplayWarmer {
+    private readonly client;
+    private readonly config;
+    private readonly sink;
+    private readonly logger;
+    private readonly directory;
+    private readonly now;
+    private runtime?;
+    private controlTimer?;
+    private enabled;
+    constructor(client: any, config: KeepaliveConfig, sink: WarmStateSink, logger: Logger, directory: string, now?: () => number);
+    start(): void;
+    dispose(): void;
+    onEvent(event: any): void;
+    private totals;
+    /** @internal Called asynchronously by the process-wide recorder. */
+    debugRecordRejected(reason: string): void;
+    /** @internal Called asynchronously by the process-wide recorder. */
+    recordRequest(runtime: Runtime, input: string | URL | Request, init?: RequestInit, bodySource?: Promise<string>, selectedBody?: string, selectedParsed?: any): Promise<void>;
+    private recordEligible;
+    private startGap;
+    private invalidateTarget;
+    private enforceStoredBudget;
+    private get cap();
+    private schedule;
+    private replay;
+    private retryOrLapse;
+    private stopSession;
+    private updateState;
+    private publish;
+    private clearTimer;
+    private clearTimerFrom;
+    private sessionEnabled;
+    private disableSession;
+    private syncControl;
+}
+export {};
+//# sourceMappingURL=replay-warmer.d.ts.map

package/dist/lib/replay-warmer.d.ts.map

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

package/dist/lib/state.d.ts

@@ -1,121 +1,19 @@
-import type { KeepaliveConfig } from "./config";
-export type PingRecord = {
-    at: number;
-    hit: boolean;
-    input: number;
-    cacheRead: number;
-    cacheWrite: number;
-    output: number;
+import type { Logger } from "./logger";
+import type { ProcessTotals, SessionWarmEntry, WarmStateSink } from "./types";
+export type StateStoreOptions = {
+    logger?: Logger;
+    now?: () => number;
 };
 /**
- * Request settings of the last real user turn. A ping must replay them exactly:
- * a prompt without explicit settings runs as opencode's default agent with no
- * variant, which changes the request shape (missing the cache) and overwrites
- * the session's persisted agent/model/variant.
+ * Create an isolated v2 snapshot writer. Mutations are debounced, dispose flushes
+ * the latest snapshot before removing it, and all filesystem failures stay
+ * best-effort so state reporting cannot disrupt replay execution.
  */
-export type PingRequest = {
-    agent?: string;
-    providerID: string;
-    modelID: string;
-    variant?: string;
-};
-/** Bookkeeping for the ping request currently in flight. */
-export type InflightPing = {
-    /** Epoch ms the ping attempt began (before the pre-flight status check). */
-    startedAt: number;
-    /** The prompt request has been issued. */
-    sent: boolean;
-    /** The ping's own user message, identified by its ping-token text part. */
-    messageID?: string;
-    /**
-     * New user messages seen during the ping whose text has not yet been observed.
-     * Each is classified by its first text part: the ping token marks our own
-     * message, anything else a real turn.
-     */
-    pending: Map<string, unknown>;
-    /**
-     * A real user message appeared while the ping was in flight. opencode joins such
-     * a prompt to the running ping loop, so the rest of the run is real work.
-     */
-    interrupted: boolean;
-};
-/** Live per-session bookkeeping held by the server plugin. */
-export type SessionKeepalive = {
-    sessionID: string;
-    /** Whether the session's provider/model pair supports cache warming. */
-    eligible: boolean;
-    modelLabel?: string;
-    /** Epoch ms of the last real assistant response (excludes ping replies). */
-    lastResponseAt: number;
-    /** Epoch ms the current idle stretch began. */
-    idleSince: number;
-    /** Epoch ms after which warming stops and the cache is allowed to go cold. */
-    windowEndsAt: number;
-    /** Epoch ms the next ping is due. */
-    nextPingAt: number;
-    /** Number of scheduled ping requests attempted during this warm window. */
-    pingsSent: number;
-    /** A real turn is currently running. */
-    busy: boolean;
-    /** A keepalive ping is currently in flight. */
-    warming: boolean;
-    /** The in-flight ping; set exactly while `warming` is true. */
-    ping?: InflightPing;
-    /** ID and creation time of the newest user message seen, to tell new turns from re-emitted old messages. */
-    lastUserID?: string;
-    lastUserAt?: number;
-    /** Settings of the last real user turn, replayed by pings. */
-    request?: PingRequest;
-    /** Within the warm window and actively scheduling pings. */
-    active: boolean;
-    /** True while `armWindow` is resolving session metadata (async guard). */
-    arming?: boolean;
-    /** Epoch ms the last sent ping finished; ignores its late events and marks the last cache touch. */
-    lastPingAt?: number;
-    lastPing?: PingRecord;
-};
-/** Lean projection persisted to disk for the TUI reader. */
-export type PersistedSession = {
-    eligible: boolean;
-    modelLabel?: string;
-    lastResponseAt: number;
-    idleSince: number;
-    windowEndsAt: number;
-    nextPingAt: number;
-    intervalMs: number;
-    pingsSent: number;
-    busy: boolean;
-    warming: boolean;
-    active: boolean;
-    lastPing?: PingRecord;
-};
-export type PersistedState = {
-    version: 1;
-    updatedAt: number;
-    enabled: boolean;
-    intervalMs: number;
-    windowMs: number;
-    sessions: Record<string, PersistedSession>;
-};
-export declare class KeepaliveStore {
-    private readonly config;
-    private readonly directory;
-    private readonly sessions;
-    private writeQueue;
-    private enabled;
-    private intervalMs;
-    constructor(config: KeepaliveConfig, directory: string);
-    setEnabled(enabled: boolean): void;
-    /** Effective ping interval (runtime override or config) reported to the TUI. */
-    setIntervalMs(intervalMs: number): void;
-    get(sessionID: string): SessionKeepalive | undefined;
-    ensure(sessionID: string): SessionKeepalive;
-    remove(sessionID: string): void;
-    all(): SessionKeepalive[];
-    /**
-     * Atomically persist a lean snapshot for the TUI. Never throws or rejects; the
-     * returned promise resolves once this snapshot and every earlier one are written.
-     */
-    persist(): Promise<void>;
-}
+export declare function createStateStore(directory: string, options?: StateStoreOptions): WarmStateSink;
+/** Return the newest self-contained entry for a session across matching v2 files. */
+export declare function readSessionEntry(directory: string, sessionID: string): SessionWarmEntry | undefined;
+/** Sum process-level totals from live snapshots for this directory. */
+export declare function readProcessTotals(directory: string): ProcessTotals;
+/** Remove only v2 snapshots whose owner PID is confirmed dead. */
+export declare function cleanupStateFiles(directory: string, logger?: Logger): void;
 //# sourceMappingURL=state.d.ts.map

package/dist/lib/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../lib/state.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../lib/state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAc7E,MAAM,MAAM,iBAAiB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,CAAA;AAEvE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAChC,aAAa,CAoFf;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAClB,gBAAgB,GAAG,SAAS,CAO9B;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAgBlE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAmB1E"}

package/dist/lib/tui/commands.d.ts

@@ -1,10 +1,5 @@
 /** @jsxImportSource @opentui/solid */
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
-/**
- * Register the keepalive commands. The control file is scoped per directory, so
- * toggling keepalive or changing its interval here only affects this project's
- * server plugin — not other open opencode sessions. The server polls the file
- * every second, so changes apply without a restart.
- */
+/** Register runtime enable/disable commands for the current session only. */
 export declare function registerKeepaliveCommands(api: TuiPluginApi): void;
 //# sourceMappingURL=commands.d.ts.map

package/dist/lib/tui/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../lib/tui/commands.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAqBlF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CA0IjE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../lib/tui/commands.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAG3D,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAqEjE"}

package/dist/lib/tui/footer.d.ts

@@ -1,14 +1,14 @@
 /** @jsxImportSource @opentui/solid */
+import type { SessionWarmEntry } from "../types";
 type Theme = Record<string, any>;
-/**
- * Persistent readout mounted in the `sidebar_footer` slot. Shows time since the
- * last real agent response plus keepalive pings sent / left. Data comes from the
- * server plugin's state file; the idle timer ticks locally every second.
- */
+/** Display the persisted replay-warming state for the current session only. */
 export declare function KeepaliveFooter(props: {
     theme: Theme;
     directory: string;
     sessionID?: string;
 }): any;
+/** Pure formatter for the two-line footer's optional telemetry. */
+export declare function formatDetails(entry: SessionWarmEntry, now?: number): string | undefined;
+export declare function formatStatusLine(entry: SessionWarmEntry, remainingMs: number): string;
 export {};
 //# sourceMappingURL=footer.d.ts.map

package/dist/lib/tui/footer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../../lib/tui/footer.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AAUtC,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAYhC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,OAwI7F"}
+{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../../../lib/tui/footer.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AAItC,OAAO,KAAK,EAAE,gBAAgB,EAAa,MAAM,UAAU,CAAA;AAI3D,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEhC,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,OAkD7F;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,SAAS,CAE3F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAYrF"}

package/dist/lib/tui/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../lib/tui/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKvC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKtC;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa/D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAWjD"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../lib/tui/format.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKvC;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAStC;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAa/D;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAWjD"}

package/dist/lib/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Shared contracts between the server-side replay engine and the state/TUI layer.
+ *
+ * The engine produces one self-contained {@link SessionWarmEntry} per tracked root
+ * session and hands it to a {@link WarmStateSink}; the TUI reads persisted entries
+ * back per session. Entries never contain request URLs with queries, headers,
+ * bodies, credentials, or conversation text.
+ */
+/** Wire API family of a recorded request, derived from the request pathname. */
+export type WarmApi = "messages" | "responses" | "chat";
+/**
+ * Display/lifecycle state of a session's cache warming.
+ * - `active`: a real model request/step is in flight; no replay is sent.
+ * - `busy`: the session is blocked on a running tool; replays are scheduled.
+ * - `idle`: the session is idle between turns; replays are scheduled.
+ * - `stopped`: warming ended for the current gap; see {@link StopReason}.
+ * - `off`: warming is disabled by config or runtime control.
+ */
+export type WarmState = "active" | "busy" | "idle" | "stopped" | "off";
+/**
+ * Why warming stopped for the current gap.
+ * - `cap`: the per-gap replay cap was reached.
+ * - `lapsed`: the cache is believed expired (failed retry, or a replay reported a cache write instead of a read).
+ * - `rejected-4xx`: the provider rejected the replay with 400/401/403.
+ * - `disabled`: runtime control or config turned warming off.
+ */
+export type StopReason = "cap" | "lapsed" | "rejected-4xx" | "disabled";
+/** Outcome of the most recent replay attempt. */
+export interface ReplayResult {
+    /** Replay send time, epoch ms. */
+    at: number;
+    /** HTTP status; 0 for network error or timeout. */
+    status: number;
+    /** Milliseconds from issuing the replay fetch to the API-specific abort point. */
+    latencyMs: number;
+    /** Cached prompt tokens reported by the provider, when parseable before abort (messages API). */
+    cacheRead?: number;
+    /** Cache-write prompt tokens reported by the provider, when parseable before abort (messages API). */
+    cacheWrite?: number;
+}
+/** Result of the first real model call after a gap that had at least one successful replay. */
+export interface ResumeResult {
+    /** step-finish time, epoch ms. */
+    at: number;
+    /** cache.read tokens of that call. */
+    read: number;
+    /** Prompt tokens (input + cache.read + cache.write) of the last call before the gap. */
+    promptPrev: number;
+    /** True when read >= 0.9 * promptPrev. */
+    hit: boolean;
+    /** Successful replays spent in the gap. */
+    replays: number;
+    /**
+     * Cache-write tokens avoided for the gap: `promptPrev` on a hit, 0 on a miss.
+     * Gross figure shown to users as "saved"; replay cost is reported separately.
+     */
+    avoidedTokens: number;
+    /**
+     * Cached-read tokens spent by the gap's successful replays (sum of each replay's
+     * reported cacheRead, falling back to promptPrev when not parsed). Logged only.
+     */
+    replayReadTokens: number;
+}
+/**
+ * Complete, self-contained display state for one root session. Every field the TUI
+ * needs is here so readers never depend on file-level or process-level fields.
+ */
+export interface SessionWarmEntry {
+    sessionID: string;
+    /** Last time this entry changed, epoch ms; readers pick the freshest entry per session. */
+    updatedAt: number;
+    /** Effective enablement (config AND runtime control). */
+    enabled: boolean;
+    /** Model id from the recorded request body. */
+    model: string;
+    api: WarmApi;
+    state: WarmState;
+    stopReason?: StopReason;
+    /** HTTP status that caused `rejected-4xx`. */
+    stopStatus?: number;
+    /** Monotonic per-session gap counter; a gap starts at each real request send. */
+    gapId: number;
+    /** Successful replays in the current gap. */
+    gapReplays: number;
+    /** Per-gap replay cap in effect. */
+    cap: number;
+    /** Next scheduled replay time, epoch ms; null when none is scheduled. */
+    nextReplayAt: number | null;
+    /** Successful replays across the session's lifetime in this process. */
+    sessionReplays: number;
+    /** Sum of ResumeResult.avoidedTokens across the session's gaps in this process. */
+    avoidedTokens: number;
+    /** Resumes (first call after a gap with ≥1 successful replay) that hit, in this process. */
+    resumeHits: number;
+    /** All resumes (hits + misses) in this process. */
+    resumeCount: number;
+    lastReplay?: ReplayResult;
+    resume?: ResumeResult;
+}
+/** Process-wide aggregates, informational only (never used to gate display). */
+export interface ProcessTotals {
+    replays: number;
+    avoidedTokens: number;
+    replayReadTokens: number;
+    resumeHits: number;
+    resumeMisses: number;
+}
+/**
+ * Destination for engine state. Implementations persist sanitized entries for the
+ * TUI. Calls are synchronous and must never throw; persistence may be debounced.
+ * Single-threaded use from the plugin's event loop is assumed.
+ */
+export interface WarmStateSink {
+    /** Replace the entry for `entry.sessionID`. */
+    upsert(entry: SessionWarmEntry): void;
+    /** Forget a session (e.g. deleted). */
+    remove(sessionID: string): void;
+    /** Replace process totals. */
+    setTotals(totals: ProcessTotals): void;
+    /** Flush pending writes and remove this instance's persisted file. Never rejects. */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,gFAAgF;AAChF,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAA;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,CAAA;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,cAAc,GAAG,UAAU,CAAA;AAEvE,iDAAiD;AACjD,MAAM,WAAW,YAAY;IACzB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAA;IACjB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,+FAA+F;AAC/F,MAAM,WAAW,YAAY;IACzB,kCAAkC;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,wFAAwF;IACxF,UAAU,EAAE,MAAM,CAAA;IAClB,0CAA0C;IAC1C,GAAG,EAAE,OAAO,CAAA;IACZ,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,gBAAgB,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAA;IAChB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAA;IAClB,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,yEAAyE;IACzE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,wEAAwE;IACxE,cAAc,EAAE,MAAM,CAAA;IACtB,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAA;IACrB,4FAA4F;IAC5F,UAAU,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,YAAY,CAAA;IACzB,MAAM,CAAC,EAAE,YAAY,CAAA;CACxB;AAED,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,+CAA+C;IAC/C,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;IACrC,uCAAuC;IACvC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,8BAA8B;IAC9B,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACtC,qFAAqF;IACrF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B"}

package/dist/tui.d.ts

@@ -1,4 +1,7 @@
 /** @jsxImportSource @opentui/solid */
+import type { SessionWarmEntry } from "./lib/types";
+/** Route-level owner for deduplicating rejected replay notifications. */
+export declare function notifyRejectedReplayOnce(notified: Set<string>, sessionID: string, entry: SessionWarmEntry, toast: (message: string) => void): void;
 declare const _default: {
     id: string;
     tui: import("@opencode-ai/plugin/tui").TuiPlugin;

package/dist/tui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../tui.tsx"],"names":[],"mappings":"AAAA,sCAAsC;;;;;AAwBtC,wBAAgF"}
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../tui.tsx"],"names":[],"mappings":"AAAA,sCAAsC;AAMtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAEnD,yEAAyE;AACzE,wBAAgB,wBAAwB,CACpC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GACjC,IAAI,CAWN;;;;;AAuCD,wBAAgF"}