@adecore/agents 0.31.9 → 0.31.11

package/dist/chat/fixtures/grok-1.0.62-usage.json

@@ -0,0 +1,475 @@
+{
+  "version": "Grok 1.0.62, `grok --no-auto-update agent stdio`",
+  "source": "Recorded from the real CLI on 2026-10-21 in an empty folder: initialize, session/new and one session/prompt for \"Reply with the single word ok.\". Only session/update frames are kept, each with the _meta of its notification, which is where the CLI counts the context; the notifications it sends under _x.ai are left out. The command list is cut, the _meta of initialize and session/new left out, the session id and the folder replaced. Every other field is as the CLI sent it.",
+  "sessionId": "grok-session-1",
+  "initialize": {
+    "protocolVersion": 1,
+    "agentCapabilities": {
+      "loadSession": true,
+      "promptCapabilities": {
+        "image": false,
+        "audio": false,
+        "embeddedContext": true
+      },
+      "mcpCapabilities": {
+        "http": true,
+        "sse": true
+      },
+      "sessionCapabilities": {
+        "list": {},
+        "resume": {},
+        "close": {}
+      },
+      "auth": {},
+      "_meta": {
+        "x.ai/fs_notify": true,
+        "x.ai/hooks": {
+          "blockingEvents": [
+            "pre_tool_use",
+            "stop",
+            "subagent_stop"
+          ],
+          "decisions": [
+            "deny",
+            "block"
+          ],
+          "stopSignals": [
+            "continue",
+            "stopReason",
+            "additionalContext"
+          ]
+        },
+        "x.ai/capabilities": {
+          "toolOverrides": {
+            "x_keyword_search": true,
+            "x_semantic_search": true,
+            "x_user_search": false,
+            "x_thread_fetch": false
+          }
+        }
+      }
+    },
+    "authMethods": [
+      {
+        "id": "cached_token",
+        "name": "cached_token",
+        "description": "Cached token from ~/.grok/auth.json"
+      },
+      {
+        "id": "grok.com",
+        "name": "Grok",
+        "description": "Sign in with Grok"
+      }
+    ]
+  },
+  "sessionNew": {
+    "sessionId": "grok-session-1",
+    "models": {
+      "currentModelId": "grok-4.7",
+      "availableModels": [
+        {
+          "modelId": "grok-4.7",
+          "name": "Grok 4.7",
+          "description": "SpaceXAI's latest frontier model",
+          "_meta": {
+            "totalContextTokens": 256000,
+            "agentType": "grok-build-plan",
+            "supportsReasoningEffort": true,
+            "reasoningEffort": "high",
+            "reasoningEfforts": [
+              {
+                "id": "xhigh",
+                "value": "xhigh",
+                "label": "Extra High",
+                "description": "Maximum reasoning for the hardest tasks.",
+                "default": false
+              },
+              {
+                "id": "high",
+                "value": "high",
+                "label": "High",
+                "description": "Thorough reasoning and quality. Recommended.",
+                "default": true
+              },
+              {
+                "id": "medium",
+                "value": "medium",
+                "label": "Medium",
+                "description": "Strong quality with a faster turnaround.",
+                "default": false
+              },
+              {
+                "id": "low",
+                "value": "low",
+                "label": "Low",
+                "description": "Fastest responses. Best for simple tasks.",
+                "default": false
+              }
+            ],
+            "contextWindows": [
+              256000,
+              500000
+            ]
+          }
+        },
+        {
+          "modelId": "grok-4.7-build-fast",
+          "name": "Grok 4.7 Fast",
+          "description": "Fast variant. 2x the price.",
+          "_meta": {
+            "totalContextTokens": 256000,
+            "agentType": "grok-build-plan",
+            "supportsReasoningEffort": true,
+            "reasoningEffort": "high",
+            "reasoningEfforts": [
+              {
+                "id": "xhigh",
+                "value": "xhigh",
+                "label": "Extra High",
+                "description": "Maximum reasoning for the hardest tasks.",
+                "default": false
+              },
+              {
+                "id": "high",
+                "value": "high",
+                "label": "High",
+                "description": "Thorough reasoning and quality. Recommended.",
+                "default": true
+              },
+              {
+                "id": "medium",
+                "value": "medium",
+                "label": "Medium",
+                "description": "Strong quality with a faster turnaround.",
+                "default": false
+              },
+              {
+                "id": "low",
+                "value": "low",
+                "label": "Low",
+                "description": "Fastest responses. Best for simple tasks.",
+                "default": false
+              }
+            ],
+            "contextWindows": [
+              256000,
+              500000
+            ]
+          }
+        },
+        {
+          "modelId": "grok-4.6",
+          "name": "Grok 4.6",
+          "_meta": {
+            "totalContextTokens": 256000,
+            "agentType": "grok-build-plan",
+            "supportsReasoningEffort": true,
+            "reasoningEffort": "high",
+            "reasoningEfforts": [
+              {
+                "id": "xhigh",
+                "value": "xhigh",
+                "label": "Extra High",
+                "description": "Highest effort and reasoning level",
+                "default": false
+              },
+              {
+                "id": "high",
+                "value": "high",
+                "label": "High",
+                "description": "Higher implementation quality with extensive reasoning",
+                "default": true
+              },
+              {
+                "id": "medium",
+                "value": "medium",
+                "label": "Medium",
+                "description": "Balanced effort with standard implementation and testing",
+                "default": false
+              },
+              {
+                "id": "low",
+                "value": "low",
+                "label": "Low",
+                "description": "Quick, fast implementations",
+                "default": false
+              }
+            ],
+            "contextWindows": [
+              256000,
+              500000
+            ]
+          }
+        },
+        {
+          "modelId": "grok-4.5",
+          "name": "Grok 4.5",
+          "_meta": {
+            "totalContextTokens": 256000,
+            "agentType": "grok-build-plan",
+            "supportsReasoningEffort": true,
+            "reasoningEffort": "high",
+            "reasoningEfforts": [
+              {
+                "id": "high",
+                "value": "high",
+                "label": "High",
+                "description": "Highest implementation quality with extensive reasoning",
+                "default": true
+              },
+              {
+                "id": "medium",
+                "value": "medium",
+                "label": "Medium",
+                "description": "Balanced effort with standard implementation and testing",
+                "default": false
+              },
+              {
+                "id": "low",
+                "value": "low",
+                "label": "Low",
+                "description": "Quick, fast implementations",
+                "default": false
+              }
+            ],
+            "contextWindows": [
+              256000,
+              500000
+            ]
+          }
+        }
+      ]
+    },
+    "configOptions": [
+      {
+        "id": "model",
+        "name": "Model",
+        "category": "model",
+        "type": "select",
+        "currentValue": "grok-4.7",
+        "options": [
+          {
+            "value": "grok-4.7",
+            "name": "Grok 4.7"
+          },
+          {
+            "value": "grok-4.7-build-fast",
+            "name": "Grok 4.7 Fast"
+          },
+          {
+            "value": "grok-4.6",
+            "name": "Grok 4.6"
+          },
+          {
+            "value": "grok-4.5",
+            "name": "Grok 4.5"
+          }
+        ]
+      },
+      {
+        "id": "reasoning_effort",
+        "name": "Reasoning Effort",
+        "category": "thought_level",
+        "type": "select",
+        "currentValue": "high",
+        "options": [
+          {
+            "value": "xhigh",
+            "name": "Extra High",
+            "description": "Maximum reasoning for the hardest tasks."
+          },
+          {
+            "value": "high",
+            "name": "High",
+            "description": "Thorough reasoning and quality. Recommended."
+          },
+          {
+            "value": "medium",
+            "name": "Medium",
+            "description": "Strong quality with a faster turnaround."
+          },
+          {
+            "value": "low",
+            "name": "Low",
+            "description": "Fastest responses. Best for simple tasks."
+          }
+        ]
+      }
+    ]
+  },
+  "commands": [
+    {
+      "name": "compact",
+      "description": "Compress conversation history to save context window",
+      "input": null
+    },
+    {
+      "name": "context",
+      "description": "Show context window usage and session stats",
+      "input": null
+    }
+  ],
+  "setConfigOption": {},
+  "promptUpdates": [
+    {
+      "update": {
+        "sessionUpdate": "agent_thought_chunk",
+        "content": {
+          "type": "text",
+          "text": "The user wants a single-word"
+        }
+      },
+      "_meta": {
+        "totalTokens": 1457,
+        "requestTrimmedTokens": 0,
+        "eventId": "grok-session-1-6",
+        "agentTimestampMs": 1792595946046,
+        "promptId": "05ec1787-0632-4aaf-a44a-22a97595a865",
+        "streamStartMs": 1792595945078,
+        "turnStartMs": 1792595943704,
+        "updateType": "AgentThoughtChunk",
+        "chunkId": 1
+      }
+    },
+    {
+      "update": {
+        "sessionUpdate": "agent_thought_chunk",
+        "content": {
+          "type": "text",
+          "text": " reply: \"ok\"."
+        }
+      },
+      "_meta": {
+        "totalTokens": 1457,
+        "requestTrimmedTokens": 0,
+        "eventId": "grok-session-1-7",
+        "agentTimestampMs": 1792595946062,
+        "promptId": "05ec1787-0632-4aaf-a44a-22a97595a865",
+        "streamStartMs": 1792595945078,
+        "turnStartMs": 1792595943704,
+        "updateType": "AgentThoughtChunk",
+        "chunkId": 2
+      }
+    },
+    {
+      "update": {
+        "sessionUpdate": "agent_message_chunk",
+        "content": {
+          "type": "text",
+          "text": "ok"
+        }
+      },
+      "_meta": {
+        "totalTokens": 1457,
+        "requestTrimmedTokens": 0,
+        "eventId": "grok-session-1-8",
+        "agentTimestampMs": 1792595946065,
+        "promptId": "05ec1787-0632-4aaf-a44a-22a97595a865",
+        "streamStartMs": 1792595945078,
+        "turnStartMs": 1792595943704,
+        "updateType": "AgentMessageChunk",
+        "chunkId": 3
+      }
+    },
+    {
+      "update": {
+        "sessionUpdate": "available_commands_update",
+        "availableCommands": [
+          {
+            "name": "compact",
+            "description": "Compress conversation history to save context window",
+            "input": null
+          },
+          {
+            "name": "context",
+            "description": "Show context window usage and session stats",
+            "input": null
+          }
+        ],
+        "_meta": {
+          "tools": [
+            "run_terminal_command",
+            "read_file",
+            "search_replace",
+            "list_dir",
+            "grep",
+            "kill_command_or_subagent",
+            "todo_write",
+            "get_command_or_subagent_output",
+            "spawn_subagent",
+            "scheduler_create",
+            "scheduler_delete",
+            "scheduler_list",
+            "monitor",
+            "search_tool",
+            "use_tool",
+            "workflow",
+            "enter_plan_mode",
+            "exit_plan_mode",
+            "ask_user_question",
+            "send_feedback",
+            "web_search",
+            "web_fetch",
+            "image_gen",
+            "image_edit",
+            "image_to_video",
+            "reference_to_video",
+            "write"
+          ]
+        }
+      },
+      "_meta": {
+        "totalTokens": 21939,
+        "requestTrimmedTokens": 0,
+        "eventId": "grok-session-1-9",
+        "agentTimestampMs": 1792595946147,
+        "promptId": "05ec1787-0632-4aaf-a44a-22a97595a865",
+        "streamStartMs": 1792595945078,
+        "turnStartMs": 1792595943704,
+        "updateType": "AvailableCommandsUpdate",
+        "updateParams": {
+          "commandsCount": 63
+        }
+      }
+    }
+  ],
+  "promptResponse": {
+    "stopReason": "end_turn",
+    "_meta": {
+      "sessionId": "grok-session-1",
+      "requestId": "05ec1787-0632-4aaf-a44a-22a97595a865",
+      "promptId": "05ec1787-0632-4aaf-a44a-22a97595a865",
+      "totalTokens": 21939,
+      "modelId": "grok-4.7",
+      "inputTokens": 21847,
+      "outputTokens": 83,
+      "cachedReadTokens": 2176,
+      "reasoningTokens": 82,
+      "usage": {
+        "inputTokens": 21847,
+        "outputTokens": 83,
+        "totalTokens": 21930,
+        "cachedReadTokens": 2176,
+        "cacheCreationTokens": 0,
+        "reasoningTokens": 82,
+        "modelCalls": 1,
+        "apiDurationMs": 2092,
+        "costUsdTicks": 409280000,
+        "modelUsage": {
+          "grok-4.7-build": {
+            "inputTokens": 21847,
+            "outputTokens": 83,
+            "totalTokens": 21930,
+            "cachedReadTokens": 2176,
+            "cacheCreationTokens": 0,
+            "reasoningTokens": 82,
+            "modelCalls": 1,
+            "apiDurationMs": 2092,
+            "costUsdTicks": 409280000
+          }
+        },
+        "numTurns": 1
+      }
+    }
+  }
+}

