agent0-js 0.0.6 → 0.0.7

package/README.md

@@ -98,6 +98,24 @@ interface ModelOverrides {
   maxOutputTokens?: number;    // Override max output tokens
   temperature?: number;        // Override temperature
   maxStepCount?: number;       // Override max step count
+  providerOptions?: ProviderOptions; // Provider-specific reasoning options
+}
+
+interface ProviderOptions {
+  openai?: {
+    reasoningEffort?: 'minimal' | 'low' | 'medium' | 'high';
+    reasoningSummary?: 'auto' | 'detailed';
+  };
+  xai?: {
+    reasoningEffort?: 'low' | 'medium' | 'high';
+  };
+  google?: {
+    thinkingConfig?: {
+      thinkingBudget?: number;
+      thinkingLevel?: 'low' | 'medium' | 'high';
+      includeThoughts?: boolean;
+    };
+  };
 }
 ```
 
@@ -278,6 +296,79 @@ async function runWithFallback(agentId: string, variables: Record<string, string
 }
 ```
 
+### Provider Options
+
+The `providerOptions` option allows you to configure provider-specific reasoning and thinking behavior. Different providers have different options:
+
+**OpenAI / Azure** - Use `reasoningEffort` to control how much reasoning the model does, and `reasoningSummary` to control whether the model returns its reasoning process:
+
+```typescript
+const response = await client.generate({
+  agentId: 'agent_123',
+  overrides: {
+    providerOptions: {
+      openai: {
+        reasoningEffort: 'high', // 'minimal' | 'low' | 'medium' | 'high'
+        reasoningSummary: 'auto' // 'auto' | 'detailed' - controls reasoning output
+      }
+    }
+  }
+});
+```
+
+- `reasoningSummary: 'auto'` - Returns a condensed summary of the reasoning process
+- `reasoningSummary: 'detailed'` - Returns more comprehensive reasoning
+- When enabled, reasoning summaries appear in the stream as events with type `'reasoning'` and in non-streaming responses within the `reasoning` field
+
+**xAI (Grok)** - Use `reasoningEffort` to control reasoning:
+
+```typescript
+const response = await client.generate({
+  agentId: 'agent_123',
+  overrides: {
+    providerOptions: {
+      xai: {
+        reasoningEffort: 'high' // 'low' | 'medium' | 'high'
+      }
+    }
+  }
+});
+```
+
+**Google Generative AI / Google Vertex** - Use `thinkingConfig` to control thinking (use either `thinkingLevel` or `thinkingBudget`, not both):
+
+```typescript
+// Using thinkingLevel (recommended for most cases)
+const response = await client.generate({
+  agentId: 'agent_123',
+  overrides: {
+    providerOptions: {
+      google: {
+        thinkingConfig: {
+          thinkingLevel: 'high',     // 'low' | 'medium' | 'high'
+          includeThoughts: true      // Include thinking in response
+        }
+      }
+    }
+  }
+});
+
+// OR using thinkingBudget (for fine-grained control)
+const response = await client.generate({
+  agentId: 'agent_123',
+  overrides: {
+    providerOptions: {
+      google: {
+        thinkingConfig: {
+          thinkingBudget: 8192,      // Number of thinking tokens
+          includeThoughts: true
+        }
+      }
+    }
+  }
+});
+```
+
 ### Extra Messages
 
 The `extraMessages` option allows you to programmatically append additional messages to the agent's prompt. These messages are used as-is without any variable substitution, making them ideal for:

package/dist/types.d.ts

@@ -1,8 +1,23 @@
+import type { GoogleGenerativeAIProviderOptions } from "@ai-sdk/google";
+import type { OpenAIResponsesProviderOptions } from "@ai-sdk/openai";
+import type { XaiProviderOptions } from "@ai-sdk/xai";
 import type { ModelMessage } from "ai";
 export interface Agent0Config {
     apiKey: string;
     baseUrl?: string;
 }
