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

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

@@ -43,21 +43,37 @@ export interface DshSettingsCardInjected {
     };
 }
 /**
- * Full props of the 0.1.5 settings.plugin.item card entry. The removed slot's
- * owner share was intentionally empty and its root scope delivered the global
- * seats; the structural type below is exact about the one seat the auth block
- * consumes (the slot name is gone from the alpha.2 SlotMap, so the
- * registration goes through a duck-typed narrow — see client/index.ts).
+ * Full props of the retired 0.1.5 settings.plugin.item card. The host removed
+ * that seat and client/index.ts no longer registers the component — the live
+ * settings surface is the plugins.item entry built on the BundleConfig
+ * component below; this export remains for the component spec and direct
+ * composers. The removed slot's owner share was intentionally empty and its
+ * root scope delivered the global seats; the structural type below is exact
+ * about the one seat the auth block consumes.
  */
 export type DshSettingsCardProps = InjectFace<DshSettingsCardInjected> & PropsLocale<typeof NS> & {
     /** The standing root-scope global seat (ui-session's merge), delivered to the 0.1.5 card by the renderer. */
     useSessions: ProviderAuthBlockProps['useSessions'];
 };
-/** Full props of the alpha.2 plugins.bundle.config entry (owner prop `view`). */
-export type DshBundleConfigProps = PropsRuntime<'plugins.bundle.config'> & InjectFace<DshSettingsCardInjected> & PropsLocale<typeof NS>;
+/** Full props of the plugins.item entry (owner prop `view`). */
+export type DshBundleConfigProps = PropsRuntime<'plugins.item'> & InjectFace<DshSettingsCardInjected> & PropsLocale<typeof NS>;
 /**
- * The dsh harness settings card in the 0.1.5 plugin configuration tab: the
- * same collapsible chrome the official plugin cards use, re-implemented
+ * Full props of the harness's section inside the core's「本机 Agent 委派」
+ * family card: the same inject face minus the slot-owner share, plus the one
+ * global seat the body consumes, forwarded by the family card (the section
+ * render bypasses the slot runtime, so its remaining standard seats are not
+ * fabricable here and are deliberately absent).
+ */
+export type DshCardSectionProps = InjectFace<DshSettingsCardInjected> & PropsLocale<typeof NS> & {
+    /** Whether the section is currently expanded (the family card mounts the body only while it is). */
+    readonly active: boolean;
+    /** The standing root-scope global seat (ui-session's merge), forwarded by the family card. */
+    readonly useSessions: ProviderAuthBlockProps['useSessions'];
+};
+/**
+ * The dsh harness settings card of the retired 0.1.5 plugin configuration
+ * tab (no longer registered; the live surface is the plugins.item entry
+ * below): the same collapsible chrome the official plugin cards use, re-implemented
  * locally (the bundle-purity gate forbids value-importing the official chrome
  * — the context-guard pattern), with the at-a-glance credential dot in the
  * header. Explanation copy lives in hover/focus bubbles behind ⓘ anchors —
@@ -67,12 +83,24 @@ export type DshBundleConfigProps = PropsRuntime<'plugins.bundle.config'> & Injec
  */
 export declare function DshSettingsCard(props: DshSettingsCardProps): import("react").JSX.Element;
 /**
- * The bundle's configuration on the alpha.2 Plugins page
- * (`plugins.bundle.config`, keyed by package name): the page draws the title,
- * the icon, and the crumb itself, so the entry renders the one-liner for the
- * `summary` view and the bare form — with its own save control — for `page`.
+ * The provider's card on the Plugins page (the `plugins.item` entry
+ * client/index.ts registers while the Host serves the namespace AND the core
+ * predates the family card): the page
+ * draws the title, the icon, and the crumb itself, so the entry renders the
+ * one-liner for the `summary` view and the bare form — with its own save
+ * control — for `page`.
  * @param props - the owner view, the injected scope/auth faces, and copy.
  * @returns the entry.
  */
 export declare function DshBundleConfig({ view, useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t }: DshBundleConfigProps): import("react").JSX.Element;
+/**
+ * The harness's section inside the core's「本机 Agent 委派」family card: the
+ * same useCardState + CardBody the plugins.item page view renders — the
+ * collapsible chrome belongs to the family card now. The delegation enable
+ * switch keeps its semantics: it writes the scope, the host mounts/unmounts
+ * the harness on the served value, and the section itself stays put.
+ * @param props - the injected scope/auth faces, the forwarded session seat, and copy.
+ * @returns the section body.
+ */
+export declare function DshCardSection({ active, useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t }: DshCardSectionProps): import("react").JSX.Element;
 //# sourceMappingURL=SettingsCard.d.ts.map

package/lib/types/client/SettingsCard.js

