@myagentroam/node 0.10.1 → 0.10.3

package/dist/config.d.ts

@@ -0,0 +1,43 @@
+export interface ConversationHostingConfig {
+    readonly enabled: boolean;
+    /** Relative directory inside dataDirectory. */
+    readonly storeDirectory?: string;
+    readonly inactiveRetentionDays?: number;
+}
+export interface DirectTransferConfig {
+    readonly udpPortRangeBegin: number;
+    readonly udpPortRangeEnd: number;
+}
+export interface DirectTransferUdpPortRange {
+    readonly begin: number;
+    readonly end: number;
+}
+export interface ComputerUseConfig {
+    readonly enabled: boolean;
+    /** Development/validation override; production distributions use the managed runtime path. */
+    readonly runtimeExecutable?: string;
+}
+export interface NodeConfig {
+    readonly serverUrl: string;
+    /** Explicit roots or the platform default resolved while loading the config. */
+    readonly allowedRoots: readonly string[];
+    /** Absolute or config-relative root for SQLite, upgrades and other private Node data. */
+    readonly dataDirectory?: string;
+    readonly conversationHosting?: ConversationHostingConfig;
+    readonly directTransfer?: DirectTransferConfig;
+    readonly computerUse?: ComputerUseConfig;
+    readonly nodeId?: string;
+    readonly credential?: string;
+    readonly registrationToken?: string;
+}
+export declare function nodeConfigPath(): string;
+export declare function loadNodeConfig(path?: string): Promise<NodeConfig>;
+export declare function directTransferUdpPortRange(config: Pick<NodeConfig, 'directTransfer'> | undefined): DirectTransferUdpPortRange;
+/** Uses the Node service account's scope when no Workspace roots are configured. */
+export declare function defaultAllowedRoots(platform?: NodeJS.Platform, homePath?: string, currentDirectory?: string): readonly string[];
+export declare function nodeDatabasePath(config: NodeConfig, configPath?: string): string;
+export declare function nodeDataDirectory(config: NodeConfig, configPath?: string): string;
+export declare function computerUseRuntimeExecutable(config: NodeConfig, configPath?: string, platform?: NodeJS.Platform, architecture?: string): string | undefined;
+export declare function hostedConversationStorePath(config: NodeConfig, configPath?: string): string | undefined;
+/** Credentials are always written with owner-only POSIX permissions where supported. */
+export declare function saveNodeConfig(config: NodeConfig, path?: string): Promise<void>;

package/dist/config.js

