@inferencesh/sdk 0.5.1 → 0.5.3

package/dist/agent/actions.js

@@ -48,7 +48,8 @@ export function createActions(ctx) {
                     if (!handler) {
                         console.warn(`[AgentSDK] No handler for client tool: ${functionName}`);
                         api.submitToolResult(client, invocation.id, JSON.stringify({
-                            error: `No handler registered for tool: ${functionName}`
+                            status: 'not_available',
+                            message: `Client tool "${functionName}" is not available in this environment`,
                         }));
                         continue;
                     }
@@ -77,10 +78,19 @@ export function createActions(ctx) {
         setStreamManager(undefined);
         dispatch({ type: 'SET_STATUS', payload: 'connecting' });
         callbacks.onStatusChange?.('connecting');
-        // Fetch initial chat
-        const chat = await api.fetchChat(client, id);
-        if (chat) {
-            setChat(chat);
+        try {
+            // Fetch initial chat
+            const chat = await api.fetchChat(client, id);
+            if (chat) {
+                setChat(chat);
+            }
+        }
+        catch (error) {
+            console.error('[AgentSDK] Failed to fetch chat:', error);
+            dispatch({ type: 'SET_STATUS', payload: 'idle' });
+            dispatch({ type: 'SET_IS_GENERATING', payload: false });
+            callbacks.onStatusChange?.('idle');
+            return;
         }
         // Single unified stream with TypedEvents (both Chat and ChatMessage events)
         const manager = new StreamManager({
@@ -96,6 +106,17 @@ export function createActions(ctx) {
                 dispatch({ type: 'SET_STATUS', payload: 'streaming' });
                 callbacks.onStatusChange?.('streaming');
             },
+            onStop: () => {
+                // Only reset if this is an unexpected stop (stream died, max reconnects exhausted).
+                // If stopStream() was called intentionally, it clears the manager ref first,
+                // so getStreamManager() will be undefined and we skip the duplicate dispatch.
+                if (getStreamManager()) {
+                    setStreamManager(undefined);
+                    dispatch({ type: 'SET_STATUS', payload: 'idle' });
+                    dispatch({ type: 'SET_IS_GENERATING', payload: false });
+                    callbacks.onStatusChange?.('idle');
+                }
+            },
         });
         // Listen for Chat object updates (status changes)
         manager.addEventListener('chats', (chatData) => {
@@ -110,10 +131,11 @@ export function createActions(ctx) {
     };
     const stopStream = () => {
         const manager = getStreamManager();
+        // Clear ref first so onStop callback (from manager.stop) is a no-op
+        setStreamManager(undefined);
         if (manager) {
             manager.stop();
         }
-        setStreamManager(undefined);
         dispatch({ type: 'SET_STATUS', payload: 'idle' });
         dispatch({ type: 'SET_IS_GENERATING', payload: false });
         callbacks.onStatusChange?.('idle');
@@ -150,6 +172,12 @@ export function createActions(ctx) {
                         streamChat(newChatId);
                     }
                 }
+                else {
+                    // API returned no result — reset status so we don't get stuck
+                    dispatch({ type: 'SET_STATUS', payload: 'idle' });
+                    dispatch({ type: 'SET_IS_GENERATING', payload: false });
+                    callbacks.onStatusChange?.('idle');
+                }
             }
             catch (error) {
                 console.error('[AgentSDK] Failed to send message:', error);

package/dist/agent/api.js

@@ -24,6 +24,7 @@ export async function sendAdHocMessage(client, config, chatId, text, imageUris,
             system_prompt: config.system_prompt ?? '',
             tools: toolSchemas
         },
+        agent_name: config.name,
         input: {
             text,
             images: imageUris,

package/dist/agent/provider.d.ts

@@ -27,7 +27,7 @@ import type { AgentChatProviderProps } from './types';
  * }
  * ```
  */
-export declare function AgentChatProvider({ client, agentConfig, chatId, onChatCreated, onStatusChange, onError, children, }: AgentChatProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function AgentChatProvider({ client, agentConfig, chatId, clientToolHandlers: extraHandlers, onChatCreated, onStatusChange, onError, children, }: AgentChatProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace AgentChatProvider {
     var displayName: string;
 }

package/dist/agent/provider.js

@@ -9,6 +9,14 @@ import { useReducer, useRef, useEffect, useMemo } from 'react';
 import { AgentChatContext } from './context';
 import { chatReducer, initialState } from './reducer';
 import { createActions, getClientToolHandlers } from './actions';
+function mergeHandlers(base, extra) {
+    if (!extra || extra.size === 0)
+        return base;
+    const merged = new Map(base);
+    for (const [k, v] of extra)
+        merged.set(k, v);
+    return merged;
+}
 /**
  * AgentChatProvider - Provides chat state and actions to children
  *
@@ -31,20 +39,20 @@ import { createActions, getClientToolHandlers } from './actions';
  * }
  * ```
  */
-export function AgentChatProvider({ client, agentConfig, chatId, onChatCreated, onStatusChange, onError, children, }) {
+export function AgentChatProvider({ client, agentConfig, chatId, clientToolHandlers: extraHandlers, onChatCreated, onStatusChange, onError, children, }) {
     // Core state via useReducer
     const [state, dispatch] = useReducer(chatReducer, initialState);
     // Refs for mutable values that actions need access to
     const configRef = useRef(agentConfig);
     const chatIdRef = useRef(chatId ?? null);
     const streamManagerRef = useRef(undefined);
-    const clientToolHandlersRef = useRef(getClientToolHandlers(agentConfig));
+    const clientToolHandlersRef = useRef(mergeHandlers(getClientToolHandlers(agentConfig), extraHandlers));
     const callbacksRef = useRef({ onChatCreated, onStatusChange, onError });
     // Keep refs in sync with props
     useEffect(() => {
         configRef.current = agentConfig;
-        clientToolHandlersRef.current = getClientToolHandlers(agentConfig);
-    }, [agentConfig]);
+        clientToolHandlersRef.current = mergeHandlers(getClientToolHandlers(agentConfig), extraHandlers);
+    }, [agentConfig, extraHandlers]);
     useEffect(() => {
         callbacksRef.current = { onChatCreated, onStatusChange, onError };
     }, [onChatCreated, onStatusChange, onError]);

package/dist/agent/types.d.ts

@@ -134,6 +134,8 @@ export interface AgentChatProviderProps {
     agentConfig: AgentOptions;
     /** Optional existing chat ID to continue */
     chatId?: string;
+    /** Extra client tool handlers, merged with any from agentConfig. Use with TemplateAgentConfig to handle tools defined server-side. */
+    clientToolHandlers?: Map<string, ClientToolHandlerFn>;
     /** Callback when a new chat is created */
     onChatCreated?: (chatId: string) => void;
     /** Callback when chat status changes */

package/dist/api/agents.js

@@ -56,7 +56,7 @@ export class Agent {
             : {
                 chat_id: this.chatId,
                 agent_config: this.config,
-                agent_name: this.agentName,
+                agent_name: this.agentName ?? this.config.name,
                 input: { text, images: imageUris, files: fileUris, role: 'user', context: [], system_prompt: '', context_size: 0 },
             };
         // For existing chats with callbacks: Start streaming BEFORE POST so we don't miss updates

package/dist/sessions.integration.test.js

@@ -39,7 +39,6 @@ describeIfApiKey('Sessions Integration Tests', () => {
             expect(result.status).toBe(TaskStatusCompleted);
             expect(result.session_id).toBeDefined();
             expect(result.session_id).not.toBe('new');
-            expect(result.session_id).toMatch(/^sess_/);
         }, 60000);
         it('should return correct output data', async () => {
             const result = await client.run({
@@ -69,7 +68,6 @@ describeIfApiKey('Sessions Integration Tests', () => {
             });
             expect(result1.status).toBe(TaskStatusCompleted);
             const sessionId = result1.session_id;
-            expect(sessionId).toMatch(/^sess_/);
             // Retrieve value from same session
             const result2 = await client.run({
                 app: SESSION_TEST_APP,

package/dist/types.d.ts

@@ -7,6 +7,7 @@ export interface InternalToolsConfig {
     widget?: boolean;
     finish?: boolean;
     skills?: boolean;
+    host_context?: boolean;
 }
 /**
  * ToolType represents the type of tool (used in both AgentTool definition and ToolInvocation)
@@ -170,7 +171,7 @@ export interface ClientToolConfigDTO {
  */
 export interface CoreAppConfig {
     id?: string;
-    version?: string;
+    version_id?: string;
     /**
      * CoreAppRef is the user-facing ref (namespace/name@shortid) - used in ad-hoc configs, resolved at creation
      */
@@ -235,6 +236,11 @@ export interface SkillConfig {
  * Using Go embedding flattens these fields in JSON serialization.
  */
 export interface AgentConfig {
+    /**
+     * Optional name for the agent (used for adhoc agent deduplication — reuses existing agent by name).
+     * Not persisted as a DB column; only used in API requests.
+     */
+    name?: string;
     description?: string;
     system_prompt?: string;
     example_prompts?: string[];
@@ -268,7 +274,7 @@ export interface AgentVersion extends BaseModel, PermissionModel {
 }
 export interface CoreAppConfigDTO {
     id?: string;
-    version?: string;
+    version_id?: string;
     ref?: string;
     app?: AppDTO;
     /**
@@ -330,7 +336,7 @@ export interface ApiAppRunRequest {
      */
     app?: string;
     /**
-     * Alternative: specify app by ID (for internal use)
+     * Deprecated: use App ref instead. Direct ID bypasses ref routing.
      */
     app_id?: string;
     version_id?: string;
@@ -391,6 +397,16 @@ export interface ApiAgentRunRequest {
      */
     stream?: boolean;
 }
+/**
+ * EmbedAgentRunRequest is the embed variant of ApiAgentRunRequest.
+ * Only template agents are supported (no ad-hoc configs).
+ */
+export interface EmbedAgentRunRequest {
+    chat_id?: string;
+    agent: string;
+    input: ChatTaskInput;
+    stream?: boolean;
+}
 export interface CreateAgentMessageRequest {
     chat_id?: string;
     agent_id?: string;
@@ -503,6 +519,26 @@ export interface CreateAgentRequest {
  */
 export interface SDKTypes {
 }
+export interface SkillPublishRequest {
+    name: string;
+    description: string;
+    category: string;
+    repo_url: string;
+    license: string;
+    allowed_tools: string;
+    compatibility: string;
+    instructions: string;
+    files: SkillFile[];
+    metadata?: {
+        [key: string]: string;
+    };
+    /**
+     * Spec fields for roundtrip fidelity
+     */
+    disable_model_invocation: boolean;
+    user_invocable?: boolean;
+    context: string;
+}
 export interface CheckoutCreateRequest {
     amount: number;
     success_url: string;
@@ -1253,6 +1289,19 @@ export interface WorkerStateSummary {
     cpus: WorkerCPU[];
     rams: WorkerRAM[];
 }
+/**
+ * FileMetadata holds probed media metadata cached on File records.
+ */
+export interface FileMetadata {
+    type?: string;
+    width?: number;
+    height?: number;
+    duration?: number;
+    fps?: number;
+    sample_rate?: number;
+    channels?: number;
+    codec?: string;
+}
 export interface File extends BaseModel, PermissionModel {
     path: string;
     remote_path: string;
@@ -1262,6 +1311,7 @@ export interface File extends BaseModel, PermissionModel {
     size: number;
     filename: string;
     rating: ContentRating;
+    metadata?: FileMetadata;
 }
 export interface FileDTO extends BaseModel, PermissionModelDTO {
     path: string;
@@ -1272,6 +1322,7 @@ export interface FileDTO extends BaseModel, PermissionModelDTO {
     size: number;
     filename: string;
     rating: ContentRating;
+    metadata?: FileMetadata;
 }
 export interface FlowVersion extends BaseModel {
     /**
@@ -1725,6 +1776,16 @@ export interface InstanceEnvVar {
     name: string;
     value: string;
 }
+/**
+ * SkillFile represents a file in the skill directory (stored as JSONB in skill_versions)
+ */
+export interface SkillFile {
+    path: string;
+    uri?: string;
+    size: number;
+    hash: string;
+    content?: string;
+}
 /**
  * Hardware/System related types
  */
@@ -2072,6 +2133,7 @@ export interface ToolInvocationDTO extends BaseModel, PermissionModelDTO {
     chat_message_id: string;
     tool_invocation_id: string;
     type: ToolType;
+    display_name?: string;
     execution_id?: string;
     function: ToolInvocationFunction;
     status: ToolInvocationStatus;
@@ -2130,6 +2192,12 @@ export interface Transaction extends BaseModel {
     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
@@ -2152,6 +2220,7 @@ 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;
@@ -2239,6 +2308,13 @@ 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)

package/package.json

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