@myagentroam/node 0.9.131 → 0.9.132

package/dist/connector.js

@@ -1480,7 +1480,8 @@ export class NodeConnector {
         this.operationRouter.register('node.upgrade.request', (data) => this.upgradeCoordinator.request(data));
         this.operationRouter.register('node.upgrade.cancel', () => this.upgradeCoordinator.cancel());
         this.operationRouter.register('node.workbench.capabilities', async () => ({
-            manifest: await this.workbenchManifestService.read()
+            manifest: await this.workbenchManifestService.read(),
+            binaryTerminal: true
         }));
     }
     async initializeConversationHosting() {

package/dist/marmgr.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+// Keep the CLI implementation in its own package; the Node install exposes the same entrypoint.
+const entrypoint = '@myagentroam/marmgr/bin/marmgr.mjs';
+await import(entrypoint);
+export {};

package/dist/marnodes.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const entrypoint = '@myagentroam/marmgr/bin/marnodes.mjs';
+await import(entrypoint);
+export {};

package/dist/marscp.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const entrypoint = '@myagentroam/marmgr/bin/marscp.mjs';
+await import(entrypoint);
+export {};

package/dist/marssh.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+const entrypoint = '@myagentroam/marmgr/bin/marssh.mjs';
+await import(entrypoint);
+export {};

package/dist/runner/abstract-runner.js

@@ -166,6 +166,15 @@ export class AbstractRunner {
 function resolvedMcpServers(raw, secrets) {
     if (!Array.isArray(raw))
         return [];
+    const marmgrEnvironment = {
+        ...(secrets['MAR_MGR_SERVER_URL'] === undefined
+            ? {}
+            : { MAR_MGR_SERVER_URL: secrets['MAR_MGR_SERVER_URL'] }),
+        ...(secrets['MAR_MGR_USER_TOKEN'] === undefined
+            ? {}
+            : { MAR_MGR_USER_TOKEN: secrets['MAR_MGR_USER_TOKEN'] }),
+        MAR_MGR_CONTEXT_REQUIRED: '1'
+    };
     const result = [];
     for (const value of raw) {
         if (value === null || typeof value !== 'object' || Array.isArray(value))
@@ -191,17 +200,20 @@ function resolvedMcpServers(raw, secrets) {
                 environment: record['__marGoal'] === true
                     ? {
                         MAR_GOAL_MCP_ENDPOINT: record['endpoint'],
-                        MAR_GOAL_MCP_TOKEN: secrets[record['secretName']]
+                        MAR_GOAL_MCP_TOKEN: secrets[record['secretName']],
+                        ...marmgrEnvironment
                     }
                     : record['__marScheduled'] === true
                         ? {
                             MAR_SCHEDULE_MCP_ENDPOINT: record['endpoint'],
                             MAR_SCHEDULE_MCP_TOKEN: secrets[record['secretName']],
-                            MAR_SCHEDULE_MCP_READ_ONLY: record['readOnly'] === true ? '1' : '0'
+                            MAR_SCHEDULE_MCP_READ_ONLY: record['readOnly'] === true ? '1' : '0',
+                            ...marmgrEnvironment
                         }
                         : {
                             MAR_MAIL_MCP_ENDPOINT: record['endpoint'],
-                            MAR_MAIL_MCP_TOKEN: secrets[record['secretName']]
+                            MAR_MAIL_MCP_TOKEN: secrets[record['secretName']],
+                            ...marmgrEnvironment
                         }
             });
             continue;
@@ -241,7 +253,8 @@ function resolvedMcpServers(raw, secrets) {
                 ],
                 environment: {
                     ...runtimeEnvironment,
-                    ...configuredEnvironment
+                    ...configuredEnvironment,
+                    ...marmgrEnvironment
                 }
             });
         }

package/dist/runner/claude/managed-run-controller.js

