desic-okx-agent 0.2.0 → 0.3.0

package/dist/live/gates.js

@@ -0,0 +1,136 @@
+import { committedMarginUsdt, sizeEntry } from "./sizing.js";
+/** Actions that open exposure. Only these are budgeted. */
+const OPENING = new Set(["open_long", "open_short"]);
+/** Actions that reduce exposure. */
+const CLOSING = new Set(["close_long", "close_short"]);
+export function sideOf(action) {
+    return action === "open_long" || action === "close_long" ? "long" : "short";
+}
+export function isOpening(action) {
+    return OPENING.has(action);
+}
+export function isClosing(action) {
+    return CLOSING.has(action);
+}
+/**
+ * Runs every gate in order and returns either a legal size or the refusal.
+ *
+ * Closing actions skip the budget, loss, and cooldown gates. Those exist to limit new
+ * exposure, and applying them to an exit would trap a position open precisely when
+ * risk control most wants it closed — a daily loss limit that prevented closing a
+ * losing position would make the loss worse.
+ */
+export function evaluateGates(context) {
+    const { profile, action } = context;
+    // 1. Still enabled. Checked first because it is free and makes everything else
+    //    moot.
+    if (!context.enabledNow) {
+        return refuse("disabled", `Profile ${profile.name} is not enabled`, { profileId: profile.id });
+    }
+    // 2. Generation unchanged. This is the TOCTOU guard: a stop that landed while the
+    //    strategy was deciding must still block the order it decided on.
+    if (context.currentGeneration !== context.generation) {
+        return refuse("generation", "The profile was stopped or restarted during this evaluation", {
+            decidedUnder: context.generation,
+            currentGeneration: context.currentGeneration
+        });
+    }
+    const side = sideOf(action);
+    // 3. Direction permitted. A long-only profile must not be talked into a short by a
+    //    strategy that emits both.
+    if (isOpening(action)) {
+        const permitted = side === "long" ? profile.allowLong : profile.allowShort;
+        if (!permitted) {
+            return refuse("direction", `This profile does not allow opening ${side} positions`, { side });
+        }
+    }
+    if (isClosing(action)) {
+        // An exit is sized from the open position, not from a budget: a partial close
+        // driven by a budget would leave exposure the strategy believed it had removed.
+        const held = holdingQuantity(context.positions, side);
+        if (held <= 0) {
+            return refuse("minimum_size", `There is no ${side} position to close`, { side });
+        }
+        return { allowed: true, contracts: held, notionalUsdt: 0, marginUsdt: 0, side };
+    }
+    // 4. Entry budget. The ceiling on one entry.
+    const budget = Math.min(profile.entryBudgetUsdt, context.availableMarginUsdt);
+    if (!(budget > 0)) {
+        return refuse("entry_budget", "No margin is available for a new entry", {
+            entryBudgetUsdt: profile.entryBudgetUsdt,
+            availableMarginUsdt: context.availableMarginUsdt
+        });
+    }
+    // 5. Side budget. Total margin already committed in this direction, read from the
+    //    exchange rather than accumulated locally.
+    const committed = committedMarginUsdt(context.positions, side);
+    const headroom = profile.sideBudgetUsdt - committed;
+    if (headroom <= 0) {
+        return refuse("side_budget", `The ${side} budget is fully committed`, {
+            committedUsdt: round(committed),
+            sideBudgetUsdt: profile.sideBudgetUsdt
+        });
+    }
+    // 6. Daily loss limit. Blocks new exposure only; an exit already returned above.
+    if (context.realizedLossUsdtToday >= profile.dailyLossLimitUsdt) {
+        return refuse("daily_loss", "Today's realized loss has reached the limit", {
+            realizedLossUsdt: round(context.realizedLossUsdtToday),
+            dailyLossLimitUsdt: profile.dailyLossLimitUsdt
+        });
+    }
+    // 7. Cooldown, measured from the last order actually submitted rather than the last
+    //    evaluation: a stretch of blocked signals must not keep the cooldown alive.
+    if (profile.cooldownSeconds > 0 && context.lastSubmittedAt !== undefined) {
+        const elapsedSeconds = (context.cutoffAt - context.lastSubmittedAt) / 1_000;
+        if (elapsedSeconds < profile.cooldownSeconds) {
+            return refuse("cooldown", "The cooldown after the last order has not elapsed", {
+                elapsedSeconds: round(elapsedSeconds),
+                cooldownSeconds: profile.cooldownSeconds
+            });
+        }
+    }
+    // 8. A legal contract count. The budget is capped by the side headroom so an entry
+    //    cannot straddle the limit.
+    const sized = sizeEntry({
+        budgetUsdt: Math.min(budget, headroom),
+        price: context.price,
+        leverage: profile.leverage,
+        marginSafetyMultiplier: 1,
+        contract: context.contract
+    });
+    if (sized.contracts <= 0) {
+        return refuse("minimum_size", "The budget is too small for one legal contract lot", {
+            budgetUsdt: round(Math.min(budget, headroom)),
+            price: context.price,
+            minSize: context.contract.minSize,
+            lotSize: context.contract.lotSize,
+            reason: sized.refusedBecause ?? "below_minimum_size"
+        });
+    }
+    return {
+        allowed: true,
+        contracts: sized.contracts,
+        notionalUsdt: sized.notionalUsdt,
+        marginUsdt: sized.marginUsdt,
+        side
+    };
+}
+/** Contracts held on one side, as the exchange reports them. */
+export function holdingQuantity(positions, side) {
+    let total = 0;
+    for (const position of positions) {
+        if (String(position.side ?? "") !== side)
+            continue;
+        const quantity = Number(position.quantity ?? 0);
+        if (Number.isFinite(quantity) && quantity > 0)
+            total += quantity;
+    }
+    return total;
+}
+function refuse(gate, message, details) {
+    return { allowed: false, refusal: { gate, message, details } };
+}
+function round(value) {
+    return Number(value.toFixed(6));
+}
+//# sourceMappingURL=gates.js.map

