Add the Strands example

Author: poad

.github/dependabot.yml

@@ -25,6 +25,7 @@ updates:
       - '/agents/agent-mastra/'
       - '/agents/agent-voltagent/'
       - '/agents/agent-sdk/'
+      - '/agents/agent-strands/'
       - '/basic/cdk/'
       - '/basic/app/'
       - '/mcp/clients/langgraph-mcp-client/'

agents/agent-sdk/package.json

@@ -34,7 +34,7 @@
     "vitest": "^4.0.15"
   },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.1.59",
+    "@anthropic-ai/claude-agent-sdk": "^0.1.60",
     "source-map-support": "^0.5.21",
     "uuid": "^13.0.0",
     "zod": "^4.1.13"

agents/agent-strands/.gitignore

@@ -0,0 +1,112 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+# dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and *not* Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+.DS_Store
+
+eslint.config.js
+eslint.config.d.ts
+**/*.d.ts
+**/*.js
+cdk.out
+!**/awslambda.d.ts

agents/agent-strands/bin/cdk.ts

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import * as cdk from 'aws-cdk-lib';
+import {
+  CloudfrontCdnTemplateStack,
+} from '../lib/cdk-stack.js';
+
+const app = new cdk.App();
+
+new CloudfrontCdnTemplateStack(app, 'agent-strands-lambda-example', {
+  appName: 'agent-strands-lambda-example',
+  env: {
+    account: app.account,
+    region: app.region,
+  },
+});

agents/agent-strands/cdk.context.json

@@ -0,0 +1,6 @@
+{
+  "acknowledged-issue-numbers": [
+    34892
+  ],
+  "cli-telemetry": false
+}

agents/agent-strands/cdk.json

@@ -0,0 +1,25 @@
+{
+  "app": "pnpm dlx tsx bin/cdk.ts",
+  "watch": {
+    "include": [
+      "**"
+    ],
+    "exclude": [
+      "README.md",
+      "cdk*.json",
+      "**/*.d.ts",
+      "**/*.js",
+      "tsconfig.json",
+      "package*.json",
+      "yarn.lock",
+      "node_modules",
+      "test",
+      "eslint.config.mjs"
+    ]
+  },
+  "requireApproval": "never",
+  "versionReporting": false,
+  "pathMetadata": false,
+  "context": {
+  }
+}

agents/agent-strands/eslint.config.ts

@@ -0,0 +1,74 @@
+import { Config, defineConfig } from 'eslint/config';
+import eslint from '@eslint/js';
+import { configs, parser } from 'typescript-eslint';
+import stylistic from '@stylistic/eslint-plugin';
+import importPlugin from 'eslint-plugin-import';
+// @ts-expect-error ignore type errors
+import pluginPromise from 'eslint-plugin-promise';
+
+import { includeIgnoreFile } from '@eslint/compat';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const gitignorePath = path.resolve(__dirname, '.gitignore');
+
+const eslintConfig: Config[] = defineConfig(
+  {
+    ignores: [
+      ...(includeIgnoreFile(gitignorePath).ignores || []),
+      '**/*.d.ts',
+      'src/tsconfig.json',
+      'src/stories',
+      '**/*.css',
+      'node_modules/**/*',
+      'out',
+      'cdk.out',
+      'dist',
+      'app',
+      '**/*.js',
+    ],
+  },
+  eslint.configs.recommended,
+  configs.strict,
+  configs.stylistic,
+  pluginPromise.configs['flat/recommended'],
+  {
+    files: ['**/*.ts', '*.js'],
+    plugins: {
+      '@stylistic': stylistic,
+    },
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      parser,
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: __dirname,
+        allowDefaultProject: ['eslint.config.ts'],
+      },
+    },
+    extends: [
+      importPlugin.flatConfigs.recommended,
+      importPlugin.flatConfigs.typescript,
+    ],
+    settings: {
+      'import/resolver': {
+        // You will also need to install and configure the TypeScript resolver
+        // See also https://github.com/import-js/eslint-import-resolver-typescript#configuration
+        'typescript': true,
+        'node': true,
+      },
+    },
+    rules: {
+      '@stylistic/semi': ['error', 'always'],
+      '@stylistic/indent': ['error', 2],
+      '@stylistic/comma-dangle': ['error', 'always-multiline'],
+      '@stylistic/arrow-parens': ['error', 'always'],
+      '@stylistic/quotes': ['error', 'single'],
+    },
+  },
+);
+
+export default eslintConfig;

agents/agent-strands/lambda/agent.ts

@@ -0,0 +1,14 @@
+import { Agent, BedrockModel } from '@strands-agents/sdk';
+
+const createAgent = ({ model: modelId }: { model: string }) => {
+  const model = new BedrockModel({
+    region: 'us-east-1',
+    modelId: modelId,
+    maxTokens: 4096,
+    temperature: 0.7,
+  });
+
+  return new Agent({ model });
+};
+
+export { createAgent };

agents/agent-strands/lambda/awslambda.d.ts

@@ -0,0 +1,24 @@
+'use strict';
+
+import { APIGatewayProxyEvent, APIGatewayProxyEvent, Context, Callback } from 'aws-lambda';
+import { Stream } from 'stream'
+
+export type Event = APIGatewayProxyEvent | APIGatewayProxyEventV2;
+
+export class HttpResponseStream {
+  static from(underlyingStream: any, prelude: any): any;
+}
+
+export type RequestHandler = (
+  event: Event,
+  streamResponse: Stream.WritableStream,
+  ctx?: Context,
+  callback?: Callback<any>,
+) => any | Promise<any>;
+
+declare global {
+  namespace awslambda {
+      function streamifyResponse(handler: RequestHandler, option?: any): RequestHandler;
+      let HttpResponseStream: HttpResponseStream;
+  }
+}

agents/agent-strands/lambda/index.ts

@@ -0,0 +1,27 @@
+import { logger } from '@llm-ts-example/common-backend';
+import { APIGatewayProxyEvent } from 'aws-lambda';
+import { createAgent } from './agent.js';
+
+export const handle = async ({ message: message = 'こんにちは！', model: model = 'us.amazon.nova-micro-v1:0' }: { message: string, model: string }, output: NodeJS.WritableStream) => {
+  const agent = createAgent({ model });
+  for await (const event of agent.stream(message)) {
+    // console.log('[Event]', event.type);
+    if (event.type === 'modelContentBlockDeltaEvent') {
+      if (event.delta.type === 'textDelta') {
+        output.write(event.delta.text);
+      }
+    }
+  }
+};
+
+export const handler = awslambda.streamifyResponse(
+  async (
+    event: APIGatewayProxyEvent, responseStream: NodeJS.WritableStream,
+  ) => {
+    logger.debug('event', { event });
+    const { message, model } = event.body ? JSON.parse(event.body) : {};
+    await handle({ message, model }, responseStream);
+    responseStream.end();
+  });
+
+export default handler;