@@ -161,8 +161,9 @@ function CardBody({ state, auth, authT, renderModelPicker, useSessions, t }) {
     return (_jsxs("div", { className: css.body, children: [_jsxs("section", { className: css.block, children: [_jsx("h3", { className: css.blockTitle, children: t('auth.title') }), _jsx(ProviderAuthBlock, { harness: { id: 'dsh', label: 'dsh' }, useSessions: useSessions, status: auth.status, runCommand: auth.runCommand, t: authT }), _jsx("span", { className: css.hint, children: t('auth.host') })] }), _jsxs("section", { className: css.block, children: [_jsx("h3", { className: css.blockTitle, children: t('enable.title') }), _jsxs("div", { className: css.row, children: [_jsx("span", { className: css.rowLabel, children: t('enable.switch') }), _jsx("button", { type: "button", role: "switch", "aria-checked": enabled, "aria-label": t('enable.switch.aria'), className: enabled ? `${css.switch} ${css.switchOn}` : css.switch, disabled: !ready, onClick: () => { write('enabled', !enabled); }, children: _jsx("span", { className: css.knob }) })] }), _jsx("span", { className: css.hint, children: t(enabled ? 'enable.on' : 'enable.off') })] }), _jsxs("section", { className: css.block, children: [_jsxs("h3", { className: css.blockTitle, children: [t('model.title'), _jsx(Tooltip, { label: t('model.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('model.info.aria'), children: "\u24D8" }) })] }), _jsxs("div", { className: css.row, children: [renderModelPicker?.({ value: modelValue, onChange: setModelDraft, disabled: !ready, defaultLabel: modelDefaultItem }) ?? (choices.length > 0 ? (_jsxs("div", { className: css.modelField, ref: modelFieldRef, children: [modelInputElement, _jsx("button", { type: "button", className: css.modelMenuButton, "aria-label": t('model.menu'), "aria-haspopup": "menu", "aria-expanded": modelMenuOpen, disabled: !ready, onClick: () => { toggleModelMenu(); }, children: _jsx(IconChevronDownOutlineMedium, { className: modelMenuOpen ? `${css.modelMenuChevron} ${css.modelMenuChevronOpen}` : css.modelMenuChevron }) }), modelMenuOpen && (_jsxs("div", { className: modelMenuUp ? `${css.modelMenu} ${css.modelMenuUp}` : css.modelMenu, role: "menu", "aria-label": t('model.menu'), children: [_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": modelValue.trim() === '', className: modelValue.trim() === '' ? `${css.modelItemDefault} ${css.modelItemCurrent}` : css.modelItemDefault, onClick: () => { setModelDraft(''); setModelMenuOpen(false); }, children: [_jsx("span", { className: css.modelItemLabel, children: modelDefaultItem }), _jsx("span", { className: css.modelItemCheck, "aria-hidden": true, children: modelValue.trim() === '' ? '✓' : '' })] }), choices.map(choice => (_jsxs("button", { type: "button", role: "menuitemradio", "aria-checked": choice === modelValue, className: choice === modelValue ? css.modelItemCurrent : css.modelItem, onClick: () => { setModelDraft(choice); setModelMenuOpen(false); }, children: [_jsx("span", { className: css.modelItemLabel, children: choice }), _jsx("span", { className: css.modelItemCheck, "aria-hidden": true, children: choice === modelValue ? '✓' : '' })] }, choice)))] }))] })) : modelInputElement), _jsx("button", { type: "button", className: css.modelSave, disabled: !ready || modelValue.trim() === storedModel, onClick: () => { saveModel(); }, children: t('model.save') })] }), modelSaved && _jsx("span", { className: css.saved, children: t('model.applied') }), modelError && _jsx("span", { className: css.errorText, children: t('model.error') })] }), _jsxs("section", { className: css.block, children: [_jsxs("div", { className: css.row, children: [_jsxs("span", { className: css.rowLabel, children: [t('live.title'), _jsx(Tooltip, { label: t('live.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('live.info.aria'), children: "\u24D8" }) })] }), _jsx("button", { type: "button", role: "switch", "aria-checked": live, "aria-label": t('live.title'), className: live ? `${css.switch} ${css.switchOn}` : css.switch, disabled: !ready, onClick: () => { write('live', !live); }, children: _jsx("span", { className: css.knob }) })] }), snapshot.status === 'unavailable' && (_jsx("span", { className: css.hint, children: t('live.unavailable') }))] }), saved && _jsx("span", { className: css.saved, children: t('live.applied') }), error && _jsx("span", { className: css.errorText, children: t('live.error') })] }));
 }
 /**
- * The dsh harness settings card in the 0.1.5 plugin configuration tab: the
- * same collapsible chrome the official plugin cards use, re-implemented
+ * The dsh harness settings card of the retired 0.1.5 plugin configuration
+ * tab (no longer registered; the live surface is the plugins.item entry
+ * below): the same collapsible chrome the official plugin cards use, re-implemented
  * locally (the bundle-purity gate forbids value-importing the official chrome
  * — the context-guard pattern), with the at-a-glance credential dot in the
  * header. Explanation copy lives in hover/focus bubbles behind ⓘ anchors —
@@ -185,10 +186,12 @@ export function DshSettingsCard(props) {
     return (_jsxs("li", { className: open ? `${css.card} ${css.cardOpen}` : css.card, children: [_jsxs("button", { type: "button", className: css.header, "aria-expanded": open, "aria-label": `${t(open ? 'card.collapse' : 'card.expand')}: ${title}`, onClick: () => { setOpen(!open); }, children: [_jsxs("span", { className: css.headText, children: [_jsxs("span", { className: css.nameRow, children: [_jsx("span", { className: css.name, children: title }), _jsx(AuthStatusDot, { status: authStatus, label: dotLabel })] }), _jsx("span", { className: css.description, children: t('card.description') })] }), _jsx(IconChevronDownOutlineMedium, { className: open ? `${css.chevron} ${css.chevronOpen}` : css.chevron })] }), open && _jsx(CardBody, { state: state, auth: auth, authT: authT, renderModelPicker: renderModelPicker, useSessions: useSessions, t: t })] }));
 }
 /**
- * The bundle's configuration on the alpha.2 Plugins page
- * (`plugins.bundle.config`, keyed by package name): the page draws the title,
- * the icon, and the crumb itself, so the entry renders the one-liner for the
- * `summary` view and the bare form — with its own save control — for `page`.
+ * The provider's card on the Plugins page (the `plugins.item` entry
+ * client/index.ts registers while the Host serves the namespace AND the core
+ * predates the family card): the page
+ * draws the title, the icon, and the crumb itself, so the entry renders the
+ * one-liner for the `summary` view and the bare form — with its own save
+ * control — for `page`.
  * @param props - the owner view, the injected scope/auth faces, and copy.
  * @returns the entry.
  */
