@inferencesh/sdk 0.6.21 → 0.6.26

package/dist/agent/actions.js

@@ -4,27 +4,25 @@
  * Action creators that handle side effects (API calls, streaming).
  * These are created once per provider instance with access to dispatch.
  */
-import { ToolInvocationStatusAwaitingInput, ToolInvocationStatusInProgress, ToolTypeClient, ChatStatusBusy, } from '../types';
+import { ToolInvocationStatusAwaitingInput, ToolInvocationStatusInProgress, ToolTypeClient, } from '../types';
+import { isChatBusy } from '../utils';
 import { StreamableManager } from '../http/streamable';
 import { PollManager } from '../http/poll';
 import { isAdHocConfig, extractClientToolHandlers } from './types';
 import * as api from './api';
 // =============================================================================
-// Track dispatched client tool invocations to prevent duplicates
-// =============================================================================
-const dispatchedToolInvocations = new Set();
-// =============================================================================
 // Action Creators
 // =============================================================================
 export function createActions(ctx) {
+    const dispatchedToolInvocations = new Set();
     const { client, dispatch, getConfig, getChatId, getClientToolHandlers, getStreamManager, setStreamManager, getStreamEnabled, getPollIntervalMs, callbacks } = ctx;
     let prevChatWasBusy = false;
     const checkTurnEnd = (chat) => {
-        const isBusy = chat.status === ChatStatusBusy;
-        if (prevChatWasBusy && !isBusy) {
+        const busy = isChatBusy(chat);
+        if (prevChatWasBusy && !busy) {
             callbacks.onTurnEnd?.(chat);
         }
-        prevChatWasBusy = isBusy;
+        prevChatWasBusy = busy;
     };
     // =========================================================================
     // Internal helpers
@@ -32,8 +30,7 @@ export function createActions(ctx) {
     const setChat = (chat) => {
         dispatch({ type: 'SET_CHAT', payload: chat });
         if (chat) {
-            const status = chat.status === ChatStatusBusy ? 'streaming' : 'idle';
-            callbacks.onStatusChange?.(status);
+            callbacks.onStatusChange?.(isChatBusy(chat) ? 'streaming' : 'idle');
             checkTurnEnd(chat);
         }
     };
@@ -136,8 +133,7 @@ export function createActions(ctx) {
         manager.addEventListener('chats', (chatData) => {
             dispatch({ type: 'UPDATE_CHAT', payload: chatData });
             if (chatData) {
-                const status = chatData.status === ChatStatusBusy ? 'streaming' : 'idle';
-                callbacks.onStatusChange?.(status);
+                callbacks.onStatusChange?.(isChatBusy(chatData) ? 'streaming' : 'idle');
                 checkTurnEnd(chatData);
             }
         });
@@ -218,6 +214,7 @@ export function createActions(ctx) {
             const trimmedText = text.trim();
             if (!trimmedText)
                 return;
+            dispatchedToolInvocations.clear();
             // Update status
             dispatch({ type: 'SET_CONNECTION_STATUS', payload: 'streaming' });
             dispatch({ type: 'SET_ERROR', payload: undefined });

package/dist/api/agents.js

@@ -1,6 +1,7 @@
 import { StreamableManager } from '../http/streamable';
 import { PollManager } from '../http/poll';
-import { ToolTypeClient, ToolInvocationStatusAwaitingInput, ToolInvocationStatusInProgress, ChatStatusBusy, } from '../types';
+import { ToolTypeClient, ToolInvocationStatusAwaitingInput, ToolInvocationStatusInProgress, } from '../types';
+import { isChatBusy } from '../utils';
 /**
  * Agent for chat interactions
  *
@@ -25,6 +26,7 @@ export class Agent {
     }
     /** Send a message to the agent */
     async sendMessage(text, options = {}) {
+        this.dispatchedToolCalls.clear();
         const isTemplate = typeof this.config === 'string';
         const hasCallbacks = !!(options.onMessage || options.onChat || options.onToolCall);
         // Process files - either already uploaded (FileDTO with uri) or needs upload (Blob)
@@ -156,7 +158,7 @@ export class Agent {
             });
             this.stream.addEventListener('chats', (chat) => {
                 options.onChat?.(chat);
-                if (chat.status !== ChatStatusBusy) {
+                if (!isChatBusy(chat)) {
                     resolve();
                 }
             });
@@ -234,7 +236,7 @@ export class Agent {
                             }
                         }
                     }
-                    if (chat.status !== ChatStatusBusy) {
+                    if (!isChatBusy(chat)) {
                         this.poller?.stop();
                         this.poller = null;
                         resolve();

package/dist/api/files.d.ts

@@ -9,6 +9,25 @@ export interface UploadFileOptions {
 /**
  * Files API
  */
+/**
+ * Everything about a presigned upload except which endpoint mints the record.
+ *
+ * js/app's platform-media API posts to /admin/media/upload with a category
+ * instead of /files, and had re-derived all of this — content type, filename,
+ * the PUT, the ok check — losing the data-URI and base64 handling in the
+ * process. Splitting the transfer from the create call lets both share one
+ * implementation of the part that talks to S3.
+ */
+export interface ResolvedUpload {
+    contentType: string;
+    filename?: string;
+    size?: number;
+    /** The bytes to PUT, normalised from a Blob, a data URI or bare base64. */
+    body: Blob;
+}
+export declare function resolveUpload(data: string | Blob, options?: UploadFileOptions): ResolvedUpload;
+/** PUTs the bytes to a presigned URL and throws on a non-2xx response. */
+export declare function putToSignedUrl(uploadUrl: string, body: Blob): Promise<void>;
 export declare class FilesAPI {
     private readonly http;
     constructor(http: HttpClient);

package/dist/api/files.js

@@ -37,9 +37,63 @@ function parseDataUri(uri) {
         return { mediaType, data: encoder.encode(decoded) };
     }
 }
-/**
- * Files API
- */
+const extMimeTypes = {
+    jfif: 'image/jpeg', jpe: 'image/jpeg', jpg: 'image/jpeg', jpeg: 'image/jpeg',
+    png: 'image/png', gif: 'image/gif', webp: 'image/webp', avif: 'image/avif',
+    heic: 'image/heif', heif: 'image/heif', tif: 'image/tiff', tiff: 'image/tiff',
+    bmp: 'image/bmp', svg: 'image/svg+xml',
+    mp4: 'video/mp4', mov: 'video/quicktime', webm: 'video/webm', mkv: 'video/x-matroska',
+    mp3: 'audio/mpeg', wav: 'audio/wav', ogg: 'audio/ogg', flac: 'audio/flac',
+    aac: 'audio/aac', m4a: 'audio/mp4',
+    pdf: 'application/pdf',
+};
+function mimeFromFilename(name) {
+    const ext = name.split('.').pop()?.toLowerCase();
+    return ext ? extMimeTypes[ext] : undefined;
+}
+export function resolveUpload(data, options = {}) {
+    let filename = options.filename;
+    if (!filename && data instanceof globalThis.File) {
+        filename = data.name;
+    }
+    const contentType = options.contentType ||
+        (data instanceof Blob ? data.type : data.match(/^data:([^;,]*)[;,]/)?.[1]) ||
+        (filename ? mimeFromFilename(filename) : undefined) ||
+        'application/octet-stream';
+    let body;
+    if (data instanceof Blob) {
+        body = data;
+    }
+    else if (data.startsWith('data:')) {
+        const parsed = parseDataUri(data);
+        body = new Blob([parsed.data.buffer], { type: parsed.mediaType });
+    }
+    else {
+        const binaryStr = atob(data);
+        const bytes = new Uint8Array(binaryStr.length);
+        for (let i = 0; i < binaryStr.length; i++) {
+            bytes[i] = binaryStr.charCodeAt(i);
+        }
+        body = new Blob([bytes.buffer], { type: contentType });
+    }
+    return {
+        contentType,
+        filename,
+        size: data instanceof Blob ? data.size : undefined,
+        body,
+    };
+}
+/** PUTs the bytes to a presigned URL and throws on a non-2xx response. */
+export async function putToSignedUrl(uploadUrl, body) {
+    const response = await fetch(uploadUrl, {
+        method: 'PUT',
+        body,
+        headers: { 'Content-Type': body.type || 'application/octet-stream' },
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to upload file content: ${response.statusText}`);
+    }
+}
 export class FilesAPI {
     constructor(http) {
         this.http = http;
@@ -66,33 +120,14 @@ export class FilesAPI {
      * Upload a file (Blob or base64 string)
      */
     async upload(data, options = {}) {
-        // Determine content type
-        let contentType = options.contentType;
-        if (!contentType) {
-            if (data instanceof Blob) {
-                contentType = data.type;
-            }
-            else if (typeof data === 'string' && data.startsWith('data:')) {
-                // Extract media type from data URI
-                const match = data.match(/^data:([^;,]*)?/);
-                contentType = match?.[1] || 'application/octet-stream';
-            }
-            else {
-                contentType = 'application/octet-stream';
-            }
-        }
-        // Extract filename from File object if not provided in options
-        let filename = options.filename;
-        if (!filename && data instanceof globalThis.File) {
-            filename = data.name;
-        }
+        const resolved = resolveUpload(data, options);
         // Step 1: Create the file record
         const fileRequest = {
             uri: '', // Empty URI as it will be set by the server
-            filename,
-            content_type: contentType,
+            filename: resolved.filename,
+            content_type: resolved.contentType,
             path: options.path,
-            size: data instanceof Blob ? data.size : undefined,
+            size: resolved.size,
         };
         const response = await this.http.request('post', '/files', {
             data: { files: [fileRequest] },
@@ -102,37 +137,7 @@ export class FilesAPI {
         if (!file.upload_url) {
             throw new Error('No upload URL provided by the server');
         }
-        let contentToUpload;
-        if (data instanceof Blob) {
-            contentToUpload = data;
-        }
-        else {
-            // If it's a base64 string, convert it to a Blob
-            if (data.startsWith('data:')) {
-                const parsed = parseDataUri(data);
-                contentToUpload = new Blob([parsed.data.buffer], { type: parsed.mediaType });
-            }
-            else {
-                // Assume it's a clean base64 string
-                const binaryStr = atob(data);
-                const bytes = new Uint8Array(binaryStr.length);
-                for (let i = 0; i < binaryStr.length; i++) {
-                    bytes[i] = binaryStr.charCodeAt(i);
-                }
-                contentToUpload = new Blob([bytes.buffer], { type: options.contentType || 'application/octet-stream' });
-            }
-        }
-        // Upload to S3 using the signed URL
-        const uploadResponse = await fetch(file.upload_url, {
-            method: 'PUT',
-            body: contentToUpload,
-            headers: {
-                'Content-Type': contentToUpload.type,
-            },
-        });
-        if (!uploadResponse.ok) {
-            throw new Error(`Failed to upload file content: ${uploadResponse.statusText}`);
-        }
+        await putToSignedUrl(file.upload_url, resolved.body);
         return file;
     }
     /**

package/dist/index.d.ts

@@ -22,7 +22,7 @@ export { ProjectsAPI } from './api/projects';
 export { MCPServersAPI } from './api/mcp-servers';
 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 { parseStatus, isTerminalStatus, isChatBusy } from './utils';
 export * from './types';
 export type { TaskDTO as Task } from './types';
 import { HttpClient, type HttpClientConfig } from './http/client';

package/dist/index.js

@@ -27,7 +27,7 @@ export { MCPServersAPI } from './api/mcp-servers';
 // Tool Builder (fluent API)
 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';
+export { parseStatus, isTerminalStatus, isChatBusy } from './utils';
 // Types - includes TaskStatus constants and all DTOs
 export * from './types';
 // =============================================================================

package/dist/types.d.ts

@@ -241,6 +241,20 @@ export interface CoreAppConfigInput {
     setup?: any;
     input?: any;
 }
+export interface AgentRunDTO extends BaseModelDTO, PermissionModelDTO {
+    agent_id: string;
+    agent?: AgentDTO;
+    agent_version_id?: string;
+    chat_id: string;
+    user_message_id?: string;
+    state: AgentRunState;
+    error?: string;
+    interrupt_reason?: InterruptReason;
+    interrupt_tool_id?: string;
+    interrupt_meta?: any;
+    trigger_id?: string;
+    metadata?: any;
+}
 export interface APIResponse<T extends any> {
     success: boolean;
     status: number;
@@ -512,9 +526,7 @@ export interface CreateApiKeyRequest {
  * EstimateCostRequest is the request for POST /store/apps/{appId}/estimate.
  */
 export interface EstimateCostRequest {
-    input: {
-        [key: string]: any;
-    };
+    input: any;
     function?: string;
 }
 /**
@@ -1099,6 +1111,27 @@ export interface ResourceStatusDTO {
     status: any;
     updated_at: string;
 }
+/**
+ * AvailabilityResponse answers "can I use this name?" — for page slugs, team
+ * usernames and voucher codes alike.
+ * The three checks had three different shapes, and one of them was an untyped
+ * map[string]bool that generated no client type at all, so each caller invented
+ * its own handling. Reason exists because "not available" was previously
+ * indistinguishable from "reserved": every client that wanted to say why had to
+ * mirror the server's reserved-name list to guess, and those mirrors went stale.
+ */
+export interface AvailabilityResponse {
+    /**
+     * Value is the normalized form of what was checked — the server may slugify
+     * or lowercase the input, and the client should show what it actually took.
+     */
+    value: string;
+    available: boolean;
+    /**
+     * Reason is set only when Available is false: "taken" or "reserved".
+     */
+    reason?: string;
+}
 /**
  * ChatDTO for API responses
  */
@@ -1119,6 +1152,7 @@ export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
     description: string;
     chat_messages: ChatMessageDTO[];
     agent_data: ChatData;
+    active_run?: AgentRunDTO;
 }
 /**
  * ChatMessageDTO for API responses
@@ -1126,6 +1160,7 @@ export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
 export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
     chat_id: string;
     chat?: ChatDTO;
+    agent_run_id?: string;
     order: number;
     status: ChatMessageStatus;
     task_id?: string;
@@ -1136,10 +1171,10 @@ export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
     tool_invocations?: ToolInvocationDTO[];
 }
 /**
- * SearchRequest represents a search request
+ * SearchRequest represents a search request.
+ * Each model declares its own SearchFields() on the repository.
  */
 export interface SearchRequest {
-    fields: string[];
     term: string;
     exact: boolean;
 }
@@ -1835,6 +1870,11 @@ export interface PageMetadata {
     type?: string;
     icon?: string;
     hide_from_nav?: boolean;
+    /**
+     * PublishAt is when a scheduled page goes live. Only meaningful while the
+     * page's status is PageStatusScheduled.
+     */
+    publish_at?: string;
 }
 /**
  * MenuItem represents an item in a menu (can be nested)
@@ -1863,6 +1903,11 @@ export interface PageDTO extends BaseModelDTO, PermissionModelDTO {
     type: PageType;
     metadata: PageMetadata;
     slug: string;
+    /**
+     * PublishAt mirrors Metadata.PublishAt, which remains the field clients write.
+     * Surfaced here so a reader does not have to reach into the metadata blob.
+     */
+    publish_at?: string;
 }
 /**
  * MenuDTO for API responses
@@ -2684,6 +2729,29 @@ export interface Widget {
     children?: WidgetNode[];
     actions?: WidgetActionButton[];
 }
+/**
+ * AgentRunState tracks the lifecycle of an agent run (one user→agent turn).
+ * Maps to A2A TaskState and AG-UI Run outcome for protocol compliance.
+ */
+export type AgentRunState = string;
+export declare const AgentRunStateSubmitted: AgentRunState;
+export declare const AgentRunStateWorking: AgentRunState;
+export declare const AgentRunStateInputRequired: AgentRunState;
+export declare const AgentRunStateAuthRequired: AgentRunState;
+export declare const AgentRunStateCompleted: AgentRunState;
+export declare const AgentRunStateFailed: AgentRunState;
+export declare const AgentRunStateCanceled: AgentRunState;
+export declare const AgentRunStateRejected: AgentRunState;
+/**
+ * InterruptReason describes why an agent run is in an interrupted state.
+ * Aligns with AG-UI interrupt outcome reasons.
+ */
+export type InterruptReason = string;
+export declare const InterruptReasonToolApproval: InterruptReason;
+export declare const InterruptReasonClientTool: InterruptReason;
+export declare const InterruptReasonWidget: InterruptReason;
+export declare const InterruptReasonAuth: InterruptReason;
+export declare const InterruptReasonConfirmation: InterruptReason;
 export type AppCategory = string;
 export declare const AppCategoryImage: AppCategory;
 export declare const AppCategoryVideo: AppCategory;
@@ -2854,6 +2922,7 @@ export declare const EngineStatusRunning: EngineStatus;
 export declare const EngineStatusPending: EngineStatus;
 export declare const EngineStatusDraining: EngineStatus;
 export declare const EngineStatusDisconnected: EngineStatus;
+export declare const EngineStatusRestarting: EngineStatus;
 export declare const EngineStatusStopping: EngineStatus;
 export declare const EngineStatusStopped: EngineStatus;
 /**
@@ -3011,6 +3080,7 @@ export declare const PageStatusUnknown: PageStatus;
 export declare const PageStatusDraft: PageStatus;
 export declare const PageStatusPublished: PageStatus;
 export declare const PageStatusArchived: PageStatus;
+export declare const PageStatusScheduled: PageStatus;
 /**
  * PageType represents the type of page content
  */

package/dist/types.js

@@ -261,6 +261,19 @@ export const RequirementTypeScope = "scope";
 export const SetupActionAddSecret = "add_secret";
 export const SetupActionConnect = "connect";
 export const SetupActionAddScopes = "add_scopes";
+export const AgentRunStateSubmitted = "submitted";
+export const AgentRunStateWorking = "working";
+export const AgentRunStateInputRequired = "input_required";
+export const AgentRunStateAuthRequired = "auth_required";
+export const AgentRunStateCompleted = "completed";
+export const AgentRunStateFailed = "failed";
+export const AgentRunStateCanceled = "canceled";
+export const AgentRunStateRejected = "rejected";
+export const InterruptReasonToolApproval = "tool_approval";
+export const InterruptReasonClientTool = "client_tool";
+export const InterruptReasonWidget = "widget";
+export const InterruptReasonAuth = "auth";
+export const InterruptReasonConfirmation = "confirmation";
 export const AppCategoryImage = "image";
 export const AppCategoryVideo = "video";
 export const AppCategoryAudio = "audio";
@@ -329,6 +342,7 @@ export const EngineStatusRunning = "running";
 export const EngineStatusPending = "pending";
 export const EngineStatusDraining = "draining";
 export const EngineStatusDisconnected = "disconnected";
+export const EngineStatusRestarting = "restarting";
 export const EngineStatusStopping = "stopping";
 export const EngineStatusStopped = "stopped";
 export const WorkerStatusReserved = "reserved";
@@ -389,6 +403,7 @@ export const PageStatusUnknown = 0;
 export const PageStatusDraft = 1;
 export const PageStatusPublished = 2;
 export const PageStatusArchived = 3;
+export const PageStatusScheduled = 4;
 export const PageTypeDoc = "doc";
 export const PageTypeBlog = "blog";
 export const PageTypePage = "page";

package/dist/utils.d.ts

@@ -3,6 +3,7 @@
  * Provides future compatibility when API migrates from int to string status.
  */
 import { TaskStatus } from './types';
+import type { ChatDTO } from './types';
 /**
  * Parse task status from int or string to TaskStatus number.
  * Handles both current int-based API and future string-based API.
@@ -13,3 +14,4 @@ export declare function parseStatus(status: number | string | undefined | null):
  * Handles both int and string status values.
  */
 export declare function isTerminalStatus(status: number | string | undefined | null): boolean;
+export declare function isChatBusy(chat: ChatDTO | null | undefined): boolean;

package/dist/utils.js

@@ -2,7 +2,7 @@
  * Status utilities for handling both int and string-based status values.
  * Provides future compatibility when API migrates from int to string status.
  */
-import { TaskStatusUnknown, TaskStatusReceived, TaskStatusQueued, TaskStatusDispatched, TaskStatusPreparing, TaskStatusServing, TaskStatusSettingUp, TaskStatusRunning, TaskStatusCancelling, TaskStatusUploading, TaskStatusCompleted, TaskStatusFailed, TaskStatusCancelled, } from './types';
+import { TaskStatusUnknown, TaskStatusReceived, TaskStatusQueued, TaskStatusDispatched, TaskStatusPreparing, TaskStatusServing, TaskStatusSettingUp, TaskStatusRunning, TaskStatusCancelling, TaskStatusUploading, TaskStatusCompleted, TaskStatusFailed, TaskStatusCancelled, AgentRunStateWorking, AgentRunStateSubmitted, } from './types';
 /** Map string status names to TaskStatus values (for future string-based API) */
 const STATUS_STRING_MAP = {
     unknown: TaskStatusUnknown,
@@ -43,3 +43,7 @@ export function isTerminalStatus(status) {
     const parsed = parseStatus(status);
     return parsed === TaskStatusCompleted || parsed === TaskStatusFailed || parsed === TaskStatusCancelled;
 }
+export function isChatBusy(chat) {
+    const state = chat?.active_run?.state;
+    return state === AgentRunStateWorking || state === AgentRunStateSubmitted;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.6.21",
+  "version": "0.6.26",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "type": "module",
   "main": "dist/index.js",
@@ -39,6 +39,11 @@
       "types": "./dist/agent/index.d.ts",
       "inference-src": "./src/agent/index.ts",
       "default": "./dist/agent/index.js"
+    },
+    "./internal/upload": {
+      "types": "./dist/api/files.d.ts",
+      "inference-src": "./src/api/files.ts",
+      "default": "./dist/api/files.js"
     }
   },
   "scripts": {