ai-pipeline-orchestrator 0.1.0

package/dist/handlers/index.d.cts

@@ -0,0 +1,105 @@
+import { a as OrchestrationHandler, O as OrchestrationContext } from '../types-DGSj206n.cjs';
+import { I as IntentClassifier, L as LLMIntentClassifier } from '../llm-classifier-pOp7OO-V.cjs';
+import { Logger } from '../utils/index.cjs';
+import { ContextOptimizer } from '../context/index.cjs';
+import { ProviderConfig } from '../providers/index.cjs';
+
+interface IntentHandlerConfig {
+    classifier: IntentClassifier;
+    llmFallback?: {
+        enabled: boolean;
+        classifier: LLMIntentClassifier;
+        confidenceThreshold?: number;
+    };
+    contextKey?: string;
+    onFallback?: (data: {
+        message: string;
+        keywordIntent: string;
+        keywordConfidence: number;
+        llmIntent: string;
+        llmConfidence: number;
+        matchedKeywords?: string[];
+    }) => void | Promise<void>;
+    logger?: Logger;
+}
+/**
+ * Creates intent detection handler with hybrid classification.
+ * Uses keyword matching first, falls back to LLM if confidence is low and LLM is enabled.
+ *
+ * Keyword matching algorithm:
+ * - Scoring: Each keyword match adds points equal to the keyword's word count.
+ * - Single-word keywords (e.g., "hello") score 1 point
+ * - Multi-word keywords (e.g., "help me") score 2 points
+ *
+ * - Selection: The category with the highest score wins. Confidence is calculated as the margin between the best and second-best scores, normalized to 0-1.
+ *
+ * Note: This is a simple heuristic. For production use, consider the LLM fallback option in createIntentHandler when confidence is low.
+ */
+declare function createIntentHandler(config: IntentHandlerConfig): OrchestrationHandler;
+
+interface ContextHandlerConfig {
+    optimizer: ContextOptimizer;
+    getTopics?: (context: OrchestrationContext) => string[];
+    isFirstMessage?: (context: OrchestrationContext) => boolean;
+    outputKey?: string;
+    logger?: Logger;
+}
+/**
+ * Creates context building handler for dynamic prompt generation.
+ */
+declare function createContextHandler(config: ContextHandlerConfig): OrchestrationHandler;
+
+interface RateLimiter {
+    check(identifier: string): Promise<{
+        allowed: boolean;
+        retryAfter?: number;
+    }>;
+}
+interface RateLimitHandlerConfig {
+    limiter: RateLimiter;
+    identifierKey?: string;
+    getIdentifier?: (context: OrchestrationContext) => string;
+    outputKey?: string;
+    logger?: Logger;
+}
+/**
+ * Creates rate limiting handler to prevent abuse.
+ */
+declare function createRateLimitHandler(config: RateLimitHandlerConfig): OrchestrationHandler;
+
+interface ModerationRule {
+    pattern: RegExp;
+    reason: string;
+}
+interface ModerationConfig {
+    spamPatterns?: string[];
+    profanityWords?: string[];
+    customRules?: ModerationRule[];
+    outputKey?: string;
+    logger?: Logger;
+}
+/**
+ * Creates content moderation handler for spam and profanity filtering.
+ */
+declare function createModerationHandler(config?: ModerationConfig): OrchestrationHandler;
+
+interface AIHandlerConfig extends ProviderConfig {
+    maxTokens?: number;
+    temperature?: number;
+    getSystemPrompt?: (context: OrchestrationContext) => string;
+    outputKey?: string;
+    logger?: Logger;
+}
+interface StreamingAIHandlerConfig extends AIHandlerConfig {
+    onChunk: (chunk: string) => void | Promise<void>;
+}
+/**
+ * Creates AI generation handler.
+ */
+declare function createAIHandler(config: AIHandlerConfig): OrchestrationHandler;
+/**
+ * Creates streaming AI generation handler.
+ */
+declare function createStreamingAIHandler(config: StreamingAIHandlerConfig): OrchestrationHandler;
+
+export { type AIHandlerConfig, type ContextHandlerConfig, type IntentHandlerConfig, type ModerationConfig, type ModerationRule, type RateLimitHandlerConfig, type RateLimiter, type StreamingAIHandlerConfig, createAIHandler, createContextHandler, createIntentHandler, createModerationHandler, createRateLimitHandler, createStreamingAIHandler };

