# agent-claw Project Context

This is a Telegram bot running on AWS AgentCore (Bedrock) with Google Workspace integration.

## Architecture
- AgentCore runtime: Python 3.14, Strands SDK, Claude Sonnet 4.6
- workspace_mcp Lambda: Mangum/FastMCP + workspace-mcp package, AWS_IAM Function URL auth + SigV4
- tg-ingest Lambda: Telegram webhook ingest → SQS
- agent-runner Lambda: SQS consumer → invokes AgentCore

## Key Directories
- agentclaw/app/agent_claw_main/ — AgentCore runtime code (Python)
- cdk/lib/agent-claw-stack.ts — AWS infrastructure (CDK TypeScript)
- src/lambdas/agent-runner/ — SQS → AgentCore bridge
- src/lambdas/tg-ingest/ — Telegram webhook ingest
- src/lambdas/workspace-mcp/ — Google Workspace MCP server
- src/lambdas/oauth-handler/ — Google OAuth callback

## Deploy
- CDK: cd cdk && AWS_PROFILE=ai1 npx cdk deploy --require-approval never [context params]
- AgentCore: cd agentclaw && AWS_PROFILE=ai1 agentcore deploy --yes
- Both required for any change

## Rules
- Do NOT restart com.openclaw.vikunja-proxy
- Do NOT use mcporter
- Always run both deploy steps after code changes