@myagentroam/node 0.9.157 → 0.9.159

package/dist/opencode-server.js

@@ -93,6 +93,10 @@ export class OpenCodeServerClient {
         const client = await this.requireClient();
         return unwrap(await client.session.list({ directory, limit }));
     }
+    async session(directory, sessionID) {
+        const client = await this.requireClient();
+        return unwrap(await client.session.get({ directory, sessionID }));
+    }
     async createSession(directory, title) {
         const client = await this.requireClient();
         return unwrap(await client.session.create({ directory, ...(title === undefined ? {} : { title }) }));
@@ -102,8 +106,15 @@ export class OpenCodeServerClient {
         return unwrap(await client.session.fork({ directory, sessionID, messageID }));
     }
     async messages(directory, sessionID, limit = 100) {
+        return (await this.messagePage(directory, sessionID, { limit })).messages;
+    }
+    async messagePage(directory, sessionID, input) {
         const client = await this.requireClient();
-        return unwrap(await client.session.messages({ directory, sessionID, limit }));
+        const result = await client.session.messages({ directory, sessionID, ...input });
+        return {
+            messages: unwrap(result),
+            nextCursor: result.response.headers.get('x-next-cursor') || null
+        };
     }
     async updateSession(directory, sessionID, title) {
         const client = await this.requireClient();

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

@@ -249,7 +249,6 @@ export class MarAgentManagedRunController {
                 if (controller.signal.aborted)
                     return;
                 controller.abort();
-                titleController.abort();
                 cancelExecution?.();
             },
             cancelTitle: () => titleController.abort()
@@ -434,7 +433,16 @@ export class MarAgentManagedRunController {
                         currentModelId: input.model.id,
                         prompt: input.input,
                         signal: titleController.signal
-                    }).catch(() => undefined);
+                    }).catch((error) => {
+                        if (!titleController.signal.aborted)
+                            nodeLog('runner.mar-agent.title.failed', {
+                                sessionId: session.id,
+                                runId: input.runId,
+                                stage: 'generate',
+                                code: runnerErrorProjection(error, 'MAR_AGENT_TITLE_GENERATION_FAILED').code
+                            });
+                        return undefined;
+                    });
                     runtime.automaticTitleTask = { cancel: () => titleController.abort(), result: titleTask };
                 }
                 this.project(input.runId, event);
@@ -448,7 +456,14 @@ export class MarAgentManagedRunController {
                     expectedTitle: metadata.title,
                     executionId: handle.executionId
                 })
-                    .catch(() => undefined);
+                    .catch((error) => {
+                    nodeLog('runner.mar-agent.title.failed', {
+                        sessionId: session.id,
+                        runId: input.runId,
+                        stage: 'persist',
+                        code: runnerErrorProjection(error, 'MAR_AGENT_TITLE_PERSIST_FAILED').code
+                    });
+                });
             await this.host.syncTitle(session.id, input.cwd);
             const status = result.status === 'completed'
                 ? 'SUCCEEDED'

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

@@ -1,4 +1,6 @@
 import { marAgentNodeModelSummarySchema, resolveMarAgentDefaultReasoningEffort } from '@myagentroam/protocol';
+import { nodeLog } from '../operational.js';
+import { runnerErrorProjection } from '../util/runner-error.js';
 import { MarAgentError, openMarAgentSessionCatalog } from '@myagentroam/agent';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
