@vikrant82/opencode-cache-keepalive 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../lib/auth.ts","../lib/config.ts","../lib/control.ts","../lib/paths.ts","../lib/model.ts","../lib/keepalive.ts","../lib/logger.ts","../lib/state.ts","../lib/system.ts","../index.ts"],"sourcesContent":["/**\n * When opencode runs with `OPENCODE_SERVER_PASSWORD`, the local HTTP API requires\n * Basic auth. The SDK client handed to plugins does not carry it automatically,\n * so we attach an interceptor. No-op when the server is not password protected.\n *\n * Same approach as opencode-dynamic-context-pruning's auth helper.\n */\nexport function isSecureMode(): boolean {\n    return !!process.env.OPENCODE_SERVER_PASSWORD\n}\n\nexport function getAuthorizationHeader(): string | undefined {\n    const password = process.env.OPENCODE_SERVER_PASSWORD\n    if (!password) return undefined\n    const username = process.env.OPENCODE_SERVER_USERNAME ?? \"opencode\"\n    const credentials = Buffer.from(`${username}:${password}`).toString(\"base64\")\n    return `Basic ${credentials}`\n}\n\nexport function configureClientAuth(client: any): void {\n    const header = getAuthorizationHeader()\n    if (!header) return\n\n    const inner = client?._client ?? client?.client\n    if (!inner?.interceptors?.request) return\n\n    inner.interceptors.request.use((request: Request) => {\n        if (!request.headers.has(\"Authorization\")) {\n            request.headers.set(\"Authorization\", header)\n        }\n        return request\n    })\n}\n","export type KeepaliveConfig = {\n    /** Master switch. When false the plugin registers no timers or hooks. */\n    enabled: boolean\n    /** Milliseconds between pings. Must stay under the shortest supported provider TTL. */\n    intervalMs: number\n    /**\n     * How long to keep warming after the last real response before giving up and\n     * letting the cache go cold. The default follows the Copilot Claude\n     * write/read break-even; providers with automatic caching may be cheaper.\n     */\n    windowMs: number\n    /**\n     * Append a stable keepalive instruction to the system prompt so the model\n     * answers a `~` ping with a single `~` token and never calls tools. The\n     * instruction is added to real turns too, so the cached prefix stays identical.\n     */\n    injectSystemInstruction: boolean\n    /** The single character/token used as the keepalive suffix. */\n    pingToken: string\n    /** Remove synthetic ping turns after measuring their cache usage. */\n    revertPing: boolean\n    /** Warm subagent/child sessions too. Off by default to avoid wasted pings. */\n    includeChildSessions: boolean\n    debug: boolean\n    /** providerID substrings eligible for warming (cache-controlled providers). */\n    providerAllowlist: string[]\n    /** modelID substrings eligible for warming. */\n    modelAllowlist: string[]\n}\n\nconst DEFAULTS: KeepaliveConfig = {\n    enabled: true,\n    intervalMs: 270_000, // 4.5 min — below the shortest supported cache TTL\n    windowMs: 3_300_000, // 55 min — the Copilot Claude write/read break-even\n    injectSystemInstruction: true,\n    pingToken: \"~\",\n    revertPing: true,\n    includeChildSessions: false,\n    debug: false,\n    providerAllowlist: [\"copilot\"],\n    modelAllowlist: [\"claude\", \"anthropic\", \"sonnet\", \"opus\", \"haiku\", \"gpt\"],\n}\n\nexport function getConfig(options: Record<string, unknown> | undefined): KeepaliveConfig {\n    const o = options ?? {}\n    const env = process.env\n\n    return {\n        enabled: boolOpt(o.enabled, env.OPENCODE_KEEPALIVE_ENABLED !== \"false\" && DEFAULTS.enabled),\n        intervalMs: durationOpt(\n            o.intervalMs,\n            o.intervalSeconds,\n            numEnv(env.OPENCODE_KEEPALIVE_INTERVAL_MS, DEFAULTS.intervalMs),\n        ),\n        windowMs: durationOpt(\n            o.windowMs,\n            o.windowMinutes ? Number(o.windowMinutes) * 60 : undefined,\n            numEnv(env.OPENCODE_KEEPALIVE_WINDOW_MS, DEFAULTS.windowMs),\n        ),\n        injectSystemInstruction: boolOpt(\n            o.injectSystemInstruction,\n            DEFAULTS.injectSystemInstruction,\n        ),\n        pingToken:\n            typeof o.pingToken === \"string\" && o.pingToken.length > 0\n                ? o.pingToken\n                : DEFAULTS.pingToken,\n        revertPing: boolOpt(\n            o.revertPing,\n            env.OPENCODE_KEEPALIVE_REVERT_PING !== \"false\" && DEFAULTS.revertPing,\n        ),\n        includeChildSessions: boolOpt(o.includeChildSessions, DEFAULTS.includeChildSessions),\n        debug: boolOpt(o.debug, env.OPENCODE_KEEPALIVE_DEBUG === \"true\"),\n        providerAllowlist: listOpt(o.providerAllowlist, DEFAULTS.providerAllowlist),\n        modelAllowlist: listOpt(o.modelAllowlist, DEFAULTS.modelAllowlist),\n    }\n}\n\nfunction boolOpt(value: unknown, fallback: boolean): boolean {\n    return typeof value === \"boolean\" ? value : fallback\n}\n\nfunction listOpt(value: unknown, fallback: string[]): string[] {\n    if (!Array.isArray(value)) return fallback\n    const filtered = value.filter((item): item is string => typeof item === \"string\")\n    return filtered.length > 0 ? filtered : fallback\n}\n\n/** Accept an explicit `*Ms` option, a `*Seconds` option, or fall back. */\nfunction durationOpt(ms: unknown, seconds: unknown, fallback: number): number {\n    if (typeof ms === \"number\" && Number.isFinite(ms) && ms > 0) return ms\n    if (typeof seconds === \"number\" && Number.isFinite(seconds) && seconds > 0)\n        return seconds * 1000\n    return fallback\n}\n\nfunction numEnv(raw: string | undefined, fallback: number): number {\n    if (!raw) return fallback\n    const value = Number(raw)\n    return Number.isFinite(value) && value > 0 ? value : fallback\n}\n","import { readFileSync } from \"node:fs\"\nimport { mkdir, rename, writeFile } from \"node:fs/promises\"\nimport { dirname } from \"node:path\"\nimport { controlFilePath } from \"./paths\"\n\nexport type KeepaliveControl = {\n    version: 1\n    enabled: boolean\n    updatedAt: number\n}\n\nexport function readControl(): KeepaliveControl | undefined {\n    try {\n        const value = JSON.parse(\n            readFileSync(controlFilePath(), \"utf8\"),\n        ) as Partial<KeepaliveControl>\n        if (value.version !== 1 || typeof value.enabled !== \"boolean\") return undefined\n        if (typeof value.updatedAt !== \"number\") return undefined\n        return value as KeepaliveControl\n    } catch {\n        return undefined\n    }\n}\n\nexport async function writeControl(enabled: boolean): Promise<KeepaliveControl> {\n    const value: KeepaliveControl = {\n        version: 1,\n        enabled,\n        updatedAt: Date.now(),\n    }\n    const path = controlFilePath()\n    const tmp = `${path}.${process.pid}.${value.updatedAt}.tmp`\n    await mkdir(dirname(path), { recursive: true })\n    await writeFile(tmp, `${JSON.stringify(value)}\\n`, \"utf8\")\n    await rename(tmp, path)\n    return value\n}\n","import { createHash } from \"node:crypto\"\nimport { homedir } from \"node:os\"\nimport { join } from \"node:path\"\n\n/**\n * Absolute path to the JSON state file shared between the server plugin (writer)\n * and the TUI plugin (reader). Both processes run on the same machine, so a file\n * under opencode's plugin storage dir is the simplest cross-process channel.\n *\n * Mirrors the storage layout used by other opencode plugins:\n *   <XDG_DATA_HOME | ~/.local/share>/opencode/storage/plugin/keepalive/state.json\n */\nexport function stateFilePath(directory: string): string {\n    const key = createHash(\"sha256\").update(directory).digest(\"hex\").slice(0, 16)\n    return join(stateDirectoryPath(), `state-${key}.json`)\n}\n\nexport function stateDirectoryPath(): string {\n    return join(\n        process.env.XDG_DATA_HOME ?? join(homedir(), \".local\", \"share\"),\n        \"opencode\",\n        \"storage\",\n        \"plugin\",\n        \"keepalive\",\n    )\n}\n\n/** Runtime on/off control written by the TUI and read by the server plugin. */\nexport function controlFilePath(): string {\n    return join(stateDirectoryPath(), \"control.json\")\n}\n","import type { KeepaliveConfig } from \"./config\"\n\n/**\n * Warming only helps on providers that do prefix caching we can refresh by\n * replaying the prefix. Supported defaults include Claude and GPT models served\n * through GitHub Copilot. Everything else is skipped.\n */\nexport function isEligibleModel(\n    config: KeepaliveConfig,\n    providerID: string | undefined,\n    modelID: string | undefined,\n): boolean {\n    if (!providerID || !modelID) return false\n    const provider = providerID.toLowerCase()\n    const model = modelID.toLowerCase()\n    const providerOk = config.providerAllowlist.some((needle) => provider.includes(needle))\n    const modelOk = config.modelAllowlist.some((needle) => model.includes(needle))\n    return providerOk && modelOk\n}\n","import type { KeepaliveConfig } from \"./config\"\nimport { readControl } from \"./control\"\nimport { isEligibleModel } from \"./model\"\nimport type { KeepaliveStore, SessionKeepalive } from \"./state\"\nimport type { Logger } from \"./logger\"\n\nconst TICK_MS = 15_000\nconst JITTER_MS = 15_000\nconst CONTROL_POLL_MS = 1_000\nconst STATUS_POLL_MS = 2_000\n\n/**\n * The keepalive engine.\n *\n * Lifecycle per session:\n *   1. A real turn finishes -> `session.idle` -> arm a warm window and schedule pings.\n *   2. On each tick past `nextPingAt` (and within the window) -> `firePing`.\n *   3. `firePing` sends a `~` prompt through opencode (exact cached prefix, reuses\n *      the session's model/auth), reads `usage` to confirm a cache hit, then optionally\n *      reverts the `~`/`~` turn so it does not pollute the real conversation.\n *   4. A new real user turn or the window closing stops warming.\n */\nexport class KeepaliveEngine {\n    private timer: ReturnType<typeof setInterval> | undefined\n    private controlTimer: ReturnType<typeof setInterval> | undefined\n    private statusTimer: ReturnType<typeof setInterval> | undefined\n    private controlUpdatedAt = 0\n    private reconcilingStatus = false\n    private enabled: boolean\n\n    constructor(\n        private readonly client: any,\n        private readonly config: KeepaliveConfig,\n        private readonly store: KeepaliveStore,\n        private readonly logger: Logger,\n    ) {\n        const control = readControl()\n        this.enabled = control?.enabled ?? config.enabled\n        this.controlUpdatedAt = control?.updatedAt ?? 0\n        this.store.setEnabled(this.enabled)\n    }\n\n    start(): void {\n        if (this.timer) return\n        this.timer = setInterval(() => void this.tick(), TICK_MS)\n        this.controlTimer = setInterval(() => this.pollControl(), CONTROL_POLL_MS)\n        this.statusTimer = setInterval(() => void this.reconcileStatus(), STATUS_POLL_MS)\n        this.store.persist()\n        this.logger.info(\n            `started (${this.enabled ? \"enabled\" : \"disabled\"}, ` +\n                `interval=${Math.round(this.config.intervalMs / 1000)}s, ` +\n                `window=${Math.round(this.config.windowMs / 60_000)}m)`,\n        )\n    }\n\n    stop(): void {\n        if (!this.timer) return\n        clearInterval(this.timer)\n        this.timer = undefined\n        if (this.controlTimer) clearInterval(this.controlTimer)\n        this.controlTimer = undefined\n        if (this.statusTimer) clearInterval(this.statusTimer)\n        this.statusTimer = undefined\n    }\n\n    /** True while a ping is in flight — used to block tool calls during a ping. */\n    isWarming(sessionID: string): boolean {\n        return !!this.store.get(sessionID)?.warming\n    }\n\n    async onEvent(event: any): Promise<void> {\n        const type: string | undefined = event?.type\n        if (!type) return\n\n        if (type === \"session.deleted\") {\n            const id = event.properties?.sessionID ?? event.properties?.info?.id\n            if (id) {\n                this.store.remove(id)\n                this.store.persist()\n            }\n            return\n        }\n\n        if (type === \"message.updated\") {\n            const info = event.properties?.info\n            const sessionID: string | undefined = info?.sessionID ?? event.properties?.sessionID\n            if (!sessionID) return\n            const session = this.store.get(sessionID)\n            // Ignore everything that happens inside our own ping turn.\n            if (session?.warming) return\n            const eventAt = info?.time?.completed ?? info?.time?.created\n            // Events are asynchronous: a completed ping may still emit message updates\n            // after `warming` clears. Their timestamps predate the recorded ping.\n            if (session?.lastPingAt && typeof eventAt === \"number\" && eventAt <= session.lastPingAt)\n                return\n\n            if (info?.role === \"user\") {\n                const s = this.store.ensure(sessionID)\n                s.busy = true\n                s.active = false\n                this.store.persist()\n                return\n            }\n\n            if (info?.role === \"assistant\" && typeof info?.time?.completed === \"number\") {\n                const s = this.store.ensure(sessionID)\n                s.lastResponseAt = info.time.completed\n                this.store.persist()\n            }\n            return\n        }\n\n        if (type === \"session.status\") {\n            const sessionID: string | undefined = event.properties?.sessionID\n            const status: string | undefined = event.properties?.status?.type\n            if (!sessionID || !status) return\n\n            // The ping's own status transitions must not restart its idle window.\n            if (this.store.get(sessionID)?.warming) return\n\n            if (status === \"idle\") {\n                await this.armWindow(sessionID)\n                return\n            }\n\n            const s = this.store.ensure(sessionID)\n            s.busy = true\n            s.active = false\n            this.store.persist()\n            return\n        }\n\n        // Compatibility fallback for opencode versions predating session.status.\n        if (type === \"session.idle\") {\n            const sessionID: string | undefined = event.properties?.sessionID\n            if (!sessionID) return\n            if (this.store.get(sessionID)?.warming) return // idle from our own ping\n            await this.armWindow(sessionID)\n        }\n    }\n\n    private async armWindow(sessionID: string): Promise<void> {\n        const s = this.store.ensure(sessionID)\n        // Duplicate idle events (including late events from a ping) must not reset the\n        // current idle stretch or extend its warm window.\n        if (s.active && !s.busy) return\n        s.busy = false\n        await this.resolveSession(s)\n\n        // A new turn may have started while session metadata was being resolved.\n        if (s.busy || !this.enabled || !s.eligible) {\n            s.active = false\n            this.store.persist()\n            return\n        }\n\n        const now = Date.now()\n        if (!s.lastResponseAt) s.lastResponseAt = now\n        s.idleSince = now\n        s.windowEndsAt = now + this.config.windowMs\n        s.nextPingAt = now + this.config.intervalMs\n        s.pingsSent = 0\n        s.lastPing = undefined\n        s.active = true\n        this.store.persist()\n        this.logger.dbg(`armed ${short(sessionID)} model=${s.modelLabel}`)\n    }\n\n    private async tick(): Promise<void> {\n        if (!this.enabled) return\n        const now = Date.now()\n        for (const s of this.store.all()) {\n            if (!s.eligible || !s.active || s.busy || s.warming) continue\n\n            if (now >= s.windowEndsAt) {\n                s.active = false\n                this.store.persist()\n                this.logger.dbg(\n                    `window closed ${short(s.sessionID)} after ${s.pingsSent} ping(s) — cache may cool`,\n                )\n                continue\n            }\n\n            if (now >= s.nextPingAt) void this.firePing(s.sessionID)\n        }\n    }\n\n    private async firePing(sessionID: string): Promise<void> {\n        const s = this.store.get(sessionID)\n        if (!s || s.warming || s.busy) return\n\n        s.warming = true\n        this.store.persist()\n        const startAt = Date.now()\n\n        try {\n            const res = await this.client.session.prompt({\n                path: { id: sessionID },\n                body: { parts: [{ type: \"text\", text: this.config.pingToken }] },\n            })\n\n            const info = res?.data?.info ?? res?.info\n            const cache = info?.tokens?.cache ?? {}\n            const record = {\n                at: Date.now(),\n                hit: Number(cache.read ?? 0) > 0,\n                input: Number(info?.tokens?.input ?? 0),\n                cacheRead: Number(cache.read ?? 0),\n                cacheWrite: Number(cache.write ?? 0),\n                output: Number(info?.tokens?.output ?? 0),\n            }\n            s.lastPing = record\n            s.lastPingAt = record.at\n            s.pingsSent += 1\n            this.logger.info(\n                `ping ${short(sessionID)} ${record.hit ? \"HIT\" : \"MISS\"} ` +\n                    `in=${record.input} read=${record.cacheRead} write=${record.cacheWrite} out=${record.output}`,\n            )\n\n            if (this.config.revertPing) await this.revertPing(sessionID, startAt)\n        } catch (err) {\n            this.logger.warn(`ping ${short(sessionID)} failed`, errText(err))\n        } finally {\n            s.warming = false\n            s.nextPingAt = Date.now() + jitter(this.config.intervalMs)\n            this.store.persist()\n        }\n    }\n\n    /** Remove the `~` user + `~` assistant turn so it never enters real context. */\n    private async revertPing(sessionID: string, startAt: number): Promise<void> {\n        let messages: any[]\n        try {\n            const res = await this.client.session.messages({ path: { id: sessionID } })\n            messages = res?.data ?? res ?? []\n        } catch (err) {\n            this.logger.warn(`ping ${short(sessionID)} revert: list failed`, errText(err))\n            return\n        }\n\n        let target: string | undefined\n        for (const m of messages) {\n            if (m?.info?.role !== \"user\") continue\n            if (Number(m.info?.time?.created ?? 0) < startAt - 2_000) continue\n            const text = (m.parts ?? [])\n                .filter((p: any) => p?.type === \"text\")\n                .map((p: any) => p?.text ?? \"\")\n                .join(\"\")\n                .trim()\n            if (text === this.config.pingToken) target = m.info.id\n        }\n\n        if (!target) {\n            this.logger.dbg(`ping ${short(sessionID)} revert: ping message not found`)\n            return\n        }\n\n        try {\n            await this.client.session.revert({\n                path: { id: sessionID },\n                body: { messageID: target },\n            })\n        } catch (err) {\n            // BusyError (a real turn started) or similar — leave the ping visible.\n            this.logger.warn(`ping ${short(sessionID)} revert failed`, errText(err))\n        }\n    }\n\n    private async resolveSession(s: SessionKeepalive): Promise<void> {\n        try {\n            const res = await this.client.session.get({ path: { id: s.sessionID } })\n            const info = res?.data ?? res\n            if (info?.parentID && !this.config.includeChildSessions) {\n                s.eligible = false\n                s.modelLabel = info?.model?.id ?? \"child\"\n                return\n            }\n            s.modelLabel = info?.model?.id ?? \"unknown\"\n            s.eligible = isEligibleModel(this.config, info?.model?.providerID, info?.model?.id)\n        } catch (err) {\n            s.eligible = false\n            this.logger.dbg(`resolve ${short(s.sessionID)} failed`, errText(err))\n        }\n    }\n\n    private pollControl(): void {\n        const control = readControl()\n        if (!control || control.updatedAt <= this.controlUpdatedAt) return\n        this.controlUpdatedAt = control.updatedAt\n        if (control.enabled === this.enabled) return\n\n        this.enabled = control.enabled\n        this.store.setEnabled(control.enabled)\n        const now = Date.now()\n        for (const session of this.store.all()) {\n            if (!control.enabled) {\n                session.active = false\n                continue\n            }\n            if (!session.eligible || session.busy || session.warming) continue\n            if (!session.lastResponseAt) session.lastResponseAt = now\n            session.idleSince = now\n            session.windowEndsAt = now + this.config.windowMs\n            session.nextPingAt = now + this.config.intervalMs\n            session.pingsSent = 0\n            session.lastPing = undefined\n            session.active = true\n        }\n        this.store.persist()\n        this.logger.info(`runtime ${control.enabled ? \"enabled\" : \"disabled\"}`)\n    }\n\n    /** Recover when a session.status idle event is missed by reconciling with the API. */\n    private async reconcileStatus(): Promise<void> {\n        if (this.reconcilingStatus) return\n        const busy = this.store.all().filter((session) => session.busy && !session.warming)\n        if (busy.length === 0) return\n\n        this.reconcilingStatus = true\n        try {\n            const res = await this.client.session.status()\n            const statuses = res?.data ?? res ?? {}\n            for (const session of busy) {\n                const status = statuses?.[session.sessionID]?.type ?? \"idle\"\n                if (status === \"idle\") await this.armWindow(session.sessionID)\n            }\n        } catch (err) {\n            this.logger.dbg(\"status reconciliation failed\", errText(err))\n        } finally {\n            this.reconcilingStatus = false\n        }\n    }\n}\n\nfunction short(sessionID: string): string {\n    return sessionID.slice(-6)\n}\n\nfunction jitter(base: number): number {\n    return Math.max(1_000, base + Math.floor((Math.random() * 2 - 1) * JITTER_MS))\n}\n\nfunction errText(err: unknown): string {\n    return err instanceof Error ? err.message : String(err)\n}\n","const PREFIX = \"[cache-keepalive]\"\n\nexport class Logger {\n    constructor(private readonly debug: boolean) {}\n\n    info(message: string, data?: unknown) {\n        if (this.debug) console.log(`${PREFIX} ${message}`, data ?? \"\")\n    }\n\n    warn(message: string, data?: unknown) {\n        console.warn(`${PREFIX} ${message}`, data ?? \"\")\n    }\n\n    error(message: string, data?: unknown) {\n        console.error(`${PREFIX} ${message}`, data ?? \"\")\n    }\n\n    dbg(message: string, data?: unknown) {\n        if (this.debug) console.log(`${PREFIX}:debug ${message}`, data ?? \"\")\n    }\n}\n","import { mkdir, rename, writeFile } from \"node:fs/promises\"\nimport { dirname } from \"node:path\"\nimport type { KeepaliveConfig } from \"./config\"\nimport { stateFilePath } from \"./paths\"\n\nexport type PingRecord = {\n    at: number\n    hit: boolean\n    input: number\n    cacheRead: number\n    cacheWrite: number\n    output: number\n}\n\n/** Live per-session bookkeeping held by the server plugin. */\nexport type SessionKeepalive = {\n    sessionID: string\n    /** Whether the session's provider/model pair supports cache warming. */\n    eligible: boolean\n    modelLabel?: string\n    /** Epoch ms of the last real assistant response (excludes ping replies). */\n    lastResponseAt: number\n    /** Epoch ms the current idle stretch began. */\n    idleSince: number\n    /** Epoch ms after which warming stops and the cache is allowed to go cold. */\n    windowEndsAt: number\n    /** Epoch ms the next ping is due. */\n    nextPingAt: number\n    /** Pings sent during the current idle stretch. */\n    pingsSent: number\n    /** A real turn is currently running. */\n    busy: boolean\n    /** A keepalive ping is currently in flight. */\n    warming: boolean\n    /** Within the warm window and actively scheduling pings. */\n    active: boolean\n    /** Epoch ms of the last ping; retained only to ignore its late events. */\n    lastPingAt?: number\n    lastPing?: PingRecord\n}\n\n/** Lean projection persisted to disk for the TUI reader. */\nexport type PersistedSession = {\n    eligible: boolean\n    modelLabel?: string\n    lastResponseAt: number\n    idleSince: number\n    windowEndsAt: number\n    nextPingAt: number\n    intervalMs: number\n    pingsSent: number\n    busy: boolean\n    warming: boolean\n    active: boolean\n    lastPing?: PingRecord\n}\n\nexport type PersistedState = {\n    version: 1\n    updatedAt: number\n    enabled: boolean\n    intervalMs: number\n    windowMs: number\n    sessions: Record<string, PersistedSession>\n}\n\nexport class KeepaliveStore {\n    private readonly sessions = new Map<string, SessionKeepalive>()\n    private writeQueue: Promise<void> = Promise.resolve()\n    private enabled: boolean\n\n    constructor(\n        private readonly config: KeepaliveConfig,\n        private readonly directory: string,\n    ) {\n        this.enabled = config.enabled\n    }\n\n    setEnabled(enabled: boolean): void {\n        this.enabled = enabled\n    }\n\n    get(sessionID: string): SessionKeepalive | undefined {\n        return this.sessions.get(sessionID)\n    }\n\n    ensure(sessionID: string): SessionKeepalive {\n        const existing = this.sessions.get(sessionID)\n        if (existing) return existing\n        const created: SessionKeepalive = {\n            sessionID,\n            eligible: false,\n            lastResponseAt: 0,\n            idleSince: 0,\n            windowEndsAt: 0,\n            nextPingAt: 0,\n            pingsSent: 0,\n            busy: false,\n            warming: false,\n            active: false,\n        }\n        this.sessions.set(sessionID, created)\n        return created\n    }\n\n    remove(sessionID: string): void {\n        this.sessions.delete(sessionID)\n    }\n\n    all(): SessionKeepalive[] {\n        return [...this.sessions.values()]\n    }\n\n    /** Atomically persist a lean snapshot for the TUI. Never throws to callers. */\n    persist(): void {\n        const snapshot: PersistedState = {\n            version: 1,\n            updatedAt: Date.now(),\n            enabled: this.enabled,\n            intervalMs: this.config.intervalMs,\n            windowMs: this.config.windowMs,\n            sessions: Object.fromEntries(\n                this.all().map((s) => [\n                    s.sessionID,\n                    {\n                        eligible: s.eligible,\n                        modelLabel: s.modelLabel,\n                        lastResponseAt: s.lastResponseAt,\n                        idleSince: s.idleSince,\n                        windowEndsAt: s.windowEndsAt,\n                        nextPingAt: s.nextPingAt,\n                        intervalMs: this.config.intervalMs,\n                        pingsSent: s.pingsSent,\n                        busy: s.busy,\n                        warming: s.warming,\n                        active: s.active,\n                        lastPing: s.lastPing,\n                    } satisfies PersistedSession,\n                ]),\n            ),\n        }\n\n        const write = () => atomicWrite(stateFilePath(this.directory), JSON.stringify(snapshot))\n        this.writeQueue = this.writeQueue.then(write, write)\n    }\n}\n\nasync function atomicWrite(path: string, contents: string): Promise<void> {\n    try {\n        const tmp = `${path}.${process.pid}.${Date.now()}.tmp`\n        await mkdir(dirname(path), { recursive: true })\n        await writeFile(tmp, `${contents}\\n`, \"utf8\")\n        await rename(tmp, path)\n    } catch {\n        // Persistence is best-effort; the TUI readout simply falls behind.\n    }\n}\n","/**\n * Stable keepalive instruction appended to the system prompt.\n *\n * IMPORTANT: this text must be byte-stable and applied to *every* request for an\n * eligible model (real turns and pings alike). If it were only added on pings, the\n * system prefix would differ from real turns and the ping would miss the cache.\n * Adding it consistently keeps the cached prefix identical and lets the model\n * answer a ping with a single token instead of a paragraph or a tool call.\n */\nexport function keepaliveInstruction(pingToken: string): string {\n    return [\n        \"<cache_keepalive>\",\n        `A user message consisting of exactly the single token \"${pingToken}\" is an`,\n        \"automated cache-keepalive ping, not a real request. When you receive it,\",\n        `reply with exactly \"${pingToken}\" and nothing else. Do not call any tools,`,\n        \"do not explain, and do not take any action.\",\n        \"</cache_keepalive>\",\n    ].join(\"\\n\")\n}\n","import type { Plugin } from \"@opencode-ai/plugin\"\nimport { configureClientAuth, isSecureMode } from \"./lib/auth\"\nimport { getConfig } from \"./lib/config\"\nimport { KeepaliveEngine } from \"./lib/keepalive\"\nimport { Logger } from \"./lib/logger\"\nimport { isEligibleModel } from \"./lib/model\"\nimport { KeepaliveStore } from \"./lib/state\"\nimport { keepaliveInstruction } from \"./lib/system\"\n\ndeclare const __KEEPALIVE_VERSION__: string\n\nconst server: Plugin = async (ctx, options) => {\n    const config = getConfig(options as Record<string, unknown> | undefined)\n    const logger = new Logger(config.debug)\n\n    if (!config.enabled) {\n        logger.info(\"disabled via config\")\n        return {}\n    }\n\n    if (isSecureMode()) configureClientAuth(ctx.client)\n\n    const store = new KeepaliveStore(config, ctx.directory)\n    const engine = new KeepaliveEngine(ctx.client, config, store, logger)\n    engine.start()\n\n    const version = typeof __KEEPALIVE_VERSION__ !== \"undefined\" ? __KEEPALIVE_VERSION__ : \"dev\"\n    logger.info(`v${version} ready`)\n\n    const instruction = keepaliveInstruction(config.pingToken)\n\n    return {\n        event: async ({ event }) => {\n            await engine.onEvent(event)\n        },\n\n        // Keep the system prefix identical between real turns and pings, and make\n        // the model answer a ping with a single token.\n        \"experimental.chat.system.transform\": async (input, output) => {\n            if (!config.injectSystemInstruction) return\n            const model = input.model as { providerID?: string; id?: string; modelID?: string }\n            if (!isEligibleModel(config, model?.providerID, model?.id ?? model?.modelID)) return\n            output.system.push(instruction)\n        },\n\n        // Backstop: if the model ignores the instruction and tries a tool during a\n        // ping, block it — the ping turn is going to be reverted anyway.\n        \"tool.execute.before\": async (input) => {\n            if (engine.isWarming(input.sessionID)) {\n                throw new Error(\"cache-keepalive: tools are disabled during a keepalive ping\")\n            }\n        },\n\n        dispose: async () => {\n            engine.stop()\n        },\n    }\n}\n\nexport default server\n"],"mappings":"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","names":["mkdir","rename","writeFile","dirname","mkdir","dirname","writeFile","rename"]}

