@poppykit/server 0.5.0 → 0.5.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Local migration block2 adds Operations v2 codecs, negotiated API/MCP/conversation mechanics and durable revision ownership, execution claims, local atomic effects and host external reconciliation. See [OPERATIONS.md](OPERATIONS.md). This is a local SDK checkpoint, not full CLI integration or package publication.
 
+## 0.5.1 — 2026-11-01
+
+Handle PostgreSQL socket loss while an SDK transaction or migration owns a
+checked-out connection. Invalidate failed transaction handles, discard broken
+connections, and preserve the original migration error when rollback also fails.
+A failed COMMIT still requires durable-state reconciliation before retry.
+
 ## 0.5.0 — current-spec core migration
 
 Separate delegated resource Sessions from OAuth account grants; discover issuers and

package/STORAGE.md

@@ -235,3 +235,9 @@ shared handles. See [legacy retirement](migrations/RETIREMENT.md) before any del
 ## Business operation persistence
 
 [Operations storage contracts](OPERATIONS.md#store-contract-retention-and-migration) are separate from authentication lifecycle operations and message receipts. BusinessOperationStore uses an asynchronous transaction for same-database effects, unlike synchronous issuer/conversation callbacks. SQLite and PostgreSQL use the separate business_operations record kind. Use the same company database instance for policy, operation storage and local effects. No existing SQL history, credentials or uncertain work is deleted. Unknown versions fail closed. External effects require a durable downstream idempotency/reconciliation contract. Never prune or release an uncertain business claim after a worker deadline.
+
+Postgres adapters handle socket errors while they own a checked-out connection.
+Connection loss invalidates the transaction, rejects the operation and discards
+the broken connection. A successful retry must reconcile durable state first;
+a lost COMMIT response does not prove rollback. Callers still own their pool and
+its idle `error` handler, and host-enlisted connection lifetimes.

package/dist/postgres-runtime.js

@@ -35,6 +35,9 @@ export async function postgresMigration(schema) {
 export async function migratePostgres(pool, schema) {
     schemaName(schema);
     const client = await pool.connect();
+    let connectionError;
+    const onError = (error) => { connectionError = error; };
+    client.on('error', onError);
     try {
         await client.query('BEGIN');
         await client.query("SET LOCAL statement_timeout='5s'");
@@ -50,11 +53,12 @@ export async function migratePostgres(pool, schema) {
         await client.query('COMMIT');
     }
     catch (error) {
-        await client.query('ROLLBACK');
+        await client.query('ROLLBACK').catch((failure) => { connectionError = failure; });
         throw error;
     }
     finally {
-        client.release();
+        client.release(connectionError);
+        client.removeListener('error', onError);
     }
 }
 function scopeActive(context) {
@@ -117,6 +121,9 @@ export class PostgresRuntime {
             }
         }
         const client = await this.pool.connect(), context = { client, active: true, locks: new Set(), state: { serial: 0, active: true }, childActive: false };
+        let connectionError;
+        const onError = (error) => { connectionError = error; context.state.active = false; };
+        client.on('error', onError);
         try {
             await client.query('BEGIN');
             await client.query("SET LOCAL statement_timeout='5s'");
@@ -134,13 +141,14 @@ export class PostgresRuntime {
         }
         catch (error) {
             context.state.active = false;
-            await client.query('ROLLBACK').catch(() => { });
+            await client.query('ROLLBACK').catch((failure) => { connectionError = failure; });
             throw error;
         }
         finally {
             context.active = false;
             context.state.active = false;
-            client.release();
+            client.release(connectionError);
+            client.removeListener('error', onError);
         }
     }
     connection() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poppykit/server",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": false,
   "description": "Personal Agent Protocol company SDK",
   "repository": {