@siliconflow-official/dsh-llm-siliconflow 0.2.0-rc.1 → 0.2.0-rc.3

package/README.md

@@ -34,6 +34,24 @@ dsh-siliconflow-setup
 export SILICONFLOW_API_KEY=sk-...   # 或写入 $DSH_HOME/.credentials.yaml
 ```
 
+写入 `.credentials.yaml` 采用**跨代兼容规则**（单一构建同时服务新旧两代 dsh）：
+
+- **新文件 / 扁平（无 `version`）文件 → 保持扁平写入**：旧代 dsh（credentials-local 0.1.0）原生可读；新代 dsh 会在下次启动时自动迁移为 `version: 1`。
+- **已是 `version: 1` 的文件 → 保持 version-1 写入**：新代用户永不降级；新旧两代读路径都识别这两种布局。
+- 其他无法识别的文档（未知键、非法结构）会明确报错而不是被改写；早期版本向导误写的顶层键会在写入时折回 `refs:`。
+
+```yaml
+# 向导写出的新文件（扁平，两代公共分母）：
+OTHER_KEY: sk-...
+SILICONFLOW_API_KEY: sk-...
+
+# 新代 dsh 首次启动后自动迁移为：
+version: 1
+refs:
+  OTHER_KEY: sk-...
+  SILICONFLOW_API_KEY: sk-...
+```
+
 在包发布到 npm 之前，先用 `pnpm install && pnpm build` 构建出 `lib/`，再从本地路径安装：
 
 ```sh

package/lib/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as PUBLIC_BASE_URL, g as discoverChatModels, i as PROVIDER, n as DEFAULT_API_KEY_ENV, r as DEFAULT_MODELS } from "./types-BWDupDnP.js";
+import { _ as discoverChatModels, a as PUBLIC_BASE_URL, i as PROVIDER, n as DEFAULT_API_KEY_ENV, r as DEFAULT_MODELS } from "./types-IqSaZRz4.js";
 import { createInterface } from "node:readline/promises";
 import { stdin, stdout } from "node:process";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
