@inferencesh/sdk 0.5.8 → 0.5.10

package/dist/api/files.js

@@ -1,3 +1,42 @@
+/**
+ * Parse a data URI and return the media type and decoded data.
+ *
+ * Supports formats:
+ * - data:image/jpeg;base64,/9j/4AAQ...
+ * - data:text/plain,Hello%20World
+ * - data:;base64,SGVsbG8= (defaults to text/plain)
+ */
+function parseDataUri(uri) {
+    // Match: data:[<mediatype>][;base64],<data>
+    const match = uri.match(/^data:([^;,]*)?(?:;(base64))?,(.*)$/s);
+    if (!match) {
+        throw new Error('Invalid data URI format');
+    }
+    const mediaType = match[1] || 'text/plain';
+    const isBase64 = match[2] === 'base64';
+    let dataStr = match[3];
+    if (isBase64) {
+        // Handle URL-safe base64 (- and _ instead of + and /)
+        dataStr = dataStr.replace(/-/g, '+').replace(/_/g, '/');
+        // Add padding if needed
+        const padding = 4 - (dataStr.length % 4);
+        if (padding !== 4) {
+            dataStr += '='.repeat(padding);
+        }
+        const binaryStr = atob(dataStr);
+        const bytes = new Uint8Array(binaryStr.length);
+        for (let i = 0; i < binaryStr.length; i++) {
+            bytes[i] = binaryStr.charCodeAt(i);
+        }
+        return { mediaType, data: bytes };
+    }
+    else {
+        // URL-encoded data
+        const decoded = decodeURIComponent(dataStr);
+        const encoder = new TextEncoder();
+        return { mediaType, data: encoder.encode(decoded) };
+    }
+}
 /**
  * Files API
  */
@@ -27,11 +66,26 @@ 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';
+            }
+        }
         // Step 1: Create the file record
         const fileRequest = {
             uri: '', // Empty URI as it will be set by the server
             filename: options.filename,
-            content_type: options.contentType || (data instanceof Blob ? data.type : 'application/octet-stream'),
+            content_type: contentType,
             path: options.path,
             size: data instanceof Blob ? data.size : undefined,
         };
