// In Package.swift
dependencies: [
    .package(url: "https://github.com/your-org/ChatClientKit.git", branch: "main")
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "ChatClientKit", package: "ChatClientKit")
        ]
    )
]

import ChatClientKit

let client = RemoteCompletionsChatClient(
    model: "gpt-4o-mini",
    baseURL: "https://api.openai.com/v1/chat/completions",
    apiKey: ProcessInfo.processInfo.environment["OPENAI_API_KEY"],
    additionalHeaders: ["X-Client": "ChatClientKit-Demo"]
)

let response = try await client.chatCompletion {
    ChatRequest.system("You are a precise release-notes assistant.")
    ChatRequest.user("Summarize the last test run.")
    ChatRequest.temperature(0.2)
}

print(response.choices.first?.message.content ?? "")

let stream = try await client.streamingChatCompletion {
    ChatRequest.system("You stream thoughts and final answers.")
    ChatRequest.user("Walk me through the onboarding checklist.")
}

for try await event in stream {
    switch event {
    case let .chatCompletionChunk(chunk):
        let text = chunk.choices.first?.delta.content ?? ""
        print(text, terminator: "")
    case let .tool(call):
        // Dispatch tool call to your executor.
        triggerTool(call)
    }
}

let responsesClient = RemoteResponsesChatClient(
    model: "google/gemini-3-pro-preview",
    baseURL: "https://openrouter.ai/api",
    path: "/v1/responses",
    apiKey: ProcessInfo.processInfo.environment["OPENROUTER_API_KEY"]
)

// Collect the entire response
let chunks = try await responsesClient.chatChunks {
    ChatRequest.messages {
        .system(content: .text("Answer concisely."))
        .user(content: .text("What is the capital of France?"))
    }
    ChatRequest.temperature(0.3)
}

let text = ChatResponse(chunks: chunks).text

// Or stream chunks as they arrive
let responseStream = try await responsesClient.streamingChat {
    ChatRequest.messages {
        .user(content: .text("Compose a haiku about integration tests."))
    }
}

for try await chunk in responseStream {
    if case let .text(delta) = chunk { print(delta, terminator: "") }
}

let imageClient = RemoteCompletionsChatClient(
    model: "google/gemini-2.5-flash-image",
    baseURL: "https://openrouter.ai/api",
    path: "/v1/chat/completions",
    apiKey: ProcessInfo.processInfo.environment["OPENROUTER_API_KEY"],
    additionalHeaders: [
        "HTTP-Referer": "https://github.com/FlowDown/ChatClientKit",
        "X-Title": "ChatClientKit Demo"
    ],
    additionalBodyField: [
        "output_modalities": ["image", "text"],
        "modalities": ["image", "text"]
    ]
)

let imageResponse = try await imageClient.chat {
    ChatRequest.system("You are a professional icon designer. You must return an image.")
    ChatRequest.user("Generate a simple black-and-white line-art cat icon.")
}

let imageData = imageResponse.images.first?.data // base64 image payload

let localClient = MLXChatClient(
    url: URL(fileURLWithPath: "/Models/Qwen2.5-7B-Instruct")
)

let reply = try await localClient.chatCompletion {
    ChatRequest.system("You are a privacy-first assistant running fully on-device.")
    ChatRequest.user("Draft a release tweet for ChatClientKit.")
    ChatRequest.maxCompletionTokens(512)
}

if #available(iOS 26, macOS 26, macCatalyst 26, *) {
    let aiClient = AppleIntelligenceChatClient()
    let aiResponse = try await aiClient.chatCompletion {
        ChatRequest.user("Find the action items from the last note.")
    }
}

let makeStandupRequest = {
    ChatRequest {
        ChatRequest.model("gpt-4o-realtime-preview")
        ChatRequest.messages {
            .system(content: .text("Keep answers concise."))
            .user(parts: [
                .text("Turn these bullet points into a standup update."),
                .fileData(.init(filename: "status.md", mimeType: "text/markdown", data: statusData))
            ])
        }
        ChatRequest.tools([
            .jsonSchema(
                name: "create_ticket",
                description: "Open a Jira ticket",
                schema: ticketSchema
            )
        ])
    }
}

do {
    _ = try await client.chatCompletion { /* ... */ }
} catch {
    let message = await client.errorCollector.getError() ?? error.localizedDescription
    presentAlert(message)
}