0.15.1 • Published 17h ago

@agentick/bedrock

Licence

MIT

Version

0.15.1

Deps

Size

271 kB

Vulns

Weekly

Stars

Summary Dependency Versions

@agentick/bedrock

AWS Bedrock Converse API adapter for Agentick.

Installation

pnpm add @agentick/bedrock @aws-sdk/client-bedrock-runtime

Usage

Factory Pattern (Recommended)

import { bedrock } from "@agentick/bedrock";
import { createApp } from "@agentick/core";

const model = bedrock("us.anthropic.claude-sonnet-4-20250514-v1:0");

// Use with createApp
const app = createApp(MyAgent, { model });
const session = await app.session();
await session.run({ messages: [{ role: "user", content: [{ type: "text", text: "Hello!" }] }] });

// Or with config object
const model = bedrock({
  model: "us.anthropic.claude-sonnet-4-20250514-v1:0",
  region: "us-east-1",
  maxTokens: 8192,
});

JSX Component Pattern

import { BedrockModel } from "@agentick/bedrock";

function MyAgent() {
  return (
    <BedrockModel model="us.anthropic.claude-sonnet-4-20250514-v1:0" maxTokens={4096}>
      <System>You are helpful.</System>
      <Timeline />
    </BedrockModel>
  );
}

Features

Streaming - Full streaming support via ConverseStream
Tool calling - Native tool use support
Multi-model - Claude, Nova, Llama, Mistral, and more via Bedrock
S3 image support - Image and document understanding
Guardrails - Bedrock Guardrails integration

Configuration

Option	Type	Description
`model`	`string`	Model ID (e.g., `us.anthropic.claude-sonnet-4-20250514-v1:0`)
`region`	`string?`	AWS region (env: `AWS_REGION`)
`credentials`	`object?`	Explicit `{ accessKeyId, secretAccessKey, sessionToken? }`
`profile`	`string?`	AWS profile name for credential chain
`client`	`BedrockRuntimeClient?`	Pre-configured client instance
`maxTokens`	`number?`	Maximum tokens to generate
`customBlocks`	`object?`	Custom block definitions to intercept from output
`deltaTransform`	`function?`	User-facing delta transform

Guardrails

const model = bedrock({
  model: "us.anthropic.claude-sonnet-4-20250514-v1:0",
  providerOptions: {
    bedrock: {
      guardrailConfig: {
        guardrailIdentifier: "my-guardrail-id",
        guardrailVersion: "1",
      },
    },
  },
});

AWS Authentication

The adapter uses the standard AWS credential chain. Configure via any of:

Method	Description
Environment vars	`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`, `AWS_SESSION_TOKEN`
AWS profile	`profile` option or `AWS_PROFILE` env var
IAM role	EC2/ECS/Lambda instance role
Explicit	`credentials` config option

Environment Variables

Variable	Description
`AWS_REGION`	AWS region
`AWS_DEFAULT_REGION`	Fallback region
`AWS_ACCESS_KEY_ID`	AWS access key
`AWS_SECRET_ACCESS_KEY`	AWS secret key
`AWS_SESSION_TOKEN`	Session token (optional)
`AWS_PROFILE`	Named profile

Model IDs

# Claude
us.anthropic.claude-opus-4-20250514-v1:0
us.anthropic.claude-sonnet-4-20250514-v1:0
anthropic.claude-3-5-sonnet-20241022-v2:0
anthropic.claude-3-5-haiku-20241022-v1:0

# Amazon Nova
amazon.nova-pro-v1:0
amazon.nova-lite-v1:0
amazon.nova-micro-v1:0

# Meta Llama
meta.llama3-1-70b-instruct-v1:0