feat(chat-panel): add provide at function feature api in chat panel

clients/tabby-chat-panel/src/index.ts

@@ -211,6 +211,47 @@ export interface GitRepository {
  */
 export type ChatCommand = 'explain' | 'fix' | 'generate-docs' | 'generate-tests'
 
+/**
+ * A symbol kind from vscode standard
+ */
+export enum SymbolKind {
+  /**
+   * The `File` symbol kind.
+   */
+  File = 0,
+}
+
+/**
+ * Represents a file reference (file path plus an optional 1-based line range) for retrieving file content.
+ * If `range` is not provided, the entire file is considered.
+ */
+export interface FileRange {
+  /**
+   * A {@link Filepath} identifying the location of the file.
+   */
+  filepath: Filepath
+
+  /**
+   * A 1-based line range specifying a subset of the file content.
+   */
+  range?: LineRange
+}
+
+/**
+ * Defines optional parameters used to filter or limit the results of a file query.
+ */
+export interface AtInputOpts {
+  /**
+   * A search query string used for filtering results.
+   */
+  query?: string
+
+  /**
+   * The maximum number of results to return.
+   */
+  limit?: number
+}
+
 export interface ServerApi {
   init: (request: InitRequest) => void
 
@@ -278,6 +319,21 @@ export interface ClientApiMethods {
    * @returns The active selection of active editor.
    */
   getActiveEditorSelection: () => Promise<EditorFileContext | null>
+
+  /**
+   * Returns a list of file information matching the specified query.
+   * @param opts An optional {@link AtInputOpts} object that includes a search query and a limit for the results.
+   * @returns An array of {@link FileRange} objects, or `null` if no matching files are found.
+   */
+  listFileInWorkspace?: (opts?: AtInputOpts) => Promise<FileRange[] | null>
+
+  /**
+   * Returns the content of a file within the specified range.
+   * If `range` is not provided, the entire file content is returned.
+   * @param info A {@link FileRange} object that includes the file path and optionally a 1-based line range.
+   * @returns The content of the file as a string, or `null` if the file or range cannot be accessed.
+   */
+  readFileContent?: (info: FileRange) => Promise<string | null>
 }
 
 export interface ClientApi extends ClientApiMethods {
@@ -303,6 +359,8 @@ export function createClient(target: HTMLIFrameElement, api: ClientApiMethods):
       openExternal: api.openExternal,
       readWorkspaceGitRepositories: api.readWorkspaceGitRepositories,
       getActiveEditorSelection: api.getActiveEditorSelection,
+      provideFileAtInfo: api.listFileInWorkspace,
+      provideRangeContent: api.readFileContent,
     },
   })
 }