@inferencesh/sdk 0.5.19 → 0.6.1

package/dist/api/agents.d.ts

@@ -13,6 +13,8 @@ export interface InternalToolDefinition {
 export interface AgentOptions {
     /** Optional name for the adhoc agent (used for deduplication and display) */
     name?: string;
+    /** Per-chat context variables — resolved in call tool URL templates ({{context.X}}) */
+    context?: Record<string, string>;
 }
 export interface SendMessageOptions {
     /** File attachments - Blob (will be uploaded) or FileDTO (already uploaded, has uri) */
@@ -46,6 +48,7 @@ export declare class Agent {
     private readonly files;
     private readonly config;
     private readonly agentName;
+    private readonly context;
     private chatId;
     private stream;
     private poller;

package/dist/api/agents.js

@@ -17,6 +17,7 @@ export class Agent {
         this.files = files;
         this.config = config;
         this.agentName = options?.name;
+        this.context = options?.context;
     }
     /** Get current chat ID */
     get currentChatId() {
@@ -53,12 +54,14 @@ export class Agent {
             ? {
                 chat_id: this.chatId,
                 agent: this.config,
+                context: this.context,
                 input: { text, images: imageUris, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
             }
             : {
                 chat_id: this.chatId,
                 agent_config: this.config,
                 agent_name: this.agentName ?? this.config.name,
+                context: this.context,
                 input: { text, images: imageUris, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
             };
         const useStream = options.stream ?? this.http.getStreamDefault();

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export { ChatsAPI } from './api/chats';
 export { FlowsAPI } from './api/flows';
 export { FlowRunsAPI } from './api/flow-runs';
 export { EnginesAPI } from './api/engines';
-export { tool, appTool, agentTool, webhookTool, httpTool, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder';
+export { tool, appTool, agentTool, webhookTool, httpTool, callTool, mcpTool, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder';
 export type { ClientTool, ClientToolHandler } from './tool-builder';
 export { parseStatus, isTerminalStatus } from './utils';
 export * from './types';

package/dist/index.js

@@ -17,7 +17,7 @@ export { FlowsAPI } from './api/flows';
 export { FlowRunsAPI } from './api/flow-runs';
 export { EnginesAPI } from './api/engines';
 // Tool Builder (fluent API)
-export { tool, appTool, agentTool, webhookTool, httpTool, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder';
+export { tool, appTool, agentTool, webhookTool, httpTool, callTool, mcpTool, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder';
 // Status utilities (handle both int and string status values)
 export { parseStatus, isTerminalStatus } from './utils';
 // Types - includes TaskStatus constants and all DTOs

package/dist/tool-builder.d.ts

@@ -106,6 +106,16 @@ export declare const agentTool: (name: string, agentRef: string) => AgentToolBui
 export declare const webhookTool: (name: string, url: string) => WebhookToolBuilder;
 /** Create an HTTP tool with credential injection (replaces webhookTool for new code) */
 export declare const httpTool: (name: string, url: string) => HTTPToolBuilder;
+/** Create a call tool — makes authenticated HTTP requests. Preferred name for httpTool. */
+export declare const callTool: (name: string, url: string) => HTTPToolBuilder;
+/** Create an MCP connector tool (calls a tool on a connected MCP server) */
+export declare const mcpTool: (name: string, integrationId: string, toolName: string) => MCPToolBuilder;
+declare class MCPToolBuilder extends ToolBuilder {
+    private integrationId;
+    private toolName;
+    constructor(name: string, integrationId: string, toolName: string);
+    build(): AgentTool;
+}
 declare class InternalToolsBuilder {
     private config;
     /** Enable plan tools (Create, Update, Load) */

package/dist/tool-builder.js

@@ -1,7 +1,7 @@
 /**
  * Tool Builder - Fluent API for defining agent tools
  */
-import { ToolTypeClient, ToolTypeApp, ToolTypeAgent, ToolTypeHook, ToolTypeHTTP } from './types';
+import { ToolTypeClient, ToolTypeApp, ToolTypeAgent, ToolTypeHook, ToolTypeHTTP, ToolTypeMCP } from './types';
 // =============================================================================
 // Schema Builders
 // =============================================================================
@@ -229,6 +229,27 @@ export const agentTool = (name, agentRef) => new AgentToolBuilder(name, agentRef
 export const webhookTool = (name, url) => new WebhookToolBuilder(name, url);
 /** Create an HTTP tool with credential injection (replaces webhookTool for new code) */
 export const httpTool = (name, url) => new HTTPToolBuilder(name, url);
+/** Create a call tool — makes authenticated HTTP requests. Preferred name for httpTool. */
+export const callTool = (name, url) => new HTTPToolBuilder(name, url);
+/** Create an MCP connector tool (calls a tool on a connected MCP server) */
+export const mcpTool = (name, integrationId, toolName) => new MCPToolBuilder(name, integrationId, toolName);
+class MCPToolBuilder extends ToolBuilder {
+    constructor(name, integrationId, toolName) {
+        super(name);
+        this.integrationId = integrationId;
+        this.toolName = toolName;
+    }
+    build() {
+        return {
+            name: this.name,
+            display_name: this.displayNameValue || this.name,
+            description: this.desc,
+            type: ToolTypeMCP,
+            require_approval: this.approval || undefined,
+            mcp: { integration_id: this.integrationId, tool_name: this.toolName },
+        };
+    }
+}
 // =============================================================================
 // Internal Tools Builder
 // =============================================================================

package/dist/types.d.ts

@@ -17,6 +17,7 @@ export declare const ToolTypeApp: ToolType;
 export declare const ToolTypeAgent: ToolType;
 export declare const ToolTypeHook: ToolType;
 export declare const ToolTypeHTTP: ToolType;
+export declare const ToolTypeCall: ToolType;
 export declare const ToolTypeMCP: ToolType;
 export declare const ToolTypeClient: ToolType;
 export declare const ToolTypeInternal: ToolType;
@@ -113,6 +114,11 @@ export interface ToolAuthConfig {
      */
     header?: string;
 }
+/**
+ * CallToolConfig is the preferred name for HTTPToolConfig.
+ * "call" is the user-facing type; "http" is kept for backward compatibility.
+ */
+export type CallToolConfig = HTTPToolConfig;
 /**
  * HTTPToolConfig contains configuration for an authenticated HTTP tool
  */
@@ -158,6 +164,7 @@ export interface AgentTool {
     agent?: AgentToolConfig;
     hook?: HookToolConfig;
     http?: HTTPToolConfig;
+    call?: CallToolConfig;
     mcp?: MCPToolConfig;
     client?: ClientToolConfig;
     internal?: InternalToolConfig;
@@ -185,6 +192,7 @@ export interface AgentToolDTO {
     agent?: AgentToolConfigDTO;
     hook?: HookToolConfigDTO;
     http?: HTTPToolConfigDTO;
+    call?: HTTPToolConfigDTO;
     mcp?: MCPToolConfigDTO;
     client?: ClientToolConfigDTO;
 }
@@ -302,6 +310,17 @@ export interface SkillConfig {
     version_id?: string;
     url?: string;
     content?: string;
+    preload?: boolean;
+}
+/**
+ * ContextField declares a context parameter expected by the agent.
+ * Context is caller-provided at chat creation, stored on Chat, and available in tool URL templates.
+ */
+export interface ContextField {
+    name: string;
+    description?: string;
+    required?: boolean;
+    default?: string;
 }
 /**
  * AgentConfig contains the shared configuration fields for agent execution.
@@ -329,6 +348,10 @@ export interface AgentConfig {
      * Skills available to this agent (loaded on-demand via skill_get tool)
      */
     skills?: SkillConfig[];
+    /**
+     * Context declares expected context parameters (resolved in tool URL templates via {{context.X}})
+     */
+    context?: ContextField[];
     /**
      * Internal tools configuration (plan, memory, widget, finish, skills)
      */
@@ -372,6 +395,10 @@ export interface AgentVersionDTO extends BaseModel, PermissionModelDTO {
      * Skills available to this agent (loaded on-demand via skill_get tool)
      */
     skills: SkillConfig[];
+    /**
+     * Context declarations
+     */
+    context?: ContextField[];
     /**
      * Internal tools configuration (plan, memory, widget, finish, skills)
      */
@@ -483,6 +510,12 @@ export interface ApiAgentRunRequest {
      * The message to send
      */
     input: ChatTaskInput;
+    /**
+     * Context values for this chat session (used in tool URL templates)
+     */
+    context?: {
+        [key: string]: string;
+    };
     /**
      * If true, returns SSE stream instead of JSON response
      */
@@ -515,6 +548,12 @@ export interface CreateAgentMessageRequest {
      * Optional name for the adhoc agent (used for deduplication and display)
      */
     agent_name?: string;
+    /**
+     * Context values for this chat session (used in tool URL templates)
+     */
+    context?: {
+        [key: string]: string;
+    };
 }
 export interface CreateAgentMessageResponse {
     user_message?: ChatMessageDTO;
@@ -966,7 +1005,7 @@ export interface App extends BaseModel, PermissionModel {
 }
 /**
  * AppPricing configures all pricing using CEL expressions
- * Empty expressions use defaults. All values in nanocents (1 cent = 1,000,000,000)
+ * Empty expressions use defaults. All values in microcents (1 cent = 1,000,000; 1 dollar = 100,000,000)
  */
 export interface AppPricing {
     prices: {
@@ -980,7 +1019,7 @@ export interface AppPricing {
      */
     resource_expression: string;
     /**
-     * CEL expressions for each fee type (result in nanocents)
+     * CEL expressions for each fee type (result in microcents)
      * Available variables: inputs, outputs, prices, resource_fee, usage_seconds
      */
     inference_expression: string;
@@ -1337,6 +1376,9 @@ export interface ChatDTO extends BaseModel, PermissionModelDTO {
     children: (ChatDTO | undefined)[];
     status: ChatStatus;
     output?: any;
+    context?: {
+        [key: string]: string;
+    };
     /**
      * Agent version reference
      */
@@ -1854,6 +1896,7 @@ export interface IntegrationDTO extends BaseModel, PermissionModelDTO {
     auth: string;
     status: string;
     display_name: string;
+    icon_url?: string;
     scopes: StringSlice;
     expires_at?: string;
     service_account_email?: string;

package/dist/types.js

@@ -3,6 +3,7 @@ export const ToolTypeApp = "app"; // App tools - creates a Task
 export const ToolTypeAgent = "agent"; // Sub-agent tools - creates a sub-Chat
 export const ToolTypeHook = "hook"; // Webhook tools - HTTP POST to external URL (legacy)
 export const ToolTypeHTTP = "http"; // HTTP tools - authenticated HTTP request/response
+export const ToolTypeCall = "call"; // Call tools - authenticated HTTP request/response (preferred over "http")
 export const ToolTypeMCP = "mcp"; // MCP tools - calls remote MCP server
 export const ToolTypeClient = "client"; // Client tools - executed by frontend
 export const ToolTypeInternal = "internal"; // Internal/built-in tools (plan, memory, widget, finish)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.5.19",
+  "version": "0.6.1",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "type": "module",
   "main": "dist/index.js",