outcomes - Naive

An outcome says what “done” means for a task: a plain-language description and a Markdown rubric. Three methods; objects parse with the core OutcomeSchema. An outcome is immutable — there is no update and no delete; a changed rubric is a new outcome. Attach one to a session with sessions.setOutcome.

create

client.outcomes.create(body: OutcomeCreate): Promise<Outcome>

POST /v1/outcomes. name (1–200) and description (1–4000) are required. Give exactly one of rubric (inline Markdown) and rubric_file (a fil_ id of a file in your organization, read when the outcome is attached to a session); both or neither is validation_failed. max_iterations is 1–20, default 3.

const outcome = await client.outcomes.create({
  name: "refund-quality",
  description: "A correct, policy-compliant refund.",
  rubric: "# Refund rubric\n- Correct order identified\n- Amount matches policy\n",
  max_iterations: 4,
});

list

client.outcomes.list(query?: ListQuery): Promise<Page<Outcome>>

GET /v1/outcomes, newest first, cursor-paginated.

get

client.outcomes.get(id: string): Promise<Outcome>

GET /v1/outcomes/{id}. An unknown id is not_found (404).