@yeaft/webchat-agent 1.0.326 → 1.0.329

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.326",
+  "version": "1.0.329",
   "description": "Remote worker agent for Yeaft Web Code Agent — connects the native Yeaft engine, CLI providers, and workbench tools",
   "main": "index.js",
   "type": "module",

package/yeaft/engine.js

@@ -31,6 +31,7 @@ import { evaluateCompactTriggers } from './compact/triggers.js';
 import { archiveTurn } from './archive/turn-archive.js';
 import { archiveToolResults } from './archive/tool-results.js';
 import { readSummary as readScopeSummary } from './memory/store.js';
+import { ActiveMemorySet } from './memory/ams.js';
 import { runAdjust } from './memory/adjust.js';
 import { cleanMemoryPromptText, isMemoryPromptRelevant } from './memory/prompt-cleanup.js';
 import { isVpSeedBackfillStub } from './memory/seed-backfill.js';
@@ -44,7 +45,7 @@ import { lookupModelLimitSync } from './llm/models-dev.js';
 import { countTurns } from './turn-utils.js';
 import { attachRouterPlan, extractPriorPlan, stripMetaForWire } from './router/continuity.js';
 import { resolveThinking } from './router/thinking.js';
-import { approxTokens } from './memory/budget.js';
+import { approxTokens, computeBudget } from './memory/budget.js';
 import { COLLAB_TOOL_POLICY, isToolErrorOutput, normalizeToolOutput, truncateToolResultIfNeeded } from './tools/registry.js';
 import { extractDisplayImages, stripDisplayImageData } from './image-assets.js';
 import { acknowledgePendingNotifications, formatNotificationsForPrompt, peekPendingNotifications } from './sub-agent/notifications.js';
@@ -399,7 +400,7 @@ export function shouldAllowGroupReflection({
  * @param {{
  *   sessionId?: string|null,
  *   ownVpId?: string|null,
- *   summaries: { user?: string, session?: string, vp?: string, topics?: Array<{scope:string, summary:string}> }
+ *   summaries: { user?: string, session?: string, vp?: string, topics?: Array<{scope:string, summary:string}>, relatedSessions?: Array<{sessionId:string, summary:string}> }
  * }} args
  * @returns {Array<{scope: string, summary: string}>}
  */
@@ -445,6 +446,18 @@ export function buildResidentEntries(args) {
   if (args.sessionId && args.ownVpId && vpSummary && !isVpSeedBackfillStub(vpSummary)) {
     out.push({ scope: `sessions/${args.sessionId}/vp/${args.ownVpId}`, summary: vpSummary });
   }
+  // Related Session experience is useful but lower-priority than every memory
+  // source owned by the active Session/VP. Append it last so the resident
+  // budget can never evict current context in favour of historical prose.
+  if (Array.isArray(summaries.relatedSessions)) {
+    for (const related of summaries.relatedSessions) {
+      const relatedSessionId = typeof related?.sessionId === 'string' ? related.sessionId.trim() : '';
+      const summary = cleanMemoryPromptText(related?.summary);
+      if (relatedSessionId && relatedSessionId !== args.sessionId && summary) {
+        out.push({ scope: `sessions/${relatedSessionId}`, summary });
+      }
+    }
+  }
   return out;
 }
 
@@ -452,6 +465,11 @@ function isZhRuntimeLanguage(language) {
   return String(language || '').toLowerCase().startsWith('zh');
 }
 
+function sessionIdFromMemoryScope(scope) {
+  const match = /^(?:sessions|session|group)\/([^/]+)$/.exec(String(scope || ''));
+  return match ? match[1] : null;
+}
+
 function resolveMemoryRecallLimit(config) {
   const raw = config?.memoryRecallLimit ?? config?.dreamMemoryRecallLimit;
   if (!Number.isFinite(raw) || raw <= 0) return DEFAULT_MEMORY_RECALL_LIMIT;
@@ -476,6 +494,7 @@ function loadedResidentDebugEntries(entries) {
     kind: 'summary',
     score: null,
     tags: [],
+    category: entry.category || null,
     body: entry.summary || '',
   })).filter(entry => entry.body);
 }
