@coinrithm/mcp-trading 0.7.7 → 0.7.8

package/dist/agent/types.d.ts

@@ -1,4 +1,5 @@
 import { IndicatorSet } from "./indicators.js";
+import type { DecisionInputRecord } from "./decisionReceipt.js";
 export declare const SPEC_VERSION = "coinrithm.agent.v1";
 export type Venue = "spot" | "futures" | "pm";
 export declare const VENUES: readonly Venue[];
@@ -39,6 +40,38 @@ export interface LimitsConfig {
     maxDailyLossMusd: number;
     maxOpenMarginMusd: number;
 }
+/** Opt-in paper experiment. Percent fields are percentage POINTS, not fractions. */
+export interface CapitalSizingPolicy {
+    version: "equity_fraction_v1";
+    futuresRiskPct: number;
+    pmMaxLossPct: number;
+    perTicketCapitalPct: number;
+    totalCapitalPct: number;
+    cashReservePct: number;
+    minRewardRisk: number;
+}
+export type CapitalBook = {
+    status: "unavailable";
+    reason: string;
+} | {
+    status: "ready";
+    walletId: number;
+    /** Marked spot + collateral, reduced by known negative position marks.
+     * Positive open-position gains are excluded; this is NOT complete MTM. */
+    conservativeEquityMusd: number;
+    cashAvailableMusd: number;
+    committedCapitalMusd: number;
+};
+export interface CapitalSizingAdjustment {
+    version: "equity_fraction_v1";
+    basis: "owned_collateral_spot_marked_negative_position_marks_only";
+    proposedAmountMusd?: number;
+    sizedAmountMusd?: number;
+    conservativeEquityMusd?: number;
+    riskBudgetMusd?: number;
+    /** Runner safety estimate, not a claim that the venue charges this fee. */
+    feeBufferBps?: number;
+}
 export interface AbstentionConfig {
     onStaleData: boolean;
     onWeakSignal: boolean;
@@ -72,6 +105,7 @@ export interface AgentSpec {
     model?: ModelConfig;
     venues: Venue[];
     risk: RiskConfig;
+    capitalSizing?: CapitalSizingPolicy;
     limits: LimitsConfig;
     abstention: AbstentionConfig;
     sync: SyncConfig;
@@ -95,6 +129,8 @@ export declare const fail: (code: string, reason: string) => ValidationResult;
 export interface Freshness {
     status: string;
     ageSeconds?: number;
+    asOf?: string;
+    basis?: string;
 }
 export interface WatchEntry {
     symbol: string;
@@ -108,10 +144,25 @@ export interface WatchEntry {
     freshness?: Freshness;
     indicators?: IndicatorSet;
     discovered?: boolean;
+    slug?: string;
+    fundamentals?: CoinFundamentals;
+}
+export interface CoinFundamentals {
+    categories?: string[];
+    marketCapRank?: number;
+    marketCapUsd?: number;
+    volume24hUsd?: number;
+    headlines?: Array<{
+        title: string;
+        at?: string;
+        importance?: number;
+        sentiment?: string;
+    }>;
 }
 export interface OpenPosition {
     venue: Venue;
     id: number;
+    walletId?: number;
     coinId?: string;
     symbol?: string;
     side?: string;
@@ -124,6 +175,8 @@ export interface OpenPosition {
     liquidationPrice?: number;
     stopLossPrice?: number;
     takeProfitPrice?: number;
+    openedAt?: string;
+    thesis?: ThesisView;
 }
 export interface SpotOrder {
     id: number;
@@ -136,12 +189,19 @@ export interface SpotOrder {
 }
 export interface PmPosition {
     id: number;
+    walletId?: number;
     source?: string;
     slug?: string;
     outcomeExternalMarketId?: string;
     stakeMusd?: number;
     unrealizedPnlMusd?: number;
     status?: string;
+    title?: string;
+    side?: string;
+    entryProbability?: number;
+    currentProbability?: number;
+    openedAt?: string;
+    thesis?: ThesisView;
 }
 export interface PmResolution {
     id: number;
@@ -162,6 +222,27 @@ export interface PmMarket {
     title?: string;
     freshness?: Freshness;
     volumeUsd?: number;
+    endDate?: string;
+    liquidityUsd?: number;
+    quality?: PmQuality;
+    decisionSupport?: PmDecisionSupport;
+}
+export interface PmQuality {
+    decisionEligible?: boolean;
+    warningReasons: string[];
+    blockReasons: string[];
+    policyVersion?: string;
+    assessedAt?: string;
+    reasonsOmitted?: boolean;
+}
+export interface PmDecisionSupport {
+    qualityScore?: number;
+    qualityTier?: string;
+    qualityCapReason?: string | null;
+    spreadTier?: string;
+    liquidityTier?: string;
+    volumeTier?: string;
+    flags?: Partial<Record<"thinMarket" | "inactiveMarket" | "highAmbiguity" | "nearResolution" | "staleData", boolean>>;
 }
 export interface SetupSignal {
     symbol: string;
@@ -177,6 +258,7 @@ export interface NewsItem {
     sentiment?: string;
     importance?: number;
     ageHours?: number;
+    publishedAt?: string;
     coins?: string[];
 }
 export interface Observation {
@@ -184,6 +266,7 @@ export interface Observation {
     scopes: string[];
     cashAvailableMusd: number | null;
     equityMusd: number | null;
+    capitalBook?: CapitalBook;
     openPositions: OpenPosition[];
     openOrders: SpotOrder[];
     pmPositions: PmPosition[];
@@ -206,6 +289,35 @@ export interface Observation {
         priceUsd?: number;
     }>;
 }
+export interface ThesisInvalidation {
+    priceBelow?: number;
+    priceAbove?: number;
+    probabilityBelow?: number;
+    probabilityAbove?: number;
+    maxHoldMinutes?: number;
+    catalyst?: string;
+}
+export interface Thesis {
+    summary: string;
+    invalidation: ThesisInvalidation;
+}
+export interface PositionThesis extends Thesis {
+    venue: Venue;
+    positionId: number;
+    symbol?: string;
+    side?: string;
+    source?: string;
+    slug?: string;
+    outcomeExternalMarketId?: string;
+    openedAt: string;
+    entryPrice?: number;
+    entryProbability?: number;
+}
+export interface ThesisView extends Thesis {
+    holdMinutes: number;
+    status: "intact" | "invalidated";
+    invalidatedBy?: string;
+}
 export type ProposedAction = {
     type: "futures_open";
     symbol: string;
@@ -216,6 +328,7 @@ export type ProposedAction = {
     takeProfitPrice?: number | null;
     confidence?: number;
     rationaleSummary?: string;
+    thesis?: Thesis;
 } | {
     type: "futures_close";
     positionId: number;
@@ -237,6 +350,7 @@ export type ProposedAction = {
     stopPrice?: number;
     confidence?: number;
     rationaleSummary?: string;
+    thesis?: Thesis;
 } | {
     type: "spot_cancel";
     orderId: number;
@@ -250,6 +364,7 @@ export type ProposedAction = {
     confidence?: number;
     rationaleSummary?: string;
     forecastProbability?: number;
+    thesis?: Thesis;
 };
 export type ActionVenue = Venue;
 export declare function actionVenue(a: ProposedAction): ActionVenue;
@@ -273,7 +388,14 @@ export interface QuoteEvidence {
     entryPrice?: number;
     liquidationPrice?: number;
     executionPrice?: number;
+    entryProbability?: number;
+    stakeMusd?: number;
+    sharesEstimate?: number;
     estimatedCostMusd?: number;
+    estimatedFeeMusd?: number;
+    futuresFeeBps?: number;
+    estimatedEntryFeeMusd?: number;
+    cashRequiredMusd?: number;
     freshness?: Freshness;
     openBlocked?: boolean;
     openBlockReasons?: unknown;
@@ -282,6 +404,7 @@ export interface RunState {
     runId: string;
     cyclesRun: number;
     writesToday: number;
+    riskIncreasesToday: number;
     realizedPnlMusd: number;
     peakRealizedMusd: number;
     consecutiveRejectCycles: number;
@@ -304,6 +427,7 @@ export interface RunState {
         at: string;
         did: string;
     }>;
+    theses?: Record<string, PositionThesis>;
 }
 export interface AgentTrace {
     runId?: string;
@@ -330,8 +454,11 @@ export interface PlannedAction {
     quote?: QuoteEvidence;
     executed?: boolean;
     result?: unknown;
+    capitalSizing?: CapitalSizingAdjustment;
 }
 export interface CycleResult {
+    /** Private non-enumerable evidence. Never forward through AgentTrace/public APIs. */
+    decisionInputRecord?: DecisionInputRecord;
     decision: "skip" | "act";
     skipReason?: string;
     rationale?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinrithm/mcp-trading",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "mcpName": "io.github.CoinRithm/mcp-trading",
   "description": "CoinRithm paper-trading toolkit: an MCP server (coinrithm-mcp) AND a self-host agent runner (coinrithm-agent) for spot, futures, and prediction markets with a user-minted API key.",
   "type": "module",