pi-harness-runtime 0.9.19 → 0.9.21

package/packages/dependency-analyzer/test/analyzer.test.js

@@ -0,0 +1,37 @@
+import { describe, it } from "node:test";
+import { deepEqual } from "node:assert";
+import { parseImports } from "../src/imports.js";
+describe("parseImports", () => {
+    it("parses ESM default import", () => {
+        const result = parseImports("import x from './y';", "file.ts");
+        deepEqual(result, ["./y"]);
+    });
+    it("parses ESM named import", () => {
+        const result = parseImports("import { a, b } from './x';", "file.ts");
+        deepEqual(result, ["./x"]);
+    });
+    it("parses ESM package import", () => {
+        const result = parseImports("import lodash from 'lodash';", "file.ts");
+        deepEqual(result, ["lodash"]);
+    });
+    it("parses CommonJS require", () => {
+        const result = parseImports("const x = require('./y');", "file.ts");
+        deepEqual(result, ["./y"]);
+    });
+    it("parses Python from-import", () => {
+        const result = parseImports("from os import path", "file.py");
+        deepEqual(result, ["os"]);
+    });
+    it("parses Python direct import", () => {
+        const result = parseImports("import numpy", "file.py");
+        deepEqual(result, ["numpy"]);
+    });
+    it("returns empty for empty file", () => {
+        const result = parseImports("", "file.ts");
+        deepEqual(result, []);
+    });
+    it("deduplicates imports", () => {
+        const result = parseImports("import x from './y';\nimport z from './y';", "file.ts");
+        deepEqual(result, ["./y"]);
+    });
+});

package/packages/dependency-analyzer/test/analyzer.test.ts

@@ -0,0 +1,48 @@
+import { describe, it } from "node:test";
+import { equal, deepEqual } from "node:assert";
+import { parseImports } from "../src/imports.js";
+
+describe("parseImports", () => {
+	it("parses ESM default import", () => {
+		const result = parseImports("import x from './y';", "file.ts");
+		deepEqual(result, ["./y"]);
+	});
+
+	it("parses ESM named import", () => {
+		const result = parseImports("import { a, b } from './x';", "file.ts");
+		deepEqual(result, ["./x"]);
+	});
+
+	it("parses ESM package import", () => {
+		const result = parseImports("import lodash from 'lodash';", "file.ts");
+		deepEqual(result, ["lodash"]);
+	});
+
+	it("parses CommonJS require", () => {
+		const result = parseImports("const x = require('./y');", "file.ts");
+		deepEqual(result, ["./y"]);
+	});
+
+	it("parses Python from-import", () => {
+		const result = parseImports("from os import path", "file.py");
+		deepEqual(result, ["os"]);
+	});
+
+	it("parses Python direct import", () => {
+		const result = parseImports("import numpy", "file.py");
+		deepEqual(result, ["numpy"]);
+	});
+
+	it("returns empty for empty file", () => {
+		const result = parseImports("", "file.ts");
+		deepEqual(result, []);
+	});
+
+	it("deduplicates imports", () => {
+		const result = parseImports(
+			"import x from './y';\nimport z from './y';",
+			"file.ts",
+		);
+		deepEqual(result, ["./y"]);
+	});
+});

package/packages/dependency-analyzer/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": ".",
+    "types": ["node"],
+    "lib": ["ES2022"]
+  },
+  "include": ["src/**/*"]
+}

package/packages/event-bus/dist/bus.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event Bus — pub/sub implementation
+ */
+import type { Subscriber, Subscription, EventPayload } from "./types.js";
+export declare class EventBus {
+    private readonly subs;
+    private readonly byTopic;
+    publish<T>(topic: string, data: T, source?: string): string;
+    subscribe<T>(topic: string, subscriber: Subscriber<T>, filter?: (data: T) => boolean, priority?: number): string;
+    unsubscribe(subscriptionId: string): void;
+    unsubscribeAll(topic?: string): void;
+    replay(topic: string, events: EventPayload<unknown>[]): void;
+    getSubscribers(topic?: string): Subscription[];
+}
+//# sourceMappingURL=bus.d.ts.map

package/packages/event-bus/dist/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,SAAW,GAAG,MAAM,CA6B5D;IAED,SAAS,CAAC,CAAC,EACV,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,EAC7B,QAAQ,SAAI,GACV,MAAM,CAcR;IAED,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAMxC;IAED,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAWnC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAM3D;IAED,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAM7C;CACD"}