+/**
+ * Provider-specific options for reasoning/thinking configuration.
+ * Each provider has its own format for controlling reasoning behavior.
+ */
+export interface ProviderOptions {
+    /** OpenAI reasoning effort options */
+    openai?: OpenAIResponsesProviderOptions;
+    /** xAI reasoning effort options */
+    xai?: XaiProviderOptions;
+    /** Google/Vertex thinking configuration */
+    google?: GoogleGenerativeAIProviderOptions;
+}
 /**
  * Model configuration overrides for runtime customization.
  * Allows downstream applications to implement load balancing, fallbacks, and dynamic model switching.
@@ -19,6 +34,8 @@ export interface ModelOverrides {
     temperature?: number;
     /** Override max step count */
     maxStepCount?: number;
+    /** Provider-specific options for reasoning/thinking configuration */
+    providerOptions?: ProviderOptions;
 }
 export interface RunOptions {
     agentId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent0-js",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "TypeScript SDK for Agent0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,6 +17,9 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
+    "@ai-sdk/google": "3.0.0-beta.69",
+    "@ai-sdk/openai": "3.0.0-beta.90",
+    "@ai-sdk/xai": "3.0.0-beta.54",
     "ai": "^5.0.98"
   },
   "scripts": {

package/src/types.ts

@@ -1,8 +1,24 @@
+import type { GoogleGenerativeAIProviderOptions } from "@ai-sdk/google";
+import type { OpenAIResponsesProviderOptions } from "@ai-sdk/openai";
+import type { XaiProviderOptions } from "@ai-sdk/xai";
 import type { ModelMessage } from "ai";
 
 export interface Agent0Config {
-    apiKey: string;
-    baseUrl?: string;
+	apiKey: string;
+	baseUrl?: string;
+}
+
+/**
+ * Provider-specific options for reasoning/thinking configuration.
+ * Each provider has its own format for controlling reasoning behavior.
+ */
+export interface ProviderOptions {
+	/** OpenAI reasoning effort options */
+	openai?: OpenAIResponsesProviderOptions;
+	/** xAI reasoning effort options */
+	xai?: XaiProviderOptions;
+	/** Google/Vertex thinking configuration */
+	google?: GoogleGenerativeAIProviderOptions;
 }
 
 /**
@@ -10,29 +26,31 @@ export interface Agent0Config {
  * Allows downstream applications to implement load balancing, fallbacks, and dynamic model switching.
  */
 export interface ModelOverrides {
-    /** Override the model provider and name */
-    model?: {
-        provider_id?: string;
-        name?: string;
-    };
-    /** Override max output tokens */
-    maxOutputTokens?: number;
-    /** Override temperature */
-    temperature?: number;
-    /** Override max step count */
-    maxStepCount?: number;
+	/** Override the model provider and name */
+	model?: {
+		provider_id?: string;
+		name?: string;
+	};
+	/** Override max output tokens */
+	maxOutputTokens?: number;
+	/** Override temperature */
+	temperature?: number;
+	/** Override max step count */
+	maxStepCount?: number;
+	/** Provider-specific options for reasoning/thinking configuration */
+	providerOptions?: ProviderOptions;
 }
 
 export interface RunOptions {
-    agentId: string;
-    variables?: Record<string, string>;
-    /** Runtime model overrides for load balancing, fallbacks, etc. */
-    overrides?: ModelOverrides;
-    /** Extra messages to append to the agent's prompt (used as-is, no variable substitution) */
-    extraMessages?: ModelMessage[];
+	agentId: string;
+	variables?: Record<string, string>;
+	/** Runtime model overrides for load balancing, fallbacks, etc. */
+	overrides?: ModelOverrides;
+	/** Extra messages to append to the agent's prompt (used as-is, no variable substitution) */
+	extraMessages?: ModelMessage[];
 }
 
 export interface GenerateResponse {
-    messages: ModelMessage[];
-    text: string;
+	messages: ModelMessage[];
+	text: string;
 }