@harness-control/runner 0.1.0

package/dist/workspaces/index.js

@@ -0,0 +1,110 @@
+import { createHash, randomUUID } from "node:crypto";
+import { open, readFile, realpath, rename, rm, stat } from "node:fs/promises";
+import { isAbsolute, relative, sep } from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { z } from "zod";
+import { RunnerConfigSchema } from "../config/index.js";
+export class WorkspaceManager {
+    config;
+    configPath;
+    sessions;
+    constructor(config, configPath, sessions) {
+        this.config = config;
+        this.configPath = configPath;
+        this.sessions = sessions;
+    }
+    snapshot() {
+        return {
+            revision: this.config.workspace_revision ?? createHash("sha256").update(JSON.stringify(this.config.workspaces)).digest("hex"),
+            allowed_roots: this.configPath ? this.config.workspace_management?.allowed_roots ?? [] : [],
+        };
+    }
+    async execute(requestId, request) {
+        let outcome;
+        try {
+            if (request.operation.kind === "list") {
+                if (Date.parse(request.expires_at) <= Date.now())
+                    throw new Error("Request expired. Refresh workspaces.");
+            }
+            else {
+                await this.sessions.updateWorkspaceConfiguration(() => this.change(request));
+            }
+            outcome = { kind: "success" };
+        }
+        catch (error) {
+            outcome = { kind: "error", message: error instanceof Error ? error.message.slice(0, 1000) : "Workspace update failed." };
+        }
+        return { request_id: requestId, outcome, management: this.snapshot(), workspaces: this.config.workspaces.map(workspace => ({ ...workspace })) };
+    }
+    async change(request) {
+        if (Date.parse(request.expires_at) <= Date.now())
+            throw new Error("Request expired. Refresh workspaces.");
+        const configPath = this.configPath;
+        const roots = this.snapshot().allowed_roots;
+        if (!configPath || roots.length === 0)
+            throw new Error("Workspace management is disabled. Configure workspace_management.allowed_roots locally, then restart the runner.");
+        if (request.expected_revision !== this.snapshot().revision)
+            throw new Error("Workspaces changed. Refresh and try again.");
+        const operation = request.operation;
+        let workspaces = this.config.workspaces.map(workspace => ({ ...workspace }));
+        if (operation.kind === "add") {
+            if (!isAbsolute(operation.path))
+                throw new Error("Use an absolute folder path on this machine.");
+            const path = await realpath(operation.path);
+            if (!(await stat(path)).isDirectory())
+                throw new Error("The workspace must be an existing folder.");
+            const canonicalRoots = await Promise.all(roots.map(root => realpath(root)));
+            if (!canonicalRoots.some(root => contained(root, path)))
+                throw new Error("The folder is outside this machine’s allowed roots.");
+            const existingPaths = await Promise.all(workspaces.map(async (workspace) => {
+                try {
+                    return await realpath(workspace.path);
+                }
+                catch (error) {
+                    if (error instanceof Error && "code" in error && error.code === "ENOENT")
+                        return workspace.path;
+                    throw error;
+                }
+            }));
+            if (existingPaths.includes(path))
+                throw new Error("This folder is already registered.");
+            workspaces.push({ id: randomUUID(), path, display_name: operation.display_name });
+        }
+        else if (operation.kind === "rename" || operation.kind === "remove") {
+            const workspace = workspaces.find(entry => entry.id === operation.id);
+            if (!workspace)
+                throw new Error("Workspace no longer exists. Refresh the list.");
+            if (operation.kind === "rename")
+                workspace.display_name = operation.display_name;
+            else
+                workspaces = workspaces.filter(entry => entry.id !== operation.id);
+        }
+        const raw = z.record(z.string(), z.unknown()).parse(JSON.parse(await readFile(configPath, "utf8")));
+        if (!isDeepStrictEqual(RunnerConfigSchema.parse(raw), this.config))
+            throw new Error("Runner configuration changed on disk. Restart the runner before managing workspaces.");
+        const revision = randomUUID();
+        RunnerConfigSchema.parse({ ...raw, workspaces, workspace_revision: revision });
+        const temporaryPath = `${configPath}.${randomUUID()}.tmp`;
+        try {
+            const file = await open(temporaryPath, "wx", 0o600);
+            try {
+                await file.writeFile(`${JSON.stringify({ ...raw, workspaces, workspace_revision: revision }, null, 2)}\n`);
+                await file.sync();
+            }
+            finally {
+                await file.close();
+            }
+            await rename(temporaryPath, configPath);
+            this.config.workspaces = workspaces;
+            this.config.workspace_revision = revision;
+        }
+        finally {
+            await rm(temporaryPath, { force: true });
+        }
+    }
+}
+function contained(root, path) {
+    const child = relative(root, path);
+    return child === "" || (!isAbsolute(child) && child !== ".." && !child.startsWith(`..${sep}`));
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@harness-control/runner",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "hcp-runner": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./connection": {
+      "types": "./dist/connection/index.d.ts",
+      "import": "./dist/connection/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./harnesses": {
+      "types": "./dist/harnesses/index.d.ts",
+      "import": "./dist/harnesses/index.js"
+    },
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js"
+    },
+    "./state": {
+      "types": "./dist/state/index.d.ts",
+      "import": "./dist/state/index.js"
+    },
+    "./pairing": {
+      "types": "./dist/pairing/index.d.ts",
+      "import": "./dist/pairing/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false",
+    "test": "node --import tsx --test --test-concurrency=1 src/**/*.test.ts"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.267",
+    "@harness-control/protocol": "0.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "ws": "^8.21.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1"
+  },
+  "description": "Local coding-agent runner for Harness Control Protocol",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qazisaad/harness-control-protocol.git",
+    "directory": "packages/hcp-runner"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/**/test/**",
+    "!dist/**/*.map",
+    "README.md",
+    "LICENSE"
+  ]
+}