@coinrithm/mcp-trading 0.7.6 → 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[];
@@ -31,6 +32,7 @@ export interface RiskConfig {
     requireStopLoss: boolean;
     watchlist: string[];
     blocklist?: string[];
+    direction?: "long_only" | "short_only";
 }
 export interface LimitsConfig {
     maxTradesPerDay: number;
@@ -38,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;
@@ -71,6 +105,7 @@ export interface AgentSpec {
     model?: ModelConfig;
     venues: Venue[];
     risk: RiskConfig;
+    capitalSizing?: CapitalSizingPolicy;
     limits: LimitsConfig;
     abstention: AbstentionConfig;
     sync: SyncConfig;
@@ -94,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;
@@ -107,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;
@@ -123,6 +175,8 @@ export interface OpenPosition {
     liquidationPrice?: number;
     stopLossPrice?: number;
     takeProfitPrice?: number;
+    openedAt?: string;
+    thesis?: ThesisView;
 }
 export interface SpotOrder {
     id: number;
@@ -135,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;
@@ -161,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;
@@ -176,6 +258,7 @@ export interface NewsItem {
     sentiment?: string;
     importance?: number;
     ageHours?: number;
+    publishedAt?: string;
     coins?: string[];
 }
 export interface Observation {
@@ -183,6 +266,7 @@ export interface Observation {
     scopes: string[];
     cashAvailableMusd: number | null;
     equityMusd: number | null;
+    capitalBook?: CapitalBook;
     openPositions: OpenPosition[];
     openOrders: SpotOrder[];
     pmPositions: PmPosition[];
@@ -205,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;
@@ -215,6 +328,7 @@ export type ProposedAction = {
     takeProfitPrice?: number | null;
     confidence?: number;
     rationaleSummary?: string;
+    thesis?: Thesis;
 } | {
     type: "futures_close";
     positionId: number;
@@ -236,6 +350,7 @@ export type ProposedAction = {
     stopPrice?: number;
     confidence?: number;
     rationaleSummary?: string;
+    thesis?: Thesis;
 } | {
     type: "spot_cancel";
     orderId: number;
@@ -249,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;
@@ -272,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;
@@ -281,6 +404,7 @@ export interface RunState {
     runId: string;
     cyclesRun: number;
     writesToday: number;
+    riskIncreasesToday: number;
     realizedPnlMusd: number;
     peakRealizedMusd: number;
     consecutiveRejectCycles: number;
@@ -303,6 +427,7 @@ export interface RunState {
         at: string;
         did: string;
     }>;
+    theses?: Record<string, PositionThesis>;
 }
 export interface AgentTrace {
     runId?: string;
@@ -329,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;
@@ -340,6 +468,16 @@ export interface CycleResult {
     modelFailed?: boolean;
     disabled?: boolean;
     disabledReason?: string;
+    /** Reliability slice 1 (2026-08-26): a PERMANENT provider/model failure
+     * (404/410/decommission class) no longer disables the agent. The runner
+     * reports the hold; the scheduler aggregates holds into a fleet-wide
+     * provider circuit (skip-claiming + backoff probes). User pauses, revoked
+     * credentials, drawdown and safety stops keep using `disabled`. */
+    providerHold?: {
+        provider: string;
+        model: string;
+        error: string;
+    };
     live: boolean;
     observationHash?: string;
     indicatorVersion?: string;
@@ -348,6 +486,19 @@ export interface CycleResult {
     tokensIn?: number;
     tokensOut?: number;
     estimatedCostUsd?: number;
+    effectiveProvider?: string;
+    effectiveModel?: string;
+    routeReason?: string;
+    routeAttempts?: Array<{
+        provider: string;
+        model: string;
+        outcome: "success" | "failed" | "deferred";
+        failureClass?: "capacity" | "permanent" | "transient" | "malformed";
+        status?: number;
+        retryAfterMs?: number;
+        latencyMs: number;
+        error?: string;
+    }>;
     decisionType?: "act" | "skip" | "gate_skip" | "model_error";
     writeAttempted?: number;
     writeAccepted?: number;

package/dist/http.js

@@ -79,6 +79,27 @@ async function main() {
             },
         });
     });
+    // robots.txt for THIS host. robots.txt is per-HOST, so www.coinrithm.com's
+    // file never governed mcp.coinrithm.com — a separate origin that had no
+    // route of its own. The origin 404'd and Cloudflare answered with its
+    // managed content-signals boilerplate: 1,248 bytes of comments carrying ZERO
+    // User-agent/Disallow/Allow lines, which a crawler reads as "crawl
+    // everything". That is the identical failure that cost api.coinrithm.com
+    // 15.4% of the site's 90-day crawl budget (4,468 of 29,100 GSC requests)
+    // before it was closed on 2026-08-20.
+    //
+    // Nothing here is indexable: GET / is a JSON service descriptor, GET /mcp is
+    // a 405, and the real surface is POST-only streamable HTTP. The human-facing
+    // documentation crawlers should index lives on www.coinrithm.com
+    // (/en/agentic-trading, /en/prediction-markets/api), which links here.
+    //
+    // SAFE FOR MCP CLIENTS AND REGISTRIES: robots.txt is advisory to CRAWLERS
+    // only. MCP clients, Smithery and the MCP registry POST /mcp or GET /healthz
+    // directly and never consult robots.txt, so this cannot gate discovery,
+    // initialization or tool listing. Do not "fix" a registry problem here.
+    app.get("/robots.txt", (_req, res) => {
+        res.type("text/plain").send("User-agent: *\nDisallow: /\n");
+    });
     app.get("/mcp", (_req, res) => {
         res.status(405).json({
             error: "method_not_allowed",

package/dist/tools.js

@@ -971,16 +971,16 @@ export function registerTools(server, client) {
     }, async ({ runId, agentTrace }, extra) => present(await client.exportLedger({ runId }, requestKey(extra), agentTrace)));
     server.registerTool("get_arena_leaderboard", {
         title: "Get Agent Arena leaderboard",
-        description: "The public Agent Arena: opted-in agents ranked by total realized PnL " +
-            "(mUSD) across spot, futures, and prediction markets, with per-venue " +
-            "breakdown and win rate. Only agents with at least minDecidedTrades " +
-            "decided (win+loss) trades rank (currently 3 — echoed in the " +
-            "response); demo/house agents seed the board until live agents " +
-            "qualify. Rows also carry a 44-day sparkline, badges, rankDelta, " +
-            "biggestWinMusd, and the self-reported model label. Pass " +
-            "window='7d'|'30d' for the weekly/monthly board — re-ranked by PnL " +
-            "realized inside the window (badges/biggestWin and the min-decided " +
-            "gate stay all-time). Use it to see the field and where you stand — pair " +
+        description: "The public Agent Arena across spot, futures, and prediction markets. " +
+            "The response publishes the arena-ranking-v1 contract: five decided " +
+            "trades qualify an agent for normal ordering; positive realized PnL is " +
+            "weighted by the 95% Wilson win-confidence lower bound; non-positive " +
+            "PnL is used directly. Agents below five remain listed after qualified " +
+            "agents; fewer than 20 decided trades is a separate small-sample " +
+            "warning. Rows carry per-venue results, a 90-day sparkline, badges, " +
+            "rankDelta, biggestWinMusd, and a self-reported model label. Pass " +
+            "window='today'|'24h'|'7d'|'30d'|'3m'|'all'. Use it to see the field " +
+            "and where you stand — pair " +
             "with get_performance (your own scorecard) and get_arena_agent (drill " +
             "into one handle). Public data: agent names + performance only. " +
             PAPER_NOTE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinrithm/mcp-trading",
-  "version": "0.7.6",
+  "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",