feat: add import from Bedrock Agents to add agent and create flows (#563)

* feat: add Import from Bedrock Agents to add agent and create flows

Adds a third option in the "add agent" flow that fetches a Bedrock Agent's
configuration via AWS SDK and translates it into runnable Strands or
LangChain/LangGraph Python code, wired into the standard AgentCore project
structure.

Supports action groups, knowledge bases, multi-agent collaboration, code
interpreter, guardrails, prompt overrides, and memory configuration. Both
interactive TUI and non-interactive CLI paths are implemented.

* style: fix prettier formatting in docs

* fix: escape backslashes in action group description for generated Python code

* style: fix prettier formatting across all changed files

* fix: align memory retrieval strategies with agentcore.json config

- Add actor_id=user_id to all retrieve_memories calls (was missing in
  Strands translator)
- Pass memoryOption through to translators so generated Python code
  matches the strategies written to agentcore.json
- shortTerm: no namespace-specific retrieval (no strategies in schema)
- longAndShortTerm: retrieve from all three strategy namespaces
  (/users/{user_id}/facts, /users/{user_id}/preferences,
  /summaries/{user_id}/) matching SEMANTIC, USER_PREFERENCE, and
  SUMMARIZATION strategies

* style: fix prettier formatting in translators

* fix: address review feedback from aidandaly24

- Prevent infinite recursion in collaborator fetching by threading a
  visited-agents set through getBedrockAgentConfig
- Fix LangGraph checkpointer_STM NameError when memory is disabled by
  making the checkpointer parameter conditional
- Fix memory_manager NameError in both translators when memoryEnabled
  but agentcoreMemoryEnabled is false
- Add shared Python string escaping utilities (escapePyDoubleQuote,
  escapePySingleQuote, escapePyTripleQuote) and apply consistently
  to all user-provided string interpolations
- Sanitize KB and collaborator names into valid Python identifiers
  (replace non-alphanumeric chars, handle leading digits)
- Add pagination loops for all list API calls (agents, aliases,
  action groups, knowledge bases, collaborators)
- Replace non-null assertions with explicit null guards
- Validate alias ARNs with regex before extracting agent/alias IDs
- Add console.warn messages to all catch blocks instead of silently
  discarding errors
- Fix stale closure for importConfig.region using a ref
- Add guardrail warning comment in Strands generated code

* fix: resolve lint errors in bedrock-import and AddAgentScreen

- Use Set<string> constructor generic instead of variable annotation
- Replace unknown err in template literals with String(err)
- Use RegExp#exec() instead of String#match()
- Move ref update into useEffect to avoid updating during render

Author: tejaskash

AGENTS.md

@@ -48,6 +48,7 @@ Note: CDK L3 constructs are in a separate package `@aws/agentcore-cdk`.
 - **Template agents**: Created from framework templates (Strands, LangChain_LangGraph, CrewAI, GoogleADK, OpenAIAgents,
   AutoGen)
 - **BYO agents**: Bring your own code with `agentcore add agent --type byo`
+- **Imported agents**: Import from Bedrock Agents with `agentcore add agent --type import`
 
 ### Build Types
 

docs/commands.md

@@ -53,13 +53,24 @@ agentcore create --name MyProject --no-agent
 
 # Preview without creating
 agentcore create --name MyProject --defaults --dry-run
+
+# Import from Bedrock Agents
+agentcore create \
+  --name MyImportedAgent \
+  --type import \
+  --agent-id AGENT123 \
+  --agent-alias-id ALIAS456 \
+  --region us-east-1 \
+  --framework Strands \
+  --memory none
 ```
 
 | Flag                      | Description                                                                      |
 | ------------------------- | -------------------------------------------------------------------------------- |
 | `--name <name>`           | Project name (alphanumeric, starts with letter, max 23 chars)                    |
 | `--defaults`              | Use defaults (Python, Strands, Bedrock, no memory)                               |
 | `--no-agent`              | Skip agent creation                                                              |
+| `--type <type>`           | `create` (default) or `import`                                                   |
 | `--language <lang>`       | `Python` (default)                                                               |
 | `--framework <fw>`        | `Strands`, `LangChain_LangGraph`, `CrewAI`, `GoogleADK`, `OpenAIAgents`          |
 | `--model-provider <p>`    | `Bedrock`, `Anthropic`, `OpenAI`, `Gemini`                                       |
@@ -70,6 +81,9 @@ agentcore create --name MyProject --defaults --dry-run
 | `--network-mode <mode>`   | `PUBLIC` (default) or `VPC`                                                      |
 | `--subnets <ids>`         | Comma-separated subnet IDs (required for VPC mode)                               |
 | `--security-groups <ids>` | Comma-separated security group IDs (required for VPC mode)                       |
+| `--agent-id <id>`         | Bedrock Agent ID (import only)                                                   |
+| `--agent-alias-id <id>`   | Bedrock Agent Alias ID (import only)                                             |
+| `--region <region>`       | AWS region for Bedrock Agent (import only)                                       |
 | `--output-dir <dir>`      | Output directory                                                                 |
 | `--skip-git`              | Skip git initialization                                                          |
 | `--skip-python-setup`     | Skip venv setup                                                                  |
@@ -167,24 +181,37 @@ agentcore add agent \
   --network-mode VPC \
   --subnets subnet-abc,subnet-def \
   --security-groups sg-123
+
+# Import from Bedrock Agents
+agentcore add agent \
+  --name MyAgent \
+  --type import \
+  --agent-id AGENT123 \
+  --agent-alias-id ALIAS456 \
+  --region us-east-1 \
+  --framework Strands \
+  --memory none
 ```
 
 | Flag                      | Description                                                                      |
 | ------------------------- | -------------------------------------------------------------------------------- |
 | `--name <name>`           | Agent name (alphanumeric, starts with letter, max 64 chars)                      |
-| `--type <type>`           | `create` (default) or `byo`                                                      |
+| `--type <type>`           | `create` (default), `byo`, or `import`                                           |
 | `--build <type>`          | `CodeZip` (default) or `Container` (see [Container Builds](container-builds.md)) |
 | `--language <lang>`       | `Python` (create); `Python`, `TypeScript`, `Other` (BYO)                         |
 | `--framework <fw>`        | `Strands`, `LangChain_LangGraph`, `CrewAI`, `GoogleADK`, `OpenAIAgents`          |
 | `--model-provider <p>`    | `Bedrock`, `Anthropic`, `OpenAI`, `Gemini`                                       |
 | `--api-key <key>`         | API key for non-Bedrock providers                                                |
-| `--memory <opt>`          | `none`, `shortTerm`, `longAndShortTerm` (create only)                            |
+| `--memory <opt>`          | `none`, `shortTerm`, `longAndShortTerm` (create and import)                      |
 | `--protocol <protocol>`   | `HTTP` (default), `MCP`, `A2A`                                                   |
 | `--code-location <path>`  | Path to existing code (BYO only)                                                 |
 | `--entrypoint <file>`     | Entry file relative to code-location (BYO, default: `main.py`)                   |
 | `--network-mode <mode>`   | `PUBLIC` (default) or `VPC`                                                      |
 | `--subnets <ids>`         | Comma-separated subnet IDs (required for VPC mode)                               |
 | `--security-groups <ids>` | Comma-separated security group IDs (required for VPC mode)                       |
+| `--agent-id <id>`         | Bedrock Agent ID (import only)                                                   |
+| `--agent-alias-id <id>`   | Bedrock Agent Alias ID (import only)                                             |
+| `--region <region>`       | AWS region for Bedrock Agent (import only)                                       |
 | `--json`                  | JSON output                                                                      |
 
 ### add memory

docs/frameworks.md

@@ -76,6 +76,51 @@ OpenAI's native agent framework.
 agentcore create --framework OpenAIAgents --model-provider OpenAI --api-key sk-...
 ```
 
+## Import from Bedrock Agents
+
+If you have an existing Bedrock Agent, you can import its configuration and translate it into runnable Strands or
+LangChain/LangGraph code. The imported agent preserves your Bedrock Agent's action groups, knowledge bases, multi-agent
+collaboration, guardrails, prompts, and memory configuration.
+
+```bash
+# Interactive (select "Import from Bedrock Agents" in the wizard)
+agentcore add agent
+
+# Non-interactive
+agentcore add agent \
+  --name MyAgent \
+  --type import \
+  --agent-id AGENT123 \
+  --agent-alias-id ALIAS456 \
+  --region us-east-1 \
+  --framework Strands \
+  --memory none
+```
+
+### What gets imported
+
+The import process fetches your Bedrock Agent's full configuration and translates it into framework-specific Python code
+that runs on AgentCore:
+
+- **Action groups** (function-schema and built-in) become `@tool` decorated functions
+- **Knowledge bases** become retrieval tool integrations
+- **Multi-agent collaboration** produces separate collaborator files with recursive translation
+- **Code interpreter** wires to AgentCore's `code_interpreter_client`
+- **Guardrails** are configured in the model initialization
+- **Prompt overrides** are preserved as template variables
+- **Memory** integrates with AgentCore's memory service when enabled
+
+### Import options
+
+| Flag                    | Description                               |
+| ----------------------- | ----------------------------------------- |
+| `--type import`         | Use import mode (required)                |
+| `--agent-id <id>`       | Bedrock Agent ID                          |
+| `--agent-alias-id <id>` | Bedrock Agent Alias ID                    |
+| `--region <region>`     | AWS region where the Bedrock Agent exists |
+| `--framework <fw>`      | `Strands` or `LangChain_LangGraph`        |
+| `--memory <opt>`        | `none`, `shortTerm`, `longAndShortTerm`   |
+
 ## Bring Your Own (BYO) Agent
 
 For existing agent code or frameworks not listed above, use the BYO option: