@myagentroam/node 0.11.18 → 0.11.19

package/dist/capabilities.js

@@ -60,6 +60,7 @@ export function unavailableCapabilities() {
         promptCompletion: { apiVersion: 1, contextVersion: 3, automaticTriggers: true },
         chatgptLogin: { apiVersion: 1, loopback: true },
         workspaceDirectTransfer: workspaceDirectTransferCapability(),
+        sessionGroups: { apiVersion: 1 },
         terminalDirect: terminalDirectCapability()
     };
 }
@@ -96,6 +97,7 @@ export function detectCapabilities(commands = {}) {
         promptCompletion: { apiVersion: 1, contextVersion: 3, automaticTriggers: true },
         chatgptLogin: { apiVersion: 1, loopback: true },
         workspaceDirectTransfer: workspaceDirectTransferCapability(),
+        sessionGroups: { apiVersion: 1 },
         terminalDirect: terminalDirectCapability()
     };
 }
@@ -136,6 +138,7 @@ export async function detectCapabilitiesAsync(commands = {}) {
         promptCompletion: { apiVersion: 1, contextVersion: 3, automaticTriggers: true },
         chatgptLogin: { apiVersion: 1, loopback: true },
         workspaceDirectTransfer: workspaceDirectTransferCapability(),
+        sessionGroups: { apiVersion: 1 },
         terminalDirect: terminalDirectCapability()
     };
 }

package/dist/connector.js

@@ -46,6 +46,7 @@ import { WorkspaceSessionService } from './service/workspace-session-service.js'
 import { WorkbenchEventService } from './service/workbench-event-service.js';
 import { RunDomainState } from './service/run-domain-state.js';
 import { RecentRunProjectionService } from './service/recent-run-projection-service.js';
+import { sessionGroupChangedSchema } from '@myagentroam/protocol';
 import { SessionDomainState } from './service/session-domain-state.js';
 import { RunEventService } from './service/run-event-service.js';
 import { RunAttachmentService } from './service/run-attachment-service.js';
@@ -79,7 +80,7 @@ import { MailNotificationControl } from './service/mail-notification-control.js'
 import { NotificationMcpBridge, resolveNotificationCapability } from './service/notification-mcp-bridge.js';
 import { SessionCatalogService } from './service/session-catalog-service.js';
 import { SessionCommandService } from './service/session-command-service.js';
-import { SessionPresentationService } from './service/session-presentation-service.js';
+import { SessionPresentationService, sessionGroup } from './service/session-presentation-service.js';
 import { isPlainRecord, isRunnerImageAttachment, parseRunnerImageAttachments } from './util/node-operation-parsers.js';
 import { WebToolService } from './service/web-tool-service.js';
 export { nodeConnectEndpoint, validatedCapabilities } from './util/node-operation-parsers.js';
