@myagentroam/node 0.1.2 → 0.1.4

package/dist/service/native-session-watch-service.js

@@ -0,0 +1,151 @@
+import { isPlainRecord } from '../runner/codex/conversation-parser.js';
+const INTERVAL_MS = 2_000;
+const TTL_MS = 45_000;
+const MAX_FAILURES = 3;
+const INITIAL_TURN_LIMIT = 30;
+export class NativeSessionWatchService {
+    options;
+    watches = new Map();
+    constructor(options) {
+        this.options = options;
+    }
+    operations() {
+        return {
+            'session.watch': (data) => this.executeWatch(isPlainRecord(data) ? data : {})
+        };
+    }
+    async executeWatch(input) {
+        if (typeof input.sessionId !== 'string' || (input.mode !== 'initial' && input.mode !== 'renew'))
+            throw new Error('SESSION_INVALID');
+        const session = await this.options.resolve(input.sessionId);
+        if (session === undefined || session.externalSessionId === null)
+            throw new Error('SESSION_NOT_FOUND');
+        if (input.mode === 'renew') {
+            const watch = this.renew(session);
+            if (watch === undefined)
+                throw new Error('SESSION_WATCH_NOT_FOUND');
+            return { renewed: true };
+        }
+        const watch = this.watch(session);
+        const snapshot = watch === undefined ? undefined : await this.refresh(session.id, INITIAL_TURN_LIMIT);
+        if (watch !== undefined && snapshot === undefined)
+            throw new Error('NATIVE_TRANSCRIPT_UNAVAILABLE');
+        return {
+            session: this.options.present(session),
+            watch: watch === undefined ? null : { expiresAt: watch.expiresAt },
+            ...(snapshot === undefined ? {} : { snapshot })
+        };
+    }
+    watch(session) {
+        if (this.options.managedActive(session)) {
+            this.stop(session.id);
+            return undefined;
+        }
+        const existing = this.watches.get(session.id);
+        if (existing !== undefined) {
+            existing.expiresAt = Date.now() + TTL_MS;
+            return { expiresAt: existing.expiresAt };
+        }
+        const watch = {
+            expiresAt: Date.now() + TTL_MS,
+            refresh: undefined,
+            sessionSignature: undefined,
+            signature: undefined,
+            failures: 0,
+            timer: undefined
+        };
+        watch.timer = setInterval(() => void this.refresh(session.id), INTERVAL_MS);
+        watch.timer.unref();
+        this.watches.set(session.id, watch);
+        return { expiresAt: watch.expiresAt };
+    }
+    renew(session) {
+        if (this.options.managedActive(session)) {
+            this.stop(session.id);
+            return undefined;
+        }
+        const watch = this.watches.get(session.id);
+        if (watch === undefined || watch.expiresAt <= Date.now()) {
+            this.stop(session.id);
+            return undefined;
+        }
+        watch.expiresAt = Date.now() + TTL_MS;
+        return { expiresAt: watch.expiresAt };
+    }
+    stop(sessionId) {
+        const watch = this.watches.get(sessionId);
+        if (watch === undefined)
+            return;
+        clearInterval(watch.timer);
+        this.watches.delete(sessionId);
+    }
+    clear() {
+        for (const watch of this.watches.values())
+            clearInterval(watch.timer);
+        this.watches.clear();
+    }
+    has(sessionId) {
+        return this.watches.has(sessionId);
+    }
+    entry(sessionId) {
+        return this.watches.get(sessionId);
+    }
+    get size() {
+        return this.watches.size;
+    }
+    async refresh(sessionId, limit = 10) {
+        const watch = this.watches.get(sessionId);
+        if (watch === undefined)
+            return undefined;
+        if (watch.refresh !== undefined)
+            return watch.refresh;
+        if (watch.expiresAt <= Date.now()) {
+            this.stop(sessionId);
+            return undefined;
+        }
+        const refresh = this.performRefresh(sessionId, watch, limit);
+        watch.refresh = refresh;
+        try {
+            return await refresh;
+        }
+        finally {
+            if (this.watches.get(sessionId) === watch)
+                watch.refresh = undefined;
+        }
+    }
+    async performRefresh(sessionId, watch, limit) {
+        try {
+            const session = await this.options.resolve(sessionId);
+            if (session === undefined ||
+                session.externalSessionId === null ||
+                this.options.managedActive(session)) {
+                this.stop(sessionId);
+                return undefined;
+            }
+            await this.options.refreshActivity(session);
+            const presented = this.options.present(session);
+            const sessionSignature = JSON.stringify(presented);
+            if (sessionSignature !== watch.sessionSignature) {
+                watch.sessionSignature = sessionSignature;
+                this.options.emitSession(presented);
+            }
+            const page = await this.options.readPage(session, limit);
+            watch.failures = 0;
+            const turns = page.turns.length <= 10 ? page.turns : page.turns.slice(0, 10);
+            const signature = JSON.stringify(turns);
+            if (signature === watch.signature)
+                return page;
+            watch.signature = signature;
+            for (const turn of turns)
+                this.options.emitTurn(turn);
+            return page;
+        }
+        catch {
+            watch.failures += 1;
+            if (watch.failures >= MAX_FAILURES)
+                this.stop(sessionId);
+            return undefined;
+        }
+    }
+}
+//# sourceMappingURL=native-session-watch-service.js.map

