dexterm-cli 0.1.6 → 0.2.0

package/dist/packages/autotrade/assets/strategies/scalp.json

@@ -0,0 +1,98 @@
+{
+  "kind": "strategy",
+  "schema": "dexterm-strategy/1",
+  "id": "scalp",
+  "name": "Scalp (quick play)",
+  "version": "1.0.0",
+  "description": "Fresh momentum on a young coin: a 5-minute push with buyers in control, small size, fast partial profits, a tight trail, a 20-minute clock and a -25% hard stop.",
+  "mode": "paper",
+  "bankroll": {
+    "startUsd": 1000
+  },
+  "entry": {
+    "screen": "liq >= 30K vol5m >= 5K !flag:mint !flag:freeze",
+    "ageHours": {
+      "min": 0,
+      "max": 6
+    },
+    "safety": {
+      "maxTop10Pct": 35,
+      "maxDevPct": 5,
+      "requireNoMintAuthority": true,
+      "requireNoFreezeAuthority": true,
+      "maxMcapSplitX": 5,
+      "youngVertical": {
+        "maxAgeHours": 1,
+        "maxH1Pct": 250
+      },
+      "unknownHolders": "reject"
+    },
+    "triggers": [
+      {
+        "kind": "momentum",
+        "m5MinPct": 3,
+        "buySellMin": 1.2
+      }
+    ],
+    "triggerMode": "any",
+    "decide": "agent",
+    "candidateTtlSec": 300
+  },
+  "exits": {
+    "default": "scalp",
+    "profiles": [
+      "builtin:scalp",
+      "builtin:swing"
+    ]
+  },
+  "sizing": {
+    "mode": "pct",
+    "pct": 5,
+    "maxPctOfBankroll": 10,
+    "maxUsd": 500,
+    "minUsd": 5
+  },
+  "risk": {
+    "perTrade": {
+      "maxLossPctOfBankroll": 10,
+      "assumedLossPctNoStop": 100
+    },
+    "dailyLossHaltPct": 10,
+    "drawdown": {
+      "sizeDownAtPct": 15,
+      "sizeDownMult": 0.5,
+      "recoverBelowPct": 8,
+      "haltAtPct": 25
+    },
+    "maxConcurrent": 2,
+    "maxExposurePct": 25,
+    "lossStreak": {
+      "losses": 3,
+      "cooldownMin": 60
+    },
+    "maxEntriesPerDay": 12,
+    "perCoin": {
+      "maxEntries": 2,
+      "cooldownMin": 10
+    }
+  },
+  "agent": {
+    "model": "sonnet",
+    "maxSessions": 2,
+    "budgetUsdPerSession": 0.5,
+    "budgetUsdPerDay": 10,
+    "maxTurns": 60,
+    "deltaEverySec": 15,
+    "decideWithinSec": 90,
+    "sessionMaxMin": 240,
+    "onTimeout": "skip"
+  },
+  "execution": {
+    "slippageBps": 100,
+    "feeBps": 30,
+    "networkFeeUsd": 0.02,
+    "latencyMs": 3000,
+    "maxPriceImpactPct": 8,
+    "minExitLiquidityUsd": 2000
+  }
+}

package/dist/packages/autotrade/assets/strategies/swing.json

@@ -0,0 +1,97 @@
+{
+  "kind": "strategy",
+  "schema": "dexterm-strategy/1",
+  "id": "swing",
+  "name": "Swing (intraday trend)",
+  "version": "1.0.0",
+  "description": "An intraday trend on a coin that has already held a pool for an hour or more: medium size, thirds at +50% and +100%, a 25% trail, a 90-minute review and thesis-break exits instead of a hard stop.",
+  "mode": "paper",
+  "bankroll": {
+    "startUsd": 1000
+  },
+  "entry": {
+    "screen": "liq >= 30K vol1h > 15K !flag:mint !flag:freeze",
+    "ageHours": {
+      "min": 1,
+      "max": 168
+    },
+    "safety": {
+      "maxTop10Pct": 35,
+      "maxDevPct": 5,
+      "requireNoMintAuthority": true,
+      "requireNoFreezeAuthority": true,
+      "maxMcapSplitX": 5,
+      "youngVertical": {
+        "maxAgeHours": 1,
+        "maxH1Pct": 250
+      },
+      "unknownHolders": "reject"
+    },
+    "triggers": [
+      {
+        "kind": "screen"
+      }
+    ],
+    "triggerMode": "any",
+    "decide": "agent",
+    "candidateTtlSec": 300
+  },
+  "exits": {
+    "default": "swing",
+    "profiles": [
+      "builtin:swing",
+      "builtin:runner",
+      "builtin:scalp"
+    ]
+  },
+  "sizing": {
+    "mode": "pct",
+    "pct": 10,
+    "maxPctOfBankroll": 15,
+    "maxUsd": 500,
+    "minUsd": 5
+  },
+  "risk": {
+    "perTrade": {
+      "maxLossPctOfBankroll": 10,
+      "assumedLossPctNoStop": 100
+    },
+    "dailyLossHaltPct": 15,
+    "drawdown": {
+      "sizeDownAtPct": 25,
+      "sizeDownMult": 0.5,
+      "recoverBelowPct": 15,
+      "haltAtPct": 40
+    },
+    "maxConcurrent": 2,
+    "maxExposurePct": 35,
+    "lossStreak": {
+      "losses": 3,
+      "cooldownMin": 60
+    },
+    "maxEntriesPerDay": 8,
+    "perCoin": {
+      "maxEntries": 1,
+      "cooldownMin": 30
+    }
+  },
+  "agent": {
+    "model": "sonnet",
+    "maxSessions": 2,
+    "budgetUsdPerSession": 0.5,
+    "budgetUsdPerDay": 10,
+    "maxTurns": 60,
+    "deltaEverySec": 15,
+    "decideWithinSec": 90,
+    "sessionMaxMin": 240,
+    "onTimeout": "skip"
+  },
+  "execution": {
+    "slippageBps": 100,
+    "feeBps": 30,
+    "networkFeeUsd": 0.02,
+    "latencyMs": 3000,
+    "maxPriceImpactPct": 8,
+    "minExitLiquidityUsd": 2000
+  }
+}

