@khorsheed/dsh-local-agent 0.2.0-rc.1 → 0.2.0

package/lib/types/client/harness-cards.js

@@ -0,0 +1,57 @@
+/**
+ * The harness-card registry behind the「本机 Agent 委派」family card: each
+ * delegation companion's client registers one section (its settings card
+ * body) through the localAgentUi service's `registerHarnessCard`, and the
+ * core's single `plugins.item` entry renders every registered section sorted
+ * by order. Sections come from THIS registry, never the gateway roster — a
+ * registered harness absent host-side still renders, its body degrading
+ * exactly like the retired standalone card did.
+ *
+ * The registry lives on the cordis service (not a module export) because every
+ * plugin's client bundle inlines its own copy of the core's sources: module
+ * identity is per bundle, the service is the one shared instance.
+ * @module @khorsheed/dsh-local-agent/client — harness card registry
+ */
+/**
+ * In-memory registry with the useSyncExternalStore face the family card
+ * subscribes through: a version counter as the snapshot (mutations bump it)
+ * and a cached sorted list readers re-read after a bump.
+ */
+export class HarnessCardRegistry {
+    entries = new Map();
+    listeners = new Set();
+    version = 0;
+    sorted = [];
+    /**
+     * Register one harness's section; re-registering the same name replaces the
+     * entry. The returned disposer removes only the entry it registered (a stale
+     * disposer never evicts a newer registration of the same name).
+     * @param entry - the section registration.
+     * @returns the unregister.
+     */
+    register = (entry) => {
+        this.entries.set(entry.name, entry);
+        this.bump();
+        return () => {
+            if (this.entries.get(entry.name) !== entry)
+                return;
+            this.entries.delete(entry.name);
+            this.bump();
+        };
+    };
+    /** The registered sections in display order (order, then name). */
+    cards = () => this.sorted;
+    /** The mutation counter — the useSyncExternalStore snapshot. */
+    snapshotVersion = () => this.version;
+    /** Subscribe a listener fired after every mutation; returns the unsubscribe. */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    };
+    bump() {
+        this.version += 1;
+        this.sorted = [...this.entries.values()].sort((a, b) => a.order - b.order || (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+        for (const listener of [...this.listeners])
+            listener();
+    }
+}

package/lib/types/client/icons.d.ts

@@ -1,6 +1,6 @@
 /**
  * Generated by scripts/sync-icon-artwork.mts from @deepseek-ai/dsh-client-ui-primitives
- * (v0.1.7-rc.1, harness 46a7f68b09) — do not edit by hand. The 0.1.5 and rc.1 host lines
+ * (v0.2.1-rc.1, harness 1600d8a1e1) — do not edit by hand. The 0.1.5 and rc.1 host lines
  * share no icon export name, so the rc.1 artwork is inlined here: pure SVG,
  * no host runtime identity, identical on every line. Re-run the generator
  * after adding an icon import or bumping the harness checkout.
@@ -18,5 +18,6 @@ export declare const IconCheckOutlineMedium: ({ size, className }: IconProps) =>
 export declare const IconChevronDownOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
 export declare const IconChevronUpOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
 export declare const IconQueueOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+export declare const IconThinkOutlineRegular: ({ size, className }: IconProps) => import("react").JSX.Element;
 export declare const IconTrashOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
 //# sourceMappingURL=icons.d.ts.map

package/lib/types/client/icons.js

@@ -3,4 +3,5 @@ export const IconCheckOutlineMedium = ({ size = 16, className }) => (_jsx("svg",
 export const IconChevronDownOutlineMedium = ({ size = 14, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6", stroke: "currentColor" }) }));
 export const IconChevronUpOutlineMedium = ({ size = 14, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M12 10L8.70711 6.70711C8.31658 6.31658 7.68342 6.31658 7.29289 6.70711L4 10", stroke: "currentColor" }) }));
 export const IconQueueOutlineMedium = ({ size = 14, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M5 6.75H11", stroke: "currentColor" }), _jsx("path", { d: "M5 9H8", stroke: "currentColor" }), _jsx("path", { d: "M2.37067 11.2497C1.5872 9.89252 1.32042 8.29798 1.61945 6.7597C1.91847 5.22141 2.76317 3.84293 3.99801 2.87809C5.23285 1.91325 6.7747 1.427 8.33964 1.50888C9.90458 1.59076 11.3873 2.23526 12.5147 3.32369C13.6422 4.41232 14.3384 5.8717 14.4751 7.43304C14.6118 8.99438 14.1797 10.5525 13.2585 11.8205C12.3372 13.0885 10.9889 13.9809 9.4617 14.3334C8.18666 14.6277 6.8587 14.529 5.64964 14.0601C5.17095 13.8745 4.76937 13.4929 4.26509 13.3963C3.67389 13.2832 2.95232 13.5595 2.0377 14.3334", stroke: "currentColor" })] }));
+export const IconThinkOutlineRegular = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1, children: [_jsx("path", { d: "M10.2854 5.71481C12.9673 8.39663 14.1182 11.5938 12.8562 12.8559C11.5942 14.1179 8.39706 12.9669 5.71518 10.2851C3.03333 7.60323 1.88236 4.40608 3.14441 3.14403C4.40644 1.882 7.6036 3.03297 10.2854 5.71481Z", stroke: "currentColor" }), _jsx("path", { d: "M10.2854 10.2851C7.6036 12.9669 4.40644 14.1179 3.14441 12.8559C1.88236 11.5938 3.03333 8.39663 5.71518 5.71481C8.39706 3.03297 11.5942 1.882 12.8562 3.14403C14.1182 4.40608 12.9673 7.60323 10.2854 10.2851Z", stroke: "currentColor" }), _jsx("path", { d: "M8.86291 8.0002C8.86291 8.47549 8.47762 8.86087 8.00224 8.86087C7.52694 8.86087 7.1416 8.47549 7.1416 8.0002C7.1416 7.52485 7.52694 7.13953 8.00224 7.13953C8.47762 7.13953 8.86291 7.52485 8.86291 8.0002Z", fill: "currentColor" })] }));
 export const IconTrashOutlineMedium = ({ size = 16, className }) => (_jsxs("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: [_jsx("path", { d: "M1.28149 3.88831H14.7187", stroke: "currentColor" }), _jsx("path", { d: "M5.41602 3.88833V2.47962C5.41602 2.29282 5.52492 2.11366 5.71876 1.98157C5.9126 1.84948 6.17551 1.77527 6.44964 1.77527H9.55053C9.82466 1.77527 10.0876 1.84948 10.2814 1.98157C10.4753 2.11366 10.5842 2.29282 10.5842 2.47962V3.88833", stroke: "currentColor" }), _jsx("path", { d: "M2.57349 3.88831L3.19366 13.2943C3.21937 13.5502 3.33952 13.7872 3.53065 13.9593C3.72178 14.1313 3.97016 14.2259 4.22729 14.2246H11.7728C12.0299 14.2259 12.2783 14.1313 12.4694 13.9593C12.6605 13.7872 12.7807 13.5502 12.8064 13.2943L13.4266 3.88831", stroke: "currentColor" }), _jsx("path", { d: "M6.44946 6.98926V11.1238", stroke: "currentColor" }), _jsx("path", { d: "M9.55054 6.98926V11.1238", stroke: "currentColor" })] }));

package/lib/types/client/index.d.ts

@@ -1,12 +1,18 @@
 /**
  * Local-agent records plugin, browser half: the member composer for delegated
- * CLI sessions, plus the shared settings-card building blocks the provider
- * packages compose (ProviderAuthBlock, the auth-status bus, AuthStatusDot).
- * The per-harness auth/live settings live in each provider's own settings
- * card — on alpha.2 the bundle's configuration on its Plugins-page detail
- * view (`plugins.bundle.config`), on 0.1.5 the `settings.plugin.item` card
- * (Plugins → 可配置插件); the standalone「本地 Agent」section was retired
- * once the cards carried auth (the live-settings proposal's M3). Roster and status ride the read-only local-agent Remote
+ * CLI sessions, the shared settings-card building blocks the provider
+ * packages compose (ProviderAuthBlock, the auth-status bus, AuthStatusDot),
+ * and the「本机 Agent 委派」family card — ONE `plugins.item` entry on the
+ * Plugins page that renders each harness's settings section, registered by
+ * the provider packages through the localAgentUi service's
+ * `registerHarnessCard` (a provider on a core predating the family card
+ * keeps its own standalone card; this core alone shows the card with an
+ * empty state). The card registers with the core client bundle itself —
+ * no served-namespace gate: the whileServed convention only lists
+ * namespaces whose Config has a volatile field, and this core's Config
+ * has none, so its namespace never serves (the companions' sections keep
+ * their own namespace gates).
+ * Roster and status ride the read-only local-agent Remote
  * channel (no session events); only the user-initiated login/logout/preset
  * commands go through the commands Remote, whose visible command node is the
  * expected feedback. Delegation records live with the shared subagent
@@ -16,16 +22,23 @@
  */
 import { type ReactNode } from 'react';
 import { type HarnessModelPickerProps } from './HarnessModelPicker.tsx';
+import { type HarnessCardRegistration } from './harness-cards.ts';
 import type { Context } from '@deepseek-ai/cordis';
 import type { TypertRemoteNamespaceMap } from '@deepseek-ai/dsh-typert-protocol';
 import { type LocalAgentKey } from './locales.ts';
 export type { LocalAgentHarnessView } from './LocalAgentRecordsAction.tsx';
 export { ProviderAuthBlock } from './ProviderAuthBlock.tsx';
 export type { ProviderAuthBlockProps, ProviderAuthInjected } from './ProviderAuthBlock.tsx';
+export { ModelListSection } from './ModelListSection.tsx';
+export type { ModelListSectionListFace, ModelListSectionProps } from './ModelListSection.tsx';
 export { AuthStatusDot } from './AuthStatusDot.tsx';
 export type { AuthStatusDotProps } from './AuthStatusDot.tsx';
 export { publishAuthStatus, useHarnessAuthStatus, resetAuthStatuses, readAuthStatus } from './auth-status.ts';
 export type { HarnessAuthStatusKind } from './auth-status.ts';
+export { HarnessCardRegistry } from './harness-cards.ts';
+export type { HarnessCardRegistration, HarnessCardRenderProps } from './harness-cards.ts';
+export { LocalAgentFamilyCard } from './FamilyCard.tsx';
+export type { FamilyCardInjected, LocalAgentFamilyCardProps } from './FamilyCard.tsx';
 export type { MemberComposerInjected, MemberComposerMatch, MemberComposerProps } from './MemberComposer.tsx';
 export { selectCliMember } from './MemberComposer.tsx';
 /** The mounted local-agent gateway namespace, read back from the global store. */
@@ -37,6 +50,18 @@ export interface LocalAgentUi {
     renderMemberInbox(childSessionId: string): ReactNode;
     renderHarnessModelPicker(name: string, props: HarnessModelPickerInput): ReactNode;
     renderMemberConfiguration(childSessionId: string): ReactNode;
+    /**
+     * Register one harness's section in the family card; returns the
+     * unregister. Optional on the TYPE because a companion may run against a
+     * core that predates the family card: companions probe
+     * `typeof ui.registerHarnessCard === 'function'` and keep their standalone
+     * plugins.item card when it is absent. This core always provides it.
+     */
+    registerHarnessCard?(entry: HarnessCardRegistration): () => void;
+    /** The registered harness sections in display order (the family card's reading). */
+    harnessCards?(): readonly HarnessCardRegistration[];
+    /** The registry's useSyncExternalStore subscribe. */
+    subscribeHarnessCards?(listener: () => void): () => void;
 }
 declare module '@deepseek-ai/cordis' {
     interface Context {

package/lib/types/client/index.js

@@ -1,13 +1,19 @@
 import { MemberFeeds } from './member-feed.js';
 /**
  * Local-agent records plugin, browser half: the member composer for delegated
- * CLI sessions, plus the shared settings-card building blocks the provider
- * packages compose (ProviderAuthBlock, the auth-status bus, AuthStatusDot).
- * The per-harness auth/live settings live in each provider's own settings
- * card — on alpha.2 the bundle's configuration on its Plugins-page detail
- * view (`plugins.bundle.config`), on 0.1.5 the `settings.plugin.item` card
- * (Plugins → 可配置插件); the standalone「本地 Agent」section was retired
- * once the cards carried auth (the live-settings proposal's M3). Roster and status ride the read-only local-agent Remote
+ * CLI sessions, the shared settings-card building blocks the provider
+ * packages compose (ProviderAuthBlock, the auth-status bus, AuthStatusDot),
+ * and the「本机 Agent 委派」family card — ONE `plugins.item` entry on the
+ * Plugins page that renders each harness's settings section, registered by
+ * the provider packages through the localAgentUi service's
+ * `registerHarnessCard` (a provider on a core predating the family card
+ * keeps its own standalone card; this core alone shows the card with an
+ * empty state). The card registers with the core client bundle itself —
+ * no served-namespace gate: the whileServed convention only lists
+ * namespaces whose Config has a volatile field, and this core's Config
+ * has none, so its namespace never serves (the companions' sections keep
+ * their own namespace gates).
+ * Roster and status ride the read-only local-agent Remote
  * channel (no session events); only the user-initiated login/logout/preset
  * commands go through the commands Remote, whose visible command node is the
  * expected feedback. Delegation records live with the shared subagent
@@ -17,6 +23,9 @@ import { MemberFeeds } from './member-feed.js';
  */
 import { createElement } from 'react';
 import { HarnessModelPicker } from './HarnessModelPicker.js';
+import { scopeDirectoryToList } from './model-directory-scope.js';
+import { LocalAgentFamilyCard } from './FamilyCard.js';
+import { HarnessCardRegistry } from './harness-cards.js';
 import { MemberConfiguration } from './MemberConfiguration.js';
 import { MemberConfigurationStores } from './member-configuration.js';
 import localAgentRemote from '@khorsheed/dsh-local-agent/remote';
@@ -26,8 +35,11 @@ import { memberLiveDefinition } from './live-node.js';
 import { MemberLiveNode, MemberLiveOutputView } from './MemberLiveNode.js';
 import { MemberLiveOutputs } from './live-output.js';
 export { ProviderAuthBlock } from './ProviderAuthBlock.js';
+export { ModelListSection } from './ModelListSection.js';
 export { AuthStatusDot } from './AuthStatusDot.js';
 export { publishAuthStatus, useHarnessAuthStatus, resetAuthStatuses, readAuthStatus } from './auth-status.js';
+export { HarnessCardRegistry } from './harness-cards.js';
+export { LocalAgentFamilyCard } from './FamilyCard.js';
 export { selectCliMember } from './MemberComposer.js';
 import { MemberInboxView } from './MemberInboxView.js';
 export { ModelConfigurationFields } from './ModelConfigurationFields.js';
@@ -76,8 +88,21 @@ export async function apply(ctx) {
         let face = directoryFaces.get(name);
         if (face === undefined)
             directoryFaces.set(name, face = {
-                read: async (refresh) => unwrap(await gateway.modelDirectory(name, undefined, refresh)),
-                follow: signal => gateway.followModelDirectory(name, undefined, signal),
+                read: async (refresh) => {
+                    const directory = unwrap(await gateway.modelDirectory(name, undefined, refresh));
+                    return directory === null ? null : scopeDirectoryToList(directory, unwrap(await gateway.modelList(name)));
+                },
+                follow: async function* (signal) {
+                    // The invite picker faces the curated list, not the raw served
+                    // catalog; re-read the list on each directory revision.
+                    let list = unwrap(await gateway.modelList(name));
+                    for await (const directory of gateway.followModelDirectory(name, undefined, signal)) {
+                        if (signal.aborted)
+                            return;
+                        list = unwrap(await gateway.modelList(name));
+                        yield scopeDirectoryToList(directory, list);
+                    }
+                },
             });
         return face;
     };
@@ -92,11 +117,20 @@ export async function apply(ctx) {
         return face;
     };
     const outputs = new MemberLiveOutputs((id, signal) => feeds.follow(id, 'output', signal));
+    // The family card's section registry: companions register through the
+    // service below, the plugins.item entry reads it reactively. Service-held,
+    // never module-held — each client bundle inlines its own copy of these
+    // sources, so only the cordis service is the shared instance.
+    const harnessCards = new HarnessCardRegistry();
+    const t = ctx.locale.bind(NS);
     const configurationUi = {
         renderMemberOutput: (id, startedAt) => createElement(MemberLiveOutputView, { key: `${id}:${startedAt}`, sessionId: id, startedAt, outputs, t: ctx.locale.bind(NS) }),
         renderMemberInbox: id => createElement(MemberInboxView, { key: id, face: inboxFace(id), t: ctx.locale.bind(NS) }),
         renderHarnessModelPicker: (name, props) => createElement(HarnessModelPicker, { ...props, key: name, face: directoryFace(name), t: ctx.locale.bind(NS) }),
         renderMemberConfiguration: id => createElement(MemberConfiguration, { key: id, store: configurations.get(id), diagnostics: outputs.diagnostics, t: ctx.locale.bind(NS) }),
+        registerHarnessCard: entry => harnessCards.register(entry),
+        harnessCards: () => harnessCards.cards(),
+        subscribeHarnessCards: listener => harnessCards.subscribe(listener),
     };
     ctx.provide('localAgentUi', configurationUi);
     ctx.inject(['uiConversation'], lctx => { lctx.uiConversation.events.register(memberLiveDefinition); });
@@ -128,6 +162,29 @@ export async function apply(ctx) {
             setMemberModel: (childSessionId, model) => gateway.setMemberModel(childSessionId, model).then(result => (result.ok ? result.value : undefined)),
         }),
     }, MemberComposer));
