@holokai/sdk 0.1.0

package/dist/plugin/manifest.d.ts

@@ -0,0 +1,349 @@
+/**
+ * Plugin manifest schema for the Holo plugin system.
+ * Defines metadata, capabilities, and requirements for plugins.
+ */
+/**
+ * Plugin type enumeration
+ */
+export type PluginType = 'provider' | 'guard' | 'evaluator' | 'logger' | 'worker';
+/**
+ * Plugin category for marketplace organization
+ */
+export type PluginCategory = 'ai-providers' | 'security' | 'monitoring' | 'evaluation' | 'processing' | 'integration' | 'utility';
+/**
+ * Pricing model for marketplace plugins
+ */
+export interface PluginPricing {
+    model: 'free' | 'paid' | 'freemium' | 'subscription' | 'usage-based';
+    /**
+     * Price in base currency units (not cents).
+     * Specify whether per seat, per org, etc. in documentation.
+     */
+    price?: number;
+    currency?: string;
+    billingPeriod?: 'monthly' | 'yearly' | 'one-time';
+    trialDays?: number;
+    pricingUrl?: string;
+}
+/**
+ * Support information for plugin users
+ */
+export interface PluginSupport {
+    email?: string;
+    url?: string;
+    discord?: string;
+    slack?: string;
+    /**
+     * URL pointing to documentation index/homepage
+     */
+    documentation?: string;
+}
+/**
+ * Plugin capabilities declaration
+ */
+export interface PluginCapabilities {
+    /**
+     * Supports configuration hot reload without restart
+     */
+    supportsHotReload?: boolean;
+    /**
+     * Can operate in distributed/clustered mode
+     */
+    supportsDistributed?: boolean;
+    /**
+     * Supports async/background processing
+     */
+    supportsAsync?: boolean;
+    /**
+     * Supports request batching
+     */
+    supportsBatching?: boolean;
+    /**
+     * Supports streaming responses
+     */
+    supportsStreaming?: boolean;
+    /**
+     * Custom capability flags (e.g. "supportsMultiTenant": true).
+     * Keys SHOULD be stable and documented per plugin or plugin type.
+     * Values must be boolean or numeric capabilities.
+     */
+    [key: string]: boolean | number | undefined;
+}
+/**
+ * JSON Schema node definition (Draft 7–style).
+ *
+ * This represents a generic schema node that can be used at any level
+ * (root, property, items, nested objects, etc.).
+ */
+export interface JSONSchemaProperty {
+    type?: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null';
+    description?: string;
+    default?: string | number | boolean | null | object | Array<unknown>;
+    enum?: Array<string | number | boolean | null>;
+    const?: string | number | boolean | null;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: string;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    items?: JSONSchemaProperty | JSONSchemaProperty[];
+    minItems?: number;
+    maxItems?: number;
+    uniqueItems?: boolean;
+    properties?: Record<string, JSONSchemaProperty>;
+    required?: string[];
+    additionalProperties?: boolean | JSONSchemaProperty;
+    patternProperties?: Record<string, JSONSchemaProperty>;
+    allOf?: JSONSchemaProperty[];
+    anyOf?: JSONSchemaProperty[];
+    oneOf?: JSONSchemaProperty[];
+    not?: JSONSchemaProperty;
+    $ref?: string;
+    title?: string;
+    examples?: unknown[];
+}
+/**
+ * Configuration schema for runtime validation.
+ *
+ * This is the *root* JSON Schema object for a plugin's configuration and
+ * must describe an object shape. It is what the host uses to validate
+ * user-provided configuration for this plugin.
+ */
+export interface ConfigSchema extends JSONSchemaProperty {
+    /**
+     * JSON Schema dialect identifier (optional).
+     * Example: "http://json-schema.org/draft-07/schema#"
+     */
+    $schema?: string;
+    /**
+     * Type of the root configuration object.
+     * Must be "object" for all plugin configs.
+     */
+    type: 'object';
+    /**
+     * Property definitions for the configuration object.
+     */
+    properties: Record<string, JSONSchemaProperty>;
+    /**
+     * Required properties for the configuration object.
+     */
+    required?: string[];
+    /**
+     * Additional properties allowed on the configuration object.
+     */
+    additionalProperties?: boolean | JSONSchemaProperty;
+    /**
+     * Pattern-based property definitions for the configuration object.
+     */
+    patternProperties?: Record<string, JSONSchemaProperty>;
+    /**
+     * Dependencies between properties on the configuration object.
+     */
+    dependencies?: Record<string, string[] | JSONSchemaProperty>;
+    /**
+     * Minimum number of properties on the configuration object.
+     */
+    minProperties?: number;
+    /**
+     * Maximum number of properties on the configuration object.
+     */
+    maxProperties?: number;
+}
+/**
+ * Plugin manifest with comprehensive metadata
+ *
+ * @example
+ * ```typescript
+ * const manifest: PluginManifest = {
+ *   // Required fields
+ *   name: '@holokai/provider-openai',
+ *   version: '1.0.0',
+ *   pluginType: 'provider',
+ *   displayName: 'OpenAI Provider',
+ *   description: 'Official OpenAI integration for Holo',
+ *
+ *   // Optional metadata
+ *   author: 'Holo Team',
+ *   license: 'MIT',
+ *   homepage: 'https://docs.holo.ai/plugins/openai',
+ *   repository: {
+ *     type: 'git',
+ *     url: 'https://github.com/holo-ai/provider-openai'
+ *   },
+ *
+ *   // Technical requirements
+ *   engineVersion: '>=1.0.0',
+ *   dependencies: {
+ *     'openai': '^4.0.0'
+ *   },
+ *
+ *   // Capabilities
+ *   capabilities: {
+ *     supportsStreaming: true,
+ *     supportsHotReload: true
+ *   },
+ *
+ *   // Permissions
+ *   permissions: ['network']
+ * };
+ * ```
+ */
+export interface PluginManifest {
+    /**
+     * Unique plugin identifier and canonical key in the Holo ecosystem.
+     * Follows npm naming conventions and is used as the plugin ID everywhere
+     * (registry key, internal maps, etc.).
+     * Should be scoped (e.g., @org/plugin-name) for published plugins.
+     */
+    name: string;
+    /**
+     * Semantic version of the plugin (e.g., "1.2.3").
+     * Must follow semver specification.
+     */
+    version: string;
+    /**
+     * Type of plugin functionality.
+     * Determines which interface the plugin must implement.
+     */
+    pluginType: PluginType;
+    /**
+     * Plugin family identifier for grouping related plugins.
+     * Used for version management and plugin resolution.
+     */
+    family?: string;
+    /**
+     * Human-readable name for UI display.
+     * Used in marketplace and admin interfaces.
+     */
+    displayName: string;
+    /**
+     * Brief description of plugin functionality.
+     * Should be 1-2 sentences explaining what the plugin does.
+     */
+    description: string;
+    /**
+     * Plugin author or organization.
+     * Can be a string or an object with name, email, and url.
+     */
+    author?: string | {
+        name: string;
+        email?: string;
+        url?: string;
+    };
+    /**
+     * License identifier (SPDX format preferred).
+     * Examples: "MIT", "Apache-2.0", "GPL-3.0"
+     */
+    license?: string;
+    /**
+     * Plugin homepage URL.
+     * Should link to documentation or marketing page.
+     */
+    homepage?: string;
+    /**
+     * Source code repository information.
+     * Follows npm package.json repository format.
+     */
+    repository?: string | {
+        type: string;
+        url: string;
+        directory?: string;
+    };
+    /**
+     * Issue tracker URL.
+     * Where users can report bugs or request features.
+     */
+    bugs?: string | {
+        url?: string;
+        email?: string;
+    };
+    /**
+     * Searchable keywords for plugin discovery.
+     * Used in marketplace search and filtering.
+     */
+    keywords?: string[];
+    /**
+     * Required host/engine version range (semver).
+     * Example: ">=1.0.0 <2.0.0"
+     */
+    engineVersion?: string;
+    /**
+     * Runtime dependencies required by the plugin.
+     * Uses npm-style dependency specification.
+     */
+    dependencies?: Record<string, string>;
+    /**
+     * Peer dependencies expected in the host environment.
+     * Used for shared dependencies to avoid duplication.
+     */
+    peerDependencies?: Record<string, string>;
+    /**
+     * Plugin capability declarations.
+     * Used by the host to understand plugin features.
+     */
+    capabilities?: PluginCapabilities;
+    /**
+     * Required permissions for plugin operation.
+     * Examples: ["network", "filesystem", "env"]
+     * The host is responsible for enforcing or denying these.
+     * This is the canonical list of required runtime permissions.
+     */
+    permissions?: string[];
+    /**
+     * JSON Schema for configuration validation.
+     * Should be a valid JSON Schema object with "type": "object" at the root.
+     * Used to validate plugin configuration at runtime.
+     */
+    configSchema?: ConfigSchema;
+    /**
+     * Marketplace category for plugin organization.
+     */
+    category?: PluginCategory;
+    /**
+     * Screenshot URLs for marketplace display.
+     * Should be publicly accessible image URLs.
+     */
+    screenshots?: string[];
+    /**
+     * URL to plugin changelog.
+     * Used to communicate updates to users.
+     */
+    changelog?: string;
+    /**
+     * Pricing information for commercial plugins.
+     */
+    pricing?: PluginPricing;
+    /**
+     * Support contact information.
+     */
+    support?: PluginSupport;
+    /**
+     * Minimum supported previous version (semver range) for in-place upgrades.
+     * Used to determine safe upgrade paths and migration steps.
+     * Example: ">=0.9.0"
+     */
+    upgradeFrom?: string;
+    /**
+     * Plugin entrypoint file (relative to package root).
+     * Defaults to "dist/index.js" if not specified.
+     */
+    main?: string;
+    /**
+     * TypeScript type definitions file.
+     * Used for TypeScript integration.
+     */
+    types?: string;
+    /**
+     * Custom metadata for future extensions.
+     * Allows plugins to include additional metadata.
+     * Values must be primitive types or arrays of primitives.
+     */
+    custom?: {
+        [key: string]: string | number | boolean | string[] | number[] | undefined;
+    };
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/plugin/manifest.d.ts.map

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

package/dist/plugin/manifest.js

@@ -0,0 +1,6 @@
+/**
+ * Plugin manifest schema for the Holo plugin system.
+ * Defines metadata, capabilities, and requirements for plugins.
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/plugin/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/plugin/manifest.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/plugin/provider.d.ts

@@ -0,0 +1,55 @@
+import { IProvider, IProviderTranslator, IWireAdapter, ProviderCapabilities as ProviderFeatures, WireAdapterParams } from '../provider/index';
+import { IPlugin } from "./base";
+import { RouteHandler, RouteTree } from "../core/routes";
+/**
+ * Provider plugin interface for LLM integrations.
+ * @template TProvider The type of provider instance created by this plugin.
+ *
+ * @example
+ * ```typescript
+ * class OpenAIPlugin
+ *   extends BasePlugin
+ *   implements IProviderPlugin<OpenAIProvider>
+ * {
+ *   async createProvider(config: ProviderConfig): Promise<OpenAIProvider> {
+ *     return new OpenAIProvider(config);
+ *   }
+ *
+ *   async validateConfig(config: ProviderConfig): Promise<boolean> {
+ *     return !!config.api_key && !!config.model;
+ *   }
+ *
+ *   getCapabilities(): ProviderFeatures {
+ *     return {
+ *       streaming: true,
+ *       embedding: true,
+ *       vision: true,
+ *       function_calling: true,
+ *       supported_models: ['gpt-4', 'gpt-3.5-turbo']
+ *     };
+ *   }
+ *
+ *   getSupportedModels(): string[] {
+ *     return this.getCapabilities().supported_models;
+ *   }
+ * }
+ * ```
+ */
+export interface IProviderPlugin<TProvider = IProvider> extends IPlugin {
+    translator: IProviderTranslator;
+    defaultRouteHandler?: RouteHandler;
+    /**
+     * Create a provider instance with the given configuration.
+     * @param config Provider configuration including API keys and model settings.
+     * @returns Promise resolving to a provider instance.
+     */
+    createProvider(config: any): Promise<TProvider>;
+    /**
+     * Get provider capabilities.
+     * @returns Provider capabilities including supported features and models.
+     */
+    getCapabilities(): ProviderFeatures;
+    getRoutes(): RouteTree;
+    createWireAdapter(params: WireAdapterParams): IWireAdapter;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/plugin/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/plugin/provider.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,SAAS,EACT,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,IAAI,gBAAgB,EACxC,iBAAiB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAC/B,OAAO,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,WAAW,eAAe,CAAC,SAAS,GAAG,SAAS,CAAE,SAAQ,OAAO;IACnE,UAAU,EAAE,mBAAmB,CAAA;IAC/B,mBAAmB,CAAC,EAAE,YAAY,CAAA;IAElC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhD;;;OAGG;IACH,eAAe,IAAI,gBAAgB,CAAC;IAEpC,SAAS,IAAI,SAAS,CAAC;IAEvB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC;CAE9D"}

package/dist/plugin/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/plugin/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/plugin/provider.ts"],"names":[],"mappings":""}

package/dist/plugin/registry.d.ts

@@ -0,0 +1,7 @@
+import { IPlugin } from "./base";
+export interface IPluginRegistry<T extends IPlugin> {
+    registerPlugin(plugin: T, version?: string, isLatest?: boolean): void;
+    unregisterPlugin(id: string, version?: string): void;
+    listPlugins(): T[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugin/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AAE/B,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,OAAO;IAC9C,cAAc,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAEtE,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAErD,WAAW,IAAI,CAAC,EAAE,CAAC;CACtB"}

package/dist/plugin/registry.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=registry.js.map

package/dist/plugin/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/plugin/registry.ts"],"names":[],"mappings":""}

package/dist/provider/auditor/base.d.ts

@@ -0,0 +1,21 @@
+import { HoloWorkerRequest, WorkerRequestEnvelope, WorkerResponseEnvelope } from "../../core/worker";
+import { ClassLogger } from "../../core";
+import { ProviderEnvelope, ProviderEvent } from "../types";
+import { LlmRequest, LlmResponse } from "../../core/entities";
+export interface IAuditor {
+    readonly provider: string;
+    auditRequest(workerRequest: HoloWorkerRequest): Promise<LlmRequest>;
+    createWorkerResponseEnvelope(workerRequest: HoloWorkerRequest, workerId?: string): Promise<WorkerResponseEnvelope>;
+    auditResponse(responseEnvelope: WorkerResponseEnvelope, providerEvent: ProviderEvent): Promise<LlmResponse>;
+}
+export declare abstract class BaseAuditor extends ClassLogger implements IAuditor {
+    abstract readonly provider: string;
+    createWorkerRequestEnvelope(workerRequest: HoloWorkerRequest): Promise<WorkerRequestEnvelope>;
+    createWorkerResponseEnvelope(workerRequest: HoloWorkerRequest, workerId?: string): Promise<WorkerResponseEnvelope>;
+    auditRequest(workerRequest: HoloWorkerRequest): Promise<LlmRequest>;
+    protected abstract toHoloRequest(workerRequest: HoloWorkerRequest, llmRequest: Omit<LlmRequest, 'id'>): void;
+    protected abstract mapProviderPayload(workerRequest: HoloWorkerRequest, llmRequest: Omit<LlmRequest, 'id'>): void;
+    auditResponse(responseEnvelope: WorkerResponseEnvelope, providerEvent: ProviderEvent): Promise<LlmResponse>;
+    protected abstract createProviderEnvelope(payload: any): Promise<ProviderEnvelope>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/provider/auditor/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/provider/auditor/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAE,qBAAqB,EAAE,sBAAsB,EAAC,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAC,WAAW,EAAc,MAAM,YAAY,CAAC;AACpD,OAAO,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC;AACzD,OAAO,EAAC,UAAU,EAAE,WAAW,EAAY,MAAM,qBAAqB,CAAC;AAGvE,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEpE,4BAA4B,CAAC,aAAa,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnH,aAAa,CACT,gBAAgB,EAAE,sBAAsB,EACxC,aAAa,EAAE,aAAa,GAC7B,OAAO,CAAC,WAAW,CAAC,CAAC;CAC3B;AAED,8BAAsB,WAAY,SAAQ,WAAY,YAAW,QAAQ;IACrE,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE7B,2BAA2B,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA0B7F,4BAA4B,CAAC,aAAa,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAalH,YAAY,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAezE,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,IAAI;IAE5G,SAAS,CAAC,QAAQ,CAAC,kBAAkB,CAAC,aAAa,EAAE,iBAAiB,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,IAAI;IAE3G,aAAa,CACf,gBAAgB,EAAE,sBAAsB,EACxC,aAAa,EAAE,aAAa,GAC7B,OAAO,CAAC,WAAW,CAAC;IAWvB,SAAS,CAAC,QAAQ,CAAC,sBAAsB,CACrC,OAAO,EAAE,GAAG,GACb,OAAO,CAAC,gBAAgB,CAAC;CAC/B"}

package/dist/provider/auditor/base.js

@@ -0,0 +1,58 @@
+import { ClassLogger, pickDefined } from "../../core";
+import { LlmStatus } from "../../core/entities";
+export class BaseAuditor extends ClassLogger {
+    async createWorkerRequestEnvelope(workerRequest) {
+        const logger = this.mlog(this.createWorkerResponseEnvelope);
+        if (!workerRequest.requestId) {
+            logger.error(`No requestId for workerRequest: ${JSON.stringify(workerRequest)}`);
+        }
+        const providerEnvelope = await this.createProviderEnvelope(workerRequest.payload);
+        return pickDefined({
+            request_id: workerRequest.requestId,
+            request_type: workerRequest.type,
+            organization_id: workerRequest.organizationId,
+            application_id: workerRequest.appSlug ?? 'default',
+            user_id: workerRequest.userId,
+            provider_slug: workerRequest.providerName,
+            timestamp: new Date(workerRequest.timestamp).toISOString(),
+            source_id: workerRequest.sourceId,
+            thread_id: workerRequest.thread_id,
+            branch_id: workerRequest.branch_id,
+            raw_request: workerRequest.payload,
+            ...providerEnvelope
+        });
+    }
+    async createWorkerResponseEnvelope(workerRequest, workerId) {
+        return pickDefined({
+            worker_id: workerId,
+            request_id: workerRequest.requestId,
+            request_type: workerRequest.type,
+            organization_id: workerRequest.organizationId,
+            application_id: workerRequest.appSlug ?? 'default',
+            user_id: workerRequest.userId,
+            provider_slug: workerRequest.providerName,
+            ...await this.createProviderEnvelope(workerRequest.payload)
+        });
+    }
+    async auditRequest(workerRequest) {
+        const requestEnvelope = await this.createWorkerRequestEnvelope(workerRequest);
+        const llmRequest = {
+            ...requestEnvelope
+        };
+        // Call provider-specific mapping methods to extract user_prompt, options, etc.
+        this.toHoloRequest(workerRequest, llmRequest);
+        this.mapProviderPayload(workerRequest, llmRequest);
+        return pickDefined(llmRequest);
+    }
+    async auditResponse(responseEnvelope, providerEvent) {
+        return pickDefined({
+            ...responseEnvelope,
+            created_at: providerEvent.ts ? new Date(providerEvent.ts).toISOString() : new Date().toISOString(),
+            status: LlmStatus.SUCCESS,
+            cost: 0,
+            response: providerEvent.type === 'done' || providerEvent.type === 'text_delta' ? providerEvent.text : JSON.stringify(providerEvent),
+            response_raw: providerEvent
+        });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/provider/auditor/base.js.map

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

package/dist/provider/auditor/index.d.ts

@@ -0,0 +1,2 @@
+export * from './base';
+//# sourceMappingURL=index.d.ts.map

package/dist/provider/auditor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/provider/auditor/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/provider/auditor/index.js

@@ -0,0 +1,2 @@
+export * from './base';
+//# sourceMappingURL=index.js.map

package/dist/provider/auditor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/provider/auditor/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/provider/base.d.ts

@@ -0,0 +1,39 @@
+import { AsyncEventQueue, IProvider, IResponseFactory, ModelInfo, ProviderContext, ProviderEvent } from "./types";
+import { HoloWorkerRequest, WorkerRequestEnvelope } from "../core/worker/index";
+import { ClassLogger } from "../core/index";
+import { IAuditor } from "./auditor/index";
+import { IProviderTranslator } from "./translator/index";
+import { LlmRequest, LlmResponse } from "../core/entities/index";
+export type ProviderRunner<Final = any> = {
+    final: () => Promise<Final>;
+    cancel?: () => void;
+};
+export declare abstract class BaseProvider<ProviderClient = any, RequestPayload = any, Final = any> extends ClassLogger implements IProvider {
+    readonly name: string;
+    readonly family: string;
+    readonly version: string;
+    protected readonly _config: any;
+    protected models: Record<string, ModelInfo>;
+    protected readonly client: ProviderClient;
+    readonly auditor: IAuditor;
+    readonly translator: IProviderTranslator;
+    readonly responseFactory: IResponseFactory;
+    constructor(name: string, family: string, version: string, _config: any);
+    protected abstract createClient(): ProviderClient;
+    protected abstract createAuditor(): IAuditor;
+    protected abstract createTranslator(): IProviderTranslator;
+    protected abstract createResponseFactory(): IResponseFactory;
+    abstract getModels(allowedModels: string[] | true): Promise<any>;
+    auditRequest(workerRequest: HoloWorkerRequest): Promise<LlmRequest>;
+    auditResponse(workerEnvelope: WorkerRequestEnvelope, providerEvent: ProviderEvent): Promise<LlmResponse>;
+    processWorkerRequest(request: HoloWorkerRequest, _opts?: {
+        signal?: AbortSignal;
+    }): Promise<AsyncEventQueue<ProviderEvent>>;
+    protected abstract handleError(error: any): Promise<any>;
+    protected abstract handleRequest(payload: RequestPayload, ctx: ProviderContext): Promise<ProviderRunner<Final>>;
+    protected getHeaders(request: HoloWorkerRequest, config: any): Record<string, string>;
+    private createEventPusher;
+    private handlePassthrough;
+    get id(): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/provider/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/provider/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,eAAe,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAChH,OAAO,EAAC,iBAAiB,EAAE,qBAAqB,EAAC,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAC,WAAW,EAA6D,MAAM,eAAe,CAAC;AACtG,OAAO,EAAC,QAAQ,EAAC,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAC,UAAU,EAAE,WAAW,EAAC,MAAM,wBAAwB,CAAC;AAG/D,MAAM,MAAM,cAAc,CAAC,KAAK,GAAG,GAAG,IAAI;IAAE,KAAK,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAE/F,8BAAsB,YAAY,CAAC,cAAc,GAAG,GAAG,EAAE,cAAc,GAAG,GAAG,EAAE,KAAK,GAAG,GAAG,CAAE,SAAQ,WAAY,YAAW,SAAS;aAQ5G,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;aACd,OAAO,EAAE,MAAM;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG;IAVnC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAM;IACjD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAC1C,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,UAAU,EAAE,mBAAmB,CAAC;IAChD,SAAgB,eAAe,EAAE,gBAAgB,CAAC;gBAG9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG;IAUnC,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,cAAc;IAEjD,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ;IAE5C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,IAAI,mBAAmB;IAE1D,SAAS,CAAC,QAAQ,CAAC,qBAAqB,IAAI,gBAAgB;IAE5D,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;IAE1D,YAAY,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAInE,aAAa,CACf,cAAc,EAAE,qBAAqB,EACrC,aAAa,EAAE,aAAa,GAC7B,OAAO,CAAC,WAAW,CAAC;IAIjB,oBAAoB,CACtB,OAAO,EAAE,iBAAiB,EAC1B,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC;IAsE1C,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAExD,SAAS,CAAC,QAAQ,CAAC,aAAa,CAC5B,OAAO,EAAE,cAAc,EACvB,GAAG,EAAE,eAAe,GACrB,OAAO,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAEjC,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAarF,OAAO,CAAC,iBAAiB;YAOX,iBAAiB;IAoE/B,IAAI,EAAE,IAAI,MAAM,CAEf;CACJ"}