@inferencesh/sdk 0.6.30 → 0.6.48

package/dist/types.d.ts

@@ -8,6 +8,7 @@ export interface InternalToolsConfig {
     finish?: boolean;
     skills?: boolean;
     host_context?: boolean;
+    meta?: boolean;
 }
 /**
  * AgentTool represents a unified tool that can be used by an agent
@@ -198,6 +199,7 @@ export interface AgentVersionDTO extends BaseModelDTO, PermissionModelDTO {
     skills: SkillConfig[];
     context?: ContextField[];
     internal_tools?: InternalToolsConfig;
+    hooks?: LifecycleHookConfig[];
     output_schema?: any;
 }
 /**
@@ -229,6 +231,7 @@ export interface AgentConfigInput {
     skills?: SkillConfig[];
     context?: ContextField[];
     internal_tools?: InternalToolsConfig;
+    hooks?: LifecycleHookConfig[];
     output_schema?: any;
 }
 /**
@@ -253,6 +256,7 @@ export interface AgentRunDTO extends BaseModelDTO, PermissionModelDTO {
     interrupt_reason?: InterruptReason;
     interrupt_tool_id?: string;
     interrupt_meta?: any;
+    tool_invocation_id?: string;
     trigger_id?: string;
     metadata?: any;
 }
@@ -270,6 +274,19 @@ export interface APIError {
         [key: string]: any;
     };
 }
+/**
+ * ResponseMessage carries a non-error notice alongside a successful response.
+ * Inspired by GraphQL's coexisting data+errors pattern, but for actionable
+ * messages (warnings, info) rather than partial failures.
+ */
+export interface ResponseMessage {
+    level: string;
+    code: string;
+    message: string;
+    meta?: {
+        [key: string]: any;
+    };
+}
 /**
  * ApiAppRunRequest is the request body for /apps/run endpoint.
  */
