feat(market-trends-agent): add demo UI, LangGraph checkpointer/store, multi-region support

- Add AgentCoreMemorySaver (checkpointer) and AgentCoreMemoryStore for dual-layer memory
- Add React chat UI with pre-built broker profiles and markdown rendering
- Add FastAPI backend proxy bridging UI to deployed AgentCore agent
- Add run_demo_ui.py launcher for single-command startup
- Replace hardcoded us-east-1 with os.getenv for multi-region deployability
- Add IAM permissions for checkpointer and memory record operations
- Fix extract_actor_id regex and add new intro patterns
- Remove personal AWS_PROFILE reference from error message
- Sync requirements.txt with pyproject.toml (fastapi, uvicorn, langgraph-checkpoint-aws)
- Update README with UI setup, architecture diagram, and troubleshooting

Author: deepaxs

02-use-cases/market-trends-agent/.gitignore

@@ -3,6 +3,16 @@
 .memory_id
 .bedrock_agentcore.yaml
 
+# Browser screenshots captured during demo runs
+browser_screenshots/
+
+# Test results (generated by test_auto.py)
+test_results.md
+test_auto.py
+
+# PR description drafts (local only)
+PR_DESCRIPTION*.md
+
 # Python
 __pycache__/
 *.py[cod]
@@ -43,6 +53,9 @@ venv.bak/
 *.swp
 *.swo
 
+# Node
+node_modules/
+
 # OS
 .DS_Store
 Thumbs.db

02-use-cases/market-trends-agent/README.md

@@ -0,0 +1,103 @@
+"""
+FastAPI backend for Market Trends Agent React UI.
+Proxies chat requests to the deployed AgentCore Runtime agent.
+"""
+
+import json
+import os
+import logging
+from pathlib import Path
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from pydantic import BaseModel, Field
+import boto3
+from botocore.config import Config
+
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger(__name__)
+
+app = FastAPI(title="Market Trends Agent API")
+
+# Allow React dev server to connect
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["http://localhost:3000"],
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+# AWS region for AgentCore Runtime
+REGION = os.getenv("AWS_REGION", "us-east-1")
+
+# Boto3 client with extended timeout for agent responses (browser + LLM calls can be slow)
+boto_config = Config(read_timeout=300, retries={"max_attempts": 2})
+agentcore_client = boto3.client("bedrock-agentcore", region_name=REGION, config=boto_config)
+
+
+def load_agent_arn() -> str | None:
+    """Load deployed agent ARN from the .agent_arn file created by deploy.py"""
+    arn_file = Path(__file__).parent / ".agent_arn"
+    if arn_file.exists():
+        return arn_file.read_text().strip()
+    return None
+
+
+class ChatRequest(BaseModel):
+    message: str = Field(..., max_length=4000)
+    session_id: str = Field(default="", max_length=100)
+
+
+@app.get("/api/health")
+def health():
+    """Health check — also reports whether the agent is deployed"""
+    arn = load_agent_arn()
+    return {"status": "ok", "agent_deployed": arn is not None, "region": REGION}
+
+
+@app.post("/api/chat")
+def chat(req: ChatRequest):
+    """Send a message to the deployed AgentCore agent and return the response"""
+    arn = load_agent_arn()
+    if not arn:
+        return {"error": "Agent not deployed. Run 'uv run python deploy.py' first."}
+
+    try:
+        # Build invocation payload matching the agent's expected format
+        payload = json.dumps({"prompt": req.message, "session_id": req.session_id}).encode("utf-8")
+        params: dict = {"agentRuntimeArn": arn, "payload": payload}
+
+        # Pass session ID for memory continuity across messages
+        if req.session_id:
+            params["runtimeSessionId"] = req.session_id
+
+        logger.info(f"Invoking agent | session={req.session_id[:24]}...")
+        response = agentcore_client.invoke_agent_runtime(**params)
+
+        # Read the response body (handles both streaming and standard responses)
+        if "response" in response:
+            body = response["response"].read().decode("utf-8")
+        else:
+            body = str(response)
+
+        # AgentCore often returns a JSON-encoded string (e.g. "\"hello\\nworld\"")
+        # Unwrap it so the frontend receives clean text with real newlines
+        try:
+            parsed = json.loads(body)
+            if isinstance(parsed, str):
+                body = parsed
+        except (json.JSONDecodeError, TypeError):
+            pass
+
+        # Final safety: replace any remaining literal \n sequences with real newlines
+        body = body.replace("\\n", "\n")
+
+        return {"response": body, "session_id": req.session_id}
+
+    except Exception as e:
+        logger.error(f"Agent invocation error: {e}")
+        return {"error": "Agent request failed. Check server logs for details."}
+
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8001)

02-use-cases/market-trends-agent/api_server.py

@@ -138,6 +138,12 @@ def create_execution_role(self, role_name: str) -> str:
                         "bedrock-agentcore:DeleteMemory",
                         "bedrock-agentcore:GetMemory",
                         "bedrock-agentcore:RetrieveMemoryRecords",
+                        "bedrock-agentcore:CreateMemoryRecord",
+                        "bedrock-agentcore:DeleteMemoryRecord",
+                        "bedrock-agentcore:UpdateMemoryRecord",
+                        "bedrock-agentcore:GetCheckpoint",
+                        "bedrock-agentcore:PutCheckpoint",
+                        "bedrock-agentcore:ListCheckpoints",
                     ],
                     "Resource": [
                         f"arn:aws:bedrock-agentcore:{self.region}:{account_id}:memory/*"
@@ -156,7 +162,7 @@ def create_execution_role(self, role_name: str) -> str:
                     ],
                     "Resource": [
                         f"arn:aws:bedrock-agentcore:{self.region}:{account_id}:browser-custom/*",
-                        "arn:aws:bedrock-agentcore:*:aws:browser/*"
+                        f"arn:aws:bedrock-agentcore:*:aws:browser/*"
                     ],
                 },
                 {

02-use-cases/market-trends-agent/deploy.py

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>Market Trends Agent — AgentCore Demo</title>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="/src/main.jsx"></script>
+</body>
+</html>