package/dist/lib/auth.d.ts

@@ -0,0 +1,11 @@
+/**
+ * When opencode runs with `OPENCODE_SERVER_PASSWORD`, the local HTTP API requires
+ * Basic auth. The SDK client handed to plugins does not carry it automatically,
+ * so we attach an interceptor. No-op when the server is not password protected.
+ *
+ * Same approach as opencode-dynamic-context-pruning's auth helper.
+ */
+export declare function isSecureMode(): boolean;
+export declare function getAuthorizationHeader(): string | undefined;
+export declare function configureClientAuth(client: any): void;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../lib/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAM3D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAarD"}

package/dist/lib/config.d.ts

@@ -0,0 +1,31 @@
+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. */
+    includeChildSessions: boolean;
+    debug: boolean;
+    /** providerID substrings eligible for warming (cache-controlled providers). */
+    providerAllowlist: string[];
+    /** modelID substrings eligible for warming. */
+    modelAllowlist: string[];
+};
+export declare function getConfig(options: Record<string, unknown> | undefined): KeepaliveConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../lib/config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC1B,yEAAyE;IACzE,OAAO,EAAE,OAAO,CAAA;IAChB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,uBAAuB,EAAE,OAAO,CAAA;IAChC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAA;IACnB,8EAA8E;IAC9E,oBAAoB,EAAE,OAAO,CAAA;IAC7B,KAAK,EAAE,OAAO,CAAA;IACd,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,+CAA+C;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAA;CAC3B,CAAA;AAeD,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,eAAe,CAiCvF"}