package/dist/service/native-session-watch-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-session-watch-service.js","sourceRoot":"","sources":["../../src/service/native-session-watch-service.ts"],"names":[],"mappings":"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"}

package/dist/service/node-connection-lifecycle-service.d.ts

@@ -0,0 +1,37 @@
+import type { NodeCapabilities } from '@myagentroam/protocol';
+import { type NodeConfig } from '../config.js';
+import type { NodeMetrics } from '../operational.js';
+import type { NodeControlChannel } from './node-control-channel.js';
+import type { NodeTerminalChannel } from './node-terminal-channel.js';
+import type { WorkbenchEventService } from './workbench-event-service.js';
+interface NodeConnectionLifecycleServiceOptions {
+    readonly config: () => NodeConfig | undefined;
+    readonly setConfig: (config: NodeConfig) => void;
+    readonly configPath: string | undefined;
+    readonly capabilities: () => NodeCapabilities;
+    readonly detectCapabilities: () => NodeCapabilities | Promise<NodeCapabilities>;
+    readonly capabilitiesProvided: boolean;
+    readonly stopped: () => boolean;
+    readonly setCapabilities: (capabilities: NodeCapabilities) => void;
+    readonly control: NodeControlChannel;
+    readonly terminal: NodeTerminalChannel;
+    readonly events: WorkbenchEventService;
+    readonly metrics: NodeMetrics;
+    readonly heartbeatMs: number;
+    readonly refreshMs: number;
+}
+/** Owns registration completion, heartbeat and background capability refresh timers. */
+export declare class NodeConnectionLifecycleService {
+    private readonly options;
+    private heartbeat;
+    private refreshTimer;
+    private refreshing;
+    constructor(options: NodeConnectionLifecycleServiceOptions);
+    start(): void;
+    startCapabilityRefresh(): void;
+    stop(): void;
+    register(nodeId: string, credential: string): Promise<void>;
+    connected(): void;
+    refreshCapabilities(): Promise<void>;
+}
+export {};

package/dist/service/node-connection-lifecycle-service.js

@@ -0,0 +1,84 @@
+import { saveNodeConfig } from '../config.js';
+/** Owns registration completion, heartbeat and background capability refresh timers. */
+export class NodeConnectionLifecycleService {
+    options;
+    heartbeat;
+    refreshTimer;
+    refreshing = false;
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        this.startCapabilityRefresh();
+    }
+    startCapabilityRefresh() {
+        if (this.refreshTimer !== undefined)
+            clearInterval(this.refreshTimer);
+        if (!this.options.capabilitiesProvided)
+            void this.refreshCapabilities();
+        this.refreshTimer = setInterval(() => void this.refreshCapabilities(), this.options.refreshMs);
+    }
+    stop() {
+        if (this.heartbeat !== undefined)
+            clearInterval(this.heartbeat);
+        if (this.refreshTimer !== undefined)
+            clearInterval(this.refreshTimer);
+        this.heartbeat = undefined;
+        this.refreshTimer = undefined;
+    }
+    async register(nodeId, credential) {
+        const config = this.options.config();
+        if (config === undefined)
+            return;
+        const registered = {
+            serverUrl: config.serverUrl,
+            allowedRoots: config.allowedRoots,
+            ...(config.databasePath === undefined ? {} : { databasePath: config.databasePath }),
+            nodeId,
+            credential
+        };
+        this.options.setConfig(registered);
+        await saveNodeConfig(registered, this.options.configPath);
+        this.connected();
+    }
+    connected() {
+        if (this.heartbeat !== undefined)
+            clearInterval(this.heartbeat);
+        this.options.control.send('capabilities', this.options.capabilities());
+        this.options.terminal.connect();
+        this.options.control.send('heartbeat', {});
+        this.options.metrics.heartbeatSent();
+        this.options.events.replay();
+        this.heartbeat = setInterval(() => {
+            this.options.metrics.heartbeatSent();
+            this.options.control.send('heartbeat', {});
+        }, this.options.heartbeatMs);
+    }
+    async refreshCapabilities() {
+        if (this.options.stopped() || this.refreshing)
+            return;
+        this.refreshing = true;
+        try {
+            let next;
+            try {
+                next = await this.options.detectCapabilities();
+            }
+            catch {
+                next = {
+                    ...this.options.capabilities(),
+                    codex: { available: false },
+                    claudeCode: { available: false }
+                };
+            }
+            if (this.options.stopped() ||
+                JSON.stringify(next) === JSON.stringify(this.options.capabilities()))
+                return;
+            this.options.setCapabilities(next);
+            this.options.control.send('capabilities', next);
+        }
+        finally {
+            this.refreshing = false;
+        }
+    }
+}
+//# sourceMappingURL=node-connection-lifecycle-service.js.map

