@inferencesh/sdk 0.4.4 → 0.4.8

package/dist/types.d.ts

@@ -144,6 +144,14 @@ export interface CoreAppConfig {
     id: string;
     version_id: string;
 }
+/**
+ * AgentImages contains display images for an agent (like AppImages)
+ */
+export interface AgentImages {
+    card: string;
+    thumbnail: string;
+    banner: string;
+}
 export interface Agent {
     BaseModel: BaseModel;
     PermissionModel: PermissionModel;
@@ -153,6 +161,10 @@ export interface Agent {
      */
     namespace: string;
     name: string;
+    /**
+     * Display images (like App)
+     */
+    images: AgentImages;
     version_id: string;
     version?: AgentVersion;
 }
@@ -162,22 +174,33 @@ export interface Agent {
 export interface AgentDTO extends BaseModel, PermissionModelDTO, ProjectModelDTO {
     namespace: string;
     name: string;
+    /**
+     * Display images (like AppDTO)
+     */
+    images: AgentImages;
     version_id: string;
     version?: AgentVersionDTO;
 }
-export interface AgentVersion {
-    BaseModel: BaseModel;
-    PermissionModel: PermissionModel;
-    agent_id: string;
-    description: string;
-    system_prompt: string;
-    example_prompts: string[];
+/**
+ * AgentConfig contains the shared configuration fields for agent execution.
+ * This is embedded by both AgentVersion (DB model) and API request structs.
+ * Using Go embedding flattens these fields in JSON serialization.
+ */
+export interface AgentConfig {
+    description?: string;
+    system_prompt?: string;
+    example_prompts?: string[];
+    /**
+     * Core LLM configuration
+     * CoreAppRef is the user-facing ref (namespace/name@shortid) - used in ad-hoc configs, resolved at creation
+     */
+    core_app_ref?: string;
     core_app?: CoreAppConfig;
     core_app_input?: any;
     /**
-     * Unified tools array (apps, agents, hooks)
+     * Tools (apps, agents, hooks, client tools)
      */
-    tools: (AgentTool | undefined)[];
+    tools?: (AgentTool | undefined)[];
     /**
      * Internal tools configuration (plan, memory, widget, finish)
      */
@@ -187,6 +210,19 @@ export interface AgentVersion {
      */
     output_schema?: any;
 }
+export interface AgentVersion {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    agent_id: string;
+    /**
+     * Short ID for human-readable version references (e.g., "abc123")
+     */
+    short_id: string;
+    /**
+     * ConfigHash for deduplication - SHA256 of config content
+     */
+    config_hash: string;
+}
 export interface CoreAppConfigDTO {
     id: string;
     version_id: string;
@@ -211,67 +247,6 @@ export interface AgentVersionDTO extends BaseModel, PermissionModelDTO {
      */
     output_schema?: any;
 }
-/**
- * AgentRuntimeConfig is a self-contained, flattened config for chat execution.
- * This is either snapshotted from an Agent template or provided ad-hoc.
- * It's portable and can be serialized to JSON or YAML.
- */
-export interface AgentRuntimeConfig {
-    /**
-     * Origin tracking (optional, for lineage when snapshotted from template)
-     */
-    agent_id?: string;
-    agent_version_id?: string;
-    /**
-     * Identity
-     */
-    name: string;
-    namespace?: string;
-    description?: string;
-    /**
-     * Prompts
-     */
-    system_prompt: string;
-    example_prompts?: string[];
-    /**
-     * Core LLM
-     * CoreAppRef is the user-facing ref (namespace/name@shortid) - used in ad-hoc configs
-     * CoreApp is the resolved config - populated by backend after resolving CoreAppRef
-     */
-    core_app_ref?: string;
-    core_app?: CoreAppConfig;
-    core_app_input?: any;
-    /**
-     * Tools (apps, agents, hooks, client tools)
-     */
-    tools?: (AgentTool | undefined)[];
-    /**
-     * Internal tools configuration (plan, memory, widget, finish)
-     */
-    internal_tools?: InternalToolsConfig;
-    /**
-     * Output schema for custom finish tool (sub-agents only)
-     */
-    output_schema?: any;
-}
-/**
- * AgentRuntimeConfigDTO for API responses
- */
-export interface AgentRuntimeConfigDTO {
-    agent_id?: string;
-    agent_version_id?: string;
-    name: string;
-    namespace?: string;
-    description?: string;
-    system_prompt: string;
-    example_prompts?: string[];
-    core_app_ref?: string;
-    core_app?: CoreAppConfigDTO;
-    core_app_input?: any;
-    tools?: (AgentToolDTO | undefined)[];
-    internal_tools?: InternalToolsConfig;
-    output_schema?: any;
-}
 export interface APIRequest<T extends any> {
     timestamp: string;
     data: T;
@@ -331,7 +306,11 @@ export interface ApiAgentRunRequest {
      * For ad-hoc agents, set core_app_ref to the LLM app reference
      * Example: { "core_app_ref": "infsh/claude-sonnet-4@abc123", "system_prompt": "..." }
      */
-    agent_config?: AgentRuntimeConfig;
+    agent_config?: AgentConfig;
+    /**
+     * Optional name for the adhoc agent (used for deduplication and display)
+     */
+    agent_name?: string;
     /**
      * The message to send
      */
@@ -353,7 +332,11 @@ export interface CreateAgentMessageRequest {
      * Ad-hoc agent config - use this instead of Agent for embedded configs
      * If provided, creates a chat with this config directly (no agent reference)
      */
-    agent_config?: AgentRuntimeConfig;
+    agent_config?: AgentConfig;
+    /**
+     * Optional name for the adhoc agent (used for deduplication and display)
+     */
+    agent_name?: string;
 }
 export interface CreateAgentMessageResponse {
     user_message?: ChatMessageDTO;
@@ -671,8 +654,8 @@ export interface AppVersion {
         [key: string]: any;
     };
     repository: string;
-    flow_id?: string;
-    flow?: Flow;
+    flow_version_id?: string;
+    flow_version?: FlowVersion;
     setup_schema: any;
     input_schema: any;
     output_schema: any;
@@ -715,7 +698,8 @@ export interface AppVersionDTO extends BaseModel {
         [key: string]: any;
     };
     repository: string;
-    flow?: FlowDTO;
+    flow_version_id?: string;
+    flow_version?: FlowVersionDTO;
     setup_schema: any;
     input_schema: any;
     output_schema: any;
@@ -882,7 +866,13 @@ export interface ChatDTO extends BaseModel, PermissionModelDTO {
     parent?: ChatDTO;
     children: (ChatDTO | undefined)[];
     status: ChatStatus;
-    agent_config?: AgentRuntimeConfigDTO;
+    /**
+     * Agent version reference
+     */
+    agent_id?: string;
+    agent?: AgentDTO;
+    agent_version_id?: string;
+    agent_version?: AgentVersionDTO;
     name: string;
     description: string;
     chat_messages: ChatMessageDTO[];
@@ -988,14 +978,28 @@ export interface FileDTO extends BaseModel, PermissionModelDTO {
     filename: string;
     rating: ContentRating;
 }
-export interface Flow {
+export interface FlowVersion {
     BaseModel: BaseModel;
-    PermissionModel: PermissionModel;
-    name: string;
-    description: string;
-    card_image: string;
-    thumbnail: string;
-    banner_image: string;
+    /**
+     * Permission fields - nullable for migration from existing data
+     * After migration these will be populated from parent Flow
+     */
+    user_id: string;
+    user?: User;
+    team_id: string;
+    team?: Team;
+    flow_id: string;
+    /**
+     * Short ID for human-readable version references (e.g., "abc123")
+     */
+    short_id: string;
+    /**
+     * ConfigHash for deduplication - SHA256 of config content
+     */
+    config_hash: string;
+    /**
+     * Flow graph configuration
+     */
     input_schema: any;
     input: FlowRunInputs;
     output_schema: any;
@@ -1058,12 +1062,8 @@ export interface OutputFieldMapping {
 export type OutputMappings = {
     [key: string]: OutputFieldMapping;
 };
-export interface FlowDTO extends BaseModel, PermissionModelDTO {
-    name: string;
-    description: string;
-    card_image: string;
-    thumbnail: string;
-    banner_image: string;
+export interface FlowVersionDTO extends BaseModel {
+    short_id: string;
     input_schema: any;
     input: FlowRunInputs;
     output_schema: any;
@@ -1423,10 +1423,9 @@ export interface TaskDTO extends BaseModel, PermissionModelDTO {
     function: string;
     infra: Infra;
     workers: string[];
-    flow_id?: string;
     flow_run_id?: string;
-    sub_flow_run_id?: string;
     chat_id?: string;
+    sub_flow_run_id?: string;
     agent_id?: string;
     agent_version_id?: string;
     agent?: AgentDTO;
@@ -1704,6 +1703,7 @@ export interface UsageBillingRecord {
      * Fee breakdown (all in microcents)
      */
     total: number;
+    discount: number;
     /**
      * User debit (total charged)
      */
@@ -1843,7 +1843,32 @@ export declare const WidgetNodeTypeCheckbox: WidgetNodeType;
 export declare const WidgetNodeTypeRow: WidgetNodeType;
 export declare const WidgetNodeTypeCol: WidgetNodeType;
 /**
- * Data-bound node types (read from ToolInvocation.Data via DataKey)
+ * Layout node types
+ */
+export declare const WidgetNodeTypeBox: WidgetNodeType;
+export declare const WidgetNodeTypeSpacer: WidgetNodeType;
+export declare const WidgetNodeTypeDivider: WidgetNodeType;
+export declare const WidgetNodeTypeForm: WidgetNodeType;
+/**
+ * Typography node types
+ */
+export declare const WidgetNodeTypeTitle: WidgetNodeType;
+export declare const WidgetNodeTypeCaption: WidgetNodeType;
+export declare const WidgetNodeTypeLabel: WidgetNodeType;
+/**
+ * Control node types
+ */
+export declare const WidgetNodeTypeTextarea: WidgetNodeType;
+export declare const WidgetNodeTypeRadioGroup: WidgetNodeType;
+export declare const WidgetNodeTypeDatePicker: WidgetNodeType;
+/**
+ * Content node types
+ */
+export declare const WidgetNodeTypeIcon: WidgetNodeType;
+export declare const WidgetNodeTypeChart: WidgetNodeType;
+export declare const WidgetNodeTypeTransition: WidgetNodeType;
+/**
+ * Data-bound node types (deprecated - use templates instead)
  */
 export declare const WidgetNodeTypePlanList: WidgetNodeType;
 export declare const WidgetNodeTypeKeyValue: WidgetNodeType;
@@ -1867,8 +1892,60 @@ export interface WidgetNode {
     children?: WidgetNode[];
     gap?: number;
     /**
-     * Data binding - for data-bound node types, specifies which key in ToolInvocation.Data to read
-     * Empty string means read entire Data object (useful for key-value display)
+     * Layout props (Box, Row, Col, Form)
+     */
+    align?: string;
+    justify?: string;
+    padding?: any;
+    background?: any;
+    radius?: string;
+    direction?: string;
+    wrap?: string;
+    flex?: any;
+    /**
+     * Typography props (Text, Title, Caption, Label)
+     */
+    size?: string;
+    weight?: string;
+    color?: any;
+    textAlign?: string;
+    truncate?: boolean;
+    maxLines?: number;
+    /**
+     * Control props (Input, Textarea, Select, Checkbox, RadioGroup, DatePicker, Button)
+     */
+    disabled?: boolean;
+    required?: boolean;
+    rows?: number;
+    fieldName?: string;
+    submit?: boolean;
+    pattern?: string;
+    min?: string;
+    max?: string;
+    clearable?: boolean;
+    /**
+     * Content props (Icon, Spacer, Divider, Chart)
+     */
+    iconName?: string;
+    spacing?: any;
+    minSize?: any;
+    height?: any;
+    width?: any;
+    /**
+     * Chart specific props
+     */
+    chartData?: any;
+    chartSeries?: any;
+    xAxis?: any;
+    showYAxis?: boolean;
+    showLegend?: boolean;
+    showTooltip?: boolean;
+    /**
+     * Form-specific props
+     */
+    onSubmitAction?: WidgetAction;
+    /**
+     * Data binding (deprecated - use templates instead)
      */
     dataKey?: string;
 }

package/dist/types.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeviceAuthStatusExpired = exports.DeviceAuthStatusApproved = exports.DeviceAuthStatusPending = exports.IntegrationTypeTelegram = exports.IntegrationTypeTeams = exports.IntegrationTypeDiscord = exports.IntegrationTypeSlack = exports.ChatMessageContentTypeTool = exports.ChatMessageContentTypeFile = exports.ChatMessageContentTypeImage = exports.ChatMessageContentTypeReasoning = exports.ChatMessageContentTypeText = exports.ChatMessageStatusCancelled = exports.ChatMessageStatusFailed = exports.ChatMessageStatusReady = exports.ChatMessageStatusPending = exports.ChatMessageRoleTool = exports.ChatMessageRoleAssistant = exports.ChatMessageRoleUser = exports.ChatMessageRoleSystem = exports.PlanStepStatusCancelled = exports.PlanStepStatusCompleted = exports.PlanStepStatusInProgress = exports.PlanStepStatusPending = exports.ChatStatusCompleted = exports.ChatStatusAwaitingInput = exports.ChatStatusIdle = exports.ChatStatusBusy = exports.VisibilityUnlisted = exports.VisibilityPublic = exports.VisibilityPrivate = exports.GPUTypeApple = exports.GPUTypeAMD = exports.GPUTypeNvidia = exports.GPUTypeIntel = exports.GPUTypeNone = exports.GPUTypeAny = exports.AppCategoryFlow = exports.AppCategoryOther = exports.AppCategory3D = exports.AppCategoryChat = exports.AppCategoryText = exports.AppCategoryAudio = exports.AppCategoryVideo = exports.AppCategoryImage = exports.ToolTypeInternal = exports.ToolTypeClient = exports.ToolTypeHook = exports.ToolTypeAgent = exports.ToolTypeApp = void 0;
 exports.TaskStatusCancelled = exports.TaskStatusFailed = exports.TaskStatusCompleted = exports.TaskStatusUploading = exports.TaskStatusCancelling = exports.TaskStatusRunning = exports.TaskStatusSettingUp = exports.TaskStatusServing = exports.TaskStatusPreparing = exports.TaskStatusScheduled = exports.TaskStatusQueued = exports.TaskStatusReceived = exports.TaskStatusUnknown = exports.InstanceStatusDeleted = exports.InstanceStatusActive = exports.InstanceStatusPending = exports.CloudShade = exports.CloudVultr = exports.CloudMassedCompute = exports.CloudDatacrunch = exports.CloudPaperspace = exports.CloudOblivus = exports.CloudJarvisLabs = exports.CloudLatitude = exports.CloudRunPod = exports.CloudTensorDock = exports.CloudLambdaLabs = exports.CloudAzure = exports.CloudAWS = exports.ContentUnrated = exports.ContentSelfHarm = exports.ContentDrugs = exports.ContentGore = exports.ContentViolenceGraphic = exports.ContentViolenceNonGraphic = exports.ContentSexualExplicit = exports.ContentSexualSuggestive = exports.ContentSafe = exports.ProjectTypeOther = exports.ProjectTypeFlow = exports.ProjectTypeApp = exports.ProjectTypeAgent = exports.EngineStatusStopped = exports.EngineStatusStopping = exports.EngineStatusPending = exports.EngineStatusRunning = exports.DeviceAuthStatusLoading = exports.DeviceAuthStatusInvalid = exports.DeviceAuthStatusValid = exports.DeviceAuthStatusDenied = void 0;
 exports.WidgetNodeTypeButton = exports.WidgetNodeTypeBadge = exports.WidgetNodeTypeImage = exports.WidgetNodeTypeMarkdown = exports.WidgetNodeTypeText = exports.RoleSystem = exports.RoleAdmin = exports.RoleUser = exports.RoleGuest = exports.VideoRes4K = exports.VideoRes1440P = exports.VideoRes1080P = exports.VideoRes720P = exports.VideoRes480P = exports.MetaItemTypeRaw = exports.MetaItemTypeAudio = exports.MetaItemTypeVideo = exports.MetaItemTypeImage = exports.MetaItemTypeText = exports.UsageEventResourceTierCloud = exports.UsageEventResourceTierPrivate = exports.PaymentRecordTypeAutoRecharge = exports.PaymentRecordTypeCheckout = exports.PaymentRecordStatusExpired = exports.PaymentRecordStatusFailed = exports.PaymentRecordStatusComplete = exports.PaymentRecordStatusPending = exports.TransactionTypeDebit = exports.TransactionTypeCredit = exports.ToolInvocationStatusCancelled = exports.ToolInvocationStatusFailed = exports.ToolInvocationStatusCompleted = exports.ToolInvocationStatusAwaitingApproval = exports.ToolInvocationStatusAwaitingInput = exports.ToolInvocationStatusInProgress = exports.ToolInvocationStatusPending = exports.TeamRoleMember = exports.TeamRoleAdmin = exports.TeamRoleOwner = exports.TeamTypeSystem = exports.TeamTypeTeam = exports.TeamTypePersonal = exports.TaskLogTypeTask = exports.TaskLogTypeSetup = exports.TaskLogTypeServe = exports.TaskLogTypeRun = exports.TaskLogTypeBuild = exports.InfraPrivateFirst = exports.InfraCloud = exports.InfraPrivate = void 0;
-exports.WidgetNodeTypeStatusBadge = exports.WidgetNodeTypeKeyValue = exports.WidgetNodeTypePlanList = exports.WidgetNodeTypeCol = exports.WidgetNodeTypeRow = exports.WidgetNodeTypeCheckbox = exports.WidgetNodeTypeSelect = exports.WidgetNodeTypeInput = void 0;
+exports.WidgetNodeTypeStatusBadge = exports.WidgetNodeTypeKeyValue = exports.WidgetNodeTypePlanList = exports.WidgetNodeTypeTransition = exports.WidgetNodeTypeChart = exports.WidgetNodeTypeIcon = exports.WidgetNodeTypeDatePicker = exports.WidgetNodeTypeRadioGroup = exports.WidgetNodeTypeTextarea = exports.WidgetNodeTypeLabel = exports.WidgetNodeTypeCaption = exports.WidgetNodeTypeTitle = exports.WidgetNodeTypeForm = exports.WidgetNodeTypeDivider = exports.WidgetNodeTypeSpacer = exports.WidgetNodeTypeBox = exports.WidgetNodeTypeCol = exports.WidgetNodeTypeRow = exports.WidgetNodeTypeCheckbox = exports.WidgetNodeTypeSelect = exports.WidgetNodeTypeInput = void 0;
 exports.ToolTypeApp = "app"; // App tools - creates a Task
 exports.ToolTypeAgent = "agent"; // Sub-agent tools - creates a sub-Chat
 exports.ToolTypeHook = "hook"; // Webhook tools - HTTP POST to external URL
@@ -176,8 +176,33 @@ exports.WidgetNodeTypeCheckbox = "checkbox";
 exports.WidgetNodeTypeRow = "row";
 exports.WidgetNodeTypeCol = "col";
 /**
- * Data-bound node types (read from ToolInvocation.Data via DataKey)
+ * Layout node types
  */
-exports.WidgetNodeTypePlanList = "plan-list"; // Renders plan steps from Data
-exports.WidgetNodeTypeKeyValue = "key-value"; // Renders key-value pairs from Data
-exports.WidgetNodeTypeStatusBadge = "status-badge"; // Renders status badge from Data
+exports.WidgetNodeTypeBox = "box";
+exports.WidgetNodeTypeSpacer = "spacer";
+exports.WidgetNodeTypeDivider = "divider";
+exports.WidgetNodeTypeForm = "form";
+/**
+ * Typography node types
+ */
+exports.WidgetNodeTypeTitle = "title";
+exports.WidgetNodeTypeCaption = "caption";
+exports.WidgetNodeTypeLabel = "label";
+/**
+ * Control node types
+ */
+exports.WidgetNodeTypeTextarea = "textarea";
+exports.WidgetNodeTypeRadioGroup = "radio-group";
+exports.WidgetNodeTypeDatePicker = "date-picker";
+/**
+ * Content node types
+ */
+exports.WidgetNodeTypeIcon = "icon";
+exports.WidgetNodeTypeChart = "chart";
+exports.WidgetNodeTypeTransition = "transition";
+/**
+ * Data-bound node types (deprecated - use templates instead)
+ */
+exports.WidgetNodeTypePlanList = "plan-list";
+exports.WidgetNodeTypeKeyValue = "key-value";
+exports.WidgetNodeTypeStatusBadge = "status-badge";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inferencesh/sdk",
-  "version": "0.4.4",
+  "version": "0.4.8",
   "description": "Official JavaScript/TypeScript SDK for inference.sh - Run AI models with a simple API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -10,11 +10,41 @@
       "import": "./dist/index.mjs",
       "require": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./proxy": {
+      "import": "./dist/proxy/index.mjs",
+      "require": "./dist/proxy/index.js",
+      "types": "./dist/proxy/index.d.ts"
+    },
+    "./proxy/nextjs": {
+      "import": "./dist/proxy/nextjs.mjs",
+      "require": "./dist/proxy/nextjs.js",
+      "types": "./dist/proxy/nextjs.d.ts"
+    },
+    "./proxy/express": {
+      "import": "./dist/proxy/express.mjs",
+      "require": "./dist/proxy/express.js",
+      "types": "./dist/proxy/express.d.ts"
+    },
+    "./proxy/hono": {
+      "import": "./dist/proxy/hono.mjs",
+      "require": "./dist/proxy/hono.js",
+      "types": "./dist/proxy/hono.d.ts"
+    },
+    "./proxy/remix": {
+      "import": "./dist/proxy/remix.mjs",
+      "require": "./dist/proxy/remix.js",
+      "types": "./dist/proxy/remix.d.ts"
+    },
+    "./proxy/svelte": {
+      "import": "./dist/proxy/svelte.mjs",
+      "require": "./dist/proxy/svelte.js",
+      "types": "./dist/proxy/svelte.d.ts"
     }
   },
   "scripts": {
     "build": "tsc && npm run build:esm",
-    "build:esm": "echo 'export * from \"./index.js\";' > dist/index.mjs",
+    "build:esm": "echo 'export * from \"./index.js\";' > dist/index.mjs && mkdir -p dist/proxy && for f in dist/proxy/*.js; do echo \"export * from \\\"./$(basename $f)\\\";\" > \"${f%.js}.mjs\"; done",
     "test": "jest --testPathIgnorePatterns=integration",
     "test:integration": "jest --testPathPattern=integration --testTimeout=120000 --runInBand",
     "test:all": "jest --testTimeout=120000 --runInBand",
@@ -39,7 +69,10 @@
     "typescript",
     "image-generation",
     "llm",
-    "generative-ai"
+    "generative-ai",
+    "proxy",
+    "nextjs",
+    "express"
   ],
   "author": "Okaris <hello@inference.sh>",
   "license": "MIT",
@@ -58,18 +91,42 @@
     "eventsource": "^4.0.0"
   },
   "devDependencies": {
+    "@sveltejs/kit": "^2.0.0",
+    "@types/express": "^5.0.0",
     "@types/jest": "^29.5.12",
     "@types/node": "^24.1.0",
     "@typescript-eslint/eslint-plugin": "^8.38.0",
     "@typescript-eslint/parser": "^8.38.0",
     "eslint": "^9.32.0",
     "eslint-config-prettier": "^10.1.8",
+    "hono": "^4.0.0",
     "jest": "^29.7.0",
+    "next": "^15.0.0",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
     "ts-jest": "^29.2.5",
     "typescript": "^5.8.3"
   },
+  "peerDependencies": {
+    "@sveltejs/kit": ">=2.0.0",
+    "express": ">=4.0.0",
+    "hono": ">=4.0.0",
+    "next": ">=13.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
+    "hono": {
+      "optional": true
+    },
+    "@sveltejs/kit": {
+      "optional": true
+    }
+  },
   "files": [
     "dist",
     "README.md",

package/dist/agent.d.ts

@@ -1,78 +0,0 @@
-/**
- * Headless Agent SDK
- *
- * Chat with AI agents without UI dependencies.
- */
-import { ChatDTO, ChatMessageDTO, AgentRuntimeConfig } from './types';
-export interface AgentConfig {
-    apiKey: string;
-    baseUrl?: string;
-}
-/**
- * Ad-hoc agent configuration - extends AgentRuntimeConfig with core_app_ref required
- * Uses Partial to make name/system_prompt optional for ad-hoc usage
- */
-export type AdHocAgentOptions = Partial<AgentRuntimeConfig> & {
-    /** Core LLM app ref: namespace/name@shortid (required for ad-hoc agents) */
-    core_app_ref: string;
-};
-/** Template agent configuration */
-export interface TemplateAgentOptions {
-    /** Agent reference: namespace/name@version (e.g., "my-org/assistant@abc123") */
-    agent: string;
-}
-export type AgentOptions = AdHocAgentOptions | TemplateAgentOptions;
-export interface SendMessageOptions {
-    /** File attachments (Blob or base64 data URI) */
-    files?: (Blob | string)[];
-    /** Callback for message updates */
-    onMessage?: (message: ChatMessageDTO) => void;
-    /** Callback for chat updates */
-    onChat?: (chat: ChatDTO) => void;
-    /** Callback when a client tool needs execution */
-    onToolCall?: (invocation: {
-        id: string;
-        name: string;
-        args: Record<string, unknown>;
-    }) => void;
-}
-export declare class Agent {
-    private readonly apiKey;
-    private readonly baseUrl;
-    private readonly options;
-    private chatId;
-    private stream;
-    constructor(config: AgentConfig, options: AgentOptions);
-    /** Get current chat ID */
-    get currentChatId(): string | null;
-    /** Send a message to the agent */
-    sendMessage(text: string, options?: SendMessageOptions): Promise<ChatMessageDTO>;
-    /** Get chat by ID */
-    getChat(chatId?: string): Promise<ChatDTO | null>;
-    /** Stop the current chat generation */
-    stopChat(): Promise<void>;
-    /**
-     * Submit a tool result
-     * @param toolInvocationId - The tool invocation ID
-     * @param resultOrAction - Either a raw result string, or an object with action and optional form_data (will be JSON-serialized)
-     */
-    submitToolResult(toolInvocationId: string, resultOrAction: string | {
-        action: {
-            type: string;
-            payload?: Record<string, unknown>;
-        };
-        form_data?: Record<string, unknown>;
-    }): Promise<void>;
-    /** Stop streaming and cleanup */
-    disconnect(): void;
-    /** Reset the agent (start fresh chat) */
-    reset(): void;
-    /** Upload a file and return the file object */
-    uploadFile(data: Blob | string): Promise<{
-        uri: string;
-        content_type?: string;
-    }>;
-    private startStreaming;
-    private createEventSource;
-    private request;
-}