@mastra/core 1.7.0 → 1.8.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 (498) hide show
  1. package/CHANGELOG.md +218 -0
  2. package/dist/agent/agent-legacy.d.ts +15 -0
  3. package/dist/agent/agent-legacy.d.ts.map +1 -1
  4. package/dist/agent/agent.d.ts +7 -0
  5. package/dist/agent/agent.d.ts.map +1 -1
  6. package/dist/agent/agent.types.d.ts +311 -2
  7. package/dist/agent/agent.types.d.ts.map +1 -1
  8. package/dist/agent/index.cjs +13 -13
  9. package/dist/agent/index.d.ts +3 -1
  10. package/dist/agent/index.d.ts.map +1 -1
  11. package/dist/agent/index.js +2 -2
  12. package/dist/agent/message-list/index.cjs +18 -18
  13. package/dist/agent/message-list/index.js +1 -1
  14. package/dist/agent/message-list/merge/MessageMerger.d.ts.map +1 -1
  15. package/dist/agent/message-list/message-list.d.ts.map +1 -1
  16. package/dist/agent/workflows/prepare-stream/map-results-step.d.ts.map +1 -1
  17. package/dist/agent/workflows/prepare-stream/prepare-tools-step.d.ts.map +1 -1
  18. package/dist/{chunk-A72NTLFT.cjs → chunk-2IO5Q7OZ.cjs} +7 -7
  19. package/dist/{chunk-A72NTLFT.cjs.map → chunk-2IO5Q7OZ.cjs.map} +1 -1
  20. package/dist/{chunk-DFCRXDVK.js → chunk-2KHPZJNU.js} +10 -8
  21. package/dist/chunk-2KHPZJNU.js.map +1 -0
  22. package/dist/{chunk-R4N65TLG.js → chunk-2R5MQMSA.js} +35 -16
  23. package/dist/chunk-2R5MQMSA.js.map +1 -0
  24. package/dist/{chunk-ZSBM2SVU.js → chunk-4H5F6AFP.js} +1064 -226
  25. package/dist/chunk-4H5F6AFP.js.map +1 -0
  26. package/dist/{chunk-BQHWJLXU.js → chunk-63G75DJE.js} +9 -3
  27. package/dist/chunk-63G75DJE.js.map +1 -0
  28. package/dist/{chunk-SBOHDNIZ.cjs → chunk-6GSWC5ZA.cjs} +2 -2
  29. package/dist/{chunk-SBOHDNIZ.cjs.map → chunk-6GSWC5ZA.cjs.map} +1 -1
  30. package/dist/{chunk-QTAS3HND.cjs → chunk-6Q2UD3XF.cjs} +21 -14
  31. package/dist/chunk-6Q2UD3XF.cjs.map +1 -0
  32. package/dist/{chunk-GPJGPARM.js → chunk-DTPR3JAM.js} +2 -2
  33. package/dist/{chunk-GPJGPARM.js.map → chunk-DTPR3JAM.js.map} +1 -1
  34. package/dist/{chunk-NN26FSKL.js → chunk-FHJ2KIU5.js} +3 -3
  35. package/dist/{chunk-NN26FSKL.js.map → chunk-FHJ2KIU5.js.map} +1 -1
  36. package/dist/{chunk-RABITNTG.cjs → chunk-HWG7NPJA.cjs} +55 -55
  37. package/dist/{chunk-RABITNTG.cjs.map → chunk-HWG7NPJA.cjs.map} +1 -1
  38. package/dist/{chunk-HB6T4554.cjs → chunk-KH3G65IS.cjs} +10 -8
  39. package/dist/chunk-KH3G65IS.cjs.map +1 -0
  40. package/dist/{chunk-YQG7NBPR.cjs → chunk-KZ4IKNPN.cjs} +25 -23
  41. package/dist/chunk-KZ4IKNPN.cjs.map +1 -0
  42. package/dist/{chunk-6DUTLERJ.js → chunk-MRV5NCPC.js} +3 -3
  43. package/dist/{chunk-6DUTLERJ.js.map → chunk-MRV5NCPC.js.map} +1 -1
  44. package/dist/{chunk-O7PZ4VOO.cjs → chunk-N3ROEJG4.cjs} +12 -10
  45. package/dist/chunk-N3ROEJG4.cjs.map +1 -0
  46. package/dist/{chunk-7EXW4AAG.js → chunk-NXKI2L4X.js} +6 -4
  47. package/dist/chunk-NXKI2L4X.js.map +1 -0
  48. package/dist/{chunk-QWTB53GS.js → chunk-OSEPGSLN.js} +6 -6
  49. package/dist/{chunk-QWTB53GS.js.map → chunk-OSEPGSLN.js.map} +1 -1
  50. package/dist/{chunk-6OXW5E2O.js → chunk-PI7ONENO.js} +4 -4
  51. package/dist/{chunk-6OXW5E2O.js.map → chunk-PI7ONENO.js.map} +1 -1
  52. package/dist/{chunk-KUXNBWN7.js → chunk-Q4MV4XKX.js} +8 -6
  53. package/dist/chunk-Q4MV4XKX.js.map +1 -0
  54. package/dist/{chunk-7UAJ6LMR.cjs → chunk-QKQGKEN7.cjs} +1078 -241
  55. package/dist/chunk-QKQGKEN7.cjs.map +1 -0
  56. package/dist/{chunk-IC5OUWKJ.js → chunk-SP7P6Z4L.js} +19 -2
  57. package/dist/chunk-SP7P6Z4L.js.map +1 -0
  58. package/dist/{chunk-QDH6MVJ7.cjs → chunk-TGUDI64A.cjs} +14 -14
  59. package/dist/{chunk-QDH6MVJ7.cjs.map → chunk-TGUDI64A.cjs.map} +1 -1
  60. package/dist/{chunk-EAZ6YDCQ.cjs → chunk-U3HBG2GU.cjs} +9 -2
  61. package/dist/chunk-U3HBG2GU.cjs.map +1 -0
  62. package/dist/{chunk-6QBN6MZY.cjs → chunk-VAKB5EXJ.cjs} +42 -23
  63. package/dist/chunk-VAKB5EXJ.cjs.map +1 -0
  64. package/dist/{chunk-QSHV7GPT.js → chunk-VBPU6CLZ.js} +3808 -3026
  65. package/dist/chunk-VBPU6CLZ.js.map +1 -0
  66. package/dist/{chunk-2X66GWF5.cjs → chunk-VTVCMIAI.cjs} +3905 -3121
  67. package/dist/chunk-VTVCMIAI.cjs.map +1 -0
  68. package/dist/{chunk-PHHJLGZU.cjs → chunk-XNWF6CYR.cjs} +6 -6
  69. package/dist/{chunk-PHHJLGZU.cjs.map → chunk-XNWF6CYR.cjs.map} +1 -1
  70. package/dist/{chunk-T6GAM3SQ.js → chunk-ZRPTWYWJ.js} +18 -11
  71. package/dist/chunk-ZRPTWYWJ.js.map +1 -0
  72. package/dist/{chunk-DB7U2C5B.cjs → chunk-ZXOWG32X.cjs} +19 -2
  73. package/dist/chunk-ZXOWG32X.cjs.map +1 -0
  74. package/dist/datasets/experiment/index.d.ts.map +1 -1
  75. package/dist/datasets/experiment/scorer.d.ts +1 -1
  76. package/dist/datasets/experiment/scorer.d.ts.map +1 -1
  77. package/dist/datasets/index.cjs +17 -17
  78. package/dist/datasets/index.js +2 -2
  79. package/dist/docs/SKILL.md +300 -0
  80. package/dist/docs/assets/SOURCE_MAP.json +1423 -0
  81. package/dist/docs/references/docs-agents-adding-voice.md +349 -0
  82. package/dist/docs/references/docs-agents-agent-approval.md +558 -0
  83. package/dist/docs/references/docs-agents-agent-memory.md +209 -0
  84. package/dist/docs/references/docs-agents-guardrails.md +374 -0
  85. package/dist/docs/references/docs-agents-network-approval.md +275 -0
  86. package/dist/docs/references/docs-agents-networks.md +299 -0
  87. package/dist/docs/references/docs-agents-overview.md +304 -0
  88. package/dist/docs/references/docs-agents-processors.md +622 -0
  89. package/dist/docs/references/docs-agents-structured-output.md +273 -0
  90. package/dist/docs/references/docs-agents-supervisor-agents.md +304 -0
  91. package/dist/docs/references/docs-agents-using-tools.md +214 -0
  92. package/dist/docs/references/docs-evals-custom-scorers.md +519 -0
  93. package/dist/docs/references/docs-evals-overview.md +141 -0
  94. package/dist/docs/references/docs-evals-running-in-ci.md +124 -0
  95. package/dist/docs/references/docs-memory-memory-processors.md +314 -0
  96. package/dist/docs/references/docs-memory-observational-memory.md +248 -0
  97. package/dist/docs/references/docs-memory-overview.md +45 -0
  98. package/dist/docs/references/docs-memory-semantic-recall.md +272 -0
  99. package/dist/docs/references/docs-memory-storage.md +261 -0
  100. package/dist/docs/references/docs-memory-working-memory.md +400 -0
  101. package/dist/docs/references/docs-observability-datasets-overview.md +198 -0
  102. package/dist/docs/references/docs-observability-datasets-running-experiments.md +274 -0
  103. package/dist/docs/references/docs-observability-logging.md +99 -0
  104. package/dist/docs/references/docs-observability-overview.md +70 -0
  105. package/dist/docs/references/docs-observability-tracing-bridges-otel.md +209 -0
  106. package/dist/docs/references/docs-observability-tracing-exporters-arize.md +272 -0
  107. package/dist/docs/references/docs-observability-tracing-exporters-braintrust.md +111 -0
  108. package/dist/docs/references/docs-observability-tracing-exporters-cloud.md +127 -0
  109. package/dist/docs/references/docs-observability-tracing-exporters-datadog.md +187 -0
  110. package/dist/docs/references/docs-observability-tracing-exporters-default.md +209 -0
  111. package/dist/docs/references/docs-observability-tracing-exporters-laminar.md +100 -0
  112. package/dist/docs/references/docs-observability-tracing-exporters-langfuse.md +213 -0
  113. package/dist/docs/references/docs-observability-tracing-exporters-langsmith.md +198 -0
  114. package/dist/docs/references/docs-observability-tracing-exporters-otel.md +476 -0
  115. package/dist/docs/references/docs-observability-tracing-exporters-posthog.md +148 -0
  116. package/dist/docs/references/docs-observability-tracing-overview.md +1112 -0
  117. package/dist/docs/references/docs-rag-chunking-and-embedding.md +183 -0
  118. package/dist/docs/references/docs-rag-graph-rag.md +215 -0
  119. package/dist/docs/references/docs-rag-overview.md +72 -0
  120. package/dist/docs/references/docs-rag-retrieval.md +515 -0
  121. package/dist/docs/references/docs-rag-vector-databases.md +645 -0
  122. package/dist/docs/references/docs-server-auth-auth0.md +220 -0
  123. package/dist/docs/references/docs-server-auth-clerk.md +132 -0
  124. package/dist/docs/references/docs-server-auth-composite-auth.md +234 -0
  125. package/dist/docs/references/docs-server-auth-custom-auth-provider.md +513 -0
  126. package/dist/docs/references/docs-server-auth-firebase.md +272 -0
  127. package/dist/docs/references/docs-server-auth-jwt.md +110 -0
  128. package/dist/docs/references/docs-server-auth-simple-auth.md +180 -0
  129. package/dist/docs/references/docs-server-auth-supabase.md +117 -0
  130. package/dist/docs/references/docs-server-auth-workos.md +186 -0
  131. package/dist/docs/references/docs-server-custom-adapters.md +378 -0
  132. package/dist/docs/references/docs-server-custom-api-routes.md +267 -0
  133. package/dist/docs/references/docs-server-mastra-client.md +243 -0
  134. package/dist/docs/references/docs-server-mastra-server.md +71 -0
  135. package/dist/docs/references/docs-server-middleware.md +225 -0
  136. package/dist/docs/references/docs-server-request-context.md +471 -0
  137. package/dist/docs/references/docs-streaming-events.md +237 -0
  138. package/dist/docs/references/docs-streaming-tool-streaming.md +175 -0
  139. package/dist/docs/references/docs-streaming-workflow-streaming.md +109 -0
  140. package/dist/docs/references/docs-voice-overview.md +959 -0
  141. package/dist/docs/references/docs-voice-speech-to-speech.md +102 -0
  142. package/dist/docs/references/docs-voice-speech-to-text.md +79 -0
  143. package/dist/docs/references/docs-voice-text-to-speech.md +83 -0
  144. package/dist/docs/references/docs-workflows-agents-and-tools.md +166 -0
  145. package/dist/docs/references/docs-workflows-control-flow.md +822 -0
  146. package/dist/docs/references/docs-workflows-error-handling.md +360 -0
  147. package/dist/docs/references/docs-workflows-human-in-the-loop.md +215 -0
  148. package/dist/docs/references/docs-workflows-overview.md +370 -0
  149. package/dist/docs/references/docs-workflows-snapshots.md +238 -0
  150. package/dist/docs/references/docs-workflows-suspend-and-resume.md +205 -0
  151. package/dist/docs/references/docs-workflows-time-travel.md +309 -0
  152. package/dist/docs/references/docs-workflows-workflow-state.md +181 -0
  153. package/dist/docs/references/docs-workspace-filesystem.md +164 -0
  154. package/dist/docs/references/docs-workspace-overview.md +239 -0
  155. package/dist/docs/references/docs-workspace-sandbox.md +63 -0
  156. package/dist/docs/references/docs-workspace-search.md +243 -0
  157. package/dist/docs/references/docs-workspace-skills.md +169 -0
  158. package/dist/docs/references/guides-agent-frameworks-ai-sdk.md +140 -0
  159. package/dist/docs/references/reference-agents-agent.md +141 -0
  160. package/dist/docs/references/reference-agents-generate.md +186 -0
  161. package/dist/docs/references/reference-agents-generateLegacy.md +173 -0
  162. package/dist/docs/references/reference-agents-getDefaultGenerateOptions.md +36 -0
  163. package/dist/docs/references/reference-agents-getDefaultOptions.md +34 -0
  164. package/dist/docs/references/reference-agents-getDefaultStreamOptions.md +36 -0
  165. package/dist/docs/references/reference-agents-getDescription.md +21 -0
  166. package/dist/docs/references/reference-agents-getInstructions.md +34 -0
  167. package/dist/docs/references/reference-agents-getLLM.md +37 -0
  168. package/dist/docs/references/reference-agents-getMemory.md +34 -0
  169. package/dist/docs/references/reference-agents-getModel.md +34 -0
  170. package/dist/docs/references/reference-agents-getTools.md +29 -0
  171. package/dist/docs/references/reference-agents-getVoice.md +34 -0
  172. package/dist/docs/references/reference-agents-listAgents.md +35 -0
  173. package/dist/docs/references/reference-agents-listScorers.md +34 -0
  174. package/dist/docs/references/reference-agents-listTools.md +34 -0
  175. package/dist/docs/references/reference-agents-listWorkflows.md +34 -0
  176. package/dist/docs/references/reference-agents-network.md +133 -0
  177. package/dist/docs/references/reference-ai-sdk-chat-route.md +82 -0
  178. package/dist/docs/references/reference-ai-sdk-network-route.md +74 -0
  179. package/dist/docs/references/reference-ai-sdk-to-ai-sdk-stream.md +231 -0
  180. package/dist/docs/references/reference-ai-sdk-with-mastra.md +59 -0
  181. package/dist/docs/references/reference-ai-sdk-workflow-route.md +79 -0
  182. package/dist/docs/references/reference-auth-auth0.md +73 -0
  183. package/dist/docs/references/reference-auth-clerk.md +36 -0
  184. package/dist/docs/references/reference-auth-firebase.md +80 -0
  185. package/dist/docs/references/reference-auth-jwt.md +26 -0
  186. package/dist/docs/references/reference-auth-supabase.md +33 -0
  187. package/dist/docs/references/reference-auth-workos.md +84 -0
  188. package/dist/docs/references/reference-client-js-agents.md +437 -0
  189. package/dist/docs/references/reference-configuration.md +752 -0
  190. package/dist/docs/references/reference-core-addGateway.md +42 -0
  191. package/dist/docs/references/reference-core-getAgent.md +21 -0
  192. package/dist/docs/references/reference-core-getAgentById.md +21 -0
  193. package/dist/docs/references/reference-core-getDeployer.md +22 -0
  194. package/dist/docs/references/reference-core-getGateway.md +38 -0
  195. package/dist/docs/references/reference-core-getGatewayById.md +41 -0
  196. package/dist/docs/references/reference-core-getLogger.md +22 -0
  197. package/dist/docs/references/reference-core-getMCPServer.md +47 -0
  198. package/dist/docs/references/reference-core-getMCPServerById.md +55 -0
  199. package/dist/docs/references/reference-core-getMemory.md +50 -0
  200. package/dist/docs/references/reference-core-getScorer.md +54 -0
  201. package/dist/docs/references/reference-core-getScorerById.md +54 -0
  202. package/dist/docs/references/reference-core-getServer.md +22 -0
  203. package/dist/docs/references/reference-core-getStorage.md +22 -0
  204. package/dist/docs/references/reference-core-getStoredAgentById.md +89 -0
  205. package/dist/docs/references/reference-core-getTelemetry.md +22 -0
  206. package/dist/docs/references/reference-core-getVector.md +22 -0
  207. package/dist/docs/references/reference-core-getWorkflow.md +42 -0
  208. package/dist/docs/references/reference-core-listAgents.md +21 -0
  209. package/dist/docs/references/reference-core-listGateways.md +40 -0
  210. package/dist/docs/references/reference-core-listLogs.md +38 -0
  211. package/dist/docs/references/reference-core-listLogsByRunId.md +36 -0
  212. package/dist/docs/references/reference-core-listMCPServers.md +55 -0
  213. package/dist/docs/references/reference-core-listMemory.md +56 -0
  214. package/dist/docs/references/reference-core-listScorers.md +29 -0
  215. package/dist/docs/references/reference-core-listStoredAgents.md +93 -0
  216. package/dist/docs/references/reference-core-listVectors.md +22 -0
  217. package/dist/docs/references/reference-core-listWorkflows.md +21 -0
  218. package/dist/docs/references/reference-core-mastra-class.md +66 -0
  219. package/dist/docs/references/reference-core-mastra-model-gateway.md +153 -0
  220. package/dist/docs/references/reference-core-setLogger.md +26 -0
  221. package/dist/docs/references/reference-core-setStorage.md +27 -0
  222. package/dist/docs/references/reference-datasets-addItem.md +37 -0
  223. package/dist/docs/references/reference-datasets-addItems.md +35 -0
  224. package/dist/docs/references/reference-datasets-compareExperiments.md +52 -0
  225. package/dist/docs/references/reference-datasets-create.md +51 -0
  226. package/dist/docs/references/reference-datasets-dataset.md +82 -0
  227. package/dist/docs/references/reference-datasets-datasets-manager.md +94 -0
  228. package/dist/docs/references/reference-datasets-delete.md +25 -0
  229. package/dist/docs/references/reference-datasets-deleteExperiment.md +27 -0
  230. package/dist/docs/references/reference-datasets-deleteItem.md +27 -0
  231. package/dist/docs/references/reference-datasets-deleteItems.md +29 -0
  232. package/dist/docs/references/reference-datasets-get.md +31 -0
  233. package/dist/docs/references/reference-datasets-getDetails.md +47 -0
  234. package/dist/docs/references/reference-datasets-getExperiment.md +30 -0
  235. package/dist/docs/references/reference-datasets-getItem.md +33 -0
  236. package/dist/docs/references/reference-datasets-getItemHistory.md +31 -0
  237. package/dist/docs/references/reference-datasets-list.md +31 -0
  238. package/dist/docs/references/reference-datasets-listExperimentResults.md +39 -0
  239. package/dist/docs/references/reference-datasets-listExperiments.md +33 -0
  240. package/dist/docs/references/reference-datasets-listItems.md +46 -0
  241. package/dist/docs/references/reference-datasets-listVersions.md +33 -0
  242. package/dist/docs/references/reference-datasets-startExperiment.md +62 -0
  243. package/dist/docs/references/reference-datasets-startExperimentAsync.md +43 -0
  244. package/dist/docs/references/reference-datasets-update.md +48 -0
  245. package/dist/docs/references/reference-datasets-updateItem.md +38 -0
  246. package/dist/docs/references/reference-evals-answer-relevancy.md +105 -0
  247. package/dist/docs/references/reference-evals-answer-similarity.md +99 -0
  248. package/dist/docs/references/reference-evals-bias.md +120 -0
  249. package/dist/docs/references/reference-evals-completeness.md +136 -0
  250. package/dist/docs/references/reference-evals-content-similarity.md +101 -0
  251. package/dist/docs/references/reference-evals-context-precision.md +196 -0
  252. package/dist/docs/references/reference-evals-create-scorer.md +270 -0
  253. package/dist/docs/references/reference-evals-faithfulness.md +114 -0
  254. package/dist/docs/references/reference-evals-hallucination.md +213 -0
  255. package/dist/docs/references/reference-evals-keyword-coverage.md +128 -0
  256. package/dist/docs/references/reference-evals-mastra-scorer.md +123 -0
  257. package/dist/docs/references/reference-evals-run-evals.md +179 -0
  258. package/dist/docs/references/reference-evals-scorer-utils.md +326 -0
  259. package/dist/docs/references/reference-evals-textual-difference.md +113 -0
  260. package/dist/docs/references/reference-evals-tone-consistency.md +119 -0
  261. package/dist/docs/references/reference-evals-toxicity.md +123 -0
  262. package/dist/docs/references/reference-harness-harness-class.md +708 -0
  263. package/dist/docs/references/reference-logging-pino-logger.md +117 -0
  264. package/dist/docs/references/reference-memory-deleteMessages.md +38 -0
  265. package/dist/docs/references/reference-memory-memory-class.md +147 -0
  266. package/dist/docs/references/reference-memory-observational-memory.md +565 -0
  267. package/dist/docs/references/reference-observability-tracing-bridges-otel.md +131 -0
  268. package/dist/docs/references/reference-observability-tracing-configuration.md +178 -0
  269. package/dist/docs/references/reference-observability-tracing-exporters-console-exporter.md +138 -0
  270. package/dist/docs/references/reference-observability-tracing-exporters-datadog.md +116 -0
  271. package/dist/docs/references/reference-observability-tracing-instances.md +107 -0
  272. package/dist/docs/references/reference-observability-tracing-interfaces.md +743 -0
  273. package/dist/docs/references/reference-observability-tracing-processors-sensitive-data-filter.md +144 -0
  274. package/dist/docs/references/reference-observability-tracing-spans.md +224 -0
  275. package/dist/docs/references/reference-processors-batch-parts-processor.md +61 -0
  276. package/dist/docs/references/reference-processors-language-detector.md +82 -0
  277. package/dist/docs/references/reference-processors-message-history-processor.md +85 -0
  278. package/dist/docs/references/reference-processors-moderation-processor.md +104 -0
  279. package/dist/docs/references/reference-processors-pii-detector.md +108 -0
  280. package/dist/docs/references/reference-processors-processor-interface.md +521 -0
  281. package/dist/docs/references/reference-processors-prompt-injection-detector.md +72 -0
  282. package/dist/docs/references/reference-processors-semantic-recall-processor.md +117 -0
  283. package/dist/docs/references/reference-processors-system-prompt-scrubber.md +80 -0
  284. package/dist/docs/references/reference-processors-token-limiter-processor.md +115 -0
  285. package/dist/docs/references/reference-processors-tool-call-filter.md +85 -0
  286. package/dist/docs/references/reference-processors-tool-search-processor.md +111 -0
  287. package/dist/docs/references/reference-processors-unicode-normalizer.md +62 -0
  288. package/dist/docs/references/reference-processors-working-memory-processor.md +152 -0
  289. package/dist/docs/references/reference-rag-database-config.md +261 -0
  290. package/dist/docs/references/reference-rag-embeddings.md +92 -0
  291. package/dist/docs/references/reference-server-mastra-server.md +298 -0
  292. package/dist/docs/references/reference-server-register-api-route.md +249 -0
  293. package/dist/docs/references/reference-storage-cloudflare-d1.md +218 -0
  294. package/dist/docs/references/reference-storage-composite.md +235 -0
  295. package/dist/docs/references/reference-storage-lance.md +131 -0
  296. package/dist/docs/references/reference-storage-libsql.md +135 -0
  297. package/dist/docs/references/reference-storage-mongodb.md +262 -0
  298. package/dist/docs/references/reference-storage-mssql.md +157 -0
  299. package/dist/docs/references/reference-storage-overview.md +121 -0
  300. package/dist/docs/references/reference-storage-postgresql.md +526 -0
  301. package/dist/docs/references/reference-storage-upstash.md +160 -0
  302. package/dist/docs/references/reference-streaming-ChunkType.md +292 -0
  303. package/dist/docs/references/reference-streaming-agents-MastraModelOutput.md +182 -0
  304. package/dist/docs/references/reference-streaming-agents-streamLegacy.md +142 -0
  305. package/dist/docs/references/reference-streaming-workflows-observeStream.md +42 -0
  306. package/dist/docs/references/reference-streaming-workflows-resumeStream.md +61 -0
  307. package/dist/docs/references/reference-streaming-workflows-stream.md +88 -0
  308. package/dist/docs/references/reference-streaming-workflows-timeTravelStream.md +142 -0
  309. package/dist/docs/references/reference-templates-overview.md +194 -0
  310. package/dist/docs/references/reference-tools-create-tool.md +237 -0
  311. package/dist/docs/references/reference-tools-graph-rag-tool.md +182 -0
  312. package/dist/docs/references/reference-tools-mcp-client.md +954 -0
  313. package/dist/docs/references/reference-tools-mcp-server.md +1271 -0
  314. package/dist/docs/references/reference-tools-vector-query-tool.md +459 -0
  315. package/dist/docs/references/reference-vectors-libsql.md +305 -0
  316. package/dist/docs/references/reference-vectors-mongodb.md +295 -0
  317. package/dist/docs/references/reference-vectors-pg.md +408 -0
  318. package/dist/docs/references/reference-vectors-upstash.md +294 -0
  319. package/dist/docs/references/reference-voice-composite-voice.md +121 -0
  320. package/dist/docs/references/reference-voice-mastra-voice.md +311 -0
  321. package/dist/docs/references/reference-voice-voice.addInstructions.md +55 -0
  322. package/dist/docs/references/reference-voice-voice.addTools.md +67 -0
  323. package/dist/docs/references/reference-voice-voice.connect.md +94 -0
  324. package/dist/docs/references/reference-voice-voice.events.md +37 -0
  325. package/dist/docs/references/reference-voice-voice.listen.md +164 -0
  326. package/dist/docs/references/reference-voice-voice.on.md +111 -0
  327. package/dist/docs/references/reference-voice-voice.speak.md +157 -0
  328. package/dist/docs/references/reference-workflows-run-methods-cancel.md +86 -0
  329. package/dist/docs/references/reference-workflows-run-methods-restart.md +33 -0
  330. package/dist/docs/references/reference-workflows-run-methods-resume.md +59 -0
  331. package/dist/docs/references/reference-workflows-run-methods-start.md +58 -0
  332. package/dist/docs/references/reference-workflows-run-methods-startAsync.md +67 -0
  333. package/dist/docs/references/reference-workflows-run-methods-timeTravel.md +142 -0
  334. package/dist/docs/references/reference-workflows-run.md +59 -0
  335. package/dist/docs/references/reference-workflows-step.md +119 -0
  336. package/dist/docs/references/reference-workflows-workflow-methods-branch.md +25 -0
  337. package/dist/docs/references/reference-workflows-workflow-methods-commit.md +17 -0
  338. package/dist/docs/references/reference-workflows-workflow-methods-create-run.md +63 -0
  339. package/dist/docs/references/reference-workflows-workflow-methods-dountil.md +25 -0
  340. package/dist/docs/references/reference-workflows-workflow-methods-dowhile.md +25 -0
  341. package/dist/docs/references/reference-workflows-workflow-methods-foreach.md +118 -0
  342. package/dist/docs/references/reference-workflows-workflow-methods-map.md +93 -0
  343. package/dist/docs/references/reference-workflows-workflow-methods-parallel.md +21 -0
  344. package/dist/docs/references/reference-workflows-workflow-methods-sleep.md +35 -0
  345. package/dist/docs/references/reference-workflows-workflow-methods-sleepUntil.md +35 -0
  346. package/dist/docs/references/reference-workflows-workflow-methods-then.md +21 -0
  347. package/dist/docs/references/reference-workflows-workflow.md +157 -0
  348. package/dist/docs/references/reference-workspace-filesystem.md +255 -0
  349. package/dist/docs/references/reference-workspace-local-filesystem.md +343 -0
  350. package/dist/docs/references/reference-workspace-local-sandbox.md +301 -0
  351. package/dist/docs/references/reference-workspace-sandbox.md +87 -0
  352. package/dist/docs/references/reference-workspace-workspace-class.md +244 -0
  353. package/dist/docs/references/reference.md +277 -0
  354. package/dist/evals/index.cjs +20 -20
  355. package/dist/evals/index.js +3 -3
  356. package/dist/evals/run/index.d.ts +9 -2
  357. package/dist/evals/run/index.d.ts.map +1 -1
  358. package/dist/evals/scoreTraces/index.cjs +5 -5
  359. package/dist/evals/scoreTraces/index.js +2 -2
  360. package/dist/harness/harness.d.ts +6 -0
  361. package/dist/harness/harness.d.ts.map +1 -1
  362. package/dist/harness/index.cjs +28 -13
  363. package/dist/harness/index.cjs.map +1 -1
  364. package/dist/harness/index.js +20 -5
  365. package/dist/harness/index.js.map +1 -1
  366. package/dist/index.cjs +2 -2
  367. package/dist/index.js +1 -1
  368. package/dist/integration/index.cjs +2 -2
  369. package/dist/integration/index.js +1 -1
  370. package/dist/llm/index.cjs +6 -6
  371. package/dist/llm/index.js +1 -1
  372. package/dist/llm/model/embedding-router.d.ts.map +1 -1
  373. package/dist/llm/model/model.loop.d.ts +1 -1
  374. package/dist/llm/model/model.loop.d.ts.map +1 -1
  375. package/dist/loop/index.cjs +20 -12
  376. package/dist/loop/index.js +1 -1
  377. package/dist/loop/network/index.d.ts.map +1 -1
  378. package/dist/loop/network/validation.d.ts +51 -0
  379. package/dist/loop/network/validation.d.ts.map +1 -1
  380. package/dist/loop/test-utils/generateText.d.ts.map +1 -1
  381. package/dist/loop/test-utils/options.d.ts.map +1 -1
  382. package/dist/loop/test-utils/streamObject.d.ts.map +1 -1
  383. package/dist/loop/types.d.ts +15 -0
  384. package/dist/loop/types.d.ts.map +1 -1
  385. package/dist/loop/workflows/agentic-execution/index.d.ts +3 -0
  386. package/dist/loop/workflows/agentic-execution/index.d.ts.map +1 -1
  387. package/dist/loop/workflows/agentic-execution/is-task-complete-step.d.ts +126 -0
  388. package/dist/loop/workflows/agentic-execution/is-task-complete-step.d.ts.map +1 -0
  389. package/dist/loop/workflows/agentic-execution/llm-execution-step.d.ts +3 -1
  390. package/dist/loop/workflows/agentic-execution/llm-execution-step.d.ts.map +1 -1
  391. package/dist/loop/workflows/agentic-execution/llm-mapping-step.d.ts +1 -0
  392. package/dist/loop/workflows/agentic-execution/llm-mapping-step.d.ts.map +1 -1
  393. package/dist/loop/workflows/agentic-execution/tool-call-step.d.ts.map +1 -1
  394. package/dist/loop/workflows/agentic-loop/index.d.ts +3 -0
  395. package/dist/loop/workflows/agentic-loop/index.d.ts.map +1 -1
  396. package/dist/loop/workflows/schema.d.ts +3 -0
  397. package/dist/loop/workflows/schema.d.ts.map +1 -1
  398. package/dist/mastra/index.cjs +2 -2
  399. package/dist/mastra/index.d.ts +9 -5
  400. package/dist/mastra/index.d.ts.map +1 -1
  401. package/dist/mastra/index.js +1 -1
  402. package/dist/memory/index.cjs +14 -14
  403. package/dist/memory/index.js +1 -1
  404. package/dist/processor-provider/index.cjs +10 -10
  405. package/dist/processor-provider/index.js +1 -1
  406. package/dist/processors/index.cjs +42 -42
  407. package/dist/processors/index.js +1 -1
  408. package/dist/processors/processors/skills.d.ts.map +1 -1
  409. package/dist/relevance/index.cjs +3 -3
  410. package/dist/relevance/index.js +1 -1
  411. package/dist/storage/constants.cjs +56 -56
  412. package/dist/storage/constants.js +1 -1
  413. package/dist/storage/domains/memory/inmemory.d.ts.map +1 -1
  414. package/dist/storage/index.cjs +160 -160
  415. package/dist/storage/index.js +2 -2
  416. package/dist/storage/types.d.ts +2 -3
  417. package/dist/storage/types.d.ts.map +1 -1
  418. package/dist/stream/aisdk/v5/compat/prepare-tools.d.ts.map +1 -1
  419. package/dist/stream/base/output.d.ts +1 -0
  420. package/dist/stream/base/output.d.ts.map +1 -1
  421. package/dist/stream/index.cjs +11 -11
  422. package/dist/stream/index.js +2 -2
  423. package/dist/stream/types.d.ts +27 -1
  424. package/dist/stream/types.d.ts.map +1 -1
  425. package/dist/test-utils/llm-mock.cjs +4 -4
  426. package/dist/test-utils/llm-mock.js +1 -1
  427. package/dist/tool-loop-agent/index.cjs +4 -4
  428. package/dist/tool-loop-agent/index.js +1 -1
  429. package/dist/tools/index.cjs +9 -5
  430. package/dist/tools/index.d.ts +1 -1
  431. package/dist/tools/index.d.ts.map +1 -1
  432. package/dist/tools/index.js +1 -1
  433. package/dist/tools/is-vercel-tool.cjs +2 -2
  434. package/dist/tools/is-vercel-tool.js +1 -1
  435. package/dist/tools/toolchecks.d.ts +10 -0
  436. package/dist/tools/toolchecks.d.ts.map +1 -1
  437. package/dist/utils.cjs +23 -23
  438. package/dist/utils.js +1 -1
  439. package/dist/vector/index.cjs +7 -7
  440. package/dist/vector/index.js +1 -1
  441. package/dist/vector/types.d.ts +9 -1
  442. package/dist/vector/types.d.ts.map +1 -1
  443. package/dist/workflows/evented/index.cjs +10 -10
  444. package/dist/workflows/evented/index.js +1 -1
  445. package/dist/workflows/index.cjs +25 -25
  446. package/dist/workflows/index.js +1 -1
  447. package/dist/workflows/types.d.ts +14 -1
  448. package/dist/workflows/types.d.ts.map +1 -1
  449. package/dist/workflows/workflow.d.ts +3 -17
  450. package/dist/workflows/workflow.d.ts.map +1 -1
  451. package/dist/workspace/filesystem/composite-filesystem.d.ts +5 -0
  452. package/dist/workspace/filesystem/composite-filesystem.d.ts.map +1 -1
  453. package/dist/workspace/filesystem/filesystem.d.ts +12 -0
  454. package/dist/workspace/filesystem/filesystem.d.ts.map +1 -1
  455. package/dist/workspace/filesystem/fs-utils.d.ts +12 -0
  456. package/dist/workspace/filesystem/fs-utils.d.ts.map +1 -1
  457. package/dist/workspace/filesystem/local-filesystem.d.ts +6 -0
  458. package/dist/workspace/filesystem/local-filesystem.d.ts.map +1 -1
  459. package/dist/workspace/index.cjs +66 -66
  460. package/dist/workspace/index.js +1 -1
  461. package/dist/workspace/lsp/client.d.ts +76 -0
  462. package/dist/workspace/lsp/client.d.ts.map +1 -0
  463. package/dist/workspace/lsp/index.d.ts +6 -0
  464. package/dist/workspace/lsp/index.d.ts.map +1 -0
  465. package/dist/workspace/lsp/language.d.ts +16 -0
  466. package/dist/workspace/lsp/language.d.ts.map +1 -0
  467. package/dist/workspace/lsp/manager.d.ts +72 -0
  468. package/dist/workspace/lsp/manager.d.ts.map +1 -0
  469. package/dist/workspace/lsp/servers.d.ts +43 -0
  470. package/dist/workspace/lsp/servers.d.ts.map +1 -0
  471. package/dist/workspace/lsp/types.d.ts +45 -0
  472. package/dist/workspace/lsp/types.d.ts.map +1 -0
  473. package/dist/workspace/tools/ast-edit.d.ts.map +1 -1
  474. package/dist/workspace/tools/edit-file.d.ts.map +1 -1
  475. package/dist/workspace/tools/helpers.d.ts +13 -0
  476. package/dist/workspace/tools/helpers.d.ts.map +1 -1
  477. package/dist/workspace/tools/write-file.d.ts.map +1 -1
  478. package/dist/workspace/workspace.d.ts +33 -0
  479. package/dist/workspace/workspace.d.ts.map +1 -1
  480. package/package.json +10 -8
  481. package/dist/chunk-2X66GWF5.cjs.map +0 -1
  482. package/dist/chunk-6QBN6MZY.cjs.map +0 -1
  483. package/dist/chunk-7EXW4AAG.js.map +0 -1
  484. package/dist/chunk-7UAJ6LMR.cjs.map +0 -1
  485. package/dist/chunk-BQHWJLXU.js.map +0 -1
  486. package/dist/chunk-DB7U2C5B.cjs.map +0 -1
  487. package/dist/chunk-DFCRXDVK.js.map +0 -1
  488. package/dist/chunk-EAZ6YDCQ.cjs.map +0 -1
  489. package/dist/chunk-HB6T4554.cjs.map +0 -1
  490. package/dist/chunk-IC5OUWKJ.js.map +0 -1
  491. package/dist/chunk-KUXNBWN7.js.map +0 -1
  492. package/dist/chunk-O7PZ4VOO.cjs.map +0 -1
  493. package/dist/chunk-QSHV7GPT.js.map +0 -1
  494. package/dist/chunk-QTAS3HND.cjs.map +0 -1
  495. package/dist/chunk-R4N65TLG.js.map +0 -1
  496. package/dist/chunk-T6GAM3SQ.js.map +0 -1
  497. package/dist/chunk-YQG7NBPR.cjs.map +0 -1
  498. package/dist/chunk-ZSBM2SVU.js.map +0 -1
