@agntk/core 0.1.0

package/dist/models.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @agntk/core - Model Configuration
+ *
+ * Model tier definitions supporting multiple providers.
+ * All providers use @ai-sdk/openai-compatible for unified access.
+ */
+import type { LanguageModel } from 'ai';
+export type ModelTier = 'fast' | 'standard' | 'reasoning' | 'powerful';
+export type ModelProvider = 'openrouter' | 'ollama' | 'openai' | (string & {});
+export interface ModelConfig {
+    provider: ModelProvider;
+    name: string;
+}
+export declare const models: {
+    fast: () => LanguageModel;
+    standard: () => LanguageModel;
+    reasoning: () => LanguageModel;
+    powerful: () => LanguageModel;
+};
+export interface ModelResolutionOptions {
+    /** Specific model tier to use */
+    tier?: ModelTier;
+    /** Specific provider to use */
+    provider?: ModelProvider;
+    /** Specific model name (overrides tier/provider) */
+    modelName?: string;
+}
+/**
+ * Resolves a model based on options.
+ *
+ * Priority:
+ * 1. Explicit modelName with provider
+ * 2. Tier-based selection from config (env vars > config file > defaults)
+ * 3. Default tier (standard) with default provider
+ */
+export declare function resolveModel(options?: ModelResolutionOptions): LanguageModel;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAkFxC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AACvE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AA4CD,eAAO,MAAM,MAAM;gBACP,aAAa;oBACT,aAAa;qBACZ,aAAa;oBACd,aAAa;CAC5B,CAAC;AAMF,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa,CAsBhF"}

package/dist/models.js

@@ -0,0 +1,131 @@
+/**
+ * @agntk/core - Model Configuration
+ *
+ * Model tier definitions supporting multiple providers.
+ * All providers use @ai-sdk/openai-compatible for unified access.
+ */
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import { createLogger } from '@agntk/logger';
+import { getModelForTier, getConfig, DEFAULT_MODELS, DEFAULT_PROVIDER } from './config/index.js';
+const log = createLogger('@agntk/core:models');
+const PROVIDER_CONFIGS = {
+    openrouter: {
+        name: 'openrouter',
+        baseURL: 'https://openrouter.ai/api/v1',
+        apiKeyEnv: 'OPENROUTER_API_KEY',
+    },
+    ollama: {
+        name: 'ollama',
+        baseURL: process.env['OLLAMA_BASE_URL'] || 'http://localhost:11434/v1',
+        apiKeyEnv: 'OLLAMA_API_KEY', // Ollama typically doesn't need a key, but support it
+    },
+    openai: {
+        name: 'openai',
+        baseURL: 'https://api.openai.com/v1',
+        apiKeyEnv: 'OPENAI_API_KEY',
+    },
+};
+// ============================================================================
+// Provider Instances (Lazy Initialization)
+// ============================================================================
+const providerInstances = new Map();
+function getProvider(providerName) {
+    let instance = providerInstances.get(providerName);
+    if (instance)
+        return instance;
+    // Check for custom providers in config
+    const config = getConfig();
+    const customProviders = config.models?.customProviders;
+    const customConfig = customProviders?.[providerName];
+    let providerConfig;
+    if (customConfig) {
+        providerConfig = {
+            name: providerName,
+            baseURL: customConfig.baseURL,
+            apiKeyEnv: customConfig.apiKeyEnv,
+            headers: customConfig.headers,
+        };
+    }
+    else if (PROVIDER_CONFIGS[providerName]) {
+        providerConfig = PROVIDER_CONFIGS[providerName];
+    }
+    else {
+        throw new Error(`Unknown provider: ${providerName}. Configure it in models.customProviders.`);
+    }
+    const apiKey = process.env[providerConfig.apiKeyEnv] || '';
+    log.debug('Initializing provider', { name: providerConfig.name, baseURL: providerConfig.baseURL });
+    instance = createOpenAICompatible({
+        name: providerConfig.name,
+        baseURL: providerConfig.baseURL,
+        apiKey,
+        headers: providerConfig.headers,
+    });
+    providerInstances.set(providerName, instance);
+    return instance;
+}
+// ============================================================================
+// Environment Variable Model Overrides
+// ============================================================================
+function getEnvModel(tier) {
+    const envKey = `MODEL_${tier.toUpperCase()}`;
+    return process.env[envKey];
+}
+function getOllamaEnvModel(tier) {
+    const envKey = `OLLAMA_${tier.toUpperCase()}_MODEL`;
+    return process.env[envKey];
+}
+// ============================================================================
+// Model Creation Functions
+// ============================================================================
+function createModelForProvider(provider, modelName) {
+    const providerInstance = getProvider(provider);
+    return providerInstance(modelName);
+}
+// ============================================================================
+// Model Tier Functions
+// ============================================================================
+/**
+ * Create a model for a given tier, respecting env overrides and Ollama fallback.
+ */
+function createTierModel(tier) {
+    if (process.env['OLLAMA_ENABLED'] === 'true') {
+        const modelName = getOllamaEnvModel(tier) || DEFAULT_MODELS.ollama[tier];
+        return createModelForProvider('ollama', modelName);
+    }
+    const modelName = getEnvModel(tier) || DEFAULT_MODELS.openrouter[tier];
+    return createModelForProvider('openrouter', modelName);
+}
+export const models = {
+    fast: () => createTierModel('fast'),
+    standard: () => createTierModel('standard'),
+    reasoning: () => createTierModel('reasoning'),
+    powerful: () => createTierModel('powerful'),
+};
+/**
+ * Resolves a model based on options.
+ *
+ * Priority:
+ * 1. Explicit modelName with provider
+ * 2. Tier-based selection from config (env vars > config file > defaults)
+ * 3. Default tier (standard) with default provider
+ */
+export function resolveModel(options = {}) {
+    const { tier = 'standard', provider, modelName } = options;
+    const config = getConfig();
+    // If explicit model name provided with provider
+    if (modelName && provider) {
+        log.info('Resolving model (explicit)', { provider, modelName });
+        return createModelForProvider(provider, modelName);
+    }
+    // If modelName looks like "provider/model", route through OpenRouter
+    if (modelName && modelName.includes('/')) {
+        log.info('Resolving model (OpenRouter format)', { modelName });
+        return createModelForProvider('openrouter', modelName);
+    }
+    // Use tier-based selection from config
+    const effectiveProvider = provider ?? config.models?.defaultProvider ?? DEFAULT_PROVIDER;
+    const effectiveModel = getModelForTier(tier, effectiveProvider);
+    log.info('Resolving model (tier-based)', { tier, provider: effectiveProvider, model: effectiveModel });
+    return createModelForProvider(effectiveProvider, effectiveModel);
+}
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

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

