@inferencesh/sdk 0.2.0 → 0.4.0

package/README.md

@@ -218,7 +218,7 @@ await agent.sendMessage('What is the weather in Paris?', {
 | `sendMessage(text, options?)` | Send a message to the agent |
 | `getChat(chatId?)` | Get chat history |
 | `stopChat(chatId?)` | Stop current generation |
-| `submitToolResult(toolId, result)` | Submit result for a client tool |
+| `submitToolResult(toolId, resultOrAction)` | Submit result for a client tool (string or {action, form_data}) |
 | `streamMessages(chatId?, options?)` | Stream message updates |
 | `streamChat(chatId?, options?)` | Stream chat updates |
 | `disconnect()` | Clean up streams |

package/dist/agent.d.ts

@@ -3,26 +3,19 @@
  *
  * Chat with AI agents without UI dependencies.
  */
-import { ChatDTO, ChatMessageDTO, AgentTool, InternalToolsConfig } from './types';
+import { ChatDTO, ChatMessageDTO, AgentRuntimeConfig } from './types';
 export interface AgentConfig {
     apiKey: string;
     baseUrl?: string;
 }
-/** Ad-hoc agent configuration (no saved template) */
-export interface AdHocAgentOptions {
-    /** Core LLM app: namespace/name@shortid */
-    coreApp: string;
-    /** LLM parameters */
-    coreAppInput?: Record<string, unknown>;
-    /** Agent name */
-    name?: string;
-    /** System prompt */
-    systemPrompt?: string;
-    /** Tools */
-    tools?: AgentTool[];
-    /** Internal tools config */
-    internalTools?: InternalToolsConfig;
-}
+/**
+ * Ad-hoc agent configuration - extends AgentRuntimeConfig with core_app_ref required
+ * Uses Partial to make name/system_prompt optional for ad-hoc usage
+ */
+export type AdHocAgentOptions = Partial<AgentRuntimeConfig> & {
+    /** Core LLM app ref: namespace/name@shortid (required for ad-hoc agents) */
+    core_app_ref: string;
+};
 /** Template agent configuration */
 export interface TemplateAgentOptions {
     /** Agent reference: namespace/name@version (e.g., "my-org/assistant@abc123") */
@@ -58,8 +51,18 @@ export declare class Agent {
     getChat(chatId?: string): Promise<ChatDTO | null>;
     /** Stop the current chat generation */
     stopChat(): Promise<void>;
-    /** Submit a tool result */
-    submitToolResult(toolInvocationId: string, result: string): Promise<void>;
+    /**
+     * Submit a tool result
+     * @param toolInvocationId - The tool invocation ID
+     * @param resultOrAction - Either a raw result string, or an object with action and optional form_data (will be JSON-serialized)
+     */
+    submitToolResult(toolInvocationId: string, resultOrAction: string | {
+        action: {
+            type: string;
+            payload?: Record<string, unknown>;
+        };
+        form_data?: Record<string, unknown>;
+    }): Promise<void>;
     /** Stop streaming and cleanup */
     disconnect(): void;
     /** Reset the agent (start fresh chat) */

package/dist/agent.js

@@ -27,7 +27,7 @@ class Agent {
     }
     /** Send a message to the agent */
     async sendMessage(text, options = {}) {
-        const isAdHoc = 'coreApp' in this.options;
+        const isAdHoc = 'core_app_ref' in this.options;
         // Upload files if provided
         let imageUri;
         let fileUris;
@@ -42,22 +42,10 @@ class Agent {
                 fileUris = others.map(f => f.uri);
         }
         // Both template and ad-hoc use /agents/run
+        const input = { text, image: imageUri, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 };
         const body = isAdHoc
-            ? {
-                chat_id: this.chatId,
-                core_app: this.options.coreApp,
-                core_app_input: this.options.coreAppInput,
-                name: this.options.name,
-                system_prompt: this.options.systemPrompt,
-                tools: this.options.tools,
-                internal_tools: this.options.internalTools,
-                input: { text, image: imageUri, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
-            }
-            : {
-                chat_id: this.chatId,
-                agent: this.options.agent,
-                input: { text, image: imageUri, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
-            };
+            ? { chat_id: this.chatId, agent_config: this.options, input }
+            : { chat_id: this.chatId, agent: this.options.agent, input };
         const response = await this.request('post', '/agents/run', { data: body });
         // Update chat ID if new
         if (!this.chatId && response.assistant_message.chat_id) {
@@ -79,13 +67,17 @@ class Agent {
             return;
         await this.request('post', `/chats/${this.chatId}/stop`);
     }
-    /** Submit a tool result */
-    async submitToolResult(toolInvocationId, result) {
-        if (!this.chatId)
-            throw new Error('No active chat');
-        await this.request('post', `/chats/${this.chatId}/tool-result`, {
-            data: { tool_invocation_id: toolInvocationId, result },
-        });
+    /**
+     * Submit a tool result
+     * @param toolInvocationId - The tool invocation ID
+     * @param resultOrAction - Either a raw result string, or an object with action and optional form_data (will be JSON-serialized)
+     */
+    async submitToolResult(toolInvocationId, resultOrAction) {
+        // Serialize widget actions to JSON string
+        const result = typeof resultOrAction === 'string'
+            ? resultOrAction
+            : JSON.stringify(resultOrAction);
+        await this.request('post', `/tools/${toolInvocationId}`, { data: { result } });
     }
     /** Stop streaming and cleanup */
     disconnect() {

package/dist/client.d.ts

@@ -1,20 +1,13 @@
-import { ApiAppRunRequest, TaskDTO as Task, File, ChatDTO, ChatMessageDTO, AgentTool, InternalToolsConfig } from './types';
+import { ApiAppRunRequest, TaskDTO as Task, File, ChatDTO, ChatMessageDTO, AgentRuntimeConfig } from './types';
 import { EventSource } from 'eventsource';
-/** Ad-hoc agent configuration (no saved template) */
-export interface AdHocAgentConfig {
-    /** Core LLM app: namespace/name@shortid */
-    coreApp: string;
-    /** LLM parameters */
-    coreAppInput?: Record<string, unknown>;
-    /** Agent name */
-    name?: string;
-    /** System prompt */
-    systemPrompt?: string;
-    /** Tools */
-    tools?: AgentTool[];
-    /** Internal tools config */
-    internalTools?: InternalToolsConfig;
-}
+/**
+ * Ad-hoc agent configuration - extends AgentRuntimeConfig with core_app_ref required
+ * Uses Partial to make name/system_prompt optional for ad-hoc usage
+ */
+export type AdHocAgentConfig = Partial<AgentRuntimeConfig> & {
+    /** Core LLM app ref: namespace/name@shortid (required for ad-hoc agents) */
+    core_app_ref: string;
+};
 export interface SendMessageOptions {
     /** File attachments (Blob or base64 data URI) */
     files?: (Blob | string)[];
@@ -84,10 +77,10 @@ export declare class Inference {
      * @param options - Run options for waiting, updates, and reconnection
      * @returns The completed task result
      *
-     * App reference format: `namespace/name@shortid` (version is required)
+     * App reference format: `namespace/name@shortid` or `namespace/name@shortid:function`
      *
-     * The short ID ensures your code always runs the same version,
-     * protecting against breaking changes from app updates.
+     * The short ID ensures your code always runs the same version.
+     * You can optionally specify a function name to run a specific entry point.
      *
      * @example
      * ```typescript
@@ -131,8 +124,8 @@ export declare class Inference {
      *
      * // Ad-hoc agent
      * const agent = client.agent({
-     *   coreApp: 'infsh/claude-sonnet-4@xyz789',
-     *   systemPrompt: 'You are a helpful assistant',
+     *   core_app_ref: 'infsh/claude-sonnet-4@xyz789',
+     *   system_prompt: 'You are a helpful assistant',
      *   tools: [...]
      * })
      *
@@ -152,6 +145,7 @@ export declare class Agent {
     private readonly config;
     private chatId;
     private stream;
+    private dispatchedToolCalls;
     /** @internal */
     constructor(client: Inference, config: string | AdHocAgentConfig);
     /** Get current chat ID */
@@ -162,13 +156,24 @@ export declare class Agent {
     getChat(chatId?: string): Promise<ChatDTO | null>;
     /** Stop the current chat generation */
     stopChat(): Promise<void>;
-    /** Submit a tool result */
-    submitToolResult(toolInvocationId: string, result: string): Promise<void>;
+    /**
+     * Submit a tool result
+     * @param toolInvocationId - The tool invocation ID
+     * @param resultOrAction - Either a raw result string, or an object with action and optional form_data (will be JSON-serialized)
+     */
+    submitToolResult(toolInvocationId: string, resultOrAction: string | {
+        action: {
+            type: string;
+            payload?: Record<string, unknown>;
+        };
+        form_data?: Record<string, unknown>;
+    }): Promise<void>;
     /** Stop streaming and cleanup */
     disconnect(): void;
     /** Reset the agent (start fresh chat) */
     reset(): void;
-    private startStreaming;
+    /** Stream events until chat becomes idle */
+    private streamUntilIdle;
 }
 /**
  * Factory function for creating an Inference client (lowercase for branding)

package/dist/client.js

@@ -82,7 +82,13 @@ class Inference {
         }
         const apiResponse = data;
         if (!apiResponse?.success) {
-            throw new errors_1.InferenceError(response.status, apiResponse?.error?.message || 'Request failed', responseText);
+            // Build a helpful error message
+            let errorMessage = apiResponse?.error?.message;
+            if (!errorMessage) {
+                // No error message provided - show the response for debugging
+                errorMessage = `Request failed (success=false). Response: ${responseText.slice(0, 500)}`;
+            }
+            throw new errors_1.InferenceError(response.status, errorMessage, responseText);
         }
         return apiResponse.data;
     }
@@ -150,10 +156,10 @@ class Inference {
      * @param options - Run options for waiting, updates, and reconnection
      * @returns The completed task result
      *
-     * App reference format: `namespace/name@shortid` (version is required)
+     * App reference format: `namespace/name@shortid` or `namespace/name@shortid:function`
      *
-     * The short ID ensures your code always runs the same version,
-     * protecting against breaking changes from app updates.
+     * The short ID ensures your code always runs the same version.
+     * You can optionally specify a function name to run a specific entry point.
      *
      * @example
      * ```typescript
@@ -310,8 +316,8 @@ class Inference {
      *
      * // Ad-hoc agent
      * const agent = client.agent({
-     *   coreApp: 'infsh/claude-sonnet-4@xyz789',
-     *   systemPrompt: 'You are a helpful assistant',
+     *   core_app_ref: 'infsh/claude-sonnet-4@xyz789',
+     *   system_prompt: 'You are a helpful assistant',
      *   tools: [...]
      * })
      *
@@ -337,6 +343,7 @@ class Agent {
     constructor(client, config) {
         this.chatId = null;
         this.stream = null;
+        this.dispatchedToolCalls = new Set();
         this.client = client;
         this.config = config;
     }
@@ -362,23 +369,23 @@ class Agent {
         const body = isTemplate
             ? {
                 chat_id: this.chatId,
-                agent: this.config,
+                agent_ref: this.config,
                 input: { text, image: imageUri, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
             }
             : {
                 chat_id: this.chatId,
-                core_app: this.config.coreApp,
-                core_app_input: this.config.coreAppInput,
-                name: this.config.name,
-                system_prompt: this.config.systemPrompt,
-                tools: this.config.tools,
-                internal_tools: this.config.internalTools,
+                agent_config: this.config,
                 input: { text, image: imageUri, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
             };
         const response = await this.client._request('post', '/agents/run', { data: body });
-        if (!this.chatId && response.assistant_message.chat_id) {
+        // Start streaming for new chats or continue existing stream
+        const isNewChat = !this.chatId && response.assistant_message.chat_id;
+        if (isNewChat) {
             this.chatId = response.assistant_message.chat_id;
-            this.startStreaming(options);
+        }
+        // Wait for streaming to complete if callbacks are provided
+        if (options.onMessage || options.onChat || options.onToolCall) {
+            await this.streamUntilIdle(options);
         }
         return response.assistant_message;
     }
@@ -395,13 +402,17 @@ class Agent {
             return;
         await this.client._request('post', `/chats/${this.chatId}/stop`);
     }
-    /** Submit a tool result */
-    async submitToolResult(toolInvocationId, result) {
-        if (!this.chatId)
-            throw new Error('No active chat');
-        await this.client._request('post', `/chats/${this.chatId}/tool-result`, {
-            data: { tool_invocation_id: toolInvocationId, result },
-        });
+    /**
+     * Submit a tool result
+     * @param toolInvocationId - The tool invocation ID
+     * @param resultOrAction - Either a raw result string, or an object with action and optional form_data (will be JSON-serialized)
+     */
+    async submitToolResult(toolInvocationId, resultOrAction) {
+        // Serialize widget actions to JSON string
+        const result = typeof resultOrAction === 'string'
+            ? resultOrAction
+            : JSON.stringify(resultOrAction);
+        await this.client._request('post', `/tools/${toolInvocationId}`, { data: { result } });
     }
     /** Stop streaming and cleanup */
     disconnect() {
@@ -412,32 +423,46 @@ class Agent {
     reset() {
         this.disconnect();
         this.chatId = null;
+        this.dispatchedToolCalls.clear();
     }
-    startStreaming(options) {
+    /** Stream events until chat becomes idle */
+    streamUntilIdle(options) {
         if (!this.chatId)
-            return;
-        this.stream = new stream_1.StreamManager({
-            createEventSource: async () => this.client._createEventSource(`/chats/${this.chatId}/stream`),
-            autoReconnect: true,
-        });
-        this.stream.addEventListener('chats', (chat) => {
-            options.onChat?.(chat);
-        });
-        this.stream.addEventListener('chat_messages', (message) => {
-            options.onMessage?.(message);
-            if (message.tool_invocations && options.onToolCall) {
-                for (const inv of message.tool_invocations) {
-                    if (inv.type === types_1.ToolTypeClient && inv.status === types_1.ToolInvocationStatusAwaitingInput) {
-                        options.onToolCall({
-                            id: inv.id,
-                            name: inv.function?.name || '',
-                            args: inv.function?.arguments || {},
-                        });
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            // Stop any existing stream
+            this.stream?.stop();
+            this.stream = new stream_1.StreamManager({
+                createEventSource: async () => this.client._createEventSource(`/chats/${this.chatId}/stream`),
+                autoReconnect: true,
+            });
+            this.stream.addEventListener('chats', (chat) => {
+                options.onChat?.(chat);
+                // Resolve when chat becomes idle (generation complete)
+                if (chat.status === 'idle') {
+                    resolve();
+                }
+            });
+            this.stream.addEventListener('chat_messages', (message) => {
+                options.onMessage?.(message);
+                if (message.tool_invocations && options.onToolCall) {
+                    for (const inv of message.tool_invocations) {
+                        // Skip if already dispatched
+                        if (this.dispatchedToolCalls.has(inv.id))
+                            continue;
+                        if (inv.type === types_1.ToolTypeClient && inv.status === types_1.ToolInvocationStatusAwaitingInput) {
+                            this.dispatchedToolCalls.add(inv.id);
+                            options.onToolCall({
+                                id: inv.id,
+                                name: inv.function?.name || '',
+                                args: inv.function?.arguments || {},
+                            });
+                        }
                     }
                 }
-            }
+            });
+            this.stream.connect();
         });
-        this.stream.connect();
     }
 }
 exports.Agent = Agent;

package/dist/integration.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Integration tests for @inferencesh/sdk
+ *
+ * These tests hit the real API and require INFERENCE_API_KEY to be set.
+ * Run with: npm run test:integration
+ *
+ * @jest-environment node
+ */
+export {};

package/dist/integration.test.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * Integration tests for @inferencesh/sdk
+ *
+ * These tests hit the real API and require INFERENCE_API_KEY to be set.
+ * Run with: npm run test:integration
+ *
+ * @jest-environment node
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const client_1 = require("./client");
+const types_1 = require("./types");
+// Skip all tests if no API key is set
+const API_KEY = process.env.INFERENCE_API_KEY;
+const BASE_URL = process.env.INFERENCE_BASE_URL || 'https://api.inference.sh';
+// Use a pinned app version that's known to work
+const TEST_APP = 'infsh/text-templating@53bk0yzk';
+const describeIfApiKey = API_KEY ? describe : describe.skip;
+describeIfApiKey('Integration Tests', () => {
+    let client;
+    beforeAll(() => {
+        client = new client_1.Inference({
+            apiKey: API_KEY,
+            baseUrl: BASE_URL,
+        });
+    });
+    describe('Basic Run', () => {
+        it('should run a simple task and wait for completion', async () => {
+            const result = await client.run({
+                app: TEST_APP,
+                input: { template: 'Hello {1}!', strings: ['Jest'] },
+            });
+            expect(result).toBeDefined();
+            expect(result.id).toBeDefined();
+            expect(result.status).toBe(types_1.TaskStatusCompleted);
+            expect(result.output).toBeDefined();
+        }, 60000); // 60 second timeout for API call
+    });
+    describe('Run with Updates', () => {
+        it('should receive status updates during task execution', async () => {
+            const updates = [];
+            const result = await client.run({
+                app: TEST_APP,
+                input: { template: 'Testing {1}', strings: ['SDK'] },
+            }, {
+                onUpdate: (update) => {
+                    updates.push(update.status);
+                },
+            });
+            expect(result.status).toBe(types_1.TaskStatusCompleted);
+            expect(updates.length).toBeGreaterThan(0);
+        }, 60000);
+    });
+    describe('Fire and Forget', () => {
+        it('should submit a task without waiting for completion', async () => {
+            const result = await client.run({
+                app: TEST_APP,
+                input: { template: '{1}', strings: ['Fire and forget'] },
+            }, { wait: false });
+            expect(result).toBeDefined();
+            expect(result.id).toBeDefined();
+            // Status should NOT be completed yet (task was just submitted)
+            expect(result.status).not.toBe(types_1.TaskStatusCompleted);
+            expect(result.status).not.toBe(types_1.TaskStatusFailed);
+        }, 30000);
+    });
+    describe('Factory Function', () => {
+        it('should work with lowercase inference() factory', async () => {
+            const factoryClient = (0, client_1.inference)({
+                apiKey: API_KEY,
+                baseUrl: BASE_URL,
+            });
+            const result = await factoryClient.run({
+                app: TEST_APP,
+                input: { template: '{1}', strings: ['Factory test'] },
+            }, { wait: false });
+            expect(result).toBeDefined();
+            expect(result.id).toBeDefined();
+        }, 30000);
+    });
+    describe('Error Handling', () => {
+        it('should throw an error for non-existent app', async () => {
+            await expect(client.run({
+                app: 'non-existent/app-that-does-not-exist@xyz123',
+                input: {},
+            }, { wait: false })).rejects.toThrow();
+        }, 30000);
+    });
+});
+// Add a simple test that always runs to ensure Jest doesn't complain about no tests
+describe('Integration Test Setup', () => {
+    it('should have API key check', () => {
+        if (!API_KEY) {
+            console.log('⚠️  Skipping integration tests - INFERENCE_API_KEY not set');
+        }
+        expect(true).toBe(true);
+    });
+});

package/dist/tool-builder.js

@@ -95,15 +95,13 @@ class AppToolBuilder extends ToolBuilder {
         this.appRef = appRef;
     }
     build() {
-        const [ns, rest] = this.appRef.split('/');
-        const [appName, version] = rest?.split('@') || [];
         return {
             name: this.name,
             display_name: this.displayName || this.name,
             description: this.desc,
             type: types_1.ToolTypeApp,
             require_approval: this.approval || undefined,
-            app: { id: `${ns}/${appName}`, version_id: version },
+            app: { ref: this.appRef },
         };
     }
 }
@@ -113,15 +111,13 @@ class AgentToolBuilder extends ToolBuilder {
         this.agentRef = agentRef;
     }
     build() {
-        const [ns, rest] = this.agentRef.split('/');
-        const [agentName, version] = rest?.split('@') || [];
         return {
             name: this.name,
             display_name: this.displayName || this.name,
             description: this.desc,
             type: types_1.ToolTypeAgent,
             require_approval: this.approval || undefined,
-            agent: { id: `${ns}/${agentName}`, version_id: version },
+            agent: { ref: this.agentRef },
         };
     }
 }

package/dist/tool-builder.test.js

@@ -169,12 +169,12 @@ describe('AppToolBuilder (appTool)', () => {
             .describe('Generate image')
             .build();
         expect(t.type).toBe(types_1.ToolTypeApp);
-        expect(t.app).toEqual({ id: 'infsh/flux', version_id: 'v1.0' });
+        expect(t.app).toEqual({ ref: 'infsh/flux@v1.0' });
         expect(t.description).toBe('Generate image');
     });
     it('handles app reference with latest version', () => {
         const t = (0, tool_builder_1.appTool)('browse', 'my-org/browser@latest').build();
-        expect(t.app).toEqual({ id: 'my-org/browser', version_id: 'latest' });
+        expect(t.app).toEqual({ ref: 'my-org/browser@latest' });
     });
     it('includes parameters', () => {
         const t = (0, tool_builder_1.appTool)('fetch', 'infsh/fetch@v1')
@@ -190,7 +190,7 @@ describe('AgentToolBuilder (agentTool)', () => {
             .describe('Research a topic')
             .build();
         expect(t.type).toBe(types_1.ToolTypeAgent);
-        expect(t.agent).toEqual({ id: 'acme/researcher', version_id: 'v2' });
+        expect(t.agent).toEqual({ ref: 'acme/researcher@v2' });
     });
     it('supports display name and approval', () => {
         const t = (0, tool_builder_1.agentTool)('coder', 'infsh/code-agent@latest')

package/dist/types.d.ts

@@ -20,10 +20,18 @@ export declare const ToolTypeInternal: ToolType;
  * AppToolConfig contains configuration for an app tool
  */
 export interface AppToolConfig {
-    id: string;
+    /**
+     * Ref is the human-readable reference: "namespace/name@shortVersionId"
+     * This is what users specify in configs/SDKs
+     */
+    ref: string;
+    /**
+     * ID and VersionID are resolved full database UUIDs (populated at runtime)
+     */
+    id?: string;
     version_id?: string;
     /**
-     * Resolved at runtime, not stored
+     * Resolved app object (populated at runtime)
      */
     app?: App;
 }
@@ -31,10 +39,18 @@ export interface AppToolConfig {
  * AgentToolConfig contains configuration for a sub-agent tool
  */
 export interface AgentToolConfig {
-    id: string;
+    /**
+     * Ref is the human-readable reference: "namespace/name@shortVersionId"
+     * This is what users specify in configs/SDKs
+     */
+    ref: string;
+    /**
+     * ID and VersionID are resolved full database UUIDs (populated at runtime)
+     */
+    id?: string;
     version_id?: string;
     /**
-     * Resolved at runtime, not stored
+     * Resolved agent object (populated at runtime)
      */
     agent?: Agent;
 }
@@ -73,6 +89,14 @@ export interface AgentTool {
     agent?: AgentToolConfig;
     hook?: HookToolConfig;
     client?: ClientToolConfig;
+    internal?: InternalToolConfig;
+}
+/**
+ * InternalToolConfig contains configuration for internal/built-in tools
+ */
+export interface InternalToolConfig {
+    category: string;
+    operation: string;
 }
 /**
  * AgentToolDTO for API responses
@@ -92,12 +116,14 @@ export interface AgentToolDTO {
     client?: ClientToolConfigDTO;
 }
 export interface AppToolConfigDTO {
-    id: string;
+    ref: string;
+    id?: string;
     version_id?: string;
     app?: AppDTO;
 }
 export interface AgentToolConfigDTO {
-    id: string;
+    ref: string;
+    id?: string;
     version_id?: string;
     agent?: AgentDTO;
 }
@@ -210,7 +236,10 @@ export interface AgentRuntimeConfig {
     example_prompts?: string[];
     /**
      * Core LLM
+     * CoreAppRef is the user-facing ref (namespace/name@shortid) - used in ad-hoc configs
+     * CoreApp is the resolved config - populated by backend after resolving CoreAppRef
      */
+    core_app_ref?: string;
     core_app?: CoreAppConfig;
     core_app_input?: any;
     /**
@@ -237,6 +266,7 @@ export interface AgentRuntimeConfigDTO {
     description?: string;
     system_prompt: string;
     example_prompts?: string[];
+    core_app_ref?: string;
     core_app?: CoreAppConfigDTO;
     core_app_input?: any;
     tools?: (AgentToolDTO | undefined)[];
@@ -282,10 +312,6 @@ export interface ApiAppRunRequest {
      */
     stream?: boolean;
 }
-/**
- * ApiTaskRequest is an alias for ApiAppRunRequest (deprecated name)
- */
-export type ApiTaskRequest = ApiAppRunRequest;
 /**
  * ApiAgentRunRequest is the request body for /agents/run endpoint.
  * Supports both template agents and ad-hoc agents.
@@ -298,31 +324,15 @@ export interface ApiAgentRunRequest {
     /**
      * Template agent reference in format: namespace/name@shortid
      * Example: "my-org/assistant@abc123"
-     * Use this OR core_app, not both
+     * Use this OR AgentConfig, not both
      */
     agent?: string;
     /**
-     * Core LLM app reference for ad-hoc agents in format: namespace/name@shortid
-     * Example: "infsh/claude-sonnet-4@1195p4sq"
-     * Use this for ad-hoc agents (without a saved template)
-     */
-    core_app?: string;
-    /**
-     * LLM parameters for ad-hoc agents (temperature, top_p, context_size, etc.)
-     */
-    core_app_input?: any;
-    /**
-     * Agent configuration for ad-hoc agents
+     * Ad-hoc agent configuration
+     * For ad-hoc agents, set core_app_ref to the LLM app reference
+     * Example: { "core_app_ref": "infsh/claude-sonnet-4@abc123", "system_prompt": "..." }
      */
-    name?: string;
-    description?: string;
-    system_prompt?: string;
-    example_prompts?: string[];
-    /**
-     * Tools configuration for ad-hoc agents
-     */
-    tools?: (AgentTool | undefined)[];
-    internal_tools?: InternalToolsConfig;
+    agent_config?: AgentRuntimeConfig;
     /**
      * The message to send
      */
@@ -332,10 +342,6 @@ export interface ApiAgentRunRequest {
      */
     stream?: boolean;
 }
-/**
- * ApiAgentMessageRequest is an alias for ApiAgentRunRequest (deprecated name)
- */
-export type ApiAgentMessageRequest = ApiAgentRunRequest;
 export interface CreateAgentMessageRequest {
     chat_id?: string;
     agent_id?: string;
@@ -350,21 +356,13 @@ export interface CreateAgentMessageRequest {
      */
     agent_config?: AgentRuntimeConfig;
 }
-export interface CreateChatMessageResponse {
+export interface CreateAgentMessageResponse {
     user_message?: ChatMessageDTO;
     assistant_message?: ChatMessageDTO;
 }
 /**
- * WidgetActionRequest represents a user's response to a widget
- * Uses WidgetAction and WidgetFormData from chat.go
- */
-export interface WidgetActionRequest {
-    action: WidgetAction;
-    form_data?: WidgetFormData;
-}
-/**
- * ToolResultRequest represents a generic tool result callback
- * Used by hooks and other tools that expect an async callback
+ * ToolResultRequest represents a tool result submission
+ * For widget actions, clients should JSON-serialize { action, form_data } as the result string
  */
 export interface ToolResultRequest {
     result: string;
@@ -648,6 +646,16 @@ export interface AppVariant {
     };
     python: string;
 }
+/**
+ * AppFunction represents a callable entry point within an app version.
+ * Each function has its own input/output schema while sharing the app's setup.
+ */
+export interface AppFunction {
+    name: string;
+    description?: string;
+    input_schema: any;
+    output_schema: any;
+}
 export interface AppVersion {
     BaseModel: BaseModel;
     /**
@@ -665,6 +673,15 @@ export interface AppVersion {
     setup_schema: any;
     input_schema: any;
     output_schema: any;
+    /**
+     * Functions contains the callable entry points for this app version.
+     * Each function has its own input/output schema. If nil/empty, the app uses legacy single-function mode
+     * with InputSchema/OutputSchema at the version level.
+     */
+    functions?: {
+        [key: string]: AppFunction;
+    };
+    default_function?: string;
     variants: {
         [key: string]: AppVariant;
     };
@@ -699,6 +716,10 @@ export interface AppVersionDTO extends BaseModel {
     setup_schema: any;
     input_schema: any;
     output_schema: any;
+    functions?: {
+        [key: string]: AppFunction;
+    };
+    default_function?: string;
     variants: {
         [key: string]: AppVariant;
     };
@@ -743,9 +764,7 @@ export interface PermissionModelDTO {
 export type ChatStatus = string;
 export declare const ChatStatusBusy: ChatStatus;
 export declare const ChatStatusIdle: ChatStatus;
-/**
- * ChatStatusWaitingInput ChatStatus = "waiting_input"
- */
+export declare const ChatStatusAwaitingInput: ChatStatus;
 export declare const ChatStatusCompleted: ChatStatus;
 export interface IntegrationContext {
     integration_type?: IntegrationType;
@@ -757,6 +776,7 @@ export interface IntegrationContext {
 export interface ChatData {
     plan_steps: PlanStep[];
     memory: StringEncodedMap;
+    always_allowed_tools: string[];
 }
 /**
  * PlanStep represents a step in an agent's execution plan
@@ -781,6 +801,14 @@ export declare const ChatMessageRoleSystem: ChatMessageRole;
 export declare const ChatMessageRoleUser: ChatMessageRole;
 export declare const ChatMessageRoleAssistant: ChatMessageRole;
 export declare const ChatMessageRoleTool: ChatMessageRole;
+/**
+ * ChatMessageStatus represents the lifecycle status of a chat message
+ */
+export type ChatMessageStatus = string;
+export declare const ChatMessageStatusPending: ChatMessageStatus;
+export declare const ChatMessageStatusReady: ChatMessageStatus;
+export declare const ChatMessageStatusFailed: ChatMessageStatus;
+export declare const ChatMessageStatusCancelled: ChatMessageStatus;
 export type ChatMessageContentType = string;
 export declare const ChatMessageContentTypeText: ChatMessageContentType;
 export declare const ChatMessageContentTypeReasoning: ChatMessageContentType;
@@ -861,8 +889,8 @@ export interface ChatMessageDTO extends BaseModel, PermissionModelDTO {
     chat_id: string;
     chat?: ChatDTO;
     order: number;
+    status: ChatMessageStatus;
     task_id?: string;
-    task_status?: TaskStatus;
     role: ChatMessageRole;
     content: ChatMessageContent[];
     tools?: Tool[];
@@ -992,6 +1020,7 @@ export interface FlowNodeData {
     app?: AppDTO;
     app_id: string;
     app_version_id: string;
+    function?: string;
     infra: Infra;
     workers: string[];
     setup?: any;
@@ -1374,6 +1403,7 @@ export interface TaskDTO extends BaseModel, PermissionModelDTO {
     app_version_id: string;
     app_version?: AppVersionDTO;
     app_variant: string;
+    function: string;
     infra: Infra;
     workers: string[];
     flow_id?: string;
@@ -1722,6 +1752,7 @@ export interface User {
     default_team_id: string;
     role: Role;
     email: string;
+    email_verified: boolean;
     name: string;
     full_name: string;
     avatar_url: string;
@@ -1845,9 +1876,3 @@ export interface Widget {
     children?: WidgetNode[];
     actions?: WidgetActionButton[];
 }
-/**
- * WidgetFormData represents the form data collected from widget inputs
- */
-export type WidgetFormData = {
-    [key: string]: any;
-};

package/dist/types.js

@@ -1,10 +1,10 @@
 "use strict";
 // Code generated by tygo. DO NOT EDIT.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EngineStatusRunning = exports.DeviceAuthStatusLoading = exports.DeviceAuthStatusInvalid = exports.DeviceAuthStatusValid = exports.DeviceAuthStatusDenied = exports.DeviceAuthStatusExpired = exports.DeviceAuthStatusApproved = exports.DeviceAuthStatusPending = exports.IntegrationTypeTelegram = exports.IntegrationTypeTeams = exports.IntegrationTypeDiscord = exports.IntegrationTypeSlack = exports.ChatMessageContentTypeTool = exports.ChatMessageContentTypeFile = exports.ChatMessageContentTypeImage = exports.ChatMessageContentTypeReasoning = exports.ChatMessageContentTypeText = exports.ChatMessageRoleTool = exports.ChatMessageRoleAssistant = exports.ChatMessageRoleUser = exports.ChatMessageRoleSystem = exports.PlanStepStatusCancelled = exports.PlanStepStatusCompleted = exports.PlanStepStatusInProgress = exports.PlanStepStatusPending = exports.ChatStatusCompleted = exports.ChatStatusIdle = exports.ChatStatusBusy = exports.VisibilityUnlisted = exports.VisibilityPublic = exports.VisibilityPrivate = exports.GPUTypeApple = exports.GPUTypeAMD = exports.GPUTypeNvidia = exports.GPUTypeIntel = exports.GPUTypeNone = exports.GPUTypeAny = exports.AppCategoryFlow = exports.AppCategoryOther = exports.AppCategory3D = exports.AppCategoryChat = exports.AppCategoryText = exports.AppCategoryAudio = exports.AppCategoryVideo = exports.AppCategoryImage = exports.ToolTypeInternal = exports.ToolTypeClient = exports.ToolTypeHook = exports.ToolTypeAgent = exports.ToolTypeApp = void 0;
-exports.TaskLogTypeServe = exports.TaskLogTypeRun = exports.TaskLogTypeBuild = exports.InfraPrivateFirst = exports.InfraCloud = exports.InfraPrivate = exports.TaskStatusCancelled = exports.TaskStatusFailed = exports.TaskStatusCompleted = exports.TaskStatusUploading = exports.TaskStatusRunning = exports.TaskStatusSettingUp = exports.TaskStatusServing = exports.TaskStatusPreparing = exports.TaskStatusScheduled = exports.TaskStatusQueued = exports.TaskStatusReceived = exports.TaskStatusUnknown = exports.InstanceStatusDeleted = exports.InstanceStatusActive = exports.InstanceStatusPending = exports.CloudShade = exports.CloudVultr = exports.CloudMassedCompute = exports.CloudDatacrunch = exports.CloudPaperspace = exports.CloudOblivus = exports.CloudJarvisLabs = exports.CloudLatitude = exports.CloudRunPod = exports.CloudTensorDock = exports.CloudLambdaLabs = exports.CloudAzure = exports.CloudAWS = exports.ContentUnrated = exports.ContentSelfHarm = exports.ContentDrugs = exports.ContentGore = exports.ContentViolenceGraphic = exports.ContentViolenceNonGraphic = exports.ContentSexualExplicit = exports.ContentSexualSuggestive = exports.ContentSafe = exports.ProjectTypeOther = exports.ProjectTypeFlow = exports.ProjectTypeApp = exports.ProjectTypeAgent = exports.EngineStatusStopped = exports.EngineStatusStopping = exports.EngineStatusPending = void 0;
-exports.WidgetNodeTypePlanList = exports.WidgetNodeTypeCol = exports.WidgetNodeTypeRow = exports.WidgetNodeTypeCheckbox = exports.WidgetNodeTypeSelect = exports.WidgetNodeTypeInput = exports.WidgetNodeTypeButton = exports.WidgetNodeTypeBadge = exports.WidgetNodeTypeImage = exports.WidgetNodeTypeMarkdown = exports.WidgetNodeTypeText = exports.RoleSystem = exports.RoleAdmin = exports.RoleUser = exports.RoleGuest = exports.VideoRes4K = exports.VideoRes1440P = exports.VideoRes1080P = exports.VideoRes720P = exports.VideoRes480P = exports.MetaItemTypeRaw = exports.MetaItemTypeAudio = exports.MetaItemTypeVideo = exports.MetaItemTypeImage = exports.MetaItemTypeText = exports.UsageEventResourceTierCloud = exports.UsageEventResourceTierPrivate = exports.PaymentRecordTypeAutoRecharge = exports.PaymentRecordTypeCheckout = exports.PaymentRecordStatusExpired = exports.PaymentRecordStatusFailed = exports.PaymentRecordStatusComplete = exports.PaymentRecordStatusPending = exports.TransactionTypeDebit = exports.TransactionTypeCredit = exports.ToolInvocationStatusCancelled = exports.ToolInvocationStatusFailed = exports.ToolInvocationStatusCompleted = exports.ToolInvocationStatusAwaitingApproval = exports.ToolInvocationStatusAwaitingInput = exports.ToolInvocationStatusInProgress = exports.ToolInvocationStatusPending = exports.TeamRoleMember = exports.TeamRoleAdmin = exports.TeamRoleOwner = exports.TeamTypeSystem = exports.TeamTypeTeam = exports.TeamTypePersonal = exports.TaskLogTypeTask = exports.TaskLogTypeSetup = void 0;
-exports.WidgetNodeTypeStatusBadge = exports.WidgetNodeTypeKeyValue = void 0;
+exports.DeviceAuthStatusExpired = exports.DeviceAuthStatusApproved = exports.DeviceAuthStatusPending = exports.IntegrationTypeTelegram = exports.IntegrationTypeTeams = exports.IntegrationTypeDiscord = exports.IntegrationTypeSlack = exports.ChatMessageContentTypeTool = exports.ChatMessageContentTypeFile = exports.ChatMessageContentTypeImage = exports.ChatMessageContentTypeReasoning = exports.ChatMessageContentTypeText = exports.ChatMessageStatusCancelled = exports.ChatMessageStatusFailed = exports.ChatMessageStatusReady = exports.ChatMessageStatusPending = exports.ChatMessageRoleTool = exports.ChatMessageRoleAssistant = exports.ChatMessageRoleUser = exports.ChatMessageRoleSystem = exports.PlanStepStatusCancelled = exports.PlanStepStatusCompleted = exports.PlanStepStatusInProgress = exports.PlanStepStatusPending = exports.ChatStatusCompleted = exports.ChatStatusAwaitingInput = exports.ChatStatusIdle = exports.ChatStatusBusy = exports.VisibilityUnlisted = exports.VisibilityPublic = exports.VisibilityPrivate = exports.GPUTypeApple = exports.GPUTypeAMD = exports.GPUTypeNvidia = exports.GPUTypeIntel = exports.GPUTypeNone = exports.GPUTypeAny = exports.AppCategoryFlow = exports.AppCategoryOther = exports.AppCategory3D = exports.AppCategoryChat = exports.AppCategoryText = exports.AppCategoryAudio = exports.AppCategoryVideo = exports.AppCategoryImage = exports.ToolTypeInternal = exports.ToolTypeClient = exports.ToolTypeHook = exports.ToolTypeAgent = exports.ToolTypeApp = void 0;
+exports.InfraPrivate = exports.TaskStatusCancelled = exports.TaskStatusFailed = exports.TaskStatusCompleted = exports.TaskStatusUploading = exports.TaskStatusRunning = exports.TaskStatusSettingUp = exports.TaskStatusServing = exports.TaskStatusPreparing = exports.TaskStatusScheduled = exports.TaskStatusQueued = exports.TaskStatusReceived = exports.TaskStatusUnknown = exports.InstanceStatusDeleted = exports.InstanceStatusActive = exports.InstanceStatusPending = exports.CloudShade = exports.CloudVultr = exports.CloudMassedCompute = exports.CloudDatacrunch = exports.CloudPaperspace = exports.CloudOblivus = exports.CloudJarvisLabs = exports.CloudLatitude = exports.CloudRunPod = exports.CloudTensorDock = exports.CloudLambdaLabs = exports.CloudAzure = exports.CloudAWS = exports.ContentUnrated = exports.ContentSelfHarm = exports.ContentDrugs = exports.ContentGore = exports.ContentViolenceGraphic = exports.ContentViolenceNonGraphic = exports.ContentSexualExplicit = exports.ContentSexualSuggestive = exports.ContentSafe = exports.ProjectTypeOther = exports.ProjectTypeFlow = exports.ProjectTypeApp = exports.ProjectTypeAgent = exports.EngineStatusStopped = exports.EngineStatusStopping = exports.EngineStatusPending = exports.EngineStatusRunning = exports.DeviceAuthStatusLoading = exports.DeviceAuthStatusInvalid = exports.DeviceAuthStatusValid = exports.DeviceAuthStatusDenied = void 0;
+exports.WidgetNodeTypeInput = exports.WidgetNodeTypeButton = exports.WidgetNodeTypeBadge = exports.WidgetNodeTypeImage = exports.WidgetNodeTypeMarkdown = exports.WidgetNodeTypeText = exports.RoleSystem = exports.RoleAdmin = exports.RoleUser = exports.RoleGuest = exports.VideoRes4K = exports.VideoRes1440P = exports.VideoRes1080P = exports.VideoRes720P = exports.VideoRes480P = exports.MetaItemTypeRaw = exports.MetaItemTypeAudio = exports.MetaItemTypeVideo = exports.MetaItemTypeImage = exports.MetaItemTypeText = exports.UsageEventResourceTierCloud = exports.UsageEventResourceTierPrivate = exports.PaymentRecordTypeAutoRecharge = exports.PaymentRecordTypeCheckout = exports.PaymentRecordStatusExpired = exports.PaymentRecordStatusFailed = exports.PaymentRecordStatusComplete = exports.PaymentRecordStatusPending = exports.TransactionTypeDebit = exports.TransactionTypeCredit = exports.ToolInvocationStatusCancelled = exports.ToolInvocationStatusFailed = exports.ToolInvocationStatusCompleted = exports.ToolInvocationStatusAwaitingApproval = exports.ToolInvocationStatusAwaitingInput = exports.ToolInvocationStatusInProgress = exports.ToolInvocationStatusPending = exports.TeamRoleMember = exports.TeamRoleAdmin = exports.TeamRoleOwner = exports.TeamTypeSystem = exports.TeamTypeTeam = exports.TeamTypePersonal = exports.TaskLogTypeTask = exports.TaskLogTypeSetup = exports.TaskLogTypeServe = exports.TaskLogTypeRun = exports.TaskLogTypeBuild = exports.InfraPrivateFirst = exports.InfraCloud = void 0;
+exports.WidgetNodeTypeStatusBadge = exports.WidgetNodeTypeKeyValue = exports.WidgetNodeTypePlanList = exports.WidgetNodeTypeCol = exports.WidgetNodeTypeRow = exports.WidgetNodeTypeCheckbox = exports.WidgetNodeTypeSelect = void 0;
 exports.ToolTypeApp = "app"; // App tools - creates a Task
 exports.ToolTypeAgent = "agent"; // Sub-agent tools - creates a sub-Chat
 exports.ToolTypeHook = "hook"; // Webhook tools - HTTP POST to external URL
@@ -29,9 +29,7 @@ exports.VisibilityPublic = "public";
 exports.VisibilityUnlisted = "unlisted";
 exports.ChatStatusBusy = "busy";
 exports.ChatStatusIdle = "idle";
-/**
- * ChatStatusWaitingInput ChatStatus = "waiting_input"
- */
+exports.ChatStatusAwaitingInput = "awaiting_input";
 exports.ChatStatusCompleted = "completed";
 exports.PlanStepStatusPending = "pending";
 exports.PlanStepStatusInProgress = "in_progress";
@@ -41,6 +39,10 @@ exports.ChatMessageRoleSystem = "system";
 exports.ChatMessageRoleUser = "user";
 exports.ChatMessageRoleAssistant = "assistant";
 exports.ChatMessageRoleTool = "tool";
+exports.ChatMessageStatusPending = "pending"; // Message is being generated
+exports.ChatMessageStatusReady = "ready"; // Message complete, tools ready for execution
+exports.ChatMessageStatusFailed = "failed"; // Message generation failed
+exports.ChatMessageStatusCancelled = "cancelled"; // Message was cancelled
 exports.ChatMessageContentTypeText = "text";
 exports.ChatMessageContentTypeReasoning = "reasoning";
 exports.ChatMessageContentTypeImage = "image";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -15,9 +15,11 @@
   "scripts": {
     "build": "tsc && npm run build:esm",
     "build:esm": "echo 'export * from \"./index.js\";' > dist/index.mjs",
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage",
+    "test": "jest --testPathIgnorePatterns=integration",
+    "test:integration": "jest --testPathPattern=integration --testTimeout=120000 --runInBand",
+    "test:all": "jest --testTimeout=120000 --runInBand",
+    "test:watch": "jest --watch --testPathIgnorePatterns=integration",
+    "test:coverage": "jest --coverage --testPathIgnorePatterns=integration",
     "lint": "eslint src --ext .ts",
     "lint:fix": "eslint src --ext .ts --fix",
     "format": "prettier --write \"src/**/*.ts\"",