@yeaft/webchat-agent 1.0.299 → 1.0.301

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "1.0.299",
+  "version": "1.0.301",
   "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/cli-session-runner.js

@@ -23,7 +23,7 @@ function buildVpPersona(vpId, loaded) {
   };
 }
 
-function createEngine(loaded, sessionId, vpId) {
+export function createCliVpEngine(loaded, sessionId, vpId) {
   const effectiveConfig = resolveSessionConfig(
     loaded.config,
     loadSessionConfig(loaded.yeaftDir, sessionId),
@@ -41,6 +41,7 @@ function createEngine(loaded, sessionId, vpId) {
     yeaftDir: loaded.yeaftDir,
     toolStats: loaded.toolStats || null,
     taskManager: loaded.taskManager || null,
+    managedCliReady: loaded.managedCliReady || null,
     sessionId,
     vpId,
   });
@@ -58,7 +59,7 @@ export function createCliSessionRunner({
   loaded,
   sessionId,
   workDir = process.cwd(),
-  engineFactory = createEngine,
+  engineFactory = createCliVpEngine,
   personaFactory = buildVpPersona,
 } = {}) {
   if (!loaded || !sessionId) return null;

package/yeaft/cli.js

@@ -40,6 +40,7 @@ import { loadSessionConfig, resolveSessionConfig } from './sessions/session-conf
 import { validateSessionId } from './sessions/ids.js';
 import { createJsonlWriter, JsonlInput, runStreamTurn, runStreamSessionTurn } from './stdio-protocol.js';
 import { createCliSessionRunner } from './cli-session-runner.js';
+import { ensureManagedCliTools, summarizeManagedCliResults } from './managed-cli.js';
 
 // ─── Argument parsing ──────────────────────────────────────────
 
@@ -65,6 +66,7 @@ export function parseArgs(argv) {
     outputFormat: 'text',
     print: false,
     prompt: null,
+    managedCliReady: Promise.resolve([]),
   };
 
   const rest = argv.slice(2);
@@ -346,6 +348,7 @@ async function runREPL(config, args) {
     skipMCP: args.skipMCP,
     skipSkills: args.skipSkills,
     configOverrides: effectiveConfig,
+    managedCliReady: args.managedCliReady,
   });
 
   const { engine, conversationStore, trace, skillManager, mcpManager, toolRegistry } = session;
@@ -797,6 +800,7 @@ async function runStreamJson(config, args) {
       ...effectiveConfig,
       ...(effectiveConfig.modelEffort ? { modelEffort: effectiveConfig.modelEffort } : {}),
     },
+    managedCliReady: args.managedCliReady,
   });
   const { engine, conversationStore, skillManager, toolRegistry } = loaded;
   const sessionRunner = createCliSessionRunner({ loaded, sessionId, workDir });
@@ -885,6 +889,7 @@ async function runOnce(config, args) {
     skipMCP: args.skipMCP,
     skipSkills: args.skipSkills,
     configOverrides: effectiveConfig,
+    managedCliReady: args.managedCliReady,
   });
 
   const { engine, conversationStore } = session;
@@ -993,7 +998,6 @@ async function main() {
     language: args.language,
     debug: args.debug || undefined,
   });
