@toddzheng024/dscode-bundle 0.7.26 → 0.7.28

package/vendor/deepseek/types/adapter.d.ts

@@ -1,163 +1,24 @@
-/**
- * `DeepSeekAdapter`: fetch + SSE against a DeepSeek (OpenAI-compatible)
- * chat-completions endpoint, emitting harness StreamChunks. The adapter is
- * transport-only: connection facts arrive through a thunk resolved once per
- * operation and the bearer token through a per-request resolver, so the
- * registering plugin owns validation, layering, and credential policy.
- *
- * @module dsh-llm-deepseek/adapter
- */
+/** Direct Messages transport with one cancellable lifecycle per model request. */
 import { LlmAdapter } from '@deepseek-ai/dsh-llm';
-import type { GenerateOptions, ImageAttachmentAccess, LlmModelInfo, LlmProviderInfo, PreparedAdapterCall, LlmResolvedModelInfo, ModelModality, ResolvedRetryPolicy, StreamChunk, SystemPromptUpdate } from '@deepseek-ai/dsh-llm';
-import type { AttachmentStore, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-import type { CredentialRef } from '@deepseek-ai/dsh-credentials';
-import type { AnonymousUserId } from '@deepseek-ai/dsh-anonymous-user-id';
-import type { DeepSeekLlmApiExtensionRequest, PreparedDeepSeekLlmApiExtensions } from '@deepseek-ai/dsh-deepseek-llm-api-extensions';
-import type { RequestDefaults } from './serialize.ts';
-import { DeepSeekFileStore } from './file-store.ts';
-import type { DeepSeekFilePolicy } from './file-store.ts';
-import type { WireError } from './types.ts';
-/** One optional model entry advertised by the direct-fetch adapter. */
-export interface DeepSeekCatalogModel {
-    /** Wire model id accepted by the configured endpoint. */
-    id: string;
-    /** Selector label; defaults to {@link id}. */
-    name?: string;
-    /** Optional selector detail for deployments with similar model variants. */
-    description?: string;
-    /** Known combined request/response context capacity; omitted when deployment metadata is unavailable. */
-    contextWindow?: number;
-    /** Per-request output cap for this model; omission falls back to the profile's {@link DeepSeekConnectionOptions.maxTokens}. */
-    maxTokens?: number;
-    /** Accepted request modalities; omission is text-only. */
-    inputModalities?: ModelModality[];
-    /** Total-pixel budget for one deterministic request preview, or the 512-by-512 `low` preset. */
-    imagePixelBudget?: number | 'low';
-    /** Encoded-byte target for one deterministic request preview; the smallest quality-ladder output is used when no quality fits. */
-    imageMaxBytes?: number;
-    /**
-     * `'in-history'` declares that the endpoint reads the latest `system`
-     * message at any position of the conversation as the complete effective
-     * system prompt; omission means only a leading system message is read.
-     */
-    systemPromptUpdate?: SystemPromptUpdate;
-}
-/**
- * Validated connection facts for one operation. The plugin's
- * `resolveAdapterOptions` is the one explicit resolve step producing this
- * shape; the adapter trusts it and re-reads it per operation, which is what
- * makes a configuration change reach the next request without re-registration.
- */
-export interface DeepSeekConnectionOptions {
-    /** Endpoint base; `/chat/completions` is appended. */
-    baseURL: string;
-    /**
-     * Credential reference of this same resolution, resolved per request.
-     * Travelling with the endpoint is the point: a request can never pair one
-     * generation's URL with another generation's secret. Configuration carries
-     * only this name — a literal key is not a configuration value.
-     */
-    apiKeyEnv: CredentialRef;
-    /** Request defaults applied to every call (thinking mode, effort). */
-    defaults: RequestDefaults;
-    /** Default per-request output cap; explicit request values win. */
-    maxTokens: number;
-    /** Positive context capacity used when the selected model has no exact value. */
-    defaultContextWindow: number;
-    /** Advisory models exposed to discovery consumers; requests remain unrestricted. */
-    models: readonly DeepSeekCatalogModel[];
-    /** Maximum provider idle time while one stream read is outstanding. */
-    streamIdleTimeoutMs: number;
-    /** Maximum accumulated file-referenced image bytes in one request. */
-    maxRequestFilesBytes: number;
-    /** Maximum accumulated base64 image payload after Files API fallback. */
-    maxInlineRequestImageBytes: number;
-    /** Maximum number of represented images in one request. */
-    maxImagesPerRequest: number;
-    /** Raw-byte removal step after the file-reference bound is exceeded. */
-    imageOffloadByteQuantum: number;
-    /** Base64-byte removal step after the inline fallback bound is exceeded. */
-    inlineImageOffloadByteQuantum: number;
-    /** Image-count removal step after the count bound is exceeded. */
-    imageOffloadCountQuantum: number;
-    /** Maximum duration of one request-image Files API resolution. */
-    filesApiTimeoutMs: number;
-    /** Upload expiry, refresh, and quota-recovery policy. */
-    filePolicy: DeepSeekFilePolicy;
-    /** Provider-owned model-request retry policy, already resolved. */
-    retryPolicy: ResolvedRetryPolicy;
-}
-/** Constructor options for {@link DeepSeekAdapter}: the operation-local resolution hooks the plugin owns. */
-export interface DeepSeekAdapterOptions {
-    /** Current validated connection facts; called once per operation. */
-    options: () => DeepSeekConnectionOptions;
-    /**
-     * Resolve the bearer token for the connection facts of one request. The
-     * snapshot is passed in — never re-read — so the key can only ever come
-     * from the same resolution as the endpoint it is sent to. Throws `LlmError`
-     * `MISSING_CREDENTIAL` when no key is available anywhere.
-     */
-    resolveApiKey: (connection: DeepSeekConnectionOptions) => Promise<string>;
-    /** Resolve the harness-home anonymous id shared with telemetry and feedback. */
-    resolveUserId: () => AnonymousUserId;
-    /** Resolve the current durable attachment service; absence rejects image input. */
-    resolveAttachments?: () => AttachmentStore | undefined;
-    /** Bridge one attachment reference into the current model-tool execution world. */
-    resolveImageAccess?: (attachments: AttachmentStore, ref: ImageAttachmentRef) => ImageAttachmentAccess | undefined;
-    /** Resolve the process-wide upload reuse store. */
-    resolveFiles?: () => DeepSeekFileStore;
-    /** Prepare the official API's plugin-contributed top-level fields for one exact wire request. */
-    prepareExtensions: (request: DeepSeekLlmApiExtensionRequest) => Promise<PreparedDeepSeekLlmApiExtensions>;
-}
-/** Default maximum idle interval while an adapter stream read is outstanding. */
-export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
-/** Default combined request/response context capacity. */
-export declare const DEFAULT_CONTEXT_WINDOW = 1000000;
-/** Default per-request output-token cap. */
-export declare const DEFAULT_MAX_TOKENS = 256000;
-/** Default bound on accumulated base64 image payload after Files API fallback. */
-export declare const DEFAULT_MAX_INLINE_REQUEST_IMAGE_BYTES: number;
-/** Deterministic raw-byte removal step. */
-export declare const DEFAULT_IMAGE_OFFLOAD_BYTE_QUANTUM: number;
-/** Deterministic base64-byte removal step after Files API fallback. */
-export declare const DEFAULT_INLINE_IMAGE_OFFLOAD_BYTE_QUANTUM: number;
-/** Deterministic image-count removal step. */
-export declare const DEFAULT_IMAGE_OFFLOAD_COUNT_QUANTUM = 20;
-/** Default explicit lifetime for uploaded images. */
-export declare const DEFAULT_FILE_EXPIRY_SECONDS: number;
-/** Default proactive refresh window for indexed file ids. */
-export declare const DEFAULT_FILE_REFRESH_MARGIN_SECONDS: number;
-/** Default number of oldest harness-owned files removed on quota recovery. */
-export declare const DEFAULT_FILE_QUOTA_CLEANUP_BATCH = 100;
-/** Default deadline for resolving one request image through the Files API. */
-export declare const DEFAULT_FILES_API_TIMEOUT_MS = 60000;
-/**
- * Map an HTTP status to a stable LlmError code.
- * @param status - status of a non-2xx provider response.
- * @param error - parsed provider error body, when available.
- * @returns the normalized harness error code.
- */
-export declare function httpErrorCode(status: number, error?: WireError['error']): string;
-/**
- * The first real `LlmAdapter`. One instance serves every model name it was
- * registered under (the harness model name IS the wire model name).
- *
- * One stable signal reaches both initial fetch and body reads. Caller aborts
- * map to `ABORTED`; the configured per-read idle watchdog maps to `TIMEOUT`.
- */
+import type { GenerateOptions, PreparedAdapterCall, StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { DeepSeekAdapterOptions } from './types.ts';
+/** DeepSeek provider using Messages content and native thinking replay. */
 export declare class DeepSeekAdapter extends LlmAdapter {
-    private readonly config;
+    private readonly dependencies;
     private readonly files;
-    constructor(config: DeepSeekAdapterOptions);
-    providerInfo(provider: string): LlmProviderInfo;
-    providerRetryPolicy(_provider: string): ResolvedRetryPolicy;
-    imageRequestPricing(_provider: string, model: string): ReturnType<LlmAdapter['imageRequestPricing']>;
-    listModels(provider: string): Promise<readonly LlmModelInfo[]>;
-    resolveModel(provider: string, model: string, _signal?: AbortSignal): Promise<LlmResolvedModelInfo>;
-    private modelInfoFor;
+    private readonly imageAccess;
+    constructor(dependencies: DeepSeekAdapterOptions);
+    providerInfo(provider: string): {
+        id: string;
+        name: string;
+    };
+    providerRetryPolicy(_provider: string): import("@deepseek-ai/dsh-llm").ResolvedRetryPolicy;
+    listModels(provider: string): Promise<import("@deepseek-ai/dsh-llm").LlmModelInfo[]>;
+    resolveModel(provider: string, model: string, _signal?: AbortSignal): Promise<import("@deepseek-ai/dsh-llm").LlmResolvedModelInfo>;
+    imageRequestPricing(_provider: string, model: string): import("@deepseek-ai/dsh-llm").LlmImageRequestPricing;
     prepareCall(provider: string, model: string, _signal?: AbortSignal): Promise<PreparedAdapterCall>;
     stream(options: GenerateOptions): AsyncIterable<StreamChunk>;
-    private streamWithConnection;
+    private generate;
     private request;
 }
 //# sourceMappingURL=adapter.d.ts.map

package/vendor/deepseek/types/config.d.ts

@@ -0,0 +1,127 @@
+/** Plugin configuration and complete request-local resolution for DeepSeek. */
+import type { Volatile } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import type { RetryPolicyConfig } from '@deepseek-ai/dsh-llm';
+import type { LaunchEnvironmentSnapshot } from '@deepseek-ai/dsh-launch-environment';
+import type { DeepSeekCatalogModel, DeepSeekConnectionOptions } from './types.ts';
+/**
+ * Plugin config, validated by the same-named schemastery schema and doubling
+ * as the `llm-deepseek` settings-section shape. Every field is optional in
+ * yml: a missing API key resolves through {@link Config.apiKeyEnv} at each
+ * request (a request without any key fails with `MISSING_CREDENTIAL`, not at
+ * plugin load), omitted thinking mode uses the provider default, and omitted
+ * reasoning effort resolves to `high`.
+ */
+export interface Config {
+    /** Credential reference (environment-variable name) resolved per request; defaults to `DEEPSEEK_API_KEY`. */
+    apiKeyEnv: Volatile<string>;
+    /** Endpoint base; falls back to $DEEPSEEK_BASE_URL from a trusted environment layer, then the public API. */
+    baseURL: Volatile<string | undefined>;
+    /** Deployment thinking policy; `disabled` limits every conversation request to `off`. */
+    thinking: Volatile<'enabled' | 'disabled' | undefined>;
+    /** Default thinking effort (default `high`); `off` disables thinking per request. */
+    reasoningEffort: Volatile<'off' | 'low' | 'high' | 'max' | undefined>;
+    /** Default per-request output cap (default 256,000); a model's own cap and explicit request values win. */
+    maxTokens: Volatile<number>;
+    /** Positive context capacity used when the selected model has no exact value (default 1,000,000). */
+    defaultContextWindow: Volatile<number>;
+    /** Advisory models shown by discovery consumers; defaults to V41 Flash and V4 Pro. */
+    models: Volatile<DeepSeekCatalogModel[]>;
+    /** Maximum provider idle time while one stream read is outstanding (default five minutes). */
+    streamIdleTimeoutMs: Volatile<number>;
+    /** Maximum accumulated file-referenced image bytes per chat request (default 128 MiB). */
+    maxRequestFilesBytes: Volatile<number>;
+    /** Maximum accumulated base64 image payload after Files API fallback (default 20 MiB). */
+    maxInlineRequestImageBytes: Volatile<number>;
+    /** Maximum number of represented images per chat request (default 600). */
+    maxImagesPerRequest: Volatile<number>;
+    /** Raw-byte removal step after the request exceeds its file bound (default 64 MiB). */
+    imageOffloadByteQuantum: Volatile<number>;
+    /** Base64-byte removal step after inline fallback exceeds its bound (default 10 MiB). */
+    inlineImageOffloadByteQuantum: Volatile<number>;
+    /** Image-count removal step after the request exceeds its count bound (default 20). */
+    imageOffloadCountQuantum: Volatile<number>;
+    /** Maximum duration of one request-image Files API resolution (default one minute). */
+    filesApiTimeoutMs: Volatile<number>;
+    /** Explicit lifetime assigned to each uploaded image (default seven days). */
+    fileExpiresAfterSeconds: Volatile<number>;
+    /** Remaining lifetime below which an indexed file is replaced (default one hour). */
+    fileRefreshMarginSeconds: Volatile<number>;
+    /** Oldest harness-owned files deleted before one quota-recovery upload retry (default 100). */
+    fileQuotaCleanupBatch: Volatile<number>;
+    /** Provider-owned model-request retry policy; omission uses normal mode with five retries. */
+    retryPolicy: Volatile<RetryPolicyConfig | undefined>;
+}
+/** Plain options accepted by the provider resolver. */
+export type Options = {
+    [K in keyof Config]?: Config[K] extends Volatile<infer T> ? Exclude<T, undefined> : never;
+};
+/** Read the current value behind every reference of a validated Config.
+ * @param config Parsed plugin Config.
+ * @returns Plain options for the resolver.
+ */
+export declare function plainOptions(config: Config): Options;
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    apiKeyEnv: z<string, string, "volatile-defined">;
+    baseURL: z<string, string, "volatile">;
+    thinking: z<"enabled" | "disabled", "enabled" | "disabled", "volatile">;
+    reasoningEffort: z<"low" | "off" | "high" | "max", "low" | "off" | "high" | "max", "volatile">;
+    maxTokens: z<number, number, "volatile-defined">;
+    defaultContextWindow: z<number, number, "volatile-defined">;
+    models: z<NoInfer<DeepSeekCatalogModel[]>, NoInfer<DeepSeekCatalogModel[]>, "volatile-defined">;
+    streamIdleTimeoutMs: z<number, number, "volatile-defined">;
+    maxRequestFilesBytes: z<number, number, "volatile-defined">;
+    maxInlineRequestImageBytes: z<number, number, "volatile-defined">;
+    maxImagesPerRequest: z<number, number, "volatile-defined">;
+    imageOffloadByteQuantum: z<number, number, "volatile-defined">;
+    inlineImageOffloadByteQuantum: z<number, number, "volatile-defined">;
+    imageOffloadCountQuantum: z<number, number, "volatile-defined">;
+    filesApiTimeoutMs: z<number, number, "volatile-defined">;
+    fileExpiresAfterSeconds: z<number, number, "volatile-defined">;
+    fileRefreshMarginSeconds: z<number, number, "volatile-defined">;
+    fileQuotaCleanupBatch: z<number, number, "volatile-defined">;
+    retryPolicy: z<NoInfer<RetryPolicyConfig>, NoInfer<RetryPolicyConfig>, "volatile">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    apiKeyEnv: z<string, string, "volatile-defined">;
+    baseURL: z<string, string, "volatile">;
+    thinking: z<"enabled" | "disabled", "enabled" | "disabled", "volatile">;
+    reasoningEffort: z<"low" | "off" | "high" | "max", "low" | "off" | "high" | "max", "volatile">;
+    maxTokens: z<number, number, "volatile-defined">;
+    defaultContextWindow: z<number, number, "volatile-defined">;
+    models: z<NoInfer<DeepSeekCatalogModel[]>, NoInfer<DeepSeekCatalogModel[]>, "volatile-defined">;
+    streamIdleTimeoutMs: z<number, number, "volatile-defined">;
+    maxRequestFilesBytes: z<number, number, "volatile-defined">;
+    maxInlineRequestImageBytes: z<number, number, "volatile-defined">;
+    maxImagesPerRequest: z<number, number, "volatile-defined">;
+    imageOffloadByteQuantum: z<number, number, "volatile-defined">;
+    inlineImageOffloadByteQuantum: z<number, number, "volatile-defined">;
+    imageOffloadCountQuantum: z<number, number, "volatile-defined">;
+    filesApiTimeoutMs: z<number, number, "volatile-defined">;
+    fileExpiresAfterSeconds: z<number, number, "volatile-defined">;
+    fileRefreshMarginSeconds: z<number, number, "volatile-defined">;
+    fileQuotaCleanupBatch: z<number, number, "volatile-defined">;
+    retryPolicy: z<NoInfer<RetryPolicyConfig>, NoInfer<RetryPolicyConfig>, "volatile">;
+}>>, "plain">;
+/** Public API default; the internal endpoint comes from $DEEPSEEK_BASE_URL. */
+export declare const PUBLIC_BASE_URL = "https://api.deepseek.com/anthropic";
+/**
+ * One resolution's complete request facts. Connection and credential facts
+ * are one value on purpose: a snapshot the resolver rejects keeps the whole
+ * previous generation, so a request can never pair a stale endpoint with a
+ * newer key.
+ */
+export type ResolvedDeepSeekOptions = DeepSeekConnectionOptions;
+/**
+ * The one explicit resolve step from raw config to validated connection
+ * facts. Programmatic construction may bypass Schemastery normalization, so
+ * every default and bound is re-judged here — for the composition entry at
+ * load (fail loud) and for each settings snapshot at its first use.
+ * @param config - raw plugin config or resolved settings snapshot.
+ * @param environment - this run's environment layers, or `undefined` outside
+ * the product CLI. Every layer may supply an endpoint: the product trusts the
+ * project it is launched in, so a checkout can point its own agent at the
+ * gateway that checkout is meant to use.
+ * @returns validated connection facts plus the credential reference.
+ */
+export declare function resolveAdapterOptions(config: Options, environment?: LaunchEnvironmentSnapshot): ResolvedDeepSeekOptions;
+//# sourceMappingURL=config.d.ts.map

package/vendor/deepseek/types/defaults.d.ts

@@ -0,0 +1,24 @@
+/** Shared provider limits and Chat Files API defaults. */
+/** Default maximum idle interval while an adapter stream read is outstanding. */
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
+/** Default combined request/response context capacity. */
+export declare const DEFAULT_CONTEXT_WINDOW = 1000000;
+/** Default per-request output-token cap. */
+export declare const DEFAULT_MAX_TOKENS = 256000;
+/** Default bound on accumulated base64 image payload after Files API fallback. */
+export declare const DEFAULT_MAX_INLINE_REQUEST_IMAGE_BYTES: number;
+/** Deterministic raw-byte removal step. */
+export declare const DEFAULT_IMAGE_OFFLOAD_BYTE_QUANTUM: number;
+/** Deterministic base64-byte removal step after Files API fallback. */
+export declare const DEFAULT_INLINE_IMAGE_OFFLOAD_BYTE_QUANTUM: number;
+/** Deterministic image-count removal step. */
+export declare const DEFAULT_IMAGE_OFFLOAD_COUNT_QUANTUM = 20;
+/** Default explicit lifetime for uploaded images. */
+export declare const DEFAULT_FILE_EXPIRY_SECONDS: number;
+/** Default proactive refresh window for indexed file ids. */
+export declare const DEFAULT_FILE_REFRESH_MARGIN_SECONDS: number;
+/** Default number of oldest harness-owned files removed on quota recovery. */
+export declare const DEFAULT_FILE_QUOTA_CLEANUP_BATCH = 100;
+/** Default deadline for resolving one request image through the Files API. */
+export declare const DEFAULT_FILES_API_TIMEOUT_MS = 60000;
+//# sourceMappingURL=defaults.d.ts.map

package/vendor/deepseek/types/file-store.d.ts

@@ -3,8 +3,8 @@ import type { RequestImageAttachment } from '@deepseek-ai/dsh-attachment';
 import type { DeepSeekFileId } from './file-id.ts';
 import { DeepSeekUploadIndex } from './upload-index.ts';
 import type { DeepSeekUploadRecord } from './upload-index.ts';
-/** DeepSeek chat accepts at most 32 MiB per image even when it is referenced by file id. */
-export declare const MAX_CHAT_IMAGE_BYTES: number;
+/** Shared Files-store limit for each request image, including file-id references. */
+export declare const MAX_IMAGE_BYTES: number;
 /** Resolved file-store policy from the plugin configuration. */
 export interface DeepSeekFilePolicy {
     expiresAfterSeconds: number;
@@ -15,6 +15,8 @@ export interface DeepSeekFilePolicy {
 export interface DeepSeekFileConnection {
     baseURL: string;
     apiKey: string;
+    /** Use the DSH account header; omitted for ordinary API keys. */
+    accountCredential?: boolean;
 }
 /** Result of one file-id resolution. */
 export interface DeepSeekFileReference {
@@ -48,7 +50,7 @@ export declare class DeepSeekFileStore {
     ensureUploaded(version: RequestImageAttachment, connection: DeepSeekFileConnection, policy: DeepSeekFilePolicy, signal?: AbortSignal): Promise<DeepSeekFileReference>;
     private ensureUploadedOnce;
     /**
-     * Invalidate one exact local mapping after the chat endpoint rejects its remote id.
+     * Invalidate one exact local mapping after a model request rejects its remote id.
      * @param version - request-image version whose remote generation failed.
      * @param fileId - exact rejected file id.
      * @param connection - endpoint and API-key snapshot.

package/vendor/deepseek/types/files-api.d.ts

@@ -1,4 +1,4 @@
-/** OpenAI-compatible DeepSeek Files API transport. @module dsh-llm-deepseek/files-api */
+/** DeepSeek Files API transport. @module dsh-llm-deepseek/files-api */
 import { LlmError } from '@deepseek-ai/dsh-llm';
 import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
 import type { DeepSeekFileId as DeepSeekFileIdType } from './file-id.ts';
@@ -12,13 +12,13 @@ export declare const MAX_FILE_UPLOAD_BYTES: number;
 export declare const MAX_STORED_FILE_COUNT = 10000;
 /** Current per-key storage quota. */
 export declare const MAX_STORED_FILE_BYTES: number;
-/** Validated file object returned by the OpenAI-compatible endpoint. */
+/** Validated provider file metadata. */
 export interface DeepSeekFileObject {
     id: DeepSeekFileIdType;
     bytes: number;
     createdAt: number;
     filename: string;
-    purpose: 'user_data';
+    /** Upload-time reuse deadline; list and retrieve responses omit this field. */
     expiresAt?: number;
 }
 /** One page returned by `GET /files`. */
@@ -48,11 +48,14 @@ export declare function isFilesQuotaError(error: unknown): error is DeepSeekFile
 interface FilesApiOptions {
     baseURL: string;
     apiKey: string;
+    /** Use the DSH account header; omitted for ordinary API keys. */
+    accountCredential?: boolean;
     fetch?: typeof fetch;
 }
-/** Direct client for the OpenAI-compatible `/files` endpoints. */
+/** Direct Files client retaining the configured URL root and refusing redirects before credentials can leave its origin. */
 export declare class DeepSeekFilesClient {
     private readonly baseURL;
+    private readonly accountCredential;
     private readonly apiKey;
     private readonly fetchImpl;
     /**
@@ -63,7 +66,8 @@ export declare class DeepSeekFilesClient {
     /**
      * Upload one image with an explicit expiry.
      * @param input - deterministic request-version bytes, media type, filename, lifetime, and cancellation.
-     * @returns the validated provider file object, including `expires_at`.
+     * @returns the validated file and reuse deadline. Messages omits expiry metadata;
+     *   its deadline uses upload creation plus the requested lifetime.
      */
     upload(input: {
         data: Uint8Array;
@@ -75,14 +79,13 @@ export declare class DeepSeekFilesClient {
         expiresAt: number;
     }>;
     /**
-     * List one ascending or descending page of user-data files.
-     * @param options - pagination, ordering, and cancellation.
-     * @returns the validated page.
+     * List one provider-ordered page of files.
+     * @param options - pagination and cancellation.
+     * @returns the validated page with null cursors omitted.
      */
     list(options?: {
         after?: DeepSeekFileIdType;
         limit?: number;
-        order?: 'asc' | 'desc';
         signal?: AbortSignal;
     }): Promise<DeepSeekFilePage>;
     /**

package/vendor/deepseek/types/image-tokens.d.ts

@@ -1,19 +1,34 @@
 /**
- * DeepSeek v4 vision-token accounting: the provider's published image-token
- * calculator (api-docs.deepseek.com, Token & Token Usage) ported verbatim.
- * The provider resizes every request image onto a 14px-patch grid, downsamples
- * 3:1 per axis, and caps one image at 384 tokens; the port prices the
- * pad-to-4 alignment at its 3-token upper bound because request pricing has
- * no preceding-token position. Actual usage remains authoritative.
+ * DeepSeek vision-token accounting: the provider's published image-token
+ * calculator (api-docs.deepseek.com, Token & Token Usage) ported verbatim in
+ * its current `v41` configuration. The provider scales an image below
+ * 544×544 total pixels up, aligns it to a 14px-patch grid, downsamples 3:1
+ * per axis into token cells, and caps one image at 1024 tokens by solving the
+ * largest aspect-preserving grid inside that budget. The count is exact: this
+ * configuration has no alignment pad and no aspect-ratio clamp. Actual usage
+ * remains authoritative.
  *
  * @module dsh-llm-deepseek/image-tokens
  */
+import type { ProjectedDimensions } from '@deepseek-ai/dsh-attachment';
 /**
- * Vision tokens DeepSeek v4 charges for one request image of the given
- * dimensions, at the worst-case alignment pad.
+ * Dimensions the harness sends so the provider keeps the whole image: the
+ * source itself when its patch-padded grid fits the token cap, otherwise the
+ * source aspect ratio at the solved grid's long edge. The provider pads the
+ * short edge to whole patches on its side. Rounding the aspect-preserving
+ * short edge can change the token count from the source's solved grid;
+ * request pricing uses the sent dimensions. Small images are never enlarged.
+ * @param width - positive integer source width in pixels.
+ * @param height - positive integer source height in pixels.
+ * @returns the request dimensions to encode.
+ */
+export declare function deepSeekRequestImageDimensions(width: number, height: number): ProjectedDimensions;
+/**
+ * Vision tokens DeepSeek charges for one request image of the given
+ * dimensions.
  * @param width - positive integer request-image width in pixels.
  * @param height - positive integer request-image height in pixels.
- * @returns the provider vision-token price, at most 384.
+ * @returns the provider vision-token price, at most 1024.
  */
 export declare function deepSeekImageTokens(width: number, height: number): number;
 //# sourceMappingURL=image-tokens.d.ts.map

package/vendor/deepseek/types/images.d.ts

@@ -0,0 +1,35 @@
+/** Deterministic Messages image preparation for Files references and bounded inline fallback. */
+import type { AttachmentStore, ImageAttachmentRef, RequestImageAttachment } from '@deepseek-ai/dsh-attachment';
+import type { ImageAttachmentAccessResolver, RequestMessage } from '@deepseek-ai/dsh-llm';
+import type { DeepSeekConnectionOptions as Connection } from './types.ts';
+import type { DeepSeekFileId } from './file-id.ts';
+import type { RequestFiles } from './request-files.ts';
+export { deepSeekImageRequestPricing as imagePricing } from './request-pricing.ts';
+/** Normalize retained image references before converting Messages content.
+ * @param history - durable history; never mutated.
+ * @param connection - request-local image budgets.
+ * @param modelId - target model id.
+ * @param attachments - mounted attachment store, required only for image requests.
+ * @param access - current execution-world path resolver.
+ * @param signal - request cancellation.
+ * @returns projected history and prepared image bytes keyed by attachment id.
+ */
+export declare function prepareImages(history: readonly RequestMessage[], connection: Connection, modelId: string, attachments: AttachmentStore | undefined, access: ImageAttachmentAccessResolver, signal: AbortSignal): Promise<{
+    messages: readonly RequestMessage[];
+    versions: Map<ImageAttachmentRef['attachmentId'], RequestImageAttachment>;
+}>;
+/** Require logged offload before retrying images that exceed the inline budget.
+ * @param messages - history already within the Files budget.
+ * @param versions - normalized versions prepared for retained references.
+ * @param connection - resolved inline bounds.
+ * @returns unchanged history within both byte and image-count limits.
+ */
+export declare function inlineImages(messages: readonly RequestMessage[], versions: ReadonlyMap<ImageAttachmentRef['attachmentId'], RequestImageAttachment>, connection: Connection): readonly RequestMessage[];
+/** Resolve retained images to Files ids, recording every occurrence for failure diagnostics.
+ * @param messages - history within the Files byte/count budget.
+ * @param versions - normalized versions for every retained reference.
+ * @param files - request-owned Files resolution and recovery.
+ * @returns ids keyed by durable attachment identity.
+ */
+export declare function prepareFileIds(messages: readonly RequestMessage[], versions: ReadonlyMap<ImageAttachmentRef['attachmentId'], RequestImageAttachment>, files: RequestFiles): Promise<Map<ImageAttachmentRef['attachmentId'], DeepSeekFileId>>;
+//# sourceMappingURL=images.d.ts.map

package/vendor/deepseek/types/index.d.ts

@@ -1,25 +1,13 @@
-/**
- * Register a {@link DeepSeekAdapter} for the `deepseek-official` provider route on
- * `ctx.llm`, with connection facts resolved per request instead of frozen at
- * load: the plugin layers its `cordis.yml` entry config under the optional
- * `llm-deepseek` user-settings section (`ctx.settings`) and resolves the API
- * key through the optional credential seam (`ctx.credentials`), so a changed
- * base URL, catalog, or key reaches the very next request without restarting
- * anything, while an in-flight stream keeps the facts it started with. The
- * one registration-captured fact — the retry policy — re-registers the route
- * in place when it changes.
- * @module @deepseek-ai/dsh-llm-deepseek
- */
 import type { Context } from '@deepseek-ai/cordis';
-import z from '@deepseek-ai/schemastery';
-import type { RetryPolicyConfig } from '@deepseek-ai/dsh-llm';
-import { type LaunchEnvironmentSnapshot } from '@deepseek-ai/dsh-launch-environment';
-import type { DeepSeekCatalogModel, DeepSeekConnectionOptions } from './adapter.ts';
-export { DEFAULT_CONTEXT_WINDOW, DEFAULT_FILE_EXPIRY_SECONDS, DEFAULT_FILE_QUOTA_CLEANUP_BATCH, DEFAULT_FILE_REFRESH_MARGIN_SECONDS, DEFAULT_FILES_API_TIMEOUT_MS, DEFAULT_IMAGE_OFFLOAD_BYTE_QUANTUM, DEFAULT_IMAGE_OFFLOAD_COUNT_QUANTUM, DEFAULT_INLINE_IMAGE_OFFLOAD_BYTE_QUANTUM, DEFAULT_MAX_INLINE_REQUEST_IMAGE_BYTES, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, DeepSeekAdapter, } from './adapter.ts';
-export type { DeepSeekAdapterOptions, DeepSeekCatalogModel, DeepSeekConnectionOptions } from './adapter.ts';
-export { DEFAULT_LOW_DETAIL_IMAGE_PIXEL_BUDGET, DEFAULT_MAX_IMAGES_PER_REQUEST, DEFAULT_MAX_REQUEST_FILES_BYTES, DEFAULT_REQUEST_IMAGE_MAX_BYTES, DEFAULT_REQUEST_IMAGE_PIXEL_BUDGET, deepSeekImageRequestPricing, resolveRequestImagePolicy, } from './request-pricing.ts';
-export { deepSeekImageTokens } from './image-tokens.ts';
-export { DeepSeekFileStore, MAX_CHAT_IMAGE_BYTES } from './file-store.ts';
+import { Config } from './config.ts';
+export { Config, plainOptions, resolveAdapterOptions, PUBLIC_BASE_URL } from './config.ts';
+export type { Options, ResolvedDeepSeekOptions } from './config.ts';
+export { DEFAULT_CONTEXT_WINDOW, DEFAULT_FILE_EXPIRY_SECONDS, DEFAULT_FILE_QUOTA_CLEANUP_BATCH, DEFAULT_FILE_REFRESH_MARGIN_SECONDS, DEFAULT_FILES_API_TIMEOUT_MS, DEFAULT_IMAGE_OFFLOAD_BYTE_QUANTUM, DEFAULT_IMAGE_OFFLOAD_COUNT_QUANTUM, DEFAULT_INLINE_IMAGE_OFFLOAD_BYTE_QUANTUM, DEFAULT_MAX_INLINE_REQUEST_IMAGE_BYTES, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, } from './defaults.ts';
+export { DeepSeekAdapter } from './adapter.ts';
+export type { DeepSeekAdapterOptions, DeepSeekCatalogModel, DeepSeekConnectionOptions } from './types.ts';
+export { DEFAULT_LOW_DETAIL_IMAGE_PIXEL_BUDGET, DEFAULT_MAX_IMAGES_PER_REQUEST, DEFAULT_MAX_REQUEST_FILES_BYTES, DEFAULT_REQUEST_IMAGE_MAX_BYTES, REQUEST_IMAGE_MAX_DIMENSION, deepSeekImageRequestPricing, resolveRequestImageMaxBytes, resolveRequestImageTarget, } from './request-pricing.ts';
+export { deepSeekImageTokens, deepSeekRequestImageDimensions } from './image-tokens.ts';
+export { DeepSeekFileStore, MAX_IMAGE_BYTES } from './file-store.ts';
 export type { DeepSeekFileConnection, DeepSeekFilePolicy, DeepSeekFileReference } from './file-store.ts';
 export { DeepSeekFilesClient, MAX_FILE_EXPIRY_SECONDS, MAX_FILE_UPLOAD_BYTES, MAX_STORED_FILE_BYTES, MAX_STORED_FILE_COUNT, MIN_FILE_EXPIRY_SECONDS } from './files-api.ts';
 export type { DeepSeekFileObject, DeepSeekFilePage } from './files-api.ts';
@@ -27,80 +15,8 @@ export { DeepSeekFileId } from './file-id.ts';
 export type { DeepSeekFileId as DeepSeekFileIdType } from './file-id.ts';
 export { DeepSeekUploadIndex, deepSeekFileScope } from './upload-index.ts';
 export type { DeepSeekUploadRecord } from './upload-index.ts';
-export type { RequestDefaults } from './serialize.ts';
-export type * from './types.ts';
+export type { RequestDefaults } from './types.ts';
 export declare const name = "llm-deepseek";
 export declare const inject: string[];
-/**
- * Plugin config, validated by the same-named schemastery schema and doubling
- * as the `llm-deepseek` settings-section shape. Every field is optional in
- * yml: a missing API key resolves through {@link Config.apiKeyEnv} at each
- * request (a request without any key fails with `MISSING_CREDENTIAL`, not at
- * plugin load), omitted thinking mode uses the provider default, and omitted
- * reasoning effort resolves to `high`.
- */
-export interface Config {
-    /** Credential reference (environment-variable name) resolved per request; defaults to `DEEPSEEK_API_KEY`. */
-    apiKeyEnv?: string;
-    /** Endpoint base; falls back to $DEEPSEEK_BASE_URL from a trusted environment layer, then the public API. */
-    baseURL?: string;
-    /** Deployment thinking policy; `disabled` limits every conversation request to `off`. */
-    thinking?: 'enabled' | 'disabled';
-    /** Default thinking effort (default `high`); `off` disables thinking per request. */
-    reasoningEffort?: 'off' | 'low' | 'high' | 'max';
-    /** Default per-request output cap (default 256,000); a model's own cap and explicit request values win. */
-    maxTokens?: number;
-    /** Positive context capacity used when the selected model has no exact value (default 1,000,000). */
-    defaultContextWindow?: number;
-    /** Advisory models shown by discovery consumers; defaults to V41 Flash, V4 Flash, V4 Pro, and V4 Flash Vision Exp. */
-    models?: DeepSeekCatalogModel[];
-    /** Maximum provider idle time while one stream read is outstanding (default five minutes). */
-    streamIdleTimeoutMs?: number;
-    /** Maximum accumulated file-referenced image bytes per chat request (default 128 MiB). */
-    maxRequestFilesBytes?: number;
-    /** Maximum accumulated base64 image payload after Files API fallback (default 20 MiB). */
-    maxInlineRequestImageBytes?: number;
-    /** Maximum number of represented images per chat request (default 600). */
-    maxImagesPerRequest?: number;
-    /** Raw-byte removal step after the request exceeds its file bound (default 64 MiB). */
-    imageOffloadByteQuantum?: number;
-    /** Base64-byte removal step after inline fallback exceeds its bound (default 10 MiB). */
-    inlineImageOffloadByteQuantum?: number;
-    /** Image-count removal step after the request exceeds its count bound (default 20). */
-    imageOffloadCountQuantum?: number;
-    /** Maximum duration of one request-image Files API resolution (default one minute). */
-    filesApiTimeoutMs?: number;
-    /** Explicit lifetime assigned to each uploaded image (default seven days). */
-    fileExpiresAfterSeconds?: number;
-    /** Remaining lifetime below which an indexed file is replaced (default one hour). */
-    fileRefreshMarginSeconds?: number;
-    /** Oldest harness-owned files deleted before one quota-recovery upload retry (default 100). */
-    fileQuotaCleanupBatch?: number;
-    /** Provider-owned model-request retry policy; omission uses normal mode with five retries. */
-    retryPolicy?: RetryPolicyConfig;
-}
-export declare const Config: z<Config>;
-/** Public API default; the internal endpoint comes from $DEEPSEEK_BASE_URL. */
-export declare const PUBLIC_BASE_URL = "https://api.deepseek.com";
-/**
- * One resolution's complete request facts. Connection and credential facts
- * are one value on purpose: a snapshot the resolver rejects keeps the whole
- * previous generation, so a request can never pair a stale endpoint with a
- * newer key.
- */
-export type ResolvedDeepSeekOptions = DeepSeekConnectionOptions;
-/**
- * The one explicit resolve step from raw config to validated connection
- * facts. Programmatic construction may bypass Schemastery normalization, so
- * every default and bound is re-judged here — for the composition entry at
- * load (fail loud) and for each settings snapshot at its first use.
- * @param config - raw plugin config or resolved settings snapshot.
- * @param environment - this run's environment layers, or `undefined` outside
- * the product CLI. Every layer may supply an endpoint: the product trusts the
- * project it is launched in, so a checkout can point its own agent at the
- * gateway that checkout is meant to use.
- * @returns validated connection facts plus the credential reference.
- */
-export declare function resolveAdapterOptions(config: Config, environment?: LaunchEnvironmentSnapshot): ResolvedDeepSeekOptions;
 export declare function apply(ctx: Context, config: Config): void;
 //# sourceMappingURL=index.d.ts.map

package/vendor/deepseek/types/messages-api.d.ts

@@ -0,0 +1,10 @@
+/** Shared DeepSeek Messages API endpoint and header policy. @module dsh-llm-deepseek/messages-api */
+/** Required opt-in for Messages file operations and file-referenced image requests. */
+export declare const MESSAGES_FILES_BETA = "files-api-2025-04-14";
+/**
+ * Resolve the API root without duplicating an explicit provider version path.
+ * @param baseURL - validated configured endpoint root.
+ * @returns the root beneath which Messages resources are exposed.
+ */
+export declare function messagesApiRoot(baseURL: string): string;
+//# sourceMappingURL=messages-api.d.ts.map