feat: implement core/ and platform/ with full test coverage

- platform/interface.py: PlatformClient Protocol + Pydantic models (User,
  MessageResponse, UserSettings) — no explicit session management, Master
  handles container lifecycle
- platform/mock.py: MockPlatformClient with simulated latency, [MOCK]
  responses, is_new correctly True only on first creation
- core/protocol.py: unified dataclasses for all events and responses
  (IncomingMessage/Command/Callback, OutgoingMessage/UI/Notification,
  AuthFlow, ChatContext, SettingsAction, etc.)
- core/store.py: StateStore Protocol + InMemoryStore (tests) + SQLiteStore
  (prod) with JSON serialization
- core/chat.py: ChatManager — chat metadata (C1/C2/C3), not container
  lifecycle (that's the platform's job)
- core/auth.py: AuthManager — start_flow / confirm / is_authenticated
- core/settings.py: SettingsManager — get/apply with store cache
- core/handler.py: EventDispatcher — registry-based routing with keys
  (command name, action name, attachment type, "*" catch-all)
- core/handlers/: register_all() + start/new/message/callback/settings
  handlers; voice slot falls back to stub text until voice_handler added
- conftest.py: sys.path fix so local platform/ shadows stdlib platform
- docs/api-contract.md: rewritten for Lambda Lab 3.0 container model

46 tests passing, 0 warnings.

core/handlers/__init__.py

@@ -0,0 +1,24 @@
+# core/handlers/__init__.py
+from __future__ import annotations
+
+from core.handler import EventDispatcher
+from core.protocol import IncomingCallback, IncomingCommand, IncomingMessage
+from core.handlers import callback, chat, message, settings, start
+
+
+def register_all(dispatcher: EventDispatcher) -> None:
+    # Commands
+    dispatcher.register(IncomingCommand, "start",    start.handle_start)
+    dispatcher.register(IncomingCommand, "new",      chat.handle_new_chat)
+    dispatcher.register(IncomingCommand, "rename",   chat.handle_rename)
+    dispatcher.register(IncomingCommand, "archive",  chat.handle_archive)
+    dispatcher.register(IncomingCommand, "chats",    chat.handle_list_chats)
+    dispatcher.register(IncomingCommand, "settings", settings.handle_settings)
+
+    # Messages — catch-all (audio falls back here until voice_handler registered)
+    dispatcher.register(IncomingMessage, "*", message.handle_message)
+
+    # Callbacks
+    dispatcher.register(IncomingCallback, "confirm",      callback.handle_confirm)
+    dispatcher.register(IncomingCallback, "cancel",       callback.handle_cancel)
+    dispatcher.register(IncomingCallback, "toggle_skill", callback.handle_toggle_skill)

core/handlers/callback.py

