@consiliency/agent-board-schema 1.2.0

package/migrations/20260504000000_agent_board_read_models.sql

@@ -0,0 +1,206 @@
+create or replace view agent_board.v_thread_feed
+with (security_invoker = true)
+as
+select
+  m.thread_id,
+  m.id as message_id,
+  m.message_sequence,
+  m.created_at as message_created_at,
+  m.author_agent_id,
+  a.handle as author_handle,
+  a.display_name as author_display_name,
+  m.message_type,
+  m.body,
+  m.task_id
+from agent_board.messages m
+join agent_board.agents a on a.id = m.author_agent_id;
+
+create or replace view agent_board.v_task_tree
+with (security_invoker = true)
+as
+select
+  coalesce(t.root_task_id, t.id) as root_task_id,
+  t.id as task_id,
+  t.parent_task_id,
+  t.thread_id,
+  t.created_by_agent_id,
+  t.assigned_agent_id,
+  assigned.handle as assigned_agent_handle,
+  t.status,
+  t.priority,
+  t.orchestration_mode,
+  t.title,
+  t.details,
+  t.created_at,
+  t.updated_at,
+  t.completed_at,
+  latest.event_sequence as latest_event_sequence,
+  latest.event_type as latest_event_type,
+  latest.payload->>'kind' as latest_event_kind
+from agent_board.tasks t
+left join agent_board.agents assigned on assigned.id = t.assigned_agent_id
+left join lateral (
+  select te.event_sequence, te.event_type, te.payload
+    from agent_board.task_events te
+   where te.task_id = t.id
+   order by te.event_sequence desc
+   limit 1
+) latest on true;
+
+create or replace view agent_board.v_active_claims
+with (security_invoker = true)
+as
+select
+  c.id as claim_id,
+  c.task_id,
+  c.thread_id,
+  c.agent_id,
+  a.handle as agent_handle,
+  c.resource_kind,
+  c.resource_key,
+  c.lease_token,
+  c.lease_expires_at,
+  c.created_at,
+  c.updated_at,
+  t.status as task_status
+from agent_board.claims c
+join agent_board.agents a on a.id = c.agent_id
+left join agent_board.tasks t on t.id = c.task_id
+where c.status = 'active'
+  and c.released_at is null
+  and c.lease_expires_at > now();
+
+create or replace view agent_board.v_open_escalations
+with (security_invoker = true)
+as
+select
+  e.id as escalation_id,
+  e.thread_id,
+  e.task_id,
+  e.raised_by_agent_id,
+  raised.handle as raised_by_handle,
+  e.assigned_agent_id,
+  assigned.handle as assigned_agent_handle,
+  e.escalation_type,
+  e.severity,
+  e.status,
+  e.summary,
+  e.details,
+  e.created_at,
+  e.updated_at,
+  e.acknowledged_at,
+  t.status as task_status
+from agent_board.escalations e
+join agent_board.agents raised on raised.id = e.raised_by_agent_id
+left join agent_board.agents assigned on assigned.id = e.assigned_agent_id
+left join agent_board.tasks t on t.id = e.task_id
+where e.status in ('open', 'acknowledged');
+
+create or replace view agent_board.v_agent_dashboard
+with (security_invoker = true)
+as
+select
+  a.id as agent_id,
+  a.handle,
+  a.display_name,
+  a.status as participant_status,
+  p.availability,
+  p.thread_id as presence_thread_id,
+  p.last_heartbeat_at,
+  p.expires_at as presence_expires_at,
+  coalesce(open_tasks.open_task_count, 0)::bigint as open_task_count,
+  coalesce(active_claims.active_claim_count, 0)::bigint as active_claim_count,
+  coalesce(open_escalations.assigned_open_escalation_count, 0)::bigint as assigned_open_escalation_count,
+  latest.task_id as latest_task_id,
+  latest.event_sequence as latest_task_event_sequence,
+  latest.event_type as latest_task_event_type,
+  latest.payload->>'kind' as latest_task_event_kind,
+  latest.updated_at as latest_task_updated_at
+from agent_board.agents a
+left join agent_board.presence p on p.agent_id = a.id
+left join lateral (
+  select count(*) as open_task_count
+    from agent_board.tasks t
+   where t.assigned_agent_id = a.id
+     and t.status in ('pending', 'in_progress', 'blocked')
+) open_tasks on true
+left join lateral (
+  select count(*) as active_claim_count
+    from agent_board.claims c
+   where c.agent_id = a.id
+     and c.status = 'active'
+     and c.released_at is null
+     and c.lease_expires_at > now()
+) active_claims on true
+left join lateral (
+  select count(*) as assigned_open_escalation_count
+    from agent_board.escalations e
+   where e.assigned_agent_id = a.id
+     and e.status in ('open', 'acknowledged')
+) open_escalations on true
+left join lateral (
+  select t.id as task_id, te.event_sequence, te.event_type, te.payload, t.updated_at
+    from agent_board.tasks t
+    left join agent_board.task_events te on te.task_id = t.id
+   where t.assigned_agent_id = a.id or t.created_by_agent_id = a.id
+   order by t.updated_at desc, te.event_sequence desc nulls last
+   limit 1
+) latest on true;
+
+grant usage on schema agent_board to service_role;
+grant select on all tables in schema agent_board to service_role;
+grant select on agent_board.v_thread_feed, agent_board.v_task_tree, agent_board.v_active_claims, agent_board.v_open_escalations, agent_board.v_agent_dashboard to authenticated;
+
+alter table agent_board.agents enable row level security;
+alter table agent_board.threads enable row level security;
+alter table agent_board.messages enable row level security;
+alter table agent_board.tasks enable row level security;
+alter table agent_board.task_events enable row level security;
+alter table agent_board.claims enable row level security;
+alter table agent_board.delegations enable row level security;
+alter table agent_board.artifacts enable row level security;
+alter table agent_board.conflicts enable row level security;
+alter table agent_board.escalations enable row level security;
+alter table agent_board.read_receipts enable row level security;
+alter table agent_board.presence enable row level security;
+
+do $$
+declare
+  v_table text;
+begin
+  foreach v_table in array array[
+    'agents',
+    'threads',
+    'messages',
+    'tasks',
+    'task_events',
+    'claims',
+    'delegations',
+    'artifacts',
+    'conflicts',
+    'escalations',
+    'read_receipts',
+    'presence'
+  ]
+  loop
+    execute format('drop policy if exists %I on agent_board.%I', 'agent_board_service_all_' || v_table, v_table);
+    execute format('create policy %I on agent_board.%I as permissive for all to service_role using (true) with check (true)', 'agent_board_service_all_' || v_table, v_table);
+  end loop;
+end;
+$$;
+
+do $$
+declare
+  v_table text;
+begin
+  foreach v_table in array array['messages', 'task_events', 'tasks', 'claims', 'delegations', 'conflicts', 'escalations', 'presence']
+  loop
+    begin
+      execute format('alter publication supabase_realtime add table agent_board.%I', v_table);
+    exception
+      when duplicate_object then null;
+      when undefined_object then null;
+    end;
+  end loop;
+end;
+$$;

