@eddyskywalker/dsh-chatgpt-subscription 0.40.1 → 0.41.0

package/lib/types/host/kimi-code/client.d.ts.map

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

package/lib/types/host/kimi-code/mapper.d.ts

@@ -47,6 +47,60 @@ import type { KimiCodeReasoningEffort, KimiCodeWire } from '../../shared/kimi-co
 export declare const KNOWN_REASONING_KEYS: readonly ["reasoning_content", "reasoning_details", "reasoning"];
 /** Default outbound reasoning key, used until a response proves otherwise. */
 export declare const DEFAULT_REASONING_KEY: string;
+/**
+ * How one `reasoning_details` fragment arrived on the wire.
+ *
+ * - `string` — the older bare-string spelling of the whole field;
+ * - `summary` — a visible summary element: official `type: 'summary'`, no
+ *   `type` at all, or the `reasoning.summary` gateway spelling;
+ * - `encrypted` — official opaque provider state, which carries no visible text;
+ * - `text` — the `reasoning.text` compatibility spelling.
+ *
+ * The form is recorded because the same text has to be written back in the shape
+ * it arrived in: a bare string must not become an array, and an official
+ * encrypted element must stay one.
+ */
+export type ReasoningForm = 'string' | 'text' | 'summary' | 'encrypted';
+/**
+ * One reasoning fragment, together with how it arrived.
+ *
+ * The key is carried per fragment rather than per message because one delta can
+ * legitimately carry several at once: Kimi answers under `reasoning_content`,
+ * gateways add `reasoning_details`, and newer vLLM builds reply under
+ * `reasoning`. Stopping at the first field loses text the service already
+ * charged for, and flattening every field onto one outbound key is what makes a
+ * replay read as a field the peer never sent.
+ *
+ * An encrypted fragment is the one shape with no visible text: its `text` is ''
+ * and its payload stays in `encrypted`, which is opaque provider state and is
+ * never decoded, rendered, or logged.
+ */
+export interface ReasoningFragment {
+    /** Wire field the fragment arrived under. */
+    readonly key: string;
+    /** Wire form, only meaningful when `key` is `reasoning_details`. */
+    readonly form?: ReasoningForm;
+    /** Element `type` exactly as received; absent when the element carried none. */
+    readonly wireType?: string;
+    /** Element index: the wire's own number, else the element's position. */
+    readonly index?: number;
+    /** Opaque encrypted provider state (`form: 'encrypted'`); never text. */
+    readonly encrypted?: string;
+    /** Visible text; always '' for an encrypted fragment. */
+    readonly text: string;
+}
+/**
+ * Every reasoning fragment one inbound object (a stream delta or a message)
+ * carries, in a fixed, documented order.
+ *
+ * `reasoning_content` comes first and `reasoning` last because that is the
+ * order of {@link KNOWN_REASONING_KEYS}: the Kimi field is the one this route is
+ * documented against and `reasoning` is the newer vLLM rename, so a delta
+ * carrying both keeps its text in the order a single-key endpoint would have
+ * produced it in. A `reasoning_details` array keeps its arrival order; `index` is
+ * carried as metadata and never reorders it (see reasoningDetailFragments).
+ */
+export declare function reasoningFragmentsOf(source: unknown): ReasoningFragment[];
 /**
  * Per-endpoint reasoning-field dialect: observes what the endpoint actually
  * sends, and echoes thinking back under the same key.
@@ -59,7 +113,23 @@ export declare const DEFAULT_REASONING_KEY: string;
  */
 export declare class ReasoningKeyDialect {
     private detected;
-    /** Reasoning text on an inbound message or delta, remembering its key. */
+    /**
+     * Every reasoning fragment one inbound delta carries, remembering the dialect.
+     *
+     * The FIRST string-shaped fragment names the key this endpoint speaks, which is
+     * exactly the field the earlier single-match read picked: an endpoint answering
+     * under `reasoning_content` keeps that outbound key even when the same delta
+     * also carries a sibling field, so learning does not change just because a peer
+     * became chattier.
+     *
+     * An element of a `reasoning_details` ARRAY never teaches the dialect: the
+     * outbound key must be a field that takes a plain string, and array elements
+     * could only teach `reasoning_details`, which on that wire is an array. A bare
+     * string `reasoning_details` still teaches it, because that spelling really is
+     * a string.
+     */
+    observeAll(source: unknown): ReasoningFragment[];
+    /** First reasoning fragment on an inbound message or delta, remembering its key. */
     observe(source: unknown): string | undefined;
     /** The key to serialize thinking into on an outbound assistant message. */
     outboundKey(): string;
@@ -166,6 +236,67 @@ export interface RequestMediaOptions {
      * (`messages[].tools`), Kimi's `dynamically_loaded_tools` capability.
      */
     messageTools?: boolean;
+    /**
+     * Hosted references this request already uploaded, keyed by ATTACHMENT ID.
+     *
+     * The value is the `ms://<id>` reference the upload returned, and citing it
+     * instead of the bytes is the whole point: the service reads the stored file,
+     * so the body carries a ~20-byte URL where it used to carry a megabyte of
+     * base64. Only the OpenAI-compatible surface documents this; the Anthropic
+     * one keeps its inline block (see anthropicUserContent).
+     *
+     * A miss is not an error: an occurrence with no entry here is sent exactly as
+     * it always was (inline when readable, the unavailable placeholder when not),
+     * which is what makes a per-media upload failure degrade instead of fail.
+     */
+    imageReferences?: ReadonlyMap<string, string>;
+    /** Hosted video references, keyed by attachment id; see imageReferences. */
+    videoReferences?: ReadonlyMap<string, string>;
+}
+/**
+ * One `reasoning_details` element, rebuilt from the provenance the stream
+ * recorded.
+ *
+ * Each variant is written back in the shape it arrived in: `text` and `summary`
+ * keep the wire `type` they were sent with (a summary may legitimately have
+ * none), `encrypted` keeps the opaque payload verbatim, and no variant invents
+ * an `index` the wire did not carry.
+ */
+export type ReplayedReasoningDetail = {
+    readonly form: 'text';
+    readonly text: string;
+    readonly index?: number;
+} | {
+    readonly form: 'summary';
+    readonly summary: string;
+    readonly wireType?: string;
+    readonly index?: number;
+} | {
+    readonly form: 'encrypted';
+    readonly encrypted: string;
+    readonly wireType?: string;
+    readonly index?: number;
+};
+/**
+ * Reasoning of one assistant message, split by the wire shape it arrived in.
+ *
+ * `fields` holds text that belongs under a plain string field, `detailsString`
+ * is the older bare-string `reasoning_details` value (which must stay a
+ * string), and `details` holds array elements; `joined` is everything
+ * concatenated, which is what a message with no provenance still sends.
+ */
+export interface ReplayedReasoning {
+    /** Text per plain string field, in first-seen order. */
+    readonly fields: ReadonlyArray<{
+        readonly key: string;
+        readonly text: string;
+    }>;
+    /** The legacy bare-string `reasoning_details` value, when one was recorded. */
+    readonly detailsString?: string;
+    /** `reasoning_details` elements rebuilt from their provenance, in wire order. */
+    readonly details: ReadonlyArray<ReplayedReasoningDetail>;
+    /** Every reasoning block concatenated, used when no provenance survives. */
+    readonly joined: string;
 }
 /**
  * One complete tool definition, in the shape the function-calling wire wants.
@@ -337,6 +468,28 @@ export interface KimiCodeInBandStreamError {
     /** The provider's own diagnostic, without this mapper's prefix. */
     message: string;
 }
