@senpi/runtime 3.0.162 → 3.0.168

package/dist/strategy/__tests__/fixtures/hawk-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hawk-facts.js","sourceRoot":"","sources":["../../../../src/strategy/__tests__/fixtures/hawk-facts.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,CAAC,MAAM,UAAU,GAAkB;IACvC,CAAC,EAAE,CAAC;IACJ,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IAC7B,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,YAAY;IACvB,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,IAAI;IACpB,KAAK,EAAE,CAAC;IACR,eAAe,EAAE,GAAG;IACpB,IAAI,EAAE;QACJ,YAAY,EAAE,CAAC;QACf,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;QACpB,UAAU,EAAE,CAAC;QACb,aAAa,EAAE,IAAI;QACnB,eAAe,EAAE,IAAI;KACtB;IACD,MAAM,EAAE;QACN,mBAAmB,EAAE,CAAC;QACtB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;QACxC,iBAAiB,EAAE,EAAE;QACrB,kBAAkB,EAAE,KAAK;KAC1B;CACF,CAAC"}

package/dist/strategy/facts-sync.d.ts

@@ -0,0 +1,79 @@
+import type { RuntimeConfig } from "../runtime/runtime-schema.js";
+import { type StrategyFacts, type StrategyManifestLike } from "./facts.js";
+export declare const FACTS_STATE_FILE = "strategy-facts.json";
+/** Bound on one boot facts send (connect excluded; the SDK bounds that). Detached from boot either way. */
+export declare const BOOT_FACTS_CALL_TIMEOUT_MS = 30000;
+/** What this runtime last settled with the backend. */
+export interface FactsSyncState {
+    v: 1;
+    /** Hash of the last facts the backend accepted (`sent`) or refused for good (`refused`). */
+    hash: string;
+    outcome: "sent" | "refused";
+    /** The last facts the backend accepted, kept for the boot merge. Null when none ever was. */
+    sent: StrategyFacts | null;
+}
+export interface FactsPlan {
+    runtimeId: string;
+    wallet: string;
+    stateDir: string;
+    /** What this boot would send: the instance's facts, merged over the last accepted ones. */
+    facts: StrategyFacts;
+    hash: string;
+    /** This hash was already settled (sent or refused): nothing to send. */
+    unchanged: boolean;
+    /** The backend holds exactly these facts. Stamped on `runtime.started` as `senpi.strategy.facts_sent`. */
+    delivered: boolean;
+    previous: FactsSyncState | null;
+}
+/** The answer of one `strategy_patch_metadata` call, as `SenpiClient.patchStrategyMetadata` reads it. */
+export interface FactsPatchResult {
+    success: boolean;
+    errorCode?: string;
+    message?: string;
+    retryable?: boolean;
+}
+export interface FactsSyncDeps {
+    /** The strategy id for a wallet, from the boot status read; undefined when that read did not say. */
+    strategyIdFor(wallet: string): string | undefined;
+    patch(strategyId: string, facts: StrategyFacts): Promise<FactsPatchResult>;
+}
+export type FactsSyncOutcome = "sent" | "unchanged" | "refused" | "failed";
+export interface FactsSyncResult {
+    outcome: FactsSyncOutcome;
+    /** Why it was refused or failed. */
+    detail?: string;
+}
+export declare function factsHash(facts: StrategyFacts): string;
+/**
+ * The package manifest of a runtime, best-effort. Stock packages are `<pkg>/strategy.yaml` beside
+ * `<pkg>/<instance>/runtime.yaml`; flat ones keep both in `<pkg>/`. So look in the runtime's own
+ * dir, then its parent, and take the parent's only when it declares this instance. Null when none
+ * is found or it will not parse; never throws. The files can change after deploy, and
+ * `runtime create` installs have no package at all.
+ */
+export declare function readPackageManifest(runtimeYamlDir: string | undefined): Promise<StrategyManifestLike | null>;
+/**
+ * Boot facts over the last accepted ones. A boot that cannot read the manifest loses the catalog
+ * fallback for assets and direction; it must not overwrite what the deploy sent with nulls. The
+ * boot's values win wherever they are non-null. Assets are carried over only when the boot does
+ * not know the universe either: a scanner that ranks a live board has no asset list by design.
+ */
+export declare function mergeBootFacts(boot: StrategyFacts, lastSent: StrategyFacts | null): StrategyFacts;
+/** The stored state, or null when there is none or it is unreadable (read as "never sent"). */
+export declare function readFactsState(stateDir: string): Promise<FactsSyncState | null>;
+/** Record facts the backend already holds (the deploy sent them on create), so boot does not resend. */
+export declare function recordFactsSent(stateDir: string, facts: StrategyFacts): Promise<void>;
+/** What this boot would send for one instance. Local only: files, no network. */
+export declare function planBootFacts(input: {
+    runtimeId: string;
+    wallet: string;
+    stateDir: string;
+    config: RuntimeConfig;
+    runtimeYamlDir?: string;
+}): Promise<FactsPlan>;
+/**
+ * Send one instance's planned facts, at most once. Never throws. A state write that fails after a
+ * send only costs a resend on the next boot.
+ */
+export declare function syncBootFacts(plan: FactsPlan, deps: FactsSyncDeps): Promise<FactsSyncResult>;
+//# sourceMappingURL=facts-sync.d.ts.map

