@agent-api/sdk 1.0.3 → 1.0.4

package/CHANGELOG.md

@@ -1,11 +1,18 @@
 # Changelog — @agent-api/sdk
 
+## 1.0.4
+
+### Added
+
+- `preferred_sites` create-run parameter (up to 3 hostnames) to bias web search and fetch toward specific domains when allowed tools include `web_search` or `web_fetch`.
+
 ## 1.0.3
 
 ### Added
 
 - Workbench volume APIs: `summarize`, `grep`, `readLines`, `patchLines`, `downloadArchive`.
 - `responses.retrieveVolume` for `GET /v1/responses/{response_id}/volume`.
+- Create-run params `model_routing` (`auto` | `chain`) and `routing_strategy` (`balanced` | `high-quality` | `cost-effective`) for platform model selection when `model_routing` is `auto`.
 
 ### Changed
 

package/README.md

@@ -2,7 +2,7 @@
 
 Production JavaScript/TypeScript SDK for the Managed Agent API.
 
-**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.0.2)
+**Published on npm:** [`@agent-api/sdk`](https://www.npmjs.com/package/@agent-api/sdk) (v1.0.4)
 
 ## Install
 
@@ -106,6 +106,21 @@ for await (const event of stream) {
 }
 ```
 
+## Model routing
+
+Use `model_routing: "auto"` to let the platform pick a model (openmark). Optionally constrain the pool with `models`, and tune selection with `routing_strategy`:
+
+```typescript
+const response = await client.responses.create({
+  input: "Compare two cloud providers for ML workloads.",
+  model_routing: "auto",
+  routing_strategy: "cost-effective",
+  models: ["openai/gpt-5.4", "google/gemini-3-flash-preview"],
+});
+```
+
+Use model ids in vendor/model form (values from `client.models.list()`). Omit `model_routing` (or set `"chain"`) for strict fallback order via `model` / `models`. `routing_strategy` is only valid when `model_routing` is `"auto"`.
+
 ## Client options
 
 ```typescript

package/dist/types/common.d.ts

@@ -3,6 +3,8 @@ export type JSONValue = JSONPrimitive | JSONValue[] | {
     [key: string]: JSONValue;
 };
 export type AgentCapabilityPreference = "off" | "auto" | "preferred" | "required";
+export type ModelRoutingMode = "auto" | "chain";
+export type ModelRoutingStrategy = "balanced" | "high-quality" | "cost-effective";
 export interface ClientOptions {
     apiKey?: string;
     baseURL?: string;

package/dist/types/responses.d.ts

@@ -1,4 +1,4 @@
-import type { AgentCapabilityPreference, ErrorInfo, OutputItemStatus, ResponseStatus, Usage } from "./common.js";
+import type { AgentCapabilityPreference, ErrorInfo, ModelRoutingMode, ModelRoutingStrategy, OutputItemStatus, ResponseStatus, Usage } from "./common.js";
 import type { ContentPart, Input, MemoryOptions, ReasoningConfig, ResponseFormat } from "./input.js";
 import type { Tool } from "./tools.js";
 export interface ResponseCreateParamsBase {
@@ -7,6 +7,8 @@ export interface ResponseCreateParamsBase {
     language_preference?: string;
     model?: string;
     models?: string[];
+    model_routing?: ModelRoutingMode;
+    routing_strategy?: ModelRoutingStrategy;
     preset?: "fast-search" | "pro-search" | "deep-research" | "advanced-deep-research" | string;
     max_output_tokens?: number;
     max_steps?: number;
@@ -19,6 +21,7 @@ export interface ResponseCreateParamsBase {
     store?: boolean;
     previous_response_id?: string;
     volume_id?: string;
+    preferred_sites?: string[];
     prompt_cache_key?: string;
     memory?: MemoryOptions;
     plan_mode_preference?: AgentCapabilityPreference;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.0.3";
-export declare const USER_AGENT = "@agent-api/sdk/1.0.3";
+export declare const VERSION = "1.0.4";
+export declare const USER_AGENT = "@agent-api/sdk/1.0.4";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "1.0.3";
+export const VERSION = "1.0.4";
 export const USER_AGENT = `@agent-api/sdk/${VERSION}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-api/sdk",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Production JavaScript SDK for the Managed Agent API",
   "license": "MIT",
   "repository": {