desic-okx-agent 0.2.1 → 0.3.0

package/dist/core/okx-client.js

@@ -3,7 +3,7 @@ import { ProxyAgent } from "undici";
 import { applyOrderAttribution } from "./attribution.js";
 import { classifyOkxError, RuntimeError } from "./errors.js";
 import { sanitizeValue } from "./sanitize.js";
-import { OKX_REST_BASE_URL } from "../network/connectivity.js";
+import { OKX_REST_BASE_URL, environmentHeaders } from "../network/connectivity.js";
 export class OkxClient {
     baseUrl;
     timeOffsetMs = 0;
@@ -12,8 +12,16 @@ export class OkxClient {
         this.baseUrl = baseUrl;
         this.dispatcher = proxyUrl ? new ProxyAgent(proxyUrl) : undefined;
     }
-    async publicGet(path, query) {
-        return this.request("GET", path, { query });
+    /**
+     * Reads a public endpoint.
+     *
+     * `headers` exists so a caller can select the demo environment with
+     * `x-simulated-trading`. Public market data differs between environments — demo is
+     * a separate matching venue — so backfilling history without it would mix live
+     * bars into a demo store.
+     */
+    async publicGet(path, query, headers) {
+        return this.request("GET", path, { query, headers });
     }
     async privateGet(path, account, query, headers) {
         return this.request("GET", path, { query, account, headers });
@@ -81,8 +89,9 @@ export class OkxClient {
         headers["OK-ACCESS-SIGN"] = signature;
         headers["OK-ACCESS-TIMESTAMP"] = timestamp;
         headers["OK-ACCESS-PASSPHRASE"] = account.passphrase;
-        if (account.environment === "demo")
-            headers["x-simulated-trading"] = "1";
+        // Every private call routes through here, so demo selection cannot be missed on
+        // an individual endpoint.
+        Object.assign(headers, environmentHeaders(account.environment));
     }
 }
 function buildQuery(query) {

package/dist/core/okx-client.js.map

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

package/dist/i18n/locale.d.ts

@@ -0,0 +1,24 @@
+import { type Locale, type Messages } from "./messages.js";
+declare const LOCALE_PATH: string;
+/**
+ * Resolves the active locale.
+ *
+ * Order: the saved preference, then the environment, then English. An explicit
+ * choice always wins over an ambient one, because a user who picked a language
+ * should not have it changed by a shell variable.
+ */
+export declare function activeLocale(): Locale;
+export declare function activeMessages(): Messages;
+export declare function savedLocale(): Locale | undefined;
+export declare function saveLocale(locale: Locale): void;
+/** Test seam: forgets the cached value so a changed file is re-read. */
+export declare function resetLocaleCache(): void;
+/**
+ * Pins the locale for this process without writing to disk.
+ *
+ * Tests must pin it: otherwise assertions on user-facing text pass or fail
+ * depending on the developer's `LANG`, and a suite that green on one machine
+ * fails on another for no real reason.
+ */
+export declare function useLocale(locale: Locale): void;
+export { LOCALE_PATH };

package/dist/i18n/locale.js

@@ -0,0 +1,65 @@
+import fs from "node:fs";
+import path from "node:path";
+import { CONFIG_DIR } from "../config/paths.js";
+import { isLocale, messages } from "./messages.js";
+const LOCALE_PATH = path.join(CONFIG_DIR, "locale.json");
+let cached;
+/**
+ * Resolves the active locale.
+ *
+ * Order: the saved preference, then the environment, then English. An explicit
+ * choice always wins over an ambient one, because a user who picked a language
+ * should not have it changed by a shell variable.
+ */
+export function activeLocale() {
+    if (cached)
+        return cached;
+    cached = savedLocale() ?? environmentLocale() ?? "en";
+    return cached;
+}
+export function activeMessages() {
+    return messages(activeLocale());
+}
+export function savedLocale() {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(LOCALE_PATH, "utf8"));
+        const value = String(parsed.locale ?? "");
+        return isLocale(value) ? value : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function saveLocale(locale) {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(LOCALE_PATH, `${JSON.stringify({ locale }, null, 2)}\n`, { mode: 0o600 });
+    cached = locale;
+}
+/** Reads `LC_ALL`, `LC_MESSAGES`, or `LANG`, mapping any Chinese variant to `zh`. */
+function environmentLocale() {
+    const raw = process.env.LC_ALL || process.env.LC_MESSAGES || process.env.LANG || "";
+    const lower = raw.toLowerCase();
+    if (!lower)
+        return undefined;
+    if (lower.startsWith("zh"))
+        return "zh";
+    if (lower.startsWith("en"))
+        return "en";
+    return undefined;
+}
+/** Test seam: forgets the cached value so a changed file is re-read. */
+export function resetLocaleCache() {
+    cached = undefined;
+}
+/**
+ * Pins the locale for this process without writing to disk.
+ *
+ * Tests must pin it: otherwise assertions on user-facing text pass or fail
+ * depending on the developer's `LANG`, and a suite that green on one machine
+ * fails on another for no real reason.
+ */
+export function useLocale(locale) {
+    cached = locale;
+}
+export { LOCALE_PATH };
+//# sourceMappingURL=locale.js.map

package/dist/i18n/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/i18n/locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAA8B,MAAM,eAAe,CAAC;AAE/E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;AAEzD,IAAI,MAA0B,CAAC;AAE/B;;;;;;GAMG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,GAAG,WAAW,EAAE,IAAI,iBAAiB,EAAE,IAAI,IAAI,CAAC;IACtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAyB,CAAC;QACxF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3F,MAAM,GAAG,MAAM,CAAC;AAClB,CAAC;AAED,qFAAqF;AACrF,SAAS,iBAAiB;IACxB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACpF,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACtC,MAAM,GAAG,MAAM,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/i18n/messages.d.ts

@@ -0,0 +1,333 @@
+/**
+ * User-facing strings for the CLI and shell.
+ *
+ * Only presentation is translated. Tool names, field names, run ids, and error
+ * codes stay in English so a copied message still matches the API and the
+ * documentation, and so a bug report reads the same in any locale.
+ */
+export declare const LOCALES: readonly ["en", "zh"];
+export type Locale = (typeof LOCALES)[number];
+export declare function isLocale(value: string): value is Locale;
+export interface Messages {
+    bannerTitle: string;
+    bannerHints: string;
+    clearHint: string;
+    exitHint: string;
+    pythonNotFound: string;
+    instrumentsWithHistory: (count: number) => string;
+    working: string;
+    cancelHint: string;
+    argumentsAsked: string;
+    unknownCommand: (name: string) => string;
+    didYouMean: (name: string) => string;
+    seeHelp: string;
+    noCommandNamed: (name: string) => string;
+    needsTerminal: string;
+    needsUiPackages: string;
+    noLocalHistory: string;
+    tryDownload: string;
+    readingCoverage: string;
+    requestingHistory: (instId: string, days: number) => string;
+    daysMustBePositive: string;
+    instrumentColumn: string;
+    fromColumn: string;
+    toColumn: string;
+    barsColumn: string;
+    gapsColumn: string;
+    gapsNone: string;
+    coverageRange: string;
+    coverageStored: (count: string) => string;
+    coverageMissing: (bars: string, gaps: string) => string;
+    coverageMissingNone: string;
+    coverageUpdated: string;
+    coverageExchangeEnd: string;
+    coverageGaps: string;
+    coverageMore: (count: string) => string;
+    syncRange: string;
+    syncExpected: string;
+    syncElapsed: string;
+    syncNoEarlierData: (time: string) => string;
+    giveFileNew: string;
+    giveFileValidate: string;
+    giveFileBacktest: string;
+    giveRunId: (command: string) => string;
+    unknownTemplate: (name: string, available: string) => string;
+    fileExists: (file: string) => string;
+    fileMissing: (file: string) => string;
+    wroteTemplate: (name: string, file: string) => string;
+    nextValidate: (file: string) => string;
+    validating: (file: string) => string;
+    policyPassed: string;
+    policyViolations: (count: number) => string;
+    violationLine: (line: number, message: string) => string;
+    backtestConfig: (file: string, instId: string, days: number) => string;
+    backtestWindow: (file: string, instId: string, window: string) => string;
+    requestingWindow: (instId: string, window: string) => string;
+    backtestSettings: (equity: string, leverage: number, preload: number) => string;
+    queuing: (instId: string) => string;
+    noRuns: string;
+    runsHint: string;
+    forCurveAndTrades: (runId: string) => string;
+    cancelled: (runId: string) => string;
+    deleteConfirm: (runId: string) => string;
+    deleted: (runId: string) => string;
+    alreadyFinished: (runId: string) => string;
+    statusLabel: string;
+    barsLabel: string;
+    includingPreloaded: (count: string) => string;
+    snapshotLabel: string;
+    etaLabel: string;
+    elapsedLabel: string;
+    errorLabel: string;
+    performance: string;
+    netProfit: string;
+    returnLabel: string;
+    annualized: string;
+    annualizedWithheld: (days: number) => string;
+    maxDrawdown: string;
+    drawdownRecovery: string;
+    riskAdjusted: string;
+    sharpeLabel: string;
+    sortinoLabel: string;
+    calmarLabel: string;
+    activity: string;
+    tradesLabel: string;
+    longShort: (long: number, short: number) => string;
+    winRate: string;
+    profitFactor: string;
+    netOfFees: string;
+    expectancy: string;
+    averageWinLoss: string;
+    largestWinLoss: string;
+    streaks: string;
+    holdingTime: string;
+    costs: string;
+    feesLabel: string;
+    feesOfGross: string;
+    turnover: string;
+    exposure: string;
+    tradesPerDay: string;
+    marginExhaustedWarning: string;
+    marginExhaustedDetail: string;
+    reportOpened: string;
+    reportWritten: string;
+    hoverPrompt: string;
+    hoverTime: string;
+    hoverEquity: string;
+    hoverChange: string;
+    hoverDrawdown: string;
+    settingsTitle: string;
+    settingsHint: string;
+    settingsUnsaved: string;
+    settingsSaved: string;
+    settingsCancelled: string;
+    settingsDefaultIs: string;
+    settingsHeading: string;
+    settingsHintCommand: string;
+    assumptionsHeading: string;
+    settingEquity: string;
+    settingEquityHelp: string;
+    settingLeverage: string;
+    settingLeverageHelp: string;
+    settingMarginSafety: string;
+    settingMarginSafetyHelp: string;
+    settingBudgetPct: string;
+    settingBudgetPctHelp: string;
+    settingBudgetUsdt: string;
+    settingBudgetUsdtHelp: string;
+    settingTakerFee: string;
+    settingTakerFeeHelp: string;
+    settingMakerFee: string;
+    settingMakerFeeHelp: string;
+    settingEntrySlippage: string;
+    settingEntrySlippageHelp: string;
+    settingExitSlippage: string;
+    settingExitSlippageHelp: string;
+    settingPreload: string;
+    settingPreloadHelp: string;
+    settingDays: string;
+    settingDaysHelp: string;
+    settingCloseAtEnd: string;
+    settingCloseAtEndHelp: string;
+    monthlyHeading: string;
+    distributionHeading: string;
+    colSide: string;
+    colQty: string;
+    colEntry: string;
+    colExit: string;
+    colNetPnl: string;
+    colReturn: string;
+    colCumulative: string;
+    colFees: string;
+    colHeld: string;
+    colOpened: string;
+    colClosed: string;
+    colMonth: string;
+    colOpenEquity: string;
+    colCloseEquity: string;
+    colChange: string;
+    colWorstDrop: string;
+    equityHeading: string;
+    tradesHeading: string;
+    noClosedTrades: string;
+    notEnoughPoints: string;
+    simulationNote: string;
+    cmdHelp: string;
+    cmdData: string;
+    cmdDataDetail: string;
+    cmdDownload: string;
+    cmdDownloadDetail: string;
+    cmdNew: string;
+    cmdNewDetail: string;
+    cmdValidate: string;
+    cmdValidateDetail: string;
+    cmdBacktest: string;
+    cmdBacktestDetail: string;
+    cmdOptimize: string;
+    cmdOptimizeDetail: string;
+    cmdCompare: string;
+    cmdCompareDetail: string;
+    cmdLive: string;
+    cmdLiveDetail: string;
+    argLiveAction: string;
+    argLiveProfileId: string;
+    cmdMarket: string;
+    cmdMarketDetail: string;
+    argMarketEnv: string;
+    cmdSettings: string;
+    cmdSettingsDetail: string;
+    cmdCoverage: string;
+    cmdCoverageDetail: string;
+    cmdDelete: string;
+    cmdDeleteDetail: string;
+    cmdRuns: string;
+    cmdReport: string;
+    cmdCancel: string;
+    cmdEnv: string;
+    cmdStatus: string;
+    cmdLang: string;
+    cmdLangDetail: string;
+    cmdClear: string;
+    cmdClearDetail: string;
+    cmdExit: string;
+    argHelpCommand: string;
+    argInstrument: string;
+    argWindow30: string;
+    argWindow90: string;
+    argDestinationFile: string;
+    argTemplate: string;
+    argStrategyToCheck: string;
+    argStrategyOrSetting: string;
+    argStrategyOrReport: string;
+    argSpaceFile: string;
+    argBudget: string;
+    argRunsToCompare: string;
+    argNoOpen: string;
+    argRunToDelete: string;
+    argRowLimit: string;
+    argRunToOpen: string;
+    argRunToCancel: string;
+    argEnvSetup: string;
+    argLocale: string;
+    argRequired: string;
+    argOptional: string;
+    argDefault: (value: string) => string;
+    agentAccessState: (state: string) => string;
+    agentAccessSet: (state: string) => string;
+    agentAccessRestart: string;
+    agentAccessWarning: string;
+    agentAccessUsage: string;
+    liveNoProfiles: string;
+    liveCreateHint: string;
+    liveNameColumn: string;
+    liveBudgetColumn: string;
+    liveErrorColumn: string;
+    liveEnabled: string;
+    liveStopped: string;
+    liveReady: string;
+    liveNotReady: (count: number) => string;
+    liveEvidence: (runId: string) => string;
+    liveRealMoneyWarning: string;
+    liveNoSignals: string;
+    liveCutoffColumn: string;
+    liveActionColumn: string;
+    liveDetailColumn: string;
+    liveQtyColumn: string;
+    liveProfileCreated: (id: string) => string;
+    liveProfileStarted: (name: string) => string;
+    liveProfileStopped: (name: string) => string;
+    liveDeleteConfirm: (id: string) => string;
+    marketEnvironmentLabel: string;
+    marketEnvironmentDemo: string;
+    marketEnvironmentLive: string;
+    demoDataWarning: string;
+    environmentSwitched: (env: string) => string;
+    environmentAlready: (env: string) => string;
+    environmentRestartHint: string;
+    environmentUsage: string;
+    environmentUsageShell: string;
+    warnDifferentData: string;
+    warnDifferentInstruments: (list: string) => string;
+    warnDifferentWindows: string;
+    warnDifferentAssumptions: (keys: string) => string;
+    warnIncompleteRuns: (list: string) => string;
+    strategyColumn: string;
+    differingAssumptionsHeading: string;
+    assumptionsIdentical: string;
+    sharedAssumptionsNote: (count: string) => string;
+    compareNormalizedNote: string;
+    compareNeedsTwo: string;
+    compareTooMany: (limit: number) => string;
+    comparisonHeading: string;
+    comparedRunsHeading: string;
+    normalizedEquityHeading: string;
+    spaceLabel: string;
+    candidatesLabel: string;
+    candidatesOf: (done: string, budget: string, combinations: string) => string;
+    candidatesFailed: (count: string) => string;
+    trainLabel: string;
+    validationLabel: string;
+    trainReturn: string;
+    validationReturn: string;
+    trainDrawdown: string;
+    validationDrawdown: string;
+    verdictColumn: string;
+    verdictHolds: string;
+    verdictOverfit: string;
+    verdictWeak: string;
+    verdictUnexplained: string;
+    overfitNote: string;
+    selectionNote: string;
+    noCandidatesYet: string;
+    giveFileOptimize: string;
+    giveSpaceFile: string;
+    spaceFileMissing: (file: string) => string;
+    spaceFileInvalid: (file: string) => string;
+    optimizeWindow: (file: string, instId: string, window: string) => string;
+    optimizeSearch: (candidates: string, combinations: string) => string;
+    forCandidateTable: (runId: string) => string;
+    adoptedParams: (file: string) => string;
+    adoptHint: (runId: string) => string;
+    noBestCandidate: string;
+    pythonLabel: string;
+    readyLabel: string;
+    notFound: string;
+    yes: string;
+    no: string;
+    fixLabel: string;
+    checkingEnvironment: string;
+    preparingEnvironment: string;
+    environmentReady: string;
+    runtimeLabel: string;
+    publicWs: string;
+    businessWs: string;
+    subscribed: (count: number) => string;
+    databaseLabel: string;
+    readingStatus: string;
+    readingRuns: string;
+    readingRun: (runId: string) => string;
+    languageChanged: (locale: string) => string;
+    languageCurrent: (locale: string) => string;
+    languageUsage: string;
+}
+export declare function messages(locale: Locale): Messages;