@wowyuarm/dsh-agent-team 0.1.12 → 0.1.13

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

@@ -42,23 +42,21 @@ export interface MentionSegment {
     readonly name?: string;
 }
 /**
- * Locate one Message's structured mention names inside its literal body. A
- * name matches case-insensitively with an optional leading '@' on Unicode word
- * boundaries, and longer names win at the same position. Mention segments
- * render the canonical `@Handle`; names absent from the body come back
- * unmatched so the consumer can append them as a fallback chip row.
+ * Locate one Message's delivered mention names inside its literal body. Matching
+ * is the shared Host delivery scan — an authored `@`, case-insensitive on Unicode
+ * word boundaries, longest handle first, code quoted rather than called — so a chip
+ * never lands where delivery would not reach. Mention segments render the canonical
+ * `@Handle`; names absent from the body come back unmatched so the consumer can
+ * append them as a fallback chip row.
  */
 export declare function splitMentionNames(text: string, names: readonly string[]): {
     segments: MentionSegment[];
     unmatched: readonly string[];
 };
 /**
- * Whether one draft spells a handle as an authored `@mention`: a literal `@`
- * before the handle, case-insensitively, on Unicode word boundaries. The Host
- * resolves delivery from the same text with its own scanner, so this is the
- * Client's single answer to "did the author call this name" — the composer
- * prunes picked recipients with it and previews the draft's notifications with
- * it.
+ * Whether one draft spells a handle as an authored `@mention`: the shared
+ * delivery scan, so the composer's recipient prune and will-notify preview agree
+ * with the Host on what the draft actually calls.
  */
 export declare function containsMention(body: string, handle: string): boolean;
 /** Whether one draft carries the `@all` marker the mention menu expands. */
