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

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

@@ -0,0 +1,37 @@
+/**
+ * The「本机 Agent 委派」family card: the core's single `plugins.item` entry on
+ * the Plugins page, replacing the four per-harness cards. Each delegation
+ * companion registers one section through the localAgentUi service's
+ * `registerHarnessCard`; the page view renders the sections in their retired
+ * standalone-card order, each under the collapsible chrome those cards used
+ * (header button with aria-expanded, the credential dot, a chevron), plus a
+ * grey「未检测到 CLI」tag when the harness's status probe answers without a
+ * cliVersion. Sections mount their bodies only while expanded, exactly like
+ * the standalone cards did.
+ * @module @khorsheed/dsh-local-agent/client — family card
+ */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { LocalAgentStatus } from '@khorsheed/dsh-local-agent/types';
+import type { HarnessCardRegistry } from './harness-cards.ts';
+import { NS } from './locales.ts';
+/** Injected face of the family card. */
+export interface FamilyCardInjected {
+    /** The registry the companions' sections live in (the localAgentUi service's registerHarnessCard writes here). */
+    readonly harnessCards: HarnessCardRegistry;
+    /**
+     * Per-harness status probe over the read-only gateway Remote. The Remote
+     * declares `status(name, scope?)` and the api-gateway client enforces exact
+     * arity, so the default scope is passed explicitly at the call site.
+     */
+    readonly harnessStatus: (name: string) => Promise<LocalAgentStatus | undefined>;
+}
+/** Full props of the family card entry (owner prop `view`). */
+export type LocalAgentFamilyCardProps = PropsRuntime<'plugins.item'> & InjectFace<FamilyCardInjected> & PropsLocale<typeof NS>;
+/**
+ * The family card entry: the one-liner for the `summary` view, the section
+ * stack for `page`.
+ * @param props - the owner view, the injected registry/status faces, and copy.
+ * @returns the entry.
+ */
+export declare function LocalAgentFamilyCard({ view, harnessCards, harnessStatus, useSessions, t }: LocalAgentFamilyCardProps): import("react").JSX.Element;
+//# sourceMappingURL=FamilyCard.d.ts.map

package/lib/types/client/FamilyCard.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The「本机 Agent 委派」family card: the core's single `plugins.item` entry on
+ * the Plugins page, replacing the four per-harness cards. Each delegation
+ * companion registers one section through the localAgentUi service's
+ * `registerHarnessCard`; the page view renders the sections in their retired
+ * standalone-card order, each under the collapsible chrome those cards used
+ * (header button with aria-expanded, the credential dot, a chevron), plus a
+ * grey「未检测到 CLI」tag when the harness's status probe answers without a
+ * cliVersion. Sections mount their bodies only while expanded, exactly like
+ * the standalone cards did.
+ * @module @khorsheed/dsh-local-agent/client — family card
+ */
+import { useMemo, useState, useSyncExternalStore } from 'react';
+import { AuthStatusDot } from './AuthStatusDot.js';
+import { useHarnessAuthStatus } from './auth-status.js';
+import { IconChevronDownOutlineMedium } from './icons.js';
+import css from './FamilyCard.module.css';
+/** One registered harness's collapsible section: the header row plus its body. */
+function HarnessSection({ entry, harnessStatus, useSessions, t }) {
+    const [open, setOpen] = useState(false);
+    // One mount probe feeds both the header dot and the CLI-missing tag: the
+    // wrapper keeps the answered payload (its effectiveSettings.cliVersion)
+    // while the bus hook publishes the kind the dot reads — the same single
+    // probe the retired standalone card headers ran.
+    const [answered, setAnswered] = useState(null);
+    const probe = useMemo(() => async (name) => {
+        const status = await harnessStatus(name);
+        setAnswered(status ?? undefined);
+        return status;
+    }, [harnessStatus]);
+    const authStatus = useHarnessAuthStatus(entry.name, probe);
+    const dotLabel = t(authStatus === 'authenticated' ? 'settings.authenticated'
+        : authStatus === 'anonymous' ? 'settings.notAuthenticated'
+            : authStatus === 'checking' ? 'loading' : 'error');
+    const label = entry.label();
+    // The tag fires only on an answered probe: an unanswered one (the harness
+    // is absent host-side) already reads as the dot's unavailable state, and
+    // "CLI not detected" would misreport it.
+    const cliMissing = answered !== null && answered !== undefined && answered.effectiveSettings?.cliVersion === undefined;
+    return (_jsxs("section", { className: open ? `${css.section} ${css.sectionOpen}` : css.section, children: [_jsxs("button", { type: "button", className: css.header, "aria-expanded": open, "aria-label": `${t(open ? 'family.collapse' : 'family.expand')}: ${label}`, onClick: () => { setOpen(!open); }, children: [_jsx("span", { className: css.headText, children: _jsxs("span", { className: css.nameRow, children: [_jsx("span", { className: css.name, children: label }), _jsx(AuthStatusDot, { status: authStatus, label: dotLabel }), cliMissing && _jsx("span", { className: css.cliMissing, children: t('family.cliMissing') })] }) }), _jsx(IconChevronDownOutlineMedium, { className: open ? `${css.chevron} ${css.chevronOpen}` : css.chevron })] }), open && entry.render({ active: true, useSessions })] }));
+}
+/**
+ * The family card entry: the one-liner for the `summary` view, the section
+ * stack for `page`.
+ * @param props - the owner view, the injected registry/status faces, and copy.
+ * @returns the entry.
+ */
+export function LocalAgentFamilyCard({ view, harnessCards, harnessStatus, useSessions, t }) {
+    useSyncExternalStore(harnessCards.subscribe, harnessCards.snapshotVersion);
+    const sections = harnessCards.cards();
+    if (view === 'summary')
+        return _jsx("span", { className: css.description, children: t('family.description') });
+    return (_jsxs("div", { className: css.sections, children: [sections.length === 0 && _jsx("span", { className: css.empty, children: t('family.empty') }), sections.map(entry => (_jsx(HarnessSection, { entry: entry, harnessStatus: harnessStatus, useSessions: useSessions, t: t }, entry.name)))] }));
+}

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