package/dist/live/gates.js.map

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

package/dist/live/loop.d.ts

@@ -0,0 +1,56 @@
+import type { PythonStatus } from "../strategy/environment.js";
+import { type RunnerDeps } from "./runner.js";
+import type { LiveService } from "./service.js";
+export interface LoopDeps extends RunnerDeps {
+    service: LiveService;
+    /** Resolves the interpreter and engine root, or reports why it cannot. */
+    python: () => Promise<PythonStatus>;
+}
+/**
+ * Drives live profiles off the confirmed-bar feed.
+ *
+ * One session per profile, started when the profile is enabled and torn down when it stops.
+ * A session is expensive to build — it warms hundreds of bars of indicator state — so it is
+ * kept alive across minutes rather than rebuilt per bar.
+ *
+ * Bars arrive through a coalescing queue, so a burst after a reconnect collapses to the
+ * newest cutoff. Older minutes are not evaluated at all: by the time a decision for one
+ * reached the exchange the market would have moved on, and the bar itself is already stored.
+ */
+export declare class LiveLoop {
+    private readonly deps;
+    private readonly queue;
+    private readonly running;
+    private unsubscribe?;
+    private stopping;
+    constructor(deps: LoopDeps);
+    /** Begins listening for closed bars. Enabled profiles are attached as their bars arrive. */
+    start(): void;
+    /** Stops every session and detaches from the feed. */
+    stop(): Promise<void>;
+    /** Profiles with a live session, for status reporting. */
+    activeProfileIds(): string[];
+    /**
+     * Releases a profile's session.
+     *
+     * Called when a profile is disabled, so a stopped profile is not left holding a Python
+     * process. Safe to call for a profile that was never running.
+     */
+    release(profileId: string): Promise<void>;
+    /**
+     * Evaluates whatever is pending for one instrument.
+     *
+     * Serialised per instrument by the queue: two concurrent evaluations could each read the
+     * position before the other's order landed, and both would then open one.
+     */
+    private drain;
+    private evaluateProfiles;
+    private evaluateOne;
+    /**
+     * Returns the profile's session, starting and warming one if needed.
+     *
+     * Warm-up feeds history without evaluating it, so a session joining mid-stream does not
+     * emit decisions for minutes that have already passed.
+     */
+    private ensureSession;
+}

package/dist/live/loop.js

