@myagentroam/node 0.1.2 → 0.1.4

package/dist/service/node-run-event-bridge.d.ts

@@ -0,0 +1,38 @@
+import type { NodeEnvelope, WorkbenchEventCategory } from '@myagentroam/protocol';
+import type { FakeRunnerStatus } from '../fake-runner.js';
+import type { CodexRunner } from '../runner/codex-runner.js';
+import type { ClaudeCodeRunner } from '../runner/claude-code-runner.js';
+import type { NodeRuntimeState } from '../runtime-state.js';
+import type { RunDomainState } from './run-domain-state.js';
+import type { RunEventService } from './run-event-service.js';
+import type { WorkbenchEventService } from './workbench-event-service.js';
+import type { WorkspaceQueueWorkbenchService } from './workspace-queue-workbench-service.js';
+import type { RunnerImageAttachment } from './run-attachment-service.js';
+export declare function workbenchPayloadSessionId(runtime: NodeRuntimeState, category: WorkbenchEventCategory, payload: unknown): string | undefined;
+interface NodeRunEventBridgeOptions {
+    readonly runtime: NodeRuntimeState;
+    readonly state: RunDomainState;
+    readonly events: RunEventService;
+    readonly workbench: WorkbenchEventService;
+    readonly queues: WorkspaceQueueWorkbenchService<RunnerImageAttachment>;
+    readonly codex: CodexRunner;
+    readonly claude: ClaudeCodeRunner;
+    readonly send: (type: string, payload: unknown, replyTo?: string) => void;
+}
+/** Bridges process-local Run state to normalized control and Workbench events. */
+export declare class NodeRunEventBridge {
+    private readonly options;
+    constructor(options: NodeRunEventBridgeOptions);
+    publishApproval(input: {
+        readonly runId: string;
+        readonly approvalId: string;
+        readonly payload: unknown;
+        readonly expiresAt: number;
+    }): void;
+    emitRun(runId: string, eventType: string, payload: unknown, status?: FakeRunnerStatus): void;
+    emitWorkbench(category: WorkbenchEventCategory, payload: unknown): void;
+    emitQueue(workspaceId: string, sessionId: string): void;
+    migrateRunnerSessionIdentity(sessionId: string, nativeSessionId: string): void;
+    reconcile(envelope: NodeEnvelope): void;
+}
+export {};

package/dist/service/node-run-event-bridge.js

@@ -0,0 +1,80 @@
+import { isNodeAgentRun, isNodeConversationTurn, isPlainRecord } from '../runner/codex/conversation-parser.js';
+export function workbenchPayloadSessionId(runtime, category, payload) {
+    if (!isPlainRecord(payload))
+        return undefined;
+    if (category === 'session' && isPlainRecord(payload.session)) {
+        const id = payload.session.id;
+        return typeof id === 'string' ? id : undefined;
+    }
+    if (category === 'run' && isNodeAgentRun(payload.run))
+        return payload.run.sessionId;
+    if (category === 'conversation' && isNodeConversationTurn(payload.turn))
+        return payload.turn.sessionId;
+    if (category === 'conversation' && isPlainRecord(payload.event)) {
+        const runId = payload.event.runId;
+        return typeof runId === 'string' ? runtime.getRun(runId)?.sessionId : undefined;
+    }
+    if (category === 'queue') {
+        const id = payload.sessionId;
+        return typeof id === 'string' ? id : undefined;
+    }
+    return undefined;
+}
+/** Bridges process-local Run state to normalized control and Workbench events. */
+export class NodeRunEventBridge {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    publishApproval(input) {
+        this.options.send('approval.request', input);
+        this.emitRun(input.runId, 'approval.request', input);
+    }
+    emitRun(runId, eventType, payload, status) {
+        this.options.events.emit(runId, eventType, payload, status);
+    }
+    emitWorkbench(category, payload) {
+        this.options.workbench.emit(category, payload);
+    }
+    emitQueue(workspaceId, sessionId) {
+        this.emitWorkbench('queue', {
+            workspaceId,
+            sessionId,
+            queue: this.options.queues.present(workspaceId, sessionId)
+        });
+    }
+    migrateRunnerSessionIdentity(sessionId, nativeSessionId) {
+        for (const [turnId, managed] of this.options.codex.execution.managedTurns) {
+            if (managed.sessionId === sessionId)
+                this.options.codex.execution.managedTurns.set(turnId, {
+                    ...managed,
+                    sessionId: nativeSessionId
+                });
+        }
+        for (const [runId, managed] of this.options.codex.execution.runs) {
+            if (managed.sessionId === sessionId)
+                this.options.codex.execution.runs.set(runId, { ...managed, sessionId: nativeSessionId });
+        }
+        for (const [runId, managed] of this.options.claude.execution.runs) {
+            if (managed.marSessionId === sessionId)
+                this.options.claude.execution.runs.set(runId, {
+                    ...managed,
+                    marSessionId: nativeSessionId
+                });
+        }
+    }
+    reconcile(envelope) {
+        const payload = envelope.payload;
+        if (!Array.isArray(payload.runIds) || payload.runIds.some((id) => typeof id !== 'string')) {
+            this.options.send('error', { code: 'MESSAGE_INVALID' }, envelope.id);
+            return;
+        }
+        for (const runId of payload.runIds) {
+            const known = this.options.state.active.has(runId);
+            this.options.runtime.reconcileRun(runId, known);
+            this.options.send('lease.reconcile', { runId, known });
+        }
+        this.options.send('ack', { type: 'runs.reconcile' }, envelope.id);
+    }
+}
+//# sourceMappingURL=node-run-event-bridge.js.map

