@yeaft/webchat-agent 0.1.874 → 0.1.876

package/connection/message-router.js

@@ -37,9 +37,16 @@ import { handleRestartAgent, handleUpgradeAgent } from './upgrade.js';
 import { loadMcpServers, updateMcpConfig } from '../mcp.js';
 import { getLlmConfig, updateLlmConfig, getYeaftSettings, updateYeaftSettings, getSearchSettings, updateSearchSettings, fetchTavilyUsage } from '../yeaft/config-api.js';
 import { fetchModelsDev } from '../yeaft/llm/models-dev.js';
-import { handleYeaftGroupChat, handleYeaftModeSwitch, handleYeaftModelSwitch, resetYeaftSession, handleYeaftLoadHistory, handleYeaftLoadMoreHistory, handleYeaftAbortThread, handleYeaftAbortAll, handleYeaftAbortTurn, handleYeaftVpSubscribe, handleYeaftVpCreate, handleYeaftVpUpdate, handleYeaftVpDelete, handleYeaftVpRead, handleYeaftListGroups, handleYeaftCreateGroup, handleYeaftRenameGroup, handleYeaftUpdateGroup, handleYeaftUpdateGroupConfig, handleYeaftArchiveGroup, handleYeaftDeleteGroup, handleYeaftAddMember, handleYeaftRemoveMember, handleYeaftSetDefaultVp, handleYeaftDreamTrigger, handleYeaftFetchToolStats, handleYeaftFetchDebugHistory, broadcastLanguageChange } from '../yeaft/web-bridge.js';
+import { handleYeaftSessionSend, handleYeaftModeSwitch, handleYeaftModelSwitch, resetYeaftSession, handleYeaftLoadHistory, handleYeaftLoadMoreHistory, handleYeaftAbortThread, handleYeaftAbortAll, handleYeaftAbortTurn, handleYeaftVpSubscribe, handleYeaftVpCreate, handleYeaftVpUpdate, handleYeaftVpDelete, handleYeaftVpRead, handleYeaftListSessions, handleYeaftCreateSession, handleYeaftRenameSession, handleYeaftUpdateSession, handleYeaftUpdateSessionConfig, handleYeaftArchiveSession, handleYeaftDeleteSession, handleYeaftSessionAddMember, handleYeaftSessionRemoveMember, handleYeaftSessionSetDefaultVp, handleYeaftDreamTrigger, handleYeaftFetchToolStats, handleYeaftFetchDebugHistory, broadcastLanguageChange } from '../yeaft/web-bridge.js';
 
 export async function handleMessage(msg) {
+  // Wire-compat: old web bundles send `groupId` on Yeaft messages;
+  // the agent runtime has switched to `sessionId`. Coerce here so
+  // handlers don't each have to do it. Keep both fields populated.
+  if (msg && typeof msg === 'object') {
+    if (msg.sessionId == null && typeof msg.groupId === 'string') msg.sessionId = msg.groupId;
+    if (msg.groupId == null && typeof msg.sessionId === 'string') msg.groupId = msg.sessionId;
+  }
   switch (msg.type) {
     case 'registered':
       if (msg.sessionKey) {
@@ -429,7 +436,7 @@ export async function handleMessage(msg) {
     // Yeaft — single conversation backed by the default group.
     case 'yeaft_group_chat':
     case 'unify_group_chat':
-      await handleYeaftGroupChat(msg);
+      await handleYeaftSessionSend(msg);
       break;
 
     case 'yeaft_load_history':
@@ -513,56 +520,56 @@ export async function handleMessage(msg) {
     case 'yeaft_list_groups':
     case 'unify_list_groups':
     case 'yeaft_list_sessions':
-      handleYeaftListGroups(msg);
+      handleYeaftListSessions(msg);
       break;
     case 'yeaft_create_group':
     case 'unify_create_group':
     case 'yeaft_create_session':
-      handleYeaftCreateGroup(msg);
+      handleYeaftCreateSession(msg);
       break;
     case 'yeaft_rename_group':
     case 'unify_rename_group':
     case 'yeaft_rename_session':
-      handleYeaftRenameGroup(msg);
+      handleYeaftRenameSession(msg);
       break;
     case 'yeaft_update_group':
     case 'unify_update_group':
     case 'yeaft_update_session':
-      handleYeaftUpdateGroup(msg);
+      handleYeaftUpdateSession(msg);
       break;
     case 'yeaft_update_group_config':
     case 'unify_update_group_config':
     case 'yeaft_update_session_config':
-      handleYeaftUpdateGroupConfig(msg);
+      handleYeaftUpdateSessionConfig(msg);
       break;
     case 'yeaft_archive_group':
     case 'unify_archive_group':
     case 'yeaft_archive_session':
-      handleYeaftArchiveGroup(msg);
+      handleYeaftArchiveSession(msg);
       break;
     case 'yeaft_delete_group':
     case 'unify_delete_group':
     case 'yeaft_delete_session':
-      handleYeaftDeleteGroup(msg);
+      handleYeaftDeleteSession(msg);
       break;
     case 'yeaft_add_member':
     case 'unify_add_member':
     case 'yeaft_session_add_member':
-      handleYeaftAddMember(msg);
+      handleYeaftSessionAddMember(msg);
       break;
     case 'yeaft_remove_member':
     case 'unify_remove_member':
     case 'yeaft_session_remove_member':
-      handleYeaftRemoveMember(msg);
+      handleYeaftSessionRemoveMember(msg);
       break;
     case 'yeaft_set_default_vp':
     case 'unify_set_default_vp':
     case 'yeaft_session_set_default_vp':
-      handleYeaftSetDefaultVp(msg);
+      handleYeaftSessionSetDefaultVp(msg);
       break;
     // Phase 2: session_send is just group_chat (N≥1 fan-out already works).
     case 'yeaft_session_send':
-      handleYeaftGroupChat(msg);
+      handleYeaftSessionSend(msg);
       break;
 
     // wave-6b: manual dream trigger from VP detail page

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yeaft/webchat-agent",
-  "version": "0.1.874",
+  "version": "0.1.876",
   "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
   "main": "index.js",
   "type": "module",

package/yeaft/attachments.js

@@ -90,7 +90,7 @@ function sanitizeBaseName(base) {
  *        Resolved files from server (pendingFiles → base64).
  * @param {Object} [opts]
  * @param {string} [opts.subdir]   Sub-folder under TEMP_UPLOAD_DIR
- *        (e.g. groupId). Lets multiple groups co-exist without clobbering.
+ *        (e.g. sessionId). Lets multiple groups co-exist without clobbering.
  * @param {string} [opts.cwd]      Override base dir; defaults to process.cwd()
  *        which is what yeaft tools (file-read, bash, ...) resolve relative
  *        paths against.
@@ -104,7 +104,7 @@ function sanitizeBaseName(base) {
 export function persistYeaftAttachments(files, opts = {}) {
   const cwd = opts.cwd || process.cwd();
   // Subdir is OURS — it must remain ASCII-safe because we generate it
-  // from groupId. Keep the existing strict policy here; this is NOT
+  // from sessionId. Keep the existing strict policy here; this is NOT
   // user-visible.
   const subdir = opts.subdir ? String(opts.subdir).replace(/[^a-zA-Z0-9._-]/g, '_') : '';
   const uploadDir = subdir

package/yeaft/cli.js

@@ -32,7 +32,7 @@ import { listModels, resolveModel, parseModelRef } from './models.js';
 import { buildSystemPrompt } from './prompts.js';
 import { searchMessages } from './conversation/search.js';
 import { ConversationStore } from './conversation/persist.js';
-import { snapshotGroups } from './groups/group-crud.js';
+import { snapshotSessions } from './sessions/session-crud.js';
 
 // ─── Argument parsing ──────────────────────────────────────────
 
@@ -50,7 +50,7 @@ function parseArgs(argv) {
     skipSkills: false,
     compactOrphans: false,
     compactOrphansDry: false,
-    deleteGroup: null,
+    deleteSession: null,
     prompt: null,
   };
 
@@ -100,7 +100,7 @@ function parseArgs(argv) {
         args.compactOrphansDry = true;
         break;
       case '--delete-group':
-        args.deleteGroup = rest[++i] || null;
+        args.deleteSession = rest[++i] || null;
         break;
       default:
         if (!arg.startsWith('-') && !args.prompt) {
@@ -216,7 +216,7 @@ function handleDryRun(args, config) {
 
 /**
  * One-shot orphan-message sweep. Reads the live group list off disk and
- * deletes every persisted message whose `groupId` frontmatter is missing
+ * deletes every persisted message whose `sessionId` frontmatter is missing
  * or points to a group that no longer exists.
  *
  * Exposed via `--compact-orphans` (delete) and `--compact-orphans-dry`
@@ -227,7 +227,7 @@ function handleCompactOrphans(config, { dryRun = false } = {}) {
   const yeaftDir = config.dir;
   let groups;
   try {
-    groups = snapshotGroups(yeaftDir);
+    groups = snapshotSessions(yeaftDir);
   } catch (err) {
     console.error(`Cannot read groups directory: ${err.message}`);
     console.error('Refusing to compact orphans without an authoritative live-group list.');
@@ -258,30 +258,30 @@ function handleCompactOrphans(config, { dryRun = false } = {}) {
  * as the web-bridge `yeaft_delete_group` op, but reachable from the CLI
  * for scripted maintenance.
  */
-function handleDeleteGroup(config, groupId) {
+function handleDeleteGroup(config, sessionId) {
   const yeaftDir = config.dir;
   // Lazy import to avoid loading the whole groups module on every CLI call.
   // (Static `import` at top is fine too — kept dynamic to mirror the web-bridge
   // pattern and keep the maintenance path self-contained.)
   // eslint-disable-next-line global-require
-  return import('./groups/group-crud.js').then(({ deleteGroup }) => {
+  return import('./sessions/session-crud.js').then(({ deleteSession }) => {
     let result;
     try {
-      result = deleteGroup(yeaftDir, groupId);
+      result = deleteSession(yeaftDir, sessionId);
     } catch (err) {
-      console.error(`Failed to delete group ${groupId}: ${err.message}`);
+      console.error(`Failed to delete group ${sessionId}: ${err.message}`);
       process.exitCode = 1;
       return;
     }
     let messagesRemoved = 0;
     try {
       const store = new ConversationStore(yeaftDir);
-      messagesRemoved = store.deleteByGroup(groupId);
+      messagesRemoved = store.deleteByGroup(sessionId);
     } catch (err) {
       console.warn(`Group dir removed, but cascade failed: ${err.message}`);
     }
     console.log('=== DELETE GROUP ===');
-    console.log(`  Group:               ${result.groupId}`);
+    console.log(`  Group:               ${result.sessionId}`);
     console.log(`  Legacy archives swept: ${result.legacyCleanedUp}`);
     console.log(`  Messages cascaded:   ${messagesRemoved}`);
   });
@@ -784,8 +784,8 @@ async function main() {
     handleCompactOrphans(config, { dryRun: args.compactOrphansDry });
     return;
   }
-  if (args.deleteGroup) {
-    await handleDeleteGroup(config, args.deleteGroup);
+  if (args.deleteSession) {
+    await handleDeleteGroup(config, args.deleteSession);
     return;
   }
 

package/yeaft/compact/compactor.js

@@ -19,7 +19,7 @@
  * separately via `setOnCompacted`.
  *
  * Engine instances are per-VP-per-group (`vpEngines` keyed by
- * `${groupId}::${vpId}`), so this orchestration cannot live on `Engine`
+ * `${sessionId}::${vpId}`), so this orchestration cannot live on `Engine`
  * itself: a per-group single-flight slot pinned to a per-VP Engine is a
  * category error. Compactor is constructed once per session, beside the
  * `dreamScheduler`.
@@ -67,7 +67,7 @@ export class Compactor {
    *        `compactHistory` so the compactor's summary prompt + the
    *        "session continued" wrapper render in the user's preferred
    *        locale instead of always English.
-   * @param {(groupId: string, result: CompactedResult) => void} [opts.onCompacted]
+   * @param {(sessionId: string, result: CompactedResult) => void} [opts.onCompacted]
    *        Optional sink. Bridge wires this to send the
    *        `yeaft_history_compacted` WS event. Default: no-op. Can be
    *        replaced post-construction via `setOnCompacted`.
@@ -100,11 +100,11 @@ export class Compactor {
   }
 
   /** Get-or-create the per-group state record. */
-  _state(groupId) {
-    let s = this._states.get(groupId);
+  _state(sessionId) {
+    let s = this._states.get(sessionId);
     if (!s) {
       s = { inFlight: null, pending: false };
-      this._states.set(groupId, s);
+      this._states.set(sessionId, s);
     }
     return s;
   }
@@ -114,11 +114,11 @@ export class Compactor {
    * so a brand-new turn never reads a half-mutated history mid-compact.
    * Other groups' compacts never block this gate (per-group keying).
    *
-   * @param {string} groupId
+   * @param {string} sessionId
    */
-  async awaitInFlight(groupId) {
-    if (!groupId) return;
-    const s = this._states.get(groupId);
+  async awaitInFlight(sessionId) {
+    if (!sessionId) return;
+    const s = this._states.get(sessionId);
     if (s && s.inFlight) {
       try { await s.inFlight; } catch { /* _runOnce already logs */ }
     }
@@ -127,7 +127,7 @@ export class Compactor {
   /**
    * Post-turn fire-and-forget. Bridge calls after the per-VP fanout
    * completes for a turn. The `historyHandle` MUST be a per-call value:
-   * its `get` / `set` close over the bridge's groupId-scoped helpers
+   * its `get` / `set` close over the bridge's sessionId-scoped helpers
    * (`getOrCreateGroupHistory` / `setGroupHistory`), not over a frozen
    * snapshot, so a chained follow-up sees fresh state.
    *
@@ -136,12 +136,12 @@ export class Compactor {
    * the in-flight finishes, exactly one follow-up runs (no matter how
    * many turns piled up during the await).
    *
-   * @param {string} groupId
+   * @param {string} sessionId
    * @param {CompactorHistoryHandle} historyHandle
    */
-  scheduleAfterTurn(groupId, historyHandle) {
-    if (!groupId || !historyHandle) return;
-    const s = this._state(groupId);
+  scheduleAfterTurn(sessionId, historyHandle) {
+    if (!sessionId || !historyHandle) return;
+    const s = this._state(sessionId);
     if (s.inFlight) {
       // Anti-starvation: compact is already running. Mark a follow-up
       // so when it finishes, it re-evaluates and runs again if still
@@ -149,14 +149,14 @@ export class Compactor {
       s.pending = true;
       return;
     }
-    s.inFlight = this._runOnce(groupId, historyHandle).finally(() => {
+    s.inFlight = this._runOnce(sessionId, historyHandle).finally(() => {
       s.inFlight = null;
       // If turns piled up while we were running and compaction is still
       // needed, chain a follow-up. Use a microtask so the .finally
       // chain settles cleanly before the next promise is created.
       if (s.pending) {
         s.pending = false;
-        queueMicrotask(() => this.scheduleAfterTurn(groupId, historyHandle));
+        queueMicrotask(() => this.scheduleAfterTurn(sessionId, historyHandle));
       }
     });
   }
@@ -167,10 +167,10 @@ export class Compactor {
    * `historyHandle.set`, then notifies `onCompacted`. All errors are
    * swallowed (logged) so `inFlight` always clears.
    *
-   * @param {string} groupId
+   * @param {string} sessionId
    * @param {CompactorHistoryHandle} historyHandle
    */
-  async _runOnce(groupId, historyHandle) {
+  async _runOnce(sessionId, historyHandle) {
     try {
       // Capture reference AND length. If a different code path swaps the
       // array (`consolidate` event, session reset, manual clear) the
@@ -233,7 +233,7 @@ export class Compactor {
       );
 
       try {
-        this._onCompacted(groupId, {
+        this._onCompacted(sessionId, {
           reason: result.reason,
           beforeTurns: result.beforeTurns,
           afterTurns: result.afterTurns,
@@ -243,7 +243,7 @@ export class Compactor {
         });
       } catch { /* sink failure must not abort the orchestrator */ }
     } catch (err) {
-      console.warn(`[Yeaft] history compact: unexpected failure (groupId=${groupId})`, err?.message || err);
+      console.warn(`[Yeaft] history compact: unexpected failure (sessionId=${sessionId})`, err?.message || err);
     }
   }