@@ -1,7 +1,7 @@
1
1
  export * from './tool.js';
2
2
  export * from './types.js';
3
3
  export * from './ui-types.js';
4
- export { isVercelTool } from './toolchecks.js';
4
+ export { isVercelTool, isProviderDefinedTool } from './toolchecks.js';
5
5
  export { ToolStream } from './stream.js';
6
6
  export { type ValidationError } from './validation.js';
7
7
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC"}
@@ -1,4 +1,4 @@
1
1
  export { ToolStream } from '../chunk-DD2VNRQM.js';
2
- export { MASTRA_TOOL_MARKER, Tool, createTool, isVercelTool } from '../chunk-BQHWJLXU.js';
2
+ export { MASTRA_TOOL_MARKER, Tool, createTool, isProviderDefinedTool, isVercelTool } from '../chunk-63G75DJE.js';
3
3
  //# sourceMappingURL=index.js.map
4
4
  //# sourceMappingURL=index.js.map
@@ -1,12 +1,12 @@
1
1
  'use strict';
2
2
 
3
- var chunkEAZ6YDCQ_cjs = require('../chunk-EAZ6YDCQ.cjs');
3
+ var chunkU3HBG2GU_cjs = require('../chunk-U3HBG2GU.cjs');
4
4
 
5
5
 