package/dist/service/node-run-event-bridge.js.map

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

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

@@ -0,0 +1,29 @@
+import type { NodeConfig } from '../config.js';
+import type { TerminalManager } from '../terminal.js';
+interface NodeTerminalChannelOptions {
+    readonly config: () => NodeConfig | undefined;
+    readonly controlConnected: () => boolean;
+    readonly stopped: () => boolean;
+    readonly reconnect: boolean;
+    readonly reconnectDelay: (attempt: number) => number;
+    readonly manager: TerminalManager;
+}
+export declare class NodeTerminalChannel {
+    private readonly options;
+    private socket;
+    private reconnectTimer;
+    private attempts;
+    private readonly state;
+    constructor(options: NodeTerminalChannelOptions);
+    connect(): void;
+    disconnect(): void;
+    stop(): void;
+    private scheduleReconnect;
+    private handle;
+    private publish;
+    private sendFrame;
+    private send;
+    private invalid;
+    private releaseAttachments;
+}
+export {};

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

@@ -0,0 +1,176 @@
+import WebSocket from 'ws';
+import { terminalDataFrameSchema } from '@myagentroam/protocol';
+import { nodeTerminalConnectEndpoint, isPlainRecord } from '../runner/codex/conversation-parser.js';
+import { TerminalRelayState } from './terminal-relay-state.js';
+export class NodeTerminalChannel {
+    options;
+    socket;
+    reconnectTimer;
+    attempts = 0;
+    state = new TerminalRelayState();
+    constructor(options) {
+        this.options = options;
+        options.manager.onFrame((frame) => this.publish(frame));
+    }
+    connect() {
+        const config = this.options.config();
+        if (config?.nodeId === undefined ||
+            config.credential === undefined ||
+            this.options.stopped() ||
+            (this.socket !== undefined &&
+                (this.socket.readyState === this.socket.OPEN ||
+                    this.socket.readyState === this.socket.CONNECTING)))
+            return;
+        const socket = new WebSocket(nodeTerminalConnectEndpoint(config.serverUrl));
+        this.socket = socket;
+        socket.once('open', () => this.send({ type: 'authenticate', nodeId: config.nodeId, credential: config.credential }));
+        socket.on('message', (raw, isBinary) => isBinary ? socket.close(4002, 'TERMINAL_MESSAGE_INVALID') : this.handle(raw.toString()));
+        socket.once('close', () => {
+            if (this.socket !== socket)
+                return;
+            this.socket = undefined;
+            this.releaseAttachments();
+            this.scheduleReconnect();
+        });
+        socket.once('error', () => undefined);
+    }
+    disconnect() {
+        this.socket?.close();
+    }
+    stop() {
+        if (this.reconnectTimer !== undefined)
+            clearTimeout(this.reconnectTimer);
+        this.reconnectTimer = undefined;
+        this.releaseAttachments();
+        this.socket?.close();
+        this.socket = undefined;
+    }
+    scheduleReconnect() {
+        if (this.options.stopped() ||
+            !this.options.reconnect ||
+            !this.options.controlConnected() ||
+            this.reconnectTimer !== undefined)
+            return;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            this.connect();
+        }, this.options.reconnectDelay(this.attempts++));
+    }
+    handle(raw) {
+        let message;
+        try {
+            message = JSON.parse(raw);
+        }
+        catch {
+            this.invalid();
+            return;
+        }
+        if (!isPlainRecord(message) || typeof message.type !== 'string') {
+            this.invalid();
+            return;
+        }
+        if (message.type === 'authenticated') {
+            if (typeof message.nodeId !== 'string' ||
+                Object.keys(message).some((key) => key !== 'type' && key !== 'nodeId'))
+                this.invalid();
+            else
+                this.attempts = 0;
+            return;
+        }
+        if (message.type === 'attach') {
+            if (typeof message.ticket !== 'string' ||
+                typeof message.terminalId !== 'string' ||
+                typeof message.attachmentId !== 'string' ||
+                Object.keys(message).some((key) => !['type', 'ticket', 'terminalId', 'attachmentId'].includes(key))) {
+                this.invalid();
+                return;
+            }
+            this.state.attachments.set(message.ticket, {
+                terminalId: message.terminalId,
+                attachmentId: message.attachmentId
+            });
+            return;
+        }
+        if (message.type === 'detach' || message.type === 'close') {
+            if (typeof message.ticket !== 'string' ||
+                Object.keys(message).some((key) => !['type', 'ticket'].includes(key))) {
+                this.invalid();
+                return;
+            }
+            const attachment = this.state.attachments.get(message.ticket);
+            if (attachment === undefined)
+                return;
+            this.state.attachments.delete(message.ticket);
+            if (message.type === 'detach')
+                this.options.manager.detach(attachment.attachmentId);
+            else
+                void this.options.manager
+                    .acceptFrame(attachment.attachmentId, {
+                    type: 'close',
+                    terminalId: attachment.terminalId
+                })
+                    .catch(() => undefined);
+            return;
+        }
+        if (message.type === 'frame') {
+            if (typeof message.ticket !== 'string' ||
+                Object.keys(message).some((key) => !['type', 'ticket', 'frame'].includes(key))) {
+                this.invalid();
+                return;
+            }
+            const parsed = terminalDataFrameSchema.safeParse(message.frame);
+            const attachment = this.state.attachments.get(message.ticket);
+            if (!parsed.success ||
+                attachment === undefined ||
+                parsed.data.terminalId !== attachment.terminalId ||
+                !['input', 'resize', 'close'].includes(parsed.data.type)) {
+                this.invalid();
+                return;
+            }
+            void this.options.manager.acceptFrame(attachment.attachmentId, parsed.data).catch(() => this.sendFrame(message.ticket, {
+                type: 'error',
+                terminalId: attachment.terminalId,
+                code: 'TERMINAL_FRAME_REJECTED'
+            }));
+            return;
+        }
+        if (message.type === 'shutdown' && Object.keys(message).length === 1) {
+            this.state.attachments.clear();
+            void this.options.manager.shutdown();
+            return;
+        }
+        this.invalid();
+    }
+    publish(frame) {
+        for (const [ticket, attachment] of this.state.attachments) {
+            if (attachment.terminalId !== frame.terminalId)
+                continue;
+            this.sendFrame(ticket, frame);
+            if (frame.type === 'exit')
+                this.state.attachments.delete(ticket);
+        }
+    }
+    sendFrame(ticket, frame) {
+        this.send({ type: 'frame', ticket, frame });
+    }
+    send(message) {
+        const socket = this.socket;
+        if (socket === undefined || socket.readyState !== socket.OPEN)
+            return;
+        try {
+            socket.send(JSON.stringify(message));
+        }
+        catch {
+            socket.close(1011, 'TERMINAL_SEND_FAILED');
+        }
+    }
+    invalid() {
+        this.socket?.close(4002, 'TERMINAL_MESSAGE_INVALID');
+    }
+    releaseAttachments() {
+        for (const attachment of this.state.attachments.values())
+            this.options.manager.detach(attachment.attachmentId);
+        this.state.attachments.clear();
+    }
+}
+//# sourceMappingURL=node-terminal-channel.js.map

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

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

