agent0-js 0.0.10 → 0.0.12

package/README.md

@@ -88,6 +88,13 @@ interface RunOptions {
   variables?: Record<string, string>; // Variables to pass to the agent
   overrides?: ModelOverrides;         // Runtime model configuration overrides
   extraMessages?: Message[];          // Extra messages to append to the prompt
+  extraTools?: CustomTool[];          // Additional custom tools to add at runtime
+}
+
+interface CustomTool {
+  title: string;                       // Unique title for the tool (lowercase with underscores)
+  description: string;                // Description of what the tool does
+  inputSchema?: Record<string, unknown>; // JSON Schema for the tool's parameters
 }
 
 interface ModelOverrides {
@@ -592,6 +599,95 @@ const response = await client.generate({
 });
 ```
 
+### Custom Tools (extraTools)
+
+The `extraTools` option allows you to add custom tool definitions at runtime. These tools are merged with any tools defined in the agent configuration. Custom tools enable function calling without requiring an MCP server - the LLM will generate tool calls, but **execution must be handled externally** by your application.
+
+This is useful for:
+- **Dynamic Tool Injection**: Add context-specific tools at runtime
+- **Function Calling Patterns**: Define tools that your application will execute
+- **Hybrid Agents**: Combine MCP server tools with custom tools
+
+```typescript
+// Define custom tools for function calling
+const response = await client.generate({
+  agentId: 'agent_123',
+  extraTools: [
+    {
+      title: 'get_weather',
+      description: 'Get the current weather for a location',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          location: {
+            type: 'string',
+            description: 'City name or zip code'
+          },
+          units: {
+            type: 'string',
+            enum: ['celsius', 'fahrenheit'],
+            description: 'Temperature units'
+          }
+        },
+        required: ['location']
+      }
+    },
+    {
+      title: 'search_database',
+      description: 'Search the company database for information',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          query: { type: 'string', description: 'Search query' },
+          limit: { type: 'number', description: 'Max results to return' }
+        },
+        required: ['query']
+      }
+    }
+  ]
+});
+
+// The response may contain tool calls that your app needs to handle
+for (const message of response.messages) {
+  if (message.role === 'assistant') {
+    for (const part of message.content) {
+      if (part.type === 'tool-call') {
+        console.log('Tool called:', part.toolName);
+        console.log('Arguments:', part.args);
+        // Execute the tool and provide results back to the agent
+      }
+    }
+  }
+}
+```
+
+**Streaming with Custom Tools:**
+
+```typescript
+const stream = client.stream({
+  agentId: 'agent_123',
+  extraTools: [
+    {
+      title: 'lookup_user',
+      description: 'Look up user information by ID',
+      inputSchema: {
+        type: 'object',
+        properties: {
+          userId: { type: 'string' }
+        },
+        required: ['userId']
+      }
+    }
+  ]
+});
+
+for await (const chunk of stream) {
+  if (chunk.type === 'tool-call') {
+    console.log(`Tool ${chunk.toolName} called with:`, chunk.args);
+  }
+}
+```
+
 ### Error Handling
 
 ```typescript

package/dist/index.d.ts

@@ -24,4 +24,4 @@ export declare class Agent0 {
      */
     embedMany(options: EmbedManyOptions): Promise<EmbedManyResponse>;
 }
-export type { Agent0Config, EmbedManyOptions, EmbedManyResponse, EmbedModel, EmbedOptions, EmbedResponse, GenerateResponse, ModelOverrides, ProviderOptions, RunOptions, } from "./types";
+export type { Agent0Config, CustomTool, EmbedManyOptions, EmbedManyResponse, EmbedModel, EmbedOptions, EmbedResponse, GenerateResponse, ModelOverrides, ProviderOptions, RunOptions, } from "./types";

package/dist/index.js

@@ -30,6 +30,7 @@ class Agent0 {
             variables: options.variables,
             overrides: options.overrides,
             extra_messages: options.extraMessages,
+            extra_tools: options.extraTools,
             stream: false,
         });
         return await response.json();
