@wowyuarm/dsh-agent-team 0.1.14-alpha.2 → 0.1.14

package/packages/agent-team/lib/ledger.js

@@ -45,6 +45,15 @@ function boundedInboxPreview(body) {
     const firstLine = body.split('\n', 1)[0]?.trim() ?? '';
     return firstLine.length > 120 ? `${firstLine.slice(0, 119)}…` : firstLine;
 }
+/**
+ * Chip title for a resolved Thread ref: the same opening-line gist as the
+ * Inbox preview, but capped at 40 characters — a chip shares its line with
+ * prose, so the 120-character row bound would crowd the message out.
+ */
+function boundedThreadTitle(body) {
+    const firstLine = body.split('\n', 1)[0]?.trim() ?? '';
+    return firstLine.length > 40 ? `${firstLine.slice(0, 39)}…` : firstLine;
+}
 /**
  * How many Threads one Workspace's 「最近活跃」 slice may carry. It bounds what
  * the Host hands over, not what the reader sees: the Client merges every
@@ -100,6 +109,13 @@ export class AgentTeamLedger {
     createOccurredAt;
     createRef;
     operationTail = Promise.resolve();
+    /**
+     * Runtime human display name. Durable identity stays `member:human`; only
+     * the handle read by @ matching and handle-uniqueness follows this value.
+     * The Host syncs it from the `agent-team-human` settings namespace; the
+     * ledger never persists it, so a rename affects only later resolutions.
+     */
+    humanHandle = AGENT_TEAM_HUMAN_HANDLE;
     /**
      * Head of the durable records the constructor's record-level replay
      * validated, adoptable once by the invariant mount. See `validateAtMount`.
@@ -130,6 +146,19 @@ export class AgentTeamLedger {
             lastOperationId: head?.operationId ?? null,
         });
     }
+    /** Current human display name for @ matching and uniqueness checks. */
+    humanDisplayHandle() {
+        return this.humanHandle;
+    }
+    /**
+     * Sync the runtime human display name from Host settings. Never persisted:
+     * a rename affects only later @ resolutions and handle checks.
+     */
+    setHumanDisplayHandle(handle) {
+        const name = handle.normalize('NFKC').trim();
+        if (name !== '')
+            this.humanHandle = name;
+    }
     initialize(request = {
         requestId: AGENT_TEAM_INITIALIZE_REQUEST_ID,
         actor: HUMAN_ACTOR,
@@ -1180,7 +1209,8 @@ export class AgentTeamLedger {
         const recent = authorized.kind === 'human'
             ? this.recentInboxItems(authorized.memberId, workspaceIds[0], unreadThreads, taskNumbers)
             : Object.freeze([]);
-        return Object.freeze({ items: Object.freeze(selected), recent,
+        return Object.freeze({ humanMemberId: this.initialization().data.humanMemberId,
+            items: Object.freeze(selected), recent,
             totalUnreadCount: items.reduce((sum, item) => sum + item.unreadCount, 0),
             totalDirectCount: items.reduce((sum, item) => sum + item.directCount, 0) });
     }
@@ -1194,8 +1224,16 @@ export class AgentTeamLedger {
     inboxActorFor(fact) {
         return this.memberActor(fact.kind === 'message' ? fact.message.sender : fact.activity.actor);
     }
-    /** One Member as a row draws them: the id carries the identity hue, the handle the initial. */
+    /**
+     * One Member as a row draws them: the id carries the identity hue, the handle
+     * the initial. The Human is the one Member the Agent roster never holds, so
+     * their row reads the runtime display name rather than falling back to the
+     * durable `member:human` id — the same name every other seat and @ matching
+     * already use.
+     */
     memberActor(memberId) {
+        if (memberId === this.initialization().data.humanMemberId)
+            return Object.freeze({ memberId, name: this.humanHandle });
         return Object.freeze({ memberId, name: this.state.members.get(memberId)?.handle ?? memberId });
     }
     /**
@@ -1380,6 +1418,30 @@ export class AgentTeamLedger {
     getClaim(claimRef) {
         return this.state.claims.get(claimRef);
     }
+    /** Navigation facts for message-body Thread refs; unknown refs are omitted. */
+    resolveThreadRefs(workspaceId, threadRefs) {
+        const numbers = this.taskNumbers(workspaceId);
+        const resolved = [];
+        for (const threadRef of threadRefs) {
+            const key = this.uniqueRefKey(this.state.threads, threadRef, 'thread');
+            const thread = key === undefined ? undefined : this.state.threads.get(key);
+            const channelRef = thread === undefined ? undefined : this.channelRefForThread(thread.threadRef);
+            const channel = channelRef === undefined ? undefined : this.state.channels.get(channelRef);
+            // Same archival rule as tasks: archived Channels do not exist on Team
+            // API surfaces, so their Threads stop resolving and message bodies
+            // render the refs as plain non-navigable text.
+            if (thread === undefined || channelRef === undefined || channel?.workspaceId !== workspaceId || channel?.state === 'archived')
+                continue;
+            const task = thread.taskRef === undefined ? undefined : this.state.tasks.get(thread.taskRef);
+            resolved.push(Object.freeze({
+                threadRef: thread.threadRef,
+                channelRef,
+                ...(task === undefined ? {} : { taskRef: task.taskRef, taskNumber: numbers.get(task.taskRef) ?? 0 }),
+                title: boundedThreadTitle(this.threadAnchor(thread.threadRef).body),
+            }));
+        }
+        return resolved;
+    }
     /** Navigation facts for message-body Task refs; unknown refs are omitted. */
     resolveTaskRefs(workspaceId, taskRefs) {
         const numbers = this.taskNumbers(workspaceId);
@@ -1412,20 +1474,28 @@ export class AgentTeamLedger {
             if (!this.participatesIn(member.memberId, request.workspaceId))
                 throw new Error('Member cannot view another Workspace');
         }
-        if (request.channelRef !== undefined) {
-            this.requireActiveChannel(request.workspaceId, request.channelRef);
-            if (memberId !== undefined && !this.isChannelMember(request.channelRef, memberId))
+        // Validation above accepts unique UUID abbreviations, so resolve both
+        // filters to full keys once: comparing the authored spelling in the fact
+        // filters below matches nothing and returns an empty view that every
+        // caller reads as "no such thread" (task #17).
+        const channelRefFilter = request.channelRef === undefined
+            ? undefined
+            : this.requireActiveChannel(request.workspaceId, request.channelRef).channelRef;
+        if (channelRefFilter !== undefined) {
+            if (memberId !== undefined && !this.isChannelMember(channelRefFilter, memberId))
                 throw new Error(`Agent Member '${memberId}' is not authorized for Channel '${request.channelRef}'`);
         }
+        let threadRefFilter;
         if (request.threadRef !== undefined) {
             const thread = this.requireThread(request.threadRef);
+            threadRefFilter = thread.threadRef;
             const channelRef = this.channelRefForThread(thread.threadRef);
             if (channelRef === undefined)
                 throw new Error(`unknown Thread ref '${request.threadRef}'`);
             if (this.state.channels.get(channelRef)?.workspaceId !== request.workspaceId)
                 throw new Error(`Thread '${request.threadRef}' does not belong to Workspace '${request.workspaceId}'`);
             this.assertThreadChannelActive(channelRef);
-            if (request.channelRef !== undefined && channelRef !== request.channelRef)
+            if (channelRefFilter !== undefined && channelRef !== channelRefFilter)
                 throw new Error(`Thread '${request.threadRef}' does not belong to Channel '${request.channelRef}'`);
             if (memberId !== undefined && !this.isChannelMember(channelRef, memberId))
                 throw new Error(`Agent Member '${memberId}' is not authorized for Channel '${channelRef}'`);
@@ -1440,9 +1510,9 @@ export class AgentTeamLedger {
             const channelRef = this.channelRefForThread(threadRef);
             if (channelRef === undefined || !channelRefs.has(channelRef))
                 return false;
-            if (request.channelRef !== undefined && channelRef !== request.channelRef)
+            if (channelRefFilter !== undefined && channelRef !== channelRefFilter)
                 return false;
-            if (request.threadRef !== undefined && threadRef !== request.threadRef)
+            if (threadRefFilter !== undefined && threadRef !== threadRefFilter)
                 return false;
             if (request.topLevelOnly && (fact.kind !== 'message' || !fact.message.topLevel))
                 return false;
@@ -1483,8 +1553,8 @@ export class AgentTeamLedger {
             }
         }
         const visibleTasks = [...this.state.tasks.values()].filter(task => channelRefs.has(task.channelRef)
-            && (request.channelRef === undefined || task.channelRef === request.channelRef)
-            && (request.threadRef === undefined || task.threadRef === request.threadRef));
+            && (channelRefFilter === undefined || task.channelRef === channelRefFilter)
+            && (threadRefFilter === undefined || task.threadRef === threadRefFilter));
         const taskNumbers = this.taskNumbers(request.workspaceId);
         const items = selected.filter((fact) => fact.kind === 'message').map(fact => {
             const message = fact.message;
@@ -1511,8 +1581,8 @@ export class AgentTeamLedger {
             threads: Object.freeze([...this.state.threads.values()].filter(thread => {
                 const channelRef = this.channelRefForThread(thread.threadRef);
                 return channelRef !== undefined && channelRefs.has(channelRef)
-                    && (request.channelRef === undefined || channelRef === request.channelRef)
-                    && (request.threadRef === undefined || thread.threadRef === request.threadRef);
+                    && (channelRefFilter === undefined || channelRef === channelRefFilter)
+                    && (threadRefFilter === undefined || thread.threadRef === threadRefFilter);
             })),
             taskNumbers: Object.freeze(visibleTasks.map(task => Object.freeze({ taskRef: task.taskRef, taskNumber: taskNumbers.get(task.taskRef) ?? 0 }))),
             items: Object.freeze(items),
@@ -1766,7 +1836,10 @@ export class AgentTeamLedger {
             throw new Error('agent-team ledger has no Human Member');
         const humanMemberId = human.data.humanMemberId;
         const assertHuman = () => {
-            if (operation.actor.kind !== 'human' || operation.actor.memberId !== humanMemberId || operation.actor.handle !== HUMAN_ACTOR.handle) {
+            // memberId is the durable Human authority; the handle is display-only
+            // and may carry a configured name (old records carry the historic
+            // literal), so replay never judges it here.
+            if (operation.actor.kind !== 'human' || operation.actor.memberId !== humanMemberId) {
                 throw new Error(`agent-team operation ${operation.sequence} has invalid Human authority`);
             }
         };
@@ -1897,6 +1970,12 @@ export class AgentTeamLedger {
                     && other.handle.normalize('NFKC').trim().toLowerCase() === normalized)
                     throw new Error('invalid Member update handle');
             }
+            // Replay-time human collision uses the Host-synced runtime name; the
+            // default keeps old ledgers (written before configurable names) valid.
+            // A stored rename that now collides fails replay loudly rather than
+            // silently forking the @ namespace, so the operator renames first.
+            if (normalized === this.humanHandle.normalize('NFKC').trim().toLowerCase())
+                throw new Error('invalid Member update handle');
             return;
         }
         if (operation.kind === 'team/channel-member-added') {
@@ -3207,7 +3286,8 @@ export class AgentTeamLedger {
     }
     assertHumanActor(actor) {
         const initialization = this.initialization();
-        if (actor.kind !== 'human' || actor.memberId !== initialization.data.humanMemberId || actor.handle !== HUMAN_ACTOR.handle) {
+        // memberId is the durable Human authority; the handle is display-only.
+        if (actor.kind !== 'human' || actor.memberId !== initialization.data.humanMemberId) {
             throw new Error('agent-team operation lacks Human authority');
         }
     }
@@ -3442,9 +3522,16 @@ export class AgentTeamLedger {
      * Channel plus the Human. A name outside this set stays prose, which is what
      * keeps an incidental name-drop from reaching someone the Channel cannot
      * deliver to.
+     *
+     * The Human is reachable under two names: the current display handle and the
+     * permanent `human` alias, so a rename never silently orphans `@human`
+     * (matching ignores case, and chips render the display name either way).
+     * The alias yields when another candidate already answers to it, so one
+     * written name never notifies two different Members; enrollment reserves the
+     * literal, so that yield only ever covers data predating the reservation.
      */
     mentionCandidatesFor(channelRef) {
-        const candidates = [{ memberId: AGENT_TEAM_HUMAN_MEMBER_ID, handle: AGENT_TEAM_HUMAN_HANDLE }];
+        const candidates = [{ memberId: AGENT_TEAM_HUMAN_MEMBER_ID, handle: this.humanHandle }];
         for (const member of this.state.members.values()) {
             if (member.state === 'inactive' || member.state === 'archived')
                 continue;
@@ -3452,6 +3539,10 @@ export class AgentTeamLedger {
                 continue;
             candidates.push({ memberId: member.memberId, handle: member.handle });
         }
+        if (this.humanHandle.normalize('NFKC').trim().toLowerCase() !== AGENT_TEAM_HUMAN_HANDLE
+            && !candidates.some(candidate => candidate.handle.normalize('NFKC').trim().toLowerCase() === AGENT_TEAM_HUMAN_HANDLE)) {
+            candidates.push({ memberId: AGENT_TEAM_HUMAN_MEMBER_ID, handle: AGENT_TEAM_HUMAN_HANDLE });
+        }
         return Object.freeze(candidates);
     }
     /**
@@ -3512,6 +3603,20 @@ export class AgentTeamLedger {
             && member.handle.normalize('NFKC').trim().toLowerCase() === normalized)) {
             throw new Error(`Agent Member handle '${handle}' is already active in Workspace '${workspaceId}'`);
         }
+        // The human display name shares the @ namespace: an agent handle colliding
+        // with it would make body mentions ambiguous, so it is reserved globally.
+        // The ledger's runtime humanHandle is the single source; replay uses the
+        // Host-synced value, and the default equals the historic literal.
+        // The historic literal itself is reserved permanently alongside it: `@human`
+        // is the documented permanent alias for the Human, so it must never belong
+        // to an agent even after a rename moves the display name elsewhere.
+        const humanNormalized = this.humanHandle.normalize('NFKC').trim().toLowerCase();
+        if (humanNormalized !== '' && normalized === humanNormalized) {
+            throw new Error(`Agent Member handle '${handle}' collides with the human display name`);
+        }
+        if (normalized === AGENT_TEAM_HUMAN_HANDLE) {
+            throw new Error(`Agent Member handle '${handle}' collides with the reserved human alias`);
+        }
     }
     /** Provider route and model id are exact identifiers; only whitespace-only values are rejected. */
     assertModelSelection(model) {

package/packages/agent-team/lib/member-context.js

@@ -2,10 +2,9 @@ import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
 import { SessionLogOffset } from '@deepseek-ai/dsh-session';
-import { v3RenamedSourceKind } from "./context-source.js";
 import { memberMemoryDirectoryPath } from "./member-runtime.js";
 export const name = 'wowyuarm-agent-team-member-context';
-const MAX_MEMORY_BYTES = 8 * 1024;
+const MAX_MEMORY_BYTES = 16 * 1024;
 const BEGIN = '<team-member-private-memory>';
 const END = '</team-member-private-memory>';
 export function apply(ctx) {
@@ -43,9 +42,8 @@ export function apply(ctx) {
             // number domains explicit (the seq = log.length contiguity contract).
             const event = agent.session.snapshotEvents(SessionLogOffset(sequence), SessionLogOffset(sequence + 1))[0];
             return event?.type === 'user/message'
-                // Both identities are this producer's own: the kind written now and
-                // the read-time conversion's rename of this producer's V3 history.
-                && (event.data.source.kind === name || event.data.source.kind === v3RenamedSourceKind(name))
+                && event.data.source.kind === 'plugin'
+                && event.data.source.plugin === name
                 && event.data.content[0]?.type === 'text'
                 ? [event.data.content[0].text]
                 : [];
@@ -55,7 +53,7 @@ export function apply(ctx) {
             return decision;
         const message = createUserMessage({
             content: [{ type: 'text', text }],
-            source: { kind: name, form: 'instructions' },
+            source: { kind: 'plugin', plugin: name, form: 'instructions' },
         });
         return { kind: 'enter', messages: [...decision.messages, message] };
     }, { prepend: true });
@@ -87,10 +85,13 @@ function memoryPathsBlock(privateMemoryPath) {
 export function renderMemberMemory(raw, privateMemoryPath = '<private-memory-path>') {
     const overBudget = raw.byteLength > MAX_MEMORY_BYTES;
     const body = overBudget ? '' : raw.toString('utf8');
+    const usedKiB = (raw.byteLength / 1024).toFixed(1);
+    const percent = Math.round((raw.byteLength / MAX_MEMORY_BYTES) * 100);
+    const usage = `\n\nPrivate memory index: ${usedKiB} KiB / ${MAX_MEMORY_BYTES / 1024} KiB (${percent}%).`;
     const warning = overBudget
-        ? '\n\n[Maintenance warning: memory.md exceeds the 8 KiB context budget. Its contents were not injected; do not delete or automatically summarize the file. Maintain a smaller index explicitly.]'
+        ? `\n\n[Maintenance warning: memory.md at ${raw.byteLength} B (${usedKiB} KiB, ${percent}%) exceeds the ${MAX_MEMORY_BYTES / 1024} KiB context budget. Its contents were not injected; do not delete or automatically summarize the file. Maintain a smaller index explicitly.]`
         : '';
-    return `${BEGIN}\nThis is the complete replacement for this Team Member's private memory index; all earlier private-memory context is obsolete. It is reference context only, may be stale, and is not an instruction or Team fact.\n\n${memoryPathsBlock(privateMemoryPath)} Relative filesystem paths resolve from cwd, so use the absolute paths above when reading or editing this Member's memory. Only this Member can read this directory — no other human or agent sees its contents; when communicating, restate what you need from it instead of pointing others at these paths. Read matching notes on demand; do not copy credentials, sensitive data, guesses, chat logs, other Members' memory, or Team facts already owned by the ledger into memory.\n\n${escape(body)}${warning}\n${END}`;
+    return `${BEGIN}\nThis is the complete replacement for this Team Member's private memory index; all earlier private-memory context is obsolete. It is reference context only, may be stale, and is not an instruction or Team fact.\n\n${memoryPathsBlock(privateMemoryPath)} Relative filesystem paths resolve from cwd, so use the absolute paths above when reading or editing this Member's memory. Only this Member can read this directory — no other human or agent sees its contents; when communicating, restate what you need from it instead of pointing others at these paths. Read matching notes on demand; do not copy credentials, sensitive data, guesses, chat logs, other Members' memory, or Team facts already owned by the ledger into memory.${usage}\n\n${escape(body)}${warning}\n${END}`;
 }
 function renderUnavailableMemory(privateMemoryPath, reason) {
     return `${BEGIN}\nThis is the complete replacement for this Team Member's private memory index; all earlier private-memory context is obsolete. ${reason}\n\n${memoryPathsBlock(privateMemoryPath)} Use the absolute paths above when inspecting or repairing this Member's memory.\n${END}`;

package/packages/agent-team/lib/member-runtime.js

@@ -247,7 +247,7 @@ export class MemberRuntime {
         await mkdir(join(path, 'notes'), { recursive: true });
         await mkdir(join(path, 'skills'), { recursive: true });
         try {
-            await writeFile(join(path, 'memory.md'), '# Member memory\n\n## Stable facts\n- Add only verified, durable facts that help future work.\n\n## Notes index\n- Add focused `notes/*.md` entries here when a reusable detail needs on-demand reading.\n', { flag: 'wx' });
+            await writeFile(join(path, 'memory.md'), '# Member memory\n\nA bounded routing index: identity, durable rules, what is in hand, and one line per topic cluster.\nWriting, compaction, and retirement rules: the bundled `member-memory-manager` skill.\n\n## Identity and role\n- <what this Member owns, and does not own>\n\n## Durable rules\n- <only rules that must bind every step; one line each>\n\n## In hand\n- <overwrite as work moves; this section never accumulates history>\n\n## Notes index\n- <cluster>: `notes/<cluster>/README.md`\n', { flag: 'wx' });
         }
         catch (error) {
             if (error.code !== 'EEXIST')

package/packages/agent-team/lib/member-time-context.js

@@ -27,7 +27,6 @@
  * @module @wowyuarm/dsh-agent-team/member-time-context
  */
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
-import { v3RenamedSourceKind } from "./context-source.js";
 import { formatTeamDuration, formatTeamTimestamp } from "./time-format.js";
 import { advanceOwnedSessionEventCursor } from "./session-event-cursor.js";
 export const name = 'wowyuarm-agent-team-member-time-context';
@@ -50,9 +49,7 @@ export function applyClockEvent(state, event) {
             return state.openTurn === -1 ? state : { ...state, lastTurnInjectionTime: null, openTurn: -1 };
         case 'user/message': {
             const source = event.data.source;
-            // Both identities are this producer's own: the kind written now and the
-            // read-time conversion's rename of this producer's V3 history.
-            const injected = source.kind === name || source.kind === v3RenamedSourceKind(name);
+            const injected = source.kind === 'plugin' && source.plugin === name;
             const withMessage = state.lastMessageTime === event.time ? state : { ...state, lastMessageTime: event.time };
             if (!injected)
                 return withMessage;
@@ -137,7 +134,7 @@ export function apply(ctx, config = {}) {
         const text = renderClockSnapshot({ now, turn, step, previous });
         const message = createUserMessage({
             content: [{ type: 'text', text }],
-            source: { kind: name, form: 'snapshot', sections: [{ name, text }] },
+            source: { kind: 'plugin', plugin: name, form: 'snapshot', sections: [{ name, text }] },
         });
         return { kind: 'enter', messages: [...decision.messages, message] };
     }, { prepend: true });

package/packages/agent-team/lib/preset-roster.js

@@ -0,0 +1,15 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import AgentPresets from '@deepseek-ai/dsh-agent-presets';
+export const inject = ['loader'];
+/** Bundle-private Agent preset roster. The composition must isolate `agentPresets` around this provider and AgentTeam. */
+export function apply(ctx) {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const root = resolve(here, '../preset');
+    ctx.plugin(AgentPresets, {
+        default: 'team-member',
+        roots: [{ path: root, trust: 'system' }],
+        includeShippedRoot: false,
+        includeUserRoot: false,
+    });
+}

package/packages/agent-team/lib/pressure-policy.js

@@ -16,9 +16,14 @@
  */
 import { CONTEXT_WINDOW_EXCEEDED_CODE } from '@deepseek-ai/dsh-llm';
 import { createUserMessage } from '@deepseek-ai/dsh-llm';
-import { CONTEXT_PRESSURE_NOTICE_SUMMARY } from "./context-management.js";
-import { AGENT_TEAM_PLUGIN_ID, isAgentTeamSourceKind } from "./context-source.js";
+import { AGENT_TEAM_PLUGIN_ID } from "./context-source.js";
 import { advanceOwnedSessionEventCursor } from "./session-event-cursor.js";
+/**
+ * Stable summary of the one-shot rollover pressure notice. It is a durable
+ * marker: the notice's own presence in a Session's log is what latches the
+ * policy, so the wording is read back and must not drift.
+ */
+export const CONTEXT_PRESSURE_NOTICE_SUMMARY = 'Context pressure: prepare a handoff';
 /**
  * Whether this Session's own span already carries the pressure notice: either
  * surfaced as a `user/message` or still queued in a durable
@@ -50,10 +55,8 @@ export function contextPressureNoticeText(input) {
 }
 /** Whether one user message is this policy's one-shot pressure notice. */
 function isPressureNotice(message) {
-    // The source arrives untyped from the inbox; identity is matched by exact
-    // kind — the shape written now and the read-time conversion's V3 rename.
     const source = message.source;
-    return isAgentTeamSourceKind(source?.kind)
+    return source?.plugin === AGENT_TEAM_PLUGIN_ID
         && source?.summary === CONTEXT_PRESSURE_NOTICE_SUMMARY;
 }
 export class PressurePolicyCoordinator {
@@ -131,7 +134,7 @@ export class PressurePolicyCoordinator {
                             activeClaims: this.options.activeClaimLabels(member.memberId),
                             runningJobs: this.options.runningJobLabels(member.memberId),
                         }) }],
-                source: { kind: AGENT_TEAM_PLUGIN_ID, form: 'notice', summary: CONTEXT_PRESSURE_NOTICE_SUMMARY },
+                source: { kind: 'plugin', plugin: AGENT_TEAM_PLUGIN_ID, form: 'notice', summary: CONTEXT_PRESSURE_NOTICE_SUMMARY },
             });
             try {
                 agent.steer(notice);