@a5c-ai/agent-mux-harness-mock 0.2.0

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Types for the harness mock/simulator.
+ *
+ * A "harness" is a CLI tool (claude-code, codex, etc.) that agent-mux
+ * invokes as a subprocess. This package simulates harness behavior for
+ * testing without requiring the real CLI tools to be installed.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/workspace.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=workspace.d.ts.map

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(), 'amux-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":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAYlC,MAAM,OAAO,gBAAgB;IAC3B,0CAA0C;IACjC,IAAI,CAAS;IAEd,SAAS,GAAG,KAAK,CAAC;IAClB,SAAS,CAAU;IACnB,gBAAgB,CAAsB;IAE9C,YAAY,OAA0B;QACpC,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;QAC5C,IAAI,CAAC,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;QAElC,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC;YAC1B,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBACvE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAClC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,OAAO,CAAC,YAAoB;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,yBAAyB,YAAY,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,mCAAmC;IACnC,SAAS,CAAC,YAAoB,EAAE,OAAe;QAC7C,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAC5C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED,oCAAoC;IACpC,QAAQ,CAAC,YAAoB;QAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,6CAA6C;IAC7C,MAAM,CAAC,YAAoB;QACzB,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,sCAAsC;IACtC,UAAU,CAAC,YAAoB;QAC7B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,sDAAsD;IACtD,SAAS;QACP,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAQ,EAAE;YACjC,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACb,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;gBACnE,CAAC;YACH,CAAC;QACH,CAAC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,UAA2B,EAAE,QAAiB;QAC5D,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAG,QAAQ;gBAC3B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;gBACtD,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAE/B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBAChB,KAAK,QAAQ,CAAC;gBACd,KAAK,QAAQ;oBACX,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;oBAC/C,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;wBAC9B,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;oBAChC,CAAC;oBACD,MAAM;gBACR,KAAK,QAAQ;oBACX,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;wBACf,MAAM,WAAW,GAAG,QAAQ;4BAC1B,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;4BACzD,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;wBAClC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;wBAC5C,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;wBACrC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;oBAChC,CAAC;oBACD,MAAM;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/C,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;iBAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC;YAChD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;IACzF,CAAC;IAED,yDAAyD;IACzD,QAAQ;QACN,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,kBAAkB;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@a5c-ai/agent-mux-harness-mock",
+  "version": "0.2.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Mock harness simulator for testing agent-mux adapters — simulates claude-code, codex, and other CLI harnesses",
+  "author": "a5c-ai",
+  "homepage": "https://github.com/a5c-ai/agent-mux#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a5c-ai/agent-mux.git",
+    "directory": "packages/harness-mock"
+  },
+  "bugs": {
+    "url": "https://github.com/a5c-ai/agent-mux/issues"
+  },
+  "keywords": [
+    "agent-mux",
+    "mock",
+    "harness",
+    "testing",
+    "fixtures",
+    "ai"
+  ],
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "mock-harness": "./dist/bin/mock-harness.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run --config ../../vitest.config.ts"
+  },
+  "dependencies": {
+    "@a5c-ai/agent-mux-core": "0.2.0"
+  }
+}