@mastra/observability 0.0.0-vnext-20251104230439 → 0.0.0-vnext-20251119160359

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 (51) hide show
  1. package/CHANGELOG.md +94 -3
  2. package/README.md +18 -20
  3. package/dist/config.d.ts +343 -0
  4. package/dist/config.d.ts.map +1 -0
  5. package/dist/default.d.ts +29 -0
  6. package/dist/default.d.ts.map +1 -0
  7. package/dist/exporters/base.d.ts +10 -10
  8. package/dist/exporters/base.d.ts.map +1 -1
  9. package/dist/exporters/cloud.d.ts +2 -2
  10. package/dist/exporters/cloud.d.ts.map +1 -1
  11. package/dist/exporters/console.d.ts +2 -2
  12. package/dist/exporters/console.d.ts.map +1 -1
  13. package/dist/exporters/default.d.ts +10 -14
  14. package/dist/exporters/default.d.ts.map +1 -1
  15. package/dist/exporters/index.d.ts +1 -1
  16. package/dist/index.cjs +1786 -1649
  17. package/dist/index.cjs.map +1 -1
  18. package/dist/index.d.ts +4 -3
  19. package/dist/index.d.ts.map +1 -1
  20. package/dist/index.js +1774 -1632
  21. package/dist/index.js.map +1 -1
  22. package/dist/{tracers → instances}/base.d.ts +27 -26
  23. package/dist/instances/base.d.ts.map +1 -0
  24. package/dist/instances/default.d.ts +8 -0
  25. package/dist/instances/default.d.ts.map +1 -0
  26. package/dist/instances/index.d.ts +6 -0
  27. package/dist/instances/index.d.ts.map +1 -0
  28. package/dist/model-tracing.d.ts +6 -6
  29. package/dist/model-tracing.d.ts.map +1 -1
  30. package/dist/registry.d.ts +46 -48
  31. package/dist/registry.d.ts.map +1 -1
  32. package/dist/span_processors/index.d.ts +1 -1
  33. package/dist/span_processors/sensitive-data-filter.d.ts +4 -4
  34. package/dist/span_processors/sensitive-data-filter.d.ts.map +1 -1
  35. package/dist/spans/base.d.ts +11 -11
  36. package/dist/spans/base.d.ts.map +1 -1
  37. package/dist/spans/default.d.ts +4 -4
  38. package/dist/spans/default.d.ts.map +1 -1
  39. package/dist/spans/index.d.ts +1 -1
  40. package/dist/spans/no-op.d.ts +4 -4
  41. package/dist/spans/no-op.d.ts.map +1 -1
  42. package/package.json +16 -11
  43. package/dist/default-entrypoint.d.ts +0 -16
  44. package/dist/default-entrypoint.d.ts.map +0 -1
  45. package/dist/init.d.ts +0 -2
  46. package/dist/init.d.ts.map +0 -1
  47. package/dist/tracers/base.d.ts.map +0 -1
  48. package/dist/tracers/default.d.ts +0 -7
  49. package/dist/tracers/default.d.ts.map +0 -1
  50. package/dist/tracers/index.d.ts +0 -6
  51. package/dist/tracers/index.d.ts.map +0 -1
package/CHANGELOG.md CHANGED
@@ -1,9 +1,43 @@
1
1
  # @mastra/observability
2
2
 
3
- ## 0.0.0-vnext-20251104230439
3
+ ## 0.0.0-vnext-20251119160359
4
4
 
5
5
  ### Major Changes
6
6
 