@@ -298,7 +315,7 @@ export interface ApiAgentRunRequest {
     agent?: string;
     agent_config?: AgentConfigInput;
     agent_name?: string;
-    input: ChatTaskInput;
+    input: LLMInput;
     context?: {
         [key: string]: string;
     };
@@ -313,7 +330,7 @@ export interface CreateAgentMessageRequest {
     agent_version_id?: string;
     agent?: string;
     tool_call_id?: string;
-    input: ChatTaskInput;
+    input: LLMInput;
     integration_context?: IntegrationContext;
     agent_config?: AgentConfigInput;
     agent_name?: string;
@@ -415,7 +432,10 @@ export interface CheckoutCreateRequest {
 export interface AuthResponse {
     user?: UserDTO;
     session_id: string;
+    is_new?: boolean;
     otp_required?: boolean;
+    otp_method?: string;
+    challenge_token?: string;
     redirect_to?: string;
     provider?: string;
 }
@@ -469,6 +489,7 @@ export interface SecretCreateRequest {
     key: string;
     value: string;
     description?: string;
+    provider?: string;
 }
 export interface SecretUpdateRequest {
     value: string;
@@ -482,6 +503,13 @@ export interface IntegrationConnectRequest {
     metadata?: {
         [key: string]: any;
     };
+    /**
+     * ConnectionScope is who the resulting credential belongs to:
+     * "user" (just me) or "team" (shared with the team — requires team
+     * admin). Empty = the provider's default. Distinct from Scopes, which
+     * are OAuth permission scopes.
+     */
+    connection_scope?: CredentialScope;
 }
 export interface IntegrationCompleteOAuthRequest {
     provider: string;
@@ -777,6 +805,16 @@ export declare const ScopeApiKeysRead: Scope;
  * Empty scopes = full access (for backwards compatibility with existing keys).
  */
 export declare const ScopeApiKeysWrite: Scope;
+/**
+ * Action-level scopes for Knowledge (includes skills)
+ */
+export declare const ScopeKnowledgeRead: 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 ScopeKnowledgeWrite: Scope;
 /**
  * Action-level scopes for User profile
  */
@@ -814,6 +852,7 @@ export declare const ScopeGroupSecrets: ScopeGroup;
 export declare const ScopeGroupIntegrations: ScopeGroup;
 export declare const ScopeGroupEngines: ScopeGroup;
 export declare const ScopeGroupApiKeys: ScopeGroup;
+export declare const ScopeGroupKnowledge: ScopeGroup;
 export declare const ScopeGroupUser: ScopeGroup;
 export declare const ScopeGroupSettings: ScopeGroup;
 /**
@@ -1063,6 +1102,7 @@ export interface PublicAppStoreDTO {
     rank: number;
     has_approved_version: boolean;
     page_id?: string;
+    pricing_description?: string;
 }
 /**
  * AuthSessionDTO is a safe representation of AuthSession for API responses.
@@ -1102,6 +1142,7 @@ export interface PermissionModelDTO {
     user?: UserRelationDTO;
     team_id: string;
     team?: TeamRelationDTO;
+    org_id?: string;
     visibility: Visibility;
 }
 /**
@@ -1133,6 +1174,53 @@ export interface AvailabilityResponse {
      */
     reason?: string;
 }
+/**
+ * BountyProgramDTO is the API representation of a bounty program.
+ */
+export interface BountyProgramDTO extends BaseModelDTO, PermissionModelDTO {
+    name: string;
+    description: string;
+    amount_microcents: number;
+    grant_type: string;
+    expiry_days: number;
+    max_per_user: number;
+    max_per_day: number;
+    proof_type: string;
+    proof_min_length: number;
+    status: string;
+    notice_text: string;
+    notice_cooldown_hours: number;
+    notice_priority: number;
+    starts_at?: string;
+    ends_at?: string;
+}
+/**
+ * BountySubmissionDTO is the API representation of a bounty claim.
+ */
+export interface BountySubmissionDTO extends BaseModelDTO, PermissionModelDTO {
+    bounty_id: string;
+    resource_id?: string;
+    proof_id: string;
+    proof_ref: string;
+    agent?: string;
+    source?: string;
+}
+/**
+ * SubmitBountyRequest is used to claim a bounty reward.
+ */
+export interface SubmitBountyRequest {
+    bounty_id: string;
+    proof_id: string;
+    agent?: string;
+    source?: string;
+}
+/**
+ * SubmitBountyResponse is returned when claiming a bounty.
+ */
+export interface SubmitBountyResponse {
+    submission: BountySubmissionDTO;
+    granted_amount?: number;
+}
 /**
  * ChatDTO for API responses
  */
@@ -1154,6 +1242,7 @@ export interface ChatDTO extends BaseModelDTO, PermissionModelDTO {
     chat_messages: ChatMessageDTO[];
     agent_data: ChatData;
     active_run?: AgentRunDTO;
+    pending_interrupts?: InterruptDTO[];
 }
 /**
  * ChatMessageDTO for API responses
@@ -1222,6 +1311,12 @@ export interface CursorListResponse<T extends any> {
     items_per_page: number;
     total_items: number;
 }
+/**
+ * CountResponse is the response for count endpoints.
+ */
+export interface CountResponse {
+    count: number;
+}
 /**
  * EngineConfig holds engine configuration (no gorm tags).
  */
@@ -1419,6 +1514,15 @@ export interface FlowNodeData {
     additional?: any;
     task?: TaskDTO;
     task_id?: string;
+    /**
+     * Primitive node configs (legacy, kept for backward compat)
+     */
+    gate_condition?: GateCondition;
+    selector_config?: SelectorConfig;
+    /**
+     * Unified utility node config (replaces gate_condition/selector_config)
+     */
+    utility?: UtilityConfig;
 }
 /**
  * FlowNodeDataMap maps node IDs to their data
@@ -1489,6 +1593,190 @@ export interface FlowRunDTO extends BaseModelDTO, PermissionModelDTO {
     node_tasks: {
         [key: string]: NodeTaskDTO | undefined;
     };
+    node_statuses?: {
+        [key: string]: GraphNodeStatus;
+    };
+    node_outputs: any;
+}
+/**
+ * FlowActionType is the string type for action constants.
+ */
+export type FlowActionType = string;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeAdd: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeRemove: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeMove: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeMoveMany: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeDuplicate: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeRename: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeSetApp: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeUpdate: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeSetInput: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionNodeClearInput: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionEdgeAdd: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionEdgeRemove: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionFlowSetInputSchema: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionFlowSetOutputSchema: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionFlowSetOutputMapping: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionFlowRemoveOutputMapping: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionFlowRenameOutputField: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionUndo: FlowActionType;
+/**
+ * Flow graph action type constants.
+ */
+export declare const ActionRedo: FlowActionType;
+/**
+ * FlowAction represents a single graph mutation.
+ */
+export interface FlowAction {
+    type: FlowActionType;
+    payload: any;
+}
+/**
+ * FlowActionsRequest is the request body for POST /flows/{id}/actions.
+ */
+export interface FlowActionsRequest {
+    actions: FlowAction[];
+}
+/**
+ * FlowActionsResponse is the response from the actions endpoint.
+ */
+export interface FlowActionsResponse {
+    version: number;
+    actions: FlowAction[];
+    errors?: FlowActionError[];
+}
+/**
+ * FlowActionError is an error returned from an action.
+ */
+export interface FlowActionError {
+    type?: string;
+    message: string;
+}
+export interface AddNodePayload {
+    id: string;
+    type: string;
+    position: FlowNodePosition;
+    data: FlowNodeData;
+}
+export interface RemoveNodePayload {
+    id: string;
+}
+export interface MoveNodePayload {
+    id: string;
+    position: FlowNodePosition;
+}
+export interface MoveNodesPayload {
+    positions: {
+        [key: string]: FlowNodePosition;
+    };
+}
+export interface DuplicateNodePayload {
+    source_id: string;
+    new_id: string;
+    offset: FlowNodePosition;
+}
+export interface RenameNodePayload {
+    old_id: string;
+    new_id: string;
+}
+export interface SetNodeAppPayload {
+    node_id: string;
+    app_id: string;
+    app_version_id: string;
+    function: string;
+}
+export interface UpdateNodeDataPayload {
+    node_id: string;
+    patch: {
+        [key: string]: any;
+    };
+}
+export interface SetInputPayload {
+    node_id: string;
+    input_key: string;
+    input: FlowRunInput;
+}
+export interface ClearInputPayload {
+    node_id: string;
+    input_key: string;
+}
+export interface AddEdgePayload {
+    id: string;
+    source: string;
+    target: string;
+    source_handle?: string;
+    target_handle?: string;
+}
+export interface RemoveEdgePayload {
+    id: string;
+}
+export interface SetSchemaPayload {
+    schema: any;
+}
+export interface SetOutputMappingPayload {
+    field: string;
+    mapping: OutputFieldMapping;
+}
+export interface RemoveOutputMappingPayload {
+    field: string;
+}
+export interface RenameOutputFieldPayload {
+    old_field: string;
+    new_field: string;
 }
 /**
  * GraphNodeDTO is the API representation of a graph node
@@ -1596,6 +1884,7 @@ export interface InstanceTypeBootTime {
  */
 export interface IntegrationDTO extends BaseModelDTO, PermissionModelDTO {
     scope: IntegrationScope;
+    grant?: IntegrationGrant;
     provider: IntegrationProvider;
     type: IntegrationAuthType;
     auth: IntegrationAuthType;
@@ -1631,6 +1920,7 @@ export interface IntegrationConfigDTO {
     allows_byok: boolean;
     available: boolean;
     has_managed: boolean;
+    grant?: IntegrationGrant;
     integration?: IntegrationDTO;
 }
 /**
@@ -1643,6 +1933,20 @@ export interface SecretFieldConfig {
     sensitive: boolean;
     optional: boolean;
 }
+export interface InterruptDTO extends BaseModelDTO, PermissionModelDTO {
+    run_id: string;
+    chat_id: string;
+    reason: InterruptReason;
+    source: string;
+    resource_id?: string;
+    resource_type?: InterruptResourceType;
+    status: InterruptStatus;
+    resolution?: InterruptResolution;
+    resolved_at?: string;
+    resolved_data?: any;
+    expires_at?: string;
+    meta?: any;
+}
 /**
  * KnowledgeFile represents a file in a knowledge entry
  */
@@ -1711,6 +2015,8 @@ export interface KnowledgeVersionDTO extends BaseModelDTO {
     metadata?: {
         [key: string]: string;
     };
+    origin?: string;
+    generated_by?: string;
     source_url?: string;
     mutation_type?: string;
     version_notes?: string;
@@ -1786,6 +2092,77 @@ export interface SkillStoreListingDTO {
     uses: number;
     tags?: string[];
 }
+/**
+ * LifecycleHookConfig registers a handler for an agent lifecycle event.
+ * Stored on AgentVersion alongside Tools and Skills.
+ */
+export interface LifecycleHookConfig {
+    event: HookEvent;
+    type: HookHandlerType;
+    handler?: string;
+    async?: boolean;
+    timeout?: number;
+    /**
+     * Gate-specific fields (type: "gate")
+     */
+    default_resolution?: InterruptResolution;
+}
+/**
+ * LifecycleHookPayload is sent to hook handlers on lifecycle events.
+ */
+export interface LifecycleHookPayload {
+    event: HookEvent;
+    timestamp: string;
+    agent_id: string;
+    chat_id: string;
+    run_id?: string;
+    turn_count: number;
+    data?: any;
+}
+/**
+ * LifecycleHookResponse is returned by hook handlers.
+ * All fields are optional — an empty 200 response is equivalent to {decision: "allow"}.
+ */
+export interface LifecycleHookResponse {
+    inject?: ContextInjection;
+    decision?: HookDecision;
+    reason?: string;
+    override?: any;
+    system?: string;
+}
+/**
+ * ContextInjection adds ephemeral content to the agent's context window.
+ * Injections are stored as ChatMessages and filtered at context-build time.
+ */
+export interface ContextInjection {
+    content: string;
+    role?: string;
+    ttl_turns?: number;
+    dedup_key?: string;
+}
+/**
+ * ToolCallEventData is the typed payload for agent.tool_call events.
+ */
+export interface ToolCallEventData {
+    tool: string;
+    arguments?: {
+        [key: string]: any;
+    };
+}
+/**
+ * ToolResultEventData is the typed payload for agent.tool_result events.
+ */
+export interface ToolResultEventData {
+    tool: string;
+    status: string;
+    result?: string;
+}
+/**
+ * ErrorEventData is the typed payload for agent.error events.
+ */
+export interface ErrorEventData {
+    error: string;
+}
 /**
  * ElicitationCapability advertises which elicitation modes the client handles.
  * An empty struct is equivalent to form-only for backward compatibility.
@@ -1951,7 +2328,12 @@ export type StringSlice = string[];
  */
 export interface MCPServerDTO {
     id: string;
-    PermissionModelDTO: PermissionModelDTO;
+    user_id: string;
+    user: UserRelationDTO;
+    team_id: string;
+    team: TeamRelationDTO;
+    org_id?: string;
+    visibility: Visibility;
     slug: string;
     name: string;
     description: string;
@@ -1961,6 +2343,7 @@ export interface MCPServerDTO {
     oauth_client_id?: string;
     default_scopes: StringSlice;
     documentation_url: string;
+    connection_status?: string;
 }
 /**
  * NotificationDTO is the data transfer object
@@ -2028,6 +2411,9 @@ export interface PageMetadata {
     type?: string;
     icon?: string;
     hide_from_nav?: boolean;
+    action_url?: string;
+    action_label?: string;
+    display_mode?: string;
     /**
      * PublishAt is when a scheduled page goes live. Only meaningful while the
      * page's status is PageStatusScheduled.
@@ -2179,6 +2565,8 @@ export interface KnowledgeVersionInput {
     metadata?: {
         [key: string]: string;
     };
+    origin?: string;
+    generated_by?: string;
     source_url?: string;
     mutation_type?: string;
     version_notes?: string;
@@ -2285,6 +2673,7 @@ export interface SuggestRequest {
     category?: string;
     agent?: boolean;
     scope?: string[];
+    origin?: string;
 }
 /**
  * SuggestResponse is the output of the suggest endpoint.
@@ -2292,6 +2681,7 @@ export interface SuggestRequest {
 export interface SuggestResponse {
     query: string;
     results: SuggestResult[];
+    impression_id?: string;
 }
 /**
  * SuggestResult is a single result item from the suggest endpoint.
@@ -2362,6 +2752,17 @@ export interface CheckRequirementsResponse {
     satisfied: boolean;
     errors?: RequirementError[];
 }
+export interface ResourceShareDTO extends BaseModelDTO {
+    resource_id: string;
+    resource_type: string;
+    user_id: string;
+    user?: UserRelationDTO;
+    permission: Permission;
+}
+export interface ShareRequest {
+    user_id: string;
+    permission: Permission;
+}
 /**
  * SDKTypes is a phantom type for gotypegen dependency tracing.
  * Types listed here (and their transitive dependencies) are included
@@ -2379,6 +2780,22 @@ export interface SecretDTO extends BaseModelDTO, PermissionModelDTO {
     description?: string;
     scope?: SecretScope;
 }
+/**
+ * MeStatsResponse is returned by GET /me/stats.
+ */
+export interface MeStatsResponse {
+    knowledge_count: number;
+    skills_count: number;
+    extracted: StatBuckets;
+}
+/**
+ * StatBuckets holds time-windowed counts.
+ */
+export interface StatBuckets {
+    today: number;
+    this_week: number;
+    all_time: number;
+}
 /**
  * SubscriptionDTO for API responses
  */
@@ -2672,6 +3089,18 @@ export interface TeamInviteCreateRequest {
     email: string;
     role: TeamRole;
 }
+export interface TelemetryReportDTO extends BaseModelDTO, PermissionModelDTO {
+    ip: string;
+    level: number;
+    payload: {
+        [key: string]: any;
+    };
+}
+export interface SubmitTelemetryRequest {
+    payload: {
+        [key: string]: any;
+    };
+}
 /**
  * ToolInvocationFunction contains the function details for a tool invocation
  */
@@ -2744,6 +3173,9 @@ export interface UserDTO extends BaseModelDTO {
     name: string;
     full_name: string;
     avatar_url: string;
+    banned_at?: string;
+    ban_note?: string;
+    totp_enabled: boolean;
     metadata?: UserMetadataDTO;
 }
 /**
@@ -2770,86 +3202,125 @@ export interface UserMetadataDTO {
     terms_version: string;
 }
 /**
- * WidgetAction represents an action triggered by a widget button
- */
-export interface WidgetAction {
-    type: string;
-    payload?: {
-        [key: string]: any;
-    };
-}
-/**
- * WidgetActionButton represents a button in a widget's action bar
- */
-export interface WidgetActionButton {
-    label: string;
-    action: WidgetAction;
+ * Widget is an A2UI surface stored on a ToolInvocation.
+ * Alias of shared.A2UISurface so the type generation pipeline picks it up.
+ */
+export type Widget = A2UISurface;
+export type A2UIComponentType = string;
+export declare const A2UIRow: A2UIComponentType;
+export declare const A2UIColumn: A2UIComponentType;
+export declare const A2UIList: A2UIComponentType;
+export declare const A2UIText: A2UIComponentType;
+export declare const A2UIImage: A2UIComponentType;
+export declare const A2UIIcon: A2UIComponentType;
+export declare const A2UIDivider: A2UIComponentType;
+export declare const A2UIButton: A2UIComponentType;
+export declare const A2UITextField: A2UIComponentType;
+export declare const A2UICheckBox: A2UIComponentType;
+export declare const A2UISlider: A2UIComponentType;
+export declare const A2UIDateTimeInput: A2UIComponentType;
+export declare const A2UIChoicePicker: A2UIComponentType;
+export declare const A2UICard: A2UIComponentType;
+export declare const A2UIModal: A2UIComponentType;
+export declare const A2UITabs: A2UIComponentType;
+/**
+ * Extensions (inferencesh/v1 catalog)
+ */
+export declare const A2UIBadge: A2UIComponentType;
+export declare const A2UISpacer: A2UIComponentType;
+export declare const A2UIChart: A2UIComponentType;
+export declare const A2UIForm: A2UIComponentType;
+/**
+ * A2UIComponent is the universal component representation.
+ * Children are string IDs (flat adjacency list), not nested objects.
+ */
+export interface A2UIComponent {
+    id: string;
+    component: A2UIComponentType;
+    /**
+     * Layout
+     */
+    children?: string[];
+    justify?: string;
+    align?: string;
+    direction?: string;
+    gap?: number;
+    /**
+     * Text
+     */
+    text?: A2UIBoundValue;
     variant?: string;
-}
-/**
- * WidgetNode represents a UI element in a widget (text, input, select, etc.)
- */
-export interface WidgetNode {
-    type: WidgetNodeType;
-    value?: string;
-    src?: string;
-    alt?: string;
+    /**
+     * Image
+     */
+    url?: A2UIBoundValue;
+    fit?: string;
+    /**
+     * Icon
+     */
+    name?: A2UIBoundValue;
+    /**
+     * Divider
+     */
+    axis?: string;
+    /**
+     * Button / Card
+     */
+    child?: string;
+    primary?: boolean;
+    action?: A2UIAction;
+    /**
+     * TextField
+     */
     label?: string;
-    name?: string;
+    value?: A2UIBoundValue;
+    textFieldType?: string;
+    validationRegexp?: string;
     placeholder?: string;
-    defaultValue?: string;
-    variant?: string;
-    action?: WidgetAction;
-    options?: WidgetSelectOption[];
-    defaultChecked?: boolean;
-    children?: WidgetNode[];
-    gap?: number;
+    rows?: number;
     /**
-     * Layout props (Box, Row, Col, Form)
+     * Slider
      */
-    align?: string;
-    justify?: string;
-    padding?: any;
-    background?: any;
-    radius?: string;
-    direction?: string;
-    wrap?: string;
-    flex?: any;
+    minValue?: number;
+    maxValue?: number;
     /**
-     * Typography props (Text, Title, Caption, Label)
+     * DateTimeInput
      */
-    size?: string;
-    weight?: string;
-    color?: any;
-    textAlign?: string;
-    truncate?: boolean;
-    maxLines?: number;
+    enableDate?: boolean;
+    enableTime?: boolean;
     /**
-     * Control props (Input, Textarea, Select, Checkbox, RadioGroup, DatePicker, Button)
+     * ChoicePicker
      */
+    options?: A2UIChoiceOption[];
+    selections?: A2UIBoundValue;
+    maxAllowedSelections?: number;
+    /**
+     * Modal
+     */
+    entryPointChild?: string;
+    contentChild?: string;
+    /**
+     * Tabs
+     */
+    tabItems?: A2UITabItem[];
+    /**
+     * Common
+     */
+    accessibility?: A2UIAccessibility;
+    weight?: number;
     disabled?: boolean;
     required?: boolean;
-    rows?: number;
-    fieldName?: string;
-    submit?: boolean;
-    pattern?: string;
-    min?: string;
-    max?: string;
-    clearable?: boolean;
     /**
-     * Action handler for buttons (form data is collected locally and sent with action)
+     * Extension: Badge
      */
-    onClickAction?: WidgetAction;
+    badgeLabel?: string;
+    badgeVariant?: string;
     /**
-     * Content props (Icon, Spacer, Divider, Chart)
+     * Extension: Spacer
      */
-    iconName?: string;
-    spacing?: any;
     minSize?: any;
-    height?: any;
-    width?: any;
     /**
-     * Chart specific props
+     * Extension: Chart
      */
     chartData?: any;
     chartSeries?: any;
@@ -2858,34 +3329,175 @@ export interface WidgetNode {
     showLegend?: boolean;
     showTooltip?: boolean;
     /**
-     * Form-specific props
+     * Extension: Form
      */
-    onSubmitAction?: WidgetAction;
-    /**
-     * Data binding (deprecated - use templates instead)
-     */
-    dataKey?: string;
+    onSubmitAction?: A2UIAction;
 }
 /**
- * WidgetSelectOption represents an option in a select widget
+ * A2UIBoundValue is either a literal or a data model path reference.
  */
-export interface WidgetSelectOption {
+export interface A2UIBoundValue {
+    path?: string;
+}
+export interface A2UIAction {
+    type: string;
+    payload?: any;
+}
+export interface A2UIChoiceOption {
     label: string;
     value: string;
 }
+export interface A2UITabItem {
+    title: string;
+    child: string;
+}
+export interface A2UIAccessibility {
+    label?: string;
+    description?: string;
+}
 /**
- * Widget represents an interactive widget for display in chat
- * Type is either "ui" (structured nodes) or "html" (raw HTML)
- * For "ui" widgets, data-bound nodes read values from ToolInvocation.Data
+ * A2UISurface is the complete renderable state for a widget.
  */
-export interface Widget {
-    type: string;
-    interactive?: boolean;
-    title?: string;
-    html?: string;
-    json?: string;
-    children?: WidgetNode[];
-    actions?: WidgetActionButton[];
+export interface A2UISurface {
+    version: string;
+    surfaceId: string;
+    catalogId: string;
+    components: A2UIComponent[];
+    dataModel?: any;
+}
+/**
+ * AgentEventType identifies what happened in an agent run.
+ * These are the backbone protocol events — every consumer (A2A, SDK, frontend)
+ * projects from this set.
+ */
+export type AgentEventType = string;
+/**
+ * Run lifecycle
+ */
+export declare const AgentEventRunStarted: AgentEventType;
+export declare const AgentEventRunStateChanged: AgentEventType;
+/**
+ * Turn lifecycle
+ */
+export declare const AgentEventTurnStarted: AgentEventType;
+export declare const AgentEventTurnCompleted: AgentEventType;
+/**
+ * Content streaming — structural wrapper; high-frequency token deltas
+ * still flow via the existing DeltaEvent channel for efficiency.
+ */
+export declare const AgentEventContentDelta: AgentEventType;
+/**
+ * Tool lifecycle
+ */
+export declare const AgentEventToolStarted: AgentEventType;
+export declare const AgentEventToolCompleted: AgentEventType;
+/**
+ * Approval flow
+ */
+export declare const AgentEventApprovalRequired: AgentEventType;
+export declare const AgentEventApprovalResolved: AgentEventType;
+/**
+ * Hook lifecycle
+ */
+export declare const AgentEventHookExecuted: AgentEventType;
+/**
+ * Usage
+ */
+export declare const AgentEventUsageUpdated: AgentEventType;
+/**
+ * Context management
+ */
+export declare const AgentEventContextCompacted: AgentEventType;
+/**
+ * Errors
+ */
+export declare const AgentEventError: AgentEventType;
+/**
+ * AgentEvent is the backbone protocol event for agent runs.
+ * Published to "runs:<runID>" and "chats:<chatID>" keys on the event bus.
+ */
+export interface AgentEvent {
+    id: string;
+    type: AgentEventType;
+    run_id: string;
+    chat_id: string;
+    agent_id?: string;
+    timestamp: string;
+    payload?: any;
+}
+export interface RunStartedPayload {
+    agent_id: string;
+    agent_version_id?: string;
+    user_message_id?: string;
+}
+export interface RunStateChangedPayload {
+    from_state: AgentRunState;
+    to_state: AgentRunState;
+    error?: string;
+}
+export interface TurnStartedPayload {
+    turn_index: number;
+    model?: string;
+}
+export interface TurnCompletedPayload {
+    turn_index: number;
+    tool_count: number;
+    has_output: boolean;
+    stop_reason?: string;
+}
+export interface ContentDeltaPayload {
+    kind: ContentDeltaKind;
+    delta: string;
+}
+export type ContentDeltaKind = string;
+export declare const ContentDeltaText: ContentDeltaKind;
+export declare const ContentDeltaReasoning: ContentDeltaKind;
+export interface ToolStartedPayload {
+    tool_invocation_id: string;
+    tool_name: string;
+    tool_type?: ToolType;
+    display_name?: string;
+    arguments?: StringEncodedMap;
+}
+export interface ToolCompletedPayload {
+    tool_invocation_id: string;
+    tool_name: string;
+    status: ToolInvocationStatus;
+    result?: string;
+    duration_ms?: number;
+}
+export interface ApprovalRequiredPayload {
+    tool_invocation_id: string;
+    tool_name: string;
+    arguments?: StringEncodedMap;
+    reason: InterruptReason;
+}
+export interface ApprovalResolvedPayload {
+    tool_invocation_id: string;
+    tool_name: string;
+    decision: string;
+    reason?: string;
+}
+export interface HookExecutedPayload {
+    hook_event: HookEvent;
+    decision: HookDecision;
+    reason?: string;
+    duration_ms?: number;
+}
+export interface UsageUpdatedPayload {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    reasoning_tokens?: number;
+    cost_usd?: number;
+}
+export interface ContextCompactedPayload {
+    before_tokens: number;
+    after_tokens: number;
+}
+export interface ErrorPayload {
+    message: string;
+    code?: string;
 }
 /**
  * AgentRunState tracks the lifecycle of an agent run (one user→agent turn).
@@ -2910,6 +3522,7 @@ export declare const InterruptReasonClientTool: InterruptReason;
 export declare const InterruptReasonWidget: InterruptReason;
 export declare const InterruptReasonAuth: InterruptReason;
 export declare const InterruptReasonConfirmation: InterruptReason;
+export declare const InterruptReasonHookGate: InterruptReason;
 export type AppCategory = string;
 export declare const AppCategoryImage: AppCategory;
 export declare const AppCategoryVideo: AppCategory;
@@ -2936,8 +3549,20 @@ export declare const GPUTypeApple: GPUType;
  */
 export type Visibility = string;
 export declare const VisibilityPrivate: Visibility;
+export declare const VisibilityTeam: Visibility;
+/**
+ * VisibilityOrg sits between team and public: visible to every member of
+ * every team in the owning team's org (INF-795 Phase 2).
+ */
+export declare const VisibilityOrg: Visibility;
 export declare const VisibilityPublic: Visibility;
 export declare const VisibilityUnlisted: Visibility;
+/**
+ * Permission represents a permission level for access checks.
+ */
+export type Permission = string;
+export declare const PermRead: Permission;
+export declare const PermWrite: Permission;
 export type SubscriptionStatus = string;
 export declare const SubscriptionStatusTrialing: SubscriptionStatus;
 export declare const SubscriptionStatusActive: SubscriptionStatus;
@@ -2973,12 +3598,22 @@ export declare const PlanStepStatusInProgress: PlanStepStatus;
 export declare const PlanStepStatusCompleted: PlanStepStatus;
 export declare const PlanStepStatusCancelled: PlanStepStatus;
 export type ChatMessageRole = string;
+/**
+ * LLM wire-protocol roles
+ */
 export declare const ChatMessageRoleSystem: ChatMessageRole;
 export declare const ChatMessageRoleUser: ChatMessageRole;
 export declare const ChatMessageRoleAssistant: ChatMessageRole;
 export declare const ChatMessageRoleTool: ChatMessageRole;
+/**
+ * Internal bookkeeping roles — never sent to the LLM provider.
+ * BuildContext converts these to system messages or skips them.
+ */
+export declare const ChatMessageRoleInjection: ChatMessageRole;
+export declare const ChatMessageRoleCompaction: ChatMessageRole;
 export type ChatMessageStatus = string;
 export declare const ChatMessageStatusPending: ChatMessageStatus;
+export declare const ChatMessageStatusQueued: ChatMessageStatus;
 export declare const ChatMessageStatusReady: ChatMessageStatus;
 export declare const ChatMessageStatusFailed: ChatMessageStatus;
 export declare const ChatMessageStatusCancelled: ChatMessageStatus;
@@ -3029,46 +3664,6 @@ export interface IntegrationContext {
     integration_type?: IntegrationType;
     integration_metadata?: any;
 }
-/**
- * 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;
 };
@@ -3172,6 +3767,22 @@ export interface OutputFieldMapping {
 export type OutputMappings = {
     [key: string]: OutputFieldMapping;
 };
+/**
+ * GateCondition defines a simple boolean condition for gate nodes.
+ */
+export interface GateCondition {
+    field: string;
+    operator: string;
+    value: any;
+}
+/**
+ * SelectorConfig defines how to pick element(s) from an array.
+ */
+export interface SelectorConfig {
+    field: string;
+    mode: string;
+    index?: number;
+}
 export type GraphNodeType = string;
 export declare const GraphNodeTypeUnknown: GraphNodeType;
 export declare const GraphNodeTypeJoin: GraphNodeType;
@@ -3217,6 +3828,251 @@ export declare const GraphEdgeTypeReferences: GraphEdgeType;
 export declare const GraphEdgeTypeSupersedes: GraphEdgeType;
 export declare const GraphEdgeTypeInput: GraphEdgeType;
 export declare const GraphEdgeTypeOutput: GraphEdgeType;
+/**
+ * InterruptStatus tracks the lifecycle of an interrupt gate.
+ */
+export type InterruptStatus = string;
+export declare const InterruptStatusPending: InterruptStatus;
+export declare const InterruptStatusResolved: InterruptStatus;
+export declare const InterruptStatusExpired: InterruptStatus;
+export declare const InterruptStatusCancelled: InterruptStatus;
+/**
+ * InterruptResolution records how a pending interrupt was resolved.
+ */
+export type InterruptResolution = string;
+export declare const InterruptResolutionAllow: InterruptResolution;
+export declare const InterruptResolutionDeny: InterruptResolution;
+/**
+ * InterruptResourceType identifies the kind of resource an interrupt gates.
+ */
+export type InterruptResourceType = string;
+export declare const InterruptResourceToolInvocation: InterruptResourceType;
+export declare const InterruptResourceHookEvent: InterruptResourceType;
+/**
+ * HookEvent is a lifecycle event in the agent conversation loop.
+ * Events fire at well-defined points in the turn cycle, giving external
+ * handlers the ability to observe, inject context, or halt execution.
+ */
+export type HookEvent = string;
+export declare const HookEventAgentStart: HookEvent;
+export declare const HookEventTurnStart: HookEvent;
+export declare const HookEventToolCall: HookEvent;
+export declare const HookEventToolResult: HookEvent;
+export declare const HookEventTurnComplete: HookEvent;
+export declare const HookEventAgentError: HookEvent;
+export declare const HookEventAgentComplete: HookEvent;
+export declare const HookEventAgentIdle: HookEvent;
+export declare const HookEventPreCompact: HookEvent;
+export declare const HookEventPostCompact: HookEvent;
+/**
+ * HookEventDefinition describes a lifecycle hook event and its capabilities.
+ */
+export interface HookEventDefinition {
+    event: HookEvent;
+    description: string;
+    can_gate: boolean;
+}
+/**
+ * HookDecision is the handler's verdict on whether execution should continue.
+ */
+export type HookDecision = string;
+export declare const HookDecisionAllow: HookDecision;
+export declare const HookDecisionDeny: HookDecision;
+export declare const HookDecisionStop: HookDecision;
+export declare const HookDecisionSuspend: HookDecision;
+/**
+ * HookHandlerType distinguishes how a lifecycle hook is executed.
+ */
+export type HookHandlerType = string;
+export declare const HookHandlerWebhook: HookHandlerType;
+export declare const HookHandlerTask: HookHandlerType;
+export declare const HookHandlerGate: HookHandlerType;
+/**
+ * MergeStrategy defines how a delta field should be merged by consumers.
+ */
+export type MergeStrategy = string;
+export declare const MergeStrategyConcat: MergeStrategy;
+export declare const MergeStrategyReplace: MergeStrategy;
+export declare const MergeStrategyIndexed: MergeStrategy;
+export declare const MergeStrategyNested: MergeStrategy;
+/**
+ * StreamDelta is the marker base for all streaming delta types.
+ * Types embedding StreamDelta are routed through the delta channel.
+ */
+export interface StreamDelta {
+}
+/**
+ * LLMOutput is the output envelope from an LLM provider task.
+ * This is the contract between chat apps (sdk-py) and the agent runtime (go/api).
+ */
+export interface LLMOutput {
+    response: string;
+    reasoning?: string;
+    tool_calls?: ToolCall[];
+    usage?: LLMUsage;
+}
+/**
+ * LLMDelta is a streaming delta for LLMOutput.
+ */
+export interface LLMDelta extends StreamDelta {
+    response: string;
+    reasoning?: string;
+    tool_calls?: ToolCallDelta[];
+    usage?: LLMUsage;
+}
+export declare const LLMDelta_fieldTags: {
+    readonly response: {
+        readonly merge: "concat";
+    };
+    readonly reasoning: {
+        readonly merge: "concat";
+    };
+    readonly tool_calls: {
+        readonly merge: "indexed";
+    };
+    readonly usage: {
+        readonly merge: "replace";
+    };
+};
+/**
+ * ToolCallDelta is an incremental update to a tool call, identified by index.
+ * First delta for an index carries ID, Type, and Function.Name.
+ * Subsequent deltas carry only Function.Arguments fragments.
+ */
+export interface ToolCallDelta {
+    index: number;
+    id?: string;
+    type?: ToolCallType;
+    function?: ToolCallFunctionDelta;
+}
+export declare const ToolCallDelta_fieldTags: {
+    readonly id: {
+        readonly merge: "replace";
+    };
+    readonly type: {
+        readonly merge: "replace";
+    };
+    readonly function: {
+        readonly merge: "nested";
+    };
+};
+/**
+ * DeltaEvent is the generic streaming envelope on the NDJSON wire.
+ * Delta is raw bytes — consumers parse based on context.
+ */
+export interface DeltaEvent {
+    delta: any;
+    seq: number;
+}
+/**
+ * LLMDeltaEvent is a typed alias for backward compatibility.
+ */
+export type LLMDeltaEvent = DeltaEvent;
+/**
+ * ToolCallFunctionDelta carries partial tool call function data.
+ * Arguments is a raw JSON string fragment — concatenate by index, parse on completion.
+ */
+export interface ToolCallFunctionDelta {
+    name?: string;
+    arguments?: string;
+}
+export declare const ToolCallFunctionDelta_fieldTags: {
+    readonly name: {
+        readonly merge: "replace";
+    };
+    readonly arguments: {
+        readonly merge: "concat";
+    };
+};
+/**
+ * ToolChoiceMode controls whether the model must call a tool this turn.
+ */
+export type ToolChoiceMode = string;
+export declare const ToolChoiceModeNone: ToolChoiceMode;
+export declare const ToolChoiceModeAuto: ToolChoiceMode;
+export declare const ToolChoiceModeRequired: ToolChoiceMode;
+export declare const ToolChoiceModeFunction: ToolChoiceMode;
+/**
+ * ToolChoice constrains tool calling for a turn. Providers spell this
+ * differently (OpenAI tool_choice, Anthropic tool_choice.type any/tool,
+ * Gemini functionCallingConfig); apps translate at the provider boundary.
+ */
+export interface ToolChoice {
+    mode: ToolChoiceMode;
+    name?: string;
+}
+/**
+ * ResponseFormatType selects how the model's output is constrained.
+ */
+export type ResponseFormatType = string;
+export declare const ResponseFormatTypeText: ResponseFormatType;
+export declare const ResponseFormatTypeJSONObject: ResponseFormatType;
+export declare const ResponseFormatTypeJSONSchema: ResponseFormatType;
+/**
+ * ResponseFormat constrains the shape of the model's response.
+ * JSONSchema is required when Type is json_schema.
+ */
+export interface ResponseFormat {
+    type: ResponseFormatType;
+    name?: string;
+    json_schema?: any;
+    strict?: boolean;
+}
+/**
+ * LLMSettings is everything that configures a generation independent of the
+ * conversation: model, context, sampling, system prompt, tools and output
+ * constraints. Embedded (tstype extends) by BaseLLMInput — an agent's stored
+ * configuration — and LLMInput — a single call — so a field added here
+ * reaches both, and the call is built from the configuration by one
+ * assignment.
+ */
+export interface LLMSettings {
+    model?: string;
+    context_size: number;
+    temperature?: number;
+    top_p?: number;
+    top_k?: number;
+    min_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+    repetition_penalty?: number;
+    seed?: number;
+    stop?: string[];
+    max_tokens?: number;
+    reasoning_effort?: string;
+    reasoning_max_tokens?: number;
+    system_prompt: string;
+    tools?: Tool[];
+    tool_choice?: ToolChoice;
+    response_format?: ResponseFormat;
+}
+/**
+ * LLMInput is the input envelope for an LLM provider task: the settings plus
+ * the conversation, with the current turn split out of the context.
+ */
+export interface LLMInput extends LLMSettings {
+    context: LLMContextMessage[];
+    role?: ChatMessageRole;
+    text?: string;
+    reasoning?: string;
+    attachments?: FileRef[];
+    images?: string[];
+    files?: string[];
+    tool_call_id?: string;
+}
+/**
+ * LLMContextMessage represents a message in the chat context for LLM tasks
+ */
+export interface LLMContextMessage {
+    role: ChatMessageRole;
+    text?: string;
+    reasoning?: string;
+    images?: string[];
+    files?: string[];
+    tools?: Tool[];
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+}
 /**
  * SecretScope defines the visibility/purpose of a secret
  */
@@ -3246,6 +4102,7 @@ export type PageType = string;
 export declare const PageTypeDoc: PageType;
 export declare const PageTypeBlog: PageType;
 export declare const PageTypePage: PageType;
+export declare const PageTypeAnnouncement: PageType;
 /**
  * ToolInvocationStatus represents the execution status of a tool invocation
  */
@@ -3377,6 +4234,8 @@ export declare const KnowledgeTypeAgentConfig: KnowledgeType;
 export type KnowledgeLifecycle = string;
 export declare const KnowledgeLifecyclePermanent: KnowledgeLifecycle;
 export declare const KnowledgeLifecycleDecay: KnowledgeLifecycle;
+export declare const KnowledgeLifecycleDraft: KnowledgeLifecycle;
+export declare const KnowledgeLifecycleDeprecated: KnowledgeLifecycle;
 export type FilterOperator = string;
 export declare const OpEqual: FilterOperator;
 export declare const OpNotEqual: FilterOperator;
@@ -3491,44 +4350,40 @@ export declare const IntegrationStatusDisconnected: IntegrationStatus;
 export declare const IntegrationStatusExpired: IntegrationStatus;
 export declare const IntegrationStatusError: IntegrationStatus;
 /**
- * IntegrationScope distinguishes platform-provided vs team-owned integrations.
+ * IntegrationScope controls credential resolution priority and ownership.
  */
 export type IntegrationScope = string;
+export declare const IntegrationScopeTeam: IntegrationScope;
+export declare const IntegrationScopePlatform: IntegrationScope;
+export declare const IntegrationScopeUser: IntegrationScope;
 /**
- * IntegrationScopeTeam is owned by a user/team (BYOK credentials, user connections)
+ * IntegrationGrant describes what an integration provides.
  */
-export declare const IntegrationScopeTeam: IntegrationScope;
+export type IntegrationGrant = string;
 /**
- * IntegrationScopePlatform is owned by the platform (managed credentials, admin-configured)
+ * IntegrationGrantCredentials provides OAuth app credentials (client_id/secret).
+ * Users connect their own accounts against it. Only valid for type=oauth.
  */
-export declare const IntegrationScopePlatform: IntegrationScope;
-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;
+export declare const IntegrationGrantCredentials: IntegrationGrant;
+/**
+ * IntegrationGrantToken provides ready-to-use access (token, API key, etc.).
+ */
+export declare const IntegrationGrantToken: IntegrationGrant;
+/**
+ * CredentialScope controls resolution priority and ownership.
+ */
+export type CredentialScope = string;
+export declare const CredentialScopePlatform: CredentialScope;
+/**
+ * CredentialScopeOrg: shared across all teams of an org. In the enum for
+ * end-to-end typing (connect-level pickers); connects with it are refused
+ * until the org domain lands (INF-795 Phase 2). Resolution order once
+ * live: agent > user > team > org > platform.
+ */
+export declare const CredentialScopeOrg: CredentialScope;
+export declare const CredentialScopeTeam: CredentialScope;
+export declare const CredentialScopeUser: CredentialScope;
+export declare const CredentialScopeAgent: CredentialScope;
 /**
  * NotificationChannel represents a delivery channel
  */
@@ -3562,6 +4417,7 @@ export declare const NotificationTypeInvoice: NotificationType;
 export declare const NotificationTypeSubscriptionCreated: NotificationType;
 export declare const NotificationTypeSubscriptionCredit: NotificationType;
 export declare const NotificationTypeSubscriptionCanceled: NotificationType;
+export declare const NotificationTypeSubscriptionPaymentFailed: NotificationType;
 export declare const NotificationTypeSubscriptionTrialEnding: NotificationType;
 /**
  * Account notifications
@@ -3720,6 +4576,19 @@ export interface ToolCallFunction {
     name: string;
     arguments: StringEncodedMap;
 }
+/**
+ * LLMUsage contains token usage and performance metrics from an LLM response
+ */
+export interface LLMUsage {
+    stop_reason: string;
+    time_to_first_token: number;
+    tokens_per_second: number;
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    reasoning_tokens: number;
+    reasoning_time: number;
+}
 /**
  * FileRef is a lightweight reference to a file with essential metadata.
  * Used in chat inputs/context instead of full File objects.
@@ -3766,3 +4635,13 @@ export declare const RoleGuest: Role;
 export declare const RoleUser: Role;
 export declare const RoleAdmin: Role;
 export declare const RoleSystem: Role;
+/**
+ * UtilityConfig defines a flow utility node — gate, selector, merge, or custom CEL.
+ */
+export interface UtilityConfig {
+    preset: string;
+    expression?: string;
+    gate?: GateCondition;
+    selector?: SelectorConfig;
+    constant?: any;
+}