@mastra/loggers 1.3.9-alpha.2 → 1.3.9

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-loggers
 description: Documentation for @mastra/loggers. Use when working with @mastra/loggers APIs, configuration, or implementation.
 metadata:
   package: "@mastra/loggers"
-  version: "1.3.9-alpha.2"
+  version: "1.3.9"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.9-alpha.2",
+  "version": "1.3.9",
   "package": "@mastra/loggers",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-core-mastra-class.md

@@ -147,9 +147,9 @@ Re-drives every orphaned `running` durable-agent run across all registered durab
 
 Requires persistent storage. With an in-memory store, there's nothing to recover after a process restart.
 
-Agents and their runs are attempted serially. Each built-in `recoverActiveRuns()` attempt waits up to 30 seconds in total for `recover()` setup and settlement of the whole recovered workflow, then traversal can continue to later runs and agents. This isn't an overall recovery deadline: discovery and overridden custom recovery methods aren't bounded by this budget.
+Recovery processes up to five agents concurrently, with up to five run waits per agent, independently of `recovery.workflowConcurrency`. Each built-in `recoverActiveRuns()` attempt waits up to 30 seconds in total for `recover()` setup and settlement of the whole recovered workflow, then frees its slot for another run. These limits bound waiting, not live executions. This isn't an overall recovery deadline: discovery and overridden custom recovery methods aren't bounded by this budget.
 
-A timed-out attempt continues in the background. Its outcome is `status: 'skipped'` with `reason: 'recovery-timeout'` and no `retryAt`. It contributes only to `skipped`, not `recovered`, `succeeded`, or `failed`, and Mastra doesn't automatically retry it. Late settlement doesn't change the returned counts.
+A timed-out attempt continues in the background. Its outcome is `status: 'skipped'` with `reason: 'recovery-timeout'` and a future `retryAt`. It contributes only to `skipped`, not `recovered`, `succeeded`, or `failed`. Mastra schedules re-checks automatically. While the original attempt is pending, re-checks defer without starting another execution. After it settles, recovery checks the persisted snapshot and ownership before retrying; finished or suspended runs aren't restarted. Late settlement doesn't change the returned counts.
 
 When shutdown begins, recovery stops dispatching new agents and runs. The recovery traversal and original attempts, including timed-out setup or execution, participate in the same shared shutdown drain as active executions. A recovery wait timeout doesn't cancel the attempt or give it a separate shutdown drain window.
 

