u1s1-cli-cn 1.18.0 → 1.20.0

package/dist/agents/agent-config.d.ts

@@ -1,5 +1,5 @@
 import { type RuntimeBrake } from "./runtime.js";
-export type GatewayAgentName = "claude-code" | "codex" | "pi";
+export type GatewayAgentName = "claude-code" | "codex" | "dsh" | "pi";
 export interface AgentModel {
     id: string;
     name: string;

package/dist/agents/agent-config.js

@@ -4,7 +4,7 @@
  * 契约(网关 workers/gateway/src/agent-config.ts):
  *   { agent, enabled, disabled_reason, runtime: { min_version, max_tested_version, blocked_versions },
  *     default_model, small_model, models: [...], settings }
- * default_model / small_model 在没有模型时是 null;settings 只在 claude-code 启用时是对象,其余 null。
+ * default_model / small_model 在没有模型时是 null;settings 在 claude-code / codex / dsh 启用时是对象(各客户端自己的形状),其余 null。
  * 响应里没有任何凭证或端点:地址和本地 token 由启动器自己注入。
  *
  * 结果处理:

package/dist/agents/claude.d.ts

@@ -1,5 +1,6 @@
 import { type McpLaunchEnv } from "../mcp-server.js";
 import { type AgentConfig } from "./agent-config.js";
+import { type AgentCustomModel } from "./custom-models.js";
 import { type RuntimePaths } from "./runtime.js";
 export { agentsRoot, CLAUDE_TERMS_URL, cliInstallHooks, consentLines, notOpenText, overMaxTestedText, printRuntimeFailure, runtimeErrorText, spawnAgent, } from "./launch.js";
 export declare const CLAUDE_GATEWAY_AGENT: "claude-code";
@@ -72,7 +73,9 @@ export declare function sanitizeClaudeSettings(settings: Record<string, unknown>
  * model 用调用方选好的(用户在 u1s1 config 里定的、仍在阵容里的模型),没给时保留网关的,
  * 网关也没有就用 default_model。
  */
-export declare function claudeSettingsFromConfig(config: AgentConfig, model?: string | null): Record<string, unknown>;
+export declare function claudeSettingsFromConfig(config: AgentConfig, model?: string | null, 
+/** 自定义端点模型:接在 /model 列表后面(custom-models.ts withCustomClaudeModels) */
+customModels?: readonly AgentCustomModel[]): Record<string, unknown>;
 /** 调用方的 --settings 有问题(缺值、读不了、不是 JSON 对象);runClaude 报出来后以非 0 退出。 */
 export declare class ClaudeSettingsArgError extends Error {
     name: string;

package/dist/agents/claude.js

@@ -22,6 +22,7 @@ import { join, resolve } from "node:path";
 import { writePrivateFile } from "../config.js";
 import { lang, tr } from "../i18n.js";
 import { MCP_ENV_NAMES, MCP_SERVER_NAME, MCP_TRACE_ENV, mcpInjectionDisabled, mcpLaunchEnv, mcpServerCommand, } from "../mcp-server.js";
+import { withCustomClaudeModels } from "./custom-models.js";
 import { AGENT_PROFILES, agentsRoot, prepareAgentLaunch, runPreparedAgent, } from "./launch.js";
 import { runtimePaths } from "./runtime.js";
 import { stripSecretEnv } from "../secret-env.js";
@@ -198,13 +199,15 @@ export function sanitizeClaudeSettings(settings) {
  * model 用调用方选好的(用户在 u1s1 config 里定的、仍在阵容里的模型),没给时保留网关的,
  * 网关也没有就用 default_model。
  */
-export function claudeSettingsFromConfig(config, model) {
+export function claudeSettingsFromConfig(config, model, 
+/** 自定义端点模型:接在 /model 列表后面(custom-models.ts withCustomClaudeModels) */
+customModels = []) {
     const out = sanitizeClaudeSettings(config.settings ?? {});
     if (model)
         out["model"] = model;
     else if (out["model"] === undefined && config.defaultModel)
         out["model"] = config.defaultModel;
-    return out;
+    return withCustomClaudeModels(out, customModels, out["model"]);
 }
 // ---------------------------------------------------------------- 调用方的 --settings
 /** 调用方的 --settings 有问题(缺值、读不了、不是 JSON 对象);runClaude 报出来后以非 0 退出。 */
@@ -385,7 +388,7 @@ export async function runClaude(userArgs) {
     const mcp = mcpInjectionDisabled()
         ? undefined
         : mcpLaunchEnv({ proxyBaseUrl: prepared.proxy.baseUrl, localToken: prepared.proxy.localKey, features: prepared.features, lang: lang() });
-    const settings = claudeSettingsFromConfig(prepared.config, prepared.model);
+    const settings = claudeSettingsFromConfig(prepared.config, prepared.model, prepared.customModels);
     cleanStaleSettingsFiles(paths.root);
     const settingsFile = callerSettings.length ? processSettingsFile(paths) : paths.settingsFile;
     writeClaudeSettings(settingsFile, finalClaudeSettings(settings, callerSettings, !!mcp));

package/dist/agents/codex.d.ts

@@ -1,5 +1,6 @@
 import { type McpLaunchEnv } from "../mcp-server.js";
 import type { AgentConfig } from "./agent-config.js";
+import { type AgentCustomModel } from "./custom-models.js";
 import { type RuntimePaths } from "./runtime.js";
 export declare const CODEX_GATEWAY_AGENT: "codex";
 /** config.toml 里我们的 provider id(不能用 openai、ollama 等内置保留名)。 */
@@ -98,7 +99,9 @@ export declare function modelCatalogFromConfig(config: AgentConfig): Record<stri
  */
 export declare function writeCodexConfig(paths: CodexPaths, config: AgentConfig, now?: () => number, mcp?: CodexMcpServer | null, 
 /** 这次启动用的模型(launch.ts 按 u1s1 config 选好);undefined = 网关默认 */
-model?: string | null): string | undefined;
+model?: string | null, 
+/** 自定义端点模型:接在网关目录后面(custom-models.ts withCustomCodexCatalog) */
+customModels?: readonly AgentCustomModel[]): string | undefined;
 /** [mcp_servers.u1s1] 的内容:同一个 node、同一份 CLI;只列要转发的变量名。 */
 export declare function codexMcpServer(command?: {
     command: string;

package/dist/agents/codex.js

@@ -25,6 +25,7 @@ import { writePrivateFile } from "../config.js";
 import { lang, tr } from "../i18n.js";
 import { MCP_ENV_NAMES, MCP_SERVER_NAME, MCP_TRACE_ENV, mcpInjectionDisabled, mcpLaunchEnv, mcpServerCommand, } from "../mcp-server.js";
 import { stripSecretEnv } from "../secret-env.js";
+import { withCustomCodexCatalog } from "./custom-models.js";
 import { AGENT_PROFILES, agentsRoot, prepareAgentLaunch, runPreparedAgent } from "./launch.js";
 import { runtimePaths } from "./runtime.js";
 export const CODEX_GATEWAY_AGENT = "codex";
@@ -334,9 +335,11 @@ export function modelCatalogFromConfig(config) {
  */
 export function writeCodexConfig(paths, config, now = Date.now, mcp = null, 
 /** 这次启动用的模型(launch.ts 按 u1s1 config 选好);undefined = 网关默认 */
-model = config.defaultModel) {
+model = config.defaultModel, 
+/** 自定义端点模型:接在网关目录后面(custom-models.ts withCustomCodexCatalog) */
+customModels = []) {
     mkdirSync(paths.configDir, { recursive: true, mode: 0o700 });
-    const catalog = modelCatalogFromConfig(config);
+    const catalog = withCustomCodexCatalog(modelCatalogFromConfig(config), customModels);
     if (catalog)
         writePrivateFile(paths.catalogFile, JSON.stringify(catalog) + "\n");
     else
@@ -382,7 +385,7 @@ export async function runCodex(userArgs) {
     const mcp = mcpInjectionDisabled()
         ? undefined
         : mcpLaunchEnv({ proxyBaseUrl: prepared.proxy.baseUrl, localToken: prepared.proxy.localKey, features: prepared.features, lang: lang() });
-    const backup = writeCodexConfig(paths, prepared.config, Date.now, mcp ? codexMcpServer() : null, prepared.model);
+    const backup = writeCodexConfig(paths, prepared.config, Date.now, mcp ? codexMcpServer() : null, prepared.model, prepared.customModels);
     if (backup) {
         console.error(tr(`  ${paths.configToml} 里有 u1s1 没法逐项改写的写法,已整份重写;原文件备份在 ${backup}。`, `  ${paths.configToml} had entries u1s1 couldn't update in place, so it was rewritten; the original is saved as ${backup}.`));
     }

package/dist/agents/custom-models.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 自定义端点的模型给 Claude Code / Codex 用(规划 docs/custom-endpoints-all-clients-plan-2026-11-13.md 的 A2)。
+ *
+ * 客户端里的模型 id 是 `<端点 id>/<模型 id>`(端点 id = ep + 32 位 hex,模型 id 原样,可以再带 `/`),
+ * 与 Pi 的 `provider/model` 写法一致;本机签名代理按这个 id 认出自定义模型,在本机转成 Chat Completions
+ * 直连端点(custom-endpoint-proxy.ts),不经网关、不计费。网关模型的 id 里没有这种前缀,照旧走网关。
+ *
+ * 只收 api = openai-completions 的端点(本地路由只会转 Chat Completions)。
+ */
+import { type CustomEndpoint, type ModelDef } from "../config.js";
+/** 本地路由认的 id:`ep<32 hex>/<模型 id>`。 */
+export declare const CUSTOM_MODEL_ID_RE: RegExp;
+export declare const CUSTOM_ENDPOINT_API = "openai-completions";
+export interface AgentCustomModel {
+    /** 客户端里用的 id(--model / -m / /model 里的值) */
+    id: string;
+    endpoint: CustomEndpoint;
+    model: ModelDef;
+}
+export declare function customModelId(endpointId: string, modelId: string): string;
+/** 端点能不能给 Claude Code / Codex 用:只认 Chat Completions 协议。 */
+export declare function routableEndpoint(ep: Pick<CustomEndpoint, "id" | "api">): boolean;
+/** 某客户端(Claude Code / Codex)可用的自定义模型,端点顺序、端点内模型顺序。A1 的模型列表也用它。 */
+export declare function agentCustomModels(endpoints: readonly CustomEndpoint[]): AgentCustomModel[];
+export type CustomModelLookup = 
+/** 不是自定义模型的写法:交给网关 */
+{
+    kind: "gateway";
+}
+/** 自定义模型的写法,但端点或模型已不在(删了、改了名):本机直接报错,不发给网关 */
+ | {
+    kind: "missing";
+    endpointId: string;
+    modelId: string;
+} | {
+    kind: "custom";
+    found: AgentCustomModel;
+};
+export declare function lookupCustomModel(endpoints: readonly CustomEndpoint[], requested: unknown): CustomModelLookup;
+/**
+ * 把自定义模型接在 /model 列表(modelPicker.options)后面。Claude Code 不认识这些 id,窗口只有一个全局的
+ * CLAUDE_CODE_MAX_CONTEXT_TOKENS:启动模型是自定义模型时设成它的窗口,否则不动(不让一个小窗口的本地模型
+ * 拖低网关模型的压缩点;会话中途从网关模型换到更小窗口的自定义模型时可能超窗,由端点报错)。
+ */
+export declare function withCustomClaudeModels(settings: Record<string, unknown>, customs: readonly AgentCustomModel[], launchModel: string | null | undefined): Record<string, unknown>;
+/**
+ * Codex /model 里给自定义模型列的思考档位(本地路由按 chatReasoningFields 转成 reasoning_effort):
+ * 带思考契约的按契约(关不掉的不列 none);只标了推理的给 none/low/medium/high,默认 medium;非推理不列。
+ */
+export declare function codexCustomReasoning(model: Pick<ModelDef, "reasoning" | "thinking">): {
+    levels: string[];
+    defaultLevel: string | null;
+};
+/**
+ * 自定义模型的 model_catalog 条目。指令模板等 Codex 必填但与模型无关的字段取网关目录的第一条
+ * (网关目录每条都带同一份模板);目录为空时没有模板可用,返回 undefined(Codex 对目录外的模型用
+ * 兜底元数据,照样能用)。
+ */
+export declare function codexCatalogEntry(c: AgentCustomModel, template: Record<string, unknown>, priority: number): Record<string, unknown>;
+/** 网关的 model_catalog + 自定义模型(排在后面)。没有网关目录或目录为空时原样返回。 */
+export declare function withCustomCodexCatalog(catalog: Record<string, unknown> | undefined, customs: readonly AgentCustomModel[]): Record<string, unknown> | undefined;

package/dist/agents/custom-models.js

@@ -0,0 +1,175 @@
+/**
+ * 自定义端点的模型给 Claude Code / Codex 用(规划 docs/custom-endpoints-all-clients-plan-2026-11-13.md 的 A2)。
+ *
+ * 客户端里的模型 id 是 `<端点 id>/<模型 id>`(端点 id = ep + 32 位 hex,模型 id 原样,可以再带 `/`),
+ * 与 Pi 的 `provider/model` 写法一致;本机签名代理按这个 id 认出自定义模型,在本机转成 Chat Completions
+ * 直连端点(custom-endpoint-proxy.ts),不经网关、不计费。网关模型的 id 里没有这种前缀,照旧走网关。
+ *
+ * 只收 api = openai-completions 的端点(本地路由只会转 Chat Completions)。
+ */
+import { ENDPOINT_ID_RE } from "../config.js";
+/** 本地路由认的 id:`ep<32 hex>/<模型 id>`。 */
+export const CUSTOM_MODEL_ID_RE = /^(ep[0-9a-f]{32})\/(.+)$/;
+export const CUSTOM_ENDPOINT_API = "openai-completions";
+export function customModelId(endpointId, modelId) {
+    return `${endpointId}/${modelId}`;
+}
+/** 端点能不能给 Claude Code / Codex 用:只认 Chat Completions 协议。 */
+export function routableEndpoint(ep) {
+    return ENDPOINT_ID_RE.test(ep.id) && ep.api === CUSTOM_ENDPOINT_API;
+}
+/** 某客户端(Claude Code / Codex)可用的自定义模型,端点顺序、端点内模型顺序。A1 的模型列表也用它。 */
+export function agentCustomModels(endpoints) {
+    const out = [];
+    const seen = new Set();
+    for (const endpoint of endpoints) {
+        if (!routableEndpoint(endpoint))
+            continue;
+        for (const model of endpoint.models) {
+            const id = customModelId(endpoint.id, model.id);
+            if (!model.id || seen.has(id))
+                continue;
+            seen.add(id);
+            out.push({ id, endpoint, model });
+        }
+    }
+    return out;
+}
+export function lookupCustomModel(endpoints, requested) {
+    if (typeof requested !== "string")
+        return { kind: "gateway" };
+    const m = CUSTOM_MODEL_ID_RE.exec(requested);
+    if (!m)
+        return { kind: "gateway" };
+    const [, endpointId, modelId] = m;
+    const endpoint = endpoints.find((ep) => ep.id === endpointId && routableEndpoint(ep));
+    const model = endpoint?.models.find((x) => x.id === modelId);
+    if (!endpoint || !model)
+        return { kind: "missing", endpointId, modelId };
+    return { kind: "custom", found: { id: requested, endpoint, model } };
+}
+// ---------------------------------------------------------------- Claude Code
+function contextLabel(tokens) {
+    if (tokens >= 1_000_000)
+        return `${Math.round(tokens / 100_000) / 10}M context`;
+    return `${Math.round(tokens / 1000)}K context`;
+}
+function customDescription(c) {
+    const parts = [];
+    if (c.model.contextWindow > 0)
+        parts.push(contextLabel(c.model.contextWindow));
+    parts.push(`custom endpoint ${c.endpoint.name}`);
+    return parts.join(" - ");
+}
+function isPlainObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+/**
+ * 把自定义模型接在 /model 列表(modelPicker.options)后面。Claude Code 不认识这些 id,窗口只有一个全局的
+ * CLAUDE_CODE_MAX_CONTEXT_TOKENS:启动模型是自定义模型时设成它的窗口,否则不动(不让一个小窗口的本地模型
+ * 拖低网关模型的压缩点;会话中途从网关模型换到更小窗口的自定义模型时可能超窗,由端点报错)。
+ */
+export function withCustomClaudeModels(settings, customs, launchModel) {
+    if (customs.length === 0)
+        return settings;
+    const out = { ...settings };
+    const picker = isPlainObject(out["modelPicker"]) ? { ...out["modelPicker"] } : {};
+    const options = Array.isArray(picker["options"]) ? [...picker["options"]] : [];
+    const listed = new Set(options.map((o) => (isPlainObject(o) ? o["model"] : undefined)));
+    for (const c of customs) {
+        if (listed.has(c.id))
+            continue;
+        options.push({ model: c.id, label: c.model.name || c.model.id, description: customDescription(c) });
+    }
+    picker["options"] = options;
+    out["modelPicker"] = picker;
+    const launched = customs.find((c) => c.id === launchModel);
+    if (launched && launched.model.contextWindow > 0) {
+        const env = isPlainObject(out["env"]) ? { ...out["env"] } : {};
+        env["CLAUDE_CODE_MAX_CONTEXT_TOKENS"] = String(launched.model.contextWindow);
+        out["env"] = env;
+    }
+    return out;
+}
+// ---------------------------------------------------------------- Codex
+const CODEX_EFFORT_TEXT = {
+    none: "No reasoning",
+    minimal: "Minimal reasoning",
+    low: "Fast responses with lighter reasoning",
+    medium: "Balanced speed and reasoning depth",
+    high: "Deeper reasoning for complex problems",
+    xhigh: "Extra deep reasoning",
+};
+/** u1s1 思考档位 → Codex 的 reasoning effort;max 在 Responses 里没有对应档,不列。 */
+const CODEX_EFFORT = {
+    off: "none",
+    minimal: "minimal",
+    low: "low",
+    medium: "medium",
+    high: "high",
+    xhigh: "xhigh",
+};
+/**
+ * Codex /model 里给自定义模型列的思考档位(本地路由按 chatReasoningFields 转成 reasoning_effort):
+ * 带思考契约的按契约(关不掉的不列 none);只标了推理的给 none/low/medium/high,默认 medium;非推理不列。
+ */
+export function codexCustomReasoning(model) {
+    if (!model.reasoning)
+        return { levels: [], defaultLevel: null };
+    const caps = model.thinking;
+    if (caps && caps.levels.length) {
+        const levels = caps.levels
+            .filter((level) => level !== "off" || caps.canDisable)
+            .map((level) => CODEX_EFFORT[level])
+            .filter((effort) => typeof effort === "string");
+        const preferred = CODEX_EFFORT[caps.defaultLevel];
+        const defaultLevel = preferred && levels.includes(preferred) ? preferred : levels.filter((e) => e !== "none").at(-1) ?? null;
+        return { levels, defaultLevel };
+    }
+    return { levels: ["none", "low", "medium", "high"], defaultLevel: "medium" };
+}
+/** 与网关 codex-config.ts 一致:模型行没设压缩预算时按 200K 压。 */
+const CODEX_DEFAULT_COMPACT_TOKENS = 200_000;
+/**
+ * 自定义模型的 model_catalog 条目。指令模板等 Codex 必填但与模型无关的字段取网关目录的第一条
+ * (网关目录每条都带同一份模板);目录为空时没有模板可用,返回 undefined(Codex 对目录外的模型用
+ * 兜底元数据,照样能用)。
+ */
+export function codexCatalogEntry(c, template, priority) {
+    const reasoning = codexCustomReasoning(c.model);
+    const levels = reasoning.levels;
+    const window = c.model.contextWindow > 0 ? c.model.contextWindow : undefined;
+    const entry = {
+        ...template,
+        slug: c.id,
+        display_name: c.model.name || c.model.id,
+        description: customDescription(c),
+        supported_reasoning_levels: levels.map((effort) => ({ effort, description: CODEX_EFFORT_TEXT[effort] ?? effort })),
+        priority,
+        input_modalities: c.model.vision ? ["text", "image"] : ["text"],
+    };
+    delete entry["default_reasoning_level"];
+    if (reasoning.defaultLevel)
+        entry["default_reasoning_level"] = reasoning.defaultLevel;
+    if (window) {
+        entry["context_window"] = window;
+        entry["max_context_window"] = window;
+        // 压缩点:200K 与窗口的 90% 取小(本地模型窗口常比 200K 小)
+        entry["auto_compact_token_limit"] = Math.min(CODEX_DEFAULT_COMPACT_TOKENS, Math.floor(window * 0.9));
+    }
+    return entry;
+}
+/** 网关的 model_catalog + 自定义模型(排在后面)。没有网关目录或目录为空时原样返回。 */
+export function withCustomCodexCatalog(catalog, customs) {
+    if (!catalog || customs.length === 0)
+        return catalog;
+    const models = Array.isArray(catalog["models"]) ? catalog["models"] : [];
+    const template = models.find(isPlainObject);
+    if (!template)
+        return catalog;
+    const slugs = new Set(models.map((m) => (isPlainObject(m) ? m["slug"] : undefined)));
+    const extra = customs
+        .filter((c) => !slugs.has(c.id))
+        .map((c, i) => codexCatalogEntry(c, template, models.length + i));
+    return { ...catalog, models: [...models, ...extra] };
+}

package/dist/agents/dsh.d.ts

@@ -0,0 +1,90 @@
+import { type McpLaunchEnv } from "../mcp-server.js";
+import type { AgentConfig } from "./agent-config.js";
+import { type RuntimePaths } from "./runtime.js";
+/** patch 里我们的 provider 名(dsh 的路由名:小写加连字符)。 */
+export declare const DSH_PROVIDER_ID = "u1s1";
+/** provider 的 apiKeyEnv:子进程环境里放本地 token 的变量名。 */
+export declare const DSH_KEY_ENV = "U1S1_LOCAL_KEY";
+/** 签名代理地址(带 /v1),patch 里用 `!!js process.env.U1S1_DSH_BASE_URL` 读。 */
+export declare const DSH_BASE_URL_ENV = "U1S1_DSH_BASE_URL";
+export interface DshPaths extends RuntimePaths {
+    /** DSH_HOME */
+    configDir: string;
+    /** 启动器生成的 --patch 文件 */
+    patchFile: string;
+    /** 上次成功拉到的 /v1/agents/dsh/config */
+    configCache: string;
+}
+export declare function dshPaths(root?: string): DshPaths;
+/**
+ * 子进程环境里要去掉的变量(依据 dsh 0.2.2-rc.1 的默认配置树):
+ *   - DSH_HOME(我们自己设);
+ *   - DEEPSEEK_API_KEY:官方 API Key 通道和官方网页搜索读它,有了就会绕开 u1s1 直连官方;
+ *   - 遥测/产品分析的地址与模式(DSH_TELEMETRY_MODE、DSH_TELEMETRY_OTLP_URL、DSH_PRODUCT_ANALYTICS_OTLP_URL、
+ *     DSH_CLIENT_VERSION),以及换搜索/抓取提供方的 DSH_WEB_SEARCH_PROVIDER、DSH_WEB_FETCH_PROVIDER;
+ *   - 我们自己的变量:关掉 MCP 注入时也不留用户环境里的旧值。
+ * DSH_PERMISSION_MODE(用户自己选的沙箱模式)保留。
+ */
+export declare const DSH_ENV_DROP: readonly string[];
+export interface DshLaunchInput {
+    baseEnv: NodeJS.ProcessEnv;
+    /** 签名代理的一次性本地 token */
+    localToken: string;
+    /** 签名代理地址,形如 http://127.0.0.1:12345/v1 */
+    proxyBaseUrl: string;
+    /** DSH_HOME */
+    home: string;
+    /** u1s1 工具服务要的变量(mcpLaunchEnv);不注入时省略 */
+    mcp?: McpLaunchEnv;
+}
+export declare function dshLaunchEnv(input: DshLaunchInput): NodeJS.ProcessEnv;
+/**
+ * 用户参数 → dsh 参数。dsh 的语法是 `dsh [--profile] <名字> [启动器选项] [应用参数]`,`--patch` 是启动器选项,
+ * 要紧跟在 profile 名后面(第一个它不认识的参数起就是应用参数)。
+ *   (无参数)           → web --patch <文件>
+ *   --no-open --port 1 → web --patch <文件> --no-open --port 1(以选项开头:默认进网页界面)
+ *   headless "任务"     → headless --patch <文件> "任务"
+ *   --profile web …    → --profile web --patch <文件> …
+ *   --help / --version → 原样(dsh 自己的帮助和版本)
+ *   plugin …           → 原样(插件管理,不启动 profile)
+ * 用户自己再传的 --patch 排在我们的后面,后叠的为准。
+ */
+export declare function dshLaunchArgs(patchFile: string, userArgs: readonly string[]): string[];
+/**
+ * 网关 settings.models(dsh-config.ts 下发的 dsh 原生形状)→ provider 模型表。没有 settings(老网关)时
+ * 退回 models 阵容里的 id、名字、窗口。
+ */
+export declare function dshProviderModels(config: Pick<AgentConfig, "settings" | "models">): Array<Record<string, unknown>>;
+export interface DshPatchInput {
+    models: Array<Record<string, unknown>>;
+    /** 这次启动的默认模型 */
+    model: string;
+    /** 会话标题等后台小任务用的模型;null = 跟默认模型 */
+    smallModel: string | null;
+    /** u1s1 工具服务怎么拉起;null = 不注入 */
+    mcp: {
+        command: string;
+        args: string[];
+        envVars: string[];
+    } | null;
+}
+/**
+ * 生成 --patch 文件。dsh 的 patch 是顶层数组:按 id 覆盖条目(config 整段替换、不深合并),`insert` 追加新条目。
+ * 文件里没有端点和凭证:baseURL 与 MCP 服务的变量都用 `!!js process.env.…` 在 dsh 进程里读。
+ */
+export declare function renderDshPatch(input: DshPatchInput): string;
+/** MCP 服务:同一个 node、同一份 CLI;env 里只列变量名,值由 dsh 从自己的环境转过去。 */
+export declare function dshMcpServer(command?: {
+    command: string;
+    args: string[];
+}, env?: NodeJS.ProcessEnv): {
+    command: string;
+    args: string[];
+    envVars: string[];
+};
+export declare function writeDshPatch(paths: DshPaths, input: DshPatchInput): void;
+/**
+ * `u1s1 dsh [参数…]`。返回子进程的退出码(启动前就失败返回 1)。
+ * 是否可用完全由网关配置的 enabled 决定(prepareAgentLaunch)。
+ */
+export declare function runDsh(userArgs: string[]): Promise<number>;