@@ -8,10 +8,30 @@ export interface HarnessModelPickerProps {
     face: ModelDirectoryFace;
     value: string;
     onChange(value: string): void;
+    /**
+     * Present = the menu also offers the model's reasoning-effort row
+     * ('' = follow the harness default). Absent = the picker stays model-only
+     * (settings cards' behavior).
+     */
+    effort?: {
+        value: string;
+        onChange(value: string): void;
+    } | undefined;
     disabled?: boolean | undefined;
     defaultLabel?: string | undefined;
+    /**
+     * Present = render as form fields (a labelled model select, plus an effort
+     * select when `effort` is present) in the host form's own classes, instead
+     * of the drill-down menu — for a dialog whose other fields are selects.
+     */
+    fields?: {
+        field?: string | undefined;
+        label?: string | undefined;
+        select?: string | undefined;
+        row?: string | undefined;
+    } | undefined;
     t: ConfigurationTranslate;
 }
 /** Discover while expanded or resolving an empty choice; settings remain caller-owned drafts. */
-export declare function HarnessModelPicker({ face, value, onChange, disabled, t }: HarnessModelPickerProps): import("react").JSX.Element;
+export declare function HarnessModelPicker({ face, value, onChange, effort, disabled, fields, t }: HarnessModelPickerProps): import("react").JSX.Element;
 //# sourceMappingURL=HarnessModelPicker.d.ts.map

package/lib/types/client/HarnessModelPicker.js

@@ -4,9 +4,11 @@ import { ModelConfigurationFields } from './ModelConfigurationFields.js';
 import css from './MemberConfiguration.module.css';
 import { useConfigurationMenu } from './use-configuration-menu.js';
 /** Discover while expanded or resolving an empty choice; settings remain caller-owned drafts. */