@@ -40,6 +41,7 @@ class Agent0 {
             variables: options.variables,
             overrides: options.overrides,
             extra_messages: options.extraMessages,
+            extra_tools: options.extraTools,
             stream: true,
         });
         if (!response.body) {

package/dist/types.d.ts

@@ -37,6 +37,19 @@ export interface ModelOverrides {
     /** Provider-specific options for reasoning/thinking configuration */
     providerOptions?: ProviderOptions;
 }
+/**
+ * A custom tool defined at runtime.
+ * Custom tools have title, description, and inputSchema but no execute function.
+ * The LLM will generate tool calls for these, but execution must be handled externally.
+ */
+export interface CustomTool {
+    /** Unique title for the tool (lowercase with underscores recommended) */
+    title: string;
+    /** Description of what the tool does - helps the AI understand when to use it */
+    description: string;
+    /** JSON Schema defining the parameters this tool accepts */
+    inputSchema?: Record<string, unknown>;
+}
 export interface RunOptions {
     agentId: string;
     variables?: Record<string, string>;
@@ -44,6 +57,8 @@ export interface RunOptions {
     overrides?: ModelOverrides;
     /** Extra messages to append to the agent's prompt (used as-is, no variable substitution) */
     extraMessages?: ModelMessage[];
+    /** Additional custom tools to add at runtime. These are merged with any tools defined in the agent. */
+    extraTools?: CustomTool[];
 }
 export interface GenerateResponse {
     messages: ModelMessage[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent0-js",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "description": "TypeScript SDK for Agent0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,10 +17,10 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "@ai-sdk/google": "3.0.0-beta.81",
-    "@ai-sdk/openai": "3.0.0-beta.104",
-    "@ai-sdk/xai": "3.0.0-beta.62",
-    "ai": "6.0.0-beta.159"
+    "@ai-sdk/google": "3.0.0",
+    "@ai-sdk/openai": "3.0.0",
+    "@ai-sdk/xai": "3.0.0",
+    "ai": "6.0.1"
   },
   "scripts": {
     "build": "tsc",

package/src/index.ts

@@ -49,6 +49,7 @@ export class Agent0 {
 			variables: options.variables,
 			overrides: options.overrides,
 			extra_messages: options.extraMessages,
+			extra_tools: options.extraTools,
 			stream: false,
 		});
 
@@ -63,6 +64,7 @@ export class Agent0 {
 			variables: options.variables,
 			overrides: options.overrides,
 			extra_messages: options.extraMessages,
+			extra_tools: options.extraTools,
 			stream: true,
 		});
 
@@ -134,6 +136,7 @@ export class Agent0 {
 // Re-export types for convenience
 export type {
 	Agent0Config,
+	CustomTool,
 	EmbedManyOptions,
 	EmbedManyResponse,
 	EmbedModel,

package/src/types.ts

@@ -41,6 +41,20 @@ export interface ModelOverrides {
 	providerOptions?: ProviderOptions;
 }
 
+/**
+ * A custom tool defined at runtime.
+ * Custom tools have title, description, and inputSchema but no execute function.
+ * The LLM will generate tool calls for these, but execution must be handled externally.
+ */
+export interface CustomTool {
+	/** Unique title for the tool (lowercase with underscores recommended) */
+	title: string;
+	/** Description of what the tool does - helps the AI understand when to use it */
+	description: string;
+	/** JSON Schema defining the parameters this tool accepts */
+	inputSchema?: Record<string, unknown>;
+}
+
 export interface RunOptions {
 	agentId: string;
 	variables?: Record<string, string>;
@@ -48,6 +62,8 @@ export interface RunOptions {
 	overrides?: ModelOverrides;
 	/** Extra messages to append to the agent's prompt (used as-is, no variable substitution) */
 	extraMessages?: ModelMessage[];
+	/** Additional custom tools to add at runtime. These are merged with any tools defined in the agent. */
+	extraTools?: CustomTool[];
 }
 
 export interface GenerateResponse {