package/dist/service/node-connection-lifecycle-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-connection-lifecycle-service.js","sourceRoot":"","sources":["../../src/service/node-connection-lifecycle-service.ts"],"names":[],"mappings":"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"}

package/dist/service/node-control-channel.d.ts

@@ -0,0 +1,32 @@
+import WebSocket from 'ws';
+import { type NodeCapabilities, type NodeEnvelope } from '@myagentroam/protocol';
+import type { NodeConfig } from '../config.js';
+interface NodeControlChannelOptions {
+    readonly config: () => NodeConfig | undefined;
+    readonly capabilities: () => NodeCapabilities;
+    readonly stopped: () => boolean;
+    readonly reconnect: boolean;
+    readonly reconnectDelay: (attempt: number) => number;
+    readonly onConnecting: (attempt: number) => void;
+    readonly onReconnectScheduled: () => void;
+    readonly onMessage: (raw: string) => void;
+    readonly onClose: (code: number) => void;
+}
+export declare class NodeControlChannel {
+    private readonly options;
+    private socket;
+    private readonly outbound;
+    private reconnectTimer;
+    private attempts;
+    constructor(options: NodeControlChannelOptions);
+    connect(): void;
+    connected(): boolean;
+    /** Keeps transport injection at the transport boundary for contract tests. */
+    replaceSocketForTesting(socket: WebSocket | undefined): void;
+    close(code?: number, reason?: string): void;
+    stop(): void;
+    send(type: string, payload: unknown, replyTo?: string): void;
+    sendEnvelope(envelope: NodeEnvelope): void;
+    private scheduleReconnect;
+}
+export {};

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