package/dist/packages/autotrade/assets/strategies/yolo.json

@@ -0,0 +1,157 @@
+{
+  "kind": "strategy",
+  "schema": "dexterm-strategy/1",
+  "id": "yolo",
+  "name": "YOLO full port (HIGH RISK)",
+  "version": "1.0.0",
+  "description": "HIGH RISK, PAPER only. One early-momentum entry at a time, the biggest size the paper book allows behind it. Holder-safety gates first: LP burned or locked, no mint or freeze authority, the LARP check, minimum liquidity. Take the cost back at about 2x, then a free bag with a loose trail; thesis-break and liquidity-pull exits, a time stop, never the same coin twice. Most entries lose and one rug can zero the wallet.",
+  "mode": "paper",
+  "highRisk": true,
+  "bankroll": {
+    "startUsd": 200
+  },
+  "entry": {
+    "screen": "liq >= 25K vol5m >= 5K lplocked >= 90 !flag:mint !flag:freeze",
+    "ageHours": {
+      "min": 0,
+      "max": 2
+    },
+    "safety": {
+      "maxTop10Pct": 30,
+      "maxDevPct": 5,
+      "requireNoMintAuthority": true,
+      "requireNoFreezeAuthority": true,
+      "maxMcapSplitX": 3,
+      "youngVertical": {
+        "maxAgeHours": 2,
+        "maxH1Pct": 150
+      },
+      "unknownHolders": "reject",
+      "larp": {
+        "maxScore": 49,
+        "unknown": "reject"
+      }
+    },
+    "triggers": [
+      {
+        "kind": "momentum",
+        "m5MinPct": 3,
+        "buySellMin": 1.3
+      }
+    ],
+    "triggerMode": "any",
+    "decide": "agent",
+    "candidateTtlSec": 180
+  },
+  "exits": {
+    "default": "yolo",
+    "profiles": [
+      {
+        "kind": "exit-profile",
+        "id": "yolo",
+        "name": "YOLO (cost back at 2x, free bag)",
+        "version": "1.2.0",
+        "description": "The whole stake on one young pair. At about 2x, sell the slice that pays back the position cost; the rest rides as a free bag on a loose 50% trail. Liquidity pulls, dev sells and dead volume exit at once; a -50% stop and a 45-minute time stop keep a full-port position from bleeding out slowly.",
+        "fit": {
+          "summary": "A young pair (0-2 h) with LP burned or locked, no mint or freeze authority, a LARP score below the high band, liquidity >= $25k and a first clean 5-minute push.",
+          "minLiquidityUsd": 25000,
+          "ageHours": { "min": 0, "max": 2 },
+          "maxTop10Pct": 30,
+          "signals": ["first clean 5m push with buyers ahead of sellers", "liquidity rising with price", "many distinct buyers, top-2 share low"]
+        },
+        "sizing": { "maxSizePctOfBankroll": 25 },
+        "tpLadder": [],
+        "trailingStop": null,
+        "costRecovery": { "atPct": 100, "maxSellFrac": 0.6 },
+        "bagTrail": { "trailPct": 50 },
+        "timeStop": { "minutes": 45, "ifBelowPct": 20, "action": "exit" },
+        "hardStop": {
+          "enabled": true,
+          "atPct": -50,
+          "why": "The whole wallet rides on one coin: a -50% stop ends a slow bleed. A rug or a pulled pool still fills near -100%, whatever the stop says."
+        },
+        "thesisBreak": {
+          "liquidityDropPct": 30,
+          "liquidityWindowMin": 5,
+          "mcapDivergenceX": 5,
+          "devSell": { "exitOnAnyDevSell": true, "topHolderSellPctOfBag": 30 },
+          "volumeDeath": { "m5TradesBelow": 5, "forMinutes": 20 }
+        },
+        "reentry": {
+          "allowed": false,
+          "cooldownMinutes": 0,
+          "maxEntriesPerCoinPerSession": 1,
+          "requires": "never the same coin twice: a full-port entry is never repeated"
+        },
+        "carry": { "allowed": false, "requiresTpFilled": 0, "maxRemainderPctOfBankroll": 0 },
+        "reprofileTo": [],
+        "wake": { "onTpFilled": false, "onTimeReview": false, "drawdownPct": -30, "thesisWarnFrac": 0.6, "noAnswer": "exit", "onCostRecovered": true },
+        "maxHoldMinutes": 1440,
+        "notes": [
+          "The bag trail arms on the cost-recovery sell; before that the stop, the time stop, the thesis breaks and the rug floor exit.",
+          "An agent can tighten or exit early, never loosen a stop or a trail."
+        ]
+      }
+    ]
+  },
+  "sizing": {
+    "mode": "pct",
+    "pct": 25,
+    "maxPctOfBankroll": 25,
+    "maxUsd": 1000,
+    "minUsd": 5
+  },
+  "risk": {
+    "perTrade": {
+      "maxLossPctOfBankroll": 25,
+      "assumedLossPctNoStop": 100
+    },
+    "dailyLossHaltPct": 60,
+    "drawdown": {
+      "sizeDownAtPct": 50,
+      "sizeDownMult": 1,
+      "recoverBelowPct": 10,
+      "haltAtPct": 80
+    },
+    "maxConcurrent": 1,
+    "maxExposurePct": 100,
+    "lossStreak": {
+      "losses": 3,
+      "cooldownMin": 60
+    },
+    "maxEntriesPerDay": 6,
+    "perCoin": {
+      "maxEntries": 1,
+      "cooldownMin": 10080
+    },
+    "recoveredBags": {
+      "countAsOpen": true,
+      "maxBags": 1
+    }
+  },
+  "agent": {
+    "model": "sonnet",
+    "maxSessions": 1,
+    "budgetUsdPerSession": 0.5,
+    "budgetUsdPerDay": 5,
+    "maxTurns": 60,
+    "deltaEverySec": 15,
+    "decideWithinSec": 45,
+    "sessionMaxMin": 240,
+    "onTimeout": "skip"
+  },
+  "execution": {
+    "slippageBps": 300,
+    "feeBps": 30,
+    "networkFeeUsd": 0.02,
+    "latencyMs": 3000,
+    "maxPriceImpactPct": 3,
+    "minExitLiquidityUsd": 5000
+  },
+  "notes": [
+    "HIGH RISK. Paper only: dexterm holds no key and places no live order. Experimental; not financial advice. Self-directed only.",
+    "Paper: the runner's book caps one position at 25% (the ceiling for every strategy); the replay below measures full port.",
+    "Run it: `dexterm autotrade run yolo --paper` (`--replay builtin:yolo-rehearsal --stub` for a short fixture run).",
+    "`dexterm autotrade yolo-replay yolo` shows what full-port compounding did on your recorded history: rugs, the loss spread and how often it zeroed the wallet."
+  ]
+}