package/packages/event-bus/dist/bus.js

@@ -0,0 +1,90 @@
+/**
+ * Event Bus — pub/sub implementation
+ */
+import { randomUUID } from "node:crypto";
+export class EventBus {
+    subs = new Map();
+    byTopic = new Map();
+    publish(topic, data, source = "system") {
+        const eventId = randomUUID();
+        const timestamp = new Date().toISOString();
+        const payload = { topic, data, timestamp, eventId, source };
+        const topicIds = this.byTopic.get(topic) ?? new Set();
+        const wildcardIds = this.byTopic.get("*") ?? new Set();
+        const matches = [];
+        for (const sid of [...topicIds, ...wildcardIds]) {
+            const sub = this.subs.get(sid);
+            if (!sub || !sub.active)
+                continue;
+            if (sub.filter && !sub.filter(data))
+                continue;
+            matches.push({ sub, payload });
+        }
+        matches.sort((a, b) => b.sub.priority - a.sub.priority);
+        for (const { sub } of matches) {
+            try {
+                sub.subscriber(payload);
+            }
+            catch {
+                sub.active = false;
+                this.subs.delete(sub.id);
+                this.byTopic.get(sub.topic)?.delete(sub.id);
+            }
+        }
+        return eventId;
+    }
+    subscribe(topic, subscriber, filter, priority = 0) {
+        const id = randomUUID();
+        const sub = {
+            id,
+            topic,
+            subscriber: subscriber,
+            filter: filter,
+            priority,
+            active: true,
+        };
+        this.subs.set(id, sub);
+        if (!this.byTopic.has(topic))
+            this.byTopic.set(topic, new Set());
+        this.byTopic.get(topic).add(id);
+        return id;
+    }
+    unsubscribe(subscriptionId) {
+        const sub = this.subs.get(subscriptionId);
+        if (!sub)
+            return;
+        sub.active = false;
+        this.subs.delete(subscriptionId);
+        this.byTopic.get(sub.topic)?.delete(subscriptionId);
+    }
+    unsubscribeAll(topic) {
+        if (topic) {
+            const ids = this.byTopic.get(topic);
+            if (ids) {
+                for (const id of ids)
+                    this.unsubscribe(id);
+                this.byTopic.delete(topic);
+            }
+        }
+        else {
+            for (const id of this.subs.keys())
+                this.unsubscribe(id);
+            this.byTopic.clear();
+        }
+    }
+    replay(topic, events) {
+        for (const event of events) {
+            if (event.topic === topic || topic === "*") {
+                this.publish(event.topic, event.data, event.source);
+            }
+        }
+    }
+    getSubscribers(topic) {
+        if (topic) {
+            const ids = this.byTopic.get(topic) ?? new Set();
+            return [...ids].map((id) => this.subs.get(id)).filter((s) => s !== undefined);
+        }
+        return [...this.subs.values()].filter((s) => s.active);
+    }
+}
+//# sourceMappingURL=bus.js.map

package/packages/event-bus/dist/bus.js.map

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

