@myagentroam/node 0.10.57 → 0.10.59

package/dist/connector.js

@@ -56,6 +56,7 @@ import { SessionContextService } from './service/session-context-service.js';
 import { WorkspaceDomainState } from './service/workspace-domain-state.js';
 import { RunWorkbenchService } from './service/run-workbench-service.js';
 import { SessionQueryService } from './service/session-query-service.js';
+import { marctlSessionProgress } from './service/session-recent-activity.js';
 import { WorkspaceQueueWorkbenchService } from './service/workspace-queue-workbench-service.js';
 import { ContinuousRunCoordinator } from './service/continuous-run-coordinator.js';
 import { SessionIdentityService } from './service/session-identity-service.js';
@@ -500,6 +501,7 @@ export class NodeConnector {
                 sequence: this.workbenchEventService.snapshotSequence(),
                 session: this.sessionPresentationService.present(session),
                 runs: this.runtime.listRunsForSession(session.id, { includeTerminal: true }),
+                progress: marctlSessionProgress(this.runtime, session.id),
                 performance: this.runtime.sessionPerformance(session.id),
                 queue: this.workspaceQueueWorkbenchService.snapshot(session.id),
                 context,
@@ -787,6 +789,7 @@ export class NodeConnector {
             markInterrupted: (runId) => this.runState.interruptRequested.add(runId)
         });
         this.sessionQueryService = new SessionQueryService({
+            queuedCount: (sessionId) => this.workspaceQueueWorkbenchService.queuedCount(sessionId),
             workspace: (workspaceId) => this.database?.getWorkspace(workspaceId),
             goal: (sessionId) => this.goalRuntime.get(sessionId),
             runtime: this.runtime,

package/dist/runner/mar-agent/conversation-normalizer.js

@@ -6,6 +6,7 @@ export function normalizeMarAgentUsage(usage) {
 }
 import { boundedConversationItemId, compactRunnerText, compactRunnerValue } from '../../util/node-operation-parsers.js';
 import { runnerErrorProjection } from '../../util/runner-error.js';
+import { toolPresentationSchema } from '@myagentroam/protocol';
 export class MarAgentConversationNormalizer {
     input(entry) {
         return {
@@ -89,8 +90,11 @@ export class MarAgentConversationNormalizer {
         if (event.type === 'tool.started' ||
             event.type === 'tool.completed' ||
             event.type === 'tool.failed') {
-            // Generated artifacts must remain deliverable even when the cell does not observe them.
-            if (event.parentCallId !== undefined && !isImageGenerationTool(event.toolName))
+            // Native web calls and generated artifacts stay visible independently of cell observations.
+            if (event.parentCallId !== undefined &&
+                event.toolName !== 'web_search' &&
+                event.toolName !== 'web_fetch' &&
+                !isImageGenerationTool(event.toolName))
                 return [];
             if (event.type === 'tool.started')
                 return this.#toolStarted(event);
@@ -101,6 +105,15 @@ export class MarAgentConversationNormalizer {
                 ...this.#codeModeToolResults(event)
             ];
         }
+        if (event.type === 'sleep.started') {
+            const state = this.#tools.get(event.callId);
+            if (state?.toolName !== 'sleep')
+                return [];
+            this.#tools.set(event.callId, { ...state, sleepStartedAt: event.startedAt });
+            return [
+                genericToolItem(state.itemId, 'sleep', 'IN_PROGRESS', state.input, null, null, false, undefined, undefined, undefined, event.startedAt)
+            ];
+        }
         if (event.type === 'todo.updated')
             return [
                 {
@@ -205,13 +218,14 @@ export class MarAgentConversationNormalizer {
             input: event.input,
             itemId: ownItemId,
             structured: 'input' in event,
+            ...(event.data === undefined ? {} : { presentationData: event.data }),
             ...(subagentTitle === undefined ? {} : { subagentTitle }),
             ...(subagentDetails === undefined ? {} : { subagentDetails })
         });
         if (event.toolName === 'apply_patch' && 'input' in event)
             return [fileChangeItem(ownItemId, 'IN_PROGRESS', [])];
         return [
-            genericToolItem(ownItemId, event.toolName, 'IN_PROGRESS', event.input, null, null, event.truncated === true, undefined, subagentTitle, subagentDetails)
+            genericToolItem(ownItemId, event.toolName, 'IN_PROGRESS', event.input, null, null, event.truncated === true, event.data, subagentTitle, subagentDetails)
         ];
     }
     #compactAnchorItemId(event, publicItemIdPrefix) {
@@ -278,7 +292,7 @@ export class MarAgentConversationNormalizer {
         }
         const item = genericToolItem(state?.itemId ?? itemId('tool', event.callId), event.toolName, 'COMPLETED', state?.input, generatedImages.length === 0
             ? event.summary
-            : generatedImages.map((image) => image.name).join(', '), null, event.truncated, event.data, agentId === undefined ? state?.subagentTitle : this.#subagentTitles.get(agentId), details);
+            : generatedImages.map((image) => image.name).join(', '), null, event.truncated, event.data, agentId === undefined ? state?.subagentTitle : this.#subagentTitles.get(agentId), details, state?.sleepStartedAt);
         return [
             {
                 ...item,
@@ -306,7 +320,9 @@ export class MarAgentConversationNormalizer {
                 fileChangeItem(state?.itemId ?? itemId('tool', event.callId), 'FAILED', patchChanges(event.data, event.resultExtensions))
             ];
         return [
-            genericToolItem(state?.itemId ?? itemId('tool', event.callId), event.toolName, 'FAILED', state?.input, event.message ?? event.code, event.code, event.truncated === true, undefined, state?.subagentTitle, state?.subagentDetails)
+            genericToolItem(state?.itemId ?? itemId('tool', event.callId), event.toolName, event.code === 'MAR_AGENT_CANCELLED' || event.code === 'MAR_AGENT_EXECUTION_CANCELLED'
+                ? 'CANCELLED'
+                : 'FAILED', state?.input, event.message ?? event.code, event.code, event.truncated === true, state?.presentationData, state?.subagentTitle, state?.subagentDetails, state?.sleepStartedAt)
         ];
     }
     #codeModeToolResults(event) {
@@ -580,7 +596,7 @@ function normalizeContextCompaction(event, anchorItemId) {
 function validCompactAnchor(value) {
     return value !== undefined && value.length > 0 && value.length <= 128 ? value : undefined;
 }
-function genericToolItem(id, toolName, status, input, outputSummary = null, errorCode = null, truncated = false, output, subagentTitle, knownSubagentDetails) {
+function genericToolItem(id, toolName, status, input, outputSummary = null, errorCode = null, truncated = false, output, subagentTitle, knownSubagentDetails, sleepStartedAt) {
     if (toolName === 'code_exec') {
         const code = typeof input === 'string' ? input : record(input)?.code;
         const source = typeof code === 'string' ? code : compactRunnerValue(input, 10_000).text || toolName;
@@ -594,7 +610,7 @@ function genericToolItem(id, toolName, status, input, outputSummary = null, erro
             outputPreview: compactRunnerText(output, 10_000),
             exitCode: null,
             truncated: truncated || source.length > 10_000 || output.length > 10_000
-        }, status);
+        }, status, 'Code execution');
     }
     if (toolName === 'code_exec_wait') {
         const inputRecord = record(input);
@@ -622,10 +638,11 @@ function genericToolItem(id, toolName, status, input, outputSummary = null, erro
                 inputSummary.truncated ||
                 result?.truncated === true ||
                 resultSummary.length > 10_000
-        }, status);
+        }, status, 'Code execution wait');
     }
     const subagent = marAgentSubagentProjection(toolName, input, output, subagentTitle, knownSubagentDetails);
     const toolCategory = isImageGenerationTool(toolName) ? 'IMAGE_GENERATION' : undefined;
+    const presentation = projectToolPresentation(toolName, input, output, sleepStartedAt);
     const inputSummary = compactRunnerValue(input, 10_000);
     return {
         itemId: id,
@@ -641,17 +658,52 @@ function genericToolItem(id, toolName, status, input, outputSummary = null, erro
             errorCode: errorCode === null ? null : compactRunnerText(errorCode, 80),
             truncated: truncated || inputSummary.truncated || (outputSummary?.length ?? 0) > 10_000,
             ...(toolCategory === undefined ? {} : { toolCategory }),
+            ...(presentation === undefined ? {} : { toolPresentation: presentation }),
             ...subagent
         },
         merge: true
     };
 }
-function commandItem(command, status) {
+function projectToolPresentation(toolName, input, output, startedAt) {
+    const category = toolName === 'web_search'
+        ? 'WEB_SEARCH'
+        : toolName === 'web_fetch'
+            ? 'WEB_FETCH'
+            : toolName === 'skill'
+                ? 'SKILL'
+                : toolName === 'sleep'
+                    ? 'SLEEP'
+                    : undefined;
+    if (category === undefined)
+        return undefined;
+    const args = record(input) ?? {};
+    const data = record(output) ?? {};
+    // A provider-hosted search tool can report a page-read action under its native name.
+    const kind = category === 'WEB_SEARCH' && data.hostedToolKind === 'WEB_FETCH' ? 'WEB_FETCH' : category;
+    const text = (value, limit) => typeof value === 'string' ? compactRunnerText(value, limit) : undefined;
+    const candidate = kind === 'WEB_SEARCH'
+        ? { ...data, kind, query: text(data.query ?? args.query, 500) }
+        : kind === 'WEB_FETCH'
+            ? {
+                ...data,
+                kind,
+                requestUrl: text(args.url, 8192),
+                url: text(data.url, 8192),
+                mode: data.mode ?? args.mode
+            }
+            : kind === 'SKILL'
+                ? { ...data, kind, name: text(data.name ?? args.name, 128) }
+                : { ...data, kind, durationMs: data.durationMs ?? args.durationMs, startedAt };
+    const parsed = toolPresentationSchema.safeParse(candidate);
+    return parsed.success ? parsed.data : { kind };
+}
+function commandItem(command, status, title) {
     return {
         itemId: command.itemId,
         kind: 'command_execution',
         status,
         payload: {
+            ...(title === undefined ? {} : { title }),
             command: command.command,
             cwd: command.cwd,
             outputPreview: command.outputPreview,

package/dist/runner/mar-agent/marctl-skill.js

@@ -25,14 +25,14 @@ const marctlInstructions = [
     'Prefer -m / --message for short text; use --message-file for longer UTF-8 text or an existing file (- reads stdin). These options are mutually exclusive. Example: marctl sessions start --runner codex --title "fixer#42 Handle empty totals" -m "Implement issue #42 and report test evidence" --json. Other Runner names are mar-agent, claude-code and opencode. An omitted model uses the target Runner configuration, not the Coordinator model.',
     'For start/send, repeat --image <local-path> to attach PNG, JPEG, GIF or WebP images, with or without text. Images are read on this CLI host, not by remote path. Limits: 5 images, 5 MiB each, 10 MiB total. Actual Runner/model image capabilities apply; goal set accepts text only.',
     'Create workers only as tasks need them, named fixer#<task-id> <description> or reviewer#<task-or-change-id> <description>. These are conventions, not product roles or a fixed pool. Put role, scope, acceptance criteria and delivery requirements in the first message. Follow the repository workflow for development and review. Session Prompt is edited in the Web UI only; marctl has no editing command, and sends to existing Sessions use normal prompt injection.',
-    'Reuse recorded Session/Run IDs and receipts. Refresh volatile Run, queue and Goal state with sessions show only when the next action depends on it. Select needed JSON fields instead of dumping full Session lists or tool transcripts. Hidden reasoning, credentials and raw model requests are not collaboration artifacts.',
-    'show --json fields: session.activity, session.model, session.effort, session.customTitle or session.runnerTitle, runs[] (id/status), queue.items[], and goal.status (goal may be null). Run status and Goal status are separate.',
+    'Reuse recorded Session/Run IDs and receipts. Refresh execution state with show only when the next action depends on it; use goal get or schedule get for those details. Select needed JSON fields instead of dumping full Session lists or tool transcripts. Hidden reasoning, credentials and raw model requests are not collaboration artifacts.',
+    'list returns id/title/runner/status/runId and one latestActivity per Session. show --json fields: session.id, session.title, session.runner, session.status, session.runId, session.model, session.effort, session.queuedCount, session.latestMessage, session.recentTools (at most three). Status is RUNNING/IDLE/SLEEPING; tools keep their original states. Activity is bounded public evidence, not proof of task completion; use history for full results.',
     'Rename any authorized Workspace Session with sessions rename <session-id> --title <name> --json; parent relationships do not restrict renaming.',
     'show/config/history/graph/rename and schedule get/create/update may omit the Session ID to use the current Session. Without a current Session, specify an ID. send/goal/stop/wait always require explicit target IDs.',
     'Use sessions schedule list/get/create/update for the same tasks as the built-in schedule MCP, which is hidden while this skill is available. list is Workspace-scoped. create requires --cron and text (-m/--message-file, up to 20,000 characters). update requires --expected-revision from get and at least cron or text. get returns task (null if absent), with id, revision, objective, cron, timezone and enabled; applied updates also return task. Reuse that task instead of probing its shape or refetching unchanged state. Schedule text is trimmed at both ends; compare after the same trimming; a conclusive update response needs no extra get. Other-owner edits return a PENDING proposal, not an applied change. Scheduled execution uses normal user permissions. Follow existing approval rules and do not retry conflicts or uncertain writes blindly.',
     'Read results with sessions history <session-id> --limit 10 --json (default: latest 10 SEGMENTs, not messages; --limit 1..100). In segments[].items[], select kind === "assistant_message" and read payload.text; keep segment runId and user_message.payload.clientMessageId for queued-input correlation. Reuse the returned page; follow --cursor <nextCursor> only for missing evidence.',
-    'Use sessions send <session-id> --steer -m "Additional context: focus on the resume path." --json for decision-changing updates rather than routine reports: it may switch the current execution. Node decides delivery from actual state; an idle Session receives ordinary input. Choose exactly one of --steer or --queue, even when idle; missing, conflicting, repeated, or obsolete options are rejected locally before input is read or a request is sent. Use --queue to place input in a subsequent turn; with an active Goal, ordinary queued input waits until the Goal exits. start/send return clientMessageId and the accepted/queued result. A queued result may refer to the currently active Run: associate queueItemId/clientMessageId with history before deciding that input finished. There are no queue-item edit/delete/reorder commands; show includes queue state.',
-    'Wait with sessions wait <session-id> --run <run-id> --timeout 5m --json through the existing Watch. Prefer --timeout 5m when blocked on task completion; use 30s for a short deadline. Continue useful independent work before waiting. If exec returns a running process or cell, reuse its process/cell handle rather than starting another wait or polling show/list. Timeout or cancelled waiting does not stop the task. Use sessions stop <session-id> --run <run-id> --json only to stop that active Run; ownership rules still apply.',
+    'Use sessions send <session-id> --steer -m "Additional context: focus on the resume path." --json for decision-changing updates rather than routine reports: it may switch the current execution. Node decides delivery from actual state; an idle Session receives ordinary input. Choose exactly one of --steer or --queue, even when idle; missing, conflicting, repeated, or obsolete options are rejected locally before input is read or a request is sent. Use --queue to place input in a subsequent turn; with an active Goal, ordinary queued input waits until the Goal exits. start/send return clientMessageId and the accepted/queued result. A queued result may refer to the currently active Run: associate queueItemId/clientMessageId with history before deciding that input finished. There are no queue-item edit/delete/reorder commands; show returns only queuedCount.',
+    'Wait with sessions wait <session-id> --run <run-id> --timeout 5m --json through the existing Watch. Prefer --timeout 5m when blocked on task completion; use 30s for a short deadline. Continue useful independent work before waiting. If exec returns a running process or cell, reuse its process/cell handle rather than starting another wait or polling show/list. A timeout may include progress, the last observed snapshot, not a fresh query. Timeout or cancelled waiting does not stop the task. Use sessions stop <session-id> --run <run-id> --json only to stop that active Run; ownership rules still apply.',
     'Goal get/set/clear use the existing Session Goal semantics; see marctl help sessions. A Coordinator can work from ordinary messages or its existing schedule without a Goal. Worker completion never automatically wakes it. Actively wait/read results, or finish and reconcile on the next user message or scheduled input.',
     '## Verify, recover and respect authorization',
     'An accepted message or SUCCEEDED Run is not proof of business completion. Inspect artifacts and test evidence.',

package/dist/runtime-state.js

@@ -702,7 +702,12 @@ export class NodeRuntimeState {
             completedAt: terminal(next) ? this.now() : turn.completedAt,
             items: terminal(next)
                 ? turn.items.map((item) => activeConversationItem(item.status)
-                    ? { ...item, status: completedStatusForRun(next), completedAt: this.now() }
+                    ? {
+                        ...item,
+                        status: completedStatusForRun(next),
+                        completedAt: this.now(),
+                        updatedAt: now
+                    }
                     : item)
                 : turn.items
         }));
@@ -844,6 +849,9 @@ export class NodeRuntimeState {
         const turns = this.listConversationTurns(input).turns;
         return { items: turns.flatMap((turn) => turn.items), nextCursor: null };
     }
+    conversationTail(sessionId) {
+        return this.turns.get(this.resolvePromotedSessionId(sessionId)) ?? [];
+    }
     recordCommandExecution(input) {
         const session = this.requireSession(input.sessionId);
         const now = this.now();
@@ -1310,7 +1318,12 @@ export class NodeRuntimeState {
                     status,
                     completedAt,
                     items: turn.items.map((item) => activeConversationItem(item.status)
-                        ? { ...item, status: completedStatusForRun(status), completedAt }
+                        ? {
+                            ...item,
+                            status: completedStatusForRun(status),
+                            completedAt,
+                            updatedAt: completedAt
+                        }
                         : item)
                 }
                 : turn));
@@ -1347,6 +1360,7 @@ export class NodeRuntimeState {
                     sourceSequence: existing?.sourceSequence ?? event.sequence,
                     revision: event.sequence,
                     kind: 'assistant_message',
+                    updatedAt: event.createdAt,
                     status: 'IN_PROGRESS',
                     payload: { text, format: 'markdown', model: null },
                     startedAt: existing?.startedAt ?? event.createdAt,
@@ -1369,7 +1383,12 @@ export class NodeRuntimeState {
                     trailingItem?.kind === 'assistant_message' &&
                     activeConversationItem(trailingItem.status)
                     ? turn.items.map((item) => item.id === trailingItem.id
-                        ? { ...item, status: 'COMPLETED', completedAt: event.createdAt }
+                        ? {
+                            ...item,
+                            status: 'COMPLETED',
+                            completedAt: event.createdAt,
+                            updatedAt: event.createdAt
+                        }
                         : item)
                     : turn.items;
                 const existing = orderedItems.find((item) => item.id === itemId) ??
@@ -1390,6 +1409,7 @@ export class NodeRuntimeState {
                     sourceSequence: existing?.sourceSequence ?? event.sequence,
                     revision: (existing?.revision ?? -1) + 1,
                     kind: projected.kind,
+                    updatedAt: event.createdAt,
                     status,
                     payload: mergeConversationItemPayload(existing?.payload, projected),
                     ...(projected.permissionStop === undefined

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

@@ -1,5 +1,6 @@
 import { conversationSegmentIdentityForItem, conversationSegments } from './conversation-segment-service.js';
 import { runConversationItemId } from '../runtime-state.js';
+import { marctlSessionProgress } from './session-recent-activity.js';
 import { isNodeAgentRun, isNodeConversationTurn, isPlainRecord } from '../runner/codex/conversation-parser.js';
 export function workbenchPayloadSessionId(runtime, category, payload) {
     if (!isPlainRecord(payload))
@@ -82,6 +83,10 @@ export class NodeRunEventBridge {
                 payload = {
                     sessionId: turn.sessionId,
                     runId: turn.runId,
+                    ...(['assistant_message', 'tool_call', 'command_execution', 'file_change'].includes(item.kind) &&
+                        (rawPayload?.append === undefined || item.status !== 'IN_PROGRESS')
+                        ? { progress: marctlSessionProgress(this.options.runtime, turn.sessionId) }
+                        : {}),
                     item: {
                         turnId: turn.id,
                         itemId: item.id,
@@ -105,6 +110,11 @@ export class NodeRunEventBridge {
             isPlainRecord(payload) &&
             isNodeConversationTurn(payload.turn))
             return { ...payload, segments: conversationSegments(payload.turn) };
+        if (category === 'run' && isPlainRecord(payload) && isNodeAgentRun(payload.run))
+            return {
+                ...payload,
+                progress: marctlSessionProgress(this.options.runtime, payload.run.sessionId)
+            };
         return payload;
     }
     emitConversationItem(runId, item) {

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

@@ -2,6 +2,7 @@ import { removeNativeSession } from '../native-session-history.js';
 import { nodeLog } from '../operational.js';
 import { isTerminalRunStatus, sessionPage } from '../util/node-operation-parsers.js';
 import { latestSessionActivityAt } from './session-presentation-service.js';
+import { marctlSessionSummary } from './session-recent-activity.js';
 export class SessionCatalogService {
     options;
     rewindQueue = Promise.resolve();
@@ -20,7 +21,14 @@ export class SessionCatalogService {
     }
     async list(input) {
         const sessions = await this.collect(input);
-        return sessionPage(sessions.filter((session) => input.parentSessionId === undefined || session.parentSessionId === input.parentSessionId), input);
+        const page = sessionPage(sessions.filter((session) => input.parentSessionId === undefined || session.parentSessionId === input.parentSessionId), input);
+        return input.view === 'marctl'
+            ? {
+                view: 'marctl',
+                sessions: page.sessions.map((session) => marctlSessionSummary(this.options.runtime, session)),
+                nextCursor: page.nextCursor
+            }
+            : page;
     }
     async graph(input) {
         if (typeof input.workspaceId !== 'string')

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

@@ -1,3 +1,4 @@
+import { marctlSessionDetail } from './session-recent-activity.js';
 import { isPlainRecord } from '../runner/codex/conversation-parser.js';
 import { toolResultResourceInputSchema, toolResultResourcePageSchema } from '@myagentroam/protocol';
 export class SessionQueryService {
@@ -23,9 +24,14 @@ export class SessionQueryService {
         };
     }
     async get(input) {
-        return {
-            session: this.options.present(await this.requireSession(input.sessionId, input.workspaceId, input.registeredOnly === true))
-        };
+        const session = await this.requireSession(input.sessionId, input.workspaceId, input.registeredOnly === true);
+        return input.view === 'marctl'
+            ? {
+                view: 'marctl',
+                workspaceId: session.workspaceId,
+                session: marctlSessionDetail(this.options.runtime, session, this.options.queuedCount(session.id))
+            }
+            : { session: this.options.present(session) };
     }
     async cliContext(input) {
         if (typeof input.workspaceId !== 'string')

package/dist/service/session-recent-activity.js

@@ -0,0 +1,177 @@
+import { isPlainRecord, isTerminalRunStatus } from '../util/node-operation-parsers.js';
+/** Projects only already-observed, process-local public facts. Never reads native history. */
+function activity(runtime, sessionId) {
+    const candidate = runtime.activeSessionRun(sessionId);
+    const run = candidate && !isTerminalRunStatus(candidate.status) ? candidate : undefined;
+    const turns = runtime.conversationTail(sessionId);
+    let sleeping = false;
+    let latestActivity = null;
+    let latestMessage = null;
+    const recentTools = [];
+    for (let t = turns.length - 1; t >= 0; t -= 1) {
+        const turn = turns[t];
+        if (run && turn.runId !== run.id)
+            continue;
+        for (let i = turn.items.length - 1; i >= 0; i -= 1) {
+            const item = turn.items[i];
+            if (item.parentItemId !== null)
+                continue;
+            const payload = isPlainRecord(item.payload) ? item.payload : {};
+            const at = time(item);
+            const isLatest = isNewerActivity(latestActivity, at, item.kind === 'assistant_message' ? 'message' : 'tool');
+            if (item.kind === 'assistant_message' &&
+                (latestMessage === null || isLatest) &&
+                typeof payload.text === 'string' &&
+                payload.text.trim()) {
+                if (latestMessage === null) {
+                    const text = clip(payload.text, 300);
+                    latestMessage = {
+                        text: text.text,
+                        state: item.status,
+                        at,
+                        runId: item.runId,
+                        truncated: text.truncated
+                    };
+                }
+                if (isLatest) {
+                    const summary = clip(payload.text, 100);
+                    latestActivity = {
+                        state: item.status,
+                        at,
+                        runId: item.runId,
+                        kind: 'message',
+                        name: 'assistant',
+                        summary: summary.text,
+                        truncated: summary.truncated
+                    };
+                }
+            }
+            if (!['tool_call', 'command_execution', 'file_change'].includes(item.kind))
+                continue;
+            const presentation = isPlainRecord(payload.toolPresentation) ? payload.toolPresentation : {};
+            if (run?.status === 'RUNNING' &&
+                item.status === 'IN_PROGRESS' &&
+                presentation.kind === 'SLEEP' &&
+                typeof presentation.startedAt === 'string')
+                sleeping = true;
+            if (recentTools.length === 3 && !isLatest)
+                continue;
+            const tool = projectTool(item, payload, presentation);
+            if (recentTools.length < 3)
+                recentTools.push(tool);
+            if (isLatest)
+                latestActivity = { ...tool, kind: 'tool' };
+        }
+    }
+    return {
+        status: run === undefined
+            ? 'IDLE'
+            : sleeping
+                ? 'SLEEPING'
+                : 'RUNNING',
+        runId: run?.id ?? null,
+        latestActivity,
+        latestMessage,
+        recentTools,
+        observedAt: Math.max(latestActivity?.at ?? 0, run?.updatedAt ?? 0) || null
+    };
+}
+export function marctlSessionProgress(runtime, sessionId) {
+    const { latestActivity: _latest, ...progress } = activity(runtime, sessionId);
+    return progress;
+}
+function identity(session) {
+    return {
+        id: session.id,
+        title: session.customTitle ?? session.runnerTitle ?? 'Untitled session',
+        runner: session.runner
+    };
+}
+export function marctlSessionSummary(runtime, session) {
+    const { status, runId, latestActivity } = activity(runtime, session.id);
+    if (latestActivity === null)
+        return { ...identity(session), status, runId, latestActivity: null };
+    const { runId: _activityRun, ...value } = latestActivity;
+    return { ...identity(session), status, runId, latestActivity: value };
+}
+export function marctlSessionDetail(runtime, session, queuedCount) {
+    const { status, runId, latestMessage, recentTools } = activity(runtime, session.id);
+    return {
+        ...identity(session),
+        status,
+        runId,
+        model: session.model,
+        effort: session.effort,
+        queuedCount,
+        latestMessage,
+        recentTools
+    };
+}
+function time(item) {
+    return item.updatedAt ?? item.completedAt ?? item.startedAt;
+}
+function isNewerActivity(current, at, kind) {
+    return (current === null ||
+        (at ?? 0) > (current.at ?? 0) ||
+        (at === current.at && kind === 'tool' && current.kind !== 'tool'));
+}
+function projectTool(item, payload, presentation) {
+    const name = clip(typeof payload.toolName === 'string' ? payload.toolName : item.kind, 128);
+    let summary = '';
+    if (presentation.kind === 'SLEEP') {
+        summary =
+            typeof presentation.elapsedMs === 'number'
+                ? 'Slept for ' +
+                    presentation.elapsedMs +
+                    ' ms' +
+                    (typeof presentation.wakeReason === 'string'
+                        ? '; wake reason: ' + presentation.wakeReason
+                        : '')
+                : typeof presentation.durationMs === 'number'
+                    ? 'Sleep for up to ' + presentation.durationMs + ' ms'
+                    : 'Sleep';
+    }
+    else if (item.kind === 'command_execution') {
+        summary =
+            typeof payload.title === 'string'
+                ? payload.title
+                : typeof payload.command === 'string'
+                    ? payload.command
+                    : '';
+        if (typeof payload.exitCode === 'number')
+            summary += '; exit code ' + payload.exitCode;
+    }
+    else if (item.kind === 'file_change' && Array.isArray(payload.changes)) {
+        summary = payload.changes
+            .filter(isPlainRecord)
+            .map((change) => (typeof change.path === 'string' ? change.path : ''))
+            .join(', ');
+    }
+    else {
+        summary = [
+            item.status === 'IN_PROGRESS' ? payload.progressLabel : undefined,
+            payload.title ?? payload.toolName,
+            payload.errorCode
+        ]
+            .filter((value) => typeof value === 'string' && value.length > 0)
+            .join(' · ');
+    }
+    const bounded = clip(summary.replace(/\s+/gu, ' ').trim(), 100);
+    return {
+        name: name.text,
+        state: item.status,
+        summary: bounded.text,
+        at: time(item),
+        runId: item.runId,
+        truncated: name.truncated || bounded.truncated || payload.truncated === true
+    };
+}
+function clip(value, limit) {
+    const chars = [];
+    for (const char of value) {
+        if (chars.length === limit)
+            return { text: chars.join(''), truncated: true };
+        chars.push(char);
+    }
+    return { text: chars.join(''), truncated: false };
+}

package/dist/service/workspace-queue-workbench-service.js

@@ -172,6 +172,11 @@ export class WorkspaceQueueWorkbenchService {
         const item = this.options.runtime.getQueueItem(itemId);
         return item?.clientMessageId.startsWith('goal:') ? undefined : item;
     }
+    queuedCount(sessionId) {
+        return this.options.runtime
+            .sessionQueue(sessionId)
+            .itemIds.filter((id) => this.publicQueueItem(id) !== undefined).length;
+    }
     requireItem(itemId, workspaceId) {
         const item = this.options.runtime.getQueueItem(itemId);
         if (item === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.10.57",
+  "version": "0.10.59",
   "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.10.57",
+    "@myagentroam/agent": "0.10.59",
+    "@myagentroam/marctl": "0.10.12",
     "@myagentroam/code-navigation": "0.10.1",
-    "@myagentroam/protocol": "0.10.57",
-    "@myagentroam/marctl": "0.10.11"
+    "@myagentroam/protocol": "0.10.59"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"