@codebolt/codeboltjs 2.2.1 → 2.2.3

package/dist/types/libFunctionTypes.d.ts

@@ -7,6 +7,42 @@
  * - Configuration options for library functions
  * - User-facing data structures
  */
+/**
+ * Content block within a message
+ */
+export interface MessageContentBlock {
+    /** Type of content block */
+    type: 'text' | 'image' | 'file' | 'code' | 'error' | 'tool_result';
+    /** Text content for text blocks */
+    text?: string;
+    /** Image URL for image blocks */
+    image_url?: string;
+    /** File information for file blocks */
+    file?: {
+        name: string;
+        path: string;
+        size?: number;
+        type?: string;
+    };
+    /** Code information for code blocks */
+    code?: {
+        language: string;
+        code: string;
+        filename?: string;
+    };
+    /** Error information for error blocks */
+    error?: {
+        message: string;
+        code?: string;
+        details?: Record<string, unknown>;
+    };
+    /** Tool result for tool_result blocks */
+    tool_result?: {
+        tool_name: string;
+        result: unknown;
+        success: boolean;
+    };
+}
 /**
  * Represents a message in the conversation with roles and content.
  */
@@ -14,13 +50,13 @@ export interface Message {
     /** The role of the message sender: user, assistant, tool, or system */
     role: 'user' | 'assistant' | 'tool' | 'system';
     /** The content of the message, can be an array of content blocks or a string */
-    content: any[] | string;
+    content: MessageContentBlock[] | string;
     /** Optional ID for tool calls */
     tool_call_id?: string;
     /** Optional tool calls for assistant messages */
     tool_calls?: ToolCall[];
     /** Additional properties that might be present */
-    [key: string]: any;
+    [key: string]: unknown;
 }
 /**
  * Represents a tool call in OpenAI format
@@ -38,6 +74,33 @@ export interface ToolCall {
         arguments: string;
     };
 }
+/**
+ * JSON Schema for tool parameters
+ */
+export interface JSONSchema {
+    /** Schema type */
+    type: 'object' | 'array' | 'string' | 'number' | 'boolean' | 'integer';
+    /** Schema description */
+    description?: string;
+    /** Required properties for objects */
+    required?: string[];
+    /** Properties for objects */
+    properties?: Record<string, JSONSchema>;
+    /** Items for arrays */
+    items?: JSONSchema;
+    /** Enum values */
+    enum?: unknown[];
+    /** Minimum value for numbers */
+    minimum?: number;
+    /** Maximum value for numbers */
+    maximum?: number;
+    /** Pattern for strings */
+    pattern?: string;
+    /** Format for strings */
+    format?: string;
+    /** Additional properties allowed */
+    additionalProperties?: boolean | JSONSchema;
+}
 /**
  * Represents a tool definition in OpenAI format
  */
@@ -51,7 +114,7 @@ export interface Tool {
         /** Description of what the function does */
         description?: string;
         /** JSON schema for the function parameters */
-        parameters?: any;
+        parameters?: JSONSchema;
     };
 }
 /**
@@ -131,7 +194,7 @@ export interface ConversationEntry {
         text: string;
     }>;
     tool_call_id?: string;
-    tool_calls?: any[];
+    tool_calls?: ToolCall[];
 }
 /**
  * Result from a tool execution
@@ -142,9 +205,9 @@ export interface ToolResult {
     /** ID that links this result to the original tool call */
     tool_call_id: string;
     /** The content returned by the tool */
-    content: any;
+    content: string | Record<string, unknown>;
     /** Optional user message to be added after tool execution */
-    userMessage?: any;
+    userMessage?: string | Record<string, unknown>;
 }
 /**
  * Details about a tool to be executed
@@ -153,7 +216,7 @@ export interface ToolDetails {
     /** The name of the tool to execute */
     toolName: string;
     /** Input parameters for the tool */
-    toolInput: any;
+    toolInput: Record<string, unknown>;
     /** Unique ID for this tool use instance */
     toolUseId: string;
 }
