@khorsheed/dsh-local-agent-codex 0.1.0-rc.6

package/lib/invariant.js

@@ -0,0 +1,31 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@khorsheed/dsh-local-agent-codex`.
+* @module @khorsheed/dsh-local-agent-codex/invariant
+*/
+const PACKAGE_NAME = "@khorsheed/dsh-local-agent-codex";
+/** Cordis companion plugin name. */
+const name = "local-agent-codex-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* The codex harness definition is this bundle's contract with the core
+* registry: whenever a `codex` harness registers, its scoped-home variable
+* must be the one this bundle pins.
+*/
+const install = (ctx, fail) => {
+	ctx.on("internal/dispatch", (_mode, eventName, args) => {
+		if (eventName !== "localAgent/harness-added") return;
+		const harness = args[0];
+		if (harness.name !== "codex") return;
+		if (harness.homeEnvVar !== "CODEX_HOME") fail("codex harness registered with a home env other than the local-agent-codex contract");
+	}, { global: true });
+};
+/**
+* Register this package's invariant companion.
+* @param ctx - plugin context carrying the invariant registry.
+* @returns the installed registration's disposer.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,76 @@
+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 { NS } from './locales.ts';
+/** The `local-agent-codex` settings namespace section the card edits. */
+export interface CodexLiveSettings {
+    /** Resident (live) mode: one resident `codex app-server` process per member. */
+    live?: boolean;
+    /**
+     * The model every delegation round starts the CLI with. Absent (the field
+     * cleared) means the plugin passes no model at all — the scoped `config.toml`'s own `model` decides,
+     * exactly as before the key existed.
+     */
+    model?: string;
+    /** Model identifiers saved before; the input's suggestions, capped at five. */
+    recentModels?: readonly string[];
+}
+/** 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. */
+    auth: ProviderAuthInjected;
+    /** 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.
+     */
+    harnessModel: () => Promise<LocalAgentModelInfo | 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).
+ */
+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>;
+/**
+ * The codex harness settings card in the 0.1.5 plugin configuration tab: 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 —
+ * the card's rows stay one line each.
+ * @param props - the injected scope/auth faces and copy.
+ * @returns the card.
+ */
+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`.
+ * @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;
+//# sourceMappingURL=SettingsCard.d.ts.map

package/lib/types/client/SettingsCard.js

@@ -0,0 +1,200 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, 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
+// sanctioned core/companion edge (the host half already depends on the core);
+// 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 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
+ * (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).
+ * @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.
+ */
+function useCardState(active, useSettings, scope, harnessModel, t) {
+    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);
+    useEffect(() => {
+        if (!active)
+            return;
+        let stale = false;
+        void harnessModel().then((info) => {
+            if (!stale)
+                setModelInfo(info ?? null);
+        });
+        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));
+            }
+            setModelDraft(null);
+            setModelSaved(true);
+        }, () => { setModelError(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,
+    };
+}
+/** 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 codex harness settings card in the 0.1.5 plugin configuration tab: 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 —
+ * the card's rows stay one line each.
+ * @param props - the injected scope/auth faces and copy.
+ * @returns the card.
+ */
+export function CodexSettingsCard(props) {
+    const { useSettings, scope, auth, authT, renderModelPicker, harnessModel, useSessions, t } = props;
+    const [open, setOpen] = useState(false);
+    const state = useCardState(open, useSettings, scope, harnessModel, t);
+    // 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.
+    const authStatus = useHarnessAuthStatus('codex', auth.status);
+    const dotLabel = authT(authStatus === 'authenticated' ? 'settings.authenticated'
+        : 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 })] }));
+}
+/**
+ * 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`.
+ * @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);
+    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 });
+}

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

@@ -0,0 +1,18 @@
+/**
+ * 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
+ * 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.
+ *
+ * @module @khorsheed/dsh-local-agent-codex/client
+ */
+/** Shared props for every product icon component (mirrors the upstream IconProps). */
+export interface IconProps {
+    /** Square edge in px; defaults to the glyph's own drawn size. */
+    size?: number | undefined;
+    /** Extra class for layout placement; color rides currentColor. */
+    className?: string | undefined;
+}
+export declare const IconChevronDownOutlineMedium: ({ size, className }: IconProps) => import("react").JSX.Element;
+//# sourceMappingURL=icons.d.ts.map

package/lib/types/client/icons.js

