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

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

@@ -1,13 +1,20 @@
 # Changelog
 
+## [0.1.17] - 2025-10-01
+
+### Changes
+
+- chore: sync main with PyPI version 0.1.16 (#242) (c414fe5)
+- fix: initialize ConfigurationManager with non_interactive flag (#240) (3b92653)
+- Add cleanup section and fix documentation links (#239) (cba1169)
+
 ## [0.1.16] - 2025-10-01
 
 ### Changes
 
-- fix: don't fail validation for empty namespaces for during get_or_create when strategy defaults server side (#235) (3557359)
-- chore: make doc titles more meaningful (#229) (9c860d7)
-- Update memory quickstart (#234) (98a192b)
-- chore: bump version to 0.1.15 (#233) (0561bb5)
+- Update memory quickstart by @mikewrighton in #234
+- chore: make doc titles more meaningful by @theumbrella1 in #229
+- fix: don't fail validation for empty namespaces by @jona62 in #235
 
 ## [0.1.15] - 2025-10-01
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bedrock-agentcore-starter-toolkit
-Version: 0.1.16
+Version: 0.1.17
 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.16 → bedrock_agentcore_starter_toolkit-0.1.17}/documentation/docs/examples/semantic_search.md

@@ -33,49 +33,41 @@ session_manager = MemorySessionManager(
     memory_id=memory.get("id"),
     region_name="us-west-2")
 
-# Write memory events (conversation turns)
-session_manager.add_turns(
+session = session_manager.create_memory_session(
     actor_id="User1",
-    session_id="OrderSupportSession1",
+    session_id="OrderSupportSession1"
+)
+
+# Write memory events (conversation turns)
+session.add_turns(
     messages=[
         ConversationalMessage(
             "Hi, how can I help you today?",
             MessageRole.ASSISTANT)],
 )
 
-session_manager.add_turns(
-    actor_id="User1",
-    session_id="OrderSupportSession1",
+session.add_turns(
     messages=[
         ConversationalMessage(
             "Hi, I am a new customer. I just made an order, but it hasn't arrived. The Order number is #35476",
             MessageRole.USER)],
 )
 
-session_manager.add_turns(
-    actor_id="User1",
-    session_id="OrderSupportSession1",
+session.add_turns(
     messages=[
         ConversationalMessage(
             "I'm sorry to hear that. Let me look up your order.",
             MessageRole.ASSISTANT)],
 )
 
-# List all events in the session
-events = session_manager.list_events(
-    actor_id="User1",
-    session_id="OrderSupportSession1",
-)
-
-for event in events:
-    print(f"Event: {event}")
-    print("--------------------------------------------------------------------")
+# Get the last k turns in the session
+turns = session.get_last_k_turns(k=5)
 
-print("Waiting 2 minutes for semantic processing...")
-time.sleep(120)
+for turn in turns:
+    print(f"Turn: {turn}")
 
 # List all memory records
-memory_records = session_manager.list_long_term_memory_records(
+memory_records = session.list_long_term_memory_records(
     namespace_prefix="/"
 )
 
@@ -84,7 +76,7 @@ for record in memory_records:
     print("--------------------------------------------------------------------")
 
 # Perform a semantic search
-memory_records = session_manager.search_long_term_memories(
+memory_records = session.search_long_term_memories(
     query="can you summarize the support issue",
     namespace_prefix="/",
     top_k=3
@@ -94,4 +86,9 @@ for record in memory_records:
     print(f"retrieved memory: {record}")
     print("--------------------------------------------------------------------")
 
+
+# Cleanup - delete the memory resource
+print("Cleaning up...")
+
+memory_manager.delete_memory(memory_id=memory.get("id"))
 ```

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

@@ -28,20 +28,24 @@ pip install bedrock-agentcore-starter-toolkit
 ```
 
 
-**Note: The AgentCore Starter Toolkit is intended to help developers get started quickly. The Boto3 Python library provides the most comprehensive set of operations for AgentCore Memory. You can find the Boto3 documentation here.**
+**Note:** The AgentCore Starter Toolkit is intended to help developers get started quickly. For the complete set of AgentCore Memory operations, see the Boto3 documentation: [bedrock-agentcore-control](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agentcore-control.html) and [bedrock-agentcore](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/bedrock-agentcore.html).
 
 
+
+**Full example:** See the [complete code example](../../examples/semantic_search.md) that demonstrates steps 1-3.
+
 ## Step One: Create a Memory Resource
 
 A memory resource is needed to start storing information for your agent. By default, memory events (which we refer to as short-term memory) can be written to a memory resource. In order for insights to be extracted and placed into long term memory records, the resource requires a 'memory strategy' - a configuration that defines how conversational data should be processed, and what information to extract (such as facts, preferences, or summaries).
 
-We are going to create a memory resource with a semantic strategy so that both short term and long term memory can be utilized. This will take 1-2 minutes. Memory resources can also be created in the AWS console.
+We are going to create a memory resource with a semantic strategy so that both short term and long term memory can be utilized. This will take 2-3 minutes. Memory resources can also be created in the AWS console.
 
 ```python
 from bedrock_agentcore_starter_toolkit.operations.memory.manager import MemoryManager
 from bedrock_agentcore.memory.session import MemorySessionManager
-from bedrock_agentcore_starter_toolkit.operations.memory.models.strategies import (
-    SemanticStrategy)
+from bedrock_agentcore.memory.constants import ConversationalMessage, MessageRole
+from bedrock_agentcore_starter_toolkit.operations.memory.models.strategies import SemanticStrategy
+import time
 
 memory_manager = MemoryManager(region_name="us-west-2")
 
@@ -49,10 +53,11 @@ print("Creating memory resource...")
 
 memory = memory_manager.get_or_create_memory(
     name="CustomerSupportSemantic",
-    description="Customer suppoer memory store",
+    description="Customer support memory store",
     strategies=[
         SemanticStrategy(
             name="semanticLongTermMemory",
+            namespaces=['/strategies/{memoryStrategyId}/actors/{actorId}'],
         )
     ]
 )
@@ -83,28 +88,27 @@ session_manager = MemorySessionManager(
     memory_id=memory.get("id"),
     region_name="us-west-2")
 
-# Write memory events (conversation turns)
-session_manager.add_turns(
+session = session_manager.create_memory_session(
     actor_id="User1",
-    session_id="OrderSupportSession1",
+    session_id="OrderSupportSession1"
+)
+
+# Write memory events (conversation turns)
+session.add_turns(
     messages=[
         ConversationalMessage(
             "Hi, how can I help you today?",
             MessageRole.ASSISTANT)],
 )
 
-session_manager.add_turns(
-    actor_id="User1",
-    session_id="OrderSupportSession1",
+session.add_turns(
     messages=[
         ConversationalMessage(
             "Hi, I am a new customer. I just made an order, but it hasn't arrived. The Order number is #35476",
             MessageRole.USER)],
 )
 
-session_manager.add_turns(
-    actor_id="User1",
-    session_id="OrderSupportSession1",
+session.add_turns(
     messages=[
         ConversationalMessage(
             "I'm sorry to hear that. Let me look up your order.",
@@ -113,15 +117,15 @@ session_manager.add_turns(
 ```
 
 
-You can get events for a specific actor after they’ve been written.
+You can get events (turns) for a specific actor after they’ve been written.
 
 
 ```python
-# List all events in the session
-events = session_manager.list_events(
-    actor_id="User1",
-    session_id="OrderSupportSession1"
-)
+# Get the last k turns in the session
+turns = session.get_last_k_turns(k=5)
+
+for turn in turns:
+    print(f"Turn: {turn}")
 ```
 
 
@@ -135,16 +139,20 @@ You can list all memory records with:
 
 ```python
 # List all memory records
-session_manager.list_long_term_memory_records(
+memory_records = session.list_long_term_memory_records(
     namespace_prefix="/"
 )
+
+for record in memory_records:
+    print(f"Memory record: {record}")
+    print("--------------------------------------------------------------------")
 ```
 
 Or ask for the most relevant information as part of a semantic search:
 
 ```python
 # Perform a semantic search
-memory_records = session_manager.search_long_term_memories(
+memory_records = session.search_long_term_memories(
     query="can you summarize the support issue",
     namespace_prefix="/",
     top_k=3
@@ -154,7 +162,14 @@ memory_records = session_manager.search_long_term_memories(
 
 Important information about the user is likely stored is long term memory. Agents can use long term memory rather than a full conversation history to make sure that LLMs are not overloaded with context.
 
-The full example source file showing steps 1 - 3 is available [here](../../examples/semantic_search.md).
+## Cleanup
+
+When you're done with the memory resource, you can delete it:
+
+```python
+# Delete the memory resource
+memory_manager.delete_memory(memory_id=memory.get("id"))
+```
 
 ## What’s Next?
 

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

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

{bedrock_agentcore_starter_toolkit-0.1.16 → bedrock_agentcore_starter_toolkit-0.1.17}/src/bedrock_agentcore_starter_toolkit/operations/runtime/configure.py

@@ -119,7 +119,7 @@ def configure_bedrock_agentcore(
     if verbose:
         log.debug("Prompting for memory configuration")
 
-    config_manager = ConfigurationManager(build_dir / ".bedrock_agentcore.yaml")
+    config_manager = ConfigurationManager(build_dir / ".bedrock_agentcore.yaml", non_interactive)
 
     # New memory selection flow
     action, value = config_manager.prompt_memory_selection()

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

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