package/dist/packages/autotrade/assets/tapes/yolo-rehearsal.json

@@ -0,0 +1 @@
+{"schema":"dexterm-autotrade-tape/1","source":"FIXTURE: yolo devnet rehearsal (synthetic)","extractedAt":"2026-10-22T00:00:00.000Z","window":{"from":1792800000000,"to":1792805940000},"note":"REHEARSAL FIXTURE, NOT MARKET DATA. Synthetic price paths written for the yolo devnet rehearsal, on three real, long-lived mainnet mint addresses (so the devnet signer can read their mint and freeze authority and their liquidity). The symbols, prices, ages and liquidity here are made up. Paths: a 3x push with the cost taken back and the bag trailed out; a flat entry the time stop closes; a pool pulled by half (the liquidity-pull exit). Never a performance sample.","columns":["t","kind","price","mcap","mcapResolved","mcapFlagged","liq","vol5m","vol1h","vol24","buys5m","sells5m","buys24","sells24","chg5m","chg1h","chg6h","chg24h","holders","top10","dev","mintAuth","freezeAuth","org"],"mints":[{"mint":"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263","symbol":"REHA","launchpad":"pump.fun","createdAt":1792798800000,"rows":[[1792800000000,"live",1e-05,10000,10000,0,60000,10800.0,108000.0,540000.0,40,20,800,400,5.0,0.0,0.0,0.0,900,22.5,2.1,0,0,62.0],[1792800060000,"live",1.25e-05,12500,12500,0,66000,11700.0,117000.0,585000.0,45,20,900,400,25.0,25.0,25.0,25.0,905,22.5,2.1,0,0,62.0],[1792800120000,"live",1.5000000000000002e-05,15000,15000,0,72000,11700.0,117000.0,585000.0,45,20,900,400,50.0,50.0,50.0,50.0,910,22.5,2.1,0,0,62.0],[1792800180000,"live",1.7500000000000002e-05,17500,17500,0,78000,11700.0,117000.0,585000.0,45,20,900,400,75.0,75.0,75.0,75.0,915,22.5,2.1,0,0,62.0],[1792800240000,"live",2e-05,20000,20000,0,84000,11700.0,117000.0,585000.0,45,20,900,400,100.0,100.0,100.0,100.0,920,22.5,2.1,0,0,62.0],[1792800300000,"live",2.25e-05,22500,22500,0,90000,11700.0,117000.0,585000.0,45,20,900,400,125.0,125.0,125.0,125.0,925,22.5,2.1,0,0,62.0],[1792800360000,"live",2.5e-05,25000,25000,0,96000,11700.0,117000.0,585000.0,45,20,900,400,100.0,150.0,150.0,150.0,930,22.5,2.1,0,0,62.0],[1792800420000,"live",2.75e-05,27500,27500,0,102000,11700.0,117000.0,585000.0,45,20,900,400,83.33,175.0,175.0,175.0,935,22.5,2.1,0,0,62.0],[1792800480000,"live",3.0000000000000004e-05,30000,30000,0,108000,11700.0,117000.0,585000.0,45,20,900,400,71.43,200.0,200.0,200.0,940,22.5,2.1,0,0,62.0],[1792800540000,"live",2.7899999999999997e-05,27900,27900,0,106000,9900.0,99000.0,495000.0,25,30,500,600,39.5,179.0,179.0,179.0,945,22.5,2.1,0,0,62.0],[1792800600000,"live",2.58e-05,25800,25800,0,104000,9900.0,99000.0,495000.0,25,30,500,600,14.67,158.0,158.0,158.0,950,22.5,2.1,0,0,62.0],[1792800660000,"live",2.37e-05,23700,23700,0,102000,9900.0,99000.0,495000.0,25,30,500,600,-5.2,137.0,137.0,137.0,955,22.5,2.1,0,0,62.0],[1792800720000,"live",2.16e-05,21600,21600,0,100000,9900.0,99000.0,495000.0,25,30,500,600,-21.45,116.0,116.0,116.0,960,22.5,2.1,0,0,62.0],[1792800780000,"live",1.9499999999999996e-05,19500,19500,0,98000,9900.0,99000.0,495000.0,25,30,500,600,-35.0,95.0,95.0,95.0,965,22.5,2.1,0,0,62.0],[1792800840000,"live",1.74e-05,17400,17400,0,96000,9900.0,99000.0,495000.0,25,30,500,600,-37.63,74.0,74.0,74.0,970,22.5,2.1,0,0,62.0],[1792800900000,"live",1.53e-05,15300,15300,0,94000,9900.0,99000.0,495000.0,25,30,500,600,-40.7,53.0,53.0,53.0,975,22.5,2.1,0,0,62.0],[1792800960000,"live",1.3199999999999999e-05,13200,13200,0,92000,9900.0,99000.0,495000.0,25,30,500,600,-44.3,32.0,32.0,32.0,980,22.5,2.1,0,0,62.0],[1792801020000,"live",1.32e-05,13200,13200,0,92000,5400.0,54000.0,270000.0,15,15,300,300,-38.89,32.0,32.0,32.0,985,22.5,2.1,0,0,62.0],[1792801080000,"live",1.32e-05,13200,13200,0,92000,5400.0,54000.0,270000.0,15,15,300,300,-32.31,32.0,32.0,32.0,990,22.5,2.1,0,0,62.0],[1792801140000,"live",1.32e-05,13200,13200,0,92000,5400.0,54000.0,270000.0,15,15,300,300,-24.14,32.0,32.0,32.0,995,22.5,2.1,0,0,62.0],[1792801200000,"live",1.32e-05,13200,13200,0,92000,5400.0,54000.0,270000.0,15,15,300,300,-13.73,32.0,32.0,32.0,1000,22.5,2.1,0,0,62.0]]},{"mint":"7GCihgDB8fe6KNjn2MYtkzZcRjQy3t9GHdC8uHYmW2hr","symbol":"REHC","launchpad":"pump.fun","createdAt":1792800600000,"rows":[[1792801800000,"live",2e-05,20000,20000,0,70000,10800.0,108000.0,540000.0,40,20,800,400,5.0,0.0,0.0,0.0,900,22.5,2.1,0,0,62.0],[1792801860000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,3.0,3.0,3.0,3.0,905,22.5,2.1,0,0,62.0],[1792801920000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-2.0,-2.0,-2.0,-2.0,910,22.5,2.1,0,0,62.0],[1792801980000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,3.0,3.0,3.0,3.0,915,22.5,2.1,0,0,62.0],[1792802040000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-2.0,-2.0,-2.0,-2.0,920,22.5,2.1,0,0,62.0],[1792802100000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,3.0,3.0,3.0,3.0,925,22.5,2.1,0,0,62.0],[1792802160000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,930,22.5,2.1,0,0,62.0],[1792802220000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,935,22.5,2.1,0,0,62.0],[1792802280000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,940,22.5,2.1,0,0,62.0],[1792802340000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,945,22.5,2.1,0,0,62.0],[1792802400000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,950,22.5,2.1,0,0,62.0],[1792802460000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,955,22.5,2.1,0,0,62.0],[1792802520000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,960,22.5,2.1,0,0,62.0],[1792802580000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,965,22.5,2.1,0,0,62.0],[1792802640000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,970,22.5,2.1,0,0,62.0],[1792802700000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,975,22.5,2.1,0,0,62.0],[1792802760000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,980,22.5,2.1,0,0,62.0],[1792802820000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,985,22.5,2.1,0,0,62.0],[1792802880000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,990,22.5,2.1,0,0,62.0],[1792802940000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,995,22.5,2.1,0,0,62.0],[1792803000000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1000,22.5,2.1,0,0,62.0],[1792803060000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1005,22.5,2.1,0,0,62.0],[1792803120000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1010,22.5,2.1,0,0,62.0],[1792803180000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1015,22.5,2.1,0,0,62.0],[1792803240000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1020,22.5,2.1,0,0,62.0],[1792803300000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1025,22.5,2.1,0,0,62.0],[1792803360000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1030,22.5,2.1,0,0,62.0],[1792803420000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1035,22.5,2.1,0,0,62.0],[1792803480000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1040,22.5,2.1,0,0,62.0],[1792803540000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1045,22.5,2.1,0,0,62.0],[1792803600000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1050,22.5,2.1,0,0,62.0],[1792803660000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1055,22.5,2.1,0,0,62.0],[1792803720000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1060,22.5,2.1,0,0,62.0],[1792803780000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1065,22.5,2.1,0,0,62.0],[1792803840000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1070,22.5,2.1,0,0,62.0],[1792803900000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1075,22.5,2.1,0,0,62.0],[1792803960000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1080,22.5,2.1,0,0,62.0],[1792804020000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1085,22.5,2.1,0,0,62.0],[1792804080000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1090,22.5,2.1,0,0,62.0],[1792804140000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1095,22.5,2.1,0,0,62.0],[1792804200000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1100,22.5,2.1,0,0,62.0],[1792804260000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1105,22.5,2.1,0,0,62.0],[1792804320000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1110,22.5,2.1,0,0,62.0],[1792804380000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1115,22.5,2.1,0,0,62.0],[1792804440000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1120,22.5,2.1,0,0,62.0],[1792804500000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1125,22.5,2.1,0,0,62.0],[1792804560000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1130,22.5,2.1,0,0,62.0],[1792804620000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1135,22.5,2.1,0,0,62.0],[1792804680000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1140,22.5,2.1,0,0,62.0],[1792804740000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1145,22.5,2.1,0,0,62.0],[1792804800000,"live",1.9600000000000002e-05,19600,19600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,-4.85,-2.0,-2.0,-2.0,1150,22.5,2.1,0,0,62.0],[1792804860000,"live",2.0600000000000003e-05,20600,20600,0,70000,4320.0,43200.0,216000.0,12,12,240,240,5.1,3.0,3.0,3.0,1155,22.5,2.1,0,0,62.0]]},{"mint":"EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm","symbol":"REHB","launchpad":"pump.fun","createdAt":1792804200000,"rows":[[1792805400000,"live",5e-06,5000,5000,0,80000,10800.0,108000.0,540000.0,40,20,800,400,5.0,0.0,0.0,0.0,900,22.5,2.1,0,0,62.0],[1792805460000,"live",5.2e-06,5200,5200,0,81000,9000.0,90000.0,450000.0,30,20,600,400,4.0,4.0,4.0,4.0,905,22.5,2.1,0,0,62.0],[1792805520000,"live",5.1e-06,5100,5100,0,80500,7560.0,75600.0,378000.0,20,22,400,440,2.0,2.0,2.0,2.0,910,22.5,2.1,0,0,62.0],[1792805580000,"live",2.4e-06,2400,2400,0,40000,12600.0,126000.0,630000.0,10,60,200,1200,-52.0,-52.0,-52.0,-52.0,915,22.5,2.1,0,0,62.0],[1792805640000,"live",1.9e-06,1900,1900,0,36000,8640.0,86400.0,432000.0,8,40,160,800,-62.0,-62.0,-62.0,-62.0,920,22.5,2.1,0,0,62.0],[1792805700000,"live",1.8e-06,1800,1800,0,35000,2880.0,28800.0,144000.0,6,10,120,200,-64.0,-64.0,-64.0,-64.0,925,22.5,2.1,0,0,62.0],[1792805760000,"live",1.8e-06,1800,1800,0,35000,2880.0,28800.0,144000.0,6,10,120,200,-65.38,-64.0,-64.0,-64.0,930,22.5,2.1,0,0,62.0],[1792805820000,"live",1.8e-06,1800,1800,0,35000,2880.0,28800.0,144000.0,6,10,120,200,-64.71,-64.0,-64.0,-64.0,935,22.5,2.1,0,0,62.0],[1792805880000,"live",1.8e-06,1800,1800,0,35000,2880.0,28800.0,144000.0,6,10,120,200,-25.0,-64.0,-64.0,-64.0,940,22.5,2.1,0,0,62.0],[1792805940000,"live",1.8e-06,1800,1800,0,35000,2880.0,28800.0,144000.0,6,10,120,200,-5.26,-64.0,-64.0,-64.0,945,22.5,2.1,0,0,62.0]]}]}

