@mastra/mcp-docs-server 1.1.29-alpha.8 → 1.1.29

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 (23) hide show
  1. package/.docs/docs/agents/background-tasks.md +242 -0
  2. package/.docs/docs/agents/channels.md +2 -1
  3. package/.docs/docs/agents/supervisor-agents.md +35 -4
  4. package/.docs/docs/agents/using-tools.md +1 -0
  5. package/.docs/docs/streaming/background-task-streaming.md +80 -0
  6. package/.docs/docs/streaming/overview.md +3 -0
  7. package/.docs/docs/workspace/filesystem.md +1 -1
  8. package/.docs/guides/guide/slack-assistant.md +191 -0
  9. package/.docs/models/index.md +1 -1
  10. package/.docs/models/providers/deepinfra.md +2 -1
  11. package/.docs/models/providers/fireworks-ai.md +2 -1
  12. package/.docs/models/providers/kilo.md +3 -1
  13. package/.docs/reference/client-js/agents.md +24 -0
  14. package/.docs/reference/configuration.md +63 -0
  15. package/.docs/reference/harness/harness-class.md +53 -10
  16. package/.docs/reference/index.md +2 -0
  17. package/.docs/reference/observability/tracing/interfaces.md +17 -0
  18. package/.docs/reference/processors/stream-error-retry-processor.md +54 -0
  19. package/.docs/reference/streaming/ChunkType.md +140 -0
  20. package/.docs/reference/streaming/agents/streamUntilIdle.md +94 -0
  21. package/.docs/reference/workspace/s3-filesystem.md +79 -5
  22. package/CHANGELOG.md +30 -0
  23. package/package.json +6 -6
package/.docs/reference/workspace/s3-filesystem.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # S3Filesystem
2
2
 
3
- Stores files in Amazon S3 or S3-compatible storage services like Cloudflare R2, MinIO, and DigitalOcean Spaces.
3
+ Stores files in Amazon S3 or S3-compatible storage services like Cloudflare R2, MinIO, DigitalOcean Spaces, and Tigris.
4
4
 