@@ -198,3 +201,16 @@ export function DshBundleConfig({ view, useSettings, scope, auth, authT, renderM
         return _jsx("span", { className: css.description, children: t('card.description') });
     return _jsx(CardBody, { state: state, auth: auth, authT: authT, renderModelPicker: renderModelPicker, useSessions: useSessions, t: t });
 }
+/**
+ * The harness's section inside the core's「本机 Agent 委派」family card: the
+ * same useCardState + CardBody the plugins.item page view renders — the
+ * collapsible chrome belongs to the family card now. The delegation enable
+ * switch keeps its semantics: it writes the scope, the host mounts/unmounts
+ * the harness on the served value, and the section itself stays put.
+ * @param props - the injected scope/auth faces, the forwarded session seat, and copy.
+ * @returns the section body.
+ */
+export function DshCardSection({ active, useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t }) {
+    const state = useCardState(active, useSettings, scope, harnessModel, t);
+    return _jsx(CardBody, { state: state, auth: auth, authT: authT, renderModelPicker: renderModelPicker, useSessions: useSessions, t: t });
+}

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.

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

@@ -1,30 +1,7 @@
-/**
- * Local-agent-dsh plugin, browser half: the dsh settings surface, one face
- * per install shape and host line — a standalone install renders the
- * bundle's own configuration on its Plugins-page detail view
- * (`plugins.bundle.config`, keyed by package name), a family-bundle install
- * renders the same card through the row-level configure entry on the
- * BUNDLE's detail view (`plugins.row.config`, keyed
- * `@khorsheed/dsh-bundle-local-agent#local-agent-dsh`), and 0.1.5 renders
- * the `settings.plugin.item` card (keyed to the `local-agent-dsh`
- * settings namespace the host half registers) in the official
- * Plugins → 可配置插件 tab. The card carries the family core's shared
- * ProviderAuthBlock (dsh authenticates through the host credentials, so the
- * block renders status only), the DeepSeek delegation switch — migrated from
- * the core section's `local-agent.settings.row-action` seat, which this
- * plugin no longer contributes to — and the resident-mode block (live switch)
- * plus the default-model block (free-text input, the broker's effective-model
- * line and suggestion vocabulary), whose writes ride the bound settingsScope:
- * the host watcher hot-applies them, no reload. Every read degrades: an
- * absent gateway renders the auth block's 'unavailable' state and drops the
- * model surface to the bare input, an unregistered namespace disables the
- * controls.
- * @module @khorsheed/dsh-local-agent-dsh/client
- */
 import type { Context } from '@deepseek-ai/cordis';
 import { en, NS, zh, type LocalAgentDshKey } from './locales.ts';
-export { DshBundleConfig, DshSettingsCard } from './SettingsCard.tsx';
-export type { DshCardSettings, DshBundleConfigProps, DshSettingsCardInjected, DshSettingsCardProps, } from './SettingsCard.tsx';
+export { DshBundleConfig, DshCardSection, DshSettingsCard } from './SettingsCard.tsx';
+export type { DshCardSettings, DshBundleConfigProps, DshCardSectionProps, DshSettingsCardInjected, DshSettingsCardProps, } from './SettingsCard.tsx';
 export { en, NS, zh };
 export type { LocalAgentDshKey };
 /**
@@ -33,11 +10,12 @@ export type { LocalAgentDshKey };
  * line (`settingsScope` on 0.1.5, `configForms` on rc.1), so a static entry
  * would pend the whole client plugin on the other line; bindSettingsScope
  * probes the serving one instead (the settings client package is a declared
- * client inject, so one of them is always already up).
+ * client inject, so one of them is always already up). The card track probes
+ * `configForms` through the same kind of deferred inject (see apply).
  */
 export declare const inject: string[];
 /**
- * Client plugin body: register the dictionaries and the dsh settings surfaces
+ * Client plugin body: register the dictionaries and the dsh settings card
  * bound to the local-agent-dsh namespace.
  * @param ctx - client root context.
  */

package/lib/types/client/index.js

@@ -1,30 +1,50 @@
 import { bindSettingsScope } from '@khorsheed/dsh-local-agent/src/client/settings-scope.ts';
-import { en, NS, zh } from './locales.js';
-import { DshBundleConfig, DshSettingsCard, } from './SettingsCard.js';
-export { DshBundleConfig, DshSettingsCard } from './SettingsCard.js';
-export { en, NS, zh };
 /**
- * This bundle's package name — the key the Plugins page dispatches
- * `plugins.bundle.config` entries on (identity triangle: cordis.patch.yml,
- * tsdown.config.ts, invariant.ts).
+ * Local-agent-dsh plugin, browser half: the dsh settings card — a section of
+ * the family core's「本机 Agent 委派」family card on the Plugins page
+ * (registered through the core's `localAgentUi.registerHarnessCard` while the
+ * Host serves the `local-agent-dsh` namespace), or this package's own
+ * `plugins.item` entry when the core predates the family card (the
+ * declare-and-degrade fallback). Every
+ * install shape serves the row's volatile Config under the row id —
+ * standalone install, family bundle, or mode pack — so the card follows the
+ * served namespace rather than any carrier bundle, and a composition without
+ * the row shows no trace of it. The card carries the family core's shared
+ * ProviderAuthBlock (dsh authenticates through the host credentials, so the
+ * block renders status only), the DeepSeek delegation switch — migrated from
+ * the core section's `local-agent.settings.row-action` seat, which this
+ * plugin no longer contributes to — and the resident-mode block (live switch)
+ * plus the default-model block (free-text input, the broker's effective-model
+ * line and suggestion vocabulary), whose writes ride the bound settingsScope:
+ * the host watcher hot-applies them, no reload. Every read degrades: an
+ * absent gateway renders the auth block's 'unavailable' state and drops the
+ * model surface to the bare input, an unregistered namespace disables the
+ * controls.
+ * @module @khorsheed/dsh-local-agent-dsh/client
  */
-const PACKAGE_NAME = '@khorsheed/dsh-local-agent-dsh';
+import { createElement, useSyncExternalStore } from 'react';
+import { en, NS, zh } from './locales.js';
+import { DshBundleConfig, DshCardSection, } from './SettingsCard.js';
+export { DshBundleConfig, DshCardSection, DshSettingsCard } from './SettingsCard.js';
+export { en, NS, zh };
 /**
  * Required services: slot registry, command Remote, and locale registry. The
  * settings scope is NOT a static inject — its service name differs per host
  * line (`settingsScope` on 0.1.5, `configForms` on rc.1), so a static entry
  * would pend the whole client plugin on the other line; bindSettingsScope
  * probes the serving one instead (the settings client package is a declared
- * client inject, so one of them is always already up).
+ * client inject, so one of them is always already up). The card track probes
+ * `configForms` through the same kind of deferred inject (see apply).
  */
 export const inject = ['slots', 'remote', 'remote.commands', 'locale'];
 /**
- * Client plugin body: register the dictionaries and the dsh settings surfaces
+ * Client plugin body: register the dictionaries and the dsh settings card
  * bound to the local-agent-dsh namespace.
  * @param ctx - client root context.
  */
 export function apply(ctx) {
     ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'local-agent-dsh: dictionaries');
+    const t = ctx.locale.bind(NS);
     const scope = bindSettingsScope(ctx, 'local-agent-dsh');
     // The auth block's copy lives in the family core's dictionary; binding is
     // stable per namespace and late dictionary registration still resolves.
@@ -34,10 +54,11 @@ export function apply(ctx) {
     // never matters, and degrade to the auth block's 'unavailable' state when
     // the core client is absent.
     const gateway = () => ctx.get('remote.localAgentGateway');
-    // Both settings surfaces inject the same face.
-    const cardInject = () => ({
+    // The card's inject face minus the hooks compartment — the family-card
+    // section consumes this verbatim; the standalone card's slot registration
+    // adds the hooks compartment back below.
+    const cardFace = () => ({
         scope,
-        hooks: { settings: scope },
         authT,
         renderModelPicker: props => ctx.get('localAgentUi')?.renderHarnessModelPicker('dsh', props),
         // The harness's memberless model surface; absent gateway/broker
@@ -54,35 +75,57 @@ export function apply(ctx) {
                 .then(result => (result.ok ? result.value?.result.text : undefined)),
         },
     });
-    // The settings surface follows the host line AND the install shape — three
-    // tracks, all riding slots.inject so each fires only where its declaration
-    // exists. Standalone install: the package's own Plugins-page detail view
-    // (`plugins.bundle.config`, keyed by package name). Installed as a family
-    // member: the member is no longer the profile's direct dependency, so only
-    // the bundle gets a detail view — the card rides the row-level slot
-    // (`plugins.row.config`, keyed `<bundle package>#<row id>` with the row id
-    // the bundle's patch declares) and the bundle's page gains a configure
-    // entry opening it. 0.1.5: the legacy configurable-plugins tab card
-    // (`settings.plugin.item`, keyed by the settings namespace) through a
-    // string-keyed duck narrow of the same service (the slot name is gone from
-    // the alpha.2 SlotMap).
-    ctx.slots.inject('plugins.bundle.config', () => ctx.slots.register({
-        name: 'plugins.bundle.config',
-        key: PACKAGE_NAME,
-        locale: NS,
-        inject: cardInject,
-    }, DshBundleConfig));
-    ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
-        name: 'plugins.row.config',
-        key: '@khorsheed/dsh-bundle-local-agent#local-agent-dsh',
-        locale: NS,
-        inject: cardInject,
-    }, DshBundleConfig));
-    const legacy = ctx.slots;
-    legacy.inject('settings.plugin.item', () => legacy.register({
-        name: 'settings.plugin.item',
-        key: 'local-agent-dsh',
-        locale: NS,
-        inject: cardInject,
-    }, DshSettingsCard));
+    // The settings card injects this face.
+    const cardInject = () => ({ ...cardFace(), hooks: { settings: scope } });
+    // The family-card section render bypasses the slot renderer's inject.hooks
+    // materialization, so bind the scope's selector hook here with the same
+    // semantics (a uSES subscription over the scope's own subscribe/getSnapshot).
+    const subscribeScope = (listener) => scope.subscribe(listener);
+    const readScope = () => scope.getSnapshot();
+    const useSettings = (select) => select(useSyncExternalStore(subscribeScope, readScope));
+    // One Plugins-page seat gated on the SERVED NAMESPACE, never on the install
+    // shape: whichever composition carries the `local-agent-dsh` row —
+    // standalone install, family bundle, or mode pack — serves the row's
+    // volatile Config under the row id, and `whileServed` keeps the
+    // registration alive for exactly that span (the official companion
+    // convention), so a composition without the row shows no trace of the card.
+    // This replaces the retired per-shape seats: `plugins.row.config` hardcoded
+    // one carrier bundle into its key, and the host deleted
+    // `settings.plugin.item`. The probe rides a deferred inject because
+    // configForms exists only on the alpha.2+ host line; a 0.1.5 host never
+    // fires it, and a configForms predating whileServed (0.1.6-alpha.2) skips
+    // the card.
+    ctx.inject(['configForms'], (formsCtx) => {
+        const forms = formsCtx.configForms;
+        if (typeof forms.whileServed !== 'function')
+            return;
+        return forms.whileServed(['local-agent-dsh'], () => {
+            // The family card owns the Plugins-page seat when the core's client
+            // provides it: a core new enough answers registerHarnessCard, and this
+            // package renders as a section of the「本机 Agent 委派」card instead of
+            // its own entry. The probe runs at serve time — a host round-trip past
+            // client plugin boot — so a composed core has already provided the
+            // service; an old or absent core keeps the standalone card below.
+            const ui = ctx.get('localAgentUi');
+            if (typeof ui?.registerHarnessCard === 'function') {
+                return ui.registerHarnessCard({
+                    name: 'dsh',
+                    // The retired standalone card's order, kept as the section order.
+                    order: 140,
+                    locale: NS,
+                    label: () => t('card.title'),
+                    render: ({ active, useSessions }) => createElement(DshCardSection, { active, useSessions, ...cardFace(), useSettings, t }),
+                });
+            }
+            return ctx.slots.inject('plugins.item', () => ctx.slots.register({
+                name: 'plugins.item',
+                id: 'local-agent-dsh',
+                // Community cards sort after the official settings pages (orders 10-40).
+                order: 140,
+                label: () => t('card.title'),
+                locale: NS,
+                inject: cardInject,
+            }, DshBundleConfig));
+        });
+    });
 }

