desic-okx-agent 0.2.0 → 0.3.0

package/dist/report/compare.js.map

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

package/dist/report/fetch.d.ts

@@ -0,0 +1,20 @@
+import type { RuntimeClient } from "../runtime/client.js";
+import type { ReportInput } from "./html.js";
+import type { ComparisonInput } from "./compare.js";
+/**
+ * Gathers everything a report needs, following pagination.
+ *
+ * Requesting a large limit is not enough: the store bounds a single page, so a
+ * one-shot read silently returns a prefix. That produced a chart showing a 37%
+ * drawdown next to a metric block reporting 79% — the picture contradicting the
+ * numbers is worse than no picture.
+ */
+export declare function collectReport(client: RuntimeClient, runId: string): Promise<ReportInput>;
+/**
+ * Gathers the runs for a comparison.
+ *
+ * Only the summary and the equity curve are read: a comparison overlays curves and
+ * tabulates metrics, and pulling every trade for six runs would cost far more than
+ * it shows. Fetched concurrently, since the reads are independent.
+ */
+export declare function collectComparison(client: RuntimeClient, runIds: string[]): Promise<ComparisonInput>;

package/dist/report/fetch.js

@@ -0,0 +1,56 @@
+import { MAX_PAGE_ROWS } from "../strategy/constants.js";
+/**
+ * Ceiling on total points gathered for a report. A year of one-minute bars is
+ * ~525k points, which is plotted after downsampling; beyond this the extra
+ * detail cannot survive the chart anyway.
+ */
+const MAX_POINTS = 600_000;
+/**
+ * Gathers everything a report needs, following pagination.
+ *
+ * Requesting a large limit is not enough: the store bounds a single page, so a
+ * one-shot read silently returns a prefix. That produced a chart showing a 37%
+ * drawdown next to a metric block reporting 79% — the picture contradicting the
+ * numbers is worse than no picture.
+ */
+export async function collectReport(client, runId) {
+    const run = (await client.call("strategy_get_run", { runId })).data;
+    const [equity, trades, actions] = await Promise.all([
+        collect(client, "strategy_get_run_equity", runId, MAX_POINTS),
+        collect(client, "strategy_get_run_trades", runId, 50_000),
+        collect(client, "strategy_get_run_actions", runId, 50_000)
+    ]);
+    return { run, equity, trades, actions };
+}
+/**
+ * Gathers the runs for a comparison.
+ *
+ * Only the summary and the equity curve are read: a comparison overlays curves and
+ * tabulates metrics, and pulling every trade for six runs would cost far more than
+ * it shows. Fetched concurrently, since the reads are independent.
+ */
+export async function collectComparison(client, runIds) {
+    const runs = await Promise.all(runIds.map(async (runId) => {
+        const run = (await client.call("strategy_get_run", { runId })).data;
+        // A run that never completed has no curve to plot; it is still listed so the
+        // comparison can say why it is missing.
+        const equity = run.status === "completed" ? await collect(client, "strategy_get_run_equity", runId, MAX_POINTS) : [];
+        return { run, equity };
+    }));
+    return { runs };
+}
+async function collect(client, tool, runId, ceiling) {
+    const rows = [];
+    let offset = 0;
+    for (;;) {
+        const page = (await client.call(tool, { runId, offset, limit: MAX_PAGE_ROWS })).data;
+        rows.push(...page.rows);
+        offset += page.rows.length;
+        // Stop on an empty page too, so a store that reports a larger total than it
+        // can serve cannot spin here forever.
+        if (page.rows.length === 0 || offset >= page.total || rows.length >= ceiling)
+            break;
+    }
+    return rows;
+}
+//# sourceMappingURL=fetch.js.map

package/dist/report/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/report/fetch.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD;;;;GAIG;AACH,MAAM,UAAU,GAAG,OAAO,CAAC;AAO3B;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB,EAAE,KAAa;IACtE,MAAM,GAAG,GAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,CAA0B,CAAC,IAAI,CAAC;IAC9F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,OAAO,CAAc,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,UAAU,CAAC;QAC1E,OAAO,CAA0B,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,CAAC;QAClF,OAAO,CAA0B,MAAM,EAAE,0BAA0B,EAAE,KAAK,EAAE,MAAM,CAAC;KACpF,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAqB,EACrB,MAAgB;IAEhB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QACzB,MAAM,GAAG,GAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,CAAC,CAA0B,CAAC,IAAI,CAAC;QAC9F,6EAA6E;QAC7E,wCAAwC;QACxC,MAAM,MAAM,GACV,GAAG,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,OAAO,CAAc,MAAM,EAAE,yBAAyB,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC,CACH,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,MAAqB,EACrB,IAAY,EACZ,KAAa,EACb,OAAe;IAEf,MAAM,IAAI,GAAQ,EAAE,CAAC;IACrB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,SAAS,CAAC;QACR,MAAM,IAAI,GAAI,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAuB,CAAC,IAAI,CAAC;QAC5G,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;QAC3B,4EAA4E;QAC5E,sCAAsC;QACtC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,OAAO;YAAE,MAAM;IACtF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/report/html.d.ts

