@cmdop/react 0.1.1 → 0.1.2

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { CMDOPConfig } from '@cmdop/core';
 export { API_BASE_URL, AuthenticationError, CMDOPConfig, CMDOPError, CancelledError, ConnectionError, DEFAULT_CONFIG, FileInfo, MachinesModule, NotFoundError, PermissionError, ResourceExhaustedError, SessionError, SessionInfo, SessionState, SystemModule, TimeoutError, TransportMode, UnavailableError, VERSION, WorkspacesModule, api, machines, system, workspaces } from '@cmdop/core';
-import { ReactNode } from 'react';
+import { ReactNode, Dispatch, SetStateAction } from 'react';
 import { SWRConfiguration } from 'swr';
 
 /**
@@ -47,9 +47,15 @@ declare class CMDOPWebSocketClient {
      */
     unsubscribe(channel: string): void;
     /**
-     * Make an RPC call via Centrifugo
+     * Make an RPC call via Centrifugo (namedRPC compatible)
      */
     rpc<TRequest, TResponse>(method: string, data: TRequest): Promise<TResponse>;
+    /**
+     * Alias for rpc() - compatible with generated APIClient interface
+     */
+    namedRPC<TResponse = unknown>(method: string, params: unknown, _options?: {
+        timeout?: number;
+    }): Promise<TResponse>;
     /**
      * Publish to a channel (fire-and-forget)
      */
