@tradejs/node 3.0.1 → 3.1.0

package/README.md

@@ -63,6 +63,8 @@ Import only explicit subpaths:
 - `@tradejs/node/connectors`
 - `@tradejs/node/cli`
 - `@tradejs/node/constants`
+- `@tradejs/node/runtimeTrades`
+- `@tradejs/node/runtimeDashboard`
 
 There is no root `@tradejs/node` import surface.
 

package/dist/ai.d.mts

@@ -1,9 +1,34 @@
 import { Signal, AiPayload, SignalAnalysis, AiPromptPair } from '@tradejs/types';
 
+interface AiChatMessage$1 {
+    role: 'system' | 'user';
+    content: string;
+}
+interface InvokeAiChatOptions$1 {
+    messages: AiChatMessage$1[];
+    userName?: string;
+    model?: string;
+    temperature?: number;
+}
+declare const DEFAULT_AI_MODEL = "openai/gpt-5-mini";
+declare const getOpenRouterModelKwargs: (apiEndpoint?: string | null) => Record<string, unknown>;
+declare const resetAiRuntimeCache: () => void;
+
 declare const MAX_AI_SERIES_POINTS = 5;
 declare const trimSeriesDeep: (value: any) => any;
 declare const buildCompactAiIndicatorsSnapshot: (value: any) => any;
 
