@dexto/core 1.2.4 → 1.2.6

package/dist/logger/v2/transports/file-transport.js

@@ -0,0 +1,128 @@
+import "../../../chunk-C6A6W6XS.js";
+import * as fs from "fs";
+import * as path from "path";
+class FileTransport {
+  filePath;
+  maxSize;
+  maxFiles;
+  writeStream = null;
+  currentSize = 0;
+  isRotating = false;
+  pendingLogs = [];
+  constructor(config) {
+    this.filePath = config.path;
+    this.maxSize = config.maxSize ?? 10 * 1024 * 1024;
+    this.maxFiles = config.maxFiles ?? 5;
+    const dir = path.dirname(this.filePath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    if (fs.existsSync(this.filePath)) {
+      const stats = fs.statSync(this.filePath);
+      this.currentSize = stats.size;
+    }
+    this.createWriteStream();
+  }
+  createWriteStream() {
+    this.writeStream = fs.createWriteStream(this.filePath, {
+      flags: "a",
+      // Append mode
+      encoding: "utf8"
+    });
+    this.writeStream.on("error", (error) => {
+      console.error("FileTransport write stream error:", error);
+    });
+  }
+  write(entry) {
+    const line = JSON.stringify(entry) + "\n";
+    const lineSize = Buffer.byteLength(line, "utf8");
+    if (!this.writeStream || this.isRotating) {
+      this.pendingLogs.push(line);
+      return;
+    }
+    if (this.currentSize + lineSize > this.maxSize) {
+      this.pendingLogs.push(line);
+      void this.rotate();
+      return;
+    }
+    this.writeStream.write(line);
+    this.currentSize += lineSize;
+  }
+  /**
+   * Rotate log files asynchronously
+   * Renames current file to .1, shifts existing rotated files up (.1 -> .2, etc.)
+   * Deletes oldest file if maxFiles is exceeded, then flushes buffered logs
+   */
+  async rotate() {
+    if (this.isRotating) {
+      return;
+    }
+    this.isRotating = true;
+    try {
+      if (this.writeStream) {
+        await new Promise((resolve) => {
+          this.writeStream.end(() => resolve());
+        });
+        this.writeStream = null;
+      }
+      const promises = [];
+      const oldestFile = `${this.filePath}.${this.maxFiles}`;
+      try {
+        await fs.promises.access(oldestFile);
+        promises.push(fs.promises.unlink(oldestFile));
+      } catch {
+      }
+      await Promise.all(promises);
+      for (let i = this.maxFiles - 1; i >= 1; i--) {
+        const oldFile = `${this.filePath}.${i}`;
+        const newFile = `${this.filePath}.${i + 1}`;
+        try {
+          await fs.promises.access(oldFile);
+          await fs.promises.rename(oldFile, newFile);
+        } catch {
+        }
+      }
+      try {
+        await fs.promises.access(this.filePath);
+        await fs.promises.rename(this.filePath, `${this.filePath}.1`);
+      } catch {
+      }
+      this.currentSize = 0;
+      this.createWriteStream();
+      await this.flushPendingLogs();
+    } catch (error) {
+      console.error("FileTransport rotation error:", error);
+    } finally {
+      this.isRotating = false;
+    }
+  }
+  /**
+   * Flush buffered logs to the write stream
+   * Called after rotation completes to prevent log loss
+   */
+  async flushPendingLogs() {
+    while (this.pendingLogs.length > 0 && this.writeStream) {
+      const line = this.pendingLogs.shift();
+      const lineSize = Buffer.byteLength(line, "utf8");
+      if (this.currentSize + lineSize > this.maxSize) {
+        this.pendingLogs.unshift(line);
+        await this.rotate();
+        break;
+      }
+      this.writeStream.write(line);
+      this.currentSize += lineSize;
+    }
+  }
+  /**
+   * Cleanup resources
+   */
+  destroy() {
+    if (this.writeStream) {
+      this.writeStream.end();
+      this.writeStream = null;
+    }
+  }
+}
+export {
+  FileTransport
+};

package/dist/logger/v2/types.cjs

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+__export(types_exports, {
+  DextoLogComponent: () => DextoLogComponent
+});
+module.exports = __toCommonJS(types_exports);
+var DextoLogComponent = /* @__PURE__ */ ((DextoLogComponent2) => {
+  DextoLogComponent2["AGENT"] = "agent";
+  DextoLogComponent2["LLM"] = "llm";
+  DextoLogComponent2["CONFIG"] = "config";
+  DextoLogComponent2["CONTEXT"] = "context";
+  DextoLogComponent2["SESSION"] = "session";
+  DextoLogComponent2["MCP"] = "mcp";
+  DextoLogComponent2["TOOLS"] = "tools";
+  DextoLogComponent2["STORAGE"] = "storage";
+  DextoLogComponent2["SYSTEM_PROMPT"] = "system_prompt";
+  DextoLogComponent2["RESOURCE"] = "resource";
+  DextoLogComponent2["PROMPT"] = "prompt";
+  DextoLogComponent2["MEMORY"] = "memory";
+  DextoLogComponent2["PLUGIN"] = "plugin";
+  DextoLogComponent2["FILESYSTEM"] = "filesystem";
+  DextoLogComponent2["PROCESS"] = "process";
+  DextoLogComponent2["APPROVAL"] = "approval";
+  DextoLogComponent2["API"] = "api";
+  DextoLogComponent2["CLI"] = "cli";
+  DextoLogComponent2["TELEMETRY"] = "telemetry";
+  return DextoLogComponent2;
+})(DextoLogComponent || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DextoLogComponent
+});

