@theokit/sdk-tools 0.20.1 → 0.22.0

package/dist/index.d.cts

@@ -119,6 +119,17 @@ declare function createCurrentTimeTool(opts?: CreateCurrentTimeToolOptions): Cus
  */
 
 interface CreateEditFileToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
     /** Absolute path to the project root. Every edit is gated against this boundary. */
     projectRoot: string;
     /** Optional injected filesystem (`@theokit/sdk/filesystem`) — when provided, the read + `.bak` backup +
@@ -175,6 +186,40 @@ interface CreateGitDiffToolOptions {
 }
 declare function createGitDiffTool(opts: CreateGitDiffToolOptions): CustomTool;
 
+/**
+ * `git_status` — built-in tool for coding agents.
+ *
+ * Returns the working-tree status in porcelain v1 format (`git status --porcelain`), which is the
+ * stable machine-readable form — the human format is explicitly not guaranteed across git versions.
+ *
+ * M76 — nasce ao lado de `git_diff` e compartilha o motor de execução (`internal/git-exec.ts`): teto
+ * de stdout, kill do grupo de processos no timeout e mapeamento para erro tipado são a MESMA regra
+ * para qualquer subcomando do git. O consumidor (agent-builder) tinha isto local em 62 LoC; nada ali
+ * era específico dele.
+ *
+ * Result shape (always a JSON string):
+ *   - `{ ok: true, diff: string, truncated?: boolean }` — `diff` carrega a saída porcelain
+ *   - `{ ok: false, error: 'not_a_repo' | 'path_traversal' | 'timeout' | 'git_failed' }`
+ */
+
+interface CreateGitStatusToolOptions {
+    /** Absolute path to the project root. Every invocation is gated against this boundary. */
+    projectRoot: string;
+    /** Wall-clock cap; the process group is killed on expiry. Default 30_000. */
+    timeoutMs?: number;
+    /** Cap on captured stdout; excess sets `truncated: true`. Default 5 MB. */
+    maxStdoutBytes?: number;
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ `"git_status"` (aditivo).
+     *
+     * O nome é contrato: chave de approval, o que o modelo vê e o que o telemetry registra.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal abaixo (aditivo). */
+    description?: string;
+}
+declare function createGitStatusTool(opts: CreateGitStatusToolOptions): CustomTool;
+
 /**
  * `glob_files` — built-in tool for coding agents.
  *
@@ -528,6 +573,26 @@ declare function withShellExitGuidance(tool: CustomTool): CustomTool;
  */
 
 interface CreateListDirToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
+    /**
+     * M76 — opt-in "lista-em-qualquer-lugar": honra um `path` ABSOLUTO fora de `projectRoot`
+     * (paridade com `createReadFileTool`/`createSearchTextTool`, sandbox read-only do Codex).
+     *
+     * O guard de segredo por QUALQUER segmento continua valendo, e não é separável: `isForbiddenPath`
+     * só bloqueia o item sensível quando ele é o PRIMEIRO segmento, então um `/home/u/proj/.env/sub`
+     * passaria. Ligar o flag sem o guard é abrir exfiltração. Default `false` ⇒ absoluto rejeitado.
+     */
+    allowAbsolute?: boolean;
     /** Absolute path to the project root. Every listing is gated against this boundary. */
     projectRoot: string;
     /** Maximum number of entries returned per call. Default 500. */
@@ -605,17 +670,37 @@ declare function createPlanModeTool(options: PlanModeToolOptions): PlanModeToolW
  *   - `{ ok: false, error: "timeout" }`
  */
 interface QuestionToolOptions {
-    /** Callback that presents a question to the user and resolves with their answer. */
-    askUser: (question: string) => Promise<string>;
+    /**
+     * Callback que apresenta a pergunta ao usuário e resolve com a resposta.
+     *
+     * M76 — passou a ser OPCIONAL: o asker preferencial vem do contexto da run
+     * (`ctx.context.askUser`), porque um valor fixado aqui é o "baked into each factory" que a doc do
+     * `CustomTool.handler` aponta como o problema que `ctx.context` existe para resolver. Este campo
+     * permanece como fallback, para quem constrói a tool com um asker fixo (retrocompatível).
+     */
+    askUser?: (question: string) => Promise<string>;
     /** Maximum time to wait for user response in ms. Default: 300_000 (5 min). */
     timeoutMs?: number;
 }
+/**
+ * M76 — alinhado ao `CustomTool` do SDK. Era uma interface própria com `inputSchema: unknown`, o que
+ * obrigava todo consumidor a escrever um cast para registrar a tool — e cast não conserta contrato,
+ * só silencia o compilador, transformando uma futura mudança de assinatura em erro de RUNTIME.
+ *
+ * Estreitar foi aditivo: o valor sempre foi um objeto (`{ type: "object", properties, required }`
+ * logo abaixo); só o tipo declarado estava frouxo. O handler aceita o 2º argumento opcional do
+ * contrato (`ctx`), por onde o M76 passa a resolver o asker por sessão.
+ */
 interface QuestionTool {
     name: string;
     description: string;
-    inputSchema: unknown;
+    inputSchema: Record<string, unknown>;
     handler: (input: {
         question: string;
+    }, ctx?: {
+        signal?: AbortSignal;
+        context?: unknown;
+        threadId?: string;
     }) => Promise<string>;
 }
 declare function createQuestionTool(opts: QuestionToolOptions): QuestionTool;
