@wowyuarm/dsh-agent-team 0.1.15 → 0.2.1

package/packages/client-agent-team/lib/types/client/EnvironmentCheck.d.ts

@@ -0,0 +1,18 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type TeamEnvironmentSource } from './environment-check.ts';
+/**
+ * The local environment check: which DSH line this installation runs against,
+ * and whether that line is inside the range the bundle declares.
+ *
+ * Three verdicts, never a fourth, and never a guess: a fact the Host could not
+ * establish is `undetermined`, not a mismatch. Every verdict is stated as text
+ * plus an icon, so the state survives a reader who cannot tell the colors
+ * apart. The support line is written in words rather than as a bare semver
+ * range, and the tested combination is printed only when the Host could derive
+ * both of its versions — the page never supplies a version of its own.
+ */
+export type EnvironmentCheckProps = PropsLocale<'team'> & {
+    readonly environment: TeamEnvironmentSource;
+};
+export declare function EnvironmentCheck({ t, environment }: EnvironmentCheckProps): import("react").JSX.Element | null;
+//# sourceMappingURL=EnvironmentCheck.d.ts.map

package/packages/client-agent-team/lib/types/client/EnvironmentCheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentCheck.d.ts","sourceRoot":"","sources":["../../../src/client/EnvironmentCheck.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAGxF;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,WAAW,CAAC,MAAM,CAAC,GACnB;IAAE,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAA;CAAE,CAAA;AAyBnD,wBAAgB,gBAAgB,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,qBAAqB,sCAkDzE"}

package/packages/client-agent-team/lib/types/client/EnvironmentCheck.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEnvironmentCheck } from "./environment-check.js";
+import css from './environment-check.module.css';
+/** The three glyphs, drawn at the 16px seat the settings page uses for state marks. */
+const ICONS = {
+    ok: _jsx("path", { d: "M3 8.5 6.5 12 13 4.5" }),
+    warn: _jsxs(_Fragment, { children: [_jsx("path", { d: "M8 2.5 14.6 13.6H1.4z" }), _jsx("path", { d: "M8 6.6v3.2" }), _jsx("path", { d: "M8 11.9h.01" })] }),
+    unknown: _jsxs(_Fragment, { children: [_jsx("circle", { cx: "8", cy: "8", r: "6" }), _jsx("path", { d: "M5.6 8h4.8" })] }),
+};
+function EnvironmentIcon({ glyph }) {
+    return _jsx("svg", { className: css.icon, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: ICONS[glyph] });
+}
+/** The release notes this bundle's own repository keeps, one click from the version footnote. */
+const RELEASE_NOTES_URL = 'https://github.com/wowyuarm/dsh-agent-team/releases';
+export function EnvironmentCheck({ t, environment }) {
+    const { report } = useEnvironmentCheck(environment);
+    // Nothing to state before the first read settles, and nothing to state if it
+    // never lands: the block is informational and its absence is not an error.
+    if (report === undefined)
+        return null;
+    const range = report.supportRange;
+    const running = report.dshVersion;
+    // The tested combination appears only when both of its versions were derived:
+    // the installed manifest's own version, and the range's lower bound, which is
+    // the certified line. A missing one withholds the line rather than inviting a
+    // hand-written version onto the page.
+    const certified = report.certifiedDshVersion;
+    const bundleVersion = report.bundleVersion;
+    // Both sides of the line have to be derived: `'unknown'` is the data layer's
+    // word for a version that could not be read, and it never reaches the page.
+    const tested = certified !== undefined && bundleVersion !== undefined && bundleVersion !== 'unknown';
+    const title = report.verdict === 'ok'
+        ? t('environmentOkTitle')
+        : report.verdict === 'out-of-range'
+            ? t('environmentOutOfRangeTitle')
+            : t('environmentUndeterminedTitle');
+    const lines = [];
+    if (report.verdict === 'ok') {
+        if (running !== undefined)
+            lines.push(t('environmentOkDetail', { version: running }));
+    }
+    else if (report.verdict === 'out-of-range') {
+        if (running !== undefined)
+            lines.push(t('environmentOutOfRangeDetail', { version: running }));
+        if (range !== undefined)
+            lines.push(t('environmentRange', { lower: range.lower, upper: range.upper }));
+        if (tested && certified !== undefined && bundleVersion !== undefined) {
+            lines.push(t('environmentTested', { bundle: bundleVersion, dsh: certified }));
+        }
+    }
+    else {
+        lines.push(t('environmentUndeterminedDetail'));
+    }
+    // `data-environment` carries the verdict the way the rest of the Client marks
+    // a state for assertions; the block also renders nothing at all before a read
+    // lands, so a journey can wait on this attribute rather than on prose.
+    return _jsxs("div", { className: css.block, "data-environment": report.verdict, children: [_jsx(EnvironmentIcon, { glyph: report.verdict === 'ok' ? 'ok' : report.verdict === 'out-of-range' ? 'warn' : 'unknown' }), _jsxs("div", { className: css.body, children: [_jsx("p", { className: css.title, children: title }), lines.map((line, index) => _jsx("p", { className: css.detail, children: line }, index)), report.verdict !== 'ok' && _jsx("p", { className: css.action, children: _jsx("a", { className: css.link, href: RELEASE_NOTES_URL, target: "_blank", rel: "noreferrer", children: t('environmentReleaseNotes') }) })] })] });
+}

