@mastra/deployer 1.80.0-alpha.7 → 1.81.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/dist/_types/@internal_core/dist/base/index.d.ts +28 -0
  2. package/dist/_types/@internal_core/dist/index-Diz1p9N7.d.ts +316 -0
  3. package/dist/_types/@internal_core/dist/logger/index.d.ts +2 -0
  4. package/dist/_types/@internal_core/package.json +1 -0
  5. package/dist/_types/@internal_deployer/dist/_types/@internal_core/dist/index-Diz1p9N7.d.ts +316 -0
  6. package/dist/_types/@internal_deployer/dist/_types/@internal_core/dist/logger/index.d.ts +2 -0
  7. package/dist/_types/@internal_deployer/dist/bundler.d.ts +79 -0
  8. package/dist/_types/@internal_deployer/dist/deployer.d.ts +11 -0
  9. package/dist/_types/@internal_deployer/dist/index.d.ts +4 -0
  10. package/dist/_types/@internal_deployer/package.json +1 -0
  11. package/dist/{analyze-CaR5az9N.js → analyze-BZGcfVSL.js} +5 -5
  12. package/dist/analyze-BZGcfVSL.js.map +1 -0
  13. package/dist/{analyze-CcZ2AWV3.cjs → analyze-CtWBhASF.cjs} +14 -14
  14. package/dist/analyze-CtWBhASF.cjs.map +1 -0
  15. package/dist/build/analyze/analyzeEntry.d.ts +1 -1
  16. package/dist/build/analyze/analyzeEntry.d.ts.map +1 -1
  17. package/dist/build/analyze/bundleExternals.d.ts.map +1 -1
  18. package/dist/build/analyze.cjs +1 -1
  19. package/dist/build/analyze.d.ts +4 -4
  20. package/dist/build/analyze.d.ts.map +1 -1
  21. package/dist/build/analyze.js +1 -1
  22. package/dist/build/babel/remove-all-options-except.d.ts +1 -1
  23. package/dist/build/babel/remove-all-options-except.d.ts.map +1 -1
  24. package/dist/build/bundler.cjs +1 -1
  25. package/dist/build/bundler.js +1 -1
  26. package/dist/build/bundlerOptions.d.ts +3 -3
  27. package/dist/build/bundlerOptions.d.ts.map +1 -1
  28. package/dist/build/deployer.d.ts +3 -3
  29. package/dist/build/deployer.d.ts.map +1 -1
  30. package/dist/build/index.cjs +5 -5
  31. package/dist/build/index.js +5 -5
  32. package/dist/build/plugins/esm-shim.d.ts.map +1 -1
  33. package/dist/build/plugins/remove-all-except.d.ts +1 -1
  34. package/dist/build/plugins/remove-all-except.d.ts.map +1 -1
  35. package/dist/build/serverOptions.d.ts +1 -1
  36. package/dist/build/serverOptions.d.ts.map +1 -1
  37. package/dist/build/shared/extract-mastra-option.d.ts +1 -1
  38. package/dist/build/shared/extract-mastra-option.d.ts.map +1 -1
  39. package/dist/{build-CwIzWB-q.js → build-CkZ0xUid.js} +7 -9
  40. package/dist/build-CkZ0xUid.js.map +1 -0
  41. package/dist/{build-BLhyMvzA.cjs → build-D0eiANsp.cjs} +8 -10
  42. package/dist/build-D0eiANsp.cjs.map +1 -0
  43. package/dist/bundler/index.cjs +6 -506
  44. package/dist/bundler/index.d.ts +14 -8
  45. package/dist/bundler/index.d.ts.map +1 -1
  46. package/dist/bundler/index.js +1 -498
  47. package/dist/bundler/workspaceDependencies.d.ts +1 -1
  48. package/dist/bundler/workspaceDependencies.d.ts.map +1 -1
  49. package/dist/bundler-BBi45M7f.cjs +549 -0
  50. package/dist/bundler-BBi45M7f.cjs.map +1 -0
  51. package/dist/bundler-CNgW1Vui.js +516 -0
  52. package/dist/bundler-CNgW1Vui.js.map +1 -0
  53. package/dist/{bundler-D3Ky7WCf.js → bundler-C_LpvgiH.js} +2 -2
  54. package/dist/bundler-C_LpvgiH.js.map +1 -0
  55. package/dist/{bundler-D_3GyN0N.cjs → bundler-Cb7pRVvA.cjs} +5 -5
  56. package/dist/bundler-Cb7pRVvA.cjs.map +1 -0
  57. package/dist/{bundlerOptions-Dgt4ZEo1.cjs → bundlerOptions-BBvSNHFj.cjs} +2 -2
  58. package/dist/bundlerOptions-BBvSNHFj.cjs.map +1 -0
  59. package/dist/{bundlerOptions-BtDsaIgs.js → bundlerOptions-BlUHmPBE.js} +2 -2
  60. package/dist/bundlerOptions-BlUHmPBE.js.map +1 -0
  61. package/dist/deploy/base.d.ts +1 -1
  62. package/dist/deploy/base.d.ts.map +1 -1
  63. package/dist/deploy/log.d.ts +1 -1
  64. package/dist/deploy/log.d.ts.map +1 -1
  65. package/dist/docs/SKILL.md +1 -1
  66. package/dist/docs/assets/SOURCE_MAP.json +1 -1
  67. package/dist/docs/references/docs-deployment-mastra-server.md +3 -1
  68. package/dist/error-BVvc5jcw.js +172 -0
  69. package/dist/error-BVvc5jcw.js.map +1 -0
  70. package/dist/error-CR4whExy.cjs +195 -0
  71. package/dist/error-CR4whExy.cjs.map +1 -0
  72. package/dist/index.cjs +5 -5
  73. package/dist/index.cjs.map +1 -1
  74. package/dist/index.js +4 -4
  75. package/dist/index.js.map +1 -1
  76. package/dist/server/handlers/a2a.d.ts +31 -31
  77. package/dist/server/handlers/a2a.d.ts.map +1 -1
  78. package/dist/server/handlers/client.d.ts.map +1 -1
  79. package/dist/server/index.cjs +9 -8
  80. package/dist/server/index.cjs.map +1 -1
  81. package/dist/server/index.js +9 -8
  82. package/dist/server/index.js.map +1 -1
  83. package/dist/services/deps.d.ts +2 -2
  84. package/dist/services/deps.d.ts.map +1 -1
  85. package/dist/services/env.d.ts.map +1 -1
  86. package/dist/services/fs.d.ts.map +1 -1
  87. package/dist/services/index.cjs +1 -1
  88. package/dist/services/index.js +1 -1
  89. package/dist/{services-BJQJLQs9.js → services-CXZJN9er.js} +294 -5
  90. package/dist/services-CXZJN9er.js.map +1 -0
  91. package/dist/{services-Dqx1iouv.cjs → services-CtVt5CJq.cjs} +321 -20
  92. package/dist/services-CtVt5CJq.cjs.map +1 -0
  93. package/dist/validator/validate.d.ts.map +1 -1
  94. package/package.json +14 -12
  95. package/dist/analyze-CaR5az9N.js.map +0 -1
  96. package/dist/analyze-CcZ2AWV3.cjs.map +0 -1
  97. package/dist/build-BLhyMvzA.cjs.map +0 -1
  98. package/dist/build-CwIzWB-q.js.map +0 -1
  99. package/dist/bundler/index.cjs.map +0 -1
  100. package/dist/bundler/index.js.map +0 -1
  101. package/dist/bundler-D3Ky7WCf.js.map +0 -1
  102. package/dist/bundler-D_3GyN0N.cjs.map +0 -1
  103. package/dist/bundlerOptions-BtDsaIgs.js.map +0 -1
  104. package/dist/bundlerOptions-Dgt4ZEo1.cjs.map +0 -1
  105. package/dist/services-BJQJLQs9.js.map +0 -1
  106. package/dist/services-Dqx1iouv.cjs.map +0 -1
