xo-harness 0.1.0

package/dist/internal/storage/jsonl-event-store.js

@@ -0,0 +1,105 @@
+import { appendFile, mkdir, open, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { HarnessEventSchema, parseHarnessEvent, stringifyHarnessEvent, } from "../protocol/index.js";
+import { SessionAppendTails } from "./append-tail.js";
+const safeSessionId = /^[A-Za-z0-9_-]+$/;
+/**
+ * Local JSONL persistence for one harness process. Cross-process writer fencing and
+ * directory fsync for newly published session files are deferred to the resume slice.
+ */
+export class JsonlEventStore {
+    #rootDirectory;
+    #tails = new SessionAppendTails();
+    #nextSequence = new Map();
+    constructor(rootDirectory) {
+        this.#rootDirectory = rootDirectory;
+    }
+    async append(event) {
+        this.#assertSessionId(event.sessionId);
+        return this.#tails.run(event.sessionId, async () => {
+            const sequence = await this.#takeSequence(event.sessionId);
+            const stored = HarnessEventSchema.parse({ ...event, sequence });
+            await mkdir(this.#rootDirectory, { recursive: true });
+            await appendFile(this.#sessionPath(event.sessionId), `${stringifyHarnessEvent(stored)}\n`, "utf8");
+            return stored;
+        });
+    }
+    flush(sessionId) {
+        this.#assertSessionId(sessionId);
+        return this.#tails.run(sessionId, async () => {
+            try {
+                const file = await open(this.#sessionPath(sessionId), "r");
+                try {
+                    await file.sync();
+                }
+                finally {
+                    await file.close();
+                }
+            }
+            catch (error) {
+                if (error.code === "ENOENT")
+                    return;
+                throw error;
+            }
+        });
+    }
+    async list(sessionId) {
+        this.#assertSessionId(sessionId);
+        await this.#tails.settled(sessionId);
+        let contents;
+        try {
+            contents = await readFile(this.#sessionPath(sessionId), "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+        return parseCompleteLines(contents);
+    }
+    async #takeSequence(sessionId) {
+        const known = this.#nextSequence.get(sessionId);
+        if (known !== undefined) {
+            this.#nextSequence.set(sessionId, known + 1);
+            return known;
+        }
+        const events = await this.#repairAndRead(sessionId);
+        const next = (events.at(-1)?.sequence ?? 0) + 1;
+        this.#nextSequence.set(sessionId, next + 1);
+        return next;
+    }
+    async #repairAndRead(sessionId) {
+        let contents;
+        try {
+            contents = await readFile(this.#sessionPath(sessionId), "utf8");
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return [];
+            throw error;
+        }
+        if (contents.length > 0 && !contents.endsWith("\n")) {
+            const lastNewline = contents.lastIndexOf("\n");
+            contents = lastNewline === -1 ? "" : contents.slice(0, lastNewline + 1);
+            await writeFile(this.#sessionPath(sessionId), contents, "utf8");
+        }
+        return parseCompleteLines(contents);
+    }
+    #sessionPath(sessionId) {
+        return path.join(this.#rootDirectory, `${sessionId}.jsonl`);
+    }
+    #assertSessionId(sessionId) {
+        if (!safeSessionId.test(sessionId)) {
+            throw new Error(`Unsafe session id: ${sessionId}`);
+        }
+    }
+}
+function parseCompleteLines(contents) {
+    const completeContents = contents.endsWith("\n")
+        ? contents
+        : contents.slice(0, Math.max(0, contents.lastIndexOf("\n") + 1));
+    return completeContents
+        .split("\n")
+        .filter((line) => line.length > 0)
+        .map(parseHarnessEvent);
+}

package/dist/internal/storage/memory-event-store.d.ts

@@ -0,0 +1,8 @@
+import { type HarnessEvent, type UnsequencedHarnessEvent } from "../protocol/index.js";
+import type { EventStore } from "./event-store.js";
+export declare class MemoryEventStore implements EventStore {
+    #private;
+    append(event: UnsequencedHarnessEvent): Promise<HarnessEvent>;
+    flush(sessionId: string): Promise<void>;
+    list(sessionId: string): Promise<readonly HarnessEvent[]>;
+}

package/dist/internal/storage/memory-event-store.js

@@ -0,0 +1,22 @@
+import { HarnessEventSchema } from "../protocol/index.js";
+import { SessionAppendTails } from "./append-tail.js";
+export class MemoryEventStore {
+    #events = new Map();
+    #tails = new SessionAppendTails();
+    append(event) {
+        return this.#tails.run(event.sessionId, async () => {
+            const sessionEvents = this.#events.get(event.sessionId) ?? [];
+            const stored = HarnessEventSchema.parse({ ...event, sequence: sessionEvents.length + 1 });
+            sessionEvents.push(stored);
+            this.#events.set(event.sessionId, sessionEvents);
+            return stored;
+        });
+    }
+    flush(sessionId) {
+        return this.#tails.run(sessionId, async () => undefined);
+    }
+    async list(sessionId) {
+        await this.#tails.settled(sessionId);
+        return [...(this.#events.get(sessionId) ?? [])];
+    }
+}

package/dist/protocol.d.ts

@@ -0,0 +1 @@
+export * from "./internal/protocol/index.js";

package/dist/protocol.js

@@ -0,0 +1 @@
+export * from "./internal/protocol/index.js";

package/dist/provider-workers.d.ts

@@ -0,0 +1 @@
+export * from "./internal/provider/workers.js";

package/dist/provider-workers.js

@@ -0,0 +1 @@
+export * from "./internal/provider/workers.js";

package/dist/provider.d.ts

@@ -0,0 +1 @@
+export * from "./internal/provider/index.js";

package/dist/provider.js

@@ -0,0 +1 @@
+export * from "./internal/provider/index.js";

package/dist/storage.d.ts

@@ -0,0 +1 @@
+export * from "./internal/storage/index.js";

package/dist/storage.js

@@ -0,0 +1 @@
+export * from "./internal/storage/index.js";

package/dist/testing.d.ts

@@ -0,0 +1 @@
+export * from "./internal/provider-fake/index.js";

package/dist/testing.js

@@ -0,0 +1 @@
+export * from "./internal/provider-fake/index.js";

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "xo-harness",
+  "version": "0.1.0",
+  "description": "A TypeScript-first agent harness for continuous, fully duplex voice models.",
+  "type": "module",
+  "sideEffects": [
+    "./dist/provider.js",
+    "./dist/provider-workers.js"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./harness": {
+      "types": "./dist/harness.d.ts",
+      "default": "./dist/harness.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "default": "./dist/protocol.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "default": "./dist/provider.js"
+    },
+    "./provider/workers": {
+      "types": "./dist/provider-workers.d.ts",
+      "default": "./dist/provider-workers.js"
+    },
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "default": "./dist/storage.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs"
+  },
+  "dependencies": {
+    "ws": "8.21.1",
+    "zod": "4.4.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zvadaadam/XO.git",
+    "directory": "packages/xo"
+  },
+  "homepage": "https://github.com/zvadaadam/XO#readme",
+  "bugs": {
+    "url": "https://github.com/zvadaadam/XO/issues"
+  },
+  "keywords": [
+    "agent",
+    "ai",
+    "voice",
+    "realtime",
+    "harness",
+    "tools"
+  ]
+}