Structured outputs and tool calls in prototypes

import Anthropic from '@anthropic-ai/sdk';
import { zodOutputFormat } from '@anthropic-ai/sdk/helpers/zod';
import { z } from 'zod';

const client = new Anthropic();

const ActionItems = z.object({
  items: z.array(
    z.object({
      task: z.string().describe('What needs to be done, starting with a verb'),
      owner: z.string().nullable().describe('Who is responsible, exactly as named in the notes, or null if unclear'),
      due: z.string().nullable().describe('Due date as YYYY-MM-DD if stated, otherwise null'),
    }),
  ),
});

export type ActionItem = z.infer<typeof ActionItems>['items'][number];

export async function extractActions(notes: string, attendees: string[]): Promise<ActionItem[] | null> {
  const response = await client.messages.parse({
    model: 'claude-opus-5-5',
    max_tokens: 4096,
    output_config: { effort: 'low', format: zodOutputFormat(ActionItems) },
    system: 'Extract action items from the meeting notes. Only include tasks someone committed to. Never invent owners or dates.',
    messages: [{ role: 'user', content: notes }],
  });

  // A truncated response could be missing items; a refusal has no output. Either way, don't create tasks.
  if (response.stop_reason !== 'end_turn' || !response.parsed_output) return null;

  // The schema guarantees the shape, not that the values make sense for your product. Check those in code.
  return response.parsed_output.items.map((item) => ({
    ...item,
    owner: item.owner && attendees.includes(item.owner) ? item.owner : null,
    due: item.due && !Number.isNaN(Date.parse(item.due)) ? item.due : null,
  }));
}

import Anthropic from '@anthropic-ai/sdk';
import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
import { z } from 'zod';

const client = new Anthropic();

// Stand-in for your real order service.
async function fetchOrder(orderId: string) {
  return orderId === 'A1042' ? { orderId, status: 'shipped', carrier: 'DHL', eta: '2026-10-21' } : null;
}

// A read-only tool: safe to run without approval. Anything that changes data needs an approval step.
const getOrderStatus = betaZodTool({
  name: 'get_order_status',
  description: 'Look up the current status of an order by its ID, such as A1042. Read-only.',
  inputSchema: z.object({ orderId: z.string().regex(/^[A-Z]\d{4}$/) }),
  run: async ({ orderId }) => {
    const order = await fetchOrder(orderId);
    return order ? JSON.stringify(order) : `No order found with ID ${orderId}.`;
  },
});

export async function answerOrderQuestion(question: string): Promise<string> {
  // The runner calls tools and feeds results back until the model stops asking for them.
  const final = await client.beta.messages.toolRunner({
    model: 'claude-opus-5-5',
    max_tokens: 4096,
    output_config: { effort: 'low' },
    tools: [getOrderStatus],
    messages: [{ role: 'user', content: question }],
  });

  // The runner doesn't apply stop-reason rules for you: check how the final turn ended.
  const text = final.content.flatMap((b) => (b.type === 'text' ? [b.text] : [])).join('');
  if (final.stop_reason === 'end_turn') return text;
  if (final.stop_reason === 'refusal') return "Sorry, I can't help with that request. Please contact support.";
  return `Sorry, I couldn't finish answering (${final.stop_reason}). Please try again or contact support.`;
}

console.log(await answerOrderQuestion('Where is my order A1042?'));