trellis 3.1.6 → 3.1.7

package/dist/server/server.d.ts

@@ -28,6 +28,8 @@
 import type { TrellisDbConfig } from '../client/config.js';
 import type { TenantPool } from './tenancy.js';
 import type { PermissionRegistry } from './permissions.js';
+import type { TrellisHttpServer } from './server-shared.js';
+export type { TrellisHttpServer } from './server-shared.js';
 export interface ServerConfig {
     port?: number;
     config: TrellisDbConfig;
@@ -36,8 +38,23 @@ export interface ServerConfig {
     oauthProviders?: Record<string, import('./auth.js').OAuthProvider>;
 }
 /**
- * Start the Trellis DB HTTP + WebSocket server.
- * Returns the Bun server instance.
+ * Start the Trellis DB HTTP + WebSocket server under Bun.
+ *
+ * For runtime-portable code that may also run under Node or WebContainer,
+ * use `startServerCrossRuntime` instead — it dispatches to either Bun.serve
+ * or a Node http+ws adapter based on the host runtime.
  */
 export declare function startServer(opts: ServerConfig): ReturnType<typeof Bun.serve>;
+/**
+ * Runtime-dispatched server boot. Use this when your code might run outside
+ * Bun (Node, WebContainer, browser).
+ *
+ *   - Under Bun, this calls `Bun.serve` and returns the Bun server wrapped
+ *     in a `TrellisHttpServer` interface.
+ *   - Under Node, uses `node:http` + the `ws` library (optional dependency).
+ *
+ * Returns a `Promise<TrellisHttpServer>` — the minimal cross-runtime surface
+ * with `.port` / `.stop()`.
+ */
+export declare function startServerCrossRuntime(opts: ServerConfig): Promise<TrellisHttpServer>;
 //# sourceMappingURL=server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAQ3D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,aAAa,CAAC,CAAC;CACpE;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAqF5E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAWH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAU/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,eAAe,CAAC;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,WAAW,EAAE,aAAa,CAAC,CAAC;CACpE;AAMD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAE5E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAU5B"}

package/dist/server/tenancy.d.ts

@@ -9,6 +9,7 @@
  * @module trellis/server
  */
 import { TrellisKernel } from '../core/kernel/trellis-kernel.js';
+import type { CreateKernelBackendOptions } from '../core/persist/factory.js';
 export declare const DEFAULT_TENANT = "default";
 /**
  * A pool of `TrellisKernel` instances keyed by tenant ID.
@@ -17,16 +18,39 @@ export declare const DEFAULT_TENANT = "default";
  * - Each tenant's data lives in `<dbPath>/tenants/<tenantId>.sqlite`.
  * - The default tenant lives at `<dbPath>/default.sqlite`.
  */
+export interface TenantPoolOptions {
+    agentId?: string;
+    /**
+     * Backend selection forwarded to `createKernelBackend`. Only consulted by
+     * `preload()` — `get()` always uses the synchronous bun:sqlite backend
+     * for back-compat.
+     */
+    backend?: CreateKernelBackendOptions;
+}
 export declare class TenantPool {
     private pool;
     private dbPath;
     private agentId;
-    constructor(dbPath: string, agentId?: string);
+    private backendOpts;
+    constructor(dbPath: string, agentIdOrOpts?: string | TenantPoolOptions);
     /**
      * Get (or create) the kernel for a tenant.
      * Pass `null` or `undefined` to get the default tenant.
+     *
+     * Uses the synchronous bun:sqlite backend. To use an async backend
+     * (better-sqlite3, sql.js) call `preload(tenantId)` first; subsequent
+     * `get()` calls will return the preloaded kernel from the pool.
      */
     get(tenantId?: string | null): TrellisKernel;
+    /**
+     * Pre-create a tenant's kernel using the runtime-selected backend.
+     * Required when running with an async-only backend (sql.js / WebContainer
+     * / browser). Idempotent — safe to call multiple times.
+     *
+     * After `preload()`, subsequent `get(tenantId)` returns the same kernel
+     * synchronously from the pool.
+     */
+    preload(tenantId?: string | null): Promise<TrellisKernel>;
     /**
      * Check whether a tenant has been initialized (kernel created).
      */
@@ -47,7 +71,9 @@ export declare class TenantPool {
      * Return the SQLite file path for a given tenant.
      */
     dbFilePath(tenantId?: string | null): string;
-    private _createKernel;
+    private _createKernelSync;
+    private _createKernelAsync;
+    private _wrapKernel;
     private _ensureDirs;
 }
 //# sourceMappingURL=tenancy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../../src/server/tenancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAOjE,eAAO,MAAM,cAAc,YAAY,CAAC;AAOxC;;;;;;GAMG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,SAAe;IAUlD;;;OAGG;IACH,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa;IAQ5C;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAY5C,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,WAAW;CASpB"}
+{"version":3,"file":"tenancy.d.ts","sourceRoot":"","sources":["../../src/server/tenancy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAM7E,eAAO,MAAM,cAAc,YAAY,CAAC;AAOxC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,0BAA0B,CAAC;CACtC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAyC;gBAG1D,MAAM,EAAE,MAAM,EACd,aAAa,GAAE,MAAM,GAAG,iBAAgC;IAiB1D;;;;;;;OAOG;IACH,GAAG,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa;IAQ5C;;;;;;;OAOG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC;IAS/D;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ7B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAOhB;;OAEG;IACH,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAY5C,OAAO,CAAC,iBAAiB;YAMX,kBAAkB;IAShC,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,WAAW;CASpB"}

package/dist/{server-mrctdwzr.js → server-szdjx0nt.js}

@@ -1,11 +1,13 @@
 // @bun
 import {
-  startServer
-} from "./index-6n5dcebj.js";
+  startServer,
+  startServerCrossRuntime
+} from "./index-53f3b8p8.js";
 import"./index-n9f2qyh5.js";
-import"./index-yhwjgfvj.js";
 import"./index-yp88he8n.js";
+import"./index-yhwjgfvj.js";
 import"./index-a76rekgs.js";
 export {
+  startServerCrossRuntime,
   startServer
 };

package/dist/sqlite-backend-0vsmc6qj.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  SqliteKernelBackend
+} from "./index-h7zxhhhh.js";
+import"./index-a76rekgs.js";
+export {
+  SqliteKernelBackend
+};

package/dist/{tenancy-7d1g4ayp.js → tenancy-pjm32b4v.js}

@@ -2,10 +2,11 @@
 import {
   DEFAULT_TENANT,
   TenantPool
-} from "./index-y3d71wzd.js";
-import"./index-0zk3fx2s.js";
-import"./index-yhwjgfvj.js";
+} from "./index-7pjz3tsy.js";
+import"./index-4wxa8xz4.js";
 import"./index-yp88he8n.js";
