@khorsheed/dsh-local-agent-claude-code 0.1.0-rc.6

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

@@ -0,0 +1,78 @@
+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 { LocalAgentModelInfo } from '@khorsheed/dsh-local-agent/types';
+import { type ProviderAuthBlockProps, type ProviderAuthInjected } from '@khorsheed/dsh-local-agent/src/client/ProviderAuthBlock.tsx';
+import { NS } from './locales.ts';
+/** The `local-agent-claude-code` settings namespace section the card edits. */
+export interface ClaudeLiveSettings {
+    /** Resident (live) mode: one resident stream-json process per member. */
+    live?: boolean;
+    /** Live mirror granularity: folded events or per-chunk streaming. */
+    liveMirrorGranularity?: 'event' | 'token';
+    /**
+     * The model every delegation round starts the CLI with. Absent (the field
+     * cleared) means the plugin passes no model at all — the scoped `settings.json`'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 claude-code settings card. */
+export interface ClaudeCodeSettingsCardInjected {
+    renderModelPicker?: ((props: HarnessModelPickerInput) => ReactNode) | undefined;
+    /** Bound settings scope for the local-agent-claude-code namespace. */
+    scope: SettingsScope<ClaudeLiveSettings>;
+    /** 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 family gateway's
+     * `harnessModel` Remote): the inherited default the unset field displays
+     * and the menu's choice vocabulary. Absent on a core that predates the
+     * model broker — the card then keeps the bare free-text input exactly as
+     * before brokers existed.
+     */
+    modelInfo?: () => Promise<LocalAgentModelInfo | null | undefined>;
+    hooks: {
+        /** The same scope as a hooks source, so the card reacts to external writes. */
+        settings: SettingsScope<ClaudeLiveSettings>;
+    };
+}
+/**
+ * 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 ClaudeCodeSettingsCardProps = InjectFace<ClaudeCodeSettingsCardInjected> & 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 ClaudeCodeBundleConfigProps = PropsRuntime<'plugins.bundle.config'> & InjectFace<ClaudeCodeSettingsCardInjected> & PropsLocale<typeof NS>;
+/**
+ * The claude-code 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 ClaudeCodeSettingsCard(props: ClaudeCodeSettingsCardProps): 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 ClaudeCodeBundleConfig({ view, useSettings, scope, auth, authT, renderModelPicker, modelInfo, useSessions, t }: ClaudeCodeBundleConfigProps): import("react").JSX.Element;
+//# sourceMappingURL=SettingsCard.d.ts.map

package/lib/types/client/SettingsCard.js

@@ -0,0 +1,198 @@
+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 broker'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 modelInfo - the harness's memberless model surface read; absent degrades to the bare input.
+ * @param t - copy.
+ */
+function useCardState(active, useSettings, scope, modelInfo, 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 broker's model surface: fetched while the surface is active and after
+    // every save (the save changes the settings layer the surface reports). `null`
+    // means the gateway answered null (a brokerless core) or the read was
+    // never wired — the card then degrades to the bare input, no effective
+    // line, the recent-models suggestions.
+    const [modelSurface, setModelSurface] = useState(null);
+    useEffect(() => {
+        if (!active || modelInfo === undefined)
+            return;
+        let stale = false;
+        void modelInfo().then((info) => { if (!stale)
+            setModelSurface(info ?? null); }, () => { if (!stale)
+            setModelSurface(null); });
+        return () => { stale = true; };
+    }, [active, modelSaved, modelInfo]);
+    /**
+     * 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 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 = modelSurface !== null ? modelSurface.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 a cli-builtin source that still
+    // names its default (a harness catalog's isDefault entry), then the last
+    // observed model the records know, and last the generic copy.
+    const inheritedModel = modelSurface !== null && modelSurface.cliDefault !== undefined && modelSurface.cliDefault !== ''
+        ? modelSurface.cliDefault
+        : modelSurface !== null && modelSurface.source === 'cli-builtin' && modelSurface.effective !== undefined && modelSurface.effective !== ''
+            ? modelSurface.effective
+            : modelSurface !== null && modelSurface.lastObserved !== undefined && modelSurface.lastObserved !== ''
+                ? modelSurface.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 = modelSurface !== null && modelSurface.cliDefault !== undefined && modelSurface.cliDefault !== ''
+        ? t('model.menuDefaultCliConfig', { model: modelSurface.cliDefault })
+        : modelSurface !== null && modelSurface.source === 'cli-builtin' && modelSurface.effective !== undefined && modelSurface.effective !== ''
+            ? t('model.menuDefaultCliBuiltin', { model: modelSurface.effective })
+            : modelSurface !== null && modelSurface.lastObserved !== undefined && modelSurface.lastObserved !== ''
+                ? t('model.menuDefaultLastObserved', { model: modelSurface.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: 'claude-code', label: 'Claude Code' }, 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 claude-code 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 ClaudeCodeSettingsCard(props) {
+    const { useSettings, scope, auth, authT, renderModelPicker, modelInfo, useSessions, t } = props;
+    const [open, setOpen] = useState(false);
+    const state = useCardState(open, useSettings, scope, modelInfo, 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('claude-code', 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 ClaudeCodeBundleConfig({ view, useSettings, scope, auth, authT, renderModelPicker, modelInfo, useSessions, t }) {
+    const state = useCardState(view === 'page', useSettings, scope, modelInfo, 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-claude-code/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,36 @@
+/**
+ * Local-agent-claude-code plugin, browser half: the claude-code 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-claude-code`, the row id the
+ * bundle's patch declares), and 0.1.5 renders the `settings.plugin.item`
+ * card (keyed to the `local-agent-claude-code` settings namespace the host
+ * half registers) in the official Plugins → 可配置插件 tab. The card carries the family core's
+ * shared ProviderAuthBlock (login/logout/manual-handoff, backed by the core's
+ * localAgentGateway Remote and the commands channel), the default-model block
+ * (free-text write plus the gateway's model surface: the effective-model line
+ * and the suggestion vocabulary), and the resident-mode switch, 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, an unregistered namespace
+ * disables the live controls.
+ * @module @khorsheed/dsh-local-agent-claude-code/client
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { en, NS, zh, type LocalAgentClaudeCodeKey } from './locales.ts';
+export { ClaudeCodeBundleConfig, ClaudeCodeSettingsCard } from './SettingsCard.tsx';
+export type { ClaudeLiveSettings, ClaudeCodeBundleConfigProps, ClaudeCodeSettingsCardInjected, ClaudeCodeSettingsCardProps, } from './SettingsCard.tsx';
+export { en, NS, zh };
+export type { LocalAgentClaudeCodeKey };
+/** Required services: slot registry, settings scope, command Remote, and locale registry. */
+export declare const inject: string[];
+/**
+ * Client plugin body: register the dictionaries and the claude-code settings
+ * surfaces bound to the local-agent-claude-code 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,87 @@
+import { bindSettingsScope } from '@khorsheed/dsh-local-agent/src/client/settings-scope.ts';
+import { en, NS, zh } from './locales.js';
+import { ClaudeCodeBundleConfig, ClaudeCodeSettingsCard, } from './SettingsCard.js';
+export { ClaudeCodeBundleConfig, ClaudeCodeSettingsCard } 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-claude-code';
+/** Required services: slot registry, settings scope, command Remote, and locale registry. */
+export const inject = ['slots', 'remote', 'remote.commands', 'locale'];
+/**
+ * Client plugin body: register the dictionaries and the claude-code settings
+ * surfaces bound to the local-agent-claude-code namespace.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'local-agent-claude-code: dictionaries');
+    const scope = bindSettingsScope(ctx, 'local-agent-claude-code');
+    // 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('claude-code', props),
+        // The model surface read behind the default-model block's effective
+        // line and suggestions. 'claude-code' is the harness name the host
+        // half registers; a core predating the model broker (or an absent
+        // gateway) degrades to the bare free-text input.
+        modelInfo: () => {
+            const gw = gateway();
+            if (gw === undefined || typeof gw.harnessModel !== 'function')
+                return Promise.resolve(undefined);
+            return gw.harnessModel('claude-code').then(result => (result.ok ? result.value : 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,
+    }, ClaudeCodeBundleConfig));
+    ctx.slots.inject('plugins.row.config', () => ctx.slots.register({
+        name: 'plugins.row.config',
+        key: '@khorsheed/dsh-bundle-local-agent#local-agent-claude-code',
+        locale: NS,
+        inject: cardInject,
+    }, ClaudeCodeBundleConfig));
+    const legacy = ctx.slots;
+    legacy.inject('settings.plugin.item', () => legacy.register({
+        name: 'settings.plugin.item',
+        key: 'local-agent-claude-code',
+        locale: NS,
+        inject: cardInject,
+    }, ClaudeCodeSettingsCard));
+}

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

@@ -0,0 +1,64 @@
+/** `local-agent-claude-code` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin (matches the settings namespace). */
+export declare const NS = "local-agent-claude-code";
+/** 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.menuDefaultCliConfig': string;
+    'model.menuDefaultCliBuiltin': string;
+    'model.menuDefaultLastObserved': 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-claude-code namespace key union. */
+export type LocalAgentClaudeCodeKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The claude-code harness settings card copy. */
+        'local-agent-claude-code': LocalAgentClaudeCodeKey;
+    }
+}
+/** 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.menuDefaultCliConfig': string;
+    'model.menuDefaultCliBuiltin': string;
+    'model.menuDefaultLastObserved': 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-claude-code` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin (matches the settings namespace). */
+export const NS = 'local-agent-claude-code';
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export const zh = {
+    'card.title': 'Local Agent · Claude Code',
+    'card.description': 'Claude Code 委派：登录授权与常驻模式（live）',
+    'card.expand': '展开',
+    'card.collapse': '收起',
+    'auth.title': '认证',
+    'model.title': '默认模型',
+    'model.info.aria': '默认模型说明',
+    'model.info': '留空 = 跟随默认（输入框里显示的就是当前跟随的模型）。从列表选择或手动输入一个模型名后保存，之后的每轮委派都以它起 CLI（`claude -p --model <模型>`，常驻模式同一个旗标）。成员会话里还可用作曲器按会话切换，不影响这里的默认。改动在下一轮委派生效，进行中的轮次不受影响；评测 run 的条件在建立时冻结，中途换模型会被下一轮的模型回读判为 misattributed 而拦下。',
+    'model.placeholder': '留空 = 不传模型，用 CLI 自己的默认',
+    'model.menu': '选择模型',
+    'model.menuDefault': '默认（跟随 CLI 内置默认）',
+    'model.menuDefaultCliConfig': '默认（跟随 CLI 配置：{model}）',
+    'model.menuDefaultCliBuiltin': '默认（跟随 CLI 默认：{model}）',
+    'model.menuDefaultLastObserved': '默认（跟随 CLI 内置默认（最近：{model}））',
+    'model.save': '保存',
+    'model.applied': '已保存，下一轮委派生效；进行中的轮次不受影响',
+    'model.error': '保存失败，请重试',
+    'live.title': '常驻模式（live）',
+    'live.info.aria': '常驻模式说明',
+    'live.info': '常驻模式 = 成员进程常驻：输出实时流入成员会话、取消不杀进程、崩溃后自动续上原会话；关闭则每轮独立进程，跑完一次性出结果。设置为全局偏好，对所有后续委派生效。',
+    'live.applied': '已保存，下一轮委派生效；进行中的轮次不受影响',
+    'live.error': '保存失败，请重试',
+    'live.unavailable': '设置服务不可用（宿主未注册 local-agent-claude-code 命名空间）',
+};
+/** English dictionary, checked complete against the zh key set. */
+export const en = {
+    'card.title': 'Local Agent · Claude Code',
+    'card.description': 'Claude Code 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 (`claude -p --model <model>`, the same flag in resident mode). 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.menuDefaultCliConfig': 'Default (follow the CLI config: {model})',
+    'model.menuDefaultCliBuiltin': 'Default (follow the CLI default: {model})',
+    'model.menuDefaultLastObserved': "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-claude-code namespace)',
+};

