deepseek-harness/examples/desktop/test/renderer-interrupts.test.js

// Tests for the interrupt round-trip through renderer.js.
//
// Main.js dispatches inbound `session/interrupt` requests as
// `interrupt:incoming { interruptId, sessionId, kind, spec }`; the renderer
// mounts a card, waits for the user, and answers with
// `window.dsh.resolveInterrupt(id, { outcome, payload? })`. The three
// outcomes are `accepted` / `rejected` / `cancelled`. Two spec kinds are
// live on the wire: `approval` (tool-call gating) and `form` (structured
// or free-text answer).
//
// Coverage matrix:
//   approval + accepted / rejected / cancelled
//   form (options) + accepted (payload has selectedOptions) / cancelled
//   form (schema)  + accepted (payload has schema field values)
//   form (free)    + accepted (payload has answer)
//   interrupt:invalidate — card disabled, entry removed from state map

'use strict'

const test = require('node:test')
const assert = require('node:assert/strict')
const { loadRenderer } = require('./renderer-harness.js')

async function bootWithSession() {
  const bundle = await loadRenderer()
  bundle.renderer.ensureSession('s1', { title: 's', header: {} })
  await bundle.renderer.selectSession('s1')
  return bundle
}

function findApprovalCard(document) {
  return document.querySelector('.card.approval')
}
function findFormCard(document) {
  return document.querySelector('.card.form')
}
function findButtonByText(root, text) {
  // Walk depth-first and match ONLY <button> elements whose direct text
  // equals `text`. A previous version checked `textContent` first, which
  // is a getter that concatenates child text — so a wrapping <div> with a
  // single Dismiss button in it also matched, returning the wrapping div
  // and its (nonexistent) listeners. That silently broke the click path.
  for (const el of root.children) {
    if (el.tagName === 'BUTTON' && el._text === text) return el
    const hit = findButtonByText(el, text)
    if (hit) return hit
  }
  return null
}

test('approval: clicking the "allow" option resolves accepted with optionId', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-1',
    sessionId: 's1',
    kind: 'approval',
    spec: {
      toolCallId: 'tc-1',
      options: [
        { optionId: 'allow-once', name: 'Allow once', kind: 'allow-once' },
        { optionId: 'reject', name: 'Reject', kind: 'reject-once' },
      ],
    },
  })
  const card = findApprovalCard(document)
  assert.ok(card, 'approval card should have been mounted into the DOM')
  const btn = findButtonByText(card, 'Allow once')
  assert.ok(btn, 'Allow once button should exist')
  btn.click()
  // resolveInterrupt is async; drain microtasks.
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt')
  assert.ok(call, 'resolveInterrupt should have been called')
  assert.equal(call[1], 'i-1')
  assert.equal(call[2].outcome, 'accepted')
  assert.equal(call[2].payload.optionId, 'allow-once')
})

test('approval: clicking a reject-* option resolves rejected (no payload required)', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-2',
    sessionId: 's1',
    kind: 'approval',
    spec: {
      toolCallId: 'tc-2',
      options: [
        { optionId: 'allow', name: 'Allow', kind: 'allow-once' },
        { optionId: 'no', name: 'Deny', kind: 'reject-once' },
      ],
    },
  })
  const card = findApprovalCard(document)
  findButtonByText(card, 'Deny').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-2')
  assert.ok(call)
  assert.equal(call[2].outcome, 'rejected')
  assert.equal(call[2].payload, undefined,
    'rejected outcome ships no payload — renderer.js sends {outcome:"rejected"}')
})

test('approval: Dismiss resolves cancelled', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-3',
    sessionId: 's1',
    kind: 'approval',
    spec: { toolCallId: 'tc-3', options: [] },
  })
  const card = findApprovalCard(document)
  findButtonByText(card, 'Dismiss').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-3')
  assert.ok(call)
  assert.equal(call[2].outcome, 'cancelled')
})

test('form with options: Submit ships selectedOptions + custom answer', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-4',
    sessionId: 's1',
    kind: 'form',
    spec: {
      title: 'Pick one',
      message: 'Choose your fighter',
      options: [
        { label: 'Alpha' },
        { label: 'Beta' },
      ],
      multiSelect: false,
      questionId: 'q-alpha',
    },
  })
  const card = findFormCard(document)
  assert.ok(card, 'form card should have been mounted')
  // Mark the first radio as :checked so the collect step reads it.
  const radios = card.querySelectorAll('input[type=radio]')
  assert.equal(radios.length, 2)
  // Fake :checked by attaching an `attrs.checked` key that our matches()
  // won't read — instead, patch the querySelectorAll on card by hand.
  radios[0].attrs.checked = 'checked'
  // The shim's matches() reads attrs by name; extend the query to look for
  // `checked` attribute. Renderer uses the CSS `:checked` pseudo which our
  // shim doesn't implement, so we work around by pre-selecting the radio's
  // value and skipping through the read-path: set .value on collect.node
  // is not straightforward; instead, use free-text fallback branch on a
  // separate test. For this test, assert that the Submit path calls
  // resolveInterrupt with an "accepted" outcome + questionId even when
  // no radio matched.
  findButtonByText(card, 'Submit').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-4')
  assert.ok(call, 'resolveInterrupt fired')
  assert.equal(call[2].outcome, 'accepted')
  assert.ok(call[2].payload, 'payload present')
  assert.equal(call[2].payload.questionId, 'q-alpha')
  assert.ok(Array.isArray(call[2].payload.selectedOptions))
})

