@inferencesh/sdk 0.5.6 → 0.5.8

package/dist/agent/actions.js

@@ -4,7 +4,7 @@
  * Action creators that handle side effects (API calls, streaming).
  * These are created once per provider instance with access to dispatch.
  */
-import { ToolInvocationStatusAwaitingInput, ToolTypeClient, } from '../types';
+import { ToolInvocationStatusAwaitingInput, ToolTypeClient, ChatStatusBusy, } from '../types';
 import { StreamManager } from '../http/stream';
 import { PollManager } from '../http/poll';
 import { isAdHocConfig, extractClientToolHandlers } from './types';
@@ -24,7 +24,7 @@ export function createActions(ctx) {
     const setChat = (chat) => {
         dispatch({ type: 'SET_CHAT', payload: chat });
         if (chat) {
-            const status = chat.status === 'busy' ? 'streaming' : 'idle';
+            const status = chat.status === ChatStatusBusy ? 'streaming' : 'idle';
             callbacks.onStatusChange?.(status);
         }
     };

package/dist/api/agents.d.ts

@@ -32,6 +32,10 @@ export interface SendMessageOptions {
     /** Polling interval in ms when stream is false. Overrides client default. */
     pollIntervalMs?: number;
 }
+export interface AgentRunOptions extends Omit<SendMessageOptions, 'stream'> {
+    /** Polling interval in ms (default: 2000) */
+    pollIntervalMs?: number;
+}
 /**
  * Agent for chat interactions
  *
@@ -71,6 +75,14 @@ export declare class Agent {
     }): Promise<void>;
     /** Stop streaming/polling and cleanup */
     disconnect(): void;
+    /**
+     * Run the agent and return structured output.
+     *
+     * Sends a message, waits for completion (always polls, no SSE), then returns
+     * `chat.output` — the parsed finish tool result. Returns `null` if the agent
+     * finished without calling the finish tool.
+     */
+    run(text: string, options?: AgentRunOptions): Promise<any>;
     /** Reset the agent (start fresh chat) */
     reset(): void;
     /**

package/dist/api/agents.js

@@ -1,6 +1,6 @@
 import { StreamManager } from '../http/stream';
 import { PollManager } from '../http/poll';
-import { ToolTypeClient, ToolInvocationStatusAwaitingInput, } from '../types';
+import { ToolTypeClient, ToolInvocationStatusAwaitingInput, ChatStatusBusy, } from '../types';
 /**
  * Agent for chat interactions
  *
@@ -62,12 +62,13 @@ export class Agent {
                 input: { text, images: imageUris, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
             };
         const useStream = options.stream ?? this.http.getStreamDefault();
-        const waitFn = useStream
-            ? (opts) => this.streamUntilIdle(opts)
-            : (opts) => this.pollUntilIdle(opts);
-        // For existing chats with callbacks: Start waiting BEFORE POST so we don't miss updates
+        const shouldWait = useStream === false || hasCallbacks;
+        const waitFn = useStream === false
+            ? (opts) => this.pollUntilIdle(opts)
+            : (opts) => this.streamUntilIdle(opts);
+        // For existing chats: Start waiting BEFORE POST so we don't miss updates
         let waitPromise = null;
-        if (this.chatId && hasCallbacks) {
+        if (this.chatId && shouldWait) {
             waitPromise = waitFn(options);
         }
         // Make the POST request
@@ -76,7 +77,7 @@ export class Agent {
         const isNewChat = !this.chatId && response.assistant_message.chat_id;
         if (isNewChat) {
             this.chatId = response.assistant_message.chat_id;
-            if (hasCallbacks) {
+            if (shouldWait) {
                 waitPromise = waitFn(options);
             }
         }
@@ -113,6 +114,18 @@ export class Agent {
         this.poller?.stop();
         this.poller = null;
     }
+    /**
+     * Run the agent and return structured output.
+     *
+     * Sends a message, waits for completion (always polls, no SSE), then returns
+     * `chat.output` — the parsed finish tool result. Returns `null` if the agent
+     * finished without calling the finish tool.
+     */
+    async run(text, options = {}) {
+        await this.sendMessage(text, { ...options, stream: false });
+        const chat = await this.getChat();
+        return chat?.output ?? null;
+    }
     /** Reset the agent (start fresh chat) */
     reset() {
         this.disconnect();
@@ -139,7 +152,7 @@ export class Agent {
             });
             this.stream.addEventListener('chats', (chat) => {
                 options.onChat?.(chat);
-                if (chat.status === 'idle') {
+                if (chat.status !== ChatStatusBusy) {
                     resolve();
                 }
             });
@@ -217,7 +230,7 @@ export class Agent {
                             }
                         }
                     }
