zframes 0.4.0 → 0.5.0

package/dist/index.js

@@ -9,6 +9,10 @@ function catalogueForAI(input) {
   const metas = input instanceof Map ? [...input.values()] : [...input];
   return metas.map((meta) => ({
     name: meta.name,
+    // The frame's default card title. An instance that omits `title` renders
+    // this, so the agent should leave `title` unset unless it wants a custom
+    // label — never re-state the default or hand-author an abbreviation.
+    label: meta.label,
     category: meta.category,
     description: meta.description,
     iconUrl: meta.iconUrl,
@@ -55,7 +59,7 @@ var FrameInstanceSchema = z2.object({
   id: z2.string().describe("Unique instance id within the dashboard"),
   frame: z2.string().describe("Name of a registered frame"),
   title: z2.string().optional().describe(
-    `Card title shown in the frame's chrome. Overrides the default (the frame type name) \u2014 set a meaningful per-instance label, e.g. the ticker on a price-chart ("TSLA"). Ignored by chrome-less frames like heading.`
+    'Optional custom card title. Omit it to use the frame\'s own polished default label (its catalogue `label`, e.g. "OI by Strike") \u2014 that is the norm. Only set this for a genuinely instance-specific label the default can\'t know, e.g. the ticker on a price-chart ("TSLA") or which outlet a news-feed shows. Never abbreviate. Ignored by chrome-less frames like heading.'
   ),
   position: GridPositionSchema,
   layouts: z2.record(z2.string(), GridPositionSchema).optional().describe(
@@ -426,6 +430,7 @@ var SOURCES = {
 };
 var clockMeta = defineFrameMeta({
   name: "clock",
+  label: "Clock",
   category: "tools",
   iconUrl: widgetIcon("clock"),
   layout: { w: 3, h: 2, minW: 2, minH: 1 },
@@ -451,6 +456,7 @@ var clockMeta = defineFrameMeta({
 });
 var marketHoursMeta = defineFrameMeta({
   name: "market-hours",
+  label: "Market Hours",
   category: "tools",
   iconUrl: widgetIcon("market-hours"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -467,6 +473,7 @@ var marketHoursMeta = defineFrameMeta({
 });
 var fearGreedMeta = defineFrameMeta({
   name: "fear-greed",
+  label: "Fear & Greed",
   category: "sentiment",
   iconUrl: widgetIcon("fear-greed"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -479,6 +486,7 @@ var fearGreedMeta = defineFrameMeta({
 });
 var fundingRateChartMeta = defineFrameMeta({
   name: "funding-rate-chart",
+  label: "Funding Rate Chart",
   category: "derivatives",
   iconUrl: widgetIcon("funding-rate-chart"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -494,6 +502,7 @@ var fundingRateChartMeta = defineFrameMeta({
 });
 var noteMeta = defineFrameMeta({
   name: "note",
+  label: "Note",
   category: "layout",
   iconUrl: widgetIcon("note"),
   layout: { w: 4, h: 3, minW: 2, minH: 2 },
@@ -506,6 +515,7 @@ var noteMeta = defineFrameMeta({
 });
 var priceChartMeta = defineFrameMeta({
   name: "price-chart",
+  label: "Price Chart",
   category: "markets",
   iconUrl: widgetIcon("price-chart"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -523,6 +533,7 @@ var priceChartMeta = defineFrameMeta({
 });
 var priceLivelineMeta = defineFrameMeta({
   name: "price-liveline",
+  label: "Price Liveline",
   category: "markets",
   iconUrl: widgetIcon("price-liveline"),
   layout: { w: 6, h: 3, minW: 4, minH: 2 },
@@ -543,6 +554,7 @@ var priceLivelineMeta = defineFrameMeta({
 });
 var priceTickerMeta = defineFrameMeta({
   name: "price-ticker",
+  label: "Price Ticker",
   category: "markets",
   iconUrl: widgetIcon("price-ticker"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -557,6 +569,7 @@ var priceTickerMeta = defineFrameMeta({
 });
 var topMoversMeta = defineFrameMeta({
   name: "top-movers",
+  label: "Top Movers",
   category: "markets",
   iconUrl: widgetIcon("top-movers"),
   layout: { w: 5, h: 3, minW: 3, minH: 3 },
@@ -569,6 +582,7 @@ var topMoversMeta = defineFrameMeta({
 });
 var tvlTreemapMeta = defineFrameMeta({
   name: "tvl-treemap",
+  label: "TVL Treemap",
   category: "crypto",
   iconUrl: widgetIcon("tvl-treemap"),
   layout: { w: 6, h: 4, minW: 3, minH: 3 },
@@ -581,6 +595,7 @@ var tvlTreemapMeta = defineFrameMeta({
 });
 var bitcoinDominanceMeta = defineFrameMeta({
   name: "bitcoin-dominance",
+  label: "Bitcoin Dominance",
   category: "crypto",
   iconUrl: widgetIcon("bitcoin-dominance"),
   layout: { w: 4, h: 2, minW: 3, minH: 2 },
@@ -595,6 +610,7 @@ var bitcoinDominanceMeta = defineFrameMeta({
 });
 var ratesBoardMeta = defineFrameMeta({
   name: "rates-board",
+  label: "Rates Board",
   category: "macro",
   iconUrl: widgetIcon("rates-board"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -611,6 +627,7 @@ var ratesBoardMeta = defineFrameMeta({
 });
 var fxBoardMeta = defineFrameMeta({
   name: "fx-board",
+  label: "FX Board",
   category: "macro",
   iconUrl: widgetIcon("fx-board"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -629,6 +646,7 @@ var fxBoardMeta = defineFrameMeta({
 });
 var inflationPulseMeta = defineFrameMeta({
   name: "inflation-pulse",
+  label: "Inflation Pulse",
   category: "macro",
   iconUrl: widgetIcon("inflation-pulse"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -641,6 +659,7 @@ var inflationPulseMeta = defineFrameMeta({
 });
 var financialStressMeta = defineFrameMeta({
   name: "financial-stress",
+  label: "Financial Stress",
   category: "macro",
   iconUrl: widgetIcon("financial-stress"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -656,6 +675,7 @@ var financialStressMeta = defineFrameMeta({
 });
 var nationalDebtMeta = defineFrameMeta({
   name: "national-debt",
+  label: "National Debt",
   category: "macro",
   iconUrl: widgetIcon("national-debt"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -673,6 +693,7 @@ var nationalDebtMeta = defineFrameMeta({
 });
 var laborMarketMeta = defineFrameMeta({
   name: "labor-market",
+  label: "Labor Market",
   category: "macro",
   iconUrl: widgetIcon("labor-market"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -685,6 +706,7 @@ var laborMarketMeta = defineFrameMeta({
 });
 var treasuryAuctionsMeta = defineFrameMeta({
   name: "treasury-auctions",
+  label: "Treasury Auctions",
   category: "macro",
   iconUrl: widgetIcon("treasury-auctions"),
   layout: { w: 5, h: 4, minW: 3, minH: 3 },
@@ -697,6 +719,7 @@ var treasuryAuctionsMeta = defineFrameMeta({
 });
 var filingsFeedMeta = defineFrameMeta({
   name: "filings-feed",
+  label: "Filings Feed",
   category: "equities",
   iconUrl: widgetIcon("filings-feed"),
   layout: { w: 5, h: 4, minW: 3, minH: 3 },
@@ -715,6 +738,7 @@ var filingsFeedMeta = defineFrameMeta({
 });
 var yieldCurveMeta = defineFrameMeta({
   name: "yield-curve",
+  label: "Yield Curve",
   category: "macro",
   iconUrl: widgetIcon("yield-curve"),
   layout: { w: 4, h: 3, minW: 3, minH: 3 },
@@ -745,6 +769,7 @@ var yieldCurveMeta = defineFrameMeta({
 });
 var fundamentalsMeta = defineFrameMeta({
   name: "fundamentals",
+  label: "Fundamentals",
   category: "equities",
   iconUrl: widgetIcon("fundamentals"),
   layout: { w: 4, h: 3, minW: 3, minH: 3 },
@@ -759,6 +784,7 @@ var fundamentalsMeta = defineFrameMeta({
 });
 var shortVolumeMeta = defineFrameMeta({
   name: "short-volume",
+  label: "Short Volume",
   category: "equities",
   iconUrl: widgetIcon("short-volume"),
   layout: { w: 5, h: 4, minW: 3, minH: 3 },
@@ -776,6 +802,7 @@ var shortVolumeMeta = defineFrameMeta({
 });
 var fundingHeatmapMeta = defineFrameMeta({
   name: "funding-heatmap",
+  label: "Funding Heatmap",
   category: "derivatives",
   iconUrl: widgetIcon("funding-heatmap"),
   layout: { w: 6, h: 3, minW: 4, minH: 3 },
@@ -790,6 +817,7 @@ var fundingHeatmapMeta = defineFrameMeta({
 });
 var dinoGameMeta = defineFrameMeta({
   name: "dino-game",
+  label: "Dino Game",
   category: "games",
   iconUrl: widgetIcon("dino-game"),
   layout: { w: 4, h: 3, minW: 3, minH: 3 },
@@ -799,6 +827,7 @@ var dinoGameMeta = defineFrameMeta({
 });
 var imageMeta = defineFrameMeta({
   name: "image",
+  label: "Image",
   category: "layout",
   iconUrl: widgetIcon("image"),
   layout: { w: 3, h: 3, minW: 1, minH: 1 },
@@ -814,6 +843,7 @@ var imageMeta = defineFrameMeta({
 });
 var headingMeta = defineFrameMeta({
   name: "heading",
+  label: "Heading",
   category: "layout",
   iconUrl: widgetIcon("heading"),
   layout: { w: 12, h: 1, minW: 2, minH: 1, maxH: 1 },
@@ -827,6 +857,7 @@ var headingMeta = defineFrameMeta({
 });
 var dailyAnalysisMeta = defineFrameMeta({
   name: "daily-analysis",
+  label: "Daily Analysis",
   category: "tools",
   iconUrl: widgetIcon("daily-analysis"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -846,6 +877,7 @@ var dailyAnalysisMeta = defineFrameMeta({
 });
 var journalLogMeta = defineFrameMeta({
   name: "journal-log",
+  label: "Journal \xB7 Log",
   category: "journal",
   iconUrl: widgetIcon("journal-log"),
   layout: { w: 4, h: 5, minW: 3, minH: 4 },
@@ -856,6 +888,7 @@ var journalLogMeta = defineFrameMeta({
 });
 var journalOpenMeta = defineFrameMeta({
   name: "journal-open",
+  label: "Journal \xB7 Open",
   category: "journal",
   iconUrl: widgetIcon("journal-open"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -868,6 +901,7 @@ var journalOpenMeta = defineFrameMeta({
 });
 var journalResultsMeta = defineFrameMeta({
   name: "journal-results",
+  label: "Journal \xB7 Results",
   category: "journal",
   iconUrl: widgetIcon("journal-results"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -879,6 +913,7 @@ var journalResultsMeta = defineFrameMeta({
 });
 var journalScoreMeta = defineFrameMeta({
   name: "journal-score",
+  label: "Journal \xB7 Scoreboard",
   category: "journal",
   iconUrl: widgetIcon("journal-score"),
   layout: { w: 4, h: 2, minW: 3, minH: 2 },
@@ -888,6 +923,7 @@ var journalScoreMeta = defineFrameMeta({
 });
 var priceCompareMeta = defineFrameMeta({
   name: "price-compare",
+  label: "Price Compare",
   category: "markets",
   iconUrl: widgetIcon("price-compare"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -914,6 +950,7 @@ var portfolioConfigShape = {
 };
 var portfolioValueMeta = defineFrameMeta({
   name: "portfolio-value",
+  label: "Portfolio Value",
   category: "portfolio",
   iconUrl: widgetIcon("portfolio-value"),
   layout: { w: 5, h: 4, minW: 3, minH: 3 },
@@ -929,6 +966,7 @@ var portfolioValueMeta = defineFrameMeta({
 });
 var portfolioAllocationMeta = defineFrameMeta({
   name: "portfolio-allocation",
+  label: "Portfolio Allocation",
   category: "portfolio",
   iconUrl: widgetIcon("portfolio-allocation"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -939,6 +977,7 @@ var portfolioAllocationMeta = defineFrameMeta({
 });
 var portfolioHoldingsMeta = defineFrameMeta({
   name: "portfolio-holdings",
+  label: "Portfolio Holdings",
   category: "portfolio",
   iconUrl: widgetIcon("portfolio-holdings"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -949,6 +988,7 @@ var portfolioHoldingsMeta = defineFrameMeta({
 });
 var newsFeedMeta = defineFrameMeta({
   name: "news-feed",
+  label: "News Feed",
   category: "sentiment",
   iconUrl: widgetIcon("news-feed"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -973,6 +1013,7 @@ var newsFeedMeta = defineFrameMeta({
 });
 var dexVolumeTreemapMeta = defineFrameMeta({
   name: "dex-volume-treemap",
+  label: "DEX Volume Treemap",
   category: "crypto",
   iconUrl: widgetIcon("dex-volume-treemap"),
   layout: { w: 6, h: 4, minW: 3, minH: 3 },
@@ -985,6 +1026,7 @@ var dexVolumeTreemapMeta = defineFrameMeta({
 });
 var dexVolumeChartMeta = defineFrameMeta({
   name: "dex-volume-chart",
+  label: "DEX Volume Chart",
   category: "crypto",
   iconUrl: widgetIcon("dex-volume-chart"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -1000,6 +1042,7 @@ var dexVolumeChartMeta = defineFrameMeta({
 });
 var protocolTvlTreemapMeta = defineFrameMeta({
   name: "protocol-tvl-treemap",
+  label: "Protocol TVL Treemap",
   category: "crypto",
   iconUrl: widgetIcon("protocol-tvl-treemap"),
   layout: { w: 6, h: 4, minW: 3, minH: 3 },
@@ -1012,6 +1055,7 @@ var protocolTvlTreemapMeta = defineFrameMeta({
 });
 var protocolTvlChartMeta = defineFrameMeta({
   name: "protocol-tvl-chart",
+  label: "Protocol TVL Chart",
   category: "crypto",
   iconUrl: widgetIcon("protocol-tvl-chart"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -1027,6 +1071,7 @@ var protocolTvlChartMeta = defineFrameMeta({
 });
 var protocolFeesTreemapMeta = defineFrameMeta({
   name: "protocol-fees-treemap",
+  label: "Protocol Fees Treemap",
   category: "crypto",
   iconUrl: widgetIcon("protocol-fees-treemap"),
   layout: { w: 6, h: 4, minW: 3, minH: 3 },
@@ -1039,6 +1084,7 @@ var protocolFeesTreemapMeta = defineFrameMeta({
 });
 var marketCapTreemapMeta = defineFrameMeta({
   name: "market-cap-treemap",
+  label: "Market Cap Treemap",
   category: "crypto",
   iconUrl: widgetIcon("market-cap-treemap"),
   layout: { w: 6, h: 4, minW: 3, minH: 3 },
@@ -1053,6 +1099,7 @@ var marketCapTreemapMeta = defineFrameMeta({
 });
 var openInterestMeta = defineFrameMeta({
   name: "open-interest",
+  label: "Open Interest",
   category: "derivatives",
   iconUrl: widgetIcon("open-interest"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -1067,6 +1114,7 @@ var openInterestMeta = defineFrameMeta({
 });
 var snakeMeta = defineFrameMeta({
   name: "snake",
+  label: "Snake",
   category: "games",
   iconUrl: widgetIcon("snake"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -1076,6 +1124,7 @@ var snakeMeta = defineFrameMeta({
 });
 var flappyBirdMeta = defineFrameMeta({
   name: "flappy-bird",
+  label: "Flappy Bird",
   category: "games",
   iconUrl: widgetIcon("flappy-bird"),
   layout: { w: 4, h: 4, minW: 3, minH: 3 },
@@ -1085,6 +1134,7 @@ var flappyBirdMeta = defineFrameMeta({
 });
 var videoMeta = defineFrameMeta({
   name: "video",
+  label: "Video",
   category: "layout",
   iconUrl: widgetIcon("video"),
   layout: { w: 4, h: 3, minW: 2, minH: 2 },
@@ -1099,6 +1149,7 @@ var videoMeta = defineFrameMeta({
 });
 var drawdyMeta = defineFrameMeta({
   name: "drawdy",
+  label: "Drawdy",
   category: "layout",
   iconUrl: widgetIcon("drawdy"),
   layout: { w: 8, h: 6, minW: 2, minH: 2 },
@@ -1108,6 +1159,7 @@ var drawdyMeta = defineFrameMeta({
 });
 var countdownMeta = defineFrameMeta({
   name: "countdown",
+  label: "Countdown",
   category: "tools",
   iconUrl: widgetIcon("countdown"),
   layout: { w: 3, h: 2, minW: 2, minH: 1 },
@@ -1125,6 +1177,7 @@ var countdownMeta = defineFrameMeta({
 });
 var linkGridMeta = defineFrameMeta({
   name: "link-grid",
+  label: "Quick Links",
   category: "tools",
   iconUrl: widgetIcon("link-grid"),
   layout: { w: 3, h: 2, minW: 2, minH: 1 },
@@ -1156,6 +1209,7 @@ var linkGridMeta = defineFrameMeta({
 });
 var calculatorMeta = defineFrameMeta({
   name: "calculator",
+  label: "Position Calculator",
   category: "tools",
   iconUrl: widgetIcon("calculator"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -1173,6 +1227,7 @@ var calculatorMeta = defineFrameMeta({
 });
 var quoteMeta = defineFrameMeta({
   name: "quote",
+  label: "Quote",
   category: "layout",
   iconUrl: widgetIcon("quote"),
   layout: { w: 4, h: 2, minW: 2, minH: 1 },
@@ -1193,6 +1248,7 @@ var quoteMeta = defineFrameMeta({
 });
 var dividerMeta = defineFrameMeta({
   name: "divider",
+  label: "Divider",
   category: "layout",
   iconUrl: widgetIcon("divider"),
   layout: { w: 12, h: 1, minW: 1, minH: 1 },
@@ -1211,6 +1267,7 @@ var dividerMeta = defineFrameMeta({
 });
 var diceMeta = defineFrameMeta({
   name: "dice",
+  label: "Dice",
   category: "tools",
   iconUrl: widgetIcon("dice"),
   layout: { w: 2, h: 2, minW: 1, minH: 1 },
@@ -1226,6 +1283,7 @@ var diceMeta = defineFrameMeta({
 });
 var riskRewardMeta = defineFrameMeta({
   name: "risk-reward",
+  label: "Risk / Reward",
   category: "tools",
   iconUrl: widgetIcon("risk-reward"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -1243,6 +1301,7 @@ var riskRewardMeta = defineFrameMeta({
 });
 var marqueeMeta = defineFrameMeta({
   name: "marquee",
+  label: "Marquee",
   category: "layout",
   iconUrl: widgetIcon("marquee"),
   layout: { w: 6, h: 1, minW: 2, minH: 1 },
@@ -1257,6 +1316,7 @@ var marqueeMeta = defineFrameMeta({
 });
 var stopwatchMeta = defineFrameMeta({
   name: "stopwatch",
+  label: "Stopwatch",
   layout: { w: 3, h: 2, minW: 2, minH: 1 },
   category: "tools",
   iconUrl: widgetIcon("stopwatch"),
@@ -1274,6 +1334,7 @@ var stopwatchMeta = defineFrameMeta({
 });
 var sessionProgressMeta = defineFrameMeta({
   name: "session-progress",
+  label: "Session Progress",
   category: "tools",
   iconUrl: widgetIcon("session-progress"),
   layout: { w: 3, h: 2, minW: 2, minH: 1 },
@@ -1287,6 +1348,7 @@ var sessionProgressMeta = defineFrameMeta({
 });
 var holidayCalendarMeta = defineFrameMeta({
   name: "holiday-calendar",
+  label: "Holiday Calendar",
   category: "tools",
   iconUrl: widgetIcon("holiday-calendar"),
   layout: { w: 3, h: 4, minW: 2, minH: 2 },
@@ -1300,6 +1362,7 @@ var holidayCalendarMeta = defineFrameMeta({
 });
 var dayMeterMeta = defineFrameMeta({
   name: "day-meter",
+  label: "Day Meter",
   category: "tools",
   iconUrl: widgetIcon("day-meter"),
   layout: { w: 4, h: 2, minW: 2, minH: 1 },
@@ -1315,6 +1378,7 @@ var dayMeterMeta = defineFrameMeta({
 });
 var returnsProjectorMeta = defineFrameMeta({
   name: "returns-projector",
+  label: "Returns Projector",
   category: "tools",
   iconUrl: widgetIcon("returns-projector"),
   layout: { w: 3, h: 4, minW: 2, minH: 3 },
@@ -1330,6 +1394,7 @@ var returnsProjectorMeta = defineFrameMeta({
 });
 var breakevenMeta = defineFrameMeta({
   name: "breakeven",
+  label: "Break-even",
   category: "tools",
   iconUrl: widgetIcon("breakeven"),
   layout: { w: 3, h: 4, minW: 2, minH: 2 },
@@ -1352,6 +1417,7 @@ var breakevenMeta = defineFrameMeta({
 });
 var checklistMeta = defineFrameMeta({
   name: "checklist",
+  label: "Checklist",
   category: "tools",
   iconUrl: widgetIcon("checklist"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -1371,6 +1437,7 @@ var checklistMeta = defineFrameMeta({
 });
 var pomodoroMeta = defineFrameMeta({
   name: "pomodoro",
+  label: "Pomodoro",
   category: "tools",
   iconUrl: widgetIcon("pomodoro"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -1385,6 +1452,7 @@ var pomodoroMeta = defineFrameMeta({
 });
 var rulesCardMeta = defineFrameMeta({
   name: "rules-card",
+  label: "Rules",
   category: "layout",
   iconUrl: widgetIcon("rules-card"),
   layout: { w: 3, h: 3, minW: 2, minH: 2 },
@@ -1401,6 +1469,7 @@ var rulesCardMeta = defineFrameMeta({
 });
 var breathingMeta = defineFrameMeta({
   name: "breathing",
+  label: "Breathing",
   category: "layout",
   iconUrl: widgetIcon("breathing"),
   chrome: "bare",
@@ -1416,6 +1485,7 @@ var breathingMeta = defineFrameMeta({
 });
 var spotifyEmbedMeta = defineFrameMeta({
   name: "spotify-embed",
+  label: "Spotify",
   category: "layout",
   iconUrl: widgetIcon("spotify-embed"),
   layout: { w: 3, h: 4, minW: 2, minH: 2 },
@@ -1430,6 +1500,7 @@ var spotifyEmbedMeta = defineFrameMeta({
 });
 var btcFeesMeta = defineFrameMeta({
   name: "btc-fees",
+  label: "BTC Fees",
   category: "bitcoin",
   iconUrl: widgetIcon("btc-fees"),
   layout: { w: 3, h: 2, minW: 2, minH: 2 },
@@ -1444,6 +1515,7 @@ var btcFeesMeta = defineFrameMeta({
 });
 var btcMempoolMeta = defineFrameMeta({
   name: "btc-mempool",
+  label: "BTC Mempool",
   category: "bitcoin",
   iconUrl: widgetIcon("btc-mempool"),
   layout: { w: 5, h: 3, minW: 3, minH: 2 },
@@ -1458,6 +1530,7 @@ var btcMempoolMeta = defineFrameMeta({
 });
 var btcBlocksMeta = defineFrameMeta({
   name: "btc-blocks",
+  label: "BTC Blocks",
   category: "bitcoin",
   iconUrl: widgetIcon("btc-blocks"),
   layout: { w: 5, h: 4, minW: 3, minH: 3 },
@@ -1470,6 +1543,7 @@ var btcBlocksMeta = defineFrameMeta({
 });
 var btcHashrateMeta = defineFrameMeta({
   name: "btc-hashrate",
+  label: "BTC Hashrate",
   category: "bitcoin",
   iconUrl: widgetIcon("btc-hashrate"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -1482,6 +1556,7 @@ var btcHashrateMeta = defineFrameMeta({
 });
 var btcDifficultyMeta = defineFrameMeta({
   name: "btc-difficulty",
+  label: "BTC Difficulty",
   category: "bitcoin",
   iconUrl: widgetIcon("btc-difficulty"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -1496,6 +1571,7 @@ var btcDifficultyMeta = defineFrameMeta({
 });
 var miningPoolsMeta = defineFrameMeta({
   name: "mining-pools",
+  label: "Mining Pools",
   category: "bitcoin",
   iconUrl: widgetIcon("mining-pools"),
   layout: { w: 6, h: 4, minW: 3, minH: 3 },
@@ -1511,6 +1587,7 @@ var miningPoolsMeta = defineFrameMeta({
 });
 var lightningStatsMeta = defineFrameMeta({
   name: "lightning-stats",
+  label: "Lightning Network",
   category: "bitcoin",
   iconUrl: widgetIcon("lightning-stats"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -1525,6 +1602,7 @@ var lightningStatsMeta = defineFrameMeta({
 });
 var optionsPutCallMeta = defineFrameMeta({
   name: "options-put-call",
+  label: "Put / Call Ratio",
   category: "derivatives",
   iconUrl: widgetIcon("options-put-call"),
   layout: { w: 4, h: 3, minW: 3, minH: 2 },
@@ -1542,6 +1620,7 @@ var optionsPutCallMeta = defineFrameMeta({
 });
 var optionsIvMeta = defineFrameMeta({
   name: "options-iv",
+  label: "Implied Volatility",
   category: "derivatives",
   iconUrl: widgetIcon("options-iv"),
   layout: { w: 6, h: 3, minW: 3, minH: 2 },
@@ -1555,6 +1634,7 @@ var optionsIvMeta = defineFrameMeta({
 });
 var optionsOiStrikeMeta = defineFrameMeta({
   name: "options-oi-strike",
+  label: "OI by Strike",
   category: "derivatives",
   iconUrl: widgetIcon("options-oi-strike"),
   layout: { w: 6, h: 4, minW: 4, minH: 3 },
@@ -1570,6 +1650,7 @@ var optionsOiStrikeMeta = defineFrameMeta({
 });
 var coinMoversMeta = defineFrameMeta({
   name: "coin-movers",
+  label: "Coin Movers",
   category: "markets",
   iconUrl: widgetIcon("coin-movers"),
   layout: { w: 5, h: 4, minW: 3, minH: 3 },
@@ -2093,6 +2174,21 @@ function claudeDelta(line) {
   const delta = o.event?.type === "content_block_delta" ? o.event.delta : void 0;
   return delta?.type === "text_delta" && typeof delta.text === "string" ? delta.text : null;
 }
+function claudeStatus(line) {
+  const o = tryParse(line);
+  if (o?.type !== "stream_event") return null;
+  if (o.event?.type !== "content_block_start") return null;
+  const block = o.event.content_block;
+  if (block?.type !== "tool_use") return null;
+  switch (block.name) {
+    case "WebSearch":
+      return "searching the web\u2026";
+    case "WebFetch":
+      return "reading a page\u2026";
+    default:
+      return null;
+  }
+}
 function claudeResult(stdout) {
   let result = null;
   let deltas = "";
@@ -2118,15 +2214,24 @@ var RUNNERS = [
     // answer is generated; --verbose is required alongside it under -p, and
     // --include-partial-messages adds the token-level `content_block_delta`
     // events we relay live. The canonical answer is the closing `result` event.
+    // --allowedTools whitelists WebSearch/WebFetch so zAI can look up news +
+    // context; in headless -p that also KEEPS Bash/Write/Edit blocked (only
+    // allowlisted tools auto-approve), so it can search the web but can't wander
+    // the dashboard folder we run it in. Search results interleave as tool
+    // events the delta parser ignores, then the text answer streams as usual.
     buildArgs: (prompt) => [
       "-p",
       prompt,
       "--output-format",
       "stream-json",
       "--verbose",
-      "--include-partial-messages"
+      "--include-partial-messages",
+      "--allowedTools",
+      "WebSearch",
+      "WebFetch"
     ],
     parseDelta: claudeDelta,
+    parseStatus: claudeStatus,
     readResult: async (stdout) => claudeResult(stdout)
   },
   {
@@ -2136,7 +2241,12 @@ var RUNNERS = [
     // `exec` is non-interactive; read-only sandbox so a Q&A can't mutate
     // anything, and -o writes ONLY the final message to a file (stdout carries
     // session noise). --skip-git-repo-check so it runs outside a repo too.
+    // --search enables the native web_search tool for news + context (a network
+    // read, orthogonal to the read-only filesystem sandbox). It's a TOP-LEVEL
+    // codex flag, so it must precede the `exec` subcommand — after it, exec's
+    // parser rejects it as an unknown argument.
     buildArgs: (prompt, outFile) => [
+      "--search",
       "exec",
       "--skip-git-repo-check",
       "-s",
@@ -2228,13 +2338,15 @@ ${frameCatalogue}${grounding}
 
 ${transcript}Stay strictly on topic. Only answer questions about zframes itself (its frames, data, dashboard, and how to use it) and about markets and finance \u2014 stocks, crypto, prices, funding, market caps, on-chain and macro data, and the symbols on screen. If the question is about anything else (general knowledge, coding, personal advice, writing, other software, etc.), do not answer it: reply in one sentence that you only cover zframes and the markets it tracks, and invite a market or dashboard question instead.
 
-Answer the user's question in 2\u20134 sentences of plain text \u2014 no markdown headings, no preamble, no tool use, just the answer.
+You may use web search when it helps \u2014 for news, catalysts, or context not in the live readings above. Be explicit in your answer about where each fact comes from: say when a number or fact is from the live dashboard readings above versus from the web, and name the web source (e.g. "per Reuters"). For anything shown on the dashboard, treat the live readings above as the source of truth \u2014 don't override them with a web figure.
+
+Answer the user's question in 2\u20134 sentences of plain text \u2014 no markdown headings, no preamble.
 
 Question: ${question}`
   );
 }
 var askCounter = 0;
-function runAgent(runner, prompt, cwd, onDelta) {
+function runAgent(runner, prompt, cwd, onDelta, onStatus) {
   const outFile = join2(
     tmpdir(),
     `zframes-ask-${process.pid}-${++askCounter}.txt`
@@ -2264,10 +2376,14 @@ function runAgent(runner, prompt, cwd, onDelta) {
       child.kill("SIGKILL");
       finish({ ok: false, error: `${runner.label} timed out` });
     }, RUN_TIMEOUT_MS);
-    const streaming = Boolean(onDelta && runner.parseDelta);
+    const streaming = Boolean(
+      onDelta && runner.parseDelta || onStatus && runner.parseStatus
+    );
     const emit = (line) => {
       const delta = runner.parseDelta?.(line);
       if (delta) onDelta?.(delta);
+      const status = runner.parseStatus?.(line);
+      if (status) onStatus?.(status);
     };
     child.stdout?.on("data", (d) => {
       stdout += d;
@@ -2390,7 +2506,8 @@ function handleAsk(req, res, specFile, catalogue) {
       runner,
       prompt,
       dirname2(specFile),
-      (text) => send({ type: "delta", text })
+      (text) => send({ type: "delta", text }),
+      (text) => send({ type: "status", text })
     );
     if (result.ok)
       send({ type: "done", agent: runner.id, answer: result.answer });
@@ -3185,6 +3302,25 @@ async function info(body) {
     }
   });
 }
+var dayStatsCache = new TtlCache({
+  namespace: "zframes:hyperliquid:daystats",
+  ttlMs: 25e3
+});
+var openInterestCache = new TtlCache({
+  namespace: "zframes:hyperliquid:oi",
+  ttlMs: 25e3
+});
+var candlesCache = new TtlCache({
+  namespace: "zframes:hyperliquid:candles",
+  ttlMs: 55e3,
+  persist: true
+});
+var fundingCache = new TtlCache({
+  namespace: "zframes:hyperliquid:funding",
+  ttlMs: 4.5 * 6e4,
+  persist: true
+});
+var sortedKey = (symbols) => symbols ? [...symbols].sort().join(",") : "*";
 var HyperliquidProvider = class {
   name = "hyperliquid";
   capabilities = [
@@ -3214,7 +3350,13 @@ var HyperliquidProvider = class {
       if (this.listeners.size === 0) this.teardown();
     };
   }
-  async getDayStats(symbols) {
+  getDayStats(symbols) {
+    return dayStatsCache.get(
+      sortedKey(symbols),
+      () => this.fetchDayStats(symbols)
+    );
+  }
+  async fetchDayStats(symbols) {
     const wholeDexes = /* @__PURE__ */ new Set();
     const concrete = /* @__PURE__ */ new Set();
     if (!symbols) {
@@ -3251,7 +3393,13 @@ var HyperliquidProvider = class {
     );
     return out;
   }
-  async getOpenInterest(symbols) {
+  getOpenInterest(symbols) {
+    return openInterestCache.get(
+      sortedKey(symbols),
+      () => this.fetchOpenInterest(symbols)
+    );
+  }
+  async fetchOpenInterest(symbols) {
     const wholeDexes = /* @__PURE__ */ new Set();
     const concrete = /* @__PURE__ */ new Set();
     if (!symbols) {
@@ -3284,7 +3432,13 @@ var HyperliquidProvider = class {
     );
     return out.sort((a, b) => b.openInterestUsd - a.openInterestUsd);
   }
-  async getFundingHistory(symbols, startTimeMs) {
+  getFundingHistory(symbols, startTimeMs) {
+    return fundingCache.get(
+      `${[...symbols].sort().join(",")}|${startTimeMs}`,
+      () => this.fetchFundingHistory(symbols, startTimeMs)
+    );
+  }
+  async fetchFundingHistory(symbols, startTimeMs) {
     const results = await Promise.all(
       symbols.map(async (coin) => {
         const entries = await info({
@@ -3303,7 +3457,13 @@ var HyperliquidProvider = class {
     );
     return Object.fromEntries(results);
   }
-  async getCandles(symbol, interval, startTimeMs) {
+  getCandles(symbol, interval, startTimeMs) {
+    return candlesCache.get(
+      `${symbol}|${interval}|${startTimeMs}`,
+      () => this.fetchCandles(symbol, interval, startTimeMs)
+    );
+  }
+  async fetchCandles(symbol, interval, startTimeMs) {
     const entries = await info({
       type: "candleSnapshot",
       req: { coin: symbol, interval, startTime: startTimeMs }