@eddyskywalker/dsh-chatgpt-subscription 0.11.7 → 0.12.2

package/lib/types/host/common/request-images.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Image resolution, byte budgeting and data-URL handling for one request.
+ *
+ * Shared by the provider lines that send inline images, because the budget is a
+ * property of the deployment rather than of any one endpoint, and because two
+ * lines that budget differently send different request bytes for the same picture.
+ *
+ * The notable decision is SCALE, not drop: see {@link resolveRequestImages}.
+ *
+ * @module dsh-chatgpt-subscription/request-images
+ */
+import type { GenerateOptions } from "./llm-compat.ts";
+import type { AttachmentStore, ImageAttachmentRef } from "@deepseek-ai/dsh-attachment";
+/**
+ * Attachment seam this route needs: verified bytes for one durable image, and a
+ * downscaled request version of one that does not fit the image budget.
+ *
+ * Every harness generation in the peer range declares readImageRequest; a
+ * backend that cannot derive request versions rejects the call, and that
+ * rejection is handled like any other unreadable image.
+ */
+export type AttachmentImageReader = Pick<AttachmentStore, 'readImage' | 'readImageRequest'>;
+/** One durable user image resolved for an in-flight request, or proven unreadable. */
+export type ResolvedRequestImage = {
+    readonly kind: 'inline';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    readonly kind: 'unavailable';
+};
+/** Resolved images keyed by durable attachment id; consumed by one request build. */
+export type ResolvedRequestImages = ReadonlyMap<string, ResolvedRequestImage>;
+export declare const NO_RESOLVED_IMAGES: ResolvedRequestImages;
+/**
+ * Base64 image payload one request may carry.
+ *
+ * Kimi rejects a request whose total message size exceeds 2 MB with a 400, and
+ * the image bytes share that budget with the conversation text, tool schemas,
+ * and system prompt — so the bound is deliberately the smaller of the two
+ * documented limits rather than the largest body the transport would accept.
+ */
+export declare const MAX_REQUEST_IMAGE_BYTES = 1500000;
+/** Message-body ceiling the service documents for one request. */
+export declare const MAX_MESSAGE_BODY_BYTES = 2097152;
+/**
+ * Body ceiling once a request carries video.
+ *
+ * The 2 MB figure above is the documented limit for text and images, and it is
+ * far too small for video: a single frame-sequence clip dwarfs it. Kimi's own
+ * video guidance carries a separate, much larger request budget, so the ceiling
+ * is raised only for a request that actually attaches video. A text-only or
+ * image-only request keeps the tighter guard, because catching that 400 locally
+ * is the whole reason it exists.
+ */
+export declare const MAX_VIDEO_MESSAGE_BODY_BYTES: number;
+/**
+ * Base64 video budget for one request.
+ *
+ * Deliberately below {@link MAX_VIDEO_MESSAGE_BODY_BYTES} so the surrounding
+ * JSON envelope, tool schemas and text still fit; the oldest clips are dropped
+ * first once the total would exceed it.
+ */
+export declare const MAX_REQUEST_VIDEO_BYTES: number;
+/** Media types both upstream wires accept as inline base64. */
+export declare const SUPPORTED_IMAGE_MEDIA_TYPES: Set<string>;
+export declare function attachmentLabel(block: Record<string, unknown>): string | undefined;
+/**
+ * Longest edge any image of this request may keep.
+ *
+ * Kimi's own client compresses an oversized image down to roughly 2 MB of raw
+ * bytes before it sends it, and this route has to fit every image of one request
+ * inside a far smaller shared budget. Screening on the long edge rather than on
+ * the encoded size is what makes the decision stable: it reads only the
+ * attachment's own dimensions, so the same image yields the same target in every
+ * later turn and the cached prefix survives.
+ */
+export declare const REQUEST_IMAGE_MAX_EDGE = 1024;
+/**
+ * Request-version target for one stored image whose long edge is over the
+ * ceiling, or undefined when it fits and is sent as stored.
+ *
+ * A reference without usable dimensions is sent as stored: there is no basis
+ * for choosing a target, and the budget fallback still applies to it.
+ */
+export declare function requestImageTarget(ref: ImageAttachmentRef, edge?: number): {
+    width: number;
+    height: number;
+    maxBytes: number;
+} | undefined;
+/**
+ * Replace the oldest inline images with a text placeholder once one request
+ * would carry more than `maxBytes` of base64 image data.
+ *
+ * The MECHANISM is shared because it is generic: measure the retained
+ * occurrences' encoded length, drop oldest-first, leave durable history alone.
+ * The BUDGET is not, and it is a parameter for exactly that reason — an
+ * image budget is a property of the upstream gateway, and importing one route's
+ * number into another refuses that other route's own legal images. The default
+ * is Kimi's, so every existing call site is byte-for-byte unchanged; a route
+ * with a different ceiling passes its own.
+ *
+ * Durable history is untouched; only the request about to be sent changes.
+ */
+export declare function offloadOldestRequestImages(options: GenerateOptions, maxBytes?: number): GenerateOptions;
+/**
+ * Read every durable `{ type: 'image', attachment }` block one request carries.
+ * An unreadable image resolves to `unavailable` rather than disappearing, so
+ * the model is told the picture is missing instead of answering about a blank.
+ *
+ * An image whose long edge is over {@link REQUEST_IMAGE_MAX_EDGE} is sent as the
+ * harness's downscaled request version (see {@link requestImageTarget}). The
+ * stored image and durable history do not change, and an image that already
+ * fits is sent byte-for-byte as stored.
+ *
+ * WHY scale instead of drop. `offloadOldestRequestImages` has to drop an image
+ * once the request exceeds `MAX_REQUEST_IMAGE_BYTES`, and the number it drops
+ * grows with every later image. Each change rewrites the retained prefix, so the
+ * prompt cache is invalidated again on the very next turn. Scaling keeps the
+ * image COUNT stable, which is what preserves that prefix: a conversation that
+ * outgrew the budget once stays inside it instead of breaking the cache every
+ * time an image is added.
+ */
+export declare function resolveRequestImages(options: GenerateOptions, attachments: AttachmentImageReader | undefined, signal?: AbortSignal): Promise<ResolvedRequestImages>;
+export declare function unavailableImageText(block: Record<string, unknown>): string;
+export interface InlineImage {
+    mediaType: string;
+    data: string;
+}
+export declare function imageBlockToInline(block: Record<string, unknown>, images: ResolvedRequestImages): InlineImage | undefined;
+//# sourceMappingURL=request-images.d.ts.map

