@inhuman.tools/harness 0.0.0-stage → 0.1.0

package/dist/yjs/update-log.js

@@ -0,0 +1,91 @@
+/**
+ * Append-only Yjs image.
+ *
+ * Every update is preceded by its length. A torn final entry is ignored;
+ * earlier complete entries remain readable without rewriting the image.
+ */
+import { Buffer } from "node:buffer";
+import * as decoding from "lib0/decoding";
+import * as Y from "yjs";
+const LENGTH_BYTES = 4;
+/** Unchanged state encodes as `[0, 0]`, not a 0-length buffer. */
+export function isEmptyUpdate(update) {
+    return update.byteLength === 0 || (update.byteLength === 2 && update[0] === 0 && update[1] === 0);
+}
+/**
+ * The updates in order. A caller applies them onto one document one after
+ * another: a later entry is a delta and does not stand on its own, so
+ * merging them into one buffer drops everything after the first.
+ *
+ * A torn last entry (crash before fsync) is dropped. Earlier entries stay.
+ */
+export function readUpdateLog(bytes) {
+    if (bytes.byteLength === 0)
+        return null;
+    const prefixed = readPrefixed(bytes, 0);
+    if (prefixed != null && prefixed.updates.length > 0) {
+        if (!prefixed.updates.every(isOneUpdate))
+            return null;
+        return prefixed.updates;
+    }
+    // Images saved before the length prefix are one bare update. A length read
+    // of those bytes is a torn empty log, which used to report the session missing.
+    if (isOneUpdate(bytes))
+        return [bytes];
+    return null;
+}
+/** Length prefix plus the update. Appending it extends a log. */
+export function encodeLogEntry(update) {
+    const entry = new Uint8Array(LENGTH_BYTES + update.byteLength);
+    writeLength(entry, update.byteLength);
+    entry.set(update, LENGTH_BYTES);
+    return entry;
+}
+/** Length-prefixed entries from `start`. A short final entry is torn, not corrupt. */
+function readPrefixed(bytes, start) {
+    if (start > bytes.byteLength)
+        return null;
+    const updates = [];
+    let offset = start;
+    while (offset + LENGTH_BYTES <= bytes.byteLength) {
+        const length = readLength(bytes, offset);
+        if (length <= 0)
+            return null;
+        if (offset + LENGTH_BYTES + length > bytes.byteLength) {
+            return { updates, torn: true };
+        }
+        updates.push(bytes.subarray(offset + LENGTH_BYTES, offset + LENGTH_BYTES + length));
+        offset += LENGTH_BYTES + length;
+    }
+    if (offset !== bytes.byteLength)
+        return { updates, torn: true };
+    return { updates, torn: false };
+}
+/** Bytes of the first Yjs message, or null when the buffer is not one. */
+function yjsUpdateEnd(bytes) {
+    const decoder = decoding.createDecoder(bytes);
+    const doc = new Y.Doc();
+    try {
+        Y.readUpdate(decoder, doc);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        doc.destroy();
+    }
+    const end = decoder.pos;
+    return end > 0 && end <= bytes.byteLength ? end : null;
+}
+function isOneUpdate(update) {
+    if (update == null)
+        return false;
+    return yjsUpdateEnd(update) === update.byteLength;
+}
+function readLength(bytes, offset) {
+    return Buffer.from(bytes.buffer, bytes.byteOffset + offset, LENGTH_BYTES).readUInt32BE(0);
+}
+function writeLength(bytes, length) {
+    Buffer.from(bytes.buffer, bytes.byteOffset, LENGTH_BYTES).writeUInt32BE(length, 0);
+}
+//# sourceMappingURL=update-log.js.map

package/dist/yjs/update-log.js.map

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

package/dist/yjs/websocket.d.ts

@@ -0,0 +1,4 @@
+import { WebSocket } from "ws";
+import type { PlaneSocket } from "./relay.js";
+export declare function wrapWebSocket(ws: WebSocket): PlaneSocket;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/yjs/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../src/yjs/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,WAAW,CAyCxD"}

package/dist/yjs/websocket.js

