@cerebriline/core 4.100.243 → 4.100.245

package/dist/extensions/tools/code-search.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Search of a workspace's code by meaning, as `search_codebase` uses it.
+ *
+ * The index is the user's choice per folder (Settings > Library): building it
+ * sends every source file in the folder to the embedding model. Where the
+ * folder is opted in and an embedding model is set, this is the executor a
+ * host hands to the tools; the index is brought up to date in the background,
+ * and a search made before that is done says so instead of waiting.
+ */
+import { type LibrarySettings } from "@cerebriline/shared";
+import { type CodeIndex, type CodeSearchResult } from "../../services/retrieval/code-index";
+import type { RetrievalEndpoint } from "../../services/retrieval/embedding-client";
+import type { SemanticSearchExecutor } from "./types";
+export interface CodeSearchConfig {
+    settings: LibrarySettings;
+    /** The embedding model, when the user has set one. */
+    embedding?: RetrievalEndpoint;
+    /** The reranking model, when the user has set one. */
+    reranker?: RetrievalEndpoint;
+}
+export interface CodeIndexProgress {
+    /** What the refresh is doing now. */
+    phase: "reading" | "embedding";
+    done: number;
+    total: number;
+}
+export interface CodeIndexRefreshState {
+    running: boolean;
+    progress?: CodeIndexProgress;
+    /** Why the last refresh stopped short, when it did. */
+    problem?: string;
+    /** When the last refresh finished, in epoch milliseconds. */
+    finishedAt?: number;
+}
+export interface CreateCodeSearchOptions {
+    /** Read on every call: the settings can change mid-session. */
+    getConfig: () => CodeSearchConfig;
+    /** @default the shared code index of the data folder */
+    index?: CodeIndex;
+    log?: (message: string) => void;
+}
+export interface CodeSearch extends SemanticSearchExecutor {
+    /**
+     * Bring a folder's index up to date: read what changed, then embed what has
+     * no vectors. One at a time per folder; a second call joins the first.
+     * Resolves when it is done and never rejects: the state says what happened.
+     */
+    refresh(root: string): Promise<void>;
+    state(root: string): CodeIndexRefreshState;
+}
+/** Whether a folder is searched by meaning: opted in, with a model to embed with. */
+export declare function codeSearchAvailable(config: CodeSearchConfig, root: string): boolean;
+/** The hits as the model reads them: where each passage is, then the passage. */
+export declare function formatCodeHits(result: CodeSearchResult): string;
+export declare function createCodeSearch(options: CreateCodeSearchOptions): CodeSearch;

package/dist/extensions/tools/definitions.d.ts

@@ -6,7 +6,7 @@
 import { type AgentTool, type ShellKind } from "@cerebriline/shared";
 import { type QaCredential } from "./qa-credentials";
 import { type ApplyPatchInput, type AskQuestionInput, type AwkToolInput, type EditFileInput, type ExtractDocumentInput, type FetchWebContentInput, type GrepToolInput, type ReadFileRequest, type ReadFilesInput, type SearchCodebaseInput, type SedToolInput, type SkillsInput, type SubmitInput } from "./schemas";
-import type { ApplyPatchExecutor, AskQuestionExecutor, AwkExecutor, CreateDefaultToolsOptions, DefaultToolsConfig, EditorExecutor, ExtractDocumentExecutor, FileReadExecutor, GrepExecutor, SearchExecutor, SedExecutor, ShellExecutor, SkillsExecutorWithMetadata, ToolOperationResult, VerifySubmitExecutor, WebFetchExecutor } from "./types";
+import type { ApplyPatchExecutor, AskQuestionExecutor, AwkExecutor, CreateDefaultToolsOptions, DefaultToolsConfig, EditorExecutor, ExtractDocumentExecutor, FileReadExecutor, GrepExecutor, SearchExecutor, SedExecutor, SemanticSearchExecutor, ShellExecutor, SkillsExecutorWithMetadata, ToolOperationResult, VerifySubmitExecutor, WebFetchExecutor } from "./types";
 /**
  * What a successful read with no content is told to mean.
  *
@@ -41,7 +41,7 @@ export declare function createReadFilesTool(executor: FileReadExecutor, config?:
  *
  * Performs regex pattern searches across the codebase.
  */
