@wowyuarm/dsh-agent-team 0.1.10 → 0.1.12

package/packages/tool-agent-team/lib/context-tools.js

@@ -9,18 +9,7 @@
  * @module @wowyuarm/dsh-agent-team/context-tools
  */
 import { defineTool } from '@deepseek-ai/dsh-tools';
-function service(agent) {
-    const host = agent.ctx.get('agentTeam');
-    if (host === undefined)
-        throw new Error('Agent Team Host is unavailable');
-    return host;
-}
-function member(agent) {
-    const current = service(agent).memberForAgent(agent);
-    if (current === undefined)
-        throw new Error('team tool requires an active Team Member');
-    return current;
-}
+import { member, service } from "./host-access.js";
 const MAX_HANDOFF_CHARS = 32 * 1024;
 const MAX_RELATED_FILES = 32;
 const contextRollover = defineTool({
@@ -139,13 +128,19 @@ const contextTimeline = defineTool({
                             reason: { type: 'string' },
                             sourceSessionId: { type: 'string' },
                         } } },
+                incompleteFrom: { type: 'object', additionalProperties: false, properties: {
+                        sessionId: { type: 'string', required: true },
+                        reason: { type: 'string', required: true },
+                    } },
             } },
         // The item list is the whole decision surface: without each anchor's
         // ref, label, source, size estimates, affected Threads, and
         // restorable/reason verdict, the model cannot pick a `checkpointRef` for
         // `context_rollover` — the summary line alone left the tool unusable for
         // seeded returns. The Host bounds items (default 12, at most 24), so this