package/packages/client-agent-team/lib/types/client/TeamAgentsPanel.js

@@ -230,11 +230,6 @@ function AgentRow({ workspaceId, leaveWorkspace, status, current, updateMember,
                 return;
             }
             if (result.value.status.availability === 'unavailable') {
-                const diagnostic = result.value.status.diagnostic;
-                if (diagnostic?.class === 'session-refused' && diagnostic.remediable === false) {
-                    setRowAlert(t('restartRefusedNoRestart', { detail: diagnosticText(result.value.status) }));
-                    return;
-                }
                 setRowAlert(t('restartStillUnavailable', { diagnostic: diagnosticText(result.value.status) || t('statusUnavailable') }));
                 return;
             }

package/packages/client-agent-team/lib/types/client/TeamPresenceDot.d.ts

@@ -7,7 +7,7 @@ export declare function diagnosticText(status: Pick<AgentTeamClientMemberStatus,
 /**
  * Whether the restart action can help an unavailable Member: it heals
  * transient and repairable failures, but not a transient rollover window
- * (which resolves on its own) or a refusal already proven non-remediable.
+ * (which resolves on its own).
  */
 export declare function restartOffered(status: AgentTeamClientMemberStatus): boolean;
 /** Shared presence → indicator mapping for dots and avatar badges. */

package/packages/client-agent-team/lib/types/client/TeamPresenceDot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TeamPresenceDot.d.ts","sourceRoot":"","sources":["../../../src/client/TeamPresenceDot.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,2BAA2B,EAAE,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,MAAM,CAKnG;AAED,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE,YAAY,CAAC,GAAG,MAAM,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAK3E;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAErG;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAA;IAC5C,QAAQ,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAA;CAClC,+BASA"}
+{"version":3,"file":"TeamPresenceDot.d.ts","sourceRoot":"","sources":["../../../src/client/TeamPresenceDot.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG3D,wBAAgB,aAAa,CAAC,MAAM,EAAE,2BAA2B,EAAE,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,MAAM,CAKnG;AAED,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE,YAAY,CAAC,GAAG,MAAM,CAI9F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAE3E;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAErG;AAED,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAA;IAC5C,QAAQ,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAA;CAClC,+BASA"}

package/packages/client-agent-team/lib/types/client/TeamPresenceDot.js

@@ -18,15 +18,10 @@ export function diagnosticText(status) {
 /**
  * Whether the restart action can help an unavailable Member: it heals
  * transient and repairable failures, but not a transient rollover window
- * (which resolves on its own) or a refusal already proven non-remediable.
+ * (which resolves on its own).
  */
 export function restartOffered(status) {
-    const diagnostic = status.diagnostic;
-    if (diagnostic === undefined)
-        return true;
-    if (diagnostic.class === 'rollover')
-        return false;
-    return !(diagnostic.class === 'session-refused' && diagnostic.remediable === false);
+    return status.diagnostic?.class !== 'rollover';
 }
 /** Shared presence → indicator mapping for dots and avatar badges. */
 export function presenceDotState(presence) {

package/packages/client-agent-team/lib/types/client/TeamSettingsSection.d.ts

@@ -0,0 +1,26 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type TeamHumanIdentityFace } from './human-identity.ts';
+import type { TeamEnvironmentSource } from './environment-check.ts';
+import { type TeamContextJudgeSource } from './context-judge.ts';
+import type { TeamJudgeFormSource } from './judge-form.ts';
+export interface TeamSettingsInjected {
+    /** The shared Human identity projection: profile facts plus post-write refresh. */
+    identity: TeamHumanIdentityFace;
+    /** Persist one renamed display name; the failure message when the Host refuses it. */
+    saveName: (name: string) => Promise<string | undefined>;
+    /** Upload one image file, persist its reference; the failure message when it does not stick. */
+    uploadAvatar: (file: File) => Promise<string | undefined>;
+    /** Clear the avatar; the identity falls back to the initial. */
+    removeAvatar: () => Promise<string | undefined>;
+    /** The local environment check, a read-only projection of the installation. */
+    environment: TeamEnvironmentSource;
+    /** The judge's live status: whether one is reachable right now. */
+    judge: TeamContextJudgeSource;
+    /** The staged form over the judge's endpoint; it holds nothing while this deployment serves no settings document. */
+    judgeForm: TeamJudgeFormSource;
+    /** Whether the settings document holds a key literal for the judge. */
+    keyConfigured: () => boolean;
+}
+export type TeamSettingsProps = PropsRuntime<'settings.section'> & PropsLocale<'team'> & TeamSettingsInjected;
+export declare function TeamSettingsSection(props: TeamSettingsProps): import("react").JSX.Element;
+//# sourceMappingURL=TeamSettingsSection.d.ts.map

package/packages/client-agent-team/lib/types/client/TeamSettingsSection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TeamSettingsSection.d.ts","sourceRoot":"","sources":["../../../src/client/TeamSettingsSection.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAMjF,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAElF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAEnE,OAAO,EAAmB,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AACjF,OAAO,KAAK,EAAiC,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAoBzF,MAAM,WAAW,oBAAoB;IACnC,mFAAmF;IACnF,QAAQ,EAAE,qBAAqB,CAAA;IAC/B,sFAAsF;IACtF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACvD,gGAAgG;IAChG,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IACzD,gEAAgE;IAChE,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAC/C,+EAA+E;IAC/E,WAAW,EAAE,qBAAqB,CAAA;IAClC,mEAAmE;IACnE,KAAK,EAAE,sBAAsB,CAAA;IAC7B,qHAAqH;IACrH,SAAS,EAAE,mBAAmB,CAAA;IAC9B,uEAAuE;IACvE,aAAa,EAAE,MAAM,OAAO,CAAA;CAC7B;AAED,MAAM,MAAM,iBAAiB,GACzB,YAAY,CAAC,kBAAkB,CAAC,GAChC,WAAW,CAAC,MAAM,CAAC,GACnB,oBAAoB,CAAA;AAsBxB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,+BA+K3D"}

package/packages/client-agent-team/lib/types/client/TeamSettingsSection.js

@@ -0,0 +1,195 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef, useState, useSyncExternalStore } from 'react';
+import { Button, IconChevronDownOutlineRegular, IconChevronRightOutlineRegular, Input, SettingsForm, SettingsSecretField, SettingsValueField, } from '@deepseek-ai/dsh-client-ui-primitives';
+import { useHumanIdentity } from "./human-identity.js";
+import { EnvironmentCheck } from "./EnvironmentCheck.js";
+import { useAvatarImage } from "./avatar-image.js";
+import { useContextJudge } from "./context-judge.js";
+import css from './team-settings.module.css';
+/**
+ * The Team's settings page: the Human's display name and avatar, the endpoint
+ * the relatedness judge calls, the local environment check, and the version
+ * footnote.
+ *
+ * The page owns no durable fact and no copy of one, and it holds its two
+ * writable groups apart because they are two different documents: identity
+ * arrives from the shared identity projection and writes through the Team
+ * Remote, while the judge's endpoint is one group of the Team row's settings
+ * section and writes through the settings provider. Neither group renders the
+ * other's fields, and a failed write in either keeps the typed value and
+ * reports the reason it was refused.
+ */
+/** Host-side avatar ceiling (`ATTACHMENT_MAX_BYTES`): the settings page refuses larger files before the round trip. */
+const AVATAR_MAX_BYTES = 10 * 1024 * 1024;
+/**
+ * Run one durable write and reduce every failure to the message the page
+ * reports. A rejected Remote call (a dropped carrier, a refused write) is a
+ * failure like any other: without this the field would sit on "saving" forever
+ * and report nothing.
+ */
+async function failureOf(action) {
+    try {
+        return await action();
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+/** First visible character of a display name, or the neutral `H` before one is known. */
+function avatarInitial(name) {
+    const trimmed = (name ?? '').replace(/^@/, '').trim();
+    return trimmed === '' ? 'H' : trimmed.slice(0, 1).toUpperCase();
+}
+export function TeamSettingsSection(props) {
+    const { t, identity } = props;
+    const profile = useHumanIdentity(identity);
+    // The endpoint form is observed rather than received: the settings service it
+    // is built over can arrive after this entry's injected props were computed,
+    // and those props are cached for the entry's lifetime, so a value handed over
+    // once would never appear.
+    const judgeForm = useSyncExternalStore(props.judgeForm.subscribe, props.judgeForm.getSnapshot);
+    // Undefined means "follow the Host value": the field re-syncs whenever the
+    // profile changes underneath, without a background read clobbering a name
+    // the reader is still editing.
+    const [draft, setDraft] = useState(undefined);
+    const [saving, setSaving] = useState(false);
+    const [uploading, setUploading] = useState(false);
+    const [notice, setNotice] = useState(null);
+    const filePicker = useRef(null);
+    const name = draft ?? profile.name ?? '';
+    const dirty = draft !== undefined && draft.trim() !== (profile.name ?? '');
+    const emptyName = draft !== undefined && draft.trim() === '';
+    const hasAvatar = profile.avatarRef !== undefined;
+    // The circle answers to decoded bytes, not to a stored reference: the Host
+    // accepts any `image/…` payload, so a file this browser cannot read has to
+    // fall back to the initial exactly as a removed one does.
+    const avatar = useAvatarImage(profile.avatarUrl);
+    const submitName = async () => {
+        if (!dirty || emptyName || saving)
+            return;
+        setSaving(true);
+        setNotice(null);
+        const failure = await failureOf(() => props.saveName(name.trim()));
+        setSaving(false);
+        if (failure !== undefined) {
+            setNotice(t('humanSettingsNameFailed', { message: failure }));
+            return;
+        }
+        setDraft(undefined);
+    };
+    const pickAvatar = async (file) => {
+        if (file === undefined)
+            return;
+        setNotice(null);
+        if (!file.type.startsWith('image/')) {
+            setNotice(t('humanSettingsAvatarNotImage'));
+            return;
+        }
+        if (file.size > AVATAR_MAX_BYTES) {
+            setNotice(t('humanSettingsAvatarTooLarge'));
+            return;
+        }
+        setUploading(true);
+        const failure = await failureOf(() => props.uploadAvatar(file));
+        setUploading(false);
+        if (failure !== undefined)
+            setNotice(t('humanSettingsAvatarFailed', { message: failure }));
+    };
+    const removeAvatar = async () => {
+        setNotice(null);
+        const failure = await failureOf(() => props.removeAvatar());
+        if (failure !== undefined)
+            setNotice(t('humanSettingsAvatarFailed', { message: failure }));
+    };
+    // The page says what it is before it says what happened: the settings nav
+    // lists it beside the Harness's own pages, so the title alone leaves "whose
+    // Team is this, and where does a change apply?" unanswered — and every state,
+    // including a failed read, has to answer it.
+    const pageHeader = _jsxs(_Fragment, { children: [_jsx("h2", { className: css.heading, children: t('teamSettingsTitle') }), _jsx("p", { className: css.intro, children: t('teamSettingsIntro') })] });
+    if (profile.status === 'loading' && profile.name === undefined) {
+        return _jsxs("div", { className: css.section, children: [pageHeader, _jsx("p", { className: css.state, role: "status", children: t('humanSettingsLoading') })] });
+    }
+    if (profile.name === undefined) {
+        return _jsxs("div", { className: css.section, children: [pageHeader, _jsx("p", { className: css.state, role: "alert", children: t('humanSettingsUnavailable', { message: profile.error ?? '' }) }), _jsx("div", { className: css.stateAction, children: _jsx(Button, { variant: "outline", onClick: () => { void identity.refresh(); }, children: t('retry') }) })] });
+    }
+    return _jsxs("div", { className: css.section, children: [pageHeader, _jsxs("div", { className: css.rows, children: [_jsxs("div", { className: css.row, children: [_jsxs("div", { className: css.rowText, children: [_jsx("div", { className: css.title, children: t('humanSettingsName') }), _jsx("div", { className: css.desc, children: t('humanSettingsNameHint') })] }), _jsxs("form", { className: css.controls, onSubmit: (event) => {
+                                    event.preventDefault();
+                                    void submitName();
+                                }, children: [_jsx(Input, { className: css.nameInput, "aria-label": t('humanSettingsName'), "aria-invalid": emptyName || undefined, value: name, disabled: saving, onChange: (event) => { setDraft(event.target.value); } }), _jsx(Button, { type: "submit", variant: "primary", disabled: saving || !dirty || emptyName, children: saving ? t('humanSettingsSaving') : t('humanSettingsSave') })] })] }), _jsxs("div", { className: css.row, children: [_jsxs("div", { className: css.rowText, children: [_jsx("div", { className: css.title, children: t('humanSettingsAvatar') }), _jsx("div", { className: css.desc, children: t('humanSettingsAvatarHint') })] }), _jsxs("div", { className: css.controls, children: [avatar.src === undefined
+                                        ? _jsx("span", { className: `${css.identity} ${css.identityFallback}`, "data-avatar": "initial", "aria-hidden": "true", children: avatarInitial(profile.name) })
+                                        : _jsx("img", { className: `${css.identity} ${css.identityImage}`, "data-avatar": "image", src: avatar.src, alt: "", onError: avatar.failed }), _jsx("input", { ref: filePicker, type: "file", accept: "image/*", tabIndex: -1, "aria-hidden": "true", hidden: true, onChange: (event) => {
+                                            void pickAvatar(event.target.files?.[0]);
+                                            event.target.value = '';
+                                        } }), _jsx(Button, { variant: "outline", disabled: uploading, onClick: () => { filePicker.current?.click(); }, children: uploading ? t('humanSettingsUploading') : hasAvatar ? t('humanSettingsReplace') : t('humanSettingsUpload') }), hasAvatar && _jsx(Button, { disabled: uploading, onClick: () => { void removeAvatar(); }, children: t('humanSettingsRemoveAvatar') })] })] })] }), judgeForm === undefined
+                ? null
+                : _jsx(JudgeGroup, { t: t, form: judgeForm, judge: props.judge, keyConfigured: props.keyConfigured }), _jsx("div", { className: css.environment, children: _jsx(EnvironmentCheck, { t: t, environment: props.environment }) }), _jsxs("div", { className: css.footnote, children: [_jsx("span", { children: t('humanSettingsVersion', { version: profile.version ?? '' }) }), _jsx("span", { "aria-hidden": "true", children: "\u00B7" }), _jsx("a", { className: css.link, href: profile.repoUrl ?? '', target: "_blank", rel: "noreferrer", children: "GitHub" }), profile.updateAvailable && profile.latestVersion !== undefined
+                        ? _jsx("a", { className: css.link, href: `${profile.repoUrl ?? ''}/releases`, target: "_blank", rel: "noreferrer", children: t('humanSettingsUpdateAvailable', { version: profile.latestVersion }) })
+                        : null] }), emptyName && _jsx("p", { className: css.notice, children: t('humanSettingsNameEmpty') }), notice === null ? null : _jsx("p", { className: css.notice, role: "alert", children: notice })] });
+}
+/**
+ * The judge's endpoint as one collapsed row: the state of jev on the line
+ * itself, and the three controls that decide it behind a disclosure.
+ *
+ * Collapsed is the default because the endpoint is set once and then left
+ * alone, while its state is worth seeing every time the page opens — so the
+ * row carries the answer and the controls wait. The status is read rather than
+ * derived, because a deployment may mount a judge from configuration this page
+ * cannot see, and it states what the Host answered rather than predicting it.
+ */
+function JudgeGroup(props) {
+    const { t, form, judge, keyConfigured } = props;
+    const { report } = useContextJudge(judge);
+    const state = useSyncExternalStore(form.subscribe, form.getSnapshot, form.getSnapshot);
+    const actions = form.actions();
+    const [open, setOpen] = useState(false);
+    const [clearing, setClearing] = useState(false);
+    const [clearFailed, setClearFailed] = useState(false);
+    const configured = keyConfigured();
+    // Every control answers to the document: a read-only document disables them
+    // all rather than letting a save fail after the fact.
+    const disabled = !state.shell.writable;
+    const labels = {
+        overridden: t('teamSettingsOverridden'),
+        reset: t('teamSettingsReset'),
+        invalid: t('teamSettingsInvalid'),
+    };
+    const field = (name) => state.fields[name];
+    const clear = async () => {
+        setClearing(true);
+        setClearFailed(false);
+        const landed = await form.clearKey();
+        setClearing(false);
+        if (!landed)
+            setClearFailed(true);
+    };
+    return _jsxs("div", { className: css.group, children: [_jsxs("button", { type: "button", className: css.groupToggle, "aria-expanded": open, onClick: () => { setOpen(value => !value); }, children: [_jsx("span", { className: css.groupChevron, "aria-hidden": "true", children: open ? _jsx(IconChevronDownOutlineRegular, { size: 14 }) : _jsx(IconChevronRightOutlineRegular, { size: 14 }) }), _jsx("span", { className: css.groupTitle, children: t('teamJudgeGroupTitle') }), _jsx(JudgeStatus, { t: t, report: report })] }), open
+                ? _jsxs("div", { className: css.groupBody, role: "group", "aria-label": t('teamJudgeGroupTitle'), "data-team-judge": true, children: [_jsx("p", { className: css.groupHint, children: t('teamJudgeGroupHint') }), _jsxs(SettingsForm, { labels: {
+                                unavailable: t('teamSettingsUnavailable'),
+                                readOnly: t('teamSettingsReadOnly'),
+                                saveFailed: t('teamSettingsSaveFailed'),
+                                save: t('teamSettingsSave'),
+                                saving: t('teamSettingsSaving'),
+                            }, state: state.shell, onSave: actions.save, onDiscard: actions.discard, children: [_jsx(SettingsValueField, { id: "team-judge-api-base", label: t('teamJudgeApiBase'), text: field('apiBase').text, overridden: field('apiBase').overridden, invalid: field('apiBase').invalid, overriddenLabel: labels.overridden, resetLabel: labels.reset, invalidLabel: labels.invalid, disabled: disabled, onEdit: text => { actions.edit('apiBase', text); }, onReset: () => { actions.resetField('apiBase'); } }), _jsx(SettingsValueField, { id: "team-judge-model", label: t('teamJudgeModel'), text: field('model').text, overridden: field('model').overridden, invalid: field('model').invalid, overriddenLabel: labels.overridden, resetLabel: labels.reset, invalidLabel: labels.invalid, disabled: disabled, onEdit: text => { actions.edit('model', text); }, onReset: () => { actions.resetField('model'); } }), _jsx(SettingsSecretField, { id: "team-judge-api-key", label: t('teamJudgeKey'), hint: t('teamJudgeKeyHint'), text: field('apiKey').text, configured: configured, stateLabel: configured ? t('teamJudgeKeySet') : t('teamJudgeKeyUnset'), disabled: disabled, onEdit: text => { actions.edit('apiKey', text); } }), configured
+                                    ? _jsxs("div", { className: css.clearRow, children: [_jsx(Button, { variant: "outline", size: "sm", disabled: disabled || state.shell.dirty || clearing, onClick: () => { void clear(); }, children: t('teamJudgeClearKey') }), _jsx("p", { className: css.clearHint, children: state.shell.dirty ? t('teamJudgeClearBlocked') : t('teamJudgeClearHint') }), clearFailed ? _jsx("p", { className: css.notice, role: "status", children: t('teamJudgeClearFailed') }) : null] })
+                                    : null] })] })
+                : null] });
+}
+/** The three glyphs, drawn at the 16px seat the settings page uses for state marks. */
+const ICONS = {
+    ok: _jsx("path", { d: "M3 8.5 6.5 12 13 4.5" }),
+    off: _jsxs(_Fragment, { children: [_jsx("circle", { cx: "8", cy: "8", r: "6" }), _jsx("path", { d: "M5.6 8h4.8" })] }),
+    warn: _jsxs(_Fragment, { children: [_jsx("path", { d: "M8 2.5 14.6 13.6H1.4z" }), _jsx("path", { d: "M8 6.6v3.2" }), _jsx("path", { d: "M8 11.9h.01" })] }),
+};
+/**
+ * The judge's live status in one line, inside the row that carries it. The
+ * verdict is stated as text and an icon, never by color alone, and nothing is
+ * said before the first read settles: the row then stands as a bare title.
+ */
+function JudgeStatus({ t, report }) {
+    if (report === undefined)
+        return null;
+    const verdict = report.enabled ? 'enabled' : report.reason ?? 'unavailable';
+    return _jsxs("span", { className: css.status, "data-context-judge": verdict, children: [_jsx("svg", { className: css.statusIcon, viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: ICONS[report.enabled ? 'ok' : report.reason === 'no-key' ? 'off' : 'warn'] }), _jsx("span", { children: report.enabled
+                    ? t('teamJudgeReady')
+                    : report.reason === 'no-key' ? t('teamJudgeNoKey') : t('teamJudgeUnavailable') })] });
+}

package/packages/client-agent-team/lib/types/client/attachment-preview.d.ts

@@ -1,16 +1,13 @@
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
 import type { AgentTeamAttachmentId, AgentTeamGetAttachmentRequest, AgentTeamGetAttachmentResult } from '@wowyuarm/dsh-agent-team/types';
 /** Base64 one file payload in chunks so large uploads stay off the call-stack limit. */
 export declare function bytesToBase64(bytes: Uint8Array): string;
-/** Mirrors the slot's Remote result union without importing the slots module. */
-type GetAttachment = (request: AgentTeamGetAttachmentRequest) => Promise<{
-    ok: true;
-    value: AgentTeamGetAttachmentResult;
-} | {
-    ok: false;
-    error: {
-        message: string;
-    };
-}>;
+/**
+ * The slot's Remote result union without importing the slots module: an
+ * expected failure arrives as a stable `code`, and any other error stays
+ * unknown to this cache.
+ */
+export type GetAttachment = (request: AgentTeamGetAttachmentRequest) => Promise<RemoteResult<AgentTeamGetAttachmentResult>>;
 export declare function cachedAttachmentDataUrl(attachmentId: AgentTeamAttachmentId): string | null | undefined;
 export declare function loadAttachmentDataUrl(getAttachment: GetAttachment, attachment: {
     attachmentId: AgentTeamAttachmentId;
@@ -18,5 +15,4 @@ export declare function loadAttachmentDataUrl(getAttachment: GetAttachment, atta
 }): Promise<string | null>;
 /** Human-readable byte size for attachment chips. */
 export declare function formatByteSize(byteSize: number): string;
-export {};
 //# sourceMappingURL=attachment-preview.d.ts.map

package/packages/client-agent-team/lib/types/client/attachment-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-preview.d.ts","sourceRoot":"","sources":["../../../src/client/attachment-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAExI,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOvD;AAED,iFAAiF;AACjF,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,4BAA4B,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAAA;AASvK,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtG;AAED,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE;IAAE,YAAY,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxK;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIvD"}
+{"version":3,"file":"attachment-preview.d.ts","sourceRoot":"","sources":["../../../src/client/attachment-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAExI,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOvD;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,6BAA6B,KAAK,OAAO,CAAC,YAAY,CAAC,4BAA4B,CAAC,CAAC,CAAA;AAW3H,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtG;AAED,wBAAsB,qBAAqB,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE;IAAE,YAAY,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxK;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIvD"}

package/packages/client-agent-team/lib/types/client/attachment-preview.js

@@ -9,8 +9,10 @@ export function bytesToBase64(bytes) {
 }
 /**
  * Thumbnail data URLs live in one session-wide cache: message lists re-render
- * often, and each miss costs a Host round-trip plus a base64 decode. Failed
- * loads (bytes already GC'd) are cached as `null` so the chip fallback is stable.
+ * often, and each miss costs a Host round-trip plus a base64 decode. Only a
+ * settled answer is cached: a gone entry resolves to `null` so the chip stays
+ * on the expired label, while an unknown failure caches nothing and lets a
+ * later mount retry the Host.
  */
 const dataUrlCache = new Map();
 export function cachedAttachmentDataUrl(attachmentId) {
@@ -21,7 +23,15 @@ export async function loadAttachmentDataUrl(getAttachment, attachment) {
     if (cached !== undefined)
         return cached;
     const result = await getAttachment({ attachmentId: attachment.attachmentId });
-    const url = result.ok && attachment.mediaType.startsWith('image/') ? `data:${attachment.mediaType};base64,${result.value.bytesBase64}` : null;
+    if (!result.ok) {
+        // Discriminate by code, never by message: the stable not-found code is a
+        // settled fact, everything else (carrier, Host, unknown future codes) is
+        // transient from this cache's point of view.
+        if (result.error.code === 'team/attachment-not-found')
+            dataUrlCache.set(attachment.attachmentId, null);
+        return null;
+    }
+    const url = attachment.mediaType.startsWith('image/') ? `data:${attachment.mediaType};base64,${result.value.bytesBase64}` : null;
     dataUrlCache.set(attachment.attachmentId, url);
     return url;
 }

package/packages/client-agent-team/lib/types/client/context-judge.d.ts

@@ -0,0 +1,64 @@
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { AgentTeamContextJudgeResult } from '@wowyuarm/dsh-agent-team/types';
+/**
+ * The Client's one projection of the long-gap gate's judge.
+ *
+ * The settings page stages the row configuration that mounts the judge, but it
+ * cannot state whether a judge is actually reachable: `enabled` is a fact about
+ * the running Host, and a deployment may mount one from configuration the page
+ * never sees. So this projection is read rather than derived, and every write
+ * that can mount or unmount the judge re-reads it instead of predicting the
+ * outcome.
+ *
+ * Reads are demand-driven off the first subscriber, so an ordinary conversation
+ * never calls the Remote.
+ */
+/** One read of the judge status, replaced wholesale on every change. */
+export interface TeamContextJudgeSnapshot {
+    /** `loading` until the first read settles, `ready` once it has. */
+    readonly status: 'loading' | 'ready';
+    /** The status to render; undefined until the first read settles. */
+    readonly report?: AgentTeamContextJudgeResult | undefined;
+}
+/** Read-side face the settings page binds. */
+export interface TeamContextJudgeSource {
+    getSnapshot(): TeamContextJudgeSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/** Host call the projection reads through; one loader per Client context. */
+export interface TeamContextJudgeLoader {
+    loadContextJudge: () => Promise<RemoteResult<AgentTeamContextJudgeResult>>;
+}
+export declare class TeamContextJudgeCheck implements TeamContextJudgeSource {
+    private snapshot;
+    private readonly listeners;
+    private reading;
+    private readonly loader;
+    constructor(loader: TeamContextJudgeLoader);
+    readonly getSnapshot: () => TeamContextJudgeSnapshot;
+    /**
+     * Observe the status, starting the first read when nobody has read yet.
+     * @param listener - invoked after every snapshot replacement.
+     * @returns the disposer removing this listener.
+     */
+    readonly subscribe: (listener: () => void) => (() => void);
+    /**
+     * Read the Host status. Concurrent callers share one round trip, and a failed
+     * read keeps the last accepted report — the block never blanks out over a
+     * background read.
+     * @returns settlement of this read (or of the read already in flight).
+     */
+    refresh(): Promise<void>;
+    dispose(): void;
+    private read;
+    /**
+     * Settle a read that produced no report, so a reader stops waiting on a
+     * `loading` that will never finish. A report that already stands is left
+     * untouched: a failed background read never blanks the block.
+     */
+    private fail;
+    private commit;
+}
+/** Subscribe one rendered block to the judge status. */
+export declare function useContextJudge(judge: TeamContextJudgeSource): TeamContextJudgeSnapshot;
+//# sourceMappingURL=context-judge.d.ts.map

package/packages/client-agent-team/lib/types/client/context-judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-judge.d.ts","sourceRoot":"","sources":["../../../src/client/context-judge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAA;AAEjF;;;;;;;;;;;;GAYG;AAEH,wEAAwE;AACxE,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IACpC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,SAAS,CAAA;CAC1D;AAED,8CAA8C;AAC9C,MAAM,WAAW,sBAAsB;IACrC,WAAW,IAAI,wBAAwB,CAAA;IACvC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,6EAA6E;AAC7E,MAAM,WAAW,sBAAsB;IACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,2BAA2B,CAAC,CAAC,CAAA;CAC3E;AAID,qBAAa,qBAAsB,YAAW,sBAAsB;IAClE,OAAO,CAAC,QAAQ,CAAoC;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,EAAE,sBAAsB;IAI1C,QAAQ,CAAC,WAAW,QAAO,wBAAwB,CAAiB;IAEpE;;;;OAIG;IACH,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAIxD;IAED;;;;;OAKG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IASxB,OAAO,IAAI,IAAI;YAID,IAAI;IAkBlB;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM;CAIf;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,KAAK,EAAE,sBAAsB,GAAG,wBAAwB,CAEvF"}

package/packages/client-agent-team/lib/types/client/context-judge.js

@@ -0,0 +1,78 @@
+import { useSyncExternalStore } from 'react';
+const INITIAL = { status: 'loading' };
+export class TeamContextJudgeCheck {
+    snapshot = INITIAL;
+    listeners = new Set();
+    reading;
+    loader;
+    constructor(loader) {
+        this.loader = loader;
+    }
+    getSnapshot = () => this.snapshot;
+    /**
+     * Observe the status, starting the first read when nobody has read yet.
+     * @param listener - invoked after every snapshot replacement.
+     * @returns the disposer removing this listener.
+     */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        if (this.snapshot.status === 'loading' && this.reading === undefined)
+            void this.refresh();
+        return () => { this.listeners.delete(listener); };
+    };
+    /**
+     * Read the Host status. Concurrent callers share one round trip, and a failed
+     * read keeps the last accepted report — the block never blanks out over a
+     * background read.
+     * @returns settlement of this read (or of the read already in flight).
+     */
+    refresh() {
+        if (this.reading !== undefined)
+            return this.reading;
+        const reading = this.read().finally(() => {
+            if (this.reading === reading)
+                this.reading = undefined;
+        });
+        this.reading = reading;
+        return reading;
+    }
+    dispose() {
+        this.listeners.clear();
+    }
+    async read() {
+        let report;
+        try {
+            const result = await this.loader.loadContextJudge();
+            if (!result.ok) {
+                this.fail();
+                return;
+            }
+            report = result.value;
+        }
+        catch {
+            // A dropped connection surfaces as a thrown carrier error, not a result:
+            // both are read failures and both keep whatever report already stands.
+            this.fail();
+            return;
+        }
+        this.commit({ status: 'ready', report });
+    }
+    /**
+     * Settle a read that produced no report, so a reader stops waiting on a
+     * `loading` that will never finish. A report that already stands is left
+     * untouched: a failed background read never blanks the block.
+     */
+    fail() {
+        if (this.snapshot.report === undefined)
+            this.commit({ status: 'ready' });
+    }
+    commit(snapshot) {
+        this.snapshot = snapshot;
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+/** Subscribe one rendered block to the judge status. */
+export function useContextJudge(judge) {
+    return useSyncExternalStore(judge.subscribe, judge.getSnapshot, judge.getSnapshot);
+}