@plurnk/plurnk-service 0.1.0

package/dist/server/ClientConnection.js

@@ -0,0 +1,120 @@
+// Per-WebSocket-client JSON-RPC dispatch. One instance per connected client.
+// Owns session attachment state, calls into the engine for auto-create on
+// first requiresInit RPC, closes the client loop on disconnect.
+//
+// SPEC §13.2 (protocol), §13.7 (lifecycle), §13.8 (errors).
+import { createClientEnvelope, closeClientLoop } from "./envelope.js";
+// JSON-RPC 2.0 standard error codes (SPEC §13.8).
+const ERR_PARSE = -32700;
+const ERR_INVALID_REQUEST = -32600;
+const ERR_METHOD_NOT_FOUND = -32601;
+const ERR_INTERNAL = -32603;
+// Plurnk-specific (SPEC §13.8).
+const ERR_NOT_INITIALIZED = -32000;
+export default class ClientConnection {
+    #ws;
+    #registry;
+    #db;
+    #engine;
+    #provider;
+    #broadcast;
+    #session = null;
+    constructor({ ws, registry, db, engine, provider, broadcast }) {
+        this.#ws = ws;
+        this.#registry = registry;
+        this.#db = db;
+        this.#engine = engine;
+        this.#provider = provider;
+        this.#broadcast = broadcast;
+        this.#ws.on("message", (data) => this.#handleMessage(data));
+    }
+    get session() {
+        return this.#session;
+    }
+    sendNotification(method, params) {
+        const notification = { jsonrpc: "2.0", method };
+        if (params !== undefined)
+            notification.params = params;
+        this.#send(notification);
+    }
+    close() {
+        if (this.#session !== null) {
+            void closeClientLoop(this.#db, this.#session.clientLoopId, 200);
+            this.#session = null;
+        }
+        if (this.#ws.readyState === 1)
+            this.#ws.terminate();
+    }
+    async #handleMessage(data) {
+        let id = null;
+        let request;
+        try {
+            const text = typeof data === "string" ? data : data.toString("utf8");
+            request = JSON.parse(text);
+        }
+        catch (_e) {
+            this.#sendError(null, ERR_PARSE, "parse error");
+            return;
+        }
+        if (request.jsonrpc !== "2.0" || typeof request.method !== "string") {
+            this.#sendError(request.id ?? null, ERR_INVALID_REQUEST, "invalid request");
+            return;
+        }
+        id = request.id ?? null;
+        const registration = this.#registry.getMethod(request.method);
+        if (registration === undefined) {
+            this.#sendError(id, ERR_METHOD_NOT_FOUND, `method '${request.method}' not found`);
+            return;
+        }
+        if (registration.requiresInit && this.#session === null) {
+            try {
+                const envelope = await createClientEnvelope(this.#db, { prefix: "auto" });
+                this.#session = envelope;
+                this.#broadcast("all", this, "session/created", {
+                    id: envelope.sessionId,
+                    name: envelope.sessionName,
+                    projectRoot: envelope.projectRoot,
+                    persona: envelope.sessionPersona,
+                });
+            }
+            catch (cause) {
+                const message = cause instanceof Error ? cause.message : String(cause);
+                this.#sendError(id, ERR_NOT_INITIALIZED, `auto-create envelope failed: ${message}`);
+                return;
+            }
+        }
+        const ctx = {
+            registry: this.#registry,
+            db: this.#db,
+            engine: this.#engine,
+            provider: this.#provider,
+            session: this.#session,
+            attachSession: (envelope) => {
+                if (this.#session !== null) {
+                    throw new Error("connection already has a session attached");
+                }
+                this.#session = envelope;
+            },
+            notify: (target, method, params) => this.#broadcast(target, this, method, params),
+        };
+        try {
+            const result = await registration.handler(request.params ?? {}, ctx);
+            this.#send({ jsonrpc: "2.0", id, result });
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            this.#sendError(id, ERR_INTERNAL, message);
+        }
+    }
+    #sendError(id, code, message, data) {
+        const response = { jsonrpc: "2.0", id, error: { code, message } };
+        if (data !== undefined && response.error !== undefined)
+            response.error.data = data;
+        this.#send(response);
+    }
+    #send(payload) {
+        if (this.#ws.readyState === 1)
+            this.#ws.send(JSON.stringify(payload));
+    }
+}
+//# sourceMappingURL=ClientConnection.js.map

