@myagentroam/node 0.9.108 → 0.9.110

package/dist/capabilities.js

@@ -8,6 +8,7 @@ const nodeAppVersion = typeof nodePackage.version === 'string' ? nodePackage.ver
 const runtimeCredentialCapability = () => ({
     apiVersion: 1,
     websocket: true,
+    fastMode: true,
     httpVersions: ['1.1', '2']
 });
 const workspaceDirectTransferCapability = () => ({
@@ -19,6 +20,10 @@ const workspaceDirectTransferCapability = () => ({
     gitCommitBlob: true,
     maxChunkBytes: 256 * 1024
 });
+const terminalDirectCapability = () => ({
+    apiVersion: 1,
+    transport: true
+});
 export function reportedPlatform(platform = process.platform) {
     if (platform === 'win32')
         return 'windows';
@@ -47,7 +52,8 @@ export function unavailableCapabilities() {
         openCode: { available: false },
         marAgent: { available: true, version: nodeAppVersion },
         marAgentRuntimeCredentials: runtimeCredentialCapability(),
-        workspaceDirectTransfer: workspaceDirectTransferCapability()
+        workspaceDirectTransfer: workspaceDirectTransferCapability(),
+        terminalDirect: terminalDirectCapability()
     };
 }
 export function detectCapabilities(commands = {}) {
@@ -80,7 +86,8 @@ export function detectCapabilities(commands = {}) {
         },
         marAgent: { available: true, version: nodeAppVersion },
         marAgentRuntimeCredentials: runtimeCredentialCapability(),
-        workspaceDirectTransfer: workspaceDirectTransferCapability()
+        workspaceDirectTransfer: workspaceDirectTransferCapability(),
+        terminalDirect: terminalDirectCapability()
     };
 }
 export async function detectCapabilitiesAsync(commands = {}) {
@@ -117,6 +124,7 @@ export async function detectCapabilitiesAsync(commands = {}) {
         },
         marAgent: { available: true, version: nodeAppVersion },
         marAgentRuntimeCredentials: runtimeCredentialCapability(),
-        workspaceDirectTransfer: workspaceDirectTransferCapability()
+        workspaceDirectTransfer: workspaceDirectTransferCapability(),
+        terminalDirect: terminalDirectCapability()
     };
 }

package/dist/connector.js