@@ -170,7 +170,7 @@ export class ClaudeManagedRunController {
                 ...(typeof payload.model === 'string' ? { model: payload.model } : {}),
                 ...(typeof payload.effort === 'string' ? { effort: payload.effort } : {}),
                 ...(typeof payload.access === 'string' ? { access: payload.access } : {}),
-                environment: secretEnvironment,
+                environment: { ...secretEnvironment, MAR_MGR_CONTEXT_REQUIRED: '1' },
                 ...(typeof payload.personalInstructions === 'string'
                     ? { personalInstructions: payload.personalInstructions }
                     : {}),

package/dist/runner/codex/managed-run-controller.js

@@ -385,7 +385,7 @@ export class CodexManagedRunController {
             return;
         }
         try {
-            this.runner.prepareEnvironment(secretEnvironment, runId);
+            this.runner.prepareEnvironment({ ...secretEnvironment, MAR_MGR_CONTEXT_REQUIRED: '1' }, runId);
         }
         catch (error) {
             this.host.emit(runId, 'run.rejected', { code: safeErrorCode(error, 'SECRET_ENVIRONMENT_INVALID') }, 'FAILED');

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

@@ -686,7 +686,7 @@ export function allowsUntrustedWebFetchTls(environment) {
     return environment['MAR_AGENT_WEB_FETCH_ALLOW_UNTRUSTED_TLS'] !== '0';
 }
 async function resolveMarAgentHostRuntimeConfiguration(secretEnvironment = {}) {
-    const environment = { ...process.env, ...secretEnvironment };
+    const environment = { ...process.env, ...secretEnvironment, MAR_MGR_CONTEXT_REQUIRED: '1' };
     const ripgrep = await availableBundledRipgrep();
     return {
         environment: ripgrep === undefined ? environment : prependBundledRipgrepToPath(environment, ripgrep),

package/dist/runner/opencode/managed-run-controller.js

@@ -108,7 +108,10 @@ export class OpenCodeManagedRunController {
         let mcp;
         let attachments;
         try {
-            environment = parseSecretEnvironment(payload.secretEnvironment);
+            environment = {
+                ...parseSecretEnvironment(payload.secretEnvironment),
+                MAR_MGR_CONTEXT_REQUIRED: '1'
+            };
             mcpSecretEnvironment = parseSecretEnvironment(payload.mcpSecretEnvironment);
             mcp = this.runner.mcpConfiguration(payload.mcpInstallations, {
                 ...environment,

package/dist/service/terminal-service.js

@@ -38,8 +38,11 @@ export class TerminalService {
         if (commandMode &&
             (input.workspaceId !== undefined ||
                 typeof input.command !== 'string' ||
-                input.command.trim().length === 0))
+                input.command.trim().length === 0 ||
+                (input.binary !== undefined && typeof input.binary !== 'boolean')))
             throw new Error('TERMINAL_COMMAND_INVALID');
+        if (!commandMode && input.binary !== undefined)
+            throw new Error('TERMINAL_OPEN_INVALID');
         const secretEnvironment = parseSecretEnvironment(input.secretEnvironment);
         if ((commandMode || secretEnvironment.MAR_GIT_TOKEN !== undefined) &&
             (!Number.isSafeInteger(input.__requestUserId) || Number(input.__requestUserId) <= 0))
@@ -58,11 +61,11 @@ export class TerminalService {
             const options = {
                 ...input,
                 workspaceId: typeof input.workspaceId === 'string' ? input.workspaceId : null,
-                environment: secretEnvironment,
+                environment: { ...secretEnvironment, MAR_MGR_CONTEXT_REQUIRED: '1' },
                 ...(cwd === undefined ? {} : { cwd })
             };
             const terminal = commandMode
-                ? this.terminalManager.openCommand(options, input.command)
+                ? this.terminalManager.openCommand(options, input.command, input.binary === true)
                 : this.terminalManager.open(options);
             if (commandMode || secretEnvironment.MAR_GIT_TOKEN !== undefined)
                 this.terminalOwners.set(terminal.id, {

package/dist/terminal.js

@@ -1,4 +1,5 @@
 import { randomUUID } from 'node:crypto';
+import { spawn as spawnProcess } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
@@ -26,6 +27,7 @@ export class TerminalManager {
     idleTimeoutMs;
     now;
     ptyFactory;
+    pipeFactory;
     terminate;
     terminals = new Map();
     attachments = new Map();
@@ -61,6 +63,7 @@ export class TerminalManager {
         }
         this.now = options.now ?? Date.now;
         this.ptyFactory = options.ptyFactory ?? nodePtyFactory;
+        this.pipeFactory = options.pipeFactory ?? nodePipeFactory;
         this.terminate =
             options.terminate ?? ((child, platform) => terminateProcessTree(child, platform));
         this.idleTimer = setInterval(() => void this.closeExpired(), Math.min(this.idleTimeoutMs, 60_000));
@@ -81,13 +84,13 @@ export class TerminalManager {
         return this.openInternal(input);
     }
     /** A command starts only after a relay or direct Terminal attachment is active. */
-    openCommand(input, command) {
+    openCommand(input, command, binary = false) {
         if (typeof command !== 'string' ||
             command.trim().length === 0 ||
             Buffer.byteLength(command, 'utf8') > TERMINAL_COMMAND_MAX_BYTES ||
             command.includes('\0'))
             throw new Error('TERMINAL_COMMAND_INVALID');
-        return this.openInternal(input, command);
+        return this.openInternal(input, command, binary);
     }
     startCommand(terminalId) {
         const terminal = this.requireTerminal(terminalId);
@@ -96,17 +99,25 @@ export class TerminalManager {
             return;
         delete terminal.deferredCommand;
         try {
-            const pty = this.ptyFactory(deferred.shell, deferred.args, deferred.options);
-            terminal.pty = pty;
-            pty.onData((data) => this.recordOutput(terminal, data));
-            pty.onExit((event) => this.exited(terminal, event.exitCode));
+            if (terminal.binary) {
+                const pipe = this.pipeFactory(deferred.shell, deferred.args, deferred.options);
+                terminal.pipe = pipe;
+                pipe.onData((data) => this.recordBinaryOutput(terminal, data));
+                pipe.onExit((exitCode) => this.exited(terminal, exitCode));
+            }
+            else {
+                const pty = this.ptyFactory(deferred.shell, deferred.args, deferred.options);
+                terminal.pty = pty;
+                pty.onData((data) => this.recordOutput(terminal, data));
+                pty.onExit((event) => this.exited(terminal, event.exitCode));
+            }
         }
         catch {
             this.emit({ type: 'error', terminalId, code: 'TERMINAL_COMMAND_START_FAILED' });
             this.exited(terminal, 127);
         }
     }
-    openInternal(input = {}, command) {
+    openInternal(input = {}, command, binary = false) {
         const profileId = input.profileId ?? this.profiles.find((profile) => profile.isDefault)?.id;
         if (typeof profileId !== 'string')
             throw new Error('TERMINAL_PROFILE_INVALID');
@@ -143,6 +154,8 @@ export class TerminalManager {
             workspaceId: input.workspaceId ?? null,
             profile,
             pty,
+            pipe: undefined,
+            binary,
             ...(commandArgs === undefined
                 ? {}
                 : { deferredCommand: { shell: profile.shell, args: commandArgs, options } }),
@@ -252,12 +265,23 @@ export class TerminalManager {
         terminal.updatedAt = this.now();
         terminal.lastUsedAt = terminal.updatedAt;
         if (parsed.data.type === 'input') {
+            if (terminal.binary) {
+                if (terminal.pipe === undefined)
+                    throw new Error('TERMINAL_COMMAND_NOT_STARTED');
+                const bytes = Buffer.from(parsed.data.data, 'base64');
+                if (bytes.length > 32 * 1024 || bytes.toString('base64') !== parsed.data.data)
+                    throw new Error('TERMINAL_FRAME_INVALID');
+                terminal.pipe.write(bytes);
+                return;
+            }
             if (terminal.pty === undefined)
                 throw new Error('TERMINAL_COMMAND_NOT_STARTED');
             terminal.pty.write(parsed.data.data);
             return;
         }
         if (parsed.data.type === 'resize') {
+            if (terminal.binary)
+                throw new Error('TERMINAL_FRAME_INVALID');
             if (terminal.pty === undefined)
                 throw new Error('TERMINAL_COMMAND_NOT_STARTED');
             terminal.pty.resize(parsed.data.cols, parsed.data.rows);
@@ -279,6 +303,8 @@ export class TerminalManager {
         try {
             if (terminal.pty !== undefined)
                 await this.terminate(terminal.pty, this.platform);
+            if (terminal.pipe !== undefined)
+                await this.terminate(terminal.pipe, this.platform);
         }
         finally {
             this.emit({ type: 'exit', terminalId: terminal.id, exitCode: terminal.exitCode });
@@ -331,6 +357,31 @@ export class TerminalManager {
             });
         }
     }
+    recordBinaryOutput(terminal, data) {
+        if (terminal.state !== 'RUNNING')
+            return;
+        for (let offset = 0; offset < data.length; offset += 32 * 1024) {
+            const part = data.subarray(offset, offset + 32 * 1024);
+            const frame = {
+                sequence: ++terminal.sequence,
+                data: part.toString('base64'),
+                bytes: part.length
+            };
+            terminal.replay.push(frame);
+            terminal.replayBytes += frame.bytes;
+            while (terminal.replayBytes > this.maxReplayBytes && terminal.replay.length > 0) {
+                const removed = terminal.replay.shift();
+                if (removed !== undefined)
+                    terminal.replayBytes -= removed.bytes;
+            }
+            this.emit({
+                type: 'output',
+                terminalId: terminal.id,
+                sequence: frame.sequence,
+                data: frame.data
+            });
+        }
+    }
     exited(terminal, exitCode) {
         if (terminal.state !== 'RUNNING')
             return;
@@ -433,6 +484,33 @@ function nodePtyFactory(shell, args, options) {
     });
     return pty;
 }
+function nodePipeFactory(shell, args, options) {
+    const child = spawnProcess(shell, [...args], {
+        cwd: options.cwd,
+        env: options.env,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        detached: process.platform !== 'win32',
+        windowsHide: true
+    });
+    child.stdin.on('error', () => undefined);
+    child.stderr.resume();
+    return {
+        pid: child.pid,
+        kill: (signal) => child.kill(signal),
+        write: (bytes) => {
+            if (child.stdin.destroyed)
+                throw new Error('TERMINAL_PIPE_CLOSED');
+            child.stdin.write(bytes);
+        },
+        onData: (listener) => {
+            child.stdout.on('data', listener);
+        },
+        onExit: (listener) => {
+            child.on('error', () => listener(127));
+            child.on('close', (exitCode) => listener(exitCode ?? 1));
+        }
+    };
+}
 export function defaultTerminalProfiles(platform, findWindowsExecutable = resolveWindowsExecutable) {
     if (platform === 'win32') {
         const pwsh = findWindowsExecutable('pwsh.exe');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.131",
+  "version": "0.9.132",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -12,7 +12,11 @@
     "NOTICE"
   ],
   "bin": {
-    "mar-node": "./dist/main.js"
+    "mar-node": "./dist/main.js",
+    "marmgr": "./dist/marmgr.js",
+    "marnodes": "./dist/marnodes.js",
+    "marssh": "./dist/marssh.js",
+    "marscp": "./dist/marscp.js"
   },
   "engines": {
     "node": ">=22.13"
@@ -30,8 +34,9 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.9.131",
-    "@myagentroam/protocol": "0.9.131",
+    "@myagentroam/marmgr": "0.9.115",
+    "@myagentroam/agent": "0.9.132",
+    "@myagentroam/protocol": "0.9.132",
     "@myagentroam/code-navigation": "0.9.129"
   },
   "devDependencies": {