@@ -0,0 +1,2 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+export const IconChevronDownOutlineMedium = ({ size = 14, className }) => (_jsx("svg", { width: size, height: size, className: className, viewBox: "0 0 16 16", fill: "none", xmlns: "http://www.w3.org/2000/svg", "aria-hidden": "true", strokeWidth: 1.3, children: _jsx("path", { d: "M4 6L7.29289 9.29289C7.68342 9.68342 8.31658 9.68342 8.70711 9.29289L12 6", stroke: "currentColor" }) }));

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

@@ -0,0 +1,43 @@
+/**
+ * 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 { en, NS, zh };
+export type { LocalAgentCodexKey };
+/**
+ * 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).
+ */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the dictionaries and the codex settings
+ * surfaces bound to the local-agent-codex namespace.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/index.js

@@ -0,0 +1,88 @@
+import { bindSettingsScope } from '@khorsheed/dsh-local-agent/src/client/settings-scope.ts';
+import { en, NS, zh } from './locales.js';
+import { CodexBundleConfig, CodexSettingsCard, } from './SettingsCard.js';
+export { CodexBundleConfig, CodexSettingsCard } 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).
+ */
+const PACKAGE_NAME = '@khorsheed/dsh-local-agent-codex';
+/**
+ * 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).
+ */
+export const inject = ['slots', 'remote', 'remote.commands', 'locale'];
+/**
+ * Client plugin body: register the dictionaries and the codex settings
+ * surfaces bound to the local-agent-codex namespace.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'local-agent-codex: dictionaries');
+    const scope = bindSettingsScope(ctx, 'local-agent-codex');
+    // The auth block's copy lives in the family core's dictionary; binding is
+    // stable per namespace and late dictionary registration still resolves.
+    const authT = ctx.locale.bind('local-agent');
+    // The gateway namespace is mounted by the family core's client half; read it
+    // lazily from the global store so boot order between the two client plugins
+    // 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 = () => ({
+        scope,
+        hooks: { settings: scope },
+        authT,
+        renderModelPicker: props => ctx.get('localAgentUi')?.renderHarnessModelPicker('codex', props),
+        // The harness's memberless model surface; absent gateway/broker
+        // degrades to the bare input with its recent-models suggestions.
+        harnessModel: () => gateway()?.harnessModel('codex').then(result => (result.ok ? result.value : undefined))
+            ?? Promise.resolve(undefined),
+        auth: {
+            status: name => 
+            // The Remote declares (name, scope?) and the client enforces exact arity:
+            // pass the default scope explicitly (undefined reads as omitted host-side).
+            gateway()?.status(name, undefined).then(result => (result.ok ? result.value : undefined))
+                ?? Promise.resolve(undefined),
+            runCommand: (sessionId, line) => ctx.remote.commands.execute(sessionId, line, [])
+                .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,
+    }, CodexBundleConfig));
+    ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
+        name: 'plugins.row.config',
+        key: '@khorsheed/dsh-bundle-local-agent#local-agent-codex',
+        locale: NS,
+        inject: cardInject,
+    }, CodexBundleConfig));
+    const legacy = ctx.slots;
+    legacy.inject('settings.plugin.item', () => legacy.register({
+        name: 'settings.plugin.item',
+        key: 'local-agent-codex',
+        locale: NS,
+        inject: cardInject,
+    }, CodexSettingsCard));
+}

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

@@ -0,0 +1,64 @@
+/** `local-agent-codex` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin (matches the settings namespace). */
+export declare const NS = "local-agent-codex";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'card.title': string;
+    'card.description': string;
+    'card.expand': string;
+    'card.collapse': string;
+    'auth.title': string;
+    'model.title': string;
+    'model.info.aria': string;
+    'model.info': string;
+    'model.placeholder': string;
+    'model.menu': string;
+    'model.menuDefault': string;
+    'model.menuDefault.cli-config': string;
+    'model.menuDefault.cli-builtin': string;
+    'model.menuDefault.last-observed': string;
+    'model.save': string;
+    'model.applied': string;
+    'model.error': string;
+    'live.title': string;
+    'live.info.aria': string;
+    'live.info': string;
+    'live.applied': string;
+    'live.error': string;
+    'live.unavailable': string;
+};
+/** The local-agent-codex namespace key union. */
+export type LocalAgentCodexKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The codex harness settings card copy. */
+        'local-agent-codex': LocalAgentCodexKey;
+    }
+}
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'card.title': string;
+    'card.description': string;
+    'card.expand': string;
+    'card.collapse': string;
+    'auth.title': string;
+    'model.title': string;
+    'model.info.aria': string;
+    'model.info': string;
+    'model.placeholder': string;
+    'model.menu': string;
+    'model.menuDefault': string;
+    'model.menuDefault.cli-config': string;
+    'model.menuDefault.cli-builtin': string;
+    'model.menuDefault.last-observed': string;
+    'model.save': string;
+    'model.applied': string;
+    'model.error': string;
+    'live.title': string;
+    'live.info.aria': string;
+    'live.info': string;
+    'live.applied': string;
+    'live.error': string;
+    'live.unavailable': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/locales.js

