@mastra/mcp-docs-server 0.13.23 → 0.13.24-alpha.2

package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md

@@ -1,5 +1,14 @@
 # @mastra/voice-gladia
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md

@@ -1,5 +1,14 @@
 # @mastra/voice-google-gemini-live
 
+## 0.10.12-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.10.11
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md

@@ -1,5 +1,14 @@
 # @mastra/voice-google
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [41daa63]
 - Updated dependencies [ad0a58b]
 - Updated dependencies [254a36b]
-- Updated dependencies [2ecf658]
-- Updated dependencies [7a7754f]
-- Updated dependencies [fc92d80]
-- Updated dependencies [e0f73c6]
-- Updated dependencies [0b89602]
-- Updated dependencies [4d37822]
-- Updated dependencies [23a6a7c]
-- Updated dependencies [cda801d]
-- Updated dependencies [a77c823]
-
-... 1314 more lines hidden. See full changelog in package directory.
+
+... 1323 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md

@@ -1,5 +1,14 @@
 # @mastra/voice-murf
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [a77c823]
 - Updated dependencies [ff9c125]
 - Updated dependencies [09bca64]
-- Updated dependencies [b8efbb9]
-- Updated dependencies [71466e7]
-- Updated dependencies [0c99fbe]
-  - @mastra/core@0.12.0
-
-## 0.10.6-alpha.0
-
-### Patch Changes
-
 
-... 1295 more lines hidden. See full changelog in package directory.
+... 1304 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md

@@ -1,5 +1,14 @@
 # @mastra/voice-openai-realtime
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [cda801d]
 - Updated dependencies [a77c823]
 - Updated dependencies [ff9c125]
-- Updated dependencies [09bca64]
-- Updated dependencies [b8efbb9]
-- Updated dependencies [71466e7]
-- Updated dependencies [0c99fbe]
-  - @mastra/core@0.12.0
-
-## 0.10.6-alpha.1
-
-### Patch Changes
 
-... 1027 more lines hidden. See full changelog in package directory.
+... 1036 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md

@@ -1,5 +1,14 @@
 # @mastra/voice-openai
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 - Updated dependencies [fc92d80]
 - Updated dependencies [e0f73c6]
 - Updated dependencies [0b89602]
-- Updated dependencies [4d37822]
-- Updated dependencies [23a6a7c]
-- Updated dependencies [cda801d]
-- Updated dependencies [a77c823]
-- Updated dependencies [ff9c125]
-- Updated dependencies [09bca64]
-- Updated dependencies [b8efbb9]
-- Updated dependencies [71466e7]
-- Updated dependencies [0c99fbe]
-
-... 1325 more lines hidden. See full changelog in package directory.
+
+... 1334 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md

@@ -1,5 +1,14 @@
 # @mastra/voice-playai
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 - 8e1b6e9: dependencies updates:
   - Updated dependency [`zod@^3.25.67` ↗︎](https://www.npmjs.com/package/zod/v/3.25.67) (from `^3.25.57`, in `dependencies`)
-- Updated dependencies [15e9d26]
-- Updated dependencies [d1baedb]
-- Updated dependencies [d8f2d19]
-- Updated dependencies [4d21bf2]
-- Updated dependencies [07d6d88]
-- Updated dependencies [9d52b17]
-- Updated dependencies [2097952]
-- Updated dependencies [792c4c0]
-- Updated dependencies [5d74aab]
-
-... 1265 more lines hidden. See full changelog in package directory.
+
+... 1274 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md

@@ -1,5 +1,14 @@
 # @mastra/voice-sarvam
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 - 8e1b6e9: dependencies updates:
   - Updated dependency [`zod@^3.25.67` ↗︎](https://www.npmjs.com/package/zod/v/3.25.67) (from `^3.25.57`, in `dependencies`)
-- Updated dependencies [15e9d26]
-- Updated dependencies [d1baedb]
-- Updated dependencies [d8f2d19]
-- Updated dependencies [4d21bf2]
-- Updated dependencies [07d6d88]
-- Updated dependencies [9d52b17]
-- Updated dependencies [2097952]
-- Updated dependencies [792c4c0]
-- Updated dependencies [5d74aab]
-
-... 915 more lines hidden. See full changelog in package directory.
+
+... 924 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md

@@ -1,5 +1,14 @@
 # @mastra/voice-speechify
 
+## 0.11.6-alpha.0
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55)]:
+  - @mastra/core@0.18.0-alpha.2
+
 ## 0.11.5
 
 ### Patch Changes