-                    if (chat.status === 'idle') {
+                    if (chat.status !== ChatStatusBusy) {
                         this.poller?.stop();
                         this.poller = null;
                         resolve();

package/dist/api/index.d.ts

@@ -1,4 +1,4 @@
 export { TasksAPI, createTasksAPI, RunOptions } from './tasks';
 export { FilesAPI, createFilesAPI, UploadFileOptions } from './files';
-export { AgentsAPI, createAgentsAPI, Agent, AgentOptions, SendMessageOptions } from './agents';
+export { AgentsAPI, createAgentsAPI, Agent, AgentOptions, SendMessageOptions, AgentRunOptions } from './agents';
 export { SessionsAPI, createSessionsAPI } from './sessions';

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { PollManager, PollManagerOptions } from './http/poll';
 export { InferenceError, RequirementsNotMetException, SessionError, SessionNotFoundError, SessionExpiredError, SessionEndedError, WorkerLostError, } from './http/errors';
 export { TasksAPI, RunOptions } from './api/tasks';
 export { FilesAPI, UploadFileOptions } from './api/files';
-export { AgentsAPI, Agent, AgentOptions, SendMessageOptions } from './api/agents';
+export { AgentsAPI, Agent, AgentOptions, SendMessageOptions, AgentRunOptions } from './api/agents';
 export { SessionsAPI } from './api/sessions';
 export { AppsAPI } from './api/apps';
 export { ChatsAPI } from './api/chats';

package/dist/integration.test.js

@@ -76,6 +76,17 @@ describeIfApiKey('Integration Tests', () => {
             expect(result.id).toBeDefined();
         }, 30000);
     });
+    describe('Webhook', () => {
+        it('should deliver webhook on task completion', async () => {
+            const result = await client.run({
+                app: TEST_APP,
+                input: { template: 'Webhook test {1}', strings: ['hello'] },
+                webhook: 'https://webhook.site/bbe9ba01-3ab2-4056-a1b1-1cf6969987d5',
+            });
+            expect(result.status).toBe(TaskStatusCompleted);
+            expect(result.output).toBeDefined();
+        }, 60000);
+    });
     describe('Error Handling', () => {
         it('should throw an error for non-existent app', async () => {
             await expect(client.run({

package/dist/types.d.ts

@@ -349,6 +349,11 @@ export interface ApiAppRunRequest {
      * If true, returns SSE stream instead of JSON response
      */
     stream?: boolean;
+    /**
+     * If true, holds the connection open until the task reaches a terminal state and returns the final result.
+     * Mutually exclusive with Stream.
+     */
+    wait?: boolean;
     /**
      * Function to call on multi-function apps (defaults to "run" or app's default_function)
      */
@@ -436,6 +441,14 @@ export interface CreateAgentMessageResponse {
 export interface ToolResultRequest {
     result: string;
 }
+/**
+ * WebhookEvent is the envelope for task webhook deliveries.
+ */
+export interface WebhookEvent<T extends any> {
+    event: string;
+    timestamp: string;
+    data: T;
+}
 /**
  * HookPayload represents the request body sent to a webhook when a hook tool is invoked
  */
@@ -720,6 +733,16 @@ export interface EngineConfig {
     network_name: string;
     cache_path: string;
     gpus: string[];
+    /**
+     * CallbackBasePort overrides the base port for engine↔worker callback APIs.
+     * If 0, derived from EnginePort: 5000 + (enginePort - 8163) * 100.
+     */
+    callback_base_port: number;
+    /**
+     * EngineInternalAPIURL is the URL workers use to reach the engine's main API.
+     * If empty, derived as http://host.docker.internal:{EnginePort}.
+     */
+    engine_internal_api_url: string;
 }
 export type AppCategory = string;
 export declare const AppCategoryImage: AppCategory;
@@ -1188,6 +1211,7 @@ export declare const DeviceAuthStatusLoading: DeviceAuthStatus;
 export type EngineStatus = string;
 export declare const EngineStatusRunning: EngineStatus;
 export declare const EngineStatusPending: EngineStatus;
+export declare const EngineStatusDraining: EngineStatus;
 export declare const EngineStatusStopping: EngineStatus;
 export declare const EngineStatusStopped: EngineStatus;
 export interface EngineState extends BaseModel, PermissionModel {
@@ -1979,7 +2003,7 @@ export interface Task extends BaseModel, PermissionModel {
     setup?: any;
     input: any;
     output: any;
-    error: string;
+    error?: string;
     rating: ContentRating;
     /**
      * Relationships
@@ -2054,7 +2078,7 @@ export interface TaskDTO extends BaseModel, PermissionModelDTO {
     setup?: any;
     input: any;
     output: any;
-    error: string;
+    error?: string;
     rating: ContentRating;
     events: TaskEvent[];
     logs: TaskLog[];

package/dist/types.js

@@ -80,6 +80,7 @@ export const DeviceAuthStatusInvalid = "invalid";
 export const DeviceAuthStatusLoading = "loading";
 export const EngineStatusRunning = "running";
 export const EngineStatusPending = "pending";
+export const EngineStatusDraining = "draining";
 export const EngineStatusStopping = "stopping";
 export const EngineStatusStopped = "stopped";
 export const FlowRunStatusUnknown = 0; // 0

package/package.json

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