@@ -0,0 +1,54 @@
+import type { EquityPoint, RunSummary } from "../strategy/types.js";
+export interface ReportInput {
+    run: RunSummary;
+    equity: EquityPoint[];
+    trades: Array<Record<string, unknown>>;
+    actions: Array<Record<string, unknown>>;
+}
+/**
+ * Renders a self-contained HTML report.
+ *
+ * Everything is inlined — no CDN, no fonts, no scripts fetched at view time — so
+ * the file opens offline, keeps working when archived next to its run, and never
+ * sends the contents of a strategy anywhere.
+ *
+ * The chart is drawn as SVG paths computed here rather than by a charting
+ * library: a 50,000-point curve as JSON plus a bundled library would be
+ * megabytes, and the useful information survives downsampling.
+ */
+export declare function renderReportHtml(input: ReportInput): string;
+/**
+ * Reduces a curve for plotting while keeping its shape.
+ *
+ * Each bucket contributes both its highest and lowest point, in the order they
+ * occurred. Picking one point per bucket — even alternating high and low — drops
+ * a spike whenever it lands in a bucket that happens to be looking for the other
+ * extreme, which erases exactly the moves a reader is scanning for.
+ */
+export declare function downsample(points: EquityPoint[], target: number): EquityPoint[];
+/** Percentage below the running peak at each point. */
+export declare function drawdownSeries(points: EquityPoint[], initialEquity: number): number[];
+/**
+ * Escapes text for HTML.
+ *
+ * Strategy names and error messages come from user input, so anything
+ * interpolated into the document is escaped rather than trusted.
+ */
+export declare function escapeHtml(value: string): string;
+/**
+ * Escapes a value for a single-quoted HTML attribute.
+ *
+ * The series JSON is carried in an attribute rather than a script literal, so a
+ * quote or an angle bracket inside it cannot terminate the attribute or open a
+ * tag. Kept separate from `escapeHtml` because that one escapes double quotes
+ * and would mangle the JSON's own syntax.
+ */
+export declare function escapeAttribute(value: string): string;
+/**
+ * Styles for the comparison document.
+ *
+ * The single-run sheet plus the few rules a matrix table needs, rather than a
+ * second copy: the two documents should not drift apart visually, and a duplicated
+ * sheet is exactly how that happens.
+ */
+export declare const COMPARE_STYLES = "\n:root{--bg:#0f1116;--panel:#171a21;--line:#242833;--text:#e6e8ee;--dim:#8b90a0;--up:#3fb950;--down:#f2777a;--accent:#4f9cf9}\n@media(prefers-color-scheme:light){:root{--bg:#f7f8fa;--panel:#fff;--line:#e3e6ec;--text:#1a1d24;--dim:#6b7280;--up:#1a7f37;--down:#c9372c}}\n*{box-sizing:border-box}\nbody{margin:0;background:var(--bg);color:var(--text);font:14px/1.55 -apple-system,BlinkMacSystemFont,\"Segoe UI\",Roboto,\"Helvetica Neue\",\"PingFang SC\",\"Microsoft YaHei\",sans-serif}\nmain{max-width:1080px;margin:0 auto;padding:32px 24px 64px}\nheader{display:flex;justify-content:space-between;align-items:flex-end;gap:24px;flex-wrap:wrap;padding-bottom:20px;border-bottom:1px solid var(--line)}\nh1{margin:0;font-size:26px;font-weight:600;letter-spacing:-.01em}\n.sub{margin:4px 0 0;color:var(--dim);font-size:13px}\n.headline{text-align:right}\n.headline .value{display:block;font-size:34px;font-weight:650;letter-spacing:-.02em;font-variant-numeric:tabular-nums}\n.headline .label{color:var(--dim);font-size:12px;text-transform:uppercase;letter-spacing:.08em}\n.up{color:var(--up)}.down{color:var(--down)}.flat{color:var(--dim)}\n.facts{display:flex;gap:28px;flex-wrap:wrap;margin:20px 0 8px;color:var(--dim);font-size:13px}\n.facts span{display:block;text-transform:uppercase;letter-spacing:.06em;font-size:11px}\n.facts strong{color:var(--text);font-weight:550;font-variant-numeric:tabular-nums}\n.warnings{margin:20px 0 0;padding:12px 16px;border-left:3px solid var(--down);background:color-mix(in srgb,var(--down) 8%,transparent);border-radius:0 6px 6px 0}\n.warnings p{margin:4px 0;font-size:13px}\nsection{margin-top:32px}\nh2{margin:0 0 14px;font-size:12px;font-weight:600;text-transform:uppercase;letter-spacing:.1em;color:var(--dim)}\nh2 .count{color:var(--dim);font-weight:400}\ndl{display:grid;grid-template-columns:repeat(auto-fit,minmax(210px,1fr));gap:1px;margin:0;background:var(--line);border:1px solid var(--line);border-radius:8px;overflow:hidden}\ndl>div{background:var(--panel);padding:12px 14px}\ndt{color:var(--dim);font-size:11px;text-transform:uppercase;letter-spacing:.06em}\ndd{margin:3px 0 0;font-size:16px;font-weight:550;font-variant-numeric:tabular-nums}\n.chart{background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:10px 12px;display:flex;gap:10px;align-items:stretch}\n.chart.drawdown{margin-top:8px;border-radius:8px}\n.chart svg{flex:1;height:240px;width:100%;display:block}\n.chart.drawdown svg{height:80px}\n.axis{display:flex;flex-direction:column;justify-content:space-between;color:var(--dim);font-size:11px;font-variant-numeric:tabular-nums;min-width:62px;text-align:right}\n.range{margin:8px 0 0;color:var(--dim);font-size:12px}\n.chart{position:relative}\n.chart svg{cursor:crosshair}\n.chart:focus-visible{outline:2px solid var(--accent);outline-offset:2px}\n.baseline{stroke:var(--dim);stroke-width:1;stroke-dasharray:3 4;opacity:.5;vector-effect:non-scaling-stroke}\n.crosshair{stroke:var(--dim);stroke-width:1;vector-effect:non-scaling-stroke;pointer-events:none}\n.marker{fill:var(--accent);stroke:var(--panel);stroke-width:1.5;pointer-events:none}\n.tooltip{position:absolute;top:10px;pointer-events:none;background:var(--panel);border:1px solid var(--line);border-radius:6px;padding:8px 10px;font-size:12px;min-width:180px;box-shadow:0 4px 16px rgba(0,0,0,.28);z-index:2}\n.tooltip .row{display:flex;justify-content:space-between;gap:14px;padding:1px 0}\n.tooltip .row span{color:var(--dim)}\n.tooltip .row b{font-weight:550;font-variant-numeric:tabular-nums}\n.scroll{overflow-x:auto;border:1px solid var(--line);border-radius:8px}\ntable{width:100%;border-collapse:collapse;font-size:13px}\nth,td{padding:8px 12px;text-align:left;border-bottom:1px solid var(--line);white-space:nowrap}\nth{background:var(--panel);color:var(--dim);font-size:11px;font-weight:600;text-transform:uppercase;letter-spacing:.06em;position:sticky;top:0}\ntbody tr:last-child td{border-bottom:none}\ntd.n{text-align:right;font-variant-numeric:tabular-nums}\ntr.up td:nth-child(5),tr.up td:nth-child(6){color:var(--up)}\ntr.down td:nth-child(5),tr.down td:nth-child(6){color:var(--down)}\n.mono{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:12px}\ntd.dim{color:var(--dim)}\n.scroll.tall{max-height:520px;overflow-y:auto}\n.histogram{background:var(--panel);border:1px solid var(--line);border-radius:8px;padding:12px 14px}\n.bin{display:flex;align-items:center;gap:10px;padding:3px 0}\n.bin .range{min-width:132px;color:var(--dim);text-align:right;flex-shrink:0}\n.bin .track{flex:1;height:12px;background:color-mix(in srgb,var(--line) 60%,transparent);border-radius:3px;overflow:hidden}\n.bin .fill{display:block;height:100%;border-radius:3px}\n.bin .fill.up{background:var(--up)}\n.bin .fill.down{background:var(--down)}\n.bin>.count{min-width:44px;text-align:right;color:var(--dim);font-size:12px;font-variant-numeric:tabular-nums;flex-shrink:0}\n.empty{color:var(--dim);font-size:13px}\nfooter{margin-top:40px;padding-top:16px;border-top:1px solid var(--line);color:var(--dim);font-size:12px}\nfooter p{margin:4px 0}\n\n.legend{display:flex;gap:20px;flex-wrap:wrap;margin:20px 0 0;font-size:13px}\n.legend div{display:flex;align-items:center;gap:7px}\n.legend i,th i{display:inline-block;width:10px;height:10px;border-radius:2px;flex-shrink:0}\nth i{margin-right:6px;vertical-align:middle}\ntable.matrix th[scope=row]{background:var(--panel);color:var(--dim);text-transform:none;letter-spacing:0;font-size:12px;font-weight:500;text-align:left;position:sticky;left:0}\ntable.matrix thead th{text-align:right}\ntable.matrix thead th span.dim{display:block;font-weight:400;text-transform:none;letter-spacing:0;font-size:10px}\ntd.best{color:var(--up);font-weight:600}\n.chart .tooltip .swatch{display:inline-block;width:8px;height:8px;border-radius:2px;margin-right:6px}\n.chart .tooltip .row.head{border-bottom:1px solid var(--line);margin-bottom:3px;padding-bottom:3px}\n";