@mastra/core 1.18.0-alpha.1 → 1.18.0-alpha.2

package/dist/docs/references/reference-core-getStoredAgentById.md

@@ -1,87 +0,0 @@
-# Mastra.getStoredAgentById()
-
-The `.getStoredAgentById()` method retrieves an agent configuration from storage by its ID and creates an executable `Agent` instance. Stored agents allow you to persist agent configurations in a database and dynamically load them at runtime.
-
-## Usage example
-
-```typescript
-// Get an Agent instance from storage
-const agent = await mastra.getStoredAgentById('my-stored-agent')
-
-if (agent) {
-  const response = await agent.generate('Hello')
-  console.log(response.text)
-}
-```
-
-```typescript
-// Get the raw storage data instead of an Agent instance
-const storedConfig = await mastra.getStoredAgentById('my-stored-agent', { raw: true })
-
-if (storedConfig) {
-  console.log(storedConfig.instructions)
-  console.log(storedConfig.createdAt)
-}
-```
-
-## Parameters
-
-**id** (`string`): The unique identifier of the stored agent to retrieve.
-
-**options** (`{ raw?: boolean }`): Optional configuration object.
-
-**options.raw** (`boolean`): When \`true\`, returns the raw \`StorageAgentType\` object from storage instead of creating an \`Agent\` instance. Useful for inspecting stored configuration or metadata.
-
-## Returns
-
-**result** (`Agent | StorageAgentType | null`): Returns an \`Agent\` instance by default, or \`StorageAgentType\` when \`raw: true\`. Returns \`null\` if no agent with the given ID exists.
-
-## Primitive resolution
-
-When creating an `Agent` instance from stored configuration, the method resolves references to registered primitives:
-
-- **Tools**: Resolved from `tools` registered in Mastra config
-- **Workflows**: Resolved from `workflows` registered in Mastra config
-- **Subagents**: Resolved from `agents` registered in Mastra config
-- **Memory**: Resolved from `memory` registered in Mastra config
-- **Scorers**: Resolved from `scorers` registered in Mastra config, including sampling configuration
-
-If a referenced primitive isn't found in the registry, a warning is logged but the agent is still created.
-
-## `StorageAgentType`
-
-When using `raw: true`, the returned object has the following structure:
-
-**id** (`string`): Unique identifier for the agent.
-
-**name** (`string`): Display name of the agent.
-
-**description** (`string`): Optional description of the agent.
-
-**instructions** (`string`): System instructions for the agent.
-
-**model** (`Record<string, unknown>`): Model configuration with provider and name.
-
-**tools** (`Record<string, unknown>`): Tool references to resolve from registry.
-
-**workflows** (`Record<string, unknown>`): Workflow references to resolve from registry.
-
-**agents** (`Record<string, unknown>`): Subagent references to resolve from registry.
-
-**memory** (`Record<string, unknown>`): Memory reference to resolve from registry.
-
-**scorers** (`Record<string, unknown>`): Scorer references with optional sampling config.
-
-**defaultOptions** (`Record<string, unknown>`): Default options passed to agent execution.
-
-**metadata** (`Record<string, unknown>`): Custom metadata stored with the agent.
-
-**createdAt** (`Date`): Timestamp when the agent was created.
-
-**updatedAt** (`Date`): Timestamp when the agent was last updated.
-
-## Related
-
-- [Mastra.listStoredAgents()](https://mastra.ai/reference/core/listStoredAgents)
-- [Storage overview](https://mastra.ai/reference/storage/overview)
-- [Agents overview](https://mastra.ai/docs/agents/overview)

package/dist/docs/references/reference-core-listStoredAgents.md

@@ -1,91 +0,0 @@
-# Mastra.listStoredAgents()
-
-The `.listStoredAgents()` method retrieves a paginated list of agent configurations from storage. By default, it returns executable `Agent` instances, but can also return raw storage data.
-
-## Usage example
-
-```typescript
-// Get Agent instances from storage
-const { agents, total, hasMore } = await mastra.listStoredAgents()
-
-for (const agent of agents) {
-  console.log(agent.id, agent.name)
-  // Each agent is ready to use
-  // const response = await agent.generate("Hello");
-}
-```
-
-```typescript
-// Get paginated results with raw storage data
-const result = await mastra.listStoredAgents({
-  page: 0,
-  perPage: 10,
-  raw: true,
-})
-
-console.log(`Showing ${result.agents.length} of ${result.total} agents`)
-console.log(`Has more: ${result.hasMore}`)
-
-for (const config of result.agents) {
-  console.log(config.id, config.name, config.createdAt)
-}
-```
-
-## Parameters
-
-**args** (`object`): Optional configuration object for pagination and output format.
-
-**args.page** (`number`): Zero-indexed page number for pagination.
-
-**args.perPage** (`number | false`): Number of items per page. Set to \`false\` to fetch all records without pagination.
-
-**args.raw** (`boolean`): When \`true\`, returns raw \`StorageAgentType\` objects instead of \`Agent\` instances.
-
-## Returns
-
-**agents** (`Agent[] | StorageAgentType[]`): Array of \`Agent\` instances by default, or \`StorageAgentType\` objects when \`raw: true\`.
-
-**total** (`number`): Total number of stored agents across all pages.
-
-**page** (`number`): Current page number (zero-indexed).
-
-**perPage** (`number | false`): Number of items per page, or \`false\` if fetching all.
-
-**hasMore** (`boolean`): Whether there are more pages available.
-
-## Primitive resolution
-
-When creating `Agent` instances (default behavior), each stored agent's configuration is resolved against registered primitives:
-
-- **Tools**: Resolved from `tools` registered in Mastra config
-- **Workflows**: Resolved from `workflows` registered in Mastra config
-- **Subagents**: Resolved from `agents` registered in Mastra config
-- **Memory**: Resolved from `memory` registered in Mastra config
-- **Scorers**: Resolved from `scorers` registered in Mastra config
-
-If a referenced primitive isn't found, a warning is logged but the agent is still created.
-
-## Example: Iterating through all stored agents
-
-```typescript
-async function getAllStoredAgents(mastra: Mastra) {
-  const allAgents: Agent[] = []
-  let page = 0
-  let hasMore = true
-
-  while (hasMore) {
-    const result = await mastra.listStoredAgents({ page, perPage: 50 })
-    allAgents.push(...result.agents)
-    hasMore = result.hasMore
-    page++
-  }
-
-  return allAgents
-}
-```
-
-## Related
-
-- [Mastra.getStoredAgentById()](https://mastra.ai/reference/core/getStoredAgentById)
-- [Storage overview](https://mastra.ai/reference/storage/overview)
-- [Agents overview](https://mastra.ai/docs/agents/overview)

package/dist/models-dev-3U6ICCNW.js

@@ -1,3 +0,0 @@
-export { ModelsDevGateway } from './chunk-BYJDWJCX.js';
-//# sourceMappingURL=models-dev-3U6ICCNW.js.map
-//# sourceMappingURL=models-dev-3U6ICCNW.js.map

package/dist/models-dev-BJHT4GXA.cjs

@@ -1,12 +0,0 @@
-'use strict';
-
-var chunkUEZU2TA2_cjs = require('./chunk-UEZU2TA2.cjs');
-
-
-
-Object.defineProperty(exports, "ModelsDevGateway", {
-  enumerable: true,
-  get: function () { return chunkUEZU2TA2_cjs.ModelsDevGateway; }
-});
-//# sourceMappingURL=models-dev-BJHT4GXA.cjs.map
-//# sourceMappingURL=models-dev-BJHT4GXA.cjs.map

package/dist/netlify-DE3IXMT2.js

@@ -1,3 +0,0 @@
-export { NetlifyGateway } from './chunk-D4DCPE5Y.js';
-//# sourceMappingURL=netlify-DE3IXMT2.js.map
-//# sourceMappingURL=netlify-DE3IXMT2.js.map

package/dist/netlify-UARJYMCW.cjs

@@ -1,12 +0,0 @@
-'use strict';
-
-var chunkMSDZQ4DW_cjs = require('./chunk-MSDZQ4DW.cjs');
-
-
-
-Object.defineProperty(exports, "NetlifyGateway", {
-  enumerable: true,
-  get: function () { return chunkMSDZQ4DW_cjs.NetlifyGateway; }
-});
-//# sourceMappingURL=netlify-UARJYMCW.cjs.map
-//# sourceMappingURL=netlify-UARJYMCW.cjs.map

package/dist/provider-registry-65CPGTUU.cjs

@@ -1,40 +0,0 @@
-'use strict';
-
-var chunkKL2IRBNK_cjs = require('./chunk-KL2IRBNK.cjs');
-
-
-
-Object.defineProperty(exports, "GatewayRegistry", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.GatewayRegistry; }
-});
-Object.defineProperty(exports, "PROVIDER_MODELS", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.PROVIDER_MODELS; }
-});
-Object.defineProperty(exports, "PROVIDER_REGISTRY", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.PROVIDER_REGISTRY; }
-});
-Object.defineProperty(exports, "getProviderConfig", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.getProviderConfig; }
-});
-Object.defineProperty(exports, "getRegisteredProviders", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.getRegisteredProviders; }
-});
-Object.defineProperty(exports, "isProviderRegistered", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.isProviderRegistered; }
-});
-Object.defineProperty(exports, "isValidModelId", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.isValidModelId; }
-});
-Object.defineProperty(exports, "parseModelString", {
-  enumerable: true,
-  get: function () { return chunkKL2IRBNK_cjs.parseModelString; }
-});
-//# sourceMappingURL=provider-registry-65CPGTUU.cjs.map
-//# sourceMappingURL=provider-registry-65CPGTUU.cjs.map

package/dist/provider-registry-EQAT7FXK.js

@@ -1,3 +0,0 @@
-export { GatewayRegistry, PROVIDER_MODELS, PROVIDER_REGISTRY, getProviderConfig, getRegisteredProviders, isProviderRegistered, isValidModelId, parseModelString } from './chunk-TKKBZUWD.js';
-//# sourceMappingURL=provider-registry-EQAT7FXK.js.map
-//# sourceMappingURL=provider-registry-EQAT7FXK.js.map