@myagentroam/node 0.11.33 → 0.11.35

package/dist/connector.js

@@ -914,6 +914,7 @@ export class NodeConnector {
             persist: (session, nativeSessionId) => {
                 this.database?.saveNativeSessionMetadata({
                     ...(session.parentSessionId == null ? {} : { parentSessionId: session.parentSessionId }),
+                    initializeParent: session.externalSessionId === null,
                     runner: session.runner,
                     externalSessionId: nativeSessionId,
                     workspaceId: session.workspaceId,

package/dist/database.js

@@ -315,7 +315,9 @@ export class NodeDatabase {
         const model = input.model === undefined ? (current?.model ?? null) : input.model;
         const effort = input.effort === undefined ? (current?.effort ?? null) : input.effort;
         const access = input.access === undefined ? (current?.access ?? null) : input.access;
-        const parentSessionId = current === undefined ? (input.parentSessionId ?? null) : (current.parentSessionId ?? null);
+        const parentSessionId = current === undefined || input.initializeParent === true
+            ? (current?.parentSessionId ?? input.parentSessionId ?? null)
+            : (current.parentSessionId ?? null);
         const metadata = JSON.stringify({
             version: 1,
             parentSessionId,

package/dist/marctl-guidance.js

@@ -5,7 +5,7 @@ export function hasMarctlContext(environment) {
         !!environment['MAR_CTL_NODE_ID'] &&
         !!environment['MAR_CTL_WORKSPACE_ID']);
 }
-export const marctlDescription = 'You are in a MAR-managed Workspace with marctl on PATH. Load this guide to create, coordinate, message or stop independent Sessions; inspect status/history/results; change titles, prompts or models; observe and decide approvals; manage Goals or scheduled tasks; or run commands/transfer files on other authorized MAR Nodes, even when marctl is not named. When creating an independent Session, prefer --runner mar-agent unless the user or applicable workflow specifies another Runner. Ordinary local shell work and built-in subagents alone do not require it.';
+export const marctlDescription = 'You are in a MAR-managed Workspace with marctl on PATH. Load this guide to create, coordinate, message or stop independent Sessions; inspect status/history/results; change titles, prompts or models; observe and decide approvals; manage Goals or scheduled tasks for the current or other Sessions; or run commands/transfer files on other authorized MAR Nodes, even when marctl is not named. When creating an independent Session, prefer --runner mar-agent unless the user or applicable workflow specifies another Runner. Ordinary local shell work and built-in subagents alone do not require it.';
 export const marctlInstructions = [
     '## MAR Workspace CLI',
     'Use your native shell tool to run marctl. Reuse loaded guidance while it remains in context. Consult local marctl help sessions for unclear options (shared by all Session subcommands) and marctl --version when version matters; neither needs a network request. Capabilities and permissions still apply.',
@@ -22,7 +22,7 @@ export const marctlInstructions = [
     'show/config/history/graph/rename, prompt 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/approval always require explicit target IDs.',
     'Use sessions schedule list/get/create/update for the same tasks as the built-in schedule MCP, which remains available in other Runners and is hidden in MAR Agent while its marctl 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. get returns task (null if absent), with id, revision, objective, cron, timezone and enabled; applied updates also return task. Reuse that task instead of probing its shape or refetching unchanged state. Schedule text is trimmed at both ends; compare after the same trimming; a conclusive update response needs no extra get. Other-owner edits return a PENDING proposal, not an applied change. Scheduled execution uses normal user permissions. 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 without interrupting active execution. New input resumes a paused queue using ordinary send admission after cancellation settles; later explicit stops still apply; 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 returns only queuedCount.',
+    'Use sessions send <session-id> --steer -m "Additional context: focus on the resume path." --json for time-sensitive, decision-changing updates rather than routine reports: it prioritizes the update and 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 without interrupting active execution; during normal active work it waits for the current execution and earlier queued work, and can be delayed by an active Goal. Do not use it when the recipient needs the information during current work. New input resumes a paused queue using ordinary send admission after cancellation settles; later explicit stops still apply; 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 returns only queuedCount.',
     '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 your shell tool returns a running process or cell, reuse its process/cell handle rather than starting another wait or polling show/list. A timeout may include progress, the last observed snapshot, not a fresh query. 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.',
     'Use wait --until approval to return early when a Run needs a decision. Inspect show/history, then use sessions approval decide <session-id> --run <public-run-id> --approval <approval-id> --decision approve|reject --json for one explicitly authorized request. This does not grant authority or auto-approve tools. Acknowledgment is not completion; observe status/history and wait again as needed.',
     '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.',

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

@@ -1,4 +1,4 @@
-import { buildCompactEvidence, countModelTokens, generateModelText, MarAgentError } from '@myagentroam/agent';
+import { buildCompactEvidence, countModelTokens, generateModelText, AgentError } from '@myagentroam/agent';
 import { highDensityCompactionPrompt } from './compact-prompt.js';
 import { marAgentRuntimeCompactConfigurationSchema } from '@myagentroam/protocol';
 /** Resolve optional dedicated credentials in the same factory batch without widening the SDK catalog. */
@@ -141,7 +141,7 @@ export async function generateMarAgentCompact(context, selected, signal) {
     }
     catch (error) {
         signal.throwIfAborted();
-        if (error instanceof MarAgentError) {
+        if (error instanceof AgentError) {
             const status = error.details?.status;
             failure = {
                 ...failure,
@@ -150,7 +150,7 @@ export async function generateMarAgentCompact(context, selected, signal) {
                 ...(typeof error.details?.reason === 'string' ? { errorReason: error.details.reason } : {})
             };
         }
-        await report('FAILED', 'MODEL_FAILED', error instanceof MarAgentError
+        await report('FAILED', 'MODEL_FAILED', error instanceof AgentError
             ? error.code
             : (failure.errorCode ?? 'MAR_AGENT_COMPACT_MODEL_FAILED'));
         return undefined;

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

@@ -1,9 +1,9 @@
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 /** Composes Node-owned tools without replacing another domain's execution handler. */
 export function combineExecutionExtensions(...sources) {
     const tools = sources.flatMap((source) => source.tools ?? []);
     if (new Set(tools.map((tool) => tool.name)).size !== tools.length)
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Host tool names conflict.');
+        throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Host tool names conflict.');
     return {
         tools,
         skills: sources.flatMap((source) => source.skills ?? []),
@@ -14,7 +14,7 @@ export function combineExecutionExtensions(...sources) {
         executeTool: async (call, context) => {
             const source = sources.find((source) => source.tools?.some((tool) => tool.name === call.name));
             if (!source?.executeTool)
-                throw new MarAgentError('MAR_AGENT_TOOL_NOT_AVAILABLE', 'Host tool is unavailable.');
+                throw new AgentError('MAR_AGENT_TOOL_NOT_AVAILABLE', 'Host tool is unavailable.');
             return source.executeTool(call, context);
         }
     };

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

@@ -1,5 +1,6 @@
 import { createHash } from 'node:crypto';
-import { LocalAgentHost, MarAgentError, createMarAgent, generateSessionTitle, openMarAgentSessionCatalog } from '@myagentroam/agent';
+import { LocalAgentHost } from '@myagentroam/agent/host';
+import { AgentError, createAgent, generateSessionTitle, openAgentSessionCatalog } from '@myagentroam/agent';
 import { projectMarAgentHistory } from './history-projection.js';
 import { MarAgentConversationNormalizer } from './conversation-normalizer.js';
 import { hostedConversationGeneratedImagesDisplayDirectory, hostedConversationImageRunId, marAgentGeneratedImageSources, marAgentGeneratedImagesDirectory } from './generated-images.js';
@@ -28,10 +29,10 @@ export class MarAgentHostedConversationRuntime {
     #registerNativeImages;
     constructor(options = {}) {
         this.#publishModelResource = options.publishModelResource;
-        this.#createAgent = options.createAgent ?? createMarAgent;
+        this.#createAgent = options.createAgent ?? createAgent;
         this.#generateTitle = options.generateTitle ?? generateSessionTitle;
         this.#createHost = options.createHost ?? ((input) => new LocalAgentHost(input));
-        this.#openCatalog = options.openCatalog ?? openMarAgentSessionCatalog;
+        this.#openCatalog = options.openCatalog ?? openAgentSessionCatalog;
         this.#now = options.now ?? Date.now;
         this.#onEvent = options.onEvent;
         this.#webSearch = options.webSearch;
@@ -120,7 +121,7 @@ export class MarAgentHostedConversationRuntime {
             return { lastActivityAt: Date.parse(rolledBack.lastActivityAt) };
         }
         catch (error) {
-            if (error instanceof MarAgentError)
+            if (error instanceof AgentError)
                 throw new Error(error.code, { cause: error });
             throw error;
         }
@@ -383,7 +384,7 @@ export class MarAgentHostedConversationRuntime {
                 mode: 'node',
                 host,
                 models: sdkModelConfigurations(models.filter((model) => input.models.some((candidate) => candidate.id === model.id))),
-                runtimeExtensions: marAgentCompactExtensionSource(compactState),
+                extensions: marAgentCompactExtensionSource(compactState),
                 defaultModelId: 'defaultModelId' in input ? input.defaultModelId : input.modelId,
                 workspaceMapping: {
                     logicalPath: '/workspace',

package/dist/runner/mar-agent/image-generation-extensions.js

@@ -1,5 +1,5 @@
 import { dirname } from 'node:path';
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { codexImageGenToolDefinition, bytedArkImageGenToolDefinition, executeCodexImageGen } from './image-generation.js';
 import { marAgentGeneratedImagesDirectory } from './generated-images.js';
 import { normalizeGeneratedImageDisplayDirectory, validateImageGenerationConfiguration } from './image-generation-validation.js';
@@ -11,7 +11,7 @@ export function createImageGenerationExtensions(input) {
     const displayDirectory = normalizeGeneratedImageDisplayDirectory(input.displayDirectory);
     const codex = imageGeneration.provider === 'CODEX';
     if (!codex && imageGeneration.provider !== 'BYTED_ARK')
-        throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Unsupported image provider.');
+        throw new AgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Unsupported image provider.');
     const tool = codex ? codexImageGenToolDefinition : bytedArkImageGenToolDefinition;
     return {
         tools: [tool],
@@ -29,11 +29,11 @@ export function createImageGenerationExtensions(input) {
         ],
         executeTool: async (call, context) => {
             if (call.name !== tool.name)
-                throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Image tool is unavailable.');
+                throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Image tool is unavailable.');
             context.signal.throwIfAborted();
             const directory = marAgentGeneratedImagesDirectory(input.homeDirectory, context.sessionId);
             if (directory === undefined || call.callId === undefined)
-                throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Image execution identity is invalid.');
+                throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Image execution identity is invalid.');
             return executeCodexImageGen(call.arguments, {
                 configuration: { imageGeneration },
                 sessionDirectory: dirname(directory),
@@ -47,10 +47,10 @@ export function createImageGenerationExtensions(input) {
                         .executeTool({ name: 'view_image', arguments: { path } }, context);
                     const image = output.images?.length === 1 ? output.images[0] : undefined;
                     if (image === undefined || image.dataBase64 === undefined)
-                        throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_INVALID', 'Referenced image result is invalid.');
+                        throw new AgentError('MAR_AGENT_TOOL_OUTPUT_INVALID', 'Referenced image result is invalid.');
                     const data = Buffer.from(image.dataBase64, 'base64');
                     if (data.byteLength === 0)
-                        throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_INVALID', 'Referenced image result is invalid.');
+                        throw new AgentError('MAR_AGENT_TOOL_OUTPUT_INVALID', 'Referenced image result is invalid.');
                     return { mimeType: image.mimeType, data };
                 }
             });

package/dist/runner/mar-agent/image-generation-validation.js

@@ -1,5 +1,5 @@
 import { posix } from 'node:path';
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 export function validateImageGenerationConfiguration(configuration) {
     const imageGeneration = configuration.imageGeneration;
     if (imageGeneration === undefined)
@@ -32,7 +32,7 @@ export function normalizeGeneratedImageDisplayDirectory(value) {
         normalized === '/' ||
         normalized.length > 4096 ||
         normalized.includes('\0'))
-        throw new MarAgentError('MAR_AGENT_HOST_INCOMPATIBLE', 'Generated image display directory is invalid.');
+        throw new AgentError('MAR_AGENT_HOST_INCOMPATIBLE', 'Generated image display directory is invalid.');
     return normalized;
 }
 function isAllowedImageGenerationEndpoint(endpoint) {
@@ -46,5 +46,5 @@ function isAllowedImageGenerationEndpoint(endpoint) {
         (endpoint.protocol === 'https:' || (endpoint.protocol === 'http:' && loopback)));
 }
 function invalidImageGenerationConfiguration() {
-    throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Model image generation configuration is invalid.');
+    throw new AgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Model image generation configuration is invalid.');
 }

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

@@ -1,7 +1,7 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
 import { basename, isAbsolute, join, posix } from 'node:path';
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { requestHttp, acquireCredential, appendCredentialHeaders } from '@myagentroam/agent/host/network';
 const IMAGE_MAX_BYTES = 20_971_520;
 const RESPONSE_MAX_BYTES = Math.ceil((IMAGE_MAX_BYTES * 4) / 3) + 4096;
@@ -59,12 +59,12 @@ export async function executeCodexImageGen(arguments_, input) {
     input.signal.throwIfAborted();
     const capability = input.configuration.imageGeneration;
     if (capability === undefined || capability.credentialProvider === undefined)
-        throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Image generation requires an independent credential provider.');
+        throw new AgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Image generation requires an independent credential provider.');
     const request = parseInput(arguments_);
     const images = await selectedEditImages(request, input);
     const ark = capability.provider === 'BYTED_ARK';
     if (!ark && capability.provider !== 'CODEX')
-        throw new MarAgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Unsupported image provider.');
+        throw new AgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Unsupported image provider.');
     const endpoint = images.length === 0 ? capability.generateEndpoint : capability.editEndpoint;
     const body = JSON.stringify(ark
         ? {
@@ -168,7 +168,7 @@ export async function executeCodexImageGen(arguments_, input) {
             ]
         };
     }
-    throw new MarAgentError('MAR_AGENT_IMAGE_GENERATION_FAILED', 'Image generation failed.');
+    throw new AgentError('MAR_AGENT_IMAGE_GENERATION_FAILED', 'Image generation failed.');
 }
 function parseInput(value) {
     if (value === null || typeof value !== 'object' || Array.isArray(value))
@@ -211,7 +211,7 @@ async function selectedEditImages(request, input) {
         return [];
     const images = input.recentImages.slice(-request.numLastImagesToInclude);
     if (images.length !== request.numLastImagesToInclude)
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', `Requested the last ${request.numLastImagesToInclude} conversation images, but only ${images.length} were available.`);
+        throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', `Requested the last ${request.numLastImagesToInclude} conversation images, but only ${images.length} were available.`);
     return images.map(validateEditImage);
 }
 function validateEditImage(image) {
@@ -219,14 +219,14 @@ function validateEditImage(image) {
         !Buffer.isBuffer(image.data) ||
         image.data.byteLength === 0 ||
         image.data.byteLength > IMAGE_MAX_BYTES)
-        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Referenced image is invalid or unsupported.');
+        throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Referenced image is invalid or unsupported.');
     return { mimeType: image.mimeType, data: Buffer.from(image.data) };
 }
 async function readJsonResponse(response, signal) {
     const contentLength = Number(response.headers.get('content-length'));
     if (Number.isFinite(contentLength) && contentLength > RESPONSE_MAX_BYTES) {
         await response.body?.cancel().catch(() => undefined);
-        throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', 'Image response exceeded the size limit.');
+        throw new AgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', 'Image response exceeded the size limit.');
     }
     if (response.body === null)
         return {};
@@ -238,7 +238,7 @@ async function readJsonResponse(response, signal) {
     };
     readSignal.addEventListener('abort', abort, { once: true });
     const onIdle = () => {
-        readController.abort(new MarAgentError('MAR_AGENT_IMAGE_GENERATION_READ_TIMEOUT', 'Image response body read timed out waiting for data.', {
+        readController.abort(new AgentError('MAR_AGENT_IMAGE_GENERATION_READ_TIMEOUT', 'Image response body read timed out waiting for data.', {
             details: {
                 reason: 'IMAGE_RESPONSE_READ_TIMEOUT',
                 idleTimeoutMs: IMAGE_GENERATION_READ_IDLE_TIMEOUT_MS
@@ -261,7 +261,7 @@ async function readJsonResponse(response, signal) {
             readTimeout = setTimeout(onIdle, IMAGE_GENERATION_READ_IDLE_TIMEOUT_MS);
             bytes += chunk.value.byteLength;
             if (bytes > RESPONSE_MAX_BYTES)
-                throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', 'Image response exceeded the size limit.');
+                throw new AgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', 'Image response exceeded the size limit.');
             chunks.push(chunk.value);
         }
     }
@@ -278,7 +278,7 @@ async function readJsonResponse(response, signal) {
         return JSON.parse(Buffer.concat(chunks, bytes).toString('utf8'));
     }
     catch (cause) {
-        throw new MarAgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.', { cause });
+        throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.', { cause });
     }
 }
 async function waitForImageStep(operation, signal) {
@@ -307,18 +307,18 @@ function imageBase64(value) {
         ? data[0].b64_json
         : undefined;
     if (typeof first !== 'string' || first.length === 0 || first.length > RESPONSE_MAX_BYTES)
-        throw new MarAgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.');
+        throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.');
     return first;
 }
 function decodePng(encoded) {
     if (encoded.length % 4 !== 0 || !/^[A-Za-z0-9+/]+={0,2}$/u.test(encoded))
-        throw new MarAgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.');
+        throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.');
     const data = Buffer.from(encoded, 'base64');
     if (data.byteLength === 0 ||
         data.byteLength > IMAGE_MAX_BYTES ||
         data.toString('base64') !== encoded ||
         !data.subarray(0, PNG_SIGNATURE.length).equals(PNG_SIGNATURE))
-        throw new MarAgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is not a supported PNG.');
+        throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is not a supported PNG.');
     return data;
 }
 function generatedFileName(callId) {
@@ -349,8 +349,8 @@ function imageGenerationResponseError(status, value) {
         !/\b(?:authorization|bearer|api[_ -]?key|access[_ -]?token|refresh[_ -]?token|password|secret|proxy-authorization|chatgpt-account-id)\b|socks5:\/\//iu.test(rawMessage)
         ? rawMessage
         : fallbackMessage;
-    return new MarAgentError(code, message, { details: { status } });
+    return new AgentError(code, message, { details: { status } });
 }
 function invalidInput() {
-    throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Image generation input is invalid.');
+    throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Image generation input is invalid.');
 }

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

@@ -6,7 +6,7 @@ import { marctlExecutionEnvironment, marctlHostSkill } from './marctl-skill.js';
 import { createHash, randomUUID } from 'node:crypto';
 import { homedir } from 'node:os';
 import { nodeLog } from '../../operational.js';
-import { createMarAgent, generateSessionTitle } from '@myagentroam/agent';
+import { createAgent, generateSessionTitle } from '@myagentroam/agent';
 import { marAgentReasoningEffortSchema, resolveMarAgentDefaultReasoningEffort } from '@myagentroam/protocol';
 import { boundedConversationItemId } from '../../util/node-operation-parsers.js';
 import { parseSecretEnvironment } from '../../util/secret-environment.js';
@@ -43,7 +43,7 @@ export class MarAgentManagedRunController {
             ...(options.retainEnvironment === undefined
                 ? {}
                 : { retainEnvironment: options.retainEnvironment }),
-            createAgent: options.createAgent ?? createMarAgent,
+            createAgent: options.createAgent ?? createAgent,
             modelFactory: options.modelFactory ??
                 new MarAgentRuntimeModelFactory({
                     resolve: async () => {

package/dist/runner/mar-agent/mcp-client-pool.js

@@ -4,7 +4,8 @@ import { Client } from '@modelcontextprotocol/sdk/client/index.js';
 import { getDefaultEnvironment, StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
 import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
 import { ToolListChangedNotificationSchema } from '@modelcontextprotocol/sdk/types.js';
-import { assertMcpToolDefinition, assertMcpToolCatalog, MarAgentError } from '@myagentroam/agent';
+import { assertMcpToolDefinition, assertMcpToolCatalog } from '@myagentroam/agent/host';
+import { AgentError } from '@myagentroam/agent';
 import { canonicalJson } from '../../util/canonical-json.js';
 import { ExecutorStdioClientTransport } from './executor-stdio-client-transport.js';
 export class MarAgentMcpClientCache {
@@ -175,11 +176,11 @@ export class MarAgentMcpClientPool {
     async call(name, arguments_, signal, expectedTool) {
         const binding = this.#tools.get(name);
         if (!binding || this.#closed)
-            throw new MarAgentError('MAR_AGENT_MCP_TOOL_NOT_FOUND', 'MCP tool is no longer available.');
+            throw new AgentError('MAR_AGENT_MCP_TOOL_NOT_FOUND', 'MCP tool is no longer available.');
         if (expectedTool &&
             (binding.metadata.sourceIdentity !== expectedTool.sourceIdentity ||
                 binding.metadata.definitionRevision !== expectedTool.definitionRevision))
-            throw new MarAgentError('MAR_AGENT_MCP_TOOL_DEFINITION_CHANGED', 'MCP tool binding or definition changed.');
+            throw new AgentError('MAR_AGENT_MCP_TOOL_DEFINITION_CHANGED', 'MCP tool binding or definition changed.');
         signal?.throwIfAborted();
         const result = await binding.client.callTool({
             name: binding.nativeName,

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

@@ -1,4 +1,4 @@
-import { MarAgentError, SecretValue } from '@myagentroam/agent';
+import { AgentError, SecretValue } from '@myagentroam/agent';
 import { marAgentRuntimeModelConfigurationSchema, resolveMarAgentDefaultReasoningEffort } from '@myagentroam/protocol';
 export function sdkModelConfigurations(models) {
     return models.map(({ imageGeneration: _imageGeneration, ...model }) => model);
@@ -84,6 +84,9 @@ export class MarAgentRuntimeModelFactory {
                             responsesOptionalParameters: configuration.responsesOptionalParameters
                         }),
                     responsesPreviousResponseId: configuration.responsesPreviousResponseId,
+                    ...(configuration.responsesConfigurationUpdates === undefined
+                        ? {}
+                        : { responsesConfigurationUpdates: configuration.responsesConfigurationUpdates }),
                     enabled: configuration.enabled
                 };
                 const { apiKey, credential } = configuration;
@@ -95,11 +98,11 @@ export class MarAgentRuntimeModelFactory {
                         apiKey: new SecretValue(credential.value)
                     };
                 if (credential?.type !== 'RUNTIME_TICKET')
-                    throw new MarAgentError('MAR_AGENT_RUNTIME_MODEL_CREDENTIAL_INVALID', 'The runtime model credential is invalid.');
+                    throw new AgentError('MAR_AGENT_RUNTIME_MODEL_CREDENTIAL_INVALID', 'The runtime model credential is invalid.');
                 if (context.runtimeScopeId === undefined ||
                     context.runtimeScopeId !== credential.ticket.runtimeScopeId ||
                     !credential.ticket.allowedModelIds.includes(configuration.id))
-                    throw new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_SCOPE_INVALID', 'The runtime credential does not authorize this execution or model.');
+                    throw new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_SCOPE_INVALID', 'The runtime credential does not authorize this execution or model.');
                 const provider = runtimeProvider(credential, configuration.id, context, tickets, providers, this.control, this.now);
                 return {
                     ...model,
@@ -117,7 +120,6 @@ export class MarAgentRuntimeModelFactory {
                             }
                         }
                         : {}),
-                    responsesConfigurationUpdates: configuration.responsesConfigurationUpdates === true,
                     credentialProvider: provider
                 };
             });
@@ -141,7 +143,7 @@ function runtimeProvider(credential, consumerId, context, tickets, providers, co
     if (context.runtimeScopeId === undefined ||
         context.runtimeScopeId !== credential.ticket.runtimeScopeId ||
         !credential.ticket.allowedModelIds.includes(consumerId))
-        throw new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_SCOPE_INVALID', 'The runtime credential does not authorize this execution or model.');
+        throw new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_SCOPE_INVALID', 'The runtime credential does not authorize this execution or model.');
     const key = `${credential.credentialId}\0${credential.ticket.runtimeScopeId}\0${credential.ticket.purpose ?? 'MODEL'}`;
     let state = tickets.get(key);
     if (state === undefined) {
@@ -153,7 +155,7 @@ function runtimeProvider(credential, consumerId, context, tickets, providers, co
         tickets.set(key, state);
     }
     else if (!sameRuntimeCredentialTicket(state.ticket, credential.ticket))
-        throw new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_SCOPE_INVALID', 'The runtime credential does not authorize this execution or model.');
+        throw new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_SCOPE_INVALID', 'The runtime credential does not authorize this execution or model.');
     const provider = new ServerRuntimeCredentialProvider(control, state, consumerId, context.runtimeScopeId, context.executionId, now);
     providers.push(provider);
     return provider;
@@ -179,7 +181,7 @@ class ServerRuntimeCredentialProvider {
     }
     async acquire(reason) {
         if (this.#closed || this.state.released)
-            throw new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.');
+            throw new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.');
         if (isReusableCredential(this.state.credential, this.now())) {
             if (isWithinRefreshWindow(this.state.ticket.expiresAt, this.now()))
                 this.refreshAutomatically();
@@ -264,9 +266,9 @@ class ServerRuntimeCredentialProvider {
             reason
         }, signal);
         if (this.state.released)
-            throw new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.');
+            throw new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.');
         if ('error' in response)
-            throw new MarAgentError(response.error.code, response.error.message);
+            throw new AgentError(response.error.code, response.error.message);
         this.state.ticket = response.nextTicket;
         const credential = {
             revision: response.credential.revision,
@@ -333,11 +335,11 @@ function clearRefreshTimer(state) {
 }
 function waitForCredential(pending, signal) {
     if (signal.aborted)
-        return Promise.reject(new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.'));
+        return Promise.reject(new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.'));
     return new Promise((resolve, reject) => {
         const abort = () => {
             cleanup();
-            reject(new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.'));
+            reject(new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.'));
         };
         const cleanup = () => signal.removeEventListener('abort', abort);
         signal.addEventListener('abort', abort, { once: true });

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

@@ -1,7 +1,7 @@
 import { createHash, randomUUID } from 'node:crypto';
 import { homedir } from 'node:os';
 import { access, constants } from 'node:fs/promises';
-import { LocalAgentHost } from '@myagentroam/agent';
+import { LocalAgentHost } from '@myagentroam/agent/host';
 import { marAgentRuntimeCompactConfigurationSchema } from '@myagentroam/protocol';
 import { nodeExecutionEnvironment } from '../../node-execution-environment.js';
 import { nodeLog } from '../../operational.js';
@@ -73,7 +73,7 @@ export async function createSessionRuntime(input, sessionKey, fingerprint, hostC
             host: localHost,
             models: sdkModelConfigurations(models.filter((model) => input.models.some((candidate) => candidate.id === model.id))),
             defaultModelId: input.model.id,
-            runtimeExtensions: marAgentCompactExtensionSource(compactState),
+            extensions: marAgentCompactExtensionSource(compactState),
             ...(input.personalInstructions ? { systemInstruction: input.personalInstructions } : {})
         });
         const customTitle = dependencies.customTitle(input.sessionId) ?? undefined;

package/dist/runner/mar-agent/web-tools-extensions.js

@@ -1,4 +1,4 @@
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { WEB_FETCH_MAX_URL_LENGTH, webFetchRequestSchema, webSearchRequestSchema } from '../../service/web-fetch-contracts.js';
 export const webSearchToolDefinition = {
     name: 'web_search',
@@ -49,13 +49,13 @@ export function createWebToolsExtensions(input) {
         isToolAvailable,
         executeTool: async (call, context) => {
             if (!isToolAvailable(call.name, context))
-                throw new MarAgentError('MAR_AGENT_TOOL_NOT_AVAILABLE', 'Node web tool is unavailable.');
+                throw new AgentError('MAR_AGENT_TOOL_NOT_AVAILABLE', 'Node web tool is unavailable.');
             context.signal.throwIfAborted();
             const parsed = call.name === 'web_search'
                 ? webSearchRequestSchema.safeParse(call.arguments)
                 : webFetchRequestSchema.safeParse(call.arguments);
             if (!parsed.success)
-                throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Node web tool input is invalid.');
+                throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Node web tool input is invalid.');
             try {
                 if (call.name === 'web_search')
                     return await input.webSearch(webSearchRequestSchema.parse(parsed.data), context.signal);
@@ -63,9 +63,9 @@ export function createWebToolsExtensions(input) {
                 return await input.webFetch({ ...request, url: new URL(request.url).href }, context.signal);
             }
             catch (error) {
-                if (context.signal.aborted || error instanceof MarAgentError)
+                if (context.signal.aborted || error instanceof AgentError)
                     throw error;
-                throw new MarAgentError(call.name === 'web_search' ? 'MAR_AGENT_WEB_SEARCH_FAILED' : 'MAR_AGENT_WEB_FETCH_FAILED', call.name === 'web_search' ? 'Web search failed.' : 'Web fetch failed.', { cause: error });
+                throw new AgentError(call.name === 'web_search' ? 'MAR_AGENT_WEB_SEARCH_FAILED' : 'MAR_AGENT_WEB_FETCH_FAILED', call.name === 'web_search' ? 'Web search failed.' : 'Web fetch failed.', { cause: error });
             }
         }
     };

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

@@ -1,7 +1,7 @@
 import { marAgentNodeModelSummarySchema, parseComposerTags, resolveMarAgentDefaultReasoningEffort, serializeComposerTag } from '@myagentroam/protocol';
 import { nodeLog } from '../operational.js';
 import { runnerErrorProjection } from '../util/runner-error.js';
-import { MarAgentError, openMarAgentSessionCatalog } from '@myagentroam/agent';
+import { AgentError, openAgentSessionCatalog } from '@myagentroam/agent';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
 import { AbstractRunner } from './abstract-runner.js';
@@ -94,7 +94,7 @@ export class MarAgentRunner extends AbstractRunner {
     async readToolResultResource(session, input) {
         if (!session.externalSessionId)
             throw new Error('SESSION_NOT_FOUND');
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             return await catalog.readToolResultResource(session.externalSessionId, {
                 resourceRef: input.resourceRef,
@@ -268,7 +268,7 @@ export class MarAgentRunner extends AbstractRunner {
     async discoverSessions(context, workspace) {
         let catalog;
         try {
-            catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+            catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
             const activeCatalog = catalog;
             const listed = await activeCatalog.list({ limit: 200 });
             if (context.cleanup) {
@@ -336,13 +336,13 @@ export class MarAgentRunner extends AbstractRunner {
     async forkNative(session, boundary, title) {
         if (session.externalSessionId === null)
             throw new Error('SESSION_REWIND_UNAVAILABLE');
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             return (await catalog.fork(session.externalSessionId, { boundaryTurnId: boundary, title }))
                 .id;
         }
         catch (error) {
-            if (error instanceof MarAgentError)
+            if (error instanceof AgentError)
                 throw new Error(error.code, { cause: error });
             throw error;
         }
@@ -354,7 +354,7 @@ export class MarAgentRunner extends AbstractRunner {
         if (session.externalSessionId === null)
             throw new Error('SESSION_ROLLBACK_UNAVAILABLE');
         await this.#releaseSessionResources?.(session.externalSessionId);
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             if (targetClientMessageId !== undefined && targetTurnBoundary === undefined)
                 throw new Error('SESSION_ROLLBACK_TARGET_INVALID');
@@ -366,7 +366,7 @@ export class MarAgentRunner extends AbstractRunner {
             return Date.parse(rolledBack.lastActivityAt);
         }
         catch (error) {
-            if (error instanceof MarAgentError)
+            if (error instanceof AgentError)
                 throw new Error(error.code, { cause: error });
             throw error;
         }
@@ -381,12 +381,12 @@ export class MarAgentRunner extends AbstractRunner {
         if (session.externalSessionId === null)
             throw new Error('SESSION_CLEAR_UNAVAILABLE');
         await this.#releaseSessionResources?.(session.externalSessionId);
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             return Date.parse((await catalog.clear(session.externalSessionId)).lastActivityAt);
         }
         catch (error) {
-            if (error instanceof MarAgentError)
+            if (error instanceof AgentError)
                 throw new Error(error.code, { cause: error });
             throw error;
         }
@@ -398,7 +398,7 @@ export class MarAgentRunner extends AbstractRunner {
         if (session.runner !== this.name || session.externalSessionId !== nativeSessionId)
             return false;
         await this.#releaseSessionResources?.(nativeSessionId);
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             return (await catalog.delete(nativeSessionId)).deleted ? true : 'MISSING';
         }
@@ -409,7 +409,7 @@ export class MarAgentRunner extends AbstractRunner {
     async readManagedRunnerTitle(session, nativeSessionId) {
         if (session.runner !== this.name || session.externalSessionId !== nativeSessionId)
             return undefined;
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             let cursor;
             do {
@@ -426,7 +426,7 @@ export class MarAgentRunner extends AbstractRunner {
         }
     }
     async restartInputState(sessionId, clientMessageId) {
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             let cursor;
             const states = new Map();
@@ -460,7 +460,7 @@ export class MarAgentRunner extends AbstractRunner {
     async readOfficialConversation(session, input) {
         if (session.externalSessionId === null)
             return undefined;
-        const catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+        const catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
         try {
             const limit = input.limit ?? 10;
             let cursor = input.cursor;
@@ -524,7 +524,7 @@ export class MarAgentRunner extends AbstractRunner {
             return undefined;
         let catalog;
         try {
-            catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+            catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
             const usage = await catalog.contextUsage(session.externalSessionId);
             return usage === undefined
                 ? undefined
@@ -545,7 +545,7 @@ export class MarAgentRunner extends AbstractRunner {
     async #readInputImage(sessionId, sequence, imageIndex, expected) {
         let catalog;
         try {
-            catalog = await openMarAgentSessionCatalog({ homeDirectory: this.homeDirectory });
+            catalog = await openAgentSessionCatalog({ homeDirectory: this.homeDirectory });
             const image = await catalog.readImage(sessionId, { sequence, imageIndex });
             if (image === undefined ||
                 image.name !== expected.name ||

package/dist/service/hosted-conversation-sandbox-profile.js

@@ -1,11 +1,11 @@
 import { LINUX_BUBBLEWRAP_SANDBOX_POLICY_VERSION } from '@myagentroam/agent/sandbox/linux';
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { posix } from 'node:path';
 /** Compiles Node-owned hosted-conversation directories into the generic Agent sandbox profile. */
 export function hostedConversationSandboxProfile(input) {
     if ((input.generatedImagesDirectory === undefined) !==
         (input.generatedImagesLogicalPath === undefined))
-        throw new MarAgentError('SANDBOX_POLICY_INVALID', 'Sandbox policy is invalid.');
+        throw new AgentError('SANDBOX_POLICY_INVALID', 'Sandbox policy is invalid.');
     const mounts = [
         {
             source: input.workspaceDirectory,

package/dist/service/mar-agent-model-transport-test-service.js

@@ -1,4 +1,4 @@
-import { testMarAgentModelTransport } from '@myagentroam/agent';
+import { testAgentModelTransport } from '@myagentroam/agent';
 import { marAgentModelTransportTestInputSchema, marAgentModelTransportTestResultSchema } from '@myagentroam/protocol';
 import { runnerErrorProjection } from '../util/runner-error.js';
 export class MarAgentModelTransportTestService {
@@ -24,7 +24,7 @@ export class MarAgentModelTransportTestService {
         if (configuration === undefined)
             throw new Error('MAR_AGENT_MODEL_TEST_INPUT_INVALID');
         try {
-            const completed = await (this.options.testTransport ?? testMarAgentModelTransport)(configuration, AbortSignal.timeout(this.#timeoutMs));
+            const { completed } = await (this.options.testTransport ?? testAgentModelTransport)(configuration, AbortSignal.timeout(this.#timeoutMs));
             return marAgentModelTransportTestResultSchema.parse(completed
                 ? { success: true, code: null, message: null, httpStatus: null }
                 : {

package/dist/service/model-resource-publication-service.js

@@ -1,7 +1,7 @@
 import { createHash, createHmac, randomBytes, randomUUID, timingSafeEqual } from 'node:crypto';
 import { mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { MarAgentError, openMarAgentSessionCatalog } from '@myagentroam/agent';
+import { AgentError, openAgentSessionCatalog } from '@myagentroam/agent';
 import { modelResourceReadInputSchema } from '@myagentroam/protocol';
 const TTL_MS = 24 * 60 * 60_000;
 /** Only capability metadata lives here. The SDK owns the sole immutable image file. */
@@ -88,14 +88,14 @@ export class ModelResourcePublicationService {
             record.expiresAt !== input.expiresAt ||
             this.identity(record.source, record.resourceId) !== this.identity(source, input.resourceId))
             return undefined;
-        const catalog = await openMarAgentSessionCatalog({
+        const catalog = await openAgentSessionCatalog({
             homeDirectory: record.source.homeDirectory
         });
         try {
             return await catalog.readResource(record.source.sessionId, record.resourceId);
         }
         catch (error) {
-            if (error instanceof MarAgentError && error.code === 'MAR_AGENT_SESSION_NOT_FOUND')
+            if (error instanceof AgentError && error.code === 'MAR_AGENT_SESSION_NOT_FOUND')
                 return undefined;
             throw error;
         }

package/dist/service/prompt-completion-generator.js

@@ -1,4 +1,4 @@
-import { countModelTokens, generateModelText, marAgentReasoningEffortSchema } from '@myagentroam/agent';
+import { countModelTokens, generateModelText, agentReasoningEffortSchema } from '@myagentroam/agent';
 const MAX_INPUT_TOKENS = 12_288;
 const MAX_OUTPUT_TOKENS = 2_048;
 const INPUT_CONTEXT_RESERVE_TOKENS = 64;
@@ -296,7 +296,7 @@ function validateInput(input) {
         model.maxOutputTokens <= 0)
         throw invalidInput();
     if (input.reasoningEffort !== undefined &&
-        !marAgentReasoningEffortSchema.safeParse(input.reasoningEffort).success)
+        !agentReasoningEffortSchema.safeParse(input.reasoningEffort).success)
         throw invalidInput();
     if (!Array.isArray(input.history) ||
         !Array.isArray(input.referenceMessages) ||

package/dist/service/runtime-credential-control-service.js

@@ -1,4 +1,4 @@
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { createEnvelope, runtimeCredentialResolveRequestSchema, runtimeCredentialResolveResponseSchema } from '@myagentroam/protocol';
 const DEFAULT_TIMEOUT_MS = 15_000;
 /** Correlates the closed runtime-credential exchange on the authenticated control connection. */
@@ -33,7 +33,7 @@ export class RuntimeCredentialControlService {
             return true;
         const parsed = runtimeCredentialResolveResponseSchema.safeParse(envelope.payload);
         if (!parsed.success) {
-            pending.reject(new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_RESPONSE_INVALID', 'The runtime credential response is invalid.'));
+            pending.reject(new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_RESPONSE_INVALID', 'The runtime credential response is invalid.'));
             return true;
         }
         pending.resolve(parsed.data);
@@ -41,9 +41,9 @@ export class RuntimeCredentialControlService {
     }
     resolve(request, signal) {
         if (this.#closed)
-            return Promise.reject(new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_CONTROL_CLOSED', 'The runtime credential control service is closed.'));
+            return Promise.reject(new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_CONTROL_CLOSED', 'The runtime credential control service is closed.'));
         if (!this.#connected)
-            return Promise.reject(new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_CONNECTION_INVALID', 'The runtime credential control connection is unavailable.'));
+            return Promise.reject(new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_CONNECTION_INVALID', 'The runtime credential control connection is unavailable.'));
         const parsed = runtimeCredentialResolveRequestSchema.parse(request);
         const envelope = createEnvelope('credential.resolve', parsed);
         const generation = this.#generation;
@@ -57,8 +57,8 @@ export class RuntimeCredentialControlService {
                 pending.cleanup();
                 action(value);
             };
-            const abort = () => settle((error) => reject(error), new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.'));
-            const timer = setTimeout(() => settle((error) => reject(error), new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_REQUEST_TIMEOUT', 'The runtime credential request timed out.')), this.#timeoutMs);
+            const abort = () => settle((error) => reject(error), new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_PROVIDER_CLOSED', 'The runtime credential provider is closed.'));
+            const timer = setTimeout(() => settle((error) => reject(error), new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_REQUEST_TIMEOUT', 'The runtime credential request timed out.')), this.#timeoutMs);
             timer.unref();
             this.#pending.set(envelope.id, {
                 generation,
@@ -75,7 +75,7 @@ export class RuntimeCredentialControlService {
                     this.options.send(envelope);
                 }
                 catch (error) {
-                    settle((cause) => reject(cause), new MarAgentError('MAR_AGENT_RUNTIME_CREDENTIAL_REQUEST_SEND_FAILED', 'The runtime credential request could not be sent.', { cause: error }));
+                    settle((cause) => reject(cause), new AgentError('MAR_AGENT_RUNTIME_CREDENTIAL_REQUEST_SEND_FAILED', 'The runtime credential request could not be sent.', { cause: error }));
                 }
         });
     }
@@ -89,6 +89,6 @@ export class RuntimeCredentialControlService {
     }
     #rejectPending(code) {
         for (const pending of [...this.#pending.values()])
-            pending.reject(new MarAgentError(code, 'The runtime credential control connection is no longer valid.'));
+            pending.reject(new AgentError(code, 'The runtime credential control connection is no longer valid.'));
     }
 }

package/dist/service/web-fetch-service.js

@@ -4,13 +4,13 @@ import { TLSSocket } from 'node:tls';
 import { createBrotliDecompress, createGunzip, createInflate } from 'node:zlib';
 import { pipeline } from 'node:stream/promises';
 import { setTimeout as delay } from 'node:timers/promises';
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { chromium, errors } from 'playwright';
 import { WEB_FETCH_MAX_BYTES, webFetchRequestSchema } from './web-fetch-contracts.js';
 const TIMEOUT_MS = 30_000;
 const MAX_REDIRECTS = 5;
 const MAX_BROWSER_REQUESTS = 2;
-export class WebFetchError extends MarAgentError {
+export class WebFetchError extends AgentError {
     code;
     status;
     publicMessage;

package/dist/service/web-search-error.js

@@ -1,4 +1,4 @@
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { httpErrorResponseSchema } from '@myagentroam/protocol';
 export async function readWebSearchError(response) {
     let payload;
@@ -6,13 +6,13 @@ export async function readWebSearchError(response) {
         payload = await response.json();
     }
     catch {
-        return new MarAgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search failed.', {
+        return new AgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search failed.', {
             details: { status: response.status }
         });
     }
     const parsed = httpErrorResponseSchema.safeParse(payload);
     if (!parsed.success)
-        return new MarAgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search failed.', {
+        return new AgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search failed.', {
             details: { status: response.status }
         });
     const failure = parsed.data.error;
@@ -26,7 +26,7 @@ export async function readWebSearchError(response) {
         ...(failure.details === undefined ? [] : [`details: ${failure.details}`]),
         ...identifiers
     ].join('; ');
-    return new MarAgentError(failure.code, detail.length === 0 ? failure.message : `${failure.message} (${detail})`, {
+    return new AgentError(failure.code, detail.length === 0 ? failure.message : `${failure.message} (${detail})`, {
         details: {
             status: response.status,
             requestId: failure.requestId,

package/dist/service/web-tool-service.js

@@ -1,4 +1,4 @@
-import { MarAgentError } from '@myagentroam/agent';
+import { AgentError } from '@myagentroam/agent';
 import { readWebSearchError } from './web-search-error.js';
 import { WebFetchService } from './web-fetch-service.js';
 import { webFetchResultSchema } from './web-fetch-contracts.js';
@@ -21,7 +21,7 @@ export class WebToolService {
         });
         const parsed = webFetchResultSchema.safeParse(result);
         if (!parsed.success)
-            throw new MarAgentError('MAR_AGENT_WEB_FETCH_FAILED', 'Web fetch returned an invalid result.');
+            throw new AgentError('MAR_AGENT_WEB_FETCH_FAILED', 'Web fetch returned an invalid result.');
         return parsed.data;
     };
     close() {
@@ -59,14 +59,14 @@ export class WebToolService {
             return { content, data: result };
         }
         catch (error) {
-            if (error instanceof MarAgentError || signal.aborted)
+            if (error instanceof AgentError || signal.aborted)
                 throw error;
-            throw new MarAgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search failed.', {
+            throw new AgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search failed.', {
                 cause: error
             });
         }
     }
 }
 function invalidResult() {
-    return new MarAgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search returned an invalid result.');
+    return new AgentError('MAR_AGENT_WEB_SEARCH_FAILED', 'Web search returned an invalid result.');
 }

package/dist/service/workspace-change-service.js

@@ -8,6 +8,7 @@ const REPOSITORY_READ_CONCURRENCY = 4;
 const WORKTREE_READ_CONCURRENCY = 4;
 const CHANGE_VISIBILITY_CONCURRENCY = 16;
 const SUBMODULE_LIMIT = 128;
+const CHANGE_RESULT_LIMIT = 1000;
 export class WorkspaceChangeService {
     state;
     constructor(state) {
@@ -92,6 +93,7 @@ export class WorkspaceChangeService {
                     ...(summary.tracking === undefined ? {} : { tracking: summary.tracking }),
                     dirty: summary.changes.length > 0,
                     status: summary.changes.length > 0 ? 'DIRTY' : 'CLEAN',
+                    ...(summary.changesTruncated ? { changesTruncated: true } : {}),
                     changes
                 };
             };
@@ -190,6 +192,7 @@ export class WorkspaceChangeService {
                         branch: repository.branch,
                         ...(repository.tracking === undefined ? {} : { tracking: repository.tracking }),
                         status: repository.dirty ? 'DIRTY' : 'CLEAN',
+                        ...(repository.changesTruncated ? { changesTruncated: true } : {}),
                         changes: repository.changes
                     };
                 }
@@ -229,6 +232,33 @@ export class WorkspaceChangeService {
                 binary: false,
                 diffAvailable: true
             });
+            let remainingChanges = CHANGE_RESULT_LIMIT;
+            const repositories = [
+                {
+                    ...root,
+                    source: 'ROOT',
+                    physicalPath: currentWorktree?.path ?? repositoryRoot,
+                    current: true,
+                    ...(currentWorktree === undefined ? {} : { head: currentWorktree.head }),
+                    status: root.dirty ? 'DIRTY' : 'CLEAN',
+                    locked: currentWorktree?.locked ?? false,
+                    prunable: currentWorktree?.prunable ?? false
+                },
+                ...children.map((repository) => ({ ...repository, source: 'SUBMODULE' })),
+                ...linkedRepositories
+            ].map(({ dirty: _dirty, ...repository }) => {
+                void _dirty;
+                const changes = repository.changes.slice(0, remainingChanges).map(decorate);
+                remainingChanges -= changes.length;
+                return {
+                    ...repository,
+                    changes,
+                    ...(('changesTruncated' in repository && repository.changesTruncated) ||
+                        changes.length < repository.changes.length
+                        ? { changesTruncated: true }
+                        : {})
+                };
+            });
             const value = {
                 repositoryRoot,
                 workspace: {
@@ -240,27 +270,12 @@ export class WorkspaceChangeService {
                 partial: errors.length > 0 ||
                     children.some((group) => group.status === 'UNAVAILABLE') ||
                     linkedRepositories.some((group) => group.status === 'UNAVAILABLE') ||
-                    worktreeList.truncated,
+                    worktreeList.truncated ||
+                    repositories.some((group) => group.changesTruncated === true),
                 ...(errors.length === 0 ? {} : { errors }),
                 branch: root.branch,
-                changes: root.changes.map(decorate),
-                repositories: [
-                    {
-                        ...root,
-                        source: 'ROOT',
-                        physicalPath: currentWorktree?.path ?? repositoryRoot,
-                        current: true,
-                        ...(currentWorktree === undefined ? {} : { head: currentWorktree.head }),
-                        status: root.dirty ? 'DIRTY' : 'CLEAN',
-                        locked: currentWorktree?.locked ?? false,
-                        prunable: currentWorktree?.prunable ?? false
-                    },
-                    ...children.map((repository) => ({ ...repository, source: 'SUBMODULE' })),
-                    ...linkedRepositories
-                ].map(({ dirty: _dirty, ...repository }) => {
-                    void _dirty;
-                    return { ...repository, changes: repository.changes.map(decorate) };
-                }),
+                changes: repositories[0]?.changes ?? [],
+                repositories,
                 worktrees,
                 worktreesTruncated: worktreeList.truncated
             };

package/dist/workspace.js

@@ -1400,6 +1400,8 @@ export async function readCurrentChangesSummary(workspacePath, isolateSubmoduleF
         return runReadOnlyGit(workspacePath, [...args, '--ignore-submodules=dirty'], options);
     });
     const records = result.text.split('\0');
+    if (result.truncated)
+        records.pop();
     const header = records.shift() ?? '';
     const output = [];
     for (let index = 0; index < records.length; index += 1) {
@@ -1434,6 +1436,7 @@ export async function readCurrentChangesSummary(workspacePath, isolateSubmoduleF
         branch,
         ...(head === undefined ? {} : { head }),
         ...(tracking === undefined ? {} : { tracking }),
+        ...(result.truncated ? { changesTruncated: true } : {}),
         changes: output
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.11.33",
+  "version": "0.11.35",
   "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.33",
-    "@myagentroam/protocol": "0.11.33",
+    "@myagentroam/agent": "0.11.35",
     "@myagentroam/code-navigation": "0.11.0",
-    "@myagentroam/marctl": "0.11.1"
+    "@myagentroam/marctl": "0.11.2",
+    "@myagentroam/protocol": "0.11.35"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"