@didim365/agent-cli-core 0.1.0

package/dist/src/providers/__tests__/performance.test.js

@@ -0,0 +1,270 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * M3.4.3.1 — Response latency benchmark (< 50ms)
+ * M3.4.3.2 — Streaming TTFT benchmark (< 100ms)
+ * M3.4.3.3 — Memory usage profiling (< 10% growth)
+ *
+ * Measures adapter framework overhead using mock adapters.
+ * Network latency is excluded — only Registry → Factory → Adapter → Event Stream
+ * overhead is measured.
+ *
+ * **Scope limitation**: These benchmarks target the adapter abstraction layer only.
+ * Real SDK conversion (toClaudeRequest, toOpenAiRequest), error classification
+ * (classifyError), and stream assembly (StreamAssembler) overhead is NOT measured
+ * here — those paths are covered by their respective unit tests.
+ * Full end-to-end latency (including SDK wire time) requires live API tests
+ * and is out of scope for regression gating.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { ProviderRegistry } from '../registry.js';
+import { ProviderFactory } from '../factory.js';
+import { BaseAdapter } from '../baseAdapter.js';
+import { LlmEventType } from '../events.js';
+// ============================================================================
+// Benchmark Utilities
+// ============================================================================
+async function measureTime(fn) {
+    const start = performance.now();
+    await fn();
+    return performance.now() - start;
+}
+async function benchmark(fn, iterations = 50) {
+    const times = [];
+    // Warm-up (5 iterations)
+    for (let i = 0; i < 5; i++) {
+        await fn();
+    }
+    // Measure
+    for (let i = 0; i < iterations; i++) {
+        times.push(await measureTime(fn));
+    }
+    times.sort((a, b) => a - b);
+    return {
+        median: times[Math.floor(times.length / 2)],
+        p95: times[Math.floor(times.length * 0.95)],
+    };
+}
+// ============================================================================
+// Mock Adapters (minimal — mirrors multiProvider.integration.test.ts)
+// ============================================================================
+const MOCK_CAPABILITIES = {
+    supportsStreaming: true,
+    supportsToolCalls: true,
+    supportsImageInput: false,
+    supportsImageGeneration: false,
+    supportsEmbedding: false,
+    supportsTokenCount: false,
+    supportsSystemMessage: true,
+    supportsThought: false,
+    maxContextLength: 128_000,
+    maxOutputTokens: 8192,
+};
+class PerfMockGeminiAdapter extends BaseAdapter {
+    providerName = 'gemini';
+    capabilities = MOCK_CAPABILITIES;
+    mapToProviderConfig(_config) {
+        return {};
+    }
+    async generateContent(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        return {
+            id: 'perf-gemini-1',
+            content: [{ type: 'text', text: '[gemini] perf response' }],
+            model: request.model,
+            stopReason: 'end_turn',
+            usage: { promptTokens: 10, completionTokens: 20, totalTokens: 30 },
+        };
+    }
+    async *generateContentStream(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        yield { type: LlmEventType.TextDelta, text: '[gemini] ' };
+        yield { type: LlmEventType.TextDelta, text: 'streaming' };
+        yield { type: LlmEventType.Finished, finishReason: 'end_turn' };
+    }
+}
+class PerfMockClaudeAdapter extends BaseAdapter {
+    providerName = 'claude';
+    capabilities = MOCK_CAPABILITIES;
+    mapToProviderConfig(_config) {
+        return {};
+    }
+    async generateContent(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        return {
+            id: 'perf-claude-1',
+            content: [{ type: 'text', text: '[claude] perf response' }],
+            model: request.model,
+            stopReason: 'end_turn',
+            usage: { promptTokens: 15, completionTokens: 25, totalTokens: 40 },
+        };
+    }
+    async *generateContentStream(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        yield { type: LlmEventType.TextDelta, text: '[claude] ' };
+        yield { type: LlmEventType.TextDelta, text: 'streaming' };
+        yield { type: LlmEventType.Finished, finishReason: 'end_turn' };
+    }
+}
+class PerfMockOpenAiAdapter extends BaseAdapter {
+    providerName = 'openai';
+    capabilities = MOCK_CAPABILITIES;
+    mapToProviderConfig(_config) {
+        return {};
+    }
+    async generateContent(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        return {
+            id: 'perf-openai-1',
+            content: [{ type: 'text', text: '[openai] perf response' }],
+            model: request.model,
+            stopReason: 'end_turn',
+            usage: { promptTokens: 12, completionTokens: 18, totalTokens: 30 },
+        };
+    }
+    async *generateContentStream(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        yield { type: LlmEventType.TextDelta, text: '[openai] ' };
+        yield { type: LlmEventType.TextDelta, text: 'streaming' };
+        yield { type: LlmEventType.Finished, finishReason: 'end_turn' };
+    }
+}
+// ============================================================================
+// Test Setup
+// ============================================================================
+function createBasicRequest(model) {
+    return {
+        model,
+        messages: [{ role: 'user', content: [{ type: 'text', text: 'Hello' }] }],
+    };
+}
+const PROVIDERS = [
+    { name: 'gemini', AdapterClass: PerfMockGeminiAdapter },
+    { name: 'claude', AdapterClass: PerfMockClaudeAdapter },
+    { name: 'openai', AdapterClass: PerfMockOpenAiAdapter },
+];
+// ============================================================================
+// Tests
+// ============================================================================
+describe('Provider Performance Benchmarks', () => {
+    let registry;
+    let factory;
+    let adapters;
+    beforeEach(() => {
+        registry = ProviderRegistry.getInstance();
+        registry.clear();
+        for (const { name, AdapterClass } of PROVIDERS) {
+            registry.register(name, (config) => new AdapterClass(config), {
+                force: true,
+            });
+        }
+        factory = new ProviderFactory(registry);
+        adapters = new Map();
+        for (const { name } of PROVIDERS) {
+            adapters.set(name, factory.create(name, {}));
+        }
+    });
+    afterEach(() => {
+        registry.clear();
+    });
+    // ==========================================================================
+    // 3.4.3.1 Response Latency (< 50ms)
+    // ==========================================================================
+    describe('3.4.3.1 Response Latency', () => {
+        it('generateContent overhead should be < 50ms per provider (p95)', async () => {
+            const request = createBasicRequest('test-model');
+            for (const { name } of PROVIDERS) {
+                const adapter = adapters.get(name);
+                const result = await benchmark(async () => {
+                    await adapter.generateContent(request, `bench-${name}`);
+                });
+                expect(result.p95, `${name} generateContent p95 (${result.p95.toFixed(2)}ms) exceeds 50ms`).toBeLessThan(50);
+            }
+        });
+        it('provider creation overhead should be < 10ms (p95)', async () => {
+            const result = await benchmark(async () => {
+                factory.create('gemini', {});
+            });
+            expect(result.p95, `Provider creation p95 (${result.p95.toFixed(2)}ms) exceeds 10ms`).toBeLessThan(10);
+        });
+        it('registry lookup overhead should be < 5ms (p95)', async () => {
+            const result = await benchmark(async () => {
+                registry.get('claude');
+            });
+            expect(result.p95, `Registry lookup p95 (${result.p95.toFixed(2)}ms) exceeds 5ms`).toBeLessThan(5);
+        });
+    });
+    // ==========================================================================
+    // 3.4.3.2 Streaming TTFT (< 100ms)
+    // ==========================================================================
+    describe('3.4.3.2 Streaming TTFT', () => {
+        it('time to first TextDelta should be < 100ms per provider (p95)', async () => {
+            const request = createBasicRequest('test-model');
+            for (const { name } of PROVIDERS) {
+                const adapter = adapters.get(name);
+                const result = await benchmark(async () => {
+                    const stream = adapter.generateContentStream(request, `bench-ttft-${name}`);
+                    for await (const event of stream) {
+                        if (event.type === LlmEventType.TextDelta)
+                            break;
+                    }
+                });
+                expect(result.p95, `${name} TTFT p95 (${result.p95.toFixed(2)}ms) exceeds 100ms`).toBeLessThan(100);
+            }
+        });
+        it('full stream consumption should be < 50ms per provider (p95)', async () => {
+            const request = createBasicRequest('test-model');
+            for (const { name } of PROVIDERS) {
+                const adapter = adapters.get(name);
+                const result = await benchmark(async () => {
+                    const stream = adapter.generateContentStream(request, `bench-stream-${name}`);
+                    for await (const _event of stream) {
+                        /* consume all */
+                    }
+                });
+                expect(result.p95, `${name} full stream p95 (${result.p95.toFixed(2)}ms) exceeds 50ms`).toBeLessThan(50);
+            }
+        });
+    });
+    // ==========================================================================
+    // 3.4.3.3 Memory Usage (< 10% growth)
+    // ==========================================================================
+    describe('3.4.3.3 Memory Usage', () => {
+        it('memory growth during repeated operations should be < 10%', async () => {
+            const request = createBasicRequest('test-model');
+            // Multi-round measurement to reduce noise from GC timing and
+            // background V8 activity. Each round runs the workload and records
+            // the heap delta. The median of all rounds is used for the final check.
+            const ROUNDS = 5;
+            const ITERATIONS_PER_ROUND = 50;
+            const growthSamples = [];
+            for (let round = 0; round < ROUNDS; round++) {
+                if (global.gc)
+                    global.gc();
+                const before = process.memoryUsage().heapUsed;
+                for (let i = 0; i < ITERATIONS_PER_ROUND; i++) {
+                    for (const [, adapter] of adapters) {
+                        await adapter.generateContent(request, `mem-${round}-${i}`);
+                        const stream = adapter.generateContentStream(request, `mem-s-${round}-${i}`);
+                        for await (const _event of stream) {
+                            /* consume */
+                        }
+                    }
+                }
+                if (global.gc)
+                    global.gc();
+                const after = process.memoryUsage().heapUsed;
+                growthSamples.push(((after - before) / before) * 100);
+            }
+            // Use median to reduce outlier impact from GC pauses / background allocation
+            growthSamples.sort((a, b) => a - b);
+            const medianGrowth = growthSamples[Math.floor(growthSamples.length / 2)];
+            const sampleStr = growthSamples.map((g) => g.toFixed(2) + '%').join(', ');
+            expect(medianGrowth, `Median memory growth (${medianGrowth.toFixed(2)}%) exceeds 10% [samples: ${sampleStr}]`).toBeLessThan(10);
+        });
+    });
+});
+//# sourceMappingURL=performance.test.js.map

