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

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 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.
+
+- **Breaking:** `QuotaExceeded.cap` is now `compute`, `connections` or `spend`; `storage` is removed because Akter Cloud no longer supplies or bills managed databases. Only the connections cap remains retryable. HTTP 429 and WebSocket 1008 mappings are unchanged.
+- **Breaking cloud API:** every environment uses customer Postgres through `DATABASE_URL`. The optional `Environment.database` report has source `customer`, state `missing`, `reachable` or `unreachable`, nullable p50 `latency` in milliseconds, boolean `latencyWarning`, and nullable integer `runnerCap`. A deploy probes from the runner region: p50 above 5 ms warns without refusing, and runner cap is `floor((max_connections - in_use - 10) / 9)`.
+- **Breaking billing API:** base subscription plus compute unit-hours only. Removes every storage allowance, hard cap, price, meter, sample and per-project storage figure, plus storage and dedicated managed database plan features. The contract continues to ship at `@rikalabs/akter-cli/cloud-api`, not as a separate package.
+- `akter env list` no longer marks variables `managed`. `akter deploy` confirms a live rollout and prints its matching database probe's latency warning and non-null runner cap, preserving zero and unknown measurements. Failed or superseded diagnostic reads warn without changing the successful exit status.
+- Includes [#711](https://github.com/Rika-Labs/akter/pull/711): deploy following retries transient transport failures, typed `Unavailable` outages and unreadable 5xx responses with bounded exponential delays; refusals are never retried. Authentication declares `Unavailable`, so `whoami` reports a session-store outage without asking for another login.
+
 ## 0.1.0-alpha.3 (2026-10-08)
 
 The framework and CLI release together on the `alpha` and `latest` npm dist-tags; verified-main canaries use only `next`. This launch release includes the unpublished alpha.2 draft and subsequent changes. Alpha APIs and stored formats can change. Read the [upgrade notes](https://docs.akter.dev/operations/alpha-upgrades), back up the database, and stop every earlier alpha runner before starting alpha.3; mixed-alpha rolling upgrades are not established as safe.

package/dist/errors/actor.d.ts

@@ -107,7 +107,7 @@ export declare class RunnerAtCapacity extends RunnerAtCapacity_base {
 declare const QuotaExceeded_base: Schema.Class<QuotaExceeded, Schema.TaggedStruct<"QuotaExceeded", {
     readonly organizationId: Schema.String;
     readonly period: Schema.String;
-    readonly cap: Schema.Literals<readonly ["compute", "storage", "connections", "spend"]>;
+    readonly cap: Schema.Literals<readonly ["compute", "connections", "spend"]>;
     readonly limit: Schema.Finite;
     readonly used: Schema.Finite;
     readonly retryAfterMs: Schema.Finite;
@@ -116,8 +116,7 @@ declare const QuotaExceeded_base: Schema.Class<QuotaExceeded, Schema.TaggedStruc
  * The hosted organization reached one of its plan's hard caps. `cap` names it,
  * and `limit` and `used` are in that cap's units: cents for `spend`, open
  * connections for `connections`, compute unit-hours this period for
- * `compute`, and decimal gigabytes of pooled managed database storage for
- * `storage`. A `connections` refusal clears as connections close, so it is
+ * `compute`. A `connections` refusal clears as connections close, so it is
  * retryable with the same command id after `retryAfterMs`; the others hold
  * until usage drops, the period resets or the plan changes.
  */

package/dist/errors/actor.js

@@ -123,15 +123,14 @@ export class RunnerAtCapacity extends Schema.TaggedError()("RunnerAtCapacity", {
  * The hosted organization reached one of its plan's hard caps. `cap` names it,
  * and `limit` and `used` are in that cap's units: cents for `spend`, open
  * connections for `connections`, compute unit-hours this period for
- * `compute`, and decimal gigabytes of pooled managed database storage for
- * `storage`. A `connections` refusal clears as connections close, so it is
+ * `compute`. A `connections` refusal clears as connections close, so it is
  * retryable with the same command id after `retryAfterMs`; the others hold
  * until usage drops, the period resets or the plan changes.
  */
 export class QuotaExceeded extends Schema.TaggedError()("QuotaExceeded", {
     organizationId: Schema.String,
     period: Schema.String,
-    cap: Schema.Literals(["compute", "storage", "connections", "spend"]),
+    cap: Schema.Literals(["compute", "connections", "spend"]),
     limit: Schema.Finite,
     used: Schema.Finite,
     retryAfterMs: Schema.Finite,

package/dist/protocol/wire.d.ts

@@ -31,7 +31,7 @@ declare const reasonSchemas: {
         readonly _tag: Schema.tag<"QuotaExceeded">;
         readonly organizationId: Schema.String;
         readonly period: Schema.String;
-        readonly cap: Schema.Literals<readonly ["compute", "storage", "connections", "spend"]>;
+        readonly cap: Schema.Literals<readonly ["compute", "connections", "spend"]>;
         readonly limit: Schema.Finite;
         readonly used: Schema.Finite;
         readonly retryAfterMs: Schema.Finite;
@@ -83,7 +83,7 @@ export declare const envelope: (route: {
         readonly _tag: Schema.tag<"QuotaExceeded">;
         readonly organizationId: Schema.String;
         readonly period: Schema.String;
-        readonly cap: Schema.Literals<readonly ["compute", "storage", "connections", "spend"]>;
+        readonly cap: Schema.Literals<readonly ["compute", "connections", "spend"]>;
         readonly limit: Schema.Finite;
         readonly used: Schema.Finite;
         readonly retryAfterMs: Schema.Finite;

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.3","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"}}