@@ -196,9 +259,13 @@ export interface UserMessage {
     /** Thread identifier */
     threadId: string;
     /** Any text selection in the editor */
-    selection?: any;
+    selection?: {
+        start: number;
+        end: number;
+        text: string;
+    };
     remixPrompt?: string;
-    mentionedAgents?: [];
+    mentionedAgents?: string[];
 }
 /**
  * Interface for codebolt API functionality
@@ -208,11 +275,11 @@ export interface CodeboltAPI {
         listMcpFromServers: (servers: string[]) => Promise<{
             data: OpenAITool[];
         }>;
-        getTools: (mcps: any[]) => Promise<{
+        getTools: (mcps: string[]) => Promise<{
             data: OpenAITool[];
         }>;
-        executeTool: (toolboxName: string, actualToolName: string, toolInput: any) => Promise<{
-            data: any;
+        executeTool: (toolboxName: string, actualToolName: string, toolInput: Record<string, unknown>) => Promise<{
+            data: string | Record<string, unknown>;
         }>;
     };
     fs: {
@@ -228,7 +295,7 @@ export interface CodeboltAPI {
         }>;
     };
     chat: {
-        sendMessage: (message: string, metadata: any) => Promise<void>;
+        sendMessage: (message: string, metadata: Record<string, unknown>) => Promise<void>;
     };
 }
 export interface ReadFileOptions {
@@ -277,6 +344,397 @@ export interface GrepSearchOptions {
     /** Whether search is case sensitive */
     caseSensitive?: boolean;
 }