@@ -45,11 +45,66 @@ function settingsPath(home) {
 function isEnoent(error) {
 	return error.code === "ENOENT";
 }
+/** The credentials document layout version this wizard reads and writes. */
+const CREDENTIALS_LAYOUT_VERSION = 1;
+/** POSIX identifier rule the credentials seam addresses references by. */
+const REF_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 /**
-* Read one credential reference from a comment-preserving document.
+* Recognize one parsed credentials document.
+* @param document - the parsed document; parse errors make it unrecognizable.
+* @returns the admitted layout with its references — plus, under `extraKeys`,
+*   any top-level key a pre-fix release of this wizard left beside `version`,
+*   held out of `entries` so reads treat them as absent while the write path
+*   folds them back under `refs` — or `undefined` when the document does not
+*   parse, holds an unknown `version`, carries a `refs` section that is not a
+*   mapping of reference names to non-empty strings, or holds any other
+*   top-level entry this build cannot attribute to its own predecessor.
+*/
+function admitCredentialsDocument(document) {
+	if (document.errors.length > 0) return void 0;
+	const root = document.toJS() ?? {};
+	if (typeof root !== "object" || root === null) return void 0;
+	const fields = root;
+	const entries = /* @__PURE__ */ new Map();
+	if (!("version" in fields)) {
+		for (const [key, value] of Object.entries(fields)) {
+			if (!REF_NAME_PATTERN.test(key)) return void 0;
+			if (typeof value !== "string" || value.length === 0) return void 0;
+			entries.set(key, value);
+		}
+		return {
+			kind: "flat",
+			entries
+		};
+	}
+	if (fields.version !== CREDENTIALS_LAYOUT_VERSION) return void 0;
+	const refs = fields["refs"];
+	if (refs !== void 0) {
+		if (typeof refs !== "object" || refs === null) return void 0;
+		for (const [key, value] of Object.entries(refs)) {
+			if (!REF_NAME_PATTERN.test(key)) return void 0;
+			if (typeof value !== "string" || value.length === 0) return void 0;
+			entries.set(key, value);
+		}
+	}
+	const extraKeys = /* @__PURE__ */ new Map();
+	for (const [key, value] of Object.entries(fields)) {
+		if (key === "version" || key === "refs" || key === "records") continue;
+		if (!REF_NAME_PATTERN.test(key) || typeof value !== "string" || value.length === 0) return void 0;
+		extraKeys.set(key, value);
+	}
+	return {
+		kind: "versioned",
+		entries,
+		...extraKeys.size > 0 ? { extraKeys } : {}
+	};
+}
+/**
+* Read one credential reference from a versioned or pre-release flat document.
 * @param path - the credentials document path.
-* @param keyEnv - the top-level reference name (e.g. `SILICONFLOW_API_KEY`).
-* @returns the stored value, or `undefined` when absent or the file is missing.
+* @param keyEnv - the reference name to read (e.g. `SILICONFLOW_API_KEY`).
+* @returns the stored value, or `undefined` when the reference is absent, the
+*   file is missing, or the document is not a recognizable layout.
 */
 async function readCredential(path, keyEnv) {
 	let text;
@@ -59,18 +114,47 @@ async function readCredential(path, keyEnv) {
 		if (isEnoent(error)) return void 0;
 		throw error;
 	}
-	const value = parseDocument(text).toJS()?.[keyEnv];
-	return typeof value === "string" && value.length > 0 ? value : void 0;
+	const admitted = admitCredentialsDocument(parseDocument(text));
+	if (admitted === void 0) return void 0;
+	return admitted.entries.get(keyEnv);
 }
 /**
-* Set one credential reference, preserving every other entry and comment.
+* Write one credential reference, preserving the document's own layout family
+* and every other entry and comment.
+*
+* Cross-era rule (0.2.0-rc.3): which layout a FRESH document gets is decided
+* by what both dsh eras can read, not by this build's version clock. The OLD
+* credentials-local (0.1.0-rc.8) reads only the flat layout; the NEW one
+* (0.1.1+) reads only version-1 but migrates a version-less flat document on
+* its next boot. Flat is therefore the common denominator: a fresh or flat
+* document stays flat under this write, and the running dsh upgrades it when
+* that dsh is new-era. An existing versioned document keeps version-1 so a
+* new-era user is never downgraded; an old-era user with a versioned document
+* still has a file old dsh rejects — that file predates this rule and is
+* repaired by re-running setup on a flat base or by hand.
+*
+* A top-level key a pre-fix release of this wizard left beside `version` is
+* folded back under `refs`, so one run repairs the file its predecessor
+* corrupted. An unrecognized document fails loud instead of being rewritten —
+* a silent rewrite would hide why the running harness rejects it.
 * @param path - the credentials document path; created when absent.
-* @param keyEnv - the top-level reference name to write.
+* @param keyEnv - the reference name to write.
 * @param key - the value.
+* @throws when the document exists but is not a recognizable credentials layout.
 */
 async function writeCredential(path, keyEnv, key) {
 	const doc = await loadDocument(path);
-	doc.set(keyEnv, key);
+	const admitted = admitCredentialsDocument(doc);
+	if (admitted === void 0) throw new Error(`setup: ${path} is not a recognizable credentials document (expected version 1 with a refs section, or the pre-release flat layout); fix it before running setup`);
+	if (admitted.kind === "flat") {
+		doc.setIn([keyEnv], key);
+		await persistDocument(path, doc);
+		return;
+	}
+	for (const extra of admitted.extraKeys?.keys() ?? []) doc.deleteIn([extra]);
+	for (const [extra, value] of admitted.extraKeys ?? /* @__PURE__ */ new Map()) doc.setIn(["refs", extra], value);
+	doc.setIn(["version"], CREDENTIALS_LAYOUT_VERSION);
+	doc.setIn(["refs", keyEnv], key);
 	await persistDocument(path, doc);
 }
 /**

package/lib/index.js

@@ -1,2 +1,2 @@
-import { _ as listingUrl, a as PUBLIC_BASE_URL, c as name, d as DEFAULT_MAX_TOKENS, f as DEFAULT_STREAM_IDLE_TIMEOUT_MS, g as discoverChatModels, h as inferInputModalities, i as PROVIDER, l as resolveAdapterOptions, m as SiliconFlowAdapter, n as DEFAULT_API_KEY_ENV, o as apply, p as DISCOVERY_TTL_MS, r as DEFAULT_MODELS, s as inject, t as Config, u as DEFAULT_CONTEXT_WINDOW, v as readListing } from "./types-BWDupDnP.js";
-export { Config, DEFAULT_API_KEY_ENV, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS, DEFAULT_MODELS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, DISCOVERY_TTL_MS, PROVIDER, PUBLIC_BASE_URL, SiliconFlowAdapter, apply, discoverChatModels, inferInputModalities, inject, listingUrl, name, readListing, resolveAdapterOptions };
+import { _ as discoverChatModels, a as PUBLIC_BASE_URL, c as inject, d as DEFAULT_CONTEXT_WINDOW, f as DEFAULT_MAX_TOKENS, g as inferInputModalities, h as SiliconFlowAdapter, i as PROVIDER, l as name, m as DISCOVERY_TTL_MS, n as DEFAULT_API_KEY_ENV, o as apply, p as DEFAULT_STREAM_IDLE_TIMEOUT_MS, r as DEFAULT_MODELS, s as assembleSettingsSection, t as Config, u as resolveAdapterOptions, v as listingUrl, y as readListing } from "./types-IqSaZRz4.js";
+export { Config, DEFAULT_API_KEY_ENV, DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS, DEFAULT_MODELS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, DISCOVERY_TTL_MS, PROVIDER, PUBLIC_BASE_URL, SiliconFlowAdapter, apply, assembleSettingsSection, discoverChatModels, inferInputModalities, inject, listingUrl, name, readListing, resolveAdapterOptions };

package/lib/types/dsh-era.d.ts

@@ -0,0 +1,133 @@
+/**
+ * Single-build cross-era compatibility for the DeepSeek Harness dsh family.
+ *
+ * One published plugin build must run inside TWO dsh runtime closures:
+ *
+ * - the NEW era (dsh 0.1.2+ LLM family, first shipped 2026-08-30):
+ *   `ToolCallId` brand, `version: 1` credentials layout (`refs:` nesting,
+ *   unknown top-level keys hard-fail), settings installed via the service
+ *   method `installSection`, model discovery via `LlmModelDiscoveryOperation`
+ *   (extends `LlmModelDiscoveryRequest` with optional `signal`).
+ * - the OLD era (dsh-llm 0.1.1 and earlier; credentials-local 0.1.0):
+ *   `CallId` brand, flat top-level credentials (no `version` key),
+ *   settings installed via the module function `installSettingsSection`,
+ *   model discovery via `LlmModelDiscoveryRequest` carrying `signal`.
+ *
+ * Compatibility rules this module relies on, established against real
+ * published packages (npm tarballs), not assumptions:
+ *
+ * 1. ESM link-time export validation only applies to NAMED imports
+ *    (`import { ToolCallId }`). A missing named export throws SyntaxError at
+ *    link time and the module never evaluates — exactly the reported
+ *    `SyntaxError: … does not provide an export named 'CallId'`. A NAMESPACE
+ *    import (`import * as llm`) links unconditionally; missing members are
+ *    simply `undefined` at runtime. Every era-sensitive value therefore comes
+ *    from the namespace object, never from a named import.
+ * 2. Exports BOTH eras ship (verified in 0.1.1-rc.2 and 0.1.5-rc.2):
+ *    EMPTY_RESPONSE_CODE, LlmError, LlmAdapter, ProviderRequestId,
+ *    QUOTA_EXCEEDED_CODE, RetryPolicySchema, assertUsableApiKey,
+ *    resolveRetryPolicy, attributionHeaders, isQuotaExceededError,
+ *    isContextWindowExceededError, CONTEXT_WINDOW_EXCEEDED_CODE. Named
+ *    imports of these stay safe in both eras.
+ * 3. `dsh-util-values` postdates the OLD era entirely (404 there); its one
+ *    consumer in this plugin, `deepEqualJson`, is inlined below.
+ *
+ * The era probe: `typeof ns.ToolCallId === 'function'`. NEW era exports
+ * ToolCallId; OLD era exports CallId instead. One probe classifies the
+ * closure and stays stable under future renames.
+ *
+ * @module dsh-llm-siliconflow/dsh-era
+ */
+import type { ToolCallId as ToolCallIdType } from '@deepseek-ai/dsh-llm';
+/**
+ * The raw namespace, exported for era-sensitive call sites. Typed loosely:
+ * the OLD-era variant of a member is unknown to the NEW-era .d.ts and vice
+ * versa, so era-shape access happens through this record, never the typed
+ * import.
+ */
+export declare const dshLLM: Record<string, unknown>;
+/** True when the running dsh closure is the NEW era (ToolCallId present). */
+export declare const isNewEra: boolean;
+/**
+ * Construct a provider tool-call id brand for the running era: `ToolCallId`
+ * in the NEW era, `CallId` in the OLD. The constructor is resolved at call
+ * time from the live namespace; a closure exposing neither fails loud.
+ *
+ * @param raw - the raw provider id, e.g. `block.callId ?? ''`.
+ * @returns the era-correct branded id.
+ */
+export declare function toolCallIdOf(raw: string): ToolCallIdType;
+/**
+ * Structural JSON equality over plain values (the shape settings documents
+ * and retry policies are made of). Inlined from dsh-util-values so the plugin
+ * carries no dependency on a NEW-era-only package: the OLD-era closure cannot
+ * even install dsh-util-values, which used to break npm resolution of this
+ * plugin under old dsh homes.
+ *
+ * Owned here over the value domain the plugin actually observes (plain JSON
+ * documents): recursion by key set, so object member order never matters —
+ * the upstream package compares structurally, and JSON.stringify would make
+ * order significant, corrupting that contract.
+ *
+ * @param a - one plain JSON value.
+ * @param b - another plain JSON value.
+ * @returns true when both represent the same JSON value.
+ */
+export declare function deepEqualJson(a: unknown, b: unknown): boolean;
+/**
+ * The era-neutral discovery-request shape one callback can serve both eras
+ * from: the fields the SiliconFlow discovery callback reads. In the OLD era
+ * the caller passes `LlmModelDiscoveryRequest` (signal present as a field);
+ * in the NEW era `LlmModelDiscoveryOperation` (same field, optional).
+ */
+export interface ModelDiscoveryShape {
+    /** Route being edited, when it edits an existing one. */
+    provider?: string;
+    /** Endpoint to interrogate. */
+    baseURL?: string;
+    /** Wire protocol the endpoint speaks, when the draft names one. */
+    api?: string;
+    /** Credential for this interrogation alone; never stored by the harness. */
+    apiKey?: string;
+    /** Caller cancellation; present in both eras, optional in the new one. */
+    signal?: AbortSignal;
+}
+/**
+ * The era-neutral settings-hooks shape. The OLD and NEW installers take
+ * identical hook objects; only the mount point moved between eras.
+ * Parameterized on the entry type so it flows through without variance
+ * friction against exactOptionalPropertyTypes.
+ */
+export interface EraSettingsHooks<T> {
+    setSource: (source: () => T) => void;
+    onChange: () => void;
+}
+/**
+ * Structural mirror of the NEW-era settings namespace input type (a lowercase
+ * hyphenated identifier). Declared locally so this plugin typechecks under the
+ * OLD-era closure, where `@deepseek-ai/dsh-settings` exports a differently
+ * shaped `SettingsNamespace`; the namespace value itself is identical either way.
+ */
+export type SettingsNamespaceInput = string;
+/**
+ * The settings package namespace as a plain record. The OLD era exports
+ * installSettingsSection as a MODULE-LEVEL function (it performs its own
+ * ctx.inject(['settings']) internally); the NEW era dropped that export and
+ * moved the installer onto the service class as installSection. Era probes
+ * must consult BOTH surfaces: the module namespace for the old path, the
+ * service object for the new one — probing only one proved wrong against
+ * real packages (verified against 0.1.1-rc.2 and 0.1.5-rc.2 tarballs).
+ */
+export declare const dshSettings: Record<string, unknown>;
+/**
+ * The era-union settings service seen by the plugin: the NEW era exposes
+ * installSection as a service method; the OLD era exported
+ * installSettingsSection as a module function (also re-exported by the
+ * service object). Signatures are identical (owner, ns, schema, entry, hooks)
+ * — only the mount point moved.
+ */
+export interface EraSettingsService {
+    installSection?: <T>(owner: unknown, ns: SettingsNamespaceInput, schema: unknown, entry: T, hooks: EraSettingsHooks<T>) => void;
+    installSettingsSection?: <T>(owner: unknown, ns: SettingsNamespaceInput, schema: unknown, entry: T, hooks: EraSettingsHooks<T>) => void;
+}
+//# sourceMappingURL=dsh-era.d.ts.map

package/lib/types/index.d.ts

@@ -18,6 +18,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
 import type { RetryPolicyConfig } from '@deepseek-ai/dsh-llm';
 import { type LaunchEnvironmentSnapshot } from '@deepseek-ai/dsh-launch-environment';
+import { type EraSettingsHooks, type EraSettingsService } from './dsh-era.ts';
 import type { SiliconFlowCatalogModel, SiliconFlowConnectionOptions } from './adapter.ts';
 export { DEFAULT_CONTEXT_WINDOW, DEFAULT_MAX_TOKENS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, DISCOVERY_TTL_MS, SiliconFlowAdapter, } from './adapter.ts';
 export { inferInputModalities } from './adapter.ts';
@@ -91,4 +92,29 @@ export type ResolvedSiliconFlowOptions = SiliconFlowConnectionOptions;
  */
 export declare function resolveAdapterOptions(config: Config, environment?: LaunchEnvironmentSnapshot): ResolvedSiliconFlowOptions;
 export declare function apply(ctx: Context, config: Config): void;
+/**
+ * Install the settings through whichever surface the running era exposes.
+ *
+ * NEW era (dsh-settings 0.1.2+): the injected settings SERVICE carries the
+ * installer as the method `installSection` — invoked as a method so the
+ * service's registration state stays bound.
+ *
+ * OLD era (dsh-settings 0.1.1): the installer is the MODULE-LEVEL function
+ * `installSettingsSection` from '@deepseek-ai/dsh-settings' — it performs
+ * its own ctx.inject(['settings']) internally, so it is called directly with
+ * (owner, ns, schema, entry, hooks). No service argument is involved.
+ *
+ * Probing taught against real packages (0.1.1-rc.2 / 0.1.5-rc.2 tarballs):
+ * the OLD service object has NO installSettingsSection member, and the NEW
+ * module has NO installSettingsSection export — probing a single surface
+ * would throw on the other era. Both surfaces are checked in order; when
+ * the running dsh exposes neither, this fails loud instead of silently
+ * dropping the section.
+ */
+export declare function assembleSettingsSection<T>(service: EraSettingsService, args: {
+    owner: Context;
+    ns: string;
+    schema: unknown;
+    entry: T;
+} & EraSettingsHooks<T>): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/setup.d.ts

@@ -56,17 +56,36 @@ export declare function credentialsPath(home: string): string;
 /** The settings document path under a harness home. */
 export declare function settingsPath(home: string): string;
 /**
- * Read one credential reference from a comment-preserving document.
+ * Read one credential reference from a versioned or pre-release flat document.
  * @param path - the credentials document path.
- * @param keyEnv - the top-level reference name (e.g. `SILICONFLOW_API_KEY`).
- * @returns the stored value, or `undefined` when absent or the file is missing.
+ * @param keyEnv - the reference name to read (e.g. `SILICONFLOW_API_KEY`).
+ * @returns the stored value, or `undefined` when the reference is absent, the
+ *   file is missing, or the document is not a recognizable layout.
  */
 export declare function readCredential(path: string, keyEnv: string): Promise<string | undefined>;
 /**
- * Set one credential reference, preserving every other entry and comment.
+ * Write one credential reference, preserving the document's own layout family
+ * and every other entry and comment.
+ *
+ * Cross-era rule (0.2.0-rc.3): which layout a FRESH document gets is decided
+ * by what both dsh eras can read, not by this build's version clock. The OLD
+ * credentials-local (0.1.0-rc.8) reads only the flat layout; the NEW one
+ * (0.1.1+) reads only version-1 but migrates a version-less flat document on
+ * its next boot. Flat is therefore the common denominator: a fresh or flat
+ * document stays flat under this write, and the running dsh upgrades it when
+ * that dsh is new-era. An existing versioned document keeps version-1 so a
+ * new-era user is never downgraded; an old-era user with a versioned document
+ * still has a file old dsh rejects — that file predates this rule and is
+ * repaired by re-running setup on a flat base or by hand.
+ *
+ * A top-level key a pre-fix release of this wizard left beside `version` is
+ * folded back under `refs`, so one run repairs the file its predecessor
+ * corrupted. An unrecognized document fails loud instead of being rewritten —
+ * a silent rewrite would hide why the running harness rejects it.
  * @param path - the credentials document path; created when absent.
- * @param keyEnv - the top-level reference name to write.
+ * @param keyEnv - the reference name to write.
  * @param key - the value.
+ * @throws when the document exists but is not a recognizable credentials layout.
  */
 export declare function writeCredential(path: string, keyEnv: string, key: string): Promise<void>;
 /**

package/lib/{types-BWDupDnP.js → types-IqSaZRz4.js}

@@ -1,11 +1,119 @@
 import z from "@deepseek-ai/schemastery";
-import { CONTEXT_WINDOW_EXCEEDED_CODE, CallId, EMPTY_RESPONSE_CODE, LlmAdapter, LlmError, ProviderRequestId, QUOTA_EXCEEDED_CODE, RetryPolicySchema, assertUsableApiKey, attributionHeaders, isContextWindowExceededError, isQuotaExceededError, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
+import * as llm from "@deepseek-ai/dsh-llm";
+import { CONTEXT_WINDOW_EXCEEDED_CODE, EMPTY_RESPONSE_CODE, LlmAdapter, LlmError, ProviderRequestId, QUOTA_EXCEEDED_CODE, RetryPolicySchema, assertUsableApiKey, attributionHeaders, isContextWindowExceededError, isQuotaExceededError, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
-import { deepEqualJson, installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+import * as settingsModule from "@deepseek-ai/dsh-settings";
 import { MAX_TIMER_DELAY_MS, idleWatchdog, timeoutOf } from "@deepseek-ai/dsh-timeout";
 import { getOrCreateAnonymousUserId } from "@deepseek-ai/dsh-anonymous-user-id";
 import { EventSourceParserStream } from "eventsource-parser/stream";
+//#region lib/types/dsh-era.js
+/**
+* Single-build cross-era compatibility for the DeepSeek Harness dsh family.
+*
+* One published plugin build must run inside TWO dsh runtime closures:
+*
+* - the NEW era (dsh 0.1.2+ LLM family, first shipped 2026-08-30):
+*   `ToolCallId` brand, `version: 1` credentials layout (`refs:` nesting,
+*   unknown top-level keys hard-fail), settings installed via the service
+*   method `installSection`, model discovery via `LlmModelDiscoveryOperation`
+*   (extends `LlmModelDiscoveryRequest` with optional `signal`).
+* - the OLD era (dsh-llm 0.1.1 and earlier; credentials-local 0.1.0):
+*   `CallId` brand, flat top-level credentials (no `version` key),
+*   settings installed via the module function `installSettingsSection`,
+*   model discovery via `LlmModelDiscoveryRequest` carrying `signal`.
+*
+* Compatibility rules this module relies on, established against real
+* published packages (npm tarballs), not assumptions:
+*
+* 1. ESM link-time export validation only applies to NAMED imports
+*    (`import { ToolCallId }`). A missing named export throws SyntaxError at
+*    link time and the module never evaluates — exactly the reported
+*    `SyntaxError: … does not provide an export named 'CallId'`. A NAMESPACE
+*    import (`import * as llm`) links unconditionally; missing members are
+*    simply `undefined` at runtime. Every era-sensitive value therefore comes
+*    from the namespace object, never from a named import.
+* 2. Exports BOTH eras ship (verified in 0.1.1-rc.2 and 0.1.5-rc.2):
+*    EMPTY_RESPONSE_CODE, LlmError, LlmAdapter, ProviderRequestId,
+*    QUOTA_EXCEEDED_CODE, RetryPolicySchema, assertUsableApiKey,
+*    resolveRetryPolicy, attributionHeaders, isQuotaExceededError,
+*    isContextWindowExceededError, CONTEXT_WINDOW_EXCEEDED_CODE. Named
+*    imports of these stay safe in both eras.
+* 3. `dsh-util-values` postdates the OLD era entirely (404 there); its one
+*    consumer in this plugin, `deepEqualJson`, is inlined below.
+*
+* The era probe: `typeof ns.ToolCallId === 'function'`. NEW era exports
+* ToolCallId; OLD era exports CallId instead. One probe classifies the
+* closure and stays stable under future renames.
+*
+* @module dsh-llm-siliconflow/dsh-era
+*/
+/**
+* The raw namespace, exported for era-sensitive call sites. Typed loosely:
+* the OLD-era variant of a member is unknown to the NEW-era .d.ts and vice
+* versa, so era-shape access happens through this record, never the typed
+* import.
+*/
+const dshLLM = llm;
+dshLLM["ToolCallId"];
+/**
+* Construct a provider tool-call id brand for the running era: `ToolCallId`
+* in the NEW era, `CallId` in the OLD. The constructor is resolved at call
+* time from the live namespace; a closure exposing neither fails loud.
+*
+* @param raw - the raw provider id, e.g. `block.callId ?? ''`.
+* @returns the era-correct branded id.
+*/
+function toolCallIdOf(raw) {
+	const ctor = dshLLM["ToolCallId"] ?? dshLLM["CallId"];
+	if (ctor === void 0) throw new Error("neither ToolCallId nor CallId is exported by @deepseek-ai/dsh-llm");
+	return ctor(raw);
+}
+/**
+* Structural JSON equality over plain values (the shape settings documents
+* and retry policies are made of). Inlined from dsh-util-values so the plugin
+* carries no dependency on a NEW-era-only package: the OLD-era closure cannot
+* even install dsh-util-values, which used to break npm resolution of this
+* plugin under old dsh homes.
+*
+* Owned here over the value domain the plugin actually observes (plain JSON
+* documents): recursion by key set, so object member order never matters —
+* the upstream package compares structurally, and JSON.stringify would make
+* order significant, corrupting that contract.
+*
+* @param a - one plain JSON value.
+* @param b - another plain JSON value.
+* @returns true when both represent the same JSON value.
+*/
+function deepEqualJson(a, b) {
+	if (a === b) return true;
+	if (a === null || b === null) return false;
+	if (typeof a !== typeof b) return false;
+	if (typeof a !== "object") return a === b;
+	const ao = a;
+	const bo = b;
+	if (Array.isArray(ao) !== Array.isArray(bo)) return false;
+	if (Array.isArray(ao) && Array.isArray(bo)) {
+		if (ao.length !== bo.length) return false;
+		return ao.every((item, i) => deepEqualJson(item, bo[i]));
+	}
+	const ak = Object.keys(ao);
+	const bk = Object.keys(bo);
+	if (ak.length !== bk.length) return false;
+	if (!ak.every((k) => k in bo)) return false;
+	return ak.every((k) => deepEqualJson(ao[k], bo[k]));
+}
+/**
+* The settings package namespace as a plain record. The OLD era exports
+* installSettingsSection as a MODULE-LEVEL function (it performs its own
+* ctx.inject(['settings']) internally); the NEW era dropped that export and
+* moved the installer onto the service class as installSection. Era probes
+* must consult BOTH surfaces: the module namespace for the old path, the
+* service object for the new one — probing only one proved wrong against
+* real packages (verified against 0.1.1-rc.2 and 0.1.5-rc.2 tarballs).
+*/
+const dshSettings = settingsModule;
+//#endregion
 //#region lib/types/discovery.js
 /**
 * Interrogate the SiliconFlow (OpenAI-compatible) `GET /models` listing for
@@ -408,7 +516,7 @@ function closeBlock(block) {
 		};
 		case "tool-call": return {
 			type: "tool-call",
-			id: CallId(block.callId ?? ""),
+			id: toolCallIdOf(block.callId ?? ""),
 			name: block.name ?? "",
 			arguments: block.text
 		};
@@ -523,7 +631,7 @@ async function* translate(payloads) {
 				yield {
 					type: "tool-call-delta",
 					index: block.index,
-					id: CallId(block.callId ?? ""),
+					id: toolCallIdOf(block.callId ?? ""),
 					...block.name !== void 0 ? { name: block.name } : {},
 					argumentsDelta: fragment
 				};
@@ -896,7 +1004,7 @@ var SiliconFlowAdapter = class extends LlmAdapter {
 */
 const name = "llm-siliconflow";
 const inject = ["llm"];
-const NS = settingsNamespace("llm-siliconflow");
+const NS = "llm-siliconflow";
 /** Credential reference this plugin reads by default, also used by the setup CLI. */
 const DEFAULT_API_KEY_ENV = "SILICONFLOW_API_KEY";
 /** The single provider route this plugin owns. */
@@ -1125,12 +1233,49 @@ function apply(ctx, config) {
 		registration.replace([PROVIDER]);
 		registeredPolicy = policy;
 	};
-	installSettingsSection(ctx, NS, Config, config, {
-		setSource: (source) => {
-			current = source;
-		},
-		onChange: ensureRegistrationFacts
+	ctx.inject(["settings"], (settingsCtx) => {
+		assembleSettingsSection(settingsCtx.settings, {
+			owner: ctx,
+			ns: NS,
+			schema: Config,
+			entry: config,
+			setSource: (source) => {
+				current = source;
+			},
+			onChange: ensureRegistrationFacts
+		});
 	});
 }
+/**
+* Install the settings through whichever surface the running era exposes.
+*
+* NEW era (dsh-settings 0.1.2+): the injected settings SERVICE carries the
+* installer as the method `installSection` — invoked as a method so the
+* service's registration state stays bound.
+*
+* OLD era (dsh-settings 0.1.1): the installer is the MODULE-LEVEL function
+* `installSettingsSection` from '@deepseek-ai/dsh-settings' — it performs
+* its own ctx.inject(['settings']) internally, so it is called directly with
+* (owner, ns, schema, entry, hooks). No service argument is involved.
+*
+* Probing taught against real packages (0.1.1-rc.2 / 0.1.5-rc.2 tarballs):
+* the OLD service object has NO installSettingsSection member, and the NEW
+* module has NO installSettingsSection export — probing a single surface
+* would throw on the other era. Both surfaces are checked in order; when
+* the running dsh exposes neither, this fails loud instead of silently
+* dropping the section.
+*/
+function assembleSettingsSection(service, args) {
+	if (typeof service.installSection === "function") {
+		service.installSection(args.owner, args.ns, args.schema, args.entry, args);
+		return;
+	}
+	const oldInstall = dshSettings["installSettingsSection"];
+	if (typeof oldInstall === "function") {
+		oldInstall(args.owner, args.ns, args.schema, args.entry, args);
+		return;
+	}
+	throw new Error("settings install: neither service.installSection (new era) nor module installSettingsSection (old era) is available");
+}
 //#endregion
-export { listingUrl as _, PUBLIC_BASE_URL as a, name as c, DEFAULT_MAX_TOKENS as d, DEFAULT_STREAM_IDLE_TIMEOUT_MS as f, discoverChatModels as g, inferInputModalities as h, PROVIDER as i, resolveAdapterOptions as l, SiliconFlowAdapter as m, DEFAULT_API_KEY_ENV as n, apply as o, DISCOVERY_TTL_MS as p, DEFAULT_MODELS as r, inject as s, Config as t, DEFAULT_CONTEXT_WINDOW as u, readListing as v };
+export { discoverChatModels as _, PUBLIC_BASE_URL as a, inject as c, DEFAULT_CONTEXT_WINDOW as d, DEFAULT_MAX_TOKENS as f, inferInputModalities as g, SiliconFlowAdapter as h, PROVIDER as i, name as l, DISCOVERY_TTL_MS as m, DEFAULT_API_KEY_ENV as n, apply as o, DEFAULT_STREAM_IDLE_TIMEOUT_MS as p, DEFAULT_MODELS as r, assembleSettingsSection as s, Config as t, resolveAdapterOptions as u, listingUrl as v, readListing as y };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@siliconflow-official/dsh-llm-siliconflow",
   "description": "SiliconFlow (OpenAI-compatible) chat-completions adapter plugin for the DeepSeek Harness LLM seam",
-  "version": "0.2.0-rc.1",
+  "version": "0.2.0-rc.3",
   "publishConfig": {
     "access": "public"
   },
@@ -44,14 +44,14 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-anonymous-user-id": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-attachment": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-credentials": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-invariants": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-launch-environment": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-settings": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-timeout": ">=0.0.1-rc.0"
+    "@deepseek-ai/dsh-anonymous-user-id": "*",
+    "@deepseek-ai/dsh-attachment": "*",
+    "@deepseek-ai/dsh-credentials": "*",
+    "@deepseek-ai/dsh-invariants": "*",
+    "@deepseek-ai/dsh-launch-environment": "*",
+    "@deepseek-ai/dsh-llm": "*",
+    "@deepseek-ai/dsh-settings": "*",
+    "@deepseek-ai/dsh-timeout": "*"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
@@ -59,18 +59,46 @@
     "yaml": "^2.9.0"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-anonymous-user-id": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-attachment": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-credentials": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-invariants": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-launch-environment": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-llm": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-settings": ">=0.0.1-rc.0",
-    "@deepseek-ai/dsh-timeout": ">=0.0.1-rc.0",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-anonymous-user-id": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-invariants": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-launch-environment": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.1.5-rc.2",
     "@types/node": "^22.0.0",
     "tsdown": "^0.22.0",
-    "typescript": "^6.0.0",
-    "unrun": "^0.3.1"
+    "typescript": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/cordis": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-anonymous-user-id": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-attachment": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-credentials": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-invariants": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-launch-environment": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-llm": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-timeout": {
+      "optional": true
+    }
   }
 }