@yeaft/webchat-agent 1.0.328 → 1.0.329

package/local-runtime/version.json

@@ -1 +1 @@
-{"version":"1.0.328"}
+{"version":"1.0.329"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.328",
+  "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

@@ -1201,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.
@@ -1235,6 +1236,7 @@ export class Engine {
       activeScope,
       sessionAnnouncement,
       projectInstruction,
+      projectLabel,
       workCenterInstructions,
       projectDoc,
       runtimePlatform: getRuntimePlatformInfo(),
@@ -1420,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
           : '',
@@ -1967,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 {
@@ -2053,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
@@ -2101,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
@@ -2303,6 +2308,7 @@ export class Engine {
       activeScope,
       sessionAnnouncement,
       projectInstruction,
+      projectLabel,
       workCenterInstructions,
       projectDoc,
       activeTasks,
@@ -3706,6 +3712,7 @@ export class Engine {
         sessionId: runtimeSessionId,
         projectSessionIds,
         projectInstruction,
+        projectLabel,
         threadId: runtimeThreadId,
         inboundEnvelope,
         taskId,

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/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,6 +5276,9 @@ 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 || '';
         // Related Session summaries now enter through Engine's single AMS
         // memory outlet. Keep this announcement limited to Project identity and
@@ -6527,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 = [];