@vikrant82/opencode-cache-keepalive 0.1.5 → 0.2.0

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,118 +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;
-    constructor(config: KeepaliveConfig, directory: string);
-    setEnabled(enabled: boolean): 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,3 +1,5 @@
+/** @jsxImportSource @opentui/solid */
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
+/** 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.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAG3D,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAmDjE"}
+{"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;AAUhC;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,OA+G7F"}
+{"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

@@ -1,3 +1,11 @@
 export declare function mmss(ms: number): string;
 export declare function kfmt(n: number): string;
+/**
+ * Parse a human duration such as "4m30s", "4.5m", "270s", "1h" or "28m 20s".
+ * A bare number means minutes. Returns undefined for anything unparseable;
+ * range checks are the caller's concern.
+ */
+export declare function parseDuration(input: string): number | undefined;
+/** Compact duration label, e.g. 270000 -> "4m 30s", 3600000 -> "1h". */
+export declare function formatDuration(ms: number): string;
 //# sourceMappingURL=format.d.ts.map

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"}
+{"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"}

package/lib/config.ts

@@ -1,101 +1,133 @@
 export type KeepaliveConfig = {
-    /** Master switch. When false the plugin registers no timers or hooks. */
     enabled: boolean
-    /** Milliseconds between pings. Must stay under the shortest supported provider TTL. */
-    intervalMs: number
-    /**
-     * How long to keep warming after the last real response before giving up and
-     * letting the cache go cold. The default follows the Copilot Claude
-     * write/read break-even; providers with automatic caching may be cheaper.
-     */
-    windowMs: number
-    /**
-     * Append a stable keepalive instruction to the system prompt so the model
-     * answers a `~` ping with a single `~` token and never calls tools. The
-     * instruction is added to real turns too, so the cached prefix stays identical.
-     */
-    injectSystemInstruction: boolean
-    /** The single character/token used as the keepalive suffix. */
-    pingToken: string
-    /** Remove synthetic ping turns after measuring their cache usage. */
-    revertPing: boolean
-    /** Warm subagent/child sessions too. Off by default to avoid wasted pings. */
+    intervals: Record<string, number>
+    hosts: string[]
+    cacheReadFactor: number
+    missFactor: number
+    maxReplaysPerGap: "auto" | number
     includeChildSessions: boolean
+    replayTimeoutMs: number
+    maxStoredBytes: number
     debug: boolean
-    /** providerID substrings eligible for warming (cache-controlled providers). */
-    providerAllowlist: string[]
-    /** modelID substrings eligible for warming. */
-    modelAllowlist: string[]
 }
 
 const DEFAULTS: KeepaliveConfig = {
     enabled: true,
-    intervalMs: 270_000, // 4.5 min — below the shortest supported cache TTL
-    windowMs: 3_300_000, // 55 min — the Copilot Claude write/read break-even
-    injectSystemInstruction: true,
-    pingToken: "~",
-    revertPing: true,
+    intervals: { claude: 285_000, gpt: 1_680_000 },
+    hosts: ["githubcopilot.com"],
+    cacheReadFactor: 0.1,
+    missFactor: 1,
+    maxReplaysPerGap: "auto",
     includeChildSessions: false,
+    replayTimeoutMs: 60_000,
+    maxStoredBytes: 67_108_864,
     debug: false,
-    providerAllowlist: ["copilot"],
-    modelAllowlist: ["claude", "anthropic", "sonnet", "opus", "haiku", "gpt"],
 }
 