package/dist/server/ClientConnection.js.map

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

package/dist/server/Daemon.d.ts

@@ -0,0 +1,43 @@
+import type { Db } from "../core/Db.ts";
+import Engine from "../core/Engine.ts";
+import SchemeRegistry from "../core/SchemeRegistry.ts";
+import { Mimetypes } from "@plurnk/plurnk-mimetypes";
+import MethodRegistry from "./MethodRegistry.ts";
+import type { Provider } from "./MethodRegistry.ts";
+export interface DaemonOptions {
+    host?: string;
+    port?: number;
+}
+export interface DaemonAddress {
+    host: string;
+    port: number;
+}
+export default class Daemon {
+    #private;
+    constructor({ db, schemes, mimetypes, provider, nodeModulesPath, }: {
+        db: Db;
+        schemes?: SchemeRegistry;
+        mimetypes?: Mimetypes;
+        provider?: Provider | null;
+        nodeModulesPath?: string;
+    });
+    get registry(): MethodRegistry;
+    get engine(): Engine;
+    get provider(): Provider | null;
+    get schemes(): SchemeRegistry;
+    get mimetypes(): Mimetypes;
+    start({ host, port }?: DaemonOptions): Promise<DaemonAddress>;
+    stop(): Promise<void>;
+    /**
+     * Emit a stream/event notification scoped to the session containing the
+     * entry. ChannelWrite helpers (src/core/ChannelWrite.ts) invoke this when
+     * they update channel content or state. SPEC §13.6.
+     */
+    notifyStreamEvent(sessionId: number, event: {
+        entryId: number;
+        channel: string;
+        state: string;
+        contentLength: number;
+    }): void;
+}
+//# sourceMappingURL=Daemon.d.ts.map

package/dist/server/Daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Daemon.d.ts","sourceRoot":"","sources":["../../src/server/Daemon.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,OAAO,MAAM,MAAM,mBAAmB,CAAC;AACvC,OAAO,cAAc,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,cAAc,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAgB,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AA6BlE,MAAM,WAAW,aAAa;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,CAAC,OAAO,OAAO,MAAM;;gBAWX,EACR,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,GACpD,EAAE;QACC,EAAE,EAAE,EAAE,CAAC;QACP,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,SAAS,CAAC,EAAE,SAAS,CAAC;QACtB,QAAQ,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B;IA2CD,IAAI,QAAQ,IAAI,cAAc,CAA2B;IACzD,IAAI,MAAM,IAAI,MAAM,CAAyB;IAC7C,IAAI,QAAQ,IAAI,QAAQ,GAAG,IAAI,CAA2B;IAC1D,IAAI,OAAO,IAAI,cAAc,CAA0B;IACvD,IAAI,SAAS,IAAI,SAAS,CAA4B;IAEhD,KAAK,CAAC,EAAE,IAAkB,EAAE,IAAW,EAAE,GAAE,aAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4BtF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgF3B;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;CAmDhI"}

package/dist/server/Daemon.js

