@myagentroam/node 0.11.48 → 0.11.49

package/dist/connector.js

@@ -67,7 +67,7 @@ import { SessionScheduleService } from './session/session-schedule-service.js';
 import { ScheduledSessionCoordinator } from './service/scheduled-session-coordinator.js';
 import { ScheduledSessionStore } from './service/scheduled-session-store.js';
 import { RunAuthorizationControl } from './service/run-authorization-control.js';
-import { PlannedRestartHandoff } from './service/planned-restart-handoff.js';
+import { PlannedRestartHandoff, plannedRestartCaptureDiagnostic } from './service/planned-restart-handoff.js';
 import { NodeUpgradeCredentialControl } from './service/node-upgrade-credential-control.js';
 import { RestartSessionRestorer } from './service/restart-session-restorer.js';
 import { ScheduleMcpBridge } from './service/schedule-mcp-bridge.js';
@@ -200,7 +200,8 @@ export class NodeConnector {
         publish: (snapshot) => this.restartHandoff.publish(snapshot),
         diagnose: (stage, error) => nodeLog('node.shutdown.failed', {
             stage,
-            errorCode: safeErrorCode(error, 'NODE_SHUTDOWN_FAILED')
+            errorCode: safeErrorCode(error, 'NODE_SHUTDOWN_FAILED'),
+            ...(stage === 'capture' ? plannedRestartCaptureDiagnostic(error) : undefined)
         })
     });
     get stopped() {

package/dist/runner/mar-agent/agent-network-extension.js

@@ -131,7 +131,9 @@ const tools = [
 ];
 const delegationPrompt = [
     '# Delegation and coordination',
-    'Delegate bounded, self-contained tasks when independent progress or context savings materially helps. Keep simple or tightly coupled work local.',
+    'Handle focused or tightly coupled work locally by default.',
+    'Delegate a clearly separable subtask when parallel progress or context savings materially outweigh coordination overhead.',
+    'Do not split work merely because agents are available.',
     'Give each child an objective, necessary context, expected output, and a read-only boundary or non-overlapping write scope.',
     'Follow up through the direct delegate by default; inspect deeper Sessions only when a concrete issue needs independent verification.',
     'While children run, continue meaningful non-overlapping work. Do not redo delegated work. Wait only when the next step needs the result.',

package/dist/service/planned-restart-handoff.js

@@ -84,6 +84,44 @@ const legacyPlannedRestartSchema = plannedRestartSchema.extend({
         })
     }))
 });
+// Only this producer can associate log-safe metadata with an original failure.
+const captureDiagnostics = new WeakMap();
+const captureFields = new Set([
+    ...Object.keys(plannedRestartSchema.shape),
+    ...Object.keys(sessionSchema.shape),
+    ...Object.keys(sessionSchema.shape.session.shape),
+    ...Object.keys(goalSchema.shape),
+    ...Object.keys(goalSchema.shape.goal.shape),
+    ...Object.keys(messageSchema.shape),
+    ...Object.keys(attachmentSchema.shape)
+]);
+export function plannedRestartCaptureDiagnostic(error) {
+    return error instanceof Error ? captureDiagnostics.get(error) : undefined;
+}
+function parseCapture(schema, input, reason) {
+    const result = schema.safeParse(input);
+    if (result.success)
+        return result.data;
+    captureDiagnostics.set(result.error, {
+        reason,
+        issues: result.error.issues.slice(0, 12).map((issue) => ({
+            code: issue.code,
+            // Only schema-owned fields and array offsets, never unknown keys or input values.
+            path: issue.path
+                .slice(0, 8)
+                .map((part) => typeof part === 'number'
+                ? `[${part}]`
+                : captureFields.has(String(part))
+                    ? String(part)
+                    : '*')
+                .join('.')
+                .replaceAll('.[', '[')
+                .slice(0, 160)
+        })),
+        issuesTruncated: result.error.issues.length > 12
+    });
+    throw result.error;
+}
 export const RESTART_NOTICE = 'The previous execution was interrupted by a system restart. Check the session history and current workspace, then continue unfinished work. Verify completed or uncertain actions before proceeding; do not blindly repeat actions with external side effects.';
 /** A one-shot orderly-shutdown handoff, not a crash-recovery journal. */
 export class PlannedRestartHandoff {
@@ -197,8 +235,13 @@ export class PlannedRestartHandoff {
                 : toMessage(currentId, pending.clientMessageId ?? active.clientMessageId, pending.restartMessage.content, [...pending.restartMessage.attachments], pending.restartMessage.initiatedByUserId ?? active?.initiatedByUserId, active?.suppressNotifications);
             if (current === undefined && items.length === 0 && goal === undefined && !awaitingGoal)
                 continue;
-            if (session.externalSessionId === null)
-                throw new Error('RESTART_SESSION_NOT_READY');
+            if (session.externalSessionId === null) {
+                const error = Object.assign(new Error('RESTART_SESSION_NOT_READY'), {
+                    code: 'RESTART_SESSION_NOT_READY'
+                });
+                captureDiagnostics.set(error, { reason: 'session_not_ready' });
+                throw error;
+            }
             const ownerUserId = active?.initiatedByUserId ??
                 items[0]?.initiatedByUserId ??
                 this.owners.get(session.id) ??
@@ -220,18 +263,20 @@ export class PlannedRestartHandoff {
                 ...(notificationSource?.suppressNotifications === true
                     ? { suppressNotifications: true }
                     : {}),
-                ...(goal === undefined ? {} : { goal: goalSchema.parse(goal) }),
+                ...(goal === undefined
+                    ? {}
+                    : { goal: parseCapture(goalSchema, goal, 'goal_schema_invalid') }),
                 ...(current === undefined ? {} : { current }),
                 queue: items
             });
         }
-        return plannedRestartSchema.parse({
+        return parseCapture(plannedRestartSchema, {
             schemaVersion: 2,
             id: randomUUID(),
             ...this.options.identity(),
             createdAt: Date.now(),
             sessions
-        });
+        }, 'snapshot_schema_invalid');
     }
     async publish(snapshot) {
         for (const entry of snapshot.sessions) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.11.48",
+  "version": "0.11.49",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -38,10 +38,10 @@
     "sharp": "0.35.5",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.11.48",
+    "@myagentroam/agent": "0.11.49",
     "@myagentroam/code-navigation": "0.11.1",
-    "@myagentroam/protocol": "0.11.48",
-    "@myagentroam/marctl": "0.11.9"
+    "@myagentroam/marctl": "0.11.9",
+    "@myagentroam/protocol": "0.11.49"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"