@@ -289,14 +298,5 @@
 
 ## 0.10.5
 
-### Patch Changes
-
-- ce088f5: Update all peerdeps to latest core
-  - @mastra/core@0.11.1
-
-## 0.10.4
-
-### Patch Changes
-
 
-... 1280 more lines hidden. See full changelog in package directory.
+... 1289 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,18 @@
 # create-mastra
 
+## 0.13.2-alpha.2
+
+## 0.13.2-alpha.1
+
+### Patch Changes
+
+- dependencies updates: ([#8007](https://github.com/mastra-ai/mastra/pull/8007))
+  - Updated dependency [`fs-extra@^11.3.2` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.2) (from `^11.3.1`, in `dependencies`)
+
+## 0.13.2-alpha.0
+
+## 0.13.1
+
 ## 0.13.1-alpha.0
 
 ## 0.13.0
@@ -285,18 +298,5 @@
 
 - ad04455: Missed changeset in last release, needed to include create-mastra
 
-## 0.10.15-alpha.0
-
-### Patch Changes
-
-- ad04455: Missed changeset in last release, needed to include create-mastra
-
-## 0.10.14
-
-### Patch Changes
-
-- f442224: speech to text using voice config
-- d8dec5e: add a cta to invite to deploy to cloud
-- 6336993: Fix workflow input form overflow
 
-... 1430 more lines hidden. See full changelog in package directory.
+... 1443 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,50 @@
 # mastra
 
+## 0.13.2-alpha.2
+
+### Patch Changes
+
+- Update Peerdeps for packages based on core minor bump ([#8025](https://github.com/mastra-ai/mastra/pull/8025))
+
+- Updated dependencies [[`cf34503`](https://github.com/mastra-ai/mastra/commit/cf345031de4e157f29087946449e60b965e9c8a9), [`6b4b1e4`](https://github.com/mastra-ai/mastra/commit/6b4b1e4235428d39e51cbda9832704c0ba70ab32), [`3469fca`](https://github.com/mastra-ai/mastra/commit/3469fca7bb7e5e19369ff9f7044716a5e4b02585), [`2d29ad9`](https://github.com/mastra-ai/mastra/commit/2d29ad92763cac02fc1d80c221ac93c39c0c5caf), [`c4a8204`](https://github.com/mastra-ai/mastra/commit/c4a82046bfd241d6044e234bc5917d5a01fe6b55), [`5b1ee71`](https://github.com/mastra-ai/mastra/commit/5b1ee71dc3ac92383226dc1e375642ca5f9b4224)]:
+  - @mastra/core@0.18.0-alpha.2
+  - @mastra/deployer@0.18.0-alpha.2
+  - @mastra/loggers@0.10.13-alpha.0
+  - @mastra/mcp@0.13.1-alpha.0
+
+## 0.13.2-alpha.1
+
+### Patch Changes
+
+- dependencies updates: ([#8007](https://github.com/mastra-ai/mastra/pull/8007))
+  - Updated dependency [`fs-extra@^11.3.2` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.2) (from `^11.3.1`, in `dependencies`)
+
+- show the tool-output stream in the playground for streamVNext ([#7983](https://github.com/mastra-ai/mastra/pull/7983))
+
+- Updated dependencies [[`288745a`](https://github.com/mastra-ai/mastra/commit/288745a19aa9557db3ab3c877d667ff59f14d79c), [`c45298a`](https://github.com/mastra-ai/mastra/commit/c45298a0a0791db35cf79f1199d77004da0704cb)]:
+  - @mastra/deployer@0.17.2-alpha.1
+  - @mastra/core@0.17.2-alpha.1
+
+## 0.13.2-alpha.0
+
+### Patch Changes
+
+- Get rid off swr one for all ([#7931](https://github.com/mastra-ai/mastra/pull/7931))
+
+- Updated dependencies [[`a61f23f`](https://github.com/mastra-ai/mastra/commit/a61f23fbbca4b88b763d94f1d784c47895ed72d7), [`d1dc606`](https://github.com/mastra-ai/mastra/commit/d1dc6067b0557a71190b68d56ee15b48c26d2411), [`d3bd4d4`](https://github.com/mastra-ai/mastra/commit/d3bd4d482a685bbb67bfa89be91c90dca3fa71ad)]:
+  - @mastra/core@0.17.2-alpha.0
+  - @mastra/deployer@0.17.2-alpha.0
+
+## 0.13.1
+
+### Patch Changes
+
+- fix workflow resuming issue in the playground ([#7988](https://github.com/mastra-ai/mastra/pull/7988))
+
+- Updated dependencies [[`fd00e63`](https://github.com/mastra-ai/mastra/commit/fd00e63759cbcca3473c40cac9843280b0557cff), [`ab610f6`](https://github.com/mastra-ai/mastra/commit/ab610f6f41dbfe6c9502368671485ca7a0aac09b), [`e6bda5f`](https://github.com/mastra-ai/mastra/commit/e6bda5f954ee8493ea18adc1a883f0a5b785ad9b)]:
+  - @mastra/core@0.17.1
+  - @mastra/deployer@0.17.1
+
 ## 0.13.1-alpha.0
 
 ### Patch Changes
@@ -253,50 +298,5 @@
   - @mastra/mcp@0.12.0
   - @mastra/core@0.16.1
 
-## 0.12.1-alpha.2
-
-### Patch Changes
-
-- Fix template slug when getting template environment variables ([#7650](https://github.com/mastra-ai/mastra/pull/7650))
-
-- Updated dependencies [[`fd9bbfe`](https://github.com/mastra-ai/mastra/commit/fd9bbfee22484f8493582325f53e8171bf8e682b)]:
-  - @mastra/core@0.16.1-alpha.3
-  - @mastra/deployer@0.16.1-alpha.3
-
-## 0.12.1-alpha.1
-
-### Patch Changes
-
-- Use workflow streamVNext in playground ([#7575](https://github.com/mastra-ai/mastra/pull/7575))
-
-- add workflow streaming in agent thread ([#7506](https://github.com/mastra-ai/mastra/pull/7506))
-
-- Updated dependencies [[`0f7b8c0`](https://github.com/mastra-ai/mastra/commit/0f7b8c0c22d2a677a0f71c35ad1bc2d60b063d39), [`47b6dc9`](https://github.com/mastra-ai/mastra/commit/47b6dc94f4976d4f3d3882e8f19eb365bbc5976c), [`565d65f`](https://github.com/mastra-ai/mastra/commit/565d65fc16314a99f081975ec92f2636dff0c86d), [`4da3d68`](https://github.com/mastra-ai/mastra/commit/4da3d68a778e5c4d5a17351ef223289fe2f45a45), [`0b0bbb2`](https://github.com/mastra-ai/mastra/commit/0b0bbb24f4198ead69792e92b68a350f52b45cf3), [`d951f41`](https://github.com/mastra-ai/mastra/commit/d951f41771e4e5da8da4b9f870949f9509e38756), [`8049e2e`](https://github.com/mastra-ai/mastra/commit/8049e2e8cce80a00353c64894c62b695ac34e35e), [`f36343e`](https://github.com/mastra-ai/mastra/commit/f36343e02935b9a112a45b2dc3de7b562cc3aa68)]:
-  - @mastra/mcp@0.12.0-alpha.1
-  - @mastra/core@0.16.1-alpha.1
-  - @mastra/deployer@0.16.1-alpha.1
-
-## 0.12.1-alpha.0
-
-### Patch Changes
-
-- dependencies updates: ([#7544](https://github.com/mastra-ai/mastra/pull/7544))
-  - Updated dependency [`fs-extra@^11.3.1` ↗︎](https://www.npmjs.com/package/fs-extra/v/11.3.1) (from `^11.3.0`, in `dependencies`)
-
-- Update cli dev copy from "Local" - ([#7579](https://github.com/mastra-ai/mastra/pull/7579))
-
-- Updated dependencies [[`6d6e5dd`](https://github.com/mastra-ai/mastra/commit/6d6e5dd00edd5f4d2f310d347c615aef3ed7f609), [`0662d02`](https://github.com/mastra-ai/mastra/commit/0662d02ef16916e67531890639fcd72c69cfb6e2), [`6189844`](https://github.com/mastra-ai/mastra/commit/61898448e65bda02bb814fb15801a89dc6476938), [`90cab34`](https://github.com/mastra-ai/mastra/commit/90cab347db71359dc5f3d001b1e8d63fd958879a), [`e75360a`](https://github.com/mastra-ai/mastra/commit/e75360a134d722df969777abcf36092fadad1f12), [`d7a8f59`](https://github.com/mastra-ai/mastra/commit/d7a8f59154b0621aec4f41a6b2ea2b3882f03cb7), [`4dda259`](https://github.com/mastra-ai/mastra/commit/4dda2593b6343f9258671de5fb237aeba3ef6bb7), [`defed1c`](https://github.com/mastra-ai/mastra/commit/defed1ca8040cc8d42e645c5a50a1bc52a4918d7), [`79b39c1`](https://github.com/mastra-ai/mastra/commit/79b39c1def3bbd5d6ee2d2cc1e89ea378a940477), [`6991ced`](https://github.com/mastra-ai/mastra/commit/6991cedcb5a44a49d9fe58ef67926e1f96ba55b1), [`9cb9c42`](https://github.com/mastra-ai/mastra/commit/9cb9c422854ee81074989dd2d8dccc0500ba8d3e), [`8334859`](https://github.com/mastra-ai/mastra/commit/83348594d4f37b311ba4a94d679c5f8721d796d4)]:
-  - @mastra/deployer@0.16.1-alpha.0
-  - @mastra/core@0.16.1-alpha.0
-  - @mastra/mcp@0.12.0-alpha.0
-
-## 0.12.0
-
-### Minor Changes
-
-- a01cf14: Add workflow graph in agent (workflow as tool in agent)
-
-### Patch Changes
-
 
-... 5653 more lines hidden. See full changelog in package directory.
+... 5698 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/dynamic-agents.mdx

@@ -23,6 +23,7 @@ const supportAgent = new Agent({
     const userTier = runtimeContext.get("user-tier");
     const language = runtimeContext.get("language");
 
+    // Can return a string
     return `You are a customer support agent for our SaaS platform.
     The current user is on the ${userTier} tier and prefers ${language} language.
 
@@ -32,6 +33,24 @@ const supportAgent = new Agent({
     ${userTier === "enterprise" ? "- Provide priority support with custom solutions" : ""}
 
     Always respond in ${language} language.`;
+    
+    // Alternative: Return a system message object with provider options
+    // return {
+    //   role: "system",
+    //   content: `You are a customer support agent for ${userTier} tier...`,
+    //   providerOptions: {
+    //     openai: { 
+    //       reasoning_effort: userTier === "enterprise" ? "high" : "medium"
+    //     }
+    //   }
+    // };
+    
+    // Alternative: Return an array of system messages for modular instructions
+    // return [
+    //   { role: "system", content: "You are a customer support agent." },
+    //   { role: "system", content: `User is on ${userTier} tier.` },
+    //   { role: "system", content: `Respond in ${language} language.` }
+    // ];
   },
 
   model: ({ runtimeContext }) => {

package/.docs/raw/agents/overview.mdx

@@ -64,6 +64,52 @@ export const testAgent = new Agent({
 });
 ```
 
+#### Instruction formats
+
+Instructions define the agent's behavior, personality, and capabilities.
+They are system-level prompts that establish the agent's core identity and expertise.
+
+Instructions can be provided in multiple formats for greater flexibility:
+
+```typescript showLineNumbers copy
+// String (most common)
+instructions: "You are a helpful assistant."
+
+// System message object
+instructions: { 
+  role: "system", 
+  content: "You are an expert programmer." 
+}
+
+// Array of strings
+instructions: [
+  "You are a helpful assistant.",
+  "Always be polite.",
+  "Provide detailed answers."
+]
+
+// Array of system messages
+instructions: [
+  { role: "system", content: "You are a helpful assistant." },
+  { role: "system", content: "You have expertise in TypeScript." }
+]
+
+// With provider-specific options (e.g., caching, reasoning)
+instructions: {
+  role: "system",
+  content: "You are an expert code reviewer. Analyze code for bugs, performance issues, and best practices.",
+  providerOptions: {
+    openai: { reasoning_effort: "high" },        // OpenAI's reasoning models
+    anthropic: { cache_control: { type: "ephemeral" } }  // Anthropic's prompt caching
+  }
+}
+```
+
+Provider-specific options allow you to leverage unique features of different LLM providers:
+- **Anthropic caching**: Reduce costs by caching frequently-used instructions
+- **OpenAI reasoning**: Enable deeper analysis for complex tasks
+- **Custom parameters**: Pass any provider-specific configuration
+
 > See [Agent](../../reference/agents/agent.mdx) for more information.