@wowyuarm/dsh-agent-team 0.1.15 → 0.2.0

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/HumanSettingsSection.d.ts

@@ -1,5 +1,6 @@
 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 {
     /** The shared Human identity projection: profile facts plus post-write refresh. */
     identity: TeamHumanIdentityFace;
@@ -9,6 +10,8 @@ export interface HumanSettingsSectionInjected {
     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;
 }
 export type HumanSettingsSectionProps = PropsRuntime<'settings.section'> & PropsLocale<'team'> & HumanSettingsSectionInjected;
 export declare function HumanSettingsSection(props: HumanSettingsSectionProps): import("react").JSX.Element;

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

@@ -1 +1 @@
-{"version":3,"file":"HumanSettingsSection.d.ts","sourceRoot":"","sources":["../../../src/client/HumanSettingsSection.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEjF,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAiBlF,MAAM,WAAW,4BAA4B;IAC3C,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;CAChD;AAED,MAAM,MAAM,yBAAyB,GACjC,YAAY,CAAC,kBAAkB,CAAC,GAChC,WAAW,CAAC,MAAM,CAAC,GACnB,4BAA4B,CAAA;AAsBhC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BAiKpE"}
+{"version":3,"file":"HumanSettingsSection.d.ts","sourceRoot":"","sources":["../../../src/client/HumanSettingsSection.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAEjF,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAElF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAmBnE,MAAM,WAAW,4BAA4B;IAC3C,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;CACnC;AAED,MAAM,MAAM,yBAAyB,GACjC,YAAY,CAAC,kBAAkB,CAAC,GAChC,WAAW,CAAC,MAAM,CAAC,GACnB,4BAA4B,CAAA;AAsBhC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BAkKpE"}

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

@@ -2,16 +2,19 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 import { useRef, useState } from 'react';
 import { Button, Input } 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 css from './human-settings.module.css';
 /**
- * The Human's own settings page: display name, avatar, and the version
- * footnote.
+ * The Human's own settings page: display name, avatar, the local environment
+ * check, and the version footnote.
  *
  * The page owns no durable fact and no copy of one. Name, avatar, and version
  * all arrive from the shared identity projection, so a save here moves the
  * message rows and member refs at the same moment; a failed write keeps the
- * typed name in the field and reports the Host's own reason.
+ * typed name in the field and reports the Host's own reason. The environment
+ * check is a separate projection, read only, and belongs to the installation
+ * rather than to the Human.
  */
 /** Host-side avatar ceiling (`ATTACHMENT_MAX_BYTES`): the settings page refuses larger files before the round trip. */
 const AVATAR_MAX_BYTES = 10 * 1024 * 1024;
@@ -109,7 +112,7 @@ export function HumanSettingsSection(props) {
                                         : _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') })] })] })] }), _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(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') })] })] })] }), _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 })] }));
 }

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/environment-check.d.ts