@@ -0,0 +1,84 @@
+import WebSocket from 'ws';
+import { createEnvelope } from '@myagentroam/protocol';
+import { ControlOutboundScheduler } from '../control-outbound-scheduler.js';
+import { nodeConnectEndpoint } from '../runner/codex/conversation-parser.js';
+export class NodeControlChannel {
+    options;
+    socket;
+    outbound = new ControlOutboundScheduler(() => this.socket);
+    reconnectTimer;
+    attempts = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    connect() {
+        const config = this.options.config();
+        if (config === undefined ||
+            this.options.stopped() ||
+            (this.socket !== undefined &&
+                (this.socket.readyState === WebSocket.OPEN ||
+                    this.socket.readyState === WebSocket.CONNECTING)))
+            return;
+        this.options.onConnecting(this.attempts);
+        const socket = new WebSocket(nodeConnectEndpoint(config.serverUrl));
+        this.socket = socket;
+        socket.once('open', () => {
+            this.attempts = 0;
+            if (config.nodeId !== undefined && config.credential !== undefined)
+                this.send('authenticate', { nodeId: config.nodeId, credential: config.credential });
+            else if (config.registrationToken !== undefined)
+                this.send('register', {
+                    registrationToken: config.registrationToken,
+                    capabilities: this.options.capabilities()
+                });
+            else
+                socket.close(4000, 'NODE_CREDENTIAL_MISSING');
+        });
+        socket.on('message', (raw) => this.options.onMessage(raw.toString()));
+        socket.once('close', (code) => {
+            if (this.socket !== socket)
+                return;
+            this.socket = undefined;
+            this.outbound.reset();
+            this.options.onClose(code);
+            this.scheduleReconnect();
+        });
+        socket.once('error', () => undefined);
+    }
+    connected() {
+        return this.socket?.readyState === WebSocket.OPEN;
+    }
+    /** Keeps transport injection at the transport boundary for contract tests. */
+    replaceSocketForTesting(socket) {
+        this.socket = socket;
+    }
+    close(code, reason) {
+        this.socket?.close(code, reason);
+    }
+    stop() {
+        if (this.reconnectTimer !== undefined)
+            clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = undefined;
+        this.outbound.reset();
+        this.socket?.close();
+        this.socket = undefined;
+    }
+    send(type, payload, replyTo) {
+        this.sendEnvelope(createEnvelope(type, payload, { ...(replyTo === undefined ? {} : { replyTo }) }));
+    }
+    sendEnvelope(envelope) {
+        if (!this.connected())
+            return;
+        this.outbound.enqueue(envelope, envelope.type === 'workbench.event' ? 'normal' : 'high');
+    }
+    scheduleReconnect() {
+        if (this.options.stopped() || !this.options.reconnect || this.reconnectTimer !== undefined)
+            return;
+        this.options.onReconnectScheduled();
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            this.connect();
+        }, this.options.reconnectDelay(this.attempts++));
+    }
+}
+//# sourceMappingURL=node-control-channel.js.map

package/dist/service/node-control-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-control-channel.js","sourceRoot":"","sources":["../../src/service/node-control-channel.ts"],"names":[],"mappings":"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"}

package/dist/service/node-control-message-service.d.ts

@@ -0,0 +1,28 @@
+import { type NodeEnvelope } from '@myagentroam/protocol';
+import type { NodeConfig } from '../config.js';
+import type { RunnerRegistry } from '../runner/runner-registry.js';
+interface NodeControlMessageServiceOptions {
+    readonly config: () => NodeConfig | undefined;
+    readonly register: (nodeId: string, credential: string) => Promise<void>;
+    readonly connected: () => void;
+    readonly close: (code: number, reason: string) => void;
+    readonly inspectWorkspace: (envelope: NodeEnvelope) => Promise<void>;
+    readonly handleNodeRequest: (envelope: NodeEnvelope) => Promise<void>;
+    readonly acknowledgeWorkbenchEvent: (replyTo: string | undefined) => void;
+    readonly reconcileRuns: (envelope: NodeEnvelope) => void;
+    readonly runners: RunnerRegistry;
+    readonly deliverSessionChannelMessage: (envelope: NodeEnvelope) => void;
+    readonly completeUncontrolledCancellation: (runId: string) => void;
+    readonly send: (type: string, payload: unknown, replyTo?: string) => void;
+}
+/** Owns parsing and dispatch of the closed Node control-message protocol. */
+export declare class NodeControlMessageService {
+    private readonly options;
+    constructor(options: NodeControlMessageServiceOptions);
+    handle(raw: string): void;
+    private dispatch;
+    private register;
+    private decideApproval;
+    private cancelRun;
+}
+export {};

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