+/**
+ * File information structure
+ */
+export interface FileInfo {
+    /** File or directory name */
+    name: string;
+    /** Full path to the file or directory */
+    path: string;
+    /** Whether this is a directory */
+    isDirectory: boolean;
+    /** File size in bytes */
+    size?: number;
+    /** Last modified timestamp */
+    modified?: string;
+    /** Creation timestamp */
+    created?: string;
+    /** File permissions */
+    permissions?: string;
+    /** File extension */
+    extension?: string;
+}
+/**
+ * Search match information
+ */
+export interface SearchMatch {
+    /** Line number where match was found */
+    line: number;
+    /** Content of the line */
+    content: string;
+    /** Line number (alias for line) */
+    lineNumber: number;
+    /** Column where match starts */
+    column?: number;
+    /** Length of the match */
+    matchLength?: number;
+}
+/**
+ * File search result
+ */
+export interface FileSearchResult {
+    /** Path to the file */
+    path: string;
+    /** Matches found in the file */
+    matches: SearchMatch[];
+    /** Relevance score for fuzzy search */
+    score?: number;
+}
+/**
+ * Grep search result
+ */
+export interface GrepSearchResult {
+    /** Path to the file */
+    file: string;
+    /** Line number where match was found */
+    line: number;
+    /** Content of the line */
+    content: string;
+    /** The actual match text */
+    match: string;
+    /** Column where match starts */
+    column?: number;
+    /** Context lines before and after */
+    context?: {
+        before: string[];
+        after: string[];
+    };
+}
+/**
+ * Code definition information
+ */
+export interface CodeDefinition {
+    /** Name of the definition */
+    name: string;
+    /** Type of definition (function, class, variable, etc.) */
+    type: string;
+    /** File path where definition is located */
+    file: string;
+    /** Line number where definition starts */
+    line: number;
+    /** Column where definition starts */
+    column?: number;
+    /** Scope of the definition */
+    scope?: string;
+    /** Documentation comment if available */
+    documentation?: string;
+}
+/**
+ * Diff result information
+ */
+export interface DiffResult {
+    /** Status of the diff operation */
+    status: 'success' | 'error' | 'review_started' | 'rejected';
+    /** File that was modified */
+    file: string;
+    /** Result message */
+    message: string;
+    /** Diff content if available */
+    diff?: string;
+    /** Applied changes summary */
+    changes?: {
+        added: number;
+        removed: number;
+        modified: number;
+    };
+}
+/**
+ * Base response interface for all FS operations
+ */
+export interface BaseFSResponse {
+    /** Response type identifier */
+    type: string;
+    /** Unique request identifier */
+    requestId: string;
+    /** Whether the operation was successful */
+    success?: boolean;
+    /** Response message */
+    message?: string;
+    /** Response data - specific to each operation type */
+    data?: FileInfo[] | FileSearchResult[] | GrepSearchResult[] | CodeDefinition[] | DiffResult | string | number | boolean | Record<string, unknown>;
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Create file response types
+ */
+export interface CreateFileSuccessResponse extends BaseFSResponse {
+    type: 'createFileResponse';
+    success: true;
+}
+export interface CreateFileErrorResponse extends BaseFSResponse {
+    type: 'createFileResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Create folder response types
+ */
+export interface CreateFolderSuccessResponse extends BaseFSResponse {
+    type: 'createFolderResponse';
+    success: true;
+}
+export interface CreateFolderErrorResponse extends BaseFSResponse {
+    type: 'createFolderResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Read file response types
+ */
+export interface ReadFileSuccessResponse extends BaseFSResponse {
+    type: 'readFileResponse';
+    success: true;
+    /** File content */
+    content?: string;
+}
+export interface ReadFileErrorResponse extends BaseFSResponse {
+    type: 'readFileResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Update file response types
+ */
+export interface UpdateFileSuccessResponse extends BaseFSResponse {
+    type: 'updateFileResponse';
+    success: true;
+}
+export interface UpdateFileErrorResponse extends BaseFSResponse {
+    type: 'updateFileResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Delete file response types
+ */
+export interface DeleteFileSuccessResponse extends BaseFSResponse {
+    type: 'deleteFileResponse';
+    success: true;
+}
+export interface DeleteFileErrorResponse extends BaseFSResponse {
+    type: 'deleteFileResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Delete folder response types
+ */
+export interface DeleteFolderSuccessResponse extends BaseFSResponse {
+    type: 'deleteFolderResponse';
+    success: true;
+}
+export interface DeleteFolderErrorResponse extends BaseFSResponse {
+    type: 'deleteFolderResponse';
+    success: false;
+    error: string;
+}
+/**
+ * File list response types
+ */
+export interface FileListSuccessResponse extends BaseFSResponse {
+    type: 'fileListResponse';
+    success: true;
+    /** Array of file information */
+    files?: FileInfo[];
+}
+export interface FileListErrorResponse extends BaseFSResponse {
+    type: 'fileListResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Search files response types
+ */
+export interface SearchFilesSuccessResponse extends BaseFSResponse {
+    type: 'searchFilesResponse';
+    success: true;
+    /** Search results */
+    files?: FileSearchResult[];
+}
+export interface SearchFilesErrorResponse extends BaseFSResponse {
+    type: 'searchFilesResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Write to file response types
+ */
+export interface WriteToFileSuccessResponse extends BaseFSResponse {
+    type: 'writeToFileResponse';
+    success: true;
+}
+export interface WriteToFileErrorResponse extends BaseFSResponse {
+    type: 'writeToFileResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Grep search response types
+ */
+export interface GrepSearchSuccessResponse extends BaseFSResponse {
+    type: 'grepSearchResponse';
+    success: true;
+    /** Search results */
+    results?: GrepSearchResult[];
+}
+export interface GrepSearchErrorResponse extends BaseFSResponse {
+    type: 'grepSearchResponse';
+    success: false;
+    error: string;
+}
+/**
+ * File search response types
+ */
+export interface FileSearchSuccessResponse extends BaseFSResponse {
+    type: 'fileSearchResponse';
+    success: true;
+    /** Array of matching file paths */
+    files?: string[];
+}
+export interface FileSearchErrorResponse extends BaseFSResponse {
+    type: 'fileSearchResponse';
+    success: false;
+    error: string;
+}
+/**
+ * List code definition names response types
+ */
+export interface ListCodeDefinitionNamesSuccessResponse extends BaseFSResponse {
+    type: 'listCodeDefinitionNamesResponse';
+    success: true;
+    /** Array of code definition names */
+    definitions?: string[];
+    /** Detailed code definition information */
+    codeDefinitions?: CodeDefinition[];
+}
+export interface ListCodeDefinitionNamesErrorResponse extends BaseFSResponse {
+    type: 'listCodeDefinitionNamesResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Edit file with diff response types
+ */
+export interface EditFileAndApplyDiffSuccessResponse extends BaseFSResponse {
+    type: 'editFileAndApplyDiffResponse';
+    success: true;
+    /** Diff result information */
+    data?: DiffResult;
+}
+export interface EditFileAndApplyDiffErrorResponse extends BaseFSResponse {
+    type: 'editFileAndApplyDiffResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Union type for all FS responses
+ */
+export type FSResponse = CreateFileSuccessResponse | CreateFileErrorResponse | CreateFolderSuccessResponse | CreateFolderErrorResponse | ReadFileSuccessResponse | ReadFileErrorResponse | UpdateFileSuccessResponse | UpdateFileErrorResponse | DeleteFileSuccessResponse | DeleteFileErrorResponse | DeleteFolderSuccessResponse | DeleteFolderErrorResponse | FileListSuccessResponse | FileListErrorResponse | SearchFilesSuccessResponse | SearchFilesErrorResponse | WriteToFileSuccessResponse | WriteToFileErrorResponse | GrepSearchSuccessResponse | GrepSearchErrorResponse | FileSearchSuccessResponse | FileSearchErrorResponse | ListCodeDefinitionNamesSuccessResponse | ListCodeDefinitionNamesErrorResponse | EditFileAndApplyDiffSuccessResponse | EditFileAndApplyDiffErrorResponse;
+/**
+ * File system operation parameters
+ */
+export interface CreateFileParams {
+    /** File name to create */
+    fileName: string;
+    /** Source content for the file */
+    source: string;
+    /** Path where to create the file */
+    filePath: string;
+}
+export interface CreateFolderParams {
+    /** Folder name to create */
+    folderName: string;
+    /** Path where to create the folder */
+    folderPath: string;
+}
+export interface ReadFileParams {
+    /** Path of the file to read */
+    filePath: string;
+}
+export interface UpdateFileParams {
+    /** Name of the file to update */
+    filename: string;
+    /** Path of the file to update */
+    filePath: string;
+    /** New content for the file */
+    newContent: string;
+}
+export interface DeleteFileParams {
+    /** Name of the file to delete */
+    filename: string;
+    /** Path of the file to delete */
+    filePath: string;
+}
+export interface DeleteFolderParams {
+    /** Name of the folder to delete */
+    foldername: string;
+    /** Path of the folder to delete */
+    folderpath: string;
+}
+export interface ListFileParams {
+    /** Path to list files from */
+    folderPath: string;
+    /** Whether to list files recursively */
+    isRecursive?: boolean;
+}
+export interface ListCodeDefinitionNamesParams {
+    /** Path to search for code definitions */
+    path: string;
+}
+export interface SearchFilesParams {
+    /** Path to search within */
+    path: string;
+    /** Regex pattern to search for */
+    regex: string;
+    /** File pattern to match files */
+    filePattern: string;
+}
+export interface WriteToFileParams {
+    /** Relative path of the file to write to */
+    relPath: string;
+    /** New content to write into the file */
+    newContent: string;
+}
+export interface GrepSearchParams {
+    /** Path to search within */
+    path: string;
+    /** Query to search for */
+    query: string;
+    /** Pattern of files to include */
+    includePattern?: string;
+    /** Pattern of files to exclude */
+    excludePattern?: string;
+    /** Whether the search is case sensitive */
+    caseSensitive?: boolean;
+}
+export interface FileSearchParams {
+    /** Query to search for */
+    query: string;
+}
+export interface EditFileWithDiffParams {
+    /** Target file to edit */
+    target_file: string;
+    /** Code edit to apply */
+    code_edit: string;
+    /** Diff identifier */
+    diffIdentifier: string;
+    /** Prompt for the edit */
+    prompt: string;
+    /** Model to apply the edit with */
+    applyModel?: string;
+}
 export interface BrowserNavigationOptions {
     /** URL to navigate to */
     url: string;
@@ -313,17 +771,410 @@ export interface TerminalExecuteOptions {
     /** Whether to run in background */
     background?: boolean;
 }
-export interface GitCommitOptions {
+/**
+ * Git file status information
+ */
+export interface GitFileStatus {
+    /** File path */
+    path: string;
+    /** Index status (staged changes) */
+    index: string;
+    /** Working directory status (unstaged changes) */
+    working_dir: string;
+}
+/**
+ * Git repository status information
+ */
+export interface GitStatusResult {
+    /** Files not added to git */
+    not_added: string[];
+    /** Files with conflicts */
+    conflicted: string[];
+    /** Newly created files */
+    created: string[];
+    /** Deleted files */
+    deleted: string[];
+    /** Modified files */
+    modified: string[];
+    /** Renamed files */
+    renamed: string[];
+    /** Detailed file status information */
+    files: GitFileStatus[];
+    /** Staged files */
+    staged: string[];
+    /** Number of commits ahead of remote */
+    ahead: number;
+    /** Number of commits behind remote */
+    behind: number;
+    /** Current branch name */
+    current: string | null;
+    /** Tracking branch name */
+    tracking: string | null;
+    /** Whether in detached HEAD state */
+    detached: boolean;
+}
+/**
+ * Git commit information
+ */
+export interface GitCommitSummary {
+    /** Commit hash */
+    hash: string;
+    /** Commit date */
+    date: string;
     /** Commit message */
     message: string;
+    /** Git references (branches, tags) */
+    refs: string;
+    /** Full commit body */
+    body: string;
     /** Author name */
-    author?: string;
+    author_name: string;
     /** Author email */
+    author_email: string;
+}
+/**
+ * Git diff file information
+ */
+export interface GitDiffFile {
+    /** File path */
+    file: string;
+    /** Number of changes */
+    changes: number;
+    /** Number of insertions */
+    insertions: number;
+    /** Number of deletions */
+    deletions: number;
+    /** Whether file is binary */
+    binary: boolean;
+}
+/**
+ * Git diff result information
+ */
+export interface GitDiffResult {
+    /** Files with changes */
+    files: GitDiffFile[];
+    /** Total insertions */
+    insertions: number;
+    /** Total deletions */
+    deletions: number;
+    /** Total changed files */
+    changed: number;
+}
+/**
+ * Git pull result information
+ */
+export interface GitPullResult {
+    /** Number of files updated */
+    files: number;
+    /** Number of insertions */
+    insertions: number;
+    /** Number of deletions */
+    deletions: number;
+    /** Summary message */
+    summary: string;
+    /** Remote branch information */
+    remote?: {
+        name: string;
+        url: string;
+    };
+}
+/**
+ * Git push result information
+ */
+export interface GitPushResult {
+    /** Number of commits pushed */
+    commits: number;
+    /** Summary message */
+    summary: string;
+    /** Remote branch information */
+    remote?: {
+        name: string;
+        url: string;
+    };
+}
+/**
+ * Git commit result information
+ */
+export interface GitCommitResult {
+    /** Commit hash */
+    hash: string;
+    /** Commit message */
+    message: string;
+    /** Number of files committed */
+    files: number;
+    /** Number of insertions */
+    insertions: number;
+    /** Number of deletions */
+    deletions: number;
+    /** Author information */
+    author: {
+        name: string;
+        email: string;
+    };
+}
+/**
+ * Git branch information
+ */
+export interface GitBranchInfo {
+    /** Branch name */
+    name: string;
+    /** Whether this is the current branch */
+    current: boolean;
+    /** Commit hash at branch tip */
+    commit: string;
+    /** Last commit message */
+    message: string;
+    /** Whether branch is remote */
+    remote: boolean;
+}
+/**
+ * Git checkout result information
+ */
+export interface GitCheckoutResult {
+    /** Branch or commit checked out */
+    target: string;
+    /** Previous branch or commit */
+    previous?: string;
+    /** Whether checkout was successful */
+    success: boolean;
+    /** Additional information */
+    message?: string;
+}
+/**
+ * Git add result information
+ */
+export interface GitAddResult {
+    /** Number of files added */
+    files: number;
+    /** List of added files */
+    added: string[];
+    /** Summary message */
+    summary: string;
+}
+/**
+ * Git init result information
+ */
+export interface GitInitResult {
+    /** Repository path */
+    path: string;
+    /** Whether repository was created */
+    created: boolean;
+    /** Initial branch name */
+    branch: string;
+    /** Summary message */
+    message: string;
+}
+/**
+ * Base response interface for all Git operations
+ */
+export interface BaseGitResponse {
+    /** Response type identifier */
+    type: string;
+    /** Unique request identifier */
+    requestId: string;
+    /** Whether the operation was successful */
+    success?: boolean;
+    /** Response message */
+    message?: string;
+    /** Response data - specific to each operation type */
+    data?: GitInitResult | GitPullResult | GitPushResult | GitStatusResult | GitAddResult | GitCommitResult | GitCheckoutResult | GitBranchInfo[] | GitCommitSummary[] | GitDiffResult | string | number | boolean | Record<string, unknown>;
+    /** Error message if operation failed */
+    error?: string;
+}
+/**
+ * Git init response types
+ */
+export interface GitInitSuccessResponse extends BaseGitResponse {
+    type: 'gitInitResponse';
+    success: true;
+    /** Git init result data */
+    data?: GitInitResult;
+}
+export interface GitInitErrorResponse extends BaseGitResponse {
+    type: 'gitInitResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git pull response types
+ */
+export interface GitPullSuccessResponse extends BaseGitResponse {
+    type: 'PullResponse';
+    success: true;
+    /** Git pull result data */
+    data?: GitPullResult;
+}
+export interface GitPullErrorResponse extends BaseGitResponse {
+    type: 'PullResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git push response types
+ */
+export interface GitPushSuccessResponse extends BaseGitResponse {
+    type: 'PushResponse';
+    success: true;
+    /** Git push result data */
+    data?: GitPushResult;
+}
+export interface GitPushErrorResponse extends BaseGitResponse {
+    type: 'PushResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git status response types
+ */
+export interface GitStatusSuccessResponse extends BaseGitResponse {
+    type: 'gitStatusResponse';
+    success: true;
+    /** Git status result data */
+    data?: GitStatusResult;
+}
+export interface GitStatusErrorResponse extends BaseGitResponse {
+    type: 'gitStatusResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git add response types
+ */
+export interface GitAddSuccessResponse extends BaseGitResponse {
+    type: 'AddResponse';
+    success: true;
+    /** Git add result data */
+    data?: GitAddResult;
+}
+export interface GitAddErrorResponse extends BaseGitResponse {
+    type: 'AddResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git commit response types
+ */
+export interface GitCommitSuccessResponse extends BaseGitResponse {
+    type: 'gitCommitResponse';
+    success: true;
+    /** Git commit result data */
+    data?: GitCommitResult;
+}
+export interface GitCommitErrorResponse extends BaseGitResponse {
+    type: 'gitCommitResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git checkout response types
+ */
+export interface GitCheckoutSuccessResponse extends BaseGitResponse {
+    type: 'gitCheckoutResponse';
+    success: true;
+    /** Git checkout result data */
+    data?: GitCheckoutResult;
+}
+export interface GitCheckoutErrorResponse extends BaseGitResponse {
+    type: 'gitCheckoutResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git branch response types
+ */
+export interface GitBranchSuccessResponse extends BaseGitResponse {
+    type: 'gitBranchResponse';
+    success: true;
+    /** Array of branch names */
+    branches?: string[];
+    /** Detailed branch information */
+    data?: GitBranchInfo[];
+}
+export interface GitBranchErrorResponse extends BaseGitResponse {
+    type: 'gitBranchResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git logs response types
+ */
+export interface GitLogsSuccessResponse extends BaseGitResponse {
+    type: 'gitLogsResponse';
+    success: true;
+    /** Array of commit summaries */
+    logs?: GitCommitSummary[];
+    /** Detailed commit information */
+    data?: GitCommitSummary[];
+}
+export interface GitLogsErrorResponse extends BaseGitResponse {
+    type: 'gitLogsResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Git diff response types
+ */
+export interface GitDiffSuccessResponse extends BaseGitResponse {
+    type: 'gitDiffResponse';
+    success: true;
+    /** Diff content as string */
+    diff?: string;
+    /** Structured diff result */
+    data?: GitDiffResult;
+}
+export interface GitDiffErrorResponse extends BaseGitResponse {
+    type: 'gitDiffResponse';
+    success: false;
+    error: string;
+}
+/**
+ * Union type for all Git responses
+ */
+export type GitResponse = GitInitSuccessResponse | GitInitErrorResponse | GitPullSuccessResponse | GitPullErrorResponse | GitPushSuccessResponse | GitPushErrorResponse | GitStatusSuccessResponse | GitStatusErrorResponse | GitAddSuccessResponse | GitAddErrorResponse | GitCommitSuccessResponse | GitCommitErrorResponse | GitCheckoutSuccessResponse | GitCheckoutErrorResponse | GitBranchSuccessResponse | GitBranchErrorResponse | GitLogsSuccessResponse | GitLogsErrorResponse | GitDiffSuccessResponse | GitDiffErrorResponse;
+/**
+ * Git operation parameters
+ */
+export interface GitInitParams {
+    /** Path where to initialize the repository */
+    path: string;
+}
+export interface GitPullParams {
+    /** Remote name (optional) */
+    remote?: string;
+    /** Branch name (optional) */
+    branch?: string;
+}
+export interface GitPushParams {
+    /** Remote name (optional) */
+    remote?: string;
+    /** Branch name (optional) */
+    branch?: string;
+}
+export interface GitCommitParams {
+    /** Commit message */
+    message: string;
+    /** Author name (optional) */
+    author?: string;
+    /** Author email (optional) */
     email?: string;
-    /** Whether to add all files */
+    /** Whether to add all files before commit */
     addAll?: boolean;
 }
-export interface GitLogOptions {
+export interface GitCheckoutParams {
+    /** Branch or commit to checkout */
+    branch: string;
+    /** Whether to create new branch */
+    create?: boolean;
+}
+export interface GitBranchParams {
+    /** Branch name */
+    branch: string;
+    /** Whether to delete the branch */
+    delete?: boolean;
+    /** Whether to force the operation */
+    force?: boolean;
+}
+export interface GitLogsParams {
     /** Number of commits to retrieve */
     maxCount?: number;
     /** Starting from commit hash */
@@ -333,6 +1184,14 @@ export interface GitLogOptions {
     /** File path to filter logs */
     path?: string;
 }
+export interface GitDiffParams {
+    /** Commit hash to diff against */
+    commitHash?: string;
+    /** File path to diff */
+    file?: string;
+    /** Whether to show staged changes */
+    staged?: boolean;
+}
 export interface LLMChatOptions {
     /** Messages in the conversation */
     messages: Message[];
@@ -386,7 +1245,7 @@ export interface MemorySetOptions {
     /** Memory key */
     key: string;
     /** Memory value */
-    value: any;
+    value: string | number | boolean | Record<string, unknown> | unknown[];
     /** Expiration time in seconds */
     ttl?: number;
 }
@@ -394,7 +1253,7 @@ export interface MemoryGetOptions {
     /** Memory key */
     key: string;
     /** Default value if key not found */
-    defaultValue?: any;
+    defaultValue?: string | number | boolean | Record<string, unknown> | unknown[];
 }
 export interface TaskCreateOptions {
     /** Task title */
@@ -508,7 +1367,7 @@ export interface DebugLogOptions {
     /** Log level */
     level?: 'debug' | 'info' | 'warn' | 'error';
     /** Additional metadata */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     /** Component name */
     component?: string;
 }
@@ -520,7 +1379,7 @@ export interface ProjectInfo {
     /** Project type */
     type?: string;
     /** Project configuration */
-    config?: Record<string, any>;
+    config?: Record<string, unknown>;
 }
 export interface CrawlerOptions {
     /** URL to crawl */
@@ -540,7 +1399,7 @@ export interface MCPExecuteOptions {
     /** Server name */
     serverName?: string;
     /** Tool parameters */
-    params?: Record<string, any>;
+    params?: Record<string, unknown>;
     /** Request timeout */
     timeout?: number;
 }
@@ -548,7 +1407,7 @@ export interface MCPConfigureOptions {
     /** Server name */
     serverName: string;
     /** Configuration data */
-    config: Record<string, any>;
+    config: Record<string, unknown>;
     /** Whether to enable the server */
     enabled?: boolean;
 }
@@ -556,7 +1415,7 @@ export interface StateUpdateOptions {
     /** State key */
     key: string;
     /** State value */
-    value: any;
+    value: string | number | boolean | Record<string, unknown> | unknown[];
     /** Whether to merge with existing state */
     merge?: boolean;
 }
@@ -566,7 +1425,7 @@ export interface ChatSendOptions {
     /** Conversation ID */
     conversationId?: string;
     /** Message metadata */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     /** Mentioned files */
     mentionedFiles?: string[];
     /** Mentioned agents */
@@ -597,7 +1456,7 @@ export interface NotificationOptions {
 /**
  * Standard API response wrapper
  */
-export interface APIResponse<T = any> {
+export interface APIResponse<T = unknown> {
     /** Whether the operation was successful */
     success: boolean;
     /** Response data */
@@ -607,7 +1466,7 @@ export interface APIResponse<T = any> {
     /** Error code if unsuccessful */
     code?: string;
     /** Additional metadata */
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Pagination options for list operations
@@ -629,7 +1488,7 @@ export interface FilterOptions {
     /** Search query */
     query?: string;
     /** Field filters */
-    filters?: Record<string, any>;
+    filters?: Record<string, unknown>;
     /** Date range */
     dateRange?: {
         from?: Date | string;
@@ -656,7 +1515,7 @@ export interface APIEventMap {
     connected: () => void;
     disconnected: () => void;
     error: (error: Error) => void;
-    message: (message: any) => void;
+    message: (message: Record<string, unknown>) => void;
     progress: (progress: number) => void;
 }
 export interface CodeboltConfig {
@@ -693,3 +1552,33 @@ export type ProgressCallback = (progress: number, message?: string) => void;
 export type ErrorCallback = (error: Error) => void;
 export type SuccessCallback<T = any> = (result: T) => void;
 export type CompletionCallback<T = any> = (error: Error | null, result?: T) => void;
+/**
+ * This file contains comprehensive TypeScript types for the codeboltjs library API.
+ *
+ * Key sections include:
+ * - Message Types for Library API
+ * - File System API Types and Response Types
+ * - Browser API Types
+ * - Terminal API Types
+ * - Git API Types
+ * - LLM API Types
+ * - Vector Database API Types
+ * - Agent API Types
+ * - Memory API Types
+ * - Task API Types
+ * - Code Utils API Types
+ * - Debug API Types
+ * - Project API Types
+ * - Crawler API Types
+ * - MCP Tools API Types
+ * - State Management API Types
+ * - Chat API Types
+ * - Notification API Types
+ * - Utility Types for API
+ * - Event Types for API
+ * - Configuration Types for Library
+ * - Callback Types
+ *
+ * All types are designed to be user-friendly and provide comprehensive
+ * type safety for the codeboltjs library functions.
+ */