@strands-agents/sdk 0.1.0 → 0.1.2
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.
- package/README.md +13 -10
- package/package.json +25 -25
package/README.md
CHANGED
|
@@ -171,22 +171,25 @@ await agent.invoke('What is the weather in San Francisco?')
|
|
|
171
171
|
Seamlessly integrate Model Context Protocol (MCP) servers:
|
|
172
172
|
|
|
173
173
|
```typescript
|
|
174
|
-
import { Agent, McpClient
|
|
174
|
+
import { Agent, McpClient } from "@strands-agents/sdk";
|
|
175
|
+
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
|
|
175
176
|
|
|
176
177
|
// Create a client for a local MCP server
|
|
177
|
-
const
|
|
178
|
+
const documentationTools = new McpClient({
|
|
178
179
|
transport: new StdioClientTransport({
|
|
179
|
-
command:
|
|
180
|
-
args: [
|
|
180
|
+
command: "uvx",
|
|
181
|
+
args: ["awslabs.aws-documentation-mcp-server@latest"],
|
|
181
182
|
}),
|
|
182
|
-
})
|
|
183
|
+
});
|
|
183
184
|
|
|
184
185
|
const agent = new Agent({
|
|
185
|
-
systemPrompt:
|
|
186
|
-
tools: [
|
|
187
|
-
})
|
|
186
|
+
systemPrompt: "You are a helpful assistant using MCP tools.",
|
|
187
|
+
tools: [documentationTools], // Pass the MCP client directly as a tool source
|
|
188
|
+
});
|
|
189
|
+
|
|
190
|
+
await agent.invoke("Use a random tool from the MCP server.");
|
|
188
191
|
|
|
189
|
-
await
|
|
192
|
+
await documentationTools.disconnect();
|
|
190
193
|
```
|
|
191
194
|
|
|
192
195
|
---
|
|
@@ -196,7 +199,7 @@ await agent.invoke('Use a random tool from the MCP server.')
|
|
|
196
199
|
For detailed guidance, tutorials, and concept overviews, please visit:
|
|
197
200
|
|
|
198
201
|
- **[Official Documentation](https://strandsagents.com/)**: Comprehensive guides and tutorials
|
|
199
|
-
- **[API Reference](.
|
|
202
|
+
- **[API Reference](https://strandsagents.com/latest/documentation/docs/api-reference/typescript/)**: Complete API documentation
|
|
200
203
|
- **[Examples](./examples/)**: Sample applications
|
|
201
204
|
- **[Contributing Guide](CONTRIBUTING.md)**: Development setup and guidelines
|
|
202
205
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@strands-agents/sdk",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "TypeScript SDK for Strands Agents framework",
|
|
5
5
|
"main": "dist/src/index.js",
|
|
6
6
|
"module": "dist/src/index.js",
|
|
@@ -11,28 +11,28 @@
|
|
|
11
11
|
],
|
|
12
12
|
"exports": {
|
|
13
13
|
".": {
|
|
14
|
-
"
|
|
15
|
-
"
|
|
14
|
+
"types": "./dist/src/index.d.ts",
|
|
15
|
+
"default": "./dist/src/index.js"
|
|
16
16
|
},
|
|
17
17
|
"./openai": {
|
|
18
|
-
"
|
|
19
|
-
"
|
|
18
|
+
"types": "./dist/src/models/openai.d.ts",
|
|
19
|
+
"default": "./dist/src/models/openai.js"
|
|
20
20
|
},
|
|
21
21
|
"./bedrock": {
|
|
22
|
-
"
|
|
23
|
-
"
|
|
22
|
+
"types": "./dist/src/models/bedrock.d.ts",
|
|
23
|
+
"default": "./dist/src/models/bedrock.js"
|
|
24
24
|
},
|
|
25
25
|
"./vended_tools/notebook": {
|
|
26
|
-
"
|
|
27
|
-
"
|
|
26
|
+
"types": "./dist/vended_tools/notebook/index.d.ts",
|
|
27
|
+
"default": "./dist/vended_tools/notebook/index.js"
|
|
28
28
|
},
|
|
29
29
|
"./vended_tools/file_editor": {
|
|
30
|
-
"
|
|
31
|
-
"
|
|
30
|
+
"types": "./dist/vended_tools/file_editor/index.d.ts",
|
|
31
|
+
"default": "./dist/vended_tools/file_editor/index.js"
|
|
32
32
|
},
|
|
33
33
|
"./vended_tools/http_request": {
|
|
34
|
-
"
|
|
35
|
-
"
|
|
34
|
+
"types": "./dist/vended_tools/http_request/index.d.ts",
|
|
35
|
+
"default": "./dist/vended_tools/http_request/index.js"
|
|
36
36
|
}
|
|
37
37
|
},
|
|
38
38
|
"scripts": {
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"test:browser:install": "npx playwright install --with-deps chromium",
|
|
51
51
|
"test:all": "vitest run --project unit-node --project unit-browser",
|
|
52
52
|
"test:all:coverage": "vitest run --coverage --project unit-node --project unit-browser",
|
|
53
|
-
"test:package": "npm
|
|
53
|
+
"test:package": "cd test/packages/esm-module && npm install && node esm.js && cd ../cjs-module && npm install && node cjs.js",
|
|
54
54
|
"lint": "eslint src tests_integ vended_tools",
|
|
55
55
|
"lint:fix": "eslint src tests_integ vended_tools --fix",
|
|
56
56
|
"format": "prettier --write src tests_integ vended_tools",
|
|
@@ -69,21 +69,21 @@
|
|
|
69
69
|
"author": "Strands Agents",
|
|
70
70
|
"license": "Apache-2.0",
|
|
71
71
|
"devDependencies": {
|
|
72
|
-
"@aws-sdk/client-secrets-manager": "^3.
|
|
73
|
-
"@aws-sdk/credential-providers": "^3.
|
|
72
|
+
"@aws-sdk/client-secrets-manager": "^3.943.0",
|
|
73
|
+
"@aws-sdk/credential-providers": "^3.943.0",
|
|
74
74
|
"@types/json-schema": "^7.0.15",
|
|
75
75
|
"@types/node": "^24.6.0",
|
|
76
|
-
"@typescript-eslint/eslint-plugin": "^8.
|
|
76
|
+
"@typescript-eslint/eslint-plugin": "^8.48.1",
|
|
77
77
|
"@typescript-eslint/parser": "^8.0.0",
|
|
78
|
-
"@vitest/browser": "^4.0.
|
|
79
|
-
"@vitest/browser-playwright": "^4.0.
|
|
80
|
-
"@vitest/coverage-v8": "^4.0.
|
|
78
|
+
"@vitest/browser": "^4.0.15",
|
|
79
|
+
"@vitest/browser-playwright": "^4.0.15",
|
|
80
|
+
"@vitest/coverage-v8": "^4.0.15",
|
|
81
81
|
"eslint": "^9.0.0",
|
|
82
82
|
"eslint-plugin-tsdoc": "^0.5.0",
|
|
83
83
|
"husky": "^9.1.7",
|
|
84
84
|
"playwright": "^1.56.1",
|
|
85
|
-
"prettier": "^3.
|
|
86
|
-
"tsx": "^4.
|
|
85
|
+
"prettier": "^3.7.4",
|
|
86
|
+
"tsx": "^4.21.0",
|
|
87
87
|
"typescript": "^5.5.0",
|
|
88
88
|
"vitest": "^4.0.8"
|
|
89
89
|
},
|
|
@@ -92,15 +92,15 @@
|
|
|
92
92
|
},
|
|
93
93
|
"repository": {
|
|
94
94
|
"type": "git",
|
|
95
|
-
"url": "https://github.com/strands-agents/sdk-typescript.git"
|
|
95
|
+
"url": "git+https://github.com/strands-agents/sdk-typescript.git"
|
|
96
96
|
},
|
|
97
97
|
"bugs": {
|
|
98
98
|
"url": "https://github.com/strands-agents/sdk-typescript/issues"
|
|
99
99
|
},
|
|
100
100
|
"homepage": "https://github.com/strands-agents/sdk-typescript#readme",
|
|
101
101
|
"dependencies": {
|
|
102
|
-
"@aws-sdk/client-bedrock-runtime": "^3.
|
|
103
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
102
|
+
"@aws-sdk/client-bedrock-runtime": "^3.943.0",
|
|
103
|
+
"@modelcontextprotocol/sdk": "^1.24.2",
|
|
104
104
|
"zod": "^4.1.12"
|
|
105
105
|
},
|
|
106
106
|
"optionalDependencies": {
|