@wildo-ai/external-connectors-models 1.1.2 → 1.1.3

package/dist/esm/protocols/llm.external-connectors-models.schemas.js

@@ -125,8 +125,14 @@ export var LLM_Model_Thinking_Capability;
     LLM_Model_Thinking_Capability["OPTIONAL"] = "optional";
     /**
      * The model ALWAYS reasons and thinking CANNOT be disabled (o-series,
-     * Claude 5). Every effort is valid EXCEPT `NONE` — asking such a model not to
-     * think is a provider error, not a preference.
+     * `claude-fable-5`). Every effort is valid EXCEPT `NONE` — asking such a model
+     * not to think is a provider error, not a preference.
+     *
+     * NOT a property of a model FAMILY: measured 2026-09-08, `claude-fable-5`
+     * refuses `thinking.type.disabled` while `claude-sonnet-5` and
+     * `claude-opus-5` accept it. Both siblings carried this value on the family's
+     * behalf for a month, which made `validateReasoningEffortForModel` refuse a
+     * configuration the provider would have honoured.
      */
     LLM_Model_Thinking_Capability["ALWAYS"] = "always";
 })(LLM_Model_Thinking_Capability || (LLM_Model_Thinking_Capability = {}));
@@ -291,8 +297,8 @@ export const LLMProvider_ToolChoice_Schema = z.union([
  * OpenAI o-series, Claude 5 thinking, Gemini reasoning, …). The values mirror
  * the AI SDK 7 top-level `reasoning` option EXACTLY, which the SDK translates to
  * each provider's native reasoning setting (OpenAI `reasoning_effort`, Anthropic
- * thinking budget, …). Omit for non-reasoning models or to accept the provider
- * default.
+ * `output_config.effort`, …). Omit for non-reasoning models or to accept the
+ * provider default.
  *
  * Effort ladder (cost/latency ↑ with depth):
  * - `NONE` — reasoning off; mechanical tasks (extraction, formatting, labelling).
