@a5c-ai/adapters-harness-mock 5.1.1-staging.00ceebd28cf2

package/dist/websocket-mock.js

@@ -0,0 +1,367 @@
+/**
+ * WebSocket server mock implementation for harness-mock.
+ */
+import { EventEmitter } from 'node:events';
+import WebSocket, { WebSocketServer } from 'ws';
+let nextConnectionId = 1;
+export class WebSocketServerMock extends EventEmitter {
+    scenario;
+    id;
+    _port;
+    _serverUrl;
+    _server = null;
+    _exited = false;
+    _isRunning = false;
+    _startTime = Date.now();
+    _fileChanges = [];
+    _messageHistory = [];
+    _connections = new Map();
+    _completedConnections = [];
+    _reconnectAllowedAt = null;
+    _reconnectTimer = null;
+    constructor(scenario, id) {
+        super();
+        this.scenario = scenario;
+        this.id = id;
+        this._port = scenario.websocketServer?.port ?? 8081;
+        const host = scenario.websocketServer?.host ?? '127.0.0.1';
+        this._serverUrl = `ws://${host}:${this._port}`;
+    }
+    get port() {
+        return this._port;
+    }
+    get serverUrl() {
+        return this._serverUrl;
+    }
+    get exited() {
+        return this._exited;
+    }
+    get fileChanges() {
+        return [...this._fileChanges];
+    }
+    get isRunning() {
+        return this._isRunning;
+    }
+    get connectionCount() {
+        return this._connections.size;
+    }
+    get messageHistory() {
+        return [...this._messageHistory];
+    }
+    async start() {
+        if (this._server || this._isRunning) {
+            throw new Error('WebSocket server already started');
+        }
+        const config = this.scenario.websocketServer;
+        if (config?.startupDelayMs) {
+            await new Promise((resolve) => setTimeout(resolve, config.startupDelayMs));
+        }
+        if (config?.startupFails) {
+            throw new Error('Mock WebSocket server startup failed');
+        }
+        const host = config?.host ?? '127.0.0.1';
+        const port = config?.port ?? 8081;
+        this._port = port;
+        this._serverUrl = `ws://${host}:${port}`;
+        this._server = new WebSocketServer({
+            host,
+            port,
+            maxPayload: 1024 * 1024 * 8,
+        });
+        try {
+            await new Promise((resolve, reject) => {
+                const server = this._server;
+                if (!server) {
+                    reject(new Error('WebSocket server failed to initialize'));
+                    return;
+                }
+                const cleanup = () => {
+                    server.off('error', onError);
+                    server.off('listening', onListening);
+                };
+                const onError = (error) => {
+                    cleanup();
+                    reject(error);
+                };
+                const onListening = () => {
+                    cleanup();
+                    const address = server.address();
+                    if (address && typeof address === 'object' && 'port' in address) {
+                        this._port = address.port;
+                        this._serverUrl = `ws://${host}:${address.port}`;
+                    }
+                    this._isRunning = true;
+                    this.emit('started');
+                    resolve();
+                };
+                server.once('error', onError);
+                server.once('listening', onListening);
+            });
+        }
+        catch (error) {
+            this._isRunning = false;
+            if (this._server) {
+                await new Promise((resolve) => this._server?.close(() => resolve()));
+                this._server = null;
+            }
+            throw error;
+        }
+        this._server.on('connection', (socket) => {
+            if (!this._isRunning) {
+                socket.close(1012, 'Server stopping');
+                return;
+            }
+            const now = Date.now();
+            if (this._reconnectAllowedAt != null && now < this._reconnectAllowedAt) {
+                socket.close(1013, 'Reconnect not yet allowed');
+                return;
+            }
+            const isReconnect = this._reconnectAllowedAt != null && now >= this._reconnectAllowedAt;
+            if (isReconnect) {
+                this._reconnectAllowedAt = null;
+            }
+            if (this.scenario.websocketServer?.maxConnections != null
+                && this._connections.size >= this.scenario.websocketServer.maxConnections) {
+                socket.close(1013, 'Mock connection limit reached');
+                return;
+            }
+            const connection = this.createConnection(socket);
+            this.emit('connection', connection.connectionId);
+            if (isReconnect) {
+                this.emit('reconnected', connection.connectionId);
+            }
+            this.scheduleScenarioEvents(connection);
+            this.attachSocketHandlers(connection);
+        });
+    }
+    broadcast(message) {
+        for (const connectionId of this._connections.keys()) {
+            this.sendTo(connectionId, message);
+        }
+    }
+    sendTo(connectionId, message) {
+        const connection = this._connections.get(connectionId);
+        if (!connection) {
+            throw new Error(`Unknown connection: ${connectionId}`);
+        }
+        if (connection.disconnectedAt) {
+            throw new Error(`Connection already closed: ${connectionId}`);
+        }
+        this.sendFrame(connection, message);
+    }
+    receiveFrom(connectionId, message) {
+        const connection = this._connections.get(connectionId);
+        if (!connection) {
+            throw new Error(`Unknown connection: ${connectionId}`);
+        }
+        if (connection.disconnectedAt) {
+            throw new Error(`Connection already closed: ${connectionId}`);
+        }
+        this.recordMessage(connection, 'inbound', message);
+        this.emit('message', { connectionId, direction: 'inbound', message });
+        this.checkForDrop(connection);
+    }
+    dropConnection(connectionId) {
+        const connection = this._connections.get(connectionId);
+        if (!connection || connection.disconnectedAt) {
+            return;
+        }
+        this.closeConnection(connection, 1011, 'Mock connection dropped');
+        const drops = this.scenario.websocketServer?.simulateDrops;
+        if (drops?.reconnectDelayMs != null) {
+            this._reconnectAllowedAt = Date.now() + drops.reconnectDelayMs;
+            if (this._reconnectTimer) {
+                clearTimeout(this._reconnectTimer);
+            }
+            this._reconnectTimer = setTimeout(() => {
+                this._reconnectTimer = null;
+                if (!this._isRunning)
+                    return;
+                if (this._reconnectAllowedAt != null && Date.now() >= this._reconnectAllowedAt) {
+                    this._reconnectAllowedAt = null;
+                }
+            }, drops.reconnectDelayMs);
+        }
+    }
+    getConnectionStatus() {
+        return Array.from(this._connections.values()).map((connection) => ({
+            connectionId: connection.connectionId,
+            connectedAt: connection.connectedAt,
+            messageCount: connection.messageCount,
+        }));
+    }
+    async stop() {
+        if (!this._isRunning) {
+            this._exited = true;
+            return;
+        }
+        this._isRunning = false;
+        if (this._reconnectTimer) {
+            clearTimeout(this._reconnectTimer);
+            this._reconnectTimer = null;
+        }
+        for (const connection of [...this._connections.values()]) {
+            this.closeConnection(connection, 1001, 'Server stopped');
+        }
+        this._connections.clear();
+        await new Promise((resolve) => {
+            if (!this._server) {
+                resolve();
+                return;
+            }
+            this._server.close(() => resolve());
+            this._server = null;
+        });
+        this._exited = true;
+        this.emit('stopped');
+    }
+    forceStop() {
+        void this.stop();
+    }
+    async waitForCompletion() {
+        if (!this._exited) {
+            await new Promise((resolve) => this.once('stopped', resolve));
+        }
+        const durationMs = Date.now() - this._startTime;
+        const completedConnections = this.getHistoricalConnections();
+        const averageConnectionDurationMs = completedConnections.length === 0
+            ? durationMs
+            : completedConnections.reduce((sum, connection) => sum + connection.durationMs, 0) / completedConnections.length;
+        const result = {
+            type: 'websocket',
+            connectionCount: completedConnections.length,
+            messageCount: this._messageHistory.length,
+            averageConnectionDurationMs,
+        };
+        return {
+            success: true,
+            durationMs,
+            results: result,
+        };
+    }
+    createConnection(socket) {
+        const connectionId = `ws-${nextConnectionId++}`;
+        const connection = {
+            connectionId,
+            socket,
+            connectedAt: new Date(),
+            messageCount: 0,
+            timers: [],
+        };
+        this._connections.set(connectionId, connection);
+        return connection;
+    }
+    scheduleScenarioEvents(connection) {
+        let delayMs = 0;
+        for (const event of this.scenario.events ?? []) {
+            delayMs += event.delayMs ?? 0;
+            const timer = setTimeout(() => {
+                if (!this._isRunning || !this._connections.has(connection.connectionId)) {
+                    return;
+                }
+                this.sendFrame(connection, event);
+                this.emit('event', { connectionId: connection.connectionId, event });
+            }, delayMs);
+            connection.timers.push(timer);
+        }
+        for (const op of this.scenario.fileOperations ?? []) {
+            this._fileChanges.push(op);
+        }
+    }
+    recordMessage(connection, direction, message) {
+        connection.messageCount += 1;
+        this._messageHistory.push({
+            connectionId: connection.connectionId,
+            direction,
+            message,
+            timestamp: new Date(),
+        });
+    }
+    sendFrame(connection, message) {
+        if (connection.socket.readyState !== WebSocket.OPEN) {
+            throw new Error(`Connection already closed: ${connection.connectionId}`);
+        }
+        this.recordMessage(connection, 'outbound', message);
+        connection.socket.send(typeof message === 'string' ? message : JSON.stringify(message));
+        this.emit('message', { connectionId: connection.connectionId, direction: 'outbound', message });
+        this.checkForDrop(connection);
+    }
+    attachSocketHandlers(connection) {
+        connection.socket.on('message', (data, isBinary) => {
+            const message = this.decodeMessage(data, isBinary);
+            this.receiveFrom(connection.connectionId, message);
+        });
+        connection.socket.once('close', () => {
+            this.finalizeConnection(connection);
+        });
+        connection.socket.once('error', (error) => {
+            if (!connection.disconnectedAt) {
+                this.emit('error', error);
+            }
+        });
+    }
+    decodeMessage(data, isBinary) {
+        const normalized = this.normalizeRawData(data);
+        if (isBinary) {
+            return normalized;
+        }
+        const text = typeof normalized === 'string' ? normalized : normalized.toString('utf8');
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    }
+    normalizeRawData(data) {
+        if (typeof data === 'string') {
+            return data;
+        }
+        if (Buffer.isBuffer(data)) {
+            return data;
+        }
+        if (Array.isArray(data)) {
+            return Buffer.concat(data);
+        }
+        return Buffer.from(new Uint8Array(data));
+    }
+    closeConnection(connection, code, reason) {
+        if (connection.disconnectedAt) {
+            return;
+        }
+        connection.disconnectedAt = new Date();
+        for (const timer of connection.timers) {
+            clearTimeout(timer);
+        }
+        connection.timers.length = 0;
+        if (connection.socket.readyState === WebSocket.OPEN || connection.socket.readyState === WebSocket.CONNECTING) {
+            connection.socket.close(code, reason);
+        }
+        this.finalizeConnection(connection);
+    }
+    finalizeConnection(connection) {
+        if (!this._connections.has(connection.connectionId)) {
+            return;
+        }
+        connection.disconnectedAt ??= new Date();
+        this._connections.delete(connection.connectionId);
+        if (!this._completedConnections.includes(connection)) {
+            this._completedConnections.push(connection);
+        }
+        this.emit('disconnected', connection.connectionId);
+    }
+    checkForDrop(connection) {
+        const drops = this.scenario.websocketServer?.simulateDrops;
+        if (drops?.afterMessages != null && connection.messageCount >= drops.afterMessages) {
+            this.dropConnection(connection.connectionId);
+        }
+    }
+    getHistoricalConnections() {
+        const allConnections = [...this._completedConnections, ...this._connections.values()];
+        return allConnections.map((connection) => ({
+            connectionId: connection.connectionId,
+            durationMs: Math.max(0, (connection.disconnectedAt ?? new Date()).getTime() - connection.connectedAt.getTime()),
+        }));
+    }
+}
+//# sourceMappingURL=websocket-mock.js.map