7
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
8
+
9
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
10
+
11
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
12
+ import { Mastra } from '@mastra/core';
13
+ import { Observability } from '@mastra/observability'; // Explicit import
14
+
15
+ const mastra = new Mastra({
16
+ ...other_config,
17
+ observability: new Observability({
18
+ default: { enabled: true }
19
+ }) // Instance
20
+ });
21
+ ```
22
+
23
+ Instead of:
24
+
25
+ ```
26
+ import { Mastra } from '@mastra/core';
27
+ import '@mastra/observability/init'; // Explicit import
28
+
29
+ const mastra = new Mastra({
30
+ ...other_config,
31
+ observability: {
32
+ default: { enabled: true }
33
+ }
34
+ });
35
+ ```
36
+
37
+ Also renamed a bunch of:
38
+ - `Tracing` things to `Observability` things.
39
+ - `AI-` things to just things.
40
+
7
41
  - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
8
42
 
9
43
  - moved ai-tracing code into @mastra/observability ([#9661](https://github.com/mastra-ai/mastra/pull/9661))
@@ -14,8 +48,65 @@
14
48
 
15
49
  - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
16
50
 
17
- - Updated dependencies [[`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`3443770`](https://github.com/mastra-ai/mastra/commit/3443770662df8eb24c9df3589b2792d78cfcb811), [`f0a07e0`](https://github.com/mastra-ai/mastra/commit/f0a07e0111b3307c5fabfa4094c5c2cfb734fbe6), [`1521d71`](https://github.com/mastra-ai/mastra/commit/1521d716e5daedc74690c983fbd961123c56756b), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`4c6b492`](https://github.com/mastra-ai/mastra/commit/4c6b492c4dd591c6a592520c1f6855d6e936d71f), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`6179a9b`](https://github.com/mastra-ai/mastra/commit/6179a9ba36ffac326de3cc3c43cdc8028d37c251), [`00f4921`](https://github.com/mastra-ai/mastra/commit/00f4921dd2c91a1e5446799599ef7116a8214a1a), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`a8f1494`](https://github.com/mastra-ai/mastra/commit/a8f1494f4bbdc2770bcf327d4c7d869e332183f1), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`a854ede`](https://github.com/mastra-ai/mastra/commit/a854ede62bf5ac0945a624ac48913dd69c73aabf), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`3defc80`](https://github.com/mastra-ai/mastra/commit/3defc80cf2b88a1b7fc1cc4ddcb91e982a614609), [`16153fe`](https://github.com/mastra-ai/mastra/commit/16153fe7eb13c99401f48e6ca32707c965ee28b9), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`bc94344`](https://github.com/mastra-ai/mastra/commit/bc943444a1342d8a662151b7bce1df7dae32f59c), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`96d35f6`](https://github.com/mastra-ai/mastra/commit/96d35f61376bc2b1bf148648a2c1985bd51bef55), [`5cbe88a`](https://github.com/mastra-ai/mastra/commit/5cbe88aefbd9f933bca669fd371ea36bf939ac6d), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`0d7618b`](https://github.com/mastra-ai/mastra/commit/0d7618bc650bf2800934b243eca5648f4aeed9c2), [`7b763e5`](https://github.com/mastra-ai/mastra/commit/7b763e52fc3eaf699c2a99f2adf418dd46e4e9a5), [`d36cfbb`](https://github.com/mastra-ai/mastra/commit/d36cfbbb6565ba5f827883cc9bb648eb14befdc1), [`3697853`](https://github.com/mastra-ai/mastra/commit/3697853deeb72017d90e0f38a93c1e29221aeca0), [`a534e95`](https://github.com/mastra-ai/mastra/commit/a534e9591f83b3cc1ebff99c67edf4cda7bf81d3), [`9d0e7fe`](https://github.com/mastra-ai/mastra/commit/9d0e7feca8ed98de959f53476ee1456073673348), [`53d927c`](https://github.com/mastra-ai/mastra/commit/53d927cc6f03bff33655b7e2b788da445a08731d), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`d7acd8e`](https://github.com/mastra-ai/mastra/commit/d7acd8e987b5d7eff4fd98b0906c17c06a2e83d5), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`735d8c1`](https://github.com/mastra-ai/mastra/commit/735d8c1c0d19fbc09e6f8b66cf41bc7655993838), [`acf322e`](https://github.com/mastra-ai/mastra/commit/acf322e0f1fd0189684cf529d91c694bea918a45), [`c942802`](https://github.com/mastra-ai/mastra/commit/c942802a477a925b01859a7b8688d4355715caaa), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`cc34739`](https://github.com/mastra-ai/mastra/commit/cc34739c34b6266a91bea561119240a7acf47887), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3), [`2b8893c`](https://github.com/mastra-ai/mastra/commit/2b8893cb108ef9acb72ee7835cd625610d2c1a4a), [`8e5c75b`](https://github.com/mastra-ai/mastra/commit/8e5c75bdb1d08a42d45309a4c72def4b6890230f), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019)]:
18
- - @mastra/core@0.0.0-vnext-20251104230439
51
+ - Updates console warning when cloud access token env is not set. ([#9149](https://github.com/mastra-ai/mastra/pull/9149))
52
+
53
+ - moved observability config to zod to provide better validation ([#9783](https://github.com/mastra-ai/mastra/pull/9783))
54
+
55
+ - Updated dependencies [[`2319326`](https://github.com/mastra-ai/mastra/commit/2319326f8c64e503a09bbcf14be2dd65405445e0), [`39c9743`](https://github.com/mastra-ai/mastra/commit/39c97432d084294f8ba85fbf3ef28098ff21459e), [`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`0491e7c`](https://github.com/mastra-ai/mastra/commit/0491e7c9b714cb0ba22187ee062147ec2dd7c712), [`f6f4903`](https://github.com/mastra-ai/mastra/commit/f6f4903397314f73362061dc5a3e8e7c61ea34aa), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`910db9e`](https://github.com/mastra-ai/mastra/commit/910db9e0312888495eb5617b567f247d03303814), [`2f897df`](https://github.com/mastra-ai/mastra/commit/2f897df208508f46f51b7625e5dd20c37f93e0e3), [`d629361`](https://github.com/mastra-ai/mastra/commit/d629361a60f6565b5bfb11976fdaf7308af858e2), [`08c31c1`](https://github.com/mastra-ai/mastra/commit/08c31c188ebccd598acaf55e888b6397d01f7eae), [`3443770`](https://github.com/mastra-ai/mastra/commit/3443770662df8eb24c9df3589b2792d78cfcb811), [`f0a07e0`](https://github.com/mastra-ai/mastra/commit/f0a07e0111b3307c5fabfa4094c5c2cfb734fbe6), [`aaa40e7`](https://github.com/mastra-ai/mastra/commit/aaa40e788628b319baa8e889407d11ad626547fa), [`1521d71`](https://github.com/mastra-ai/mastra/commit/1521d716e5daedc74690c983fbd961123c56756b), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`4c6b492`](https://github.com/mastra-ai/mastra/commit/4c6b492c4dd591c6a592520c1f6855d6e936d71f), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`fd3d338`](https://github.com/mastra-ai/mastra/commit/fd3d338a2c362174ed5b383f1f011ad9fb0302aa), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`6179a9b`](https://github.com/mastra-ai/mastra/commit/6179a9ba36ffac326de3cc3c43cdc8028d37c251), [`c30400a`](https://github.com/mastra-ai/mastra/commit/c30400a49b994b1b97256fe785eb6c906fc2b232), [`00f4921`](https://github.com/mastra-ai/mastra/commit/00f4921dd2c91a1e5446799599ef7116a8214a1a), [`ca8041c`](https://github.com/mastra-ai/mastra/commit/ca8041cce0379fda22ed293a565bcb5b6ddca68a), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`a8f1494`](https://github.com/mastra-ai/mastra/commit/a8f1494f4bbdc2770bcf327d4c7d869e332183f1), [`69e0a87`](https://github.com/mastra-ai/mastra/commit/69e0a878896a2da9494945d86e056a5f8f05b851), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`01f8878`](https://github.com/mastra-ai/mastra/commit/01f88783de25e4de048c1c8aace43e26373c6ea5), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`4c77209`](https://github.com/mastra-ai/mastra/commit/4c77209e6c11678808b365d545845918c40045c8), [`a854ede`](https://github.com/mastra-ai/mastra/commit/a854ede62bf5ac0945a624ac48913dd69c73aabf), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`3defc80`](https://github.com/mastra-ai/mastra/commit/3defc80cf2b88a1b7fc1cc4ddcb91e982a614609), [`16153fe`](https://github.com/mastra-ai/mastra/commit/16153fe7eb13c99401f48e6ca32707c965ee28b9), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`bc94344`](https://github.com/mastra-ai/mastra/commit/bc943444a1342d8a662151b7bce1df7dae32f59c), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`903f67d`](https://github.com/mastra-ai/mastra/commit/903f67d184504a273893818c02b961f5423a79ad), [`d827d08`](https://github.com/mastra-ai/mastra/commit/d827d0808ffe1f3553a84e975806cc989b9735dd), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`23c10a1`](https://github.com/mastra-ai/mastra/commit/23c10a1efdd9a693c405511ab2dc8a1236603162), [`96d35f6`](https://github.com/mastra-ai/mastra/commit/96d35f61376bc2b1bf148648a2c1985bd51bef55), [`5cbe88a`](https://github.com/mastra-ai/mastra/commit/5cbe88aefbd9f933bca669fd371ea36bf939ac6d), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`676ccc7`](https://github.com/mastra-ai/mastra/commit/676ccc7fe92468d2d45d39c31a87825c89fd1ea0), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`398fde3`](https://github.com/mastra-ai/mastra/commit/398fde3f39e707cda79372cdae8f9870e3b57c8d), [`c10398d`](https://github.com/mastra-ai/mastra/commit/c10398d5b88f1d4af556f4267ff06f1d11e89179), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`0d7618b`](https://github.com/mastra-ai/mastra/commit/0d7618bc650bf2800934b243eca5648f4aeed9c2), [`7b763e5`](https://github.com/mastra-ai/mastra/commit/7b763e52fc3eaf699c2a99f2adf418dd46e4e9a5), [`d36cfbb`](https://github.com/mastra-ai/mastra/commit/d36cfbbb6565ba5f827883cc9bb648eb14befdc1), [`3697853`](https://github.com/mastra-ai/mastra/commit/3697853deeb72017d90e0f38a93c1e29221aeca0), [`b2e45ec`](https://github.com/mastra-ai/mastra/commit/b2e45eca727a8db01a81ba93f1a5219c7183c839), [`d6d49f7`](https://github.com/mastra-ai/mastra/commit/d6d49f7b8714fa19a52ff9c7cf7fb7e73751901e), [`00c2387`](https://github.com/mastra-ai/mastra/commit/00c2387f5f04a365316f851e58666ac43f8c4edf), [`a534e95`](https://github.com/mastra-ai/mastra/commit/a534e9591f83b3cc1ebff99c67edf4cda7bf81d3), [`9d0e7fe`](https://github.com/mastra-ai/mastra/commit/9d0e7feca8ed98de959f53476ee1456073673348), [`53d927c`](https://github.com/mastra-ai/mastra/commit/53d927cc6f03bff33655b7e2b788da445a08731d), [`ad6250d`](https://github.com/mastra-ai/mastra/commit/ad6250dbdaad927e29f74a27b83f6c468b50a705), [`3f2faf2`](https://github.com/mastra-ai/mastra/commit/3f2faf2e2d685d6c053cc5af1bf9fedf267b2ce5), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`3a73998`](https://github.com/mastra-ai/mastra/commit/3a73998fa4ebeb7f3dc9301afe78095fc63e7999), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`d7acd8e`](https://github.com/mastra-ai/mastra/commit/d7acd8e987b5d7eff4fd98b0906c17c06a2e83d5), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`735d8c1`](https://github.com/mastra-ai/mastra/commit/735d8c1c0d19fbc09e6f8b66cf41bc7655993838), [`acf322e`](https://github.com/mastra-ai/mastra/commit/acf322e0f1fd0189684cf529d91c694bea918a45), [`e16d553`](https://github.com/mastra-ai/mastra/commit/e16d55338403c7553531cc568125c63d53653dff), [`c942802`](https://github.com/mastra-ai/mastra/commit/c942802a477a925b01859a7b8688d4355715caaa), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`cc34739`](https://github.com/mastra-ai/mastra/commit/cc34739c34b6266a91bea561119240a7acf47887), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3), [`4d59f58`](https://github.com/mastra-ai/mastra/commit/4d59f58de2d90d6e2810a19d4518e38ddddb9038), [`2b8893c`](https://github.com/mastra-ai/mastra/commit/2b8893cb108ef9acb72ee7835cd625610d2c1a4a), [`8e5c75b`](https://github.com/mastra-ai/mastra/commit/8e5c75bdb1d08a42d45309a4c72def4b6890230f), [`e1bb9c9`](https://github.com/mastra-ai/mastra/commit/e1bb9c94b4eb68b019ae275981be3feb769b5365), [`351a11f`](https://github.com/mastra-ai/mastra/commit/351a11fcaf2ed1008977fa9b9a489fc422e51cd4), [`e59e0d3`](https://github.com/mastra-ai/mastra/commit/e59e0d32afb5fcf2c9f3c00c8f81f6c21d3a63fa), [`465ac05`](https://github.com/mastra-ai/mastra/commit/465ac0526a91d175542091c675181f1a96c98c46), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`e7266a2`](https://github.com/mastra-ai/mastra/commit/e7266a278db02035c97a5e9cd9d1669a6b7a535d), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019)]:
56
+ - @mastra/core@0.0.0-vnext-20251119160359
57
+
58
+ ## 1.0.0-beta.0
59
+
60
+ ### Major Changes
61
+
62
+ - Bump minimum required Node.js version to 22.13.0 ([#9706](https://github.com/mastra-ai/mastra/pull/9706))
63
+
64
+ - Renamed a bunch of observability/tracing-related things to drop the AI prefix. ([#9744](https://github.com/mastra-ai/mastra/pull/9744))
65
+
66
+ - ```([#9709](https://github.com/mastra-ai/mastra/pull/9709))
67
+ import { Mastra } from '@mastra/core';
68
+ import { Observability } from '@mastra/observability'; // Explicit import
69
+
70
+ const mastra = new Mastra({
71
+ ...other_config,
72
+ observability: new Observability({
73
+ default: { enabled: true }
74
+ }) // Instance
75
+ });
76
+ ```
77
+
78
+ Instead of:
79
+
80
+ ```
81
+ import { Mastra } from '@mastra/core';
82
+ import '@mastra/observability/init'; // Explicit import
83
+
84
+ const mastra = new Mastra({
85
+ ...other_config,
86
+ observability: {
87
+ default: { enabled: true }
88
+ }
89
+ });
90
+ ```
91
+
92
+ Also renamed a bunch of:
93
+ - `Tracing` things to `Observability` things.
94
+ - `AI-` things to just things.
95
+
96
+ - Mark as stable ([`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc))
97
+
98
+ - moved ai-tracing code into @mastra/observability ([#9661](https://github.com/mastra-ai/mastra/pull/9661))
99
+
100
+ ### Patch Changes
101
+
102
+ - Fixed import isssues in exporters. ([#9316](https://github.com/mastra-ai/mastra/pull/9316))
103
+
104
+ - Update peer dependencies to match core package version bump (1.0.0) ([#9237](https://github.com/mastra-ai/mastra/pull/9237))
105
+
106
+ - moved observability config to zod to provide better validation ([#9783](https://github.com/mastra-ai/mastra/pull/9783))
107
+
108
+ - Updated dependencies [[`39c9743`](https://github.com/mastra-ai/mastra/commit/39c97432d084294f8ba85fbf3ef28098ff21459e), [`f743dbb`](https://github.com/mastra-ai/mastra/commit/f743dbb8b40d1627b5c10c0e6fc154f4ebb6e394), [`fec5129`](https://github.com/mastra-ai/mastra/commit/fec5129de7fc64423ea03661a56cef31dc747a0d), [`0491e7c`](https://github.com/mastra-ai/mastra/commit/0491e7c9b714cb0ba22187ee062147ec2dd7c712), [`f6f4903`](https://github.com/mastra-ai/mastra/commit/f6f4903397314f73362061dc5a3e8e7c61ea34aa), [`0e8ed46`](https://github.com/mastra-ai/mastra/commit/0e8ed467c54d6901a6a365f270ec15d6faadb36c), [`6c049d9`](https://github.com/mastra-ai/mastra/commit/6c049d94063fdcbd5b81c4912a2bf82a92c9cc0b), [`2f897df`](https://github.com/mastra-ai/mastra/commit/2f897df208508f46f51b7625e5dd20c37f93e0e3), [`3443770`](https://github.com/mastra-ai/mastra/commit/3443770662df8eb24c9df3589b2792d78cfcb811), [`f0a07e0`](https://github.com/mastra-ai/mastra/commit/f0a07e0111b3307c5fabfa4094c5c2cfb734fbe6), [`aaa40e7`](https://github.com/mastra-ai/mastra/commit/aaa40e788628b319baa8e889407d11ad626547fa), [`1521d71`](https://github.com/mastra-ai/mastra/commit/1521d716e5daedc74690c983fbd961123c56756b), [`9e1911d`](https://github.com/mastra-ai/mastra/commit/9e1911db2b4db85e0e768c3f15e0d61e319869f6), [`ebac155`](https://github.com/mastra-ai/mastra/commit/ebac15564a590117db7078233f927a7e28a85106), [`dd1c38d`](https://github.com/mastra-ai/mastra/commit/dd1c38d1b75f1b695c27b40d8d9d6ed00d5e0f6f), [`5948e6a`](https://github.com/mastra-ai/mastra/commit/5948e6a5146c83666ba3f294b2be576c82a513fb), [`8940859`](https://github.com/mastra-ai/mastra/commit/89408593658199b4ad67f7b65e888f344e64a442), [`e629310`](https://github.com/mastra-ai/mastra/commit/e629310f1a73fa236d49ec7a1d1cceb6229dc7cc), [`4c6b492`](https://github.com/mastra-ai/mastra/commit/4c6b492c4dd591c6a592520c1f6855d6e936d71f), [`dff01d8`](https://github.com/mastra-ai/mastra/commit/dff01d81ce1f4e4087cfac20fa868e6db138dd14), [`9d819d5`](https://github.com/mastra-ai/mastra/commit/9d819d54b61481639f4008e4694791bddf187edd), [`71c8d6c`](https://github.com/mastra-ai/mastra/commit/71c8d6c161253207b2b9588bdadb7eed604f7253), [`6179a9b`](https://github.com/mastra-ai/mastra/commit/6179a9ba36ffac326de3cc3c43cdc8028d37c251), [`00f4921`](https://github.com/mastra-ai/mastra/commit/00f4921dd2c91a1e5446799599ef7116a8214a1a), [`ca8041c`](https://github.com/mastra-ai/mastra/commit/ca8041cce0379fda22ed293a565bcb5b6ddca68a), [`7051bf3`](https://github.com/mastra-ai/mastra/commit/7051bf38b3b122a069008f861f7bfc004a6d9f6e), [`a8f1494`](https://github.com/mastra-ai/mastra/commit/a8f1494f4bbdc2770bcf327d4c7d869e332183f1), [`0793497`](https://github.com/mastra-ai/mastra/commit/079349753620c40246ffd673e3f9d7d9820beff3), [`5df9cce`](https://github.com/mastra-ai/mastra/commit/5df9cce1a753438413f64c11eeef8f845745c2a8), [`a854ede`](https://github.com/mastra-ai/mastra/commit/a854ede62bf5ac0945a624ac48913dd69c73aabf), [`c576fc0`](https://github.com/mastra-ai/mastra/commit/c576fc0b100b2085afded91a37c97a0ea0ec09c7), [`3defc80`](https://github.com/mastra-ai/mastra/commit/3defc80cf2b88a1b7fc1cc4ddcb91e982a614609), [`16153fe`](https://github.com/mastra-ai/mastra/commit/16153fe7eb13c99401f48e6ca32707c965ee28b9), [`9f4a683`](https://github.com/mastra-ai/mastra/commit/9f4a6833e88b52574665c028fd5508ad5c2f6004), [`bc94344`](https://github.com/mastra-ai/mastra/commit/bc943444a1342d8a662151b7bce1df7dae32f59c), [`57d157f`](https://github.com/mastra-ai/mastra/commit/57d157f0b163a95c3e6c9eae31bdb11d1bfc64f9), [`903f67d`](https://github.com/mastra-ai/mastra/commit/903f67d184504a273893818c02b961f5423a79ad), [`2a90c55`](https://github.com/mastra-ai/mastra/commit/2a90c55a86a9210697d5adaab5ee94584b079adc), [`eb09742`](https://github.com/mastra-ai/mastra/commit/eb09742197f66c4c38154c3beec78313e69760b2), [`96d35f6`](https://github.com/mastra-ai/mastra/commit/96d35f61376bc2b1bf148648a2c1985bd51bef55), [`5cbe88a`](https://github.com/mastra-ai/mastra/commit/5cbe88aefbd9f933bca669fd371ea36bf939ac6d), [`a1bd7b8`](https://github.com/mastra-ai/mastra/commit/a1bd7b8571db16b94eb01588f451a74758c96d65), [`d78b38d`](https://github.com/mastra-ai/mastra/commit/d78b38d898fce285260d3bbb4befade54331617f), [`0633100`](https://github.com/mastra-ai/mastra/commit/0633100a911ad22f5256471bdf753da21c104742), [`c710c16`](https://github.com/mastra-ai/mastra/commit/c710c1652dccfdc4111c8412bca7a6bb1d48b441), [`354ad0b`](https://github.com/mastra-ai/mastra/commit/354ad0b7b1b8183ac567f236a884fc7ede6d7138), [`cfae733`](https://github.com/mastra-ai/mastra/commit/cfae73394f4920635e6c919c8e95ff9a0788e2e5), [`e3dfda7`](https://github.com/mastra-ai/mastra/commit/e3dfda7b11bf3b8c4bb55637028befb5f387fc74), [`844ea5d`](https://github.com/mastra-ai/mastra/commit/844ea5dc0c248961e7bf73629ae7dcff503e853c), [`398fde3`](https://github.com/mastra-ai/mastra/commit/398fde3f39e707cda79372cdae8f9870e3b57c8d), [`f0f8f12`](https://github.com/mastra-ai/mastra/commit/f0f8f125c308f2d0fd36942ef652fd852df7522f), [`0d7618b`](https://github.com/mastra-ai/mastra/commit/0d7618bc650bf2800934b243eca5648f4aeed9c2), [`7b763e5`](https://github.com/mastra-ai/mastra/commit/7b763e52fc3eaf699c2a99f2adf418dd46e4e9a5), [`d36cfbb`](https://github.com/mastra-ai/mastra/commit/d36cfbbb6565ba5f827883cc9bb648eb14befdc1), [`3697853`](https://github.com/mastra-ai/mastra/commit/3697853deeb72017d90e0f38a93c1e29221aeca0), [`b2e45ec`](https://github.com/mastra-ai/mastra/commit/b2e45eca727a8db01a81ba93f1a5219c7183c839), [`d6d49f7`](https://github.com/mastra-ai/mastra/commit/d6d49f7b8714fa19a52ff9c7cf7fb7e73751901e), [`a534e95`](https://github.com/mastra-ai/mastra/commit/a534e9591f83b3cc1ebff99c67edf4cda7bf81d3), [`9d0e7fe`](https://github.com/mastra-ai/mastra/commit/9d0e7feca8ed98de959f53476ee1456073673348), [`53d927c`](https://github.com/mastra-ai/mastra/commit/53d927cc6f03bff33655b7e2b788da445a08731d), [`3f2faf2`](https://github.com/mastra-ai/mastra/commit/3f2faf2e2d685d6c053cc5af1bf9fedf267b2ce5), [`22f64bc`](https://github.com/mastra-ai/mastra/commit/22f64bc1d37149480b58bf2fefe35b79a1e3e7d5), [`83d5942`](https://github.com/mastra-ai/mastra/commit/83d5942669ce7bba4a6ca4fd4da697a10eb5ebdc), [`b7959e6`](https://github.com/mastra-ai/mastra/commit/b7959e6e25a46b480f9ea2217c4c6c588c423791), [`bda6370`](https://github.com/mastra-ai/mastra/commit/bda637009360649aaf579919e7873e33553c273e), [`d7acd8e`](https://github.com/mastra-ai/mastra/commit/d7acd8e987b5d7eff4fd98b0906c17c06a2e83d5), [`c7f1f7d`](https://github.com/mastra-ai/mastra/commit/c7f1f7d24f61f247f018cc2d1f33bf63212959a7), [`0bddc6d`](https://github.com/mastra-ai/mastra/commit/0bddc6d8dbd6f6008c0cba2e4960a2da75a55af1), [`735d8c1`](https://github.com/mastra-ai/mastra/commit/735d8c1c0d19fbc09e6f8b66cf41bc7655993838), [`acf322e`](https://github.com/mastra-ai/mastra/commit/acf322e0f1fd0189684cf529d91c694bea918a45), [`c942802`](https://github.com/mastra-ai/mastra/commit/c942802a477a925b01859a7b8688d4355715caaa), [`a0c8c1b`](https://github.com/mastra-ai/mastra/commit/a0c8c1b87d4fee252aebda73e8637fbe01d761c9), [`cc34739`](https://github.com/mastra-ai/mastra/commit/cc34739c34b6266a91bea561119240a7acf47887), [`c218bd3`](https://github.com/mastra-ai/mastra/commit/c218bd3759e32423735b04843a09404572631014), [`2c4438b`](https://github.com/mastra-ai/mastra/commit/2c4438b87817ab7eed818c7990fef010475af1a3), [`2b8893c`](https://github.com/mastra-ai/mastra/commit/2b8893cb108ef9acb72ee7835cd625610d2c1a4a), [`8e5c75b`](https://github.com/mastra-ai/mastra/commit/8e5c75bdb1d08a42d45309a4c72def4b6890230f), [`e59e0d3`](https://github.com/mastra-ai/mastra/commit/e59e0d32afb5fcf2c9f3c00c8f81f6c21d3a63fa), [`fa8409b`](https://github.com/mastra-ai/mastra/commit/fa8409bc39cfd8ba6643b9db5269b90b22e2a2f7), [`173c535`](https://github.com/mastra-ai/mastra/commit/173c535c0645b0da404fe09f003778f0b0d4e019)]:
109
+ - @mastra/core@1.0.0-beta.0
19
110
 
20
111
  ## 0.0.2
21
112
 
package/README.md CHANGED
@@ -1,10 +1,10 @@
1
- # AI Tracing
1
+ # Mastra Observability
2
2
 
3
- A comprehensive tracing system for AI operations in Mastra, providing type-safe span tracking, event-driven exports, and OpenTelemetry-compatible tracing.
3
+ A comprehensive observability system for AI operations in Mastra, providing type-safe span tracking, event-driven exports, and flexible tracing configuration.
4
4
 
5
5
  ## Overview
6
6
 
7
- The AI Tracing system enables detailed observability for AI-driven applications by tracking operations through spans that capture metadata, timing, and context. It's designed to work seamlessly with Mastra's architecture while providing flexible configuration and export options.
7
+ The Mastra Observability system enables detailed observability for AI-driven applications by tracking operations through spans that capture metadata, timing, and context. It's designed to work seamlessly with Mastra's architecture while providing flexible configuration and export options.
8
8
 
9
9
  ## Key Features
10
10
 
@@ -21,16 +21,17 @@ The AI Tracing system enables detailed observability for AI-driven applications
21
21
  ### Manual Tracing
22
22
 
23
23
  ```typescript
24
- import { DefaultAITracing, AISpanType } from '@mastra/core/observability';
24
+ import { DefaultObservabilityInstance, SpanType } from '@mastra/observability';
25
25
 
26
- // Create tracing instance
27
- const tracing = new DefaultAITracing({
26
+ // Create observability instance
27
+ const observability = new DefaultObservabilityInstance({
28
+ name: 'my-app',
28
29
  serviceName: 'my-app',
29
30
  });
30
31
 
31
32
  // Start an agent span
32
- const agentSpan = tracing.startSpan({
33
- type: AISpanType.AGENT_RUN,
33
+ const agentSpan = observability.startSpan({
34
+ type: SpanType.AGENT_RUN,
34
35
  name: 'customer-support-agent',
35
36
  attributes: {
36
37
  agentId: 'agent-123',
@@ -41,7 +42,7 @@ const agentSpan = tracing.startSpan({
41
42
 
42
43
  // Create child spans for nested operations
43
44
  const llmSpan = agentSpan.createChildSpan({
44
- type: AISpanType.MODEL_GENERATION,
45
+ type: SpanType.MODEL_GENERATION,
45
46
  name: 'gpt-4-response',
46
47
  attributes: {
47
48
  model: 'gpt-4',
@@ -66,22 +67,26 @@ agentSpan.end();
66
67
  - **`MODEL_GENERATION`**: Individual model API calls with token usage
67
68
  - **`TOOL_CALL`**: Function/tool execution
68
69
  - **`MCP_TOOL_CALL`**: Model Context Protocol tool execution
70
+ - **`PROCESSOR_RUN`**: Input/output processor execution
69
71
  - **`GENERIC`**: Custom spans for other operations
70
72
 
71
73
  ### Basic Configuration
72
74
 
73
- Enable AI Observability in your Mastra instance:
75
+ Enable observability in your Mastra instance:
74
76
 
75
77
  ```typescript
78
+ import { Mastra } from '@mastra/core';
79
+ import { Observability } from '@mastra/observability';
80
+
76
81
  export const mastra = new Mastra({
77
82
  // ... other config
78
- observability: {
83
+ observability: new Observability({
79
84
  default: { enabled: true },
80
- },
85
+ }),
81
86
  });
82
87
  ```
83
88
 
84
- This enables the Default and Cloud exporters, with the SensitiveDataFilter, and 'Always' Sampling.
89
+ This enables the `DefaultExporter` and `CloudExporter`, with the `SensitiveDataFilter` span output processor, and `always` sampling.
85
90
 
86
91
  ## Performance Considerations
87
92
 
@@ -92,10 +97,3 @@ The current implementation prioritizes correctness and ease of use:
92
97
  - **Automatic Lifecycle Management**: All spans automatically emit events through method wrapping
93
98
  - **Real-time Export**: Events are exported immediately when they occur
94
99
  - **Memory Overhead**: Each span maintains references to tracing instance
95
-
96
- ### Future Optimization Opportunities
97
-
98
- When performance becomes a concern, consider these optimizations:
99
-
100
- 1. **Sampling at Creation**: Move sampling decision earlier to avoid creating unnecessary spans
101
- 2. **Async Export Queues**: Buffer events and export in batches to reduce I/O overhead
@@ -0,0 +1,343 @@
1
+ /**
2
+ * Configuration types for Mastra Observability
3
+ *
4
+ * These types define the configuration structure for observability,
5
+ * including tracing configs, sampling strategies, and registry setup.
6
+ */
7
+ import type { RequestContext } from '@mastra/core/di';
8
+ import type { ObservabilityInstance, ObservabilityExporter, SpanOutputProcessor, ConfigSelector } from '@mastra/core/observability';
9
+ import { z } from 'zod';
10
+ /**
11
+ * Sampling strategy types
12
+ */
13
+ export declare enum SamplingStrategyType {
14
+ ALWAYS = "always",
15
+ NEVER = "never",
16
+ RATIO = "ratio",
17
+ CUSTOM = "custom"
18
+ }
19
+ /**
20
+ * Options passed when using a custom sampler strategy
21
+ */
22
+ export interface CustomSamplerOptions {
23
+ requestContext?: RequestContext;
24
+ metadata?: Record<string, any>;
25
+ }
26
+ /**
27
+ * Sampling strategy configuration
28
+ */
29
+ export type SamplingStrategy = {
30
+ type: SamplingStrategyType.ALWAYS;
31
+ } | {
32
+ type: SamplingStrategyType.NEVER;
33
+ } | {
34
+ type: SamplingStrategyType.RATIO;
35
+ probability: number;
36
+ } | {
37
+ type: SamplingStrategyType.CUSTOM;
38
+ sampler: (options?: CustomSamplerOptions) => boolean;
39
+ };
40
+ /**
41
+ * Configuration for a single observability instance
42
+ */
43
+ export interface ObservabilityInstanceConfig {
44
+ /** Unique identifier for this config in the tracing registry */
45
+ name: string;
46
+ /** Service name for tracing */
47
+ serviceName: string;
48
+ /** Sampling strategy - controls whether tracing is collected (defaults to ALWAYS) */
49
+ sampling?: SamplingStrategy;
50
+ /** Custom exporters */
51
+ exporters?: ObservabilityExporter[];
52
+ /** Custom span output processors */
53
+ spanOutputProcessors?: SpanOutputProcessor[];
54
+ /** Set to `true` if you want to see spans internal to the operation of mastra */
55
+ includeInternalSpans?: boolean;
56
+ /**
57
+ * RequestContext keys to automatically extract as metadata for all spans
58
+ * created with this tracing configuration.
59
+ * Supports dot notation for nested values.
60
+ */
61
+ requestContextKeys?: string[];
62
+ }
63
+ /**
64
+ * Complete Observability registry configuration
65
+ */
66
+ export interface ObservabilityRegistryConfig {
67
+ /** Enables default exporters, with sampling: always, and sensitive data filtering */
68
+ default?: {
69
+ enabled?: boolean;
70
+ };
71
+ /** Map of tracing instance names to their configurations or pre-instantiated instances */
72
+ configs?: Record<string, Omit<ObservabilityInstanceConfig, 'name'> | ObservabilityInstance>;
73
+ /** Optional selector function to choose which tracing instance to use */
74
+ configSelector?: ConfigSelector;
75
+ }
76
+ /**
77
+ * Zod schema for SamplingStrategy
78
+ */
79
+ export declare const samplingStrategySchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
80
+ type: z.ZodLiteral<SamplingStrategyType.ALWAYS>;
81
+ }, "strip", z.ZodTypeAny, {
82
+ type: SamplingStrategyType.ALWAYS;
83
+ }, {
84
+ type: SamplingStrategyType.ALWAYS;
85
+ }>, z.ZodObject<{
86
+ type: z.ZodLiteral<SamplingStrategyType.NEVER>;
87
+ }, "strip", z.ZodTypeAny, {
88
+ type: SamplingStrategyType.NEVER;
89
+ }, {
90
+ type: SamplingStrategyType.NEVER;
91
+ }>, z.ZodObject<{
92
+ type: z.ZodLiteral<SamplingStrategyType.RATIO>;
93
+ probability: z.ZodNumber;
94
+ }, "strip", z.ZodTypeAny, {
95
+ type: SamplingStrategyType.RATIO;
96
+ probability: number;
97
+ }, {
98
+ type: SamplingStrategyType.RATIO;
99
+ probability: number;
100
+ }>, z.ZodObject<{
101
+ type: z.ZodLiteral<SamplingStrategyType.CUSTOM>;
102
+ sampler: z.ZodFunction<z.ZodTuple<[z.ZodOptional<z.ZodAny>], z.ZodUnknown>, z.ZodBoolean>;
103
+ }, "strip", z.ZodTypeAny, {
104
+ type: SamplingStrategyType.CUSTOM;
105
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
106
+ }, {
107
+ type: SamplingStrategyType.CUSTOM;
108
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
109
+ }>]>;
110
+ /**
111
+ * Zod schema for ObservabilityInstanceConfig
112
+ * Note: exporters, spanOutputProcessors, and configSelector are validated as any
113
+ * since they're complex runtime objects
114
+ */
115
+ export declare const observabilityInstanceConfigSchema: z.ZodObject<{
116
+ name: z.ZodString;
117
+ serviceName: z.ZodString;
118
+ sampling: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
119
+ type: z.ZodLiteral<SamplingStrategyType.ALWAYS>;
120
+ }, "strip", z.ZodTypeAny, {
121
+ type: SamplingStrategyType.ALWAYS;
122
+ }, {
123
+ type: SamplingStrategyType.ALWAYS;
124
+ }>, z.ZodObject<{
125
+ type: z.ZodLiteral<SamplingStrategyType.NEVER>;
126
+ }, "strip", z.ZodTypeAny, {
127
+ type: SamplingStrategyType.NEVER;
128
+ }, {
129
+ type: SamplingStrategyType.NEVER;
130
+ }>, z.ZodObject<{
131
+ type: z.ZodLiteral<SamplingStrategyType.RATIO>;
132
+ probability: z.ZodNumber;
133
+ }, "strip", z.ZodTypeAny, {
134
+ type: SamplingStrategyType.RATIO;
135
+ probability: number;
136
+ }, {
137
+ type: SamplingStrategyType.RATIO;
138
+ probability: number;
139
+ }>, z.ZodObject<{
140
+ type: z.ZodLiteral<SamplingStrategyType.CUSTOM>;
141
+ sampler: z.ZodFunction<z.ZodTuple<[z.ZodOptional<z.ZodAny>], z.ZodUnknown>, z.ZodBoolean>;
142
+ }, "strip", z.ZodTypeAny, {
143
+ type: SamplingStrategyType.CUSTOM;
144
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
145
+ }, {
146
+ type: SamplingStrategyType.CUSTOM;
147
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
148
+ }>]>>;
149
+ exporters: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
150
+ spanOutputProcessors: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
151
+ includeInternalSpans: z.ZodOptional<z.ZodBoolean>;
152
+ requestContextKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
153
+ }, "strip", z.ZodTypeAny, {
154
+ name: string;
155
+ serviceName: string;
156
+ sampling?: {
157
+ type: SamplingStrategyType.ALWAYS;
158
+ } | {
159
+ type: SamplingStrategyType.NEVER;
160
+ } | {
161
+ type: SamplingStrategyType.RATIO;
162
+ probability: number;
163
+ } | {
164
+ type: SamplingStrategyType.CUSTOM;
165
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
166
+ } | undefined;
167
+ exporters?: any[] | undefined;
168
+ spanOutputProcessors?: any[] | undefined;
169
+ includeInternalSpans?: boolean | undefined;
170
+ requestContextKeys?: string[] | undefined;
171
+ }, {
172
+ name: string;
173
+ serviceName: string;
174
+ sampling?: {
175
+ type: SamplingStrategyType.ALWAYS;
176
+ } | {
177
+ type: SamplingStrategyType.NEVER;
178
+ } | {
179
+ type: SamplingStrategyType.RATIO;
180
+ probability: number;
181
+ } | {
182
+ type: SamplingStrategyType.CUSTOM;
183
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
184
+ } | undefined;
185
+ exporters?: any[] | undefined;
186
+ spanOutputProcessors?: any[] | undefined;
187
+ includeInternalSpans?: boolean | undefined;
188
+ requestContextKeys?: string[] | undefined;
189
+ }>;
190
+ /**
191
+ * Zod schema for config values in the configs map
192
+ * This is the config object without the name field
193
+ */
194
+ export declare const observabilityConfigValueSchema: z.ZodObject<{
195
+ serviceName: z.ZodString;
196
+ sampling: z.ZodOptional<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
197
+ type: z.ZodLiteral<SamplingStrategyType.ALWAYS>;
198
+ }, "strip", z.ZodTypeAny, {
199
+ type: SamplingStrategyType.ALWAYS;
200
+ }, {
201
+ type: SamplingStrategyType.ALWAYS;
202
+ }>, z.ZodObject<{
203
+ type: z.ZodLiteral<SamplingStrategyType.NEVER>;
204
+ }, "strip", z.ZodTypeAny, {
205
+ type: SamplingStrategyType.NEVER;
206
+ }, {
207
+ type: SamplingStrategyType.NEVER;
208
+ }>, z.ZodObject<{
209
+ type: z.ZodLiteral<SamplingStrategyType.RATIO>;
210
+ probability: z.ZodNumber;
211
+ }, "strip", z.ZodTypeAny, {
212
+ type: SamplingStrategyType.RATIO;
213
+ probability: number;
214
+ }, {
215
+ type: SamplingStrategyType.RATIO;
216
+ probability: number;
217
+ }>, z.ZodObject<{
218
+ type: z.ZodLiteral<SamplingStrategyType.CUSTOM>;
219
+ sampler: z.ZodFunction<z.ZodTuple<[z.ZodOptional<z.ZodAny>], z.ZodUnknown>, z.ZodBoolean>;
220
+ }, "strip", z.ZodTypeAny, {
221
+ type: SamplingStrategyType.CUSTOM;
222
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
223
+ }, {
224
+ type: SamplingStrategyType.CUSTOM;
225
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
226
+ }>]>>;
227
+ exporters: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
228
+ spanOutputProcessors: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
229
+ includeInternalSpans: z.ZodOptional<z.ZodBoolean>;
230
+ requestContextKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
231
+ }, "strip", z.ZodTypeAny, {
232
+ serviceName: string;
233
+ sampling?: {
234
+ type: SamplingStrategyType.ALWAYS;
235
+ } | {
236
+ type: SamplingStrategyType.NEVER;
237
+ } | {
238
+ type: SamplingStrategyType.RATIO;
239
+ probability: number;
240
+ } | {
241
+ type: SamplingStrategyType.CUSTOM;
242
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
243
+ } | undefined;
244
+ exporters?: any[] | undefined;
245
+ spanOutputProcessors?: any[] | undefined;
246
+ includeInternalSpans?: boolean | undefined;
247
+ requestContextKeys?: string[] | undefined;
248
+ }, {
249
+ serviceName: string;
250
+ sampling?: {
251
+ type: SamplingStrategyType.ALWAYS;
252
+ } | {
253
+ type: SamplingStrategyType.NEVER;
254
+ } | {
255
+ type: SamplingStrategyType.RATIO;
256
+ probability: number;
257
+ } | {
258
+ type: SamplingStrategyType.CUSTOM;
259
+ sampler: (args_0: any, ...args: unknown[]) => boolean;
260
+ } | undefined;
261
+ exporters?: any[] | undefined;
262
+ spanOutputProcessors?: any[] | undefined;
263
+ includeInternalSpans?: boolean | undefined;
264
+ requestContextKeys?: string[] | undefined;
265
+ }>;
266
+ /**
267
+ * Zod schema for ObservabilityRegistryConfig
268
+ * Note: Individual configs are validated separately in the constructor to allow for
269
+ * both plain config objects and pre-instantiated ObservabilityInstance objects.
270
+ * The schema is permissive to handle edge cases gracefully (arrays, null values).
271
+ */
272
+ export declare const observabilityRegistryConfigSchema: z.ZodEffects<z.ZodEffects<z.ZodObject<{
273
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
274
+ enabled: z.ZodOptional<z.ZodBoolean>;
275
+ }, "strip", z.ZodTypeAny, {
276
+ enabled?: boolean | undefined;
277
+ }, {
278
+ enabled?: boolean | undefined;
279
+ }>>>;
280
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
281
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
282
+ }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
283
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
284
+ enabled: z.ZodOptional<z.ZodBoolean>;
285
+ }, "strip", z.ZodTypeAny, {
286
+ enabled?: boolean | undefined;
287
+ }, {
288
+ enabled?: boolean | undefined;
289
+ }>>>;
290
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
291
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
292
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
293
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
294
+ enabled: z.ZodOptional<z.ZodBoolean>;
295
+ }, "strip", z.ZodTypeAny, {
296
+ enabled?: boolean | undefined;
297
+ }, {
298
+ enabled?: boolean | undefined;
299
+ }>>>;
300
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
301
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
302
+ }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
303
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
304
+ enabled: z.ZodOptional<z.ZodBoolean>;
305
+ }, "strip", z.ZodTypeAny, {
306
+ enabled?: boolean | undefined;
307
+ }, {
308
+ enabled?: boolean | undefined;
309
+ }>>>;
310
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
311
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
312
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
313
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
314
+ enabled: z.ZodOptional<z.ZodBoolean>;
315
+ }, "strip", z.ZodTypeAny, {
316
+ enabled?: boolean | undefined;
317
+ }, {
318
+ enabled?: boolean | undefined;
319
+ }>>>;
320
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
321
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
322
+ }, z.ZodTypeAny, "passthrough">>, z.objectOutputType<{
323
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
324
+ enabled: z.ZodOptional<z.ZodBoolean>;
325
+ }, "strip", z.ZodTypeAny, {
326
+ enabled?: boolean | undefined;
327
+ }, {
328
+ enabled?: boolean | undefined;
329
+ }>>>;
330
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
331
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
332
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
333
+ default: z.ZodNullable<z.ZodOptional<z.ZodObject<{
334
+ enabled: z.ZodOptional<z.ZodBoolean>;
335
+ }, "strip", z.ZodTypeAny, {
336
+ enabled?: boolean | undefined;
337
+ }, {
338
+ enabled?: boolean | undefined;
339
+ }>>>;
340
+ configs: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodAny>, z.ZodArray<z.ZodAny, "many">, z.ZodNull]>>;
341
+ configSelector: z.ZodOptional<z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>>;
342
+ }, z.ZodTypeAny, "passthrough">>;
343
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,cAAc,EACf,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAA;CAAE,CAAC;AAMhG;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,qFAAqF;IACrF,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,uBAAuB;IACvB,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACpC,oCAAoC;IACpC,oBAAoB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC7C,iFAAiF;IACjF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qFAAqF;IACrF,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,2BAA2B,EAAE,MAAM,CAAC,GAAG,qBAAqB,CAAC,CAAC;IAC5F,yEAAyE;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAMD;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAejC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQ5C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOzC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAiD3C,CAAC"}
@@ -0,0 +1,29 @@
1
+ import type { Mastra } from '@mastra/core';
2
+ import { MastraBase } from '@mastra/core/base';
3
+ import type { IMastraLogger } from '@mastra/core/logger';
4
+ import type { ConfigSelector, ConfigSelectorOptions, ObservabilityEntrypoint, ObservabilityInstance } from '@mastra/core/observability';
5
+ import type { ObservabilityRegistryConfig } from './config.js';
6
+ export declare class Observability extends MastraBase implements ObservabilityEntrypoint {
7
+ #private;
8
+ constructor(config: ObservabilityRegistryConfig);
9
+ setMastraContext(options: {
10
+ mastra: Mastra;
11
+ }): void;
12
+ setLogger(options: {
13
+ logger: IMastraLogger;
14
+ }): void;
15
+ getSelectedInstance(options: ConfigSelectorOptions): ObservabilityInstance | undefined;
16
+ /**
17
+ * Registry management methods
18
+ */
19
+ registerInstance(name: string, instance: ObservabilityInstance, isDefault?: boolean): void;
20
+ getInstance(name: string): ObservabilityInstance | undefined;
21
+ getDefaultInstance(): ObservabilityInstance | undefined;
22
+ listInstances(): ReadonlyMap<string, ObservabilityInstance>;
23
+ unregisterInstance(name: string): boolean;
24
+ hasInstance(name: string): boolean;
25
+ setConfigSelector(selector: ConfigSelector): void;
26
+ clear(): void;
27
+ shutdown(): Promise<void>;
28
+ }
29
+ //# sourceMappingURL=default.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../src/default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAA+B,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAezF,qBAAa,aAAc,SAAQ,UAAW,YAAW,uBAAuB;;gBAGlE,MAAM,EAAE,2BAA2B;IAsF/C,gBAAgB,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAuBnD,SAAS,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,IAAI;IAOnD,mBAAmB,CAAC,OAAO,EAAE,qBAAqB,GAAG,qBAAqB,GAAG,SAAS;IAItF;;OAEG;IAEH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,qBAAqB,EAAE,SAAS,UAAQ,GAAG,IAAI;IAIxF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAI5D,kBAAkB,IAAI,qBAAqB,GAAG,SAAS;IAIvD,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAI3D,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIzC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,iBAAiB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIjD,KAAK,IAAI,IAAI;IAIP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}