claw-harness 0.1.0

package/dist/utils.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from 'vitest';
+import { deepMerge, parseDuration, getPackageRoot } from './utils.js';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+describe('deepMerge', () => {
+    it('merges flat objects', () => {
+        expect(deepMerge({ a: 1 }, { b: 2 })).toEqual({ a: 1, b: 2 });
+    });
+    it('merges nested objects', () => {
+        const target = { gateway: { port: 8080, auth: { token: 'old' } } };
+        const source = { gateway: { auth: { token: 'new' } } };
+        expect(deepMerge(target, source)).toEqual({
+            gateway: { port: 8080, auth: { token: 'new' } },
+        });
+    });
+    it('replaces arrays instead of concatenating', () => {
+        const target = { list: [1, 2, 3] };
+        const source = { list: [4, 5] };
+        expect(deepMerge(target, source)).toEqual({ list: [4, 5] });
+    });
+    it('skips undefined values in source', () => {
+        const target = { a: 1, b: 2 };
+        const source = { a: undefined, b: 3 };
+        expect(deepMerge(target, source)).toEqual({ a: 1, b: 3 });
+    });
+    it('does not mutate the target', () => {
+        const target = { a: 1, nested: { b: 2 } };
+        const original = { a: 1, nested: { b: 2 } };
+        deepMerge(target, { a: 99 });
+        expect(target).toEqual(original);
+    });
+});
+describe('parseDuration', () => {
+    it('parses milliseconds', () => {
+        expect(parseDuration('500ms')).toBe(500);
+    });
+    it('parses seconds', () => {
+        expect(parseDuration('30s')).toBe(30_000);
+    });
+    it('parses minutes', () => {
+        expect(parseDuration('2m')).toBe(120_000);
+    });
+    it('returns 60000 for invalid input', () => {
+        expect(parseDuration('invalid')).toBe(60_000);
+        expect(parseDuration('')).toBe(60_000);
+        expect(parseDuration('10x')).toBe(60_000);
+    });
+});
+describe('getPackageRoot', () => {
+    it('returns a path containing package.json', async () => {
+        const root = await getPackageRoot();
+        expect(existsSync(join(root, 'package.json'))).toBe(true);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/utils.test.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Workspace — Creates and manages isolated OpenClaw workspace directories.
+ *
+ * Each bot gets a profile directory at ~/.openclaw-claw-harness-<id>/
+ * containing openclaw.json, USER.md, and skills.
+ */
+import type { BotConfig } from './types.js';
+import type { BotRuntimeConfig } from './bot.js';
+export declare class Workspace {
+    readonly profileName: string;
+    private _profileDir;
+    private workspaceSubdir;
+    private skillsDir;
+    get profileDir(): string;
+    constructor(botId: string, baseDir: string);
+    /**
+     * Create the workspace directory structure and populate files.
+     */
+    setup(config: BotConfig, runtime: BotRuntimeConfig): Promise<void>;
+    /**
+     * Remove the workspace directory.
+     */
+    cleanup(): Promise<void>;
+    private buildConfig;
+    private loadPreset;
+    private installSkill;
+    /**
+     * Resolve content that could be a file path or inline string.
+     * Tries: absolute path, cwd-relative, package-root-relative, then inline.
+     */
+    resolveContent(pathOrContent: string): Promise<string>;
+}
+//# 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;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGhD,qBAAa,SAAS;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,SAAS,CAAQ;IAEzB,IAAI,UAAU,IAAI,MAAM,CAA4B;gBAExC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQ1C;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CxE;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,WAAW;YA2DX,UAAU;YAyBV,YAAY;IA4B1B;;;OAGG;IACG,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CA4B7D"}

package/dist/workspace.js

@@ -0,0 +1,198 @@
+/**
+ * Workspace — Creates and manages isolated OpenClaw workspace directories.
+ *
+ * Each bot gets a profile directory at ~/.openclaw-claw-harness-<id>/
+ * containing openclaw.json, USER.md, and skills.
+ */
+import { mkdir, writeFile, rm, readFile, access } from 'node:fs/promises';
+import { join, resolve, isAbsolute } from 'node:path';
+import JSON5 from 'json5';
+import { deepMerge, getPackageRoot } from './utils.js';
+export class Workspace {
+    profileName;
+    _profileDir;
+    workspaceSubdir;
+    skillsDir;
+    get profileDir() { return this._profileDir; }
+    constructor(botId, baseDir) {
+        this.profileName = `claw-harness-${botId}`;
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '/tmp';
+        this._profileDir = join(home, `.openclaw-${this.profileName}`);
+        this.workspaceSubdir = join(this._profileDir, 'workspace');
+        this.skillsDir = join(this.workspaceSubdir, 'skills');
+    }
+    /**
+     * Create the workspace directory structure and populate files.
+     */
+    async setup(config, runtime) {
+        // Create directory structure
+        await mkdir(this.skillsDir, { recursive: true });
+        // Write openclaw.json
+        const openclawConfig = await this.buildConfig(config, runtime);
+        await writeFile(join(this._profileDir, 'openclaw.json'), JSON.stringify(openclawConfig, null, 2));
+        // Write .env file with API keys so the agent can find them
+        const envLines = [];
+        if (runtime.anthropicApiKey) {
+            envLines.push(`ANTHROPIC_API_KEY=${runtime.anthropicApiKey}`);
+        }
+        if (runtime.openaiApiKey) {
+            envLines.push(`OPENAI_API_KEY=${runtime.openaiApiKey}`);
+        }
+        if (envLines.length > 0) {
+            await writeFile(join(this._profileDir, '.env'), envLines.join('\n') + '\n');
+        }
+        // Write USER.md (persona)
+        if (config.userMd) {
+            const content = await this.resolveContent(config.userMd);
+            await writeFile(join(this.workspaceSubdir, 'USER.md'), content);
+        }
+        // Write SOUL.md (personality)
+        if (config.soulMd) {
+            const content = await this.resolveContent(config.soulMd);
+            await writeFile(join(this.workspaceSubdir, 'SOUL.md'), content);
+        }
+        // Install skills
+        if (config.skills) {
+            for (const skill of config.skills) {
+                await this.installSkill(skill);
+            }
+        }
+    }
+    /**
+     * Remove the workspace directory.
+     */
+    async cleanup() {
+        try {
+            await rm(this._profileDir, { recursive: true, force: true });
+        }
+        catch {
+            // Best-effort cleanup
+        }
+    }
+    async buildConfig(config, runtime) {
+        // Load preset if specified
+        let base = {};
+        if (config.preset) {
+            base = await this.loadPreset(config.preset);
+        }
+        // Build the config, merging preset with overrides
+        const token = `claw-harness-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+        // Build agents defaults with optional web_fetch allowlist
+        const agentsDefaults = {};
+        if (config.model) {
+            agentsDefaults.model = { primary: config.model };
+        }
+        if (config.allowedHosts && config.allowedHosts.length > 0) {
+            agentsDefaults.web_fetch = {
+                allowed_hosts: config.allowedHosts,
+            };
+        }
+        let result = deepMerge(base, {
+            gateway: {
+                mode: 'local',
+                port: runtime.port,
+                auth: { token },
+                http: {
+                    endpoints: {
+                        chatCompletions: { enabled: true },
+                    },
+                },
+            },
+            agents: {
+                defaults: agentsDefaults,
+                list: [{ id: 'main', default: true }],
+            },
+            skills: {
+                allowBundled: [],
+            },
+        });
+        // Docker mode: enable headless browser with Chromium
+        if (runtime.mode === 'docker') {
+            result = deepMerge(result, {
+                browser: { enabled: true, headless: true, noSandbox: true },
+            });
+        }
+        // Apply user-specified overrides
+        if (config.configOverrides) {
+            return deepMerge(result, config.configOverrides);
+        }
+        return result;
+    }
+    async loadPreset(name) {
+        const pkgRoot = await getPackageRoot();
+        // Search order: cwd presets -> package presets
+        const presetsLocations = [
+            join(process.cwd(), 'presets', 'configs', `${name}.json5`),
+            join(process.cwd(), 'presets', 'configs', `${name}.json`),
+            join(pkgRoot, 'presets', 'configs', `${name}.json5`),
+            join(pkgRoot, 'presets', 'configs', `${name}.json`),
+        ];
+        for (const loc of presetsLocations) {
+            try {
+                await access(loc);
+                const content = await readFile(loc, 'utf-8');
+                return JSON5.parse(content);
+            }
+            catch {
+                continue;
+            }
+        }
+        console.warn(`Warning: preset "${name}" not found, using empty config`);
+        return {};
+    }
+    async installSkill(skill) {
+        const skillName = skill.name ?? 'skill';
+        const skillDir = join(this.skillsDir, skillName);
+        await mkdir(skillDir, { recursive: true });
+        let content;
+        if (skill.url) {
+            // Fetch from URL with timeout
+            const response = await fetch(skill.url, {
+                signal: AbortSignal.timeout(30_000),
+            });
+            if (!response.ok) {
+                throw new Error(`Failed to fetch skill from ${skill.url}: ${response.status}`);
+            }
+            content = await response.text();
+        }
+        else if (skill.path) {
+            // Read from local file
+            content = await readFile(skill.path, 'utf-8');
+        }
+        else {
+            throw new Error('Skill must have either url or path');
+        }
+        await writeFile(join(skillDir, 'SKILL.md'), content);
+    }
+    /**
+     * Resolve content that could be a file path or inline string.
+     * Tries: absolute path, cwd-relative, package-root-relative, then inline.
+     */
+    async resolveContent(pathOrContent) {
+        // If it contains newlines or doesn't look like a path, treat as inline content
+        if (pathOrContent.includes('\n') || !pathOrContent.match(/\.\w+$/)) {
+            return pathOrContent;
+        }
+        // Try resolving as file path from multiple locations
+        const candidates = [];
+        if (isAbsolute(pathOrContent)) {
+            candidates.push(pathOrContent);
+        }
+        else {
+            candidates.push(resolve(process.cwd(), pathOrContent));
+            const pkgRoot = await getPackageRoot();
+            candidates.push(resolve(pkgRoot, pathOrContent));
+        }
+        for (const candidate of candidates) {
+            try {
+                return await readFile(candidate, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+        }
+        // Fall back to treating it as inline content
+        return pathOrContent;
+    }
+}
+//# 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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"}

package/dist/workspace.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workspace.test.d.ts.map

package/dist/workspace.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.test.d.ts","sourceRoot":"","sources":["../src/workspace.test.ts"],"names":[],"mappings":""}

package/dist/workspace.test.js

@@ -0,0 +1,68 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { Workspace } from './workspace.js';
+import { mkdir, writeFile, readFile, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+const TEST_DIR = join(tmpdir(), 'claw-harness-workspace-test');
+describe('Workspace', () => {
+    beforeEach(async () => {
+        await mkdir(TEST_DIR, { recursive: true });
+    });
+    afterEach(async () => {
+        await rm(TEST_DIR, { recursive: true, force: true });
+        // Clean up any test profile directories
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '/tmp';
+        await rm(join(home, '.openclaw-claw-harness-test-ws'), { recursive: true, force: true }).catch(() => { });
+    });
+    it('resolveContent returns inline content for strings with newlines', async () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const result = await ws.resolveContent('line one\nline two');
+        expect(result).toBe('line one\nline two');
+    });
+    it('resolveContent returns inline content for strings without file extension', async () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const result = await ws.resolveContent('You are a friendly bot');
+        expect(result).toBe('You are a friendly bot');
+    });
+    it('resolveContent reads file content for valid paths', async () => {
+        const testFile = join(TEST_DIR, 'test-persona.md');
+        await writeFile(testFile, 'I am a test persona');
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const result = await ws.resolveContent(testFile);
+        expect(result).toBe('I am a test persona');
+    });
+    it('resolveContent falls back to inline for missing file paths', async () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const result = await ws.resolveContent('/nonexistent/file.md');
+        expect(result).toBe('/nonexistent/file.md');
+    });
+    it('installSkill throws for skill with no url or path', async () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const runtime = { mode: 'local', port: 18800, workspaceDir: TEST_DIR, anthropicApiKey: 'test', openaiApiKey: '' };
+        await ws.setup({ skills: [{}] }, runtime).catch(err => {
+            expect(err.message).toBe('Skill must have either url or path');
+        });
+    });
+    it('profileDir getter returns the profile directory path', () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const home = process.env.HOME ?? process.env.USERPROFILE ?? '/tmp';
+        expect(ws.profileDir).toBe(join(home, '.openclaw-claw-harness-test-ws'));
+    });
+    it('docker mode includes browser config in openclaw.json', async () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const runtime = { mode: 'docker', port: 18800, workspaceDir: TEST_DIR, anthropicApiKey: 'test', openaiApiKey: '' };
+        await ws.setup({}, runtime);
+        const configPath = join(ws.profileDir, 'openclaw.json');
+        const config = JSON.parse(await readFile(configPath, 'utf-8'));
+        expect(config.browser).toEqual({ enabled: true, headless: true, noSandbox: true });
+    });
+    it('local mode does not include browser config in openclaw.json', async () => {
+        const ws = new Workspace('test-ws', TEST_DIR);
+        const runtime = { mode: 'local', port: 18800, workspaceDir: TEST_DIR, anthropicApiKey: 'test', openaiApiKey: '' };
+        await ws.setup({}, runtime);
+        const configPath = join(ws.profileDir, 'openclaw.json');
+        const config = JSON.parse(await readFile(configPath, 'utf-8'));
+        expect(config.browser).toBeUndefined();
+    });
+});
+//# sourceMappingURL=workspace.test.js.map

package/dist/workspace.test.js.map

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

package/docker/Dockerfile

@@ -0,0 +1,12 @@
+FROM node:22-slim
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    chromium xvfb fonts-liberation libatk-bridge2.0-0 libdrm2 \
+    libxcomposite1 libxdamage1 libxrandr2 libgbm1 libpango-1.0-0 \
+    libcairo2 libasound2 libnspr4 libnss3 libxss1 libxtst6 \
+    && rm -rf /var/lib/apt/lists/*
+RUN npm install -g openclaw@latest
+ENV CHROME_PATH=/usr/bin/chromium
+ENV PUPPETEER_EXECUTABLE_PATH=/usr/bin/chromium
+COPY entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+ENTRYPOINT ["/entrypoint.sh"]

package/docker/entrypoint.sh

@@ -0,0 +1,6 @@
+#!/bin/bash
+set -e
+Xvfb :99 -screen 0 1280x1024x24 -nolisten tcp &
+sleep 0.5
+export DISPLAY=:99
+exec "$@"

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "claw-harness",
+  "version": "0.1.0",
+  "description": "Testing framework for OpenClaw bots. Spin up real agents, load skills, drive multi-turn prompts, and capture results.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "claw-harness": "dist/bin/clawbench.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "tsc --noEmit",
+    "postbuild": "chmod +x dist/bin/clawbench.js"
+  },
+  "keywords": [
+    "openclaw",
+    "testing",
+    "ai-agents",
+    "benchmark",
+    "bot-testing",
+    "skill-testing"
+  ],
+  "files": ["dist", "presets", "docker"],
+  "author": "Connor Daly connor@iceblock.ventures",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dasconnor/claw-harness.git"
+  },
+  "homepage": "https://github.com/dasconnor/claw-harness#readme",
+  "bugs": {
+    "url": "https://github.com/dasconnor/claw-harness/issues"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "json5": "^2.2.3",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}

package/presets/configs/default.json5

@@ -0,0 +1,28 @@
+{
+  // Claw Harness default bot configuration
+  // Merged into each bot's openclaw.json
+  "gateway": {
+    "mode": "local",
+    // port is set dynamically by Claw Harness
+    "auth": {
+      // token is set dynamically by Claw Harness
+    },
+    "http": {
+      "endpoints": {
+        "chatCompletions": { "enabled": true }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": { "primary": "anthropic/claude-haiku-4-5-20251001" }
+    },
+    "list": [
+      { "id": "main", "default": true }
+    ]
+  },
+  "skills": {
+    // Disable all bundled skills so only test skills are active
+    "allowBundled": []
+  }
+}

package/presets/configs/minimal.json5

@@ -0,0 +1,22 @@
+{
+  // Minimal config — restricted tools, lower cost
+  "gateway": {
+    "mode": "local",
+    "http": {
+      "endpoints": {
+        "chatCompletions": { "enabled": true }
+      }
+    }
+  },
+  "agents": {
+    "defaults": {
+      "model": { "primary": "anthropic/claude-haiku-4-5-20251001" }
+    },
+    "list": [
+      { "id": "main", "default": true }
+    ]
+  },
+  "skills": {
+    "allowBundled": []
+  }
+}

package/presets/personas/curious.md

@@ -0,0 +1,5 @@
+# About Me
+
+I'm a curious, thoughtful AI bot. I ask interesting questions and engage deeply with conversation partners. I prefer substance over small talk and enjoy exploring ideas.
+
+When interacting with platforms or services, I read the documentation carefully and think through my actions before taking them.

package/presets/personas/friendly.md

@@ -0,0 +1,5 @@
+# About Me
+
+I'm a friendly, outgoing AI bot. I enjoy meeting other bots and having casual conversations. I'm enthusiastic, ask follow-up questions, and like to share interesting observations.
+
+When interacting with platforms or services, I explore them naturally — trying things out, reading documentation, and figuring out how things work on my own.

package/presets/personas/terse.md

@@ -0,0 +1,3 @@
+# About Me
+
+I'm a concise, technical bot. I keep responses brief and to the point. I value efficiency and clarity over chattiness.

package/presets/scenarios/example-chat.yaml

@@ -0,0 +1,71 @@
+# Example: Two bots discover a site and have a conversation
+#
+# Usage:
+#   claw-harness run presets/scenarios/example-chat.yaml
+#
+# Prerequisites:
+#   - OpenClaw installed (`npm install -g openclaw@latest`)
+#   - ANTHROPIC_API_KEY set in environment
+#   - Target app running at base_url
+
+name: "Example Chat Test"
+description: "Two bots read a skill.md, register, and have a conversation"
+
+target:
+  base_url: "http://localhost:3000"
+
+bots:
+  alpha:
+    preset: default
+    model: anthropic/claude-haiku-4-5-20251001
+    user_md: presets/personas/friendly.md
+    skills:
+      - url: "http://localhost:3000/skill.md"
+        name: target-app
+
+  beta:
+    preset: default
+    model: anthropic/claude-haiku-4-5-20251001
+    user_md: presets/personas/curious.md
+    skills:
+      - url: "http://localhost:3000/skill.md"
+        name: target-app
+
+steps:
+  # Both bots register
+  - bot: alpha
+    prompt: >
+      Read the skill documentation to understand how this platform works.
+      Then register yourself as a bot on the platform.
+    timeout: 60s
+
+  - bot: beta
+    prompt: >
+      Read the skill documentation to understand how this platform works.
+      Then register yourself as a bot on the platform.
+    timeout: 60s
+
+  # Alpha joins a lounge
+  - bot: alpha
+    prompt: >
+      Browse the platform for active lounges or events.
+      Join one and introduce yourself.
+    timeout: 60s
+
+  # Beta follows
+  - bot: beta
+    prompt: >
+      Browse the platform for active lounges or events.
+      If you see a lounge with another bot, join it and start a conversation.
+    timeout: 60s
+
+  # Back-and-forth conversation
+  - repeat: 3
+    interval: 15s
+    steps:
+      - bot: alpha
+        prompt: "Check for new messages and respond to continue the conversation."
+        timeout: 30s
+      - bot: beta
+        prompt: "Check for new messages and respond to continue the conversation."
+        timeout: 30s