@@ -0,0 +1,47 @@
+import { WebSocket } from "ws";
+import { keepPlaneAlive } from "./keepalive.js";
+export function wrapWebSocket(ws) {
+    let closed = false;
+    keepPlaneAlive({
+        get readyState() {
+            return closed ? 3 : ws.readyState;
+        },
+        ping: () => {
+            ws.ping();
+        },
+        send: (data, options) => {
+            ws.send(data, { binary: options?.binary ?? true });
+        },
+        on: (event, listener) => {
+            ws.on(event, listener);
+        },
+    });
+    return {
+        send: (frame) => {
+            if (closed || ws.readyState !== WebSocket.OPEN)
+                return;
+            ws.send(frame, { binary: true });
+        },
+        sendText: (text) => {
+            if (closed || ws.readyState !== WebSocket.OPEN)
+                return;
+            ws.send(text);
+        },
+        close: (code, reason) => {
+            closed = true;
+            ws.close(code, reason);
+        },
+        onBinary: (handler) => ws.on("message", (data, isBinary) => {
+            if (closed || !isBinary)
+                return;
+            handler(new Uint8Array(Buffer.isBuffer(data) ? data : Buffer.concat(data)));
+        }),
+        onText: (handler) => ws.on("message", (data, isBinary) => {
+            if (closed || isBinary)
+                return;
+            handler(data.toString());
+        }),
+        onClose: (handler) => ws.on("close", handler),
+    };
+}
+//# sourceMappingURL=websocket.js.map

package/dist/yjs/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/yjs/websocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,MAAM,UAAU,aAAa,CAAC,EAAa;IACzC,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,cAAc,CAAC;QACb,IAAI,UAAU;YACZ,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;QACpC,CAAC;QACD,IAAI,EAAE,GAAG,EAAE;YACT,EAAE,CAAC,IAAI,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACtB,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACtB,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzB,CAAC;KACF,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,MAAM,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,OAAO;YACvD,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnC,CAAC;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;YACjB,IAAI,MAAM,IAAI,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI;gBAAE,OAAO;YACvD,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;QACD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YACtB,MAAM,GAAG,IAAI,CAAC;YACd,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,EAAE,CACpB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YAClC,IAAI,MAAM,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAChC,OAAO,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAgB,CAAC,CAAC,CAAC,CAAC;QAC1F,CAAC,CAAC;QACJ,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAClB,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE;YAClC,IAAI,MAAM,IAAI,QAAQ;gBAAE,OAAO;YAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3B,CAAC,CAAC;QACJ,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,116 @@
 {
   "name": "@inhuman.tools/harness",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Harness core: the daemon (kernel and session planes), runtime, providers and the Yjs sync plane. Shells attach over harness-peer or harness-sdk.",
+  "type": "module",
+  "bin": {
+    "harness-daemon": "./dist/server/bin.js",
+    "harness-yjs-server": "./dist/yjs/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./testkit": {
+      "types": "./dist/server/testkit/index.d.ts",
+      "import": "./dist/server/testkit/index.js",
+      "default": "./dist/server/testkit/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "compact.scm",
+    "compact.prompt",
+    "src/server/defaults",
+    "!**/__tests__"
+  ],
+  "dependencies": {
+    "@ff-labs/fff-node": "0.10.1",
+    "@here.build/arrival": "^0.10.2",
+    "@here.build/arrival-modules": "^0.10.0",
+    "@here.build/arrival-provenance": "^0.10.0",
+    "@here.build/arrival-serializer": "^0.10.2",
+    "@here.build/arrival-sugarcoat": "^0.10.0",
+    "@here.build/collections": "^0.9.0",
+    "@here.build/plexus": "^0.9.6",
+    "@modelcontextprotocol/sdk": "1.26.0",
+    "dedent": "1.7.2",
+    "fast-deep-equal": "3.1.3",
+    "fs-extra": "11.4.0",
+    "lib0": "0.2.119",
+    "mobx": "6.16.1",
+    "pngjs": "7.0.0",
+    "tiny-invariant": "^1.3.3",
+    "undici": "^8.10.2",
+    "ws": "8.18.3",
+    "y-protocols": "1.0.7",
+    "y-websocket": "3.1.0",
+    "yaml": "^2.8.0",
+    "yjs": "13.6.33",
+    "zod": "^4.4.3",
+    "@inhuman.tools/error-with-invariant": "^0.1.0",
+    "@inhuman.tools/env-capability-module-prompt": "^0.1.0",
+    "@inhuman.tools/harness-commons": "^0.1.0",
+    "@inhuman.tools/harness-model": "^0.1.0",
+    "@inhuman.tools/harness-diagnostics": "^0.1.0",
+    "@inhuman.tools/activity": "^0.1.0",
+    "@inhuman.tools/harness-scheme": "^0.1.0",
+    "@inhuman.tools/harness-sdk": "^0.1.0",
+    "@inhuman.tools/harness-peer": "^0.1.0",
+    "@inhuman.tools/plexus-expectations": "^0.1.0",
+    "@inhuman.tools/continuation": "^0.1.0",
+    "@inhuman.tools/plugin-sdk": "^0.1.0",
+    "@inhuman.tools/policy": "^0.1.0",
+    "@inhuman.tools/pretty-mcp": "^0.1.0",
+    "@inhuman.tools/harness-provider-sdk": "^0.1.0",
+    "@inhuman.tools/scheme-program": "^0.1.0",
+    "@inhuman.tools/harness-contract": "^0.1.0",
+    "@inhuman.tools/plugin-tasks": "^0.1.0",
+    "@inhuman.tools/substrate": "^0.9.0",
+    "@inhuman.tools/tool-call-normalize": "^0.1.0",
+    "@inhuman.tools/scheme-watch": "^0.1.0",
+    "@inhuman.tools/turn": "^0.1.0",
+    "@inhuman.tools/statusline": "^0.1.0",
+    "@inhuman.tools/project-instructions": "^0.1.0",
+    "@inhuman.tools/project-skills": "^0.1.0"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/server-filesystem": "2026.7.10",
+    "@types/express": "5.0.3",
+    "@types/fs-extra": "11.0.4",
+    "@types/node": "^24.0.0",
+    "@types/pngjs": "6.0.5",
+    "@types/ws": "8.18.1",
+    "eslint": "9.39.2",
+    "express": "5.2.1",
+    "typescript": "6.0.2",
+    "vitest": "4.1.0",
+    "@-internal-/eslint-configs": "0.0.0",
+    "@inhuman.tools/harness-client": "^0.0.1"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/here-build/inhuman-harness.git",
+    "directory": "packages/harness"
+  },
+  "browserslist": [
+    "node >= 22"
+  ],
+  "author": "Merkle Bonsai",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node ./scripts/src-alias.mjs",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "tsc -p tsconfig.json --noEmit && vitest run --project logic --project server",
+    "test:process": "tsc -p tsconfig.json --noEmit && vitest run --project server-process",
+    "research": "vitest run --project research"
+  }
 }