+/**
+ * One run of reasoning and how it arrived.
+ *
+ * Length, not text: the run describes where a slice of the block came from
+ * without storing the thinking twice, which keeps the persisted replay state
+ * small and keeps it a plain JSON value. An encrypted run has `length: 0` — it
+ * carries no visible text, only the opaque payload that must be handed back.
+ */
+export interface ReasoningRun {
+    /** Wire field the slice arrived under. */
+    readonly key: string;
+    /** Wire form, only meaningful when `key` is `reasoning_details`. */
+    readonly form?: ReasoningForm;
+    /** Element `type` exactly as received; absent when the element carried none. */
+    readonly wireType?: string;
+    /** Element index: the wire's own number, else the element's position. */
+    readonly index?: number;
+    /** Opaque encrypted provider state (`form: 'encrypted'`); never text. */
+    readonly encrypted?: string;
+    /** Length of the slice in the assembled block's text; 0 when there is none. */
+    readonly length: number;
+}
 export interface KimiCodeStreamState {
     wire: KimiCodeWire;
     blocks: OutboundContentBlock[];
@@ -345,6 +498,18 @@ export interface KimiCodeStreamState {
         type: 'text' | 'reasoning';
         text: string;
     } | null;
+    /**
+     * Which wire field the reasoning text of each block arrived under.
+     *
+     * One block can mix fields: a delta may carry `reasoning_content` and
+     * `reasoning` together, and consecutive deltas may alternate spellings without
+     * the block boundary moving. Each run records the key and the LENGTH of its
+     * slice rather than the slice itself, so the provenance never duplicates the
+     * thinking it describes and a replay can put every slice back under the field
+     * it came from. Keyed by block index and serialized by
+     * {@link reasoningReplayState}.
+     */
+    reasoningRuns: Map<number, ReasoningRun[]>;
     /** wire tool index -> accumulating call (OpenAI route). */
     toolCalls: Map<number, PendingToolCall>;
     /** anthropic content-block index -> our block index. */

package/lib/types/host/kimi-code/mapper.d.ts.map

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

package/lib/types/host/kimi-code/media-files.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Kimi Code hosted-file (media upload) client.
+ *
+ * WHY THIS FILE EXISTS. Everything this plugin has ever sent to the Kimi Code
+ * gateway carries media INLINE, as a `data:<type>;base64,...` URL
+ * (mapper.ts builds both the image and the video block that way). The gateway
+ * also accepts a hosted reference instead: upload the bytes once, cite
+ * `ms://<id>` afterwards. That is the only way to send a clip whose base64 would
+ * overrun the request body ceiling, and it is what this module implements.
+ *
+ * EVERY WIRE FACT BELOW WAS MEASURED live against the subscription gateway by
+ * `scripts/probe-kimi-files.probe.ts` on this line's own account and region,
+ * not copied from the official client:
+ *
+ * - the upload is `POST {coding base}/v1/files`, `multipart/form-data` with a
+ *   `file` part and a `purpose` part whose value is `image` or `video`
+ *   (note: NOT the `*_understanding` vocabulary the MiniMax line uses);
+ * - it authenticates with the bearer token plus the same `X-Msh-*` identity
+ *   headers every other request on this line sends;
+ * - the body answers with the id at the top level or nested under
+ *   `data`/`file`/`result`, and the reference a later chat body cites is
+ *   `ms://<id>`;
+ * - `content-type` is never set by hand: the runtime writes
+ *   `multipart/form-data; boundary=...` itself, and a hand-written JSON header
+ *   on a form body is a malformed request.
+ *
+ * DELIBERATELY NARROW. No adapter, mapper or route is touched here: this module
+ * only uploads, caches and returns a reference. Integration is a later change.
+ *
+ * @module dsh-chatgpt-subscription/kimi-media-files
+ */
+/** Upload route, relative to a base URL that may already carry `/v1`. */
+export declare const FILES_UPLOAD_PATH = "/v1/files";
+/** Scheme a stored id is cited by on the wire. */
+export declare const FILE_REF_SCHEME = "ms://";
+/**
+ * Ceiling on cached references.
+ *
+ * Bounded because a long conversation can attach many distinct clips and a
+ * process that lives for days must not grow one map per upload forever. 256 is
+ * far more than one conversation cites and small enough to be invisible.
+ */
+export declare const DEFAULT_MEDIA_FILE_CACHE_ENTRIES = 256;
+/** Time budget for one upload request. */
+export declare const MEDIA_UPLOAD_TIMEOUT_MS = 120000;
+/** The two purposes this surface measuredly accepts. */
+export type KimiMediaKind = 'image' | 'video';
+/** Why one upload could not produce a usable reference. */
+export type KimiMediaUploadFailure = 
+/** The request was unusable before anything was sent (media type, empty body, ...). */
+'invalid-request'
+/** The media type is not image/* or video/*, so there is no purpose to send. */
+ | 'unsupported-media'
+/** HTTP 401/403: the credential was not accepted. */
+ | 'unauthorized'
+/** HTTP 404/405: this base URL does not expose the upload route. */
+ | 'not-found'
+/** HTTP 413: the service refused the body as too large. */
+ | 'too-large'
+/** HTTP 5xx: the service failed; the same request may succeed later. */
+ | 'server'
+/** Any other non-2xx answer. */
+ | 'rejected'
+/** 2xx whose body was not JSON. */
+ | 'not-json'
+/** 2xx whose body carried no usable id. */
+ | 'no-id'
+/** The local time budget elapsed before the response arrived. */
+ | 'timeout'
+/** The request never completed (socket, DNS, TLS, ...). */
+ | 'network';
+/**
+ * One failed upload.
+ *
+ * Carries the HTTP status and a REDACTED digest of the response body so a
+ * caller can decide (401 -> sign in again, 5xx -> retry) without the raw body
+ * reaching a log. The access token is never placed in `message` or `detail`;
+ * see {@link redact}.
+ */
+export declare class KimiMediaUploadError extends Error {
+    readonly failure: KimiMediaUploadFailure;
+    readonly status: number | null;
+    /** Redacted one-line digest of the response body, or '' when there was none. */
+    readonly detail: string;
+    constructor(failure: KimiMediaUploadFailure, message: string, options?: {
+        status?: number | null;
+        detail?: string;
+    });
+}
+/** What one upload needs. */
+export interface KimiMediaUploadRequest {
+    /** Bearer token the caller obtained; never logged and never part of a key. */
+    readonly accessToken: string;
+    /** Coding API base, with or without a trailing slash and with or without `/v1`. */
+    readonly baseUrl: string;
+    /**
+     * Opaque, stable identifier of the ACCOUNT the bytes are uploaded under.
+     *
+     * It scopes the cache: an id minted for one account is never handed to
+     * another, because nothing here proves the gateway shares ids across accounts.
+     * It must identify the account (a user id, an account slot index) and must
+     * NEVER be the access token — {@link KimiMediaFilesUploader.upload} refuses
+     * that, so a token cannot end up inside a cache key by accident.
+     */
+    readonly accountScope: string;
+    /** Complete file bytes. */
+    readonly data: Uint8Array;
+    /** Media type, such as `image/png` or `video/mp4`. */
+    readonly mediaType: string;
+    /** Optional display name; only its leaf is used, and never as a path. */
+    readonly filename?: string;
+    /** Cancels this caller's wait, and the upload once nobody is waiting. */
+    readonly signal?: AbortSignal;
+}
+/** Everything a caller of this module may swap out, plus test seams. */
+export interface KimiMediaUploadOptions {
+    /** Transport; defaults to the global `fetch`. */
+    readonly fetchFn?: typeof fetch;
+    /** Cache ceiling; defaults to {@link DEFAULT_MEDIA_FILE_CACHE_ENTRIES}. */
+    readonly maxCacheEntries?: number;
+    /** Per-request time budget; 0 (or a negative value) disables it. */
+    readonly timeoutMs?: number;
+}
+/**
+ * The upload URL for one coding base.
+ *
+ * The base this line resolves normally carries neither a version nor a trailing
+ * slash (`https://api.kimi.com/coding`), so the measured route is built by
+ * appending `/v1/files` and the answer is `.../coding/v1/files`. A caller that
+ * passes a base which ALREADY ends in `/v1` — the official client's own
+ * KIMI_CODE_BASE_URL shape — gets the prefix removed once rather than doubled:
+ * `.../coding/v1/v1/files` is a 404 that reads like a missing route.
+ */
+export declare function filesUploadUrl(baseUrl: string): string;
+/** The upload purpose one media type maps to, or undefined when unsupported. */
+export declare function mediaKindFor(mediaType: string): KimiMediaKind | undefined;
+/** The wire reference for a stored id. */
+export declare function fileReference(id: string): string;
+/**
+ * The cache key for one upload.
+ *
+ * Five things, and each of them is load-bearing:
+ *
+ * - ACCOUNT SCOPE, because an id minted for one account is never assumed to be
+ *   readable by another (see {@link KimiMediaUploadRequest.accountScope});
+ * - BASE URL (normalized through {@link filesUploadUrl}, so a trailing slash
+ *   cannot split one endpoint into two slots), because two regions or two
+ *   deployments are two distinct file stores;
+ * - MEDIA KIND and MEDIA TYPE, because the same bytes uploaded as an image and
+ *   as a video are two different resources as far as the purpose is concerned;
+ * - CONTENT SHA-256, so identical bytes reuse one upload and any change at all
+ *   misses the cache.
+ *
+ * The access token is NOT part of it: a key is written to memory only, but a
+ * token in a key is a token in the next dump, and the account is already
+ * identified by its scope. `|` cannot appear in a scope because the scope is
+ * sanitized here.
+ */
+export declare function mediaFileCacheKey(input: {
+    accountScope: string;
+    baseUrl: string;
+    mediaType: string;
+    data: Uint8Array;
+}): string;
+/**
+ * Uploads one media file per distinct key, caching and single-flighting them.
+ *
+ * Two behaviours are deliberate and easy to get wrong:
+ *
+ * 1. SINGLE FLIGHT. Concurrent callers with the same key share one request.
+ *    A caller that aborts stops waiting immediately and gets an AbortError, but
+ *    the shared request is only cancelled once NO caller is still waiting — so
+ *    one cancelled turn does not fail another turn that wants the same clip.
+ * 2. NO TTL. A successful reference is cached until it is evicted by the LRU
+ *    ceiling. Inventing an expiry would either expire a live id (a failed turn)
+ *    or outlive it silently; nothing here measured a lifetime, so nothing here
+ *    pretends to know one. A reference the service later rejects is dropped with
+ *    {@link forget} by whoever sees that rejection.
+ */
+export declare class KimiMediaFilesUploader {
+    private readonly fetchFn;
+    private readonly maxCacheEntries;
+    private readonly timeoutMs;
+    /** key -> `ms://<id>`, in least-recently-used order. */
+    private readonly cache;
+    private readonly flights;
+    constructor(options?: KimiMediaUploadOptions);
+    /** Cached references currently held, for a settings surface or a test. */
+    get size(): number;
+    /** Uploads one file and returns the `ms://<id>` reference a request cites. */
+    upload(request: KimiMediaUploadRequest): Promise<string>;
+    /**
+     * Drop the reference one upload would use.
+     *
+     * The caller that sees a stored id REJECTED on the wire calls this so the next
+     * attempt uploads again instead of replaying the same dead reference.
+     */
+    forget(request: Omit<KimiMediaUploadRequest, 'accessToken'>): boolean;
+    /** Forget everything; a sign-out or a test starting over. */
+    clear(): void;
+    /** Validate and normalize one request, or throw before anything is sent. */
+    private resolve;
+    private readCache;
+    private writeCache;
+    /** Open one flight and run it; the map entry is dropped as it settles. */
+    private startFlight;
+    /**
+     * Wait for one flight, respecting THIS caller's abort.
+     *
+     * The flight is not bound to the caller's signal: a caller that aborts
+     * detaches, and the transport is cancelled only when the last waiter has gone.
+     */
+    private join;
+    /** The one request a flight performs. */
+    private performUpload;
+    /** Turn a transport rejection into the error the caller must see. */
+    private transportFailure;
+    /** Read one response into a reference, or into a typed failure. */
+    private settle;
+}
+/** One uploader with the default transport and cache size. */
+export declare function createMediaFilesUploader(options?: KimiMediaUploadOptions): KimiMediaFilesUploader;
+/**
+ * The process-wide uploader the adapter will use.
+ *
+ * Shared on purpose: the cache is the whole point, and a per-call instance would
+ * upload the same clip once per turn.
+ */
+export declare const kimiMediaFiles: KimiMediaFilesUploader;
+/** Upload one file through the shared uploader. */
+export declare function uploadMediaFile(request: KimiMediaUploadRequest): Promise<string>;
+//# sourceMappingURL=media-files.d.ts.map

package/lib/types/host/kimi-code/media-files.d.ts.map

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

package/lib/types/host/kimi-code/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/host/kimi-code/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,OAAO,EAEL,WAAW,EACX,aAAa,EAId,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EAEtB,KAAK,oBAAoB,EAGzB,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAevD,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,qCAAqC,CAAA;AAwD5C;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,OAAO,UAAO,GACb,MAAM,EAAE,CAUV;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;IACnC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAA;IAChD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAMD,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,sBAAsB,EACrC,WAAW,CAAC,EAAE,uBAAuB,EACrC,OAAO,GAAE,qBAA0B,EACnC,WAAW,GAAE,mBAAmB,GAAG,SAA+B,GACjE,OAAO,CAAC,iBAAiB,CAAC,CA4E5B;AAmDD,qEAAqE;AACrE,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,sBAAsB,EACrC,WAAW,CAAC,EAAE,uBAAuB,EACrC,OAAO,GAAE,qBAA0B,EACnC,WAAW,GAAE,mBAAmB,GAAG,SAA+B,GACjE,MAAM,IAAI,CA0UZ;AAED,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAA"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/host/kimi-code/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,OAAO,EAEL,WAAW,EACX,aAAa,EAId,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EAEtB,KAAK,oBAAoB,EAGzB,KAAK,uBAAuB,EAC7B,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAgBvD,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,qCAAqC,CAAA;AAwD5C;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,OAAO,UAAO,GACb,MAAM,EAAE,CAUV;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;IACtB,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,CAAA;IACnC,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAA;IAChD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAA;IACjC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CACpC;AAMD,mFAAmF;AACnF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,sBAAsB,EACrC,WAAW,CAAC,EAAE,uBAAuB,EACrC,OAAO,GAAE,qBAA0B,EACnC,WAAW,GAAE,mBAAmB,GAAG,SAA+B,GACjE,OAAO,CAAC,iBAAiB,CAAC,CA4E5B;AAoHD,qEAAqE;AACrE,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,EAC1B,aAAa,EAAE,sBAAsB,EACrC,WAAW,CAAC,EAAE,uBAAuB,EACrC,OAAO,GAAE,qBAA0B,EACnC,WAAW,GAAE,mBAAmB,GAAG,SAA+B,GACjE,MAAM,IAAI,CA0UZ;AAED,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,CAAA"}