package/lib/types/host/common/request-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-images.d.ts","sourceRoot":"","sources":["../../../../src/host/common/request-images.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAuBtF;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,eAAe,EAAE,WAAW,GAAG,kBAAkB,CAAC,CAAA;AAE3F,sFAAsF;AACtF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAA;AAEpC,qFAAqF;AACrF,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAE7E,eAAO,MAAM,kBAAkB,EAAE,qBAAiC,CAAA;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,UAAY,CAAA;AAEhD,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,UAAY,CAAA;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,QAAmB,CAAA;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,QAAmB,CAAA;AAMvD,+DAA+D;AAC/D,eAAO,MAAM,2BAA2B,aAAkE,CAAA;AAQ1G,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAGlF;AAsCD;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,OAAO,CAAA;AAe1C;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,kBAAkB,EACvB,IAAI,GAAE,MAA+B,GACpC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAOjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,QAAQ,GAAE,MAAgC,GACzC,eAAe,CA4BjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CAgChC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAI3E;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,qBAAqB,GAAG,WAAW,GAAG,SAAS,CAuBzH"}

package/lib/types/host/common/tool-schema.d.ts

@@ -0,0 +1,27 @@
+/**
+ * JSON-Schema normalization for tool parameter schemas.
+ *
+ * Provider gateways reject or ignore parts of a JSON Schema that a TypeBox/Zod-style
+ * schema carries, and a few keywords arrive unresolved. This module is shared
+ * because several provider lines send the same normalized shape and the
+ * normalization is behaviour, not preference: two lines that normalize
+ * differently send different request bytes for the same tool.
+ *
+ * The work is:
+ *
+ * - drop the meta keywords ($schema) a gateway ignores;
+ * - INLINE $defs / definitions / $ref, so no reference survives to the wire;
+ * - give enum and const nodes an explicit type, which some gateways require;
+ * - walk the whole tree, with cycle detection so a self-referential schema
+ *   terminates instead of recursing forever.
+ *
+ * @module dsh-chatgpt-subscription/tool-schema
+ */
+/**
+ * Normalizes tool parameter schemas for Kimi by stripping meta keywords ($schema),
+ * inlining definitions ($defs/definitions/$ref), and ensuring property types for enums/consts.
+ */
+export declare function normalizeKimiToolSchema(schema: unknown): Record<string, unknown>;
+/** Drop the JSON-Schema keywords provider gateways reject or ignore, and normalize properties. */
+export declare function stripMetaSchema(schema: unknown): Record<string, unknown>;
+//# sourceMappingURL=tool-schema.d.ts.map