package/dist/observability/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Observability module public API.
+ */
+export type { ObservabilityConfig, LangfuseConfig, TelemetrySettings } from './types.js';
+export { initObservability, createTelemetrySettings, isObservabilityEnabled, shutdownObservability, } from './langfuse.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACtF,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Observability module public API.
+ */
+export { initObservability, createTelemetrySettings, isObservabilityEnabled, shutdownObservability, } from './langfuse.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/observability/langfuse.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Langfuse observability integration for AI SDK.
+ * Uses OpenTelemetry to trace AI SDK calls via Langfuse.
+ *
+ * This module is designed to be optional — langfuse is a peer dependency.
+ * If not installed, observability features gracefully degrade (no-op).
+ */
+import type { ObservabilityConfig, TelemetrySettings } from './types.js';
+/**
+ * Initialize observability provider (currently Langfuse).
+ *
+ * Must be called before any AI SDK calls to enable tracing.
+ * This sets up the OpenTelemetry span processor that sends
+ * traces to Langfuse.
+ *
+ * @example
+ * ```typescript
+ * import { initObservability } from '@agntk/core';
+ *
+ * await initObservability({
+ *   provider: 'langfuse',
+ *   langfuse: {
+ *     publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+ *     secretKey: process.env.LANGFUSE_SECRET_KEY,
+ *   },
+ * });
+ * ```
+ */
+export declare function initObservability(config: ObservabilityConfig): Promise<boolean>;
+/**
+ * Create telemetry settings for AI SDK calls.
+ * Returns settings that enable OpenTelemetry tracing.
+ */
+export declare function createTelemetrySettings(options?: {
+    functionId?: string;
+    metadata?: Record<string, unknown>;
+}): TelemetrySettings;
+/**
+ * Check if observability is currently initialized.
+ */
+export declare function isObservabilityEnabled(): boolean;
+/**
+ * Shutdown observability (flush pending traces).
+ * Call this during graceful shutdown.
+ */
+export declare function shutdownObservability(): Promise<void>;
+//# sourceMappingURL=langfuse.d.ts.map

