@pouchy_ai/companion-sdk 0.18.0 → 0.18.1

package/CHANGELOG.md

@@ -12,6 +12,20 @@ a protocol bump is always called out explicitly here.
 
 ## [Unreleased]
 
+## [0.18.1] - 2026-07-08
+
+### Changed
+
+- `confirmAction()` return type widened: `status` may now be `'exec_failed'` and
+  the response carries an optional `retryable` flag. When an approved **idempotent**
+  action (a wallet payment) fails on a transient error, the server no longer burns
+  the confirmation — it returns `{ status: 'exec_failed', retryable: true }`, and
+  you MAY re-call `confirmAction(sameConfirmId, true)` to re-run it (the server
+  dedupes a partial first attempt on the confirmId). Non-idempotent actions (a
+  friend message, a skill POST) stay strictly single-use and are never retryable.
+  Additive + backwards-compatible: existing `'approved' | 'denied'` handling is
+  unaffected. No wire-protocol change.
+
 ## [0.18.0] - 2026-07-08
 
 ### Added

package/dist/client.d.ts

@@ -438,12 +438,19 @@ export declare class CompanionClient {
      *  approval the recorded action runs server-side; its result comes back as
      *  `outcome` in this response (render it where the user tapped) AND as a
      *  normal companion.message on the stream (so the conversation shows it).
-     *  A denial returns/emits a brief decline the same way. One-time:
-     *  re-resolving a settled confirmId fails with 409. */
+     *  A denial returns/emits a brief decline the same way. Single-use:
+     *  re-resolving a settled confirmId fails with 409.
+     *
+     *  RETRY: if an approved IDEMPOTENT action (a wallet payment) flakes on a
+     *  transient error, `status` is `'exec_failed'` and `retryable` is true — you
+     *  MAY call `confirmAction(sameConfirmId, true)` again to re-run it (the server
+     *  dedupes a partial first attempt). A non-idempotent action (a message / skill)
+     *  stays terminal and is never retryable. */
     confirmAction(confirmId: string, approve: boolean): Promise<{
         ok: boolean;
-        status: 'approved' | 'denied';
+        status: 'approved' | 'denied' | 'exec_failed';
         outcome?: string;
+        retryable?: boolean;
     }>;
     /** The session's still-pending confirmations (display-safe: id, summary,
      *  scope, timestamps — never raw args). Use it to rebuild your confirm card

package/dist/client.js

@@ -678,8 +678,14 @@ export class CompanionClient {
      *  approval the recorded action runs server-side; its result comes back as
      *  `outcome` in this response (render it where the user tapped) AND as a
      *  normal companion.message on the stream (so the conversation shows it).
-     *  A denial returns/emits a brief decline the same way. One-time:
-     *  re-resolving a settled confirmId fails with 409. */
+     *  A denial returns/emits a brief decline the same way. Single-use:
+     *  re-resolving a settled confirmId fails with 409.
+     *
+     *  RETRY: if an approved IDEMPOTENT action (a wallet payment) flakes on a
+     *  transient error, `status` is `'exec_failed'` and `retryable` is true — you
+     *  MAY call `confirmAction(sameConfirmId, true)` again to re-run it (the server
+     *  dedupes a partial first attempt). A non-idempotent action (a message / skill)
+     *  stays terminal and is never retryable. */
     async confirmAction(confirmId, approve) {
         const sessionId = this.requireSession();
         return this.postJson(`/api/companion/session/${encodeURIComponent(sessionId)}/confirm`, { confirmId, approve });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pouchy_ai/companion-sdk",
-  "version": "0.18.0",
+  "version": "0.18.1",
   "description": "Embed the Pouchy companion — chat, voice, tools, memory, live world-state, instant UI, and agent-to-agent messaging — in any app, game, or site.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",