package/packages/event-bus/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { EventBus } from "./bus.js";
+export { EventBusError } from "./types.js";
+export type { Topic, EventPayload, Subscriber, Subscription, BusOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/event-bus/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/packages/event-bus/dist/index.js

@@ -0,0 +1,3 @@
+export { EventBus } from "./bus.js";
+export { EventBusError } from "./types.js";
+//# sourceMappingURL=index.js.map

package/packages/event-bus/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/packages/event-bus/dist/src/bus.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event Bus — pub/sub implementation
+ */
+import type { Subscriber, Subscription, EventPayload } from "./types.js";
+export declare class EventBus {
+    private readonly subs;
+    private readonly byTopic;
+    publish<T>(topic: string, data: T, source?: string): string;
+    subscribe<T>(topic: string, subscriber: Subscriber<T>, filter?: (data: T) => boolean, priority?: number): string;
+    unsubscribe(subscriptionId: string): void;
+    unsubscribeAll(topic?: string): void;
+    replay(topic: string, events: EventPayload<unknown>[]): void;
+    getSubscribers(topic?: string): Subscription[];
+}
+//# sourceMappingURL=bus.d.ts.map

package/packages/event-bus/dist/src/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/bus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAE/D,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,SAAW,GAAG,MAAM,CAsC5D;IAED,SAAS,CAAC,CAAC,EACV,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,EAC7B,QAAQ,SAAI,GACV,MAAM,CAcR;IAED,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAMxC;IAED,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAWnC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAM3D;IAED,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAQ7C;CACD"}

package/packages/event-bus/dist/src/bus.js

@@ -0,0 +1,98 @@
+/**
+ * Event Bus — pub/sub implementation
+ */
+import { randomUUID } from "node:crypto";
+export class EventBus {
+    subs = new Map();
+    byTopic = new Map();
+    publish(topic, data, source = "system") {
+        const eventId = randomUUID();
+        const timestamp = new Date().toISOString();
+        const payload = {
+            topic,
+            data,
+            timestamp,
+            eventId,
+            source,
+        };
+        const topicIds = this.byTopic.get(topic) ?? new Set();
+        const wildcardIds = this.byTopic.get("*") ?? new Set();
+        const matches = [];
+        for (const sid of [...topicIds, ...wildcardIds]) {
+            const sub = this.subs.get(sid);
+            if (!sub || !sub.active)
+                continue;
+            if (sub.filter && !sub.filter(data))
+                continue;
+            matches.push({ sub, payload });
+        }
+        matches.sort((a, b) => b.sub.priority - a.sub.priority);
+        for (const { sub } of matches) {
+            try {
+                sub.subscriber(payload);
+            }
+            catch {
+                sub.active = false;
+                this.subs.delete(sub.id);
+                this.byTopic.get(sub.topic)?.delete(sub.id);
+            }
+        }
+        return eventId;
+    }
+    subscribe(topic, subscriber, filter, priority = 0) {
+        const id = randomUUID();
+        const sub = {
+            id,
+            topic,
+            subscriber: subscriber,
+            filter: filter,
+            priority,
+            active: true,
+        };
+        this.subs.set(id, sub);
+        if (!this.byTopic.has(topic))
+            this.byTopic.set(topic, new Set());
+        this.byTopic.get(topic).add(id);
+        return id;
+    }
+    unsubscribe(subscriptionId) {
+        const sub = this.subs.get(subscriptionId);
+        if (!sub)
+            return;
+        sub.active = false;
+        this.subs.delete(subscriptionId);
+        this.byTopic.get(sub.topic)?.delete(subscriptionId);
+    }
+    unsubscribeAll(topic) {
+        if (topic) {
+            const ids = this.byTopic.get(topic);
+            if (ids) {
+                for (const id of ids)
+                    this.unsubscribe(id);
+                this.byTopic.delete(topic);
+            }
+        }
+        else {
+            for (const id of this.subs.keys())
+                this.unsubscribe(id);
+            this.byTopic.clear();
+        }
+    }
+    replay(topic, events) {
+        for (const event of events) {
+            if (event.topic === topic || topic === "*") {
+                this.publish(event.topic, event.data, event.source);
+            }
+        }
+    }
+    getSubscribers(topic) {
+        if (topic) {
+            const ids = this.byTopic.get(topic) ?? new Set();
+            return [...ids]
+                .map((id) => this.subs.get(id))
+                .filter((s) => s !== undefined);
+        }
+        return [...this.subs.values()].filter((s) => s.active);
+    }
+}
+//# sourceMappingURL=bus.js.map

package/packages/event-bus/dist/src/bus.js.map

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

package/packages/event-bus/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { EventBus } from "./bus.js";
+export { EventBusError } from "./types.js";
+export type { Topic, EventPayload, Subscriber, Subscription, BusOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/event-bus/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,YAAY,EACX,KAAK,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,UAAU,GACV,MAAM,YAAY,CAAC"}

package/packages/event-bus/dist/src/index.js

@@ -0,0 +1,3 @@
+export { EventBus } from "./bus.js";
+export { EventBusError } from "./types.js";
+//# sourceMappingURL=index.js.map

package/packages/event-bus/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/packages/event-bus/dist/src/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Event Bus — Types
+ */
+export type Topic = "session.message" | "session.assistant_start" | "session.assistant_end" | "session.tool_start" | "session.tool_end" | "session.checkpoint" | "session.compact" | "task.assigned" | "task.started" | "task.completed" | "task.failed" | "review.requested" | "review.completed" | "decision.made" | "approval.requested" | "approval.granted" | "workflow.started" | "workflow.finished" | "knowledge.extracted" | "system.quota_exceeded" | "system.checkpoint_saved" | "system.error";
+export interface EventPayload<T = unknown> {
+    topic: string;
+    data: T;
+    timestamp: string;
+    eventId: string;
+    source: string;
+}
+export type Subscriber<T = unknown> = (payload: EventPayload<T>) => void | Promise<void>;
+export interface Subscription {
+    id: string;
+    topic: string;
+    subscriber: Subscriber<unknown>;
+    filter?: (data: unknown) => boolean;
+    priority: number;
+    active: boolean;
+}
+export interface BusOptions {
+    deliveryGuarantee?: "at_least_once" | "at_most_once" | "exactly_once";
+}
+export declare class EventBusError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/event-bus/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,KAAK,GACd,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,uBAAuB,GACvB,yBAAyB,GACzB,cAAc,CAAC;AAElB,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CACrC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,iBAAiB,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;CACtE;AAED,qBAAa,aAAc,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD"}

package/packages/event-bus/dist/src/types.js

@@ -0,0 +1,10 @@
+/**
+ * Event Bus — Types
+ */
+export class EventBusError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EventBusError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/packages/event-bus/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmDH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD"}

package/packages/event-bus/dist/test/bus.test.js

@@ -0,0 +1,52 @@
+import { describe, it } from "node:test";
+import { equal, deepEqual } from "node:assert";
+import { EventBus } from "../src/bus.js";
+describe("EventBus", () => {
+    const bus = new EventBus();
+    it("publish returns eventId", () => {
+        const id = bus.publish("test.topic", { msg: "hello" });
+        equal(typeof id, "string");
+        equal(id.length > 0, true);
+    });
+    it("subscriber receives event", () => {
+        let received = null;
+        bus.subscribe("test.1", (p) => { received = p; });
+        bus.publish("test.1", { data: "hello" });
+        equal(received.data, "hello");
+    });
+    it("multiple subscribers all called", () => {
+        const calls = [];
+        bus.subscribe("test.2", () => { calls.push(1); });
+        bus.subscribe("test.2", () => { calls.push(2); });
+        bus.publish("test.2", { x: 1 });
+        deepEqual(calls, [1, 2]);
+    });
+    it("unsubscribe stops notifications", () => {
+        let called = false;
+        const id = bus.subscribe("test.3", () => { called = true; });
+        bus.unsubscribe(id);
+        bus.publish("test.3", {});
+        equal(called, false);
+    });
+    it("filter predicates work", () => {
+        let called = false;
+        bus.subscribe("test.4", () => { called = true; }, (d) => d.ok === true);
+        bus.publish("test.4", { ok: false });
+        equal(called, false);
+        bus.publish("test.4", { ok: true });
+        equal(called, true);
+    });
+    it("priority ordering respected", () => {
+        const order = [];
+        bus.subscribe("test.5", () => { order.push(1); }, undefined, 1);
+        bus.subscribe("test.5", () => { order.push(2); }, undefined, 2);
+        bus.publish("test.5", {});
+        deepEqual(order, [2, 1]); // higher priority first
+    });
+    it("unsubscribeAll(topic) removes all for topic", () => {
+        bus.subscribe("test.6", () => { });
+        bus.subscribe("test.6", () => { });
+        bus.unsubscribeAll("test.6");
+        equal(bus.getSubscribers("test.6").length, 0);
+    });
+});

package/packages/event-bus/dist/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Event Bus — Types
+ */
+export type Topic = "session.message" | "session.assistant_start" | "session.assistant_end" | "session.tool_start" | "session.tool_end" | "session.checkpoint" | "session.compact" | "task.assigned" | "task.started" | "task.completed" | "task.failed" | "review.requested" | "review.completed" | "decision.made" | "approval.requested" | "approval.granted" | "workflow.started" | "workflow.finished" | "knowledge.extracted" | "system.quota_exceeded" | "system.checkpoint_saved" | "system.error";
+export interface EventPayload<T = unknown> {
+    topic: string;
+    data: T;
+    timestamp: string;
+    eventId: string;
+    source: string;
+}
+export type Subscriber<T = unknown> = (payload: EventPayload<T>) => void | Promise<void>;
+export interface Subscription {
+    id: string;
+    topic: string;
+    subscriber: Subscriber<unknown>;
+    filter?: (data: unknown) => boolean;
+    priority: number;
+    active: boolean;
+}
+export interface BusOptions {
+    deliveryGuarantee?: "at_least_once" | "at_most_once" | "exactly_once";
+}
+export declare class EventBusError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/event-bus/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,KAAK,GACd,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,GACvB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,qBAAqB,GACrB,uBAAuB,GACvB,yBAAyB,GACzB,cAAc,CAAC;AAElB,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,OAAO,IAAI,CACrC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,KACpB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,iBAAiB,CAAC,EAAE,eAAe,GAAG,cAAc,GAAG,cAAc,CAAC;CACtE;AAED,qBAAa,aAAc,SAAQ,KAAK;IACvC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACD"}

package/packages/event-bus/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Event Bus — Types
+ */
+export class EventBusError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EventBusError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/packages/event-bus/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmDH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD"}

package/packages/event-bus/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@pi/event-bus",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "scripts": {
+    "test": "node --test"
+  }
+}