@@ -231,6 +233,7 @@ export class MarAgentRunner extends AbstractRunner {
                 const executionConfiguration = session.modelId === undefined
                     ? await activeCatalog.executionConfiguration(session.id)
                     : session;
+                const title = await marAgentSessionTitle(session, activeCatalog);
                 return [
                     {
                         ...context.createProjection({
@@ -238,8 +241,7 @@ export class MarAgentRunner extends AbstractRunner {
                             runner: this.name,
                             externalSessionId: session.id,
                             cwd: session.workspace,
-                            title: session.title,
-                            titleOrigin: 'NATIVE',
+                            ...title,
                             lastActivityAt: Date.parse(session.lastActivityAt)
                         }),
                         ...(executionConfiguration?.modelId === undefined
@@ -336,9 +338,9 @@ export class MarAgentRunner extends AbstractRunner {
             let cursor;
             do {
                 const page = await catalog.list({ limit: 200, ...(cursor ? { cursor } : {}) });
-                const title = page.sessions.find((candidate) => candidate.id === nativeSessionId)?.title;
-                if (title !== undefined)
-                    return title;
+                const summary = page.sessions.find((candidate) => candidate.id === nativeSessionId);
+                if (summary !== undefined)
+                    return (await marAgentSessionTitle(summary, catalog)).title;
                 cursor = page.nextCursor;
             } while (cursor !== undefined);
             return undefined;
@@ -456,6 +458,24 @@ export class MarAgentRunner extends AbstractRunner {
         }
     }
 }
+async function marAgentSessionTitle(session, catalog) {
+    const nativeTitle = session.title.trim();
+    if (nativeTitle.length === 0 || /^(?:new|untitled) session$/iu.test(nativeTitle)) {
+        try {
+            const preview = session.firstUserMessagePreview ?? (await catalog.firstUserMessagePreview(session.id));
+            if (preview)
+                return { title: preview, titleOrigin: 'PREVIEW' };
+        }
+        catch (error) {
+            nodeLog('runner.mar-agent.title.failed', {
+                sessionId: session.id,
+                stage: 'preview',
+                code: runnerErrorProjection(error, 'MAR_AGENT_TITLE_PREVIEW_FAILED').code
+            });
+        }
+    }
+    return { title: session.title, titleOrigin: 'NATIVE' };
+}
 function firstSequenceForTurn(entries, turnId) {
     return entries.find((entry) => entry.kind === 'user' ? entry.turnId === turnId : entry.event.turnId === turnId)?.sequence;
 }

package/dist/runner/opencode/conversation-parser.js

@@ -1,6 +1,32 @@
 import { boundedConversationItemId, compactRunnerText } from '../codex/conversation-parser.js';
 import { stripGoalStartPrompt } from '../../service/goal-runtime.js';
 import { normalizeOpenCodeTool } from './tool-normalizer.js';
+export function openCodeUserMessagePreview(messages) {
+    for (const message of messages) {
+        const entry = record(message);
+        const info = record(entry?.info);
+        if (info?.role !== 'user' || typeof info.id !== 'string')
+            continue;
+        const parts = array(entry?.parts);
+        if (parts.some((part) => record(part)?.type === 'compaction'))
+            continue;
+        const text = parts
+            .flatMap((part) => {
+            const value = record(part);
+            return value?.type === 'text' &&
+                value.synthetic !== true &&
+                value.ignored !== true &&
+                typeof value.text === 'string'
+                ? [value.text]
+                : [];
+        })
+            .join('\n');
+        const preview = stripGoalStartPrompt(text).trim().replace(/\s+/gu, ' ').slice(0, 160);
+        if (preview)
+            return preview;
+    }
+    return undefined;
+}
 export function openCodeConversationPage(session, messages, input, managedTurn) {
     const records = messages.flatMap((value) => {
         const entry = record(value);

package/dist/runner/opencode-runner.js

@@ -5,11 +5,14 @@ import { AbstractRunner } from './abstract-runner.js';
 import { isWithinWorkspace } from './codex/conversation-parser.js';
 import { createHash } from 'node:crypto';
 import { homedir } from 'node:os';
-import { openCodeConversationPage } from './opencode/conversation-parser.js';
+import { openCodeConversationPage, openCodeUserMessagePreview } from './opencode/conversation-parser.js';
 import { nodeLog } from '../operational.js';
+import { runnerErrorProjection } from '../util/runner-error.js';
 const PROFILE_ENTRY_TTL_MS = 30 * 60_000;
 const PROFILE_FAILURE_RETRY_MS = 30_000;
 const PROFILE_REFRESH_TIMEOUT_MS = 90_000;
+const TITLE_PREVIEW_TTL_MS = 60 * 60_000;
+const MAX_TITLE_PREVIEWS = 256;
 export class OpenCodeRunner extends AbstractRunner {
     client;
     clientFactory;
@@ -24,6 +27,7 @@ export class OpenCodeRunner extends AbstractRunner {
     profileGeneration = 0;
     execution = new Map();
     managedTurns = new Map();
+    titlePreviews = new Map();
     environmentClients = new Map();
     stoppingClients = new Set();
     constructor(client = new OpenCodeServerClient(), clientFactory = () => new OpenCodeServerClient()) {
@@ -198,19 +202,91 @@ export class OpenCodeRunner extends AbstractRunner {
                     session.parentId !== undefined ||
                     !isWithinWorkspace(session.directory, target.path))
                     continue;
+                const title = await this.sessionTitle(session);
                 result.push(context.createProjection({
                     workspace: target,
                     runner: this.name,
                     externalSessionId: session.id,
                     cwd: session.directory,
-                    title: session.title,
-                    titleOrigin: 'OFFICIAL',
+                    title: title.title,
+                    titleOrigin: title.titleOrigin,
                     lastActivityAt: session.updatedAt
                 }));
             }
         }
         return result;
     }
+    async readManagedRunnerTitle(session) {
+        if (session.externalSessionId === null)
+            return undefined;
+        const native = openCodeSession(await this.client.session(session.cwd, session.externalSessionId));
+        if (native === undefined ||
+            native.id !== session.externalSessionId ||
+            !isWithinWorkspace(native.directory, session.cwd))
+            return undefined;
+        return (await this.sessionTitle(native)).title;
+    }
+    async sessionTitle(session) {
+        const nativeTitle = session.title.trim();
+        if (nativeTitle.length === 0 ||
+            /^(?:new|untitled) session(?:\s*[-–—:]\s*\d{4}-\d{2}-\d{2}.*)?$/iu.test(nativeTitle)) {
+            try {
+                const preview = await this.firstUserMessagePreview(session);
+                if (preview)
+                    return { title: preview, titleOrigin: 'PREVIEW' };
+            }
+            catch (error) {
+                nodeLog('runner.opencode.title.failed', {
+                    sessionId: session.id,
+                    stage: 'preview',
+                    code: runnerErrorProjection(error, 'OPENCODE_TITLE_PREVIEW_FAILED').code
+                });
+            }
+        }
+        return { title: session.title, titleOrigin: 'OFFICIAL' };
+    }
+    async firstUserMessagePreview(session) {
+        const key = `${session.directory}\0${session.id}`;
+        const cached = this.titlePreviews.get(key);
+        if (cached !== undefined &&
+            cached.updatedAt === session.updatedAt &&
+            cached.expiresAt > Date.now())
+            return cached.result;
+        this.titlePreviews.delete(key);
+        if (this.titlePreviews.size >= MAX_TITLE_PREVIEWS)
+            this.titlePreviews.delete(this.titlePreviews.keys().next().value);
+        const entry = {
+            updatedAt: session.updatedAt,
+            expiresAt: Date.now() + TITLE_PREVIEW_TTL_MS,
+            result: (async () => {
+                let before;
+                let preview;
+                const cursors = new Set();
+                for (;;) {
+                    const page = await this.client.messagePage(session.directory, session.id, {
+                        limit: 100,
+                        ...(before === undefined ? {} : { before })
+                    });
+                    preview = openCodeUserMessagePreview(page.messages) ?? preview;
+                    if (page.nextCursor === null)
+                        return preview;
+                    if (cursors.has(page.nextCursor))
+                        throw new Error('OPENCODE_MESSAGE_CURSOR_INVALID');
+                    cursors.add(page.nextCursor);
+                    before = page.nextCursor;
+                }
+            })()
+        };
+        this.titlePreviews.set(key, entry);
+        try {
+            return await entry.result;
+        }
+        catch (error) {
+            if (this.titlePreviews.get(key) === entry)
+                this.titlePreviews.delete(key);
+            throw error;
+        }
+    }
     async resumeExternal(external, context) {
         if (external.runner !== this.name || external.externalSessionId === null || !context.available)
             return { failureCode: 'RUNNER_UNAVAILABLE' };
@@ -328,6 +404,7 @@ export class OpenCodeRunner extends AbstractRunner {
             execution.abort.abort();
         this.execution.clear();
         this.managedTurns.clear();
+        this.titlePreviews.clear();
         this.profileCache = undefined;
         this.profileRefresh = undefined;
         if (this.profileRefreshTimer !== undefined)

package/dist/runtime-state.js

@@ -268,14 +268,16 @@ export class NodeRuntimeState {
         });
     }
     /**
-     * Give a just-created managed Session a readable local title before the
-     * Runner has written its own transcript title. This intentionally never
-     * replaces a user rename or a Runner-provided title.
+     * Give a new or restored managed Session a readable local title while the
+     * Runner still has a placeholder. Never replace a user rename or a
+     * non-placeholder Runner title.
      */
     setTemporaryTitleIfMissing(id, title) {
         const current = this.requireSession(id);
         const value = title.trim().replace(/\s+/g, ' ').slice(0, 160);
-        if (value.length === 0 || current.customTitle !== null || current.runnerTitle !== null)
+        if (value.length === 0 ||
+            current.customTitle !== null ||
+            (current.runnerTitle !== null && !isDefaultRunnerTitle(current.runnerTitle)))
             return current;
         return this.replaceSession(id, { runnerTitle: value, titleSource: 'AUTO' });
     }

package/package.json

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