Skip to content

Core v1.0.0-beta.2

Pre-release
Pre-release

Choose a tag to compare

View all tags
@thisbrainai thisbrainai released this 03 Sep 00:40
v1.0.0-beta.2
a9428ae
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

1.0.0-beta.2

The SDK now builds one app for macOS 26 and macOS 27. Previously 1.0.0-beta required macOS 27.

LocalLMLabSDKCore, LocalLMLabSDKInference, and LocalLMLabSDKComponents all target macOS 26. Register SystemModelProvider() unconditionally and the macOS-27-only providers inside one if #available(macOS 27, *) block — makeSession, respond, events, connectors, MCP, and the pickers are the same code on both OSes. On macOS 26, Private Cloud Compute / Claude / open-weight (MLX) models report as unavailable rather than failing the build. See examples/os-matrix and docs/sdk-guide.md.

Breaking changes

ClaudeModelProvider moved to a new LocalLMLabSDKClaude.xcframework. It depends on ClaudeForFoundationModels, which requires macOS 27, so it can't ship in the macOS-26 Core. If you use Claude: add the LocalLMLabSDKClaude binary target (from the same release), import LocalLMLabSDKClaude, and set a macOS 27 deployment target on the target that links it. To ship a macOS 26 app and offer Claude, isolate the Claude path in a separate macOS-27-only target.

ModelProvider protocol. languageModel(for:) -> any LanguageModel is now makeSession(for:tools:instructions:transcript:) -> LanguageModelSession. Only affects custom ModelProvider conformances; lab.makeSession(route:…) is unchanged.

Added

  • ModelAvailability.UnavailableKind.requiresOS(_:) and ModelRegistry.schemesRequiringNewerOS — on macOS 26, lab.models.availability(for: .pcc) returns .requiresOS("macOS 27").
  • ModelPickerView shows the macOS-27-only model families as disabled "Requires macOS 27" rows on macOS 26. New show27OnlyModels parameter to hide them instead.
  • examples/os-matrix — one .macOS("26.0") build that runs on both OSes.

Fixed

  • FoundationModels errors that showed as "The operation couldn't be completed. (…error -1.)" now report the actual cause (context-window overflow, guardrail, model assets unavailable, …) on both macOS 26 and macOS 27.

Assets

LocalLMLabSDKCore-1.0.0-beta.2.xcframework.zip
e3e687e503d3c563e6548b472dc8eb415475f0402845e9b4a56c58c15105c974

LocalLMLabSDKClaude-1.0.0-beta.2.xcframework.zip
fd0489be28f6c1dc589161d978ef39718605c01483eebd0efc29e206e406525f

LocalLMLabSDKInference-1.0.0-beta.2.xcframework.zip
728bc399a96a851f1e46c6f709684133f40dc09b067a0717e1898ab11156e8a8

Build against a version with LOCALLM_SDK_VERSION=1.0.0-beta.2

Assets 8
Loading