pi-harness-runtime 0.5.0 → 0.6.3-beta.13

package/packages/provider-adapter-sdk/dist/src/tester.js

@@ -0,0 +1,392 @@
+/**
+ * Provider Adapter SDK - Tester
+ *
+ * Testing utilities for provider adapters.
+ */
+import { TestFailureError } from "./errors.js";
+/**
+ * Default test configuration
+ */
+const DEFAULT_TEST_CONFIG = {
+    testInvocation: true,
+    testQuotaDetection: true,
+    testErrorParsing: true,
+    testHealthCheck: true,
+    testRateLimiting: false,
+    mockResponses: true,
+    timeout: 10000,
+};
+/**
+ * Default test request
+ */
+const DEFAULT_TEST_REQUEST = {
+    model: "",
+    messages: [
+        {
+            role: "user",
+            content: "Hello, this is a test message.",
+        },
+    ],
+    temperature: 0.7,
+    maxTokens: 100,
+};
+/**
+ * Tester utility for validating adapters
+ */
+export class AdapterTester {
+    adapter;
+    config;
+    mockResponses = [];
+    testStartTime = 0;
+    constructor(adapter, config = {}) {
+        this.adapter = adapter;
+        this.config = { ...DEFAULT_TEST_CONFIG, ...config };
+    }
+    /**
+     * Run all tests
+     */
+    async runAllTests() {
+        this.testStartTime = Date.now();
+        const results = [];
+        // Get the first supported model for testing
+        const models = this.adapter.getModels();
+        const testModel = this.config.mockResponses
+            ? models[0] || "test-model"
+            : models[0];
+        if (!testModel) {
+            results.push({
+                name: "model_availability",
+                passed: false,
+                duration: 0,
+                error: "No models available for testing",
+            });
+            return this.createReport(results);
+        }
+        // Update default request with model
+        const testRequest = {
+            ...DEFAULT_TEST_REQUEST,
+            model: testModel,
+        };
+        // Test model availability
+        results.push(await this.testModelAvailability(testModel));
+        // Test invocation
+        if (this.config.testInvocation) {
+            results.push(await this.testBasicInvocation(testRequest));
+        }
+        // Test quota detection
+        if (this.config.testQuotaDetection) {
+            results.push(await this.testQuotaDetection());
+        }
+        // Test error parsing
+        if (this.config.testErrorParsing) {
+            results.push(await this.testErrorParsing());
+        }
+        // Test health check
+        if (this.config.testHealthCheck) {
+            results.push(await this.testHealthCheck());
+        }
+        // Test rate limiting
+        if (this.config.testRateLimiting) {
+            results.push(await this.testRateLimiting(testRequest));
+        }
+        return this.createReport(results);
+    }
+    /**
+     * Test model availability
+     */
+    async testModelAvailability(model) {
+        const start = Date.now();
+        try {
+            const supported = this.adapter.supportsModel(model);
+            return {
+                name: "model_availability",
+                passed: supported,
+                duration: Date.now() - start,
+                message: supported
+                    ? `Model '${model}' is supported`
+                    : `Model '${model}' is not supported`,
+            };
+        }
+        catch (error) {
+            return {
+                name: "model_availability",
+                passed: false,
+                duration: Date.now() - start,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Test basic invocation
+     */
+    async testBasicInvocation(request) {
+        const start = Date.now();
+        try {
+            if (this.config.mockResponses) {
+                // Mock response mode
+                return {
+                    name: "basic_invocation",
+                    passed: true,
+                    duration: Date.now() - start,
+                    message: "Mock response mode - invocation skipped",
+                };
+            }
+            const result = await this.withTimeout(this.adapter.invoke(request), this.config.timeout);
+            const passed = result.response.content !== undefined;
+            return {
+                name: "basic_invocation",
+                passed,
+                duration: Date.now() - start,
+                message: passed
+                    ? "Invocation successful"
+                    : "Invocation returned empty response",
+                details: {
+                    hasContent: !!result.response.content,
+                    latencyMs: result.latencyMs,
+                },
+            };
+        }
+        catch (error) {
+            // In mock mode, errors are expected
+            if (this.config.mockResponses) {
+                return {
+                    name: "basic_invocation",
+                    passed: true,
+                    duration: Date.now() - start,
+                    message: "Mock mode - error handling verified",
+                };
+            }
+            return {
+                name: "basic_invocation",
+                passed: false,
+                duration: Date.now() - start,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Test quota detection
+     */
+    async testQuotaDetection() {
+        const start = Date.now();
+        try {
+            // Test error parsing with quota-related errors
+            const testErrors = [
+                { message: "Quota exceeded for this period", code: "QUOTA_EXCEEDED" },
+                { message: "Insufficient quota", code: "insufficient_quota" },
+                { message: "Rate limit exceeded", code: "429" },
+            ];
+            const results = testErrors.map((e) => this.adapter.parseError(e));
+            // Check if at least some quota signals were detected
+            const quotaDetected = results.filter((r) => r.quotaExceeded || r.rateLimited);
+            const passed = quotaDetected.length > 0;
+            return {
+                name: "quota_detection",
+                passed,
+                duration: Date.now() - start,
+                message: passed
+                    ? `Quota detection working (${quotaDetected.length}/${testErrors.length} detected)`
+                    : "Quota detection not working",
+                details: {
+                    errorsTested: testErrors.length,
+                    detected: quotaDetected.length,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                name: "quota_detection",
+                passed: false,
+                duration: Date.now() - start,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Test error parsing
+     */
+    async testErrorParsing() {
+        const start = Date.now();
+        try {
+            const testCases = [
+                {
+                    input: { message: "Rate limit exceeded", code: "429" },
+                    expected: { rateLimited: true },
+                },
+                {
+                    input: { message: "Internal server error", code: "500" },
+                    expected: { serverError: true },
+                },
+                {
+                    input: { message: "Bad request", code: "400" },
+                    expected: { clientError: true },
+                },
+                {
+                    input: { message: "Request timeout", code: "timeout" },
+                    expected: { timeout: true },
+                },
+            ];
+            let passedCount = 0;
+            for (const testCase of testCases) {
+                const result = this.adapter.parseError(testCase.input);
+                const matches = Object.entries(testCase.expected).every(([key, value]) => result[key] === value);
+                if (matches)
+                    passedCount++;
+            }
+            const passed = passedCount === testCases.length;
+            return {
+                name: "error_parsing",
+                passed,
+                duration: Date.now() - start,
+                message: passed
+                    ? "All error parsing tests passed"
+                    : `${passedCount}/${testCases.length} error parsing tests passed`,
+                details: { passedCount, total: testCases.length },
+            };
+        }
+        catch (error) {
+            return {
+                name: "error_parsing",
+                passed: false,
+                duration: Date.now() - start,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Test health check
+     */
+    async testHealthCheck() {
+        const start = Date.now();
+        try {
+            const result = await this.withTimeout(this.adapter.healthCheck(), this.config.timeout);
+            return {
+                name: "health_check",
+                passed: result.healthy !== undefined,
+                duration: Date.now() - start,
+                message: result.healthy
+                    ? "Health check passed"
+                    : "Health check indicates unhealthy",
+                details: {
+                    healthy: result.healthy,
+                    latencyMs: result.latencyMs,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                name: "health_check",
+                passed: false,
+                duration: Date.now() - start,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Test rate limiting behavior
+     */
+    async testRateLimiting(request) {
+        const start = Date.now();
+        try {
+            // Make concurrent requests to test rate limiting
+            const concurrency = 5;
+            const promises = Array.from({ length: concurrency }, () => this.adapter.invoke(request).catch((e) => e));
+            const results = await Promise.allSettled(promises);
+            const rejected = results.filter((r) => r.status === "rejected");
+            // If rate limiting is configured, we expect some to be rate limited
+            const rateLimits = this.adapter.getRateLimits();
+            const hasRateLimitConfig = rateLimits.concurrentRequests !== undefined ||
+                rateLimits.requestsPerMinute !== undefined;
+            const passed = hasRateLimitConfig || rejected.length === 0;
+            return {
+                name: "rate_limiting",
+                passed,
+                duration: Date.now() - start,
+                message: hasRateLimitConfig
+                    ? "Rate limiting configured"
+                    : "No rate limiting configured",
+                details: {
+                    concurrency,
+                    rejected: rejected.length,
+                    hasConfig: hasRateLimitConfig,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                name: "rate_limiting",
+                passed: false,
+                duration: Date.now() - start,
+                error: String(error),
+            };
+        }
+    }
+    /**
+     * Add mock responses for testing
+     */
+    addMockResponse(mock) {
+        this.mockResponses.push(mock);
+    }
+    /**
+     * Clear mock responses
+     */
+    clearMockResponses() {
+        this.mockResponses = [];
+    }
+    /**
+     * Generate mock responses based on adapter config
+     */
+    generateMockResponses() {
+        this.mockResponses = this.adapter.getModels().map((model) => ({
+            request: { ...DEFAULT_TEST_REQUEST, model },
+            response: {
+                content: `Mock response for ${model}`,
+                model,
+                finishReason: "stop",
+                usage: {
+                    input: 10,
+                    output: 20,
+                    cost: 0.001,
+                },
+            },
+        }));
+    }
+    /**
+     * Create test report
+     */
+    createReport(results) {
+        const totalDuration = Date.now() - this.testStartTime;
+        const passed = results.filter((r) => r.passed).length;
+        const failed = results.filter((r) => !r.passed).length;
+        return {
+            adapterId: this.adapter.id,
+            timestamp: new Date().toISOString(),
+            results,
+            summary: {
+                total: results.length,
+                passed,
+                failed,
+                duration: totalDuration,
+            },
+            overall: failed === 0 ? "passed" : passed === 0 ? "failed" : "partial",
+        };
+    }
+    /**
+     * Wrap promise with timeout
+     */
+    async withTimeout(promise, timeoutMs) {
+        const timeout = new Promise((_, reject) => setTimeout(() => reject(new Error(`Test timed out after ${timeoutMs}ms`)), timeoutMs));
+        return Promise.race([promise, timeout]);
+    }
+}
+/**
+ * Assert test results, throwing on failure
+ */
+export function assertTestResults(report) {
+    if (report.overall === "failed") {
+        const failures = report.results.filter((r) => !r.passed);
+        const messages = failures.map((f) => `  - ${f.name}: ${f.error || "failed"}`);
+        throw new TestFailureError(report.adapterId, "all", `Test failed:\n${messages.join("\n")}`);
+    }
+}
+//# sourceMappingURL=tester.js.map

package/packages/provider-adapter-sdk/dist/src/tester.js.map

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

package/packages/provider-adapter-sdk/dist/src/types.d.ts

@@ -0,0 +1,182 @@
+/**
+ * Provider Adapter SDK - Types
+ *
+ * Core types for building provider adapters.
+ */
+import type { ProviderCapability, ProviderRequest, ProviderResponse } from "../../types/src/runtime-types.js";
+/**
+ * SDK version for compatibility checks
+ */
+export declare const SDK_VERSION = "1.0.0";
+/**
+ * Rate limit configuration for providers
+ */
+export interface RateLimitConfig {
+    requestsPerMinute?: number;
+    tokensPerMinute?: number;
+    tokensPerDay?: number;
+    concurrentRequests?: number;
+}
+/**
+ * Adapter version information
+ */
+export interface AdapterVersion {
+    sdk: string;
+    minRuntime?: string;
+    capabilities: ProviderCapability[];
+}
+/**
+ * Quota signal extracted from error responses
+ */
+export interface QuotaSignal {
+    exhausted: boolean;
+    resetsAt?: string;
+    retryAfterMs?: number;
+    usedPercentage?: number;
+    remainingTokens?: number;
+}
+/**
+ * Error analysis result from adapter
+ */
+export interface ErrorAnalysis {
+    quotaExceeded: boolean;
+    rateLimited: boolean;
+    timeout: boolean;
+    serverError: boolean;
+    clientError: boolean;
+    quotaSignal?: QuotaSignal;
+    message?: string;
+    code?: string;
+}
+/**
+ * Adapter invocation result with quota signals
+ */
+export interface AdapterResult {
+    response: ProviderResponse;
+    quotaSignal?: QuotaSignal;
+    retryable: boolean;
+    latencyMs?: number;
+}
+/**
+ * Configuration for creating an adapter via Builder
+ */
+export interface AdapterBuilderConfig {
+    id: string;
+    name: string;
+    models?: string[];
+    capabilities?: ProviderCapability[];
+    rateLimits?: RateLimitConfig;
+    defaultModel?: string;
+    maxTokens?: Record<string, number>;
+}
+/**
+ * Invoke function signature for custom adapters
+ */
+export type InvokeFunction = (request: ProviderRequest) => Promise<ProviderResponse>;
+/**
+ * Error parser function signature
+ */
+export type ErrorParserFunction = (error: unknown) => ErrorAnalysis;
+/**
+ * Health check function signature
+ */
+export type HealthCheckFunction = () => Promise<HealthCheckResult>;
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    latencyMs?: number;
+    message?: string;
+    timestamp: string;
+}
+/**
+ * Lifecycle hooks for adapter management
+ */
+export interface AdapterLifecycle {
+    onInit?: () => Promise<void>;
+    onHealthCheck?: HealthCheckFunction;
+    onTeardown?: () => Promise<void>;
+}
+/**
+ * Adapter metadata for registry listing
+ */
+export interface AdapterInfo {
+    id: string;
+    name: string;
+    version?: AdapterVersion;
+    capabilities: ProviderCapability[];
+    models: string[];
+    registeredAt: string;
+    state: AdapterState;
+    lastHealthCheck?: HealthCheckResult;
+}
+/**
+ * Adapter state in registry
+ */
+export type AdapterState = "registered" | "initializing" | "ready" | "error" | "unavailable";
+/**
+ * Test result from AdapterTester
+ */
+export interface TestResult {
+    name: string;
+    passed: boolean;
+    duration: number;
+    message?: string;
+    error?: string;
+    details?: Record<string, unknown>;
+}
+/**
+ * Full test report from AdapterTester
+ */
+export interface TestReport {
+    adapterId: string;
+    timestamp: string;
+    results: TestResult[];
+    summary: {
+        total: number;
+        passed: number;
+        failed: number;
+        duration: number;
+    };
+    overall: "passed" | "failed" | "partial";
+}
+/**
+ * Test configuration
+ */
+export interface TestConfig {
+    testInvocation?: boolean;
+    testQuotaDetection?: boolean;
+    testErrorParsing?: boolean;
+    testHealthCheck?: boolean;
+    testRateLimiting?: boolean;
+    mockResponses?: boolean;
+    timeout?: number;
+}
+/**
+ * Mock response for testing
+ */
+export interface MockResponse {
+    request: ProviderRequest;
+    response: ProviderResponse;
+    delayMs?: number;
+}
+/**
+ * Compatibility check result
+ */
+export interface CompatibilityResult {
+    compatible: boolean;
+    issues: string[];
+    warnings: string[];
+}
+/**
+ * Registry events
+ */
+export interface RegistryEvents {
+    onAdapterRegistered: (adapter: AdapterInfo) => void;
+    onAdapterUnregistered: (adapterId: string) => void;
+    onAdapterStateChanged: (adapterId: string, state: AdapterState) => void;
+    onHealthCheckFailed: (adapterId: string, result: HealthCheckResult) => void;
+}
+export type { ProviderCapability, ProviderRequest, ProviderResponse, } from "../../types/src/runtime-types.js";
+//# sourceMappingURL=types.d.ts.map

package/packages/provider-adapter-sdk/dist/src/types.d.ts.map

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

package/packages/provider-adapter-sdk/dist/src/types.js

@@ -0,0 +1,11 @@
+/**
+ * Provider Adapter SDK - Types
+ *
+ * Core types for building provider adapters.
+ */
+// ─── SDK Version ────────────────────────────────────────────────────────────
+/**
+ * SDK version for compatibility checks
+ */
+export const SDK_VERSION = "1.0.0";
+//# sourceMappingURL=types.js.map

package/packages/provider-adapter-sdk/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/packages/provider-adapter-sdk/dist/tester.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Provider Adapter SDK - Tester
+ *
+ * Testing utilities for provider adapters.
+ */
+import type { MockResponse, ProviderRequest, TestConfig, TestReport, TestResult } from "./types.js";
+import type { BuiltAdapter } from "./builder.js";
+/**
+ * Tester utility for validating adapters
+ */
+export declare class AdapterTester {
+    private readonly adapter;
+    private readonly config;
+    private mockResponses;
+    private testStartTime;
+    constructor(adapter: BuiltAdapter, config?: TestConfig);
+    /**
+     * Run all tests
+     */
+    runAllTests(): Promise<TestReport>;
+    /**
+     * Test model availability
+     */
+    testModelAvailability(model: string): Promise<TestResult>;
+    /**
+     * Test basic invocation
+     */
+    testBasicInvocation(request: ProviderRequest): Promise<TestResult>;
+    /**
+     * Test quota detection
+     */
+    testQuotaDetection(): Promise<TestResult>;
+    /**
+     * Test error parsing
+     */
+    testErrorParsing(): Promise<TestResult>;
+    /**
+     * Test health check
+     */
+    testHealthCheck(): Promise<TestResult>;
+    /**
+     * Test rate limiting behavior
+     */
+    testRateLimiting(request: ProviderRequest): Promise<TestResult>;
+    /**
+     * Add mock responses for testing
+     */
+    addMockResponse(mock: MockResponse): void;
+    /**
+     * Clear mock responses
+     */
+    clearMockResponses(): void;
+    /**
+     * Generate mock responses based on adapter config
+     */
+    generateMockResponses(): void;
+    /**
+     * Create test report
+     */
+    private createReport;
+    /**
+     * Wrap promise with timeout
+     */
+    private withTimeout;
+}
+/**
+ * Assert test results, throwing on failure
+ */
+export declare function assertTestResults(report: TestReport): void;
+/**
+ * Create a new adapter tester
+ */
+export declare function createAdapterTester(adapter: import("./builder.js").BuiltAdapter, config?: TestConfig): AdapterTester;
+//# sourceMappingURL=tester.d.ts.map