6
6
 
7
7
  Object.defineProperty(exports, "isVercelTool", {
8
8
  enumerable: true,
9
- get: function () { return chunkEAZ6YDCQ_cjs.isVercelTool; }
9
+ get: function () { return chunkU3HBG2GU_cjs.isVercelTool; }
10
10
  });
11
11
  //# sourceMappingURL=is-vercel-tool.cjs.map
12
12
  //# sourceMappingURL=is-vercel-tool.cjs.map
@@ -1,3 +1,3 @@
1
- export { isVercelTool } from '../chunk-BQHWJLXU.js';
1
+ export { isVercelTool } from '../chunk-63G75DJE.js';
2
2
  //# sourceMappingURL=is-vercel-tool.js.map
3
3
  //# sourceMappingURL=is-vercel-tool.js.map
@@ -6,4 +6,14 @@ import type { VercelTool } from './types.js';
6
6
  * @returns True if the tool is a Vercel Tool, false otherwise
7
7
  */
8
8
  export declare function isVercelTool(tool?: ToolToConvert): tool is VercelTool;
9
+ /**
10
+ * Checks if a tool is a provider-defined tool from the AI SDK.
11
+ * Provider tools (like google.tools.googleSearch(), openai.tools.webSearch()) have:
12
+ * - type: "provider-defined" (AI SDK v5) or "provider" (AI SDK v6)
13
+ * - id: in format 'provider.tool_name' (e.g., 'google.google_search')
14
+ *
15
+ * These tools have a lazy `inputSchema` function that returns an AI SDK Schema
16
+ * (not a Zod schema), so they require special handling during serialization.
17
+ */
18
+ export declare function isProviderDefinedTool(tool: unknown): boolean;
9
19
  //# sourceMappingURL=toolchecks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"toolchecks.d.ts","sourceRoot":"","sources":["../../src/tools/toolchecks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW1C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,IAAI,UAAU,CAUrE"}