package/dist/websocket-mock.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,52 @@
+/**
+ * WorkspaceSandbox — isolated filesystem area for mock harness file operations.
+ *
+ * Creates a temporary directory that the mock harness can read/write to,
+ * providing snapshot and diff capabilities for test assertions.
+ */
+import type { FileOperation } from './types.js';
+export interface WorkspaceOptions {
+    /** Initial files to seed the workspace with. */
+    initialFiles?: Record<string, string>;
+    /** Whether to preserve the workspace after dispose() (for debugging). */
+    preserve?: boolean;
+}
+export declare class WorkspaceSandbox {
+    /** The root directory of this sandbox. */
+    readonly root: string;
+    private _disposed;
+    private _preserve;
+    private _initialSnapshot;
+    constructor(options?: WorkspaceOptions);
+    /** Resolve a relative path within the sandbox. */
+    resolve(relativePath: string): string;
+    /** Write a file to the sandbox. */
+    writeFile(relativePath: string, content: string): void;
+    /** Read a file from the sandbox. */
+    readFile(relativePath: string): string;
+    /** Check if a file exists in the sandbox. */
+    exists(relativePath: string): boolean;
+    /** Delete a file from the sandbox. */
+    deleteFile(relativePath: string): void;
+    /** List all files in the sandbox (relative paths). */
+    listFiles(): string[];
+    /**
+     * Apply a sequence of file operations to the sandbox.
+     * Translates absolute paths in the operations to sandbox-relative paths.
+     */
+    applyOperations(operations: FileOperation[], basePath?: string): void;
+    /**
+     * Get a diff of changes since the workspace was created.
+     * Returns arrays of created, modified, and deleted files.
+     */
+    diff(): {
+        created: string[];
+        modified: string[];
+        deleted: string[];
+    };
+    /** Snapshot the current state (for later comparison). */
+    snapshot(): Map<string, string>;
+    /** Clean up the sandbox. */
+    dispose(): void;
+    private _ensureNotDisposed;
+}