package/migrations/20260505000000_agent_board_inbox_schema.sql

@@ -0,0 +1,341 @@
+create table if not exists agent_board.boards (
+  id uuid primary key default gen_random_uuid(),
+  slug text not null unique,
+  name text not null,
+  description text,
+  created_by_agent_id uuid not null references agent_board.agents(id),
+  status text not null default 'active' check (status in ('active', 'archived')),
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+comment on table agent_board.boards is 'Named opt-in coordination surfaces for shared board delivery and board feeds.';
+
+create table if not exists agent_board.board_memberships (
+  id uuid primary key default gen_random_uuid(),
+  board_id uuid not null references agent_board.boards(id) on delete cascade,
+  agent_id uuid not null references agent_board.agents(id) on delete cascade,
+  membership_state text not null default 'joined' check (membership_state in ('joined', 'subscribed', 'left', 'removed')),
+  created_by_agent_id uuid references agent_board.agents(id),
+  left_at timestamptz,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  constraint board_memberships_state_left_at check (
+    (membership_state in ('joined', 'subscribed') and left_at is null)
+    or (membership_state in ('left', 'removed') and left_at is not null)
+  ),
+  constraint board_memberships_identity_unique unique (id, board_id, agent_id)
+);
+
+comment on table agent_board.board_memberships is 'One agent membership state per board; joined and subscribed are active delivery states.';
+
+create unique index if not exists idx_agent_board_board_memberships_active_unique
+  on agent_board.board_memberships(board_id, agent_id)
+  where membership_state in ('joined', 'subscribed');
+
+create index if not exists idx_agent_board_board_memberships_board_state
+  on agent_board.board_memberships(board_id, membership_state, created_at desc);
+
+create table if not exists agent_board.delivery_recipients (
+  id uuid primary key default gen_random_uuid(),
+  delivery_mode text not null check (delivery_mode in ('direct', 'multicast', 'board', 'tasking')),
+  recipient_agent_id uuid not null references agent_board.agents(id) on delete cascade,
+  source_kind text not null check (source_kind in ('message', 'task', 'delegation')),
+  source_message_id uuid references agent_board.messages(id) on delete cascade,
+  source_task_id uuid references agent_board.tasks(id) on delete cascade,
+  source_delegation_id uuid references agent_board.delegations(id) on delete cascade,
+  board_id uuid references agent_board.boards(id) on delete cascade,
+  board_membership_id uuid,
+  canonical_source_key text generated always as (
+    case source_kind
+      when 'message' then 'message:' || source_message_id::text
+      when 'task' then 'task:' || source_task_id::text
+      when 'delegation' then 'delegation:' || source_delegation_id::text
+    end
+  ) stored,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  constraint delivery_recipients_source_shape check (
+    (source_kind = 'message' and source_message_id is not null and source_task_id is null and source_delegation_id is null)
+    or (source_kind = 'task' and source_message_id is null and source_task_id is not null and source_delegation_id is null)
+    or (source_kind = 'delegation' and source_message_id is null and source_task_id is null and source_delegation_id is not null)
+  ),
+  constraint delivery_recipients_board_scope check (
+    (
+      delivery_mode in ('direct', 'multicast')
+      and board_id is null
+      and board_membership_id is null
+    )
+    or (
+      delivery_mode in ('board', 'tasking')
+      and (
+        (board_id is null and board_membership_id is null)
+        or (board_id is not null and board_membership_id is not null)
+      )
+    )
+  ),
+  constraint delivery_recipients_board_membership_fkey
+    foreign key (board_membership_id, board_id, recipient_agent_id)
+    references agent_board.board_memberships(id, board_id, agent_id)
+);
+
+comment on table agent_board.delivery_recipients is 'Append-only canonical routing rows for direct, multicast, board, and tasking recipients.';
+
+create unique index if not exists idx_agent_board_delivery_recipients_unique_source_recipient
+  on agent_board.delivery_recipients(recipient_agent_id, canonical_source_key);
+
+create index if not exists idx_agent_board_delivery_recipients_board_feed
+  on agent_board.delivery_recipients(board_id, created_at desc)
+  where board_id is not null;
+
+create table if not exists agent_board.inbox_items (
+  id uuid primary key default gen_random_uuid(),
+  delivery_recipient_id uuid not null unique references agent_board.delivery_recipients(id) on delete cascade,
+  recipient_agent_id uuid not null references agent_board.agents(id) on delete cascade,
+  board_id uuid references agent_board.boards(id) on delete cascade,
+  delivery_mode text not null check (delivery_mode in ('direct', 'multicast', 'board', 'tasking')),
+  source_kind text not null check (source_kind in ('message', 'task', 'delegation')),
+  source_message_id uuid references agent_board.messages(id) on delete cascade,
+  source_task_id uuid references agent_board.tasks(id) on delete cascade,
+  source_delegation_id uuid references agent_board.delegations(id) on delete cascade,
+  subject text not null,
+  preview text,
+  priority text not null default 'medium' check (priority in ('low', 'medium', 'high', 'urgent')),
+  action_state text not null default 'new' check (action_state in ('new', 'read', 'acknowledged', 'deferred', 'dismissed', 'restored')),
+  visible_in_inbox boolean not null default true,
+  visible_in_board_feed boolean not null default false,
+  fetch_descriptor jsonb not null default '{}'::jsonb,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  constraint inbox_items_source_shape check (
+    (source_kind = 'message' and source_message_id is not null and source_task_id is null and source_delegation_id is null)
+    or (source_kind = 'task' and source_message_id is null and source_task_id is not null and source_delegation_id is null)
+    or (source_kind = 'delegation' and source_message_id is null and source_task_id is null and source_delegation_id is not null)
+  ),
+  constraint inbox_items_visibility_shape check (
+    (visible_in_inbox or visible_in_board_feed)
+    and (not visible_in_board_feed or board_id is not null)
+  ),
+  constraint inbox_items_board_scope check (
+    (
+      delivery_mode in ('direct', 'multicast')
+      and board_id is null
+      and visible_in_board_feed = false
+    )
+    or delivery_mode in ('board', 'tasking')
+  ),
+  constraint inbox_items_fetch_descriptor_object check (jsonb_typeof(fetch_descriptor) = 'object')
+);
+
+comment on table agent_board.inbox_items is 'Compact per-recipient triage rows with bounded metadata and canonical fetch descriptors.';
+
+create index if not exists idx_agent_board_inbox_items_agent_triage
+  on agent_board.inbox_items(recipient_agent_id, updated_at desc, created_at desc);
+
+create index if not exists idx_agent_board_inbox_items_agent_pending
+  on agent_board.inbox_items(recipient_agent_id, updated_at desc)
+  where action_state in ('new', 'restored', 'deferred');
+
+create index if not exists idx_agent_board_inbox_items_board_feed
+  on agent_board.inbox_items(board_id, created_at desc)
+  where visible_in_board_feed = true;
+
+create table if not exists agent_board.callback_endpoints (
+  id uuid primary key default gen_random_uuid(),
+  owner_agent_id uuid not null references agent_board.agents(id) on delete cascade,
+  endpoint_url text not null,
+  endpoint_status text not null default 'pending_verification' check (endpoint_status in ('pending_verification', 'verified', 'disabled')),
+  signing_key_version integer not null default 1 check (signing_key_version > 0),
+  verification_requested_at timestamptz,
+  verified_at timestamptz,
+  disabled_at timestamptz,
+  disabled_reason text,
+  last_delivery_at timestamptz,
+  last_failure_at timestamptz,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  constraint callback_endpoints_status_disabled_shape check (
+    (endpoint_status = 'disabled' and disabled_at is not null)
+    or (endpoint_status <> 'disabled' and disabled_at is null)
+  ),
+  constraint callback_endpoints_url_unique unique (owner_agent_id, endpoint_url)
+);
+
+comment on table agent_board.callback_endpoints is 'Durable callback endpoint registration with verification and disablement metadata.';
+
+create table if not exists agent_board.callback_subscriptions (
+  id uuid primary key default gen_random_uuid(),
+  endpoint_id uuid not null references agent_board.callback_endpoints(id) on delete cascade,
+  agent_id uuid not null references agent_board.agents(id) on delete cascade,
+  subscription_scope text not null check (subscription_scope in ('own_inbox', 'board')),
+  event_category text not null check (event_category in ('inbox.item.delivered', 'inbox.item.updated', 'board.post.delivered', 'board.post.updated')),
+  board_id uuid references agent_board.boards(id) on delete cascade,
+  board_membership_id uuid,
+  subscription_status text not null default 'active' check (subscription_status in ('active', 'disabled')),
+  disabled_at timestamptz,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  constraint callback_subscriptions_scope_shape check (
+    (
+      subscription_scope = 'own_inbox'
+      and event_category in ('inbox.item.delivered', 'inbox.item.updated')
+      and board_id is null
+      and board_membership_id is null
+    )
+    or (
+      subscription_scope = 'board'
+      and event_category in ('board.post.delivered', 'board.post.updated')
+      and board_id is not null
+      and board_membership_id is not null
+    )
+  ),
+  constraint callback_subscriptions_status_disabled_shape check (
+    (subscription_status = 'disabled' and disabled_at is not null)
+    or (subscription_status <> 'disabled' and disabled_at is null)
+  ),
+  constraint callback_subscriptions_board_membership_fkey
+    foreign key (board_membership_id, board_id, agent_id)
+    references agent_board.board_memberships(id, board_id, agent_id)
+);
+
+comment on table agent_board.callback_subscriptions is 'Own-inbox and board-scoped callback intent for one endpoint.';
+
+create unique index if not exists idx_agent_board_callback_subscriptions_active_unique
+  on agent_board.callback_subscriptions(endpoint_id, agent_id, event_category, coalesce(board_id, '00000000-0000-0000-0000-000000000000'::uuid))
+  where subscription_status = 'active';
+
+create index if not exists idx_agent_board_callback_subscriptions_board
+  on agent_board.callback_subscriptions(board_id, subscription_status, created_at desc)
+  where board_id is not null;
+
+create table if not exists agent_board.callback_outbox_events (
+  id uuid primary key default gen_random_uuid(),
+  endpoint_id uuid not null references agent_board.callback_endpoints(id) on delete cascade,
+  subscription_id uuid not null references agent_board.callback_subscriptions(id) on delete cascade,
+  recipient_agent_id uuid not null references agent_board.agents(id) on delete cascade,
+  inbox_item_id uuid references agent_board.inbox_items(id) on delete set null,
+  board_id uuid references agent_board.boards(id) on delete cascade,
+  event_category text not null check (event_category in ('inbox.item.delivered', 'inbox.item.updated', 'board.post.delivered', 'board.post.updated')),
+  delivery_mode text not null check (delivery_mode in ('direct', 'multicast', 'board', 'tasking')),
+  source_kind text not null check (source_kind in ('message', 'task', 'delegation')),
+  source_message_id uuid references agent_board.messages(id) on delete cascade,
+  source_task_id uuid references agent_board.tasks(id) on delete cascade,
+  source_delegation_id uuid references agent_board.delegations(id) on delete cascade,
+  idempotency_key text not null unique,
+  subject text,
+  preview text,
+  priority text not null default 'medium' check (priority in ('low', 'medium', 'high', 'urgent')),
+  fetch_descriptor jsonb not null default '{}'::jsonb,
+  outbox_status text not null default 'pending' check (outbox_status in ('pending', 'delivering', 'retryable', 'delivered', 'failed', 'disabled')),
+  available_at timestamptz not null default now(),
+  locked_at timestamptz,
+  delivered_at timestamptz,
+  last_error_at timestamptz,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  constraint callback_outbox_events_source_shape check (
+    (source_kind = 'message' and source_message_id is not null and source_task_id is null and source_delegation_id is null)
+    or (source_kind = 'task' and source_message_id is null and source_task_id is not null and source_delegation_id is null)
+    or (source_kind = 'delegation' and source_message_id is null and source_task_id is null and source_delegation_id is not null)
+  ),
+  constraint callback_outbox_events_scope_shape check (
+    (
+      event_category in ('inbox.item.delivered', 'inbox.item.updated')
+      and board_id is null
+    )
+    or (
+      event_category in ('board.post.delivered', 'board.post.updated')
+      and board_id is not null
+    )
+  ),
+  constraint callback_outbox_events_fetch_descriptor_object check (jsonb_typeof(fetch_descriptor) = 'object')
+);
+
+comment on table agent_board.callback_outbox_events is 'Durable callback notification intent written before any external delivery attempt.';
+
+create index if not exists idx_agent_board_callback_outbox_events_poll
+  on agent_board.callback_outbox_events(outbox_status, available_at, created_at)
+  where outbox_status in ('pending', 'retryable');
+
+create index if not exists idx_agent_board_callback_outbox_events_retry
+  on agent_board.callback_outbox_events(available_at, updated_at desc)
+  where outbox_status = 'retryable';
+
+create table if not exists agent_board.callback_delivery_attempts (
+  id uuid primary key default gen_random_uuid(),
+  outbox_event_id uuid not null references agent_board.callback_outbox_events(id) on delete cascade,
+  endpoint_id uuid not null references agent_board.callback_endpoints(id) on delete cascade,
+  attempt_number integer not null check (attempt_number > 0),
+  attempt_outcome text not null check (attempt_outcome in ('delivered', 'retryable_failure', 'terminal_failure', 'endpoint_disabled')),
+  http_status integer check (http_status is null or (http_status >= 100 and http_status <= 599)),
+  error_summary text,
+  started_at timestamptz not null default now(),
+  finished_at timestamptz,
+  next_retry_at timestamptz,
+  metadata jsonb not null default '{}'::jsonb,
+  created_at timestamptz not null default now(),
+  constraint callback_delivery_attempts_retry_shape check (
+    (attempt_outcome = 'retryable_failure' and next_retry_at is not null)
+    or (attempt_outcome <> 'retryable_failure' and next_retry_at is null)
+  ),
+  constraint callback_delivery_attempts_outbox_attempt_unique unique (outbox_event_id, attempt_number)
+);
+
+comment on table agent_board.callback_delivery_attempts is 'Append-only callback delivery attempts for retries, successes, and terminal failures.';
+
+create index if not exists idx_agent_board_callback_delivery_attempts_retry_schedule
+  on agent_board.callback_delivery_attempts(next_retry_at, created_at)
+  where attempt_outcome = 'retryable_failure';
+
+create index if not exists idx_agent_board_callback_delivery_attempts_outbox
+  on agent_board.callback_delivery_attempts(outbox_event_id, attempt_number desc);
+
+grant select on agent_board.boards,
+  agent_board.board_memberships,
+  agent_board.delivery_recipients,
+  agent_board.inbox_items,
+  agent_board.callback_endpoints,
+  agent_board.callback_subscriptions,
+  agent_board.callback_outbox_events,
+  agent_board.callback_delivery_attempts
+to service_role;
+
+alter table agent_board.boards enable row level security;
+alter table agent_board.board_memberships enable row level security;
+alter table agent_board.delivery_recipients enable row level security;
+alter table agent_board.inbox_items enable row level security;
+alter table agent_board.callback_endpoints enable row level security;
+alter table agent_board.callback_subscriptions enable row level security;
+alter table agent_board.callback_outbox_events enable row level security;
+alter table agent_board.callback_delivery_attempts enable row level security;
+
+do $$
+declare
+  v_table text;
+begin
+  foreach v_table in array array[
+    'boards',
+    'board_memberships',
+    'delivery_recipients',
+    'inbox_items',
+    'callback_endpoints',
+    'callback_subscriptions',
+    'callback_outbox_events',
+    'callback_delivery_attempts'
+  ]
+  loop
+    execute format('drop policy if exists %I on agent_board.%I', 'agent_board_service_all_' || v_table, v_table);
+    execute format(
+      'create policy %I on agent_board.%I as permissive for all to service_role using (true) with check (true)',
+      'agent_board_service_all_' || v_table,
+      v_table
+    );
+  end loop;
+end;
+$$;