OpenAI Responses

Overview

OpenAI Responses is the best OpenAI-native hosted MCP path in the SDK and is the recommended choice for new OpenAI integrations.

Inline mode is still available, but most teams should start with hosted mode here because it keeps the app surface thinner while staying provider-native.

Helpers

• milkey.openai.responses.tools(...)
• milkey.openai.responses.outputs(...)
• milkey.openai.responses.resolveMode(...)

Examples

1import OpenAI from "openai"2import { milkey } from "@milkeyskills/sdk"3 4const openai = new OpenAI({5  apiKey: process.env.OPENAI_API_KEY!,6})7 8const milkeyClient = milkey.createClient({9  baseUrl: process.env.MILKEY_BASE_URL!,10  apiKey: process.env.MILKEY_API_KEY!,11})12 13const tools = milkey.openai.responses.tools({14  client: milkeyClient,15  mode: "hosted",16})17 18const response = await openai.responses.create({19  model: process.env.OPENAI_MODEL ?? "gpt-5",20  input: "Find the best Milkey skill for PostgreSQL query optimization.",21  tools,22})23 24console.log(response.output_text)

1let response = await openai.responses.create({2  model: process.env.OPENAI_MODEL ?? "gpt-5",3  input: "Find the best Milkey skill for PostgreSQL query optimization.",4  tools: milkey.openai.responses.tools({5    client: milkeyClient,6    mode: "inline",7  }),8})9 10for (let turn = 1; turn <= 4; turn += 1) {11  const outputs = await milkey.openai.responses.outputs(response, milkeyClient)12  if (outputs.length === 0) break13 14  response = await openai.responses.create({15    model: process.env.OPENAI_MODEL ?? "gpt-5",16    previous_response_id: response.id,17    input: outputs,18    tools,19  })20}

Edge cases and production notes

• If you can choose only one OpenAI path for documentation and onboarding, make it Responses hosted.
• Use inline only when you need to inspect and control every follow-up item yourself.