Skip to content

armgit / orca

Public Imported from GitHub
0

Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

20.1 KB
Raw Blame
import { describe, it, expect } from 'vitest'
import { parseWorkspaceSession } from './workspace-session-schema'

describe('parseWorkspaceSession sleeping agents', () => {
  it('preserves valid sleeping agent resume records', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9,
          terminalTitle: 'Codex',
          lastAssistantMessage: 'done',
          launchConfig: {
            agentArgs: '',
            agentEnv: {}
          },
          origin: 'live'
        }
      }
    })
    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.agent).toBe('codex')
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.origin).toBe('live')
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.launchConfig).toEqual({
        agentArgs: '',
        agentEnv: {}
      })
    }
  })

  it.each([undefined, 'legacy-orchestration-worker'])(
    'new host ignores an old client resume fence (%s)',
    (automaticResumeBlockedBy) => {
      const record = {
        paneKey: 'tab1:pane-1',
        tabId: 'tab1',
        worktreeId: 'wt',
        agent: 'codex',
        providerSession: { key: 'session_id', id: 'codex-session' },
        prompt: 'continue',
        state: 'done',
        capturedAt: 10,
        updatedAt: 10,
        origin: 'worktree-sleep'
      }
      const result = parseWorkspaceSession({
        activeRepoId: null,
        activeWorktreeId: null,
        activeTabId: null,
        tabsByWorktree: {},
        terminalLayoutsByTabId: {},
        sleepingAgentSessionsByPaneKey: {
          [record.paneKey]: { ...record, automaticResumeBlockedBy }
        }
      })
      expect(result.ok).toBe(true)
      if (result.ok) {
        expect(result.value.sleepingAgentSessionsByPaneKey?.[record.paneKey]).toEqual(record)
      }
    }
  )

  it('hydrates a persisted Kimi sleeping agent record', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'kimi',
          providerSession: {
            key: 'session_id',
            id: 'session_431324d7-2165-42f0-9ecd-9f93437b3201'
          },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9,
          terminalTitle: 'Kimi',
          origin: 'live'
        }
      }
    })
    expect(result.ok).toBe(true)
    if (result.ok) {
      // Why: the record must survive the resumable-agent refine, or restore silently drops it.
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']).toMatchObject({
        agent: 'kimi',
        providerSession: { key: 'session_id', id: 'session_431324d7-2165-42f0-9ecd-9f93437b3201' }
      })
    }
  })

  it('preserves the authoritative Pi session file through hydration', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'pi',
          providerSession: {
            key: 'session_id',
            id: 'pi-session',
            transcriptPath: '/tmp/pi-session.jsonl'
          },
          prompt: '',
          state: 'working',
          capturedAt: 10,
          updatedAt: 10,
          origin: 'live'
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.providerSession).toEqual(
        {
          key: 'session_id',
          id: 'pi-session',
          transcriptPath: '/tmp/pi-session.jsonl'
        }
      )
    }
  })

  it("preserves a Claude session's effort level through hydration", () => {
    const providerSession = { key: 'session_id', id: 'claude-session', effort: 'max' }
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'claude',
          providerSession,
          prompt: '',
          state: 'done',
          capturedAt: 10,
          updatedAt: 10,
          origin: 'live'
        }
      }
    })

    expect(
      result.ok && result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.providerSession
    ).toEqual(providerSession)
  })

  it('preserves the AI Vault OMP resume file through hydration', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'omp',
          providerSession: { key: 'session_id', id: 'omp-session' },
          prompt: '',
          state: 'working',
          capturedAt: 10,
          updatedAt: 10,
          launchConfig: {
            agentArgs: '',
            agentEnv: {},
            ompResumeFilePath: '/custom/omp-sessions/project/session.jsonl'
          },
          origin: 'quit'
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(
        result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.launchConfig
          ?.ompResumeFilePath
      ).toBe('/custom/omp-sessions/project/session.jsonl')
    }
  })

  it('drops Pi sleeping-agent records without an authoritative session file', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'pi',
          providerSession: { key: 'session_id', id: 'pi-session' },
          prompt: '',
          state: 'done',
          capturedAt: 10,
          updatedAt: 10,
          origin: 'live'
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey).toBeUndefined()
    }
  })

  it('drops invalid sleeping agent launch config without dropping the record', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9,
          launchConfig: {
            agentArgs: '--model high',
            agentEnv: { 'BAD=KEY': 'value' }
          }
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      const record = result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']
      expect(record?.agent).toBe('codex')
      expect(record?.launchConfig).toBeUndefined()
    }
  })

  it('drops launch config with prototype-polluting env keys without dropping siblings', () => {
    const sessions = JSON.parse(`{
      "__proto__": {
        "paneKey": "__proto__",
        "worktreeId": "wt",
        "agent": "codex",
        "providerSession": { "key": "session_id", "id": "bad-session" },
        "prompt": "bad",
        "state": "working",
        "capturedAt": 10,
        "updatedAt": 9
      },
      "tab1:pane-1": {
        "paneKey": "tab1:pane-1",
        "tabId": "tab1",
        "worktreeId": "wt",
        "agent": "codex",
        "providerSession": { "key": "session_id", "id": "codex-session" },
        "prompt": "continue",
        "state": "working",
        "capturedAt": 10,
        "updatedAt": 9,
        "launchConfig": {
          "agentArgs": "",
          "agentEnv": { "__proto__": "polluted" }
        }
      }
    }`)
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: sessions
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(Object.hasOwn(result.value.sleepingAgentSessionsByPaneKey ?? {}, '__proto__')).toBe(
        false
      )
      const record = result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']
      expect(record?.agent).toBe('codex')
      expect(record?.launchConfig).toBeUndefined()
      expect(({} as Record<string, unknown>).polluted).toBeUndefined()
    }
  })

  it('preserves sleeping agent launch env values with whitespace characters', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9,
          launchConfig: {
            agentArgs: '',
            agentEnv: { MULTILINE: 'line1\nline2\tok' }
          }
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(
        result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.launchConfig?.agentEnv
      ).toEqual({ MULTILINE: 'line1\nline2\tok' })
    }
  })

  it('drops sleeping agent launch config with NUL env values without dropping the record', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9,
          launchConfig: {
            agentArgs: '',
            agentEnv: { BAD_VALUE: 'ok\0bad' }
          }
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      const record = result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']
      expect(record?.agent).toBe('codex')
      expect(record?.launchConfig).toBeUndefined()
    }
  })

  it('preserves sleeping agent record origin across hydration', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'devin',
          providerSession: { key: 'session_id', id: 'devin-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9,
          origin: 'quit'
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.origin).toBe('quit')
    }
  })

  it('preserves the tab-open-only restore flag across hydration', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'claude',
          providerSession: { key: 'session_id', id: 'claude-session' },
          prompt: 'continue',
          state: 'done',
          capturedAt: 10,
          updatedAt: 10,
          origin: 'worktree-sleep',
          restoreOnTabOpenOnly: true
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      // Why: dropping it on restart resurrects the mobile-wake fan-out this flag exists to stop.
      expect(
        result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.restoreOnTabOpenOnly
      ).toBe(true)
    }
  })

  it('preserves interrupted sleeping agent records across hydration', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'done',
          capturedAt: 10,
          updatedAt: 9,
          interrupted: true,
          origin: 'worktree-sleep'
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.interrupted).toBe(true)
    }
  })

  // A record written by a newer build can carry a verdict arm this reader does not know; the same
  // path an older reader takes for the host-observed arms must drop only the verdict.
  it.each([
    ['interruption', { state: 'done', outcome: 'interruption', stateStartedAt: 9 }],
    ['unconfirmed', { state: 'done', outcome: 'unconfirmed', stateStartedAt: 9 }],
    ['from-a-newer-host', { state: 'done', stateStartedAt: 9 }]
  ])('keeps a sleeping agent record whose main agent verdict is %s', (outcome, mainAgent) => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'done',
          capturedAt: 10,
          updatedAt: 9,
          mainAgent: { state: 'done', outcome, stateStartedAt: 9 },
          origin: 'live'
        }
      }
    })

    expect(result.ok).toBe(true)
    if (result.ok) {
      const record = result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']
      expect(record).toMatchObject({ prompt: 'continue' })
      expect(record?.mainAgent).toEqual(mainAgent)
    }
  })

  it('drops malformed sleeping agent resume records without failing the whole session', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          worktreeId: 'wt',
          agent: 'definitely-not-an-agent',
          providerSession: { key: 'session_id', id: 'bogus-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        }
      }
    })
    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey).toBeUndefined()
    }
  })

  it('preserves valid sleeping agent resume records when sibling records are malformed', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        },
        'tab2:pane-1': {
          paneKey: 'tab2:pane-1',
          worktreeId: 'wt',
          agent: 'not-real',
          providerSession: { key: 'session_id', id: 'bad-session' },
          prompt: 'ignore me',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        }
      }
    })
    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.agent).toBe('codex')
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab2:pane-1']).toBeUndefined()
    }
  })

  it('drops sleeping agent records with unsafe provider session ids without dropping valid siblings', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        },
        'tab2:pane-1': {
          paneKey: 'tab2:pane-1',
          tabId: 'tab2',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: '--last' },
          prompt: 'ignore me',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        }
      }
    })
    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.providerSession.id).toBe(
        'codex-session'
      )
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab2:pane-1']).toBeUndefined()
    }
  })

  it('drops sleeping agent records whose embedded pane key differs from the map key', () => {
    const result = parseWorkspaceSession({
      activeRepoId: null,
      activeWorktreeId: null,
      activeTabId: null,
      tabsByWorktree: {},
      terminalLayoutsByTabId: {},
      sleepingAgentSessionsByPaneKey: {
        'tab1:pane-1': {
          paneKey: 'tab1:pane-1',
          tabId: 'tab1',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'codex-session' },
          prompt: 'continue',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        },
        'tab2:pane-1': {
          paneKey: 'other-tab:pane-1',
          tabId: 'tab2',
          worktreeId: 'wt',
          agent: 'codex',
          providerSession: { key: 'session_id', id: 'mismatched-session' },
          prompt: 'ignore me',
          state: 'working',
          capturedAt: 10,
          updatedAt: 9
        }
      }
    })
    expect(result.ok).toBe(true)
    if (result.ok) {
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab1:pane-1']?.providerSession.id).toBe(
        'codex-session'
      )
      expect(result.value.sleepingAgentSessionsByPaneKey?.['tab2:pane-1']).toBeUndefined()
    }
  })
})