v0.13.0

What's in v0.13.0

A focused cleanup-and-correctness release. It removes a vestigial "default provider" mechanism that had no effect in production yet advertised a configuration path nothing honoured, and it clears up the misleading setup that prompted discussion #254.

⚠️ Breaking changes

• Default-provider fallback removed. setDefaultProvider() and getDefaultProvider() are gone from LlmServiceManagerInterface, the ExtensionConfiguration['nr_llm']['defaultProvider'] setting is no longer read, and LlmServiceManager::getProvider(null) now throws instead of silently falling back. These were a remnant of the pre-database, provider-centric design and were never populated in production (the key was never exposed in ext_conf_template.txt). See ADR-034.

  Migration — choose a provider in one of the two supported ways:

  • Per call: pass it in the options object — new ChatOptions(provider: 'openai') (likewise EmbeddingOptions / VisionOptions / ToolOptions).
  • As an instance default: mark a Configuration active and default in the LLM backend module, and the generic chat() / complete() / embed() entry points resolve it automatically.

  To read the configured default in code, use LlmConfigurationService::getDefaultConfiguration() (access-checked) or LlmConfigurationRepository::findDefault() (raw).

Fixed

• Removed the orphaned plugin.tx_nrllm TypoScript constants/setup that were registered but never read by any code and falsely implied TypoScript-driven provider selection. The "No provider specified and no default provider configured" exception now carries actionable guidance pointing to the backend module, and the configuration docs describe the database-backed setup. (#254, #255)

Maintenance

• PHPUnit 13 cross-compatibility (#249, #250), canonical TYPO3-extension CI template adoption (#247), and dependency updates (#246, #248).

Installation

composer require netresearch/nr-llm

Publication status

• TER: extensions.typo3.org/extension/nr_llm — 0.13.0 verified
• Packagist: packagist.org/packages/netresearch/nr-llm — 0.13.0 verified
• Documentation: docs.typo3.org/p/netresearch/nr-llm/0.13/en-us/ — render verified

Security

All release artifacts are signed with Sigstore keyless signing.

Verify signatures

cosign verify-blob \
  --bundle nr-llm-0.13.0.zip.sigstore.json \
  --certificate-identity-regexp "https://github.com/netresearch/.*" \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  nr-llm-0.13.0.zip

Verify checksums

sha256sum -c checksums.txt

Software Bill of Materials (SBOM)

SBOMs are provided in both SPDX and CycloneDX formats for supply chain transparency.

👥 Contributors

Thanks to everyone who made this release — code and reports alike:

• Code: @CybotTM
• Reported: @lradloff (raised discussion #254, which drove the fixes above)