@realtimex/sdk 1.7.28 → 2.0.1

package/dist/index.d.ts

@@ -1,2069 +1,29 @@
-import { V as V1ApiNamespace, a as V1DesktopRuntimeSessionsModule, b as V1DesktopBrowserModule } from './errors-NufsyIZ-.js';
-export { A as AuthenticationError, D as DeveloperApiClient, c as DeveloperApiError, N as NotFoundError, S as ServerError, d as ValidationError } from './errors-NufsyIZ-.js';
+import { V as V1ApiNamespace } from './errors-C98IGxYU.js';
+export { A as AuthenticationError, D as DeveloperApiClient, a as DeveloperApiError, N as NotFoundError, S as ServerError, b as ValidationError } from './errors-C98IGxYU.js';
 
-/**
- * RealtimeX Local App SDK - Types
- */
 interface SDKConfig {
     realtimex?: {
         url?: string;
         appId?: string;
-        appName?: string;
         apiKey?: string;
     };
-    defaultPort?: number;
-    permissions?: string[];
-    contract?: {
-        callbackSecret?: string;
-        signCallbacksByDefault?: boolean;
-    };
-}
-interface Activity {
-    id: string;
-    raw_data: Record<string, unknown>;
-    old_data?: Record<string, unknown>;
-    status: 'pending' | 'claimed' | 'completed' | 'failed';
-    locked_by?: string;
-    locked_at?: string;
-    completed_at?: string;
-    error_message?: string;
-    result?: Record<string, unknown>;
-    created_at: string;
-}
-interface TriggerAgentPayload {
-    raw_data: Record<string, unknown>;
-    auto_run?: boolean;
-    agent_name?: string;
-    workspace_slug?: string;
-    thread_slug?: string;
-    prompt?: string;
-    event_id?: string;
-    attempt_id?: string | number;
-}
-interface TriggerAgentResponse {
-    success: boolean;
-    task_uuid?: string;
-    task_id?: string;
-    capability_id?: string;
-    event_id?: string;
-    attempt_id?: string;
-    event_type?: ContractEventType | string;
-    contract_version?: string;
-    calendar_event_uuid?: string;
-    auto_run?: boolean;
-    message?: string;
-    error?: string;
-}
-type ContractEventType = 'task.trigger' | 'system.ping' | 'task.claimed' | 'task.started' | 'task.progress' | 'task.completed' | 'task.failed' | 'task.canceled';
-interface ContractCallbackMetadata {
-    event_id_header?: string;
-    signature_header?: string;
-    signature_algorithm?: string;
-    signature_message?: string;
-    attempt_id_format?: string;
-    idempotency?: string;
-}
-interface ContractCapabilityTrigger$1 {
-    event: string;
-    route?: string;
-    payload_template?: Record<string, unknown>;
-}
-interface ContractCapability$1 {
-    capability_id: string;
-    name: string;
-    description?: string;
-    input_schema: Record<string, unknown>;
-    output_schema?: Record<string, unknown>;
-    permission?: string;
-    trigger?: ContractCapabilityTrigger$1;
-    tags?: string[];
-    examples?: string[];
-    risk_level?: 'low' | 'medium' | 'high' | null;
-    enabled?: boolean;
-}
-interface LocalAppContractDefinition {
-    id: string;
-    version: string;
-    strictness?: 'compatible' | 'strict';
-    events: Record<string, ContractEventType>;
-    supported_events: ContractEventType[];
-    supported_legacy_events: string[];
-    aliases: Record<string, ContractEventType>;
-    status_map: Record<string, string>;
-    legacy_action_map: Record<ContractEventType, string>;
-    catalog_hash?: string;
-    capability_count?: number;
-    capabilities?: ContractCapability$1[];
-    callback?: ContractCallbackMetadata;
-}
-interface LocalAppContractResponse {
-    success: boolean;
-    contract: LocalAppContractDefinition;
-}
-interface LocalAppCapabilitiesResponse {
-    success: boolean;
-    contract_version: string;
-    strictness?: 'compatible' | 'strict';
-    catalog_hash?: string;
-    count: number;
-    capabilities: ContractCapability$1[];
-}
-interface LocalAppCapabilitySearchResponse extends LocalAppCapabilitiesResponse {
-    query: string;
-}
-interface LocalAppCapabilityDetailResponse {
-    success: boolean;
-    contract_version: string;
-    strictness?: 'compatible' | 'strict';
-    catalog_hash?: string;
-    capability: ContractCapability$1;
-}
-interface ContractInvokePayload {
-    capability_id: string;
-    args?: Record<string, unknown>;
-    auto_run?: boolean;
-    agent_name?: string;
-    workspace_slug?: string;
-    thread_slug?: string;
-    prompt?: string;
-    event_id?: string;
-    attempt_id?: string | number;
-}
-interface Agent {
-    slug: string;
-    name: string;
-    description?: string;
-    hub_id?: string;
-}
-interface Workspace {
-    id: number;
-    slug: string;
-    name: string;
-    type: string;
-    created_at: string;
-}
-interface Thread {
-    id: number;
-    slug: string;
-    name: string;
-    created_at: string;
-}
-interface TaskRun {
-    id: number;
-    attempt_id?: string;
-    agent_name: string;
-    workspace_slug: string;
-    thread_slug?: string;
-    status: string;
-    started_at?: string;
-    completed_at?: string;
-    error?: string;
-}
-interface Task {
-    uuid: string;
-    title: string;
-    status: string;
-    action_type: string;
-    source_app: string;
-    error?: string;
-    created_at: string;
-    updated_at: string;
-    runs: TaskRun[];
-}
-interface TTSOptions {
-    /** Voice ID (provider-specific) */
-    voice?: string;
-    /** Model ID (provider-specific) */
-    model?: string;
-    /** Speech speed (0.5-2.0) */
-    speed?: number;
-    /** TTS provider ID */
-    provider?: string;
-    /** Language code (e.g., 'en', 'es', 'fr') - for Supertonic */
-    language?: string;
-    /** Quality level (1-20) - for Supertonic num_inference_steps */
-    num_inference_steps?: number;
-}
-interface TTSProviderConfig {
-    /** Available voice/speaker IDs */
-    voices: string[];
-    /** Supported languages (for multilingual providers) */
-    languages?: string[];
-    /** Speed range */
-    speed?: {
-        min: number;
-        max: number;
-        default: number;
-    };
-    /** Quality range (for providers that support it) */
-    quality?: {
-        min: number;
-        max: number;
-        default: number;
-        description?: string;
-    };
-}
-interface TTSProvider {
-    /** Provider ID (e.g., 'elevenlabs', 'supertonic_local') */
-    id: string;
-    /** Display name */
-    name: string;
-    /** Provider type: 'server' (remote API) or 'client' (local) */
-    type: 'server' | 'client';
-    /** Whether provider is configured and ready */
-    configured: boolean;
-    /** Whether streaming is supported */
-    supportsStreaming: boolean;
-    /** Optional note about provider requirements */
-    note?: string;
-    /** Configuration options */
-    config?: TTSProviderConfig;
-}
-interface TTSProvidersResponse {
-    success: boolean;
-    providers: TTSProvider[];
-    default: string;
-    error?: string;
-}
-interface TTSChunk {
-    /** Chunk index (0-based) */
-    index: number;
-    /** Total number of chunks */
-    total: number;
-    /** Decoded audio data (ArrayBuffer) - ready for playback */
-    audio: ArrayBuffer;
-    /** Audio MIME type */
-    mimeType: string;
-}
-interface TTSChunkEvent {
-    type: 'info' | 'chunk' | 'error' | 'done';
-    data: TTSChunk | {
-        totalChunks: number;
-    } | {
-        error: string;
-    };
-}
-interface STTListenOptions {
-    /** STT provider (e.g., 'native', 'whisper', 'groq') */
-    provider?: string;
-    /** Language code (e.g., 'en-US') */
-    language?: string;
-    /** Specific model ID (e.g., 'onnx-community/whisper-tiny.en') */
-    model: string;
-    /** Timeout in milliseconds (default: 60000) */
-    timeout?: number;
-}
-interface STTModel {
-    id: string;
-    name: string;
-    provider?: string;
-    description?: string;
-    language?: string;
-    size?: string;
-    recommended?: boolean;
-}
-interface STTProvider {
-    id: string;
-    name: string;
-    description?: string;
-    models: STTModel[];
-}
-interface STTProvidersResponse {
-    success: boolean;
-    providers: STTProvider[];
-    error?: string;
-}
-interface STTModelsResponse {
-    success: boolean;
-    models: STTModel[];
-    error?: string;
-}
-interface STTResponse {
-    success: boolean;
-    /** Transcribed text */
-    text: string;
-    error?: string;
-}
-
-/**
- * Activities Module - HTTP Proxy to RealtimeX Main App
- * No direct Supabase access - all operations go through Main App
- */
-
-declare class ActivitiesModule {
-    private baseUrl;
-    private appId;
-    private appName;
-    private apiKey?;
-    constructor(realtimexUrl: string, appId: string, appName?: string, apiKey?: string);
-    /**
-     * Request a single permission from Electron via internal API
-     */
-    private requestPermission;
-    private request;
-    /**
-     * Insert a new activity
-     */
-    insert(rawData: Record<string, unknown>): Promise<Activity>;
-    /**
-     * Update an existing activity
-     */
-    update(id: string, updates: Partial<Activity>): Promise<Activity>;
-    /**
-     * Delete an activity
-     */
-    delete(id: string): Promise<void>;
-    /**
-     * Get a single activity by ID
-     */
-    get(id: string): Promise<Activity | null>;
-    /**
-     * List activities with optional filters
-     */
-    list(options?: {
-        status?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<Activity[]>;
-}
-
-declare class WebhookModule {
-    private realtimexUrl;
-    private appName?;
-    private appId?;
-    private apiKey?;
-    constructor(realtimexUrl: string, appName?: string, appId?: string, apiKey?: string);
-    /**
-     * Request a single permission from Electron via internal API
-     */
-    private requestPermission;
-    private request;
-    triggerAgent(payload: TriggerAgentPayload): Promise<TriggerAgentResponse>;
-    ping(): Promise<{
-        success: boolean;
-        app_name: string;
-        message: string;
-    }>;
-}
-
-/**
- * API Module - Call RealtimeX public APIs
- */
-
-/**
- * Error thrown when a permission is permanently denied
- */
-declare class PermissionDeniedError extends Error {
-    readonly permission: string;
-    readonly code: string;
-    constructor(permission: string, message?: string, code?: string);
-}
-/**
- * Error thrown when a permission needs to be granted
- */
-declare class PermissionRequiredError extends Error {
-    readonly permission: string;
-    readonly code: string;
-    constructor(permission: string, message?: string, code?: string);
-}
-declare class ApiModule {
-    private realtimexUrl;
-    private appId;
-    private appName;
-    private apiKey?;
-    constructor(realtimexUrl: string, appId: string, appName?: string, apiKey?: string);
-    private getHeaders;
-    /**
-     * Request a single permission from Electron via internal API
-     */
-    private requestPermission;
-    /**
-     * Make an API call with automatic permission handling
-     */
-    protected apiCall<T>(method: string, endpoint: string, options?: RequestInit): Promise<T>;
-    getAgents(): Promise<Agent[]>;
-    getWorkspaces(): Promise<Workspace[]>;
-    getThreads(workspaceSlug: string): Promise<Thread[]>;
-    getTask(taskUuid: string): Promise<Task>;
-}
-
-/**
- * Task Module - Report task status to RealtimeX
- * Used by external agents/processors to update task status
- */
-
-interface TaskStatusResponse {
-    success: boolean;
-    task_uuid: string;
-    status: string;
-    event_id?: string;
-    attempt_id?: string;
-    event_type?: ContractEventType | string;
-    deduplicated?: boolean;
-    duplicate?: boolean;
-    message?: string;
-}
-interface TaskEventOptions {
-    machineId?: string;
-    attemptId?: string | number;
-    eventId?: string;
-    timestamp?: string;
-    callbackUrl?: string;
-    callbackSecret?: string;
-    sign?: boolean;
-    userEmail?: string;
-    activityId?: string;
-    tableName?: string;
-}
-declare class TaskModule {
-    private realtimexUrl;
-    private appName?;
-    private appId?;
-    private apiKey?;
-    private callbackSecret?;
-    private signCallbacksByDefault;
-    constructor(realtimexUrl: string, appName?: string, appId?: string, apiKey?: string);
-    /**
-     * Configure callback signing behavior.
-     */
-    configureContract(config: {
-        callbackSecret?: string;
-        signCallbacksByDefault?: boolean;
-    }): void;
-    /**
-     * Claim a task before processing.
-     */
-    claim(taskUuid: string, options?: TaskEventOptions): Promise<TaskStatusResponse>;
-    /**
-     * Alias for claim()
-     */
-    claimed(taskUuid: string, options?: TaskEventOptions): Promise<TaskStatusResponse>;
-    /**
-     * Mark task as processing.
-     * Backward compatible signature: start(taskUuid, machineId?)
-     */
-    start(taskUuid: string, machineIdOrOptions?: string | TaskEventOptions): Promise<TaskStatusResponse>;
-    /**
-     * Report incremental task progress.
-     */
-    progress(taskUuid: string, progressData?: Record<string, unknown>, options?: TaskEventOptions): Promise<TaskStatusResponse>;
-    /**
-     * Mark task as completed with result.
-     * Backward compatible signature: complete(taskUuid, result?, machineId?)
-     */
-    complete(taskUuid: string, result?: Record<string, unknown>, machineIdOrOptions?: string | TaskEventOptions): Promise<TaskStatusResponse>;
-    /**
-     * Mark task as failed with error.
-     * Backward compatible signature: fail(taskUuid, error, machineId?)
-     */
-    fail(taskUuid: string, error: string, machineIdOrOptions?: string | TaskEventOptions): Promise<TaskStatusResponse>;
-    /**
-     * Mark task as canceled.
-     */
-    cancel(taskUuid: string, reason?: string, options?: TaskEventOptions): Promise<TaskStatusResponse>;
-    private _normalizeOptions;
-    private _sendEvent;
-}
-
-/**
- * Port utilities for Local Apps
- * Helps find available ports to avoid conflicts when multiple apps run simultaneously
- */
-declare class PortModule {
-    private defaultPort;
-    constructor(defaultPort?: number);
-    /**
-     * Get suggested port from environment (RTX_PORT) or default
-     */
-    getSuggestedPort(): number;
-    /**
-     * Check if a port is available on a specific host
-     */
-    private isPortAvailableOn;
-    /**
-     * Check if a port is available (checks both IPv4 and IPv6)
-     * @param port - Port number to check
-     * @returns Promise resolving to true if port is available on ALL interfaces
-     */
-    isPortAvailable(port: number): Promise<boolean>;
-    /**
-     * Find an available port starting from the suggested port
-     * @param startPort - Starting port number (default: RTX_PORT or defaultPort)
-     * @param maxAttempts - Maximum ports to try (default: 100)
-     * @returns Promise resolving to an available port number
-     * @throws Error if no available port found in range
-     */
-    findAvailablePort(startPort?: number, maxAttempts?: number): Promise<number>;
-    /**
-     * Get a ready-to-use port
-     * Returns the suggested port if available, otherwise finds the next available port
-     *
-     * @example
-     * ```typescript
-     * const sdk = new RealtimeXSDK();
-     * const port = await sdk.port.getPort();
-     * app.listen(port);
-     * ```
-     */
-    getPort(): Promise<number>;
-}
-
-/**
- * LLM Module for RealtimeX SDK
- *
- * Provides access to LLM capabilities:
- * - Chat completion (sync and streaming)
- * - Embedding generation
- * - Provider/model listing
- * - Vector storage (upsert, query, delete)
- */
-
-interface ChatTextBlock {
-    type: 'text' | 'input_text';
-    text: string;
-    [key: string]: unknown;
-}
-interface ChatImageUrlBlock {
-    type: 'image_url' | 'input_image';
-    image_url: string | {
-        url: string;
-        detail?: 'auto' | 'low' | 'high';
-        [key: string]: unknown;
-    };
-    [key: string]: unknown;
-}
-interface ChatFileBlock {
-    type: 'input_file' | 'file';
-    file_url?: string;
-    file_id?: string;
-    filename?: string;
-    [key: string]: unknown;
-}
-interface ChatCustomBlock {
-    type: string;
-    [key: string]: unknown;
-}
-type ChatContentBlock = ChatTextBlock | ChatImageUrlBlock | ChatFileBlock | ChatCustomBlock;
-type ChatMessageContent = string | ChatContentBlock[];
-interface ChatMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: ChatMessageContent;
-}
-interface ChatOptions {
-    model?: string;
-    provider?: string;
-    temperature?: number;
-    max_tokens?: number;
-    response_format?: {
-        type: string;
-    };
-}
-interface ChatResponse {
-    success: boolean;
-    response?: {
-        content: string;
-        model: string;
-        provider?: string;
-        metrics?: {
-            prompt_tokens: number;
-            completion_tokens: number;
-            total_tokens: number;
-            duration?: number;
-            outputTps?: number;
-        };
-    };
-    error?: string;
-    code?: string;
-}
-interface StreamChunk {
-    uuid?: string;
-    type?: string;
-    textResponse?: string;
-    close?: boolean;
-    error?: boolean;
-}
-interface EmbedOptions {
-    provider?: string;
-    model?: string;
-}
-interface EmbedResponse {
-    success: boolean;
-    embeddings?: number[][];
-    provider?: string;
-    model?: string;
-    dimensions?: number;
-    error?: string;
-    code?: string;
-    errors?: string[];
-}
-interface Provider {
-    provider: string;
-    models: Array<{
-        id: string;
-        name: string;
-    }>;
-}
-interface ProvidersResponse {
-    success: boolean;
-    llm?: Provider[];
-    embedding?: Provider[];
-    providers?: Provider[];
-    error?: string;
-    code?: string;
-}
-interface VectorRecord {
-    id: string;
-    vector: number[];
-    metadata?: {
-        text?: string;
-        documentId?: string;
-        workspaceId?: string;
-        [key: string]: unknown;
-    };
-}
-interface VectorUpsertOptions {
-    workspaceId?: string;
-}
-interface VectorUpsertResponse {
-    success: boolean;
-    upserted?: number;
-    namespace?: string;
-    error?: string;
-    code?: string;
-    errors?: string[];
-}
-interface VectorQueryOptions {
-    topK?: number;
-    filter?: {
-        workspaceId?: string;
-        documentId?: string;
-    };
-    workspaceId?: string;
-    provider?: string;
-    model?: string;
-}
-interface VectorQueryResult {
-    id: string;
-    score: number;
-    metadata?: {
-        text?: string;
-        documentId?: string;
-        workspaceId?: string;
-        [key: string]: unknown;
-    };
-}
-interface VectorQueryResponse {
-    success: boolean;
-    results?: VectorQueryResult[];
-    error?: string;
-    code?: string;
-}
-interface VectorDeleteOptions {
-    workspaceId?: string;
-    deleteAll: true;
-}
-interface VectorDeleteResponse {
-    success: boolean;
-    deleted?: number;
-    message?: string;
-    error?: string;
-    code?: string;
-    errors?: string[];
-}
-interface VectorListWorkspacesResponse {
-    success: boolean;
-    workspaces?: string[];
-    error?: string;
-    code?: string;
-    error_message?: string;
-}
-interface VectorRegisterResponse {
-    success: boolean;
-    message?: string;
-    error?: string;
-    code?: string;
-}
-interface VectorConfigResponse {
-    success: boolean;
-    provider?: string;
-    config?: Record<string, any>;
-    error?: string;
-    code?: string;
-}
-interface VectorProviderField {
-    name: string;
-    label: string;
-    type: 'string' | 'password';
-    placeholder?: string;
-}
-interface VectorProviderMetadata {
-    name: string;
-    label: string;
-    description?: string;
-    fields: VectorProviderField[];
-}
-interface VectorProvidersResponse {
-    success: boolean;
-    providers: VectorProviderMetadata[];
-}
-/**
- * @deprecated Use PermissionRequiredError from api module instead
- */
-declare class LLMPermissionError extends PermissionRequiredError {
-    constructor(permission: string, code?: string);
-}
-declare class LLMProviderError extends Error {
-    code: string;
-    constructor(message: string, code?: string);
-}
-declare class VectorStore {
-    private baseUrl;
-    private appId;
-    private appName;
-    private apiKey?;
-    constructor(baseUrl: string, appId: string, appName?: string, apiKey?: string | undefined);
-    private get headers();
-    /**
-     * Request a single permission from Electron via internal API
-     */
-    private requestPermission;
-    /**
-     * Internal request wrapper that handles automatic permission prompts
-     */
-    private request;
-    /**
-     * Upsert (insert or update) vectors into storage
-     *
-     * @example
-     * ```ts
-     * await sdk.llm.vectors.upsert([
-     *   { id: 'chunk-1', vector: embeddings[0], metadata: { text: 'Hello', documentId: 'doc-1' } }
-     * ], { workspaceId: 'ws-123' });
-     * ```
-     */
-    upsert(vectors: VectorRecord[], options?: VectorUpsertOptions): Promise<VectorUpsertResponse>;
-    /**
-     * Query similar vectors by embedding
-     *
-     * @example
-     * ```ts
-     * const results = await sdk.llm.vectors.query(queryVector, {
-     *   topK: 5,
-     *   filter: { documentId: 'doc-1' },
-     *   workspaceId: 'ws-123'
-     * });
-     * ```
-     */
-    query(vector: number[], options?: VectorQueryOptions): Promise<VectorQueryResponse>;
-    /**
-     * Delete vectors from storage
-     *
-     * Note: Currently only supports deleteAll: true
-     * Use workspaceId to scope deletion to a specific workspace
-     *
-     * @example
-     * ```ts
-     * await sdk.llm.vectors.delete({ deleteAll: true, workspaceId: 'ws-123' });
-     * ```
-     */
-    delete(options: VectorDeleteOptions): Promise<VectorDeleteResponse>;
-    /**
-     * List all available workspaces (namespaces) for this app
-     *
-     * @example
-     * ```ts
-     * const { workspaces } = await sdk.llm.vectors.listWorkspaces();
-     * console.log('Workspaces:', workspaces);
-     * ```
-     */
-    listWorkspaces(): Promise<VectorListWorkspacesResponse>;
-    /**
-     * Register a custom vector database configuration for this app
-     *
-     * @example
-     * ```ts
-     * await sdk.llm.vectors.registerConfig('lancedb', { });
-     * ```
-     */
-    registerConfig(provider: string, config: Record<string, any>): Promise<VectorRegisterResponse>;
-    /**
-     * List all supported vector database providers and their configuration requirements
-     */
-    listProviders(): Promise<VectorProvidersResponse>;
-    /**
-     * Get the current vector database configuration for this app
-     *
-     * @example
-     * ```ts
-     * const { provider, config } = await sdk.llm.vectors.getConfig();
-     * console.log(`App is using ${provider}`);
-     * ```
-     */
-    getConfig(): Promise<VectorConfigResponse>;
-}
-declare class LLMModule {
-    private baseUrl;
-    private appId;
-    private appName;
-    private apiKey?;
-    vectors: VectorStore;
-    constructor(baseUrl: string, appId: string, appName?: string, apiKey?: string | undefined);
-    private get headers();
-    /**
-     * Request a single permission from Electron via internal API
-     */
-    private requestPermission;
-    /**
-     * Internal request wrapper that handles automatic permission prompts
-     */
-    private request;
-    /**
-     * Get only configured chat (LLM) providers
-     *
-     * @example
-     * ```ts
-     * const { providers } = await sdk.llm.chatProviders();
-     * console.log('Available chat models:', providers[0].models);
-     * ```
-     */
-    chatProviders(): Promise<ProvidersResponse>;
-    /**
-     * Get only configured embedding providers
-     *
-     * @example
-     * ```ts
-     * const { providers } = await sdk.llm.embedProviders();
-     * console.log('Available embedding models:', providers[0].models);
-     * ```
-     */
-    embedProviders(): Promise<ProvidersResponse>;
-    /**
-     * Send a chat completion request (synchronous)
-     *
-     * @example
-     * ```ts
-     * const response = await sdk.llm.chat([
-     *   { role: 'system', content: 'You are a helpful assistant.' },
-     *   { role: 'user', content: 'Hello!' }
-     * ], { model: 'gpt-4o', temperature: 0.7 });
-     *
-     * console.log(response.response?.content);
-     * ```
-     */
-    chat(messages: ChatMessage[], options?: ChatOptions): Promise<ChatResponse>;
-    /**
-     * Send a streaming chat completion request (SSE)
-     *
-     * @example
-     * ```ts
-     * for await (const chunk of sdk.llm.chatStream([
-     *   { role: 'user', content: 'Tell me a story' }
-     * ])) {
-     *   process.stdout.write(chunk.textResponse || '');
-     * }
-     * ```
-     */
-    chatStream(messages: ChatMessage[], options?: ChatOptions): AsyncGenerator<StreamChunk, void, unknown>;
-    /**
-     * Generate vector embeddings from text
-     *
-     * @example
-     * ```ts
-     * // Single text
-     * const { embeddings } = await sdk.llm.embed('Hello world');
-     *
-     * // Multiple texts
-     * const { embeddings } = await sdk.llm.embed(['Hello', 'World']);
-     * ```
-     */
-    embed(input: string | string[], options?: EmbedOptions): Promise<EmbedResponse>;
-    /**
-     * Helper: Embed text and store as vectors in one call
-     *
-     * @example
-     * ```ts
-     * await sdk.llm.embedAndStore({
-     *   texts: ['Hello world', 'Goodbye world'],
-     *   documentId: 'doc-123',
-     *   workspaceId: 'ws-456'
-     * });
-     * ```
-     */
-    embedAndStore(params: {
-        texts: string[];
-        documentId?: string;
-        workspaceId?: string;
-        idPrefix?: string;
-        provider?: string;
-        model?: string;
-    }): Promise<VectorUpsertResponse>;
-    /**
-     * Helper: Search similar documents by text query
-     *
-     * @example
-     * ```ts
-     * const results = await sdk.llm.search('What is RealtimeX?', {
-     *   topK: 5,
-     *   workspaceId: 'ws-123'
-     * });
-     *
-     * for (const result of results) {
-     *   console.log(result.metadata?.text, result.score);
-     * }
-     * ```
-     */
-    search(query: string, options?: VectorQueryOptions): Promise<VectorQueryResult[]>;
-}
-
-declare class TTSModule {
-    private baseUrl;
-    private appId;
-    private appName;
-    private apiKey?;
-    constructor(realtimexUrl: string, appId: string, appName?: string, apiKey?: string);
-    private get headers();
-    /**
-     * Request a single permission from Electron via internal API
-     */
-    private requestPermission;
-    /**
-     * Internal request wrapper that handles automatic permission prompts
-     */
-    private request;
-    /**
-     * Generate speech from text (returns full buffer)
-     *
-     * @example
-     * ```ts
-     * const buffer = await sdk.tts.speak("Hello world");
-     * // Play buffer...
-     * ```
-     */
-    speak(text: string, options?: TTSOptions): Promise<ArrayBuffer>;
-    /**
-     * Generate speech from text with streaming (yields decoded audio chunks)
-     * Uses SSE internally but returns decoded ArrayBuffer chunks for easy playback.
-     *
-     * @example
-     * ```ts
-     * for await (const chunk of sdk.tts.speakStream("Hello world")) {
-     *   // chunk.audio is ArrayBuffer (already decoded!)
-     *   const blob = new Blob([chunk.audio], { type: chunk.mimeType });
-     *   const audio = new Audio(URL.createObjectURL(blob));
-     *   await audio.play();
-     * }
-     * ```
-     */
-    speakStream(text: string, options?: TTSOptions): AsyncGenerator<TTSChunk>;
-    /**
-     * List available TTS providers with configuration options
-     */
-    listProviders(): Promise<TTSProvider[]>;
-}
-
-declare class STTModule extends ApiModule {
-    /**
-     * Get available STT providers and their models.
-     * @returns Promise resolving to list of providers
-     */
-    listProviders(): Promise<STTProvider[]>;
-    /**
-     * Listen to microphone and transcribe speech to text.
-     * Performed on the client device (Electron) via the RealtimeX Hub.
-     *
-     * @param options Configuration options for listening
-     * @returns Promise resolving to the transcribed text
-     */
-    listen(options: STTListenOptions): Promise<STTResponse>;
-}
-
-/**
- * HTTP Client Module - Smart Client with Auth Handling
- */
-declare class HttpClient {
-    private baseUrl;
-    private appId;
-    private apiKey?;
-    private accessToken?;
-    constructor(baseUrl: string, appId: string, apiKey?: string);
-    private getAppHeaders;
-    private getAccessToken;
-    fetch(endpoint: string, options?: RequestInit): Promise<Response>;
-}
-
-/**
- * Agent Module - Simple session-based agent chat
- *
- * This module provides the simplest way to chat with AI agents:
- * 1. Create a session (optional - can just chat directly)
- * 2. Send messages (context is automatically maintained)
- * 3. Close session when done (optional - auto-expires)
- */
-
-interface AgentSessionOptions {
-    workspace_slug?: string;
-    thread_slug?: string;
-    agent_name?: string;
-}
-interface AgentSession {
-    session_id: string;
-    workspace: {
-        slug: string;
-        name: string;
-    };
-    thread?: {
-        slug: string;
-        name: string;
-    } | null;
-    agent: {
-        name: string;
-        provider: string;
-        model: string | null;
-    };
-    created_at: string;
-}
-interface AgentChatOptions {
-    message: string;
-}
-interface AgentChatResponse {
-    id: string;
-    session_id: string;
-    text: string;
-    thoughts: string[];
-    message_count: number;
-}
-interface AgentSessionInfo extends AgentSession {
-    message_count: number;
-    last_message_at: string | null;
-}
-interface StreamChunkEvent {
-    type: 'agentThought' | 'textResponse' | 'close' | 'error';
-    data: any;
-}
-declare class AgentModule {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /**
-     * Create a new agent session
-     *
-     * @example
-     * ```typescript
-     * const session = await sdk.agent.createSession({
-     *   workspace_slug: 'my-workspace',
-     *   agent_name: '@agent'
-     * });
-     * ```
-     */
-    createSession(options?: AgentSessionOptions): Promise<AgentSession>;
-    /**
-     * Chat within a session (synchronous)
-     *
-     * @example
-     * ```typescript
-     * const response = await sdk.agent.chat(sessionId, 'Hello agent!');
-     * console.log(response.text);
-     * ```
-     */
-    chat(sessionId: string, message: string): Promise<AgentChatResponse>;
-    /**
-     * Stream chat within a session
-     * Returns an async iterator for SSE events
-     *
-     * @example
-     * ```typescript
-     * for await (const event of sdk.agent.streamChat(sessionId, 'Tell me a story')) {
-     *   if (event.type === 'agentThought') {
-     *     console.log('Thinking:', event.data.thought);
-     *   } else if (event.type === 'textResponse') {
-     *     console.log('Response:', event.data.textResponse);
-     *   }
-     * }
-     * ```
-     */
-    streamChat(sessionId: string, message: string): AsyncIterableIterator<StreamChunkEvent>;
-    /**
-     * Get session information
-     *
-     * @example
-     * ```typescript
-     * const info = await sdk.agent.getSession(sessionId);
-     * console.log(`Messages sent: ${info.message_count}`);
-     * ```
-     */
-    getSession(sessionId: string): Promise<AgentSessionInfo>;
-    /**
-     * Close and delete a session
-     * Sessions auto-expire after 1 hour, but you can close them manually
-     *
-     * @example
-     * ```typescript
-     * await sdk.agent.closeSession(sessionId);
-     * ```
-     */
-    closeSession(sessionId: string): Promise<void>;
-    /**
-     * Helper: Create session and send first message in one call
-     * This is the simplest way to start chatting with an agent
-     *
-     * @example
-     * ```typescript
-     * const { session, response } = await sdk.agent.startChat('Hello agent!');
-     * console.log(response.text);
-     *
-     * // Continue chatting in the same session
-     * const reply = await sdk.agent.chat(session.session_id, 'Tell me more');
-     * ```
-     */
-    startChat(message: string, options?: AgentSessionOptions): Promise<{
-        session: AgentSession;
-        response: AgentChatResponse;
-    }>;
-}
-
-/**
- * ACP Agent Module — CLI-based agent sessions via ACP bridge
- *
- * Provides session lifecycle, sync/streaming chat, permission resolution,
- * and turn control for CLI agents (Claude, Gemini, Codex, etc.).
- *
- * Unlike AgentModule (LLM API-based), ACP agents spawn CLI processes
- * and can execute commands, read/write files, and interact with tools.
- */
-
-interface AcpAgentInfo {
-    id: string;
-    label: string;
-    handles: string[];
-    installed: boolean;
-    authReady: boolean;
-    version?: string | null;
-    status: "installed" | "not_installed";
-    /** Present when listAgents({ includeModels: true }). */
-    models?: Array<{
-        id: string;
-        name?: string;
-    }>;
-    /** "provider_api" | "fallback" — how models were resolved. */
-    source?: string | null;
-    /** Non-null if model fetch failed and fell back. */
-    error?: string | null;
-    /** Whether this agent supports using credentials from another provider. */
-    supportsProviderForwarding?: boolean;
-    /** Provider IDs that can be forwarded (e.g. ["openai", "anthropic"]). */
-    forwardableProviders?: string[];
-}
-interface AcpSessionOptions {
-    agent_id: string;
-    cwd?: string;
-    label?: string;
-    model?: string;
-    approvalPolicy?: "approve-all" | "approve-reads" | "deny-all";
-    /** Use another provider's credentials (e.g. "openai"). Agent must support forwarding. */
-    forwardedProvider?: string;
-}
-interface AcpSession {
-    session_key: string;
-    agent_id: string;
-    state: "initializing" | "ready" | "stale" | "closed";
-    backend_id: string;
-    created_at: string;
-}
-interface AcpSessionStatus extends AcpSession {
-    runtime_options: AcpRuntimeOptionPatch;
-    last_activity_at: string | null;
-    last_error?: string;
-}
-interface AcpRuntimeOptionPatch {
-    model?: string;
-    cwd?: string;
-    timeoutSeconds?: number;
-    runtimeMode?: string;
-    approvalPolicy?: "approve-all" | "approve-reads" | "deny-all";
-    extras?: Record<string, string>;
-}
-interface AcpAttachment {
-    contentString: string;
-    mime: string;
-}
-interface AcpChatResponse {
-    text: string;
-    stop_reason?: string;
-}
-interface AcpStreamEvent {
-    type: "text_delta" | "status" | "tool_call" | "permission_request" | "done" | "error" | "close";
-    data: Record<string, unknown>;
-}
-interface AcpPermissionDecision {
-    requestId: string;
-    optionId: string;
-    outcome?: string;
-}
-declare class AcpAgentModule {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /** List available CLI agents. Pass includeModels to get model lists per agent. */
-    listAgents(opts?: {
-        includeModels?: boolean;
-    }): Promise<AcpAgentInfo[]>;
-    /** Create and initialize a new ACP session. Spawns the CLI agent process. */
-    createSession(options: AcpSessionOptions): Promise<AcpSession>;
-    /** Get session status and runtime options. */
-    getSession(sessionKey: string): Promise<AcpSessionStatus>;
-    /** List active ACP sessions owned by this app. */
-    listSessions(): Promise<AcpSessionStatus[]>;
-    /** Update runtime options (applied on next turn). */
-    patchSession(sessionKey: string, patch: AcpRuntimeOptionPatch): Promise<void>;
-    /** Close session and stop the agent process. */
-    closeSession(sessionKey: string, reason?: string): Promise<void>;
-    /**
-     * Synchronous turn — waits for completion, returns full response.
-     * Requires approvalPolicy set on the session (via create or patchSession).
-     */
-    chat(sessionKey: string, message: string, attachments?: AcpAttachment[]): Promise<AcpChatResponse>;
-    /**
-     * Streaming turn via SSE. Yields events as they arrive.
-     *
-     * Uses named SSE events (event: + data: lines). The event type comes
-     * from the `event:` line, not from inside the JSON payload.
-     *
-     * @example
-     * ```typescript
-     * for await (const event of sdk.acpAgent.streamChat(key, 'Explain this')) {
-     *   if (event.type === 'text_delta') console.log(event.data.text);
-     *   if (event.type === 'permission_request') {
-     *     await sdk.acpAgent.resolvePermission(key, {
-     *       requestId: event.data.requestId as string,
-     *       optionId: 'allow_once',
-     *     });
-     *   }
-     * }
-     * ```
-     */
-    streamChat(sessionKey: string, message: string, attachments?: AcpAttachment[]): AsyncIterableIterator<AcpStreamEvent>;
-    /** Cancel the active turn on a session. */
-    cancelTurn(sessionKey: string, reason?: string): Promise<void>;
-    /** Resolve a pending permission request (call while SSE stream is active). */
-    resolvePermission(sessionKey: string, decision: AcpPermissionDecision): Promise<{
-        resolved: boolean;
-        reason?: string;
-    }>;
-    /** Convenience: create session + first sync chat in one call. */
-    startChat(message: string, options: AcpSessionOptions): Promise<{
-        session: AcpSession;
-        response: AcpChatResponse;
-    }>;
-}
-
-/**
- * MCP Module - Interact with MCP servers via RealtimeX SDK
- */
-
-interface MCPServer {
-    /** Unique server name (slug) */
-    name: string;
-    /** User-friendly display name */
-    display_name: string;
-    /** Server description */
-    description: string | null;
-    /** Server type: 'stdio', 'http', 'sse', or 'remote' */
-    server_type: string;
-    /** Whether the server is enabled */
-    enabled: boolean;
-    /** Provider: 'local' or 'remote' */
-    provider: 'local' | 'remote';
-    /** Tags / categories */
-    tags: string[];
-}
-interface MCPTool {
-    /** Tool name */
-    name: string;
-    /** Tool description */
-    description: string | null;
-    /** JSON Schema describing the tool's input parameters */
-    input_schema: Record<string, any>;
-}
-interface MCPToolResult {
-    /** Whether the execution was successful */
-    success: boolean;
-    /** Server that executed the tool */
-    server: string;
-    /** Tool that was executed */
-    tool: string;
-    /** Provider used */
-    provider: string;
-    /** Execution result data */
-    result: any;
-    /** Error message if failed */
-    error?: string;
-}
-declare class MCPModule extends ApiModule {
-    constructor(realtimexUrl: string, appId: string, appName?: string, apiKey?: string);
-    /**
-     * List configured MCP servers.
-     * @param provider - Filter by provider: 'local', 'remote', or 'all' (default: 'all')
-     * @returns Array of MCP server objects
-     */
-    getServers(provider?: 'local' | 'remote' | 'all'): Promise<MCPServer[]>;
-    /**
-     * List available tools for a specific MCP server.
-     * @param serverName - The server name (slug)
-     * @param provider - Provider: 'local' or 'remote' (default: 'local')
-     * @returns Array of tool objects with name, description, and input schema
-     */
-    getTools(serverName: string, provider?: 'local' | 'remote'): Promise<MCPTool[]>;
-    /**
-     * Execute a tool on an MCP server.
-     * @param serverName - The server name (slug)
-     * @param toolName - The tool name to execute
-     * @param args - Arguments to pass to the tool (matches tool's input_schema)
-     * @param provider - Provider: 'local' or 'remote' (default: 'local')
-     * @returns Tool execution result
-     */
-    executeTool(serverName: string, toolName: string, args?: Record<string, any>, provider?: 'local' | 'remote'): Promise<any>;
-}
-
-declare const LOCAL_APP_CONTRACT_VERSION = "local-app-contract/v1";
-declare const CONTRACT_SIGNATURE_HEADER = "x-rtx-contract-signature";
-declare const CONTRACT_EVENT_ID_HEADER = "x-rtx-event-id";
-declare const CONTRACT_SIGNATURE_ALGORITHM = "sha256";
-declare const CONTRACT_ATTEMPT_PREFIX = "run-";
-interface ContractSignInput {
-    secret: string;
-    eventId?: string;
-    eventType: ContractEventType | string;
-    taskId: string;
-    attemptId?: string | number | null;
-    timestamp?: string | null;
-    payload?: unknown;
-}
-declare function normalizeContractEvent(eventLike?: string | null): ContractEventType | null;
-declare function normalizeAttemptId(attemptLike?: string | number | null): string | undefined;
-declare function parseAttemptRunId(attemptLike?: string | number | null): number | null;
-declare function hashContractPayload(payload: unknown): string;
-declare function createContractEventId(): string;
-declare function buildContractSignatureMessage({ eventId, eventType, taskId, attemptId, timestamp, payload, }: Omit<ContractSignInput, 'secret'>): string;
-declare function signContractEvent(input: ContractSignInput): string;
-declare function canonicalEventToLegacyAction(eventLike: string): string | null;
-declare function buildContractIdempotencyKey({ taskId, eventType, eventId, attemptId, machineId, timestamp, payload, }: {
-    taskId: string;
-    eventType: string;
-    eventId?: string | null;
-    attemptId?: string | number | null;
-    machineId?: string | null;
-    timestamp?: string | null;
-    payload?: unknown;
-}): string;
-declare class ContractModule {
-    private readonly realtimexUrl;
-    private readonly appName?;
-    private readonly appId?;
-    private readonly apiKey?;
-    private cachedContract;
-    private cachedCapabilities;
-    private cachedCapabilityCatalogHash;
-    constructor(realtimexUrl: string, appName?: string, appId?: string, apiKey?: string);
-    private requestPermission;
-    private request;
-    getLocalAppV1(forceRefresh?: boolean): Promise<LocalAppContractDefinition>;
-    listCapabilities(forceRefresh?: boolean): Promise<ContractCapability$1[]>;
-    searchCapabilities(query: string): Promise<ContractCapability$1[]>;
-    describeCapability(capabilityId: string): Promise<ContractCapability$1>;
-    search(query: string): Promise<ContractCapability$1[]>;
-    describe(capabilityId: string): Promise<ContractCapability$1>;
-    invoke(payload: ContractInvokePayload): Promise<TriggerAgentResponse>;
-    getCachedCatalogHash(): string | null;
-    clearCache(): void;
-}
-
-type ProviderKind = 'gemini' | 'claude' | 'codex';
-type ContractStrictness = 'compatible' | 'strict';
-interface ContractCallbackRules {
-    event_id_header?: string;
-    signature_header?: string;
-    signature_algorithm?: string;
-    signature_message?: string;
-    attempt_id_format?: string;
-    idempotency?: string;
-}
-interface ContractCapabilityTrigger {
-    event: 'task.trigger';
-    route?: string;
-    payload_template?: Record<string, unknown>;
-}
-interface ContractCapability {
-    capability_id: string;
-    name: string;
-    description: string;
-    input_schema: Record<string, unknown>;
-    output_schema?: Record<string, unknown>;
-    permission: string;
-    trigger: ContractCapabilityTrigger;
-}
-interface LocalAppContractV1 {
-    contract_version: 'local-app-contract/v1';
-    strictness: ContractStrictness;
-    supported_contract_events: string[];
-    supported_legacy_events?: string[];
-    aliases?: Record<string, string>;
-    status_map?: Record<string, string>;
-    legacy_action_map?: Record<string, string>;
-    callback?: ContractCallbackRules;
-    capabilities?: ContractCapability[];
-}
-interface LegacyLocalAppContractShape {
-    id?: string;
-    version?: string;
-    strictness?: ContractStrictness;
-    supported_events?: string[];
-    supported_contract_events?: string[];
-    supported_legacy_events?: string[];
-    aliases?: Record<string, string>;
-    status_map?: Record<string, string>;
-    legacy_action_map?: Record<string, string>;
-    callback?: ContractCallbackRules;
-    capabilities?: ContractCapability[];
-}
-interface ContractDiscoveryResponse {
-    success: boolean;
-    contract: LocalAppContractV1 | LegacyLocalAppContractShape;
-}
-
-interface ProjectToolsInput {
-    contract: LocalAppContractV1;
-    provider: ProviderKind;
-    appId: string;
-    namespace?: string;
-}
-interface CanonicalToolDefinition {
-    tool_name: string;
-    title: string;
-    description: string;
-    input_schema: Record<string, unknown>;
-    output_schema?: Record<string, unknown>;
-    permission: string;
-    capability_id: string;
-    trigger: ContractCapability['trigger'];
-}
-interface HostToolAdapter<TProviderTool, TProviderToolCall, TProviderResult> {
-    toProviderTools(tools: CanonicalToolDefinition[]): TProviderTool[];
-    fromProviderToolCall(call: TProviderToolCall): {
-        tool_call_id: string;
-        tool_name: string;
-        args: Record<string, unknown>;
-    };
-    toProviderResult(result: {
-        status: 'completed' | 'failed' | 'queued';
-        tool_call_id?: string;
-        task_id?: string;
-        attempt_id?: string;
-        output?: Record<string, unknown>;
-        error?: {
-            code: string;
-            message: string;
-            retryable: boolean;
-        };
-    }): TProviderResult;
-}
-
-interface ToolCall {
-    tool_call_id: string;
-    tool_name: string;
-    args: Record<string, unknown>;
-}
-interface ExecutionContext {
-    appId: string;
-    userId: string;
-    workspaceId?: string;
-    requestId?: string;
-    idempotencyKey?: string;
-    provider?: ProviderKind;
-    namespace?: string;
-    metadata?: Record<string, unknown>;
-}
-interface ExecutionResult {
-    status: 'completed' | 'failed' | 'queued';
-    tool_call_id?: string;
-    task_id?: string;
-    attempt_id?: string;
-    output?: Record<string, unknown>;
-    error?: {
-        code: string;
-        message: string;
-        retryable: boolean;
-    };
-}
-type LifecycleEventType = 'task.claimed' | 'task.started' | 'task.progress' | 'task.completed' | 'task.failed' | 'task.canceled';
-interface RuntimeExecutionEvent {
-    tool_call_id: string;
-    task_id: string;
-    attempt_id?: string;
-    event_type: LifecycleEventType;
-    event_id: string;
-    timestamp: string;
-    payload?: Record<string, unknown>;
-}
-interface GetToolsInput {
-    appId: string;
-    provider: ProviderKind;
-    namespace?: string;
-}
-interface IngestExecutionEventInput {
-    event?: string;
-    event_type?: string;
-    event_id?: string;
-    task_id?: string;
-    task_uuid?: string;
-    attempt_id?: string | number | null;
-    tool_call_id?: string;
-    timestamp?: string;
-    payload?: Record<string, unknown>;
-    data?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-interface ContractRuntimeInterface {
-    getContract(appId: string): Promise<LocalAppContractV1>;
-    getTools(input: GetToolsInput): Promise<CanonicalToolDefinition[]>;
-    executeToolCall(call: ToolCall, context: ExecutionContext): Promise<ExecutionResult>;
-    onExecutionEvent(handler: (event: RuntimeExecutionEvent) => void): () => void;
-}
-
-interface RetryPolicyOptions {
-    maxAttempts?: number;
-    baseDelayMs?: number;
-    maxDelayMs?: number;
-    shouldRetry?: (error: unknown, attempt: number) => boolean;
-}
-declare class RetryPolicy {
-    private readonly maxAttempts;
-    private readonly baseDelayMs;
-    private readonly maxDelayMs;
-    private readonly shouldRetry;
-    constructor(options?: RetryPolicyOptions);
-    execute<T>(operation: (attempt: number) => Promise<T>): Promise<T>;
-}
-
-interface ContractRuntimeOptions {
-    baseUrl: string;
-    appId?: string;
-    appName?: string;
-    apiKey?: string;
-    permissions?: string[];
-    namespace?: string;
-    fetchImpl?: typeof fetch;
-    cacheTtlMs?: number;
-    retry?: RetryPolicyOptions;
-}
-declare class ContractRuntime implements ContractRuntimeInterface {
-    private readonly appId?;
-    private readonly appName?;
-    private readonly defaultNamespace?;
-    private readonly contractClient;
-    private readonly toolProjector;
-    private readonly executionStore;
-    private readonly lifecycleReporter;
-    private readonly scopeGuard;
-    private readonly retryPolicy;
-    private readonly httpClient;
-    constructor(options: ContractRuntimeOptions);
-    getContract(appId: string): Promise<LocalAppContractV1>;
-    getTools(input: GetToolsInput): Promise<CanonicalToolDefinition[]>;
-    executeToolCall(call: ToolCall, context: ExecutionContext): Promise<ExecutionResult>;
-    onExecutionEvent(handler: (event: RuntimeExecutionEvent) => void): () => void;
-    ingestExecutionEvent(input: IngestExecutionEventInput): RuntimeExecutionEvent | null;
-    clearCache(): void;
-    private assertAppContext;
-    private buildRegistryKey;
-    private resolveTaskId;
-    private buildTriggerRequestBody;
-    private validateToolArgs;
-    private matchesType;
-    private tryEmitLifecycleEvent;
-    private toFailedResult;
-}
-
-/**
- * Database Module - Retrieve Supabase config from RealtimeX Main App
- *
- * Allows Local Apps to fetch their database configuration (URL, anonKey, mode)
- * without hardcoding them.
- */
-interface DatabaseConfig {
-    url: string;
-    anonKey: string;
-    mode: 'compatible' | 'custom';
-    tables: string[];
-    max_concurrent_tasks: number;
-}
-declare class DatabaseModule {
-    private baseUrl;
-    private appId;
-    private apiKey?;
-    constructor(realtimexUrl: string, appId: string, apiKey?: string);
-    private getHeaders;
-    /**
-     * Get the Supabase database configuration for this app.
-     * Returns URL, anonKey, mode, and tables.
-     *
-     * @example
-     * ```ts
-     * const config = await sdk.database.getConfig();
-     * const supabase = createClient(config.url, config.anonKey);
-     * ```
-     */
-    getConfig(): Promise<DatabaseConfig>;
 }
 
 /**
- * Auth Module - Authentication helpers for RealtimeX SDK
+ * RealtimeX SDK
  *
- * Provides:
- * - syncSupabaseToken(): Push Supabase JWT to Main App for RLS-aware operations
- * - getAccessToken(): Retrieve the Keycloak access token from Main App (existing endpoint)
- */
-interface AuthTokenResponse {
-    token: string;
-    hasToken: boolean;
-    syncedAt: string | null;
-    source: string | null;
-}
-interface SyncTokenResponse {
-    success: boolean;
-    message: string;
-    hasToken: boolean;
-    syncedAt: string | null;
-    source: string | null;
-}
-declare class AuthModule {
-    private baseUrl;
-    private appId;
-    private apiKey?;
-    constructor(realtimexUrl: string, appId: string, apiKey?: string);
-    private getHeaders;
-    /**
-     * Push a Supabase access token to the Main App.
-     * This enables Main App to use the token for:
-     * - Realtime subscriptions (bypass RLS)
-     * - CRUD operations on rtx_activities (bypass RLS)
-     *
-     * @param token - Supabase JWT from supabase.auth.signIn()
-     *
-     * @example
-     * ```ts
-     * const { data } = await supabase.auth.signInWithPassword({ email, password });
-     * await sdk.auth.syncSupabaseToken(data.session.access_token);
-     * ```
-     */
-    syncSupabaseToken(token: string): Promise<SyncTokenResponse>;
-    /**
-     * Retrieve the current Keycloak access token from Main App.
-     * This is the existing Token Vending Machine endpoint.
-     *
-     * @returns The access token info, or null if no token is available.
-     */
-    getAccessToken(): Promise<AuthTokenResponse | null>;
-}
-
-/**
- * Credentials Module — read-only access to user-managed credentials
- *
- * Credential values are encrypted at rest and decrypted only on get().
- * Values should NEVER be printed to stdout or included in agent responses.
- */
-
-interface CredentialInfo {
-    name: string;
-    type: "http_header" | "query_auth" | "basic_auth" | "env_var";
-    metadata: Record<string, any> | null;
-}
-interface CredentialPayload {
-    name: string;
-    type: string;
-    payload: Record<string, string>;
-}
-declare class CredentialsModule {
-    private httpClient;
-    constructor(httpClient: HttpClient);
-    /** List available credentials (names and types, no values). */
-    list(): Promise<CredentialInfo[]>;
-    /** Get a credential's decrypted payload by name. */
-    get(name: string): Promise<CredentialPayload>;
-}
-
-interface ContractHttpClientConfig {
-    baseUrl: string;
-    appId?: string;
-    appName?: string;
-    apiKey?: string;
-    fetchImpl?: typeof fetch;
-}
-declare class ContractHttpClient {
-    private readonly baseUrl;
-    private readonly appId?;
-    private readonly appName?;
-    private readonly apiKey?;
-    private readonly fetchImpl;
-    constructor(config: ContractHttpClientConfig);
-    get<T>(path: string, headers?: HeadersInit): Promise<T>;
-    post<T>(path: string, body: unknown, headers?: HeadersInit): Promise<T>;
-    request<T>(path: string, options?: RequestInit): Promise<T>;
-    private buildHeaders;
-    private parseResponse;
-}
-
-declare class ContractCache {
-    private readonly ttlMs;
-    private readonly entries;
-    constructor(ttlMs?: number);
-    get(key: string): LocalAppContractV1 | null;
-    set(key: string, value: LocalAppContractV1): void;
-    clear(key?: string): void;
-}
-
-interface ContractClientOptions {
-    cache?: ContractCache;
-    cacheKey?: string;
-}
-declare class ContractClient {
-    private readonly httpClient;
-    private readonly cache;
-    private readonly cacheKey;
-    constructor(httpClient: ContractHttpClient, options?: ContractClientOptions);
-    getLocalAppV1(forceRefresh?: boolean): Promise<LocalAppContractV1>;
-    clearCache(): void;
-}
-
-declare function normalizeLocalAppContractV1(payload: unknown): LocalAppContractV1;
-
-declare class ToolProjector {
-    project(input: ProjectToolsInput): CanonicalToolDefinition[];
-    private ensureUniqueToolName;
-}
-
-declare function normalizeSchema(schema?: Record<string, unknown>): Record<string, unknown>;
-
-declare function toStableToolName(capabilityId: string, namespace?: string): string;
-
-declare class ScopeGuard {
-    private readonly scopes;
-    constructor(scopes?: string[]);
-    can(permission?: string): boolean;
-    assert(permission?: string): void;
-}
-
-interface AuthProvider {
-    buildHeaders(baseHeaders?: Record<string, string>): Record<string, string>;
-}
-interface StaticAuthProviderOptions {
-    appId?: string;
-    appName?: string;
-    apiKey?: string;
-}
-declare class StaticAuthProvider implements AuthProvider {
-    private readonly appId?;
-    private readonly appName?;
-    private readonly apiKey?;
-    constructor(options?: StaticAuthProviderOptions);
-    buildHeaders(baseHeaders?: Record<string, string>): Record<string, string>;
-}
-
-declare class ContractError extends Error {
-    readonly code: string;
-    readonly details?: unknown;
-    constructor(code: string, message: string, details?: unknown);
-}
-declare class ContractValidationError extends ContractError {
-    constructor(message: string, details?: unknown);
-}
-declare class ToolValidationError extends ContractError {
-    constructor(message: string, details?: unknown);
-}
-declare class ToolNotFoundError extends ContractError {
-    constructor(toolName: string, details?: unknown);
-}
-declare class ScopeDeniedError extends ContractError {
-    constructor(permission: string, details?: unknown);
-}
-declare class RuntimeTransportError extends ContractError {
-    readonly statusCode?: number;
-    constructor(message: string, statusCode?: number, details?: unknown);
-}
-
-interface GeminiFunctionDeclaration {
-    name: string;
-    description?: string;
-    parameters?: Record<string, unknown>;
-}
-interface GeminiToolCall {
-    id: string;
-    name: string;
-    args?: Record<string, unknown> | string;
-}
-interface GeminiToolResult {
-    tool_call_id: string;
-    status: ExecutionResult['status'];
-    payload: Record<string, unknown>;
-}
-declare class GeminiToolAdapter implements HostToolAdapter<GeminiFunctionDeclaration, GeminiToolCall, GeminiToolResult> {
-    toProviderTools(tools: CanonicalToolDefinition[]): GeminiFunctionDeclaration[];
-    fromProviderToolCall(call: GeminiToolCall): ToolCall;
-    toProviderResult(result: ExecutionResult): GeminiToolResult;
-}
-
-interface ClaudeToolDefinition {
-    name: string;
-    description: string;
-    input_schema: Record<string, unknown>;
-}
-interface ClaudeToolCall {
-    id: string;
-    name: string;
-    input?: Record<string, unknown>;
-}
-interface ClaudeToolResult {
-    type: 'tool_result';
-    tool_use_id: string;
-    content: string;
-    is_error?: boolean;
-}
-declare class ClaudeToolAdapter implements HostToolAdapter<ClaudeToolDefinition, ClaudeToolCall, ClaudeToolResult> {
-    toProviderTools(tools: CanonicalToolDefinition[]): ClaudeToolDefinition[];
-    fromProviderToolCall(call: ClaudeToolCall): ToolCall;
-    toProviderResult(result: ExecutionResult): ClaudeToolResult;
-}
-
-interface CodexToolDefinition {
-    type: 'function';
-    function: {
-        name: string;
-        description: string;
-        parameters: Record<string, unknown>;
-    };
-}
-interface CodexToolCall {
-    id: string;
-    function: {
-        name: string;
-        arguments?: string | Record<string, unknown>;
-    };
-}
-interface CodexToolResult {
-    tool_call_id: string;
-    output: string;
-    is_error?: boolean;
-}
-declare class CodexToolAdapter implements HostToolAdapter<CodexToolDefinition, CodexToolCall, CodexToolResult> {
-    toProviderTools(tools: CanonicalToolDefinition[]): CodexToolDefinition[];
-    fromProviderToolCall(call: CodexToolCall): ToolCall;
-    toProviderResult(result: ExecutionResult): CodexToolResult;
-}
-
-type ACPToolKind = 'read' | 'edit' | 'delete' | 'move' | 'search' | 'execute' | 'think' | 'fetch' | 'other';
-type ACPToolStatus = 'pending' | 'in_progress' | 'completed' | 'failed';
-interface ACPTextContent {
-    type: 'text';
-    text: string;
-}
-interface ACPSessionToolUpdate {
-    type: 'tool_call' | 'tool_call_update';
-    toolCallId: string;
-    title?: string;
-    kind?: ACPToolKind;
-    status: ACPToolStatus;
-    content?: ACPTextContent[];
-    rawInput?: Record<string, unknown>;
-    rawOutput?: Record<string, unknown>;
-    _meta?: Record<string, unknown>;
-}
-interface ACPSessionUpdateParams {
-    sessionId: string;
-    update: ACPSessionToolUpdate;
-}
-interface ACPNotifier {
-    notify(method: 'session/update', params: ACPSessionUpdateParams): Promise<void>;
-    request?<T = unknown>(method: string, params: Record<string, unknown>): Promise<T>;
-}
-interface ACPAdapterContext {
-    sessionId: string;
-    appId: string;
-    userId: string;
-    workspaceId?: string;
-    provider?: 'gemini' | 'claude' | 'codex';
-    namespace?: string;
-}
-interface ACPToolInvocation {
-    toolCallId: string;
-    toolName: string;
-    args: Record<string, unknown>;
-    title?: string;
-    kind?: ACPToolKind;
-}
-interface ACPExecutionReference {
-    sessionId: string;
-    toolCallId: string;
-    appId: string;
-    userId: string;
-    workspaceId?: string;
-    provider?: 'gemini' | 'claude' | 'codex';
-    namespace?: string;
-    title?: string;
-    kind?: ACPToolKind;
-}
-interface PermissionOption {
-    id: string;
-    label: string;
-    kind?: 'allow_once' | 'allow_always' | 'deny_once' | 'deny_always';
-}
-interface ACPContractRuntime {
-    executeToolCall(call: ToolCall, context: ExecutionContext): Promise<ExecutionResult>;
-    onExecutionEvent(handler: (event: RuntimeExecutionEvent) => void): () => void;
-    ingestExecutionEvent(input: IngestExecutionEventInput): RuntimeExecutionEvent | null;
-}
-interface ACPContractAdapterOptions {
-    runtime: ACPContractRuntime;
-    notifier: ACPNotifier;
-    requestPermission?: boolean;
-    buildPermissionOptions?: (input: ACPToolInvocation) => PermissionOption[];
-    telemetry?: ACPAdapterTelemetrySink;
-}
-interface ACPAdapterTelemetryEvent {
-    phase: 'execute' | 'notify' | 'permission' | 'runtime_event' | 'ingest';
-    result: 'ok' | 'failed' | 'skipped';
-    sessionId?: string;
-    toolCallId?: string;
-    toolName?: string;
-    taskId?: string;
-    attemptId?: string;
-    eventId?: string;
-    eventType?: string;
-    status?: ACPToolStatus;
-    error?: string;
-    metadata?: Record<string, unknown>;
-}
-interface ACPAdapterTelemetrySink {
-    emit(event: ACPAdapterTelemetryEvent): void | Promise<void>;
-}
-
-declare class ACPContractAdapter {
-    private readonly runtime;
-    private readonly notifier;
-    private readonly mapper;
-    private readonly permissionBridge;
-    private readonly telemetry;
-    private readonly taskReferences;
-    private readonly toolCallReferences;
-    private readonly runtimeUnsubscribe;
-    constructor(options: ACPContractAdapterOptions);
-    dispose(): void;
-    executeTool(invocation: ACPToolInvocation, context: ACPAdapterContext): Promise<ExecutionResult>;
-    ingestContractCallback(payload: Record<string, unknown>, context: Pick<ACPAdapterContext, 'sessionId'>): RuntimeExecutionEvent | null;
-    private handleRuntimeEvent;
-    private resolveReferenceForEvent;
-    private rememberReference;
-    private cleanupReference;
-    private notify;
-}
-
-declare class ACPEventMapper {
-    createReference(invocation: ACPToolInvocation, context: ACPAdapterContext): ACPExecutionReference;
-    buildPendingUpdate(invocation: ACPToolInvocation, reference: ACPExecutionReference): ACPSessionUpdateParams;
-    buildResultUpdate(result: ExecutionResult, reference: ACPExecutionReference): ACPSessionUpdateParams;
-    buildLifecycleUpdate(event: RuntimeExecutionEvent, reference: ACPExecutionReference): ACPSessionUpdateParams | null;
-    buildNotifyFailureUpdate(reference: ACPExecutionReference, error: unknown): ACPSessionUpdateParams;
-    mapContractEventStatus(eventType: string): ACPToolStatus | null;
-    private mapExecutionResultStatus;
-    private resolveEventText;
-}
-
-interface ACPPermissionBridgeOptions {
-    notifier: ACPNotifier;
-    enabled: boolean;
-    buildPermissionOptions?: (input: ACPToolInvocation) => PermissionOption[];
-}
-declare class ACPPermissionBridge {
-    private readonly notifier;
-    private readonly enabled;
-    private readonly buildPermissionOptions?;
-    constructor(options: ACPPermissionBridgeOptions);
-    requestToolPermission(invocation: ACPToolInvocation, context: ACPAdapterContext): Promise<boolean>;
-}
-
-declare class ACPTelemetry {
-    private readonly sink?;
-    constructor(sink?: ACPAdapterTelemetrySink);
-    emit(event: ACPAdapterTelemetryEvent): void;
-}
-
-/**
- * RealtimeX Local App SDK
- *
- * SDK for building Local Apps that integrate with RealtimeX
- * All operations go through RealtimeX Main App proxy
+ * Milestone 1 SDK surface: generated Developer API v1 modules for workspace,
+ * thread, and chat.
  */
 
 declare class RealtimeXSDK {
-    activities: ActivitiesModule;
-    webhook: WebhookModule;
-    api: ApiModule;
-    task: TaskModule;
-    port: PortModule;
-    llm: LLMModule;
-    tts: TTSModule;
-    stt: STTModule;
-    agent: AgentModule;
-    acpAgent: AcpAgentModule;
-    mcp: MCPModule;
-    contract: ContractModule;
-    contractRuntime: ContractRuntime;
-    database: DatabaseModule;
-    auth: AuthModule;
-    credentials: CredentialsModule;
-    /**
-     * Developer API (v1) — requires apiKey to be set in config.
-     * Provides access to workspace management, admin, documents, system settings, and more.
-     */
-    v1: V1ApiNamespace | undefined;
-    /**
-     * Desktop terminal sessions — top-level alias for the desktop runtime session APIs.
-     * Backed by `sdk.v1.desktopRuntimeSessions` for compatibility with generated v1 modules.
-     */
-    desktopRuntimeSessions: V1DesktopRuntimeSessionsModule | undefined;
-    /**
-     * Desktop browser control — top-level alias for the RealTimeX Browser session and tab APIs.
-     * Backed by `sdk.v1.desktopBrowser` for compatibility with generated v1 modules.
-     */
-    desktopBrowser: V1DesktopBrowserModule | undefined;
     readonly appId: string;
-    readonly appName: string | undefined;
     readonly apiKey: string | undefined;
-    private readonly realtimexUrl;
-    private readonly permissions;
-    private httpClient;
+    readonly realtimexUrl: string;
+    readonly v1: V1ApiNamespace;
     private static DEFAULT_REALTIMEX_URL;
     constructor(config?: SDKConfig);
-    /**
-     * Register app with RealtimeX hub and request declared permissions upfront.
-     * This is called automatically if permissions are provided in constructor.
-     */
-    register(permissions?: string[]): Promise<void>;
-    /**
-     * Get environment variable (works in Node.js and browser)
-     */
     private getEnvVar;
-    /**
-     * Ping RealtimeX server to verify connection and authentication.
-     * Works in both development (API Key) and production (App ID) modes.
-     */
-    ping(): Promise<{
-        success: boolean;
-        mode: 'development' | 'production';
-        appId?: string;
-        timestamp: string;
-    }>;
-    /**
-     * Get the absolute path to the data directory for this app.
-     * Path: ~/.realtimex.ai/Resources/local-apps/{appId}
-     */
-    getAppDataDir(): Promise<string>;
 }
 
-export { type ACPAdapterContext, type ACPAdapterTelemetryEvent, type ACPAdapterTelemetrySink, ACPContractAdapter, type ACPContractAdapterOptions, type ACPContractRuntime, ACPEventMapper, type ACPExecutionReference, type ACPNotifier, ACPPermissionBridge, type ACPSessionToolUpdate, type ACPSessionUpdateParams, ACPTelemetry, type ACPTextContent, type ACPToolInvocation, type ACPToolKind, type ACPToolStatus, type AcpAgentInfo, AcpAgentModule, type AcpAttachment, type AcpChatResponse, type AcpPermissionDecision, type AcpRuntimeOptionPatch, type AcpSession, type AcpSessionOptions, type AcpSessionStatus, type AcpStreamEvent, ActivitiesModule, type Activity, type Agent, type AgentChatOptions, type AgentChatResponse, AgentModule, type AgentSession, type AgentSessionInfo, type AgentSessionOptions, ApiModule, AuthModule, type AuthProvider, type AuthTokenResponse, CONTRACT_ATTEMPT_PREFIX, CONTRACT_EVENT_ID_HEADER, CONTRACT_SIGNATURE_ALGORITHM, CONTRACT_SIGNATURE_HEADER, type CanonicalToolDefinition, type ChatContentBlock, type ChatCustomBlock, type ChatFileBlock, type ChatImageUrlBlock, type ChatMessage, type ChatMessageContent, type ChatOptions, type ChatResponse, type ChatTextBlock, ClaudeToolAdapter, type ClaudeToolCall, type ClaudeToolDefinition, type ClaudeToolResult, CodexToolAdapter, type CodexToolCall, type CodexToolDefinition, type CodexToolResult, ContractCache, type ContractCallbackMetadata, type ContractCallbackRules, type ContractCapability, type ContractCapabilityTrigger, ContractClient, type ContractClientOptions, type ContractDiscoveryResponse, ContractError, type ContractEventType, ContractHttpClient, type ContractHttpClientConfig, type ContractInvokePayload, ContractModule, ContractRuntime, type ContractRuntimeInterface, type ContractRuntimeOptions, type ContractSignInput, type ContractStrictness, ContractValidationError, type DatabaseConfig, DatabaseModule, type EmbedOptions, type EmbedResponse, type ExecutionContext, type ExecutionResult, type GeminiFunctionDeclaration, GeminiToolAdapter, type GeminiToolCall, type GeminiToolResult, type GetToolsInput, type HostToolAdapter, type IngestExecutionEventInput, LLMModule, LLMPermissionError, LLMProviderError, LOCAL_APP_CONTRACT_VERSION, type LegacyLocalAppContractShape, type LifecycleEventType, type LocalAppCapabilitiesResponse, type LocalAppCapabilityDetailResponse, type LocalAppCapabilitySearchResponse, type LocalAppContractDefinition, type LocalAppContractResponse, type LocalAppContractV1, MCPModule, type MCPServer, type MCPTool, type MCPToolResult, PermissionDeniedError, type PermissionOption, PermissionRequiredError, PortModule, type ProjectToolsInput, type Provider, type ProviderKind, type ProvidersResponse, RealtimeXSDK, RetryPolicy, type RetryPolicyOptions, type RuntimeExecutionEvent, RuntimeTransportError, type SDKConfig, type STTListenOptions, type STTModel, type STTModelsResponse, STTModule, type STTProvider, type STTProvidersResponse, type STTResponse, ScopeDeniedError, ScopeGuard, StaticAuthProvider, type StaticAuthProviderOptions, type StreamChunk, type StreamChunkEvent, type SyncTokenResponse, type TTSChunk, type TTSChunkEvent, TTSModule, type TTSOptions, type TTSProvider, type TTSProviderConfig, type TTSProvidersResponse, type Task, TaskModule, type TaskRun, type Thread, type ToolCall, ToolNotFoundError, ToolProjector, ToolValidationError, type TriggerAgentPayload, type TriggerAgentResponse, V1ApiNamespace, type VectorDeleteOptions, type VectorDeleteResponse, type VectorQueryOptions, type VectorQueryResponse, type VectorQueryResult, type VectorRecord, VectorStore, type VectorUpsertOptions, type VectorUpsertResponse, WebhookModule, type Workspace, buildContractIdempotencyKey, buildContractSignatureMessage, canonicalEventToLegacyAction, createContractEventId, hashContractPayload, normalizeAttemptId, normalizeContractEvent, normalizeLocalAppContractV1, normalizeSchema, parseAttemptRunId, signContractEvent, toStableToolName };
+export { RealtimeXSDK, type SDKConfig, V1ApiNamespace };