@inferencesh/sdk 0.6.3 → 0.6.5

package/dist/types.d.ts

@@ -10,118 +10,102 @@ export interface InternalToolsConfig {
     host_context?: boolean;
 }
 /**
- * ToolType represents the type of tool (used in both AgentTool definition and ToolInvocation)
+ * AgentTool represents a unified tool that can be used by an agent
  */
-export type ToolType = string;
-export declare const ToolTypeApp: ToolType;
-export declare const ToolTypeAgent: ToolType;
-export declare const ToolTypeHook: ToolType;
-export declare const ToolTypeHTTP: ToolType;
-export declare const ToolTypeCall: ToolType;
-export declare const ToolTypeMCP: ToolType;
-export declare const ToolTypeClient: ToolType;
-export declare const ToolTypeInternal: ToolType;
+export interface AgentTool {
+    name: string;
+    display_name?: string;
+    description: string;
+    type: ToolType;
+    require_approval?: boolean;
+    app?: AppToolConfig;
+    agent?: AgentToolConfig;
+    hook?: HookToolConfig;
+    http?: HTTPToolConfig;
+    call?: HTTPToolConfig;
+    mcp?: MCPToolConfig;
+    client?: ClientToolConfig;
+    internal?: InternalToolConfig;
+}
+/**
+ * InternalToolConfig contains configuration for internal/built-in tools
+ */
+export interface InternalToolConfig {
+    category: string;
+    operation: string;
+}
 /**
- * AppToolConfig contains configuration for an app tool
+ * SkillConfig defines a skill available to the agent.
+ */
+export interface SkillConfig {
+    name: string;
+    description: string;
+    skill_id?: string;
+    version_id?: string;
+    url?: string;
+    content?: string;
+    preload?: boolean;
+}
+/**
+ * ContextField declares a context parameter expected by the agent.
+ */
+export interface ContextField {
+    name: string;
+    description?: string;
+    required?: boolean;
+    default?: string;
+}
+/**
+ * AgentToolDTO for API responses
  */
+export interface AgentToolDTO {
+    name: string;
+    display_name?: string;
+    description: string;
+    type: ToolType;
+    require_approval?: boolean;
+    app?: AppToolConfigDTO;
+    agent?: AgentToolConfigDTO;
+    hook?: HookToolConfigDTO;
+    http?: HTTPToolConfigDTO;
+    call?: HTTPToolConfigDTO;
+    mcp?: MCPToolConfigDTO;
+    client?: ClientToolConfigDTO;
+}
 export interface AppToolConfig {
-    /**
-     * Ref is the human-readable reference: "namespace/name@shortVersionId"
-     * This is what users specify in configs/SDKs
-     */
     ref: string;
-    /**
-     * ID and VersionID are resolved full database UUIDs (populated at runtime)
-     */
     id?: string;
     version_id?: string;
-    /**
-     * Resolved app object (populated at runtime)
-     */
-    app?: App;
-    /**
-     * Function to call on multi-function apps (empty = app's default function)
-     */
     function?: string;
-    /**
-     * SessionEnabled allows the agent to control sessions for this tool
-     * When true, agent can pass session parameter and sees session_id in output
-     */
     session_enabled?: boolean;
-    /**
-     * Pre-configured values
-     */
     setup?: any;
     input?: any;
 }
-/**
- * AgentToolConfig contains configuration for a sub-agent tool
- */
 export interface AgentToolConfig {
-    /**
-     * Ref is the human-readable reference: "namespace/name@shortVersionId"
-     * This is what users specify in configs/SDKs
-     */
     ref: string;
-    /**
-     * ID and VersionID are resolved full database UUIDs (populated at runtime)
-     */
     id?: string;
     version_id?: string;
-    /**
-     * Resolved agent object (populated at runtime)
-     */
-    agent?: Agent;
 }
-/**
- * HookToolConfig contains configuration for a webhook tool
- */
 export interface HookToolConfig {
     url: string;
     secret?: string;
     input_schema?: any;
     output_schema?: any;
 }