test('form with schema: Submit ships one field per property', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-5',
    sessionId: 's1',
    kind: 'form',
    spec: {
      title: 'Enter details',
      requestedSchema: {
        properties: {
          name: { title: 'Full name' },
          email: {},
        },
      },
    },
  })
  const card = findFormCard(document)
  const inputs = card.querySelectorAll('input')
  assert.equal(inputs.length, 2)
  inputs[0].value = 'Ada Lovelace'
  inputs[1].value = 'ada@example.org'
  findButtonByText(card, 'Submit').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-5')
  assert.ok(call)
  assert.equal(call[2].outcome, 'accepted')
  assert.deepEqual(call[2].payload, {
    name: 'Ada Lovelace',
    email: 'ada@example.org',
  })
})

test('form with free text: Submit ships {answer}', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-6',
    sessionId: 's1',
    kind: 'form',
    spec: {
      header: 'One question',
      question: 'How are you?',
    },
  })
  const card = findFormCard(document)
  const input = card.querySelector('input')
  input.value = 'doing fine'
  findButtonByText(card, 'Submit').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-6')
  assert.ok(call)
  assert.equal(call[2].outcome, 'accepted')
  assert.deepEqual(call[2].payload, { answer: 'doing fine' })
})

test('form Dismiss resolves cancelled', async () => {
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-7',
    sessionId: 's1',
    kind: 'form',
    spec: { title: 'x', message: 'y' },
  })
  const card = findFormCard(document)
  findButtonByText(card, 'Dismiss').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-7')
  assert.ok(call)
  assert.equal(call[2].outcome, 'cancelled')
})

test('interrupt:invalidate disables the card and removes it from the state map', async () => {
  const { listeners, renderer, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-8',
    sessionId: 's1',
    kind: 'approval',
    spec: { toolCallId: 'tc-8', options: [] },
  })
  const card = findApprovalCard(document)
  assert.ok(card)
  listeners.onInterruptInvalidate({ interruptId: 'i-8', reason: 'runtime crashed' })
  // Card should have the disabled class + a cancellation note appended.
  assert.ok(card.classList.contains('disabled'),
    'invalidated card should carry the disabled class')
  const text = card.textContent
  assert.match(text, /cancelled/, 'note added to invalidated card')
  // Snapshot state doesn't expose interruptCards; behavior we can check is
  // "no crash + card marked disabled". A second invalidate on the same id
  // must be a no-op (already deleted from the map).
  assert.doesNotThrow(() => {
    listeners.onInterruptInvalidate({ interruptId: 'i-8', reason: 'again' })
  })
  // Renderer must not have called resolveInterrupt in the invalidate path
  // — the runtime is telling us the interrupt was auto-cancelled elsewhere.
  const { dsh } = await import('./renderer-harness.js').catch(() => ({ dsh: null }))
  if (dsh) {
    const calls = dsh.__calls || []
    const badCalls = calls.filter((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-8')
    assert.equal(badCalls.length, 0)
  }
  void renderer
})

test('cancelled outcome payload shape is exactly {outcome:"cancelled"}', async () => {
  // Locks the wire shape — the runtime distinguishes "cancelled" from
  // "rejected" and both are meaningful. Historical bug potential: a
  // "cancelled" with a payload confuses the daemon-side interrupt bus.
  const { listeners, dsh, document } = await bootWithSession()
  listeners.onInterruptIncoming({
    interruptId: 'i-9',
    sessionId: 's1',
    kind: 'form',
    spec: { question: 'why?' },
  })
  findButtonByText(findFormCard(document), 'Dismiss').click()
  await new Promise((r) => setTimeout(r, 5))
  const call = dsh.__calls.find((c) => c[0] === 'resolveInterrupt' && c[1] === 'i-9')
  assert.ok(call)
  assert.deepEqual(Object.keys(call[2]).sort(), ['outcome'])
  assert.equal(call[2].outcome, 'cancelled')
})