package/dist/observability/langfuse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuse.d.ts","sourceRoot":"","sources":["../../src/observability/langfuse.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAMtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuDrF;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GAAG,iBAAiB,CAMpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3D"}

package/dist/observability/langfuse.js

@@ -0,0 +1,112 @@
+/**
+ * @fileoverview Langfuse observability integration for AI SDK.
+ * Uses OpenTelemetry to trace AI SDK calls via Langfuse.
+ *
+ * This module is designed to be optional — langfuse is a peer dependency.
+ * If not installed, observability features gracefully degrade (no-op).
+ */
+import { createLogger } from '@agntk/logger';
+const log = createLogger('@agntk/core:observability');
+let initialized = false;
+/**
+ * Initialize observability provider (currently Langfuse).
+ *
+ * Must be called before any AI SDK calls to enable tracing.
+ * This sets up the OpenTelemetry span processor that sends
+ * traces to Langfuse.
+ *
+ * @example
+ * ```typescript
+ * import { initObservability } from '@agntk/core';
+ *
+ * await initObservability({
+ *   provider: 'langfuse',
+ *   langfuse: {
+ *     publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+ *     secretKey: process.env.LANGFUSE_SECRET_KEY,
+ *   },
+ * });
+ * ```
+ */
+export async function initObservability(config) {
+    if (initialized) {
+        log.warn('Observability already initialized, skipping');
+        return true;
+    }
+    if (config.provider !== 'langfuse') {
+        log.error('Unsupported observability provider', { provider: config.provider });
+        return false;
+    }
+    try {
+        // Dynamic import via Function to bypass TypeScript module resolution.
+        // These are optional peer deps that may not be installed.
+        const dynamicImport = new Function('specifier', 'return import(specifier)');
+        const langfuseModule = await dynamicImport('langfuse-vercel');
+        const publicKey = config.langfuse?.publicKey ?? process.env.LANGFUSE_PUBLIC_KEY;
+        const secretKey = config.langfuse?.secretKey ?? process.env.LANGFUSE_SECRET_KEY;
+        const baseUrl = config.langfuse?.baseUrl ?? process.env.LANGFUSE_BASEURL ?? 'https://cloud.langfuse.com';
+        if (!publicKey || !secretKey) {
+            log.warn('Langfuse keys not provided, observability disabled');
+            return false;
+        }
+        // Register the exporter with OpenTelemetry
+        const otelModule = await dynamicImport('@vercel/otel');
+        otelModule.registerOTel({
+            serviceName: 'agent-sdk',
+            traceExporter: new langfuseModule.LangfuseExporter({
+                publicKey,
+                secretKey,
+                baseUrl,
+                debug: config.langfuse?.debug ?? false,
+            }),
+        });
+        initialized = true;
+        log.info('Langfuse observability initialized', { baseUrl });
+        return true;
+    }
+    catch (error) {
+        // Graceful degradation — langfuse not installed or failed to init
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('Cannot find module') || message.includes('MODULE_NOT_FOUND')) {
+            log.info('Langfuse not installed, observability features disabled. Install with: pnpm add langfuse-vercel @vercel/otel');
+        }
+        else {
+            log.warn('Failed to initialize Langfuse observability', { error: message });
+        }
+        return false;
+    }
+}
+/**
+ * Create telemetry settings for AI SDK calls.
+ * Returns settings that enable OpenTelemetry tracing.
+ */
+export function createTelemetrySettings(options) {
+    return {
+        isEnabled: initialized,
+        functionId: options?.functionId,
+        metadata: options?.metadata,
+    };
+}
+/**
+ * Check if observability is currently initialized.
+ */
+export function isObservabilityEnabled() {
+    return initialized;
+}
+/**
+ * Shutdown observability (flush pending traces).
+ * Call this during graceful shutdown.
+ */
+export async function shutdownObservability() {
+    if (!initialized)
+        return;
+    try {
+        // The registered OTel provider handles shutdown via process events
+        log.info('Observability shutdown requested');
+        initialized = false;
+    }
+    catch (error) {
+        log.warn('Error during observability shutdown', { error: String(error) });
+    }
+}
+//# sourceMappingURL=langfuse.js.map

package/dist/observability/langfuse.js.map

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

