@inferencesh/sdk 0.6.1 → 0.6.3

package/dist/api/agents.d.ts

@@ -1,6 +1,6 @@
 import { HttpClient } from '../http/client';
 import { FilesAPI } from './files';
-import { ChatDTO, ChatMessageDTO, AgentConfig, AgentDTO, AgentVersionDTO, CreateAgentRequest, File, CursorListRequest, CursorListResponse } from '../types';
+import { ChatDTO, ChatMessageDTO, AgentConfig, AgentDTO, AgentVersionDTO, CreateAgentRequest, FileDTO as File, CursorListRequest, CursorListResponse } from '../types';
 /** Internal tool definition returned by getInternalTools */
 export interface InternalToolDefinition {
     id: string;

package/dist/api/apps.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from '../http/client';
-import { AppDTO as App, AppVersionDTO, CursorListRequest, CursorListResponse, LicenseRecord } from '../types';
+import { AppDTO as App, AppVersionDTO, CursorListRequest, CursorListResponse, LicenseRecordDTO } from '../types';
 /**
  * Apps API
  */
@@ -53,11 +53,11 @@ export declare class AppsAPI {
     /**
      * Get app license record
      */
-    getLicense(appId: string): Promise<LicenseRecord>;
+    getLicense(appId: string): Promise<LicenseRecordDTO>;
     /**
      * Save app license
      */
-    saveLicense(appId: string, license: string): Promise<LicenseRecord>;
+    saveLicense(appId: string, license: string): Promise<LicenseRecordDTO>;
     /**
      * Set the current (active) version of an app
      */

package/dist/api/files.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from '../http/client';
-import { File, CursorListRequest, CursorListResponse } from '../types';
+import { FileDTO as File, CursorListRequest, CursorListResponse } from '../types';
 export interface UploadFileOptions {
     filename?: string;
     contentType?: string;

package/dist/api/sessions.d.ts

@@ -2,7 +2,7 @@
  * Sessions API - namespaced session operations.
  */
 import { HttpClient } from '../http/client';
-import { AppSession } from '../types';
+import { AppSessionDTO } from '../types';
 /**
  * Sessions API for managing stateful worker leases.
  *
@@ -34,13 +34,13 @@ export declare class SessionsAPI {
      * @returns Session information
      * @throws SessionNotFoundError if session doesn't exist
      */
-    get(sessionId: string): Promise<AppSession>;
+    get(sessionId: string): Promise<AppSessionDTO>;
     /**
      * List all sessions for the current user/team.
      *
      * @returns List of session information
      */
-    list(): Promise<AppSession[]>;
+    list(): Promise<AppSessionDTO[]>;
     /**
      * Extend session expiration time.
      *
@@ -52,7 +52,7 @@ export declare class SessionsAPI {
      * @throws SessionExpiredError if session has expired
      * @throws SessionEndedError if session was ended
      */
-    keepalive(sessionId: string): Promise<AppSession>;
+    keepalive(sessionId: string): Promise<AppSessionDTO>;
     /**
      * End a session and release the worker.
      *

package/dist/http/client.js

@@ -159,7 +159,7 @@ export class HttpClient {
             }
             throw new InferenceError(response.status, errorMessage, responseText);
         }
-        return apiResponse.data;
+        return (apiResponse.data ?? null);
     }
     /**
      * Get URL and headers for NDJSON streaming.

package/dist/index.d.ts

@@ -27,7 +27,7 @@ import { ChatsAPI } from './api/chats';
 import { FlowsAPI } from './api/flows';
 import { FlowRunsAPI } from './api/flow-runs';
 import { EnginesAPI } from './api/engines';
-import { ApiAppRunRequest, TaskDTO as Task, AgentConfig, File } from './types';
+import { ApiAppRunRequest, TaskDTO as Task, AgentConfig, FileDTO as File } from './types';
 export interface InferenceConfig {
     /** Your inference.sh API key (required unless using proxyUrl) */
     apiKey?: string;

package/dist/types.d.ts

@@ -289,7 +289,7 @@ export interface Agent extends BaseModel, PermissionModel {
 /**
  * AgentDTO for API responses
  */
-export interface AgentDTO extends BaseModel, PermissionModelDTO, ProjectModelDTO {
+export interface AgentDTO extends BaseModelDTO, PermissionModelDTO, ProjectModelDTO {
     namespace: string;
     name: string;
     /**
@@ -382,7 +382,7 @@ export interface CoreAppConfigDTO {
      */
     input?: any;
 }
-export interface AgentVersionDTO extends BaseModel, PermissionModelDTO {
+export interface AgentVersionDTO extends BaseModelDTO, PermissionModelDTO {
     description: string;
     system_prompt: string;
     example_prompts: string[];
@@ -632,7 +632,15 @@ export interface CreateFlowRunRequest {
 /**
  * CreateAppRequest is the request body for POST /apps
  */
-export interface CreateAppRequest extends App {
+export interface CreateAppRequest {
+    id?: string;
+    namespace?: string;
+    name: string;
+    description?: string;
+    agent_description?: string;
+    category?: AppCategory;
+    images?: AppImages;
+    version?: AppVersion;
     /**
      * PreserveCurrentVersion prevents auto-promoting the new version to current.
      * Default false = new versions become current (what most users expect).
@@ -1106,12 +1114,12 @@ export interface AppVersion extends BaseModel {
      */
     checksum?: string;
 }
-export interface LicenseRecord extends BaseModel {
+export interface LicenseRecordDTO extends BaseModelDTO {
     user_id: string;
     app_id: string;
     license: string;
 }
-export interface AppDTO extends BaseModel, PermissionModelDTO {
+export interface AppDTO extends BaseModelDTO, PermissionModelDTO {
     namespace: string;
     name: string;
     description: string;
@@ -1121,7 +1129,7 @@ export interface AppDTO extends BaseModel, PermissionModelDTO {
     version_id: string;
     version?: AppVersionDTO;
 }
-export interface AppVersionDTO extends BaseModel {
+export interface AppVersionDTO extends BaseModelDTO {
     metadata: {
         [key: string]: any;
     };
@@ -1157,37 +1165,20 @@ export type AppSessionStatus = string;
 export declare const AppSessionStatusActive: AppSessionStatus;
 export declare const AppSessionStatusEnded: AppSessionStatus;
 export declare const AppSessionStatusExpired: AppSessionStatus;
-export interface AppSession extends BaseModel, PermissionModel {
-    /**
-     * Affinity binding
-     */
+/**
+ * AppSessionDTO is the external representation
+ */
+export interface AppSessionDTO extends BaseModelDTO, PermissionModelDTO {
     worker_id: string;
     app_id: string;
     app_version_id: string;
-    /**
-     * Lifecycle
-     */
     status: AppSessionStatus;
     expires_at: string;
     ended_at?: string;
-    /**
-     * Billing link
-     */
     task_id?: string;
-    /**
-     * Stats
-     */
     call_count: number;
     last_call_at?: string;
-    /**
-     * Custom idle timeout in seconds (nil = use default)
-     */
     idle_timeout?: number;
-    /**
-     * Relations
-     */
-    worker?: WorkerState;
-    task?: Task;
 }
 /**
  * PublicAppStoreDTO is a lean DTO for public app store display.
@@ -1213,6 +1204,17 @@ export interface BaseModel {
     updated_at: string;
     deleted_at?: string;
 }
+/**
+ * BaseModelDTO is the contract-layer base embed — same fields, no gorm tags.
+ * All DTOs should embed this instead of BaseModel.
+ */
+export interface BaseModelDTO {
+    id: string;
+    short_id: string;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string;
+}
 /**
  * Visibility represents the visibility level of a resource
  */
@@ -1370,7 +1372,7 @@ export interface ChatTaskContextMessage {
     tool_calls?: ToolCall[];
     tool_call_id?: string;
 }
-export interface ChatDTO extends BaseModel, PermissionModelDTO {
+export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
     parent_id?: string;
     parent?: ChatDTO;
     children: (ChatDTO | undefined)[];
@@ -1391,7 +1393,7 @@ export interface ChatDTO extends BaseModel, PermissionModelDTO {
     chat_messages: ChatMessageDTO[];
     agent_data: ChatData;
 }
-export interface ChatMessageDTO extends BaseModel, PermissionModelDTO {
+export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
     chat_id: string;
     chat?: ChatDTO;
     order: number;
@@ -1500,18 +1502,7 @@ 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 {
-    instance?: Instance;
-    transaction_id: string;
-    config: EngineConfig;
-    public_key: string;
-    name: string;
-    api_url: string;
-    status: EngineStatus;
-    system_info?: SystemInfo;
-    workers: (WorkerState | undefined)[];
-}
-export interface EngineStateDTO extends BaseModel, PermissionModelDTO {
+export interface EngineStateDTO extends BaseModelDTO, PermissionModelDTO {
     instance?: Instance;
     config: EngineConfig;
     name: string;
@@ -1520,7 +1511,7 @@ export interface EngineStateDTO extends BaseModel, PermissionModelDTO {
     system_info?: SystemInfo;
     workers: (WorkerStateDTO | undefined)[];
 }
-export interface EngineStateSummary extends BaseModel, PermissionModelDTO {
+export interface EngineStateSummary extends BaseModelDTO, PermissionModelDTO {
     instance?: Instance;
     name: string;
     status: EngineStatus;
@@ -1530,31 +1521,6 @@ export interface EngineStateSummary extends BaseModel, PermissionModelDTO {
  * Worker-related types
  */
 export type WorkerStatus = string;
-export interface WorkerState extends BaseModel, PermissionModel {
-    index: number;
-    status: WorkerStatus;
-    status_updated_at?: string;
-    heartbeat_at?: string;
-    engine_id: string;
-    engine?: EngineState;
-    task_id?: string;
-    app_id: string;
-    app_version_id: string;
-    /**
-     * App session lease
-     */
-    active_session_id?: string;
-    active_session?: AppSession;
-    gpus: WorkerGPU[];
-    cpus: WorkerCPU[];
-    rams: WorkerRAM[];
-    /**
-     * WarmApps tracks app+version combos with warm containers for scheduling optimization.
-     * Format: "appID:versionID@setupHash" - managed by Engine, synced via heartbeat.
-     * Not persisted to DB - this is ephemeral runtime state.
-     */
-    warm_apps?: string[];
-}
 export interface WorkerGPU {
     id: string;
     worker_id: string;
@@ -1578,7 +1544,7 @@ export interface WorkerRAM {
     worker_id: string;
     total: number;
 }
-export interface WorkerStateDTO extends BaseModel {
+export interface WorkerStateDTO extends BaseModelDTO {
     user_id: string;
     team_id: string;
     index: number;
@@ -1622,19 +1588,7 @@ export interface FileMetadata {
     channels?: number;
     codec?: string;
 }
-export interface File extends BaseModel, PermissionModel {
-    path: string;
-    remote_path: string;
-    upload_url: string;
-    uri: string;
-    content_type: string;
-    size: number;
-    filename: string;
-    category: string;
-    rating: ContentRating;
-    metadata?: FileMetadata;
-}
-export interface FileDTO extends BaseModel, PermissionModelDTO {
+export interface FileDTO extends BaseModelDTO, PermissionModelDTO {
     path: string;
     remote_path: string;
     upload_url: string;
@@ -1729,7 +1683,7 @@ export interface OutputFieldMapping {
 export type OutputMappings = {
     [key: string]: OutputFieldMapping;
 };
-export interface FlowDTO extends BaseModel, PermissionModelDTO {
+export interface FlowDTO extends BaseModelDTO, PermissionModelDTO {
     name: string;
     description: string;
     card_image: string;
@@ -1755,7 +1709,7 @@ export interface FlowDTO extends BaseModel, PermissionModelDTO {
     edges: FlowEdge[];
     viewport?: FlowViewport;
 }
-export interface FlowVersionDTO extends BaseModel {
+export interface FlowVersionDTO extends BaseModelDTO {
     graph_version: number;
     input_schema: any;
     input: FlowRunInputs;
@@ -1777,7 +1731,7 @@ export declare const FlowRunStatusRunning: FlowRunStatus;
 export declare const FlowRunStatusCompleted: FlowRunStatus;
 export declare const FlowRunStatusFailed: FlowRunStatus;
 export declare const FlowRunStatusCancelled: FlowRunStatus;
-export interface FlowRunDTO extends BaseModel, PermissionModelDTO {
+export interface FlowRunDTO extends BaseModelDTO, PermissionModelDTO {
     flow_id: string;
     flow_version_id: string;
     flow_version?: FlowVersionDTO;
@@ -1847,7 +1801,7 @@ export declare const GraphEdgeTypeDuplicate: GraphEdgeType;
 /**
  * GraphNodeDTO is the API representation of a graph node
  */
-export interface GraphNodeDTO extends BaseModel {
+export interface GraphNodeDTO extends BaseModelDTO {
     graph_id: string;
     type: GraphNodeType;
     label: string;
@@ -1863,7 +1817,7 @@ export interface GraphNodeDTO extends BaseModel {
 /**
  * GraphEdgeDTO is the API representation of a graph edge
  */
-export interface GraphEdgeDTO extends BaseModel {
+export interface GraphEdgeDTO extends BaseModelDTO {
     type: GraphEdgeType;
     from_node: string;
     to_node: string;
@@ -1890,7 +1844,7 @@ export type StringSlice = string[];
 /**
  * IntegrationDTO for API responses (never exposes tokens)
  */
-export interface IntegrationDTO extends BaseModel, PermissionModelDTO {
+export interface IntegrationDTO extends BaseModelDTO, PermissionModelDTO {
     provider: string;
     type: string;
     auth: string;
@@ -1955,7 +1909,7 @@ export type PageType = string;
 export declare const PageTypeDoc: PageType;
 export declare const PageTypeBlog: PageType;
 export declare const PageTypePage: PageType;
-export interface PageDTO extends BaseModel, PermissionModelDTO {
+export interface PageDTO extends BaseModelDTO, PermissionModelDTO {
     is_featured: boolean;
     title: string;
     content: string;
@@ -1980,7 +1934,7 @@ export interface MenuItem {
     expanded?: boolean;
     children?: MenuItem[];
 }
-export interface MenuDTO extends BaseModel, PermissionModelDTO {
+export interface MenuDTO extends BaseModelDTO, PermissionModelDTO {
     name: string;
     slug: string;
     description: string;
@@ -2024,7 +1978,7 @@ export interface Project extends BaseModel, PermissionModel {
 /**
  * ProjectDTO for API responses
  */
-export interface ProjectDTO extends BaseModel, PermissionModelDTO {
+export interface ProjectDTO extends BaseModelDTO, PermissionModelDTO {
     name: string;
     description: string;
     type: ProjectType;
@@ -2089,14 +2043,6 @@ export interface SetupAction {
     provider?: string;
     scopes?: string[];
 }
-/**
- * SecretRef tracks which Secret record provided a value for a task (for billing)
- */
-export interface SecretRef {
-    key: string;
-    id: string;
-    team_id: string;
-}
 export type InstanceCloudProvider = string;
 export declare const CloudAWS: InstanceCloudProvider;
 export declare const CloudAzure: InstanceCloudProvider;
@@ -2336,73 +2282,6 @@ export interface TaskAction {
 export interface TaskMetadata {
     action?: TaskAction;
 }
-export interface Task extends BaseModel, PermissionModel {
-    is_featured: boolean;
-    status: TaskStatus;
-    /**
-     * Foreign keys
-     */
-    app_id: string;
-    app?: App;
-    version_id: string;
-    app_version?: AppVersion;
-    /**
-     * Deprecated: Will be removed in favor of Setup
-     */
-    variant: string;
-    /**
-     * Function is the specific function to call on multi-function apps.
-     * DEPRECATED: Standardizing on explicit function name.
-     * Defaults to "run" for legacy tasks (backfilled via migration).
-     */
-    function: string;
-    infra: Infra;
-    workers: string[];
-    engine_id?: string;
-    engine?: EngineState;
-    worker_id?: string;
-    worker?: WorkerState;
-    /**
-     * Belongs to:
-     */
-    flow_run_id?: string;
-    chat_id?: string;
-    /**
-     * Owns: (Can be replaced with graph execution edge/node)
-     */
-    sub_flow_run_id?: string;
-    webhook?: string;
-    metadata?: TaskMetadata;
-    setup?: any;
-    input: any;
-    output: any;
-    error?: string;
-    rating: ContentRating;
-    /**
-     * Relationships
-     */
-    events: TaskEvent[];
-    logs: TaskLog[];
-    usage_events: (UsageEvent | undefined)[];
-    /**
-     * Secret refs for billing (tracks ownership to determine partner fee)
-     */
-    secrets?: SecretRef[];
-    /**
-     * App session reference (for session calls)
-     * Special value "new" means scheduler should create session when dispatching.
-     */
-    session_id?: string;
-    session?: AppSession;
-    /**
-     * 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;
     created_at: string;
@@ -2424,7 +2303,7 @@ export interface TaskLog {
     log_type: TaskLogType;
     content: string;
 }
-export interface TaskDTO extends BaseModel, PermissionModelDTO {
+export interface TaskDTO extends BaseModelDTO, PermissionModelDTO {
     graph_id?: string;
     user_public_key: string;
     engine_public_key: string;
@@ -2486,7 +2365,7 @@ export interface Team extends BaseModel {
     max_concurrency: number;
     status: TeamStatus;
 }
-export interface TeamDTO extends BaseModel {
+export interface TeamDTO extends BaseModelDTO {
     type: TeamType;
     name: string;
     username: string;
@@ -2533,7 +2412,7 @@ export declare const ToolInvocationStatusCancelled: ToolInvocationStatus;
 /**
  * ToolInvocationDTO for API responses
  */
-export interface ToolInvocationDTO extends BaseModel, PermissionModelDTO {
+export interface ToolInvocationDTO extends BaseModelDTO, PermissionModelDTO {
     chat_message_id: string;
     tool_invocation_id: string;
     type: ToolType;
@@ -2610,7 +2489,7 @@ export declare const RoleGuest: Role;
 export declare const RoleUser: Role;
 export declare const RoleAdmin: Role;
 export declare const RoleSystem: Role;
-export interface UserDTO extends BaseModel {
+export interface UserDTO extends BaseModelDTO {
     default_team_id: string;
     role: Role;
     email: string;

package/package.json

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