@wowyuarm/dsh-agent-team 0.1.10 → 0.1.12

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

@@ -1,13 +1,24 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
-import { IconAgentPresetOutline16, IconListPenOutline16, Tooltip } from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconAgentPresetOutline16, IconListPenOutline16, IconQueueOutline14, Tooltip } from '@deepseek-ai/dsh-client-ui-primitives';
 import { TeamWorkspaceRow } from "./TeamWorkspaceRow.js";
 import { TeamSidebarSection } from "./TeamSidebarSection.js";
 import { useSidebarSectionOpen, setSidebarSectionOpen } from "./sidebar-sections.js";
 import { TeamAgentsPanel } from "./TeamAgentsPanel.js";
 import { TeamChannelsPanel } from "./TeamChannelsPanel.js";
 import css from './sidebar.module.css';
-export function TeamWorkspaceBrowser({ wide, expandSidebar, navigation, selectWorkspace, selectChannel, t, useWorkspaces, loadMembers, subscribeChanges, addMember, loadChannels, createChannel, updateChannel, archiveChannel, updateMember, recoverMember, archiveMember, joinChannel, removeChannelMember, loadModels, openMemberSession }) {
+/**
+ * The Inbox entry's icon with its unread mark. The quantity left this surface
+ * and lives in the control's accessible name: the sidebar answers whether
+ * anything is waiting at a glance, and the number — which moves on every fact —
+ * is what a reader asks for on purpose. The mark hangs off the icon rather than
+ * off the control, so the wide card and the 36px rail button put the same dot
+ * on the same corner of the same glyph.
+ */
+function InboxMark({ unread }) {
+    return _jsxs("span", { className: css.inboxMark, children: [_jsx(IconQueueOutline14, { size: 16 }), unread > 0 && _jsx("span", { className: css.inboxDot, "data-team-inbox-dot": true, "aria-hidden": "true" })] });
+}
+export function TeamWorkspaceBrowser({ wide, expandSidebar, navigation, selectWorkspace, selectChannel, selectInbox, t, useWorkspaces, loadMembers, loadInbox, subscribeChanges, subscribeReads, addMember, loadChannels, createChannel, updateChannel, archiveChannel, updateMember, recoverMember, archiveMember, joinChannel, removeChannelMember, loadModels, openMemberSession }) {
     const navigationState = useSyncExternalStore(navigation.subscribe, navigation.getSnapshot, navigation.getSnapshot);
     const workspaces = useWorkspaces(state => state.items);
     const selected = navigationState.workspaceId;
@@ -16,19 +27,69 @@ export function TeamWorkspaceBrowser({ wide, expandSidebar, navigation, selectWo
     // Exactly one sidebar row carries aria-current='page': the open Channel while
     // one is set, the selected Agent card while a Member Session view is open,
     // otherwise the browsed Workspace's overview. The selected row keeps its
-    // quiet folder tint (data-selected) in every case.
-    const overviewIsCurrent = navigationState.channelRef === undefined && navigationState.memberSessionId === undefined;
+    // quiet folder tint (data-selected) in every case. The mention-Inbox card
+    // takes the marker while the Inbox page stands, and stands down while the
+    // embedded Member Session covers that page: the Inbox stays the remembered
+    // face underneath — closing the overlay returns to it, marker included —
+    // but the card is not a second current page while an Agent holds the seat.
+    const overviewIsCurrent = navigationState.channelRef === undefined && navigationState.memberSessionId === undefined && navigationState.inbox !== true;
+    const inboxIsCurrent = navigationState.inbox === true && navigationState.memberSessionId === undefined;
     const [creatingAgents, setCreatingAgents] = useState([]);
     // Rail icons request expansion and name the section to reveal once wide.
     const [pendingSection, setPendingSection] = useState();
     const channelsRef = useRef(null);
     const agentsRef = useRef(null);
     const workspacesOpen = useSidebarSectionOpen(undefined, 'workspaces');
+    // The cross-Workspace Inbox badge: one scope-less subscription while the
+    // Team sidebar stands; every wake re-pulls each Workspace's unread total
+    // (limit 1 — totals cover every row, never the list). Same-burst wakes
+    // coalesce behind a short debounce; the number is whatever the Host's whole
+    // unread slice returns, mentions included rather than alone.
+    const [inboxTotal, setInboxTotal] = useState(0);
+    // One name for both entries: what the control is, and how much waits behind
+    // it. The rail repeats it as its hover hint, which is the only place a reader
+    // still meets the quantity without opening the page.
+    const inboxLabel = inboxTotal > 0 ? t('inboxTitleWithCount', { count: inboxTotal }) : t('inboxTitle');
+    useEffect(() => {
+        let disposed = false;
+        let scheduled;
+        const refresh = async () => {
+            const results = await Promise.all(workspaces.map(workspace => loadInbox({ workspaceId: workspace.workspaceId, limit: 1 })));
+            if (disposed)
+                return;
+            setInboxTotal(results.reduce((sum, result) => result.ok ? sum + result.value.totalUnreadCount : sum, 0));
+        };
+        const schedule = () => {
+            if (scheduled !== undefined)
+                return;
+            scheduled = setTimeout(() => { scheduled = undefined; void refresh(); }, 200);
+        };
+        void refresh();
+        const unsubscribe = subscribeChanges(undefined, update => {
+            if (update.type === 'changed')
+                schedule();
+        });
+        // A durable Thread read consumes this reader's mention markers without a
+        // changes wake (reads change no shared projection), so the badge also
+        // refreshes from every completed read.
+        const unsubscribeReads = subscribeReads(schedule);
+        return () => {
+            disposed = true;
+            if (scheduled !== undefined)
+                clearTimeout(scheduled);
+            unsubscribe();
+            unsubscribeReads();
+        };
+    }, [loadInbox, subscribeChanges, subscribeReads, workspaces]);
     useEffect(() => {
+        // The Inbox page is global and needs no selected Workspace, so the
+        // auto-select must not yank the seat back to a Workspace overview.
+        if (navigationState.inbox === true)
+            return;
         if (navigationState.mode === 'team' && selectedId !== undefined && selectedId !== selected) {
             selectWorkspace(selectedId);
         }
-    }, [navigationState.mode, selected, selectedId, selectWorkspace]);
+    }, [navigationState.inbox, navigationState.mode, selected, selectedId, selectWorkspace]);
     useEffect(() => {
         if (!wide || pendingSection === undefined)
             return;
@@ -37,7 +98,7 @@ export function TeamWorkspaceBrowser({ wide, expandSidebar, navigation, selectWo
         queueMicrotask(() => { node?.querySelector('button')?.focus(); });
     }, [wide, pendingSection]);
     if (!wide) {
-        return _jsxs("nav", { className: css.railWorkspace, "aria-label": t('workspaceSections'), children: [_jsx(Tooltip, { label: t('channels'), side: "right", children: _jsx("button", { type: "button", className: css.railButton, "aria-label": t('channels'), onClick: () => { setPendingSection('channels'); expandSidebar(); }, children: _jsx(IconListPenOutline16, { size: 16 }) }) }), _jsx(Tooltip, { label: t('agents'), side: "right", children: _jsx("button", { type: "button", className: css.railButton, "aria-label": t('agents'), onClick: () => { setPendingSection('agents'); expandSidebar(); }, children: _jsx(IconAgentPresetOutline16, { size: 16 }) }) })] });
+        return _jsxs("nav", { className: css.railWorkspace, "aria-label": t('workspaceSections'), children: [_jsx(Tooltip, { label: inboxLabel, side: "right", children: _jsx("button", { type: "button", className: css.railButton, "aria-label": inboxLabel, "aria-current": inboxIsCurrent ? 'page' : undefined, onClick: () => { selectInbox(); expandSidebar(); }, children: _jsx(InboxMark, { unread: inboxTotal }) }) }), _jsx(Tooltip, { label: t('channels'), side: "right", children: _jsx("button", { type: "button", className: css.railButton, "aria-label": t('channels'), onClick: () => { setPendingSection('channels'); expandSidebar(); }, children: _jsx(IconListPenOutline16, { size: 16 }) }) }), _jsx(Tooltip, { label: t('agents'), side: "right", children: _jsx("button", { type: "button", className: css.railButton, "aria-label": t('agents'), onClick: () => { setPendingSection('agents'); expandSidebar(); }, children: _jsx(IconAgentPresetOutline16, { size: 16 }) }) })] });
     }
-    return _jsxs("section", { className: css.workspaceBrowser, "aria-label": t('workspaces'), children: [_jsx(TeamSidebarSection, { title: t('workspaces'), open: workspacesOpen, onToggle: open => { setSidebarSectionOpen(undefined, 'workspaces', open); }, children: _jsxs("div", { className: css.workspaceList, children: [workspaces.map(workspace => _jsx(TeamWorkspaceRow, { workspaceId: workspace.workspaceId, title: workspace.title, path: workspace.path, selected: workspace.workspaceId === selectedId, current: workspace.workspaceId === selectedId && overviewIsCurrent, onSelect: selectWorkspace }, workspace.workspaceId)), workspaces.length === 0 && _jsx("p", { className: css.emptyState, children: t('empty') })] }) }), selectedId !== undefined && _jsxs("div", { className: css.workspaceSection, children: [_jsx("div", { ref: channelsRef, children: _jsx(TeamChannelsPanel, { workspaceId: selectedId, loadMembers: loadMembers, loadChannels: loadChannels, subscribeChanges: subscribeChanges, createChannel: createChannel, updateChannel: updateChannel, archiveChannel: archiveChannel, joinChannel: joinChannel, removeChannelMember: removeChannelMember, creatingAgents: creatingAgents.filter(request => request.workspaceId === selectedId), ...(navigationState.memberSessionId !== undefined || navigationState.channelRef === undefined ? {} : { selectedChannelRef: navigationState.channelRef }), selectChannel: selectChannel, t: t }, selectedId) }), _jsx("div", { ref: agentsRef, children: _jsx(TeamAgentsPanel, { workspaceId: selectedId, loadMembers: loadMembers, subscribeChanges: subscribeChanges, addMember: addMember, updateMember: updateMember, recoverMember: recoverMember, archiveMember: archiveMember, loadModels: loadModels, ...(navigationState.memberSessionId === undefined ? {} : { memberSessionId: navigationState.memberSessionId }), openMemberSession: openMemberSession, onCreatingChange: (request, creating) => { setCreatingAgents(current => creating ? [...current.filter(item => item.requestId !== request.requestId), request] : current.filter(item => item.requestId !== request.requestId)); }, t: t }, selectedId) })] })] });
+    return _jsxs("section", { className: css.workspaceBrowser, "aria-label": t('workspaces'), children: [_jsxs("button", { type: "button", className: css.inboxCard, "aria-label": inboxLabel, "aria-current": inboxIsCurrent ? 'page' : undefined, onClick: selectInbox, children: [_jsx(InboxMark, { unread: inboxTotal }), _jsx("span", { className: css.inboxCardLabel, children: t('inboxTitle') })] }), _jsx(TeamSidebarSection, { title: t('workspaces'), open: workspacesOpen, onToggle: open => { setSidebarSectionOpen(undefined, 'workspaces', open); }, children: _jsxs("div", { className: css.workspaceList, children: [workspaces.map(workspace => _jsx(TeamWorkspaceRow, { workspaceId: workspace.workspaceId, title: workspace.title, path: workspace.path, selected: workspace.workspaceId === selectedId, current: workspace.workspaceId === selectedId && overviewIsCurrent, onSelect: selectWorkspace }, workspace.workspaceId)), workspaces.length === 0 && _jsx("p", { className: css.emptyState, children: t('empty') })] }) }), selectedId !== undefined && _jsxs("div", { className: css.workspaceSection, children: [_jsx("div", { ref: channelsRef, children: _jsx(TeamChannelsPanel, { workspaceId: selectedId, loadMembers: loadMembers, loadChannels: loadChannels, subscribeChanges: subscribeChanges, createChannel: createChannel, updateChannel: updateChannel, archiveChannel: archiveChannel, joinChannel: joinChannel, removeChannelMember: removeChannelMember, creatingAgents: creatingAgents.filter(request => request.workspaceId === selectedId), ...(navigationState.memberSessionId !== undefined || navigationState.channelRef === undefined ? {} : { selectedChannelRef: navigationState.channelRef }), selectChannel: selectChannel, t: t }, selectedId) }), _jsx("div", { ref: agentsRef, children: _jsx(TeamAgentsPanel, { workspaceId: selectedId, loadMembers: loadMembers, subscribeChanges: subscribeChanges, addMember: addMember, updateMember: updateMember, recoverMember: recoverMember, archiveMember: archiveMember, loadModels: loadModels, ...(navigationState.memberSessionId === undefined ? {} : { memberSessionId: navigationState.memberSessionId }), openMemberSession: openMemberSession, onCreatingChange: (request, creating) => { setCreatingAgents(current => creating ? [...current.filter(item => item.requestId !== request.requestId), request] : current.filter(item => item.requestId !== request.requestId)); }, t: t }, selectedId) })] })] });
 }

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;AAoCnE,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;AAED,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;AAmLD,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;AAoCnE,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;AAED,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;AA6LD,wBAAsB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAI7D"}

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

@@ -1,9 +1,9 @@
-import agentTeamRemote from '../../../agent-team/lib/typert.remote-client.js';
+import agentTeamRemote from '@wowyuarm/dsh-agent-team/remote';
 import { TeamNavigation } from "./navigation.js";
-import { TeamChangeStream } from "./team-changes.js";
+import { TeamChangeStream, TeamReadStream } from "./team-changes.js";
 import { TeamDraftStore } from "./drafts.js";
 import { TeamFooterAction } from "./TeamFooterAction.js";
-import { TeamSettings } from "./TeamSettings.js";
+import { TeamMembersAction } from "./TeamMembersAction.js";
 import { TeamConversation } from "./TeamConversation.js";
 import { TeamWorkspaceBrowser } from "./TeamWorkspaceBrowser.js";
 import { en, zh } from "./locales.js";
@@ -12,7 +12,7 @@ const NS = 'team';
 export const inject = [
     'slots', 'workspaces', 'locale', 'remote', 'remote.session', 'sessions', 'connection', 'conversation',
 ];
-function registerModeShadow(ctx, navigation, changes, drafts, name, component, extraInject, 
+function registerModeShadow(ctx, navigation, changes, reads, drafts, name, component, extraInject, 
 // Keyed seats (`main`) address one panel by key; the reserved 'conversation'
 // key is where the shipped Conversation registers, so the Team seat shadows
 // that same panel instead of adding a second one.
@@ -33,6 +33,8 @@ entryKey) {
     // Remote bindings shared by every Team slot; surface-specific entries extend it below.
     const sharedRemotes = {
         loadChannels: (request) => ctx.remote.agentTeam.view(request),
+        loadInbox: (request) => ctx.remote.agentTeam.inbox(request),
+        subscribeReads: (listener) => reads.subscribe(listener),
         subscribeChanges: (scope, listener) => changes.subscribe(scope, listener),
         drafts,
         loadMembers: (request) => ctx.remote.agentTeam.members(request),
@@ -68,7 +70,15 @@ entryKey) {
                         ...navigation.actions(),
                         ...sharedRemotes,
                         ...(name === 'main' ? {
-                            readThread: (request) => ctx.remote.agentTeam.readThread(request),
+                            // A committed durable read consumes this reader's mention
+                            // markers; the Host's changes stream never wakes on reads, so
+                            // the Human's badge refreshes from the completed read itself.
+                            readThread: async (request) => {
+                                const result = await ctx.remote.agentTeam.readThread(request);
+                                if (result.ok)
+                                    reads.bump();
+                                return result;
+                            },
                             loadThreadHistory: (request) => ctx.remote.agentTeam.threadHistory(request),
                             threadObservations: (request) => ctx.remote.agentTeam.threadObservations(request),
                             sendMessage: (request) => ctx.remote.agentTeam.sendMessage(request),
@@ -143,6 +153,7 @@ function applyUi(ctx) {
         };
     }, 'agent-team: member session restore');
     const changes = new TeamChangeStream((request, signal) => ctx.remote.agentTeam.changes(request, signal));
+    const reads = new TeamReadStream();
     const loadMemberGroups = async () => {
         const workspaces = ctx.workspaces.list.getSnapshot().items;
         const groups = await Promise.all(workspaces.map(async (workspace) => {
@@ -172,12 +183,11 @@ function applyUi(ctx) {
                 navigation.actions().exitMemberSession();
                 navigation.actions().leaveTeam();
             },
-            loadMemberGroups,
         }),
     }, TeamFooterAction));
-    registerModeShadow(ctx, navigation, changes, drafts, 'sidebar.workspaces', TeamWorkspaceBrowser);
-    registerModeShadow(ctx, navigation, changes, drafts, 'main', TeamConversation, undefined, 'conversation');
-    registerModeShadow(ctx, navigation, changes, drafts, 'sidebar.settings', TeamSettings, () => ({ loadMemberGroups }));
+    registerModeShadow(ctx, navigation, changes, reads, drafts, 'sidebar.workspaces', TeamWorkspaceBrowser);
+    registerModeShadow(ctx, navigation, changes, reads, drafts, 'main', TeamConversation, undefined, 'conversation');
+    registerModeShadow(ctx, navigation, changes, reads, drafts, 'sidebar.settings', TeamMembersAction, () => ({ loadMemberGroups }));
 }
 export async function apply(ctx) {
     const disposeRemote = await ctx.remote.$mount(agentTeamRemote);

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

@@ -27,6 +27,20 @@ export declare const zh: {
     readonly statusError: "错误";
     readonly statusUnavailable: "不可用";
     readonly addChannel: "新建频道";
+    readonly inboxTitle: "收件箱";
+    readonly inboxTitleWithCount: "收件箱，{count} 条未读";
+    readonly loadingInbox: "正在加载收件箱…";
+    readonly inboxEmptyTitle: "收件箱是空的";
+    readonly inboxEmptyHint: "你参与的 Thread 有新活动、或有人提到你时，会出现在这里";
+    readonly inboxTimeYesterday: "昨天";
+    readonly inboxHeaderThreads: "{count} 个 Thread";
+    readonly inboxHeaderUnread: "{count} 条未读";
+    readonly inboxHeaderMentions: "{count} 条提及";
+    readonly inboxRowUnread: "{count} 条未读";
+    readonly inboxRowUnreadMentions: "{count} 条未读，其中 {mentions} 条提及";
+    readonly inboxRowActor: "最新来自 {name}";
+    readonly inboxSectionNeedsMe: "需要我";
+    readonly inboxSectionRecent: "最近活跃";
     readonly channelName: "名称";
     readonly channelDescription: "说明";
     readonly initialMembers: "初始成员";
@@ -40,6 +54,7 @@ export declare const zh: {
     readonly resumeAgent: "恢复";
     readonly restartAgent: "重启";
     readonly restartStillUnavailable: "重启已执行，成员仍不可用：{diagnostic}";
+    readonly restartRefusedNoRestart: "会话日志被确定拒绝，修复无可用项，重启无法解决：{detail}";
     readonly restartFailed: "重启执行失败：{message}";
     readonly archiveAgent: "归档";
     readonly archiveAgentTitle: "归档 Agent：{name}";
@@ -91,12 +106,16 @@ export declare const zh: {
     readonly taskStatusInReview: "待验收";
     readonly taskStatusDone: "已完成";
     readonly taskStatusClosed: "已关闭";
-    readonly taskMessageCount: "{count} 条消息";
     readonly taskLabel: "Task #{number}";
     readonly taskPending: "Task …";
     readonly openTask: "打开 Task #{number}";
     readonly openThread: "打开讨论";
+    readonly openTaskUnread: "打开 Task #{number}（{count} 条新动态）";
+    readonly openThreadUnread: "打开讨论（{count} 条新动态）";
     readonly threadLabel: "讨论";
+    readonly recentActivity: "最近活动 {time}";
+    readonly replyAction: "回复";
+    readonly claimers: "由 {names} 处理";
     readonly asTask: "作为任务";
     readonly promoteToTask: "转为 Task";
     readonly promotingTask: "正在转为 Task…";
@@ -175,6 +194,20 @@ export declare const en: {
     readonly statusError: "Error";
     readonly statusUnavailable: "Unavailable";
     readonly addChannel: "New Channel";
+    readonly inboxTitle: "Inbox";
+    readonly inboxTitleWithCount: "Inbox, {count} unread";
+    readonly loadingInbox: "Loading Inbox…";
+    readonly inboxEmptyTitle: "Your Inbox is empty";
+    readonly inboxEmptyHint: "Threads you take part in appear here when they have new activity or mention you";
+    readonly inboxTimeYesterday: "Yesterday";
+    readonly inboxHeaderThreads: "{count} Thread(s)";
+    readonly inboxHeaderUnread: "{count} unread";
+    readonly inboxHeaderMentions: "{count} mention(s)";
+    readonly inboxRowUnread: "{count} unread";
+    readonly inboxRowUnreadMentions: "{count} unread, {mentions} mention(s)";
+    readonly inboxRowActor: "Latest from {name}";
+    readonly inboxSectionNeedsMe: "Needs me";
+    readonly inboxSectionRecent: "Recently active";
     readonly channelName: "Name";
     readonly channelDescription: "Description";
     readonly initialMembers: "Initial members";
@@ -188,6 +221,7 @@ 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}";
@@ -239,12 +273,16 @@ export declare const en: {
     readonly taskStatusInReview: "In review";
     readonly taskStatusDone: "Done";
     readonly taskStatusClosed: "Closed";
-    readonly taskMessageCount: "{count} messages";
     readonly taskLabel: "Task #{number}";
     readonly taskPending: "Task …";
     readonly openTask: "Open Task #{number}";
     readonly openThread: "Open thread";
+    readonly openTaskUnread: "Open Task #{number} ({count} new updates)";
+    readonly openThreadUnread: "Open thread ({count} new updates)";
     readonly threadLabel: "Thread";
+    readonly recentActivity: "Last activity {time}";
+    readonly replyAction: "Reply";
+    readonly claimers: "Handled by {names}";
     readonly asTask: "As task";
     readonly promoteToTask: "Convert to Task";
     readonly promotingTask: "Converting to Task…";

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmJL,CAAA;AAEV,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmJL,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsKL,CAAA;AAEV,eAAO,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsKL,CAAA;AAEV,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,EAAE,CAAA"}

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

@@ -27,6 +27,20 @@ export const zh = {
     statusError: '错误',
     statusUnavailable: '不可用',
     addChannel: '新建频道',
+    inboxTitle: '收件箱',
+    inboxTitleWithCount: '收件箱，{count} 条未读',
+    loadingInbox: '正在加载收件箱…',
+    inboxEmptyTitle: '收件箱是空的',
+    inboxEmptyHint: '你参与的 Thread 有新活动、或有人提到你时，会出现在这里',
+    inboxTimeYesterday: '昨天',
+    inboxHeaderThreads: '{count} 个 Thread',
+    inboxHeaderUnread: '{count} 条未读',
+    inboxHeaderMentions: '{count} 条提及',
+    inboxRowUnread: '{count} 条未读',
+    inboxRowUnreadMentions: '{count} 条未读，其中 {mentions} 条提及',
+    inboxRowActor: '最新来自 {name}',
+    inboxSectionNeedsMe: '需要我',
+    inboxSectionRecent: '最近活跃',
     channelName: '名称',
     channelDescription: '说明',
     initialMembers: '初始成员',
@@ -40,6 +54,7 @@ export const zh = {
     resumeAgent: '恢复',
     restartAgent: '重启',
     restartStillUnavailable: '重启已执行，成员仍不可用：{diagnostic}',
+    restartRefusedNoRestart: '会话日志被确定拒绝，修复无可用项，重启无法解决：{detail}',
     restartFailed: '重启执行失败：{message}',
     archiveAgent: '归档',
     archiveAgentTitle: '归档 Agent：{name}',
@@ -91,12 +106,16 @@ export const zh = {
     taskStatusInReview: '待验收',
     taskStatusDone: '已完成',
     taskStatusClosed: '已关闭',
-    taskMessageCount: '{count} 条消息',
     taskLabel: 'Task #{number}',
     taskPending: 'Task …',
     openTask: '打开 Task #{number}',
     openThread: '打开讨论',
+    openTaskUnread: '打开 Task #{number}（{count} 条新动态）',
+    openThreadUnread: '打开讨论（{count} 条新动态）',
     threadLabel: '讨论',
+    recentActivity: '最近活动 {time}',
+    replyAction: '回复',
+    claimers: '由 {names} 处理',
     asTask: '作为任务',
     promoteToTask: '转为 Task',
     promotingTask: '正在转为 Task…',
@@ -175,6 +194,20 @@ export const en = {
     statusError: 'Error',
     statusUnavailable: 'Unavailable',
     addChannel: 'New Channel',
+    inboxTitle: 'Inbox',
+    inboxTitleWithCount: 'Inbox, {count} unread',
+    loadingInbox: 'Loading Inbox…',
+    inboxEmptyTitle: 'Your Inbox is empty',
+    inboxEmptyHint: 'Threads you take part in appear here when they have new activity or mention you',
+    inboxTimeYesterday: 'Yesterday',
+    inboxHeaderThreads: '{count} Thread(s)',
+    inboxHeaderUnread: '{count} unread',
+    inboxHeaderMentions: '{count} mention(s)',
+    inboxRowUnread: '{count} unread',
+    inboxRowUnreadMentions: '{count} unread, {mentions} mention(s)',
+    inboxRowActor: 'Latest from {name}',
+    inboxSectionNeedsMe: 'Needs me',
+    inboxSectionRecent: 'Recently active',
     channelName: 'Name',
     channelDescription: 'Description',
     initialMembers: 'Initial members',
@@ -188,6 +221,7 @@ 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}',
@@ -239,12 +273,16 @@ export const en = {
     taskStatusInReview: 'In review',
     taskStatusDone: 'Done',
     taskStatusClosed: 'Closed',
-    taskMessageCount: '{count} messages',
     taskLabel: 'Task #{number}',
     taskPending: 'Task …',
     openTask: 'Open Task #{number}',
     openThread: 'Open thread',
+    openTaskUnread: 'Open Task #{number} ({count} new updates)',
+    openThreadUnread: 'Open thread ({count} new updates)',
     threadLabel: 'Thread',
+    recentActivity: 'Last activity {time}',
+    replyAction: 'Reply',
+    claimers: 'Handled by {names}',
     asTask: 'As task',
     promoteToTask: 'Convert to Task',
     promotingTask: 'Converting to Task…',

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

@@ -9,6 +9,12 @@ export interface TeamNavigationSnapshot {
     taskRef?: AgentTeamTaskRef;
     threadRef?: AgentTeamThreadRef;
     taskNumber?: number;
+    /**
+     * Durable position of the Human mention-Inbox page (a navigation fact, not
+     * an unread fact): selecting Inbox clears the Channel/Thread faces, and a
+     * reload reopens the page. Read markers only move through Thread reads.
+     */
+    inbox?: boolean;
     /** Runtime-only Member Session embedded in the conversation seat; never persisted. */
     memberSessionId?: SessionId;
     /** Runtime-only session to restore when the Member view closes; never persisted. */
@@ -21,6 +27,8 @@ export interface TeamNavigationActions {
     selectWorkspace: (workspaceId: WorkspaceId) => void;
     selectChannel: (channelRef: AgentTeamChannelRef) => void;
     selectThread: (threadRef: AgentTeamThreadRef, channelRef?: AgentTeamChannelRef, taskRef?: AgentTeamTaskRef, taskNumber?: number) => void;
+    /** Open the Human mention-Inbox page; clears the Channel/Thread faces. */
+    selectInbox: () => void;
     backToWorkspace: () => void;
     /** Leave the selected Channel for the workspace Channel list; keeps mode and Workspace. */
     backToChannels: () => void;
@@ -47,6 +55,8 @@ export declare class TeamNavigation {
     private clearMemberSession;
     private setWorkspace;
     private setChannel;
+    /** The Inbox is a face, not workspace content: selecting a Workspace leaves it. */
+    private setInbox;
     private clearChannel;
     private setThread;
     private commit;

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

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/client/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAE/G,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,MAAM,CAAA;AAE9C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAA;IACd,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAA;IAChC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sFAAsF;IACtF,eAAe,CAAC,EAAE,SAAS,CAAA;IAC3B,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,SAAS,CAAA;CAC9B;AAED,QAAA,MAAM,WAAW,8BAA8B,CAAA;AAuC/C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,eAAe,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAA;IACnD,aAAa,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACxD,YAAY,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACxI,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,2FAA2F;IAC3F,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;IACjF,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED,4EAA4E;AAC5E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,QAAQ,CAAC,WAAW,QAAO,sBAAsB,CAAiB;IAElE,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGxD;IAED,OAAO,IAAI,qBAAqB;IAchC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,gBAAgB;IAaxB,6EAA6E;IAC7E,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,MAAM;CAKf;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/client/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAE/G,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,MAAM,CAAA;AAE9C,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAA;IACd,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAA;IAChC,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,CAAC,EAAE,kBAAkB,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sFAAsF;IACtF,eAAe,CAAC,EAAE,SAAS,CAAA;IAC3B,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,SAAS,CAAA;CAC9B;AAED,QAAA,MAAM,WAAW,8BAA8B,CAAA;AAyC/C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,eAAe,EAAE,CAAC,WAAW,EAAE,WAAW,KAAK,IAAI,CAAA;IACnD,aAAa,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,IAAI,CAAA;IACxD,YAAY,EAAE,CAAC,SAAS,EAAE,kBAAkB,EAAE,UAAU,CAAC,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACxI,0EAA0E;IAC1E,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,2FAA2F;IAC3F,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;OAIG;IACH,kBAAkB,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,EAAE,SAAS,KAAK,IAAI,CAAA;IACjF,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED,4EAA4E;AAC5E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAElD,QAAQ,CAAC,WAAW,QAAO,sBAAsB,CAAiB;IAElE,QAAQ,CAAC,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGxD;IAED,OAAO,IAAI,qBAAqB;IAehC,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,gBAAgB;IAaxB,6EAA6E;IAC7E,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,UAAU;IAOlB,mFAAmF;IACnF,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,SAAS;IAkBjB,OAAO,CAAC,MAAM;CAKf;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

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

@@ -9,6 +9,7 @@ function readSnapshot() {
             mode: parsed.mode === 'team' ? 'team' : 'conversation',
             ...(typeof parsed.workspaceId === 'string' ? { workspaceId: parsed.workspaceId } : {}),
             ...(typeof parsed.channelRef === 'string' ? { channelRef: parsed.channelRef } : {}),
+            ...(parsed.inbox === true ? { inbox: true } : {}),
             ...(hasThread ? {
                 threadRef: parsed.threadRef,
                 ...(typeof parsed.taskRef === 'string' ? { taskRef: parsed.taskRef } : {}),
@@ -24,11 +25,12 @@ function persistSnapshot(snapshot) {
     if (typeof localStorage === 'undefined')
         return;
     try {
-        const { mode, workspaceId, channelRef, taskRef, threadRef, taskNumber } = snapshot;
+        const { mode, workspaceId, channelRef, taskRef, threadRef, taskNumber, inbox } = snapshot;
         localStorage.setItem(STORAGE_KEY, JSON.stringify({
             mode,
             ...(workspaceId === undefined ? {} : { workspaceId }),
             ...(channelRef === undefined ? {} : { channelRef }),
+            ...(inbox === true ? { inbox: true } : {}),
             ...(taskRef === undefined ? {} : { taskRef }),
             ...(threadRef === undefined ? {} : { threadRef }),
             ...(taskNumber === undefined ? {} : { taskNumber }),
@@ -54,6 +56,7 @@ export class TeamNavigation {
             selectWorkspace: workspaceId => { this.clearMemberSession(); this.setWorkspace(workspaceId); },
             selectChannel: channelRef => { this.clearMemberSession(); this.setChannel(channelRef); },
             selectThread: (threadRef, channelRef, taskRef, taskNumber) => { this.clearMemberSession(); this.setThread(threadRef, channelRef, taskRef, taskNumber); },
+            selectInbox: () => { this.clearMemberSession(); this.setInbox(); },
             backToWorkspace: () => { this.clearMemberSession(); this.setThread(undefined); },
             backToChannels: () => { this.clearMemberSession(); this.clearChannel(); },
             enterMemberSession: (sessionId, returnToSessionId) => { this.setMemberSession(sessionId, returnToSessionId); },
@@ -91,19 +94,27 @@ export class TeamNavigation {
         this.commit();
     }
     setWorkspace(workspaceId) {
-        if (this.snapshot.workspaceId === workspaceId)
+        if (this.snapshot.workspaceId === workspaceId && this.snapshot.inbox !== true)
             return;
-        const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+        const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, inbox: _inbox, ...base } = this.snapshot;
         this.snapshot = { ...base, workspaceId };
         this.commit();
     }
     setChannel(channelRef) {
-        if (this.snapshot.channelRef === channelRef && this.snapshot.threadRef === undefined)
+        if (this.snapshot.channelRef === channelRef && this.snapshot.threadRef === undefined && this.snapshot.inbox !== true)
             return;
-        const { taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+        const { taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, inbox: _inbox, ...base } = this.snapshot;
         this.snapshot = { ...base, channelRef };
         this.commit();
     }
+    /** The Inbox is a face, not workspace content: selecting a Workspace leaves it. */
+    setInbox() {
+        if (this.snapshot.inbox === true && this.snapshot.channelRef === undefined && this.snapshot.threadRef === undefined)
+            return;
+        const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+        this.snapshot = { ...base, inbox: true };
+        this.commit();
+    }
     clearChannel() {
         const { channelRef: _channelRef, ...base } = this.snapshot;
         if (this.snapshot.channelRef === undefined)
@@ -112,14 +123,14 @@ export class TeamNavigation {
         this.commit();
     }
     setThread(threadRef, channelRef, taskRef, taskNumber) {
-        if (this.snapshot.threadRef === threadRef && this.snapshot.taskRef === taskRef && this.snapshot.channelRef === channelRef && this.snapshot.taskNumber === taskNumber)
+        if (this.snapshot.threadRef === threadRef && this.snapshot.taskRef === taskRef && this.snapshot.channelRef === channelRef && this.snapshot.taskNumber === taskNumber && this.snapshot.inbox !== true)
             return;
         if (threadRef === undefined) {
             const { taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
             this.snapshot = base;
         }
         else {
-            const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, ...base } = this.snapshot;
+            const { channelRef: _channelRef, taskRef: _taskRef, threadRef: _threadRef, taskNumber: _taskNumber, inbox: _inbox, ...base } = this.snapshot;
             this.snapshot = {
                 ...base,
                 threadRef,

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

@@ -0,0 +1,41 @@
+/** The change scopes whose wakes one surface answers with a shared refresh round. */
+export type SupplementalScope = 'workspace' | 'presence';
+/** One change wake, carrying a version from the scope that issued it. */
+export interface ScopeWake {
+    readonly scope: SupplementalScope;
+    readonly version: number;
+}
+/**
+ * Per-scope coverage of the change versions one surface has already answered.
+ *
+ * A version is only comparable inside the scope that issued it: the Host
+ * answers a workspace scope from the durable ledger position and a presence
+ * scope from its process-local wake epoch, which starts low and climbs on every
+ * Agent transition. One high-water mark shared by both would therefore let a
+ * presence epoch swallow a later, smaller ledger sequence and park the surface
+ * on stale data, so coverage and pending versions are kept per scope.
+ *
+ * One round answers one version per scope. The Host delivers one event to every
+ * matching scope, so the first version a round sees in a scope it has not
+ * answered yet is that event reaching a second scope, and joins the round
+ * already fetching instead of earning a second identical read. A newer version
+ * in a scope the round has answered arrived after the round issued its fetch,
+ * so it owes one trailing round.
+ */
+export declare class ScopeCoverage {
+    private readonly covered;
+    private readonly pending;
+    /** The scopes the open round has an answer for. */
+    private readonly answered;
+    private fetching;
+    /** Folds one wake in and answers whether it opens a round. */
+    wake(scope: SupplementalScope, version: number): boolean;
+    /** Opens a round's fetch window; versions observed from here on are pending. */
+    beginRound(): void;
+    /** Closes a round's fetch window and answers whether a trailing round is owed. */
+    finishRound(): boolean;
+    /** Drops every observation: a new owner starts with nothing covered. */
+    reset(): void;
+    private coveredOf;
+}
+//# sourceMappingURL=scope-coverage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope-coverage.d.ts","sourceRoot":"","sources":["../../../src/client/scope-coverage.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,UAAU,CAAA;AAExD,yEAAyE;AACzE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAQ;IAExB,8DAA8D;IAC9D,IAAI,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAWxD,gFAAgF;IAChF,UAAU,IAAI,IAAI;IAKlB,kFAAkF;IAClF,WAAW,IAAI,OAAO;IAYtB,wEAAwE;IACxE,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,SAAS;CAGlB"}

package/packages/client-agent-team/lib/types/client/scope-coverage.js

@@ -0,0 +1,64 @@
+/**
+ * Per-scope coverage of the change versions one surface has already answered.
+ *
+ * A version is only comparable inside the scope that issued it: the Host
+ * answers a workspace scope from the durable ledger position and a presence
+ * scope from its process-local wake epoch, which starts low and climbs on every
+ * Agent transition. One high-water mark shared by both would therefore let a
+ * presence epoch swallow a later, smaller ledger sequence and park the surface
+ * on stale data, so coverage and pending versions are kept per scope.
+ *
+ * One round answers one version per scope. The Host delivers one event to every
+ * matching scope, so the first version a round sees in a scope it has not
+ * answered yet is that event reaching a second scope, and joins the round
+ * already fetching instead of earning a second identical read. A newer version
+ * in a scope the round has answered arrived after the round issued its fetch,
+ * so it owes one trailing round.
+ */
+export class ScopeCoverage {
+    covered = new Map();
+    pending = new Map();
+    /** The scopes the open round has an answer for. */
+    answered = new Set();
+    fetching = false;
+    /** Folds one wake in and answers whether it opens a round. */
+    wake(scope, version) {
+        if (version <= this.coveredOf(scope))
+            return false;
+        if (this.fetching && this.answered.has(scope)) {
+            this.pending.set(scope, Math.max(this.pending.get(scope) ?? 0, version));
+            return false;
+        }
+        this.answered.add(scope);
+        this.covered.set(scope, version);
+        return !this.fetching;
+    }
+    /** Opens a round's fetch window; versions observed from here on are pending. */
+    beginRound() {
+        this.pending.clear();
+        this.fetching = true;
+    }
+    /** Closes a round's fetch window and answers whether a trailing round is owed. */
+    finishRound() {
+        this.fetching = false;
+        this.answered.clear();
+        let owed = false;
+        for (const [scope, version] of this.pending) {
+            if (version <= this.coveredOf(scope))
+                continue;
+            this.covered.set(scope, version);
+            owed = true;
+        }
+        return owed;
+    }
+    /** Drops every observation: a new owner starts with nothing covered. */
+    reset() {
+        this.covered.clear();
+        this.pending.clear();
+        this.answered.clear();
+        this.fetching = false;
+    }
+    coveredOf(scope) {
+        return this.covered.get(scope) ?? 0;
+    }
+}