@@ -0,0 +1,55 @@
+/** `local-agent-codex` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin (matches the settings namespace). */
+export const NS = 'local-agent-codex';
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+    'card.title': 'Local Agent · Codex',
+    'card.description': 'Codex 委派：登录授权与常驻模式（live）',
+    'card.expand': '展开',
+    'card.collapse': '收起',
+    'auth.title': '认证',
+    'model.title': '默认模型',
+    'model.info.aria': '默认模型说明',
+    'model.info': '留空 = 跟随默认（输入框里显示的就是当前跟随的模型）。从列表选择或手动输入一个模型名后保存，之后的每轮委派都以它起 CLI（一次性轮次走 `codex exec -m <模型>`，常驻模式走 app-server 的 `-c model=…`）。成员会话里还可用作曲器按会话切换，不影响这里的默认。改动在下一轮委派生效，进行中的轮次不受影响；评测 run 的条件在建立时冻结，中途换模型会被下一轮的模型回读判为 misattributed 而拦下。',
+    'model.placeholder': '留空 = 不传模型，用 CLI 自己的默认',
+    'model.menu': '选择模型',
+    'model.menuDefault': '默认（跟随 CLI 内置默认）',
+    'model.menuDefault.cli-config': '默认（跟随 CLI 配置：{model}）',
+    'model.menuDefault.cli-builtin': '默认（跟随 CLI 默认：{model}）',
+    'model.menuDefault.last-observed': '默认（跟随 CLI 内置默认（最近：{model}））',
+    'model.save': '保存',
+    'model.applied': '已保存，下一轮委派生效；进行中的轮次不受影响',
+    'model.error': '保存失败，请重试',
+    'live.title': '常驻模式（live）',
+    'live.info.aria': '常驻模式说明',
+    'live.info': '常驻模式 = 成员进程常驻：输出实时流入成员会话、取消不杀进程、崩溃后自动续上原会话；关闭则每轮独立进程，跑完一次性出结果。设置为全局偏好，对所有后续委派生效。',
+    'live.applied': '已保存，下一轮委派生效；进行中的轮次不受影响',
+    'live.error': '保存失败，请重试',
+    'live.unavailable': '设置服务不可用（宿主未注册 local-agent-codex 命名空间）',
+};
+/** English dictionary, checked complete against the zh key set. */
+export const en = {
+    'card.title': 'Local Agent · Codex',
+    'card.description': 'Codex delegation: sign-in and resident (live) mode',
+    'card.expand': 'Expand',
+    'card.collapse': 'Collapse',
+    'auth.title': 'Authentication',
+    'model.title': 'Default model',
+    'model.info.aria': 'About the default model',
+    'model.info': "Blank = follow the default (the input shows the model it currently follows). Pick from the list or type a model name by hand and save, and every later delegation round starts the CLI with it (`codex exec -m <model>` for one-shot rounds, `-c model=…` on the resident app-server). Inside a member session the composer can also switch the model per session, without touching this default. A change applies to the next round and never disturbs a round in flight; an evaluation run freezes its condition at setup, so switching mid-run is caught by the model read-back on the next round and fails the run as misattributed.",
+    'model.placeholder': "Blank = pass no model, keep the CLI's own default",
+    'model.menu': 'Pick a model',
+    'model.menuDefault': "Default (follow the CLI's built-in default)",
+    'model.menuDefault.cli-config': 'Default (follow the CLI config: {model})',
+    'model.menuDefault.cli-builtin': 'Default (follow the CLI default: {model})',
+    'model.menuDefault.last-observed': "Default (follow the CLI's built-in default (last: {model}))",
+    'model.save': 'Save',
+    'model.applied': 'Saved — takes effect on the next delegation round; rounds in flight are unaffected',
+    'model.error': 'Save failed, please retry',
+    'live.title': 'Resident mode (live)',
+    'live.info.aria': 'About resident mode',
+    'live.info': 'Resident mode keeps the member process alive: output streams into the member session in real time, cancelling does not kill the process, and a crash resumes the same session. Off means every round runs as an independent one-shot process. The setting is global and applies to every later delegation.',
+    'live.applied': 'Saved — takes effect on the next delegation round; rounds in flight are unaffected',
+    'live.error': 'Save failed, please retry',
+    'live.unavailable': 'Settings service unavailable (the host did not register the local-agent-codex namespace)',
+};