@love-moon/ai-sdk 0.7.7 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @love-moon/ai-sdk
 
+## 0.9.0
+
+### Minor Changes
+
+- a15b55d: Add per-turn multi-image and local context-file inputs, plus authenticated attachment materialization from Conductor Web to the executing daemon.
+
+## 0.8.0
+
 ## 0.7.7
 
 ## 0.7.6

package/dist/built-in-backends.d.ts

@@ -23,6 +23,7 @@ export const KIMI_CLI_WIRE_VARIANT: "kimi-cli-wire";
 export const KIMI_CLI_PRINT_VARIANT: "kimi-cli-print";
 export const OPENCODE_SDK_VARIANT: "opencode-sdk";
 export const CHAT_WEB_SESSION_VARIANT: "chat-web-session";
+export const DSH_SDK_VARIANT: "dsh-sdk";
 /**
  * @typedef {Object} BuiltInBackendEntry
  * @property {string}   backend        Canonical backend name.

package/dist/built-in-backends.js

@@ -19,6 +19,7 @@ export const KIMI_CLI_WIRE_VARIANT = "kimi-cli-wire";
 export const KIMI_CLI_PRINT_VARIANT = "kimi-cli-print";
 export const OPENCODE_SDK_VARIANT = "opencode-sdk";
 export const CHAT_WEB_SESSION_VARIANT = "chat-web-session";
+export const DSH_SDK_VARIANT = "dsh-sdk";
 /**
  * @typedef {Object} BuiltInBackendEntry
  * @property {string}   backend        Canonical backend name.
@@ -60,6 +61,11 @@ export const BUILT_IN_BACKENDS = [
         aliases: ["chat-web", "chatweb", "chat_web", "web-chat"],
         defaultVariant: CHAT_WEB_SESSION_VARIANT,
     },
+    {
+        backend: "dsh",
+        aliases: ["dsh", "deepseek-harness"],
+        defaultVariant: DSH_SDK_VARIANT,
+    },
 ];
 const ALIAS_TO_BACKEND = new Map();
 for (const entry of BUILT_IN_BACKENDS) {

package/dist/context-files.d.ts

@@ -0,0 +1,16 @@
+export function normalizeContextFiles(value: any): {
+    path: any;
+    name: string;
+    mimeType: any;
+    sizeBytes: number;
+}[];
+export function appendContextFilesToPrompt(promptText: any, value: any): {
+    prompt: string;
+    contextFiles: {
+        path: any;
+        name: string;
+        mimeType: any;
+        sizeBytes: number;
+    }[];
+};
+export function createContextFileError(message: any, extras?: {}): Error;

package/dist/context-files.js

@@ -0,0 +1,86 @@
+import fs from "node:fs";
+import path from "node:path";
+const MAX_CONTEXT_FILES = 20;
+const MAX_CONTEXT_FILE_BYTES = 100 * 1024 * 1024;
+const MAX_TOTAL_CONTEXT_BYTES = 200 * 1024 * 1024;
+export function normalizeContextFiles(value) {
+    if (value === undefined || value === null)
+        return [];
+    if (!Array.isArray(value))
+        throw createContextFileError("contextFiles must be an array");
+    if (value.length > MAX_CONTEXT_FILES) {
+        throw createContextFileError(`contextFiles cannot contain more than ${MAX_CONTEXT_FILES} files`, {
+            reason: "context_file_limit_exceeded",
+        });
+    }
+    let totalBytes = 0;
+    return value.map((item, index) => {
+        if (!item || typeof item !== "object" || Array.isArray(item)) {
+            throw createContextFileError(`contextFiles[${index}] must be an object`, { contextFileIndex: index });
+        }
+        const filePath = typeof item.path === "string" ? item.path.trim() : "";
+        if (!filePath || !path.isAbsolute(filePath)) {
+            throw createContextFileError(`contextFiles[${index}] path must be absolute`, { contextFileIndex: index });
+        }
+        let stat;
+        try {
+            const linkStat = fs.lstatSync(filePath);
+            if (linkStat.isSymbolicLink())
+                throw new Error("symbolic links are not allowed");
+            stat = fs.statSync(filePath);
+        }
+        catch {
+            throw createContextFileError(`contextFiles[${index}] file does not exist`, { contextFileIndex: index });
+        }
+        if (!stat.isFile()) {
+            throw createContextFileError(`contextFiles[${index}] path must reference a file`, { contextFileIndex: index });
+        }
+        if (stat.size > MAX_CONTEXT_FILE_BYTES) {
+            throw createContextFileError(`contextFiles[${index}] exceeds the file size limit`, {
+                reason: "context_file_limit_exceeded",
+                contextFileIndex: index,
+                maxBytes: MAX_CONTEXT_FILE_BYTES,
+            });
+        }
+        totalBytes += stat.size;
+        if (totalBytes > MAX_TOTAL_CONTEXT_BYTES) {
+            throw createContextFileError("contextFiles exceeds the total size limit", {
+                reason: "context_file_limit_exceeded",
+                maxBytes: MAX_TOTAL_CONTEXT_BYTES,
+            });
+        }
+        return {
+            path: filePath,
+            name: typeof item.name === "string" && item.name.trim() ? path.basename(item.name.trim()) : path.basename(filePath),
+            mimeType: typeof item.mimeType === "string" && item.mimeType.trim()
+                ? item.mimeType.trim().toLowerCase()
+                : "application/octet-stream",
+            sizeBytes: stat.size,
+        };
+    });
+}
+export function appendContextFilesToPrompt(promptText, value) {
+    const files = normalizeContextFiles(value);
+    const prompt = String(promptText || "").trim();
+    if (files.length === 0)
+        return { prompt, contextFiles: files };
+    const manifest = files.map((file, index) => [
+        `${index + 1}. ${file.name}`,
+        `   Path: ${file.path}`,
+        `   MIME: ${file.mimeType}`,
+    ].join("\n")).join("\n\n");
+    return {
+        contextFiles: files,
+        prompt: [
+            prompt,
+            "The following user-provided context files are available locally. Read them when relevant to the request:",
+            manifest,
+        ].filter(Boolean).join("\n\n"),
+    };
+}
+export function createContextFileError(message, extras = {}) {
+    const error = new Error(message);
+    error.reason = extras.reason || "invalid_context_file";
+    Object.assign(error, extras);
+    return error;
+}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { BUILT_IN_BACKENDS } from "./built-in-backends.js";
+export { PROVIDER_MEDIA_CAPABILITIES } from "./media-adapters.js";
 export { createAiSession, RemoteAiSession } from "./client.js";
+export { appendContextFilesToPrompt, normalizeContextFiles } from "./context-files.js";
+export { assertMediaCapabilities, fileMediaToBase64, fileMediaToDataUri, normalizeMediaInputs, resolveTurnMedia } from "./media-input.js";
 export { GOAL_STATUSES, TERMINAL_GOAL_STATUSES, isGoalStatus, isTerminalGoalStatus } from "./shared.js";
-export { AiManager, accountNameFromPath, checkInstall, checkInstallAll, checkNetwork, checkNetworkAll, getClaudeQuota, getCodexQuota, getCopilotQuota, getCurrentCodexAccount, getExternalQuota, getExternalQuotaList, getKimiQuota, listCodexAccounts, loadAiManagerConfig, normalizeExternalQuota, normalizeExternalQuotaList, parseAuthFile, parseAuthFileContents, parseCopilotQuotaSnapshots, readCachedCodexQuota, resolveClaudeCredential, switchCodexAccount } from "./manager/index.js";
+export { AiManager, accountNameFromPath, checkInstall, checkInstallAll, checkNetwork, checkNetworkAll, getClaudeQuota, getCodexQuota, getCopilotQuota, getCurrentCodexAccount, getDshQuota, readCachedDshQuota, resolveDeepSeekCredential, getExternalQuota, getExternalQuotaList, getKimiQuota, listCodexAccounts, loadAiManagerConfig, normalizeExternalQuota, normalizeExternalQuotaList, parseAuthFile, parseAuthFileContents, parseCopilotQuotaSnapshots, readCachedCodexQuota, resolveClaudeCredential, switchCodexAccount } from "./manager/index.js";
 export { getExternalProviderDescriptor, getExternalProviderRegistry, resetExternalProviderRegistryForTests, resolveExternalBackend } from "./external-provider-registry.js";
 export { resolveResumeContext, buildResumeArgsForBackend, resumeProviderForBackend, findSessionPath, resolveSessionRunDirectory, inspectResumeTarget } from "./resume/index.js";

package/dist/index.js

@@ -1,6 +1,9 @@
 export { createAiSession, RemoteAiSession } from "./client.js";
 export { BUILT_IN_BACKENDS } from "./built-in-backends.js";
+export { PROVIDER_MEDIA_CAPABILITIES } from "./media-adapters.js";
+export { appendContextFilesToPrompt, normalizeContextFiles } from "./context-files.js";
+export { assertMediaCapabilities, fileMediaToBase64, fileMediaToDataUri, normalizeMediaInputs, resolveTurnMedia, } from "./media-input.js";
 export { GOAL_STATUSES, TERMINAL_GOAL_STATUSES, isGoalStatus, isTerminalGoalStatus, } from "./shared.js";
-export { AiManager, accountNameFromPath, checkInstall, checkInstallAll, checkNetwork, checkNetworkAll, getClaudeQuota, getCodexQuota, getCopilotQuota, getCurrentCodexAccount, getExternalQuota, getExternalQuotaList, getKimiQuota, listCodexAccounts, loadAiManagerConfig, normalizeExternalQuota, normalizeExternalQuotaList, parseAuthFile, parseAuthFileContents, parseCopilotQuotaSnapshots, readCachedCodexQuota, resolveClaudeCredential, switchCodexAccount, } from "./manager/index.js";
+export { AiManager, accountNameFromPath, checkInstall, checkInstallAll, checkNetwork, checkNetworkAll, getClaudeQuota, getCodexQuota, getCopilotQuota, getCurrentCodexAccount, getDshQuota, readCachedDshQuota, resolveDeepSeekCredential, getExternalQuota, getExternalQuotaList, getKimiQuota, listCodexAccounts, loadAiManagerConfig, normalizeExternalQuota, normalizeExternalQuotaList, parseAuthFile, parseAuthFileContents, parseCopilotQuotaSnapshots, readCachedCodexQuota, resolveClaudeCredential, switchCodexAccount, } from "./manager/index.js";
 export { getExternalProviderDescriptor, getExternalProviderRegistry, resetExternalProviderRegistryForTests, resolveExternalBackend, } from "./external-provider-registry.js";
 export { resolveResumeContext, buildResumeArgsForBackend, resumeProviderForBackend, findSessionPath, resolveSessionRunDirectory, inspectResumeTarget, } from "./resume/index.js";

package/dist/manager/index.d.ts

@@ -8,5 +8,6 @@ export { getCodexQuota, readCachedCodexQuota, type GetCodexQuotaOptions, } from
 export { getClaudeQuota, resolveClaudeCredential, type GetClaudeQuotaOptions, type ClaudeCredential, } from "./quota/claude.js";
 export { getKimiQuota, type GetKimiQuotaOptions } from "./quota/kimi.js";
 export { getCopilotQuota, parseCopilotQuotaSnapshots, type GetCopilotQuotaOptions, } from "./quota/copilot.js";
+export { getDshQuota, readCachedDshQuota, resolveDeepSeekCredential, parseDshBalance, normalizeDshBaseUrl, type DshQuotaOptions, } from "./quota/dsh.js";
 export { getExternalQuota, getExternalQuotaList, normalizeExternalQuota, normalizeExternalQuotaList, type GetExternalQuotaListOptions, type GetExternalQuotaOptions, } from "./quota/external.js";
 export type { AiManagerConfig, CodexAccount, CodexQuota, ClaudeQuota, ExternalQuota, ExternalQuotaList, KimiQuota, CopilotQuota, CopilotQuotaSnapshot, InstallStatus, NetworkStatus, QuotaSource, QuotaWindow, SwitchResult, Tool, } from "./types.js";

package/dist/manager/index.js

@@ -8,4 +8,5 @@ export { getCodexQuota, readCachedCodexQuota, } from "./quota/codex.js";
 export { getClaudeQuota, resolveClaudeCredential, } from "./quota/claude.js";
 export { getKimiQuota } from "./quota/kimi.js";
 export { getCopilotQuota, parseCopilotQuotaSnapshots, } from "./quota/copilot.js";
+export { getDshQuota, readCachedDshQuota, resolveDeepSeekCredential, parseDshBalance, normalizeDshBaseUrl, } from "./quota/dsh.js";
 export { getExternalQuota, getExternalQuotaList, normalizeExternalQuota, normalizeExternalQuotaList, } from "./quota/external.js";

package/dist/manager/install.js

@@ -46,6 +46,9 @@ export async function checkInstall(tool, opts = {}) {
     if (tool === "copilot") {
         return checkCopilotSdkInstall();
     }
+    if (tool === "dsh") {
+        return checkDshSdkInstall();
+    }
     const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
     const bin = tool; // codex / claude
     const path = await which(bin, timeoutMs);
@@ -69,13 +72,14 @@ function extractSemver(line) {
     return m ? m[0] : undefined;
 }
 export async function checkInstallAll(opts) {
-    const [codex, claude, kimi, copilot] = await Promise.all([
+    const [codex, claude, kimi, copilot, dsh] = await Promise.all([
         checkInstall("codex", opts),
         checkInstall("claude", opts),
         checkInstall("kimi", opts),
         checkInstall("copilot", opts),
+        checkInstall("dsh", opts),
     ]);
-    return { codex, claude, kimi, copilot };
+    return { codex, claude, kimi, copilot, dsh };
 }
 async function checkCopilotSdkInstall() {
     try {
@@ -94,6 +98,29 @@ async function checkCopilotSdkInstall() {
         };
     }
 }
+/**
+ * DeepSeek Harness ships as pinned dependencies of this package rather than a
+ * CLI on PATH, so the reported version is the runtime package's own npm
+ * version — the same shape as the Copilot SDK probe above.
+ */
+async function checkDshSdkInstall() {
+    const RUNTIME_PACKAGE = "@deepseek-ai/dsh-sdk-jsonrpc-demo";
+    try {
+        const entryPath = require.resolve(`${RUNTIME_PACKAGE}/bin`);
+        const version = await findPackageVersionForEntry(entryPath, RUNTIME_PACKAGE);
+        return {
+            installed: true,
+            path: RUNTIME_PACKAGE,
+            version: version ?? "installed",
+        };
+    }
+    catch (err) {
+        return {
+            installed: false,
+            error: `${RUNTIME_PACKAGE} not available: ${err?.message ?? err}`,
+        };
+    }
+}
 /** Exported for tests. */
 export async function findPackageVersionForEntry(entryPath, packageName) {
     let dir = dirname(entryPath);

package/dist/manager/manager.d.ts

@@ -2,8 +2,9 @@ import { type GetCodexQuotaOptions } from "./quota/codex.js";
 import { type GetClaudeQuotaOptions } from "./quota/claude.js";
 import { type GetKimiQuotaOptions } from "./quota/kimi.js";
 import { type GetCopilotQuotaOptions } from "./quota/copilot.js";
+import { type DshQuotaOptions } from "./quota/dsh.js";
 import { type GetExternalQuotaListOptions, type GetExternalQuotaOptions } from "./quota/external.js";
-import type { AiManagerConfig, CodexAccount, CodexQuota, ClaudeQuota, ExternalQuota, ExternalQuotaList, KimiQuota, CopilotQuota, InstallStatus, NetworkStatus, SwitchResult, Tool } from "./types.js";
+import type { AiManagerConfig, CodexAccount, CodexQuota, ClaudeQuota, DshQuota, ExternalQuota, ExternalQuotaList, KimiQuota, CopilotQuota, InstallStatus, NetworkStatus, SwitchResult, Tool } from "./types.js";
 export interface AiManagerOptions {
     /** Path to conductor config.yaml. Default: $CONDUCTOR_HOME/config.yaml. */
     configPath?: string;
@@ -43,6 +44,9 @@ export declare class AiManager {
     getClaudeQuota(opts?: GetClaudeQuotaOptions): Promise<ClaudeQuota>;
     getKimiQuota(opts?: GetKimiQuotaOptions): Promise<KimiQuota>;
     getCopilotQuota(opts?: GetCopilotQuotaOptions): Promise<CopilotQuota>;
+    getDshQuota(opts?: DshQuotaOptions): Promise<DshQuota>;
+    /** Last cached DeepSeek balance, no network call. */
+    readCachedDshQuota(opts?: DshQuotaOptions): Promise<DshQuota | null>;
     getExternalQuota(opts: GetExternalQuotaOptions): Promise<ExternalQuota>;
     getExternalQuotaList(opts: GetExternalQuotaListOptions): Promise<ExternalQuotaList>;
     listCodexAccounts(): Promise<CodexAccount[]>;

package/dist/manager/manager.js

@@ -7,6 +7,7 @@ import { getCodexQuota, readCachedCodexQuota } from "./quota/codex.js";
 import { getClaudeQuota } from "./quota/claude.js";
 import { getKimiQuota } from "./quota/kimi.js";
 import { getCopilotQuota } from "./quota/copilot.js";
+import { getDshQuota, readCachedDshQuota } from "./quota/dsh.js";
 import { getExternalQuota, getExternalQuotaList, } from "./quota/external.js";
 import { DEFAULT_CODEX_AUTH, resolveDefaultConductorConfig } from "./paths.js";
 export class AiManager {
@@ -84,6 +85,13 @@ export class AiManager {
     getCopilotQuota(opts) {
         return getCopilotQuota(opts);
     }
+    getDshQuota(opts) {
+        return getDshQuota({ configPath: this.configPath, ...opts });
+    }
+    /** Last cached DeepSeek balance, no network call. */
+    readCachedDshQuota(opts) {
+        return readCachedDshQuota({ configPath: this.configPath, ...opts });
+    }
     getExternalQuota(opts) {
         return getExternalQuota({ configPath: this.configPath, ...opts });
     }

package/dist/manager/network.js

@@ -3,6 +3,7 @@ const ENDPOINTS = {
     claude: "https://api.anthropic.com/v1/messages",
     kimi: "https://api.kimi.com/coding/v1/usages",
     copilot: "https://api.githubcopilot.com/",
+    dsh: "https://api.deepseek.com/",
 };
 const DEFAULT_TIMEOUT_MS = 5000;
 export async function checkNetwork(tool, opts = {}) {
@@ -36,11 +37,12 @@ export async function checkNetwork(tool, opts = {}) {
     }
 }
 export async function checkNetworkAll(opts) {
-    const [codex, claude, kimi, copilot] = await Promise.all([
+    const [codex, claude, kimi, copilot, dsh] = await Promise.all([
         checkNetwork("codex", opts),
         checkNetwork("claude", opts),
         checkNetwork("kimi", opts),
         checkNetwork("copilot", opts),
+        checkNetwork("dsh", opts),
     ]);
-    return { codex, claude, kimi, copilot };
+    return { codex, claude, kimi, copilot, dsh };
 }

package/dist/manager/quota/dsh.d.ts

@@ -0,0 +1,55 @@
+import type { DshBalanceInfo, DshQuota } from "../types.js";
+interface DeepSeekBalanceResponse {
+    is_available?: unknown;
+    balance_infos?: unknown;
+}
+export interface DshQuotaOptions {
+    /**
+     * Explicit credential; skips the config/env resolution ladder. An empty
+     * string is an explicit "no credential" and does NOT fall back, so a caller
+     * can probe the unconfigured path deterministically.
+     */
+    apiKey?: string;
+    /** Endpoint base; a `/v1` suffix is tolerated and stripped. */
+    baseURL?: string;
+    /** Conductor config file to read `envs.DEEPSEEK_API_KEY` from. */
+    configPath?: string;
+    /** Cache TTL in seconds (default 60). */
+    ttlSeconds?: number;
+    /** Bypass the cache and always hit the network. */
+    forceRefresh?: boolean;
+    timeoutMs?: number;
+    cacheDir?: string;
+    /** Injected for tests. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Normalize the DeepSeek base URL for the balance endpoint. The inference
+ * base commonly carries a `/v1` suffix (it is an OpenAI-compatible route),
+ * but `/user/balance` lives at the host root, so the suffix is stripped.
+ */
+export declare function normalizeDshBaseUrl(baseURL: string | undefined): string;
+export declare function parseDshBalance(payload: DeepSeekBalanceResponse): {
+    isAvailable: boolean;
+    balances: DshBalanceInfo[];
+};
+/**
+ * Resolve the DeepSeek credential the way {@link DshSdkSession} does, so the
+ * balance shown here belongs to the account that actually serves turns:
+ * explicit option, then the conductor config's `envs` section, then the
+ * launching environment.
+ */
+export declare function resolveDeepSeekCredential(options?: Pick<DshQuotaOptions, "apiKey" | "baseURL" | "configPath">): Promise<{
+    apiKey: string;
+    baseURL: string;
+}>;
+/**
+ * Read the DeepSeek account balance. DeepSeek bills per token with no rolling
+ * usage window, so this reports prepaid balance instead of a percentage-based
+ * {@link QuotaWindow}. A stale cache entry is served when the network call
+ * fails, matching the other quota providers.
+ */
+export declare function getDshQuota(options?: DshQuotaOptions): Promise<DshQuota>;
+/** Read the last cached balance without touching the network. */
+export declare function readCachedDshQuota(options?: Pick<DshQuotaOptions, "apiKey" | "baseURL" | "configPath" | "cacheDir">): Promise<DshQuota | null>;
+export {};

package/dist/manager/quota/dsh.js

@@ -0,0 +1,146 @@
+import { readFile } from "node:fs/promises";
+import { parse as parseYaml } from "yaml";
+import { resolveDefaultConductorConfig } from "../paths.js";
+import { cacheFile, fingerprintKey, isFresh, readCache, writeCache } from "./cache.js";
+const DEFAULT_TTL = 60;
+const DEFAULT_TIMEOUT_MS = 10_000;
+const DEFAULT_BASE_URL = "https://api.deepseek.com";
+const BALANCE_PATH = "/user/balance";
+function toNumber(value) {
+    const parsed = typeof value === "number" ? value : Number.parseFloat(String(value ?? ""));
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+/**
+ * Normalize the DeepSeek base URL for the balance endpoint. The inference
+ * base commonly carries a `/v1` suffix (it is an OpenAI-compatible route),
+ * but `/user/balance` lives at the host root, so the suffix is stripped.
+ */
+export function normalizeDshBaseUrl(baseURL) {
+    const raw = typeof baseURL === "string" ? baseURL.trim() : "";
+    const base = raw || DEFAULT_BASE_URL;
+    return base.replace(/\/+$/, "").replace(/\/v\d+$/, "");
+}
+export function parseDshBalance(payload) {
+    const rawList = Array.isArray(payload?.balance_infos) ? payload.balance_infos : [];
+    const balances = rawList
+        .filter((entry) => Boolean(entry) && typeof entry === "object")
+        .map((entry) => ({
+        currency: typeof entry.currency === "string" ? entry.currency : "",
+        totalBalance: toNumber(entry.total_balance),
+        grantedBalance: toNumber(entry.granted_balance),
+        toppedUpBalance: toNumber(entry.topped_up_balance),
+    }));
+    return { isAvailable: payload?.is_available === true, balances };
+}
+/**
+ * Resolve the DeepSeek credential the way {@link DshSdkSession} does, so the
+ * balance shown here belongs to the account that actually serves turns:
+ * explicit option, then the conductor config's `envs` section, then the
+ * launching environment.
+ */
+export async function resolveDeepSeekCredential(options = {}) {
+    // `apiKey: ""` is an explicit refusal, distinct from an absent option.
+    const keyProvided = typeof options.apiKey === "string";
+    let apiKey = keyProvided ? options.apiKey.trim() : "";
+    let baseURL = typeof options.baseURL === "string" ? options.baseURL.trim() : "";
+    if (!keyProvided || !baseURL) {
+        const configPath = options.configPath ?? resolveDefaultConductorConfig();
+        try {
+            const doc = parseYaml(await readFile(configPath, "utf8"));
+            const envs = doc?.envs;
+            if (envs && typeof envs === "object") {
+                if (!keyProvided && typeof envs.DEEPSEEK_API_KEY === "string") {
+                    apiKey = envs.DEEPSEEK_API_KEY.trim();
+                }
+                if (!baseURL && typeof envs.DEEPSEEK_BASE_URL === "string") {
+                    baseURL = envs.DEEPSEEK_BASE_URL.trim();
+                }
+            }
+        }
+        catch {
+            // Missing or unreadable config: fall through to the environment.
+        }
+    }
+    if (!keyProvided && !apiKey && typeof process.env.DEEPSEEK_API_KEY === "string") {
+        apiKey = process.env.DEEPSEEK_API_KEY.trim();
+    }
+    if (!baseURL && typeof process.env.DEEPSEEK_BASE_URL === "string") {
+        baseURL = process.env.DEEPSEEK_BASE_URL.trim();
+    }
+    return { apiKey, baseURL: normalizeDshBaseUrl(baseURL) };
+}
+function emptyQuota(error, fetchedAt = Math.floor(Date.now() / 1000)) {
+    return {
+        tool: "dsh",
+        isAvailable: false,
+        balances: [],
+        fetchedAt,
+        source: "unknown",
+        error,
+    };
+}
+/**
+ * Read the DeepSeek account balance. DeepSeek bills per token with no rolling
+ * usage window, so this reports prepaid balance instead of a percentage-based
+ * {@link QuotaWindow}. A stale cache entry is served when the network call
+ * fails, matching the other quota providers.
+ */
+export async function getDshQuota(options = {}) {
+    const { apiKey, baseURL } = await resolveDeepSeekCredential(options);
+    if (!apiKey) {
+        return emptyQuota("DEEPSEEK_API_KEY is not configured; set envs.DEEPSEEK_API_KEY in the conductor config");
+    }
+    const ttlSeconds = options.ttlSeconds ?? DEFAULT_TTL;
+    const file = cacheFile("dsh", fingerprintKey([baseURL, apiKey]), options.cacheDir);
+    const cached = await readCache(file);
+    if (!options.forceRefresh && isFresh(cached, ttlSeconds)) {
+        return { ...cached.value, source: "cached" };
+    }
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    try {
+        const res = await fetchImpl(`${baseURL}${BALANCE_PATH}`, {
+            method: "GET",
+            headers: { Authorization: `Bearer ${apiKey}`, Accept: "application/json" },
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            throw new Error(`DeepSeek balance request failed with HTTP ${res.status}`);
+        }
+        const payload = (await res.json());
+        const { isAvailable, balances } = parseDshBalance(payload);
+        const quota = {
+            tool: "dsh",
+            isAvailable,
+            ...(balances[0] ? { primaryBalance: balances[0] } : {}),
+            balances,
+            fetchedAt: Math.floor(Date.now() / 1000),
+            source: "fresh",
+            raw: payload,
+        };
+        const entry = await writeCache(file, quota);
+        return { ...quota, fetchedAt: entry.fetchedAt };
+    }
+    catch (err) {
+        const message = err?.name === "AbortError" ? "timeout" : err?.message ?? String(err);
+        if (cached) {
+            return { ...cached.value, source: "stale", error: message };
+        }
+        return emptyQuota(message);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Read the last cached balance without touching the network. */
+export async function readCachedDshQuota(options = {}) {
+    const { apiKey, baseURL } = await resolveDeepSeekCredential(options);
+    if (!apiKey)
+        return null;
+    const file = cacheFile("dsh", fingerprintKey([baseURL, apiKey]), options.cacheDir);
+    const cached = await readCache(file);
+    if (!cached)
+        return null;
+    return { ...cached.value, fetchedAt: cached.fetchedAt, source: "cached" };
+}

package/dist/manager/types.d.ts

@@ -1,4 +1,4 @@
-export type Tool = "codex" | "claude" | "kimi" | "copilot";
+export type Tool = "codex" | "claude" | "kimi" | "copilot" | "dsh";
 export type QuotaSource = "fresh" | "cached" | "stale" | "unknown";
 export interface InstallStatus {
     installed: boolean;
@@ -106,6 +106,31 @@ export interface CopilotQuota {
     raw?: Record<string, unknown>;
     error?: string;
 }
+/** One currency bucket of a DeepSeek account balance. */
+export interface DshBalanceInfo {
+    currency: string;
+    totalBalance: number;
+    grantedBalance: number;
+    toppedUpBalance: number;
+}
+/**
+ * DeepSeek Harness account state. DeepSeek bills per token with no rolling
+ * usage window, so this carries a prepaid balance rather than a
+ * {@link QuotaWindow}: there is no percentage to render.
+ */
+export interface DshQuota {
+    tool: "dsh";
+    /** Whether DeepSeek considers the account usable for inference. */
+    isAvailable: boolean;
+    /** The account's primary balance bucket (first entry, usually CNY). */
+    primaryBalance?: DshBalanceInfo;
+    /** Every currency bucket the API reported. */
+    balances: DshBalanceInfo[];
+    fetchedAt: number;
+    source: QuotaSource;
+    raw?: Record<string, unknown>;
+    error?: string;
+}
 export interface ExternalQuota {
     backend?: string;
     model: string;

package/dist/media-adapters.d.ts

@@ -0,0 +1,34 @@
+export function buildCodexAppServerInput(promptText: any, media: any): any[];
+export function buildClaudeContent(promptText: any, media: any): any[];
+export function buildCopilotAttachments(media: any): any;
+export function buildKimiContent(promptText: any, media: any): any[];
+export function buildOpencodeParts(promptText: any, media: any): any[];
+export const UNSUPPORTED_MEDIA_CAPABILITIES: Readonly<{
+    image: "unsupported";
+}>;
+export const PROVIDER_MEDIA_CAPABILITIES: Readonly<{
+    "chat-web-session": Readonly<{
+        image: "unsupported";
+    }>;
+    "claude-agent-sdk": Readonly<{
+        image: "native";
+    }>;
+    "codex-app-server": Readonly<{
+        image: "native";
+    }>;
+    "codex-exec": Readonly<{
+        image: "native";
+    }>;
+    "copilot-sdk": Readonly<{
+        image: "native";
+    }>;
+    "kimi-cli-print": Readonly<{
+        image: "native";
+    }>;
+    "kimi-cli-wire": Readonly<{
+        image: "native";
+    }>;
+    "opencode-sdk": Readonly<{
+        image: "native";
+    }>;
+}>;

package/dist/media-adapters.js

@@ -0,0 +1,57 @@
+import { fileMediaToBase64, fileMediaToDataUri } from "./media-input.js";
+export const UNSUPPORTED_MEDIA_CAPABILITIES = Object.freeze({
+    image: "unsupported",
+});
+export const PROVIDER_MEDIA_CAPABILITIES = Object.freeze({
+    "chat-web-session": UNSUPPORTED_MEDIA_CAPABILITIES,
+    "claude-agent-sdk": Object.freeze({ image: "native" }),
+    "codex-app-server": Object.freeze({ image: "native" }),
+    "codex-exec": Object.freeze({ image: "native" }),
+    "copilot-sdk": Object.freeze({ image: "native" }),
+    "kimi-cli-print": Object.freeze({ image: "native" }),
+    "kimi-cli-wire": Object.freeze({ image: "native" }),
+    "opencode-sdk": Object.freeze({ image: "native" }),
+});
+export function buildCodexAppServerInput(promptText, media) {
+    return [
+        { type: "text", text: promptText },
+        ...media.map((item) => ({ type: "localImage", path: item.path })),
+    ];
+}
+export function buildClaudeContent(promptText, media) {
+    return [
+        { type: "text", text: promptText },
+        ...media.map((item) => ({
+            type: "image",
+            source: {
+                type: "base64",
+                media_type: item.mimeType,
+                data: fileMediaToBase64(item),
+            },
+        })),
+    ];
+}
+export function buildCopilotAttachments(media) {
+    return media.map((item) => ({
+        type: "file",
+        path: item.path,
+        displayName: item.name,
+    }));
+}
+export function buildKimiContent(promptText, media) {
+    return [
+        { type: "text", text: promptText },
+        ...media.map((item) => ({ type: "image_url", image_url: { url: fileMediaToDataUri(item) } })),
+    ];
+}
+export function buildOpencodeParts(promptText, media) {
+    return [
+        { type: "text", text: promptText },
+        ...media.map((item) => ({
+            type: "file",
+            mime: item.mimeType,
+            filename: item.name,
+            url: fileMediaToDataUri(item),
+        })),
+    ];
+}