@agentclientprotocol/claude-agent-acp 0.76.1-preview.8 → 0.77.1-preview.1

package/dist/elicitation.d.ts

@@ -57,8 +57,9 @@ export declare function extractAskUserQuestions(input: Record<string, unknown>):
  *
  * Each question is followed by its own optional free-text "custom answer" field
  * (`question_<n>_custom`), mirroring the CLI's per-question "Other" box: the
- * user can type their own answer instead of (or, for a multi-select question,
- * as well as) picking an option, scoped to that specific question. Nothing is
+ * user can type their own answer instead of picking an option, add it to a
+ * multi-select's picks, or attach it as a note to a single-select's pick (see
+ * `applyAskElicitationResponse`), scoped to that specific question. Nothing is
  * marked required, so the user can also just skip — matching the built-in tool,
  * which always offers Skip + a free-text box.
  */
@@ -77,11 +78,15 @@ export type AskUserQuestionOutcome = {
  * `answers` as a `{ [questionText]: label }` map — the key shape the tool's own
  * `call()` reads — with multi-selects comma-joined in the CLI's own quoted form
  * (see `joinMultiSelectAnswer`). A non-empty per-question custom-answer field
- * (`question_<n>_custom`) replaces the selection of a single-select question,
- * since the user typed their own answer instead of picking one, and joins the
- * selection of a multi-select question, where the two fields are independent
- * and filling both means both. Decline yields empty answers (the model is told
- * the user skipped rather than the turn aborting); cancel — and any
+ * (`question_<n>_custom`) joins the selection of a multi-select question, where
+ * the two fields are independent and filling both means both. For a
+ * single-select question it is the answer when nothing was picked (the user
+ * typed their own instead), and otherwise travels beside the pick as the
+ * tool's own per-question `annotations[question].notes` — the slot the CLI
+ * uses for free text attached to a selection and renders to the model as
+ * `"Q"="A" notes: ...` — so a client that presents the box as a notes field
+ * cannot make the selection disappear. Decline yields empty answers (the model
+ * is told the user skipped rather than the turn aborting); cancel — and any
  * custom/future action we don't understand — aborts the tool call.
  */
 export declare function applyAskElicitationResponse(response: CreateElicitationResponse, toolInput: Record<string, unknown>, questions: AskUserQuestion[]): AskUserQuestionOutcome;

package/dist/elicitation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACV,wBAAwB,EAKzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,6CAA6C,CAAC;AAErD;;;;;;;;;;;;;GAaG;AAEH,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAChB,wBAAwB,GAAG,IAAI,CAyBjC;AAgBD;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,yBAAyB,GAClC,iBAAiB,CAUnB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,EAAE,GAAG,IAAI,CAUhG;AAgCD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,eAAe,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,wBAAwB,CA6D1B;AAED,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAChC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAevF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,eAAe,EAAE,GAC3B,sBAAsB,CA2CxB;AAgBD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,qBAAqB,GAAG,IAAI,CAW9B;AAYD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,qBAAqB,EAC7B,SAAS,EAAE,MAAM,GAChB,wBAAwB,CA+B1B;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,CAG7F"}
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EACV,wBAAwB,EAKzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAC5F,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,6CAA6C,CAAC;AAErD;;;;;;;;;;;;;GAaG;AAEH,yDAAyD;AACzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,kBAAkB,EAC3B,SAAS,EAAE,MAAM,GAChB,wBAAwB,GAAG,IAAI,CAyBjC;AAgBD;;;GAGG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,yBAAyB,GAClC,iBAAiB,CAUnB;AAED;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,EAAE,GAAG,IAAI,CAUhG;AAgCD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,eAAe,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,wBAAwB,CA6D1B;AAED,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAChC;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,QAAQ,CAAA;CAAE,CAAC;AAevF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,yBAAyB,EACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,SAAS,EAAE,eAAe,EAAE,GAC3B,sBAAsB,CAgExB;AAgBD;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,4BAA4B,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,qBAAqB,GAAG,IAAI,CAW9B;AAYD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,qBAAqB,EAC7B,SAAS,EAAE,MAAM,GAChB,wBAAwB,CA+B1B;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,CAG7F"}

package/dist/elicitation.js

@@ -108,8 +108,9 @@ const CUSTOM_ANSWER_META_KEY = "_askUserQuestionCustomAnswer";
  *
  * Each question is followed by its own optional free-text "custom answer" field
  * (`question_<n>_custom`), mirroring the CLI's per-question "Other" box: the
- * user can type their own answer instead of (or, for a multi-select question,
- * as well as) picking an option, scoped to that specific question. Nothing is
+ * user can type their own answer instead of picking an option, add it to a
+ * multi-select's picks, or attach it as a note to a single-select's pick (see
+ * `applyAskElicitationResponse`), scoped to that specific question. Nothing is
  * marked required, so the user can also just skip — matching the built-in tool,
  * which always offers Skip + a free-text box.
  */
@@ -146,7 +147,7 @@ export function askUserQuestionsToCreateRequest(questions, sessionId, toolCallId
             title: "Other",
             description: question.multiSelect
                 ? "Type your own answer to add to your selection above (optional)."
-                : "Type your own answer instead of choosing an option above (optional).",
+                : "Type your own answer, or add a note to the option you chose above (optional).",
             _meta: {
                 [CUSTOM_ANSWER_META_KEY]: {
                     questionId: questionFieldKey(index),
@@ -187,11 +188,15 @@ function joinMultiSelectAnswer(items) {
  * `answers` as a `{ [questionText]: label }` map — the key shape the tool's own
  * `call()` reads — with multi-selects comma-joined in the CLI's own quoted form
  * (see `joinMultiSelectAnswer`). A non-empty per-question custom-answer field
- * (`question_<n>_custom`) replaces the selection of a single-select question,
- * since the user typed their own answer instead of picking one, and joins the
- * selection of a multi-select question, where the two fields are independent
- * and filling both means both. Decline yields empty answers (the model is told
- * the user skipped rather than the turn aborting); cancel — and any
+ * (`question_<n>_custom`) joins the selection of a multi-select question, where
+ * the two fields are independent and filling both means both. For a
+ * single-select question it is the answer when nothing was picked (the user
+ * typed their own instead), and otherwise travels beside the pick as the
+ * tool's own per-question `annotations[question].notes` — the slot the CLI
+ * uses for free text attached to a selection and renders to the model as
+ * `"Q"="A" notes: ...` — so a client that presents the box as a notes field
+ * cannot make the selection disappear. Decline yields empty answers (the model
+ * is told the user skipped rather than the turn aborting); cancel — and any
  * custom/future action we don't understand — aborts the tool call.
  */
 export function applyAskElicitationResponse(response, toolInput, questions) {
@@ -205,6 +210,7 @@ export function applyAskElicitationResponse(response, toolInput, questions) {
     // Typed against the tool's own output schema so the answer/response shapes
     // stay in sync with what the built-in tool's call() expects to read back.
     const answers = {};
+    const annotations = {};
     questions.forEach((question, index) => {
         const custom = content[questionCustomFieldKey(index)];
         const customText = typeof custom === "string" ? custom.trim() : "";
@@ -214,21 +220,42 @@ export function applyAskElicitationResponse(response, toolInput, questions) {
             : Array.isArray(value)
                 ? value.filter((item) => item !== undefined && item !== null && item !== "").map(String)
                 : [String(value)];
-        // A single-select question is answered by exactly one thing, so a typed
-        // custom answer replaces the pick: the user wrote their own answer instead
-        // of choosing an option. A multi-select is additive, and the form offers
-        // the selection and the custom box as independent fields — a user who
-        // fills both means both, so the typed answer joins the checked options.
-        const items = customText === "" ? picks : question.multiSelect ? [...picks, customText] : [customText];
-        // A single-select normally holds one item; the plain join only matters if a
-        // client hands back an array for it, and then mirrors the old behavior.
-        const text = question.multiSelect ? joinMultiSelectAnswer(items) : items.join(", ");
-        if (text === "") {
+        // A multi-select is additive, and the form offers the selection and the
+        // custom box as independent fields — a user who fills both means both, so
+        // the typed answer joins the checked options.
+        if (question.multiSelect) {
+            const text = joinMultiSelectAnswer(customText === "" ? picks : [...picks, customText]);
+            if (text !== "") {
+                answers[question.question] = text;
+            }
+            return;
+        }
+        // A single-select question is answered by exactly one thing. With no option
+        // picked, the typed text is that answer (the CLI's "Other"). With an option
+        // picked as well, the pick stays the answer and the text rides along as the
+        // tool's per-question `notes` annotation, so neither is lost. A single-select
+        // normally holds one item; the plain join only matters if a client hands
+        // back an array for it, and then mirrors the old behavior.
+        const picked = picks.join(", ");
+        if (picked === "") {
+            if (customText !== "") {
+                answers[question.question] = customText;
+            }
             return;
         }
-        answers[question.question] = text;
+        answers[question.question] = picked;
+        if (customText !== "") {
+            annotations[question.question] = { notes: customText };
+        }
     });
-    return { action: "answered", updatedInput: { ...toolInput, answers } };
+    return {
+        action: "answered",
+        updatedInput: {
+            ...toolInput,
+            answers,
+            ...(Object.keys(annotations).length > 0 ? { annotations } : {}),
+        },
+    };
 }
 /**
  * Coerce an arbitrary MCP `requestedSchema` into an ACP `ElicitationSchema`.

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.76.1-preview.8",
+  "version": "0.77.1-preview.1",
   "description": "An ACP-compatible coding agent powered by the Claude Agent SDK (TypeScript)",
   "main": "dist/lib.js",
   "types": "dist/lib.d.ts",