@theokit/sdk-tools 0.22.0 → 0.22.2

package/dist/index.d.cts

@@ -681,6 +681,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
@@ -695,9 +705,13 @@ interface QuestionTool {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
-    handler: (input: {
-        question: string;
-    }, ctx?: {
+    /**
+     * 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.
+     */
+    handler: (input: Record<string, unknown>, ctx?: {
         signal?: AbortSignal;
         context?: unknown;
         threadId?: string;

package/dist/index.d.ts

@@ -681,6 +681,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
@@ -695,9 +705,13 @@ interface QuestionTool {
     name: string;
     description: string;
     inputSchema: Record<string, unknown>;
-    handler: (input: {
-        question: string;
-    }, ctx?: {
+    /**
+     * 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.
+     */
+    handler: (input: Record<string, unknown>, ctx?: {
         signal?: AbortSignal;
         context?: unknown;
         threadId?: string;

package/dist/index.js

@@ -1737,8 +1737,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: {
@@ -1759,7 +1759,7 @@ function createQuestionTool(opts) {
         setTimeout(() => reject(new Error("timeout")), timeoutMs);
       });
       try {
-        const answer = await Promise.race([askUser(input.question), timeout]);
+        const answer = await Promise.race([askUser(String(input.question ?? "")), timeout]);
         return JSON.stringify({ ok: true, answer });
       } catch (err) {
         if (err instanceof Error && err.message === "timeout") {