@@ -782,6 +867,17 @@ declare function createRunVitestTool(opts: CreateRunVitestToolOptions): CustomTo
  */
 
 interface CreateSearchTextToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
     projectRoot: string;
     /** Cap on total matches returned. Default 100. */
     maxMatches?: number;
@@ -811,6 +907,17 @@ declare function createSearchTextTool(opts: CreateSearchTextToolOptions): Custom
  */
 
 interface CreateShellToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
     /** Absolute path to the project root. Commands execute in this cwd. */
     projectRoot: string;
     /** Default timeout in ms. Capped at 300s. */
@@ -1117,4 +1224,4 @@ interface CreateWriteFileToolOptions {
 }
 declare function createWriteFileTool(opts: CreateWriteFileToolOptions): CustomTool;
 
-export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateCurrentTimeToolOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createUpdatePlanTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };
+export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateCurrentTimeToolOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGitStatusToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGitStatusTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createUpdatePlanTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };

package/dist/index.d.ts

@@ -119,6 +119,17 @@ declare function createCurrentTimeTool(opts?: CreateCurrentTimeToolOptions): Cus
  */
 
 interface CreateEditFileToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
     /** Absolute path to the project root. Every edit is gated against this boundary. */
     projectRoot: string;
     /** Optional injected filesystem (`@theokit/sdk/filesystem`) — when provided, the read + `.bak` backup +
@@ -175,6 +186,40 @@ interface CreateGitDiffToolOptions {
 }
 declare function createGitDiffTool(opts: CreateGitDiffToolOptions): CustomTool;
 
+/**
+ * `git_status` — built-in tool for coding agents.
+ *
+ * Returns the working-tree status in porcelain v1 format (`git status --porcelain`), which is the
+ * stable machine-readable form — the human format is explicitly not guaranteed across git versions.
+ *
+ * M76 — nasce ao lado de `git_diff` e compartilha o motor de execução (`internal/git-exec.ts`): teto
+ * de stdout, kill do grupo de processos no timeout e mapeamento para erro tipado são a MESMA regra
+ * para qualquer subcomando do git. O consumidor (agent-builder) tinha isto local em 62 LoC; nada ali
+ * era específico dele.
+ *
+ * Result shape (always a JSON string):
+ *   - `{ ok: true, diff: string, truncated?: boolean }` — `diff` carrega a saída porcelain
+ *   - `{ ok: false, error: 'not_a_repo' | 'path_traversal' | 'timeout' | 'git_failed' }`
+ */
+
+interface CreateGitStatusToolOptions {
+    /** Absolute path to the project root. Every invocation is gated against this boundary. */
+    projectRoot: string;
+    /** Wall-clock cap; the process group is killed on expiry. Default 30_000. */
+    timeoutMs?: number;
+    /** Cap on captured stdout; excess sets `truncated: true`. Default 5 MB. */
+    maxStdoutBytes?: number;
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ `"git_status"` (aditivo).
+     *
+     * O nome é contrato: chave de approval, o que o modelo vê e o que o telemetry registra.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal abaixo (aditivo). */
+    description?: string;
+}
+declare function createGitStatusTool(opts: CreateGitStatusToolOptions): CustomTool;
+
 /**
  * `glob_files` — built-in tool for coding agents.
  *
@@ -528,6 +573,26 @@ declare function withShellExitGuidance(tool: CustomTool): CustomTool;
  */
 
 interface CreateListDirToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
+    /**
+     * M76 — opt-in "lista-em-qualquer-lugar": honra um `path` ABSOLUTO fora de `projectRoot`
+     * (paridade com `createReadFileTool`/`createSearchTextTool`, sandbox read-only do Codex).
+     *
+     * O guard de segredo por QUALQUER segmento continua valendo, e não é separável: `isForbiddenPath`
+     * só bloqueia o item sensível quando ele é o PRIMEIRO segmento, então um `/home/u/proj/.env/sub`
+     * passaria. Ligar o flag sem o guard é abrir exfiltração. Default `false` ⇒ absoluto rejeitado.
+     */
+    allowAbsolute?: boolean;
     /** Absolute path to the project root. Every listing is gated against this boundary. */
     projectRoot: string;
     /** Maximum number of entries returned per call. Default 500. */
@@ -605,17 +670,37 @@ declare function createPlanModeTool(options: PlanModeToolOptions): PlanModeToolW
  *   - `{ ok: false, error: "timeout" }`
  */
 interface QuestionToolOptions {
-    /** Callback that presents a question to the user and resolves with their answer. */
-    askUser: (question: string) => Promise<string>;
+    /**
+     * Callback que apresenta a pergunta ao usuário e resolve com a resposta.
+     *
+     * M76 — passou a ser OPCIONAL: o asker preferencial vem do contexto da run
+     * (`ctx.context.askUser`), porque um valor fixado aqui é o "baked into each factory" que a doc do
+     * `CustomTool.handler` aponta como o problema que `ctx.context` existe para resolver. Este campo
+     * permanece como fallback, para quem constrói a tool com um asker fixo (retrocompatível).
+     */
+    askUser?: (question: string) => Promise<string>;
     /** Maximum time to wait for user response in ms. Default: 300_000 (5 min). */
     timeoutMs?: number;
 }
