Build the values a :query_fun returns, without knowing claude_wrapper's struct shapes.

ObanClaude.run/2 and ObanClaude.Worker call claude through a :query_fun (ObanClaude.query_fun/0): a 2-arity (prompt, opts) returning {:ok, %ClaudeWrapper.Result{}} or {:error, %ClaudeWrapper.Error{}}. In a test you pass a stub :query_fun so no real (paid) claude call happens.

Hand-writing that stub means knowing wrapper internals: success is a %Result{is_error: false}; structured output lives at extra["structured_output"] (where ObanClaude.structured/1 and ObanClaude.outcome/1 read it); a failure carries a %Error{kind: ...} from claude_wrapper's kind vocabulary. This module is those stubs, written once, so a shift in that representation surfaces here rather than silently in every consumer's tests.

Value builders

Return the bare wrapper structs -- for a hand-written :query_fun, or to feed handle_result/2 / ObanClaude.structured/1 directly in a unit test:

• result/1 -- a success %Result{}
• structured_result/2 -- a %Result{} carrying structured output
• error/2 -- an %Error{} of a given kind

query_fun builders

Return a ready :query_fun (a 2-arity function):

• respond/1 -- always succeeds with a result (or a plain string)
• fail/1 -- always fails with an error (or a plain kind atom)
• sequence/1 -- returns each scripted value in turn, for retry tests

Examples

Through the full seam with ObanClaude.run/2:

import ObanClaude.Testing

test "a clean result classifies to {:ok, result}" do
  assert {:ok, %Result{result: "done"}} =
           ObanClaude.run(%{"prompt" => "x"}, query_fun: respond("done"))
end

test "an auth failure cancels" do
  assert {{:cancel, :auth}, _} =
           ObanClaude.run(%{"prompt" => "x"}, query_fun: fail(:auth))
end

Structured output a handle_result/2 can read back:

test "reads the structured verdict" do
  result = structured_result(%{"outcome" => "blocked"})
  assert ObanClaude.outcome(result) == "blocked"
end

A worker's retry path, scripting one failure then a success:

qf = sequence([error(:auth, reason: :rate_limit), "done"])
assert {{:error, :rate_limit}, _} = ObanClaude.run(%{"prompt" => "x"}, query_fun: qf)
assert {:ok, %Result{result: "done"}} = ObanClaude.run(%{"prompt" => "x"}, query_fun: qf)