@mastra/mcp-docs-server 1.2.14-alpha.3 → 1.2.14-alpha.4

package/.docs/reference/workflows/stored-workflow-definition.md

@@ -0,0 +1,292 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Stored workflow definition
+
+> **Beta:** Stored workflows are in beta. Breaking changes may occur without a major version bump until the API is stable.
+
+A stored workflow definition is a JSON-compatible `StoredWorkflowGraph` accepted by [`Mastra.addStoredWorkflow()`](https://mastra.ai/reference/core/addStoredWorkflow), the stored-workflow server routes, and the Client SDK workflows API.
+
+See [Stored workflows](https://mastra.ai/docs/workflows/stored-workflows) for a complete setup and usage example.
+
+## Definition fields
+
+| Field                  | Type                        | Required | Description                                                                    |
+| ---------------------- | --------------------------- | -------- | ------------------------------------------------------------------------------ |
+| `id`                   | `string`                    | Yes      | Unique workflow ID. This is also the ID used to retrieve and run the workflow. |
+| `description`          | `string`                    | No       | Human-readable description                                                     |
+| `inputSchema`          | `JsonSchema`                | Yes      | JSON Schema for the workflow input                                             |
+| `outputSchema`         | `JsonSchema`                | Yes      | JSON Schema for the workflow output                                            |
+| `stateSchema`          | `JsonSchema`                | No       | JSON Schema for shared workflow state                                          |
+| `requestContextSchema` | `JsonSchema`                | No       | JSON Schema for values read from the request context                           |
+| `metadata`             | `Record<string, unknown>`   | No       | Arbitrary JSON metadata preserved through storage                              |
+| `graph`                | `SerializedStepFlowEntry[]` | Yes      | Step entries that make up the workflow                                         |
+
+Schemas use JSON Schema rather than Zod so the definition can round-trip through JSON. Mastra converts each schema to Zod when it registers the workflow.
+
+```json
+{
+  "id": "greeting-workflow",
+  "description": "Returns a greeting for the supplied name",
+  "inputSchema": {
+    "type": "object",
+    "properties": { "name": { "type": "string" } },
+    "required": ["name"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": { "message": { "type": "string" } },
+    "required": ["message"]
+  },
+  "graph": [
+    {
+      "type": "mapping",
+      "id": "create-greeting",
+      "mapConfig": "{\"message\":{\"template\":\"Hello, ${initData.name}!\"}}"
+    }
+  ]
+}
+```
+
+## Graph entries
+
+Entries in the `graph` run in order. Each entry receives the previous entry's output, and the first entry receives the workflow input.
+
+| Entry type    | Description                                            |
+| ------------- | ------------------------------------------------------ |
+| `agent`       | Invoke a registered agent                              |
+| `tool`        | Invoke a registered tool                               |
+| `mapping`     | Reshape data between steps                             |
+| `workflow`    | Invoke a registered workflow as a nested step          |
+| `parallel`    | Run several steps concurrently and merge their outputs |
+| `conditional` | Run every branch whose predicate is true, concurrently |
+| `foreach`     | Run one step per item of an array input                |
+| `loop`        | Repeat a step while or until a predicate holds         |
+| `sleep`       | Pause for a fixed duration                             |
+| `sleepUntil`  | Pause until a fixed date                               |
+
+Code-defined workflows that use [`.agent()`](https://mastra.ai/reference/workflows/workflow-methods/agent) and [`.tool()`](https://mastra.ai/reference/workflows/workflow-methods/tool) produce the same declarative entries when serialized.
+
+### Agent steps
+
+An `agent` entry invokes a registered agent by ID. Agent steps accept `{ prompt: string }` as input and return `{ text: string }` by default.
+
+```json
+{
+  "type": "agent",
+  "id": "summarize",
+  "agentId": "support-agent"
+}
+```
+
+The `id` identifies this call site within the workflow. Later steps address the result as `stepResults.summarize`, regardless of the agent's own ID.
+
+Add an `outputSchema` to request structured output from the agent:
+
+```json
+{
+  "type": "agent",
+  "id": "extract-subtopics",
+  "agentId": "support-agent",
+  "outputSchema": {
+    "type": "array",
+    "items": {
+      "type": "object",
+      "properties": { "title": { "type": "string" } },
+      "required": ["title"]
+    }
+  }
+}
+```
+
+Use a `mapping` entry before an agent to build its `{ prompt }` input from workflow data.
+
+Agent entries accept an optional `description` and an `options` object:
+
+```json
+{
+  "type": "agent",
+  "id": "summarize",
+  "agentId": "support-agent",
+  "description": "Summarize the incoming request",
+  "options": { "retries": 2, "metadata": { "team": "support" } }
+}
+```
+
+Only `retries` and `metadata` persist. Function-valued options such as `onFinish` and function-valued `toolChoice` are rejected when a code-defined workflow is stored. Other agent call options don't persist.
+
+### Tool steps
+
+A `tool` entry invokes a tool by its registration key from the `Mastra` `tools` object. Mastra resolves the tool's input and output schemas from the registry when it registers the workflow.
+
+```json
+{
+  "type": "tool",
+  "id": "lookup",
+  "toolId": "lookup-customer"
+}
+```
+
+Tool entries accept the same optional `description` and `options` fields as agent entries. Only `retries` and `metadata` persist.
+
+### Mapping steps
+
+A `mapping` entry reshapes data. Its `mapConfig` is a JSON string that encodes an object. Each key becomes a key in the step output, and each descriptor defines one source.
+
+| Descriptor                             | Description                               |
+| -------------------------------------- | ----------------------------------------- |
+| `{ "value": ... }`                     | A constant JSON value                     |
+| `{ "template": "..." }`                | A string built from `${...}` placeholders |
+| `{ "initData": true, "path": "a.b" }`  | A value from the workflow input           |
+| `{ "step": "step-id", "path": "a.b" }` | A value from a preceding step's output    |
+| `{ "requestContextPath": "a.b" }`      | A value from the request context          |
+
+The `step` source also accepts an array of step IDs:
+
+```json
+{ "step": ["escalate", "auto-reply"], "path": "text" }
+```
+
+The first listed step with a non-empty result supplies the value. This can select the branch that ran after a `conditional` entry.
+
+Templates resolve placeholders against `initData`, `inputData`, `state`, `requestContext`, and `stepResults.<step-id>`:
+
+```json
+{
+  "type": "mapping",
+  "id": "build-prompt",
+  "mapConfig": "{\"prompt\":{\"template\":\"Summarize this request: ${initData.request}\"}}"
+}
+```
+
+Objects and arrays resolved by a template are stringified as JSON. A `null` value inside a present result renders as an empty string. A template that references a step without a successful output fails the run.
+
+Mapping entries must be top-level graph entries. They can't be placed inside `parallel`, `conditional`, `foreach`, or `loop` containers.
+
+### Nested workflow steps
+
+A `workflow` entry invokes another registered workflow. The target can be code-defined or stored.
+
+```json
+{
+  "type": "workflow",
+  "id": "lookup-first",
+  "workflowId": "lookup-customer-workflow"
+}
+```
+
+The `id` identifies the call site. The same nested workflow can appear several times under different call-site IDs, and later steps address each result as `stepResults.<id>`. A `workflow` entry also accepts an optional `description`.
+
+### Parallel entries
+
+A `parallel` entry runs several single steps concurrently and merges their outputs into an object keyed by step ID.
+
+```json
+{
+  "type": "parallel",
+  "steps": [
+    { "type": "tool", "id": "first", "toolId": "lookup-customer" },
+    { "type": "tool", "id": "second", "toolId": "lookup-customer" }
+  ]
+}
+```
+
+Each child must be an `agent`, `tool`, or `workflow` entry. All children receive the parallel entry's input directly.
+
+### Conditional entries
+
+A `conditional` entry pairs each step with a declarative predicate and runs every branch whose predicate is true.
+
+```json
+{
+  "type": "conditional",
+  "steps": [
+    { "type": "agent", "id": "escalate", "agentId": "support-agent" },
+    { "type": "agent", "id": "auto-reply", "agentId": "support-agent" }
+  ],
+  "predicates": [
+    { "op": "eq", "left": { "path": "inputData.priority" }, "right": { "literal": "urgent" } },
+    { "op": "ne", "left": { "path": "inputData.priority" }, "right": { "literal": "urgent" } }
+  ]
+}
+```
+
+Each child must be an `agent`, `tool`, or `workflow` entry, and each child needs a predicate. All children receive the conditional entry's input directly.
+
+### Predicates
+
+Conditional entries and loops use a JSON predicate DSL. Operands are `{ "path": "..." }` references or `{ "literal": ... }` values. Paths resolve against `initData`, `inputData`, `stepResults`, and `state`.
+
+| Operator                             | Shape                                        |
+| ------------------------------------ | -------------------------------------------- |
+| `eq`, `ne`, `lt`, `lte`, `gt`, `gte` | `{ "op": "eq", "left": ..., "right": ... }`  |
+| `in`, `notIn`                        | `{ "op": "in", "value": ..., "set": [...] }` |
+| `exists`, `notExists`                | `{ "op": "exists", "path": "..." }`          |
+| `truthy`, `falsy`                    | `{ "op": "truthy", "value": ... }`           |
+| `and`, `or`                          | `{ "op": "and", "args": [...] }`             |
+| `not`                                | `{ "op": "not", "arg": ... }`                |
+
+Missing paths don't throw. Path-based operators return `false` when the path can't be resolved. Use `exists` or `notExists` to distinguish a missing value from a falsy value.
+
+### Foreach entries
+
+A `foreach` entry runs its body once for each item in an array input. The preceding entry must produce a raw array. Results preserve input order, and concurrency defaults to `1`.
+
+```json
+{
+  "type": "foreach",
+  "step": { "type": "workflow", "id": "write-blurb", "workflowId": "blurb-workflow" },
+  "opts": { "concurrency": 3 }
+}
+```
+
+The body can be an `agent`, `tool`, or `workflow` entry, but not a `mapping` entry.
+
+### Loop entries
+
+A `loop` repeats one step while (`dowhile`) or until (`dountil`) a predicate holds.
+
+```json
+{
+  "type": "loop",
+  "loopType": "dountil",
+  "step": { "type": "tool", "id": "poll", "toolId": "check-status" },
+  "predicate": {
+    "op": "eq",
+    "left": { "path": "inputData.status" },
+    "right": { "literal": "done" }
+  }
+}
+```
+
+The loop body must be a single step, and stored loops require a declarative predicate.
+
+### Sleep entries
+
+A `sleep` entry pauses for a fixed number of milliseconds. A `sleepUntil` entry pauses until a fixed date represented by an ISO date string. Stored definitions require literal values.
+
+```json
+{ "type": "sleep", "id": "wait", "duration": 5000 }
+```
+
+```json
+{ "type": "sleepUntil", "id": "wait-for-launch", "date": "2027-01-01T00:00:00.000Z" }
+```
+
+Use a code-defined workflow when the duration or date must be calculated at runtime.
+
+## Validation
+
+Mastra validates definitions before it persists or registers them:
+
+- Structure: Entry shapes and required fields, including placement rules such as top-level-only mappings.
+- References: Each `agentId` and `workflowId` must resolve against the live registries or the same bundle. A `toolId` must match a tool registration key.
+- Schema flow: Each entry's input must be compatible with the preceding output, including inferred mapping outputs.
+
+Validation errors include a dotted path, such as `graph.2.steps.0`, that identifies the invalid entry.
+
+## Related
+
+- [Use stored workflows](https://mastra.ai/docs/workflows/stored-workflows)
+- [`Mastra.addStoredWorkflow()`](https://mastra.ai/reference/core/addStoredWorkflow)
+- [`Mastra.addStoredWorkflows()`](https://mastra.ai/reference/core/addStoredWorkflows)
+- [Client SDK workflows API](https://mastra.ai/reference/client-js/workflows)

package/.docs/reference/workflows/workflow-methods/agent.md

@@ -0,0 +1,62 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Workflow\.agent()
+
+The `.agent()` method adds an agent as a declarative step. The step accepts `{ prompt: string }` as input and returns `{ text: string }` by default. Use `.map()` before the agent to build the prompt from workflow data.
+
+Unlike wrapping an agent with `createStep()`, `.agent()` records a declarative entry in the workflow graph. This makes the workflow portable: the same graph can be serialized and persisted as a [stored workflow](https://mastra.ai/docs/workflows/stored-workflows).
+
+## Usage example
+
+```typescript
+workflow
+  .map({ prompt: mapVariable({ initData: workflow, path: "topic" }) })
+  .agent(testAgent)
+  .commit();
+```
+
+## Parameters
+
+**agentOrId** (`Agent | string`): An agent instance, or the ID of an agent registered on the Mastra instance. When passing an ID, the agent is resolved from the registry at execution time.
+
+**options** (`AgentStepOptions & { structuredOutput?: { schema }, retries?: number, scorers?: DynamicArgument<MastraScorers>, metadata?: StepMetadata }`): Agent call options such as maxSteps, modelSettings, memory, and providerOptions, plus step-level retries, scorers, and metadata. Per-request fields such as requestContext, resourceId, threadId, and onStepFinish are managed by the workflow engine and excluded.
+
+**stepOptions** (`{ id?: string }`): The step's call-site ID within the workflow. Defaults to the agent's ID. Set this when the same agent appears more than once in one workflow.
+
+## Returns
+
+**workflow** (`Workflow`): The workflow instance for method chaining
+
+## Structured output
+
+By default the step's output is `{ text: string }`. Pass `structuredOutput.schema` to make the step return that shape instead. The schema becomes the step's output schema, so later steps chain against it with full type safety:
+
+```typescript
+workflow
+  .agent(testAgent, {
+    structuredOutput: {
+      schema: z.object({
+        subtopics: z.array(z.string()),
+      }),
+    },
+  })
+  .commit();
+```
+
+## Referencing an agent by ID
+
+Pass a string to reference a registered agent without importing it. The agent must be registered on the Mastra instance when the workflow runs:
+
+```typescript
+workflow.agent("test-agent", { maxSteps: 3 }).commit();
+```
+
+## Persisting agent steps
+
+Workflows built with `.agent()` serialize to the same declarative entries that [stored workflows](https://mastra.ai/docs/workflows/stored-workflows) use. Only `retries` and `metadata` round-trip through storage. Options that hold functions, such as `onFinish` or a function-valued `toolChoice`, throw an error when the workflow is stored.
+
+## Related
+
+- [Agents and Tools](https://mastra.ai/docs/workflows/agents-and-tools)
+- [Stored workflows](https://mastra.ai/docs/workflows/stored-workflows)
+- [Workflow.tool()](https://mastra.ai/reference/workflows/workflow-methods/tool)

package/.docs/reference/workflows/workflow-methods/tool.md

@@ -0,0 +1,43 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Workflow\.tool()
+
+The `.tool()` method adds a tool as a declarative step. The tool's own input and output schemas apply, so the previous step's output must satisfy the tool's input schema. Use `.map()` to transform the data if they don't match.
+
+Unlike wrapping a tool with `createStep()`, `.tool()` records a declarative entry in the workflow graph. This makes the workflow portable: the same graph can be serialized and persisted as a [stored workflow](https://mastra.ai/docs/workflows/stored-workflows).
+
+## Usage example
+
+```typescript
+workflow.tool(testTool).commit();
+```
+
+## Parameters
+
+**toolOrId** (`Tool | string`): A tool instance, or the ID of a tool registered on the Mastra instance. When passing an ID, the tool is resolved from the registry at execution time.
+
+**options** (`{ retries?: number, scorers?: DynamicArgument<MastraScorers>, metadata?: StepMetadata }`): Step-level retry count, scorers, and metadata for the tool step.
+
+**stepOptions** (`{ id?: string }`): The step's call-site ID within the workflow. Defaults to the tool's ID. Set this when the same tool appears more than once in one workflow.
+
+## Returns
+
+**workflow** (`Workflow`): The workflow instance for method chaining
+
+## Referencing a tool by ID
+
+Pass a string to reference a registered tool without importing it. The tool must be registered on the Mastra instance when the workflow runs:
+
+```typescript
+workflow.tool("lookup-customer", { retries: 2 }).commit();
+```
+
+## Persisting tool steps
+
+Workflows built with `.tool()` serialize to the same declarative entries that [stored workflows](https://mastra.ai/docs/workflows/stored-workflows) use. Only `retries` and `metadata` round-trip through storage. A function-valued `scorers` option throws an error when the workflow is stored.
+
+## Related
+
+- [Agents and Tools](https://mastra.ai/docs/workflows/agents-and-tools)
+- [Stored workflows](https://mastra.ai/docs/workflows/stored-workflows)
+- [Workflow.agent()](https://mastra.ai/reference/workflows/workflow-methods/agent)

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.2.14-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`810c7e7`](https://github.com/mastra-ai/mastra/commit/810c7e74929989d8b8b5db52cd3af22cd0998af4), [`f9f9884`](https://github.com/mastra-ai/mastra/commit/f9f98848ee194dc71a787a709ec430b065cdc41b), [`e0904dc`](https://github.com/mastra-ai/mastra/commit/e0904dc538792e54e1806b70172e5900ac49bff4), [`64d6781`](https://github.com/mastra-ai/mastra/commit/64d67814bccddd314f7e09643243821e57cb87b6), [`c848e65`](https://github.com/mastra-ai/mastra/commit/c848e655a64ff10331a8ceafafe7f18e70a0f092), [`0494489`](https://github.com/mastra-ai/mastra/commit/049448906e4c3d2d615bbe865b073a0d890ddb7c), [`8d1aeb8`](https://github.com/mastra-ai/mastra/commit/8d1aeb8acf7c20c4bb8e4d8e4bdc6569c83ac561), [`83065bf`](https://github.com/mastra-ai/mastra/commit/83065bfee9e47c3c6f09132a9034501f6cfb69cf), [`01b162f`](https://github.com/mastra-ai/mastra/commit/01b162fe435295881aa7ea55f1759407ad5175ad)]:
+  - @mastra/core@1.57.0-alpha.2
+
 ## 1.2.14-alpha.2
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.14-alpha.3",
+  "version": "1.2.14-alpha.4",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.57.0-alpha.1",
-    "@mastra/mcp": "^1.15.1"
+    "@mastra/mcp": "^1.15.1",
+    "@mastra/core": "1.57.0-alpha.2"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.14",
@@ -45,9 +45,9 @@
     "tsx": "^4.23.1",
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
-    "@internal/types-builder": "0.0.95",
     "@internal/lint": "0.0.120",
-    "@mastra/core": "1.57.0-alpha.1"
+    "@internal/types-builder": "0.0.95",
+    "@mastra/core": "1.57.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {

package/.docs/models/providers/neon.md

@@ -1,109 +0,0 @@
-> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
-
-# ![Neon logo](https://models.dev/logos/neon.svg)Neon
-
-Access 36 Neon models through Mastra's model router. Authentication is handled automatically using the `NEON_AI_GATEWAY_TOKEN` environment variable. Configure `NEON_AI_GATEWAY_BASE_URL` as well.
-
-Learn more in the [Neon documentation](https://neon.com/docs).
-
-```bash
-NEON_AI_GATEWAY_BASE_URL=your-value
-NEON_AI_GATEWAY_TOKEN=your-api-token
-```
-
-```typescript
-import { Agent } from "@mastra/core/agent";
-
-const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "neon/claude-haiku-4-5"
-});
-
-// Generate a response
-const response = await agent.generate("Hello!");
-
-// Stream a response
-const stream = await agent.stream("Tell me a story");
-for await (const chunk of stream) {
-  console.log(chunk);
-}
-```
-
-> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Neon documentation](https://neon.com/docs) for details.
-
-## Models
-
-| Model                              | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `neon/claude-haiku-4-5`            | 200K    |       |           |       |       |       | $1         | $5          |
-| `neon/claude-opus-4-1`             | 200K    |       |           |       |       |       | $15        | $75         |
-| `neon/claude-opus-4-5`             | 200K    |       |           |       |       |       | $5         | $25         |
-| `neon/claude-opus-4-6`             | 1.0M    |       |           |       |       |       | $5         | $25         |
-| `neon/claude-opus-4-7`             | 1.0M    |       |           |       |       |       | $5         | $25         |
-| `neon/claude-opus-4-8`             | 1.0M    |       |           |       |       |       | $5         | $25         |
-| `neon/claude-sonnet-4`             | 200K    |       |           |       |       |       | $3         | $15         |
-| `neon/claude-sonnet-4-5`           | 200K    |       |           |       |       |       | $3         | $15         |
-| `neon/claude-sonnet-4-6`           | 1.0M    |       |           |       |       |       | $3         | $15         |
-| `neon/gemini-2-5-flash`            | 1.0M    |       |           |       |       |       | $0.30      | $3          |
-| `neon/gemini-2-5-pro`              | 1.0M    |       |           |       |       |       | $1         | $10         |
-| `neon/gemini-3-1-flash-lite`       | 1.0M    |       |           |       |       |       | $0.25      | $2          |
-| `neon/gemini-3-1-pro`              | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `neon/gemini-3-5-flash`            | 1.0M    |       |           |       |       |       | $2         | $9          |
-| `neon/gemini-3-flash`              | 1.0M    |       |           |       |       |       | $0.50      | $3          |
-| `neon/gemini-3-pro`                | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `neon/gemma-3-12b`                 | 131K    |       |           |       |       |       | $0.15      | $0.50       |
-| `neon/gpt-5`                       | 400K    |       |           |       |       |       | $1         | $10         |
-| `neon/gpt-5-1`                     | 400K    |       |           |       |       |       | $1         | $10         |
-| `neon/gpt-5-1-codex-max`           | 400K    |       |           |       |       |       | $1         | $10         |
-| `neon/gpt-5-1-codex-mini`          | 400K    |       |           |       |       |       | $0.25      | $2          |
-| `neon/gpt-5-2`                     | 400K    |       |           |       |       |       | $2         | $14         |
-| `neon/gpt-5-2-codex`               | 400K    |       |           |       |       |       | $2         | $14         |
-| `neon/gpt-5-3-codex`               | 400K    |       |           |       |       |       | $2         | $14         |
-| `neon/gpt-5-4`                     | 1.1M    |       |           |       |       |       | $3         | $15         |
-| `neon/gpt-5-4-mini`                | 400K    |       |           |       |       |       | $0.75      | $5          |
-| `neon/gpt-5-4-nano`                | 400K    |       |           |       |       |       | $0.20      | $1          |
-| `neon/gpt-5-mini`                  | 400K    |       |           |       |       |       | $0.25      | $2          |
-| `neon/gpt-5-nano`                  | 400K    |       |           |       |       |       | $0.05      | $0.40       |
-| `neon/gpt-oss-120b`                | 131K    |       |           |       |       |       | $0.07      | $0.28       |
-| `neon/gpt-oss-20b`                 | 131K    |       |           |       |       |       | $0.05      | $0.20       |
-| `neon/llama-4-maverick`            | 1.0M    |       |           |       |       |       | $0.50      | $2          |
-| `neon/meta-llama-3-1-8b-instruct`  | 131K    |       |           |       |       |       | $0.15      | $0.45       |
-| `neon/meta-llama-3-3-70b-instruct` | 128K    |       |           |       |       |       | $0.50      | $2          |
-| `neon/qwen3-next-80b-a3b-instruct` | 131K    |       |           |       |       |       | $0.15      | $1          |
-| `neon/qwen35-122b-a10b`            | 262K    |       |           |       |       |       | $0.22      | $2          |
-
-## Advanced configuration
-
-### Custom headers
-
-```typescript
-const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
-  model: {
-    url: "${NEON_AI_GATEWAY_BASE_URL}/v1",
-    id: "neon/claude-haiku-4-5",
-    apiKey: process.env.NEON_AI_GATEWAY_TOKEN,
-    headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
-```
-
-### Dynamic model selection
-
-```typescript
-const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
-  model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "neon/qwen35-122b-a10b"
-      : "neon/claude-haiku-4-5";
-  }
-});
-```