package/lib/types/host/common/tool-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-schema.d.ts","sourceRoot":"","sources":["../../../../src/host/common/tool-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAoIH;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYhF;AAED,kGAAkG;AAClG,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAExE"}

package/lib/types/host/common/video-request.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Request-side machinery for video input, shared by every line that accepts it.
+ *
+ * Everything here walks ContentBlocks and base64-encodes bytes; none of it knows
+ * which provider it is serving. A line contributes the two things that DO differ:
+ * the wording for a video it cannot send, and the byte budget its endpoint
+ * tolerates.
+ *
+ * @module dsh-chatgpt-subscription/video-request
+ */
+import type { GenerateOptions } from './llm-compat.ts';
+import { type VideoAttachmentRef, type VideoOmissionText } from './video.ts';
+/**
+ * One durable video resolved for an in-flight request, or proven unreadable.
+ *
+ * The shape mirrors the image counterpart so the two media kinds travel the
+ * same path and differ only in the wire part each produces.
+ */
+export type ResolvedRequestVideo = {
+    readonly kind: 'inline';
+    readonly mediaType: string;
+    readonly data: string;
+} | {
+    readonly kind: 'unavailable';
+};
+/** Resolved videos keyed by attachment id; consumed by one request build. */
+export type ResolvedRequestVideos = ReadonlyMap<string, ResolvedRequestVideo>;
+/**
+ * Attachment seam for video bytes.
+ *
+ * DSH's own attachment service stores images only, so a video reference can
+ * only exist if some producer in this deployment created it. Rather than
+ * pretend otherwise, the reader is an injected seam: absent means every video
+ * resolves to `unavailable` and the model is told the clip is missing, which is
+ * strictly better than silently sending a request with no video at all.
+ */
+export type AttachmentVideoReader = {
+    readVideo(ref: VideoAttachmentRef, signal?: AbortSignal): Promise<{
+        data: Uint8Array;
+        mediaType: string;
+    }>;
+};
+/**
+ * Read every durable `{ type: 'video', attachment }` block one request carries.
+ *
+ * An unreadable clip resolves to `unavailable` rather than disappearing, so the
+ * model is told the video is missing instead of answering about a blank.
+ */
+export declare function resolveRequestVideos(options: GenerateOptions, attachments: AttachmentVideoReader | undefined, signal?: AbortSignal): Promise<ResolvedRequestVideos>;
+/** True when the request carries any video occurrence at all. */
+export declare function requestHasVideo(options: GenerateOptions): boolean;
+/**
+ * Drop the oldest videos once one request would exceed `maxBytes` of base64
+ * video data, replacing each with a text placeholder.
+ *
+ * Durable history is untouched; only the request about to be sent changes.
+ * Images are left alone — they have their own, much smaller budget and their own
+ * offload pass.
+ *
+ * @param maxBytes - the endpoint's base64 video budget.
+ */
+export declare function offloadOldestRequestVideos(options: GenerateOptions, maxBytes: number): GenerateOptions;
+/** One video block resolved for the wire, or the reason it cannot be sent. */
+export type ResolvedVideoBlock = {
+    readonly inline: {
+        readonly mediaType: string;
+        readonly data: string;
+    };
+} | {
+    readonly omission: string;
+};
+/**
+ * Resolve one video block for the wire, or explain why it cannot be sent.
+ *
+ * @param block - the durable video occurrence.
+ * @param videos - videos read for this request.
+ * @param videoAccepted - whether the selected model declares video input.
+ * @param omit - the line's wording for a video it cannot send.
+ */
+export declare function videoBlockToInline(block: Record<string, unknown>, videos: ResolvedRequestVideos, videoAccepted: boolean, omit: VideoOmissionText): ResolvedVideoBlock;
+//# sourceMappingURL=video-request.d.ts.map

