@oracle-agent/oracle 0.25.1 → 0.25.2

package/dist/assets/graphics/oracle_card.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 """Oracle-branded alert cards.
 
-RH AGENT cards stay RH AGENT. This module is the Oracle desk surface:
+RH AGENT brand is dead. This module is the Oracle desk surface:
 same lime/red candles, Oracle splash kit, official chain lockup (logo, not
 a typeset fake), and price-only chrome for Polymarket / HIP-4.
 
@@ -66,6 +66,7 @@ def _init_fonts():
         roots = [
             Path.home() / ".local/share/fonts",
             Path.home() / ".local/share/fonts/dmmono",
+            Path(__file__).resolve().parent / "fonts",
         ]
         for root in roots:
             if not root.exists():
@@ -93,8 +94,48 @@ def _init_fonts():
     return _FONTS
 
 
+def _oracle_display_fp(size: float):
+    """Oracle display face at a real weight. Variable Cormorant has no bold
+    instance in matplotlib — we ship a 700 static cut next to this file."""
+    from matplotlib import font_manager as fm
+
+    here = Path(__file__).resolve().parent / "fonts"
+    for name in ("CormorantGaramond-Bold.ttf", "CormorantGaramond-SemiBold.ttf"):
+        p = here / name
+        if p.exists():
+            try:
+                fm.fontManager.addfont(str(p))
+            except Exception:
+                pass
+            return fm.FontProperties(fname=str(p), size=size)
+    return fm.FontProperties(family=_FONTS.get("display") or "DejaVu Serif", size=size, weight="bold")
+
+
+def _oracle_num_fp(size: float):
+    """Oracle data face for figures. Cormorant is for names; numbers use
+    DM Mono / Roboto Mono from a real file so they stay bold and tabular."""
+    from matplotlib import font_manager as fm
+
+    cands = [
+        Path(__file__).resolve().parent / "fonts" / "RobotoMono-Bold.ttf",
+        Path.home() / ".local/share/fonts/keyitdev/RobotoMono-Bold.ttf",
+        Path(__file__).resolve().parent / "fonts" / "dmmono-Medium.ttf",
+        Path.home() / ".local/share/fonts/dmmono/dmmono-Medium.ttf",
+        Path.home() / ".local/share/fonts/MapleMono/MapleMono-Bold.ttf",
+    ]
+    for p in cands:
+        if not p.exists():
+            continue
+        try:
+            fm.fontManager.addfont(str(p))
+        except Exception:
+            pass
+        return fm.FontProperties(fname=str(p), size=size)
+    return fm.FontProperties(family=_FONTS.get("mono") or "DejaVu Sans Mono", size=size, weight="bold")
+
+
 def _esc(s: str) -> str:
-    return str(s or "").replace("$", r"\$")
+    return str(s or "")
 
 
 def _fmt_px(n: float) -> str:
@@ -208,7 +249,7 @@ def _load_logo(path: Path | None):
             return None
 
 
-def _chrome(fig, *, venue: str, eyebrow: str, hero: str, hero_color: str, chip: str, chip_bg: str, footer: str):
+def _chrome(fig, *, venue: str, eyebrow: str, hero: str, hero_color: str, chip: str, chip_bg: str, footer: str, pair_label: str = ""):
     from matplotlib import patheffects as pe
     from matplotlib.lines import Line2D
 
@@ -228,7 +269,6 @@ def _chrome(fig, *, venue: str, eyebrow: str, hero: str, hero_color: str, chip:
             text_x = 0.048
     wm = fig.text(text_x, 0.922, "ORACLE", color=B["blue2"], fontsize=16, fontfamily=fonts["display"], fontweight="medium", va="center")
     wm.set_path_effects([pe.withStroke(linewidth=3.0, foreground=B["glow"], alpha=0.65)])
-    # Chain tag: "CHAIN:" + the venue's official lockup (its real logo + font).
     tag_x = text_x + 0.118
     fig.text(tag_x, 0.922, "CHAIN:", color=B["mute"], fontsize=8.0, fontfamily=fonts["mono"], va="center")
     lockup = _load_logo(meta.get("logo"))
@@ -249,11 +289,43 @@ def _chrome(fig, *, venue: str, eyebrow: str, hero: str, hero_color: str, chip:
         fig.text(tag_x + 0.052, 0.922, meta["label"], color=meta["accent"], fontsize=8.0, fontfamily=fonts["mono"], va="center")
     fig.text(0.048, 0.815, eyebrow, color=B["blue"], fontsize=7.2, fontfamily=fonts["mono"], va="top")
     if hero:
-        fig.text(0.952, 0.932, _esc(hero), color=hero_color or B["blue2"], fontsize=22, fontfamily=fonts["display"], ha="right", va="center")
+        hp = None
+        try:
+            hp = _oracle_num_fp(26)
+        except Exception:
+            hp = None
+        ht = fig.text(
+            0.952, 0.932, _esc(hero), color=hero_color or B["blue2"],
+            fontsize=26, fontfamily=fonts["mono"], fontweight="bold",
+            fontproperties=hp, ha="right", va="center", zorder=9,
+            parse_math=False,
+        )
+        if pair_label:
+            tp = None
+            try:
+                tp = _oracle_display_fp(20)
+            except Exception:
+                tp = None
+            # Sit flush left of the MC using the real glyph box.
+            gap = 0.014
+            x = 0.74
+            try:
+                fig.canvas.draw()
+                bb = ht.get_window_extent(renderer=fig.canvas.get_renderer())
+                x0, _ = fig.transFigure.inverted().transform((bb.x0, bb.y0))
+                x = x0 - gap
+            except Exception:
+                x = 0.952 - max(0.18, len(_esc(hero)) * 0.014)
+            fig.text(
+                x, 0.932, _esc(pair_label),
+                color=B["ink"], fontsize=20, fontfamily=fonts["display"],
+                fontweight="bold", fontproperties=tp, ha="right", va="center",
+                zorder=9,
+            )
     if chip:
         fig.text(0.952, 0.868, chip, color=B["blue2"], fontsize=8.2, fontfamily=fonts["mono"], ha="right", va="center")
     fig.add_artist(Line2D([0.045, 0.955], [0.072, 0.072], transform=fig.transFigure, color=B["line"], linewidth=1.0))
-    fig.text(0.048, 0.040, os.environ.get("ORACLE_CARD_FOOTER", "oracle-agent"), color=B["blue2"], fontsize=6.8, fontfamily=fonts["mono"], fontweight="bold", va="center")
+    fig.text(0.048, 0.040, os.environ.get("ORACLE_CARD_FOOTER", "oracle.demi.la"), color=B["blue2"], fontsize=6.8, fontfamily=fonts["mono"], fontweight="bold", va="center")
     tag = fig.text(0.500, 0.040, "T H E   F U T U R E   I S   A G E N T I C", color=B["blue2"], fontsize=6.8, fontfamily=fonts["display"], ha="center", va="center")
     tag.set_path_effects([pe.withStroke(linewidth=2.2, foreground=B["glow"], alpha=0.6)])
     right = f"{_esc(footer)} · " if footer else ""
@@ -285,6 +357,59 @@ def _bg(fig):
         pass
 
 
+def render_spot_card(
+    *,
+    symbol: str,
+    venue: str = "robinhood",
+    hero: str | None = None,
+    chip: str | None = None,
+    mid: str | None = None,
+    sub: str | None = None,
+    reason: str = "OHLCV UNAVAILABLE",
+    out_path: str | None = None,
+) -> str | None:
+    """Oracle chrome with live stats but no fake candles.
+
+    Used when Gecko OHLCV 429s. Honest: no data, no fake lines.
+    """
+    import matplotlib
+
+    matplotlib.use("Agg")
+    import matplotlib.pyplot as plt
+
+    fonts = _init_fonts()
+    B = ORACLE
+    fig = plt.figure(figsize=(11.2, 6.3), dpi=160, facecolor=B["bg"])
+    _bg(fig)
+    ax = fig.add_axes([0.075, 0.135, 0.875, 0.68])
+    ax.set_facecolor(B["panel"])
+    ax.set_xticks([])
+    ax.set_yticks([])
+    for sp in ax.spines.values():
+        sp.set_visible(False)
+    sym = str(symbol or "TOKEN").lstrip("$").upper()
+    ax.text(0.06, 0.72, f"${sym}", color=B["ink"], fontsize=28, fontfamily=fonts["display"], fontweight="medium", transform=ax.transAxes)
+    if mid:
+        ax.text(0.06, 0.48, mid, color=B["blue2"], fontsize=18, fontfamily=fonts["display"], transform=ax.transAxes)
+    if sub:
+        ax.text(0.06, 0.30, sub, color=B["mute"], fontsize=12, fontfamily=fonts["mono"], transform=ax.transAxes)
+    ax.text(0.06, 0.12, reason, color=B["mute"], fontsize=8.5, fontfamily=fonts["mono"], transform=ax.transAxes)
+    _chrome(
+        fig,
+        venue=venue,
+        eyebrow=f"{sym}  ·  SPOT",
+        hero=hero or "",
+        hero_color=B["blue2"],
+        chip=chip or "",
+        chip_bg=B["blue"],
+        footer=reason,
+    )
+    dest = out_path or str(Path(tempfile.gettempdir()) / f"oracle-spot-{sym[:12]}.png")
+    fig.savefig(dest, facecolor=fig.get_facecolor())
+    plt.close(fig)
+    return dest if Path(dest).exists() else None
+
+
 def render_ohlc_card(
     rows: list[dict],
     *,
@@ -302,6 +427,9 @@ def render_ohlc_card(
     hero: str | None = None,
     chip: str | None = None,
     chip_bg: str | None = None,
+    edge_px: float | None = None,
+    holders_delta_24h: int | None = None,
+    holders_now: int | None = None,
 ) -> str | None:
     """OHLC card with optional position overlays.
 