package/dist/logger/v2/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Logger Types and Interfaces
+ *
+ * Defines the core abstractions for the multi-transport logger architecture.
+ * Based on Mastra's transport pattern with Dexto-specific adaptations.
+ */
+/**
+ * Log levels in order of severity
+ * Following Winston convention: error < warn < info < debug < silly
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silly';
+/**
+ * Component identifiers for structured logging
+ * Mirrors ErrorScope for consistency, with additional execution context components
+ */
+export declare enum DextoLogComponent {
+    AGENT = "agent",
+    LLM = "llm",
+    CONFIG = "config",
+    CONTEXT = "context",
+    SESSION = "session",
+    MCP = "mcp",
+    TOOLS = "tools",
+    STORAGE = "storage",
+    SYSTEM_PROMPT = "system_prompt",
+    RESOURCE = "resource",
+    PROMPT = "prompt",
+    MEMORY = "memory",
+    PLUGIN = "plugin",
+    FILESYSTEM = "filesystem",
+    PROCESS = "process",
+    APPROVAL = "approval",
+    API = "api",
+    CLI = "cli",
+    TELEMETRY = "telemetry"
+}
+/**
+ * Structured log entry
+ * All logs are converted to this format before being sent to transports
+ */
+export interface LogEntry {
+    /** Log level */
+    level: LogLevel;
+    /** Primary log message */
+    message: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Component that generated the log */
+    component: DextoLogComponent;
+    /** Agent ID for multi-agent isolation */
+    agentId: string;
+    /** Optional structured context data */
+    context?: Record<string, unknown> | undefined;
+}
+/**
+ * Logger interface
+ * All logger implementations must implement this interface
+ */
+export interface IDextoLogger {
+    /**
+     * Log debug message
+     * @param message Log message
+     * @param context Optional structured context
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log silly message (most verbose, for detailed debugging like full JSON dumps)
+     * @param message Log message
+     * @param context Optional structured context
+     */
+    silly(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log info message
+     * @param message Log message
+     * @param context Optional structured context
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log warning message
+     * @param message Log message
+     * @param context Optional structured context
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error message
+     * @param message Log message
+     * @param context Optional structured context
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Track exception with stack trace
+     * @param error Error object
+     * @param context Optional additional context
+     */
+    trackException(error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with a different component
+     * Shares the same transports, agentId, and level but uses a different component identifier
+     * @param component Component identifier for the child logger
+     * @returns New logger instance with specified component
+     */
+    createChild(component: DextoLogComponent): IDextoLogger;
+    /**
+     * Cleanup resources and close transports
+     */
+    destroy(): Promise<void>;
+}
+/**
+ * Base transport interface
+ * All transport implementations must implement this interface
+ */
+export interface ILoggerTransport {
+    /**
+     * Write a log entry to the transport
+     * @param entry Structured log entry
+     */
+    write(entry: LogEntry): void | Promise<void>;
+    /**
+     * Cleanup resources when logger is destroyed
+     */
+    destroy?(): void | Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/logger/v2/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/logger/v2/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE;;;GAGG;AACH,oBAAY,iBAAiB;IAEzB,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,QAAQ,aAAa;IAGrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,SAAS,cAAc;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,gBAAgB;IAChB,KAAK,EAAE,QAAQ,CAAC;IAChB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACjD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE/D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEhE;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEtE;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,iBAAiB,GAAG,YAAY,CAAC;IAExD;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;OAEG;IACH,OAAO,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC"}

package/dist/logger/v2/types.js

@@ -0,0 +1,26 @@
+import "../../chunk-C6A6W6XS.js";
+var DextoLogComponent = /* @__PURE__ */ ((DextoLogComponent2) => {
+  DextoLogComponent2["AGENT"] = "agent";
+  DextoLogComponent2["LLM"] = "llm";
+  DextoLogComponent2["CONFIG"] = "config";
+  DextoLogComponent2["CONTEXT"] = "context";
+  DextoLogComponent2["SESSION"] = "session";
+  DextoLogComponent2["MCP"] = "mcp";
+  DextoLogComponent2["TOOLS"] = "tools";
+  DextoLogComponent2["STORAGE"] = "storage";
+  DextoLogComponent2["SYSTEM_PROMPT"] = "system_prompt";
+  DextoLogComponent2["RESOURCE"] = "resource";
+  DextoLogComponent2["PROMPT"] = "prompt";
+  DextoLogComponent2["MEMORY"] = "memory";
+  DextoLogComponent2["PLUGIN"] = "plugin";
+  DextoLogComponent2["FILESYSTEM"] = "filesystem";
+  DextoLogComponent2["PROCESS"] = "process";
+  DextoLogComponent2["APPROVAL"] = "approval";
+  DextoLogComponent2["API"] = "api";
+  DextoLogComponent2["CLI"] = "cli";
+  DextoLogComponent2["TELEMETRY"] = "telemetry";
+  return DextoLogComponent2;
+})(DextoLogComponent || {});
+export {
+  DextoLogComponent
+};