@voltagent/internal 0.0.1 → 0.0.2

package/dist/main/index.d.mts

@@ -129,4 +129,15 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
  */
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, _default as devLogger };
+/**
+ * Object manipulation utility functions
+ */
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger };

package/dist/main/index.d.ts

@@ -129,4 +129,15 @@ declare function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T>
  */
 declare function convertResponseStreamToArray(response: Response): Promise<string[]>;
 
-export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, _default as devLogger };
+/**
+ * Object manipulation utility functions
+ */
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+
+export { type DevLoggerOptions, convertArrayToAsyncIterable, convertArrayToReadableStream, convertAsyncIterableToArray, convertReadableStreamToArray, convertResponseStreamToArray, createDevLogger, deepClone, _default as devLogger };

package/dist/main/index.js

@@ -2,8 +2,22 @@
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __export = (target, all) => {
   for (var name in all)
@@ -64,6 +78,7 @@ __export(index_exports, {
   convertReadableStreamToArray: () => convertReadableStreamToArray,
   convertResponseStreamToArray: () => convertResponseStreamToArray,
   createDevLogger: () => createDevLogger,
+  deepClone: () => deepClone,
   devLogger: () => logger_default
 });
 module.exports = __toCommonJS(index_exports);
@@ -214,6 +229,20 @@ function convertResponseStreamToArray(response) {
   });
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
+
+// src/utils/object-utils.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   convertArrayToAsyncIterable,
@@ -222,6 +251,7 @@ __name(convertResponseStreamToArray, "convertResponseStreamToArray");
   convertReadableStreamToArray,
   convertResponseStreamToArray,
   createDevLogger,
+  deepClone,
   devLogger
 });
 //# sourceMappingURL=index.js.map

package/dist/main/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/dev/logger.ts","../../src/test/conversions.ts"],"sourcesContent":["export * from \"./dev\";\nexport * from \"./test\";\n","export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,EAKT;AACF;AA5DgB;AA8DhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAFS;AAIT,SAAS,gBAAgB,OAA0C;AACjE,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;AC/ET,SAAsB,6BAAgC,QAAyC;AAAA;AAC7F,UAAM,SAAS,OAAO,UAAU;AAChC,UAAM,SAAc,CAAC;AAErB,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,aAAO,KAAK,KAAK;AAAA,IACnB;AAEA,WAAO;AAAA,EACT;AAAA;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,CAAQ,OAAO,aAAa,IAAI;AAAA;AAC9B,mBAAW,SAAS,QAAQ;AAC1B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA;AAAA,EACF;AACF;AARgB;AAehB,SAAsB,4BAA+B,UAA0C;AAAA;AAC7F,UAAM,SAAc,CAAC;AACrB;AAAA,iCAAyB,WAAzB,0EAAmC;AAAxB,cAAM,OAAjB;AACE,eAAO,KAAK,IAAI;AAAA,MAClB;AAAA,aAFA,MAxCF;AAwCE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,WAAO;AAAA,EACT;AAAA;AANsB;AAaf,SAAS,6BAAgC,QAAgC;AAC9E,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,YAAY;AAChB,UAAI;AACF,mBAAW,SAAS,QAAQ;AAC1B,qBAAW,QAAQ,KAAK;AAAA,QAC1B;AAAA,MACF,UAAE;AACA,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAZgB;AAmBhB,SAAsB,6BAA6B,UAAuC;AAAA;AAExF,WAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AAAA,EACzF;AAAA;AAHsB;","names":[]}
+{"version":3,"sources":["../../src/index.ts","../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export * from \"./dev\";\nexport * from \"./test\";\nexport * from \"./utils\";\n","export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","/**\n * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/main/index.mjs

@@ -1,5 +1,20 @@
 var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
 var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : Symbol.for("Symbol." + name);
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
@@ -184,6 +199,20 @@ function convertResponseStreamToArray(response) {
   });
 }
 __name(convertResponseStreamToArray, "convertResponseStreamToArray");
