@rikalabs/akter 0.1.0-alpha.4 → 0.1.0-alpha.5

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.1.0-alpha.5 (2026-10-09)
+
+The framework and CLI release together on the `alpha` and `latest` npm dist-tags. Stored formats and the default Postgres pool sizes are unchanged from alpha.4.
+
+- Adds the supported opt-in `Database.postgres({ url, preset: "low-connection" })` preset: one turn, two off-turn and one query session, for four primary Postgres sessions per runner without read replicas. Explicit pool options override the preset. This uses direct Postgres connections; it does not establish transaction-pooler support.
+- Real-Postgres evidence covers a held single turn session, progressing off-turn work, migration serialization, command deduplication and process recovery. See the [low-connection verification](https://docs.akter.dev/verification/low-connection-postgres) and [deployment guidance](https://docs.akter.dev/guides/deploy).
+- Includes the compute-only Akter Cloud guides and deterministic offline/content conformance timing fixes; the CLI and bundled cloud API contract are unchanged from alpha.4.
+
 ## 0.1.0-alpha.4 (2026-10-09)
 
 The framework and CLI release together on the `alpha` and `latest` npm dist-tags. The framework runtime and stored formats are unchanged from alpha.3; the hosted quota and cloud API contracts change during alpha.

package/dist/runtime/layer.d.ts

@@ -223,6 +223,8 @@ export interface Options {
  */
 export declare const layer: (options?: Options) => Layer.Layer<Actors | ContentStore | DefectLog | InternalActors | OperatorRuntime | RuntimeControl | TelemetrySampler, import("effect/sql/Migrator").MigrationError | SqlError.SqlError, Crypto.Crypto | SqlClient.SqlClient>;
 type PostgresOptions = Omit<PgClient.PgPoolConfig, "types"> & {
+    /** Four primary sessions: one turn, two off-turn (one reserved by Cluster), and one query. Explicit pool sizes take precedence. */
+    readonly preset?: "low-connection";
     readonly offTurnConnections?: number;
     readonly queryConnections?: number;
     readonly replica?: Omit<PgClient.PgPoolConfig, "types"> | undefined;
@@ -245,6 +247,13 @@ type PostgresOptions = Omit<PgClient.PgPoolConfig, "types"> & {
  * first come, first served. Keep the sum across runners below the server's
  * `max_connections`.
  *
+ * `preset: "low-connection"` defaults these pools to 1/2/1 instead of
+ * 50/10/10. Cluster reserves one off-turn session for its entire lifetime,
+ * including with table leases, so the other must remain available for
+ * startup and ordinary work. Fleet maintenance and application reservations
+ * need additional off-turn capacity; optional pools add to the budget.
+ * Explicit pool sizes override the preset.
+ *
  * `replica` is this runner's nearest streaming replica of the same primary.
  * Queries read there once it has replayed the commit version their caller
  * last saw, and read the primary when it is behind or fails. Its pool

package/dist/runtime/layer.js

@@ -913,6 +913,13 @@ export const layer = (options = {}) => {
  * first come, first served. Keep the sum across runners below the server's
  * `max_connections`.
  *
+ * `preset: "low-connection"` defaults these pools to 1/2/1 instead of
+ * 50/10/10. Cluster reserves one off-turn session for its entire lifetime,
+ * including with table leases, so the other must remain available for
+ * startup and ordinary work. Fleet maintenance and application reservations
+ * need additional off-turn capacity; optional pools add to the budget.
+ * Explicit pool sizes override the preset.
+ *
  * `replica` is this runner's nearest streaming replica of the same primary.
  * Queries read there once it has replayed the commit version their caller
  * last saw, and read the primary when it is behind or fails. Its pool
@@ -932,9 +939,22 @@ function postgres(options) {
             ? Result.succeed(new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength).getUint32(0))
             : Result.fail(new PgTypes.CodecError({ message: "Invalid regclass value" })),
     });
-    const { offTurnConnections, queryConnections, replica, coordination, ...configured } = options;
+    const { preset, offTurnConnections, queryConnections, replica, coordination, ...configured } = options;
     const pool = withKeepalives(configured);
-    return Layer.mergeAll(boundedLayer({ ...pool, maxConnections: offTurnConnections ?? 10, types }), turnGroups.pipe(Layer.provideMerge(turnConnections({ ...pool, maxConnections: pool.maxConnections ?? 50, types }))), queryPoolLayer({ ...pool, maxConnections: queryConnections ?? 10, types }), replicaLayer(replica === undefined ? undefined : { ...withKeepalives(replica), types }), coordinationLayer(coordination === undefined ? undefined : { ...withKeepalives(coordination), types }));
+    const lowConnection = preset === "low-connection";
+    return Layer.mergeAll(boundedLayer({
+        ...pool,
+        maxConnections: offTurnConnections ?? (lowConnection ? 2 : 10),
+        types,
+    }), turnGroups.pipe(Layer.provideMerge(turnConnections({
+        ...pool,
+        maxConnections: pool.maxConnections ?? (lowConnection ? 1 : 50),
+        types,
+    }))), queryPoolLayer({
+        ...pool,
+        maxConnections: queryConnections ?? (lowConnection ? 1 : 10),
+        types,
+    }), replicaLayer(replica === undefined ? undefined : { ...withKeepalives(replica), types }), coordinationLayer(coordination === undefined ? undefined : { ...withKeepalives(coordination), types }));
 }
 /** Database layers for `Actors.layer`: `postgres` for real deployments, `pglite` for embedded and test use. */
 export const Database = {

package/package.json

@@ -1 +1 @@
-{"name":"@rikalabs/akter","version":"0.1.0-alpha.4","files":["dist","CHANGELOG.md","README.md","LICENSE","NOTICE"],"dependencies":{"@effect/platform-node-shared":"4.0.2","@electric-sql/pglite":"0.5.8","@noble/hashes":"2.4.0","@node-rs/xxhash":"1.7.8","koffi":"3.3.2"},"peerDependencies":{"@effect/platform-bun":"^4.0.2","@effect/platform-node":"^4.0.2","@effect/sql-pg":"^4.0.2","@effect/sql-pglite":"^4.0.2","drizzle-orm":"^1.0.0-rc.5-5935859","effect":"^4.0.2"},"publishConfig":{"access":"public"},"description":"The framework for durable, stateful backends that power realtime apps, background work, and agents.","keywords":["actor-model","actors","agents","background-jobs","bun","durable","effect","effect-ts","pglite","postgres","realtime","stateful","transactions","workflows"],"homepage":"https://github.com/Rika-Labs/akter#readme","bugs":"https://github.com/Rika-Labs/akter/issues","license":"Apache-2.0","author":"Rika Labs","repository":{"type":"git","url":"git+https://github.com/Rika-Labs/akter.git","directory":"packages/akter"},"type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./runtime":{"types":"./dist/runtime/index.d.ts","default":"./dist/runtime/index.js"},"./client":{"types":"./dist/client/index.d.ts","default":"./dist/client/index.js"},"./testing":{"types":"./dist/testing/index.d.ts","default":"./dist/testing/index.js"},"./package.json":"./package.json"},"peerDependenciesMeta":{"@effect/platform-bun":{"optional":true},"@effect/platform-node":{"optional":true}},"engines":{"bun":">=1.4.2","node":">=24.0.0"}}
+{"name":"@rikalabs/akter","version":"0.1.0-alpha.5","files":["dist","CHANGELOG.md","README.md","LICENSE","NOTICE"],"dependencies":{"@effect/platform-node-shared":"4.0.2","@electric-sql/pglite":"0.5.8","@noble/hashes":"2.4.0","@node-rs/xxhash":"1.7.8","koffi":"3.3.2"},"peerDependencies":{"@effect/platform-bun":"^4.0.2","@effect/platform-node":"^4.0.2","@effect/sql-pg":"^4.0.2","@effect/sql-pglite":"^4.0.2","drizzle-orm":"^1.0.0-rc.5-5935859","effect":"^4.0.2"},"publishConfig":{"access":"public"},"description":"The framework for durable, stateful backends that power realtime apps, background work, and agents.","keywords":["actor-model","actors","agents","background-jobs","bun","durable","effect","effect-ts","pglite","postgres","realtime","stateful","transactions","workflows"],"homepage":"https://github.com/Rika-Labs/akter#readme","bugs":"https://github.com/Rika-Labs/akter/issues","license":"Apache-2.0","author":"Rika Labs","repository":{"type":"git","url":"git+https://github.com/Rika-Labs/akter.git","directory":"packages/akter"},"type":"module","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"},"./runtime":{"types":"./dist/runtime/index.d.ts","default":"./dist/runtime/index.js"},"./client":{"types":"./dist/client/index.d.ts","default":"./dist/client/index.js"},"./testing":{"types":"./dist/testing/index.d.ts","default":"./dist/testing/index.js"},"./package.json":"./package.json"},"peerDependenciesMeta":{"@effect/platform-bun":{"optional":true},"@effect/platform-node":{"optional":true}},"engines":{"bun":">=1.4.2","node":">=24.0.0"}}