@@ -1,4 +1,5 @@
-import { chmod, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { chmod, mkdir, readFile, rename, rm, writeFile } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
 import { homedir } from 'node:os';
 import { dirname, isAbsolute, relative, resolve, sep, win32 } from 'node:path';
 import { computerUseRuntimeVersion } from './computer-use-runtime-version.js';
@@ -87,9 +88,18 @@ export function hostedConversationStorePath(config, configPath = nodeConfigPath(
 /** Credentials are always written with owner-only POSIX permissions where supported. */
 export async function saveNodeConfig(config, path = nodeConfigPath()) {
     await mkdir(dirname(path), { recursive: true, mode: 0o700 });
-    await writeFile(path, `${JSON.stringify(config, undefined, 2)}\n`, { mode: 0o600 });
-    if (process.platform !== 'win32') {
-        await chmod(path, 0o600);
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(config, undefined, 2)}\n`, {
+            mode: 0o600,
+            flag: 'wx'
+        });
+        if (process.platform !== 'win32')
+            await chmod(temporary, 0o600);
+        await rename(temporary, path);
+    }
+    finally {
+        await rm(temporary, { force: true });
     }
 }
 function parseConversationHosting(value) {

package/dist/connector.js

@@ -1684,7 +1684,7 @@ export class NodeConnector {
                 nodeGeneration: () => this.nodeGeneration,
                 send: (type, payload) => this.send(type, payload),
                 terminalManager: this.terminalManager,
-                sendTerminalReady: (directSessionId) => this.send('terminal.direct.ready', { directSessionId }),
+                sendTerminalReady: (directSessionId, phase) => this.send('terminal.direct.ready', { directSessionId, ...(phase ? { phase } : {}) }),
                 udpPortRange: () => directTransferUdpPortRange(this.config),
                 openUpload: async (descriptor) => {
                     if (descriptor.direction !== 'UPLOAD' || descriptor.resource.kind !== 'WORKSPACE_FILE')

package/dist/main.js

@@ -17,10 +17,13 @@ if (command === 'run') {
     const { NodeConnector } = await import('./connector.js');
     configureNodeLog(nodeDataDirectory(await loadNodeConfig(config), config));
     const connector = new NodeConnector({ configPath: config });
-    await connector.start();
+    const shutdown = () => {
+        void connector.stop().finally(() => process.exit(0));
+    };
     for (const signal of ['SIGINT', 'SIGTERM']) {
-        process.once(signal, () => connector.stop());
+        process.once(signal, shutdown);
     }
+    await connector.start();
 }
 else if (command === 'supervise') {
     if (process.argv[1] === undefined)

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

@@ -47,7 +47,7 @@ export class DirectTransferService {
         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), (command, peer) => {
+            this.terminalDirect = new TerminalDirectService(options.terminalManager, (id, phase) => options.sendTerminalReady?.(id, phase), (command, peer) => {
                 const transport = this.transports.get(command.transportSessionId);
                 return (transport?.peer === peer &&
                     transport.command.workbenchConnectionId === command.workbenchConnectionId &&

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

@@ -114,6 +114,9 @@ export class TerminalDirectService {
                 this.sendFrame(session, frame);
             channel.onmessage = (event) => this.accept(session, event.data);
             this.manager.startCommand(session.command.terminalId);
+            void Promise.resolve()
+                .then(() => this.sendReady(session.command.directSessionId, 'ATTACHED'))
+                .catch(() => console.warn('AUDIT_RECEIPT_UNAVAILABLE'));
         }
         catch (error) {
             this.remove(session, error instanceof Error && error.message === 'TERMINAL_ATTACH_CONFLICT'

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

@@ -44,8 +44,8 @@ export class WorkspaceQueueWorkbenchService {
             version: queue.version,
             paused: queue.paused,
             items: queue.itemIds.flatMap((itemId) => {
-                const item = this.options.runtime.getQueueItem(itemId);
-                if (item === undefined || item.clientMessageId.startsWith('goal:'))
+                const item = this.publicQueueItem(itemId);
+                if (item === undefined)
                     return [];
                 const session = this.options.runtime.getAgentSession(item.sessionId);
                 return [
@@ -89,7 +89,16 @@ export class WorkspaceQueueWorkbenchService {
             throw new Error('QUEUE_INVALID');
         const session = this.requireSession(input);
         assertSessionControlOwner(this.options.runtime, session.id, input.__requestUserId);
-        this.options.runtime.reorderSessionQueue(session.id, input.expectedVersion, input.queueItemIds);
+        const current = this.options.runtime.sessionQueue(session.id);
+        const publicItemIds = new Set(current.itemIds.filter((itemId) => this.publicQueueItem(itemId) !== undefined));
+        const reorderedIds = input.queueItemIds;
+        if (reorderedIds.length !== publicItemIds.size ||
+            new Set(reorderedIds).size !== reorderedIds.length ||
+            reorderedIds.some((itemId) => !publicItemIds.has(itemId)))
+            throw new Error('QUEUE_VERSION_CONFLICT');
+        let index = 0;
+        // Reorder only public slots, leaving internal continuations in place.
+        this.options.runtime.reorderSessionQueue(session.id, input.expectedVersion, current.itemIds.map((itemId) => (publicItemIds.has(itemId) ? reorderedIds[index++] : itemId)));
         this.options.emit(session.workspaceId, session.id);
         return {
             queue: this.present(session.workspaceId, session.id),
@@ -151,6 +160,10 @@ export class WorkspaceQueueWorkbenchService {
             throw new Error('SESSION_NOT_FOUND');
         return session;
     }
+    publicQueueItem(itemId) {
+        const item = this.options.runtime.getQueueItem(itemId);
+        return item?.clientMessageId.startsWith('goal:') ? undefined : item;
+    }
     requireItem(itemId, workspaceId) {
         const item = this.options.runtime.getQueueItem(itemId);
         if (item === undefined)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -9,6 +9,7 @@
     "scripts/install-web-browser.mjs",
     "vendor/ripgrep/**/*",
     "vendor/ctags/**/*",
+    "dist/config.d.ts",
     "LICENSE",
     "NOTICE"
   ],
@@ -36,14 +37,22 @@
     "playwright": "1.62.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/agent": "0.10.1",
-    "@myagentroam/protocol": "0.10.1",
+    "@myagentroam/agent": "0.10.3",
+    "@myagentroam/code-navigation": "0.10.1",
     "@myagentroam/marctl": "0.10.1",
-    "@myagentroam/code-navigation": "0.10.1"
+    "@myagentroam/protocol": "0.10.3"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"
   },
+  "exports": {
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
+    "./cli": "./dist/main.js",
+    "./package.json": "./package.json"
+  },
   "scripts": {
     "postinstall": "node scripts/install-web-browser.mjs",
     "build": "node ../scripts/clean-build-output.mjs dist && tsc -p tsconfig.json",