refactor: introduce multi-session chat support (#session) (#267)

* refactor: introduce multi-session chat support (#session) Replace the single-context-per-bot model with multiple chat sessions. Database: - Add bot_sessions table (route_id, channel_type, title, metadata, soft delete) - Migrate bot_history_messages from (route_id, channel_type) to session_id - Add active_session_id to bot_channel_routes - Migration 0036 handles data migration from existing messages Backend: - New internal/session service for session CRUD - Update message service/types to use session_id instead of route_id - Update conversation flow (resolver, history, store) for session context - Channel inbound auto-creates/retrieves active session via SessionEnsurer - New REST endpoints: /bots/:bot_id/sessions (CRUD) - WebSocket and message handlers accept optional session_id - Wire session service into FX dependency graph (agent + memoh) Frontend: - Refactor chat store: sessions replaces chats, sessionId replaces chatId - Session-aware message loading, sending, and pagination - WebSocket sends include session_id - New session sidebar component with select/delete - Chat area header shows active session title + new session button - API layer updated: fetchSessions, createSession, deleteSession - i18n strings for session management (en + zh) SDK: - Regenerated TypeScript SDK and Swagger docs with session endpoints * fix: update tests for session refactoring (RouteID → SessionID) Remove references to removed RouteID and Platform fields from PersistInput/Message in channel_test.go and service_integration_test.go. * fix: restore accidentally deleted SDK files and guard migration 0032 - Restore packages/sdk/src/container-stream.ts and extra/index.ts that were accidentally removed during SDK regeneration - Wrap migration 0032 route_id index creation in a column existence check to avoid failure on fresh databases where 0001_init.up.sql no longer has route_id * fix: guard migration 0036 data steps for fresh databases Wrap steps 3-7 (which reference route_id/channel_type on bot_history_messages) in a column existence check so the migration is safe on fresh databases where 0001_init.up.sql already reflects the final schema without those columns. * feat: add title model setting and auto-generate session titles on user input - Add title_model_id to bots table (migration 0037) and bot settings API - Implement async title generation triggered at user message time (not after assistant response) for faster title availability - Publish session_title_updated events via SSE event hub for real-time frontend updates without page refresh - Fix SSE message event parsing: use direct JSON.parse instead of normalizeStreamEvent which silently dropped non-chat-stream event types - Add title model selector in bot settings UI with i18n support * fix: session-scoped message filtering and URL-based chat routing - Filter realtime SSE messages by session_id to prevent cross-session message leakage after page refresh - Add /chat/:sessionId? route with bidirectional URL ↔ store sync - Visiting /chat shows a clean state with no bot or session pre-selected - Visiting /chat/:sessionId loads the specific session directly - Session switches from sidebar automatically update the URL - Fix stale RouteID field in dedupe test (removed during session refactor) * fix: skip cross-channel stream events to prevent session leakage The bot-level web stream pushes events from all channels (Telegram, Discord, etc.) without session_id context. Previously these were rendered inline in the current chat view regardless of session. Now cross-channel events are ignored in handleLocalStreamEvent; persisted messages arrive via the SSE message events stream with proper session_id filtering through appendRealtimeMessage. * feat: show IM avatars and platform badges on session sidebar - Add sender_avatar_url to route metadata from identity resolution - Resolve group avatar and handle via directory adapter for group chats - JOIN bot_channel_routes in ListSessionsByBot to return route metadata - Display avatar with ChannelBadge on IM session items (group avatar for groups, sender avatar for private chats) - Show @groupname or @username as session sub-label * fix: clean up RunConfig unused fields, fix skill system and copy bug - Remove unused RunConfig fields: Tools, Channels, CurrentChannel, ActiveContextTime - Remove unused SessionContext fields: DisplayName, ConversationType - Fix EnabledSkillNames copy bug: make([]string, 0, n) + copy copies zero elements; changed to make([]string, n) - Fix prepareRunConfig dead code: remove no-op loop over CurrentPlatform runes; compute supportsImageInput from model's InputModalities - Fix EnabledSkills always nil in system prompt: resolve enabled skill entries from EnabledSkillNames + Skills - Fix use_skill tool returning empty response: now returns full skill content (description + instructions) so LLM gets it in the same turn - Skip use_skill tool registration when no skills are available - Conditionally render Skills section in system prompt (hidden when no skills exist) * feat: add session type field and bind sessions to heartbeat/schedule executions - Add `type` column to `bot_sessions` (chat | heartbeat | schedule) - Add `session_id` to `bot_heartbeat_logs` for per-execution session tracking - Create `schedule_logs` table binding schedule_id + session_id - Heartbeat and schedule runs now create independent sessions and persist agent messages via storeRound, enabling full conversation replay - Add schedule logs API endpoints (list by bot, list by schedule, delete) - Update Triggerer interfaces to return TriggerResult with status/usage/model * refactor: modular system prompts per session type (chat/heartbeat/schedule) Split the monolithic system.md into three type-specific system prompts with shared fragments via {{include:_xxx}} syntax, so each session type gets a focused prompt without irrelevant instructions. * fix: prevent message duplication after task completion message_created events from Persist() had an empty platform field because toMessageFromCreate() didn't extract it from the session. This caused appendRealtimeMessage to fail the platform === 'web' guard, and hasMessageWithId to fail because local IDs differ from server UUIDs, resulting in all messages being appended as duplicates. - Extract platform from metadata in toMessageFromCreate so published events carry the correct value - Pass channel_type: 'web' when creating sessions from the web frontend so List queries return the correct platform via the session JOIN * fix: use per-message usage from SDK instead of misaligned step-level usages Previously, token usage was stored via a separate per-step usages array that didn't align with messages (off-by-one from prepending user message, step count != message count). This caused: - User messages incorrectly receiving usage data - Usage values shifted across messages in multi-step rounds - Last assistant message getting the accumulated total instead of its own step usage - InputTokenDetails/OutputTokenDetails lost during manual accumulation Now each sdk.Message carries its own per-step Usage (set by the SDK in buildStepMessages), which is extracted in sdkMessagesToModelMessages and stored directly via ModelMessage.Usage. The storeRound/storeMessages path no longer needs external usage/usages parameters. Also fixes the totalUsage accumulation in runStream to include all detail fields (InputTokenDetails, OutputTokenDetails). * feat: add /new slash command to create a new active session from IM channels Users in Telegram/Discord/Feishu can now send /new to start a fresh conversation, resetting the session context for the current chat thread. The command resolves the channel route, creates a new session, sets it as the active session on the route, and replies with a confirmation message. * feat: distinguish heartbeat and schedule sessions with dedicated icons in sidebar Heartbeat sessions show a heart-pulse icon (rose), schedule sessions show a clock icon (amber), and both display a type label beneath the session title. * refactor: remove enabledSkills system prompt injection, keep sorted skill listing use_skill now returns skill content directly as tool output, so there is no need to inject enabled skill body text into the system prompt. Remove the entire enabledSkills tracking chain (RunConfig.EnabledSkillNames, StreamEvent.Skills, GenerateResult.Skills, ChatRequest/Response.Skills, enableSkill closures in runStream/runGenerate, prepareRunConfig matching). Keep a lightweight skills listing (name + description only) in the system prompt so the model knows which skills are available. Sort entries by name to guarantee deterministic ordering and maximize KV cache reuse. * refactor: remove inbox system, persist passive messages directly to history Replace the bot_inbox table and service with direct writes to bot_history_messages for group conversations where the bot is not @mentioned. Trigger-path messages continue to be persisted after the agent responds (unchanged). - Drop bot_inbox table and max_inbox_items column (migration 0039) - Delete internal/inbox/, handlers/inbox.go, command/inbox.go, agent/tools/inbox.go and the MCP message provider - Add persistPassiveMessage() in channel inbound to write user messages into the active session immediately - Rewrite ListObservedConversationsByChannelIdentity to query bot_history_messages + bot_sessions instead of bot_inbox - Extract shared send/react logic into internal/messaging/executor.go; agent/tools/message.go is now a thin SDK adapter - Clean up all inbox references from agent prompts, flow resolver, email trigger, settings, commands, DI wiring, and frontend - Regenerate sqlc, swagger, and SDK * feat: add list_sessions and search_messages agent tools Provide agents with the ability to query session metadata and search message history across all sessions. search_messages supports filtering by time range, keyword (JSONB-aware ILIKE), session, contact, and role, with a default 7-day lookback when no start_time is given. * feat: inject last_heartbeat time and improve heartbeat search guidance Query the previous heartbeat's started_at timestamp and pass it through TriggerPayload into the heartbeat prompt template. Update system prompt and HEARTBEAT.md checklist to guide agents to use search_messages with start_time=last_heartbeat for efficient cross-session message review. * fix: pass BridgeProvider to FSClient and store full heartbeat prompt FSClient was always created with nil provider, causing all container file reads (IDENTITY.md, SOUL.md, MEMORY.md, HEARTBEAT.md, etc.) to silently return empty strings. Expose Agent.BridgeProvider() and wire it into Resolver. Also fix heartbeat trigger to store the full prompt template as the user message instead of the literal "heartbeat" string. * feat: add line numbers to container file read output Move line-number formatting from the bridge gRPC server to the agent tool layer so that the raw content stored and transmitted via gRPC remains clean, while the read_file tool output includes numbered lines for easier reference by the agent. * chore(deps): update twilight-ai to v0.3.2 * fix: lint, test
2026-04-27 07:16:19 +09:00 · 2026-03-21 15:57:22 +08:00
parent ad08f335eb
commit 7d7d0e4b51
152 changed files with 7674 additions and 4922 deletions
@@ -1,15 +1,15 @@
 -- name: CreateBot :one
 INSERT INTO bots (owner_user_id, display_name, avatar_url, is_active, metadata, status)
 VALUES ($1, $2, $3, $4, $5, $6)
-RETURNING id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, max_inbox_items, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at;
+RETURNING id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at;

 -- name: GetBotByID :one
-SELECT id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, max_inbox_items, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at
+SELECT id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at
 FROM bots
 WHERE id = $1;

 -- name: ListBotsByOwner :many
-SELECT id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, max_inbox_items, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at
+SELECT id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at
 FROM bots
 WHERE owner_user_id = $1
 ORDER BY created_at DESC;
@@ -22,14 +22,14 @@ SET display_name = $2,
    metadata = $5,
    updated_at = now()
 WHERE id = $1
-RETURNING id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, max_inbox_items, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at;
+RETURNING id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at;

 -- name: UpdateBotOwner :one
 UPDATE bots
 SET owner_user_id = $2,
    updated_at = now()
 WHERE id = $1
-RETURNING id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, max_inbox_items, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at;
+RETURNING id, owner_user_id, display_name, avatar_url, is_active, status, max_context_load_time, max_context_tokens, language, reasoning_enabled, reasoning_effort, chat_model_id, search_provider_id, memory_provider_id, heartbeat_enabled, heartbeat_interval, heartbeat_prompt, metadata, created_at, updated_at;

 -- name: UpdateBotStatus :exec
 UPDATE bots
@@ -22,6 +22,7 @@ RETURNING
  external_thread_id AS thread_id,
  conversation_type,
  default_reply_target AS reply_target,
+  active_session_id,
  metadata,
  created_at,
  updated_at;
@@ -37,6 +38,7 @@ SELECT
  external_thread_id AS thread_id,
  conversation_type,
  default_reply_target AS reply_target,
+  active_session_id,
  metadata,
  created_at,
  updated_at
@@ -58,6 +60,7 @@ SELECT
  external_thread_id AS thread_id,
  conversation_type,
  default_reply_target AS reply_target,
+  active_session_id,
  metadata,
  created_at,
  updated_at
@@ -75,6 +78,7 @@ SELECT
  external_thread_id AS thread_id,
  conversation_type,
  default_reply_target AS reply_target,
+  active_session_id,
  metadata,
  created_at,
  updated_at
@@ -92,6 +96,11 @@ UPDATE bot_channel_routes
 SET metadata = sqlc.arg(metadata), updated_at = now()
 WHERE id = sqlc.arg(id);

+-- name: SetRouteActiveSession :exec
+UPDATE bot_channel_routes
+SET active_session_id = sqlc.narg(active_session_id)::uuid, updated_at = now()
+WHERE id = sqlc.arg(id);
+
 -- name: DeleteChatRoute :exec
 DELETE FROM bot_channel_routes
 WHERE id = $1;
@@ -131,6 +131,10 @@ WHERE id = sqlc.arg(chat_id);
 WITH deleted_messages AS (
  DELETE FROM bot_history_messages
  WHERE bot_id = sqlc.arg(chat_id)
+),
+deleted_sessions AS (
+  DELETE FROM bot_sessions
+  WHERE bot_id = sqlc.arg(chat_id)
 )
 DELETE FROM bot_channel_routes bcr
 WHERE bcr.bot_id = sqlc.arg(chat_id);
@@ -1,7 +1,7 @@
 -- name: CreateHeartbeatLog :one
-INSERT INTO bot_heartbeat_logs (bot_id, started_at)
-VALUES ($1, now())
-RETURNING id, bot_id, status, result_text, error_message, usage, started_at, completed_at;
+INSERT INTO bot_heartbeat_logs (bot_id, session_id, started_at)
+VALUES ($1, sqlc.narg(session_id)::uuid, now())
+RETURNING id, bot_id, session_id, status, result_text, error_message, usage, started_at, completed_at;

 -- name: CompleteHeartbeatLog :one
 UPDATE bot_heartbeat_logs
@@ -12,10 +12,10 @@ SET status = $2,
    model_id = $6,
    completed_at = now()
 WHERE id = $1
-RETURNING id, bot_id, status, result_text, error_message, usage, model_id, started_at, completed_at;
+RETURNING id, bot_id, session_id, status, result_text, error_message, usage, model_id, started_at, completed_at;

 -- name: ListHeartbeatLogsByBot :many
-SELECT id, bot_id, status, result_text, error_message, usage, started_at, completed_at
+SELECT id, bot_id, session_id, status, result_text, error_message, usage, started_at, completed_at
 FROM bot_heartbeat_logs
 WHERE bot_id = $1
  AND ($2::timestamptz IS NULL OR started_at < $2::timestamptz)
@@ -1,61 +0,0 @@
-- name: CreateInboxItem :one
-INSERT INTO bot_inbox (bot_id, source, header, content, action)
-VALUES (sqlc.arg(bot_id), sqlc.arg(source), sqlc.arg(header), sqlc.arg(content), sqlc.arg(action))
-RETURNING *;
-
-- name: GetInboxItemByID :one
-SELECT * FROM bot_inbox
-WHERE id = sqlc.arg(id)
-  AND bot_id = sqlc.arg(bot_id);
-
-- name: ListInboxItems :many
-SELECT * FROM bot_inbox
-WHERE bot_id = sqlc.arg(bot_id)
-  AND (sqlc.narg(is_read)::boolean IS NULL OR is_read = sqlc.narg(is_read)::boolean)
-  AND (sqlc.narg(source)::text IS NULL OR source = sqlc.narg(source)::text)
-ORDER BY created_at DESC
-LIMIT sqlc.arg(max_count)
-OFFSET sqlc.arg(item_offset);
-
-- name: ListUnreadInboxItems :many
-SELECT * FROM bot_inbox
-WHERE bot_id = sqlc.arg(bot_id)
-  AND is_read = FALSE
-ORDER BY created_at ASC
-LIMIT sqlc.arg(max_count);
-
-- name: MarkInboxItemsRead :exec
-UPDATE bot_inbox
-SET is_read = TRUE,
-    read_at = now()
-WHERE bot_id = sqlc.arg(bot_id)
-  AND id = ANY(sqlc.arg(ids)::uuid[])
-  AND is_read = FALSE;
-
-- name: SearchInboxItems :many
-SELECT * FROM bot_inbox
-WHERE bot_id = sqlc.arg(bot_id)
-  AND (sqlc.narg(query)::text IS NULL OR content ILIKE '%' || sqlc.narg(query)::text || '%')
-  AND (sqlc.narg(start_time)::timestamptz IS NULL OR created_at >= sqlc.narg(start_time)::timestamptz)
-  AND (sqlc.narg(end_time)::timestamptz IS NULL OR created_at <= sqlc.narg(end_time)::timestamptz)
-  AND (sqlc.narg(include_read)::boolean IS NULL OR sqlc.narg(include_read)::boolean = TRUE OR is_read = FALSE)
-ORDER BY created_at DESC
-LIMIT sqlc.arg(max_count);
-
-- name: CountUnreadInboxItems :one
-SELECT count(*) FROM bot_inbox
-WHERE bot_id = sqlc.arg(bot_id)
-  AND is_read = FALSE;
-
-- name: CountInboxItems :one
-SELECT count(*) FROM bot_inbox
-WHERE bot_id = sqlc.arg(bot_id);
-
-- name: DeleteInboxItem :exec
-DELETE FROM bot_inbox
-WHERE id = sqlc.arg(id)
-  AND bot_id = sqlc.arg(bot_id);
-
-- name: DeleteInboxItemsByBot :exec
-DELETE FROM bot_inbox
-WHERE bot_id = sqlc.arg(bot_id);
@@ -1,10 +1,9 @@
 -- name: CreateMessage :one
 INSERT INTO bot_history_messages (
  bot_id,
-  route_id,
+  session_id,
  sender_channel_identity_id,
  sender_account_user_id,
-  channel_type,
  source_message_id,
  source_reply_to_message_id,
  role,
@@ -15,10 +14,9 @@ INSERT INTO bot_history_messages (
 )
 VALUES (
  sqlc.arg(bot_id),
-  sqlc.narg(route_id)::uuid,
+  sqlc.narg(session_id)::uuid,
  sqlc.narg(sender_channel_identity_id)::uuid,
  sqlc.narg(sender_user_id)::uuid,
-  sqlc.narg(platform)::text,
  sqlc.narg(external_message_id)::text,
  sqlc.narg(source_reply_to_message_id)::text,
  sqlc.arg(role),
@@ -30,10 +28,9 @@ VALUES (
 RETURNING
  id,
  bot_id,
-  route_id,
+  session_id,
  sender_channel_identity_id,
  sender_account_user_id AS sender_user_id,
-  channel_type AS platform,
  source_message_id AS external_message_id,
  source_reply_to_message_id,
  role,
@@ -46,10 +43,9 @@ RETURNING
 SELECT
  m.id,
  m.bot_id,
-  m.route_id,
+  m.session_id,
  m.sender_channel_identity_id,
  m.sender_account_user_id AS sender_user_id,
-  m.channel_type AS platform,
  m.source_message_id AS external_message_id,
  m.source_reply_to_message_id,
  m.role,
@@ -58,21 +54,46 @@ SELECT
  m.usage,
  m.created_at,
  ci.display_name AS sender_display_name,
-  ci.avatar_url AS sender_avatar_url
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
 FROM bot_history_messages m
 LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
 WHERE m.bot_id = sqlc.arg(bot_id)
 ORDER BY m.created_at ASC
 LIMIT 10000;

+-- name: ListMessagesBySession :many
+SELECT
+  m.id,
+  m.bot_id,
+  m.session_id,
+  m.sender_channel_identity_id,
+  m.sender_account_user_id AS sender_user_id,
+  m.source_message_id AS external_message_id,
+  m.source_reply_to_message_id,
+  m.role,
+  m.content,
+  m.metadata,
+  m.usage,
+  m.created_at,
+  ci.display_name AS sender_display_name,
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
+FROM bot_history_messages m
+LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
+WHERE m.session_id = sqlc.arg(session_id)
+ORDER BY m.created_at ASC
+LIMIT 10000;
+
 -- name: ListMessagesSince :many
 SELECT
  m.id,
  m.bot_id,
-  m.route_id,
+  m.session_id,
  m.sender_channel_identity_id,
  m.sender_account_user_id AS sender_user_id,
-  m.channel_type AS platform,
  m.source_message_id AS external_message_id,
  m.source_reply_to_message_id,
  m.role,
@@ -81,21 +102,46 @@ SELECT
  m.usage,
  m.created_at,
  ci.display_name AS sender_display_name,
-  ci.avatar_url AS sender_avatar_url
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
 FROM bot_history_messages m
 LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
 WHERE m.bot_id = sqlc.arg(bot_id)
  AND m.created_at >= sqlc.arg(created_at)
 ORDER BY m.created_at ASC;

+-- name: ListMessagesSinceBySession :many
+SELECT
+  m.id,
+  m.bot_id,
+  m.session_id,
+  m.sender_channel_identity_id,
+  m.sender_account_user_id AS sender_user_id,
+  m.source_message_id AS external_message_id,
+  m.source_reply_to_message_id,
+  m.role,
+  m.content,
+  m.metadata,
+  m.usage,
+  m.created_at,
+  ci.display_name AS sender_display_name,
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
+FROM bot_history_messages m
+LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
+WHERE m.session_id = sqlc.arg(session_id)
+  AND m.created_at >= sqlc.arg(created_at)
+ORDER BY m.created_at ASC;
+
 -- name: ListActiveMessagesSince :many
 SELECT
  m.id,
  m.bot_id,
-  m.route_id,
+  m.session_id,
  m.sender_channel_identity_id,
  m.sender_account_user_id AS sender_user_id,
-  m.channel_type AS platform,
  m.source_message_id AS external_message_id,
  m.source_reply_to_message_id,
  m.role,
@@ -104,22 +150,48 @@ SELECT
  m.usage,
  m.created_at,
  ci.display_name AS sender_display_name,
-  ci.avatar_url AS sender_avatar_url
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
 FROM bot_history_messages m
 LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
 WHERE m.bot_id = sqlc.arg(bot_id)
  AND m.created_at >= sqlc.arg(created_at)
  AND (m.metadata->>'trigger_mode' IS NULL OR m.metadata->>'trigger_mode' != 'passive_sync')
 ORDER BY m.created_at ASC;

+-- name: ListActiveMessagesSinceBySession :many
+SELECT
+  m.id,
+  m.bot_id,
+  m.session_id,
+  m.sender_channel_identity_id,
+  m.sender_account_user_id AS sender_user_id,
+  m.source_message_id AS external_message_id,
+  m.source_reply_to_message_id,
+  m.role,
+  m.content,
+  m.metadata,
+  m.usage,
+  m.created_at,
+  ci.display_name AS sender_display_name,
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
+FROM bot_history_messages m
+LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
+WHERE m.session_id = sqlc.arg(session_id)
+  AND m.created_at >= sqlc.arg(created_at)
+  AND (m.metadata->>'trigger_mode' IS NULL OR m.metadata->>'trigger_mode' != 'passive_sync')
+ORDER BY m.created_at ASC;
+
 -- name: ListMessagesBefore :many
 SELECT
  m.id,
  m.bot_id,
-  m.route_id,
+  m.session_id,
  m.sender_channel_identity_id,
  m.sender_account_user_id AS sender_user_id,
-  m.channel_type AS platform,
  m.source_message_id AS external_message_id,
  m.source_reply_to_message_id,
  m.role,
@@ -128,22 +200,48 @@ SELECT
  m.usage,
  m.created_at,
  ci.display_name AS sender_display_name,
-  ci.avatar_url AS sender_avatar_url
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
 FROM bot_history_messages m
 LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
 WHERE m.bot_id = sqlc.arg(bot_id)
  AND m.created_at < sqlc.arg(created_at)
 ORDER BY m.created_at DESC
 LIMIT sqlc.arg(max_count);

+-- name: ListMessagesBeforeBySession :many
+SELECT
+  m.id,
+  m.bot_id,
+  m.session_id,
+  m.sender_channel_identity_id,
+  m.sender_account_user_id AS sender_user_id,
+  m.source_message_id AS external_message_id,
+  m.source_reply_to_message_id,
+  m.role,
+  m.content,
+  m.metadata,
+  m.usage,
+  m.created_at,
+  ci.display_name AS sender_display_name,
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
+FROM bot_history_messages m
+LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
+WHERE m.session_id = sqlc.arg(session_id)
+  AND m.created_at < sqlc.arg(created_at)
+ORDER BY m.created_at DESC
+LIMIT sqlc.arg(max_count);
+
 -- name: ListMessagesLatest :many
 SELECT
  m.id,
  m.bot_id,
-  m.route_id,
+  m.session_id,
  m.sender_channel_identity_id,
  m.sender_account_user_id AS sender_user_id,
-  m.channel_type AS platform,
  m.source_message_id AS external_message_id,
  m.source_reply_to_message_id,
  m.role,
@@ -152,45 +250,58 @@ SELECT
  m.usage,
  m.created_at,
  ci.display_name AS sender_display_name,
-  ci.avatar_url AS sender_avatar_url
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
 FROM bot_history_messages m
 LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
 WHERE m.bot_id = sqlc.arg(bot_id)
 ORDER BY m.created_at DESC
 LIMIT sqlc.arg(max_count);

+-- name: ListMessagesLatestBySession :many
+SELECT
+  m.id,
+  m.bot_id,
+  m.session_id,
+  m.sender_channel_identity_id,
+  m.sender_account_user_id AS sender_user_id,
+  m.source_message_id AS external_message_id,
+  m.source_reply_to_message_id,
+  m.role,
+  m.content,
+  m.metadata,
+  m.usage,
+  m.created_at,
+  ci.display_name AS sender_display_name,
+  ci.avatar_url AS sender_avatar_url,
+  s.channel_type AS platform
+FROM bot_history_messages m
+LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
+WHERE m.session_id = sqlc.arg(session_id)
+ORDER BY m.created_at DESC
+LIMIT sqlc.arg(max_count);
+
 -- name: DeleteMessagesByBot :exec
 DELETE FROM bot_history_messages
 WHERE bot_id = sqlc.arg(bot_id);

+-- name: DeleteMessagesBySession :exec
+DELETE FROM bot_history_messages
+WHERE session_id = sqlc.arg(session_id);
+
 -- name: ListObservedConversationsByChannelIdentity :many
 WITH observed_routes AS (
  SELECT
-    (i.header->>'route_id')::uuid AS route_id,
-    MAX(i.created_at)::timestamptz AS last_observed_at
-  FROM bot_inbox i
-  WHERE i.bot_id = sqlc.arg(bot_id)
-    AND i.header->>'channel-identity-id' = sqlc.arg(channel_identity_id)::text
-    AND COALESCE(i.header->>'route_id', '') != ''
-  GROUP BY (i.header->>'route_id')::uuid
-
-  UNION ALL
-
-  SELECT
-    m.route_id,
+    s.route_id,
    MAX(m.created_at)::timestamptz AS last_observed_at
  FROM bot_history_messages m
+  JOIN bot_sessions s ON s.id = m.session_id
  WHERE m.bot_id = sqlc.arg(bot_id)
    AND m.sender_channel_identity_id = sqlc.arg(channel_identity_id)::uuid
-    AND m.route_id IS NOT NULL
-  GROUP BY m.route_id
-),
-ranked_routes AS (
-  SELECT
-    route_id,
-    MAX(last_observed_at)::timestamptz AS last_observed_at
-  FROM observed_routes
-  GROUP BY route_id
+    AND s.route_id IS NOT NULL
+  GROUP BY s.route_id
 )
 SELECT
  r.id AS route_id,
@@ -203,7 +314,7 @@ SELECT
  COALESCE(r.external_thread_id, '') AS thread_id,
  COALESCE(r.metadata->>'conversation_name', '')::text AS conversation_name,
  rr.last_observed_at
-FROM ranked_routes rr
+FROM observed_routes rr
 JOIN bot_channel_routes r ON r.id = rr.route_id
 WHERE LOWER(COALESCE(r.conversation_type, '')) NOT IN ('', 'p2p', 'private', 'direct', 'dm')
 GROUP BY
@@ -215,3 +326,37 @@ GROUP BY
  r.metadata,
  rr.last_observed_at
 ORDER BY rr.last_observed_at DESC;
+
+-- name: SearchMessages :many
+SELECT
+  m.id,
+  m.bot_id,
+  m.session_id,
+  m.sender_channel_identity_id,
+  m.role,
+  m.content,
+  m.created_at,
+  ci.display_name AS sender_display_name,
+  s.channel_type AS platform
+FROM bot_history_messages m
+LEFT JOIN channel_identities ci ON ci.id = m.sender_channel_identity_id
+LEFT JOIN bot_sessions s ON s.id = m.session_id
+WHERE m.bot_id = sqlc.arg(bot_id)
+  AND (sqlc.narg(session_id)::uuid IS NULL OR m.session_id = sqlc.narg(session_id)::uuid)
+  AND (sqlc.narg(contact_id)::uuid IS NULL OR m.sender_channel_identity_id = sqlc.narg(contact_id)::uuid)
+  AND (sqlc.narg(start_time)::timestamptz IS NULL OR m.created_at >= sqlc.narg(start_time)::timestamptz)
+  AND (sqlc.narg(end_time)::timestamptz IS NULL OR m.created_at <= sqlc.narg(end_time)::timestamptz)
+  AND (sqlc.narg(role)::text IS NULL OR m.role = sqlc.narg(role)::text)
+  AND (sqlc.narg(keyword)::text IS NULL OR (
+    CASE
+      WHEN jsonb_typeof(m.content->'content') = 'string'
+        THEN m.content->>'content'
+      WHEN jsonb_typeof(m.content->'content') = 'array'
+        THEN (SELECT COALESCE(string_agg(elem->>'text', ' '), '')
+              FROM jsonb_array_elements(m.content->'content') AS elem
+              WHERE elem->>'type' = 'text')
+      ELSE ''
+    END
+  ) ILIKE '%' || sqlc.narg(keyword)::text || '%')
+ORDER BY m.created_at DESC
+LIMIT sqlc.arg(max_count);
@@ -0,0 +1,37 @@
+-- name: CreateScheduleLog :one
+INSERT INTO schedule_logs (schedule_id, bot_id, session_id, started_at)
+VALUES ($1, $2, sqlc.narg(session_id)::uuid, now())
+RETURNING id, schedule_id, bot_id, session_id, status, result_text, error_message, usage, started_at, completed_at;
+
+-- name: CompleteScheduleLog :one
+UPDATE schedule_logs
+SET status = $2,
+    result_text = $3,
+    error_message = $4,
+    usage = $5,
+    model_id = $6,
+    completed_at = now()
+WHERE id = $1
+RETURNING id, schedule_id, bot_id, session_id, status, result_text, error_message, usage, model_id, started_at, completed_at;
+
+-- name: ListScheduleLogsByBot :many
+SELECT id, schedule_id, bot_id, session_id, status, result_text, error_message, usage, started_at, completed_at
+FROM schedule_logs
+WHERE bot_id = $1
+  AND ($2::timestamptz IS NULL OR started_at < $2::timestamptz)
+ORDER BY started_at DESC
+LIMIT $3;
+
+-- name: ListScheduleLogsBySchedule :many
+SELECT id, schedule_id, bot_id, session_id, status, result_text, error_message, usage, started_at, completed_at
+FROM schedule_logs
+WHERE schedule_id = $1
+  AND ($2::timestamptz IS NULL OR started_at < $2::timestamptz)
+ORDER BY started_at DESC
+LIMIT $3;
+
+-- name: DeleteScheduleLogsByBot :exec
+DELETE FROM schedule_logs WHERE bot_id = $1;
+
+-- name: DeleteScheduleLogsBySchedule :exec
+DELETE FROM schedule_logs WHERE schedule_id = $1;
@@ -0,0 +1,72 @@
+-- name: CreateSession :one
+INSERT INTO bot_sessions (
+  bot_id, route_id, channel_type, type, title, metadata
+)
+VALUES (
+  sqlc.arg(bot_id),
+  sqlc.narg(route_id)::uuid,
+  sqlc.narg(channel_type)::text,
+  sqlc.arg(type),
+  sqlc.arg(title),
+  sqlc.arg(metadata)
+)
+RETURNING *;
+
+-- name: GetSessionByID :one
+SELECT *
+FROM bot_sessions
+WHERE id = $1
+  AND deleted_at IS NULL;
+
+-- name: ListSessionsByBot :many
+SELECT
+  s.id, s.bot_id, s.route_id, s.channel_type, s.type, s.title, s.metadata,
+  s.created_at, s.updated_at, s.deleted_at,
+  r.metadata AS route_metadata,
+  r.conversation_type AS route_conversation_type
+FROM bot_sessions s
+LEFT JOIN bot_channel_routes r ON r.id = s.route_id
+WHERE s.bot_id = sqlc.arg(bot_id)
+  AND s.deleted_at IS NULL
+ORDER BY s.updated_at DESC;
+
+-- name: ListSessionsByRoute :many
+SELECT *
+FROM bot_sessions
+WHERE route_id = sqlc.arg(route_id)
+  AND deleted_at IS NULL
+ORDER BY updated_at DESC;
+
+-- name: UpdateSessionTitle :one
+UPDATE bot_sessions
+SET title = sqlc.arg(title), updated_at = now()
+WHERE id = sqlc.arg(id) AND deleted_at IS NULL
+RETURNING *;
+
+-- name: UpdateSessionMetadata :one
+UPDATE bot_sessions
+SET metadata = sqlc.arg(metadata), updated_at = now()
+WHERE id = sqlc.arg(id) AND deleted_at IS NULL
+RETURNING *;
+
+-- name: SoftDeleteSession :exec
+UPDATE bot_sessions
+SET deleted_at = now(), updated_at = now()
+WHERE id = sqlc.arg(id) AND deleted_at IS NULL;
+
+-- name: TouchSession :exec
+UPDATE bot_sessions
+SET updated_at = now()
+WHERE id = sqlc.arg(id) AND deleted_at IS NULL;
+
+-- name: GetActiveSessionForRoute :one
+SELECT s.*
+FROM bot_sessions s
+JOIN bot_channel_routes r ON r.active_session_id = s.id
+WHERE r.id = sqlc.arg(route_id)
+  AND s.deleted_at IS NULL;
+
+-- name: SoftDeleteSessionsByBot :exec
+UPDATE bot_sessions
+SET deleted_at = now(), updated_at = now()
+WHERE bot_id = sqlc.arg(bot_id) AND deleted_at IS NULL;
@@ -3,7 +3,6 @@ SELECT
  bots.id AS bot_id,
  bots.max_context_load_time,
  bots.max_context_tokens,
-  bots.max_inbox_items,
  bots.language,
  bots.reasoning_enabled,
  bots.reasoning_effort,
@@ -12,6 +11,7 @@ SELECT
  bots.heartbeat_prompt,
  chat_models.id AS chat_model_id,
  heartbeat_models.id AS heartbeat_model_id,
+  title_models.id AS title_model_id,
  search_providers.id AS search_provider_id,
  memory_providers.id AS memory_provider_id,
  tts_models.id AS tts_model_id,
@@ -19,6 +19,7 @@ SELECT
 FROM bots
 LEFT JOIN models AS chat_models ON chat_models.id = bots.chat_model_id
 LEFT JOIN models AS heartbeat_models ON heartbeat_models.id = bots.heartbeat_model_id
+LEFT JOIN models AS title_models ON title_models.id = bots.title_model_id
 LEFT JOIN search_providers ON search_providers.id = bots.search_provider_id
 LEFT JOIN memory_providers ON memory_providers.id = bots.memory_provider_id
 LEFT JOIN tts_models ON tts_models.id = bots.tts_model_id
@@ -30,7 +31,6 @@ WITH updated AS (
  UPDATE bots
  SET max_context_load_time = sqlc.arg(max_context_load_time),
      max_context_tokens = sqlc.arg(max_context_tokens),
-      max_inbox_items = sqlc.arg(max_inbox_items),
      language = sqlc.arg(language),
      reasoning_enabled = sqlc.arg(reasoning_enabled),
      reasoning_effort = sqlc.arg(reasoning_effort),
@@ -39,19 +39,19 @@ WITH updated AS (
      heartbeat_prompt = sqlc.arg(heartbeat_prompt),
      chat_model_id = COALESCE(sqlc.narg(chat_model_id)::uuid, bots.chat_model_id),
      heartbeat_model_id = COALESCE(sqlc.narg(heartbeat_model_id)::uuid, bots.heartbeat_model_id),
+      title_model_id = COALESCE(sqlc.narg(title_model_id)::uuid, bots.title_model_id),
      search_provider_id = COALESCE(sqlc.narg(search_provider_id)::uuid, bots.search_provider_id),
      memory_provider_id = COALESCE(sqlc.narg(memory_provider_id)::uuid, bots.memory_provider_id),
      tts_model_id = COALESCE(sqlc.narg(tts_model_id)::uuid, bots.tts_model_id),
      browser_context_id = COALESCE(sqlc.narg(browser_context_id)::uuid, bots.browser_context_id),
      updated_at = now()
  WHERE bots.id = sqlc.arg(id)
-  RETURNING bots.id, bots.max_context_load_time, bots.max_context_tokens, bots.max_inbox_items, bots.language, bots.reasoning_enabled, bots.reasoning_effort, bots.heartbeat_enabled, bots.heartbeat_interval, bots.heartbeat_prompt, bots.chat_model_id, bots.heartbeat_model_id, bots.search_provider_id, bots.memory_provider_id, bots.tts_model_id, bots.browser_context_id
+  RETURNING bots.id, bots.max_context_load_time, bots.max_context_tokens, bots.language, bots.reasoning_enabled, bots.reasoning_effort, bots.heartbeat_enabled, bots.heartbeat_interval, bots.heartbeat_prompt, bots.chat_model_id, bots.heartbeat_model_id, bots.title_model_id, bots.search_provider_id, bots.memory_provider_id, bots.tts_model_id, bots.browser_context_id
 )
 SELECT
  updated.id AS bot_id,
  updated.max_context_load_time,
  updated.max_context_tokens,
-  updated.max_inbox_items,
  updated.language,
  updated.reasoning_enabled,
  updated.reasoning_effort,
@@ -60,6 +60,7 @@ SELECT
  updated.heartbeat_prompt,
  chat_models.id AS chat_model_id,
  heartbeat_models.id AS heartbeat_model_id,
+  title_models.id AS title_model_id,
  search_providers.id AS search_provider_id,
  memory_providers.id AS memory_provider_id,
  tts_models.id AS tts_model_id,
@@ -67,6 +68,7 @@ SELECT
 FROM updated
 LEFT JOIN models AS chat_models ON chat_models.id = updated.chat_model_id
 LEFT JOIN models AS heartbeat_models ON heartbeat_models.id = updated.heartbeat_model_id
+LEFT JOIN models AS title_models ON title_models.id = updated.title_model_id
 LEFT JOIN search_providers ON search_providers.id = updated.search_provider_id
 LEFT JOIN memory_providers ON memory_providers.id = updated.memory_provider_id
 LEFT JOIN tts_models ON tts_models.id = updated.tts_model_id
@@ -76,7 +78,6 @@ LEFT JOIN browser_contexts ON browser_contexts.id = updated.browser_context_id;
 UPDATE bots
 SET max_context_load_time = 1440,
    max_context_tokens = 0,
-    max_inbox_items = 50,
    language = 'auto',
    reasoning_enabled = false,
    reasoning_effort = 'medium',
@@ -85,6 +86,7 @@ SET max_context_load_time = 1440,
    heartbeat_prompt = '',
    chat_model_id = NULL,
    heartbeat_model_id = NULL,
+    title_model_id = NULL,
    search_provider_id = NULL,
    memory_provider_id = NULL,
    tts_model_id = NULL,