package/dist/strategy/facts-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts-sync.d.ts","sourceRoot":"","sources":["../../src/strategy/facts-sync.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1F,eAAO,MAAM,gBAAgB,wBAAwB,CAAC;AACtD,2GAA2G;AAC3G,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAGjD,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,6FAA6F;IAC7F,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,0GAA0G;IAC1G,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;CACjC;AAED,yGAAyG;AACzG,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,qGAAqG;IACrG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC5E;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEtD;AAuBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CASlH;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,aAAa,CAOjG;AAkBD,+FAA+F;AAC/F,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAOrF;AAUD,wGAAwG;AACxG,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3F;AAED,iFAAiF;AACjF,wBAAsB,aAAa,CAAC,KAAK,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,SAAS,CAAC,CAerB;AAaD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAgClG"}

package/dist/strategy/facts-sync.js

@@ -0,0 +1,184 @@
+/**
+ * Boot-time StrategyFacts sync: at every boot, each running instance sends its facts to the backend
+ * (MCP `strategy_patch_metadata`) once, and only when they differ from what it last settled.
+ *
+ * The package files live only on the user's box, so sending at boot as well as at deploy gives
+ * every live package facts after one image rollout, without waiting for a redeploy.
+ *
+ * What "last settled" means is kept in the runtime's own state dir (`strategy-facts.json`): the
+ * hash of the last facts the backend accepted or refused for good. A refusal is final for that hash
+ * (the box does not retry it every boot); anything transient (UNAVAILABLE, a thrown call, an
+ * unknown strategy id) writes nothing, so the next boot tries once more. Nothing here loops, and
+ * nothing here may block boot or trading: the caller runs the send detached, after the runtimes
+ * are up.
+ */
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+import { errorText } from "../deploy/error-text.js";
+import { computeConfigHash } from "../telemetry/identity.js";
+import { strategyFacts } from "./facts.js";
+export const FACTS_STATE_FILE = "strategy-facts.json";
+/** Bound on one boot facts send (connect excluded; the SDK bounds that). Detached from boot either way. */
+export const BOOT_FACTS_CALL_TIMEOUT_MS = 30_000;
+const MANIFEST_FILE = "strategy.yaml";
+export function factsHash(facts) {
+    return computeConfigHash(facts) ?? "";
+}
+function isMap(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+async function readYamlMap(path) {
+    try {
+        const parsed = parseYaml(await readFile(path, "utf8"));
+        return isMap(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Does this manifest declare an instance whose runtime.yaml lives in `runtimeYamlDir`? */
+function declaresDir(manifest, packageDir, runtimeYamlDir) {
+    const instances = Array.isArray(manifest.instances) ? manifest.instances : [];
+    return instances.some((inst) => isMap(inst) && typeof inst.runtime === "string" && dirname(resolve(packageDir, inst.runtime)) === runtimeYamlDir);
+}
+/**
+ * The package manifest of a runtime, best-effort. Stock packages are `<pkg>/strategy.yaml` beside
+ * `<pkg>/<instance>/runtime.yaml`; flat ones keep both in `<pkg>/`. So look in the runtime's own
+ * dir, then its parent, and take the parent's only when it declares this instance. Null when none
+ * is found or it will not parse; never throws. The files can change after deploy, and
+ * `runtime create` installs have no package at all.
+ */
+export async function readPackageManifest(runtimeYamlDir) {
+    if (!runtimeYamlDir)
+        return null;
+    const dir = resolve(runtimeYamlDir);
+    const own = await readYamlMap(join(dir, MANIFEST_FILE));
+    if (own)
+        return { catalog: own.catalog };
+    const parentDir = dirname(dir);
+    const parent = await readYamlMap(join(parentDir, MANIFEST_FILE));
+    if (parent && declaresDir(parent, parentDir, dir))
+        return { catalog: parent.catalog };
+    return null;
+}
+/**
+ * Boot facts over the last accepted ones. A boot that cannot read the manifest loses the catalog
+ * fallback for assets and direction; it must not overwrite what the deploy sent with nulls. The
+ * boot's values win wherever they are non-null. Assets are carried over only when the boot does
+ * not know the universe either: a scanner that ranks a live board has no asset list by design.
+ */
+export function mergeBootFacts(boot, lastSent) {
+    if (!lastSent)
+        return boot;
+    return {
+        ...boot,
+        assets: boot.assets ?? (boot.universe === null ? lastSent.assets : null),
+        direction: boot.direction ?? lastSent.direction,
+    };
+}
+function statePath(stateDir) {
+    return join(stateDir, FACTS_STATE_FILE);
+}
+/**
+ * The state file's shape. `sent` is checked as far as the MCP checks facts (`v: 1`): it was written
+ * by this module from a `StrategyFacts`, and a hand-edited one is merged and hashed, never trusted
+ * further than the backend would.
+ */
+const factsSyncStateSchema = z.object({
+    v: z.literal(1),
+    hash: z.string(),
+    outcome: z.enum(["sent", "refused"]),
+    sent: z.object({ v: z.literal(1) }).passthrough().nullable(),
+});
+/** The stored state, or null when there is none or it is unreadable (read as "never sent"). */
+export async function readFactsState(stateDir) {
+    try {
+        const parsed = factsSyncStateSchema.safeParse(JSON.parse(await readFile(statePath(stateDir), "utf8")));
+        return parsed.success ? ({ ...parsed.data, sent: parsed.data.sent }) : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeFactsState(stateDir, state) {
+    await mkdir(stateDir, { recursive: true });
+    const target = statePath(stateDir);
+    const tmp = `${target}.${process.pid}.${randomUUID()}.tmp`;
+    await writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
+    await rename(tmp, target);
+}
+/** Record facts the backend already holds (the deploy sent them on create), so boot does not resend. */
+export async function recordFactsSent(stateDir, facts) {
+    await writeFactsState(stateDir, { v: 1, hash: factsHash(facts), outcome: "sent", sent: facts });
+}
+/** What this boot would send for one instance. Local only: files, no network. */
+export async function planBootFacts(input) {
+    const manifest = await readPackageManifest(input.runtimeYamlDir);
+    const previous = await readFactsState(input.stateDir);
+    const facts = mergeBootFacts(strategyFacts(input.config, manifest), previous?.sent ?? null);
+    const hash = factsHash(facts);
+    return {
+        runtimeId: input.runtimeId,
+        wallet: input.wallet,
+        stateDir: input.stateDir,
+        facts,
+        hash,
+        unchanged: previous?.hash === hash,
+        delivered: previous?.outcome === "sent" && previous.hash === hash,
+        previous,
+    };
+}
+/**
+ * Codes that say nothing about the facts, so the next boot tries again whatever `retryable` says:
+ * UNAVAILABLE (transport) and SERR032 (the box's token expired; 124 marks it `retryable: false`).
+ */
+const RETRY_NEXT_BOOT_CODES = new Set(["UNAVAILABLE", "SERR032"]);
+/** A refusal the backend will repeat for these facts: a code that is neither retryable nor the box's own state. */
+function isFinalRefusal(result) {
+    return result.errorCode !== undefined && !RETRY_NEXT_BOOT_CODES.has(result.errorCode) && result.retryable !== true;
+}
+/**
+ * Send one instance's planned facts, at most once. Never throws. A state write that fails after a
+ * send only costs a resend on the next boot.
+ */
+export async function syncBootFacts(plan, deps) {
+    if (plan.unchanged)
+        return { outcome: "unchanged" };
+    const strategyId = deps.strategyIdFor(plan.wallet);
+    if (!strategyId)
+        return { outcome: "failed", detail: "no strategy id known for this wallet" };
+    let result;
+    try {
+        result = await deps.patch(strategyId, plan.facts);
+    }
+    catch (err) {
+        return { outcome: "failed", detail: errorText(err) };
+    }
+    const detail = result.errorCode
+        ? `${result.errorCode}: ${result.message ?? "no message"}`
+        : "no error code in the answer";
+    let settled;
+    let state;
+    if (result.success) {
+        settled = { outcome: "sent" };
+        state = { v: 1, hash: plan.hash, outcome: "sent", sent: plan.facts };
+    }
+    else if (isFinalRefusal(result)) {
+        settled = { outcome: "refused", detail };
+        state = { v: 1, hash: plan.hash, outcome: "refused", sent: plan.previous?.sent ?? null };
+    }
+    else {
+        return { outcome: "failed", detail };
+    }
+    try {
+        await writeFactsState(plan.stateDir, state);
+    }
+    catch (err) {
+        return { ...settled, detail: `${settled.detail ? `${settled.detail}; ` : ""}state not saved: ${errorText(err)}` };
+    }
+    return settled;
+}
+//# sourceMappingURL=facts-sync.js.map

package/dist/strategy/facts-sync.js.map

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

package/dist/strategy/facts.d.ts

@@ -0,0 +1,79 @@
+/**
+ * StrategyFacts v1: what one runtime instance does, read from its own files. One value per
+ * instance, because each instance owns its own wallet.
+ *
+ * Facts only. No wording, no model, no scanner-input names or "what it looks for" hints: the same
+ * input means opposite things across packages (`minTraderCount` is "the crowd agrees" in Beaver and
+ * "the crowd is crowded, fade it" in Dog), so the only inputs read are ticker lists, a universe
+ * shape, an explicit long/short leg, and leverage/margin numbers. Rendering belongs to the backend.
+ *
+ * Pure: no I/O, never throws. Every field is null when the files do not say, never a guess. The
+ * exit block is read THROUGH THE ENGINE'S OWN READER (`mapRuntimeExitToDslConfig` + `parsePreset`,
+ * as `loadRuntimeConfig` and `runtime-descriptor.ts` do), so a fact here is what the DSL enforces.
+ *
+ * Port of the runtime-file fields of the pages-v2 prototype `strategy-describer/describe.py`.
+ */
+import type { RuntimeConfig } from "../runtime/runtime-schema.js";
+export type StrategyDirection = "long" | "short" | "long_short";
+export interface StrategyExitFacts {
+    /** Max loss as % of margin. Enforced as the absolute floor even with phase 1 off (`floors.ts` phase1BaseFloor). */
+    loss_cap_pct: number;
+    time_cap_min: number | null;
+    /** [trigger_pct, lock_hw_pct] of the first profit-lock tier; null when phase 2 is off. */
+    first_lock: [number, number] | null;
+    /** Number of profit-lock tiers the engine acts on; 0 when phase 2 is off. */
+    lock_steps: number;
+    weak_peak_cut: {
+        after_min: number;
+        under_pct: number;
+    } | null;
+    dead_weight_cut: {
+        after_min: number;
+    } | null;
+}
+export interface StrategyLimitFacts {
+    max_entries_per_day: number | null;
+    daily_loss_pct: number | null;
+    /** Gate 3 runs only when both are set (`risk/guardrail.types.ts`), so it is both or null. */
+    loss_streak: {
+        count: number;
+        pause_s: number;
+    } | null;
+    drawdown_halt_pct: number | null;
+    same_market_wait_s: number | null;
+}
+/** Wire shape, snake_case, versioned. */
+export interface StrategyFacts {
+    v: 1;
+    /** Static ticker list from the entry scanner's inputs, else the manifest's `catalog.assets`. */
+    assets: string[] | null;
+    /** "static" when the scanner names its tickers, "dynamic" when it picks from a live board. */
+    universe: "static" | "dynamic" | null;
+    /** Scanner `direction`/`leg` input when it is long or short, else the manifest's `catalog.direction`. */
+    direction: StrategyDirection | null;
+    leverage_default: number | null;
+    leverage_max: number | null;
+    margin_pct: number | null;
+    margin_pct_max: number | null;
+    slots: number | null;
+    scan_interval_s: number | null;
+    exit: StrategyExitFacts | null;
+    limits: StrategyLimitFacts | null;
+}
+/** The part of a package manifest (`strategy.yaml`) read here. `DeployPackage` satisfies it. */
+export interface StrategyManifestLike {
+    catalog?: unknown;
+}
+/** The catalog copy the backend reads from `strategyMetadata.catalog` (ticket 116). */
+export interface StrategyCatalogCopy {
+    name: string;
+    tagline: string;
+    belief_plain: string;
+}
+/**
+ * `{name, tagline, belief_plain}` out of a manifest's `catalog:` block, or null unless all three are
+ * non-empty strings: the MCP stores the catalog only whole, so a partial one would be dropped there.
+ */
+export declare function catalogCopy(catalog: unknown): StrategyCatalogCopy | null;
+export declare function strategyFacts(config: RuntimeConfig, manifest?: StrategyManifestLike | null): StrategyFacts;
+//# sourceMappingURL=facts.d.ts.map

package/dist/strategy/facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts.d.ts","sourceRoot":"","sources":["../../src/strategy/facts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,aAAa,EAA+B,MAAM,8BAA8B,CAAC;AAM/F,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,YAAY,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,mHAAmH;IACnH,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,0FAA0F;IAC1F,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACpC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/D,eAAe,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6FAA6F;IAC7F,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACvD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,CAAC,EAAE,CAAC,CAAC;IACL,gGAAgG;IAChG,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,8FAA8F;IAC9F,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAAC;IACtC,yGAAyG;IACzG,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACnC;AAED,gGAAgG;AAChG,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,GAAG,IAAI,CAKxE;AA6JD,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,IAAI,GAAG,aAAa,CAgB1G"}

package/dist/strategy/facts.js

@@ -0,0 +1,184 @@
+import { mapRuntimeExitToDslConfig } from "../runtime/map-exit-config.js";
+import { parsePreset } from "../dsl/config/parse-preset.js";
+import { DEFAULT_INTERVAL_MS, EXIT_DSL_PRESET_PATH } from "../constants/dsl/index.js";
+/**
+ * `{name, tagline, belief_plain}` out of a manifest's `catalog:` block, or null unless all three are
+ * non-empty strings: the MCP stores the catalog only whole, so a partial one would be dropped there.
+ */
+export function catalogCopy(catalog) {
+    if (!isMap(catalog))
+        return null;
+    const { name, tagline, belief_plain } = catalog;
+    const filled = (value) => typeof value === "string" && value.trim().length > 0;
+    return filled(name) && filled(tagline) && filled(belief_plain) ? { name, tagline, belief_plain } : null;
+}
+/** Input keys whose value is the scanner's own ticker list (or a single ticker), in priority order. */
+const ASSET_KEYS = ["universe", "allowedAssets", "assets", "whitelist", "trackedAssets", "asset", "coin", "hedgeUniverse"];
+/** Keys that hold a ticker list only as a list (never a single string). */
+const LIST_ONLY_ASSET_KEYS = ["equities", "trackedCrypto", "riskAssets"];
+/** Inputs that size a live, ranked universe instead of naming one. */
+const DYNAMIC_UNIVERSE_KEYS = [
+    "universeVolFloorUsd", "universeMaxNames", "universeTopN", "topN", "maxUniverse", "universeSize",
+    "maxUniverseNames", "maxMainNames", "volFloorUsd", "leaderboardLimit", "shortlistByVol", "minOiUsd",
+    "xyzVolFloorUsd", "trackedXyz",
+];
+const TICKER = /^(xyz:)?[A-Za-z0-9]{2,10}$/;
+function num(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function isMap(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function tickers(value) {
+    if (!Array.isArray(value) || value.length === 0)
+        return null;
+    return value.every((x) => typeof x === "string" && TICKER.test(x)) ? value : null;
+}
+/** Every finite number inside a (possibly nested) tier map such as `leverageTiers`. */
+function tierNumbers(value) {
+    if (num(value) !== null)
+        return [value];
+    if (Array.isArray(value))
+        return value.flatMap(tierNumbers);
+    if (isMap(value))
+        return Object.values(value).flatMap(tierNumbers);
+    return [];
+}
+function firstNum(inputs, keys) {
+    for (const k of keys) {
+        const n = num(inputs[k]);
+        if (n !== null)
+            return n;
+    }
+    return null;
+}
+function normalizeDirection(value) {
+    if (typeof value !== "string")
+        return null;
+    switch (value.trim().toLowerCase()) {
+        case "long":
+        case "long_only":
+            return "long";
+        case "short":
+        case "short_only":
+            return "short";
+        case "long_short":
+            return "long_short";
+        default:
+            return null;
+    }
+}
+function universeFacts(inputs, catalog) {
+    for (const k of ASSET_KEYS) {
+        const v = inputs[k];
+        const list = tickers(typeof v === "string" ? [v] : v);
+        if (list)
+            return { assets: list, universe: "static" };
+    }
+    for (const k of LIST_ONLY_ASSET_KEYS) {
+        const list = tickers(inputs[k]);
+        if (list)
+            return { assets: list, universe: "static" };
+    }
+    const dex = typeof inputs.dex === "string" ? inputs.dex.toLowerCase() : "";
+    if (dex === "xyz" || DYNAMIC_UNIVERSE_KEYS.some((k) => k in inputs))
+        return { assets: null, universe: "dynamic" };
+    // Declared, not observed: the manifest says which tickers, but not whether the scanner is held to them.
+    return { assets: tickers(catalog.assets), universe: null };
+}
+function directionFact(inputs, catalog) {
+    return (normalizeDirection(inputs.direction) ?? normalizeDirection(inputs.leg) ?? normalizeDirection(catalog.direction));
+}
+function leverageMax(inputs) {
+    const explicit = firstNum(inputs, ["maxLeverage", "leverageMax", "max_leverage"]);
+    if (explicit !== null)
+        return explicit;
+    const tiers = tierNumbers(inputs.leverageTiers);
+    if (tiers.length > 0)
+        return Math.max(...tiers);
+    return num(inputs.leverage);
+}
+function marginFacts(strategy, inputs) {
+    let marginPct = num(strategy.margin_pct);
+    let marginPctMax = null;
+    if (marginPct === null) {
+        marginPct = firstNum(inputs, ["marginPct", "marginPctBase", "margin_pct", "marginPctMax"]);
+        const tiers = tierNumbers(inputs.marginPctTiers);
+        if (marginPct === null && tiers.length > 0) {
+            marginPct = Math.min(...tiers);
+            marginPctMax = Math.max(...tiers);
+        }
+    }
+    if (marginPctMax === null) {
+        const cap = firstNum(inputs, ["maxMarginPct", "marginPctMax", "marginPctCap"]);
+        if (cap !== null && cap !== marginPct)
+            marginPctMax = cap;
+    }
+    return { margin_pct: marginPct, margin_pct_max: marginPctMax };
+}
+/** The preset the DSL monitor would run, or null when there is none or the engine refuses it. */
+function enginePreset(exit) {
+    try {
+        const block = mapRuntimeExitToDslConfig(exit);
+        if (!isMap(block.dsl_preset))
+            return null;
+        // Same clamp floor `parseDslPluginConfig` passes: the exit poll interval, in minutes.
+        return parsePreset(EXIT_DSL_PRESET_PATH, block.dsl_preset, (block.interval_seconds ?? DEFAULT_INTERVAL_MS / 1000) / 60);
+    }
+    catch {
+        return null;
+    }
+}
+function exitFacts(exit) {
+    const preset = enginePreset(exit);
+    if (preset === null)
+        return null;
+    const tiers = preset.phase2Enabled ? preset.tiers : [];
+    const first = tiers[0];
+    return {
+        loss_cap_pct: preset.maxLossPct,
+        time_cap_min: preset.hardTimeout?.intervalInMinutes ?? null,
+        first_lock: first ? [first.triggerPct, first.lockHwPct] : null,
+        lock_steps: tiers.length,
+        weak_peak_cut: preset.weakPeakCut
+            ? { after_min: preset.weakPeakCut.intervalInMinutes, under_pct: preset.weakPeakCut.minValue }
+            : null,
+        dead_weight_cut: preset.deadWeightCut ? { after_min: preset.deadWeightCut.intervalInMinutes } : null,
+    };
+}
+function limitFacts(config) {
+    const gr = config.risk?.guard_rails;
+    if (!gr)
+        return null;
+    const count = num(gr.max_consecutive_losses);
+    const pause = num(gr.cooldown_seconds);
+    return {
+        max_entries_per_day: num(gr.max_entries_per_day),
+        daily_loss_pct: num(gr.daily_loss_limit_pct),
+        loss_streak: count !== null && pause !== null ? { count, pause_s: pause } : null,
+        drawdown_halt_pct: num(gr.drawdown_halt_pct),
+        same_market_wait_s: num(gr.per_asset_cooldown_seconds),
+    };
+}
+/** The scanner that produces entries: the first `external_scanner`. */
+function entryScanner(config) {
+    return config.scanners?.find((s) => s.type === "external_scanner");
+}
+export function strategyFacts(config, manifest) {
+    const scanner = entryScanner(config);
+    const inputs = isMap(scanner?.inputs) ? scanner.inputs : {};
+    const catalog = isMap(manifest?.catalog) ? manifest.catalog : {};
+    return {
+        v: 1,
+        ...universeFacts(inputs, catalog),
+        direction: directionFact(inputs, catalog),
+        leverage_default: num(config.strategy.default_leverage),
+        leverage_max: leverageMax(inputs),
+        ...marginFacts(config.strategy, inputs),
+        slots: num(config.strategy.slots),
+        scan_interval_s: num(scanner?.interval_seconds),
+        exit: exitFacts(config.exit),
+        limits: limitFacts(config),
+    };
+}
+//# sourceMappingURL=facts.js.map

package/dist/strategy/facts.js.map

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

package/dist/strategy/index.d.ts

@@ -1,2 +1,3 @@
 export { StrategyStateImpl } from './strategy-state.js';
+export { strategyFacts, type StrategyFacts, type StrategyExitFacts, type StrategyLimitFacts, type StrategyDirection, type StrategyManifestLike, } from './facts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/strategy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strategy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strategy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC"}

package/dist/strategy/index.js

@@ -1,2 +1,3 @@
 export { StrategyStateImpl } from './strategy-state.js';
+export { strategyFacts, } from './facts.js';
 //# sourceMappingURL=index.js.map

package/dist/strategy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategy/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,aAAa,GAMd,MAAM,YAAY,CAAC"}