desic-okx-agent 0.2.0 → 0.3.0

package/dist/live/service.js

@@ -0,0 +1,303 @@
+import { RuntimeError } from "../core/errors.js";
+import { resultMeta } from "../core/types.js";
+import { loadContractSpec } from "../strategy/instrument.js";
+import { pythonStatus } from "../strategy/environment.js";
+import { checkPreconditions } from "./preconditions.js";
+import { reconcileSignals } from "./reconcile.js";
+import { describeAutoDisable, evaluateStreak } from "./failures.js";
+/** Consecutive failures after which a profile stops itself. */
+export const ERROR_STREAK_LIMIT = 3;
+/**
+ * Owns live profiles: their lifecycle, and what has to be true before one trades.
+ *
+ * Creating a profile never starts it. Enabling is the only step that can lead to an
+ * order, and it is the step that checks preconditions — so a profile can be written,
+ * inspected, and left alone safely.
+ */
+export class LiveService {
+    store;
+    strategyStore;
+    bars;
+    market;
+    accounts;
+    client;
+    trade;
+    errorStreakLimit;
+    constructor(store, strategyStore, bars, market, accounts, client, 
+    /** Used to apply the profile's leverage at enable time. See `applyLeverage`. */
+    trade, 
+    /** Consecutive systemic failures after which a profile stops itself. */
+    errorStreakLimit = ERROR_STREAK_LIMIT) {
+        this.store = store;
+        this.strategyStore = strategyStore;
+        this.bars = bars;
+        this.market = market;
+        this.accounts = accounts;
+        this.client = client;
+        this.trade = trade;
+        this.errorStreakLimit = errorStreakLimit;
+    }
+    onDisabled;
+    /**
+     * Marks profiles a dead worker left running.
+     *
+     * Called at startup. Their generation advances, so an order decided by the previous
+     * process cannot be submitted if it somehow still arrives.
+     */
+    recoverInterrupted() {
+        return this.store.failInterruptedProfiles();
+    }
+    /**
+     * Resolves signals left unresolved by a previous process.
+     *
+     * Every one is checked against the exchange rather than assumed. Nothing is resubmitted:
+     * re-sending an order that may already exist is the one mistake worse than missing one,
+     * so anything that cannot be resolved is marked ambiguous and waits for a person.
+     */
+    async reconcile() {
+        const outcome = await reconcileSignals({
+            client: this.client,
+            accounts: this.accounts,
+            store: this.store
+        });
+        return { data: outcome, meta: resultMeta({ source: "mixed" }) };
+    }
+    createProfile(input) {
+        validateBudgets(input);
+        // Deliberately does not check preconditions: a profile that cannot yet be enabled
+        // is still worth creating, and refusing here would mean writing the definition and
+        // the evidence in one step.
+        return { data: this.store.createProfile(input), meta: resultMeta({ source: "sqlite" }) };
+    }
+    listProfiles() {
+        return { data: this.store.listProfiles(), meta: resultMeta({ source: "sqlite" }) };
+    }
+    getProfile(id) {
+        return { data: this.store.requireProfile(id), meta: resultMeta({ source: "sqlite" }) };
+    }
+    signals(profileId, limit = 50) {
+        this.store.requireProfile(profileId);
+        return { data: this.store.listSignals(profileId, limit), meta: resultMeta({ source: "sqlite" }) };
+    }
+    /**
+     * Reports whether a profile could be enabled, without enabling it.
+     *
+     * Separate from `enable` so the list of blockers can be read before committing to
+     * anything — and so a caller that wants to show them does not have to trigger a
+     * failure to find out.
+     */
+    async readiness(id) {
+        const profile = this.store.requireProfile(id);
+        const facts = await this.gatherFacts(profile);
+        return {
+            data: {
+                profile,
+                ready: facts.failures.length === 0,
+                failures: facts.failures,
+                backtestRunId: facts.backtestRunId
+            },
+            meta: resultMeta({ source: "mixed" })
+        };
+    }
+    /**
+     * Enables a profile, refusing unless every precondition holds.
+     *
+     * The backtest that justified it is recorded on the profile, so a later reader can
+     * see which run was the evidence rather than having to trust that one existed.
+     */
+    async enable(id) {
+        const profile = this.store.requireProfile(id);
+        const facts = await this.gatherFacts(profile);
+        if (facts.failures.length > 0) {
+            throw new RuntimeError("VALIDATION", `Cannot enable '${profile.name}': ${facts.failures.map((failure) => failure.message).join(" ")}`, false, { failures: facts.failures });
+        }
+        // Before the row is written, so a profile is never enabled at a leverage other than
+        // its own. Sizing divides the entry budget by `profile.leverage`; if the exchange
+        // holds a different figure, the margin actually committed differs by that ratio and
+        // the budget stops meaning what it says. Measured on demo: a profile set to 10x on
+        // an account left at 3x turned a 60 USDT entry budget into roughly 198 USDT of
+        // margin.
+        const applied = await this.applyLeverage(profile);
+        return {
+            data: {
+                profile: this.store.enableProfile(id, facts.backtestRunId),
+                backtestRunId: facts.backtestRunId,
+                leverage: applied
+            },
+            meta: resultMeta({ source: "mixed" })
+        };
+    }
+    /**
+     * Writes the profile's leverage to the exchange, and refuses to enable if it cannot.
+     *
+     * This changes a setting the account shares across everything trading that instrument
+     * and margin mode, including positions opened by hand. That is the cost of the budgets
+     * meaning what they say, and it is why it happens at enable rather than silently on
+     * every bar.
+     *
+     * A failure here stops the enable. Continuing would leave the profile trading at a
+     * leverage nobody chose, which is the exact condition this call exists to remove.
+     */
+    async applyLeverage(profile) {
+        const lever = String(profile.leverage);
+        try {
+            await this.trade.setLeverage({
+                account: profile.account,
+                // Deterministic, so a retried enable reuses the same execution record instead of
+                // writing a second one for the same intent.
+                executionKey: `live-leverage:${profile.id}:${lever}:${profile.marginMode}`,
+                instId: profile.instId,
+                lever,
+                mgnMode: profile.marginMode
+            });
+            return { requested: profile.leverage, applied: true };
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new RuntimeError("VALIDATION", `Cannot enable '${profile.name}': setting ${profile.instId} to ${lever}x ${profile.marginMode} was refused (${detail}). Its entry budget is sized against ${lever}x, so trading at whatever the account currently holds would commit a different amount of margin than the budget states.`, false, { instId: profile.instId, leverage: profile.leverage, marginMode: profile.marginMode });
+        }
+    }
+    /**
+     * Stops a profile.
+     *
+     * Always allowed and never precondition-checked: whatever is wrong, stopping is the
+     * safe direction, and a stop that could fail would be worse than useless.
+     */
+    disable(id, reason) {
+        this.store.requireProfile(id);
+        const profile = this.store.disableProfile(id, reason ?? null);
+        // The row is written first, so a stop takes effect even if releasing the session fails.
+        // Releasing promptly matters because a session owns a Python child process; waiting for
+        // the next bar would leave it running against a profile that has stopped.
+        void this.onDisabled?.(id);
+        return { data: profile, meta: resultMeta({ source: "sqlite" }) };
+    }
+    /** Registers the loop's session release, called after a profile is disabled. */
+    onProfileDisabled(release) {
+        this.onDisabled = release;
+    }
+    /**
+     * Records a failed evaluation and stops the profile if they keep coming.
+     *
+     * One failure never stops anything: the risk gates still refuse whatever is unsafe, and
+     * halting on a single dropped connection would make the whole thing unusable. A run of
+     * failures is different — it means something systemic, and continuing only accumulates
+     * errors against an exchange nobody is watching.
+     *
+     * Only failures that will not fix themselves count. A profile that could not reach OKX
+     * for one minute is in a different position from one whose strategy throws on every bar.
+     * Transient failures are still recorded, so the minute is never silently dropped; they
+     * just do not push toward a shutdown.
+     */
+    recordFailure(id, error) {
+        const profile = this.store.requireProfile(id);
+        const message = error instanceof Error ? error.message : String(error);
+        const decision = evaluateStreak({
+            error,
+            currentStreak: profile.errorStreak,
+            limit: this.errorStreakLimit
+        });
+        if (!decision.counted) {
+            // Kept as the profile's last error so a reader can see what happened, without
+            // advancing the streak.
+            this.store.setLastError(id, message);
+            return {
+                data: { kind: decision.kind, streak: decision.streak, disabled: false },
+                meta: resultMeta({ source: "sqlite" })
+            };
+        }
+        const streak = this.store.recordError(id, message);
+        if (streak < this.errorStreakLimit) {
+            return { data: { kind: decision.kind, streak, disabled: false }, meta: resultMeta({ source: "sqlite" }) };
+        }
+        // Disabling also advances the generation, so an action this profile already decided
+        // cannot still be submitted.
+        this.store.disableProfile(id, describeAutoDisable(streak, message));
+        return { data: { kind: decision.kind, streak, disabled: true }, meta: resultMeta({ source: "sqlite" }) };
+    }
+    /** Clears the streak after an evaluation that worked. */
+    recordSuccess(id) {
+        // Only touched when there is something to clear: a healthy profile would otherwise
+        // write a row on every closed minute for no reason.
+        if (this.store.requireProfile(id).errorStreak > 0)
+            this.store.clearErrorStreak(id);
+    }
+    deleteProfile(id) {
+        const profile = this.store.requireProfile(id);
+        if (profile.enabled) {
+            throw new RuntimeError("VALIDATION", `'${profile.name}' is enabled. Stop it before deleting, so its signal history is not removed while it is still trading.`);
+        }
+        return { data: { deleted: this.store.deleteProfile(id) }, meta: resultMeta({ source: "sqlite" }) };
+    }
+    /**
+     * Collects everything the preconditions need.
+     *
+     * Each lookup is guarded on its own: a profile blocked by a missing backtest should
+     * still learn that its account is also unverified, and one failing probe must not
+     * hide the rest of the list.
+     */
+    async gatherFacts(profile) {
+        const backtest = this.strategyStore.latestCompletedRun(profile.strategyHash, profile.instId);
+        const python = await pythonStatus().catch(() => ({ ready: false, problems: ["Python status could not be read"] }));
+        let accountVerified = false;
+        let accountPermissions = null;
+        try {
+            const verified = await this.accounts.verify(profile.account);
+            accountVerified = true;
+            const permission = verified.data.perm;
+            accountPermissions = typeof permission === "string" && permission ? permission : null;
+        }
+        catch {
+            // Left unverified; the precondition reports it, and the exact exchange error is
+            // not more useful than "OKX did not accept these credentials".
+        }
+        const contractReadable = await loadContractSpec(this.market, profile.instId).then(() => true, () => false);
+        return {
+            backtestRunId: backtest?.id ?? null,
+            failures: checkPreconditions({
+                profile,
+                backtestRunId: backtest?.id ?? null,
+                pythonReady: python.ready,
+                pythonProblems: python.problems,
+                accountVerified,
+                accountPermissions,
+                contractReadable,
+                marketEnvironment: this.bars.environment === "demo" ? "demo" : "live"
+            })
+        };
+    }
+}
+/**
+ * Rejects budgets that cannot describe a real position.
+ *
+ * Checked at creation because these are the numbers every risk gate measures against: a
+ * profile whose side budget is below its entry budget would refuse every order it ever
+ * decided, which reads as a broken strategy rather than a bad setting.
+ */
+function validateBudgets(input) {
+    // An agent must say why. A profile that arrived with no reasoning is one nobody can review
+    // later, and reviewing it later is the only check left once it is trading.
+    if (input.origin === "agent" && !input.rationale?.trim()) {
+        throw new RuntimeError("VALIDATION", "An agent-created profile requires a rationale: which backtest justified it, and why these budgets");
+    }
+    const positives = [
+        ["entryBudgetUsdt", input.entryBudgetUsdt],
+        ["sideBudgetUsdt", input.sideBudgetUsdt],
+        ["dailyLossLimitUsdt", input.dailyLossLimitUsdt],
+        ["leverage", input.leverage]
+    ];
+    for (const [field, value] of positives) {
+        if (!Number.isFinite(value) || value <= 0) {
+            throw new RuntimeError("VALIDATION", `${field} must be greater than zero`);
+        }
+    }
+    if (input.sideBudgetUsdt < input.entryBudgetUsdt) {
+        throw new RuntimeError("VALIDATION", `sideBudgetUsdt (${input.sideBudgetUsdt}) is below entryBudgetUsdt (${input.entryBudgetUsdt}), so no entry could ever be placed`);
+    }
+    // Both default to allowed when omitted, matching the store. Reading `undefined` as
+    // "not allowed" would reject every profile that simply did not mention direction.
+    if (input.allowLong === false && input.allowShort === false) {
+        throw new RuntimeError("VALIDATION", "A profile with neither direction allowed can never trade");
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/live/service.js.map

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

package/dist/live/session.d.ts

@@ -0,0 +1,85 @@
+import type { Bar } from "../bars/types.js";
+export interface LiveSessionOptions {
+    interpreter: string;
+    engineRoot: string;
+    source: string;
+    instrument: Record<string, unknown>;
+    params: Record<string, unknown>;
+    intervals: string[];
+    /** Test seam. */
+    evaluationTimeoutMs?: number;
+}
+/** A strategy's intent for one cutoff. Carries no contract count. */
+export interface LiveDecision {
+    action: string;
+    reason: string;
+    asOfMs: number;
+    protection?: {
+        stopLossPrice?: number;
+        takeProfitPrice?: number;
+    };
+    execution?: {
+        orderType: string;
+        limitPrice?: number;
+    };
+    orderId?: string;
+}
+/** The account state a strategy sees, as reported by the exchange. */
+export interface LivePortfolio {
+    cashUsdt: number;
+    equityUsdt: number;
+    usedMarginUsdt: number;
+    availableMarginUsdt: number;
+    positions: Array<Record<string, unknown>>;
+    openOrders: Array<Record<string, unknown>>;
+}
+/**
+ * Owns one long-lived Python process speaking the `live` protocol.
+ *
+ * Requests are strictly serialised: one line out, one line back. The protocol has
+ * no request ids, so a second concurrent write would make it impossible to tell
+ * which reply belonged to which bar — and mismatching a decision to a minute is how
+ * a stale intent reaches the exchange.
+ */
+export declare class PythonLiveSession {
+    private readonly options;
+    private child?;
+    private buffer;
+    private pending?;
+    private queue;
+    private stderrText;
+    /**
+     * Replies still owed by the engine for requests that already timed out.
+     *
+     * The engine answers every request eventually, in order. A timeout abandons the
+     * caller but not the request, so that many arriving replies must be discarded
+     * before the stream lines up with whoever is waiting now.
+     */
+    private owedReplies;
+    private exited?;
+    private readonly timeoutMs;
+    constructor(options: LiveSessionOptions);
+    get running(): boolean;
+    /** Starts the process and completes the handshake. */
+    start(): Promise<void>;
+    /** Feeds history without evaluating it. */
+    warm(bars: Bar[]): Promise<number>;
+    /**
+     * Evaluates one confirmed bar and returns the strategy's intent.
+     *
+     * `portfolio` must be the exchange's own view, read immediately before this call.
+     */
+    evaluate(bar: Bar, portfolio: LivePortfolio): Promise<LiveDecision>;
+    /** Asks the process to exit, then makes sure it did. */
+    stop(): Promise<void>;
+    /**
+     * Serialises one request/response exchange.
+     *
+     * Every call is chained onto the previous one, so two callers cannot interleave
+     * writes on a protocol that has no request ids.
+     */
+    private request;
+    private onStdout;
+    private fail;
+    private describeExit;
+}

package/dist/live/session.js

@@ -0,0 +1,234 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import { RuntimeError } from "../core/errors.js";
+/**
+ * How long one evaluation may take before it is treated as a strategy fault.
+ *
+ * A decision is only useful within the minute it was made for, so a strategy that
+ * stalls is skipped rather than waited on. The session survives the timeout: the
+ * warmed indicator state is still valid for the next minute.
+ */
+const EVALUATION_TIMEOUT_MS = 5_000;
+/** Handshake and warm-up move more data, so they get a longer allowance. */
+const SETUP_TIMEOUT_MS = 60_000;
+/** One reply is a single JSON line; more than this means something is wrong. */
+const MAX_LINE_BYTES = 4 * 1024 * 1024;
+/**
+ * Owns one long-lived Python process speaking the `live` protocol.
+ *
+ * Requests are strictly serialised: one line out, one line back. The protocol has
+ * no request ids, so a second concurrent write would make it impossible to tell
+ * which reply belonged to which bar — and mismatching a decision to a minute is how
+ * a stale intent reaches the exchange.
+ */
+export class PythonLiveSession {
+    options;
+    child;
+    buffer = "";
+    pending;
+    queue = Promise.resolve();
+    stderrText = "";
+    /**
+     * Replies still owed by the engine for requests that already timed out.
+     *
+     * The engine answers every request eventually, in order. A timeout abandons the
+     * caller but not the request, so that many arriving replies must be discarded
+     * before the stream lines up with whoever is waiting now.
+     */
+    owedReplies = 0;
+    exited;
+    timeoutMs;
+    constructor(options) {
+        this.options = options;
+        this.timeoutMs = options.evaluationTimeoutMs ?? EVALUATION_TIMEOUT_MS;
+    }
+    get running() {
+        return this.child !== undefined && this.exited === undefined;
+    }
+    /** Starts the process and completes the handshake. */
+    async start() {
+        if (this.child)
+            throw new RuntimeError("VALIDATION", "This session is already started");
+        const entry = path.join(this.options.engineRoot, "main.py");
+        // `-I` ignores PYTHONPATH and the user site directory, so a live strategy
+        // cannot be redirected by ambient configuration. `-u` keeps replies flowing
+        // instead of sitting in a pipe buffer.
+        const child = spawn(this.options.interpreter, ["-I", "-u", entry], {
+            stdio: ["pipe", "pipe", "pipe"],
+            cwd: this.options.engineRoot,
+            windowsHide: true
+        });
+        this.child = child;
+        child.stdout.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => this.onStdout(chunk));
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            // Kept for diagnostics; an unexpected exit is undiagnosable without it.
+            if (this.stderrText.length < 64 * 1024)
+                this.stderrText += chunk;
+        });
+        child.on("error", (error) => this.fail(new RuntimeError("CAPABILITY_UNAVAILABLE", `Could not start the strategy engine: ${error.message}`)));
+        child.on("close", (code, signal) => {
+            this.exited = { code, signal };
+            this.fail(new RuntimeError("INTERNAL", `The strategy engine exited (${this.describeExit()})`));
+        });
+        child.stdin.on("error", () => {
+            // The close handler reports the real cause; a broken pipe here is a symptom.
+        });
+        const ready = await this.request({
+            command: "live",
+            source: this.options.source,
+            instrument: this.options.instrument,
+            params: this.options.params,
+            intervals: this.options.intervals
+        }, SETUP_TIMEOUT_MS);
+        if (ready.ok !== true)
+            throw pythonError(ready);
+    }
+    /** Feeds history without evaluating it. */
+    async warm(bars) {
+        const response = await this.request({ kind: "warm", bars: bars.map(toPayload) }, SETUP_TIMEOUT_MS);
+        if (response.ok !== true)
+            throw pythonError(response);
+        return Number(response.barCount ?? 0);
+    }
+    /**
+     * Evaluates one confirmed bar and returns the strategy's intent.
+     *
+     * `portfolio` must be the exchange's own view, read immediately before this call.
+     */
+    async evaluate(bar, portfolio) {
+        const response = await this.request({ kind: "bar", bar: toPayload(bar), portfolio }, this.timeoutMs);
+        if (response.ok !== true)
+            throw pythonError(response);
+        return {
+            action: String(response.action ?? ""),
+            reason: String(response.reason ?? ""),
+            asOfMs: Number(response.asOfMs ?? bar.closeTimeMs),
+            ...(response.protection ? { protection: response.protection } : {}),
+            ...(response.execution ? { execution: response.execution } : {}),
+            ...(response.orderId ? { orderId: String(response.orderId) } : {})
+        };
+    }
+    /** Asks the process to exit, then makes sure it did. */
+    async stop() {
+        const child = this.child;
+        if (!child || this.exited) {
+            this.child = undefined;
+            return;
+        }
+        try {
+            await this.request({ command: "shutdown" }, 2_000);
+        }
+        catch {
+            // A session being stopped because it misbehaved will not answer; the kill
+            // below is the point.
+        }
+        if (this.exited === undefined)
+            child.kill("SIGKILL");
+        this.child = undefined;
+    }
+    /**
+     * Serialises one request/response exchange.
+     *
+     * Every call is chained onto the previous one, so two callers cannot interleave
+     * writes on a protocol that has no request ids.
+     */
+    request(message, timeoutMs) {
+        const run = async () => {
+            const child = this.child;
+            if (!child || this.exited) {
+                throw new RuntimeError("INTERNAL", `The strategy engine is not running (${this.describeExit()})`);
+            }
+            return new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    this.pending = undefined;
+                    // The engine is still working on this request and will answer eventually.
+                    // That reply now belongs to nobody, so it is counted here and dropped on
+                    // arrival — handing it to the next caller would pair a decision with a
+                    // different minute than the one it was computed for.
+                    this.owedReplies += 1;
+                    // The process is left alive: its indicator state is still valid, and the
+                    // caller treats this minute as a skipped evaluation.
+                    reject(new RuntimeError("INTERNAL", `The strategy took longer than ${timeoutMs}ms to decide`));
+                }, timeoutMs);
+                timer.unref();
+                this.pending = { resolve, reject, timer };
+                child.stdin.write(`${JSON.stringify(message)}\n`);
+            });
+        };
+        // Failures must not poison the chain for later calls.
+        const chained = this.queue.then(run, run);
+        this.queue = chained.then(() => undefined, () => undefined);
+        return chained;
+    }
+    onStdout(chunk) {
+        this.buffer += chunk;
+        if (this.buffer.length > MAX_LINE_BYTES) {
+            this.buffer = "";
+            this.fail(new RuntimeError("INTERNAL", "The strategy engine produced an oversized reply"));
+            return;
+        }
+        for (;;) {
+            const newline = this.buffer.indexOf("\n");
+            if (newline === -1)
+                return;
+            const line = this.buffer.slice(0, newline).trim();
+            this.buffer = this.buffer.slice(newline + 1);
+            if (!line)
+                continue;
+            // A timed-out request is still owed a reply. Discarding it here — before
+            // looking at who is waiting — is what keeps the stream aligned: otherwise the
+            // late answer would satisfy the *next* evaluation, pairing a decision with a
+            // different minute than the one it was computed for.
+            if (this.owedReplies > 0) {
+                this.owedReplies -= 1;
+                continue;
+            }
+            const waiting = this.pending;
+            // A reply nobody is owed and nobody is waiting for means the stream
+            // desynchronised; dropping it is safer than delivering it.
+            if (!waiting)
+                continue;
+            this.pending = undefined;
+            clearTimeout(waiting.timer);
+            try {
+                waiting.resolve(JSON.parse(line));
+            }
+            catch {
+                waiting.reject(new RuntimeError("INTERNAL", `The strategy engine returned invalid JSON: ${line.slice(0, 200)}`));
+            }
+        }
+    }
+    fail(error) {
+        const waiting = this.pending;
+        if (!waiting)
+            return;
+        this.pending = undefined;
+        clearTimeout(waiting.timer);
+        waiting.reject(error);
+    }
+    describeExit() {
+        if (!this.exited)
+            return "still running";
+        const detail = this.stderrText.trim().split("\n").at(-1);
+        const status = this.exited.signal ? `signal ${this.exited.signal}` : `exit code ${this.exited.code}`;
+        return detail ? `${status}: ${detail}` : status;
+    }
+}
+function toPayload(bar) {
+    return {
+        openTimeMs: bar.openTimeMs,
+        closeTimeMs: bar.closeTimeMs,
+        open: Number(bar.open),
+        high: Number(bar.high),
+        low: Number(bar.low),
+        close: Number(bar.close),
+        volume: Number(bar.volume)
+    };
+}
+function pythonError(response) {
+    const error = (response.error ?? {});
+    return new RuntimeError(error.code === "policy_violation" ? "VALIDATION" : "INTERNAL", error.message ?? "The strategy engine reported an error", false, error.violations ? { violations: error.violations } : undefined);
+}
+//# sourceMappingURL=session.js.map

package/dist/live/session.js.map

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