@wowyuarm/dsh-agent-team 0.2.0 → 0.2.1

package/packages/client-agent-team/lib/types/client/{HumanSettingsSection.d.ts → TeamSettingsSection.d.ts}

@@ -1,7 +1,9 @@
 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';
-export interface HumanSettingsSectionInjected {
+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. */
@@ -12,7 +14,13 @@ export interface HumanSettingsSectionInjected {
     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 HumanSettingsSectionProps = PropsRuntime<'settings.section'> & PropsLocale<'team'> & HumanSettingsSectionInjected;
-export declare function HumanSettingsSection(props: HumanSettingsSectionProps): import("react").JSX.Element;
-//# sourceMappingURL=HumanSettingsSection.d.ts.map
+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);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AA8CnE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAK5C,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAEnD,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC9F,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAIhD,eAAO,MAAM,MAAM,UAElB,CAAA;AAuBD,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,IAAI,EAAE,OAAO,CAAA;KACd;CACF;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,cAAc,EAAE,cAAc,CAAA;QAC9B,UAAU,EAAE,cAAc,CAAA;KAC3B;CACF;AA8QD,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAgDnE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAK5C,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAEnD,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC9F,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAYhD,eAAO,MAAM,MAAM,UAElB,CAAA;AAuBD,OAAO,QAAQ,kCAAkC,CAAC;IAChD,UAAU,kBAAkB;QAC1B,IAAI,EAAE,OAAO,CAAA;KACd;CACF;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,cAAc,EAAE,cAAc,CAAA;QAC9B,UAAU,EAAE,cAAc,CAAA;KAC3B;CACF;AAoUD,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}

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

@@ -1,5 +1,7 @@
 import agentTeamRemote from '@wowyuarm/dsh-agent-team/remote';
-import { HumanSettingsSection } from "./HumanSettingsSection.js";
+import { TeamSettingsSection } from "./TeamSettingsSection.js";
+import { TeamContextJudgeCheck } from "./context-judge.js";
+import { TeamJudgeForm, TeamJudgeFormSeat } from "./judge-form.js";
 import { TeamHumanIdentity } from "./human-identity.js";
 import { TeamEnvironmentCheck } from "./environment-check.js";
 import { bytesToBase64 } from "./attachment-preview.js";
@@ -13,8 +15,15 @@ import { TeamWorkspaceBrowser } from "./TeamWorkspaceBrowser.js";
 import { en, zh } from "./locales.js";
 export { TeamNavigation } from "./navigation.js";
 const NS = 'team';