package/dist/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../src/workspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,gBAAgB;IAC/B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,gBAAgB,CAAsB;gBAElC,OAAO,CAAC,EAAE,gBAAgB;IAatC,kDAAkD;IAClD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAQrC,mCAAmC;IACnC,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOtD,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKtC,6CAA6C;IAC7C,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAKrC,sCAAsC;IACtC,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAKtC,sDAAsD;IACtD,SAAS,IAAI,MAAM,EAAE;IAiBrB;;;OAGG;IACH,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IA+BrE;;;OAGG;IACH,IAAI,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAwBpE,yDAAyD;IACzD,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAS/B,4BAA4B;IAC5B,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,kBAAkB;CAK3B"}

package/dist/workspace.js

@@ -0,0 +1,157 @@
+/**
+ * WorkspaceSandbox — isolated filesystem area for mock harness file operations.
+ *
+ * Creates a temporary directory that the mock harness can read/write to,
+ * providing snapshot and diff capabilities for test assertions.
+ */
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+export class WorkspaceSandbox {
+    /** The root directory of this sandbox. */
+    root;
+    _disposed = false;
+    _preserve;
+    _initialSnapshot;
+    constructor(options) {
+        this.root = fs.mkdtempSync(path.join(os.tmpdir(), 'adapters-workspace-'));
+        this._preserve = options?.preserve ?? false;
+        this._initialSnapshot = new Map();
+        if (options?.initialFiles) {
+            for (const [filePath, content] of Object.entries(options.initialFiles)) {
+                this.writeFile(filePath, content);
+                this._initialSnapshot.set(filePath, content);
+            }
+        }
+    }
+    /** Resolve a relative path within the sandbox. */
+    resolve(relativePath) {
+        const resolved = path.resolve(this.root, relativePath);
+        if (!resolved.startsWith(this.root)) {
+            throw new Error(`Path escapes sandbox: ${relativePath}`);
+        }
+        return resolved;
+    }
+    /** Write a file to the sandbox. */
+    writeFile(relativePath, content) {
+        this._ensureNotDisposed();
+        const fullPath = this.resolve(relativePath);
+        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+        fs.writeFileSync(fullPath, content, 'utf-8');
+    }
+    /** Read a file from the sandbox. */
+    readFile(relativePath) {
+        this._ensureNotDisposed();
+        return fs.readFileSync(this.resolve(relativePath), 'utf-8');
+    }
+    /** Check if a file exists in the sandbox. */
+    exists(relativePath) {
+        this._ensureNotDisposed();
+        return fs.existsSync(this.resolve(relativePath));
+    }
+    /** Delete a file from the sandbox. */
+    deleteFile(relativePath) {
+        this._ensureNotDisposed();
+        fs.unlinkSync(this.resolve(relativePath));
+    }
+    /** List all files in the sandbox (relative paths). */
+    listFiles() {
+        this._ensureNotDisposed();
+        const results = [];
+        const walk = (dir) => {
+            for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+                const full = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    walk(full);
+                }
+                else {
+                    results.push(path.relative(this.root, full).replace(/\\/g, '/'));
+                }
+            }
+        };
+        walk(this.root);
+        return results.sort();
+    }
+    /**
+     * Apply a sequence of file operations to the sandbox.
+     * Translates absolute paths in the operations to sandbox-relative paths.
+     */
+    applyOperations(operations, basePath) {
+        this._ensureNotDisposed();
+        for (const op of operations) {
+            const relativePath = basePath
+                ? path.relative(basePath, op.path).replace(/\\/g, '/')
+                : op.path.replace(/^\//, '');
+            switch (op.type) {
+                case 'create':
+                case 'modify':
+                    this.writeFile(relativePath, op.content ?? '');
+                    break;
+                case 'delete':
+                    if (this.exists(relativePath)) {
+                        this.deleteFile(relativePath);
+                    }
+                    break;
+                case 'rename':
+                    if (op.newPath) {
+                        const newRelative = basePath
+                            ? path.relative(basePath, op.newPath).replace(/\\/g, '/')
+                            : op.newPath.replace(/^\//, '');
+                        const content = this.readFile(relativePath);
+                        this.writeFile(newRelative, content);
+                        this.deleteFile(relativePath);
+                    }
+                    break;
+            }
+        }
+    }
+    /**
+     * Get a diff of changes since the workspace was created.
+     * Returns arrays of created, modified, and deleted files.
+     */
+    diff() {
+        this._ensureNotDisposed();
+        const currentFiles = new Set(this.listFiles());
+        const created = [];
+        const modified = [];
+        const deleted = [];
+        for (const file of currentFiles) {
+            if (!this._initialSnapshot.has(file)) {
+                created.push(file);
+            }
+            else if (this.readFile(file) !== this._initialSnapshot.get(file)) {
+                modified.push(file);
+            }
+        }
+        for (const file of this._initialSnapshot.keys()) {
+            if (!currentFiles.has(file)) {
+                deleted.push(file);
+            }
+        }
+        return { created: created.sort(), modified: modified.sort(), deleted: deleted.sort() };
+    }
+    /** Snapshot the current state (for later comparison). */
+    snapshot() {
+        this._ensureNotDisposed();
+        const snap = new Map();
+        for (const file of this.listFiles()) {
+            snap.set(file, this.readFile(file));
+        }
+        return snap;
+    }
+    /** Clean up the sandbox. */
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        if (!this._preserve) {
+            fs.rmSync(this.root, { recursive: true, force: true });
+        }
+    }
+    _ensureNotDisposed() {
+        if (this._disposed) {
+            throw new Error('WorkspaceSandbox has been disposed');
+        }
+    }
+}
+//# sourceMappingURL=workspace.js.map

package/dist/workspace.js.map

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