@plurnk/plurnk-service 0.1.0

package/dist/server/methods/ping.js

@@ -0,0 +1,7 @@
+export const register = (registry) => {
+    registry.registerMethod("ping", {
+        handler: async () => ({}),
+        description: "Liveness check. Returns an empty object.",
+    });
+};
+//# sourceMappingURL=ping.js.map

package/dist/server/methods/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../../src/server/methods/ping.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,MAAM,EAAE;QAC5B,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACzB,WAAW,EAAE,0CAA0C;KAC1D,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/providers_list.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=providers_list.d.ts.map

package/dist/server/methods/providers_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers_list.d.ts","sourceRoot":"","sources":["../../../src/server/methods/providers_list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAgBnD,CAAC"}

package/dist/server/methods/providers_list.js

@@ -0,0 +1,19 @@
+import { parseAliasesFromEnv, resolveActiveAlias } from "../../core/ProviderRegistry.js";
+export const register = (registry) => {
+    registry.registerMethod("providers.list", {
+        handler: async () => {
+            const aliases = parseAliasesFromEnv();
+            const active = resolveActiveAlias();
+            return {
+                aliases: aliases.map((a) => ({
+                    alias: a.alias,
+                    provider: a.provider,
+                    model: a.model,
+                    active: active !== null && active.alias === a.alias,
+                })),
+            };
+        },
+        description: "List configured model aliases (PLURNK_MODEL_<alias>) and which one is active.",
+    });
+};
+//# sourceMappingURL=providers_list.js.map

package/dist/server/methods/providers_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers_list.js","sourceRoot":"","sources":["../../../src/server/methods/providers_list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE;QACtC,OAAO,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;YACpC,OAAO;gBACH,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;oBACpB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;iBACtD,CAAC,CAAC;aACN,CAAC;QACN,CAAC;QACD,WAAW,EAAE,+EAA+E;KAC/F,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/session_attach.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=session_attach.d.ts.map

package/dist/server/methods/session_attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_attach.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_attach.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAuCnD,CAAC"}

package/dist/server/methods/session_attach.js

@@ -0,0 +1,42 @@
+import { attachToSession } from "../envelope.js";
+export const register = (registry) => {
+    registry.registerMethod("session.attach", {
+        handler: async (params, ctx) => {
+            if (ctx.session !== null) {
+                throw new Error("connection already has a session attached");
+            }
+            const p = (params ?? {});
+            if (typeof p.id !== "number") {
+                throw new Error("session.attach requires params.id: number");
+            }
+            if (p.runId !== undefined && typeof p.runId !== "number") {
+                throw new Error("session.attach: runId must be a number");
+            }
+            if (p.runName !== undefined && (typeof p.runName !== "string" || p.runName.length === 0)) {
+                throw new Error("session.attach: runName must be a non-empty string");
+            }
+            const persona = p.persona ?? null;
+            if (persona !== null && typeof persona !== "string") {
+                throw new Error("session.attach: persona must be a string or null");
+            }
+            const envelope = await attachToSession(ctx.db, p.id, { runId: p.runId, runName: p.runName, persona });
+            ctx.attachSession(envelope);
+            return {
+                id: envelope.sessionId,
+                name: envelope.sessionName,
+                sessionPersona: envelope.sessionPersona,
+                runId: envelope.runId,
+                runName: envelope.runName,
+                runPersona: envelope.runPersona,
+            };
+        },
+        description: "Attach this connection to an existing session. Optionally resume an existing run by id or name; otherwise creates a fresh run. The persona param sets run-level persona ONLY when a new run is created (reusing an existing run preserves its stored persona; use session.set_persona for session-level changes).",
+        params: {
+            id: "number — session id to attach to",
+            runId: "number? — resume the run with this id (must belong to the session)",
+            runName: "string? — resume the run with this name within the session; create if absent",
+            persona: "string? — run-level persona (text/markdown); applied to a NEWLY created run only",
+        },
+    });
+};
+//# sourceMappingURL=session_attach.js.map

