Phase 1 cleanup: onboarding flow, per-user S3 MEMORY.md, seed script

src/lambdas/agent-runner/handler.py

@@ -3,6 +3,7 @@ import os
 import time
 import uuid
 import boto3
+import urllib.request
 from typing import Any
 
 # AWS clients
@@ -40,13 +41,33 @@ def get_or_create_user(actor_id: str, from_info: dict) -> dict:
         'display_name': from_info.get('from_name') or actor_id,
         'telegram_username': from_info.get('from_username', ''),
         'created_at': str(now),
-        'allowed': True,
+        'status': 'pending',
     }
     table.put_item(Item=item)
-    print(f'[agent-runner] Registered new user: {actor_id}')
+    print(f'[agent-runner] Registered new user (pending): {actor_id}')
     return item
 
 
+def update_user_status(actor_id: str, name: str, status: str) -> None:
+    table_name = os.environ.get('USERS_TABLE_NAME', '')
+    if not table_name:
+        return
+    table = get_ddb().Table(table_name)
+    table.update_item(
+        Key={'actor_id': actor_id},
+        UpdateExpression='SET display_name = :n, #s = :s',
+        ExpressionAttributeNames={'#s': 'status'},
+        ExpressionAttributeValues={':n': name, ':s': status},
+    )
+
+
+def send_telegram_direct(chat_id: str, token: str, text: str) -> None:
+    url = f'https://api.telegram.org/bot{token}/sendMessage'
+    data = json.dumps({'chat_id': chat_id, 'text': text}).encode()
+    req = urllib.request.Request(url, data=data, headers={'Content-Type': 'application/json'})
+    urllib.request.urlopen(req, timeout=10)
+
+
 def get_or_create_session(actor_id: str) -> str:
     """Look up active session for actor, or create a new one."""
     table = get_ddb().Table(os.environ['SESSION_TABLE_NAME'])
@@ -99,6 +120,25 @@ def handler(event, context):
     from_info = first.get('messages', [{}])[0]
     user_profile = get_or_create_user(actor_id, from_info)
 
+    # ── Onboarding gate ─────────────────────────────────────────────────────
+    table_name = os.environ.get('USERS_TABLE_NAME', '')
+    if table_name and user_profile.get('status', 'active') == 'pending':
+        raw_prompt = records[0]['messages'][0]['text'] if records else ''
+        is_name_msg = bool(raw_prompt and len(raw_prompt.strip()) < 50 and '?' not in raw_prompt)
+        if is_name_msg:
+            name = raw_prompt.strip()
+            update_user_status(actor_id, name=name, status='active')
+            user_profile['display_name'] = name
+            user_profile['status'] = 'active'
+            prompt = f"[System: User just registered with name '{name}'. Welcome them warmly and ask how you can help.]"
+        else:
+            bot_token_secret_arn = os.environ.get('TELEGRAM_BOT_TOKEN_SECRET_ARN', '')
+            bot_token = ''
+            if bot_token_secret_arn:
+                sm = boto3.client('secretsmanager', region_name='us-east-1')
+                bot_token = sm.get_secret_value(SecretId=bot_token_secret_arn)['SecretString']
+            send_telegram_direct(chat_id, bot_token, "Hi! I don't recognize you yet. What's your name?")
+            return
     # ── Get or create AgentCore session ──────────────────────────────────
     session_id = get_or_create_session(actor_id)
     print(f"[agent-runner] actor={actor_id} session={session_id} user={user_profile.get('display_name', '')}")