@@ -172,6 +173,7 @@ export class NodeConnector {
     restartAuthorization;
     restartHandoff;
     inFlightOperations = new Set();
+    pendingSessionGroups = new Map();
     mailNotificationControl = new MailNotificationControl((envelope) => this.sendEnvelope(envelope));
     scheduledSessions;
     nodeRequests;
@@ -907,6 +909,17 @@ export class NodeConnector {
             emitTurn: (turn) => this.emitConversationTurn(turn)
         });
         this.sessionLifecycleService = new SessionLifecycleService({
+            parentCleared: (session) => {
+                this.recentRunProjectionService.clearSessionParent(session.workspaceId, session.id);
+                const change = {
+                    nodeId: session.nodeId,
+                    workspaceId: session.workspaceId,
+                    sessionId: session.id,
+                    sessionGroup: 'MAIN'
+                };
+                this.pendingSessionGroups.set(session.id, change);
+                this.send('session.group.changed', change);
+            },
             database: () => {
                 if (this.database === undefined)
                     throw new Error('NODE_DATABASE_UNAVAILABLE');
@@ -1176,8 +1189,19 @@ export class NodeConnector {
                 await this.connectionLifecycle.register(nodeId, credential);
                 this.mailNotificationControl.setFeatures(payload);
                 this.usageOutbox?.connected(payload);
+                for (const change of this.pendingSessionGroups.values())
+                    this.send('session.group.changed', change);
             },
             usageAck: (payload) => this.usageOutbox?.handle(createEnvelope('usage.ack', payload)),
+            sessionGroupAck: (payload) => {
+                const parsed = sessionGroupChangedSchema.safeParse(payload);
+                if (!parsed.success)
+                    return;
+                const pending = this.pendingSessionGroups.get(parsed.data.sessionId);
+                if (pending?.nodeId === parsed.data.nodeId &&
+                    pending.workspaceId === parsed.data.workspaceId)
+                    this.pendingSessionGroups.delete(parsed.data.sessionId);
+            },
             bindUsage: (payload) => {
                 if (!isPlainRecord(payload) ||
                     typeof payload.runId !== 'string' ||
@@ -1189,6 +1213,8 @@ export class NodeConnector {
             },
             connected: (payload) => {
                 this.usageOutbox?.connected(payload);
+                for (const change of this.pendingSessionGroups.values())
+                    this.send('session.group.changed', change);
                 this.connectionLifecycle.connected();
                 this.mailNotificationControl.setFeatures(payload);
             },
@@ -1326,6 +1352,9 @@ export class NodeConnector {
                 const session = this.runtime.getAgentSession(sessionId);
                 return session?.customTitle ?? session?.runnerTitle ?? sessionId;
             },
+            sessionGroup: (task) => sessionGroup(this.runtime.getAgentSession(task.sessionId) ??
+                this.database?.getNativeSessionMetadata(task.runner, task.sessionId, task.workspaceId) ??
+                {}),
             emitNotification: (payload) => this.emitWorkbenchEvent('conversation', payload)
         });
         this.runnerService = new RunnerService(requireDatabase, () => this.capabilities, this.runners, this.runnerUsageReader);
@@ -1357,7 +1386,11 @@ export class NodeConnector {
             files: this.workspaceFileService,
             uploads: this.workspaceUploadService,
             changes: this.workspaceChangeService,
-            listSessions: (workspaceId) => this.executeNodeOperation('session.list', { workspaceId, limit: 30 }),
+            listSessions: (workspaceId, sessionGroup) => this.executeNodeOperation('session.list', {
+                workspaceId,
+                limit: 30,
+                ...(sessionGroup === undefined ? {} : { sessionGroup })
+            }),
             invalidate: this.invalidateWorkspaceFiles,
             nodeId: () => this.config?.nodeId ?? 'runtime-node',
             nodeGeneration: () => this.nodeGeneration,

package/dist/database.js

@@ -281,6 +281,13 @@ export class NodeDatabase {
             pinOrder: nullableNumber(row, 'pin_order')
         };
     }
+    clearSessionParent(runner, externalSessionId, workspaceId) {
+        const result = this.raw
+            .prepare("UPDATE agent_sessions SET metadata = json_set(metadata, '$.parentSessionId', NULL) WHERE id = ? AND runner = ? AND workspace_id = ?")
+            .run(externalSessionId, runner, workspaceId);
+        if (result.changes !== 1)
+            throw new Error('SESSION_NOT_FOUND');
+    }
     saveNativeSessionMetadata(input) {
         const current = this.getNativeSessionMetadata(input.runner, input.externalSessionId, input.workspaceId);
         const customTitle = input.customTitle === undefined
@@ -308,7 +315,7 @@ export class NodeDatabase {
         const model = input.model === undefined ? (current?.model ?? null) : input.model;
         const effort = input.effort === undefined ? (current?.effort ?? null) : input.effort;
         const access = input.access === undefined ? (current?.access ?? null) : input.access;
-        const parentSessionId = current?.parentSessionId ?? input.parentSessionId ?? null;
+        const parentSessionId = current === undefined ? (input.parentSessionId ?? null) : (current.parentSessionId ?? null);
         const metadata = JSON.stringify({
             version: 1,
             parentSessionId,

package/dist/runtime-state.js

@@ -343,6 +343,9 @@ export class NodeRuntimeState {
             titleSource: title === null ? 'AUTO' : 'CUSTOM'
         });
     }
+    clearSessionParent(sessionId) {
+        return this.replaceSession(this.requireSession(sessionId).id, { parentSessionId: null });
+    }
     /**
      * Give a new or restored managed Session a readable local title while the
      * Runner still has a placeholder. Never replace a user rename or a

package/dist/service/node-control-message-service.js

@@ -51,6 +51,10 @@ export class NodeControlMessageService {
         }
         if (envelope.type === 'ack')
             return;
+        if (envelope.type === 'session.group.ack') {
+            this.options.sessionGroupAck?.(envelope.payload);
+            return;
+        }
         if (envelope.type === 'run.approval.decision') {
             this.decideApproval(envelope);
             return;

package/dist/service/notification-mcp-bridge.js

@@ -7,6 +7,7 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { notificationInputSchema, notificationChannelsRequestSchema, mailNotificationRequestSchema } from '@myagentroam/protocol';
+import { sessionGroup } from './session-presentation-service.js';
 export class NotificationMcpBridge {
     resolve;
     send;
@@ -177,7 +178,7 @@ export function resolveNotificationCapability(runtime, capability) {
         run.initiatedByUserId !== capability.userId ||
         (run.source === 'SCHEDULED' ? 'SCHEDULED' : 'MANUAL') !== capability.source)
         return undefined;
-    return { ...capability, sessionId: session.id };
+    return { ...capability, sessionId: session.id, sessionGroup: sessionGroup(session) };
 }
 function notificationMcpStdioArgs() {
     const javascript = fileURLToPath(new URL('./notification-mcp-stdio.js', import.meta.url));

package/dist/service/prompt-completion-service.js

@@ -38,7 +38,8 @@ export class PromptCompletionService {
         finally {
             const context = JSON.stringify(analysis);
             try {
-                await this.options.record?.({
+                // Keep persistence on the journal's serial queue, outside the response path.
+                const recording = this.options.record?.({
                     schemaVersion: 1,
                     startedAt,
                     finishedAt: this.now(),
@@ -63,6 +64,9 @@ export class PromptCompletionService {
                     status: failed ? 'failed' : result?.status,
                     reason: failed ? failureCode : result?.status === 'skipped' ? result.reason : undefined
                 });
+                void recording?.catch(() => {
+                    console.warn('PROMPT_COMPLETION_JOURNAL_WRITE_FAILED');
+                });
             }
             catch {
                 console.warn('PROMPT_COMPLETION_JOURNAL_WRITE_FAILED');

package/dist/service/recent-run-projection-service.js

@@ -1,3 +1,4 @@
+import { sessionGroup } from './session-presentation-service.js';
 import { composerVisibleText } from '@myagentroam/protocol';
 const TERMINAL_TTL_MS = 12 * 60 * 60_000;
 const CLEANUP_INTERVAL_MS = 5 * 60_000;
@@ -36,6 +37,7 @@ export class RecentRunProjectionService {
             workspaceId: run.workspaceId,
             sessionId: run.sessionId,
             sessionTitle: session.customTitle ?? session.runnerTitle ?? session.id,
+            sessionGroup: sessionGroup(session),
             ...(latestUserMessage === undefined ? {} : { userMessage: latestUserMessage }),
             runner: run.runner,
             status: run.status,
@@ -55,6 +57,11 @@ export class RecentRunProjectionService {
         this.cleanup();
         return [...this.runsBySession.values()].sort(compareRecentRuns);
     }
+    clearSessionParent(workspaceId, sessionId) {
+        for (const [key, run] of this.runsBySession)
+            if (run.workspaceId === workspaceId && run.sessionId === sessionId)
+                this.runsBySession.set(key, { ...run, sessionGroup: 'MAIN' });
+    }
     publishSnapshot() {
         this.emit({ kind: 'SNAPSHOT', runs: [...this.snapshot()] });
     }

package/dist/service/run-event-service.js

@@ -1,3 +1,4 @@
+import { sessionGroup } from './session-presentation-service.js';
 import { permissionStopSchema, runPerformanceSchema } from '@myagentroam/protocol';
 import { nodeLog } from '../operational.js';
 import { isPlainRecord, isTerminalRunStatus } from '../util/node-operation-parsers.js';
@@ -252,6 +253,7 @@ export class RunEventService {
             workspaceId: run.workspaceId,
             sessionId: run.sessionId,
             sessionTitle: session.customTitle ?? session.runnerTitle ?? session.id,
+            sessionGroup: sessionGroup(session),
             runId
         };
         if (!Number.isSafeInteger(base.userId))

package/dist/service/scheduled-session-coordinator.js

@@ -41,6 +41,7 @@ export class ScheduledSessionCoordinator {
                 eventType: 'notification',
                 payload: {
                     targetType: 'WORKSPACE_SESSION',
+                    sessionGroup: this.options.sessionGroup?.(task) ?? 'MAIN',
                     userId: currentTask.ownerUserId,
                     workspaceId: task.workspaceId,
                     sessionId: task.sessionId,
@@ -68,6 +69,7 @@ export class ScheduledSessionCoordinator {
                 eventType: 'notification',
                 payload: {
                     targetType: 'WORKSPACE_SESSION',
+                    sessionGroup: this.options.sessionGroup?.(task) ?? 'MAIN',
                     userId: task.ownerUserId,
                     workspaceId: task.workspaceId,
                     sessionId,

package/dist/service/session-catalog-service.js

@@ -1,3 +1,4 @@
+import { sessionGroup } from './session-presentation-service.js';
 import { removeNativeSession } from '../native-session-history.js';
 import { nodeLog } from '../operational.js';
 import { isTerminalRunStatus, sessionPage } from '../util/node-operation-parsers.js';
@@ -20,15 +21,33 @@ export class SessionCatalogService {
         };
     }
     async list(input) {
+        if (input.sessionGroup !== undefined &&
+            input.sessionGroup !== 'MAIN' &&
+            input.sessionGroup !== 'CHILD')
+            throw new Error('SESSION_INVALID');
         const sessions = await this.collect(input);
-        const page = sessionPage(sessions.filter((session) => input.parentSessionId === undefined || session.parentSessionId === input.parentSessionId), input);
+        const runningCounts = { MAIN: 0, CHILD: 0 };
+        for (const session of sessions)
+            if ('activity' in session && session.activity === 'MANAGED_ACTIVE')
+                runningCounts[sessionGroup(session)] += 1;
+        const query = typeof input.query === 'string'
+            ? input.query.trim().normalize('NFKC').toLocaleLowerCase()
+            : '';
+        const page = sessionPage(sessions.filter((session) => (input.parentSessionId === undefined ||
+            session.parentSessionId === input.parentSessionId) &&
+            (input.sessionGroup === undefined || sessionGroup(session) === input.sessionGroup) &&
+            (query.length === 0 ||
+                (session.customTitle ?? session.runnerTitle ?? '')
+                    .normalize('NFKC')
+                    .toLocaleLowerCase()
+                    .includes(query))), input);
         return input.view === 'marctl'
             ? {
                 view: 'marctl',
                 sessions: page.sessions.map((session) => marctlSessionSummary(this.options.runtime, session)),
                 nextCursor: page.nextCursor
             }
-            : page;
+            : { ...page, runningCounts };
     }
     async graph(input) {
         if (typeof input.workspaceId !== 'string')
@@ -125,14 +144,7 @@ export class SessionCatalogService {
         ].map((session) => [session.id, session]));
         if (workspaceId !== undefined)
             this.mergePersisted(merged, workspaceId, !registeredOnly && query === undefined && this.options.discoveryPending(workspaceId));
-        const sessions = [...merged.values()].filter((session) => {
-            if (query === undefined)
-                return true;
-            const title = (session.customTitle ?? session.runnerTitle ?? '')
-                .normalize('NFKC')
-                .toLocaleLowerCase();
-            return title.includes(query);
-        });
+        const sessions = [...merged.values()];
         return workspaceId === undefined
             ? sessions
             : sessions.filter((session) => session.workspaceId === workspaceId);

package/dist/service/session-lifecycle-service.js

@@ -24,6 +24,13 @@ export class SessionLifecycleService {
         this.starts.clear();
     }
     async updateMetadata(input) {
+        if (input.parentSessionId !== undefined ||
+            (input.clearParent !== undefined &&
+                (input.clearParent !== true ||
+                    input.customTitle !== undefined ||
+                    input.pinned !== undefined ||
+                    input.sessionPrompt !== undefined)))
+            throw new Error('SESSION_INVALID');
         const sessionPrompt = input.sessionPrompt === undefined ? undefined : normalizeSessionPrompt(input.sessionPrompt);
         if (typeof input.sessionId !== 'string' ||
             (input.customTitle !== undefined &&
@@ -39,6 +46,27 @@ export class SessionLifecycleService {
             (await this.options.projection.createMetadataProjection(input.sessionId));
         if (current === undefined)
             throw new Error('SESSION_NOT_FOUND');
+        if (input.clearParent === true) {
+            if (current.externalSessionId === null)
+                throw new Error('SESSION_ACTIVATION_REQUIRED');
+            const metadata = this.options
+                .database()
+                .getNativeSessionMetadata(current.runner, current.externalSessionId, current.workspaceId);
+            const parentSessionId = metadata === undefined ? current.parentSessionId : metadata.parentSessionId;
+            if (parentSessionId == null) {
+                const next = current.parentSessionId == null
+                    ? current
+                    : this.options.runtime.clearSessionParent(current.id);
+                return { session: this.options.present(next) };
+            }
+            this.options
+                .database()
+                .clearSessionParent(current.runner, current.externalSessionId, current.workspaceId);
+            const next = this.options.runtime.clearSessionParent(current.id);
+            this.options.parentCleared?.(next);
+            this.options.emitSession(next);
+            return { session: this.options.present(next) };
+        }
         if (sessionPrompt !== undefined && current.externalSessionId === null)
             throw new Error('SESSION_ACTIVATION_REQUIRED');
         if (input.pinned === false) {

package/dist/service/session-presentation-service.js

@@ -12,7 +12,7 @@ export class SessionPresentationService {
                 session = {
                     ...session,
                     sessionPrompt: metadata.sessionPrompt ?? null,
-                    parentSessionId: metadata.parentSessionId ?? session.parentSessionId ?? null,
+                    parentSessionId: metadata.parentSessionId ?? null,
                     pinnedAt: metadata.pinnedAt,
                     pinOrder: metadata.pinOrder
                 };
@@ -26,6 +26,7 @@ export class SessionPresentationService {
         return {
             ...session,
             parentSessionId: session.parentSessionId ?? null,
+            sessionGroup: sessionGroup(session),
             ...presentation,
             runtime: {
                 ...presentation.runtime,
@@ -60,6 +61,9 @@ export class SessionPresentationService {
         });
     }
 }
+export function sessionGroup(session) {
+    return session.parentSessionId ? 'CHILD' : 'MAIN';
+}
 export function latestSessionActivityAt(current, discovered) {
     const known = [current, discovered].filter((value) => Number.isFinite(value) && value > 0);
     return known.length === 0 ? 0 : Math.max(...known);

package/dist/service/workbench-manifest-service.js

@@ -48,6 +48,7 @@ export class WorkbenchManifestService {
             },
             directTransfer: capabilities.workspaceDirectTransfer,
             terminalDirect: capabilities.terminalDirect,
+            sessionGroups: capabilities.sessionGroups,
             git: {
                 available: true,
                 reasonCode: null,

package/dist/service/workspace-watch-service.js

@@ -17,6 +17,9 @@ export class WorkspaceWatchService {
         if (!plain(input.topics))
             throw new Error('WORKSPACE_WATCH_INVALID');
         const sessions = input.topics.sessions === true;
+        const sessionGroup = input.topics.sessionGroup;
+        if (sessionGroup !== undefined && sessionGroup !== 'MAIN' && sessionGroup !== 'CHILD')
+            throw new Error('WORKSPACE_WATCH_INVALID');
         const changes = input.topics.changes === true;
         const rawFiles = input.topics.files;
         let files;
@@ -38,7 +41,7 @@ export class WorkspaceWatchService {
         }
         if (!sessions && !changes && files === undefined)
             throw new Error('WORKSPACE_WATCH_INVALID');
-        return { sessions, changes, files };
+        return { sessions, changes, files, ...(sessionGroup === undefined ? {} : { sessionGroup }) };
     }
     key(input) {
         return `${this.sessionHash(input)}:${this.connectionId(input)}`;

package/dist/service/workspace-watch-snapshot-service.js

@@ -123,7 +123,7 @@ export class WorkspaceWatchSnapshotService {
         const subscribers = this.subscribers(workspaceId, topic);
         if (subscribers.length === 0)
             return;
-        if (topic !== 'files') {
+        if (topic === 'changes') {
             const first = subscribers[0];
             if (first === undefined)
                 return;
@@ -154,7 +154,9 @@ export class WorkspaceWatchSnapshotService {
         }
         const views = new Map();
         for (const watch of subscribers) {
-            const key = JSON.stringify(watch.topics.files);
+            const key = topic === 'files'
+                ? JSON.stringify(watch.topics.files)
+                : (watch.topics.sessionGroup ?? 'ALL');
             views.set(key, [...(views.get(key) ?? []), watch]);
         }
         await Promise.all([...views.values()].map(async (viewSubscribers) => {
@@ -180,12 +182,12 @@ export class WorkspaceWatchSnapshotService {
     read(workspace, topic, watch) {
         const key = topic === 'files'
             ? `${workspace.id}:files:${JSON.stringify(watch.topics.files)}`
-            : `${workspace.id}:${topic}:${this.readRevision(workspace.id, topic)}`;
+            : `${workspace.id}:${topic}:${watch.topics.sessionGroup ?? 'ALL'}:${this.readRevision(workspace.id, topic)}`;
         const active = this.reads.get(key);
         if (active !== undefined)
             return active;
         const read = (topic === 'sessions'
-            ? this.options.listSessions(workspace.id)
+            ? this.options.listSessions(workspace.id, watch.topics.sessionGroup)
             : topic === 'changes'
                 ? workspace.kind === 'GIT_WORKSPACE'
                     ? this.options.changes.current(workspace)
@@ -214,7 +216,7 @@ export class WorkspaceWatchSnapshotService {
     viewKey(workspaceId, topic, watch) {
         return topic === 'files'
             ? `${workspaceId}:files:${JSON.stringify(watch.topics.files)}`
-            : `${workspaceId}:${topic}`;
+            : `${workspaceId}:${topic}:${watch.topics.sessionGroup ?? 'ALL'}`;
     }
     readActive(workspaceId, topic) {
         const prefix = `${workspaceId}:${topic}`;

package/dist/terminal.js

@@ -631,7 +631,7 @@ function terminalDimension(value, fallback) {
 function terminalSequence(value) {
     if (value === undefined)
         return 0;
-    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0)
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)
         throw new Error('TERMINAL_REPLAY_INVALID');
     return value;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.11.18",
+  "version": "0.11.19",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -37,10 +37,10 @@
     "playwright": "1.62.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.11.18",
+    "@myagentroam/agent": "0.11.19",
     "@myagentroam/marctl": "0.11.0",
     "@myagentroam/code-navigation": "0.11.0",
-    "@myagentroam/protocol": "0.11.18"
+    "@myagentroam/protocol": "0.11.19"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"