package/dist/server/methods/session_attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_attach.js","sourceRoot":"","sources":["../../../src/server/methods/session_attach.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE;QACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAA8E,CAAC;YACtG,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACjE,CAAC;YACD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC9D,CAAC;YACD,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;gBACvF,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;YAClC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YACtG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC5B,OAAO;gBACH,EAAE,EAAE,QAAQ,CAAC,SAAS;gBACtB,IAAI,EAAE,QAAQ,CAAC,WAAW;gBAC1B,cAAc,EAAE,QAAQ,CAAC,cAAc;gBACvC,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;aAClC,CAAC;QACN,CAAC;QACD,WAAW,EAAE,mTAAmT;QAChU,MAAM,EAAE;YACJ,EAAE,EAAE,kCAAkC;YACtC,KAAK,EAAE,oEAAoE;YAC3E,OAAO,EAAE,8EAA8E;YACvF,OAAO,EAAE,kFAAkF;SAC9F;KACJ,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/session_create.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=session_create.d.ts.map

package/dist/server/methods/session_create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_create.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAkDnD,CAAC"}

package/dist/server/methods/session_create.js

@@ -0,0 +1,53 @@
+import { isAbsolute } from "node:path";
+import { createClientEnvelope } from "../envelope.js";
+export const register = (registry) => {
+    registry.registerMethod("session.create", {
+        handler: async (params, ctx) => {
+            if (ctx.session !== null) {
+                throw new Error("connection already has a session attached");
+            }
+            const p = (params ?? {});
+            const projectRoot = p.projectRoot ?? null;
+            if (projectRoot !== null) {
+                if (typeof projectRoot !== "string" || projectRoot.length === 0) {
+                    throw new Error("session.create: projectRoot must be a non-empty string or null");
+                }
+                if (!isAbsolute(projectRoot)) {
+                    throw new Error("session.create: projectRoot must be an absolute path");
+                }
+            }
+            const persona = p.persona ?? null;
+            if (persona !== null && typeof persona !== "string") {
+                throw new Error("session.create: persona must be a string or null");
+            }
+            const envelope = await createClientEnvelope(ctx.db, { name: p.name, projectRoot, persona });
+            ctx.attachSession(envelope);
+            ctx.notify("all", "session/created", {
+                id: envelope.sessionId,
+                name: envelope.sessionName,
+                projectRoot: envelope.projectRoot,
+                persona: envelope.sessionPersona,
+            });
+            return {
+                id: envelope.sessionId, name: envelope.sessionName,
+                projectRoot: envelope.projectRoot, persona: envelope.sessionPersona,
+            };
+        },
+        description: "Create a new session and attach this connection to it. Optionally pin the session to a workspace via projectRoot, and/or set a session-level persona (text/markdown injected into packet.system.persona). Per-run and per-loop overrides may further refine the persona.",
+        params: {
+            name: "string? — session name (auto-generated if omitted)",
+            projectRoot: "string? — absolute path to the client's workspace; null/omitted = headless mode (no disk side-effects on file ops)",
+            persona: "string? — session-level persona (text/markdown); cascades as: loops.persona > runs.persona > sessions.persona > PLURNK_PERSONA file",
+        },
+    });
+    registry.registerNotification("session/created", {
+        description: "A new session has been created. Broadcast to all connected clients.",
+        params: {
+            id: "number — session id",
+            name: "string — session name",
+            projectRoot: "string|null — workspace pointer for the session (null = headless)",
+            persona: "string|null — session-level persona override (null = no override at this level)",
+        },
+    });
+};
+//# sourceMappingURL=session_create.js.map