@@ -0,0 +1,65 @@
+import type { RemoteResult } from '@deepseek-ai/dsh-typert-protocol';
+import type { AgentTeamEnvironmentResult } from '@wowyuarm/dsh-agent-team/types';
+/**
+ * The Client's one projection of the local environment check.
+ *
+ * Deliberately separate from the Human identity projection: this is a fact
+ * about the installation, not about the Human, it is read once and never
+ * written back, and the settings page is the only surface that renders it.
+ * Folding it into the identity store would make every seat that names the
+ * Human depend on a version comparison it has no use for.
+ *
+ * Reads are demand-driven off the first subscriber, so an ordinary conversation
+ * never calls the Remote. There is no retry: `undetermined` is a settled
+ * verdict about facts the Host could not establish, not a failed request, so a
+ * reader has nothing to retry.
+ */
+/** One read of the environment check, replaced wholesale on every change. */
+export interface TeamEnvironmentSnapshot {
+    /** `loading` until the first read settles, `ready` once it has. */
+    readonly status: 'loading' | 'ready';
+    /** The report to render; undefined until the first read settles. */
+    readonly report?: AgentTeamEnvironmentResult | undefined;
+}
+/** Read-side face the settings page binds. */
+export interface TeamEnvironmentSource {
+    getSnapshot(): TeamEnvironmentSnapshot;
+    subscribe(listener: () => void): () => void;
+}
+/** Host call the store reads through; one loader per Client context. */
+export interface TeamEnvironmentLoader {
+    loadEnvironment: () => Promise<RemoteResult<AgentTeamEnvironmentResult>>;
+}
+export declare class TeamEnvironmentCheck implements TeamEnvironmentSource {
+    private snapshot;
+    private readonly listeners;
+    private reading;
+    private readonly loader;
+    constructor(loader: TeamEnvironmentLoader);
+    readonly getSnapshot: () => TeamEnvironmentSnapshot;
+    /**
+     * Observe the check, 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 projection. 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 environment check. */
+export declare function useEnvironmentCheck(environment: TeamEnvironmentSource): TeamEnvironmentSnapshot;
+//# sourceMappingURL=environment-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment-check.d.ts","sourceRoot":"","sources":["../../../src/client/environment-check.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAA;AAEhF;;;;;;;;;;;;;GAaG;AAEH,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACtC,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAA;IACpC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAA;CACzD;AAED,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,WAAW,IAAI,uBAAuB,CAAA;IACtC,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5C;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;CACzE;AAID,qBAAa,oBAAqB,YAAW,qBAAqB;IAChE,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAClD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,MAAM,EAAE,qBAAqB;IAIzC,QAAQ,CAAC,WAAW,QAAO,uBAAuB,CAAiB;IAEnE;;;;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,6DAA6D;AAC7D,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,qBAAqB,GAAG,uBAAuB,CAE/F"}

package/packages/client-agent-team/lib/types/client/environment-check.js

@@ -0,0 +1,78 @@
+import { useSyncExternalStore } from 'react';
+const INITIAL = { status: 'loading' };
+export class TeamEnvironmentCheck {
+    snapshot = INITIAL;
+    listeners = new Set();
+    reading;
+    loader;
+    constructor(loader) {
+        this.loader = loader;
+    }
+    getSnapshot = () => this.snapshot;
+    /**
+     * Observe the check, 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 projection. 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.loadEnvironment();
+            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 environment check. */
+export function useEnvironmentCheck(environment) {
+    return useSyncExternalStore(environment.subscribe, environment.getSnapshot, environment.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;AA6CnE,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;AAsQD,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;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"}

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

@@ -1,6 +1,7 @@
 import agentTeamRemote from '@wowyuarm/dsh-agent-team/remote';
 import { HumanSettingsSection } from "./HumanSettingsSection.js";
 import { TeamHumanIdentity } from "./human-identity.js";
+import { TeamEnvironmentCheck } from "./environment-check.js";
 import { bytesToBase64 } from "./attachment-preview.js";
 import { TeamNavigation } from "./navigation.js";
 import { TeamChangeStream, TeamReadStream } from "./team-changes.js";
@@ -160,10 +161,17 @@ function applyUi(ctx) {
             return `data:${result.value.mediaType};base64,${result.value.bytesBase64}`;
         },
     });
+    // The local environment check: a fact about this installation rather than
+    // about the Human, so it is its own projection and never a field of the
+    // identity above. Read once, on the first subscriber, and never written back.
+    const environment = new TeamEnvironmentCheck({
+        loadEnvironment: () => ctx.remote.agentTeam.environment({}),
+    });
     ctx.effect(() => () => {
         navigation.dispose();
         drafts.dispose();
         humanIdentity.dispose();
+        environment.dispose();
         void disposeNavigation();
         void disposeDrafts();
     }, 'agent-team: navigation service');
@@ -250,6 +258,7 @@ function applyUi(ctx) {
         locale: NS,
         inject: () => ({
             identity: humanIdentity,
+            environment,
             saveName: async (name) => {
                 const saved = await ctx.remote.agentTeam.setHumanProfile({ name });
                 if (!saved.ok)

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

@@ -64,13 +64,11 @@ export declare const zh: {
     readonly resumeAgent: "恢复";
     readonly restartAgent: "重启";
     readonly restartStillUnavailable: "重启已执行，成员仍不可用：{diagnostic}";
-    readonly restartRefusedNoRestart: "会话日志被确定拒绝，修复无可用项，重启无法解决：{detail}";
     readonly restartFailed: "重启执行失败：{message}";
     readonly archiveAgent: "归档";
     readonly archiveAgentTitle: "归档 Agent：{name}";
     readonly archiveAgentNotice: "将把 {name} 从所有列表收起：会话与私有记忆保留在磁盘上、活跃 Claim 会释放，但暂无恢复入口。";
     readonly archiveAgentConfirm: "归档";
-    readonly archiveAgentFailed: "归档失败：{message}";
     readonly archiveChannel: "归档频道";
     readonly archiveChannelTitle: "归档频道：{name}";
     readonly archiveChannelNotice: "将把 {name} 及其全部讨论从所有列表收起：数据保留、所有成员在此频道的活跃 Claim 会释放，但暂无恢复入口。";
@@ -133,13 +131,21 @@ export declare const zh: {
     readonly humanSettingsUnavailable: "资料读不出来：{message}";
     readonly humanSettingsVersion: "版本 {version}";
     readonly humanSettingsUpdateAvailable: "有新版本 {version}，去查看发布说明";
+    readonly environmentOkTitle: "在支持范围内";
+    readonly environmentOkDetail: "正在运行的 DSH {version} 在我们声明的支持范围内。";
+    readonly environmentOutOfRangeTitle: "不在支持范围内";
+    readonly environmentOutOfRangeDetail: "正在运行的 DSH {version} 不在我们声明的支持范围内——这套组合未经我们认证，可能出问题。";
+    readonly environmentRange: "支持范围：{lower} 起、{upper} 之前。";
+    readonly environmentTested: "我们实测认证的组合：Agent Team {bundle} × DSH {dsh}。";
+    readonly environmentUndeterminedTitle: "无法判定运行环境";
+    readonly environmentUndeterminedDetail: "读不到正在运行的 DSH 版本，或无法确定我们的支持范围，因此不做判断。";
+    readonly environmentReleaseNotes: "查看发布说明";
     readonly taskStatusTodo: "待处理";
     readonly taskStatusInProgress: "进行中";
     readonly taskStatusInReview: "待验收";
     readonly taskStatusDone: "已完成";
     readonly taskStatusClosed: "已关闭";
     readonly taskLabel: "Task #{number}";
-    readonly taskPending: "Task …";
     readonly openTask: "打开 Task #{number}";
     readonly openThread: "打开讨论";
     readonly openTaskUnread: "打开 Task #{number}（{count} 条新动态）";
@@ -206,7 +212,6 @@ export declare const zh: {
     readonly activityReopened: "{actor} 重新打开了此 Task";
     readonly mentionConfirmation: "提及未关注成员需要确认，再次发送以继续";
     readonly memberNotFollowing: "这些成员还未关注此 Thread：{ids}";
-    readonly sendFailedKind: "无法发送消息（{kind}）";
     readonly unreadRequired: "请先读取 {count} 条未读更新，再继续修改。";
     readonly staleRevision: "Thread 已发生变化，请按最新状态重试。";
 };
@@ -276,13 +281,11 @@ export declare const en: {
     readonly resumeAgent: "Resume";
     readonly restartAgent: "Restart";
     readonly restartStillUnavailable: "Restart ran, but the Member is still unavailable: {diagnostic}";
-    readonly restartRefusedNoRestart: "The session log is deterministically refused with nothing repairable; restarting cannot fix it: {detail}";
     readonly restartFailed: "Restart failed: {message}";
     readonly archiveAgent: "Archive";
     readonly archiveAgentTitle: "Archive Agent: {name}";
     readonly archiveAgentNotice: "This hides {name} from every list: the session log and private memory stay on disk and active Claims release, but there is no restore entry point yet.";
     readonly archiveAgentConfirm: "Archive";
-    readonly archiveAgentFailed: "Failed to archive: {message}";
     readonly archiveChannel: "Archive Channel";
     readonly archiveChannelTitle: "Archive Channel: {name}";
     readonly archiveChannelNotice: "This hides {name} and all of its discussions from every list: the data stays, every Member's active Claims in this Channel release, but there is no restore entry point yet.";
@@ -345,13 +348,21 @@ export declare const en: {
     readonly humanSettingsUnavailable: "The profile could not be read: {message}";
     readonly humanSettingsVersion: "Version {version}";
     readonly humanSettingsUpdateAvailable: "New version {version} available — see the release notes";
+    readonly environmentOkTitle: "Within the supported range";
+    readonly environmentOkDetail: "The running DSH {version} is within the range we declare support for.";
+    readonly environmentOutOfRangeTitle: "Outside the supported range";
+    readonly environmentOutOfRangeDetail: "The running DSH {version} is outside the range we declare support for — we have not certified this combination and it may misbehave.";
+    readonly environmentRange: "Support range: from {lower} up to, but not including, {upper}.";
+    readonly environmentTested: "Certified combination: Agent Team {bundle} × DSH {dsh}.";
+    readonly environmentUndeterminedTitle: "Environment cannot be determined";
+    readonly environmentUndeterminedDetail: "The running DSH version could not be read, or our support range could not be established, so no judgement is made.";
+    readonly environmentReleaseNotes: "See the release notes";
     readonly taskStatusTodo: "To do";
     readonly taskStatusInProgress: "In progress";
     readonly taskStatusInReview: "In review";
     readonly taskStatusDone: "Done";
     readonly taskStatusClosed: "Closed";
     readonly taskLabel: "Task #{number}";
-    readonly taskPending: "Task …";
     readonly openTask: "Open Task #{number}";
     readonly openThread: "Open thread";
     readonly openTaskUnread: "Open Task #{number} ({count} new updates)";
@@ -418,7 +429,6 @@ export declare const en: {
     readonly activityReopened: "{actor} reopened this Task";
     readonly mentionConfirmation: "Mentioning an unfollowed member requires confirmation; send again to continue";
     readonly memberNotFollowing: "These Members do not follow this Thread yet: {ids}";
-    readonly sendFailedKind: "Unable to send message ({kind})";
     readonly unreadRequired: "Read {count} unread update(s) before changing this Thread.";
     readonly staleRevision: "This Thread changed; retry using the current state.";
 };

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

@@ -1 +1 @@
-{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuNL,CAAA;AAEV,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqNL,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAA"}
+{"version":3,"file":"locales.d.ts","sourceRoot":"","sources":["../../../src/client/locales.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+NL,CAAA;AAEV,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0NL,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAA"}

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

@@ -64,13 +64,11 @@ export const zh = {
     resumeAgent: '恢复',
     restartAgent: '重启',
     restartStillUnavailable: '重启已执行，成员仍不可用：{diagnostic}',
-    restartRefusedNoRestart: '会话日志被确定拒绝，修复无可用项，重启无法解决：{detail}',
     restartFailed: '重启执行失败：{message}',
     archiveAgent: '归档',
     archiveAgentTitle: '归档 Agent：{name}',
     archiveAgentNotice: '将把 {name} 从所有列表收起：会话与私有记忆保留在磁盘上、活跃 Claim 会释放，但暂无恢复入口。',
     archiveAgentConfirm: '归档',
-    archiveAgentFailed: '归档失败：{message}',
     archiveChannel: '归档频道',
     archiveChannelTitle: '归档频道：{name}',
     archiveChannelNotice: '将把 {name} 及其全部讨论从所有列表收起：数据保留、所有成员在此频道的活跃 Claim 会释放，但暂无恢复入口。',
@@ -133,13 +131,24 @@ export const zh = {
     humanSettingsUnavailable: '资料读不出来：{message}',
     humanSettingsVersion: '版本 {version}',
     humanSettingsUpdateAvailable: '有新版本 {version}，去查看发布说明',
+    // The environment check. The support line is stated in words, never as a bare
+    // semver range, and the tested-combination line prints only versions the Host
+    // could derive — the page adds no version of its own.
+    environmentOkTitle: '在支持范围内',
+    environmentOkDetail: '正在运行的 DSH {version} 在我们声明的支持范围内。',
+    environmentOutOfRangeTitle: '不在支持范围内',
+    environmentOutOfRangeDetail: '正在运行的 DSH {version} 不在我们声明的支持范围内——这套组合未经我们认证，可能出问题。',
+    environmentRange: '支持范围：{lower} 起、{upper} 之前。',
+    environmentTested: '我们实测认证的组合：Agent Team {bundle} × DSH {dsh}。',
+    environmentUndeterminedTitle: '无法判定运行环境',
+    environmentUndeterminedDetail: '读不到正在运行的 DSH 版本，或无法确定我们的支持范围，因此不做判断。',
+    environmentReleaseNotes: '查看发布说明',
     taskStatusTodo: '待处理',
     taskStatusInProgress: '进行中',
     taskStatusInReview: '待验收',
     taskStatusDone: '已完成',
     taskStatusClosed: '已关闭',
     taskLabel: 'Task #{number}',
-    taskPending: 'Task …',
     openTask: '打开 Task #{number}',
     openThread: '打开讨论',
     openTaskUnread: '打开 Task #{number}（{count} 条新动态）',
@@ -210,7 +219,6 @@ export const zh = {
     activityReopened: '{actor} 重新打开了此 Task',
     mentionConfirmation: '提及未关注成员需要确认，再次发送以继续',
     memberNotFollowing: '这些成员还未关注此 Thread：{ids}',
-    sendFailedKind: '无法发送消息（{kind}）',
     unreadRequired: '请先读取 {count} 条未读更新，再继续修改。',
     staleRevision: 'Thread 已发生变化，请按最新状态重试。',
 };
@@ -280,13 +288,11 @@ export const en = {
     resumeAgent: 'Resume',
     restartAgent: 'Restart',
     restartStillUnavailable: 'Restart ran, but the Member is still unavailable: {diagnostic}',
-    restartRefusedNoRestart: 'The session log is deterministically refused with nothing repairable; restarting cannot fix it: {detail}',
     restartFailed: 'Restart failed: {message}',
     archiveAgent: 'Archive',
     archiveAgentTitle: 'Archive Agent: {name}',
     archiveAgentNotice: 'This hides {name} from every list: the session log and private memory stay on disk and active Claims release, but there is no restore entry point yet.',
     archiveAgentConfirm: 'Archive',
-    archiveAgentFailed: 'Failed to archive: {message}',
     archiveChannel: 'Archive Channel',
     archiveChannelTitle: 'Archive Channel: {name}',
     archiveChannelNotice: 'This hides {name} and all of its discussions from every list: the data stays, every Member\'s active Claims in this Channel release, but there is no restore entry point yet.',
@@ -349,13 +355,21 @@ export const en = {
     humanSettingsUnavailable: 'The profile could not be read: {message}',
     humanSettingsVersion: 'Version {version}',
     humanSettingsUpdateAvailable: 'New version {version} available — see the release notes',
+    environmentOkTitle: 'Within the supported range',
+    environmentOkDetail: 'The running DSH {version} is within the range we declare support for.',
+    environmentOutOfRangeTitle: 'Outside the supported range',
+    environmentOutOfRangeDetail: 'The running DSH {version} is outside the range we declare support for — we have not certified this combination and it may misbehave.',
+    environmentRange: 'Support range: from {lower} up to, but not including, {upper}.',
+    environmentTested: 'Certified combination: Agent Team {bundle} × DSH {dsh}.',
+    environmentUndeterminedTitle: 'Environment cannot be determined',
+    environmentUndeterminedDetail: 'The running DSH version could not be read, or our support range could not be established, so no judgement is made.',
+    environmentReleaseNotes: 'See the release notes',
     taskStatusTodo: 'To do',
     taskStatusInProgress: 'In progress',
     taskStatusInReview: 'In review',
     taskStatusDone: 'Done',
     taskStatusClosed: 'Closed',
     taskLabel: 'Task #{number}',
-    taskPending: 'Task …',
     openTask: 'Open Task #{number}',
     openThread: 'Open thread',
     openTaskUnread: 'Open Task #{number} ({count} new updates)',
@@ -424,7 +438,6 @@ export const en = {
     activityReopened: '{actor} reopened this Task',
     mentionConfirmation: 'Mentioning an unfollowed member requires confirmation; send again to continue',
     memberNotFollowing: 'These Members do not follow this Thread yet: {ids}',
-    sendFailedKind: 'Unable to send message ({kind})',
     unreadRequired: 'Read {count} unread update(s) before changing this Thread.',
     staleRevision: 'This Thread changed; retry using the current state.',
 };