package/dist/packages/autotrade/examples/executor/README.md

@@ -0,0 +1,70 @@
+# dexterm executor reference kit
+
+dexterm holds no key and signs nothing. In real mode a strategy sends a **LIVE TRADE FIRE** signal
+(`dexterm-trade-fire/1`) for every buy and sell. **Your own executor** acts on it: a Telegram trading bot you chose,
+or any script.
+
+This folder holds three small executors you can wire up in minutes, so you can see the whole path work before
+anything can spend money:
+
+| file | channel | how dexterm reaches it |
+|---|---|---|
+| `webhook-executor.mjs` | webhook | `dexterm autotrade signal channels --webhook http://127.0.0.1:8787/signal` |
+| `signal-cmd-executor.mjs` | command hook | `dexterm autotrade signal channels --signal-cmd '["/abs/node","/abs/signal-cmd-executor.mjs","--account","main"]'` |
+| `jsonl-tail-executor.mjs` | JSONL stream | `dexterm autotrade signal channels --jsonl on` (add `--jsonl-signed on` for HMAC lines) |
+
+Each one handles every signal the same way:
+
+1. It verifies the HMAC, when you give it the secret file. Without `--secret-file` it acts on unsigned bodies (it says `HMAC NOT checked` when it starts); before you put a real trade into `act()`, run it with `--secret-file` and `--require-hmac`.
+2. It checks the account id.
+3. It dedupes by nonce. Delivery is at-least-once, so a repeat is normal, and the seen set survives a restart.
+4. It ignores anything past `expiresAt` (the TTL).
+5. It writes a receipt to dexterm's `autotrade/real/receipts.jsonl` and a heartbeat to `autotrade/real/executor.jsonl`.
+
+**All of them are DRY RUN.** `act()` in `kit.mjs` only logs what it WOULD do, and the receipt says so:
+status `rejected`, reason `dry-run: would BUY …`. There is no wallet code, no key and no chain call anywhere in this
+kit. Trading for real means replacing `act()` with your own code, or handing the order to your own bot. That is your
+code and your wallet, never dexterm's.
+
+## Five minutes, end to end (paper money only)
+
+```sh
+# 1. a secret for the HMAC (written to a 0600 file, stored in your keychain, never printed)
+dexterm autotrade signal secret generate --out ~/.dexterm-exec.secret
+
+# 2. start the kit's webhook executor (dry run) in another terminal
+node webhook-executor.mjs --account main --secret-file ~/.dexterm-exec.secret
+
+# 3. point dexterm at it, then prove the round trip
+dexterm autotrade signal channels --webhook http://127.0.0.1:8787/signal
+dexterm autotrade signal test          # per channel: delivered, latency, the kit's receipt
+dexterm autotrade executor status      # alive · last heartbeat · last receipt · lag
+```
+
+`signal test` sends a signal marked `test: true` that names no mint, so there is nothing in it to trade. The kit
+receipts it as `rejected` (`test signal: received, never traded`).
+
+## Heartbeats and the silence pause
+
+dexterm counts a heartbeat, a receipt, or an ack on the webhook or command hook as a sign of life. When it hears
+nothing for longer than your `executorSilenceMin` limit (placeholder: 15 min), a real run **pauses new buy
+signals** and tells you in the run log and on Telegram. Exits keep going out. The kit sends a heartbeat every 60 s
+(`--heartbeat-sec`). Your own executor can append the same line, POST it to the run's loopback listener
+(`--executor-port`), or run `dexterm autotrade executor heartbeat`:
+
+```json
+{"schema":"dexterm-executor-heartbeat/1","at":1761300000000,"executor":"my-bot","accountId":"main","dryRun":false,"lastNonce":42}
+```
+
+## Receipts
+
+A receipt is data only. It moves a real position from `unconfirmed` to executed / rejected / failed. With a fill
+(`priceUsd`, `sizeSol`, `tokens`, `txSig`), dexterm also measures how far the real fill was from its own paper fill:
+slippage, latency, partial fills and rejections. That shows in `dexterm autotrade audit`, `signal status` and
+`dexterm autotrade report`.
+
+```json
+{"schema":"dexterm-trade-receipt/1","signalId":"<the signal's id>","nonce":42,"accountId":"main","status":"executed","at":1761300001200,"fill":{"priceUsd":0.00123,"sizeSol":0.25,"tokens":40650,"txSig":null},"reason":null,"executor":"my-bot"}
+```
+
+See `telegram-bot-recipe.md` for the Telegram trading-bot setup. The bot executes, and dexterm never signs.