package/dist/server/methods/session_create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_create.js","sourceRoot":"","sources":["../../../src/server/methods/session_create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE;QACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;YACjE,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAA4E,CAAC;YACpG,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC;YAC1C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;gBACtF,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;gBAC5E,CAAC;YACL,CAAC;YACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;YAClC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5F,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC5B,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE;gBACjC,EAAE,EAAE,QAAQ,CAAC,SAAS;gBACtB,IAAI,EAAE,QAAQ,CAAC,WAAW;gBAC1B,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,OAAO,EAAE,QAAQ,CAAC,cAAc;aACnC,CAAC,CAAC;YACH,OAAO;gBACH,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW;gBAClD,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc;aACtE,CAAC;QACN,CAAC;QACD,WAAW,EAAE,0QAA0Q;QACvR,MAAM,EAAE;YACJ,IAAI,EAAE,oDAAoD;YAC1D,WAAW,EAAE,oHAAoH;YACjI,OAAO,EAAE,qIAAqI;SACjJ;KACJ,CAAC,CAAC;IAEH,QAAQ,CAAC,oBAAoB,CAAC,iBAAiB,EAAE;QAC7C,WAAW,EAAE,qEAAqE;QAClF,MAAM,EAAE;YACJ,EAAE,EAAE,qBAAqB;YACzB,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,mEAAmE;YAChF,OAAO,EAAE,iFAAiF;SAC7F;KACJ,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/session_list.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=session_list.d.ts.map

package/dist/server/methods/session_list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_list.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_list.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAKnD,CAAC"}

package/dist/server/methods/session_list.js

@@ -0,0 +1,8 @@
+import { listSessions } from "../envelope.js";
+export const register = (registry) => {
+    registry.registerMethod("session.list", {
+        handler: async (_params, ctx) => ({ sessions: await listSessions(ctx.db) }),
+        description: "List all sessions, most recent first.",
+    });
+};
+//# sourceMappingURL=session_list.js.map

package/dist/server/methods/session_list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_list.js","sourceRoot":"","sources":["../../../src/server/methods/session_list.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,cAAc,EAAE;QACpC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3E,WAAW,EAAE,uCAAuC;KACvD,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/session_runs.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=session_runs.d.ts.map

package/dist/server/methods/session_runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_runs.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAenD,CAAC"}

package/dist/server/methods/session_runs.js

@@ -0,0 +1,18 @@
+import { listRunsForSession } from "../envelope.js";
+export const register = (registry) => {
+    registry.registerMethod("session.runs", {
+        handler: async (params, ctx) => {
+            const p = (params ?? {});
+            const sessionId = p.id ?? ctx.session?.sessionId;
+            if (typeof sessionId !== "number") {
+                throw new Error("session.runs requires params.id: number (or an attached session)");
+            }
+            return { runs: await listRunsForSession(ctx.db, sessionId) };
+        },
+        description: "List runs in a session, most recent first.",
+        params: {
+            id: "number? — session id; defaults to the attached session",
+        },
+    });
+};
+//# sourceMappingURL=session_runs.js.map

package/dist/server/methods/session_runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_runs.js","sourceRoot":"","sources":["../../../src/server/methods/session_runs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,cAAc,EAAE;QACpC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAoB,CAAC;YAC5C,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC;YACjD,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;YACxF,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC;QACjE,CAAC;QACD,WAAW,EAAE,4CAA4C;QACzD,MAAM,EAAE;YACJ,EAAE,EAAE,wDAAwD;SAC/D;KACJ,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/session_set_persona.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=session_set_persona.d.ts.map

package/dist/server/methods/session_set_persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_set_persona.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_set_persona.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IAwBnD,CAAC"}

package/dist/server/methods/session_set_persona.js

@@ -0,0 +1,27 @@
+import { updateSessionPersona } from "../envelope.js";
+export const register = (registry) => {
+    registry.registerMethod("session.set_persona", {
+        handler: async (params, ctx) => {
+            if (ctx.session === null) {
+                throw new Error("session.set_persona requires an attached session");
+            }
+            const p = (params ?? {});
+            const persona = p.persona ?? null;
+            if (persona !== null && typeof persona !== "string") {
+                throw new Error("session.set_persona: persona must be a string or null");
+            }
+            const updated = await updateSessionPersona(ctx.db, ctx.session.sessionId, persona);
+            // Mutate the attached envelope so subsequent handler invocations
+            // on this connection observe the new value. ctx.session is the
+            // same object reference held in ClientConnection.#session.
+            ctx.session.sessionPersona = updated;
+            return { id: ctx.session.sessionId, persona: updated };
+        },
+        description: "Update the session-level persona (text/markdown injected into packet.system.persona when no per-run or per-loop override exists). Pass null to clear the override and fall through to PLURNK_PERSONA file.",
+        params: {
+            persona: "string|null — session-level persona content; null clears the override",
+        },
+        requiresInit: true,
+    });
+};
+//# sourceMappingURL=session_set_persona.js.map