package/dist/lib/control.d.ts

@@ -0,0 +1,8 @@
+export type KeepaliveControl = {
+    version: 1;
+    enabled: boolean;
+    updatedAt: number;
+};
+export declare function readControl(): KeepaliveControl | undefined;
+export declare function writeControl(enabled: boolean): Promise<KeepaliveControl>;
+//# sourceMappingURL=control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../lib/control.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,wBAAgB,WAAW,IAAI,gBAAgB,GAAG,SAAS,CAW1D;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAY9E"}

package/dist/lib/keepalive.d.ts

@@ -0,0 +1,42 @@
+import type { KeepaliveConfig } from "./config";
+import type { KeepaliveStore } from "./state";
+import type { Logger } from "./logger";
+/**
+ * The keepalive engine.
+ *
+ * Lifecycle per session:
+ *   1. A real turn finishes -> `session.idle` -> arm a warm window and schedule pings.
+ *   2. On each tick past `nextPingAt` (and within the window) -> `firePing`.
+ *   3. `firePing` sends a `~` prompt through opencode (exact cached prefix, reuses
+ *      the session's model/auth), reads `usage` to confirm a cache hit, then optionally
+ *      reverts the `~`/`~` turn so it does not pollute the real conversation.
+ *   4. A new real user turn or the window closing stops warming.
+ */
+export declare class KeepaliveEngine {
+    private readonly client;
+    private readonly config;
+    private readonly store;
+    private readonly logger;
+    private timer;
+    private controlTimer;
+    private statusTimer;
+    private controlUpdatedAt;
+    private reconcilingStatus;
+    private enabled;
+    constructor(client: any, config: KeepaliveConfig, store: KeepaliveStore, logger: Logger);
+    start(): void;
+    stop(): void;
+    /** True while a ping is in flight — used to block tool calls during a ping. */
+    isWarming(sessionID: string): boolean;
+    onEvent(event: any): Promise<void>;
+    private armWindow;
+    private tick;
+    private firePing;
+    /** Remove the `~` user + `~` assistant turn so it never enters real context. */
+    private revertPing;
+    private resolveSession;
+    private pollControl;
+    /** Recover when a session.status idle event is missed by reconciling with the API. */
+    private reconcileStatus;
+}
+//# sourceMappingURL=keepalive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keepalive.d.ts","sourceRoot":"","sources":["../../lib/keepalive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG/C,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,SAAS,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAOtC;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IASpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAX3B,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,YAAY,CAA4C;IAChE,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,OAAO,CAAS;gBAGH,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM;IAQnC,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAUZ,+EAA+E;IAC/E,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAuE1B,SAAS;YA2BT,IAAI;YAmBJ,QAAQ;IA0CtB,gFAAgF;YAClE,UAAU;YAsCV,cAAc;IAiB5B,OAAO,CAAC,WAAW;IA2BnB,sFAAsF;YACxE,eAAe;CAmBhC"}