-export function getConfig(options: Record<string, unknown> | undefined): KeepaliveConfig {
-    const o = options ?? {}
-    const env = process.env
+const DEPRECATED = [
+    "intervalMs",
+    "intervalSeconds",
+    "windowMs",
+    "windowMinutes",
+    "revertPing",
+    "pingToken",
+    "injectSystemInstruction",
+    "providerAllowlist",
+    "modelAllowlist",
+    "claudeBusyWarm",
+    "claudeBusyWarmIntervalMs",
+    "claudeBusyWarmWindowMs",
+]
+const warnedDeprecated = new Set<string>()
 
+export function getConfig(
+    options: Record<string, unknown> | undefined,
+    warn: (message: string) => void = () => {},
+): KeepaliveConfig {
+    const option = options ?? {}
+    const env = process.env
+    for (const key of DEPRECATED) {
+        if (key in option && !warnedDeprecated.has(key)) {
+            warnedDeprecated.add(key)
+            warn(`deprecated option ${key} is ignored`)
+        }
+    }
+    const parseJson = (raw: string | undefined): unknown => {
+        if (!raw) return undefined
+        try {
+            return JSON.parse(raw)
+        } catch {
+            return undefined
+        }
+    }
+    const intervals = objectOption(
+        option.intervals ?? parseJson(env.OPENCODE_KEEPALIVE_INTERVALS),
+        DEFAULTS.intervals,
+    )
+    const hosts = listOption(
+        option.hosts ?? parseJson(env.OPENCODE_KEEPALIVE_HOSTS),
+        DEFAULTS.hosts,
+    )
+    const maxRaw = option.maxReplaysPerGap ?? env.OPENCODE_KEEPALIVE_MAX_REPLAYS_PER_GAP
+    const maxReplaysPerGap =
+        maxRaw === "auto"
+            ? "auto"
+            : positiveNumber(maxRaw) !== undefined
+              ? positiveNumber(maxRaw)!
+              : DEFAULTS.maxReplaysPerGap
     return {
-        enabled: boolOpt(o.enabled, env.OPENCODE_KEEPALIVE_ENABLED !== "false" && DEFAULTS.enabled),
-        intervalMs: durationOpt(
-            o.intervalMs,
-            o.intervalSeconds,
-            numEnv(env.OPENCODE_KEEPALIVE_INTERVAL_MS, DEFAULTS.intervalMs),
+        enabled: boolOption(
+            option.enabled,
+            env.OPENCODE_KEEPALIVE_ENABLED === undefined
+                ? DEFAULTS.enabled
+                : env.OPENCODE_KEEPALIVE_ENABLED !== "false",
         ),
-        windowMs: durationOpt(
-            o.windowMs,
-            o.windowMinutes ? Number(o.windowMinutes) * 60 : undefined,
-            numEnv(env.OPENCODE_KEEPALIVE_WINDOW_MS, DEFAULTS.windowMs),
+        intervals,
+        hosts,
+        cacheReadFactor:
+            positiveNumber(option.cacheReadFactor ?? env.OPENCODE_KEEPALIVE_CACHE_READ_FACTOR) ??
+            DEFAULTS.cacheReadFactor,
+        missFactor:
+            positiveNumber(option.missFactor ?? env.OPENCODE_KEEPALIVE_MISS_FACTOR) ??
+            DEFAULTS.missFactor,
+        maxReplaysPerGap,
+        includeChildSessions: boolOption(
+            option.includeChildSessions,
+            env.OPENCODE_KEEPALIVE_INCLUDE_CHILD_SESSIONS === "true" ||
+                DEFAULTS.includeChildSessions,
         ),
-        injectSystemInstruction: boolOpt(
-            o.injectSystemInstruction,
-            DEFAULTS.injectSystemInstruction,
-        ),
-        pingToken:
-            typeof o.pingToken === "string" && o.pingToken.length > 0
-                ? o.pingToken
-                : DEFAULTS.pingToken,
-        revertPing: boolOpt(
-            o.revertPing,
-            env.OPENCODE_KEEPALIVE_REVERT_PING !== "false" && DEFAULTS.revertPing,
-        ),
-        includeChildSessions: boolOpt(o.includeChildSessions, DEFAULTS.includeChildSessions),
-        debug: boolOpt(o.debug, env.OPENCODE_KEEPALIVE_DEBUG === "true"),
-        providerAllowlist: listOpt(o.providerAllowlist, DEFAULTS.providerAllowlist),
-        modelAllowlist: listOpt(o.modelAllowlist, DEFAULTS.modelAllowlist),
+        replayTimeoutMs:
+            positiveNumber(option.replayTimeoutMs ?? env.OPENCODE_KEEPALIVE_REPLAY_TIMEOUT_MS) ??
+            DEFAULTS.replayTimeoutMs,
+        maxStoredBytes:
+            positiveNumber(option.maxStoredBytes ?? env.OPENCODE_KEEPALIVE_MAX_STORED_BYTES) ??
+            DEFAULTS.maxStoredBytes,
+        debug: boolOption(option.debug, env.OPENCODE_KEEPALIVE_DEBUG === "true"),
     }
 }
 
-function boolOpt(value: unknown, fallback: boolean): boolean {
+function boolOption(value: unknown, fallback: boolean): boolean {
     return typeof value === "boolean" ? value : fallback
 }
 
-function listOpt(value: unknown, fallback: string[]): string[] {
-    if (!Array.isArray(value)) return fallback
-    const filtered = value.filter((item): item is string => typeof item === "string")
-    return filtered.length > 0 ? filtered : fallback
+function positiveNumber(value: unknown): number | undefined {
+    const parsed = typeof value === "string" ? Number(value) : value
+    return typeof parsed === "number" && Number.isFinite(parsed) && parsed > 0 ? parsed : undefined
 }
 
-/** Accept an explicit `*Ms` option, a `*Seconds` option, or fall back. */
-function durationOpt(ms: unknown, seconds: unknown, fallback: number): number {
-    if (typeof ms === "number" && Number.isFinite(ms) && ms > 0) return ms
-    if (typeof seconds === "number" && Number.isFinite(seconds) && seconds > 0)
-        return seconds * 1000
-    return fallback
+function objectOption(value: unknown, fallback: Record<string, number>): Record<string, number> {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return fallback
+    const entries = Object.entries(value).flatMap(([key, interval]) => {
+        const parsed = positiveNumber(interval)
+        return parsed === undefined ? [] : [[key.toLowerCase(), parsed] as const]
+    })
+    return entries.length ? Object.fromEntries(entries) : fallback
 }
 
-function numEnv(raw: string | undefined, fallback: number): number {
-    if (!raw) return fallback
-    const value = Number(raw)
-    return Number.isFinite(value) && value > 0 ? value : fallback
+function listOption(value: unknown, fallback: string[]): string[] {
+    if (!Array.isArray(value)) return fallback
+    const values = value.filter(
+        (item): item is string => typeof item === "string" && item.length > 0,
+    )
+    return values.length ? values : fallback
 }