package/dist/src/providers/__tests__/performance.test.js.map

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

package/dist/src/providers/__tests__/providerConfigIntegration.test.d.ts

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

package/dist/src/providers/__tests__/providerConfigIntegration.test.js

@@ -0,0 +1,245 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * M3.4.1.3 — Provider config validation integration test
+ *
+ * Tests configuration handling across all 3 providers:
+ * - Config passthrough to adapters
+ * - Required config validation
+ * - Provider-specific config interpretation
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ProviderRegistry } from '../registry.js';
+import { ProviderFactory } from '../factory.js';
+import { BaseAdapter } from '../baseAdapter.js';
+import { LlmError, LlmErrorType } from '../errors.js';
+import { LlmEventType } from '../events.js';
+// ============================================================================
+// Config-Aware Mock Adapter
+// ============================================================================
+class ConfigCapturingAdapter extends BaseAdapter {
+    providerName;
+    capabilities = {
+        supportsStreaming: true,
+        supportsToolCalls: true,
+        supportsImageInput: false,
+        supportsImageGeneration: false,
+        supportsEmbedding: false,
+        supportsTokenCount: false,
+        supportsSystemMessage: true,
+        supportsThought: false,
+        maxContextLength: 128_000,
+        maxOutputTokens: 4096,
+    };
+    /** Expose config for assertions */
+    capturedConfig;
+    constructor(provider, config) {
+        super(config);
+        this.providerName = provider;
+        this.capturedConfig = config;
+    }
+    mapToProviderConfig(_config) {
+        return {};
+    }
+    async generateContent(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        return {
+            id: `${this.providerName}-resp`,
+            content: [{ type: 'text', text: 'ok' }],
+            model: request.model,
+            stopReason: 'end_turn',
+        };
+    }
+    async *generateContentStream(request, _userPromptId, _options) {
+        this.validateRequest(request);
+        yield { type: LlmEventType.Finished, finishReason: 'end_turn' };
+    }
+}
+// ============================================================================
+// Tests
+// ============================================================================
+describe('M3.4.1.3 — Provider config validation integration', () => {
+    let registry;
+    let factory;
+    beforeEach(() => {
+        registry = ProviderRegistry.getInstance();
+        registry.clear();
+        factory = new ProviderFactory(registry);
+        // Register config-capturing adapters for each provider
+        registry.register('gemini', (config) => new ConfigCapturingAdapter('gemini', config));
+        registry.register('claude', (config) => new ConfigCapturingAdapter('claude', config));
+        registry.register('openai', (config) => new ConfigCapturingAdapter('openai', config));
+    });
+    // ==========================================================================
+    // Config Passthrough
+    // ==========================================================================
+    describe('config passthrough', () => {
+        it('should pass apiKey to adapter config', () => {
+            const adapter = factory.create('claude', {
+                apiKey: 'sk-test-123',
+            });
+            expect(adapter.capturedConfig.apiKey).toBe('sk-test-123');
+        });
+        it('should pass baseUrl to adapter config', () => {
+            const adapter = factory.create('openai', {
+                apiKey: 'key',
+                baseUrl: 'https://custom.openai.api/v1',
+            });
+            expect(adapter.capturedConfig.baseUrl).toBe('https://custom.openai.api/v1');
+        });
+        it('should pass timeout and maxRetries to adapter config', () => {
+            const adapter = factory.create('gemini', {
+                apiKey: 'key',
+                timeout: 30_000,
+                maxRetries: 3,
+            });
+            expect(adapter.capturedConfig.timeout).toBe(30_000);
+            expect(adapter.capturedConfig.maxRetries).toBe(3);
+        });
+        it('should pass provider-specific config via index signature', () => {
+            const adapter = factory.create('claude', {
+                apiKey: 'key',
+                maxTokens: 4096,
+                customOption: 'value',
+            });
+            expect(adapter.capturedConfig['maxTokens']).toBe(4096);
+            expect(adapter.capturedConfig['customOption']).toBe('value');
+        });
+    });
+    // ==========================================================================
+    // Factory Validation (createWithValidation)
+    // ==========================================================================
+    describe('createWithValidation', () => {
+        it('should create adapter without requireApiKey by default', () => {
+            const adapter = factory.createWithValidation('gemini', {});
+            expect(adapter.providerName).toBe('gemini');
+        });
+        it('should throw VALIDATION when requireApiKey is true and apiKey is missing', () => {
+            try {
+                factory.createWithValidation('claude', {}, { requireApiKey: true });
+                expect.fail('Should have thrown');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(LlmError);
+                expect(error.type).toBe(LlmErrorType.VALIDATION);
+                expect(error.message).toContain('apiKey');
+            }
+        });
+        it('should succeed with requireApiKey when apiKey is provided', () => {
+            const adapter = factory.createWithValidation('openai', { apiKey: 'sk-test' }, { requireApiKey: true });
+            expect(adapter.providerName).toBe('openai');
+        });
+        it('should throw PROVIDER_NOT_FOUND for unregistered provider before config validation', () => {
+            try {
+                factory.createWithValidation('anthropic-vertex', {}, { requireApiKey: true });
+                expect.fail('Should have thrown');
+            }
+            catch (error) {
+                expect(error).toBeInstanceOf(LlmError);
+                // PROVIDER_NOT_FOUND takes precedence over VALIDATION
+                expect(error.type).toBe(LlmErrorType.PROVIDER_NOT_FOUND);
+            }
+        });
+    });
+    // ==========================================================================
+    // Request Config Interpretation
+    // ==========================================================================
+    describe('request config interpretation', () => {
+        it('should accept temperature/topP/maxTokens in request for all providers', async () => {
+            const providers = ['gemini', 'claude', 'openai'];
+            for (const provider of providers) {
+                const adapter = factory.create(provider, { apiKey: 'key' });
+                const request = {
+                    model: `${provider}-model`,
+                    messages: [
+                        { role: 'user', content: [{ type: 'text', text: 'test' }] },
+                    ],
+                    temperature: 0.7,
+                    topP: 0.9,
+                    maxTokens: 1024,
+                };
+                // Should not throw — request passes validateRequest
+                const response = await adapter.generateContent(request, 'prompt-1');
+                expect(response.stopReason).toBe('end_turn');
+            }
+        });
+        it('should accept systemInstruction in request for all providers', async () => {
+            const providers = ['gemini', 'claude', 'openai'];
+            for (const provider of providers) {
+                const adapter = factory.create(provider, { apiKey: 'key' });
+                const request = {
+                    model: `${provider}-model`,
+                    messages: [
+                        { role: 'user', content: [{ type: 'text', text: 'test' }] },
+                    ],
+                    systemInstruction: 'You are a helpful assistant.',
+                };
+                const response = await adapter.generateContent(request, 'prompt-1');
+                expect(response.stopReason).toBe('end_turn');
+            }
+        });
+        it('should accept tools in request for all providers', async () => {
+            const providers = ['gemini', 'claude', 'openai'];
+            for (const provider of providers) {
+                const adapter = factory.create(provider, { apiKey: 'key' });
+                const request = {
+                    model: `${provider}-model`,
+                    messages: [
+                        { role: 'user', content: [{ type: 'text', text: 'test' }] },
+                    ],
+                    tools: [
+                        {
+                            name: 'search',
+                            description: 'Search the web',
+                            parameters: {
+                                type: 'object',
+                                properties: {
+                                    query: { type: 'string', description: 'Search query' },
+                                },
+                                required: ['query'],
+                            },
+                        },
+                    ],
+                };
+                const response = await adapter.generateContent(request, 'prompt-1');
+                expect(response.stopReason).toBe('end_turn');
+            }
+        });
+    });
+    // ==========================================================================
+    // BaseAdapter Validation (common across all providers)
+    // ==========================================================================
+    describe('base adapter validation', () => {
+        it('should reject request with empty model', async () => {
+            const adapter = factory.create('claude', { apiKey: 'key' });
+            const request = {
+                model: '',
+                messages: [{ role: 'user', content: [{ type: 'text', text: 'test' }] }],
+            };
+            await expect(adapter.generateContent(request, 'prompt-1')).rejects.toThrow(LlmError);
+        });
+        it('should reject request with empty messages', async () => {
+            const adapter = factory.create('openai', { apiKey: 'key' });
+            const request = {
+                model: 'gpt-4o',
+                messages: [],
+            };
+            await expect(adapter.generateContent(request, 'prompt-1')).rejects.toThrow(LlmError);
+        });
+        it('should apply validation consistently across all providers', async () => {
+            const providers = ['gemini', 'claude', 'openai'];
+            const badRequest = {
+                model: '',
+                messages: [],
+            };
+            for (const provider of providers) {
+                const adapter = factory.create(provider, { apiKey: 'key' });
+                await expect(adapter.generateContent(badRequest, 'prompt-1')).rejects.toThrow(LlmError);
+            }
+        });
+    });
+});
+//# sourceMappingURL=providerConfigIntegration.test.js.map

