pandora-cli-skills 1.1.18 → 1.1.20

package/cli/lib/autopilot_service.cjs

@@ -30,6 +30,14 @@ function buildIdempotencyKey(options, quote, nowMs) {
 }
 
 function evaluateTrigger(options, quote) {
+  if (quote && quote.quoteAvailable === false) {
+    return {
+      triggered: false,
+      reason: 'quote unavailable; skipping trigger evaluation.',
+      yesPct: null,
+    };
+  }
+
   const yesPct = toNumber(quote && quote.odds && quote.odds.yesPct);
   if (yesPct === null) {
     return {
@@ -148,26 +156,40 @@ async function runAutopilot(options, deps) {
           snapshot.action = {
             mode: options.executeLive ? 'live' : 'paper',
             status: 'blocked',
-            reason: `Exposure cap exceeded: ${(state.dailySpendUsdc + options.amountUsdc).toFixed(2)} > ${options.maxOpenExposureUsdc}.`,
+            reason: `Daily spend cap exceeded: ${(state.dailySpendUsdc + options.amountUsdc).toFixed(2)} > ${options.maxOpenExposureUsdc}.`,
           };
         } else {
+          let executionSucceeded = true;
           if (options.executeLive) {
-            const execution = await deps.executeFn({
-              marketAddress: options.marketAddress,
-              side: options.side,
-              amountUsdc: options.amountUsdc,
-              yesPct: trigger.yesPct,
-              maxAmountUsdc: options.maxAmountUsdc,
-              minProbabilityPct: options.minProbabilityPct,
-              maxProbabilityPct: options.maxProbabilityPct,
-            });
+            try {
+              const execution = await deps.executeFn({
+                marketAddress: options.marketAddress,
+                side: options.side,
+                amountUsdc: options.amountUsdc,
+                yesPct: trigger.yesPct,
+                maxAmountUsdc: options.maxAmountUsdc,
+                minProbabilityPct: options.minProbabilityPct,
+                maxProbabilityPct: options.maxProbabilityPct,
+              });
 
-            snapshot.action = {
-              mode: 'live',
-              status: 'executed',
-              idempotencyKey: key,
-              execution,
-            };
+              snapshot.action = {
+                mode: 'live',
+                status: 'executed',
+                idempotencyKey: key,
+                execution,
+              };
+            } catch (err) {
+              executionSucceeded = false;
+              snapshot.action = {
+                mode: 'live',
+                status: 'failed',
+                idempotencyKey: key,
+                error: {
+                  code: err && err.code ? String(err.code) : null,
+                  message: err && err.message ? String(err.message) : String(err),
+                },
+              };
+            }
           } else {
             snapshot.action = {
               mode: 'paper',
@@ -178,10 +200,12 @@ async function runAutopilot(options, deps) {
             };
           }
 
-          state.idempotencyKeys.push(key);
-          pruneIdempotencyKeys(state);
-          state.dailySpendUsdc = Number((state.dailySpendUsdc + options.amountUsdc).toFixed(6));
-          state.tradesToday += 1;
+          if (executionSucceeded) {
+            state.idempotencyKeys.push(key);
+            pruneIdempotencyKeys(state);
+            state.dailySpendUsdc = Number((state.dailySpendUsdc + options.amountUsdc).toFixed(6));
+            state.tradesToday += 1;
+          }
           state.lastExecution = snapshot.action;
           actions.push(snapshot.action);
 
@@ -239,6 +263,7 @@ async function runAutopilot(options, deps) {
       cooldownMs: options.cooldownMs,
       maxAmountUsdc: options.maxAmountUsdc,
       maxOpenExposureUsdc: options.maxOpenExposureUsdc,
+      dailySpendCapUsdc: options.maxOpenExposureUsdc,
       maxTradesPerDay: options.maxTradesPerDay,
     },
     state,

package/cli/lib/mirror_econ_service.cjs

@@ -54,6 +54,9 @@ function resolveDistribution(options = {}) {
   const explicitYes = toNumber(options.distributionYes);
   const explicitNo = toNumber(options.distributionNo);
   if (explicitYes !== null || explicitNo !== null) {
+    if (explicitYes === null || explicitNo === null) {
+      throw new Error('distributionYes and distributionNo must both be provided together.');
+    }
     if (!Number.isInteger(explicitYes) || !Number.isInteger(explicitNo)) {
       throw new Error('distributionYes and distributionNo must be integers.');
     }
@@ -73,6 +76,8 @@ function resolveDistribution(options = {}) {
   const distribution = computeDistributionHint(sourceYesPct === null ? 0.5 : sourceYesPct / 100);
   if (sourceYesPct === null) {
     diagnostics.push('No source YES probability supplied; defaulted to balanced 50/50 distribution hint.');
+  } else if (sourceYesPct === 0 || sourceYesPct === 100) {
+    diagnostics.push('Degenerate source YES probability (0% or 100%) may create an extreme one-sided seed.');
   }
 
   return {
@@ -186,7 +191,7 @@ function simulateDirectionalSwap(options = {}) {
     const denominator = reserveNo + effectiveIn;
     const outputYes = denominator > 0 ? (reserveYes * effectiveIn) / denominator : 0;
     const postReserveYes = Math.max(0, reserveYes - outputYes);
-    const postReserveNo = reserveNo + volumeUsdc;
+    const postReserveNo = reserveNo + effectiveIn;
     return {
       side,
       volumeUsdc: round(volumeUsdc, 6),
@@ -203,7 +208,7 @@ function simulateDirectionalSwap(options = {}) {
   const denominator = reserveYes + effectiveIn;
   const outputNo = denominator > 0 ? (reserveNo * effectiveIn) / denominator : 0;
   const postReserveNo = Math.max(0, reserveNo - outputNo);
-  const postReserveYes = reserveYes + volumeUsdc;
+  const postReserveYes = reserveYes + effectiveIn;
   return {
     side,
     volumeUsdc: round(volumeUsdc, 6),
@@ -270,26 +275,32 @@ function solveVolumeForTargetYesPct(options = {}) {
 }
 
 function normalizeVolumeScenarios(value, liquidityUsdc) {
+  const fallback = () => {
+    const liq = Math.max(1, toNumber(liquidityUsdc) || 0);
+    return [
+      round(liq * 0.25, 6),
+      round(liq * 0.5, 6),
+      round(liq, 6),
+      round(liq * 2, 6),
+    ];
+  };
+
   if (Array.isArray(value)) {
-    return value.map((item) => toNumber(item)).filter((item) => Number.isFinite(item) && item >= 0).map((item) => round(item, 6));
+    const parsed = value.map((item) => toNumber(item)).filter((item) => Number.isFinite(item) && item >= 0).map((item) => round(item, 6));
+    return parsed.length ? parsed : fallback();
   }
 
   const raw = String(value || '').trim();
   if (raw) {
-    return raw
+    const parsed = raw
       .split(',')
       .map((entry) => toNumber(entry.trim()))
       .filter((entry) => Number.isFinite(entry) && entry >= 0)
       .map((entry) => round(entry, 6));
+    return parsed.length ? parsed : fallback();
   }
 
-  const liq = Math.max(1, toNumber(liquidityUsdc) || 0);
-  return [
-    round(liq * 0.25, 6),
-    round(liq * 0.5, 6),
-    round(liq, 6),
-    round(liq * 2, 6),
-  ];
+  return fallback();
 }
 
 function computeHedgeMetrics(options = {}) {
@@ -534,7 +545,7 @@ function buildMirrorSimulate(options = {}) {
     scenarios: scenarioResults,
     diagnostics: [
       'Complete-set mint/split step is exact (raw integer math).',
-      'Trade path models a CPMM-style directional flow with fees retained in reserves.',
+      'Trade path models CPMM directional flow using net-of-fee input in reserve updates; fees are tracked as a separate accrual line.',
       'Use mirror sync + live orderbooks for execution-grade sizing; this command is planning-grade simulation.',
     ].concat(distribution.diagnostics || []),
   };

package/cli/lib/polymarket_ops_service.cjs

@@ -170,7 +170,7 @@ function resolveSpenders(options = {}, env = process.env) {
 function resolveRuntime(options = {}) {
   const env = options.env || process.env;
   const rpcUrl = options.rpcUrl || env.POLYMARKET_RPC_URL || env.RPC_URL || null;
-  const privateKey = options.privateKey || env.POLYMARKET_PRIVATE_KEY || env.PRIVATE_KEY || null;
+  const privateKey = options.privateKey || env.POLYMARKET_PRIVATE_KEY || null;
   const funderAddress = normalizeAddress(options.funder || env.POLYMARKET_FUNDER, 'funder');
   const usdcAddress = normalizeAddress(options.usdcAddress || env.POLYMARKET_USDC_E_ADDRESS, 'usdcAddress')
     || POLYMARKET_POLYGON_DEFAULTS.usdc;

package/cli/lib/polymarket_trade_adapter.cjs

@@ -488,6 +488,25 @@ async function fetchJson(url, timeoutMs) {
   }
 }
 
+async function callWithTimeout(work, timeoutMs, label) {
+  const limitMs = Number.isInteger(timeoutMs) && timeoutMs > 0 ? timeoutMs : null;
+  if (!limitMs) {
+    return work();
+  }
+
+  let timer = null;
+  try {
+    return await Promise.race([
+      work(),
+      new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`${label} timed out after ${limitMs}ms`)), limitMs);
+      }),
+    ]);
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
+
 function buildGammaUrl(baseUrl, params) {
   const url = new URL(`${baseUrl}/markets`);
   for (const [key, value] of Object.entries(params || {})) {
@@ -523,7 +542,7 @@ function extractConditionId(row) {
   return value;
 }
 
-async function resolveByClobDirect(conditionId, hosts, options, diagnostics) {
+async function resolveByClobDirect(conditionId, hosts, options, diagnostics, timeoutMs) {
   const hostErrors = [];
   for (const candidateHost of hosts) {
     try {
@@ -534,7 +553,11 @@ async function resolveByClobDirect(conditionId, hosts, options, diagnostics) {
       if (!client || typeof client.getMarket !== 'function') {
         throw new Error('CLOB client does not expose getMarket.');
       }
-      const market = await client.getMarket(conditionId);
+      const market = await callWithTimeout(
+        () => client.getMarket(conditionId),
+        timeoutMs,
+        `Polymarket getMarket(${conditionId})`,
+      );
       if (!market) continue;
       return {
         row: market,
@@ -604,7 +627,7 @@ async function resolvePolymarketMarket(options = {}) {
     }
 
     if (directConditionId && isConditionId(directConditionId)) {
-      const direct = await resolveByClobDirect(directConditionId, hosts, options, diagnostics);
+      const direct = await resolveByClobDirect(directConditionId, hosts, options, diagnostics, timeoutMs);
       if (direct && direct.row) {
         rows = [direct.row];
         hostUsed = direct.host;
@@ -632,7 +655,11 @@ async function resolvePolymarketMarket(options = {}) {
 
           while (loops < maxPages) {
             loops += 1;
-            const page = cursor ? await client.getMarkets(cursor) : await client.getMarkets();
+            const page = await callWithTimeout(
+              () => (cursor ? client.getMarkets(cursor) : client.getMarkets()),
+              timeoutMs,
+              `Polymarket getMarkets(${candidateHost})`,
+            );
             const chunk = Array.isArray(page && page.data) ? page.data : [];
 
             if (selectorMode) {
@@ -790,7 +817,7 @@ function calculateExecutableDepthUsd(orderbook, side, slippageBps) {
   };
 }
 
-async function getOrderbook(clientOrOptions, tokenId, fallbackOrderbooks = null) {
+async function getOrderbook(clientOrOptions, tokenId, fallbackOrderbooks = null, timeoutMs = null) {
   if (!tokenId) return null;
 
   if (fallbackOrderbooks && typeof fallbackOrderbooks === 'object' && fallbackOrderbooks[tokenId]) {
@@ -801,11 +828,16 @@ async function getOrderbook(clientOrOptions, tokenId, fallbackOrderbooks = null)
     return null;
   }
 
-  return clientOrOptions.getOrderBook(tokenId);
+  return callWithTimeout(
+    () => clientOrOptions.getOrderBook(tokenId),
+    timeoutMs,
+    `Polymarket getOrderBook(${tokenId})`,
+  );
 }
 
 async function fetchDepthForMarket(market, options = {}) {
   const slippageBps = Number.isFinite(Number(options.slippageBps)) ? Number(options.slippageBps) : 100;
+  const timeoutMs = Number.isInteger(options.timeoutMs) && options.timeoutMs > 0 ? options.timeoutMs : 12_000;
   const diagnostics = [];
   const hosts = normalizeHostList(options.host || options.hosts || process.env.POLYMARKET_HOSTS || DEFAULT_POLYMARKET_HOST);
   const cacheFile =
@@ -825,8 +857,8 @@ async function fetchDepthForMarket(market, options = {}) {
     for (const candidateHost of hosts) {
       try {
         const client = new ClobClient(candidateHost, DEFAULT_POLYMARKET_CHAIN);
-        const yesFromHost = await getOrderbook(client, market.yesTokenId, null);
-        const noFromHost = await getOrderbook(client, market.noTokenId, null);
+        const yesFromHost = await getOrderbook(client, market.yesTokenId, null, timeoutMs);
+        const noFromHost = await getOrderbook(client, market.noTokenId, null, timeoutMs);
         yesBook = yesFromHost || yesBook;
         noBook = noFromHost || noBook;
         if (yesFromHost || noFromHost) {
@@ -1289,10 +1321,15 @@ async function fetchPolymarketPositionSummary(options = {}) {
   const fetchBalance = async (tokenId, sideLabel) => {
     if (!tokenId) return;
     try {
-      const response = await client.getBalanceAllowance({
-        asset_type: AssetType.CONDITIONAL,
-        token_id: tokenId,
-      });
+      const response = await callWithTimeout(
+        () =>
+          client.getBalanceAllowance({
+            asset_type: AssetType.CONDITIONAL,
+            token_id: tokenId,
+          }),
+        timeoutMs,
+        `Polymarket getBalanceAllowance(${tokenId})`,
+      );
       if (responseContainsError(response)) {
         diagnostics.push(
           `${sideLabel} balance lookup failed: ${response && response.error ? response.error : `HTTP ${response && response.status ? response.status : 'error'}`}.`,
@@ -1317,14 +1354,30 @@ async function fetchPolymarketPositionSummary(options = {}) {
   let openOrders = null;
   try {
     if (baseSummary.marketId) {
-      openOrders = await client.getOpenOrders({ market: baseSummary.marketId });
+      openOrders = await callWithTimeout(
+        () => client.getOpenOrders({ market: baseSummary.marketId }),
+        timeoutMs,
+        `Polymarket getOpenOrders(market:${baseSummary.marketId})`,
+      );
     } else {
       const grouped = [];
       if (baseSummary.yesTokenId) {
-        grouped.push(await client.getOpenOrders({ asset_id: baseSummary.yesTokenId }));
+        grouped.push(
+          await callWithTimeout(
+            () => client.getOpenOrders({ asset_id: baseSummary.yesTokenId }),
+            timeoutMs,
+            `Polymarket getOpenOrders(asset:${baseSummary.yesTokenId})`,
+          ),
+        );
       }
       if (baseSummary.noTokenId && baseSummary.noTokenId !== baseSummary.yesTokenId) {
-        grouped.push(await client.getOpenOrders({ asset_id: baseSummary.noTokenId }));
+        grouped.push(
+          await callWithTimeout(
+            () => client.getOpenOrders({ asset_id: baseSummary.noTokenId }),
+            timeoutMs,
+            `Polymarket getOpenOrders(asset:${baseSummary.noTokenId})`,
+          ),
+        );
       }
       const dedup = new Map();
       for (const group of grouped) {

package/cli/pandora.cjs

@@ -2954,7 +2954,7 @@ function parseMirrorDeployFlags(args) {
       continue;
     }
     if (token === '--private-key') {
-      options.privateKey = requireFlagValue(args, i, '--private-key');
+      options.privateKey = parsePrivateKeyFlag(requireFlagValue(args, i, '--private-key'), '--private-key');
       i += 1;
       continue;
     }
@@ -4434,6 +4434,7 @@ function parsePolymarketTradeFlags(args) {
     dryRun: false,
     execute: false,
     host: null,
+    timeoutMs: DEFAULT_INDEXER_TIMEOUT_MS,
     rpcUrl: null,
     privateKey: null,
     funder: null,
@@ -4485,6 +4486,11 @@ function parsePolymarketTradeFlags(args) {
       i += 1;
       continue;
     }
+    if (token === '--timeout-ms') {
+      options.timeoutMs = parsePositiveInteger(requireFlagValue(args, i, '--timeout-ms'), '--timeout-ms');
+      i += 1;
+      continue;
+    }
     if (token === '--dry-run') {
       options.dryRun = true;
       continue;
@@ -9768,7 +9774,7 @@ async function runPolymarketCommand(args, context) {
       console.log('  approve --dry-run|--execute [--rpc-url <url>] [--private-key <hex>] [--funder <address>]');
       console.log('  preflight [--rpc-url <url>] [--private-key <hex>] [--funder <address>]');
       console.log(
-        '  trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]',
+        '  trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--timeout-ms <ms>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]',
       );
     }
     return;
@@ -9847,7 +9853,7 @@ async function runPolymarketCommand(args, context) {
   if (action === 'trade') {
     if (includesHelpFlag(actionArgs)) {
       const usage =
-        'pandora [--output table|json] polymarket trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]';
+        'pandora [--output table|json] polymarket trade --condition-id <id>|--slug <slug>|--token-id <id> --token yes|no --amount-usdc <n> --dry-run|--execute [--side buy|sell] [--polymarket-host <url>] [--timeout-ms <ms>] [--rpc-url <url>] [--private-key <hex>] [--funder <address>]';
       if (context.outputMode === 'json') {
         emitSuccess(context.outputMode, 'polymarket.trade.help', commandHelpPayload(usage));
       } else {
@@ -9862,7 +9868,7 @@ async function runPolymarketCommand(args, context) {
     if (!tokenId) {
       market = await resolvePolymarketMarket({
         host: options.host || process.env.POLYMARKET_HOST || null,
-        timeoutMs: DEFAULT_INDEXER_TIMEOUT_MS,
+        timeoutMs: options.timeoutMs,
         marketId: options.conditionId,
         slug: options.slug,
       });
@@ -10126,38 +10132,47 @@ async function runSuggestCommand(args, context) {
   maybeLoadIndexerEnv(shared);
   const indexerUrl = resolveIndexerUrl(shared.indexerUrl);
   const options = parseSuggestFlags(shared.rest);
-  const history = await fetchHistory({
-    wallet: options.wallet,
-    chainId: null,
-    marketAddress: null,
-    side: 'both',
-    status: 'all',
-    limit: 250,
-    after: null,
-    before: null,
-    orderBy: 'timestamp',
-    orderDirection: 'desc',
-    includeSeed: false,
-    indexerUrl,
-    timeoutMs: shared.timeoutMs,
-  });
-  const arbitrage = await scanArbitrage({
-    indexerUrl,
-    timeoutMs: shared.timeoutMs,
-    chainId: null,
-    venues: options.includeVenues,
-    limit: Math.max(options.count * 3, 10),
-    minSpreadPct: 3,
-    minLiquidityUsd: 1000,
-    maxCloseDiffHours: 24,
-    similarityThreshold: 0.86,
-    crossVenueOnly: true,
-    withRules: false,
-    includeSimilarity: false,
-    questionContains: null,
-    polymarketHost: null,
-    polymarketMockUrl: null,
-  });
+  let history;
+  let arbitrage;
+  try {
+    history = await fetchHistory({
+      wallet: options.wallet,
+      chainId: null,
+      marketAddress: null,
+      side: 'both',
+      status: 'all',
+      limit: 250,
+      after: null,
+      before: null,
+      orderBy: 'timestamp',
+      orderDirection: 'desc',
+      includeSeed: false,
+      indexerUrl,
+      timeoutMs: shared.timeoutMs,
+    });
+    arbitrage = await scanArbitrage({
+      indexerUrl,
+      timeoutMs: shared.timeoutMs,
+      chainId: null,
+      venues: options.includeVenues,
+      limit: Math.max(options.count * 3, 10),
+      minSpreadPct: 3,
+      minLiquidityUsd: 1000,
+      maxCloseDiffHours: 24,
+      similarityThreshold: 0.86,
+      crossVenueOnly: true,
+      withRules: false,
+      includeSimilarity: false,
+      questionContains: null,
+      polymarketHost: null,
+      polymarketMockUrl: null,
+    });
+  } catch (err) {
+    if (err && err.code) {
+      throw new CliError(err.code, err.message || 'suggest failed.', err.details);
+    }
+    throw err;
+  }
 
   const suggestions = buildSuggestions({
     wallet: options.wallet,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pandora-cli-skills",
-  "version": "1.1.18",
+  "version": "1.1.20",
   "description": "Pandora CLI & Skills",
   "main": "cli/pandora.cjs",
   "bin": {