@dsh-plus/llm-pi 0.1.0

package/lib/index.js

@@ -0,0 +1,1247 @@
+import z from "@deepseek-ai/schemastery";
+import { deepEqualJson, installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import { dshHomePath } from "@deepseek-ai/dsh-home-paths";
+import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
+import { request } from "node:http";
+import { request as request$1 } from "node:https";
+import { existsSync, mkdirSync, readFileSync, realpathSync, renameSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import HttpsProxyAgentModule from "https-proxy-agent";
+import { credentialRef } from "@deepseek-ai/dsh-credentials";
+import { pathToFileURL } from "node:url";
+import * as vendoredPiAi from "@earendil-works/pi-ai";
+import * as vendoredCatalog from "@earendil-works/pi-ai/providers/all";
+import { anthropicMessagesApi } from "@earendil-works/pi-ai/api/anthropic-messages.lazy";
+import { openAICompletionsApi } from "@earendil-works/pi-ai/api/openai-completions.lazy";
+import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
+import * as vendoredLlm from "@deepseek-ai/dsh-llm";
+import * as vendoredPiAiAdapter from "@deepseek-ai/dsh-llm-pi-ai";
+
+//#region src/config.ts
+/** settings 命名空间；webui 配置卡片与插件运行期读取同一份。 */
+const SETTINGS_NS = settingsNamespace("dsh-plus-llm-pi");
+/** 本插件可为手写 route 提供的协议实现（与官方 PROTOCOLS 表一致）。 */
+const PROTOCOL_IDS = [
+	"openai-completions",
+	"openai-responses",
+	"anthropic-messages"
+];
+/** pi-ai 思考档位，升级序。 */
+const THINKING_LEVELS = [
+	"off",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
+const MODALITIES = ["text", "image"];
+const DEFAULT_CONTEXT_WINDOW = 262144;
+const DEFAULT_MAX_TOKENS = 32768;
+const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 3e5;
+/** dsh-timeout 的定时器上限（与官方 MAX_TIMER_DELAY_MS 对齐）。 */
+const MAX_TIMER_DELAY_MS = 2 ** 31 - 1;
+/** 键为可选档位，值为线协议拼写；仅 off 可留空（支持但不发送参数）。 */
+const reasoningEfforts = z.dict(z.union([z.string(), z.const(null)]), z.union(THINKING_LEVELS));
+const thinkingBudgets = z.object({
+	minimal: z.number(),
+	low: z.number(),
+	medium: z.number(),
+	high: z.number()
+});
+/**
+* compat 开放字典：承载 pi-ai 的全量 compat 字段（按协议分型，
+* 字段集与值校验见 compat.ts，在 settings 写入与 profile 构建时执行）。
+* schema 层不收紧，是因为字段集取决于本条目的 api，schema 无法表达条件分型。
+*/
+const compatDict = z.dict(z.any());
+const modelEntry = z.object({
+	id: z.string().required().description("模型 id（发送给 provider 的标识）"),
+	extends: z.string().description("继承源：\"provider/model\" 或裸 model id（随 provider 级 extends 源）；缺省先查内置目录同名模型"),
+	name: z.string().description("选择器显示名；缺省继承内置目录名，再退化为 id"),
+	contextWindow: z.number().step(1).min(1).description("上下文容量（覆盖继承值）"),
+	maxTokens: z.number().step(1).min(1).description("输出能力上限；显式配置同时成为无 cap 请求的默认 cap"),
+	input: z.array(z.union(MODALITIES)).description("请求模态；缺省继承内置目录，再退化 route defaultInput"),
+	reasoningEfforts: z.union([z.const(false), reasoningEfforts]).description("可选 reasoning 档位：false=非推理模型；dict=档位→线值映射；缺省继承内置目录能力"),
+	compat: compatDict.description("模型级 compat（字段级合并，压过 route 级与继承值）")
+});
+const providerProfile = z.object({
+	extends: z.string().description("provider 级继承：内置 provider id，提供 api/baseURL 默认值与模型 extends 的缺省查找源"),
+	displayName: z.string().description("选择器显示名；缺省为 route 键"),
+	api: z.union(PROTOCOL_IDS).description("线协议；缺省逐模型取继承值的 api，全部一致时作为 route 协议"),
+	baseURL: z.string().description("端点；缺省继承 extends 源 provider 的端点"),
+	apiKeyEnv: z.string().role("credential-ref").description("凭据引用名（凭据服务/环境变量）"),
+	headers: z.dict(z.string()).description("provider 请求头（Harness 署名头保留名优先）"),
+	compat: compatDict.description("route 级 compat 默认（逐模型按字段生效）"),
+	defaultContextWindow: z.number().step(1).min(1).description("模型与继承源都未标注时的上下文容量兜底"),
+	defaultMaxTokens: z.number().step(1).min(1).description("模型与继承源都未标注时的输出能力兜底"),
+	defaultInput: z.array(z.union(MODALITIES)).description("模型与继承源都未声明时的模态兜底（不可为空）").default(["text"]),
+	reasoning: z.union(THINKING_LEVELS).description("provider 默认 reasoning 档位"),
+	thinkingBudgets: thinkingBudgets.description("支持 token 预算的推理 provider 的档位预算"),
+	cacheRetention: z.union([
+		"none",
+		"short",
+		"long"
+	]).description("提示缓存保留偏好"),
+	transport: z.union([
+		"sse",
+		"websocket",
+		"websocket-cached",
+		"auto"
+	]).description("流式传输偏好"),
+	timeoutMs: z.natural().description("HTTP/provider 超时毫秒"),
+	websocketConnectTimeoutMs: z.natural().description("WebSocket 连接超时毫秒"),
+	streamIdleTimeoutMs: z.number().min(Number.MIN_VALUE).max(MAX_TIMER_DELAY_MS).description("单支流式读取的最大空闲间隔毫秒"),
+	retryPolicy: z.any().description("provider 重试策略（dsh-llm RetryPolicy 形状，构建期校验）"),
+	models: z.array(modelEntry).description("本 route 的模型目录；缺省且 provider 有 extends 时继承该源全部模型")
+});
+const Config = z.object({
+	enabled: z.boolean().description("总开关（关闭则不注册任何 route）").default(true),
+	catalogUrl: z.string().description("models.dev 目录数据端点").default("https://models.dev/api.json"),
+	catalogRefreshHours: z.number().description("models.dev 自动拉取间隔小时数；0 = 不自动拉取（可手动拉取或读已有缓存）").default(0),
+	catalogProxy: z.string().description("拉取 models.dev 目录时的 HTTP 代理地址（如 http://127.0.0.1:7890）；留空直连").default(""),
+	providers: z.dict(providerProfile).description("provider 路由表，键即 route 名").default({})
+});
+function toWire(cfg, writable, kitSource, modelsDevStatus) {
+	return {
+		enabled: cfg.enabled,
+		catalogUrl: cfg.catalogUrl,
+		catalogRefreshHours: cfg.catalogRefreshHours,
+		catalogProxy: cfg.catalogProxy ?? "",
+		providers: cfg.providers ?? {},
+		writable,
+		kitSource,
+		modelsDevStatus
+	};
+}
+const WirePatch = z.object({
+	enabled: z.boolean(),
+	catalogUrl: z.string(),
+	catalogRefreshHours: z.number(),
+	catalogProxy: z.string(),
+	providers: z.dict(providerProfile)
+});
+
+//#endregion
+//#region src/catalog/builtin.ts
+/** 内置 provider 的端点（provider 级 extends 的 baseURL 缺省值）。 */
+function builtinProviderBaseUrl(kit, provider) {
+	return kit.builtinProviders().find((p) => p.id === provider)?.baseUrl;
+}
+/** 内置目录是否存在该 provider。 */
+function hasBuiltinProvider(kit, provider) {
+	return kit.getBuiltinProviders().includes(provider);
+}
+/** 内置 provider 的全部模型 id（UI extends 选择器用）。 */
+function builtinModelIds(kit, provider) {
+	if (!hasBuiltinProvider(kit, provider)) return [];
+	return kit.getBuiltinModels(provider).map((m) => m.id);
+}
+/** 查单个内置模型为继承 base；未命中返回 undefined。 */
+function builtinModelBase(kit, provider, modelId) {
+	if (!hasBuiltinProvider(kit, provider)) return void 0;
+	const model = kit.getBuiltinModels(provider).find((m) => m.id === modelId);
+	if (model === void 0) return void 0;
+	return {
+		name: model.name,
+		api: model.api,
+		baseUrl: model.baseUrl,
+		input: [...model.input],
+		reasoning: model.reasoning,
+		...model.thinkingLevelMap === void 0 ? {} : { thinkingLevelMap: { ...model.thinkingLevelMap } },
+		...model.compat === void 0 ? {} : { compat: { ...model.compat } },
+		contextWindow: model.contextWindow,
+		maxTokens: model.maxTokens,
+		cost: { ...model.cost },
+		...model.headers === void 0 ? {} : { headers: { ...model.headers } }
+	};
+}
+/**
+* provider 级 extends 的全量模型继承：route 不写 models 时，
+* 以继承源 provider 的全部内置模型作为条目（每个条目 base 即其自身）。
+*/
+function inheritedCatalogEntries(kit, provider) {
+	if (!hasBuiltinProvider(kit, provider)) return [];
+	return kit.getBuiltinModels(provider).map((model) => ({
+		id: model.id,
+		base: builtinModelBase(kit, provider, model.id) ?? {}
+	}));
+}
+
+//#endregion
+//#region src/config-api.ts
+const ROUTE_CONFIG = "/dsh-plus/llm-pi/config";
+const ROUTE_CATALOG = "/dsh-plus/llm-pi/catalog";
+const MAX_BODY_BYTES = 256 * 1024;
+function sendJson(res, status, body) {
+	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+	res.end(JSON.stringify(body));
+}
+function readBody(req) {
+	return new Promise((resolve, reject) => {
+		const chunks = [];
+		let size = 0;
+		req.on("data", (chunk) => {
+			size += chunk.length;
+			if (size > MAX_BODY_BYTES) {
+				reject(/* @__PURE__ */ new Error("request body too large"));
+				req.destroy();
+				return;
+			}
+			chunks.push(chunk);
+		});
+		req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
+		req.on("error", reject);
+	});
+}
+async function readPatch(req) {
+	const raw = await readBody(req);
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		throw new Error("request body is not valid JSON");
+	}
+	return WirePatch(parsed);
+}
+function wireOf(runtime, writable) {
+	return toWire(runtime.currentConfig(), writable, runtime.kitInfo().source, runtime.modelsDev.status());
+}
+async function handleConfig(ctx, runtime, req, res) {
+	const settings = ctx.get("settings");
+	if (req.method === "GET") {
+		sendJson(res, 200, wireOf(runtime, settings !== void 0));
+		return;
+	}
+	if (req.method !== "PUT") {
+		sendJson(res, 405, { error: "method not allowed" });
+		return;
+	}
+	if (settings === void 0) {
+		sendJson(res, 503, { error: "settings provider 不可用，无法在线保存；请编辑 settings.yaml" });
+		return;
+	}
+	const patch = await readPatch(req);
+	await settings.replace(SETTINGS_NS, patch);
+	sendJson(res, 200, wireOf(runtime, true));
+}
+/** 目录查询/手动拉取：GET ?provider=&source= → 该源模型 id 列表；POST /refresh → 立即拉取。 */
+function handleCatalog(runtime, req, res) {
+	if (req.method === "POST" && req.url?.endsWith("/refresh")) {
+		runtime.modelsDev.refresh().then(() => {
+			sendJson(res, 200, { status: runtime.modelsDev.status() });
+		});
+		return;
+	}
+	const url = new URL(req.url ?? "", "http://localhost");
+	const provider = url.searchParams.get("provider") ?? "";
+	if ((url.searchParams.get("source") ?? "builtin") === "models-dev") {
+		sendJson(res, 200, {
+			providers: runtime.modelsDev.providerIds(),
+			models: provider.length > 0 ? runtime.modelsDev.modelIds(provider) : [],
+			status: runtime.modelsDev.status()
+		});
+		return;
+	}
+	sendJson(res, 200, {
+		providers: runtime.kit.getBuiltinProviders(),
+		models: provider.length > 0 ? builtinModelIds(runtime.kit, provider) : []
+	});
+}
+/** 注册配置读写与目录查询路由（webServer 缺失时由调用方保证不调用）。 */
+function registerConfigApi(ctx, runtime) {
+	const logger = ctx.logger("llm-pi");
+	const guard = (handler) => {
+		return async (req, res) => {
+			try {
+				await handler(req, res);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				logger.warn(`config api ${req.method ?? "?"} ${req.url ?? "?"} failed: ${message}`);
+				if (!res.headersSent) sendJson(res, 400, { error: message });
+				else res.end();
+			}
+		};
+	};
+	ctx.webServer.register({
+		kind: "exact",
+		path: ROUTE_CONFIG,
+		handler: guard((req, res) => handleConfig(ctx, runtime, req, res))
+	});
+	ctx.webServer.register({
+		kind: "prefix",
+		path: ROUTE_CATALOG,
+		handler: guard((req, res) => handleCatalog(runtime, req, res))
+	});
+}
+
+//#endregion
+//#region src/catalog/models-dev.ts
+/** 仅 https 目标走代理（http 目标直连；代理通常只提供 CONNECT 隧道）。 */
+const { HttpsProxyAgent } = HttpsProxyAgentModule;
+const FETCH_TIMEOUT_MS = 2e4;
+/** 目录文档体上限（api.json 全量约 1-2MB，放宽到 20MB 防未来膨胀）。 */
+const MAX_RESPONSE_BYTES$1 = 20 * 1024 * 1024;
+/**
+* 极简 JSON GET（node:http(s) 实现）：支持 HTTP 代理（仅 https 目标）与超时。
+* 不跟随重定向（models.dev 直链无重定向；自定义端点需自行保证可直达）。
+*/
+function fetchJson(url, proxy, timeoutMs) {
+	return new Promise((resolve, reject) => {
+		const target = new URL(url);
+		const req = (target.protocol === "https:" ? request$1 : request)(url, {
+			agent: target.protocol === "https:" && proxy.length > 0 ? new HttpsProxyAgent(proxy) : void 0,
+			timeout: timeoutMs,
+			headers: { accept: "application/json" }
+		}, (response) => {
+			const chunks = [];
+			let size = 0;
+			response.on("data", (chunk) => {
+				size += chunk.length;
+				if (size > MAX_RESPONSE_BYTES$1) {
+					req.destroy(/* @__PURE__ */ new Error("响应超过 20MB 上限"));
+					return;
+				}
+				chunks.push(chunk);
+			});
+			response.on("end", () => {
+				resolve({
+					status: response.statusCode ?? 0,
+					body: Buffer.concat(chunks).toString("utf8")
+				});
+			});
+		});
+		req.on("timeout", () => req.destroy(/* @__PURE__ */ new Error(`请求超时（${timeoutMs}ms）`)));
+		req.on("error", reject);
+		req.end();
+	});
+}
+function isDocument(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** 单个 models.dev 模型条目 → 继承 base（仅采信名称/容量/推理能力）。 */
+function toModelBase(entry) {
+	const base = {};
+	if (typeof entry.name === "string" && entry.name.length > 0) base.name = entry.name;
+	const context = entry.limit?.context;
+	if (typeof context === "number" && Number.isInteger(context) && context > 0) base.contextWindow = context;
+	const output = entry.limit?.output;
+	if (typeof output === "number" && Number.isInteger(output) && output > 0) base.maxTokens = output;
+	base.reasoning = entry.reasoning === true;
+	return base;
+}
+var ModelsDevSource = class {
+	cacheFile;
+	url;
+	ttlHours;
+	proxy;
+	log;
+	document;
+	fetchedAt = null;
+	lastError = null;
+	refreshing;
+	constructor(cacheFile, url, ttlHours, log, proxy = "") {
+		this.cacheFile = cacheFile;
+		this.url = url;
+		this.ttlHours = ttlHours;
+		this.log = log;
+		this.proxy = proxy;
+	}
+	/** 配置变更时更新端点/TTL/代理并触发刷新（去抖由 refresh 的进行中复用承担）。 */
+	reconfigure(url, ttlHours, proxy) {
+		if (url === this.url && ttlHours === this.ttlHours && proxy === this.proxy) return;
+		this.url = url;
+		this.ttlHours = ttlHours;
+		this.proxy = proxy;
+		if (ttlHours > 0 && this.isStale()) this.refresh();
+	}
+	/** 是否已有可用数据（缓存或拉取成功）；与自动拉取开关无关。 */
+	get enabled() {
+		return this.document !== void 0;
+	}
+	/** 加载缓存，并在启用自动拉取且缓存过期时后台刷新；构造后调用一次，永不抛错。 */
+	async ensureLoaded() {
+		this.loadCache();
+		if (this.ttlHours > 0 && this.isStale()) await this.refresh();
+	}
+	/** 强制刷新（手动拉取/配置变更触发）；ttlHours=0 时同样生效（手动拉取不受自动开关限制）。 */
+	async refresh() {
+		this.refreshing ??= this.doFetch().finally(() => {
+			this.refreshing = void 0;
+		});
+		await this.refreshing;
+	}
+	/** 查继承 base；未命中/未启用返回 undefined。 */
+	lookup(provider, modelId) {
+		const entry = this.document?.[provider]?.models?.[modelId];
+		if (entry === void 0) return void 0;
+		return toModelBase(entry);
+	}
+	/** 全部 provider id（UI extends 选择器用）。 */
+	providerIds() {
+		return Object.keys(this.document ?? {});
+	}
+	/** 某 provider 的模型 id 列表（UI extends 选择器用）。 */
+	modelIds(provider) {
+		return Object.keys(this.document?.[provider]?.models ?? {});
+	}
+	status() {
+		const providers = Object.keys(this.document ?? {});
+		const models = providers.reduce((total, p) => total + Object.keys(this.document?.[p]?.models ?? {}).length, 0);
+		return {
+			fetchedAt: this.fetchedAt,
+			providers: providers.length,
+			models,
+			error: this.lastError
+		};
+	}
+	isStale() {
+		if (this.fetchedAt === null) return true;
+		const ageMs = Date.now() - Date.parse(this.fetchedAt);
+		return !Number.isFinite(ageMs) || ageMs > this.ttlHours * 36e5;
+	}
+	loadCache() {
+		try {
+			const raw = JSON.parse(readFileSync(this.cacheFile, "utf8"));
+			if (!isDocument(raw.data) || typeof raw.fetchedAt !== "string") throw new Error("缓存形状非法");
+			this.document = raw.data;
+			this.fetchedAt = raw.fetchedAt;
+		} catch {}
+	}
+	async doFetch() {
+		try {
+			const response = await fetchJson(this.url, this.proxy, FETCH_TIMEOUT_MS);
+			if (response.status < 200 || response.status >= 300) throw new Error(`HTTP ${response.status}`);
+			const data = JSON.parse(response.body);
+			if (!isDocument(data)) throw new Error("响应不是 models.dev 目录文档");
+			this.document = data;
+			this.fetchedAt = (/* @__PURE__ */ new Date()).toISOString();
+			this.lastError = null;
+			this.persistCache(data);
+		} catch (error) {
+			this.lastError = error instanceof Error ? error.message : String(error);
+			this.log(`models.dev 目录拉取失败（沿用缓存/仅内置目录）：${this.lastError}`);
+		}
+	}
+	persistCache(data) {
+		try {
+			mkdirSync(dirname(this.cacheFile), { recursive: true });
+			const tmp = `${this.cacheFile}.tmp`;
+			writeFileSync(tmp, JSON.stringify({
+				fetchedAt: this.fetchedAt,
+				data
+			}), "utf8");
+			renameSync(tmp, this.cacheFile);
+		} catch (error) {
+			this.log(`models.dev 缓存写入失败：${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+};
+
+//#endregion
+//#region src/discovery.ts
+const LISTABLE_PROTOCOLS = new Set(["openai-completions", "openai-responses"]);
+const MAX_RESPONSE_BYTES = 4 * 1024 * 1024;
+/** 读取有界响应体：声明超长或累计超长都拒绝（对齐官方 readBounded）。 */
+async function readBounded(kit, response, url) {
+	const oversized = () => new kit.LlmError(`${url} 响应超过 ${MAX_RESPONSE_BYTES} 字节`, "DISCOVERY_FAILED");
+	const declared = Number(response.headers.get("content-length") ?? NaN);
+	if (Number.isFinite(declared) && declared > MAX_RESPONSE_BYTES) {
+		await response.body?.cancel();
+		throw oversized();
+	}
+	if (response.body === null) return "";
+	const reader = response.body.getReader();
+	const chunks = [];
+	let total = 0;
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			total += value.byteLength;
+			if (total > MAX_RESPONSE_BYTES) throw oversized();
+			chunks.push(value);
+		}
+	} finally {
+		await reader.cancel().catch(() => {});
+	}
+	const body = new Uint8Array(total);
+	let offset = 0;
+	for (const chunk of chunks) {
+		body.set(chunk, offset);
+		offset += chunk.byteLength;
+	}
+	return new TextDecoder().decode(body);
+}
+/** 解析 OpenAI 兼容模型清单；坏行跳过而非整表失败（对齐官方 readListing）。 */
+function readListing(kit, body) {
+	const data = body?.data;
+	if (!Array.isArray(data)) throw new kit.LlmError("端点的模型清单缺少 \"data\" 数组；请手工录入模型", "DISCOVERY_FAILED");
+	const models = [];
+	for (const raw of data) {
+		const entry = raw;
+		if (typeof entry?.["id"] !== "string" || entry["id"].length === 0) continue;
+		const out = { id: entry["id"] };
+		const name$1 = entry["name"] ?? entry["display_name"];
+		if (typeof name$1 === "string" && name$1.length > 0) out.name = name$1;
+		for (const [key, field] of [
+			["context_window", "contextWindow"],
+			["context_length", "contextWindow"],
+			["max_output_tokens", "maxTokens"],
+			["max_tokens", "maxTokens"]
+		]) {
+			const value = entry[key];
+			if (typeof value === "number" && Number.isInteger(value) && value > 0 && out[field] === void 0) out[field] = value;
+		}
+		models.push(out);
+	}
+	return models;
+}
+/** 内置目录直答（route 配了 provider 级 extends 时）。 */
+function catalogAnswer(kit, source) {
+	return builtinModelIds(kit, source).map((id) => {
+		const model = kit.getBuiltinModels(source).find((m) => m.id === id);
+		return {
+			id,
+			...model?.name === void 0 ? {} : { name: model.name },
+			...model?.contextWindow === void 0 ? {} : { contextWindow: model.contextWindow },
+			...model?.maxTokens === void 0 ? {} : { maxTokens: model.maxTokens }
+		};
+	});
+}
+/**
+* 回答"该 provider 可服务哪些模型"：extends 内置源零网络直答；
+* 否则仅 openai 系协议走 GET {baseURL}/models；其余协议明确不支持。
+*/
+async function discoverModels(request$2, deps) {
+	const { kit } = deps;
+	const route = request$2.provider === void 0 ? void 0 : deps.configProviders()[request$2.provider];
+	if (route?.extends !== void 0 && hasBuiltinProvider(kit, route.extends)) return catalogAnswer(kit, route.extends);
+	const baseURL = request$2.baseURL ?? route?.baseURL;
+	if (baseURL === void 0 || baseURL.length === 0) throw new kit.LlmError(`route ${JSON.stringify(request$2.provider ?? "")} 未配 baseURL 且 extends 源无内置目录；无法探测模型清单`, "DISCOVERY_FAILED");
+	const api = request$2.api ?? route?.api ?? "openai-completions";
+	if (!LISTABLE_PROTOCOLS.has(api)) throw new kit.LlmError(`协议 "${api}" 无可读取的模型清单端点；请手工录入模型`, "DISCOVERY_UNSUPPORTED");
+	const url = `${baseURL.replace(/\/+$/, "")}/models`;
+	const supplied = request$2.apiKey ?? await deps.storedApiKey(request$2.provider);
+	let authorization;
+	if (supplied !== void 0) {
+		const checked = kit.normalizeApiKey(supplied);
+		if (!checked.ok) throw new kit.LlmError(checked.reason === "empty" ? "API key 为空；请在 Models 页配置或留空以匿名探测" : "API key 含有 HTTP 头无法携带的字符", kit.INVALID_CREDENTIAL_CODE);
+		authorization = `Bearer ${checked.value}`;
+	}
+	let response;
+	try {
+		response = await fetch(url, {
+			method: "GET",
+			headers: {
+				accept: "application/json",
+				...authorization === void 0 ? {} : { authorization },
+				...kit.attributionHeaders()
+			},
+			...request$2.signal === void 0 ? {} : { signal: request$2.signal }
+		});
+	} catch (error) {
+		if (request$2.signal?.aborted) throw new kit.LlmError("模型发现被调用方中止", "ABORTED", { cause: error });
+		throw new kit.LlmError(`无法连接 ${url}`, "DISCOVERY_FAILED", { cause: error });
+	}
+	if (!response.ok) throw new kit.LlmError(`${url} 返回 ${response.status}${response.status === 401 || response.status === 403 ? "；请检查 API key" : ""}`, "DISCOVERY_FAILED");
+	const text = await readBounded(kit, response, url);
+	try {
+		return readListing(kit, JSON.parse(text));
+	} catch (error) {
+		if (error instanceof kit.LlmError) throw error;
+		throw new kit.LlmError(`${url} 未返回 JSON`, "DISCOVERY_FAILED", { cause: error });
+	}
+}
+
+//#endregion
+//#region src/compat.ts
+/** openai-completions 的 21 个字段（pi-ai OpenAICompletionsCompat）。 */
+const COMPLETIONS_FIELDS = {
+	supportsStore: "boolean",
+	supportsDeveloperRole: "boolean",
+	supportsReasoningEffort: "boolean",
+	supportsUsageInStreaming: "boolean",
+	maxTokensField: ["max_completion_tokens", "max_tokens"],
+	requiresToolResultName: "boolean",
+	requiresAssistantAfterToolResult: "boolean",
+	requiresThinkingAsText: "boolean",
+	requiresReasoningContentOnAssistantMessages: "boolean",
+	thinkingFormat: [
+		"openai",
+		"openrouter",
+		"deepseek",
+		"together",
+		"zai",
+		"qwen",
+		"chat-template",
+		"qwen-chat-template",
+		"string-thinking",
+		"ant-ling"
+	],
+	chatTemplateKwargs: "object",
+	openRouterRouting: "object",
+	vercelGatewayRouting: "object",
+	zaiToolStream: "boolean",
+	supportsOpenAIGrammarTools: "boolean",
+	supportsStrictMode: "boolean",
+	cacheControlFormat: ["anthropic"],
+	sendSessionAffinityHeaders: "boolean",
+	deferredToolsMode: ["kimi"],
+	sessionAffinityFormat: [
+		"openai",
+		"openai-nosession",
+		"openrouter"
+	],
+	supportsLongCacheRetention: "boolean"
+};
+/** openai-responses 的 7 个字段（pi-ai OpenAIResponsesCompat）。 */
+const RESPONSES_FIELDS = {
+	supportsDeveloperRole: "boolean",
+	sessionAffinityFormat: [
+		"openai",
+		"openai-nosession",
+		"openrouter"
+	],
+	supportsLongCacheRetention: "boolean",
+	supportsStrictMode: "boolean",
+	supportsOpenAIGrammarTools: "boolean",
+	supportsToolSearch: "boolean",
+	supportsExplicitPromptCacheMode: "boolean"
+};
+/** anthropic-messages 的 9 个字段（pi-ai AnthropicMessagesCompat）。 */
+const ANTHROPIC_FIELDS = {
+	supportsEagerToolInputStreaming: "boolean",
+	supportsLongCacheRetention: "boolean",
+	sendSessionAffinityHeaders: "boolean",
+	supportsCacheControlOnTools: "boolean",
+	supportsTemperature: "boolean",
+	forceAdaptiveThinking: "boolean",
+	allowEmptySignature: "boolean",
+	supportsStrictTools: "boolean",
+	supportsToolReferences: "boolean"
+};
+const FIELDS_BY_PROTOCOL = {
+	"openai-completions": COMPLETIONS_FIELDS,
+	"openai-responses": RESPONSES_FIELDS,
+	"anthropic-messages": ANTHROPIC_FIELDS
+};
+function checkValue(api, field, spec, value, where) {
+	if (spec === "boolean") {
+		if (typeof value !== "boolean") throw new Error(`${where}: compat.${field} 必须是布尔值`);
+		return;
+	}
+	if (spec === "object") {
+		if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error(`${where}: compat.${field} 必须是对象`);
+		return;
+	}
+	if (typeof value !== "string" || !spec.includes(value)) throw new Error(`${where}: compat.${field} 必须是 ${spec.map((v) => JSON.stringify(v)).join(" | ")} 之一`);
+}
+/**
+* 校验一份 compat 字典对指定协议合法：未知协议/未知键拒绝（对比官方的静默丢弃），
+* 已知键校验值类型/枚举。undefined 值视为未设置，跳过（语义同 pi-ai 的 ??）。
+*/
+function validateCompat(api, compat, where) {
+	if (compat === void 0) return;
+	const fields = FIELDS_BY_PROTOCOL[api];
+	if (fields === void 0) throw new Error(`${where}: 协议 ${JSON.stringify(api)} 无 compat 字段表（支持：${Object.keys(FIELDS_BY_PROTOCOL).join(", ")}）`);
+	for (const [key, value] of Object.entries(compat)) {
+		const spec = fields[key];
+		if (spec === void 0) throw new Error(`${where}: compat.${key} 不是 ${api} 协议的合法字段（合法字段：${Object.keys(fields).join(", ")}）`);
+		if (value === void 0) continue;
+		checkValue(api, key, spec, value, where);
+	}
+}
+/**
+* 逐字段合并 compat 层（后者覆盖前者），丢弃 undefined 值。
+* 层序：继承源（仅同协议）→ route 级 → 模型级。
+*/
+function mergeCompat(...layers) {
+	const merged = {};
+	for (const layer of layers) {
+		if (layer === void 0) continue;
+		for (const [key, value] of Object.entries(layer)) if (value !== void 0) merged[key] = value;
+	}
+	return Object.keys(merged).length > 0 ? merged : void 0;
+}
+
+//#endregion
+//#region src/inherit.ts
+var ExtendsError = class extends Error {};
+/** 解析 "provider/model" 或裸 "model" 引用。 */
+function parseExtendsRef(raw) {
+	const slash = raw.indexOf("/");
+	if (slash < 0) return { model: raw };
+	const provider = raw.slice(0, slash);
+	const model = raw.slice(slash + 1);
+	if (provider.length === 0 || model.length === 0 || model.includes("/")) throw new ExtendsError(`extends 引用 ${JSON.stringify(raw)} 非法：应为 "provider/model" 或 "model"`);
+	return {
+		provider,
+		model
+	};
+}
+function lookup(kit, modelsDev, provider, model) {
+	const builtin = builtinModelBase(kit, provider, model);
+	if (builtin !== void 0) return {
+		base: builtin,
+		source: "builtin",
+		sourceProvider: provider
+	};
+	const dev = modelsDev?.lookup(provider, model);
+	if (dev !== void 0) return {
+		base: dev,
+		source: "models-dev",
+		sourceProvider: provider
+	};
+}
+/**
+* 解析一个模型条目的继承 base。
+* @throws ExtendsError 显式 extends 引用不存在（写入时拒绝，指明引用名）。
+*/
+function resolveModelBase(route, profile, entry, kit, modelsDev) {
+	const where = `provider "${route}" model "${entry.id}"`;
+	if (entry.extends === void 0) {
+		if (profile.extends === void 0) return {
+			base: {},
+			source: "none"
+		};
+		return lookup(kit, modelsDev, profile.extends, entry.id) ?? {
+			base: {},
+			source: "none"
+		};
+	}
+	const ref = parseExtendsRef(entry.extends);
+	const provider = ref.provider ?? profile.extends;
+	if (provider === void 0) throw new ExtendsError(`${where}: extends ${JSON.stringify(entry.extends)} 是裸模型 id，但本 route 未配置 provider 级 extends 查找源`);
+	const hit = lookup(kit, modelsDev, provider, ref.model);
+	if (hit === void 0) throw new ExtendsError(`${where}: extends 引用 "${provider}/${ref.model}" 在内置目录与 models.dev 快照中都不存在`);
+	return hit;
+}
+
+//#endregion
+//#region src/profiles.ts
+/** 内置目录未描述时的零价目（harness 不消费 cost 元数据，同官方 NO_COST）。 */
+const NO_COST = {
+	input: 0,
+	output: 0,
+	cacheRead: 0,
+	cacheWrite: 0
+};
+/** 报告不可服务的 route，命名出错配置键（对齐官方 invalid()）。 */
+function invalid(provider, detail) {
+	throw new Error(`llm-pi: provider "${provider}" ${detail}`);
+}
+/** 条目的声明模态；缺省/空数组都视为"无答案"，交下一级（同官方 declaredInput）。 */
+function declaredInput(configured) {
+	return configured === void 0 || configured.length === 0 ? void 0 : [...configured];
+}
+/**
+* 单个模型的 reasoning 物化（逐行对齐官方 resolveModelReasoning）：
+* 显式 dict → 全档位确定的 thinkingLevelMap（未声明档位置 null）；
+* false → 非推理模型；缺省 → 保留继承源的 reasoning 能力。
+*/
+function resolveModelReasoning(provider, entry, base) {
+	const efforts = entry.reasoningEfforts;
+	if (efforts === void 0) {
+		if (base.reasoning === void 0) return { reasoning: false };
+		return {
+			reasoning: base.reasoning,
+			...base.thinkingLevelMap === void 0 ? {} : { thinkingLevelMap: base.thinkingLevelMap }
+		};
+	}
+	if (efforts === false) return { reasoning: false };
+	if (Object.keys(efforts).length === 0) invalid(provider, `model "${entry.id}" 的 reasoningEfforts 为空：声明档位、置 false 或缺省继承`);
+	for (const level of THINKING_LEVELS) {
+		const wire = efforts[level];
+		if (wire === void 0) continue;
+		if (wire === null) {
+			if (level !== "off") invalid(provider, `model "${entry.id}" reasoningEfforts.${level} 需要线值；仅 off 可留空`);
+		} else if (wire.length === 0) invalid(provider, `model "${entry.id}" reasoningEfforts.${level} 不能为空字符串`);
+	}
+	if (!THINKING_LEVELS.filter((level) => efforts[level] !== void 0).some((level) => level !== "off")) invalid(provider, `model "${entry.id}" reasoningEfforts 只有 off；声明思考档位或置 false`);
+	const map = {};
+	for (const level of THINKING_LEVELS) {
+		const wire = efforts[level];
+		if (wire === void 0) map[level] = null;
+		else if (wire !== null) map[level] = wire;
+	}
+	return {
+		reasoning: true,
+		thinkingLevelMap: map
+	};
+}
+/** Harness 自管凭据的 api-key auth（对齐官方 harnessApiKeyAuth，index.js:1215）。 */
+function harnessApiKeyAuth(name$1) {
+	return {
+		name: name$1,
+		resolve: ({ credential }) => Promise.resolve({
+			auth: credential?.key === void 0 ? {} : { apiKey: credential.key },
+			source: name$1
+		})
+	};
+}
+/** 物化单个模型：继承 base 在下，条目显式字段逐字段覆盖。lenient 下缺 api/baseURL 时跳过（返回 null）。 */
+function materializeModel(route, profile, entry, base, routeApi, providerBaseUrl, defaultInput, deps, configuredMaxTokens) {
+	const api = profile.api ?? base.api ?? routeApi;
+	if (api === void 0) {
+		if (deps.lenient) {
+			deps.warn?.(`llm-pi: provider "${route}" model "${entry.id}" 无法获得 api（继承源缺失），已跳过该模型`);
+			return null;
+		}
+		invalid(route, `model "${entry.id}" 需要 api：继承源未提供，请在 route 上设置 api`);
+	}
+	const baseUrl = profile.baseURL ?? base.baseUrl ?? providerBaseUrl;
+	if (baseUrl === void 0) {
+		if (deps.lenient) {
+			deps.warn?.(`llm-pi: provider "${route}" model "${entry.id}" 无法获得 baseURL（继承源缺失），已跳过该模型`);
+			return null;
+		}
+		invalid(route, `model "${entry.id}" 需要 baseURL：继承源未提供，请在 route 上设置 baseURL`);
+	}
+	const contextWindow = entry.contextWindow ?? base.contextWindow ?? profile.defaultContextWindow ?? DEFAULT_CONTEXT_WINDOW;
+	const maxTokens = entry.maxTokens ?? base.maxTokens ?? profile.defaultMaxTokens ?? DEFAULT_MAX_TOKENS;
+	if (entry.maxTokens !== void 0) configuredMaxTokens.set(entry.id, entry.maxTokens);
+	validateCompat(api, profile.compat, `provider "${route}"`);
+	validateCompat(api, entry.compat, `provider "${route}" model "${entry.id}"`);
+	const compat = mergeCompat(base.api === api ? base.compat : void 0, profile.compat, entry.compat);
+	return {
+		id: entry.id,
+		name: entry.name ?? base.name ?? entry.id,
+		api,
+		provider: route,
+		baseUrl,
+		...resolveModelReasoning(route, entry, base),
+		input: declaredInput(entry.input) ?? base.input ?? [...defaultInput],
+		cost: base.cost ?? NO_COST,
+		contextWindow,
+		maxTokens,
+		...base.headers === void 0 ? {} : { headers: { ...base.headers } },
+		...compat === void 0 ? {} : { compat }
+	};
+}
+/** 物化一个 route 的全部模型；返回模型列表与显式配置的请求 cap 表。
+*  lenient 下 route 无任何可服务模型时返回 null（调用方跳过该 route）。 */
+function materializeRouteModels(route, profile, deps, defaultInput) {
+	const configuredMaxTokens = /* @__PURE__ */ new Map();
+	const providerBaseUrl = profile.extends === void 0 ? void 0 : builtinProviderBaseUrl(deps.kit, profile.extends);
+	const entries = [];
+	if (profile.models !== void 0 && profile.models.length > 0) {
+		const seen = /* @__PURE__ */ new Set();
+		for (const entry of profile.models) {
+			if (entry.id.length === 0) invalid(route, "存在空 id 的模型条目");
+			if (seen.has(entry.id)) invalid(route, `模型 "${entry.id}" 重复列出`);
+			seen.add(entry.id);
+			let base;
+			try {
+				base = resolveModelBase(route, profile, entry, deps.kit, deps.modelsDev).base;
+			} catch (error) {
+				if (!deps.lenient || !(error instanceof ExtendsError)) throw error;
+				deps.warn?.(`llm-pi: provider "${route}" model "${entry.id}" 的 extends 引用当前不可解析（${error.message}）；已降级为手写条目`);
+				base = {};
+			}
+			entries.push({
+				id: entry.id,
+				entry,
+				base
+			});
+		}
+	} else if (profile.extends !== void 0) {
+		for (const { id, base } of inheritedCatalogEntries(deps.kit, profile.extends)) entries.push({
+			id,
+			base
+		});
+		if (entries.length === 0) invalid(route, `extends 源 "${profile.extends}" 在内置目录中没有模型；请显式列出 models`);
+	} else invalid(route, "未配置 models 且未配置 provider 级 extends；本 route 无模型可服务");
+	const apis = new Set(entries.map(({ base }) => profile.api ?? base.api).filter((api) => api !== void 0));
+	const routeApi = apis.size === 1 ? [...apis][0] : void 0;
+	const models = entries.map(({ id, entry, base }) => materializeModel(route, profile, entry ?? { id }, base, routeApi, providerBaseUrl, defaultInput, deps, configuredMaxTokens)).filter((model) => model !== null);
+	if (models.length === 0) {
+		if (deps.lenient) {
+			deps.warn?.(`llm-pi: provider "${route}" 当前没有可服务的模型（继承源漂移），已跳过该 route 的注册`);
+			return null;
+		}
+		invalid(route, "route 内没有可服务的模型");
+	}
+	const finalApis = new Set(models.map((m) => m.api));
+	if (finalApis.size > 1) invalid(route, `route 内模型协议不一致（${[...finalApis].join(", ")}）；一个 route 只能服务一种协议`);
+	return {
+		models,
+		configuredMaxTokens
+	};
+}
+/**
+* 校验并物化全部 route。任一 route 不可服务即整体抛错——
+* settings 写入校验与运行期 profiles 回调共用本函数，
+* 保证"写入时被拒"与"运行期不可能拿到坏配置"互为表里。
+*/
+function buildProfiles(providers, deps) {
+	const resolved = /* @__PURE__ */ new Map();
+	for (const [route, profile] of Object.entries(providers ?? {})) {
+		if (route.length === 0) throw new Error("llm-pi: provider 名不能为空");
+		if (profile.baseURL !== void 0 && profile.baseURL.length === 0) invalid(route, "baseURL 为空");
+		if (profile.displayName !== void 0 && profile.displayName.length === 0) invalid(route, "displayName 为空");
+		const streamIdleTimeoutMs = profile.streamIdleTimeoutMs ?? DEFAULT_STREAM_IDLE_TIMEOUT_MS;
+		if (!Number.isFinite(streamIdleTimeoutMs) || streamIdleTimeoutMs <= 0 || streamIdleTimeoutMs > MAX_TIMER_DELAY_MS) invalid(route, `streamIdleTimeoutMs 必须是 (0, ${MAX_TIMER_DELAY_MS}] 内的有限数`);
+		const defaultInput = [...profile.defaultInput ?? ["text"]];
+		if (defaultInput.length === 0) invalid(route, "defaultInput 至少要声明一种模态");
+		const displayName = profile.displayName ?? route;
+		const catalog = materializeRouteModels(route, profile, deps, defaultInput);
+		if (catalog === null) continue;
+		const api = catalog.models[0]?.api;
+		const factory = api === void 0 ? void 0 : deps.kit.protocolFactories[api];
+		if (factory === void 0) invalid(route, `api ${JSON.stringify(api)} 本插件无法服务（支持：openai-completions/openai-responses/anthropic-messages）`);
+		const piProvider = deps.kit.createProvider({
+			id: route,
+			name: displayName,
+			...profile.baseURL === void 0 ? profile.extends === void 0 ? {} : { baseUrl: builtinProviderBaseUrl(deps.kit, profile.extends) } : { baseUrl: profile.baseURL },
+			...profile.headers === void 0 ? {} : { headers: { ...profile.headers } },
+			auth: { apiKey: harnessApiKeyAuth(displayName) },
+			models: catalog.models,
+			api: factory()
+		});
+		resolved.set(route, {
+			provider: route,
+			displayName,
+			...profile.apiKeyEnv === void 0 ? {} : { apiKeyEnv: credentialRef(profile.apiKeyEnv) },
+			streamIdleTimeoutMs,
+			retryPolicy: deps.kit.resolveRetryPolicy(profile.retryPolicy, `llm-pi: provider "${route}" retryPolicy`),
+			...profile.headers === void 0 ? {} : { headers: { ...profile.headers } },
+			...profile.reasoning === void 0 ? {} : { reasoning: profile.reasoning },
+			...profile.thinkingBudgets === void 0 ? {} : { thinkingBudgets: { ...profile.thinkingBudgets } },
+			...profile.cacheRetention === void 0 ? {} : { cacheRetention: profile.cacheRetention },
+			...profile.transport === void 0 ? {} : { transport: profile.transport },
+			...profile.timeoutMs === void 0 ? {} : { timeoutMs: profile.timeoutMs },
+			...profile.websocketConnectTimeoutMs === void 0 ? {} : { websocketConnectTimeoutMs: profile.websocketConnectTimeoutMs },
+			configuredMaxTokens: catalog.configuredMaxTokens,
+			piProvider
+		});
+	}
+	return resolved;
+}
+/** settings 写入校验钩子：完整试跑解析，非法配置在写入处拒绝。 */
+function assertServiceable(config, deps) {
+	buildProfiles(config.providers, deps);
+}
+
+//#endregion
+//#region src/resolve-dsh.ts
+/** kit 必备形状清单：缺失即视为上游不兼容。 */
+function assertKitShape(kit, origin) {
+	const problems = [];
+	if (typeof kit.PiAiAdapter !== "function") problems.push("PiAiAdapter 不是类");
+	else for (const method of [
+		"current",
+		"stream",
+		"listModels",
+		"resolveModel",
+		"providerInfo"
+	]) if (typeof kit.PiAiAdapter.prototype[method] !== "function") problems.push(`PiAiAdapter.prototype.${method} 缺失`);
+	if (typeof kit.createProvider !== "function") problems.push("pi-ai createProvider 缺失");
+	if (typeof kit.getBuiltinModels !== "function") problems.push("pi-ai getBuiltinModels 缺失");
+	if (typeof kit.builtinProviders !== "function") problems.push("pi-ai builtinProviders 缺失");
+	for (const [api, factory] of Object.entries(kit.protocolFactories)) if (typeof factory !== "function") problems.push(`协议工厂 ${api} 缺失`);
+	if (typeof kit.LlmError !== "function") problems.push("dsh-llm LlmError 缺失");
+	if (typeof kit.resolveRetryPolicy !== "function") problems.push("dsh-llm resolveRetryPolicy 缺失");
+	if (problems.length > 0) throw new Error(`llm-pi: ${origin} 来源的运行时套件形状不兼容：${problems.join("；")}`);
+}
+/** 从 startDir 向上找同时含有 dsh-llm-pi-ai 与 pi-ai 的安装树根。 */
+function findDshTreeRoot(startDir) {
+	let dir = startDir;
+	for (let depth = 0; depth < 8; depth += 1) {
+		const nm = join(dir, "node_modules");
+		if (existsSync(join(nm, "@deepseek-ai", "dsh-llm-pi-ai", "lib", "index.js")) && existsSync(join(nm, "@earendil-works", "pi-ai", "dist", "index.js"))) return dir;
+		const parent = dirname(dir);
+		if (parent === dir) return void 0;
+		dir = parent;
+	}
+}
+/** 从 dsh 安装树按文件路径动态 import 全部套件模块（与官方插件同实例）。 */
+async function importTreeModules(root) {
+	const nm = join(root, "node_modules");
+	const load = (absPath) => import(pathToFileURL(absPath).href);
+	const [piAiAdapter, llm, piAi, catalog, completions, responses, anthropic] = await Promise.all([
+		load(join(nm, "@deepseek-ai", "dsh-llm-pi-ai", "lib", "index.js")),
+		load(join(nm, "@deepseek-ai", "dsh-llm", "lib", "index.js")),
+		load(join(nm, "@earendil-works", "pi-ai", "dist", "index.js")),
+		load(join(nm, "@earendil-works", "pi-ai", "dist", "providers", "all.js")),
+		load(join(nm, "@earendil-works", "pi-ai", "dist", "api", "openai-completions.lazy.js")),
+		load(join(nm, "@earendil-works", "pi-ai", "dist", "api", "openai-responses.lazy.js")),
+		load(join(nm, "@earendil-works", "pi-ai", "dist", "api", "anthropic-messages.lazy.js"))
+	]);
+	return {
+		piAiAdapter,
+		llm,
+		piAi,
+		catalog,
+		completions,
+		responses,
+		anthropic
+	};
+}
+function kitFromTree(mods) {
+	return {
+		source: "dsh-tree",
+		PiAiAdapter: mods.piAiAdapter["PiAiAdapter"],
+		LlmError: mods.llm["LlmError"],
+		resolveRetryPolicy: mods.llm["resolveRetryPolicy"],
+		attributionHeaders: mods.llm["attributionHeaders"],
+		normalizeApiKey: mods.llm["normalizeApiKey"],
+		assertUsableApiKey: mods.llm["assertUsableApiKey"],
+		INVALID_CREDENTIAL_CODE: mods.llm["INVALID_CREDENTIAL_CODE"],
+		createProvider: mods.piAi["createProvider"],
+		builtinProviders: mods.catalog["builtinProviders"],
+		getBuiltinProviders: mods.catalog["getBuiltinProviders"],
+		getBuiltinModels: mods.catalog["getBuiltinModels"],
+		protocolFactories: {
+			"openai-completions": mods.completions["openAICompletionsApi"],
+			"openai-responses": mods.responses["openAIResponsesApi"],
+			"anthropic-messages": mods.anthropic["anthropicMessagesApi"]
+		}
+	};
+}
+/** vendored 兜底副本套件（导出供单测直接使用，免走 dsh 树解析）。 */
+function loadVendoredKit() {
+	const kit = {
+		source: "vendored",
+		PiAiAdapter: vendoredPiAiAdapter.PiAiAdapter,
+		LlmError: vendoredLlm.LlmError,
+		resolveRetryPolicy: vendoredLlm.resolveRetryPolicy,
+		attributionHeaders: vendoredLlm.attributionHeaders,
+		normalizeApiKey: vendoredLlm.normalizeApiKey,
+		assertUsableApiKey: vendoredLlm.assertUsableApiKey,
+		INVALID_CREDENTIAL_CODE: vendoredLlm.INVALID_CREDENTIAL_CODE,
+		createProvider: vendoredPiAi.createProvider,
+		builtinProviders: vendoredCatalog.builtinProviders,
+		getBuiltinProviders: vendoredCatalog.getBuiltinProviders,
+		getBuiltinModels: vendoredCatalog.getBuiltinModels,
+		protocolFactories: {
+			"openai-completions": openAICompletionsApi,
+			"openai-responses": openAIResponsesApi,
+			"anthropic-messages": anthropicMessagesApi
+		}
+	};
+	assertKitShape(kit, "vendored");
+	return kit;
+}
+/** 定位 dsh 安装树根：realpath(argv[1]) 向上查找；argv 异常时返回 undefined。 */
+function dshTreeAnchor() {
+	const entry = process.argv[1];
+	if (entry === void 0) return void 0;
+	try {
+		return findDshTreeRoot(dirname(realpathSync(entry)));
+	} catch {
+		return;
+	}
+}
+/**
+* 解析运行时套件：优先 dsh 安装树（自动跟随上游），失败回退 vendored 副本；
+* 两者都过不了形状自检时抛错（调用方应记日志并放弃注册 route）。
+* 返回的 diagnostics 记录回退原因，供配置卡片与日志展示。
+*/
+async function resolveDshKit() {
+	const diagnostics = [];
+	const anchor = dshTreeAnchor();
+	if (anchor !== void 0) try {
+		const kit = kitFromTree(await importTreeModules(anchor));
+		assertKitShape(kit, "dsh-tree");
+		return {
+			kit,
+			diagnostics
+		};
+	} catch (error) {
+		diagnostics.push(`dsh 安装树套件不可用（${anchor}）：${error instanceof Error ? error.message : String(error)}；回退 vendored 副本`);
+	}
+	else diagnostics.push("未能从 process.argv[1] 定位 dsh 安装树；回退 vendored 副本");
+	return {
+		kit: loadVendoredKit(),
+		diagnostics
+	};
+}
+
+//#endregion
+//#region src/service.ts
+/** 注册时捕获的事实表；变化才重注册（按 provider 排序，免序误报）。 */
+function registrationFacts(profiles) {
+	return [...profiles.entries()].map(([provider, profile]) => ({
+		provider,
+		displayName: profile.displayName,
+		retryPolicy: profile.retryPolicy
+	})).sort((left, right) => left.provider.localeCompare(right.provider));
+}
+/** 凭据解析（逐行对齐官方 resolveApiKey）：凭据服务优先，缺失时启动环境兜底。 */
+function makeResolveApiKey(ctx, kit) {
+	return async (provider, profile) => {
+		const ref = profile.apiKeyEnv;
+		if (ref === void 0) return void 0;
+		const credentials = ctx.get("credentials");
+		const hit = credentials !== void 0 ? (await credentials.resolve(ref))?.value : launchEnvironmentOf(ctx).get(ref)?.value;
+		if (hit !== void 0 && hit.length > 0) return kit.assertUsableApiKey(hit, "llm-pi", ref);
+		throw new kit.LlmError(`llm-pi: provider route "${provider}" 的凭据引用 ${String(ref)} 未解析到值——请经凭据服务（web Models 页）存放或导出环境变量；仅当该 provider 应使用 pi-ai 自有环境发现时才移除 apiKeyEnv`, "MISSING_CREDENTIAL");
+	};
+}
+/** 启动插件运行时：解析套件、挂载注册/发现/settings 联动。 */
+async function startRuntime(ctx, rawConfig) {
+	const logger = ctx.logger("llm-pi");
+	const config = Config(rawConfig ?? {});
+	const { kit, diagnostics } = await resolveDshKit();
+	for (const line of diagnostics) logger.warn(line);
+	logger.info(`运行时套件来源：${kit.source}`);
+	const modelsDev = new ModelsDevSource(dshHomePath("storages", "dsh-plus-llm-pi", "models-dev.json"), config.catalogUrl, config.catalogRefreshHours, (message) => logger.warn(message), config.catalogProxy ?? "");
+	modelsDev.ensureLoaded();
+	let current = () => config;
+	let lastRaw;
+	let memoized;
+	const deps = {
+		kit,
+		modelsDev
+	};
+	/** 当前已解析 profiles，按原始 config identity 备忘（官方同款模式）。
+	*  运行期走 lenient：数据源漂移时降级/跳过并告警，而非抛错弄挂整个 route。 */
+	const profiles = () => {
+		const raw = current();
+		if (raw === lastRaw && memoized !== void 0) return memoized;
+		const next = raw.enabled ? buildProfiles(raw.providers, {
+			...deps,
+			lenient: true,
+			warn: (message) => logger.warn(message)
+		}) : /* @__PURE__ */ new Map();
+		lastRaw = raw;
+		memoized = next;
+		return next;
+	};
+	profiles();
+	const adapter = new kit.PiAiAdapter({
+		profiles,
+		resolveApiKey: makeResolveApiKey(ctx, kit),
+		resolveAttachments: () => ctx.get("attachments")
+	});
+	const storedApiKey = async (provider) => {
+		if (provider === void 0) return void 0;
+		const profile = profiles().get(provider);
+		if (profile === void 0) return void 0;
+		return makeResolveApiKey(ctx, kit)(provider, profile);
+	};
+	ctx.llm.registerModelDiscovery(SETTINGS_NS, (request$2) => discoverModels(request$2, {
+		kit,
+		configProviders: () => current().providers ?? {},
+		storedApiKey
+	}));
+	let registrations;
+	let registeredFacts;
+	const registerGroup = (routes, fallback) => {
+		try {
+			return [{
+				routes,
+				handle: ctx.llm.registerAdapter(routes, adapter)
+			}];
+		} catch (error) {
+			fallback(error);
+			const groups = [];
+			for (const route of routes) try {
+				const handle = ctx.llm.registerAdapter([route], adapter);
+				groups.push({
+					routes: [route],
+					handle
+				});
+			} catch (routeError) {
+				logger.error(`llm-pi: route "${route}" 注册失败（可能与其他 adapter 重名），该 route 不可用`);
+				logger.error(routeError);
+			}
+			return groups;
+		}
+	};
+	const ensureRegistration = () => {
+		const current2 = profiles();
+		const facts = registrationFacts(current2);
+		if (deepEqualJson(facts, registeredFacts)) return;
+		const routes = [...current2.keys()];
+		if (registrations === void 0) {
+			if (routes.length === 0) {
+				registeredFacts = facts;
+				return;
+			}
+			registrations = registerGroup(routes, (error) => {
+				logger.warn("llm-pi: 整批注册失败（可能 route 名冲突），降级为逐个 route 注册");
+				logger.warn(error);
+			});
+		} else try {
+			registrations[0].handle.replace(routes);
+			for (let i = 1; i < registrations.length; i += 1) registrations[i].handle.replace([]);
+			registrations = [{
+				routes,
+				handle: registrations[0].handle
+			}];
+		} catch (error) {
+			logger.error("llm-pi: 更新被拒，保留此前注册的 route");
+			logger.error(error);
+		}
+		registeredFacts = facts;
+	};
+	let directory;
+	let directoryFacts;
+	const ensureDirectory = () => {
+		const entries = [...profiles().entries()].map(([provider, profile]) => ({
+			provider,
+			displayName: profile.displayName,
+			settingsNs: SETTINGS_NS,
+			settingsPath: ["providers", provider],
+			declared: !hasBuiltinProvider(kit, provider)
+		}));
+		if (deepEqualJson(entries, directoryFacts)) return;
+		if (entries.length === 0) {
+			directoryFacts = entries;
+			return;
+		}
+		if (directory === void 0) directory = ctx.llm.registerConfigurableProviders(entries);
+		else directory.replace(entries);
+		directoryFacts = entries;
+	};
+	ensureRegistration();
+	ensureDirectory();
+	installSettingsSection(ctx, SETTINGS_NS, Config, config, {
+		validate: (cfg) => assertServiceable(cfg, deps),
+		setSource: (source) => {
+			current = source;
+		},
+		onChange: () => {
+			try {
+				ensureRegistration();
+			} catch (error) {
+				logger.error("llm-pi: 更新被拒，保留此前注册的 route");
+				logger.error(error);
+			}
+			try {
+				ensureDirectory();
+			} catch (error) {
+				logger.error("llm-pi: 更新被拒，保留此前的 configurable-provider 目录");
+				logger.error(error);
+			}
+			const cfg = current();
+			modelsDev.reconfigure(cfg.catalogUrl, cfg.catalogRefreshHours, cfg.catalogProxy ?? "");
+		}
+	});
+	return {
+		currentConfig: () => current(),
+		kitInfo: () => ({
+			source: kit.source,
+			diagnostics
+		}),
+		modelsDev,
+		kit
+	};
+}
+
+//#endregion
+//#region src/index.ts
+const name = "dsh-plus-llm-pi";
+const inject = ["llm"];
+async function apply(ctx, config) {
+	const runtime = await startRuntime(ctx, config);
+	ctx.inject(["webServer"], (webCtx) => {
+		registerConfigApi(webCtx, runtime);
+	});
+}
+
+//#endregion
+export { Config, SETTINGS_NS, apply, inject, name };