package/dist/src/providers/__tests__/providerConfigIntegration.test.js.map

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

package/dist/src/providers/baseAdapter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { LlmGenerateConfig, LlmProviderCapabilities, LlmGenerateRequest, LlmGenerateResponse, AdapterConfig, ContentGenerator, GenerateOptions, LlmTokenCount } from './types.js';
+import type { LlmEventStream } from './events.js';
+/**
+ * Abstract base class for LLM adapters.
+ * Implements the ContentGenerator interface to enforce consistency.
+ *
+ * @see docs/ai_adapter/03-technical-design.md
+ */
+export declare abstract class BaseAdapter implements ContentGenerator {
+    protected config: AdapterConfig;
+    abstract readonly providerName: string;
+    abstract readonly capabilities: LlmProviderCapabilities;
+    constructor(config: AdapterConfig);
+    /**
+     * Validate the configuration.
+     * Throws LlmError if configuration is invalid.
+     */
+    protected validateConfig(): void;
+    /**
+     * Validate the request before processing.
+     * Subclasses SHOULD call this method at the start of `generateContent`
+     * and `generateContentStream` implementations.
+     *
+     * @example
+     * ```ts
+     * async generateContent(request: LlmGenerateRequest, ...): Promise<...> {
+     *   this.validateRequest(request); // Call validation first
+     *   // ... implementation
+     * }
+     * ```
+     */
+    protected validateRequest(request: LlmGenerateRequest): void;
+    /**
+     * Handle errors uniformly.
+     */
+    protected handleError(error: unknown): never;
+    /**
+     * Convert common config to provider-specific config.
+     * Note: This helper might be moved to specific adapters or kept here if useful.
+     */
+    protected abstract mapToProviderConfig(config: LlmGenerateConfig): Record<string, unknown>;
+    abstract generateContent(request: LlmGenerateRequest, userPromptId: string, options?: GenerateOptions): Promise<LlmGenerateResponse>;
+    abstract generateContentStream(request: LlmGenerateRequest, userPromptId: string, options?: GenerateOptions): LlmEventStream;
+    /**
+     * Count tokens in a request.
+     * Default implementation throws UnsupportedFeatureError if capabilities.supportsTokenCount is false.
+     * Subclasses SHOULD override this method if token counting is supported.
+     */
+    countTokens(_request: LlmGenerateRequest): Promise<LlmTokenCount>;
+    /**
+     * Embed content (optional).
+     * Default implementation throws UnsupportedFeatureError.
+     * @see TODO: M1.3 will define proper LlmEmbedRequest/LlmEmbedResponse types
+     */
+    embedContent(_request: unknown): Promise<unknown>;
+}