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

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

@@ -0,0 +1,332 @@
+/**
+ * Provider Adapter SDK - Builder
+ *
+ * Fluent API for creating provider adapters.
+ */
+import { BuilderValidationError } from "./errors.js";
+/**
+ * Token limits for common model families
+ */
+const DEFAULT_TOKEN_LIMITS = {
+    // MiniMax
+    "minimax/MiniMax-M3": 32768,
+    "minimax/MiniMax-Text-01": 1000000,
+    // Anthropic
+    "anthropic/claude-3-5-sonnet": 200000,
+    "anthropic/claude-3-5-haiku": 200000,
+    "anthropic/claude-3-opus": 200000,
+    "anthropic/claude-3-sonnet": 200000,
+    "anthropic/claude-3-haiku": 200000,
+    "anthropic/claude-2.1": 200000,
+    "anthropic/claude-2": 100000,
+    "anthropic/claude-instant": 100000,
+    // OpenAI
+    "openai/gpt-4o": 128000,
+    "openai/gpt-4-turbo": 128000,
+    "openai/gpt-4": 128000,
+    "openai/gpt-3.5-turbo": 16385,
+    // Google
+    "google/gemini-1.5-pro": 128000,
+    "google/gemini-1.5-flash": 128000,
+    // Default
+    default: 4096,
+};
+/**
+ * Default error parser for unknown providers
+ */
+const defaultErrorParser = (error) => {
+    const e = error;
+    const msg = String(e.message ?? e.error ?? "").toLowerCase();
+    const code = String(e.code ?? "");
+    return {
+        quotaExceeded: code === "insufficient_quota" ||
+            code === "context_length_exceeded" ||
+            msg.includes("quota"),
+        rateLimited: code === "rate_limit_exceeded" ||
+            msg.includes("429") ||
+            msg.includes("rate limit"),
+        timeout: msg.includes("timeout") || msg.includes("timed out"),
+        serverError: code.startsWith("5") || msg.includes("500"),
+        clientError: code.startsWith("4") && !code.startsWith("429"),
+        message: String(e.message ?? e.error ?? "Unknown error"),
+        code,
+    };
+};
+/**
+ * Builder class for creating provider adapters
+ */
+export class AdapterBuilder {
+    _id;
+    _name;
+    _models = [];
+    _capabilities = [];
+    _rateLimits = {};
+    _defaultModel;
+    _maxTokens = {};
+    _invokeFn;
+    _errorParserFn = defaultErrorParser;
+    _healthCheckFn;
+    constructor(name) {
+        if (name) {
+            this._name = name;
+        }
+    }
+    /**
+     * Set the adapter ID
+     */
+    id(id) {
+        if (!id || id.trim() === "") {
+            throw new BuilderValidationError("Adapter ID cannot be empty", "id");
+        }
+        this._id = id.toLowerCase();
+        return this;
+    }
+    /**
+     * Set the adapter name
+     */
+    name(name) {
+        if (!name || name.trim() === "") {
+            throw new BuilderValidationError("Adapter name cannot be empty", "name");
+        }
+        this._name = name;
+        return this;
+    }
+    /**
+     * Set supported models
+     */
+    models(...models) {
+        if (models.length === 0) {
+            throw new BuilderValidationError("At least one model must be specified", "models");
+        }
+        this._models = models;
+        if (!this._defaultModel) {
+            this._defaultModel = models[0];
+        }
+        return this;
+    }
+    /**
+     * Set default model (if different from first model)
+     */
+    defaultModel(model) {
+        if (!this._models.includes(model)) {
+            throw new BuilderValidationError(`Default model '${model}' must be in the models list`, "defaultModel");
+        }
+        this._defaultModel = model;
+        return this;
+    }
+    /**
+     * Set capabilities
+     */
+    capabilities(...capabilities) {
+        this._capabilities = capabilities;
+        return this;
+    }
+    /**
+     * Set rate limits
+     */
+    rateLimits(limits) {
+        this._rateLimits = limits;
+        return this;
+    }
+    /**
+     * Set token limits per model
+     */
+    maxTokens(model, tokens) {
+        this._maxTokens[model] = tokens;
+        return this;
+    }
+    /**
+     * Set the invoke function (required)
+     */
+    invoke(fn) {
+        if (typeof fn !== "function") {
+            throw new BuilderValidationError("Invoke must be a function", "invoke");
+        }
+        this._invokeFn = fn;
+        return this;
+    }
+    /**
+     * Set custom error parser
+     */
+    parseError(fn) {
+        if (typeof fn !== "function") {
+            throw new BuilderValidationError("parseError must be a function", "parseError");
+        }
+        this._errorParserFn = fn;
+        return this;
+    }
+    /**
+     * Set health check function
+     */
+    healthCheck(fn) {
+        if (typeof fn !== "function") {
+            throw new BuilderValidationError("healthCheck must be a function", "healthCheck");
+        }
+        this._healthCheckFn = fn;
+        return this;
+    }
+    /**
+     * Validate and build the adapter
+     */
+    build() {
+        // Validate required fields
+        if (!this._id) {
+            throw new BuilderValidationError("Adapter ID is required", "id");
+        }
+        if (!this._name) {
+            throw new BuilderValidationError("Adapter name is required", "name");
+        }
+        if (!this._invokeFn) {
+            throw new BuilderValidationError("Invoke function is required", "invoke");
+        }
+        return new BuiltAdapter({
+            id: this._id,
+            name: this._name,
+            models: this._models,
+            capabilities: this._capabilities,
+            rateLimits: this._rateLimits,
+            defaultModel: this._defaultModel ?? this._models[0],
+            maxTokens: { ...DEFAULT_TOKEN_LIMITS, ...this._maxTokens },
+            invokeFn: this._invokeFn,
+            errorParserFn: this._errorParserFn,
+            healthCheckFn: this._healthCheckFn,
+        });
+    }
+}
+/**
+ * Built adapter instance
+ */
+export class BuiltAdapter {
+    id;
+    name;
+    _models;
+    _capabilities;
+    _rateLimits;
+    _defaultModel;
+    _maxTokens;
+    _invokeFn;
+    _errorParserFn;
+    _healthCheckFn;
+    constructor(config) {
+        this.id = config.id;
+        this.name = config.name;
+        this._models = config.models;
+        this._capabilities = config.capabilities;
+        this._rateLimits = config.rateLimits;
+        this._defaultModel = config.defaultModel;
+        this._maxTokens = config.maxTokens;
+        this._invokeFn = config.invokeFn;
+        this._errorParserFn = config.errorParserFn;
+        this._healthCheckFn = config.healthCheckFn;
+    }
+    /**
+     * Get supported models
+     */
+    getModels() {
+        return [...this._models];
+    }
+    /**
+     * Get capabilities
+     */
+    getCapabilities() {
+        return [...this._capabilities];
+    }
+    /**
+     * Get rate limits
+     */
+    getRateLimits() {
+        return { ...this._rateLimits };
+    }
+    /**
+     * Check if model is supported
+     */
+    supportsModel(model) {
+        return this._models.some((m) => m.toLowerCase() === model.toLowerCase());
+    }
+    /**
+     * Get default model
+     */
+    getDefaultModel() {
+        return this._defaultModel;
+    }
+    /**
+     * Get max tokens for a model
+     */
+    getMaxTokens(model) {
+        const modelToCheck = model ?? this._defaultModel;
+        // Try exact match first
+        if (this._maxTokens[modelToCheck]) {
+            return this._maxTokens[modelToCheck];
+        }
+        // Try to find a prefix match
+        for (const [key, value] of Object.entries(this._maxTokens)) {
+            if (modelToCheck?.toLowerCase().startsWith(key.toLowerCase())) {
+                return value;
+            }
+        }
+        return this._maxTokens.default ?? 4096;
+    }
+    /**
+     * Invoke the adapter
+     */
+    async invoke(request) {
+        const start = Date.now();
+        try {
+            const response = await this._invokeFn(request);
+            return {
+                response,
+                retryable: false,
+                latencyMs: Date.now() - start,
+            };
+        }
+        catch (error) {
+            const errorAnalysis = this._errorParserFn(error);
+            const latencyMs = Date.now() - start;
+            return {
+                response: {
+                    content: "",
+                    error: errorAnalysis.message,
+                },
+                quotaSignal: errorAnalysis.quotaSignal,
+                retryable: errorAnalysis.rateLimited ||
+                    errorAnalysis.serverError ||
+                    errorAnalysis.timeout,
+                latencyMs,
+            };
+        }
+    }
+    /**
+     * Parse an error
+     */
+    parseError(error) {
+        return this._errorParserFn(error);
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        if (this._healthCheckFn) {
+            return this._healthCheckFn();
+        }
+        // Default health check - just return healthy
+        return {
+            healthy: true,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /**
+     * Convert to adapter info for registry
+     */
+    toConfig() {
+        return {
+            id: this.id,
+            name: this.name,
+            models: this._models,
+            capabilities: this._capabilities,
+            rateLimits: this._rateLimits,
+            defaultModel: this._defaultModel,
+            maxTokens: this._maxTokens,
+        };
+    }
+}
+//# sourceMappingURL=builder.js.map

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

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

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

@@ -0,0 +1,71 @@
+/**
+ * Provider Adapter SDK - Errors
+ *
+ * Custom error classes for the adapter SDK.
+ */
+/**
+ * Base error for adapter SDK
+ */
+export declare class AdapterError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, details?: Record<string, unknown> | undefined);
+}
+/**
+ * Thrown when an adapter is not found in registry
+ */
+export declare class AdapterNotFoundError extends AdapterError {
+    constructor(adapterId: string);
+}
+/**
+ * Thrown when an adapter is already registered
+ */
+export declare class AdapterAlreadyRegisteredError extends AdapterError {
+    constructor(adapterId: string);
+}
+/**
+ * Thrown when adapter invocation fails
+ */
+export declare class AdapterInvocationError extends AdapterError {
+    readonly adapterId: string;
+    readonly retryable: boolean;
+    readonly originalError?: unknown;
+    constructor(message: string, adapterId: string, retryable: boolean, originalError?: unknown);
+}
+/**
+ * Thrown when a model is not supported
+ */
+export declare class ModelNotSupportedError extends AdapterError {
+    constructor(model: string, adapterId: string, supportedModels: string[]);
+}
+/**
+ * Thrown when adapter is not in expected state
+ */
+export declare class AdapterStateError extends AdapterError {
+    constructor(adapterId: string, expectedState: string, actualState: string);
+}
+/**
+ * Thrown when compatibility check fails
+ */
+export declare class CompatibilityError extends AdapterError {
+    constructor(adapterId: string, issues: string[], sdkVersion: string, runtimeVersion?: string);
+}
+/**
+ * Thrown when test fails
+ */
+export declare class TestFailureError extends AdapterError {
+    constructor(adapterId: string, testName: string, message: string, error?: unknown);
+}
+/**
+ * Thrown when builder validation fails
+ */
+export declare class BuilderValidationError extends AdapterError {
+    constructor(message: string, field: string);
+}
+/**
+ * Thrown when lifecycle hook fails
+ */
+export declare class LifecycleError extends AdapterError {
+    constructor(hook: string, adapterId: string, originalError: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aAGrB,IAAI,EAAE,MAAM;aACZ,OAAO,CAAC;gBAFxB,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,qCAAyB;CAKlD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACzC,SAAS,EAAE,MAAM;CAM7B;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,YAAY;gBAClD,SAAS,EAAE,MAAM;CAQ7B;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;aAGtC,SAAS,EAAE,MAAM;aACjB,SAAS,EAAE,OAAO;aAClB,aAAa,CAAC;gBAH9B,OAAO,EAAE,MAAM,EACC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,EAClB,aAAa,CAAC,SAAS;CAQxC;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC3C,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE;CAQvE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;CAQzE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBAElD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,MAAM,EAClB,cAAc,CAAC,EAAE,MAAM;CASxB;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;gBAEhD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO;CAShB;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC3C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAI1C;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBACnC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO;CAQnE"}

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

@@ -0,0 +1,111 @@
+/**
+ * Provider Adapter SDK - Errors
+ *
+ * Custom error classes for the adapter SDK.
+ */
+/**
+ * Base error for adapter SDK
+ */
+export class AdapterError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "AdapterError";
+    }
+}
+/**
+ * Thrown when an adapter is not found in registry
+ */
+export class AdapterNotFoundError extends AdapterError {
+    constructor(adapterId) {
+        super(`Adapter '${adapterId}' not found in registry`, "ADAPTER_NOT_FOUND", {
+            adapterId,
+        });
+        this.name = "AdapterNotFoundError";
+    }
+}
+/**
+ * Thrown when an adapter is already registered
+ */
+export class AdapterAlreadyRegisteredError extends AdapterError {
+    constructor(adapterId) {
+        super(`Adapter '${adapterId}' is already registered`, "ADAPTER_ALREADY_REGISTERED", { adapterId });
+        this.name = "AdapterAlreadyRegisteredError";
+    }
+}
+/**
+ * Thrown when adapter invocation fails
+ */
+export class AdapterInvocationError extends AdapterError {
+    adapterId;
+    retryable;
+    originalError;
+    constructor(message, adapterId, retryable, originalError) {
+        super(message, "ADAPTER_INVOCATION_ERROR", {
+            adapterId,
+            retryable,
+        });
+        this.adapterId = adapterId;
+        this.retryable = retryable;
+        this.originalError = originalError;
+        this.name = "AdapterInvocationError";
+    }
+}
+/**
+ * Thrown when a model is not supported
+ */
+export class ModelNotSupportedError extends AdapterError {
+    constructor(model, adapterId, supportedModels) {
+        super(`Model '${model}' is not supported by adapter '${adapterId}'`, "MODEL_NOT_SUPPORTED", { model, adapterId, supportedModels });
+        this.name = "ModelNotSupportedError";
+    }
+}
+/**
+ * Thrown when adapter is not in expected state
+ */
+export class AdapterStateError extends AdapterError {
+    constructor(adapterId, expectedState, actualState) {
+        super(`Adapter '${adapterId}' is in state '${actualState}', expected '${expectedState}'`, "ADAPTER_STATE_ERROR", { adapterId, expectedState, actualState });
+        this.name = "AdapterStateError";
+    }
+}
+/**
+ * Thrown when compatibility check fails
+ */
+export class CompatibilityError extends AdapterError {
+    constructor(adapterId, issues, sdkVersion, runtimeVersion) {
+        super(`Adapter '${adapterId}' is not compatible: ${issues.join(", ")}`, "COMPATIBILITY_ERROR", { adapterId, issues, sdkVersion, runtimeVersion });
+        this.name = "CompatibilityError";
+    }
+}
+/**
+ * Thrown when test fails
+ */
+export class TestFailureError extends AdapterError {
+    constructor(adapterId, testName, message, error) {
+        super(`Test '${testName}' failed for adapter '${adapterId}': ${message}`, "TEST_FAILURE", { adapterId, testName, originalError: error });
+        this.name = "TestFailureError";
+    }
+}
+/**
+ * Thrown when builder validation fails
+ */
+export class BuilderValidationError extends AdapterError {
+    constructor(message, field) {
+        super(message, "BUILDER_VALIDATION_ERROR", { field });
+        this.name = "BuilderValidationError";
+    }
+}
+/**
+ * Thrown when lifecycle hook fails
+ */
+export class LifecycleError extends AdapterError {
+    constructor(hook, adapterId, originalError) {
+        super(`Lifecycle hook '${hook}' failed for adapter '${adapterId}'`, "LIFECYCLE_ERROR", { hook, adapterId, originalError });
+        this.name = "LifecycleError";
+    }
+}
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * Provider Adapter SDK
+ *
+ * A comprehensive SDK for building, testing, and registering provider adapters.
+ */
+export { AdapterBuilder, BuiltAdapter } from "./builder.js";
+export { AdapterRegistry, type RegistryConfig } from "./registry.js";
+export { AdapterTester, assertTestResults, } from "./tester.js";
+export type { AdapterVersion, AdapterResult, ErrorAnalysis, QuotaSignal, RateLimitConfig, AdapterBuilderConfig, InvokeFunction, ErrorParserFunction, HealthCheckFunction, HealthCheckResult, AdapterInfo, AdapterLifecycle, AdapterState, CompatibilityResult, TestConfig, TestResult, TestReport, MockResponse, RegistryEvents, ProviderCapability, ProviderRequest, ProviderResponse, } from "./types.js";
+export { AdapterError, AdapterNotFoundError, AdapterAlreadyRegisteredError, AdapterInvocationError, ModelNotSupportedError, AdapterStateError, CompatibilityError, TestFailureError, BuilderValidationError, LifecycleError, } from "./errors.js";
+/**
+ * SDK version
+ */
+export { SDK_VERSION, SDK_VERSION as ADAPTER_SDK_VERSION } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAI5D,OAAO,EAAE,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAIrE,OAAO,EACN,aAAa,EACb,iBAAiB,GACjB,MAAM,aAAa,CAAC;AAIrB,YAAY,EAEX,cAAc,EACd,aAAa,EACb,aAAa,EACb,WAAW,EACX,eAAe,EAEf,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EAEjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EAEnB,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EAEZ,cAAc,EAEd,kBAAkB,EAClB,eAAe,EACf,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAIpB,OAAO,EACN,YAAY,EACZ,oBAAoB,EACpB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,GACd,MAAM,aAAa,CAAC;AAIrB;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * Provider Adapter SDK
+ *
+ * A comprehensive SDK for building, testing, and registering provider adapters.
+ */
+// ─── Builder ────────────────────────────────────────────────────────────────
+export { AdapterBuilder, BuiltAdapter } from "./builder.js";
+// ─── Registry ────────────────────────────────────────────────────────────────
+export { AdapterRegistry } from "./registry.js";
+// ─── Tester ─────────────────────────────────────────────────────────────────
+export { AdapterTester, assertTestResults, } from "./tester.js";
+// ─── Errors ─────────────────────────────────────────────────────────────────
+export { AdapterError, AdapterNotFoundError, AdapterAlreadyRegisteredError, AdapterInvocationError, ModelNotSupportedError, AdapterStateError, CompatibilityError, TestFailureError, BuilderValidationError, LifecycleError, } from "./errors.js";
+// ─── Constants ───────────────────────────────────────────────────────────────
+/**
+ * SDK version
+ */
+export { SDK_VERSION, SDK_VERSION as ADAPTER_SDK_VERSION } from "./types.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAE/E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5D,gFAAgF;AAEhF,OAAO,EAAE,eAAe,EAAuB,MAAM,eAAe,CAAC;AAErE,+EAA+E;AAE/E,OAAO,EACN,aAAa,EACb,iBAAiB,GACjB,MAAM,aAAa,CAAC;AAmCrB,+EAA+E;AAE/E,OAAO,EACN,YAAY,EACZ,oBAAoB,EACpB,6BAA6B,EAC7B,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,cAAc,GACd,MAAM,aAAa,CAAC;AAErB,gFAAgF;AAEhF;;GAEG;AACH,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,YAAY,CAAC"}