@@ -101,7 +107,7 @@ declare function WebSocketProvider({ children, url, getToken, autoConnect, debug
 declare function useWebSocket(): WebSocketContextValue;
 
 /**
- * Centrifugo React hooks for CMDOP
+ * WebSocket React hooks for CMDOP
  */
 interface UseSubscriptionOptions<T> {
     /**
@@ -169,6 +175,895 @@ interface UseRPCResult {
  */
 declare function useRPC(options?: UseRPCOptions): UseRPCResult;
 
+/**
+ * Generated TypeScript Types
+ * Auto-generated - DO NOT EDIT
+ */
+declare const enum WsFileChangeType {
+    UNSPECIFIED = 0,
+    CREATE = 1,
+    MODIFY = 2,
+    DELETE = 3,
+    MOVE = 4
+}
+declare const enum WsFileIconType {
+    UNSPECIFIED = 0,
+    FILE = 1,
+    CODE = 2,
+    TEXT = 3,
+    IMAGE = 4,
+    VIDEO = 5,
+    AUDIO = 6,
+    ARCHIVE = 7,
+    DATA = 8,
+    PDF = 9,
+    FOLDER = 10,
+    FOLDER_HOME = 11,
+    FOLDER_DESKTOP = 12,
+    FOLDER_DOCUMENTS = 13,
+    FOLDER_DOWNLOADS = 14,
+    FOLDER_PICTURES = 15,
+    FOLDER_MUSIC = 16,
+    FOLDER_VIDEOS = 17,
+    FOLDER_APPLICATIONS = 18,
+    FOLDER_LIBRARY = 19,
+    FOLDER_SYSTEM = 20,
+    FOLDER_DRIVE = 21,
+    FOLDER_CLOUD = 22,
+    FOLDER_TRASH = 23,
+    FOLDER_HIDDEN = 24,
+    FOLDER_CODE = 25,
+    FOLDER_SERVER = 26,
+    FOLDER_DATABASE = 27,
+    FOLDER_ARCHIVE = 28
+}
+declare const enum WsLoadMethod {
+    UNSPECIFIED = 0,
+    RPC = 1,
+    HTTP_STREAM = 2,
+    SKIP = 3,
+    HTTP_TRANSCODE = 4,
+    HTTP_HLS = 5
+}
+declare const enum WsSearchMatchType {
+    UNSPECIFIED = 0,
+    FILENAME = 1,
+    CONTENT = 2
+}
+declare const enum WsViewerType {
+    UNKNOWN = 0,
+    CODE = 1,
+    TEXT = 2,
+    IMAGE = 3,
+    VIDEO = 4,
+    AUDIO = 5,
+    PDF = 6,
+    MARKDOWN = 7,
+    JSON = 8,
+    YAML = 9,
+    XML = 10,
+    ARCHIVE = 11,
+    HEX = 12
+}
+interface WsCreateArchiveParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Files/directories to archive */
+    source_paths: string[];
+    /** Archive destination (auto-generated if empty) */
+    destination_path?: string;
+    /** Archive format: zip, tar, tar.gz */
+    format?: string;
+    /** Include hidden files */
+    include_hidden?: boolean;
+}
+interface WsGetChangesParams {
+    /** Agent session ID */
+    session_id: string;
+    /** Root path to get changes from */
+    path?: string;
+    /** Sequence number to get changes since */
+    since_sequence?: number;
+    /** Maximum number of changes to return */
+    limit?: number;
+}
+interface WsContentMatch {
+    line_number: number;
+    line: string;
+    column_start: number;
+    column_end: number;
+    context_before?: string[];
+    context_after?: string[];
+}
+interface WsFileEntry {
+    name: string;
+    path: string;
+    type: string;
+    size: number;
+    permissions: string;
+    owner: string;
+    modified_at: string;
+    is_hidden: boolean;
+    is_readable: boolean;
+    is_writable: boolean;
+    mime_type?: string | null;
+    symlink_target?: string | null;
+    icon_type?: WsFileIconType;
+    is_system?: boolean;
+    viewer_type?: WsViewerType;
+    load_method?: WsLoadMethod;
+    media_metadata?: WsMediaMetadata | null;
+}
+interface WsMediaMetadata {
+    duration_seconds?: number;
+    bitrate_kbps?: number;
+    sample_rate_hz?: number;
+    audio_channels?: number;
+    audio_codec?: string;
+    width?: number;
+    height?: number;
+    frame_rate?: number;
+    video_codec?: string;
+    title?: string;
+    artist?: string;
+    album?: string;
+    album_artist?: string;
+    genre?: string;
+    year?: number;
+    track_number?: number;
+    disc_number?: number;
+    comment?: string;
+    composer?: string;
+    cover_art?: string | null;
+    cover_art_mime_type?: string;
+    container_format?: string;
+    has_video?: boolean;
+    has_audio?: boolean;
+}
+interface WsSearchMatch {
+    entry: WsFileEntry;
+    match_type?: WsSearchMatchType;
+    content_matches?: WsContentMatch[];
+}
+interface WsSearchResult {
+    success: boolean;
+    error?: string | null;
+    matches?: WsSearchMatch[];
+    total_matches?: number;
+    truncated?: boolean;
+    search_path?: string;
+    files_scanned?: number;
+    duration_ms?: number;
+}
+interface WsCheckVersionParams {
+    /** Client API version hash */
+    client_version: string;
+}
+interface WsTerminalCreateSessionParams {
+    /** Optional session name */
+    name?: string;
+    /** Shell to use */
+    shell?: string;
+    /** Initial working directory */
+    working_directory?: string;
+}
+interface WsTransferInfo {
+    transfer_id: string;
+    source_session_id: string;
+    target_session_id: string;
+    source_path: string;
+    target_path: string;
+    file_size: number;
+    state: string;
+    upload_progress: number;
+    download_progress: number;
+    is_source: boolean;
+    is_target: boolean;
+}
+interface WsListTransfersResult {
+    success: boolean;
+    transfers?: WsTransferInfo[];
+    error?: string | null;
+}
+interface WsTerminalCloseParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Reason for closing */
+    reason?: string;
+}
+interface WsCreateDirectoryResult {
+    success: boolean;
+    error?: string | null;
+    path?: string;
+}
+interface WsMessageItem {
+    id: string;
+    role: string;
+    content: string;
+    response_text?: string;
+    status: string;
+    error?: string;
+    created_at: string;
+    iterations?: number;
+}
+interface WsMessageListResult {
+    success: boolean;
+    messages?: WsMessageItem[];
+    has_more?: boolean;
+    error?: string;
+}
+interface WsListSessionsParams {
+    /** Max sessions to return */
+    limit?: number;
+}
+interface WsBrowserExecuteScriptParams {
+    /** Terminal session UUID (agent connection) */
+    session_id: string;
+    /** Browser session ID */
+    browser_session_id: string;
+    /** JavaScript code to execute */
+    script: string;
+}
+interface WsTransferStatusResult {
+    found: boolean;
+    transfer_id?: string;
+    state?: string;
+    source_session_id?: string;
+    target_session_id?: string;
+    source_path?: string;
+    target_path?: string;
+    file_size?: number;
+    stored_size?: number;
+    upload_progress?: number;
+    download_progress?: number;
+    total_chunks?: number;
+    chunks_uploaded?: number;
+    chunks_downloaded?: number;
+    error?: string | null;
+}
+interface WsTerminalHistoryParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Max commands to return */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+interface WsInitiateTransferResult {
+    success: boolean;
+    transfer_id?: string;
+    chunk_size?: number;
+    total_chunks?: number;
+    error?: string | null;
+}
+interface WsInitiateTransferParams {
+    /** Source device session ID */
+    source_session_id: string;
+    /** Target device session ID */
+    target_session_id: string;
+    /** File path on source device */
+    source_path: string;
+    /** Destination path on target device */
+    target_path: string;
+    /** Total file size in bytes */
+    file_size: number;
+    /** MD5 checksum of entire file (optional) */
+    file_checksum?: string;
+    /** Chunk size for transfer */
+    chunk_size?: number;
+}
+interface WsBrowserValidateSelectorsParams {
+    /** Terminal session UUID (agent connection) */
+    session_id: string;
+    /** Browser session ID */
+    browser_session_id: string;
+    /** CSS selector for repeating item container */
+    item: string;
+    /** Field name to CSS selector mapping */
+    fields: Record<string, any>;
+}
+interface WsBrowserValidateSelectorsResult {
+    success: boolean;
+    valid?: boolean;
+    counts?: Record<string, any>;
+    samples?: Record<string, any>;
+    errors?: string[];
+    error?: string;
+}
+interface WsGetFileInfoResult {
+    success: boolean;
+    error?: string | null;
+    entry?: WsFileEntry | null;
+    is_text?: boolean;
+}
+interface WsListDirectoryResult {
+    success: boolean;
+    error?: string | null;
+    current_path?: string;
+    entries?: WsFileEntry[];
+    next_page_token?: string;
+    total_count?: number;
+    has_more?: boolean;
+    file_count?: number;
+    directory_count?: number;
+}
+interface WsChatCreateSessionParams {
+    /** Workspace UUID */
+    workspace_id: string;
+    /** Optional session title */
+    title?: string;
+}
+interface WsBrowserExtractRegexParams {
+    /** Terminal session UUID (agent connection) */
+    session_id: string;
+    /** Browser session ID */
+    browser_session_id: string;
+    /** Regex pattern */
+    pattern: string;
+    /** Source: `html` or `text` */
+    source?: string;
+    /** Max matches */
+    limit?: number;
+}
+interface WsCancelTransferResult {
+    success: boolean;
+    error?: string | null;
+}
+interface WsDeleteResult {
+    success: boolean;
+    error?: string | null;
+    deleted_path?: string;
+    files_deleted?: number;
+    dirs_deleted?: number;
+}
+interface WsMoveResult {
+    success: boolean;
+    error?: string | null;
+    path?: string;
+}
+interface WsChannelAuthResult {
+    authorized: boolean;
+    error?: string;
+}
+interface WsBrowserExecuteScriptResult {
+    success: boolean;
+    result?: string;
+    error?: string;
+}
+interface WsChatSessionResult {
+    success: boolean;
+    session_id?: string;
+    error?: string;
+}
+interface WsGetSessionParams {
+    /** Terminal session UUID */
+    session_id: string;
+}
+interface WsReadFileResult {
+    success: boolean;
+    error?: string | null;
+    content?: string;
+    total_size?: number;
+    read_size?: number;
+    mime_type?: string | null;
+    is_text?: boolean;
+    viewer_type?: WsViewerType;
+}
+interface WsSearchParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Base directory to search */
+    path?: string;
+    /** Glob pattern for filenames (e.g., `*.ts`, `**\/*.go`) */
+    filename_pattern?: string;
+    /** Regex pattern for file content */
+    content_pattern?: string;
+    /** Case sensitivity for content search */
+    case_sensitive?: boolean;
+    /** Include hidden files/directories */
+    include_hidden?: boolean;
+    /** Maximum results */
+    max_results?: number;
+    /** Maximum directory depth (0 = unlimited) */
+    max_depth?: number;
+    /** Lines of context around matches */
+    context_lines?: number;
+}
+interface WsMessageResult {
+    success: boolean;
+    message_id?: string;
+    status?: string;
+    error?: string;
+}
+interface WsBrowserExtractDataParams {
+    /** Terminal session UUID (agent connection) */
+    session_id: string;
+    /** Browser session ID */
+    browser_session_id: string;
+    /** CSS selector for repeating item container */
+    item: string;
+    /** Field extractors (string or {selector, attr, regex}) */
+    fields: Record<string, any>;
+    /** Max items to extract */
+    limit?: number;
+}
+interface WsTerminalResizeParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Number of columns */
+    cols: number;
+    /** Number of rows */
+    rows: number;
+}
+interface WsCancelTransferParams {
+    /** Transfer ID to cancel */
+    transfer_id: string;
+}
+interface WsCreateDirectoryParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Directory path to create */
+    path: string;
+    /** Create parent directories */
+    create_parents?: boolean;
+}
+interface WsSessionResult {
+    session_id: string;
+    name: string;
+    status: string;
+    shell: string;
+    working_directory: string;
+    agent_hostname?: string;
+    commands_count?: number;
+}
+interface WsMoveParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Source path */
+    source_path: string;
+    /** Destination path */
+    destination_path: string;
+    /** Overwrite if exists */
+    overwrite?: boolean;
+}
+interface WsListTransfersParams {
+    /** Session ID to list transfers for */
+    session_id: string;
+    /** Include completed transfers */
+    include_completed?: boolean;
+}
+interface WsSuccessResult {
+    success: boolean;
+    message?: string;
+}
+interface WsGetFileInfoParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** File path */
+    path: string;
+}
+interface WsFileChange {
+    /** Type of change (create, modify, delete, rename) */
+    change_type: WsFileChangeType;
+    /** File entry (null for delete) */
+    item?: WsFileEntry | null;
+    /** Previous path (for rename operations) */
+    old_path?: string;
+}
+interface WsGetChangesResult {
+    /** Whether operation succeeded */
+    success?: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** List of file changes */
+    changes?: WsFileChange[];
+    /** Current sequence number (for next sync) */
+    current_sequence?: number;
+    /** Server timestamp (Unix epoch) */
+    server_timestamp?: number;
+    /** Whether there are more changes to fetch */
+    has_more?: boolean;
+    /** Cursor for pagination (if has_more is true) */
+    next_cursor?: string;
+    /** MD5 hash of directory state for integrity check */
+    state_digest?: string;
+}
+interface WsBrowserExtractRegexResult {
+    success: boolean;
+    matches?: Record<string, any>[];
+    count?: number;
+    error?: string;
+}
+interface WsTerminalInputParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Input data (base64 encoded) */
+    data: string;
+}
+interface WsSessionListResult {
+    sessions: WsSessionResult[];
+    total: number;
+}
+interface WsChannelAuthParams {
+    /** Channel name to authorize */
+    channel: string;
+}
+interface WsGetHistoryParams {
+    /** Workspace UUID */
+    workspace_id: string;
+    /** Filter by session UUID */
+    session_id?: string | null;
+    /** Max messages to return */
+    limit?: number;
+    /** Pagination offset */
+    offset?: number;
+}
+interface WsWriteFileParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** File path to write */
+    path: string;
+    /** File content (base64 encoded) */
+    content: string;
+    /** Overwrite if exists */
+    overwrite?: boolean;
+    /** Create parent directories */
+    create_parents?: boolean;
+}
+interface WsDeleteParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Path to delete */
+    path: string;
+    /** Delete directories recursively */
+    recursive?: boolean;
+}
+interface WsTransferStatusParams {
+    /** Transfer ID */
+    transfer_id: string;
+}
+interface WsHistoryResult {
+    commands: string[];
+    total: number;
+}
+interface WsReadFileParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** File path to read */
+    path: string;
+    /** Start offset in bytes */
+    offset?: number;
+    /** Bytes to read (0 = entire file) */
+    length?: number;
+}
+interface WsCreateArchiveResult {
+    success: boolean;
+    error?: string | null;
+    archive_path?: string;
+    bytes_archived?: number;
+    files_archived?: number;
+    dirs_archived?: number;
+}
+interface WsListDirectoryParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Directory path to list */
+    path: string;
+    /** Max entries per page */
+    page_size?: number;
+    /** Token for pagination */
+    page_token?: string;
+    /** Include hidden files */
+    include_hidden?: boolean;
+    /** Sort order */
+    sort_order?: string;
+}
+interface WsWriteFileResult {
+    success: boolean;
+    error?: string | null;
+    bytes_written?: number;
+    path?: string;
+}
+interface WsBrowserExtractDataResult {
+    success: boolean;
+    items?: Record<string, any>[];
+    count?: number;
+    error?: string;
+}
+interface WsVersionCheckResult {
+    /** Whether versions are compatible */
+    compatible: boolean;
+    /** Client version received */
+    client_version: string;
+    /** Server API version hash */
+    server_version: string;
+    /** Additional info message */
+    message?: string;
+}
+interface WsTerminalSignalParams {
+    /** Terminal session UUID */
+    session_id: string;
+    /** Signal number (2=SIGINT, 9=SIGKILL, 15=SIGTERM) */
+    signal?: number;
+}
+interface WsSendMessageParams {
+    /** Workspace UUID */
+    workspace_id: string;
+    /** User message/prompt */
+    message: string;
+    /** Optional chat session UUID */
+    session_id?: string | null;
+    /** Target machine UUIDs for orchestrator mode (empty = all machines) */
+    target_machine_ids?: string[];
+    /** Client-generated message ID for optimistic UI updates */
+    client_message_id?: string | null;
+    /** Enable streaming response */
+    stream?: boolean;
+}
+
+/**
+ * Generated API Client
+ * Auto-generated thin wrapper - DO NOT EDIT
+ *
+ * @generated 2026-01-25T04:56:47.477899
+ */
+
+/**
+ * API contract version - changes when methods or models change.
+ * Use checkVersion() to verify client/server compatibility.
+ */
+declare const API_VERSION = "5e38751f";
+/**
+ * Timestamp when this client was generated.
+ */
+declare const GENERATED_AT = "2026-01-25T04:56:47.477899";
+interface CentrifugoClient {
+    namedRPC<T = any>(method: string, params: any, options?: {
+        timeout?: number;
+    }): Promise<T>;
+    /** Optional: fire-and-forget RPC (no response expected) */
+    namedRPCNoWait?(method: string, params: any): void;
+}
+
+declare class APIClient {
+    private client;
+    constructor(client: CentrifugoClient);
+    /**
+     * Check if client API version is compatible with server.
+     * Call this after connecting to ensure contract compatibility.
+     *
+     * @throws Error if versions are incompatible
+     * @returns WsVersionCheckResult with compatibility info
+     *
+     * @example
+     * const apiClient = new APIClient(client);
+     * const result = await apiClient.checkVersion();
+     * if (!result.compatible) {
+     *   console.error('API version mismatch! Please regenerate client.');
+     * }
+     */
+    checkVersion(): Promise<WsVersionCheckResult>;
+    /**
+     * Get the API contract version of this client.
+     */
+    getVersion(): string;
+    /**
+     * Send input to terminal session (fire-and-forget).
+     */
+    terminalInput(params: WsTerminalInputParams): Promise<WsSuccessResult>;
+    /**
+     * Send input to terminal session (fire-and-forget). (fire-and-forget)
+     */
+    terminalInputNoWait(params: WsTerminalInputParams): void;
+    /**
+     * Resize terminal (fire-and-forget).
+     */
+    terminalResize(params: WsTerminalResizeParams): Promise<WsSuccessResult>;
+    /**
+     * Resize terminal (fire-and-forget). (fire-and-forget)
+     */
+    terminalResizeNoWait(params: WsTerminalResizeParams): void;
+    /**
+     * Send signal to terminal process.
+     */
+    terminalSignal(params: WsTerminalSignalParams): Promise<WsSuccessResult>;
+    /**
+     * Close terminal session.
+     */
+    terminalClose(params: WsTerminalCloseParams): Promise<WsSuccessResult>;
+    /**
+     * Create new terminal session.
+     */
+    terminalCreateSession(params: WsTerminalCreateSessionParams): Promise<WsSessionResult>;
+    /**
+     * Get terminal session info.
+     */
+    terminalGetSession(params: WsGetSessionParams): Promise<WsSessionResult>;
+    /**
+     * List user's terminal sessions.
+     */
+    terminalListSessions(params: WsListSessionsParams): Promise<WsSessionListResult>;
+    /**
+     * Get terminal command history.
+     */
+    terminalHistory(params: WsTerminalHistoryParams): Promise<WsHistoryResult>;
+    /**
+     * List directory contents via gRPC.
+     */
+    fileListDirectory(params: WsListDirectoryParams): Promise<WsListDirectoryResult>;
+    /**
+     * Create a new directory via gRPC.
+     */
+    fileCreateDirectory(params: WsCreateDirectoryParams): Promise<WsCreateDirectoryResult>;
+    /**
+     * Read file contents via gRPC.
+     */
+    fileRead(params: WsReadFileParams): Promise<WsReadFileResult>;
+    /**
+     * Write file contents via gRPC.
+     */
+    fileWrite(params: WsWriteFileParams): Promise<WsWriteFileResult>;
+    /**
+     * Delete a file or directory via gRPC.
+     */
+    fileDelete(params: WsDeleteParams): Promise<WsDeleteResult>;
+    /**
+     * Move or rename a file or directory via gRPC.
+     */
+    fileMove(params: WsMoveParams): Promise<WsMoveResult>;
+    /**
+     * Get file or directory info via gRPC.
+     */
+    fileGetInfo(params: WsGetFileInfoParams): Promise<WsGetFileInfoResult>;
+    /**
+     * Create archive from selected files via gRPC.
+     */
+    fileCreateArchive(params: WsCreateArchiveParams): Promise<WsCreateArchiveResult>;
+    /**
+     * Search files by filename pattern and/or content via gRPC.
+     */
+    fileSearch(params: WsSearchParams): Promise<WsSearchResult>;
+    /**
+     * Get file changes since a sequence number.
+     */
+    fileGetChanges(params: WsGetChangesParams): Promise<WsGetChangesResult>;
+    /**
+     * Initiate a cross-device file transfer via streaming relay.
+     */
+    transferInitiate(params: WsInitiateTransferParams): Promise<WsInitiateTransferResult>;
+    /**
+     * Get status of a cross-device transfer.
+     */
+    transferStatus(params: WsTransferStatusParams): Promise<WsTransferStatusResult>;
+    /**
+     * Cancel a cross-device transfer.
+     */
+    transferCancel(params: WsCancelTransferParams): Promise<WsCancelTransferResult>;
+    /**
+     * List active transfers for a session.
+     */
+    transferList(params: WsListTransfersParams): Promise<WsListTransfersResult>;
+    /**
+     * Validate CSS selectors on current browser page.
+     */
+    browserValidateSelectors(params: WsBrowserValidateSelectorsParams): Promise<WsBrowserValidateSelectorsResult>;
+    /**
+     * Extract structured data from browser page.
+     */
+    browserExtractData(params: WsBrowserExtractDataParams): Promise<WsBrowserExtractDataResult>;
+    /**
+     * Execute JavaScript in browser.
+     */
+    browserExecuteScript(params: WsBrowserExecuteScriptParams): Promise<WsBrowserExecuteScriptResult>;
+    /**
+     * Extract data from page using regex.
+     */
+    browserExtractRegex(params: WsBrowserExtractRegexParams): Promise<WsBrowserExtractRegexResult>;
+    /**
+     * Check if client API version is compatible with server.
+     */
+    systemCheckVersion(params: WsCheckVersionParams): Promise<WsVersionCheckResult>;
+    /**
+     * Authorize access to a channel.
+     */
+    channelAuthorize(params: WsChannelAuthParams): Promise<WsChannelAuthResult>;
+    /**
+     * Send a chat message for AI processing.
+     */
+    aiChatSendMessage(params: WsSendMessageParams): Promise<WsMessageResult>;
+    /**
+     * Get message history for a workspace or session.
+     */
+    aiChatGetHistory(params: WsGetHistoryParams): Promise<WsMessageListResult>;
+    /**
+     * Create a new chat session.
+     */
+    aiChatCreateSession(params: WsChatCreateSessionParams): Promise<WsChatSessionResult>;
+}
+
+interface WsPlanStep {
+    id: string;
+    description: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'error';
+    agent_id?: any;
+    machine_id?: any;
+    result?: any;
+    error?: any;
+}
+interface WsMessageStartEvent {
+    type: 'message_start';
+    message_id: string;
+    client_message_id?: string;
+}
+interface WsMessageChunkEvent {
+    type: 'message_chunk';
+    message_id: string;
+    client_message_id?: string;
+    chunk: string;
+}
+interface WsMessageCompleteEvent {
+    type: 'message_complete';
+    message_id: string;
+    client_message_id?: string;
+    content: string;
+}
+interface WsErrorEvent {
+    type: 'error';
+    message_id: string;
+    client_message_id?: string;
+    error: string;
+}
+interface WsOrchestrationRoutingEvent {
+    type: 'orchestration_routing';
+    message_id: string;
+    client_message_id?: string;
+    intent: string;
+    needs_planning: boolean;
+}
+interface WsOrchestrationPlanEvent {
+    type: 'orchestration_plan';
+    message_id: string;
+    client_message_id?: string;
+    iteration: number;
+    steps: WsPlanStep[];
+}
+interface WsOrchestrationStepStartEvent {
+    type: 'orchestration_step_start';
+    message_id: string;
+    client_message_id?: string;
+    step_id: string;
+}
+interface WsOrchestrationStepCompleteEvent {
+    type: 'orchestration_step_complete';
+    message_id: string;
+    client_message_id?: string;
+    step_id: string;
+    result: string;
+}
+interface WsOrchestrationStepErrorEvent {
+    type: 'orchestration_step_error';
+    message_id: string;
+    client_message_id?: string;
+    step_id: string;
+    error: string;
+}
+interface WsOrchestrationEvaluationEvent {
+    type: 'orchestration_evaluation';
+    message_id: string;
+    client_message_id?: string;
+    goal_achieved: boolean;
+    reasoning: string;
+}
+interface WsOrchestrationCompleteEvent {
+    type: 'orchestration_complete';
+    message_id: string;
+    client_message_id?: string;
+    final_result: string;
+    total_iterations: number;
+}
+/** AI chat streaming events (message chunks, orchestration, errors) */
+type WsAiChatEvent = WsMessageStartEvent | WsMessageChunkEvent | WsMessageCompleteEvent | WsErrorEvent | WsOrchestrationRoutingEvent | WsOrchestrationPlanEvent | WsOrchestrationStepStartEvent | WsOrchestrationStepCompleteEvent | WsOrchestrationStepErrorEvent | WsOrchestrationEvaluationEvent | WsOrchestrationCompleteEvent;
+
 /**
  * useTerminal hook - Real-time terminal connection via WebSocket
  */
