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.
TypeScript adeagent-ideai-agentsautomationbotclaude-codecodexghosttygrok-bothermes-agentmobile-appmuseopenclawopencodeorchestrationpiruntimeterminalworktreesyc-backed
import { describe, expect, it } from 'vitest'
import type { AgentJournalDispatchState } from '../../../src/shared/agent-session-journal-types'
import type { AgentSessionSendResult } from '../../../src/shared/agent-session-wire'
import { DISPATCH_REJECTED_CANCELLED } from '../../../src/shared/structured-agent-session-dispatch-rejection'
import { mobileStructuredSendDelivery } from './mobile-structured-send-delivery'
import type { StructuredAgentSessionMutationCallResult } from './mobile-structured-agent-session-rpc'
import { structuredSendResultFixture } from './structured-agent-send-result.test-fixture'
function accepted(
dispatchState: AgentJournalDispatchState,
reason: string | null = null
): StructuredAgentSessionMutationCallResult<AgentSessionSendResult> {
return { status: 'accepted', value: structuredSendResultFixture(dispatchState, reason) }
}
describe('mobileStructuredSendDelivery', () => {
it.each([
['a sign-in rejection', 'Sign in to Grok with `grok login`.', { kind: 'notSignedIn' as const }],
['a content rejection', 'Claude does not support .bmp', undefined],
['a write failure', 'provider_write_failed: broken pipe', undefined]
])('leaves %s to its recorded row', (_name, reason, rejection) => {
const value = structuredSendResultFixture('rejected', reason)
if (rejection && 'submission' in value) {
value.submission.rejection = rejection
}
expect(mobileStructuredSendDelivery({ status: 'accepted', value })).toEqual({
outcome: 'accepted',
error: null
})
})
it('reports transport and host uncertainty on this send', () => {
expect(mobileStructuredSendDelivery({ status: 'unknown' })).toEqual({
outcome: 'unknown',
error: null
})
expect(mobileStructuredSendDelivery(accepted('unknown'))).toEqual({
outcome: 'unknown',
error: null
})
})
it.each(['accepted', 'pending'] as const)('reports a written %s send as accepted', (state) => {
expect(mobileStructuredSendDelivery(accepted(state))).toEqual({
outcome: 'accepted',
error: null
})
})
it.each(['waiting', 'dispatched', 'returned'] as const)(
'lets the host own its %s queued message without an optimistic bubble',
(state) => {
expect(
mobileStructuredSendDelivery({
status: 'accepted',
value: {
clientMessageId: 'client-1',
queued: { messageId: 'client-1', position: 1, state }
}
})
).toEqual({ outcome: 'queued', error: null })
}
)
it('hands back a withdrawn card instead of silently sending again', () => {
expect(
mobileStructuredSendDelivery({
status: 'accepted',
value: {
clientMessageId: 'client-1',
queued: { messageId: 'client-1', position: 1, state: 'withdrawn' }
}
})
).toEqual({ outcome: 'rejected', error: 'Message not sent' })
})
it('keeps a handed-off queued message unconfirmed until the stream identifies it', () => {
const value = structuredSendResultFixture('accepted')
if (!('submission' in value)) {
throw new Error('expected a submission answer')
}
expect(
mobileStructuredSendDelivery({
status: 'accepted',
value: {
clientMessageId: 'draft-id',
submission: {
...value.submission,
clientMessageId: 'fresh-id',
queuedMessageId: 'draft-id'
}
}
})
).toEqual({ outcome: 'unknown', error: null })
})
it('fails closed when a malformed answer has no submission', () => {
expect(mobileStructuredSendDelivery({ status: 'accepted', value: JSON.parse('{}') })).toEqual({
outcome: 'unknown',
error: null
})
})
it('lets a kept queued card hold the text after a provider rejection', () => {
const value = structuredSendResultFixture('rejected', 'Orca restarted before this was sent.')
if (!('submission' in value)) {
throw new Error('expected a submission answer')
}
value.submission.keptAsQueuedMessageId = 'card-id'
expect(mobileStructuredSendDelivery({ status: 'accepted', value })).toEqual({
outcome: 'queued',
error: null
})
})
it.each([
{ reason: DISPATCH_REJECTED_CANCELLED, typed: false },
{ reason: 'This message was withdrawn before the agent started it.', typed: true }
])('leaves a stopped submission in its existing chat row (typed $typed)', ({ reason, typed }) => {
const value = structuredSendResultFixture('rejected', reason)
if (typed && 'submission' in value) {
value.submission.rejection = { kind: 'cancelled' }
}
expect(mobileStructuredSendDelivery({ status: 'accepted', value })).toEqual({
outcome: 'accepted',
error: null
})
})
it.each([
['agent_session_operation_invalid', 'Invalid operation'],
['agent_session_checkpoint_stale', 'Fence moved'],
['agent_session_operation_expired', 'Operation expired'],
['agent_session_operation_conflict', 'Operation conflict']
] as const)('reports the current %s refusal', (code, message) => {
expect(mobileStructuredSendDelivery({ status: 'refused', code, message })).toEqual({
outcome: 'rejected',
error: message
})
})
it('preserves an unknown operation refusal as uncertainty', () => {
expect(
mobileStructuredSendDelivery({
status: 'refused',
code: 'agent_session_operation_unknown',
message: 'Outcome unknown'
})
).toEqual({ outcome: 'unknown', error: null })
})
it('reports a request failure without consulting earlier sends', () => {
expect(
mobileStructuredSendDelivery({
status: 'failed',
message: 'Your message was not sent. Send it again.'
})
).toEqual({ outcome: 'rejected', error: 'Your message was not sent. Send it again.' })
})
})