@myagentroam/node 0.10.40 → 0.10.42

package/dist/service/{mail-notification-mcp-stdio.js → notification-mcp-stdio.js}

@@ -1,16 +1,17 @@
+import { NODE_MCP, NODE_MCP_VERSION } from '../mcp/naming.js';
 import { randomUUID } from 'node:crypto';
 import { connect } from 'node:net';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { notificationInputSchema } from '@myagentroam/protocol';
-const endpoint = process.env['MAR_MAIL_MCP_ENDPOINT'];
-const token = process.env['MAR_MAIL_MCP_TOKEN'];
+const endpoint = process.env['MAR_NOTIFICATION_MCP_ENDPOINT'];
+const token = process.env['MAR_NOTIFICATION_MCP_TOKEN'];
 if (endpoint === undefined || token === undefined)
     throw new Error('MAIL_CAPABILITY_INVALID');
-const server = new McpServer({ name: 'mar_notification', version: '1.0.0' });
-server.registerTool('mar_send_email_notification', {
-    description: 'Send a notification email to the specified recipient from this MAR-managed Workspace conversation. The Agent works with files and tools on the authorized MAR Node; the MAR Server sends email using its administrator-configured SMTP account. This is not the browser or Node local email account, nor a repository cron/CI notification. This tool cannot access SMTP credentials. Omit the template to use the built-in notification template in the sender’s preferred language; optionally select notification-en-US or notification-zh-CN. Each call may send a real email; do not retry after an uncertain result.',
+const server = new McpServer({ name: NODE_MCP.notification.name, version: NODE_MCP_VERSION });
+server.registerTool(NODE_MCP.notification.tools.email, {
+    description: 'Send a notification email from this MAR-managed Workspace conversation. To email the initiating user’s own account, omit recipientEmail; the Server uses that account’s saved email address and fails if no valid address is configured. Specify recipientEmail only to send to another explicitly authorized address. The Agent works with files and tools on the authorized MAR Node; the MAR Server sends email using its administrator-configured SMTP account. This is not the browser or Node local email account, nor a repository cron/CI notification. This tool cannot access SMTP credentials. Omit the template to use the built-in notification template in the sender’s preferred language; optionally select notification-en-US or notification-zh-CN. Each call may send a real email; do not retry after an uncertain result.',
     inputSchema: {
         templateId: z
             .string()
@@ -23,16 +24,21 @@ server.registerTool('mar_send_email_notification', {
             .regex(/^[^\r\n]*$/u)
             .optional()
             .describe('Optional notification title rendered into the email subject.'),
-        recipientEmail: z.string().min(3).max(320).describe('Single recipient email address.'),
+        recipientEmail: z
+            .string()
+            .min(3)
+            .max(320)
+            .optional()
+            .describe('Optional authorized recipient override. Omit to email the initiating user’s own account.'),
         message: z.string().min(1).max(4000).describe('Notification text for {{message}}.')
     }
 }, async (args) => {
     const value = await request({ ...args, callId: randomUUID() });
     return { content: [{ type: 'text', text: JSON.stringify(value) }] };
 });
-if (process.env['MAR_NOTIFICATION_CHANNELS'] === '1') {
-    server.registerTool('mar_send_notification', {
-        description: 'Send a real notification from the current authorized Workspace execution. Defaults to push to the initiating user; email requires an explicitly authorized recipientEmail. Channels and registered Push clients are independent. Push may be suppressed while any workbench connection is open or unavailable due to system, browser, or OS settings. Acceptance is not delivery. Do not disclose secrets or send to unauthorized recipients. Each invocation is a new side effect; do not retry after an uncertain or partial result.',
+if (process.env['MAR_NOTIFICATION_MCP_CHANNELS'] === '1') {
+    server.registerTool(NODE_MCP.notification.tools.send, {
+        description: 'Send a real notification from the current authorized Workspace execution. Defaults to push to the initiating user. To email the user’s own account, include email in channels and omit recipientEmail; the Server uses the initiating account’s saved email address and fails if no valid address is configured. Specify recipientEmail only to send to another explicitly authorized address. Channels and registered Push clients are independent. Push may be suppressed while any workbench connection is open or unavailable due to system, browser, or OS settings. Acceptance is not delivery. Do not disclose secrets or send to unauthorized recipients. Each invocation is a new side effect; do not retry after an uncertain or partial result.',
         inputSchema: {
             channels: z
                 .array(z.enum(['push', 'email']))
@@ -50,17 +56,17 @@ if (process.env['MAR_NOTIFICATION_CHANNELS'] === '1') {
                 .min(3)
                 .max(320)
                 .optional()
-                .describe('Single recipient email address.'),
+                .describe('Optional authorized recipient override for the email channel. Omit to email the initiating user’s own account.'),
             templateId: z.enum(['', 'notification-en-US', 'notification-zh-CN']).optional()
         }
     }, async (args) => {
         const input = notificationInputSchema.parse(args);
-        const value = await request({ ...input, callId: randomUUID() }, 'mar_send_notification');
+        const value = await request({ ...input, callId: randomUUID() }, NODE_MCP.notification.tools.send);
         return { content: [{ type: 'text', text: JSON.stringify(value) }] };
     });
 }
 await server.connect(new StdioServerTransport());
-function request(args, tool = 'mar_send_email_notification') {
+function request(args, tool = NODE_MCP.notification.tools.email) {
     return new Promise((resolve, reject) => {
         const socket = connect(endpoint);
         socket.setTimeout(35_000, () => socket.destroy(new Error('MAIL_DELIVERY_UNCERTAIN')));

package/dist/service/restart-session-restorer.js

@@ -1,4 +1,4 @@
-import { serializeComposerTag } from '@myagentroam/protocol';
+import { parseComposerTags, serializeComposerTag } from '@myagentroam/protocol';
 import { parseMessageAttachments } from '../util/node-operation-parsers.js';
 import { RESTART_NOTICE } from './planned-restart-handoff.js';
 /** Rebuild inputs through the existing preparation and FIFO boundary. */
@@ -70,7 +70,7 @@ export class RestartSessionRestorer {
                 sessionId: session.id,
                 content,
                 clientMessageId: input.clientMessageId,
-                ...(content.startsWith('<mar_restart>')
+                ...(parseComposerTags(content)[0]?.kind === 'mar_restart'
                     ? { __runnerContent: `${content}${RESTART_NOTICE}` }
                     : {}),
                 attachments: input.attachments,

package/dist/service/{scheduled-task-mcp-server.js → schedule-mcp-bridge.js}

@@ -1,3 +1,4 @@
+import { NODE_MCP } from '../mcp/naming.js';
 import { randomBytes, randomUUID } from 'node:crypto';
 import { existsSync } from 'node:fs';
 import { unlink } from 'node:fs/promises';
@@ -5,7 +6,7 @@ import { createServer } from 'node:net';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
-export class ScheduledTaskMcpServer {
+export class ScheduleMcpBridge {
     store;
     changed;
     proposed;
@@ -24,23 +25,28 @@ export class ScheduledTaskMcpServer {
         this.create = create;
         this.resolveSessionId = resolveSessionId;
     }
-    async installation(capability) {
+    async prepare(capability) {
         await this.#listen();
+        const args = scheduleMcpStdioArgs();
         const token = randomBytes(32).toString('base64url');
-        const secretName = `MAR_SCHEDULE_MCP_${randomBytes(16).toString('hex').toUpperCase()}`;
         this.#capabilities.set(token, capability);
         return {
-            installation: {
-                __marScheduled: true,
-                serverName: 'mar_schedule',
-                enabled: true,
-                command: process.execPath,
-                args: scheduledMcpStdioArgs(),
-                endpoint: this.#endpoint,
-                secretName,
-                readOnly: capability.readonly
+            name: NODE_MCP.schedule.name,
+            origin: 'BUILTIN',
+            lifecycle: 'EXECUTION',
+            transport: 'STDIO',
+            command: process.execPath,
+            args,
+            environment: {
+                MAR_SCHEDULE_MCP_ENDPOINT: this.#endpoint,
+                MAR_SCHEDULE_MCP_TOKEN: token,
+                MAR_SCHEDULE_MCP_READ_ONLY: capability.readonly ? '1' : '0'
             },
-            secrets: { [secretName]: token }
+            allowedToolCallers: {
+                [NODE_MCP.schedule.tools.get]: ['direct', 'programmatic'],
+                [NODE_MCP.schedule.tools.create]: ['direct', 'programmatic'],
+                [NODE_MCP.schedule.tools.update]: ['direct', 'programmatic']
+            }
         };
     }
     revoke(executionId) {
@@ -95,11 +101,11 @@ export class ScheduledTaskMcpServer {
                 (task !== undefined &&
                     (task.id !== capability.taskId || task.revision !== capability.revision)))
                 throw new Error('SCHEDULE_CAPABILITY_STALE');
-            if (request.tool === 'mar_get_scheduled_task') {
+            if (request.tool === NODE_MCP.schedule.tools.get) {
                 socket.end(`${JSON.stringify({ result: task ?? null })}\n`);
                 return;
             }
-            if (request.tool === 'mar_create_scheduled_task') {
+            if (request.tool === NODE_MCP.schedule.tools.create) {
                 if (capability.readonly)
                     throw new Error('SCHEDULE_READ_ONLY');
                 if (task !== undefined)
@@ -126,7 +132,7 @@ export class ScheduledTaskMcpServer {
                 socket.end(`${JSON.stringify({ result: created })}\n`);
                 return;
             }
-            if (request.tool !== 'mar_update_scheduled_task')
+            if (request.tool !== NODE_MCP.schedule.tools.update)
                 throw new Error('SCHEDULE_TOOL_INVALID');
             if (capability.readonly)
                 throw new Error('SCHEDULE_READ_ONLY');
@@ -171,11 +177,11 @@ function record(value) {
         ? value
         : {};
 }
-function scheduledMcpStdioArgs() {
-    const javascript = fileURLToPath(new URL('./scheduled-task-mcp-stdio.js', import.meta.url));
+function scheduleMcpStdioArgs() {
+    const javascript = fileURLToPath(new URL('./schedule-mcp-stdio.js', import.meta.url));
     if (existsSync(javascript))
         return [javascript];
-    const typescript = fileURLToPath(new URL('./scheduled-task-mcp-stdio.ts', import.meta.url));
+    const typescript = fileURLToPath(new URL('./schedule-mcp-stdio.ts', import.meta.url));
     if (!existsSync(typescript))
         throw new Error('SCHEDULE_MCP_STDIO_ENTRY_UNAVAILABLE');
     return ['--import', import.meta.resolve('tsx'), typescript];

package/dist/service/{scheduled-task-mcp-stdio.js → schedule-mcp-stdio.js}

@@ -1,3 +1,4 @@
+import { NODE_MCP, NODE_MCP_VERSION } from '../mcp/naming.js';
 import { connect } from 'node:net';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -6,17 +7,17 @@ const endpoint = process.env['MAR_SCHEDULE_MCP_ENDPOINT'];
 const token = process.env['MAR_SCHEDULE_MCP_TOKEN'];
 if (endpoint === undefined || token === undefined)
     throw new Error('SCHEDULE_CAPABILITY_INVALID');
-const server = new McpServer({ name: 'mar_schedule', version: '1.0.0' });
+const server = new McpServer({ name: NODE_MCP.schedule.name, version: NODE_MCP_VERSION });
 const scopeNote = 'Scope is limited to the MAR scheduled task managed by Node for this conversation; ' +
     'it does not cover repository, CI, system cron, or other timers.';
 const objectiveDescription = 'Task body for one scheduled run in this conversation. State what that run should do with enough task context. ' +
     'Do not phrase it as a request to create or change a schedule or repeat cron/time-zone settings; MAR handles scheduling and skipped triggers.';
-server.registerTool('mar_get_scheduled_task', {
+server.registerTool(NODE_MCP.schedule.tools.get, {
     description: 'Read the MAR scheduled task bound to this MAR-managed Workspace conversation, or null if none exists. ' +
         scopeNote
-}, async () => result(await request('mar_get_scheduled_task', {})));
+}, async () => result(await request(NODE_MCP.schedule.tools.get, {})));
 if (process.env['MAR_SCHEDULE_MCP_READ_ONLY'] !== '1') {
-    server.registerTool('mar_create_scheduled_task', {
+    server.registerTool(NODE_MCP.schedule.tools.create, {
         description: 'Create the MAR scheduled task for this MAR-managed Workspace conversation. MAR runs it in this conversation for each admitted trigger using the connected Node time zone. ' +
             scopeNote,
         inputSchema: {
@@ -27,8 +28,8 @@ if (process.env['MAR_SCHEDULE_MCP_READ_ONLY'] !== '1') {
                 .max(64)
                 .describe('Five-field cron expression interpreted in the connected MAR Node time zone. It defines the schedule separately from the per-run task body.')
         }
-    }, async (args) => result(await request('mar_create_scheduled_task', args)));
-    server.registerTool('mar_update_scheduled_task', {
+    }, async (args) => result(await request(NODE_MCP.schedule.tools.create, args)));
+    server.registerTool(NODE_MCP.schedule.tools.update, {
         description: 'Update the MAR scheduled task for this MAR-managed Workspace conversation. MAR runs the saved objective in this conversation for each admitted trigger using the connected Node time zone. ' +
             scopeNote,
         inputSchema: {
@@ -40,7 +41,7 @@ if (process.env['MAR_SCHEDULE_MCP_READ_ONLY'] !== '1') {
                 .describe('Replacement five-field cron expression in the connected MAR Node time zone.')
                 .optional()
         }
-    }, async (args) => result(await request('mar_update_scheduled_task', args)));
+    }, async (args) => result(await request(NODE_MCP.schedule.tools.update, args)));
 }
 await server.connect(new StdioServerTransport());
 function request(tool, args) {

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

@@ -294,9 +294,9 @@ export class SessionCatalogService {
                     (!this.options.runnerAvailable(session.runner) ||
                         this.options.runtime.getAgentSession(session.id) !== undefined)) ||
                 (!missingCandidate &&
-                    (!Number.isFinite(session.lastActivityAt) ||
-                        session.lastActivityAt <= 0 ||
-                        session.lastActivityAt >= cutoff)) ||
+                    Number.isFinite(session.lastActivityAt) &&
+                    session.lastActivityAt > 0 &&
+                    session.lastActivityAt >= cutoff) ||
                 (session.pinOrder !== null && session.pinOrder !== undefined) ||
                 this.options.isWatching(session.id) ||
                 this.options.isRecovering?.(session.id) ||

package/package.json

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