@tradejs/node 1.0.5 → 1.0.8

package/dist/ai.js

@@ -0,0 +1,1074 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/ai.ts
+var ai_exports = {};
+__export(ai_exports, {
+  DEFAULT_AI_MODEL: () => DEFAULT_AI_MODEL,
+  MAX_AI_SERIES_POINTS: () => MAX_AI_SERIES_POINTS,
+  askAI: () => askAI,
+  buildAiHumanPrompt: () => buildAiHumanPrompt,
+  buildAiPayload: () => buildAiPayload,
+  buildAiPrompts: () => buildAiPrompts,
+  buildAiSystemPrompt: () => buildAiSystemPrompt,
+  ensureAiStrategyPluginsLoaded: () => ensureAiStrategyPluginsLoaded,
+  getDeterministicAiGateContext: () => getDeterministicAiGateContext,
+  getOpenRouterModelKwargs: () => getOpenRouterModelKwargs,
+  resetAiRuntimeCache: () => resetAiRuntimeCache,
+  runAiPrompt: () => runAiPrompt,
+  runAiPromptLocal: () => runAiPromptLocal,
+  trimSeriesDeep: () => trimSeriesDeep
+});
+module.exports = __toCommonJS(ai_exports);
+var import_aiLanguages = require("@tradejs/infra/aiLanguages");
+var import_redis = require("@tradejs/infra/redis");
+var import_userSettings = require("@tradejs/infra/userSettings");
+
+// src/aiShared.ts
+var MAX_AI_SERIES_POINTS = 5;
+var trimSeriesDeep = (value) => {
+  if (Array.isArray(value)) {
+    const trimmed = value.slice(-MAX_AI_SERIES_POINTS);
+    const isMatrix = trimmed.every((item) => Array.isArray(item));
+    if (isMatrix) {
+      return trimmed;
+    }
+    return trimmed.map(
+      (item) => item && typeof item === "object" ? trimSeriesDeep(item) : item
+    );
+  }
+  if (value && typeof value === "object") {
+    return Object.fromEntries(
+      Object.entries(value).map(([key, nested]) => [
+        key,
+        trimSeriesDeep(nested)
+      ])
+    );
+  }
+  return value;
+};
+
+// src/aiMarketContext.ts
+var SESSION_WINDOWS = [
+  { name: "asia", startMinuteUtc: 0, endMinuteUtc: 8 * 60 },
+  { name: "europe", startMinuteUtc: 7 * 60, endMinuteUtc: 16 * 60 },
+  { name: "us", startMinuteUtc: 13 * 60, endMinuteUtc: 22 * 60 }
+];
+var toRecord = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value;
+};
+var toFiniteNumber = (value) => {
+  const numeric = typeof value === "number" ? value : typeof value === "string" && value.trim() ? Number(value) : Number.NaN;
+  return Number.isFinite(numeric) ? numeric : null;
+};
+var getLastFiniteNumber = (value) => {
+  const numeric = toFiniteNumber(value);
+  if (numeric != null) {
+    return numeric;
+  }
+  if (!Array.isArray(value)) {
+    return null;
+  }
+  for (let i = value.length - 1; i >= 0; i -= 1) {
+    const nested = getLastFiniteNumber(value[i]);
+    if (nested != null) {
+      return nested;
+    }
+  }
+  return null;
+};
+var roundTo = (value, decimals) => {
+  const factor = 10 ** decimals;
+  return Math.round(value * factor) / factor;
+};
+var isInsideSession = (minuteUtc, startMinuteUtc, endMinuteUtc) => startMinuteUtc <= endMinuteUtc ? minuteUtc >= startMinuteUtc && minuteUtc < endMinuteUtc : minuteUtc >= startMinuteUtc || minuteUtc < endMinuteUtc;
+var buildTradingSessionContext = (timestamp) => {
+  const date = new Date(timestamp);
+  const utcHour = date.getUTCHours();
+  const utcMinute = date.getUTCMinutes();
+  const minuteUtc = utcHour * 60 + utcMinute;
+  const activeSessions = SESSION_WINDOWS.filter(
+    (session) => isInsideSession(minuteUtc, session.startMinuteUtc, session.endMinuteUtc)
+  ).map((session) => session.name);
+  const primarySession = activeSessions.includes("us") ? "us" : activeSessions.includes("europe") ? "europe" : activeSessions.includes("asia") ? "asia" : "off_hours";
+  return {
+    timezone: "UTC",
+    utcHour,
+    utcMinute,
+    primarySession,
+    activeSessions,
+    isOverlap: activeSessions.length > 1,
+    overlap: activeSessions.length > 1 ? `${activeSessions.join("_")}_overlap` : null
+  };
+};
+var buildMissingSpreadContext = () => ({
+  source: "binance_coinbase_btc",
+  indicatorKey: "payload.indicators.spread",
+  available: false,
+  value: null,
+  bps: null,
+  absBps: null,
+  bias: null,
+  severity: null
+});
+var buildSpreadContextFromValue = (spread) => {
+  const value = roundTo(spread, 8);
+  const bps = roundTo(value * 1e4, 2);
+  const absBps = Math.abs(bps);
+  const bias = Math.abs(bps) < 1 ? "flat" : bps > 0 ? "coinbase_premium" : "binance_premium";
+  const severity = absBps >= 20 ? "wide" : absBps >= 5 ? "elevated" : "normal";
+  return {
+    source: "binance_coinbase_btc",
+    indicatorKey: "payload.indicators.spread",
+    available: true,
+    value,
+    bps,
+    absBps,
+    bias,
+    severity
+  };
+};
+var readSpreadFromSignal = (signal) => {
+  const indicatorSpread = getLastFiniteNumber(signal.indicators?.spread);
+  if (indicatorSpread != null) {
+    return indicatorSpread;
+  }
+  return getLastFiniteNumber(signal.additionalIndicators?.spread);
+};
+var buildAiMarketContext = (signal) => {
+  const existingMarketContext = toRecord(
+    signal.additionalIndicators?.marketContext
+  );
+  const existingSpread = toRecord(existingMarketContext?.binanceCoinbaseSpread);
+  const spread = readSpreadFromSignal(signal);
+  return {
+    ...existingMarketContext ?? {},
+    tradingSession: buildTradingSessionContext(signal.timestamp),
+    binanceCoinbaseSpread: spread != null ? buildSpreadContextFromValue(spread) : existingSpread ?? buildMissingSpreadContext()
+  };
+};
+
+// src/strategy/manifests.ts
+var import_indicators = require("@tradejs/core/indicators");
+var import_logger2 = require("@tradejs/infra/logger");
+
+// src/tradejsConfig.ts
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var import_module = require("module");
+var import_url = require("url");
+var import_config = require("@tradejs/core/config");
+var import_logger = require("@tradejs/infra/logger");
+var CONFIG_FILE_NAMES = [
+  "tradejs.config.ts",
+  "tradejs.config.mts",
+  "tradejs.config.js",
+  "tradejs.config.mjs",
+  "tradejs.config.cjs"
+];
+var TS_MODULE_RE = /\.(cts|mts|ts)$/i;
+var cachedByCwd = /* @__PURE__ */ new Map();
+var announcedConfigFile = /* @__PURE__ */ new Set();
+var tsNodeRegistered = false;
+var tsconfigPathsRegisteredByCwd = /* @__PURE__ */ new Set();
+var getTradejsProjectCwd = (cwd) => {
+  const explicit = String(cwd ?? "").trim();
+  if (explicit) {
+    return import_path.default.resolve(explicit);
+  }
+  const fromEnv = String(process.env.PROJECT_CWD || "").trim();
+  if (fromEnv) {
+    return import_path.default.resolve(fromEnv);
+  }
+  return process.cwd();
+};
+var normalizeConfig = (rawConfig) => {
+  if (!rawConfig || typeof rawConfig !== "object") {
+    return {};
+  }
+  const config = rawConfig;
+  const strategies2 = Array.isArray(config.strategies) ? config.strategies.map((value) => String(value || "").trim()).filter(Boolean) : [];
+  const indicators = Array.isArray(config.indicators) ? config.indicators.map((value) => String(value || "").trim()).filter(Boolean) : [];
+  const connectors = Array.isArray(config.connectors) ? config.connectors.map((value) => String(value || "").trim()).filter(Boolean) : [];
+  const hooks = (0, import_config.normalizeTradejsConfigHooks)(
+    config.hooks
+  );
+  return {
+    strategies: strategies2,
+    indicators,
+    connectors,
+    ...hooks ? { hooks } : {}
+  };
+};
+var getRequireFn = (cwd = getTradejsProjectCwd()) => (0, import_module.createRequire)(import_path.default.join(import_path.default.resolve(cwd), "__tradejs_loader__.js"));
+var ensureTsNodeRegistered = async () => {
+  if (tsNodeRegistered) {
+    return;
+  }
+  const tsNodeModule = await import("ts-node");
+  const tsNode = tsNodeModule.default ?? tsNodeModule;
+  tsNode.register?.({
+    transpileOnly: true,
+    compilerOptions: {
+      module: "commonjs",
+      moduleResolution: "node"
+    }
+  });
+  tsNodeRegistered = true;
+};
+var ensureTsconfigPathsRegistered = async (cwd = getTradejsProjectCwd()) => {
+  const projectRoot = getTradejsProjectCwd(cwd);
+  if (tsconfigPathsRegisteredByCwd.has(projectRoot)) {
+    return;
+  }
+  const tsconfigPathsModule = await import("tsconfig-paths");
+  const loadConfig = tsconfigPathsModule.loadConfig;
+  const register = tsconfigPathsModule.register;
+  if (typeof loadConfig !== "function" || typeof register !== "function") {
+    return;
+  }
+  const loadedConfig = loadConfig(projectRoot);
+  if (loadedConfig.resultType !== "success") {
+    return;
+  }
+  register({
+    baseUrl: loadedConfig.absoluteBaseUrl,
+    paths: loadedConfig.paths,
+    addMatchAll: false
+  });
+  tsconfigPathsRegisteredByCwd.add(projectRoot);
+};
+var toImportSpecifier = (moduleName) => {
+  if (moduleName.startsWith("file://")) {
+    return moduleName;
+  }
+  if (import_path.default.isAbsolute(moduleName)) {
+    return (0, import_url.pathToFileURL)(moduleName).href;
+  }
+  return moduleName;
+};
+var isTsModulePath = (moduleName) => TS_MODULE_RE.test(moduleName.split("?")[0]);
+var isRelativeModulePath = (moduleName) => moduleName.startsWith("./") || moduleName.startsWith("../");
+var isBareModuleSpecifier = (moduleName) => {
+  const normalized = String(moduleName ?? "").trim();
+  if (!normalized) {
+    return false;
+  }
+  if (normalized.startsWith("file://") || import_path.default.isAbsolute(normalized) || isRelativeModulePath(normalized)) {
+    return false;
+  }
+  return true;
+};
+var importConfigFile = async (configFilePath) => {
+  const ext = import_path.default.extname(configFilePath).toLowerCase();
+  const configFileUrl = `${toImportSpecifier(configFilePath)}?t=${Date.now()}`;
+  if (ext === ".ts" || ext === ".mts") {
+    const requireFn = getRequireFn(import_path.default.dirname(configFilePath));
+    await ensureTsNodeRegistered();
+    await ensureTsconfigPathsRegistered(import_path.default.dirname(configFilePath));
+    return requireFn(configFilePath);
+  }
+  return import(
+    /* webpackIgnore: true */
+    configFileUrl
+  );
+};
+var importTradejsModule = async (moduleName, cwd = getTradejsProjectCwd()) => {
+  const normalized = String(moduleName ?? "").trim();
+  if (!normalized) {
+    return {};
+  }
+  let modulePath = normalized;
+  if (normalized.startsWith("file://")) {
+    try {
+      modulePath = (0, import_url.fileURLToPath)(normalized);
+    } catch {
+      modulePath = normalized;
+    }
+  }
+  const requireFn = getRequireFn(
+    import_path.default.isAbsolute(modulePath) ? import_path.default.dirname(modulePath) : cwd
+  );
+  if (isTsModulePath(modulePath)) {
+    await ensureTsNodeRegistered();
+    await ensureTsconfigPathsRegistered(cwd);
+    return requireFn(modulePath);
+  }
+  if (isBareModuleSpecifier(normalized)) {
+    await ensureTsconfigPathsRegistered(cwd);
+    return requireFn(normalized);
+  }
+  try {
+    return await import(
+      /* webpackIgnore: true */
+      toImportSpecifier(normalized)
+    );
+  } catch (error) {
+    if (isTsModulePath(modulePath)) {
+      await ensureTsNodeRegistered();
+      await ensureTsconfigPathsRegistered(cwd);
+      return requireFn(modulePath);
+    }
+    throw error;
+  }
+};
+var resolveExportedConfig = (moduleExports) => {
+  const candidate = moduleExports && typeof moduleExports === "object" && "default" in moduleExports ? moduleExports.default : moduleExports;
+  return normalizeConfig(candidate);
+};
+var findConfigFilePath = (cwd) => {
+  let currentDir = import_path.default.resolve(cwd);
+  while (true) {
+    for (const fileName of CONFIG_FILE_NAMES) {
+      const fullPath = import_path.default.join(currentDir, fileName);
+      if (import_fs.default.existsSync(fullPath) && import_fs.default.statSync(fullPath).isFile()) {
+        return fullPath;
+      }
+    }
+    const parentDir = import_path.default.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+    currentDir = parentDir;
+  }
+};
+var resolvePluginModuleSpecifier = (moduleName, cwd = getTradejsProjectCwd()) => {
+  const normalized = String(moduleName ?? "").trim();
+  if (!normalized) {
+    return "";
+  }
+  if (normalized.startsWith("file://")) {
+    try {
+      return (0, import_url.fileURLToPath)(normalized);
+    } catch {
+      return normalized;
+    }
+  }
+  if (import_path.default.isAbsolute(normalized)) {
+    return normalized;
+  }
+  if (isRelativeModulePath(normalized)) {
+    return import_path.default.resolve(cwd, normalized);
+  }
+  return normalized;
+};
+var loadTradejsConfig = async (cwd = getTradejsProjectCwd()) => {
+  const cached = cachedByCwd.get(cwd);
+  if (cached) {
+    return cached;
+  }
+  const configFilePath = findConfigFilePath(cwd);
+  if (!configFilePath) {
+    cachedByCwd.set(cwd, {});
+    return {};
+  }
+  try {
+    const moduleExports = await importConfigFile(configFilePath);
+    const config = resolveExportedConfig(moduleExports);
+    cachedByCwd.set(cwd, config);
+    if (!announcedConfigFile.has(configFilePath)) {
+      announcedConfigFile.add(configFilePath);
+      import_logger.logger.log("debug", "Loaded TradeJS config: %s", configFilePath);
+    }
+    return config;
+  } catch (error) {
+    import_logger.logger.log(
+      "warn",
+      "Failed to load TradeJS config from %s: %s",
+      configFilePath,
+      String(error)
+    );
+    cachedByCwd.set(cwd, {});
+    return {};
+  }
+};
+
+// src/strategy/manifests.ts
+var createStrategyRegistryState = () => ({
+  strategyCreators: /* @__PURE__ */ new Map(),
+  strategyManifestsMap: /* @__PURE__ */ new Map(),
+  pluginsLoadPromise: null
+});
+var registryStateByProjectRoot = /* @__PURE__ */ new Map();
+var getStrategyRegistryState = (cwd = getTradejsProjectCwd()) => {
+  const projectRoot = getTradejsProjectCwd(cwd);
+  let state = registryStateByProjectRoot.get(projectRoot);
+  if (!state) {
+    state = createStrategyRegistryState();
+    registryStateByProjectRoot.set(projectRoot, state);
+  }
+  return {
+    projectRoot,
+    state
+  };
+};
+var toUniqueModules = (modules = []) => [
+  ...new Set(modules.map((moduleName) => moduleName.trim()).filter(Boolean))
+];
+var getConfiguredPluginModuleNames = async (cwd = getTradejsProjectCwd()) => {
+  const config = await loadTradejsConfig(cwd);
+  return {
+    strategyModules: toUniqueModules(config.strategies),
+    indicatorModules: toUniqueModules(config.indicators)
+  };
+};
+var extractModuleEntries = (moduleExport, key) => {
+  if (!moduleExport || typeof moduleExport !== "object") {
+    return null;
+  }
+  const candidate = moduleExport;
+  if (Array.isArray(candidate[key])) {
+    return candidate[key];
+  }
+  const defaultExport = candidate.default;
+  if (defaultExport && Array.isArray(defaultExport[key])) {
+    return defaultExport[key];
+  }
+  return null;
+};
+var extractStrategyPluginDefinition = (moduleExport) => {
+  const strategyEntries = extractModuleEntries(
+    moduleExport,
+    "strategyEntries"
+  );
+  return strategyEntries ? { strategyEntries } : null;
+};
+var extractIndicatorPluginDefinition = (moduleExport) => {
+  const indicatorEntries = extractModuleEntries(
+    moduleExport,
+    "indicatorEntries"
+  );
+  return indicatorEntries ? { indicatorEntries } : null;
+};
+var registerEntries = (entries, source, state) => {
+  for (const entry of entries) {
+    const strategyName = entry.manifest?.name;
+    if (!strategyName) {
+      import_logger2.logger.warn("Skip strategy entry without name from %s", source);
+      continue;
+    }
+    if (state.strategyCreators.has(strategyName)) {
+      import_logger2.logger.warn(
+        'Skip duplicate strategy "%s" from %s: already registered',
+        strategyName,
+        source
+      );
+      continue;
+    }
+    state.strategyCreators.set(strategyName, entry.creator);
+    state.strategyManifestsMap.set(strategyName, entry.manifest);
+  }
+};
+var importStrategyPluginModule = async (moduleName, cwd = getTradejsProjectCwd()) => {
+  if (typeof importTradejsModule === "function") {
+    return importTradejsModule(moduleName, cwd);
+  }
+  return import(
+    /* webpackIgnore: true */
+    moduleName
+  );
+};
+var ensureStrategyPluginsLoaded = async (cwd = getTradejsProjectCwd()) => {
+  const { projectRoot, state } = getStrategyRegistryState(cwd);
+  if (!state.pluginsLoadPromise) {
+    (0, import_indicators.resetIndicatorRegistryCache)(projectRoot);
+    state.pluginsLoadPromise = (async () => {
+      const { strategyModules, indicatorModules } = await getConfiguredPluginModuleNames(projectRoot);
+      const strategySet = new Set(strategyModules);
+      const indicatorSet = new Set(indicatorModules);
+      const pluginModuleNames = [
+        .../* @__PURE__ */ new Set([...strategyModules, ...indicatorModules])
+      ];
+      if (!pluginModuleNames.length) {
+        return;
+      }
+      for (const moduleName of pluginModuleNames) {
+        try {
+          const resolvedModuleName = resolvePluginModuleSpecifier(
+            moduleName,
+            projectRoot
+          );
+          const moduleExport = await importStrategyPluginModule(
+            resolvedModuleName,
+            projectRoot
+          );
+          if (strategySet.has(moduleName)) {
+            const pluginDefinition = extractStrategyPluginDefinition(moduleExport);
+            if (!pluginDefinition) {
+              import_logger2.logger.warn(
+                'Skip strategy plugin "%s": export { strategyEntries } is missing',
+                moduleName
+              );
+            } else {
+              registerEntries(
+                pluginDefinition.strategyEntries,
+                moduleName,
+                state
+              );
+            }
+          }
+          if (indicatorSet.has(moduleName)) {
+            const indicatorPluginDefinition = extractIndicatorPluginDefinition(moduleExport);
+            if (!indicatorPluginDefinition) {
+              import_logger2.logger.warn(
+                'Skip indicator plugin "%s": export { indicatorEntries } is missing',
+                moduleName
+              );
+            } else {
+              (0, import_indicators.registerIndicatorEntries)(
+                indicatorPluginDefinition.indicatorEntries,
+                moduleName,
+                projectRoot
+              );
+            }
+          }
+          if (!strategySet.has(moduleName) && !indicatorSet.has(moduleName)) {
+            import_logger2.logger.warn(
+              'Skip plugin "%s": no strategy/indicator sections requested in config',
+              moduleName
+            );
+          }
+        } catch (error) {
+          import_logger2.logger.warn(
+            'Failed to load plugin "%s": %s',
+            moduleName,
+            String(error)
+          );
+        }
+      }
+    })();
+  }
+  await state.pluginsLoadPromise;
+};
+var getStrategyManifest = (name, cwd = getTradejsProjectCwd()) => {
+  if (!name) {
+    return void 0;
+  }
+  const { state } = getStrategyRegistryState(cwd);
+  return state.strategyManifestsMap.get(name);
+};
+var strategies = new Proxy(
+  {},
+  {
+    get: (_target, property) => {
+      if (typeof property !== "string") {
+        return void 0;
+      }
+      return getStrategyRegistryState().state.strategyCreators.get(property);
+    },
+    ownKeys: () => {
+      return [...getStrategyRegistryState().state.strategyCreators.keys()];
+    },
+    getOwnPropertyDescriptor: () => ({
+      enumerable: true,
+      configurable: true
+    })
+  }
+);
+
+// src/strategyAdapters/ai.ts
+var toRecord2 = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return {};
+  }
+  return value;
+};
+var buildBaseAiPayload = (signal) => {
+  const additionalIndicators = {
+    ...toRecord2(signal.additionalIndicators),
+    marketContext: buildAiMarketContext(signal)
+  };
+  return {
+    signal: {
+      symbol: signal.symbol,
+      signalId: signal.signalId,
+      interval: signal.interval,
+      direction: signal.direction,
+      timestamp: signal.timestamp,
+      strategy: signal.strategy,
+      prices: {
+        currentPrice: signal.prices.currentPrice,
+        takeProfitPrice: signal.prices.takeProfitPrice,
+        stopLossPrice: signal.prices.stopLossPrice
+      }
+    },
+    figures: trimSeriesDeep(signal.figures ?? {}),
+    indicators: trimSeriesDeep(signal.indicators),
+    additionalIndicators: trimSeriesDeep(additionalIndicators)
+  };
+};
+var defaultAiAdapter = {};
+var getStrategyAiAdapter = (strategy) => getStrategyManifest(strategy)?.aiAdapter ?? defaultAiAdapter;
+var getSignalAiAdapter = (signal) => getStrategyAiAdapter(signal.strategy);
+var buildAiPayloadByStrategy = (signal) => {
+  const basePayload = buildBaseAiPayload(signal);
+  const adapter = getSignalAiAdapter(signal);
+  return adapter.buildPayload?.({ signal, basePayload }) ?? basePayload;
+};
+var buildAiSystemPromptAddonByStrategy = (signal) => getSignalAiAdapter(signal).buildSystemPromptAddon?.({ signal }) ?? "";
+var buildAiHumanPromptAddonByStrategy = (signal, payload) => getSignalAiAdapter(signal).buildHumanPromptAddon?.({
+  signal,
+  payload
+}) ?? "";
+var postProcessAiAnalysisByStrategy = (signal, analysis, payload = buildAiPayloadByStrategy(signal)) => getSignalAiAdapter(signal).postProcessAnalysis?.({
+  signal,
+  payload,
+  analysis
+}) ?? analysis;
+
+// src/ai.ts
+var parseAIResponse = (input) => {
+  try {
+    if (typeof input === "object" && input !== null) return input;
+    const match = input.match(/\{[\s\S]*\}/);
+    if (!match) throw new Error("JSON block not found");
+    return JSON.parse(match[0]);
+  } catch (err) {
+    console.error("Failed to parse AI response:", err);
+    console.log("Raw AI response:", input);
+    return {};
+  }
+};
+var normalizeResponseContent = (content) => {
+  if (typeof content === "string" || content && typeof content === "object") {
+    if (typeof content !== "object" || !Array.isArray(content)) {
+      return content;
+    }
+  }
+  if (Array.isArray(content)) {
+    const text = content.map((part) => typeof part?.text === "string" ? part.text : "").join("\n").trim();
+    return text;
+  }
+  return String(content ?? "");
+};
+var normalizeAnalysis = (raw) => {
+  const direction = raw?.direction === "LONG" || raw?.direction === "SHORT" ? raw.direction : null;
+  const qualityNum = typeof raw?.quality === "number" ? Math.max(1, Math.min(5, Math.round(raw.quality))) : void 0;
+  const toNumberOrNull = (value) => {
+    if (typeof value === "number" && Number.isFinite(value)) return value;
+    if (typeof value === "string" && value.trim()) {
+      const parsed = Number(value);
+      if (Number.isFinite(parsed)) return parsed;
+    }
+    return null;
+  };
+  const toText = (value) => typeof value === "string" ? value.slice(0, 400) : void 0;
+  return {
+    direction,
+    quality: qualityNum,
+    needRetest: Boolean(raw?.needRetest),
+    retestPrice: toNumberOrNull(raw?.retestPrice),
+    takeProfitPrice: toNumberOrNull(raw?.takeProfitPrice),
+    stopLossPrice: toNumberOrNull(raw?.stopLossPrice),
+    setup: toText(raw?.setup),
+    confirmations: toText(raw?.confirmations),
+    btcContext: toText(raw?.btcContext),
+    retestPlan: toText(raw?.retestPlan),
+    riskLevels: toText(raw?.riskLevels),
+    qualityReason: toText(raw?.qualityReason),
+    triggerInvalidation: toText(raw?.triggerInvalidation),
+    comment: typeof raw?.comment === "string" ? raw.comment.slice(0, 1024) : ""
+  };
+};
+var asRecord = (value) => {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value;
+};
+var getSignalDirection = (signal) => signal.direction === "LONG" || signal.direction === "SHORT" ? signal.direction : null;
+var getDeterministicQuality = (gateContext) => {
+  const deterministicQuality = Number(gateContext?.deterministicQuality);
+  if (Number.isFinite(deterministicQuality)) {
+    return Math.max(1, Math.min(5, Math.round(deterministicQuality)));
+  }
+  const maxAllowedQuality = Number(gateContext?.maxAllowedQuality);
+  if (Number.isFinite(maxAllowedQuality)) {
+    return Math.max(1, Math.min(5, Math.round(maxAllowedQuality)));
+  }
+  return Array.isArray(gateContext?.structuralHardBlockReasons) && gateContext.structuralHardBlockReasons.length > 0 ? 2 : 3;
+};
+var buildAiSystemPrompt = (signal) => `
+You are an internal market-structure classifier for an already computed system signal.
+Analyze the provided JSON containing the trade, candles, indicators (for the coin and BTC across multiple timeframes), and strategy figures/context.
+Series data is already trimmed to the latest 5 values.
+
+Important:
+- Do not invent missing data.
+- This is an internal audit/classification task, not user-facing trading advice.
+- Do not generate execution instructions, do not replace the original thesis with a new one, and do not provide personalized investment advice.
+- Use the original signal direction and levels as the anchor, but you may state that the current structure does not support them.
+- Respect the source strategy specified in \`signal.strategy\`.
+- Your goal is to explain how well the observed structure matches the existing signal and how structurally confirmed it is right now.
+- Do not write vague statements like "there is momentum/slope" without tying them to the decision.
+- Write all user-visible text fields in the requested response language. If no explicit language instruction is provided later, default to English.
+- If confidence is incomplete, prefer cautious wording such as "likely", "not confirmed yet", or "probably" instead of categorical claims.
+
+Return exactly one JSON object and nothing else:
+
+{
+  "direction": payload.signal.direction | null,
+  "quality": 1 | 2 | 3 | 4 | 5,
+  "needRetest": boolean,
+  "retestPrice": number | null,
+  "takeProfitPrice": number | null,
+  "stopLossPrice": number | null,
+  "setup": string,
+  "confirmations": string,
+  "btcContext": string,
+  "retestPlan": string,
+  "riskLevels": string,
+  "qualityReason": string,
+  "triggerInvalidation": string
+}
+
+- Do not add any other fields.
+- All numbers must be finite, with no \`NaN\` or \`Infinity\`.
+- All text fields must be short strings with no line breaks and no markdown lists.
+- \`direction\` is not a new trade idea. It is only a compatibility flag for the existing signal: either exactly \`payload.signal.direction\` or \`null\` if the current structure does not confirm that signal. Never propose the opposite direction.
+- \`quality\` is the structural confirmation level of the current signal right now, including timing and confirmations. It is not a general attractiveness score and not investment advice.
+- \`needRetest\` indicates whether an additional confirmation level is required before the current signal can be treated as structurally confirmed.
+- \`retestPrice\` is the key level that would confirm or invalidate the structure, or \`null\` if no extra level is needed or available.
+- \`takeProfitPrice\` and \`stopLossPrice\` must not be newly invented levels. If the levels already supplied in \`payload.signal.prices\` still look internally coherent relative to the current price and the confirmed signal, you may return them as an audit of existing levels; otherwise return \`null\`.
+- Use these fields as separate parts of the analysis:
+  - \`setup\`: the current structural setup or trendline state.
+  - \`confirmations\`: 2-4 concrete confirmations or conflicts from the coin indicators.
+  - \`btcContext\`: whether BTC supports the idea, is neutral, or conflicts with it.
+  - \`retestPlan\`: what must happen at the key level to confirm the structure, or why no extra level is needed.
+  - \`riskLevels\`: a short note on whether the existing levels and risk structure are internally coherent, without creating a new trade plan.
+  - \`qualityReason\`: why the quality score is what it is.
+  - \`triggerInvalidation\`: what must happen to confirm the signal or what invalidates the current structural thesis.
+- \`comment\` is optional. If you include it, do not just duplicate the structured fields.
+
+If the data is insufficient or the setup is weak, return \`"direction": null\`, \`quality <= 2\`, and explain why.
+
+Input payload structure:
+- payload.signal:
+  symbol, signalId, interval, direction, timestamp, strategy, prices
+- payload.signal.prices:
+  currentPrice, takeProfitPrice, stopLossPrice
+- payload.figures:
+  strategy-specific figures or geometry when available. Fields vary by strategy.
+- payload.indicators:
+  indicator dictionaries and series for the coin and BTC; all series are already trimmed to the latest 5 values.
+- payload.additionalIndicators:
+  strategy-specific summary/context fields. This is not noise; it contains derived fields deliberately passed by the strategy to help the decision.
+  Examples: helperFlags, structureContext, spread, correlation, volatilitySummary.
+  Always inspect \`payload.additionalIndicators.marketContext\` when present:
+  \u2022 \`marketContext.tradingSession\`: UTC session at signal time: asia / europe / us / overlap / off_hours.
+  \u2022 \`marketContext.binanceCoinbaseSpread\`: BTC spread between Coinbase and Binance from \`payload.indicators.spread\`; \`value=(Coinbase-Binance)/Binance\`, \`bps=value*10000\`.
+  If those fields exist, use them as a more explicit hint instead of trying to re-derive the same idea from raw lines or points.
+  If \`derivativesContext\` exists, it is a derived Coinalyze summary for the time of the signal. Coinalyze context is built only from \`BTCUSDT\` and \`ETHUSDT\` reference symbols, not for every target coin. \`targetSymbol\` is just the source signal coin. Use BTC/ETH open interest, funding, liquidations, and pressure/riskFlags as positioning context, not as an independent trade idea.
+  Key patterns:
+  \u2022 coin: \`maFast\`, \`atrPct\`, \`macd...\`, \`candles15m/candles1h/candles4h/candles1d\`, and \`*1h/*4h/*1d\`
+  \u2022 BTC: \`btcMaFast\`, \`btcAtr\`, \`btcMacd...\`, \`btcCandles*\`, and \`btc*1h/*4h/*1d\`
+  \u2022 strategy service keys are possible as well, for example \`correlation\`, \`spread\`, \`touches\`, \`distance\`
+
+How to analyze, in order:
+1. Start with price structure and the setup geometry or context in \`payload.figures\`. This has higher priority than indicators.
+2. Then use \`payload.additionalIndicators\` when it contains explicit strategy-specific context such as line state, spread, correlation, and similar fields.
+3. Then assess confirmation or conflict from the current coin indicators.
+4. Then evaluate BTC context.
+5. Only after that choose \`direction\`, \`quality\`, and whether an extra confirmation level is required.
+6. If strong conflicts exist, reduce quality or set direction to \`null\`.
+
+Explicit conflict rules:
+- If the figure or price structure is invalid or doubtful, indicators must not rescue the setup.
+- If strategy-specific helper fields explicitly say the signal is not confirmed yet, lacks margin, or requires waiting, do not overstate quality.
+- If the structure is acceptable but BTC or key indicators noticeably conflict, quality is usually \`<= 3\`.
+- If \`derivativesContext.referenceContexts\` exists, check \`primaryReferenceSymbol\` first, then compare \`BTCUSDT\` and \`ETHUSDT\` as broad-market derivatives context. Do not search for Coinalyze data for \`targetSymbol\` unless \`targetSymbol\` itself is \`BTCUSDT\` or \`ETHUSDT\`.
+- If \`derivativesContext.summary.riskFlags\` contains \`crowded_long\` for a LONG or \`crowded_short\` for a SHORT, treat that as crowded positioning and do not overstate quality without strong structural confirmation.
+- If \`derivativesContext.summary.directionAligned=false\`, explicitly mention the derivatives conflict in \`confirmations\` or \`qualityReason\`.
+- If \`derivativesContext\` is absent, stale, or \`missing_derivatives\`, do not infer Coinalyze conclusions and do not penalize the signal just because that data is missing.
+- If \`marketContext.tradingSession\` exists, treat the session as a liquidity and volatility regime: asia is often thinner, europe/us are more active, and overlaps can amplify both momentum and noise. Do not reject a signal solely because of session, but mention clear session support or conflict in \`confirmations\` or \`qualityReason\`.
+- If \`marketContext.binanceCoinbaseSpread.available=true\` and \`severity=elevated/wide\`, treat it as cross-exchange divergence or BTC liquidity risk. Do not use the spread as a standalone long/short signal, but reduce confidence or require more confirmation when the rest of the structure is weak or BTC context conflicts.
+- If \`marketContext.binanceCoinbaseSpread\` is missing or \`available=false\`, do not infer anything from Binance/Coinbase spread and do not penalize the signal just because it is absent.
+- If the current signal is not confirmed (\`direction=null\`), name the main reason briefly in \`comment\`.
+  If you use the structured fields, include the main reason in \`qualityReason\` or \`triggerInvalidation\`.
+
+Rules for \`direction\` / TP / SL:
+- \`direction = LONG\` only if the data confirms the existing LONG signal; \`SHORT\` only if the data confirms the existing SHORT signal; otherwise \`null\`.
+- For LONG, the expected relation is usually \`stopLossPrice < currentPrice < takeProfitPrice\`.
+- For SHORT, the expected relation is usually \`takeProfitPrice < currentPrice < stopLossPrice\`.
+- Do not optimize or recalculate TP/SL for a "better trade"; only assess whether the already supplied levels are coherent.
+- If \`direction = null\`, then \`takeProfitPrice = null\` and \`stopLossPrice = null\`.
+- If \`needRetest = false\`, then \`retestPrice = null\`.
+- If \`needRetest = true\`, \`retestPrice\` must be a finite number tied to a meaningful retest or breakout level.
+- Before responding, sanity-check the consistency of \`direction\`, TP/SL, and the current price.
+
+Quality scale:
+- 1: poor or chaotic setup, strong conflicts, signal not structurally confirmed
+- 2: weak setup, few confirmations, more of a watch or reject
+- 3: average setup, some structure exists, but notable conflicts remain
+- 4: good setup, several confirmations, structure is mostly coherent
+- 5: very strong setup, clean structure, confirmations, and internally coherent levels
+
+Requirements for useful structured analysis:
+- Include 2-4 concrete factors for or against confirmation in \`confirmations\`.
+- Explicitly mention the role of the key figure or structural state, for example breakout, retest, false break, touch, or lack of confirmation.
+- Explicitly mention BTC context as supportive, neutral, or conflicting.
+- Explain why the quality score is what it is.
+- If the signal is not confirmed (\`direction=null\`), state clearly what must change for confirmation.
+- In \`retestPlan\`, avoid technical placeholders like \`needRetest=false @ null\`; write a human explanation.
+- Do not simply restate JSON fields; add interpretation and decision logic.
+
+Rules for using trimmed series (last 5 values):
+- Do not make strong long-term conclusions from only 5 points.
+- Use 4h and 1d series as brief context, not full history.
+- If the data is too limited for confidence, reduce quality and use cautious wording.
+
+Short few-shot examples:
+{"direction":"LONG","quality":4,"needRetest":true,"retestPrice":100.2,"takeProfitPrice":101.5,"stopLossPrice":98.9,"setup":"Likely trendline breakout upward, but the signal still needs a level check for confirmation.","confirmations":"The coin shows momentum support without obvious overheating, but confirmation is not fully clean yet.","btcContext":"BTC is neutral-to-supportive and does not conflict with the current LONG signal.","retestPlan":"The key level is 100.2; holding above it would confirm the signal structure.","riskLevels":"The supplied TP and SL remain on the correct sides of the current price and still look internally coherent.","qualityReason":"Quality=4 because the structure is solid, but an extra level confirmation is still preferable.","triggerInvalidation":"The structure confirms on a hold above the level and weakens on a move back under the line."}
+{"direction":null,"quality":2,"needRetest":false,"retestPrice":null,"takeProfitPrice":null,"stopLossPrice":null,"setup":"Touch or noise around the trendline without a convincing breakout.","confirmations":"Indicators are mixed and do not provide strong structural support.","btcContext":"BTC is either conflicting or not supportive of the current thesis.","retestPlan":"It is too early to define an extra level because a quality breakout is not present yet.","riskLevels":"The supplied levels should not be treated as confirmed while the structure remains weak.","qualityReason":"Quality=2 because timing is weak and confirmations are limited.","triggerInvalidation":"Wait for a clear breakout and confirmation from both the coin and BTC."}
+
+Return only the JSON object, with no extra characters.
+${signal ? buildAiSystemPromptAddonByStrategy(signal) : ""}
+`;
+var buildAiPayload = (signal) => buildAiPayloadByStrategy(signal);
+var getDeterministicAiGateContext = (payload) => {
+  const additionalIndicators = asRecord(payload.additionalIndicators);
+  const candidates = [
+    additionalIndicators,
+    ...Object.values(additionalIndicators ?? {}).map(asRecord)
+  ].filter((value) => Boolean(value));
+  return candidates.find(
+    (candidate) => Array.isArray(candidate.structuralHardBlockReasons) || typeof candidate.approvalAllowedNow === "boolean"
+  ) ?? null;
+};
+var buildAiHumanPrompt = (signal, payload = buildAiPayload(signal)) => `
+Analyze the already computed internal signal for ${signal.symbol}. The original signal direction is ${signal.direction}.
+This is a structure-classification and audit task, not execution advice. Determine whether the current structure confirms the existing signal, how structurally coherent it is right now, whether an extra confirmation level is needed, and whether the already supplied levels in \`payload.signal.prices\` still look internally coherent. Do not replace the original thesis with a new one and do not invent new levels; return only the requested JSON.
+
+Trade payload:
+${JSON.stringify(payload)}
+${buildAiHumanPromptAddonByStrategy(signal, payload)}
+`;
+var DEFAULT_AI_MODEL = "openai/gpt-5-mini";
+var userSettingsCache = /* @__PURE__ */ new Map();
+var aiModelCache = /* @__PURE__ */ new Map();
+var getAiModelCacheKey = (userName, modelName) => `${userName}::${modelName}`;
+var resolveAiModelName = (settings, requestedModelName) => {
+  const explicitModelName = typeof requestedModelName === "string" ? requestedModelName.trim() : "";
+  if (explicitModelName) {
+    return explicitModelName;
+  }
+  const settingsModelName = typeof settings.AI_MODEL === "string" ? settings.AI_MODEL.trim() : "";
+  return settingsModelName || DEFAULT_AI_MODEL;
+};
+var getOpenRouterModelKwargs = (apiEndpoint) => {
+  const endpoint = String(apiEndpoint ?? "").trim();
+  if (!endpoint) {
+    return {};
+  }
+  let hostname = "";
+  try {
+    hostname = new URL(endpoint).hostname;
+  } catch {
+    hostname = endpoint;
+  }
+  if (!hostname.toLowerCase().includes("openrouter")) {
+    return {};
+  }
+  return {
+    provider: {
+      ignore: ["azure"]
+    }
+  };
+};
+var getAiSettings = async (userName = "root") => {
+  let settingsPromise = userSettingsCache.get(userName);
+  if (!settingsPromise) {
+    settingsPromise = (0, import_userSettings.getUserSettings)(userName);
+    settingsPromise.catch(() => {
+      userSettingsCache.delete(userName);
+    });
+    userSettingsCache.set(userName, settingsPromise);
+  }
+  const settings = await settingsPromise;
+  if (!settings.AI_API_KEY || !settings.AI_API_ENDPOINT) {
+    throw new Error(`AI settings are incomplete for user ${userName}`);
+  }
+  return settings;
+};
+var createAiModel = async (userName = "root", requestedModelName) => {
+  const settings = await getAiSettings(userName);
+  const modelName = resolveAiModelName(settings, requestedModelName);
+  const cacheKey = getAiModelCacheKey(userName, modelName);
+  let modelPromise = aiModelCache.get(cacheKey);
+  if (!modelPromise) {
+    modelPromise = (async () => {
+      const { ChatOpenAI } = await import("@langchain/openai");
+      const modelKwargs = getOpenRouterModelKwargs(settings.AI_API_ENDPOINT);
+      return new ChatOpenAI({
+        temperature: 0.2,
+        modelName,
+        apiKey: settings.AI_API_KEY,
+        ...Object.keys(modelKwargs).length ? { modelKwargs } : {},
+        configuration: {
+          baseURL: settings.AI_API_ENDPOINT,
+          defaultHeaders: {
+            "HTTP-Referer": "https://tradejs.dev",
+            "X-Title": "Inv"
+          }
+        }
+      });
+    })();
+    modelPromise.catch(() => {
+      aiModelCache.delete(cacheKey);
+    });
+    aiModelCache.set(cacheKey, modelPromise);
+  }
+  return modelPromise;
+};
+var getAiModel = async (userName = "root", requestedModelName) => {
+  const settings = await getAiSettings(userName);
+  const resolvedModelName = resolveAiModelName(settings, requestedModelName);
+  try {
+    return await createAiModel(userName, resolvedModelName);
+  } catch (error) {
+    aiModelCache.delete(getAiModelCacheKey(userName, resolvedModelName));
+    userSettingsCache.delete(userName);
+    throw error;
+  }
+};
+var resetAiRuntimeCache = () => {
+  aiModelCache.clear();
+  userSettingsCache.clear();
+};
+var ensureAiStrategyPluginsLoaded = async () => {
+  await ensureStrategyPluginsLoaded();
+};
+var buildAiPrompts = (signal) => {
+  const payload = buildAiPayload(signal);
+  return {
+    systemPrompt: buildAiSystemPrompt(signal),
+    humanPrompt: buildAiHumanPrompt(signal, payload)
+  };
+};
+var runAiPrompt = async ({ systemPrompt, humanPrompt }, options = {}) => {
+  if (options.signal) {
+    await ensureAiStrategyPluginsLoaded();
+  }
+  const [{ HumanMessage, SystemMessage }, model, settings] = await Promise.all([
+    import("@langchain/core/messages"),
+    getAiModel(options.userName, options.model),
+    getAiSettings(options.userName)
+  ]);
+  const messages = [];
+  const responseLanguage = (0, import_aiLanguages.getAiResponseLanguagePromptName)(
+    settings.AI_RESPONSE_LANGUAGE || import_aiLanguages.DEFAULT_AI_RESPONSE_LANGUAGE
+  );
+  messages.push(new SystemMessage(systemPrompt));
+  messages.push(
+    new SystemMessage(
+      `Write all user-visible text fields in ${responseLanguage}. Keep field names and JSON syntax unchanged.`
+    )
+  );
+  messages.push(
+    new HumanMessage({
+      content: [
+        {
+          type: "text",
+          text: humanPrompt
+        }
+      ]
+    })
+  );
+  const response = await model.invoke(messages);
+  const parsed = parseAIResponse(
+    normalizeResponseContent(response.content)
+  );
+  const normalized = normalizeAnalysis(parsed);
+  if (!options.signal) {
+    return normalized;
+  }
+  return postProcessAiAnalysisByStrategy(
+    options.signal,
+    normalized,
+    options.payload
+  );
+};
+var runAiPromptLocal = async (signal, options = {}) => {
+  await ensureAiStrategyPluginsLoaded();
+  const payload = options.payload ?? buildAiPayload(signal);
+  const gateContext = getDeterministicAiGateContext(payload);
+  const signalDirection = getSignalDirection(signal);
+  const deterministicQuality = getDeterministicQuality(gateContext);
+  const approvalAllowedNow = typeof gateContext?.approvalAllowedNow === "boolean" ? gateContext.approvalAllowedNow : deterministicQuality >= 4;
+  return postProcessAiAnalysisByStrategy(
+    signal,
+    {
+      direction: approvalAllowedNow ? signalDirection : null,
+      quality: deterministicQuality,
+      needRetest: !approvalAllowedNow,
+      retestPrice: null,
+      takeProfitPrice: approvalAllowedNow ? signal.prices?.takeProfitPrice ?? null : null,
+      stopLossPrice: approvalAllowedNow ? signal.prices?.stopLossPrice ?? null : null
+    },
+    payload
+  );
+};
+var askAI = async (signal, options = {}) => {
+  const { symbol } = signal;
+  await ensureAiStrategyPluginsLoaded();
+  const payload = buildAiPayload(signal);
+  const content = await runAiPrompt(
+    {
+      systemPrompt: buildAiSystemPrompt(signal),
+      humanPrompt: buildAiHumanPrompt(signal, payload)
+    },
+    {
+      ...options,
+      signal,
+      payload
+    }
+  );
+  await (0, import_redis.setData)(import_redis.redisKeys.analysis(symbol, signal.signalId), content);
+  return content;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_AI_MODEL,
+  MAX_AI_SERIES_POINTS,
+  askAI,
+  buildAiHumanPrompt,
+  buildAiPayload,
+  buildAiPrompts,
+  buildAiSystemPrompt,
+  ensureAiStrategyPluginsLoaded,
+  getDeterministicAiGateContext,
+  getOpenRouterModelKwargs,
+  resetAiRuntimeCache,
+  runAiPrompt,
+  runAiPromptLocal,
+  trimSeriesDeep
+});