@@ -910,13 +929,17 @@ export class Engine {
    * dream tick (Phase 6) is what populates these; on a fresh install they
    * all return ''.
    *
-   * @param {{sessionId?: string, vpId?: string, language?: string, topicScopes?: string[]}} ctx
-   * @returns {Promise<{user:string, session:string, vp:string, topics:Array<{scope:string, summary:string}>}>}
+   * @param {{sessionId?: string, vpId?: string, language?: string, topicScopes?: string[], relatedSessionIds?: string[]}} ctx
+   * @returns {Promise<{user:string, session:string, vp:string, topics:Array<{scope:string, summary:string}>, relatedSessions:Array<{sessionId:string, summary:string}>}>}
    */
-  async #loadLayerASummaries({ sessionId, vpId, language, topicScopes } = {}) {
-    if (!this.#yeaftDir) return { user: '', session: '', vp: '', topics: [] };
+  async #loadLayerASummaries({ sessionId, vpId, language, topicScopes, relatedSessionIds } = {}) {
+    if (!this.#yeaftDir) return { user: '', session: '', vp: '', topics: [], relatedSessions: [] };
     const memoryRoot = `${this.#yeaftDir}/memory`;
     const topicScopeList = Array.isArray(topicScopes) ? topicScopes.slice(0, 12) : [];
+    const relatedIds = Array.from(new Set((Array.isArray(relatedSessionIds) ? relatedSessionIds : [])
+      .filter(id => typeof id === 'string' && id.trim() && id.trim() !== sessionId)
+      .map(id => id.trim())))
+      .slice(0, 8);
     const tasks = [
       readScopeSummary({ kind: 'user' }, { root: memoryRoot, language }).catch(() => ''),
       sessionId
@@ -926,10 +949,18 @@ export class Engine {
         ? readScopeSummary({ kind: 'session-vp', sessionId, id: vpId }, { root: memoryRoot, language }).catch(() => '')
         : Promise.resolve(''),
       Promise.all(topicScopeList.map(scope => readTopicSummary(scope, { root: memoryRoot, language }))),
+      Promise.all(relatedIds.map(async relatedSessionId => ({
+        sessionId: relatedSessionId,
+        summary: await readScopeSummary(
+          { kind: 'session', id: relatedSessionId },
+          { root: memoryRoot, language },
+        ).catch(() => ''),
+      }))),
     ];
-    const [user, session, vp, topicsRaw] = await Promise.all(tasks);
+    const [user, session, vp, topicsRaw, relatedSessionsRaw] = await Promise.all(tasks);
     const topics = (topicsRaw || []).filter(t => t && t.summary);
-    return { user: user || '', session: session || '', vp: vp || '', topics };
+    const relatedSessions = (relatedSessionsRaw || []).filter(entry => entry && entry.summary);
+    return { user: user || '', session: session || '', vp: vp || '', topics, relatedSessions };
   }
 
   async #loadSessionTopicLabels(sessionId, limit = 8) {
@@ -967,27 +998,42 @@ export class Engine {
    * } | null}
    */
   #prepareAms(args) {
-    if (!this.#amsRegistry) return null;
     const sessionKey = args.sessionId || 'default';
     const ownVpId = args.ownVpId || null;
-    const ams = this.#amsRegistry.getOrCreate(sessionKey, { ownVpId });
+    // Some read-only Engine entry points (notably sub-agents) intentionally do
+    // not own the parent's persistent registry. They still need the single AMS
+    // render outlet, otherwise FTS recall succeeds and then vanishes before the
+    // prompt. Use an isolated per-query AMS in that case: it preserves budgets,
+    // cleanup, and dedupe without sharing mutable parent state or writing disk.
+    const ams = this.#amsRegistry
+      ? this.#amsRegistry.getOrCreate(sessionKey, { ownVpId })
+      : new ActiveMemorySet({
+          ownVpId,
+          budget: computeBudget(this.#config?.maxContextTokens),
+        });
 
     // Prime #adjustRanBySession from disk-hydrated state on first access:
     // a reactivated group resumes with whatever adjustRanThisSession bit
     // it had on disconnect, so we don't burn a fresh adjust on every
     // reload. Once set true in this session we never clear it.
-    if (!this.#adjustRanBySession.has(sessionKey)
+    if (this.#amsRegistry
+        && !this.#adjustRanBySession.has(sessionKey)
         && this.#amsRegistry.adjustRanThisSession(sessionKey)) {
       this.#adjustRanBySession.set(sessionKey, true);
     }
 
     // (a) Resident: rebuild from the same scope summaries the worker
     // prompt is already going to see.
+    const relatedSessionIds = new Set((args.summaries?.relatedSessions || [])
+      .map(entry => entry?.sessionId)
+      .filter(Boolean));
     const residentEntries = buildResidentEntries({
       sessionId: args.sessionId,
       ownVpId,
       summaries: args.summaries || {},
-    });
+    }).map(entry => relatedSessionIds.has(entry.scope.replace(/^sessions\//, ''))
+      ? { ...entry, category: 'experience' }
+      : { ...entry, category: 'memory' });
     ams.setResident(residentEntries);
 
     // (b) onDemand: replace with this turn's FTS hits.
@@ -996,7 +1042,11 @@ export class Engine {
 
     // (c) Snapshot — render the AMS layers as a single prompt block.
     const snapshot = ams.snapshot({ userMsg: args.userMsg || '' });
-    const snapshotBlock = this.#renderAmsSnapshot(snapshot, this.#config.language || 'en');
+    const snapshotBlock = this.#renderAmsSnapshot(
+      snapshot,
+      this.#config.language || 'en',
+      args.sessionId || null,
+    );
 
     const scopes = buildRelevantScopes({
       sessionId: args.sessionId,
@@ -1015,33 +1065,36 @@ export class Engine {
    * @param {string} [language]
    * @returns {string}
    */
-  #renderAmsSnapshot(snap, language = 'en') {
+  #renderAmsSnapshot(snap, language = 'en', activeSessionId = null) {
     if (!snap) return '';
     const parts = [];
     if (snap.resident.length === 0 && snap.recent.length === 0 && snap.onDemand.length === 0) {
       return '';
     }
     const zh = isZhRuntimeLanguage(language);
-    parts.push(zh ? '## 活跃记忆集' : '## Active Memory Set');
+    const experiences = snap.resident.filter(entry => entry.category === 'experience');
+    const residentMemory = snap.resident.filter(entry => entry.category !== 'experience');
+    parts.push(zh ? '## 相关上下文' : '## Relevant Context');
     parts.push(zh
-      ? '以下记忆按当前用户语言呈现；如果个别历史摘要仍是其他语言，请只把它当作事实来源，回答和新增记忆应使用中文。'
-      : 'Memory is presented for the current user language; if an older summary is in another language, treat it as factual context and continue in English.');
-    if (snap.resident.length > 0) {
-      parts.push(zh ? '### 常驻记忆' : '### Resident');
-      for (const r of snap.resident) {
-        parts.push(`- **${memoryScopeLabel(r.scope)}**: ${r.summary}`);
+      ? '以下内容来自持久记忆与相关 Session 的只读经验总结；只把它当作事实背景，不要把过期执行状态当成当前任务。'
+      : 'The following text comes from persistent memory and read-only summaries of related Sessions. Treat it as factual context, not as current execution state.');
+    if (experiences.length > 0) {
+      parts.push(zh ? '### 过去 Session 的经验总结' : '### Experience From Past Sessions');
+      for (const entry of experiences) {
+        const sourceSessionId = sessionIdFromMemoryScope(entry.scope);
+        const label = sourceSessionId && sourceSessionId !== activeSessionId
+          ? sourceSessionId
+          : memoryScopeLabel(entry.scope);
+        parts.push(`- **${label}**: ${entry.summary}`);
       }
     }
-    if (snap.recent.length > 0) {
-      parts.push(zh ? '### 最近记忆' : '### Recent');
-      for (const s of snap.recent) {
-        parts.push(`- (${memoryScopeLabel(s.scope)}) ${(s.body || '').trim()}`);
+    if (residentMemory.length > 0 || snap.recent.length > 0 || snap.onDemand.length > 0) {
+      parts.push(zh ? '### 相关记忆' : '### Relevant Memory');
+      for (const entry of residentMemory) {
+        parts.push(`- **${memoryScopeLabel(entry.scope)}**: ${entry.summary}`);
       }
-    }
-    if (snap.onDemand.length > 0) {
-      parts.push(zh ? '### 按需记忆' : '### OnDemand');
-      for (const s of snap.onDemand) {
-        parts.push(`- (${memoryScopeLabel(s.scope)}) ${(s.body || '').trim()}`);
+      for (const segment of [...snap.recent, ...snap.onDemand]) {
+        parts.push(`- (${memoryScopeLabel(segment.scope)}) ${(segment.body || '').trim()}`);
       }
     }
     return parts.join('\n');
@@ -1148,13 +1201,14 @@ export class Engine {
    * @param {object} [args.activeScope] — DESIGN-PROMPT §3 ④ structured scope summary
    * @param {string} [args.sessionAnnouncement]
    * @param {string} [args.projectInstruction] — server-managed instruction shared by Project Sessions
+   * @param {string} [args.projectLabel] — current Project name and id for prompt attribution
    * @param {string} [args.workCenterInstructions] — frozen Agent-level Work Center policy
    * @param {string} [args.projectDoc] — resolved CLAUDE.md / AGENTS.md text (already truncated)
    * @param {object} [args.taskCtx] — legacy task-context sub-block (optional)
    * @param {string} [args.explicitSkillName] — leading /skill:<name> command, if present
    * @returns {string}
    */
-  #buildSystemPrompt({ prompt, memoryInjection, vpPersona, activeScope, sessionAnnouncement, projectInstruction, workCenterInstructions, projectDoc, taskCtx, activeTasks, explicitSkillName, resolvedSkillContent = null } = {}) {
+  #buildSystemPrompt({ prompt, memoryInjection, vpPersona, activeScope, sessionAnnouncement, projectInstruction, projectLabel, workCenterInstructions, projectDoc, taskCtx, activeTasks, explicitSkillName, resolvedSkillContent = null } = {}) {
     // Skill selection is normally resolved once by #runQuery so the prompt and
     // emitted protocol events describe the exact same skills. Keep the local
     // fallback for internal callers that do not need selection events.
@@ -1182,6 +1236,7 @@ export class Engine {
       activeScope,
       sessionAnnouncement,
       projectInstruction,
+      projectLabel,
       workCenterInstructions,
       projectDoc,
       runtimePlatform: getRuntimePlatformInfo(),
@@ -1367,6 +1422,9 @@ export class Engine {
         projectSessionIds: Array.isArray(vpCtx?.projectSessionIds)
           ? vpCtx.projectSessionIds.slice()
           : [],
+        projectLabel: typeof vpCtx?.projectLabel === 'string'
+          ? vpCtx.projectLabel
+          : '',
         projectInstruction: typeof vpCtx?.projectInstruction === 'string'
           ? vpCtx.projectInstruction
           : '',
@@ -1914,7 +1972,7 @@ export class Engine {
     }
   }
 
-  async *#queryLifecycle({ prompt, promptParts = null, messages = [], signal, userEffort = null, scenario = 'chat', vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds = null, projectInstruction = '', sessionTopics = null, vpPlan, sessionAnnouncement, workCenterInstructions, workDir, userAlreadyPersisted = false, getCurrentTodos = null, setCurrentTodos = null, askUser = null, threadId = MAIN_THREAD_ID, vpTurnId = null, drainPendingUserMessages = null, prepareProviderRequest = null, startProviderRequest = null, finishProviderRequest = null, failProviderRequest = null, closePendingUserInput = null, collabToolPolicy = null } = {}) {
+  async *#queryLifecycle({ prompt, promptParts = null, messages = [], signal, userEffort = null, scenario = 'chat', vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds = null, projectInstruction = '', projectLabel = '', sessionTopics = null, vpPlan, sessionAnnouncement, workCenterInstructions, workDir, userAlreadyPersisted = false, getCurrentTodos = null, setCurrentTodos = null, askUser = null, threadId = MAIN_THREAD_ID, vpTurnId = null, drainPendingUserMessages = null, prepareProviderRequest = null, startProviderRequest = null, finishProviderRequest = null, failProviderRequest = null, closePendingUserInput = null, collabToolPolicy = null } = {}) {
     if (!prompt || typeof prompt !== 'string' || !prompt.trim()) {
       const error = new Error('prompt is required and must be a non-empty string');
       yield {
@@ -2000,7 +2058,7 @@ export class Engine {
     };
     try {
       this.#currentThreadId = threadId || MAIN_THREAD_ID;
-      yield* this.#runQuery({ prompt: effectivePrompt, promptParts: effectivePromptParts, messages, signal: runSignal, userEffort: effectiveUserEffort, scenario, vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds, projectInstruction, sessionTopics, vpPlan, sessionAnnouncement, workCenterInstructions, workDir, userAlreadyPersisted, getCurrentTodos, setCurrentTodos, askUser, threadId: this.#currentThreadId, vpTurnId, drainPendingUserMessages, prepareProviderRequest, startProviderRequest, finishProviderRequest, failProviderRequest, closePendingUserInput, collabToolPolicy: effectiveCollabToolPolicy, explicitSkillName: parsedSkill.skillName, retryLifecycle });
+      yield* this.#runQuery({ prompt: effectivePrompt, promptParts: effectivePromptParts, messages, signal: runSignal, userEffort: effectiveUserEffort, scenario, vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds, projectInstruction, projectLabel, sessionTopics, vpPlan, sessionAnnouncement, workCenterInstructions, workDir, userAlreadyPersisted, getCurrentTodos, setCurrentTodos, askUser, threadId: this.#currentThreadId, vpTurnId, drainPendingUserMessages, prepareProviderRequest, startProviderRequest, finishProviderRequest, failProviderRequest, closePendingUserInput, collabToolPolicy: effectiveCollabToolPolicy, explicitSkillName: parsedSkill.skillName, retryLifecycle });
     } finally {
       // Closing the async generator at a visible retry boundary means the
       // continuation never reached a provider. Keep it out of history and
@@ -2048,7 +2106,7 @@ export class Engine {
    * in a try/finally without indenting the whole loop.
    * @private
    */
-  async *#runQuery({ prompt, promptParts = null, messages, signal, userEffort = null, scenario = 'chat', vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds = null, projectInstruction = '', sessionTopics = null, vpPlan, sessionAnnouncement, workCenterInstructions, workDir, userAlreadyPersisted = false, getCurrentTodos = null, setCurrentTodos = null, askUser = null, threadId = MAIN_THREAD_ID, vpTurnId = null, drainPendingUserMessages = null, prepareProviderRequest = null, startProviderRequest = null, finishProviderRequest = null, failProviderRequest = null, closePendingUserInput = null, collabToolPolicy = null, explicitSkillName = null, retryLifecycle }) {
+  async *#runQuery({ prompt, promptParts = null, messages, signal, userEffort = null, scenario = 'chat', vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds = null, projectInstruction = '', projectLabel = '', sessionTopics = null, vpPlan, sessionAnnouncement, workCenterInstructions, workDir, userAlreadyPersisted = false, getCurrentTodos = null, setCurrentTodos = null, askUser = null, threadId = MAIN_THREAD_ID, vpTurnId = null, drainPendingUserMessages = null, prepareProviderRequest = null, startProviderRequest = null, finishProviderRequest = null, failProviderRequest = null, closePendingUserInput = null, collabToolPolicy = null, explicitSkillName = null, retryLifecycle }) {
 
     const effectiveCollabToolPolicy = collabToolPolicy === COLLAB_TOOL_POLICY.SINGLE_VP || collabToolPolicy === COLLAB_TOOL_POLICY.MULTI_VP
       ? collabToolPolicy
@@ -2146,6 +2204,7 @@ export class Engine {
         : (typeof senderVpId === 'string' ? senderVpId : undefined),
       language: this.#config.language || 'en',
       topicScopes: topicScopesForResident,
+      relatedSessionIds: projectSessionIds,
     });
 
     // ─── AMS: populate + snapshot ───────────────────────────────
@@ -2211,7 +2270,9 @@ export class Engine {
 
     const projectDoc = this.#getProjectDocBlock(workDir);
     const activeTasks = this.#taskManager
-      ? this.#taskManager.renderActiveTasksForPrompt(runtimeSessionId)
+      ? this.#taskManager.renderActiveTasksForPrompt(runtimeSessionId, {
+          language: this.#config.language || 'en',
+        })
       : '';
     let resolvedSkillContent = '';
     let resolvedSkills = [];
@@ -2247,6 +2308,7 @@ export class Engine {
       activeScope,
       sessionAnnouncement,
       projectInstruction,
+      projectLabel,
       workCenterInstructions,
       projectDoc,
       activeTasks,
@@ -3650,6 +3712,7 @@ export class Engine {
         sessionId: runtimeSessionId,
         projectSessionIds,
         projectInstruction,
+        projectLabel,
         threadId: runtimeThreadId,
         inboundEnvelope,
         taskId,

package/yeaft/memory/ams.js

@@ -29,14 +29,14 @@ const RECENT_DEFAULT_CAPACITY = 64;
 
 /**
  * @typedef {object} AmsLayers
- * @property {Map<string, string>}                resident
+ * @property {Map<string, { summary: string, category?: string }>} resident
  * @property {Array<{ id: string, seg: import('./segment.js').Segment, ts: number }>} recent
  * @property {Map<string, import('./segment.js').Segment>} onDemand
  */
 
 /**
  * @typedef {object} AmsSnapshot
- * @property {Array<{ scope: string, summary: string }>} resident
+ * @property {Array<{ scope: string, summary: string, category?: string }>} resident
  * @property {import('./segment.js').Segment[]} recent
  * @property {import('./segment.js').Segment[]} onDemand
  * @property {{ resident: number, recent: number, onDemand: number, total: number }} usage
@@ -55,8 +55,8 @@ export class ActiveMemorySet {
     this.ownVpId = opts.ownVpId || null;
     this.budget = opts.budget;
     this.recentCapacity = opts.recentCapacity || RECENT_DEFAULT_CAPACITY;
-    /** @type {Map<string, string>} */
-    this._resident = new Map();          // scope → summaryText
+    /** @type {Map<string, { summary: string, category?: string }>} */
+    this._resident = new Map();          // scope → prompt-facing summary metadata
     /** @type {Map<string, { seg: import('./segment.js').Segment, ts: number }>} */
     this._recent = new Map();            // segId → entry (insertion-order is LRU order)
     /** @type {Map<string, import('./segment.js').Segment>} */
@@ -69,7 +69,7 @@ export class ActiveMemorySet {
    * Replace the resident layer with a fresh set of scope→summary
    * pairs. Foreign VP scopes are silently dropped.
    *
-   * @param {Array<{ scope: string, summary: string }>} entries
+   * @param {Array<{ scope: string, summary: string, category?: string }>} entries
    */
   setResident(entries) {
     this._resident.clear();
@@ -77,7 +77,10 @@ export class ActiveMemorySet {
       if (this._isForeignVp(e.scope)) continue;
       const summary = cleanMemoryPromptText(e.summary);
       if (!summary) continue;
-      this._resident.set(e.scope, summary);
+      this._resident.set(e.scope, {
+        summary,
+        ...(typeof e.category === 'string' && e.category ? { category: e.category } : {}),
+      });
     }
   }
 
@@ -159,8 +162,15 @@ export class ActiveMemorySet {
     // Resident: pack scopes by priority order (caller provides via insert
     // order — current group's own vp first, then user, etc.).
     const { picked: resPicked, cost: resCost } = pickMemoryItems({
-      items: [...this._resident.entries()].map(([scope, summary]) => ({
-        scope, summary: filterMemoryPromptTextForPrompt(summary, userMsg),
+      items: [...this._resident.entries()].map(([scope, entry]) => ({
+        scope,
+        // Related-Session summaries are explicitly historical context. Keep the
+        // bounded prose intact and label it as experience instead of dropping
+        // the whole paragraph because it mentions an old PR/tag/task state.
+        summary: entry.category === 'experience'
+          ? cleanMemoryPromptText(entry.summary)
+          : filterMemoryPromptTextForPrompt(entry.summary, userMsg),
+        ...(entry.category ? { category: entry.category } : {}),
       })),
       budget: this.budget.resident,
       seen: seenPromptText,

package/yeaft/prompts.js

@@ -205,7 +205,9 @@ const PROMPTS = {
     multiVpRoutingHeader: '## multi_vp_routing',
     sessionAnnouncementHeader: '[Session Announcement]',
     projectInstructionHeader: '[Project Instruction]',
-    projectInstructionIntro: 'This server-managed instruction applies to every Session in the current Project.',
+    projectInstructionIntro: (projectLabel) => projectLabel
+      ? `The current Session belongs to Project ${projectLabel}. The unified instruction for this Project is:`
+      : 'The current Session belongs to the current Project. The unified instruction for this Project is:',
     workCenterInstructionsHeader: '[Work Center Agent Instructions]',
     workCenterInstructionsIntro: 'These Agent-level instructions apply to every Action in this WorkItem. Follow them unless they conflict with system/tool safety rules, the authoritative project document, or the WorkItem contract.',
     // Project-doc (CLAUDE.md / AGENTS.md) header + one-liner intro. Both
@@ -229,7 +231,9 @@ const PROMPTS = {
     multiVpRoutingHeader: '## multi_vp_routing',
     sessionAnnouncementHeader: '[会话公告]',
     projectInstructionHeader: '[Project 指令]',
-    projectInstructionIntro: '这是服务器管理的 Project 级指令，适用于当前 Project 内的所有 Session。',
+    projectInstructionIntro: (projectLabel) => projectLabel
+      ? `当前 Session 隶属于 Project ${projectLabel}。当前 Project 的统一 instruction 是：`
+      : '当前 Session 隶属于当前 Project。当前 Project 的统一 instruction 是：',
     workCenterInstructionsHeader: '[Work Center Agent 指令]',
     workCenterInstructionsIntro: '这些 Agent 级指令作用于当前 Work Item 的每个 Action。除非与系统/工具安全规则、权威项目文档或 Work Item 契约冲突，否则必须遵循。',
     // 项目文档块：CLAUDE.md / AGENTS.md（与 Codex 通用命名兼容）。
@@ -302,6 +306,7 @@ export function normalizePromptLanguage(language) {
  *   vpPersona?: object,
  *   sessionAnnouncement?: string,
  *   projectInstruction?: string,
+ *   projectLabel?: string,
  *   workCenterInstructions?: string,
  *   projectDoc?: string,
  * }} params
@@ -317,6 +322,7 @@ export function buildSystemPrompt({
   vpPersona,
   sessionAnnouncement = '',
   projectInstruction = '',
+  projectLabel = '',
   workCenterInstructions = '',
   projectDoc = '',
   runtimePlatform,
@@ -366,7 +372,10 @@ export function buildSystemPrompt({
   const projectInstructionText = typeof projectInstruction === 'string' ? projectInstruction.trim() : '';
   if (projectInstructionText) {
     const header = lang.projectInstructionHeader || '[Project Instruction]';
-    const intro = lang.projectInstructionIntro || '';
+    const normalizedProjectLabel = typeof projectLabel === 'string' ? projectLabel.trim() : '';
+    const intro = typeof lang.projectInstructionIntro === 'function'
+      ? lang.projectInstructionIntro(normalizedProjectLabel)
+      : '';
     parts.push(`${header}\n${intro ? `${intro}\n\n` : ''}${projectInstructionText}`);
   }
 

package/yeaft/sub-agent/prompt-queue.js

@@ -6,7 +6,7 @@
  *
  * @param {object} agent
  * @param {string} prompt
- * @param {{ projectSessionIds?: string[], projectInstruction?: string }} projectContext
+ * @param {{ projectSessionIds?: string[], projectLabel?: string, projectInstruction?: string }} projectContext
  */
 export function enqueueSubAgentPrompt(agent, prompt, projectContext = {}) {
   if (!Array.isArray(agent.pendingPrompts)) agent.pendingPrompts = [];
@@ -15,6 +15,9 @@ export function enqueueSubAgentPrompt(agent, prompt, projectContext = {}) {
     projectSessionIds: Array.isArray(projectContext.projectSessionIds)
       ? projectContext.projectSessionIds.slice()
       : [],
+    projectLabel: typeof projectContext.projectLabel === 'string'
+      ? projectContext.projectLabel
+      : '',
     projectInstruction: typeof projectContext.projectInstruction === 'string'
       ? projectContext.projectInstruction
       : '',

package/yeaft/sub-agent/runner.js

@@ -125,6 +125,7 @@ export function isRestrictedToolName(name) {
  *   parentVpId?: string,
  *   parentSessionId?: string|null,
  *   projectSessionIds?: string[],
+ *   projectLabel?: string,
  *   projectInstruction?: string,
  *   parentThreadId?: string|null,
  *   parentVpPersona?: object,
@@ -325,6 +326,9 @@ async function driveSubAgent(agent, subEngine, vpPersona, deps) {
         projectSessionIds: Array.isArray(deps.projectSessionIds)
           ? deps.projectSessionIds.slice()
           : [],
+        projectLabel: typeof deps.projectLabel === 'string'
+          ? deps.projectLabel
+          : '',
         projectInstruction: typeof deps.projectInstruction === 'string'
           ? deps.projectInstruction
           : '',
@@ -336,6 +340,9 @@ async function driveSubAgent(agent, subEngine, vpPersona, deps) {
       projectSessionIds: Array.isArray(entry.projectSessionIds)
         ? entry.projectSessionIds.slice()
         : [],
+      projectLabel: typeof entry.projectLabel === 'string'
+        ? entry.projectLabel
+        : '',
       projectInstruction: typeof entry.projectInstruction === 'string'
         ? entry.projectInstruction
         : '',
@@ -407,6 +414,7 @@ async function driveSubAgent(agent, subEngine, vpPersona, deps) {
           vpPersona,
           sessionId: agent.parentSessionId || deps.parentSessionId || null,
           projectSessionIds: queuedPrompt.projectSessionIds,
+          projectLabel: queuedPrompt.projectLabel,
           projectInstruction: queuedPrompt.projectInstruction,
         });
         for await (const evt of stream) {

package/yeaft/tasks/manager.js

@@ -20,6 +20,7 @@ import { getRuntimePlatformInfo } from '../runtime-platform.js';
 const LOG_PREVIEW_BYTES = 4096;
 const SUB_AGENT_LOG_PREVIEW_BYTES = 1024 * 1024;
 const DEFAULT_CANCEL_ESCALATION_MS = 2000;
+const PROMPT_TASK_LIMIT = 5;
 
 function logPreviewBytesFor(task) {
   return task?.kind === 'sub_agent' ? SUB_AGENT_LOG_PREVIEW_BYTES : LOG_PREVIEW_BYTES;
@@ -54,9 +55,35 @@ function publicSnapshot(task) {
   };
 }
 
-function taskCommand(task) {
-  const command = task?.runtime?.command;
-  return typeof command === 'string' && command.trim() ? command.trim() : '';
+function taskKindLabel(kind, language) {
+  const zh = String(language || '').toLowerCase().startsWith('zh');
+  if (kind === 'sub_agent') return zh ? '子 Agent' : 'sub-agent';
+  if (kind === 'shell') return zh ? '后台命令' : 'background command';
+  return zh ? '后台任务' : 'background task';
+}
+
+function safeTaskName(task) {
+  const name = typeof task?.runtime?.name === 'string' ? task.runtime.name.trim() : '';
+  return /^[\p{L}\p{N}][\p{L}\p{N}._-]{0,63}$/u.test(name) ? name : '';
+}
+
+function promptTaskLabel(task, language) {
+  const name = task?.kind === 'sub_agent' ? safeTaskName(task) : '';
+  if (!name) return taskKindLabel(task?.kind, language);
+  return String(language || '').toLowerCase().startsWith('zh')
+    ? `子 Agent ${name}`
+    : `sub-agent ${name}`;
+}
+
+function taskStatusLabel(status, language) {
+  const zh = String(language || '').toLowerCase().startsWith('zh');
+  if (!zh) return String(status || 'running').replace(/_/g, ' ');
+  const labels = {
+    running: '运行中',
+    queued: '等待中',
+    cancelling: '正在取消',
+  };
+  return labels[status] || String(status || '运行中').replace(/_/g, ' ');
 }
 
 export class TaskManager {
@@ -358,17 +385,27 @@ export class TaskManager {
     return publicSnapshot(task);
   }
 
-  renderActiveTasksForPrompt(sessionId = null) {
+  renderActiveTasksForPrompt(sessionId = null, { language = 'en', limit = PROMPT_TASK_LIMIT } = {}) {
     const tasks = this.listActiveTasks(sessionId);
     if (tasks.length === 0) return '';
-    const lines = ['<active_tasks>'];
-    for (const task of tasks) {
-      const preview = (task.log?.preview || '').trim().split('\n').slice(-3).join(' | ');
-      const command = taskCommand(task);
-      const cancelRequestedAt = typeof task.runtime?.cancelRequestedAt === 'string' ? task.runtime.cancelRequestedAt : '';
-      lines.push(`- ${task.id} | ${task.kind} | ${task.status} | owner=${task.ownerVpId || 'unknown'} | title=${JSON.stringify(task.title)}${command ? ` | command=${JSON.stringify(command)}` : ''}${cancelRequestedAt ? ` | cancelRequestedAt=${JSON.stringify(cancelRequestedAt)}` : ''} | log=${task.log?.path || ''}${preview ? ` | tail=${JSON.stringify(preview)}` : ''}`);
+    const zh = String(language || '').toLowerCase().startsWith('zh');
+    const maxTasks = Number.isFinite(limit) && limit > 0 ? Math.floor(limit) : PROMPT_TASK_LIMIT;
+    const visible = tasks.slice(0, maxTasks);
+    const lines = [zh ? '## 可能相关的任务' : '## Possibly Relevant Tasks'];
+    lines.push(zh
+      ? '以下任务仍在后台运行。需要进度或完整输出时使用任务工具查询；不要把它们当成记忆事实。'
+      : 'These tasks are still running in the background. Use the task tools for progress or full output; do not treat them as memory facts.');
+    for (const task of visible) {
+      const title = promptTaskLabel(task, language);
+      const detail = zh
+        ? `${taskKindLabel(task.kind, language)}，${taskStatusLabel(task.status, language)}`
+        : `${taskKindLabel(task.kind, language)}, ${taskStatusLabel(task.status, language)}`;
+      lines.push(`- ${title} (${detail})`);
+    }
+    if (tasks.length > visible.length) {
+      const remaining = tasks.length - visible.length;
+      lines.push(zh ? `- 另有 ${remaining} 个运行中任务，可用任务列表查看。` : `- ${remaining} more running task${remaining === 1 ? '' : 's'}; use the task list to inspect them.`);
     }
-    lines.push('</active_tasks>');
     return lines.join('\n');
   }
 }

package/yeaft/tools/send-message.js

@@ -114,6 +114,7 @@ SpawnAgent -> (PromptAgent <-> WaitAgent)+ -> CloseAgent -> 最终回复给用
     // driver out of its idle wait and starts a new turn.
     enqueueSubAgentPrompt(agent, message, {
       projectSessionIds: ctx?.parentEngineDeps?.projectSessionIds,
+      projectLabel: ctx?.parentEngineDeps?.projectLabel,
       projectInstruction: ctx?.parentEngineDeps?.projectInstruction,
     });
     agent.messages.push({

package/yeaft/web-bridge.js

@@ -5276,13 +5276,15 @@ async function runVpTurn({ prompt, promptParts = null, sessionId, vpId, threadId
           || legacyProjectContext(ctx.CONFIG?.yeaftDir, sessionId);
         const projectSessionIds = projectContext?.sessionIds || [];
         queryOpts.projectSessionIds = projectSessionIds;
+        queryOpts.projectLabel = projectContext?.projectName
+          ? `${projectContext.projectName} (${projectContext.projectId})`
+          : (projectContext?.projectId || '');
         queryOpts.projectInstruction = projectContext?.projectInstruction || '';
-        const projectSummaries = await sharedProjectContext(ctx.CONFIG?.yeaftDir, sessionId, {
-          sessionIds: projectSessionIds,
-          language: session?.config?.language,
-          tokenBudget: Math.max(512, Math.floor((session?.config?.messageTokenBudget || 32768) / 8)),
-        });
-        const sharedBlock = buildProjectSharedBlock(projectContext, projectSummaries);
+        // Related Session summaries now enter through Engine's single AMS
+        // memory outlet. Keep this announcement limited to Project identity and
+        // sharing boundaries so parent VP prompts do not duplicate the same prose
+        // that sub-agents receive through memory.
+        const sharedBlock = buildProjectSharedBlock(projectContext);
         if (sharedBlock) {
           queryOpts.sessionAnnouncement = queryOpts.sessionAnnouncement
             ? `${queryOpts.sessionAnnouncement}\n\n${sharedBlock}`
@@ -6528,6 +6530,9 @@ export function handleYeaftSubAgentPrompt(msg) {
     || legacyProjectContext(ctx.CONFIG?.yeaftDir, sessionId);
   enqueueSubAgentPrompt(agent, message, {
     projectSessionIds: projectContext?.sessionIds,
+    projectLabel: projectContext?.projectName
+      ? `${projectContext.projectName} (${projectContext.projectId})`
+      : (projectContext?.projectId || ''),
     projectInstruction: projectContext?.projectInstruction,
   });
   if (!Array.isArray(agent.messages)) agent.messages = [];