@office-ai/aioncli-core 0.26.0 → 0.30.1

package/dist/src/agents/a2a-errors.test.js

@@ -0,0 +1,183 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { A2AAgentError, AgentCardNotFoundError, AgentCardAuthError, AgentAuthConfigMissingError, AgentConnectionError, classifyAgentError, } from './a2a-errors.js';
+describe('A2A Error Types', () => {
+    describe('A2AAgentError', () => {
+        it('should set name, agentName, and userMessage', () => {
+            const error = new A2AAgentError('my-agent', 'internal msg', 'user msg');
+            expect(error.name).toBe('A2AAgentError');
+            expect(error.agentName).toBe('my-agent');
+            expect(error.message).toBe('internal msg');
+            expect(error.userMessage).toBe('user msg');
+        });
+    });
+    describe('AgentCardNotFoundError', () => {
+        it('should produce a user-friendly 404 message', () => {
+            const error = new AgentCardNotFoundError('my-agent', 'https://example.com/card');
+            expect(error.name).toBe('AgentCardNotFoundError');
+            expect(error.agentName).toBe('my-agent');
+            expect(error.userMessage).toContain('404');
+            expect(error.userMessage).toContain('https://example.com/card');
+            expect(error.userMessage).toContain('agent_card_url');
+        });
+    });
+    describe('AgentCardAuthError', () => {
+        it('should produce a user-friendly 401 message', () => {
+            const error = new AgentCardAuthError('secure-agent', 'https://example.com/card', 401);
+            expect(error.name).toBe('AgentCardAuthError');
+            expect(error.statusCode).toBe(401);
+            expect(error.userMessage).toContain('401');
+            expect(error.userMessage).toContain('Unauthorized');
+            expect(error.userMessage).toContain('"auth" configuration');
+        });
+        it('should produce a user-friendly 403 message', () => {
+            const error = new AgentCardAuthError('secure-agent', 'https://example.com/card', 403);
+            expect(error.statusCode).toBe(403);
+            expect(error.userMessage).toContain('403');
+            expect(error.userMessage).toContain('Forbidden');
+        });
+    });
+    describe('AgentAuthConfigMissingError', () => {
+        it('should list missing config fields', () => {
+            const error = new AgentAuthConfigMissingError('api-agent', 'API Key (x-api-key): Send x-api-key in header', [
+                'Authentication is required but not configured',
+                "Scheme 'api_key' requires apiKey authentication",
+            ]);
+            expect(error.name).toBe('AgentAuthConfigMissingError');
+            expect(error.requiredAuth).toContain('API Key');
+            expect(error.missingFields).toHaveLength(2);
+            expect(error.userMessage).toContain('API Key');
+            expect(error.userMessage).toContain('no auth is configured');
+            expect(error.userMessage).toContain('Missing:');
+        });
+    });
+    describe('AgentConnectionError', () => {
+        it('should wrap the original error cause', () => {
+            const cause = new Error('ECONNREFUSED');
+            const error = new AgentConnectionError('my-agent', 'https://example.com/card', cause);
+            expect(error.name).toBe('AgentConnectionError');
+            expect(error.userMessage).toContain('ECONNREFUSED');
+            expect(error.userMessage).toContain('https://example.com/card');
+        });
+        it('should handle non-Error causes', () => {
+            const error = new AgentConnectionError('my-agent', 'https://example.com/card', 'raw string error');
+            expect(error.userMessage).toContain('raw string error');
+        });
+    });
+    describe('classifyAgentError', () => {
+        it('should classify a 404 error message', () => {
+            const raw = new Error('HTTP 404: Not Found');
+            const result = classifyAgentError('agent-a', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentCardNotFoundError);
+            expect(result.agentName).toBe('agent-a');
+        });
+        it('should classify a "not found" error message (case-insensitive)', () => {
+            const raw = new Error('Agent card not found at the given URL');
+            const result = classifyAgentError('agent-a', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentCardNotFoundError);
+        });
+        it('should classify a 401 error message', () => {
+            const raw = new Error('Request failed with status 401');
+            const result = classifyAgentError('agent-b', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentCardAuthError);
+            expect(result.statusCode).toBe(401);
+        });
+        it('should classify an "unauthorized" error message', () => {
+            const raw = new Error('Unauthorized access to agent card');
+            const result = classifyAgentError('agent-b', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentCardAuthError);
+        });
+        it('should classify a 403 error message', () => {
+            const raw = new Error('HTTP 403 Forbidden');
+            const result = classifyAgentError('agent-c', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentCardAuthError);
+            expect(result.statusCode).toBe(403);
+        });
+        it('should fall back to AgentConnectionError for unknown errors', () => {
+            const raw = new Error('Something completely unexpected');
+            const result = classifyAgentError('agent-d', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentConnectionError);
+        });
+        it('should classify ECONNREFUSED as AgentConnectionError', () => {
+            const raw = new Error('ECONNREFUSED 127.0.0.1:8080');
+            const result = classifyAgentError('agent-d', 'https://example.com/card', raw);
+            expect(result).toBeInstanceOf(AgentConnectionError);
+        });
+        it('should handle non-Error values', () => {
+            const result = classifyAgentError('agent-e', 'https://example.com/card', 'some string error');
+            expect(result).toBeInstanceOf(AgentConnectionError);
+        });
+        describe('cause chain inspection', () => {
+            it('should detect 404 in a nested cause', () => {
+                const inner = new Error('HTTP 404 Not Found');
+                const outer = new Error('fetch failed', { cause: inner });
+                const result = classifyAgentError('agent-nested', 'https://example.com/card', outer);
+                expect(result).toBeInstanceOf(AgentCardNotFoundError);
+            });
+            it('should detect 401 in a deeply nested cause', () => {
+                const innermost = new Error('Server returned 401');
+                const middle = new Error('Request error', { cause: innermost });
+                const outer = new Error('fetch failed', { cause: middle });
+                const result = classifyAgentError('agent-deep', 'https://example.com/card', outer);
+                expect(result).toBeInstanceOf(AgentCardAuthError);
+                expect(result.statusCode).toBe(401);
+            });
+            it('should detect ECONNREFUSED error code in cause chain', () => {
+                const inner = Object.assign(new Error('connect failed'), {
+                    code: 'ECONNREFUSED',
+                });
+                const outer = new Error('fetch failed', { cause: inner });
+                const result = classifyAgentError('agent-conn', 'https://example.com/card', outer);
+                expect(result).toBeInstanceOf(AgentConnectionError);
+            });
+            it('should detect status property on error objects in cause chain', () => {
+                const inner = Object.assign(new Error('Bad response'), {
+                    status: 403,
+                });
+                const outer = new Error('agent card resolution failed', {
+                    cause: inner,
+                });
+                const result = classifyAgentError('agent-status', 'https://example.com/card', outer);
+                expect(result).toBeInstanceOf(AgentCardAuthError);
+                expect(result.statusCode).toBe(403);
+            });
+            it('should detect status on a plain-object cause (non-Error)', () => {
+                const outer = new Error('fetch failed');
+                // Some HTTP libs set cause to a plain object, not an Error instance
+                outer.cause = {
+                    message: 'Unauthorized',
+                    status: 401,
+                };
+                const result = classifyAgentError('agent-plain-cause', 'https://example.com/card', outer);
+                expect(result).toBeInstanceOf(AgentCardAuthError);
+                expect(result.statusCode).toBe(401);
+            });
+            it('should detect statusCode on a plain-object cause (non-Error)', () => {
+                const outer = new Error('fetch failed');
+                outer.cause = {
+                    message: 'Forbidden',
+                    statusCode: 403,
+                };
+                const result = classifyAgentError('agent-plain-cause-403', 'https://example.com/card', outer);
+                expect(result).toBeInstanceOf(AgentCardAuthError);
+                expect(result.statusCode).toBe(403);
+            });
+            it('should classify ENOTFOUND as AgentConnectionError, not 404', () => {
+                // ENOTFOUND (DNS resolution failure) should NOT be misclassified
+                // as a 404 despite containing "NOTFOUND" in the error code.
+                const inner = Object.assign(new Error('getaddrinfo ENOTFOUND example.invalid'), {
+                    code: 'ENOTFOUND',
+                });
+                const outer = new Error('fetch failed', { cause: inner });
+                const result = classifyAgentError('agent-dns', 'https://example.invalid/card', outer);
+                expect(result).toBeInstanceOf(AgentConnectionError);
+                expect(result).not.toBeInstanceOf(AgentCardNotFoundError);
+            });
+        });
+    });
+});
+//# sourceMappingURL=a2a-errors.test.js.map

