@consiliency/agent-board-schema 1.60.0 → 1.63.0

package/tests/isolation/expected/session_identity_renew_revoke_key_gate.out

@@ -0,0 +1,138 @@
+Parsed test spec with 4 sessions
+
+starting permutation: key_begin key_hold revoke_begin revoke renew_begin renew key_commit revoke_commit renew_commit check
+step key_begin: BEGIN;
+step key_hold: 
+  select 1 as held from agent_board.agent_signing_keys
+  where agent_id = (select id from agent_board.agents where handle = 'sid-renew-child') for update;
+
+held
+----
+   1
+(1 row)
+
+step revoke_begin: 
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '81000000-0000-4000-8000-000000000001';
+
+step revoke: 
+  select agent_board.revoke_session_identity((select id from agent_board.agents where handle = 'sid-renew-child'));
+ <waiting ...>
+step renew_begin: 
+  BEGIN;
+  select set_config('request.jwt.claim.sub', (select auth_user_id::text from agent_board.agents where handle = 'sid-renew-child'), true) is not null as holder_forwarded;
+  SET LOCAL ROLE service_role;
+  SET LOCAL "request.jwt.claim.role" = 'service_role';
+  SET LOCAL "request.jwt.claim.identity_lease_epoch" = '0';
+
+holder_forwarded
+----------------
+t               
+(1 row)
+
+step renew: 
+  select agent_board.renew_session_identity((select id from agent_board.agents where handle = 'sid-renew-child'), 'approved');
+ <waiting ...>
+step key_commit: COMMIT;
+step revoke: <... completed>
+revoke_session_identity
+-----------------------
+                       
+(1 row)
+
+step revoke_commit: COMMIT;
+step renew: <... completed>
+ERROR:  identity_tombstoned
+step renew_commit: COMMIT;
+step check: 
+  select si.tombstone_reason, si.credential_epoch, a.status, g.revoked_at is not null as grant_revoked,
+    g.last_renewed_at is not null as renewal_preceded_revoke,
+    (select count(*) from agent_board.fleet_revocation_events e where e.subject_id = a.id) as permanent_revocations,
+    (select count(*) from agent_board.agent_signing_keys k where k.agent_id = a.id and k.status <> 'revoked') as active_keys
+  from agent_board.agents a join agent_board.session_identities si on si.agent_id = a.id
+    join agent_board.delegation_grants g on g.child_agent_id = a.id where a.handle = 'sid-renew-child';
+  select bool_and(expires_at <= issued_at + interval '900 seconds') as bounded_pre_revoke_tokens
+  from agent_board.nonfleet_sessions where agent_id = (select id from agent_board.agents where handle = 'sid-renew-child');
+
+tombstone_reason|credential_epoch|status |grant_revoked|renewal_preceded_revoke|permanent_revocations|active_keys
+----------------+----------------+-------+-------------+-----------------------+---------------------+-----------
+revoked         |               1|revoked|t            |f                      |                    1|          0
+(1 row)
+
+bounded_pre_revoke_tokens
+-------------------------
+t                        
+(1 row)
+
+
+starting permutation: key_begin key_hold renew_begin renew revoke_begin revoke key_commit renew_commit revoke_commit check
+step key_begin: BEGIN;
+step key_hold: 
+  select 1 as held from agent_board.agent_signing_keys
+  where agent_id = (select id from agent_board.agents where handle = 'sid-renew-child') for update;
+
+held
+----
+   1
+(1 row)
+
+step renew_begin: 
+  BEGIN;
+  select set_config('request.jwt.claim.sub', (select auth_user_id::text from agent_board.agents where handle = 'sid-renew-child'), true) is not null as holder_forwarded;
+  SET LOCAL ROLE service_role;
+  SET LOCAL "request.jwt.claim.role" = 'service_role';
+  SET LOCAL "request.jwt.claim.identity_lease_epoch" = '0';
+
+holder_forwarded
+----------------
+t               
+(1 row)
+
+step renew: 
+  select agent_board.renew_session_identity((select id from agent_board.agents where handle = 'sid-renew-child'), 'approved');
+
+renew_session_identity
+----------------------
+                      
+(1 row)
+
+step revoke_begin: 
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '81000000-0000-4000-8000-000000000001';
+
+step revoke: 
+  select agent_board.revoke_session_identity((select id from agent_board.agents where handle = 'sid-renew-child'));
+ <waiting ...>
+step key_commit: COMMIT;
+step renew_commit: COMMIT;
+step revoke: <... completed>
+revoke_session_identity
+-----------------------
+                       
+(1 row)
+
+step revoke_commit: COMMIT;
+step check: 
+  select si.tombstone_reason, si.credential_epoch, a.status, g.revoked_at is not null as grant_revoked,
+    g.last_renewed_at is not null as renewal_preceded_revoke,
+    (select count(*) from agent_board.fleet_revocation_events e where e.subject_id = a.id) as permanent_revocations,
+    (select count(*) from agent_board.agent_signing_keys k where k.agent_id = a.id and k.status <> 'revoked') as active_keys
+  from agent_board.agents a join agent_board.session_identities si on si.agent_id = a.id
+    join agent_board.delegation_grants g on g.child_agent_id = a.id where a.handle = 'sid-renew-child';
+  select bool_and(expires_at <= issued_at + interval '900 seconds') as bounded_pre_revoke_tokens
+  from agent_board.nonfleet_sessions where agent_id = (select id from agent_board.agents where handle = 'sid-renew-child');
+
+tombstone_reason|credential_epoch|status |grant_revoked|renewal_preceded_revoke|permanent_revocations|active_keys
+----------------+----------------+-------+-------------+-----------------------+---------------------+-----------
+revoked         |               1|revoked|t            |t                      |                    1|          0
+(1 row)
+
+bounded_pre_revoke_tokens
+-------------------------
+t                        
+(1 row)
+

