dependencies: [
    .package(url: "https://github.com/YOUR_USERNAME/SwiftAgent.git", from: "1.0.0")
]

import SwiftAgent

// Use EchoModel for testing (no API key needed)
let model = EchoModel()

// Or use OpenAI-compatible models
let openAI = OpenAICompatibleChatModel(
    baseURL: URL(string: "https://api.openai.com/v1")!,
    apiKey: "your-api-key",
    modelName: "gpt-4o"
)

// Create agent
let agent = AgentSDK(
    model: openAI,
    workingDirectory: URL(fileURLWithPath: "/path/to/workspace"),
    maxSteps: 10
)

// Run
let result = try await agent.run(prompt: "Read README.md and summarize it")
print(result.finalText)

struct MyTool: AgentTool {
    let name = "my_tool"
    let description = "Does something useful"
    let argumentSchemaJSON = #"{"type":"object","properties":{"input":{"type":"string"}},"required":["input"]}"#
    
    func run(argumentsJSON: String, context: ToolExecutionContext) async throws -> String {
        // Parse args, do work, return result
        return "Tool output"
    }
}

let skill = BasicSkill(
    name: "code-reviewer",
    systemPrompt: "You are a code reviewer...",
    tools: []
)

let agent = AgentSDK(model: model, skills: [skill], ...)

let skills = SkillLoader.loadSkills(from: skillsDirectory)

let compaction = CompactionConfig(
    enabled: true,
    modelContextWindow: 128_000,
    reserveTokens: 16_384,
    keepRecentTokens: 20_000
)

let agent = AgentSDK(model: model, compaction: compaction, ...)