1
+ {"version":3,"file":"toolchecks.d.ts","sourceRoot":"","sources":["../../src/tools/toolchecks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW1C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,GAAG,IAAI,IAAI,UAAU,CAUrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAK5D"}
package/dist/utils.cjs CHANGED
@@ -1,97 +1,97 @@
1
1
  'use strict';
2
2
 
3
- var chunkQDH6MVJ7_cjs = require('./chunk-QDH6MVJ7.cjs');
3
+ var chunkTGUDI64A_cjs = require('./chunk-TGUDI64A.cjs');
4
4
  var chunkBFIOQFGF_cjs = require('./chunk-BFIOQFGF.cjs');
5
5
 
6
6
 
7
7
 
8
8
  Object.defineProperty(exports, "checkEvalStorageFields", {
9
9
  enumerable: true,
10
- get: function () { return chunkQDH6MVJ7_cjs.checkEvalStorageFields; }
10
+ get: function () { return chunkTGUDI64A_cjs.checkEvalStorageFields; }
11
11
  });
12
12
  Object.defineProperty(exports, "createMastraProxy", {
13
13
  enumerable: true,
14
- get: function () { return chunkQDH6MVJ7_cjs.createMastraProxy; }
14
+ get: function () { return chunkTGUDI64A_cjs.createMastraProxy; }
15
15
  });
16
16
  Object.defineProperty(exports, "deepEqual", {
17
17
  enumerable: true,
18
- get: function () { return chunkQDH6MVJ7_cjs.deepEqual; }
18
+ get: function () { return chunkTGUDI64A_cjs.deepEqual; }
19
19
  });
20
20
  Object.defineProperty(exports, "deepMerge", {
21
21
  enumerable: true,
22
- get: function () { return chunkQDH6MVJ7_cjs.deepMerge; }
22
+ get: function () { return chunkTGUDI64A_cjs.deepMerge; }
23
23
  });
24
24
  Object.defineProperty(exports, "delay", {
25
25
  enumerable: true,
26
- get: function () { return chunkQDH6MVJ7_cjs.delay; }
26
+ get: function () { return chunkTGUDI64A_cjs.delay; }
27
27
  });
28
28
  Object.defineProperty(exports, "ensureToolProperties", {
29
29
  enumerable: true,
30
- get: function () { return chunkQDH6MVJ7_cjs.ensureToolProperties; }
30
+ get: function () { return chunkTGUDI64A_cjs.ensureToolProperties; }
31
31
  });
32
32
  Object.defineProperty(exports, "fetchWithRetry", {
33
33
  enumerable: true,
34
- get: function () { return chunkQDH6MVJ7_cjs.fetchWithRetry; }
34
+ get: function () { return chunkTGUDI64A_cjs.fetchWithRetry; }
35
35
  });
36
36
  Object.defineProperty(exports, "generateEmptyFromSchema", {
37
37
  enumerable: true,
38
- get: function () { return chunkQDH6MVJ7_cjs.generateEmptyFromSchema; }
38
+ get: function () { return chunkTGUDI64A_cjs.generateEmptyFromSchema; }
39
39
  });
40
40
  Object.defineProperty(exports, "getNestedValue", {
41
41
  enumerable: true,
42
- get: function () { return chunkQDH6MVJ7_cjs.getNestedValue; }
42
+ get: function () { return chunkTGUDI64A_cjs.getNestedValue; }
43
43
  });
44
44
  Object.defineProperty(exports, "isCoreMessage", {
45
45
  enumerable: true,
46
- get: function () { return chunkQDH6MVJ7_cjs.isCoreMessage; }
46
+ get: function () { return chunkTGUDI64A_cjs.isCoreMessage; }
47
47
  });
48
48
  Object.defineProperty(exports, "isUiMessage", {
49
49
  enumerable: true,
50
- get: function () { return chunkQDH6MVJ7_cjs.isUiMessage; }
50
+ get: function () { return chunkTGUDI64A_cjs.isUiMessage; }
51
51
  });
52
52
  Object.defineProperty(exports, "isZodType", {
53
53
  enumerable: true,
54
- get: function () { return chunkQDH6MVJ7_cjs.isZodType; }
54
+ get: function () { return chunkTGUDI64A_cjs.isZodType; }
55
55
  });
56
56
  Object.defineProperty(exports, "makeCoreTool", {
57
57
  enumerable: true,
58
- get: function () { return chunkQDH6MVJ7_cjs.makeCoreTool; }
58
+ get: function () { return chunkTGUDI64A_cjs.makeCoreTool; }
59
59
  });
60
60
  Object.defineProperty(exports, "makeCoreToolV5", {
61
61
  enumerable: true,
62
- get: function () { return chunkQDH6MVJ7_cjs.makeCoreToolV5; }
62
+ get: function () { return chunkTGUDI64A_cjs.makeCoreToolV5; }
63
63
  });
64
64
  Object.defineProperty(exports, "maskStreamTags", {
65
65
  enumerable: true,
66
- get: function () { return chunkQDH6MVJ7_cjs.maskStreamTags; }
66
+ get: function () { return chunkTGUDI64A_cjs.maskStreamTags; }
67
67
  });
68
68
  Object.defineProperty(exports, "omitKeys", {
69
69
  enumerable: true,
70
- get: function () { return chunkQDH6MVJ7_cjs.omitKeys; }
70
+ get: function () { return chunkTGUDI64A_cjs.omitKeys; }
71
71
  });
72
72
  Object.defineProperty(exports, "parseFieldKey", {
73
73
  enumerable: true,
74
- get: function () { return chunkQDH6MVJ7_cjs.parseFieldKey; }
74
+ get: function () { return chunkTGUDI64A_cjs.parseFieldKey; }
75
75
  });
76
76
  Object.defineProperty(exports, "parseSqlIdentifier", {
77
77
  enumerable: true,
78
- get: function () { return chunkQDH6MVJ7_cjs.parseSqlIdentifier; }
78
+ get: function () { return chunkTGUDI64A_cjs.parseSqlIdentifier; }
79
79
  });
80
80
  Object.defineProperty(exports, "removeUndefinedValues", {
81
81
  enumerable: true,
82
- get: function () { return chunkQDH6MVJ7_cjs.removeUndefinedValues; }
82
+ get: function () { return chunkTGUDI64A_cjs.removeUndefinedValues; }
83
83
  });
84
84
  Object.defineProperty(exports, "resolveSerializedZodOutput", {
85
85
  enumerable: true,
86
- get: function () { return chunkQDH6MVJ7_cjs.resolveSerializedZodOutput; }
86
+ get: function () { return chunkTGUDI64A_cjs.resolveSerializedZodOutput; }
87
87
  });
88
88
  Object.defineProperty(exports, "selectFields", {
89
89
  enumerable: true,
90
- get: function () { return chunkQDH6MVJ7_cjs.selectFields; }
90
+ get: function () { return chunkTGUDI64A_cjs.selectFields; }
91
91
  });
92
92
  Object.defineProperty(exports, "setNestedValue", {
93
93
  enumerable: true,
94
- get: function () { return chunkQDH6MVJ7_cjs.setNestedValue; }
94
+ get: function () { return chunkTGUDI64A_cjs.setNestedValue; }
95
95
  });
96
96
  Object.defineProperty(exports, "getZodDef", {
97
97
  enumerable: true,
package/dist/utils.js CHANGED
@@ -1,4 +1,4 @@
1
- export { checkEvalStorageFields, createMastraProxy, deepEqual, deepMerge, delay, ensureToolProperties, fetchWithRetry, generateEmptyFromSchema, getNestedValue, isCoreMessage, isUiMessage, isZodType, makeCoreTool, makeCoreToolV5, maskStreamTags, omitKeys, parseFieldKey, parseSqlIdentifier, removeUndefinedValues, resolveSerializedZodOutput, selectFields, setNestedValue } from './chunk-NN26FSKL.js';
1
+ export { checkEvalStorageFields, createMastraProxy, deepEqual, deepMerge, delay, ensureToolProperties, fetchWithRetry, generateEmptyFromSchema, getNestedValue, isCoreMessage, isUiMessage, isZodType, makeCoreTool, makeCoreToolV5, maskStreamTags, omitKeys, parseFieldKey, parseSqlIdentifier, removeUndefinedValues, resolveSerializedZodOutput, selectFields, setNestedValue } from './chunk-FHJ2KIU5.js';
2
2
  export { getZodDef, getZodTypeName, isZodArray, isZodObject } from './chunk-S53FKKVL.js';
3
3
  //# sourceMappingURL=utils.js.map
4
4
  //# sourceMappingURL=utils.js.map
@@ -1,7 +1,7 @@
1
1
  'use strict';
2
2
 
3
3
  var chunk6XCINXZ7_cjs = require('../chunk-6XCINXZ7.cjs');
4
- var chunkYQG7NBPR_cjs = require('../chunk-YQG7NBPR.cjs');
4
+ var chunkKZ4IKNPN_cjs = require('../chunk-KZ4IKNPN.cjs');
5
5
  var chunkZIEQA3YP_cjs = require('../chunk-ZIEQA3YP.cjs');
6
6
  var chunkH5S4PS44_cjs = require('../chunk-H5S4PS44.cjs');
7
7
  var chunkCC3OOESY_cjs = require('../chunk-CC3OOESY.cjs');
@@ -92,7 +92,7 @@ var MastraVector = class extends chunkRO47SMI7_cjs.MastraBase {
92
92
  function validateUpsertInput(storeName, vectors, metadata, ids) {
93
93
  if (!vectors || vectors.length === 0) {
94
94
  throw new chunk4U7ZLI36_cjs.MastraError({
95
- id: chunkYQG7NBPR_cjs.createVectorErrorId(storeName, "UPSERT", "EMPTY_VECTORS"),
95
+ id: chunkKZ4IKNPN_cjs.createVectorErrorId(storeName, "UPSERT", "EMPTY_VECTORS"),
96
96
  domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
97
97
  category: "USER" /* USER */,
98
98
  details: {
@@ -102,7 +102,7 @@ function validateUpsertInput(storeName, vectors, metadata, ids) {
102
102
  }
103
103
  if (metadata && metadata.length > 0 && metadata.length !== vectors.length) {
104
104
  throw new chunk4U7ZLI36_cjs.MastraError({
105
- id: chunkYQG7NBPR_cjs.createVectorErrorId(storeName, "UPSERT", "METADATA_LENGTH_MISMATCH"),
105
+ id: chunkKZ4IKNPN_cjs.createVectorErrorId(storeName, "UPSERT", "METADATA_LENGTH_MISMATCH"),
106
106
  domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
107
107
  category: "USER" /* USER */,
108
108
  details: {
@@ -114,7 +114,7 @@ function validateUpsertInput(storeName, vectors, metadata, ids) {
114
114
  }
115
115
  if (ids && ids.length !== vectors.length) {
116
116
  throw new chunk4U7ZLI36_cjs.MastraError({
117
- id: chunkYQG7NBPR_cjs.createVectorErrorId(storeName, "UPSERT", "IDS_LENGTH_MISMATCH"),
117
+ id: chunkKZ4IKNPN_cjs.createVectorErrorId(storeName, "UPSERT", "IDS_LENGTH_MISMATCH"),
118
118
  domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
119
119
  category: "USER" /* USER */,
120
120
  details: {
@@ -128,7 +128,7 @@ function validateUpsertInput(storeName, vectors, metadata, ids) {
128
128
  function validateTopK(storeName, topK) {
129
129
  if (!Number.isInteger(topK) || topK <= 0) {
130
130
  throw new chunk4U7ZLI36_cjs.MastraError({
131
- id: chunkYQG7NBPR_cjs.createVectorErrorId(storeName, "QUERY", "INVALID_TOP_K"),
131
+ id: chunkKZ4IKNPN_cjs.createVectorErrorId(storeName, "QUERY", "INVALID_TOP_K"),
132
132
  domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
133
133
  category: "USER" /* USER */,
134
134
  details: {
@@ -143,7 +143,7 @@ function validateVectorValues(storeName, vectors) {
143
143
  const vector = vectors[i];
144
144
  if (!vector) {
145
145
  throw new chunk4U7ZLI36_cjs.MastraError({
146
- id: chunkYQG7NBPR_cjs.createVectorErrorId(storeName, "UPSERT", "INVALID_VECTOR"),
146
+ id: chunkKZ4IKNPN_cjs.createVectorErrorId(storeName, "UPSERT", "INVALID_VECTOR"),
147
147
  domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
148
148
  category: "USER" /* USER */,
149
149
  details: {
@@ -156,7 +156,7 @@ function validateVectorValues(storeName, vectors) {
156
156
  const value = vector[j];
157
157
  if (value === null || value === void 0 || !Number.isFinite(value)) {
158
158
  throw new chunk4U7ZLI36_cjs.MastraError({
159
- id: chunkYQG7NBPR_cjs.createVectorErrorId(storeName, "UPSERT", "INVALID_VECTOR_VALUE"),
159
+ id: chunkKZ4IKNPN_cjs.createVectorErrorId(storeName, "UPSERT", "INVALID_VECTOR_VALUE"),
160
160
  domain: "MASTRA_VECTOR" /* MASTRA_VECTOR */,
161
161
  category: "USER" /* USER */,
162
162
  details: {
@@ -1,5 +1,5 @@
1
1
  export { BaseFilterTranslator } from '../chunk-BWYU7D33.js';
2
- import { createVectorErrorId } from '../chunk-DFCRXDVK.js';
2
+ import { createVectorErrorId } from '../chunk-2KHPZJNU.js';
3
3
  export { embed as embedV2 } from '../chunk-UTLWS5LV.js';
4
4
  export { embed as embedV3 } from '../chunk-IOY7Y5GV.js';
5
5
  export { embed as embedV1 } from '../chunk-S6BH5HHY.js';
@@ -58,7 +58,15 @@ export interface CreateIndexParams {
58
58
  }
59
59
  export interface QueryVectorParams<Filter = VectorFilter> {
60
60
  indexName: string;
61
- queryVector: number[];
61
+ /**
62
+ * The query vector for similarity search.
63
+ * Optional — when omitted, a metadata-only query is performed using `filter`.
64
+ * At least one of `queryVector` or `filter` must be provided.
65
+ *
66
+ * Note: Not all vector store backends support metadata-only queries.
67
+ * Check your store's documentation for support details.
68
+ */
69
+ queryVector?: number[];
62
70
  topK?: number;
63
71
  filter?: Filter;
64
72
  includeVector?: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vector/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vector/types.ts"],"names":[],"mappings":"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"}
@@ -1,44 +1,44 @@
1
1
  'use strict';
2
2
 
3
- var chunkRABITNTG_cjs = require('../../chunk-RABITNTG.cjs');
3
+ var chunkHWG7NPJA_cjs = require('../../chunk-HWG7NPJA.cjs');
4
4
 
5
5
 
6
6
 
7
7
  Object.defineProperty(exports, "EventedExecutionEngine", {
8
8
  enumerable: true,
9
- get: function () { return chunkRABITNTG_cjs.EventedExecutionEngine; }
9
+ get: function () { return chunkHWG7NPJA_cjs.EventedExecutionEngine; }
10
10
  });
11
11
  Object.defineProperty(exports, "EventedRun", {
12
12
  enumerable: true,
13
- get: function () { return chunkRABITNTG_cjs.EventedRun; }
13
+ get: function () { return chunkHWG7NPJA_cjs.EventedRun; }
14
14
  });
15
15
  Object.defineProperty(exports, "EventedWorkflow", {
16
16
  enumerable: true,
17
- get: function () { return chunkRABITNTG_cjs.EventedWorkflow; }
17
+ get: function () { return chunkHWG7NPJA_cjs.EventedWorkflow; }
18
18
  });
19
19
  Object.defineProperty(exports, "StepExecutor", {
20
20
  enumerable: true,
21
- get: function () { return chunkRABITNTG_cjs.StepExecutor; }
21
+ get: function () { return chunkHWG7NPJA_cjs.StepExecutor; }
22
22
  });
23
23
  Object.defineProperty(exports, "WorkflowEventProcessor", {
24
24
  enumerable: true,
25
- get: function () { return chunkRABITNTG_cjs.WorkflowEventProcessor; }
25
+ get: function () { return chunkHWG7NPJA_cjs.WorkflowEventProcessor; }
26
26
  });
27
27
  Object.defineProperty(exports, "cloneStep", {
28
28
  enumerable: true,
29
- get: function () { return chunkRABITNTG_cjs.cloneStep; }
29
+ get: function () { return chunkHWG7NPJA_cjs.cloneStep; }
30
30
  });
31
31
  Object.defineProperty(exports, "cloneWorkflow", {
32
32
  enumerable: true,
33
- get: function () { return chunkRABITNTG_cjs.cloneWorkflow; }
33
+ get: function () { return chunkHWG7NPJA_cjs.cloneWorkflow; }
34
34
  });
35
35
  Object.defineProperty(exports, "createStep", {
36
36
  enumerable: true,
37
- get: function () { return chunkRABITNTG_cjs.createStep; }
37
+ get: function () { return chunkHWG7NPJA_cjs.createStep; }
38
38
  });
39
39
  Object.defineProperty(exports, "createWorkflow", {
40
40
  enumerable: true,
41
- get: function () { return chunkRABITNTG_cjs.createWorkflow; }
41
+ get: function () { return chunkHWG7NPJA_cjs.createWorkflow; }
42
42
  });
43
43
  //# sourceMappingURL=index.cjs.map
44
44
  //# sourceMappingURL=index.cjs.map
@@ -1,3 +1,3 @@
1
- export { EventedExecutionEngine, EventedRun, EventedWorkflow, StepExecutor, WorkflowEventProcessor, cloneStep, cloneWorkflow, createStep, createWorkflow } from '../../chunk-QWTB53GS.js';
1
+ export { EventedExecutionEngine, EventedRun, EventedWorkflow, StepExecutor, WorkflowEventProcessor, cloneStep, cloneWorkflow, createStep, createWorkflow } from '../../chunk-OSEPGSLN.js';
2
2
  //# sourceMappingURL=index.js.map
3
3
  //# sourceMappingURL=index.js.map
@@ -1,104 +1,104 @@
1
1
  'use strict';
2
2
 
3
- var chunk2X66GWF5_cjs = require('../chunk-2X66GWF5.cjs');
3
+ var chunkVTVCMIAI_cjs = require('../chunk-VTVCMIAI.cjs');
4
4
 
5
5
 
6
6
 
7
7
  Object.defineProperty(exports, "DefaultExecutionEngine", {
8
8
  enumerable: true,
9
- get: function () { return chunk2X66GWF5_cjs.DefaultExecutionEngine; }
9
+ get: function () { return chunkVTVCMIAI_cjs.DefaultExecutionEngine; }
10
10
  });
11
11
  Object.defineProperty(exports, "ExecutionEngine", {
12
12
  enumerable: true,
13
- get: function () { return chunk2X66GWF5_cjs.ExecutionEngine; }
13
+ get: function () { return chunkVTVCMIAI_cjs.ExecutionEngine; }
14
14
  });
15
15
  Object.defineProperty(exports, "Run", {
16
16
  enumerable: true,
17
- get: function () { return chunk2X66GWF5_cjs.Run; }
17
+ get: function () { return chunkVTVCMIAI_cjs.Run; }
18
18
  });
19
19
  Object.defineProperty(exports, "Workflow", {
20
20
  enumerable: true,
21
- get: function () { return chunk2X66GWF5_cjs.Workflow; }
21
+ get: function () { return chunkVTVCMIAI_cjs.Workflow; }
22
22
  });
23
23
  Object.defineProperty(exports, "cleanStepResult", {
24
24
  enumerable: true,
25
- get: function () { return chunk2X66GWF5_cjs.cleanStepResult; }
25
+ get: function () { return chunkVTVCMIAI_cjs.cleanStepResult; }
26
26
  });
27
27
  Object.defineProperty(exports, "cloneStep", {
28
28
  enumerable: true,
29
- get: function () { return chunk2X66GWF5_cjs.cloneStep; }
29
+ get: function () { return chunkVTVCMIAI_cjs.cloneStep; }
30
30
  });
31
31
  Object.defineProperty(exports, "cloneWorkflow", {
32
32
  enumerable: true,
33
- get: function () { return chunk2X66GWF5_cjs.cloneWorkflow; }
33
+ get: function () { return chunkVTVCMIAI_cjs.cloneWorkflow; }
34
34
  });
35
35
  Object.defineProperty(exports, "createDeprecationProxy", {
36
36
  enumerable: true,
37
- get: function () { return chunk2X66GWF5_cjs.createDeprecationProxy; }
37
+ get: function () { return chunkVTVCMIAI_cjs.createDeprecationProxy; }
38
38
  });
39
39
  Object.defineProperty(exports, "createStep", {
40
40
  enumerable: true,
41
- get: function () { return chunk2X66GWF5_cjs.createStep; }
41
+ get: function () { return chunkVTVCMIAI_cjs.createStep; }
42
42
  });
43
43
  Object.defineProperty(exports, "createTimeTravelExecutionParams", {
44
44
  enumerable: true,
45
- get: function () { return chunk2X66GWF5_cjs.createTimeTravelExecutionParams; }
45
+ get: function () { return chunkVTVCMIAI_cjs.createTimeTravelExecutionParams; }
46
46
  });
47
47
  Object.defineProperty(exports, "createWorkflow", {
48
48
  enumerable: true,
49
- get: function () { return chunk2X66GWF5_cjs.createWorkflow; }
49
+ get: function () { return chunkVTVCMIAI_cjs.createWorkflow; }
50
50
  });
51
51
  Object.defineProperty(exports, "getResumeLabelsByStepId", {
52
52
  enumerable: true,
53
- get: function () { return chunk2X66GWF5_cjs.getResumeLabelsByStepId; }
53
+ get: function () { return chunkVTVCMIAI_cjs.getResumeLabelsByStepId; }
54
54
  });
55
55
  Object.defineProperty(exports, "getStepIds", {
56
56
  enumerable: true,
57
- get: function () { return chunk2X66GWF5_cjs.getStepIds; }
57
+ get: function () { return chunkVTVCMIAI_cjs.getStepIds; }
58
58
  });
59
59
  Object.defineProperty(exports, "getStepResult", {
60
60
  enumerable: true,
61
- get: function () { return chunk2X66GWF5_cjs.getStepResult; }
61
+ get: function () { return chunkVTVCMIAI_cjs.getStepResult; }
62
62
  });
63
63
  Object.defineProperty(exports, "getZodErrors", {
64
64
  enumerable: true,
65
- get: function () { return chunk2X66GWF5_cjs.getZodErrors; }
65
+ get: function () { return chunkVTVCMIAI_cjs.getZodErrors; }
66
66
  });
67
67
  Object.defineProperty(exports, "hydrateSerializedStepErrors", {
68
68
  enumerable: true,
69
- get: function () { return chunk2X66GWF5_cjs.hydrateSerializedStepErrors; }
69
+ get: function () { return chunkVTVCMIAI_cjs.hydrateSerializedStepErrors; }
70
70
  });
71
71
  Object.defineProperty(exports, "isProcessor", {
72
72
  enumerable: true,
73
- get: function () { return chunk2X66GWF5_cjs.isProcessor; }
73
+ get: function () { return chunkVTVCMIAI_cjs.isProcessor; }
74
74
  });
75
75
  Object.defineProperty(exports, "mapVariable", {
76
76
  enumerable: true,
77
- get: function () { return chunk2X66GWF5_cjs.mapVariable; }
77
+ get: function () { return chunkVTVCMIAI_cjs.mapVariable; }
78
78
  });
79
79
  Object.defineProperty(exports, "runCountDeprecationMessage", {
80
80
  enumerable: true,
81
- get: function () { return chunk2X66GWF5_cjs.runCountDeprecationMessage; }
81
+ get: function () { return chunkVTVCMIAI_cjs.runCountDeprecationMessage; }
82
82
  });
83
83
  Object.defineProperty(exports, "validateStepInput", {
84
84
  enumerable: true,
85
- get: function () { return chunk2X66GWF5_cjs.validateStepInput; }
85
+ get: function () { return chunkVTVCMIAI_cjs.validateStepInput; }
86
86
  });
87
87
  Object.defineProperty(exports, "validateStepRequestContext", {
88
88
  enumerable: true,
89
- get: function () { return chunk2X66GWF5_cjs.validateStepRequestContext; }
89
+ get: function () { return chunkVTVCMIAI_cjs.validateStepRequestContext; }
90
90
  });
91
91
  Object.defineProperty(exports, "validateStepResumeData", {
92
92
  enumerable: true,
93
- get: function () { return chunk2X66GWF5_cjs.validateStepResumeData; }
93
+ get: function () { return chunkVTVCMIAI_cjs.validateStepResumeData; }
94
94
  });
95
95
  Object.defineProperty(exports, "validateStepStateData", {
96
96
  enumerable: true,
97
- get: function () { return chunk2X66GWF5_cjs.validateStepStateData; }
97
+ get: function () { return chunkVTVCMIAI_cjs.validateStepStateData; }
98
98
  });
99
99
  Object.defineProperty(exports, "validateStepSuspendData", {
100
100
  enumerable: true,
101
- get: function () { return chunk2X66GWF5_cjs.validateStepSuspendData; }
101
+ get: function () { return chunkVTVCMIAI_cjs.validateStepSuspendData; }
102
102
  });
103
103
  //# sourceMappingURL=index.cjs.map
104
104
  //# sourceMappingURL=index.cjs.map
@@ -1,3 +1,3 @@
1
- export { DefaultExecutionEngine, ExecutionEngine, Run, Workflow, cleanStepResult, cloneStep, cloneWorkflow, createDeprecationProxy, createStep, createTimeTravelExecutionParams, createWorkflow, getResumeLabelsByStepId, getStepIds, getStepResult, getZodErrors, hydrateSerializedStepErrors, isProcessor, mapVariable, runCountDeprecationMessage, validateStepInput, validateStepRequestContext, validateStepResumeData, validateStepStateData, validateStepSuspendData } from '../chunk-QSHV7GPT.js';
1
+ export { DefaultExecutionEngine, ExecutionEngine, Run, Workflow, cleanStepResult, cloneStep, cloneWorkflow, createDeprecationProxy, createStep, createTimeTravelExecutionParams, createWorkflow, getResumeLabelsByStepId, getStepIds, getStepResult, getZodErrors, hydrateSerializedStepErrors, isProcessor, mapVariable, runCountDeprecationMessage, validateStepInput, validateStepRequestContext, validateStepResumeData, validateStepStateData, validateStepSuspendData } from '../chunk-VBPU6CLZ.js';
2
2
  //# sourceMappingURL=index.js.map
3
3
  //# sourceMappingURL=index.js.map
@@ -6,7 +6,7 @@ import type { MastraScorers } from '../evals/index.js';
6
6
  import type { PubSub } from '../events/pubsub.js';
7
7
  import type { IMastraLogger } from '../logger/index.js';
8
8
  import type { Mastra } from '../mastra/index.js';
9
- import type { AnySpan, TracingContext, TracingPolicy, TracingProperties } from '../observability/index.js';
9
+ import type { AnySpan, TracingContext, TracingOptions, TracingPolicy, TracingProperties } from '../observability/index.js';
10
10
  import type { RequestContext } from '../request-context/index.js';
11
11
  import type { OutputSchema } from '../stream/index.js';
12
12
  import type { InferZodLikeSchema, SchemaWithValidation } from '../stream/base/schema.js';
@@ -17,6 +17,19 @@ import type { ZodLikeSchema } from '../types/zod-compat.js';
17
17
  import type { ExecutionEngine } from './execution-engine.js';
18
18
  import type { ConditionFunction, ExecuteFunction, ExecuteFunctionParams, LoopConditionFunction, Step } from './step.js';
19
19
  export type OutputWriter<TChunk = any> = (chunk: TChunk) => Promise<void>;
20
+ /**
21
+ * Options for `Run.start()` beyond the generic `inputData`/`initialState`/`requestContext` fields.
22
+ */
23
+ export type WorkflowRunStartOptions = {
24
+ outputWriter?: OutputWriter;
25
+ tracingContext?: TracingContext;
26
+ tracingOptions?: TracingOptions;
27
+ outputOptions?: {
28
+ includeState?: boolean;
29
+ includeResumeLabels?: boolean;
30
+ };
31
+ perStep?: boolean;
32
+ };
20
33
  export type { ChunkType, WorkflowStreamEvent } from '../stream/types.js';
21
34
  export type { MastraWorkflowStream } from '../stream/MastraWorkflowStream.js';
22
35
  export type WorkflowEngineType = string;