package/dist/service/node-workspace-coordinator.d.ts

@@ -0,0 +1,32 @@
+import type { NodeEnvelope } from '@myagentroam/protocol';
+import type { NodeConfig } from '../config.js';
+import type { NodeAgentSession, NodeDatabase, NodeWorkspace } from '../database.js';
+import type { NodeRuntimeState } from '../runtime-state.js';
+import type { TerminalSummary } from '../terminal.js';
+import type { WorkspaceChangeService } from './workspace-change-service.js';
+import type { WorkspaceSessionService } from './workspace-session-service.js';
+import type { WorkspaceWatchService } from './workspace-watch-service.js';
+interface NodeWorkspaceCoordinatorOptions {
+    readonly config: () => NodeConfig | undefined;
+    readonly database: () => NodeDatabase | undefined;
+    readonly runtime: NodeRuntimeState;
+    readonly watches: WorkspaceWatchService;
+    readonly sessions: WorkspaceSessionService;
+    readonly changes: WorkspaceChangeService;
+    readonly emit: (workspaceId: string, topic: 'files' | 'changes', revision: number) => void;
+    readonly send: (type: string, payload: unknown, replyTo?: string) => void;
+}
+/** Coordinates Workspace invalidation, inspection, snapshots and persisted Terminal summaries. */
+export declare class NodeWorkspaceCoordinator {
+    private readonly options;
+    constructor(options: NodeWorkspaceCoordinatorOptions);
+    require(workspaceId: unknown): NodeWorkspace;
+    clearWatches(workspaceId: string): void;
+    cachedSessions(workspaceId: string): Promise<readonly NodeAgentSession[]>;
+    invalidate(workspaceId: string): void;
+    invalidateChanges(workspaceId: string): void;
+    persistTerminal(summary: TerminalSummary): void;
+    inspect(envelope: NodeEnvelope): Promise<void>;
+    captureRunSnapshot(runId: string, cwd: string): Promise<void>;
+}
+export {};

