@di-code/coding-agent 0.1.3 → 0.1.6

package/dist/startup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"AAEA,OAAO,EAON,KAAK,KAAK,EACV,KAAK,QAAQ,EACb,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,4BAA4B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,4BAA4B,EAAE,CAAC;CAC5D;AAQD,KAAK,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAehE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,CAE7E;AAmPD,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,SAAS,4BAA4B,EAAE,GAChD,cAAc,CAgBhB;AAED,wBAAsB,wBAAwB,CAC7C,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,WAAyB,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAuB/B;AAED,wBAAsB,sBAAsB,CAC3C,GAAG,EAAE,MAAM,EACX,WAAW,GAAE,WAAyB,GACpC,OAAO,CAAC,WAAW,CAAC,CAEtB"}
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../src/startup.ts"],"names":[],"mappings":"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"}

package/dist/startup.js

@@ -1,119 +1,397 @@
-import { readFile } from "node:fs/promises";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
 import { join } from "node:path";
-import { createAnthropicProvider, createDeepSeekProvider, createFauxProvider, createOpenAIProvider, createZhipuProvider, } from "@di-code/ai";
+import { createAnthropicProvider, createDeepSeekProvider, createFauxProvider, createKimiProvider, createOpenAIChatCompletionsProvider, createOpenAIProvider, createZhipuProvider, findBuiltinModel, } from "@di-code/ai";
+import { isLocale } from "./i18n.js";
 const FAUX_RESPONSES = [
-    { type: "success", content: [{ type: "text", text: "Faux response." }] },
+    {
+        type: "success",
+        content: [
+            {
+                type: "text",
+                text: "你好，我是di-code，一个面向终端的 TypeScript AI Coding Agent，支持多 Provider 流式对话、工具调用、JSONL 会话持久化、交互式 TUI、插件扩展与 JSONL RPC 集成。",
+            },
+        ],
+    },
+    { type: "success", content: [{ type: "text", text: "当前回复为faux数据" }] },
 ];
-const SETTINGS_PATH = join(".di-code", "settings.json");
+const SETTINGS_FILE_NAME = "settings.json";
+const SETTINGS_PATH = join(".di-code", SETTINGS_FILE_NAME);
 export function resolveStartupArgs(args) {
     return args.length === 0 ? ["--interactive"] : args;
 }