@@ -0,0 +1,28 @@
1
+ import { i as IMastraLogger, u as RegisteredLogger } from "../index-Diz1p9N7.js";
2
+ export declare class MastraBase {
3
+ #private;
4
+ component: RegisteredLogger;
5
+ protected logger: IMastraLogger;
6
+ name?: string;
7
+ constructor({ component, name, rawConfig }: {
8
+ component?: RegisteredLogger;
9
+ name?: string;
10
+ rawConfig?: Record<string, unknown>;
11
+ });
12
+ /**
13
+ * Returns the raw storage configuration this primitive was created from,
14
+ * or undefined if it was created from code.
15
+ */
16
+ toRawConfig(): Record<string, unknown> | undefined;
17
+ /**
18
+ * Sets the raw storage configuration for this primitive.
19
+ * @internal
20
+ */
21
+ __setRawConfig(rawConfig: Record<string, unknown>): void;
22
+ /**
23
+ * Set the logger for the agent
24
+ * @param logger
25
+ */
26
+ __setLogger(logger: IMastraLogger): void;
27
+ }
28
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,316 @@
1
+ import { Transform } from "stream";
2
+ /**
3
+ * OpenTelemetry-compatible trace correlation fields, injected at the top
4
+ * level of a logger's native record.
5
+ *
6
+ * Field names are part of the platform contract (snake_case, W3C formats):
7
+ * external consumers (e.g. the Studio logs view reading Railway stdout)
8
+ * parse structured log lines and look for exactly these keys.
9
+ */
10
+ interface TraceFields {
11
+ /** 32-char lowercase hex W3C trace id */
12
+ trace_id: string;
13
+ /**
14
+ * 16-char lowercase hex W3C span id.
15
+ *
16
+ * Optional, and omitted rather than emitted empty: the active span may be
17
+ * one observability never exports (an internal span, or one dropped by
18
+ * `excludeSpanTypes`), leaving no span id a consumer could look up. The
19
+ * trace is still addressable in that case, so the line keeps `trace_id` and
20
+ * drops only this field. Consumers must treat `span_id` as possibly absent.
21
+ */
22
+ span_id?: string;
23
+ }
24
+ /**
25
+ * Destination for log records derived from the logger's native record,
26
+ * exported to Mastra observability. Structurally compatible with
27
+ * `LoggerContext` from `@mastra/core/observability`.
28
+ */
29
+ interface AdapterLogSink {
30
+ debug(message: string, data?: Record<string, unknown>): void;
31
+ info(message: string, data?: Record<string, unknown>): void;
32
+ warn(message: string, data?: Record<string, unknown>): void;
33
+ error(message: string, data?: Record<string, unknown>): void;
34
+ }
35
+ interface LoggerAdapterOptions {
36
+ /** Inject trace_id/span_id into the logger's native records. */
37
+ correlation: boolean;
38
+ /** Export records derived from the native record to Mastra observability. */
39
+ export: boolean;
40
+ }
41
+ /**
42
+ * Context handed to an adaptable logger by Mastra when observability is
43
+ * wired up. All members are safe to call on every log call (synchronous,
44
+ * never throw).
45
+ */
46
+ interface LoggerAdapterContext {
47
+ /**
48
+ * Resolve correlation fields for the currently active span, or undefined
49
+ * when no span is active (in which case no trace fields are added).
50
+ */
51
+ resolveTraceFields: () => TraceFields | undefined;
52
+ /**
53
+ * Resolve the observability log sink at call time. Returns the
54
+ * span-correlated sink when a span is active, the global sink otherwise,
55
+ * and undefined when export is disabled or observability is not
56
+ * initialized. Records must still be written to the native destination
57
+ * regardless.
58
+ */
59
+ getLogSink: () => AdapterLogSink | undefined;
60
+ options: LoggerAdapterOptions;
61
+ }
62
+ /**
63
+ * Capability marker a logger implements to opt into native trace
64
+ * correlation and observability export. When a configured logger implements
65
+ * this, Mastra attaches observability directly instead of wrapping the
66
+ * logger in the deprecated `DualLogger`.
67
+ */
68
+ interface AdaptableLogger extends IMastraLogger {
69
+ __attachObservability(ctx: LoggerAdapterContext): void;
70
+ /**
71
+ * Stable identity for the attachment target. Loggers whose adapter context
72
+ * lives in state shared across a root/child family (e.g. PinoLogger's
73
+ * mixin ref cell) return that shared object, so attaching any family
74
+ * member is recognized as re-attaching the whole family. Defaults to the
75
+ * logger instance itself when absent.
76
+ */
77
+ __observabilityAttachmentKey?(): object;
78
+ }
79
+ declare function isAdaptableLogger(logger: IMastraLogger): logger is AdaptableLogger;
80
+ /**
81
+ * Export a tracked exception through the adapter sink, mirroring the
82
+ * DualLogger dual-write shape (`errorId`/`domain`/`category`/`details`/`cause`
83
+ * when present on a MastraError-like value). Never throws into the caller.
84
+ */
85
+ declare function exportTrackedException(ctx: LoggerAdapterContext | undefined, error: Error, metadata?: Record<string, unknown>): void;
86
+ /**
87
+ * Adapt IMastraLogger's variadic args into the structured `data` payload of
88
+ * an exported log record. Extracts the first plain object as data,
89
+ * serializes an Error arg, and collects remaining primitives under `args`
90
+ * so the derived record preserves all context from the native call.
91
+ */
92
+ declare function buildLogRecordData(args: unknown[]): Record<string, unknown> | undefined;
93
+ declare const noopLogger: IMastraLogger;
94
+ declare const RegisteredLogger: {
95
+ readonly AGENT: 'AGENT';
96
+ readonly OBSERVABILITY: 'OBSERVABILITY';
97
+ readonly AUTH: 'AUTH';
98
+ readonly BROWSER: 'BROWSER';
99
+ readonly NETWORK: 'NETWORK';
100
+ readonly WORKFLOW: 'WORKFLOW';
101
+ readonly LLM: 'LLM';
102
+ readonly TTS: 'TTS';
103
+ readonly VOICE: 'VOICE';
104
+ readonly VECTOR: 'VECTOR';
105
+ readonly BUNDLER: 'BUNDLER';
106
+ readonly DEPLOYER: 'DEPLOYER';
107
+ readonly MEMORY: 'MEMORY';
108
+ readonly STORAGE: 'STORAGE';
109
+ readonly EMBEDDINGS: 'EMBEDDINGS';
110
+ readonly MCP_SERVER: 'MCP_SERVER';
111
+ readonly SERVER_CACHE: 'SERVER_CACHE';
112
+ readonly SERVER: 'SERVER';
113
+ readonly WORKSPACE: 'WORKSPACE';
114
+ readonly CHANNEL: 'CHANNEL';
115
+ };
116
+ type RegisteredLogger = (typeof RegisteredLogger)[keyof typeof RegisteredLogger];
117
+ declare const LogLevel: {
118
+ readonly DEBUG: 'debug';
119
+ readonly INFO: 'info';
120
+ readonly WARN: 'warn';
121
+ readonly ERROR: 'error';
122
+ readonly NONE: 'silent';
123
+ };
124
+ type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
125
+ interface BaseLogMessage {
126
+ runId?: string;
127
+ msg: string;
128
+ level: LogLevel;
129
+ time: Date;
130
+ pid: number;
131
+ hostname: string;
132
+ name: string;
133
+ }
134
+ declare abstract class LoggerTransport extends Transform {
135
+ constructor(opts?: any);
136
+ listLogsByRunId(_args: {
137
+ runId: string;
138
+ fromDate?: Date;
139
+ toDate?: Date;
140
+ logLevel?: LogLevel;
141
+ filters?: Record<string, any>;
142
+ page?: number;
143
+ perPage?: number;
144
+ }): Promise<{
145
+ logs: BaseLogMessage[];
146
+ total: number;
147
+ page: number;
148
+ perPage: number;
149
+ hasMore: boolean;
150
+ }>;
151
+ listLogs(_args?: {
152
+ fromDate?: Date;
153
+ toDate?: Date;
154
+ logLevel?: LogLevel;
155
+ filters?: Record<string, any>;
156
+ returnPaginationResults?: boolean;
157
+ page?: number;
158
+ perPage?: number;
159
+ }): Promise<{
160
+ logs: BaseLogMessage[];
161
+ total: number;
162
+ page: number;
163
+ perPage: number;
164
+ hasMore: boolean;
165
+ }>;
166
+ }
167
+ declare const createCustomTransport: (stream: Transform, listLogs?: LoggerTransport['listLogs'], listLogsByRunId?: LoggerTransport['listLogsByRunId']) => LoggerTransport;
168
+ interface IMastraLogger {
169
+ debug(message: string, ...args: any[]): void;
170
+ info(message: string, ...args: any[]): void;
171
+ warn(message: string, ...args: any[]): void;
172
+ error(message: string, ...args: any[]): void;
173
+ trackException(error: Error, metadata?: Record<string, unknown>): void;
174
+ getTransports(): Map<string, LoggerTransport>;
175
+ listLogs(_transportId: string, _params?: {
176
+ fromDate?: Date;
177
+ toDate?: Date;
178
+ logLevel?: LogLevel;
179
+ filters?: Record<string, any>;
180
+ page?: number;
181
+ perPage?: number;
182
+ }): Promise<{
183
+ logs: BaseLogMessage[];
184
+ total: number;
185
+ page: number;
186
+ perPage: number;
187
+ hasMore: boolean;
188
+ }>;
189
+ listLogsByRunId(_args: {
190
+ transportId: string;
191
+ runId: string;
192
+ fromDate?: Date;
193
+ toDate?: Date;
194
+ logLevel?: LogLevel;
195
+ filters?: Record<string, any>;
196
+ page?: number;
197
+ perPage?: number;
198
+ }): Promise<{
199
+ logs: BaseLogMessage[];
200
+ total: number;
201
+ page: number;
202
+ perPage: number;
203
+ hasMore: boolean;
204
+ }>;
205
+ }
206
+ declare abstract class MastraLogger implements IMastraLogger {
207
+ protected name: string;
208
+ protected level: LogLevel;
209
+ protected transports: Map<string, LoggerTransport>;
210
+ constructor(options?: {
211
+ name?: string;
212
+ level?: LogLevel;
213
+ transports?: Record<string, LoggerTransport>;
214
+ });
215
+ abstract debug(message: string, ...args: any[]): void;
216
+ abstract info(message: string, ...args: any[]): void;
217
+ abstract warn(message: string, ...args: any[]): void;
218
+ abstract error(message: string, ...args: any[]): void;
219
+ getTransports(): Map<string, LoggerTransport>;
220
+ trackException(_error: Error, _metadata?: Record<string, unknown>): void;
221
+ listLogs(transportId: string, params?: {
222
+ fromDate?: Date;
223
+ toDate?: Date;
224
+ logLevel?: LogLevel;
225
+ filters?: Record<string, any>;
226
+ page?: number;
227
+ perPage?: number;
228
+ }): Promise<{
229
+ logs: BaseLogMessage[];
230
+ total: number;
231
+ page: number;
232
+ perPage: number;
233
+ hasMore: boolean;
234
+ }>;
235
+ listLogsByRunId({ transportId, runId, fromDate, toDate, logLevel, filters, page, perPage }: {
236
+ transportId: string;
237
+ runId: string;
238
+ fromDate?: Date;
239
+ toDate?: Date;
240
+ logLevel?: LogLevel;
241
+ filters?: Record<string, any>;
242
+ page?: number;
243
+ perPage?: number;
244
+ }): Promise<{
245
+ logs: BaseLogMessage[];
246
+ total: number;
247
+ page: number;
248
+ perPage: number;
249
+ hasMore: boolean;
250
+ }>;
251
+ }
252
+ type LogFilterContext = {
253
+ component?: RegisteredLogger;
254
+ level: LogLevel;
255
+ message: string;
256
+ args: unknown[];
257
+ };
258
+ type LogFilter = (ctx: LogFilterContext) => boolean;
259
+ interface ConsoleLoggerOptions {
260
+ name?: string;
261
+ level?: LogLevel;
262
+ component?: RegisteredLogger;
263
+ filter?: LogFilter;
264
+ }
265
+ declare class ConsoleLogger extends MastraLogger {
266
+ #private;
267
+ protected component?: RegisteredLogger;
268
+ protected filter?: LogFilter;
269
+ constructor(options?: ConsoleLoggerOptions);
270
+ /**
271
+ * Adapter hook (see `AdaptableLogger`): enables native trace correlation
272
+ * (trace_id/span_id appended to console output) and observability export
273
+ * derived from the same record. Called by Mastra during setup.
274
+ */
275
+ __attachObservability(ctx: LoggerAdapterContext): void;
276
+ child(componentOrBindings: RegisteredLogger | Record<string, unknown>): ConsoleLogger;
277
+ private shouldLog;
278
+ private prefix;
279
+ debug(message: string, ...args: any[]): void;
280
+ info(message: string, ...args: any[]): void;
281
+ warn(message: string, ...args: any[]): void;
282
+ error(message: string, ...args: any[]): void;
283
+ trackException(error: Error, metadata?: Record<string, unknown>): void;
284
+ listLogs(_transportId: string, _params?: {
285
+ fromDate?: Date;
286
+ toDate?: Date;
287
+ logLevel?: LogLevel;
288
+ filters?: Record<string, any>;
289
+ page?: number;
290
+ perPage?: number;
291
+ }): Promise<{
292
+ logs: never[];
293
+ total: number;
294
+ page: number;
295
+ perPage: number;
296
+ hasMore: boolean;
297
+ }>;
298
+ listLogsByRunId(_args: {
299
+ transportId: string;
300
+ runId: string;
301
+ fromDate?: Date;
302
+ toDate?: Date;
303
+ logLevel?: LogLevel;
304
+ filters?: Record<string, any>;
305
+ page?: number;
306
+ perPage?: number;
307
+ }): Promise<{
308
+ logs: never[];
309
+ total: number;
310
+ page: number;
311
+ perPage: number;
312
+ hasMore: boolean;
313
+ }>;
314
+ }
315
+ export { TraceFields as _, LogFilter as a, isAdaptableLogger as b, LoggerTransport as c, createCustomTransport as d, noopLogger as f, LoggerAdapterOptions as g, LoggerAdapterContext as h, IMastraLogger as i, MastraLogger as l, AdapterLogSink as m, ConsoleLogger as n, LogFilterContext as o, AdaptableLogger as p, ConsoleLoggerOptions as r, LogLevel as s, BaseLogMessage as t, RegisteredLogger as u, buildLogRecordData as v, exportTrackedException as y };
316
+ //# sourceMappingURL=index-Diz1p9N7.d.ts.map
@@ -0,0 +1,2 @@
1
+ import { _ as TraceFields, a as LogFilter, b as isAdaptableLogger, c as LoggerTransport, d as createCustomTransport, f as noopLogger, g as LoggerAdapterOptions, h as LoggerAdapterContext, i as IMastraLogger, l as MastraLogger, m as AdapterLogSink, n as ConsoleLogger, o as LogFilterContext, p as AdaptableLogger, r as ConsoleLoggerOptions, s as LogLevel, t as BaseLogMessage, u as RegisteredLogger, v as buildLogRecordData, y as exportTrackedException } from "../index-Diz1p9N7.js";
2
+ export { AdaptableLogger, AdapterLogSink, BaseLogMessage, ConsoleLogger, ConsoleLoggerOptions, IMastraLogger, LogFilter, LogFilterContext, LogLevel, LoggerAdapterContext, LoggerAdapterOptions, LoggerTransport, MastraLogger, RegisteredLogger, TraceFields, buildLogRecordData, createCustomTransport, exportTrackedException, isAdaptableLogger, noopLogger };
@@ -0,0 +1 @@
1
+ {"type":"module"}
@@ -0,0 +1,316 @@
1
+ import { Transform } from "stream";
2
+ /**
3
+ * OpenTelemetry-compatible trace correlation fields, injected at the top
4
+ * level of a logger's native record.
5
+ *
6
+ * Field names are part of the platform contract (snake_case, W3C formats):
7
+ * external consumers (e.g. the Studio logs view reading Railway stdout)
8
+ * parse structured log lines and look for exactly these keys.
9
+ */
10
+ interface TraceFields {
11
+ /** 32-char lowercase hex W3C trace id */
12
+ trace_id: string;
13
+ /**
14
+ * 16-char lowercase hex W3C span id.
15
+ *
16
+ * Optional, and omitted rather than emitted empty: the active span may be
17
+ * one observability never exports (an internal span, or one dropped by
18
+ * `excludeSpanTypes`), leaving no span id a consumer could look up. The
19
+ * trace is still addressable in that case, so the line keeps `trace_id` and
20
+ * drops only this field. Consumers must treat `span_id` as possibly absent.
21
+ */
22
+ span_id?: string;
23
+ }
24
+ /**
25
+ * Destination for log records derived from the logger's native record,
26
+ * exported to Mastra observability. Structurally compatible with
27
+ * `LoggerContext` from `@mastra/core/observability`.
28
+ */
29
+ interface AdapterLogSink {
30
+ debug(message: string, data?: Record<string, unknown>): void;
31
+ info(message: string, data?: Record<string, unknown>): void;
32
+ warn(message: string, data?: Record<string, unknown>): void;
33
+ error(message: string, data?: Record<string, unknown>): void;
34
+ }
35
+ interface LoggerAdapterOptions {
36
+ /** Inject trace_id/span_id into the logger's native records. */
37
+ correlation: boolean;
38
+ /** Export records derived from the native record to Mastra observability. */
39
+ export: boolean;
40
+ }
41
+ /**
42
+ * Context handed to an adaptable logger by Mastra when observability is
43
+ * wired up. All members are safe to call on every log call (synchronous,
44
+ * never throw).
45
+ */
46
+ interface LoggerAdapterContext {
47
+ /**
48
+ * Resolve correlation fields for the currently active span, or undefined
49
+ * when no span is active (in which case no trace fields are added).
50
+ */
51
+ resolveTraceFields: () => TraceFields | undefined;
52
+ /**
53
+ * Resolve the observability log sink at call time. Returns the
54
+ * span-correlated sink when a span is active, the global sink otherwise,
55
+ * and undefined when export is disabled or observability is not
56
+ * initialized. Records must still be written to the native destination
57
+ * regardless.
58
+ */
59
+ getLogSink: () => AdapterLogSink | undefined;
60
+ options: LoggerAdapterOptions;
61
+ }
62
+ /**
63
+ * Capability marker a logger implements to opt into native trace
64
+ * correlation and observability export. When a configured logger implements
65
+ * this, Mastra attaches observability directly instead of wrapping the
66
+ * logger in the deprecated `DualLogger`.
67
+ */
68
+ interface AdaptableLogger extends IMastraLogger {
69
+ __attachObservability(ctx: LoggerAdapterContext): void;
70
+ /**
71
+ * Stable identity for the attachment target. Loggers whose adapter context
72
+ * lives in state shared across a root/child family (e.g. PinoLogger's
73
+ * mixin ref cell) return that shared object, so attaching any family
74
+ * member is recognized as re-attaching the whole family. Defaults to the
75
+ * logger instance itself when absent.
76
+ */
77
+ __observabilityAttachmentKey?(): object;
78
+ }
79
+ declare function isAdaptableLogger(logger: IMastraLogger): logger is AdaptableLogger;
80
+ /**
81
+ * Export a tracked exception through the adapter sink, mirroring the
82
+ * DualLogger dual-write shape (`errorId`/`domain`/`category`/`details`/`cause`
83
+ * when present on a MastraError-like value). Never throws into the caller.
84
+ */
85
+ declare function exportTrackedException(ctx: LoggerAdapterContext | undefined, error: Error, metadata?: Record<string, unknown>): void;
86
+ /**
87
+ * Adapt IMastraLogger's variadic args into the structured `data` payload of
88
+ * an exported log record. Extracts the first plain object as data,
89
+ * serializes an Error arg, and collects remaining primitives under `args`
90
+ * so the derived record preserves all context from the native call.
91
+ */
92
+ declare function buildLogRecordData(args: unknown[]): Record<string, unknown> | undefined;
93
+ declare const noopLogger: IMastraLogger;
94
+ declare const RegisteredLogger: {
95
+ readonly AGENT: 'AGENT';
96
+ readonly OBSERVABILITY: 'OBSERVABILITY';
97
+ readonly AUTH: 'AUTH';
98
+ readonly BROWSER: 'BROWSER';
99
+ readonly NETWORK: 'NETWORK';
100
+ readonly WORKFLOW: 'WORKFLOW';
101
+ readonly LLM: 'LLM';
102
+ readonly TTS: 'TTS';
103
+ readonly VOICE: 'VOICE';
104
+ readonly VECTOR: 'VECTOR';
105
+ readonly BUNDLER: 'BUNDLER';
106
+ readonly DEPLOYER: 'DEPLOYER';
107
+ readonly MEMORY: 'MEMORY';
108
+ readonly STORAGE: 'STORAGE';
109
+ readonly EMBEDDINGS: 'EMBEDDINGS';
110
+ readonly MCP_SERVER: 'MCP_SERVER';
111
+ readonly SERVER_CACHE: 'SERVER_CACHE';
112
+ readonly SERVER: 'SERVER';
113
+ readonly WORKSPACE: 'WORKSPACE';
114
+ readonly CHANNEL: 'CHANNEL';
115
+ };
116
+ type RegisteredLogger = (typeof RegisteredLogger)[keyof typeof RegisteredLogger];
117
+ declare const LogLevel: {
118
+ readonly DEBUG: 'debug';
119
+ readonly INFO: 'info';
120
+ readonly WARN: 'warn';
121
+ readonly ERROR: 'error';
122
+ readonly NONE: 'silent';
123
+ };
124
+ type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
125
+ interface BaseLogMessage {
126
+ runId?: string;
127
+ msg: string;
128
+ level: LogLevel;
129
+ time: Date;
130
+ pid: number;
131
+ hostname: string;
132
+ name: string;
133
+ }
134
+ declare abstract class LoggerTransport extends Transform {
135
+ constructor(opts?: any);
136
+ listLogsByRunId(_args: {
137
+ runId: string;
138
+ fromDate?: Date;
139
+ toDate?: Date;
140
+ logLevel?: LogLevel;
141
+ filters?: Record<string, any>;
142
+ page?: number;
143
+ perPage?: number;
144
+ }): Promise<{
145
+ logs: BaseLogMessage[];
146
+ total: number;
147
+ page: number;
148
+ perPage: number;
149
+ hasMore: boolean;
150
+ }>;
151
+ listLogs(_args?: {
152
+ fromDate?: Date;
153
+ toDate?: Date;
154
+ logLevel?: LogLevel;
155
+ filters?: Record<string, any>;
156
+ returnPaginationResults?: boolean;
157
+ page?: number;
158
+ perPage?: number;
159
+ }): Promise<{
160
+ logs: BaseLogMessage[];
161
+ total: number;
162
+ page: number;
163
+ perPage: number;
164
+ hasMore: boolean;
165
+ }>;
166
+ }
167
+ declare const createCustomTransport: (stream: Transform, listLogs?: LoggerTransport['listLogs'], listLogsByRunId?: LoggerTransport['listLogsByRunId']) => LoggerTransport;
168
+ interface IMastraLogger {
169
+ debug(message: string, ...args: any[]): void;
170
+ info(message: string, ...args: any[]): void;
171
+ warn(message: string, ...args: any[]): void;
172
+ error(message: string, ...args: any[]): void;
173
+ trackException(error: Error, metadata?: Record<string, unknown>): void;
174
+ getTransports(): Map<string, LoggerTransport>;
175
+ listLogs(_transportId: string, _params?: {
176
+ fromDate?: Date;
177
+ toDate?: Date;
178
+ logLevel?: LogLevel;
179
+ filters?: Record<string, any>;
180
+ page?: number;
181
+ perPage?: number;
182
+ }): Promise<{
183
+ logs: BaseLogMessage[];
184
+ total: number;
185
+ page: number;
186
+ perPage: number;
187
+ hasMore: boolean;
188
+ }>;
189
+ listLogsByRunId(_args: {
190
+ transportId: string;
191
+ runId: string;
192
+ fromDate?: Date;
193
+ toDate?: Date;
194
+ logLevel?: LogLevel;
195
+ filters?: Record<string, any>;
196
+ page?: number;
197
+ perPage?: number;
198
+ }): Promise<{
199
+ logs: BaseLogMessage[];
200
+ total: number;
201
+ page: number;
202
+ perPage: number;
203
+ hasMore: boolean;
204
+ }>;
205
+ }
206
+ declare abstract class MastraLogger implements IMastraLogger {
207
+ protected name: string;
208
+ protected level: LogLevel;
209
+ protected transports: Map<string, LoggerTransport>;
210
+ constructor(options?: {
211
+ name?: string;
212
+ level?: LogLevel;
213
+ transports?: Record<string, LoggerTransport>;
214
+ });
215
+ abstract debug(message: string, ...args: any[]): void;
216
+ abstract info(message: string, ...args: any[]): void;
217
+ abstract warn(message: string, ...args: any[]): void;
218
+ abstract error(message: string, ...args: any[]): void;
219
+ getTransports(): Map<string, LoggerTransport>;
220
+ trackException(_error: Error, _metadata?: Record<string, unknown>): void;
221
+ listLogs(transportId: string, params?: {
222
+ fromDate?: Date;
223
+ toDate?: Date;
224
+ logLevel?: LogLevel;
225
+ filters?: Record<string, any>;
226
+ page?: number;
227
+ perPage?: number;
228
+ }): Promise<{
229
+ logs: BaseLogMessage[];
230
+ total: number;
231
+ page: number;
232
+ perPage: number;
233
+ hasMore: boolean;
234
+ }>;
235
+ listLogsByRunId({ transportId, runId, fromDate, toDate, logLevel, filters, page, perPage }: {
236
+ transportId: string;
237
+ runId: string;
238
+ fromDate?: Date;
239
+ toDate?: Date;
240
+ logLevel?: LogLevel;
241
+ filters?: Record<string, any>;
242
+ page?: number;
243
+ perPage?: number;
244
+ }): Promise<{
245
+ logs: BaseLogMessage[];
246
+ total: number;
247
+ page: number;
248
+ perPage: number;
249
+ hasMore: boolean;
250
+ }>;
251
+ }
252
+ type LogFilterContext = {
253
+ component?: RegisteredLogger;
254
+ level: LogLevel;
255
+ message: string;
256
+ args: unknown[];
257
+ };
258
+ type LogFilter = (ctx: LogFilterContext) => boolean;
259
+ interface ConsoleLoggerOptions {
260
+ name?: string;
261
+ level?: LogLevel;
262
+ component?: RegisteredLogger;
263
+ filter?: LogFilter;
264
+ }
265
+ declare class ConsoleLogger extends MastraLogger {
266
+ #private;
267
+ protected component?: RegisteredLogger;
268
+ protected filter?: LogFilter;
269
+ constructor(options?: ConsoleLoggerOptions);
270
+ /**
271
+ * Adapter hook (see `AdaptableLogger`): enables native trace correlation
272
+ * (trace_id/span_id appended to console output) and observability export
273
+ * derived from the same record. Called by Mastra during setup.
274
+ */
275
+ __attachObservability(ctx: LoggerAdapterContext): void;
276
+ child(componentOrBindings: RegisteredLogger | Record<string, unknown>): ConsoleLogger;
277
+ private shouldLog;
278
+ private prefix;
279
+ debug(message: string, ...args: any[]): void;
280
+ info(message: string, ...args: any[]): void;
281
+ warn(message: string, ...args: any[]): void;
282
+ error(message: string, ...args: any[]): void;
283
+ trackException(error: Error, metadata?: Record<string, unknown>): void;
284
+ listLogs(_transportId: string, _params?: {
285
+ fromDate?: Date;
286
+ toDate?: Date;
287
+ logLevel?: LogLevel;
288
+ filters?: Record<string, any>;
289
+ page?: number;
290
+ perPage?: number;
291
+ }): Promise<{
292
+ logs: never[];
293
+ total: number;
294
+ page: number;
295
+ perPage: number;
296
+ hasMore: boolean;
297
+ }>;
298
+ listLogsByRunId(_args: {
299
+ transportId: string;
300
+ runId: string;
301
+ fromDate?: Date;
302
+ toDate?: Date;
303
+ logLevel?: LogLevel;
304
+ filters?: Record<string, any>;
305
+ page?: number;
306
+ perPage?: number;
307
+ }): Promise<{
308
+ logs: never[];
309
+ total: number;
310
+ page: number;
311
+ perPage: number;
312
+ hasMore: boolean;
313
+ }>;
314
+ }
315
+ export { TraceFields as _, LogFilter as a, isAdaptableLogger as b, LoggerTransport as c, createCustomTransport as d, noopLogger as f, LoggerAdapterOptions as g, LoggerAdapterContext as h, IMastraLogger as i, MastraLogger as l, AdapterLogSink as m, ConsoleLogger as n, LogFilterContext as o, AdaptableLogger as p, ConsoleLoggerOptions as r, LogLevel as s, BaseLogMessage as t, RegisteredLogger as u, buildLogRecordData as v, exportTrackedException as y };
316
+ //# sourceMappingURL=index-Diz1p9N7.d.ts.map
@@ -0,0 +1,2 @@
1
+ import { _ as TraceFields, a as LogFilter, b as isAdaptableLogger, c as LoggerTransport, d as createCustomTransport, f as noopLogger, g as LoggerAdapterOptions, h as LoggerAdapterContext, i as IMastraLogger, l as MastraLogger, m as AdapterLogSink, n as ConsoleLogger, o as LogFilterContext, p as AdaptableLogger, r as ConsoleLoggerOptions, s as LogLevel, t as BaseLogMessage, u as RegisteredLogger, v as buildLogRecordData, y as exportTrackedException } from "../index-Diz1p9N7.js";
2
+ export { AdaptableLogger, AdapterLogSink, BaseLogMessage, ConsoleLogger, ConsoleLoggerOptions, IMastraLogger, LogFilter, LogFilterContext, LogLevel, LoggerAdapterContext, LoggerAdapterOptions, LoggerTransport, MastraLogger, RegisteredLogger, TraceFields, buildLogRecordData, createCustomTransport, exportTrackedException, isAdaptableLogger, noopLogger };