@garrix82/reactgenie-dsl 1.0.0

package/dist/nl/nl-parser-groq.js

@@ -0,0 +1,357 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NlParserGroq = void 0;
+const llm_monitoring_1 = require("./llm-monitoring");
+const nl_parser_utils_1 = require("./nl-parser-utils");
+function buildChatCompletionsEndpoint(baseUrl) {
+    const resolvedBase = (0, nl_parser_utils_1.normalizeBaseUrl)(baseUrl && baseUrl.trim().length > 0
+        ? baseUrl
+        : "https://api.groq.com/openai/v1");
+    if (resolvedBase.endsWith("/chat/completions")) {
+        return resolvedBase;
+    }
+    if (resolvedBase.endsWith("/openai/v1") || resolvedBase.endsWith("/v1")) {
+        return `${resolvedBase}/chat/completions`;
+    }
+    return `${resolvedBase}/openai/v1/chat/completions`;
+}
+function asFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function extractCostMetrics(response) {
+    const usage = response?.usage ?? response?.usage_metadata ?? {};
+    const inputCost = asFiniteNumber(usage?.input_cost) ??
+        asFiniteNumber(usage?.prompt_cost) ??
+        asFiniteNumber(usage?.prompt_cost_usd);
+    const outputCost = asFiniteNumber(usage?.output_cost) ??
+        asFiniteNumber(usage?.completion_cost) ??
+        asFiniteNumber(usage?.completion_cost_usd);
+    const totalCost = asFiniteNumber(usage?.total_cost) ??
+        asFiniteNumber(usage?.cost) ??
+        asFiniteNumber(usage?.total_cost_usd) ??
+        (typeof inputCost === "number" && typeof outputCost === "number"
+            ? inputCost + outputCost
+            : undefined);
+    return {
+        ...(typeof inputCost === "number" ? { inputCost } : {}),
+        ...(typeof outputCost === "number" ? { outputCost } : {}),
+        ...(typeof totalCost === "number" ? { totalCost } : {}),
+    };
+}
+class NlParserGroq {
+    constructor(prompt, apiKey, model = process.env.SEMANTIC_MODEL || "llama-3.3-70b-versatile", samplingParams, baseURL, langsmithApiKey, langsmithProject, langsmithEndpoint, validateCommand) {
+        this.prompt = prompt;
+        this.apiKey = apiKey;
+        this.model = model;
+        this.baseURL = baseURL;
+        this.validateCommand = validateCommand;
+        this.chatCompletionsEndpoint = buildChatCompletionsEndpoint(this.baseURL);
+        this.llmMonitor = (0, llm_monitoring_1.getLLMMonitor)({
+            apiKey: langsmithApiKey,
+            project: langsmithProject,
+            endpoint: langsmithEndpoint,
+        });
+        this.samplingParams = {
+            ...nl_parser_utils_1.DEFAULT_SEMANTIC_PARSER_SAMPLING,
+            ...samplingParams,
+        };
+    }
+    async createChatCompletion(body) {
+        return (0, nl_parser_utils_1.createJsonChatCompletion)({
+            endpoint: this.chatCompletionsEndpoint,
+            apiKey: this.apiKey,
+            body,
+            provider: "groq",
+            requestLabel: "LLM proxy request failed",
+            invalidPayloadLabel: "LLM proxy returned an invalid JSON payload",
+        });
+    }
+    async oldParse(nl) {
+        const promptText = this.prompt.prompt(nl);
+        const startTime = Date.now();
+        try {
+            const response = await this.llmMonitor.traceCall("oldParse", { model: this.model, provider: "groq" }, async () => {
+                return await this.runStructuredCommandMessages([
+                    {
+                        role: "user",
+                        content: promptText,
+                    },
+                ], false);
+            });
+            const completion = await this.validateOrRepairCommand("oldParse", "legacy_prompt", promptText, response.command, promptText);
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                promptTokens: response.response.usage?.prompt_tokens,
+                completionTokens: response.response.usage?.completion_tokens,
+                totalTokens: response.response.usage?.total_tokens,
+                ...extractCostMetrics(response.response),
+                prompt: promptText,
+                completion,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+            });
+            return completion;
+        }
+        catch (error) {
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                prompt: promptText,
+                completion: null,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    async parse(nl) {
+        const startTime = Date.now();
+        const promptVariants = [];
+        const defaultPrompt = this.prompt.zero_shot_prompt(nl);
+        promptVariants.push({ label: "filtered", text: defaultPrompt });
+        let usedPromptText = defaultPrompt;
+        let completion = null;
+        let response;
+        let lastError;
+        try {
+            const runParse = async (strict, promptText) => {
+                return this.runStructuredCommandMessages([
+                    {
+                        role: "user",
+                        content: promptText,
+                    },
+                ], strict);
+            };
+            for (const promptVariant of promptVariants) {
+                usedPromptText = promptVariant.text;
+                try {
+                    const result = await this.llmMonitor.traceCall(`parse_${promptVariant.label}`, { model: this.model, provider: "groq" }, async () => runParse(false, promptVariant.text));
+                    response = result.response;
+                    completion = await this.validateOrRepairCommand("parse", promptVariant.label, nl, result.command, usedPromptText);
+                    break;
+                }
+                catch (error) {
+                    try {
+                        const result = await this.llmMonitor.traceCall(`parse_${promptVariant.label}`, { model: this.model, provider: "groq" }, async () => runParse(true, promptVariant.text));
+                        response = result.response;
+                        completion = await this.validateOrRepairCommand("parse", promptVariant.label, nl, result.command, usedPromptText);
+                        break;
+                    }
+                    catch (strictError) {
+                        lastError = strictError;
+                    }
+                }
+            }
+            if (!completion || !response) {
+                throw (lastError instanceof Error
+                    ? lastError
+                    : new Error("Groq parse failed for filtered prompt"));
+            }
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                promptTokens: response.usage?.prompt_tokens,
+                completionTokens: response.usage?.completion_tokens,
+                totalTokens: response.usage?.total_tokens,
+                ...extractCostMetrics(response),
+                prompt: usedPromptText,
+                completion,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+            });
+            return completion;
+        }
+        catch (error) {
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                prompt: usedPromptText,
+                completion: null,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    async parseGpt4(nl) {
+        const promptText = this.prompt.prompt(nl);
+        const startTime = Date.now();
+        try {
+            const runParse = async (strict) => {
+                return this.runStructuredCommandMessages([
+                    {
+                        role: "system",
+                        content: "only generate one line of code",
+                    },
+                    {
+                        role: "user",
+                        content: promptText,
+                    },
+                ], strict);
+            };
+            let response;
+            let completion = null;
+            try {
+                const result = await this.llmMonitor.traceCall("parseGpt4", { model: this.model, provider: "groq" }, async () => runParse(false));
+                response = result.response;
+                completion = result.command;
+            }
+            catch (error) {
+                const result = await this.llmMonitor.traceCall("parseGpt4", { model: this.model, provider: "groq" }, async () => runParse(true));
+                response = result.response;
+                completion = result.command;
+            }
+            const validatedCompletion = completion
+                ? await this.validateOrRepairCommand("parseGpt4", "legacy_prompt", nl, completion, promptText)
+                : completion;
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                promptTokens: response.usage?.prompt_tokens,
+                completionTokens: response.usage?.completion_tokens,
+                totalTokens: response.usage?.total_tokens,
+                ...extractCostMetrics(response),
+                prompt: promptText,
+                completion: validatedCompletion,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+            });
+            return validatedCompletion;
+        }
+        catch (error) {
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                prompt: promptText,
+                completion: null,
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+    async respond(nl, parsed, result) {
+        const promptText = this.prompt.response_prompt(nl, parsed, result);
+        const startTime = Date.now();
+        try {
+            const runRespond = async (strict) => {
+                const response = await this.createChatCompletion({
+                    model: this.model,
+                    messages: [
+                        {
+                            role: "system",
+                            content: "Return only a strict JSON object for agent_response_json.",
+                        },
+                        {
+                            role: "user",
+                            content: promptText,
+                        },
+                    ],
+                    temperature: this.samplingParams.temperature,
+                    max_tokens: 256,
+                    top_p: this.samplingParams.top_p,
+                    frequency_penalty: this.samplingParams.frequency_penalty,
+                    presence_penalty: this.samplingParams.presence_penalty,
+                    response_format: (0, nl_parser_utils_1.getStructuredAgentResponseFormat)(strict),
+                });
+                const raw = response.choices[0]?.message?.content ?? null;
+                const payload = (0, nl_parser_utils_1.extractStructuredAgentResponse)(raw);
+                if (!payload) {
+                    throw new Error("Groq structured output missing agent response payload");
+                }
+                return { response, payload };
+            };
+            let response;
+            let completion = null;
+            try {
+                const result = await this.llmMonitor.traceCall("respond", { model: this.model, provider: "groq" }, async () => runRespond(false));
+                response = result.response;
+                completion = result.payload;
+            }
+            catch {
+                const result = await this.llmMonitor.traceCall("respond", { model: this.model, provider: "groq" }, async () => runRespond(true));
+                response = result.response;
+                completion = result.payload;
+            }
+            const normalizedCompletion = completion
+                ? (0, nl_parser_utils_1.normalizeAgentResponse)(completion)
+                : (0, nl_parser_utils_1.buildFallbackAgentResponse)(parsed, result);
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                promptTokens: response.usage?.prompt_tokens,
+                completionTokens: response.usage?.completion_tokens,
+                totalTokens: response.usage?.total_tokens,
+                ...extractCostMetrics(response),
+                prompt: promptText,
+                completion: JSON.stringify(normalizedCompletion),
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+            });
+            return normalizedCompletion;
+        }
+        catch (error) {
+            const fallbackResponse = (0, nl_parser_utils_1.buildFallbackAgentResponse)(parsed, result);
+            await this.llmMonitor.logCall({
+                model: this.model,
+                provider: "groq",
+                prompt: promptText,
+                completion: JSON.stringify(fallbackResponse),
+                latency: Date.now() - startTime,
+                timestamp: new Date(),
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return fallbackResponse;
+        }
+    }
+    async runStructuredCommandMessages(messages, strict) {
+        const response = await this.createChatCompletion({
+            model: this.model,
+            messages: [...messages],
+            temperature: this.samplingParams.temperature,
+            max_tokens: 256,
+            top_p: this.samplingParams.top_p,
+            frequency_penalty: this.samplingParams.frequency_penalty,
+            presence_penalty: this.samplingParams.presence_penalty,
+            response_format: (0, nl_parser_utils_1.getStructuredResponseFormat)(strict),
+        });
+        const raw = response.choices[0]?.message?.content ?? null;
+        const command = (0, nl_parser_utils_1.extractStructuredCommand)(raw);
+        if (!command) {
+            throw new Error("Groq structured output missing command");
+        }
+        return { response, command };
+    }
+    async validateOrRepairCommand(traceName, promptLabel, userUtterance, command, lastUsedPrompt) {
+        if (!this.validateCommand) {
+            return command;
+        }
+        try {
+            await this.validateCommand(command);
+            return command;
+        }
+        catch (validationError) {
+            const messages = (0, nl_parser_utils_1.buildCommandRepairMessages)(userUtterance, command, validationError instanceof Error ? validationError.message : String(validationError), lastUsedPrompt);
+            let lastError = validationError;
+            for (const strict of [false, true]) {
+                try {
+                    const repaired = await this.llmMonitor.traceCall(`${traceName}_${promptLabel}_repair_${strict ? "strict" : "lenient"}`, { model: this.model, provider: "groq" }, async () => this.runStructuredCommandMessages(messages, strict));
+                    await this.validateCommand(repaired.command);
+                    return repaired.command;
+                }
+                catch (repairError) {
+                    lastError = repairError;
+                }
+            }
+            throw (lastError instanceof Error
+                ? lastError
+                : new Error("Groq repair failed after semantic validation"));
+        }
+    }
+}
+exports.NlParserGroq = NlParserGroq;
+//# sourceMappingURL=nl-parser-groq.js.map