package/dist/packages/autotrade/examples/executor/jsonl-tail-executor.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// dexterm executor reference kit: the JSONL stream tail (task-1654). DRY RUN: logs what it would do; no wallet code.
+//
+//   node jsonl-tail-executor.mjs --account main [--stream FILE] [--secret-file FILE --require-hmac] [--once] [--poll-ms 1000]
+//
+// Turn the stream on in dexterm (`dexterm autotrade signal channels --jsonl on`, default file
+// autotrade/real/signals.jsonl). With `--jsonl-signed on` each line is an HMAC envelope this tail verifies; a bare
+// line has no signature, so --require-hmac refuses it. The read offset is saved, so a restart resumes where it was.
+// --once reads what is there and exits (handy for a test).
+
+import { closeSync, existsSync, openSync, readFileSync, readSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { SeenStore, args, dextermHome, handle, heartbeat, readSecret, realDir, unwrapLine } from './kit.mjs';
+
+const a = args();
+if (!a.account) { console.error('usage: node jsonl-tail-executor.mjs --account ID [--stream FILE] [--secret-file FILE] [--once]'); process.exit(2); }
+const home = a.home || dextermHome();
+const stream = a.stream || join(realDir(home), 'signals.jsonl');
+const offFile = a['offset-file'] || join(realDir(home), 'kit-tail-offset.json');
+const seen = new SeenStore(a.state || join(realDir(home), 'kit-tail-seen.json'));
+const secret = readSecret(a['secret-file']);
+const name = String(a.name || 'kit-jsonl-tail').slice(0, 32);
+const log = (s) => console.log(`[${new Date().toISOString()}] ${s}`);
+let offset = 0;
+try { offset = Number(JSON.parse(readFileSync(offFile, 'utf8')).offset) || 0; } catch { /* from the start */ }
+let carry = '';
+
+function poll() {
+  if (!existsSync(stream)) return;
+  const size = statSync(stream).size;
+  if (size < offset) { offset = 0; carry = ''; }
+  if (size === offset) return;
+  const fd = openSync(stream, 'r');
+  const buf = Buffer.alloc(size - offset);
+  try { readSync(fd, buf, 0, buf.length, offset); } finally { closeSync(fd); }
+  offset = size;
+  const lines = (carry + buf.toString('utf8')).split('\n');
+  carry = lines.pop() ?? '';
+  for (const l of lines) {
+    if (!l.trim()) continue;
+    const { body, signature } = unwrapLine(l);
+    handle(body, { accountId: a.account, secret, requireHmac: !!a['require-hmac'], signature, seen, home, executor: name, log, now: Date.now() });
+  }
+  writeFileSync(offFile, JSON.stringify({ offset: offset - Buffer.byteLength(carry) }));
+}
+
+const beat = () => { try { heartbeat(home, { executor: name, accountId: a.account, lastNonce: seen.maxNonce || null }); } catch (e) { log(`heartbeat failed: ${e.message}`); } };
+poll();
+beat();
+if (!a.once) {
+  log(`dexterm kit JSONL tail executor (DRY RUN) on ${stream} · account ${a.account}`);
+  const t1 = setInterval(poll, Math.max(100, Number(a['poll-ms'] ?? 1000)));
+  const t2 = setInterval(beat, Math.max(5, Number(a['heartbeat-sec'] ?? 60)) * 1000);
+  const stop = () => { clearInterval(t1); clearInterval(t2); process.exit(0); };
+  process.on('SIGINT', stop);
+  process.on('SIGTERM', stop);
+}

package/dist/packages/autotrade/examples/executor/kit.mjs

@@ -0,0 +1,144 @@
+// dexterm executor reference kit: the shared part (task-1654). Plain Node (22+), no dependencies, no wallet code.
+//
+// Every kit executor does the same five things with a LIVE TRADE FIRE signal (`dexterm-trade-fire/1`):
+//   1. verify the HMAC (`t=<unix s>,v1=<hex sha256 of "<t>.<body>">`) when you gave it the secret file
+//   2. check the shape, and that the signal is for YOUR account id
+//   3. dedupe by nonce and id (delivery is at-least-once: a repeat is normal); the seen set survives a restart
+//   4. honor the TTL: anything past `expiresAt` is ignored, never acted on late
+//   5. write a receipt (`dexterm-trade-receipt/1`) to dexterm's receipts.jsonl, and a heartbeat now and then
+//
+// It is DRY RUN, always: `act()` below only logs what it WOULD do and the receipt says so (status "rejected",
+// reason "dry-run: …"). There is no key, no wallet and no chain call in this kit. To trade for real you replace
+// `act()` with your own executor's code (or hand the order to the Telegram trading bot you chose); dexterm never
+// signs anything.
+
+import { createHmac, timingSafeEqual } from 'node:crypto';
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir } from 'node:os';
+
+export const SIGNAL_SCHEMA = 'dexterm-trade-fire/1';
+export const RECEIPT_SCHEMA = 'dexterm-trade-receipt/1';
+export const HEARTBEAT_SCHEMA = 'dexterm-executor-heartbeat/1';
+export const ENVELOPE_SCHEMA = 'dexterm-trade-fire-envelope/1';
+const TOLERANCE_SEC = 300;
+const MINT = /^[1-9A-HJ-NP-Za-km-z]{32,44}$/;
+
+/** `--name value` / `--flag` argv into an object. */
+export function args(argv = process.argv.slice(2)) {
+  const o = {};
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    if (!a.startsWith('--')) continue;
+    const k = a.slice(2);
+    const v = argv[i + 1];
+    if (v !== undefined && !v.startsWith('--')) { o[k] = v; i++; } else o[k] = true;
+  }
+  return o;
+}
+
+/** Where dexterm keeps its files (DEXTERM_HOME, else ~/.dexterm). */
+export const dextermHome = (env = process.env) => env.DEXTERM_HOME || join(homedir(), '.dexterm');
+export const realDir = (home) => join(home, 'autotrade', 'real');
+
+/** The HMAC secret from a file (`dexterm autotrade signal secret generate --out FILE`), or null. */
+export function readSecret(file) {
+  if (!file) return null;
+  const v = readFileSync(file, 'utf8').trim();
+  return v || null;
+}
+
+export function verify(secret, header, body, nowMs = Date.now()) {
+  const m = /^t=(\d{1,12}),v1=([0-9a-f]{64})$/.exec(String(header ?? ''));
+  if (!m) return { ok: false, why: 'signature-missing' };
+  const t = Number(m[1]);
+  if (Math.abs(nowMs / 1000 - t) > TOLERANCE_SEC) return { ok: false, why: 'signature-stale' };
+  const want = createHmac('sha256', secret).update(`${t}.${body}`).digest();
+  const got = Buffer.from(m[2], 'hex');
+  return got.length === want.length && timingSafeEqual(got, want) ? { ok: true } : { ok: false, why: 'signature-bad' };
+}
+
+/** The seen nonces and ids, in a small JSON file so a restart does not act on a repeat. */
+export class SeenStore {
+  constructor(file) { this.file = file; this.seen = new Set(); this.maxNonce = 0; try { const d = JSON.parse(readFileSync(file, 'utf8')); for (const x of d.seen ?? []) this.seen.add(x); this.maxNonce = Number(d.maxNonce) || 0; } catch { /* first run */ } }
+  has(s) { return this.seen.has(s.id) || this.seen.has(`n${s.nonce}`); }
+  add(s) {
+    this.seen.add(s.id); this.seen.add(`n${s.nonce}`); this.maxNonce = Math.max(this.maxNonce, s.nonce);
+    const keep = [...this.seen].slice(-4000);
+    mkdirSync(dirname(this.file), { recursive: true });
+    const tmp = `${this.file}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify({ seen: keep, maxNonce: this.maxNonce }));
+    renameSync(tmp, this.file);
+  }
+}
+
+/**
+ * Check one signal body. Returns { verdict, signal?, why }: verdict is act | duplicate | expired | rejected.
+ * `secret` null = no HMAC check (only when you chose not to set one).
+ */
+export function check(body, o) {
+  const now = o.now ?? Date.now();
+  if (o.secret) { const v = verify(o.secret, o.signature, body, now); if (!v.ok) return { verdict: 'rejected', why: v.why }; }
+  else if (o.requireHmac) return { verdict: 'rejected', why: 'signature-required' };
+  let s;
+  try { s = JSON.parse(body); } catch { return { verdict: 'rejected', why: 'not-json' }; }
+  if (!s || s.schema !== SIGNAL_SCHEMA || !['trade', 'halted', 'test'].includes(s.type) || !Number.isSafeInteger(s.nonce) || typeof s.id !== 'string') return { verdict: 'rejected', why: 'shape' };
+  if (s.paper !== false) return { verdict: 'rejected', why: 'paper-flag' };
+  if (s.accountId !== o.accountId) return { verdict: 'rejected', why: 'wrong-account', signal: s };
+  if (o.seen.has(s)) return { verdict: 'duplicate', why: 'duplicate', signal: s };
+  if (!(now <= s.expiresAt)) return { verdict: 'expired', why: 'expired', signal: s };
+  if (s.type === 'trade' && (!MINT.test(s.mint) || (s.side !== 'buy' && s.side !== 'sell'))) return { verdict: 'rejected', why: 'shape', signal: s };
+  if (s.type === 'trade' && s.nonce <= o.seen.maxNonce) return { verdict: 'rejected', why: 'nonce-replay', signal: s };
+  return { verdict: 'act', why: null, signal: s };
+}
+
+/**
+ * What the executor does with a fresh signal. DRY RUN: it only says what it WOULD do. Replace this with your own
+ * code to trade (your wallet, your bot); keep the rest of the pipeline (verify, dedupe, TTL, receipt) as it is.
+ */
+export function act(s) {
+  if (s.type === 'test') return { status: 'rejected', reason: 'test signal: received, never traded' };
+  if (s.type === 'halted') return { status: null, reason: `halted (${s.reason}): would cancel ${s.outstanding.length} outstanding signal(s)` };
+  const what = s.side === 'buy' ? `would BUY ${s.sizeSol} SOL of ${s.symbol} (${s.mint}) with ${s.slippageBps} bps slippage` : `would SELL ${Math.round(s.sellFraction * 1000) / 10}% of ${s.symbol} (${s.mint}): ${s.exitReason}`;
+  return { status: 'rejected', reason: `dry-run: ${what}`.slice(0, 120) };
+}
+
+/** Append a receipt line to dexterm's receipts.jsonl (the same file `dexterm autotrade receipt` writes). */
+export function writeReceipt(home, s, r, executor, now = Date.now()) {
+  const line = { schema: RECEIPT_SCHEMA, signalId: s.id, nonce: s.nonce, accountId: s.accountId, status: r.status, at: now, fill: r.fill ?? null, reason: r.reason ?? null, executor };
+  mkdirSync(realDir(home), { recursive: true, mode: 0o700 });
+  appendFileSync(join(realDir(home), 'receipts.jsonl'), `${JSON.stringify(line)}\n`, { mode: 0o600 });
+  return line;
+}
+
+/** Append a heartbeat to dexterm's executor.jsonl: dexterm pauses new buys when it hears nothing for too long. */
+export function heartbeat(home, o) {
+  const hb = { schema: HEARTBEAT_SCHEMA, at: o.now ?? Date.now(), executor: o.executor, accountId: o.accountId ?? null, dryRun: true, lastNonce: o.lastNonce ?? null, note: o.note ?? null };
+  mkdirSync(realDir(home), { recursive: true, mode: 0o700 });
+  appendFileSync(join(realDir(home), 'executor.jsonl'), `${JSON.stringify(hb)}\n`, { mode: 0o600 });
+  return hb;
+}
+
+/** The whole pipeline for one body: check, act (dry run), receipt, log line. Returns the verdict. */
+export function handle(body, o) {
+  const c = check(body, o);
+  const s = c.signal;
+  if (c.verdict === 'act') {
+    o.seen.add(s);
+    const r = act(s);
+    if (r.status && s.type !== 'halted') writeReceipt(o.home, s, r, o.executor, o.now ?? Date.now());
+    o.log(`#${s.nonce} ${s.type}${s.type === 'trade' ? ` ${s.side}` : ''}: ${r.reason}`);
+  } else o.log(`${s ? `#${s.nonce} ` : ''}${c.verdict}: ${c.why}`);
+  return c;
+}
+
+/** A stream line: a bare signal, or a signed envelope (`dexterm autotrade signal channels --jsonl-signed on`). */
+export function unwrapLine(line) {
+  try {
+    const x = JSON.parse(line);
+    if (x && x.schema === ENVELOPE_SCHEMA && typeof x.signal === 'string') return { body: x.signal, signature: x.signature ?? null };
+  } catch { /* handled by check() */ }
+  return { body: line, signature: null };
+}
+
+export const exists = existsSync;