@garrix82/reactgenie-dsl 1.0.0

package/dist/nl-interpreter.js

@@ -0,0 +1,155 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NlInterpreter = void 0;
+const nl_1 = require("./nl");
+const dsl_1 = require("./dsl");
+const prompt_gen_1 = require("./nl/prompt-gen");
+const DEFAULT_GROQ_BASE_URL = "https://api.groq.com/openai/v1";
+const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
+const PROVIDER_ENV_KEY = "GENIE_PARSER_PROVIDER";
+function normalizeBaseUrl(baseUrl) {
+    return baseUrl.trim().replace(/\/+$/, "");
+}
+function stripChatCompletionsSuffix(baseUrl) {
+    if (!baseUrl.endsWith("/chat/completions")) {
+        return baseUrl;
+    }
+    return baseUrl.slice(0, -"/chat/completions".length);
+}
+function isDirectOpenAIBaseUrl(baseUrl) {
+    try {
+        const url = new URL(baseUrl);
+        return url.hostname === "api.openai.com";
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeProviderBaseUrl(provider, baseUrl) {
+    const fallbackBaseUrl = provider === "openai" ? DEFAULT_OPENAI_BASE_URL : DEFAULT_GROQ_BASE_URL;
+    if (!baseUrl || baseUrl.trim().length === 0) {
+        return fallbackBaseUrl;
+    }
+    const normalizedBaseUrl = stripChatCompletionsSuffix(normalizeBaseUrl(baseUrl));
+    if (normalizedBaseUrl.endsWith("/openai/v1") ||
+        normalizedBaseUrl.endsWith("/v1")) {
+        return normalizedBaseUrl;
+    }
+    if (provider === "openai" && isDirectOpenAIBaseUrl(normalizedBaseUrl)) {
+        return `${normalizedBaseUrl}/v1`;
+    }
+    return `${normalizedBaseUrl}/openai/v1`;
+}
+function resolveParserProvider(parserConfig) {
+    if (parserConfig?.provider === "openai" || parserConfig?.provider === "groq") {
+        return parserConfig.provider;
+    }
+    const envProvider = process.env[PROVIDER_ENV_KEY]?.trim().toLowerCase();
+    if (envProvider === "openai" || envProvider === "groq") {
+        return envProvider;
+    }
+    return "groq";
+}
+function requireOpenAIModel(model) {
+    const trimmed = model?.trim();
+    if (!trimmed) {
+        throw new Error("OpenAI parser requires parser.openai.model / semanticModel / SEMANTIC_MODEL configuration.");
+    }
+    return trimmed;
+}
+class NlInterpreter {
+    constructor(descriptions, apiKey, prompt, examples, extraPrompt, options = {}) {
+        this.descriptions = descriptions;
+        this.apiKey = apiKey;
+        this.prompt = prompt;
+        this.examples = examples;
+        this.extraPrompt = extraPrompt;
+        this.options = options;
+        if (this.prompt === undefined) {
+            console.assert(this.examples !== undefined);
+            this.prompt = new prompt_gen_1.ContextAwareDescriptorPromptGen(this.descriptions, this.examples, extraPrompt);
+        }
+        const parserConfig = this.options.parser;
+        const monitoringConfig = this.options.monitoring;
+        const provider = resolveParserProvider(parserConfig);
+        this.dslInterpreter = new dsl_1.DslInterpreter([...descriptions]);
+        this.dslValidator = new dsl_1.DslInterpreter([...descriptions], true);
+        const validateCommand = async (command) => {
+            await this.dslValidator.interpret(command);
+        };
+        if (provider === "openai") {
+            const openAIConfig = parserConfig?.openai;
+            this.nlParser = new nl_1.NlParser(this.prompt, apiKey, normalizeProviderBaseUrl("openai", openAIConfig?.baseUrl), requireOpenAIModel(openAIConfig?.model), openAIConfig?.samplingParams, monitoringConfig?.langsmithApiKey, monitoringConfig?.langsmithProject, monitoringConfig?.langsmithEndpoint, validateCommand, {
+                statefulValidationRetry: !!openAIConfig?.statefulValidationRetry,
+            });
+        }
+        else {
+            const groqConfig = parserConfig?.groq;
+            const resolvedGroqModel = groqConfig?.model ||
+                process.env.SEMANTIC_MODEL ||
+                "llama-3.3-70b-versatile";
+            this.nlParser = new nl_1.NlParserGroq(this.prompt, apiKey, resolvedGroqModel, groqConfig?.samplingParams, normalizeProviderBaseUrl("groq", groqConfig?.baseUrl), monitoringConfig?.langsmithApiKey, monitoringConfig?.langsmithProject, monitoringConfig?.langsmithEndpoint, validateCommand);
+        }
+    }
+    recordInteraction(record) {
+        const recorder = this.prompt;
+        if (typeof recorder?.recordInteraction === "function") {
+            recorder.recordInteraction(record);
+        }
+    }
+    recordTurn(record) {
+        this.recordInteraction(record);
+    }
+    setRuntimeContext(context) {
+        const runtimeContextSetter = this.prompt;
+        if (typeof runtimeContextSetter?.setRuntimeContext === "function") {
+            runtimeContextSetter.setRuntimeContext(context);
+        }
+    }
+    async interpret(nl) {
+        let command = null;
+        try {
+            command = await this.nlParser.parse(nl);
+        }
+        catch (error) {
+            this.recordInteraction({
+                utterance: nl,
+                success: false,
+                resultSummary: `parse_error:${error instanceof Error ? error.message : String(error)}`,
+            });
+            throw error;
+        }
+        if (command === null) {
+            this.recordInteraction({
+                utterance: nl,
+                success: false,
+                resultSummary: "parse_empty",
+            });
+            return null;
+        }
+        try {
+            const result = await this.dslInterpreter.interpret(command);
+            this.recordInteraction({
+                utterance: nl,
+                parsed: command,
+                success: true,
+                resultSummary: "execute_ok",
+            });
+            return result;
+        }
+        catch (error) {
+            this.recordInteraction({
+                utterance: nl,
+                parsed: command,
+                success: false,
+                resultSummary: `execute_error:${error instanceof Error ? error.message : String(error)}`,
+            });
+            throw error;
+        }
+    }
+    async respond(nl, parsed, result) {
+        return await this.nlParser.respond(nl, parsed, result);
+    }
+}
+exports.NlInterpreter = NlInterpreter;
+//# sourceMappingURL=nl-interpreter.js.map

package/dist/nl-interpreter.js.map

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

package/lib/__test__/dsl-descriptor.test.ts

@@ -0,0 +1,27 @@
+import { Restaurant } from "./example_descriptor";
+
+test("Restaurant Description", async () => {
+  const description = Restaurant._ClassDescriptor.description();
+  expect(description).toEqual(
+    "// A restaurant\n" +
+    "class Restaurant {\n" +
+      "\tstring name;\n" +
+      "\tFood[] menu;\n" +
+      "\tint rating;\n" +
+      "\tfloat priceGrade;\n" +
+      "\tstring cuisine;\n" +
+      "\tstring address;\n" +
+      "\tOrder[] orders;\n" +
+      "\t// All active restaurants\n" +
+      "\tstatic Restaurant[] all();\n" +
+      "\t// All active restaurants\n" +
+      "\tstatic Restaurant[] All();\n" +
+      "\t// The current restaurant\n" +
+      "\tstatic Restaurant current();\n" +
+      "\t// Book a table for a given date time\n" +
+      "\tvoid book(dateTime: DateTime? = `DateTime.today()`);\n" +
+      "\t// Book numbers tables for a given date time\n" +
+      "\tvoid bookTable(dateTime: DateTime?, number: int?);\n" +
+      "}"
+  );
+});