p-spore 0.1.0

package/dist/protocol/client.d.ts

@@ -0,0 +1,25 @@
+import { type EventEnvelope, type ServerHelloFrame } from "./schema.js";
+export interface ProtocolClientOptions {
+    socketPath: string;
+    clientId: string;
+    capabilities?: string[];
+    cursors?: Record<string, number>;
+    maxFrameBytes?: number;
+    idFactory?: () => string;
+}
+export declare class ProtocolClient {
+    #private;
+    constructor(options: ProtocolClientOptions);
+    get hello(): ServerHelloFrame | undefined;
+    get cursors(): Record<string, number>;
+    connect(): Promise<ServerHelloFrame>;
+    subscribe(listener: (event: EventEnvelope) => void): () => void;
+    subscribeConnection(listener: (connected: boolean, error?: Error) => void): () => void;
+    command<T = unknown>(type: string, payload: unknown, options?: {
+        id?: string;
+        sessionId?: string;
+        expectedRevision?: number;
+    }): Promise<T>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/protocol/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/protocol/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAML,KAAK,aAAa,EAGlB,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,MAAM,CAAC;CAC1B;AAOD,qBAAa,cAAc;;gBAYb,OAAO,EAAE,qBAAqB;IAM1C,IAAI,KAAK,IAAI,gBAAgB,GAAG,SAAS,CAExC;IAED,IAAI,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpC;IAEK,OAAO,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAmC1C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAK/D,mBAAmB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI;IAKhF,OAAO,CAAC,CAAC,GAAG,OAAO,EACvB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3E,OAAO,CAAC,CAAC,CAAC;IA2BP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAqF7B"}

package/dist/protocol/client.js

@@ -0,0 +1,188 @@
+import { randomUUID } from "node:crypto";
+import { createConnection } from "node:net";
+import { DEFAULT_MAX_FRAME_BYTES, encodeFrame, PROTOCOL_VERSION, } from "./schema.js";
+export class ProtocolClient {
+    #options;
+    #idFactory;
+    #listeners = new Set();
+    #connectionListeners = new Set();
+    #pendingCommands = new Map();
+    #socket;
+    #pending = Buffer.alloc(0);
+    #helloWaiter;
+    #hello;
+    #lastSeq;
+    constructor(options) {
+        this.#options = options;
+        this.#idFactory = options.idFactory ?? randomUUID;
+        this.#lastSeq = { ...(options.cursors ?? {}) };
+    }
+    get hello() {
+        return this.#hello ? structuredClone(this.#hello) : undefined;
+    }
+    get cursors() {
+        return { ...this.#lastSeq };
+    }
+    async connect() {
+        if (this.#socket)
+            throw new Error("Protocol client is already connected");
+        const socket = createConnection(this.#options.socketPath);
+        this.#socket = socket;
+        this.#pending = Buffer.alloc(0);
+        socket.setNoDelay(true);
+        socket.on("data", (chunk) => this.#receive(chunk));
+        socket.on("error", (error) => this.#disconnect(error));
+        socket.on("close", () => this.#disconnect(new Error("Protocol connection closed")));
+        await new Promise((resolve, reject) => {
+            socket.once("connect", resolve);
+            socket.once("error", reject);
+        });
+        const hello = new Promise((resolve, reject) => {
+            this.#helloWaiter = {
+                resolve: (response) => reject(new Error(response.error?.message ?? "Handshake failed")),
+                reject,
+            };
+            this.#resolveHello = resolve;
+        });
+        const frame = {
+            v: PROTOCOL_VERSION,
+            kind: "hello",
+            id: this.#idFactory(),
+            clientId: this.#options.clientId,
+            supportedVersions: [PROTOCOL_VERSION],
+            capabilities: [...(this.#options.capabilities ?? [])],
+            cursors: this.cursors,
+        };
+        socket.write(encodeFrame(frame));
+        return hello;
+    }
+    #resolveHello;
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        return () => this.#listeners.delete(listener);
+    }
+    subscribeConnection(listener) {
+        this.#connectionListeners.add(listener);
+        return () => this.#connectionListeners.delete(listener);
+    }
+    async command(type, payload, options = {}) {
+        const socket = this.#socket;
+        if (!socket || socket.destroyed || !this.#hello)
+            throw new Error("Protocol client is not connected");
+        const id = options.id ?? this.#idFactory();
+        const frame = {
+            v: PROTOCOL_VERSION,
+            kind: "command",
+            id,
+            clientId: this.#options.clientId,
+            type,
+            payload,
+            ...(options.sessionId === undefined ? {} : { sessionId: options.sessionId }),
+            ...(options.expectedRevision === undefined ? {} : { expectedRevision: options.expectedRevision }),
+        };
+        const response = new Promise((resolve, reject) => {
+            this.#pendingCommands.set(id, { resolve, reject });
+        });
+        socket.write(encodeFrame(frame));
+        const result = await response;
+        if (!result.ok) {
+            const error = new Error(result.error?.message ?? "Protocol command failed");
+            Object.assign(error, { code: result.error?.code, currentRevision: result.error?.currentRevision });
+            throw error;
+        }
+        return result.payload;
+    }
+    async close() {
+        const socket = this.#socket;
+        if (!socket)
+            return;
+        this.#socket = undefined;
+        if (socket.destroyed)
+            return;
+        await new Promise((resolve) => socket.end(resolve));
+    }
+    #receive(chunk) {
+        this.#pending = Buffer.concat([this.#pending, chunk]);
+        const maxFrameBytes = this.#options.maxFrameBytes ?? DEFAULT_MAX_FRAME_BYTES;
+        if (this.#pending.byteLength > maxFrameBytes * 2) {
+            this.#socket?.destroy(new Error("Server exceeded protocol buffer limit"));
+            return;
+        }
+        for (;;) {
+            const delimiter = this.#pending.indexOf(0x0a);
+            if (delimiter < 0)
+                break;
+            const line = this.#pending.subarray(0, delimiter);
+            this.#pending = this.#pending.subarray(delimiter + 1);
+            if (line.byteLength > maxFrameBytes) {
+                this.#socket?.destroy(new Error("Server frame exceeded protocol limit"));
+                return;
+            }
+            this.#handleServerFrame(line);
+        }
+    }
+    #handleServerFrame(line) {
+        let frame;
+        try {
+            frame = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(line));
+        }
+        catch {
+            this.#socket?.destroy(new Error("Server sent invalid protocol JSON"));
+            return;
+        }
+        if (frame.v !== PROTOCOL_VERSION) {
+            this.#socket?.destroy(new Error("Server protocol version is unsupported"));
+            return;
+        }
+        if (frame.kind === "hello_ack") {
+            if (this.#hello) {
+                this.#socket?.destroy(new Error("Server sent duplicate hello acknowledgement"));
+                return;
+            }
+            this.#hello = structuredClone(frame);
+            const resolve = this.#resolveHello;
+            this.#resolveHello = undefined;
+            this.#helloWaiter = undefined;
+            resolve?.(this.hello);
+            for (const listener of this.#connectionListeners)
+                listener(true);
+            return;
+        }
+        if (frame.kind === "event") {
+            const previous = this.#lastSeq[frame.streamId] ?? 0;
+            if (frame.seq > previous)
+                this.#lastSeq[frame.streamId] = frame.seq;
+            for (const listener of this.#listeners)
+                listener(structuredClone(frame));
+            return;
+        }
+        if (frame.kind === "response") {
+            if (frame.commandId === "protocol" && this.#helloWaiter) {
+                this.#helloWaiter.resolve(frame);
+                this.#helloWaiter = undefined;
+                return;
+            }
+            const pending = this.#pendingCommands.get(frame.commandId);
+            if (!pending)
+                return;
+            this.#pendingCommands.delete(frame.commandId);
+            pending.resolve(frame);
+        }
+    }
+    #disconnect(error) {
+        const wasConnected = this.#socket !== undefined || this.#hello !== undefined;
+        this.#socket = undefined;
+        this.#hello = undefined;
+        this.#resolveHello = undefined;
+        this.#helloWaiter?.reject(error);
+        this.#helloWaiter = undefined;
+        for (const pending of this.#pendingCommands.values())
+            pending.reject(error);
+        this.#pendingCommands.clear();
+        if (wasConnected) {
+            for (const listener of this.#connectionListeners)
+                listener(false, error);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/protocol/client.js.map

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

package/dist/protocol/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class CommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/protocol/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C"}

package/dist/protocol/errors.js

@@ -0,0 +1,9 @@
+export class CommandError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "CommandError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/protocol/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/protocol/schema.d.ts

@@ -0,0 +1,71 @@
+import type { KernelState, PublicKernelEvent } from "../kernel/state.js";
+export declare const PROTOCOL_VERSION: 1;
+export declare const DEFAULT_MAX_FRAME_BYTES = 1048576;
+export declare const DEFAULT_MAX_NESTING_DEPTH = 32;
+export declare const DEFAULT_MAX_STRING_LENGTH = 262144;
+export interface ClientHelloFrame {
+    v: 1;
+    kind: "hello";
+    id: string;
+    clientId: string;
+    supportedVersions: number[];
+    capabilities: string[];
+    cursors: Record<string, number>;
+}
+export interface ServerHelloFrame {
+    v: 1;
+    kind: "hello_ack";
+    id: string;
+    protocolVersion: 1;
+    instanceId: string;
+    streamId: string;
+    latestSeq: number;
+    replayFromSeq: number;
+    snapshot: KernelState;
+}
+export interface CommandEnvelope<T = unknown> {
+    v: 1;
+    kind: "command";
+    id: string;
+    clientId: string;
+    sessionId?: string;
+    expectedRevision?: number;
+    type: string;
+    payload: T;
+}
+export interface ResponseEnvelope<T = unknown> {
+    v: 1;
+    kind: "response";
+    id: string;
+    commandId: string;
+    ok: boolean;
+    payload?: T;
+    error?: {
+        code: string;
+        message: string;
+        currentRevision?: number;
+    };
+}
+export interface EventEnvelope<T = unknown> {
+    v: 1;
+    kind: "event";
+    id: string;
+    streamId: string;
+    seq: number;
+    ts: string;
+    correlationId?: string;
+    causationId?: string;
+    durable: boolean;
+    type: string;
+    payload: T;
+}
+export type ClientFrame = ClientHelloFrame | CommandEnvelope;
+export type ServerFrame = ServerHelloFrame | ResponseEnvelope | EventEnvelope;
+export declare function decodeClientFrame(line: Uint8Array, maxFrameBytes?: number): ClientFrame;
+export declare function encodeFrame(frame: ServerFrame | ClientFrame): string;
+export declare function toEventEnvelope(event: PublicKernelEvent, streamId: string, seq: number): EventEnvelope;
+export declare class ProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/protocol/schema.d.ts.map

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

package/dist/protocol/schema.js

@@ -0,0 +1,155 @@
+export const PROTOCOL_VERSION = 1;
+export const DEFAULT_MAX_FRAME_BYTES = 1_048_576;
+export const DEFAULT_MAX_NESTING_DEPTH = 32;
+export const DEFAULT_MAX_STRING_LENGTH = 262_144;
+export function decodeClientFrame(line, maxFrameBytes = DEFAULT_MAX_FRAME_BYTES) {
+    if (line.byteLength === 0)
+        throw new ProtocolError("empty_frame", "Protocol frame cannot be empty");
+    if (line.byteLength > maxFrameBytes) {
+        throw new ProtocolError("frame_too_large", `Protocol frame exceeds ${maxFrameBytes} bytes`);
+    }
+    let value;
+    try {
+        value = JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(line));
+    }
+    catch {
+        throw new ProtocolError("invalid_json", "Protocol frame must be valid UTF-8 JSON");
+    }
+    assertValueLimits(value, 0);
+    const record = asRecord(value, "frame");
+    if (record["v"] !== PROTOCOL_VERSION) {
+        throw new ProtocolError("unsupported_version", `Protocol version ${String(record["v"])} is unsupported`);
+    }
+    if (record["kind"] === "hello")
+        return parseHello(record);
+    if (record["kind"] === "command")
+        return parseCommand(record);
+    throw new ProtocolError("invalid_kind", "Client frame kind must be hello or command");
+}
+export function encodeFrame(frame) {
+    return `${JSON.stringify(frame)}\n`;
+}
+export function toEventEnvelope(event, streamId, seq) {
+    return {
+        v: PROTOCOL_VERSION,
+        kind: "event",
+        id: event.id,
+        streamId,
+        seq,
+        ts: event.ts,
+        durable: event.durable,
+        type: event.type,
+        payload: event.payload,
+        ...(event.correlationId === undefined ? {} : { correlationId: event.correlationId }),
+        ...(event.causationId === undefined ? {} : { causationId: event.causationId }),
+    };
+}
+export class ProtocolError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "ProtocolError";
+        this.code = code;
+    }
+}
+function parseHello(record) {
+    exactKeys(record, ["v", "kind", "id", "clientId", "supportedVersions", "capabilities", "cursors"], "hello");
+    const versions = numberArray(record["supportedVersions"], "supportedVersions");
+    if (!versions.includes(PROTOCOL_VERSION)) {
+        throw new ProtocolError("unsupported_version", "Client does not support protocol version 1");
+    }
+    const cursors = asRecord(record["cursors"], "cursors");
+    const parsedCursors = {};
+    for (const [streamId, seq] of Object.entries(cursors)) {
+        parsedCursors[identifier(streamId, "cursor streamId")] = nonNegativeInteger(seq, `cursor ${streamId}`);
+    }
+    return {
+        v: PROTOCOL_VERSION,
+        kind: "hello",
+        id: identifier(record["id"], "id"),
+        clientId: identifier(record["clientId"], "clientId"),
+        supportedVersions: versions,
+        capabilities: stringArray(record["capabilities"], "capabilities"),
+        cursors: parsedCursors,
+    };
+}
+function parseCommand(record) {
+    exactKeys(record, ["v", "kind", "id", "clientId", "sessionId", "expectedRevision", "type", "payload"], "command");
+    const sessionId = record["sessionId"];
+    const expectedRevision = record["expectedRevision"];
+    return {
+        v: PROTOCOL_VERSION,
+        kind: "command",
+        id: identifier(record["id"], "id"),
+        clientId: identifier(record["clientId"], "clientId"),
+        type: eventType(record["type"]),
+        payload: record["payload"],
+        ...(sessionId === undefined ? {} : { sessionId: identifier(sessionId, "sessionId") }),
+        ...(expectedRevision === undefined
+            ? {}
+            : { expectedRevision: nonNegativeInteger(expectedRevision, "expectedRevision") }),
+    };
+}
+function assertValueLimits(value, depth) {
+    if (depth > DEFAULT_MAX_NESTING_DEPTH) {
+        throw new ProtocolError("nesting_too_deep", `JSON nesting exceeds ${DEFAULT_MAX_NESTING_DEPTH}`);
+    }
+    if (typeof value === "string" && value.length > DEFAULT_MAX_STRING_LENGTH) {
+        throw new ProtocolError("string_too_large", `JSON string exceeds ${DEFAULT_MAX_STRING_LENGTH} characters`);
+    }
+    if (Array.isArray(value)) {
+        for (const item of value)
+            assertValueLimits(item, depth + 1);
+    }
+    else if (value !== null && typeof value === "object") {
+        for (const [key, item] of Object.entries(value)) {
+            assertValueLimits(key, depth + 1);
+            assertValueLimits(item, depth + 1);
+        }
+    }
+}
+function exactKeys(record, allowed, path) {
+    const accepted = new Set(allowed);
+    const unknown = Object.keys(record).filter((key) => !accepted.has(key));
+    if (unknown.length > 0) {
+        throw new ProtocolError("unknown_field", `${path} contains unknown fields: ${unknown.join(", ")}`);
+    }
+}
+function asRecord(value, path) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        throw new ProtocolError("invalid_field", `${path} must be an object`);
+    }
+    return value;
+}
+function identifier(value, path) {
+    if (typeof value !== "string" || value.length === 0 || value.length > 128 || /[\u0000-\u001f]/.test(value)) {
+        throw new ProtocolError("invalid_field", `${path} must be a non-empty identifier of at most 128 characters`);
+    }
+    return value;
+}
+function eventType(value) {
+    const type = identifier(value, "type");
+    if (!/^[a-z][a-z0-9_.-]*$/.test(type)) {
+        throw new ProtocolError("invalid_field", "type contains unsupported characters");
+    }
+    return type;
+}
+function stringArray(value, path) {
+    if (!Array.isArray(value) || value.length > 128) {
+        throw new ProtocolError("invalid_field", `${path} must be an array with at most 128 entries`);
+    }
+    return value.map((item, index) => identifier(item, `${path}[${index}]`));
+}
+function numberArray(value, path) {
+    if (!Array.isArray(value) || value.length > 16) {
+        throw new ProtocolError("invalid_field", `${path} must be an array with at most 16 entries`);
+    }
+    return value.map((item, index) => nonNegativeInteger(item, `${path}[${index}]`));
+}
+function nonNegativeInteger(value, path) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0) {
+        throw new ProtocolError("invalid_field", `${path} must be a non-negative safe integer`);
+    }
+    return Number(value);
+}
+//# sourceMappingURL=schema.js.map

package/dist/protocol/schema.js.map

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

package/dist/settings/llm-settings-service.d.ts

@@ -0,0 +1,9 @@
+import { type PsporePaths } from "../storage/home.js";
+import { type LlmSettings, type LlmSettingsUpdate } from "./llm-settings.js";
+export declare class LlmSettingsService {
+    #private;
+    constructor(home: string, paths: PsporePaths);
+    get(): Promise<LlmSettings>;
+    save(update: LlmSettingsUpdate): Promise<LlmSettings>;
+}
+//# sourceMappingURL=llm-settings-service.d.ts.map

package/dist/settings/llm-settings-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-settings-service.d.ts","sourceRoot":"","sources":["../../src/settings/llm-settings-service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAGvB,MAAM,mBAAmB,CAAC;AAgB3B,qBAAa,kBAAkB;;gBAIjB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAKtC,GAAG,IAAI,OAAO,CAAC,WAAW,CAAC;IAqB3B,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAgG5D"}