+
+// src/utils/object-utils.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
 export {
   convertArrayToAsyncIterable,
   convertArrayToReadableStream,
@@ -191,6 +220,7 @@ export {
   convertReadableStreamToArray,
   convertResponseStreamToArray,
   createDevLogger,
+  deepClone,
   logger_default as devLogger
 };
 //# sourceMappingURL=index.mjs.map

package/dist/main/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/dev/logger.ts","../../src/test/conversions.ts"],"sourcesContent":["export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,EAKT;AACF;AA5DgB;AA8DhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAFS;AAIT,SAAS,gBAAgB,OAA0C;AACjE,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;AC/ET,SAAsB,6BAAgC,QAAyC;AAAA;AAC7F,UAAM,SAAS,OAAO,UAAU;AAChC,UAAM,SAAc,CAAC;AAErB,WAAO,MAAM;AACX,YAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,UAAI,KAAM;AACV,aAAO,KAAK,KAAK;AAAA,IACnB;AAEA,WAAO;AAAA,EACT;AAAA;AAXsB;AAkBf,SAAS,4BAA+B,QAA+B;AAC5E,SAAO;AAAA,IACL,CAAQ,OAAO,aAAa,IAAI;AAAA;AAC9B,mBAAW,SAAS,QAAQ;AAC1B,gBAAM;AAAA,QACR;AAAA,MACF;AAAA;AAAA,EACF;AACF;AARgB;AAehB,SAAsB,4BAA+B,UAA0C;AAAA;AAC7F,UAAM,SAAc,CAAC;AACrB;AAAA,iCAAyB,WAAzB,0EAAmC;AAAxB,cAAM,OAAjB;AACE,eAAO,KAAK,IAAI;AAAA,MAClB;AAAA,aAFA,MAxCF;AAwCE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,WAAO;AAAA,EACT;AAAA;AANsB;AAaf,SAAS,6BAAgC,QAAgC;AAC9E,SAAO,IAAI,eAAe;AAAA,IACxB,MAAM,YAAY;AAChB,UAAI;AACF,mBAAW,SAAS,QAAQ;AAC1B,qBAAW,QAAQ,KAAK;AAAA,QAC1B;AAAA,MACF,UAAE;AACA,mBAAW,MAAM;AAAA,MACnB;AAAA,IACF;AAAA,EACF,CAAC;AACH;AAZgB;AAmBhB,SAAsB,6BAA6B,UAAuC;AAAA;AAExF,WAAO,6BAA6B,SAAS,KAAM,YAAY,IAAI,kBAAkB,CAAC,CAAC;AAAA,EACzF;AAAA;AAHsB;","names":[]}
+{"version":3,"sources":["../../src/dev/logger.ts","../../src/test/conversions.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/**\n * Convert a readable stream to an array\n * @param stream - The readable stream to convert\n * @returns The array of values\n */\nexport async function convertReadableStreamToArray<T>(stream: ReadableStream<T>): Promise<T[]> {\n  const reader = stream.getReader();\n  const result: T[] = [];\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n    result.push(value);\n  }\n\n  return result;\n}\n\n/**\n * Convert an array to an async iterable\n * @param values - The array to convert\n * @returns The async iterable\n */\nexport function convertArrayToAsyncIterable<T>(values: T[]): AsyncIterable<T> {\n  return {\n    async *[Symbol.asyncIterator]() {\n      for (const value of values) {\n        yield value;\n      }\n    },\n  };\n}\n\n/**\n * Convert an async iterable to an array\n * @param iterable - The async iterable to convert\n * @returns The array of values\n */\nexport async function convertAsyncIterableToArray<T>(iterable: AsyncIterable<T>): Promise<T[]> {\n  const result: T[] = [];\n  for await (const item of iterable) {\n    result.push(item);\n  }\n  return result;\n}\n\n/**\n * Convert an array to a readable stream\n * @param values - The array to convert\n * @returns The readable stream\n */\nexport function convertArrayToReadableStream<T>(values: T[]): ReadableStream<T> {\n  return new ReadableStream({\n    start(controller) {\n      try {\n        for (const value of values) {\n          controller.enqueue(value);\n        }\n      } finally {\n        controller.close();\n      }\n    },\n  });\n}\n\n/**\n * Convert a response stream to an array\n * @param response - The response to convert\n * @returns The array of values\n */\nexport async function convertResponseStreamToArray(response: Response): Promise<string[]> {\n  // biome-ignore lint/style/noNonNullAssertion: ignore this\n  return convertReadableStreamToArray(response.body!.pipeThrough(new TextDecoderStream()));\n}\n","/**\n * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/utils/index.d.mts

@@ -0,0 +1,12 @@
+/**
+ * Object manipulation utility functions
+ */
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+
+export { deepClone };

package/dist/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Object manipulation utility functions
+ */
+/**
+ * Deep clone an object using JSON serialization with fallback to shallow clone
+ *
+ * @param obj - The object to clone
+ * @returns A deep copy of the object, or shallow copy if JSON serialization fails
+ */
+declare function deepClone<T>(obj: T): T;
+
+export { deepClone };

package/dist/utils/index.js

@@ -0,0 +1,137 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/index.ts
+var index_exports = {};
+__export(index_exports, {
+  deepClone: () => deepClone
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/dev/logger.ts
+function createDevLogger(options) {
+  const isDev = typeof (options == null ? void 0 : options.dev) === "function" ? options.dev : () => {
+    var _a;
+    return (_a = options == null ? void 0 : options.dev) != null ? _a : isDevNodeEnv();
+  };
+  return {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.info(formatLogPrefix("INFO"), message, ...args);
+      }
+    }, "info"),
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.warn(formatLogPrefix("WARN"), message, ...args);
+      }
+    }, "warn"),
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.error(formatLogPrefix("ERROR"), message, ...args);
+      }
+    }, "error")
+  };
+}
+__name(createDevLogger, "createDevLogger");
+var logger_default = createDevLogger();
+function isDevNodeEnv() {
+  return process.env.NODE_ENV === "development";
+}
+__name(isDevNodeEnv, "isDevNodeEnv");
+function formatLogPrefix(level) {
+  return `[VoltAgent] [${timestamp()}] ${level}: `;
+}
+__name(formatLogPrefix, "formatLogPrefix");
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, -1);
+}
+__name(timestamp, "timestamp");
+
+// src/utils/object-utils.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  deepClone
+});
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/index.ts","../../src/dev/logger.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export { deepClone } from \"./object-utils\";\n","export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/**\n * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,EAKT;AACF;AA5DgB;AA8DhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAFS;AAIT,SAAS,gBAAgB,OAA0C;AACjE,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;ACxEF,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;","names":[]}

