@juspay/neurolink 12.12.9 → 12.12.11

package/dist/core/modules/GenerationHandler.d.ts

@@ -1,145 +0,0 @@
-/**
- * Generation Handler Module
- *
- * Handles text generation execution, result formatting, and tool information extraction.
- * Extracted from BaseProvider to follow Single Responsibility Principle.
- *
- * Responsibilities:
- * - Generation execution with AI SDK
- * - Tool information extraction
- * - Result formatting and enhancement
- * - Response analysis and logging
- *
- * @module core/modules/GenerationHandler
- */
-import type { GenerateTextResult, AIProviderName, EnhancedGenerateResult, NeuroLinkEvents, StandardRecord, TextGenerationOptions, ToolExecutionRecord, TypedEventEmitter } from "../../types/index.js";
-import type { LanguageModel, ModelMessage, Tool } from "../../types/index.js";
-/**
- * Turn budget + wrap-up deadline (parity with the googleVertex native loops).
- * A deadline is engaged only when the caller expressed one: turnTimeoutMs
- * wins, else an explicit generate timeout. Callers that set neither keep the
- * pre-existing behaviour (no wrap-up; the outer defensive timeout in
- * executeStandardGenerateFlow still applies). With `wrapupTimeLeadMs` left of
- * the deadline, the loop stops offering tools (toolChoice: "none") so the
- * model spends the remaining budget producing a final answer instead of being
- * guillotined mid-tool-loop with all work discarded. The lead is clamped to a
- * quarter of the budget so short explicit timeouts (e.g. 30s) don't trigger
- * wrap-up on the very first step.
- *
- * `turnStartMs` anchors the deadline to the ORIGINAL generation start:
- * callGenerateText re-runs on executeGeneration's fallback retries
- * (structured-output conflict, temperature-deprecated) and provider retries,
- * and a deadline computed from Date.now() per attempt would hand each retry
- * a fresh budget — multiplying the caller's wall-clock cap.
- */
-export declare function resolveTurnBudget(options: TextGenerationOptions, turnStartMs: number): {
-    callerTimeoutMs: number | undefined;
-    turnBudgetMs: number | undefined;
-    wrapupLeadMs: number;
-    turnDeadline: number | undefined;
-};
-/**
- * GenerationHandler class - Handles text generation operations for AI providers
- */
-export declare class GenerationHandler {
-    private readonly providerName;
-    private readonly modelName;
-    private readonly supportsToolsFn;
-    private readonly getTelemetryConfigFn;
-    private readonly handleToolStorageFn;
-    /**
-     * The remaining, optional dependencies.
-     *
-     * Grouped rather than added as further positional parameters: the
-     * constructor is already at the six-parameter cap, and both of these are
-     * optional injection seams rather than required collaborators.
-     *
-     * `generateTextFn` exists because every other dependency of this class
-     * arrives through the constructor while `generateText` was reached by
-     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
-     * ESM re-export cannot be substituted from a test, so asserting on the
-     * arguments this class builds — the entire contract of the system-message
-     * hoisting below — had no seam to work through. Production passes neither.
-     */
-    private readonly deps;
-    constructor(providerName: AIProviderName, modelName: string, supportsToolsFn: () => boolean, getTelemetryConfigFn: (options: TextGenerationOptions, type: string) => {
-        isEnabled: boolean;
-        functionId?: string;
-        metadata?: Record<string, string | number | boolean>;
-    } | undefined, handleToolStorageFn: (toolCalls: unknown[], toolResults: unknown[], options: TextGenerationOptions, timestamp: Date) => Promise<void>, 
-    /**
-     * The remaining, optional dependencies.
-     *
-     * Grouped rather than added as further positional parameters: the
-     * constructor is already at the six-parameter cap, and both of these are
-     * optional injection seams rather than required collaborators.
-     *
-     * `generateTextFn` exists because every other dependency of this class
-     * arrives through the constructor while `generateText` was reached by
-     * static import. `utils/generation.ts` is a bare re-export of `ai`, and an
-     * ESM re-export cannot be substituted from a test, so asserting on the
-     * arguments this class builds — the entire contract of the system-message
-     * hoisting below — had no seam to work through. Production passes neither.
-     */
-    deps?: {
-        getEmitterFn?: () => TypedEventEmitter<NeuroLinkEvents> | undefined;
-        generateTextFn?: (options: Record<string, unknown>) => Promise<GenerateTextResult<Record<string, Tool>, unknown>>;
-    });
-    /**
-     * Helper method to call generateText with optional structured output
-     * @private
-     */
-    /**
-     * The ai-package generate loop.
-     *
-     * Unreachable: every text provider now implements a native generate() and
-     * none of them return here. That was established by trapping the seam —
-     * replacing the ai package's generateText with a throwing stub left the full
-     * provider matrix passing and zero cells reaching it — and non-text request
-     * kinds return from runGenerateInActiveContext before this handler is
-     * consulted.
-     *
-     * Kept as an explicit failure rather than deleted outright so a provider
-     * added without a native generate() fails loudly here instead of silently
-     * reintroducing a dependency on the removed package.
-     */
-    private callGenerateText;
-    executeGeneration(model: LanguageModel, messages: ModelMessage[], tools: Record<string, Tool>, options: TextGenerationOptions): Promise<GenerateTextResult<Record<string, Tool>, unknown>>;
-    /**
-     * Extract cache metrics from provider metadata (e.g. Anthropic's providerMetadata.anthropic)
-     * The AI SDK's LanguageModelUsage only has inputTokens/outputTokens.
-     * Cache metrics are surfaced via providerMetadata by provider-specific SDK adapters.
-     */
-    /**
-     * Set gen_ai usage attributes + cache-aware cost on the span from the
-     * CROSS-STEP aggregate (result.totalUsage). result.usage is the LAST step
-     * only — using it undercounted every multi-step tool loop, and pricing the
-     * raw cache-inclusive inputTokens without the cache fields billed cache
-     * reads at the full input rate.
-     */
-    private setUsageSpanAttributes;
-    private extractCacheMetricsFromProviderMetadata;
-    /**
-     * Log generation completion information
-     */
-    logGenerationComplete(generateResult: GenerateTextResult<Record<string, Tool>, unknown>): void;
-    /**
-     * Extract tool information from generation result
-     */
-    extractToolInformation(generateResult: GenerateTextResult<Record<string, Tool>, unknown>): {
-        toolsUsed: string[];
-        toolExecutions: Array<{
-            name: string;
-            input: StandardRecord;
-            output: unknown;
-        }>;
-    };
-    /**
-     * Format the enhanced result
-     */
-    formatEnhancedResult(generateResult: GenerateTextResult<Record<string, Tool>, unknown>, tools: Record<string, Tool>, toolsUsed: string[], toolExecutions: ToolExecutionRecord[], options: TextGenerationOptions): EnhancedGenerateResult;
-    /**
-     * Analyze AI response structure and log detailed debugging information
-     */
-    analyzeAIResponse(rawResult: unknown): void;
-}