package/tests/isolation/expected/session_identity_tombstone_onboarding.out

@@ -0,0 +1,247 @@
+Parsed test spec with 3 sessions
+
+starting permutation: o_begin o_advisory o_agents t_begin t_tomb o_membership o_commit t_commit check
+step o_begin: BEGIN; SET LOCAL "request.jwt.claim.role" = 'service_role';
+step o_advisory: 
+  select agent_board._lock_board_authority_ceiling('85000000-0000-4000-8000-000000000002') is null as advisory_taken;
+
+advisory_taken
+--------------
+f             
+(1 row)
+
+step o_agents: 
+  select count(*)::int as locked_agents from (
+    select 1 from agent_board.agents where id='85000000-0000-4000-8000-000000000001' for update) s;
+
+locked_agents
+-------------
+            1
+(1 row)
+
+step t_begin: BEGIN; SET LOCAL "request.jwt.claim.role" = 'service_role';
+step t_tomb: 
+  select first from agent_board.tombstone_delegate_instance(
+    'sid_ti_instance_00001','urn:sid-ti:issuer','sid-ti-owner','owner_revoked');
+ <waiting ...>
+step o_membership: 
+  select count(*)::int as locked_memberships from (
+    select 1 from agent_board.board_memberships
+      where board_id='85000000-0000-4000-8000-000000000002'
+        and agent_id='85000000-0000-4000-8000-000000000001' for update) s;
+
+locked_memberships
+------------------
+                 1
+(1 row)
+
+step o_commit: COMMIT;
+step t_tomb: <... completed>
+first
+-----
+t    
+(1 row)
+
+step t_commit: COMMIT;
+step check: 
+  select tombstoned_at is not null as instance_tombstoned from agent_board.delegate_instances
+    where instance_id='sid_ti_instance_00001';
+  select status from agent_board.agents where id='85000000-0000-4000-8000-000000000001';
+  select membership_state from agent_board.board_memberships
+    where board_id='85000000-0000-4000-8000-000000000002'
+      and agent_id='85000000-0000-4000-8000-000000000001';
+  select si.tombstoned_at is not null as child_tombstoned,si.credential_epoch,
+    (select count(*) from agent_board.agent_credentials ac where ac.agent_id=si.agent_id and ac.revoked_at is null) as live_credentials
+    from agent_board.session_identities si join agent_board.agents a on a.id=si.agent_id where a.handle='sid-ti-child';
+  select count(*) as withdrawal_events from agent_board.board_membership_events
+    where board_id='85000000-0000-4000-8000-000000000002' and event_kind='operator_removal';
+
+instance_tombstoned
+-------------------
+t                  
+(1 row)
+
+status 
+-------
+revoked
+(1 row)
+
+membership_state
+----------------
+left            
+(1 row)
+
+child_tombstoned|credential_epoch|live_credentials
+----------------+----------------+----------------
+t               |               1|               0
+(1 row)
+
+withdrawal_events
+-----------------
+                1
+(1 row)
+
+
+starting permutation: t_begin t_tomb o_begin o_advisory t_commit o_agents o_membership o_commit check
+step t_begin: BEGIN; SET LOCAL "request.jwt.claim.role" = 'service_role';
+step t_tomb: 
+  select first from agent_board.tombstone_delegate_instance(
+    'sid_ti_instance_00001','urn:sid-ti:issuer','sid-ti-owner','owner_revoked');
+
+first
+-----
+t    
+(1 row)
+
+step o_begin: BEGIN; SET LOCAL "request.jwt.claim.role" = 'service_role';
+step o_advisory: 
+  select agent_board._lock_board_authority_ceiling('85000000-0000-4000-8000-000000000002') is null as advisory_taken;
+ <waiting ...>
+step t_commit: COMMIT;
+step o_advisory: <... completed>
+advisory_taken
+--------------
+f             
+(1 row)
+
+step o_agents: 
+  select count(*)::int as locked_agents from (
+    select 1 from agent_board.agents where id='85000000-0000-4000-8000-000000000001' for update) s;
+
+locked_agents
+-------------
+            1
+(1 row)
+
+step o_membership: 
+  select count(*)::int as locked_memberships from (
+    select 1 from agent_board.board_memberships
+      where board_id='85000000-0000-4000-8000-000000000002'
+        and agent_id='85000000-0000-4000-8000-000000000001' for update) s;
+
+locked_memberships
+------------------
+                 1
+(1 row)
+
+step o_commit: COMMIT;
+step check: 
+  select tombstoned_at is not null as instance_tombstoned from agent_board.delegate_instances
+    where instance_id='sid_ti_instance_00001';
+  select status from agent_board.agents where id='85000000-0000-4000-8000-000000000001';
+  select membership_state from agent_board.board_memberships
+    where board_id='85000000-0000-4000-8000-000000000002'
+      and agent_id='85000000-0000-4000-8000-000000000001';
+  select si.tombstoned_at is not null as child_tombstoned,si.credential_epoch,
+    (select count(*) from agent_board.agent_credentials ac where ac.agent_id=si.agent_id and ac.revoked_at is null) as live_credentials
+    from agent_board.session_identities si join agent_board.agents a on a.id=si.agent_id where a.handle='sid-ti-child';
+  select count(*) as withdrawal_events from agent_board.board_membership_events
+    where board_id='85000000-0000-4000-8000-000000000002' and event_kind='operator_removal';
+
+instance_tombstoned
+-------------------
+t                  
+(1 row)
+
+status 
+-------
+revoked
+(1 row)
+
+membership_state
+----------------
+left            
+(1 row)
+
+child_tombstoned|credential_epoch|live_credentials
+----------------+----------------+----------------
+t               |               1|               0
+(1 row)
+
+withdrawal_events
+-----------------
+                1
+(1 row)
+
+
+starting permutation: o_begin o_advisory t_begin t_tomb o_agents o_membership o_commit t_commit check
+step o_begin: BEGIN; SET LOCAL "request.jwt.claim.role" = 'service_role';
+step o_advisory: 
+  select agent_board._lock_board_authority_ceiling('85000000-0000-4000-8000-000000000002') is null as advisory_taken;
+
+advisory_taken
+--------------
+f             
+(1 row)
+
+step t_begin: BEGIN; SET LOCAL "request.jwt.claim.role" = 'service_role';
+step t_tomb: 
+  select first from agent_board.tombstone_delegate_instance(
+    'sid_ti_instance_00001','urn:sid-ti:issuer','sid-ti-owner','owner_revoked');
+ <waiting ...>
+step o_agents: 
+  select count(*)::int as locked_agents from (
+    select 1 from agent_board.agents where id='85000000-0000-4000-8000-000000000001' for update) s;
+
+locked_agents
+-------------
+            1
+(1 row)
+
+step o_membership: 
+  select count(*)::int as locked_memberships from (
+    select 1 from agent_board.board_memberships
+      where board_id='85000000-0000-4000-8000-000000000002'
+        and agent_id='85000000-0000-4000-8000-000000000001' for update) s;
+
+locked_memberships
+------------------
+                 1
+(1 row)
+
+step o_commit: COMMIT;
+step t_tomb: <... completed>
+first
+-----
+t    
+(1 row)
+
+step t_commit: COMMIT;
+step check: 
+  select tombstoned_at is not null as instance_tombstoned from agent_board.delegate_instances
+    where instance_id='sid_ti_instance_00001';
+  select status from agent_board.agents where id='85000000-0000-4000-8000-000000000001';
+  select membership_state from agent_board.board_memberships
+    where board_id='85000000-0000-4000-8000-000000000002'
+      and agent_id='85000000-0000-4000-8000-000000000001';
+  select si.tombstoned_at is not null as child_tombstoned,si.credential_epoch,
+    (select count(*) from agent_board.agent_credentials ac where ac.agent_id=si.agent_id and ac.revoked_at is null) as live_credentials
+    from agent_board.session_identities si join agent_board.agents a on a.id=si.agent_id where a.handle='sid-ti-child';
+  select count(*) as withdrawal_events from agent_board.board_membership_events
+    where board_id='85000000-0000-4000-8000-000000000002' and event_kind='operator_removal';
+
+instance_tombstoned
+-------------------
+t                  
+(1 row)
+
+status 
+-------
+revoked
+(1 row)
+
+membership_state
+----------------
+left            
+(1 row)
+
+child_tombstoned|credential_epoch|live_credentials
+----------------+----------------+----------------
+t               |               1|               0
+(1 row)
+
+withdrawal_events
+-----------------
+                1
+(1 row)
+