package/dist/server/methods/session_set_persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_set_persona.js","sourceRoot":"","sources":["../../../src/server/methods/session_set_persona.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,qBAAqB,EAAE;QAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACxE,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAgC,CAAC;YACxD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;YAClC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACnF,iEAAiE;YACjE,+DAA+D;YAC/D,2DAA2D;YAC3D,GAAG,CAAC,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC;YACrC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC3D,CAAC;QACD,WAAW,EAAE,4MAA4M;QACzN,MAAM,EAAE;YACJ,OAAO,EAAE,uEAAuE;SACnF;QACD,YAAY,EAAE,IAAI;KACrB,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/methods/session_set_root.d.ts

@@ -0,0 +1,3 @@
+import type MethodRegistry from "../MethodRegistry.ts";
+export declare const register: (registry: MethodRegistry) => void;
+//# sourceMappingURL=session_set_root.d.ts.map

package/dist/server/methods/session_set_root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_set_root.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_set_root.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,eAAO,MAAM,QAAQ,GAAI,UAAU,cAAc,KAAG,IA6BnD,CAAC"}

package/dist/server/methods/session_set_root.js

@@ -0,0 +1,33 @@
+import { isAbsolute } from "node:path";
+import { updateSessionProjectRoot } from "../envelope.js";
+export const register = (registry) => {
+    registry.registerMethod("session.set_root", {
+        handler: async (params, ctx) => {
+            if (ctx.session === null) {
+                throw new Error("session.set_root requires an attached session");
+            }
+            const p = (params ?? {});
+            const projectRoot = p.projectRoot ?? null;
+            if (projectRoot !== null) {
+                if (typeof projectRoot !== "string" || projectRoot.length === 0) {
+                    throw new Error("session.set_root: projectRoot must be a non-empty string or null");
+                }
+                if (!isAbsolute(projectRoot)) {
+                    throw new Error("session.set_root: projectRoot must be an absolute path");
+                }
+            }
+            const updated = await updateSessionProjectRoot(ctx.db, ctx.session.sessionId, projectRoot);
+            // Mutate the attached envelope so subsequent handler invocations on
+            // this connection observe the new value. ctx.session is the same
+            // object reference held in ClientConnection.#session.
+            ctx.session.projectRoot = updated;
+            return { id: ctx.session.sessionId, projectRoot: updated };
+        },
+        description: "Update the workspace pointer (projectRoot) on the currently-attached session. Pass null to revert to headless mode.",
+        params: {
+            projectRoot: "string|null — absolute path to the client's workspace; null = headless",
+        },
+        requiresInit: true,
+    });
+};
+//# sourceMappingURL=session_set_root.js.map

package/dist/server/methods/session_set_root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session_set_root.js","sourceRoot":"","sources":["../../../src/server/methods/session_set_root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,QAAwB,EAAQ,EAAE;IACvD,QAAQ,CAAC,cAAc,CAAC,kBAAkB,EAAE;QACxC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAoC,CAAC;YAC5D,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC;YAC1C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9D,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;gBACxF,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBAC9E,CAAC;YACL,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,wBAAwB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAC3F,oEAAoE;YACpE,iEAAiE;YACjE,sDAAsD;YACtD,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;QAC/D,CAAC;QACD,WAAW,EAAE,qHAAqH;QAClI,MAAM,EAAE;YACJ,WAAW,EAAE,wEAAwE;SACxF;QACD,YAAY,EAAE,IAAI;KACrB,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/server/yolo.d.ts

