solana-traderclaw 1.0.145 → 1.0.146

package/dist/{chunk-ZUY36F4Q.js → chunk-GX4HA22L.js}

@@ -141,12 +141,19 @@ var AlphaStreamManager = class {
     return this.subscribed && this.ws !== null && this.ws.readyState === 1;
   }
   getStats() {
+    const ls = this.config.lifetimeState;
+    const lifetimeMessageCount = ls ? ls.lifetimeMessageCount : this.messageCount;
+    const firstConnectedAt = ls && ls.firstConnectedAt > 0 ? ls.firstConnectedAt : this.connectedAt;
+    const lifetimeLastEventTs = ls && ls.lifetimeLastEventTs > 0 ? ls.lifetimeLastEventTs : this.lastEventTs;
     return {
       subscribed: this.isSubscribed(),
-      messageCount: this.messageCount,
-      lastEventTs: this.lastEventTs,
+      messageCount: lifetimeMessageCount,
+      currentWsMessageCount: this.messageCount,
+      lastEventTs: lifetimeLastEventTs,
       connectedAt: this.connectedAt,
+      firstConnectedAt,
       uptimeSeconds: this.connectedAt ? Math.floor((Date.now() - this.connectedAt) / 1e3) : 0,
+      lifetimeUptimeSeconds: firstConnectedAt ? Math.floor((Date.now() - firstConnectedAt) / 1e3) : 0,
       reconnectAttempt: this.reconnectAttempt,
       unhealthyStreak: this.unhealthyStreak,
       circuitBackoff: this.unhealthyStreak >= CIRCUIT_UNHEALTHY_THRESHOLD
@@ -200,6 +207,9 @@ var AlphaStreamManager = class {
       this.ws.on("open", () => {
         clearTimeout(connectTimeout);
         this.connectedAt = Date.now();
+        if (this.config.lifetimeState && this.config.lifetimeState.firstConnectedAt === 0) {
+          this.config.lifetimeState.firstConnectedAt = this.connectedAt;
+        }
         this.reconnectAttempt = 0;
         this.log("info", "WebSocket connected, waiting for server handshake...");
         pingInterval = setInterval(() => {
@@ -286,6 +296,10 @@ var AlphaStreamManager = class {
       case "alpha_signal": {
         this.messageCount++;
         this.lastEventTs = Date.now();
+        if (this.config.lifetimeState) {
+          this.config.lifetimeState.lifetimeMessageCount++;
+          this.config.lifetimeState.lifetimeLastEventTs = this.lastEventTs;
+        }
         const data = msg.data;
         if (data) {
           const signal = {

package/dist/index.js

@@ -19,7 +19,7 @@ import {
 } from "./chunk-3UQIQJPQ.js";
 import {
   AlphaStreamManager
-} from "./chunk-ZUY36F4Q.js";
+} from "./chunk-GX4HA22L.js";
 import {
   BitqueryStreamManager
 } from "./chunk-S2DLZKMQ.js";
@@ -777,6 +777,31 @@ var SOLANA_TRADER_LIFECYCLE_SINGLETON_KEY = Symbol.for(
   "openclaw.solana-trader.lifecycle.v1"
 );
 var __solanaTraderGlobalSingletonHolder = globalThis;
+var SOLANA_TRADER_ALPHA_BUFFER_SINGLETON_KEY = Symbol.for(
+  "openclaw.solana-trader.alpha-buffer.v1"
+);
+var SOLANA_TRADER_ALPHA_LIFETIME_SINGLETON_KEY = Symbol.for(
+  "openclaw.solana-trader.alpha-lifetime.v1"
+);
+var __solanaTraderAlphaSingletonHolder = globalThis;
+function getOrCreateAlphaBuffer() {
+  const existing = __solanaTraderAlphaSingletonHolder[SOLANA_TRADER_ALPHA_BUFFER_SINGLETON_KEY];
+  if (existing) return existing;
+  const fresh = new AlphaBuffer();
+  __solanaTraderAlphaSingletonHolder[SOLANA_TRADER_ALPHA_BUFFER_SINGLETON_KEY] = fresh;
+  return fresh;
+}
+function getOrCreateAlphaLifetimeState() {
+  const existing = __solanaTraderAlphaSingletonHolder[SOLANA_TRADER_ALPHA_LIFETIME_SINGLETON_KEY];
+  if (existing) return existing;
+  const fresh = {
+    lifetimeMessageCount: 0,
+    firstConnectedAt: 0,
+    lifetimeLastEventTs: 0
+  };
+  __solanaTraderAlphaSingletonHolder[SOLANA_TRADER_ALPHA_LIFETIME_SINGLETON_KEY] = fresh;
+  return fresh;
+}
 function __solanaTraderDisposePreviousLifecycle(logger) {
   const prev = __solanaTraderGlobalSingletonHolder[SOLANA_TRADER_LIFECYCLE_SINGLETON_KEY];
   if (!prev) return;
@@ -2572,11 +2597,13 @@ ${notes}
         async () => get("/api/agents/active")
       )
     });
-    const alphaBuffer = new AlphaBuffer();
+    const alphaBuffer = getOrCreateAlphaBuffer();
+    const alphaLifetimeState = getOrCreateAlphaLifetimeState();
     const alphaStreamManager = new AlphaStreamManager({
       wsUrl: orchestratorUrl.replace(/^http/, "ws").replace(/\/$/, "") + "/ws",
       getAccessToken: () => sessionManager.getAccessToken(),
       buffer: alphaBuffer,
+      lifetimeState: alphaLifetimeState,
       agentId: config.agentId,
       logger: {
         info: (msg) => api.logger.info(`[solana-trader] ${msg}`),
@@ -2799,7 +2826,7 @@ ${notes}
     });
     api.registerTool({
       name: "solana_alpha_signals",
-      description: "Get buffered alpha signals from the SpyFly stream. By default returns only unseen signals and marks them as seen. Use minScore to filter low-quality signals. Poll this every heartbeat cycle in Step 1.5b. Returns signals sorted by ingestion time (newest last).",
+      description: "Read the live alpha-stream state and buffered signals from the running plugin. **Single source of truth** for any 'how many alpha signals / are we getting alpha / is alpha connected / latest signals' question \u2014 call it on the same turn. Signals are NOT logged per-message, so the journal/heartbeat-history will look empty; only this tool returns the real count.\n\nReturned shape: { signals[], count, bufferSize, subscribed, stats }.\n\nHEADLINE FIELDS for live status answers:\n - stats.messageCount = total alpha_signal messages this gateway process has received (survives plugin re-registers and WS reconnects). Use this for 'how many signals so far' answers.\n - stats.lifetimeUptimeSeconds = seconds since the first WS connect in this gateway process. Divide messageCount/lifetimeUptimeSeconds to get rate.\n - stats.lastEventTs = wall-clock ms of the most recent alpha_signal (lifetime).\n - subscribed = current WS is in subscribed state.\n - stats.reconnectAttempt, stats.unhealthyStreak, stats.circuitBackoff = health signals.\n\nDebug-only fields (do NOT report to users as 'totals'):\n - stats.currentWsMessageCount = messages since the CURRENT WS connect (resets on every reconnect; misleading as a 'total').\n - stats.uptimeSeconds = uptime of the current WS connect.\n - stats.connectedAt = ts of the current WS open.\n\nFor windows beyond what bufferSize covers (\u2248200 signals), or after a gateway restart wiped the lifetime counters, fall through to `solana_alpha_history` (REST, tier=enterprise \u2192 up to 200 results, last 12+ months).\n\nParams: pass unseen:false when the user is asking about overall state (don't mutate _seen). Pass unseen:true (default) only during heartbeat polling to mark and consume new signals. Use minScore to filter low-quality. Returns signals sorted by ingestion time (newest last).",
       parameters: Type.Object({
         minScore: Type.Optional(Type.Number({ description: "Minimum systemScore threshold (0-100). Signals below this are excluded." })),
         chain: Type.Optional(Type.String({ description: "Filter by chain (e.g., 'solana'). BSC is already filtered at ingestion." })),
@@ -2824,7 +2851,7 @@ ${notes}
     });
     api.registerTool({
       name: "solana_alpha_history",
-      description: "Query historical alpha signal data via the SpyFly REST API (GET /api/pings). Returns up to 1 year of stored signals for source reputation analysis, post-downtime catch-up, and strategy learning. Tier-gated: starter=10, pro=50, enterprise=200 results. 99.99% of tokens are dead but source patterns are invaluable.",
+      description: "Query historical alpha signal data via the orchestrator REST API (GET /api/pings). Use this whenever the user asks about an ALPHA window that extends beyond what `solana_alpha_signals` can cover, e.g.:\n - 'how many alpha signals in the last hour / today / this week / since Monday'\n - 'any alpha on <token> in the last 24h'\n - 'PAIN/$X signals from yesterday'\n - any time the live buffer is empty or just reconnected but the user is asking about a real time window.\n\nReturns up to 1 year of stored signals. Tier-gated by your account (starter=10, pro=50, enterprise=200 results). Combine with `solana_alpha_signals` (live state) to answer 'we've received N signals lifetime in this gateway, plus M historical in the window you asked about'.\n\nParams: tokenAddress, channelId, limit, days (lookback window). 99.99% of tokens are dead but source patterns are invaluable.",
       parameters: Type.Object({
         tokenAddress: Type.Optional(Type.String({ description: "Filter by token mint address" })),
         channelId: Type.Optional(Type.String({ description: "Filter by source channel ID" })),
@@ -2848,7 +2875,7 @@ ${notes}
     });
     api.registerTool({
       name: "solana_alpha_sources",
-      description: "Get per-source statistics from the alpha signal buffer \u2014 signal count, average systemScore, and source type for each channel. Use for quick reputation checks during signal processing and to identify high-quality vs low-quality sources.",
+      description: "Get per-source statistics from the alpha signal buffer \u2014 signal count, average systemScore, and source type for each channel. Call this when the user asks 'which alpha sources / channels are active', 'where are signals coming from', or any breakdown-by-source question. Always live; never answer source breakdowns from memory. Use also for quick reputation checks during signal processing.",
       parameters: Type.Object({}),
       execute: wrapExecute("solana_alpha_sources", async () => ({
         sources: alphaBuffer.getSourceStatsAll(),
@@ -4265,6 +4292,12 @@ ${String(params.summary)}
           content: entitlementMd,
           source: "solana-trader:entitlements-digest"
         });
+        context.bootstrapFiles.push({
+          name: "live-queries.md",
+          path: "live-queries.md",
+          content: "# Live alpha status queries \u2014 always call the tool\n\nWhen the user asks anything about CURRENT alpha activity, call the matching tool **on this turn**. Do NOT answer from memory, heartbeat history, journal logs, or earlier turn context \u2014 alpha signals are not journalled per-message, so 'I don't see any / 0' is wrong by default.\n\n## Routing\n\n| User question shape | Tool(s) to call | Key fields in response |\n|---|---|---|\n| how many alpha signals / are we getting alpha / activity since gateway start | `solana_alpha_signals` (unseen:false) | stats.messageCount, stats.lifetimeUptimeSeconds, stats.lastEventTs, subscribed, bufferSize |\n| is alpha connected / healthy / stream status | `solana_alpha_signals` (unseen:false) | subscribed, stats.reconnectAttempt, stats.unhealthyStreak, stats.circuitBackoff, stats.lastEventTs |\n| how many alpha signals in last hour / today / this week / since <day> | `solana_alpha_signals` (live state) **AND** `solana_alpha_history` (days=\u2026 or compute from window) | live: stats.messageCount + bufferSize; historical: pings[] in window |\n| any alpha on token <X> (recent / historical) | `solana_alpha_signals` for in-buffer signals, then `solana_alpha_history` (tokenAddress=X, days=N) for older | both responses merged by ts |\n| what alpha sources / channels are active | `solana_alpha_sources` | sources[] (name, type, count, avgScore) |\n| latest signals / new signals | `solana_alpha_signals` (unseen:false) | signals[] sorted newest last |\n\n## Field meanings \u2014 IMPORTANT\n\n`solana_alpha_signals` returns `stats` with both lifetime and current-WS fields. Use LIFETIME fields for user-facing answers:\n\n- `stats.messageCount` = **lifetime** total alpha_signal messages received since the gateway process started. Survives plugin re-registers and WS reconnects. **This is the headline number.**\n- `stats.lifetimeUptimeSeconds` = seconds since the first WS open in this process.\n- `stats.lastEventTs` = wall-clock ms of the most recent signal (lifetime).\n- `stats.firstConnectedAt` = wall-clock ms of the first WS open in this process.\n\nDebug-only (do NOT report these as 'totals' \u2014 they reset on every WS reconnect / plugin re-register):\n\n- `stats.currentWsMessageCount` \u2014 messages since the current WS opened.\n- `stats.uptimeSeconds` \u2014 current WS uptime.\n- `stats.connectedAt` \u2014 current WS open ts.\n\n## When to also call `solana_alpha_history`\n\nCall `solana_alpha_history` in addition to `solana_alpha_signals` whenever the user's window pre-dates the current gateway-process lifetime (e.g. `stats.lifetimeUptimeSeconds` is shorter than the asked window, or `stats.messageCount` is 0 because the gateway just restarted). Tier=enterprise returns up to 200 pings, up to ~1 year back.\n\n## Reply template (live-only)\n\n```\nLive alpha state:\n- subscribed: <bool>\n- lifetime: <messageCount> messages over <lifetimeUptimeSeconds>s (\u2248 <rate>/min) since gateway start\n- last signal: <Xs/Xm ago> (lastEventTs)\n- buffer (deduped): <bufferSize>\n- reconnects: <reconnectAttempt>, unhealthy streak: <unhealthyStreak>\n```\n\n## Reply template (with historical window, e.g. 'last hour')\n\n```\nAlpha activity (<window>):\n- live (gateway lifetime): <messageCount> messages over <lifetimeUptimeSeconds>s\n- historical (`solana_alpha_history` days=<N>): <pings.length> pings\n- combined unique within <window>: <merged count>\n- subscribed: <bool>, last signal: <ago>\n```\n\nThis routing overrides any heartbeat-cycle 'minimal calls' cap: ad-hoc user status questions are NOT subject to per-cycle envelopes.\n",
+          source: "solana-trader:live-queries"
+        });
         api.logger.info(`[solana-trader] Bootstrap: injected ${context.bootstrapFiles.length} files for agent ${bootAgentId}`);
       },
       {

package/dist/src/alpha-ws.js

@@ -2,7 +2,7 @@ import {
   ALPHA_INGESTION_STALE_MS,
   ALPHA_STALE_GRACE_AFTER_CONNECT_MS,
   AlphaStreamManager
-} from "../chunk-ZUY36F4Q.js";
+} from "../chunk-GX4HA22L.js";
 export {
   ALPHA_INGESTION_STALE_MS,
   ALPHA_STALE_GRACE_AFTER_CONNECT_MS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "solana-traderclaw",
-  "version": "1.0.145",
+  "version": "1.0.146",
   "description": "TraderClaw V1-Upgraded — Solana trading for OpenClaw with intelligence lab, tool envelopes, prompt scrubbing, read-only X social intel, and split skill docs",
   "type": "module",
   "main": "./dist/index.js",