package/dist/observability/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Type definitions for observability providers.
+ */
+/**
+ * Observability provider configuration.
+ */
+export interface ObservabilityConfig {
+    /** Provider name. Currently supports 'langfuse'. */
+    provider: 'langfuse';
+    /** Langfuse-specific configuration. */
+    langfuse?: LangfuseConfig;
+}
+/**
+ * Langfuse configuration.
+ */
+export interface LangfuseConfig {
+    /** Langfuse public key. Falls back to LANGFUSE_PUBLIC_KEY env var. */
+    publicKey?: string;
+    /** Langfuse secret key. Falls back to LANGFUSE_SECRET_KEY env var. */
+    secretKey?: string;
+    /** Langfuse base URL. Falls back to LANGFUSE_BASEURL or https://cloud.langfuse.com. */
+    baseUrl?: string;
+    /** Enable/disable debug logging. Default: false */
+    debug?: boolean;
+}
+/**
+ * Telemetry settings to pass to AI SDK calls.
+ * This is a simplified subset of the AI SDK's TelemetrySettings.
+ * The full AI SDK type uses AttributeValue from @opentelemetry/api,
+ * but we accept Record<string, unknown> for a simpler API.
+ */
+export interface TelemetrySettings {
+    isEnabled: boolean;
+    functionId?: string;
+    metadata?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/observability/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/observability/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oDAAoD;IACpD,QAAQ,EAAE,UAAU,CAAC;IAErB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC"}

package/dist/observability/types.js

@@ -0,0 +1,5 @@
+/**
+ * @fileoverview Type definitions for observability providers.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/observability/types.js.map

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

package/dist/pool/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Pool module barrel exports.
+ */
+export { SpecialistPool } from './specialist-pool.js';
+export { createPoolTools, createSpawnSpecialistTool, createListSpecialistsTool } from './tools.js';
+export type { SpecialistPoolConfig, SpecialistConfig, CachedSpecialist, ConversationMessage, SpecialistAgent, HistoryStrategy, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pool/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAChG,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/pool/index.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Pool module barrel exports.
+ */
+export { SpecialistPool } from './specialist-pool.js';
+export { createPoolTools, createSpawnSpecialistTool, createListSpecialistsTool } from './tools.js';
+//# sourceMappingURL=index.js.map

package/dist/pool/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pool/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC"}

package/dist/pool/specialist-pool.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview SpecialistPool — LRU+TTL cache of domain specialists.
+ *
+ * Spawns (or reuses) specialist agents keyed by domain name.
+ * Each specialist can have skills injected and maintains conversation history.
+ */
+import type { SpecialistPoolConfig, SpecialistConfig, CachedSpecialist } from './types.js';
+export declare class SpecialistPool {
+    private cache;
+    private readonly maxAgents;
+    private readonly ttlMs;
+    private readonly defaultHistoryStrategy;
+    private readonly defaultWindowSize;
+    private readonly createAgent;
+    constructor(config: SpecialistPoolConfig);
+    /**
+     * Spawn or reuse a specialist for the given domain.
+     * Returns the cached specialist if not expired; otherwise creates a new one.
+     */
+    spawn(config: SpecialistConfig): Promise<CachedSpecialist>;
+    /**
+     * Generate a response from a specialist, managing conversation history.
+     */
+    generate(domain: string, prompt: string): Promise<string>;
+    /**
+     * List all cached specialists with their metadata.
+     */
+    list(): Array<{
+        domain: string;
+        createdAt: number;
+        lastUsedAt: number;
+        useCount: number;
+        historyLength: number;
+        expired: boolean;
+        skills: string[];
+    }>;
+    /**
+     * Remove a specialist from the cache.
+     */
+    remove(domain: string): boolean;
+    /**
+     * Clear all cached specialists.
+     */
+    clear(): void;
+    /**
+     * Get the current number of cached specialists.
+     */
+    get size(): number;
+    /**
+     * Get a cached specialist by domain (without modifying LRU state).
+     */
+    get(domain: string): CachedSpecialist | undefined;
+    private isExpired;
+    private evictIfNeeded;
+    private createSpecialist;
+    private buildContextualPrompt;
+    private getRelevantHistory;
+}
+//# sourceMappingURL=specialist-pool.d.ts.map

package/dist/pool/specialist-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialist-pool.d.ts","sourceRoot":"","sources":["../../src/pool/specialist-pool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAIjB,MAAM,SAAS,CAAC;AAmBjB,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAkB;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsC;gBAEtD,MAAM,EAAE,oBAAoB;IAkBxC;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA6BhE;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6B/D;;OAEG;IACH,IAAI,IAAI,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAYF;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAQ/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAQjD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,aAAa;YAsBP,gBAAgB;IAwC9B,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,kBAAkB;CAsB3B"}