-export function HarnessModelPicker({ face, value, onChange, disabled, t }) {
+export function HarnessModelPicker({ face, value, onChange, effort, disabled, fields, t }) {
     const menu = useConfigurationMenu('below');
-    const { open, setOpen } = menu;
+    const { setOpen } = menu;
+    // Form fields show the directory all the time: discovery runs as if open.
+    const open = menu.open || fields !== undefined;
     const [surface, setSurface] = useState();
     const directory = surface?.face === face ? surface.directory : undefined;
     const currentFace = useRef(face);
@@ -44,5 +46,31 @@ export function HarnessModelPicker({ face, value, onChange, disabled, t }) {
             onChange(first.value);
     }, [directory, value, disabled, onChange]);
     const entry = directory?.entries.find(entry => entry.value === value);
-    return _jsxs("details", { ref: menu.root, className: `${css.root} ${css.settings}`, open: open, onToggle: event => setOpen(event.currentTarget.open), children: [_jsx("summary", { "aria-label": t('configuration.model'), "aria-expanded": open, children: _jsx("span", { className: css.triggerLabel, children: entry?.label ?? (value || t('configuration.choose')) }) }), open && _jsxs("div", { ref: menu.panel, className: css.panel, style: menu.style, children: [error && _jsx("div", { role: "alert", children: error }), !directory && _jsx("span", { role: "status", children: t('loading') }), _jsx(ModelConfigurationFields, { directory: directory, value: { model: value ? { mode: 'value', value } : { mode: 'default' }, effort: { mode: 'default' } }, onChange: selection => { onChange(selection.model.mode === 'value' ? selection.model.value : ''); setOpen(false); }, showEffort: false, disabled: disabled, t: t })] })] });
+    if (fields !== undefined)
+        return _jsx(ModelSelects, { directory: directory, error: error, value: value, onChange: onChange, effort: effort, disabled: disabled, classes: fields, t: t });
+    return _jsxs("details", { ref: menu.root, className: `${css.root} ${css.settings}`, open: open, onToggle: event => setOpen(event.currentTarget.open), children: [_jsx("summary", { "aria-label": t('configuration.model'), "aria-expanded": open, children: _jsx("span", { className: css.triggerLabel, children: entry?.label ?? (value || t('configuration.choose')) }) }), open && _jsxs("div", { ref: menu.panel, className: css.panel, style: menu.style, children: [error && _jsx("div", { role: "alert", children: error }), !directory && _jsx("span", { role: "status", children: t('loading') }), _jsx(ModelConfigurationFields, { directory: directory, value: { model: value ? { mode: 'value', value } : { mode: 'default' }, effort: effort !== undefined && effort.value !== '' ? { mode: 'value', value: effort.value } : { mode: 'default' } }, onChange: selection => {
+                            onChange(selection.model.mode === 'value' ? selection.model.value : '');
+                            effort?.onChange(selection.effort.mode === 'value' ? selection.effort.value : '');
+                            // The effort-capable menu navigates between panes instead of
+                            // closing on a pick (the MemberConfiguration card's behavior).
+                            if (effort === undefined)
+                                setOpen(false);
+                        }, showEffort: effort !== undefined, disabled: disabled, t: t })] })] });
+}
+/** The form-field face: a model select and, when asked, the model's effort select ('' = the model's default). */
+function ModelSelects({ directory, error, value, onChange, effort, disabled, classes, t }) {
+    const entries = directory?.entries ?? [];
+    // The chosen model stays listed even when the directory hides it.
+    const shown = entries.filter(entry => !entry.hidden || entry.value === value);
+    const reasoning = entries.find(entry => entry.value === value)?.reasoning;
+    const options = reasoning?.options ?? [];
+    const defaultEffort = options.find(option => option.value === reasoning?.default)?.label ?? reasoning?.default;
+    const pickModel = (next) => {
+        onChange(next);
+        // An effort the next model does not offer falls back to its default.
+        const nextOptions = entries.find(entry => entry.value === next)?.reasoning?.options ?? [];
+        if (effort !== undefined && effort.value !== '' && !nextOptions.some(option => option.value === effort.value))
+            effort.onChange('');
+    };
+    return _jsxs("div", { className: classes.row, children: [_jsxs("label", { className: classes.field, children: [_jsx("span", { className: classes.label, children: t('configuration.model') }), _jsxs("select", { className: classes.select, "aria-label": t('configuration.model'), value: value, disabled: disabled || directory === undefined, onChange: event => { pickModel(event.target.value); }, children: [directory === undefined && _jsx("option", { value: value, children: value || t('loading') }), directory !== undefined && value === '' && _jsx("option", { value: "", children: t('configuration.choose') }), directory !== undefined && value !== '' && !shown.some(entry => entry.value === value) && _jsx("option", { value: value, children: value }), shown.map(entry => _jsx("option", { value: entry.value, children: entry.label }, entry.value))] }), error !== undefined && _jsx("span", { role: "alert", children: error })] }), effort !== undefined && _jsxs("label", { className: classes.field, children: [_jsx("span", { className: classes.label, children: t('configuration.effort') }), _jsxs("select", { className: classes.select, "aria-label": t('configuration.effort'), value: effort.value, disabled: disabled || options.length === 0, onChange: event => { effort.onChange(event.target.value); }, children: [_jsx("option", { value: "", children: defaultEffort === undefined ? t('configuration.effortDefault') : `${t('configuration.effortDefault')}（${defaultEffort}）` }), options.map(option => _jsx("option", { value: option.value, children: option.label }, option.value))] })] })] });
 }

package/lib/types/client/MemberLiveNode.js

