@addozhang/dsh-discord 0.5.0-rc.3 → 0.5.0

package/README.md

@@ -29,13 +29,26 @@ No extra process: the adapter is a DSH plugin that mounts straight onto your `ds
 
 ## Requirements
 
-- The [dsh CLI](https://www.npmjs.com/package/@deepseek-ai/dsh) `0.1.6-alpha.1` or a compatible newer release, running a web profile. Adapter `0.5.x` uses the 0.1.6 controller services and is not compatible with the former `apiProxy` host surface.
+- The [dsh CLI](https://www.npmjs.com/package/@deepseek-ai/dsh), running a web profile. Match the dsh and adapter channels — see [Versions](#versions).
 - Node.js `^22.19.0 || >=24`
 - A Discord application with a bot user and the **MESSAGE CONTENT** privileged intent enabled (Developer Portal → your application → Bot → Privileged Gateway Intents)
 
+## Versions
+
+Two channels ship in parallel, each pinned to the dsh host surface it was verified against. Pick the adapter and the dsh CLI from the same row:
+
+| Channel | Adapter | dsh CLI | Install |
+|---|---|---|---|
+| **stable** | `0.5.0` — npm `latest` | `0.1.7-rc.1` — npm `next` | `dsh plugin --profile web add @addozhang/dsh-discord` |
+| **next** | `>=0.5.0-rc.4` — npm `next` | `0.1.7-alpha` — npm `alpha` | `dsh plugin --profile web add @addozhang/dsh-discord@next` |
+
+- **The rows do not mix.** Adapter `>=0.5.0-rc.4` (including `0.5.0`) speaks the 0.1.7 profile-backed settings forms and controller services and will not load on older hosts (the startup probe refuses with one actionable diagnostic); `0.5.0-rc.1`–`rc.3` target dsh `0.1.6-alpha`; adapter `0.4.x` talks to the former `apiProxy` surface, which `0.1.6-alpha` removed — it remains the pairing for the dsh `0.1.5` stable line, reachable by exact version (e.g. `@addozhang/dsh-discord@0.4.0`). A mismatched pair fails at startup.
+- To switch the dsh CLI line: `npm install -g @deepseek-ai/dsh@next` (0.1.7-rc.1, pairs with adapter 0.5.0) or `npm install -g @deepseek-ai/dsh@alpha` (0.1.7-alpha line).
+- Right after a `next` release, the `@next` spec can resolve to a stale cached version. If the installed copy looks old, install by exact version instead (e.g. `@addozhang/dsh-discord@0.5.0-rc.4`) and verify the `version` field inside the profile's `node_modules`.
+
 ## Install
 
-Install with the dsh CLI — it installs the package into the profile and registers the bundle for you:
+Install with the dsh CLI — it installs the package into the profile and registers the bundle for you. The stable channel is shown below; for the next channel use the `@next` command from the [Versions](#versions) table (`up` / `rm` take the same spec):
 
 ```sh
 dsh plugin --profile web add @addozhang/dsh-discord

package/README.zh.md

@@ -29,13 +29,26 @@
 
 ## 环境要求
 
