@myagentroam/node 0.11.24 → 0.11.25

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

@@ -356,7 +356,8 @@ export class MarAgentConversationNormalizer {
             if (observation.id !== undefined)
                 this.#codeModeObservationIds.add(observation.id);
             this.#codeModeSourceCallIds.add(observation.source.callId);
-            items.push(...projected.map((item) => 'callId' in event ? { ...item, parentItemId: itemId('tool', event.callId) } : item));
+            // An execution/observation container does not own these public tool records.
+            items.push(...projected);
         }
         return items;
     }

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

@@ -102,7 +102,7 @@ export function projectMarAgentHistory(session, entries, options = {}) {
             const attachments = projected.generatedImages === undefined
                 ? []
                 : (options.registerGeneratedImages?.(event.sessionId, projected.generatedImages) ?? []);
-            replace(projectionTurn, historyItem(session, projectionTurn, projected.itemId, projected.kind, projected.status, attachments.length === 0 ? projected.payload : { ...projected.payload, attachments }, at, projected.permissionStop, projected.parentItemId));
+            replace(projectionTurn, historyItem(session, projectionTurn, projected.itemId, projected.kind, projected.status, attachments.length === 0 ? projected.payload : { ...projected.payload, attachments }, at, projected.permissionStop));
         }
     }
     return [...turns.values()];
@@ -129,13 +129,13 @@ function record(value) {
         ? value
         : undefined;
 }
