modulex-js 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3349 @@
+/**
+ * Configuration options for the ModuleX client.
+ */
+interface ModulexConfig {
+    /** API key with `mx_live_` prefix. */
+    apiKey: string;
+    /** Default organization ID for all requests. Can be overridden per-request. */
+    organizationId?: string;
+    /** Base URL for the ModuleX API. */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. */
+    timeout?: number;
+    /** Maximum number of retries for transient errors (429, 5xx). */
+    maxRetries?: number;
+    /** Custom fetch implementation. Defaults to globalThis.fetch. */
+    fetch?: typeof globalThis.fetch;
+}
+/** @internal */
+interface ResolvedConfig {
+    apiKey: string;
+    organizationId?: string;
+    baseUrl: string;
+    timeout: number;
+    maxRetries: number;
+    fetch: typeof globalThis.fetch;
+}
+
+/** A parsed SSE event. */
+interface SSEEvent {
+    /** Event type (e.g., "node_update", "done", "error"). */
+    event: string;
+    /** Parsed JSON data payload. */
+    data: Record<string, unknown>;
+    /** Optional event ID. */
+    id?: string;
+    /** Optional reconnection interval in ms. */
+    retry?: number;
+}
+
+/**
+ * Common types shared across all ModuleX SDK resources.
+ * @module types/shared
+ */
+/**
+ * Per-request options that can be passed to any SDK method.
+ * organizationId overrides the client-level default for a single call.
+ */
+interface RequestOptions {
+    /** Override the organization context for this request. */
+    organizationId?: string;
+    /** Additional query parameters appended to the URL (camelCase keys are converted to snake_case). */
+    params?: Record<string, string | number | boolean | undefined>;
+    /** An AbortSignal to cancel the in-flight request. */
+    signal?: AbortSignal;
+    /** Request-level timeout in milliseconds, overrides the client default. */
+    timeout?: number;
+}
+/**
+ * Standard success acknowledgement returned by mutation endpoints.
+ */
+interface SuccessResponse {
+    success: boolean;
+    message?: string;
+}
+/**
+ * Generic paginated list envelope.
+ * The API uses different pagination styles across resources; all optional
+ * fields that a particular endpoint may or may not include are represented here.
+ *
+ * @template T - The type of each item in the collection.
+ */
+interface PaginatedList<T> {
+    total: number;
+    page?: number;
+    page_size?: number;
+    total_pages?: number;
+    limit?: number;
+    offset?: number;
+    has_next?: boolean;
+    has_previous?: boolean;
+}
+
+/**
+ * Base class for all resource classes. Provides HTTP methods with
+ * retry logic, error handling, and organization ID resolution.
+ */
+declare abstract class BaseResource {
+    /** @internal */
+    protected readonly _config: ResolvedConfig;
+    constructor(config: ResolvedConfig);
+    /**
+     * Resolve the organization ID from per-request options or client default.
+     * @internal
+     */
+    private resolveOrgId;
+    /**
+     * Build full URL with query parameters.
+     * @internal
+     */
+    private buildUrl;
+    /**
+     * Build headers for a request.
+     * @internal
+     */
+    private buildHeaders;
+    /**
+     * Create an abort signal that combines timeout and user-provided signal.
+     * @internal
+     */
+    private createSignal;
+    /**
+     * Execute a fetch request with retry logic.
+     * @internal
+     */
+    private fetchWithRetry;
+    /**
+     * Calculate delay for exponential backoff with jitter.
+     * @internal
+     */
+    private calculateDelay;
+    /**
+     * Sleep for a given duration, respecting abort signals.
+     * @internal
+     */
+    private sleep;
+    /** Perform a GET request. */
+    protected _get<T>(path: string, options?: RequestOptions): Promise<T>;
+    /** Perform a POST request. */
+    protected _post<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** Perform a PUT request. */
+    protected _put<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** Perform a PATCH request. */
+    protected _patch<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** Perform a DELETE request. */
+    protected _delete<T>(path: string, body?: unknown, options?: RequestOptions): Promise<T>;
+    /** Open an SSE stream and return an async iterable of events. */
+    protected streamSSE(path: string, options?: RequestOptions): AsyncGenerator<SSEEvent>;
+    /** Perform a POST SSE stream request. */
+    protected streamSSEPost(path: string, body?: unknown, options?: RequestOptions): AsyncGenerator<SSEEvent>;
+    /** Upload a file using multipart/form-data. */
+    protected upload<T>(path: string, formData: FormData, options?: RequestOptions): Promise<T>;
+}
+
+/**
+ * Types for authentication, user identity, and organization membership.
+ * @module types/auth
+ */
+/**
+ * The role a user can hold within the platform.
+ */
+type UserRole = 'USER' | 'ADMIN' | 'SUPER_ADMIN';
+/**
+ * Full user object returned by identity endpoints.
+ */
+interface UserResponse {
+    id: string;
+    email: string;
+    username: string;
+    role: UserRole;
+    is_active: boolean;
+    /** IDs of all organizations the user belongs to. */
+    organization_ids: string[];
+    /** The user's primary / default organization. */
+    primary_organization_id: string | null;
+}
+/**
+ * Lightweight organization membership record returned inside user-centric responses.
+ */
+interface OrganizationInfo {
+    id: string;
+    name: string;
+    slug: string;
+    /** The calling user's role inside this organization. */
+    role: string;
+    created_at: string;
+}
+/**
+ * Response from listing the organizations a user belongs to.
+ */
+interface OrganizationsResponse {
+    success: boolean;
+    user_id: string;
+    organizations: OrganizationInfo[];
+    total: number;
+}
+/**
+ * A single organization invitation object.
+ */
+interface InvitationObject {
+    id: string;
+    organization_id: string;
+    organization_name?: string;
+    invited_email: string;
+    role: string;
+    status: string;
+    invitation_message?: string;
+    created_at: string;
+    expires_at?: string;
+}
+/**
+ * Response from listing pending invitations for the authenticated user.
+ */
+interface InvitationsResponse {
+    success: boolean;
+    invitations: InvitationObject[];
+    total: number;
+}
+/**
+ * Response from accepting or rejecting a single invitation.
+ */
+interface InvitationResponse {
+    success: boolean;
+    message?: string;
+    invitation: InvitationObject;
+}
+/**
+ * Response returned when a user leaves an organization.
+ */
+interface LeaveResponse {
+    success: boolean;
+    message: string;
+    /** The organization that was left. */
+    left_organization: {
+        id: string;
+        name: string;
+    };
+    /** The organizations the user still belongs to. */
+    remaining_organizations: {
+        id: string;
+        name: string;
+    }[];
+    total_remaining: number;
+}
+
+/**
+ * Types for API key management.
+ * @module types/api-keys
+ */
+/**
+ * Parameters for creating a new API key.
+ * Field names are camelCase; the SDK converts them to snake_case before sending.
+ */
+interface CreateApiKeyParams {
+    /** Human-readable label for the key. */
+    name: string;
+    /** Scope the key to a specific organization. Defaults to the client-level org. */
+    organizationId?: string;
+    /** ISO-8601 datetime after which the key becomes invalid. */
+    expiresAt?: string;
+    /** Maximum number of API calls allowed per minute for this key. */
+    rateLimitPerMinute?: number;
+}
+/**
+ * An API key object as returned by the API.
+ * The `key` field is only present immediately after creation.
+ */
+interface ApiKeyResponse {
+    id: string;
+    name: string;
+    /**
+     * The full secret key value.
+     * Only returned once, immediately after creation — store it securely.
+     */
+    key?: string;
+    /** Masked hint showing the first / last characters of the key. */
+    key_hint: string;
+    organization_id: string | null;
+    expires_at: string | null;
+    rate_limit_per_minute: number | null;
+    created_at: string;
+    is_revoked?: boolean;
+    revoked_at?: string | null;
+}
+/**
+ * Response returned when a new API key is created.
+ * Extends {@link ApiKeyResponse} and always includes the full `key`.
+ */
+interface CreateApiKeyResponse extends ApiKeyResponse {
+    /** The full secret key — only exposed on creation. */
+    key: string;
+}
+/**
+ * Response from listing API keys for an organization.
+ */
+interface ApiKeyListResponse {
+    keys: ApiKeyResponse[];
+    total?: number;
+}
+/**
+ * Response returned after revoking an API key.
+ */
+interface RevokeApiKeyResponse {
+    success: boolean;
+    message: string;
+}
+
+/**
+ * Types for organization management, LLM configuration, and member management.
+ * @module types/organizations
+ */
+/**
+ * Parameters for creating a new organization.
+ */
+interface CreateOrganizationParams {
+    /** Display name for the organization. */
+    name: string;
+    /** URL-safe slug. Auto-generated from `name` if omitted. */
+    slug?: string;
+}
+/**
+ * Minimal organization object embedded in creation responses.
+ */
+interface OrganizationCreatedObject {
+    id: string;
+    name: string;
+    slug: string;
+}
+/**
+ * Response from the create-organization endpoint.
+ */
+interface CreateOrganizationResponse {
+    success: boolean;
+    message: string;
+    organization: OrganizationCreatedObject;
+}
+/**
+ * A single LLM integration entry as returned by the organization LLM list.
+ */
+interface LLMEntry {
+    [key: string]: unknown;
+}
+/**
+ * Response from listing LLM integrations for an organization.
+ */
+interface LLMsResponse {
+    success: boolean;
+    total: number;
+    active_llm_total: number;
+    inactive_llm_total: number;
+    /** Array of active LLM integration objects. */
+    active_llms: LLMEntry[];
+    /** Array of inactive LLM integration objects. */
+    inactive_llms: LLMEntry[];
+}
+/**
+ * Parameters for inviting a user to the organization.
+ */
+interface InviteParams {
+    /** Email address of the person being invited. */
+    invitedEmail: string;
+    /** Role to assign upon acceptance. Defaults to `'member'`. */
+    role?: string;
+    /** Optional personal message included in the invitation email. */
+    invitationMessage?: string;
+}
+/**
+ * Response returned after cancelling a pending invitation.
+ */
+interface CancelInvitationResponse {
+    success: boolean;
+    message: string;
+}
+/**
+ * Parameters for updating a member's role within an organization.
+ */
+interface RoleUpdateParams {
+    /** New role to assign. */
+    role: 'member' | 'admin';
+}
+/**
+ * Response returned after a successful role update.
+ */
+interface RoleUpdateResponse {
+    success: boolean;
+    message: string;
+    user_id: string;
+    organization_id: string;
+    new_role: string;
+}
+
+/**
+ * Types for workflow definitions, nodes, edges, and builder metadata.
+ * This is the largest type module — it covers the full workflow DSL used
+ * across the create, update, run, and builder endpoints.
+ * @module types/workflows
+ */
+/**
+ * Human-readable metadata attached to a workflow.
+ */
+interface WorkflowMetadata {
+    name: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    tags?: string[];
+}
+/**
+ * Runtime configuration defaults for a workflow.
+ */
+interface WorkflowConfig {
+    /** Default LLM configuration used when a node does not specify one. */
+    default_llm?: LLMConfig;
+    /** Default list of tool definitions available to agent nodes. */
+    default_tools?: ToolDefinition[];
+    /** Maximum number of recursive node invocations before aborting. */
+    recursion_limit?: number;
+    /** Checkpointing backend identifier (e.g. `"postgres"`). */
+    checkpointing?: string;
+}
+/**
+ * Definition of a single field in the workflow state schema.
+ */
+interface StateSchemaField {
+    /** JSON Schema type string (e.g. `"string"`, `"number"`, `"array"`). */
+    type: string;
+    description?: string;
+    /** LangGraph reducer function name or expression applied to updates. */
+    reducer?: string;
+    required?: boolean;
+    default?: unknown;
+}
+/**
+ * The complete state schema for a workflow, keyed by field name.
+ */
+interface StateSchema {
+    fields: Record<string, StateSchemaField>;
+}
+/**
+ * All valid node type identifiers in the workflow graph.
+ */
+type NodeType = 'llm' | 'tool' | 'agent' | 'function' | 'conditional' | 'interrupt' | 'transformer' | 'guardrails' | 'knowledge';
+/**
+ * Identifies a specific LLM model from a provider integration.
+ */
+interface LLMConfig {
+    /** The name of the LLM integration (e.g. `"openai"`). */
+    integration_name: string;
+    /** Provider ID within the integration (e.g. `"openai"`). */
+    provider_id: string;
+    /** Model identifier (e.g. `"gpt-4o"`). */
+    model_id: string;
+    /** Sampling temperature (0–2). */
+    temperature?: number;
+    /** Credential ID to use when calling this model. */
+    credential_id?: string;
+}
+/**
+ * Selects a specific action from a tool integration.
+ */
+interface ToolDefinition {
+    /** The name of the tool integration (e.g. `"github"`). */
+    integration_name: string;
+    /** Action / service name within the integration. */
+    service_name: string;
+    /** Credential ID to use for authenticated tool calls. */
+    credential_id?: string;
+    /** Static defaults to merge into the tool's input parameters. */
+    parameter_defaults?: Record<string, unknown>;
+    /** Values that override user-supplied parameters at runtime. */
+    parameter_overrides?: Record<string, unknown>;
+}
+/**
+ * Retry policy applied to a node on transient failures.
+ */
+interface RetryConfig {
+    /** Maximum number of retry attempts. */
+    max_attempts?: number;
+    /** Initial wait interval in milliseconds before the first retry. */
+    initial_interval?: number;
+    /** Multiplier applied to the interval on each subsequent retry. */
+    backoff_factor?: number;
+}
+/**
+ * Configuration for an `llm` node — calls an LLM and stores the response.
+ */
+interface LLMNodeConfig {
+    llm: LLMConfig;
+    /** System prompt template (supports state interpolation via `{{field}}`). */
+    system_prompt?: string;
+    /** User prompt template. */
+    user_prompt?: string;
+    /** JSON Schema describing the expected structured output format. */
+    structured_output_schema?: Record<string, unknown>;
+}
+/**
+ * Configuration for a `tool` node — executes a single tool action.
+ */
+interface ToolNodeConfig {
+    tool: ToolDefinition;
+    /** Maps state fields to tool input parameters. */
+    input_mapping?: Record<string, string>;
+}
+/**
+ * Configuration for an `agent` node — an LLM with tool-use capabilities.
+ */
+interface AgentNodeConfig {
+    llm: LLMConfig;
+    /** Tools available to this agent. */
+    tools?: ToolDefinition[];
+    system_prompt?: string;
+    user_prompt?: string;
+    /** Maximum tool-call iterations before the agent yields. */
+    max_iterations?: number;
+    input_mapping?: Record<string, string>;
+}
+/**
+ * Configuration for a `function` node — executes arbitrary registered code.
+ * Shape is integration-specific and passed through without transformation.
+ */
+interface FunctionNodeConfig {
+    [key: string]: unknown;
+}
+/**
+ * A single branch in a conditional node evaluated against runtime state.
+ */
+interface ConditionalBranch {
+    name: string;
+    /** Boolean expression evaluated against the workflow state. */
+    condition: string;
+    /** Node ID to route to when the condition is truthy. */
+    target: string;
+}
+/**
+ * Loop execution configuration for a `conditional` node used as a loop.
+ */
+interface LoopConfig {
+    loop_id: string;
+    /** `"for"` | `"foreach"` | `"while"` — how to determine iterations. */
+    mode: string;
+    /** Fixed iteration count for `"for"` mode. */
+    iterations?: number;
+    /** State field containing the collection to iterate over for `"foreach"` mode. */
+    collection?: string;
+    /** Boolean expression used for `"while"` mode. */
+    condition?: string;
+    /** First node inside the loop body. */
+    body_target?: string;
+    /** Last node inside the loop body. */
+    body_end?: string;
+    /** Node to route to when the loop exits. */
+    exit_target?: string;
+    /** Hard upper bound on iterations to prevent infinite loops. */
+    max_iterations?: number;
+}
+/**
+ * Configuration for a `conditional` node — branches or loops based on state.
+ */
+interface ConditionalNodeConfig {
+    /** `"expression"` | `"llm"` | `"loop"` */
+    condition_type: string;
+    /** Named routes mapping route names to target node IDs. */
+    routes?: Record<string, string>;
+    /** Ordered list of conditional branches evaluated top-to-bottom. */
+    expression_branches?: ConditionalBranch[];
+    loop_config?: LoopConfig;
+}
+/**
+ * Configuration for an `interrupt` node — pauses execution for human input.
+ */
+interface InterruptNodeConfig {
+    /** Message shown to the human reviewer. */
+    message?: string;
+    /** JSON Schema describing the shape of the resume value. */
+    resume_schema?: Record<string, unknown>;
+    /** Example resume values shown in the UI. */
+    examples?: unknown[];
+}
+/**
+ * A single data-transformation operation applied by a `transformer` node.
+ */
+interface TransformerOperation {
+    /** Operation type (e.g. `"set"`, `"delete"`, `"map"`, `"filter"`, `"template"`). */
+    type: string;
+    /** JSON Pointer or dot-notation path to the target field. */
+    path?: string;
+    /** Boolean expression used for conditional operations. */
+    condition?: string;
+    /** Jinja-style template string for `"template"` operations. */
+    template?: string;
+}
+/**
+ * Configuration for a `transformer` node — reshapes state between nodes.
+ */
+interface TransformerNodeConfig {
+    /** Source state field to read from. */
+    source?: string;
+    /** Ordered list of transformation operations. */
+    operations?: TransformerOperation[];
+}
+/**
+ * Configuration for a `guardrails` node — validates or filters content.
+ * Shape is provider-specific and passed through without transformation.
+ */
+interface GuardrailsNodeConfig {
+    [key: string]: unknown;
+}
+/**
+ * Configuration for a `knowledge` node — retrieves context from a knowledge base.
+ */
+interface KnowledgeNodeConfig {
+    credential_id?: string;
+    /** Provider type identifier (e.g. `"pinecone"`, `"weaviate"`). */
+    provider_type?: string;
+    /** Query string or state field reference to search with. */
+    query?: string;
+    collection_name?: string;
+    /** Number of top results to return. */
+    top_k?: number;
+    /** Minimum similarity score threshold (0–1). */
+    min_score?: number;
+    /** Provider-specific metadata filters. */
+    filters?: Record<string, unknown>;
+    /** Embedding model configuration used for the similarity search. */
+    embedding_config?: Record<string, unknown>;
+}
+/**
+ * A single node in the workflow graph.
+ */
+interface NodeDefinition {
+    /** Unique identifier for this node within the workflow. */
+    id: string;
+    type: NodeType;
+    name: string;
+    description?: string;
+    /** Whether the node participates in execution. Defaults to `true`. */
+    enabled?: boolean;
+    /** Canvas X position (used by the visual editor). */
+    x?: number;
+    /** Canvas Y position (used by the visual editor). */
+    y?: number;
+    retry_config?: RetryConfig;
+    llm_config?: LLMNodeConfig;
+    tool_config?: ToolNodeConfig;
+    agent_config?: AgentNodeConfig;
+    function_config?: FunctionNodeConfig;
+    conditional_config?: ConditionalNodeConfig;
+    interrupt_config?: InterruptNodeConfig;
+    transformer_config?: TransformerNodeConfig;
+    guardrails_config?: GuardrailsNodeConfig;
+    knowledge_config?: KnowledgeNodeConfig;
+}
+/**
+ * A directed edge connecting two nodes in the workflow graph.
+ */
+interface EdgeDefinition {
+    /** ID of the source node. */
+    source: string;
+    /** ID of the target node. */
+    target: string;
+}
+/**
+ * The complete, serializable definition of a workflow.
+ * This is what is stored, versioned, and executed.
+ */
+interface WorkflowDefinition {
+    metadata: WorkflowMetadata;
+    config: WorkflowConfig;
+    state_schema: StateSchema;
+    nodes: NodeDefinition[];
+    edges: EdgeDefinition[];
+    /** ID of the first node to execute. */
+    entry_point: string;
+}
+/**
+ * Parameters for creating a new workflow.
+ */
+interface CreateWorkflowParams {
+    /** The full workflow graph definition. */
+    workflowSchema: WorkflowDefinition;
+    name?: string;
+    description?: string;
+    version?: string;
+    tags?: string[];
+    category?: string;
+    /** Lifecycle status (e.g. `"draft"`, `"published"`). */
+    status?: string;
+    /** Sharing visibility (e.g. `"private"`, `"organization"`, `"public"`). */
+    visibility?: string;
+    /** Default input values shown in the run panel. */
+    input?: Record<string, unknown>;
+    /** Override config values for this workflow. */
+    config?: Partial<WorkflowConfig>;
+}
+/**
+ * Parameters for updating an existing workflow.
+ * All fields are optional; only provided fields are updated.
+ */
+interface UpdateWorkflowParams {
+    name?: string;
+    description?: string;
+    version?: string;
+    tags?: string[];
+    category?: string;
+    status?: string;
+    visibility?: string;
+    workflowSchema?: WorkflowDefinition;
+    input?: Record<string, unknown>;
+    config?: Partial<WorkflowConfig>;
+}
+/**
+ * Lightweight workflow record returned in list responses.
+ */
+interface WorkflowSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    version: string;
+    status: string;
+    visibility: string;
+    category: string | null;
+    tags: string[];
+    created_at: string;
+    updated_at: string;
+    creator_id: string;
+}
+/**
+ * Full workflow record including the stored schema.
+ */
+interface WorkflowResponse extends WorkflowSummary {
+    workflow_schema: WorkflowDefinition;
+    edit_version?: number;
+    last_edited_by?: string | null;
+    last_edited_at?: string | null;
+    organization_id: string;
+}
+/**
+ * Query parameters for listing workflows.
+ */
+interface WorkflowListParams {
+    status?: string;
+    category?: string;
+    visibility?: string;
+    search?: string;
+    page?: number;
+    pageSize?: number;
+    organizationId?: string;
+}
+/**
+ * Paginated list of workflow summaries.
+ */
+interface WorkflowListResponse {
+    workflows: WorkflowSummary[];
+    total: number;
+    page?: number;
+    page_size?: number;
+    total_pages?: number;
+}
+/**
+ * Response from deleting a workflow.
+ */
+interface DeleteWorkflowResponse {
+    /** HTTP-style status string (e.g. `"deleted"`). */
+    status: string;
+    workflow_id: string;
+    message: string;
+}
+/**
+ * Query parameters for fetching node type and integration details from the builder.
+ */
+interface BuilderDetailsParams {
+    /** Filter to a specific node type. */
+    nodeType?: string;
+    /** Filter to a specific category. */
+    category?: string;
+    /** Filter to a specific integration name. */
+    integrationName?: string;
+    organizationId?: string;
+}
+/**
+ * Response from the builder details endpoint, providing the palette of
+ * available node types, integration categories, and their counts.
+ */
+interface BuilderDetailsResponse {
+    /** Map of node type identifier to its descriptor. */
+    node_types: Record<string, unknown>;
+    /** Available integration categories. */
+    categories: string[];
+    /** Count breakdown by category or type. */
+    counts: Record<string, number>;
+    /** Whether the response was served from cache. */
+    cached: boolean;
+}
+
+/**
+ * Types for workflow execution — running, resuming, cancelling, and streaming.
+ * @module types/executions
+ */
+
+/**
+ * Parameters for triggering a workflow run.
+ */
+interface WorkflowRunParams {
+    /** ID of a previously saved workflow to run. Mutually exclusive with `workflow`. */
+    workflowId?: string;
+    /** An inline workflow definition to run without saving. */
+    workflow?: WorkflowDefinition;
+    /** Override the LLM used by the run. */
+    llm?: LLMConfig;
+    /** Name of a system-level workflow to run (e.g. `"workflow_name"`). */
+    systemWorkflow?: string;
+    /** State input values passed to the workflow's entry node. */
+    input?: Record<string, unknown>;
+    /** Runtime config overrides for this execution. */
+    config?: Record<string, unknown>;
+    /** Whether to open an SSE stream for real-time events. */
+    stream?: boolean;
+    /** If `true`, the run is not persisted and no thread is created. */
+    ephemeral?: boolean;
+    /** If `true`, the run and its messages are only visible to the creator. */
+    isPrivate?: boolean;
+    /** Knowledge base retrieval config for this run. */
+    knowledgeConfig?: Record<string, unknown>;
+    organizationId?: string;
+}
+/**
+ * Response from initiating a workflow run.
+ */
+interface WorkflowRunResponse {
+    /** Terminal or intermediate status (e.g. `"completed"`, `"running"`, `"interrupted"`). */
+    status: string;
+    run_id: string;
+    thread_id: string;
+    chat_id: string | null;
+    ephemeral: boolean;
+    stream: boolean;
+    workflow_name: string;
+    workflow_version: string;
+    /** `"saved"` | `"inline"` | `"deployment"` */
+    workflow_source: string;
+    /** Wall-clock duration of the synchronous portion in milliseconds. */
+    elapsed_ms: number;
+    human_message?: Record<string, unknown> | null;
+    ai_message?: Record<string, unknown> | null;
+    message: string;
+}
+/**
+ * The persisted state snapshot of a workflow thread at a given checkpoint.
+ */
+interface WorkflowStateResponse {
+    thread_id: string;
+    run_id: string;
+    checkpoint_id: string;
+    /** The full LangGraph state object. */
+    state: Record<string, unknown>;
+    /** Node IDs scheduled to execute next. */
+    next: string[];
+    /** LangGraph metadata blob. */
+    metadata: Record<string, unknown>;
+    /** Number of writes pending flush to the checkpoint store. */
+    pending_writes: number;
+}
+/**
+ * Parameters for resuming a workflow that is waiting at an interrupt node.
+ */
+interface WorkflowResumeParams {
+    /** The thread ID to resume (required — used as path parameter). */
+    threadId: string;
+    /** ID of the saved workflow. Required unless `workflow` is provided. */
+    workflowId?: string;
+    /** Inline workflow definition to resume. */
+    workflow?: WorkflowDefinition;
+    /** The value to inject at the interrupt point (required). */
+    resumeValue: unknown;
+    /** The run ID to resume (required). */
+    runId: string;
+    /** Whether to open an SSE stream for the resumed execution. */
+    stream?: boolean;
+    organizationId?: string;
+}
+/**
+ * Response from resuming an interrupted workflow run.
+ */
+interface WorkflowResumeResponse {
+    status: string;
+    run_id: string;
+    thread_id: string;
+    stream: boolean;
+    workflow_source: string;
+    message: string;
+}
+/**
+ * Response from cancelling an in-progress workflow run.
+ */
+interface CancelResponse {
+    status: string;
+    run_id: string;
+    reason: string;
+    message: string;
+}
+/**
+ * Data payload for the `metadata` SSE event — emitted at the start of a run.
+ */
+interface MetadataEventData {
+    run_id: string;
+    thread_id: string;
+    workflow_name: string;
+    workflow_version: string;
+    /** Ordered list of node IDs in the execution plan. */
+    nodes: string[];
+}
+/**
+ * Data payload for a `node_update` SSE event — emitted as each node changes state.
+ */
+interface NodeUpdateEventData {
+    node_id: string;
+    node_type: string;
+    status: 'started' | 'completed' | 'error';
+    /** Node output value (present when `status` is `"completed"`). */
+    output?: unknown;
+    /** Error message (present when `status` is `"error"`). */
+    error?: string;
+    /** How long the node took to execute, in milliseconds. */
+    execution_time_ms?: number;
+}
+/**
+ * Data payload for an `interrupt` SSE event — execution is paused for human input.
+ */
+interface InterruptEventData {
+    message: string;
+    /** Current workflow state at the point of interruption. */
+    state: Record<string, unknown>;
+    /** Instructions describing what the human should supply as a resume value. */
+    resume_instructions?: string;
+    /** ID of the node that triggered the interrupt. */
+    node_id: string;
+}
+/**
+ * Data payload for a `resumed` SSE event — a previously interrupted run has continued.
+ */
+interface ResumedEventData {
+    run_id: string;
+    thread_id: string;
+}
+/**
+ * Data payload for the `done` SSE event — the workflow has finished executing.
+ */
+interface DoneEventData {
+    final_state: Record<string, unknown>;
+    steps_executed: number;
+    total_execution_time_ms: number;
+}
+/**
+ * Data payload for an `error` SSE event — an unrecoverable error occurred.
+ */
+interface ErrorEventData {
+    error_message: string;
+    error_type?: string;
+    /** ID of the node where the error originated, if applicable. */
+    node_id?: string;
+    stack_trace?: string;
+}
+/**
+ * A type-safe discriminated union of all possible SSE events emitted during
+ * a workflow run or resume stream.
+ *
+ * Discriminate on the `event` field to narrow the `data` type:
+ * ```ts
+ * for await (const evt of stream) {
+ *   if (evt.event === 'done') {
+ *     console.log(evt.data.final_state);
+ *   }
+ * }
+ * ```
+ */
+type WorkflowSSEEvent = {
+    event: 'metadata';
+    data: MetadataEventData;
+} | {
+    event: 'node_update';
+    data: NodeUpdateEventData;
+} | {
+    event: 'interrupt';
+    data: InterruptEventData;
+} | {
+    event: 'resumed';
+    data: ResumedEventData;
+} | {
+    event: 'done';
+    data: DoneEventData;
+} | {
+    event: 'error';
+    data: ErrorEventData;
+};
+
+/**
+ * Types for workflow deployment management.
+ * @module types/deployments
+ */
+
+/**
+ * Parameters for creating a deployment snapshot of a workflow.
+ */
+interface CreateDeploymentParams {
+    /** Human-readable release note describing what changed in this deployment. */
+    deploymentNote?: string;
+    /** URL to a preview image of the workflow schema canvas. */
+    schemaImageUrl?: string;
+}
+/**
+ * A deployment record as returned by list and summary endpoints.
+ */
+interface DeploymentResponse {
+    id: string;
+    workflow_id: string;
+    name: string;
+    version: string;
+    deployment_note: string | null;
+    schema_image_url: string | null;
+    deployed_by: string;
+    created_at: string;
+    /** Whether this deployment is currently the live (active) version. */
+    is_live: boolean;
+}
+/**
+ * Query parameters for listing deployments.
+ */
+interface DeploymentListParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated list of deployment records.
+ */
+interface DeploymentListResponse {
+    deployments: DeploymentResponse[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Full deployment record including the stored workflow schema and run config.
+ * Returned by the get-single-deployment endpoint.
+ */
+interface DeploymentDetailResponse extends DeploymentResponse {
+    /** The full workflow graph definition at the time of this deployment. */
+    workflow_schema: WorkflowDefinition;
+    /** Default input values stored with the deployment. */
+    input: Record<string, unknown> | null;
+    /** Runtime configuration stored with the deployment. */
+    config: Record<string, unknown> | null;
+}
+/**
+ * Response from activating a deployment (making it the live version).
+ */
+interface ActivateDeploymentResponse {
+    success: boolean;
+    message: string;
+    deployment_id: string;
+    /** The deployment that was previously live, if any. */
+    previous_live_deployment_id: string | null;
+}
+/**
+ * Response from deactivating the current live deployment.
+ */
+interface DeactivateDeploymentResponse {
+    success: boolean;
+    message: string;
+    /** The deployment that was deactivated. */
+    previous_live_deployment_id: string;
+}
+/**
+ * Response from deleting a deployment.
+ */
+interface DeleteDeploymentResponse {
+    success: boolean;
+    message: string;
+    deleted_deployment_id: string;
+    /** Whether the deleted deployment was the live version. */
+    was_live: boolean;
+    /**
+     * The deployment automatically promoted to live status after deletion,
+     * if any (only present when `was_live` is `true`).
+     */
+    new_live_deployment_id: string | null;
+}
+
+/**
+ * Types for chat session management and messaging.
+ * @module types/chats
+ */
+/**
+ * A chat session record.
+ */
+interface ChatResponse {
+    id: string;
+    title: string | null;
+    creator_id: string;
+    is_private: boolean;
+    /** ID of the currently in-progress run attached to this chat, if any. */
+    running_id: string | null;
+    created_at: string;
+    updated_at: string;
+    organization_id?: string | null;
+    /** Messages are included when fetching a single chat with messages embedded. */
+    messages?: ChatMessageResponse[];
+    deleted_at?: string | null;
+}
+/**
+ * The role of a participant in a chat message.
+ */
+type ChatMessageRole = 'human' | 'ai' | 'system';
+/**
+ * A single message within a chat session.
+ */
+interface ChatMessageResponse {
+    id: string;
+    chat_id: string;
+    role: ChatMessageRole;
+    /** Message content — can be a string, structured array, or object depending on message type. */
+    content: string | unknown[] | Record<string, unknown>;
+    /** Name or version of the workflow that produced an `ai` message. */
+    workflow?: string | null;
+    run_id?: string | null;
+    /** Execution status of the run that produced this message (for `ai` messages). */
+    running_status?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Query parameters for paginating messages within a chat.
+ */
+interface ChatMessagesParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated list of messages within a chat.
+ */
+interface ChatMessagesResponse {
+    messages: ChatMessageResponse[];
+    total: number;
+    limit: number;
+    offset: number;
+    has_next: boolean;
+    /** The number of messages actually returned (may differ from `limit` on the last page). */
+    actual_count: number;
+}
+/**
+ * Parameters for updating a chat's metadata.
+ */
+interface UpdateChatParams {
+    title?: string;
+    isPrivate?: boolean;
+    /** Move the chat to a named folder (e.g. `"pinned"`, `"archived"`, or a custom name). */
+    folder?: string;
+}
+/**
+ * Grouped chat list response.
+ *
+ * Keys are dynamic folder names: at minimum `"chats"`, `"pinned"`, and
+ * `"archived"` are present; user-created custom folders appear as additional keys.
+ *
+ * @example
+ * ```ts
+ * const list: ChatListResponse = await client.chats.list();
+ * const pinned = list['pinned'] ?? [];
+ * ```
+ */
+type ChatListResponse = Record<string, ChatResponse[]>;
+
+/**
+ * Types for credential management and MCP server connections.
+ * @module types/credentials
+ */
+/**
+ * A stored credential record as returned by the API.
+ */
+interface CredentialResponse {
+    credential_id: string;
+    integration_name: string;
+    /** Integration category (e.g. `"tool"`, `"llm"`, `"knowledge"`). */
+    integration_type: string;
+    /** Human-readable label for the credential. */
+    display_name: string;
+    /** Auth mechanism used (e.g. `"api_key"`, `"oauth2"`, `"basic"`). */
+    auth_type: string;
+    /** Whether this is the default credential for its integration. */
+    is_default: boolean;
+    created_at: string;
+    updated_at: string;
+    last_used_at?: string | null;
+    expires_at?: string | null;
+}
+/**
+ * Parameters for creating a new credential.
+ */
+interface CreateCredentialParams {
+    /** Integration name to create the credential for (e.g. `"openai"`). */
+    integrationName: string;
+    /** Auth data object — shape depends on `authType` and the integration. */
+    authData?: Record<string, unknown>;
+    /** Auth mechanism (e.g. `"api_key"`, `"oauth2"`). */
+    authType?: string;
+    /** Human-readable label. Defaults to the integration display name. */
+    displayName?: string;
+    /** Arbitrary metadata to associate with the credential. */
+    metadata?: Record<string, unknown>;
+    /** Whether to set this credential as the default for its integration. */
+    makeDefault?: boolean;
+    /** OAuth2-specific configuration when creating via OAuth. */
+    oauthConfig?: Record<string, unknown>;
+    /** ISO-8601 datetime after which the credential should be considered expired. */
+    expiresAt?: string;
+}
+/**
+ * Parameters for updating an existing credential.
+ */
+interface UpdateCredentialParams {
+    displayName?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A single integration group entry within the grouped credential list.
+ */
+interface CredentialIntegrationGroup {
+    integration_name: string;
+    integration_type: string;
+    total_count: number;
+    auth_types: string[];
+    credentials: CredentialResponse[];
+}
+/**
+ * Credential list response in grouped-by-integration format.
+ * Returned when no `integrationName` filter is applied.
+ */
+interface CredentialListGrouped {
+    integrations: Record<string, CredentialIntegrationGroup>;
+    total_credentials: number;
+    total_integrations: number;
+    filters: Record<string, unknown>;
+}
+/**
+ * Credential list response in flat format.
+ * Returned when an `integrationName` filter is applied.
+ */
+interface CredentialListFlat {
+    credentials: CredentialResponse[];
+    total_count: number;
+    integration_name: string | null;
+    filters: Record<string, unknown>;
+}
+/**
+ * Query parameters for listing credentials.
+ */
+interface CredentialListParams {
+    integrationName?: string;
+    authType?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Parameters for testing a temporary (unsaved) credential.
+ */
+interface TestTemporaryParams {
+    integrationName: string;
+    authType: string;
+    authData: Record<string, unknown>;
+}
+/**
+ * Response from testing a temporary credential before saving it.
+ */
+interface TestTemporaryResponse {
+    is_valid: boolean;
+    message: string;
+    tested_at: string;
+    test_method: string;
+    integration_name: string;
+    auth_type: string;
+    /** Endpoint that was contacted during the test, if applicable. */
+    test_endpoint?: string | null;
+    /** HTTP status code returned by the test endpoint, if applicable. */
+    status_code?: number | null;
+    /** Relative API cost of the test call (e.g. `"free"`, `"low"`, `"medium"`). */
+    cost_level?: string | null;
+}
+/**
+ * Response from testing an existing saved credential.
+ */
+interface TestCredentialResponse {
+    credential_id: string;
+    is_valid: boolean;
+    message: string;
+    tested_at: string;
+}
+/**
+ * Query parameters for fetching credential usage statistics.
+ */
+interface CredentialUsageParams {
+    startDate?: string;
+    endDate?: string;
+}
+/**
+ * Usage statistics for a credential over a date range.
+ */
+interface CredentialUsageResponse {
+    credential_id: string;
+    total_calls: number;
+    successful_calls: number;
+    failed_calls: number;
+    /** Success rate as a fraction (0–1). */
+    success_rate: number;
+    /** Call counts broken down by action / operation name. */
+    action_breakdown: Record<string, number>;
+    start_date: string;
+    end_date: string;
+}
+/**
+ * Query parameters for paginating a credential's audit log.
+ */
+interface CredentialAuditParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Parameters for connecting a Model Context Protocol (MCP) server as a credential.
+ */
+interface McpServerParams {
+    /** URL of the MCP server. */
+    serverUrl: string;
+    /** Additional HTTP headers sent to the MCP server on each request. */
+    headers?: Record<string, string>;
+    /** Human-readable label for this MCP server credential. */
+    displayName?: string;
+    /** Whether to set this as the default MCP credential. */
+    makeDefault?: boolean;
+}
+/**
+ * Response listing tools discovered from an MCP server credential.
+ */
+interface McpToolsResponse {
+    credential_id: string;
+    /** Array of tool descriptors in MCP schema format. */
+    tools: Record<string, unknown>[];
+    total_count: number;
+}
+/**
+ * Response from refreshing the tool discovery cache for an MCP server credential.
+ */
+interface RefreshDiscoveryResponse {
+    credential_id: string;
+    refreshed_at: string;
+    /** Summary of what changed (added / removed tools). */
+    changes: Record<string, unknown>;
+    total_tools: number;
+    success: boolean;
+}
+
+/**
+ * Types for browsing the integration catalog and fetching provider details.
+ * @module types/integrations
+ */
+/**
+ * Query parameters for browsing the integration catalog.
+ */
+interface BrowseParams {
+    /** Filter by category (e.g. `"communication"`, `"storage"`, `"llm"`). */
+    category?: string;
+    /** Filter by integration type (e.g. `"tool"`, `"llm_provider"`, `"knowledge_provider"`). */
+    type?: string;
+    /** Filter by supported auth type (e.g. `"api_key"`, `"oauth2"`). */
+    authType?: string;
+    /** Full-text search query against name and description. */
+    search?: string;
+    /** Whether to include full action/schema details in the response. */
+    includeDetails?: boolean;
+    /** Whether to return a paginated response. */
+    paginate?: boolean;
+    page?: number;
+    pageSize?: number;
+}
+/**
+ * Response from the catalog browse endpoint.
+ */
+interface BrowseResponse {
+    integrations: IntegrationResponse[];
+    total: number;
+    page?: number;
+    page_size?: number;
+    total_pages?: number;
+}
+/**
+ * Generic integration object as returned by catalog and detail endpoints.
+ * Fields beyond the listed ones are provider-specific and accessed via the index signature.
+ */
+interface IntegrationResponse {
+    name: string;
+    /** Integration category (e.g. `"tool"`, `"llm_provider"`, `"knowledge_provider"`). */
+    type: string;
+    display_name?: string;
+    description?: string;
+    /** Available action/service names. */
+    actions?: string[];
+    /** Authentication schema descriptors. */
+    auth_schemas?: Record<string, unknown>[];
+    icon_url?: string;
+    [key: string]: unknown;
+}
+/**
+ * Detailed tool integration response including action definitions.
+ */
+interface ToolIntegrationResponse {
+    integration_name: string;
+    display_name?: string;
+    description?: string;
+    /** Map of action name to action descriptor. */
+    actions?: Record<string, unknown>;
+    auth_types?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Detailed LLM provider response including available models.
+ */
+interface LLMProviderResponse {
+    provider_name: string;
+    display_name?: string;
+    models?: Record<string, unknown>[];
+    auth_types?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Detailed knowledge provider response including supported collection features.
+ */
+interface KnowledgeProviderResponse {
+    provider_name: string;
+    display_name?: string;
+    auth_types?: string[];
+    [key: string]: unknown;
+}
+
+/**
+ * Types for knowledge base management, document ingestion, and semantic search.
+ * @module types/knowledge
+ */
+/**
+ * Configuration for the embedding model used to vectorize documents and queries.
+ */
+interface EmbeddingConfig {
+    /** Credential ID for the embedding provider. */
+    provider_credential_id?: string;
+    /** Provider name (e.g. `"openai"`, `"cohere"`). */
+    provider?: string;
+    /** Model identifier (e.g. `"text-embedding-3-small"`). */
+    model?: string;
+    /** Expected vector dimension for the model. */
+    dimension?: number;
+}
+/**
+ * Configuration for how documents are split into chunks before indexing.
+ */
+interface ChunkingConfig {
+    /** Chunking strategy (e.g. `"recursive"`, `"sentence"`, `"fixed"`). */
+    strategy?: string;
+    /** Target token/character count per chunk. */
+    chunk_size?: number;
+    /** Overlap in tokens/characters between consecutive chunks. */
+    overlap?: number;
+    /** Custom separator strings used by recursive/sentence strategies. */
+    separators?: string[];
+}
+/**
+ * Parameters for creating a new knowledge base.
+ */
+interface CreateKnowledgeBaseParams {
+    name: string;
+    description?: string;
+    /** Embedding model configuration for this knowledge base. */
+    embeddingConfig?: EmbeddingConfig;
+    /** Chunking strategy configuration for ingested documents. */
+    chunkingConfig?: ChunkingConfig;
+}
+/**
+ * Parameters for updating an existing knowledge base.
+ * All fields are optional; only provided fields are updated.
+ */
+interface UpdateKnowledgeBaseParams {
+    name?: string;
+    description?: string;
+    embeddingConfig?: EmbeddingConfig;
+    chunkingConfig?: ChunkingConfig;
+    /** Lifecycle status (e.g. `"active"`, `"paused"`). */
+    status?: string;
+}
+/**
+ * A knowledge base record as returned by the API.
+ */
+interface KnowledgeBaseResponse {
+    id: string;
+    name: string;
+    description: string | null;
+    organization_id: string;
+    embedding_config: EmbeddingConfig;
+    chunking_config: ChunkingConfig;
+    /** Lifecycle status (e.g. `"active"`, `"building"`, `"error"`). */
+    status: string;
+    document_count?: number;
+    total_chunks?: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Query parameters for listing knowledge bases.
+ */
+interface KnowledgeBaseListParams {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated list of knowledge bases.
+ */
+interface KnowledgeBaseListResponse {
+    knowledge_bases: KnowledgeBaseResponse[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * Aggregated statistics across all knowledge bases in an organization.
+ * The shape is extensible; provider-specific fields may be present.
+ */
+interface KnowledgeBaseStatsResponse {
+    [key: string]: unknown;
+}
+/**
+ * A document record as returned by the API.
+ */
+interface DocumentResponse {
+    id: string;
+    knowledge_base_id: string;
+    filename: string;
+    file_type: string;
+    file_size: number;
+    /** Processing status (e.g. `"pending"`, `"processing"`, `"ready"`, `"error"`). */
+    status: string;
+    metadata?: Record<string, unknown>;
+    chunk_count?: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Query parameters for listing documents within a knowledge base.
+ */
+interface DocumentListParams {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Parameters for uploading a document to a knowledge base.
+ */
+interface UploadDocumentParams {
+    /** File content as a Blob or File object. */
+    file: Blob | File;
+    /** Override the filename stored with the document. */
+    filename?: string;
+    /** Arbitrary metadata to associate with the document. */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Status and progress of a document being processed.
+ */
+interface DocumentStatusResponse {
+    status: string;
+    /** Processing progress as a fraction (0–1). */
+    progress?: number;
+    error?: string;
+}
+/**
+ * A single document chunk as returned by the chunks endpoint or a search result.
+ */
+interface ChunkResponse {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    /** Similarity score (0–1). Present only in search results. */
+    score?: number;
+}
+/**
+ * Query parameters for listing chunks within a document.
+ */
+interface DocumentChunksParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Response from the document chunks endpoint.
+ */
+interface DocumentChunksResponse {
+    chunks: ChunkResponse[];
+    count: number;
+}
+/**
+ * Parameters for semantic search within a single knowledge base.
+ */
+interface SearchParams {
+    query: string;
+    topK?: number;
+    minScore?: number;
+    filters?: Record<string, unknown>;
+    includeContent?: boolean;
+    includeMetadata?: boolean;
+}
+/**
+ * A single search result entry.
+ */
+interface SearchResult {
+    chunk_id: string;
+    content: string;
+    score: number;
+    metadata: Record<string, unknown>;
+    document_id: string;
+}
+/**
+ * Response from a knowledge base search.
+ */
+interface SearchResponse {
+    results: SearchResult[];
+    query: string;
+    total: number;
+}
+/**
+ * Parameters for searching across multiple knowledge bases simultaneously.
+ */
+interface MultiSearchParams {
+    knowledgeBaseIds: string[];
+    query: string;
+    topK?: number;
+    minScore?: number;
+}
+/**
+ * Parameters for hybrid (semantic + keyword) search within a knowledge base.
+ */
+interface HybridSearchParams {
+    query: string;
+    topK?: number;
+    /** Relative weight given to keyword matching (0–1). */
+    keywordWeight?: number;
+    /** Relative weight given to semantic similarity (0–1). */
+    semanticWeight?: number;
+    minScore?: number;
+    filters?: Record<string, unknown>;
+}
+/**
+ * Parameters for retrieving a pre-formatted context string from a knowledge base.
+ */
+interface RetrieveContextParams {
+    query: string;
+    /** Maximum token budget for the returned context string. */
+    maxTokens?: number;
+    topK?: number;
+    minScore?: number;
+}
+/**
+ * Response from the context retrieval endpoint.
+ */
+interface RetrieveContextResponse {
+    /** Pre-formatted context string suitable for injection into a prompt. */
+    context: string;
+    query: string;
+}
+/**
+ * Response listing the file types accepted by the document ingestion pipeline.
+ */
+interface SupportedFileTypesResponse {
+    supported_types: string[];
+    max_file_size_bytes: number;
+    max_file_size_mb: number;
+}
+
+/**
+ * Types for workflow schedule management and scheduled run history.
+ * @module types/schedules
+ */
+/**
+ * Parameters for creating a new workflow schedule.
+ */
+interface CreateScheduleParams {
+    /** ID of the workflow to run on this schedule. */
+    workflowId: string;
+    name: string;
+    description?: string;
+    /** How the schedule recurrence is defined. */
+    scheduleType: 'interval' | 'cron';
+    /** Recurrence interval in seconds. Required when `scheduleType` is `"interval"`. */
+    intervalSeconds?: number;
+    /** Cron expression string. Required when `scheduleType` is `"cron"`. */
+    cronExpression?: string;
+    /** IANA timezone name (e.g. `"America/New_York"`). Defaults to `"UTC"`. */
+    timezone?: string;
+    /** State input passed to the workflow on each scheduled run. */
+    input?: Record<string, unknown>;
+    /** Runtime config overrides applied to each scheduled run. */
+    config?: Record<string, unknown>;
+}
+/**
+ * Parameters for updating an existing schedule.
+ * All fields are optional; only provided fields are updated.
+ */
+interface UpdateScheduleParams {
+    workflowId?: string;
+    name?: string;
+    description?: string;
+    scheduleType?: 'interval' | 'cron';
+    intervalSeconds?: number;
+    cronExpression?: string;
+    timezone?: string;
+    isActive?: boolean;
+    input?: Record<string, unknown>;
+    config?: Record<string, unknown>;
+}
+/**
+ * A schedule record as returned by the API.
+ */
+interface ScheduleResponse {
+    id: string;
+    workflow_id: string;
+    name: string;
+    description: string | null;
+    schedule_type: 'interval' | 'cron';
+    interval_seconds?: number | null;
+    cron_expression?: string | null;
+    /** IANA timezone name. */
+    timezone: string;
+    is_active: boolean;
+    input?: Record<string, unknown> | null;
+    config?: Record<string, unknown> | null;
+    next_run_at?: string | null;
+    last_run_at?: string | null;
+    created_at: string;
+    updated_at: string;
+    created_by: string;
+}
+/**
+ * Query parameters for listing schedules.
+ */
+interface ScheduleListParams {
+    workflowId?: string;
+    isActive?: boolean;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Paginated list of schedules.
+ */
+interface ScheduleListResponse {
+    schedules: ScheduleResponse[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+/**
+ * A single scheduled run record.
+ */
+interface ScheduleRunResponse {
+    id: string;
+    schedule_id: string;
+    /** Run status (e.g. `"completed"`, `"failed"`, `"running"`). */
+    status: string;
+    started_at: string;
+    completed_at?: string | null;
+    error?: string | null;
+    duration_ms?: number | null;
+}
+/**
+ * Query parameters for listing runs belonging to a schedule.
+ */
+interface ScheduleRunListParams {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Query parameters for fetching aggregate run statistics.
+ */
+interface ScheduleRunStatsParams {
+    /** Number of past days to include in the stats window. */
+    days?: number;
+}
+/**
+ * Aggregate run statistics for a schedule.
+ */
+interface ScheduleRunStatsResponse {
+    total_runs: number;
+    successful_runs: number;
+    failed_runs: number;
+    average_duration_ms: number;
+}
+
+/**
+ * Types for workflow templates and creator profiles.
+ * @module types/templates
+ */
+
+/**
+ * Public profile information for a template creator.
+ */
+interface CreatorInfo {
+    name: string;
+    display_photo?: string | null;
+    about?: string | null;
+    /** Map of social platform name to profile URL. */
+    socials?: Record<string, string>;
+}
+/**
+ * A template record as returned by the API.
+ */
+interface TemplateResponse {
+    id: string;
+    creator_id: string;
+    creator?: CreatorInfo | null;
+    name: string;
+    description: string | null;
+    tags: string[];
+    workflow_schema: WorkflowDefinition;
+    input?: Record<string, unknown> | null;
+    config?: Record<string, unknown> | null;
+    schema_image_url?: string | null;
+    /** Sharing visibility (e.g. `"private"`, `"public"`). */
+    visibility: string;
+    /** Lifecycle status (e.g. `"draft"`, `"published"`). */
+    status: string;
+    like_count: number;
+    used_count: number;
+    /** Whether the authenticated user has liked this template. */
+    is_liked?: boolean;
+    edit_version?: number | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Response from the public template browse endpoint.
+ */
+interface TemplateListResponse {
+    templates: TemplateResponse[];
+    /** Whether the response was served from cache. */
+    cached?: boolean;
+}
+/**
+ * Response from listing templates created by the authenticated user.
+ */
+interface MyTemplatesResponse {
+    templates: TemplateResponse[];
+    total: number;
+}
+/**
+ * Parameters for publishing a workflow as a template.
+ */
+interface CreateTemplateParams {
+    /** ID of the saved workflow to publish as a template. */
+    workflowId: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    /** URL to a preview image of the workflow canvas. */
+    schemaImageUrl?: string;
+}
+/**
+ * Response from using (importing) a template into the user's workspace.
+ */
+interface TemplateUseResponse {
+    success: boolean;
+    message: string;
+    /** The newly created workflow in the user's workspace. */
+    workflow: WorkflowResponse;
+    used_count: number;
+}
+/**
+ * Response from liking or un-liking a template.
+ */
+interface TemplateLikeResponse {
+    success: boolean;
+    /** `true` if the template is now liked, `false` if the like was removed. */
+    liked: boolean;
+    like_count: number;
+}
+/**
+ * Parameters for requesting an update to a published template.
+ */
+interface UpdateTemplateRequestParams {
+    /** ID of the updated workflow to sync into the template. */
+    workflowId: string;
+    name?: string;
+    description?: string;
+    tags?: string[];
+    schemaImageUrl?: string;
+}
+/**
+ * Parameters for creating or updating a template creator profile.
+ */
+interface CreateCreatorParams {
+    name: string;
+    about?: string;
+    displayPhoto?: string;
+    /** Map of social platform name to profile URL. */
+    socials?: Record<string, string>;
+}
+
+/**
+ * Types for the AI Composer — a chat-driven workflow builder.
+ * @module types/composer
+ */
+
+/**
+ * Parameters for starting a new Composer chat or sending a message to an existing one.
+ */
+interface ComposerChatParams {
+    /** ID of an existing saved workflow to attach to this Composer session. */
+    workflowId?: string;
+    /** ID of an existing Composer chat to continue. Omit to start a new session. */
+    composerChatId?: string;
+    /** The user's message to the Composer AI. */
+    message: string;
+    /** Override the LLM used by the Composer AI. */
+    llm?: LLMConfig;
+}
+/**
+ * Response from starting or continuing a Composer chat session.
+ */
+interface ComposerChatResponse {
+    status: string;
+    composer_chat_id: string;
+    workflow_id: string | null;
+    run_id: string;
+    thread_id: string;
+    /** URL to an SSE stream for real-time Composer output. */
+    stream_url: string;
+}
+/**
+ * A single message within a Composer chat conversation.
+ */
+interface ComposerMessageResponse {
+    id: string;
+    role: 'human' | 'ai' | 'system';
+    content: string;
+    created_at: string;
+}
+/**
+ * Full Composer chat detail including messages and workflow snapshot status.
+ */
+interface ComposerChatDetailResponse {
+    id: string;
+    workflow_id: string | null;
+    messages: ComposerMessageResponse[];
+    /** Whether there is a saved workflow snapshot associated with this chat. */
+    snapshot_status: string | null;
+    /** Whether the AI has produced changes not yet saved to the workflow. */
+    has_pending_changes: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Real-time status of a Composer chat session.
+ */
+interface ComposerStatusResponse {
+    composer_chat_id: string;
+    workflow_id: string | null;
+    is_running: boolean;
+    running_id: string | null;
+    has_pending_changes: boolean;
+    /** Status of the most recent run attached to this Composer session. */
+    run_status: string | null;
+}
+/**
+ * Query parameters for listing Composer chat history.
+ */
+interface ComposerHistoryParams {
+    limit?: number;
+}
+/**
+ * Parameters for deleting a Composer chat session.
+ */
+interface ComposerDeleteParams {
+    /** If `true`, also permanently delete the associated workflow. */
+    permanent?: boolean;
+}
+
+/**
+ * Types for the organization dashboard — activity logs, analytics, and user management.
+ * @module types/dashboard
+ */
+/**
+ * Query parameters for fetching organization activity logs.
+ */
+interface DashboardLogsParams {
+    limit?: number;
+    offset?: number;
+    /** Filter by log category (e.g. `"workflow"`, `"credential"`, `"auth"`). */
+    category?: string;
+    /** Filter by operation type (e.g. `"run"`, `"create"`, `"delete"`). */
+    operation?: string;
+    /** ISO-8601 start date for the log window. */
+    startDate?: string;
+    /** ISO-8601 end date for the log window. */
+    endDate?: string;
+}
+/**
+ * A single activity log entry.
+ */
+interface ActivityLogEntry {
+    id: string;
+    category: string;
+    operation: string;
+    user_id: string;
+    resource_id?: string | null;
+    resource_type?: string | null;
+    metadata?: Record<string, unknown>;
+    created_at: string;
+}
+/**
+ * Pagination metadata embedded in log responses.
+ */
+interface LogsPaginationData {
+    logs: ActivityLogEntry[];
+    total_count: number;
+    limit: number;
+    offset: number;
+    has_next: boolean;
+    has_previous: boolean;
+}
+/**
+ * Response from the dashboard logs endpoint.
+ */
+interface DashboardLogsResponse {
+    success: boolean;
+    organization_id: string;
+    data: LogsPaginationData;
+    filters: Record<string, unknown>;
+    meta: Record<string, unknown>;
+}
+/**
+ * Query parameters for the analytics overview endpoint.
+ */
+interface AnalyticsOverviewParams {
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Response from the analytics overview endpoint.
+ */
+interface AnalyticsOverviewResponse {
+    success: boolean;
+    organization_id: string;
+    data: {
+        overview: Record<string, unknown>;
+    };
+    meta: Record<string, unknown>;
+}
+/**
+ * Query parameters for the tools analytics endpoint.
+ */
+interface AnalyticsToolsParams {
+    /** Aggregation period (e.g. `"24h"`, `"7d"`, `"30d"`, `"90d"`). */
+    period?: string;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Response from the tools analytics endpoint.
+ */
+interface AnalyticsToolsResponse {
+    success: boolean;
+    organization_id: string;
+    data: Record<string, unknown>;
+    meta: Record<string, unknown>;
+}
+/**
+ * Response from the LLM usage analytics endpoint.
+ */
+interface AnalyticsLLMUsageResponse {
+    success: boolean;
+    organization_id: string;
+    data: Record<string, unknown>;
+    meta: Record<string, unknown>;
+}
+/**
+ * Query parameters for listing organization members from the dashboard.
+ */
+interface DashboardUsersParams {
+    search?: string;
+    /** Filter by member status (e.g. `"active"`, `"invited"`, `"suspended"`). */
+    status?: string;
+    /** Field to sort by (e.g. `"created_at"`, `"email"`). */
+    sortBy?: string;
+    /** Sort direction — `"asc"` or `"desc"`. */
+    order?: string;
+    page?: number;
+    limit?: number;
+}
+/**
+ * Response from the dashboard users endpoint.
+ */
+interface DashboardUsersResponse {
+    success: boolean;
+    organization_id: string;
+    users: Record<string, unknown>[];
+    invitation_count: number;
+    max_seats: number;
+    total: number;
+    total_pages: number;
+    current_page: number;
+    limit: number;
+    has_next: boolean;
+    has_previous: boolean;
+}
+
+/**
+ * Types for subscription plans, billing, and payment portal management.
+ * @module types/subscriptions
+ */
+/**
+ * A single price option for a plan (monthly or yearly).
+ */
+interface PlanPrice {
+    price: number;
+    /** Billing interval (e.g. `"month"`, `"year"`). */
+    interval: string;
+    /** ISO-4217 currency code (e.g. `"usd"`). */
+    currency: string;
+}
+/**
+ * A subscription plan available to organizations.
+ */
+interface Plan {
+    id: string;
+    name: string;
+    /** Display sort order on the pricing page. */
+    sort_order: number;
+    is_enterprise: boolean;
+    /** Discount percentage (0–100). */
+    discount: number;
+    prices: PlanPrice[];
+    /** List of feature descriptions included in this plan. */
+    features: string[];
+    /** Whether the plan can be self-selected (vs. sales-only). */
+    is_selectable?: boolean;
+}
+/**
+ * Response from listing available organization plans.
+ */
+interface OrganizationPlansResponse {
+    plans: Plan[];
+    total: number;
+}
+/**
+ * An active subscription record.
+ */
+interface Subscription {
+    id: string;
+    /** Stripe/payment-provider subscription status (e.g. `"active"`, `"past_due"`). */
+    status: string;
+    current_period_start: string;
+    current_period_end: string;
+    /** Current billing interval (`"month"` or `"year"`). */
+    billing_interval: string;
+    current_price: number;
+    created_at: string;
+}
+/**
+ * Billing information for an organization.
+ */
+interface BillingResponse {
+    has_subscription: boolean;
+    subscription?: Subscription;
+    plan?: Plan;
+}
+/**
+ * Parameters for creating a Stripe Checkout session.
+ */
+interface CheckoutParams {
+    planId: string;
+    interval: 'month' | 'year';
+}
+/**
+ * Response from creating a Checkout session.
+ */
+interface CheckoutResponse {
+    /** Stripe Checkout URL — redirect the user here to complete payment. */
+    url: string;
+}
+/**
+ * Response from creating a Stripe Customer Portal session.
+ */
+interface PortalResponse {
+    /** Stripe Portal URL — redirect the user here to manage billing. */
+    url: string;
+}
+
+/**
+ * Types for organization notifications.
+ * @module types/notifications
+ */
+/**
+ * A notification record as returned by the API.
+ */
+interface NotificationResponse {
+    id: string;
+    organization_id: string;
+    user_id: string | null;
+    notification_topic: string;
+    message: string;
+    notification_url?: string | null;
+    is_read: boolean;
+    expires_at?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Response from listing notifications for an organization.
+ */
+interface NotificationListResponse {
+    success: boolean;
+    notifications: NotificationResponse[];
+    total: number;
+    organization_id: string;
+}
+/**
+ * Parameters for creating an organization notification.
+ */
+interface CreateNotificationParams {
+    /** The category / channel for the notification. */
+    notificationTopic: 'integration' | 'attention';
+    message: string;
+    /** User ID to direct the notification to. Omit to send to all org members. */
+    notifiedTo?: string;
+    /** Deep-link URL associated with the notification. */
+    notificationUrl?: string;
+    /** ISO-8601 datetime after which the notification should be hidden. */
+    expiresAt?: string;
+}
+
+/**
+ * Auth resource — identity and organization membership endpoints.
+ * @module resources/auth
+ */
+
+/**
+ * Provides methods for the `/auth` API endpoints.
+ */
+declare class Auth extends BaseResource {
+    /**
+     * GET /auth/me
+     *
+     * Returns the authenticated user's profile.
+     */
+    me(options?: RequestOptions): Promise<UserResponse>;
+    /**
+     * GET /auth/me/organizations
+     *
+     * Returns the organizations the authenticated user belongs to.
+     */
+    organizations(params?: {
+        role?: string;
+    }, options?: RequestOptions): Promise<OrganizationsResponse>;
+    /**
+     * GET /auth/invitations/my
+     *
+     * Returns pending invitations for the authenticated user.
+     */
+    invitations(options?: RequestOptions): Promise<InvitationsResponse>;
+    /**
+     * POST /auth/invitations/{id}/accept
+     *
+     * Accepts a pending organization invitation.
+     */
+    acceptInvitation(invitationId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /auth/invitations/{id}/reject
+     *
+     * Rejects a pending organization invitation.
+     */
+    rejectInvitation(invitationId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /auth/organizations/leave
+     *
+     * Leaves the current organization (requires organization context).
+     */
+    leaveOrganization(options?: RequestOptions): Promise<LeaveResponse>;
+}
+
+/**
+ * ApiKeys resource — API key management endpoints.
+ * @module resources/api-keys
+ */
+
+/**
+ * Provides methods for the `/api-keys` API endpoints.
+ */
+declare class ApiKeys extends BaseResource {
+    /**
+     * POST /api-keys
+     *
+     * Creates a new API key. The full key value is returned only once.
+     */
+    create(params: CreateApiKeyParams, options?: RequestOptions): Promise<CreateApiKeyResponse>;
+    /**
+     * GET /api-keys
+     *
+     * Lists all API keys for the authenticated user.
+     */
+    list(params?: {
+        includeRevoked?: boolean;
+    }, options?: RequestOptions): Promise<ApiKeyListResponse>;
+    /**
+     * GET /api-keys/{keyId}
+     *
+     * Returns details for a specific API key (masked — never the full key).
+     */
+    get(keyId: string, options?: RequestOptions): Promise<ApiKeyResponse>;
+    /**
+     * DELETE /api-keys/{keyId}
+     *
+     * Permanently revokes an API key.
+     */
+    revoke(keyId: string, options?: RequestOptions): Promise<RevokeApiKeyResponse>;
+}
+
+/**
+ * Organizations resource — organization management endpoints.
+ * @module resources/organizations
+ */
+
+/**
+ * Provides methods for the `/organizations` API endpoints.
+ */
+declare class Organizations extends BaseResource {
+    /**
+     * POST /organizations
+     *
+     * Creates a new organization. The authenticated user becomes the owner.
+     */
+    create(params: CreateOrganizationParams, options?: RequestOptions): Promise<CreateOrganizationResponse>;
+    /**
+     * GET /organizations/llms
+     *
+     * Returns the LLM integrations configured for the current organization.
+     */
+    llms(options?: RequestOptions): Promise<LLMsResponse>;
+    /**
+     * POST /organizations/invite
+     *
+     * Sends an invitation email to add a user to the current organization.
+     */
+    invite(params: InviteParams, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /organizations/invitations/{id}/cancel
+     *
+     * Cancels a pending organization invitation.
+     */
+    cancelInvitation(invitationId: string, options?: RequestOptions): Promise<CancelInvitationResponse>;
+    /**
+     * POST /organizations/invitations/{id}/reinvite
+     *
+     * Re-sends an invitation email for a pending invitation.
+     */
+    reinvite(invitationId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * PUT /organizations/{orgId}/users/{userId}/role
+     *
+     * Updates a member's role within an organization.
+     */
+    updateRole(organizationId: string, userId: string, params: RoleUpdateParams, options?: RequestOptions): Promise<RoleUpdateResponse>;
+    /**
+     * DELETE /organizations/{orgId}/users/{userId}
+     *
+     * Removes a user from an organization. Requires owner permission.
+     */
+    removeUser(organizationId: string, userId: string, options?: RequestOptions): Promise<SuccessResponse>;
+}
+
+/**
+ * Workflows resource — workflow CRUD and builder endpoints.
+ * @module resources/workflows
+ */
+
+/**
+ * Provides methods for the `/workflows` API endpoints (CRUD and builder).
+ */
+declare class Workflows extends BaseResource {
+    /**
+     * POST /workflows
+     *
+     * Creates a new workflow with the given schema.
+     */
+    create(params: CreateWorkflowParams, options?: RequestOptions): Promise<WorkflowResponse>;
+    /**
+     * GET /workflows
+     *
+     * Lists workflows in the current organization.
+     */
+    list(params?: WorkflowListParams, options?: RequestOptions): Promise<WorkflowListResponse>;
+    /**
+     * Auto-pagination — yields all WorkflowSummary records across pages.
+     *
+     * Fetches page=1 with pageSize=100 and continues until all pages have been
+     * exhausted or there are no more results.
+     */
+    listAll(params?: Omit<WorkflowListParams, 'page' | 'pageSize'>, options?: RequestOptions): AsyncGenerator<WorkflowSummary>;
+    /**
+     * GET /workflows/{workflowId}
+     *
+     * Returns a full workflow object including the stored schema.
+     */
+    get(workflowId: string, options?: RequestOptions): Promise<WorkflowResponse>;
+    /**
+     * PUT /workflows/{workflowId}
+     *
+     * Updates an existing workflow. Only provided fields are changed.
+     */
+    update(workflowId: string, params: UpdateWorkflowParams, options?: RequestOptions): Promise<WorkflowResponse>;
+    /**
+     * DELETE /workflows/{workflowId}
+     *
+     * Soft-deletes a workflow.
+     */
+    delete(workflowId: string, options?: RequestOptions): Promise<DeleteWorkflowResponse>;
+    /**
+     * GET /workflows/builder/details
+     *
+     * Returns available node types, integration categories, and counts for
+     * the visual workflow builder. Results are cached for 60 minutes.
+     */
+    builderDetails(params?: BuilderDetailsParams, options?: RequestOptions): Promise<BuilderDetailsResponse>;
+}
+
+/**
+ * Executions resource — workflow run, resume, cancel, listen, and state endpoints.
+ * @module resources/executions
+ */
+
+/**
+ * Provides methods for workflow execution endpoints under `/workflows`.
+ */
+declare class Executions extends BaseResource {
+    /**
+     * POST /workflows/run
+     *
+     * Initiates a workflow run. Supports four modes: existing workflow, ad-hoc
+     * workflow, direct LLM call, and system workflow. Returns immediately with
+     * run metadata; stream events via `listen()`.
+     */
+    run(params: WorkflowRunParams, options?: RequestOptions): Promise<WorkflowRunResponse>;
+    /**
+     * GET /workflows/state/{threadId}
+     *
+     * Returns the persisted state snapshot of a workflow thread at its latest
+     * checkpoint.
+     */
+    getState(threadId: string, options?: RequestOptions): Promise<WorkflowStateResponse>;
+    /**
+     * POST /workflows/resume/{threadId}
+     *
+     * Resumes a workflow that is waiting at an interrupt node.
+     */
+    resume(params: WorkflowResumeParams, options?: RequestOptions): Promise<WorkflowResumeResponse>;
+    /**
+     * POST /workflows/cancel/{runId}
+     *
+     * Requests cancellation of an in-progress workflow run.
+     */
+    cancel(runId: string, params?: {
+        reason?: string;
+    }, options?: RequestOptions): Promise<CancelResponse>;
+    /**
+     * GET /workflows/listen/{runId} — SSE stream
+     *
+     * Opens a Server-Sent Events stream for real-time execution events of
+     * an in-progress workflow run. Yields typed `WorkflowSSEEvent` values.
+     */
+    listen(runId: string, options?: RequestOptions): AsyncGenerator<WorkflowSSEEvent>;
+}
+
+/**
+ * Deployments resource — workflow deployment management endpoints.
+ * @module resources/deployments
+ */
+
+/**
+ * Provides methods for the `/workflows/{workflowId}/deployments` API endpoints.
+ */
+declare class Deployments extends BaseResource {
+    /**
+     * POST /workflows/{workflowId}/deploy
+     *
+     * Creates a new deployment snapshot of a workflow.
+     */
+    create(workflowId: string, params?: CreateDeploymentParams, options?: RequestOptions): Promise<DeploymentResponse>;
+    /**
+     * GET /workflows/{workflowId}/deployments
+     *
+     * Lists deployment snapshots for a workflow.
+     */
+    list(workflowId: string, params?: DeploymentListParams, options?: RequestOptions): Promise<DeploymentListResponse>;
+    /**
+     * GET /workflows/{workflowId}/deployments/{deploymentId}
+     *
+     * Returns the full deployment record including the stored workflow schema.
+     */
+    get(workflowId: string, deploymentId: string, options?: RequestOptions): Promise<DeploymentDetailResponse>;
+    /**
+     * PUT /workflows/{workflowId}/deployments/{deploymentId}/activate
+     *
+     * Sets the given deployment as the live (active) version for the workflow.
+     */
+    activate(workflowId: string, deploymentId: string, options?: RequestOptions): Promise<ActivateDeploymentResponse>;
+    /**
+     * DELETE /workflows/{workflowId}/deployments/live
+     *
+     * Deactivates the currently live deployment so no version is active.
+     */
+    deactivate(workflowId: string, options?: RequestOptions): Promise<DeactivateDeploymentResponse>;
+    /**
+     * DELETE /workflows/{workflowId}/deployments/{deploymentId}
+     *
+     * Permanently deletes a deployment snapshot.
+     */
+    delete(workflowId: string, deploymentId: string, options?: RequestOptions): Promise<DeleteDeploymentResponse>;
+}
+
+/**
+ * Chats resource — chat session management endpoints.
+ * @module resources/chats
+ */
+
+/**
+ * Provides methods for the `/chats` API endpoints.
+ */
+declare class Chats extends BaseResource {
+    /**
+     * GET /chats
+     *
+     * Returns all chats for the current organization, grouped by folder.
+     * Keys include at minimum `"chats"`, `"pinned"`, and `"archived"`.
+     */
+    list(options?: RequestOptions): Promise<ChatListResponse>;
+    /**
+     * GET /chats/stream — SSE
+     *
+     * Opens a Server-Sent Events stream for real-time chat list updates.
+     * Emits `connected`, `chat_list_updated`, and `keepalive` events.
+     */
+    stream(options?: RequestOptions): AsyncGenerator<SSEEvent>;
+    /**
+     * GET /chats/{chatId}
+     *
+     * Returns a single chat session with its embedded messages.
+     */
+    get(chatId: string, options?: RequestOptions): Promise<ChatResponse>;
+    /**
+     * GET /chats/{chatId}/messages
+     *
+     * Returns paginated messages for a chat session.
+     */
+    messages(chatId: string, params?: ChatMessagesParams, options?: RequestOptions): Promise<ChatMessagesResponse>;
+    /**
+     * PATCH /chats/{chatId}
+     *
+     * Updates a chat's title, privacy, or folder assignment.
+     */
+    update(chatId: string, params: UpdateChatParams, options?: RequestOptions): Promise<ChatResponse>;
+    /**
+     * DELETE /chats/{chatId}
+     *
+     * Soft-deletes a chat. Private chats can only be deleted by the creator.
+     */
+    delete(chatId: string, options?: RequestOptions): Promise<SuccessResponse>;
+}
+
+/**
+ * Credentials resource — credential management and MCP server endpoints.
+ * @module resources/credentials
+ */
+
+/**
+ * Provides methods for the `/credentials` API endpoints.
+ */
+declare class Credentials extends BaseResource {
+    /**
+     * GET /credentials
+     *
+     * Lists credentials for the current organization.
+     * Returns a grouped response by default, or a flat list when
+     * `integrationName` is specified.
+     */
+    list(params?: CredentialListParams, options?: RequestOptions): Promise<CredentialListGrouped | CredentialListFlat>;
+    /**
+     * GET /credentials/{credentialId}
+     *
+     * Returns a single credential record.
+     */
+    get(credentialId: string, params?: {
+        includeMasked?: boolean;
+    }, options?: RequestOptions): Promise<CredentialResponse>;
+    /**
+     * POST /credentials
+     *
+     * Creates a new credential. The auth data is encrypted at rest.
+     */
+    create(params: CreateCredentialParams, options?: RequestOptions): Promise<CredentialResponse>;
+    /**
+     * PUT /credentials/{credentialId}
+     *
+     * Updates a credential's display name or metadata.
+     */
+    update(credentialId: string, params: UpdateCredentialParams, options?: RequestOptions): Promise<CredentialResponse>;
+    /**
+     * DELETE /credentials/{credentialId}
+     *
+     * Permanently deletes a credential. Returns 204 No Content on success.
+     */
+    delete(credentialId: string, options?: RequestOptions): Promise<void>;
+    /**
+     * POST /credentials/{credentialId}/set-default
+     *
+     * Sets the credential as the default for its integration.
+     * Unsets any previously set default.
+     */
+    setDefault(credentialId: string, options?: RequestOptions): Promise<CredentialResponse>;
+    /**
+     * POST /credentials/test-temporary
+     *
+     * Validates a credential's auth data without saving it.
+     */
+    testTemporary(params: TestTemporaryParams, options?: RequestOptions): Promise<TestTemporaryResponse>;
+    /**
+     * POST /credentials/{credentialId}/test
+     *
+     * Tests an existing saved credential by making a live API call.
+     */
+    test(credentialId: string, options?: RequestOptions): Promise<TestCredentialResponse>;
+    /**
+     * GET /credentials/{credentialId}/usage
+     *
+     * Returns usage statistics for a credential.
+     */
+    usage(credentialId: string, params?: CredentialUsageParams, options?: RequestOptions): Promise<CredentialUsageResponse>;
+    /**
+     * GET /credentials/{credentialId}/audit
+     *
+     * Returns the audit log for a credential.
+     */
+    audit(credentialId: string, params?: CredentialAuditParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * POST /credentials/bulk-modulex-keys/stream — SSE
+     *
+     * Streams bulk ModuleX managed key provisioning events.
+     */
+    bulkModulexKeys(options?: RequestOptions): AsyncGenerator<SSEEvent>;
+    /**
+     * POST /credentials/mcp-server
+     *
+     * Creates a credential for a Model Context Protocol (MCP) server.
+     */
+    mcpServer(params: McpServerParams, options?: RequestOptions): Promise<CredentialResponse>;
+    /**
+     * POST /credentials/{credentialId}/refresh-discovery
+     *
+     * Refreshes the tool discovery cache for an MCP server credential.
+     */
+    refreshDiscovery(credentialId: string, options?: RequestOptions): Promise<RefreshDiscoveryResponse>;
+    /**
+     * GET /credentials/{credentialId}/mcp-tools
+     *
+     * Returns the tools discovered from an MCP server credential.
+     */
+    mcpTools(credentialId: string, options?: RequestOptions): Promise<McpToolsResponse>;
+}
+
+/**
+ * Integrations resource — integration catalog and provider detail endpoints.
+ * @module resources/integrations
+ */
+
+/**
+ * Provides methods for the `/integrations` API endpoints.
+ */
+declare class Integrations extends BaseResource {
+    /**
+     * GET /integrations/browse
+     *
+     * Returns the integration catalog, optionally filtered by category or type.
+     */
+    browse(params?: BrowseParams, options?: RequestOptions): Promise<BrowseResponse>;
+    /**
+     * GET /integrations/tools
+     *
+     * Returns all available tool integrations, optionally filtered by category.
+     */
+    tools(params?: {
+        category?: string;
+    }, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /integrations/tools/{integrationName}
+     *
+     * Returns the full detail for a specific tool integration including its actions.
+     */
+    tool(integrationName: string, options?: RequestOptions): Promise<ToolIntegrationResponse>;
+    /**
+     * GET /integrations/llm-providers
+     *
+     * Returns all available LLM provider integrations, optionally filtered by category.
+     */
+    llmProviders(params?: {
+        category?: string;
+    }, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /integrations/llm-providers/{providerName}
+     *
+     * Returns the full detail for a specific LLM provider including available models.
+     */
+    llmProvider(providerName: string, options?: RequestOptions): Promise<LLMProviderResponse>;
+    /**
+     * GET /integrations/knowledge-providers
+     *
+     * Returns all available knowledge provider integrations.
+     */
+    knowledgeProviders(params?: {
+        category?: string;
+    }, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /integrations/knowledge-providers/{providerName}
+     *
+     * Returns the full detail for a specific knowledge provider.
+     */
+    knowledgeProvider(providerName: string, options?: RequestOptions): Promise<KnowledgeProviderResponse>;
+    /**
+     * GET /integrations/{integrationName}
+     *
+     * Returns the detail object for any integration by name.
+     */
+    get(integrationName: string, options?: RequestOptions): Promise<IntegrationResponse>;
+}
+
+/**
+ * Knowledge resource — knowledge base management, document ingestion, and search.
+ * @module resources/knowledge
+ */
+
+/**
+ * Provides methods for the `/knowledge-bases` API endpoints.
+ */
+declare class Knowledge extends BaseResource {
+    /**
+     * GET /knowledge-bases
+     *
+     * Lists knowledge bases for the current organization.
+     */
+    list(params?: KnowledgeBaseListParams, options?: RequestOptions): Promise<KnowledgeBaseListResponse>;
+    /**
+     * POST /knowledge-bases
+     *
+     * Creates a new knowledge base.
+     */
+    create(params: CreateKnowledgeBaseParams, options?: RequestOptions): Promise<KnowledgeBaseResponse>;
+    /**
+     * GET /knowledge-bases/stats
+     *
+     * Returns aggregated statistics across all knowledge bases in the organization.
+     */
+    stats(options?: RequestOptions): Promise<KnowledgeBaseStatsResponse>;
+    /**
+     * GET /knowledge-bases/{kbId}
+     *
+     * Returns a single knowledge base record.
+     */
+    get(knowledgeBaseId: string, options?: RequestOptions): Promise<KnowledgeBaseResponse>;
+    /**
+     * PUT /knowledge-bases/{kbId}
+     *
+     * Updates a knowledge base's name, description, or configuration.
+     */
+    update(knowledgeBaseId: string, params: UpdateKnowledgeBaseParams, options?: RequestOptions): Promise<KnowledgeBaseResponse>;
+    /**
+     * DELETE /knowledge-bases/{kbId}
+     *
+     * Deletes a knowledge base. Pass `deleteFiles: true` to also remove
+     * the underlying stored files.
+     */
+    delete(knowledgeBaseId: string, params?: {
+        deleteFiles?: boolean;
+    }, options?: RequestOptions): Promise<void>;
+    /**
+     * POST /knowledge-bases/{kbId}/archive
+     *
+     * Archives a knowledge base, pausing ingestion without deleting data.
+     */
+    archive(knowledgeBaseId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * GET /knowledge-bases/{kbId}/documents
+     *
+     * Returns documents within a knowledge base.
+     */
+    documents(knowledgeBaseId: string, params?: DocumentListParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * POST /knowledge-bases/{kbId}/documents — multipart upload
+     *
+     * Uploads a document file to a knowledge base for ingestion.
+     * Builds a `FormData` with the file and optional metadata JSON.
+     */
+    uploadDocument(knowledgeBaseId: string, params: UploadDocumentParams, options?: RequestOptions): Promise<DocumentResponse>;
+    /**
+     * GET /knowledge-bases/{kbId}/documents/{docId}
+     *
+     * Returns a single document record.
+     */
+    getDocument(knowledgeBaseId: string, documentId: string, options?: RequestOptions): Promise<DocumentResponse>;
+    /**
+     * GET /knowledge-bases/{kbId}/documents/{docId}/status
+     *
+     * Returns the processing status and progress of a document.
+     */
+    documentStatus(knowledgeBaseId: string, documentId: string, options?: RequestOptions): Promise<DocumentStatusResponse>;
+    /**
+     * DELETE /knowledge-bases/{kbId}/documents/{docId}
+     *
+     * Deletes a document and its chunks from the knowledge base.
+     * Pass `deleteFile: true` to also remove the source file from storage.
+     */
+    deleteDocument(knowledgeBaseId: string, documentId: string, params?: {
+        deleteFile?: boolean;
+    }, options?: RequestOptions): Promise<void>;
+    /**
+     * POST /knowledge-bases/{kbId}/documents/{docId}/retry
+     *
+     * Retries ingestion of a failed document.
+     */
+    retryDocument(knowledgeBaseId: string, documentId: string, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /knowledge-bases/{kbId}/documents/{docId}/chunks
+     *
+     * Returns the processed chunks for a document.
+     */
+    documentChunks(knowledgeBaseId: string, documentId: string, params?: DocumentChunksParams, options?: RequestOptions): Promise<DocumentChunksResponse>;
+    /**
+     * POST /knowledge-bases/{kbId}/search
+     *
+     * Performs a semantic search within a single knowledge base.
+     */
+    search(knowledgeBaseId: string, params: SearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    /**
+     * POST /knowledge-bases/search
+     *
+     * Searches across multiple knowledge bases simultaneously.
+     */
+    searchMultiple(params: MultiSearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    /**
+     * POST /knowledge-bases/{kbId}/hybrid-search
+     *
+     * Performs a hybrid (semantic + keyword) search within a knowledge base.
+     */
+    hybridSearch(knowledgeBaseId: string, params: HybridSearchParams, options?: RequestOptions): Promise<SearchResponse>;
+    /**
+     * POST /knowledge-bases/{kbId}/retrieve-context
+     *
+     * Retrieves a pre-formatted context string from a knowledge base for
+     * prompt injection.
+     */
+    retrieveContext(knowledgeBaseId: string, params: RetrieveContextParams, options?: RequestOptions): Promise<RetrieveContextResponse>;
+    /**
+     * GET /knowledge-bases/info/supported-file-types
+     *
+     * Returns the list of file types accepted by the document ingestion pipeline.
+     */
+    supportedFileTypes(options?: RequestOptions): Promise<SupportedFileTypesResponse>;
+}
+
+/**
+ * Schedules resource — workflow schedule management and run history endpoints.
+ * @module resources/schedules
+ */
+
+/**
+ * Provides methods for the `/schedules` API endpoints.
+ */
+declare class Schedules extends BaseResource {
+    /**
+     * POST /schedules
+     *
+     * Creates a new workflow schedule.
+     */
+    create(params: CreateScheduleParams, options?: RequestOptions): Promise<ScheduleResponse>;
+    /**
+     * GET /schedules
+     *
+     * Lists schedules for the current organization.
+     */
+    list(params?: ScheduleListParams, options?: RequestOptions): Promise<ScheduleListResponse>;
+    /**
+     * GET /schedules/{scheduleId}
+     *
+     * Returns a single schedule record.
+     */
+    get(scheduleId: string, options?: RequestOptions): Promise<ScheduleResponse>;
+    /**
+     * PUT /schedules/{scheduleId}
+     *
+     * Updates an existing schedule. Only provided fields are changed.
+     */
+    update(scheduleId: string, params: UpdateScheduleParams, options?: RequestOptions): Promise<ScheduleResponse>;
+    /**
+     * DELETE /schedules/{scheduleId}
+     *
+     * Deletes a schedule and cancels all pending executions.
+     */
+    delete(scheduleId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /schedules/{scheduleId}/pause
+     *
+     * Pauses a schedule, preventing future runs until resumed.
+     */
+    pause(scheduleId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /schedules/{scheduleId}/resume
+     *
+     * Resumes a paused schedule.
+     */
+    resume(scheduleId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * GET /schedules/{scheduleId}/runs
+     *
+     * Returns the run history for a schedule.
+     */
+    runs(scheduleId: string, params?: ScheduleRunListParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /schedules/{scheduleId}/runs/stats
+     *
+     * Returns aggregate run statistics for a schedule.
+     */
+    runStats(scheduleId: string, params?: ScheduleRunStatsParams, options?: RequestOptions): Promise<ScheduleRunStatsResponse>;
+    /**
+     * GET /schedules/{scheduleId}/runs/{runId}
+     *
+     * Returns details for a single scheduled run.
+     */
+    getRun(scheduleId: string, runId: string, options?: RequestOptions): Promise<ScheduleRunResponse>;
+    /**
+     * POST /schedules/{scheduleId}/runs/{runId}/retry
+     *
+     * Retries a failed scheduled run.
+     */
+    retryRun(scheduleId: string, runId: string, options?: RequestOptions): Promise<Record<string, unknown>>;
+}
+
+/**
+ * Templates resource — workflow template and creator profile endpoints.
+ * @module resources/templates
+ */
+
+/**
+ * Provides methods for the `/templates` API endpoints.
+ */
+declare class Templates extends BaseResource {
+    /**
+     * GET /templates
+     *
+     * Returns the public template library.
+     */
+    list(options?: RequestOptions): Promise<TemplateListResponse>;
+    /**
+     * GET /templates/{templateId}
+     *
+     * Returns a single template including its full workflow schema.
+     */
+    get(templateId: string, options?: RequestOptions): Promise<TemplateResponse>;
+    /**
+     * GET /templates/me
+     *
+     * Returns templates created by the authenticated user.
+     */
+    mine(options?: RequestOptions): Promise<MyTemplatesResponse>;
+    /**
+     * POST /templates
+     *
+     * Publishes a workflow as a new template.
+     */
+    create(params: CreateTemplateParams, options?: RequestOptions): Promise<TemplateResponse>;
+    /**
+     * POST /templates/{templateId}/like
+     *
+     * Toggles the authenticated user's like on a template.
+     */
+    like(templateId: string, options?: RequestOptions): Promise<TemplateLikeResponse>;
+    /**
+     * POST /templates/{templateId}/use
+     *
+     * Imports a template as a new workflow in the current organization.
+     */
+    use(templateId: string, options?: RequestOptions): Promise<TemplateUseResponse>;
+    /**
+     * POST /templates/{templateId}/update-request
+     *
+     * Submits an update request for a published template.
+     */
+    updateRequest(templateId: string, params: UpdateTemplateRequestParams, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /templates/creators
+     *
+     * Creates or updates the authenticated user's template creator profile.
+     */
+    createCreator(params: CreateCreatorParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /templates/creators/me
+     *
+     * Returns the authenticated user's template creator profile.
+     */
+    getCreator(options?: RequestOptions): Promise<Record<string, unknown>>;
+}
+
+/**
+ * Composer resource — AI-driven workflow builder chat endpoints.
+ * @module resources/composer
+ */
+
+/**
+ * Provides methods for the `/composer` API endpoints.
+ */
+declare class Composer extends BaseResource {
+    /**
+     * POST /composer/chat
+     *
+     * Starts a new Composer chat or sends a message to an existing session.
+     * Returns a run ID that can be used to listen to the SSE stream.
+     */
+    chat(params: ComposerChatParams, options?: RequestOptions): Promise<ComposerChatResponse>;
+    /**
+     * GET /composer/chat/{composerChatId}
+     *
+     * Returns a Composer chat session with its messages and workflow snapshot status.
+     */
+    get(composerChatId: string, options?: RequestOptions): Promise<ComposerChatDetailResponse>;
+    /**
+     * GET /composer/chat/{composerChatId}/listen/{runId} — SSE
+     *
+     * Opens a Server-Sent Events stream for real-time Composer output during a run.
+     */
+    listen(composerChatId: string, runId: string, options?: RequestOptions): AsyncGenerator<SSEEvent>;
+    /**
+     * POST /composer/chat/{composerChatId}/save
+     *
+     * Saves the Composer's current workflow changes to the associated workflow.
+     */
+    save(composerChatId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * POST /composer/chat/{composerChatId}/revert
+     *
+     * Reverts the Composer's pending changes, restoring the last saved state.
+     */
+    revert(composerChatId: string, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * GET /composer/chat/workflow/{workflowId}/history
+     *
+     * Returns the Composer chat history associated with a workflow.
+     */
+    history(workflowId: string, params?: ComposerHistoryParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * DELETE /composer/chat/{composerChatId}
+     *
+     * Deletes a Composer chat session. Pass `permanent: true` to also delete
+     * the associated workflow.
+     */
+    delete(composerChatId: string, params?: ComposerDeleteParams, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * GET /composer/chat/{composerChatId}/status
+     *
+     * Returns the real-time status of a Composer chat session.
+     */
+    status(composerChatId: string, options?: RequestOptions): Promise<ComposerStatusResponse>;
+    /**
+     * POST /composer/chat/{composerChatId}/cancel
+     *
+     * Cancels the in-progress run for a Composer chat session.
+     */
+    cancel(composerChatId: string, options?: RequestOptions): Promise<SuccessResponse>;
+}
+
+/**
+ * Dashboard resource — activity logs, analytics, and user management endpoints.
+ * @module resources/dashboard
+ */
+
+/**
+ * Provides methods for the `/dashboard` API endpoints.
+ */
+declare class Dashboard extends BaseResource {
+    /**
+     * GET /dashboard/logs
+     *
+     * Returns paginated activity logs for the current organization.
+     */
+    logs(params?: DashboardLogsParams, options?: RequestOptions): Promise<DashboardLogsResponse>;
+    /**
+     * GET /dashboard/analytics/overview
+     *
+     * Returns high-level execution and usage analytics for the organization.
+     */
+    analyticsOverview(params?: AnalyticsOverviewParams, options?: RequestOptions): Promise<AnalyticsOverviewResponse>;
+    /**
+     * GET /dashboard/analytics/tools
+     *
+     * Returns tool-usage analytics broken down by integration.
+     */
+    analyticsTools(params?: AnalyticsToolsParams, options?: RequestOptions): Promise<AnalyticsToolsResponse>;
+    /**
+     * GET /dashboard/analytics/llm-usage
+     *
+     * Returns LLM token-usage analytics broken down by model and provider.
+     */
+    analyticsLlmUsage(params?: AnalyticsToolsParams, options?: RequestOptions): Promise<AnalyticsLLMUsageResponse>;
+    /**
+     * GET /dashboard/users
+     *
+     * Returns organization members with pagination and search support.
+     */
+    users(params?: DashboardUsersParams, options?: RequestOptions): Promise<DashboardUsersResponse>;
+}
+
+/**
+ * Subscriptions resource — billing and subscription plan management endpoints.
+ * @module resources/subscriptions
+ */
+
+/**
+ * Provides methods for the `/subscriptions` API endpoints.
+ */
+declare class Subscriptions extends BaseResource {
+    /**
+     * GET /subscriptions/organization-plans
+     *
+     * Returns the list of available organization subscription plans.
+     */
+    organizationPlans(options?: RequestOptions): Promise<OrganizationPlansResponse>;
+    /**
+     * GET /subscriptions/organization-billing
+     *
+     * Returns the current organization's billing status and active subscription.
+     */
+    billing(options?: RequestOptions): Promise<BillingResponse>;
+    /**
+     * POST /subscriptions/checkout-link
+     *
+     * Creates a Stripe Checkout session and returns the redirect URL.
+     */
+    checkoutLink(params: CheckoutParams, options?: RequestOptions): Promise<CheckoutResponse>;
+    /**
+     * POST /subscriptions/customer-portal
+     *
+     * Creates a Stripe Customer Portal session and returns the redirect URL
+     * for the user to manage their billing.
+     */
+    customerPortal(options?: RequestOptions): Promise<PortalResponse>;
+}
+
+/**
+ * Notifications resource — organization notification management endpoints.
+ * @module resources/notifications
+ */
+
+/**
+ * Provides methods for the `/notifications` API endpoints.
+ */
+declare class Notifications extends BaseResource {
+    /**
+     * GET /notifications
+     *
+     * Returns notifications for the current organization.
+     */
+    list(options?: RequestOptions): Promise<NotificationListResponse>;
+    /**
+     * POST /notifications/organization
+     *
+     * Creates a new notification for the organization or a specific user.
+     */
+    create(params: CreateNotificationParams, options?: RequestOptions): Promise<Record<string, unknown>>;
+}
+
+/**
+ * System resource — health, metrics, and timezone endpoints.
+ * @module resources/system
+ */
+
+/**
+ * Provides methods for the `/system` API endpoints.
+ */
+declare class System extends BaseResource {
+    /**
+     * GET /system/health
+     *
+     * Returns the service health status, name, and version.
+     */
+    health(options?: RequestOptions): Promise<{
+        status: string;
+        service: string;
+        version: string;
+    }>;
+    /**
+     * GET /system/metrics
+     *
+     * Returns Prometheus-format metrics as plain text.
+     * This endpoint bypasses the JSON-parsing logic of `BaseResource.get()` and
+     * reads the raw response body as a string.
+     */
+    metrics(options?: RequestOptions): Promise<string>;
+    /**
+     * GET /system/timezones
+     *
+     * Returns the list of supported IANA timezone identifiers.
+     */
+    timezones(options?: RequestOptions): Promise<Record<string, unknown>>;
+    /**
+     * GET /system/timezones/search
+     *
+     * Searches supported IANA timezone identifiers by query string.
+     */
+    searchTimezones(query: string, options?: RequestOptions): Promise<Record<string, unknown>>;
+}
+
+/**
+ * The main ModuleX client. Provides access to all API resources.
+ *
+ * @example
+ * ```typescript
+ * import { Modulex } from 'modulex';
+ *
+ * const client = new Modulex({
+ *   apiKey: 'mx_live_...',
+ *   organizationId: 'your-org-id',
+ * });
+ *
+ * const me = await client.auth.me();
+ * const workflows = await client.workflows.list({ status: 'active' });
+ * ```
+ */
+declare class Modulex {
+    /** @internal */
+    private readonly _config;
+    private _auth?;
+    private _apiKeys?;
+    private _organizations?;
+    private _workflows?;
+    private _executions?;
+    private _deployments?;
+    private _chats?;
+    private _credentials?;
+    private _integrations?;
+    private _knowledge?;
+    private _schedules?;
+    private _templates?;
+    private _composer?;
+    private _dashboard?;
+    private _subscriptions?;
+    private _notifications?;
+    private _system?;
+    constructor(config: ModulexConfig);
+    /** Authentication and user profile endpoints. */
+    get auth(): Auth;
+    /** API key management endpoints. */
+    get apiKeys(): ApiKeys;
+    /** Organization management endpoints. */
+    get organizations(): Organizations;
+    /** Workflow CRUD endpoints. */
+    get workflows(): Workflows;
+    /** Workflow execution endpoints (run, resume, cancel, listen). */
+    get executions(): Executions;
+    /** Workflow deployment endpoints. */
+    get deployments(): Deployments;
+    /** Chat endpoints. */
+    get chats(): Chats;
+    /** Credential management endpoints. */
+    get credentials(): Credentials;
+    /** Integration browsing endpoints. */
+    get integrations(): Integrations;
+    /** Knowledge base endpoints. */
+    get knowledge(): Knowledge;
+    /** Schedule management endpoints. */
+    get schedules(): Schedules;
+    /** Template endpoints. */
+    get templates(): Templates;
+    /** Composer (AI workflow builder) endpoints. */
+    get composer(): Composer;
+    /** Dashboard and analytics endpoints. */
+    get dashboard(): Dashboard;
+    /** Subscription and billing endpoints. */
+    get subscriptions(): Subscriptions;
+    /** Notification endpoints. */
+    get notifications(): Notifications;
+    /** System health and utility endpoints. */
+    get system(): System;
+}
+
+/**
+ * Base error class for all ModuleX SDK errors.
+ */
+declare class ModulexError extends Error {
+    readonly status: number | undefined;
+    readonly body: unknown;
+    readonly headers: Headers | undefined;
+    constructor(message: string, status: number | undefined, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 400 Bad Request. */
+declare class BadRequestError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 401 Unauthorized. */
+declare class AuthenticationError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 403 Forbidden. */
+declare class PermissionError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 404 Not Found. */
+declare class NotFoundError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 409 Conflict. */
+declare class ConflictError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 422 Validation Error. */
+declare class ValidationError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 429 Too Many Requests. */
+declare class RateLimitError extends ModulexError {
+    /** Seconds to wait before retrying (from Retry-After header). */
+    readonly retryAfter: number | undefined;
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 500 Internal Server Error. */
+declare class InternalError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 502 Bad Gateway. */
+declare class ExternalServiceError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown when the API returns 503 Service Unavailable. */
+declare class ServiceUnavailableError extends ModulexError {
+    constructor(message: string, body: unknown, headers: Headers | undefined);
+}
+/** Thrown on SSE stream errors. */
+declare class StreamError extends ModulexError {
+    constructor(message: string);
+}
+/** Thrown when a request times out. */
+declare class TimeoutError extends ModulexError {
+    constructor(message?: string);
+}
+
+export { type ActivateDeploymentResponse, type AgentNodeConfig, type AnalyticsLLMUsageResponse, type AnalyticsOverviewParams, type AnalyticsOverviewResponse, type AnalyticsToolsParams, type AnalyticsToolsResponse, type ApiKeyListResponse, type ApiKeyResponse, AuthenticationError, BadRequestError, type BillingResponse, type BrowseParams, type BrowseResponse, type BuilderDetailsParams, type BuilderDetailsResponse, type CancelInvitationResponse, type CancelResponse, type ChatListResponse, type ChatMessageResponse, type ChatMessagesParams, type ChatMessagesResponse, type ChatResponse, type CheckoutParams, type CheckoutResponse, type ChunkResponse, type ChunkingConfig, type ComposerChatDetailResponse, type ComposerChatParams, type ComposerChatResponse, type ComposerDeleteParams, type ComposerHistoryParams, type ComposerStatusResponse, type ConditionalBranch, type ConditionalNodeConfig, ConflictError, type CreateApiKeyParams, type CreateApiKeyResponse, type CreateCreatorParams, type CreateCredentialParams, type CreateDeploymentParams, type CreateKnowledgeBaseParams, type CreateNotificationParams, type CreateOrganizationParams, type CreateOrganizationResponse, type CreateScheduleParams, type CreateTemplateParams, type CreateWorkflowParams, type CreatorInfo, type CredentialAuditParams, type CredentialListFlat, type CredentialListGrouped, type CredentialListParams, type CredentialResponse, type CredentialUsageParams, type CredentialUsageResponse, type DashboardLogsParams, type DashboardLogsResponse, type DashboardUsersParams, type DashboardUsersResponse, type DeactivateDeploymentResponse, type DeleteDeploymentResponse, type DeleteWorkflowResponse, type DeploymentDetailResponse, type DeploymentListParams, type DeploymentListResponse, type DeploymentResponse, type DocumentChunksParams, type DocumentChunksResponse, type DocumentListParams, type DocumentResponse, type DocumentStatusResponse, type DoneEventData, type EdgeDefinition, type EmbeddingConfig, type ErrorEventData, ExternalServiceError, type FunctionNodeConfig, type GuardrailsNodeConfig, type HybridSearchParams, type IntegrationResponse, InternalError, type InterruptEventData, type InterruptNodeConfig, type InvitationResponse, type InvitationsResponse, type InviteParams, type KnowledgeBaseListParams, type KnowledgeBaseListResponse, type KnowledgeBaseResponse, type KnowledgeBaseStatsResponse, type KnowledgeNodeConfig, type KnowledgeProviderResponse, type LLMConfig, type LLMNodeConfig, type LLMProviderResponse, type LLMsResponse, type LeaveResponse, type LoopConfig, type McpServerParams, type McpToolsResponse, type MetadataEventData, Modulex, type ModulexConfig, ModulexError, type MultiSearchParams, type MyTemplatesResponse, type NodeDefinition, type NodeType, type NodeUpdateEventData, NotFoundError, type NotificationListResponse, type NotificationResponse, type OrganizationInfo, type OrganizationPlansResponse, type OrganizationsResponse, type PaginatedList, PermissionError, type Plan, type PlanPrice, type PortalResponse, RateLimitError, type RefreshDiscoveryResponse, type RequestOptions, type ResumedEventData, type RetrieveContextParams, type RetrieveContextResponse, type RetryConfig, type RevokeApiKeyResponse, type RoleUpdateParams, type RoleUpdateResponse, type SSEEvent, type ScheduleListParams, type ScheduleListResponse, type ScheduleResponse, type ScheduleRunListParams, type ScheduleRunResponse, type ScheduleRunStatsParams, type ScheduleRunStatsResponse, type SearchParams, type SearchResponse, type SearchResult, ServiceUnavailableError, type StateSchema, type StateSchemaField, StreamError, type Subscription, type SuccessResponse, type SupportedFileTypesResponse, type TemplateLikeResponse, type TemplateListResponse, type TemplateResponse, type TemplateUseResponse, type TestCredentialResponse, type TestTemporaryParams, type TestTemporaryResponse, TimeoutError, type ToolDefinition, type ToolIntegrationResponse, type ToolNodeConfig, type TransformerNodeConfig, type TransformerOperation, type UpdateChatParams, type UpdateCredentialParams, type UpdateKnowledgeBaseParams, type UpdateScheduleParams, type UpdateTemplateRequestParams, type UpdateWorkflowParams, type UploadDocumentParams, type UserResponse, ValidationError, type WorkflowConfig, type WorkflowDefinition, type WorkflowListParams, type WorkflowListResponse, type WorkflowMetadata, type WorkflowResponse, type WorkflowResumeParams, type WorkflowResumeResponse, type WorkflowRunParams, type WorkflowRunResponse, type WorkflowSSEEvent, type WorkflowStateResponse, type WorkflowSummary };