add(ci): github actions, mintfile, and makefile with mint run

Tom-Ryder · Tom-Ryder · commit f995b9040fbf · 2026-03-25T22:32:45.000-07:00
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+    paths-ignore: ['**.md']
+  pull_request:
+    paths-ignore: ['**.md']
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.head_ref || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: macos-26
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+      - name: Install Mint
+        run: brew install mint
+      - uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+        with:
+          path: ~/.mint
+          key: mint-${{ hashFiles('Mintfile') }}
+          restore-keys: mint-
+      - name: Bootstrap tools
+        run: mint bootstrap
+      - name: SwiftFormat
+        run: mint run swiftformat --lint .
+      - name: SwiftLint
+        run: mint run swiftlint --strict
+
+  test-macos:
+    runs-on: macos-26
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+      - uses: actions/cache@cdf6c1fa76f9f475f3d7449005a359c84ca0f306 # v5.0.3
+        with:
+          path: .build
+          key: macos-spm-${{ hashFiles('Package.resolved', 'Package.swift') }}
+          restore-keys: macos-spm-
+      - name: Run tests
+        run: swift test --parallel -Xswiftc -warnings-as-errors
+
+  check:
+    if: always()
+    needs: [lint, test-macos]
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Verify all jobs passed
+        run: |
+          if [[ "${{ needs.lint.result }}" != "success" || \
+                "${{ needs.test-macos.result }}" != "success" ]]; then
+            echo "Required jobs failed:"
+            echo "  lint: ${{ needs.lint.result }}"
+            echo "  test-macos: ${{ needs.test-macos.result }}"
+            exit 1
+          fi
diff --git a/Makefile b/Makefile
@@ -1,4 +1,8 @@
-.PHONY: build test lint format check clean
+.PHONY: build test lint format check clean bootstrap
+
+bootstrap:
+	brew install mint
+	mint bootstrap
 
 build:
 	swift build
@@ -7,10 +11,10 @@ test:
 	swift test
 
 lint:
-	swiftlint
+	mint run swiftlint --strict
 
 format:
-	swiftformat .
+	mint run swiftformat .
 
 check: format lint test
 
diff --git a/Mintfile b/Mintfile
@@ -0,0 +1,2 @@
+nicklockwood/SwiftFormat@0.60.1
+realm/SwiftLint@0.63.0
diff --git a/README.md b/README.md
@@ -52,6 +52,7 @@
   - [Per-Request Customization](#per-request-customization)
 - [LLM Providers](#llm-providers)
   - [Anthropic Messages API](#anthropic-messages-api)
+  - [Google Gemini](#google-gemini)
   - [OpenAI Responses API](#openai-responses-api)
   - [ChatGPT Subscription (OAuth)](#chatgpt-subscription-oauth)
   - [Proxy Mode](#proxy-mode)
@@ -459,10 +460,10 @@ let client = OpenAIClient(
     reasoningConfig: .high
 )
 
-// Via OpenAI Responses API (native reasoning with GPT-5.2)
+// Via OpenAI Responses API (native reasoning with GPT-5.4)
 let client = ResponsesAPIClient(
     apiKey: apiKey,
-    model: "gpt-5.2",
+    model: "gpt-5.4",
     baseURL: ResponsesAPIClient.openAIBaseURL,
     reasoningConfig: .medium
 )
@@ -1303,14 +1304,31 @@ The header closure is evaluated per request, enabling dynamic values.
 
 </details>
 
+### Google Gemini
+
+`GeminiClient` speaks the [Gemini REST API](https://ai.google.dev/api/generate-content) natively — thinking, tool calling, structured output, and streaming.
+
+```swift
+let client = GeminiClient(
+    apiKey: ProcessInfo.processInfo.environment["GEMINI_API_KEY"]!,
+    model: "gemini-3.1-pro-preview",
+    reasoningConfig: .high
+)
+
+let agent = Agent<EmptyContext>(client: client, tools: [myTool])
+let result = try await agent.run(userMessage: "Analyze this data", context: EmptyContext())
+```
+
+Works with any Gemini model — 2.5 Flash, 2.5 Pro, 3 Flash, 3.1 Pro, 3.1 Flash-Lite, and the `customtools` variant. Thinking budget and effort levels map to Gemini's native `thinkingConfig`.
+
 ### OpenAI Responses API
 
 `ResponsesAPIClient` speaks OpenAI's [Responses API](https://platform.openai.com/docs/api-reference/responses) — a newer endpoint with native support for reasoning models, server-side conversation state, and structured tool calling.
 
 ```swift
 let client = ResponsesAPIClient(
     apiKey: ProcessInfo.processInfo.environment["OPENAI_API_KEY"]!,
-    model: "gpt-5.2",
+    model: "gpt-5.4",
     baseURL: ResponsesAPIClient.openAIBaseURL,
     reasoningConfig: .medium
 )
@@ -1341,7 +1359,7 @@ let auth = try JSONDecoder().decode(CodexAuth.self, from: authData)
 
 // 2. Create client pointing at ChatGPT backend
 let client = ResponsesAPIClient(
-    model: "gpt-5.2",
+    model: "gpt-5.4",
     maxOutputTokens: nil,          // not supported on this endpoint
     baseURL: ResponsesAPIClient.chatGPTBaseURL,
     additionalHeaders: {
@@ -1369,7 +1387,7 @@ The ChatGPT backend enforces specific constraints:
 | `max_output_tokens` | Not supported — set `maxOutputTokens: nil` |
 | `instructions` | Required — always provide a system prompt |
 
-Reasoning models (GPT-5.2, GPT-5.2-codex) work fully, including interleaved thinking with opaque reasoning block echo-back across tool-calling turns.
+Reasoning models (GPT-5.4, GPT-5.3-Codex) work fully, including interleaved thinking with opaque reasoning block echo-back across tool-calling turns.
 
 ### Proxy Mode
 
@@ -1472,8 +1490,9 @@ The client bridges `AnyTool` definitions to Apple's `Tool` protocol at runtime v
 |------|-------------|
 | `LLMClient` | Protocol for LLM implementations |
 | `AnthropicClient` | Anthropic Messages API client (Claude Sonnet, Opus, Haiku) |
+| `GeminiClient` | Google Gemini API client (2.5 Flash/Pro, 3 Flash, 3.1 Pro/Flash-Lite) |
 | `OpenAIClient` | Chat Completions client (OpenAI, OpenRouter, Groq, etc.) |
-| `ResponsesAPIClient` | OpenAI Responses API client (GPT-5.2, GPT-5.2-codex) |
+| `ResponsesAPIClient` | OpenAI Responses API client (GPT-5.4, GPT-5.3-Codex) |
 | `MLXClient` | On-device inference via MLX on Apple Silicon (Qwen 3.5, Liquid LFM2.5, etc.) |
 | `FoundationModelsClient` | On-device inference via Apple Foundation Models (iOS 26+ / macOS 26+) |
 | `ThinkTagParser` | Streaming `<think>` tag parser with configurable delimiters |
diff --git a/Tests/.swiftlint.yml b/Tests/.swiftlint.yml
@@ -0,0 +1,15 @@
+parent_config: ../.swiftlint.yml
+
+disabled_rules:
+  - trailing_comma
+  - function_default_parameter_at_end
+  - no_empty_block
+  - identical_operands
+
+file_length:
+  warning: 1000
+  error: 1500
+
+type_body_length:
+  warning: 400
+  error: 600

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+nicklockwood/SwiftFormat@0.60.1`
	`2`	`+realm/SwiftLint@0.63.0`