package/dist/file/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["LoggerTransport","#queryLogs","MastraError","ErrorDomain","ErrorCategory","normalizePagination"],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createReadStream, createWriteStream, existsSync, statSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { ErrorCategory, ErrorDomain, MastraError } from '@mastra/core/error';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\nimport { normalizePagination } from '../pagination';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      throw new Error('File path does not exist');\n    }\n\n    if (!statSync(this.path).isFile()) {\n      throw new Error(`File path must point to a file: ${this.path}`);\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n    // Without a listener, the file stream's 'error' event would crash the process.\n    // Write failures already reach the transport through the write callback, so only\n    // forward errors that have not destroyed the transport yet (e.g. open failures).\n    this.fileStream.on('error', error => {\n      if (!this.destroyed) this.destroy(error);\n    });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk?: any) => void) {\n    try {\n      this.fileStream.write(chunk, error => {\n        if (error) callback(error);\n        else callback(null, chunk);\n      });\n    } catch (error) {\n      callback(error as Error);\n    }\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(params?.page, params?.perPage);\n    try {\n      return await this.#queryLogs(params || {});\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path },\n        },\n        error,\n      );\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(page, perPage);\n    try {\n      return await this.#queryLogs({ runId, fromDate, toDate, logLevel, filters, page, perPage });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_BY_RUN_ID_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path, runId },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Streams the log file line by line, counting every matching record but\n   * retaining only the requested page (or all matches when pagination is off).\n   */\n  async #queryLogs({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    returnPaginationResults = true,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId?: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }) {\n    const { page, perPage, start, end } = normalizePagination(pageInput, perPageInput);\n    const filterEntries = Object.entries(filters ?? {});\n\n    const logs: BaseLogMessage[] = [];\n    let total = 0;\n\n    const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });\n    for await (const line of lines) {\n      if (!line.trim()) continue;\n\n      let log: any;\n      try {\n        log = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      if (log === null || typeof log !== 'object') continue;\n      if (runId !== undefined && log.runId !== runId) continue;\n      if (!filterEntries.every(([key, value]) => log[key] === value)) continue;\n      if (logLevel && log.level !== logLevel) continue;\n      if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;\n      if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;\n\n      if (!returnPaginationResults || (total >= start && total < end)) {\n        logs.push(log);\n      }\n      total++;\n    }\n\n    if (!returnPaginationResults) {\n      return { logs, total, page, perPage: total, hasMore: false };\n    }\n\n    return { logs, total, page, perPage, hasMore: end < total };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["LoggerTransport","existsSync","statSync","createWriteStream","MastraError","ErrorDomain","ErrorCategory","normalizePagination","createInterface","createReadStream"],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createReadStream, createWriteStream, existsSync, statSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { ErrorCategory, ErrorDomain, MastraError } from '@mastra/core/error';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\nimport { normalizePagination } from '../pagination';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      throw new Error('File path does not exist');\n    }\n\n    if (!statSync(this.path).isFile()) {\n      throw new Error(`File path must point to a file: ${this.path}`);\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n    // Without a listener, the file stream's 'error' event would crash the process.\n    // Write failures already reach the transport through the write callback, so only\n    // forward errors that have not destroyed the transport yet (e.g. open failures).\n    this.fileStream.on('error', error => {\n      if (!this.destroyed) this.destroy(error);\n    });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk?: any) => void) {\n    try {\n      this.fileStream.write(chunk, error => {\n        if (error) callback(error);\n        else callback(null, chunk);\n      });\n    } catch (error) {\n      callback(error as Error);\n    }\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(params?.page, params?.perPage);\n    try {\n      return await this.#queryLogs(params || {});\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path },\n        },\n        error,\n      );\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(page, perPage);\n    try {\n      return await this.#queryLogs({ runId, fromDate, toDate, logLevel, filters, page, perPage });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_BY_RUN_ID_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path, runId },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Streams the log file line by line, counting every matching record but\n   * retaining only the requested page (or all matches when pagination is off).\n   */\n  async #queryLogs({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    returnPaginationResults = true,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId?: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }) {\n    const { page, perPage, start, end } = normalizePagination(pageInput, perPageInput);\n    const filterEntries = Object.entries(filters ?? {});\n\n    const logs: BaseLogMessage[] = [];\n    let total = 0;\n\n    const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });\n    for await (const line of lines) {\n      if (!line.trim()) continue;\n\n      let log: any;\n      try {\n        log = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      if (log === null || typeof log !== 'object') continue;\n      if (runId !== undefined && log.runId !== runId) continue;\n      if (!filterEntries.every(([key, value]) => log[key] === value)) continue;\n      if (logLevel && log.level !== logLevel) continue;\n      if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;\n      if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;\n\n      if (!returnPaginationResults || (total >= start && total < end)) {\n        logs.push(log);\n      }\n      total++;\n    }\n\n    if (!returnPaginationResults) {\n      return { logs, total, page, perPage: total, hasMore: false };\n    }\n\n    return { logs, total, page, perPage, hasMore: end < total };\n  }\n}\n"],"mappings":"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"}

package/dist/file/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#queryLogs"],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createReadStream, createWriteStream, existsSync, statSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { ErrorCategory, ErrorDomain, MastraError } from '@mastra/core/error';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\nimport { normalizePagination } from '../pagination';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      throw new Error('File path does not exist');\n    }\n\n    if (!statSync(this.path).isFile()) {\n      throw new Error(`File path must point to a file: ${this.path}`);\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n    // Without a listener, the file stream's 'error' event would crash the process.\n    // Write failures already reach the transport through the write callback, so only\n    // forward errors that have not destroyed the transport yet (e.g. open failures).\n    this.fileStream.on('error', error => {\n      if (!this.destroyed) this.destroy(error);\n    });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk?: any) => void) {\n    try {\n      this.fileStream.write(chunk, error => {\n        if (error) callback(error);\n        else callback(null, chunk);\n      });\n    } catch (error) {\n      callback(error as Error);\n    }\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(params?.page, params?.perPage);\n    try {\n      return await this.#queryLogs(params || {});\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path },\n        },\n        error,\n      );\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(page, perPage);\n    try {\n      return await this.#queryLogs({ runId, fromDate, toDate, logLevel, filters, page, perPage });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_BY_RUN_ID_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path, runId },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Streams the log file line by line, counting every matching record but\n   * retaining only the requested page (or all matches when pagination is off).\n   */\n  async #queryLogs({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    returnPaginationResults = true,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId?: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }) {\n    const { page, perPage, start, end } = normalizePagination(pageInput, perPageInput);\n    const filterEntries = Object.entries(filters ?? {});\n\n    const logs: BaseLogMessage[] = [];\n    let total = 0;\n\n    const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });\n    for await (const line of lines) {\n      if (!line.trim()) continue;\n\n      let log: any;\n      try {\n        log = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      if (log === null || typeof log !== 'object') continue;\n      if (runId !== undefined && log.runId !== runId) continue;\n      if (!filterEntries.every(([key, value]) => log[key] === value)) continue;\n      if (logLevel && log.level !== logLevel) continue;\n      if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;\n      if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;\n\n      if (!returnPaginationResults || (total >= start && total < end)) {\n        logs.push(log);\n      }\n      total++;\n    }\n\n    if (!returnPaginationResults) {\n      return { logs, total, page, perPage: total, hasMore: false };\n    }\n\n    return { logs, total, page, perPage, hasMore: end < total };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createReadStream, createWriteStream, existsSync, statSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { ErrorCategory, ErrorDomain, MastraError } from '@mastra/core/error';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\nimport { normalizePagination } from '../pagination';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      throw new Error('File path does not exist');\n    }\n\n    if (!statSync(this.path).isFile()) {\n      throw new Error(`File path must point to a file: ${this.path}`);\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n    // Without a listener, the file stream's 'error' event would crash the process.\n    // Write failures already reach the transport through the write callback, so only\n    // forward errors that have not destroyed the transport yet (e.g. open failures).\n    this.fileStream.on('error', error => {\n      if (!this.destroyed) this.destroy(error);\n    });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk?: any) => void) {\n    try {\n      this.fileStream.write(chunk, error => {\n        if (error) callback(error);\n        else callback(null, chunk);\n      });\n    } catch (error) {\n      callback(error as Error);\n    }\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(params?.page, params?.perPage);\n    try {\n      return await this.#queryLogs(params || {});\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path },\n        },\n        error,\n      );\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    normalizePagination(page, perPage);\n    try {\n      return await this.#queryLogs({ runId, fromDate, toDate, logLevel, filters, page, perPage });\n    } catch (error) {\n      throw new MastraError(\n        {\n          id: 'FILE_TRANSPORT_LIST_LOGS_BY_RUN_ID_FAILED',\n          domain: ErrorDomain.MASTRA_OBSERVABILITY,\n          category: ErrorCategory.SYSTEM,\n          details: { path: this.path, runId },\n        },\n        error,\n      );\n    }\n  }\n\n  /**\n   * Streams the log file line by line, counting every matching record but\n   * retaining only the requested page (or all matches when pagination is off).\n   */\n  async #queryLogs({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    returnPaginationResults = true,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId?: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }) {\n    const { page, perPage, start, end } = normalizePagination(pageInput, perPageInput);\n    const filterEntries = Object.entries(filters ?? {});\n\n    const logs: BaseLogMessage[] = [];\n    let total = 0;\n\n    const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });\n    for await (const line of lines) {\n      if (!line.trim()) continue;\n\n      let log: any;\n      try {\n        log = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      if (log === null || typeof log !== 'object') continue;\n      if (runId !== undefined && log.runId !== runId) continue;\n      if (!filterEntries.every(([key, value]) => log[key] === value)) continue;\n      if (logLevel && log.level !== logLevel) continue;\n      if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;\n      if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;\n\n      if (!returnPaginationResults || (total >= start && total < end)) {\n        logs.push(log);\n      }\n      total++;\n    }\n\n    if (!returnPaginationResults) {\n      return { logs, total, page, perPage: total, hasMore: false };\n    }\n\n    return { logs, total, page, perPage, hasMore: end < total };\n  }\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -16,7 +16,7 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["MastraLogger","#adapterContextRef","LogLevel","#export"],"sources":["../src/pino.ts"],"sourcesContent":["import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n  /**\n   * Custom pino serializers, merged over Mastra's defaults.\n   * By default the `error` key is serialized with pino's standard error\n   * serializer (alongside pino's built-in `err`), so that\n   * `logger.warn('...', { error })` records the message and stack rather\n   * than an empty object.\n   */\n  serializers?: pino.LoggerOptions['serializers'];\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n  /** @internal Shared adapter-context ref so root and children correlate together */\n  _adapterContextRef?: { current?: LoggerAdapterContext };\n}\n\n/**\n * Provides Pino-backed logging for Mastra applications.\n *\n * @example\n * ```typescript\n * import { Mastra } from '@mastra/core/mastra';\n * import { PinoLogger } from '@mastra/loggers';\n *\n * const mastra = new Mastra({\n *   logger: new PinoLogger({ name: 'my-app', level: 'info' }),\n * });\n * ```\n *\n * @see For documentation bundled with your installed package, locate\n * `@mastra/loggers/package.json` with your project's resolver or package-manager\n * tooling, then read `dist/docs/SKILL.md` from that package root and follow its\n * reference links. Use package-manager tools for virtual or archived packages.\n *\n * @see [Pino logger documentation](https://mastra.ai/reference/logging/pino-logger)\n * if packaged docs are unavailable.\n */\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n  // Mutable ref shared with child loggers: the root's mixin (which children's\n  // pino instances inherit) reads through this ref, so attaching observability\n  // to a child (e.g. `new Mastra({ logger: base.child({...}) })`) correlates\n  // the records it actually logs through.\n  #adapterContextRef: { current?: LoggerAdapterContext };\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n    this.#adapterContextRef = internalOptions._adapterContextRef ?? {};\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    // Compose the user mixin with trace correlation. Pino mixins run\n    // synchronously on every log call, so the trace fields land in the\n    // native record before serialization — for ALL destinations (stdout,\n    // transports, files). Trace fields win on key conflicts.\n    const userMixin = options.mixin;\n    const correlationMixin: pino.MixinFn<CustomLevels> = (mergeObject, level, logger) => {\n      const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};\n      const ctx = this.#adapterContextRef.current;\n      if (!ctx?.options.correlation) return userFields;\n      try {\n        return { ...userFields, ...(ctx.resolveTraceFields() ?? {}) };\n      } catch {\n        return userFields;\n      }\n    };\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: correlationMixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n        // Pino applies its error serializer only to `errorKey` (default `err`).\n        // Mastra logs errors as `{ error }` throughout, and an Error's `message`\n        // and `stack` are non-enumerable, so without this they serialize to `{}`.\n        serializers: { error: pino.stdSerializers.err, ...options.serializers },\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n      _adapterContextRef: this.#adapterContextRef,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  /**\n   * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables\n   * native trace correlation (trace_id/span_id merged into the pino record\n   * via mixin, for every destination) and observability export derived from\n   * the same record. Called by Mastra during setup.\n   */\n  __attachObservability(ctx: LoggerAdapterContext): void {\n    // Shared ref: attaching to a child also enables correlation on the root\n    // mixin the child's records flow through (and vice versa).\n    this.#adapterContextRef.current = ctx;\n  }\n\n  /**\n   * The adapter context lives on the ref cell shared by the whole\n   * root/child family, so re-attach detection (multi-Mastra warning) must\n   * key on that cell — attaching to a child re-targets the root too.\n   */\n  __observabilityAttachmentKey(): object {\n    return this.#adapterContextRef;\n  }\n\n  /**\n   * Export the record derived from the same native call to observability.\n   * Runs regardless of pino's level filter and never throws into the caller.\n   */\n  #export(level: 'debug' | 'info' | 'warn' | 'error', message: string, args: Record<string, any>): void {\n    const ctx = this.#adapterContextRef.current;\n    if (!ctx?.options.export) return;\n    try {\n      // An Error passed as the args value often has no enumerable keys but\n      // must still be exported (serialized by buildLogRecordData).\n      const hasPayload = args instanceof Error || Object.keys(args).length > 0;\n      // Trace identity travels on ExportedLog.traceId/spanId (the sink is\n      // span-correlated); data stays reserved for the user payload. The mixin\n      // still injects trace fields into the native pino record for stdout.\n      ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));\n    } catch {\n      // Never let observability export break the primary logger\n    }\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n    this.#export('debug', message, args);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n    this.#export('info', message, args);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n    this.#export('warn', message, args);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n    this.#export('error', message, args);\n  }\n\n  override trackException(error: Error, metadata?: Record<string, unknown>): void {\n    exportTrackedException(this.#adapterContextRef.current, error, metadata);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["MastraLogger","pretty","LogLevel","buildLogRecordData"],"sources":["../src/pino.ts"],"sourcesContent":["import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n  /**\n   * Custom pino serializers, merged over Mastra's defaults.\n   * By default the `error` key is serialized with pino's standard error\n   * serializer (alongside pino's built-in `err`), so that\n   * `logger.warn('...', { error })` records the message and stack rather\n   * than an empty object.\n   */\n  serializers?: pino.LoggerOptions['serializers'];\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n  /** @internal Shared adapter-context ref so root and children correlate together */\n  _adapterContextRef?: { current?: LoggerAdapterContext };\n}\n\n/**\n * Provides Pino-backed logging for Mastra applications.\n *\n * @example\n * ```typescript\n * import { Mastra } from '@mastra/core/mastra';\n * import { PinoLogger } from '@mastra/loggers';\n *\n * const mastra = new Mastra({\n *   logger: new PinoLogger({ name: 'my-app', level: 'info' }),\n * });\n * ```\n *\n * @see For documentation bundled with your installed package, locate\n * `@mastra/loggers/package.json` with your project's resolver or package-manager\n * tooling, then read `dist/docs/SKILL.md` from that package root and follow its\n * reference links. Use package-manager tools for virtual or archived packages.\n *\n * @see [Pino logger documentation](https://mastra.ai/reference/logging/pino-logger)\n * if packaged docs are unavailable.\n */\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n  // Mutable ref shared with child loggers: the root's mixin (which children's\n  // pino instances inherit) reads through this ref, so attaching observability\n  // to a child (e.g. `new Mastra({ logger: base.child({...}) })`) correlates\n  // the records it actually logs through.\n  #adapterContextRef: { current?: LoggerAdapterContext };\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n    this.#adapterContextRef = internalOptions._adapterContextRef ?? {};\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    // Compose the user mixin with trace correlation. Pino mixins run\n    // synchronously on every log call, so the trace fields land in the\n    // native record before serialization — for ALL destinations (stdout,\n    // transports, files). Trace fields win on key conflicts.\n    const userMixin = options.mixin;\n    const correlationMixin: pino.MixinFn<CustomLevels> = (mergeObject, level, logger) => {\n      const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};\n      const ctx = this.#adapterContextRef.current;\n      if (!ctx?.options.correlation) return userFields;\n      try {\n        return { ...userFields, ...(ctx.resolveTraceFields() ?? {}) };\n      } catch {\n        return userFields;\n      }\n    };\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: correlationMixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n        // Pino applies its error serializer only to `errorKey` (default `err`).\n        // Mastra logs errors as `{ error }` throughout, and an Error's `message`\n        // and `stack` are non-enumerable, so without this they serialize to `{}`.\n        serializers: { error: pino.stdSerializers.err, ...options.serializers },\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n      _adapterContextRef: this.#adapterContextRef,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  /**\n   * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables\n   * native trace correlation (trace_id/span_id merged into the pino record\n   * via mixin, for every destination) and observability export derived from\n   * the same record. Called by Mastra during setup.\n   */\n  __attachObservability(ctx: LoggerAdapterContext): void {\n    // Shared ref: attaching to a child also enables correlation on the root\n    // mixin the child's records flow through (and vice versa).\n    this.#adapterContextRef.current = ctx;\n  }\n\n  /**\n   * The adapter context lives on the ref cell shared by the whole\n   * root/child family, so re-attach detection (multi-Mastra warning) must\n   * key on that cell — attaching to a child re-targets the root too.\n   */\n  __observabilityAttachmentKey(): object {\n    return this.#adapterContextRef;\n  }\n\n  /**\n   * Export the record derived from the same native call to observability.\n   * Runs regardless of pino's level filter and never throws into the caller.\n   */\n  #export(level: 'debug' | 'info' | 'warn' | 'error', message: string, args: Record<string, any>): void {\n    const ctx = this.#adapterContextRef.current;\n    if (!ctx?.options.export) return;\n    try {\n      // An Error passed as the args value often has no enumerable keys but\n      // must still be exported (serialized by buildLogRecordData).\n      const hasPayload = args instanceof Error || Object.keys(args).length > 0;\n      // Trace identity travels on ExportedLog.traceId/spanId (the sink is\n      // span-correlated); data stays reserved for the user payload. The mixin\n      // still injects trace fields into the native pino record for stdout.\n      ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));\n    } catch {\n      // Never let observability export break the primary logger\n    }\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n    this.#export('debug', message, args);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n    this.#export('info', message, args);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n    this.#export('warn', message, args);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n    this.#export('error', message, args);\n  }\n\n  override trackException(error: Error, metadata?: Record<string, unknown>): void {\n    exportTrackedException(this.#adapterContextRef.current, error, metadata);\n  }\n}\n"],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#adapterContextRef","#export"],"sources":["../src/pino.ts"],"sourcesContent":["import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n  /**\n   * Custom pino serializers, merged over Mastra's defaults.\n   * By default the `error` key is serialized with pino's standard error\n   * serializer (alongside pino's built-in `err`), so that\n   * `logger.warn('...', { error })` records the message and stack rather\n   * than an empty object.\n   */\n  serializers?: pino.LoggerOptions['serializers'];\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n  /** @internal Shared adapter-context ref so root and children correlate together */\n  _adapterContextRef?: { current?: LoggerAdapterContext };\n}\n\n/**\n * Provides Pino-backed logging for Mastra applications.\n *\n * @example\n * ```typescript\n * import { Mastra } from '@mastra/core/mastra';\n * import { PinoLogger } from '@mastra/loggers';\n *\n * const mastra = new Mastra({\n *   logger: new PinoLogger({ name: 'my-app', level: 'info' }),\n * });\n * ```\n *\n * @see For documentation bundled with your installed package, locate\n * `@mastra/loggers/package.json` with your project's resolver or package-manager\n * tooling, then read `dist/docs/SKILL.md` from that package root and follow its\n * reference links. Use package-manager tools for virtual or archived packages.\n *\n * @see [Pino logger documentation](https://mastra.ai/reference/logging/pino-logger)\n * if packaged docs are unavailable.\n */\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n  // Mutable ref shared with child loggers: the root's mixin (which children's\n  // pino instances inherit) reads through this ref, so attaching observability\n  // to a child (e.g. `new Mastra({ logger: base.child({...}) })`) correlates\n  // the records it actually logs through.\n  #adapterContextRef: { current?: LoggerAdapterContext };\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n    this.#adapterContextRef = internalOptions._adapterContextRef ?? {};\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    // Compose the user mixin with trace correlation. Pino mixins run\n    // synchronously on every log call, so the trace fields land in the\n    // native record before serialization — for ALL destinations (stdout,\n    // transports, files). Trace fields win on key conflicts.\n    const userMixin = options.mixin;\n    const correlationMixin: pino.MixinFn<CustomLevels> = (mergeObject, level, logger) => {\n      const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};\n      const ctx = this.#adapterContextRef.current;\n      if (!ctx?.options.correlation) return userFields;\n      try {\n        return { ...userFields, ...(ctx.resolveTraceFields() ?? {}) };\n      } catch {\n        return userFields;\n      }\n    };\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: correlationMixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n        // Pino applies its error serializer only to `errorKey` (default `err`).\n        // Mastra logs errors as `{ error }` throughout, and an Error's `message`\n        // and `stack` are non-enumerable, so without this they serialize to `{}`.\n        serializers: { error: pino.stdSerializers.err, ...options.serializers },\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n      _adapterContextRef: this.#adapterContextRef,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  /**\n   * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables\n   * native trace correlation (trace_id/span_id merged into the pino record\n   * via mixin, for every destination) and observability export derived from\n   * the same record. Called by Mastra during setup.\n   */\n  __attachObservability(ctx: LoggerAdapterContext): void {\n    // Shared ref: attaching to a child also enables correlation on the root\n    // mixin the child's records flow through (and vice versa).\n    this.#adapterContextRef.current = ctx;\n  }\n\n  /**\n   * The adapter context lives on the ref cell shared by the whole\n   * root/child family, so re-attach detection (multi-Mastra warning) must\n   * key on that cell — attaching to a child re-targets the root too.\n   */\n  __observabilityAttachmentKey(): object {\n    return this.#adapterContextRef;\n  }\n\n  /**\n   * Export the record derived from the same native call to observability.\n   * Runs regardless of pino's level filter and never throws into the caller.\n   */\n  #export(level: 'debug' | 'info' | 'warn' | 'error', message: string, args: Record<string, any>): void {\n    const ctx = this.#adapterContextRef.current;\n    if (!ctx?.options.export) return;\n    try {\n      // An Error passed as the args value often has no enumerable keys but\n      // must still be exported (serialized by buildLogRecordData).\n      const hasPayload = args instanceof Error || Object.keys(args).length > 0;\n      // Trace identity travels on ExportedLog.traceId/spanId (the sink is\n      // span-correlated); data stays reserved for the user payload. The mixin\n      // still injects trace fields into the native pino record for stdout.\n      ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));\n    } catch {\n      // Never let observability export break the primary logger\n    }\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n    this.#export('debug', message, args);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n    this.#export('info', message, args);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n    this.#export('warn', message, args);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n    this.#export('error', message, args);\n  }\n\n  override trackException(error: Error, metadata?: Record<string, unknown>): void {\n    exportTrackedException(this.#adapterContextRef.current, error, metadata);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/pino.ts"],"sourcesContent":["import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n  /**\n   * Custom pino serializers, merged over Mastra's defaults.\n   * By default the `error` key is serialized with pino's standard error\n   * serializer (alongside pino's built-in `err`), so that\n   * `logger.warn('...', { error })` records the message and stack rather\n   * than an empty object.\n   */\n  serializers?: pino.LoggerOptions['serializers'];\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n  /** @internal Shared adapter-context ref so root and children correlate together */\n  _adapterContextRef?: { current?: LoggerAdapterContext };\n}\n\n/**\n * Provides Pino-backed logging for Mastra applications.\n *\n * @example\n * ```typescript\n * import { Mastra } from '@mastra/core/mastra';\n * import { PinoLogger } from '@mastra/loggers';\n *\n * const mastra = new Mastra({\n *   logger: new PinoLogger({ name: 'my-app', level: 'info' }),\n * });\n * ```\n *\n * @see For documentation bundled with your installed package, locate\n * `@mastra/loggers/package.json` with your project's resolver or package-manager\n * tooling, then read `dist/docs/SKILL.md` from that package root and follow its\n * reference links. Use package-manager tools for virtual or archived packages.\n *\n * @see [Pino logger documentation](https://mastra.ai/reference/logging/pino-logger)\n * if packaged docs are unavailable.\n */\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n  // Mutable ref shared with child loggers: the root's mixin (which children's\n  // pino instances inherit) reads through this ref, so attaching observability\n  // to a child (e.g. `new Mastra({ logger: base.child({...}) })`) correlates\n  // the records it actually logs through.\n  #adapterContextRef: { current?: LoggerAdapterContext };\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n    this.#adapterContextRef = internalOptions._adapterContextRef ?? {};\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    // Compose the user mixin with trace correlation. Pino mixins run\n    // synchronously on every log call, so the trace fields land in the\n    // native record before serialization — for ALL destinations (stdout,\n    // transports, files). Trace fields win on key conflicts.\n    const userMixin = options.mixin;\n    const correlationMixin: pino.MixinFn<CustomLevels> = (mergeObject, level, logger) => {\n      const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};\n      const ctx = this.#adapterContextRef.current;\n      if (!ctx?.options.correlation) return userFields;\n      try {\n        return { ...userFields, ...(ctx.resolveTraceFields() ?? {}) };\n      } catch {\n        return userFields;\n      }\n    };\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: correlationMixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n        // Pino applies its error serializer only to `errorKey` (default `err`).\n        // Mastra logs errors as `{ error }` throughout, and an Error's `message`\n        // and `stack` are non-enumerable, so without this they serialize to `{}`.\n        serializers: { error: pino.stdSerializers.err, ...options.serializers },\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n      _adapterContextRef: this.#adapterContextRef,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  /**\n   * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables\n   * native trace correlation (trace_id/span_id merged into the pino record\n   * via mixin, for every destination) and observability export derived from\n   * the same record. Called by Mastra during setup.\n   */\n  __attachObservability(ctx: LoggerAdapterContext): void {\n    // Shared ref: attaching to a child also enables correlation on the root\n    // mixin the child's records flow through (and vice versa).\n    this.#adapterContextRef.current = ctx;\n  }\n\n  /**\n   * The adapter context lives on the ref cell shared by the whole\n   * root/child family, so re-attach detection (multi-Mastra warning) must\n   * key on that cell — attaching to a child re-targets the root too.\n   */\n  __observabilityAttachmentKey(): object {\n    return this.#adapterContextRef;\n  }\n\n  /**\n   * Export the record derived from the same native call to observability.\n   * Runs regardless of pino's level filter and never throws into the caller.\n   */\n  #export(level: 'debug' | 'info' | 'warn' | 'error', message: string, args: Record<string, any>): void {\n    const ctx = this.#adapterContextRef.current;\n    if (!ctx?.options.export) return;\n    try {\n      // An Error passed as the args value often has no enumerable keys but\n      // must still be exported (serialized by buildLogRecordData).\n      const hasPayload = args instanceof Error || Object.keys(args).length > 0;\n      // Trace identity travels on ExportedLog.traceId/spanId (the sink is\n      // span-correlated); data stays reserved for the user payload. The mixin\n      // still injects trace fields into the native pino record for stdout.\n      ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));\n    } catch {\n      // Never let observability export break the primary logger\n    }\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n    this.#export('debug', message, args);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n    this.#export('info', message, args);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n    this.#export('warn', message, args);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n    this.#export('error', message, args);\n  }\n\n  override trackException(error: Error, metadata?: Record<string, unknown>): void {\n    exportTrackedException(this.#adapterContextRef.current, error, metadata);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/loggers",
-  "version": "1.3.9-alpha.2",
+  "version": "1.3.9",
   "description": "",
   "type": "module",
   "files": [
@@ -75,9 +75,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.11",
-    "@internal/lint": "0.0.144",
-    "@internal/types-builder": "0.0.119",
-    "@mastra/core": "1.79.0-alpha.6"
+    "@internal/lint": "0.0.145",
+    "@mastra/core": "1.79.0",
+    "@internal/types-builder": "0.0.120"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"