@inferencesh/sdk 0.1.1 → 0.1.3

package/dist/types.d.ts

@@ -5,13 +5,13 @@ export interface ACL {
     deleted_at?: string;
     resource_id: string;
     owner_id: string;
-    group_id?: string;
+    team_id: string;
     owner_read: boolean;
     owner_write: boolean;
     owner_exec: boolean;
-    group_read: boolean;
-    group_write: boolean;
-    group_exec: boolean;
+    team_read: boolean;
+    team_write: boolean;
+    team_exec: boolean;
     other_read: boolean;
     other_write: boolean;
     other_exec: boolean;
@@ -45,6 +45,26 @@ export interface SubAgentDTO {
     agent?: AgentDTO;
     description: string;
 }
+/**
+ * AgentHook represents a webhook that can be called as a tool
+ */
+export interface AgentHook {
+    name: string;
+    description: string;
+    url: string;
+    secret?: string;
+    input_schema?: any;
+}
+/**
+ * AgentHookDTO for API responses
+ */
+export interface AgentHookDTO {
+    name: string;
+    description: string;
+    url: string;
+    secret?: string;
+    input_schema?: any;
+}
 export interface Agent {
     BaseModel: BaseModel;
     PermissionModel: PermissionModel;
@@ -61,14 +81,7 @@ export interface Agent {
 /**
  * AgentDTO for API responses
  */
-export interface AgentDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
-    acl?: ACL;
+export interface AgentDTO extends BaseModel, PermissionModelDTO {
     name: string;
     project_id?: string;
     project?: ProjectDTO;
@@ -86,16 +99,10 @@ export interface AgentVersion {
     core_app?: AgentApp;
     core_app_input?: any;
     sub_agents: (SubAgent | undefined)[];
-    tool_apps: (AgentApp | undefined)[];
+    apps: (AgentApp | undefined)[];
+    hooks: (AgentHook | undefined)[];
 }
-export interface AgentVersionDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
-    acl?: ACL;
+export interface AgentVersionDTO extends BaseModel, PermissionModelDTO {
     description: string;
     system_prompt: string;
     prompt_template: string;
@@ -103,7 +110,8 @@ export interface AgentVersionDTO {
     core_app?: AgentApp;
     core_app_input?: any;
     sub_agents: (SubAgentDTO | undefined)[];
-    tool_apps: (AgentAppDTO | undefined)[];
+    apps: (AgentAppDTO | undefined)[];
+    hooks: (AgentHookDTO | undefined)[];
 }
 /**
  * TimeWindow represents a single analytics time window
@@ -122,9 +130,9 @@ export interface TaskStatusWindow {
     count: number;
 }
 /**
- * AppUsage represents usage statistics for an app
+ * AppAnalytics represents usage statistics for an app
  */
-export interface AppUsage {
+export interface AppAnalytics {
     app_id: string;
     app_username: string;
     app_name: string;
@@ -161,7 +169,7 @@ export interface TotalMetrics {
      * Cloud running engines (acl_other_exec = true)
      */
     cloud_running_engines: number;
-    top_apps: AppUsage[];
+    top_apps: AppAnalytics[];
 }
 /**
  * RealtimeMetrics contains current system state
@@ -258,14 +266,19 @@ export interface RemoteEngineCreateRequest {
     start_time: string;
     end_time: string;
 }
-export interface StripeCheckoutCreateRequest {
+export interface CheckoutCreateRequest {
     amount: number;
     success_url: string;
     cancel_url: string;
 }
-export interface StripeCheckoutCompleteRequest {
+export interface CheckoutCompleteRequest {
     session_id: string;
 }
+/**
+ * Legacy aliases for backward compatibility
+ */
+export type StripeCheckoutCreateRequest = CheckoutCreateRequest;
+export type StripeCheckoutCompleteRequest = CheckoutCompleteRequest;
 export interface EngineCreateResponse {
     engine_state?: EngineState;
 }
@@ -282,6 +295,7 @@ export interface CreateApiKeyRequest {
     name: string;
 }
 export interface CreateTaskRequest {
+    id?: string;
     app_id: string;
     version_id?: string;
     variant?: string;
@@ -295,6 +309,7 @@ export interface CreateTaskRequest {
     agent_id?: string;
     agent_version_id?: string;
     tool_call_id?: string;
+    graph_id?: string;
 }
 export interface CreateAgentMessageRequest {
     chat_id?: string;
@@ -312,6 +327,53 @@ export interface WidgetActionRequest {
     action: WidgetAction;
     form_data?: WidgetFormData;
 }
+/**
+ * ToolResultRequest represents a generic tool result callback
+ * Used by hooks and other tools that expect an async callback
+ */
+export interface ToolResultRequest {
+    result: string;
+}
+/**
+ * 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;
+    /**
+     * Context
+     */
+    chat_id: string;
+    agent_id?: string;
+    agent_version_id?: 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
+ */
+export interface HookResponse {
+    success: boolean;
+    message?: string;
+}
 export interface ApiTaskRequest {
     app: string;
     version?: string;
@@ -398,29 +460,32 @@ export interface QueueMetrics {
     dlq: number;
     in_flight: number;
 }
-export interface BlogPostCreateRequest {
+export interface PageCreateRequest {
     title: string;
     content: string;
     excerpt: string;
-    status: BlogPostStatus;
-    metadata: BlogPostMetadata;
+    status: PageStatus;
+    metadata: PageMetadata;
     slug: string;
-    category_title?: string;
-    category_slug?: string;
-    sub_category_title?: string;
-    sub_category_slug?: string;
-    acl?: ACL;
+    visibility: Visibility;
     is_featured: boolean;
 }
-export type BlogPostUpdateRequest = BlogPostCreateRequest;
-export interface BlogPostCommentCreateRequest {
-    blog_post_id: string;
+export type PageUpdateRequest = PageCreateRequest;
+export interface CommentCreateRequest {
+    page_id: string;
     content: string;
 }
-export type BlogPostCommentUpdateRequest = BlogPostCommentCreateRequest;
+export type CommentUpdateRequest = CommentCreateRequest;
+export interface MenuCreateRequest {
+    name: string;
+    slug: string;
+    description: string;
+    items: MenuItem[];
+}
+export type MenuUpdateRequest = MenuCreateRequest;
 export interface TransactionCreateRequest {
     user_id: string;
-    group_id?: string;
+    team_id: string;
     type: TransactionType;
     amount: number;
     reference: string;
@@ -456,6 +521,8 @@ export interface EnginesForResourcesResponse {
 }
 export interface TeamCreateRequest {
     name: string;
+    username: string;
+    email: string;
 }
 export interface FeatureTaskRequest {
     is_featured: boolean;
@@ -545,6 +612,135 @@ export interface MoveAgentToProjectRequest {
     agent_id: string;
     project_id: string;
 }
+/**
+ * CELEvalRequest is the request for evaluating CEL expressions
+ */
+export interface CELEvalRequest {
+    pricing: AppPricing;
+    output_meta?: OutputMeta;
+    resource_cost: number;
+    resource_ms: number;
+}
+/**
+ * CELEvalResult is the result of a single expression evaluation
+ */
+export interface CELEvalResult {
+    value: number;
+    error?: string;
+}
+/**
+ * CELEvalResponse is the response from evaluating CEL expressions
+ */
+export interface CELEvalResponse {
+    inference_fee: CELEvalResult;
+    royalty_fee: CELEvalResult;
+    partner_fee: CELEvalResult;
+    total: CELEvalResult;
+    description: 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;
+}
+/**
+ * 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;
+}
+/**
+ * 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;
+}
+/**
+ * IntegrationCompleteOAuthRequest for completing an OAuth flow
+ */
+export interface IntegrationCompleteOAuthRequest {
+    provider: string;
+    type: string;
+    code: string;
+    state: string;
+}
+/**
+ * IntegrationConnectResponse after connecting
+ */
+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 service accounts - instructions
+     */
+    instructions?: string;
+}
 export interface ApiKey {
     BaseModel: BaseModel;
     PermissionModel: PermissionModel;
@@ -552,12 +748,7 @@ export interface ApiKey {
     key: string;
     last_used_at: string;
 }
-export interface ApiKeyDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    user_id: string;
-    user: UserRelationDTO;
+export interface ApiKeyDTO extends BaseModel, PermissionModelDTO {
     name: string;
     key: string;
     last_used_at: string;
@@ -597,7 +788,7 @@ export interface App {
     description: string;
     agent_description: string;
     category: AppCategory;
-    blog_post_id?: string;
+    page_id?: string;
     license: string;
     license_mandatory: boolean;
     needs_hf_token: boolean;
@@ -614,13 +805,35 @@ export interface App {
     allows_cloud_workers: boolean;
     fees: AppFees;
 }
-export type PartnerFeeType = string;
-export declare const PartnerFeeTypeFixed: PartnerFeeType;
-export declare const PartnerFeeTypePerSecond: PartnerFeeType;
+/**
+ * AppPricing configures all pricing using CEL expressions
+ * CEL context includes: inputs, outputs, prices, resource_cost
+ * Empty expressions are skipped (evaluate to 0)
+ */
+export interface AppPricing {
+    prices: {
+        [key: string]: number;
+    };
+    /**
+     * CEL expressions for each fee type (result in microcents)
+     * Available variables: inputs, outputs, prices, resource_cost
+     */
+    inference_expression: string;
+    royalty_expression: string;
+    partner_expression: string;
+    /**
+     * Total expression combines all fees (can apply weights/discounts)
+     * Available variables: inputs, outputs, prices, resource_cost, inference_fee, royalty_fee, partner_fee
+     * If empty, defaults to: resource_cost + inference_fee + royalty_fee + partner_fee
+     */
+    total_expression: string;
+    description: string;
+}
+/**
+ * AppFees contains pricing configuration for an app
+ */
 export interface AppFees {
-    royalty_fee: number;
-    partner_fee: number;
-    partner_fee_type: PartnerFeeType;
+    app_pricing: AppPricing;
 }
 export interface AppGPUResource {
     count: number;
@@ -654,6 +867,11 @@ export interface AppVersion {
     metadata: {
         [key: string]: any;
     };
+    /**
+     * App requirements - secrets and integrations needed to run this app
+     */
+    required_secrets?: SecretRequirement[];
+    required_integrations?: IntegrationRequirement[];
 }
 export interface AppConfig {
     name: string;
@@ -669,6 +887,11 @@ export interface AppConfig {
     variants: {
         [key: string]: AppVariant;
     };
+    /**
+     * App requirements - parsed from YAML
+     */
+    required_secrets?: SecretRequirement[];
+    required_integrations?: IntegrationRequirement[];
 }
 export interface LicenseRecord {
     id: string;
@@ -679,25 +902,18 @@ export interface LicenseRecord {
     app_id: string;
     license: string;
 }
-export interface AppDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
+export interface AppDTO extends BaseModel, PermissionModelDTO {
     name: string;
     description: string;
     agent_description: string;
     category: AppCategory;
-    blog_post_id?: string;
+    page_id?: string;
     license: string;
     license_mandatory: boolean;
     needs_hf_token: boolean;
     hf_model_url: string;
     commercial: boolean;
     status: AppStatus;
-    acl?: ACL;
     is_featured: boolean;
     is_verified: boolean;
     rank: number;
@@ -711,10 +927,7 @@ export interface AppDTO {
     allows_private_workers: boolean;
     allows_cloud_workers: boolean;
 }
-export interface AppVersionDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
+export interface AppVersionDTO extends BaseModel {
     variants: {
         [key: string]: AppVariant;
     };
@@ -725,6 +938,11 @@ export interface AppVersionDTO {
     metadata: {
         [key: string]: any;
     };
+    /**
+     * App requirements
+     */
+    required_secrets?: SecretRequirement[];
+    required_integrations?: IntegrationRequirement[];
 }
 export interface ChatModelCapabilities {
     Image: boolean;
@@ -739,20 +957,34 @@ export interface BaseModel {
     updated_at: string;
     deleted_at?: string;
 }
+/**
+ * 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 Permissioned = any;
 export interface PermissionModel {
     user_id: string;
     user?: User;
-    group_id?: string;
-    acl?: ACL;
+    team_id: string;
+    team?: Team;
+    visibility: Visibility;
+}
+export interface PermissionModelDTO {
+    user_id: string;
+    user?: UserRelationDTO;
+    team_id: string;
+    team?: TeamRelationDTO;
+    visibility: Visibility;
 }
 export declare const PermRead = "read";
 export declare const PermWrite = "write";
-export declare const PermExec = "exec";
 export interface AuthContext {
-    IsAnonymous: boolean;
+    Role: Role;
     UserID: string;
-    GroupID?: string;
+    TeamID: string;
 }
 /**
  * Versioned interface for optimistic locking
@@ -773,6 +1005,27 @@ export interface EncryptedModel {
     user_pre_key: string;
     engine_public_key: string;
 }
+/**
+ * StripePaymentMetadata holds Stripe-specific payment method details
+ */
+export interface StripePaymentMetadata {
+    payment_method_id?: string;
+    last4?: string;
+    brand?: string;
+    exp_month?: number;
+    exp_year?: number;
+}
+/**
+ * PaymentProvider represents the payment provider being used
+ */
+export type PaymentProvider = string;
+export declare const PaymentProviderNone: PaymentProvider;
+export declare const PaymentProviderStripe: PaymentProvider;
+export type BillingStatus = string;
+export declare const BillingStatusActive: BillingStatus;
+export declare const BillingStatusSpendLocked: BillingStatus;
+export declare const BillingStatusManualHold: BillingStatus;
+export declare const BillingStatusSuspended: BillingStatus;
 /**
  * Billing holds billing information that can be owned by a user or team
  * OwnerID is the user ID if no group, or the team/group ID if a group exists
@@ -780,6 +1033,7 @@ export interface EncryptedModel {
 export interface Billing {
     BaseModel: BaseModel;
     PermissionModel: PermissionModel;
+    status: BillingStatus;
     /**
      * Balance in micro-cents (1 cent = 1,000,000)
      */
@@ -792,108 +1046,179 @@ export interface Billing {
 /**
  * BillingDTO is the data transfer object for Billing
  */
-export interface BillingDTO {
-    id: string;
-    user_id: string;
-    group_id?: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
+export interface BillingDTO extends BaseModel, PermissionModelDTO {
     balance: number;
     currency: string;
+    status: BillingStatus;
 }
-export type BlogPostStatus = number;
-export declare const BlogPostStatusUnknown: BlogPostStatus;
-export declare const BlogPostStatusDraft: BlogPostStatus;
-export declare const BlogPostStatusPublished: BlogPostStatus;
-export declare const BlogPostStatusArchived: BlogPostStatus;
-export interface BlogPostMetadata {
-    title: string;
-    description: string;
-    image: string;
-    tags: string[];
+/**
+ * BillingStatusUpdateRequest is the request to update billing status (admin only)
+ */
+export interface BillingStatusUpdateRequest {
+    status: BillingStatus;
 }
-export interface BlogPost {
-    BaseModel: BaseModel;
-    PermissionModel: PermissionModel;
-    is_featured: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
-    status: BlogPostStatus;
-    slug: string;
-    category_title?: string;
-    category_slug?: string;
-    sub_category_title?: string;
-    sub_category_slug?: string;
-    metadata: BlogPostMetadata;
+/**
+ * Address represents a structured postal address for billing/invoicing
+ * Fields align with Stripe's address format for easy integration
+ */
+export interface Address {
+    line1: string;
+    line2: string;
+    city: string;
+    state: string;
+    postal_code: string;
+    country: string;
 }
-export interface BlogPostDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    acl?: ACL;
-    is_featured: boolean;
-    user_id: string;
-    user?: UserRelationDTO;
-    title: string;
-    content: string;
-    excerpt: string;
-    status: BlogPostStatus;
-    metadata: BlogPostMetadata;
-    slug: string;
-    category_title?: string;
-    category_slug?: string;
-    sub_category_title?: string;
-    sub_category_slug?: string;
-}
-export type BlogPostCommentStatus = number;
-export declare const BlogPostCommentStatusUnknown: BlogPostCommentStatus;
-export declare const BlogPostCommentStatusDraft: BlogPostCommentStatus;
-export declare const BlogPostCommentStatusPublished: BlogPostCommentStatus;
-export declare const BlogPostCommentStatusArchived: BlogPostCommentStatus;
-export interface BlogPostComment {
+/**
+ * BillingSettings holds user-editable billing preferences and configuration
+ * Linked to a Billing account via BillingID
+ */
+export interface BillingSettings {
     BaseModel: BaseModel;
     PermissionModel: PermissionModel;
-    blog_post_id: string;
-    content: string;
-    status: BlogPostCommentStatus;
     /**
-     * Relationships
+     * Spending Controls
+     * SpendingLimit is the maximum amount allowed to spend per billing period (in micro-cents, 0 = unlimited)
      */
-    parent_comment_id?: string;
-    children: BlogPostComment[];
+    spending_limit: number;
+    /**
+     * LowBalanceThreshold triggers alerts when balance drops below this amount (in micro-cents) default to 1 USD
+     */
+    low_balance_threshold: number;
+    /**
+     * Auto-Recharge Settings
+     */
+    auto_recharge_enabled: boolean;
+    auto_recharge_amount: number;
+    auto_recharge_threshold: number;
+    /**
+     * Notification Settings
+     */
+    billing_email: string;
+    low_balance_alerts: boolean;
+    usage_summary_enabled: boolean;
+    usage_summary_interval: string;
+    /**
+     * Business Information (for invoicing)
+     */
+    company_name: string;
+    tax_id: string;
+    /**
+     * Payment Integration (provider-agnostic)
+     */
+    payment_provider: PaymentProvider;
+    provider_customer_id: string;
+    payment_method_id?: string;
+    payment_method_label?: string;
+    provider_metadata: {
+        [key: string]: any;
+    };
 }
-export interface BlogPostCommentDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
-    blog_post_id: string;
-    content: string;
-    parent_comment_id?: string;
-    children: BlogPostCommentDTO[];
-    status: BlogPostCommentStatus;
+/**
+ * BillingSettingsDTO is the data transfer object for BillingSettings
+ */
+export interface BillingSettingsDTO extends BaseModel, PermissionModelDTO {
+    /**
+     * Spending Controls
+     */
+    spending_limit: number;
+    low_balance_threshold: number;
+    /**
+     * Auto-Recharge Settings
+     */
+    auto_recharge_enabled: boolean;
+    auto_recharge_amount: number;
+    auto_recharge_threshold: number;
+    /**
+     * Notification Settings
+     */
+    billing_email: string;
+    low_balance_alerts: boolean;
+    usage_summary_enabled: boolean;
+    usage_summary_interval: string;
+    /**
+     * Business Information
+     */
+    company_name: string;
+    tax_id: string;
+    address: Address;
+    /**
+     * Payment Integration (read-only for user, provider-agnostic)
+     */
+    payment_provider: PaymentProvider;
+    has_payment_method: boolean;
+    payment_method_label?: string;
 }
-export type ChatType = string;
-export type ChatStatus = string;
-export declare const ChatStatusPending: ChatStatus;
-export declare const ChatStatusInProgress: ChatStatus;
-export declare const ChatStatusCompleted: ChatStatus;
-export declare const ChatStatusCancelled: ChatStatus;
-export interface Chat {
-    BaseModel: BaseModel;
-    PermissionModel: PermissionModel;
-    agent_id?: string;
-    agent_version_id?: string;
-    agent?: Agent;
-    tool_call_id?: string;
-    parent_id?: string;
-    parent?: Chat;
-    children: (Chat | undefined)[];
+/**
+ * BillingSettingsUpdateRequest represents the fields a user can update
+ */
+export interface BillingSettingsUpdateRequest {
+    /**
+     * Spending Controls
+     */
+    spending_limit?: number;
+    low_balance_threshold?: number;
+    /**
+     * Auto-Recharge Settings
+     */
+    auto_recharge_enabled?: boolean;
+    auto_recharge_amount?: number;
+    auto_recharge_threshold?: number;
+    /**
+     * Notification Settings
+     */
+    billing_email?: string;
+    low_balance_alerts?: boolean;
+    usage_summary_enabled?: boolean;
+    usage_summary_interval?: string;
+    /**
+     * Business Information
+     */
+    company_name?: string;
+    tax_id?: string;
+    address?: Address;
+}
+/**
+ * SetupCheckoutRequest is the request to create a Stripe Checkout session for saving payment methods
+ */
+export interface SetupCheckoutRequest {
+    success_url: string;
+    cancel_url: string;
+}
+/**
+ * SetupCheckoutResponse is returned when creating a Stripe Checkout session for setup
+ */
+export interface SetupCheckoutResponse {
+    session_id: string;
+    session_url: string;
+}
+/**
+ * SetupCheckoutCompleteRequest is the request to complete the setup after returning from Stripe
+ */
+export interface SetupCheckoutCompleteRequest {
+    session_id: string;
+}
+/**
+ * PaymentMethodResponse is the response after successfully saving a payment method
+ */
+export interface PaymentMethodResponse {
+    last4: string;
+    brand: string;
+}
+export type ChatType = string;
+export type ChatStatus = string;
+export declare const ChatStatusBusy: ChatStatus;
+export declare const ChatStatusIdle: ChatStatus;
+export interface Chat {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    agent_id?: string;
+    agent_version_id?: string;
+    agent?: Agent;
+    tool_call_id?: string;
+    parent_id?: string;
+    parent?: Chat;
+    children: (Chat | undefined)[];
     name: string;
     description: string;
     chat_messages: ChatMessage[];
@@ -945,9 +1270,6 @@ export interface ChatMessageContent {
     file?: string;
     tool_calls?: ToolInvocation[];
 }
-export type StringEncodedMap = {
-    [key: string]: any;
-};
 export interface ToolInvocationFunction {
     name: string;
     arguments: StringEncodedMap;
@@ -964,6 +1286,8 @@ export declare const ToolInvocationTypeInternal: ToolInvocationType;
 export declare const ToolInvocationTypeApp: ToolInvocationType;
 export declare const ToolInvocationTypeAgent: ToolInvocationType;
 export declare const ToolInvocationTypeWidget: ToolInvocationType;
+export declare const ToolInvocationTypePlan: ToolInvocationType;
+export declare const ToolInvocationTypeHook: ToolInvocationType;
 export declare const ToolInvocationTypeUnknown: ToolInvocationType;
 export type ToolInvocationStatus = string;
 export declare const ToolInvocationStatusPending: ToolInvocationStatus;
@@ -978,28 +1302,23 @@ export interface AgentToolInvocation {
     chat_message_id: string;
     tool_invocation_id: string;
     type: ToolInvocationType;
+    execution_id?: string;
     function: ToolInvocationFunction;
     status: ToolInvocationStatus;
     result?: string;
-    widget: Widget;
-    task_id?: string;
-    chat_id?: string;
+    widget?: Widget;
+    plan_steps?: AgentPlanStep[];
 }
-export interface AgentToolInvocationDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
+export interface AgentToolInvocationDTO extends BaseModel, PermissionModelDTO {
     chat_message_id: string;
     tool_invocation_id: string;
     type: ToolInvocationType;
+    execution_id?: string;
     function: ToolInvocationFunction;
     status: ToolInvocationStatus;
     result?: string;
-    widget: Widget;
-    task_id?: string;
-    chat_id?: string;
+    widget?: Widget;
+    plan_steps?: AgentPlanStep[];
 }
 /**
  * This is a transport object, not a database model
@@ -1041,6 +1360,7 @@ export interface ChatTaskOutput {
     usage?: LLMUsage;
 }
 export interface ChatTaskInput {
+    model?: string;
     context_size: number;
     temperature?: number;
     top_p?: number;
@@ -1061,6 +1381,7 @@ export interface BaseLLMInput {
     app_id: string;
     app_version_id?: string;
     app_variant?: string;
+    model?: string;
     system_prompt: string;
     tools?: Tool[];
     context_size: number;
@@ -1081,17 +1402,11 @@ export interface ChatTaskContextMessage {
     tool_calls?: ToolInvocation[];
     tool_call_id?: string;
 }
-export interface ChatDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user: UserRelationDTO;
-    acl?: ACL;
+export interface ChatDTO extends BaseModel, PermissionModelDTO {
     parent_id?: string;
     parent?: ChatDTO;
     children: (ChatDTO | undefined)[];
+    status: ChatStatus;
     agent_id?: string;
     agent_version_id?: string;
     agent?: AgentDTO;
@@ -1100,13 +1415,7 @@ export interface ChatDTO {
     chat_messages: ChatMessageDTO[];
     agent_data: AgentData;
 }
-export interface ChatMessageDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
+export interface ChatMessageDTO extends BaseModel, PermissionModelDTO {
     chat_id: string;
     chat?: ChatDTO;
     order: number;
@@ -1118,6 +1427,9 @@ export interface ChatMessageDTO {
     tool_call_id?: string;
     tool_invocations?: AgentToolInvocationDTO[];
 }
+export type StringEncodedMap = {
+    [key: string]: any;
+};
 /**
  * SearchRequest represents a search request
  */
@@ -1231,6 +1543,29 @@ export interface CursorConfig {
     direction: string;
     value: any;
 }
+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;
+/**
+ * DeviceAuthCode represents a device authorization code for device/CLI authentication
+ */
+export interface DeviceAuthCode {
+    id: string;
+    user_code: string;
+    device_code: string;
+    status: DeviceAuthStatus;
+    user_id: string;
+    team_id: string;
+    api_key: string;
+    expires_at: string;
+    created_at: string;
+    updated_at: string;
+}
 /**
  * Engine-related types
  */
@@ -1258,14 +1593,7 @@ export interface LocalEngineState {
     config: EngineConfig;
     public_key: string;
 }
-export interface EngineStateDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    user_id: string;
-    user?: UserRelationDTO;
-    group_id?: string;
-    acl?: ACL;
+export interface EngineStateDTO extends BaseModel, PermissionModelDTO {
     instance?: Instance;
     config: EngineConfig;
     name: string;
@@ -1274,14 +1602,7 @@ export interface EngineStateDTO {
     system_info?: SystemInfo;
     workers: (WorkerStateDTO | undefined)[];
 }
-export interface EngineStateSummary {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    user_id: string;
-    user?: UserRelationDTO;
-    group_id?: string;
-    acl?: ACL;
+export interface EngineStateSummary extends BaseModel, PermissionModelDTO {
     instance?: Instance;
     name: string;
     status: EngineStatus;
@@ -1330,9 +1651,9 @@ export interface WorkerRAM {
     worker_id: string;
     total: number;
 }
-export interface WorkerStateDTO {
-    id: string;
+export interface WorkerStateDTO extends BaseModel {
     user_id: string;
+    team_id: string;
     index: number;
     status: WorkerStatus;
     engine_id: string;
@@ -1371,12 +1692,7 @@ export interface File {
     size: number;
     filename: string;
 }
-export interface FileDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    user_id: string;
-    user: UserRelationDTO;
+export interface FileDTO extends BaseModel, PermissionModelDTO {
     path: string;
     remote_path: string;
     upload_url: string;
@@ -1454,13 +1770,7 @@ export interface OutputFieldMapping {
 export type OutputMappings = {
     [key: string]: OutputFieldMapping;
 };
-export interface FlowDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
+export interface FlowDTO extends BaseModel, PermissionModelDTO {
     name: string;
     description: string;
     card_image: string;
@@ -1509,13 +1819,7 @@ export interface FlowRun {
         [key: string]: NodeTask;
     };
 }
-export interface FlowRunDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    acl?: ACL;
-    user_id: string;
-    user?: UserRelationDTO;
+export interface FlowRunDTO extends BaseModel, PermissionModelDTO {
     flow_id: string;
     flow?: FlowDTO;
     task_id?: string;
@@ -1574,111 +1878,45 @@ export interface NodeHandle {
     type: string;
     name: string;
 }
-export interface GraphModel {
-    graph_id?: string;
-}
-/**
- * Graph represents a persistent directed acyclic graph for tracking execution dependencies
- */
-export interface Graph {
-    BaseModel: BaseModel;
-    PermissionModel: PermissionModel;
-    /**
-     * Source reference - what created this graph
-     */
-    source_id: string;
-    source_type: string;
-    /**
-     * Status
-     */
-    status: GraphStatus;
-    /**
-     * Metadata
-     */
-    started_at?: string;
-    completed_at?: string;
-    error?: string;
-    /**
-     * Relationships - loaded via GORM joins
-     */
-    nodes?: (GraphNode | undefined)[];
-    edges?: (GraphEdge | undefined)[];
-    node_states?: (GraphNodeState | undefined)[];
-}
+export type GraphNodeType = string;
+export declare const GraphNodeTypeUnknown: GraphNodeType;
+export declare const GraphNodeTypeJoin: GraphNodeType;
+export declare const GraphNodeTypeSplit: GraphNodeType;
+export declare const GraphNodeTypeTask: GraphNodeType;
+export declare const GraphNodeTypeResource: GraphNodeType;
+export declare const GraphNodeTypeConditional: GraphNodeType;
 /**
  * GraphNode represents a node in the execution graph
  */
 export interface GraphNode {
-    id: string;
-    graph_id: string;
-    type: string;
-    /**
-     * Optional metadata for the node
-     */
-    name?: string;
-    description?: string;
-    metadata?: {
-        [key: string]: any;
-    };
-    created_at: string;
-    updated_at: string;
-}
-/**
- * GraphEdge represents a dependency between nodes
- */
-export interface GraphEdge {
-    id: string;
-    graph_id: string;
-    from: string;
-    to: string;
-    /**
-     * Edge properties
-     */
-    type: GraphEdgeType;
-    required: boolean;
-    completed: boolean;
-    metadata?: {
-        [key: string]: any;
-    };
-    created_at: string;
-    updated_at: string;
-}
-/**
- * GraphNodeState tracks the execution state of a node
- */
-export interface GraphNodeState {
-    node_id: string;
+    BaseModel: BaseModel;
     graph_id: string;
+    type: GraphNodeType;
+    resource_id: string;
+    resource_type: string;
     status: GraphNodeStatus;
     /**
      * Dependency barrier counters
      */
     required_deps: number;
     completed_deps: number;
-    /**
-     * Link to the actual execution entity (TaskID, ChatMessageID, etc.)
-     */
-    execution_id?: string;
-    execution_type?: string;
+    metadata: StringEncodedMap;
     /**
      * Timing
      */
     ready_at?: string;
     started_at?: string;
     completed_at?: string;
-    /**
-     * Error tracking
-     */
-    error?: string;
     retry_count?: number;
-    /**
-     * Optional: Store outputs if needed for input resolution
-     */
-    outputs?: {
-        [key: string]: any;
-    };
-    created_at: string;
-    updated_at: string;
+}
+/**
+ * GraphEdge represents a dependency between nodes
+ */
+export interface GraphEdge {
+    BaseModel: BaseModel;
+    type: GraphEdgeType;
+    from: string;
+    to: string;
 }
 /**
  * GraphStatus represents the overall status of the graph
@@ -1708,40 +1946,139 @@ export type GraphEdgeType = string;
 export declare const GraphEdgeTypeDependency: GraphEdgeType;
 export declare const GraphEdgeTypeFlow: GraphEdgeType;
 export declare const GraphEdgeTypeConditional: GraphEdgeType;
-export declare const GraphEdgeTypeError: GraphEdgeType;
 /**
- * GraphSpec is used to create a new execution graph
+ * EdgeBuilder is the fluent API for creating graph edges
+ * Usage: service.Wire(ctx, authCtx).Resource(x).FlowsTo().Resource(y)
  */
-export interface GraphSpec {
-    SourceID: string;
-    SourceType: string;
-    Nodes: GraphNodeSpec[];
-    Edges: GraphEdgeSpec[];
-}
+export type GraphEdgeBuilder = any;
 /**
- * GraphNodeSpec specifies a node to be created
+ * GraphEdgeTarget completes the edge to a target
  */
-export interface GraphNodeSpec {
-    ID: string;
-    Type: string;
-    Name: string;
-    Description: string;
-    Metadata: {
+export type GraphEdgeTarget = any;
+/**
+ * Integration providers
+ */
+export declare const IntegrationProviderGoogle = "google";
+/**
+ * Integration providers
+ */
+export declare const IntegrationProviderSlack = "slack";
+/**
+ * Integration providers
+ */
+export declare const IntegrationProviderNotion = "notion";
+/**
+ * Integration providers
+ */
+export declare const IntegrationProviderGitHub = "github";
+/**
+ * Integration types
+ */
+export declare const IntegrationTypeServiceAccount = "service_account";
+/**
+ * Integration types
+ */
+export declare const IntegrationTypeOAuth = "oauth";
+/**
+ * Integration types
+ */
+export declare const IntegrationTypeAPIKey = "api_key";
+/**
+ * Integration statuses
+ */
+export declare const IntegrationStatusConnected = "connected";
+/**
+ * Integration statuses
+ */
+export declare const IntegrationStatusDisconnected = "disconnected";
+/**
+ * Integration statuses
+ */
+export declare const IntegrationStatusExpired = "expired";
+/**
+ * Integration statuses
+ */
+export declare const IntegrationStatusError = "error";
+/**
+ * StringSlice is a custom type for storing string slices in the database
+ */
+export type StringSlice = string[];
+/**
+ * Integration represents a connected external service integration
+ */
+export interface Integration {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    /**
+     * Provider identifies the service (google, slack, notion, etc.)
+     */
+    provider: string;
+    /**
+     * Type identifies the integration type (service_account, oauth, api_key)
+     */
+    type: string;
+    /**
+     * Status of the integration
+     */
+    status: string;
+    /**
+     * Display name for the integration (user-friendly)
+     */
+    display_name: string;
+    /**
+     * OAuth fields - tokens stored in secrets table for centralized encryption/rotation
+     */
+    scopes: StringSlice;
+    expires_at?: string;
+    /**
+     * Service Account fields
+     */
+    service_account_email: string;
+    /**
+     * Generic metadata for provider-specific data
+     */
+    metadata: {
         [key: string]: any;
     };
+    /**
+     * Error message if status is "error"
+     */
+    error_message?: string;
 }
 /**
- * GraphEdgeSpec specifies an edge to be created
+ * IntegrationDTO for API responses (never exposes tokens)
  */
-export interface GraphEdgeSpec {
-    ID: string;
-    From: string;
-    To: string;
-    Type: GraphEdgeType;
-    Required: boolean;
-    Metadata: {
+export interface IntegrationDTO extends BaseModel, PermissionModelDTO {
+    provider: string;
+    type: string;
+    status: string;
+    display_name: string;
+    scopes: StringSlice;
+    expires_at?: string;
+    service_account_email?: string;
+    metadata?: {
         [key: string]: any;
     };
+    error_message?: string;
+}
+/**
+ * OAuthConfig for OAuth providers
+ */
+export interface OAuthConfig {
+    ClientID: string;
+    ClientSecret: string;
+    RedirectURL: string;
+    Scopes: string[];
+}
+/**
+ * IntegrationCredentials returned by GetCredentials for runtime injection
+ */
+export interface IntegrationCredentials {
+    Provider: string;
+    Type: string;
+    Secrets: {
+        [key: string]: string;
+    };
 }
 /**
  * ServerCapabilities represents the server's supported features
@@ -1968,36 +2305,353 @@ export interface JSONRPCError {
     message: string;
     data?: any;
 }
-/**
- * NotificationMessage represents a notification message
- */
-export interface NotificationMessage {
-    jsonrpc: string;
-    method: string;
-    params?: any;
+/**
+ * NotificationMessage represents a notification message
+ */
+export interface NotificationMessage {
+    jsonrpc: string;
+    method: string;
+    params?: any;
+}
+/**
+ * ConnectedEvent represents a connected event
+ */
+export interface ConnectedEvent {
+    event: string;
+    timestamp: string;
+}
+/**
+ * ResourceTemplate represents a resource template
+ */
+export interface ResourceTemplate {
+    uriTemplate: string;
+    name: string;
+    title?: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * ResourceTemplateResponse represents a response for resource template operations
+ */
+export interface ResourceTemplateResponse {
+    resourceTemplates: ResourceTemplate[];
+}
+/**
+ * NotificationChannel represents a delivery channel
+ */
+export type NotificationChannel = string;
+export declare const NotificationChannelEmail: NotificationChannel;
+export declare const NotificationChannelSMS: NotificationChannel;
+export declare const NotificationChannelPush: NotificationChannel;
+export declare const NotificationChannelSlack: NotificationChannel;
+/**
+ * NotificationPriority represents notification priority
+ */
+export type NotificationPriority = string;
+export declare const NotificationPriorityLow: NotificationPriority;
+export declare const NotificationPriorityNormal: NotificationPriority;
+export declare const NotificationPriorityHigh: NotificationPriority;
+export declare const NotificationPriorityCritical: NotificationPriority;
+/**
+ * NotificationType represents the type/category of notification
+ */
+export type NotificationType = string;
+/**
+ * Billing notifications
+ */
+export declare const NotificationTypeLowBalance: NotificationType;
+export declare const NotificationTypeAutoRecharge: NotificationType;
+export declare const NotificationTypePaymentSuccess: NotificationType;
+export declare const NotificationTypePaymentFailed: NotificationType;
+export declare const NotificationTypeUsageSummary: NotificationType;
+export declare const NotificationTypeSpendingLimit: NotificationType;
+/**
+ * Account notifications
+ */
+export declare const NotificationTypeWelcome: NotificationType;
+export declare const NotificationTypePasswordReset: NotificationType;
+export declare const NotificationTypeEmailVerify: NotificationType;
+export declare const NotificationTypeSecurityAlert: NotificationType;
+/**
+ * Task notifications
+ */
+export declare const NotificationTypeTaskComplete: NotificationType;
+export declare const NotificationTypeTaskFailed: NotificationType;
+/**
+ * System notifications
+ */
+export declare const NotificationTypeSystemAlert: NotificationType;
+export declare const NotificationTypeMaintenance: NotificationType;
+/**
+ * NotificationStatus represents the status of a notification
+ */
+export type NotificationStatus = string;
+export declare const NotificationStatusPending: NotificationStatus;
+export declare const NotificationStatusSent: NotificationStatus;
+export declare const NotificationStatusDelivered: NotificationStatus;
+export declare const NotificationStatusFailed: NotificationStatus;
+export declare const NotificationStatusBounced: NotificationStatus;
+export declare const NotificationStatusCancelled: NotificationStatus;
+/**
+ * Notification represents a notification stored in the database
+ */
+export interface Notification {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    /**
+     * Notification details
+     */
+    type: NotificationType;
+    channel: NotificationChannel;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    /**
+     * Recipient info
+     */
+    recipient_email: string;
+    recipient_phone: string;
+    /**
+     * Content
+     */
+    subject: string;
+    body: string;
+    html_body: string;
+    /**
+     * Template support
+     */
+    template_id: string;
+    template_data: {
+        [key: string]: any;
+    };
+    /**
+     * Metadata for extensibility
+     */
+    metadata: {
+        [key: string]: any;
+    };
+    /**
+     * Scheduling
+     */
+    scheduled_at?: string;
+    expires_at?: string;
+    /**
+     * Delivery tracking
+     */
+    sent_at?: string;
+    delivered_at?: string;
+    failed_at?: string;
+    /**
+     * Provider info
+     */
+    provider_name: string;
+    provider_id: string;
+    /**
+     * Error tracking
+     */
+    error_message: string;
+    retry_count: number;
+    max_retries: number;
+    /**
+     * Reference to related entity (e.g., task_id, transaction_id)
+     */
+    reference_type: string;
+    reference_id: string;
+}
+/**
+ * NotificationDTO is the data transfer object
+ */
+export interface NotificationDTO extends BaseModel, PermissionModelDTO {
+    type: NotificationType;
+    channel: NotificationChannel;
+    priority: NotificationPriority;
+    status: NotificationStatus;
+    recipient_email?: string;
+    subject: string;
+    body?: string;
+    scheduled_at?: string;
+    sent_at?: string;
+    delivered_at?: string;
+    failed_at?: string;
+    error_message?: string;
+    retry_count: number;
+    reference_type?: string;
+    reference_id?: string;
+}
+export interface NotificationPreferences {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    /**
+     * Channel preferences
+     */
+    email_enabled: boolean;
+    sms_enabled: boolean;
+    push_enabled: boolean;
+    slack_enabled: boolean;
+    /**
+     * Type preferences (which notification types to receive)
+     */
+    billing_notifications: boolean;
+    task_notifications: boolean;
+    system_notifications: boolean;
+    marketing_emails: boolean;
+    /**
+     * Quiet hours (don't send non-critical notifications during these hours)
+     */
+    quiet_hours_enabled: boolean;
+    quiet_hours_start: string;
+    quiet_hours_end: string;
+    timezone: string;
+}
+/**
+ * NotificationPreferencesDTO is the data transfer object
+ */
+export interface NotificationPreferencesDTO extends BaseModel, 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;
+}
+/**
+ * CreateNotificationRequest is the request to create a notification
+ */
+export interface CreateNotificationRequest {
+    type: NotificationType;
+    channel: NotificationChannel;
+    priority?: NotificationPriority;
+    recipient_email?: string;
+    recipient_phone?: string;
+    subject: string;
+    body: string;
+    html_body?: string;
+    template_id?: string;
+    template_data?: {
+        [key: string]: any;
+    };
+    metadata?: {
+        [key: string]: any;
+    };
+    scheduled_at?: string;
+    reference_type?: string;
+    reference_id?: 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;
+}
+export type PageStatus = number;
+export declare const PageStatusUnknown: PageStatus;
+export declare const PageStatusDraft: PageStatus;
+export declare const PageStatusPublished: PageStatus;
+export declare const PageStatusArchived: PageStatus;
+export interface PageMetadata {
+    title: string;
+    description: string;
+    image: string;
+    tags: string[];
+    /**
+     * Docs-specific fields
+     */
+    order?: number;
+    type?: string;
+    icon?: string;
+    hide_from_nav?: boolean;
+}
+export interface Page {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    is_featured: boolean;
+    title: string;
+    content: string;
+    excerpt: string;
+    status: PageStatus;
+    slug: string;
+    metadata: PageMetadata;
+}
+export interface PageDTO extends BaseModel, PermissionModelDTO {
+    is_featured: boolean;
+    title: string;
+    content: string;
+    excerpt: string;
+    status: PageStatus;
+    metadata: PageMetadata;
+    slug: string;
 }
-/**
- * ConnectedEvent represents a connected event
- */
-export interface ConnectedEvent {
-    event: string;
-    timestamp: string;
+export type CommentStatus = number;
+export declare const CommentStatusUnknown: CommentStatus;
+export declare const CommentStatusDraft: CommentStatus;
+export declare const CommentStatusPublished: CommentStatus;
+export declare const CommentStatusArchived: CommentStatus;
+export interface Comment {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    page_id: string;
+    content: string;
+    status: CommentStatus;
+    /**
+     * Relationships
+     */
+    parent_comment_id?: string;
+    children: Comment[];
 }
-/**
- * ResourceTemplate represents a resource template
- */
-export interface ResourceTemplate {
-    uriTemplate: string;
+export interface CommentDTO extends BaseModel, PermissionModelDTO {
+    page_id: string;
+    content: string;
+    parent_comment_id?: string;
+    children: CommentDTO[];
+    status: CommentStatus;
+}
+export interface Menu {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
     name: string;
-    title?: string;
-    description?: string;
-    mimeType?: string;
+    slug: string;
+    description: string;
+    /**
+     * Nested items stored as JSON for flexibility
+     */
+    items: MenuItem[];
 }
 /**
- * ResourceTemplateResponse represents a response for resource template operations
+ * MenuItem represents an item in a menu (can be nested)
  */
-export interface ResourceTemplateResponse {
-    resourceTemplates: ResourceTemplate[];
+export interface MenuItem {
+    id: string;
+    label: string;
+    slug?: string;
+    page_id?: string;
+    url?: string;
+    icon?: string;
+    order: number;
+    is_group?: boolean;
+    expanded?: boolean;
+    children?: MenuItem[];
+}
+export interface MenuDTO extends BaseModel, PermissionModelDTO {
+    name: string;
+    slug: string;
+    description: string;
+    items: MenuItem[];
 }
 /**
  * ProjectType represents different types of projects
@@ -2028,14 +2682,7 @@ export interface Project {
 /**
  * ProjectDTO for API responses
  */
-export interface ProjectDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
-    acl?: ACL;
+export interface ProjectDTO extends BaseModel, PermissionModelDTO {
     name: string;
     description: string;
     type: ProjectType;
@@ -2045,6 +2692,79 @@ export interface ProjectDTO {
     parent?: ProjectDTO;
     children: (ProjectDTO | undefined)[];
 }
+/**
+ * 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
+ */
+export interface RequirementError {
+    type: string;
+    key: string;
+    message: string;
+    action?: SetupAction;
+}
+/**
+ * SetupAction provides actionable info for resolving a missing requirement
+ */
+export interface SetupAction {
+    type: string;
+    provider?: string;
+    scopes?: string[];
+}
+/**
+ * Capability represents an integration capability that can be requested by apps
+ */
+export interface Capability {
+    key: string;
+    provider: string;
+    type: string;
+    scopes?: string[];
+    satisfies?: string[];
+    display_name: string;
+    description?: string;
+    available: boolean;
+}
+/**
+ * CapabilitiesResponse is the API response for listing available capabilities
+ */
+export interface CapabilitiesResponse {
+    capabilities: Capability[];
+}
+/**
+ * CheckRequirementsRequest is the request body for checking requirements
+ */
+export interface CheckRequirementsRequest {
+    secrets?: SecretRequirement[];
+    integrations?: IntegrationRequirement[];
+}
+/**
+ * CheckRequirementsResponse is the API response for checking requirements
+ */
+export interface CheckRequirementsResponse {
+    satisfied: boolean;
+    errors?: RequirementError[];
+}
+/**
+ * RequirementsNotMetError is a specific error type for missing requirements
+ * This allows API handlers to detect this case and return structured errors
+ */
+export interface RequirementsNotMetError {
+    Errors: RequirementError[];
+}
 export interface ResourcePrice {
     CentsPerHour: number;
     NanosPerSecond: number;
@@ -2061,6 +2781,132 @@ export interface SchemaField {
     Name: string;
     Description: string;
 }
+/**
+ * Secret represents a single key-value secret for a team (one row per key)
+ */
+export interface Secret {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    /**
+     * Key is the environment variable name (e.g., "API_KEY", "DATABASE_URL")
+     */
+    key: string;
+    /**
+     * Value is the secret value - uses SensitiveString to prevent accidental exposure
+     */
+    value: SensitiveString;
+    /**
+     * Description is optional metadata about the secret
+     */
+    description?: string;
+    /**
+     * Internal marks this secret as system-managed (e.g., integration tokens)
+     * Internal secrets are hidden from user-facing lists but can still be used
+     */
+    internal: boolean;
+}
+/**
+ * SecretDTO for API responses - VALUE IS NEVER EXPOSED
+ */
+export interface SecretDTO extends BaseModel, PermissionModelDTO {
+    key: string;
+    masked_value: string;
+    description?: string;
+    internal?: boolean;
+}
+/**
+ * SecretMap represents a map of secret key-value pairs (used for transport to workers)
+ */
+export type SecretMap = {
+    [key: string]: string;
+};
+/**
+ * SecretsLegacy stores encrypted key-value pairs as a blob (DEPRECATED)
+ * Use Secret (individual rows) instead
+ */
+export interface SecretsLegacy {
+    BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
+    /**
+     * base64 encoded JSON of key-value pairs
+     */
+    data: SensitiveString;
+}
+/**
+ * GoogleIntegration represents the Google Cloud integration state for a team
+ */
+export interface GoogleIntegration {
+    enabled: boolean;
+    service_account_email: string;
+    created_at?: string;
+}
+/**
+ * GoogleIntegrationDTO for API responses (doesn't expose the key)
+ */
+export interface GoogleIntegrationDTO {
+    enabled: boolean;
+    service_account_email: string;
+    created_at?: string;
+}
+/**
+ * GoogleIntegrationCreateRequest is the request to enable Google integration
+ */
+export interface GoogleIntegrationCreateRequest {
+}
+/**
+ * GoogleIntegrationCreateResponse is the response after enabling Google integration
+ */
+export interface GoogleIntegrationCreateResponse {
+    service_account_email: string;
+    instructions: string;
+}
+/**
+ * Secret keys for Google integration
+ */
+export declare const SecretGoogleServiceAccountEmail = "GOOGLE_SERVICE_ACCOUNT_EMAIL";
+/**
+ * Secret keys for Google integration
+ */
+export declare const SecretGoogleServiceAccountJSON = "GOOGLE_SERVICE_ACCOUNT_JSON";
+/**
+ * Secret keys for Google integration
+ */
+export declare const SecretGoogleAccessToken = "GOOGLE_ACCESS_TOKEN";
+/**
+ * GoogleAccessToken represents a temporary access token for a service account
+ */
+export interface GoogleAccessToken {
+    access_token: string;
+    token_type: string;
+    expires_in: number;
+    service_account_email: string;
+}
+/**
+ * SystemMetadata stores system-level configuration that needs to persist
+ */
+export interface SystemMetadata {
+    key: string;
+    value: string;
+}
+/**
+ * SystemMetadataKeyFingerprint stores the current encryption key fingerprint
+ */
+export declare const SystemMetadataKeyFingerprint = "encryption_key_fingerprint";
+/**
+ * SensitiveString is a string type that prevents accidental exposure of secrets.
+ * It implements custom JSON marshaling, SQL scanning, and fmt.Stringer to always
+ * redact the value unless explicitly accessed via .Expose().
+ * Security features:
+ *   - Envelope encryption at rest: DEK encrypted with KEK, data encrypted with DEK
+ *   - JSON serialization: always returns "" (empty string)
+ *   - fmt.Sprintf with %s, %v, %#v: always returns "[REDACTED]"
+ *   - Only .Expose() returns the actual value - audit all call sites!
+ * Encryption is enabled when SECRETS_ENCRYPTION_KEY env var is set.
+ * Values are stored as "enc:v2:<encrypted_dek>:<encrypted_data>" in the database.
+ * Key rotation only re-encrypts the DEK, not the data.
+ */
+export interface SensitiveString {
+}
 export interface Session {
     id: string;
     hash: string;
@@ -2097,7 +2943,7 @@ export declare const InstanceStatusPending: InstanceStatus;
 export declare const InstanceStatusActive: InstanceStatus;
 export declare const InstanceStatusDeleted: InstanceStatus;
 export interface Instance {
-    id: string;
+    BaseModel: BaseModel;
     PermissionModel: PermissionModel;
     cloud: InstanceCloudProvider;
     name: string;
@@ -2190,9 +3036,7 @@ export type InstanceTypeDeploymentType = string;
 export declare const InstanceTypeDeploymentTypeVM: InstanceTypeDeploymentType;
 export declare const InstanceTypeDeploymentTypeContainer: InstanceTypeDeploymentType;
 export declare const InstanceTypeDeploymentTypeBaremetal: InstanceTypeDeploymentType;
-export interface InstanceType {
-    id: string;
-    PermissionModel: PermissionModel;
+export interface InstanceType extends BaseModel, PermissionModel {
     cloud: InstanceCloudProvider;
     region: string;
     shade_instance_type: string;
@@ -2478,7 +3322,6 @@ export interface Task {
     PermissionModel: PermissionModel;
     VersionedStruct: VersionedStruct;
     EncryptedModel: EncryptedModel;
-    GraphModel: GraphModel;
     is_featured: boolean;
     status: TaskStatus;
     /**
@@ -2542,15 +3385,8 @@ export interface TaskLog {
     log_type: TaskLogType;
     content: string;
 }
-export interface TaskDTO {
-    id: string;
+export interface TaskDTO extends BaseModel, PermissionModelDTO {
     graph_id?: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    acl?: ACL;
-    user_id: string;
-    user?: UserRelationDTO;
     user_public_key: string;
     engine_public_key: string;
     is_featured: boolean;
@@ -2598,15 +3434,24 @@ export interface TimescaleTask {
     worker_id: string;
     system_info: TelemetrySystemInfo;
 }
+export type TeamType = string;
+export declare const TeamTypePersonal: TeamType;
+export declare const TeamTypeTeam: TeamType;
+export declare const TeamTypeSystem: TeamType;
 export interface Team {
     BaseModel: BaseModel;
+    type: TeamType;
+    username: string;
+    email: string;
+    name: string;
+    avatar_url: string;
 }
-export interface TeamDTO {
-    id: string;
+export interface TeamDTO extends BaseModel {
+    type: TeamType;
     name: string;
-    logo: string;
-    balance: number;
-    env: string;
+    username: string;
+    avatar_url: string;
+    email: string;
 }
 export type TeamRole = string;
 export declare const TeamRoleOwner: TeamRole;
@@ -2621,7 +3466,17 @@ export interface TeamMemberDTO {
     team_id: string;
     role: TeamRole;
     user?: UserRelationDTO;
-    team?: TeamDTO;
+}
+/**
+ * Team-related types
+ */
+export interface TeamRelationDTO {
+    id: string;
+    created_at: string;
+    updated_at: string;
+    type: TeamType;
+    username: string;
+    avatar_url: string;
 }
 /**
  * Tool types and parameter types
@@ -2662,13 +3517,13 @@ export interface Tool {
 export interface ToolFunction {
     name: string;
     description: string;
-    parameters: ToolParameters;
+    parameters?: ToolParameters;
     required?: string[];
 }
 export interface ToolParameters {
     type: string;
     title: string;
-    properties: ToolParameterProperties;
+    properties?: ToolParameterProperties;
     required?: string[];
 }
 export type ToolParameterProperties = {
@@ -2705,17 +3560,13 @@ export interface Transaction {
         [key: string]: any;
     };
 }
-export interface TransactionDTO {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
-    user_id: string;
-    user?: UserRelationDTO;
+export interface TransactionDTO extends BaseModel, PermissionModelDTO {
     type: TransactionType;
     amount: number;
     reference: string;
     notes: string;
+    payment_record_id?: string;
+    payment_record?: PaymentRecord;
     usage_billing_record_id?: string;
     usage_billing_record?: UsageBillingRecord;
     usage_billing_refund_id?: string;
@@ -2724,28 +3575,119 @@ export interface TransactionDTO {
         [key: string]: any;
     };
 }
-export type StripeTransactionStatus = number;
-export declare const StripeTransactionStatusOpen: StripeTransactionStatus;
-export declare const StripeTransactionStatusComplete: StripeTransactionStatus;
-export declare const StripeTransactionStatusExpired: StripeTransactionStatus;
-export interface StripeTransaction {
+/**
+ * PaymentRecordStatus represents the status of a payment
+ */
+export type PaymentRecordStatus = number;
+export declare const PaymentRecordStatusPending: PaymentRecordStatus;
+export declare const PaymentRecordStatusComplete: PaymentRecordStatus;
+export declare const PaymentRecordStatusFailed: PaymentRecordStatus;
+export declare const PaymentRecordStatusExpired: PaymentRecordStatus;
+/**
+ * PaymentRecordType represents the type of payment
+ */
+export type PaymentRecordType = string;
+export declare const PaymentRecordTypeCheckout: PaymentRecordType;
+export declare const PaymentRecordTypeAutoRecharge: PaymentRecordType;
+/**
+ * PaymentRecord stores Stripe payment details for both checkout sessions and direct charges
+ */
+export interface PaymentRecord {
     BaseModel: BaseModel;
     PermissionModel: PermissionModel;
+    type: PaymentRecordType;
+    status: PaymentRecordStatus;
+    amount: number;
+    stripe_customer_id: string;
+    payment_intent_id: string;
+    receipt_url: string;
+    /**
+     * Checkout-specific fields (only set for checkout type)
+     */
     session_id: string;
     session_url: string;
-    status: StripeTransactionStatus;
 }
+/**
+ * Legacy aliases for backward compatibility
+ */
+export type CheckoutSessionStatus = PaymentRecordStatus;
+export type CheckoutSession = PaymentRecord;
+export type StripeTransactionStatus = PaymentRecordStatus;
+export type StripeTransaction = PaymentRecord;
+export declare const CheckoutSessionStatusOpen: number;
+export declare const CheckoutSessionStatusComplete: number;
+export declare const CheckoutSessionStatusExpired: number;
+export declare const StripeTransactionStatusOpen: number;
+export declare const StripeTransactionStatusComplete: number;
+export declare const StripeTransactionStatusExpired: number;
 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;
+/**
+ * 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;
+/**
+ * MetaItem represents metadata about an input or output item
+ */
+export interface MetaItem {
+    type: MetaItemType;
+    /**
+     * Text fields
+     */
+    tokens?: number;
+    /**
+     * Image/Video shared fields
+     */
+    width?: number;
+    height?: number;
+    resolution_mp?: number;
+    /**
+     * Image specific fields
+     */
+    steps?: number;
+    count?: number;
+    /**
+     * Video specific fields
+     */
+    resolution?: VideoResolution;
+    seconds?: number;
+    fps?: number;
+    /**
+     * Audio specific fields
+     */
+    sample_rate?: number;
+    /**
+     * App-specific key-value pairs for custom pricing factors
+     */
+    extra?: {
+        [key: string]: any;
+    };
+}
+/**
+ * OutputMeta contains structured metadata about task inputs and outputs for pricing calculation
+ */
+export interface OutputMeta {
+    inputs: MetaItem[];
+    outputs: MetaItem[];
+}
 export interface UsageEvent {
     BaseModel: BaseModel;
+    PermissionModel: PermissionModel;
     usage_billing_record_id: string;
-    /**
-     * Event owner
-     */
-    user_id: string;
-    group_id?: string;
     reference_id: string;
     resource_id: string;
     /**
@@ -2771,9 +3713,11 @@ export interface UsageEventSummary {
 }
 export interface UsageBillingRecord {
     BaseModel: BaseModel;
-    user_id: string;
-    group_id?: string;
+    PermissionModel: PermissionModel;
     usage_events: (UsageEvent | undefined)[];
+    /**
+     * Fee breakdown (all in microcents)
+     */
     total: number;
     user_debit_transaction_id: string;
     user_debit_transaction?: Transaction;
@@ -2782,8 +3726,7 @@ export interface UsageBillingRecord {
 }
 export interface UsageBillingRefund {
     BaseModel: BaseModel;
-    user_id: string;
-    group_id?: string;
+    PermissionModel: PermissionModel;
     usage_billing_record_id: string;
     usage_billing_record?: UsageBillingRecord;
     user_debit_refund_transaction_id: string;
@@ -2796,38 +3739,28 @@ export interface UsageBillingRefund {
  */
 export interface User {
     BaseModel: BaseModel;
+    default_team_id: string;
     role: Role;
     username: string;
     email: string;
     name: string;
     full_name: string;
     avatar_url: string;
-    email_verified: boolean;
-    phone_verified: boolean;
-    is_anonymous: boolean;
-    env: string;
-    balance: number;
     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 {
-    id: string;
-    created_at: string;
-    updated_at: string;
-    deleted_at?: string;
+export interface UserDTO extends BaseModel {
+    default_team_id: string;
     role: Role;
     username: string;
     email: string;
-    email_verified: boolean;
-    is_anonymous: boolean;
     name: string;
     full_name: string;
     avatar_url: string;
-    env: string;
-    balance: number;
     metadata: UserMetadata;
 }
 /**
@@ -2848,12 +3781,6 @@ export interface UserMetadata {
     use_case_reason: string;
     use_case_privacy: string;
 }
-/**
- * Environment represents a map of environment variables
- */
-export type Environment = {
-    [key: string]: string;
-};
 /**
  * WidgetAction represents an action triggered by a widget button
  */
@@ -2913,6 +3840,7 @@ export interface WidgetSelectOption {
  */
 export interface Widget {
     type: string;
+    interactive?: boolean;
     title?: string;
     html?: string;
     json?: string;
@@ -2977,7 +3905,7 @@ export declare const WSEventEngineStop = "engine_stop";
 export declare const WSEventEngineDeleteHFCacheRepo = "engine_delete_hfcache_repo";
 export interface WsTaskRunPayload {
     task: TaskDTO;
-    user_env: string;
+    secrets: string;
 }
 export interface WsTaskCancelPayload {
     task: TaskDTO;