+import"./index-yhwjgfvj.js";
+import"./index-h7zxhhhh.js";
 import"./index-a76rekgs.js";
 export {
   TenantPool,

package/dist/vcs/blob-store.d.ts

@@ -33,7 +33,8 @@ export declare class BlobStore {
      */
     hash(content: Buffer | Uint8Array): Promise<string>;
     /**
-     * Compute SHA-256 hash of content (sync, using Bun's CryptoHasher).
+     * Compute SHA-256 hash of content (sync).
+     * Uses Bun.CryptoHasher when running under Bun, else node:crypto.
      */
     hashSync(content: Buffer | Uint8Array): string;
     /**

package/dist/vcs/blob-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blob-store.d.ts","sourceRoot":"","sources":["../../src/vcs/blob-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,MAAM;IAO9B;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IASxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM;IAS7C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM;IAM9C;;OAEG;IACH,KAAK,IAAI,MAAM;IASf;;OAEG;IACH,SAAS,IAAI,MAAM;IAgBnB,OAAO,CAAC,aAAa;CAKtB"}
+{"version":3,"file":"blob-store.d.ts","sourceRoot":"","sources":["../../src/vcs/blob-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAS;gBAEZ,UAAU,EAAE,MAAM;IAO9B;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IASxD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM;IAS7C;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAQhC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM;IAW9C;;OAEG;IACH,KAAK,IAAI,MAAM;IASf;;OAEG;IACH,SAAS,IAAI,MAAM;IAgBnB,OAAO,CAAC,aAAa;CAKtB"}

package/dist/vcs/index.js

@@ -1,7 +1,7 @@
 // @bun
 import {
   VcsMiddleware
-} from "../index-hmdbnd4n.js";
+} from "../index-hy73j9z8.js";
 import {
   BlobStore,
   addCriterion,
@@ -40,7 +40,7 @@ import {
   triageIssue,
   unblockIssue,
   updateIssue
-} from "../index-0q7wbasy.js";
+} from "../index-a2a394zz.js";
 import {
   DEFAULT_CONFIG,
   branchEntityId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trellis",
-  "version": "3.1.6",
+  "version": "3.1.7",
   "description": "Agentic State Engine — event-sourced causal graph with branching, decision traces, and realtime sync for AI-native applications",
   "type": "module",
   "main": "./dist/index.js",
@@ -91,6 +91,14 @@
     "./persist/better-sqlite": {
       "types": "./dist/persist/better-sqlite-backend.d.ts",
       "import": "./dist/persist/better-sqlite-backend.js"
+    },
+    "./persist/sqljs": {
+      "types": "./dist/persist/sqljs-backend.d.ts",
+      "import": "./dist/persist/sqljs-backend.js"
+    },
+    "./persist/factory": {
+      "types": "./dist/persist/factory.d.ts",
+      "import": "./dist/persist/factory.js"
     }
   },
   "files": [
@@ -107,7 +115,7 @@
     "cli": "bun run src/cli/index.ts",
     "mcp": "bun run src/mcp/index.ts",
     "mcp:docs": "bun run src/mcp/docs.ts",
-    "build": "bun build src/index.ts src/core/index.ts src/vcs/index.ts src/embeddings/index.ts src/links/index.ts src/decisions/index.ts src/server/index.ts src/client/index.ts src/react/index.ts src/db/index.ts src/cli/index.ts src/cms/index.ts --outdir dist --target bun --splitting --format esm --root src --external @xenova/transformers --external @huggingface/transformers --external react && mkdir -p dist/ui && cp src/ui/client.html dist/ui/client.html && tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false --noEmitOnError false && bun run build:inspector",
+    "build": "bun build src/index.ts src/core/index.ts src/vcs/index.ts src/embeddings/index.ts src/links/index.ts src/decisions/index.ts src/server/index.ts src/client/index.ts src/react/index.ts src/db/index.ts src/cli/index.ts src/cms/index.ts src/core/persist/sqljs-backend.ts src/core/persist/factory.ts src/server/node-adapter.ts --outdir dist --target bun --splitting --format esm --root src --external @xenova/transformers --external @huggingface/transformers --external react --external sql.js --external ws && mkdir -p dist/ui && cp src/ui/client.html dist/ui/client.html && tsc -p tsconfig.build.json --emitDeclarationOnly --noEmit false --noEmitOnError false && bun run build:inspector",
     "build:inspector": "vite build --config vite.inspector.config.ts",
     "test": "bun test test/core test/cms test/vcs test/git test/p2 test/p3 test/p4 test/p5 test/p6 test/p7 test/engine.test.ts",
     "test:all": "bun test",
@@ -119,11 +127,14 @@
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
     "opencode-ai": "^1.3.5",
+    "turtlecode": "^0.3.22",
     "zod": "3"
   },
   "optionalDependencies": {
     "@huggingface/transformers": "^3.0.0",
-    "@xenova/transformers": "^2.17.2"
+    "@xenova/transformers": "^2.17.2",
+    "sql.js": "^1.14.1",
+    "ws": "^8.20.1"
   },
   "peerDependencies": {
     "better-sqlite3": "^11.0.0",
@@ -140,6 +151,8 @@
   "devDependencies": {
     "@types/bun": "latest",
     "@types/react": "^19.1.2",
+    "@types/sql.js": "^1.4.11",
+    "@types/ws": "^8.18.1",
     "@vitejs/plugin-vue": "^5.2.3",
     "react": "^19.1.0",
     "typescript": "^5",