@@ -0,0 +1,4 @@
+import type Engine from "../core/Engine.ts";
+import type { Db } from "../core/Db.ts";
+export declare const attachYolo: (engine: Engine, _db: Db) => void;
+//# sourceMappingURL=yolo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"yolo.d.ts","sourceRoot":"","sources":["../../src/server/yolo.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,MAAM,MAAM,mBAAmB,CAAC;AAE5C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AAExC,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,KAAK,EAAE,KAAG,IAUpD,CAAC"}

package/dist/server/yolo.js

@@ -0,0 +1,48 @@
+// Server-side YOLO listener — in-tree subscriber to Engine.onProposalPending
+// that auto-accepts proposals when the loop's persisted flags.yolo === true.
+// No client roundtrip; no human approval; no RPC involvement.
+//
+// === Server-side vs client-side YOLO ===
+//
+// These are distinct features. Both have legitimate use cases. Neither
+// replaces the other.
+//
+//   Server-side YOLO (this file)
+//     - Enabled via loops.flags.yolo = true. RPC opt-in:
+//       loop.run({ prompt, flags: { yolo: true } }).
+//     - Engine auto-accepts in-process; the client need not be connected.
+//     - Use cases: benchmarks (pure model+grammar timing, no RPC roundtrip
+//       in the hot loop), CI runs, ad-hoc internal automation, test
+//       fixtures. Anywhere "just run and tell me the final state" is the
+//       right contract.
+//     - Client apps (@plurnk/plurnk CLI / TUI) intentionally do NOT expose
+//       this flag — server YOLO is not standard end-user ergonomics.
+//
+//   Client-side YOLO (@plurnk/plurnk --yolo / PLURNK_YOLO)
+//     - Client receives the loop/proposal notification and immediately
+//       sends loop.resolve({decision:"accept", outcome:"client_yolo"}).
+//     - The wire roundtrip still happens; the daemon stays unaware that
+//       no human reviewed.
+//     - Use cases: real users who want "stop bothering me" ergonomics
+//       across an interactive session. Documented in client SPEC §6.3.
+//
+// Listener fires BEFORE Engine.#awaitResolution awaits the waiter, so a
+// synchronous resolveProposal here is delivered to the awaiting dispatch
+// without yielding. The loop/proposal broadcast still goes out (listeners
+// fan out independently) — clients in server-YOLO runs may see a brief
+// proposed-then-resolved blink in their UI. The carried event.flags.yolo
+// lets clients suppress review-UI rendering for those entries.
+export const attachYolo = (engine, _db) => {
+    engine.onProposalPending((event) => {
+        if (!event.flags.yolo)
+            return;
+        try {
+            engine.resolveProposal(event.logEntryId, { decision: "accept" });
+        }
+        catch {
+            // Errors here don't abort dispatch — the proposal stays
+            // pending and falls through to the RPC / timeout path.
+        }
+    });
+};
+//# sourceMappingURL=yolo.js.map

package/dist/server/yolo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yolo.js","sourceRoot":"","sources":["../../src/server/yolo.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,EAAE;AACF,0CAA0C;AAC1C,EAAE;AACF,uEAAuE;AACvE,sBAAsB;AACtB,EAAE;AACF,iCAAiC;AACjC,yDAAyD;AACzD,qDAAqD;AACrD,0EAA0E;AAC1E,2EAA2E;AAC3E,oEAAoE;AACpE,yEAAyE;AACzE,wBAAwB;AACxB,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,2DAA2D;AAC3D,uEAAuE;AACvE,wEAAwE;AACxE,wEAAwE;AACxE,2BAA2B;AAC3B,sEAAsE;AACtE,uEAAuE;AACvE,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,yEAAyE;AACzE,+DAA+D;AAM/D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,GAAO,EAAQ,EAAE;IACxD,MAAM,CAAC,iBAAiB,CAAC,CAAC,KAA2B,EAAE,EAAE;QACrD,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI;YAAE,OAAO;QAC9B,IAAI,CAAC;YACD,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACL,wDAAwD;YACxD,uDAAuD;QAC3D,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC"}

