@gitterm/sdk 0.2.0 → 0.2.2

package/README.md

@@ -517,6 +517,12 @@ remain. The exported types are `AgentPermissionRequest`, `AgentQuestionRequest`,
   **labels** keyed by question `key`, or one free-text string when `custom` is true:
   `{ type: "question", answers: { [question.key]: string[] } }`. Every question needs an entry.
   Or dismiss all of them with `{ type: "question", reject: true }`.
+  `custom` defaults to true, matching OpenCode; false only when the agent sets it.
+  Questions with `options: []` accept free-text answers when `custom` is true.
+
+Question options are normalised at the runtime boundary: labels and descriptions are trimmed,
+OpenCode's copied "Type your own answer" entry is removed and enables `custom: true`, and
+duplicate and blank labels are dropped. Hosted users need the API redeployed for this to take effect.
 
 The quick start above shows a complete relay. Rejecting a permission or dismissing a question
 ends the turn: OpenCode records a failed tool call and the run finishes. A run left

package/dist/direct/index.js

@@ -2,6 +2,36 @@
 import { randomUUID } from "node:crypto";
 import { createOpencodeClient as createOpencodeClient2 } from "@opencode-ai/sdk";
 
+// ../agent-runtime/src/normalize.ts
+var OPENCODE_CUSTOM_OPTION_LABEL = /^type your own answer\W*$/i;
+function normalizeQuestion(question) {
+  const options = [];
+  const labels = new Set;
+  let changed = false;
+  let custom = question.custom;
+  for (const option of question.options) {
+    const label = option.label.trim();
+    const description = option.description.trim();
+    if (OPENCODE_CUSTOM_OPTION_LABEL.test(label)) {
+      custom = true;
+      changed = true;
+      continue;
+    }
+    if (!label || labels.has(label)) {
+      changed = true;
+      continue;
+    }
+    labels.add(label);
+    if (label !== option.label || description !== option.description) {
+      changed = true;
+      options.push({ ...option, label, description });
+    } else {
+      options.push(option);
+    }
+  }
+  return changed ? { ...question, options, custom } : question;
+}
+
 // ../agent-runtime/src/opencode.ts
 import { createOpencodeClient } from "@opencode-ai/sdk";
 
@@ -426,7 +456,7 @@ function questionRequest(raw) {
     kind: "question",
     createdAt: null,
     toolCallId: asString(tool.callID),
-    questions: questions.map((question, index) => ({
+    questions: questions.map((question, index) => normalizeQuestion({
       key: `q${index}`,
       header: asString(question.header) ?? `Question ${index + 1}`,
       question: asString(question.question) ?? "",
@@ -435,7 +465,7 @@ function questionRequest(raw) {
         description: asString(option.description) ?? ""
       })),
       multiple: question.multiple === true,
-      custom: question.custom === true
+      custom: question.custom !== false
     }))
   };
 }
@@ -714,7 +744,7 @@ function formRequest(raw) {
     toolCallId: asString(tool.id) ?? asString(tool.callID),
     questions: fields.map((field, index) => {
       const key = asString(field.key) ?? `q${index}`;
-      return {
+      return normalizeQuestion({
         key,
         header: asString(field.title) ?? key,
         question: asString(field.description) ?? asString(field.title) ?? key,
@@ -728,8 +758,8 @@ function formRequest(raw) {
           };
         }),
         multiple: field.type === "multiselect",
-        custom: field.custom === true
-      };
+        custom: field.custom !== false
+      });
     })
   };
 }
@@ -842,6 +872,9 @@ function questionAnswers(request, answers) {
     throw new Error(`Answers must cover exactly the question keys ${JSON.stringify(keys)}`);
   }
   return request.questions.map((question) => {
+    if (!question.options.length && !question.custom) {
+      throw new Error(`Question "${question.key}" has no options and does not accept custom answers`);
+    }
     const selected = answers[question.key];
     if (!Array.isArray(selected) || !selected.length || !question.multiple && selected.length !== 1) {
       throw new Error(`Question "${question.key}" requires ${question.multiple ? "at least one answer" : "one answer"}`);

package/dist/types.d.ts

@@ -309,6 +309,7 @@ export type AgentQuestionOption = {
     label: string;
     description: string;
 };
+/** Options are normalised: OpenCode's own type-your-own entry, duplicates and blank labels never appear. */
 export type AgentQuestion = {
     /** Identifies this question in `AgentRunReply.answers`. Unique within a request. */
     key: string;
@@ -317,7 +318,10 @@ export type AgentQuestion = {
     options: AgentQuestionOption[];
     /** More than one option may be selected. */
     multiple: boolean;
-    /** A free-text answer outside `options` is accepted. */
+    /**
+     * A free-text answer outside `options` is accepted.
+     * Defaults to true, matching OpenCode; false only when the agent sets it.
+     */
     custom: boolean;
 };
 /** The agent called OpenCode's `question` tool. Answer every question in one reply. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gitterm/sdk",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "files": [
     "dist"
   ],