package/packages/event-bus/src/bus.ts

@@ -0,0 +1,111 @@
+/**
+ * Event Bus — pub/sub implementation
+ */
+
+import { randomUUID } from "node:crypto";
+import type { Subscriber, Subscription, EventPayload } from "./types.js";
+
+export class EventBus {
+	private readonly subs: Map<string, Subscription> = new Map();
+	private readonly byTopic: Map<string, Set<string>> = new Map();
+
+	publish<T>(topic: string, data: T, source = "system"): string {
+		const eventId = randomUUID();
+		const timestamp = new Date().toISOString();
+		const payload: EventPayload<T> = {
+			topic,
+			data,
+			timestamp,
+			eventId,
+			source,
+		};
+
+		const topicIds = this.byTopic.get(topic) ?? new Set();
+		const wildcardIds = this.byTopic.get("*") ?? new Set();
+
+		const matches: Array<{
+			sub: Subscription;
+			payload: EventPayload<unknown>;
+		}> = [];
+		for (const sid of [...topicIds, ...wildcardIds]) {
+			const sub = this.subs.get(sid);
+			if (!sub || !sub.active) continue;
+			if (sub.filter && !sub.filter(data)) continue;
+			matches.push({ sub, payload });
+		}
+
+		matches.sort((a, b) => b.sub.priority - a.sub.priority);
+
+		for (const { sub } of matches) {
+			try {
+				(sub.subscriber as Subscriber)(payload);
+			} catch {
+				sub.active = false;
+				this.subs.delete(sub.id);
+				this.byTopic.get(sub.topic)?.delete(sub.id);
+			}
+		}
+
+		return eventId;
+	}
+
+	subscribe<T>(
+		topic: string,
+		subscriber: Subscriber<T>,
+		filter?: (data: T) => boolean,
+		priority = 0,
+	): string {
+		const id = randomUUID();
+		const sub: Subscription = {
+			id,
+			topic,
+			subscriber: subscriber as Subscriber<unknown>,
+			filter: filter as (data: unknown) => boolean,
+			priority,
+			active: true,
+		};
+		this.subs.set(id, sub);
+		if (!this.byTopic.has(topic)) this.byTopic.set(topic, new Set());
+		this.byTopic.get(topic)!.add(id);
+		return id;
+	}
+
+	unsubscribe(subscriptionId: string): void {
+		const sub = this.subs.get(subscriptionId);
+		if (!sub) return;
+		sub.active = false;
+		this.subs.delete(subscriptionId);
+		this.byTopic.get(sub.topic)?.delete(subscriptionId);
+	}
+
+	unsubscribeAll(topic?: string): void {
+		if (topic) {
+			const ids = this.byTopic.get(topic);
+			if (ids) {
+				for (const id of ids) this.unsubscribe(id);
+				this.byTopic.delete(topic);
+			}
+		} else {
+			for (const id of this.subs.keys()) this.unsubscribe(id);
+			this.byTopic.clear();
+		}
+	}
+
+	replay(topic: string, events: EventPayload<unknown>[]): void {
+		for (const event of events) {
+			if (event.topic === topic || topic === "*") {
+				this.publish(event.topic, event.data, event.source);
+			}
+		}
+	}
+
+	getSubscribers(topic?: string): Subscription[] {
+		if (topic) {
+			const ids = this.byTopic.get(topic) ?? new Set();
+			return [...ids]
+				.map((id) => this.subs.get(id)!)
+				.filter((s): s is Subscription => s !== undefined);
+		}
+		return [...this.subs.values()].filter((s) => s.active);
+	}
+}