@theokit/sdk-tools 0.22.1 → 0.23.0

package/dist/index.d.cts

@@ -217,6 +217,14 @@ interface CreateGitStatusToolOptions {
     name?: string;
     /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal abaixo (aditivo). */
     description?: string;
+    /**
+     * Incluir a linha de branch (`-b`) no início da saída. 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.
+     */
+    includeBranch?: boolean;
 }
 declare function createGitStatusTool(opts: CreateGitStatusToolOptions): CustomTool;
 
@@ -681,6 +689,16 @@ interface QuestionToolOptions {
     askUser?: (question: string) => Promise<string>;
     /** Maximum time to wait for user response in ms. Default: 300_000 (5 min). */
     timeoutMs?: number;
+    /**
+     * 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
+     * eliminou.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
 }
 /**
  * M76 — alinhado ao `CustomTool` do SDK. Era uma interface própria com `inputSchema: unknown`, o que

package/dist/index.d.ts

@@ -217,6 +217,14 @@ interface CreateGitStatusToolOptions {
     name?: string;
     /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal abaixo (aditivo). */
     description?: string;
+    /**
+     * Incluir a linha de branch (`-b`) no início da saída. 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.
+     */
+    includeBranch?: boolean;
 }
 declare function createGitStatusTool(opts: CreateGitStatusToolOptions): CustomTool;
 
@@ -681,6 +689,16 @@ interface QuestionToolOptions {
     askUser?: (question: string) => Promise<string>;
     /** Maximum time to wait for user response in ms. Default: 300_000 (5 min). */
     timeoutMs?: number;
+    /**
+     * 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
+     * eliminou.
+     */
+    name?: string;
+    /** M76 — descrição exposta ao modelo. Omitida ⇒ o literal de hoje (aditivo). */
+    description?: string;
 }
 /**
  * M76 — alinhado ao `CustomTool` do SDK. Era uma interface própria com `inputSchema: unknown`, o que

package/dist/index.js

@@ -863,7 +863,8 @@ function createGitStatusTool(opts) {
       }
       const scopeCheck = checkPathScope(path, projectRoot);
       if (scopeCheck !== null) return scopeCheck;
-      const args = ["status", "--porcelain"];
+      const args = ["status", "--porcelain=v1"];
+      if (opts.includeBranch !== false) args.push("-b");
       if (path !== void 0 && path !== "") args.push("--", path);
       const result = await runGitProcess(projectRoot, args, timeoutMs, maxStdoutBytes);
       return formatGitResult(result, timeoutMs);
@@ -1737,8 +1738,8 @@ function askerDoContexto(context) {
 function createQuestionTool(opts) {
   const timeoutMs = opts.timeoutMs ?? 3e5;
   return {
-    name: "question",
-    description: "Ask the user a question and wait for their response. Use when you need clarification or confirmation before proceeding. Returns { ok, answer } or { ok: false, error: 'timeout' }.",
+    name: opts.name ?? "question",
+    description: opts.description ?? "Ask the user a question and wait for their response. Use when you need clarification or confirmation before proceeding. Returns { ok, answer } or { ok: false, error: 'timeout' }.",
     inputSchema: {
       type: "object",
       properties: {