Telegram dropped every incoming photo, document, video and audio message: the default handler required message text, and nothing on the turn path knew media existed. The receiving path now closes the gap end to end. - telegram: extract the attachment from the update (largest photo, plus document, video, video-note, audio and voice kinds), download its bytes on the turn lane through getFile + the Bot API file link with a 20 MB gate, submit the turn with the attachment, and answer unsupported content kinds (sticker, location, contact, poll) with a clear notice instead of silence - messaging: Inbound carries turn-scoped transport media and MediaAttachment a Data field for in-process bytes; Message gains Media attachment metadata which stores persist (Postgres jsonb via migration 0020, memory store) with Data stripped at the persist boundary, and pb.Message carries the metadata on the gateway wire - gateway: TurnModelRequest threads the turn's media to the model seam - archied: the chat turn model merges the attachments into the final user message as ai-sdk image/file part entries, so vision-capable models see the file for the turn it arrived in; stored history keeps the placeholder note plus caption Session log: messages carry what was sent as data (the attachment metadata), not just prose. Transcript rendering of attachments and a re-look capability are tracked as archie-core-jaba.
175 lines
7.5 KiB
SQL
175 lines
7.5 KiB
SQL
-- Gateway conversation queries: sessions, messages, turns, full-text search.
|
|
-- These back internal/gateway's PostgreSQL SessionStore.
|
|
|
|
-- ── Sessions ────────────────────────────────────────────────────────────────
|
|
|
|
-- name: SaveSession :exec
|
|
INSERT INTO sessions (session_id, platform, bot_user, channel_id, thread_id,
|
|
title, parent_session_id, branch_name, created_at, last_active_at)
|
|
VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
|
|
ON CONFLICT (session_id) DO UPDATE SET
|
|
platform = EXCLUDED.platform,
|
|
bot_user = EXCLUDED.bot_user,
|
|
channel_id = EXCLUDED.channel_id,
|
|
thread_id = EXCLUDED.thread_id,
|
|
title = EXCLUDED.title,
|
|
parent_session_id = EXCLUDED.parent_session_id,
|
|
branch_name = EXCLUDED.branch_name,
|
|
created_at = EXCLUDED.created_at,
|
|
last_active_at = EXCLUDED.last_active_at;
|
|
|
|
-- name: SessionByID :one
|
|
SELECT session_id, platform, bot_user, channel_id, thread_id,
|
|
title, parent_session_id, branch_name, created_at, last_active_at
|
|
FROM sessions WHERE session_id = $1;
|
|
|
|
-- name: SessionsByChannel :many
|
|
SELECT session_id, platform, bot_user, channel_id, thread_id,
|
|
title, parent_session_id, branch_name, created_at, last_active_at
|
|
FROM sessions
|
|
WHERE platform = $1 AND channel_id = $2
|
|
ORDER BY GREATEST(last_active_at, created_at) DESC;
|
|
|
|
-- name: ListSessions :many
|
|
SELECT session_id, platform, bot_user, channel_id, thread_id,
|
|
title, parent_session_id, branch_name, created_at, last_active_at
|
|
FROM sessions
|
|
ORDER BY GREATEST(last_active_at, created_at) DESC;
|
|
|
|
-- name: DeleteSessionMessages :exec
|
|
DELETE FROM messages WHERE session_id = $1;
|
|
|
|
-- name: DeleteSessionTurns :exec
|
|
DELETE FROM turns WHERE session_id = $1;
|
|
|
|
-- name: DeleteSession :exec
|
|
DELETE FROM sessions WHERE session_id = $1;
|
|
|
|
-- name: TouchSession :exec
|
|
UPDATE sessions SET last_active_at = $2 WHERE session_id = $1;
|
|
|
|
-- ── Messages ────────────────────────────────────────────────────────────────
|
|
|
|
-- name: LockSessionMessages :exec
|
|
-- Serialises message appends per session so the monotonic clamp's MAX(ts)
|
|
-- read cannot race a concurrent append of the same session. Transaction-scoped:
|
|
-- released at commit/rollback, which is exactly the lifetime of the append.
|
|
SELECT pg_advisory_xact_lock(hashtextextended('messages:' || $1::text, 0));
|
|
|
|
-- name: InsertMessageClamped :exec
|
|
-- The append path's strictly-increasing timestamp. The clamp is computed in
|
|
-- SQL, not in Go: the CASE assigns MAX(ts)+1 when the caller's timestamp is
|
|
-- not ahead of the session's newest, else the caller's timestamp. A Go-side
|
|
-- read-then-write would race two concurrent appends to the same session.
|
|
INSERT INTO messages (message_id, session_id, source_id, sender, sender_id, role, text, media, ts)
|
|
VALUES (@message_id, @session_id, @source_id, @sender, @sender_id, @role, @text, @media, (
|
|
SELECT CASE
|
|
WHEN MAX(m.ts) IS NOT NULL AND MAX(m.ts) >= @ts THEN MAX(m.ts) + 1
|
|
ELSE @ts
|
|
END
|
|
FROM messages m WHERE m.session_id = @session_id
|
|
))
|
|
ON CONFLICT (session_id, message_id) DO NOTHING;
|
|
|
|
-- name: InsertMessageAt :exec
|
|
-- Rewriting history places records deliberately, so no clamp applies.
|
|
INSERT INTO messages (message_id, session_id, source_id, sender, sender_id, role, text, media, ts)
|
|
VALUES (@message_id, @session_id, @source_id, @sender, @sender_id, @role, @text, @media, @ts)
|
|
ON CONFLICT (session_id, message_id) DO NOTHING;
|
|
|
|
-- name: MessageID :one
|
|
SELECT message_id FROM messages WHERE session_id = $1 AND message_id = $2;
|
|
|
|
-- name: RecentMessages :many
|
|
SELECT m.message_id, m.source_id, m.sender, m.sender_id, m.role, m.text, m.ts, m.media::text AS media,
|
|
COALESCE(s.channel_id, '') AS channel_id, COALESCE(s.thread_id, '') AS thread_id
|
|
FROM (
|
|
SELECT msg.message_id, msg.source_id, msg.sender, msg.sender_id, msg.role, msg.text, msg.ts, msg.media::text AS media, msg.session_id
|
|
FROM messages msg WHERE msg.session_id = $1 ORDER BY msg.ts DESC LIMIT $2
|
|
) m
|
|
LEFT JOIN sessions s ON s.session_id = m.session_id
|
|
ORDER BY m.ts ASC;
|
|
|
|
-- name: DeleteRecentMessages :execrows
|
|
DELETE FROM messages WHERE id IN (
|
|
SELECT m.id FROM messages m WHERE m.session_id = $1 ORDER BY m.ts DESC LIMIT $2
|
|
);
|
|
|
|
-- name: DeleteMessagesByID :exec
|
|
DELETE FROM messages WHERE session_id = $1 AND message_id = ANY(sqlc.arg(ids)::text[]);
|
|
|
|
-- name: CountMessages :one
|
|
SELECT COUNT(*) FROM messages WHERE session_id = $1;
|
|
|
|
-- name: SearchMessagesCount :one
|
|
SELECT COUNT(*) FROM messages
|
|
WHERE session_id = $1 AND search @@ plainto_tsquery('simple', $2);
|
|
|
|
-- name: SearchMessagesPage :many
|
|
SELECT m.message_id, m.source_id, m.sender, m.sender_id, m.role, m.text, m.ts, m.media::text AS media,
|
|
COALESCE(s.channel_id, '') AS channel_id, COALESCE(s.thread_id, '') AS thread_id
|
|
FROM messages m
|
|
LEFT JOIN sessions s ON s.session_id = m.session_id
|
|
WHERE m.session_id = $1 AND m.search @@ plainto_tsquery('simple', $2)
|
|
ORDER BY ts_rank(m.search, plainto_tsquery('simple', $2)) DESC, m.ts DESC, m.id DESC
|
|
LIMIT $3 OFFSET $4;
|
|
|
|
-- name: SourceMessageTs :one
|
|
SELECT ts FROM messages
|
|
WHERE session_id = $1 AND message_id IN ($2, $3)
|
|
ORDER BY CASE WHEN message_id = $3 THEN 0 ELSE 1 END
|
|
LIMIT 1;
|
|
|
|
-- name: NextReplyAfterTs :one
|
|
SELECT sender, text FROM messages
|
|
WHERE session_id = $1 AND ts > $2 ORDER BY ts ASC LIMIT 1;
|
|
|
|
-- ── Turns ───────────────────────────────────────────────────────────────────
|
|
|
|
-- name: InsertTurn :execrows
|
|
INSERT INTO turns (turn_id, session_id, source_id, status, attempt, owner_id,
|
|
input_message_id, assistant_message_id, partial_text,
|
|
response_text, tool_calls, error, created_at, updated_at)
|
|
VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14)
|
|
ON CONFLICT (turn_id) DO NOTHING;
|
|
|
|
-- name: TurnByID :one
|
|
SELECT turn_id, session_id, source_id, status, attempt, owner_id,
|
|
input_message_id, assistant_message_id, partial_text,
|
|
response_text, tool_calls, error, created_at, updated_at
|
|
FROM turns WHERE turn_id = $1;
|
|
|
|
-- name: TurnAttemptOwner :one
|
|
SELECT attempt, owner_id FROM turns WHERE turn_id = $1;
|
|
|
|
-- name: FinalizeTurn :execrows
|
|
UPDATE turns SET status = $2, error = $3, updated_at = $4
|
|
WHERE turn_id = $1 AND attempt = $5 AND owner_id = $6;
|
|
|
|
-- name: RetryTurn :execrows
|
|
UPDATE turns SET status = $2, attempt = $3, owner_id = $4, error = $5, updated_at = $6
|
|
WHERE turn_id = $1 AND attempt = $7 AND owner_id = $8;
|
|
|
|
-- name: RecoverTurns :exec
|
|
UPDATE turns SET status = 'failed', error = 'recovered after process restart', updated_at = $1
|
|
WHERE status IN ('accepted', 'running', 'partial') AND owner_id <> $2;
|
|
|
|
-- name: SaveTurn :execrows
|
|
UPDATE turns SET
|
|
session_id = $2, source_id = $3, status = $4, attempt = $5, owner_id = $6,
|
|
input_message_id = $7, assistant_message_id = $8, partial_text = $9,
|
|
response_text = $10, tool_calls = $11, error = $12, created_at = $13, updated_at = $14
|
|
WHERE turn_id = $1 AND attempt = $5 AND owner_id = $6;
|
|
|
|
-- name: RecentTurns :many
|
|
SELECT turn_id, session_id, source_id, status, attempt, owner_id,
|
|
input_message_id, assistant_message_id, partial_text,
|
|
response_text, tool_calls, error, created_at, updated_at
|
|
FROM turns WHERE session_id = $1 ORDER BY created_at DESC LIMIT $2;
|
|
|
|
-- name: ListRecoverableTurns :many
|
|
SELECT turn_id, session_id, source_id, status, attempt, owner_id,
|
|
input_message_id, assistant_message_id, partial_text,
|
|
response_text, tool_calls, error, created_at, updated_at
|
|
FROM turns WHERE status IN ('accepted', 'running', 'partial') ORDER BY updated_at ASC;
|