stopWhen and regen sdk

Author: mattapperson

.speakeasy/gen.lock

@@ -5,15 +5,15 @@ management:
   docVersion: 1.0.0
   speakeasyVersion: 1.680.0
   generationVersion: 2.788.4
-  releaseVersion: 0.3.7
-  configChecksum: 307fbb413f183f19cd9e45ff5e5a2212
+  releaseVersion: 0.3.9
+  configChecksum: 5d797923e4d4578f0ee560b2fe7abc13
   repoURL: https://github.com/OpenRouterTeam/typescript-sdk.git
   installationURL: https://github.com/OpenRouterTeam/typescript-sdk
   published: true
 persistentEdits:
-  generation_id: 89ff75fc-55b0-4eb8-ad25-82572b9903a7
-  pristine_commit_hash: 64d8d07c464614eda10ab00c5d6a1c1d25c943e3
-  pristine_tree_hash: ffaecc36e84561dcf0fb0693f6a4a2318da99e0c
+  generation_id: 588e1986-8f23-4d80-bc1c-5bcd6070be37
+  pristine_commit_hash: 3c4d1945159ff0fb5582484d3b5d9708bc66c184
+  pristine_tree_hash: 36ed457ade0bb24e476d3639393e2fcd24b7e9f1
 features:
   typescript:
     acceptHeaders: 2.81.2
@@ -1960,12 +1960,12 @@ trackedFiles:
     pristine_git_object: 410efafd6a7f50d91ccb87131fedbe0c3d47e15a
   jsr.json:
     id: 7f6ab7767282
-    last_write_checksum: sha1:86b61d7f53f41cc886e34272588043abc42ce372
-    pristine_git_object: 33a0a439a9e1692e39a89709ac03b89f25c13f30
+    last_write_checksum: sha1:059fd6564be5fc2274b6382fb3e9fc66b3d68c35
+    pristine_git_object: a4cfcee0b2bf3d8719d6832a232eb73cbeac17f0
   package.json:
     id: 7030d0b2f71b
-    last_write_checksum: sha1:72caad1939114ecb1c01391384b6fb11e52fc19b
-    pristine_git_object: ac2454d305ef0d146cbf7a82ee529fe3d94af8c8
+    last_write_checksum: sha1:d2126878c2ecc0292dbc33d388f204ecbe6c0656
+    pristine_git_object: 3ff44250b668ba6980c04fc2cf5156a540233fa6
   src/core.ts:
     id: f431fdbcd144
     last_write_checksum: sha1:5aa66b0b6a5964f3eea7f3098c2eb3c0ee9c0131
@@ -2088,8 +2088,8 @@ trackedFiles:
     pristine_git_object: a187e58707bdb726ca2aff74941efe7493422d4e
   src/lib/config.ts:
     id: 320761608fb3
-    last_write_checksum: sha1:3e3d67911460cf995c91cbe540ff9de9d91ae3e0
-    pristine_git_object: 19e037b620a9f45fd4d3fab34a0ec04f2f384b9d
+    last_write_checksum: sha1:a34860d9d0346a22407061b1bba9c0a01c03f00f
+    pristine_git_object: fd407fc9bb4c55f8ccca09f37d27bb0e5d750532
   src/lib/dlv.ts:
     id: b1988214835a
     last_write_checksum: sha1:eaac763b22717206a6199104e0403ed17a4e2711
@@ -2980,8 +2980,8 @@ trackedFiles:
     pristine_git_object: bb38b40427200e0d63b8e5b59c7b557239ac5102
   src/sdk/oauth.ts:
     id: 37b7f9b2970b
-    last_write_checksum: sha1:9066fa7baf0b904ca1aa96b654fbc79b3d6c3236
-    pristine_git_object: 12f35868fad83b3b6ce20fa340d2d9f8df7bbbd1
+    last_write_checksum: sha1:6bb4e2c2cc93c3a091cf07bb520071417cfc4184
+    pristine_git_object: 726510b58fe85770461429146121e8aef773b740
   src/sdk/parameters.ts:
     id: 6e4ef00c29b7
     last_write_checksum: sha1:7e24ad2dfe41aa7a22db6db309466433ddf8ebdb
@@ -2996,8 +2996,8 @@ trackedFiles:
     pristine_git_object: fc8f29b98cfb1a5aaf4e79aa4bf6572f0ca41e53
   src/sdk/sdk.ts:
     id: 784571af2f69