@@ -0,0 +1,105 @@
+import { nodeEnvelopeSchema } from '@myagentroam/protocol';
+/** Owns parsing and dispatch of the closed Node control-message protocol. */
+export class NodeControlMessageService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    handle(raw) {
+        let envelope;
+        try {
+            envelope = nodeEnvelopeSchema.parse(JSON.parse(raw));
+        }
+        catch {
+            this.options.close(4002, 'MESSAGE_INVALID');
+            return;
+        }
+        this.dispatch(envelope);
+    }
+    dispatch(envelope) {
+        if (envelope.type === 'registered') {
+            this.register(envelope);
+            return;
+        }
+        if (envelope.type === 'authenticated') {
+            this.options.connected();
+            return;
+        }
+        if (envelope.type === 'workspace.inspect') {
+            void this.options.inspectWorkspace(envelope);
+            return;
+        }
+        if (envelope.type === 'node.request') {
+            void this.options.handleNodeRequest(envelope);
+            return;
+        }
+        if (envelope.type === 'ack') {
+            const payload = envelope.payload;
+            if (payload.type === 'workbench.event')
+                this.options.acknowledgeWorkbenchEvent(envelope.replyTo);
+            return;
+        }
+        if (envelope.type === 'runs.reconcile') {
+            this.options.reconcileRuns(envelope);
+            return;
+        }
+        if (envelope.type === 'run.approval.decision') {
+            this.decideApproval(envelope);
+            return;
+        }
+        if (envelope.type === 'run.start') {
+            this.options.send('ack', { type: envelope.type }, envelope.id);
+            this.options.runners.startManagedRun(envelope);
+            return;
+        }
+        if (envelope.type === 'session.channel.message') {
+            this.options.deliverSessionChannelMessage(envelope);
+            return;
+        }
+        if (envelope.type === 'run.cancel' || envelope.type === 'run.interrupt') {
+            this.cancelRun(envelope);
+            return;
+        }
+        if (envelope.type === 'session.resume' || envelope.type === 'lease.reconcile') {
+            this.options.send('ack', { type: envelope.type }, envelope.id);
+            return;
+        }
+        if (envelope.type !== 'error')
+            this.options.send('error', { code: 'MESSAGE_TYPE_UNKNOWN' }, envelope.id);
+    }
+    register(envelope) {
+        const payload = envelope.payload;
+        if (typeof payload.nodeId !== 'string' ||
+            typeof payload.credential !== 'string' ||
+            this.options.config() === undefined) {
+            this.options.close(4002, 'MESSAGE_INVALID');
+            return;
+        }
+        void this.options.register(payload.nodeId, payload.credential);
+    }
+    decideApproval(envelope) {
+        const payload = envelope.payload;
+        if (typeof payload.runId !== 'string' ||
+            typeof payload.approvalId !== 'string' ||
+            (payload.decision !== 'APPROVED' && payload.decision !== 'REJECTED')) {
+            this.options.send('error', { code: 'MESSAGE_INVALID' }, envelope.id);
+            return;
+        }
+        this.options.runners.decideApproval({
+            runId: payload.runId,
+            approvalId: payload.approvalId,
+            decision: payload.decision
+        });
+        this.options.send('ack', { type: envelope.type }, envelope.id);
+    }
+    cancelRun(envelope) {
+        const payload = envelope.payload;
+        if (typeof payload.runId === 'string') {
+            const handled = this.options.runners.cancelManagedRun(payload.runId, envelope.type === 'run.cancel' ? 'CANCEL' : 'INTERRUPT');
+            if (!handled)
+                this.options.completeUncontrolledCancellation(payload.runId);
+        }
+        this.options.send('ack', { type: envelope.type }, envelope.id);
+    }
+}
+//# sourceMappingURL=node-control-message-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"node-control-message-service.js","sourceRoot":"","sources":["../../src/service/node-control-message-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAqB,MAAM,uBAAuB,CAAC;AAmB9E,6EAA6E;AAC7E,MAAM,OAAO,yBAAyB;IACP;IAA7B,YAA6B,OAAyC;QAAzC,YAAO,GAAP,OAAO,CAAkC;IAAG,CAAC;IAE1E,MAAM,CAAC,GAAW;QAChB,IAAI,QAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAEO,QAAQ,CAAC,QAAsB;QACrC,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACnC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;YAC1C,KAAK,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACrC,KAAK,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;YAC9C,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA6B,CAAC;YACvD,IAAI,OAAO,CAAC,IAAI,KAAK,iBAAiB;gBACpC,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC3D,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;YAC9C,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAC/C,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;YAChD,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;YACpD,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,QAAQ,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YACxE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,IAAI,QAAQ,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAC9E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;YAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;IAEO,QAAQ,CAAC,QAAsB;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAqD,CAAC;QAC/E,IACE,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ;YAClC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YACtC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,SAAS,EACnC,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QACD,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACjE,CAAC;IAEO,cAAc,CAAC,QAAsB;QAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAIxB,CAAC;QACF,IACE,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YACjC,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YACtC,CAAC,OAAO,CAAC,QAAQ,KAAK,UAAU,IAAI,OAAO,CAAC,QAAQ,KAAK,UAAU,CAAC,EACpE,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;IAEO,SAAS,CAAC,QAAsB;QACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAA8B,CAAC;QACxD,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CACnD,OAAO,CAAC,KAAK,EACb,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CACxD,CAAC;YACF,IAAI,CAAC,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,gCAAgC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/service/node-request-service.d.ts

