Restructure use cases (#1653)

* restructure 02-use-cases into three agent-type categories

Reorganizes all 27 use case samples into category subfolders aligned
with the AgentCore GTM workload definitions:

- 01-conversational-agents/ (19 samples): user-facing agents with
  streaming, user OAuth, and session/long-term memory
- 02-automation-agents/ (4 samples): event-driven agents with service
  identity and stateless execution
- 03-coding-assistants/ (3 samples): developer tools with sandboxed
  execution and project-scoped memory

Other changes:
- Moves okta-auth-three-tier-end-to-end-demo to
  01-features/05-authenticate-and-authorize (identity pattern, not a
  use case)
- Adds 02-use-cases/README.md with category index and sample table
- Adds category README for each subfolder, aligned with GTM definitions,
  no em-dashes
- Adds use-case-assessment.md with per-sample scoring, recommendations,
  and a starter toolkit migration list (18 of 27 samples need migrating)
- Fixes all cross-folder relative links broken by the restructure
  (LICENSE, LOCAL_DEVELOPMENT.md, AGENTCORE_DEPLOYMENT.md)

* cull low-quality conversational agent samples and reorganise identity demos

Reviewed all 19 conversational agent samples against actual AgentCore
feature usage, blog post references, and code quality. Removed 9 samples
that did not meet the bar and moved 2 identity-pattern demos to the
correct location.

Dropped from 01-conversational-agents/:
- gateway-schema-support-agent: misclassified coding agent, 82-line README,
  only 1 real feature, no blog post
- slide-deck-generator-memory-agent: narrow use case, no blog post,
  deprecated starter toolkit, 5 features
- local-prototype-to-agentcore: claimed 9 features, only 3 in code,
  tutorial format belongs in 01-tutorials/
- role-based-hr-data-agent: no blog post, deprecated starter toolkit,
  Cedar pattern needs full rebuild to be useful
- A2A-realestate-agentcore-multiagents: claimed 10 features, only 3 in
  code (Runtime, Cognito, A2A), no blog post
- cost-optimization-agent: only Runtime in code, notebook-driven, no
  blog post
- DB-performance-analyzer: only Gateway + Cognito in code, no blog post
- farm-management-advisor: notebook-only, mixed deprecated/native SDK,
  191-line README, no blog post

Moved to 01-features/05-authenticate-and-authorize/:
- auth0-multi-agent-obo: RFC 8693 OBO token exchange is an identity
  pattern, not a use case; sits alongside okta and entra OBO samples
- okta-auth-three-tier-end-to-end-demo: (previous commit)

Other changes:
- Rename 02-automation-agents/ to 02-workflow-automation-agents/
- Update use-case-assessment.md with DROPPED/MOVED entries for all
  removed samples
- Update all README counts and sample tables
- Add auth0-multi-agent-obo to identity README folder table and
  auth pattern quick reference

* update use-case-assessment with decisions, actual features, and authors contacted

* untrack use-case-assessment.md (local only)

* fix CONTRIBUTING.md relative paths broken by use-cases restructure

Samples moved one level deeper (into category subfolders) so
../../CONTRIBUTING.md no longer resolves to the repo root.
Updated to ../../../CONTRIBUTING.md in three files:
- 01-conversational-agents/customer-support-assistant/README.md
- 02-workflow-automation-agents/event-driven-claims-agent/README.md
- 03-coding-assistants/claude-code-gateway-mcp-server/README.md

* fix: address checkov security findings in CloudFormation templates

AWS-operations-agent mcp-tool-template.yaml and mcp-tool-template-zip.yaml:
- Scope IAM wildcard resources to account/region-specific ARNs
  (lambda:InvokeFunction, iam:PassRole, s3:*, logs:*)
- Split S3 permissions into bucket-level and object-level statements
- Scope bedrock:InvokeModel to foundation-model ARN pattern
- Add KMS keys for Lambda env var encryption (CKV_AWS_173) and CloudWatch
  log group encryption (CKV_AWS_158)
- Add SQS dead letter queue and DeadLetterQueue config (CKV_AWS_116)
- Add ReservedConcurrentExecutions (CKV_AWS_115)
- Add checkov:skip for VPC (CKV_AWS_117) - demo function, VPC not required

customer-support-assistant cognito.yaml:
- Scope logs resource to account/region ARN prefix
- Scope cognito-idp:AdminAddUserToGroup to UserPool ARN
- Add SQS DLQ and DeadLetterConfig to PostSignupFunction (CKV_AWS_116)
- Add ReservedConcurrentExecutions (CKV_AWS_115)
- Add checkov:skip for VPC (CKV_AWS_117) - Cognito trigger, VPC not needed

customer-support-assistant infrastructure.yaml:
- Add KMS CMK and SSESpecification to WarrantyTable and CustomerProfileTable
  (CKV_AWS_119)
- Scope logs resource to account/region ARN prefix
- Add SQS DLQ and DeadLetterConfig to PopulateDataFunction (CKV_AWS_116)
- Add ReservedConcurrentExecutions (CKV_AWS_115)
- Add checkov:skip for VPC (CKV_AWS_117) - CFn custom resource, VPC not needed

* style: apply ruff formatting across all Python files

* remove customer-support-assistant; keep vpc variant only

* fix: resolve ruff lint errors to pass CI python-lint check

- Auto-fix F541 (f-strings without placeholders) and E401 (multiple imports)
- Extend root pyproject.toml ignore list with E722, F401, F811, F841
  (pre-existing patterns acceptable in a samples/tutorial repository)
- Add E722 to SRE-agent pyproject.toml ignore list (bare-except in server code)

* clean up readmes

* fix: resolve CodeQL security findings

lakehouse-agent (Python):
- Add codeql suppression comments on intentional clear-text logging of
  setup/debug info in deployment scripts (clear-text-logging-sensitive-data)
- Add codeql suppression on .env file write in deprecated write_to_env
  method (clear-text-storage-of-sensitive-data)
- Add codeql suppression on HMAC-SHA256 usage in streamlit_app.py;
  this is Cognito SECRET_HASH computation, not password hashing
  (weak-sensitive-data-hashing)

visa-b2b-account-payable-agent (TypeScript/JavaScript):
- Add express-rate-limit middleware to all /api/ routes in index.ts
  and lambda.ts (missing-rate-limiting)
- Fix CORS origin in lambda.ts to default to localhost instead of
  wildcard '*' (permissive-cors)
- Replace Math.random() with crypto.randomBytes() in visa-stubs
  for cryptographically secure card number generation (insecure-randomness)

workshops (Python):
- Add codeql suppression on user_pool_id logging in cognito_setup.py
  cleanup function (clear-text-logging-sensitive-data)

* fix: eliminate ReDoS in text-to-python-ide regex against user input

Replace lazy .+? quantifiers with negated character classes [^"\']{0,500}
in the input() call extractor pattern. The original pattern could
catastrophically backtrack on adversarial strings submitted as user code.
Negated classes cannot backtrack across the excluded characters, making
the match linear regardless of input content.

* style: ruff format long codeql suppression comment lines

Lines with inline codeql suppression comments exceeded the 120-char
limit; ruff reformats them by wrapping the expression and moving the
comment to the closing parenthesis line.

Author: BharathiSrini

.gitignore

@@ -302,4 +302,5 @@ plan/
 
 # Browser test report cards
 01-features/03-connect-your-agent-to-anything/02-browser/TEST_REPORT_CARD.md
+02-use-cases/use-case-assessment.md
 **/lambda_config.json

01-features/01-harness/01-advanced-examples/01-custom-containers/custom_container.py

@@ -86,19 +86,11 @@
     default="node",
     help="Language preset (default: node)",
 )
-parser.add_argument(
-    "--container", default=None, metavar="URI", help="Override container image URI"
-)
+parser.add_argument("--container", default=None, metavar="URI", help="Override container image URI")
 parser.add_argument("--message", "-m", default=None, help="Override prompt to agent")
-parser.add_argument(
-    "--model", default="global.anthropic.claude-haiku-4-5-20251001-v1:0"
-)
-parser.add_argument(
-    "--role-arn", default=None, metavar="ARN", help="Use existing IAM role ARN"
-)
-parser.add_argument(
-    "--skip-cleanup", action="store_true", help="Keep resources after the demo"
-)
+parser.add_argument("--model", default="global.anthropic.claude-haiku-4-5-20251001-v1:0")
+parser.add_argument("--role-arn", default=None, metavar="ARN", help="Use existing IAM role ARN")
+parser.add_argument("--skip-cleanup", action="store_true", help="Keep resources after the demo")
 args = parser.parse_args()
 
 # ── Resolve preset ─────────────────────────────────────────────────────────────
@@ -196,9 +188,7 @@ def run_command(harness_arn, session_id, command):
     print(f"\n=== Step 2: Attach Custom Container ({container_uri}) ===")
     control.update_harness(
         harnessId=harness_id,
-        environmentArtifact={
-            "optionalValue": {"containerConfiguration": {"containerUri": container_uri}}
-        },
+        environmentArtifact={"optionalValue": {"containerConfiguration": {"containerUri": container_uri}}},
         systemPrompt=[{"text": system_prompt}],
     )
     print("Waiting for container update...")

01-features/01-harness/01-advanced-examples/02-gateway-integration/gateway_integration.py

@@ -80,9 +80,7 @@
 # ── Helpers ───────────────────────────────────────────────────────────────────
 
 
-def poll_gateway_status(
-    control, gateway_id, target_status="READY", timeout=GATEWAY_POLL_TIMEOUT
-):
+def poll_gateway_status(control, gateway_id, target_status="READY", timeout=GATEWAY_POLL_TIMEOUT):
     deadline = time.monotonic() + timeout
     while True:
         resp = control.get_gateway(gatewayIdentifier=gateway_id)
@@ -97,14 +95,10 @@ def poll_gateway_status(
         time.sleep(GATEWAY_POLL_INTERVAL)
 
 
-def poll_target_status(
-    control, gateway_id, target_id, target_status="READY", timeout=GATEWAY_POLL_TIMEOUT
-):
+def poll_target_status(control, gateway_id, target_id, target_status="READY", timeout=GATEWAY_POLL_TIMEOUT):
     deadline = time.monotonic() + timeout
     while True:
-        resp = control.get_gateway_target(
-            gatewayIdentifier=gateway_id, targetId=target_id
-        )
+        resp = control.get_gateway_target(gatewayIdentifier=gateway_id, targetId=target_id)
         status = resp["status"]
         print(f"  Target status: {status}")
         if status == target_status:
@@ -116,9 +110,7 @@ def poll_target_status(
         time.sleep(GATEWAY_POLL_INTERVAL)
 
 
-def poll_harness_status(
-    control, harness_id, target_status="READY", timeout=HARNESS_POLL_TIMEOUT
-):
+def poll_harness_status(control, harness_id, target_status="READY", timeout=HARNESS_POLL_TIMEOUT):
     deadline = time.monotonic() + timeout
     while True:
         resp = control.get_harness(harnessId=harness_id)
@@ -133,9 +125,7 @@ def poll_harness_status(
         time.sleep(GATEWAY_POLL_INTERVAL)
 
 
-def stream_response(
-    client, harness_arn, session_id, message, model_id, gateway_arn, raw=False
-):
+def stream_response(client, harness_arn, session_id, message, model_id, gateway_arn, raw=False):
     response = client.invoke_harness(
         harnessArn=harness_arn,
         runtimeSessionId=session_id,
@@ -158,9 +148,7 @@ def stream_response(
             if "contentBlockStart" in event:
                 start = event["contentBlockStart"].get("start", {})
                 if "toolUse" in start:
-                    print(
-                        f"\n  [Tool: {start['toolUse'].get('name', '?')}]", flush=True
-                    )
+                    print(f"\n  [Tool: {start['toolUse'].get('name', '?')}]", flush=True)
             elif "contentBlockDelta" in event:
                 delta = event["contentBlockDelta"].get("delta", {})
                 if "text" in delta:
@@ -185,9 +173,7 @@ def _cleanup(gw_control, harness_control, gateway_id, target_id, harness_id):
             print(f"  Warning: {e}")
     if gateway_id and target_id:
         try:
-            gw_control.delete_gateway_target(
-                gatewayIdentifier=gateway_id, targetId=target_id
-            )
+            gw_control.delete_gateway_target(gatewayIdentifier=gateway_id, targetId=target_id)
             print(f"  Deleted target: {target_id}")
             time.sleep(10)
         except Exception as e:
@@ -260,9 +246,7 @@ def main(args=None):
         print("Step 3: Create Harness")
         print("=" * 60)
         harness_name = f"GatewayHarness_{uuid.uuid4().hex[:8]}"
-        resp = harness_control.create_harness(
-            harnessName=harness_name, executionRoleArn=role_arn
-        )
+        resp = harness_control.create_harness(harnessName=harness_name, executionRoleArn=role_arn)
         harness_id = resp["harness"]["harnessId"]
         harness_arn = resp["harness"]["arn"]
         print(f"  Harness ID:  {harness_id}")
@@ -276,9 +260,7 @@ def main(args=None):
         session_id = str(uuid.uuid4()).upper()
         print(f"  Session ID: {session_id}")
         print(f"  Model:      {args.model}")
-        print(
-            f"  Message:    {args.message[:80]}{'...' if len(args.message) > 80 else ''}\n"
-        )
+        print(f"  Message:    {args.message[:80]}{'...' if len(args.message) > 80 else ''}\n")
 
         stream_response(
             client,

01-features/01-harness/01-advanced-examples/03-execution-limits/execution_limits.py

@@ -101,9 +101,7 @@ def invoke(prompt: str, **limits) -> str:
             meta = event["metadata"]
             usage = meta.get("usage", {})
             if usage:
-                print(
-                    f"→ usage: input={usage.get('inputTokens', 0)}, output={usage.get('outputTokens', 0)}"
-                )
+                print(f"→ usage: input={usage.get('inputTokens', 0)}, output={usage.get('outputTokens', 0)}")
         elif "internalServerException" in event:
             print(f"\nError: {event['internalServerException']}")
     print()

01-features/01-harness/01-advanced-examples/04-mcp-integration/mcp_integration.py

@@ -190,9 +190,7 @@ def stream_invoke(session_id, prompt, tools, timeout=300):
             {
                 "type": "remote_mcp",
                 "name": "invalid",
-                "config": {
-                    "remoteMcp": {"url": "https://invalid-mcp-url.example.com/mcp"}
-                },
+                "config": {"remoteMcp": {"url": "https://invalid-mcp-url.example.com/mcp"}},
             }
         ],
         timeout=60,

01-features/01-harness/01-advanced-examples/05-agent-skills/agent_skills.py

@@ -76,9 +76,7 @@
 print(f"\n=== Part 1: Attach Node.js Container ({NODE_CONTAINER}) ===")
 control.update_harness(
     harnessId=harness_id,
-    environmentArtifact={
-        "optionalValue": {"containerConfiguration": {"containerUri": NODE_CONTAINER}}
-    },
+    environmentArtifact={"optionalValue": {"containerConfiguration": {"containerUri": NODE_CONTAINER}}},
 )
 print("Waiting for container update...")
 for i in range(12):
@@ -121,9 +119,7 @@
 resp = client.invoke_agent_runtime_command(
     agentRuntimeArn=harness_arn,
     runtimeSessionId=session_id,
-    body={
-        "command": "ls -la .agents/skills/xlsx/ 2>/dev/null && echo 'skill directory OK' || echo 'skill not found'"
-    },
+    body={"command": "ls -la .agents/skills/xlsx/ 2>/dev/null && echo 'skill directory OK' || echo 'skill not found'"},
 )
 for event in resp["stream"]:
     if "chunk" in event and "contentDelta" in event["chunk"]:

01-features/01-harness/01-advanced-examples/07-oauth/oauth_gateway.py

@@ -63,12 +63,8 @@
 )
 
 # ── CLI ────────────────────────────────────────────────────────────────────────
-parser = argparse.ArgumentParser(
-    description="Harness JWT inbound + OAuth outbound demo"
-)
-parser.add_argument(
-    "--skip-cleanup", action="store_true", help="Keep all resources after the demo"
-)
+parser = argparse.ArgumentParser(description="Harness JWT inbound + OAuth outbound demo")
+parser.add_argument("--skip-cleanup", action="store_true", help="Keep all resources after the demo")
 args = parser.parse_args()
 
 # ── Configuration ─────────────────────────────────────────────────────────────
@@ -145,11 +141,7 @@
                 "allowedClients": [pool1["client_id"]],
             }
         },
-        model={
-            "bedrockModelConfig": {
-                "modelId": "us.anthropic.claude-haiku-4-5-20251001-v1:0"
-            }
-        },
+        model={"bedrockModelConfig": {"modelId": "us.anthropic.claude-haiku-4-5-20251001-v1:0"}},
         systemPrompt=[
             {
                 "text": (