package/lib/types/client/locales.js

@@ -3,7 +3,7 @@
 export const NS = 'local-agent-dsh';
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export const zh = {
-    'card.title': 'Local Agent · dsh',
+    'card.title': '本机 DSH 委派',
     'card.description': 'dsh 自委派：开关、认证状态与常驻模式（live）',
     'card.expand': '展开',
     'card.collapse': '收起',
@@ -35,7 +35,7 @@ export const zh = {
 };
 /** English dictionary, checked complete against the zh key set. */
 export const en = {
-    'card.title': 'Local Agent · dsh',
+    'card.title': 'Local DSH Delegation',
     'card.description': 'dsh self-delegation: toggle, credential status, and resident (live) mode',
     'card.expand': 'Expand',
     'card.collapse': 'Collapse',

package/lib/types/dsh-cli-provider.js

@@ -10,15 +10,16 @@
  * that session. No stdout parsing — the sub-dsh session id is known a priori.
  * @module @khorsheed/dsh-local-agent-dsh/dsh-cli-provider
  */
+import { localModelLaunch } from './model-launch.js';
 import { randomUUID } from 'node:crypto';
 import { credentialRef } from '@deepseek-ai/dsh-credentials';
 import { SessionId } from '@deepseek-ai/dsh-session';
-import { NO_START_CAPABILITIES, settleRunResult, subprocessRunHandle, } from '@deepseek-ai/dsh-subagent';
-import { assertResumeCwdUnchanged, assertResumeScopeUnchanged, resolveRoundModel, containerExecSpawn, containerScopedHome, delegationEnv, establishSubagentCatalogChild, probeCliVersion, resolveChildCwd, subagentDelegationLabel, } from '@khorsheed/dsh-local-agent';
+import { NO_START_CAPABILITIES, SUBAGENT_DESCRIPTOR_VERSION, settleRunResult, subprocessRunHandle, } from '@deepseek-ai/dsh-subagent';
+import { assertResumeCwdUnchanged, assertResumeScopeUnchanged, resolveRoundModel, containerExecSpawn, containerScopedHome, delegationEnv, establishSubagentCatalogChild, persistChildSession, probeCliVersion, resolveChildCwd, subagentDelegationLabel, } from '@khorsheed/dsh-local-agent';
 import { MEMBER_BRIDGE_SOCKET_ENV, MEMBER_BRIDGE_TOKEN_ENV } from '@khorsheed/dsh-local-agent/types';
 import { LiveChannelUnavailableError } from './live-driver.js';
-import { DEFAULT_SUB_PROFILE_NAME, provisionDshScope } from './provision.js';
-import { mirrorDshSession } from './session-mirror.js';
+import { DEFAULT_SUB_PROFILE_NAME, provisionDshScope, unitSubProfileName } from './provision.js';
+import { closeMirroredOpenStep, mirrorDshSession } from './session-mirror.js';
 /**
  * Spawn-env name carrying the bridge entry path into the sub-dsh process,
  * where the headless bundle's mcp-client row reads it (`!!js`). The name is a
@@ -168,7 +169,7 @@ export class DshCliProvider {
                 ...record?.configurationLock === undefined ? {} : { configurationLock: record.configurationLock },
             }, configuration => this.startDshResume(request, intent, cwd, homeDir, exec, scope, record?.model, configuration), request.signal, intent?.onAdmitted);
         }
-        const childSessionId = SessionId(intent?.preparedMemberId ?? randomUUID());
+        const childSessionId = SessionId(intent?.preparedMemberId ?? intent?.childSessionId ?? randomUUID());
         if (typeof this.ctx.localAgent.withMemberConfigurationRound !== 'function') {
             if (intent?.effort !== undefined)
                 throw new Error('DSH effort requires the configuration admission core');
@@ -202,20 +203,25 @@ export class DshCliProvider {
                     delegationDepth: (request.parent.session.header.delegationDepth ?? 0) + 1,
                 },
             });
-            // The durable one-shot descriptor the runtime resolved marks this child
-            // as session-backed; without it the 子代理 projection cannot classify
-            // the session and the delegation stays invisible. The label carries the
-            // harness display name as the source marker so the dropdown shows which
-            // local agent produced the conversation.
+            // The durable one-shot descriptor marks this child as session-backed;
+            // without it the 子代理 projection cannot classify the session and the
+            // delegation stays invisible. Host 0.2.1 no longer resolves a descriptor
+            // onto the request (the runtime's one-shot snapshot is gone), so the
+            // provider stamps the same payload itself. The label carries the harness
+            // display name as the source marker so the dropdown shows which local
+            // agent produced the conversation; the activation spec's required label
+            // arrives as the empty string when the caller named none.
             const harness = this.ctx.localAgent.get('dsh');
-            const label = subagentDelegationLabel(harness?.displayName ?? 'dsh', request.descriptor.label);
+            const label = subagentDelegationLabel(harness?.displayName ?? 'dsh', request.label || undefined);
             childSession.append('subagent/descriptor', {
-                ...request.descriptor,
+                version: SUBAGENT_DESCRIPTOR_VERSION,
+                mode: 'one-shot',
+                provider: this.name,
                 label,
             });
-            // The official runtime appends the parent-side subagent/catalog
-            // discovery row only for in-process children (run.localAgent); this run
-            // is remote, so the provider appends it here — once per child, where
+            // The 0.2.1 manager appends the parent-side subagent/catalog discovery
+            // row only for parent-delivered children; the family runs caller
+            // delivery, so the provider appends it here — once per child, where
             // the descriptor lands. A failure degrades to the warn below; a missing
             // row never blocks the delegation.
             establishSubagentCatalogChild(request.parent.session, childSession.header, label);
@@ -488,20 +494,25 @@ export async function startDshCliRun(request, spec) {
     if (request.signal.aborted) {
         throw new Error('subagent-dsh: request was aborted before the CLI started');
     }
-    const profileName = config.profileName ?? DEFAULT_SUB_PROFILE_NAME;
+    // A container round launches the `-unit` twin when one is configured: its
+    // headless link names the image's own install, while the host profile
+    // links this instance's (`unitHeadlessBundleDir`).
+    const profileName = spec.exec === undefined ? config.profileName ?? DEFAULT_SUB_PROFILE_NAME : unitSubProfileName(config);
     // Provisioning is idempotent and cheap; re-running heals a deleted or
     // drifted sub-profile before every round. A CONTAINER round skips it: the
-    // sub-profile's node_modules symlink points at the host installation of the
-    // headless bundle, which resolves to nothing inside a unit — and the scoped
+    // sub-profile's node_modules carries the HOST installation's headless
+    // bundle (a copy of the host line's build, or a link that resolves to
+    // nothing inside a unit) — and the scoped
     // home is bind-mounted, so writing it would plant a broken profile in the
     // directory the unit actually reads. A containerized caller names the
     // unit's own profile through `profileName` (the image's in-box `headless`)
     // and its own entry through `cliLaunch`.
     if (spec.exec === undefined)
-        provisionDshScope(spec.homeDir, config);
+        provisionDshScope(spec.homeDir, { ...config, inheritModelConfiguration: true });
     // Resolve the sub-dsh credential BEFORE spawning: the key travels in the
     // explicit env layer, which is the only way past the shared env scrub.
-    const apiKey = await resolveApiKey(ctx, config);
+    const modelEnv = spec.exec === undefined ? (await localModelLaunch(ctx, config, spec.model)).env
+        : { DEEPSEEK_API_KEY: await resolveApiKey(ctx, config) };
     const turn = spec.resume?.turn ?? 1;
     // The turn opens at the real spawn moment so the timing projection
     // measures actual CLI runtime.
@@ -525,7 +536,7 @@ export async function startDshCliRun(request, spec) {
     // sessions into the parent instance's store.
     const env = delegationEnv({
         DSH_HOME: spec.homeDir,
-        DEEPSEEK_API_KEY: apiKey,
+        ...modelEnv,
         // The launch replicates the parent's tsx ESM hook (dshLaunchArgv), so
         // the hook's tsconfig path is a hard launch dependency: without it tsx
         // compiles the harness source with default options and the child dies
@@ -674,47 +685,71 @@ export async function startDshCliRun(request, spec) {
         // reached its endpoint and produced an answer.
         if (settled.stopReason === 'completed')
             markCredentialVerified(ctx, spec.scope);
-        // The turn closes at the real settle moment, so the timing projection's
-        // duration equals the actual CLI runtime. Every terminal path closes the
-        // window — a failed or cancelled run settles 'error'/'aborted' instead of
-        // leaving the turn open with a distorted tiny duration.
-        if (spec.childSession !== undefined) {
-            if (settled.stopReason === 'completed') {
-                spec.childSession.append('turn/end', { turn, reason: { kind: 'completed' } });
-            }
-            else if (settled.stopReason === 'aborted') {
-                spec.childSession.append('turn/end', { turn, reason: { kind: 'aborted', reason: { kind: 'parent' } } });
-            }
-            else {
-                spec.childSession.append('turn/end', {
-                    turn,
-                    reason: { kind: 'error', error: { message: 'dsh exited before the run completed', code: 'UNKNOWN' } },
-                });
-            }
-        }
+        // The turn does NOT close here: turn/end lands in the mirror queue after
+        // the settle pass (see below), so every mirrored event precedes it in the
+        // stored log — the released-log reader rejects content outside an open
+        // turn on every cold read.
         return settled;
     });
     // After the child EXITS — however it ended (completed, killed by dispose, or
     // crashed) — mirror whatever the sub-dsh session already produced into the
     // dsh subagent session, so every round preserves its conversation and real
     // token usage instead of showing turn boundaries only. Waits for the settle
-    // chain first (so turn/end is already appended) AND for the process to
-    // actually exit (the sub-dsh flushed its session before exiting) before
-    // reading.
+    // chain first AND for the process to actually exit (the sub-dsh flushed its
+    // session before exiting) before reading. The turn closes INSIDE the mirror
+    // queue, after the settle pass: the copied tail's open step first receives
+    // its closure (an interrupted sub-dsh leaves its step — and any advertised
+    // tool calls — open, and the released-log reader rejects a turn/end over
+    // it), then turn/end lands and is persisted explicitly (the mirror's own
+    // persist skips a no-op pass, which is exactly the case that needs the
+    // boundary written). Every terminal path closes the window — a failed or
+    // cancelled run settles 'error'/'aborted' instead of leaving the turn open.
     void result.then(() => child.done).then(() => {
         if (spec.childSession !== undefined) {
             const childSession = spec.childSession;
             // The settle pass reports the final mirror count even when polling
             // already covered the round (empty delta): it is authoritative.
-            return enqueueMirror(() => mirrorAndReport(childSession, true));
+            return enqueueMirror(async () => {
+                const settled = await result;
+                try {
+                    await mirrorAndReport(childSession, true);
+                }
+                catch (error) {
+                    // The mirror degrades to a warn; the turn boundary still closes —
+                    // an open turn at EOF reads as an interrupted tail only until the
+                    // next resume round tries to open its turn over it.
+                    ctx.logger.warn(`subagent-dsh: settle mirror failed: ${error instanceof Error ? error.message : String(error)}`);
+                }
+                closeMirroredOpenStep(childSession);
+                // The turn closes at the real settle moment (plus the settle-mirror
+                // quiescence), so the timing projection's duration equals the actual
+                // CLI runtime.
+                if (settled.stopReason === 'completed') {
+                    childSession.append('turn/end', { turn, reason: { kind: 'completed' } });
+                }
+                else if (settled.stopReason === 'aborted') {
+                    childSession.append('turn/end', { turn, reason: { kind: 'aborted', reason: { kind: 'parent' } } });
+                }
+                else {
+                    childSession.append('turn/end', {
+                        turn,
+                        reason: { kind: 'error', error: { message: 'dsh exited before the run completed', code: 'UNKNOWN' } },
+                    });
+                }
+                await persistChildSession(ctx, childSession).catch((error) => {
+                    ctx.logger.warn(`subagent-dsh: turn/end persistence failed: ${error instanceof Error ? error.message : String(error)}`);
+                });
+            });
         }
         return undefined;
     }, () => { });
     return Promise.resolve(subprocessRunHandle({
-        // A session-backed run's id is the child session id (the seam's local-run
-        // contract), so the tool's resume self-description names the same handle
-        // the delegation registry records.
-        id: spec.childSession?.id ?? SessionId(randomUUID()),
+        // Host 0.2.1: the published run id is a fresh PER-EXECUTION identity —
+        // the activation manager rejects a run id naming a live Session (the
+        // mirrored child session is exactly that), and resume rounds reuse the
+        // child session id. The durable child identity the family tracks rides
+        // the staged intent instead (spec.childSession.id == its childSessionId).
+        id: SessionId(randomUUID()),
         result,
         signal: request.signal,
         onAbort,

package/lib/types/index.d.ts

@@ -4,7 +4,7 @@
  * namespace (default off); while ON, the controller registers the `dsh`
  * harness into the core registry (scoped home under the shared homes root,
  * `$DSH_HOME`), the `dsh-cli` delegation provider (sub-dsh headless runs with
- * the parent's resolved DeepSeek key), and the family delegation tool for it.
+ * the parent's selected API-key model route), and the family delegation tool for it.
  * While OFF — the default — nothing model-visible mounts, so the instance
  * keeps exactly the current behavior (official in-process subagent tools) and
  * the model never sees two overlapping delegation tools at once.
@@ -42,6 +42,14 @@ export interface LocalAgentDshConfig {
     cliLaunch?: string[];
     /** Override the headless bundle directory the sub-profile symlinks to. */
     headlessBundleDir?: string;
+    /**
+     * The headless bundle directory as an evaluation unit (container round)
+     * sees it — the image's own install. Present, provisioning also writes a
+     * `<profileName>-unit` sub-profile linking it, and container rounds launch
+     * that one, while host rounds keep `headlessBundleDir` (default: this
+     * instance's own headless). Absent, both share one sub-profile.
+     */
+    unitHeadlessBundleDir?: string;
     /**
      * The sub-dsh's permission boundary: the sandbox mode every confined call
      * runs under, paired with the approval policy `dsh-base`'s own preset table