@@ -50,16 +104,8 @@ export class FilesAPI {
         else {
             // If it's a base64 string, convert it to a Blob
             if (data.startsWith('data:')) {
-                const matches = data.match(/^data:([^;]+);base64,(.+)$/);
-                if (!matches) {
-                    throw new Error('Invalid base64 data URI format');
-                }
-                const binaryStr = atob(matches[2]);
-                const bytes = new Uint8Array(binaryStr.length);
-                for (let i = 0; i < binaryStr.length; i++) {
-                    bytes[i] = binaryStr.charCodeAt(i);
-                }
-                contentToUpload = new Blob([bytes], { type: matches[1] });
+                const parsed = parseDataUri(data);
+                contentToUpload = new Blob([parsed.data.buffer], { type: parsed.mediaType });
             }
             else {
                 // Assume it's a clean base64 string
@@ -68,7 +114,7 @@ export class FilesAPI {
                 for (let i = 0; i < binaryStr.length; i++) {
                     bytes[i] = binaryStr.charCodeAt(i);
                 }
-                contentToUpload = new Blob([bytes], { type: options.contentType || 'application/octet-stream' });
+                contentToUpload = new Blob([bytes.buffer], { type: options.contentType || 'application/octet-stream' });
             }
         }
         // Upload to S3 using the signed URL

package/dist/api/tasks.js

@@ -1,6 +1,7 @@
 import { StreamManager } from '../http/stream';
 import { PollManager } from '../http/poll';
 import { TaskStatusCompleted, TaskStatusFailed, TaskStatusCancelled, } from '../types';
+import { parseStatus } from '../utils';
 //TODO: This is ugly...
 function stripTask(task) {
     return {
@@ -97,15 +98,15 @@ export class TasksAPI {
                     accumulatedTask = { ...accumulatedTask, ...data };
                     const stripped = stripTask(accumulatedTask);
                     onUpdate?.(stripped);
-                    if (data.status === TaskStatusCompleted) {
+                    if (parseStatus(data.status) === TaskStatusCompleted) {
                         streamManager.stop();
                         resolve(stripped);
                     }
-                    else if (data.status === TaskStatusFailed) {
+                    else if (parseStatus(data.status) === TaskStatusFailed) {
                         streamManager.stop();
                         reject(new Error(data.error || 'task failed'));
                     }
-                    else if (data.status === TaskStatusCancelled) {
+                    else if (parseStatus(data.status) === TaskStatusCancelled) {
                         streamManager.stop();
                         reject(new Error('task cancelled'));
                     }
@@ -115,15 +116,15 @@ export class TasksAPI {
                     accumulatedTask = { ...accumulatedTask, ...data };
                     const stripped = stripTask(accumulatedTask);
                     onPartialUpdate?.(stripped, fields);
-                    if (data.status === TaskStatusCompleted) {
+                    if (parseStatus(data.status) === TaskStatusCompleted) {
                         streamManager.stop();
                         resolve(stripped);
                     }
-                    else if (data.status === TaskStatusFailed) {
+                    else if (parseStatus(data.status) === TaskStatusFailed) {
                         streamManager.stop();
                         reject(new Error(data.error || 'task failed'));
                     }
-                    else if (data.status === TaskStatusCancelled) {
+                    else if (parseStatus(data.status) === TaskStatusCancelled) {
                         streamManager.stop();
                         reject(new Error('task cancelled'));
                     }
@@ -155,15 +156,15 @@ export class TasksAPI {
                         const fullTask = await this.http.request('get', `/tasks/${task.id}`);
                         const stripped = stripTask(fullTask);
                         onUpdate?.(stripped);
-                        if (fullTask.status === TaskStatusCompleted) {
+                        if (parseStatus(fullTask.status) === TaskStatusCompleted) {
                             poller.stop();
                             resolve(stripped);
                         }
-                        else if (fullTask.status === TaskStatusFailed) {
+                        else if (parseStatus(fullTask.status) === TaskStatusFailed) {
                             poller.stop();
                             reject(new Error(fullTask.error || 'task failed'));
                         }
-                        else if (fullTask.status === TaskStatusCancelled) {
+                        else if (parseStatus(fullTask.status) === TaskStatusCancelled) {
                             poller.stop();
                             reject(new Error('task cancelled'));
                         }
@@ -191,7 +192,7 @@ export class TasksAPI {
      * Feature/unfeature a task
      */
     async feature(taskId, featured) {
-        return this.http.request('post', `/tasks/${taskId}/featured`, { data: { featured } });
+        return this.http.request('post', `/tasks/${taskId}/featured`, { data: { is_featured: featured } });
     }
 }
 export function createTasksAPI(http) {

package/dist/http/client.js

@@ -80,7 +80,9 @@ export class HttpClient {
         if (options.params) {
             Object.entries(options.params).forEach(([key, value]) => {
                 if (value !== undefined && value !== null) {
-                    targetUrl.searchParams.append(key, String(value));
+                    // Serialize arrays and objects as JSON, primitives as strings
+                    const serialized = typeof value === 'object' ? JSON.stringify(value) : String(value);
+                    targetUrl.searchParams.append(key, serialized);
                 }
             });
         }

package/dist/http/errors.d.ts

@@ -23,10 +23,12 @@ export declare class InferenceError extends Error {
  *
  * @example
  * ```typescript
+ * import { isRequirementsNotMetException } from '@inferencesh/sdk';
+ *
  * try {
  *   const task = await client.run(params);
  * } catch (e) {
- *   if (e instanceof RequirementsNotMetException) {
+ *   if (isRequirementsNotMetException(e)) {
  *     for (const err of e.errors) {
  *       console.log(`Missing ${err.type}: ${err.key}`);
  *       if (err.action) {
@@ -130,3 +132,16 @@ export declare class SessionEndedError extends SessionError {
 export declare class WorkerLostError extends SessionError {
     constructor(sessionId: string, responseBody?: string);
 }
+/**
+ * Type guard for RequirementsNotMetException.
+ * Handles cross-module issues where instanceof may fail.
+ */
+export declare function isRequirementsNotMetException(err: unknown): err is RequirementsNotMetException;
+/**
+ * Type guard for InferenceError.
+ */
+export declare function isInferenceError(err: unknown): err is InferenceError;
+/**
+ * Type guard for SessionError (or any subclass).
+ */
+export declare function isSessionError(err: unknown): err is SessionError;

package/dist/http/errors.js

@@ -25,10 +25,12 @@ export class InferenceError extends Error {
  *
  * @example
  * ```typescript
+ * import { isRequirementsNotMetException } from '@inferencesh/sdk';
+ *
  * try {
  *   const task = await client.run(params);
  * } catch (e) {
- *   if (e instanceof RequirementsNotMetException) {
+ *   if (isRequirementsNotMetException(e)) {
  *     for (const err of e.errors) {
  *       console.log(`Missing ${err.type}: ${err.key}`);
  *       if (err.action) {
@@ -152,3 +154,44 @@ export class WorkerLostError extends SessionError {
         this.name = 'WorkerLostError';
     }
 }
+// =============================================================================
+// Type Guards
+// =============================================================================
+// These handle cross-module/bundle issues where instanceof may fail.
+// Use these instead of instanceof for reliable error checking.
+/**
+ * Type guard for RequirementsNotMetException.
+ * Handles cross-module issues where instanceof may fail.
+ */
+export function isRequirementsNotMetException(err) {
+    if (err instanceof RequirementsNotMetException)
+        return true;
+    if (typeof err !== 'object' || err === null)
+        return false;
+    const e = err;
+    return e.name === 'RequirementsNotMetException' ||
+        (e.statusCode === 412 && Array.isArray(e.errors));
+}
+/**
+ * Type guard for InferenceError.
+ */
+export function isInferenceError(err) {
+    if (err instanceof InferenceError)
+        return true;
+    if (typeof err !== 'object' || err === null)
+        return false;
+    const e = err;
+    return e.name === 'InferenceError' && typeof e.statusCode === 'number';
+}
+/**
+ * Type guard for SessionError (or any subclass).
+ */
+export function isSessionError(err) {
+    if (err instanceof SessionError)
+        return true;
+    if (typeof err !== 'object' || err === null)
+        return false;
+    const e = err;
+    return typeof e.sessionId === 'string' && typeof e.statusCode === 'number' &&
+        ['SessionError', 'SessionNotFoundError', 'SessionExpiredError', 'SessionEndedError', 'WorkerLostError'].includes(e.name);
+}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { HttpClient, HttpClientConfig, ErrorHandler, createHttpClient } from './http/client';
 export { StreamManager, StreamManagerOptions, PartialDataWrapper } from './http/stream';
 export { PollManager, PollManagerOptions } from './http/poll';
-export { InferenceError, RequirementsNotMetException, SessionError, SessionNotFoundError, SessionExpiredError, SessionEndedError, WorkerLostError, } from './http/errors';
+export { InferenceError, RequirementsNotMetException, SessionError, SessionNotFoundError, SessionExpiredError, SessionEndedError, WorkerLostError, isRequirementsNotMetException, isInferenceError, isSessionError, } from './http/errors';
 export { TasksAPI, RunOptions } from './api/tasks';
 export { FilesAPI, UploadFileOptions } from './api/files';
 export { AgentsAPI, Agent, AgentOptions, SendMessageOptions, AgentRunOptions } from './api/agents';
@@ -13,6 +13,7 @@ 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 type { ClientTool, ClientToolHandler } from './tool-builder';
+export { parseStatus, isTerminalStatus } from './utils';
 export * from './types';
 export type { TaskDTO as Task } from './types';
 import { HttpClient, HttpClientConfig } from './http/client';

package/dist/index.js

@@ -2,7 +2,9 @@
 export { HttpClient, createHttpClient } from './http/client';
 export { StreamManager } from './http/stream';
 export { PollManager } from './http/poll';
-export { InferenceError, RequirementsNotMetException, SessionError, SessionNotFoundError, SessionExpiredError, SessionEndedError, WorkerLostError, } from './http/errors';
+export { InferenceError, RequirementsNotMetException, SessionError, SessionNotFoundError, SessionExpiredError, SessionEndedError, WorkerLostError, 
+// Type guards (use these instead of instanceof for reliability)
+isRequirementsNotMetException, isInferenceError, isSessionError, } from './http/errors';
 // API modules
 export { TasksAPI } from './api/tasks';
 export { FilesAPI } from './api/files';
@@ -15,6 +17,8 @@ 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';
+// Status utilities (handle both int and string status values)
+export { parseStatus, isTerminalStatus } from './utils';
 // Types - includes TaskStatus constants and all DTOs
 export * from './types';
 // =============================================================================

package/dist/types.d.ts

@@ -367,6 +367,11 @@ export interface ApiAppRunRequest {
      * Session timeout in seconds (1-3600). Only valid when session="new"
      */
     session_timeout?: number;
+    /**
+     * Schedule execution for a specific time (ISO 8601 UTC, e.g. "2026-02-24T15:30:00Z").
+     * Task stays queued until this time. Past timestamps run immediately.
+     */
+    run_at?: string;
 }
 /**
  * ApiAgentRunRequest is the request body for /agents/run endpoint.
@@ -442,9 +447,9 @@ export interface ToolResultRequest {
     result: string;
 }
 /**
- * WebhookEvent is the envelope for task webhook deliveries.
+ * WebhookPayload is the envelope for outbound webhook deliveries (e.g., task webhooks).
  */
-export interface WebhookEvent<T extends any> {
+export interface WebhookPayload<T extends any> {
     event: string;
     timestamp: string;
     data: T;
@@ -533,6 +538,7 @@ export interface CreateAgentRequest {
 export interface SDKTypes {
 }
 export interface SkillPublishRequest {
+    namespace?: string;
     name: string;
     description: string;
     category: string;
@@ -1936,21 +1942,17 @@ export interface HFCacheInfo {
 /**
  * TaskStatus represents the state of a task in its lifecycle.
  * DESIGN NOTES:
- * - Stored as int in DB for compact storage and efficient equality checks.
- * - The int values are ordered to allow SQL range queries (status < ?) for performance.
- * - IMPORTANT: If you add new statuses in the MIDDLE of the sequence, you must:
- *  1. Write a migration to shift existing values
- *  2. Update SDKs and frontends
- *     - ALTERNATIVE: Add new statuses at the END to avoid migrations, but then you
- *     cannot use range comparisons (< >) and must use explicit checks (IN, NOT IN).
- *     - Kubernetes/Temporal use strings and explicit checks for maximum flexibility.
- *     Consider switching to strings if range comparisons become a maintenance burden.
+ * - Stored as int in DB for compact storage. New statuses can be added with any int value.
+ * - Logical ordering is defined by statusOrder map, NOT by the int values.
+ * - To add a new status: add const with next available int, add to statusOrder at correct position.
+ * - SQL queries use explicit lists (IN, NOT IN) via helper functions, not range comparisons.
+ * - This design allows future migration to string-based storage without breaking changes.
  */
 export type TaskStatus = number;
 export declare const TaskStatusUnknown: TaskStatus;
 export declare const TaskStatusReceived: TaskStatus;
 export declare const TaskStatusQueued: TaskStatus;
-export declare const TaskStatusScheduled: TaskStatus;
+export declare const TaskStatusDispatched: TaskStatus;
 export declare const TaskStatusPreparing: TaskStatus;
 export declare const TaskStatusServing: TaskStatus;
 export declare const TaskStatusSettingUp: TaskStatus;
@@ -2012,8 +2014,6 @@ export interface Task extends BaseModel, PermissionModel {
     logs: TaskLog[];
     telemetry: TimescaleTask[];
     usage_events: (UsageEvent | undefined)[];
-    transaction_id?: string;
-    transaction?: Transaction;
     /**
      * Secret refs for billing (tracks ownership to determine partner fee)
      */
@@ -2028,6 +2028,10 @@ export interface Task extends BaseModel, PermissionModel {
      * Session timeout in seconds (only used when session="new")
      */
     session_timeout?: number;
+    /**
+     * Scheduled execution time (UTC). Scheduler skips task until this time.
+     */
+    run_at?: string;
 }
 export interface TaskEvent {
     id: string;
@@ -2074,6 +2078,7 @@ export interface TaskDTO extends BaseModel, PermissionModelDTO {
     engine?: EngineStateSummary;
     worker_id?: string;
     worker?: WorkerStateSummary;
+    run_at?: string;
     webhook?: string;
     setup?: any;
     input: any;
@@ -2084,8 +2089,6 @@ export interface TaskDTO extends BaseModel, PermissionModelDTO {
     logs: TaskLog[];
     telemetry: TimescaleTask[];
     usage_events: (UsageEvent | undefined)[];
-    transaction_id?: string;
-    transaction?: Transaction;
     session_id?: string;
     session_timeout?: number;
 }
@@ -2116,6 +2119,10 @@ export interface Team extends BaseModel {
      * Personal teams start with SetupCompleted=false and a generated temporary username
      */
     setup_completed: boolean;
+    /**
+     * MaxConcurrency limits total active tasks for this team (0 = use default)
+     */
+    max_concurrency: number;
 }
 export interface TeamDTO extends BaseModel {
     type: TeamType;
@@ -2124,6 +2131,7 @@ export interface TeamDTO extends BaseModel {
     avatar_url: string;
     email: string;
     setup_completed: boolean;
+    max_concurrency: number;
 }
 export type TeamRole = string;
 export declare const TeamRoleOwner: TeamRole;
@@ -2204,130 +2212,9 @@ export interface ToolParameterProperty {
     items?: ToolParameterProperty;
     required?: string[];
 }
-/**
- * TransactionType represents the type of credit transaction
- */
-export type TransactionType = string;
-export declare const TransactionTypeCredit: TransactionType;
-export declare const TransactionTypeDebit: TransactionType;
-/**
- * Transaction represents a single credit transaction
- */
-export interface Transaction extends BaseModel {
-    PermissionModel: PermissionModel;
-    type: TransactionType;
-    amount: number;
-    reference: string;
-    notes: string;
-    /**
-     * Metadata for the transaction
-     */
-    metadata: {
-        [key: string]: any;
-    };
-    /**
-     * SideEffectsProcessed tracks whether side effects (notifications, auto-recharge,
-     * billing status changes) have been processed for this transaction.
-     * Set to true via WithSkipTxSideEffects context to skip side effects (e.g. migrations).
-     */
-    side_effects_processed: boolean;
-}
-/**
- * PaymentRecordStatus represents the status of a payment
- */
-export type PaymentRecordStatus = number;
-export declare const PaymentRecordStatusPending: PaymentRecordStatus;
-export declare const PaymentRecordStatusComplete: PaymentRecordStatus;
-export declare const PaymentRecordStatusFailed: PaymentRecordStatus;
-export declare const PaymentRecordStatusExpired: PaymentRecordStatus;
-/**
- * PaymentRecordType represents the type of payment
- */
-export type PaymentRecordType = string;
-export declare const PaymentRecordTypeCheckout: PaymentRecordType;
-export declare const PaymentRecordTypeAutoRecharge: PaymentRecordType;
-/**
- * PaymentRecord stores Stripe payment details for both checkout sessions and direct charges
- */
-export interface PaymentRecord extends BaseModel, PermissionModel {
-    type: PaymentRecordType;
-    status: PaymentRecordStatus;
-    amount: number;
-    service_fee: number;
-    stripe_customer_id: string;
-    payment_intent_id: string;
-    receipt_url: string;
-    /**
-     * Checkout-specific fields (only set for checkout type)
-     */
-    session_id: string;
-    session_url: string;
-}
 export type UsageEventResourceTier = string;
 export declare const UsageEventResourceTierPrivate: UsageEventResourceTier;
 export declare const UsageEventResourceTierCloud: UsageEventResourceTier;
-/**
- * MetaItemType is the type discriminator for MetaItem
- */
-export type MetaItemType = string;
-export declare const MetaItemTypeText: MetaItemType;
-export declare const MetaItemTypeImage: MetaItemType;
-export declare const MetaItemTypeVideo: MetaItemType;
-export declare const MetaItemTypeAudio: MetaItemType;
-export declare const MetaItemTypeRaw: MetaItemType;
-/**
- * VideoResolution represents standard video resolution presets
- */
-export type VideoResolution = string;
-export declare const VideoRes480P: VideoResolution;
-export declare const VideoRes720P: VideoResolution;
-export declare const VideoRes1080P: VideoResolution;
-export declare const VideoRes1440P: VideoResolution;
-export declare const VideoRes4K: VideoResolution;
-/**
- * MetaItem represents metadata about an input or output item
- */
-export interface MetaItem {
-    type: MetaItemType;
-    /**
-     * Text fields
-     */
-    tokens?: number;
-    /**
-     * Image/Video shared fields
-     */
-    width?: number;
-    height?: number;
-    resolution_mp?: number;
-    /**
-     * Image specific fields
-     */
-    steps?: number;
-    count?: number;
-    /**
-     * Video specific fields
-     */
-    resolution?: VideoResolution;
-    seconds?: number;
-    fps?: number;
-    /**
-     * Audio specific fields
-     */
-    sample_rate?: number;
-    /**
-     * App-specific key-value pairs for custom pricing factors
-     */
-    extra?: {
-        [key: string]: any;
-    };
-}
-/**
- * OutputMeta contains structured metadata about task inputs and outputs for pricing calculation
- */
-export interface OutputMeta {
-    inputs: MetaItem[];
-    outputs: MetaItem[];
-}
 export interface UsageEvent extends BaseModel, PermissionModel {
     usage_billing_record_id: string;
     reference_id: string;
@@ -2341,74 +2228,6 @@ export interface UsageEvent extends BaseModel, PermissionModel {
     quantity: number;
     unit: string;
 }
-/**
- * DiscountItem represents a single discount applied to a billing record
- */
-export interface DiscountItem {
-    reason: string;
-    amount: number;
-}
-export interface UsageBillingRecord extends BaseModel, PermissionModel {
-    /**
-     * Fee breakdown (all in microcents)
-     */
-    total: number;
-    discount: number;
-    /**
-     * User debit (total charged)
-     */
-    user_debit_transaction_id: string;
-    user_debit_transaction?: Transaction;
-    /**
-     * Resource owner credit (for providing compute)
-     */
-    resource_credit_transaction_id: string;
-    resource_credit_transaction?: Transaction;
-    /**
-     * Creator royalty credit (app creator earnings)
-     */
-    royalty_credit_transaction_id: string;
-    royalty_credit_transaction?: Transaction;
-    /**
-     * Inference fee credit (platform fee)
-     */
-    inference_credit_transaction_id: string;
-    inference_credit_transaction?: Transaction;
-    /**
-     * Partner fee credit (cloud API fee)
-     */
-    partner_credit_transaction_id: string;
-    partner_credit_transaction?: Transaction;
-}
-export interface UsageBillingRefund extends BaseModel, PermissionModel {
-    usage_billing_record_id: string;
-    usage_billing_record?: UsageBillingRecord;
-    /**
-     * User refund (total refunded)
-     */
-    user_debit_refund_transaction_id: string;
-    user_debit_refund_transaction?: Transaction;
-    /**
-     * Resource owner reversal
-     */
-    resource_credit_refund_transaction_id: string;
-    resource_credit_refund_transaction?: Transaction;
-    /**
-     * Creator royalty reversal
-     */
-    royalty_credit_refund_transaction_id: string;
-    royalty_credit_refund_transaction?: Transaction;
-    /**
-     * Inference fee reversal
-     */
-    inference_credit_refund_transaction_id: string;
-    inference_credit_refund_transaction?: Transaction;
-    /**
-     * Partner fee reversal
-     */
-    partner_credit_refund_transaction_id: string;
-    partner_credit_refund_transaction?: Transaction;
-}
 /**
  * User-related types
  */

package/dist/types.js

@@ -153,7 +153,7 @@ export const InstanceStatusDeleted = "deleted";
 export const TaskStatusUnknown = 0; // 0
 export const TaskStatusReceived = 1; // 1
 export const TaskStatusQueued = 2; // 2
-export const TaskStatusScheduled = 3; // 3
+export const TaskStatusDispatched = 3; // 3 - Worker assigned, task sent to worker
 export const TaskStatusPreparing = 4; // 4
 export const TaskStatusServing = 5; // 5
 export const TaskStatusSettingUp = 6; // 6
@@ -184,26 +184,8 @@ export const ToolInvocationStatusAwaitingApproval = "awaiting_approval"; // Wait
 export const ToolInvocationStatusCompleted = "completed";
 export const ToolInvocationStatusFailed = "failed";
 export const ToolInvocationStatusCancelled = "cancelled";
-export const TransactionTypeCredit = "credit"; // Adding credits
-export const TransactionTypeDebit = "debit"; // Removing credits
-export const PaymentRecordStatusPending = 0;
-export const PaymentRecordStatusComplete = 1;
-export const PaymentRecordStatusFailed = 2;
-export const PaymentRecordStatusExpired = 3;
-export const PaymentRecordTypeCheckout = "checkout"; // Stripe Checkout session (manual top-up)
-export const PaymentRecordTypeAutoRecharge = "auto_recharge"; // Direct charge (auto-recharge)
 export const UsageEventResourceTierPrivate = "private";
 export const UsageEventResourceTierCloud = "cloud";
-export const MetaItemTypeText = "text";
-export const MetaItemTypeImage = "image";
-export const MetaItemTypeVideo = "video";
-export const MetaItemTypeAudio = "audio";
-export const MetaItemTypeRaw = "raw";
-export const VideoRes480P = "480p";
-export const VideoRes720P = "720p";
-export const VideoRes1080P = "1080p";
-export const VideoRes1440P = "1440p";
-export const VideoRes4K = "4k";
 export const RoleGuest = "guest";
 export const RoleUser = "user";
 export const RoleAdmin = "admin";

package/dist/utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Status utilities for handling both int and string-based status values.
+ * Provides future compatibility when API migrates from int to string status.
+ */
+import { TaskStatus } from './types';
+/**
+ * Parse task status from int or string to TaskStatus number.
+ * Handles both current int-based API and future string-based API.
+ */
+export declare function parseStatus(status: number | string | undefined | null): TaskStatus;
+/**
+ * Check if a task status is terminal (completed, failed, or cancelled).
+ * Handles both int and string status values.
+ */
+export declare function isTerminalStatus(status: number | string | undefined | null): boolean;

package/dist/utils.js

@@ -0,0 +1,45 @@
+/**
+ * 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';
+/** Map string status names to TaskStatus values (for future string-based API) */
+const STATUS_STRING_MAP = {
+    unknown: TaskStatusUnknown,
+    received: TaskStatusReceived,
+    queued: TaskStatusQueued,
+    dispatched: TaskStatusDispatched,
+    preparing: TaskStatusPreparing,
+    serving: TaskStatusServing,
+    setting_up: TaskStatusSettingUp,
+    running: TaskStatusRunning,
+    cancelling: TaskStatusCancelling,
+    uploading: TaskStatusUploading,
+    completed: TaskStatusCompleted,
+    failed: TaskStatusFailed,
+    cancelled: TaskStatusCancelled,
+};
+/**
+ * Parse task status from int or string to TaskStatus number.
+ * Handles both current int-based API and future string-based API.
+ */
+export function parseStatus(status) {
+    if (status === undefined || status === null) {
+        return TaskStatusUnknown;
+    }
+    if (typeof status === 'number') {
+        return status;
+    }
+    if (typeof status === 'string') {
+        return STATUS_STRING_MAP[status.toLowerCase()] ?? TaskStatusUnknown;
+    }
+    return TaskStatusUnknown;
+}
+/**
+ * Check if a task status is terminal (completed, failed, or cancelled).
+ * Handles both int and string status values.
+ */
+export function isTerminalStatus(status) {
+    const parsed = parseStatus(status);
+    return parsed === TaskStatusCompleted || parsed === TaskStatusFailed || parsed === TaskStatusCancelled;
+}

package/package.json

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