package/dist/utils/index.mjs

@@ -0,0 +1,113 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/dev/logger.ts
+function createDevLogger(options) {
+  const isDev = typeof (options == null ? void 0 : options.dev) === "function" ? options.dev : () => {
+    var _a;
+    return (_a = options == null ? void 0 : options.dev) != null ? _a : isDevNodeEnv();
+  };
+  return {
+    /**
+     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.info("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    info: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.info(formatLogPrefix("INFO"), message, ...args);
+      }
+    }, "info"),
+    /**
+     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not "development".
+     *
+     * @example
+     * ```typescript
+     * devLogger.warn("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    warn: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.warn(formatLogPrefix("WARN"), message, ...args);
+      }
+    }, "warn"),
+    /**
+     * Log a warning message to the console if the environment is development.
+     *
+     * @example
+     * ```typescript
+     * devLogger.error("Hello, world!");
+     *
+     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!
+     * ```
+     *
+     * @param message - The message to log.
+     * @param args - The arguments to log.
+     */
+    error: /* @__PURE__ */ __name((message, ...args) => {
+      if (isDev()) {
+        console.error(formatLogPrefix("ERROR"), message, ...args);
+      }
+    }, "error")
+  };
+}
+__name(createDevLogger, "createDevLogger");
+var logger_default = createDevLogger();
+function isDevNodeEnv() {
+  return process.env.NODE_ENV === "development";
+}
+__name(isDevNodeEnv, "isDevNodeEnv");
+function formatLogPrefix(level) {
+  return `[VoltAgent] [${timestamp()}] ${level}: `;
+}
+__name(formatLogPrefix, "formatLogPrefix");
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace("T", " ").slice(0, -1);
+}
+__name(timestamp, "timestamp");
+
+// src/utils/object-utils.ts
+function deepClone(obj) {
+  try {
+    return JSON.parse(JSON.stringify(obj));
+  } catch (error) {
+    logger_default.warn("Failed to deep clone object, using shallow clone:", error);
+    if (obj === null || typeof obj !== "object") {
+      return obj;
+    }
+    return __spreadValues({}, obj);
+  }
+}
+__name(deepClone, "deepClone");
+export {
+  deepClone
+};
+//# sourceMappingURL=index.mjs.map