+interface AiChatMessage extends AiChatMessage$1 {
+    /** @deprecated Provider formatting is retained for API compatibility only. */
+    format?: 'plain' | 'text-block';
+}
+type InvokeAiChatOptions = Omit<InvokeAiChatOptions$1, 'messages'> & {
+    messages: AiChatMessage[];
+};
+declare const invokeAiChat: (options: InvokeAiChatOptions) => Promise<{
+    content: string | object;
+}>;
+
 type DeterministicAiGateContext = {
     approvalAllowedNow?: boolean;
     deterministicQuality?: number;
@@ -22,12 +47,9 @@ interface AiRequestOptions {
     payload?: AiPayload;
     model?: string;
 }
-declare const DEFAULT_AI_MODEL = "openai/gpt-5-mini";
-declare const getOpenRouterModelKwargs: (apiEndpoint?: string | null) => Record<string, unknown>;
-declare const resetAiRuntimeCache: () => void;
 declare const buildAiPrompts: (signal: Signal) => AiPromptPair;
 declare const runAiPrompt: ({ systemPrompt, humanPrompt }: AiPromptPair, options?: AiRequestOptions) => Promise<Partial<SignalAnalysis>>;
 declare const runAiPromptLocal: (signal: Signal, options?: Omit<AiRequestOptions, "model" | "userName">) => Promise<Partial<SignalAnalysis>>;
 declare const askAI: (signal: Signal, options?: AiRequestOptions) => Promise<Partial<SignalAnalysis>>;
 
-export { DEFAULT_AI_MODEL, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep };
+export { type AiChatMessage, DEFAULT_AI_MODEL, type InvokeAiChatOptions, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, invokeAiChat, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep };

package/dist/ai.d.ts

@@ -1,9 +1,34 @@
 import { Signal, AiPayload, SignalAnalysis, AiPromptPair } from '@tradejs/types';
 
+interface AiChatMessage$1 {
+    role: 'system' | 'user';
+    content: string;
+}
+interface InvokeAiChatOptions$1 {
+    messages: AiChatMessage$1[];
+    userName?: string;
+    model?: string;
+    temperature?: number;
+}
+declare const DEFAULT_AI_MODEL = "openai/gpt-5-mini";
+declare const getOpenRouterModelKwargs: (apiEndpoint?: string | null) => Record<string, unknown>;
+declare const resetAiRuntimeCache: () => void;
+
 declare const MAX_AI_SERIES_POINTS = 5;
 declare const trimSeriesDeep: (value: any) => any;
 declare const buildCompactAiIndicatorsSnapshot: (value: any) => any;
 
+interface AiChatMessage extends AiChatMessage$1 {
+    /** @deprecated Provider formatting is retained for API compatibility only. */
+    format?: 'plain' | 'text-block';
+}
+type InvokeAiChatOptions = Omit<InvokeAiChatOptions$1, 'messages'> & {
+    messages: AiChatMessage[];
+};
+declare const invokeAiChat: (options: InvokeAiChatOptions) => Promise<{
+    content: string | object;
+}>;
+
 type DeterministicAiGateContext = {
     approvalAllowedNow?: boolean;
     deterministicQuality?: number;
@@ -22,12 +47,9 @@ interface AiRequestOptions {
     payload?: AiPayload;
     model?: string;
 }
-declare const DEFAULT_AI_MODEL = "openai/gpt-5-mini";
-declare const getOpenRouterModelKwargs: (apiEndpoint?: string | null) => Record<string, unknown>;
-declare const resetAiRuntimeCache: () => void;
 declare const buildAiPrompts: (signal: Signal) => AiPromptPair;
 declare const runAiPrompt: ({ systemPrompt, humanPrompt }: AiPromptPair, options?: AiRequestOptions) => Promise<Partial<SignalAnalysis>>;
 declare const runAiPromptLocal: (signal: Signal, options?: Omit<AiRequestOptions, "model" | "userName">) => Promise<Partial<SignalAnalysis>>;
 declare const askAI: (signal: Signal, options?: AiRequestOptions) => Promise<Partial<SignalAnalysis>>;
 
-export { DEFAULT_AI_MODEL, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep };
+export { type AiChatMessage, DEFAULT_AI_MODEL, type InvokeAiChatOptions, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, invokeAiChat, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep };

package/dist/ai.js

@@ -40,17 +40,15 @@ __export(ai_exports, {
   buildCompactAiIndicatorsSnapshot: () => buildCompactAiIndicatorsSnapshot,
   getDeterministicAiGateContext: () => getDeterministicAiGateContext,
   getOpenRouterModelKwargs: () => getOpenRouterModelKwargs,
+  invokeAiChat: () => invokeAiChat,
   resetAiRuntimeCache: () => resetAiRuntimeCache,
   runAiPrompt: () => runAiPrompt,
   runAiPromptLocal: () => runAiPromptLocal,
   trimSeriesDeep: () => trimSeriesDeep
 });
 module.exports = __toCommonJS(ai_exports);
-var import_aiLanguages = require("@tradejs/core/aiLanguages");
-var import_aiEndpoints = require("@tradejs/core/aiEndpoints");
-var import_aiModels = require("@tradejs/core/aiModels");
+var import_aiLanguages2 = require("@tradejs/core/aiLanguages");
 var import_redis = require("@tradejs/infra/redis");
-var import_userSettings = require("@tradejs/infra/userSettings");
 
 // src/aiShared.ts
 var MAX_AI_SERIES_POINTS = 5;
@@ -757,7 +755,149 @@ var postProcessLocalAiAnalysisByStrategy = (signal, analysis, payload = buildAiP
   }) ?? strategyAnalysis;
 };
 
