desic-okx-agent 0.2.1 → 0.3.0

package/dist/strategy/store.js

@@ -0,0 +1,367 @@
+import crypto from "node:crypto";
+import { RuntimeError } from "../core/errors.js";
+import { MAX_PAGE_ROWS } from "./constants.js";
+import { STRATEGY_SCHEMA_SQL } from "./schema.js";
+/** Points per stored blob. Four float64 columns per point. */
+const CHUNK_POINTS = 8_192;
+const BYTES_PER_POINT = 32;
+export class StrategyStore {
+    db;
+    now;
+    constructor(db, now = Date.now) {
+        this.db = db;
+        this.now = now;
+        this.db.exec(STRATEGY_SCHEMA_SQL);
+        this.migrate();
+    }
+    /**
+     * Adds columns introduced after a database was first created.
+     *
+     * `CREATE TABLE IF NOT EXISTS` does nothing to an existing table, so a new
+     * column is invisible to anyone upgrading — every read then fails with "no
+     * such column" until the file is deleted.
+     */
+    migrate() {
+        const columns = new Set(this.db.prepare("PRAGMA table_info(strategy_runs)").all().map((row) => row.name));
+        // Additive only: each entry must be nullable so existing rows stay valid.
+        const additions = [["assumptions_json", "TEXT"]];
+        for (const [name, type] of additions) {
+            if (!columns.has(name))
+                this.db.exec(`ALTER TABLE strategy_runs ADD COLUMN ${name} ${type}`);
+        }
+    }
+    /**
+     * Marks runs left behind by a previous process as failed.
+     *
+     * A queued or running row cannot survive a restart: its worker is gone, so
+     * leaving it in place would show a run that will never progress.
+     */
+    failInterruptedRuns() {
+        const result = this.db
+            .prepare(`UPDATE strategy_runs SET status='failed', error=?, finished_at=?
+         WHERE status IN ('queued','running')`)
+            .run("The runtime restarted before this run could finish", this.now());
+        return result.changes;
+    }
+    createRun(input) {
+        const id = `${input.kind === "backtest" ? "bt" : "opt"}_${crypto.randomBytes(6).toString("hex")}`;
+        this.db
+            .prepare(`INSERT INTO strategy_runs(
+           id,kind,status,strategy_name,strategy_hash,strategy_source,inst_id,request_json,created_at
+         ) VALUES(?,?,'queued',?,?,?,?,?,?)`)
+            .run(id, input.kind, input.strategyName, sourceHash(input.source), input.source, input.instId, JSON.stringify(input.request), this.now());
+        return id;
+    }
+    markRunning(id, barCount, preloadBars, dataSnapshotId, assumptions) {
+        this.db
+            .prepare(`UPDATE strategy_runs SET status='running', started_at=?, bar_count=?, preload_bars=?,
+                data_snapshot_id=?, assumptions_json=?
+         WHERE id=? AND status='queued'`)
+            .run(this.now(), barCount, preloadBars, dataSnapshotId, assumptions === undefined ? null : JSON.stringify(assumptions), id);
+    }
+    updateProgress(id, progressPct, etaMs) {
+        this.db
+            .prepare("UPDATE strategy_runs SET progress_pct=?, eta_ms=? WHERE id=? AND status='running'")
+            .run(Math.max(0, Math.min(100, progressPct)), etaMs, id);
+    }
+    completeRun(id, metrics, equity, trades, actions) {
+        const transaction = this.db.transaction(() => {
+            this.db
+                .prepare("UPDATE strategy_runs SET status='completed', progress_pct=100, eta_ms=0, metrics_json=?, finished_at=? WHERE id=?")
+                .run(JSON.stringify(metrics), this.now(), id);
+            this.writeSeries(id, equity);
+            this.writeRows("strategy_run_trades", "trade_json", id, trades);
+            this.writeRows("strategy_run_actions", "action_json", id, actions);
+        });
+        transaction();
+    }
+    failRun(id, error) {
+        this.db
+            .prepare("UPDATE strategy_runs SET status='failed', error=?, finished_at=? WHERE id=?")
+            .run(error.slice(0, 2_000), this.now(), id);
+    }
+    cancelRun(id) {
+        const result = this.db
+            .prepare(`UPDATE strategy_runs SET status='cancelled', error=?, finished_at=?
+         WHERE id=? AND status IN ('queued','running')`)
+            .run("Cancelled by request", this.now(), id);
+        return result.changes > 0;
+    }
+    run(id) {
+        const row = this.db
+            .prepare(`SELECT id,kind,status,strategy_name,strategy_hash,inst_id,data_snapshot_id,bar_count,preload_bars,
+                progress_pct,eta_ms,metrics_json,assumptions_json,error,created_at,started_at,finished_at
+         FROM strategy_runs WHERE id=?`)
+            .get(id);
+        return row ? toSummary(row) : undefined;
+    }
+    runSource(id) {
+        const row = this.db.prepare("SELECT strategy_source FROM strategy_runs WHERE id=?").get(id);
+        return row?.strategy_source;
+    }
+    /**
+     * The request a run was queued with.
+     *
+     * Read back rather than recomputed: an optimize report needs the space and
+     * budget exactly as they were resolved, and re-deriving them from current
+     * settings would describe a different search than the one that ran.
+     */
+    runRequest(id) {
+        const row = this.db.prepare("SELECT request_json FROM strategy_runs WHERE id=?").get(id);
+        if (!row)
+            return undefined;
+        try {
+            return JSON.parse(row.request_json);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    listRuns(options = {}) {
+        const limit = Math.max(1, Math.min(options.limit ?? 20, 200));
+        const clauses = [];
+        const values = [];
+        if (options.status) {
+            clauses.push("status=?");
+            values.push(options.status);
+        }
+        if (options.instId) {
+            clauses.push("inst_id=?");
+            values.push(options.instId);
+        }
+        const where = clauses.length ? `WHERE ${clauses.join(" AND ")}` : "";
+        const rows = this.db
+            .prepare(`SELECT id,kind,status,strategy_name,strategy_hash,inst_id,data_snapshot_id,bar_count,preload_bars,
+                progress_pct,eta_ms,metrics_json,assumptions_json,error,created_at,started_at,finished_at
+         FROM strategy_runs ${where} ORDER BY created_at DESC LIMIT ?`)
+            .all(...values, limit);
+        return rows.map(toSummary);
+    }
+    /**
+     * The most recent completed backtest of this exact source on this instrument.
+     *
+     * Matched on the source hash rather than a name or a file path: enabling a profile
+     * requires evidence that *this* code was run against *this* contract, and a hash is
+     * the only thing that cannot drift when a file is edited.
+     *
+     * A failed or cancelled run does not count. It says nothing about whether the
+     * strategy works, which is the entire reason the evidence is required.
+     */
+    latestCompletedRun(strategyHash, instId) {
+        const row = this.db
+            .prepare(`SELECT id,kind,status,strategy_name,strategy_hash,inst_id,data_snapshot_id,bar_count,preload_bars,
+                progress_pct,eta_ms,metrics_json,assumptions_json,error,created_at,started_at,finished_at
+         FROM strategy_runs
+         WHERE strategy_hash=? AND inst_id=? AND kind='backtest' AND status='completed'
+         ORDER BY created_at DESC LIMIT 1`)
+            .get(strategyHash, instId);
+        return row ? toSummary(row) : undefined;
+    }
+    deleteRun(id) {
+        const transaction = this.db.transaction(() => {
+            this.db.prepare("DELETE FROM strategy_run_series WHERE run_id=?").run(id);
+            this.db.prepare("DELETE FROM strategy_run_trades WHERE run_id=?").run(id);
+            this.db.prepare("DELETE FROM strategy_run_actions WHERE run_id=?").run(id);
+            this.db.prepare("DELETE FROM strategy_optimization_candidates WHERE run_id=?").run(id);
+            return this.db.prepare("DELETE FROM strategy_runs WHERE id=?").run(id).changes > 0;
+        });
+        return transaction();
+    }
+    equity(id, offset = 0, limit = 1_000) {
+        const total = this.equityLength(id);
+        const bounded = Math.max(1, Math.min(limit, MAX_PAGE_ROWS));
+        const start = Math.max(0, offset);
+        const rows = [];
+        if (start >= total)
+            return { rows, offset: start, limit: bounded, total };
+        const end = Math.min(total, start + bounded);
+        const chunks = this.db
+            .prepare(`SELECT chunk_index,from_point,to_point,start_ms,step_ms,payload FROM strategy_run_series
+         WHERE run_id=? AND to_point>=? AND from_point<? ORDER BY chunk_index ASC`)
+            .all(id, start, end);
+        for (const chunk of chunks) {
+            const count = chunk.to_point - chunk.from_point + 1;
+            for (let index = 0; index < count; index += 1) {
+                const point = chunk.from_point + index;
+                if (point < start || point >= end)
+                    continue;
+                const base = index * BYTES_PER_POINT;
+                rows.push({
+                    timeMs: chunk.payload.readDoubleLE(base),
+                    equityUsdt: chunk.payload.readDoubleLE(base + 8),
+                    realizedCashUsdt: chunk.payload.readDoubleLE(base + 16),
+                    unrealizedPnlUsdt: chunk.payload.readDoubleLE(base + 24)
+                });
+            }
+        }
+        return { rows, offset: start, limit: bounded, total };
+    }
+    equityLength(id) {
+        const row = this.db
+            .prepare("SELECT COALESCE(MAX(to_point) + 1, 0) AS total FROM strategy_run_series WHERE run_id=?")
+            .get(id);
+        return Number(row.total);
+    }
+    trades(id, offset = 0, limit = 200) {
+        return this.readRows("strategy_run_trades", "trade_json", id, offset, limit);
+    }
+    /**
+     * Records the candidate set up front, before any of it has run.
+     *
+     * Written in one transaction so a reader never sees a partial set and mistakes
+     * it for a smaller search than the one under way.
+     */
+    seedCandidates(runId, candidates) {
+        const statement = this.db.prepare(`INSERT INTO strategy_optimization_candidates(run_id,candidate_index,params_json,status)
+       VALUES(?,?,?,'queued')`);
+        this.db.transaction(() => {
+            candidates.forEach((params, index) => statement.run(runId, index, JSON.stringify(params)));
+        })();
+    }
+    markCandidateRunning(runId, index) {
+        this.db
+            .prepare(`UPDATE strategy_optimization_candidates SET status='running'
+         WHERE run_id=? AND candidate_index=? AND status='queued'`)
+            .run(runId, index);
+    }
+    completeCandidate(runId, index, result) {
+        this.db
+            .prepare(`UPDATE strategy_optimization_candidates
+         SET status='completed', train_metrics_json=?, validation_metrics_json=?,
+             rank_score=?, rank_basis=?, verdict=?, error=NULL
+         WHERE run_id=? AND candidate_index=?`)
+            .run(JSON.stringify(result.train), JSON.stringify(result.validation), 
+        // A non-finite score would sort unpredictably in SQLite; it is stored as
+        // null so a failed measurement ranks last instead of first.
+        Number.isFinite(result.rankScore) ? result.rankScore : null, result.rankBasis, result.verdict, runId, index);
+    }
+    failCandidate(runId, index, error) {
+        this.db
+            .prepare(`UPDATE strategy_optimization_candidates SET status='failed', error=?, rank_score=NULL
+         WHERE run_id=? AND candidate_index=?`)
+            .run(error.slice(0, 2_000), runId, index);
+    }
+    /**
+     * Candidates in rank order, best first.
+     *
+     * `rank_score IS NULL` sorts last explicitly: SQLite orders nulls first under
+     * `DESC`, which would put every failure above the winner.
+     */
+    candidates(runId, limit = 200) {
+        const bounded = Math.max(1, Math.min(limit, MAX_PAGE_ROWS));
+        const rows = this.db
+            .prepare(`SELECT candidate_index,params_json,status,train_metrics_json,validation_metrics_json,
+                rank_score,rank_basis,verdict,error
+         FROM strategy_optimization_candidates WHERE run_id=?
+         ORDER BY rank_score IS NULL ASC, rank_score DESC, candidate_index ASC
+         LIMIT ?`)
+            .all(runId, bounded);
+        return rows.map(toCandidate);
+    }
+    candidateCounts(runId) {
+        const rows = this.db
+            .prepare("SELECT status, COUNT(*) AS count FROM strategy_optimization_candidates WHERE run_id=? GROUP BY status")
+            .all(runId);
+        const counts = { queued: 0, running: 0, completed: 0, failed: 0, total: 0 };
+        for (const row of rows) {
+            counts[row.status] = Number(row.count);
+            counts.total += Number(row.count);
+        }
+        return counts;
+    }
+    actions(id, offset = 0, limit = 200) {
+        return this.readRows("strategy_run_actions", "action_json", id, offset, limit);
+    }
+    writeSeries(id, equity) {
+        if (equity.length === 0)
+            return;
+        const statement = this.db.prepare(`INSERT INTO strategy_run_series(run_id,chunk_index,from_point,to_point,start_ms,step_ms,payload)
+       VALUES(?,?,?,?,?,?,?)`);
+        let chunkIndex = 0;
+        for (let start = 0; start < equity.length; start += CHUNK_POINTS) {
+            const slice = equity.slice(start, start + CHUNK_POINTS);
+            const payload = Buffer.allocUnsafe(slice.length * BYTES_PER_POINT);
+            slice.forEach((point, index) => {
+                const base = index * BYTES_PER_POINT;
+                payload.writeDoubleLE(point.timeMs, base);
+                payload.writeDoubleLE(point.equityUsdt, base + 8);
+                payload.writeDoubleLE(point.realizedCashUsdt, base + 16);
+                payload.writeDoubleLE(point.unrealizedPnlUsdt, base + 24);
+            });
+            const first = slice[0];
+            const step = slice.length > 1 ? slice[1].timeMs - first.timeMs : 0;
+            statement.run(id, chunkIndex, start, start + slice.length - 1, first.timeMs, step, payload);
+            chunkIndex += 1;
+        }
+    }
+    writeRows(table, column, id, rows) {
+        if (rows.length === 0)
+            return;
+        const statement = this.db.prepare(`INSERT INTO ${table}(run_id,seq,${column}) VALUES(?,?,?)`);
+        rows.forEach((row, index) => statement.run(id, index, JSON.stringify(row)));
+    }
+    readRows(table, column, id, offset, limit) {
+        const bounded = Math.max(1, Math.min(limit, MAX_PAGE_ROWS));
+        const start = Math.max(0, offset);
+        const totalRow = this.db.prepare(`SELECT COUNT(*) AS total FROM ${table} WHERE run_id=?`).get(id);
+        const rows = this.db
+            .prepare(`SELECT ${column} AS value FROM ${table} WHERE run_id=? AND seq>=? ORDER BY seq ASC LIMIT ?`)
+            .all(id, start, bounded);
+        return {
+            rows: rows.map((row) => JSON.parse(row.value)),
+            offset: start,
+            limit: bounded,
+            total: Number(totalRow.total)
+        };
+    }
+}
+export function sourceHash(source) {
+    return crypto.createHash("sha256").update(source, "utf8").digest("hex");
+}
+function toSummary(row) {
+    const metrics = row.metrics_json ? JSON.parse(String(row.metrics_json)) : null;
+    const assumptions = row.assumptions_json
+        ? JSON.parse(String(row.assumptions_json))
+        : null;
+    return {
+        id: String(row.id),
+        kind: String(row.kind),
+        status: String(row.status),
+        strategyName: String(row.strategy_name),
+        strategyHash: String(row.strategy_hash),
+        instId: String(row.inst_id),
+        dataSnapshotId: row.data_snapshot_id === null ? null : String(row.data_snapshot_id),
+        barCount: Number(row.bar_count),
+        preloadBars: Number(row.preload_bars),
+        progressPct: Number(row.progress_pct),
+        etaMs: row.eta_ms === null ? null : Number(row.eta_ms),
+        metrics,
+        assumptions,
+        error: row.error === null ? null : String(row.error),
+        createdAt: Number(row.created_at),
+        startedAt: row.started_at === null ? null : Number(row.started_at),
+        finishedAt: row.finished_at === null ? null : Number(row.finished_at)
+    };
+}
+function toCandidate(row) {
+    return {
+        candidateIndex: Number(row.candidate_index),
+        params: JSON.parse(String(row.params_json)),
+        status: String(row.status),
+        train: row.train_metrics_json ? JSON.parse(String(row.train_metrics_json)) : null,
+        validation: row.validation_metrics_json
+            ? JSON.parse(String(row.validation_metrics_json))
+            : null,
+        rankScore: row.rank_score === null || row.rank_score === undefined ? null : Number(row.rank_score),
+        rankBasis: row.rank_basis === null || row.rank_basis === undefined ? null : String(row.rank_basis),
+        verdict: row.verdict === null || row.verdict === undefined ? null : String(row.verdict),
+        error: row.error === null || row.error === undefined ? null : String(row.error)
+    };
+}
+export function requireRun(store, id) {
+    const run = store.run(id);
+    if (!run)
+        throw new RuntimeError("NOT_FOUND", `Unknown strategy run '${id}'`);
+    return run;
+}
+//# sourceMappingURL=store.js.map

package/dist/strategy/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/strategy/store.ts"],"names":[],"mappings":"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"}

package/dist/strategy/templates.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Starting points for a new strategy.
+ *
+ * Each one is valid under the source policy and demonstrates the contract that
+ * is easiest to get wrong: read documented fields directly, return exactly one
+ * decision per bar, and let the host size the position.
+ */
+export declare const TEMPLATE_NAMES: readonly ["blank", "ema-trend", "atr-breakout", "bollinger-reversion"];
+export type TemplateName = (typeof TEMPLATE_NAMES)[number];
+export declare function isTemplateName(value: string): value is TemplateName;
+export declare function template(name: TemplateName): string;

package/dist/strategy/templates.js

@@ -0,0 +1,134 @@
+/**
+ * Starting points for a new strategy.
+ *
+ * Each one is valid under the source policy and demonstrates the contract that
+ * is easiest to get wrong: read documented fields directly, return exactly one
+ * decision per bar, and let the host size the position.
+ */
+export const TEMPLATE_NAMES = ["blank", "ema-trend", "atr-breakout", "bollinger-reversion"];
+const BLANK = `"""Blank strategy skeleton.
+
+on_bar runs after every confirmed one-minute close. Return exactly one decision.
+A market decision fills at the next bar's open; the host derives the size.
+"""
+
+
+def on_bar(ctx):
+    # ctx.market.bars(ctx.instrument_id, "1m", lookback=N) -> confirmed bars
+    # ctx.indicators.ema(ctx.instrument_id, "1m", period)  -> None until warm
+    # ctx.portfolio.position(ctx.instrument_id, "long")    -> Position or None
+    return ctx.no_action("no rule implemented yet")
+`;
+const EMA_TREND = `"""Dual EMA trend following.
+
+Enters long when the fast EMA leads the slow one and exits on the reverse cross.
+Both values are None until enough bars exist, so the warm-up is explicit.
+"""
+
+
+def on_bar(ctx):
+    fast_period = int(ctx.params.get("fastPeriod", 20))
+    slow_period = int(ctx.params.get("slowPeriod", 60))
+
+    fast = ctx.indicators.ema(ctx.instrument_id, "1m", fast_period)
+    slow = ctx.indicators.ema(ctx.instrument_id, "1m", slow_period)
+    if fast is None or slow is None:
+        return ctx.no_action("indicators warming up")
+
+    position = ctx.portfolio.position(ctx.instrument_id, "long")
+    if position is None and fast > slow:
+        return ctx.open_long("fast EMA above slow EMA")
+    if position is not None and fast < slow:
+        return ctx.close_long("fast EMA below slow EMA")
+    return ctx.no_action("holding current state")
+`;
+const ATR_BREAKOUT = `"""Breakout with an ATR-scaled protective stop.
+
+The stop is attached to the opening decision as an absolute price, so the first
+minute of the position is already covered.
+"""
+
+
+def on_bar(ctx):
+    lookback = int(ctx.params.get("lookback", 60))
+    atr_period = int(ctx.params.get("atrPeriod", 14))
+    stop_multiple = float(ctx.params.get("stopMultiple", 3.0))
+
+    bars = ctx.market.bars(ctx.instrument_id, "1m", lookback=lookback)
+    atr = ctx.indicators.atr(ctx.instrument_id, "1m", atr_period)
+    if len(bars) < lookback or atr is None:
+        return ctx.no_action("waiting for a full lookback window")
+
+    # The current bar is the last item, so compare against the prior window.
+    prior = bars[:-1]
+    highest = max(bar.high for bar in prior)
+    lowest = min(bar.low for bar in prior)
+    close = bars[-1].close
+
+    position = ctx.portfolio.position(ctx.instrument_id, "long")
+    if position is None and close > highest:
+        return ctx.open_long(
+            "closed above the prior range high",
+            protection={"stopLossPrice": close - atr * stop_multiple},
+        )
+    if position is not None and close < lowest:
+        return ctx.close_long("closed below the prior range low")
+    return ctx.no_action("inside the prior range")
+`;
+const BOLLINGER_REVERSION = `"""Mean reversion around a moving average band.
+
+Bands are computed from the visible confirmed window, so nothing here can read a
+bar later than the current cutoff.
+"""
+
+import math
+
+
+def _mean(values):
+    return sum(values) / len(values)
+
+
+def _stdev(values, mean):
+    if len(values) < 2:
+        return 0.0
+    variance = sum((value - mean) ** 2 for value in values) / (len(values) - 1)
+    return math.sqrt(variance)
+
+
+def on_bar(ctx):
+    period = int(ctx.params.get("period", 60))
+    width = float(ctx.params.get("width", 2.0))
+
+    bars = ctx.market.bars(ctx.instrument_id, "1m", lookback=period)
+    if len(bars) < period:
+        return ctx.no_action("waiting for a full window")
+
+    closes = [bar.close for bar in bars]
+    mean = _mean(closes)
+    deviation = _stdev(closes, mean)
+    if deviation <= 0:
+        return ctx.no_action("no dispersion to trade")
+
+    close = closes[-1]
+    lower = mean - deviation * width
+
+    position = ctx.portfolio.position(ctx.instrument_id, "long")
+    if position is None and close < lower:
+        return ctx.open_long("closed below the lower band")
+    if position is not None and close >= mean:
+        return ctx.close_long("reverted to the mean")
+    return ctx.no_action("inside the bands")
+`;
+const TEMPLATES = {
+    blank: BLANK,
+    "ema-trend": EMA_TREND,
+    "atr-breakout": ATR_BREAKOUT,
+    "bollinger-reversion": BOLLINGER_REVERSION
+};
+export function isTemplateName(value) {
+    return Object.hasOwn(TEMPLATES, value);
+}
+export function template(name) {
+    return TEMPLATES[name];
+}
+//# sourceMappingURL=templates.js.map

package/dist/strategy/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/strategy/templates.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,qBAAqB,CAAU,CAAC;AAIrG,MAAM,KAAK,GAAG;;;;;;;;;;;;CAYb,CAAC;AAEF,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBjB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCpB,CAAC;AAEF,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C3B,CAAC;AAEF,MAAM,SAAS,GAAiC;IAC9C,KAAK,EAAE,KAAK;IACZ,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,YAAY;IAC5B,qBAAqB,EAAE,mBAAmB;CAC3C,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAkB;IACzC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/strategy/types.d.ts

@@ -0,0 +1,111 @@
+export type RunKind = "backtest" | "optimize";
+export type RunStatus = "queued" | "running" | "completed" | "failed" | "cancelled";
+export interface BacktestRequest {
+    instId: string;
+    source: string;
+    strategyName?: string;
+    params?: Record<string, unknown>;
+    intervals?: string[];
+    fromMs?: number;
+    toMs?: number;
+    days?: number;
+    preloadBars?: number;
+    initialEquityUsdt?: number;
+    leverage?: number;
+    marginSafetyMultiplier?: number;
+    entryBudgetUsdt?: number;
+    entryBudgetPct?: number;
+    takerFeeRate?: number;
+    makerFeeRate?: number;
+    entrySlippageBps?: number;
+    exitSlippageBps?: number;
+    closeAtEnd?: boolean;
+}
+export interface RunSummary {
+    id: string;
+    kind: RunKind;
+    status: RunStatus;
+    strategyName: string;
+    strategyHash: string;
+    instId: string;
+    dataSnapshotId: string | null;
+    barCount: number;
+    preloadBars: number;
+    progressPct: number;
+    etaMs: number | null;
+    metrics: Record<string, unknown> | null;
+    /** Assumptions this run used, as sent to the engine. */
+    assumptions: Record<string, unknown> | null;
+    error: string | null;
+    createdAt: number;
+    startedAt: number | null;
+    finishedAt: number | null;
+}
+export interface EquityPoint {
+    timeMs: number;
+    equityUsdt: number;
+    realizedCashUsdt: number;
+    unrealizedPnlUsdt: number;
+}
+export interface PolicyViolation {
+    line: number;
+    code: string;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    violations: PolicyViolation[];
+}
+export interface Page<T> {
+    rows: T[];
+    offset: number;
+    limit: number;
+    total: number;
+}
+/** An optimize request: a backtest, plus what to vary and how hard to look. */
+export interface OptimizeRequest extends BacktestRequest {
+    /** Per-parameter { min, max, step }. Validated against the strategy's own params. */
+    space: Record<string, unknown>;
+    /** Candidates to evaluate. Defaults to DEFAULT_BUDGET. */
+    budget?: number;
+}
+export type CandidateStatus = "queued" | "running" | "completed" | "failed";
+export interface CandidateRow {
+    candidateIndex: number;
+    params: Record<string, number>;
+    status: CandidateStatus;
+    /** Metrics over the searched segment. */
+    train: Record<string, unknown> | null;
+    /** Metrics over the held-back segment. These are the reportable ones. */
+    validation: Record<string, unknown> | null;
+    rankScore: number | null;
+    rankBasis: string | null;
+    verdict: string | null;
+    error: string | null;
+}
+/** Everything needed to render an optimize report. */
+export interface OptimizationReport {
+    run: RunSummary;
+    space: Record<string, {
+        min: number;
+        max: number;
+        step: number;
+    }>;
+    budget: number;
+    combinations: number;
+    /** Bar boundaries of the two segments, so the split is auditable. */
+    split: {
+        trainStartMs: number;
+        trainEndMs: number;
+        validationStartMs: number;
+        validationEndMs: number;
+        trainBars: number;
+        validationBars: number;
+    } | null;
+    /** Candidates in rank order, best first. Failures sort last. */
+    candidates: CandidateRow[];
+    completed: number;
+    failed: number;
+    /** Which ranking formula the leader used. */
+    rankBasis: string | null;
+}

package/dist/strategy/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/strategy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/strategy/types.ts"],"names":[],"mappings":""}