stitchkit 0.68.7 → 0.68.9

package/README.md

@@ -87,6 +87,7 @@ import { createServer, createHandler, implement } from 'stitchkit/server'
 import { createSocketIOServer, createAuthHook } from 'stitchkit/server'
 import { createMcpHandler, mountAgent } from 'stitchkit/tools'
 import { createAgentRuntime, defineAgentProtocol } from 'stitchkit/agent-runtime'
+import { createBunSqliteAgentRuntimeStore } from 'stitchkit/agent-runtime/sqlite/bun'
 import { createApplication, defineManagedResource } from 'stitchkit/application'
 import { implementRemote } from 'stitchkit/remote'
 ```
@@ -99,6 +100,9 @@ adapters are isolated further; importing `stitchkit/application` never resolves
 grammY or OpenTelemetry. Browser code that shares agent records imports
 `stitchkit/agent-runtime/browser`; it contains the canonical schemas and event
 cursor but no execution, persistence or sink graph.
+Durable embedded storage is isolated behind
+`stitchkit/agent-runtime/sqlite/bun` and `stitchkit/agent-runtime/sqlite/node`;
+neither runtime-specific built-in leaks into the neutral or browser entrypoint.
 
 ## Managed application kernel
 
@@ -423,6 +427,7 @@ peer — an install pulls in only what the project actually uses.
 | `@modelcontextprotocol/ext-apps` | peer, optional | Only MCP Apps (`ui://` resources and UI metadata). |
 | `ai` | peer, optional | `stitchkit/tools` agent tools and the optional server-only `stitchkit/agent-runtime`. |
 | `@openrouter/ai-sdk-provider` | peer, optional | Only `stitchkit/agent-runtime/openrouter`; neutral runtime imports do not resolve it. |
+| SQLite | runtime built-in, optional | `bun:sqlite` through `stitchkit/agent-runtime/sqlite/bun`, or `node:sqlite` on Node ≥ 22.5 through the Node leaf. |
 | `grammy` | peer, optional | Only `stitchkit/application/grammy`; the neutral application kernel does not resolve it. |
 | `@opentelemetry/api` | peer, optional | Type-only boundary for `stitchkit/application/opentelemetry`; the adapter has no runtime import and owns no SDK/exporter. |
 | `@tanstack/react-query` + `react-query-kit` | peer, optional | Only `stitchkit/react` — `createCursorQuery`, `createCacheBridge`. |

package/dist/agent-runtime/sqlite.d.ts

@@ -0,0 +1,32 @@
+import { createAgentRuntimeStore } from './store-driver.js';
+export type AgentRuntimeSqliteValue = string | number | bigint | null | Uint8Array;
+export interface AgentRuntimeSqliteStatement {
+    get(...parameters: AgentRuntimeSqliteValue[]): unknown;
+    all(...parameters: AgentRuntimeSqliteValue[]): readonly unknown[];
+    run(...parameters: AgentRuntimeSqliteValue[]): {
+        changes: number;
+    };
+}
+/** Minimal synchronous SQLite boundary implemented by the Bun and Node leaf entrypoints. */
+export interface AgentRuntimeSqliteDatabase {
+    exec(sql: string): void;
+    prepare(sql: string): AgentRuntimeSqliteStatement;
+    close(): void;
+}
+export interface SqliteAgentRuntimeStoreConfig {
+    database: AgentRuntimeSqliteDatabase;
+    /** Create or validate Stitchkit's namespaced schema. Default true. */
+    initialize?: boolean;
+}
+export interface SqliteAgentRuntimeStore {
+    store: ReturnType<typeof createAgentRuntimeStore<AgentRuntimeSqliteDatabase>>;
+    /** Refuse new work, wait for queued operations, then close the owned connection. */
+    close(): Promise<void>;
+}
+/**
+ * Create Stitchkit's schema without claiming an application's tables or SQLite user_version.
+ * An orphaned partial Stitchkit schema is refused rather than destructively repaired.
+ */
+export declare function initializeAgentRuntimeSqlite(database: AgentRuntimeSqliteDatabase): void;
+export declare function createSqliteAgentRuntimeStore(config: SqliteAgentRuntimeStoreConfig): SqliteAgentRuntimeStore;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/agent-runtime/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAQL,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,GAAG,UAAU,EAAE,uBAAuB,EAAE,GAAG,OAAO,CAAC;IACvD,GAAG,CAAC,GAAG,UAAU,EAAE,uBAAuB,EAAE,GAAG,SAAS,OAAO,EAAE,CAAC;IAClE,GAAG,CAAC,GAAG,UAAU,EAAE,uBAAuB,EAAE,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE;AAED,4FAA4F;AAC5F,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,2BAA2B,CAAC;IAClD,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,0BAA0B,CAAC;IACrC,sEAAsE;IACtE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,0BAA0B,CAAC,CAAC,CAAC;IAC9E,oFAAoF;IACpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAuED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAsFvF;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,6BAA6B,GACpC,uBAAuB,CAyUzB"}

package/dist/agent-runtime-sqlite-bun.d.ts

