@midscene/core 1.12.6-beta-20260910093036.0 → 1.12.6

package/dist/es/ai-model/service-caller/openai-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model/service-caller/openai-client.mjs","sources":["../../../../src/ai-model/service-caller/openai-client.ts"],"sourcesContent":["import {\n  type IModelConfig,\n  MIDSCENE_LANGFUSE_DEBUG,\n  MIDSCENE_LANGSMITH_DEBUG,\n  type TModelFamily,\n  globalConfigManager,\n} from '@midscene/shared/env';\nimport { getDebug } from '@midscene/shared/logger';\nimport { ifInBrowser } from '@midscene/shared/utils';\nimport OpenAI from 'openai';\nimport { getVersion } from '../../utils';\nimport {\n  type OpenAIErrorResponseContext,\n  wrapOpenAICompatibleFetch,\n} from './openai-error';\nimport { createProxyAgent } from './proxy';\nimport { resolveEffectiveTimeoutMs } from './request-timeout';\n\nconst createAndWrapClient = async ({\n  openaiBaseURL,\n  openaiApiKey,\n  openaiExtraConfig,\n  createOpenAIClient,\n  effectiveTimeoutMs,\n  proxyAgent,\n  executionId,\n  openAIErrorResponseContext,\n}: {\n  openaiBaseURL: IModelConfig['openaiBaseURL'];\n  openaiApiKey: IModelConfig['openaiApiKey'];\n  openaiExtraConfig: IModelConfig['openaiExtraConfig'];\n  createOpenAIClient: IModelConfig['createOpenAIClient'];\n  effectiveTimeoutMs: number | null;\n  proxyAgent: Awaited<ReturnType<typeof createProxyAgent>>;\n  executionId: string;\n  openAIErrorResponseContext: OpenAIErrorResponseContext;\n}): Promise<OpenAI> => {\n  const warnClient = getDebug('ai:call', { console: true });\n\n  const openAIOptions = {\n    baseURL: openaiBaseURL,\n    apiKey: openaiApiKey,\n    // Use fetchOptions.dispatcher for fetch-based SDK instead of httpAgent\n    // Note: Type assertion needed due to undici version mismatch between dependencies\n    ...(proxyAgent ? { fetchOptions: { dispatcher: proxyAgent as any } } : {}),\n    ...openaiExtraConfig,\n    // Midscene exposes this setting through MIDSCENE_*_INIT_CONFIG_JSON, so\n    // defaultHeaders is expected to be a plain JSON object rather than another\n    // HeadersLike representation supported by the OpenAI SDK.\n    defaultHeaders: {\n      ...(openaiExtraConfig?.defaultHeaders as\n        | Record<string, string>\n        | undefined),\n      // These Midscene-owned headers intentionally override user-supplied\n      // headers with the same names.\n      'x-midscene-version': getVersion(),\n      'x-midscene-execution-id': executionId,\n    },\n    fetch: wrapOpenAICompatibleFetch(openAIErrorResponseContext),\n    // Midscene already handles retries in callAI(), so disable SDK-level retries\n    // to avoid duplicate attempts and duplicated backoff latency.\n    maxRetries: 0,\n    // When disabled (timeoutMs === null) fall through to the SDK default so\n    // only the caller-provided abortSignal can cancel the request.\n    ...(effectiveTimeoutMs !== null ? { timeout: effectiveTimeoutMs } : {}),\n    dangerouslyAllowBrowser: true,\n  };\n\n  const baseOpenAI = new OpenAI(openAIOptions);\n\n  let openai: OpenAI = baseOpenAI;\n\n  // LangSmith wrapper\n  if (\n    openai &&\n    globalConfigManager.getEnvConfigInBoolean(MIDSCENE_LANGSMITH_DEBUG)\n  ) {\n    if (ifInBrowser) {\n      throw new Error('langsmith is not supported in browser');\n    }\n    warnClient('DEBUGGING MODE: langsmith wrapper enabled');\n    // Use variable to prevent static analysis by bundlers\n    const langsmithModule = 'langsmith/wrappers';\n    const { wrapOpenAI } = await import(langsmithModule);\n    openai = wrapOpenAI(openai);\n  }\n\n  // Langfuse wrapper\n  if (\n    openai &&\n    globalConfigManager.getEnvConfigInBoolean(MIDSCENE_LANGFUSE_DEBUG)\n  ) {\n    if (ifInBrowser) {\n      throw new Error('langfuse is not supported in browser');\n    }\n    warnClient('DEBUGGING MODE: langfuse wrapper enabled');\n    // Use variable to prevent static analysis by bundlers\n    const langfuseModule = '@langfuse/openai';\n    const { observeOpenAI } = await import(langfuseModule);\n    openai = observeOpenAI(openai);\n  }\n\n  if (createOpenAIClient) {\n    const wrappedClient = await createOpenAIClient(baseOpenAI, openAIOptions);\n\n    if (wrappedClient) {\n      openai = wrappedClient as OpenAI;\n    }\n  }\n\n  return openai;\n};\n\nexport async function createChatClient({\n  modelConfig,\n  executionId,\n  recordEvent,\n}: {\n  modelConfig: IModelConfig;\n  executionId: string;\n  recordEvent?: (event: Record<string, unknown>) => void;\n}): Promise<{\n  completion: OpenAI.Chat.Completions;\n  modelName: string;\n  modelDescription: string;\n  modelFamily: TModelFamily | undefined;\n  openAIErrorResponseContext: OpenAIErrorResponseContext;\n}> {\n  const {\n    socksProxy,\n    httpProxy,\n    modelName,\n    openaiBaseURL,\n    openaiApiKey,\n    openaiExtraConfig,\n    modelDescription,\n    modelFamily,\n    createOpenAIClient,\n    timeout,\n  } = modelConfig;\n\n  const proxyAgent = await createProxyAgent({ socksProxy, httpProxy });\n\n  const effectiveTimeoutMs = resolveEffectiveTimeoutMs({ timeout });\n  const openAIErrorResponseContext: OpenAIErrorResponseContext = {\n    recordEvent,\n  };\n\n  const openai = await createAndWrapClient({\n    openaiBaseURL,\n    openaiApiKey,\n    openaiExtraConfig,\n    createOpenAIClient,\n    effectiveTimeoutMs,\n    proxyAgent,\n    executionId,\n    openAIErrorResponseContext,\n  });\n\n  return {\n    completion: openai.chat.completions,\n    modelName,\n    modelDescription,\n    modelFamily,\n    openAIErrorResponseContext,\n  };\n}\n"],"names":["createAndWrapClient","openaiBaseURL","openaiApiKey","openaiExtraConfig","createOpenAIClient","effectiveTimeoutMs","proxyAgent","executionId","openAIErrorResponseContext","warnClient","getDebug","openAIOptions","getVersion","wrapOpenAICompatibleFetch","baseOpenAI","OpenAI","openai","globalConfigManager","MIDSCENE_LANGSMITH_DEBUG","ifInBrowser","Error","langsmithModule","wrapOpenAI","MIDSCENE_LANGFUSE_DEBUG","langfuseModule","observeOpenAI","wrappedClient","createChatClient","modelConfig","recordEvent","socksProxy","httpProxy","modelName","modelDescription","modelFamily","timeout","createProxyAgent","resolveEffectiveTimeoutMs"],"mappings":";;;;;;;;AAkBA,MAAMA,sBAAsB,OAAO,EACjCC,aAAa,EACbC,YAAY,EACZC,iBAAiB,EACjBC,kBAAkB,EAClBC,kBAAkB,EAClBC,UAAU,EACVC,WAAW,EACXC,0BAA0B,EAU3B;IACC,MAAMC,aAAaC,SAAS,WAAW;QAAE,SAAS;IAAK;IAEvD,MAAMC,gBAAgB;QACpB,SAASV;QACT,QAAQC;QAGR,GAAII,aAAa;YAAE,cAAc;gBAAE,YAAYA;YAAkB;QAAE,IAAI,CAAC,CAAC;QACzE,GAAGH,iBAAiB;QAIpB,gBAAgB;YACd,GAAIA,mBAAmB,cAAc;YAKrC,sBAAsBS;YACtB,2BAA2BL;QAC7B;QACA,OAAOM,0BAA0BL;QAGjC,YAAY;QAGZ,GAAIH,AAAuB,SAAvBA,qBAA8B;YAAE,SAASA;QAAmB,IAAI,CAAC,CAAC;QACtE,yBAAyB;IAC3B;IAEA,MAAMS,aAAa,IAAIC,SAAOJ;IAE9B,IAAIK,SAAiBF;IAGrB,IACEE,UACAC,oBAAoB,qBAAqB,CAACC,2BAC1C;QACA,IAAIC,aACF,MAAM,IAAIC,MAAM;QAElBX,WAAW;QAEX,MAAMY,kBAAkB;QACxB,MAAM,EAAEC,UAAU,EAAE,GAAG,MAAM,MAAM,CAACD;QACpCL,SAASM,WAAWN;IACtB;IAGA,IACEA,UACAC,oBAAoB,qBAAqB,CAACM,0BAC1C;QACA,IAAIJ,aACF,MAAM,IAAIC,MAAM;QAElBX,WAAW;QAEX,MAAMe,iBAAiB;QACvB,MAAM,EAAEC,aAAa,EAAE,GAAG,MAAM,MAAM,CAACD;QACvCR,SAASS,cAAcT;IACzB;IAEA,IAAIZ,oBAAoB;QACtB,MAAMsB,gBAAgB,MAAMtB,mBAAmBU,YAAYH;QAE3D,IAAIe,eACFV,SAASU;IAEb;IAEA,OAAOV;AACT;AAEO,eAAeW,iBAAiB,EACrCC,WAAW,EACXrB,WAAW,EACXsB,WAAW,EAKZ;IAOC,MAAM,EACJC,UAAU,EACVC,SAAS,EACTC,SAAS,EACT/B,aAAa,EACbC,YAAY,EACZC,iBAAiB,EACjB8B,gBAAgB,EAChBC,WAAW,EACX9B,kBAAkB,EAClB+B,OAAO,EACR,GAAGP;IAEJ,MAAMtB,aAAa,MAAM8B,iBAAiB;QAAEN;QAAYC;IAAU;IAElE,MAAM1B,qBAAqBgC,0BAA0B;QAAEF;IAAQ;IAC/D,MAAM3B,6BAAyD;QAC7DqB;IACF;IAEA,MAAMb,SAAS,MAAMhB,oBAAoB;QACvCC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;QACAC;IACF;IAEA,OAAO;QACL,YAAYQ,OAAO,IAAI,CAAC,WAAW;QACnCgB;QACAC;QACAC;QACA1B;IACF;AACF"}

package/dist/es/ai-model/service-caller/proxy.mjs

@@ -0,0 +1,66 @@
+import { getDebug } from "@midscene/shared/logger";
+import { ifInBrowser } from "@midscene/shared/utils";
+const sanitizeProxyUrl = (url)=>{
+    try {
+        const parsed = new URL(url);
+        if (parsed.username) {
+            parsed.password = '****';
+            return parsed.href;
+        }
+        return url;
+    } catch  {
+        return url;
+    }
+};
+const createProxyAgent = async ({ socksProxy, httpProxy })=>{
+    const warnProxy = getDebug('ai:call:proxy', {
+        console: true
+    });
+    const debugProxy = getDebug('ai:call:proxy');
+    if (httpProxy) {
+        debugProxy('using http proxy', sanitizeProxyUrl(httpProxy));
+        if (ifInBrowser) warnProxy('HTTP proxy is configured but not supported in browser environment');
+        else {
+            const { loadUndici } = await import("#proxy-deps");
+            const { ProxyAgent } = await loadUndici();
+            const proxyAgent = new ProxyAgent({
+                uri: httpProxy
+            });
+            return proxyAgent;
+        }
+    } else if (socksProxy) {
+        debugProxy('using socks proxy', sanitizeProxyUrl(socksProxy));
+        if (ifInBrowser) warnProxy('SOCKS proxy is configured but not supported in browser environment');
+        else try {
+            const { loadFetchSocks } = await import("#proxy-deps");
+            const { socksDispatcher } = await loadFetchSocks();
+            const proxyUrl = new URL(socksProxy);
+            if (!proxyUrl.hostname) throw new Error('SOCKS proxy URL must include a valid hostname');
+            const port = Number.parseInt(proxyUrl.port, 10);
+            if (!proxyUrl.port || Number.isNaN(port)) throw new Error('SOCKS proxy URL must include a valid port');
+            const protocol = proxyUrl.protocol.replace(':', '');
+            const socksType = 'socks4' === protocol ? 4 : 'socks5' === protocol ? 5 : 5;
+            const proxyAgent = socksDispatcher({
+                type: socksType,
+                host: proxyUrl.hostname,
+                port,
+                ...proxyUrl.username ? {
+                    userId: decodeURIComponent(proxyUrl.username),
+                    password: decodeURIComponent(proxyUrl.password || '')
+                } : {}
+            });
+            debugProxy('socks proxy configured successfully', {
+                type: socksType,
+                host: proxyUrl.hostname,
+                port: port
+            });
+            return proxyAgent;
+        } catch (error) {
+            warnProxy('Failed to configure SOCKS proxy:', error);
+            throw new Error(`Invalid SOCKS proxy URL: ${socksProxy}. Expected format: socks4://host:port, socks5://host:port, or with authentication: socks5://user:pass@host:port`);
+        }
+    }
+};
+export { createProxyAgent };
+
+//# sourceMappingURL=proxy.mjs.map

package/dist/es/ai-model/service-caller/proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model/service-caller/proxy.mjs","sources":["../../../../src/ai-model/service-caller/proxy.ts"],"sourcesContent":["import { getDebug } from '@midscene/shared/logger';\nimport { ifInBrowser } from '@midscene/shared/utils';\n\n// Helper function to sanitize proxy URL for logging (remove credentials)\n// Uses URL API instead of regex to avoid ReDoS vulnerabilities\nconst sanitizeProxyUrl = (url: string): string => {\n  try {\n    const parsed = new URL(url);\n    if (parsed.username) {\n      // Keep username for debugging, hide password for security\n      parsed.password = '****';\n      return parsed.href;\n    }\n    return url;\n  } catch {\n    // If URL parsing fails, return original URL (will be caught later)\n    return url;\n  }\n};\n\nexport const createProxyAgent = async ({\n  socksProxy,\n  httpProxy,\n}: {\n  socksProxy: string | undefined;\n  httpProxy: string | undefined;\n}): Promise<unknown> => {\n  const warnProxy = getDebug('ai:call:proxy', { console: true });\n  const debugProxy = getDebug('ai:call:proxy');\n\n  if (httpProxy) {\n    debugProxy('using http proxy', sanitizeProxyUrl(httpProxy));\n    if (ifInBrowser) {\n      warnProxy(\n        'HTTP proxy is configured but not supported in browser environment',\n      );\n    } else {\n      const { loadUndici } = await import('#proxy-deps');\n      const { ProxyAgent } = await loadUndici();\n      const proxyAgent = new ProxyAgent({\n        uri: httpProxy,\n        // Note: authentication is handled via the URI (e.g., http://user:pass@proxy.com:8080)\n      });\n      return proxyAgent;\n    }\n  } else if (socksProxy) {\n    debugProxy('using socks proxy', sanitizeProxyUrl(socksProxy));\n    if (ifInBrowser) {\n      warnProxy(\n        'SOCKS proxy is configured but not supported in browser environment',\n      );\n    } else {\n      try {\n        const { loadFetchSocks } = await import('#proxy-deps');\n        const { socksDispatcher } = await loadFetchSocks();\n        // Parse SOCKS proxy URL (e.g., socks5://127.0.0.1:1080)\n        const proxyUrl = new URL(socksProxy);\n\n        // Validate hostname\n        if (!proxyUrl.hostname) {\n          throw new Error('SOCKS proxy URL must include a valid hostname');\n        }\n\n        // Validate and parse port\n        const port = Number.parseInt(proxyUrl.port, 10);\n        if (!proxyUrl.port || Number.isNaN(port)) {\n          throw new Error('SOCKS proxy URL must include a valid port');\n        }\n\n        // Parse SOCKS version from protocol\n        const protocol = proxyUrl.protocol.replace(':', '');\n        const socksType =\n          protocol === 'socks4' ? 4 : protocol === 'socks5' ? 5 : 5;\n\n        const proxyAgent = socksDispatcher({\n          type: socksType,\n          host: proxyUrl.hostname,\n          port,\n          ...(proxyUrl.username\n            ? {\n                userId: decodeURIComponent(proxyUrl.username),\n                password: decodeURIComponent(proxyUrl.password || ''),\n              }\n            : {}),\n        });\n        debugProxy('socks proxy configured successfully', {\n          type: socksType,\n          host: proxyUrl.hostname,\n          port: port,\n        });\n        return proxyAgent;\n      } catch (error) {\n        warnProxy('Failed to configure SOCKS proxy:', error);\n        throw new Error(\n          `Invalid SOCKS proxy URL: ${socksProxy}. Expected format: socks4://host:port, socks5://host:port, or with authentication: socks5://user:pass@host:port`,\n        );\n      }\n    }\n  }\n};\n"],"names":["sanitizeProxyUrl","url","parsed","URL","createProxyAgent","socksProxy","httpProxy","warnProxy","getDebug","debugProxy","ifInBrowser","loadUndici","ProxyAgent","proxyAgent","loadFetchSocks","socksDispatcher","proxyUrl","Error","port","Number","protocol","socksType","decodeURIComponent","error"],"mappings":";;AAKA,MAAMA,mBAAmB,CAACC;IACxB,IAAI;QACF,MAAMC,SAAS,IAAIC,IAAIF;QACvB,IAAIC,OAAO,QAAQ,EAAE;YAEnBA,OAAO,QAAQ,GAAG;YAClB,OAAOA,OAAO,IAAI;QACpB;QACA,OAAOD;IACT,EAAE,OAAM;QAEN,OAAOA;IACT;AACF;AAEO,MAAMG,mBAAmB,OAAO,EACrCC,UAAU,EACVC,SAAS,EAIV;IACC,MAAMC,YAAYC,SAAS,iBAAiB;QAAE,SAAS;IAAK;IAC5D,MAAMC,aAAaD,SAAS;IAE5B,IAAIF,WAAW;QACbG,WAAW,oBAAoBT,iBAAiBM;QAChD,IAAII,aACFH,UACE;aAEG;YACL,MAAM,EAAEI,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC;YACpC,MAAM,EAAEC,UAAU,EAAE,GAAG,MAAMD;YAC7B,MAAME,aAAa,IAAID,WAAW;gBAChC,KAAKN;YAEP;YACA,OAAOO;QACT;IACF,OAAO,IAAIR,YAAY;QACrBI,WAAW,qBAAqBT,iBAAiBK;QACjD,IAAIK,aACFH,UACE;aAGF,IAAI;YACF,MAAM,EAAEO,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC;YACxC,MAAM,EAAEC,eAAe,EAAE,GAAG,MAAMD;YAElC,MAAME,WAAW,IAAIb,IAAIE;YAGzB,IAAI,CAACW,SAAS,QAAQ,EACpB,MAAM,IAAIC,MAAM;YAIlB,MAAMC,OAAOC,OAAO,QAAQ,CAACH,SAAS,IAAI,EAAE;YAC5C,IAAI,CAACA,SAAS,IAAI,IAAIG,OAAO,KAAK,CAACD,OACjC,MAAM,IAAID,MAAM;YAIlB,MAAMG,WAAWJ,SAAS,QAAQ,CAAC,OAAO,CAAC,KAAK;YAChD,MAAMK,YACJD,AAAa,aAAbA,WAAwB,IAAIA,AAAa,aAAbA,WAAwB,IAAI;YAE1D,MAAMP,aAAaE,gBAAgB;gBACjC,MAAMM;gBACN,MAAML,SAAS,QAAQ;gBACvBE;gBACA,GAAIF,SAAS,QAAQ,GACjB;oBACE,QAAQM,mBAAmBN,SAAS,QAAQ;oBAC5C,UAAUM,mBAAmBN,SAAS,QAAQ,IAAI;gBACpD,IACA,CAAC,CAAC;YACR;YACAP,WAAW,uCAAuC;gBAChD,MAAMY;gBACN,MAAML,SAAS,QAAQ;gBACvB,MAAME;YACR;YACA,OAAOL;QACT,EAAE,OAAOU,OAAO;YACdhB,UAAU,oCAAoCgB;YAC9C,MAAM,IAAIN,MACR,CAAC,yBAAyB,EAAEZ,WAAW,+GAA+G,CAAC;QAE3J;IAEJ;AACF"}

package/dist/es/ai-model/service-caller/utils.mjs

@@ -0,0 +1,83 @@
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class AIResponseParseError extends Error {
+    constructor(message, rawResponse, usage, rawChoiceMessage, reasoningContent){
+        super(message), _define_property(this, "usage", void 0), _define_property(this, "rawResponse", void 0), _define_property(this, "rawChoiceMessage", void 0), _define_property(this, "reasoningContent", void 0);
+        this.name = 'AIResponseParseError';
+        this.rawResponse = rawResponse;
+        this.usage = usage;
+        this.rawChoiceMessage = rawChoiceMessage;
+        this.reasoningContent = reasoningContent;
+    }
+}
+const INTERNAL_CALL_ID_FIELD = '_midscene_call_id';
+let internalCallIdCounter = 0;
+function nextInternalCallId() {
+    internalCallIdCounter += 1;
+    return `call_${internalCallIdCounter}`;
+}
+function stringifyForDebug(value) {
+    try {
+        return JSON.stringify(value);
+    } catch (_error) {
+        return String(value);
+    }
+}
+function getLatestSuccessfulResponseRequestId(context) {
+    return context.responseRequestIds?.reduce((latestRequestId, response)=>response.ok ? response.requestId : latestRequestId, void 0);
+}
+function getLatestResponseAttempt(context) {
+    return context.httpResponses?.at(-1)?.attempt ?? 1;
+}
+function getErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+function normalizeRetryCount(retryCount) {
+    if ('number' != typeof retryCount || !Number.isFinite(retryCount)) return 1;
+    return Math.max(0, Math.floor(retryCount));
+}
+function appendAIRequestFailureSummary(error, attemptErrors, maxAttempts) {
+    const failedAttempts = attemptErrors.length;
+    const retries = Math.max(0, failedAttempts - 1);
+    const retryLabel = 1 === retries ? 'retry' : 'retries';
+    const originalMessage = error.message;
+    const previousAttemptErrors = attemptErrors.slice(0, -1);
+    error.message = `AI model request failed after ${retries} ${retryLabel} (${failedAttempts}/${maxAttempts} attempts). Last error: ${originalMessage}`;
+    if (0 === previousAttemptErrors.length) return error;
+    const details = previousAttemptErrors.map(({ attempt, error })=>`Attempt ${attempt}: ${getErrorMessage(error)}`).join('\n');
+    error.message = `${error.message}\nPrevious AI call attempt errors:\n${details}`;
+    return error;
+}
+const buildUsageInfo = ({ usageData, requestId, timeCost, modelName, modelDescription, responseModelName, slot, internalCallId })=>{
+    if (!usageData) return;
+    const cachedInputTokens = usageData?.prompt_tokens_details?.cached_tokens;
+    return {
+        ...usageData,
+        prompt_tokens: usageData.prompt_tokens ?? 0,
+        completion_tokens: usageData.completion_tokens ?? 0,
+        total_tokens: usageData.total_tokens ?? 0,
+        cached_input: cachedInputTokens ?? 0,
+        time_cost: timeCost ?? 0,
+        model_name: modelName,
+        model_description: modelDescription,
+        response_model_name: responseModelName,
+        slot,
+        intent: void 0,
+        request_id: requestId ?? void 0,
+        [INTERNAL_CALL_ID_FIELD]: internalCallId
+    };
+};
+export { AIResponseParseError, INTERNAL_CALL_ID_FIELD, appendAIRequestFailureSummary, buildUsageInfo, getLatestResponseAttempt, getLatestSuccessfulResponseRequestId, nextInternalCallId, normalizeRetryCount, stringifyForDebug, toError };
+
+//# sourceMappingURL=utils.mjs.map

package/dist/es/ai-model/service-caller/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-model/service-caller/utils.mjs","sources":["../../../../src/ai-model/service-caller/utils.ts"],"sourcesContent":["import type { AIUsageInfo } from '@/types';\nimport type OpenAI from 'openai';\nimport type { ModelRuntime } from '../models';\nimport type { OpenAIErrorResponseContext } from './openai-error';\n\n// Error class that preserves usage and rawResponse when AI call parsing fails\nexport class AIResponseParseError extends Error {\n  usage?: AIUsageInfo;\n  /**\n   * Adapter-extracted content used by Midscene for parsing. This is not the\n   * full provider response or choices[0].message.\n   */\n  rawResponse: string;\n  rawChoiceMessage?: unknown;\n  reasoningContent?: string;\n\n  constructor(\n    message: string,\n    rawResponse: string,\n    usage?: AIUsageInfo,\n    rawChoiceMessage?: unknown,\n    reasoningContent?: string,\n  ) {\n    super(message);\n    this.name = 'AIResponseParseError';\n    this.rawResponse = rawResponse;\n    this.usage = usage;\n    this.rawChoiceMessage = rawChoiceMessage;\n    this.reasoningContent = reasoningContent;\n  }\n}\n\n/**\n * Internal field name stamped onto every AIUsageInfo shaped by callAI().\n * Used for cross-path dedup when the provider does not return a request_id.\n */\nexport const INTERNAL_CALL_ID_FIELD = '_midscene_call_id';\n\nlet internalCallIdCounter = 0;\nexport function nextInternalCallId(): string {\n  internalCallIdCounter += 1;\n  return `call_${internalCallIdCounter}`;\n}\n\nexport function stringifyForDebug(value: unknown): string {\n  try {\n    return JSON.stringify(value);\n  } catch (_error) {\n    return String(value);\n  }\n}\n\nexport function getLatestSuccessfulResponseRequestId(\n  context: OpenAIErrorResponseContext,\n): string | undefined {\n  return context.responseRequestIds?.reduce<string | undefined>(\n    (latestRequestId, response) =>\n      response.ok ? response.requestId : latestRequestId,\n    undefined,\n  );\n}\n\nexport function getLatestResponseAttempt(context: OpenAIErrorResponseContext) {\n  return context.httpResponses?.at(-1)?.attempt ?? 1;\n}\n\nfunction getErrorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\nexport function toError(error: unknown): Error {\n  return error instanceof Error ? error : new Error(String(error));\n}\n\nexport function normalizeRetryCount(retryCount: unknown): number {\n  if (typeof retryCount !== 'number' || !Number.isFinite(retryCount)) {\n    return 1;\n  }\n\n  return Math.max(0, Math.floor(retryCount));\n}\n\nexport function appendAIRequestFailureSummary<T extends Error>(\n  error: T,\n  attemptErrors: Array<{ attempt: number; error: unknown }>,\n  maxAttempts: number,\n): T {\n  const failedAttempts = attemptErrors.length;\n  const retries = Math.max(0, failedAttempts - 1);\n  const retryLabel = retries === 1 ? 'retry' : 'retries';\n  const originalMessage = error.message;\n  const previousAttemptErrors = attemptErrors.slice(0, -1);\n\n  error.message = `AI model request failed after ${retries} ${retryLabel} (${failedAttempts}/${maxAttempts} attempts). Last error: ${originalMessage}`;\n\n  if (previousAttemptErrors.length === 0) {\n    return error;\n  }\n\n  const details = previousAttemptErrors\n    .map(\n      ({ attempt, error }) => `Attempt ${attempt}: ${getErrorMessage(error)}`,\n    )\n    .join('\\n');\n\n  error.message = `${error.message}\\nPrevious AI call attempt errors:\\n${details}`;\n  return error;\n}\n\nexport const buildUsageInfo = ({\n  usageData,\n  requestId,\n  timeCost,\n  modelName,\n  modelDescription,\n  responseModelName,\n  slot,\n  internalCallId,\n}: {\n  usageData?: OpenAI.CompletionUsage;\n  requestId?: string | null;\n  timeCost?: number;\n  modelName: string;\n  modelDescription: string;\n  responseModelName?: string;\n  slot: ModelRuntime['config']['slot'];\n  internalCallId: string;\n}): AIUsageInfo | undefined => {\n  if (!usageData) return undefined;\n\n  const cachedInputTokens = (\n    usageData as { prompt_tokens_details?: { cached_tokens?: number } }\n  )?.prompt_tokens_details?.cached_tokens;\n\n  return {\n    ...usageData,\n    prompt_tokens: usageData.prompt_tokens ?? 0,\n    completion_tokens: usageData.completion_tokens ?? 0,\n    total_tokens: usageData.total_tokens ?? 0,\n    cached_input: cachedInputTokens ?? 0,\n    time_cost: timeCost ?? 0,\n    model_name: modelName,\n    model_description: modelDescription,\n    response_model_name: responseModelName,\n    slot,\n    // Left undefined at the raw call layer. The agent's onUsage callback\n    // fills it from modelConfig.slot for metrics collection, and task\n    // layers use withUsageIntent() to stamp a more specific semantic\n    // intent (e.g. 'planning', 'insight') when attaching usage to tasks.\n    intent: undefined,\n    request_id: requestId ?? undefined,\n    // Internal stable ID for cross-path dedup when request_id is absent.\n    [INTERNAL_CALL_ID_FIELD]: internalCallId,\n  } satisfies AIUsageInfo;\n};\n"],"names":["AIResponseParseError","Error","message","rawResponse","usage","rawChoiceMessage","reasoningContent","INTERNAL_CALL_ID_FIELD","internalCallIdCounter","nextInternalCallId","stringifyForDebug","value","JSON","_error","String","getLatestSuccessfulResponseRequestId","context","latestRequestId","response","undefined","getLatestResponseAttempt","getErrorMessage","error","toError","normalizeRetryCount","retryCount","Number","Math","appendAIRequestFailureSummary","attemptErrors","maxAttempts","failedAttempts","retries","retryLabel","originalMessage","previousAttemptErrors","details","attempt","buildUsageInfo","usageData","requestId","timeCost","modelName","modelDescription","responseModelName","slot","internalCallId","cachedInputTokens"],"mappings":";;;;;;;;;;AAMO,MAAMA,6BAA6BC;IAUxC,YACEC,OAAe,EACfC,WAAmB,EACnBC,KAAmB,EACnBC,gBAA0B,EAC1BC,gBAAyB,CACzB;QACA,KAAK,CAACJ,UAhBR,yCAKA,+CACA,oDACA;QAUE,IAAI,CAAC,IAAI,GAAG;QACZ,IAAI,CAAC,WAAW,GAAGC;QACnB,IAAI,CAAC,KAAK,GAAGC;QACb,IAAI,CAAC,gBAAgB,GAAGC;QACxB,IAAI,CAAC,gBAAgB,GAAGC;IAC1B;AACF;AAMO,MAAMC,yBAAyB;AAEtC,IAAIC,wBAAwB;AACrB,SAASC;IACdD,yBAAyB;IACzB,OAAO,CAAC,KAAK,EAAEA,uBAAuB;AACxC;AAEO,SAASE,kBAAkBC,KAAc;IAC9C,IAAI;QACF,OAAOC,KAAK,SAAS,CAACD;IACxB,EAAE,OAAOE,QAAQ;QACf,OAAOC,OAAOH;IAChB;AACF;AAEO,SAASI,qCACdC,OAAmC;IAEnC,OAAOA,QAAQ,kBAAkB,EAAE,OACjC,CAACC,iBAAiBC,WAChBA,SAAS,EAAE,GAAGA,SAAS,SAAS,GAAGD,iBACrCE;AAEJ;AAEO,SAASC,yBAAyBJ,OAAmC;IAC1E,OAAOA,QAAQ,aAAa,EAAE,GAAG,KAAK,WAAW;AACnD;AAEA,SAASK,gBAAgBC,KAAc;IACrC,OAAOA,iBAAiBrB,QAAQqB,MAAM,OAAO,GAAGR,OAAOQ;AACzD;AAEO,SAASC,QAAQD,KAAc;IACpC,OAAOA,iBAAiBrB,QAAQqB,QAAQ,IAAIrB,MAAMa,OAAOQ;AAC3D;AAEO,SAASE,oBAAoBC,UAAmB;IACrD,IAAI,AAAsB,YAAtB,OAAOA,cAA2B,CAACC,OAAO,QAAQ,CAACD,aACrD,OAAO;IAGT,OAAOE,KAAK,GAAG,CAAC,GAAGA,KAAK,KAAK,CAACF;AAChC;AAEO,SAASG,8BACdN,KAAQ,EACRO,aAAyD,EACzDC,WAAmB;IAEnB,MAAMC,iBAAiBF,cAAc,MAAM;IAC3C,MAAMG,UAAUL,KAAK,GAAG,CAAC,GAAGI,iBAAiB;IAC7C,MAAME,aAAaD,AAAY,MAAZA,UAAgB,UAAU;IAC7C,MAAME,kBAAkBZ,MAAM,OAAO;IACrC,MAAMa,wBAAwBN,cAAc,KAAK,CAAC,GAAG;IAErDP,MAAM,OAAO,GAAG,CAAC,8BAA8B,EAAEU,QAAQ,CAAC,EAAEC,WAAW,EAAE,EAAEF,eAAe,CAAC,EAAED,YAAY,wBAAwB,EAAEI,iBAAiB;IAEpJ,IAAIC,AAAiC,MAAjCA,sBAAsB,MAAM,EAC9B,OAAOb;IAGT,MAAMc,UAAUD,sBACb,GAAG,CACF,CAAC,EAAEE,OAAO,EAAEf,KAAK,EAAE,GAAK,CAAC,QAAQ,EAAEe,QAAQ,EAAE,EAAEhB,gBAAgBC,QAAQ,EAExE,IAAI,CAAC;IAERA,MAAM,OAAO,GAAG,GAAGA,MAAM,OAAO,CAAC,oCAAoC,EAAEc,SAAS;IAChF,OAAOd;AACT;AAEO,MAAMgB,iBAAiB,CAAC,EAC7BC,SAAS,EACTC,SAAS,EACTC,QAAQ,EACRC,SAAS,EACTC,gBAAgB,EAChBC,iBAAiB,EACjBC,IAAI,EACJC,cAAc,EAUf;IACC,IAAI,CAACP,WAAW;IAEhB,MAAMQ,oBACJR,WACC,uBAAuB;IAE1B,OAAO;QACL,GAAGA,SAAS;QACZ,eAAeA,UAAU,aAAa,IAAI;QAC1C,mBAAmBA,UAAU,iBAAiB,IAAI;QAClD,cAAcA,UAAU,YAAY,IAAI;QACxC,cAAcQ,qBAAqB;QACnC,WAAWN,YAAY;QACvB,YAAYC;QACZ,mBAAmBC;QACnB,qBAAqBC;QACrBC;QAKA,QAAQ1B;QACR,YAAYqB,aAAarB;QAEzB,CAACZ,uBAAuB,EAAEuC;IAC5B;AACF"}