+/**
+ * The Team Host row's settings namespace. Spelled here rather than imported,
+ * because a client package must not depend on a Host package — the profile, the
+ * judge's endpoint, and the gate's thresholds all live in this one row section,
+ * and each settings page renders only the group it owns.
+ */
+const TEAM_SETTINGS_NS = 'wowyuarm-agent-team-host';
 export const inject = [
-    'slots', 'workspaces', 'locale', 'remote', 'remote.session', 'sessions', 'connection', 'conversation', 'uiWorkspace',
+    'slots', 'workspaces', 'layout', 'locale', 'remote', 'remote.session', 'sessions', 'connection', 'conversation', 'uiWorkspace',
 ];
 /**
  * 0.1.7 moved the conversation selection into the workspace service: the
@@ -167,11 +176,25 @@ function applyUi(ctx) {
     const environment = new TeamEnvironmentCheck({
         loadEnvironment: () => ctx.remote.agentTeam.environment({}),
     });
+    // The long-gap gate's judge: what the Host answers about reachability, and
+    // the thresholds in force. Its own projection rather than a field of the
+    // environment check, because it re-reads after every write that can mount or
+    // unmount the judge while the environment verdict is settled once.
+    const contextJudge = new TeamContextJudgeCheck({
+        loadContextJudge: () => ctx.remote.agentTeam.contextJudge({}),
+    });
+    // The settings page's endpoint form. It is held in a seat rather than handed
+    // over as a value, because the service it is built over may arrive after the
+    // page's injected props were computed — and a slot entry's props are computed
+    // once and cached, so a value would freeze the answer.
+    const judgeForm = new TeamJudgeFormSeat();
     ctx.effect(() => () => {
         navigation.dispose();
         drafts.dispose();
         humanIdentity.dispose();
         environment.dispose();
+        contextJudge.dispose();
+        judgeForm.dispose();
         void disposeNavigation();
         void disposeDrafts();
     }, 'agent-team: navigation service');
@@ -203,6 +226,25 @@ function applyUi(ctx) {
             restore();
         };
     }, 'agent-team: member session restore');
+    // The shell renders one keyed main panel at a time — `activePanelId ?? 'conversation'`
+    // — so a shipped global panel (the plugin manager) stays on screen after Team mode is
+    // entered, and every Team destination then opens behind it: the sidebar moves while the
+    // column keeps rendering the foreign page. Team mode owns the conversation seat, so
+    // entering it, or navigating inside it, hands the column back to that seat. A null
+    // selection — and every mode but Team, where panel choice belongs to the shipped
+    // sidebar — is left untouched, so this never fights the shell's own selection.
+    ctx.effect(() => {
+        const releaseMainPanel = () => {
+            if (navigation.getSnapshot().mode !== 'team')
+                return;
+            if (ctx.layout.panelInfo.getSnapshot().activePanelId === null)
+                return;
+            ctx.layout.selectPanel(null);
+        };
+        const unsubscribe = navigation.subscribe(releaseMainPanel);
+        releaseMainPanel();
+        return unsubscribe;
+    }, 'agent-team: main panel ownership');
     const changes = new TeamChangeStream(ctx.remote);
     ctx.effect(() => () => changes.dispose(), 'agent-team: change subscriptions');
     // The Harness resumes a live generation across reconnects, but a stream that
@@ -244,21 +286,43 @@ function applyUi(ctx) {
     registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, 'sidebar.workspaces', TeamWorkspaceBrowser);
     registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, 'main', TeamConversation, undefined, 'conversation');
     registerModeShadow(ctx, navigation, changes, reads, drafts, humanIdentity, 'sidebar.settings', TeamMembersAction, () => ({ loadMemberGroups }));
-    // The Human profile page: one settings section, ordered between General (0)
-    // and Models (10) so identity sits near the top. Writes go through the Team
-    // Remote, which answers with the Host's own rejection reason (a name
-    // collides, an empty one), and the shared identity re-reads afterwards, so a
-    // rename lands in the timeline and the member refs at the same moment the
-    // page shows it.
+    // The Team's settings page: one settings section, ordered between General (0)
+    // and Models (10) so it sits near the top. It holds two groups that write
+    // through two different documents: identity goes through the Team Remote,
+    // which answers with the Host's own rejection reason (a name collides, an
+    // empty one), and the shared identity re-reads afterwards, so a rename lands
+    // in the timeline and the member refs at the same moment the page shows it.
+    //
+    // The judge's endpoint is one group of the Team row's settings section, so it
+    // is offered only while this deployment serves a settings document: the page
+    // is registered here regardless, because identity is reachable without one,
+    // and the seat above stays empty when there is none. The service is read
+    // through `ctx.get` rather than a hard `inject` for the same reason — a
+    // deployment without the settings UI keeps the rest of the Team.
+    ctx.inject(['configForms'], (scope) => {
+        const form = new TeamJudgeForm(scope.configForms.get(TEAM_SETTINGS_NS), contextJudge);
+        judgeForm.hold(form);
+        scope.effect(() => () => {
+            judgeForm.release(form);
+            form.dispose();
+        }, 'agent-team: judge settings form');
+    });
     ctx.slots.inject('settings.section', () => ctx.slots.register({
         name: 'settings.section',
-        id: 'team-human',
+        id: 'team-settings',
         order: 5,
-        label: () => ctx.locale.bind(NS)('humanSettingsNav'),
+        label: () => ctx.locale.bind(NS)('teamSettingsNav'),
         locale: NS,
         inject: () => ({
             identity: humanIdentity,
             environment,
+            judge: contextJudge,
+            judgeForm,
+            // The key's literal never rides a response; the describe mirror is what
+            // says whether one is stored.
+            keyConfigured: () => ctx.get('configForms')?.describe().getSnapshot().view?.namespaces
+                .find(row => row.ns === TEAM_SETTINGS_NS)?.secrets
+                .some(secret => secret.path.join('.') === 'jev.apiKey' && secret.set) ?? false,
             saveName: async (name) => {
                 const saved = await ctx.remote.agentTeam.setHumanProfile({ name });
                 if (!saved.ok)
@@ -294,7 +358,7 @@ function applyUi(ctx) {
                 return undefined;
             },
         }),
-    }, HumanSettingsSection));
+    }, TeamSettingsSection));
 }
 export async function apply(ctx) {
     const disposeRemote = await ctx.remote.$mount(agentTeamRemote);