package/tests/isolation/specs/grant_target_role_race.spec

@@ -0,0 +1,207 @@
+# #674 (plans/plan-674-grant-target-role.md §5.4): grant_board_role reads the target's
+# CURRENT role in ONE step-6 statement that locks the target's active row
+# FOR NO KEY UPDATE OF t and LEFT JOINs the grantor's active row unlocked. Every session
+# uses explicit BEGIN/COMMIT (or ROLLBACK); claims are transaction-local, so they are set
+# in the begin step. Authenticated grants pass no p_grantor_agent_id (the host shape).
+#
+# Board B (created by O). Roles at setup:
+#   O owner, A1 admin, M member, V observer, G member.
+# One admin-preset invite link on B, minted by O through create_invite_link (max_uses 5).
+#
+#   I-1  M redeems the admin link (rank-max lifts M to admin, row held) while A1 grants
+#        M -> observer. A1 BLOCKS at step 6; after M commits, the locked read sees admin,
+#        and C-B refuses (D6b). M stays admin.                         (pins M7)
+#   I-2  O removes M (update_board_membership, held) while A1 grants M -> observer. A1
+#        blocks; after O commits, A1 gets P0002 (no all-null row).
+#   I-3  O demotes A1 to member (held) while A1 grants M -> observer. A1 blocks on the
+#        board advisory lock; after O commits, step 6 sees A1 as member and C-A refuses
+#        (D6a). Reverse order: both succeed.
+#   I-4  O posts on B (post_board_message fan-out inserts delivery_recipients naming M's
+#        membership: FOR KEY SHARE on M's row, held) while O's second session grants
+#        M -> observer. The grant completes WITHOUT blocking.          (pins M7b)
+#   I-5  G redeems the admin link (G's own row raised to admin, held) while G's second
+#        session grants V -> member. It does NOT block (g is unlocked), reads G's committed
+#        role member, and C-A refuses (D6a). After G commits, a retry succeeds.
+
+setup
+{
+  insert into auth.users(id) values
+    ('67410000-0000-4000-8000-000000000001'),
+    ('67410000-0000-4000-8000-000000000002'),
+    ('67410000-0000-4000-8000-000000000003'),
+    ('67410000-0000-4000-8000-000000000004'),
+    ('67410000-0000-4000-8000-000000000005');
+  insert into agent_board.agents(id, agent_type, handle, display_name, status, auth_user_id) values
+    ('67420000-0000-4000-8000-000000000001', 'agent', 'g674-iso-o',  'G674 O',  'active', '67410000-0000-4000-8000-000000000001'),
+    ('67420000-0000-4000-8000-000000000002', 'agent', 'g674-iso-a1', 'G674 A1', 'active', '67410000-0000-4000-8000-000000000002'),
+    ('67420000-0000-4000-8000-000000000003', 'agent', 'g674-iso-m',  'G674 M',  'active', '67410000-0000-4000-8000-000000000003'),
+    ('67420000-0000-4000-8000-000000000004', 'agent', 'g674-iso-v',  'G674 V',  'active', '67410000-0000-4000-8000-000000000004'),
+    ('67420000-0000-4000-8000-000000000005', 'agent', 'g674-iso-g',  'G674 G',  'active', '67410000-0000-4000-8000-000000000005');
+  insert into agent_board.boards(id, slug, name, created_by_agent_id, visibility)
+  values ('67430000-0000-4000-8000-000000000001', 'g674-iso-board', 'G674 isolation board',
+          '67420000-0000-4000-8000-000000000001', 'private');
+  insert into agent_board.board_memberships(board_id, agent_id, membership_state, role, created_by_agent_id) values
+    ('67430000-0000-4000-8000-000000000001', '67420000-0000-4000-8000-000000000001', 'joined', 'owner',    '67420000-0000-4000-8000-000000000001'),
+    ('67430000-0000-4000-8000-000000000001', '67420000-0000-4000-8000-000000000002', 'joined', 'admin',    '67420000-0000-4000-8000-000000000001'),
+    ('67430000-0000-4000-8000-000000000001', '67420000-0000-4000-8000-000000000003', 'joined', 'member',   '67420000-0000-4000-8000-000000000001'),
+    ('67430000-0000-4000-8000-000000000001', '67420000-0000-4000-8000-000000000004', 'joined', 'observer', '67420000-0000-4000-8000-000000000001'),
+    ('67430000-0000-4000-8000-000000000001', '67420000-0000-4000-8000-000000000005', 'joined', 'member',   '67420000-0000-4000-8000-000000000001');
+  insert into agent_board.threads(id, created_by_agent_id, subject, board_id)
+  values ('67440000-0000-4000-8000-000000000001', '67420000-0000-4000-8000-000000000001', 'g674 iso thread',
+          '67430000-0000-4000-8000-000000000001');
+  -- The admin-preset link, minted by O through the real RPC (service path, O supplied).
+  select count(*) from agent_board.create_invite_link('67430000-0000-4000-8000-000000000001', 'admin', 'joined', 5,
+    null, '67420000-0000-4000-8000-000000000001', jsonb_build_object());
+}
+
+teardown
+{
+  delete from agent_board.board_invite_redemptions where invite_id in
+    (select id from agent_board.board_invite_tokens where board_id = '67430000-0000-4000-8000-000000000001');
+  delete from agent_board.board_invite_tokens where board_id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.delivery_recipients where board_id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.inbox_items where board_id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.callback_outbox_events where board_id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.messages where thread_id = '67440000-0000-4000-8000-000000000001';
+  delete from agent_board.threads where id = '67440000-0000-4000-8000-000000000001';
+  delete from agent_board.board_membership_events where board_id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.board_memberships where board_id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.boards where id = '67430000-0000-4000-8000-000000000001';
+  delete from agent_board.agents where id::text like '67420000-0000-4000-8000-00000000000_';
+  delete from auth.users where id::text like '67410000-0000-4000-8000-00000000000_';
+}
+
+# M, redeeming the admin link (I-1).
+session "m"
+step "m_begin" {
+  BEGIN;
+  select set_config('g674.code', (select code from agent_board.board_invite_tokens
+    where board_id = '67430000-0000-4000-8000-000000000001' and preset_role = 'admin'), true) is not null as have_code;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000003';
+}
+step "m_redeem" { select role, membership_state from agent_board.redeem_invite_link(current_setting('g674.code')); }
+step "m_commit" { COMMIT; }
+
+# A1, the admin grantor (I-1, I-2, I-3).
+session "a"
+step "a_begin" {
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000002';
+}
+step "a_grant_m_observer" {
+  select role from agent_board.grant_board_role('67430000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000003', 'observer');
+}
+step "a_commit" { COMMIT; }
+step "a_rollback" { ROLLBACK; }
+
+# O, the owner (I-2 eviction, I-3 demotion of A1, I-4 grantor).
+session "o"
+step "o_begin" {
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000001';
+}
+step "o_remove_m" {
+  select membership_state from agent_board.update_board_membership('67430000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000003', 'removed');
+}
+step "o_demote_a" {
+  select role from agent_board.grant_board_role('67430000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000002', 'member');
+}
+step "o_grant_m_observer" {
+  select role from agent_board.grant_board_role('67430000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000003', 'observer');
+}
+step "o_commit" { COMMIT; }
+
+# O's second session, posting on B (I-4): the fan-out FK-inserts delivery_recipients rows
+# naming each recipient's membership, which takes FOR KEY SHARE on M's row.
+session "p"
+step "p_begin" {
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000001';
+}
+step "p_post" {
+  select count(*) > 0 as posted from agent_board.post_board_message('67440000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000001', '67430000-0000-4000-8000-000000000001', 'g674 iso', 'fan-out to M');
+}
+# RESET ROLE (still inside the open transaction, which keeps every lock it took) so this
+# count reads M's uncommitted delivery row past the recipient-scoped RLS O is under.
+step "p_holds_m_fk" {
+  RESET ROLE;
+  select count(*) as m_delivery_rows from agent_board.delivery_recipients dr
+    join agent_board.board_memberships bm on bm.id = dr.board_membership_id
+   where bm.board_id = '67430000-0000-4000-8000-000000000001' and bm.agent_id = '67420000-0000-4000-8000-000000000003';
+}
+step "p_commit" { COMMIT; }
+
+# G, redeeming the admin link for its OWN row (I-5).
+session "g"
+step "g_begin" {
+  BEGIN;
+  select set_config('g674.code', (select code from agent_board.board_invite_tokens
+    where board_id = '67430000-0000-4000-8000-000000000001' and preset_role = 'admin'), true) is not null as have_code;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000005';
+}
+step "g_redeem" { select role, membership_state from agent_board.redeem_invite_link(current_setting('g674.code')); }
+step "g_commit" { COMMIT; }
+
+# G's second session, the grantor in I-5.
+session "g2"
+step "g2_begin" {
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000005';
+}
+step "g2_grant_v_member" {
+  select role from agent_board.grant_board_role('67430000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000004', 'member');
+}
+step "g2_rollback" { ROLLBACK; }
+step "g2_retry_begin" {
+  BEGIN;
+  SET LOCAL ROLE authenticated;
+  SET LOCAL "request.jwt.claim.role" = 'authenticated';
+  SET LOCAL "request.jwt.claim.sub" = '67410000-0000-4000-8000-000000000005';
+}
+step "g2_retry_grant_v_member" {
+  select role from agent_board.grant_board_role('67430000-0000-4000-8000-000000000001',
+    '67420000-0000-4000-8000-000000000004', 'member');
+}
+step "g2_commit" { COMMIT; }
+
+session "check"
+step "check" {
+  select a.handle, bm.role, bm.membership_state
+    from agent_board.board_memberships bm join agent_board.agents a on a.id = bm.agent_id
+   where bm.board_id = '67430000-0000-4000-8000-000000000001'
+   order by a.handle, bm.membership_state;
+}
+
+# I-1: the target is promoted through the product while it is being demoted.
+permutation "m_begin" "m_redeem" "a_begin" "a_grant_m_observer" "m_commit" "a_rollback" "check"
+# I-2: eviction during a grant.
+permutation "o_begin" "o_remove_m" "a_begin" "a_grant_m_observer" "o_commit" "a_rollback" "check"
+# I-3: two grants on one board, advisory-serialised. Demotion first: the grantor's role is
+# read AFTER the advisory wait (C-A refuses). Grant first: both succeed.
+permutation "o_begin" "o_demote_a" "a_begin" "a_grant_m_observer" "o_commit" "a_rollback" "check"
+permutation "a_begin" "a_grant_m_observer" "o_begin" "o_demote_a" "a_commit" "o_commit" "check"
+# I-4: FK-share non-interference -- the grant completes without blocking. The poster commits
+# BEFORE the grantor so that a grant which DID block (M7b, FOR UPDATE) is released and the
+# golden diff shows `<waiting ...>`/`<... completed>` instead of a truncated run.
+permutation "p_begin" "p_post" "p_holds_m_fk" "o_begin" "o_grant_m_observer" "p_commit" "o_commit" "check"
+# I-5: a concurrent raise of the grantor is seen as the older, lower rank (refusal), never
+# a wrongful allow; the retry after commit succeeds.
+permutation "g_begin" "g_redeem" "g2_begin" "g2_grant_v_member" "g2_rollback" "g_commit" "g2_retry_begin" "g2_retry_grant_v_member" "g2_commit" "check"