+    // The family card: ONE Plugins-page entry rendering every registered
+    // harness section. Registered UNCONDITIONALLY, not gated on the core row's
+    // served namespace like the companions' retired standalone cards: the
+    // whileServed list only carries namespaces whose Config schema has a
+    // volatile field, and this core's Config has none — gating on it meant the
+    // card never mounted (and the new-core companions had already given up
+    // their standalone seats, so no local-agent card rendered at all). The
+    // client bundle loads only with the core row in the composition, so the
+    // bundle's presence is the gate; a core whose server half failed simply
+    // renders the sections' degraded states.
+    ctx.slots.inject('plugins.item', () => ctx.slots.register({
+        name: 'plugins.item',
+        id: 'local-agent',
+        // Ahead of the harnesses' retired standalone cards (orders 110-140).
+        order: 100,
+        label: () => t('family.title'),
+        locale: NS,
+        inject: () => ({
+            harnessCards,
+            harnessStatus: name => gateway?.status(name, undefined).then(result => (result.ok ? result.value : undefined))
+                ?? Promise.resolve(undefined),
+        }),
+    }, LocalAgentFamilyCard));
     return async () => {
         for (const dispose of disposers.reverse())
             await dispose();

package/lib/types/client/locales.d.ts

@@ -24,6 +24,7 @@ export declare const zh: {
     readonly "configuration.details": "模型目录详情";
     readonly "configuration.model": "模型";
     readonly "configuration.effort": "推理强度";
+    readonly "configuration.effortDefault": "默认";
     readonly "configuration.inherit": "继承成员创建配置";
     readonly "configuration.default": "跟随 harness 默认值";
     readonly "configuration.search": "搜索模型名称或 ID";
@@ -55,7 +56,6 @@ export declare const zh: {
     readonly "configuration.cancelled": "已接收撤销请求，正在恢复配置。";
     readonly "configuration.failed": "配置操作失败，请检查原因后重试。";
     readonly 'stream.thinking': '思考中';
-    readonly 'stream.writing': '正在生成';
     readonly 'stream.recovering': '部分记录，等待实时连接';
     readonly 'stream.copy': '复制';
     readonly 'stream.copied': '已复制';
@@ -87,6 +87,30 @@ export declare const zh: {
     readonly 'settings.unsupported': '待支持';
     readonly 'settings.rosterFailed': '无法读取本地 Agent 列表，请重试';
     readonly 'settings.retry': '重试';
+    readonly 'family.title': '本机 Agent 委派';
+    readonly 'family.description': '本机安装的编码 agent CLI 的委派通道：端点凭据、默认模型与常驻模式';
+    readonly 'family.cliMissing': '未检测到 CLI';
+    readonly 'family.empty': '还没有已注册的委派通道';
+    readonly 'family.expand': '展开';
+    readonly 'family.collapse': '收起';
+    readonly 'models.title': '可用模型';
+    readonly 'models.info.aria': '可用模型说明';
+    readonly 'models.info': '列表从上到下是优先级：每轮委派默认使用第一个模型。点「添加模型」从端点当前供应的目录里勾选加入，所以列表里只会有端点真实供应的模型；拖动行调整顺序；留空则跟随原有默认（设置值或 CLI 内置默认）。列表保存在作用域目录（models.json），保存对下一轮委派生效。';
+    readonly 'models.empty': '列表为空 —— 跟随原有默认（设置值或 CLI 内置默认）';
+    readonly 'models.add': '＋ 添加模型';
+    readonly 'models.delete': '移除';
+    readonly 'models.defaultChip': '默认';
+    readonly 'models.orderHint': '拖动行调整顺序，第一个为默认';
+    readonly 'models.applied': '已保存，下一轮委派生效；进行中的轮次不受影响';
+    readonly 'models.error': '保存失败，请重试';
+    readonly 'models.dialog.title': '选择要添加的模型';
+    readonly 'models.dialog.hint': '以下是端点当前供应的模型，勾选要添加的模型。';
+    readonly 'models.dialog.search': '搜索模型';
+    readonly 'models.dialog.selectAll': '全选';
+    readonly 'models.dialog.cancel': '取消';
+    readonly 'models.dialog.confirm': '添加所选';
+    readonly 'models.dialog.loading': '正在加载端点目录…';
+    readonly 'models.dialog.empty': '端点目录为空 —— 先保存凭据';
     readonly 'member.checking': '正在确认成员身份…';
     readonly 'member.readonly.title': '一次性子代理记录';
     readonly 'member.readonly.body': '一次性任务不支持后续消息，可在这里查看完整执行记录。';

package/lib/types/client/locales.js

@@ -24,6 +24,7 @@ export const zh = {
     "configuration.details": "模型目录详情",
     "configuration.model": "模型",
     "configuration.effort": "推理强度",
+    "configuration.effortDefault": "默认",
     "configuration.inherit": "继承成员创建配置",
     "configuration.default": "跟随 harness 默认值",
     "configuration.search": "搜索模型名称或 ID",
@@ -55,7 +56,6 @@ export const zh = {
     "configuration.cancelled": "已接收撤销请求，正在恢复配置。",
     "configuration.failed": "配置操作失败，请检查原因后重试。",
     'stream.thinking': '思考中',
-    'stream.writing': '正在生成',
     'stream.recovering': '部分记录，等待实时连接',
     'stream.copy': '复制',
     'stream.copied': '已复制',
@@ -87,6 +87,30 @@ export const zh = {
     'settings.unsupported': '待支持',
     'settings.rosterFailed': '无法读取本地 Agent 列表，请重试',
     'settings.retry': '重试',
+    'family.title': '本机 Agent 委派',
+    'family.description': '本机安装的编码 agent CLI 的委派通道：端点凭据、默认模型与常驻模式',
+    'family.cliMissing': '未检测到 CLI',
+    'family.empty': '还没有已注册的委派通道',
+    'family.expand': '展开',
+    'family.collapse': '收起',
+    'models.title': '可用模型',
+    'models.info.aria': '可用模型说明',
+    'models.info': '列表从上到下是优先级：每轮委派默认使用第一个模型。点「添加模型」从端点当前供应的目录里勾选加入，所以列表里只会有端点真实供应的模型；拖动行调整顺序；留空则跟随原有默认（设置值或 CLI 内置默认）。列表保存在作用域目录（models.json），保存对下一轮委派生效。',
+    'models.empty': '列表为空 —— 跟随原有默认（设置值或 CLI 内置默认）',
+    'models.add': '＋ 添加模型',
+    'models.delete': '移除',
+    'models.defaultChip': '默认',
+    'models.orderHint': '拖动行调整顺序，第一个为默认',
+    'models.applied': '已保存，下一轮委派生效；进行中的轮次不受影响',
+    'models.error': '保存失败，请重试',
+    'models.dialog.title': '选择要添加的模型',
+    'models.dialog.hint': '以下是端点当前供应的模型，勾选要添加的模型。',
+    'models.dialog.search': '搜索模型',
+    'models.dialog.selectAll': '全选',
+    'models.dialog.cancel': '取消',
+    'models.dialog.confirm': '添加所选',
+    'models.dialog.loading': '正在加载端点目录…',
+    'models.dialog.empty': '端点目录为空 —— 先保存凭据',
     'member.checking': '正在确认成员身份…',
     'member.readonly.title': '一次性子代理记录',
     'member.readonly.body': '一次性任务不支持后续消息，可在这里查看完整执行记录。',
@@ -136,6 +160,7 @@ export const en = {
     "configuration.details": "Model directory details",
     "configuration.model": "Model",
     "configuration.effort": "Reasoning effort",
+    "configuration.effortDefault": "Default",
     "configuration.inherit": "Inherit member configuration",
     "configuration.default": "Follow harness defaults",
     "configuration.search": "Search model names or IDs",
@@ -167,7 +192,6 @@ export const en = {
     "configuration.cancelled": "Cancellation accepted; restoring configuration.",
     "configuration.failed": "Configuration failed; check the reason before retrying.",
     'stream.thinking': 'Thinking',
-    'stream.writing': 'Writing',
     'stream.recovering': 'Partial record, awaiting live connection',
     'stream.copy': 'Copy',
     'stream.copied': 'Copied',
@@ -199,6 +223,30 @@ export const en = {
     'settings.unsupported': 'Coming soon',
     'settings.rosterFailed': 'Could not read the local-agent roster; retry',
     'settings.retry': 'Retry',
+    'family.title': 'Local Agent Delegation',
+    'family.description': 'Delegation channels of the coding-agent CLIs installed on this machine: endpoint credentials, default model, and resident mode',
+    'family.cliMissing': 'CLI not detected',
+    'family.empty': 'No delegation harnesses registered yet',
+    'family.expand': 'Expand',
+    'family.collapse': 'Collapse',
+    'models.title': 'Available models',
+    'models.info.aria': 'About the model list',
+    'models.info': "Order is priority: every delegation round starts with the FIRST model. \"Add model\" checks entries off the endpoint's served catalog, so the list can only hold what the endpoint actually serves; drag rows to reorder; leave empty to follow the previous default (the settings value or the CLI's built-in default). The list persists in the scoped home (models.json) and applies to the next delegation round.",
+    'models.empty': 'List is empty — following the previous default (settings value or the CLI built-in default)',
+    'models.add': '+ Add model',
+    'models.delete': 'Remove',
+    'models.defaultChip': 'Default',
+    'models.orderHint': 'Drag rows to reorder; the first is the default',
+    'models.applied': 'Saved — takes effect on the next delegation round; rounds in flight are unaffected',
+    'models.error': 'Save failed, please retry',
+    'models.dialog.title': 'Choose models to add',
+    'models.dialog.hint': 'These are the models the endpoint currently serves — check the ones to add.',
+    'models.dialog.search': 'Search models',
+    'models.dialog.selectAll': 'Select all',
+    'models.dialog.cancel': 'Cancel',
+    'models.dialog.confirm': 'Add selected',
+    'models.dialog.loading': 'Loading the endpoint catalog…',
+    'models.dialog.empty': 'The endpoint catalog is empty — save a credential first',
     'member.checking': 'Checking membership…',
     'member.readonly.title': 'One-shot subagent record',
     'member.readonly.body': 'One-shot tasks do not accept follow-up messages; the full run record is available here.',

package/lib/types/client/model-directory-scope.d.ts

@@ -0,0 +1,14 @@
+import type { LocalAgentModelDirectory } from '../types.ts';
+/**
+ * Scope a harness's served directory to its curated model list (models.json):
+ * the list IS the invite picker's vocabulary, in the list's own order — a
+ * listed value the endpoint no longer serves stays as a bare row (the member
+ * dialog shows it the same way). No list support, or none configured, keeps
+ * the directory as served. Mirrors the member dialog's scoping rule so the
+ * invite picker and the member configuration show the same candidates.
+ * @param directory - the harness's served directory.
+ * @param list - the curated shortlist values, or null when unsupported.
+ * @returns the scoped directory.
+ */
+export declare function scopeDirectoryToList(directory: LocalAgentModelDirectory, list: readonly string[] | null | undefined): LocalAgentModelDirectory;
+//# sourceMappingURL=model-directory-scope.d.ts.map

package/lib/types/client/model-directory-scope.js

@@ -0,0 +1,20 @@
+/**
+ * Scope a harness's served directory to its curated model list (models.json):
+ * the list IS the invite picker's vocabulary, in the list's own order — a
+ * listed value the endpoint no longer serves stays as a bare row (the member
+ * dialog shows it the same way). No list support, or none configured, keeps
+ * the directory as served. Mirrors the member dialog's scoping rule so the
+ * invite picker and the member configuration show the same candidates.
+ * @param directory - the harness's served directory.
+ * @param list - the curated shortlist values, or null when unsupported.
+ * @returns the scoped directory.
+ */
+export function scopeDirectoryToList(directory, list) {
+    if (list === undefined || list === null || list.length === 0)
+        return directory;
+    const byValue = new Map(directory.entries.flatMap(entry => entry.resolvedModel === undefined
+        ? [[entry.value, entry]]
+        : [[entry.value, entry], [entry.resolvedModel, entry]]));
+    const entries = list.map(value => byValue.get(value) ?? { value, label: value, source: 'configuration' });
+    return { ...directory, entries };
+}

package/lib/types/gateway.d.ts

@@ -10,7 +10,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { LocalAgentDelegationView, LocalAgentModelInfo, LocalAgentModelDirectory, LocalAgentPromptResult, LocalAgentSessionRecord, LocalAgentStreamFrame, LocalAgentMemberControlState, LocalAgentMemberInbox, LocalAgentMemberConfiguration, LocalAgentControlReceipt, LocalAgentMemberFeedRequest, LocalAgentMemberFeedEvent } from './types.ts';
-import type { LocalAgentRosterRow, LocalAgentStatus } from './types.ts';
+import type { LocalAgentRosterRow, LocalAgentStatus, LocalAgentEndpointAuthFields, LocalAgentEndpointAuthState } from './types.ts';
 export default class LocalAgentGateway extends TypertRemoteService {
     static inject: string[];
     constructor(ctx: Context);
@@ -103,6 +103,54 @@ export default class LocalAgentGateway extends TypertRemoteService {
      * @returns the layer-by-layer surface, or null.
      */
     harnessModel(name: string): Promise<LocalAgentModelInfo | null>;
+    /**
+     * Verify one harness's saved endpoint from the host — the settings card's
+     * verify button. The answer is the harness's human-readable verdict text.
+     * Session-less by design: the commands channel needs a main agent session,
+     * which a settings card may not have. Null when the harness is unknown or
+     * declares no probe (the card then hides the button — declare-and-degrade).
+     * @param name - the harness name.
+     * @returns the verdict text, or null.
+     */
+    checkEndpoint(name: string): Promise<string | null>;
+    /**
+     * The settings card's read of one harness's resolved endpoint state —
+     * baseUrl verbatim, credentials as presence booleans (secrets never cross).
+     * Session-less like the rest of the gateway. Null when the harness is
+     * unknown or declares no endpoint face (the card then hides the form).
+     * @param name - the harness name.
+     * @returns the resolved per-field state, or null.
+     */
+    endpointAuth(name: string): Promise<LocalAgentEndpointAuthState | null>;
+    /**
+     * Apply one endpoint-credential edit into the harness's own credential
+     * store (a string sets, null clears, absent leaves), answering the
+     * post-write resolved state so the card can flip immediately. The write
+     * deliberately bypasses the volatile row-config channel — a credential
+     * never lands in the profile patch document. Null when the harness is
+     * unknown or declares no endpoint face.
+     * @param name - the harness name.
+     * @param fields - the field edits.
+     * @returns the post-write resolved state, or null.
+     */
+    configureEndpoint(name: string, fields: LocalAgentEndpointAuthFields): Promise<LocalAgentEndpointAuthState | null>;
+    /**
+     * The settings card's read of one harness's curated model list — ordered
+     * identifiers, first is the default. Null when the harness is unknown or
+     * declares no list face (the card then hides the editor).
+     * @param name - the harness name.
+     * @returns the ordered list, or null.
+     */
+    modelList(name: string): Promise<readonly string[] | null>;
+    /**
+     * Replace one harness's curated model list wholesale (reorders, removals
+     * and additions all ride the same write), answering the list as persisted.
+     * Null when the harness is unknown or declares no list face.
+     * @param name - the harness name.
+     * @param models - the new ordered list.
+     * @returns the persisted list, or null.
+     */
+    configureModelList(name: string, models: readonly string[]): Promise<readonly string[] | null>;
     /**
      * The model surface of one member — the composer's picker read. The
      * delegation record's requested model rides in from the core so the broker