@@ -448,6 +1343,391 @@ interface RunAgentOptions {
  */
 declare function useAgent(options: UseAgentOptions): UseAgentResult;
 
+/**
+ * useFiles hook - File operations via WebSocket RPC
+ */
+
+interface UseFilesOptions {
+    /**
+     * Session ID for file operations
+     */
+    sessionId: string;
+}
+interface UseFilesResult {
+    /**
+     * List directory contents
+     */
+    list: (path: string, options?: ListOptions) => Promise<WsListDirectoryResult>;
+    /**
+     * Read file contents
+     */
+    read: (path: string, options?: ReadOptions) => Promise<WsReadFileResult>;
+    /**
+     * Write file contents
+     */
+    write: (path: string, content: string, options?: WriteOptions) => Promise<WsWriteFileResult>;
+    /**
+     * Delete file or directory
+     */
+    remove: (path: string, recursive?: boolean) => Promise<WsDeleteResult>;
+    /**
+     * Move or rename file/directory
+     */
+    move: (sourcePath: string, destPath: string) => Promise<WsMoveResult>;
+    /**
+     * Create directory
+     */
+    mkdir: (path: string, createParents?: boolean) => Promise<WsCreateDirectoryResult>;
+    /**
+     * Search files
+     */
+    search: (path: string, options: SearchOptions) => Promise<WsSearchResult>;
+    /**
+     * Get file/directory info
+     */
+    getInfo: (path: string) => Promise<WsGetFileInfoResult>;
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
+    /**
+     * Last error
+     */
+    error: Error | null;
+    /**
+     * Clear error
+     */
+    clearError: () => void;
+}
+interface ListOptions {
+    pageSize?: number;
+    pageToken?: string;
+    includeHidden?: boolean;
+    sortOrder?: string;
+}
+interface ReadOptions {
+    offset?: number;
+    length?: number;
+}
+interface WriteOptions {
+    overwrite?: boolean;
+    createParents?: boolean;
+}
+interface SearchOptions {
+    filenamePattern?: string;
+    contentPattern?: string;
+    caseSensitive?: boolean;
+    maxResults?: number;
+    maxDepth?: number;
+}
+declare function useFiles({ sessionId }: UseFilesOptions): UseFilesResult;
+
+/**
+ * useSessions hook - Terminal session management via WebSocket RPC
+ */
+
+interface UseSessionsOptions {
+    /**
+     * Auto-fetch sessions on mount
+     * @default true
+     */
+    autoFetch?: boolean;
+    /**
+     * Max sessions to fetch
+     */
+    limit?: number;
+}
+interface UseSessionsResult {
+    /**
+     * List of sessions
+     */
+    sessions: WsSessionResult[];
+    /**
+     * Total session count
+     */
+    total: number;
+    /**
+     * Refresh sessions list
+     */
+    refresh: () => Promise<void>;
+    /**
+     * Create a new session
+     */
+    create: (options?: CreateSessionOptions) => Promise<WsSessionResult>;
+    /**
+     * Get session by ID
+     */
+    get: (sessionId: string) => Promise<WsSessionResult>;
+    /**
+     * Close a session
+     */
+    close: (sessionId: string) => Promise<void>;
+    /**
+     * Loading state
+     */
+    isLoading: boolean;
+    /**
+     * Last error
+     */
+    error: Error | null;
+    /**
+     * Clear error
+     */
+    clearError: () => void;
+}
+interface CreateSessionOptions {
+    name?: string;
+    shell?: string;
+    workingDirectory?: string;
+}
+declare function useSessions(options?: UseSessionsOptions): UseSessionsResult;
+
+/**
+ * Base64 encoding/decoding utilities
+ * Browser-focused implementation using btoa/atob
+ */
+/**
+ * Encode string to base64
+ * Handles Unicode strings correctly
+ */
+declare function encodeBase64(str: string): string;
+/**
+ * Decode base64 to string
+ * Handles Unicode strings correctly
+ */
+declare function decodeBase64(base64: string): string;
+/**
+ * Try to decode base64, return original string on failure
+ */
+declare function tryDecodeBase64(str: string): string;
+/**
+ * Encode binary data (Uint8Array) to base64
+ */
+declare function encodeBase64Bytes(data: Uint8Array): string;
+/**
+ * Decode base64 to binary data (Uint8Array)
+ */
+declare function decodeBase64Bytes(base64: string): Uint8Array;
+
+/**
+ * Error mapping utilities
+ * Maps WebSocket/RPC errors to @cmdop/core error types
+ */
+/**
+ * Map an RPC error to appropriate CMDOP error type
+ */
+declare function mapRPCError(error: unknown): Error;
+/**
+ * Create error from RPC result with success=false
+ */
+declare function createErrorFromResult(result: {
+    success: false;
+    error?: string;
+    error_code?: string;
+}): Error;
+/**
+ * Check if error is a connection error that should trigger reconnect
+ */
+declare function isRetryableError(error: unknown): boolean;
+
+/**
+ * Class name utility
+ * Simple utility for conditional class name merging
+ */
+type ClassValue = string | undefined | null | false | 0;
+/**
+ * Merge class names, filtering out falsy values
+ */
+declare function cn(...classes: ClassValue[]): string;
+
+/**
+ * Chat Component Types
+ */
+
+interface BaseMessage {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    isStreaming?: boolean;
+}
+interface ChatInputProps {
+    onSend: (content: string) => void;
+    disabled?: boolean;
+    isLoading?: boolean;
+    placeholder?: string;
+    className?: string;
+    inputClassName?: string;
+    buttonClassName?: string;
+}
+interface ChatMessagesProps<T extends BaseMessage> {
+    messages: T[];
+    renderMessage: (message: T) => ReactNode;
+    onLoadMore?: () => void;
+    isLoadingHistory?: boolean;
+    hasMoreHistory?: boolean;
+    isStreaming?: boolean;
+    emptyState?: ReactNode;
+    className?: string;
+    loadingIndicator?: ReactNode;
+    typingIndicator?: ReactNode;
+}
+interface MessageBubbleProps {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp?: Date;
+    isStreaming?: boolean;
+    children?: ReactNode;
+    className?: string;
+    /** Render custom content instead of default text */
+    renderContent?: (content: string, isUser: boolean) => ReactNode;
+}
+interface TypingIndicatorProps {
+    text?: string;
+    className?: string;
+}
+interface UseMessageOperationsResult<T extends BaseMessage> {
+    messages: T[];
+    setMessages: Dispatch<SetStateAction<T[]>>;
+    addMessage: (message: T) => void;
+    updateMessage: (id: string, updates: Partial<T>) => void;
+    appendContent: (id: string, chunk: string) => void;
+    removeMessage: (id: string) => void;
+    clearMessages: () => void;
+}
+interface MachineMessage extends BaseMessage {
+    /** Command executions attached to this message */
+    executions?: CommandExecution[];
+}
+interface CommandExecution {
+    id: string;
+    command: string;
+    status: 'pending' | 'running' | 'completed' | 'error';
+    output: string;
+    exitCode?: number;
+    startedAt?: Date;
+    completedAt?: Date;
+}
+/** Centrifugo RPC client interface (compatible with @djangocfg/centrifugo CentrifugoRPCClient) */
+interface CentrifugoClientInterface {
+    /** Make typed RPC call (namedRPC from @djangocfg/centrifugo) */
+    namedRPC<T = unknown>(method: string, params: unknown, options?: {
+        timeout?: number;
+    }): Promise<T>;
+}
+interface MachineChatProps {
+    /** Workspace ID */
+    workspaceId: string;
+    /** Machine ID */
+    machineId: string;
+    /** Machine name for display */
+    machineName?: string;
+    /** External Centrifugo client for RPC calls (from @djangocfg/centrifugo) */
+    centrifugoClient?: CentrifugoClientInterface;
+    /**
+     * Subscription data from external useSubscription hook.
+     * Pass data from: useSubscription({ channel: `ai_chat:workspace:${workspaceId}` })
+     */
+    subscriptionData?: MachineCentrifugoMessage | null;
+    /** Additional CSS classes */
+    className?: string;
+    /** Custom header renderer */
+    renderHeader?: (machineName?: string) => ReactNode;
+    /** Custom empty state renderer */
+    renderEmptyState?: () => ReactNode;
+}
+interface CommandOutputProps {
+    execution: CommandExecution;
+    className?: string;
+}
+interface CentrifugoMessageBase {
+    message_id: string;
+    client_message_id?: string;
+}
+type MachineCommandEvent = (CentrifugoMessageBase & {
+    type: 'command_generated';
+    executions: CommandExecution[];
+}) | (CentrifugoMessageBase & {
+    type: 'execution_started';
+    execution_id: string;
+    command: string;
+}) | (CentrifugoMessageBase & {
+    type: 'output_chunk';
+    execution_id: string;
+    chunk: string;
+}) | (CentrifugoMessageBase & {
+    type: 'execution_completed';
+    execution_id: string;
+    exit_code: number;
+});
+type MachineCentrifugoMessage = WsAiChatEvent | MachineCommandEvent;
+interface UseMachineChatOptions {
+    workspaceId: string;
+    machineId: string;
+    /** External Centrifugo client for RPC calls (from @djangocfg/centrifugo) */
+    centrifugoClient?: CentrifugoClientInterface;
+    /**
+     * Subscription data from external useSubscription hook.
+     * Pass data from: useSubscription({ channel: `ai_chat:workspace:${workspaceId}` })
+     */
+    subscriptionData?: MachineCentrifugoMessage | null;
+}
+interface UseMachineChatResult {
+    messages: MachineMessage[];
+    isLoadingHistory: boolean;
+    hasMoreHistory: boolean;
+    isExecuting: boolean;
+    isStreaming: boolean;
+    error: string | null;
+    sendMessage: (content: string) => Promise<void>;
+    loadMoreMessages: () => void;
+    clearMessages: () => void;
+    clearError: () => void;
+}
+
+declare function ChatInput({ onSend, disabled, isLoading, placeholder, className, inputClassName, buttonClassName, }: ChatInputProps): react_jsx_runtime.JSX.Element;
+
+declare function ChatMessages<T extends BaseMessage>({ messages, renderMessage, onLoadMore, isLoadingHistory, hasMoreHistory, isStreaming, emptyState, className, loadingIndicator, typingIndicator, }: ChatMessagesProps<T>): react_jsx_runtime.JSX.Element;
+
+declare function MessageBubble({ role, content, timestamp, isStreaming, children, className, renderContent, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
+
+declare function TypingIndicator({ text, className }: TypingIndicatorProps): react_jsx_runtime.JSX.Element;
+
+declare function CommandOutput({ execution, className }: CommandOutputProps): react_jsx_runtime.JSX.Element;
+
+declare function MachineChat({ workspaceId, machineId, machineName, centrifugoClient, subscriptionData, className, renderHeader, renderEmptyState, }: MachineChatProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Message Operations Hook
+ *
+ * Generic hook for managing chat messages
+ */
+
+declare function useMessageOperations<T extends BaseMessage>(): UseMessageOperationsResult<T>;
+
+/**
+ * Machine Chat Hook
+ *
+ * Manages chat state for single machine context.
+ * Uses external Centrifugo client for RPC and receives subscription data as prop.
+ *
+ * @example
+ * ```tsx
+ * // In apps/web with @djangocfg/centrifugo
+ * const { client } = useCentrifugo();
+ * const { data } = useSubscription({ channel: `ai_chat:workspace:${workspaceId}` });
+ *
+ * const chat = useMachineChat({
+ *   workspaceId,
+ *   machineId,
+ *   centrifugoClient: client,
+ *   subscriptionData: data,
+ * });
+ * ```
+ */
+
+declare function useMachineChat({ workspaceId, machineId, centrifugoClient, subscriptionData, }: UseMachineChatOptions): UseMachineChatResult;
+
 interface CMDOPContextValue {
     config: CMDOPConfig;
     isAuthenticated: boolean;
@@ -535,4 +1815,4 @@ interface UseWorkspaceResult {
 }
 declare function useWorkspace(workspaceId: string | undefined, options?: SWRConfiguration): UseWorkspaceResult;
 
-export { type AgentDoneEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentTokenEvent, type AgentToolCallEvent, type AgentToolResultEvent, CMDOPProvider, type CMDOPProviderProps, CMDOPWebSocketClient, type CMDOPWebSocketConfig, type ConnectionState, type Machine, type RunAgentOptions, type TerminalOutput, type TerminalStatus, type UseAgentOptions, type UseAgentResult, type UseMachineResult, type UseMachinesOptions, type UseMachinesResult, type UseRPCOptions, type UseRPCResult, type UseSubscriptionOptions, type UseSubscriptionResult, type UseTerminalOptions, type UseTerminalResult, type UseWorkspaceResult, type UseWorkspacesResult, WebSocketProvider, type WebSocketProviderProps, type Workspace, useAgent, useCMDOP, useMachine, useMachines, useRPC, useSubscription, useTerminal, useWebSocket, useWorkspace, useWorkspaces };
+export { APIClient, API_VERSION, type AgentDoneEvent, type AgentErrorEvent, type AgentEvent, type AgentEventType, type AgentTokenEvent, type AgentToolCallEvent, type AgentToolResultEvent, type BaseMessage, CMDOPProvider, type CMDOPProviderProps, CMDOPWebSocketClient, type CMDOPWebSocketConfig, ChatInput, type ChatInputProps, ChatMessages, type ChatMessagesProps, type CommandExecution, CommandOutput, type CommandOutputProps, type ConnectionState, type CreateSessionOptions, GENERATED_AT, type ListOptions, type Machine, type MachineCentrifugoMessage, MachineChat, type MachineChatProps, type MachineMessage, MessageBubble, type MessageBubbleProps, type ReadOptions, type RunAgentOptions, type SearchOptions, type TerminalOutput, type TerminalStatus, TypingIndicator, type TypingIndicatorProps, type UseAgentOptions, type UseAgentResult, type UseFilesOptions, type UseFilesResult, type UseMachineChatOptions, type UseMachineChatResult, type UseMachineResult, type UseMachinesOptions, type UseMachinesResult, type UseMessageOperationsResult, type UseRPCOptions, type UseRPCResult, type UseSessionsOptions, type UseSessionsResult, type UseSubscriptionOptions, type UseSubscriptionResult, type UseTerminalOptions, type UseTerminalResult, type UseWorkspaceResult, type UseWorkspacesResult, WebSocketProvider, type WebSocketProviderProps, type Workspace, type WriteOptions, type WsBrowserExecuteScriptParams, type WsBrowserExecuteScriptResult, type WsBrowserExtractDataParams, type WsBrowserExtractDataResult, type WsBrowserExtractRegexParams, type WsBrowserExtractRegexResult, type WsBrowserValidateSelectorsParams, type WsBrowserValidateSelectorsResult, type WsCancelTransferParams, type WsCancelTransferResult, type WsChannelAuthParams, type WsChannelAuthResult, type WsChatCreateSessionParams, type WsChatSessionResult, type WsCheckVersionParams, type WsContentMatch, type WsCreateArchiveParams, type WsCreateArchiveResult, type WsCreateDirectoryParams, type WsCreateDirectoryResult, type WsDeleteParams, type WsDeleteResult, type WsFileChange, WsFileChangeType, type WsFileEntry, WsFileIconType, type WsGetChangesParams, type WsGetChangesResult, type WsGetFileInfoParams, type WsGetFileInfoResult, type WsGetHistoryParams, type WsGetSessionParams, type WsHistoryResult, type WsInitiateTransferParams, type WsInitiateTransferResult, type WsListDirectoryParams, type WsListDirectoryResult, type WsListSessionsParams, type WsListTransfersParams, type WsListTransfersResult, WsLoadMethod, type WsMediaMetadata, type WsMessageItem, type WsMessageListResult, type WsMessageResult, type WsMoveParams, type WsMoveResult, type WsReadFileParams, type WsReadFileResult, type WsSearchMatch, WsSearchMatchType, type WsSearchParams, type WsSearchResult, type WsSendMessageParams, type WsSessionListResult, type WsSessionResult, type WsSuccessResult, type WsTerminalCloseParams, type WsTerminalCreateSessionParams, type WsTerminalHistoryParams, type WsTerminalInputParams, type WsTerminalResizeParams, type WsTerminalSignalParams, type WsTransferInfo, type WsTransferStatusParams, type WsTransferStatusResult, type WsVersionCheckResult, WsViewerType, type WsWriteFileParams, type WsWriteFileResult, cn, createErrorFromResult, decodeBase64, decodeBase64Bytes, encodeBase64, encodeBase64Bytes, isRetryableError, mapRPCError, tryDecodeBase64, useAgent, useCMDOP, useFiles, useMachine, useMachineChat, useMachines, useMessageOperations, useRPC, useSessions, useSubscription, useTerminal, useWebSocket, useWorkspace, useWorkspaces };