package/dist/lib/logger.d.ts

@@ -0,0 +1,9 @@
+export declare class Logger {
+    private readonly debug;
+    constructor(debug: boolean);
+    info(message: string, data?: unknown): void;
+    warn(message: string, data?: unknown): void;
+    error(message: string, data?: unknown): void;
+    dbg(message: string, data?: unknown): void;
+}
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../lib/logger.ts"],"names":[],"mappings":"AAEA,qBAAa,MAAM;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,OAAO;IAE3C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIpC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIpC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAIrC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAGtC"}

package/dist/lib/model.d.ts

@@ -0,0 +1,8 @@
+import type { KeepaliveConfig } from "./config";
+/**
+ * Warming only helps on providers that do prefix caching we can refresh by
+ * replaying the prefix. Supported defaults include Claude and GPT models served
+ * through GitHub Copilot. Everything else is skipped.
+ */
+export declare function isEligibleModel(config: KeepaliveConfig, providerID: string | undefined, modelID: string | undefined): boolean;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../lib/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C;;;;GAIG;AACH,wBAAgB,eAAe,CAC3B,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAOT"}

package/dist/lib/paths.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Absolute path to the JSON state file shared between the server plugin (writer)
+ * and the TUI plugin (reader). Both processes run on the same machine, so a file
+ * under opencode's plugin storage dir is the simplest cross-process channel.
+ *
+ * Mirrors the storage layout used by other opencode plugins:
+ *   <XDG_DATA_HOME | ~/.local/share>/opencode/storage/plugin/keepalive/state.json
+ */
+export declare function stateFilePath(directory: string): string;
+export declare function stateDirectoryPath(): string;
+/** Runtime on/off control written by the TUI and read by the server plugin. */
+export declare function controlFilePath(): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../lib/paths.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAQ3C;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/lib/state.d.ts