package/dist/src/agents/a2a-errors.test.js.map

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

package/dist/src/agents/a2aUtils.d.ts

@@ -14,8 +14,9 @@ export declare function extractMessageText(message: Message | undefined): string
  */
 export declare function extractPartText(part: Part): string;
 /**
- * Extracts a human-readable text summary from a Task object.
- * Includes status, ID, and any artifact content.
+ * 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 declare function extractTaskText(task: Task): string;
 /**

package/dist/src/agents/a2aUtils.js

@@ -8,13 +8,10 @@
  * Handles Text, Data (JSON), and File parts.
  */
 export function extractMessageText(message) {
-    if (!message || !message.parts) {
+    if (!message) {
         return '';
     }
-    const parts = message.parts
-        .map((part) => extractPartText(part))
-        .filter(Boolean);
-    return parts.join('\n');
+    return extractPartsText(message.parts);
 }
 /**
  * Extracts text from a single Part.
@@ -40,37 +37,42 @@ export function extractPartText(part) {
     return '';
 }
 /**
- * Extracts a human-readable text summary from a Task object.
- * Includes status, ID, and any artifact content.
+ * 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) {
-    let output = `ID: ${task.id}\n`;
-    output += `State: ${task.status.state}\n`;
+    const parts = [];
     // Status Message
-    const statusMessageText = extractMessageText(task.status.message);
+    const statusMessageText = extractMessageText(task.status?.message);
     if (statusMessageText) {
-        output += `Status Message: ${statusMessageText}\n`;
+        parts.push(statusMessageText);
     }
     // Artifacts
-    if (task.artifacts && task.artifacts.length > 0) {
-        output += `Artifacts:\n`;
+    if (task.artifacts) {
         for (const artifact of task.artifacts) {
-            output += `  - Name: ${artifact.name}\n`;
-            if (artifact.parts && artifact.parts.length > 0) {
-                // Treat artifact parts as a message for extraction
-                const artifactContent = artifact.parts
-                    .map((p) => extractPartText(p))
-                    .filter(Boolean)
-                    .join('\n');
-                if (artifactContent) {
-                    // Indent content for readability
-                    const indentedContent = artifactContent.replace(/^/gm, '    ');
-                    output += `    Content:\n${indentedContent}\n`;
-                }
+            const artifactContent = extractPartsText(artifact.parts);
+            if (artifactContent) {
+                const header = artifact.name
+                    ? `Artifact (${artifact.name}):`
+                    : 'Artifact:';
+                parts.push(`${header}\n${artifactContent}`);
             }
         }
     }
-    return output;
+    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) {

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

@@ -102,7 +102,7 @@ describe('a2aUtils', () => {
         });
     });
     describe('extractTaskText', () => {
-        it('should extract basic task info', () => {
+        it('should extract basic task info (clean)', () => {
             const task = {
                 id: 'task-1',
                 contextId: 'ctx-1',
@@ -118,11 +118,11 @@ describe('a2aUtils', () => {
                 },
             };
             const result = extractTaskText(task);
-            expect(result).toContain('ID: task-1');
-            expect(result).toContain('State: working');
-            expect(result).toContain('Status Message: Processing...');
+            expect(result).not.toContain('ID: task-1');
+            expect(result).not.toContain('State: working');
+            expect(result).toBe('Processing...');
         });
-        it('should extract artifacts', () => {
+        it('should extract artifacts with headers', () => {
             const task = {
                 id: 'task-1',
                 contextId: 'ctx-1',
@@ -137,10 +137,10 @@ describe('a2aUtils', () => {
                 ],
             };
             const result = extractTaskText(task);
-            expect(result).toContain('Artifacts:');
-            expect(result).toContain('  - Name: Report');
-            expect(result).toContain('    Content:');
-            expect(result).toContain('    This is the report.');
+            expect(result).toContain('Artifact (Report):');
+            expect(result).toContain('This is the report.');
+            expect(result).not.toContain('Artifacts:');
+            expect(result).not.toContain('  - Name: Report');
         });
     });
 });

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/acknowledgedAgents.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export interface AcknowledgedAgentsMap {
+    [projectPath: string]: {
+        [agentName: string]: string;
+    };
+}
+export declare class AcknowledgedAgentsService {
+    private acknowledgedAgents;
+    private loaded;
+    load(): Promise<void>;
+    save(): Promise<void>;
+    isAcknowledged(projectPath: string, agentName: string, hash: string): Promise<boolean>;
+    acknowledge(projectPath: string, agentName: string, hash: string): Promise<void>;
+}

package/dist/src/agents/acknowledgedAgents.js

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { Storage } from '../config/storage.js';
+import { debugLogger } from '../utils/debugLogger.js';
+import { getErrorMessage, isNodeError } from '../utils/errors.js';
+export class AcknowledgedAgentsService {
+    acknowledgedAgents = {};
+    loaded = false;
+    async load() {
+        if (this.loaded)
+            return;
+        const filePath = Storage.getAcknowledgedAgentsPath();
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            this.acknowledgedAgents = JSON.parse(content);
+        }
+        catch (error) {
+            if (!isNodeError(error) || error.code !== 'ENOENT') {
+                debugLogger.error('Failed to load acknowledged agents:', getErrorMessage(error));
+            }
+            // If file doesn't exist or there's a parsing error, fallback to empty
+            this.acknowledgedAgents = {};
+        }
+        this.loaded = true;
+    }
+    async save() {
+        const filePath = Storage.getAcknowledgedAgentsPath();
+        try {
+            const dir = path.dirname(filePath);
+            await fs.mkdir(dir, { recursive: true });
+            await fs.writeFile(filePath, JSON.stringify(this.acknowledgedAgents, null, 2), 'utf-8');
+        }
+        catch (error) {
+            debugLogger.error('Failed to save acknowledged agents:', getErrorMessage(error));
+        }
+    }
+    async isAcknowledged(projectPath, agentName, hash) {
+        await this.load();
+        const projectAgents = this.acknowledgedAgents[projectPath];
+        if (!projectAgents)
+            return false;
+        return projectAgents[agentName] === hash;
+    }
+    async acknowledge(projectPath, agentName, hash) {
+        await this.load();
+        if (!this.acknowledgedAgents[projectPath]) {
+            this.acknowledgedAgents[projectPath] = {};
+        }
+        this.acknowledgedAgents[projectPath][agentName] = hash;
+        await this.save();
+    }
+}
+//# sourceMappingURL=acknowledgedAgents.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"acknowledgedAgents.js","sourceRoot":"","sources":["../../../src/agents/acknowledgedAgents.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AASlE,MAAM,OAAO,yBAAyB;IAC5B,kBAAkB,GAA0B,EAAE,CAAC;IAC/C,MAAM,GAAG,KAAK,CAAC;IAEvB,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO;QAExB,MAAM,QAAQ,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACnD,WAAW,CAAC,KAAK,CACf,qCAAqC,EACrC,eAAe,CAAC,KAAK,CAAC,CACvB,CAAC;YACJ,CAAC;YACD,sEAAsE;YACtE,IAAI,CAAC,kBAAkB,GAAG,EAAE,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACzC,MAAM,EAAE,CAAC,SAAS,CAChB,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC,EAChD,OAAO,CACR,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,KAAK,CACf,qCAAqC,EACrC,eAAe,CAAC,KAAK,CAAC,CACvB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,SAAiB,EACjB,IAAY;QAEZ,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC3D,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACjC,OAAO,aAAa,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,WAAmB,EACnB,SAAiB,EACjB,IAAY;QAEZ,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC;QACvD,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/src/agents/acknowledgedAgents.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

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

@@ -0,0 +1,70 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { AcknowledgedAgentsService } from './acknowledgedAgents.js';
+import { Storage } from '../config/storage.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as os from 'node:os';
+describe('AcknowledgedAgentsService', () => {
+    let tempDir;
+    let originalGeminiCliHome;
+    beforeEach(async () => {
+        // Create a unique temp directory for each test
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'gemini-cli-test-'));
+        // Override GEMINI_CLI_HOME to point to the temp directory
+        originalGeminiCliHome = process.env['GEMINI_CLI_HOME'];
+        process.env['GEMINI_CLI_HOME'] = tempDir;
+    });
+    afterEach(async () => {
+        // Restore environment variable
+        if (originalGeminiCliHome) {
+            process.env['GEMINI_CLI_HOME'] = originalGeminiCliHome;
+        }
+        else {
+            delete process.env['GEMINI_CLI_HOME'];
+        }
+        // Clean up temp directory
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    it('should acknowledge an agent and save to disk', async () => {
+        const service = new AcknowledgedAgentsService();
+        const ackPath = Storage.getAcknowledgedAgentsPath();
+        await service.acknowledge('/project', 'AgentA', 'hash1');
+        // Verify file exists and content
+        const content = await fs.readFile(ackPath, 'utf-8');
+        expect(content).toContain('"AgentA": "hash1"');
+    });
+    it('should return true for acknowledged agent', async () => {
+        const service = new AcknowledgedAgentsService();
+        await service.acknowledge('/project', 'AgentA', 'hash1');
+        expect(await service.isAcknowledged('/project', 'AgentA', 'hash1')).toBe(true);
+        expect(await service.isAcknowledged('/project', 'AgentA', 'hash2')).toBe(false);
+        expect(await service.isAcknowledged('/project', 'AgentB', 'hash1')).toBe(false);
+    });
+    it('should load acknowledged agents from disk', async () => {
+        const ackPath = Storage.getAcknowledgedAgentsPath();
+        const data = {
+            '/project': {
+                AgentLoaded: 'hashLoaded',
+            },
+        };
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(ackPath), { recursive: true });
+        await fs.writeFile(ackPath, JSON.stringify(data), 'utf-8');
+        const service = new AcknowledgedAgentsService();
+        expect(await service.isAcknowledged('/project', 'AgentLoaded', 'hashLoaded')).toBe(true);
+    });
+    it('should handle load errors gracefully', async () => {
+        // Create a directory where the file should be to cause a read error (EISDIR)
+        const ackPath = Storage.getAcknowledgedAgentsPath();
+        await fs.mkdir(ackPath, { recursive: true });
+        const service = new AcknowledgedAgentsService();
+        // Should not throw, and treated as empty
+        expect(await service.isAcknowledged('/project', 'Agent', 'hash')).toBe(false);
+    });
+});
+//# sourceMappingURL=acknowledgedAgents.test.js.map

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

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

package/dist/src/agents/agent-scheduler.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../config/config.js';
+import type { ToolCallRequestInfo, CompletedToolCall } from '../scheduler/types.js';
+import type { ToolRegistry } from '../tools/tool-registry.js';
+import type { EditorType } from '../utils/editor.js';
+/**
+ * Options for scheduling agent tools.
+ */
+export interface AgentSchedulingOptions {
+    /** The unique ID for this agent's scheduler. */
+    schedulerId: string;
+    /** The ID of the tool call that invoked this agent. */
+    parentCallId?: string;
+    /** The tool registry specific to this agent. */
+    toolRegistry: ToolRegistry;
+    /** AbortSignal for cancellation. */
+    signal: AbortSignal;
+    /** Optional function to get the preferred editor for tool modifications. */
+    getPreferredEditor?: () => EditorType | undefined;
+    /** Optional function to be notified when the scheduler is waiting for user confirmation. */
+    onWaitingForConfirmation?: (waiting: boolean) => void;
+}
+/**
+ * Schedules a batch of tool calls for an agent using the new event-driven Scheduler.
+ *
+ * @param config The global runtime configuration.
+ * @param requests The list of tool call requests from the agent.
+ * @param options Scheduling options including registry and IDs.
+ * @returns A promise that resolves to the completed tool calls.
+ */
+export declare function scheduleAgentTools(config: Config, requests: ToolCallRequestInfo[], options: AgentSchedulingOptions): Promise<CompletedToolCall[]>;

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Scheduler } from '../scheduler/scheduler.js';
+/**
+ * Schedules a batch of tool calls for an agent using the new event-driven Scheduler.
+ *
+ * @param config The global runtime configuration.
+ * @param requests The list of tool call requests from the agent.
+ * @param options Scheduling options including registry and IDs.
+ * @returns A promise that resolves to the completed tool calls.
+ */
+export async function scheduleAgentTools(config, requests, options) {
+    const { schedulerId, parentCallId, toolRegistry, signal, getPreferredEditor, onWaitingForConfirmation, } = options;
+    // Create a proxy/override of the config to provide the agent-specific tool registry.
+    const agentConfig = Object.create(config);
+    agentConfig.getToolRegistry = () => toolRegistry;
+    const scheduler = new Scheduler({
+        config: agentConfig,
+        messageBus: config.getMessageBus(),
+        getPreferredEditor: getPreferredEditor ?? (() => undefined),
+        schedulerId,
+        parentCallId,
+        onWaitingForConfirmation,
+    });
+    return scheduler.schedule(requests, signal);
+}
+//# sourceMappingURL=agent-scheduler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-scheduler.js","sourceRoot":"","sources":["../../../src/agents/agent-scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA0BtD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAc,EACd,QAA+B,EAC/B,OAA+B;IAE/B,MAAM,EACJ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,MAAM,EACN,kBAAkB,EAClB,wBAAwB,GACzB,GAAG,OAAO,CAAC;IAEZ,qFAAqF;IACrF,MAAM,WAAW,GAAW,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,WAAW,CAAC,eAAe,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC;IAEjD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;QAC9B,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE;QAClC,kBAAkB,EAAE,kBAAkB,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC;QAC3D,WAAW;QACX,YAAY;QACZ,wBAAwB;KACzB,CAAC,CAAC;IAEH,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/agents/agent-scheduler.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};