package/lib/types/host/common/video-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-request.d.ts","sourceRoot":"","sources":["../../../../src/host/common/video-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACpE,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,YAAY,CAAA;AAyCnB;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAAA;AAEpC,6EAA6E;AAC7E,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;AAI7E;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3G,CAAA;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,qBAAqB,GAAG,SAAS,EAC9C,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,qBAAqB,CAAC,CA0BhC;AASD,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAGjE;AAWD;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,QAAQ,EAAE,MAAM,GACf,eAAe,CA4BjB;AAED,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjC;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,qBAAqB,EAC7B,aAAa,EAAE,OAAO,EACtB,IAAI,EAAE,iBAAiB,GACtB,kBAAkB,CAwBpB"}

package/lib/types/host/common/video.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Video input, shared by every line in this plugin that accepts it.
+ *
+ * DSH ships ModelModalityMap = { text, image } and a ContentBlockMap with no
+ * video entry, but both are merge-extensible interfaces. This module performs
+ * that widening ONCE, in the plugin's own compilation unit, so the video
+ * capability travels through DSH's real pipeline - the one that gates prompt
+ * admission, the model picker and subagent delegation - rather than living in
+ * a tooltip. Two providers now declare video (Kimi Code and MiniMax Code), and
+ * a second augmentation of the same key would be a conflicting redeclaration,
+ * so the vocabulary has to be shared rather than copied per line.
+ *
+ * Nothing here is provider-specific. A line supplies the wording for a video it
+ * cannot send (see {@link VideoOmissionText}) and the media types its endpoint
+ * accepts, and inherits the traversal, byte budgeting and base64 encoding.
+ *
+ * @module dsh-chatgpt-subscription/video
+ */
+/**
+ * Container formats the coding endpoints accept as video input.
+ *
+ * The services validate the media type, so an unlisted container is reported
+ * before it is base64-expanded into a request that would be rejected.
+ */
+export declare const VIDEO_MEDIA_TYPES: readonly string[];
+/** Runtime membership test for one video container. */
+export declare function isVideoMediaType(mediaType: string): boolean;
+/**
+ * One durable video reference carried by a request.
+ *
+ * attachmentId is a plain string rather than DSH's branded AttachmentId: no
+ * DSH service issues this identifier, so branding it would imply an origin that
+ * does not exist. The field name matches ImageAttachmentRef so one traversal
+ * helper can walk both block kinds.
+ */
+export interface VideoAttachmentRef {
+    attachmentId: string;
+    /** Verified media type, for example video/mp4. */
+    mediaType: string;
+    /** Exact encoded byte length. */
+    bytes: number;
+    /** Intrinsic duration in milliseconds, when the producer knows it. */
+    durationMs?: number;
+    /** Optional display name, stripped of any local path. */
+    name?: string;
+}
+/** One video occurrence in message content. */
+export interface VideoBlock {
+    type: 'video';
+    attachment: VideoAttachmentRef;
+}
+declare module '@deepseek-ai/dsh-llm' {
+    interface ModelModalityMap {
+        /** Widened by this plugin for the providers that accept video. */
+        video: 'video';
+    }
+    interface ContentBlockMap {
+        /** Widened by this plugin; only this package's request mappers read it. */
+        video: VideoBlock;
+    }
+}
+/** Base64 length of raw bytes, including padding. */
+export declare function base64LengthOf(bytes: number): number;
+/** Canonical data URL an inline video part carries. */
+export declare function videoDataUrl(mediaType: string, base64: string): string;
+/**
+ * Human-readable byte size for a refusal message.
+ * @param bytes - exact encoded byte length.
+ */
+export declare function formatMediaBytes(bytes: number): string;
+/** Why one video occurrence was replaced by text instead of being sent. */
+export type VideoOmissionReason = 'unsupported-model' | 'unreadable' | 'unsupported-container'
+/** The selected protocol has no documented video part, so none is sent. */
+ | 'unsupported-wire';
+/**
+ * A line's own wording for a video it cannot send.
+ *
+ * A function rather than a fixed string because the actionable half differs per
+ * provider: the models that DO take video, and whether the selected wire has a
+ * video part at all, are different answers on different routes.
+ */
+export type VideoOmissionText = (reason: VideoOmissionReason, label?: string) => string;
+/** Attachment id or display name for one block, whichever is present. */
+export declare function videoBlockLabel(block: {
+    attachment?: {
+        name?: string;
+        attachmentId?: string;
+    };
+}): string | undefined;
+//# sourceMappingURL=video.d.ts.map

