OpenAPSSwift

A standalone Swift Package extraction of the oref0 algorithm port from nightscout/Trio, branch feat/dev-oref-swift. Carved out so a host project can call oref's determineBasal (and friends) without depending on the full Trio application.

This is the source used by loopkitdev/LoopEval as a second DosingEngine for closed-loop counterfactual evaluation.

What's in the box

Sources/OpenAPSSwift/        — the library
  OpenAPSSwift.swift         — public façade: makeProfile, meal,
                                autosense, iob, determineBasal
  JSONBridge.swift           — JSON-in/JSON-out boundary
  OrefFunctionResult.swift   — typed result wrapper
  Helpers/                   — JSON, rounding, formatters, Decimal/Date
                                bridges, logging shim
  Engine subdirs             — Autosens, DetermineBasal, Forecasts,
                                Iob, Meal, Models, Profile, Utils,
                                TrioModels
Sources/OpenAPSSwiftSmoke/   — executable smoke target (sanity-check
                                that the package builds and the public
                                API is reachable)

74 Swift source files. All public entry points are JSON-in / JSON-out so the package can be linked against any host without dragging in Trio's app-level types.

Usage

import OpenAPSSwift

let determinationJSON = try OpenAPSSwift.determineBasal(
    iobInputs:    iobJSON,
    meal:         mealJSON,
    profile:      profileJSON,
    glucose:      glucoseJSON,
    currentTemp:  tempJSON,
    autosens:     autosensJSON,
    pumpHistory:  pumpHistoryJSON,
    preferences:  prefsJSON
)

See Sources/OpenAPSSwiftSmoke/main.swift for a worked example, and the OpenAPSAdapter in LoopEval (Sources/EvalCore/Engine/OpenAPSAdapter.swift) for a full host integration that translates simulator state into the JSON shapes above and back.

Building

swift build
swift build -c release
swift run OpenAPSSwiftSmoke   # builds + runs the smoke executable

Requires Swift 6.0 toolchain (declared in Package.swift). Tested on macOS 13+ and iOS 15+.

Licensing

AGPL-3.0 (see LICENSE). Trio is licensed AGPL-3.0; because this extraction is a derived work, the same license applies. If you link this into a network-served application, the AGPL-3.0 obligations apply to your service.

Provenance

Synced 2026-10-24 to Trio v1.0.2: the algorithm file set of Trio's own AlgorithmPackage (Trio/Sources/APS/OpenAPSSwift/, APS/Extensions/DecimalExtensions.swift, and the models and helpers it lists), taken from branch enable-oref-as-non-testing-package @ 95cb8acf1, whose algorithm files equal main @ 0b29cd534 (release v1.0.2) up to access control. Plus Helpers/TempTargetCalculations.swift, which the app layer uses when it builds the profile.

OpenAPSSwift.swift is this package's own JSON façade. Trio 1.0's app calls the generators natively and does some algorithm-relevant work around them (temp-target half-basal adjustment, pump rate table, duplicate suspend/resume removal, the 8 h/24 h autosens choice, the insufficient-TDD guard on dynamic ISF); the façade reproduces it, see the doc comment there.

Tests/OpenAPSSwiftTests is Trio's own algorithm test suite at the same commit, run against this package (swift test; the parity goldens need TZ=Europe/Berlin). All 226 tests and the 14 golden scenarios pass.

The June 2026 extraction from feat/dev-oref-swift (Trio ~0.7-era behaviour, e.g. dynamic ISF off at a high target with high_temptarget_raises_sensitivity) is tagged oref-2026-06.

No algorithm changes from the upstream Trio extraction — this package is a packaging change only. Bug fixes and behavior changes that show up here should be considered for upstreaming to Trio.

Related projects

• nightscout/Trio — the source project, full app + algorithm.
• openaps/oref0 — the original JavaScript algorithm that Trio's Swift port mirrors.
• loopkitdev/LoopEval — the primary host for this package; provides Loop-vs-OAPS closed-loop counterfactual evaluation.