package/dist/providers/acp-agent-state.js

@@ -11,6 +11,19 @@ function adoptableModels(info) {
         .filter((model) => model.id !== '' && !model.id.startsWith('-'))
         .map((model) => ({ slug: model.id, name: model.name, ...(model.contextWindow === null ? {} : { contextWindow: model.contextWindow }) }));
 }
+/*
+ * An agent may name its choices in lowercase, as Copilot CLI 1.0.101 names its efforts; a person reads them with a
+ * capital like every other label. Also applied to what a store kept from before, so only the labels change, never the ids.
+ */
+function capitalized(option) {
+    if (option.type !== 'select') {
+        return option;
+    }
+    return {
+        ...option,
+        choices: option.choices.map((choice) => ({ ...choice, label: choice.label.charAt(0).toLocaleUpperCase('en') + choice.label.slice(1) }))
+    };
+}
 /* The reasoning effort a session offers, as the `effort` option the composer draws for every provider. */
 function effortOption(info) {
     const level = info.thoughtLevel;
@@ -138,7 +151,7 @@ export class AcpAgentState {
             return false;
         }
         this.adopted = adopted;
-        return this.options.catalog.adopt(adopted.models, adopted.defaultModel, adopted.options);
+        return this.options.catalog.adopt(adopted.models, adopted.defaultModel, adopted.options.map(capitalized));
     }
     /* Saves and tells the listeners once something changed. */
     settle(changed) {

package/dist/providers/catalog.js

@@ -69,7 +69,8 @@ export class ModelCatalog {
             legacy: model.legacy === true,
             isDefault: model.slug === this.data.defaultModel,
             options: this.profileOf(model.slug)?.options ?? [],
-            ...(model.minCliVersion === undefined ? {} : { minCliVersion: model.minCliVersion })
+            ...(model.minCliVersion === undefined ? {} : { minCliVersion: model.minCliVersion }),
+            ...(model.tools === undefined ? {} : { tools: model.tools })
         }));
     }
     /* What a person reads for a model, so an error in a thread names it the way the picker does. */

