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

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

@@ -1,9 +1,7 @@
-import type { HarnessModelPickerInput } from '@khorsheed/dsh-local-agent/client';
-import type { ReactNode } from 'react';
 import type { SettingsScope } from '@khorsheed/dsh-local-agent/src/client/settings-scope.ts';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import { type ProviderAuthBlockProps, type ProviderAuthInjected } from '@khorsheed/dsh-local-agent/src/client/ProviderAuthBlock.tsx';
-import type { LocalAgentModelInfo } from '@khorsheed/dsh-local-agent/types';
+import type { LocalAgentEndpointAuthFields, LocalAgentEndpointAuthState, LocalAgentModelDirectory } from '@khorsheed/dsh-local-agent/types';
 import { NS } from './locales.ts';
 /** The `local-agent-codex` settings namespace section the card edits. */
 export interface CodexLiveSettings {
@@ -20,7 +18,6 @@ export interface CodexLiveSettings {
 }
 /** Injected face of the codex settings card. */
 export interface CodexSettingsCardInjected {
-    renderModelPicker?: ((props: HarnessModelPickerInput) => ReactNode) | undefined;
     /** Bound settings scope for the local-agent-codex namespace. */
     scope: SettingsScope<CodexLiveSettings>;
     /** The auth block's query/command faces, backed by the family core Remote. */
@@ -28,34 +25,77 @@ export interface CodexSettingsCardInjected {
     /** Translate bound to the family core's `local-agent` namespace (the auth block's copy lives there). */
     authT: ProviderAuthBlockProps['t'];
     /**
-     * The harness's memberless model surface (the core gateway's `harnessModel`
-     * Remote): the inherited default an unset field displays and the menu's
-     * choice vocabulary. Undefined or null when the gateway or the broker is
-     * absent — the card then keeps the bare input exactly as before brokers
-     * existed.
+     * The harness's curated model list (the family gateway's
+     * `modelList`/`configureModelList` Remotes): the editor's ordered
+     * shortlist — its first entry is the default model. Absent on a core that
+     * predates the Remotes — the card then hides the editor.
      */
-    harnessModel: () => Promise<LocalAgentModelInfo | null | undefined>;
+    modelList?: {
+        read(): Promise<readonly string[] | null | undefined>;
+        write(models: readonly string[]): Promise<readonly string[] | null | undefined>;
+    };
+    /**
+     * The endpoint's served model catalog (the family gateway's
+     * `modelDirectory` Remote): the add dialog's candidate vocabulary. Absent
+     * on a core that predates the Remote — the dialog then shows its reason.
+     */
+    modelDirectory?: (refresh?: boolean) => Promise<LocalAgentModelDirectory | null | undefined>;
+    /**
+     * The harness's endpoint verification (the family gateway's `checkEndpoint`
+     * Remote): a token-free probe of the SAVED endpoint, answered as verdict
+     * text. Absent on a core that predates the Remote — the card then hides
+     * the verify button.
+     */
+    checkEndpoint?: () => Promise<string | null | undefined>;
+    /**
+     * The harness's endpoint credential face (the family gateway's
+     * `endpointAuth`/`configureEndpoint` Remotes): the card's credential form
+     * reads and writes the harness's OWN credential store through it — never
+     * the settings scope, so no key ever lands in the profile patch document.
+     * Absent on a core that predates the Remotes — the card then hides the
+     * form. `write` answers the post-write resolved state.
+     */
+    endpointAuth?: {
+        read(): Promise<LocalAgentEndpointAuthState | null | undefined>;
+        write(fields: LocalAgentEndpointAuthFields): Promise<LocalAgentEndpointAuthState | null | undefined>;
+    };
     hooks: {
         /** The same scope as a hooks source, so the card reacts to external writes. */
         settings: SettingsScope<CodexLiveSettings>;
     };
 }
 /**
- * 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 CodexSettingsCardProps = InjectFace<CodexSettingsCardInjected> & 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 CodexBundleConfigProps = PropsRuntime<'plugins.bundle.config'> & InjectFace<CodexSettingsCardInjected> & PropsLocale<typeof NS>;
+/** Full props of the plugins.item entry (owner prop `view`). */
+export type CodexBundleConfigProps = PropsRuntime<'plugins.item'> & InjectFace<CodexSettingsCardInjected> & PropsLocale<typeof NS>;
+/**
+ * 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 CodexCardSectionProps = InjectFace<CodexSettingsCardInjected> & 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 codex harness settings card in the 0.1.5 plugin configuration tab: the
- * same collapsible chrome the official plugin cards use, re-implemented
+ * The codex 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 —
@@ -65,12 +105,21 @@ export type CodexBundleConfigProps = PropsRuntime<'plugins.bundle.config'> & Inj
  */
 export declare function CodexSettingsCard(props: CodexSettingsCardProps): 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 CodexBundleConfig({ view, useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t }: CodexBundleConfigProps): import("react").JSX.Element;
+export declare function CodexBundleConfig({ view, useSettings, scope, auth, authT, modelList, modelDirectory, checkEndpoint, endpointAuth, useSessions, t }: CodexBundleConfigProps): 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.
+ * @param props - the injected scope/auth faces, the forwarded session seat, and copy.
+ * @returns the section body.
+ */
+export declare function CodexCardSection({ active, useSettings, scope, auth, authT, modelList, modelDirectory, checkEndpoint, endpointAuth, useSessions, t }: CodexCardSectionProps): import("react").JSX.Element;
 //# sourceMappingURL=SettingsCard.d.ts.map

package/lib/types/client/SettingsCard.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useRef, useState } from 'react';
+import { useEffect, useState } from 'react';
 import { Tooltip } from '@deepseek-ai/dsh-client-ui-primitives';
 import { IconChevronDownOutlineMedium } from './icons.js';
 // The shared auth block is bundled from the family core's source — the
@@ -7,162 +7,120 @@ import { IconChevronDownOutlineMedium } from './icons.js';
 // the block carries no runtime identity to share.
 import { ProviderAuthBlock, } from '@khorsheed/dsh-local-agent/src/client/ProviderAuthBlock.tsx';
 import { AuthStatusDot } from '@khorsheed/dsh-local-agent/src/client/AuthStatusDot.tsx';
-import { useHarnessAuthStatus } from '@khorsheed/dsh-local-agent/src/client/auth-status.ts';
+import { publishAuthStatus, useHarnessAuthStatus } from '@khorsheed/dsh-local-agent/src/client/auth-status.ts';
+import { ModelListSection } from '@khorsheed/dsh-local-agent/src/client/ModelListSection.tsx';
 import css from './SettingsCard.module.css';
-/** How many previously-saved model identifiers the input suggests. */
-const RECENT_MODEL_LIMIT = 5;
 /**
- * The staged card state both settings surfaces share: the resident-mode and
- * model edits write through the bound settingsScope immediately
+ * The staged card state both settings surfaces share: the resident-mode
+ * switch writes through the bound settingsScope immediately
  * (revision-fenced), so a flip takes effect on the next delegation round
- * without a reload; the harness's model surface is fetched while the surface
- * is active (the 0.1.5 card opened, the alpha.2 page mounted) and re-fetched
- * after every save.
- * @param active - whether the surface currently shows the body (gates the model-surface fetch).
+ * without a reload; the endpoint credential form talks to the harness's own
+ * store through the endpointAuth face. The「可用模型」section is the family
+ * core's shared ModelListSection, which owns its own state.
+ * @param active - whether the surface currently shows the body (gates the credential-form fetch).
  * @param useSettings - the bound settings hook from the inject hooks compartment.
  * @param scope - the bound settings scope the writes go through.
- * @param harnessModel - the harness's memberless model surface read.
- * @param t - copy.
+ * @param endpointAuth - the harness's endpoint credential face; absent hides the credential form.
  */
-function useCardState(active, useSettings, scope, harnessModel, t) {
+function useCardState(active, useSettings, scope, endpointAuth) {
     const snapshot = useSettings(value => value);
     const [saved, setSaved] = useState(false);
     const [error, setError] = useState(false);
     const ready = snapshot.status === 'ready' && snapshot.writable;
     const live = snapshot.value?.live ?? false;
-    // The model input is a DRAFT until saved: `null` means "showing whatever the
-    // scope holds", so an external write (another tab, a YAML reload) still
-    // reaches the field while the user is not typing in it.
-    const storedModel = snapshot.value?.model ?? '';
-    const recentModels = snapshot.value?.recentModels ?? [];
-    const [modelDraft, setModelDraft] = useState(null);
-    const [modelSaved, setModelSaved] = useState(false);
-    const [modelError, setModelError] = useState(false);
-    const modelValue = modelDraft ?? storedModel;
-    // The harness's model surface, fetched while the surface is active (and
-    // re-fetched after a save): undefined until the first answer, null when the
-    // gateway or the broker is absent — the card then keeps the bare input with
-    // its recent-models suggestions, exactly as before brokers existed.
-    const [modelInfo, setModelInfo] = useState(undefined);
+    // The endpoint credential form talks to the harness's OWN credential store
+    // through the endpointAuth face — never the settings scope, so no key ever
+    // lands in the profile patch document. baseUrl echoes (it is not a
+    // secret); the key never does — a set key shows as a "configured"
+    // placeholder and the input holds only the draft of a REPLACEMENT. A blank
+    // write clears the field (the web login then answers for the scope again).
+    const [endpointState, setEndpointState] = useState(null);
+    const [baseUrlDraft, setBaseUrlDraft] = useState(null);
+    const [apiKeyDraft, setApiKeyDraft] = useState(null);
+    const [endpointSaved, setEndpointSaved] = useState(false);
+    const [endpointError, setEndpointError] = useState(false);
+    const endpointDirty = baseUrlDraft !== null || apiKeyDraft !== null;
+    const endpointUnavailable = endpointAuth === undefined || endpointState === 'unavailable';
+    const endpointLoading = !endpointUnavailable && endpointState === null;
+    const apiKeyConfigured = endpointState !== null && endpointState !== 'unavailable' && endpointState.apiKeySet;
     useEffect(() => {
-        if (!active)
+        if (!active || endpointAuth === undefined)
             return;
         let stale = false;
-        void harnessModel().then((info) => {
-            if (!stale)
-                setModelInfo(info ?? null);
-        });
+        void endpointAuth.read().then((state) => { if (!stale)
+            setEndpointState(state ?? 'unavailable'); }, () => { if (!stale)
+            setEndpointState('unavailable'); });
         return () => { stale = true; };
-    }, [active, harnessModel, modelSaved]);
-    /**
-     * Commit the model field. A blank value UNSETS the key rather than storing
-     * an empty string, so the field re-inherits the YAML composition base — and
-     * with no base, the harness is back to passing no model at all.
-     */
-    const saveModel = () => {
-        const next = modelValue.trim();
-        setModelSaved(false);
-        setModelError(false);
-        const write = next === '' ? scope.unset('model') : scope.set('model', next);
-        void write.then(async () => {
-            // Most-recent-first, deduplicated, capped: the suggestion list is a
-            // memory of what this instance has actually run, never a catalog.
-            if (next !== '') {
-                await scope.set('recentModels', [next, ...recentModels.filter(value => value !== next)].slice(0, RECENT_MODEL_LIMIT));
+    }, [active, endpointAuth, endpointSaved]);
+    // The credential save: one `configureEndpoint` call carrying only the
+    // dirty fields (a blank draft clears its field); the answer is the
+    // post-write resolved state, so the chips and the auth probe flip without
+    // a re-read.
+    const saveEndpoint = () => {
+        if (endpointAuth === undefined)
+            return;
+        setEndpointSaved(false);
+        setEndpointError(false);
+        const fields = {
+            ...baseUrlDraft !== null ? { baseUrl: baseUrlDraft.trim() === '' ? null : baseUrlDraft.trim() } : {},
+            ...apiKeyDraft !== null ? { apiKey: apiKeyDraft.trim() === '' ? null : apiKeyDraft.trim() } : {},
+        };
+        void endpointAuth.write(fields).then((state) => {
+            if (state !== undefined && state !== null) {
+                setEndpointState(state);
+                // Flip the status dot with the write's own answer — but only in
+                // the authenticated direction: clearing the key may still leave
+                // the web login's auth.json, which the next scheduled probe sees.
+                if (state.apiKeySet)
+                    publishAuthStatus('codex', 'authenticated');
             }
-            setModelDraft(null);
-            setModelSaved(true);
-        }, () => { setModelError(true); });
+            setBaseUrlDraft(null);
+            setApiKeyDraft(null);
+            setEndpointSaved(true);
+        }, () => { setEndpointError(true); });
     };
     const write = (field, value) => {
         setSaved(false);
         setError(false);
         void scope.set(field, value).then(() => { setSaved(true); }, () => { setError(true); });
     };
-    // The suggestion vocabulary: the broker's deduped union (settings + scoped
-    // config + discovered + recent) when the surface answered, the card's own
-    // recent-models memory when it did not. Never a hardcoded catalog. A
-    // non-empty list turns the field into a select-like control: the
-    // always-visible chevron opens the same vocabulary as a menu.
-    const choices = modelInfo?.choices ?? recentModels;
-    const [modelMenuOpen, setModelMenuOpen] = useState(false);
-    const [modelMenuUp, setModelMenuUp] = useState(false);
-    const modelFieldRef = useRef(null);
-    // Click-outside and Esc close the model menu (the member composer's picker
-    // pattern); the upward flip is measured when the menu opens.
-    useEffect(() => {
-        if (!modelMenuOpen)
-            return;
-        const onPointerDown = (event) => {
-            if (modelFieldRef.current?.contains(event.target) === true)
-                return;
-            setModelMenuOpen(false);
-        };
-        const onKeyDown = (event) => {
-            if (event.key === 'Escape')
-                setModelMenuOpen(false);
-        };
-        document.addEventListener('mousedown', onPointerDown);
-        document.addEventListener('keydown', onKeyDown);
-        return () => {
-            document.removeEventListener('mousedown', onPointerDown);
-            document.removeEventListener('keydown', onKeyDown);
-        };
-    }, [modelMenuOpen]);
-    const toggleModelMenu = () => {
-        if (!modelMenuOpen) {
-            const rect = modelFieldRef.current?.getBoundingClientRect();
-            if (rect !== undefined) {
-                const spaceBelow = window.innerHeight - rect.bottom;
-                setModelMenuUp(spaceBelow < 260 && rect.top > spaceBelow);
-            }
-        }
-        setModelMenuOpen(open => !open);
-    };
-    // An unset field DISPLAYS the default it follows (dimmed, as the input's
-    // placeholder — inherited, never pinned), down the chain the broker
-    // reports: the scoped config's model, then the account catalog's built-in
-    // default (source cli-builtin WITH an effective model — the one case
-    // cli-builtin names one), then the last observed model the records know,
-    // and last the generic copy.
-    const inheritedModel = modelInfo != null && modelInfo.cliDefault !== undefined && modelInfo.cliDefault !== ''
-        ? modelInfo.cliDefault
-        : modelInfo != null && modelInfo.source === 'cli-builtin' && modelInfo.effective !== undefined && modelInfo.effective !== ''
-            ? modelInfo.effective
-            : modelInfo != null && modelInfo.lastObserved !== undefined && modelInfo.lastObserved !== ''
-                ? modelInfo.lastObserved
-                : undefined;
-    const modelPlaceholder = inheritedModel ?? t('model.placeholder');
-    // The menu's leading item: the same chain, spelled as the follow-default
-    // choice. It reads checked while the field is unset, and picking it clears
-    // the draft back to follow-default (a save then unsets the key).
-    const modelDefaultItem = modelInfo != null && modelInfo.cliDefault !== undefined && modelInfo.cliDefault !== ''
-        ? t('model.menuDefault.cli-config', { model: modelInfo.cliDefault })
-        : modelInfo != null && modelInfo.source === 'cli-builtin' && modelInfo.effective !== undefined && modelInfo.effective !== ''
-            ? t('model.menuDefault.cli-builtin', { model: modelInfo.effective })
-            : modelInfo != null && modelInfo.lastObserved !== undefined && modelInfo.lastObserved !== ''
-                ? t('model.menuDefault.last-observed', { model: modelInfo.lastObserved })
-                : t('model.menuDefault');
     return {
-        snapshot, saved, error, ready, live, storedModel, modelValue, modelSaved,
-        modelError, choices, modelMenuOpen, modelMenuUp, modelFieldRef,
-        modelPlaceholder, modelDefaultItem, saveModel, write, toggleModelMenu,
-        setModelDraft, setModelMenuOpen,
+        snapshot, saved, error, ready, live, write,
+        endpointState, endpointUnavailable, endpointLoading,
+        baseUrlValue: baseUrlDraft ?? (endpointState !== null && endpointState !== 'unavailable' ? endpointState.baseUrl ?? '' : ''),
+        apiKeyConfigured, apiKeyDraft,
+        endpointSaved, endpointError, endpointDirty,
+        saveEndpoint, setBaseUrlDraft, setApiKeyDraft,
     };
 }
-/** The card body both settings surfaces share: the auth block, the default-model block, and the resident-mode block. */
-function CardBody({ state, auth, authT, renderModelPicker, useSessions, t }) {
-    const { snapshot, saved, error, ready, live, storedModel, modelValue, modelSaved, modelError, choices, modelMenuOpen, modelMenuUp, modelFieldRef, modelPlaceholder, modelDefaultItem, saveModel, write, toggleModelMenu, setModelDraft, setModelMenuOpen, } = state;
-    // The free-text input, single-sourced for both presentations: bare when no
-    // vocabulary exists (a fresh install degrades to exactly the pre-picker
-    // field), or inside the select-like field next to its chevron. No datalist:
-    // the chevron menu is the single choice list.
-    const modelInputElement = (_jsx("input", { type: "text", className: css.modelInput, value: modelValue, placeholder: modelPlaceholder, "aria-label": t('model.title'), disabled: !ready, onChange: (event) => { setModelDraft(event.target.value); } }));
-    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: 'codex', label: 'Codex' }, useSessions: useSessions, status: auth.status, runCommand: auth.runCommand, t: authT })] }), _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 }) })] }), saved && _jsx("span", { className: css.saved, children: t('live.applied') }), error && _jsx("span", { className: css.errorText, children: t('live.error') }), snapshot.status === 'unavailable' && (_jsx("span", { className: css.hint, children: t('live.unavailable') }))] })] }));
+/** The card body both settings surfaces share: the auth block, the model-list section, and the resident-mode block. */
+function CardBody({ state, active, auth, authT, modelList, modelDirectory, checkEndpoint, useSessions, t }) {
+    const { snapshot, saved, error, ready, live, write, endpointUnavailable, endpointLoading, baseUrlValue, apiKeyConfigured, apiKeyDraft, endpointSaved, endpointError, endpointDirty, saveEndpoint, setBaseUrlDraft, setApiKeyDraft, } = state;
+    // The verify button: runs the gateway's `checkEndpoint` Remote against the
+    // SAVED endpoint (unsaved drafts deliberately disable it — what it verifies
+    // is the saved configuration) and shows the verdict inline. Session-less:
+    // a settings card may have no main agent session to run a slash command.
+    const [checking, setChecking] = useState(false);
+    const [checkText, setCheckText] = useState(null);
+    const runCheck = () => {
+        if (checkEndpoint === undefined)
+            return;
+        setChecking(true);
+        setCheckText(null);
+        void checkEndpoint().then((text) => {
+            setCheckText(text ?? t('endpoint.checkUnavailable'));
+            setChecking(false);
+        }, () => {
+            setCheckText(t('endpoint.checkFailed'));
+            setChecking(false);
+        });
+    };
+    return (_jsxs("div", { className: css.body, children: [_jsxs("section", { className: css.block, children: [_jsxs("h3", { className: css.blockTitle, children: [t('auth.title'), _jsx(Tooltip, { label: t('endpoint.info'), side: "bottom", maxWidth: 360, children: _jsx("button", { type: "button", className: css.info, "aria-label": t('endpoint.info.aria'), children: "\u24D8" }) })] }), _jsx(ProviderAuthBlock, { harness: { id: 'codex', label: 'Codex' }, useSessions: useSessions, status: auth.status, runCommand: auth.runCommand, t: authT }), endpointUnavailable && (_jsx("span", { className: css.hint, children: t('endpoint.unavailable') })), !endpointUnavailable && (_jsxs("div", { className: css.endpointFields, children: [_jsxs("label", { className: css.endpointField, children: [_jsx("span", { className: css.endpointLabel, children: t('endpoint.baseUrl') }), _jsx("input", { type: "text", className: css.modelInput, value: baseUrlValue, placeholder: t('endpoint.baseUrl.placeholder'), "aria-label": t('endpoint.baseUrl'), disabled: endpointLoading, onChange: (event) => { setBaseUrlDraft(event.currentTarget.value); } })] }), _jsxs("label", { className: css.endpointField, children: [_jsxs("span", { className: css.endpointLabel, children: [t('endpoint.apiKey'), apiKeyConfigured && _jsx("span", { className: css.configuredChip, children: t('endpoint.configured') })] }), _jsx("input", { type: "password", className: css.modelInput, value: apiKeyDraft ?? '', placeholder: apiKeyConfigured ? t('endpoint.secret.configured') : t('endpoint.secret.placeholder'), "aria-label": t('endpoint.apiKey'), autoComplete: "off", disabled: endpointLoading, onChange: (event) => { setApiKeyDraft(event.currentTarget.value); } })] }), _jsxs("div", { className: css.row, children: [_jsx("button", { type: "button", className: css.modelSave, disabled: endpointLoading || !endpointDirty, onClick: () => { saveEndpoint(); }, children: t('endpoint.save') }), checkEndpoint !== undefined && (_jsx("button", { type: "button", className: css.modelSave, disabled: endpointLoading || endpointDirty || checking, title: endpointDirty ? t('endpoint.checkDirtyHint') : undefined, onClick: () => { runCheck(); }, children: checking ? t('endpoint.checking') : t('endpoint.check') })), endpointSaved && _jsx("span", { className: css.saved, children: t('endpoint.applied') }), endpointError && _jsx("span", { className: css.errorText, children: t('endpoint.error') })] }), checkText !== null && _jsx("span", { className: css.hint, children: checkText })] }))] }), _jsx(ModelListSection, { active: active, modelList: modelList, modelDirectory: modelDirectory, directoryRefresh: endpointSaved, t: authT }), _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 }) })] }), saved && _jsx("span", { className: css.saved, children: t('live.applied') }), error && _jsx("span", { className: css.errorText, children: t('live.error') }), snapshot.status === 'unavailable' && (_jsx("span", { className: css.hint, children: t('live.unavailable') }))] })] }));
 }
 /**
- * The codex harness settings card in the 0.1.5 plugin configuration tab: the
- * same collapsible chrome the official plugin cards use, re-implemented
+ * The codex 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 —
@@ -171,9 +129,9 @@ function CardBody({ state, auth, authT, renderModelPicker, useSessions, t }) {
  * @returns the card.
  */
 export function CodexSettingsCard(props) {
-    const { useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t } = props;
+    const { useSettings, scope, auth, authT, modelList, modelDirectory, checkEndpoint, endpointAuth, useSessions, t } = props;
     const [open, setOpen] = useState(false);
-    const state = useCardState(open, useSettings, scope, harnessModel, t);
+    const state = useCardState(open, useSettings, scope, endpointAuth);
     // The at-a-glance credential dot in the collapsed header: every mount
     // re-probes (a credential expiring mid-session must flip the dot at the
     // next view); the bus dedupes identical results, so no re-render storm.
@@ -182,19 +140,31 @@ export function CodexSettingsCard(props) {
         : authStatus === 'anonymous' ? 'settings.notAuthenticated'
             : authStatus === 'checking' ? 'loading' : 'error');
     const title = t('card.title');
-    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 })] }));
+    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, active: open, auth: auth, authT: authT, modelList: modelList, modelDirectory: modelDirectory, checkEndpoint: checkEndpoint, 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.
  */