package/tests/isolation/specs/session_identity_limits.spec

@@ -0,0 +1,81 @@
+# Concurrent mints from a 59-row mixed rolling-hour census share the true root
+# lock. Expired legacy grants and revoked session mints still consume the hour.
+setup
+{
+  grant usage on schema extensions to service_role;
+  insert into auth.users(id) values ('77000000-0000-4000-8000-000000000001');
+  insert into agent_board.agents(id, agent_type, handle, display_name, status, owner_user_id)
+  values ('78000000-0000-4000-8000-000000000001', 'agent', 'sid-limits-root', 'SID limits root', 'active',
+    '77000000-0000-4000-8000-000000000001');
+  insert into agent_board.session_identities(agent_id, root_agent_id, depth)
+  values ('78000000-0000-4000-8000-000000000001', '78000000-0000-4000-8000-000000000001', 0);
+  insert into agent_board.delegation_policies(id, root_agent_id, mode, max_active_children, allowed_scopes, child_ttl_ceiling)
+  values ('79000000-0000-4000-8000-000000000001', '78000000-0000-4000-8000-000000000001', 'root_minted', 200, '[]', interval '8 hours');
+  do $$ declare n integer; child uuid; begin
+    for n in 1..59 loop
+      child := gen_random_uuid();
+      insert into agent_board.agents(id, agent_type, handle, display_name, status, owner_user_id, parent_agent_id, root_agent_id)
+      values (child, 'agent', 'sid-limits-history-' || n, 'SID limits history', case when n <= 30 then 'active' else 'revoked' end,
+        '77000000-0000-4000-8000-000000000001', '78000000-0000-4000-8000-000000000001', '78000000-0000-4000-8000-000000000001');
+      insert into agent_board.session_identities(agent_id, parent_agent_id, root_agent_id, depth, identity_kind, harness, tombstoned_at, tombstone_reason)
+      values (child, '78000000-0000-4000-8000-000000000001', '78000000-0000-4000-8000-000000000001', 1,
+        case when n <= 30 then 'legacy' else 'session' end, case when n <= 30 then null else 'codex' end,
+        case when n <= 30 then null else now() end, case when n <= 30 then null else 'revoked' end);
+      insert into agent_board.delegation_grants(child_agent_id, root_agent_id, parent_agent_id, delegation_policy_id, granted_scopes, grant_expires_at, revoked_at)
+      values (child, '78000000-0000-4000-8000-000000000001', '78000000-0000-4000-8000-000000000001',
+        '79000000-0000-4000-8000-000000000001', '[]', now() - interval '1 hour', case when n <= 30 then null else now() end);
+    end loop;
+  end $$;
+}
+
+teardown
+{
+  do $$ declare v_auth_ids uuid[]; begin
+    select array_agg(auth_user_id) into v_auth_ids from agent_board.agents
+      where root_agent_id = '78000000-0000-4000-8000-000000000001' and auth_user_id is not null;
+    delete from agent_board.session_id_aliases where root_agent_id = '78000000-0000-4000-8000-000000000001';
+    delete from agent_board.session_identities where root_agent_id = '78000000-0000-4000-8000-000000000001';
+    delete from agent_board.agents where root_agent_id = '78000000-0000-4000-8000-000000000001';
+    delete from agent_board.agents where id = '78000000-0000-4000-8000-000000000001';
+    delete from auth.users where id = any(v_auth_ids) or id = '77000000-0000-4000-8000-000000000001';
+  end $$;
+}
+
+session "a"
+step "a_begin" { BEGIN; SET LOCAL ROLE service_role; SET LOCAL "request.jwt.claim.role" = 'service_role'; }
+step "a_mint" {
+  do $$ begin
+    perform * from agent_board.mint_delegated_child('78000000-0000-4000-8000-000000000001', 'sid-limit-a', '[]',
+      public.test_pubkey('sid-limit-a'), interval '1 hour', false, 'codex', 'limit-a');
+  end $$;
+}
+step "a_commit" { COMMIT; }
+
+session "b"
+step "b_begin" { BEGIN; SET LOCAL ROLE service_role; SET LOCAL "request.jwt.claim.role" = 'service_role'; }
+step "b_mint" {
+  do $$ begin
+    perform * from agent_board.mint_delegated_child('78000000-0000-4000-8000-000000000001', 'sid-limit-b', '[]',
+      public.test_pubkey('sid-limit-b'), interval '1 hour', false, 'codex', 'limit-b');
+  end $$;
+}
+step "b_duplicate" {
+  do $$ begin
+    perform * from agent_board.mint_delegated_child('78000000-0000-4000-8000-000000000001', 'sid-limit-b', '[]',
+      public.test_pubkey('sid-limit-b'), interval '1 hour', false, 'codex', 'limit-a');
+  end $$;
+}
+step "b_commit" { COMMIT; }
+
+session "check"
+step "check" {
+  select count(*) as mixed_hourly, count(*) filter (where revoked_at is not null) as tombstoned_hourly
+  from agent_board.delegation_grants where root_agent_id = '78000000-0000-4000-8000-000000000001';
+  select count(*) as new_principals from agent_board.agents where handle in ('sid-limit-a', 'sid-limit-b');
+  select count(*) as aliases from agent_board.session_id_aliases where root_agent_id = '78000000-0000-4000-8000-000000000001';
+}
+
+permutation "a_begin" "a_mint" "b_begin" "b_mint" "a_commit" "b_commit" "check"
+permutation "b_begin" "b_mint" "a_begin" "a_mint" "b_commit" "a_commit" "check"
+permutation "a_begin" "a_mint" "b_begin" "b_duplicate" "a_commit" "b_commit" "check"
+permutation "b_begin" "b_duplicate" "a_begin" "a_mint" "b_commit" "a_commit" "check"