UnusedConfigurationWarning
Defined in: packages/core/src/providers/configurationPassthrough.ts:140
Warn — naming the provider, saying why the block is dropped, naming every dropped path, and
pointing at the replacement — when a user’s configuration block carries settings this provider
cannot consume.
Warn rather than throw: a provider that reads SOME of the block (openrouter still honours
configuration.baseURL) would otherwise refuse a config that is partly valid, and an upgrading
user whose only config sets one dead transport key would be left with no way to start at all.
Takes ONE named-field object rather than a positional list. reason and guidance are both free
text, so as adjacent positionals they could be transposed with nothing to catch it: tsc sees two
strings, and the rendered message still contains both sentences — only their order is wrong, which
no toContain check on either one can see. Named fields make that mistake visible where it is
written; the slot-anchored pins in configurationPassthrough.spec.ts are what catch it if it is
written anyway.
Properties
Section titled “Properties”configuration
Section titled “configuration”configuration:
unknown
Defined in: packages/core/src/providers/configurationPassthrough.ts:144
The user’s llm.configuration block, exactly as it arrived.
consumedPaths
Section titled “consumedPaths”consumedPaths: readonly
string[]
Defined in: packages/core/src/providers/configurationPassthrough.ts:150
The paths inside the block this factory genuinely reads — whole keys or dotted one-level paths.
Required rather than defaulted to [], so a new caller has to state what its factory consumes
instead of inheriting an answer.
guidance
Section titled “guidance”guidance:
string
Defined in: packages/core/src/providers/configurationPassthrough.ts:162
What to do instead, naming the replacement on THIS provider’s own client — never a generic “move it up a level”, which for some keys moves a setting from a warned location to an unwarned one.
provider
Section titled “provider”provider:
string
Defined in: packages/core/src/providers/configurationPassthrough.ts:142
The gth provider namespace, printed to the user (anthropic, xai, …).
reason
Section titled “reason”reason:
string
Defined in: packages/core/src/providers/configurationPassthrough.ts:156
Why THIS provider drops the block, as a clause completing the "<provider>" provider …. Pass
NATIVE_CLIENT_REASON for a native-client provider; a provider that builds an OpenAI
client and then overrides the block needs its own, because that sentence would be false for it.