@consiliency/agent-board-schema 1.2.0

package/tests/agent_board_inbox_reads.test.sql

@@ -0,0 +1,471 @@
+begin;
+
+select plan(14);
+
+select has_view('agent_board', 'v_agent_inbox', 'v_agent_inbox view exists');
+select has_view('agent_board', 'v_agent_inbox_counts', 'v_agent_inbox_counts view exists');
+select has_view('agent_board', 'v_board_directory', 'v_board_directory view exists');
+select has_view('agent_board', 'v_board_memberships', 'v_board_memberships view exists');
+select has_view('agent_board', 'v_board_feed', 'v_board_feed view exists');
+select has_view('agent_board', 'v_callback_endpoint_status', 'v_callback_endpoint_status view exists');
+select has_view('agent_board', 'v_callback_subscriptions', 'v_callback_subscriptions view exists');
+select has_view('agent_board', 'v_callback_delivery_health', 'v_callback_delivery_health view exists');
+select has_column('agent_board', 'v_agent_dashboard', 'inbox_unread_count', 'v_agent_dashboard exposes inbox_unread_count');
+select has_column('agent_board', 'v_agent_dashboard', 'inbox_pending_action_count', 'v_agent_dashboard exposes inbox_pending_action_count');
+
+select ok(
+  (
+    select count(*) = 9
+      from pg_class c
+     where c.relnamespace = 'agent_board'::regnamespace
+       and c.relname in (
+         'v_agent_inbox',
+         'v_agent_inbox_counts',
+         'v_board_directory',
+         'v_board_memberships',
+         'v_board_feed',
+         'v_callback_endpoint_status',
+         'v_callback_subscriptions',
+         'v_callback_delivery_health',
+         'v_agent_dashboard'
+       )
+       and c.reloptions @> array['security_invoker=true']
+  ),
+  'all inbox read views use security_invoker=true'
+);
+
+select ok(
+  (
+    select count(distinct table_name) = 9
+      from information_schema.role_table_grants
+     where table_schema = 'agent_board'
+       and table_name in (
+         'v_agent_inbox',
+         'v_agent_inbox_counts',
+         'v_board_directory',
+         'v_board_memberships',
+         'v_board_feed',
+         'v_callback_endpoint_status',
+         'v_callback_subscriptions',
+         'v_callback_delivery_health',
+         'v_agent_dashboard'
+       )
+       and grantee = 'authenticated'
+       and privilege_type = 'SELECT'
+  ),
+  'authenticated can read the inbox read-model view surface'
+);
+
+select ok(
+  (
+    select count(*) = 6
+      from pg_publication_tables
+     where pubname = 'supabase_realtime'
+       and schemaname = 'agent_board'
+       and tablename in (
+         'boards',
+         'board_memberships',
+         'inbox_items',
+         'callback_endpoints',
+         'callback_subscriptions',
+         'callback_delivery_attempts'
+       )
+  ),
+  'supabase_realtime includes the exact INBOXREAD publication additions'
+);
+
+select ok(
+  not exists (
+    select 1
+      from pg_publication_tables
+     where pubname = 'supabase_realtime'
+       and schemaname = 'agent_board'
+       and tablename = 'callback_outbox_events'
+  ),
+  'callback_outbox_events stays unpublished in INBOXREAD'
+);
+
+do $$
+declare
+  v_sender uuid := gen_random_uuid();
+  v_recipient uuid := gen_random_uuid();
+  v_board_member uuid := gen_random_uuid();
+  v_left_member uuid := gen_random_uuid();
+  v_thread uuid := gen_random_uuid();
+  v_direct_message uuid := gen_random_uuid();
+  v_message uuid := gen_random_uuid();
+  v_task uuid := gen_random_uuid();
+  v_board uuid;
+  v_joined_membership uuid;
+  v_subscribed_membership uuid;
+  v_left_membership uuid;
+  v_direct_recipient uuid;
+  v_task_recipient uuid;
+  v_board_recipient_one uuid;
+  v_board_recipient_two uuid;
+  v_endpoint uuid;
+  v_subscription uuid;
+  v_outbox uuid;
+begin
+  insert into agent_board.agents(id, agent_type, handle, display_name)
+  values
+    (v_sender, 'agent', 'test_inboxread_sender', 'Inbox Read Sender'),
+    (v_recipient, 'agent', 'test_inboxread_recipient', 'Inbox Read Recipient'),
+    (v_board_member, 'agent', 'test_inboxread_board_member', 'Inbox Read Board Member'),
+    (v_left_member, 'agent', 'test_inboxread_left_member', 'Inbox Read Left Member');
+
+  insert into agent_board.threads(id, thread_type, created_by_agent_id, subject)
+  values (v_thread, 'coordination', v_sender, 'Inbox read test thread');
+
+  insert into agent_board.tasks(
+    id,
+    thread_id,
+    created_by_agent_id,
+    assigned_agent_id,
+    title,
+    details,
+    status,
+    priority
+  )
+  values (
+    v_task,
+    v_thread,
+    v_sender,
+    v_recipient,
+    'Inbox read test task',
+    'Validate task-backed inbox reads',
+    'pending',
+    'high'
+  );
+
+  insert into agent_board.messages(id, thread_id, author_agent_id, message_sequence, message_type, body)
+  values
+    (v_direct_message, v_thread, v_sender, 1, 'comment', 'direct post body'),
+    (v_message, v_thread, v_sender, 2, 'comment', 'board post body');
+
+  insert into agent_board.boards(slug, name, description, created_by_agent_id)
+  values ('test-inboxread-board', 'Inbox Read Board', 'board used for inbox read tests', v_sender)
+  returning id into v_board;
+
+  insert into agent_board.board_memberships(board_id, agent_id, membership_state, created_by_agent_id)
+  values (v_board, v_recipient, 'joined', v_sender)
+  returning id into v_joined_membership;
+
+  insert into agent_board.board_memberships(board_id, agent_id, membership_state, created_by_agent_id)
+  values (v_board, v_board_member, 'subscribed', v_sender)
+  returning id into v_subscribed_membership;
+
+  insert into agent_board.board_memberships(board_id, agent_id, membership_state, created_by_agent_id, left_at)
+  values (v_board, v_left_member, 'left', v_sender, now())
+  returning id into v_left_membership;
+
+  insert into agent_board.delivery_recipients(delivery_mode, recipient_agent_id, source_kind, source_message_id)
+  values ('direct', v_recipient, 'message', v_direct_message)
+  returning id into v_direct_recipient;
+
+  insert into agent_board.inbox_items(
+    delivery_recipient_id,
+    recipient_agent_id,
+    delivery_mode,
+    source_kind,
+    source_message_id,
+    subject,
+    preview,
+    priority,
+    action_state,
+    visible_in_inbox,
+    visible_in_board_feed,
+    fetch_descriptor
+  )
+  values (
+    v_direct_recipient,
+    v_recipient,
+    'direct',
+    'message',
+    v_direct_message,
+    'Direct inbox subject',
+    'Direct preview',
+    'high',
+    'new',
+    true,
+    false,
+    jsonb_build_object('surface', 'thread', 'targetId', v_thread::text, 'view', 'agent_board.v_thread_feed', 'filters', jsonb_build_object(), 'reason', 'direct delivery')
+  );
+
+  insert into agent_board.delivery_recipients(delivery_mode, recipient_agent_id, source_kind, source_task_id)
+  values ('tasking', v_recipient, 'task', v_task)
+  returning id into v_task_recipient;
+
+  insert into agent_board.inbox_items(
+    delivery_recipient_id,
+    recipient_agent_id,
+    delivery_mode,
+    source_kind,
+    source_task_id,
+    subject,
+    preview,
+    priority,
+    action_state,
+    visible_in_inbox,
+    visible_in_board_feed,
+    fetch_descriptor
+  )
+  values (
+    v_task_recipient,
+    v_recipient,
+    'tasking',
+    'task',
+    v_task,
+    'Task inbox subject',
+    'Task preview',
+    'urgent',
+    'deferred',
+    true,
+    false,
+    jsonb_build_object('surface', 'task', 'targetId', v_task::text, 'view', 'agent_board.v_task_tree', 'filters', jsonb_build_object(), 'reason', 'tasking delivery')
+  );
+
+  insert into agent_board.delivery_recipients(
+    delivery_mode,
+    recipient_agent_id,
+    source_kind,
+    source_message_id,
+    board_id,
+    board_membership_id
+  )
+  values ('board', v_recipient, 'message', v_message, v_board, v_joined_membership)
+  returning id into v_board_recipient_one;
+
+  insert into agent_board.delivery_recipients(
+    delivery_mode,
+    recipient_agent_id,
+    source_kind,
+    source_message_id,
+    board_id,
+    board_membership_id
+  )
+  values ('board', v_board_member, 'message', v_message, v_board, v_subscribed_membership)
+  returning id into v_board_recipient_two;
+
+  insert into agent_board.inbox_items(
+    delivery_recipient_id,
+    recipient_agent_id,
+    board_id,
+    delivery_mode,
+    source_kind,
+    source_message_id,
+    subject,
+    preview,
+    priority,
+    action_state,
+    visible_in_inbox,
+    visible_in_board_feed,
+    fetch_descriptor
+  )
+  values
+    (
+      v_board_recipient_one,
+      v_recipient,
+      v_board,
+      'board',
+      'message',
+      v_message,
+      'Board inbox subject',
+      'Board preview',
+      'medium',
+      'read',
+      false,
+      true,
+      jsonb_build_object('surface', 'board', 'targetId', v_board::text, 'view', 'agent_board.v_board_feed', 'filters', jsonb_build_object(), 'reason', 'board delivery')
+    ),
+    (
+      v_board_recipient_two,
+      v_board_member,
+      v_board,
+      'board',
+      'message',
+      v_message,
+      'Board inbox subject',
+      'Board preview',
+      'medium',
+      'new',
+      true,
+      true,
+      jsonb_build_object('surface', 'board', 'targetId', v_board::text, 'view', 'agent_board.v_board_feed', 'filters', jsonb_build_object(), 'reason', 'board delivery')
+    );
+
+  insert into agent_board.callback_endpoints(
+    id,
+    owner_agent_id,
+    endpoint_url,
+    endpoint_status,
+    verification_requested_at,
+    verified_at,
+    last_failure_at
+  )
+  values (
+    gen_random_uuid(),
+    v_recipient,
+    'https://example.test/inbox-read-callback',
+    'verified',
+    now(),
+    now(),
+    now()
+  )
+  returning id into v_endpoint;
+
+  insert into agent_board.callback_subscriptions(
+    endpoint_id,
+    agent_id,
+    subscription_scope,
+    event_category,
+    board_id,
+    board_membership_id,
+    subscription_status
+  )
+  values (
+    v_endpoint,
+    v_recipient,
+    'board',
+    'board.post.delivered',
+    v_board,
+    v_joined_membership,
+    'active'
+  )
+  returning id into v_subscription;
+
+  insert into agent_board.callback_outbox_events(
+    endpoint_id,
+    subscription_id,
+    recipient_agent_id,
+    board_id,
+    event_category,
+    delivery_mode,
+    source_kind,
+    source_message_id,
+    idempotency_key,
+    subject,
+    preview,
+    priority,
+    fetch_descriptor,
+    outbox_status
+  )
+  values (
+    v_endpoint,
+    v_subscription,
+    v_recipient,
+    v_board,
+    'board.post.delivered',
+    'board',
+    'message',
+    v_message,
+    'test-inboxread-health',
+    'Board inbox subject',
+    'Board preview',
+    'medium',
+    jsonb_build_object('surface', 'board', 'targetId', v_board::text, 'view', 'agent_board.v_board_feed', 'filters', jsonb_build_object(), 'reason', 'board delivery'),
+    'retryable'
+  )
+  returning id into v_outbox;
+
+  insert into agent_board.callback_delivery_attempts(
+    outbox_event_id,
+    endpoint_id,
+    attempt_number,
+    attempt_outcome,
+    http_status,
+    error_summary,
+    started_at,
+    finished_at,
+    next_retry_at
+  )
+  values (
+    v_outbox,
+    v_endpoint,
+    1,
+    'retryable_failure',
+    503,
+    'temporary callback failure',
+    now() - interval '2 minutes',
+    now() - interval '1 minute',
+    now() + interval '5 minutes'
+  );
+
+  perform is(
+    (select count(*)::bigint from agent_board.v_agent_inbox where recipient_agent_id = v_recipient),
+    2::bigint,
+    'v_agent_inbox returns visible inbox rows only'
+  );
+
+  perform is(
+    (select unread_count from agent_board.v_agent_inbox_counts where recipient_agent_id = v_recipient),
+    1::bigint,
+    'v_agent_inbox_counts computes unread_count from new and restored rows'
+  );
+
+  perform is(
+    (select pending_action_count from agent_board.v_agent_inbox_counts where recipient_agent_id = v_recipient),
+    2::bigint,
+    'v_agent_inbox_counts computes pending_action_count from actionable rows'
+  );
+
+  perform is(
+    (select active_member_count from agent_board.v_board_directory where board_id = v_board),
+    2::bigint,
+    'v_board_directory counts joined and subscribed members only'
+  );
+
+  perform is(
+    (select count(*)::bigint from agent_board.v_board_feed where board_id = v_board and message_id = v_message),
+    1::bigint,
+    'v_board_feed deduplicates a canonical board post across recipient fan-out'
+  );
+
+  perform is(
+    (select active_subscription_count from agent_board.v_callback_endpoint_status where endpoint_id = v_endpoint),
+    1::bigint,
+    'v_callback_endpoint_status counts active subscriptions'
+  );
+
+  perform ok(
+    exists (
+      select 1
+        from agent_board.v_callback_subscriptions
+       where subscription_id = v_subscription
+         and board_slug = 'test-inboxread-board'
+    ),
+    'v_callback_subscriptions exposes board-scoped subscription metadata'
+  );
+
+  perform is(
+    (select latest_attempt_outcome from agent_board.v_callback_delivery_health where subscription_id = v_subscription),
+    'retryable_failure',
+    'v_callback_delivery_health anchors on the latest delivery attempt'
+  );
+
+  perform ok(
+    (
+      select latest_next_retry_at is not null
+        from agent_board.v_callback_delivery_health
+       where subscription_id = v_subscription
+    ),
+    'v_callback_delivery_health exposes retry scheduling metadata'
+  );
+
+  perform is(
+    (select inbox_unread_count from agent_board.v_agent_dashboard where agent_id = v_recipient),
+    1::bigint,
+    'v_agent_dashboard exposes compact unread inbox counts'
+  );
+
+  perform is(
+    (select inbox_pending_action_count from agent_board.v_agent_dashboard where agent_id = v_recipient),
+    2::bigint,
+    'v_agent_dashboard exposes compact pending-action inbox counts'
+  );
+end;
+$$;
+
+select * from finish();
+
+rollback;