@inferencesh/sdk 0.5.16 → 0.5.18

package/README.md

@@ -7,7 +7,7 @@
 
 official javascript/typescript sdk for [inference.sh](https://inference.sh) — the ai agent runtime for serverless ai inference.
 
-run ai models, build ai agents, and deploy generative ai applications with a simple api. access 150+ models including flux, stable diffusion, llms (claude, gpt, gemini), video generation (veo, seedance), and more.
+run ai models, build ai agents, and deploy generative ai applications with a simple api. access 250+ models including flux, stable diffusion, llms (claude, gpt, gemini), video generation (veo, seedance), and more.
 
 ## Installation
 
@@ -408,7 +408,7 @@ import type { Task, ApiTaskRequest, RunOptions } from '@inferencesh/sdk';
 
 - [documentation](https://inference.sh/docs) — getting started guides and api reference
 - [blog](https://inference.sh/blog) — tutorials on ai agents, image generation, and more
-- [app store](https://app.inference.sh) — browse 150+ ai models
+- [app store](https://app.inference.sh) — browse 250+ ai models
 - [discord](https://discord.gg/RM77SWSbyT) — community support
 - [github](https://github.com/inference-sh) — open source projects
 

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, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder';
+export { tool, appTool, agentTool, webhookTool, httpTool, 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, internalTools, string, number, integer, boolean, enumOf, object, array, optional, } from './tool-builder';
+export { tool, appTool, agentTool, webhookTool, httpTool, 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

@@ -79,6 +79,23 @@ declare class WebhookToolBuilder extends ToolBuilder {
     secret(key: string): this;
     build(): AgentTool;
 }
+declare class HTTPToolBuilder extends ToolBuilder {
+    private url;
+    private httpMethod;
+    private authConfig?;
+    private headerMap;
+    constructor(name: string, url: string);
+    method(m: string): this;
+    auth(config: {
+        integration?: string;
+        integrationId?: string;
+        apiKey?: string;
+        bearer?: string;
+        header?: string;
+    }): this;
+    header(name: string, value: string): this;
+    build(): AgentTool;
+}
 /** Create a client tool (executed by SDK consumer) */
 export declare const tool: (name: string) => ClientToolBuilder;
 /** Create an app tool (runs another inference app) */
@@ -87,6 +104,8 @@ export declare const appTool: (name: string, appRef: string) => AppToolBuilder;
 export declare const agentTool: (name: string, agentRef: string) => AgentToolBuilder;
 /** Create a webhook tool (calls external URL) */
 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;
 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 } from './types';
+import { ToolTypeClient, ToolTypeApp, ToolTypeAgent, ToolTypeHook, ToolTypeHTTP } from './types';
 // =============================================================================
 // Schema Builders
 // =============================================================================
@@ -172,6 +172,50 @@ class WebhookToolBuilder extends ToolBuilder {
         };
     }
 }
+class HTTPToolBuilder extends ToolBuilder {
+    constructor(name, url) {
+        super(name);
+        this.httpMethod = 'POST';
+        this.headerMap = {};
+        this.url = url;
+    }
+    method(m) {
+        this.httpMethod = m;
+        return this;
+    }
+    auth(config) {
+        if (config.integration) {
+            this.authConfig = { type: 'integration', provider: config.integration, integration_id: config.integrationId };
+        }
+        else if (config.apiKey) {
+            this.authConfig = { type: 'api_key', secret: config.apiKey, header: config.header || 'X-API-Key' };
+        }
+        else if (config.bearer) {
+            this.authConfig = { type: 'bearer', secret: config.bearer };
+        }
+        return this;
+    }
+    header(name, value) {
+        this.headerMap[name] = value;
+        return this;
+    }
+    build() {
+        return {
+            name: this.name,
+            display_name: this.displayNameValue || this.name,
+            description: this.desc,
+            type: ToolTypeHTTP,
+            require_approval: this.approval || undefined,
+            http: {
+                url: this.url,
+                method: this.httpMethod !== 'POST' ? this.httpMethod : undefined,
+                auth: this.authConfig,
+                headers: Object.keys(this.headerMap).length ? this.headerMap : undefined,
+                input_schema: toJsonSchema(this.params),
+            },
+        };
+    }
+}
 // =============================================================================
 // Public API
 // =============================================================================
@@ -183,6 +227,8 @@ export const appTool = (name, appRef) => new AppToolBuilder(name, appRef);
 export const agentTool = (name, agentRef) => new AgentToolBuilder(name, agentRef);
 /** Create a webhook tool (calls external URL) */
 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);
 // =============================================================================
 // Internal Tools Builder
 // =============================================================================

package/dist/types.d.ts

@@ -16,6 +16,8 @@ export type ToolType = string;
 export declare const ToolTypeApp: ToolType;
 export declare const ToolTypeAgent: ToolType;
 export declare const ToolTypeHook: ToolType;
+export declare const ToolTypeHTTP: ToolType;
+export declare const ToolTypeMCP: ToolType;
 export declare const ToolTypeClient: ToolType;
 export declare const ToolTypeInternal: ToolType;
 /**
@@ -86,6 +88,57 @@ export interface ClientToolConfig {
     input_schema?: any;
     output_schema?: any;
 }
+/**
+ * ToolAuthConfig declares how a tool authenticates. Resolved at runtime — never contains actual credentials.
+ */
+export interface ToolAuthConfig {
+    /**
+     * Type: "integration", "api_key", "bearer", "none"
+     */
+    type: string;
+    /**
+     * For type=integration: which provider to look up (e.g. "google", "mcp", "slack")
+     */
+    provider?: string;
+    /**
+     * For type=integration: specific integration ID (optional — if empty, uses team's primary for provider)
+     */
+    integration_id?: string;
+    /**
+     * For type=api_key or bearer: name of the secret in the team's secret store
+     */
+    secret?: string;
+    /**
+     * For type=api_key: which header to inject (default: "X-API-Key")
+     */
+    header?: string;
+}
+/**
+ * HTTPToolConfig contains configuration for an authenticated HTTP tool
+ */
+export interface HTTPToolConfig {
+    url: string;
+    method?: string;
+    auth?: ToolAuthConfig;
+    headers?: {
+        [key: string]: string;
+    };
+    input_schema?: any;
+    output_schema?: any;
+}
+/**
+ * MCPToolConfig contains configuration for a remote MCP server tool
+ */
+export interface MCPToolConfig {
+    /**
+     * IntegrationID references the MCP integration (has server_url, tokens, cached tools)
+     */
+    integration_id: string;
+    /**
+     * ToolName is the tool name on the remote MCP server
+     */
+    tool_name: string;
+}
 /**
  * AgentTool represents a unified tool that can be used by an agent
  */
@@ -104,6 +157,8 @@ export interface AgentTool {
     app?: AppToolConfig;
     agent?: AgentToolConfig;
     hook?: HookToolConfig;
+    http?: HTTPToolConfig;
+    mcp?: MCPToolConfig;
     client?: ClientToolConfig;
     internal?: InternalToolConfig;
 }
@@ -129,6 +184,8 @@ export interface AgentToolDTO {
     app?: AppToolConfigDTO;
     agent?: AgentToolConfigDTO;
     hook?: HookToolConfigDTO;
+    http?: HTTPToolConfigDTO;
+    mcp?: MCPToolConfigDTO;
     client?: ClientToolConfigDTO;
 }
 export interface AppToolConfigDTO {
@@ -166,6 +223,20 @@ export interface ClientToolConfigDTO {
     input_schema?: any;
     output_schema?: any;
 }
+export interface HTTPToolConfigDTO {
+    url: string;
+    method?: string;
+    auth?: ToolAuthConfig;
+    headers?: {
+        [key: string]: string;
+    };
+    input_schema?: any;
+    output_schema?: any;
+}
+export interface MCPToolConfigDTO {
+    integration_id: string;
+    tool_name: string;
+}
 /**
  * CoreAppConfig references an app used as the agent's core
  */
@@ -375,6 +446,10 @@ export interface ApiAppRunRequest {
      * Task stays queued until this time. Past timestamps run immediately.
      */
     run_at?: string;
+    /**
+     * Optional metadata (e.g., action to trigger on completion)
+     */
+    metadata?: TaskMetadata;
 }
 /**
  * ApiAgentRunRequest is the request body for /agents/run endpoint.
@@ -592,6 +667,16 @@ export interface CheckoutCompleteRequest {
  */
 export type StripeCheckoutCreateRequest = CheckoutCreateRequest;
 export type StripeCheckoutCompleteRequest = CheckoutCompleteRequest;
+/**
+ * AuthResponse is returned after successful authentication (OAuth, magic link, SSO)
+ */
+export interface AuthResponse {
+    user?: UserDTO;
+    session_id: string;
+    otp_required?: boolean;
+    redirect_to?: string;
+    provider?: string;
+}
 /**
  * DeviceAuthResponse is returned when a device initiates auth
  */
@@ -740,8 +825,13 @@ export interface MoveAgentToProjectRequest {
     agent_id: string;
     project_id: string;
 }
+/**
+ * WorkerGPUConfig holds GPU identifiers for a worker.
+ * GPUs accepts both integer indexes (legacy) and string GPU IDs.
+ * Use GPUIndexes() and GPUIDs() to separate them after unmarshaling.
+ */
 export interface WorkerGPUConfig {
-    gpus: number[];
+    gpus: any[];
 }
 export interface WorkerCPUConfig {
     count: number;
@@ -1465,6 +1555,10 @@ export interface FlowVersion extends BaseModel {
      * ConfigHash for deduplication - SHA256 of config content
      */
     config_hash: string;
+    /**
+     * GraphVersion is an incrementing counter for optimistic locking on action-based edits
+     */
+    graph_version: number;
     /**
      * Flow graph configuration
      */
@@ -1557,6 +1651,7 @@ export interface FlowDTO extends BaseModel, PermissionModelDTO {
     viewport?: FlowViewport;
 }
 export interface FlowVersionDTO extends BaseModel {
+    graph_version: number;
     input_schema: any;
     input: FlowRunInputs;
     output_schema: any;
@@ -1693,6 +1788,7 @@ export type StringSlice = string[];
 export interface IntegrationDTO extends BaseModel, PermissionModelDTO {
     provider: string;
     type: string;
+    auth: string;
     status: string;
     display_name: string;
     scopes: StringSlice;
@@ -1706,6 +1802,17 @@ export interface IntegrationDTO extends BaseModel, PermissionModelDTO {
     is_primary: boolean;
     error_message?: string;
 }
+/**
+ * KnowledgeFile represents a file in a knowledge entry (stored as JSONB in knowledge_versions)
+ */
+export interface KnowledgeFile {
+    path: string;
+    uri?: string;
+    size: number;
+    hash: string;
+    content?: string;
+}
+export type SkillFile = KnowledgeFile;
 /**
  * ProjectType represents different types of projects
  */
@@ -1906,16 +2013,6 @@ export interface InstanceEnvVar {
     name: string;
     value: string;
 }
-/**
- * SkillFile represents a file in the skill directory (stored as JSONB in skill_versions)
- */
-export interface SkillFile {
-    path: string;
-    uri?: string;
-    size: number;
-    hash: string;
-    content?: string;
-}
 /**
  * Hardware/System related types
  */
@@ -2057,6 +2154,21 @@ export type Infra = string;
 export declare const InfraPrivate: Infra;
 export declare const InfraCloud: Infra;
 export declare const InfraPrivateFirst: Infra;
+/**
+ * TaskAction defines an action to execute when a task reaches a specific status.
+ * Used by the action projector to trigger side effects (e.g., updating app covers).
+ */
+export interface TaskAction {
+    key: string;
+    on: string;
+    params?: any;
+}
+/**
+ * TaskMetadata holds optional metadata attached to a task.
+ */
+export interface TaskMetadata {
+    action?: TaskAction;
+}
 export interface Task extends BaseModel, PermissionModel {
     is_featured: boolean;
     status: TaskStatus;
@@ -2093,6 +2205,7 @@ export interface Task extends BaseModel, PermissionModel {
      */
     sub_flow_run_id?: string;
     webhook?: string;
+    metadata?: TaskMetadata;
     setup?: any;
     input: any;
     output: any;

package/dist/types.js

@@ -1,7 +1,9 @@
-// Code generated by tygo. DO NOT EDIT.
+// Code generated by gotypegen. DO NOT EDIT.
 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
+export const ToolTypeHook = "hook"; // Webhook tools - HTTP POST to external URL (legacy)
+export const ToolTypeHTTP = "http"; // HTTP tools - authenticated HTTP request/response
+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)
 export const ScopeGroupAgents = "agents";

package/package.json

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