@@ -0,0 +1,197 @@
+import { appendRuntimeLifecycle } from "../runtime/state.js";
+import { loadContractSpec } from "../strategy/instrument.js";
+import { CutoffQueue } from "./cutoff-queue.js";
+import { evaluateCutoff, warmSession } from "./runner.js";
+import { PythonLiveSession } from "./session.js";
+/**
+ * Drives live profiles off the confirmed-bar feed.
+ *
+ * One session per profile, started when the profile is enabled and torn down when it stops.
+ * A session is expensive to build — it warms hundreds of bars of indicator state — so it is
+ * kept alive across minutes rather than rebuilt per bar.
+ *
+ * Bars arrive through a coalescing queue, so a burst after a reconnect collapses to the
+ * newest cutoff. Older minutes are not evaluated at all: by the time a decision for one
+ * reached the exchange the market would have moved on, and the bar itself is already stored.
+ */
+export class LiveLoop {
+    deps;
+    queue = new CutoffQueue();
+    running = new Map();
+    unsubscribe;
+    stopping = false;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /** Begins listening for closed bars. Enabled profiles are attached as their bars arrive. */
+    start() {
+        this.stopping = false;
+        this.unsubscribe = this.deps.bars.store.onConfirmed((instId, bar) => {
+            this.queue.offer(instId, bar);
+            // Dispatch is deliberately not awaited: this runs inside the websocket's write path,
+            // and blocking it would delay every other instrument's bar.
+            void this.drain(instId);
+        });
+    }
+    /** Stops every session and detaches from the feed. */
+    async stop() {
+        this.stopping = true;
+        this.unsubscribe?.();
+        this.unsubscribe = undefined;
+        const sessions = [...this.running.values()];
+        this.running.clear();
+        await Promise.all(sessions.map((entry) => entry.session.stop().catch(() => undefined)));
+    }
+    /** Profiles with a live session, for status reporting. */
+    activeProfileIds() {
+        return [...this.running.keys()];
+    }
+    /**
+     * Releases a profile's session.
+     *
+     * Called when a profile is disabled, so a stopped profile is not left holding a Python
+     * process. Safe to call for a profile that was never running.
+     */
+    async release(profileId) {
+        const entry = this.running.get(profileId);
+        if (!entry)
+            return;
+        this.running.delete(profileId);
+        this.queue.forget(entry.profile.instId);
+        await entry.session.stop().catch(() => undefined);
+    }
+    /**
+     * Evaluates whatever is pending for one instrument.
+     *
+     * Serialised per instrument by the queue: two concurrent evaluations could each read the
+     * position before the other's order landed, and both would then open one.
+     */
+    async drain(instId) {
+        if (this.stopping)
+            return;
+        const bar = this.queue.claim(instId);
+        if (!bar)
+            return;
+        try {
+            await this.evaluateProfiles(instId, bar);
+        }
+        finally {
+            this.queue.release(instId);
+        }
+        // A bar that arrived during the evaluation is still pending, so the newest cutoff is not
+        // left waiting for the next minute.
+        if (this.queue.pendingCutoff(instId) !== undefined)
+            void this.drain(instId);
+    }
+    async evaluateProfiles(instId, bar) {
+        const profiles = this.deps.store.listProfiles({ enabledOnly: true, instId });
+        for (const profile of profiles) {
+            // Re-read rather than trusting the list: an enable or stop may have landed since.
+            const current = this.deps.store.profile(profile.id);
+            if (!current?.enabled) {
+                await this.release(profile.id);
+                continue;
+            }
+            await this.evaluateOne(current, bar);
+        }
+        // A profile that was disabled while holding a session — by an operator or by the error
+        // streak — releases its process here rather than lingering until the runtime stops.
+        for (const profileId of this.activeProfileIds()) {
+            if (this.deps.store.profile(profileId)?.enabled !== true)
+                await this.release(profileId);
+        }
+    }
+    async evaluateOne(profile, bar) {
+        let result;
+        try {
+            const entry = await this.ensureSession(profile, bar);
+            // A generation change means the profile was restarted; its session holds state warmed
+            // under the previous run, so it is rebuilt rather than reused.
+            if (entry.generation !== profile.generation) {
+                await this.release(profile.id);
+                return;
+            }
+            result = await evaluateCutoff(this.deps, profile, entry.session, bar, entry.generation);
+            // Only a completed evaluation clears the streak. A blocked signal is a working risk
+            // gate, not a fault, so it counts as success here.
+            this.deps.service.recordSuccess(profile.id);
+        }
+        catch (error) {
+            const outcome = this.deps.service.recordFailure(profile.id, error);
+            appendRuntimeLifecycle("live-evaluation-failed", {
+                profileId: profile.id,
+                cutoffAt: bar.closeTimeMs,
+                kind: outcome.data.kind,
+                streak: outcome.data.streak,
+                disabled: outcome.data.disabled,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            // A session whose process died, or a profile that just stopped itself, must not be
+            // reused on the next bar.
+            if (outcome.data.disabled || !this.running.get(profile.id)?.session.running) {
+                await this.release(profile.id);
+            }
+            return;
+        }
+        if (result.kind === "submitted") {
+            appendRuntimeLifecycle("live-order-submitted", {
+                profileId: profile.id,
+                cutoffAt: bar.closeTimeMs,
+                orderId: result.orderId,
+                contracts: result.contracts
+            });
+        }
+    }
+    /**
+     * Returns the profile's session, starting and warming one if needed.
+     *
+     * Warm-up feeds history without evaluating it, so a session joining mid-stream does not
+     * emit decisions for minutes that have already passed.
+     */
+    async ensureSession(profile, bar) {
+        const existing = this.running.get(profile.id);
+        if (existing?.session.running && existing.warmed)
+            return existing;
+        if (existing)
+            await this.release(profile.id);
+        const python = await this.deps.python();
+        if (!python.ready || !python.interpreter) {
+            throw new RuntimeErrorLike(`The Python environment is not ready: ${python.problems.join("; ") || "unknown reason"}`);
+        }
+        const source = this.deps.store.profileSource(profile.id);
+        if (!source)
+            throw new RuntimeErrorLike(`Profile ${profile.id} has no stored strategy source`);
+        // The exchange's real specification, not a placeholder: strategy code reads
+        // `contractValue` off its own position rows, so a stand-in would have it reasoning about
+        // a contract that does not exist.
+        const contract = await loadContractSpec(this.deps.market, profile.instId);
+        const session = new PythonLiveSession({
+            interpreter: python.interpreter,
+            engineRoot: python.engineRoot,
+            source,
+            instrument: {
+                instId: contract.instId,
+                contractValue: contract.contractValue,
+                contractMultiplier: contract.contractMultiplier,
+                lotSize: contract.lotSize,
+                minSize: contract.minSize,
+                tickSize: contract.tickSize
+            },
+            params: profile.params,
+            intervals: ["1m"]
+        });
+        await session.start();
+        const entry = { profile, session, generation: profile.generation, warmed: false };
+        this.running.set(profile.id, entry);
+        // Warm up to the bar *before* this one: the triggering minute is the first thing
+        // evaluated, not part of the history.
+        await warmSession(this.deps, profile, session, bar.openTimeMs - 60_000);
+        entry.warmed = true;
+        appendRuntimeLifecycle("live-session-started", { profileId: profile.id, instId: profile.instId });
+        return entry;
+    }
+}
+/** Local error type, so the loop does not depend on the error module's shape. */
+class RuntimeErrorLike extends Error {
+}
+//# sourceMappingURL=loop.js.map

package/dist/live/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/live/loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,WAAW,EAA0C,MAAM,aAAa,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAkBjD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,QAAQ;IAMU;IALZ,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC;IAC1B,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC9C,WAAW,CAAc;IACzB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAA6B,IAAc;QAAd,SAAI,GAAJ,IAAI,CAAU;IAAG,CAAC;IAE/C,4FAA4F;IAC5F,KAAK;QACH,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAClE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC9B,qFAAqF;YACrF,4DAA4D;YAC5D,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC7B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1F,CAAC;IAED,0DAA0D;IAC1D,gBAAgB;QACd,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,KAAK,CAAC,MAAc;QAChC,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QACD,yFAAyF;QACzF,oCAAoC;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,SAAS;YAAE,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9E,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,MAAc,EAAE,GAAQ;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,kFAAkF;YAClF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC/B,SAAS;YACX,CAAC;YACD,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvC,CAAC;QACD,uFAAuF;QACvF,oFAAoF;QACpF,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI;gBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,OAAoB,EAAE,GAAQ;QACtD,IAAI,MAAoC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACrD,sFAAsF;YACtF,+DAA+D;YAC/D,IAAI,KAAK,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC5C,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC/B,OAAO;YACT,CAAC;YACD,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YACxF,oFAAoF;YACpF,mDAAmD;YACnD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACnE,sBAAsB,CAAC,wBAAwB,EAAE;gBAC/C,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,QAAQ,EAAE,GAAG,CAAC,WAAW;gBACzB,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI;gBACvB,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM;gBAC3B,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ;gBAC/B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,mFAAmF;YACnF,0BAA0B;YAC1B,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC5E,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACjC,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,sBAAsB,CAAC,sBAAsB,EAAE;gBAC7C,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,QAAQ,EAAE,GAAG,CAAC,WAAW;gBACzB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,aAAa,CAAC,OAAoB,EAAE,GAAQ;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAClE,IAAI,QAAQ;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACzC,MAAM,IAAI,gBAAgB,CACxB,wCAAwC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,gBAAgB,EAAE,CACzF,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,gBAAgB,CAAC,WAAW,OAAO,CAAC,EAAE,gCAAgC,CAAC,CAAC;QAE/F,4EAA4E;QAC5E,yFAAyF;QACzF,kCAAkC;QAClC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC;YACpC,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM;YACN,UAAU,EAAE;gBACV,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;gBAC/C,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;aAC5B;YACD,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,CAAC,IAAI,CAAC;SAClB,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAY,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;QAC3F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACpC,iFAAiF;QACjF,sCAAsC;QACtC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,CAAC;QACxE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,sBAAsB,CAAC,sBAAsB,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAClG,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,gBAAiB,SAAQ,KAAK;CAAG"}

package/dist/live/preconditions.d.ts

@@ -0,0 +1,48 @@
+import type { LiveEnvironment, LiveProfile } from "./types.js";
+/**
+ * What must be true before a profile is allowed to trade.
+ *
+ * These are checked once, at enable time, and every one of them is a fact about the system
+ * that can be verified: an environment that is ready, credentials that work, a contract the
+ * exchange will describe, a venue that matches.
+ *
+ * One is deliberate friction rather than a technical check. A profile cannot be enabled until
+ * its exact source has completed a backtest on its exact instrument, which blocks "wrote it,
+ * shipped it" — using real money for the first test. The bar is that a backtest *ran*, not
+ * that it did well: a losing run still proves the strategy executes and that someone has seen
+ * how it behaves.
+ *
+ * Deciding *whether* to commit real money is not on this list, because it is not a fact about
+ * the system — it is the operator's call. An agent is required to ask before enabling a
+ * real-money profile, and that belongs in the agent's instructions where it can be stated
+ * plainly, not in a schema check that only rewards guessing a string.
+ */
+export type PreconditionCode = "no_backtest" | "python_missing" | "account_unverified" | "no_trade_permission" | "contract_unreadable" | "environment_mismatch";
+export interface PreconditionFailure {
+    code: PreconditionCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface PreconditionInput {
+    profile: LiveProfile;
+    /** A completed backtest of this source on this instrument, if one exists. */
+    backtestRunId: string | null;
+    pythonReady: boolean;
+    pythonProblems: string[];
+    /** Whether the account's credentials were accepted by the exchange. */
+    accountVerified: boolean;
+    /** Permission string as OKX reports it, or null when it did not say. */
+    accountPermissions: string | null;
+    contractReadable: boolean;
+    /** Which venue market data is streaming from. */
+    marketEnvironment: LiveEnvironment;
+}
+/**
+ * Returns every unmet precondition, in the order they are worth fixing.
+ *
+ * All of them are collected rather than stopping at the first: someone about to trade
+ * real money should see the full list once, not discover a new blocker on each attempt.
+ */
+export declare function checkPreconditions(input: PreconditionInput): PreconditionFailure[];
+/** Throws with every unmet precondition, or returns cleanly. */
+export declare function assertPreconditions(input: PreconditionInput): void;

package/dist/live/preconditions.js

@@ -0,0 +1,69 @@
+import { RuntimeError } from "../core/errors.js";
+/**
+ * Returns every unmet precondition, in the order they are worth fixing.
+ *
+ * All of them are collected rather than stopping at the first: someone about to trade
+ * real money should see the full list once, not discover a new blocker on each attempt.
+ */
+export function checkPreconditions(input) {
+    const failures = [];
+    const { profile } = input;
+    if (!input.backtestRunId) {
+        failures.push({
+            code: "no_backtest",
+            message: `No completed backtest of this strategy on ${profile.instId}. Run one first: there is otherwise no evidence the strategy works, or even that it runs.`,
+            details: { instId: profile.instId, strategyHash: profile.strategyHash }
+        });
+    }
+    if (!input.pythonReady) {
+        failures.push({
+            code: "python_missing",
+            message: "The local Python environment is not ready, so the first closed minute would fail. Run 'desic-okx strategy env --setup'.",
+            details: { problems: input.pythonProblems }
+        });
+    }
+    if (!input.accountVerified) {
+        failures.push({
+            code: "account_unverified",
+            message: `OKX did not accept the credentials for account '${profile.account}'.`,
+            details: { account: profile.account }
+        });
+    }
+    else if (input.accountPermissions !== null && !input.accountPermissions.toLowerCase().includes("trade")) {
+        // Checked only once the credentials work, since an unverified account has no
+        // permission string worth reporting.
+        failures.push({
+            code: "no_trade_permission",
+            message: `The API key for '${profile.account}' has no trade permission, so every order would be rejected.`,
+            details: { account: profile.account, permissions: input.accountPermissions }
+        });
+    }
+    if (!input.contractReadable) {
+        failures.push({
+            code: "contract_unreadable",
+            message: `OKX did not report a usable contract specification for ${profile.instId}, so no order size can be derived.`,
+            details: { instId: profile.instId }
+        });
+    }
+    // A profile trading on one venue while bars arrive from the other would decide on
+    // prices that never applied to its own market. The environment split makes the two
+    // genuinely different, so this has to be refused rather than warned about.
+    if (input.marketEnvironment !== profile.environment) {
+        failures.push({
+            code: "environment_mismatch",
+            message: `This profile trades on ${profile.environment} while market data is streaming from ${input.marketEnvironment}. Switch with 'desic-okx market env ${profile.environment}' and restart.`,
+            details: { profileEnvironment: profile.environment, marketEnvironment: input.marketEnvironment }
+        });
+    }
+    return failures;
+}
+/** Throws with every unmet precondition, or returns cleanly. */
+export function assertPreconditions(input) {
+    const failures = checkPreconditions(input);
+    if (failures.length === 0)
+        return;
+    throw new RuntimeError("VALIDATION", `${failures.length} precondition(s) block enabling '${input.profile.name}': ${failures
+        .map((failure) => failure.message)
+        .join(" ")}`, false, { failures });
+}
+//# sourceMappingURL=preconditions.js.map

package/dist/live/preconditions.js.map

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

package/dist/live/reconcile.d.ts

@@ -0,0 +1,46 @@
+import type { AccountService } from "../account/service.js";
+import type { OkxClient } from "../core/okx-client.js";
+import type { LiveStore } from "./store.js";
+/**
+ * Resolves signals whose outcome was unknown when the process died.
+ *
+ * Two states are unresolved, and neither may be assumed:
+ *
+ * `submitted` means an order was sent but its terminal result was never recorded. It may
+ * have filled.
+ *
+ * `reserved` means a minute was claimed and the worker vanished before deciding. Usually
+ * nothing was sent — but "usually" is not a basis for trading, because the crash could
+ * equally have landed between the write and the response.
+ *
+ * So both are checked against the exchange rather than guessed at. Nothing is ever
+ * resubmitted: re-sending an order that may already exist is the one mistake worse than
+ * missing one. A signal that cannot be resolved is marked `ambiguous` and waits for a
+ * person.
+ */
+export interface ReconcileOutcome {
+    /** Signals whose remote state was found and recorded. */
+    resolved: number;
+    /** Signals confirmed to have no order at the exchange. */
+    absent: number;
+    /** Signals left for a person to inspect. */
+    ambiguous: number;
+    details: Array<{
+        signalId: string;
+        profileId: string;
+        cutoffAt: number;
+        result: string;
+    }>;
+}
+export interface Reconciler {
+    client: Pick<OkxClient, "privateGet">;
+    accounts: Pick<AccountService, "account">;
+    store: LiveStore;
+}
+/**
+ * Checks every unresolved signal against the exchange.
+ *
+ * Called at startup, after the executions table has had its own chance to recover: the
+ * two live in separate tables and a signal's execution record may still be settling.
+ */
+export declare function reconcileSignals(deps: Reconciler): Promise<ReconcileOutcome>;