package/dist/handlers/index.d.ts

@@ -0,0 +1,105 @@
+import { a as OrchestrationHandler, O as OrchestrationContext } from '../types-DGSj206n.js';
+import { I as IntentClassifier, L as LLMIntentClassifier } from '../llm-classifier-Cq-QHJc4.js';
+import { Logger } from '../utils/index.js';
+import { ContextOptimizer } from '../context/index.js';
+import { ProviderConfig } from '../providers/index.js';
+
+interface IntentHandlerConfig {
+    classifier: IntentClassifier;
+    llmFallback?: {
+        enabled: boolean;
+        classifier: LLMIntentClassifier;
+        confidenceThreshold?: number;
+    };
+    contextKey?: string;
+    onFallback?: (data: {
+        message: string;
+        keywordIntent: string;
+        keywordConfidence: number;
+        llmIntent: string;
+        llmConfidence: number;
+        matchedKeywords?: string[];
+    }) => void | Promise<void>;
+    logger?: Logger;
+}
+/**
+ * Creates intent detection handler with hybrid classification.
+ * Uses keyword matching first, falls back to LLM if confidence is low and LLM is enabled.
+ *
+ * Keyword matching algorithm:
+ * - Scoring: Each keyword match adds points equal to the keyword's word count.
+ * - Single-word keywords (e.g., "hello") score 1 point
+ * - Multi-word keywords (e.g., "help me") score 2 points
+ *
+ * - Selection: The category with the highest score wins. Confidence is calculated as the margin between the best and second-best scores, normalized to 0-1.
+ *
+ * Note: This is a simple heuristic. For production use, consider the LLM fallback option in createIntentHandler when confidence is low.
+ */
+declare function createIntentHandler(config: IntentHandlerConfig): OrchestrationHandler;
+
+interface ContextHandlerConfig {
+    optimizer: ContextOptimizer;
+    getTopics?: (context: OrchestrationContext) => string[];
+    isFirstMessage?: (context: OrchestrationContext) => boolean;
+    outputKey?: string;
+    logger?: Logger;
+}
+/**
+ * Creates context building handler for dynamic prompt generation.
+ */
+declare function createContextHandler(config: ContextHandlerConfig): OrchestrationHandler;
+
+interface RateLimiter {
+    check(identifier: string): Promise<{
+        allowed: boolean;
+        retryAfter?: number;
+    }>;
+}
+interface RateLimitHandlerConfig {
+    limiter: RateLimiter;
+    identifierKey?: string;
+    getIdentifier?: (context: OrchestrationContext) => string;
+    outputKey?: string;
+    logger?: Logger;
+}
+/**
+ * Creates rate limiting handler to prevent abuse.
+ */
+declare function createRateLimitHandler(config: RateLimitHandlerConfig): OrchestrationHandler;
+
+interface ModerationRule {
+    pattern: RegExp;
+    reason: string;
+}
+interface ModerationConfig {
+    spamPatterns?: string[];
+    profanityWords?: string[];
+    customRules?: ModerationRule[];
+    outputKey?: string;
+    logger?: Logger;
+}
+/**
+ * Creates content moderation handler for spam and profanity filtering.
+ */
+declare function createModerationHandler(config?: ModerationConfig): OrchestrationHandler;
+
+interface AIHandlerConfig extends ProviderConfig {
+    maxTokens?: number;
+    temperature?: number;
+    getSystemPrompt?: (context: OrchestrationContext) => string;
+    outputKey?: string;
+    logger?: Logger;
+}
+interface StreamingAIHandlerConfig extends AIHandlerConfig {
+    onChunk: (chunk: string) => void | Promise<void>;
+}
+/**
+ * Creates AI generation handler.
+ */
+declare function createAIHandler(config: AIHandlerConfig): OrchestrationHandler;
+/**
+ * Creates streaming AI generation handler.
+ */
+declare function createStreamingAIHandler(config: StreamingAIHandlerConfig): OrchestrationHandler;
+
+export { type AIHandlerConfig, type ContextHandlerConfig, type IntentHandlerConfig, type ModerationConfig, type ModerationRule, type RateLimitHandlerConfig, type RateLimiter, type StreamingAIHandlerConfig, createAIHandler, createContextHandler, createIntentHandler, createModerationHandler, createRateLimitHandler, createStreamingAIHandler };