@google/gemini-cli-core 0.31.0 → 0.33.0-nightly.20260228.1ca5c05d0

package/dist/src/agents/a2aUtils.js

@@ -3,15 +3,142 @@
  * Copyright 2025 Google LLC
  * SPDX-License-Identifier: Apache-2.0
  */
+/**
+ * Reassembles incremental A2A streaming updates into a coherent result.
+ * Shows sequential status/messages followed by all reassembled artifacts.
+ */
+export class A2AResultReassembler {
+    messageLog = [];
+    artifacts = new Map();
+    artifactChunks = new Map();
+    /**
+     * Processes a new chunk from the A2A stream.
+     */
+    update(chunk) {
+        if (!('kind' in chunk))
+            return;
+        switch (chunk.kind) {
+            case 'status-update':
+                this.pushMessage(chunk.status?.message);
+                break;
+            case 'artifact-update':
+                if (chunk.artifact) {
+                    const id = chunk.artifact.artifactId;
+                    const existing = this.artifacts.get(id);
+                    if (chunk.append && existing) {
+                        for (const part of chunk.artifact.parts) {
+                            existing.parts.push(structuredClone(part));
+                        }
+                    }
+                    else {
+                        this.artifacts.set(id, structuredClone(chunk.artifact));
+                    }
+                    const newText = extractPartsText(chunk.artifact.parts, '');
+                    let chunks = this.artifactChunks.get(id);
+                    if (!chunks) {
+                        chunks = [];
+                        this.artifactChunks.set(id, chunks);
+                    }
+                    if (chunk.append) {
+                        chunks.push(newText);
+                    }
+                    else {
+                        chunks.length = 0;
+                        chunks.push(newText);
+                    }
+                }
+                break;
+            case 'task':
+                this.pushMessage(chunk.status?.message);
+                if (chunk.artifacts) {
+                    for (const art of chunk.artifacts) {
+                        this.artifacts.set(art.artifactId, structuredClone(art));
+                        this.artifactChunks.set(art.artifactId, [
+                            extractPartsText(art.parts, ''),
+                        ]);
+                    }
+                }
+                // History Fallback: Some agent implementations do not populate the
+                // status.message in their final terminal response, instead archiving
+                // the final answer in the task's history array. To ensure we don't
+                // present an empty result, we fallback to the most recent agent message
+                // in the history only when the task is terminal and no other content
+                // (message log or artifacts) has been reassembled.
+                if (isTerminalState(chunk.status?.state) &&
+                    this.messageLog.length === 0 &&
+                    this.artifacts.size === 0 &&
+                    chunk.history &&
+                    chunk.history.length > 0) {
+                    const lastAgentMsg = [...chunk.history]
+                        .reverse()
+                        .find((m) => m.role?.toLowerCase().includes('agent'));
+                    if (lastAgentMsg) {
+                        this.pushMessage(lastAgentMsg);
+                    }
+                }
+                break;
+            case 'message': {
+                this.pushMessage(chunk);
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    pushMessage(message) {
+        if (!message)
+            return;
+        const text = extractPartsText(message.parts, '\n');
+        if (text && this.messageLog[this.messageLog.length - 1] !== text) {
+            this.messageLog.push(text);
+        }
+    }
+    /**
+     * Returns a human-readable string representation of the current reassembled state.
+     */
+    toString() {
+        const joinedMessages = this.messageLog.join('\n\n');
+        const artifactsOutput = Array.from(this.artifacts.keys())
+            .map((id) => {
+            const chunks = this.artifactChunks.get(id);
+            const artifact = this.artifacts.get(id);
+            if (!chunks || !artifact)
+                return '';
+            const content = chunks.join('');
+            const header = artifact.name
+                ? `Artifact (${artifact.name}):`
+                : 'Artifact:';
+            return `${header}\n${content}`;
+        })
+            .filter(Boolean)
+            .join('\n\n');
+        if (joinedMessages && artifactsOutput) {
+            return `${joinedMessages}\n\n${artifactsOutput}`;
+        }
+        return joinedMessages || artifactsOutput;
+    }
+}
 /**
  * Extracts a human-readable text representation from a Message object.
  * Handles Text, Data (JSON), and File parts.
  */
 export function extractMessageText(message) {
-    if (!message) {
+    if (!message || !message.parts || !Array.isArray(message.parts)) {
+        return '';
+    }
+    return extractPartsText(message.parts, '\n');
+}
+/**
+ * Extracts text from an array of parts, joining them with the specified separator.
+ */
+function extractPartsText(parts, separator) {
+    if (!parts || parts.length === 0) {
         return '';
     }
-    return extractPartsText(message.parts);
+    return parts
+        .map((p) => extractPartText(p))
+        .filter(Boolean)
+        .join(separator);
 }
 /**
  * Extracts text from a single Part.
@@ -21,7 +148,6 @@ function extractPartText(part) {
         return part.text;
     }
     if (isDataPart(part)) {
-        // Attempt to format known data types if metadata exists, otherwise JSON stringify
         return `Data: ${JSON.stringify(part.data)}`;
     }
     if (isFilePart(part)) {
@@ -36,44 +162,6 @@ function extractPartText(part) {
     }
     return '';
 }
-/**
- * Extracts a clean, human-readable text summary from a Task object.
- * Includes the status message and any artifact content with context headers.
- * Technical metadata like ID and State are omitted for better clarity and token efficiency.
- */
-export function extractTaskText(task) {
-    const parts = [];
-    // Status Message
-    const statusMessageText = extractMessageText(task.status?.message);
-    if (statusMessageText) {
-        parts.push(statusMessageText);
-    }
-    // Artifacts
-    if (task.artifacts) {
-        for (const artifact of task.artifacts) {
-            const artifactContent = extractPartsText(artifact.parts);
-            if (artifactContent) {
-                const header = artifact.name
-                    ? `Artifact (${artifact.name}):`
-                    : 'Artifact:';
-                parts.push(`${header}\n${artifactContent}`);
-            }
-        }
-    }
-    return parts.join('\n\n');
-}
-/**
- * Extracts text from an array of parts.
- */
-function extractPartsText(parts) {
-    if (!parts || parts.length === 0) {
-        return '';
-    }
-    return parts
-        .map((p) => extractPartText(p))
-        .filter(Boolean)
-        .join('\n');
-}
 // Type Guards
 function isTextPart(part) {
     return part.kind === 'text';
@@ -84,30 +172,49 @@ function isDataPart(part) {
 function isFilePart(part) {
     return part.kind === 'file';
 }
+function isStatusUpdateEvent(result) {
+    return result.kind === 'status-update';
+}
+/**
+ * Returns true if the given state is a terminal state for a task.
+ */
+export function isTerminalState(state) {
+    return (state === 'completed' ||
+        state === 'failed' ||
+        state === 'canceled' ||
+        state === 'rejected');
+}
 /**
- * Extracts contextId and taskId from a Message or Task response.
+ * Extracts contextId and taskId from a Message, Task, or Update response.
  * Follows the pattern from the A2A CLI sample to maintain conversational continuity.
  */
 export function extractIdsFromResponse(result) {
     let contextId;
     let taskId;
-    if (result.kind === 'message') {
-        taskId = result.taskId;
-        contextId = result.contextId;
-    }
-    else if (result.kind === 'task') {
-        taskId = result.id;
-        contextId = result.contextId;
-        // If the task is in a final state (and not input-required), we clear the taskId
-        // so that the next interaction starts a fresh task (or keeps context without being bound to the old task).
-        if (result.status &&
-            result.status.state !== 'input-required' &&
-            (result.status.state === 'completed' ||
-                result.status.state === 'failed' ||
-                result.status.state === 'canceled')) {
-            taskId = undefined;
+    let clearTaskId = false;
+    if ('kind' in result) {
+        const kind = result.kind;
+        if (kind === 'message' || kind === 'artifact-update') {
+            taskId = result.taskId;
+            contextId = result.contextId;
+        }
+        else if (kind === 'task') {
+            taskId = result.id;
+            contextId = result.contextId;
+            if (isTerminalState(result.status?.state)) {
+                clearTaskId = true;
+            }
+        }
+        else if (isStatusUpdateEvent(result)) {
+            taskId = result.taskId;
+            contextId = result.contextId;
+            // Note: We ignore the 'final' flag here per A2A protocol best practices,
+            // as a stream can close while a task is still in a 'working' state.
+            if (isTerminalState(result.status?.state)) {
+                clearTaskId = true;
+            }
         }
     }
-    return { contextId, taskId };
+    return { contextId, taskId, clearTaskId };
 }
 //# sourceMappingURL=a2aUtils.js.map

package/dist/src/agents/a2aUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"a2aUtils.js","sourceRoot":"","sources":["../../../src/agents/a2aUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"a2aUtils.js","sourceRoot":"","sources":["../../../src/agents/a2aUtils.ts"],"names":[],"mappings":"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"}

package/dist/src/agents/a2aUtils.test.js

@@ -4,8 +4,24 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { describe, it, expect } from 'vitest';
-import { extractMessageText, extractTaskText, extractIdsFromResponse, } from './a2aUtils.js';
+import { extractMessageText, extractIdsFromResponse, isTerminalState, A2AResultReassembler, } from './a2aUtils.js';
 describe('a2aUtils', () => {
+    describe('isTerminalState', () => {
+        it('should return true for completed, failed, canceled, and rejected', () => {
+            expect(isTerminalState('completed')).toBe(true);
+            expect(isTerminalState('failed')).toBe(true);
+            expect(isTerminalState('canceled')).toBe(true);
+            expect(isTerminalState('rejected')).toBe(true);
+        });
+        it('should return false for working, submitted, input-required, auth-required, and unknown', () => {
+            expect(isTerminalState('working')).toBe(false);
+            expect(isTerminalState('submitted')).toBe(false);
+            expect(isTerminalState('input-required')).toBe(false);
+            expect(isTerminalState('auth-required')).toBe(false);
+            expect(isTerminalState('unknown')).toBe(false);
+            expect(isTerminalState(undefined)).toBe(false);
+        });
+    });
     describe('extractIdsFromResponse', () => {
         it('should extract IDs from a message response', () => {
             const message = {
@@ -17,7 +33,11 @@ describe('a2aUtils', () => {
                 parts: [],
             };
             const result = extractIdsFromResponse(message);
-            expect(result).toEqual({ contextId: 'ctx-1', taskId: 'task-1' });
+            expect(result).toEqual({
+                contextId: 'ctx-1',
+                taskId: 'task-1',
+                clearTaskId: false,
+            });
         });
         it('should extract IDs from an in-progress task response', () => {
             const task = {
@@ -27,7 +47,64 @@ describe('a2aUtils', () => {
                 status: { state: 'working' },
             };
             const result = extractIdsFromResponse(task);
-            expect(result).toEqual({ contextId: 'ctx-2', taskId: 'task-2' });
+            expect(result).toEqual({
+                contextId: 'ctx-2',
+                taskId: 'task-2',
+                clearTaskId: false,
+            });
+        });
+        it('should set clearTaskId true for terminal task response', () => {
+            const task = {
+                id: 'task-3',
+                contextId: 'ctx-3',
+                kind: 'task',
+                status: { state: 'completed' },
+            };
+            const result = extractIdsFromResponse(task);
+            expect(result.clearTaskId).toBe(true);
+        });
+        it('should set clearTaskId true for terminal status update', () => {
+            const update = {
+                kind: 'status-update',
+                contextId: 'ctx-4',
+                taskId: 'task-4',
+                final: true,
+                status: { state: 'failed' },
+            };
+            const result = extractIdsFromResponse(update);
+            expect(result.contextId).toBe('ctx-4');
+            expect(result.taskId).toBe('task-4');
+            expect(result.clearTaskId).toBe(true);
+        });
+        it('should extract IDs from an artifact-update event', () => {
+            const update = {
+                kind: 'artifact-update',
+                taskId: 'task-5',
+                contextId: 'ctx-5',
+                artifact: {
+                    artifactId: 'art-1',
+                    parts: [{ kind: 'text', text: 'artifact content' }],
+                },
+            };
+            const result = extractIdsFromResponse(update);
+            expect(result).toEqual({
+                contextId: 'ctx-5',
+                taskId: 'task-5',
+                clearTaskId: false,
+            });
+        });
+        it('should extract taskId from status update event', () => {
+            const update = {
+                kind: 'status-update',
+                taskId: 'task-6',
+                contextId: 'ctx-6',
+                final: false,
+                status: { state: 'working' },
+            };
+            const result = extractIdsFromResponse(update);
+            expect(result.taskId).toBe('task-6');
+            expect(result.contextId).toBe('ctx-6');
+            expect(result.clearTaskId).toBe(false);
         });
     });
     describe('extractMessageText', () => {
@@ -101,46 +178,112 @@ describe('a2aUtils', () => {
             })).toBe('');
         });
     });
-    describe('extractTaskText', () => {
-        it('should extract basic task info (clean)', () => {
-            const task = {
-                id: 'task-1',
-                contextId: 'ctx-1',
-                kind: 'task',
+    describe('A2AResultReassembler', () => {
+        it('should reassemble sequential messages and incremental artifacts', () => {
+            const reassembler = new A2AResultReassembler();
+            // 1. Initial status
+            reassembler.update({
+                kind: 'status-update',
+                taskId: 't1',
+                status: {
+                    state: 'working',
+                    message: {
+                        kind: 'message',
+                        role: 'agent',
+                        parts: [{ kind: 'text', text: 'Analyzing...' }],
+                    },
+                },
+            });
+            // 2. First artifact chunk
+            reassembler.update({
+                kind: 'artifact-update',
+                taskId: 't1',
+                append: false,
+                artifact: {
+                    artifactId: 'a1',
+                    name: 'Code',
+                    parts: [{ kind: 'text', text: 'print(' }],
+                },
+            });
+            // 3. Second status
+            reassembler.update({
+                kind: 'status-update',
+                taskId: 't1',
                 status: {
                     state: 'working',
                     message: {
                         kind: 'message',
                         role: 'agent',
-                        messageId: 'm1',
                         parts: [{ kind: 'text', text: 'Processing...' }],
                     },
                 },
-            };
-            const result = extractTaskText(task);
-            expect(result).not.toContain('ID: task-1');
-            expect(result).not.toContain('State: working');
-            expect(result).toBe('Processing...');
+            });
+            // 4. Second artifact chunk (append)
+            reassembler.update({
+                kind: 'artifact-update',
+                taskId: 't1',
+                append: true,
+                artifact: {
+                    artifactId: 'a1',
+                    parts: [{ kind: 'text', text: '"Done")' }],
+                },
+            });
+            const output = reassembler.toString();
+            expect(output).toBe('Analyzing...\n\nProcessing...\n\nArtifact (Code):\nprint("Done")');
         });
-        it('should extract artifacts with headers', () => {
-            const task = {
-                id: 'task-1',
-                contextId: 'ctx-1',
+        it('should fallback to history in a task chunk if no message or artifacts exist and task is terminal', () => {
+            const reassembler = new A2AResultReassembler();
+            reassembler.update({
+                kind: 'task',
+                status: { state: 'completed' },
+                history: [
+                    {
+                        kind: 'message',
+                        role: 'agent',
+                        parts: [{ kind: 'text', text: 'Answer from history' }],
+                    },
+                ],
+            });
+            expect(reassembler.toString()).toBe('Answer from history');
+        });
+        it('should NOT fallback to history in a task chunk if task is not terminal', () => {
+            const reassembler = new A2AResultReassembler();
+            reassembler.update({
+                kind: 'task',
+                status: { state: 'working' },
+                history: [
+                    {
+                        kind: 'message',
+                        role: 'agent',
+                        parts: [{ kind: 'text', text: 'Answer from history' }],
+                    },
+                ],
+            });
+            expect(reassembler.toString()).toBe('');
+        });
+        it('should not fallback to history if artifacts exist', () => {
+            const reassembler = new A2AResultReassembler();
+            reassembler.update({
                 kind: 'task',
                 status: { state: 'completed' },
                 artifacts: [
                     {
                         artifactId: 'art-1',
-                        name: 'Report',
-                        parts: [{ kind: 'text', text: 'This is the report.' }],
+                        name: 'Data',
+                        parts: [{ kind: 'text', text: 'Artifact Content' }],
                     },
                 ],
-            };
-            const result = extractTaskText(task);
-            expect(result).toContain('Artifact (Report):');
-            expect(result).toContain('This is the report.');
-            expect(result).not.toContain('Artifacts:');
-            expect(result).not.toContain('  - Name: Report');
+                history: [
+                    {
+                        kind: 'message',
+                        role: 'agent',
+                        parts: [{ kind: 'text', text: 'Answer from history' }],
+                    },
+                ],
+            });
+            const output = reassembler.toString();
+            expect(output).toContain('Artifact (Data):');
+            expect(output).not.toContain('Answer from history');
         });
     });
 });

package/dist/src/agents/a2aUtils.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"a2aUtils.test.js","sourceRoot":"","sources":["../../../src/agents/a2aUtils.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"a2aUtils.test.js","sourceRoot":"","sources":["../../../src/agents/a2aUtils.test.ts"],"names":[],"mappings":"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"}

package/dist/src/agents/generalist-agent.js

@@ -16,8 +16,7 @@ export const GeneralistAgent = (config) => ({
     kind: 'local',
     name: 'generalist',
     displayName: 'Generalist Agent',
-    description: "A general-purpose AI agent with access to all tools. Use it for complex tasks that don't fit into other specialized agents.",
-    experimental: true,
+    description: 'A general-purpose AI agent with access to all tools. Highly recommended for tasks that are turn-intensive or involve processing large amounts of data. Use this to keep the main session history lean and efficient. Excellent for: batch refactoring/error fixing across multiple files, running commands with high-volume output, and speculative investigations.',
     inputConfig: {
         inputSchema: {
             type: 'object',

package/dist/src/agents/generalist-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"generalist-agent.js","sourceRoot":"","sources":["../../../src/agents/generalist-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACpE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAc,EACsC,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EACT,6HAA6H;IAC/H,YAAY,EAAE,IAAI;IAClB,WAAW,EAAE;QACX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,0CAA0C;QACvD,MAAM,EAAE,qBAAqB;KAC9B;IACD,WAAW,EAAE;QACX,KAAK,EAAE,SAAS;KACjB;IACD,IAAI,UAAU;QACZ,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,eAAe,EAAE,CAAC;QACzD,OAAO;YACL,KAAK;SACN,CAAC;IACJ,CAAC;IACD,IAAI,YAAY;QACd,OAAO;YACL,YAAY,EAAE,mBAAmB,CAC/B,MAAM;YACN,cAAc,CAAC,SAAS;YACxB,wBAAwB,CAAC,KAAK,CAC/B;YACD,KAAK,EAAE,YAAY;SACpB,CAAC;IACJ,CAAC;IACD,SAAS,EAAE;QACT,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE,EAAE;KACb;CACF,CAAC,CAAC"}
+{"version":3,"file":"generalist-agent.js","sourceRoot":"","sources":["../../../src/agents/generalist-agent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CACpE,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,MAAc,EACsC,EAAE,CAAC,CAAC;IACxD,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EACT,qWAAqW;IACvW,WAAW,EAAE;QACX,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,gDAAgD;iBAC9D;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD,YAAY,EAAE;QACZ,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE,0CAA0C;QACvD,MAAM,EAAE,qBAAqB;KAC9B;IACD,WAAW,EAAE;QACX,KAAK,EAAE,SAAS;KACjB;IACD,IAAI,UAAU;QACZ,MAAM,KAAK,GAAG,MAAM,CAAC,eAAe,EAAE,CAAC,eAAe,EAAE,CAAC;QACzD,OAAO;YACL,KAAK;SACN,CAAC;IACJ,CAAC;IACD,IAAI,YAAY;QACd,OAAO;YACL,YAAY,EAAE,mBAAmB,CAC/B,MAAM;YACN,cAAc,CAAC,SAAS;YACxB,wBAAwB,CAAC,KAAK,CAC/B;YACD,KAAK,EAAE,YAAY;SACpB,CAAC;IACJ,CAAC;IACD,SAAS,EAAE;QACT,cAAc,EAAE,EAAE;QAClB,QAAQ,EAAE,EAAE;KACb;CACF,CAAC,CAAC"}

package/dist/src/agents/registry.test.js

@@ -31,6 +31,7 @@ function makeMockedConfig(params) {
     });
     vi.spyOn(config, 'getAgentRegistry').mockReturnValue({
         getDirectoryContext: () => 'mock directory context',
+        getAllDefinitions: () => [],
     });
     return config;
 }
@@ -189,6 +190,7 @@ describe('AgentRegistry', () => {
                     overrides: {
                         codebase_investigator: { enabled: false },
                         cli_help: { enabled: false },
+                        generalist: { enabled: false },
                     },
                 },
             });
@@ -215,11 +217,11 @@ describe('AgentRegistry', () => {
             await registry.initialize();
             expect(registry.getDefinition('cli_help')).toBeUndefined();
         });
-        it('should NOT register generalist agent by default (because it is experimental)', async () => {
+        it('should register generalist agent by default', async () => {
             const config = makeMockedConfig();
             const registry = new TestableAgentRegistry(config);
             await registry.initialize();
-            expect(registry.getDefinition('generalist')).toBeUndefined();
+            expect(registry.getDefinition('generalist')).toBeDefined();
         });
         it('should register generalist agent if explicitly enabled via override', async () => {
             const config = makeMockedConfig({