package/dist/service/node-workspace-coordinator.js

@@ -0,0 +1,81 @@
+import { inspectWorkspace, readGitSummary } from '../workspace.js';
+/** Coordinates Workspace invalidation, inspection, snapshots and persisted Terminal summaries. */
+export class NodeWorkspaceCoordinator {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    require(workspaceId) {
+        if (typeof workspaceId !== 'string')
+            throw new Error('WORKSPACE_NOT_FOUND');
+        const workspace = this.options.database()?.getWorkspace(workspaceId);
+        if (workspace === undefined)
+            throw new Error('WORKSPACE_NOT_FOUND');
+        return workspace;
+    }
+    clearWatches(workspaceId) {
+        this.options.watches.clear(workspaceId);
+    }
+    cachedSessions(workspaceId) {
+        return this.options.sessions.cached(workspaceId);
+    }
+    invalidate(workspaceId) {
+        this.options.changes.invalidate(workspaceId);
+        for (const topic of ['files', 'changes']) {
+            if (!this.options.watches.topicActive(workspaceId, topic))
+                continue;
+            this.options.emit(workspaceId, topic, this.options.watches.nextRevision(workspaceId));
+        }
+    }
+    invalidateChanges(workspaceId) {
+        this.options.changes.invalidate(workspaceId);
+    }
+    persistTerminal(summary) {
+        const database = this.options.database();
+        if (database === undefined)
+            return;
+        const value = {
+            id: summary.id,
+            workspaceId: summary.workspaceId,
+            profileId: summary.profileId,
+            state: summary.state,
+            exitCode: summary.exitCode,
+            rows: summary.rows,
+            cols: summary.cols,
+            latestSequence: summary.latestSequence,
+            createdAt: summary.createdAt,
+            updatedAt: summary.updatedAt
+        };
+        database.saveTerminalSession(value);
+    }
+    async inspect(envelope) {
+        const requestedPath = typeof envelope.payload === 'object' &&
+            envelope.payload !== null &&
+            'path' in envelope.payload
+            ? envelope.payload.path
+            : undefined;
+        const config = this.options.config();
+        if (typeof requestedPath !== 'string' || config === undefined) {
+            this.options.send('workspace.inspect.result', { error: 'WORKSPACE_INVALID' }, envelope.id);
+            return;
+        }
+        try {
+            const inspection = await inspectWorkspace(requestedPath, config.allowedRoots);
+            this.options.send('workspace.inspect.result', inspection, envelope.id);
+        }
+        catch {
+            this.options.send('workspace.inspect.result', { error: 'WORKSPACE_INVALID' }, envelope.id);
+        }
+    }
+    async captureRunSnapshot(runId, cwd) {
+        try {
+            const snapshot = await readGitSummary(cwd);
+            this.options.runtime.saveSnapshot(runId, snapshot);
+            this.options.send('workspace.snapshot', { runId, snapshot });
+        }
+        catch {
+            // Ordinary directories have no Git snapshot and keep the existing Run result.
+        }
+    }
+}
+//# sourceMappingURL=node-workspace-coordinator.js.map