@@ -333,6 +461,17 @@ def render_ohlc_card(
     lows = [float(r["l"]) for r in rows]
     closes = [float(r["c"]) for r in rows]
     vols = [float(r.get("v") or 0) for r in rows]
+    last_c = closes[-1] if closes else 0.0
+    if last_c > 0:
+        keep = [i for i in range(len(closes)) if 0.4 * last_c <= closes[i] <= 2.5 * last_c]
+        if 8 <= len(keep) < len(closes):
+            xs = [xs[i] for i in keep]
+            opens = [opens[i] for i in keep]
+            highs = [highs[i] for i in keep]
+            lows = [lows[i] for i in keep]
+            closes = [closes[i] for i in keep]
+            vols = [vols[i] for i in keep]
+            rows = [rows[i] for i in keep]
     fig = plt.figure(figsize=(11.2, 6.3), dpi=160, facecolor=B["bg"])
     _bg(fig)
     ax = fig.add_axes([0.075, 0.195, 0.875, 0.575])
@@ -348,15 +487,25 @@ def render_ohlc_card(
         a.set_axisbelow(True)
     plt.setp(ax.get_xticklabels(), visible=False)
     xnum = mdates.date2num(xs)
-    wide = (xnum[-1] - xnum[0]) / max(1, len(xnum)) * 0.66
+    deltas = [xnum[i] - xnum[i - 1] for i in range(1, len(xnum)) if xnum[i] > xnum[i - 1]]
+    med = sorted(deltas)[len(deltas) // 2] if deltas else (15.0 / 1440.0)
+    wide = min(max(med * 0.55, 4.0 / 1440.0), 18.0 / 1440.0)
+    last_px = closes[-1] if closes else 0.0
+    clip_wicks = last_px >= 20
     for i in range(len(rows)):
-        up = closes[i] >= opens[i]
+        o, h, l, c = opens[i], highs[i], lows[i], closes[i]
+        if clip_wicks:
+            body_hi, body_lo = max(o, c), min(o, c)
+            cap = max(abs(c) * 0.012, (body_hi - body_lo) * 2.5, 0.15)
+            h = min(h, body_hi + cap)
+            l = max(l, body_lo - cap)
+        up = c >= o
         body_c = B["up"] if up else B["down"]
         wick_c = B["up_wick"] if up else B["down_wick"]
-        ax.plot([xnum[i], xnum[i]], [lows[i], highs[i]], color=wick_c, linewidth=0.9, zorder=2, solid_capstyle="round")
-        body_lo = min(opens[i], closes[i])
-        body_h = abs(closes[i] - opens[i]) or (highs[i] - lows[i]) * 0.02 or 1e-12
-        ax.add_patch(Rectangle((xnum[i] - wide / 2, body_lo), wide, body_h, facecolor=body_c, edgecolor=body_c, linewidth=0.5, zorder=3))
+        ax.plot([xnum[i], xnum[i]], [l, h], color=wick_c, linewidth=0.85, zorder=2, solid_capstyle="round")
+        body_lo = min(o, c)
+        body_h = abs(c - o) or (h - l) * 0.04 or abs(c) * 1e-4
+        ax.add_patch(Rectangle((xnum[i] - wide / 2, body_lo), wide, body_h, facecolor=body_c, edgecolor=body_c, linewidth=0.4, zorder=3))
         axv.bar(xnum[i], vols[i], width=wide, color=body_c, alpha=0.42, zorder=2)
     last = closes[-1]
     ax.axhline(last, color=B["blue"], linewidth=0.8, alpha=0.35, linestyle=(0, (4, 3)), zorder=4)
@@ -421,7 +570,7 @@ def render_ohlc_card(
         except Exception:
             continue
     ax.annotate(
-        _esc(_fmt_px(last)), xy=(1.0, last), xycoords=("axes fraction", "data"),
+        _esc(_fmt_px(edge_px if edge_px is not None else last)), xy=(1.0, last), xycoords=("axes fraction", "data"),
         xytext=(4, 0), textcoords="offset points", va="center", ha="left",
         fontsize=7.0, fontfamily=fonts["mono"], fontweight="bold", color=B["chip_ink"],
         bbox={"boxstyle": "round,pad=0.30", "facecolor": B["blue2"], "edgecolor": "none"}, zorder=6, annotation_clip=False,
@@ -438,6 +587,8 @@ def render_ohlc_card(
     axv.xaxis_date()
     axv.xaxis.set_major_formatter(mdates.DateFormatter("%m-%d %H:%M"))
     axv.set_yticks([])
+    if last >= 1:
+        ax.yaxis.set_major_formatter(plt.FuncFormatter(lambda v, _p: f"{v:,.2f}"))
     # 24h % gain: change vs the close nearest 24h before the last bar.
     last_ts = xs[-1].timestamp()
     base = None
@@ -447,15 +598,29 @@ def render_ohlc_card(
     if base is None:
         base = closes[0]
     chg = (closes[-1] / base - 1) * 100 if base > 0 else 0
+    if last >= 20 and abs(chg) > 80:
+        chg = 0.0
+    if chip is None:
+        bits = []
+        if not (last >= 20 and abs((closes[-1] / base - 1) * 100 if base > 0 else 0) > 80):
+            bits.append(f"{chg:+.2f}% 24H")
+        elif chg != 0:
+            bits.append(f"{chg:+.2f}% 24H")
+        else:
+            bits.append("24H n/a")
+        if holders_delta_24h is not None:
+            bits.append(f"HLD {int(holders_delta_24h):+d}/24H")
+        elif holders_now is not None:
+            bits.append(f"HLD {int(holders_now)}")
+        chip = " · ".join(bits)
     _chip_bg = chip_bg or (B["up"] if chg >= 0 else B["down"])
-    eyebrow_bits = [str(pair or symbol).upper()]
-    if market:
-        eyebrow_bits.append(str(market).upper())
     _chrome(
-        fig, venue=venue, eyebrow="  ·  ".join(eyebrow_bits),
+        fig, venue=venue, eyebrow="",
         hero=hero if hero is not None else f"{_fmt_px(last)}", hero_color=B["blue2"],
-        chip=chip if chip is not None else f"{chg:+.2f}% 24H", chip_bg=_chip_bg,
+        chip=chip,
+        chip_bg=_chip_bg,
         footer=f"{source} · CANDLES · {chain_meta(venue)['label']}",
+        pair_label=str(pair or "").upper(),
     )
     out = out_path or str(Path(tempfile.gettempdir()) / f"oracle-card-{venue}-{symbol}.png")
     fig.savefig(out, facecolor=fig.get_facecolor(), bbox_inches="tight", pad_inches=0.08)
@@ -598,7 +763,16 @@ def render_stat_card(
             cx = (i % per_row) * tile_w + tile_w / 2
             cy = 0.985 - (i // per_row) * tile_h
             ax.text(cx, cy - 0.055, str(lab).upper(), ha="center", va="top", fontsize=7.0, fontfamily=fonts["mono"], color=B["mute"])
-            ax.text(cx, cy - 0.115, _esc(str(val)), ha="center", va="top", fontsize=15, fontfamily=fonts["display"], color=B["ink"])
+            np_ = None
+            try:
+                np_ = _oracle_num_fp(15)
+            except Exception:
+                np_ = None
+            ax.text(
+                cx, cy - 0.115, _esc(str(val)), ha="center", va="top",
+                fontsize=15, fontfamily=fonts["mono"], fontweight="bold",
+                fontproperties=np_, color=B["ink"], parse_math=False,
+            )
         table_top = 0.985 - n_tile_rows * tile_h - 0.03
     else:
         table_top = 0.95
@@ -669,6 +843,7 @@ def render_nft_card(
     volume_24h: float | None = None,
     sales_24h: int | None = None,
     listed: int | None = None,
+    listed_plus: bool = False,
     supply: int | None = None,
     owners: int | None = None,
     top_offer: float | None = None,
@@ -736,23 +911,33 @@ def render_nft_card(
                 src = str(tmp_img)
             from PIL import Image
 
+            raw = Path(src).read_bytes()[:200]
+            if src.lower().endswith(".svg") or raw.lstrip().startswith(b"<svg") or b"<svg" in raw[:80]:
+                png = Path(src).with_suffix(".png")
+                import subprocess
+                subprocess.run(
+                    ["rsvg-convert", "-w", "720", "-h", "720", "-o", str(png), src],
+                    check=True, timeout=12, capture_output=True,
+                )
+                src = str(png)
             img_obj = Image.open(src).convert("RGB")
         except Exception:
             img_obj = None
 
-    # Left: NFT image panel. Right: floor chart. Bottom: stat strip.
+    # Left: NFT image, flush under the collection name. Right: floor chart.
     chart_left = 0.075
+    panel_y, panel_h = 0.228, 0.538
     if img_obj is not None:
-        iax = fig.add_axes([0.048, 0.245, 0.235, 0.520], zorder=5)
+        iax = fig.add_axes([0.048, panel_y, 0.248, panel_h], zorder=5)
         iax.imshow(img_obj)
         iax.set_xticks([])
         iax.set_yticks([])
         for sp in iax.spines.values():
             sp.set_color(B["blue"])
-            sp.set_linewidth(1.2)
+            sp.set_linewidth(1.15)
             sp.set_alpha(0.55)
         chart_left = 0.318
-    ax = fig.add_axes([chart_left, 0.245, 0.952 - chart_left, 0.520])
+    ax = fig.add_axes([chart_left, panel_y, 0.952 - chart_left, panel_h])
     ax.set_facecolor(B["panel"])
     ax.tick_params(colors=B["mute"], labelsize=6.8)
     for lbl in ax.get_xticklabels() + ax.get_yticklabels():
@@ -805,13 +990,23 @@ def render_nft_card(
         ax.text(0.5, 0.5, "NO FLOOR HISTORY", ha="center", va="center", fontsize=9, fontfamily=fonts["mono"], color=B["mute"], transform=ax.transAxes)
     # Bottom stat strip.
     chg_txt = f"{floor_chg_24h:+.1f}%" if floor_chg_24h is not None else "UNKNOWN"
+    if listed is None:
+        listed_txt = "UNKNOWN"
+    elif listed_plus and supply:
+        listed_txt = f"{listed:,}+/{supply:,}"
+    elif listed_plus:
+        listed_txt = f"{listed:,}+"
+    elif supply:
+        listed_txt = f"{listed:,}/{supply:,}"
+    else:
+        listed_txt = f"{listed:,}"
     strip = [
         ("FLOOR", fmt(floor if floor is not None else (fy[-1] if fy else None))),
         ("24H %", chg_txt),
         ("TOP OFFER", fmt(top_offer)),
         ("24H VOL", fmt(volume_24h)),
         ("24H SALES", f"{sales_24h:,}" if sales_24h is not None else "UNKNOWN"),
-        ("LISTED", f"{listed:,}/{supply:,}" if listed is not None and supply else (f"{listed:,}" if listed is not None else "UNKNOWN")),
+        ("LISTED", listed_txt),
         ("HOLDERS", f"{owners:,}" if owners is not None else "UNKNOWN"),
     ]
     n = len(strip)
@@ -821,7 +1016,16 @@ def render_nft_card(
         if lab == "24H %" and floor_chg_24h is not None:
             col = B["up"] if floor_chg_24h >= 0 else B["down"]
         fig.text(cx, 0.185, lab, ha="center", va="center", fontsize=6.2, fontfamily=fonts["mono"], color=B["mute"])
-        fig.text(cx, 0.135, _esc(str(val)), ha="center", va="center", fontsize=9.8, fontfamily=fonts["display"], color=col)
+        np_ = None
+        try:
+            np_ = _oracle_num_fp(12.5)
+        except Exception:
+            np_ = None
+        fig.text(
+            cx, 0.135, _esc(str(val)), ha="center", va="center",
+            fontsize=12.5, fontfamily=fonts["mono"], fontweight="bold",
+            fontproperties=np_, color=col, parse_math=False,
+        )
     chip_bits = []
     if floor_chg_24h is not None:
         chip_bits.append(f"{floor_chg_24h:+.1f}% 24H")
@@ -835,24 +1039,23 @@ def render_nft_card(
         chip_color = B["up"] if floor_chg_24h >= 0 else B["down"]
     hero_color = ORACLE["blue2"]
     _chrome(
-        fig, venue=venue, eyebrow="" if img_obj is not None else collection[:60],
+        fig, venue=venue, eyebrow="",
         hero=fmt(floor if floor is not None else (fy[-1] if fy else None)),
         hero_color=hero_color, chip=chip, chip_bg=chip_color,
         footer=source,
     )
-    # Collection PFP thumb + name beside the eyebrow (like the venue lockup row).
-    if img_obj is not None:
-        try:
-            pax = fig.add_axes([0.048, 0.786, 0.030, 0.053], zorder=9)
-            pax.imshow(img_obj)
-            pax.set_xticks([])
-            pax.set_yticks([])
-            for sp in pax.spines.values():
-                sp.set_color(B["blue"])
-                sp.set_linewidth(0.9)
-            fig.text(0.086, 0.812, collection[:60], color=B["blue"], fontsize=8.4, fontfamily=fonts["mono"], fontweight="bold", va="center")
-        except Exception:
-            fig.text(0.048, 0.812, collection[:60], color=B["blue"], fontsize=7.2, fontfamily=fonts["mono"], va="center")
+    # Collection name: Oracle display (Cormorant 700), ice-blue like IF/USD.
+    name = collection[:44].upper()
+    t = fig.text(
+        0.048, 0.800, name, color=B["blue2"],
+        fontproperties=_oracle_display_fp(22.5),
+        va="center", ha="left", zorder=9,
+    )
+    try:
+        from matplotlib import patheffects as pe
+        t.set_path_effects([pe.withStroke(linewidth=2.4, foreground=B["glow"], alpha=0.55)])
+    except Exception:
+        pass
     out = out_path or str(Path(tempfile.gettempdir()) / f"oracle-nft-{venue}.png")
     fig.savefig(out, facecolor=fig.get_facecolor(), bbox_inches="tight", pad_inches=0.08)
     plt.close(fig)

package/dist/assets/skills/oracle-desk-product/SKILL.md

@@ -97,7 +97,7 @@ does not prove npm users receive it. A locally hosted model/data/policy loop doe
 a bundled signer. A merged feature is not public until the npm artifact containing it is
 published and inspected.
 
-**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.25.1`
+**Candidate release in this source tree:** public package `@oracle-agent/oracle@0.25.2`
 ships the encrypted local vault + short-lived loopback signer. Hosted/keyless
 Oracle cannot hold keys or move funds. Self-host after `oracle sign init|import` is **auto-armed**
 for user-initiated actions. Public still charges the disclosed fee card; Administrator