package/dist/testing/fake-acp-capture.d.ts

@@ -7,5 +7,6 @@ export interface AcpCapture {
     setConfigOption: unknown;
     promptUpdates: unknown[];
     promptResponse: unknown;
+    titleFromPrompt?: boolean;
 }
-export declare function fakeAcpCapture(capture: AcpCapture): FakeCli;
+export declare function fakeAcpCapture(capture: AcpCapture, answers?: unknown[]): FakeCli;

package/dist/testing/fake-acp-capture.js

@@ -1,18 +1,43 @@
-export function fakeAcpCapture(capture) {
+/* `answers` collects the client's answer to every permission request, in order. */
+export function fakeAcpCapture(capture, answers = []) {
     return (io) => {
         const send = (frame) => {
             io.out({ jsonrpc: '2.0', ...frame });
         };
         const update = (fields) => {
-            send({ method: 'session/update', params: { sessionId: capture.sessionId, update: fields } });
+            const notification = fields.update === undefined ? { update: fields } : fields;
+            send({ method: 'session/update', params: { sessionId: capture.sessionId, ...notification } });
+        };
+        let waiting = null;
+        let nextRpcId = 0;
+        const play = (updates, promptId, text) => {
+            for (const [index, fields] of updates.entries()) {
+                const permission = fields.permission;
+                if (permission !== undefined) {
+                    const rpcId = nextRpcId++;
+                    waiting = { rpcId, rest: updates.slice(index + 1), promptId, text };
+                    send({ id: rpcId, method: 'session/request_permission', params: permission });
+                    return;
+                }
+                const named = capture.titleFromPrompt === true && fields.sessionUpdate === 'session_info_update';
+                update(named ? { ...fields, title: text } : fields);
+            }
+            send({ id: promptId, result: capture.promptResponse });
         };
         return {
             onLine: (line) => {
                 const frame = JSON.parse(line);
                 const id = frame.id;
                 switch (frame.method) {
-                    case undefined:
+                    case undefined: {
+                        const answered = waiting;
+                        if (answered !== null && id === answered.rpcId) {
+                            waiting = null;
+                            answers.push(frame.result ?? frame.error);
+                            play(answered.rest, answered.promptId, answered.text);
+                        }
                         return;
+                    }
                     case 'initialize':
                         send({ id, result: capture.initialize });
                         return;
@@ -29,12 +54,7 @@ export function fakeAcpCapture(capture) {
                         return;
                     case 'session/prompt': {
                         const blocks = Array.isArray(frame.params?.prompt) ? frame.params.prompt : [];
-                        const text = blocks.find((block) => block.type === 'text')?.text;
-                        for (const fields of capture.promptUpdates) {
-                            const named = fields.sessionUpdate === 'session_info_update';
-                            update(named ? { ...fields, title: text } : fields);
-                        }
-                        send({ id, result: capture.promptResponse });
+                        play(capture.promptUpdates, id, blocks.find((block) => block.type === 'text')?.text);
                         return;
                     }
                     case 'session/cancel':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents",
-  "version": "0.31.9",
+  "version": "0.31.11",
   "description": "Node-compatible agent chat hosts, providers, accounts, usage and durable task coordination.",
   "type": "module",
   "exports": {
@@ -81,8 +81,8 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/agent-contracts": "0.31.9",
-    "@adecore/intelligent-ui": "0.31.9",
+    "@adecore/agent-contracts": "0.31.11",
+    "@adecore/intelligent-ui": "0.31.11",
     "zod": "^4.6.5"
   },
   "devDependencies": {

package/src/chat/acp-backend.ts

@@ -63,6 +63,9 @@ export interface AcpAgentSpec {
     onContextReport?(): void;
     // The slash commands a session offers (without the slash), each time the agent lists them.
     onCommands?(commands: string[]): void;
+    // True takes the session titles the agent sends (`session_info_update`) as the chat's suggested title. Absent leaves
+    // naming the chat to the host, since an agent may rename the session after every turn.
+    adoptTitles?: boolean;
     // A permission request the host answers itself, in any runtime mode: true allows it once without asking the
     // person, for a call the host already guards. A throw counts as false.
     autoAllow?(request: AcpPermissionRequest): boolean;
@@ -121,7 +124,7 @@ export class AcpBackend implements ChatBackend {
         this.host = host;
         this.spec = spec;
         this.client = spec.client ?? DEFAULT_ACP_CLIENT;
-        this.protocol = new AcpProtocol(launch.generation, spec.modes ?? {}, acpStopWords(spec.name));
+        this.protocol = new AcpProtocol(launch.generation, spec.modes ?? {}, acpStopWords(spec.name), spec.adoptTitles === true);
     }
 
     get running(): boolean {
@@ -420,7 +423,7 @@ export class AcpBackend implements ChatBackend {
                 if (this.transport === transport && this.prompt === turn) {
                     this.prompt = null;
                     this.report(result);
-                    this.emitAll(this.protocol.finish(turn.cancelled ? { stopReason: 'cancelled' } : result, turn.promptId));
+                    this.emitAll(this.protocol.finish(result, turn.promptId, turn.cancelled));
                 }
             })
             .catch((error: unknown) => {
@@ -469,7 +472,11 @@ export class AcpBackend implements ChatBackend {
         if (!answer) {
             return false;
         }
-        return this.respond(requestId, answer.rpcId, answer.result);
+        if (!this.respond(requestId, answer.rpcId, answer.result)) {
+            return false;
+        }
+        this.emitAll(answer.events);
+        return true;
     }
 
     /* ACP asks no questions of its own; an agent asks in its message and the next prompt answers. */