-        // list cannot grow unbounded.
+        // list cannot grow unbounded. `incompleteFrom` states where and why the
+        // lineage walk stopped early, so history read up to that ancestor is
+        // known to be a truncation, not everything that exists.
         render: (_args, value) => {
             const lines = [`Context timeline: ${value.usageTokens} tokens used (handoff at ${value.handoffAt}, hard limit ${value.hardLimit}). ${value.items.length} item(s):`];
             for (const item of value.items) {
@@ -156,6 +151,9 @@ const contextTimeline = defineTool({
                     : `not restorable — ${item.reason ?? 'no reason given'}`;
                 lines.push(`- ${item.name} [source: ${item.source}] (${size}; ${threads}) — ${restorable}`);
             }
+            if (value.incompleteFrom !== undefined) {
+                lines.push(`History incomplete: the lineage walk stopped at Session ${value.incompleteFrom.sessionId} (${value.incompleteFrom.reason}); ancestors before it could not be read and are not reflected above.`);
+            }
             return [{ type: 'text', text: lines.join('\n') }];
         },
     },
@@ -169,7 +167,13 @@ const contextTimeline = defineTool({
         const result = await host.contextTimelineForAgent(agent, { memberId: current.memberId, ...(limit === undefined ? {} : { limit }) });
         // The Host result is deeply immutable; the tool output contract carries
         // plain arrays, so re-shape without any semantic change.
-        return { usageTokens: result.usageTokens, hardLimit: result.hardLimit, handoffAt: result.handoffAt, items: result.items.map(item => ({ ...item, affectedThreads: [...item.affectedThreads] })) };
+        return {
+            usageTokens: result.usageTokens,
+            hardLimit: result.hardLimit,
+            handoffAt: result.handoffAt,
+            items: result.items.map(item => ({ ...item, affectedThreads: [...item.affectedThreads] })),
+            ...(result.incompleteFrom === undefined ? {} : { incompleteFrom: result.incompleteFrom }),
+        };
     },
 });
 export function registerContextTools(ctx) {

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

@@ -0,0 +1,20 @@
+/**
+ * Shared Host accessors for every Team tool module. `agent.ctx.get` is the
+ * one resolution path a tool row has — the preset mounts these tools beside
+ * the Host, so a missing service or an inactive Member is a model-visible
+ * rejection rather than a silent no-op. Both messages are user-facing text.
+ */
+/** Resolve the Team Host service, or reject the tool call. */
+export function service(agent) {
+    const host = agent.ctx.get('agentTeam');
+    if (host === undefined)
+        throw new Error('Agent Team Host is unavailable');
+    return host;
+}
+/** Resolve the calling Team Member, or reject the tool call. */
+export function member(agent) {
+    const current = service(agent).memberForAgent(agent);
+    if (current === undefined)
+        throw new Error('team tool requires an active Team Member');
+    return current;
+}

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

@@ -1,6 +1,7 @@
-import { AgentTeamDmDeliveryError, markAgentTeamPreset } from '@wowyuarm/dsh-agent-team/host';
+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 { defineTool } from '@deepseek-ai/dsh-tools';
 export const name = 'wowyuarm-agent-team-tools';
 export const inject = ['tools'];
@@ -76,18 +77,6 @@ function taskStanding(value) {
         return '';
     return `${value.taskRef}${value.taskNumber === undefined ? '' : ` (#${value.taskNumber})`}${value.status === undefined ? '' : `, ${value.status}${value.resolution === undefined ? '' : `/${value.resolution}`}`}`;
 }
-function service(agent) {
-    const host = agent.ctx.get('agentTeam');
-    if (host === undefined)
-        throw new Error('Agent Team Host is unavailable');
-    return host;
-}
-function member(agent) {
-    const current = service(agent).memberForAgent(agent);
-    if (current === undefined)
-        throw new Error('team tool requires an active Team Member');
-    return current;
-}
 function requestId(agentId, callId) {
     return `agent-team:tool:${agentId}:${callId}`;
 }
@@ -178,7 +167,7 @@ const teamInbox = defineTool({
 });
 const teamThread = defineTool({
     name: 'team_thread',
-    description: 'Read or manage your Attention on one Thread. read acknowledges one chronological batch of unread facts and is the only read-side source of a next-write token — and only once no unread remains; your own committed public mutations hand off the token as well. history pages older facts without changing read state; status, follow, and unfollow change or report Attention only and render no Thread timeline. Prefer threadRef; taskRef is a compatibility alias when the Thread has a Task.',
+    description: 'Read or manage your Attention on one Thread. read acknowledges one chronological batch of unread facts and is the only read-side source of a next-write token — and only once no unread remains; your own committed public mutations hand off the token as well. A read orients on the Thread anchor and that batch, never the whole Thread: a Member re-entering one it has read before gets no background at all, so the facts between are its own to page back to. history pages older facts without changing read state; status, follow, and unfollow change or report Attention only and render no Thread timeline. Prefer threadRef; taskRef is a compatibility alias when the Thread has a Task.',
     parameters: {
         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." },
@@ -189,7 +178,7 @@ const teamThread = defineTool({
         schema: { type: 'object', additionalProperties: false, properties: {
                 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' }, cursor: { type: 'number' }, hasMore: { type: 'boolean' },
+                following: { type: 'boolean', required: true }, readThroughSequence: { type: 'number' }, remainingUnreadCount: { type: 'number' }, earlierFactCount: { type: 'number' }, cursor: { type: 'number' }, hasMore: { type: 'boolean' },
                 anchor: { type: 'object', required: true, additionalProperties: false, properties: {
                         messageRef: { type: 'string', required: true }, sender: { type: 'string', required: true }, body: { type: 'string', required: true }, sequence: { type: 'number', required: true }, occurredAt: { type: 'string' },
                     } },
@@ -243,8 +232,12 @@ const teamThread = defineTool({
             const facts = value.facts;
             const acknowledged = facts.filter(fact => fact.unread === true).length;
             const remaining = value.remainingUnreadCount ?? 0;
+            // 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 = [
-                `Read committed — ${acknowledged === 0 ? `no unread updates on ${value.threadRef}; nothing remains` : `acknowledged ${acknowledged} unread update(s) on ${value.threadRef}; ${remaining} remain`}.`,
+                acknowledged === 0
+                    ? `Read — no unread updates on ${value.threadRef}; nothing remains.`
+                    : `Read committed — acknowledged ${acknowledged} unread update(s) on ${value.threadRef}; ${remaining} remain.`,
                 `${value.threadRef}${standing === '' ? '' : ` · ${standing}`} · ${value.following ? 'following' : 'not following'}`,
             ];
             // Orientation: A the anchor is one of the returned facts (renders as
@@ -270,6 +263,13 @@ const teamThread = defineTool({
             else
                 lines.push(...facts.map(fact => factLine(fact)));
             lines.push('', `Read through sequence ${value.readThroughSequence}; ${remaining} unread update(s) remaining${remaining > 0 ? ' — call team_thread read again.' : '.'}`);
+            // What this bounded read answered with is the newest batch; the span
+            // before the watermark is the orientation it did not supply. Rendering
+            // the count is what lets a returning reader see the size of that span
+            // instead of assuming the batch is the Thread.
+            const earlier = value.earlierFactCount ?? 0;
+            if (earlier > 0)
+                lines.push(`Earlier facts: ${earlier} — read older ones with team_thread.history.`);
             if (value.contextAdvice !== undefined)
                 lines.push('', ...adviceLines(value.contextAdvice));
             if (remaining === 0)
@@ -318,7 +318,7 @@ const teamThread = defineTool({
         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'
             ? { 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.contextAdvice === undefined ? {} : { contextAdvice: adviceView(read.contextAdvice) }), ...taskNumberOf(read.task) });
+            : 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) });
     },
 });
 /** One rendered fact line; markers are inline, never a separate ellipsis line. */
@@ -355,7 +355,7 @@ function adviceLines(advice) {
 }
 const teamMessage = markAgentTeamPreset(defineTool({
     name: 'team_message',
-    description: 'Start a top-level Thread, reply to an existing Thread, or send a direct message (DM). Read the Thread first: a reply needs the current next-write token from a fully drained team_thread read (or your own last committed mutation), and unread work rejects before staleness is even checked. start defaults to a taskless Thread; pass asTask true to create a Task in the same send. A top-level start may mention related Agents directly; in replies, only a Human can invite an unfollowed Agent. Pass Member refs in mentions and spell their handles inside the body; only mentioned Members render as mention chips. dm sends a private direct message to one enabled Agent Member in your Workspace: use it for quick clarifications and status syncs — never for task work, decisions, or anything that needs team visibility or traceability (use a Thread); if a DM exchange with the same Member exceeds about 3 exchanges, move it to a Thread, because every DM costs the recipient a full agent turn.',
+    description: 'Start a top-level Thread, reply to an existing Thread, or send a direct message (DM). Read the Thread first: a reply needs the current next-write token from a fully drained team_thread read (or your own last committed mutation), and unread work rejects before staleness is even checked — and a mention only delivers its Message and restores Attention, never the Thread\'s earlier facts, so entering a Thread whose facts have left your context means reading back through it first. start defaults to a taskless Thread; pass asTask true to create a Task in the same send. A top-level start may mention related Agents directly; in replies, only a Human can invite a Member the Thread has never carried. Mention by writing `@Handle` in body — the `@` is required, matching ignores case, and each named Member is delivered to and renders as a mention chip; `@all` reaches every Member of the Channel. Naming a Member this Thread has never carried still commits, delivers nothing to that Member, and reports them under undeliveredMentions: ask the Human to invite them, or reach them with a dm. dm sends a private direct message to one enabled Agent Member in your Workspace: use it for quick clarifications and status syncs — never for task work, decisions, or anything that needs team visibility or traceability (use a Thread); if a DM exchange with the same Member exceeds about 3 exchanges, move it to a Thread, because every DM costs the recipient a full agent turn.',
     parameters: {
         action: { type: 'string', required: true, enum: ['start', 'reply', 'dm'] },
         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." },
@@ -363,8 +363,7 @@ const teamMessage = markAgentTeamPreset(defineTool({
         taskRef: { type: 'string', description: "Optional Task ref alias for reply on a Taskful Thread. Prefer threadRef; an unambiguous abbreviation of the first 6+ UUID hex characters also resolves." },
         memberRef: { type: 'string', description: "Full branded Member ref exactly as returned by Team tools, including the 'member:' prefix. An unambiguous abbreviation of the first 6+ UUID hex characters also resolves. Required for dm; the Member must be an enabled Agent in your Workspace (the Human cannot be DMed)." },
         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. 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. Spell each mentioned Member's handle in the prose so the mention renders inline." }, 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." },
-        mentions: { type: 'array', items: { type: 'string' }, description: 'Member refs to mention. Mentioned Agents receive the Message directly; write their handles in the body (any casing, optional @) so the mention renders inline.' },
+        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.' },
     },
     output: {
@@ -372,6 +371,7 @@ const teamMessage = markAgentTeamPreset(defineTool({
                 kind: { type: 'string', required: true }, action: { type: 'string' }, taskRef: { type: 'string' }, threadRef: { type: 'string' }, revision: { type: 'number' },
                 expectedRevision: { type: 'number' }, messageRef: { type: 'string' }, memberIds: { type: 'array', items: { type: 'string' } }, unreadCount: { type: 'number' }, directCount: { type: 'number' },
                 recipientMemberId: { type: 'string' }, recipientHandle: { type: 'string' }, delivered: { type: 'boolean' }, deliveryNote: { type: 'string' }, occurredAt: { type: 'string' },
+                undeliveredMentions: { type: 'array', items: { type: 'string' } },
             } },
         render: (_args, value) => {
             if (value.kind === 'dm-sent') {
@@ -388,6 +388,9 @@ const teamMessage = markAgentTeamPreset(defineTool({
                             value.action === 'start' ? 'Committed — Thread created.' : 'Committed — reply added.',
                             [value.messageRef, value.threadRef, ...(value.taskRef === undefined ? [] : [value.taskRef])].join(' · '),
                             ...(value.occurredAt === undefined ? [] : [`Committed at ${formatTeamTimestamp(value.occurredAt)}`]),
+                            ...(value.undeliveredMentions === undefined || value.undeliveredMentions.length === 0 ? [] : [
+                                `Mention not delivered — ${value.undeliveredMentions.join(', ')} never took part in this Thread, so nothing reached them. Only a Human can invite a Member: reach them with a dm, or ask the Human.`,
+                            ]),
                             nextWriteLine(value.revision),
                         ].join('\n') }];
             }
@@ -407,7 +410,6 @@ const teamMessage = markAgentTeamPreset(defineTool({
             throw new Error('team_message requires an Agent session');
         const current = member(agent);
         const host = service(agent);
-        const mentions = args.mentions;
         const rawPaths = args.attachments;
         const attachmentPaths = Array.isArray(rawPaths) ? rawPaths.filter((entry) => typeof entry === 'string' && entry.trim() !== '') : undefined;
         const paths = attachmentPaths !== undefined && attachmentPaths.length > 0 ? { attachmentPaths } : {};
@@ -415,13 +417,13 @@ const teamMessage = markAgentTeamPreset(defineTool({
             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,
-                channelRef: args.channelRef, body: args.body, asTask: args.asTask === true, ...(mentions === undefined ? {} : { recipients: mentions }), ...paths });
+                channelRef: args.channelRef, body: args.body, asTask: args.asTask === true, ...paths });
             return messageOutcome(result, 'start');
         }
         if (args.action === 'dm') {
             if (args.memberRef === undefined || args.channelRef !== undefined || args.threadRef !== undefined || args.taskRef !== undefined
-                || args.baseRevision !== undefined || args.asTask !== undefined || mentions !== undefined || attachmentPaths !== undefined) {
-                throw new Error('dm requires memberRef and body only; it does not accept channelRef, threadRef, taskRef, baseRevision, asTask, mentions, or attachments');
+                || args.baseRevision !== undefined || args.asTask !== undefined || attachmentPaths !== undefined) {
+                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,
@@ -442,16 +444,20 @@ const teamMessage = markAgentTeamPreset(defineTool({
         const result = await host.replyForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: current.workspaceId,
             ...(args.threadRef === undefined ? {} : { threadRef: args.threadRef }),
             ...(args.taskRef === undefined ? {} : { taskRef: args.taskRef }),
-            body: args.body, baseRevision,
-            ...(mentions === undefined ? {} : { recipients: mentions }), ...paths });
+            body: args.body, baseRevision, ...paths });
         return messageOutcome(result, 'reply');
     },
 }));
 function messageOutcome(result, action) {
-    if (result.kind === 'committed')
+    if (result.kind === 'committed') {
+        // A start always delivers to the Members it names — they begin following the
+        // new Thread — so only a reply can report names the Thread has never carried.
+        const undelivered = 'undeliveredMentions' in result ? result.undeliveredMentions : undefined;
         return { kind: result.kind, action, threadRef: result.thread.threadRef,
             ...(result.task === undefined ? {} : { taskRef: result.task.taskRef }),
-            revision: result.thread.revision, messageRef: result.message.messageRef, occurredAt: result.receipt.occurredAt };
+            revision: result.thread.revision, messageRef: result.message.messageRef, occurredAt: result.receipt.occurredAt,
+            ...(undelivered === undefined || undelivered.length === 0 ? {} : { undeliveredMentions: [...undelivered] }) };
+    }
     if (result.kind === 'member_not_following')
         return { kind: result.kind, memberIds: [...result.memberIds],
             ...(result.taskRef === undefined ? {} : { taskRef: result.taskRef }), ...(result.threadRef === undefined ? {} : { threadRef: result.threadRef, revision: result.revision }) };
@@ -563,7 +569,7 @@ const teamView = defineTool({
                             threadRef: { type: 'string', required: true }, channelRef: { type: 'string', required: true }, revision: { type: 'number', required: true }, messageCount: { type: 'number', required: true }, subject: { type: 'string', required: true },
                             taskRef: { type: 'string' }, status: { type: 'string' }, taskNumber: { type: 'number' }, lastActivityAt: { type: 'string' },
                         } } },
-                tasks: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: { taskRef: { type: 'string', required: true }, threadRef: { type: 'string', required: true }, channelRef: { type: 'string', required: true }, status: { type: 'string', required: true }, revision: { type: 'number', required: true } } } },
+                tasks: { type: 'array', required: true, items: { type: 'object', additionalProperties: false, properties: { taskRef: { type: 'string', required: true }, threadRef: { type: 'string', required: true }, channelRef: { type: 'string', required: true }, status: { type: 'string', required: true }, revision: { type: 'number' } } } },
                 cursor: { type: 'number', required: true }, hasMore: { type: 'boolean', required: true }, page: { type: 'string' },
             } },
         // Address book, newest Thread first: labelled sections, one bounded
@@ -611,7 +617,7 @@ const teamView = defineTool({
         return {
             channels: view.channels.map(channel => ({ channelRef: channel.channelRef, name: channel.name })),
             members: [
-                { memberId: view.humanMemberId, kind: 'human', handle: 'human', description: 'Human Team Member', presence: 'available' },
+                { memberId: view.humanMemberId, kind: 'human', handle: AGENT_TEAM_HUMAN_HANDLE, description: 'Human Team Member', presence: 'available' },
                 ...host.members().filter(status => visibleMemberIds.has(status.member.memberId)).map(status => ({ memberId: status.member.memberId,
                     kind: 'agent', handle: status.member.handle, description: status.member.description, presence: status.presence })),
             ],
@@ -622,8 +628,14 @@ const teamView = defineTool({
                     subject: boundedSubject(item.message.body), lastActivityAt: item.lastActivityAt,
                     ...(task === undefined ? {} : { taskRef: task.taskRef, status: task.status, ...(item.taskNumber === undefined ? {} : { taskNumber: item.taskNumber }) }) };
             }),
-            tasks: view.tasks.map(task => ({ taskRef: task.taskRef, threadRef: task.threadRef, channelRef: task.channelRef,
-                status: task.status, revision: view.threads.find(thread => thread.threadRef === task.threadRef)?.revision ?? 0 })),
+            // A Task's revision is its Thread's; it is omitted rather than reported as
+            // `0` when the Task's Thread is outside this directory page's scope. A
+            // fabricated revision would read as "this Thread has never been written".
+            tasks: view.tasks.map(task => {
+                const revision = view.threads.find(thread => thread.threadRef === task.threadRef)?.revision;
+                return { taskRef: task.taskRef, threadRef: task.threadRef, channelRef: task.channelRef, status: task.status,
+                    ...(revision === undefined ? {} : { revision }) };
+            }),
             cursor: view.cursor, hasMore: view.hasMore,
             ...(args.cursor === undefined ? {} : { page: 'threads' }),
         };

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

@@ -1 +1 @@
-{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/context-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoKH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAIrG"}
+{"version":3,"file":"context-tools.d.ts","sourceRoot":"","sources":["../../src/context-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuKH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAAG,IAAI,CAIrG"}

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

@@ -0,0 +1,14 @@
+/**
+ * Shared Host accessors for every Team tool module. `agent.ctx.get` is the
+ * one resolution path a tool row has — the preset mounts these tools beside
+ * the Host, so a missing service or an inactive Member is a model-visible
+ * rejection rather than a silent no-op. Both messages are user-facing text.
+ */
+import AgentTeam from '@wowyuarm/dsh-agent-team/host';
+/** 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;
+//# sourceMappingURL=host-access.d.ts.map

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

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

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;AAclD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AAypB/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;AAoqB/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAOxC"}