-function historyItem(session, turn, id, kind, status, payload, at, permissionStop, parentItemId) {
+function historyItem(session, turn, id, kind, status, payload, at, permissionStop) {
     return {
         id,
         sessionId: session.id,
         turnId: turn.id,
         runId: turn.runId,
-        parentItemId: parentItemId ?? null,
+        parentItemId: null,
         sourceSequence: null,
         revision: 0,
         kind,

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

@@ -701,7 +701,6 @@ export class MarAgentManagedRunController {
                         []);
                 this.host.emitItem(runId, {
                     itemId: item.itemId,
-                    ...(item.parentItemId === undefined ? {} : { parentItemId: item.parentItemId }),
                     kind: item.kind,
                     status: item.status,
                     payload: attachments.length === 0 ? item.payload : { ...item.payload, attachments },

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

@@ -1,9 +1,11 @@
 import { createSocket } from 'node:dgram';
+import { isIP } from 'node:net';
 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;
+const LOOPBACK_CANDIDATE_PRIORITY = '2130706431';
 const MAX_ACTIVE_TRANSPORTS = 128;
 const MAX_ACTIVE_TRANSFERS = 128;
 const DATA_CHANNEL_HIGH_WATER_BYTES = 4 * 1024 * 1024;
@@ -159,6 +161,7 @@ export class DirectTransferService {
         };
         transport.leaseTimer = this.startLeaseWatch(() => transport.leaseExpiresAt, () => transport.lastLeaseAliveAt, () => this.removeTransport(transport, 'DIRECT_TRANSFER_CONTROL_UNAVAILABLE'));
         this.transports.set(command.directSessionId, transport);
+        const sentLoopbackAddresses = new Set();
         peer.onicecandidate = (event) => {
             const candidate = event.candidate;
             if (candidate === null) {
@@ -170,8 +173,29 @@ export class DirectTransferService {
                 return;
             }
             const json = candidate.toJSON();
-            if (typeof json.candidate !== 'string' ||
-                !acceptHostCandidate(json.candidate, transport.sentCandidateKeys))
+            if (typeof json.candidate !== 'string')
+                return;
+            const loopback = loopbackHostCandidate(json.candidate);
+            const loopbackAddress = loopback?.trim().split(/\s+/u)[4];
+            if (loopback !== undefined &&
+                loopbackAddress !== undefined &&
+                !sentLoopbackAddresses.has(loopbackAddress)) {
+                sentLoopbackAddresses.add(loopbackAddress);
+                if (acceptHostCandidate(loopback, transport.sentCandidateKeys))
+                    this.emit(command.directSessionId, {
+                        type: 'direct.signal',
+                        directSessionId: command.directSessionId,
+                        signal: {
+                            kind: 'CANDIDATE',
+                            candidate: {
+                                candidate: loopback,
+                                sdpMid: json.sdpMid ?? null,
+                                sdpMLineIndex: json.sdpMLineIndex ?? null
+                            }
+                        }
+                    });
+            }
+            if (!acceptHostCandidate(json.candidate, transport.sentCandidateKeys))
                 return;
             this.emit(command.directSessionId, {
                 type: 'direct.signal',
@@ -543,6 +567,19 @@ export function probeUdp4Port(port) {
         socket.bind({ port, address: '0.0.0.0', exclusive: true }, () => socket.close(() => resolve()));
     });
 }
+export function loopbackHostCandidate(candidate) {
+    if (!safeHostCandidate(candidate))
+        return undefined;
+    const address = candidate.trim().split(/\s+/u)[4];
+    const family = isIP(address ?? '');
+    const loopback = family === 4 ? '127.0.0.1' : family === 6 ? '::1' : undefined;
+    if (loopback === undefined || address === loopback)
+        return undefined;
+    const fields = candidate.trim().split(/\s+/u);
+    fields[3] = LOOPBACK_CANDIDATE_PRIORITY;
+    fields[4] = loopback;
+    return fields.join(' ');
+}
 export function fingerprint(sdp) {
     const match = sdp?.match(/^a=fingerprint:(sha-256 [A-F0-9:]+)\r?$/imu);
     return match?.[1];
@@ -583,20 +620,26 @@ function filterIceCandidates(sdp, accepted) {
     if (sdp === undefined)
         return { sdp: undefined };
     const included = new Set();
-    const lines = sdp.split(/\r?\n/u).filter((line) => {
+    const lines = sdp.split(/\r?\n/u).flatMap((line) => {
         if (!line.startsWith('a=candidate:'))
-            return true;
+            return [line];
         const candidate = line.slice(2);
         if (!safeHostCandidate(candidate))
-            return false;
-        const key = candidateKey(candidate);
-        if (key === undefined || included.has(key))
-            return false;
-        if (!accepted.has(key) && accepted.size >= MAX_HOST_CANDIDATES)
-            return false;
-        accepted.add(key);
-        included.add(key);
-        return true;
+            return [];
+        const loopback = loopbackHostCandidate(candidate);
+        const candidates = loopback === undefined ? [candidate] : [loopback, candidate];
+        const retained = [];
+        for (const value of candidates) {
+            const key = candidateKey(value);
+            if (key === undefined || included.has(key))
+                continue;
+            if (!accepted.has(key) && accepted.size >= MAX_HOST_CANDIDATES)
+                continue;
+            accepted.add(key);
+            included.add(key);
+            retained.push(`a=${value}`);
+        }
+        return retained;
     });
     return { sdp: lines.join('\r\n') };
 }

package/dist/service/workspace-file-manager-service.js

@@ -0,0 +1,49 @@
+import { spawn } from 'node:child_process';
+import { dirname } from 'node:path';
+import { resolveWorkspaceFileManagerTarget } from '../workspace.js';
+export function fileManagerInvocation(platform, target) {
+    if (platform === 'win32')
+        return {
+            command: 'explorer.exe',
+            args: target.kind === 'FILE' ? ['/select,', target.path] : [target.path]
+        };
+    if (platform === 'darwin')
+        return { command: 'open', args: target.kind === 'FILE' ? ['-R', target.path] : [target.path] };
+    if (platform === 'linux')
+        return {
+            command: 'xdg-open',
+            args: [target.kind === 'FILE' ? dirname(target.path) : target.path]
+        };
+    throw new Error('FILE_MANAGER_UNAVAILABLE');
+}
+export async function revealWorkspaceFileInFileManager(workspaceRoot, requestedPath, options = {}) {
+    const target = await resolveWorkspaceFileManagerTarget(workspaceRoot, requestedPath);
+    const platform = options.platform ?? process.platform;
+    const invocation = fileManagerInvocation(platform, target);
+    const spawnProcess = options.spawnProcess ?? spawn;
+    let child;
+    try {
+        child = spawnProcess(invocation.command, invocation.args, {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true
+        });
+        await new Promise((resolve, reject) => {
+            child.once('error', reject);
+            if (platform === 'win32')
+                child.once('spawn', () => resolve());
+            else
+                child.once('exit', (code) => {
+                    if (code === 0)
+                        resolve();
+                    else
+                        reject(new Error('FILE_MANAGER_UNAVAILABLE'));
+                });
+        });
+    }
+    catch (error) {
+        throw new Error('FILE_MANAGER_UNAVAILABLE', { cause: error });
+    }
+    child.unref();
+    return { revealed: true };
+}

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

@@ -2,6 +2,7 @@ import { basename, dirname, isAbsolute, relative, resolve, win32 } from 'node:pa
 import { lstat, realpath } from 'node:fs/promises';
 import { isComposerAttachmentResourcePath } from '@myagentroam/protocol';
 import { listWorkspaceFiles, mutateWorkspaceFile, normalizeFilePreviewPath, readAbsoluteFileContentRange, readWorkspaceFileContentRange, readAbsoluteTextFile, readWorkspaceTextFile, writeWorkspaceTextFile, WorkspaceFileIndex } from '../workspace.js';
+import { revealWorkspaceFileInFileManager } from './workspace-file-manager-service.js';
 const INDEX_CACHE_LIMIT = 32;
 const INDEX_CACHE_BYTE_LIMIT = 128 * 1024 * 1024;
 const INDEX_QUEUE_LIMIT = 16;
@@ -224,6 +225,11 @@ export class WorkspaceFileService {
             return result;
         });
     }
+    async reveal(workspace, input) {
+        if (typeof input.path !== 'string')
+            throw new Error('FILE_REVEAL_INVALID');
+        return revealWorkspaceFileInFileManager(workspace.path, input.path);
+    }
     async serializeMutation(workspaceId, operation) {
         const previous = this.mutationTails.get(workspaceId) ?? Promise.resolve();
         const result = previous.then(operation, operation);

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

@@ -41,6 +41,10 @@ export class WorkspaceWorkbenchService {
             'workspace.file.direct.metadata': (data) => this.directFileMetadata(record(data)),
             'workspace.files.search': (data) => this.searchFiles(record(data)),
             'workspace.files.mutate': (data) => this.mutateFile(record(data)),
+            'workspace.files.reveal': (data) => {
+                const input = record(data);
+                return this.options.files.reveal(this.options.requireWorkspace(input.workspaceId), input);
+            },
             'workspace.content.search': (data) => this.searchContent(record(data)),
             'workspace.symbol.prepare': (data) => this.prepareSymbolIndex(record(data)),
             'workspace.symbol.definition': (data) => this.symbolDefinition(record(data)),

package/dist/workspace.js

@@ -1084,6 +1084,15 @@ async function resolveWorkspaceEntryMetadata(root, requestedPath) {
     const metadata = await lstat(candidate);
     return { path: candidate, metadata };
 }
+export async function resolveWorkspaceFileManagerTarget(workspaceRoot, requestedPath) {
+    const root = await resolveRegisteredWorkspaceRoot(workspaceRoot);
+    const entry = await resolveWorkspaceEntryMetadata(root, requestedPath);
+    if (entry.metadata.isDirectory())
+        return { path: entry.path, kind: 'DIRECTORY' };
+    if (entry.metadata.isFile())
+        return { path: entry.path, kind: 'FILE' };
+    throw new Error('FILE_NOT_REGULAR');
+}
 async function inspectWorkspaceIndexEntry(root, requestedPath, name, excludes) {
     try {
         const entry = await resolveWorkspaceEntryMetadata(root, requestedPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.11.24",
+  "version": "0.11.25",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -37,10 +37,10 @@
     "playwright": "1.62.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.11.24",
-    "@myagentroam/code-navigation": "0.11.0",
-    "@myagentroam/protocol": "0.11.24",
-    "@myagentroam/marctl": "0.11.1"
+    "@myagentroam/agent": "0.11.25",
+    "@myagentroam/protocol": "0.11.25",
+    "@myagentroam/marctl": "0.11.1",
+    "@myagentroam/code-navigation": "0.11.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"