@theokit/sdk-tools 0.26.0 → 0.26.2

package/dist/index.d.ts

@@ -26,10 +26,10 @@ import { InteractiveProvider } from '@theokit/sdk/interactive';
  */
 
 interface CreateApplyPatchToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Absolute path to the project root. Every hunk path is gated against this boundary. */
     projectRoot: string;
@@ -106,10 +106,10 @@ declare function createSessionArtifactStore(options: SessionArtifactStoreOptions
  */
 
 interface CreateCurrentTimeToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Injectable clock — defaults to `() => new Date()`. Pass a fixed clock for deterministic tests. */
     clock?: () => Date;
@@ -132,13 +132,13 @@ 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.
+     * It exists because, in Codex, the name is BORN in the tool definition and is the approval decision
+     * key — three consumers (model, approval, telemetry) of a string decided in one place. Renaming
+     * after construction changes the identity of something already published to the model. `withName`
+     * remains for the genuinely dynamic case.
      */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Absolute path to the project root. Every edit is gated against this boundary. */
     projectRoot: string;
@@ -187,10 +187,10 @@ declare function formatError(message: string, code?: string): string;
  */
 
 interface CreateGitDiffToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     projectRoot: string;
     timeoutMs?: number;
@@ -207,13 +207,13 @@ declare function createGitDiffTool(opts: CreateGitDiffToolOptions): CustomTool;
  * 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.
+ * M76 — born alongside `git_diff` and sharing the execution engine (`internal/git-exec.ts`): the stdout
+ * ceiling, process-group kill on timeout and mapping to a typed error are the SAME rule
+ * for any git subcommand. The consumer (agent-builder) had this locally in 62 LoC; nothing there
+ * was specific to it.
  *
  * Result shape (always a JSON string):
- *   - `{ ok: true, diff: string, truncated?: boolean }` — `diff` carrega a saída porcelain
+ *   - `{ ok: true, diff: string, truncated?: boolean }` — `diff` carries the porcelain output
  *   - `{ ok: false, error: 'not_a_repo' | 'path_traversal' | 'timeout' | 'git_failed' }`
  */
 
@@ -225,28 +225,28 @@ interface CreateGitStatusToolOptions {
     /** Cap on captured stdout; excess sets `truncated: true`. Default 5 MB. */
     maxStdoutBytes?: number;
     /**
-     * Backend de execução injetado (`@theokit/sdk/sandbox`) — quando presente, `git status` roda via
+     * Injected execution backend (`@theokit/sdk/sandbox`) — when present, `git status` runs via
      * `SandboxBackend.execute`; omitido ⇒ o `git` local (inalterado).
      *
-     * Simetria com `createGitDiffTool`, apontada pelo review do M76: sem isto `git_diff` rodaria
-     * confinado e `git_status` não, na mesma sessão — e a assimetria seria invisível até alguém
+     * Symmetry with `createGitDiffTool`, flagged by the M76 review: without it `git_diff` would run
+     * confined and `git_status` not, in the same session — and the asymmetry would be invisible until someone
      * perceber que uma das duas escapa do sandbox.
      */
     sandbox?: SandboxProvider;
     /**
      * 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.
+     * The name is a contract: the approval key, what the model sees and what telemetry records.
      */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal abaixo (aditivo). */
+    /** M76 — description exposed to the model. Omitted => the literal below (additive). */
     description?: string;
     /**
-     * Incluir a linha de branch (`-b`) no início da saída. Default `true`.
+     * Include the branch line (`-b`) at the start of the output. Default `true`.
      *
-     * Sem ela o agente vê o que mudou mas não ONDE — e "estou na branch certa?" é a pergunta que
-     * precede qualquer commit. O consumidor (agent-builder) já dependia disso; omiti-la faria a
-     * migração perder comportamento em silêncio, que é o que a deleção de código local não pode custar.
+     * Without it the agent sees what changed but not WHERE — and "am I on the right branch?" is the question that
+     * precedes any commit. The consumer (agent-builder) already depended on it; omitting it would make the
+     * migration lose behavior silently, which is what deleting local code must not cost.
      */
     includeBranch?: boolean;
 }
@@ -264,10 +264,10 @@ declare function createGitStatusTool(opts: CreateGitStatusToolOptions): CustomTo
  */
 
 interface CreateGlobToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Absolute path to the project root. */
     projectRoot: string;
@@ -296,10 +296,10 @@ declare function createGlobTool(opts: CreateGlobToolOptions): CustomTool;
  */
 
 interface CreateInteractiveShellToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** The interactive backend, or a per-request resolver of one (injected — never a direct native dep). */
     interactive: InteractiveProvider<unknown>;
@@ -618,21 +618,21 @@ 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.
+     * It exists because, in Codex, the name is BORN in the tool definition and is the approval decision key —
+     * three consumers (model, approval, telemetry) of a string decided in one place. Renaming
+     * after construction changes the identity of something already published to the model. `withName` remains
+     * for the genuinely dynamic case.
      */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     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.
+     * The ANY-segment secret guard still applies, and is not separable: `isForbiddenPath`
+     * only blocks the sensitive item when it is the FIRST segment, so a `/home/u/proj/.env/sub`
+     * would pass. Enabling the flag without the guard opens exfiltration. Default `false` => absolute rejected.
      */
     allowAbsolute?: boolean;
     /** Absolute path to the project root. Every listing is gated against this boundary. */
@@ -696,10 +696,10 @@ interface PlanModeToolWithStore {
  * @public
  */
 interface PlanModeToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Store the submitted `plan` is persisted to on `exit`. */
     artifactStore: SessionArtifactStore;
@@ -718,18 +718,18 @@ declare function createPlanModeTool(options: PlanModeToolOptions): PlanModeToolW
  */
 interface QuestionToolOptions {
     /**
-     * Callback que apresenta a pergunta ao usuário e resolve com a resposta.
+     * Callback that presents the question to the user and resolves with the answer.
      *
      * 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
+     * (`ctx.context.askUser`), because a value pinned here is the "baked into each factory" that the
      * `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).
+     * remains as a fallback, for callers building the tool with a fixed asker (backward-compatible).
      */
     askUser?: (question: string, threadId?: string) => Promise<string>;
     /**
-     * Chamado quando a pergunta é ABANDONADA (timeout ou cancelamento da run), para que o lado da UI
-     * libere o slot. Sem ele o timeout deixa a pergunta pendente para sempre — a UI segue mostrando
-     * um prompt que ninguém aguarda e a próxima pergunta falha com "já há uma pendente".
+     * Called when the question is ABANDONED (timeout or run cancellation), so the UI side can
+     * release the slot. Without it the timeout leaves the question pending forever — the UI keeps showing
+     * a prompt nobody is waiting on and the next question fails with "one is already pending".
      */
     onAbandon?: (threadId?: string) => void;
     /** Maximum time to wait for user response in ms. Default: 300_000 (5 min). */
@@ -737,32 +737,32 @@ interface QuestionToolOptions {
     /**
      * M76 — nome exposto ao modelo. Omitido ⇒ `"question"` (aditivo).
      *
-     * O consumidor precisava disto: o Codex chama a tool de `request_user_input`, e sem a opção ele
-     * era obrigado a reconstruir o objeto inteiro à mão — o adaptador com dois casts que a T3.3
+     * The consumer needed this: Codex calls the tool `request_user_input`, and without the option it
+     * had to rebuild the whole object by hand — the two-cast adapter T3.3
      * eliminou.
      */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
 }
 /**
- * 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.
+ * M76 — aligned with the SDK's `CustomTool`. It used to be its own interface with `inputSchema: unknown`, which
+ * forced every consumer to write a cast to register the tool — and a cast does not fix a contract,
+ * it only silences the compiler, turning a future signature change into a RUNTIME error.
  *
- * 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.
+ * Narrowing was additive: the value has always been an object (`{ type: "object", properties, required }`
+ * just below); only the declared type was loose. The handler accepts the contract's optional 2nd
+ * argument (`ctx`), through which M76 now resolves the asker per session.
  */
 interface QuestionTool {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
     /**
-     * M76 — o input é `Record<string, unknown>`, não `{ question: string }`, por CONTRAVARIÂNCIA: um
-     * handler que aceita só o tipo estreito não é atribuível a um que aceita o largo, e o `CustomTool`
-     * do SDK declara o largo. Declarar estreito aqui obrigava o consumidor a um cast — que era
-     * exatamente o defeito. O estreitamento acontece DENTRO do handler, onde há validação.
+     * M76 — the input is `Record<string, unknown>`, not `{ question: string }`, by CONTRAVARIANCE: a
+     * handler accepting only the narrow type is not assignable to one accepting the wide type, and `CustomTool`
+     * SDK declares the wide one. Declaring narrow here forced the consumer into a cast — which was
+     * exactly the defect. Narrowing happens INSIDE the handler, where validation lives.
      */
     handler: (input: Record<string, unknown>, ctx?: {
         signal?: AbortSignal;
@@ -818,10 +818,10 @@ declare class ReadTracker {
  */
 
 interface CreateReadFileToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Absolute path to the project root. Every read is gated against this boundary. */
     projectRoot: string;
@@ -902,10 +902,10 @@ declare class ReasoningTools {
  */
 
 interface CreateRunVitestToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     projectRoot: string;
     timeoutMs?: number;
@@ -947,13 +947,13 @@ 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.
+     * It exists because, in Codex, the name is BORN in the tool definition and is the approval decision
+     * key — three consumers (model, approval, telemetry) of a string decided in one place. Renaming
+     * after construction changes the identity of something already published to the model. `withName`
+     * remains for the genuinely dynamic case.
      */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     projectRoot: string;
     /** Cap on total matches returned. Default 100. */
@@ -987,13 +987,13 @@ 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.
+     * It exists because, in Codex, the name is BORN in the tool definition and is the approval decision
+     * key — three consumers (model, approval, telemetry) of a string decided in one place. Renaming
+     * after construction changes the identity of something already published to the model. `withName`
+     * remains for the genuinely dynamic case.
      */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Absolute path to the project root. Commands execute in this cwd. */
     projectRoot: string;
@@ -1186,10 +1186,10 @@ declare function createUpdatePlanTool(): CustomTool;
  */
 
 interface CreateWebFetchToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Default timeout in ms. */
     defaultTimeoutMs?: number;
@@ -1230,10 +1230,10 @@ interface WebSearchResult {
 }
 type WebSearchCallback = (query: string, maxResults: number) => Promise<WebSearchResult[]>;
 interface CreateWebSearchToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Search provider callback — consumer injects the implementation. */
     search: WebSearchCallback;
@@ -1324,10 +1324,10 @@ type WriteToolContext = {
     context?: unknown;
 };
 interface CreateWriteFileToolOptions {
-    /** M76 — nome exposto ao modelo. Omitido ⇒ o literal de hoje (aditivo). O nome é contrato: chave
-     *  de approval, o que o modelo vê e o que o telemetry registra. */
+    /** M76 — name exposed to the model. Omitted => today's literal (additive). The name is a contract:
+     *  the approval key, what the model sees and what telemetry records. */
     name?: string;
-    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    /** M76 — description exposed to the model. Omitted => today's literal (additive). */
     description?: string;
     /** Absolute path to the project root. Every write is gated against this boundary. */
     projectRoot: string;
@@ -1351,4 +1351,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 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 };
+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 TruncationMode, 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.js

@@ -864,7 +864,7 @@ function createGitStatusTool(opts) {
       }
       const scopeCheck = checkPathScope(path, projectRoot);
       if (scopeCheck !== null) return scopeCheck;
-      const args = montarArgs(path, opts.includeBranch !== false);
+      const args = buildArgs(path, opts.includeBranch !== false);
       if (opts.sandbox !== void 0) {
         return statusViaSandbox(opts.sandbox, ctx, args, timeoutMs);
       }
@@ -873,9 +873,9 @@ function createGitStatusTool(opts) {
     }
   });
 }
-function montarArgs(path, comBranch) {
+function buildArgs(path, withBranch) {
   const args = ["status", "--porcelain=v1"];
-  if (comBranch) args.push("-b");
+  if (withBranch) args.push("-b");
   if (path !== void 0 && path !== "") args.push("--", path);
   return args;
 }
@@ -1002,7 +1002,26 @@ function globToRegex(pattern) {
   }
   return new RegExp(`^${regexStr}$`);
 }
+function capFields(err) {
+  const e = err;
+  if (typeof e.max !== "number") return void 0;
+  if (!Array.isArray(e.liveSessionIds)) return void 0;
+  if (!e.liveSessionIds.every((id) => typeof id === "string")) return void 0;
+  return { max: e.max, liveSessionIds: e.liveSessionIds };
+}
 function toErrorJson(err) {
+  if (typeof err === "object" && err !== null) {
+    const cap = capFields(err);
+    if (cap !== void 0) {
+      return JSON.stringify({
+        ok: false,
+        error: "interactive_session_limit",
+        max: cap.max,
+        live_session_ids: [...cap.liveSessionIds],
+        message: err.message
+      });
+    }
+  }
   if (err instanceof InteractiveUnavailableError) {
     return JSON.stringify({ ok: false, error: "interactive_unavailable" });
   }
@@ -1565,10 +1584,10 @@ function createListDirTool(opts) {
     }),
     handler: async ({ path }, ctx) => {
       const relative3 = path === "" || path === "." ? "." : path;
-      const veredito = decidirEscopo(relative3, path, opts.allowAbsolute === true);
-      if (veredito.erro !== void 0) return veredito.erro;
-      if (veredito.raizAbsoluta !== void 0) {
-        return listViaLocalFs(veredito.raizAbsoluta, ".", path, max);
+      const verdict = decidirEscopo(relative3, path, opts.allowAbsolute === true);
+      if (verdict.error !== void 0) return verdict.error;
+      if (verdict.absoluteRoot !== void 0) {
+        return listViaLocalFs(verdict.absoluteRoot, ".", path, max);
       }
       if (filesystem) {
         const backend = await resolveFilesystem(filesystem, ctx ?? {});
@@ -1579,14 +1598,14 @@ function createListDirTool(opts) {
   });
 }
 function decidirEscopo(relative3, original, allowAbsolute) {
-  const recusa = (error) => ({
-    erro: JSON.stringify({ ok: false, error, path: original })
+  const refuse = (error) => ({
+    error: JSON.stringify({ ok: false, error, path: original })
   });
-  if (relative3 !== "." && isForbiddenPath(relative3)) return recusa("forbidden_path");
+  if (relative3 !== "." && isForbiddenPath(relative3)) return refuse("forbidden_path");
   if (!isAbsolute(relative3)) return {};
-  if (!allowAbsolute) return recusa("path_traversal");
-  if (ehProibidoEmQualquerProfundidade(relative3)) return recusa("forbidden_path");
-  return { raizAbsoluta: relative3 };
+  if (!allowAbsolute) return refuse("path_traversal");
+  if (ehProibidoEmQualquerProfundidade(relative3)) return refuse("forbidden_path");
+  return { absoluteRoot: relative3 };
 }
 async function listViaLocalFs(projectRoot, relative3, originalPath, max) {
   const boundary = resolveDirBoundary(relative3, projectRoot, originalPath);