+// src/aiProvider.ts
+var import_aiEndpoints = require("@tradejs/core/aiEndpoints");
+var import_aiModels = require("@tradejs/core/aiModels");
+var import_aiLanguages = require("@tradejs/core/aiLanguages");
+var import_userSettings = require("@tradejs/infra/userSettings");
+var DEFAULT_AI_MODEL = "openai/gpt-5-mini";
+var userSettingsCache = /* @__PURE__ */ new Map();
+var aiModelCache = /* @__PURE__ */ new Map();
+var normalizeResponseContent = (content) => {
+  if (typeof content === "string") return content;
+  if (content && typeof content === "object" && !Array.isArray(content)) {
+    return content;
+  }
+  if (Array.isArray(content)) {
+    return content.map(
+      (part) => typeof part?.text === "string" ? part.text : ""
+    ).join("\n").trim();
+  }
+  return String(content ?? "");
+};
+var getAiInvocationError = (error) => {
+  const details = error instanceof Error && error.message.trim() ? error.message.trim() : String(error);
+  const isEmptyCompletion = error instanceof TypeError && /Cannot read properties of undefined \(reading ['"]message['"]\)/.test(
+    details
+  );
+  const wrapped = new Error(
+    isEmptyCompletion ? "AI provider returned an empty chat completion" : `AI model invocation failed: ${details}`
+  );
+  wrapped.cause = error;
+  return wrapped;
+};
+var isEmptyResponseContent = (content) => typeof content === "string" ? content.trim().length === 0 : Object.keys(content).length === 0;
+var getAiModelCacheKey = (userName, modelName, temperature) => `${userName}::${modelName}::${temperature}`;
+var resolveAiModelName = (settings, requestedModelName) => {
+  const explicitModelName = requestedModelName?.trim() ?? "";
+  if (explicitModelName) return explicitModelName;
+  return settings.AI_MODEL?.trim() || 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;
+  }
+  return hostname.toLowerCase().includes("openrouter") ? { provider: { ignore: ["azure"] } } : {};
+};
+var getAiUserSettings = async (userName = "root") => {
+  let settingsPromise = userSettingsCache.get(userName);
+  if (!settingsPromise) {
+    settingsPromise = (0, import_userSettings.getUserSettings)(userName).then((settings2) => {
+      const endpoint = (0, import_aiEndpoints.normalizeAiEndpoint)(settings2.AI_API_ENDPOINT);
+      return {
+        ...settings2,
+        AI_API_ENDPOINT: endpoint,
+        AI_MODEL: (0, import_aiModels.normalizeAiModel)(settings2.AI_MODEL, endpoint),
+        AI_RESPONSE_LANGUAGE: (0, import_aiLanguages.normalizeAiResponseLanguage)(
+          settings2.AI_RESPONSE_LANGUAGE
+        )
+      };
+    });
+    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 getAiModel = async (userName = "root", requestedModelName, temperature = 0.2) => {
+  const settings = await getAiUserSettings(userName);
+  const modelName = resolveAiModelName(settings, requestedModelName);
+  const cacheKey = getAiModelCacheKey(userName, modelName, temperature);
+  let modelPromise = aiModelCache.get(cacheKey);
+  if (!modelPromise) {
+    modelPromise = import("@langchain/openai").then(({ ChatOpenAI }) => {
+      const modelKwargs = getOpenRouterModelKwargs(settings.AI_API_ENDPOINT);
+      return new ChatOpenAI({
+        temperature,
+        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);
+  }
+  try {
+    return await modelPromise;
+  } catch (error) {
+    aiModelCache.delete(cacheKey);
+    userSettingsCache.delete(userName);
+    throw error;
+  }
+};
+var resetAiRuntimeCache = () => {
+  aiModelCache.clear();
+  userSettingsCache.clear();
+};
+var invokeAiChatWithUserMessageEncoding = async ({
+  messages,
+  userName = "root",
+  model,
+  temperature = 0.2
+}, resolveUserMessageEncoding) => {
+  const [{ HumanMessage, SystemMessage }, aiModel] = await Promise.all([
+    import("@langchain/core/messages"),
+    getAiModel(userName, model, temperature)
+  ]);
+  const providerMessages = messages.map(
+    (message) => message.role === "system" ? new SystemMessage(message.content) : new HumanMessage(
+      resolveUserMessageEncoding(message) === "text-block" ? { content: [{ type: "text", text: message.content }] } : message.content
+    )
+  );
+  try {
+    const response = await aiModel.invoke(providerMessages);
+    const content = normalizeResponseContent(response?.content);
+    if (isEmptyResponseContent(content)) {
+      throw new Error("AI provider returned an empty chat completion");
+    }
+    return { content };
+  } catch (error) {
+    throw getAiInvocationError(error);
+  }
+};
+var invokeAiPromptChat = (options) => invokeAiChatWithUserMessageEncoding(options, () => "text-block");
+var invokeCompatibleAiChat = (options) => invokeAiChatWithUserMessageEncoding(
+  options,
+  (message) => message.format ?? "plain"
+);
+
 // src/ai.ts
+var invokeAiChat = (options) => invokeCompatibleAiChat(options);
 var parseAIResponse = (input) => {
   try {
     if (typeof input === "object" && input !== null) return input;
@@ -770,18 +910,6 @@ var parseAIResponse = (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;
@@ -1015,120 +1143,6 @@ Trade payload:
 ${JSON.stringify(payload)}
 ${buildAiHumanPromptAddonByStrategy(signal, payload)}
 `;
-var getAiInvocationError = (error) => {
-  const details = error instanceof Error && error.message.trim() ? error.message.trim() : String(error);
-  const isEmptyCompletion = error instanceof TypeError && /Cannot read properties of undefined \(reading ['"]message['"]\)/.test(
-    details
-  );
-  const wrapped = new Error(
-    isEmptyCompletion ? "AI provider returned an empty chat completion" : `AI model invocation failed: ${details}`
-  );
-  wrapped.cause = error;
-  return wrapped;
-};
-var isEmptyResponseContent = (content) => typeof content === "string" ? content.trim().length === 0 : Object.keys(content).length === 0;
-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).then((settings2) => {
-      const endpoint = (0, import_aiEndpoints.normalizeAiEndpoint)(settings2.AI_API_ENDPOINT);
-      return {
-        ...settings2,
-        AI_API_ENDPOINT: endpoint,
-        AI_MODEL: (0, import_aiModels.normalizeAiModel)(settings2.AI_MODEL, endpoint),
-        AI_RESPONSE_LANGUAGE: (0, import_aiLanguages.normalizeAiResponseLanguage)(
-          settings2.AI_RESPONSE_LANGUAGE
-        )
-      };
-    });
-    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 buildAiPrompts = (signal) => {
   const payload = buildAiPayload(signal);
   return {
@@ -1137,42 +1151,23 @@ var buildAiPrompts = (signal) => {
   };
 };
 var runAiPrompt = async ({ systemPrompt, humanPrompt }, options = {}) => {
-  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 settings = await getAiUserSettings(options.userName);
+  const responseLanguage = (0, import_aiLanguages2.getAiResponseLanguagePromptName)(
+    settings.AI_RESPONSE_LANGUAGE || import_aiLanguages2.DEFAULT_AI_RESPONSE_LANGUAGE
   );
-  let response;
-  try {
-    response = await model.invoke(messages);
-  } catch (error) {
-    throw getAiInvocationError(error);
-  }
-  const responseContent = normalizeResponseContent(response?.content);
-  if (isEmptyResponseContent(responseContent)) {
-    throw new Error("AI provider returned an empty chat completion");
-  }
-  const parsed = parseAIResponse(responseContent);
+  const response = await invokeAiPromptChat({
+    userName: options.userName,
+    model: options.model,
+    messages: [
+      { role: "system", content: systemPrompt },
+      {
+        role: "system",
+        content: `Write all user-visible text fields in ${responseLanguage}. Keep field names and JSON syntax unchanged.`
+      },
+      { role: "user", content: humanPrompt }
+    ]
+  });
+  const parsed = parseAIResponse(response.content);
   const normalized = normalizeAnalysis(parsed);
   if (!options.signal) {
     return normalized;
@@ -1231,6 +1226,7 @@ var askAI = async (signal, options = {}) => {
   buildCompactAiIndicatorsSnapshot,
   getDeterministicAiGateContext,
   getOpenRouterModelKwargs,
+  invokeAiChat,
   resetAiRuntimeCache,
   runAiPrompt,
   runAiPromptLocal,

package/dist/ai.mjs

@@ -9,11 +9,12 @@ import {
   buildCompactAiIndicatorsSnapshot,
   getDeterministicAiGateContext,
   getOpenRouterModelKwargs,
+  invokeAiChat,
   resetAiRuntimeCache,
   runAiPrompt,
   runAiPromptLocal,
   trimSeriesDeep
-} from "./chunk-VRXU4E4O.mjs";
+} from "./chunk-KOQSLFT2.mjs";
 import "./chunk-WS5DYEVZ.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 export {
@@ -27,6 +28,7 @@ export {
   buildCompactAiIndicatorsSnapshot,
   getDeterministicAiGateContext,
   getOpenRouterModelKwargs,
+  invokeAiChat,
   resetAiRuntimeCache,
   runAiPrompt,
   runAiPromptLocal,