@coinrithm/mcp-trading 0.7.14 → 0.7.16

package/dist/agent/observe.d.ts

@@ -1,11 +1,44 @@
 import { CoinRithmClient } from "./client.js";
-import { AgentSpec, RunState, Observation, AgentTrace } from "./types.js";
+import { AgentSpec, RunState, Observation, OpenInterestContext, PositioningContext, LiquidationContext, MacroContext, ChainTvlContext, StablecoinSupplyContext, DepthContext, FundingByVenueContext, AgentTrace, PmCalibration, WhaleContext } from "./types.js";
 export interface ObserveOutput {
     observation: Observation;
     skip?: string;
 }
+/**
+ * Add bounded public whale context after the deterministic gate. This is
+ * deliberately separate from observe(): a skipped or mechanical cycle never
+ * pays for the public reads, and this context cannot widen candidate selection.
+ */
+export declare function enrichWhaleContext(client: CoinRithmClient, observation: Observation): Promise<WhaleContext>;
+export declare function clearPmCalibrationCache(): void;
+export declare function readPmCalibration(client: CoinRithmClient, trace?: AgentTrace, nowMs?: number): Promise<PmCalibration | undefined>;
 export declare function isCalibrationChurnMarket(market: {
     slug?: string;
     title?: string;
 }): boolean;
-export declare function observe(client: CoinRithmClient, spec: AgentSpec, state: RunState, trace?: AgentTrace): Promise<ObserveOutput>;
+export declare function openInterestOf(m: Record<string, unknown>, nowMs?: number): OpenInterestContext | undefined;
+export declare function positioningOf(m: Record<string, unknown>, nowMs?: number): PositioningContext | undefined;
+export declare function liquidationsOf(m: Record<string, unknown>, nowMs?: number): LiquidationContext | undefined;
+/**
+ * `{ coins }` from an additive `relatedCoins` array (direct coin slugs), or
+ * nothing: non-arrays and non-string/blank entries are dropped, duplicates
+ * merged. Every valid slug is kept: the API never truncates the list, and
+ * dropping a linked coin could let a bet bypass that coin's cap. An empty
+ * result adds no field.
+ */
+export declare function coinsField(value: unknown): {
+    coins?: string[];
+};
+export declare function fundingByVenueOf(m: Record<string, unknown>, nowMs?: number): FundingByVenueContext | undefined;
+export declare function depthOf(m: Record<string, unknown>, nowMs?: number): DepthContext | undefined;
+export declare function chainTvlOf(m: Record<string, unknown>, nowMs?: number): ChainTvlContext | undefined;
+export declare function stablecoinSupplyOf(m: Record<string, unknown>, nowMs?: number): StablecoinSupplyContext | undefined;
+export declare function macroOf(m: Record<string, unknown>, nowMs?: number): MacroContext | undefined;
+/** Bench-only observation overrides; live callers pass none. */
+export interface ObserveOptions {
+    /** Read the curated PM board (depth 30, churn removed, calibration read)
+     *  even for a mechanical spec, so a bench baseline sees the recorded
+     *  agent opportunity set. Default: non-mechanical only. */
+    curatedPmBoard?: boolean;
+}
+export declare function observe(client: CoinRithmClient, spec: AgentSpec, state: RunState, trace?: AgentTrace, options?: ObserveOptions): Promise<ObserveOutput>;