package/lib/types/control-requests.d.ts

@@ -0,0 +1,15 @@
+type JsonObject = Record<string, unknown>;
+/** Bounded, correlated Claude stream-json controls, shared by discovery and live sessions. */
+export declare class ClaudeControlRequests {
+    private readonly send;
+    private readonly timeoutMs;
+    private sequence;
+    private closed;
+    private readonly pending;
+    constructor(send: (message: JsonObject) => void, timeoutMs?: number);
+    accept(event: JsonObject): boolean;
+    request(request: JsonObject, signal?: AbortSignal): Promise<JsonObject>;
+    close(): void;
+}
+export {};
+//# sourceMappingURL=control-requests.d.ts.map

package/lib/types/control-requests.js

@@ -0,0 +1,62 @@
+/** Bounded, correlated Claude stream-json controls, shared by discovery and live sessions. */
+export class ClaudeControlRequests {
+    send;
+    timeoutMs;
+    sequence = 0;
+    closed = false;
+    pending = new Map();
+    constructor(send, timeoutMs = 5_000) {
+        this.send = send;
+        this.timeoutMs = timeoutMs;
+    }
+    accept(event) {
+        if (event['type'] !== 'control_response')
+            return false;
+        const response = event['response'];
+        const id = response?.['request_id'];
+        if (typeof id !== 'string')
+            return true;
+        const pending = this.pending.get(id);
+        if (pending === undefined)
+            return true;
+        if (response?.['subtype'] !== 'success') {
+            pending.reject(new Error(typeof response?.['error'] === 'string' ? response['error'] : 'Claude rejected the control request'));
+        }
+        else {
+            const result = response['response'];
+            pending.resolve(typeof result === 'object' && result !== null ? result : {});
+        }
+        return true;
+    }
+    request(request, signal) {
+        if (this.closed || signal?.aborted)
+            return Promise.reject(new Error('Claude control channel is closed'));
+        const id = `dsh-control-${++this.sequence}`;
+        return new Promise((resolve, reject) => {
+            const finish = () => {
+                this.pending.delete(id);
+                clearTimeout(timer);
+                signal?.removeEventListener('abort', abort);
+            };
+            const fail = (error) => { finish(); reject(error); };
+            const abort = () => { fail(new Error('Claude control request cancelled')); };
+            const timer = setTimeout(() => fail(new Error(`Claude ${String(request['subtype'])} control timed out`)), this.timeoutMs);
+            timer.unref();
+            this.pending.set(id, { resolve: value => { finish(); resolve(value); }, reject: fail });
+            signal?.addEventListener('abort', abort, { once: true });
+            try {
+                this.send({ type: 'control_request', request_id: id, request });
+            }
+            catch (error) {
+                fail(error instanceof Error ? error : new Error('Claude control write failed'));
+            }
+        });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        for (const request of [...this.pending.values()])
+            request.reject(new Error('Claude control channel closed before acknowledgement'));
+    }
+}