package/migrations/001_sessions.sql

@@ -0,0 +1,11 @@
+-- INIT: sessions
+CREATE TABLE IF NOT EXISTS sessions (
+    id                        INTEGER NOT NULL PRIMARY KEY,
+    version                   INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    name                      TEXT    NOT NULL UNIQUE CHECK (length(name) > 0),
+    created_at                TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    cost_pico                 INTEGER NOT NULL DEFAULT 0 CHECK (cost_pico >= 0),
+    scheme_registry_additions TEXT    NOT NULL DEFAULT '[]' CHECK (json_valid(scheme_registry_additions))
+) STRICT;
+
+CREATE INDEX IF NOT EXISTS sessions_created_at ON sessions (created_at);

package/migrations/002_runs.sql

@@ -0,0 +1,16 @@
+-- INIT: runs
+CREATE TABLE IF NOT EXISTS runs (
+    id            INTEGER NOT NULL PRIMARY KEY,
+    version       INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    session_id    INTEGER NOT NULL,
+    name          TEXT    NOT NULL CHECK (length(name) > 0),
+    created_at    TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    parent_run_id INTEGER          CHECK (parent_run_id IS NULL OR parent_run_id != id),
+    cost_pico     INTEGER NOT NULL DEFAULT 0 CHECK (cost_pico >= 0),
+    FOREIGN KEY (session_id)    REFERENCES sessions(id) ON DELETE CASCADE,
+    FOREIGN KEY (parent_run_id) REFERENCES runs(id)     ON DELETE CASCADE
+) STRICT;
+
+CREATE        INDEX IF NOT EXISTS runs_session_id_created_at ON runs (session_id, created_at);
+CREATE        INDEX IF NOT EXISTS runs_parent_run_id         ON runs (parent_run_id);
+CREATE UNIQUE INDEX IF NOT EXISTS runs_session_name          ON runs (session_id, name);

package/migrations/003_loops.sql