@@ -0,0 +1,25 @@
+# core/handlers/callback.py
+from __future__ import annotations
+
+from core.protocol import IncomingCallback, OutgoingMessage, SettingsAction
+
+
+async def handle_confirm(event: IncomingCallback, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    action_id = event.payload.get("action_id", "unknown")
+    return [OutgoingMessage(chat_id=event.chat_id, text=f"Действие подтверждено (id: {action_id}).")]
+
+
+async def handle_cancel(event: IncomingCallback, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    action_id = event.payload.get("action_id", "unknown")
+    return [OutgoingMessage(chat_id=event.chat_id, text=f"Действие отменено (id: {action_id}).")]
+
+
+async def handle_toggle_skill(event: IncomingCallback, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    skill = event.payload.get("skill")
+    enabled = event.payload.get("enabled", True)
+    if not skill:
+        return [OutgoingMessage(chat_id=event.chat_id, text="Ошибка: не указан навык.")]
+    action = SettingsAction(action="toggle_skill", payload={"skill": skill, "enabled": enabled})
+    await settings_mgr.apply(event.user_id, action)
+    state = "включён" if enabled else "выключен"
+    return [OutgoingMessage(chat_id=event.chat_id, text=f"Навык {skill} {state}.")]

core/handlers/chat.py

@@ -0,0 +1,38 @@
+# core/handlers/chat.py
+from __future__ import annotations
+
+from core.protocol import IncomingCommand, OutgoingMessage
+
+
+async def handle_new_chat(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    if not await auth_mgr.is_authenticated(event.user_id):
+        return [OutgoingMessage(chat_id=event.chat_id, text="Введите /start чтобы начать.")]
+    name = " ".join(event.args) if event.args else None
+    ctx = await chat_mgr.get_or_create(
+        user_id=event.user_id,
+        chat_id=event.chat_id,
+        platform=event.platform,
+        surface_ref=event.chat_id,
+        name=name,
+    )
+    return [OutgoingMessage(chat_id=event.chat_id, text=f"Создан чат: {ctx.display_name}")]
+
+
+async def handle_rename(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    if not event.args:
+        return [OutgoingMessage(chat_id=event.chat_id, text="Укажите название: /rename Название")]
+    ctx = await chat_mgr.rename(event.chat_id, " ".join(event.args))
+    return [OutgoingMessage(chat_id=event.chat_id, text=f"Переименован в: {ctx.display_name}")]
+
+
+async def handle_archive(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    await chat_mgr.archive(event.chat_id)
+    return [OutgoingMessage(chat_id=event.chat_id, text="Чат архивирован.")]
+
+
+async def handle_list_chats(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    chats = await chat_mgr.list_active(event.user_id)
+    if not chats:
+        return [OutgoingMessage(chat_id=event.chat_id, text="Нет активных чатов.")]
+    lines = [f"• {c.display_name} ({c.chat_id})" for c in chats]
+    return [OutgoingMessage(chat_id=event.chat_id, text="\n".join(lines))]

core/handlers/message.py

@@ -0,0 +1,29 @@
+# core/handlers/message.py
+from __future__ import annotations
+
+from core.protocol import IncomingMessage, OutgoingMessage, OutgoingTyping
+
+
+async def handle_message(event: IncomingMessage, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    if not await auth_mgr.is_authenticated(event.user_id):
+        return [OutgoingMessage(chat_id=event.chat_id, text="Введите /start чтобы начать.")]
+
+    # Voice slot fallback: audio attachment without registered voice_handler
+    if event.attachments and event.attachments[0].type == "audio":
+        return [OutgoingMessage(
+            chat_id=event.chat_id,
+            text="Голосовые сообщения скоро поддержим.",
+            parse_mode="plain",
+        )]
+
+    response = await platform.send_message(
+        user_id=event.user_id,
+        chat_id=event.chat_id,
+        text=event.text,
+        attachments=[],
+    )
+
+    return [
+        OutgoingTyping(chat_id=event.chat_id, is_typing=False),
+        OutgoingMessage(chat_id=event.chat_id, text=response.response, parse_mode="markdown"),
+    ]

core/handlers/settings.py

@@ -0,0 +1,25 @@
+# core/handlers/settings.py
+from __future__ import annotations
+
+from core.protocol import IncomingCommand, OutgoingMessage, OutgoingUI, UIButton
+
+
+async def handle_settings(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    return [OutgoingUI(
+        chat_id=event.chat_id,
+        text="⚙️ Настройки",
+        buttons=[
+            UIButton(label="🔗 Коннекторы",    action="settings_connectors", style="secondary"),
+            UIButton(label="🧩 Скиллы",        action="settings_skills",     style="secondary"),
+            UIButton(label="🧠 Личность",      action="settings_soul",       style="secondary"),
+            UIButton(label="🔒 Безопасность",  action="settings_safety",     style="secondary"),
+            UIButton(label="💳 Подписка",      action="settings_plan",       style="secondary"),
+        ],
+    )]
+
+
+async def handle_settings_skills(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    s = await settings_mgr.get(event.user_id)
+    lines = [("✅" if on else "❌") + f" {name}" for name, on in s.skills.items()]
+    text = "🧩 Скиллы\n\n" + ("\n".join(lines) or "Нет доступных скиллов")
+    return [OutgoingMessage(chat_id=event.chat_id, text=text)]

core/handlers/start.py

@@ -0,0 +1,16 @@
+# core/handlers/start.py
+from __future__ import annotations
+
+from core.protocol import IncomingCommand, OutgoingMessage
+
+
+async def handle_start(event: IncomingCommand, auth_mgr, platform, chat_mgr, settings_mgr) -> list:
+    user = await platform.get_or_create_user(event.user_id, event.platform)
+    await auth_mgr.confirm(event.user_id)
+    name = user.display_name or event.user_id
+    text = (
+        f"Добро пожаловать, {name}! Я агент Lambda. Напишите что-нибудь чтобы начать."
+        if user.is_new
+        else f"С возвращением, {name}!"
+    )
+    return [OutgoingMessage(chat_id=event.chat_id, text=text)]