-    last_write_checksum: sha1:bcdd07970af60b24f60bc596fb20d3c0dbddb31d
-    pristine_git_object: ec947c79916d4fb0e88b9c257b1941c6b19388cc
+    last_write_checksum: sha1:8665c476ce15fd94c6fd07e4c6b163a7c7619387
+    pristine_git_object: 7b1a640d06c0edb9bcab25af3414668259c91c3b
   src/types/async.ts:
     id: fac8da972f86
     last_write_checksum: sha1:e2a7c53b428567587741f38e6da489f596de6227

.speakeasy/gen.yaml

@@ -33,7 +33,7 @@ generation:
     skipResponseBodyAssertions: false
   preApplyUnionDiscriminators: true
 typescript:
-  version: 0.3.7
+  version: 0.3.9
   acceptHeaderEnum: false
   additionalDependencies:
     dependencies: {}

examples/callModel-typed-tool-calling.example.ts

@@ -98,7 +98,7 @@ async function main() {
     model: "openai/gpt-4o-mini",
     input: "What's the weather like in Paris?",
     tools: [weatherTool] as const,
-    maxToolRounds: 0, // Don't auto-execute, just get the tool calls
+    stopWhen: 0, // Don't auto-execute, just get the tool calls
   });
 
   // Tool calls are now typed based on the tool definitions!
@@ -117,7 +117,7 @@ async function main() {
     model: "openai/gpt-4o-mini",
     input: "What's the weather in Tokyo?",
     tools: [weatherTool] as const,
-    maxToolRounds: 0,
+    stopWhen: 0,
   });
 
   // Stream tool calls with typed arguments

examples/tools-example.ts

@@ -6,22 +6,23 @@
  * 1. Validated using Zod schemas
  * 2. Executed when the model calls them
  * 3. Results sent back to the model
- * 4. Process repeats until no more tool calls (up to maxToolRounds)
+ * 4. Process repeats until no more tool calls (up to stopWhen)
  *
  * The API is simple: just call callModel() with tools, and await the result.
  * Tools are executed transparently before getMessage() or getText() returns!
  *
- * maxToolRounds can be:
- * - A number: Maximum number of tool execution rounds (default: 5)
- * - A function: (context: TurnContext) => boolean
- *   - Return true to allow another turn
- *   - Return false to stop execution
- *   - Context includes: numberOfTurns, messageHistory, model/models
+ * stopWhen options:
+ * - A StopCondition function: ({ steps }) => boolean
+ *   - Return true to STOP execution
+ *   - Return false to CONTINUE execution
+ *   - Helper functions: stepCountIs(n), hasToolCall(name), maxTokensUsed(n), maxCost(n)
+ * - An array of conditions (OR logic - stops if ANY condition returns true)
+ * - Default: stepCountIs(5) - stops after 5 steps
  */
 
 import * as dotenv from 'dotenv';
 import { z } from 'zod/v4';
-import { OpenRouter, ToolType } from '../src/index.js';
+import { OpenRouter, stepCountIs, ToolType } from '../src/index.js';
 
 // Type declaration for ShadowRealm (TC39 Stage 3 proposal)
 // See: https://tc39.es/proposal-shadowrealm/
@@ -75,13 +76,9 @@ async function basicToolExample() {
   const response = client.callModel({
     model: 'openai/gpt-4o',
     input: "What's the weather like in San Francisco?",
-    tools: [
-      weatherTool,
-    ],
-    // Example: limit to 3 turns using a function
-    maxToolRounds: (context) => {
-      return context.numberOfTurns < 3; // Allow up to 3 turns
-    },
+    tools: [weatherTool],
+    // Example: limit to 3 steps using helper function
+    stopWhen: stepCountIs(3), // Stop after 3 steps
   });
 
   // Tools are automatically executed! Just get the final message
@@ -249,7 +246,7 @@ async function manualToolExample() {
       // Safely evaluate the math expression using ShadowRealm
       try {
         const _result = safeEvaluateMath(expression);
-      } catch (_error) {}
+      } catch (_error) { }
     }
   }
 
@@ -375,7 +372,7 @@ async function main() {
     await manualToolExample();
     await streamingToolCallsExample();
     await multipleToolsExample();
-  } catch (_error) {}
+  } catch (_error) { }
 }
 
 // Only run if this file is executed directly

jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [

src/core.ts

@@ -3,7 +3,7 @@
  * @generated-id: f431fdbcd144
  */
 
-import { ClientSDK } from "./lib/sdks.js";
+import { ClientSDK } from './lib/sdks.js';
 
 /**
  * A minimal client to use when calling standalone SDK functions. Typically, an