package/dist/utils/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/dev/logger.ts","../../src/utils/object-utils.ts"],"sourcesContent":["export interface DevLoggerOptions {\n  dev: boolean | (() => boolean);\n}\n\n/**\n * A logger for development purposes, that will not pollute the production logs (aka if process.env.NODE_ENV is not \"development\").\n *\n * @example\n * ```typescript\n * devLogger.info(\"Hello, world!\");\n * ```\n */\nexport function createDevLogger(options?: DevLoggerOptions) {\n  const isDev =\n    typeof options?.dev === \"function\" ? options.dev : () => options?.dev ?? isDevNodeEnv();\n\n  return {\n    /**\n     * Log a message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.info(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] INFO: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    info: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.info(formatLogPrefix(\"INFO\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development. This will NOT be logged if process.env.NODE_ENV is not \"development\".\n     *\n     * @example\n     * ```typescript\n     * devLogger.warn(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] WARN: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    warn: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.warn(formatLogPrefix(\"WARN\"), message, ...args);\n      }\n    },\n    /**\n     * Log a warning message to the console if the environment is development.\n     *\n     * @example\n     * ```typescript\n     * devLogger.error(\"Hello, world!\");\n     *\n     * // output: [VoltAgent] [2021-01-01T00:00:00.000Z] ERROR: Hello, world!\n     * ```\n     *\n     * @param message - The message to log.\n     * @param args - The arguments to log.\n     */\n    error: (message?: any, ...args: any[]) => {\n      if (isDev()) {\n        console.error(formatLogPrefix(\"ERROR\"), message, ...args);\n      }\n    },\n  };\n}\n\nexport default createDevLogger();\n\nfunction isDevNodeEnv() {\n  return process.env.NODE_ENV === \"development\";\n}\n\nfunction formatLogPrefix(level: \"INFO\" | \"WARN\" | \"ERROR\"): string {\n  return `[VoltAgent] [${timestamp()}] ${level}: `;\n}\n\nfunction timestamp(): string {\n  return new Date().toISOString().replace(\"T\", \" \").slice(0, -1);\n}\n","/**\n * Object manipulation utility functions\n */\n\nimport { devLogger } from \"../dev\";\n\n/**\n * Deep clone an object using JSON serialization with fallback to shallow clone\n *\n * @param obj - The object to clone\n * @returns A deep copy of the object, or shallow copy if JSON serialization fails\n */\nexport function deepClone<T>(obj: T): T {\n  try {\n    return JSON.parse(JSON.stringify(obj));\n  } catch (error) {\n    devLogger.warn(\"Failed to deep clone object, using shallow clone:\", error);\n    // Fallback to shallow clone for primitive types and simple objects\n    if (obj === null || typeof obj !== \"object\") {\n      return obj;\n    }\n    return { ...obj } as T;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAYO,SAAS,gBAAgB,SAA4B;AAC1D,QAAM,QACJ,QAAO,mCAAS,SAAQ,aAAa,QAAQ,MAAM,MAAG;AAd1D;AAc6D,oDAAS,QAAT,YAAgB,aAAa;AAAA;AAExF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAcL,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,MAAM,wBAAC,YAAkB,SAAgB;AACvC,UAAI,MAAM,GAAG;AACX,gBAAQ,KAAK,gBAAgB,MAAM,GAAG,SAAS,GAAG,IAAI;AAAA,MACxD;AAAA,IACF,GAJM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAkBN,OAAO,wBAAC,YAAkB,SAAgB;AACxC,UAAI,MAAM,GAAG;AACX,gBAAQ,MAAM,gBAAgB,OAAO,GAAG,SAAS,GAAG,IAAI;AAAA,MAC1D;AAAA,IACF,GAJO;AAAA,EAKT;AACF;AA5DgB;AA8DhB,IAAO,iBAAQ,gBAAgB;AAE/B,SAAS,eAAe;AACtB,SAAO,QAAQ,IAAI,aAAa;AAClC;AAFS;AAIT,SAAS,gBAAgB,OAA0C;AACjE,SAAO,gBAAgB,UAAU,CAAC,KAAK,KAAK;AAC9C;AAFS;AAIT,SAAS,YAAoB;AAC3B,UAAO,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE;AAC/D;AAFS;;;ACxEF,SAAS,UAAa,KAAW;AACtC,MAAI;AACF,WAAO,KAAK,MAAM,KAAK,UAAU,GAAG,CAAC;AAAA,EACvC,SAAS,OAAO;AACd,mBAAU,KAAK,qDAAqD,KAAK;AAEzE,QAAI,QAAQ,QAAQ,OAAO,QAAQ,UAAU;AAC3C,aAAO;AAAA,IACT;AACA,WAAO,mBAAK;AAAA,EACd;AACF;AAXgB;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltagent/internal",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "VoltAgent internal - an internal set of tools for the VoltAgent packages",
   "license": "MIT",
   "exports": {
@@ -18,6 +18,11 @@
       "types": "./dist/test/index.d.ts",
       "import": "./dist/test/index.mjs",
       "require": "./dist/test/index.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/index.d.ts",
+      "import": "./dist/utils/index.mjs",
+      "require": "./dist/utils/index.js"
     }
   },
   "main": "dist/main/index.js",
@@ -29,7 +34,7 @@
     "test/dist/**/*"
   ],
   "dependencies": {
-    "@voltagent/core": "^0.1.31"
+    "@voltagent/core": "^0.1.44"
   },
   "devDependencies": {
     "@types/node": "^24.0.3",