@myagentroam/node 0.10.46 → 0.10.48

package/dist/connector.js

@@ -1619,7 +1619,8 @@ export class NodeConnector {
             emitSession: (session) => this.emitSessionWorkbenchEvent({
                 session: this.sessionPresentationService.present(session)
             }),
-            changed: () => this.scheduledSessions.changed()
+            changed: () => this.scheduledSessions.changed(),
+            proposed: (sessionId, proposalId) => this.emitScheduledProposalNotification(sessionId, proposalId)
         });
         this.operationRouter.registerAll(this.sessionScheduleService.operations());
         this.operationRouter.registerAll(this.sessionMessageService.operations());

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

@@ -320,8 +320,10 @@ export class MarAgentManagedRunController {
             runtime.activeRunId = input.runId;
             await runtime.mcpLease.pool.refreshForExecution();
             controller.signal.throwIfAborted();
+            const marctlSkill = marctlHostSkill(input.secretEnvironment);
             const executionMcpServers = input.mcpServers
                 .filter(isExecutionScopedMcp)
+                .filter((server) => marctlSkill === undefined || server.name !== NODE_MCP.schedule.name)
                 .map((server) => ({ ...server, lifecycle: 'EXECUTION' }));
             computerUseBinding = await this.#computerUse?.bind({
                 runId: input.runId,
@@ -371,7 +373,6 @@ export class MarAgentManagedRunController {
                     ? {}
                     : { webFetch: (request, signal) => this.host.webFetch(request, signal) })
             }));
