desic-okx-agent 0.2.0 → 0.3.0

package/dist/tui/commands.js

@@ -0,0 +1,313 @@
+/**
+ * Slash command surface for the interactive shell.
+ *
+ * Commands are data, not React: the parser, the completion list, and the
+ * argument handling are all testable without rendering a terminal.
+ *
+ * Every piece of prose here is a message-bundle key rather than English text, so
+ * `/help` follows the chosen language like the rest of the shell. Command names,
+ * argument placeholders, and usage strings stay literal: they are what the user
+ * types, and translating those would make a copied line stop working.
+ */
+import { activeMessages } from "../i18n/locale.js";
+import { displayWidth, padEndDisplay } from "../cli/width.js";
+/**
+ * Reads one bundle key as text.
+ *
+ * The bundle mixes plain strings with functions; only the plain ones are used for
+ * command help, so a key pointing at a function is a wiring mistake and shows as
+ * the key itself rather than crashing the shell.
+ */
+function phrase(key) {
+    const value = activeMessages()[key];
+    return typeof value === "string" ? value : String(key);
+}
+/** One command's summary in the active language. */
+export function commandSummary(spec) {
+    return phrase(spec.summary);
+}
+/** One command's long help in the active language, when it has any. */
+export function commandDetail(spec) {
+    return spec.detail === undefined ? undefined : phrase(spec.detail);
+}
+/** One argument's description in the active language. */
+export function argumentDescription(argument) {
+    return phrase(argument.description);
+}
+export const COMMANDS = [
+    {
+        name: "help",
+        summary: "cmdHelp",
+        usage: "/help [command]",
+        args: [{ name: "command", description: "argHelpCommand", required: false }]
+    },
+    {
+        name: "data",
+        summary: "cmdData",
+        usage: "/data",
+        detail: "cmdDataDetail"
+    },
+    {
+        name: "download",
+        summary: "cmdDownload",
+        usage: "/download <instrument> [days | range]",
+        detail: "cmdDownloadDetail",
+        args: [
+            { name: "instrument", description: "argInstrument", default: "BTC-USDT-SWAP" },
+            { name: "days | range", description: "argWindow30", default: "30" }
+        ]
+    },
+    {
+        name: "new",
+        summary: "cmdNew",
+        usage: "/new <file.py> [template]",
+        detail: "cmdNewDetail",
+        args: [
+            { name: "file.py", description: "argDestinationFile", required: true },
+            { name: "template", description: "argTemplate", default: "ema-trend" }
+        ]
+    },
+    {
+        name: "validate",
+        summary: "cmdValidate",
+        usage: "/validate <file.py>",
+        detail: "cmdValidateDetail",
+        args: [{ name: "file.py", description: "argStrategyToCheck", required: true }]
+    },
+    {
+        name: "backtest",
+        summary: "cmdBacktest",
+        usage: "/backtest <file.py | setting> [instrument] [days | range]",
+        detail: "cmdBacktestDetail",
+        args: [
+            { name: "file.py | setting", description: "argStrategyOrSetting", required: true },
+            { name: "instrument", description: "argInstrument", default: "BTC-USDT-SWAP" },
+            { name: "days | range", description: "argWindow30", default: "30" }
+        ]
+    },
+    {
+        name: "optimize",
+        summary: "cmdOptimize",
+        usage: "/optimize <file.py | report> [instrument] [days | range] [space.json] [budget]",
+        detail: "cmdOptimizeDetail",
+        args: [
+            { name: "file.py | report", description: "argStrategyOrReport", required: true },
+            { name: "instrument", description: "argInstrument", default: "BTC-USDT-SWAP" },
+            { name: "days | range", description: "argWindow90", default: "90" },
+            { name: "space.json", description: "argSpaceFile", default: "space.json" },
+            { name: "budget", description: "argBudget", default: "100" }
+        ]
+    },
+    {
+        name: "compare",
+        summary: "cmdCompare",
+        usage: "/compare <runId> <runId> [runId...] [--no-open]",
+        detail: "cmdCompareDetail",
+        args: [
+            { name: "runId runId ...", description: "argRunsToCompare", required: true },
+            { name: "--no-open", description: "argNoOpen", required: false }
+        ]
+    },
+    {
+        name: "live",
+        summary: "cmdLive",
+        usage: "/live [signals <id> | stop <id>]",
+        detail: "cmdLiveDetail",
+        args: [
+            { name: "signals | stop", description: "argLiveAction", required: false },
+            { name: "id", description: "argLiveProfileId", required: false }
+        ]
+    },
+    {
+        name: "market",
+        summary: "cmdMarket",
+        usage: "/market [demo|live]",
+        detail: "cmdMarketDetail",
+        args: [{ name: "demo | live", description: "argMarketEnv", required: false }]
+    },
+    {
+        name: "settings",
+        summary: "cmdSettings",
+        usage: "/settings",
+        detail: "cmdSettingsDetail"
+    },
+    {
+        name: "coverage",
+        summary: "cmdCoverage",
+        usage: "/coverage <instrument>",
+        args: [{ name: "instrument", description: "argInstrument", default: "BTC-USDT-SWAP" }],
+        detail: "cmdCoverageDetail"
+    },
+    {
+        name: "delete",
+        summary: "cmdDelete",
+        usage: "/delete <runId>",
+        args: [{ name: "runId", description: "argRunToDelete", required: true }],
+        detail: "cmdDeleteDetail"
+    },
+    {
+        name: "runs",
+        summary: "cmdRuns",
+        usage: "/runs [limit]",
+        args: [{ name: "limit", description: "argRowLimit", default: "10" }]
+    },
+    {
+        name: "report",
+        summary: "cmdReport",
+        usage: "/report <runId>",
+        args: [
+            { name: "runId", description: "argRunToOpen", required: true },
+            { name: "--no-open", description: "argNoOpen", required: false }
+        ]
+    },
+    {
+        name: "cancel",
+        summary: "cmdCancel",
+        usage: "/cancel <runId>",
+        args: [{ name: "runId", description: "argRunToCancel", required: true }]
+    },
+    {
+        name: "env",
+        summary: "cmdEnv",
+        usage: "/env [setup]",
+        args: [{ name: "setup", description: "argEnvSetup", required: false }]
+    },
+    {
+        name: "status",
+        summary: "cmdStatus",
+        usage: "/status"
+    },
+    {
+        name: "lang",
+        summary: "cmdLang",
+        usage: "/lang [en|zh]",
+        detail: "cmdLangDetail",
+        args: [{ name: "locale", description: "argLocale", required: false }]
+    },
+    {
+        name: "clear",
+        summary: "cmdClear",
+        usage: "/clear",
+        detail: "cmdClearDetail"
+    },
+    {
+        name: "exit",
+        summary: "cmdExit",
+        usage: "/exit"
+    }
+];
+/**
+ * Parses one input line.
+ *
+ * A bare word with no slash is treated as a command too: typing `data` is a
+ * natural mistake and refusing it teaches nothing.
+ */
+export function parseCommand(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return null;
+    const body = trimmed.startsWith("/") ? trimmed.slice(1) : trimmed;
+    const parts = body.split(/\s+/).filter(Boolean);
+    const name = (parts.shift() ?? "").toLowerCase();
+    if (!name)
+        return null;
+    return { name, args: parts, known: COMMANDS.some((command) => command.name === name) };
+}
+/** Commands whose name starts with the partial token after `/`. */
+export function completions(input) {
+    const trimmed = input.trimStart();
+    if (!trimmed.startsWith("/"))
+        return [];
+    const body = trimmed.slice(1);
+    // Once an argument is being typed, the command itself is settled.
+    if (/\s/.test(body))
+        return [];
+    const lower = body.toLowerCase();
+    return COMMANDS.filter((command) => command.name.startsWith(lower));
+}
+export function commandByName(name) {
+    return COMMANDS.find((command) => command.name === name.toLowerCase());
+}
+export function formatCommandList() {
+    const width = Math.max(...COMMANDS.map((command) => command.usage.length));
+    return COMMANDS.map((command) => `  ${command.usage.padEnd(width)}  ${commandSummary(command)}`).join("\n");
+}
+export function formatCommandDetail(spec) {
+    const lines = [`  ${spec.usage}`, `  ${commandSummary(spec)}`];
+    if (spec.args?.length) {
+        lines.push("");
+        // Padded by display width, not length: a Chinese description is twice as wide
+        // per character and would push the notes out of column.
+        const width = Math.max(...spec.args.map((argument) => displayWidth(argument.name)));
+        for (const argument of spec.args) {
+            lines.push(`  ${padEndDisplay(argument.name, width)}  ${argumentDescription(argument)}  (${note(argument)})`);
+        }
+    }
+    const detail = commandDetail(spec);
+    if (detail)
+        lines.push("", `  ${detail}`);
+    return lines.join("\n");
+}
+function note(argument) {
+    const text = activeMessages();
+    if (argument.required)
+        return text.argRequired;
+    return argument.default ? text.argDefault(argument.default) : text.argOptional;
+}
+/**
+ * Which positional argument the caret is currently on.
+ *
+ * Counts the words after the command name; a trailing space means the next
+ * argument has been started.
+ */
+export function argumentIndex(input) {
+    const body = input.trimStart().replace(/^\//, "");
+    const parts = body.split(/\s+/).filter(Boolean);
+    if (parts.length === 0)
+        return -1;
+    return /\s$/.test(input) ? parts.length - 1 : parts.length - 2;
+}
+/**
+ * Inline hint for a recognized command.
+ *
+ * Shown as soon as the command name is settled, so a multi-argument command does
+ * not require reading `/help` first. The active argument is marked, which is the
+ * part a usage string alone cannot convey.
+ */
+export function argumentHint(input) {
+    const parsed = parseCommand(input);
+    if (!parsed?.known)
+        return null;
+    const spec = commandByName(parsed.name);
+    if (!spec?.args?.length)
+        return null;
+    // Wait for a space: before that the user may still be choosing a command.
+    if (!/\s/.test(input))
+        return null;
+    const active = argumentIndex(input);
+    const lines = spec.args.map((argument, index) => {
+        const marker = index === active ? "\u25b8" : " ";
+        return `${marker} ${argument.name}  ${argumentDescription(argument)}  (${note(argument)})`;
+    });
+    return { usage: spec.usage, lines };
+}
+/** Suggests the closest command for an unrecognized name. */
+export function suggest(name) {
+    const scored = COMMANDS.map((command) => ({ name: command.name, distance: distance(name, command.name) }))
+        .filter((entry) => entry.distance <= 2)
+        .sort((left, right) => left.distance - right.distance);
+    return scored[0]?.name;
+}
+function distance(left, right) {
+    const rows = left.length + 1;
+    const columns = right.length + 1;
+    const matrix = Array.from({ length: rows }, (_, row) => Array.from({ length: columns }, (_, column) => (row === 0 ? column : column === 0 ? row : 0)));
+    for (let row = 1; row < rows; row += 1) {
+        for (let column = 1; column < columns; column += 1) {
+            const cost = left[row - 1] === right[column - 1] ? 0 : 1;
+            matrix[row][column] = Math.min(matrix[row - 1][column] + 1, matrix[row][column - 1] + 1, matrix[row - 1][column - 1] + cost);
+        }
+    }
+    return matrix[rows - 1][columns - 1];
+}
+//# sourceMappingURL=commands.js.map

package/dist/tui/commands.js.map

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

package/dist/tui/entries.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Transcript entries.
+ *
+ * Once written, an entry never changes: the shell renders history through Ink's
+ * `<Static>`, which writes each line to stdout exactly once so output scrolls
+ * like ordinary command output and survives in the terminal's scrollback.
+ */
+export type EntryKind = "input" | "output" | "success" | "error" | "note";
+export interface Entry {
+    id: number;
+    kind: EntryKind;
+    text: string;
+}
+export declare function entry(kind: EntryKind, text: string): Entry;
+export declare function resetEntryIds(): void;
+/** Colour per entry kind, matching Ink's colour names. */
+export declare function entryColor(kind: EntryKind): string | undefined;

package/dist/tui/entries.js

@@ -0,0 +1,24 @@
+let sequence = 0;
+export function entry(kind, text) {
+    sequence += 1;
+    return { id: sequence, kind, text };
+}
+export function resetEntryIds() {
+    sequence = 0;
+}
+/** Colour per entry kind, matching Ink's colour names. */
+export function entryColor(kind) {
+    switch (kind) {
+        case "input":
+            return "cyan";
+        case "success":
+            return "green";
+        case "error":
+            return "red";
+        case "note":
+            return "gray";
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=entries.js.map

package/dist/tui/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../src/tui/entries.ts"],"names":[],"mappings":"AAeA,IAAI,QAAQ,GAAG,CAAC,CAAC;AAEjB,MAAM,UAAU,KAAK,CAAC,IAAe,EAAE,IAAY;IACjD,QAAQ,IAAI,CAAC,CAAC;IACd,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,QAAQ,GAAG,CAAC,CAAC;AACf,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,IAAe;IACxC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,MAAM,CAAC;QAChB,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC;QACjB,KAAK,OAAO;YACV,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/tui/execute.d.ts

@@ -0,0 +1,26 @@
+import type { RuntimeClient } from "../runtime/client.js";
+import { type Entry } from "./entries.js";
+import type { ProgressState } from "./progress.js";
+export interface ExecuteContext {
+    client: RuntimeClient;
+    /** Test seam: which config file `/market` reads and writes. */
+    configPath?: string;
+    /** Reports a line to display in the live activity area while working. */
+    onActivity: (line: string | null) => void;
+    /** Reports measurable progress, which is drawn as a bar instead of a spinner. */
+    onProgress?: (progress: ProgressState | null) => void;
+    /** Resolves when the run should stop waiting, used for cancellation. */
+    signal?: AbortSignal;
+}
+export interface ExecuteResult {
+    entries: Entry[];
+    /** Set when the command asks the shell to do something beyond printing. */
+    effect?: "clear" | "exit";
+}
+/**
+ * Runs one parsed command and returns the entries to append.
+ *
+ * Every command returns text rather than rendering: the shell owns presentation,
+ * and this stays testable without a terminal.
+ */
+export declare function execute(name: string, args: string[], context: ExecuteContext): Promise<ExecuteResult>;