@@ -0,0 +1,74 @@
+import type { KeepaliveConfig } from "./config";
+export type PingRecord = {
+    at: number;
+    hit: boolean;
+    input: number;
+    cacheRead: number;
+    cacheWrite: number;
+    output: number;
+};
+/** 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;
+    /** Pings sent during the current idle stretch. */
+    pingsSent: number;
+    /** A real turn is currently running. */
+    busy: boolean;
+    /** A keepalive ping is currently in flight. */
+    warming: boolean;
+    /** Within the warm window and actively scheduling pings. */
+    active: boolean;
+    /** Epoch ms of the last ping; retained only to ignore its late events. */
+    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 to callers. */
+    persist(): void;
+}
+//# sourceMappingURL=state.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../lib/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAG/C,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,gBAAgB,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAA;IACjB,wEAAwE;IACxE,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,YAAY,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,IAAI,EAAE,OAAO,CAAA;IACb,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAA;IAChB,4DAA4D;IAC5D,MAAM,EAAE,OAAO,CAAA;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,UAAU,CAAA;CACxB,CAAA;AAED,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,UAAU,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,CAAC,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAC7C,CAAA;AAED,qBAAa,cAAc;IAMnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsC;IAC/D,OAAO,CAAC,UAAU,CAAmC;IACrD,OAAO,CAAC,OAAO,CAAS;gBAGH,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM;IAKtC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIpD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAmB3C,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/B,GAAG,IAAI,gBAAgB,EAAE;IAIzB,+EAA+E;IAC/E,OAAO,IAAI,IAAI;CA+BlB"}

