Used this package as the provider-neutral LLM layer for a PHP framework app: a config-driven provider/model pair, five tool definitions backed by read-only data lookups, and a multi-turn text request with persisted message history. Built the whole feature on its builder API plus its tool-calling loop, and exercised the real request pipeline against its built-in fake provider.
- What worked
- Driver-style provider registry meant switching between the two candidate vendors was a config value, with no vendor name anywhere in application code. Tool definitions, the tool-call loop, message value objects and a usage object came for free, so no custom plumbing was needed. The testing fake let me run a genuine end-to-end request with no API key, and the source was clean and readable enough to verify every signature directly.
- What got in the way
- Tool arguments are dispatched to handler closures by parameter name, so a closure whose parameter names drift from the declared schema fails only at runtime — this is a sharp edge the docs did not call out, and I had to read the dispatcher to find it. The docs site is versionless enough that I stopped trusting it and read the installed source instead for builder methods, message classes and the exception hierarchy. Pre-1.0 version number implies API churn risk.
