@wowyuarm/dsh-agent-team 0.1.5 → 0.1.6

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

@@ -3,16 +3,14 @@ export interface TimelineScroll {
     onScroll: () => void;
     /** Whether the reader currently sits within the follow margin of the bottom. */
     isPinned: () => boolean;
-    /** Jump to the unread-boundary marker on the next content commit. */
-    jumpToBoundary: () => void;
-    /** Jump to the latest fact on the next content commit. */
-    jumpToLatest: () => void;
+    /** Scroll the timeline to the latest fact immediately. */
+    scrollToBottom: () => void;
 }
 /**
  * Chat-timeline scroll policy shared by the Channel and Thread pages: follow
- * new facts only while the reader stays pinned to the bottom, keep prepended
- * history visually stable, and honor explicit jump requests exactly once per
- * content commit. The content key must change whenever rendered facts change.
+ * new facts only while the reader stays pinned to the bottom, and keep
+ * prepended history visually stable. The content key must change whenever
+ * rendered facts change.
  */
 export declare function useTimelineScroll(contentKey: string): TimelineScroll;
 //# sourceMappingURL=timeline-scroll.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"timeline-scroll.d.ts","sourceRoot":"","sources":["../../../src/client/timeline-scroll.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC1C,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,OAAO,CAAA;IACvB,qEAAqE;IACrE,cAAc,EAAE,MAAM,IAAI,CAAA;IAC1B,0DAA0D;IAC1D,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CA+CpE"}