package/dist/lib/system.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Stable keepalive instruction appended to the system prompt.
+ *
+ * IMPORTANT: this text must be byte-stable and applied to *every* request for an
+ * eligible model (real turns and pings alike). If it were only added on pings, the
+ * system prefix would differ from real turns and the ping would miss the cache.
+ * Adding it consistently keeps the cached prefix identical and lets the model
+ * answer a ping with a single token instead of a paragraph or a tool call.
+ */
+export declare function keepaliveInstruction(pingToken: string): string;
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../lib/system.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS9D"}

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

@@ -0,0 +1,3 @@
+import type { TuiPluginApi } from "@opencode-ai/plugin/tui";
+export declare function registerKeepaliveCommands(api: TuiPluginApi): void;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +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,CA8CjE"}

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

@@ -0,0 +1,14 @@
+/** @jsxImportSource @opentui/solid */
+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.
+ */
+export declare function KeepaliveFooter(props: {
+    theme: Theme;
+    directory: string;
+    sessionID?: string;
+}): any;
+export {};
+//# sourceMappingURL=footer.d.ts.map

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

@@ -0,0 +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,OAwG7F"}

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

@@ -0,0 +1,3 @@
+export declare function mmss(ms: number): string;
+export declare function kfmt(n: number): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +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"}

