@ai-setting/roy-agent-core 1.7.53 → 1.7.56

package/dist/shared/@ai-setting/{roy-agent-core-yhsssn86.js → roy-agent-core-zmeka63k.js}

@@ -1,7 +1,7 @@
 import {
   TracedAs,
   init_decorator
-} from "./roy-agent-core-dsevjbck.js";
+} from "./roy-agent-core-b599jgyd.js";
 import {
   __legacyDecorateClassTS,
   __require

package/dist/test-utils/child-process-mock.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Shared `child_process` mock factory for `mock.module(...)`.
+ *
+ * ## 为什么需要它（Task #4420）
+ *
+ * Bun 当前对 `mock.module("child_process", factory)` 采用 **ESM exports 语义**：
+ * factory 返回的对象被当作模块的**完整导出面**，而不是「在真实模块上打补丁」。
+ * 因此只要少提供一个命名导出，任何**静态** `import { x } from "child_process"`
+ * 该导出的模块都会在**模块加载期**直接抛：
+ *
+ * ```
+ * SyntaxError: Export named 'exec' not found in module 'node:child_process'.
+ * ```
+ *
+ * 更糟的是：
+ *   1. 报错指向**被 import 的模块**（如 `event-source-handlers.ts`），
+ *      而不是写了不完整 mock 的**测试文件** —— 极难定位。
+ *   2. mock.module 在同一 `bun test` 进程内**跨文件泄漏**（bun 不像 jest
+ *      每文件独立 registry），所以还会顺带炸掉后面无关的文件。
+ *
+ * ## 历史事故（同一个坑踩了 3 次）
+ *
+ * - Task #2372：`event-source-handlers-builtin.test.ts` 只 mock `spawn`，
+ *   炸掉后面所有静态 import `spawnSync` 的模块（见
+ *   `util/process/process-tree-killer.ts` 里的 lazy-import 规避注释）。
+ * - Task #4331：源码 `event-source-handlers.ts` 新增 `exec as execSync`，
+ *   但该测试的 mock 没跟上 → 整个文件 48/64 条测试挂红（Task #4420 修的就是这个）。
+ *
+ * ## 解决方式
+ *
+ * **导出面从真实模块自省派生**，永不手写清单：
+ *   - `require("node:child_process")` 枚举出真实存在的导出名
+ *   - 对每个导出，默认**透传真实实现**，只把测试显式 `overrides` 的键替换掉
+ *   - 额外补一个 `default`（ESM namespace 有 `default`，`require()` 没有 ——
+ *     这也是历史 mock 需要手写 `default: {...}` 的原因，现在自动生成）
+ *
+ * 这样即使未来 Node/Bun 新增导出，或源码新增 `import { execFile }`，
+ * mock 也不会因为「缺导出」再次炸掉整个测试文件。
+ *
+ * ## 用法
+ *
+ * ```ts
+ * import { createChildProcessMockModule } from "../../../test-utils/child-process-mock";
+ *
+ * beforeEach(() => {
+ *   mock.module("child_process", () =>
+ *     createChildProcessMockModule({ spawn: spawnMock }),
+ *   );
+ * });
+ * ```
+ *
+ * 注意：`mock.module` 的 specifier 用 `"child_process"` 还是
+ * `"node:child_process"` 都能命中（Bun 会把两者归一），helper 内部统一
+ * 从 `node:child_process` 自省。
+ */
+/**
+ * 当前 Node/Bun 上 `node:child_process` 的完整命名导出清单（运行时自省）。
+ *
+ * 在 Bun 上为：`ChildProcess`, `exec`, `execFile`, `execFileSync`,
+ * `execSync`, `fork`, `spawn`, `spawnSync`。
+ */
+export declare const CHILD_PROCESS_EXPORT_NAMES: readonly string[];
+type ChildProcessModule = Record<string, any>;
+/**
+ * 构造一个**导出面完整**的 `child_process` mock 模块对象。
+ *
+ * @param overrides 需要替换为测试替身（spy/stub）的导出。其余导出保持真实实现，
+ *                  既保证导出面完整，又避免把未测行为也一起假掉。
+ * @returns 可直接被 `mock.module("child_process", () => ...)` 返回的模块对象，
+ *          含 `default` 自引用（`default` 上的键与命名导出保持一致）。
+ */
+export declare function createChildProcessMockModule(overrides?: ChildProcessModule): ChildProcessModule;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-setting/roy-agent-core",
-  "version": "1.7.53",
+  "version": "1.7.56",
   "type": "module",
   "description": "Core SDK for roy-agent - Environment, Components, Tools, Sessions, Tasks",
   "main": "./dist/index.js",
@@ -35,7 +35,7 @@
     "clean": "rm -rf dist",
     "typecheck": "npx tsc --noEmit --skipLibCheck --project tsconfig.json",
     "test:llm": "bun test test/llm/",
-    "test:llm:fast": "bun test --parallel 4 test/llm/"
+    "test:llm:fast": "bun test --parallel=4 test/llm/"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.0",

package/dist/shared/@ai-setting/roy-agent-core-dsevjbck.js

@@ -1,245 +0,0 @@
-import {
-  createLogger,
-  getMaxOutput,
-  getTracerProvider,
-  init_logger,
-  init_tracer_provider,
-  simplifyFilePath
-} from "./roy-agent-core-8seq65bp.js";
-import {
-  __esm
-} from "./roy-agent-core-fs0mn2jk.js";
-
-// src/env/log-trace/decorator.ts
-function Traced(options) {
-  const buildOptions = () => ({
-    recordParams: options?.recordParams ?? true,
-    recordResult: options?.recordResult ?? false,
-    recordError: options?.recordError ?? true,
-    log: options?.log ?? false,
-    maxLogSize: options?.maxLogSize,
-    paramFilter: options?.paramFilter,
-    resultFilter: options?.resultFilter,
-    flattenParamFilter: options?.flattenParamFilter,
-    errorIf: options?.errorIf
-  });
-  return function(target, propertyKey, descriptor) {
-    if (descriptor !== undefined && descriptor !== null && typeof descriptor === "object" && "value" in descriptor) {
-      const originalFn = descriptor.value;
-      const spanName = options?.name || String(propertyKey);
-      descriptor.value = wrapFunction(originalFn, spanName, buildOptions());
-      return descriptor;
-    }
-    const value = target;
-    const context = propertyKey || {};
-    if (typeof value === "function") {
-      const spanName = options?.name || (context?.name ? String(context.name) : "anonymous");
-      return wrapFunction(value, spanName, buildOptions());
-    }
-    return value;
-  };
-}
-function TracedAs(name, options) {
-  return Traced({ name, ...options });
-}
-function TracedLightweight(options) {
-  return Traced({ recordParams: false, recordResult: false, log: options?.log ?? false, maxLogSize: options?.maxLogSize });
-}
-function wrapFunction(fn, name, options) {
-  const shouldLog = options?.log ?? false;
-  const getMaxLogSize = () => {
-    if (options?.maxLogSize !== undefined) {
-      return options.maxLogSize;
-    }
-    const configMaxOutput = getMaxOutput();
-    return configMaxOutput !== undefined ? configMaxOutput : 500;
-  };
-  const truncate = (obj) => {
-    if (obj === undefined)
-      return;
-    if (obj === null)
-      return null;
-    const maxLogSize = getMaxLogSize();
-    let str;
-    try {
-      str = typeof obj === "string" ? obj : JSON.stringify(obj, null, 0).replace(/\n/g, "");
-    } catch (e) {
-      str = `[Object with circular reference: ${e instanceof Error ? e.message : String(e)}]`;
-    }
-    if (maxLogSize > 0 && str.length > maxLogSize) {
-      return str.slice(0, maxLogSize) + " [TRUNCATED]";
-    }
-    try {
-      return JSON.parse(str);
-    } catch {
-      return str;
-    }
-  };
-  const truncateString = (obj) => {
-    if (obj === undefined)
-      return "undefined";
-    if (obj === null)
-      return "null";
-    const maxLogSize = getMaxLogSize();
-    let str;
-    try {
-      str = typeof obj === "string" ? obj : JSON.stringify(obj, null, 0).replace(/\n/g, "");
-    } catch (e) {
-      str = `[Object with circular reference: ${e instanceof Error ? e.message : String(e)}]`;
-    }
-    return maxLogSize > 0 && str.length > maxLogSize ? str.slice(0, maxLogSize) + " [TRUNCATED]" : str;
-  };
-  const toDbValue = (obj) => {
-    if (obj === undefined)
-      return;
-    if (obj === null)
-      return null;
-    if (typeof obj === "string")
-      return obj;
-    try {
-      return JSON.parse(JSON.stringify(obj));
-    } catch (e) {
-      return `[Object with circular reference: ${e instanceof Error ? e.message : String(e)}]`;
-    }
-  };
-  const TRACE_LOG_PREFIX = "[TRACE]";
-  const getCallerLocation = () => {
-    const originalLimit = Error.stackTraceLimit;
-    Error.stackTraceLimit = 15;
-    const err = new Error;
-    Error.captureStackTrace(err, getCallerLocation);
-    const stack = err.stack?.split(`
-`) || [];
-    Error.stackTraceLimit = originalLimit;
-    for (let i = 1;i < stack.length; i++) {
-      const line = stack[i];
-      if (line.includes("decorator.ts") || line.includes("decorator.js") || line.includes("logFn") || line.includes("getCallerLocation"))
-        continue;
-      const match = line.match(/at\s+.+\s+\((.+):(\d+):\d+\)/) || line.match(/at\s+(.+):(\d+):\d+/);
-      if (match) {
-        const filePath = match[1];
-        if (!filePath || filePath === "native")
-          continue;
-        const relativePath = simplifyFilePath(filePath);
-        return `${relativePath}:${match[2]}`;
-      }
-    }
-    return "";
-  };
-  const logFn = (event, argsOrData, callerLocation) => {
-    if (!shouldLog)
-      return;
-    const logger = createLogger("traced:" + name);
-    const tag = event === "enter" ? ">>>" : event === "quit" ? "<<<" : "!!!";
-    const prefix = `${TRACE_LOG_PREFIX} ${tag} ${name}`;
-    const originalFnLocation = callerLocation || getCallerLocation();
-    const logMessage = (msg, data) => {
-      if (data !== undefined) {
-        logger.info(`${prefix} ${msg}: ${truncateString(data)}`, { callerLocation: originalFnLocation });
-      } else {
-        logger.info(`${prefix} ${msg}`, { callerLocation: originalFnLocation });
-      }
-    };
-    if (event === "enter") {
-      logMessage("enter", argsOrData);
-    } else if (event === "quit") {
-      logMessage("quit", options?.recordResult ? argsOrData : undefined);
-    } else {
-      logMessage("error", argsOrData);
-    }
-  };
-  return function(...args) {
-    const tracer = getTracerProvider().getTracer("roy-tracer");
-    const attributes = {};
-    if (options?.recordParams !== false) {
-      if (options?.paramFilter) {
-        const filtered = options.paramFilter(args);
-        attributes["params"] = toDbValue(filtered);
-        if (options?.flattenParamFilter && filtered && typeof filtered === "object" && !Array.isArray(filtered)) {
-          for (const [key, value] of Object.entries(filtered)) {
-            if (!(key in attributes)) {
-              attributes[key] = toDbValue(value);
-            }
-          }
-        }
-      } else {
-        attributes["params"] = toDbValue(args);
-      }
-    }
-    const callerLocation = getCallerLocation();
-    let span;
-    try {
-      span = tracer.startSpan(name, { attributes });
-    } catch {}
-    logFn("enter", args, callerLocation);
-    try {
-      const result = fn.call(this, ...args);
-      if (result && typeof result === "object" && typeof result.then === "function") {
-        return result.then((resolved) => {
-          if (span) {
-            if (options?.resultFilter) {
-              const filtered = options.resultFilter(resolved);
-              if (filtered && typeof filtered === "object") {
-                for (const [key, value] of Object.entries(filtered)) {
-                  span.setAttribute(key, toDbValue(value));
-                }
-              }
-            }
-            span.setAttribute("result", JSON.stringify(toDbValue(resolved)));
-            const resultError = options?.errorIf ? options.errorIf(resolved) : undefined;
-            if (resultError) {
-              const err = resultError instanceof Error ? resultError : new Error(String(resultError));
-              span.setAttribute("error", err.message);
-              span.end(undefined, err);
-            } else {
-              span.end(resolved);
-            }
-          }
-          logFn("quit", options?.recordResult ? resolved : undefined, callerLocation);
-          return resolved;
-        }, (rejected) => {
-          if (span) {
-            span.setAttribute("error", String(rejected));
-            span.end(undefined, rejected instanceof Error ? rejected : new Error(String(rejected)));
-          }
-          logFn("error", rejected.message, callerLocation);
-          throw rejected;
-        });
-      }
-      if (span) {
-        if (options?.resultFilter) {
-          const filtered = options.resultFilter(result);
-          if (filtered && typeof filtered === "object") {
-            for (const [key, value] of Object.entries(filtered)) {
-              span.setAttribute(key, toDbValue(value));
-            }
-          }
-        }
-        span.setAttribute("result", JSON.stringify(toDbValue(result)));
-        const syncResultError = options?.errorIf ? options.errorIf(result) : undefined;
-        if (syncResultError) {
-          const err = syncResultError instanceof Error ? syncResultError : new Error(String(syncResultError));
-          span.setAttribute("error", err.message);
-          span.end(undefined, err);
-        } else {
-          span.end(result);
-        }
-      }
-      logFn("quit", options?.recordResult ? result : undefined, callerLocation);
-      return result;
-    } catch (error) {
-      if (span) {
-        span.setAttribute("error", String(error));
-        span.end(undefined, error instanceof Error ? error : new Error(String(error)));
-      }
-      logFn("error", error.message, callerLocation);
-      throw error;
-    }
-  };
-}
-var init_decorator = __esm(() => {
-  init_tracer_provider();
-  init_logger();
-});
-
-export { Traced, TracedAs, TracedLightweight, wrapFunction, init_decorator };