@@ -0,0 +1,11 @@
+import { type SqliteAgentRuntimeStore } from './agent-runtime/sqlite.js';
+export interface BunSqliteAgentRuntimeStoreConfig {
+    filename: string;
+    create?: boolean;
+    initialize?: boolean;
+}
+/** Bun `bun:sqlite` binding with non-blocking lock refusal on same-thread contention. */
+export declare function createBunSqliteAgentRuntimeStore(config: BunSqliteAgentRuntimeStoreConfig): SqliteAgentRuntimeStore;
+export type { AgentRuntimeSqliteDatabase, AgentRuntimeSqliteStatement, AgentRuntimeSqliteValue, SqliteAgentRuntimeStore, SqliteAgentRuntimeStoreConfig, } from './agent-runtime/sqlite.js';
+export { createSqliteAgentRuntimeStore, initializeAgentRuntimeSqlite, } from './agent-runtime/sqlite.js';
+//# sourceMappingURL=agent-runtime-sqlite-bun.d.ts.map

package/dist/agent-runtime-sqlite-bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime-sqlite-bun.d.ts","sourceRoot":"","sources":["../src/agent-runtime-sqlite-bun.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,yFAAyF;AACzF,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,gCAAgC,GACvC,uBAAuB,CAyBzB;AAED,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/agent-runtime-sqlite-bun.js

@@ -0,0 +1,40 @@
+import {
+  createSqliteAgentRuntimeStore,
+  initializeAgentRuntimeSqlite
+} from "./index-8vpzxg55.js";
+import"./index-hqza5nde.js";
+import"./index-ysphyxax.js";
+
+// src/agent-runtime-sqlite-bun.ts
+import { Database } from "bun:sqlite";
+function createBunSqliteAgentRuntimeStore(config) {
+  const database = new Database(config.filename, {
+    create: config.create ?? true,
+    readwrite: true
+  });
+  database.exec("PRAGMA busy_timeout = 0; PRAGMA foreign_keys = ON;");
+  const boundary = {
+    exec: (sql) => database.exec(sql),
+    prepare(sql) {
+      const statement = database.query(sql);
+      return {
+        get: (...parameters) => statement.get(...parameters),
+        all: (...parameters) => statement.all(...parameters),
+        run: (...parameters) => {
+          const result = statement.run(...parameters);
+          return { changes: result.changes };
+        }
+      };
+    },
+    close: () => database.close()
+  };
+  return createSqliteAgentRuntimeStore({
+    database: boundary,
+    initialize: config.initialize
+  });
+}
+export {
+  createBunSqliteAgentRuntimeStore,
+  createSqliteAgentRuntimeStore,
+  initializeAgentRuntimeSqlite
+};

package/dist/agent-runtime-sqlite-node.d.ts

@@ -0,0 +1,11 @@
+import { type SqliteAgentRuntimeStore } from './agent-runtime/sqlite.js';
+export interface NodeSqliteAgentRuntimeStoreConfig {
+    filename: string;
+    readOnly?: boolean;
+    initialize?: boolean;
+}
+/** Node built-in `node:sqlite` binding with non-blocking lock refusal on contention. */
+export declare function createNodeSqliteAgentRuntimeStore(config: NodeSqliteAgentRuntimeStoreConfig): SqliteAgentRuntimeStore;
+export type { AgentRuntimeSqliteDatabase, AgentRuntimeSqliteStatement, AgentRuntimeSqliteValue, SqliteAgentRuntimeStore, SqliteAgentRuntimeStoreConfig, } from './agent-runtime/sqlite.js';
+export { createSqliteAgentRuntimeStore, initializeAgentRuntimeSqlite, } from './agent-runtime/sqlite.js';
+//# sourceMappingURL=agent-runtime-sqlite-node.d.ts.map

package/dist/agent-runtime-sqlite-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runtime-sqlite-node.d.ts","sourceRoot":"","sources":["../src/agent-runtime-sqlite-node.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wFAAwF;AACxF,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,iCAAiC,GACxC,uBAAuB,CA2BzB;AAED,YAAY,EACV,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,uBAAuB,EACvB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/agent-runtime-sqlite-node.js

@@ -0,0 +1,42 @@
+import {
+  createSqliteAgentRuntimeStore,
+  initializeAgentRuntimeSqlite
+} from "./index-8vpzxg55.js";
+import"./index-hqza5nde.js";
+import"./index-ysphyxax.js";
+
+// src/agent-runtime-sqlite-node.ts
+import { DatabaseSync } from "node:sqlite";
+function createNodeSqliteAgentRuntimeStore(config) {
+  if (config.readOnly && config.initialize !== false) {
+    throw new TypeError("A read-only SQLite agent-runtime store requires initialize: false");
+  }
+  const database = new DatabaseSync(config.filename, {
+    readOnly: config.readOnly ?? false
+  });
+  database.exec("PRAGMA busy_timeout = 0; PRAGMA foreign_keys = ON;");
+  const boundary = {
+    exec: (sql) => database.exec(sql),
+    prepare(sql) {
+      const statement = database.prepare(sql);
+      return {
+        get: (...parameters) => statement.get(...parameters),
+        all: (...parameters) => statement.all(...parameters),
+        run: (...parameters) => {
+          const result = statement.run(...parameters);
+          return { changes: Number(result.changes) };
+        }
+      };
+    },
+    close: () => database.close()
+  };
+  return createSqliteAgentRuntimeStore({
+    database: boundary,
+    initialize: config.initialize
+  });
+}
+export {
+  createNodeSqliteAgentRuntimeStore,
+  createSqliteAgentRuntimeStore,
+  initializeAgentRuntimeSqlite
+};