@poppykit/client 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Local migration block2 adds Operations v2 codecs, negotiated API/MCP/conversation mechanics and durable trusted-consent attempt storage/recovery. See [OPERATIONS.md](OPERATIONS.md). This is a local SDK checkpoint, not full CLI integration or package publication.
 
+## 0.6.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.6.0 — current-spec core migration
 
 Separate delegated resource Sessions from OAuth account grants; discover issuers and

package/STORAGE.md

@@ -190,3 +190,9 @@ span model/network I/O. See the [provider example](PROVIDER.md).
 ## Business operation persistence
 
 [Operations storage contracts](OPERATIONS.md#persistence-and-migration) are separate from authentication lifecycle operations and message receipts. BusinessAttemptStore uses a synchronous transaction callback and an ascending nonterminal `pending` selector. SQLite adds a separate business_attempts table; PostgreSQL uses a separate record kind. 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) {
@@ -144,6 +148,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'");
@@ -161,13 +168,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/client",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "private": false,
   "description": "Personal Agent Protocol client SDK",
   "repository": {