@@ -1133,6 +1133,7 @@ export class NodeConnector {
             handleNodeRequest: (envelope) => this.nodeRequests.handle(envelope),
             handleRuntimeCredentialResponse: (envelope) => this.runtimeCredentials.handle(envelope),
             handleDirectTransfer: (envelope) => this.handleDirectTransfer(envelope),
+            handleTerminalDirect: (envelope) => this.handleTerminalDirect(envelope),
             reconcileRuns: (envelope) => this.runEventBridge.reconcile(envelope),
             runners: this.runners,
             deliverSessionChannelMessage: (envelope) => this.runnerChannelMessages.handle(envelope),
@@ -1456,6 +1457,9 @@ export class NodeConnector {
             return new DirectTransferService({
                 nodeGeneration: () => this.nodeGeneration,
                 send: (type, payload) => this.send(type, payload),
+                terminalManager: this.terminalManager,
+                sendTerminalReady: (directSessionId) => this.send('terminal.direct.ready', { directSessionId }),
+                sendTerminalTakeover: (directSessionId) => this.send('terminal.direct.takeover', { directSessionId }),
                 udpPortRange: () => directTransferUdpPortRange(this.config),
                 openUpload: async (descriptor) => {
                     if (descriptor.direction !== 'UPLOAD' || descriptor.resource.kind !== 'WORKSPACE_FILE')
@@ -1512,6 +1516,13 @@ export class NodeConnector {
         });
         return true;
     }
+    handleTerminalDirect(envelope) {
+        const command = {
+            type: envelope.type,
+            ...(typeof envelope.payload === 'object' && envelope.payload !== null ? envelope.payload : {})
+        };
+        return this.directTransferService?.handleTerminal(command) ?? false;
+    }
     clearMissionRetry(sessionId) {
         const retry = this.missionRetryTimers.get(sessionId);
         if (retry !== undefined)

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

@@ -64,6 +64,7 @@ export class MarAgentRuntimeModelFactory {
                     titleGeneration: configuration.titleGeneration,
                     codeMode: configuration.codeMode,
                     highDensityCompaction: configuration.highDensityCompaction,
+                    ...(configuration.fastMode === true ? { fastMode: true } : {}),
                     hostedWebSearch: configuration.hostedWebSearch,
                     ...(imageGeneration === undefined ? {} : { imageGeneration }),
                     ...(configuration.responsesTransport === undefined
@@ -107,6 +108,7 @@ export class MarAgentRuntimeModelFactory {
                         }
                         : {}),
                     responsesEncoding: configuration.responsesEncoding ?? 'STANDARD',
+                    codexCredential: true,
                     credentialProvider: provider
                 };
             });

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

@@ -17,7 +17,12 @@ export class MarAgentRunner extends AbstractRunner {
         this.homeDirectory = homeDirectory;
     }
     configureModels(value) {
-        this.#models = Array.isArray(value) ? value.filter(isModelSummary) : [];
+        this.#models = Array.isArray(value)
+            ? value.flatMap((model) => {
+                const parsed = marAgentNodeModelSummarySchema.safeParse(model);
+                return parsed.success ? [parsed.data] : [];
+            })
+            : [];
     }
     setSessionResourceReleaser(release) {
         this.#releaseSessionResources = release;
@@ -439,6 +444,3 @@ export class MarAgentRunner extends AbstractRunner {
 function firstSequenceForTurn(entries, turnId) {
     return entries.find((entry) => entry.kind === 'user' ? entry.turnId === turnId : entry.event.turnId === turnId)?.sequence;
 }
-function isModelSummary(value) {
-    return marAgentNodeModelSummarySchema.safeParse(value).success;
-}

package/dist/service/direct-transfer-service.js

@@ -1,4 +1,5 @@
 import { directDataControlFrameSchema, directNodeCommandSchema } from '@myagentroam/protocol';
+import { TerminalDirectService } from './terminal-direct-service.js';
 import { IceUdpMuxListener as NativeIceUdpMuxListener } from 'node-datachannel';
 import { RTCPeerConnection } from 'node-datachannel/polyfill';
 const MAX_HOST_CANDIDATES = 32;
@@ -18,6 +19,7 @@ export class DirectTransferService {
     peerConfiguration;
     leaseGraceMs;
     leaseCheckMs;
+    terminalDirect;
     disposed = false;
     constructor(options) {
         this.options = options;
@@ -37,6 +39,17 @@ export class DirectTransferService {
                 ((configuration) => new RTCPeerConnection(configuration));
         this.leaseGraceMs = options.leaseGraceMs ?? LEASE_GRACE_MS;
         this.leaseCheckMs = options.leaseCheckMs ?? LEASE_CHECK_MS;
+        if (options.terminalManager !== undefined)
+            this.terminalDirect = new TerminalDirectService(options.terminalManager, (id) => options.sendTerminalReady?.(id), (id) => options.sendTerminalTakeover?.(id), (command, peer) => {
+                const transport = this.transports.get(command.transportSessionId);
+                return (transport?.peer === peer &&
+                    transport.command.workbenchConnectionId === command.workbenchConnectionId &&
+                    transport.command.nodeGeneration === command.nodeGeneration &&
+                    command.nodeGeneration === options.nodeGeneration() &&
+                    peer.connectionState === 'connected' &&
+                    command.browserFingerprint === fingerprint(peer.remoteDescription?.sdp) &&
+                    command.nodeFingerprint === fingerprint(peer.localDescription?.sdp));
+            }, this.now);
     }
     handle(value) {
         const parsed = directNodeCommandSchema.safeParse(value);
@@ -54,7 +67,11 @@ export class DirectTransferService {
         });
         return true;
     }
+    handleTerminal(value) {
+        return this.terminalDirect?.handle(value, (id) => this.transports.get(id)?.peer) ?? false;
+    }
     close() {
+        this.terminalDirect?.close();
         for (const transfer of [...this.transfers.values()])
             void this.removeTransfer(transfer, 'DIRECT_NODE_STOPPED');
         for (const transport of [...this.transports.values()])
@@ -65,6 +82,7 @@ export class DirectTransferService {
             return;
         this.disposed = true;
         this.close();
+        this.terminalDirect?.dispose();
         this.iceUdpMuxListener.stop();
     }
     async dispatch(command) {
@@ -236,6 +254,12 @@ export class DirectTransferService {
             if (attached)
                 return;
             attached = true;
+            if (channel.label.startsWith('mar-terminal-')) {
+                this.terminalDirect?.open(transport.command.directSessionId, channel, event.data);
+                if (this.terminalDirect === undefined)
+                    channel.close();
+                return;
+            }
             void this.openChannel(transport, channel, event.data).catch((error) => {
                 channel.close();
                 const id = openFrameSessionId(event.data);
@@ -396,6 +420,7 @@ export class DirectTransferService {
         if (!this.transports.delete(transport.command.directSessionId))
             return;
         clearInterval(transport.leaseTimer);
+        this.terminalDirect?.removeTransport(transport.command.directSessionId);
         for (const transfer of [...this.transfers.values()])
             if (transfer.command.transportSessionId === transport.command.directSessionId)
                 void this.removeTransfer(transfer, code ?? 'DIRECT_CONNECTION_FAILED');

package/dist/service/hosted-conversation-node-service.js

@@ -2004,6 +2004,7 @@ function modelSummary(model, index) {
         titleGeneration: model.titleGeneration,
         codeMode: model.codeMode,
         highDensityCompaction: model.highDensityCompaction,
+        ...(model.fastMode === true ? { fastMode: true } : {}),
         hostedWebSearch: model.hostedWebSearch,
         ...(model.responsesTransport === undefined
             ? {}

package/dist/service/node-control-message-service.js

@@ -38,6 +38,9 @@ export class NodeControlMessageService {
         if (envelope.type.startsWith('direct.') &&
             this.options.handleDirectTransfer?.(envelope) === true)
             return;
+        if (envelope.type.startsWith('terminal.direct.') &&
+            this.options.handleTerminalDirect?.(envelope) === true)
+            return;
         if (envelope.type === 'ack')
             return;
         if (envelope.type === 'runs.reconcile') {

package/dist/service/terminal-direct-service.js

@@ -0,0 +1,202 @@
+import { terminalDataFrameSchema, terminalDirectNodeCommandSchema, terminalDirectOpenFrameSchema } from '@myagentroam/protocol';
+const MAX_SESSIONS = 128;
+const MAX_BUFFERED_BYTES = 1024 * 1024;
+const MAX_FRAME_BYTES = 128 * 1024;
+const HEARTBEAT_GRACE_MS = 30_000;
+export class TerminalDirectService {
+    manager;
+    sendReady;
+    sendTakeover;
+    verifyTransport;
+    sessions = new Map();
+    timer;
+    stopListening;
+    now;
+    constructor(manager, sendReady, sendTakeover, verifyTransport, now = Date.now) {
+        this.manager = manager;
+        this.sendReady = sendReady;
+        this.sendTakeover = sendTakeover;
+        this.verifyTransport = verifyTransport;
+        this.now = now;
+        this.stopListening = manager.onFrame((frame) => {
+            for (const session of this.sessions.values())
+                if (session.opened && session.command.terminalId === frame.terminalId)
+                    this.sendFrame(session, frame);
+        });
+        this.timer = setInterval(() => {
+            for (const session of [...this.sessions.values()])
+                if (session.expiresAt <= this.now() ||
+                    this.now() - session.lastHeartbeat > HEARTBEAT_GRACE_MS)
+                    this.remove(session);
+        }, 5_000);
+        this.timer.unref?.();
+    }
+    handle(value, getPeer) {
+        const parsed = terminalDirectNodeCommandSchema.safeParse(value);
+        if (!parsed.success)
+            return false;
+        const command = parsed.data;
+        if (command.type === 'terminal.direct.prepare') {
+            const peer = getPeer(command.transportSessionId);
+            if (peer === undefined ||
+                !this.verifyTransport(command, peer) ||
+                this.sessions.size >= MAX_SESSIONS ||
+                this.sessions.has(command.directSessionId) ||
+                command.openExpiresAt <= this.now() ||
+                command.expiresAt <= this.now())
+                return true;
+            this.sessions.set(command.directSessionId, {
+                command,
+                peer,
+                opened: false,
+                expiresAt: command.expiresAt,
+                lastHeartbeat: this.now()
+            });
+            this.sendReady(command.directSessionId);
+            return true;
+        }
+        const session = this.sessions.get(command.directSessionId);
+        if (session === undefined)
+            return true;
+        if (command.type === 'terminal.direct.cancel')
+            this.remove(session);
+        else if (session.expiresAt > this.now() && command.expiresAt > this.now()) {
+            session.expiresAt = command.expiresAt;
+            session.lastHeartbeat = this.now();
+        }
+        else
+            this.remove(session);
+        return true;
+    }
+    open(transportId, channel, raw) {
+        if (typeof raw !== 'string' || Buffer.byteLength(raw) > 4_096) {
+            channel.close();
+            return;
+        }
+        let parsed;
+        try {
+            parsed = terminalDirectOpenFrameSchema.safeParse(JSON.parse(raw));
+        }
+        catch {
+            channel.close();
+            return;
+        }
+        const session = parsed.success ? this.sessions.get(parsed.data.directSessionId) : undefined;
+        if (session === undefined ||
+            session.channel !== undefined ||
+            session.opened ||
+            session.command.transportSessionId !== transportId ||
+            session.command.grant !== (parsed.success ? parsed.data.grant : undefined) ||
+            session.command.openExpiresAt <= this.now() ||
+            session.expiresAt <= this.now() ||
+            !this.verifyTransport(session.command, session.peer)) {
+            channel.close();
+            return;
+        }
+        session.channel = channel;
+        channel.onclose = () => this.remove(session);
+        try {
+            const terminal = this.manager.get(session.command.terminalId);
+            if (terminal.state !== 'RUNNING' ||
+                terminal.workspaceId !== (session.command.workspaceId ?? null))
+                throw new Error('TERMINAL_NOT_FOUND');
+            const attachment = this.manager.authorizeAttach({
+                terminalId: session.command.terminalId,
+                afterSequence: session.command.afterSequence,
+                readonly: session.command.readonly,
+                takeover: session.command.takeover
+            });
+            session.attachmentId = attachment.attachmentId;
+            session.opened = true;
+            channel.send(JSON.stringify({
+                type: 'ATTACHED',
+                terminalId: session.command.terminalId,
+                afterSequence: session.command.afterSequence
+            }));
+            for (const frame of attachment.frames)
+                this.sendFrame(session, frame);
+            if (!session.command.readonly && session.command.takeover) {
+                for (const other of [...this.sessions.values()])
+                    if (other !== session &&
+                        other.opened &&
+                        !other.command.readonly &&
+                        other.command.terminalId === session.command.terminalId)
+                        this.remove(other, 'TERMINAL_RELAY_REPLACED');
+                this.sendTakeover(session.command.directSessionId);
+            }
+            channel.onmessage = (event) => this.accept(session, event.data);
+        }
+        catch {
+            this.remove(session, 'TERMINAL_ATTACH_FAILED');
+        }
+    }
+    removeTransport(transportId) {
+        for (const session of [...this.sessions.values()])
+            if (session.command.transportSessionId === transportId)
+                this.remove(session);
+    }
+    close() {
+        for (const session of [...this.sessions.values()])
+            this.remove(session);
+    }
+    dispose() {
+        this.close();
+        clearInterval(this.timer);
+        this.stopListening();
+    }
+    accept(session, raw) {
+        if (!session.opened ||
+            typeof raw !== 'string' ||
+            Buffer.byteLength(raw) > MAX_FRAME_BYTES ||
+            session.expiresAt <= this.now()) {
+            this.remove(session, 'TERMINAL_FRAME_REJECTED');
+            return;
+        }
+        try {
+            const frame = terminalDataFrameSchema.parse(JSON.parse(raw));
+            if (frame.terminalId !== session.command.terminalId ||
+                !['input', 'resize', 'close'].includes(frame.type) ||
+                session.attachmentId === undefined)
+                throw new Error('TERMINAL_FRAME_INVALID');
+            void this.manager
+                .acceptFrame(session.attachmentId, frame)
+                .catch(() => this.remove(session, 'TERMINAL_FRAME_REJECTED'));
+        }
+        catch {
+            this.remove(session, 'TERMINAL_FRAME_REJECTED');
+        }
+    }
+    sendFrame(session, frame) {
+        const channel = session.channel;
+        if (channel?.readyState !== 'open') {
+            this.remove(session);
+            return;
+        }
+        const value = JSON.stringify(frame);
+        if (channel.bufferedAmount + Buffer.byteLength(value) > MAX_BUFFERED_BYTES) {
+            this.remove(session, 'TERMINAL_BACKPRESSURE');
+            return;
+        }
+        try {
+            channel.send(value);
+        }
+        catch {
+            this.remove(session);
+        }
+    }
+    remove(session, code) {
+        if (!this.sessions.delete(session.command.directSessionId))
+            return;
+        if (session.attachmentId !== undefined)
+            this.manager.detach(session.attachmentId);
+        if (code !== undefined && session.channel?.readyState === 'open') {
+            try {
+                session.channel.send(JSON.stringify({ type: 'error', terminalId: session.command.terminalId, code }));
+            }
+            catch {
+                // A closing channel must not prevent attachment cleanup.
+            }
+        }
+        session.channel?.close();
+    }
+}

package/dist/service/terminal-service.js

@@ -26,7 +26,8 @@ export class TerminalService {
                         data?.__requestUserId)
             }),
             'terminal.close': (data) => this.close(data),
-            'terminal.attach.authorize': (data) => this.authorizeAttach(data)
+            'terminal.attach.authorize': (data) => this.authorizeAttach(data),
+            'terminal.direct.preflight': (data) => this.preflightDirect(data)
         };
     }
     open(data) {
@@ -82,6 +83,18 @@ export class TerminalService {
         const attachment = this.terminalManager.authorizeAttach(data);
         return { attachment, terminal: this.terminalManager.get(attachment.terminalId) };
     }
+    preflightDirect(data) {
+        if (data === null || typeof data !== 'object')
+            throw new Error('TERMINAL_ATTACH_INVALID');
+        const input = data;
+        this.assertOwner(input);
+        const terminal = this.terminalManager.get(String(input.terminalId));
+        if (terminal.state !== 'RUNNING')
+            throw new Error('TERMINAL_CLOSED');
+        if (terminal.workspaceId !== (input.workspaceId ?? null))
+            throw new Error('TERMINAL_WORKSPACE_MISMATCH');
+        return { terminalId: terminal.id, workspaceId: terminal.workspaceId };
+    }
     assertOwner(input) {
         const owner = this.gitOwners.get(String(input.terminalId));
         if (owner !== undefined && owner.userId !== input.__requestUserId)

package/dist/service/workbench-manifest-service.js

@@ -47,6 +47,7 @@ export class WorkbenchManifestService {
                 maxSearchResults: 200
             },
             directTransfer: capabilities.workspaceDirectTransfer,
+            terminalDirect: capabilities.terminalDirect,
             git: {
                 available: true,
                 reasonCode: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.108",
+  "version": "0.9.110",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -30,9 +30,9 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.9.108",
-    "@myagentroam/protocol": "0.9.108",
-    "@myagentroam/code-navigation": "0.9.108"
+    "@myagentroam/agent": "0.9.110",
+    "@myagentroam/code-navigation": "0.9.110",
+    "@myagentroam/protocol": "0.9.110"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"