p-spore 0.1.0

package/dist/notifications/notification-service.js

@@ -0,0 +1,163 @@
+import { randomUUID } from "node:crypto";
+import { appendJsonLine } from "../storage/atomic.js";
+import { readJsonLinesRecovering } from "../storage/jsonl.js";
+export class NotificationService {
+    #path;
+    #recoveryDirectory;
+    #clock;
+    #idFactory;
+    #onNotification;
+    #retainedRecords;
+    #records = [];
+    #tail = Promise.resolve();
+    constructor(options) {
+        this.#path = options.path;
+        this.#recoveryDirectory = options.recoveryDirectory;
+        this.#clock = options.clock ?? (() => new Date());
+        this.#idFactory = options.idFactory ?? randomUUID;
+        this.#onNotification = options.onNotification;
+        this.#retainedRecords = options.retainedRecords ?? 200;
+    }
+    async initialize() {
+        let values;
+        try {
+            values = await readJsonLinesRecovering(this.#path, this.#recoveryDirectory, this.#idFactory);
+        }
+        catch (error) {
+            if (isNodeError(error) && error.code === "ENOENT")
+                values = [];
+            else
+                throw error;
+        }
+        for (const [index, value] of values.entries()) {
+            const record = parseNotification(value, `${this.#path}:${index + 1}`);
+            this.#remember(record);
+            await this.#publish(record);
+        }
+    }
+    notify(input) {
+        return this.#serialize(async () => {
+            const record = {
+                version: 1,
+                id: this.#idFactory(),
+                ts: this.#clock().toISOString(),
+                level: input.level,
+                title: boundedText(input.title, "notification.title", 120),
+                body: boundedText(input.body, "notification.body", 4_000),
+                source: structuredClone(input.source),
+                target: structuredClone(input.target ?? { kind: "local-notification" }),
+            };
+            await appendJsonLine(this.#path, record, 0o600);
+            this.#remember(record);
+            await this.#publish(record);
+            return structuredClone(record);
+        });
+    }
+    async deliverRun(run) {
+        if (run.delivery.kind === "none")
+            return;
+        const detail = run.reason ?? run.error ?? `Run finished with status ${run.status}`;
+        await this.notify({
+            level: run.status === "succeeded" ? "success" : run.status === "blocked" ? "warning" : "error",
+            title: run.jobId ? `Job ${run.jobId}: ${run.status}` : `Run ${run.source}: ${run.status}`,
+            body: detail,
+            source: { kind: "run", runId: run.id, ...(run.jobId === undefined ? {} : { jobId: run.jobId }) },
+            target: run.delivery.kind === "session"
+                ? { kind: "session", sessionId: run.delivery.sessionId }
+                : { kind: "local-notification" },
+        });
+    }
+    list() {
+        return this.#records.map((record) => structuredClone(record));
+    }
+    #remember(record) {
+        this.#records.push(structuredClone(record));
+        while (this.#records.length > this.#retainedRecords)
+            this.#records.shift();
+    }
+    async #publish(record) {
+        try {
+            await this.#onNotification?.(structuredClone(record));
+        }
+        catch {
+            // Durable delivery remains authoritative even when an observer is unavailable.
+        }
+    }
+    #serialize(operation) {
+        const result = this.#tail.then(operation, operation);
+        this.#tail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+function parseNotification(value, path) {
+    if (!isRecord(value))
+        throw new Error(`Invalid notification record at ${path}`);
+    const keys = new Set(["version", "id", "ts", "level", "title", "body", "source", "target"]);
+    const unknown = Object.keys(value).filter((key) => !keys.has(key));
+    if (unknown.length > 0)
+        throw new Error(`Notification at ${path} contains unknown keys: ${unknown.join(", ")}`);
+    if (value["version"] !== 1)
+        throw new Error(`Notification at ${path} has unsupported version`);
+    const level = value["level"];
+    if (level !== "info" && level !== "success" && level !== "warning" && level !== "error") {
+        throw new Error(`Notification at ${path} has invalid level`);
+    }
+    return {
+        version: 1,
+        id: boundedText(value["id"], `${path}.id`, 128),
+        ts: boundedText(value["ts"], `${path}.ts`, 64),
+        level,
+        title: boundedText(value["title"], `${path}.title`, 120),
+        body: boundedText(value["body"], `${path}.body`, 4_000),
+        source: parseSource(value["source"], `${path}.source`),
+        target: parseTarget(value["target"], `${path}.target`),
+    };
+}
+function parseSource(value, path) {
+    if (!isRecord(value))
+        throw new Error(`${path} must be an object`);
+    if (value["kind"] === "agent" && exactKeys(value, ["kind", "sessionId"])) {
+        return { kind: "agent", sessionId: boundedText(value["sessionId"], `${path}.sessionId`, 128) };
+    }
+    if (value["kind"] === "run" && exactKeys(value, ["kind", "runId", "jobId"], ["jobId"])) {
+        const jobId = value["jobId"];
+        return {
+            kind: "run",
+            runId: boundedText(value["runId"], `${path}.runId`, 128),
+            ...(jobId === undefined ? {} : { jobId: boundedText(jobId, `${path}.jobId`, 128) }),
+        };
+    }
+    throw new Error(`${path} has invalid source`);
+}
+function parseTarget(value, path) {
+    if (!isRecord(value))
+        throw new Error(`${path} must be an object`);
+    if (value["kind"] === "local-notification" && exactKeys(value, ["kind"]))
+        return { kind: "local-notification" };
+    if (value["kind"] === "session" && exactKeys(value, ["kind", "sessionId"])) {
+        return { kind: "session", sessionId: boundedText(value["sessionId"], `${path}.sessionId`, 128) };
+    }
+    throw new Error(`${path} has invalid target`);
+}
+function exactKeys(value, keys, optional = []) {
+    const accepted = new Set(keys);
+    const optionalSet = new Set(optional);
+    if (Object.keys(value).some((key) => !accepted.has(key)))
+        return false;
+    if (keys.some((key) => !optionalSet.has(key) && !(key in value)))
+        return false;
+    return true;
+}
+function boundedText(value, path, maximum) {
+    if (typeof value !== "string" || !value.trim() || value.length > maximum) {
+        throw new Error(`${path} must be a non-empty string of at most ${maximum} characters`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNodeError(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=notification-service.js.map

package/dist/notifications/notification-service.js.map

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

package/dist/notifications/notification-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from "@earendil-works/pi-coding-agent";
+import { NotificationService } from "./notification-service.js";
+export declare function createNotificationTools(sessionId: string, notifications: NotificationService): readonly ToolDefinition[];
+//# sourceMappingURL=notification-tools.d.ts.map

package/dist/notifications/notification-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-tools.d.ts","sourceRoot":"","sources":["../../src/notifications/notification-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGlF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAahE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,GAAG,SAAS,cAAc,EAAE,CAoBxH"}

package/dist/notifications/notification-tools.js

@@ -0,0 +1,31 @@
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
+import { NotificationService } from "./notification-service.js";
+const parameters = Type.Object({
+    title: Type.String({ minLength: 1, maxLength: 120 }),
+    body: Type.String({ minLength: 1, maxLength: 4_000 }),
+    level: Type.Optional(Type.Union([Type.Literal("info"), Type.Literal("success"), Type.Literal("warning"), Type.Literal("error")])),
+}, { additionalProperties: false });
+export function createNotificationTools(sessionId, notifications) {
+    return [
+        defineTool({
+            name: "notify",
+            label: "Notify",
+            description: "Send a short durable local notification to the user.",
+            parameters,
+            executionMode: "sequential",
+            execute: async (_toolCallId, params, signal) => {
+                if (signal?.aborted)
+                    throw signal.reason instanceof Error ? signal.reason : new Error("Notification aborted");
+                const record = await notifications.notify({
+                    level: params.level ?? "info",
+                    title: params.title,
+                    body: params.body,
+                    source: { kind: "agent", sessionId },
+                });
+                return { content: [{ type: "text", text: `Notification delivered (${record.id})` }], details: record };
+            },
+        }),
+    ];
+}
+//# sourceMappingURL=notification-tools.js.map

package/dist/notifications/notification-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification-tools.js","sourceRoot":"","sources":["../../src/notifications/notification-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,iCAAiC,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAC5B;IACE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;IACpD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACrD,KAAK,EAAE,IAAI,CAAC,QAAQ,CAClB,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAC5G;CACF,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,SAAiB,EAAE,aAAkC;IAC3F,OAAO;QACL,UAAU,CAAC;YACT,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,QAAQ;YACf,WAAW,EAAE,sDAAsD;YACnE,UAAU;YACV,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;gBAC7C,IAAI,MAAM,EAAE,OAAO;oBAAE,MAAM,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAC9G,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC;oBACxC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,MAAM;oBAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE;iBACrC,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACzG,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/pi/pi-runtime-adapter.d.ts

@@ -0,0 +1,38 @@
+import type { Model } from "@earendil-works/pi-ai";
+import { ModelRuntime, type ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { Accepted, AgentHandle, AgentRuntimePort, AgentSessionSpec, AgentSnapshot, ModelRef, ResumeSessionSpec, RuntimeEvent, SessionId, ToolGate } from "../domain/runtime.js";
+type Clock = () => Date;
+type IdFactory = () => string;
+export interface PiRuntimeAdapterOptions {
+    agentDir: string;
+    sessionRoot: string;
+    modelRuntime?: ModelRuntime;
+    resolveModel?: (ref: ModelRef | undefined, runtime: ModelRuntime) => Model<string> | undefined;
+    createTools?: (sessionId: SessionId) => readonly ToolDefinition[];
+    createSkillPaths?: (sessionId: SessionId) => readonly string[] | Promise<readonly string[]>;
+    toolGate?: ToolGate;
+    clock?: Clock;
+    idFactory?: IdFactory;
+}
+export declare class PiRuntimeAdapter implements AgentRuntimePort {
+    #private;
+    private constructor();
+    static create(options: PiRuntimeAdapterOptions): Promise<PiRuntimeAdapter>;
+    create(spec: AgentSessionSpec): Promise<AgentHandle>;
+    resume(spec: ResumeSessionSpec): Promise<AgentHandle>;
+    prompt(sessionId: SessionId, input: string): Promise<Accepted>;
+    steer(sessionId: SessionId, input: string): Promise<Accepted>;
+    followUp(sessionId: SessionId, input: string): Promise<Accepted>;
+    abort(sessionId: SessionId, _reason: string): Promise<void>;
+    compact(sessionId: SessionId, instructions?: string): Promise<void>;
+    snapshot(sessionId: SessionId): AgentSnapshot;
+    subscribe(sessionId: SessionId, sink: (event: RuntimeEvent) => void): () => void;
+    waitForIdle(sessionId: SessionId): Promise<void>;
+    newSession(sessionId: SessionId): Promise<AgentHandle>;
+    switchSession(sessionId: SessionId, sessionFile: string): Promise<AgentHandle>;
+    fork(sessionId: SessionId, entryId: string, position?: "before" | "at"): Promise<AgentHandle>;
+    dispose(sessionId: SessionId): Promise<void>;
+    disposeAll(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=pi-runtime-adapter.d.ts.map

package/dist/pi/pi-runtime-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-runtime-adapter.d.ts","sourceRoot":"","sources":["../../src/pi/pi-runtime-adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAIL,YAAY,EAOZ,KAAK,cAAc,EACpB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,iBAAiB,EACjB,YAAY,EAGZ,SAAS,EACT,QAAQ,EACT,MAAM,sBAAsB,CAAC;AAE9B,KAAK,KAAK,GAAG,MAAM,IAAI,CAAC;AACxB,KAAK,SAAS,GAAG,MAAM,MAAM,CAAC;AAE9B,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,EAAE,OAAO,EAAE,YAAY,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/F,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,SAAS,cAAc,EAAE,CAAC;IAClE,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAC5F,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAgBD,qBAAa,gBAAiB,YAAW,gBAAgB;;IAYvD,OAAO;WAcM,MAAM,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAa1E,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IASpD,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAUrD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8C9D,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAM7D,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMhE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASzE,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,aAAa;IAyC7C,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAM1E,WAAW,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAStD,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAS9E,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,QAAQ,GAAG,IAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IASnG,OAAO,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CA6QlC"}