@inferencesh/sdk 0.5.6 → 0.5.7

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/package.json

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