-function optionalString(value, path) {
+function optionalString(value, path, settingsPath) {
     if (value === undefined)
         return undefined;
     if (typeof value !== "string")
-        throw new Error(`${SETTINGS_PATH}: ${path} must be a string`);
+        throw new Error(`${settingsPath}: ${path} must be a string`);
     return value;
 }
-function requiredString(value, path) {
-    const result = optionalString(value, path);
+function requiredString(value, path, settingsPath = SETTINGS_PATH) {
+    const result = optionalString(value, path, settingsPath);
     if (!result?.trim())
-        throw new Error(`${SETTINGS_PATH}: ${path} must be a non-empty string`);
+        throw new Error(`${settingsPath}: ${path} must be a non-empty string`);
     return result.trim();
 }
-function positiveInteger(value, path, fallback) {
+function positiveInteger(value, path, fallback, settingsPath) {
     const result = value ?? fallback;
     if (!Number.isInteger(result) || result <= 0) {
-        throw new Error(`${SETTINGS_PATH}: ${path} must be a positive integer`);
+        throw new Error(`${settingsPath}: ${path} must be a positive integer`);
     }
     return result;
 }
-function nonNegativeNumber(value, path, fallback) {
+function nonNegativeNumber(value, path, fallback, settingsPath) {
     const result = value ?? fallback;
     if (typeof result !== "number" || !Number.isFinite(result) || result < 0) {
-        throw new Error(`${SETTINGS_PATH}: ${path} must be a non-negative finite number`);
+        throw new Error(`${settingsPath}: ${path} must be a non-negative finite number`);
     }
     return result;
 }
-function parseModels(value, path, providerId, providerApi, providerBaseUrl) {
+function parseChatCompletionsCompat(value, path, settingsPath) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new Error(`${settingsPath}: ${path} must be an object`);
+    }
+    const compat = value;
+    const optionalBoolean = (field) => {
+        const candidate = compat[field];
+        if (candidate === undefined)
+            return undefined;
+        if (typeof candidate !== "boolean")
+            throw new Error(`${settingsPath}: ${path}.${field} must be a boolean`);
+        return candidate;
+    };
+    const maxTokensField = compat.maxTokensField;
+    if (maxTokensField !== undefined && maxTokensField !== "max_tokens" && maxTokensField !== "max_completion_tokens") {
+        throw new Error(`${settingsPath}: ${path}.maxTokensField is invalid`);
+    }
+    const thinkingFormat = compat.thinkingFormat;
+    if (thinkingFormat !== undefined &&
+        thinkingFormat !== "zai" &&
+        thinkingFormat !== "deepseek" &&
+        thinkingFormat !== "kimi") {
+        throw new Error(`${settingsPath}: ${path}.thinkingFormat is invalid`);
+    }
+    const supportsUsageInStreaming = optionalBoolean("supportsUsageInStreaming");
+    const supportsReasoningEffort = optionalBoolean("supportsReasoningEffort");
+    const zaiToolStream = optionalBoolean("zaiToolStream");
+    return {
+        ...(maxTokensField === undefined ? {} : { maxTokensField }),
+        ...(thinkingFormat === undefined ? {} : { thinkingFormat }),
+        ...(supportsUsageInStreaming === undefined ? {} : { supportsUsageInStreaming }),
+        ...(supportsReasoningEffort === undefined ? {} : { supportsReasoningEffort }),
+        ...(zaiToolStream === undefined ? {} : { zaiToolStream }),
+    };
+}
+function parseModels(value, path, providerId, providerApi, providerBaseUrl, settingsPath) {
     if (value === undefined)
         return undefined;
     if (!Array.isArray(value))
-        throw new Error(`${SETTINGS_PATH}: ${path} must be an array`);
+        throw new Error(`${settingsPath}: ${path} must be an array`);
     return value.map((entry, index) => {
         const modelPath = `${path}[${index}]`;
         if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-            throw new Error(`${SETTINGS_PATH}: ${modelPath} must be an object`);
+            throw new Error(`${settingsPath}: ${modelPath} must be an object`);
         }
         const model = entry;
         const input = model.input ?? ["text"];
         if (!Array.isArray(input) || input.length === 0 || input.some((item) => item !== "text" && item !== "image")) {
-            throw new Error(`${SETTINGS_PATH}: ${modelPath}.input must contain text and/or image`);
+            throw new Error(`${settingsPath}: ${modelPath}.input must contain text and/or image`);
         }
         const cost = model.cost ?? {};
         if (typeof cost !== "object" || cost === null || Array.isArray(cost)) {
-            throw new Error(`${SETTINGS_PATH}: ${modelPath}.cost must be an object`);
+            throw new Error(`${settingsPath}: ${modelPath}.cost must be an object`);
         }
         const prices = cost;
         if (model.reasoning !== undefined && typeof model.reasoning !== "boolean") {
-            throw new Error(`${SETTINGS_PATH}: ${modelPath}.reasoning must be a boolean`);
+            throw new Error(`${settingsPath}: ${modelPath}.reasoning must be a boolean`);
+        }
+        const configuredReasoningEfforts = model.reasoningEfforts;
+        if (configuredReasoningEfforts !== undefined) {
+            if (!Array.isArray(configuredReasoningEfforts) || configuredReasoningEfforts.length === 0) {
+                throw new Error(`${settingsPath}: ${modelPath}.reasoningEfforts must be a non-empty array`);
+            }
+            if (model.reasoning !== true ||
+                configuredReasoningEfforts.some((effort) => effort !== "low" && effort !== "medium" && effort !== "high" && effort !== "max") ||
+                new Set(configuredReasoningEfforts).size !== configuredReasoningEfforts.length) {
+                throw new Error(`${settingsPath}: ${modelPath}.reasoningEfforts requires reasoning=true and unique low, medium, high, or max values`);
+            }
         }
         if (model.cacheRetention !== undefined && model.cacheRetention !== "long") {
-            throw new Error(`${SETTINGS_PATH}: ${modelPath}.cacheRetention must be "long" when provided`);
+            throw new Error(`${settingsPath}: ${modelPath}.cacheRetention must be "long" when provided`);
         }
         if (model.sessionAffinity !== undefined && model.sessionAffinity !== "codex") {
-            throw new Error(`${SETTINGS_PATH}: ${modelPath}.sessionAffinity must be "codex" when provided`);
+            throw new Error(`${settingsPath}: ${modelPath}.sessionAffinity must be "codex" when provided`);
         }
-        const api = optionalString(model.api, `${modelPath}.api`) ?? providerApi;
+        const api = optionalString(model.api, `${modelPath}.api`, settingsPath) ?? providerApi;
         if (!api)
-            throw new Error(`${SETTINGS_PATH}: ${modelPath}.api is required`);
-        const baseUrl = optionalString(model.baseUrl, `${modelPath}.baseUrl`) ?? providerBaseUrl;
-        const id = requiredString(model.id, `${modelPath}.id`);
+            throw new Error(`${settingsPath}: ${modelPath}.api is required`);
+        if (!["faux", "openai-responses", "openai-chat-completions", "anthropic-messages"].includes(api)) {
+            throw new Error(`${settingsPath}: ${modelPath}.api is unsupported`);
+        }
+        const typedApi = api;
+        const reasoningEfforts = configuredReasoningEfforts === undefined && model.reasoning === true && api === "openai-responses"
+            ? ["low", "medium", "high"]
+            : configuredReasoningEfforts === undefined
+                ? undefined
+                : [...configuredReasoningEfforts];
+        const baseUrl = optionalString(model.baseUrl, `${modelPath}.baseUrl`, settingsPath) ?? providerBaseUrl;
+        const id = requiredString(model.id, `${modelPath}.id`, settingsPath);
+        const chatCompletionsCompat = parseChatCompletionsCompat(model.chatCompletionsCompat, `${modelPath}.chatCompletionsCompat`, settingsPath);
+        if (chatCompletionsCompat !== undefined && typedApi !== "openai-chat-completions") {
+            throw new Error(`${settingsPath}: ${modelPath}.chatCompletionsCompat requires api "openai-chat-completions"`);
+        }
         return {
             id,
-            name: requiredString(model.name ?? id, `${modelPath}.name`),
+            name: requiredString(model.name ?? id, `${modelPath}.name`, settingsPath),
             provider: providerId,
-            api,
+            api: typedApi,
             ...(baseUrl === undefined ? {} : { baseUrl }),
             input: [...input],
             reasoning: model.reasoning ?? false,
+            ...(reasoningEfforts ? { reasoningEfforts } : {}),
+            ...(chatCompletionsCompat ? { chatCompletionsCompat } : {}),
             ...(model.cacheRetention === "long" ? { cacheRetention: "long" } : {}),
             ...(model.sessionAffinity === "codex" ? { sessionAffinity: "codex" } : {}),
-            contextWindow: positiveInteger(model.contextWindow, `${modelPath}.contextWindow`, 128_000),
-            maxOutputTokens: positiveInteger(model.maxTokens ?? model.maxOutputTokens, `${modelPath}.maxTokens`, 16_384),
+            contextWindow: positiveInteger(model.contextWindow, `${modelPath}.contextWindow`, 128_000, settingsPath),
+            maxOutputTokens: positiveInteger(model.maxTokens ?? model.maxOutputTokens, `${modelPath}.maxTokens`, 16_384, settingsPath),
             cost: {
-                input: nonNegativeNumber(prices.input, `${modelPath}.cost.input`, 0) / 1_000_000,
-                output: nonNegativeNumber(prices.output, `${modelPath}.cost.output`, 0) / 1_000_000,
-                cacheRead: nonNegativeNumber(prices.cacheRead, `${modelPath}.cost.cacheRead`, 0) / 1_000_000,
-                cacheWrite: nonNegativeNumber(prices.cacheWrite, `${modelPath}.cost.cacheWrite`, 0) / 1_000_000,
+                input: nonNegativeNumber(prices.input, `${modelPath}.cost.input`, 0, settingsPath) / 1_000_000,
+                output: nonNegativeNumber(prices.output, `${modelPath}.cost.output`, 0, settingsPath) / 1_000_000,
+                cacheRead: nonNegativeNumber(prices.cacheRead, `${modelPath}.cost.cacheRead`, 0, settingsPath) / 1_000_000,
+                cacheWrite: nonNegativeNumber(prices.cacheWrite, `${modelPath}.cost.cacheWrite`, 0, settingsPath) / 1_000_000,
             },
         };
     });
 }
-function parseSettings(value) {
+/** Validates a Custom onboarding endpoint without issuing a network request. */
+export function validateCustomBaseUrl(value) {
+    const baseUrl = value.trim();
+    if (!baseUrl)
+        throw new Error("Base URL cannot be empty.");
+    let url;
+    try {
+        url = new URL(baseUrl);
+    }
+    catch {
+        throw new Error("Base URL must be an absolute http or https URL.");
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+        throw new Error("Base URL must use http or https.");
+    if (url.username || url.password || url.search || url.hash) {
+        throw new Error("Base URL must not contain credentials, query, or hash.");
+    }
+    if (baseUrl.endsWith("/"))
+        throw new Error("Base URL must not end with /.");
+    return baseUrl;
+}
+function requireCustomValue(value, field) {
+    const trimmed = value.trim();
+    if (!trimmed)
+        throw new Error(`${field === "apiKey" ? "API key" : "Model ID"} cannot be empty.`);
+    return trimmed;
+}
+/** Builds the single user-managed Custom provider from validated onboarding input. */
+export function createCustomProviderConfiguration(input) {
+    const baseUrl = validateCustomBaseUrl(input.baseUrl);
+    const modelId = requireCustomValue(input.modelId, "modelId");
+    const apiKey = requireCustomValue(input.apiKey, "apiKey");
+    const known = findBuiltinModel(input.api, modelId);
+    const model = known
+        ? {
+            ...known,
+            id: modelId,
+            provider: "custom",
+            api: input.api,
+            baseUrl,
+        }
+        : {
+            id: modelId,
+            name: modelId,
+            provider: "custom",
+            api: input.api,
+            baseUrl,
+            input: ["text"],
+            reasoning: false,
+            contextWindow: 128_000,
+            maxOutputTokens: 16_384,
+            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        };
+    return { id: "custom", name: "Custom", api: input.api, apiKey, baseUrl, models: [model] };
+}
+function serializeModel(model) {
+    return {
+        id: model.id,
+        name: model.name,
+        input: model.input,
+        reasoning: model.reasoning,
+        ...(model.reasoningEfforts ? { reasoningEfforts: model.reasoningEfforts } : {}),
+        ...(model.chatCompletionsCompat ? { chatCompletionsCompat: model.chatCompletionsCompat } : {}),
+        ...(model.cacheRetention ? { cacheRetention: model.cacheRetention } : {}),
+        ...(model.sessionAffinity ? { sessionAffinity: model.sessionAffinity } : {}),
+        contextWindow: model.contextWindow,
+        maxTokens: model.maxOutputTokens,
+        cost: Object.fromEntries(Object.entries(model.cost).map(([key, value]) => [key, value * 1_000_000])),
+    };
+}
+function parseSettings(value, settingsPath) {
     if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        throw new Error(`${SETTINGS_PATH}: root value must be an object`);
+        throw new Error(`${settingsPath}: root value must be an object`);
     }
     const record = value;
     const providersValue = record.providers;
     if (typeof providersValue !== "object" || providersValue === null || Array.isArray(providersValue)) {
-        throw new Error(`${SETTINGS_PATH}: providers must be an object`);
+        throw new Error(`${settingsPath}: providers must be an object`);
     }
     const providers = {};
     for (const [id, entry] of Object.entries(providersValue)) {
         if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
-            throw new Error(`${SETTINGS_PATH}: providers.${id} must be an object`);
+            throw new Error(`${settingsPath}: providers.${id} must be an object`);
         }
         const provider = entry;
         providers[id] = {
-            name: optionalString(provider.name, `providers.${id}.name`),
-            baseUrl: optionalString(provider.baseUrl, `providers.${id}.baseUrl`),
-            apiKey: optionalString(provider.apiKey, `providers.${id}.apiKey`),
-            api: optionalString(provider.api, `providers.${id}.api`),
+            name: optionalString(provider.name, `providers.${id}.name`, settingsPath),
+            baseUrl: optionalString(provider.baseUrl, `providers.${id}.baseUrl`, settingsPath),
+            apiKey: optionalString(provider.apiKey, `providers.${id}.apiKey`, settingsPath),
+            api: optionalString(provider.api, `providers.${id}.api`, settingsPath),
             models: provider.models,
         };
     }
-    return { providers };
+    const defaultProvider = record.defaultProvider === undefined
+        ? undefined
+        : requiredString(record.defaultProvider, "defaultProvider", settingsPath);
+    const defaultModel = record.defaultModel === undefined ? undefined : requiredString(record.defaultModel, "defaultModel", settingsPath);
+    if (record.locale !== undefined && !isLocale(record.locale)) {
+        throw new Error(`${settingsPath}: locale must be "en" or "zh-CN"`);
+    }
+    return {
+        providers,
+        ...(defaultProvider === undefined ? {} : { defaultProvider }),
+        ...(defaultModel === undefined ? {} : { defaultModel }),
+        ...(record.locale === undefined ? {} : { locale: record.locale }),
+    };
+}
+async function readSettingsFile(path, displayPath) {
+    try {
+        const source = await readFile(path, "utf8");
+        if (source.trim().length === 0)
+            return undefined;
+        return parseSettings(JSON.parse(source), displayPath);
+    }
+    catch (cause) {
+        if (cause instanceof Error && "code" in cause && cause.code === "ENOENT")
+            return undefined;
+        if (cause instanceof SyntaxError)
+            throw new Error(`${displayPath}: invalid JSON`, { cause });
+        throw cause;
+    }
+}
+function mergeSettings(globalSettings, projectSettings) {
+    const globalProviders = globalSettings?.providers ?? {};
+    const projectProviders = projectSettings?.providers ?? {};
+    const providers = { ...globalProviders };
+    for (const [id, projectProvider] of Object.entries(projectProviders)) {
+        providers[id] = {
+            ...globalProviders[id],
+            ...(projectProvider.name === undefined ? {} : { name: projectProvider.name }),
+            ...(projectProvider.baseUrl === undefined ? {} : { baseUrl: projectProvider.baseUrl }),
+            ...(projectProvider.apiKey === undefined ? {} : { apiKey: projectProvider.apiKey }),
+            ...(projectProvider.api === undefined ? {} : { api: projectProvider.api }),
+            ...(projectProvider.models === undefined ? {} : { models: projectProvider.models }),
+        };
+    }
+    const defaultProvider = projectSettings?.defaultProvider ?? globalSettings?.defaultProvider;
+    const defaultModel = projectSettings?.defaultModel ??
+        (projectSettings?.defaultProvider === undefined ? globalSettings?.defaultModel : undefined);
+    const locale = globalSettings?.locale;
+    return {
+        providers,
+        ...(defaultProvider === undefined ? {} : { defaultProvider }),
+        ...(defaultModel === undefined ? {} : { defaultModel }),
+        ...(locale === undefined ? {} : { locale }),
+    };
+}
+/** Persists a user-level terminal language preference without changing project settings. */
+export async function saveGlobalLocale(agentDir, locale) {
+    const settingsFilePath = join(agentDir, SETTINGS_FILE_NAME);
+    const existingSettings = await readSettingsFile(settingsFilePath, settingsFilePath);
+    const settings = {
+        providers: existingSettings?.providers ?? {},
+        ...(existingSettings?.defaultProvider === undefined ? {} : { defaultProvider: existingSettings.defaultProvider }),
+        ...(existingSettings?.defaultModel === undefined ? {} : { defaultModel: existingSettings.defaultModel }),
+        locale,
+    };
+    await mkdir(agentDir, { recursive: true, mode: 0o700 });
+    await writeFile(settingsFilePath, `${JSON.stringify(settings, null, "\t")}\n`, { encoding: "utf8", mode: 0o600 });
+}
+export async function saveGlobalProviderApiKey(agentDir, providerId, api, apiKey, modelId) {
+    const settingsFilePath = join(agentDir, SETTINGS_FILE_NAME);
+    const trimmedApiKey = apiKey.trim();
+    if (!trimmedApiKey)
+        throw new Error(`${settingsFilePath}: apiKey must be a non-empty string`);
+    const existingSettings = await readSettingsFile(settingsFilePath, settingsFilePath);
+    const settings = mergeSettings(existingSettings, {
+        providers: { [providerId]: { api, apiKey: trimmedApiKey } },
+        defaultProvider: providerId,
+        ...(modelId === undefined ? {} : { defaultModel: modelId }),
+    });
+    await mkdir(agentDir, { recursive: true, mode: 0o700 });
+    await writeFile(settingsFilePath, `${JSON.stringify(settings, null, "\t")}\n`, { encoding: "utf8", mode: 0o600 });
+}
+/**
+ * Replaces the user-managed `custom` provider while retaining other global
+ * providers and preferences. The key is intentionally stored only here, never
+ * in project settings or process environment.
+ */
+export async function saveGlobalCustomProvider(agentDir, input) {
+    const configuration = createCustomProviderConfiguration(input);
+    const settingsFilePath = join(agentDir, SETTINGS_FILE_NAME);
+    const existingSettings = await readSettingsFile(settingsFilePath, settingsFilePath);
+    const settings = mergeSettings(existingSettings, {
+        providers: {
+            custom: {
+                name: configuration.name,
+                api: configuration.api,
+                baseUrl: configuration.baseUrl,
+                apiKey: configuration.apiKey,
+                models: configuration.models?.map(serializeModel),
+            },
+        },
+        defaultProvider: "custom",
+        defaultModel: configuration.models?.[0]?.id,
+    });
+    await mkdir(agentDir, { recursive: true, mode: 0o700 });
+    await writeFile(settingsFilePath, `${JSON.stringify(settings, null, "\t")}\n`, { encoding: "utf8", mode: 0o600 });
+    return configuration;
+}
+/**
+ * Removes one persisted credential and clears it as the default when applicable.
+ * Environment variables and other Provider configuration remain untouched.
+ */
+export async function removeGlobalProviderApiKey(agentDir, providerId) {
+    const settingsFilePath = join(agentDir, SETTINGS_FILE_NAME);
+    const existingSettings = await readSettingsFile(settingsFilePath, settingsFilePath);
+    const provider = existingSettings?.providers[providerId];
+    if (!provider || provider.apiKey === undefined)
+        return false;
+    const { apiKey: _apiKey, ...providerWithoutApiKey } = provider;
+    const clearsDefault = existingSettings.defaultProvider === providerId;
+    const settings = {
+        providers: {
+            ...existingSettings.providers,
+            [providerId]: providerWithoutApiKey,
+        },
+        ...(clearsDefault || existingSettings.defaultProvider === undefined
+            ? {}
+            : { defaultProvider: existingSettings.defaultProvider }),
+        ...(clearsDefault || existingSettings.defaultModel === undefined
+            ? {}
+            : { defaultModel: existingSettings.defaultModel }),
+        ...(existingSettings.locale === undefined ? {} : { locale: existingSettings.locale }),
+    };
+    await writeFile(settingsFilePath, `${JSON.stringify(settings, null, "\t")}\n`, { encoding: "utf8", mode: 0o600 });
+    return true;
 }
 function resolveConfigValue(value, env) {
     if (value === undefined)
@@ -144,7 +422,9 @@ function selectProviderModel(provider, providerId, env) {
                 ? provider.models.find((candidate) => candidate.id === "gpt-4o")?.id
                 : providerId === "zhipu"
                     ? provider.models.find((candidate) => candidate.id === "glm-5.3")?.id
-                    : undefined) ||
+                    : providerId === "kimi"
+                        ? provider.models.find((candidate) => candidate.id === "k3")?.id
+                        : undefined) ||
         provider.models[0]?.id;
     if (!modelId)
         throw new Error("DI_CODE_MODEL is required when the selected provider has no models");
@@ -172,62 +452,96 @@ function createBuiltInRuntime(env, providerId) {
         const provider = createZhipuProvider({ env });
         return { provider, model: selectProviderModel(provider, providerId, env) };
     }
+    if (providerId === "kimi") {
+        const provider = createKimiProvider({ env });
+        return { provider, model: selectProviderModel(provider, providerId, env) };
+    }
     return undefined;
 }
 function createConfiguredRuntime(env, configuration) {
     if (configuration.api !== "openai-responses" &&
-        configuration.api !== "deepseek-responses" &&
-        configuration.api !== "zhipu-chat-completions" &&
+        configuration.api !== "openai-chat-completions" &&
         configuration.api !== "anthropic-messages") {
-        throw new Error(`Unsupported API "${configuration.api ?? "missing"}" for provider "${configuration.id}". Expected openai-responses, deepseek-responses, zhipu-chat-completions, or anthropic-messages.`);
+        throw new Error(`Unsupported API "${configuration.api ?? "missing"}" for provider "${configuration.id}". Expected openai-responses, openai-chat-completions, or anthropic-messages.`);
     }
     if (configuration.id !== "openai" &&
         configuration.id !== "deepseek" &&
         configuration.id !== "zhipu" &&
+        configuration.id !== "kimi" &&
         configuration.id !== "anthropic" &&
         !configuration.models) {
         throw new Error(`${SETTINGS_PATH}: providers.${configuration.id}.models is required for a custom provider`);
     }
-    const provider = configuration.api === "anthropic-messages"
-        ? createAnthropicProvider({
-            env: configuration.id === "anthropic"
+    const provider = configuration.api === "openai-chat-completions"
+        ? createOpenAIChatCompletionsProvider({
+            env: configuration.id === "zhipu" || configuration.id === "deepseek" || configuration.id === "kimi"
                 ? env
-                : Object.fromEntries(Object.entries(env).filter(([name]) => name !== "ANTHROPIC_API_KEY" && name !== "ANTHROPIC_BASE_URL")),
+                : Object.fromEntries(Object.entries(env).filter(([name]) => name !== "OPENAI_API_KEY" && name !== "OPENAI_BASE_URL")),
             models: configuration.models,
             apiKey: resolveConfigValue(configuration.apiKey, env),
             baseUrl: configuration.models ? undefined : configuration.baseUrl,
             providerId: configuration.id,
-            name: configuration.name,
+            name: configuration.name ?? configuration.id,
+            ...(configuration.id === "zhipu"
+                ? {
+                    apiKeyEnvironmentVariable: "ZAI_API_KEY",
+                    baseUrlEnvironmentVariable: "ZHIPU_BASE_URL",
+                    defaultBaseUrl: "https://open.bigmodel.cn/api/coding/paas/v4",
+                }
+                : configuration.id === "deepseek"
+                    ? {
+                        apiKeyEnvironmentVariable: "DEEPSEEK_API_KEY",
+                        baseUrlEnvironmentVariable: "DEEPSEEK_BASE_URL",
+                        defaultBaseUrl: "https://api.deepseek.com",
+                    }
+                    : configuration.id === "kimi"
+                        ? {
+                            apiKeyEnvironmentVariable: "KIMI_API_KEY",
+                            baseUrlEnvironmentVariable: "KIMI_BASE_URL",
+                            defaultBaseUrl: "https://api.kimi.com/coding/v1",
+                        }
+                        : {}),
         })
-        : configuration.id === "deepseek"
-            ? createDeepSeekProvider({
-                env,
+        : configuration.api === "anthropic-messages"
+            ? createAnthropicProvider({
+                env: configuration.id === "anthropic"
+                    ? env
+                    : Object.fromEntries(Object.entries(env).filter(([name]) => name !== "ANTHROPIC_API_KEY" && name !== "ANTHROPIC_BASE_URL")),
                 models: configuration.models,
                 apiKey: resolveConfigValue(configuration.apiKey, env),
                 baseUrl: configuration.models ? undefined : configuration.baseUrl,
+                providerId: configuration.id,
+                name: configuration.name,
             })
-            : configuration.id === "zhipu"
-                ? createZhipuProvider({
+            : configuration.id === "deepseek"
+                ? createDeepSeekProvider({
                     env,
                     models: configuration.models,
                     apiKey: resolveConfigValue(configuration.apiKey, env),
                     baseUrl: configuration.models ? undefined : configuration.baseUrl,
                 })
-                : createOpenAIProvider({
-                    env: configuration.id === "openai"
-                        ? env
-                        : Object.fromEntries(Object.entries(env).filter(([name]) => name !== "OPENAI_API_KEY" && name !== "OPENAI_BASE_URL")),
-                    models: configuration.models,
-                    apiKey: resolveConfigValue(configuration.apiKey, env),
-                    baseUrl: configuration.models ? undefined : configuration.baseUrl,
-                    providerId: configuration.id,
-                    name: configuration.name,
-                });
+                : configuration.id === "zhipu"
+                    ? createZhipuProvider({
+                        env,
+                        models: configuration.models,
+                        apiKey: resolveConfigValue(configuration.apiKey, env),
+                        baseUrl: configuration.models ? undefined : configuration.baseUrl,
+                    })
+                    : createOpenAIProvider({
+                        env: configuration.id === "openai"
+                            ? env
+                            : Object.fromEntries(Object.entries(env).filter(([name]) => name !== "OPENAI_API_KEY" && name !== "OPENAI_BASE_URL")),
+                        models: configuration.models,
+                        apiKey: resolveConfigValue(configuration.apiKey, env),
+                        baseUrl: configuration.models ? undefined : configuration.baseUrl,
+                        providerId: configuration.id,
+                        name: configuration.name,
+                    });
     const model = selectProviderModel(provider, configuration.id, env);
     return { provider, model };
 }
-export function resolveStartupRuntime(env, providers) {
-    const selectedProviderId = env.DI_CODE_PROVIDER?.trim() || (providers.length === 1 ? providers[0]?.id : undefined);
+export function resolveStartupRuntime(env, providers, defaults = {}) {
+    const selectedProviderId = env.DI_CODE_PROVIDER?.trim() || defaults.providerId || (providers.length === 1 ? providers[0]?.id : undefined);
     if (selectedProviderId === "faux")
         return createFauxRuntime();
     if (!selectedProviderId) {
@@ -236,29 +550,26 @@ export function resolveStartupRuntime(env, providers) {
         }
         throw new Error("DI_CODE_PROVIDER is required when more than one provider is configured.");
     }
+    const runtimeEnvironment = env.DI_CODE_MODEL?.trim() || defaults.providerId !== selectedProviderId || !defaults.modelId
+        ? env
+        : { ...env, DI_CODE_MODEL: defaults.modelId };
     const selectedProvider = providers.find((provider) => provider.id === selectedProviderId);
     if (selectedProvider)
-        return createConfiguredRuntime(env, selectedProvider);
-    const builtInRuntime = createBuiltInRuntime(env, selectedProviderId);
+        return createConfiguredRuntime(runtimeEnvironment, selectedProvider);
+    const builtInRuntime = createBuiltInRuntime(runtimeEnvironment, selectedProviderId);
     if (builtInRuntime)
         return builtInRuntime;
     throw new Error(`Unknown configured provider "${selectedProviderId}". Available providers: ${providers.map((provider) => provider.id).join(", ")}.`);
 }
-export async function loadStartupConfiguration(cwd, environment = process.env) {
-    let settings;
-    try {
-        const source = await readFile(join(cwd, SETTINGS_PATH), "utf8");
-        if (source.trim().length === 0)
-            return { environment, providers: [] };
-        settings = parseSettings(JSON.parse(source));
-    }
-    catch (cause) {
-        if (cause instanceof Error && "code" in cause && cause.code === "ENOENT") {
-            return { environment, providers: [] };
-        }
-        if (cause instanceof SyntaxError)
-            throw new Error(`${SETTINGS_PATH}: invalid JSON`, { cause });
-        throw cause;
+export async function loadStartupConfiguration(cwd, environment = process.env, agentDir = join(homedir(), ".di-code")) {
+    const [globalSettings, projectSettings] = await Promise.all([
+        readSettingsFile(join(agentDir, SETTINGS_FILE_NAME), join(agentDir, SETTINGS_FILE_NAME)),
+        readSettingsFile(join(cwd, SETTINGS_PATH), SETTINGS_PATH),
+    ]);
+    const settings = mergeSettings(globalSettings, projectSettings);
+    const requestedLocale = environment.DI_CODE_LOCALE?.trim();
+    if (requestedLocale !== undefined && requestedLocale !== "" && !isLocale(requestedLocale)) {
+        throw new Error('DI_CODE_LOCALE must be "en" or "zh-CN".');
     }
     const providers = Object.entries(settings.providers).map(([id, provider]) => ({
         id: requiredString(id, `providers.${id}`),
@@ -266,9 +577,18 @@ export async function loadStartupConfiguration(cwd, environment = process.env) {
         api: provider.api,
         apiKey: provider.apiKey,
         baseUrl: provider.baseUrl,
-        models: parseModels(provider.models, `providers.${id}.models`, id, provider.api, provider.baseUrl),
+        models: parseModels(provider.models, `providers.${id}.models`, id, provider.api, provider.baseUrl, SETTINGS_PATH),
     }));
-    return { environment, providers };
+    const defaults = settings.defaultProvider === undefined && settings.defaultModel === undefined
+        ? undefined
+        : { providerId: settings.defaultProvider, modelId: settings.defaultModel };
+    const locale = requestedLocale && isLocale(requestedLocale) ? requestedLocale : settings.locale;
+    return {
+        environment,
+        providers,
+        ...(locale === undefined ? {} : { locale }),
+        ...(defaults === undefined ? {} : { defaults }),
+    };
 }
 export async function loadStartupEnvironment(cwd, environment = process.env) {
     return (await loadStartupConfiguration(cwd, environment)).environment;