-
   // Handle --trace queries (no LLM needed, no session needed)
   if (args.trace) {
     await handleTraceQuery(args, config);
@@ -1010,8 +1014,20 @@ async function main() {
     return;
   }
 
+  const prepareManagedCli = () => {
+    args.managedCliReady = ensureManagedCliTools({ yeaftDir: config.dir });
+    args.managedCliReady.then(results => {
+      if (results.some(result => result.status === 'installed')) {
+        console.error(`[Yeaft] managed CLI tools: ${summarizeManagedCliResults(results)}`);
+      }
+    }).catch(error => {
+      console.error(`[Yeaft] managed CLI setup failed; using built-in fallbacks: ${error?.message || error}`);
+    });
+  };
+
   // Handle interactive mode
   if (args.interactive) {
+    prepareManagedCli();
     await runREPL(config, args);
     return;
   }
@@ -1023,6 +1039,7 @@ async function main() {
     if (!args.prompt && args.inputFormat !== 'stream-json' && process.stdin.isTTY) {
       throw new Error('stream-json output requires a prompt, piped stdin, or --input-format stream-json');
     }
+    prepareManagedCli();
     await runStreamJson(config, args);
     return;
   }
@@ -1032,6 +1049,7 @@ async function main() {
 
   // Handle prompt (from args or stdin)
   if (args.prompt) {
+    prepareManagedCli();
     await runOnce(config, args);
     return;
   }
@@ -1044,6 +1062,7 @@ async function main() {
     }
     args.prompt = input.trim();
     if (args.prompt) {
+      prepareManagedCli();
       await runOnce(config, args);
       return;
     }

package/yeaft/conversation/search.js

@@ -152,7 +152,7 @@ function sessionConversationDirs(dir) {
  * @param {string} dir — Yeaft root directory (e.g. ~/.yeaft)
  * @param {string} keyword — search terms
  * @param {number} [limit=10] — max results
- * @param {{telemetry?: {scannedFiles?: number, scannedBytes?: number, scannedMessages?: number}}} [options]
+ * @param {{telemetry?: {scannedFiles?: number, scannedBytes?: number, scannedMessages?: number}, sessionIds?: string[]}} [options]
  * @returns {object[]} — matching messages, newest first
  */
 export function searchMessages(dir, keyword, limit = 10, options = {}) {
@@ -167,18 +167,24 @@ export function searchMessages(dir, keyword, limit = 10, options = {}) {
     telemetry.scannedMessages = 0;
   }
 
-  const conversationDirs = [
-    { dir: join(dir, 'chat'), sessionId: null, kind: 'chat' },
-    ...sessionConversationDirs(dir),
-  ];
+  const requestedSessionIds = Array.isArray(options.sessionIds)
+    ? new Set(options.sessionIds.filter(id => typeof id === 'string' && id.trim()).map(id => id.trim()))
+    : null;
+  const scopedSessionDirs = sessionConversationDirs(dir)
+    .filter(source => !requestedSessionIds || requestedSessionIds.has(source.sessionId));
+  const conversationDirs = requestedSessionIds
+    ? scopedSessionDirs
+    : [{ dir: join(dir, 'chat'), sessionId: null, kind: 'chat' }, ...scopedSessionDirs];
 
   const markdownDirs = [
     ...conversationDirs.flatMap(source => [
       { ...source, dir: join(source.dir, 'messages') },
       { ...source, dir: join(source.dir, 'cold') },
     ]),
-    { dir: join(dir, 'conversation', 'messages'), sessionId: null, kind: 'legacy-conversation' },
-    { dir: join(dir, 'conversation', 'cold'), sessionId: null, kind: 'legacy-conversation' },
+    ...(!requestedSessionIds ? [
+      { dir: join(dir, 'conversation', 'messages'), sessionId: null, kind: 'legacy-conversation' },
+      { dir: join(dir, 'conversation', 'cold'), sessionId: null, kind: 'legacy-conversation' },
+    ] : []),
   ];
   const segmentDirs = conversationDirs.map(source => ({ ...source, dir: join(source.dir, 'segments') }));
 

package/yeaft/engine.js

@@ -524,6 +524,9 @@ export class Engine {
 
   /** @type {string|null} */
   #yeaftDir;
+
+  /** @type {Promise<Array>|null} */
+  #managedCliReady;
   /** @type {string|null} — set when this engine is bound to a specific group (per-VP fan-out path). */
   #sessionId = null;
   /** @type {string|null} — set when this engine is bound to a specific VP (per-VP fan-out path). */
@@ -716,9 +719,10 @@ export class Engine {
    *   mcpManager?: import('./mcp.js').MCPManager,
    *   yeaftDir?: string,
    *   toolStats?: import('./stats/tool-usage.js').ToolUsageStats,
+   *   managedCliReady?: Promise<Array>,
    * }} params
    */
-  constructor({ adapter, trace, config, conversationStore, memoryIndex, amsRegistry, toolRegistry, skillManager, mcpManager, yeaftDir, toolStats = null, taskManager = null, sessionId = null, vpId = null, chatId = null }) {
+  constructor({ adapter, trace, config, conversationStore, memoryIndex, amsRegistry, toolRegistry, skillManager, mcpManager, yeaftDir, toolStats = null, taskManager = null, sessionId = null, vpId = null, chatId = null, managedCliReady = null }) {
     this.#adapter = adapter;
     this.#trace = trace;
     this.#config = config;
@@ -732,6 +736,7 @@ export class Engine {
     this.#skillManager = skillManager || null;
     this.#mcpManager = mcpManager || null;
     this.#yeaftDir = yeaftDir || null;
+    this.#managedCliReady = managedCliReady || null;
     this.#toolStats = toolStats || null;
     // Per-VP fan-out (2026-06-01): engine instances in the group path are
     // keyed by ${sessionId}::${vpId}::${threadId}, so binding the engine to
@@ -1260,6 +1265,7 @@ export class Engine {
     return {
       signal,
       yeaftDir: this.#yeaftDir,
+      managedCliReady: this.#managedCliReady,
       runtimePlatform: getRuntimePlatformInfo(),
       // Group-scoped working directory. Threaded from #runQuery({ workDir })
       // → set by web-bridge runVpTurn from sessionMeta.workDir. Tools read
@@ -1279,6 +1285,9 @@ export class Engine {
       config: this.#config,
       taskManager: this.#taskManager,
       sessionId: vpCtx?.sessionId || this.#sessionId || null,
+      projectSessionIds: Array.isArray(vpCtx?.projectSessionIds)
+        ? vpCtx.projectSessionIds.slice()
+        : [],
       threadId: vpCtx?.threadId || this.#currentThreadId || MAIN_THREAD_ID,
       currentVpId: vpCtx?.senderVpId || this.#vpId || null,
       // task-704b: per-tool-result hard cap derives from this. Threaded
@@ -1338,10 +1347,14 @@ export class Engine {
         skillManager: this.#skillManager,
         mcpManager: this.#mcpManager,
         yeaftDir: this.#yeaftDir,
+        managedCliReady: this.#managedCliReady,
         parentName: vpCtx?.senderVpId || 'parent',
         parentVpId: vpCtx?.senderVpId || null,
         parentVpPersona: vpCtx?.vpPersona || null,
         parentSessionId: vpCtx?.sessionId || null,
+        projectSessionIds: Array.isArray(vpCtx?.projectSessionIds)
+          ? vpCtx.projectSessionIds.slice()
+          : [],
         parentThreadId: vpCtx?.threadId || this.#currentThreadId || MAIN_THREAD_ID,
         onEvent: this.#subAgentEventSink || null,
         language: this.#config?.language || 'en',
@@ -1838,7 +1851,7 @@ export class Engine {
    *   string-prompt shape (no regression for existing callers).
    * @yields {EngineEvent}
    */
-  async *query({ prompt, promptParts = null, messages = [], signal, userEffort = null, scenario = 'chat', vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, 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 *query({ prompt, promptParts = null, messages = [], signal, userEffort = null, scenario = 'chat', vpPersona, router, senderVpId, inboundEnvelope, taskId, taskMembers, sessionId, sessionMembers, projectSessionIds = null, 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()) {
       yield {
         type: 'error',
@@ -1915,7 +1928,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, 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, 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
@@ -1963,7 +1976,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, 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, 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
@@ -2022,12 +2035,22 @@ export class Engine {
     let recallEntryCount = 0;
 
     const topicScopesForMemory = await this.#loadSessionTopicScopes(sessionId);
+    const projectScopesForMemory = Array.isArray(projectSessionIds)
+      ? projectSessionIds.flatMap(id => [
+          `sessions/${id}`,
+          `sessions/${id}/user`,
+          `session/${id}`,
+          `session/${id}/user`,
+          `group/${id}`,
+          `group/${id}/user`,
+        ])
+      : [];
     const recallResult = await this.#recallMemory(prompt, {
       sessionId,
       vpId: vpPersona && typeof vpPersona === 'object' && typeof vpPersona.vpId === 'string'
         ? vpPersona.vpId
         : (typeof senderVpId === 'string' ? senderVpId : undefined),
-      extraScopes: topicScopesForMemory,
+      extraScopes: [...topicScopesForMemory, ...projectScopesForMemory],
     });
     recallEntryCount = recallResult && Array.isArray(recallResult.entries)
       ? recallResult.entries.length
@@ -3521,6 +3544,7 @@ export class Engine {
         router,
         senderVpId,
         sessionId: runtimeSessionId,
+        projectSessionIds,
         threadId: runtimeThreadId,
         inboundEnvelope,
         taskId,