@myagentroam/node 0.9.144 → 0.9.146

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

@@ -336,19 +336,6 @@ export class MarAgentConversationNormalizer {
                 if (observation.outcome === 'failed')
                     projected = projected.map((item) => item.kind === 'file_change' ? { ...item, status: 'FAILED' } : item);
             }
-            else if (toolName === 'todo_read') {
-                if (observation.outcome !== 'completed' ||
-                    record(input) === undefined ||
-                    !isTodoObservationData(observation.result.data))
-                    continue;
-                const todo = observation.result.data;
-                projected = this.normalize({
-                    ...eventMetadata(event, observation.source.callId),
-                    type: 'todo.updated',
-                    revision: todo.revision,
-                    items: todo.items
-                });
-            }
             else if (marAgentSubagentOperation(toolName) !== undefined) {
                 if (!isSubagentToolInput(toolName, input) ||
                     !isSubagentObservationData(observation.result.data, input))
@@ -512,10 +499,8 @@ function codeModeObservationResults(value) {
     });
 }
 function isPersonalizedToolName(toolName) {
-    // todo_write already emits the native todo.updated event; avoid a duplicate card here.
-    return (toolName === 'apply_patch' ||
-        toolName === 'todo_read' ||
-        marAgentSubagentOperation(toolName) !== undefined);
+    // Todo cards come only from native todo.updated events, never tool result snapshots.
+    return toolName === 'apply_patch' || marAgentSubagentOperation(toolName) !== undefined;
 }
 function isApplyPatchObservationData(value) {
     const data = record(value);
@@ -548,26 +533,6 @@ function isApplyPatchObservationData(value) {
         Number.isSafeInteger(totals.deletedLines) &&
         totals.deletedLines >= 0);
 }