package/dist/tui.d.ts

@@ -0,0 +1,7 @@
+/** @jsxImportSource @opentui/solid */
+declare const _default: {
+    id: string;
+    tui: import("@opencode-ai/plugin/tui").TuiPlugin;
+};
+export default _default;
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../tui.tsx"],"names":[],"mappings":"AAAA,sCAAsC;;;;;AAwBtC,wBAAgF"}

package/lib/auth.ts

@@ -0,0 +1,33 @@
+/**
+ * When opencode runs with `OPENCODE_SERVER_PASSWORD`, the local HTTP API requires
+ * Basic auth. The SDK client handed to plugins does not carry it automatically,
+ * so we attach an interceptor. No-op when the server is not password protected.
+ *
+ * Same approach as opencode-dynamic-context-pruning's auth helper.
+ */
+export function isSecureMode(): boolean {
+    return !!process.env.OPENCODE_SERVER_PASSWORD
+}
+
+export function getAuthorizationHeader(): string | undefined {
+    const password = process.env.OPENCODE_SERVER_PASSWORD
+    if (!password) return undefined
+    const username = process.env.OPENCODE_SERVER_USERNAME ?? "opencode"
+    const credentials = Buffer.from(`${username}:${password}`).toString("base64")
+    return `Basic ${credentials}`
+}
+
+export function configureClientAuth(client: any): void {
+    const header = getAuthorizationHeader()
+    if (!header) return
+
+    const inner = client?._client ?? client?.client
+    if (!inner?.interceptors?.request) return
+
+    inner.interceptors.request.use((request: Request) => {
+        if (!request.headers.has("Authorization")) {
+            request.headers.set("Authorization", header)
+        }
+        return request
+    })
+}