package/dist/service/node-workspace-coordinator.js.map

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

package/dist/service/run-attachment-service.d.ts

@@ -0,0 +1,37 @@
+import type { CodexComposerInput } from '../codex-app-server.js';
+import type { NodeAgentSession, NodeMessageAttachmentInput } from '../database.js';
+import type { NativeTranscriptImageAttachment } from '../native-session-history.js';
+import { AttachmentDomainState } from './attachment-domain-state.js';
+export interface CachedRunImages {
+    images: readonly NodeMessageAttachmentInput[];
+    expiresAt: number | undefined;
+    timer: NodeJS.Timeout | undefined;
+}
+export interface NativeImageSource {
+    readonly name: string;
+    readonly mime: string;
+    readonly path: string;
+}
+export type RunnerImageAttachment = NodeMessageAttachmentInput & {
+    readonly mime: 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp';
+};
+export declare class RunAttachmentService {
+    private readonly nativeImageRoot;
+    readonly state: AttachmentDomainState<CachedRunImages, NativeImageSource>;
+    constructor(nativeImageRoot: (session: NodeAgentSession) => string | undefined);
+    materializeCodex(runId: string, attachments: readonly RunnerImageAttachment[]): Promise<readonly Extract<CodexComposerInput, {
+        readonly type: 'localImage';
+    }>[]>;
+    persistFiles(workspacePath: string, runId: string, attachments: readonly NodeMessageAttachmentInput[]): Promise<readonly string[]>;
+    cleanup(runId: string): void;
+    cache(runId: string, images: readonly NodeMessageAttachmentInput[]): void;
+    append(runId: string, images: readonly NodeMessageAttachmentInput[]): readonly Record<string, unknown>[];
+    read(runId: string, imageIndex: number): NodeMessageAttachmentInput | undefined;
+    registerNative(session: NodeAgentSession, images: readonly NativeTranscriptImageAttachment[]): readonly Record<string, unknown>[];
+    readNative(runId: string, imageIndex: number): Promise<(NativeImageSource & {
+        readonly dataBase64: string;
+    }) | undefined>;
+    expire(runId: string): void;
+    clear(runId: string): void;
+    dispose(): void;
+}