-export declare function createSearchTool(executor: SearchExecutor, config?: Pick<DefaultToolsConfig, "cwd" | "searchTimeoutMs">): AgentTool<SearchCodebaseInput, ToolOperationResult[]>;
+export declare function createSearchTool(executor: SearchExecutor, config?: Pick<DefaultToolsConfig, "cwd" | "searchTimeoutMs">, semantic?: SemanticSearchExecutor["search"]): AgentTool<SearchCodebaseInput, ToolOperationResult[]>;
 /**
  * Build the run_commands tool description for the shell that will actually
  * execute the commands. The shell kind decides the syntax guidance (quoting,

package/dist/extensions/tools/index.d.ts

@@ -16,7 +16,7 @@ export { type BuiltinToolAvailabilityContext, getCoreAcpToolNames, getCoreBuilti
 export { type ApplyPatchInput, ApplyPatchInputSchema, type AskQuestionInput, AskQuestionInputSchema, AwkInputSchema, type AwkToolInput, type EditFileInput, EditFileInputSchema, type ExtractDocumentInput, ExtractDocumentInputSchema, type FetchWebContentInput, FetchWebContentInputSchema, GrepInputSchema, type GrepToolInput, type ReadFileRequest, ReadFileRequestSchema, type ReadFilesInput, ReadFilesInputSchema, type RunCommandsInput, RunCommandsInputSchema, type SearchCodebaseInput, SearchCodebaseInputSchema, SedInputSchema, type SedToolInput, type SkillsInput, SkillsInputSchema, type StructuredCommandInput, StructuredCommandInputSchema, type SubmitInput, SubmitInputSchema, type WebFetchRequest, WebFetchRequestSchema, } from "./schemas";
 export { buildTaskProgressReminder, buildTaskProgressState, DEFAULT_TASK_PROGRESS_REMINDER_INTERVAL, parseTaskProgress, readTaskProgress, TASK_PROGRESS_PARAM, TASK_PROGRESS_PARAM_DESCRIPTION, type TaskProgressItem, type TaskProgressState, TaskProgressTracker, type TaskProgressTrackerOptions, withTaskProgressCapture, withTaskProgressParam, } from "./task-progress";
 export { TEAM_TOOL_NAMES } from "./team/team-tools";
-export type { ApplyPatchExecutor, AskQuestionExecutor, AwkExecutor, CreateDefaultToolsOptions, DefaultToolName, DefaultToolsConfig, EditorExecutor, FileReadExecutor, GrepExecutor, SearchExecutor, SedExecutor, ShellExecutionOptions, ShellExecutor, SkillsExecutor, SkillsExecutorSkillMetadata, SkillsExecutorWithMetadata, ToolExecutors, ToolOperationResult, VerifySubmitExecutor, WebFetchExecutor, } from "./types";
+export type { ApplyPatchExecutor, AskQuestionExecutor, AwkExecutor, CreateDefaultToolsOptions, DefaultToolName, DefaultToolsConfig, EditorExecutor, FileReadExecutor, GrepExecutor, SearchExecutor, SedExecutor, SemanticSearchExecutor, ShellExecutionOptions, ShellExecutor, SkillsExecutor, SkillsExecutorSkillMetadata, SkillsExecutorWithMetadata, ToolExecutors, ToolOperationResult, VerifySubmitExecutor, WebFetchExecutor, } from "./types";
 import { type AgentTool } from "@cerebriline/shared";
 import { type DefaultExecutorsOptions } from "./executors/index";
 import type { CreateDefaultToolsOptions, ToolExecutors } from "./types";

package/dist/extensions/tools/types.d.ts

@@ -51,6 +51,19 @@ export interface SearchQueryOptions {
     maxPerFile?: number;
 }
 export type SearchExecutor = (query: string, cwd: string, context: AgentToolContext, options?: SearchQueryOptions) => Promise<string>;
+/**
+ * Search of the workspace's code by meaning, for `search_codebase`'s
+ * `mode: "semantic"`. A host supplies it only where the workspace is indexed:
+ * its presence is what adds the mode to the tool.
+ */
+export interface SemanticSearchExecutor {
+    /**
+     * Asked once, when a session's tools are built: whether this folder is
+     * indexed. One host serves many workspaces, so the answer is per folder.
+     */
+    available(cwd: string): boolean;
+    search(query: string, cwd: string, context: AgentToolContext): Promise<string>;
+}
 /**
  * Per-call execution options for a shell executor.
  */
@@ -209,6 +222,8 @@ export interface ToolExecutors {
     readFile?: FileReadExecutor;
     /** Codebase search implementation */
     search?: SearchExecutor;
+    /** Code search by meaning; adds `mode: "semantic"` to search_codebase */
+    semanticSearch?: SemanticSearchExecutor;
     /** Shell command execution implementation */
     bash?: ShellExecutor;
     /** Web content fetching implementation */