@wowyuarm/dsh-agent-team 0.1.1 → 0.1.3

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

@@ -35,6 +35,49 @@ export function memberHue(memberId) {
         hash = (hash * 31 + memberId.charCodeAt(index)) % 360;
     return hash;
 }
+const BRANDED_REF_PATTERN = /\b(task|channel|thread):{1,2}[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi;
+/**
+ * Canonical form of one matched ref: models occasionally double the colon or
+ * uppercase the UUID when citing a ref in prose, while Host lookups and
+ * navigation only accept the lowercase single-colon ref the ledger mints.
+ */
+function canonicalBrandedRef(match) {
+    return match.replace('::', ':').toLowerCase();
+}
+/**
+ * Split a literal text run into plain and branded-ref segments. The pattern
+ * anchors on the fixed ref prefixes plus the UUID shape, so ordinary prose
+ * containing a colon never linkifies; a doubled colon from model output is
+ * tolerated. Segment refs are always canonical, so resolution and navigation
+ * work regardless of how the ref was spelled; text without any ref comes
+ * back as one untouched segment.
+ */
+export function splitBrandedRefs(text) {
+    const segments = [];
+    let cursor = 0;
+    for (const match of text.matchAll(BRANDED_REF_PATTERN)) {
+        const start = match.index ?? 0;
+        if (start > cursor)
+            segments.push({ text: text.slice(cursor, start) });
+        segments.push({ text: match[0], ref: canonicalBrandedRef(match[0]) });
+        cursor = start + match[0].length;
+    }
+    if (cursor < text.length)
+        segments.push({ text: text.slice(cursor) });
+    return segments;
+}
+/**
+ * Whether one string's whole content is exactly one branded ref. A code span
+ * like this is the model styling a ref as an identifier, not publishing code,
+ * so the Markdown pass may linkify it; anything larger stays literal.
+ */
+export function isSingleBrandedRef(text) {
+    const trimmed = text.trim();
+    if (trimmed === '')
+        return false;
+    const matches = [...trimmed.matchAll(BRANDED_REF_PATTERN)];
+    return matches.length === 1 && matches[0][0] === trimmed;
+}
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
@@ -107,8 +150,11 @@ export function formatMessageTime(occurredAt, now = new Date()) {
 }
 export function formatActivity(activity, options) {
     const actor = options.actorName(activity.actor);
-    if (activity.kind === 'accept')
-        return options.t('activityAccepted', { actor });
+    if (activity.kind === 'accept') {
+        return activity.completedClaimRefs !== undefined && activity.completedClaimRefs.length > 0
+            ? options.t('activityAcceptedWithClaims', { actor, count: activity.completedClaimRefs.length })
+            : options.t('activityAccepted', { actor });
+    }
     if (activity.kind === 'close')
         return options.t('activityClosed', { actor });
     if (activity.kind === 'reopen')
@@ -130,3 +176,38 @@ export function formatActivity(activity, options) {
 export function stripAttachmentLines(body) {
     return body.replaceAll(/^\[attachment\] .*$(\n)?/gm, '').replace(/\n+$/, '');
 }
+/**
+ * Decide how one Message body renders. Human input and plain-prose Agent
+ * bodies stay literal, with structured mention chips inline where possible;
+ * rich Agent Markdown keeps unmatched mentions and non-Task refs in the
+ * trailing fallback row while the post-render pass handles Task refs at their
+ * authored position. Surfaces without ref navigation render everything
+ * literally and keep the full fallback row.
+ */
+export function planMessageBody(body, options) {
+    const stripped = stripAttachmentLines(body);
+    const displayBody = stripped === '' ? body : stripped;
+    const richAgentBody = !options.human && !isPlainTextBody(displayBody);
+    const inline = (options.human || isPlainTextBody(displayBody)) && options.mentionNames !== undefined && options.mentionNames.length > 0
+        ? splitMentionNames(displayBody, options.mentionNames)
+        : undefined;
+    const fallbackNames = inline !== undefined ? inline.unmatched
+        : richAgentBody && options.canOpenRefs && options.mentionNames !== undefined
+            ? splitMentionNames(displayBody, options.mentionNames).unmatched
+            : options.mentionNames ?? [];
+    const refs = splitBrandedRefs(displayBody).flatMap(segment => segment.ref === undefined ? [] : [segment.ref]);
+    const render = inline !== undefined ? 'inline'
+        : options.human || (options.canOpenRefs && !richAgentBody && refs.length > 0) ? 'literal'
+            : 'markdown';
+    return {
+        displayBody,
+        richAgentBody,
+        render,
+        ...(inline === undefined ? {} : { inline }),
+        fallbackNames,
+        fallbackRefs: richAgentBody && options.canOpenRefs ? refs.filter(ref => !ref.startsWith('task:')) : [],
+        taskRefs: options.canOpenRefs && !richAgentBody
+            ? refs.filter(ref => ref.startsWith('task:')).map(ref => ref)
+            : [],
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"team-membership.d.ts","sourceRoot":"","sources":["../../../src/client/team-membership.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,mCAAmC,EACnC,kCAAkC,EAEnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAEzE,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACjH,QAAQ,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,OAAO,CAAC,YAAY,CAAC,kCAAkC,CAAC,CAAC,CAAA;CAC1I;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,MAAM,EACrD,WAAW,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACrE;IACD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpE,CA6BA"}
+{"version":3,"file":"team-membership.d.ts","sourceRoot":"","sources":["../../../src/client/team-membership.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,mCAAmC,EACnC,kCAAkC,EAEnC,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAEzE,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAA;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC,CAAA;IACjH,QAAQ,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,OAAO,CAAC,YAAY,CAAC,kCAAkC,CAAC,CAAC,CAAA;CAC1I;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,0BAA0B,EACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,MAAM,EACrD,WAAW,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACrE;IACD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpE,CA6BA"}

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

@@ -1,4 +1,5 @@
 import { useRef, useState } from 'react';
+import { mintRequestId } from "./requests.js";
 /**
  * Shared Channel membership mutation. One stable requestId per direction,
  * Member, and Channel survives transport failures until the Host commits it;
@@ -15,7 +16,7 @@ export function useChannelMembership(transport, rowKeyOf, onCommitted) {
         setPending(current => new Set(current).add(rowKey));
         setErrors(current => { const next = new Map(current); next.delete(rowKey); return next; });
         const key = `${membership.joined ? 'remove' : 'join'}:${membership.memberId}:${membership.channelRef}`;
-        const requestId = requestIds.current.get(key) ?? crypto.randomUUID();
+        const requestId = requestIds.current.get(key) ?? mintRequestId();
         requestIds.current.set(key, requestId);
         const request = { requestId, workspaceId: membership.workspaceId, channelRef: membership.channelRef, memberId: membership.memberId };
         try {

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

@@ -131,12 +131,12 @@ function threadResult(kind, snapshot, attention, facts, extra = {}) {
 }
 const teamMessage = markAgentTeamPreset(defineTool({
     name: 'team_message',
-    description: 'Create a top-level Task or reply to one existing Task Thread. Read the Thread first; replies require its current revision. 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: 'Create a top-level Task or reply to one existing Task Thread. 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.',
     parameters: {
         action: { type: 'string', required: true, enum: ['start', 'reply'] },
         channelRef: { type: 'string', description: "Full branded Channel ref exactly as returned by Team tools, including the 'channel:' prefix." },
         taskRef: { type: 'string', description: "Full branded Task ref exactly as returned by Team tools, including the 'task:' prefix." },
-        body: { type: 'string', required: true }, baseRevision: { type: 'number', description: "Positive integer; use the current Thread revision as shown by the latest team_inbox or team_thread result for this Task." },
+        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 Task. 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.' },
         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.' },
     },
@@ -192,11 +192,11 @@ function messageOutcome(result) {
 }
 const teamClaim = defineTool({
     name: 'team_claim',
-    description: 'List or mutate your Direction Claims. Read the Thread first; every mutation uses the current Thread revision.',
+    description: 'List or mutate your Direction Claims. Read the Thread first; every mutation uses the current Thread revision. A Claim is your one-sentence direction statement on a Task — "the angle I am taking" — so others can spot collisions and track progress: Tasks define scope (owned by Humans), Claims declare the angle (owned by you). Good direction: "Unify the four form dialogs on shared field components before wiring submits." Bad direction: a multi-paragraph plan with step order, file lists, or acceptance criteria — those belong in Thread messages, not the Claim.',
     parameters: {
         action: { type: 'string', required: true, enum: ['list', 'claim', 'done', 'release'] },
         taskRef: { type: 'string', required: true, description: "Full branded Task ref exactly as returned by Team tools, including the 'task:' prefix." },
-        baseRevision: { type: 'number', description: "Positive integer; use the current Thread revision as shown by the latest team_inbox or team_thread result for this Task." }, direction: { type: 'string' },
+        baseRevision: { type: 'number', description: "Positive integer; use the current Thread revision as shown by the latest team_inbox or team_thread result for this Task. The revision is an internal concurrency token, not a citable fact." }, direction: { type: 'string' },
         claimRef: { type: 'string', description: "Full branded Claim ref exactly as returned by team_claim, including the 'claim:' prefix." },
     },
     output: {

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

@@ -1,13 +0,0 @@
-import type { WorkspaceId } from '@deepseek-ai/dsh-client-runtime/client';
-import type { TeamConversationProps } from './slots.ts';
-interface TeamInboxPanelProps {
-    readonly workspaceId: WorkspaceId;
-    readonly loadInbox: TeamConversationProps['loadInbox'];
-    readonly loadChannels: TeamConversationProps['loadChannels'];
-    readonly loadChanges: TeamConversationProps['loadChanges'];
-    readonly selectThread: TeamConversationProps['selectThread'];
-    readonly t: TeamConversationProps['t'];
-}
-export declare function TeamInboxPanel({ workspaceId, loadInbox, loadChannels, loadChanges, selectThread, t }: TeamInboxPanelProps): import("react").JSX.Element;
-export {};
-//# sourceMappingURL=TeamInboxPanel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TeamInboxPanel.d.ts","sourceRoot":"","sources":["../../../src/client/TeamInboxPanel.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAA;AAEzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAIvD,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAA;IACtD,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAA;IAC5D,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAA;IAC1D,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAC,cAAc,CAAC,CAAA;IAC5D,QAAQ,CAAC,CAAC,EAAE,qBAAqB,CAAC,GAAG,CAAC,CAAA;CACvC;AAED,wBAAgB,cAAc,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,EAAE,EAAE,mBAAmB,+BAkGzH"}

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

@@ -1,90 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { useEffect, useMemo, useRef, useState } from 'react';
-import { Button } from '@deepseek-ai/dsh-client-ui-primitives';
-import { formatTaskStatus } from "./team-formatters.js";
-import css from './inbox.module.css';
-export function TeamInboxPanel({ workspaceId, loadInbox, loadChannels, loadChanges, selectThread, t }) {
-    const [inbox, setInbox] = useState();
-    const [view, setView] = useState();
-    const [error, setError] = useState();
-    const [loading, setLoading] = useState(true);
-    const active = useRef(false);
-    const refreshSequence = useRef(0);
-    const refresh = async (clearError = false) => {
-        const sequence = refreshSequence.current + 1;
-        refreshSequence.current = sequence;
-        if (clearError)
-            setError(undefined);
-        try {
-            const [nextInbox, nextView] = await Promise.all([
-                loadInbox({ workspaceId }),
-                loadChannels({ workspaceId, topLevelOnly: true, includeActivities: false, limit: 100 }),
-            ]);
-            if (!active.current || sequence !== refreshSequence.current)
-                return;
-            if (!nextInbox.ok) {
-                setError(nextInbox.error.message);
-                return;
-            }
-            if (!nextView.ok) {
-                setError(nextView.error.message);
-                return;
-            }
-            setInbox(nextInbox.value);
-            setView(nextView.value);
-            setError(undefined);
-        }
-        catch (cause) {
-            if (active.current && sequence === refreshSequence.current)
-                setError(cause instanceof Error ? cause.message : String(cause));
-        }
-        finally {
-            if (active.current && sequence === refreshSequence.current)
-                setLoading(false);
-        }
-    };
-    useEffect(() => {
-        let listening = true;
-        active.current = true;
-        setInbox(undefined);
-        setView(undefined);
-        setError(undefined);
-        setLoading(true);
-        void refresh();
-        void (async () => {
-            let version = 0;
-            while (listening) {
-                try {
-                    const changed = await loadChanges({ afterVersion: version });
-                    if (!listening)
-                        return;
-                    if (!changed.ok) {
-                        setError(changed.error.message);
-                        return;
-                    }
-                    if (changed.value.version > version) {
-                        version = changed.value.version;
-                        await refresh();
-                    }
-                }
-                catch (cause) {
-                    if (listening)
-                        setError(cause instanceof Error ? cause.message : String(cause));
-                    return;
-                }
-            }
-        })();
-        return () => {
-            listening = false;
-            active.current = false;
-            refreshSequence.current += 1;
-        };
-    }, [workspaceId]);
-    const channels = useMemo(() => new Map(view?.channels.map(channel => [channel.channelRef, channel]) ?? []), [view]);
-    const taskNumbers = useMemo(() => new Map(view?.taskNumbers.map(item => [item.taskRef, item.taskNumber]) ?? []), [view]);
-    return _jsxs("main", { className: css.surface, "data-team-inbox": true, children: [_jsxs("header", { className: css.header, children: [_jsxs("div", { children: [_jsx("h1", { children: t('inbox') }), inbox !== undefined && _jsx("p", { children: inbox.totalUnreadCount === 0 ? t('inboxEmpty') : t('inboxUnreadCount', { count: inbox.totalUnreadCount }) })] }), inbox !== undefined && inbox.totalDirectCount > 0 && _jsx("span", { className: css.directTotal, children: t('inboxDirectCount', { count: inbox.totalDirectCount }) })] }), _jsxs("section", { className: css.list, "aria-label": t('inbox'), children: [loading && inbox === undefined && error === undefined && _jsx("p", { className: css.state, children: t('loadingInbox') }), !loading && inbox?.items.length === 0 && error === undefined && _jsx("p", { className: css.state, children: t('inboxEmpty') }), error !== undefined && _jsxs("div", { className: css.error, role: "alert", children: [_jsx("span", { children: error }), _jsx(Button, { size: "sm", variant: "outline", onClick: () => { void refresh(true); }, children: t('retry') })] }), inbox?.items.map(item => {
-                        const channel = channels.get(item.channelRef);
-                        const taskNumber = taskNumbers.get(item.task.taskRef);
-                        return _jsxs("button", { type: "button", className: css.item, onClick: () => { selectThread(item.task.taskRef, item.thread.threadRef, item.channelRef, taskNumber); }, children: [_jsx("span", { className: css.priority, "data-direct": item.directCount > 0, "aria-hidden": "true" }), _jsxs("span", { className: css.copy, children: [_jsx("strong", { children: taskNumber === undefined ? t('task') : `Task #${taskNumber}` }), _jsxs("small", { children: [channel === undefined ? t('channelUnknown') : `# ${channel.name}`, " \u00B7 ", formatTaskStatus(item.task.status, t)] })] }), _jsxs("span", { className: css.count, "aria-label": `${t('inboxUnreadCount', { count: item.unreadCount })}${item.directCount > 0 ? `, ${t('inboxDirectCount', { count: item.directCount })}` : ''}`, children: [t('inboxUnreadCount', { count: item.unreadCount }), item.directCount > 0 && _jsxs(_Fragment, { children: [" \u00B7 ", t('inboxDirectCount', { count: item.directCount })] })] })] }, item.thread.threadRef);
-                    })] })] });
-}