@@ -0,0 +1,14 @@
+import type { NodeEnvelope } from '@myagentroam/protocol';
+interface NodeRequestServiceOptions {
+    readonly nodeId: () => string | undefined;
+    readonly databaseAvailable: () => boolean;
+    readonly execute: (operation: string, data: unknown) => Promise<unknown>;
+    readonly send: (type: string, payload: unknown, replyTo?: string) => void;
+}
+/** Validates and executes the closed Admin-facing Node operation envelope. */
+export declare class NodeRequestService {
+    private readonly options;
+    constructor(options: NodeRequestServiceOptions);
+    handle(envelope: NodeEnvelope): Promise<void>;
+}
+export {};

package/dist/service/node-request-service.js

@@ -0,0 +1,51 @@
+import { nodeLog } from '../operational.js';
+import { validUserAuthorization } from '../runner/codex/conversation-parser.js';
+/** Validates and executes the closed Admin-facing Node operation envelope. */
+export class NodeRequestService {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async handle(envelope) {
+        const payload = envelope.payload;
+        if (typeof payload.operation !== 'string' || !this.options.databaseAvailable()) {
+            this.options.send('node.response', { error: 'MESSAGE_INVALID' }, envelope.id);
+            return;
+        }
+        if (!validUserAuthorization(payload.userAuthorization, envelope, payload.operation, this.options.nodeId())) {
+            this.options.send('node.response', { error: 'USER_AUTHORIZATION_REQUIRED' }, envelope.id);
+            return;
+        }
+        const startedAt = performance.now();
+        try {
+            const data = payload.data !== null && typeof payload.data === 'object'
+                ? {
+                    ...payload.data,
+                    __workspaceWatchSessionHash: payload.userAuthorization
+                        .sessionHash
+                }
+                : payload.data;
+            const result = await this.options.execute(payload.operation, data);
+            this.options.send('node.response', { result }, envelope.id);
+            const durationMs = Math.round(performance.now() - startedAt);
+            if (durationMs >= 250)
+                nodeLog('node.operation.completed', {
+                    nodeId: this.options.nodeId(),
+                    operation: payload.operation,
+                    requestId: envelope.id,
+                    durationMs
+                });
+        }
+        catch (error) {
+            nodeLog('node.operation.failed', {
+                nodeId: this.options.nodeId(),
+                operation: payload.operation,
+                requestId: envelope.id,
+                durationMs: Math.round(performance.now() - startedAt),
+                error: error instanceof Error ? error.message : 'INTERNAL_ERROR'
+            });
+            this.options.send('node.response', { error: error instanceof Error ? error.message : 'INTERNAL_ERROR' }, envelope.id);
+        }
+    }
+}
+//# sourceMappingURL=node-request-service.js.map

package/dist/service/node-request-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-request-service.js","sourceRoot":"","sources":["../../src/service/node-request-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAShF,8EAA8E;AAC9E,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,OAAkC;QAAlC,YAAO,GAAP,OAAO,CAA2B;IAAG,CAAC;IAEnE,KAAK,CAAC,MAAM,CAAC,QAAsB;QACjC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAIxB,CAAC;QACF,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC;YAC/E,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9E,OAAO;QACT,CAAC;QACD,IACE,CAAC,sBAAsB,CACrB,OAAO,CAAC,iBAAiB,EACzB,QAAQ,EACR,OAAO,CAAC,SAAS,EACjB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CACtB,EACD,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,6BAA6B,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1F,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,GACR,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBACvD,CAAC,CAAC;oBACE,GAAI,OAAO,CAAC,IAAgC;oBAC5C,2BAA2B,EAAG,OAAO,CAAC,iBAA6C;yBAChF,WAAW;iBACf;gBACH,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC;YAC7D,IAAI,UAAU,IAAI,GAAG;gBACnB,OAAO,CAAC,0BAA0B,EAAE;oBAClC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;oBAC7B,SAAS,EAAE,OAAO,CAAC,SAAS;oBAC5B,SAAS,EAAE,QAAQ,CAAC,EAAE;oBACtB,UAAU;iBACX,CAAC,CAAC;QACP,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,uBAAuB,EAAE;gBAC/B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBAC7B,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,QAAQ,CAAC,EAAE;gBACtB,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBACrD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB;aACjE,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,CAAC,IAAI,CACf,eAAe,EACf,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAAE,EACpE,QAAQ,CAAC,EAAE,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}