@blockrun/franklin 3.15.72 → 3.15.74

package/dist/agent/context.js

@@ -336,12 +336,12 @@ Your training data is frozen in the past. Live-world questions MUST be answered
 
 If you find yourself about to emit one of these, stop and call the tool instead. If you don't know which ticker the user means, call ExaSearch or AskUser — never deflect.
 
-**Prediction markets (PredictionMarket).** When the user asks about real-world odds — elections, "will X happen by year-end", "Polymarket on Y", "Kalshi market for Z", "what are the odds of recession" — use **PredictionMarket** instead of guessing. Eight actions, route by intent:
+**Prediction markets (PredictionMarket).** When the user asks about real-world odds — elections, "will X happen by year-end", "Polymarket on Y", "Kalshi market for Z", "what are the odds of recession" — use **PredictionMarket** instead of guessing. Ten actions, route by intent:
 - "is there a market on X anywhere?" / unknown which platform → \`searchAll\` (\$0.005) — single call across Polymarket+Kalshi+Limitless+Opinion+Predict.Fun.
 - "what are the odds on Polymarket / Kalshi specifically" → \`searchPolymarket\` (\$0.001) and \`searchKalshi\` (\$0.001) **in parallel**; comparing implied probability across the two venues is the high-value answer.
 - "where do Polymarket and Kalshi disagree / arbitrage" → \`crossPlatform\` (\$0.005) returns pre-matched pairs.
 - "who's profitable / top traders / who should I follow on Polymarket" → \`leaderboard\` (\$0.001) — global top wallets by P&L.
-- "how is wallet 0xabc doing / show this trader's P&L / are they profitable" → \`walletProfile\` (\$0.005) with \`wallets="<address>"\` (comma-separated for batch).
+- "analyze this wallet / can I copy this trader / 复制交易 / show me their P&L AND positions" → run \`walletProfile\` + \`walletPnl\` + \`walletPositions\` IN PARALLEL with the same address. Three \$0.005 calls = full picture for \$0.015. Do NOT \`Bash\`-curl \`data-api.polymarket.com\` directly — those are paid Predexon endpoints and going around them defeats the wallet-attached architecture. If just the profile is needed: \`walletProfile\` alone (single address → /wallet/{addr}, comma-list → batch).
 - "what are smart traders betting on right now / smart money flow across markets" → \`smartActivity\` (\$0.005) — markets where high-P&L wallets are positioning.
 - "show smart money on this specific Polymarket market / this condition_id" → \`smartMoney\` (\$0.005) with \`conditionId="<condition_id>"\`.
 

package/dist/tools/prediction.d.ts

@@ -17,8 +17,12 @@
  *   crossPlatform      $0.005  matching market pairs across Polymarket+Kalshi
  *                              (the arbitrage / consensus signal)
  *   leaderboard        $0.001  global Polymarket leaderboard — top wallets by P&L
- *   walletProfile      $0.005  batch profile lookup for one or more Polymarket
- *                              wallets — P&L, positions, identity
+ *   walletProfile      $0.005  full Polymarket wallet profile (single wallet)
+ *                              or batch profiles (comma-separated wallets)
+ *   walletPnl          $0.005  P&L summary + realized P&L time series for one
+ *                              Polymarket wallet
+ *   walletPositions    $0.005  open + historical positions for one Polymarket
+ *                              wallet
  *   smartActivity      $0.005  discover markets where high-performing wallets
  *                              are active right now
  *   smartMoney         $0.005  smart-money positioning on one Polymarket

package/dist/tools/prediction.js

@@ -17,8 +17,12 @@
  *   crossPlatform      $0.005  matching market pairs across Polymarket+Kalshi
  *                              (the arbitrage / consensus signal)
  *   leaderboard        $0.001  global Polymarket leaderboard — top wallets by P&L
- *   walletProfile      $0.005  batch profile lookup for one or more Polymarket
- *                              wallets — P&L, positions, identity
+ *   walletProfile      $0.005  full Polymarket wallet profile (single wallet)
+ *                              or batch profiles (comma-separated wallets)
+ *   walletPnl          $0.005  P&L summary + realized P&L time series for one
+ *                              Polymarket wallet
+ *   walletPositions    $0.005  open + historical positions for one Polymarket
+ *                              wallet
  *   smartActivity      $0.005  discover markets where high-performing wallets
  *                              are active right now
  *   smartMoney         $0.005  smart-money positioning on one Polymarket
@@ -98,7 +102,7 @@ async function getWithPayment(path, query, ctx) {
             const errText = await response.text().catch(() => '');
             // Surface failed paid calls in the Markets-tab health summary.
             recordFetch({ provider: 'blockrun', endpoint: path, ok: false, latencyMs: Date.now() - startedAt });
-            throw new Error(`PredictionMarket ${path} failed (${response.status}): ${errText.slice(0, 200)}`);
+            throw new Error(`PredictionMarket ${path} failed (${response.status}): ${errText.slice(0, 600)}`);
         }
         recordFetch({
             provider: 'blockrun',
@@ -186,11 +190,18 @@ function formatUsd(value) {
         return `$${(n / 1e3).toFixed(1)}K`;
     return `$${n.toFixed(2)}`;
 }
+function formatQuantity(value) {
+    const n = asNumber(value);
+    if (n == null)
+        return String(value ?? 'n/a');
+    return Number.isInteger(n) ? n.toLocaleString() : n.toLocaleString(undefined, { maximumFractionDigits: 4 });
+}
 function formatPct(value, digits = 1) {
     const n = asNumber(value);
     if (n == null)
         return 'n/a';
-    return `${(n * 100).toFixed(digits)}%`;
+    const pct = Math.abs(n) > 1 ? n : n * 100;
+    return `${pct.toFixed(digits)}%`;
 }
 // API responses sometimes come wrapped as `{data: [...], pagination: ...}`,
 // other times as a bare array. Normalise to an array.
@@ -207,15 +218,23 @@ function unwrapList(raw) {
             return obj.pairs;
         if (Array.isArray(obj.results))
             return obj.results;
+        if (Array.isArray(obj.positions))
+            return obj.positions;
     }
     return [];
 }
+function parseWalletsInput(value) {
+    return value
+        .split(',')
+        .map(w => w.trim())
+        .filter(Boolean);
+}
 async function execute(input, ctx) {
-    const { action, search, status, sort, limit, conditionId, wallets } = input;
+    const { action, search, status, sort, limit, conditionId, wallets, granularity } = input;
     const cappedLimit = Math.min(Math.max(1, limit ?? DEFAULT_LIMIT), MAX_LIMIT);
     if (!action) {
         return {
-            output: 'Error: action is required (searchAll | searchPolymarket | searchKalshi | crossPlatform | leaderboard | walletProfile | smartActivity | smartMoney)',
+            output: 'Error: action is required (searchAll | searchPolymarket | searchKalshi | crossPlatform | leaderboard | walletProfile | walletPnl | walletPositions | smartActivity | smartMoney)',
             isError: true,
         };
     }
@@ -225,8 +244,12 @@ async function execute(input, ctx) {
                 // One $0.005 call across 5 platforms — Polymarket, Kalshi, Limitless,
                 // Opinion, Predict.Fun. The right entry point for "is there a market
                 // on X anywhere?" — beats firing per-platform searches in parallel.
+                // Predexon expects `q` for the search term — verified 2026-05-06 from
+                // a live 422: {"detail":[{"type":"missing","loc":["query","q"]}]}.
+                // Public input field stays `search` for ergonomic consistency with
+                // searchPolymarket / searchKalshi; rename on the wire.
                 const raw = await getWithPayment('/v1/pm/markets/search', {
-                    search,
+                    q: search,
                     status,
                     sort,
                     limit: cappedLimit,
@@ -332,17 +355,33 @@ async function execute(input, ctx) {
                         isError: true,
                     };
                 }
-                // Predexon's batch endpoint expects the query param `addresses`,
-                // NOT `wallets` — verified 2026-05-06 from a live 422 in a real
-                // user session: `{"detail":[{"type":"missing","loc":["query",
-                // "addresses"]}]}`. The 3.15.70 ship guessed the param name from
-                // the openapi description ("Batch retrieve wallet profiles") and
-                // got it wrong. Public field stays `wallets` for ergonomics —
-                // we just rename on the wire.
-                const raw = await getWithPayment('/v1/pm/polymarket/wallets/profiles', {
-                    addresses: wallets.trim(),
-                }, ctx);
-                const profiles = unwrapList(raw);
+                // Smart dispatch: a single wallet → /wallet/{addr} (full profile,
+                // labels, scores, stats); a comma-list → /wallets/profiles (batch).
+                // The 3.15.70 ship hit the BATCH endpoint for everything and got 422
+                // for the single-wallet case; the gateway team confirmed 2026-05-06
+                // the right surface for "analyze this trader" is the path-parameter
+                // single-wallet endpoint, not the batch query-param one.
+                const parsedWallets = parseWalletsInput(wallets);
+                if (parsedWallets.length === 0) {
+                    return {
+                        output: 'Error: `wallets` must include at least one Polymarket wallet address',
+                        isError: true,
+                    };
+                }
+                const list = parsedWallets.join(',');
+                const isBatch = parsedWallets.length > 1;
+                const raw = isBatch
+                    ? await getWithPayment('/v1/pm/polymarket/wallets/profiles', {
+                        addresses: list,
+                    }, ctx)
+                    : await getWithPayment(`/v1/pm/polymarket/wallet/${encodeURIComponent(list)}`, {}, ctx);
+                // Single-wallet path returns a single profile object; batch returns
+                // an array (or {data:[]}). unwrapList handles the batch shape but
+                // returns [] for a bare object — wrap explicitly so the formatter
+                // below sees the single profile.
+                const profiles = isBatch
+                    ? unwrapList(raw)
+                    : (raw && typeof raw === 'object' ? [raw] : []);
                 if (profiles.length === 0) {
                     return { output: `No profile data returned for: ${wallets}` };
                 }
@@ -379,11 +418,124 @@ async function execute(input, ctx) {
                 lines.push('', `_$0.005 paid via x402._`);
                 return { output: lines.join('\n') };
             }
+            case 'walletPnl': {
+                // Single-wallet P&L summary + time series.
+                // Predexon path: /v1/pm/polymarket/wallet/pnl/{wallet} — Tier 2 ($0.005).
+                if (!wallets || !wallets.trim()) {
+                    return {
+                        output: 'Error: `wallets` is required for walletPnl (single Polymarket wallet address)',
+                        isError: true,
+                    };
+                }
+                const parsedWallets = parseWalletsInput(wallets);
+                if (parsedWallets.length !== 1) {
+                    return {
+                        output: 'Error: walletPnl accepts exactly one wallet address. For multiple wallets, call walletPnl once per address in parallel.',
+                        isError: true,
+                    };
+                }
+                const wallet = parsedWallets[0];
+                // Predexon requires `granularity` from the enum {day, week, month,
+                // year, all} — verified 2026-05-06 in two live 422 turns. Default
+                // `day`; agent can override via input field for longer aggregations.
+                const raw = await getWithPayment(`/v1/pm/polymarket/wallet/pnl/${encodeURIComponent(wallet)}`, { granularity: granularity ?? 'day' }, ctx);
+                if (!raw || typeof raw !== 'object') {
+                    return { output: `No P&L data returned for ${wallet}` };
+                }
+                const data = raw;
+                const realized = data.realized_pnl ?? data.realizedPnl ?? data.total_pnl ?? data.pnl;
+                const unrealized = data.unrealized_pnl ?? data.unrealizedPnl;
+                const total = data.total_value ?? data.totalValue ?? data.equity;
+                const volume = data.volume ?? data.total_volume;
+                const winRate = data.win_rate ?? data.winRate;
+                const w = wallet.length > 12 ? `${wallet.slice(0, 8)}…${wallet.slice(-4)}` : wallet;
+                const lines = [`## Polymarket wallet P&L — \`${w}\``, ''];
+                const summary = [];
+                if (realized != null)
+                    summary.push(`realized ${formatUsd(realized)}`);
+                if (unrealized != null)
+                    summary.push(`unrealized ${formatUsd(unrealized)}`);
+                if (total != null)
+                    summary.push(`equity ${formatUsd(total)}`);
+                if (volume != null)
+                    summary.push(`vol ${formatUsd(volume)}`);
+                if (winRate != null)
+                    summary.push(`win ${formatPct(winRate, 0)}`);
+                if (summary.length > 0)
+                    lines.push(summary.join(' · '));
+                // Optional time series — show recent points compactly if present.
+                const series = (data.series ?? data.history ?? data.daily);
+                if (Array.isArray(series) && series.length > 0) {
+                    lines.push('', `**Recent points** (latest ${Math.min(7, series.length)}):`);
+                    series.slice(-7).forEach(pt => {
+                        const t = (pt.date ?? pt.ts ?? pt.timestamp);
+                        const v = (pt.pnl ?? pt.value ?? pt.cumulative_pnl);
+                        if (t != null && v != null) {
+                            const tStr = typeof t === 'number' ? new Date(t).toISOString().slice(0, 10) : String(t).slice(0, 10);
+                            lines.push(`- ${tStr} · ${formatUsd(v)}`);
+                        }
+                    });
+                }
+                lines.push('', `_$0.005 paid via x402._`);
+                return { output: lines.join('\n') };
+            }
+            case 'walletPositions': {
+                // Single-wallet positions (open + historical).
+                // Predexon path: /v1/pm/polymarket/wallet/positions/{wallet} — Tier 2 ($0.005).
+                if (!wallets || !wallets.trim()) {
+                    return {
+                        output: 'Error: `wallets` is required for walletPositions (single Polymarket wallet address)',
+                        isError: true,
+                    };
+                }
+                const parsedWallets = parseWalletsInput(wallets);
+                if (parsedWallets.length !== 1) {
+                    return {
+                        output: 'Error: walletPositions accepts exactly one wallet address. For multiple wallets, call walletPositions once per address in parallel.',
+                        isError: true,
+                    };
+                }
+                const wallet = parsedWallets[0];
+                const raw = await getWithPayment(`/v1/pm/polymarket/wallet/positions/${encodeURIComponent(wallet)}`, { limit: cappedLimit }, ctx);
+                const positions = unwrapList(raw);
+                if (positions.length === 0) {
+                    return { output: `No positions returned for ${wallet}` };
+                }
+                const w = wallet.length > 12 ? `${wallet.slice(0, 8)}…${wallet.slice(-4)}` : wallet;
+                const lines = [
+                    `## Polymarket positions — \`${w}\` — ${positions.length} position${positions.length === 1 ? '' : 's'}`,
+                    '',
+                ];
+                positions.slice(0, cappedLimit).forEach((p, i) => {
+                    const title = (p.title || p.market || p.question || p.market_slug || 'untitled');
+                    const outcome = (p.outcome || p.side);
+                    const size = p.size ?? p.shares ?? p.quantity;
+                    const avgPrice = p.avg_price ?? p.avgPrice ?? p.average_price;
+                    const currentValue = p.current_value ?? p.currentValue ?? p.value;
+                    const pnl = p.pnl ?? p.unrealized_pnl ?? p.realized_pnl;
+                    const pnlPct = p.pnl_pct ?? p.pnlPct ?? p.percent_pnl;
+                    const parts = [];
+                    if (outcome)
+                        parts.push(outcome);
+                    if (size != null)
+                        parts.push(`size ${formatQuantity(size)}`);
+                    if (avgPrice != null)
+                        parts.push(`avg ${formatPct(avgPrice)}`);
+                    if (currentValue != null)
+                        parts.push(`now ${formatUsd(currentValue)}`);
+                    if (pnl != null) {
+                        const pctStr = pnlPct != null ? ` (${formatPct(pnlPct, 1)})` : '';
+                        parts.push(`P&L ${formatUsd(pnl)}${pctStr}`);
+                    }
+                    lines.push(`${i + 1}. **${title}** — ${parts.join(' · ')}`);
+                });
+                lines.push('', `_$0.005 paid via x402._`);
+                return { output: lines.join('\n') };
+            }
             case 'smartActivity': {
                 // "Discover markets where high-performing wallets are active right now."
-                // Replaces the old `smartMoney` action (which hit a non-existent path
-                // /v1/pm/polymarket/market/<id>/smart-money — silently 404'd from
-                // launch). Verified 2026-05-05 against blockrun.ai/openapi.json.
+                // Complements `smartMoney`: this discovers interesting markets across
+                // the venue; smartMoney drills into one condition_id.
                 const raw = await getWithPayment('/v1/pm/polymarket/markets/smart-activity', {
                     limit: cappedLimit,
                     search,
@@ -537,7 +689,7 @@ async function execute(input, ctx) {
             }
             default:
                 return {
-                    output: `Error: unknown action "${action}". Use: searchAll, searchPolymarket, searchKalshi, crossPlatform, leaderboard, walletProfile, smartActivity, smartMoney`,
+                    output: `Error: unknown action "${action}". Use: searchAll, searchPolymarket, searchKalshi, crossPlatform, leaderboard, walletProfile, walletPnl, walletPositions, smartActivity, smartMoney`,
                     isError: true,
                 };
         }
@@ -556,13 +708,15 @@ export const predictionMarketCapability = {
             '`searchKalshi` (Kalshi only, supports sort+status — $0.001), ' +
             '`crossPlatform` (matched market pairs across Polymarket+Kalshi for arbitrage / consensus — $0.005), ' +
             '`leaderboard` (global top wallets by P&L on Polymarket — $0.001), ' +
-            '`walletProfile` (P&L + positions for one or more Polymarket wallets — $0.005), ' +
+            '`walletProfile` (full Polymarket wallet profile — labels, scores, stats. Single address → /wallet/{addr}; comma-list → batch /wallets/profiles — $0.005), ' +
+            '`walletPnl` (single Polymarket wallet P&L summary + time series — $0.005), ' +
+            '`walletPositions` (single Polymarket wallet positions — open + historical with P&L per position — $0.005), ' +
             '`smartActivity` (markets where high-P&L wallets are positioning right now — $0.005), ' +
             '`smartMoney` (smart-money positioning on one Polymarket condition_id — $0.005). ' +
             'Default routing: ' +
             '"is there a market on X anywhere" → searchAll. ' +
             '"top wallets / who is profitable / who should I follow on Polymarket" → leaderboard. ' +
-            '"how is wallet 0xabc doing / show me their P&L" → walletProfile with that address. ' +
+            '"analyze this wallet / can I copy this trader / 复制交易 / show me their P&L AND positions" → run walletProfile + walletPnl + walletPositions IN PARALLEL with the same address — three $0.005 calls give the full picture for $0.015. Do not Bash-curl Polymarket directly; the agent has paid tools for this. ' +
             '"what are smart traders betting on right now" → smartActivity. ' +
             '"show smart money on this specific Polymarket market" → smartMoney with conditionId. ' +
             '"should I bet on X" → run searchPolymarket + searchKalshi in parallel and compare implied probabilities — divergence is the signal.',
@@ -578,6 +732,8 @@ export const predictionMarketCapability = {
                         'crossPlatform',
                         'leaderboard',
                         'walletProfile',
+                        'walletPnl',
+                        'walletPositions',
                         'smartActivity',
                         'smartMoney',
                     ],
@@ -585,7 +741,7 @@ export const predictionMarketCapability = {
                 },
                 search: {
                     type: 'string',
-                    description: 'Search query. Used by searchAll / searchPolymarket / searchKalshi / smartActivity. Optional for crossPlatform/leaderboard/walletProfile/smartMoney.',
+                    description: 'Search query. Used by searchAll / searchPolymarket / searchKalshi / smartActivity. Optional for crossPlatform/leaderboard/walletProfile/walletPnl/walletPositions/smartMoney.',
                 },
                 status: {
                     type: 'string',
@@ -607,6 +763,11 @@ export const predictionMarketCapability = {
                     type: 'string',
                     description: 'For smartMoney: Polymarket condition_id from searchPolymarket or smartActivity.',
                 },
+                granularity: {
+                    type: 'string',
+                    enum: ['day', 'week', 'month', 'year', 'all'],
+                    description: 'For walletPnl: time bucket for the P&L series. Default day.',
+                },
             },
             required: ['action'],
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/franklin",
-  "version": "3.15.72",
+  "version": "3.15.74",
   "description": "Franklin — The AI agent with a wallet. Spends USDC autonomously to get real work done. Pay per action, no subscriptions.",
   "type": "module",
   "exports": {