5
5
  > **Info:** For interface details, see [WorkspaceFilesystem Interface](https://mastra.ai/reference/workspace/filesystem).
6
6
 
@@ -55,6 +55,61 @@ const agent = new Agent({
55
55
  })
56
56
  ```
57
57
 
58
+ ### AWS credential provider chain
59
+
60
+ When no credentials are provided, `S3Filesystem` uses the AWS SDK default credential provider chain. This discovers credentials automatically from environment variables, `~/.aws` config files, ECS container credentials, EC2 instance profiles, and other standard sources.
61
+
62
+ ```typescript
63
+ import { S3Filesystem } from '@mastra/s3'
64
+
65
+ // SDK discovers credentials from the environment automatically
66
+ const filesystem = new S3Filesystem({
67
+ bucket: 'my-bucket',
68
+ region: 'us-east-1',
69
+ })
70
+ ```
71
+
72
+ Pass a credential provider function for auto-refreshing credentials. This is useful for deployments on ECS, Lambda, or when using SSO/AssumeRole where temporary credentials expire and need to be refreshed.
73
+
74
+ Install the AWS SDK credential providers package when calling `fromNodeProviderChain()` directly:
75
+
76
+ **npm**:
77
+
78
+ ```bash
79
+ npm install @aws-sdk/credential-providers
80
+ ```
81
+
82
+ **pnpm**:
83
+
84
+ ```bash
85
+ pnpm add @aws-sdk/credential-providers
86
+ ```
87
+
88
+ **Yarn**:
89
+
90
+ ```bash
91
+ yarn add @aws-sdk/credential-providers
92
+ ```
93
+
94
+ **Bun**:
95
+
96
+ ```bash
97
+ bun add @aws-sdk/credential-providers
98
+ ```
99
+
100
+ ```typescript
101
+ import { S3Filesystem } from '@mastra/s3'
102
+ import { fromNodeProviderChain } from '@aws-sdk/credential-providers'
103
+
104
+ const filesystem = new S3Filesystem({
105
+ bucket: 'my-bucket',
106
+ region: 'us-east-1',
107
+ credentials: fromNodeProviderChain(),
108
+ })
109
+ ```
110
+
111
+ Provider functions only apply to `S3Filesystem` API calls. When mounting the filesystem into an E2B sandbox, mount configuration only supports static `accessKeyId`, `secretAccessKey`, and `sessionToken` values, so credential refresh must be handled outside the mount.
112
+
58
113
  ### Cloudflare R2
59
114
 
60
115
  ```typescript
@@ -83,19 +138,38 @@ const filesystem = new S3Filesystem({
83
138
  })
84
139
  ```
85
140
 
141
+ ### Tigris
142
+
143
+ ```typescript
144
+ import { S3Filesystem } from '@mastra/s3'
145
+
146
+ const filesystem = new S3Filesystem({
147
+ bucket: 'my-bucket',
148
+ region: 'auto',
149
+ endpoint: 'https://t3.storage.dev',
150
+ accessKeyId: process.env.TIGRIS_ACCESS_KEY_ID,
151
+ secretAccessKey: process.env.TIGRIS_SECRET_ACCESS_KEY,
152
+ forcePathStyle: false,
153
+ })
154
+ ```
155
+
156
+ Tigris uses virtual-hosted-style addressing, so `forcePathStyle` must be set to `false` (the default is `true` when a custom endpoint is provided). Create credentials from the [Tigris Dashboard](https://console.tigris.dev/) — access keys are prefixed `tid_` and secrets `tsec_`.
157
+
86
158
  ## Constructor parameters
87
159
 
88
160
  **bucket** (`string`): S3 bucket name
89
161
 
90
162
  **region** (`string`): AWS region (use 'auto' for R2)
91
163
 
92
- **accessKeyId** (`string`): AWS access key ID. Optional for public buckets (read-only access).
164
+ **credentials** (`AwsCredentialIdentity | AwsCredentialIdentityProvider`): AWS credentials or credential provider function. Accepts static credentials or a provider that auto-refreshes (e.g. \`fromNodeProviderChain()\` from \`@aws-sdk/credential-providers\`). Takes precedence over \`accessKeyId\`/\`secretAccessKey\`/\`sessionToken\`. When all credential options are omitted, the SDK default credential provider chain is used.
165
+
166
+ **accessKeyId** (`string`): AWS access key ID. When omitted along with \`secretAccessKey\` and \`credentials\`, the SDK default credential provider chain is used.
93
167
 
94
- **secretAccessKey** (`string`): AWS secret access key. Optional for public buckets (read-only access).
168
+ **secretAccessKey** (`string`): AWS secret access key. When omitted along with \`accessKeyId\` and \`credentials\`, the SDK default credential provider chain is used.
95
169
 
96
- **sessionToken** (`string`): AWS session token for temporary credentials. Required when using SSO, AssumeRole, container credentials, or any other temporary credential provider.
170
+ **sessionToken** (`string`): AWS session token for static temporary credentials. Use with \`accessKeyId\`/\`secretAccessKey\` only when passing a complete temporary credential set manually. For auto-refreshing SSO, AssumeRole, or container credentials, use the \`credentials\` provider parameter or the SDK default credential provider chain.
97
171
 
98
- **endpoint** (`string`): Custom endpoint URL for S3-compatible storage (R2, MinIO, etc.)
172
+ **endpoint** (`string`): Custom endpoint URL for S3-compatible storage (R2, MinIO, Tigris, etc.)
99
173
 
100
174
  **forcePathStyle** (`boolean`): Force path-style URLs instead of virtual-hosted-style. Required for some S3-compatible services like MinIO. Defaults to true when a custom endpoint is provided. (Default: `true (when endpoint is set)`)
101
175
 
package/CHANGELOG.md CHANGED
@@ -1,5 +1,35 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.1.29
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`28caa5b`](https://github.com/mastra-ai/mastra/commit/28caa5b032358545af2589ed90636eccb4dd9d2f), [`c1ae974`](https://github.com/mastra-ai/mastra/commit/c1ae97491f6e57378ce880c3a397778c42adcdf1), [`b510d36`](https://github.com/mastra-ai/mastra/commit/b510d368f73dab6be2e2c2bc99035aaef1fb7d7a), [`10e1c9a`](https://github.com/mastra-ai/mastra/commit/10e1c9a6a99c14eb055d0f409b603e07af827e68), [`13b4d7c`](https://github.com/mastra-ai/mastra/commit/13b4d7c16de34dff9095d1cd80f22f544b6cfe75), [`7a7b313`](https://github.com/mastra-ai/mastra/commit/7a7b3138fb3bcf0b0c740eaea07971e43d330ef3), [`c04417b`](https://github.com/mastra-ai/mastra/commit/c04417ba0a2e4ded66da4352331ef29cd4bd1d79), [`cf25a03`](https://github.com/mastra-ai/mastra/commit/cf25a03132164b9dc1e5dccf7394824e33007c51), [`8a71261`](https://github.com/mastra-ai/mastra/commit/8a71261e3954ae617c6f8e25767b951f99438ab2), [`9e973b0`](https://github.com/mastra-ai/mastra/commit/9e973b010dacfa15ac82b0072897319f5234b90a), [`dd934a0`](https://github.com/mastra-ai/mastra/commit/dd934a0982ce0f78712fbd559e4f2410bf594b39), [`ba6b0c5`](https://github.com/mastra-ai/mastra/commit/ba6b0c51bfce358554fd33c7f2bcd5593633f2ff), [`a6dac0a`](https://github.com/mastra-ai/mastra/commit/a6dac0a40c7181161b1add4e8534f962bcbc9aa7), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`6c8c6c7`](https://github.com/mastra-ai/mastra/commit/6c8c6c71518394321a4692614aa4b11f3bb0a343), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`7d056b6`](https://github.com/mastra-ai/mastra/commit/7d056b6ecf603cacaa0f663ff1df025ed885b6c1), [`9cef83b`](https://github.com/mastra-ai/mastra/commit/9cef83b8a642b8098747772921e3523b492bafbc), [`d30e215`](https://github.com/mastra-ai/mastra/commit/d30e2156c746bc9fd791745cec1cc24377b66789), [`021a60f`](https://github.com/mastra-ai/mastra/commit/021a60f1f3e0135a70ef23c58be7a9b3aaffe6b4), [`73f2809`](https://github.com/mastra-ai/mastra/commit/73f2809721db24e98cdf122539652a455211b450), [`aedeea4`](https://github.com/mastra-ai/mastra/commit/aedeea48a94f728323f040478775076b9574be50), [`26f1f94`](https://github.com/mastra-ai/mastra/commit/26f1f9490574b864ba1ecedf2c9632e0767a23bd), [`8126d86`](https://github.com/mastra-ai/mastra/commit/8126d8638411eacfafdc29036ac998e8757ea66f), [`73b45fa`](https://github.com/mastra-ai/mastra/commit/73b45facdef4fbcb8af710c50f0646f18619dbaa), [`ae97520`](https://github.com/mastra-ai/mastra/commit/ae975206fdb0f6ef03c4d5bf94f7dc7c3f706c02), [`7a7b313`](https://github.com/mastra-ai/mastra/commit/7a7b3138fb3bcf0b0c740eaea07971e43d330ef3), [`441670a`](https://github.com/mastra-ai/mastra/commit/441670a02c9dc7731c52674f55481e7848a84523)]:
8
+ - @mastra/core@1.29.0
9
+ - @mastra/mcp@1.6.0
10
+
11
+ ## 1.1.29-alpha.12
12
+
13
+ ### Patch Changes
14
+
15
+ - Updated dependencies [[`c1ae974`](https://github.com/mastra-ai/mastra/commit/c1ae97491f6e57378ce880c3a397778c42adcdf1), [`10e1c9a`](https://github.com/mastra-ai/mastra/commit/10e1c9a6a99c14eb055d0f409b603e07af827e68), [`13b4d7c`](https://github.com/mastra-ai/mastra/commit/13b4d7c16de34dff9095d1cd80f22f544b6cfe75), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`6c8c6c7`](https://github.com/mastra-ai/mastra/commit/6c8c6c71518394321a4692614aa4b11f3bb0a343), [`5a4b1ee`](https://github.com/mastra-ai/mastra/commit/5a4b1ee80212969621228104995589c0fa59e575), [`ec4cb26`](https://github.com/mastra-ai/mastra/commit/ec4cb26919972eb2031fea510f8f013e1d5b7ee2)]:
16
+ - @mastra/core@1.29.0-alpha.6
17
+ - @mastra/mcp@1.6.0-alpha.0
18
+
19
+ ## 1.1.29-alpha.10
20
+
21
+ ### Patch Changes
22
+
23
+ - Updated dependencies [[`28caa5b`](https://github.com/mastra-ai/mastra/commit/28caa5b032358545af2589ed90636eccb4dd9d2f), [`7d056b6`](https://github.com/mastra-ai/mastra/commit/7d056b6ecf603cacaa0f663ff1df025ed885b6c1), [`26f1f94`](https://github.com/mastra-ai/mastra/commit/26f1f9490574b864ba1ecedf2c9632e0767a23bd)]:
24
+ - @mastra/core@1.29.0-alpha.5
25
+
26
+ ## 1.1.29-alpha.9
27
+
28
+ ### Patch Changes
29
+
30
+ - Updated dependencies [[`8a71261`](https://github.com/mastra-ai/mastra/commit/8a71261e3954ae617c6f8e25767b951f99438ab2), [`021a60f`](https://github.com/mastra-ai/mastra/commit/021a60f1f3e0135a70ef23c58be7a9b3aaffe6b4)]:
31
+ - @mastra/core@1.29.0-alpha.4
32
+
3
33
  ## 1.1.29-alpha.7
4
34
 
5
35
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.1.29-alpha.8",
3
+ "version": "1.1.29",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -29,8 +29,8 @@
29
29
  "jsdom": "^26.1.0",
30
30
  "local-pkg": "^1.1.2",
31
31
  "zod": "^4.3.6",
32
- "@mastra/core": "1.29.0-alpha.3",
33
- "@mastra/mcp": "^1.5.2"
32
+ "@mastra/core": "1.29.0",
33
+ "@mastra/mcp": "^1.6.0"
34
34
  },
35
35
  "devDependencies": {
36
36
  "@hono/node-server": "^1.19.11",
@@ -46,9 +46,9 @@
46
46
  "tsx": "^4.21.0",
47
47
  "typescript": "^5.9.3",
48
48
  "vitest": "4.1.5",
49
- "@internal/types-builder": "0.0.61",
50
- "@mastra/core": "1.29.0-alpha.3",
51
- "@internal/lint": "0.0.86"
49
+ "@internal/lint": "0.0.87",
50
+ "@mastra/core": "1.29.0",
51
+ "@internal/types-builder": "0.0.62"
52
52
  },
53
53
  "homepage": "https://mastra.ai",
54
54
  "repository": {