@@ -1,7 +1,9 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /** Generation-time text rendered through the public Markdown component. */
-import { useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';
-import { MarkdownText } from '@deepseek-ai/dsh-client-ui-primitives';
+import { useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react';
+import { DisclosureRow, MarkdownText, TextShimmer } from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconThinkOutlineRegular } from './icons.js';
+import css from './MemberLiveOutput.module.css';
 export function MemberLiveNode({ node, outputs, t }) {
     const data = node.data;
     const store = outputs.get(data.sessionId);
@@ -20,6 +22,35 @@ export function MemberLiveOutputView({ sessionId, startedAt, outputs, t }) {
  * The wall-clock subtraction is meaningful only when browser and host share a clock.
  * Keep independent callbacks across updates so slow paints cannot disappear from P95.
  */
+/** The latest completed paragraph's first line — the host think row's running summary. */
+function latestParagraphLine(text) {
+    let summary = '';
+    let start = 0;
+    const separator = /\r?\n(?:[\t ]*\r?\n)+/g;
+    while (true) {
+        const next = separator.exec(text);
+        const end = next === null ? text.length : next.index + next[0].indexOf('\n');
+        const newline = text.indexOf('\n', start);
+        if (newline !== -1 && newline <= end) {
+            const candidate = text.slice(start, newline).trim();
+            if (candidate !== '')
+                summary = candidate;
+        }
+        if (next === null)
+            return summary;
+        start = next.index + next[0].length;
+    }
+}
+/**
+ * A streaming think block drawn as the host's own think row: collapsed to one
+ * line (icon, title, the latest paragraph's first line shimmering), the full
+ * text on expand — the same row the settled message shows once it lands.
+ */
+function LiveReasoning({ text, labels, title }) {
+    const [open, setOpen] = useState(false);
+    const summary = useMemo(() => (latestParagraphLine(text) || text.split('\n', 1)[0] || '').replaceAll('**', ''), [text]);
+    return (_jsx(DisclosureRow, { rowClassName: css.thinkRow, leadingClassName: css.leading, titleClassName: css.title, icon: _jsx(IconThinkOutlineRegular, { size: 14 }), title: title, running: true, open: open, expandable: true, expandOnRowClick: true, onToggle: () => { setOpen(value => !value); }, collapsedContent: open || summary === '' ? undefined : _jsxs(_Fragment, { children: [_jsx("span", { className: css.separator, "aria-hidden": true }), _jsx("span", { className: css.summary, children: _jsx(TextShimmer, { children: summary }) })] }), children: open ? _jsx("div", { className: css.thinkBody, children: _jsx(MarkdownText, { text: text, labels: labels }) }) : undefined }));
+}
 function StreamText({ id, kind, text, receivedAt, recovering, sessionId, turn, revision, baseline, surface, diagnostics, t }) {
     const element = useRef(null);
     const samples = useRef([]);
@@ -70,5 +101,8 @@ function StreamText({ id, kind, text, receivedAt, recovering, sessionId, turn, r
         });
         frames.current.add(first);
     }, [receivedAt, revision, baseline, diagnostics, sessionId, turn, surface]);
-    return _jsxs("section", { ref: element, "data-member-live": id, "data-live-received-at": receivedAt, children: [_jsxs("small", { children: [kind === 'think' ? t('stream.thinking') : t('stream.writing'), recovering ? ` · ${t('stream.recovering')}` : ''] }), _jsx(MarkdownText, { text: text, labels: { code: { copyLabel: t('stream.copy'), copiedLabel: t('stream.copied') }, footnotes: t('stream.footnotes') } })] });
+    const labels = { code: { copyLabel: t('stream.copy'), copiedLabel: t('stream.copied') }, footnotes: t('stream.footnotes') };
+    return _jsxs("section", { ref: element, className: css.item, "data-member-live": id, "data-live-received-at": receivedAt, children: [kind === 'think'
+                ? _jsx(LiveReasoning, { text: text, labels: labels, title: t('stream.thinking') })
+                : _jsx("div", { className: css.text, children: _jsx(MarkdownText, { text: text, labels: labels }) }), recovering && _jsx("span", { className: css.recovering, children: t('stream.recovering') })] });
 }

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

@@ -0,0 +1,49 @@
+/**
+ * The family's shared「可用模型」section: an ORDERED shortlist of
+ * endpoint-served models — the first entry is the default model every
+ * delegation round starts with. Rows drag to reorder and delete per row;
+ * "add model" opens a dialog over the endpoint's served catalog (search +
+ * checkboxes), so the list can only ever contain what the endpoint actually
+ * serves. An empty list falls back to the pre-list chain (the settings
+ * model key, the scoped config file, then the CLI's own default). Every
+ * edit persists immediately through the harness's model-list face (the
+ * gateway's `modelList`/`configureModelList` Remotes).
+ *
+ * One implementation serves every companion card (claude-code, codex,
+ * kimi): the section owns its state (list read on activate, immediate
+ * writes, the catalog read behind the add dialog) so each card's
+ * integration is the two faces plus copy — the interaction cannot drift
+ * between harnesses. Copy lives in the family core's own dictionary.
+ * @module @khorsheed/dsh-local-agent/client — model list section
+ */
+import type { LocalAgentModelDirectory } from '@khorsheed/dsh-local-agent/types';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from './locales.ts';
+/** The harness's curated-list face the section edits through. */
+export interface ModelListSectionListFace {
+    /** Read the current ordered list (absent/malformed reads as empty). */
+    read(): Promise<readonly string[] | null | undefined>;
+    /** Persist a new ordered list; the answer replaces the section's state. */
+    write(models: readonly string[]): Promise<readonly string[] | null | undefined>;
+}
+/** Full props of the shared model-list section. */
+export interface ModelListSectionProps extends PropsLocale<typeof NS> {
+    /** Whether the section's surface is currently visible (gates the reads — a collapsed card never fetches). */
+    readonly active: boolean;
+    /** The harness's curated-list face; absent hides the editor (a core predating the Remotes). */
+    readonly modelList?: ModelListSectionListFace | undefined;
+    /** The endpoint's served catalog read — the add dialog's candidate vocabulary. */
+    readonly modelDirectory?: ((refresh?: boolean) => Promise<LocalAgentModelDirectory | null | undefined>) | undefined;
+    /** Re-read the catalog whenever this value changes (a credential save: a fresh credential's models belong in the dialog now). */
+    readonly directoryRefresh?: unknown;
+}
+/**
+ * The「可用模型」section every companion's settings card renders: the block
+ * chrome (title + ⓘ bubble), the editor, and the save verdict. Reads fire
+ * only while `active`; a missing list face renders the header without the
+ * editor (declare-and-degrade).
+ * @param props - the faces, the activity gate, and copy.
+ * @returns the section.
+ */
+export declare function ModelListSection({ active, modelList, modelDirectory, directoryRefresh, t }: ModelListSectionProps): import("react").JSX.Element;
+//# sourceMappingURL=ModelListSection.d.ts.map

package/lib/types/client/ModelListSection.js

@@ -0,0 +1,132 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The family's shared「可用模型」section: an ORDERED shortlist of
+ * endpoint-served models — the first entry is the default model every
+ * delegation round starts with. Rows drag to reorder and delete per row;
+ * "add model" opens a dialog over the endpoint's served catalog (search +
+ * checkboxes), so the list can only ever contain what the endpoint actually
+ * serves. An empty list falls back to the pre-list chain (the settings
+ * model key, the scoped config file, then the CLI's own default). Every
+ * edit persists immediately through the harness's model-list face (the
+ * gateway's `modelList`/`configureModelList` Remotes).
+ *
+ * One implementation serves every companion card (claude-code, codex,
+ * kimi): the section owns its state (list read on activate, immediate
+ * writes, the catalog read behind the add dialog) so each card's
+ * integration is the two faces plus copy — the interaction cannot drift
+ * between harnesses. Copy lives in the family core's own dictionary.
+ * @module @khorsheed/dsh-local-agent/client — model list section
+ */
+import { useEffect, useMemo, useState } from 'react';
+import { Tooltip } from '@deepseek-ai/dsh-client-ui-primitives';
+import css from './ModelListSection.module.css';
+/** The section's staged state: the list and the catalog behind the add dialog. */
+function useModelListState(active, modelList, modelDirectory, directoryRefresh) {
+    const unavailable = modelList === undefined;
+    const [models, setModels] = useState([]);
+    const [saved, setSaved] = useState(false);
+    const [error, setError] = useState(false);
+    useEffect(() => {
+        if (!active || modelList === undefined)
+            return;
+        let stale = false;
+        void modelList.read().then((list) => { if (!stale)
+            setModels(list ?? []); }, () => { if (!stale)
+            setModels([]); });
+        return () => { stale = true; };
+    }, [active, modelList]);
+    // The endpoint's served catalog: the add dialog's candidate vocabulary.
+    // Refreshed while the surface is active and whenever directoryRefresh
+    // moves (a fresh credential's models belong in the dialog now).
+    const [directory, setDirectory] = useState(null);
+    useEffect(() => {
+        if (!active || modelDirectory === undefined)
+            return;
+        let stale = false;
+        void modelDirectory(true).then((result) => { if (!stale)
+            setDirectory(result ?? null); }, () => { if (!stale)
+            setDirectory(null); });
+        return () => { stale = true; };
+    }, [active, modelDirectory, directoryRefresh]);
+    const saveModels = (next) => {
+        if (modelList === undefined)
+            return;
+        setSaved(false);
+        setError(false);
+        void modelList.write(next).then((written) => {
+            setModels(written ?? next);
+            setSaved(true);
+        }, () => { setError(true); });
+    };
+    return { models, unavailable, saved, error, directory, saveModels };
+}
+/** The add dialog: search + checkboxes over the endpoint's served catalog. */
+function AddModelsDialog({ models, directory, onAdd, onClose, t }) {
+    const [query, setQuery] = useState('');
+    const [checked, setChecked] = useState(new Set());
+    const candidates = useMemo(() => {
+        const entries = directory?.entries ?? [];
+        const needle = query.trim().toLowerCase();
+        return entries
+            .filter(entry => needle === '' || entry.value.toLowerCase().includes(needle) || entry.label.toLowerCase().includes(needle))
+            .map(entry => ({ ...entry, added: models.includes(entry.value) }));
+    }, [directory, query, models]);
+    const selectable = candidates.filter(entry => !entry.added);
+    const allChecked = selectable.length > 0 && selectable.every(entry => checked.has(entry.value));
+    const toggleAll = () => {
+        setChecked(allChecked ? new Set() : new Set(selectable.map(entry => entry.value)));
+    };
+    const toggle = (value) => {
+        setChecked(prev => {
+            const next = new Set(prev);
+            if (next.has(value))
+                next.delete(value);
+            else
+                next.add(value);
+            return next;
+        });
+    };
+    return (_jsx("div", { className: css.dialogBackdrop, role: "presentation", onClick: () => { onClose(); }, children: _jsxs("div", { className: css.dialog, role: "dialog", "aria-label": t('models.dialog.title'), onClick: event => { event.stopPropagation(); }, children: [_jsxs("div", { className: css.dialogHead, children: [_jsx("h4", { className: css.dialogTitle, children: t('models.dialog.title') }), _jsx("button", { type: "button", className: css.dialogClose, "aria-label": t('models.dialog.cancel'), onClick: () => { onClose(); }, children: "\u2715" })] }), _jsx("p", { className: css.dialogHint, children: t('models.dialog.hint') }), _jsxs("div", { className: css.dialogToolbar, children: [_jsx("input", { type: "text", className: css.modelInput, value: query, placeholder: t('models.dialog.search'), "aria-label": t('models.dialog.search'), onChange: event => { setQuery(event.currentTarget.value); } }), _jsx("button", { type: "button", className: css.dialogSelectAll, disabled: selectable.length === 0, onClick: () => { toggleAll(); }, children: t('models.dialog.selectAll') })] }), _jsxs("div", { className: css.dialogList, children: [directory === null && _jsx("span", { className: css.hint, children: t('models.dialog.loading') }), directory !== null && directory.entries.length === 0 && (_jsx("span", { className: css.hint, children: directory.reason ?? t('models.dialog.empty') })), candidates.map(entry => (_jsxs("label", { className: entry.added ? `${css.dialogItem} ${css.dialogItemAdded}` : css.dialogItem, children: [_jsx("input", { type: "checkbox", checked: entry.added || checked.has(entry.value), disabled: entry.added, onChange: () => { toggle(entry.value); } }), _jsx("span", { className: css.dialogItemValue, children: entry.value }), entry.label !== entry.value && _jsx("span", { className: css.dialogItemLabel, children: entry.label })] }, entry.value)))] }), _jsxs("div", { className: css.dialogActions, children: [_jsx("button", { type: "button", className: css.modelSave, onClick: () => { onClose(); }, children: t('models.dialog.cancel') }), _jsx("button", { type: "button", className: css.dialogConfirm, disabled: checked.size === 0, onClick: () => { onAdd([...checked]); }, children: t('models.dialog.confirm') })] })] }) }));
+}
+/**
+ * The editor body: the ordered rows, the per-row delete, and the add button.
+ * Reorders persist on drop — every gesture writes immediately.
+ */
+function ModelListEditor({ models, directory, onChange, t }) {
+    const [dialogOpen, setDialogOpen] = useState(false);
+    const [dragIndex, setDragIndex] = useState(null);
+    const move = (from, to) => {
+        if (from === to)
+            return;
+        const item = models[from];
+        if (item === undefined)
+            return;
+        const next = [...models];
+        next.splice(from, 1);
+        next.splice(to, 0, item);
+        onChange(next);
+    };
+    return (_jsxs("div", { className: css.modelList, children: [models.length === 0 && _jsx("span", { className: css.hint, children: t('models.empty') }), models.map((model, index) => {
+                const entry = directory?.entries.find(candidate => candidate.value === model);
+                return (_jsxs("div", { className: dragIndex === index ? `${css.modelRow} ${css.modelRowDragging}` : css.modelRow, draggable: true, onDragStart: () => { setDragIndex(index); }, onDragOver: event => { event.preventDefault(); }, onDrop: () => {
+                        if (dragIndex !== null)
+                            move(dragIndex, index);
+                        setDragIndex(null);
+                    }, onDragEnd: () => { setDragIndex(null); }, children: [_jsx("span", { className: css.modelDrag, "aria-hidden": true, children: "\u283F" }), _jsx("span", { className: css.modelRowValue, children: model }), entry !== undefined && entry.label !== model && _jsx("span", { className: css.modelRowLabel, children: entry.label }), index === 0 && _jsx("span", { className: css.modelDefaultChip, children: t('models.defaultChip') }), _jsx("button", { type: "button", className: css.modelDelete, "aria-label": `${t('models.delete')}: ${model}`, onClick: () => { onChange(models.filter((_, other) => other !== index)); }, children: "\u2715" })] }, model));
+            }), _jsxs("div", { className: css.row, children: [_jsx("button", { type: "button", className: css.modelAdd, onClick: () => { setDialogOpen(true); }, children: t('models.add') }), models.length > 1 && _jsx("span", { className: css.hint, children: t('models.orderHint') })] }), dialogOpen && (_jsx(AddModelsDialog, { models: models, directory: directory, onAdd: (added) => {
+                    onChange([...models, ...added]);
+                    setDialogOpen(false);
+                }, onClose: () => { setDialogOpen(false); }, t: t }))] }));
+}
+/**
+ * The「可用模型」section every companion's settings card renders: the block
+ * chrome (title + ⓘ bubble), the editor, and the save verdict. Reads fire
+ * only while `active`; a missing list face renders the header without the
+ * editor (declare-and-degrade).
+ * @param props - the faces, the activity gate, and copy.
+ * @returns the section.
+ */
+export function ModelListSection({ active, modelList, modelDirectory, directoryRefresh, t }) {
+    const { models, unavailable, saved, error, directory, saveModels } = useModelListState(active, modelList, modelDirectory, directoryRefresh);
+    return (_jsxs("section", { className: css.block, children: [_jsxs("h3", { className: css.blockTitle, children: [t('models.title'), _jsx(Tooltip, { label: t('models.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('models.info.aria'), children: "\u24D8" }) })] }), !unavailable && (_jsxs(_Fragment, { children: [_jsx(ModelListEditor, { models: models, directory: directory, onChange: saveModels, t: t }), saved && _jsx("span", { className: css.saved, children: t('models.applied') }), error && _jsx("span", { className: css.errorText, children: t('models.error') })] }))] }));
+}

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

@@ -13,6 +13,14 @@ export declare const LOGIN_POLL_MS = 4000;
 export declare const LOGIN_POLL_LIMIT_MS: number;
 /** The first http(s) URL in a login prompt, if any. */
 export declare function parseLoginUrl(text: string): string | undefined;
+/**
+ * The main-view session: host 0.1.6-alpha.2 dropped SessionListState.current
+ * for the retainedBy.mainView count on each summary (the label is ui-session's
+ * declaration merge, read here as a plain duck-typed count so this package
+ * needs no ui-session edge), with the legacy field as the older-host fallback.
+ * Exported for sibling cards that run slash commands from their own rows.
+ */
+export declare const mainSessionId: (list: SessionListState) => SessionId | undefined;
 /**
  * Injected business face of the shared auth block — the subset of the
  * settings section's injected face one harness row consumes.
@@ -43,8 +51,8 @@ export interface ProviderAuthBlockProps extends ProviderAuthInjected, PropsLocal
 }
 /**
  * One harness's auth interactions, shared between the per-provider settings
- * cards (the alpha.2 `plugins.bundle.config` pages and the 0.1.5
- * `settings.plugin.item` tab): auth status through
+ * cards (each a `plugins.item` entry on the Plugins page, registered while
+ * the Host serves the provider's namespace): auth status through
  * the read-only Remote channel and a web-login action that runs
  * `/<harness> login`, surfaces the device-code prompt, and offers a link to
  * the authorization page. The login command returns at prompt time while the

package/lib/types/client/ProviderAuthBlock.js

@@ -2,7 +2,7 @@ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-run
 import { useEffect, useRef, useState } from 'react';
 import { Toast } from '@deepseek-ai/dsh-client-ui-primitives';
 import { IconCheckOutlineMedium } from './icons.js';
-import { publishAuthStatus } from './auth-status.js';
+import { publishAuthStatus, usePublishedAuthStatus } from './auth-status.js';
 import css from './ProviderAuthBlock.module.css';
 /** Known harnesses the family plans to support; unregistered ones render as pending. */
 export const KNOWN_HARNESSES = [
@@ -27,13 +27,14 @@ function harnessLabel(id) {
  * for the retainedBy.mainView count on each summary (the label is ui-session's
  * declaration merge, read here as a plain duck-typed count so this package
  * needs no ui-session edge), with the legacy field as the older-host fallback.
+ * Exported for sibling cards that run slash commands from their own rows.
  */
-const mainSessionId = (list) => Object.values(list.byId ?? {}).find(session => (session.retainedBy?.mainView ?? 0) > 0)?.id
+export const mainSessionId = (list) => Object.values(list.byId ?? {}).find(session => (session.retainedBy?.mainView ?? 0) > 0)?.id
     ?? list.current;
 /**
  * One harness's auth interactions, shared between the per-provider settings
- * cards (the alpha.2 `plugins.bundle.config` pages and the 0.1.5
- * `settings.plugin.item` tab): auth status through
+ * cards (each a `plugins.item` entry on the Plugins page, registered while
+ * the Host serves the provider's namespace): auth status through
  * the read-only Remote channel and a web-login action that runs
  * `/<harness> login`, surfaces the device-code prompt, and offers a link to
  * the authorization page. The login command returns at prompt time while the
@@ -69,6 +70,7 @@ export function ProviderAuthBlock({ harness, useSessions, status, runCommand, ac
                     loginable: probe.loginable ?? true,
                     logoutable: probe.logoutable ?? true,
                     ...probe.loginAwaitingCode === true ? { loginAwaitingCode: true } : {},
+                    ...probe.effectiveSettings?.cliVersion === undefined ? {} : { cliVersion: probe.effectiveSettings.cliVersion },
                 };
             setView(prev => 
             // A completed login drops the stale device prompt.
@@ -138,7 +140,12 @@ export function ProviderAuthBlock({ harness, useSessions, status, runCommand, ac
             setView({ status: 'unavailable' });
         });
     };
-    const statusKind = view.status;
+    // The bus carries the same harness's status from every writer: this
+    // block's own probes publish into it, and so does a sibling surface that
+    // WRITES the credential (the endpoint form's save). Following it keeps the
+    // row truthful without a re-probe; undefined until the first probe lands.
+    const published = usePublishedAuthStatus(harness.id);
+    const statusKind = published ?? view.status;
     const authenticated = statusKind === 'authenticated';
     const loginPending = pendingSince !== undefined;
     // A harness without a login/logout flow (dsh authenticates through the host
@@ -146,7 +153,7 @@ export function ProviderAuthBlock({ harness, useSessions, status, runCommand, ac
     // with an error.
     const loginable = view.loginable ?? true;
     const logoutable = view.logoutable ?? true;
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.rowHead, children: [_jsxs("span", { className: css.rowIdentity, children: [_jsx("span", { className: css.rowName, children: harness.label }), _jsx("span", { className: `${css.credentialDot} ${authenticated ? css.dotOn : css.dotOff}`, role: "img", "aria-label": t(authenticated ? 'settings.authenticated' : 'settings.notAuthenticated') }), _jsx("span", { className: css.rowTag, children: harness.id })] }), _jsxs("span", { className: css.status, children: [statusKind === 'checking' && t('loading'), statusKind === 'authenticated' && t('settings.authenticated'), statusKind === 'anonymous' && t('settings.notAuthenticated'), statusKind === 'unavailable' && t('error')] }), _jsxs("span", { className: css.rowActions, children: [authenticated && logoutable && (_jsx("button", { type: "button", className: css.logoutButton, onClick: () => { signOut(); }, children: t('settings.logout') })), loginable && (_jsx("button", { type: "button", className: css.loginButton, disabled: loginPending || sessionId === undefined, onClick: () => { startLogin(); }, children: authenticated ? t('settings.reauthorize') : t('settings.login') })), actions] })] }), view.loginText !== undefined && (_jsxs("div", { className: css.loginPrompt, children: [_jsx("span", { className: css.promptText, children: view.loginText }), view.loginUrl !== undefined && (_jsx("a", { className: css.openPage, href: view.loginUrl, target: "_blank", rel: "noreferrer", children: t('settings.openPage') }))] })), view.loginAwaitingCode === true && (_jsxs("div", { className: css.loginPrompt, children: [_jsx("input", { className: css.codeInput, value: codeDraft, placeholder: t('settings.pasteCode'), onChange: (event) => {
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: css.rowHead, children: [_jsxs("span", { className: css.rowIdentity, children: [_jsx("span", { className: css.rowName, children: harness.label }), _jsx("span", { className: `${css.credentialDot} ${authenticated ? css.dotOn : css.dotOff}`, role: "img", "aria-label": t(authenticated ? 'settings.authenticated' : 'settings.notAuthenticated') }), _jsx("span", { className: css.rowTag, children: harness.id }), view.cliVersion !== undefined && _jsx("span", { className: css.rowTag, children: view.cliVersion })] }), _jsxs("span", { className: css.status, children: [statusKind === 'checking' && t('loading'), statusKind === 'authenticated' && t('settings.authenticated'), statusKind === 'anonymous' && t('settings.notAuthenticated'), statusKind === 'unavailable' && t('error')] }), _jsxs("span", { className: css.rowActions, children: [authenticated && logoutable && (_jsx("button", { type: "button", className: css.logoutButton, onClick: () => { signOut(); }, children: t('settings.logout') })), loginable && (_jsx("button", { type: "button", className: css.loginButton, disabled: loginPending || sessionId === undefined, onClick: () => { startLogin(); }, children: authenticated ? t('settings.reauthorize') : t('settings.login') })), actions] })] }), view.loginText !== undefined && (_jsxs("div", { className: css.loginPrompt, children: [_jsx("span", { className: css.promptText, children: view.loginText }), view.loginUrl !== undefined && (_jsx("a", { className: css.openPage, href: view.loginUrl, target: "_blank", rel: "noreferrer", children: t('settings.openPage') }))] })), view.loginAwaitingCode === true && (_jsxs("div", { className: css.loginPrompt, children: [_jsx("input", { className: css.codeInput, value: codeDraft, placeholder: t('settings.pasteCode'), onChange: (event) => {
                             setCodeDraft(event.currentTarget.value);
                         } }), _jsx("button", { type: "button", className: css.loginButton, disabled: codeDraft.trim() === '', onClick: () => {
                             const code = codeDraft.trim();

package/lib/types/client/auth-status.d.ts

@@ -15,6 +15,12 @@ export declare function publishAuthStatus(harnessId: string, status: HarnessAuth
 export declare function resetAuthStatuses(): void;
 /** Read one harness's latest published status without subscribing (tests, non-React callers). */
 export declare function readAuthStatus(harnessId: string): HarnessAuthStatusKind | undefined;
+/**
+ * Subscribe one harness's published status (no probe of its own): a sibling
+ * surface that WRITES the credential (the endpoint form's save) publishes
+ * through the same bus, and every block showing the status flips at once.
+ */
+export declare function usePublishedAuthStatus(harnessId: string): HarnessAuthStatusKind | undefined;
 /**
  * Read one harness's latest known auth status. Every mount probes once and
  * publishes — a published value only snapshots the past (a credential expiring

package/lib/types/client/auth-status.js

@@ -29,6 +29,14 @@ export function resetAuthStatuses() {
 export function readAuthStatus(harnessId) {
     return statuses.get(harnessId);
 }
+/**
+ * Subscribe one harness's published status (no probe of its own): a sibling
+ * surface that WRITES the credential (the endpoint form's save) publishes
+ * through the same bus, and every block showing the status flips at once.
+ */
+export function usePublishedAuthStatus(harnessId) {
+    return useSyncExternalStore(subscribe, () => statuses.get(harnessId));
+}
 /**
  * Read one harness's latest known auth status. Every mount probes once and
  * publishes — a published value only snapshots the past (a credential expiring

package/lib/types/client/harness-cards.d.ts

@@ -0,0 +1,72 @@
+/**
+ * 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
+ */
+import type { ReactNode } from 'react';
+import type { SessionListState } from '@deepseek-ai/dsh-api-session-controller/client';
+/** Render props the family card hands each harness section. */
+export interface HarnessCardRenderProps {
+    /**
+     * Whether the section is currently expanded. The family card requests the
+     * body only while the section is open, so a mounted section always reads
+     * true; the prop keeps the contract honest for a keep-alive variant.
+     */
+    readonly active: boolean;
+    /**
+     * The standing root-scope global seat (ui-session's GlobalStandardProps
+     * merge), forwarded verbatim from the family card's own plugins.item
+     * runtime props — the same seat the retired standalone cards received from
+     * the slot renderer.
+     */
+    readonly useSessions: <T>(select: (state: SessionListState) => T) => T;
+}
+/** One harness's section registration in the family card. */
+export interface HarnessCardRegistration {
+    /** The harness name the gateway answers for ('kimi', 'codex', …). */
+    readonly name: string;
+    /** Section order — the harness's retired standalone plugins.item order. */
+    readonly order: number;
+    /** The registering companion's locale namespace (mirrors the slot registration vocabulary; the label binding reads it live). */
+    readonly locale: string;
+    /** Section title (the companion's `card.title` copy). */
+    readonly label: () => string;
+    /** The section body (the companion's card body minus its standalone chrome). */
+    readonly render: (props: HarnessCardRenderProps) => ReactNode;
+}
+/**
+ * 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 declare class HarnessCardRegistry {
+    private readonly entries;
+    private readonly listeners;
+    private version;
+    private 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.
+     */
+    readonly register: (entry: HarnessCardRegistration) => (() => void);
+    /** The registered sections in display order (order, then name). */
+    readonly cards: () => readonly HarnessCardRegistration[];
+    /** The mutation counter — the useSyncExternalStore snapshot. */
+    readonly snapshotVersion: () => number;
+    /** Subscribe a listener fired after every mutation; returns the unsubscribe. */
+    readonly subscribe: (listener: () => void) => (() => void);
+    private bump;
+}
+//# sourceMappingURL=harness-cards.d.ts.map