Add Project class for agentcore.json configuration management

[jariy17]

Summary

• Add Project class to load/save agentcore.json format (starter-toolkit CLI compatibility)
• Create Pydantic config models matching the agentcore.json schema
• Move YAML loading/saving logic from Agent/Memory to Project class
• Simplify Build abstract class (remove strategy_name, keep only launch() and image_uri)
• Make Agent.launch() and Memory.launch() idempotent (create if not exists, update if exists)
• Build.launch() always rebuilds to pick up source code changes

Usage

Load from agentcore.json and deploy

from bedrock_agentcore import Project

# Load from starter-toolkit agentcore.json
project = Project.from_json("agentcore.json")

# Deploy all resources (memories first, then agents)
project.launch_all()

# Check status
print(project.status())

# Save deployed state (runtimeId, runtimeArn, memoryIds)
project.save_deployed_state("deployed-state.json")

# Access individual resources
agent = project.get_agent("my-agent")
response = agent.invoke({"message": "Hello!"})

# Clean up
project.destroy_all()

Create from scratch

from bedrock_agentcore import Project
from bedrock_agentcore.runtime import Agent
from bedrock_agentcore.memory import Memory
from bedrock_agentcore.runtime.build import DirectCodeDeploy

# Create project
project = Project(name="my-project", region="us-west-2")

# Add agent with direct code deploy
build = DirectCodeDeploy(source_path="./src", entrypoint="main.py:handler")
agent = Agent(name="my-agent", build=build)
project.add_agent(agent)

# Add memory
memory = Memory(
    name="my-memory",
    strategies=[{"type": "SEMANTIC", "namespace": "facts/{sessionId}/"}]
)
project.add_memory(memory)

# Save to agentcore.json format
project.save("agentcore.json")

# Deploy
project.launch_all()

New Files

File	Description
src/bedrock_agentcore/project.py	Project class for resource management
src/bedrock_agentcore/project_config.py	Pydantic models for agentcore.json schema
tests/bedrock_agentcore/test_project.py	Project class tests

API Changes

Project class

Method	Description
Project.from_json(path)	Load from agentcore.json
project.save(path)	Save to agentcore.json
project.save_deployed_state(path)	Save deployed-state.json
project.save_aws_targets(path)	Save aws-targets.json
project.launch_all()	Deploy all memories and agents
project.destroy_all()	Delete all resources
project.status()	Get status of all resources
project.add_agent(agent)	Add agent to project
project.add_memory(memory)	Add memory to project
project.get_agent(name)	Get agent by name
project.get_memory(name)	Get memory by name

Breaking Changes

• Removed Agent.from_yaml() and Agent.save() - use Project.from_json() instead
• Removed Memory.from_yaml() and Memory.save() - use Project.from_json() instead
• Removed Build.strategy_name property - use isinstance() for type checking

Test plan

• All 957 tests pass
• Project class tests cover: init, from_json, save, resource management, status

🤖 Generated with Claude Code