+/**
+ * M76 — alinhado ao `CustomTool` do SDK. Era uma interface própria com `inputSchema: unknown`, o que
+ * obrigava todo consumidor a escrever um cast para registrar a tool — e cast não conserta contrato,
+ * só silencia o compilador, transformando uma futura mudança de assinatura em erro de RUNTIME.
+ *
+ * Estreitar foi aditivo: o valor sempre foi um objeto (`{ type: "object", properties, required }`
+ * logo abaixo); só o tipo declarado estava frouxo. O handler aceita o 2º argumento opcional do
+ * contrato (`ctx`), por onde o M76 passa a resolver o asker por sessão.
+ */
 interface QuestionTool {
     name: string;
     description: string;
-    inputSchema: unknown;
+    inputSchema: Record<string, unknown>;
     handler: (input: {
         question: string;
+    }, ctx?: {
+        signal?: AbortSignal;
+        context?: unknown;
+        threadId?: string;
     }) => Promise<string>;
 }
 declare function createQuestionTool(opts: QuestionToolOptions): QuestionTool;
@@ -782,6 +867,17 @@ declare function createRunVitestTool(opts: CreateRunVitestToolOptions): CustomTo
  */
 
 interface CreateSearchTextToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
     projectRoot: string;
     /** Cap on total matches returned. Default 100. */
     maxMatches?: number;
@@ -811,6 +907,17 @@ declare function createSearchTextTool(opts: CreateSearchTextToolOptions): Custom
  */
 
 interface CreateShellToolOptions {
+    /**
+     * M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo).
+     *
+     * Existe porque, no Codex, o nome NASCE na definição da tool e é a chave de decisão de approval —
+     * três consumidores (modelo, approval, telemetry) de uma string decidida num lugar só. Renomear
+     * depois da construção é mudar a identidade de algo já publicado ao modelo. `withName` continua
+     * para o caso genuinamente dinâmico.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
     /** Absolute path to the project root. Commands execute in this cwd. */
     projectRoot: string;
     /** Default timeout in ms. Capped at 300s. */
@@ -1117,4 +1224,4 @@ interface CreateWriteFileToolOptions {
 }
 declare function createWriteFileTool(opts: CreateWriteFileToolOptions): CustomTool;
 
-export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateCurrentTimeToolOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createUpdatePlanTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };
+export { CatastrophicCommandError, type CommandPolicy, ContextMatchError, type ContextMatchReason, type CreateApplyPatchToolOptions, type CreateBraveWebSearchAdapterOptions, type CreateCurrentTimeToolOptions, type CreateEditFileToolOptions, type CreateGenericHttpSearchAdapterOptions, type CreateGitDiffToolOptions, type CreateGitStatusToolOptions, type CreateGlobToolOptions, type CreateInteractiveShellToolOptions, type CreateListDirToolOptions, type CreateReadFileToolOptions, type CreateRunVitestToolOptions, type CreateSearchTextToolOptions, type CreateShellToolOptions, type CreateWebFetchToolOptions, type CreateWebSearchToolOptions, type CreateWriteFileToolOptions, DEFAULT_TOOL_GUIDANCE, type EnvContextOptions, type PlanModeTool, type PlanModeToolOptions, type PlanModeToolWithStore, type PlanNode, type QuestionTool, type QuestionToolOptions, ReadTracker, ReasoningTools, RedirectBlockedError, type RepoMapOptions, type ResolveAndScreenOptions, type ScreenedFetchOptions, type SessionArtifactStore, type SessionArtifactStoreOptions, SsrfBlockedError, type TodoItem, type TodolistTool, type ToolGuidanceMap, type TruncationOptions, type TruncationResult, type VitestSummary, type WebSearchCallback, type WebSearchResult, buildEnvContext, buildRepoMap, catastrophicShellReason, commandDenialReason, createApplyPatchTool, createBraveWebSearchAdapter, createCurrentTimeTool, createEditFileTool, createGenericHttpSearchAdapter, createGitDiffTool, createGitStatusTool, createGlobTool, createInteractiveShellTool, createListDirTool, createPlanModeTool, createQuestionTool, createReadFileTool, createRunVitestTool, createSearchTextTool, createSessionArtifactStore, createShellTool, createTodolistTool, createUpdatePlanTool, createWebFetchTool, createWebSearchTool, createWriteFileTool, createWriteStdinTool, denyCatastrophicCommands, formatCode, formatDiff, formatError, formatFileList, injectGuidance, isBlockedIp, isCommandAllowed, renderToolList, replaceUnique, resolveAndScreen, screenedFetch, todoItemsToPlanNodes, truncateOutput, withDefaultGuidance, withDescription, withName, withShellExitGuidance, withToolResultGuidance };