-            const marctlSkill = marctlHostSkill(input.secretEnvironment);
             executionMcpBinding = runtime.host.bindExecutionExtensions({
                 ...extensions,
                 environment: marctlExecutionEnvironment(input.secretEnvironment),

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

@@ -10,7 +10,7 @@ export function marctlHostSkill(environment = {}) {
         return undefined;
     return {
         name: 'marctl',
-        description: 'You are in a MAR-managed Workspace with marctl on PATH. Use this skill to inspect, create, message, stop or coordinate independent Sessions, or use authorized Node terminals and file transfer. Load before cross-Session coordination.',
+        description: 'You are in a MAR-managed Workspace with marctl on PATH. Use this skill to inspect, create, rename, configure, message, stop or coordinate independent Sessions, manage their scheduled tasks, or use authorized Node terminals and file transfer. Load before cross-Session coordination.',
         requiredTools: ['exec'],
         load: async () => marctlInstructions
     };
@@ -26,8 +26,12 @@ const marctlInstructions = [
     '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.',
-    'Read results with sessions history <session-id> --limit 10 --json (default: latest 10 SEGMENTs, not messages; --limit 1..100). Extract needed assistant_message payload.text from segments[].items[]; keep segment runId and user_message.payload.clientMessageId for queued-input correlation. Reuse the returned page; follow --cursor <nextCursor> only for missing evidence.',
-    'When useful, add gentle context to an in-progress task with sessions send <session-id> --steer -m "Additional context: focus on the resume path." --json. 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. 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.',
+    '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.',
+    '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. Other-owner edits return a PENDING proposal, not an applied change; scheduled execution is read-only. 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.',
     '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',

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

@@ -139,32 +139,18 @@ export class ScheduleMcpBridge {
             if (task === undefined)
                 throw new Error('SCHEDULE_NOT_FOUND');
             const args = record(request.arguments);
-            const objective = args.objective;
-            const cron = args.cron;
-            if ((objective !== undefined && typeof objective !== 'string') ||
-                (cron !== undefined && typeof cron !== 'string') ||
-                (objective === undefined && cron === undefined))
-                throw new Error('SCHEDULE_UPDATE_INVALID');
-            const patch = {
-                ...(objective === undefined ? {} : { objective: objective }),
-                ...(cron === undefined ? {} : { cron: cron })
-            };
-            if (capability.actorUserId === task.ownerUserId) {
-                const updated = this.store().update(task.sessionId, task.revision, {
-                    ...patch,
-                    ownerUserId: capability.actorUserId
-                });
+            const result = this.store().updateFromAgent(task.sessionId, task.revision, capability.actorUserId, args);
+            if ('proposalId' in result) {
+                this.proposed(task.sessionId, result.proposalId);
+                socket.end(`${JSON.stringify({ result })}\n`);
+            }
+            else {
                 this.#capabilities.set(request.token, {
                     ...capability,
-                    revision: updated.revision
+                    revision: result.revision
                 });
                 this.changed(task.sessionId);
-                socket.end(`${JSON.stringify({ result: updated })}\n`);
-            }
-            else {
-                const proposalId = this.store().propose(task, capability.actorUserId, patch);
-                this.proposed(task.sessionId, proposalId);
-                socket.end(`${JSON.stringify({ result: { proposalId, status: 'PENDING' } })}\n`);
+                socket.end(`${JSON.stringify({ result })}\n`);
             }
         }
         catch (error) {

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

@@ -25,6 +25,62 @@ export class ScheduledSessionStore {
             .prepare('SELECT * FROM scheduled_session_tasks WHERE enabled=1 AND next_run_at<=? ORDER BY next_run_at,id')
             .all(at).map(taskFromRow);
     }
+    list(workspaceId, cursor, limit = 20) {
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 100)
+            throw new Error('SCHEDULE_INVALID');
+        let after = '';
+        if (cursor !== undefined) {
+            try {
+                if (cursor.length > 4096)
+                    throw new Error();
+                const decoded = JSON.parse(Buffer.from(cursor, 'base64url').toString('utf8'));
+                if (decoded.workspaceId !== workspaceId ||
+                    typeof decoded.after !== 'string' ||
+                    decoded.after.length < 1 ||
+                    decoded.after.length > 512)
+                    throw new Error();
+                after = decoded.after;
+            }
+            catch {
+                throw new Error('SCHEDULE_INVALID');
+            }
+        }
+        const rows = this.database
+            .prepare(`SELECT t.*, COALESCE(json_extract(s.metadata,'$.customTitle'),
+         json_extract(s.metadata,'$.runnerTitle'),s.id) AS session_title
+       FROM scheduled_session_tasks t JOIN agent_sessions s ON s.id=t.session_id
+       WHERE t.workspace_id=? AND t.id>? ORDER BY t.id LIMIT ?`)
+            .all(workspaceId, after, limit + 1);
+        const tasks = rows
+            .slice(0, limit)
+            .map((row) => ({ ...taskFromRow(row), sessionTitle: row['session_title'] }));
+        return {
+            tasks,
+            nextCursor: rows.length > limit
+                ? Buffer.from(JSON.stringify({ workspaceId, after: tasks.at(-1).id })).toString('base64url')
+                : null
+        };
+    }
+    updateFromAgent(sessionId, expectedRevision, actorUserId, input) {
+        if (!Number.isSafeInteger(actorUserId) || actorUserId < 1)
+            throw new Error('USER_AUTHORIZATION_REQUIRED');
+        const task = this.get(sessionId);
+        if (task === undefined)
+            throw new Error('SCHEDULE_NOT_FOUND');
+        if (task.revision !== expectedRevision)
+            throw new Error('SCHEDULE_REVISION_CONFLICT');
+        if ((input.objective !== undefined && typeof input.objective !== 'string') ||
+            (input.cron !== undefined && typeof input.cron !== 'string') ||
+            (input.objective === undefined && input.cron === undefined))
+            throw new Error('SCHEDULE_UPDATE_INVALID');
+        const patch = {
+            ...(input.objective === undefined ? {} : { objective: input.objective }),
+            ...(input.cron === undefined ? {} : { cron: input.cron })
+        };
+        if (actorUserId === task.ownerUserId)
+            return this.update(sessionId, expectedRevision, patch);
+        return { proposalId: this.propose(task, actorUserId, patch), status: 'PENDING' };
+    }
     nextDueAt() {
         const row = this.database
             .prepare('SELECT MIN(next_run_at) AS value FROM scheduled_session_tasks WHERE enabled=1')

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

@@ -21,11 +21,64 @@ export class SessionScheduleService {
     operations() {
         return {
             'session.schedule.get': (data) => this.get(record(data)),
+            'session.schedule.list': (data) => this.list(record(data)),
+            'session.schedule.agent.save': (data) => this.saveFromAgent(record(data)),
             'session.schedule.save': (data) => this.save(record(data)),
             'session.schedule.remove': (data) => this.remove(record(data)),
             'session.schedule.proposal.resolve': (data) => this.resolveProposal(record(data))
         };
     }
+    list(input) {
+        if (typeof input.workspaceId !== 'string' ||
+            this.options.database().getWorkspace(input.workspaceId) === undefined)
+            throw new Error('WORKSPACE_NOT_FOUND');
+        if ((input.cursor !== undefined && typeof input.cursor !== 'string') ||
+            (input.limit !== undefined && typeof input.limit !== 'number'))
+            throw new Error('SCHEDULE_INVALID');
+        const page = this.store().list(input.workspaceId, input.cursor, input.limit);
+        return {
+            ...page,
+            tasks: page.tasks.map((task) => {
+                const session = this.options.runtime.getAgentSession(task.sessionId);
+                return {
+                    ...task,
+                    sessionTitle: session?.customTitle ?? session?.runnerTitle ?? task.sessionTitle
+                };
+            })
+        };
+    }
+    async saveFromAgent(input) {
+        const session = await this.requireSession(input, input.mode === 'create');
+        const actor = input.__requestUserId;
+        if (!Number.isSafeInteger(actor) || actor < 1)
+            throw new Error('USER_AUTHORIZATION_REQUIRED');
+        const sessionId = session.externalSessionId ?? session.id;
+        if (input.mode === 'create') {
+            if (this.store().get(sessionId) !== undefined)
+                throw new Error('SCHEDULE_ALREADY_EXISTS');
+            if (typeof input.objective !== 'string' || typeof input.cron !== 'string')
+                throw new Error('SCHEDULE_INVALID');
+            return {
+                task: await this.createFromMcp({
+                    sessionId: session.id,
+                    workspaceId: session.workspaceId,
+                    actorUserId: actor,
+                    objective: input.objective,
+                    cron: input.cron
+                })
+            };
+        }
+        if (input.mode !== 'update')
+            throw new Error('SCHEDULE_INVALID');
+        const result = this.store().updateFromAgent(sessionId, input.expectedRevision, actor, input);
+        if ('proposalId' in result) {
+            this.options.proposed?.(sessionId, result.proposalId);
+            return result;
+        }
+        this.options.emitSession(this.options.runtime.getAgentSession(session.id) ?? session);
+        this.options.changed?.();
+        return { task: result };
+    }
     async get(input) {
         const session = await this.requireSession(input);
         const store = this.store();
@@ -128,14 +181,14 @@ export class SessionScheduleService {
         this.options.changed?.();
         return { task, proposals: this.store().pendingProposals(task.id) };
     }
-    async requireSession(input) {
+    async requireSession(input, allowPendingNative = false) {
         if (typeof input.sessionId !== 'string' || typeof input.workspaceId !== 'string')
             throw new Error('SCHEDULE_INVALID');
         const session = this.options.runtime.getAgentSession(input.sessionId) ??
             (await this.options.projection.createMetadataProjection(input.sessionId));
         if (session === undefined ||
             session.workspaceId !== input.workspaceId ||
-            session.externalSessionId === null)
+            (session.externalSessionId === null && !allowPendingNative))
             throw new Error('SESSION_NOT_FOUND');
         return session;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.10.46",
+  "version": "0.10.48",
   "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/marctl": "0.10.8",
     "@myagentroam/code-navigation": "0.10.1",
-    "@myagentroam/protocol": "0.10.46",
-    "@myagentroam/agent": "0.10.46"
+    "@myagentroam/agent": "0.10.48",
+    "@myagentroam/marctl": "0.10.10",
+    "@myagentroam/protocol": "0.10.48"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"