@myagentroam/node 0.10.29 → 0.10.31

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

@@ -17,7 +17,7 @@ export class MarAgentConversationNormalizer {
     messageItemId(nativeItemId) {
         return itemId('message', nativeItemId);
     }
-    normalize(event) {
+    normalize(event, options = {}) {
         if (event.type === 'execution.failed') {
             const projected = runnerErrorProjection({ code: event.code, message: event.message }, 'MAR_AGENT_RUN_FAILED');
             return [
@@ -99,19 +99,12 @@ export class MarAgentConversationNormalizer {
                     }
                 }
             ];
-        if (event.type === 'context.compacting' || event.type === 'context.compacted')
-            return [
-                {
-                    itemId: itemId('compact', event.compactionId),
-                    kind: 'context_compaction',
-                    status: event.type === 'context.compacting' ? 'IN_PROGRESS' : 'COMPLETED',
-                    payload: {
-                        phase: event.type === 'context.compacting' ? 'STARTED' : 'COMPLETED',
-                        summary: null
-                    },
-                    merge: true
-                }
-            ];
+        if (event.type === 'context.compacting' ||
+            event.type === 'context.compacted' ||
+            event.type === 'context.compact_failed') {
+            const anchorItemId = this.#compactAnchorItemId(event, options.publicItemIdPrefix);
+            return [normalizeContextCompaction(event, anchorItemId)];
+        }
         if (event.type === 'subagent.started' || event.type === 'subagent.completed')
             return this.#subagentLifecycle(event);
         return [];
@@ -204,6 +197,18 @@ export class MarAgentConversationNormalizer {
             genericToolItem(ownItemId, event.toolName, 'IN_PROGRESS', event.input, null, null, event.truncated === true, undefined, subagentTitle, subagentDetails)
         ];
     }
+    #compactAnchorItemId(event, publicItemIdPrefix) {
+        const anchor = event.anchor;
+        if (anchor === undefined || !validCompactAnchor(anchor.id))
+            return undefined;
+        const itemId = anchor.kind === 'message'
+            ? this.messageItemId(anchor.id)
+            : this.#tools.get(anchor.id)?.itemId;
+        if (itemId === undefined)
+            return undefined;
+        const publicItemId = publicItemIdPrefix === undefined ? itemId : `${publicItemIdPrefix}:${itemId}`;
+        return publicItemId.length <= 128 ? publicItemId : undefined;
+    }
     #toolCompleted(event) {
         const state = this.#tools.get(event.callId);
         if ((event.toolName === 'exec' || event.toolName === 'exec_wait') &&
@@ -526,6 +531,38 @@ function eventMetadata(event, eventId) {
 function itemId(kind, value) {
     return boundedConversationItemId(`mar-agent-${kind}`, value);
 }
+function normalizeContextCompaction(event, anchorItemId) {
+    const completed = event.type === 'context.compacted';
+    const failed = event.type === 'context.compact_failed';
+    const cancelled = failed && event.cancelled === true;
+    const code = failed && event.code.trim().length > 0
+        ? compactRunnerText(event.code, 80)
+        : failed
+            ? 'MAR_AGENT_COMPACT_FAILED'
+            : undefined;
+    return {
+        itemId: itemId('compact', event.compactionId),
+        kind: 'context_compaction',
+        status: failed ? (cancelled ? 'CANCELLED' : 'FAILED') : completed ? 'COMPLETED' : 'IN_PROGRESS',
+        payload: {
+            phase: completed ? 'COMPLETED' : 'STARTED',
+            summary: null,
+            ...(event.async === undefined ? {} : { mode: event.async ? 'BACKGROUND' : 'BLOCKING' }),
+            ...(event.type === 'context.compacting' && event.stage !== undefined
+                ? { stage: event.stage }
+                : {}),
+            ...(anchorItemId === undefined ? {} : { anchorItemId }),
+            ...(event.type === 'context.compacted' && event.retainedContext !== undefined
+                ? { retainedContext: event.retainedContext }
+                : {}),
+            ...(code === undefined ? {} : { code })
+        },
+        merge: true
+    };
+}
+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) {
     if (toolName === 'code_exec') {
         const code = typeof input === 'string' ? input : record(input)?.code;
@@ -730,6 +767,14 @@ function matchingSubagentControlOutput(toolName, input, output) {
     const operation = marAgentSubagentOperation(toolName);
     if (operation === undefined)
         return undefined;
+    if (toolName === 'agent_wait') {
+        const targets = structuredRecord(input)?.agentIds;
+        if (Array.isArray(targets) && targets.length !== 1)
+            return undefined;
+        const agents = structuredRecord(output)?.agents;
+        if (Array.isArray(agents))
+            output = agents.length === 1 ? agents[0] : undefined;
+    }
     const outputAgentId = marAgentAgentId(output);
     if (operation === 'START')
         return outputAgentId === undefined ? undefined : output;
@@ -851,6 +896,8 @@ function marAgentAgentId(value) {
     const direct = boundedId(data.agentId);
     if (direct !== undefined)
         return direct;
+    if (Array.isArray(data.agentIds))
+        return data.agentIds.length === 1 ? boundedId(data.agentIds[0]) : undefined;
     for (const key of ['data', 'result', 'output']) {
         const nested = marAgentAgentId(data[key]);
         if (nested !== undefined)

package/dist/runner/mar-agent/history-projection.js

@@ -31,8 +31,15 @@ export function projectMarAgentHistory(session, entries, options = {}) {
         const items = [...turn.items];
         if (index < 0)
             items.push(item);
-        else
-            items[index] = { ...items[index], ...item, startedAt: items[index].startedAt };
+        else {
+            const existing = items[index];
+            items[index] = {
+                ...existing,
+                ...item,
+                payload: mergeCompactLifecycleFacts(existing, item),
+                startedAt: existing.startedAt
+            };
+        }
         turns.set(turn.id, { ...turn, items });
     };
     for (const entry of entries) {
@@ -97,6 +104,28 @@ export function projectMarAgentHistory(session, entries, options = {}) {
     }
     return [...turns.values()];
 }
+function mergeCompactLifecycleFacts(previous, next) {
+    if (previous.kind !== 'context_compaction' || next.kind !== 'context_compaction')
+        return next.payload;
+    const previousPayload = record(previous.payload);
+    const nextPayload = record(next.payload);
+    if (previousPayload === undefined || nextPayload === undefined)
+        return next.payload;
+    return {
+        ...nextPayload,
+        ...(nextPayload.mode === undefined && previousPayload.mode !== undefined
+            ? { mode: previousPayload.mode }
+            : {}),
+        ...(nextPayload.anchorItemId === undefined && previousPayload.anchorItemId !== undefined
+            ? { anchorItemId: previousPayload.anchorItemId }
+            : {})
+    };
+}
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
 function historyItem(session, turn, id, kind, status, payload, at, permissionStop) {
     return {
         id,

package/dist/runner/mar-agent/managed-run-controller.js

@@ -941,7 +941,7 @@ export class MarAgentManagedRunController {
                 normalizer = new MarAgentConversationNormalizer();
                 this.#normalizers.set(runId, normalizer);
             }
-            for (const item of normalizer.normalize(event)) {
+            for (const item of normalizer.normalize(event, { publicItemIdPrefix: runId })) {
                 const attachments = item.generatedImages === undefined
                     ? []
                     : (this.host.registerGeneratedImages?.(runId, event.sessionId, item.generatedImages) ??
@@ -961,6 +961,7 @@ export class MarAgentManagedRunController {
 function contextUsageChanged(event) {
     return (event.type === 'context.compacted' ||
         (event.type === 'usage.updated' &&
+            event.purpose !== 'compact' &&
             (event.contextInputTokens !== undefined || event.inputTokens !== undefined)));
 }
 function isExecutionScopedMcp(server) {

package/dist/service/mail-notification-mcp-stdio.js

@@ -45,7 +45,12 @@ if (process.env['MAR_NOTIFICATION_CHANNELS'] === '1') {
                 .regex(/^[^\r\n]*$/u)
                 .optional(),
             message: z.string().min(1).max(4000),
-            recipientEmail: z.string().email().max(320).optional(),
+            recipientEmail: z
+                .string()
+                .min(3)
+                .max(320)
+                .optional()
+                .describe('Single recipient email address.'),
             templateId: z.enum(['', 'notification-en-US', 'notification-zh-CN']).optional()
         }
     }, async (args) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.10.29",
+  "version": "0.10.31",
   "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.29",
+    "@myagentroam/agent": "0.10.31",
     "@myagentroam/code-navigation": "0.10.1",
-    "@myagentroam/marctl": "0.10.3",
-    "@myagentroam/protocol": "0.10.29"
+    "@myagentroam/protocol": "0.10.31",
+    "@myagentroam/marctl": "0.10.3"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"