-function isTodoObservationData(value) {
-    const data = record(value);
-    if (data === undefined ||
-        !Number.isSafeInteger(data.revision) ||
-        data.revision < 0 ||
-        !Array.isArray(data.items))
-        return false;
-    return data.items.every((entry) => {
-        const item = record(entry);
-        if (item === undefined ||
-            typeof item.id !== 'string' ||
-            item.id.trim().length === 0 ||
-            typeof item.step !== 'string' ||
-            item.step.trim().length === 0 ||
-            (item.status !== 'pending' && item.status !== 'in_progress' && item.status !== 'completed') ||
-            !Number.isSafeInteger(data.revision))
-            return false;
-        return true;
-    });
-}
 function isSubagentToolInput(toolName, value) {
     const input = record(value);
     if (input === undefined)

package/dist/runner/mar-agent/hosted-conversation-runtime.js

@@ -1,5 +1,5 @@
 import { createHash } from 'node:crypto';
-import { LocalAgentHost, MarAgentError, createMarAgent, openMarAgentSessionCatalog } from '@myagentroam/agent';
+import { LocalAgentHost, MarAgentError, createMarAgent, generateSessionTitle, openMarAgentSessionCatalog } from '@myagentroam/agent';
 import { projectMarAgentHistory } from './history-projection.js';
 import { MarAgentConversationNormalizer } from './conversation-normalizer.js';
 import { hostedConversationGeneratedImagesDisplayDirectory, hostedConversationImageRunId, marAgentGeneratedImageSources, marAgentGeneratedImagesDirectory } from './generated-images.js';
@@ -12,6 +12,7 @@ import { createImageGenerationExtensions } from './image-generation-extensions.j
  */
 export class MarAgentHostedConversationRuntime {
     #createAgent;
+    #generateTitle;
     #createHost;
     #openCatalog;
     #now;
@@ -22,6 +23,7 @@ export class MarAgentHostedConversationRuntime {
     #registerNativeImages;
     constructor(options = {}) {
         this.#createAgent = options.createAgent ?? createMarAgent;
+        this.#generateTitle = options.generateTitle ?? generateSessionTitle;
         this.#createHost = options.createHost ?? ((input) => new LocalAgentHost(input));
         this.#openCatalog = options.openCatalog ?? openMarAgentSessionCatalog;
         this.#now = options.now ?? Date.now;
@@ -109,7 +111,10 @@ export class MarAgentHostedConversationRuntime {
     async startRun(input) {
         if (this.#active.has(input.sessionId))
             throw new Error('HOSTED_CONVERSATION_RUN_ACTIVE');
-        const { agent, mcp, closeImages } = await this.#createRuntime(input);
+        const { agent, mcp, closeImages, models } = await this.#createRuntime(input);
+        const titleController = new AbortController();
+        let titleTask;
+        const metadata = await agent.getSession(input.sessionId).catch(() => undefined);
         let execution;
         try {
             const session = await agent.openSession(input.sessionId);
@@ -132,6 +137,13 @@ export class MarAgentHostedConversationRuntime {
         const completion = (async () => {
             try {
                 for await (const event of execution) {
+                    if (event.type === 'execution.started' && metadata?.automaticTitlePending && !titleTask)
+                        titleTask = this.#generateTitle({
+                            models: sdkModelConfigurations(models),
+                            currentModelId: input.modelId,
+                            prompt: input.userPrompt,
+                            signal: titleController.signal
+                        }).catch(() => undefined);
                     await this.#onEvent?.(input.conversationId, event);
                     for (const projected of projectHostedEvent(normalizer, event, {
                         clientMessageId: input.clientMessageId,
@@ -140,6 +152,17 @@ export class MarAgentHostedConversationRuntime {
                         await input.onEvent?.(projected);
                 }
                 const result = await execution.result();
+                if (result.status === 'cancelled')
+                    titleController.abort();
+                const generatedTitle = await titleTask;
+                if (generatedTitle && !titleController.signal.aborted)
+                    await agent
+                        .setSessionTitle(input.sessionId, generatedTitle, {
+                        automatic: true,
+                        expectedTitle: metadata.title,
+                        executionId: execution.executionId
+                    })
+                        .catch(() => undefined);
                 const title = await this.#readGeneratedTitle(input.homeDirectory, input.sessionId).catch(() => undefined);
                 return {
                     status: result.status === 'completed'
@@ -160,6 +183,8 @@ export class MarAgentHostedConversationRuntime {
                 };
             }
             finally {
+                titleController.abort();
+                await titleTask;
                 settled = true;
                 this.#active.delete(input.sessionId);
                 await agent.dispose().catch(() => undefined);
@@ -178,6 +203,7 @@ export class MarAgentHostedConversationRuntime {
             cancel: () => {
                 if (settled || this.#active.get(input.sessionId)?.handle !== handle)
                     return false;
+                titleController.abort();
                 execution.cancel();
                 return true;
             }
@@ -297,6 +323,7 @@ export class MarAgentHostedConversationRuntime {
             };
             return {
                 agent: await this.#createAgent(options),
+                models,
                 closeImages,
                 ...(mcp === undefined ? {} : { mcp })
             };

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

@@ -4,7 +4,7 @@ import { homedir } from 'node:os';
 import { access, constants } from 'node:fs/promises';
 import { nodeExecutionEnvironment } from '../../node-execution-environment.js';
 import { BUNDLED_RIPGREP_VERSION, bundledRipgrepPath, prependBundledRipgrepToPath } from '../../ripgrep-binary.js';
-import { LocalAgentHost, createMarAgent } from '@myagentroam/agent';
+import { LocalAgentHost, createMarAgent, generateSessionTitle } from '@myagentroam/agent';
 import { marAgentReasoningEffortSchema, marAgentRuntimeModelConfigurationSchema } from '@myagentroam/protocol';
 import { boundedConversationItemId } from '../codex/conversation-parser.js';
 import { parseSecretEnvironment } from '../../util/secret-environment.js';
@@ -29,6 +29,7 @@ export class MarAgentManagedRunController {
     #createAgent;
     #modelFactory;
     #computerUse;
+    #generateTitle;
     #disposePromise;
     #disposed = false;
     constructor(runner, host, options = {}) {
@@ -44,6 +45,7 @@ export class MarAgentManagedRunController {
                     }
                 });
         this.#computerUse = options.computerUse;
+        this.#generateTitle = options.generateTitle ?? generateSessionTitle;
     }
     dispose() {
         if (this.#disposePromise !== undefined)
@@ -244,6 +246,8 @@ export class MarAgentManagedRunController {
         let executionMcpBinding;
         let computerUseBinding;
         let executionModels = [];
+        const titleController = new AbortController();
+        let titleTask;
         try {
             const sessionKey = input.externalSessionId ?? input.sessionId;
             // Reserve both identities while opening so a concurrent release can await the same runtime.
@@ -364,6 +368,9 @@ export class MarAgentManagedRunController {
                 ...(reasoningEffort === undefined ? {} : { reasoningEffort }),
                 images: input.images
             };
+            const metadata = input.mode === 'compact' || !runtime.automaticTitleEnabled
+                ? undefined
+                : await runtime.agent.getSession(session.id).catch(() => undefined);
             const handle = input.mode === 'plan'
                 ? session.plan({
                     ...runInput
@@ -372,12 +379,36 @@ export class MarAgentManagedRunController {
                     ? session.compact(runInput)
                     : session.run(runInput);
             this.#executions.set(input.runId, {
-                cancel: () => handle.cancel()
+                cancel: () => {
+                    titleController.abort();
+                    handle.cancel();
+                }
             });
             this.host.emit(input.runId, 'run.running', {}, 'RUNNING');
-            for await (const event of handle)
+            for await (const event of handle) {
+                if (event.type === 'execution.started' && metadata?.automaticTitlePending && !titleTask) {
+                    titleTask = this.#generateTitle({
+                        models: sdkModelConfigurations(executionModels),
+                        currentModelId: input.model.id,
+                        prompt: input.input,
+                        signal: titleController.signal
+                    }).catch(() => undefined);
+                    runtime.automaticTitleTask = { cancel: () => titleController.abort(), result: titleTask };
+                }
                 this.project(input.runId, event);
+            }
             const result = await handle.result();
+            if (result.status === 'cancelled')
+                titleController.abort();
+            const title = await titleTask;
+            if (title && !titleController.signal.aborted)
+                await runtime.agent
+                    .setSessionTitle(session.id, title, {
+                    automatic: true,
+                    expectedTitle: metadata.title,
+                    executionId: handle.executionId
+                })
+                    .catch(() => undefined);
             await this.host.syncTitle(session.id, input.cwd);
             const status = result.status === 'completed'
                 ? 'SUCCEEDED'
@@ -412,6 +443,10 @@ export class MarAgentManagedRunController {
             this.host.emit(input.runId, 'run.failed', projected, 'FAILED');
         }
         finally {
+            titleController.abort();
+            await titleTask;
+            if (runtime !== undefined && runtime.automaticTitleTask?.result === titleTask)
+                delete runtime.automaticTitleTask;
             this.clearInteractions(input.runId);
             this.#normalizers.delete(input.runId);
             this.host.active.delete(input.runId);
@@ -554,6 +589,7 @@ export class MarAgentManagedRunController {
                 normalizer: new MarAgentConversationNormalizer(),
                 mcpLease,
                 dynamicCredentials,
+                automaticTitleEnabled: input.externalSessionId === undefined,
                 models,
                 released: false
             };
@@ -608,6 +644,10 @@ export class MarAgentManagedRunController {
                 delete runtime.idleTimer;
             }
             try {
+                if (runtime.automaticTitleTask !== undefined) {
+                    runtime.automaticTitleTask.cancel();
+                    await runtime.automaticTitleTask.result;
+                }
                 try {
                     await this.#computerUse?.releaseSession(runtime.session.id);
                 }

package/dist/runner/mar-agent/runtime-model-factory.js

@@ -76,9 +76,6 @@ export class MarAgentRuntimeModelFactory {
                     ...(configuration.responsesTransport === undefined
                         ? {}
                         : { responsesTransport: configuration.responsesTransport }),
-                    ...(configuration.responsesEncoding === undefined
-                        ? {}
-                        : { responsesEncoding: configuration.responsesEncoding }),
                     responsesToolNamespace: configuration.responsesToolNamespace,
                     responsesPreviousResponseId: configuration.responsesPreviousResponseId,
                     enabled: configuration.enabled
@@ -114,7 +111,6 @@ export class MarAgentRuntimeModelFactory {
                             }
                         }
                         : {}),
-                    responsesEncoding: configuration.responsesEncoding ?? 'STANDARD',
                     responsesConfigurationUpdates: configuration.responsesConfigurationUpdates === true,
                     credentialProvider: provider
                 };

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

@@ -152,6 +152,18 @@ export class ScheduledSessionStore {
             .prepare('SELECT * FROM scheduled_session_occurrences WHERE task_id=? ORDER BY due_at DESC LIMIT ?')
             .all(taskId, Math.max(1, Math.min(limit, 100)));
     }
+    recentPage(taskId, page = 1) {
+        if (!Number.isSafeInteger(page) || page < 1)
+            throw new Error('SCHEDULE_INVALID');
+        const total = this.database
+            .prepare('SELECT COUNT(*) AS count FROM scheduled_session_occurrences WHERE task_id=?')
+            .get(taskId).count;
+        const actualPage = Math.min(page, Math.max(1, Math.ceil(total / 10)));
+        const occurrences = this.database
+            .prepare('SELECT * FROM scheduled_session_occurrences WHERE task_id=? ORDER BY due_at DESC, id DESC LIMIT 10 OFFSET ?')
+            .all(taskId, (actualPage - 1) * 10);
+        return { occurrences, occurrenceTotal: total, occurrencePage: actualPage };
+    }
     pendingProposals(taskId) {
         return this.database
             .prepare(`SELECT * FROM scheduled_session_proposals

package/dist/service/scheduled-task-mcp-stdio.js

@@ -7,25 +7,32 @@ 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 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', {
-    description: 'Read the MAR scheduled task for this MAR-managed Workspace conversation, or null if none exists.'
+    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', {})));
 if (process.env['MAR_SCHEDULE_MCP_READ_ONLY'] !== '1') {
     server.registerTool('mar_create_scheduled_task', {
-        description: 'Create a MAR scheduled task for this MAR-managed Workspace conversation. MAR runs it in this conversation using the connected Node time zone.',
+        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: {
-            objective: z.string().min(1).max(20_000).describe('Prompt to run at each trigger.'),
+            objective: z.string().min(1).max(20_000).describe(objectiveDescription),
             cron: z
                 .string()
                 .min(9)
                 .max(64)
-                .describe('Five-field cron expression interpreted in the connected MAR Node time zone.')
+                .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', {
-        description: 'Update the MAR scheduled task for this MAR-managed Workspace conversation. Its cron expression uses the connected Node time zone.',
+        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: {
-            objective: z.string().min(1).max(20_000).describe('Replacement prompt.').optional(),
+            objective: z.string().min(1).max(20_000).describe(objectiveDescription).optional(),
             cron: z
                 .string()
                 .min(9)

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

@@ -30,11 +30,16 @@ export class SessionScheduleService {
         const session = await this.requireSession(input);
         const store = this.store();
         const task = store.get(session.externalSessionId ?? session.id);
+        const page = input.occurrencePage === undefined ? 1 : input.occurrencePage;
+        if (typeof page !== 'number' || !Number.isSafeInteger(page) || page < 1)
+            throw new Error('SCHEDULE_INVALID');
         return {
             task: task ?? null,
             nodeTimezone: nodeTimezone(),
             canResolveProposals: task !== undefined && input.__requestUserId === task.ownerUserId,
-            occurrences: task === undefined ? [] : store.recent(task.id),
+            ...(task === undefined
+                ? { occurrences: [], occurrenceTotal: 0, occurrencePage: 1 }
+                : store.recentPage(task.id, page)),
             proposals: task === undefined ? [] : store.pendingProposals(task.id)
         };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.144",
+  "version": "0.9.146",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -34,10 +34,10 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/marctl": "0.9.120",
-    "@myagentroam/agent": "0.9.144",
+    "@myagentroam/agent": "0.9.146",
     "@myagentroam/code-navigation": "0.9.129",
-    "@myagentroam/protocol": "0.9.144"
+    "@myagentroam/protocol": "0.9.146",
+    "@myagentroam/marctl": "0.9.120"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"