bedrock-agentcore-starter-toolkit 0.1.17__tar.gz → 0.1.19__tar.gz

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.1.19] - 2025-10-03
+
+### Changes
+
+- updates gateway created lambda to python 3.13 (#196) (c5e5642)
+- Add explicit user creation config for Cognito pools (#218) (432898e)
+- Labs (#245) (579d086)
+- chore: bump version to 0.1.18 (#246) (c8d6c29)
+
+## [0.1.18] - 2025-10-02
+
+### Changes
+
+- fix: add non_interactive parameter for notebooks and fix code style issues (#244) (03953bb)
+- chore: bump version to 0.1.17 (#243) (99945c7)
+
 ## [0.1.17] - 2025-10-01
 
 ### Changes

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bedrock-agentcore-starter-toolkit
-Version: 0.1.17
+Version: 0.1.19
 Summary: A starter toolkit for using Bedrock AgentCore
 Project-URL: Homepage, https://github.com/aws/bedrock-agentcore-starter-toolkit
 Project-URL: Bug Tracker, https://github.com/aws/bedrock-agentcore-starter-toolkit/issues

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/documentation/docs/examples/agentcore-quickstart-example.md

@@ -68,25 +68,25 @@ current_session = None
 def calculate(code: str) -> str:
     """Execute Python code for calculations or analysis."""
     session_id = current_session or 'default'
-    
+
     if session_id not in ci_sessions:
         ci_sessions[session_id] = {
             'client': CodeInterpreter(REGION),
             'session_id': None
         }
-    
+
     ci = ci_sessions[session_id]
     if not ci['session_id']:
         ci['session_id'] = ci['client'].start(
             name=f"session_{session_id[:30]}",
             session_timeout_seconds=1800
         )
-    
+
     result = ci['client'].invoke("executeCode", {
         "code": code,
         "language": "python"
     })
-    
+
     for event in result.get("stream", []):
         if stdout := event.get("result", {}).get("structuredContent", {}).get("stdout"):
             return stdout
@@ -95,15 +95,15 @@ def calculate(code: str) -> str:
 @app.entrypoint
 def invoke(payload, context):
     global current_session
-    
+
     if not MEMORY_ID:
         return {"error": "Memory not configured"}
-    
+
     actor_id = context.headers.get('X-Amzn-Bedrock-AgentCore-Runtime-Custom-Actor-Id', 'user') if hasattr(context, 'headers') else 'user'
-    
+
     session_id = getattr(context, 'session_id', 'default')
     current_session = session_id
-    
+
     memory_config = AgentCoreMemoryConfig(
         memory_id=MEMORY_ID,
         session_id=session_id,
@@ -113,14 +113,14 @@ def invoke(payload, context):
             f"/users/{actor_id}/preferences": RetrievalConfig(top_k=3, relevance_score=0.5)
         }
     )
-    
+
     agent = Agent(
         model=MODEL_ID,
         session_manager=AgentCoreMemorySessionManager(memory_config, REGION),
         system_prompt="You are a helpful assistant. Use tools when appropriate.",
         tools=[calculate]
     )
-    
+
     result = agent(payload.get("prompt", ""))
     return {"response": result.message.get('content', [{}])[0].get('text', str(result))}
 

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/documentation/docs/mcp/agentcore_runtime_deployment.md

@@ -7,7 +7,7 @@
 - **New Agents**: Install AgentCore packages and create your agent using hello world strands agents  [Installation & Creation Guide](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#step-1-install-and-create-your-agent)
 - **Existing Agents**: Transform your current agent code to work with AgentCore - [Framework Integration Examples](https://aws.github.io/bedrock-agentcore-starter-toolkit/examples/index.html)
 
-#### Step 1.1: For strands refer to following documentation 
+#### Step 1.1: For strands refer to following documentation
 - [Welcome](https://strandsagents.com/latest/documentation/docs/index.md)
 - [Amazon Bedrock](https://strandsagents.com/latest/documentation/docs/user-guide/concepts/model-providers/amazon-bedrock/index.md)
 - [Amazon Bedrock AgentCore](https://strandsagents.com/latest/documentation/docs/user-guide/deploy/deploy_to_bedrock_agentcore/index.md)
@@ -15,14 +15,14 @@
 2. Create an agent with default settings - agent = Agent()
 3. Ask the agent a question - agent("Tell me about agentic AI")
 
-#### Step 1.2 - Transforming agent code for agentcore 
+#### Step 1.2 - Transforming agent code for agentcore
 - **Agent code**: Always use these [code patterns](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/overview.html#agent-development-patterns) for agent code.
 - **AgentCore Wrapper**: Use  [bedrock-agentcore](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/overview.html#what-is-the-agentcore-runtime-sdk) wrappers to implement runtime service contract.
 1. Import the Runtime App with from bedrock_agentcore.runtime import BedrockAgentCoreApp
 2. Initialize the App in your code with app = BedrockAgentCoreApp()
 3. Decorate the invocation function with the @app.entrypoint decorator
 4. Create a requirements.txt file with needed packages. Note: if strands-tools is detected, the correct library to add is strands-agents-tools
-5. Let AgentCore Runtime control the running of the agent with app.run() 
+5. Let AgentCore Runtime control the running of the agent with app.run()
 
 #### Step 2: Local Development & Testing (Optional)
 - **Local Testing**: Run and test your agent locally before deployment - [Local Testing Guide](https://aws.github.io/bedrock-agentcore-starter-toolkit/user-guide/runtime/quickstart.html#step-2-test-locally)

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/documentation/docs/user-guide/identity/quickstart.md

@@ -126,14 +126,14 @@ echo "export COGNITO_PASSWORD='$PASSWORD'"
 
 ```
 
-## Step 1: Create a credential provider 
+## Step 1: Create a credential provider
 
 Credential providers are how your agent accesses external services. Create a credential provider and configure it with an OAuth 2.0 client for your authorization server.
 
 If you are using your own authorization server, set the environment variables `ISSUER_URL`, `CLIENT_ID`, and `CLIENT_SECRET` with their appropriate values from your authorization server. If you are using the previous script to create an authorization server for you with Cognito, copy the EXPORT statements from the output into your terminal to set the environment variables.
 
 This credential provider will be used by your agent's code to get access tokens to act on behalf of your user.
- 
+
 
 
 
@@ -157,7 +157,7 @@ aws bedrock-agentcore-control create-oauth2-credential-provider \
 
 ## Step 2: Create a sample agent that initiates an OAuth 2.0 flow
 
-In this step, we will create an agent that initiates an OAuth 2.0 authorization flow to get tokens to act on behalf of the user. For simplicity, the agent will not make actual calls to external services on behalf of a user, but will prove to us that it has obtained consent to act on behalf of our test user. 
+In this step, we will create an agent that initiates an OAuth 2.0 authorization flow to get tokens to act on behalf of the user. For simplicity, the agent will not make actual calls to external services on behalf of a user, but will prove to us that it has obtained consent to act on behalf of our test user.
 
 
 ### Agent code

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/documentation/docs/user-guide/memory/quickstart.md

@@ -1,6 +1,6 @@
 # Getting Started with AgentCore Memory
 
-Amazon Bedrock AgentCore Memory lets you create and manage memory resources that store conversation context for your AI agents. This section guides you through installing dependencies and implementing both short-term and long-term memory features. 
+Amazon Bedrock AgentCore Memory lets you create and manage memory resources that store conversation context for your AI agents. This section guides you through installing dependencies and implementing both short-term and long-term memory features.
 
 The steps are as follows
 
@@ -80,7 +80,7 @@ memories = memory_manager.list_memories()
 Writing events to memory has multiple purposes. First, event contents (most commonly conversation history) are stored as short term memory. Second, relevant insights are pulled from events and written into memory records as a part of long term memory.
 
 The memory resource id, actor id, and session id are required to create an event. We are going to create three events, simulating messages between an end user and a chat bot.
- 
+
 
 ```python
 # Create a session to store memory events
@@ -178,4 +178,3 @@ Consider the following as you continue your AgentCore journey
 * Add another strategy to your memory resource
 * Enable observability for more visibility into how memory is working
 * Look at the vast collection of samples to familiarize yourself with other use cases.
-

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "bedrock-agentcore-starter-toolkit"
-version = "0.1.17"
+version = "0.1.19"
 description = "A starter toolkit for using Bedrock AgentCore"
 readme = "README.md"
 requires-python = ">=3.10"

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/src/bedrock_agentcore_starter_toolkit/notebook/runtime/bedrock_agentcore.py

@@ -47,6 +47,7 @@ class Runtime:
         region: Optional[str] = None,
         protocol: Optional[Literal["HTTP", "MCP"]] = None,
         disable_otel: bool = False,
+        non_interactive: bool = True,
     ) -> ConfigureResult:
         """Configure Bedrock AgentCore from notebook using an entrypoint file.
 
@@ -66,6 +67,7 @@ class Runtime:
             region: AWS region for deployment
             protocol: agent server protocol, must be either HTTP or MCP
             disable_otel: Whether to disable OpenTelemetry observability (default: False)
+            non_interactive: Skip interactive prompts and use defaults (default: True)
 
         Returns:
             ConfigureResult with configuration details
@@ -120,6 +122,7 @@ class Runtime:
             authorizer_configuration=authorizer_configuration,
             region=region,
             protocol=protocol.upper() if protocol else None,
+            non_interactive=non_interactive,
         )
 
         self._config_path = result.config_path

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/src/bedrock_agentcore_starter_toolkit/operations/gateway/client.py

@@ -415,6 +415,10 @@ class GatewayClient:
     def create_oauth_authorizer_with_cognito(self, gateway_name: str) -> Dict[str, Any]:
         """Creates Cognito OAuth authorization server.
 
+        Note: This implementation uses AdminCreateUserOnly mode where only administrators
+        can create user accounts. If modifying this implementation for public clients,
+        review AWS Cognito security best practices regarding user sign-up policies.
+
         :param gateway_name: the name of the gateway being created for use in naming Cognito resources.
         :return: dictionary with details of the authorization server, client id, and client secret.
         """
@@ -425,7 +429,12 @@ class GatewayClient:
         try:
             # 1. Create User Pool
             pool_name = f"agentcore-gateway-{GatewayClient.generate_random_id()}"
-            user_pool_response = cognito_client.create_user_pool(PoolName=pool_name)
+            user_pool_response = cognito_client.create_user_pool(
+                PoolName=pool_name,
+                AdminCreateUserConfig={
+                    "AllowAdminCreateUserOnly": True  # Disables self-registration
+                },
+            )
             user_pool_id = user_pool_response["UserPool"]["Id"]
             self.logger.info("  ✓ Created User Pool: %s", user_pool_id)
 

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/src/bedrock_agentcore_starter_toolkit/operations/gateway/create_lambda.py

@@ -58,7 +58,7 @@ def create_test_lambda(session: Session, logger: logging.Logger, gateway_role_ar
     try:
         response = lambda_client.create_function(
             FunctionName=function_name,
-            Runtime="python3.9",
+            Runtime="python3.13",
             Role=role_arn,
             Handler="lambda_function.lambda_handler",
             Code={"ZipFile": zip_buffer.read()},

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/src/bedrock_agentcore_starter_toolkit/operations/memory/README.md

@@ -40,7 +40,7 @@ The `MemoryManager` class provides a comprehensive interface for managing AWS Be
 ```python
 from bedrock_agentcore_starter_toolkit.operations.memory.manager import MemoryManager
 from bedrock_agentcore_starter_toolkit.operations.memory.models import (
-    SemanticStrategy, SummaryStrategy, UserPreferenceStrategy, 
+    SemanticStrategy, SummaryStrategy, UserPreferenceStrategy,
     CustomSemanticStrategy, ExtractionConfig, ConsolidationConfig
 )
 
@@ -625,7 +625,7 @@ dev_config = BotocoreConfig(
 )
 
 dev_manager = MemoryManager(
-    region_name="us-east-1", 
+    region_name="us-east-1",
     boto_client_config=dev_config
 )
 
@@ -691,7 +691,7 @@ try:
 except ClientError as e:
     error_code = e.response['Error']['Code']
     error_message = e.response['Error']['Message']
-    
+
     if error_code == 'ValidationException':
         print(f"Invalid parameters: {error_message}")
     elif error_code == 'ResourceNotFoundException':
@@ -700,13 +700,13 @@ except ClientError as e:
         print(f"Access denied: {error_message}")
     else:
         print(f"AWS error ({error_code}): {error_message}")
-        
+
 except TimeoutError as e:
     print(f"Operation timed out: {e}")
-    
+
 except RuntimeError as e:
     print(f"Memory operation failed: {e}")
-    
+
 except Exception as e:
     print(f"Unexpected error: {e}")
 ```
@@ -722,9 +722,9 @@ def safe_add_strategy(manager, memory_id, strategy):
         if status != "ACTIVE":
             print(f"Memory is {status}, waiting for ACTIVE state...")
             # Could implement custom waiting logic here
-            
+
         return manager.add_strategy_and_wait(memory_id, strategy)
-        
+
     except ClientError as e:
         if e.response['Error']['Code'] == 'ConflictException':
             print("Memory is being modified, retrying...")
@@ -745,7 +745,7 @@ def validate_and_add_strategy(manager, memory_id, strategy):
         except ValidationError as e:
             print(f"Strategy validation failed: {e}")
             return None
-    
+
     return manager.add_strategy_and_wait(memory_id, strategy)
 ```
 
@@ -1011,16 +1011,16 @@ def debug_memory_state(manager, memory_id):
     try:
         memory = manager.get_memory(memory_id)
         print(f"Memory Status: {memory.status}")
-        
+
         strategies = manager.get_memory_strategies(memory_id)
         print(f"Number of strategies: {len(strategies)}")
-        
+
         for strategy in strategies:
             print(f"  Strategy: {strategy.name}")
             print(f"    ID: {strategy.strategyId}")
             print(f"    Type: {strategy.get('type', 'N/A')}")
             print(f"    Status: {strategy.get('status', 'N/A')}")
-            
+
     except Exception as e:
         print(f"Error debugging memory {memory_id}: {e}")
 

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/tests/operations/gateway/test_gateway_client_init.py

@@ -694,7 +694,9 @@ class TestCreateOAuthAuthorizerWithCognito:
                 result = self.client.create_oauth_authorizer_with_cognito(gateway_name)
 
                 # Verify user pool creation
-                self.mock_cognito_client.create_user_pool.assert_called_once_with(PoolName="agentcore-gateway-12345678")
+                self.mock_cognito_client.create_user_pool.assert_called_once_with(
+                    PoolName="agentcore-gateway-12345678", AdminCreateUserConfig={"AllowAdminCreateUserOnly": True}
+                )
 
                 # Verify domain creation
                 self.mock_cognito_client.create_user_pool_domain.assert_called_once_with(

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/tests/operations/memory/test_strategy_validator.py

@@ -1066,6 +1066,7 @@ class TestStrategyComparator:
 
         assert matches is False  # Should fail when both namespaces are non-empty but different
         assert "namespaces: mismatch" in error
+
     def test_compare_strategies_namespaces_skip_validation(self):
         """Test comparing strategies with namespaces - should skip validation when one is empty."""
         existing = [

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/tests_integ/memory/memory-manager.ipynb

@@ -13,8 +13,13 @@
    "source": [
     "from bedrock_agentcore_starter_toolkit.operations.memory.manager import Memory, MemoryManager\n",
     "from bedrock_agentcore_starter_toolkit.operations.memory.models.strategies import (\n",
-    "    SemanticStrategy, SummaryStrategy, CustomSemanticStrategy, CustomSummaryStrategy, CustomUserPreferenceStrategy,\n",
-    "    ExtractionConfig, ConsolidationConfig\n",
+    "    ConsolidationConfig,\n",
+    "    CustomSemanticStrategy,\n",
+    "    CustomSummaryStrategy,\n",
+    "    CustomUserPreferenceStrategy,\n",
+    "    ExtractionConfig,\n",
+    "    SemanticStrategy,\n",
+    "    SummaryStrategy,\n",
     ")"
    ]
   },
@@ -78,11 +83,11 @@
     "    try:\n",
     "        manager.delete_memory(memory_id=memory.id)\n",
     "        pass\n",
-    "    except Exception as e:\n",
+    "    except Exception:\n",
     "        pass\n",
     "    try:\n",
     "        status = manager.get_memory(memory_id=memory.id).status\n",
-    "    except Exception as e:\n",
+    "    except Exception:\n",
     "        status = \"DELETED\"\n",
     "    print(f\"🔍 DEBUG: Memory status {status}\")"
    ]
@@ -123,9 +128,9 @@
     "    strategies=[\n",
     "        SemanticStrategy(\n",
     "            name=\"SemanticStrategy\",\n",
-    "            namespaces=['/strategies/{memoryStrategyId}/actors/{actorId}'],\n",
+    "            namespaces=[\"/strategies/{memoryStrategyId}/actors/{actorId}\"],\n",
     "        )\n",
-    "    ]\n",
+    "    ],\n",
     ")"
    ]
   },
@@ -219,12 +224,10 @@
     "            name=\"SemanticStrategy\",\n",
     "            description=\"A strategy for semantic understanding.\",\n",
     "            extraction_config=ExtractionConfig(\n",
-    "                append_to_prompt=\"Extract insights\",\n",
-    "                model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
+    "                append_to_prompt=\"Extract insights\", model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
     "            ),\n",
     "            consolidation_config=ConsolidationConfig(\n",
-    "                append_to_prompt=\"Consolidate semantic insights\",\n",
-    "                model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
+    "                append_to_prompt=\"Consolidate semantic insights\", model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
     "            ),\n",
     "            namespaces=[\"support/user/{actorId}/{sessionId}\"],\n",
     "        ),\n",
@@ -232,8 +235,7 @@
     "            name=\"SummaryStrategy\",\n",
     "            description=\"A strategy for summarizing the conversation.\",\n",
     "            consolidation_config=ConsolidationConfig(\n",
-    "                append_to_prompt=\"Summarize conversation highlights\",\n",
-    "                model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
+    "                append_to_prompt=\"Summarize conversation highlights\", model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
     "            ),\n",
     "            namespaces=[\"support/user/{actorId}/{sessionId}\"],\n",
     "        ),\n",
@@ -241,15 +243,13 @@
     "            name=\"UserPreferenceStrategy\",\n",
     "            description=\"A strategy for user preference.\",\n",
     "            extraction_config=ExtractionConfig(\n",
-    "                append_to_prompt=\"Extract insights\",\n",
-    "                model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
+    "                append_to_prompt=\"Extract insights\", model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
     "            ),\n",
     "            consolidation_config=ConsolidationConfig(\n",
-    "                append_to_prompt=\"Consolidate user preferences\",\n",
-    "                model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
+    "                append_to_prompt=\"Consolidate user preferences\", model_id=\"anthropic.claude-3-sonnet-20240229-v1:0\"\n",
     "            ),\n",
-    "            namespaces=['/strategies/{memoryStrategyId}/actors/{actorId}']\n",
-    "        )\n",
+    "            namespaces=[\"/strategies/{memoryStrategyId}/actors/{actorId}\"],\n",
+    "        ),\n",
     "    ],\n",
     ")\n",
     "print(\"🔍 DEBUG: long-term memory created successfully\")\n",
@@ -361,7 +361,7 @@
     "        UserPreferenceStrategy(\n",
     "            name=\"UserPreferenceStrategy\",\n",
     "            description=\"A strategy for user preference.\",\n",
-    "            namespaces=['/strategies/{memoryStrategyId}/actors/{actorId}']\n",
+    "            namespaces=[\"/strategies/{memoryStrategyId}/actors/{actorId}\"],\n",
     "        )\n",
     "    ],\n",
     ")\n",

{bedrock_agentcore_starter_toolkit-0.1.17 → bedrock_agentcore_starter_toolkit-0.1.19}/uv.lock

@@ -113,7 +113,7 @@ wheels = [
 
 [[package]]
 name = "bedrock-agentcore-starter-toolkit"
-version = "0.1.17"
+version = "0.1.19"
 source = { editable = "." }
 dependencies = [
     { name = "autopep8" },