@dfm-fi/agent 0.2.707 → 0.2.730

package/dist/zap-v2-flow.pending.test.js

@@ -0,0 +1,119 @@
+/**
+ * #61 regression (runnable: `npx tsx agent/src/zap-v2-flow.pending.test.ts`).
+ *
+ * The agent package has no jest runner — this is a self-contained assertion
+ * script (exit 1 on failure) covering the #61 contract: when the poll window
+ * elapses with the escrow STILL OPEN (or it auto-settled / disappeared), the
+ * redeem flow must return `settlement:"pending"` (ok:true) WITHOUT calling the
+ * close builder — NOT throw a hard error. On the OLD code `pollUntilReady` threw,
+ * so `runRedeem` rejected and `prepareZapOutCloseV2` was never reached either;
+ * here we assert the NEW resume-able contract: a resolved pending result + no
+ * close attempt.
+ */
+import { runRedeem } from './zap-v2-flow.js';
+const VAULT = 'Vau1t1111111111111111111111111111111111111';
+const USER = 'User1111111111111111111111111111111111111111';
+const ESCROW = 'Escrow11111111111111111111111111111111111111';
+function openRedeemStatus() {
+    return {
+        escrowPda: ESCROW,
+        vault: VAULT,
+        user: USER,
+        mode: 1, // redeem
+        state: 4, // PARTIAL_OUT
+        nAssets: 10,
+        assetMints: [],
+        filledMask: 0x1ff, // 9/10
+        legProgress: [],
+        legsFilled: 9,
+        legsTotal: 10,
+        readyToClose: false, // never ready within the window
+        legFailures: [],
+        openedAt: 0,
+        expiresAt: 9_999_999_999,
+        isExpired: false,
+        slippageBps: 300,
+        plannedAmountIn: [],
+        minOuts: [],
+        actualOuts: [],
+        inputAmount: '0',
+        sharesIn: '1000000',
+        minSharesOut: '0',
+        minUsdcOut: '0',
+    };
+}
+let failures = 0;
+function assert(cond, msg) {
+    if (!cond) {
+        console.error(`  ✗ ${msg}`);
+        failures++;
+    }
+    else {
+        console.log(`  ✓ ${msg}`);
+    }
+}
+async function caseTimeout() {
+    console.log('case: poll TIMEOUT with escrow still open → pending (no close)');
+    let closeCalled = 0;
+    const mockApi = {
+        getZapV2Status: async () => openRedeemStatus(),
+        prepareZapOutCloseV2: async () => {
+            closeCalled++;
+            return { transactions: [], blockhash: '', lastValidBlockHeight: 0, escrowPda: ESCROW };
+        },
+    };
+    const res = await runRedeem({}, // config — unused on the pending path
+    mockApi, USER, VAULT, '1000000', { poll: { timeoutSecs: 0.3, intervalSecs: 0.1 } });
+    assert(res.ok === true, 'result.ok === true (not an error)');
+    assert(res.settlement === 'pending', `settlement === 'pending' (got '${res.settlement}')`);
+    assert(res.closeSignatures.length === 0, 'no close signatures');
+    assert(closeCalled === 0, 'prepareZapOutCloseV2 was NOT called');
+    assert(res.pending?.reason === 'timeout', `pending.reason === 'timeout' (got '${res.pending?.reason}')`);
+    assert(res.pending?.legsFilled === 9 && res.pending?.legsTotal === 10, 'pending carries 9/10 legs');
+}
+async function caseGone() {
+    console.log('case: escrow GONE during poll (auto-settled) → pending/gone (no throw)');
+    let calls = 0;
+    const mockApi = {
+        // resume guard (call 0) + first poll (call 1) see the escrow OPEN, then it
+        // disappears (call 2+) = a genuine mid-poll settle. The guard requires having
+        // seen it open before concluding 'gone' (so a not-yet-propagated fresh escrow
+        // isn't mis-reported) — realistic settle must show it open first.
+        getZapV2Status: async () => (calls++ < 2 ? openRedeemStatus() : null),
+        prepareZapOutCloseV2: async () => {
+            throw new Error('close must not be called on gone');
+        },
+    };
+    const res = await runRedeem({}, mockApi, USER, VAULT, '1000000', { poll: { timeoutSecs: 5, intervalSecs: 0.1 } });
+    assert(res.ok === true, 'result.ok === true');
+    assert(res.settlement === 'pending', `settlement === 'pending' (got '${res.settlement}')`);
+    assert(res.pending?.reason === 'gone', `pending.reason === 'gone' (got '${res.pending?.reason}')`);
+}
+async function caseFreshNullNotGone() {
+    console.log('case: null reads WITHOUT ever seeing the escrow open → timeout, NOT gone (race ⑥ guard)');
+    let calls = 0;
+    const mockApi = {
+        // resume guard (call 0) sees it open; every poll read after is null BEFORE the
+        // poll loop ever observes it open itself (propagation blip / not-yet-visible).
+        // The fix must NOT declare 'gone' here — it keeps waiting → 'timeout'. The OLD
+        // code returned 'gone' on the first null, mis-reporting a live escrow as settled.
+        getZapV2Status: async () => (calls++ === 0 ? openRedeemStatus() : null),
+        prepareZapOutCloseV2: async () => {
+            throw new Error('close must not be called');
+        },
+    };
+    const res = await runRedeem({}, mockApi, USER, VAULT, '1000000', { poll: { timeoutSecs: 0.3, intervalSecs: 0.1 } });
+    assert(res.settlement === 'pending', `settlement === 'pending' (got '${res.settlement}')`);
+    assert(res.pending?.reason === 'timeout', `reason === 'timeout' not 'gone' (got '${res.pending?.reason}')`);
+}
+(async () => {
+    await caseTimeout();
+    await caseGone();
+    await caseFreshNullNotGone();
+    if (failures > 0) {
+        console.error(`\n#61 regression FAILED (${failures} assertion(s))`);
+        process.exit(1);
+    }
+    console.log('\n#61 regression PASSED');
+})();
+//# sourceMappingURL=zap-v2-flow.pending.test.js.map

package/dist/zap-v2-flow.pending.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zap-v2-flow.pending.test.js","sourceRoot":"","sources":["../src/zap-v2-flow.pending.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dfm-fi/agent",
-  "version": "0.2.707",
+  "version": "0.2.730",
   "description": "DFM v2 MCP server — drive the full DTF launch → deposit → redeem (+ manage) lifecycle from an AI agent against the live API.",
   "type": "module",
   "bin": {