@yeaft/webchat-agent 1.0.308 → 1.0.309

package/connection/message-router.js

@@ -30,7 +30,7 @@ import { getLlmConfig, updateLlmConfig, getYeaftSettings, updateYeaftSettings, g
 import { loadConfig } from '../yeaft/config.js';
 import { discoverLlmModels } from '../llm-model-discovery.js';
 import { fetchModelsDev } from '../yeaft/llm/models-dev.js';
-import { handleYeaftSessionSend, handleYeaftAskUserAnswer, handleYeaftSubAgentPrompt, handleYeaftTaskCancel, handleYeaftModeSwitch, handleYeaftModelSwitch, resetYeaftSession, refreshLiveSessionConfig, handleYeaftLoadHistory, handleYeaftLoadHistoryOutline, handleYeaftSearchHistory, handleYeaftLoadHistoryWindow, handleYeaftLoadMoreHistory, handleYeaftAbortThread, handleYeaftAbortAll, handleYeaftAbortTurn, handleYeaftVpSubscribe, handleYeaftVpCreate, handleYeaftVpUpdate, handleYeaftVpDelete, handleYeaftVpRead, handleYeaftListSessions, handleYeaftProjectMutation, handleYeaftCreateSession, handleYeaftRenameSession, handleYeaftUpdateSession, handleYeaftUpdateSessionConfig, handleYeaftArchiveSession, handleYeaftDeleteSession, handleYeaftSessionAddMember, handleYeaftSessionRemoveMember, handleYeaftSessionSetDefaultVp, handleYeaftScanWorkdirSessions, handleYeaftRestoreSession, handleYeaftDreamTrigger, handleYeaftFetchToolStats, handleYeaftFetchDebugHistory, handleYeaftMcpList, handleYeaftMcpAdd, handleYeaftMcpRemove, handleYeaftMcpReload, broadcastLanguageChange, broadcastYeaftSessionSnapshotEager, broadcastYeaftVpSnapshotEager, preloadYeaftSkillSlashCommands } from '../yeaft/web-bridge.js';
+import { handleYeaftSessionSend, handleYeaftAskUserAnswer, handleYeaftSubAgentPrompt, handleYeaftTaskCancel, handleYeaftModeSwitch, handleYeaftModelSwitch, resetYeaftSession, refreshLiveSessionConfig, handleYeaftLoadHistory, handleYeaftLoadHistoryOutline, handleYeaftSearchHistory, handleYeaftLoadHistoryWindow, handleYeaftLoadMoreHistory, handleYeaftAbortThread, handleYeaftAbortAll, handleYeaftAbortTurn, handleYeaftVpSubscribe, handleYeaftVpCreate, handleYeaftVpUpdate, handleYeaftVpDelete, handleYeaftVpRead, handleYeaftListSessions, handleYeaftProjectContextSync, handleYeaftProjectMutation, handleYeaftCreateSession, handleYeaftRenameSession, handleYeaftUpdateSession, handleYeaftUpdateSessionConfig, handleYeaftArchiveSession, handleYeaftDeleteSession, handleYeaftSessionAddMember, handleYeaftSessionRemoveMember, handleYeaftSessionSetDefaultVp, handleYeaftScanWorkdirSessions, handleYeaftRestoreSession, handleYeaftDreamTrigger, handleYeaftFetchToolStats, handleYeaftFetchDebugHistory, handleYeaftMcpList, handleYeaftMcpAdd, handleYeaftMcpRemove, handleYeaftMcpReload, broadcastLanguageChange, broadcastYeaftSessionSnapshotEager, broadcastYeaftVpSnapshotEager, preloadYeaftSkillSlashCommands } from '../yeaft/web-bridge.js';
 import { startYeaftStatusRefresh, forceRefreshYeaftStatus } from '../yeaft/status-cache.js';
 import { handleWorkCenterRequest } from '../yeaft/work-center/bridge.js';
 
@@ -506,6 +506,10 @@ export async function handleMessage(msg) {
       await handleYeaftSessionSend(msg);
       break;
 
+    case 'yeaft_project_context_sync':
+      handleYeaftProjectContextSync(msg);
+      break;
+
     case 'yeaft_project_mutation':
       handleYeaftProjectMutation(msg);
       break;

package/local-runtime/server/db/connection.js

@@ -248,6 +248,7 @@ db.exec(`
     id TEXT NOT NULL,
     user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
     name TEXT NOT NULL,
+    instruction TEXT NOT NULL DEFAULT '',
     sort_order INTEGER NOT NULL,
     created_at INTEGER NOT NULL,
     updated_at INTEGER NOT NULL,
@@ -331,6 +332,13 @@ for (const migration of yeaftMigrations) {
   try { db.exec(migration); } catch (_) { /* column exists */ }
 }
 
+const yeaftProjectMigrations = [
+  `ALTER TABLE yeaft_projects ADD COLUMN instruction TEXT NOT NULL DEFAULT ''`,
+];
+for (const migration of yeaftProjectMigrations) {
+  try { db.exec(migration); } catch (_) { /* column exists */ }
+}
+
 for (const migration of migrations) {
   try {
     db.exec(migration);
@@ -679,8 +687,8 @@ export const stmts = {
   // Project organization metadata. Projects are server-owned and may contain
   // Sessions from multiple Agents; sharing still filters by agent_id.
   insertYeaftProject: db.prepare(`
-    INSERT INTO yeaft_projects (id, user_id, name, sort_order, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?)
+    INSERT INTO yeaft_projects (id, user_id, name, instruction, sort_order, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?)
   `),
   getYeaftProjectsByUser: db.prepare(`
     SELECT * FROM yeaft_projects WHERE user_id = ? ORDER BY sort_order ASC, created_at ASC
@@ -691,6 +699,9 @@ export const stmts = {
   updateYeaftProjectName: db.prepare(`
     UPDATE yeaft_projects SET name = ?, updated_at = ? WHERE user_id = ? AND id = ?
   `),
+  updateYeaftProjectInstruction: db.prepare(`
+    UPDATE yeaft_projects SET instruction = ?, updated_at = ? WHERE user_id = ? AND id = ?
+  `),
   deleteYeaftProject: db.prepare(`
     DELETE FROM yeaft_projects WHERE user_id = ? AND id = ?
   `),

package/local-runtime/server/db/yeaft-project-db.js

@@ -21,6 +21,17 @@ function requireName(value) {
   return name.slice(0, 120);
 }
 
+function normalizeInstruction(value) {
+  if (typeof value !== 'string') {
+    throw new YeaftProjectDbError('invalid_instruction', 'Project instruction must be a string');
+  }
+  const instruction = value.trim();
+  if (instruction.length > 20_000) {
+    throw new YeaftProjectDbError('instruction_too_long', 'Project instruction must not exceed 20000 characters');
+  }
+  return instruction;
+}
+
 function requireId(value, code, label) {
   const id = typeof value === 'string' ? value.trim() : '';
   if (!id) throw new YeaftProjectDbError(code, `${label} is required`);
@@ -32,6 +43,7 @@ function mapProject(row, members = []) {
   return {
     id: row.id,
     name: row.name,
+    instruction: typeof row.instruction === 'string' ? row.instruction : '',
     sortOrder: row.sort_order,
     createdAt: row.created_at,
     updatedAt: row.updated_at,
@@ -79,6 +91,7 @@ export const yeaftProjectDb = {
     const project = {
       id: `project-${randomUUID().slice(0, 8)}`,
       name: requireName(name),
+      instruction: '',
       sortOrder: projects.reduce((max, row) => Math.max(max, Number(row.sortOrder) || 0), -1) + 1,
       createdAt: now,
       updatedAt: now,
@@ -88,6 +101,7 @@ export const yeaftProjectDb = {
       project.id,
       ownerId,
       project.name,
+      project.instruction,
       project.sortOrder,
       now,
       now,
@@ -105,6 +119,16 @@ export const yeaftProjectDb = {
       stmts.getYeaftProjectMembersByUser.all(ownerId).filter(member => member.project_id === id));
   },
 
+  updateInstruction(userId, projectId, instruction) {
+    const ownerId = requireUserId(userId);
+    const id = requireId(projectId, 'invalid_project_id', 'Project id');
+    requireProject(ownerId, id);
+    const nextInstruction = normalizeInstruction(instruction);
+    stmts.updateYeaftProjectInstruction.run(nextInstruction, Date.now(), ownerId, id);
+    return mapProject(stmts.getYeaftProjectForUser.get(ownerId, id),
+      stmts.getYeaftProjectMembersByUser.all(ownerId).filter(member => member.project_id === id));
+  },
+
   delete(userId, projectId) {
     const ownerId = requireUserId(userId);
     const id = requireId(projectId, 'invalid_project_id', 'Project id');
@@ -185,7 +209,7 @@ export const yeaftProjectDb = {
         for (let suffix = 2; usedNames.has(name); suffix += 1) name = `${baseName} ${suffix}`;
         const projectId = `project-${randomUUID().slice(0, 8)}`;
         const now = Date.now();
-        stmts.insertYeaftProject.run(projectId, ownerId, name.slice(0, 120), sortOrder, now, now);
+        stmts.insertYeaftProject.run(projectId, ownerId, name.slice(0, 120), '', sortOrder, now, now);
         sortOrder += 1;
         usedNames.add(name);
         for (const rawSessionId of Array.isArray(row.sessionIds) ? row.sessionIds : []) {
@@ -219,6 +243,7 @@ export const yeaftProjectDb = {
     return {
       projectId: project.id,
       projectName: project.name,
+      projectInstruction: typeof project.instruction === 'string' ? project.instruction : '',
       sessionIds: sameAgentMembers,
     };
   },

package/local-runtime/server/handlers/client-conversation.js

@@ -49,6 +49,33 @@ async function sendVpSnapshotError(client, msg, error) {
   });
 }
 
+export async function syncProjectContextsToAgents(userId) {
+  try {
+    const sessionsByAgent = groupOnlineYeaftSessions(yeaftSessionDb.getByUser(userId));
+    await Promise.all(Object.entries(sessionsByAgent).map(async ([agentId, sessions]) => {
+      try {
+        const contexts = sessions.map(session => ({
+          sessionId: session.id,
+          projectContext: yeaftProjectDb.contextForSession(userId, agentId, session.id) || {
+            projectId: null,
+            projectName: null,
+            projectInstruction: '',
+            sessionIds: [],
+          },
+        }));
+        await forwardToAgent(agentId, {
+          type: 'yeaft_project_context_sync',
+          contexts,
+        });
+      } catch (err) {
+        console.warn(`[Yeaft] Project context sync failed for Agent ${agentId}:`, err?.message || err);
+      }
+    }));
+  } catch (err) {
+    console.warn('[Yeaft] Project context sync failed:', err?.message || err);
+  }
+}
+
 async function broadcastSessionPin(userId, payload) {
   for (const [, target] of webClients) {
     if (!target?.authenticated) continue;
@@ -1299,7 +1326,9 @@ export async function handleClientConversation(clientId, client, msg, checkAgent
         let result = null;
         if (op === 'create') result = yeaftProjectDb.create(client.userId, msg.name);
         else if (op === 'rename') result = yeaftProjectDb.rename(client.userId, msg.projectId, msg.name);
-        else if (op === 'delete') result = yeaftProjectDb.delete(client.userId, msg.projectId);
+        else if (op === 'update_instruction') {
+          result = yeaftProjectDb.updateInstruction(client.userId, msg.projectId, msg.instruction);
+        } else if (op === 'delete') result = yeaftProjectDb.delete(client.userId, msg.projectId);
         else if (op === 'move_session') {
           const agentId = msg.targetAgentId || msg.agentId;
           const sessionId = typeof msg.sessionId === 'string' ? msg.sessionId.trim() : '';
@@ -1324,6 +1353,7 @@ export async function handleClientConversation(clientId, client, msg, checkAgent
           ? yeaftProjectDb.listForAgent(client.userId, responseAgentId)
           : yeaftProjectDb.list(client.userId);
         await respond({ ok: true, result, projects });
+        await syncProjectContextsToAgents(client.userId);
         await broadcastSessionCatalog(client.userId);
       } catch (err) {
         await respond({
@@ -1474,6 +1504,7 @@ export async function handleClientConversation(clientId, client, msg, checkAgent
             rest.projectContext = projectContext || {
               projectId: null,
               projectName: null,
+              projectInstruction: '',
               sessionIds: [],
             };
           }

package/local-runtime/version.json

@@ -1 +1 @@
-{"version":"1.0.308"}
+{"version":"1.0.309"}