package/lib/types/host/kimi-code/session-cache-state.d.ts

@@ -0,0 +1,140 @@
+/**
+ * Durable per-session cache state for the Kimi route.
+ *
+ * Kimi's prefix cache lives on the service, but everything a status card needs
+ * to describe it - when this conversation last ran, how large its prompt is, and
+ * why the last request's prefix broke - used to live in process memory only. A
+ * restart therefore erased the one fact the expiry hint depends on, exactly when
+ * the user resumes a task and pays for the whole prompt again: the card showed
+ * an empty state instead of "this conversation sat idle past the cache lifetime".
+ *
+ * This module keeps that state on disk, in the same storages directory the
+ * preferences store uses, so the hint and the attribution survive a restart.
+ * It is a diagnostic: nothing here changes a request.
+ * @module dsh-chatgpt-subscription/kimi-code-session-cache-state
+ */
+/**
+ * Conversations kept in the document.
+ *
+ * The hint only ever describes a conversation that ran recently, so an install
+ * that opens hundreds of sessions does not need all of them on disk. Old entries
+ * are dropped by {@link SessionCacheStateStore.write} in updatedAt order, which
+ * is the same order the "most recent conversation" fallback reads.
+ */
+export declare const MAX_SESSION_RECORDS = 64;
+/** One conversation's cache state, as it survives the process. */
+export interface KimiCodeSessionCacheRecord {
+    /** When this conversation last sent a request, epoch ms. */
+    lastActiveAt: number;
+    /**
+     * Prompt tokens of the most recent request (cache read + fresh input).
+     *
+     * The LAST request, not the rolling total: the expiry hint is about how much
+     * the next turn will have to reprocess, and summing every turn of a long
+     * conversation would overstate that by an order of magnitude.
+     */
+    totalTokens: number;
+    /** Rolling totals for the card, mirroring the mapper's per-session stats. */
+    requests: number;
+    cachedTokens: number;
+    freshTokens: number;
+    outputTokens: number;
+    cacheWriteTokens: number;
+    cacheWrite5mTokens: number;
+    cacheWrite1hTokens: number;
+    /** Cause attributed to the most recent request's prefix break, when there was one. */
+    lastDrift?: string;
+    /** When any field above last changed, epoch ms. Used for pruning and ordering. */
+    updatedAt: number;
+}
+/** Where the document lives; beside the other plugin-owned JSON. */
+export declare function sessionCacheStatePath(): string;
+/**
+ * Per-session cache state held in one JSON document.
+ *
+ * Reads are synchronous because every caller is answering a status request or
+ * closing a turn, both of which are allowed to block on a file this size. Writes
+ * are debounced: a turn reports once, and several turns in flight must not
+ * rewrite the document several times.
+ */
+export declare class SessionCacheStateStore {
+    private document;
+    private pending;
+    /**
+     * @param filePath - Document location; defaults to {@link sessionCacheStatePath}.
+     * @param maxEntries - Conversations kept; the oldest are dropped first.
+     */
+    private readonly filePath;
+    private readonly maxEntries;
+    /**
+     * Whether this store may write at all.
+     *
+     * A store built on an explicit path is someone's own file - a test's temporary
+     * document - and always writes. The default-path store belongs to the user's
+     * harness home, and a test that never named a path must not overwrite it.
+     */
+    private readonly allowWrite;
+    constructor(filePath?: string, maxEntries?: number);
+    /**
+     * The record for one conversation, or the most recently active one.
+     *
+     * The fallback is what makes the status card useful without a session named:
+     * the card describes the line, and the only conversation it can honestly
+     * describe in that case is the one that ran last.
+     * @param sessionId - Conversation to read; omit for the most recent one.
+     * @returns the record, or undefined when nothing has ever been recorded.
+     */
+    read(sessionId?: string): KimiCodeSessionCacheRecord | undefined;
+    /**
+     * File one conversation's state and schedule the document write.
+     * @param sessionId - Conversation the record belongs to; ignored when blank.
+     * @param record - Complete record for that conversation.
+     */
+    write(sessionId: string, record: KimiCodeSessionCacheRecord): void;
+    /**
+     * Write the document now, synchronously.
+     *
+     * Exposed for tests and for a caller that is about to lose the process; the
+     * debounced path is what normal turns use.
+     */
+    flush(): void;
+    /** Drop everything older than the newest maxEntries conversations. */
+    private prune;
+    /** Read the document once; a missing or corrupt file reads as empty. */
+    private load;
+    /** Coalesce the writes one turn's several fields would otherwise cause. */
+    private schedule;
+    private cancelPending;
+    /** Write through a temporary file so a crash cannot leave half a document. */
+    private persist;
+}
+/** What the running process knows about one conversation, before any disk read. */
+export interface SessionCacheViewInput {
+    /** Last activity the process remembers, if the conversation ran in it. */
+    memoryLastActiveAt?: number;
+    /** Prompt tokens the process has seen for this conversation; 0 when none. */
+    memoryTotalTokens: number;
+}
+/**
+ * Combine process memory with the durable record into the hint's two inputs.
+ *
+ * The process supplies the idle baseline whenever it has served the conversation,
+ * because only it knows about the turn that just ended. The prompt size comes
+ * from the file when it has one: the record is rewritten at every turn close, so
+ * it holds the LAST request's size, while the process only offers a sum across
+ * every turn of the conversation - which can overstate the next turn's cost by
+ * an order of magnitude. With no conversation named the file is the only source,
+ * because a process aggregate spans several conversations and would make "this
+ * conversation's prompt" a number no single conversation has.
+ * @param sessionId - Conversation being described; omit for "the most recent".
+ * @param memory - What this process knows about it.
+ * @param durable - What the last run on this machine left behind.
+ * @returns the idle baseline and prompt size the expiry rule needs.
+ */
+export declare function resolveSessionCacheView(sessionId: string | undefined, memory: SessionCacheViewInput, durable: KimiCodeSessionCacheRecord | undefined): {
+    lastActiveAt?: number;
+    totalTokens: number;
+};
+/** The process-wide store the adapter writes and the routes read. */
+export declare const sessionCacheState: SessionCacheStateStore;
+//# sourceMappingURL=session-cache-state.d.ts.map