-/**
- * ClientToolConfig contains configuration for a frontend-executed tool
- */
 export interface ClientToolConfig {
     input_schema?: any;
     output_schema?: any;
 }
 /**
- * ToolAuthConfig declares how a tool authenticates. Resolved at runtime — never contains actual credentials.
+ * ToolAuthConfig declares how a tool authenticates.
  */
 export interface ToolAuthConfig {
-    /**
-     * Type: "integration", "api_key", "bearer", "none"
-     */
     type: string;
-    /**
-     * For type=integration: which provider to look up (e.g. "google", "mcp", "slack")
-     */
     provider?: string;
-    /**
-     * For type=integration: specific integration ID (optional — if empty, uses team's primary for provider)
-     */
     integration_id?: string;
-    /**
-     * For type=api_key or bearer: name of the secret in the team's secret store
-     */
     secret?: string;
-    /**
-     * For type=api_key: which header to inject (default: "X-API-Key")
-     */
     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
- */
 export interface HTTPToolConfig {
     url: string;
     method?: string;
@@ -132,86 +116,17 @@ export interface HTTPToolConfig {
     input_schema?: any;
     output_schema?: any;
 }
-/**
- * MCPToolConfig contains configuration for a remote MCP server tool
- */
 export interface MCPToolConfig {
-    /**
-     * IntegrationID references the MCP integration (has server_url, tokens, cached tools)
-     */
     integration_id: string;
-    /**
-     * ToolName is the tool name on the remote MCP server
-     */
     tool_name: string;
 }
-/**
- * AgentTool represents a unified tool that can be used by an agent
- */
-export interface AgentTool {
-    name: string;
-    display_name?: string;
-    description: string;
-    type: ToolType;
-    /**
-     * Human-in-the-Loop: if true, tool execution requires user approval
-     */
-    require_approval?: boolean;
-    /**
-     * Type-specific config (exactly one should be set based on Type)
-     */
-    app?: AppToolConfig;
-    agent?: AgentToolConfig;
-    hook?: HookToolConfig;
-    http?: HTTPToolConfig;
-    call?: CallToolConfig;
-    mcp?: MCPToolConfig;
-    client?: ClientToolConfig;
-    internal?: InternalToolConfig;
-}
-/**
- * InternalToolConfig contains configuration for internal/built-in tools
- */
-export interface InternalToolConfig {
-    category: string;
-    operation: string;
-}
-/**
- * AgentToolDTO for API responses
- */
-export interface AgentToolDTO {
-    name: string;
-    display_name?: string;
-    description: string;
-    type: ToolType;
-    /**
-     * Human-in-the-Loop: if true, tool execution requires user approval
-     */
-    require_approval?: boolean;
-    app?: AppToolConfigDTO;
-    agent?: AgentToolConfigDTO;
-    hook?: HookToolConfigDTO;
-    http?: HTTPToolConfigDTO;
-    call?: HTTPToolConfigDTO;
-    mcp?: MCPToolConfigDTO;
-    client?: ClientToolConfigDTO;
-}
 export interface AppToolConfigDTO {
     ref: string;
     id?: string;
     version_id?: string;
     app?: AppDTO;
-    /**
-     * Function to call on multi-function apps
-     */
     function?: string;
-    /**
-     * SessionEnabled allows the agent to control sessions for this tool
-     */
     session_enabled?: boolean;
-    /**
-     * Pre-configured values
-     */
     setup?: any;
     input?: any;
 }
@@ -246,45 +161,23 @@ export interface MCPToolConfigDTO {
     tool_name: string;
 }
 /**
- * CoreAppConfig references an app used as the agent's core
- */
-export interface CoreAppConfig {
-    id?: string;
-    version_id?: string;
-    /**
-     * CoreAppRef is the user-facing ref (namespace/name@shortid) - used in ad-hoc configs, resolved at creation
-     */
-    ref?: string;
-    /**
-     * Setup values for the core app (one-time configuration)
-     */
-    setup?: any;
-    /**
-     * Input default values for the core app
-     */
-    input?: any;
-}
-/**
- * AgentImages contains display images for an agent (like AppImages)
+ * AgentImages contains display images for an agent
  */
 export interface AgentImages {
     card: string;
     thumbnail: string;
     banner: string;
 }
-export interface Agent extends BaseModel, PermissionModel {
-    ProjectModel: ProjectModel;
-    /**
-     * Basic info
-     */
-    namespace: string;
-    name: string;
-    /**
-     * Display images (like App)
-     */
-    images: AgentImages;
-    version_id: string;
-    version?: AgentVersion;
+/**
+ * CoreAppConfigDTO references an app used as the agent's core
+ */
+export interface CoreAppConfigDTO {
+    id?: string;
+    version_id?: string;
+    ref?: string;
+    app?: AppDTO;
+    setup?: any;
+    input?: any;
 }
 /**
  * AgentDTO for API responses
@@ -292,130 +185,66 @@ export interface Agent extends BaseModel, PermissionModel {
 export interface AgentDTO extends BaseModelDTO, PermissionModelDTO, ProjectModelDTO {
     namespace: string;
     name: string;
-    /**
-     * Display images (like AppDTO)
-     */
     images: AgentImages;
     version_id: string;
     version?: AgentVersionDTO;
 }
-/**
- * SkillConfig defines a skill available to the agent.
- * Skills are loaded on-demand via the skill_get internal tool.
- */
-export interface SkillConfig {
-    name: string;
+export interface AgentVersionDTO extends BaseModelDTO, PermissionModelDTO {
     description: string;
-    skill_id?: string;
-    version_id?: string;
-    url?: string;
-    content?: string;
-    preload?: boolean;
+    system_prompt: string;
+    example_prompts: string[];
+    core_app?: CoreAppConfigDTO;
+    tools: (AgentToolDTO | undefined)[];
+    skills: SkillConfig[];
+    context?: ContextField[];
+    internal_tools?: InternalToolsConfig;
+    output_schema?: any;
 }
 /**
- * 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.
+ * 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 ContextField {
+export interface CreateAgentRequest {
+    id?: string;
     name: string;
-    description?: string;
-    required?: boolean;
-    default?: string;
+    namespace?: string;
+    images?: AgentImages;
+    /**
+     * Version config (embedded - backend generates version ID, timestamps, etc)
+     */
+    version?: AgentConfigInput;
 }
 /**
- * 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.
+ * AgentConfigInput is the API input shape for agent version config.
+ * Mirrors AgentConfig's JSON contract without gorm tags or runtime pointers.
  */
-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.
-     */
+export interface AgentConfigInput {
     name?: string;
     description?: string;
     system_prompt?: string;
     example_prompts?: string[];
-    /**
-     * Core LLM configuration
-     */
-    core_app?: CoreAppConfig;
-    /**
-     * Tools (apps, agents, hooks, client tools)
-     */
+    core_app?: CoreAppConfigInput;
     tools?: (AgentTool | undefined)[];
-    /**
-     * 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)
-     */
     internal_tools?: InternalToolsConfig;
-    /**
-     * Output schema for custom finish tool (sub-agents only)
-     */
     output_schema?: any;
 }
-export interface AgentVersion extends BaseModel, PermissionModel {
-    agent_id: string;
-    /**
-     * ConfigHash for deduplication - SHA256 of config content
-     */
-    config_hash: string;
-}
-export interface CoreAppConfigDTO {
+/**
+ * CoreAppConfigInput is the API input shape for core app configuration.
+ */
+export interface CoreAppConfigInput {
     id?: string;
     version_id?: string;
     ref?: string;
-    app?: AppDTO;
-    /**
-     * Setup values for the core app (one-time configuration)
-     */
     setup?: any;
-    /**
-     * Input default values for the core app
-     */
     input?: any;
 }
-export interface AgentVersionDTO extends BaseModelDTO, PermissionModelDTO {
-    description: string;
-    system_prompt: string;
-    example_prompts: string[];
-    core_app?: CoreAppConfigDTO;
-    /**
-     * Unified tools array (apps, agents, hooks, client)
-     */
-    tools: (AgentToolDTO | undefined)[];
-    /**
-     * 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)
-     */
-    internal_tools?: InternalToolsConfig;
-    /**
-     * Output schema for custom finish tool (sub-agents only)
-     */
-    output_schema?: any;
-}
-export interface APIRequest<T extends any> {
-    timestamp: string;
-    data: T;
-}
 export interface APIResponse<T extends any> {
     success: boolean;
     status: number;
-    data?: T;
+    data: T;
     error?: APIError;
 }
 export interface APIError {
@@ -428,20 +257,9 @@ export interface APIError {
 }
 /**
  * ApiAppRunRequest is the request body for /apps/run endpoint.
- * 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 {
-    /**
-     * App reference in format: namespace/name@shortid (version required)
-     * Example: "okaris/flux@abc1"
-     * The short ID ensures your code always runs the same version.
-     */
     app?: string;
-    /**
-     * Deprecated: use App ref instead. Direct ID bypasses ref routing.
-     */
     app_id?: string;
     version_id?: string;
     infra?: Infra;
@@ -449,165 +267,37 @@ export interface ApiAppRunRequest {
     webhook?: string;
     setup?: any;
     input: any;
-    /**
-     * If true, returns SSE stream instead of JSON response
-     */
     stream?: boolean;
-    /**
-     * If true, holds the connection open until the task reaches a terminal state and returns the final result.
-     * Mutually exclusive with Stream.
-     */
     wait?: boolean;
-    /**
-     * Function to call on multi-function apps (defaults to "run" or app's default_function)
-     */
     function?: string;
-    /**
-     * Session control: "new" to start a new session, "sess_xxx" to continue existing session
-     * When using sessions, the worker is leased and state persists across calls
-     */
     session?: string;
-    /**
-     * Session timeout in seconds (1-3600). Only valid when session="new"
-     */
     session_timeout?: number;
-    /**
-     * Schedule execution for a specific time (ISO 8601 UTC, e.g. "2026-02-24T15:30:00Z").
-     * Task stays queued until this time. Past timestamps run immediately.
-     */
     run_at?: string;
-    /**
-     * Optional metadata (e.g., action to trigger on completion)
-     */
     metadata?: TaskMetadata;
 }
 /**
  * ApiAgentRunRequest is the request body for /agents/run endpoint.
- * Supports both template agents and ad-hoc agents.
  */
 export interface ApiAgentRunRequest {
-    /**
-     * Existing chat ID to continue a conversation (optional)
-     */
     chat_id?: string;
-    /**
-     * Template agent reference in format: namespace/name@shortid
-     * Example: "my-org/assistant@abc123"
-     * Use this OR AgentConfig, not both
-     */
     agent?: string;
-    /**
-     * Ad-hoc agent configuration
-     * 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?: AgentConfig;
-    /**
-     * Optional name for the adhoc agent (used for deduplication and display)
-     */
+    agent_config?: AgentConfigInput;
     agent_name?: string;
-    /**
-     * 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
-     */
-    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;
-    agent_version_id?: string;
-    agent?: string;
-    tool_call_id?: string;
-    input: ChatTaskInput;
-    integration_context?: IntegrationContext;
-    /**
-     * 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?: AgentConfig;
-    /**
-     * 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;
-    assistant_message?: ChatMessageDTO;
-}
 /**
  * ToolResultRequest represents a tool result submission
- * For widget actions, clients should JSON-serialize { action, form_data } as the result string
  */
 export interface ToolResultRequest {
     result: string;
 }
 /**
- * WebhookPayload is the envelope for outbound webhook deliveries (e.g., task webhooks).
- */
-export interface WebhookPayload<T extends any> {
-    event: string;
-    timestamp: string;
-    data: T;
-}
-/**
- * HookPayload represents the request body sent to a webhook when a hook tool is invoked
- */
-export interface HookPayload {
-    /**
-     * Identification
-     */
-    tool_invocation_id: string;
-    hook_name: string;
-    /**
-     * Callback - use this to submit the result back
-     */
-    callback_url: string;
-    callback_method: string;
-    /**
-     * Timestamp in RFC3339 format
-     */
-    timestamp: string;
-    /**
-     * The actual tool arguments from the LLM
-     */
-    arguments: {
-        [key: string]: any;
-    };
-}
-/**
- * HookResponse represents the expected response from the hook URL
- * The hook should return 200 with success:true to acknowledge receipt
- * The actual result should be sent via the callback URL
+ * PartialFile is the clean DTO version (no gorm tags).
  */
-export interface HookResponse {
-    success: boolean;
-    message?: string;
-}
 export interface PartialFile {
     uri: string;
     path?: string;
@@ -615,67 +305,6 @@ export interface PartialFile {
     size?: number;
     filename?: string;
 }
-export interface FileCreateRequest {
-    /**
-     * Category determines the storage path prefix: "uploads" (default), "inputs", "outputs", "repos"
-     */
-    category?: string;
-    files: PartialFile[];
-}
-export interface CreateFlowRequest {
-    name: string;
-}
-export interface CreateFlowRunRequest {
-    flow: string;
-    input: any;
-}
-/**
- * CreateAppRequest is the request body for POST /apps
- */
-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).
-     * Set true for admin deployments where you want to test before promoting.
-     */
-    preserve_current_version?: boolean;
-}
-/**
- * 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.
- * Frontend uses generics like CursorListResponse<FlowDTO> directly.
- */
-export interface SDKTypes {
-}
 export interface SkillPublishRequest {
     namespace?: string;
     name: string;
@@ -686,40 +315,18 @@ export interface SkillPublishRequest {
     allowed_tools: string;
     compatibility: string;
     instructions: string;
-    files: SkillFile[];
+    files: KnowledgeFile[];
     metadata?: {
         [key: string]: string;
     };
-    /**
-     * Lineage — backend infers MutationType from context
-     */
     parent_skill_id?: string;
     parent_version_id?: string;
     source_url?: string;
     version_notes?: string;
-    /**
-     * Spec fields for roundtrip fidelity
-     */
     disable_model_invocation: boolean;
     user_invocable?: boolean;
     context: string;
 }
-export interface CheckoutCreateRequest {
-    amount: number;
-    success_url: string;
-    cancel_url: string;
-}
-export interface CheckoutCompleteRequest {
-    session_id: string;
-}
-/**
- * Legacy aliases for backward compatibility
- */
-export type StripeCheckoutCreateRequest = CheckoutCreateRequest;
-export type StripeCheckoutCompleteRequest = CheckoutCompleteRequest;
-/**
- * AuthResponse is returned after successful authentication (OAuth, magic link, SSO)
- */
 export interface AuthResponse {
     user?: UserDTO;
     session_id: string;
@@ -727,65 +334,11 @@ export interface AuthResponse {
     redirect_to?: string;
     provider?: string;
 }
-/**
- * DeviceAuthResponse is returned when a device initiates auth
- */
-export interface DeviceAuthResponse {
-    user_code: string;
-    device_code: string;
-    poll_url: string;
-    approve_url: string;
-    expires_in: number;
-    interval: number;
-}
-/**
- * DeviceAuthPollResponse is returned when polling for auth status
- */
-export interface DeviceAuthPollResponse {
-    status: DeviceAuthStatus;
-    api_key?: string;
-    team_id?: string;
-}
-/**
- * DeviceAuthApproveRequest is sent when user approves the auth request
- */
-export interface DeviceAuthApproveRequest {
-    code: string;
-    team_id: string;
-    scopes?: string[];
-}
-/**
- * DeviceAuthApproveResponse is returned after approval
- */
-export interface DeviceAuthApproveResponse {
-    success: boolean;
-    message?: string;
-}
-/**
- * DeviceAuthCodeInfo contains info about a pending auth code (for display on approve page)
- */
-export interface DeviceAuthCodeInfo {
-    user_code: string;
-    expires_at: string;
-    valid: boolean;
-    status: DeviceAuthStatus;
-}
-/**
- * MeResponse is returned from GET /me with user and current team info
- */
-export interface MeResponse {
-    user?: UserDTO;
-    team?: TeamDTO;
-}
 export interface TeamCreateRequest {
     name: string;
     username: string;
     email: string;
 }
-/**
- * TeamSetupRequest is used for completing team setup (choosing username)
- * This marks the team as setup_completed=true after validation
- */
 export interface TeamSetupRequest {
     username: string;
 }
@@ -796,135 +349,256 @@ export interface TeamMemberAddRequest {
 export interface TeamMemberUpdateRoleRequest {
     role: TeamRole;
 }
-/**
- * SecretCreateRequest for creating a new secret
- */
-export interface SecretCreateRequest {
-    key: string;
-    value: string;
-    description?: string;
-}
-/**
- * SecretUpdateRequest for updating a secret value
- */
-export interface SecretUpdateRequest {
-    value: string;
-    description?: string;
-}
-/**
- * IntegrationConnectRequest for initiating an integration connection
- */
-export interface IntegrationConnectRequest {
-    provider: string;
-    type: string;
-    scopes?: string[];
-    /**
-     * For API Key type
-     */
-    api_key?: string;
-    /**
-     * For BYOK integrations (e.g., X.com) - contains user-provided credentials
-     */
-    metadata?: {
-        [key: string]: any;
-    };
-}
-/**
- * IntegrationCompleteOAuthRequest for completing an OAuth flow
- */
 export interface IntegrationCompleteOAuthRequest {
     provider: string;
     type: string;
     code: string;
     state: string;
-    /**
-     * For PKCE - code_verifier to complete the exchange (required by some providers like X/Twitter)
-     */
     code_verifier?: string;
 }
 /**
- * IntegrationConnectResponse after connecting
+ * Scope represents an API key permission scope string.
  */
-export interface IntegrationConnectResponse {
-    integration?: IntegrationDTO;
-    /**
-     * For OAuth - redirect URL to start the flow
-     */
-    auth_url?: string;
-    /**
-     * For OAuth - state to be returned with the callback (frontend stores this)
-     */
-    state?: string;
-    /**
-     * For PKCE - code_verifier to be stored and sent back with CompleteOAuth (required by some providers like X/Twitter)
-     */
-    code_verifier?: string;
-    /**
-     * For service accounts - instructions
-     */
-    instructions?: string;
-    /**
-     * RequiresConfirmation — the connect was paused, user must acknowledge and retry with a flag.
-     */
-    requires_confirmation?: boolean;
-    confirmation_type?: string;
-    message?: string;
-}
-export interface ProjectCreateRequest {
-    name: string;
-    type: ProjectType;
-}
-export interface ProjectUpdateRequest {
-    name: string;
-}
-export interface MoveAgentToProjectRequest {
-    agent_id: string;
-    project_id: string;
-}
+export type Scope = string;
 /**
- * WorkerGPUConfig holds GPU identifiers for a worker.
- * GPUs accepts both integer indexes (legacy) and string GPU IDs.
- * Use GPUIndexes() and GPUIDs() to separate them after unmarshaling.
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
  */
-export interface WorkerGPUConfig {
-    gpus: any[];
-}
-export interface WorkerCPUConfig {
-    count: number;
-}
-export interface WorkerConfig {
-    gpu: WorkerGPUConfig[];
-    cpu: WorkerCPUConfig;
-}
-export interface EngineConfig {
-    id: string;
-    name: string;
-    api_url: string;
-    engine_port: string;
-    workers: WorkerConfig;
-    api_key: string;
-    container_mode: boolean;
-    network_name: string;
-    cache_path: string;
-    gpus: string[];
-    /**
-     * CallbackBasePort overrides the base port for engine↔worker callback APIs.
-     * If 0, derived from EnginePort: 5000 + (enginePort - 8163) * 100.
-     */
-    callback_base_port: number;
-    /**
-     * EngineInternalAPIURL is the URL workers use to reach the engine's main API.
-     * If empty, derived as http://host.docker.internal:{EnginePort}.
-     */
-    engine_internal_api_url: string;
-}
+export declare const ScopeAll: Scope;
 /**
- * ScopeGroup identifies a category of scopes for UI grouping
+ * Resource-level scopes (implies all actions)
  */
-export type ScopeGroup = string;
-export declare const ScopeGroupAgents: ScopeGroup;
-export declare const ScopeGroupApps: ScopeGroup;
-export declare const ScopeGroupConversations: ScopeGroup;
+export declare const ScopeAgents: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeApps: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeConversations: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeFiles: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeDatastores: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeTemplates: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeFlows: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeProjects: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeTeams: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeBilling: Scope;
+/**
+ * Action-level scopes for Agents
+ */
+export declare const ScopeAgentsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeAgentsWrite: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeAgentsExecute: Scope;
+/**
+ * Action-level scopes for Apps
+ */
+export declare const ScopeAppsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeAppsWrite: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeAppsExecute: Scope;
+/**
+ * Action-level scopes for Conversations/Chats
+ */
+export declare const ScopeConversationsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeConversationsWrite: Scope;
+/**
+ * Action-level scopes for Files
+ */
+export declare const ScopeFilesRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeFilesWrite: Scope;
+/**
+ * Action-level scopes for Datastores
+ */
+export declare const ScopeDatastoresRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeDatastoresWrite: Scope;
+/**
+ * Action-level scopes for Flows
+ */
+export declare const ScopeFlowsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeFlowsWrite: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeFlowsExecute: Scope;
+/**
+ * Action-level scopes for Projects
+ */
+export declare const ScopeProjectsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeProjectsWrite: Scope;
+/**
+ * Action-level scopes for Teams
+ */
+export declare const ScopeTeamsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeTeamsWrite: Scope;
+/**
+ * Action-level scopes for Billing
+ */
+export declare const ScopeBillingRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeBillingWrite: Scope;
+/**
+ * Action-level scopes for Secrets (sensitive - not in read/run presets)
+ */
+export declare const ScopeSecretsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeSecretsWrite: Scope;
+/**
+ * Action-level scopes for Integrations
+ */
+export declare const ScopeIntegrationsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeIntegrationsWrite: Scope;
+/**
+ * Action-level scopes for Engines
+ */
+export declare const ScopeEnginesRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeEnginesWrite: Scope;
+/**
+ * Action-level scopes for API Keys
+ */
+export declare const ScopeApiKeysRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeApiKeysWrite: Scope;
+/**
+ * Action-level scopes for User profile
+ */
+export declare const ScopeUserRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeUserWrite: Scope;
+/**
+ * Action-level scopes for Settings/Notifications
+ */
+export declare const ScopeSettingsRead: Scope;
+/**
+ * API Key Scopes - hierarchical permission system.
+ * Resource-level scopes (e.g., "agents") imply all action-level scopes (e.g., "agents:read").
+ * Empty scopes = full access (for backwards compatibility with existing keys).
+ */
+export declare const ScopeSettingsWrite: Scope;
+/**
+ * ScopeGroup identifies a category of scopes for UI grouping
+ */
+export type ScopeGroup = string;
+export declare const ScopeGroupAgents: ScopeGroup;
+export declare const ScopeGroupApps: ScopeGroup;
+export declare const ScopeGroupConversations: ScopeGroup;
 export declare const ScopeGroupFiles: ScopeGroup;
 export declare const ScopeGroupDatastores: ScopeGroup;
 export declare const ScopeGroupFlows: ScopeGroup;
@@ -941,7 +615,7 @@ export declare const ScopeGroupSettings: ScopeGroup;
  * ScopeDefinition describes a single scope for UI rendering
  */
 export interface ScopeDefinition {
-    value: string;
+    value: Scope;
     label: string;
     description: string;
     group: ScopeGroup;
@@ -954,6 +628,14 @@ export interface ScopeGroupDefinition {
     label: string;
     description: string;
 }
+/**
+ * ScopesResponse is the API response for GET /scopes
+ */
+export interface ScopesResponse {
+    scopes: ScopeDefinition[];
+    groups: ScopeGroupDefinition[];
+    presets: ScopePreset[];
+}
 /**
  * ScopePreset represents a predefined bundle of scopes for common use cases
  */
@@ -961,102 +643,71 @@ export interface ScopePreset {
     id: string;
     label: string;
     description: string;
-    scopes: string[];
-}
-export type AppCategory = string;
-export declare const AppCategoryImage: AppCategory;
-export declare const AppCategoryVideo: AppCategory;
-export declare const AppCategoryAudio: AppCategory;
-export declare const AppCategoryText: AppCategory;
-export declare const AppCategoryChat: AppCategory;
-export declare const AppCategory3D: AppCategory;
-export declare const AppCategoryOther: AppCategory;
-export declare const AppCategoryFlow: AppCategory;
-export type GPUType = string;
-export declare const GPUTypeAny: GPUType;
-export declare const GPUTypeNone: GPUType;
-export declare const GPUTypeIntel: GPUType;
-export declare const GPUTypeNvidia: GPUType;
-export declare const GPUTypeAMD: GPUType;
-export declare const GPUTypeApple: GPUType;
-export interface AppImages {
-    card: string;
-    thumbnail: string;
-    banner: string;
+    scopes: Scope[];
 }
-export interface App extends BaseModel, PermissionModel {
-    /**
-     * Namespace is copied from team.username at creation time and is IMMUTABLE.
-     * This ensures stable references like "namespace/name" even if team username changes.
-     * Default empty string allows GORM migration to add column, then MigrateAppNamespaces populates it.
-     */
-    namespace: string;
-    /**
-     * Name is IMMUTABLE after creation. Combined with Namespace forms unique identifier.
-     */
+/**
+ * ApiKeyDTO for API responses
+ */
+export interface ApiKeyDTO extends BaseModelDTO, PermissionModelDTO {
     name: string;
-    description: string;
-    agent_description: string;
-    /**
-     * Category is a fundamental classification of the app (image, video, audio, text, chat, 3d, other)
-     */
-    category: AppCategory;
-    /**
-     * Developer's images
-     */
-    images: AppImages;
-    /**
-     * Current version (developer's latest)
-     */
-    version_id: string;
-    version?: AppVersion;
+    key: string;
+    last_used_at: string;
+    expires_at?: string;
+    scopes: Scope[];
+    source?: string;
 }
 /**
- * AppPricing configures all pricing using CEL expressions
- * Empty expressions use defaults. All values in microcents (1 cent = 1,000,000; 1 dollar = 100,000,000)
+ * AppPricing configures all pricing using CEL expressions.
+ * Empty expressions use defaults. All values in microcents.
  */
 export interface AppPricing {
     prices: {
         [key: string]: number;
     };
     upstream_pricing?: string;
-    /**
-     * Resource fee expression (compute cost)
-     * Available variables: resources (list of {name, price_per_second}), usage_seconds, prices
-     * Default: sum(resources.map(r, r.price_per_second)) * usage_seconds
-     */
     resource_expression: string;
-    /**
-     * CEL expressions for each fee type (result in microcents)
-     * Available variables: inputs, outputs, prices, resource_fee, usage_seconds
-     */
     inference_expression: string;
     royalty_expression: string;
     partner_expression: string;
-    /**
-     * Total expression combines all fees (can apply weights/discounts)
-     * Available variables: inputs, outputs, prices, resource_fee, usage_seconds, inference_fee, royalty_fee, partner_fee
-     * Default: resource_fee + inference_fee + royalty_fee + partner_fee
-     */
     total_expression: string;
     description: string;
-    /**
-     * DescriptionRendered is the result of evaluating Description against the
-     * static prices map at save time. Frontends should display this rather than
-     * the raw CEL source. Empty string means the description failed to render
-     * (e.g. references variables outside `prices`).
-     */
     description_rendered?: string;
 }
+/**
+ * AppFunction represents a callable entry point within an app version.
+ */
+export interface AppFunction {
+    name: string;
+    description?: string;
+    input_schema: any;
+    output_schema: any;
+}
+/**
+ * AppImages holds developer-provided images for the app.
+ */
+export interface AppImages {
+    card: string;
+    thumbnail: string;
+    banner: string;
+}
+/**
+ * AppGPUResource describes GPU requirements.
+ */
 export interface AppGPUResource {
     count: number;
     vram: number;
     type: GPUType;
 }
+/**
+ * AppResources describes resource requirements.
+ */
 export interface AppResources {
     gpu: AppGPUResource;
     ram: number;
 }
+/**
+ * AppVariant is a named resource/env configuration variant.
+ */
 export interface AppVariant {
     name: string;
     order: number;
@@ -1067,58 +718,24 @@ export interface AppVariant {
     python: string;
 }
 /**
- * AppFunction represents a callable entry point within an app version.
- * Each function has its own input/output schema while sharing the app's setup.
+ * SecretRequirement defines a secret that an app requires to run.
  */
-export interface AppFunction {
-    name: string;
+export interface SecretRequirement {
+    key: string;
     description?: string;
-    input_schema: any;
-    output_schema: any;
-}
-export interface AppVersion extends BaseModel {
-    app_id: string;
-    metadata: {
-        [key: string]: any;
-    };
-    repository: string;
-    flow_version_id?: string;
-    flow_version?: FlowVersion;
-    setup_schema: any;
-    input_schema: any;
-    output_schema: any;
-    /**
-     * Functions contains the callable entry points for this app version.
-     * Each function has its own input/output schema. If nil/empty, the app uses legacy single-function mode
-     * with InputSchema/OutputSchema at the version level.
-     */
-    functions?: {
-        [key: string]: AppFunction;
-    };
-    default_function?: string;
-    variants: {
-        [key: string]: AppVariant;
-    };
-    env: {
-        [key: string]: string;
-    };
-    kernel: string;
-    /**
-     * App requirements - secrets and integrations needed to run this app
-     */
-    required_secrets?: SecretRequirement[];
-    required_integrations?: IntegrationRequirement[];
-    resources: AppResources;
-    /**
-     * Checksum is the SHA256 checksum of the uploaded zip file
-     */
-    checksum?: string;
+    optional?: boolean;
 }
-export interface LicenseRecordDTO extends BaseModelDTO {
-    user_id: string;
-    app_id: string;
-    license: string;
+/**
+ * IntegrationRequirement defines an integration capability that an app requires.
+ */
+export interface IntegrationRequirement {
+    key: string;
+    description?: string;
+    optional?: boolean;
 }
+/**
+ * AppDTO is the API response for a full app.
+ */
 export interface AppDTO extends BaseModelDTO, PermissionModelDTO {
     namespace: string;
     name: string;
@@ -1129,6 +746,9 @@ export interface AppDTO extends BaseModelDTO, PermissionModelDTO {
     version_id: string;
     version?: AppVersionDTO;
 }
+/**
+ * AppVersionDTO is the API response for an app version.
+ */
 export interface AppVersionDTO extends BaseModelDTO {
     metadata: {
         [key: string]: any;
@@ -1150,21 +770,19 @@ export interface AppVersionDTO extends BaseModelDTO {
         [key: string]: string;
     };
     kernel: string;
-    /**
-     * App requirements
-     */
     required_secrets?: SecretRequirement[];
     required_integrations?: IntegrationRequirement[];
     resources: AppResources;
-    /**
-     * Checksum is the SHA256 checksum of the uploaded zip file
-     */
     checksum?: string;
 }
-export type AppSessionStatus = string;
-export declare const AppSessionStatusActive: AppSessionStatus;
-export declare const AppSessionStatusEnded: AppSessionStatus;
-export declare const AppSessionStatusExpired: AppSessionStatus;
+/**
+ * LicenseRecordDTO is the API response for a license record.
+ */
+export interface LicenseRecordDTO extends BaseModelDTO {
+    user_id: string;
+    app_id: string;
+    license: string;
+}
 /**
  * AppSessionDTO is the external representation
  */
@@ -1180,6 +798,25 @@ export interface AppSessionDTO extends BaseModelDTO, PermissionModelDTO {
     last_call_at?: string;
     idle_timeout?: number;
 }
+/**
+ * AppStoreListingDTO for API responses
+ */
+export interface AppStoreListingDTO {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string;
+    category: string;
+    subcategory?: string;
+    page_id?: string;
+    is_featured: boolean;
+    rank: number;
+    allows_private_workers: boolean;
+    allows_cloud_workers: boolean;
+    max_concurrency: number;
+    max_concurrency_per_team: number;
+    tags?: string[];
+}
 /**
  * PublicAppStoreDTO is a lean DTO for public app store display.
  */
@@ -1197,13 +834,6 @@ export interface PublicAppStoreDTO {
     has_approved_version: boolean;
     page_id?: string;
 }
-export interface BaseModel {
-    id: string;
-    short_id: string;
-    created_at: string;
-    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.
@@ -1216,19 +846,8 @@ export interface BaseModelDTO {
     deleted_at?: string;
 }
 /**
- * Visibility represents the visibility level of a resource
+ * PermissionModelDTO is the contract-layer permission embed.
  */
-export type Visibility = string;
-export declare const VisibilityPrivate: Visibility;
-export declare const VisibilityPublic: Visibility;
-export declare const VisibilityUnlisted: Visibility;
-export interface PermissionModel {
-    user_id: string;
-    user?: User;
-    team_id: string;
-    team?: Team;
-    visibility: Visibility;
-}
 export interface PermissionModelDTO {
     user_id: string;
     user?: UserRelationDTO;
@@ -1244,134 +863,9 @@ export interface ResourceStatusDTO {
     status: any;
     updated_at: string;
 }
-export type ChatStatus = string;
-export declare const ChatStatusBusy: ChatStatus;
-export declare const ChatStatusIdle: ChatStatus;
-export declare const ChatStatusAwaitingInput: ChatStatus;
-export declare const ChatStatusCompleted: ChatStatus;
-export interface IntegrationContext {
-    integration_type?: IntegrationType;
-    integration_metadata?: any;
-}
-/**
- * ChatData contains agent-specific data for a chat session
- */
-export interface ChatData {
-    plan_steps: PlanStep[];
-    memory: StringEncodedMap;
-    always_allowed_tools: string[];
-}
-/**
- * PlanStep represents a step in an agent's execution plan
- */
-export interface PlanStep {
-    index: number;
-    title: string;
-    description: string;
-    notes?: string;
-    status: PlanStepStatus;
-}
-/**
- * PlanStepStatus represents the status of a plan step
- */
-export type PlanStepStatus = string;
-export declare const PlanStepStatusPending: PlanStepStatus;
-export declare const PlanStepStatusInProgress: PlanStepStatus;
-export declare const PlanStepStatusCompleted: PlanStepStatus;
-export declare const PlanStepStatusCancelled: PlanStepStatus;
-export type ChatMessageRole = string;
-export declare const ChatMessageRoleSystem: ChatMessageRole;
-export declare const ChatMessageRoleUser: ChatMessageRole;
-export declare const ChatMessageRoleAssistant: ChatMessageRole;
-export declare const ChatMessageRoleTool: ChatMessageRole;
-/**
- * ChatMessageStatus represents the lifecycle status of a chat message
- */
-export type ChatMessageStatus = string;
-export declare const ChatMessageStatusPending: ChatMessageStatus;
-export declare const ChatMessageStatusReady: ChatMessageStatus;
-export declare const ChatMessageStatusFailed: ChatMessageStatus;
-export declare const ChatMessageStatusCancelled: ChatMessageStatus;
-export type ChatMessageContentType = string;
-export declare const ChatMessageContentTypeText: ChatMessageContentType;
-export declare const ChatMessageContentTypeReasoning: ChatMessageContentType;
-export declare const ChatMessageContentTypeImage: ChatMessageContentType;
-export declare const ChatMessageContentTypeFile: ChatMessageContentType;
-export declare const ChatMessageContentTypeTool: ChatMessageContentType;
-export type IntegrationType = string;
-export declare const IntegrationTypeSlack: IntegrationType;
-export declare const IntegrationTypeDiscord: IntegrationType;
-export declare const IntegrationTypeTeams: IntegrationType;
-export declare const IntegrationTypeTelegram: IntegrationType;
-/**
- * FileRef is a lightweight reference to a file with essential metadata.
- * Used in chat inputs/context instead of full File objects.
- */
-export interface FileRef {
-    id?: string;
-    uri: string;
-    filename: string;
-    content_type: string;
-    size?: number;
-}
-export interface ChatMessageContent {
-    type: ChatMessageContentType;
-    error?: string;
-    text?: string;
-    image?: string;
-    file?: string;
-    tool_calls?: ToolCall[];
-}
-/**
- * ToolCall represents a tool call from an LLM response (wire format)
- * This is a transport object for parsing LLM responses, not a database model
- */
-export interface ToolCall {
-    id: string;
-    type: string;
-    function: ToolCallFunction;
-}
 /**
- * ToolCallFunction contains the function name and arguments from an LLM tool call
+ * ChatDTO for API responses
  */
-export interface ToolCallFunction {
-    name: string;
-    arguments: StringEncodedMap;
-}
-export interface ChatTaskInput {
-    model?: string;
-    context_size: number;
-    temperature?: number;
-    top_p?: number;
-    reasoning_effort?: string;
-    reasoning_max_tokens?: number;
-    system_prompt: string;
-    context: ChatTaskContextMessage[];
-    role?: ChatMessageRole;
-    text?: string;
-    reasoning?: string;
-    /**
-     * Attachments is the SDK input field with full file metadata
-     */
-    attachments?: FileRef[];
-    /**
-     * Images and Files are internal fields for task workers (filled from Attachments or context)
-     */
-    images?: string[];
-    files?: string[];
-    tools?: Tool[];
-    tool_call_id?: string;
-}
-export interface ChatTaskContextMessage {
-    role: ChatMessageRole;
-    text?: string;
-    reasoning?: string;
-    images?: string[];
-    files?: string[];
-    tools?: Tool[];
-    tool_calls?: ToolCall[];
-    tool_call_id?: string;
-}
 export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
     parent_id?: string;
     parent?: ChatDTO;
@@ -1381,9 +875,6 @@ export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
     context?: {
         [key: string]: string;
     };
-    /**
-     * Agent version reference
-     */
     agent_id?: string;
     agent?: AgentDTO;
     agent_version_id?: string;
@@ -1393,6 +884,9 @@ export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
     chat_messages: ChatMessageDTO[];
     agent_data: ChatData;
 }
+/**
+ * ChatMessageDTO for API responses
+ */
 export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
     chat_id: string;
     chat?: ChatDTO;
@@ -1405,9 +899,6 @@ export interface ChatMessageDTO extends BaseModelDTO, PermissionModelDTO {
     tool_call_id?: string;
     tool_invocations?: ToolInvocationDTO[];
 }
-export type StringEncodedMap = {
-    [key: string]: any;
-};
 /**
  * SearchRequest represents a search request
  */
@@ -1424,32 +915,6 @@ export interface Filter {
     operator: FilterOperator;
     value: any;
 }
-/**
- * FilterOperator represents the type of filter operation
- */
-export type FilterOperator = string;
-export declare const OpEqual: FilterOperator;
-export declare const OpNotEqual: FilterOperator;
-export declare const OpIn: FilterOperator;
-export declare const OpNotIn: FilterOperator;
-export declare const OpGreater: FilterOperator;
-export declare const OpGreaterEqual: FilterOperator;
-export declare const OpLess: FilterOperator;
-export declare const OpLessEqual: FilterOperator;
-export declare const OpLike: FilterOperator;
-export declare const OpILike: FilterOperator;
-export declare const OpContains: FilterOperator;
-export declare const OpNotContains: FilterOperator;
-/**
- * Null checks
- */
-export declare const OpIsNull: FilterOperator;
-export declare const OpIsNotNull: FilterOperator;
-/**
- * Empty checks (for strings)
- */
-export declare const OpIsEmpty: FilterOperator;
-export declare const OpIsNotEmpty: FilterOperator;
 /**
  * SortOrder represents sorting configuration
  */
@@ -1485,42 +950,103 @@ export interface CursorListResponse<T extends any> {
     items_per_page: number;
     total_items: number;
 }
-export type DeviceAuthStatus = string;
-export declare const DeviceAuthStatusPending: DeviceAuthStatus;
-export declare const DeviceAuthStatusApproved: DeviceAuthStatus;
-export declare const DeviceAuthStatusExpired: DeviceAuthStatus;
-export declare const DeviceAuthStatusDenied: DeviceAuthStatus;
-export declare const DeviceAuthStatusValid: DeviceAuthStatus;
-export declare const DeviceAuthStatusInvalid: DeviceAuthStatus;
-export declare const DeviceAuthStatusLoading: DeviceAuthStatus;
 /**
- * Engine-related types
+ * EngineConfig holds engine configuration (no gorm tags).
  */
-export type EngineStatus = string;
-export declare const EngineStatusRunning: EngineStatus;
-export declare const EngineStatusPending: EngineStatus;
-export declare const EngineStatusDraining: EngineStatus;
-export declare const EngineStatusStopping: EngineStatus;
-export declare const EngineStatusStopped: EngineStatus;
-export interface EngineStateDTO extends BaseModelDTO, PermissionModelDTO {
-    instance?: Instance;
+export interface EngineConfig {
+    id: string;
+    name: string;
+    api_url: string;
+    engine_port: string;
+    workers: WorkerConfig;
+    api_key: string;
+    container_mode: boolean;
+    network_name: string;
+    cache_path: string;
+    gpus: string[];
+    callback_base_port: number;
+    engine_internal_api_url: string;
+}
+/**
+ * WorkerGPUConfig defines GPU allocation for a worker.
+ */
+export interface WorkerGPUConfig {
+    gpus: any[];
+}
+/**
+ * WorkerCPUConfig defines CPU allocation for a worker.
+ */
+export interface WorkerCPUConfig {
+    count: number;
+}
+/**
+ * WorkerConfig defines how workers are allocated on an engine.
+ */
+export interface WorkerConfig {
+    gpu: WorkerGPUConfig[];
+    cpu: WorkerCPUConfig;
+}
+/**
+ * EngineDTO is the full API response for an engine.
+ */
+export interface EngineDTO extends BaseModelDTO, PermissionModelDTO {
+    instance?: InstanceDTO;
     config: EngineConfig;
     name: string;
     api_url: string;
     status: EngineStatus;
     system_info?: SystemInfo;
-    workers: (WorkerStateDTO | undefined)[];
+    workers: (WorkerDTO | undefined)[];
 }
-export interface EngineStateSummary extends BaseModelDTO, PermissionModelDTO {
-    instance?: Instance;
+/**
+ * EngineSummary is a lightweight engine response embedded in tasks.
+ */
+export interface EngineSummary extends BaseModelDTO, PermissionModelDTO {
+    instance?: InstanceDTO;
     name: string;
     status: EngineStatus;
-    workers: (WorkerStateSummary | undefined)[];
+    workers: (WorkerSummary | undefined)[];
 }
 /**
- * Worker-related types
+ * WorkerDTO is the full API response for a worker.
+ */
+export interface WorkerDTO extends BaseModelDTO {
+    user_id: string;
+    team_id: string;
+    index: number;
+    status: WorkerStatus;
+    engine_id: string;
+    task_id?: string;
+    app_id: string;
+    app_version_id: string;
+    active_session_id?: string;
+    gpus?: WorkerGPU[];
+    cpus?: WorkerCPU[];
+    rams?: WorkerRAM[];
+    system_info: SystemInfo;
+    warm_apps?: string[];
+}
+/**
+ * WorkerSummary is a lightweight worker response.
+ */
+export interface WorkerSummary {
+    id: string;
+    user_id: string;
+    index: number;
+    status: WorkerStatus;
+    engine_id: string;
+    engine_name: string;
+    task_id?: string;
+    app_id: string;
+    app_version_id: string;
+    active_session_id?: string;
+    gpus?: WorkerGPU[];
+    cpus?: WorkerCPU[];
+    rams?: WorkerRAM[];
+}
+/**
+ * WorkerGPU describes a GPU attached to a worker (contract-only, no gorm).
  */
-export type WorkerStatus = string;
 export interface WorkerGPU {
     id: string;
     worker_id: string;
@@ -1529,6 +1055,9 @@ export interface WorkerGPU {
     name: string;
     vram: number;
 }
+/**
+ * WorkerCPU describes a CPU attached to a worker (contract-only, no gorm).
+ */
 export interface WorkerCPU {
     id: string;
     worker_id: string;
@@ -1539,41 +1068,27 @@ export interface WorkerCPU {
     cores: number;
     frequency: string;
 }
+/**
+ * WorkerRAM describes RAM attached to a worker (contract-only, no gorm).
+ */
 export interface WorkerRAM {
     id: string;
     worker_id: string;
     total: number;
 }
-export interface WorkerStateDTO extends BaseModelDTO {
-    user_id: string;
+/**
+ * EntitlementDTO for API responses
+ */
+export interface EntitlementDTO extends BaseModelDTO {
     team_id: string;
-    index: number;
-    status: WorkerStatus;
-    engine_id: string;
-    task_id?: string;
-    app_id: string;
-    app_version_id: string;
-    active_session_id?: string;
-    gpus: WorkerGPU[];
-    cpus: WorkerCPU[];
-    rams: WorkerRAM[];
-    system_info: SystemInfo;
-    warm_apps?: string[];
-}
-export interface WorkerStateSummary {
-    id: string;
-    user_id: string;
-    index: number;
-    status: WorkerStatus;
-    engine_id: string;
-    engine_name: string;
-    task_id?: string;
-    app_id: string;
-    app_version_id: string;
-    active_session_id?: string;
-    gpus: WorkerGPU[];
-    cpus: WorkerCPU[];
-    rams: WorkerRAM[];
+    resource: EntitlementResource;
+    type: EntitlementType;
+    enabled: boolean;
+    unlimited: boolean;
+    limit: number;
+    source: EntitlementSource;
+    enforcement: EnforcementMode;
+    expires_at?: string;
 }
 /**
  * FileMetadata holds probed media metadata cached on File records.
@@ -1588,6 +1103,9 @@ export interface FileMetadata {
     channels?: number;
     codec?: string;
 }
+/**
+ * FileDTO for API responses
+ */
 export interface FileDTO extends BaseModelDTO, PermissionModelDTO {
     path: string;
     remote_path: string;
@@ -1600,50 +1118,9 @@ export interface FileDTO extends BaseModelDTO, PermissionModelDTO {
     rating: ContentRating;
     metadata?: FileMetadata;
 }
-export interface FlowVersion extends BaseModel {
-    /**
-     * 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;
-    /**
-     * ConfigHash for deduplication - SHA256 of config content
-     */
-    config_hash: string;
-    /**
-     * GraphVersion is an incrementing counter for optimistic locking on action-based edits
-     */
-    graph_version: number;
-    /**
-     * Flow graph configuration
-     */
-    input_schema: any;
-    input: FlowRunInputs;
-    output_schema: any;
-    output_mappings: OutputMappings;
-    node_data: FlowNodeDataMap;
-    nodes: FlowNode[];
-    edges: FlowEdge[];
-    viewport?: FlowViewport;
-}
-export interface FlowViewport {
-    x: number;
-    y: number;
-    zoom: number;
-}
-export interface FlowNode {
-    id: string;
-    type: string;
-    position: FlowNodePosition;
-}
-export interface FlowNodePosition {
-    x: number;
-    y: number;
-}
+/**
+ * FlowNodeData describes a node's data within a flow
+ */
 export interface FlowNodeData {
     app?: AppDTO;
     app_id: string;
@@ -1656,50 +1133,25 @@ export interface FlowNodeData {
     task?: TaskDTO;
     task_id?: string;
 }
+/**
+ * FlowNodeDataMap maps node IDs to their data
+ */
 export type FlowNodeDataMap = {
     [key: string]: FlowNodeData;
 };
-export interface FlowEdge {
-    id: string;
-    type: string;
-    source: string;
-    target: string;
-    source_handle?: string;
-    target_handle?: string;
-}
-/**
- * OutputFieldMapping represents a mapping from a source node's field to an output field in the flow output schema.
- */
-export interface OutputFieldMapping {
-    sourceNodeId: string;
-    sourceFieldPath: string;
-    outputFieldName: string;
-    type: string;
-    schema: any;
-}
 /**
- * OutputMappings is a map of output field name to OutputFieldMapping.
+ * FlowDTO for API responses
  */
-export type OutputMappings = {
-    [key: string]: OutputFieldMapping;
-};
 export interface FlowDTO extends BaseModelDTO, PermissionModelDTO {
     name: string;
     description: string;
     card_image: string;
     thumbnail: string;
     banner_image: string;
-    /**
-     * Version references
-     */
     draft_version_id: string;
     draft_version?: FlowVersionDTO;
     published_version_id: string;
     published_version?: FlowVersionDTO;
-    /**
-     * Flattened draft version fields for backward compatibility
-     * These come from the draft version (the editable one)
-     */
     input_schema: any;
     input: FlowRunInputs;
     output_schema: any;
@@ -1709,6 +1161,9 @@ export interface FlowDTO extends BaseModelDTO, PermissionModelDTO {
     edges: FlowEdge[];
     viewport?: FlowViewport;
 }
+/**
+ * FlowVersionDTO for API responses
+ */
 export interface FlowVersionDTO extends BaseModelDTO {
     graph_version: number;
     input_schema: any;
@@ -1720,17 +1175,16 @@ export interface FlowVersionDTO extends BaseModelDTO {
     edges: FlowEdge[];
     viewport?: FlowViewport;
 }
+/**
+ * NodeTaskDTO represents a node task reference
+ */
 export interface NodeTaskDTO {
     task_id: string;
     task?: TaskDTO;
 }
-export type FlowRunStatus = number;
-export declare const FlowRunStatusUnknown: FlowRunStatus;
-export declare const FlowRunStatusPending: FlowRunStatus;
-export declare const FlowRunStatusRunning: FlowRunStatus;
-export declare const FlowRunStatusCompleted: FlowRunStatus;
-export declare const FlowRunStatusFailed: FlowRunStatus;
-export declare const FlowRunStatusCancelled: FlowRunStatus;
+/**
+ * FlowRunDTO for API responses
+ */
 export interface FlowRunDTO extends BaseModelDTO, PermissionModelDTO {
     flow_id: string;
     flow_version_id: string;
@@ -1748,56 +1202,6 @@ export interface FlowRunDTO extends BaseModelDTO, PermissionModelDTO {
         [key: string]: NodeTaskDTO | undefined;
     };
 }
-/**
- * Connection represents a connection between nodes in a flow
- */
-export interface FlowNodeConnection {
-    nodeId: string;
-    key: string;
-    type: string;
-    previousValue: any;
-}
-export type FlowRunInputs = {
-    [key: string]: {
-        [key: string]: FlowRunInput;
-    };
-};
-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;
-export declare const GraphEdgeTypeParent: GraphEdgeType;
-export declare const GraphEdgeTypeAncestor: GraphEdgeType;
-export declare const GraphEdgeTypeDuplicate: GraphEdgeType;
 /**
  * GraphNodeDTO is the API representation of a graph node
  */
@@ -1829,18 +1233,73 @@ 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
+ * InstanceDTO is the API representation of a cloud instance.
  */
-export type StringSlice = string[];
+export interface InstanceDTO extends BaseModelDTO, PermissionModelDTO {
+    cloud: InstanceCloudProvider;
+    name: string;
+    region: string;
+    shade_cloud: boolean;
+    shade_instance_type: string;
+    cloud_instance_type: string;
+    cloud_assigned_id: string;
+    os?: string;
+    ssh_key_id?: string;
+    ssh_user: string;
+    ssh_port: number;
+    ip: string;
+    status: InstanceStatus;
+    cost_estimate: string;
+    hourly_price: number;
+    template_id?: string;
+    volume_ids?: string[];
+    tags?: string[];
+    configuration?: any;
+    launch_configuration?: any;
+    auto_delete?: any;
+    alert?: any;
+    volume_mount?: any;
+    envs?: any;
+}
+/**
+ * InstanceTypeDTO is the API representation of a cloud instance type.
+ */
+export interface InstanceTypeDTO extends BaseModelDTO, PermissionModelDTO {
+    cloud: InstanceCloudProvider;
+    region: string;
+    shade_instance_type: string;
+    cloud_instance_type: string;
+    deployment_type: InstanceTypeDeploymentType;
+    hourly_price: number;
+    configuration?: InstanceTypeConfiguration;
+    availability: InstanceTypeAvailability[];
+    boot_time?: InstanceTypeBootTime;
+}
+export interface InstanceTypeConfiguration {
+    gpu_type: string;
+    interconnect: string;
+    memory_in_gb: number;
+    num_gpus: number;
+    os_options: string[];
+    storage_in_gb: number;
+    vcpus: number;
+    vram_per_gpu_in_gb: number;
+}
+export interface InstanceTypeAvailability {
+    available: boolean;
+    region: string;
+}
+export interface InstanceTypeBootTime {
+    average_seconds: number;
+    updated_at: string;
+    sample_size: number;
+}
 /**
  * IntegrationDTO for API responses (never exposes tokens)
  */
@@ -1863,7 +1322,36 @@ export interface IntegrationDTO extends BaseModelDTO, PermissionModelDTO {
     error_message?: string;
 }
 /**
- * KnowledgeFile represents a file in a knowledge entry (stored as JSONB in knowledge_versions)
+ * IntegrationConfigDTO is the API response for integration configuration
+ */
+export interface IntegrationConfigDTO {
+    provider: string;
+    type: string;
+    auth: string;
+    name: string;
+    short_name: string;
+    description: string;
+    icon_url?: string;
+    how_it_works?: string[];
+    docs_url?: string;
+    secret_fields?: SecretFieldConfig[];
+    allows_byok: boolean;
+    available: boolean;
+    has_managed: boolean;
+    integration?: IntegrationDTO;
+}
+/**
+ * SecretFieldConfig defines a secret field for the UI
+ */
+export interface SecretFieldConfig {
+    key: string;
+    label: string;
+    placeholder: string;
+    sensitive: boolean;
+    optional: boolean;
+}
+/**
+ * KnowledgeFile represents a file in a knowledge entry
  */
 export interface KnowledgeFile {
     path: string;
@@ -1872,7 +1360,62 @@ export interface KnowledgeFile {
     hash: string;
     content?: string;
 }
-export type SkillFile = KnowledgeFile;
+/**
+ * SkillDTO for API responses (backward-compatible naming)
+ */
+export interface SkillDTO extends BaseModelDTO, PermissionModelDTO {
+    namespace: string;
+    name: string;
+    description: string;
+    repo_url?: string;
+    version_id: string;
+    version?: SkillVersionDTO;
+}
+export interface SkillVersionDTO extends BaseModelDTO {
+    skill_id: string;
+    instructions: KnowledgeFile;
+    files: KnowledgeFile[];
+    content_hash: string;
+    description: string;
+    tags: string[];
+    allowed_tools?: string;
+    compatibility?: string;
+    license?: string;
+    source_url?: string;
+    mutation_type?: string;
+    version_notes?: string;
+    disable_model_invocation?: boolean;
+    user_invocable?: boolean;
+    context?: string;
+    metadata?: {
+        [key: string]: string;
+    };
+}
+/**
+ * SkillLineageResponse is returned by the lineage endpoint.
+ */
+export interface SkillLineageResponse {
+    skill: SkillLineageSkillRef;
+    parents: SkillLineageSkillRef[];
+    siblings: SkillLineageSkillRef[];
+    forks: SkillLineageSkillRef[];
+    duplicates: SkillLineageSkillRef[];
+    fork_depth: number;
+}
+/**
+ * SkillLineageSkillRef is a compact skill reference for lineage responses.
+ */
+export interface SkillLineageSkillRef {
+    id: string;
+    namespace: string;
+    name: string;
+    version_count?: number;
+    parent_version_id?: string;
+    versions_since_fork?: number;
+}
+/**
+ * PublicSkillStoreDTO for public skill store display
+ */
 export interface PublicSkillStoreDTO {
     id: string;
     category: string;
@@ -1884,41 +1427,72 @@ export interface PublicSkillStoreDTO {
     rank: number;
     has_approved_version: boolean;
 }
-export type PageStatus = number;
-export declare const PageStatusUnknown: PageStatus;
-export declare const PageStatusDraft: PageStatus;
-export declare const PageStatusPublished: PageStatus;
-export declare const PageStatusArchived: PageStatus;
+/**
+ * SkillStoreListingDTO for API responses
+ */
+export interface SkillStoreListingDTO {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string;
+    category: string;
+    is_featured: boolean;
+    rank: number;
+    installs: number;
+    uses: number;
+    tags?: string[];
+}
+/**
+ * StringSlice is a custom type for storing string slices
+ */
+export type StringSlice = string[];
+/**
+ * NotificationPreferencesDTO is the data transfer object
+ */
+export interface NotificationPreferencesDTO extends BaseModelDTO, PermissionModelDTO {
+    email_enabled: boolean;
+    sms_enabled: boolean;
+    push_enabled: boolean;
+    slack_enabled: boolean;
+    billing_notifications: boolean;
+    task_notifications: boolean;
+    system_notifications: boolean;
+    marketing_emails: boolean;
+    quiet_hours_enabled: boolean;
+    quiet_hours_start?: string;
+    quiet_hours_end?: string;
+    timezone: string;
+}
+/**
+ * UpdateNotificationPreferencesRequest is the request to update preferences
+ */
+export interface UpdateNotificationPreferencesRequest {
+    email_enabled?: boolean;
+    sms_enabled?: boolean;
+    push_enabled?: boolean;
+    slack_enabled?: boolean;
+    billing_notifications?: boolean;
+    task_notifications?: boolean;
+    system_notifications?: boolean;
+    marketing_emails?: boolean;
+    quiet_hours_enabled?: boolean;
+    quiet_hours_start?: string;
+    quiet_hours_end?: string;
+    timezone?: string;
+}
+/**
+ * PageMetadata holds metadata for a page
+ */
 export interface PageMetadata {
     title: string;
     description: string;
     image: string;
     tags: string[];
-    /**
-     * Docs-specific fields
-     */
     order?: number;
     type?: string;
     icon?: string;
     hide_from_nav?: boolean;
 }
-/**
- * PageType represents the type of page content
- */
-export type PageType = string;
-export declare const PageTypeDoc: PageType;
-export declare const PageTypeBlog: PageType;
-export declare const PageTypePage: PageType;
-export interface PageDTO extends BaseModelDTO, PermissionModelDTO {
-    is_featured: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
-    status: PageStatus;
-    type: PageType;
-    metadata: PageMetadata;
-    slug: string;
-}
 /**
  * MenuItem represents an item in a menu (can be nested)
  */
@@ -1934,47 +1508,35 @@ export interface MenuItem {
     expanded?: boolean;
     children?: MenuItem[];
 }
-export interface MenuDTO extends BaseModelDTO, PermissionModelDTO {
-    name: string;
-    slug: string;
-    description: string;
-    items: MenuItem[];
-}
 /**
- * ProjectType represents different types of projects
+ * PageDTO for API responses
  */
-export type ProjectType = string;
-export declare const ProjectTypeAgent: ProjectType;
-export declare const ProjectTypeApp: ProjectType;
-export declare const ProjectTypeFlow: ProjectType;
-export declare const ProjectTypeOther: ProjectType;
+export interface PageDTO extends BaseModelDTO, PermissionModelDTO {
+    is_featured: boolean;
+    title: string;
+    content: string;
+    excerpt: string;
+    status: PageStatus;
+    type: PageType;
+    metadata: PageMetadata;
+    slug: string;
+}
 /**
- * ProjectModel provides optional project association for models
+ * MenuDTO for API responses
  */
-export interface ProjectModel {
-    project_id?: string;
-    project?: Project;
+export interface MenuDTO extends BaseModelDTO, PermissionModelDTO {
+    name: string;
+    slug: string;
+    description: string;
+    items: MenuItem[];
 }
+/**
+ * ProjectModelDTO provides optional project association for DTOs
+ */
 export interface ProjectModelDTO {
     project_id?: string;
     project?: ProjectDTO;
 }
-/**
- * Project represents a container for organizing related resources
- */
-export interface Project extends BaseModel, PermissionModel {
-    name: string;
-    description: string;
-    type: ProjectType;
-    color?: string;
-    icon?: string;
-    /**
-     * For future: nested folders/projects
-     */
-    parent_id?: string;
-    parent?: Project;
-    children: (Project | undefined)[];
-}
 /**
  * ProjectDTO for API responses
  */
@@ -1988,44 +1550,6 @@ export interface ProjectDTO extends BaseModelDTO, PermissionModelDTO {
     parent?: ProjectDTO;
     children: (ProjectDTO | undefined)[];
 }
-export type ContentRating = string;
-export declare const ContentSafe: ContentRating;
-/**
- * sexual content
- */
-export declare const ContentSexualSuggestive: ContentRating;
-export declare const ContentSexualExplicit: ContentRating;
-/**
- * violence
- */
-export declare const ContentViolenceNonGraphic: ContentRating;
-export declare const ContentViolenceGraphic: ContentRating;
-/**
- * gore
- */
-export declare const ContentGore: ContentRating;
-/**
- * other regulated content
- */
-export declare const ContentDrugs: ContentRating;
-export declare const ContentSelfHarm: ContentRating;
-export declare const ContentUnrated: ContentRating;
-/**
- * SecretRequirement defines a secret that an app requires to run
- */
-export interface SecretRequirement {
-    key: string;
-    description?: string;
-    optional?: boolean;
-}
-/**
- * IntegrationRequirement defines an integration capability that an app requires
- */
-export interface IntegrationRequirement {
-    key: string;
-    description?: string;
-    optional?: boolean;
-}
 /**
  * RequirementError represents a single missing requirement with actionable info
  */
@@ -2043,94 +1567,27 @@ export interface SetupAction {
     provider?: string;
     scopes?: string[];
 }
-export type InstanceCloudProvider = string;
-export declare const CloudAWS: InstanceCloudProvider;
-export declare const CloudAzure: InstanceCloudProvider;
-export declare const CloudLambdaLabs: InstanceCloudProvider;
-export declare const CloudTensorDock: InstanceCloudProvider;
-export declare const CloudRunPod: InstanceCloudProvider;
-export declare const CloudLatitude: InstanceCloudProvider;
-export declare const CloudJarvisLabs: InstanceCloudProvider;
-export declare const CloudOblivus: InstanceCloudProvider;
-export declare const CloudPaperspace: InstanceCloudProvider;
-export declare const CloudDatacrunch: InstanceCloudProvider;
-export declare const CloudMassedCompute: InstanceCloudProvider;
-export declare const CloudVultr: InstanceCloudProvider;
-export declare const CloudShade: InstanceCloudProvider;
-export type InstanceStatus = string;
-export declare const InstanceStatusPending: InstanceStatus;
-export declare const InstanceStatusActive: InstanceStatus;
-export declare const InstanceStatusDeleted: InstanceStatus;
-export interface Instance extends BaseModel, PermissionModel {
-    cloud: InstanceCloudProvider;
-    name: string;
-    region: string;
-    shade_cloud: boolean;
-    shade_instance_type: string;
-    cloud_instance_type: string;
-    cloud_assigned_id: string;
-    os?: string;
-    ssh_key_id?: string;
-    ssh_user: string;
-    ssh_port: number;
-    ip: string;
-    status: InstanceStatus;
-    cost_estimate: string;
-    hourly_price: number;
-    template_id?: string;
-    volume_ids?: string[];
-    tags?: string[];
-    configuration?: InstanceConfiguration;
-    launch_configuration?: InstanceLaunchConfiguration;
-    auto_delete?: InstanceThresholdConfig;
-    alert?: InstanceThresholdConfig;
-    volume_mount?: InstanceVolumeMountConfig;
-    envs?: InstanceEnvVar[];
-}
-export interface InstanceConfiguration {
-    gpu_type: string;
-    interconnect: string;
-    memory_in_gb: number;
-    num_gpus: number;
-    os: string;
-    storage_in_gb: number;
-    vcpus: number;
-    vram_per_gpu_in_gb: number;
-}
-export interface InstanceLaunchConfiguration {
-    type: string;
-    docker_configuration?: InstanceDockerConfig;
-    script_configuration?: InstanceScriptConfig;
-}
-export interface InstanceDockerConfig {
-    image: string;
-    args?: string;
-    shared_memory_in_gb?: number;
-    envs?: InstanceEnvVar[];
-    port_mappings?: InstancePortMapping[];
-    volume_mounts?: InstanceVolumeMount[];
-}
-export interface InstanceScriptConfig {
-    base64_script: string;
-}
-export interface InstancePortMapping {
-    host_port: number;
-    container_port: number;
-}
-export interface InstanceVolumeMount {
-    host_path: string;
-    container_path: string;
-}
-export interface InstanceThresholdConfig {
-    date_threshold?: string;
-    spend_threshold?: string;
+/**
+ * CheckRequirementsRequest is the request body for checking requirements
+ */
+export interface CheckRequirementsRequest {
+    secrets?: SecretRequirement[];
+    integrations?: IntegrationRequirement[];
 }
-export interface InstanceVolumeMountConfig {
-    auto: boolean;
+/**
+ * CheckRequirementsResponse is the API response for checking requirements
+ */
+export interface CheckRequirementsResponse {
+    satisfied: boolean;
+    errors?: RequirementError[];
 }
-export interface InstanceEnvVar {
-    name: string;
-    value: string;
+/**
+ * SDKTypes is a phantom type for gotypegen dependency tracing.
+ * Types listed here (and their transitive dependencies) are included
+ * in the generated SDK output (TypeScript, Python, Go).
+ * To expose a type to SDK consumers: reference it in this struct.
+ */
+export interface SDKTypes {
 }
 /**
  * Hardware/System related types
@@ -2229,7 +1686,7 @@ export interface CachedRepoInfo {
     size_on_disk_str: string;
     nb_files: number;
     refs: string[];
-    Revisions: CachedRevisionInfo[];
+    revisions: CachedRevisionInfo[];
 }
 /**
  * HFCacheInfo represents information about the Huggingface cache
@@ -2241,47 +1698,9 @@ export interface HFCacheInfo {
     warnings: string[];
 }
 /**
- * TaskStatus represents the state of a task in its lifecycle.
- * DESIGN NOTES:
- * - Stored as int in DB for compact storage. New statuses can be added with any int value.
- * - Logical ordering is defined by statusOrder map, NOT by the int values.
- * - To add a new status: add const with next available int, add to statusOrder at correct position.
- * - SQL queries use explicit lists (IN, NOT IN) via helper functions, not range comparisons.
- * - This design allows future migration to string-based storage without breaking changes.
- */
-export type TaskStatus = number;
-export declare const TaskStatusUnknown: TaskStatus;
-export declare const TaskStatusReceived: TaskStatus;
-export declare const TaskStatusQueued: TaskStatus;
-export declare const TaskStatusDispatched: TaskStatus;
-export declare const TaskStatusPreparing: TaskStatus;
-export declare const TaskStatusServing: TaskStatus;
-export declare const TaskStatusSettingUp: TaskStatus;
-export declare const TaskStatusRunning: TaskStatus;
-export declare const TaskStatusCancelling: TaskStatus;
-export declare const TaskStatusUploading: TaskStatus;
-export declare const TaskStatusCompleted: TaskStatus;
-export declare const TaskStatusFailed: TaskStatus;
-export declare const TaskStatusCancelled: TaskStatus;
-export type Infra = string;
-export declare const InfraPrivate: Infra;
-export declare const InfraCloud: Infra;
-export declare const InfraPrivateFirst: Infra;
-/**
- * TaskAction defines an action to execute when a task reaches a specific status.
- * Used by the action projector to trigger side effects (e.g., updating app covers).
- */
-export interface TaskAction {
-    key: string;
-    on: string;
-    params?: any;
-}
-/**
- * TaskMetadata holds optional metadata attached to a task.
+ * TaskEvent represents a single status transition event.
+ * Duplicated here (no gorm tags) so DTOs can reference it without importing models.
  */
-export interface TaskMetadata {
-    action?: TaskAction;
-}
 export interface TaskEvent {
     id: string;
     created_at: string;
@@ -2289,12 +1708,9 @@ export interface TaskEvent {
     task_id: string;
     status: TaskStatus;
 }
-export type TaskLogType = number;
-export declare const TaskLogTypeBuild: TaskLogType;
-export declare const TaskLogTypeRun: TaskLogType;
-export declare const TaskLogTypeServe: TaskLogType;
-export declare const TaskLogTypeSetup: TaskLogType;
-export declare const TaskLogTypeTask: TaskLogType;
+/**
+ * TaskLog represents a single log entry for a task.
+ */
 export interface TaskLog {
     id: string;
     created_at: string;
@@ -2303,6 +1719,9 @@ export interface TaskLog {
     log_type: TaskLogType;
     content: string;
 }
+/**
+ * TaskDTO is the full API response for a task.
+ */
 export interface TaskDTO extends BaseModelDTO, PermissionModelDTO {
     graph_id?: string;
     user_public_key: string;
@@ -2324,9 +1743,9 @@ export interface TaskDTO extends BaseModelDTO, PermissionModelDTO {
     agent_version_id?: string;
     agent?: AgentDTO;
     engine_id?: string;
-    engine?: EngineStateSummary;
+    engine?: EngineSummary;
     worker_id?: string;
-    worker?: WorkerStateSummary;
+    worker?: WorkerSummary;
     run_at?: string;
     webhook?: string;
     setup?: any;
@@ -2336,51 +1755,32 @@ export interface TaskDTO extends BaseModelDTO, PermissionModelDTO {
     rating: ContentRating;
     events: TaskEvent[];
     logs: TaskLog[];
-    usage_events: (UsageEvent | undefined)[];
+    usage_events: (UsageEventDTO | undefined)[];
     session_id?: string;
     session_timeout?: number;
 }
-export type TeamType = string;
-export declare const TeamTypePersonal: TeamType;
-export declare const TeamTypeTeam: TeamType;
-export declare const TeamTypeSystem: TeamType;
-export type TeamStatus = string;
-export declare const TeamStatusActive: TeamStatus;
-export declare const TeamStatusSuspended: TeamStatus;
-export declare const TeamStatusTerminated: TeamStatus;
-export interface Team extends BaseModel {
-    type: TeamType;
-    username: string;
-    email: string;
-    name: string;
-    avatar_url: string;
-    /**
-     * SetupCompleted indicates whether the team has completed initial setup (chosen a username)
-     * Personal teams start with SetupCompleted=false and a generated temporary username
-     */
-    setup_completed: boolean;
-    /**
-     * MaxConcurrency limits total active tasks for this team (0 = use default)
-     */
-    max_concurrency: number;
-    status: TeamStatus;
+/**
+ * TeamMemberDTO is the API response for a team member.
+ */
+export interface TeamMemberDTO {
+    id: string;
+    user_id: string;
+    team_id: string;
+    role: TeamRole;
+    user?: TeamMemberUserDTO;
 }
-export interface TeamDTO extends BaseModelDTO {
-    type: TeamType;
+/**
+ * TeamMemberUserDTO is a lightweight user view within team membership.
+ */
+export interface TeamMemberUserDTO {
+    id: string;
+    email: string;
     name: string;
-    username: string;
+    full_name: string;
     avatar_url: string;
-    email: string;
-    setup_completed: boolean;
-    max_concurrency: number;
-    status: TeamStatus;
 }
-export type TeamRole = string;
-export declare const TeamRoleOwner: TeamRole;
-export declare const TeamRoleAdmin: TeamRole;
-export declare const TeamRoleMember: TeamRole;
 /**
- * Team-related types
+ * TeamRelationDTO is a lightweight team reference embedded in other DTOs.
  */
 export interface TeamRelationDTO {
     id: string;
@@ -2391,6 +1791,27 @@ export interface TeamRelationDTO {
     avatar_url: string;
     setup_completed: boolean;
 }
+/**
+ * TeamInviteDTO is the public representation of an invite
+ */
+export interface TeamInviteDTO {
+    id: string;
+    team_id: string;
+    email: string;
+    role: TeamRole;
+    status: TeamInviteStatus;
+    expires_at: string;
+    created_at: string;
+    invited_by?: TeamMemberUserDTO;
+    team?: TeamRelationDTO;
+}
+/**
+ * TeamInviteCreateRequest is used when creating a team invite
+ */
+export interface TeamInviteCreateRequest {
+    email: string;
+    role: TeamRole;
+}
 /**
  * ToolInvocationFunction contains the function details for a tool invocation
  */
@@ -2398,17 +1819,6 @@ export interface ToolInvocationFunction {
     name: string;
     arguments: StringEncodedMap;
 }
-/**
- * ToolInvocationStatus represents the execution status of a tool invocation
- */
-export type ToolInvocationStatus = string;
-export declare const ToolInvocationStatusPending: ToolInvocationStatus;
-export declare const ToolInvocationStatusInProgress: ToolInvocationStatus;
-export declare const ToolInvocationStatusAwaitingInput: ToolInvocationStatus;
-export declare const ToolInvocationStatusAwaitingApproval: ToolInvocationStatus;
-export declare const ToolInvocationStatusCompleted: ToolInvocationStatus;
-export declare const ToolInvocationStatusFailed: ToolInvocationStatus;
-export declare const ToolInvocationStatusCancelled: ToolInvocationStatus;
 /**
  * ToolInvocationDTO for API responses
  */
@@ -2421,49 +1831,43 @@ export interface ToolInvocationDTO extends BaseModelDTO, PermissionModelDTO {
     function: ToolInvocationFunction;
     status: ToolInvocationStatus;
     result?: string;
-    /**
-     * Unified fields
-     */
     data?: any;
     widget?: Widget;
 }
-export interface Tool {
-    type: string;
-    function: ToolFunction;
+/**
+ * MetaItem represents metadata about an input or output item
+ */
+export interface MetaItem {
+    type: MetaItemType;
+    tokens?: number;
+    width?: number;
+    height?: number;
+    resolution_mp?: number;
+    steps?: number;
+    count?: number;
+    resolution?: VideoResolution;
+    seconds?: number;
+    fps?: number;
+    sample_rate?: number;
+    cost?: number;
+    extra?: {
+        [key: string]: any;
+    };
 }
-export interface ToolFunction {
-    name: string;
-    description: string;
-    parameters?: ToolParameters;
-    required?: string[];
+/**
+ * OutputMeta contains structured metadata about task inputs and outputs for pricing calculation
+ */
+export interface OutputMeta {
+    inputs: MetaItem[];
+    outputs: MetaItem[];
 }
-export interface ToolParameters {
-    type: string;
-    title: string;
-    properties?: ToolParameterProperties;
-    required?: string[];
-}
-export type ToolParameterProperties = {
-    [key: string]: ToolParameterProperty;
-};
-export interface ToolParameterProperty {
-    type: string;
-    title: string;
-    description: string;
-    properties?: ToolParameterProperties;
-    items?: ToolParameterProperty;
-    required?: string[];
-}
-export type UsageEventResourceTier = string;
-export declare const UsageEventResourceTierPrivate: UsageEventResourceTier;
-export declare const UsageEventResourceTierCloud: UsageEventResourceTier;
-export interface UsageEvent extends BaseModel, PermissionModel {
+/**
+ * UsageEventDTO is the API representation of a usage event.
+ */
+export interface UsageEventDTO extends BaseModelDTO, PermissionModelDTO {
     usage_billing_record_id: string;
     reference_id: string;
     resource_id: string;
-    /**
-     * Resource tier
-     */
     tier: UsageEventResourceTier;
     type: string;
     model: string;
@@ -2471,24 +1875,8 @@ export interface UsageEvent extends BaseModel, PermissionModel {
     unit: string;
 }
 /**
- * User-related types
+ * UserDTO is the API response for a full user.
  */
-export interface User {
-    BaseModel: BaseModel;
-    default_team_id: string;
-    role: Role;
-    email: string;
-    email_verified: boolean;
-    name: string;
-    full_name: string;
-    avatar_url: string;
-    metadata: UserMetadata;
-}
-export type Role = string;
-export declare const RoleGuest: Role;
-export declare const RoleUser: Role;
-export declare const RoleAdmin: Role;
-export declare const RoleSystem: Role;
 export interface UserDTO extends BaseModelDTO {
     default_team_id: string;
     role: Role;
@@ -2496,10 +1884,10 @@ export interface UserDTO extends BaseModelDTO {
     name: string;
     full_name: string;
     avatar_url: string;
-    metadata: UserMetadata;
+    metadata?: UserMetadataDTO;
 }
 /**
- * User-related types
+ * UserRelationDTO is a lightweight user reference embedded in other DTOs.
  */
 export interface UserRelationDTO {
     id: string;
@@ -2508,7 +1896,10 @@ export interface UserRelationDTO {
     role: Role;
     avatar_url: string;
 }
-export interface UserMetadata {
+/**
+ * UserMetadataDTO is the API representation of user metadata.
+ */
+export interface UserMetadataDTO {
     user_id: string;
     completed_onboarding: boolean;
     use_case: string;
@@ -2533,56 +1924,6 @@ export interface WidgetActionButton {
     action: WidgetAction;
     variant?: string;
 }
-/**
- * WidgetNodeType constants
- * Primitives (literal values): text, markdown, image, badge, button, input, select, checkbox, row, col
- * Data-bound (read from ToolInvocation.Data): plan-list, key-value, status-badge
- */
-export type WidgetNodeType = string;
-/**
- * Primitive node types (render literal values)
- */
-export declare const WidgetNodeTypeText: WidgetNodeType;
-export declare const WidgetNodeTypeMarkdown: WidgetNodeType;
-export declare const WidgetNodeTypeImage: WidgetNodeType;
-export declare const WidgetNodeTypeBadge: WidgetNodeType;
-export declare const WidgetNodeTypeButton: WidgetNodeType;
-export declare const WidgetNodeTypeInput: WidgetNodeType;
-export declare const WidgetNodeTypeSelect: WidgetNodeType;
-export declare const WidgetNodeTypeCheckbox: WidgetNodeType;
-export declare const WidgetNodeTypeRow: WidgetNodeType;
-export declare const WidgetNodeTypeCol: WidgetNodeType;
-/**
- * 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;
-export declare const WidgetNodeTypeStatusBadge: WidgetNodeType;
 /**
  * WidgetNode represents a UI element in a widget (text, input, select, etc.)
  */
@@ -2684,3 +2025,597 @@ export interface Widget {
     children?: WidgetNode[];
     actions?: WidgetActionButton[];
 }
+export type AppCategory = string;
+export declare const AppCategoryImage: AppCategory;
+export declare const AppCategoryVideo: AppCategory;
+export declare const AppCategoryAudio: AppCategory;
+export declare const AppCategoryText: AppCategory;
+export declare const AppCategoryChat: AppCategory;
+export declare const AppCategory3D: AppCategory;
+export declare const AppCategoryOther: AppCategory;
+export declare const AppCategoryFlow: AppCategory;
+export type GPUType = string;
+export declare const GPUTypeAny: GPUType;
+export declare const GPUTypeNone: GPUType;
+export declare const GPUTypeIntel: GPUType;
+export declare const GPUTypeNvidia: GPUType;
+export declare const GPUTypeAMD: GPUType;
+export declare const GPUTypeApple: GPUType;
+/**
+ * Visibility represents the visibility level of a resource
+ */
+export type Visibility = string;
+export declare const VisibilityPrivate: Visibility;
+export declare const VisibilityPublic: Visibility;
+export declare const VisibilityUnlisted: Visibility;
+export type ChatStatus = string;
+export declare const ChatStatusBusy: ChatStatus;
+export declare const ChatStatusIdle: ChatStatus;
+export declare const ChatStatusAwaitingInput: ChatStatus;
+export declare const ChatStatusCompleted: ChatStatus;
+export type PlanStepStatus = string;
+export declare const PlanStepStatusPending: PlanStepStatus;
+export declare const PlanStepStatusInProgress: PlanStepStatus;
+export declare const PlanStepStatusCompleted: PlanStepStatus;
+export declare const PlanStepStatusCancelled: PlanStepStatus;
+export type ChatMessageRole = string;
+export declare const ChatMessageRoleSystem: ChatMessageRole;
+export declare const ChatMessageRoleUser: ChatMessageRole;
+export declare const ChatMessageRoleAssistant: ChatMessageRole;
+export declare const ChatMessageRoleTool: ChatMessageRole;
+export type ChatMessageStatus = string;
+export declare const ChatMessageStatusPending: ChatMessageStatus;
+export declare const ChatMessageStatusReady: ChatMessageStatus;
+export declare const ChatMessageStatusFailed: ChatMessageStatus;
+export declare const ChatMessageStatusCancelled: ChatMessageStatus;
+export type ChatMessageContentType = string;
+export declare const ChatMessageContentTypeText: ChatMessageContentType;
+export declare const ChatMessageContentTypeReasoning: ChatMessageContentType;
+export declare const ChatMessageContentTypeImage: ChatMessageContentType;
+export declare const ChatMessageContentTypeFile: ChatMessageContentType;
+export declare const ChatMessageContentTypeTool: ChatMessageContentType;
+/**
+ * ChatData contains agent-specific data for a chat session
+ */
+export interface ChatData {
+    plan_steps: PlanStep[];
+    memory: StringEncodedMap;
+    always_allowed_tools: string[];
+}
+/**
+ * PlanStep represents a step in an agent's execution plan
+ */
+export interface PlanStep {
+    index: number;
+    title: string;
+    description: string;
+    notes?: string;
+    status: PlanStepStatus;
+}
+/**
+ * ChatMessageContent represents the content of a chat message
+ */
+export interface ChatMessageContent {
+    type: ChatMessageContentType;
+    error?: string;
+    text?: string;
+    image?: string;
+    file?: string;
+    tool_calls?: ToolCall[];
+}
+/**
+ * ChatTaskInput is the input envelope for a chat LLM task
+ */
+export interface ChatTaskInput {
+    model?: string;
+    context_size: number;
+    temperature?: number;
+    top_p?: number;
+    reasoning_effort?: string;
+    reasoning_max_tokens?: number;
+    system_prompt: string;
+    context: ChatTaskContextMessage[];
+    role?: ChatMessageRole;
+    text?: string;
+    reasoning?: string;
+    /**
+     * Attachments is the SDK input field with full file metadata
+     */
+    attachments?: FileRef[];
+    /**
+     * Images and Files are internal fields for task workers (filled from Attachments or context)
+     */
+    images?: string[];
+    files?: string[];
+    tools?: Tool[];
+    tool_call_id?: string;
+}
+/**
+ * ChatTaskContextMessage represents a message in the chat context for LLM tasks
+ */
+export interface ChatTaskContextMessage {
+    role: ChatMessageRole;
+    text?: string;
+    reasoning?: string;
+    images?: string[];
+    files?: string[];
+    tools?: Tool[];
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+}
+export type StringEncodedMap = {
+    [key: string]: any;
+};
+/**
+ * EngineStatus represents the status of an engine.
+ */
+export type EngineStatus = string;
+export declare const EngineStatusRunning: EngineStatus;
+export declare const EngineStatusPending: EngineStatus;
+export declare const EngineStatusDraining: EngineStatus;
+export declare const EngineStatusStopping: EngineStatus;
+export declare const EngineStatusStopped: EngineStatus;
+/**
+ * WorkerStatus represents the status of a worker.
+ */
+export type WorkerStatus = string;
+export declare const WorkerStatusReserved: WorkerStatus;
+export declare const WorkerStatusBusy: WorkerStatus;
+export declare const WorkerStatusIdle: WorkerStatus;
+export declare const WorkerStatusInactive: WorkerStatus;
+export type FlowRunStatus = number;
+export declare const FlowRunStatusUnknown: FlowRunStatus;
+export declare const FlowRunStatusPending: FlowRunStatus;
+export declare const FlowRunStatusRunning: FlowRunStatus;
+export declare const FlowRunStatusCompleted: FlowRunStatus;
+export declare const FlowRunStatusFailed: FlowRunStatus;
+export declare const FlowRunStatusCancelled: FlowRunStatus;
+/**
+ * FlowViewport represents the viewport state of a flow canvas
+ */
+export interface FlowViewport {
+    x: number;
+    y: number;
+    zoom: number;
+}
+/**
+ * FlowNode represents a node in a flow graph
+ */
+export interface FlowNode {
+    id: string;
+    type: string;
+    position: FlowNodePosition;
+}
+/**
+ * FlowNodePosition represents the position of a node
+ */
+export interface FlowNodePosition {
+    x: number;
+    y: number;
+}
+/**
+ * FlowEdge represents an edge between nodes in a flow graph
+ */
+export interface FlowEdge {
+    id: string;
+    type: string;
+    source: string;
+    target: string;
+    source_handle?: string;
+    target_handle?: string;
+}
+/**
+ * FlowNodeConnection represents a connection between nodes in a flow
+ */
+export interface FlowNodeConnection {
+    nodeId: string;
+    key: string;
+    type: string;
+    previousValue: any;
+}
+/**
+ * FlowRunInputs maps node IDs to their input key-value pairs
+ */
+export type FlowRunInputs = {
+    [key: string]: {
+        [key: string]: FlowRunInput;
+    };
+};
+/**
+ * FlowRunInput represents a single input value or connection for a flow node
+ */
+export interface FlowRunInput {
+    Connection?: FlowNodeConnection;
+    Value: any;
+}
+/**
+ * OutputFieldMapping represents a mapping from a source node's field to an output field
+ */
+export interface OutputFieldMapping {
+    sourceNodeId: string;
+    sourceFieldPath: string;
+    outputFieldName: string;
+    type: string;
+    schema: any;
+}
+/**
+ * OutputMappings is a map of output field name to OutputFieldMapping
+ */
+export type OutputMappings = {
+    [key: string]: OutputFieldMapping;
+};
+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;
+export declare const GraphEdgeTypeParent: GraphEdgeType;
+export declare const GraphEdgeTypeAncestor: GraphEdgeType;
+export declare const GraphEdgeTypeDuplicate: GraphEdgeType;
+export type EntitlementSource = string;
+export declare const EntitlementSourceTier: EntitlementSource;
+export declare const EntitlementSourceOverride: EntitlementSource;
+export declare const EntitlementSourceWhitelist: EntitlementSource;
+export declare const EntitlementSourceTrial: EntitlementSource;
+export type EntitlementType = string;
+export declare const EntitlementTypeBoolean: EntitlementType;
+export declare const EntitlementTypeLimit: EntitlementType;
+/**
+ * EnforcementMode controls how limit violations are handled.
+ */
+export type EnforcementMode = string;
+export declare const EnforcementBlock: EnforcementMode;
+export declare const EnforcementWarn: EnforcementMode;
+export type PageStatus = number;
+export declare const PageStatusUnknown: PageStatus;
+export declare const PageStatusDraft: PageStatus;
+export declare const PageStatusPublished: PageStatus;
+export declare const PageStatusArchived: PageStatus;
+/**
+ * PageType represents the type of page content
+ */
+export type PageType = string;
+export declare const PageTypeDoc: PageType;
+export declare const PageTypeBlog: PageType;
+export declare const PageTypePage: PageType;
+/**
+ * ToolInvocationStatus represents the execution status of a tool invocation
+ */
+export type ToolInvocationStatus = string;
+export declare const ToolInvocationStatusPending: ToolInvocationStatus;
+export declare const ToolInvocationStatusInProgress: ToolInvocationStatus;
+export declare const ToolInvocationStatusAwaitingInput: ToolInvocationStatus;
+export declare const ToolInvocationStatusAwaitingApproval: ToolInvocationStatus;
+export declare const ToolInvocationStatusCompleted: ToolInvocationStatus;
+export declare const ToolInvocationStatusFailed: ToolInvocationStatus;
+export declare const ToolInvocationStatusCancelled: ToolInvocationStatus;
+/**
+ * ToolType represents the type of tool (used in both AgentTool definition and ToolInvocation)
+ */
+export type ToolType = string;
+export declare const ToolTypeApp: ToolType;
+export declare const ToolTypeAgent: ToolType;
+export declare const ToolTypeHook: ToolType;
+export declare const ToolTypeHTTP: ToolType;
+export declare const ToolTypeCall: ToolType;
+export declare const ToolTypeMCP: ToolType;
+export declare const ToolTypeClient: ToolType;
+export declare const ToolTypeInternal: ToolType;
+export type InstanceCloudProvider = string;
+export declare const CloudAWS: InstanceCloudProvider;
+export declare const CloudAzure: InstanceCloudProvider;
+export declare const CloudLambdaLabs: InstanceCloudProvider;
+export declare const CloudTensorDock: InstanceCloudProvider;
+export declare const CloudRunPod: InstanceCloudProvider;
+export declare const CloudLatitude: InstanceCloudProvider;
+export declare const CloudJarvisLabs: InstanceCloudProvider;
+export declare const CloudOblivus: InstanceCloudProvider;
+export declare const CloudPaperspace: InstanceCloudProvider;
+export declare const CloudDatacrunch: InstanceCloudProvider;
+export declare const CloudMassedCompute: InstanceCloudProvider;
+export declare const CloudVultr: InstanceCloudProvider;
+export declare const CloudShade: InstanceCloudProvider;
+export type InstanceStatus = string;
+export declare const InstanceStatusPending: InstanceStatus;
+export declare const InstanceStatusActive: InstanceStatus;
+export declare const InstanceStatusDeleted: InstanceStatus;
+export type InstanceTypeDeploymentType = string;
+export declare const InstanceTypeDeploymentTypeVM: InstanceTypeDeploymentType;
+export declare const InstanceTypeDeploymentTypeContainer: InstanceTypeDeploymentType;
+export declare const InstanceTypeDeploymentTypeBaremetal: InstanceTypeDeploymentType;
+export type AppSessionStatus = string;
+export declare const AppSessionStatusActive: AppSessionStatus;
+export declare const AppSessionStatusEnded: AppSessionStatus;
+export declare const AppSessionStatusExpired: AppSessionStatus;
+/**
+ * ProjectType represents different types of projects
+ */
+export type ProjectType = string;
+export declare const ProjectTypeAgent: ProjectType;
+export declare const ProjectTypeApp: ProjectType;
+export declare const ProjectTypeFlow: ProjectType;
+export declare const ProjectTypeOther: ProjectType;
+export type UsageEventResourceTier = string;
+export declare const UsageEventResourceTierPrivate: UsageEventResourceTier;
+export declare const UsageEventResourceTierCloud: UsageEventResourceTier;
+/**
+ * MetaItemType is the type discriminator for MetaItem
+ */
+export type MetaItemType = string;
+export declare const MetaItemTypeText: MetaItemType;
+export declare const MetaItemTypeImage: MetaItemType;
+export declare const MetaItemTypeVideo: MetaItemType;
+export declare const MetaItemTypeAudio: MetaItemType;
+export declare const MetaItemTypeRaw: MetaItemType;
+/**
+ * VideoResolution represents standard video resolution presets
+ */
+export type VideoResolution = string;
+export declare const VideoRes480P: VideoResolution;
+export declare const VideoRes720P: VideoResolution;
+export declare const VideoRes1080P: VideoResolution;
+export declare const VideoRes1440P: VideoResolution;
+export declare const VideoRes4K: VideoResolution;
+/**
+ * TeamInviteStatus represents the status of a team invitation
+ */
+export type TeamInviteStatus = string;
+export declare const TeamInviteStatusPending: TeamInviteStatus;
+export declare const TeamInviteStatusAccepted: TeamInviteStatus;
+export declare const TeamInviteStatusDeclined: TeamInviteStatus;
+export declare const TeamInviteStatusExpired: TeamInviteStatus;
+export declare const TeamInviteStatusRevoked: TeamInviteStatus;
+export type FilterOperator = string;
+export declare const OpEqual: FilterOperator;
+export declare const OpNotEqual: FilterOperator;
+export declare const OpIn: FilterOperator;
+export declare const OpNotIn: FilterOperator;
+export declare const OpGreater: FilterOperator;
+export declare const OpGreaterEqual: FilterOperator;
+export declare const OpLess: FilterOperator;
+export declare const OpLessEqual: FilterOperator;
+export declare const OpLike: FilterOperator;
+export declare const OpILike: FilterOperator;
+export declare const OpContains: FilterOperator;
+export declare const OpNotContains: FilterOperator;
+export declare const OpIsNull: FilterOperator;
+export declare const OpIsNotNull: FilterOperator;
+export declare const OpIsEmpty: FilterOperator;
+export declare const OpIsNotEmpty: FilterOperator;
+export type EntitlementResource = string;
+export declare const ResourceAPIKeys: EntitlementResource;
+export declare const ResourceConnectors: EntitlementResource;
+export declare const ResourceKnowledgeBases: EntitlementResource;
+export declare const ResourcePrivateApps: EntitlementResource;
+export declare const ResourceStorageMB: EntitlementResource;
+export declare const ResourceConcurrency: EntitlementResource;
+export declare const ResourceRatePerMin: EntitlementResource;
+export declare const ResourceSeats: EntitlementResource;
+export declare const ResourceTaskExecutions: EntitlementResource;
+export declare const ResourceFeatureScopes: EntitlementResource;
+export declare const ResourceFeatureWebhooks: EntitlementResource;
+export declare const ResourceFeatureBYOK: EntitlementResource;
+export declare const ResourceFeatureTeamBilling: EntitlementResource;
+export declare const ResourceFeatureAutoRecharge: EntitlementResource;
+export declare const ResourceFeatureInvoices: EntitlementResource;
+export declare const ResourceFeaturePublishApps: EntitlementResource;
+export type ContentRating = string;
+export declare const ContentSafe: ContentRating;
+export declare const ContentSexualSuggestive: ContentRating;
+export declare const ContentSexualExplicit: ContentRating;
+export declare const ContentViolenceNonGraphic: ContentRating;
+export declare const ContentViolenceGraphic: ContentRating;
+export declare const ContentGore: ContentRating;
+export declare const ContentUnrated: ContentRating;
+export type WidgetNodeType = string;
+export declare const WidgetNodeTypeText: WidgetNodeType;
+export declare const WidgetNodeTypeMarkdown: WidgetNodeType;
+export declare const WidgetNodeTypeImage: WidgetNodeType;
+export declare const WidgetNodeTypeBadge: WidgetNodeType;
+export declare const WidgetNodeTypeButton: WidgetNodeType;
+export declare const WidgetNodeTypeInput: WidgetNodeType;
+export declare const WidgetNodeTypeSelect: WidgetNodeType;
+export declare const WidgetNodeTypeCheckbox: WidgetNodeType;
+export declare const WidgetNodeTypeRow: WidgetNodeType;
+export declare const WidgetNodeTypeCol: WidgetNodeType;
+export declare const WidgetNodeTypeBox: WidgetNodeType;
+export declare const WidgetNodeTypeSpacer: WidgetNodeType;
+export declare const WidgetNodeTypeDivider: WidgetNodeType;
+export declare const WidgetNodeTypeForm: WidgetNodeType;
+export declare const WidgetNodeTypeTitle: WidgetNodeType;
+export declare const WidgetNodeTypeCaption: WidgetNodeType;
+export declare const WidgetNodeTypeLabel: WidgetNodeType;
+export declare const WidgetNodeTypeTextarea: WidgetNodeType;
+export declare const WidgetNodeTypeRadioGroup: WidgetNodeType;
+export declare const WidgetNodeTypeDatePicker: WidgetNodeType;
+export declare const WidgetNodeTypeIcon: WidgetNodeType;
+export declare const WidgetNodeTypeChart: WidgetNodeType;
+export declare const WidgetNodeTypeTransition: WidgetNodeType;
+export declare const WidgetNodeTypePlanList: WidgetNodeType;
+export declare const WidgetNodeTypeKeyValue: WidgetNodeType;
+export declare const WidgetNodeTypeStatusBadge: WidgetNodeType;
+/**
+ * TaskStatus represents the state of a task in its lifecycle.
+ */
+export type TaskStatus = number;
+export declare const TaskStatusUnknown: TaskStatus;
+export declare const TaskStatusReceived: TaskStatus;
+export declare const TaskStatusQueued: TaskStatus;
+export declare const TaskStatusDispatched: TaskStatus;
+export declare const TaskStatusPreparing: TaskStatus;
+export declare const TaskStatusServing: TaskStatus;
+export declare const TaskStatusSettingUp: TaskStatus;
+export declare const TaskStatusRunning: TaskStatus;
+export declare const TaskStatusCancelling: TaskStatus;
+export declare const TaskStatusUploading: TaskStatus;
+export declare const TaskStatusCompleted: TaskStatus;
+export declare const TaskStatusFailed: TaskStatus;
+export declare const TaskStatusCancelled: TaskStatus;
+/**
+ * Infra defines where a task should run.
+ */
+export type Infra = string;
+export declare const InfraPrivate: Infra;
+export declare const InfraCloud: Infra;
+export declare const InfraPrivateFirst: Infra;
+/**
+ * TaskLogType defines the type of task log.
+ */
+export type TaskLogType = number;
+export declare const TaskLogTypeBuild: TaskLogType;
+export declare const TaskLogTypeRun: TaskLogType;
+export declare const TaskLogTypeServe: TaskLogType;
+export declare const TaskLogTypeSetup: TaskLogType;
+export declare const TaskLogTypeTask: TaskLogType;
+/**
+ * TaskAction defines an action to execute when a task reaches a specific status.
+ */
+export interface TaskAction {
+    key: string;
+    on: string;
+    params?: any;
+}
+/**
+ * TaskMetadata holds optional metadata attached to a task.
+ */
+export interface TaskMetadata {
+    action?: TaskAction;
+}
+export type TeamType = string;
+export declare const TeamTypePersonal: TeamType;
+export declare const TeamTypeTeam: TeamType;
+export declare const TeamTypeSystem: TeamType;
+export type TeamStatus = string;
+export declare const TeamStatusActive: TeamStatus;
+export declare const TeamStatusSuspended: TeamStatus;
+export declare const TeamStatusTerminated: TeamStatus;
+export type TeamRole = string;
+export declare const TeamRoleOwner: TeamRole;
+export declare const TeamRoleAdmin: TeamRole;
+export declare const TeamRoleMember: TeamRole;
+/**
+ * ToolCallType represents the type field on a tool call (wire format).
+ */
+export type ToolCallType = string;
+/**
+ * ToolParamType represents a JSON Schema parameter type for tool definitions.
+ */
+export type ToolParamType = string;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolTypeFunction: ToolCallType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeObject: ToolParamType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeString: ToolParamType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeInteger: ToolParamType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeNumber: ToolParamType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeBoolean: ToolParamType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeArray: ToolParamType;
+/**
+ * Tool types and parameter types
+ */
+export declare const ToolParamTypeNull: ToolParamType;
+/**
+ * ToolCall represents a tool call from an LLM response (wire format)
+ * This is a transport object for parsing LLM responses, not a database model
+ */
+export interface ToolCall {
+    id: string;
+    type: ToolCallType;
+    function: ToolCallFunction;
+}
+/**
+ * ToolCallFunction contains the function name and arguments from an LLM tool call
+ */
+export interface ToolCallFunction {
+    name: string;
+    arguments: StringEncodedMap;
+}
+/**
+ * FileRef is a lightweight reference to a file with essential metadata.
+ * Used in chat inputs/context instead of full File objects.
+ */
+export interface FileRef {
+    id?: string;
+    uri: string;
+    filename: string;
+    content_type: string;
+    size?: number;
+}
+/**
+ * Tool represents a tool definition for LLM function calling
+ */
+export interface Tool {
+    type: ToolCallType;
+    function: ToolFunction;
+}
+export interface ToolFunction {
+    name: string;
+    description: string;
+    parameters?: ToolParameters;
+    required?: string[];
+}
+export interface ToolParameters {
+    type: ToolParamType;
+    title: string;
+    properties?: ToolParameterProperties;
+    required?: string[];
+}
+export type ToolParameterProperties = {
+    [key: string]: ToolParameterProperty;
+};
+export interface ToolParameterProperty {
+    type: ToolParamType;
+    title: string;
+    description: string;
+    properties?: ToolParameterProperties;
+    items?: ToolParameterProperty;
+    required?: string[];
+}
+export type Role = string;
+export declare const RoleGuest: Role;
+export declare const RoleUser: Role;
+export declare const RoleAdmin: Role;
+export declare const RoleSystem: Role;