@inferencesh/sdk 0.5.7 → 0.5.9

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'));
                         }

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/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)
      */
@@ -362,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.
@@ -436,6 +446,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
  */
@@ -520,6 +538,7 @@ export interface CreateAgentRequest {
 export interface SDKTypes {
 }
 export interface SkillPublishRequest {
+    namespace?: string;
     name: string;
     description: string;
     category: string;
@@ -720,6 +739,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;
@@ -954,6 +983,12 @@ export interface ResourceStatusDTO {
     status: any;
     updated_at: string;
 }
+/**
+ * PaymentProvider represents the payment provider being used
+ */
+export type PaymentProvider = string;
+export declare const PaymentProviderNone: PaymentProvider;
+export declare const PaymentProviderStripe: PaymentProvider;
 export type ChatStatus = string;
 export declare const ChatStatusBusy: ChatStatus;
 export declare const ChatStatusIdle: ChatStatus;
@@ -1188,6 +1223,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 {
@@ -1585,6 +1621,167 @@ export interface IntegrationDTO extends BaseModel, PermissionModelDTO {
     is_primary: boolean;
     error_message?: string;
 }
+/**
+ * InvoiceType distinguishes invoices from credit notes
+ */
+export type InvoiceType = string;
+export declare const InvoiceTypeInvoice: InvoiceType;
+export declare const InvoiceTypeCreditNote: InvoiceType;
+/**
+ * InvoiceStatus represents the lifecycle status of an invoice
+ */
+export type InvoiceStatus = string;
+export declare const InvoiceStatusDraft: InvoiceStatus;
+export declare const InvoiceStatusFinalized: InvoiceStatus;
+export declare const InvoiceStatusCorrected: InvoiceStatus;
+export declare const InvoiceStatusVoided: InvoiceStatus;
+/**
+ * TaxMode determines how tax is handled on the invoice
+ */
+export type TaxMode = string;
+export declare const TaxModeNone: TaxMode;
+export declare const TaxModeVAT: TaxMode;
+export declare const TaxModeReverseCharge: TaxMode;
+/**
+ * Invoice represents a legal invoice or credit note
+ */
+export interface Invoice extends BaseModel, PermissionModel {
+    /**
+     * Invoice Identity
+     */
+    type: InvoiceType;
+    invoice_number: string;
+    series: string;
+    status: InvoiceStatus;
+    /**
+     * Dates
+     */
+    issue_date: string;
+    service_period_start?: string;
+    service_period_end?: string;
+    finalized_at?: string;
+    /**
+     * Issuer Snapshot (frozen from admin settings at creation)
+     */
+    issuer_legal_name: string;
+    issuer_address: string;
+    issuer_country: string;
+    issuer_tax_id: string;
+    issuer_email: string;
+    /**
+     * Customer Snapshot (frozen from BillingSettings at creation)
+     */
+    customer_legal_name: string;
+    customer_address: string;
+    customer_country: string;
+    customer_vat_number: string;
+    customer_email: string;
+    is_business_customer: boolean;
+    customer_vat_validated: boolean;
+    /**
+     * Financial (all amounts in cents, matches PaymentRecord)
+     * For credit notes, amounts are NEGATIVE
+     */
+    currency: string;
+    subtotal_amount: number;
+    service_fee: number;
+    tax_rate: number;
+    tax_amount: number;
+    total_amount: number;
+    tax_mode: TaxMode;
+    /**
+     * Linkage to payment
+     */
+    payment_record_id: string;
+    provider_payment_id: string;
+    /**
+     * Corrections (for credit notes referencing original invoice)
+     */
+    original_invoice_id?: string;
+    correction_reason: string;
+    /**
+     * Storage
+     */
+    pdf_path: string;
+    snapshot: string;
+    /**
+     * Relations
+     */
+    items: InvoiceItem[];
+}
+/**
+ * InvoiceItem represents a line item on an invoice
+ */
+export interface InvoiceItem extends BaseModel {
+    invoice_id: string;
+    description: string;
+    quantity: number;
+    unit_price: number;
+    line_total: number;
+}
+/**
+ * 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;
+/**
+ * TaxBreakdownItem represents a single tax component
+ */
+export interface TaxBreakdownItem {
+    amount: number;
+    rate: number;
+    jurisdiction?: string;
+    display_name?: string;
+    inclusive?: boolean;
+}
+/**
+ * PaymentRecord stores payment details for checkout sessions and direct charges (provider-agnostic)
+ * Field naming follows Stripe conventions for financial clarity.
+ */
+export interface PaymentRecord extends BaseModel, PermissionModel {
+    type: PaymentRecordType;
+    status: PaymentRecordStatus;
+    currency: string;
+    /**
+     * Financial amounts (Stripe-style naming)
+     */
+    credit_amount: number;
+    service_fee: number;
+    amount_subtotal: number;
+    amount_tax: number;
+    amount_total: number;
+    /**
+     * Tax breakdown by jurisdiction (for invoicing)
+     */
+    tax_breakdown?: TaxBreakdownItem[];
+    /**
+     * Provider-agnostic fields
+     */
+    provider: PaymentProvider;
+    provider_customer_id: string;
+    provider_session_id: string;
+    provider_payment_id: string;
+    receipt_url: string;
+    /**
+     * Provider-specific details (checkout URLs, session IDs, etc.)
+     */
+    provider_metadata: {
+        [key: string]: any;
+    };
+    /**
+     * Related invoice (if one exists) - loaded via preload
+     */
+    invoice?: Invoice;
+}
 /**
  * ProjectType represents different types of projects
  */
@@ -1912,21 +2109,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;
@@ -1979,7 +2172,7 @@ export interface Task extends BaseModel, PermissionModel {
     setup?: any;
     input: any;
     output: any;
-    error: string;
+    error?: string;
     rating: ContentRating;
     /**
      * Relationships
@@ -2004,6 +2197,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;
@@ -2050,11 +2247,12 @@ export interface TaskDTO extends BaseModel, PermissionModelDTO {
     engine?: EngineStateSummary;
     worker_id?: string;
     worker?: WorkerStateSummary;
+    run_at?: string;
     webhook?: string;
     setup?: any;
     input: any;
     output: any;
-    error: string;
+    error?: string;
     rating: ContentRating;
     events: TaskEvent[];
     logs: TaskLog[];
@@ -2092,6 +2290,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;
@@ -2100,6 +2302,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;
@@ -2208,37 +2411,6 @@ export interface Transaction extends BaseModel {
      */
     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;
@@ -2290,6 +2462,10 @@ export interface MetaItem {
      * Audio specific fields
      */
     sample_rate?: number;
+    /**
+     * Raw specific fields
+     */
+    cost?: number;
     /**
      * App-specific key-value pairs for custom pricing factors
      */
@@ -2324,6 +2500,17 @@ export interface DiscountItem {
     reason: string;
     amount: number;
 }
+/**
+ * FeeConfig controls which fees are enabled for billing.
+ * Used in CEL evaluation context (as "fees") and stored for auditing.
+ * true = fee is enabled/charged, false = fee is disabled/skipped.
+ * nil FeeConfig defaults to all fees enabled.
+ */
+export interface FeeConfig {
+    inference?: boolean;
+    royalty?: boolean;
+    partner?: boolean;
+}
 export interface UsageBillingRecord extends BaseModel, PermissionModel {
     /**
      * Fee breakdown (all in microcents)

package/dist/types.js

@@ -24,6 +24,8 @@ export const AppSessionStatusExpired = "expired";
 export const VisibilityPrivate = "private";
 export const VisibilityPublic = "public";
 export const VisibilityUnlisted = "unlisted";
+export const PaymentProviderNone = "";
+export const PaymentProviderStripe = "stripe";
 export const ChatStatusBusy = "busy";
 export const ChatStatusIdle = "idle";
 export const ChatStatusAwaitingInput = "awaiting_input";
@@ -80,6 +82,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
@@ -108,6 +111,21 @@ export const GraphEdgeTypeDependency = "dependency"; // Blocking dependency
 export const GraphEdgeTypeFlow = "flow"; // Non-blocking flow
 export const GraphEdgeTypeConditional = "conditional"; // Conditional flow
 export const GraphEdgeTypeExecution = "execution"; // Node → Resource execution link
+export const InvoiceTypeInvoice = "invoice";
+export const InvoiceTypeCreditNote = "credit_note";
+export const InvoiceStatusDraft = "draft"; // Not yet finalized, can be edited
+export const InvoiceStatusFinalized = "finalized"; // Locked, has invoice number
+export const InvoiceStatusCorrected = "corrected"; // Superseded by a credit note
+export const InvoiceStatusVoided = "voided"; // Cancelled before finalize
+export const TaxModeNone = "none"; // No VAT (US domestic, non-EU)
+export const TaxModeVAT = "vat"; // VAT charged (EU B2C)
+export const TaxModeReverseCharge = "reverse_charge"; // Reverse charge (EU B2B)
+export const PaymentRecordStatusPending = 0;
+export const PaymentRecordStatusComplete = 1;
+export const PaymentRecordStatusFailed = 2;
+export const PaymentRecordStatusExpired = 3;
+export const PaymentRecordTypeCheckout = "checkout"; // Checkout session (manual top-up)
+export const PaymentRecordTypeAutoRecharge = "auto_recharge"; // Direct charge (auto-recharge)
 export const ProjectTypeAgent = "agent";
 export const ProjectTypeApp = "app";
 export const ProjectTypeFlow = "flow";
@@ -152,7 +170,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
@@ -185,12 +203,6 @@ 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";

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.7",
+  "version": "0.5.9",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "type": "module",
   "main": "dist/index.js",