Errors

Error classes

• MilkeyError
• MilkeyProblemError
• MilkeyResponseError
• MilkeyConfigError
• MilkeyTimeoutError
• MilkeyToolCallError

When they happen

• MilkeyConfigError: invalid `baseUrl`, empty API key, invalid timeout, conflicting `mode` and `delivery`, or unsupported mode requests.
• MilkeyProblemError: the backend returned RFC 9457 problem details.
• MilkeyResponseError: non-problem HTTP failures with status and raw body.
• MilkeyTimeoutError: request timeout on a Milkey backend call.
• MilkeyToolCallError: provider tool arguments were malformed before the SDK could execute the tool.

Handling

1try {2  const tools = milkey.openai.responses.tools({3    client: milkeyClient,4    mode: "auto",5  })6} catch (error) {7  if (error instanceof MilkeyConfigError) {8    // fix configuration or unsupported mode usage9  } else if (error instanceof MilkeyTimeoutError) {10    // retry or surface degraded dependency state11  } else {12    throw error13  }14}