package/lib/types/host/common/video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.d.ts","sourceRoot":"","sources":["../../../../src/host/common/video.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAU9C,CAAA;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAA;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAA;IACb,UAAU,EAAE,kBAAkB,CAAA;CAC/B;AAED,OAAO,QAAQ,sBAAsB,CAAC;IACpC,UAAU,gBAAgB;QACxB,kEAAkE;QAClE,KAAK,EAAE,OAAO,CAAA;KACf;IAED,UAAU,eAAe;QACvB,2EAA2E;QAC3E,KAAK,EAAE,UAAU,CAAA;KAClB;CACF;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAItD;AAED,2EAA2E;AAC3E,MAAM,MAAM,mBAAmB,GAC3B,mBAAmB,GACnB,YAAY,GACZ,uBAAuB;AACzB,2EAA2E;GACzE,kBAAkB,CAAA;AAEtB;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;AAEvF,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAIpH"}

package/lib/types/host/fetch-address-policy.d.ts

@@ -14,7 +14,8 @@
  * proxy on this machine must not become a path into loopback or a LAN — and it
  * also refuses a name this machine resolves into private space. Only the proxy's
  * own fake-ip answers are accepted, since that is what the proxy's name
- * resolution looks like from here; the URL hostname still reaches the proxy
+ * resolution looks like from here: the IPv4 one, and the IPv6 one only beside it
+ * (see assertPublicFetchTarget). The URL hostname still reaches the proxy
  * intact, so the proxy decides where the name really goes.
  *
  * @module dsh-chatgpt-subscription/fetch-address-policy