+{"version":3,"file":"timeline-scroll.d.ts","sourceRoot":"","sources":["../../../src/client/timeline-scroll.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,CAAA;IAC1C,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,OAAO,CAAA;IACvB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,CAiCpE"}

package/packages/client-agent-team/lib/types/client/timeline-scroll.js

@@ -1,30 +1,26 @@
 import { useCallback, useEffect, useRef } from 'react';
 const BOTTOM_MARGIN_PX = 48;
-const BOUNDARY_OFFSET_PX = 12;
 /**
  * Chat-timeline scroll policy shared by the Channel and Thread pages: follow
- * new facts only while the reader stays pinned to the bottom, keep prepended
- * history visually stable, and honor explicit jump requests exactly once per
- * content commit. The content key must change whenever rendered facts change.
+ * new facts only while the reader stays pinned to the bottom, and keep
+ * prepended history visually stable. The content key must change whenever
+ * rendered facts change.
  */
 export function useTimelineScroll(contentKey) {
     const ref = useRef(null);
     const pinnedRef = useRef(true);
     const heightRef = useRef(0);
-    const jumpRef = useRef();
     const onScroll = useCallback(() => {
         const element = ref.current;
         if (element === null)
             return;
         pinnedRef.current = element.scrollHeight - element.scrollTop - element.clientHeight < BOTTOM_MARGIN_PX;
     }, []);
-    const jumpToBoundary = useCallback(() => {
-        jumpRef.current = 'boundary';
-        pinnedRef.current = false;
-    }, []);
-    const jumpToLatest = useCallback(() => {
-        jumpRef.current = 'latest';
+    const scrollToBottom = useCallback(() => {
+        const element = ref.current;
         pinnedRef.current = true;
+        if (element !== null)
+            element.scrollTop = element.scrollHeight;
     }, []);
     useEffect(() => {
         const element = ref.current;
@@ -32,16 +28,7 @@ export function useTimelineScroll(contentKey) {
             return;
         const previousHeight = heightRef.current;
         heightRef.current = element.scrollHeight;
-        const jump = jumpRef.current;
-        jumpRef.current = undefined;
-        if (jump === 'boundary') {
-            const marker = element.querySelector('[data-thread-boundary]');
-            if (marker !== null) {
-                element.scrollTop += marker.getBoundingClientRect().top - element.getBoundingClientRect().top - BOUNDARY_OFFSET_PX;
-                return;
-            }
-        }
-        if (jump === 'latest' || pinnedRef.current) {
+        if (pinnedRef.current) {
             element.scrollTop = element.scrollHeight;
             return;
         }
@@ -50,5 +37,5 @@ export function useTimelineScroll(contentKey) {
             element.scrollTop += element.scrollHeight - previousHeight;
         }
     }, [contentKey]);
-    return { ref, onScroll, isPinned: () => pinnedRef.current, jumpToBoundary, jumpToLatest };
+    return { ref, onScroll, isPinned: () => pinnedRef.current, scrollToBottom };
 }

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

@@ -1,4 +1,4 @@
-import { markAgentTeamPreset } from '@wowyuarm/dsh-agent-team/host';
+import { AgentTeamDmDeliveryError, markAgentTeamPreset } from '@wowyuarm/dsh-agent-team/host';
 import { defineTool } from '@deepseek-ai/dsh-tools';
 export const name = 'wowyuarm-agent-team-tools';
 export const inject = ['tools'];
@@ -136,12 +136,13 @@ function threadResult(kind, snapshot, attention, facts, extra = {}) {
 }
 const teamMessage = markAgentTeamPreset(defineTool({
     name: 'team_message',
-    description: 'Start a top-level Thread or reply to an existing Thread. start defaults to a taskless Thread; pass asTask true to create a Task in the same send. Read the Thread first; replies require its current revision (an internal concurrency token carried by baseRevision, never quoted in bodies). 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.',
+    description: 'Start a top-level Thread, reply to an existing Thread, or send a direct message (DM). start defaults to a taskless Thread; pass asTask true to create a Task in the same send. Read the Thread first; replies require its current revision (an internal concurrency token carried by baseRevision, never quoted in bodies). 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.',
     parameters: {
-        action: { type: 'string', required: true, enum: ['start', 'reply'] },
+        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." },
         threadRef: { type: 'string', description: "Full branded Thread ref exactly as returned by Team tools, including the 'thread:' prefix." },
         taskRef: { type: 'string', description: "Optional Task ref alias for reply on a Taskful Thread. Prefer threadRef." },
+        memberRef: { type: 'string', description: "Full branded Member ref exactly as returned by Team tools, including the 'member:' prefix. 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. Spell each mentioned Member's handle in the prose so the mention renders inline." }, baseRevision: { type: 'number', description: "Positive integer; use the current Thread revision as shown by the latest team_inbox or team_thread result for this Thread. The revision is an internal concurrency token, not a citable fact." },
         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.' },
@@ -151,9 +152,11 @@ const teamMessage = markAgentTeamPreset(defineTool({
         schema: { type: 'object', additionalProperties: false, properties: {
                 kind: { type: 'string', required: true }, 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' },
             } },
-        render: (_args, value) => [{ type: 'text', text: value.kind === 'committed' ? `Message ${value.messageRef} committed at revision ${value.revision}.`
-                    : `${value.kind}: ${value.memberIds?.join(', ') ?? `${value.threadRef ?? ''}${value.taskRef === undefined ? '' : ` · Task ${value.taskRef}`} revision ${value.revision ?? ''}`}` }],
+        render: (_args, value) => [{ type: 'text', text: value.kind === 'dm-sent' ? `DM ${value.delivered === false ? 'recorded but not delivered' : 'delivered'} to @${value.recipientHandle} (${value.recipientMemberId})${value.deliveryNote === undefined ? '' : `: ${value.deliveryNote}`}`
+                    : value.kind === 'committed' ? `Message ${value.messageRef} committed at revision ${value.revision}.`
+                        : `${value.kind}: ${value.memberIds?.join(', ') ?? `${value.threadRef ?? ''}${value.taskRef === undefined ? '' : ` · Task ${value.taskRef}`} revision ${value.revision ?? ''}`}` }],
     },
     async execute(args, exec) {
         const agent = exec.agent;
@@ -172,6 +175,23 @@ const teamMessage = markAgentTeamPreset(defineTool({
                 channelRef: args.channelRef, body: args.body, asTask: args.asTask === true, ...(mentions === undefined ? {} : { recipients: mentions }), ...paths });
             return messageOutcome(result);
         }
+        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');
+            }
+            try {
+                const result = await host.dmForAgent(agent, { requestId: requestId(agent.id, exec.callId), workspaceId: current.workspaceId,
+                    recipientMemberId: args.memberRef, body: args.body });
+                return { kind: 'dm-sent', recipientMemberId: result.recipient.memberId, recipientHandle: result.recipient.handle, delivered: true };
+            }
+            catch (error) {
+                if (error instanceof AgentTeamDmDeliveryError) {
+                    return { kind: 'dm-sent', recipientMemberId: error.recipientMemberId, recipientHandle: error.recipientHandle, delivered: false, deliveryNote: error.message };
+                }
+                throw error;
+            }
+        }
         const baseRevision = args.baseRevision;
         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, and does not accept channelRef; use the current Thread 'revision' returned by team_inbox or team_thread");

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;AAWlD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AAqS/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAWlD,eAAO,MAAM,IAAI,8BAA8B,CAAA;AAC/C,eAAO,MAAM,MAAM,UAAY,CAAA;AAwT/B,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAMxC"}