-- [dsh CLI](https://www.npmjs.com/package/@deepseek-ai/dsh) `0.1.6-alpha.1` 或兼容的更新版本（web profile）。适配器 `0.5.x` 使用 0.1.6 的控制器服务，与旧版 `apiProxy` 宿主面不兼容。
+- [dsh CLI](https://www.npmjs.com/package/@deepseek-ai/dsh)（web profile）。dsh 与适配器的通道需匹配——见[版本支持](#版本支持)。
 - Node.js `^22.19.0 || >=24`
 - 一个 Discord 应用（含 Bot 用户），并在开发者门户启用 **MESSAGE CONTENT** 特权 intent（Developer Portal → 你的应用 → Bot → Privileged Gateway Intents）
 
+## 版本支持
+
+两条通道并行发布，各自钉在经过真机验证的 dsh 宿主面上。适配器与 dsh CLI 请取同一行：
+
+| 通道 | 适配器 | dsh CLI | 安装命令 |
+|---|---|---|---|
+| **stable** | `0.5.0` — npm `latest` | `0.1.7-rc.1` — npm `next` | `dsh plugin --profile web add @addozhang/dsh-discord` |
+| **next** | `>=0.5.0-rc.4` — npm `next` | `0.1.7-alpha` — npm `alpha` | `dsh plugin --profile web add @addozhang/dsh-discord@next` |
+
+- **两行不可混搭。** 适配器 `>=0.5.0-rc.4`（含 `0.5.0`）使用 0.1.7 的 profile-backed settings forms 与控制器服务，在更旧的宿主上无法加载（startup 探针会给出一条可操作的诊断后拒绝激活）；`0.5.0-rc.1`–`rc.3` 对应 dsh `0.1.6-alpha`；适配器 `0.4.x` 使用旧版 `apiProxy` 宿主面（该面已在 `0.1.6-alpha` 中移除）——它仍是 dsh `0.1.5` stable 线的配对，可用精确版本号安装（如 `@addozhang/dsh-discord@0.4.0`）。错配会在启动时失败。
+- 切换 dsh CLI 通道：`npm install -g @deepseek-ai/dsh@next`（0.1.7-rc.1，配适配器 0.5.0）或 `npm install -g @deepseek-ai/dsh@alpha`（0.1.7-alpha 线）。
+- `next` 刚发版后，`@next` 规格可能解析到过期的缓存版本。若装到的版本偏旧，请改用精确版本号安装（如 `@addozhang/dsh-discord@0.5.0-rc.4`），并核对 profile `node_modules` 中的 `version` 字段。
+
 ## 安装
 
-使用 dsh CLI 安装——它会自动把包装进 profile 并注册 bundle：
+使用 dsh CLI 安装——它会自动把包装进 profile 并注册 bundle。下面是 stable 通道；next 通道使用[版本支持](#版本支持)表中的 `@next` 命令（`up` / `rm` 同规格）：
 
 ```sh
 dsh plugin --profile web add @addozhang/dsh-discord

package/lib/client/card-controller.d.ts

@@ -4,14 +4,14 @@
  * hands to the component: the edit actions plus the `discordCard` snapshot
  * store the framework binds as the `useDiscordCard` selector hook.
  */
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { AdapterStatusView } from '../features/adapter-status.js';
 import type { DiscordSettings } from '../settings.js';
 import { type CardManagement, type DiscordCardFace, type DiscordCardState } from './card-form.js';
 export declare class DiscordCardController {
     private readonly form;
     private management;
-    constructor(scope: SettingsScope<DiscordSettings>);
+    constructor(form: ConfigForm<DiscordSettings>);
     /** Attach the token write/connect path once the RPC face is known. */
     setManagement(management: CardManagement): void;
     /** Publish the Host's sanitized connection status onto the card. */

package/lib/client/card-form.d.ts

@@ -7,7 +7,7 @@
  * is not a list of Discord IDs, which blocks the save rather than dropping it.
  */
 import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { AdapterStatusView } from '../features/adapter-status.js';
 import type { DiscordSettings } from '../settings.js';
 import { type AdapterStatusPresentation } from './settings-model.js';
@@ -88,7 +88,7 @@ export declare class DiscordCardForm {
     private saving;
     private failed;
     private status;
-    constructor(scope: SettingsScope<DiscordSettings>);
+    constructor(scope: ConfigForm<DiscordSettings>);
     /**
      * Publish the Host's sanitized status view. Edits, saves, and failures
      * never touch it — connection state is the Host's report, not form state.

package/lib/client.js

@@ -1022,8 +1022,8 @@ var DiscordCardForm = class {
 var DiscordCardController = class {
   form;
   management;
-  constructor(scope) {
-    this.form = new DiscordCardForm(scope);
+  constructor(form) {
+    this.form = new DiscordCardForm(form);
   }
   /** Attach the token write/connect path once the RPC face is known. */
   setManagement(management) {
@@ -1469,7 +1469,7 @@ function DiscordSettingsCard(props) {
 
 // src/client/index.ts
 var name = "dsh-discord-client";
-var inject = ["settingsScope", "slots", "connection", "locale"];
+var inject = ["configForms", "slots", "connection", "locale"];
 var STATUS_POLL_MS = 3e4;
 function isStatusView(value) {
   if (typeof value !== "object" || value === null) return false;
@@ -1477,8 +1477,8 @@ function isStatusView(value) {
   return typeof candidate["token"] === "string" && typeof candidate["connection"] === "string";
 }
 function apply(ctx) {
-  const scope = ctx.settingsScope.bind({ namespace: DISCORD_SETTINGS_NAMESPACE });
-  const controller = new DiscordCardController(scope);
+  const form = ctx.configForms.get(DISCORD_SETTINGS_NAMESPACE);
+  const controller = new DiscordCardController(form);
   ctx.locale.register("dsh-discord", {
     en: DISCORD_CARD_LOCALE_EN,
     zh: DISCORD_CARD_LOCALE_ZH

package/lib/index.d.ts

@@ -1,12 +1,56 @@
 import type { Context } from '@deepseek-ai/cordis';
-import type z from '@deepseek-ai/schemastery';
 import { type DiscordSettings } from './settings.js';
 /** Stable Cordis plugin name for diagnostics. */
 export declare const name = "dsh-discord";
 /** Host services required by the complete embedded adapter. */
 export declare const inject: string[];
 export type Config = DiscordSettings;
-export declare const Config: z<Config>;
+/**
+ * The plugin's static Config (0.1.7 profile-backed forms): every field is
+ * volatile, so the Host delivers each as a stable live reference instead of
+ * remounting the fiber on writes. The annotation is deliberately absent —
+ * schemastery's volatile mode types field defaults as `Volatile<T>`, which a
+ * `z<DiscordSettings>` annotation cannot express.
+ */
+export declare const Config: import("@deepseek-ai/schemastery").default<Schemastery.ObjectS<NoInfer<{
+    enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+    allowedGuildIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberRoleIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorRoleIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedRoleIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    hostOperatorUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    defaultVerbosity: import("@deepseek-ai/schemastery").default<"text-only" | "essential-tools" | "full-tools", "text-only" | "essential-tools" | "full-tools", "volatile-defined">;
+    language: import("@deepseek-ai/schemastery").default<"auto" | "zh" | "en", "auto" | "zh" | "en", "volatile-defined">;
+    threadAutoArchiveMinutes: import("@deepseek-ai/schemastery").default<60 | 1440 | 4320 | 10080, 60 | 1440 | 4320 | 10080, "volatile-defined">;
+    streamUpdateIntervalMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    typingIntervalMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    approvalTimeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    questionTimeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    modelSelectOperatorOnly: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+    permissionSelectOperatorOnly: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    enabled: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+    allowedGuildIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberRoleIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorRoleIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedRoleIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    hostOperatorUserIds: import("@deepseek-ai/schemastery").default<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    defaultVerbosity: import("@deepseek-ai/schemastery").default<"text-only" | "essential-tools" | "full-tools", "text-only" | "essential-tools" | "full-tools", "volatile-defined">;
+    language: import("@deepseek-ai/schemastery").default<"auto" | "zh" | "en", "auto" | "zh" | "en", "volatile-defined">;
+    threadAutoArchiveMinutes: import("@deepseek-ai/schemastery").default<60 | 1440 | 4320 | 10080, 60 | 1440 | 4320 | 10080, "volatile-defined">;
+    streamUpdateIntervalMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    typingIntervalMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    approvalTimeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    questionTimeoutMs: import("@deepseek-ai/schemastery").default<number, number, "volatile-defined">;
+    modelSelectOperatorOnly: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+    permissionSelectOperatorOnly: import("@deepseek-ai/schemastery").default<boolean, boolean, "volatile-defined">;
+}>>, "plain">;
 /**
  * Mount the embedded Discord adapter. Composition of the runtime path
  * (Gateway → ingress → command/mention dispatch → Discord REST, plus the

package/lib/index.js

@@ -1,4 +1,4 @@
-import { DEFAULT_DISCORD_SETTINGS, DiscordSettingsSchema, installDiscordSettings, normalizeDiscordSettings, } from './settings.js';
+import { DEFAULT_DISCORD_SETTINGS, DiscordSettingsSchema, bindDiscordSettings, } from './settings.js';
 import { installCancellationRoot } from './lifecycle.js';
 import { ALLOWED_MENTIONS_NONE, DISCORD_SUPPRESS_NOTIFICATIONS_FLAG, OUTBOUND_EPHEMERAL_FLAGS, safeTitle } from './policy/disclosure.js';
 import { validateHostCapabilities } from './startup.js';
@@ -39,6 +39,13 @@ import { planWorkspaceChannel, workspaceChannelName } from './features/workspace
 export const name = 'dsh-discord';
 /** Host services required by the complete embedded adapter. */
 export const inject = ['sessionController', 'workspaceController', 'sessionQuery', 'webServer', 'credentials', 'settings', 'storageDomain', 'connection'];
+/**
+ * The plugin's static Config (0.1.7 profile-backed forms): every field is
+ * volatile, so the Host delivers each as a stable live reference instead of
+ * remounting the fiber on writes. The annotation is deliberately absent —
+ * schemastery's volatile mode types field defaults as `Volatile<T>`, which a
+ * `z<DiscordSettings>` annotation cannot express.
+ */
 export const Config = DiscordSettingsSchema;
 /**
  * Fixed Milestone 1 Gateway intents: guilds, messages, content. Member data
@@ -66,18 +73,27 @@ function emitLog(ctx, level, message) {
 export function apply(ctx, config = DEFAULT_DISCORD_SETTINGS) {
     validateHostCapabilities(name => ctx.get(name));
     installCancellationRoot(ctx);
-    let current = normalizeDiscordSettings(config);
     /**
      * Discord-visible copy, re-resolved on every access so a language change
      * on the settings card applies without rebuilding the composition. The
-     * 'auto' preference follows the DSH locale (the `locale` namespace the
-     * Host app registers); non-Chinese locales fall back to English.
+     * 'auto' preference follows the DSH locale — read from the settings forms
+     * describe projection (the 0.1.7 replacement for the retired
+     * `.get(namespace)` service method); non-Chinese locales fall back to
+     * English.
      */
+    const readLocalePreference = (service) => {
+        const describe = service?.describe;
+        if (typeof describe !== 'function')
+            return undefined;
+        const row = describe.call(service, { redactSecrets: true }).find(entry => entry.ns === 'locale');
+        const preference = row?.value?.preference;
+        return typeof preference === 'string' ? preference : undefined;
+    };
     const resolveLanguage = () => {
         if (current.language !== 'auto')
             return current.language;
-        const locale = ctx.get('settings').get('locale');
-        return typeof locale?.preference === 'string' && locale.preference.startsWith('zh') ? 'zh' : 'en';
+        const preference = readLocalePreference(ctx.get('settings'));
+        return preference !== undefined && preference.startsWith('zh') ? 'zh' : 'en';
     };
     const copy = new Proxy({}, {
         get: (_target, key) => createCopy(resolveLanguage())[key],
@@ -85,7 +101,7 @@ export function apply(ctx, config = DEFAULT_DISCORD_SETTINGS) {
     // Reassigned once the async composition has built the real registrar.
     let registerCommands = async () => { };
     const onGuildsChanged = () => { void registerCommands(); };
-    installDiscordSettings(ctx, current, (next) => {
+    const settingsSource = bindDiscordSettings(ctx, config, (next) => {
         const guildsChanged = next.allowedGuildIds.join(',') !== current.allowedGuildIds.join(',');
         current = next;
         if (guildsChanged)
@@ -96,6 +112,7 @@ export function apply(ctx, config = DEFAULT_DISCORD_SETTINGS) {
             allowedGuildCount: current.allowedGuildIds.length,
         });
     });
+    let current = settingsSource.get();
     // The settings card's status surface: credential presence seeded now, the
     // Gateway observation fed by the adapter composition as it starts.
     // Services resolve through the same accessor the startup boundary probes.

package/lib/settings.d.ts

@@ -43,10 +43,48 @@ export interface DiscordSettings {
 export type ThreadAutoArchiveMinutes = 60 | 1440 | 4320 | 10080;
 export declare const THREAD_AUTO_ARCHIVE_OPTIONS: readonly ThreadAutoArchiveMinutes[];
 export declare const DEFAULT_DISCORD_SETTINGS: DiscordSettings;
-export declare const DiscordSettingsSchema: z<DiscordSettings>;
+export declare const DiscordSettingsSchema: z<Schemastery.ObjectS<NoInfer<{
+    enabled: z<boolean, boolean, "volatile-defined">;
+    allowedGuildIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberRoleIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorRoleIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedRoleIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    hostOperatorUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    defaultVerbosity: z<"text-only" | "essential-tools" | "full-tools", "text-only" | "essential-tools" | "full-tools", "volatile-defined">;
+    language: z<"auto" | "zh" | "en", "auto" | "zh" | "en", "volatile-defined">;
+    threadAutoArchiveMinutes: z<60 | 1440 | 4320 | 10080, 60 | 1440 | 4320 | 10080, "volatile-defined">;
+    streamUpdateIntervalMs: z<number, number, "volatile-defined">;
+    typingIntervalMs: z<number, number, "volatile-defined">;
+    approvalTimeoutMs: z<number, number, "volatile-defined">;
+    questionTimeoutMs: z<number, number, "volatile-defined">;
+    modelSelectOperatorOnly: z<boolean, boolean, "volatile-defined">;
+    permissionSelectOperatorOnly: z<boolean, boolean, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    enabled: z<boolean, boolean, "volatile-defined">;
+    allowedGuildIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    memberRoleIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    administratorRoleIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    deniedRoleIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    hostOperatorUserIds: z<NoInfer<string[]>, NoInfer<string[]>, "volatile-defined">;
+    defaultVerbosity: z<"text-only" | "essential-tools" | "full-tools", "text-only" | "essential-tools" | "full-tools", "volatile-defined">;
+    language: z<"auto" | "zh" | "en", "auto" | "zh" | "en", "volatile-defined">;
+    threadAutoArchiveMinutes: z<60 | 1440 | 4320 | 10080, 60 | 1440 | 4320 | 10080, "volatile-defined">;
+    streamUpdateIntervalMs: z<number, number, "volatile-defined">;
+    typingIntervalMs: z<number, number, "volatile-defined">;
+    approvalTimeoutMs: z<number, number, "volatile-defined">;
+    questionTimeoutMs: z<number, number, "volatile-defined">;
+    modelSelectOperatorOnly: z<boolean, boolean, "volatile-defined">;
+    permissionSelectOperatorOnly: z<boolean, boolean, "volatile-defined">;
+}>>, "plain">;
 export declare function normalizeDiscordSettings(input: DiscordSettings): DiscordSettings;
 export declare function validateDiscordSettings(input: DiscordSettings): void;
 export interface DiscordSettingsSource {
     get(): DiscordSettings;
 }
-export declare function installDiscordSettings(ctx: Context, entry: DiscordSettings, onChange: (value: DiscordSettings) => void): void;
+export declare function bindDiscordSettings(ctx: Context, config: Readonly<Record<string, unknown>>, onChange: (value: DiscordSettings) => void): DiscordSettingsSource;

package/lib/settings.js

@@ -22,9 +22,17 @@ export const DEFAULT_DISCORD_SETTINGS = Object.freeze({
     modelSelectOperatorOnly: false,
     permissionSelectOperatorOnly: true,
 });
-const discordIdList = z.array(z.string()).default([]);
+/**
+ * Every field is volatile (0.1.7 profile-backed forms): values live-update
+ * through stable per-field references without remounting the plugin fiber —
+ * the exact semantics the 0.1.6 `installSection` registration provided.
+ * Snowflake patterns ride the schema so the Host rejects malformed IDs at
+ * write time (parity with the retired validate hook).
+ */
+const DISCORD_SNOWFLAKE = /^\d{17,20}$/u;
+const discordIdList = z.array(z.string().pattern(DISCORD_SNOWFLAKE)).default([]).volatile();
 export const DiscordSettingsSchema = z.object({
-    enabled: z.boolean().default(false),
+    enabled: z.boolean().default(false).volatile(),
     allowedGuildIds: discordIdList,
     memberUserIds: discordIdList,
     memberRoleIds: discordIdList,
@@ -34,18 +42,17 @@ export const DiscordSettingsSchema = z.object({
     deniedRoleIds: discordIdList,
     hostOperatorUserIds: discordIdList,
     defaultVerbosity: z.union(['text-only', 'essential-tools', 'full-tools'])
-        .default('essential-tools'),
-    language: z.union(['auto', 'zh', 'en']).default('auto'),
+        .default('essential-tools').volatile(),
+    language: z.union(['auto', 'zh', 'en']).default('auto').volatile(),
     threadAutoArchiveMinutes: z.union([60, 1440, 4320, 10080])
-        .default(1440),
-    streamUpdateIntervalMs: z.number().step(1).min(250).max(10_000).default(800),
-    typingIntervalMs: z.number().step(1).min(1_000).max(30_000).default(7_000),
-    approvalTimeoutMs: z.number().step(1).min(30_000).max(86_400_000).default(600_000),
-    questionTimeoutMs: z.number().step(1).min(30_000).max(86_400_000).default(1_800_000),
-    modelSelectOperatorOnly: z.boolean().default(false),
-    permissionSelectOperatorOnly: z.boolean().default(true),
+        .default(1440).volatile(),
+    streamUpdateIntervalMs: z.number().step(1).min(250).max(10_000).default(800).volatile(),
+    typingIntervalMs: z.number().step(1).min(1_000).max(30_000).default(7_000).volatile(),
+    approvalTimeoutMs: z.number().step(1).min(30_000).max(86_400_000).default(600_000).volatile(),
+    questionTimeoutMs: z.number().step(1).min(30_000).max(86_400_000).default(1_800_000).volatile(),
+    modelSelectOperatorOnly: z.boolean().default(false).volatile(),
+    permissionSelectOperatorOnly: z.boolean().default(true).volatile(),
 });
-const DISCORD_SNOWFLAKE = /^\d{17,20}$/u;
 const ID_FIELDS = [
     'allowedGuildIds',
     'memberUserIds',
@@ -91,19 +98,22 @@ export function validateDiscordSettings(input) {
         throw new TypeError('threadAutoArchiveMinutes must be one of 60, 1440, 4320, 10080');
     }
 }
-export function installDiscordSettings(ctx, entry, onChange) {
-    let source = () => entry;
-    const provider = ctx.get('settings');
-    if (provider === undefined || typeof provider.installSection !== 'function') {
-        throw new TypeError('settings provider with installSection is unavailable on this Host');
-    }
-    provider.installSection(ctx, DISCORD_SETTINGS_NAMESPACE, DiscordSettingsSchema, entry, {
-        validate: value => { validateDiscordSettings(normalizeDiscordSettings(value)); },
-        setSource: current => {
-            source = () => normalizeDiscordSettings(current());
-        },
-        onChange: () => {
-            onChange(source());
-        },
+function isVolatileField(value) {
+    return typeof value === 'object' && value !== null
+        && typeof value.get === 'function';
+}
+export function bindDiscordSettings(ctx, config, onChange) {
+    const read = () => {
+        const raw = {};
+        for (const key of Object.keys(DEFAULT_DISCORD_SETTINGS)) {
+            const field = config[key];
+            raw[key] = isVolatileField(field) ? field.get() : field;
+        }
+        return normalizeDiscordSettings(raw);
+    };
+    ctx.on('settings/document-updated', (ns) => {
+        if (ns === DISCORD_SETTINGS_NAMESPACE)
+            onChange(read());
     });
+    return { get: read };
 }

package/lib/startup.js

@@ -21,10 +21,13 @@ export const REQUIRED_HOST_SERVICES = [
     'permissionPresets',
 ];
 /**
- * Minimum contract members per service, confirmed against the 0.1.6
- * controller faces (dsh-api-session-controller / dsh-api-workspace-controller
- * / dsh-session-query). A service lacking any member means a version drift
- * the startup probe should have refused; refuse rather than probe at runtime.
+ * Minimum contract members per service, confirmed against the 0.1.7
+ * controller and settings faces (dsh-api-session-controller /
+ * dsh-api-workspace-controller / dsh-session-query / dsh-settings
+ * SettingsForms — describe reads the forms projection including the locale
+ * entry; update is the service-side landing of every card write). A service
+ * lacking any member means a version drift the startup probe should have
+ * refused; refuse rather than probe at runtime.
  */
 const REQUIRED_CONTRACT_MEMBERS = {
     sessionController: ['prompt', 'create', 'list', 'cancel', 'updateQueue', 'selectModel', 'modelCatalog', 'follow', 'control', 'resolveAgent'],
@@ -32,14 +35,14 @@ const REQUIRED_CONTRACT_MEMBERS = {
     sessionQuery: ['observeSession'],
     webServer: [],
     credentials: ['resolve', 'describe', 'set', 'unset'],
-    settings: ['installSection'],
+    settings: ['describe', 'update'],
     storageDomain: ['open'],
     connection: ['rpc'],
     commands: ['execute'],
     permissionPresets: ['catalog'],
 };
 /** Actionable remediation hint appended to every activation failure. */
-const REMEDIATION = 'install @addozhang/dsh-discord into a dsh web profile providing the 0.1.6 host controller services';
+const REMEDIATION = 'install @addozhang/dsh-discord into a dsh web profile providing the 0.1.7 host services (profile-backed settings forms)';
 function missingMembers(service, required) {
     if (service === undefined || service === null)
         return [...required];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@addozhang/dsh-discord",
-  "version": "0.5.0-rc.3",
+  "version": "0.5.0",
   "description": "Discord adapter for DeepSeek Harness · DeepSeek Harness 的 Discord 适配器",
   "license": "MIT",
   "type": "module",
@@ -53,14 +53,15 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis": "^4.0.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.2",
-    "@deepseek-ai/dsh-client-store": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.6-alpha.2",
+    "@deepseek-ai/cordis": "4.0.3",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.1",
     "@eslint/js": "9.39.1",
     "@types/node": "24.10.1",
     "@types/react": "18.3.1",
@@ -75,10 +76,9 @@
     "vitest": "4.1.11"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-credentials": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-settings": "0.1.6-alpha.2",
-    "@deepseek-ai/dsh-storage-domain": "0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "3.18.1",
+    "@deepseek-ai/dsh-credentials": "0.1.7-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "0.1.7-rc.1",
+    "@deepseek-ai/schemastery": "3.18.4",
     "zod": "^4.4.3"
   },
   "pnpm": {},