package/lib/config.ts

@@ -0,0 +1,101 @@
+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. */
+    includeChildSessions: boolean
+    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,
+    includeChildSessions: false,
+    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
+
+    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),
+        ),
+        windowMs: durationOpt(
+            o.windowMs,
+            o.windowMinutes ? Number(o.windowMinutes) * 60 : undefined,
+            numEnv(env.OPENCODE_KEEPALIVE_WINDOW_MS, DEFAULTS.windowMs),
+        ),
+        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),
+    }
+}
+
+function boolOpt(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
+}
+
+/** 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 numEnv(raw: string | undefined, fallback: number): number {
+    if (!raw) return fallback
+    const value = Number(raw)
+    return Number.isFinite(value) && value > 0 ? value : fallback
+}

package/lib/control.ts

@@ -0,0 +1,37 @@
+import { readFileSync } from "node:fs"
+import { mkdir, rename, writeFile } from "node:fs/promises"
+import { dirname } from "node:path"
+import { controlFilePath } from "./paths"
+
+export type KeepaliveControl = {
+    version: 1
+    enabled: boolean
+    updatedAt: number
+}
+
+export function readControl(): KeepaliveControl | undefined {
+    try {
+        const value = JSON.parse(
+            readFileSync(controlFilePath(), "utf8"),
+        ) as Partial<KeepaliveControl>
+        if (value.version !== 1 || typeof value.enabled !== "boolean") return undefined
+        if (typeof value.updatedAt !== "number") return undefined
+        return value as KeepaliveControl
+    } catch {
+        return undefined
+    }
+}
+
+export async function writeControl(enabled: boolean): Promise<KeepaliveControl> {
+    const value: KeepaliveControl = {
+        version: 1,
+        enabled,
+        updatedAt: Date.now(),
+    }
+    const path = controlFilePath()
+    const tmp = `${path}.${process.pid}.${value.updatedAt}.tmp`
+    await mkdir(dirname(path), { recursive: true })
+    await writeFile(tmp, `${JSON.stringify(value)}\n`, "utf8")
+    await rename(tmp, path)
+    return value
+}