-export function CodexBundleConfig({ view, useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t }) {
-    const state = useCardState(view === 'page', useSettings, scope, harnessModel, t);
+export function CodexBundleConfig({ view, useSettings, scope, auth, authT, modelList, modelDirectory, checkEndpoint, endpointAuth, useSessions, t }) {
+    const state = useCardState(view === 'page', useSettings, scope, endpointAuth);
     if (view === 'summary')
         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 });
+    return _jsx(CardBody, { state: state, active: view === 'page', auth: auth, authT: authT, modelList: modelList, modelDirectory: modelDirectory, checkEndpoint: checkEndpoint, 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.
+ * @param props - the injected scope/auth faces, the forwarded session seat, and copy.
+ * @returns the section body.
+ */
+export function CodexCardSection({ active, useSettings, scope, auth, authT, modelList, modelDirectory, checkEndpoint, endpointAuth, useSessions, t }) {
+    const state = useCardState(active, useSettings, scope, endpointAuth);
+    return _jsx(CardBody, { state: state, active: active, auth: auth, authT: authT, modelList: modelList, modelDirectory: modelDirectory, checkEndpoint: checkEndpoint, 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,28 +1,7 @@
-/**
- * Local-agent-codex plugin, browser half: the codex 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-codex`), and 0.1.5 renders
- * the `settings.plugin.item` card (keyed to the `local-agent-codex`
- * settings namespace the host half registers) in the official
- * Plugins → 可配置插件 tab. The card carries the family core's shared
- * ProviderAuthBlock (login/logout/device-code, backed by the core's
- * localAgentGateway Remote and the commands channel) plus the resident-mode
- * block (live switch) and 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 live controls.
- * @module @khorsheed/dsh-local-agent-codex/client
- */
 import type { Context } from '@deepseek-ai/cordis';
 import { en, NS, zh, type LocalAgentCodexKey } from './locales.ts';
-export { CodexBundleConfig, CodexSettingsCard } from './SettingsCard.tsx';
-export type { CodexLiveSettings, CodexBundleConfigProps, CodexSettingsCardInjected, CodexSettingsCardProps, } from './SettingsCard.tsx';
+export { CodexBundleConfig, CodexCardSection, CodexSettingsCard } from './SettingsCard.tsx';
+export type { CodexLiveSettings, CodexBundleConfigProps, CodexCardSectionProps, CodexSettingsCardInjected, CodexSettingsCardProps, } from './SettingsCard.tsx';
 export { en, NS, zh };
 export type { LocalAgentCodexKey };
 /**
@@ -31,12 +10,13 @@ export type { LocalAgentCodexKey };
  * 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 codex settings
- * surfaces bound to the local-agent-codex namespace.
+ * Client plugin body: register the dictionaries and the codex settings card
+ * bound to the local-agent-codex namespace.
  * @param ctx - client root context.
  */
 export declare function apply(ctx: Context): void;