@@ -0,0 +1,252 @@
+// Top-level daemon orchestrator. Owns the DB connection, engine, registries,
+// the WebSocketServer, and the active client connections.
+// SPEC §13.
+import { WebSocketServer } from "ws";
+import { resolve } from "node:path";
+import Engine from "../core/Engine.js";
+import SchemeRegistry from "../core/SchemeRegistry.js";
+import { Mimetypes } from "@plurnk/plurnk-mimetypes";
+import { discoverPlugins, loadPlugin } from "../core/PluginLoader.js";
+import MethodRegistry from "./MethodRegistry.js";
+import ClientConnection from "./ClientConnection.js";
+import { register as registerPing } from "./methods/ping.js";
+import { register as registerDiscover } from "./methods/discover.js";
+import { register as registerSessionCreate } from "./methods/session_create.js";
+import { register as registerSessionList } from "./methods/session_list.js";
+import { register as registerSessionAttach } from "./methods/session_attach.js";
+import { register as registerSessionRuns } from "./methods/session_runs.js";
+import { register as registerSessionSetRoot } from "./methods/session_set_root.js";
+import { register as registerSessionSetPersona } from "./methods/session_set_persona.js";
+import { register as registerOpEdit } from "./methods/op_edit.js";
+import { register as registerOpRead } from "./methods/op_read.js";
+import { register as registerOpFind } from "./methods/op_find.js";
+import { register as registerOpShow } from "./methods/op_show.js";
+import { register as registerOpHide } from "./methods/op_hide.js";
+import { register as registerOpCopy } from "./methods/op_copy.js";
+import { register as registerOpMove } from "./methods/op_move.js";
+import { register as registerOpSend } from "./methods/op_send.js";
+import { register as registerOpExec } from "./methods/op_exec.js";
+import { register as registerOpDispatch } from "./methods/op_dispatch.js";
+import { register as registerOpParse } from "./methods/op_parse.js";
+import { register as registerLoopRun } from "./methods/loop_run.js";
+import { register as registerEntryRead } from "./methods/entry_read.js";
+import { register as registerLogRead } from "./methods/log_read.js";
+import { register as registerProvidersList } from "./methods/providers_list.js";
+import { register as registerLoopResolve } from "./methods/loop_resolve.js";
+import { attachYolo } from "./yolo.js";
+export default class Daemon {
+    #db;
+    #engine;
+    #schemes;
+    #mimetypes;
+    #provider;
+    #registry;
+    #nodeModulesPath;
+    #wss = null;
+    #connections = new Set();
+    constructor({ db, schemes, mimetypes, provider, nodeModulesPath, }) {
+        this.#db = db;
+        this.#schemes = schemes ?? new SchemeRegistry();
+        this.#provider = provider ?? null;
+        // Mimetypes owns discovery, detection, handler instantiation, and
+        // budget-truncated preview rendering. plurnk-service stays mimetype-
+        // illiterate — we just inject the tokenize function (sourced from the
+        // active provider's countTokens) and configure text/markdown as the
+        // default mimetype (LLM output is overwhelmingly markdown; the
+        // text-markdown handler is a hard dep so the default actually
+        // resolves at runtime).
+        this.#mimetypes = mimetypes ?? new Mimetypes({
+            tokenize: async (text) => this.#provider?.countTokens(text) ?? Math.ceil(text.length / 4),
+            defaultMimetype: "text/markdown",
+        });
+        this.#engine = new Engine({ db, schemes: this.#schemes, mimetypes: this.#mimetypes });
+        this.#nodeModulesPath = nodeModulesPath ?? resolve(process.cwd(), "node_modules");
+        this.#registry = new MethodRegistry();
+        this.#registerBuiltins();
+        this.#registerNotifications();
+        // Wire proposal-pending events to the loop/proposal WS notification.
+        // Sessionid scopes the broadcast to clients on the same session.
+        this.#engine.onProposalPending((event) => {
+            this.#broadcast({ sessionId: event.sessionId }, null, "loop/proposal", {
+                logEntryId: event.logEntryId,
+                loopId: event.loopId,
+                turnId: event.turnId,
+                op: event.op,
+                target: event.target,
+                body: event.body,
+                attrs: event.attrs,
+                // event.flags is carried for discoverability — a client in
+                // server-YOLO mode (event.flags.yolo=true) knows to skip
+                // rendering review UI because the entry will resolve in-
+                // process before any human can react.
+                flags: event.flags,
+            });
+        });
+        // In-tree YOLO listener — auto-accepts proposals when the loop's
+        // persisted flags.yolo === true. Skips client roundtrip entirely.
+        attachYolo(this.#engine, this.#db);
+    }
+    get registry() { return this.#registry; }
+    get engine() { return this.#engine; }
+    get provider() { return this.#provider; }
+    get schemes() { return this.#schemes; }
+    get mimetypes() { return this.#mimetypes; }
+    async start({ host = "127.0.0.1", port = 3044 } = {}) {
+        if (this.#wss !== null)
+            throw new Error("daemon already started");
+        await this.#discoverAndLoadPlugins();
+        // Mimetypes owns its own discovery scan over @plurnk/plurnk-mimetypes-*
+        // packages; pre-warm it so first index render doesn't pay the cost.
+        await this.#mimetypes.ready();
+        return new Promise((resolve, reject) => {
+            const wss = new WebSocketServer({ host, port });
+            wss.on("listening", () => {
+                this.#wss = wss;
+                wss.on("connection", (ws) => this.#onConnection(ws));
+                const addr = wss.address();
+                if (addr === null || typeof addr === "string") {
+                    reject(new Error("WebSocketServer.address() returned unexpected value"));
+                    return;
+                }
+                resolve({ host: addr.address, port: addr.port });
+            });
+            wss.on("error", (err) => {
+                if (this.#wss === null)
+                    reject(err);
+            });
+        });
+    }
+    async stop() {
+        if (this.#wss === null)
+            return;
+        for (const conn of this.#connections)
+            conn.close();
+        this.#connections.clear();
+        await new Promise((resolve, reject) => {
+            this.#wss?.close((err) => {
+                if (err !== undefined)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+        this.#wss = null;
+    }
+    #registerBuiltins() {
+        registerPing(this.#registry);
+        registerDiscover(this.#registry);
+        registerSessionCreate(this.#registry);
+        registerSessionList(this.#registry);
+        registerSessionAttach(this.#registry);
+        registerSessionRuns(this.#registry);
+        registerSessionSetRoot(this.#registry);
+        registerSessionSetPersona(this.#registry);
+        registerOpEdit(this.#registry);
+        registerOpRead(this.#registry);
+        registerOpFind(this.#registry);
+        registerOpShow(this.#registry);
+        registerOpHide(this.#registry);
+        registerOpCopy(this.#registry);
+        registerOpMove(this.#registry);
+        registerOpSend(this.#registry);
+        registerOpExec(this.#registry);
+        registerOpDispatch(this.#registry);
+        registerOpParse(this.#registry);
+        registerLoopRun(this.#registry);
+        registerLoopResolve(this.#registry);
+        registerEntryRead(this.#registry);
+        registerLogRead(this.#registry);
+        registerProvidersList(this.#registry);
+    }
+    #registerNotifications() {
+        this.#registry.registerNotification("log/entry", {
+            description: "A new log_entries row was written; scoped to the connection's attached session.",
+            params: { entry: "LogEntry — wire-shape log_entries row" },
+        });
+        this.#registry.registerNotification("loop/proposal", {
+            description: "A side-effecting action emitted a proposal (status=202, state='proposed'); dispatch is paused awaiting client resolution via loop.resolve. Scoped to the connection's attached session.",
+            params: {
+                logEntryId: "number — the log_entries.id awaiting resolution",
+                loopId: "number",
+                turnId: "number",
+                op: "string — the operation (EDIT, EXEC, etc.)",
+                target: "{scheme, pathname} — the resource being acted on",
+                body: "string — preview body (udiff for file edits, command summary for exec)",
+                attrs: "object — scheme-specific payload (patch, command args, etc.); opaque to engine",
+                flags: "{yolo, mode, noWeb, noInteraction, noProposals} — loop's persisted flags. flags.yolo=true means server-side YOLO is active and the engine will auto-accept in-process; clients can skip review UI for those entries.",
+            },
+        });
+        this.#registry.registerNotification("loop/terminated", {
+            description: "A loop has reached a terminal status; scoped to the connection's attached session.",
+            params: {
+                loopId: "number",
+                finalStatus: "number — terminal status code (200, 499, etc.)",
+                hitMaxTurns: "boolean",
+            },
+        });
+        this.#registry.registerNotification("stream/event", {
+            description: "A channel's content grew or its state transitioned. Scoped to the entry's session. Metadata-only; clients fetch new content via entry.read or op.read.",
+            params: {
+                entryId: "number — the entry whose channel changed",
+                channel: "string — the channel name",
+                state: "string — current state (static, active, closed, errored)",
+                contentLength: "number — current length of the channel's content",
+            },
+        });
+    }
+    /**
+     * Emit a stream/event notification scoped to the session containing the
+     * entry. ChannelWrite helpers (src/core/ChannelWrite.ts) invoke this when
+     * they update channel content or state. SPEC §13.6.
+     */
+    notifyStreamEvent(sessionId, event) {
+        this.#broadcast({ sessionId }, null, "stream/event", event);
+    }
+    #onConnection(ws) {
+        const conn = new ClientConnection({
+            ws,
+            registry: this.#registry,
+            db: this.#db,
+            engine: this.#engine,
+            provider: this.#provider,
+            broadcast: (target, from, method, params) => this.#broadcast(target, from, method, params),
+        });
+        this.#connections.add(conn);
+        ws.on("close", () => {
+            conn.close();
+            this.#connections.delete(conn);
+        });
+    }
+    async #discoverAndLoadPlugins() {
+        // Scheme discovery only. Providers are config-driven (wired via the
+        // bin script). Mimetypes self-discovers — Mimetypes.ready() in start()
+        // scans @plurnk/plurnk-mimetypes-* packages via the framework's own
+        // discover().
+        const plugins = await discoverPlugins(this.#nodeModulesPath);
+        for (const plugin of plugins) {
+            if (plugin.manifest.kind !== "scheme")
+                continue;
+            const instance = await loadPlugin(plugin);
+            this.#schemes.register(plugin.manifest.name, instance);
+        }
+    }
+    #broadcast(target, from, method, params) {
+        if (target === "this") {
+            from?.sendNotification(method, params);
+            return;
+        }
+        if (target === "all") {
+            for (const conn of this.#connections) {
+                conn.sendNotification(method, params);
+            }
+            return;
+        }
+        const sessionId = target.sessionId;
+        for (const conn of this.#connections) {
+            if (conn.session?.sessionId === sessionId) {
+                conn.sendNotification(method, params);
+            }
+        }
+    }
+}
+//# sourceMappingURL=Daemon.js.map

package/dist/server/Daemon.js.map

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

package/dist/server/MethodRegistry.d.ts

@@ -0,0 +1,56 @@
+import type Engine from "../core/Engine.ts";
+import type { Db } from "../core/Db.ts";
+import type { Provider } from "../core/ProviderRegistry.ts";
+import type { ClientEnvelope } from "./envelope.ts";
+export type { Provider } from "../core/ProviderRegistry.ts";
+export type NotifyTarget = "this" | "all" | {
+    sessionId: number;
+};
+export type MethodHandler = (params: unknown, ctx: HandlerContext) => Promise<unknown>;
+export interface HandlerContext {
+    registry: MethodRegistry;
+    db: Db;
+    engine: Engine;
+    provider: Provider | null;
+    session: ClientEnvelope | null;
+    attachSession: (envelope: ClientEnvelope) => void;
+    notify: (target: NotifyTarget, method: string, params?: unknown) => void;
+}
+export interface MethodRegistration {
+    handler: MethodHandler;
+    description: string;
+    params?: Record<string, string>;
+    requiresInit?: boolean;
+    longRunning?: boolean;
+}
+export interface NotificationRegistration {
+    description: string;
+    params?: Record<string, string>;
+}
+export interface MethodCatalogEntry {
+    description: string;
+    params: Record<string, string>;
+    requiresInit: boolean;
+    longRunning: boolean;
+}
+export interface NotificationCatalogEntry {
+    description: string;
+    params: Record<string, string>;
+}
+export interface Catalog {
+    protocolVersion: string;
+    methods: Record<string, MethodCatalogEntry>;
+    notifications: Record<string, NotificationCatalogEntry>;
+}
+export default class MethodRegistry {
+    #private;
+    registerMethod(name: string, registration: MethodRegistration): void;
+    registerNotification(name: string, registration: NotificationRegistration): void;
+    getMethod(name: string): MethodRegistration | undefined;
+    hasMethod(name: string): boolean;
+    hasNotification(name: string): boolean;
+    listMethods(): string[];
+    listNotifications(): string[];
+    catalog(): Catalog;
+}
+//# sourceMappingURL=MethodRegistry.d.ts.map

package/dist/server/MethodRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodRegistry.d.ts","sourceRoot":"","sources":["../../src/server/MethodRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAC5C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,cAAc,CAAC;IACzB,EAAE,EAAE,EAAE,CAAC;IACP,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,MAAM,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC5E;AAED,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,OAAO;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;CAC3D;AAID,MAAM,CAAC,OAAO,OAAO,cAAc;;IAI/B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,kBAAkB,GAAG,IAAI;IAOpE,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,wBAAwB,GAAG,IAAI;IAOhF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIvD,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAItC,WAAW,IAAI,MAAM,EAAE;IAIvB,iBAAiB,IAAI,MAAM,EAAE;IAI7B,OAAO,IAAI,OAAO;CAmBrB"}

package/dist/server/MethodRegistry.js

@@ -0,0 +1,55 @@
+// Daemon's method + notification registry. Methods are JSON-RPC endpoints
+// the daemon exposes; notifications are server-initiated events the daemon
+// may emit. Both have metadata that surfaces via `discover` (SPEC §13.4).
+const PROTOCOL_VERSION = "0.1.0";
+export default class MethodRegistry {
+    #methods = new Map();
+    #notifications = new Map();
+    registerMethod(name, registration) {
+        if (this.#methods.has(name)) {
+            throw new Error(`method '${name}' is already registered`);
+        }
+        this.#methods.set(name, registration);
+    }
+    registerNotification(name, registration) {
+        if (this.#notifications.has(name)) {
+            throw new Error(`notification '${name}' is already registered`);
+        }
+        this.#notifications.set(name, registration);
+    }
+    getMethod(name) {
+        return this.#methods.get(name);
+    }
+    hasMethod(name) {
+        return this.#methods.has(name);
+    }
+    hasNotification(name) {
+        return this.#notifications.has(name);
+    }
+    listMethods() {
+        return [...this.#methods.keys()].toSorted();
+    }
+    listNotifications() {
+        return [...this.#notifications.keys()].toSorted();
+    }
+    catalog() {
+        const methods = {};
+        for (const [name, reg] of this.#methods.entries()) {
+            methods[name] = {
+                description: reg.description,
+                params: reg.params ?? {},
+                requiresInit: reg.requiresInit ?? false,
+                longRunning: reg.longRunning ?? false,
+            };
+        }
+        const notifications = {};
+        for (const [name, reg] of this.#notifications.entries()) {
+            notifications[name] = {
+                description: reg.description,
+                params: reg.params ?? {},
+            };
+        }
+        return { protocolVersion: PROTOCOL_VERSION, methods, notifications };
+    }
+}
+//# sourceMappingURL=MethodRegistry.js.map

package/dist/server/MethodRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MethodRegistry.js","sourceRoot":"","sources":["../../src/server/MethodRegistry.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,2EAA2E;AAC3E,0EAA0E;AAsD1E,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IACjD,cAAc,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE7D,cAAc,CAAC,IAAY,EAAE,YAAgC;QACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,yBAAyB,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAC1C,CAAC;IAED,oBAAoB,CAAC,IAAY,EAAE,YAAsC;QACrE,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,yBAAyB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,SAAS,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,SAAS,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,eAAe,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,WAAW;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,iBAAiB;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;IAED,OAAO;QACH,MAAM,OAAO,GAAuC,EAAE,CAAC;QACvD,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,OAAO,CAAC,IAAI,CAAC,GAAG;gBACZ,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;gBACxB,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,KAAK;gBACvC,WAAW,EAAE,GAAG,CAAC,WAAW,IAAI,KAAK;aACxC,CAAC;QACN,CAAC;QACD,MAAM,aAAa,GAA6C,EAAE,CAAC;QACnE,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,CAAC;YACtD,aAAa,CAAC,IAAI,CAAC,GAAG;gBAClB,WAAW,EAAE,GAAG,CAAC,WAAW;gBAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;aAC3B,CAAC;QACN,CAAC;QACD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IACzE,CAAC;CACJ"}

package/dist/server/clientTurn.d.ts

@@ -0,0 +1,3 @@
+import type { Db } from "../core/Db.ts";
+export declare const insertClientTurn: (db: Db, loopId: number) => Promise<number>;
+//# sourceMappingURL=clientTurn.d.ts.map

package/dist/server/clientTurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTurn.d.ts","sourceRoot":"","sources":["../../src/server/clientTurn.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,eAAe,CAAC;AAUpD,eAAO,MAAM,gBAAgB,GAAU,IAAI,EAAE,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,MAAM,CAQ7E,CAAC"}

package/dist/server/clientTurn.js

@@ -0,0 +1,22 @@
+// Helper for creating a turn inside a connection's client loop. Each
+// client-origin RPC dispatch (op.*) creates one such turn with a synthetic
+// packet matching the same shape as model turns but with empty content.
+const CLIENT_TURN_PACKET = JSON.stringify({
+    tokens: 0,
+    system: { tokens: 0, system_definition: "", persona: "", index: [], log: [] },
+    user: { tokens: 0, prompt: "", telemetry: { budget: "", errors: [] }, system_requirements: "" },
+    assistant: { tokens: 0, content: "", ops: [], reasoning: null },
+    assistantRaw: null,
+});
+export const insertClientTurn = async (db, loopId) => {
+    const seqRow = await db.client_turn_next_sequence.get({ loop_id: loopId });
+    if (seqRow === undefined)
+        throw new Error("insertClientTurn: next-sequence query returned no row");
+    const row = await db.client_turn_insert.get({
+        loop_id: loopId, sequence: seqRow.next, packet: CLIENT_TURN_PACKET,
+    });
+    if (row === undefined)
+        throw new Error("insertClientTurn: insert returned no row");
+    return row.id;
+};
+//# sourceMappingURL=clientTurn.js.map

package/dist/server/clientTurn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTurn.js","sourceRoot":"","sources":["../../src/server/clientTurn.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,2EAA2E;AAC3E,wEAAwE;AAIxE,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,CAAC;IACtC,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;IAC7E,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE;IAC/F,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IAC/D,YAAY,EAAE,IAAI;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,EAAM,EAAE,MAAc,EAAmB,EAAE;IAC9E,MAAM,MAAM,GAAG,MAAO,EAAE,CAAC,yBAAwC,CAAC,GAAG,CAAmB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7G,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;IACnG,MAAM,GAAG,GAAG,MAAO,EAAE,CAAC,kBAAiC,CAAC,GAAG,CAAiB;QACxE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,kBAAkB;KACrE,CAAC,CAAC;IACH,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACnF,OAAO,GAAG,CAAC,EAAE,CAAC;AAClB,CAAC,CAAC"}