package/dist/nl/nl-parser-groq.js.map

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

package/dist/nl/nl-parser-utils.d.ts

@@ -0,0 +1,101 @@
+import { AgentResponsePayload, PromptGen } from "./prompt-gen";
+export interface PromptWithBroadFallback extends PromptGen {
+    zero_shot_prompt_broad?: (user_utterance: string) => string;
+}
+export type CommandValidator = (command: string) => Promise<void>;
+export interface SamplingParams {
+    temperature?: number;
+    top_p?: number;
+    frequency_penalty?: number;
+    presence_penalty?: number;
+}
+export declare const DEFAULT_SEMANTIC_PARSER_SAMPLING: Required<SamplingParams>;
+export declare function getStructuredResponseFormat(strict: boolean): {
+    readonly type: "json_schema";
+    readonly json_schema: {
+        readonly name: "dsl_command";
+        readonly strict: boolean;
+        readonly schema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly command: {
+                    readonly type: "string";
+                    readonly description: "Single DSL command string to execute.";
+                };
+            };
+            readonly required: readonly ["command"];
+            readonly additionalProperties: false;
+        };
+    };
+};
+export declare function getStructuredResponseTextFormat(strict: boolean): {
+    readonly type: "json_schema";
+    readonly name: "dsl_command";
+    readonly strict: boolean;
+    readonly schema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly command: {
+                readonly type: "string";
+                readonly description: "Single DSL command string to execute.";
+            };
+        };
+        readonly required: readonly ["command"];
+        readonly additionalProperties: false;
+    };
+};
+export declare function getStructuredAgentResponseFormat(strict: boolean): {
+    readonly type: "json_schema";
+    readonly json_schema: {
+        readonly name: "agent_response";
+        readonly strict: boolean;
+        readonly schema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly minimalText: {
+                    readonly type: "string";
+                    readonly description: "Short, speech-friendly response.";
+                };
+                readonly fullText: {
+                    readonly type: "string";
+                    readonly description: "More informative response for on-screen UI.";
+                };
+                readonly type: {
+                    readonly type: "string";
+                    readonly enum: readonly ["info", "error", "success", "warning"];
+                };
+                readonly shouldSpeak: {
+                    readonly type: "boolean";
+                };
+            };
+            readonly required: readonly ["minimalText", "fullText", "type", "shouldSpeak"];
+            readonly additionalProperties: false;
+        };
+    };
+};
+export declare function extractStructuredCommand(raw?: string | null): string | null;
+export declare function extractResponseOutputText(response: any): string | null;
+export declare function truncateText(value: string, maxLength: number): string;
+export declare function normalizeAgentResponse(payload: Partial<AgentResponsePayload>): AgentResponsePayload;
+export declare function extractStructuredAgentResponse(raw?: string | null): AgentResponsePayload | null;
+export declare function buildFallbackAgentResponse(parsedDsl: string, resultContext: string): AgentResponsePayload;
+export declare function buildCommandRepairMessages(userUtterance: string, invalidCommand: string, validationError: string, lastUsedPrompt?: string): readonly [{
+    readonly role: "user";
+    readonly content: string;
+}, {
+    readonly role: "assistant";
+    readonly content: string;
+}, {
+    readonly role: "user";
+    readonly content: string;
+}];
+export declare function buildCommandRepairInputText(userUtterance: string, invalidCommand: string, validationError: string): string;
+export declare function normalizeBaseUrl(baseUrl: string): string;
+export declare function createJsonChatCompletion(params: {
+    endpoint: string;
+    apiKey: string;
+    body: Record<string, unknown>;
+    provider?: "openai" | "groq";
+    requestLabel: string;
+    invalidPayloadLabel: string;
+}): Promise<any>;