package/lib/types/host/fetch-address-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-address-policy.d.ts","sourceRoot":"","sources":["../../../src/host/fetch-address-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAkCH;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAOtF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAQ5F"}
+{"version":3,"file":"fetch-address-policy.d.ts","sourceRoot":"","sources":["../../../src/host/fetch-address-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAkCH;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAOtF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAe5F"}

package/lib/types/host/fetch-configuration.d.ts

@@ -0,0 +1,6 @@
+import type { FetchConfigurationDto } from '../shared/contracts.ts';
+export declare const DEFAULT_FETCH_MAX_BODY_CHARS = 100000;
+export declare const DEFAULT_FETCH_MAX_RESPONSE_BYTES: number;
+export declare function positiveFetchLimit(value: number | undefined, fallback: number, name: string): number;
+export declare function resolveFetchConfiguration(config: Partial<FetchConfigurationDto>): FetchConfigurationDto;
+//# sourceMappingURL=fetch-configuration.d.ts.map

package/lib/types/host/fetch-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-configuration.d.ts","sourceRoot":"","sources":["../../../src/host/fetch-configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAEnE,eAAO,MAAM,4BAA4B,SAAU,CAAA;AACnD,eAAO,MAAM,gCAAgC,QAAkB,CAAA;AAE/D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIpG;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAUvG"}

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

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

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

@@ -0,0 +1,76 @@
+/**
+ * When it is worth telling the user their prompt cache has gone cold.
+ *
+ * Kimi's cache is automatic and content-hash based, so a client gets no marker
+ * that it is no longer being reused — the only evidence is the read ratio in
+ * the usage stream. A conversation that sat idle past the cache TTL pays the
+ * full prompt again on its next turn, and it is large enough on a real
+ * codebase to be worth a sentence.
+ *
+ * The trigger mirrors the official client's: idle beyond the tier's lifetime
+ * AND a context large enough that reprocessing it actually costs something.
+ * The upstream rules arrive from a remote config that a private deployment
+ * cannot reach, so the thresholds here are the documented defaults; the
+ * decision function itself is written to take them, so swapping the source
+ * later changes only where the numbers come from.
+ */
+import type { KimiCodeCacheTtl } from '../../shared/kimi-code-contracts.ts';
+/**
+ * How long an entry written at each tier survives.
+ *
+ * The tier is LOCKED when the prefix is first written, so this is the lifetime
+ * of the entry a request actually created rather than of the tier as a name.
+ */
+export declare const CACHE_TTL_MS: Record<KimiCodeCacheTtl, number>;
+/**
+ * Context below which a cold cache is not worth mentioning.
+ *
+ * Reprocessing a few thousand tokens is invisible; reprocessing a few hundred
+ * thousand is the difference between an instant and a visible pause, and
+ * telling someone about the former trains them to ignore the notice.
+ */
+export declare const MIN_TOKENS_TO_HINT = 100000;
+/**
+ * Note that a session just did something.
+ *
+ * Called on every turn, so the timestamp answers how long since this
+ * conversation last ran, which is what decides whether its cache entry can
+ * still be alive.
+ */
+export declare function markSessionActive(sessionId: string | undefined, now?: number): void;
+/** When a session last did something, or undefined when it never has. */
+export declare function sessionLastActiveAt(sessionId: string | undefined): number | undefined;
+/** Forget one session's activity, or all of it. Test seam and teardown. */
+export declare function resetSessionActivity(sessionId?: string): void;
+export interface CacheHintInput {
+    /** Current time, epoch ms. */
+    readonly now: number;
+    /**
+     * When the conversation last did anything, epoch ms.
+     *
+     * Absent means nothing is known, and the hint is skipped: a client that
+     * cannot say how long the session was idle cannot claim the entry expired.
+     */
+    readonly lastActiveAt?: number;
+    /** Context currently loaded, in tokens. Absent means no local estimate. */
+    readonly totalTokens?: number;
+    /** Tier the conversation's entries were written at. */
+    readonly cacheTtl?: KimiCodeCacheTtl | null;
+}
+export type CacheHintDecision = {
+    readonly kind: 'skip';
+} | {
+    readonly kind: 'hint';
+    readonly idleMs: number;
+    readonly totalTokens: number;
+};
+/**
+ * Whether one conversation should be warned about a cold cache.
+ *
+ * Every missing-data branch skips. That asymmetry is deliberate and matches
+ * the official client: a false negative costs one turn nobody noticed, while a
+ * false positive teaches the user the notice is noise and stops them reading
+ * the one that mattered.
+ */
+export declare function evaluateCacheHint(input: CacheHintInput): CacheHintDecision;
+//# sourceMappingURL=cache-hint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-hint.d.ts","sourceRoot":"","sources":["../../../../src/host/kimi-code/cache-hint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAE3E;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAGzD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,SAAU,CAAA;AAiBzC;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,GAAE,MAAmB,GAAG,IAAI,CAS/F;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGrF;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM7D;AAED,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;CAC5C;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpF;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CAY1E"}

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

@@ -76,8 +76,43 @@ export declare function rememberCatalogCredential(region: KimiCodeRegion, access
 export declare function clearCatalogCredentials(): void;
 /** Choose the wire dialect for one model, from the live catalog when it says. */
 export declare function wireForCatalogEntry(modelId: string, catalog: readonly KimiCodeCatalogModel[]): KimiCodeWire;
-/** Thinking levels for one model, from the catalog when it declares them. */
+/**
+ * Thinking levels for one model, from the catalog when it declares them.
+ *
+ * `supports_thinking_type` is applied last because it is the field that can
+ * invalidate the effort list itself. A model that declares `only` reasons at
+ * every level, so offering `none` asks for a turn the service will reject; a
+ * model that declares `no` does not reason at all, so exposing its levels would
+ * advertise behaviour it does not have.
+ */
 export declare function reasoningEffortsForEntry(modelId: string, catalog: readonly KimiCodeCatalogModel[]): string[];
+/**
+ * Default thinking level for one model, when the server states one.
+ *
+ * A declared default that the resolved effort list no longer contains is
+ * dropped rather than carried through: with `only` in force the list can lose
+ * `none`, and a default naming a level the model can no longer be asked for
+ * would fail on the first turn that relied on it.
+ */
+export declare function defaultReasoningEffortForEntry(modelId: string, catalog: readonly KimiCodeCatalogModel[]): string | undefined;
+/**
+ * Whether one model accepts tool declarations at all.
+ *
+ * Distinct from {@link dynamicToolsForEntry}, which asks the narrower question
+ * of message-level declarations: a model can take tools at the top level and
+ * not accept them per message, and collapsing the two would disable tools on a
+ * model that still works. Precedence is the live listing, including an
+ * explicit false, then the shipped registry.
+ */
+export declare function toolUseForEntry(modelId: string, catalog: readonly KimiCodeCatalogModel[]): boolean;
+/**
+ * Prompt ceiling for one model, or undefined when it equals the window.
+ *
+ * The completion budget still uses the full window — the cap bounds what may be
+ * sent, not how much may be generated — but a caller sizing a prompt needs the
+ * smaller of the two whenever the service states a lower input bound.
+ */
+export declare function maxInputTokensForEntry(modelId: string, catalog: readonly KimiCodeCatalogModel[]): number | undefined;
 /**
  * Whether one model accepts message-level tool declarations.
  *

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