@warlock.js/ai 4.7.0 → 4.8.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@warlock.js/ai` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 4.8.0 - 2026-07-19
+
+### Added
+
+- **`reasoning: { effort: "none" }`** — a neutral "run without reasoning, explicitly" level on `ReasoningEffort`; OpenAI emits `reasoning_effort: "none"` so gpt-5 / o-series accept function tools, and budget-based adapters (Anthropic / Bedrock / Google / Ollama) disable thinking.
+
 ## 4.7.0
 
 ### Added

package/esm/contracts/model.contract.d.mts

@@ -43,12 +43,20 @@ type ModelCallOptions = {
   /**
    * Reasoning / thinking-effort control for reasoning-capable models.
    * `effort` maps to OpenAI `reasoning_effort`; `maxTokens` caps the
-   * Anthropic extended-thinking budget. Adapters whose
-   * `capabilities.reasoning` is absent/false ignore this rather than
+   * Anthropic extended-thinking budget. `effort: "none"` runs the model
+   * **without reasoning, explicitly** — distinct from an absent `effort`
+   * (which requests the provider default, i.e. the model may still reason
+   * server-side). It is the only mode in which OpenAI's gpt-5 / o-series
+   * models accept function tools on the Chat Completions API. Adapters
+   * whose `capabilities.reasoning` is absent/false ignore this rather than
    * forwarding unsupported params. Absent = provider default.
    *
    * @example
    * await model.complete(messages, { reasoning: { effort: "high" } });
+   *
+   * @example
+   * // gpt-5 / o-series + tools: turn reasoning off so tools are accepted.
+   * await model.complete(messages, { reasoning: { effort: "none" }, tools });
    */
   reasoning?: {
     effort?: ReasoningEffort;
@@ -74,8 +82,18 @@ type ModelCallOptions = {
  * Reasoning/thinking-effort levels for reasoning-capable models. Maps to
  * the provider-native control (OpenAI `reasoning_effort`); adapters
  * without reasoning support ignore it.
+ *
+ * `"none"` means **run without reasoning, explicitly** — not "provider
+ * default" (that is what an absent `effort` requests). It exists because
+ * OpenAI's gpt-5 / o-series models reject function tools on Chat
+ * Completions while reasoning is active: the endpoint accepts tools only
+ * when `reasoning_effort` is sent as `"none"` (the alternative is the
+ * Responses API). The OpenAI adapter forwards `"none"` verbatim so
+ * tool-using agents work on those models; budget-based adapters
+ * (Anthropic / Google `thinking`, Ollama `think`, Bedrock) read `"none"`
+ * as "reasoning off" and disable the thinking channel.
  */
-type ReasoningEffort = "low" | "medium" | "high";
+type ReasoningEffort = "low" | "medium" | "high" | "none";
 /**
  * Declarative feature flags a `ModelContract` may expose so the agent can
  * short-circuit redundant work when the provider already enforces a

package/esm/contracts/model.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"model.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/contracts/model.contract.ts"],"mappings":";;;;;;;;;;AAqBA;;;;;;;;;;;;KAAY,gBAAA;EACV,WAAA;EACA,SAAA,WAkBA;EAhBA,KAAA,GAAQ,UAAA;EA2BR;;;;;;;;EAlBA,cAAA,GAAiB,MAAA;EA6CP;;;;AAAe;AAY3B;EAlDE,MAAA,GAAS,WAAA;;;;;;;;;;AA+FN;EApFH,SAAA;IACE,MAAA,GAAS,eAAA;IACT,SAAA;EAAA;EAkGK;;;;;;;;;;;EArFP,YAAA;IACE,WAAA;EAAA,GAkGwB;EAAA,CA/FzB,GAAA;AAAA;;;;;;KAQS,eAAA;;;;;;;;;;;KAYA,iBAAA;EA0FgD;AAAA;AAgB5D;;;;EAnGE,gBAAA;EA8HmB;;;;;;;EAtHnB,MAAA;EA2HsE;;;;;;EApHtE,SAAA;EA0GmB;;;;;EApGnB,aAAA;EAyG2D;;;;;;;;EAhG3D,KAAA;EAqGuF;AAAA;;;;;;EA7FvF,GAAA;AAAA;;;;;;;;;;;KAaU,aAAA;EACV,OAAA;EACA,YAAA,EAAc,YAAA;EACd,KAAA,EAAO,KAAA;EAEP,SAAA,GAAY,oBAAA;AAAA;;;;;;;;;;KAYF,gBAAA;EACN,IAAA;EAAe,OAAA;AAAA;EAEf,IAAA;EACA,EAAA;EACA,IAAA;EACA,KAAA;;;;;;;EAOA,gBAAA,GAAmB,MAAA;AAAA;EAEnB,IAAA;EAAc,YAAA,EAAc,YAAA;EAAc,KAAA,EAAO,KAAA;AAAA;;;;;;;;;;;;;;;UAgBtC,aAAA;;WAEN,IAAA;;WAEA,QAAA;;;;;;WAMA,YAAA,GAAe,iBAAA;;;;;;;;;;;WAYf,OAAA,GAAU,YAAA;;;;EAKnB,QAAA,CAAS,QAAA,EAAU,OAAA,IAAW,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,aAAA;;;;EAKnE,MAAA,CAAO,QAAA,EAAU,OAAA,IAAW,OAAA,GAAU,gBAAA,GAAmB,aAAA,CAAc,gBAAA;AAAA"}
+{"version":3,"file":"model.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/ai/src/contracts/model.contract.ts"],"mappings":";;;;;;;;;;AAqBA;;;;;;;;;;;;KAAY,gBAAA;EACV,WAAA;EACA,SAAA,WAkBA;EAhBA,KAAA,GAAQ,UAAA;EAmCR;;;;;;;;EA1BA,cAAA,GAAiB,MAAA;EA+DP;;;;AAAe;AAY3B;EApEE,MAAA,GAAS,WAAA;;;;;;;;;;AAiHN;AAaL;;;;;;;;EA3GE,SAAA;IACE,MAAA,GAAS,eAAA;IACT,SAAA;EAAA;EA4GK;;;;AAEyB;AAYlC;;;;;;EA7GE,YAAA;IACE,WAAA;EAAA,GA6GiB;EAAA,CA1GlB,GAAA;AAAA;;;;;;;;;;;AAwHyD;AAgB5D;;;;KAtHY,eAAA;;;;;;;;;;;KAYA,iBAAA;EA8GD;;;;;;EAvGT,gBAAA;EA8HS;;;;;;;EAtHT,MAAA;EA2HsC;;;;;AAAiD;EApHvF,SAAA;;;;;;EAMA,aAAA;;;;;;;;;EASA,KAAA;;;;;;;;EAQA,GAAA;AAAA;;;;;;;;;;;KAaU,aAAA;EACV,OAAA;EACA,YAAA,EAAc,YAAA;EACd,KAAA,EAAO,KAAA;EAEP,SAAA,GAAY,oBAAA;AAAA;;;;;;;;;;KAYF,gBAAA;EACN,IAAA;EAAe,OAAA;AAAA;EAEf,IAAA;EACA,EAAA;EACA,IAAA;EACA,KAAA;;;;;;;EAOA,gBAAA,GAAmB,MAAA;AAAA;EAEnB,IAAA;EAAc,YAAA,EAAc,YAAA;EAAc,KAAA,EAAO,KAAA;AAAA;;;;;;;;;;;;;;;UAgBtC,aAAA;;WAEN,IAAA;;WAEA,QAAA;;;;;;WAMA,YAAA,GAAe,iBAAA;;;;;;;;;;;WAYf,OAAA,GAAU,YAAA;;;;EAKnB,QAAA,CAAS,QAAA,EAAU,OAAA,IAAW,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,aAAA;;;;EAKnE,MAAA,CAAO,QAAA,EAAU,OAAA,IAAW,OAAA,GAAU,gBAAA,GAAmB,aAAA,CAAc,gBAAA;AAAA"}

package/package.json

@@ -15,14 +15,14 @@
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
-    "@warlock.js/cache": "4.7.0",
-    "@warlock.js/logger": "4.7.0",
+    "@warlock.js/cache": "4.8.0",
+    "@warlock.js/logger": "4.8.0",
     "langfuse": "*",
     "openai": "*",
     "pg": "*",
     "redis": "*"
   },
-  "version": "4.7.0",
+  "version": "4.8.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",