@@ -0,0 +1,12 @@
+-- INIT: loops
+CREATE TABLE IF NOT EXISTS loops (
+    id       INTEGER NOT NULL PRIMARY KEY,
+    version  INTEGER NOT NULL DEFAULT 0   CHECK (version >= 0),
+    run_id   INTEGER NOT NULL,
+    sequence INTEGER NOT NULL             CHECK (sequence >= 1),
+    status   INTEGER NOT NULL DEFAULT 102 CHECK (status IN (102, 200, 499)),
+    prompt   TEXT    NOT NULL,
+    FOREIGN KEY (run_id) REFERENCES runs(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS loops_run_id_sequence ON loops (run_id, sequence);

package/migrations/004_turns.sql

@@ -0,0 +1,18 @@
+-- INIT: turns
+CREATE TABLE IF NOT EXISTS turns (
+    id               INTEGER NOT NULL PRIMARY KEY,
+    version          INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    loop_id          INTEGER NOT NULL,
+    sequence         INTEGER NOT NULL           CHECK (sequence >= 1),
+    timestamp        TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    status           INTEGER NOT NULL           CHECK (status BETWEEN 100 AND 599),
+    usage_prompt     INTEGER NOT NULL DEFAULT 0 CHECK (usage_prompt >= 0),
+    usage_completion INTEGER NOT NULL DEFAULT 0 CHECK (usage_completion >= 0),
+    usage_cached     INTEGER NOT NULL DEFAULT 0 CHECK (usage_cached >= 0),
+    usage_cost_pico  INTEGER NOT NULL DEFAULT 0 CHECK (usage_cost_pico >= 0),
+    packet           TEXT    NOT NULL           CHECK (json_valid(packet)),
+    FOREIGN KEY (loop_id) REFERENCES loops(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS turns_loop_id_sequence ON turns (loop_id, sequence);
+CREATE INDEX        IF NOT EXISTS turns_timestamp        ON turns (timestamp);

package/migrations/005_entries.sql

@@ -0,0 +1,44 @@
+-- INIT: entries
+CREATE TABLE IF NOT EXISTS entries (
+    id         INTEGER NOT NULL PRIMARY KEY,
+    version    INTEGER NOT NULL DEFAULT 0   CHECK (version >= 0),
+    scope      TEXT    NOT NULL             CHECK (scope IN ('agent', 'session')),
+    session_id INTEGER,
+    scheme     TEXT                         CHECK (scheme IS NULL OR length(scheme) > 0),
+    username   TEXT,
+    password   TEXT,
+    hostname   TEXT,
+    port       INTEGER                      CHECK (port IS NULL OR (port BETWEEN 0 AND 65535)),
+    pathname   TEXT    NOT NULL,
+    params     TEXT                         CHECK (params IS NULL OR json_valid(params)),
+    attributes TEXT    NOT NULL DEFAULT '{}' CHECK (json_valid(attributes)),
+    CHECK ((scope = 'agent'   AND session_id IS NULL)
+        OR (scope = 'session' AND session_id IS NOT NULL)),
+    FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS entries_agent_identity   ON entries (scheme, pathname)             WHERE scope = 'agent';
+CREATE UNIQUE INDEX IF NOT EXISTS entries_session_identity ON entries (session_id, scheme, pathname) WHERE scope = 'session';
+
+-- SPEC §7.8: the ONE engine-imposed constraint — 100 MiB char-length cap per
+-- channel content body. All other limits (rate, burst, per-call budget, etc.)
+-- are extrinsic — providers, schemes, and mimetypes own their own constraints.
+CREATE TABLE IF NOT EXISTS entry_channels (
+    entry_id INTEGER NOT NULL,
+    name     TEXT    NOT NULL             CHECK (length(name) > 0),
+    content  TEXT    NOT NULL             CHECK (length(content) <= 104857600),
+    mimetype TEXT    NOT NULL             CHECK (length(mimetype) > 0),
+    tokens   INTEGER NOT NULL DEFAULT 0   CHECK (tokens >= 0),
+    state    TEXT    NOT NULL DEFAULT 'static' CHECK (state IN ('static', 'active', 'closed', 'errored')),
+    PRIMARY KEY (entry_id, name),
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT, WITHOUT ROWID;
+
+CREATE TABLE IF NOT EXISTS entry_tags (
+    entry_id INTEGER NOT NULL,
+    tag      TEXT    NOT NULL CHECK (length(tag) > 0),
+    PRIMARY KEY (entry_id, tag),
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT, WITHOUT ROWID;
+
+CREATE INDEX IF NOT EXISTS entry_tags_tag ON entry_tags (tag);

package/migrations/006_log_entries.sql

@@ -0,0 +1,51 @@
+-- INIT: log_entries
+CREATE TABLE IF NOT EXISTS log_entries (
+    id              INTEGER NOT NULL PRIMARY KEY,
+    version         INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+
+    run_id          INTEGER NOT NULL,
+    loop_id         INTEGER NOT NULL,
+    turn_id         INTEGER NOT NULL,
+    action_index    INTEGER NOT NULL           CHECK (action_index >= 0),
+    at              TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    origin          TEXT    NOT NULL           CHECK (origin IN ('model', 'client', 'system', 'plugin')),
+
+    op              TEXT    NOT NULL           CHECK (op IN ('FIND', 'READ', 'EDIT', 'COPY', 'MOVE', 'SHOW', 'HIDE', 'SEND', 'EXEC')),
+    suffix          TEXT    NOT NULL DEFAULT '',
+    signal          TEXT                       CHECK (signal IS NULL OR json_valid(signal)),
+
+    target_scheme   TEXT                       CHECK (target_scheme IS NULL OR length(target_scheme) > 0),
+    target_username TEXT,
+    target_password TEXT,
+    target_hostname TEXT,
+    target_port     INTEGER                    CHECK (target_port IS NULL OR (target_port BETWEEN 0 AND 65535)),
+    target_pathname TEXT,
+    target_params   TEXT                       CHECK (target_params IS NULL OR json_valid(target_params)),
+    target_fragment TEXT,
+
+    lineMarker      TEXT                       CHECK (lineMarker IS NULL OR json_valid(lineMarker)),
+
+    tx              TEXT    NOT NULL,
+    mimetype_tx     TEXT    NOT NULL           CHECK (length(mimetype_tx) > 0),
+
+    rx              TEXT    NOT NULL,
+    mimetype_rx     TEXT    NOT NULL           CHECK (length(mimetype_rx) > 0),
+    status_rx       INTEGER NOT NULL           CHECK (status_rx BETWEEN 100 AND 599),
+
+    tokens          INTEGER NOT NULL DEFAULT 0 CHECK (tokens >= 0),
+
+    FOREIGN KEY (run_id)  REFERENCES runs(id)  ON DELETE CASCADE,
+    FOREIGN KEY (loop_id) REFERENCES loops(id) ON DELETE CASCADE,
+    FOREIGN KEY (turn_id) REFERENCES turns(id) ON DELETE CASCADE
+) STRICT;
+
+CREATE UNIQUE INDEX IF NOT EXISTS log_entries_turn_id_action_index ON log_entries (turn_id, action_index);
+CREATE INDEX        IF NOT EXISTS log_entries_run_id               ON log_entries (run_id);
+CREATE INDEX        IF NOT EXISTS log_entries_loop_id              ON log_entries (loop_id);
+CREATE INDEX        IF NOT EXISTS log_entries_at                   ON log_entries (at);
+
+CREATE TRIGGER IF NOT EXISTS log_entries_immutable
+BEFORE UPDATE ON log_entries
+BEGIN
+    SELECT RAISE(ABORT, 'log_entries are append-only; INSERT new rows instead of UPDATE');
+END;

package/migrations/007_visibility.sql

@@ -0,0 +1,10 @@
+-- INIT: visibility
+CREATE TABLE IF NOT EXISTS visibility (
+    run_id   INTEGER NOT NULL,
+    entry_id INTEGER NOT NULL,
+    channel  TEXT    NOT NULL           CHECK (length(channel) > 0),
+    indexed  INTEGER NOT NULL DEFAULT 1 CHECK (indexed IN (0, 1)),
+    PRIMARY KEY (run_id, entry_id, channel),
+    FOREIGN KEY (run_id)   REFERENCES runs(id)    ON DELETE CASCADE,
+    FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
+) STRICT, WITHOUT ROWID;

package/migrations/008_schemes_providers.sql

@@ -0,0 +1,25 @@
+-- INIT: schemes_providers
+CREATE TABLE IF NOT EXISTS schemes (
+    name                 TEXT    NOT NULL PRIMARY KEY CHECK (length(name) > 0),
+    model_visible        INTEGER NOT NULL             CHECK (model_visible IN (0, 1)),
+    category             TEXT    NOT NULL             CHECK (length(category) > 0),
+    default_scope        TEXT    NOT NULL             CHECK (default_scope IN ('agent', 'session')),
+    default_channel      TEXT    NOT NULL             CHECK (length(default_channel) > 0),
+    channel_orientations TEXT                         CHECK (channel_orientations IS NULL OR json_valid(channel_orientations)),
+    writable_by          TEXT    NOT NULL             CHECK (json_valid(writable_by)),
+    volatile             INTEGER NOT NULL             CHECK (volatile IN (0, 1)),
+    handler              TEXT
+) STRICT, WITHOUT ROWID;
+
+CREATE TABLE IF NOT EXISTS providers (
+    id          INTEGER NOT NULL PRIMARY KEY,
+    version     INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
+    provider    TEXT    NOT NULL           CHECK (length(provider) > 0),
+    family      TEXT    NOT NULL           CHECK (length(family) > 0),
+    model       TEXT    NOT NULL           CHECK (length(model) > 0),
+    contextSize INTEGER NOT NULL           CHECK (contextSize >= 1),
+    currency    TEXT    NOT NULL           CHECK (length(currency) = 3),
+    created_at  TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+) STRICT;
+
+CREATE INDEX IF NOT EXISTS providers_created_at ON providers (created_at);