@myagentroam/node 0.12.0 → 0.12.2

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

@@ -602,7 +602,7 @@ export class MarAgentConversationNormalizer {
         this.#clearCodeModeOutputSnapshots(sourceCallId);
     }
     #startExecution(executionId) {
-        for (const [callId, state] of this.#tools)
+        for (const state of this.#tools.values())
             if (state.executionId !== executionId) {
                 state.active = false;
             }
@@ -1734,20 +1734,6 @@ function truncateCharacters(value, maximumCharacters) {
         ? value
         : characters.slice(0, maximumCharacters).join('');
 }
-function boundedToolSummary(value) {
-    const maximumCodeUnits = 10_000;
-    if (value.length <= maximumCodeUnits)
-        return value;
-    let end = maximumCodeUnits - 1;
-    const lastIncluded = value.charCodeAt(end - 1);
-    const firstExcluded = value.charCodeAt(end);
-    if (lastIncluded >= 0xd800 &&
-        lastIncluded <= 0xdbff &&
-        firstExcluded >= 0xdc00 &&
-        firstExcluded <= 0xdfff)
-        end--;
-    return `${value.slice(0, end)}…`;
-}
 function marAgentAgentId(value) {
     const data = structuredRecord(value);
     if (data === undefined)
@@ -1798,7 +1784,7 @@ function imageArtifacts(event) {
         const name = typeof artifact?.name === 'string' ? compactRunnerText(artifact.name, 255) : '';
         const byteSize = nonnegativeInteger(artifact?.byteSize);
         if (artifact?.kind !== 'image' ||
-            artifact.mimeType !== 'image/png' ||
+            (artifact.mimeType !== 'image/png' && artifact.mimeType !== 'image/gif') ||
             typeof artifact.sha256 !== 'string' ||
             !/^[a-f0-9]{64}$/iu.test(artifact.sha256) ||
             name.length === 0 ||
@@ -1810,8 +1796,8 @@ function imageArtifacts(event) {
             fileName === '..' ||
             fileName.includes('/') ||
             fileName.includes('\\') ||
-            !fileName.toLocaleLowerCase().endsWith('.png'))
+            !fileName.endsWith(artifact.mimeType === 'image/gif' ? '.gif' : '.png'))
             return [];
-        return [{ name, mime: 'image/png', byteSize, fileName }];
+        return [{ name, mime: artifact.mimeType, byteSize, fileName }];
     });
 }

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

@@ -19,7 +19,7 @@ export function createImageGenerationExtensions(input) {
             {
                 name: codex ? 'codex-imagegen' : 'byted_ark-imagegen',
                 description: codex
-                    ? 'Generate or edit raster images with codex_image_gen only when explicitly requested. Load before calling the image tool.'
+                    ? 'Generate or edit PNG images and looping GIFs with codex_image_gen only when explicitly requested. Load before calling the image tool.'
                     : 'Generate or edit one image with byted_ark_image_gen only when explicitly requested. Load before calling the image tool.',
                 requiredTools: [tool.name],
                 load: async () => codex

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

@@ -26,7 +26,7 @@ export const codexImageGenToolDefinition = {
     agentScope: 'ROOT_ONLY',
     allowedCallers: ['direct', 'programmatic'],
     parallelSafety: 'safe',
-    description: 'Only when the user requests or explicitly authorizes image generation or editing, use the configured Codex Images API. First load and follow skill({name:"codex-imagegen"}); reload if its guidance is no longer in context. Do not generate unsolicited visuals. Omit both selectors for a new image without references. For image inputs, inspect unseen local images with view_image when available; TEXT-only models must not claim visual inspection. Use referenced_image_paths when every image has an absolute path; otherwise use num_last_images_to_include for the smallest sufficient number of currently available conversation images. Never provide both selectors. Include at most five images; if required inputs are missing, ask for them rather than silently omitting them. Recent images are in-memory in the current Execution, not a permanent history library. One PNG is saved in the current Session and its path is returned, not inspected pixels. Use view_image when available to check the result; otherwise report that visual acceptance was not performed. Full workflow guidance is in the codex-imagegen skill.',
+    description: 'Generate or edit one PNG or simple looping GIF with the configured Codex Images API, only when requested or explicitly authorized. First load skill({name:"codex-imagegen"}); reuse it while in context. Omit selectors only for generation without references; otherwise use up to five absolute referenced_image_paths OR the smallest sufficient num_last_images_to_include from this Execution. Set transparent_background for transparency and gif for 2–16 animation frames. Returns a managed file path, not inspected pixels.',
     inputSchema: {
         type: 'object',
         properties: {
@@ -44,6 +44,19 @@ export const codexImageGenToolDefinition = {
                 minimum: 1,
                 maximum: MAX_EDIT_IMAGES,
                 description: 'Number of most recent in-memory conversation images to edit.'
+            },
+            transparent_background: {
+                type: 'boolean',
+                description: 'Request a transparent background; defaults to false.'
+            },
+            gif: {
+                type: 'object',
+                description: 'Request a simple looping GIF. Use {} for 9 frames at 200 ms per frame.',
+                properties: {
+                    frame_count: { type: 'integer', minimum: 2, maximum: 16 },
+                    frame_duration_ms: { type: 'integer', minimum: 20, maximum: 2000 }
+                },
+                additionalProperties: false
             }
         },
         required: ['prompt'],
@@ -53,6 +66,10 @@ export const codexImageGenToolDefinition = {
 export const bytedArkImageGenToolDefinition = {
     ...codexImageGenToolDefinition,
     name: 'byted_ark_image_gen',
+    inputSchema: {
+        ...codexImageGenToolDefinition.inputSchema,
+        properties: Object.fromEntries(Object.entries(codexImageGenToolDefinition.inputSchema.properties ?? {}).filter(([key]) => key !== 'transparent_background' && key !== 'gif'))
+    },
     description: 'Generate or edit one PNG using the configured Ark Images API, only when explicitly requested. First load skill({name:"byted_ark-imagegen"}). Omit both selectors for text-to-image; use absolute referenced_image_paths or num_last_images_to_include for image-to-image, never both. Up to five references, exactly one output; no group generation. Returns a managed image path, not inspected pixels.'
 };
 export async function executeCodexImageGen(arguments_, input) {
@@ -60,11 +77,11 @@ export async function executeCodexImageGen(arguments_, input) {
     const capability = input.configuration.imageGeneration;
     if (capability === undefined || capability.credentialProvider === undefined)
         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 AgentError('MAR_AGENT_MODEL_CONFIG_INVALID', 'Unsupported image provider.');
+    const request = parseInput(arguments_, ark);
+    const images = await selectedEditImages(request, input);
     const endpoint = images.length === 0 ? capability.generateEndpoint : capability.editEndpoint;
     const body = JSON.stringify(ark
         ? {
@@ -93,11 +110,11 @@ export async function executeCodexImageGen(arguments_, input) {
                     }))
                 }),
             prompt: request.prompt,
-            background: 'auto',
+            background: request.transparentBackground ? 'transparent' : 'opaque',
             model: capability.imageModelId,
-            n: 1,
             quality: 'auto',
-            size: 'auto'
+            size: 'auto',
+            ...(request.gif === undefined ? {} : { output_format: 'gif', ...request.gif })
         });
     const turnId = randomUUID();
     let reason = 'REQUEST';
@@ -136,8 +153,10 @@ export async function executeCodexImageGen(arguments_, input) {
         if (!response.ok)
             throw imageGenerationResponseError(response.status, payload);
         const encoded = imageBase64(payload);
-        const data = decodePng(encoded);
-        const fileName = generatedFileName(input.callId);
+        const { data, format } = decodeImage(encoded);
+        if (ark && format !== 'png')
+            throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Ark image response must be a PNG.');
+        const fileName = generatedFileName(input.callId, format);
         const directory = join(input.sessionDirectory, 'generated_images');
         const path = join(directory, fileName);
         const displayPath = input.displayDirectory === undefined ? path : posix.join(input.displayDirectory, fileName);
@@ -160,7 +179,7 @@ export async function executeCodexImageGen(arguments_, input) {
                 {
                     kind: 'image',
                     name: fileName,
-                    mimeType: 'image/png',
+                    mimeType: format === 'gif' ? 'image/gif' : 'image/png',
                     byteSize: data.byteLength,
                     sha256,
                     fileName
@@ -170,16 +189,21 @@ export async function executeCodexImageGen(arguments_, input) {
     }
     throw new AgentError('MAR_AGENT_IMAGE_GENERATION_FAILED', 'Image generation failed.');
 }
-function parseInput(value) {
+function parseInput(value, ark) {
     if (value === null || typeof value !== 'object' || Array.isArray(value))
         return invalidInput();
     const input = value;
     const referencedImagePaths = input.referenced_image_paths === null ? undefined : input.referenced_image_paths;
     const numLastImagesToInclude = input.num_last_images_to_include === null ? undefined : input.num_last_images_to_include;
-    if (Object.keys(input).some((key) => key !== 'prompt' && key !== 'referenced_image_paths' && key !== 'num_last_images_to_include') ||
+    const transparentBackground = input.transparent_background ?? false;
+    if (Object.keys(input).some((key) => key !== 'prompt' &&
+        key !== 'referenced_image_paths' &&
+        key !== 'num_last_images_to_include' &&
+        (ark || (key !== 'gif' && key !== 'transparent_background'))) ||
         typeof input.prompt !== 'string' ||
         input.prompt.trim().length === 0 ||
         input.prompt.length > 32_768 ||
+        typeof transparentBackground !== 'boolean' ||
         (referencedImagePaths !== undefined &&
             (!Array.isArray(referencedImagePaths) ||
                 referencedImagePaths.length > MAX_EDIT_IMAGES ||
@@ -194,12 +218,32 @@ function parseInput(value) {
         return invalidInput();
     return {
         prompt: input.prompt,
+        transparentBackground,
+        ...(input.gif === undefined || input.gif === null ? {} : { gif: parseGif(input.gif) }),
         ...(paths?.length ? { referencedImagePaths: [...paths] } : {}),
         ...(numLastImagesToInclude === undefined
             ? {}
             : { numLastImagesToInclude: numLastImagesToInclude })
     };
 }
+function parseGif(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return invalidInput();
+    const options = value;
+    if (Object.keys(options).some((key) => key !== 'frame_count' && key !== 'frame_duration_ms'))
+        return invalidInput();
+    const count = options.frame_count ?? undefined;
+    const duration = options.frame_duration_ms ?? undefined;
+    if ((count !== undefined &&
+        (!Number.isInteger(count) || count < 2 || count > 16)) ||
+        (duration !== undefined &&
+            (!Number.isInteger(duration) || duration < 20 || duration > 2000)))
+        return invalidInput();
+    return {
+        ...(count === undefined ? {} : { frame_count: count }),
+        ...(duration === undefined ? {} : { frame_duration_ms: duration })
+    };
+}
 async function selectedEditImages(request, input) {
     if (request.referencedImagePaths !== undefined) {
         const images = [];
@@ -310,31 +354,36 @@ function imageBase64(value) {
         throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.');
     return first;
 }
-function decodePng(encoded) {
+function decodeImage(encoded) {
     if (encoded.length % 4 !== 0 || !/^[A-Za-z0-9+/]+={0,2}$/u.test(encoded))
         throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is invalid.');
     const data = Buffer.from(encoded, 'base64');
+    const signature = data.subarray(0, 6);
+    const format = signature.equals(Buffer.from('GIF87a')) || signature.equals(Buffer.from('GIF89a'))
+        ? 'gif'
+        : 'png';
     if (data.byteLength === 0 ||
         data.byteLength > IMAGE_MAX_BYTES ||
         data.toString('base64') !== encoded ||
-        !data.subarray(0, PNG_SIGNATURE.length).equals(PNG_SIGNATURE))
-        throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is not a supported PNG.');
-    return data;
+        (format === 'png' && !data.subarray(0, PNG_SIGNATURE.length).equals(PNG_SIGNATURE)))
+        throw new AgentError('MAR_AGENT_IMAGE_GENERATION_RESPONSE_INVALID', 'Image response is not a supported PNG or GIF.');
+    return { data, format };
 }
-function generatedFileName(callId) {
+function generatedFileName(callId, format) {
     const normalized = callId
         .normalize('NFKC')
         .replace(/[^a-zA-Z0-9._-]+/gu, '_')
         .replace(/^[_\-.]+|[_\-.]+$/gu, '')
         .slice(0, 96);
     const stem = normalized.length > 0 ? normalized : createHash('sha256').update(callId).digest('hex');
-    const fileName = `${stem.startsWith('image_') ? stem : `image_${stem}`}.png`;
+    const fileName = `${stem.startsWith('image_') ? stem : `image_${stem}`}.${format}`;
     return basename(fileName);
 }
 function imageGenerationResponseError(status, value) {
-    const error = value !== null && typeof value === 'object' && !Array.isArray(value)
-        ? value.error
+    const payload = value !== null && typeof value === 'object' && !Array.isArray(value)
+        ? value
         : undefined;
+    const error = payload?.error;
     const record = error !== null && typeof error === 'object' && !Array.isArray(error)
         ? error
         : undefined;
@@ -343,7 +392,11 @@ function imageGenerationResponseError(status, value) {
     const code = /^[a-zA-Z0-9._-]{1,80}$/u.test(rawCode)
         ? rawCode
         : 'MAR_AGENT_IMAGE_GENERATION_FAILED';
-    const rawMessage = typeof record?.message === 'string' ? record.message.trim() : '';
+    const rawMessage = typeof record?.message === 'string'
+        ? record.message.trim()
+        : typeof payload?.detail === 'string'
+            ? payload.detail.trim()
+            : '';
     const message = rawMessage.length > 0 &&
         rawMessage.length <= 1_000 &&
         !/\b(?:authorization|bearer|api[_ -]?key|access[_ -]?token|refresh[_ -]?token|password|secret|proxy-authorization|chatgpt-account-id)\b|socks5:\/\//iu.test(rawMessage)

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

@@ -78,11 +78,13 @@ export class MarAgentSessionRuntimeRegistry {
                         this.#assertUsable(entry, lifetime);
                     }
                     const request = nativeId === undefined ? input : { ...input, externalSessionId: nativeId };
-                    let created;
-                    created = await createSessionRuntime(request, nativeId ?? input.sessionId, fingerprint, configuration, this.resources, () => created !== undefined && entry.runtime === created && entry.release === undefined
+                    const created = {};
+                    created.runtime = await createSessionRuntime(request, nativeId ?? input.sessionId, fingerprint, configuration, this.resources, () => created.runtime !== undefined &&
+                        entry.runtime === created.runtime &&
+                        entry.release === undefined
                         ? entry.current?.runId
                         : undefined);
-                    uncommitted = created;
+                    uncommitted = created.runtime;
                     this.#addAlias(entry, uncommitted.session.id);
                     nodeLog('runner.mar-agent.runtime.created', {
                         runtimeId: uncommitted.runtimeId,

package/dist/service/code-navigation/file-reference-parser.js

@@ -1,4 +1,4 @@
-import { fileSpecifierParser } from '@myagentroam/code-navigation';
+import { fileSpecifierParser } from '../../code-navigation/index.js';
 const MAX_REFERENCE_REPARSE_POSITIONS = 8;
 export function reparseFileReference(path, requested) {
     const parser = fileSpecifierParser(path, requested.sourceContext.text);

package/dist/service/node-terminal-channel.js

@@ -3,7 +3,7 @@ import { terminalDataFrameSchema } from '@myagentroam/protocol';
 import { nodeTerminalConnectEndpoint } from '../connection/endpoints.js';
 import { isPlainRecord } from '../util/records.js';
 import { TerminalRelayState } from './terminal-relay-state.js';
-import { TerminalRelaySender } from '@myagentroam/marctl/src/terminal-relay-sender.mjs';
+import { TerminalRelaySender } from '../marctl/src/terminal-relay-sender.mjs';
 export class NodeTerminalChannel {
     options;
     socket;

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

@@ -187,13 +187,16 @@ export class SessionCatalogService {
             for (const record of candidates) {
                 if (selected.size >= query.limit)
                     break;
+                const remaining = query.limit - selected.size;
                 const path = [];
                 let current = record;
                 while (current !== undefined && !selected.has(current.id)) {
                     path.push(current);
+                    if (path.length > remaining)
+                        break;
                     current = byId.get(current.metadata.parentSessionId ?? '');
                 }
-                if (path.length > query.limit - selected.size)
+                if (path.length > remaining)
                     continue;
                 for (const ancestor of path.reverse())
                     selected.set(ancestor.id, ancestor);

package/dist/workspace/workspace-code-navigation-service.js

@@ -3,8 +3,8 @@ import { constants } from 'node:fs';
 import { access, open, realpath, rename, rm, stat, writeFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { relative, resolve, sep } from 'node:path';
-import { isNavigationSymbol } from '@myagentroam/code-navigation';
-import { supportsSymbolNavigationPath } from '@myagentroam/code-navigation/symbol-navigation';
+import { isNavigationSymbol } from '../code-navigation/index.js';
+import { supportsSymbolNavigationPath } from '../code-navigation/symbol-navigation.js';
 import { workspaceFileReferenceSchema } from '@myagentroam/protocol';
 import { bundledCtagsPath, BUNDLED_CTAGS_VERSION, repairBundledCtagsExecutable } from '../ctags-binary.js';
 import { nodeLog } from '../operational.js';

package/dist/workspace/workspace-git-exclude-service.js

@@ -65,7 +65,7 @@ async function gitExcludeTarget(workspace, includeParentRepository) {
         .relative(root, await realpath(workspace))
         .split(path.sep)
         .join('/');
-    const escaped = relative.replace(/[\\*?\[\]#! ]/g, '\\$&');
+    const escaped = relative.replace(/[\\*?[\]#! ]/g, '\\$&');
     return { exclude: await resolveGitExclude(root), prefix: relative === '' ? '/' : `/${escaped}/` };
 }
 async function mutateGitExclude(workspace, mutate, includeParentRepository) {

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
   "files": [
     "dist/**/*.js",
+    "dist/marctl/**/*.mjs",
+    "dist/marctl/**/*.cjs",
+    "dist/marctl/package.json",
     "scripts/install-web-browser.mjs",
-    "vendor/ripgrep/**/*",
-    "vendor/ctags/**/*",
     "dist/config.d.ts",
     "LICENSE",
     "NOTICE"
@@ -29,6 +30,7 @@
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.3.233",
     "@modelcontextprotocol/sdk": "1.32.0",
+    "@myagentroam/binaries": "0.10.1",
     "@opencode-ai/sdk": "1.18.20",
     "minimatch": "^10.2.6",
     "node-datachannel": "0.33.4",
@@ -40,14 +42,14 @@
     "turndown-plugin-gfm": "^1.0.2",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.12.0",
-    "@myagentroam/marctl": "0.12.0",
-    "@myagentroam/code-navigation": "0.11.1",
-    "@myagentroam/protocol": "0.12.0"
+    "@myagentroam/protocol": "0.12.2",
+    "@myagentroam/agent": "0.12.2"
   },
   "devDependencies": {
     "@types/turndown": "^5.0.6",
-    "@types/ws": "^8.18.1"
+    "@types/ws": "^8.18.1",
+    "@myagentroam/code-navigation": "0.11.1",
+    "@myagentroam/marctl": "0.12.2"
   },
   "exports": {
     "./config": {
@@ -59,7 +61,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/install-web-browser.mjs",
-    "build": "node ../scripts/clean-build-output.mjs dist && tsc -p tsconfig.json",
+    "build": "node ../scripts/clean-build-output.mjs dist && tsc -p tsconfig.json && node ../scripts/stage-node-internals.mjs",
     "stage:computer-use-runtime": "node ../scripts/stage-computer-use-runtime.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.tests.json --noEmit",
     "dev": "tsx watch src/main.ts",

package/vendor/ctags/NOTICE

@@ -1,22 +0,0 @@
-This directory distributes Universal Ctags binaries as a separate executable
-work. All bundled binaries are official upstream artifacts built from commit
-ab95af198f8eaeb6d50dc96e3adf52e769d3e5f0.
-
-Universal Ctags is licensed under GPL-2.0-or-later. Its complete corresponding
-source is included at:
-
-  source/universal-ctags-ab95af198f8eaeb6d50dc96e3adf52e769d3e5f0.tar.gz
-
-The official source URL, per-platform release URLs, archive SHA-256 values and
-executable SHA-256 values are recorded in manifest.json.
-
-Linux x64/ARM64 and macOS x64/ARM64 come from the official
-universal-ctags/ctags-nightly-build 2026.09.16 release. Their upstream package
-metadata and dependency notices are preserved under
-licenses/official-snapshot/<target>/.
-
-Windows x64 comes from the official universal-ctags/ctags-win32
-2026-09-16/p6.2.20260913.0-2-gab95af1 release. Its distributed license texts
-are preserved under licenses/win32-x64/.
-
-No bundled Ctags executable is built by this project.