@@ -84,6 +82,10 @@ export declare function allMentionMembers(members: readonly AgentTeamClientMembe
 export declare function mentionedMemberIds(body: string, members: readonly AgentTeamClientMemberStatus[]): readonly AgentTeamMemberId[];
 /** Canonical chip handles for one Message's structured mention refs. */
 export declare function mentionNamesOf(mentions: readonly AgentTeamMemberId[], handles: ReadonlyMap<AgentTeamMemberId, string>): string[];
+/** Accessible label for one "who is on this work" stack: its owners' handles, comma-separated. */
+export declare function claimersLabel(owners: ReadonlyArray<{
+    readonly name: string;
+}>, t: TeamConversationProps['t']): string;
 /**
  * Whether an Agent body survives literal rendering unchanged: no fences,
  * inline code, emphasis markers, links, images, tables, or block constructs.

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

@@ -1 +1 @@
-{"version":3,"file":"team-formatters.d.ts","sourceRoot":"","sources":["../../../src/client/team-formatters.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"team-formatters.d.ts","sourceRoot":"","sources":["../../../src/client/team-formatters.ts"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,4 @@
+import { hasAllMarker, resolveBodyMentions, scanBodyHandles } from '@wowyuarm/dsh-agent-team/mentions';
 export function formatTaskStatus(status, t) {
     return t({
         todo: 'taskStatusTodo',
@@ -81,56 +82,42 @@ export function isSingleBrandedRef(text) {
     const matches = [...trimmed.matchAll(BRANDED_REF_PATTERN)];
     return matches.length === 1 && matches[0][0] === trimmed;
 }
-function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
 /**
- * Locate one Message's structured mention names inside its literal body. A
- * name matches case-insensitively with an optional leading '@' on Unicode word
- * boundaries, and longer names win at the same position. Mention segments
- * render the canonical `@Handle`; names absent from the body come back
- * unmatched so the consumer can append them as a fallback chip row.
+ * Locate one Message's delivered mention names inside its literal body. Matching
+ * is the shared Host delivery scan — an authored `@`, case-insensitive on Unicode
+ * word boundaries, longest handle first, code quoted rather than called — so a chip
+ * never lands where delivery would not reach. Mention segments render the canonical
+ * `@Handle`; names absent from the body come back unmatched so the consumer can
+ * append them as a fallback chip row.
  */
 export function splitMentionNames(text, names) {
     if (names.length === 0)
         return { segments: [{ text, mention: false }], unmatched: [] };
-    const ordered = [...names].sort((left, right) => right.length - left.length);
-    // The lookbehind keeps the optional '@' from consuming the separator of an
-    // email-like occurrence: the character before the name (or before its '@')
-    // must not be a letter, digit, underscore, or another '@'.
-    const pattern = new RegExp(`(?<![\\p{L}\\p{N}_@])@?(?:${ordered.map(name => `(${escapeRegExp(name)})`).join('|')})(?=$|[^\\p{L}\\p{N}_])`, 'giu');
     const segments = [];
     const matched = new Set();
     let cursor = 0;
-    for (const match of text.matchAll(pattern)) {
-        const groupIndex = match.findIndex((group, index) => index >= 1 && group !== undefined);
-        if (groupIndex < 1)
-            continue;
-        if (match.index > cursor)
-            segments.push({ text: text.slice(cursor, match.index), mention: false });
-        const name = ordered[groupIndex - 1];
-        segments.push({ text: `@${name}`, mention: true, name });
-        matched.add(name.toLowerCase());
-        cursor = match.index + match[0].length;
+    for (const match of scanBodyHandles(text, names)) {
+        if (match.start > cursor)
+            segments.push({ text: text.slice(cursor, match.start), mention: false });
+        segments.push({ text: `@${match.handle}`, mention: true, name: match.handle });
+        matched.add(match.handle.toLowerCase());
+        cursor = match.end;
     }
     if (cursor < text.length)
         segments.push({ text: text.slice(cursor), mention: false });
     return { segments, unmatched: names.filter(name => !matched.has(name.toLowerCase())) };
 }
 /**
- * Whether one draft spells a handle as an authored `@mention`: a literal `@`
- * before the handle, case-insensitively, on Unicode word boundaries. The Host
- * resolves delivery from the same text with its own scanner, so this is the
- * Client's single answer to "did the author call this name" — the composer
- * prunes picked recipients with it and previews the draft's notifications with
- * it.
+ * Whether one draft spells a handle as an authored `@mention`: the shared
+ * delivery scan, so the composer's recipient prune and will-notify preview agree
+ * with the Host on what the draft actually calls.
  */
 export function containsMention(body, handle) {
-    return new RegExp(`(?:^|[^\\p{L}\\p{N}_])@${escapeRegExp(handle)}(?=$|[^\\p{L}\\p{N}_])`, 'iu').test(body);
+    return scanBodyHandles(body, [handle]).length > 0;
 }
 /** Whether one draft carries the `@all` marker the mention menu expands. */
 export function containsAllMention(body) {
-    return /(?<![\p{L}\p{N}_@])@all(?=$|[^\p{L}\p{N}_])/u.test(body);
+    return hasAllMarker(body);
 }
 /**
  * Every Member the mention menu's `@all` row stands for: the roster this
@@ -153,12 +140,15 @@ export function allMentionMembers(members) {
  * rather than the prose the Host reads.
  */
 export function mentionedMemberIds(body, members) {
-    if (containsAllMention(body))
+    if (hasAllMarker(body))
         return allMentionMembers(members).map(status => status.member.memberId);
-    return members
+    const candidates = members
         .filter(status => status.member.state !== 'inactive' && status.member.state !== 'archived')
-        .filter(status => containsMention(body, status.member.handle))
-        .map(status => status.member.memberId);
+        .map(status => ({ memberId: status.member.memberId, handle: status.member.handle }));
+    // The draft's author is the Human reader, and a Message never mentions its
+    // own author: resolving with that sender drops a self-call exactly where
+    // delivery would.
+    return resolveBodyMentions(body, candidates, 'member:human').memberIds;
 }
 /** Canonical chip handles for one Message's structured mention refs. */
 export function mentionNamesOf(mentions, handles) {
@@ -168,6 +158,10 @@ export function mentionNamesOf(mentions, handles) {
         .map(memberId => memberId === 'member:human' ? 'human' : handles.get(memberId))
         .filter((name) => name !== undefined);
 }
+/** Accessible label for one "who is on this work" stack: its owners' handles, comma-separated. */
+export function claimersLabel(owners, t) {
+    return t('claimers', { names: owners.map(owner => `@${owner.name}`).join(', ') });
+}
 const MARKDOWN_BLOCK_CONSTRUCT = /(^|\n)[ \t]{0,3}(?:#{1,6}[ \t]|>[ \t]|[-*+][ \t]|\d+[.)][ \t])|^[ \t]*\|.+\|/m;
 const MARKDOWN_INLINE_CONSTRUCT = /[`*_[\]!]|~~~|```/;
 /**

package/packages/tool-agent-team/README.md

@@ -19,7 +19,7 @@ Mentions are authored in the Message body, as `@Handle` (the `@` is required, ma
 
 Every agent-facing render carries absolute event instants in the fixed Team coordination zone UTC+8 with an explicit offset (`2026-09-08T17:00:00+08:00`): `team_thread` fact lines and anchors stamp each fact with its committing operation's instant, `team_inbox` rows carry `newestOccurredAt`, `team_view` Thread rows carry `lastActivityAt`, notifications state `Occurred at:`, and committed mutations render `Committed at:` from the receipt. The same stored instant renders byte-identically on every reread path; only absolute timestamps are rendered, never relative text, and sequence and revision — not wall-clock time — remain the ordering authority.
 
-Canonical results expose stable refs, optional Task status, Thread revision, Claim history, Attention, and unread facts as structured fields. The model-visible renders follow the action decision surface: the write token appears only on a fully drained `team_thread read` and a committed public mutation; browsing results (`team_view`, `team_inbox`, status/follow/unfollow, `history`, `team_claim list`) and all typed rejections render no revision and no token. Typed `unread_required` and `stale_revision` results keep the structured fields needed to reread and retry deliberately. Tool execution resolves the exact live `exec.agent`; arguments cannot select or impersonate the actor or Workspace. Write request identity derives from sessionId plus tool callId. `context_rollover` and `context_checkpoint` conclude the Agent turn (a rollover must not be followed by old-generation work, and a checkpoint resolves at its containing turn's end); every other Team tool returns to the model loop.
+Canonical results expose stable refs, optional Task status, Thread revision, Claim history, Attention, and unread facts as structured fields. The model-visible renders follow the action decision surface: the write token appears only on a fully drained `team_thread read` and a committed public mutation; browsing results (`team_view`, `team_inbox`, status/follow/unfollow, `history`, `team_claim list`) and all typed rejections render no revision and no token. Typed `unread_required` and `stale_revision` results keep the structured fields needed to reread and retry deliberately. Tool execution resolves the exact live `exec.agent`; arguments cannot select or impersonate the actor, and the optional `workspace` selector can only pick among that actor's participated Workspaces. Write request identity derives from sessionId plus tool callId. `context_rollover` and `context_checkpoint` conclude the Agent turn (a rollover must not be followed by old-generation work, and a checkpoint resolves at its containing turn's end); every other Team tool returns to the model loop.
 
 The complete implemented protocol is documented in [`../../docs/team-collaboration.md`](../../docs/team-collaboration.md).
 

package/packages/tool-agent-team/README.zh.md

@@ -19,7 +19,7 @@ mention 在 Message 正文里撰写，形如 `@Handle`（`@` 必需、大小写
 
 所有 agent-facing 渲染都在固定的 Team 协调时区 UTC+8 下携带带显式偏移的绝对事件时刻（`2026-09-08T17:00:00+08:00`）：`team_thread` 的 fact 行与 anchor 为每条 fact 标注其提交 operation 的时刻，`team_inbox` 行携带 `newestOccurredAt`，`team_view` 的 Thread 行携带 `lastActivityAt`，通知给出 `Occurred at:`，已提交变更从 receipt 渲染 `Committed at:`。同一存储时刻在任何重读路径中渲染完全一致；只渲染绝对 timestamp，绝不出现相对时间文案，且 sequence 与 revision——而非 wall-clock 时间——仍是顺序 authority。
 
-Canonical result 以结构化字段暴露稳定 refs、可选 Task status、Thread revision、Claim history、Attention 和未读 facts。模型可见的渲染遵循 action decision surface：写令牌只出现在未读清零的 `team_thread read` 与一次已提交的 public mutation 上；浏览类结果（`team_view`、`team_inbox`、status/follow/unfollow、`history`、`team_claim list`）与所有类型化拒绝都不渲染 revision 与令牌。类型化的 `unread_required` 与 `stale_revision` 结果保留重新读取和审慎重试所需的结构化字段。工具执行通过准确的 live `exec.agent` 解析 actor；参数不能选择或冒充 actor 或 Workspace。写操作的 request identity 由 sessionId 与 tool callId 派生。`context_rollover` 与 `context_checkpoint` 结束 Agent turn；其余 Team tools 将结果返回模型循环，不主动结束 turn。
+Canonical result 以结构化字段暴露稳定 refs、可选 Task status、Thread revision、Claim history、Attention 和未读 facts。模型可见的渲染遵循 action decision surface：写令牌只出现在未读清零的 `team_thread read` 与一次已提交的 public mutation 上；浏览类结果（`team_view`、`team_inbox`、status/follow/unfollow、`history`、`team_claim list`）与所有类型化拒绝都不渲染 revision 与令牌。类型化的 `unread_required` 与 `stale_revision` 结果保留重新读取和审慎重试所需的结构化字段。工具执行通过准确的 live `exec.agent` 解析 actor；参数不能选择或冒充 actor，可选的 `workspace` 选择器只能在该 actor 已参与的 Workspace 中选择。写操作的 request identity 由 sessionId 与 tool callId 派生。`context_rollover` 与 `context_checkpoint` 结束 Agent turn；其余 Team tools 将结果返回模型循环，不主动结束 turn。
 
 完整的已实现协议见 [`../../docs/team-collaboration.md`](../../docs/team-collaboration.md)。
 

package/packages/tool-agent-team/lib/host-access.js

@@ -18,3 +18,22 @@ export function member(agent) {
         throw new Error('team tool requires an active Team Member');
     return current;
 }
+/** A collaboration address, never a cwd or Session switch. */
+export const workspaceParam = {
+    type: 'string',
+    description: 'Target Workspace id exactly as listed in your participation context or team_view. Required when you participate in more than one Workspace; only a sole participation can be inferred. This does not change your Session cwd.',
+};
+/** Reject ambiguous routing before a tool reads facts or attempts a mutation. */
+export function workspaceOf(args, agent) {
+    const workspaces = service(agent).workspacesForAgent(agent);
+    const choices = workspaces.map(workspace => workspace.workspaceId).join(', ');
+    if (args.workspace === undefined) {
+        if (workspaces.length !== 1)
+            throw new Error(`workspace is required when participating in multiple Workspaces. Choose: ${choices}`);
+        return workspaces[0].workspaceId;
+    }
+    const selected = workspaces.find(workspace => workspace.workspaceId === args.workspace);
+    if (selected === undefined)
+        throw new Error(`Not participating in Workspace '${args.workspace}'. Choose: ${choices}`);
+    return selected.workspaceId;
+}

package/packages/tool-agent-team/lib/index.js

@@ -1,7 +1,7 @@
 import { AGENT_TEAM_HUMAN_HANDLE, AgentTeamDmDeliveryError, markAgentTeamPreset } from '@wowyuarm/dsh-agent-team/host';
 import { formatTeamTimestamp } from '@wowyuarm/dsh-agent-team/time-format';
 import { registerContextTools } from "./context-tools.js";
-import { member, service } from "./host-access.js";
+import { service, workspaceOf, workspaceParam } from "./host-access.js";
 import { defineTool } from '@deepseek-ai/dsh-tools';
 export const name = 'wowyuarm-agent-team-tools';
 export const inject = ['tools'];
@@ -114,13 +114,13 @@ function rejectionLines(noun, value) {
 }
 const teamInbox = defineTool({
     name: 'team_inbox',
-    description: 'List your bounded Team Inbox for triage: unread Thread summaries with counts, without message bodies and without marking anything read. Read a selected Thread with team_thread read; the inbox itself authorizes no mutation.',
-    parameters: { limit: { type: 'number' } },
+    description: 'List your bounded Team Inbox across all joined Workspaces for triage: unread Thread summaries with counts, without message bodies and without marking anything read. Read a selected Thread with team_thread read; the inbox itself authorizes no mutation.',
+    parameters: { limit: { type: 'number' }, workspace: { type: 'string', description: 'Optional Workspace id filter. Omit to triage all your participations together.' } },
     output: {
         schema: { type: 'object', additionalProperties: false, properties: {
                 totalUnreadCount: { type: 'number', required: true }, totalDirectCount: { type: 'number', required: true },
                 items: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: {
-                            threadRef: { type: 'string', required: true }, channelRef: { type: 'string', required: true },
+                            workspaceId: { type: 'string', required: true }, threadRef: { type: 'string', required: true }, channelRef: { type: 'string', required: true },
                             taskRef: { type: 'string' }, status: { type: 'string' }, revision: { type: 'number', required: true }, unreadCount: { type: 'number', required: true }, directCount: { type: 'number', required: true },
                             taskNumber: { type: 'number' }, newestOccurredAt: { type: 'string' },
                         } } },
@@ -139,7 +139,7 @@ const teamInbox = defineTool({
             const shown = value.items.reduce((sum, item) => sum + item.unreadCount, 0);
             return [{ type: 'text', text: [
                         `Inbox — ${value.totalUnreadCount} unread update(s) total, ${value.totalDirectCount} direct, across ${value.items.length} Thread(s) shown${value.totalUnreadCount > shown ? `; ${value.totalUnreadCount - shown} more on Threads beyond this bounded list — call again with a larger limit.` : '.'}`,
-                        ...value.items.map(item => `${item.threadRef}${item.channelRef === undefined ? '' : ` · ${item.channelRef}`}${item.taskRef === undefined ? '' : ` · ${taskStanding(item)}`} · ${item.unreadCount} unread, ${item.directCount} direct${item.newestOccurredAt === undefined ? '' : ` · newest ${formatTeamTimestamp(item.newestOccurredAt)}`}`),
+                        ...value.items.map(item => `${item.workspaceId} · ${item.threadRef}${item.channelRef === undefined ? '' : ` · ${item.channelRef}`}${item.taskRef === undefined ? '' : ` · ${taskStanding(item)}`} · ${item.unreadCount} unread, ${item.directCount} direct${item.newestOccurredAt === undefined ? '' : ` · newest ${formatTeamTimestamp(item.newestOccurredAt)}`}`),
                         'Read a selected Thread with team_thread read. Listing changes no read state and supplies no write token.',
                     ].join('\n') }];
         },
@@ -148,16 +148,13 @@ const teamInbox = defineTool({
         const agent = exec.agent;
         if (agent === undefined)
             throw new Error('team_inbox requires an Agent session');
-        const current = member(agent);
         const host = service(agent);
-        const inbox = host.inboxForAgent(agent, { workspaceId: current.workspaceId, ...(args.limit === undefined ? {} : { limit: args.limit }) });
-        const taskNumbers = new Map(host.viewForAgent(agent, { workspaceId: current.workspaceId, topLevelOnly: true, includeActivities: false, direction: 'before' })
-            .taskNumbers.map(entry => [entry.taskRef, entry.taskNumber]));
+        const inbox = host.inboxForAgent(agent, { ...(args.workspace === undefined ? {} : { workspaceId: workspaceOf(args, agent) }), ...(args.limit === undefined ? {} : { limit: args.limit }) });
         return {
             totalUnreadCount: inbox.totalUnreadCount, totalDirectCount: inbox.totalDirectCount,
             items: inbox.items.map(item => {
-                const taskNumber = item.task === undefined ? undefined : taskNumbers.get(item.task.taskRef);
-                return { threadRef: item.thread.threadRef, channelRef: item.channelRef,
+                const taskNumber = item.taskNumber;
+                return { workspaceId: item.workspaceId, threadRef: item.thread.threadRef, channelRef: item.channelRef,
                     ...(item.task === undefined ? {} : { taskRef: item.task.taskRef, status: item.task.status }),
                     revision: item.thread.revision, unreadCount: item.unreadCount, directCount: item.directCount, newestOccurredAt: item.newestOccurredAt,
                     ...(taskNumber === undefined ? {} : { taskNumber }) };
@@ -172,10 +169,11 @@ const teamThread = defineTool({
         action: { type: 'string', required: true, enum: ['status', 'follow', 'unfollow', 'read', 'history'] },
         threadRef: { type: 'string', description: "Full branded Thread ref exactly as returned by Team tools, including the 'thread:' prefix. An unambiguous abbreviation of the first 6+ UUID hex characters also resolves." },
         taskRef: { type: 'string', description: "Optional Task ref alias for released clients. Prefer threadRef; if both are given they must identify the same Thread." },
-        beforeSequence: { type: 'number' }, limit: { type: 'number' },
+        beforeSequence: { type: 'number' }, limit: { type: 'number' }, workspace: workspaceParam,
     },
     output: {
         schema: { type: 'object', additionalProperties: false, properties: {
+                workspaceId: { type: 'string', required: true }, channelRef: { type: 'string', required: true },
                 kind: { type: 'string', required: true }, threadRef: { type: 'string', required: true }, taskRef: { type: 'string' },
                 revision: { type: 'number', required: true }, status: { type: 'string' }, resolution: { type: 'string' }, taskNumber: { type: 'number' },
                 following: { type: 'boolean', required: true }, readThroughSequence: { type: 'number' }, remainingUnreadCount: { type: 'number' }, earlierFactCount: { type: 'number' }, cursor: { type: 'number' }, hasMore: { type: 'boolean' },
@@ -201,15 +199,16 @@ const teamThread = defineTool({
         // current collision surface or any write token.
         render: (args, value) => {
             const standing = taskStanding(value);
+            const source = `Workspace: ${value.workspaceId} · Channel: ${value.channelRef}`;
             if (value.kind === 'status') {
-                return [{ type: 'text', text: `Attention status — ${value.following ? 'following' : 'not following'} ${value.threadRef}${standing === '' ? '' : ` · ${standing}`}.` }];
+                return [{ type: 'text', text: `${source}\nAttention status — ${value.following ? 'following' : 'not following'} ${value.threadRef}${standing === '' ? '' : ` · ${standing}`}.` }];
             }
             if (value.kind === 'follow' || value.kind === 'unfollow') {
-                return [{ type: 'text', text: `Attention changed — ${value.following ? 'now following' : 'no longer following'} ${value.threadRef}${standing === '' ? '' : ` · ${standing}`}.` }];
+                return [{ type: 'text', text: `${source}\nAttention changed — ${value.following ? 'now following' : 'no longer following'} ${value.threadRef}${standing === '' ? '' : ` · ${standing}`}.` }];
             }
             if (value.kind === 'history') {
                 const facts = value.facts;
-                const lines = [`History for ${value.threadRef}${standing === '' ? '' : ` · ${standing}`}`];
+                const lines = [source, `History for ${value.threadRef}${standing === '' ? '' : ` · ${standing}`}`];
                 // First page (no beforeSequence supplied) orients on the full
                 // anchor; a continuation orients on the shared bounded subject. An
                 // anchor already selected as a fact never repeats.
@@ -235,6 +234,7 @@ const teamThread = defineTool({
             // A read with nothing unread writes no durable operation, so the opening
             // line claims a commit only when unread facts were actually acknowledged.
             const lines = [
+                source,
                 acknowledged === 0
                     ? `Read — no unread updates on ${value.threadRef}; nothing remains.`
                     : `Read committed — acknowledged ${acknowledged} unread update(s) on ${value.threadRef}; ${remaining} remain.`,
@@ -281,15 +281,14 @@ const teamThread = defineTool({
         const agent = exec.agent;
         if (agent === undefined)
             throw new Error('team_thread requires an Agent session');
-        const current = member(agent);
         const host = service(agent);
         if (args.threadRef === undefined && args.taskRef === undefined)
             throw new Error('team_thread requires threadRef');
-        const base = { workspaceId: current.workspaceId, ...(args.threadRef === undefined ? {} : { threadRef: args.threadRef }), ...(args.taskRef === undefined ? {} : { taskRef: args.taskRef }) };
+        const base = { workspaceId: workspaceOf(args, agent), ...(args.threadRef === undefined ? {} : { threadRef: args.threadRef }), ...(args.taskRef === undefined ? {} : { taskRef: args.taskRef }) };
         const taskNumberOf = (task) => {
             if (task === undefined)
                 return {};
-            const resolved = host.resolveTaskRefs({ workspaceId: current.workspaceId, taskRefs: [task.taskRef] }).resolved[0];
+            const resolved = host.resolveTaskRefs({ workspaceId: base.workspaceId, taskRefs: [task.taskRef] }).resolved[0];
             return resolved === undefined ? {} : { taskNumber: resolved.taskNumber };
         };
         if (args.action === 'status') {
@@ -297,26 +296,26 @@ const teamThread = defineTool({
                 throw new Error('status does not accept history arguments');
             const status = host.attentionStatusForAgent(agent, base);
             const snapshot = host.threadHistoryForAgent(agent, { ...base, beforeSequence: 1, limit: 1 });
-            return threadResult('status', snapshot, status.attention, [], taskNumberOf(snapshot.task));
+            return threadResult('status', base.workspaceId, snapshot, status.attention, [], taskNumberOf(snapshot.task));
         }
         if (args.action === 'follow' || args.action === 'unfollow') {
             if (args.beforeSequence !== undefined || args.limit !== undefined)
                 throw new Error(`${args.action} does not accept history arguments`);
             const result = await host.changeAttentionForAgent(agent, { requestId: requestId(agent.id, exec.callId), ...base, action: args.action });
             const snapshot = host.threadHistoryForAgent(agent, { ...base, beforeSequence: 1, limit: 1 });
-            return threadResult(args.action, snapshot, result.attention, [], taskNumberOf(snapshot.task));
+            return threadResult(args.action, base.workspaceId, snapshot, result.attention, [], taskNumberOf(snapshot.task));
         }
         if (args.action === 'history') {
             const history = host.threadHistoryForAgent(agent, { ...base, ...(args.beforeSequence === undefined ? {} : { beforeSequence: args.beforeSequence }), ...(args.limit === undefined ? {} : { limit: args.limit }) });
             const status = host.attentionStatusForAgent(agent, base);
-            return threadResult('history', history, status.attention, history.facts.map(fact => fact.kind === 'message'
+            return threadResult('history', base.workspaceId, history, status.attention, history.facts.map(fact => fact.kind === 'message'
                 ? { sequence: fact.sequence, kind: 'message', body: fact.message.body, sender: fact.message.sender, mentions: [...fact.mentions], occurredAt: fact.occurredAt }
                 : activityFactView(fact.sequence, fact.activity, undefined, fact.occurredAt)), { cursor: history.cursor, hasMore: history.hasMore, ...taskNumberOf(history.task) });
         }
         if (args.beforeSequence !== undefined || args.limit !== undefined)
             throw new Error('read does not accept history arguments');
         const read = await host.readThreadForAgent(agent, { requestId: requestId(agent.id, exec.callId), ...base });
-        return threadResult('read', read, read.attention, read.facts.map(entry => entry.fact.kind === 'message'
+        return threadResult('read', base.workspaceId, read, read.attention, read.facts.map(entry => entry.fact.kind === 'message'
             ? { sequence: entry.fact.sequence, kind: 'message', body: entry.fact.message.body, sender: entry.fact.message.sender, mentions: [...entry.fact.mentions], unread: entry.unread, direct: entry.direct, occurredAt: entry.fact.occurredAt }
             : activityFactView(entry.fact.sequence, entry.fact.activity, { unread: entry.unread, direct: entry.direct }, entry.fact.occurredAt)), { readThroughSequence: read.readThroughSequence, remainingUnreadCount: read.remainingUnreadCount, ...(read.earlierFactCount === undefined ? {} : { earlierFactCount: read.earlierFactCount }), ...(read.contextAdvice === undefined ? {} : { contextAdvice: adviceView(read.contextAdvice) }), ...taskNumberOf(read.task) });
     },
@@ -332,8 +331,9 @@ function factLine(fact) {
 function claimLine(claim) {
     return `${claim.claimRef} — ${claim.owner}: ${claim.direction}`;
 }
-function threadResult(kind, snapshot, attention, facts, extra = {}) {
+function threadResult(kind, workspaceId, snapshot, attention, facts, extra = {}) {
     return {
+        workspaceId, channelRef: snapshot.anchor.channelRef,
         kind, threadRef: snapshot.thread.threadRef, revision: snapshot.thread.revision,
         ...(snapshot.task === undefined ? {} : { taskRef: snapshot.task.taskRef, status: snapshot.task.status, resolution: snapshot.task.resolution }),
         ...(extra.taskNumber === undefined ? {} : { taskNumber: extra.taskNumber }),
@@ -365,6 +365,7 @@ const teamMessage = markAgentTeamPreset(defineTool({
         asTask: { type: 'boolean', description: 'When true, start creates a Task with the Thread. Default false creates a taskless Thread.' },
         body: { type: 'string', required: true, description: "Markdown body. Lead with the conclusion or state. Mention the Human only when they must know or decide; when a decision is owed, say plainly what needs deciding and what happens by default if nobody answers — no fixed template. Keep it the shortest useful message for the recipients; mechanical detail follows below. Cite Team refs exactly as returned, as bare text with one colon (e.g. task:0f0a…) — never a double colon, never inside backticks or quotes. Unambiguous UUID abbreviations (first 6+ hex chars) also resolve. Mention a Member by writing `@Handle` (`@` required, case-insensitive) in the prose: that is what delivers the Message to them and renders the mention chip, and `@all` reaches the whole Channel." }, baseRevision: { type: 'number', description: "The next-write token from your latest fully drained team_thread read (or your own last committed mutation) on this Thread. Copy the explicitly rendered value verbatim; never increment, derive, compare, or cite it — it is an opaque concurrency token, not a fact about the Thread." },
         attachments: { type: 'array', items: { type: 'string' }, description: 'Absolute file paths to share, e.g. screenshots or generated artifacts; images render as thumbnails for recipients. The Host validates each path and copies the file into the attachment cache, and members also receive one cached path per attachment; if any path fails validation the whole send is rejected.' },
+        workspace: workspaceParam,
     },
     output: {
         schema: { type: 'object', additionalProperties: false, properties: {
@@ -408,7 +409,6 @@ const teamMessage = markAgentTeamPreset(defineTool({
         const agent = exec.agent;
         if (agent === undefined)
             throw new Error('team_message requires an Agent session');
-        const current = member(agent);
         const host = service(agent);
         const rawPaths = args.attachments;
         const attachmentPaths = Array.isArray(rawPaths) ? rawPaths.filter((entry) => typeof entry === 'string' && entry.trim() !== '') : undefined;
@@ -416,7 +416,7 @@ const teamMessage = markAgentTeamPreset(defineTool({
         if (args.action === 'start') {
             if (args.channelRef === undefined || args.taskRef !== undefined || args.threadRef !== undefined || args.baseRevision !== undefined)
                 throw new Error('start requires channelRef and does not accept threadRef, taskRef, or baseRevision');
-            const result = await host.sendMessageForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: current.workspaceId,
+            const result = await host.sendMessageForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: workspaceOf(args, agent),
                 channelRef: args.channelRef, body: args.body, asTask: args.asTask === true, ...paths });
             return messageOutcome(result, 'start');
         }
@@ -426,7 +426,7 @@ const teamMessage = markAgentTeamPreset(defineTool({
                 throw new Error('dm requires memberRef and body only; it does not accept channelRef, threadRef, taskRef, baseRevision, asTask, or attachments');
             }
             try {
-                const result = await host.dmForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: current.workspaceId,
+                const result = await host.dmForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: workspaceOf(args, agent),
                     recipientMemberId: args.memberRef, body: args.body });
                 return { kind: 'dm-sent', recipientMemberId: result.recipient.memberId, recipientHandle: result.recipient.handle, delivered: true, occurredAt: result.receipt.occurredAt };
             }
@@ -441,7 +441,7 @@ const teamMessage = markAgentTeamPreset(defineTool({
         if ((args.threadRef === undefined && args.taskRef === undefined) || args.channelRef !== undefined || args.asTask !== undefined || typeof baseRevision !== 'number' || !Number.isSafeInteger(baseRevision) || baseRevision < 1) {
             throw new Error('reply requires threadRef and a positive baseRevision; drain the Thread with team_thread read and copy the token it renders, or reuse the one your own last committed mutation rendered');
         }
-        const result = await host.replyForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: current.workspaceId,
+        const result = await host.replyForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: workspaceOf(args, agent),
             ...(args.threadRef === undefined ? {} : { threadRef: args.threadRef }),
             ...(args.taskRef === undefined ? {} : { taskRef: args.taskRef }),
             body: args.body, baseRevision, ...paths });
@@ -477,6 +477,7 @@ const teamClaim = defineTool({
         taskRef: { type: 'string', required: true, description: "Full branded Task ref exactly as returned by Team tools, including the 'task:' prefix. An unambiguous abbreviation of the first 6+ UUID hex characters also resolves." },
         baseRevision: { type: 'number', description: "The next-write token from your latest fully drained team_thread read (or your own last committed mutation) on this Task's Thread. Copy the explicitly rendered value verbatim; never increment, derive, compare, or cite it — it is an opaque concurrency token, not a fact about the Task." }, direction: { type: 'string' },
         claimRef: { type: 'string', description: "Full branded Claim ref exactly as returned by team_claim, including the 'claim:' prefix. An unambiguous abbreviation of the first 6+ UUID hex characters also resolves." },
+        workspace: workspaceParam,
     },
     output: {
         schema: { type: 'object', additionalProperties: false, properties: {
@@ -518,9 +519,8 @@ const teamClaim = defineTool({
         const agent = exec.agent;
         if (agent === undefined)
             throw new Error('team_claim requires an Agent session');
-        const current = member(agent);
         const host = service(agent);
-        const base = { workspaceId: current.workspaceId, taskRef: args.taskRef };
+        const base = { workspaceId: workspaceOf(args, agent), taskRef: args.taskRef };
         if (args.action === 'list') {
             if (args.baseRevision !== undefined || args.direction !== undefined || args.claimRef !== undefined)
                 throw new Error('list accepts only taskRef');
@@ -557,11 +557,13 @@ const teamView = defineTool({
     description: 'Discover your authorized Team addresses: current Channels, a newest-first page of top-level Threads (each with its bounded anchor subject; Task standing inline on taskful rows), and current Members. This is an address book, not a work queue — unread work lives in team_inbox, and a Thread is read with team_thread read. The cursor pages Thread rows only.',
     parameters: {
         channelRef: { type: 'string', description: "Full branded Channel ref exactly as returned by Team tools, including the 'channel:' prefix. An unambiguous abbreviation of the first 6+ UUID hex characters also resolves." },
-        limit: { type: 'number' }, cursor: { type: 'number' },
+        limit: { type: 'number' }, cursor: { type: 'number' }, workspace: workspaceParam,
     },
     output: {
         schema: { type: 'object', additionalProperties: false, properties: {
                 channels: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: { channelRef: { type: 'string', required: true }, name: { type: 'string', required: true } } } },
+                workspaceId: { type: 'string', required: true },
+                workspaces: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: { workspaceId: { type: 'string', required: true }, title: { type: 'string' }, default: { type: 'boolean', required: true } } } },
                 members: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: {
                             memberId: { type: 'string', required: true }, kind: { type: 'string', required: true }, handle: { type: 'string', required: true }, description: { type: 'string', required: true }, presence: { type: 'string', required: true },
                         } } },
@@ -581,7 +583,7 @@ const teamView = defineTool({
         // which is reading, never writing from a directory snapshot.
         render: (_args, value) => {
             const continuation = value.page === 'threads';
-            const lines = [];
+            const lines = [`Workspace: ${value.workspaceId}`];
             if (!continuation) {
                 lines.push('Team directory', '', 'Channels — current');
                 if (value.channels.length === 0)
@@ -596,6 +598,10 @@ const teamView = defineTool({
             else
                 lines.push(...value.threads.map(thread => `${thread.threadRef} · ${thread.channelRef}${thread.taskRef === undefined ? ' · taskless' : ` · ${taskStanding(thread)}`} — ${thread.subject}${thread.lastActivityAt === undefined ? '' : ` · last activity ${formatTeamTimestamp(thread.lastActivityAt)}`}`));
             lines.push(`Thread cursor ${value.cursor}; hasMore=${value.hasMore ? 'true' : 'false'}${value.hasMore ? ' — older Thread anchors exist; page again with this cursor.' : ' — no older Threads remain.'}`);
+            if (!continuation && value.workspaces.length > 1) {
+                lines.push('', 'Workspaces — you participate in');
+                lines.push(...value.workspaces.map(workspace => `${workspace.workspaceId}${workspace.title === undefined ? '' : ` · ${workspace.title}`}${workspace.default ? ' · default — your Session and cwd live here' : ' — address it with the workspace argument; file work needs absolute paths'}`));
+            }
             if (!continuation) {
                 lines.push('', 'Members — current');
                 if (value.members.length === 0)
@@ -610,11 +616,14 @@ const teamView = defineTool({
         const agent = exec.agent;
         if (agent === undefined)
             throw new Error('team_view requires an Agent session');
-        const current = member(agent);
         const host = service(agent);
-        const view = host.viewForAgent(agent, { workspaceId: current.workspaceId, ...(args.channelRef === undefined ? {} : { channelRef: args.channelRef }), ...(args.limit === undefined ? {} : { limit: args.limit }), ...(args.cursor === undefined ? {} : { cursor: args.cursor }), topLevelOnly: true, includeActivities: false, direction: 'before' });
+        const workspaceId = workspaceOf(args, agent);
+        const view = host.viewForAgent(agent, { workspaceId, ...(args.channelRef === undefined ? {} : { channelRef: args.channelRef }), ...(args.limit === undefined ? {} : { limit: args.limit }), ...(args.cursor === undefined ? {} : { cursor: args.cursor }), topLevelOnly: true, includeActivities: false, direction: 'before' });
         const visibleMemberIds = new Set(view.members.map(membership => membership.memberId));
         return {
+            workspaceId,
+            workspaces: view.workspaces.map(participation => ({ workspaceId: participation.workspaceId,
+                ...(participation.title === undefined ? {} : { title: participation.title }), default: participation.default })),
             channels: view.channels.map(channel => ({ channelRef: channel.channelRef, name: channel.name })),
             members: [
                 { memberId: view.humanMemberId, kind: 'human', handle: AGENT_TEAM_HUMAN_HANDLE, description: 'Human Team Member', presence: 'available' },

package/packages/tool-agent-team/lib/types/host-access.d.ts

@@ -5,10 +5,20 @@
  * rejection rather than a silent no-op. Both messages are user-facing text.
  */
 import AgentTeam from '@wowyuarm/dsh-agent-team/host';
+import type { WorkspaceId } from '@deepseek-ai/dsh-api-workspace-controller/client';
 /** The Agent shape every Team tool receives. */
 export type TeamToolAgent = NonNullable<Parameters<AgentTeam['memberForAgent']>[0]>;
 /** Resolve the Team Host service, or reject the tool call. */
 export declare function service(agent: TeamToolAgent): AgentTeam;
 /** Resolve the calling Team Member, or reject the tool call. */
 export declare function member(agent: TeamToolAgent): import("@wowyuarm/dsh-agent-team/types").AgentTeamAgentMember;
+/** A collaboration address, never a cwd or Session switch. */
+export declare const workspaceParam: {
+    type: "string";
+    description: string;
+};
+/** Reject ambiguous routing before a tool reads facts or attempts a mutation. */
+export declare function workspaceOf(args: {
+    workspace?: string | undefined;
+}, agent: TeamToolAgent): WorkspaceId;
 //# sourceMappingURL=host-access.d.ts.map

package/packages/tool-agent-team/lib/types/host-access.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-access.d.ts","sourceRoot":"","sources":["../../src/host-access.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAAS,MAAM,+BAA+B,CAAA;AAErD,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEnF,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAIvD;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,iEAI1C"}
+{"version":3,"file":"host-access.d.ts","sourceRoot":"","sources":["../../src/host-access.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAAS,MAAM,+BAA+B,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA;AAEnF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEnF,8DAA8D;AAC9D,wBAAgB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,CAIvD;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,KAAK,EAAE,aAAa,iEAI1C;AAED,8DAA8D;AAC9D,eAAO,MAAM,cAAc;;;CAG1B,CAAA;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,KAAK,EAAE,aAAa,GAAG,WAAW,CAUvG"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAelD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AAoqB/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAOxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAelD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AA8qB/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAOxC"}

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

@@ -1,41 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"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"}