@inferencesh/sdk 0.6.0 → 0.6.2

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/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

@@ -114,6 +114,11 @@ export interface ToolAuthConfig {
      */
     header?: string;
 }
+/**
+ * CallToolConfig is the preferred name for HTTPToolConfig.
+ * "call" is the user-facing type; "http" is kept for backward compatibility.
+ */
+export type CallToolConfig = HTTPToolConfig;
 /**
  * HTTPToolConfig contains configuration for an authenticated HTTP tool
  */
@@ -159,6 +164,7 @@ export interface AgentTool {
     agent?: AgentToolConfig;
     hook?: HookToolConfig;
     http?: HTTPToolConfig;
+    call?: CallToolConfig;
     mcp?: MCPToolConfig;
     client?: ClientToolConfig;
     internal?: InternalToolConfig;
@@ -186,6 +192,7 @@ export interface AgentToolDTO {
     agent?: AgentToolConfigDTO;
     hook?: HookToolConfigDTO;
     http?: HTTPToolConfigDTO;
+    call?: HTTPToolConfigDTO;
     mcp?: MCPToolConfigDTO;
     client?: ClientToolConfigDTO;
 }
@@ -282,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;
     /**
@@ -303,6 +310,17 @@ export interface SkillConfig {
     version_id?: string;
     url?: string;
     content?: string;
+    preload?: boolean;
+}
+/**
+ * ContextField declares a context parameter expected by the agent.
+ * Context is caller-provided at chat creation, stored on Chat, and available in tool URL templates.
+ */
+export interface ContextField {
+    name: string;
+    description?: string;
+    required?: boolean;
+    default?: string;
 }
 /**
  * AgentConfig contains the shared configuration fields for agent execution.
@@ -330,6 +348,10 @@ export interface AgentConfig {
      * Skills available to this agent (loaded on-demand via skill_get tool)
      */
     skills?: SkillConfig[];
+    /**
+     * Context declares expected context parameters (resolved in tool URL templates via {{context.X}})
+     */
+    context?: ContextField[];
     /**
      * Internal tools configuration (plan, memory, widget, finish, skills)
      */
@@ -360,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[];
@@ -373,6 +395,10 @@ export interface AgentVersionDTO extends BaseModel, PermissionModelDTO {
      * Skills available to this agent (loaded on-demand via skill_get tool)
      */
     skills: SkillConfig[];
+    /**
+     * Context declarations
+     */
+    context?: ContextField[];
     /**
      * Internal tools configuration (plan, memory, widget, finish, skills)
      */
@@ -484,6 +510,12 @@ export interface ApiAgentRunRequest {
      * The message to send
      */
     input: ChatTaskInput;
+    /**
+     * Context values for this chat session (used in tool URL templates)
+     */
+    context?: {
+        [key: string]: string;
+    };
     /**
      * If true, returns SSE stream instead of JSON response
      */
@@ -516,6 +548,12 @@ export interface CreateAgentMessageRequest {
      * Optional name for the adhoc agent (used for deduplication and display)
      */
     agent_name?: string;
+    /**
+     * Context values for this chat session (used in tool URL templates)
+     */
+    context?: {
+        [key: string]: string;
+    };
 }
 export interface CreateAgentMessageResponse {
     user_message?: ChatMessageDTO;
@@ -594,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).
@@ -967,7 +1013,7 @@ export interface App extends BaseModel, PermissionModel {
 }
 /**
  * AppPricing configures all pricing using CEL expressions
- * Empty expressions use defaults. All values in nanocents (1 cent = 1,000,000,000)
+ * Empty expressions use defaults. All values in microcents (1 cent = 1,000,000; 1 dollar = 100,000,000)
  */
 export interface AppPricing {
     prices: {
@@ -981,7 +1027,7 @@ export interface AppPricing {
      */
     resource_expression: string;
     /**
-     * CEL expressions for each fee type (result in nanocents)
+     * CEL expressions for each fee type (result in microcents)
      * Available variables: inputs, outputs, prices, resource_fee, usage_seconds
      */
     inference_expression: string;
@@ -1068,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;
@@ -1083,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;
     };
@@ -1119,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.
@@ -1175,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
  */
@@ -1332,12 +1372,15 @@ 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)[];
     status: ChatStatus;
     output?: any;
+    context?: {
+        [key: string]: string;
+    };
     /**
      * Agent version reference
      */
@@ -1350,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;
@@ -1459,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;
@@ -1479,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;
@@ -1489,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;
@@ -1537,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;
@@ -1581,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;
@@ -1688,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;
@@ -1714,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;
@@ -1736,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;
@@ -1806,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;
@@ -1822,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;
@@ -1849,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;
@@ -1914,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;
@@ -1939,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;
@@ -1983,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;
@@ -2048,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;
@@ -2295,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;
@@ -2383,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;
@@ -2445,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;
@@ -2492,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;
@@ -2569,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/dist/types.js

@@ -3,7 +3,7 @@ export const ToolTypeApp = "app"; // App tools - creates a Task
 export const ToolTypeAgent = "agent"; // Sub-agent tools - creates a sub-Chat
 export const ToolTypeHook = "hook"; // Webhook tools - HTTP POST to external URL (legacy)
 export const ToolTypeHTTP = "http"; // HTTP tools - authenticated HTTP request/response
-export const ToolTypeCall = "call"; // Call tools - alias for HTTP (preferred name)
+export const ToolTypeCall = "call"; // Call tools - authenticated HTTP request/response (preferred over "http")
 export const ToolTypeMCP = "mcp"; // MCP tools - calls remote MCP server
 export const ToolTypeClient = "client"; // Client tools - executed by frontend
 export const ToolTypeInternal = "internal"; // Internal/built-in tools (plan, memory, widget, finish)

package/package.json

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