refactor(agent): complete inbox lifecycle migration

packages/core/agent-loop/tests/contract-regressions.spec.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from 'vitest'
 import { Context } from 'cordis'
-import LlmService, { createUserMessage, freezeMessage, CallId, LlmError, MessageSource, ProviderRequestId, StreamChunk  } from '@deepseek-ai/dsh-llm'
+import LlmService, { createUserMessage, CallId, LlmError, MessageSource, ProviderRequestId, StreamChunk  } from '@deepseek-ai/dsh-llm'
 import SessionStore, { Session, SessionEvent, SessionId, TurnEndReason, type UserMessage } from '@deepseek-ai/dsh-session'
 import SystemPrompt from '@deepseek-ai/dsh-system-prompt'
 import ToolRegistry, { defineContentToolFixture, type PostToolDecision } from '@deepseek-ai/dsh-tools'
@@ -59,152 +59,6 @@ function inboxText(message: UserMessage): string {
     .join('')
 }
 
-describe('addressable inbox operations', () => {
-  it('edits in place and removes exactly one queued item', async () => {
-    const adapter = new MockAdapter([
-      textResponse('first reply'),
-      textResponse('edited reply'),
-    ])
-    const ctx = await harness(adapter)
-    const agent = ctx.agentLoop.create(SessionId('inbox-actions'), { provider: 'mock', model: 'mock' })
-    const preStep = Promise.withResolvers<undefined>()
-    const release = Promise.withResolvers<undefined>()
-    ctx.on('agent/pre-step', async (_subject, messages, _signal, next) => {
-      if (messages[0]?.content[0]?.type === 'text' && messages[0].content[0].text === 'first') {
-        preStep.resolve(undefined)
-        await release.promise
-      }
-      return next()
-    })
-
-    send(agent, 'first')
-    await preStep.promise
-    send(agent, 'remove me')
-    send(agent, 'edit me')
-    const pending = agent.inbox.nextTurn
-    expect(pending.map(inboxText)).toEqual(['remove me', 'edit me'])
-
-    const remove = pending[0]!
-    const edit = pending[1]!
-    expect(agent.inbox.splice('next-turn', 1, 1, [freezeMessage({
-      ...edit,
-      content: [{ type: 'text', text: 'edited' }],
-    })])).toEqual([edit])
-    expect(agent.inbox.splice('next-turn', 0, 1, [])).toEqual([remove])
-
-    const idle = waitForIdle(ctx, agent)
-    release.resolve(undefined)
-    await idle
-    expect(agent.session.events
-      .filter(event => event.type === 'user/message')
-      .map(event => event.type === 'user/message'
-        ? event.data.content.flatMap(block => block.type === 'text' ? [block.text] : []).join('')
-        : ''))
-      .toEqual(['first', 'edited'])
-    expect(agent.inbox.splice('next-turn', 0, 1, [])).toEqual([])
-  })
-
-  it('strictly transfers a queued occurrence into the open turn', async () => {
-    const adapter = new MockAdapter([textResponse('done')])
-    const ctx = await harness(adapter)
-    const agent = ctx.agentLoop.create(SessionId('queue-to-steer'), { provider: 'mock', model: 'mock' })
-    const entered = Promise.withResolvers<undefined>()
-    const decision = Promise.withResolvers<{ kind: 'allow' }>()
-    ctx.on('agent/prompt-submit', async () => {
-      entered.resolve(undefined)
-      return decision.promise
-    })
-
-    const enqueued: InboxItem[] = []
-    const discarded: InboxItem[] = []
-    ctx.on('agent/inbox/enqueue', (subject, item) => {
-      if (subject === agent) enqueued.push(item)
-    })
-    ctx.on('agent/inbox/discard', (subject, items) => {
-      if (subject === agent) discarded.push(...items)
-    })
-
-    const idle = waitForIdle(ctx, agent)
-    send(agent, 'open the turn')
-    const receipt = agent.steer(createUserMessage({
-      content: [{ type: 'text', text: 'steer this message' }],
-      source: { kind: 'user' },
-    }))
-    await entered.promise
-    const queued = enqueued.find(item => inboxText(item) === 'steer this message')!
-
-    expect(agent.updateInbox(queued.id, { kind: 'steer' })).toBe('applied')
-    const steering = enqueued.find(item => item.placement === 'steering')!
-    expect(steering.id).not.toBe(queued.id)
-    expect(steering.message).toBe(queued.message)
-    expect(discarded).toEqual([queued])
-
-    decision.resolve({ kind: 'allow' })
-    await idle
-    expect(agent.session.events.flatMap(event =>
-      event.type === 'steering/message' ? [event.data.message] : [],
-    )).toEqual([queued.message])
-    expect(await receipt.outcome).toEqual({ status: 'admitted', turn: 1, step: 1 })
-    expect(agent.updateInbox(queued.id, { kind: 'steer' })).toBe('not-found')
-  })
-
-  it('keeps a queued occurrence when the next-step window is closed', () => {
-    const ctx = new Context()
-    const session = new Session(SessionId('queue-to-steer-closed'))
-    const agent = new ReactLoopAgent(ctx, session.id, {}, session)
-    const enqueued: InboxItem[] = []
-    const discarded: InboxItem[] = []
-    ctx.on('agent/inbox/enqueue', (_subject, item) => { enqueued.push(item) })
-    ctx.on('agent/inbox/discard', (_subject, items) => { discarded.push(...items) })
-
-    agent.send(
-      createUserMessage({ content: [{ type: 'text', text: 'stay queued' }], source: { kind: 'user' } }),
-      { target: 'next-turn', wakeup: false },
-    )
-    const queued = enqueued[0]!
-    expect(agent.updateInbox(queued.id, { kind: 'steer' })).toBe('steer-unavailable')
-    expect(discarded).toEqual([])
-    expect(agent.updateInbox(queued.id, { kind: 'remove' })).toBe('applied')
-  })
-
-  it('accounts for both occurrences when steering enqueue cancels reentrantly', async () => {
-    const adapter = new MockAdapter([textResponse('unused')])
-    const ctx = await harness(adapter)
-    const agent = ctx.agentLoop.create(SessionId('queue-to-steer-cancel'), { provider: 'mock', model: 'mock' })
-    const entered = Promise.withResolvers<undefined>()
-    const decision = Promise.withResolvers<{ kind: 'allow' }>()
-    ctx.on('agent/prompt-submit', async () => {
-      entered.resolve(undefined)
-      return decision.promise
-    })
-
-    const enqueued: InboxItem[] = []
-    const discarded: InboxItem[] = []
-    ctx.on('agent/inbox/enqueue', (subject, item) => {
-      if (subject !== agent) return
-      enqueued.push(item)
-      if (item.placement === 'steering') agent.cancel({ kind: 'user' })
-    })
-    ctx.on('agent/inbox/discard', (subject, items) => {
-      if (subject === agent) discarded.push(...items)
-    })
-
-    const idle = waitForIdle(ctx, agent)
-    send(agent, 'open the turn')
-    await entered.promise
-    send(agent, 'cancel during conversion')
-    const queued = enqueued.find(item => inboxText(item) === 'cancel during conversion')!
-
-    expect(agent.updateInbox(queued.id, { kind: 'steer' })).toBe('applied')
-    const steering = enqueued.find(item => item.placement === 'steering')!
-    expect(discarded).toEqual([steering, queued])
-
-    decision.resolve({ kind: 'allow' })
-    await idle
-    expect(agent.session.events.some(event => event.type === 'steering/message')).toBe(false)
-  })
-})
-
 describe('assistant replay provenance', () => {
   it('records adapter replay state with the assembled assistant content', async () => {
     const response = textResponse('unchanged')