@inferencesh/sdk 0.4.24 → 0.4.25

package/dist/api/agents.js

@@ -189,7 +189,7 @@ export class AgentsAPI {
      * Update an agent template
      */
     async update(agentId, data) {
-        return this.http.request('put', `/agents/${agentId}`, { data });
+        return this.http.request('post', `/agents/${agentId}`, { data });
     }
     /**
      * Delete an agent template
@@ -219,7 +219,7 @@ export class AgentsAPI {
      * Update agent visibility
      */
     async updateVisibility(agentId, visibility) {
-        return this.http.request('put', `/agents/${agentId}/visibility`, { data: { visibility } });
+        return this.http.request('post', `/agents/${agentId}/visibility`, { data: { visibility } });
     }
     /**
      * Get a specific agent version

package/dist/api/apps.js

@@ -33,7 +33,7 @@ export class AppsAPI {
      * Update an app
      */
     async update(appId, data) {
-        return this.http.request('put', `/apps/${appId}`, { data });
+        return this.http.request('post', `/apps/${appId}`, { data });
     }
     /**
      * Delete an app
@@ -63,7 +63,7 @@ export class AppsAPI {
      * Update app visibility
      */
     async updateVisibility(appId, visibility) {
-        return this.http.request('put', `/apps/${appId}/visibility`, { data: { visibility } });
+        return this.http.request('post', `/apps/${appId}/visibility`, { data: { visibility } });
     }
     /**
      * Get an app by namespace and name (e.g., "inference/claude-haiku")
@@ -81,7 +81,7 @@ export class AppsAPI {
      * Save app license
      */
     async saveLicense(appId, license) {
-        return this.http.request('put', `/apps/${appId}/license`, { data: { license } });
+        return this.http.request('post', `/apps/${appId}/license`, { data: { license } });
     }
 }
 export function createAppsAPI(http) {

package/dist/api/chats.js

@@ -21,7 +21,7 @@ export class ChatsAPI {
      * Update a chat
      */
     async update(chatId, data) {
-        return this.http.request('put', `/chats/${chatId}`, { data });
+        return this.http.request('post', `/chats/${chatId}`, { data });
     }
     /**
      * Delete a chat

package/dist/api/engines.js

@@ -33,7 +33,7 @@ export class EnginesAPI {
      * Update an engine
      */
     async update(engineId, data) {
-        return this.http.request('put', `/engines/${engineId}`, { data });
+        return this.http.request('post', `/engines/${engineId}`, { data });
     }
     /**
      * Delete an engine

package/dist/api/flows.js

@@ -27,7 +27,7 @@ export class FlowsAPI {
      * Update a flow
      */
     async update(flowId, data) {
-        return this.http.request('put', `/flows/${flowId}`, { data });
+        return this.http.request('post', `/flows/${flowId}`, { data });
     }
     /**
      * Delete a flow

package/dist/api/tasks.d.ts

@@ -1,5 +1,5 @@
 import { HttpClient } from '../http/client';
-import { TaskDTO as Task, ApiAppRunRequest, CreateTaskRequest, CursorListRequest, CursorListResponse } from '../types';
+import { TaskDTO as Task, ApiAppRunRequest, CursorListRequest, CursorListResponse } from '../types';
 export interface RunOptions {
     /** Callback for real-time status updates */
     onUpdate?: (update: Task) => void;
@@ -25,21 +25,17 @@ export declare class TasksAPI {
      */
     list(params?: Partial<CursorListRequest>): Promise<CursorListResponse<Task>>;
     /**
-     * List featured tasks
+     * List featured tasks with cursor-based pagination
      */
-    listFeatured(): Promise<Task[]>;
+    listFeatured(params?: Partial<CursorListRequest>): Promise<CursorListResponse<Task>>;
     /**
      * Get a task by ID
      */
     get(taskId: string): Promise<Task>;
     /**
-     * Create a task directly
-     * Accepts either simple format { app: string; input: unknown } or full CreateTaskRequest
+     * Create and run a task
      */
-    create(data: CreateTaskRequest | {
-        app: string;
-        input: unknown;
-    }): Promise<Task>;
+    create(data: ApiAppRunRequest): Promise<Task>;
     /**
      * Delete a task
      */

package/dist/api/tasks.js

@@ -26,10 +26,10 @@ export class TasksAPI {
         return this.http.request('post', '/tasks/list', { data: params });
     }
     /**
-     * List featured tasks
+     * List featured tasks with cursor-based pagination
      */
-    async listFeatured() {
-        return this.http.request('get', '/tasks/featured');
+    async listFeatured(params) {
+        return this.http.request('get', '/tasks/featured', { params });
     }
     /**
      * Get a task by ID
@@ -38,11 +38,10 @@ export class TasksAPI {
         return this.http.request('get', `/tasks/${taskId}`);
     }
     /**
-     * Create a task directly
-     * Accepts either simple format { app: string; input: unknown } or full CreateTaskRequest
+     * Create and run a task
      */
     async create(data) {
-        return this.http.request('post', '/tasks', { data });
+        return this.http.request('post', '/apps/run', { data });
     }
     /**
      * Delete a task
@@ -128,13 +127,13 @@ export class TasksAPI {
      * Update task visibility
      */
     async updateVisibility(taskId, visibility) {
-        return this.http.request('put', `/tasks/${taskId}/visibility`, { data: { visibility } });
+        return this.http.request('post', `/tasks/${taskId}/visibility`, { data: { visibility } });
     }
     /**
      * Feature/unfeature a task
      */
     async feature(taskId, featured) {
-        return this.http.request('put', `/tasks/${taskId}/feature`, { data: { featured } });
+        return this.http.request('post', `/tasks/${taskId}/featured`, { data: { featured } });
     }
 }
 export function createTasksAPI(http) {

package/dist/client.test.js

@@ -194,11 +194,11 @@ describe('namespaced APIs', () => {
             });
             const client = new Inference({ apiKey: 'test-api-key' });
             const result = await client.tasks.create({
-                app_id: 'test-app',
+                app: 'test-org/test-app@v1',
                 input: { message: 'hello world!' },
             });
             expect(result.id).toBe('task-123');
-            expect(mockFetch).toHaveBeenCalledWith(expect.stringContaining('/tasks'), expect.objectContaining({ method: 'POST' }));
+            expect(mockFetch).toHaveBeenCalledWith(expect.stringContaining('/apps/run'), expect.objectContaining({ method: 'POST' }));
         });
         it('should get task via tasks.get()', async () => {
             const mockTask = { id: 'task-123', status: 7 };

package/dist/types.d.ts

@@ -290,7 +290,9 @@ export interface APIError {
 }
 /**
  * ApiAppRunRequest is the request body for /apps/run endpoint.
- * Version pinning is required for stability.
+ * Supports two ways to specify the app:
+ * 1. App ref (recommended): "namespace/name@shortid" in the App field
+ * 2. Direct IDs: app_id + version_id fields (for internal platform use)
  */
 export interface ApiAppRunRequest {
     /**
@@ -298,11 +300,12 @@ export interface ApiAppRunRequest {
      * Example: "okaris/flux@abc1"
      * The short ID ensures your code always runs the same version.
      */
-    app: string;
+    app?: string;
     /**
-     * Deprecated: Use namespace/name@shortid format in App field instead.
+     * Alternative: specify app by ID (for internal use)
      */
-    version?: string;
+    app_id?: string;
+    version_id?: string;
     infra?: Infra;
     workers?: string[];
     webhook?: string;
@@ -313,24 +316,6 @@ export interface ApiAppRunRequest {
      */
     stream?: boolean;
 }
-/**
- * CreateTaskRequest is the request body for creating a task via /tasks endpoint.
- * Used internally by the app.
- */
-export interface CreateTaskRequest {
-    id?: string;
-    app_id: string;
-    version_id?: string;
-    function?: string;
-    infra?: Infra;
-    workers?: string[];
-    webhook?: string;
-    setup?: unknown;
-    input: unknown;
-    flow_run_id?: string;
-    chat_id?: string;
-    graph_id?: string;
-}
 /**
  * ApiAgentRunRequest is the request body for /agents/run endpoint.
  * Supports both template agents and ad-hoc agents.
@@ -387,20 +372,6 @@ export interface CreateAgentMessageResponse {
     user_message?: ChatMessageDTO;
     assistant_message?: ChatMessageDTO;
 }
-/**
- * CreateAgentRequest is the request body for creating/updating agent templates.
- * For new agents, omit the id field. For updates, include the id.
- */
-export interface CreateAgentRequest {
-    id?: string;
-    name: string;
-    images?: AgentImages;
-    version: AgentConfig & {
-        description?: string;
-        system_prompt?: string;
-        example_prompts?: string[];
-    };
-}
 /**
  * ToolResultRequest represents a tool result submission
  * For widget actions, clients should JSON-serialize { action, form_data } as the result string
@@ -463,6 +434,27 @@ export interface CreateFlowRunRequest {
     flow: string;
     input: any;
 }
+/**
+ * CreateAgentRequest is the request body for POST /agents
+ * For new agents: omit ID, backend generates it
+ * For new version of existing agent: include ID
+ */
+export interface CreateAgentRequest {
+    /**
+     * Existing agent ID (if updating/versioning)
+     */
+    id?: string;
+    /**
+     * Agent metadata
+     */
+    name: string;
+    namespace?: string;
+    images?: AgentImages;
+    /**
+     * Version config (embedded - backend generates version ID, timestamps, etc)
+     */
+    version?: AgentConfig;
+}
 /**
  * SDKTypes is a phantom struct that references types needed by the SDK.
  * This ensures the typegen traces these types without creating aliases.
@@ -975,74 +967,6 @@ export interface ChatMessageDTO extends BaseModel, PermissionModelDTO {
     tool_call_id?: string;
     tool_invocations?: ToolInvocationDTO[];
 }
-/**
- * GraphNodeType defines the type of graph node
- */
-export type GraphNodeType = string;
-export declare const GraphNodeTypeUnknown: GraphNodeType;
-export declare const GraphNodeTypeJoin: GraphNodeType;
-export declare const GraphNodeTypeSplit: GraphNodeType;
-export declare const GraphNodeTypeExecution: GraphNodeType;
-export declare const GraphNodeTypeResource: GraphNodeType;
-export declare const GraphNodeTypeApproval: GraphNodeType;
-export declare const GraphNodeTypeConditional: GraphNodeType;
-export declare const GraphNodeTypeFlowNode: GraphNodeType;
-/**
- * GraphNodeStatus defines the status of a graph node
- */
-export type GraphNodeStatus = string;
-export declare const GraphNodeStatusPending: GraphNodeStatus;
-export declare const GraphNodeStatusReady: GraphNodeStatus;
-export declare const GraphNodeStatusRunning: GraphNodeStatus;
-export declare const GraphNodeStatusCompleted: GraphNodeStatus;
-export declare const GraphNodeStatusFailed: GraphNodeStatus;
-export declare const GraphNodeStatusCancelled: GraphNodeStatus;
-export declare const GraphNodeStatusSkipped: GraphNodeStatus;
-export declare const GraphNodeStatusBlocked: GraphNodeStatus;
-/**
- * GraphEdgeType defines the type of edge relationship
- */
-export type GraphEdgeType = string;
-export declare const GraphEdgeTypeDependency: GraphEdgeType;
-export declare const GraphEdgeTypeFlow: GraphEdgeType;
-export declare const GraphEdgeTypeConditional: GraphEdgeType;
-export declare const GraphEdgeTypeExecution: GraphEdgeType;
-/**
- * GraphNodeDTO is the API representation of a graph node
- */
-export interface GraphNodeDTO extends BaseModel {
-    graph_id: string;
-    type: GraphNodeType;
-    label: string;
-    resource_id: string;
-    resource_type: string;
-    status: GraphNodeStatus;
-    metadata?: StringEncodedMap;
-    ready_at?: string;
-    started_at?: string;
-    completed_at?: string;
-    duration_ms?: number;
-}
-/**
- * GraphEdgeDTO is the API representation of a graph edge
- */
-export interface GraphEdgeDTO extends BaseModel {
-    type: GraphEdgeType;
-    from_node: string;
-    to_node: string;
-}
-/**
- * ChatTraceDTO is the trace response for chat observability
- */
-export interface ChatTraceDTO {
-    graph_id: string;
-    nodes: (GraphNodeDTO | undefined)[];
-    edges: (GraphEdgeDTO | undefined)[];
-    total_steps: number;
-    completed_steps: number;
-    running_steps: number;
-    failed_steps: number;
-}
 export type StringEncodedMap = {
     [key: string]: any;
 };
@@ -1397,6 +1321,74 @@ export interface FlowRunInput {
     Connection?: FlowNodeConnection;
     Value: any;
 }
+export type GraphNodeType = string;
+export declare const GraphNodeTypeUnknown: GraphNodeType;
+export declare const GraphNodeTypeJoin: GraphNodeType;
+export declare const GraphNodeTypeSplit: GraphNodeType;
+export declare const GraphNodeTypeExecution: GraphNodeType;
+export declare const GraphNodeTypeResource: GraphNodeType;
+export declare const GraphNodeTypeApproval: GraphNodeType;
+export declare const GraphNodeTypeConditional: GraphNodeType;
+export declare const GraphNodeTypeFlowNode: GraphNodeType;
+/**
+ * GraphNodeStatus represents the status of a node
+ */
+export type GraphNodeStatus = string;
+export declare const GraphNodeStatusPending: GraphNodeStatus;
+export declare const GraphNodeStatusReady: GraphNodeStatus;
+export declare const GraphNodeStatusRunning: GraphNodeStatus;
+export declare const GraphNodeStatusCompleted: GraphNodeStatus;
+export declare const GraphNodeStatusFailed: GraphNodeStatus;
+export declare const GraphNodeStatusCancelled: GraphNodeStatus;
+export declare const GraphNodeStatusSkipped: GraphNodeStatus;
+export declare const GraphNodeStatusBlocked: GraphNodeStatus;
+/**
+ * GraphEdgeType defines the type of edge relationship
+ */
+export type GraphEdgeType = string;
+export declare const GraphEdgeTypeDependency: GraphEdgeType;
+export declare const GraphEdgeTypeFlow: GraphEdgeType;
+export declare const GraphEdgeTypeConditional: GraphEdgeType;
+export declare const GraphEdgeTypeExecution: GraphEdgeType;
+/**
+ * GraphNodeDTO is the API representation of a graph node
+ */
+export interface GraphNodeDTO extends BaseModel {
+    graph_id: string;
+    type: GraphNodeType;
+    label: string;
+    resource_id: string;
+    resource_type: string;
+    status: GraphNodeStatus;
+    metadata?: StringEncodedMap;
+    ready_at?: string;
+    started_at?: string;
+    completed_at?: string;
+    duration_ms?: number;
+}
+/**
+ * GraphEdgeDTO is the API representation of a graph edge
+ */
+export interface GraphEdgeDTO extends BaseModel {
+    type: GraphEdgeType;
+    from_node: string;
+    to_node: string;
+}
+/**
+ * ChatTraceDTO is the trace response for chat observability
+ */
+export interface ChatTraceDTO {
+    graph_id: string;
+    nodes: (GraphNodeDTO | undefined)[];
+    edges: (GraphEdgeDTO | undefined)[];
+    /**
+     * Summary stats
+     */
+    total_steps: number;
+    completed_steps: number;
+    running_steps: number;
+    failed_steps: number;
+}
 /**
  * StringSlice is a custom type for storing string slices in the database
  */
@@ -2296,6 +2288,10 @@ export interface WidgetNode {
     min?: string;
     max?: string;
     clearable?: boolean;
+    /**
+     * Action handler for buttons (form data is collected locally and sent with action)
+     */
+    onClickAction?: WidgetAction;
     /**
      * Content props (Icon, Spacer, Divider, Chart)
      */

package/dist/types.js

@@ -46,26 +46,6 @@ export const IntegrationTypeSlack = "slack";
 export const IntegrationTypeDiscord = "discord";
 export const IntegrationTypeTeams = "teams";
 export const IntegrationTypeTelegram = "telegram";
-export const GraphNodeTypeUnknown = "unknown";
-export const GraphNodeTypeJoin = "join";
-export const GraphNodeTypeSplit = "split";
-export const GraphNodeTypeExecution = "execution";
-export const GraphNodeTypeResource = "resource";
-export const GraphNodeTypeApproval = "approval";
-export const GraphNodeTypeConditional = "conditional";
-export const GraphNodeTypeFlowNode = "flow_node";
-export const GraphNodeStatusPending = "pending";
-export const GraphNodeStatusReady = "ready";
-export const GraphNodeStatusRunning = "running";
-export const GraphNodeStatusCompleted = "completed";
-export const GraphNodeStatusFailed = "failed";
-export const GraphNodeStatusCancelled = "cancelled";
-export const GraphNodeStatusSkipped = "skipped";
-export const GraphNodeStatusBlocked = "blocked";
-export const GraphEdgeTypeDependency = "dependency";
-export const GraphEdgeTypeFlow = "flow";
-export const GraphEdgeTypeConditional = "conditional";
-export const GraphEdgeTypeExecution = "execution";
 export const OpEqual = "eq";
 export const OpNotEqual = "neq";
 export const OpIn = "in";
@@ -105,6 +85,26 @@ export const FlowRunStatusRunning = 2; // 2
 export const FlowRunStatusCompleted = 3; // 3
 export const FlowRunStatusFailed = 4; // 4
 export const FlowRunStatusCancelled = 5; // 5
+export const GraphNodeTypeUnknown = "unknown";
+export const GraphNodeTypeJoin = "join";
+export const GraphNodeTypeSplit = "split";
+export const GraphNodeTypeExecution = "execution";
+export const GraphNodeTypeResource = "resource";
+export const GraphNodeTypeApproval = "approval";
+export const GraphNodeTypeConditional = "conditional";
+export const GraphNodeTypeFlowNode = "flow_node"; // Flow execution node
+export const GraphNodeStatusPending = "pending";
+export const GraphNodeStatusReady = "ready"; // Dependencies satisfied
+export const GraphNodeStatusRunning = "running";
+export const GraphNodeStatusCompleted = "completed";
+export const GraphNodeStatusFailed = "failed";
+export const GraphNodeStatusCancelled = "cancelled";
+export const GraphNodeStatusSkipped = "skipped"; // Conditional branch not taken
+export const GraphNodeStatusBlocked = "blocked"; // Dependency failed
+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 ProjectTypeAgent = "agent";
 export const ProjectTypeApp = "app";
 export const ProjectTypeFlow = "flow";

package/package.json

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