@@ -303,20 +309,30 @@ export const LLMProvider_ToolChoice_Schema = z.union([
  * - `PROVIDER_DEFAULT` — explicitly defer to the model's own default effort.
  *
  * NOT EVERY MODEL SUPPORTS EVERY LEVEL — the SDK forwards the value and the
- * provider validates it. Support matrix VERIFIED LIVE (2026-07-16/17); pick a
- * level the target model actually supports:
+ * provider validates it. Support matrix VERIFIED LIVE (2026-09-08), per MODEL
+ * rather than per family, because the family is not uniform:
+ *
+ * | Model                                | Supported                       | Rejected                      |
+ * |--------------------------------------|---------------------------------|-------------------------------|
+ * | GPT-5.6 sol / terra / luna           | none, low, medium, high, xhigh  | `minimal`, `provider-default` |
+ * | claude-fable-5                       | low, medium, high, xhigh        | **`none`**, `minimal`, `provider-default` |
+ * | claude-sonnet-5 · claude-opus-5      | none, low, medium, high, xhigh  | `minimal`, `provider-default` |
  *
- * | Model family        | Supported                          | Rejected                       |
- * |---------------------|------------------------------------|--------------------------------|
- * | OpenAI GPT-5.6      | none, low, medium, high, xhigh     | `minimal`, `max`               |
- * | Anthropic Claude 5  | low, medium, high, xhigh           | **`none`** — thinking CANNOT   |
- * | (fable-5, …)        |                                    | be disabled ("thinking.type.   |
- * |                     |                                    | disabled is not supported…";   |
- * |                     |                                    | defaults to adaptive)          |
+ * ⚠️ `NONE` is NOT portable, but the line is finer than "OpenAI yes, Anthropic
+ * no": `claude-fable-5` alone refuses it. Its siblings accept it, so a level
+ * that is legal on `claude-sonnet-5` can still be illegal on `claude-fable-5` —
+ * which is why the capability is a per-model probed fact and never a family
+ * assumption. `PROVIDER_DEFAULT` is rejected as an explicit value by BOTH
+ * providers — omit the field entirely for the model's own default.
  *
- * ⚠️ `NONE` is therefore NOT portable: it turns reasoning off on GPT-5.6 but
- * ERRORS on Claude 5. `PROVIDER_DEFAULT` as an explicit value is also rejected
- * by GPT-5.6 — omit the field entirely for the model's default instead.
+ * How each provider expresses this natively, since the vocabularies differ and
+ * Anthropic's changed: OpenAI takes `reasoning_effort: <level>`. Anthropic
+ * takes `thinking: {type:'disabled'}` for `NONE`, and otherwise
+ * `thinking: {type:'adaptive'}` + `output_config: {effort: <level>}` — its
+ * accepted set is `low|medium|high|xhigh|max`, so `max` exists there and is
+ * deliberately NOT an enum member (OpenAI rejects it, and a level only one
+ * provider honours would not be portable). The older
+ * `thinking: {type:'enabled', budget_tokens}` form is RETIRED and now 400s.
  */
 export var LLMProvider_ReasoningEffort;
 (function (LLMProvider_ReasoningEffort) {
@@ -350,7 +366,7 @@ export const LLM_MODEL_CATALOG = {
     [LLM_Model.OPEN_AI_GPT_5_6_SOL]: {
         providerRef: "openai",
         availability: LLM_Model_Availability.PRODUCTION,
-        probedOn: "2026-07-16",
+        probedOn: "2026-09-08",
         applicabilities: [LLM_Model_Applicability.DEEP_JUDGMENT, LLM_Model_Applicability.LONG_CONTEXT_ANALYSIS],
         ioCapabilities: [
             LLM_Model_IO_Capability.MULTIMODAL_VISION,
@@ -366,7 +382,7 @@ export const LLM_MODEL_CATALOG = {
     [LLM_Model.OPEN_AI_GPT_5_6_TERRA]: {
         providerRef: "openai",
         availability: LLM_Model_Availability.PRODUCTION,
-        probedOn: "2026-07-16",
+        probedOn: "2026-09-08",
         applicabilities: [LLM_Model_Applicability.STRUCTURED_AUTHORING, LLM_Model_Applicability.VISUAL_JUDGMENT],
         ioCapabilities: [
             LLM_Model_IO_Capability.MULTIMODAL_VISION,
@@ -380,7 +396,7 @@ export const LLM_MODEL_CATALOG = {
     [LLM_Model.OPEN_AI_GPT_5_6_LUNA]: {
         providerRef: "openai",
         availability: LLM_Model_Availability.PRODUCTION,
-        probedOn: "2026-07-16",
+        probedOn: "2026-09-08",
         applicabilities: [LLM_Model_Applicability.HIGH_VOLUME_MECHANICAL],
         ioCapabilities: [LLM_Model_IO_Capability.STRUCTURED_OUTPUTS, LLM_Model_IO_Capability.TOOL_USE],
         thinkingCapability: LLM_Model_Thinking_Capability.OPTIONAL,
@@ -413,14 +429,18 @@ export const LLM_MODEL_CATALOG = {
     [LLM_Model.OPEN_AI_O4_MINI]: { providerRef: "openai", availability: LLM_Model_Availability.PRODUCTION, probedOn: "2026-07-16", applicabilities: [] },
     // ---------------------------------------------------------------
     // Anthropic — ids verified LIVE against `GET /v1/models` (2026-07-16).
-    // The Claude 5 family reasons ADAPTIVELY and cannot be told not to:
-    // live, `reasoning: 'none'` → 400 "thinking.type.disabled is not supported
-    // for this model; thinking defaults to adaptive".
+    //
+    // Thinking posture re-probed 2026-09-08 and it is PER MODEL, not per family.
+    // `claude-fable-5` refuses `thinking: {type:'disabled'}` (400 "…is not
+    // supported for this model; thinking defaults to adaptive") — ALWAYS.
+    // `claude-sonnet-5` and `claude-opus-5` ACCEPT it (200) — OPTIONAL. All three
+    // reject `minimal` and `provider-default` as `output_config.effort` values,
+    // whose accepted set is `low|medium|high|xhigh|max`.
     // ---------------------------------------------------------------
     [LLM_Model.CLAUDE_FABLE_5]: {
         providerRef: "anthropic",
         availability: LLM_Model_Availability.PRODUCTION,
-        probedOn: "2026-07-16",
+        probedOn: "2026-09-08",
         applicabilities: [
             LLM_Model_Applicability.DEEP_JUDGMENT,
             LLM_Model_Applicability.LONG_CONTEXT_ANALYSIS,
@@ -432,7 +452,10 @@ export const LLM_MODEL_CATALOG = {
             LLM_Model_IO_Capability.TOOL_USE,
             LLM_Model_IO_Capability.LONG_CONTEXT,
         ],
+        // The ONLY model that still refuses `thinking: {type:'disabled'}` (re-probed
+        // 2026-09-08); its two siblings accept it, so this value is not the family's.
         thinkingCapability: LLM_Model_Thinking_Capability.ALWAYS,
+        unsupportedReasoningEfforts: [LLMProvider_ReasoningEffort.MINIMAL, LLMProvider_ReasoningEffort.PROVIDER_DEFAULT],
         rejectsExplicitTemperature: true,
     },
     [LLM_Model.CLAUDE_OPUS_5]: {
@@ -440,7 +463,9 @@ export const LLM_MODEL_CATALOG = {
         availability: LLM_Model_Availability.PRODUCTION,
         // Probed live 2026-09-04 by the switch of the ACP coding/research lane onto it (it had been
         // every host-managed session's silent operator default long before it had an enum member).
-        probedOn: "2026-09-04",
+        // Re-probed 2026-09-08 once it gained an `LLM_SMOKE` entry, which corrected
+        // `thinkingCapability` from an inherited ALWAYS to the measured OPTIONAL.
+        probedOn: "2026-09-08",
         applicabilities: [
             LLM_Model_Applicability.DEEP_JUDGMENT,
             LLM_Model_Applicability.LONG_CONTEXT_ANALYSIS,
@@ -454,13 +479,14 @@ export const LLM_MODEL_CATALOG = {
             LLM_Model_IO_Capability.CODE_GENERATION,
             LLM_Model_IO_Capability.LONG_CONTEXT,
         ],
-        thinkingCapability: LLM_Model_Thinking_Capability.ALWAYS,
+        thinkingCapability: LLM_Model_Thinking_Capability.OPTIONAL,
+        unsupportedReasoningEfforts: [LLMProvider_ReasoningEffort.MINIMAL, LLMProvider_ReasoningEffort.PROVIDER_DEFAULT],
         rejectsExplicitTemperature: true,
     },
     [LLM_Model.CLAUDE_SONNET_5]: {
         providerRef: "anthropic",
         availability: LLM_Model_Availability.PRODUCTION,
-        probedOn: "2026-07-16",
+        probedOn: "2026-09-08",
         applicabilities: [
             LLM_Model_Applicability.STRUCTURED_AUTHORING,
             LLM_Model_Applicability.WORKSPACE_CODING_AGENT,
@@ -471,7 +497,8 @@ export const LLM_MODEL_CATALOG = {
             LLM_Model_IO_Capability.TOOL_USE,
             LLM_Model_IO_Capability.CODE_GENERATION,
         ],
-        thinkingCapability: LLM_Model_Thinking_Capability.ALWAYS,
+        thinkingCapability: LLM_Model_Thinking_Capability.OPTIONAL,
+        unsupportedReasoningEfforts: [LLMProvider_ReasoningEffort.MINIMAL, LLMProvider_ReasoningEffort.PROVIDER_DEFAULT],
         rejectsExplicitTemperature: true,
     },
     [LLM_Model.CLAUDE_OPUS_4_8]: {
@@ -733,7 +760,28 @@ export const validateReasoningEffortForModel = (model, effort) => {
  * REJECTS an explicit `temperature`).
  */
 export const LLMProvider_OperationModelConfiguration_Schema = z.object({
-    model: z.string(),
+    /**
+     * A CONCRETE model id — the escape hatch, and no longer the ordinary way to answer "which model".
+     *
+     * Declare {@link modelApplicability} instead unless you specifically need THIS id: a fine-tuned
+     * or custom deployment, or an agent pinned for a reason worth writing down. Naming an id at each
+     * agent is what the applicability axis exists to replace — a monthly model launch then means one
+     * catalog edit rather than N definition edits, and nobody has to re-audit which agents should
+     * move.
+     *
+     * Exactly one of `model` / `modelApplicability` must be present (refined below).
+     */
+    model: z.string().optional(),
+    /**
+     * The KIND of work this agent does — resolved to a concrete id at agent registration through
+     * `resolveModelForApplicability`, against the agent's own `providerRef`.
+     *
+     * This is the durable form: it survives model launches and retirements, and it states the
+     * cost/quality trade the author actually made. Resolution FAILS CLOSED with a named error, so an
+     * applicability no model of this provider serves is a startup error rather than a silent
+     * substitution.
+     */
+    modelApplicability: z.enum(LLM_Model_Applicability).optional(),
     providerRef: z.string(),
     temperature: z.number().optional(),
     maxTokens: z.number().optional(),
@@ -759,6 +807,20 @@ export const LLMProvider_OperationModelConfiguration_Schema = z.object({
     toolingFunctionEnabled: z.boolean().optional(),
     mcpCompatible: z.boolean().optional(),
     toolChoice: LLMProvider_ToolChoice_Schema.optional(),
+}).refine((config) => (config.model === undefined) !== (config.modelApplicability === undefined), {
+    /*
+     * EXACTLY ONE, and both halves of that matter.
+     *
+     * NEITHER is the state this refinement mainly exists for — `model` used to be required, so
+     * omitting it is the new mistake and it must not reach a runtime that then has nothing to call.
+     *
+     * BOTH is the subtler one: a config carrying an id AND a class states two answers to one
+     * question, and whichever the resolver happened to prefer would be a silent decision. It is
+     * also exactly how the axis would have died — an applicability that coexists with the id it was
+     * meant to replace changes nothing, which is the trap #439 records.
+     */
+    message: 'An LLM configuration must declare EXACTLY ONE of `model` (a concrete id — the escape hatch for fine-tuned or pinned deployments) or `modelApplicability` (the kind of work, resolved to an id at registration). Declaring both states two answers to one question; declaring neither leaves nothing to call.',
+    path: ['model'],
 });
 /** @wildo_source:part:end saas.external-providers.llm.model-configuration */
 // ===============================================================