package/src/server/defaults/__tests__/resolve-compact-strategy-path.test.ts

@@ -0,0 +1,31 @@
+import { mkdtemp, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { describe, expect, it } from "vitest";
+
+import { packageStrategyPath, resolveCompactStrategyPath } from "../index.js";
+import { shippedPolicyFile } from "../policy-asset.js";
+
+describe("resolveCompactStrategyPath", () => {
+  it("resolves the package name to the shipped strategy", () => {
+    const root = join(tmpdir(), "compact-strategy-unused");
+    const shipped = packageStrategyPath();
+    expect(resolveCompactStrategyPath("@inhuman.tools/harness/compact.scm", root)).toBe(shipped);
+  });
+
+  it("resolves policy-processor document tokens onto the shipped policy assets", () => {
+    const root = join(tmpdir(), "compact-strategy-unused");
+    const ask = shippedPolicyFile("auto-mode-ask.scm");
+    expect(resolveCompactStrategyPath("@inhuman.tools/policy-processor/auto-mode-ask.scm", root)).toBe(ask);
+    expect(() => resolveCompactStrategyPath("@inhuman.tools/judge-processor/auto-mode-judge.scm", root)).toThrow();
+  });
+
+  it("still fails an unknown package prefix through node resolution", async () => {
+    const root = await mkdtemp(join(tmpdir(), "compact-strategy-"));
+    await writeFile(join(root, "package.json"), JSON.stringify({ name: "kernel", private: true }));
+    expect(() => resolveCompactStrategyPath("@inhuman.tools/not-harness/compact.scm", root)).toThrow(
+      expect.objectContaining({ code: "MODULE_NOT_FOUND" }),
+    );
+  });
+});