@myagentroam/node 0.9.130 → 0.9.132

package/dist/connector.js

@@ -263,6 +263,7 @@ export class NodeConnector {
     goalSubmissionAttempts = new Map();
     goalContinuationEpochs = new Map();
     goalExecutionProgress = new Set();
+    nativeGoalBindings = new Map();
     sessionScheduleService;
     goalMcpServer = new GoalMcpServer(this.goalRuntime, (sessionId) => {
         const goal = this.goalRuntime.get(sessionId);
@@ -270,6 +271,7 @@ export class NodeConnector {
         if (goal === undefined || session === undefined)
             return;
         if (goal.status !== 'active') {
+            this.nativeGoalBindings.delete(goal.id);
             this.retireGoalContinuation(sessionId);
             this.continuousRunCoordinator.removeGoalQueue(sessionId);
         }
@@ -384,11 +386,9 @@ export class NodeConnector {
                 failed: status === 'FAILED',
                 progressed: status !== 'SUCCEEDED' || progressed
             });
-            if (disposition === 'blocked' || disposition === 'paused') {
-                if (disposition === 'blocked')
-                    this.retireGoalContinuation(pending.sessionId);
-                else
-                    this.invalidateGoalContinuation(pending.sessionId);
+            if (disposition === 'blocked' || disposition === 'completed') {
+                this.nativeGoalBindings.delete(pending.goal.id);
+                this.retireGoalContinuation(pending.sessionId);
                 this.continuousRunCoordinator.removeGoalQueue(pending.sessionId);
                 const terminalGoal = this.goalRuntime.get(pending.sessionId);
                 const session = this.runtime.getAgentSession(pending.sessionId);
@@ -528,6 +528,7 @@ export class NodeConnector {
             promoteSession: (sessionId, nativeSessionId) => this.sessionIdentityService.promote(sessionId, nativeSessionId),
             send: (type, payload) => this.send(type, payload),
             emit: (runId, eventType, payload, status) => this.runEventBridge.emitRun(runId, eventType, payload, status),
+            nativeGoalUpdated: (runId, goal) => this.handleNativeGoalUpdate(runId, goal),
             cancel: (runId, threadId, turnId, cwd, status) => this.runnerInteractionService.cancelCodexTurn(runId, threadId, turnId, cwd, status),
             createApproval: (input) => this.runtime.createApproval(input),
             publishApproval: (input) => this.publishApprovalForRun(input),
@@ -985,6 +986,9 @@ export class NodeConnector {
                         goalAlreadyActive: true
                     };
                 if (existing !== undefined) {
+                    const previousGoal = this.goalRuntime.get(session.id);
+                    if (previousGoal !== undefined)
+                        this.nativeGoalBindings.delete(previousGoal.id);
                     this.goalRuntime.clear(session.id);
                     this.commandStates.clear(session.id, 'goal');
                 }
@@ -1476,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() {
@@ -1720,10 +1725,46 @@ export class NodeConnector {
         const current = this.goalRuntime.get(sessionId);
         return ((this.goalContinuationEpochs.get(sessionId) ?? 0) === goal.epoch &&
             current?.status === 'active' &&
-            !current.continuationPaused &&
             current.id === goal.id &&
             current.revision === goal.revision);
     }
+    handleNativeGoalUpdate(runId, nativeGoal) {
+        const pending = this.continuousRunCoordinator.pending(runId);
+        if (pending?.goal === undefined || !this.goalGenerationCurrent(pending.sessionId, pending.goal))
+            return;
+        const goal = this.goalRuntime.get(pending.sessionId);
+        if (nativeGoal.status === 'active') {
+            if ((nativeGoal.createdAt + 1) * 1_000 < goal.revisionStartedAt)
+                return;
+            const previous = this.nativeGoalBindings.get(goal.id);
+            if (previous !== undefined &&
+                previous.revision !== goal.revision &&
+                previous.threadId === nativeGoal.threadId &&
+                previous.createdAt === nativeGoal.createdAt &&
+                previous.objective === nativeGoal.objective)
+                return;
+            this.nativeGoalBindings.set(goal.id, {
+                revision: goal.revision,
+                threadId: nativeGoal.threadId,
+                createdAt: nativeGoal.createdAt,
+                objective: nativeGoal.objective
+            });
+            return;
+        }
+        const bound = this.nativeGoalBindings.get(goal.id);
+        if (bound?.revision !== goal.revision ||
+            bound.threadId !== nativeGoal.threadId ||
+            bound.createdAt !== nativeGoal.createdAt ||
+            bound.objective !== nativeGoal.objective)
+            return;
+        this.nativeGoalBindings.delete(goal.id);
+        const completed = this.goalRuntime.update(pending.sessionId, goal.id, goal.revision, 'completed');
+        this.retireGoalContinuation(pending.sessionId);
+        this.continuousRunCoordinator.removeGoalQueue(pending.sessionId);
+        const session = this.runtime.getAgentSession(pending.sessionId);
+        if (session !== undefined)
+            this.publishGoalState(session, completed);
+    }
     beginGoalSubmission(sessionId, continuationEpoch = this.goalContinuationEpochs.get(sessionId) ?? 0) {
         const attempt = { sessionId, epoch: continuationEpoch };
         const attempts = this.goalSubmissionAttempts.get(sessionId) ?? new Set();
@@ -1814,6 +1855,7 @@ export class NodeConnector {
                 this.clearGoalRetry(attempt.sessionId);
                 if (failedAttempts > 3) {
                     const blocked = this.goalRuntime.blockAfterRuntimeFailure(attempt.sessionId, input.goal.id, input.goal.revision);
+                    this.nativeGoalBindings.delete(input.goal.id);
                     this.continuousRunCoordinator.removeGoalQueue(attempt.sessionId);
                     this.goalContinuationEpochs.delete(attempt.sessionId);
                     this.finishIdleGoalRun(attempt.sessionId, 'FAILED');
@@ -1861,6 +1903,9 @@ export class NodeConnector {
     }
     clearGoalState(sessionId, status) {
         const goalExit = this.goalRuntime.exitSummary(sessionId, status);
+        const goal = this.goalRuntime.get(sessionId);
+        if (goal !== undefined)
+            this.nativeGoalBindings.delete(goal.id);
         this.retireGoalContinuation(sessionId);
         const removed = this.goalRuntime.clear(sessionId);
         this.continuousRunCoordinator.removeGoalQueue(sessionId);

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

@@ -142,6 +142,27 @@ export class CodexManagedRunController {
             this.host.emit(runId, 'run.running', { threadId, turnId }, 'RUNNING');
             return;
         }
+        if (notification.method === 'thread/goal/updated' &&
+            activeRun.goalMcp === true &&
+            turnId !== undefined &&
+            threadId !== undefined &&
+            isPlainRecord(params.goal) &&
+            params.goal.threadId === threadId &&
+            Number.isSafeInteger(params.goal.createdAt) &&
+            params.goal.createdAt > 0 &&
+            typeof params.goal.objective === 'string' &&
+            params.goal.objective.length <= 20_000 &&
+            (params.goal.status !== 'active' ||
+                (params.goal.tokensUsed === 0 && params.goal.timeUsedSeconds === 0)) &&
+            (params.goal.status === 'active' || params.goal.status === 'complete')) {
+            this.host.nativeGoalUpdated(runId, {
+                threadId,
+                createdAt: params.goal.createdAt,
+                objective: params.goal.objective,
+                status: params.goal.status === 'complete' ? 'completed' : 'active'
+            });
+            return;
+        }
         if (notification.requestId !== undefined &&
             (notification.method === 'item/commandExecution/requestApproval' ||
                 notification.method === 'item/fileChange/requestApproval')) {
@@ -364,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/goal-runtime.js

@@ -102,18 +102,19 @@ export class GoalRuntime {
             throw new Error('GOAL_OBJECTIVE_INVALID');
         const current = this.goals.get(sessionId);
         const continuing = current?.status === 'active';
+        const now = this.now();
         const goal = {
             id: continuing ? current.id : randomUUID(),
             sessionId,
             objective: normalized,
-            startedAt: continuing ? current.startedAt : this.now(),
+            startedAt: continuing ? current.startedAt : now,
+            revisionStartedAt: now,
             revision: continuing ? current.revision + 1 : 1,
             status: 'active',
             turns: 0,
             retryRequired: false,
             retryStartedAtTurn: null,
-            consecutiveNoProgressTurns: 0,
-            continuationPaused: false
+            consecutiveNoProgressTurns: 0
         };
         this.goals.set(sessionId, goal);
         this.executionFailures.delete(sessionId);
@@ -144,34 +145,32 @@ export class GoalRuntime {
         if (!input.failed && !input.progressed) {
             this.executionFailures.delete(sessionId);
             const consecutiveNoProgressTurns = current.consecutiveNoProgressTurns + 1;
-            const paused = consecutiveNoProgressTurns >= 3;
+            const completed = consecutiveNoProgressTurns >= 3;
             const goal = {
                 ...current,
                 consecutiveNoProgressTurns,
-                continuationPaused: paused
+                ...(completed ? { status: 'completed' } : {})
             };
             this.goals.set(sessionId, goal);
             this.changed(goal);
-            return paused ? 'paused' : 'continue';
+            return completed ? 'completed' : 'continue';
         }
         if (!input.failed) {
             this.executionFailures.delete(sessionId);
-            if (current.consecutiveNoProgressTurns > 0 || current.continuationPaused) {
+            if (current.consecutiveNoProgressTurns > 0) {
                 const goal = {
                     ...current,
-                    consecutiveNoProgressTurns: 0,
-                    continuationPaused: false
+                    consecutiveNoProgressTurns: 0
                 };
                 this.goals.set(sessionId, goal);
                 this.changed(goal);
             }
             return 'continue';
         }
-        if (current.consecutiveNoProgressTurns > 0 || current.continuationPaused) {
+        if (current.consecutiveNoProgressTurns > 0) {
             const goal = {
                 ...current,
-                consecutiveNoProgressTurns: 0,
-                continuationPaused: false
+                consecutiveNoProgressTurns: 0
             };
             this.goals.set(sessionId, goal);
         }
@@ -191,12 +190,11 @@ export class GoalRuntime {
         const current = this.goals.get(sessionId);
         if (current?.status !== 'active')
             return current;
-        if (!current.continuationPaused && current.consecutiveNoProgressTurns === 0)
+        if (current.consecutiveNoProgressTurns === 0)
             return current;
         const goal = {
             ...current,
-            consecutiveNoProgressTurns: 0,
-            continuationPaused: false
+            consecutiveNoProgressTurns: 0
         };
         this.goals.set(sessionId, goal);
         this.changed(goal);
@@ -247,7 +245,7 @@ export class GoalRuntime {
         const heading = kind === 'start' ? 'A Goal has started or changed.' : 'Continue the active Goal.';
         const open = kind === 'start' ? START_OPEN : CONTINUE_OPEN;
         const close = kind === 'start' ? START_CLOSE : CONTINUE_CLOSE;
-        return `${open}\n${heading}\n\nOriginal objective:\n${goal.objective}\n\nContinue executing this Goal across turns:\n- Work on the objective now. If it is incomplete, use tools to finish a coherent unit or obtain decisive evidence; do not stop at an acknowledgement, status, plan, or promise.\n- Preserve the original scope. Before completion, review the full objective and verify it with real evidence, then call mar_update_goal with status=completed.\n- Adapt and retry after individual failures. Request blocked only after the same blocker persists for three turns and the required additional retry.\n- Use mar_get_goal only when you need to reread the authoritative objective or status.\n- After mar_update_goal confirms completed or finally blocked, summarize the completed work, verification evidence, remaining issues, and the tool-reported elapsedWallMs converted from milliseconds into a concise readable duration in your final user-facing response. Name whether the Goal completed or is finally blocked. That elapsed time is wall-clock time through the status update, including waiting and retries, not tool execution time or time through this final response. If blocked returns active for the required retry, continue work instead of claiming a final summary.\n${close}`;
+        return `${open}\n${heading}\n\nOriginal objective:\n${goal.objective}\n\nContinue executing this Goal across turns:\n- This Goal is owned by the Node's myagentroam_goal MCP server. Prefer myagentroam_goal.mar_update_goal to complete it. In Codex, a runner-native Goal created during this Goal may also complete it when Codex reports that native Goal complete; native Goal state from another task or turn does not count. Do not claim completion based only on a final message or an unrelated Goal.\n- Work on the objective now. If it is incomplete, use tools to finish a coherent unit or obtain decisive evidence; do not stop at an acknowledgement, status, plan, or promise.\n- Preserve the original scope. Before completion, review the full objective and verify it with real evidence, then call mar_update_goal with status=completed when available.\n- Adapt and retry after individual failures. Request blocked only after the same blocker persists for three turns and the required additional retry.\n- Use mar_get_goal only when you need to reread the authoritative objective or status.\n- After mar_update_goal confirms completed or finally blocked, summarize the completed work, verification evidence, remaining issues, and the tool-reported elapsedWallMs converted from milliseconds into a concise readable duration in your final user-facing response. If Codex instead confirms completion with its native Goal, summarize the work without claiming a MAR elapsedWallMs value. Name whether the Goal completed or is finally blocked. MAR elapsedWallMs includes waiting and retries through the status update, not tool execution time or the final response. If blocked returns active for the required retry, continue work instead of claiming a final summary.\n${close}`;
     }
     requireCurrent(sessionId, goalId, revision) {
         const current = this.goals.get(sessionId);

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.130",
+  "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,9 +34,10 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/protocol": "0.9.130",
-    "@myagentroam/code-navigation": "0.9.129",
-    "@myagentroam/agent": "0.9.130"
+    "@myagentroam/marmgr": "0.9.115",
+    "@myagentroam/agent": "0.9.132",
+    "@myagentroam/protocol": "0.9.132",
+    "@myagentroam/code-navigation": "0.9.129"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"