@mate-academy/llm-gateway 8.0.0 → 8.2.0

package/dist/client/codegen/renderSnapshot.js

@@ -1,146 +1,173 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderSnapshotFile = renderSnapshotFile;
+const ts_morph_1 = require("ts-morph");
 const promptName_1 = require("../../client/codegen/promptName");
-const FILE_HEADER = `/* eslint-disable */
-// AUTO-GENERATED by \`npm run langfuse:generate\`. DO NOT EDIT, DO NOT COMMIT.
-// Regenerated locally on demand, in CI before image builds, and refreshed
-// non-blocking at API pod boot. Gitignored exactly like GraphQL generated files.
-
-import {
-  type LLMPromptMessage,
-  type LLMPromptSnapshot,
-  type LLMVariableValue,
-} from '@mate-academy/llm-gateway';
-`;
-const TS_IDENTIFIER_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+const renderSnapshot_constants_1 = require("../../client/codegen/renderSnapshot.constants");
 /**
  * Renders the full `langfusePrompts.generated.ts` content from fetched prompt
  * records: the `LLMPrompt` enum, per-prompt required-variable unions, the
  * `LLMPromptVariableMap` the client infers from, typed `compile()` helpers
  * (strict on required vars, tolerant of extras), and the snapshot constant used
- * as the outage fallback. A prompt whose enum member is not a valid TS
- * identifier is skipped with a warning rather than emitted — a hostile prompt
- * name can never produce a file that fails the build.
+ * as the outage fallback. The emitted file is declarations only — it compiles
+ * against the runtime helpers the package exports rather than carrying its own
+ * copy of them. A prompt whose enum member is not a valid TS identifier is
+ * skipped with a warning rather than emitted — a hostile prompt name can never
+ * produce a file that fails the build.
  */
 function renderSnapshotFile(records, options = {}) {
-    const renderable = records.filter((record) => {
-        const member = (0, promptName_1.promptNameToEnumMember)(record.name);
-        if (TS_IDENTIFIER_PATTERN.test(member)) {
-            return true;
-        }
-        options.onWarn?.(`Skipping prompt "${record.name}": its name does not map to a valid `
-            + `TypeScript identifier (got "${member}").`);
-        return false;
-    });
+    const renderable = records.filter((record) => isRenderable(record, options));
     const sorted = [...renderable].sort((left, right) => left.name.localeCompare(right.name));
-    return [
-        FILE_HEADER,
-        renderEnum(sorted),
-        renderVariableUnions(sorted),
-        renderVariableMap(sorted),
-        renderCompilers(sorted),
-        renderSnapshot(sorted),
-    ].join('\n');
+    return new SnapshotFileBuilder(sorted).build();
 }
-function renderEnum(records) {
-    if (records.length === 0) {
-        return 'export enum LLMPrompt {}\n';
+function isRenderable(record, options) {
+    const member = (0, promptName_1.promptNameToEnumMember)(record.name);
+    if (renderSnapshot_constants_1.TS_IDENTIFIER_PATTERN.test(member)) {
+        return true;
     }
-    const members = records
-        .map((record) => `  ${(0, promptName_1.promptNameToEnumMember)(record.name)} = ${JSON.stringify(record.name)},`)
-        .join('\n');
-    return `export enum LLMPrompt {\n${members}\n}\n`;
-}
-function renderVariableUnions(records) {
-    return records
-        .map((record) => {
-        const member = (0, promptName_1.promptNameToEnumMember)(record.name);
-        const union = record.requiredVariables.length > 0
-            ? record.requiredVariables.map((name) => JSON.stringify(name)).join(' | ')
-            : 'never';
-        return `export type ${member}Variables = ${union};`;
-    })
-        .join('\n')
-        .concat('\n');
+    options.onWarn?.(`Skipping prompt "${record.name}": its name does not map to a valid `
+        + `TypeScript identifier (got "${member}").`);
+    return false;
 }
-function renderVariableMap(records) {
-    if (records.length === 0) {
-        return 'export interface LLMPromptVariableMap {}\n';
+/**
+ * Builds the generated file through ts-morph's structural API — enum, type
+ * aliases, interface, functions and the snapshot constant are declared as
+ * structures and printed by the TypeScript emitter, so the codegen never
+ * hand-assembles TypeScript source out of strings.
+ */
+class SnapshotFileBuilder {
+    records;
+    sourceFile;
+    constructor(records) {
+        this.records = records;
+        const project = new ts_morph_1.Project({
+            useInMemoryFileSystem: true,
+            manipulationSettings: {
+                indentationText: ts_morph_1.IndentationText.TwoSpaces,
+                quoteKind: ts_morph_1.QuoteKind.Single,
+                useTrailingCommas: true,
+            },
+        });
+        this.sourceFile = project.createSourceFile(renderSnapshot_constants_1.GENERATED_FILE_NAME);
+    }
+    build() {
+        this.addGatewayImport();
+        this.addPromptEnum();
+        this.addVariableUnions();
+        this.addVariableMap();
+        this.addCompilers();
+        this.addSnapshotConstant();
+        this.sourceFile.formatText({ indentSize: 2, convertTabsToSpaces: true });
+        return this.sourceFile.getFullText();
+    }
+    addGatewayImport() {
+        this.sourceFile.addImportDeclaration({
+            leadingTrivia: renderSnapshot_constants_1.FILE_HEADER_COMMENT,
+            moduleSpecifier: renderSnapshot_constants_1.GATEWAY_MODULE_SPECIFIER,
+            namedImports: [
+                { name: renderSnapshot_constants_1.MESSAGES_COMPILER_NAME },
+                { name: renderSnapshot_constants_1.TEXT_COMPILER_NAME },
+                { name: renderSnapshot_constants_1.PROMPT_MESSAGE_TYPE_NAME, isTypeOnly: true },
+                { name: renderSnapshot_constants_1.SNAPSHOT_TYPE_NAME, isTypeOnly: true },
+                { name: renderSnapshot_constants_1.VARIABLE_VALUE_TYPE_NAME, isTypeOnly: true },
+            ],
+        });
+    }
+    addPromptEnum() {
+        this.sourceFile.addEnum({
+            name: renderSnapshot_constants_1.PROMPT_ENUM_NAME,
+            isExported: true,
+            members: this.records.map((record) => ({
+                name: (0, promptName_1.promptNameToEnumMember)(record.name),
+                initializer: JSON.stringify(record.name),
+            })),
+        });
+    }
+    addVariableUnions() {
+        this.sourceFile.addTypeAliases(this.records.map((record) => ({
+            name: `${(0, promptName_1.promptNameToEnumMember)(record.name)}Variables`,
+            isExported: true,
+            type: toVariablesUnion(record),
+        })));
+    }
+    addVariableMap() {
+        this.sourceFile.addInterface({
+            name: renderSnapshot_constants_1.VARIABLE_MAP_INTERFACE_NAME,
+            isExported: true,
+            properties: this.records.map((record) => {
+                const member = (0, promptName_1.promptNameToEnumMember)(record.name);
+                return {
+                    name: `[${renderSnapshot_constants_1.PROMPT_ENUM_NAME}.${member}]`,
+                    type: `${member}Variables`,
+                };
+            }),
+        });
+    }
+    addCompilers() {
+        this.sourceFile.addFunctions(this.records.map((record) => toCompilerStructure(record)));
+    }
+    addSnapshotConstant() {
+        this.sourceFile.addVariableStatement({
+            declarationKind: ts_morph_1.VariableDeclarationKind.Const,
+            isExported: true,
+            declarations: [{
+                    name: renderSnapshot_constants_1.SNAPSHOT_CONSTANT_NAME,
+                    type: renderSnapshot_constants_1.SNAPSHOT_TYPE_NAME,
+                    initializer: (writer) => this.writeSnapshotEntries(writer),
+                }],
+        });
+    }
+    writeSnapshotEntries(writer) {
+        if (this.records.length === 0) {
+            writer.write('{}');
+            return;
+        }
+        writer.inlineBlock(() => {
+            this.records.forEach((record) => {
+                const member = (0, promptName_1.promptNameToEnumMember)(record.name);
+                const entry = JSON.stringify(toSnapshotEntry(record), null, 2);
+                writer.writeLine(`[${renderSnapshot_constants_1.PROMPT_ENUM_NAME}.${member}]: ${entry},`);
+            });
+        });
     }
-    const entries = records
-        .map((record) => {
-        const member = (0, promptName_1.promptNameToEnumMember)(record.name);
-        return `  [LLMPrompt.${member}]: ${member}Variables;`;
-    })
-        .join('\n');
-    return `export interface LLMPromptVariableMap {\n${entries}\n}\n`;
 }
-function renderCompilers(records) {
-    return records
-        .map((record) => {
-        const member = (0, promptName_1.promptNameToEnumMember)(record.name);
-        const strictVars = record.requiredVariables.length > 0
-            ? `Record<${member}Variables, LLMVariableValue>`
-            : 'Record<string, never>';
-        const returnType = record.kind === 'chat' ? 'LLMPromptMessage[]' : 'string';
-        const compileCall = record.kind === 'chat'
-            ? 'compileMessagesFromSnapshot'
-            : 'compileTextFromSnapshot';
-        return `export function compile${member}(\n`
-            + `  variables: ${strictVars} & Record<string, LLMVariableValue>,\n`
-            + `): ${returnType} {\n`
-            + `  return ${compileCall}(LLMPrompt.${member}, variables);\n`
-            + '}';
-    })
-        .join('\n\n')
-        .concat('\n');
+function toCompilerStructure(record) {
+    const member = (0, promptName_1.promptNameToEnumMember)(record.name);
+    const isChatPrompt = record.kind === 'chat';
+    const compilerName = isChatPrompt
+        ? renderSnapshot_constants_1.MESSAGES_COMPILER_NAME
+        : renderSnapshot_constants_1.TEXT_COMPILER_NAME;
+    return {
+        name: `compile${member}`,
+        isExported: true,
+        parameters: [{
+                name: 'variables',
+                type: toVariablesParameterType(record),
+            }],
+        returnType: isChatPrompt ? `${renderSnapshot_constants_1.PROMPT_MESSAGE_TYPE_NAME}[]` : 'string',
+        statements: (writer) => {
+            writer.write(`return ${compilerName}(`).inlineBlock(() => {
+                writer.writeLine(`snapshot: ${renderSnapshot_constants_1.SNAPSHOT_CONSTANT_NAME},`);
+                writer.writeLine(`name: ${renderSnapshot_constants_1.PROMPT_ENUM_NAME}.${member},`);
+                writer.writeLine('variables,');
+            }).write(');');
+        },
+    };
+}
+function toVariablesUnion(record) {
+    if (record.requiredVariables.length === 0) {
+        return 'never';
+    }
+    return record.requiredVariables
+        .map((name) => JSON.stringify(name))
+        .join(' | ');
 }
-function renderSnapshot(records) {
-    const entries = records
-        .map((record) => {
-        const member = (0, promptName_1.promptNameToEnumMember)(record.name);
-        return `  [LLMPrompt.${member}]: ${JSON.stringify(toSnapshotEntry(record), null, 2)
-            .split('\n')
-            .map((line, index) => (index === 0 ? line : `  ${line}`))
-            .join('\n')},`;
-    })
-        .join('\n');
-    const body = records.length > 0 ? `\n${entries}\n` : '';
-    return `export const langfusePromptSnapshot: LLMPromptSnapshot = {${body}};\n\n`
-        + 'function escapeRegExp(value: string): string {\n'
-        + '  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \'\\\\$&\');\n'
-        + '}\n\n'
-        + 'function substituteVariables(\n'
-        + '  text: string,\n'
-        + '  variables: Record<string, LLMVariableValue>,\n'
-        + '): string {\n'
-        + '  return Object.entries(variables).reduce(\n'
-        + '    (result, [key, value]) => result.replace(\n'
-        + '      new RegExp(`{{\\\\s*${escapeRegExp(key)}\\\\s*}}`, \'g\'),\n'
-        + '      String(value),\n'
-        + '    ),\n'
-        + '    text,\n'
-        + '  );\n'
-        + '}\n\n'
-        + 'function compileTextFromSnapshot(\n'
-        + '  name: LLMPrompt,\n'
-        + '  variables: Record<string, LLMVariableValue>,\n'
-        + '): string {\n'
-        + '  const entry = langfusePromptSnapshot[name];\n'
-        + '  return substituteVariables(entry ? entry.fallbackText : \'\', variables);\n'
-        + '}\n\n'
-        + 'function compileMessagesFromSnapshot(\n'
-        + '  name: LLMPrompt,\n'
-        + '  variables: Record<string, LLMVariableValue>,\n'
-        + '): LLMPromptMessage[] {\n'
-        + '  const entry = langfusePromptSnapshot[name];\n'
-        + '  const messages = entry ? entry.fallbackMessages : [];\n'
-        + '  return messages.map((message) => ({\n'
-        + '    role: message.role,\n'
-        + '    content: substituteVariables(message.content, variables),\n'
-        + '  }));\n'
-        + '}\n';
+function toVariablesParameterType(record) {
+    const member = (0, promptName_1.promptNameToEnumMember)(record.name);
+    const strictVariables = record.requiredVariables.length > 0
+        ? `Record<${member}Variables, ${renderSnapshot_constants_1.VARIABLE_VALUE_TYPE_NAME}>`
+        : 'Record<string, never>';
+    return `${strictVariables} & Record<string, ${renderSnapshot_constants_1.VARIABLE_VALUE_TYPE_NAME}>`;
 }
 function toSnapshotEntry(record) {
     return {

package/dist/client/codegen/renderSnapshot.js.map

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

package/dist/client/codegen/renderSnapshot.typedefs.d.ts

@@ -0,0 +1,20 @@
+import { type LLMPromptConfig } from '../../client/llmConfig.schema';
+import { type LLMPromptKind, type LLMPromptMessage } from '../../client/promptSnapshot.typedefs';
+/**
+ * One prompt as codegen sees it: the live Langfuse record already validated
+ * against the gateway config schema and reduced to exactly what the generated
+ * file needs to declare.
+ */
+export interface CodegenPromptRecord {
+    name: string;
+    kind: LLMPromptKind;
+    version: number;
+    labels: string[];
+    requiredVariables: string[];
+    fallbackText: string;
+    fallbackMessages: LLMPromptMessage[];
+    config: LLMPromptConfig;
+}
+export interface RenderSnapshotOptions {
+    onWarn?: (message: string) => void;
+}

package/dist/client/codegen/renderSnapshot.typedefs.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=renderSnapshot.typedefs.js.map

package/dist/client/codegen/renderSnapshot.typedefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderSnapshot.typedefs.js","sourceRoot":"","sources":["../../../src/client/codegen/renderSnapshot.typedefs.ts"],"names":[],"mappings":""}

package/dist/client/coerceToolResult.d.ts

@@ -0,0 +1,10 @@
+import { type LLMToolResult } from '../LLMService.typedefs';
+/**
+ * The package-level tool-result normalization every tool call and delegation
+ * passes through before its value reaches the model. `execute` is typed to
+ * return `string | LLMStructuredToolResult`, but a tool is ordinary application
+ * code: a mistyped one can hand back an object, a number, or nothing at all.
+ * Coercing here keeps `[object Object]` out of the conversation without every
+ * tool author serializing by hand.
+ */
+export declare function coerceToolResult(value: unknown): LLMToolResult;

package/dist/client/coerceToolResult.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.coerceToolResult = coerceToolResult;
+/**
+ * The package-level tool-result normalization every tool call and delegation
+ * passes through before its value reaches the model. `execute` is typed to
+ * return `string | LLMStructuredToolResult`, but a tool is ordinary application
+ * code: a mistyped one can hand back an object, a number, or nothing at all.
+ * Coercing here keeps `[object Object]` out of the conversation without every
+ * tool author serializing by hand.
+ */
+function coerceToolResult(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (isStructuredToolResult(value)) {
+        return value;
+    }
+    return stringifyToolResult(value);
+}
+function isStructuredToolResult(value) {
+    if (typeof value !== 'object' || value === null || !('content' in value)) {
+        return false;
+    }
+    return typeof value.content === 'string';
+}
+function stringifyToolResult(value) {
+    if (value === undefined) {
+        return '';
+    }
+    try {
+        return JSON.stringify(value) ?? String(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+//# sourceMappingURL=coerceToolResult.js.map

package/dist/client/coerceToolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerceToolResult.js","sourceRoot":"","sources":["../../src/client/coerceToolResult.ts"],"names":[],"mappings":";;AAaA,4CAUC;AAlBD;;;;;;;GAOG;AACH,SAAgB,gBAAgB,CAAC,KAAc;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,SAAS,IAAI,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/client/createLLMClient.d.ts

@@ -1,44 +1,5 @@
-import { type LLMProviders } from '../LLMService.typedefs';
-import { type InferSchema, type LLMSchemaInterface } from '../utilities/schema';
 import { type LLMPromptRegistry } from '../client/defineLLMPrompts';
-import { type LLMAgentInlineRunOptions, type LLMAgentRunOptions, type LLMAgentRunResult } from '../client/agentRun.typedefs';
-import { LLMAgent, type LLMAgentDefinition } from '../client/LLMAgent';
-import { type CreateLLMClientConfig, type LLMGenerateOptions, type LLMGenerateResult, type LLMPlainMessage } from '../client/createLLMClient.typedefs';
-import { type LLMVariableValue } from '../client/promptSnapshot.typedefs';
-/**
- * Maps each registry key to the union of variable names its prompt requires. The
- * generated snapshot supplies this map; defaulting to `string` keeps the client
- * usable before codegen has run (every variable is then tolerated).
- */
-export type LLMPromptVariableMap<Registry extends LLMPromptRegistry> = {
-    [Key in keyof Registry]: string;
-};
-export interface LLMClient<Registry extends LLMPromptRegistry, VariableMap extends Record<keyof Registry, string>> {
-    generate<Key extends keyof Registry, Schema extends LLMSchemaInterface = never>(prompt: Key, options: LLMGenerateOptions<Record<VariableMap[Key], LLMVariableValue> & Record<string, LLMVariableValue>, Schema>): Promise<[
-        Schema
-    ] extends [never] ? LLMGenerateResult<Registry[Key]> : InferSchema<Schema>>;
-    countTokens<Key extends keyof Registry>(prompt: Key, options: {
-        variables: Record<string, LLMVariableValue>;
-        history?: LLMPlainMessage[];
-    }): Promise<number>;
-    defineAgent<Key extends keyof Registry>(definition: LLMAgentDefinition<Registry, VariableMap, Key>): LLMAgent<Registry, VariableMap, Key>;
-    runAgent<Key extends keyof Registry>(prompt: Key, options: LLMAgentInlineRunOptions<Record<VariableMap[Key], LLMVariableValue> & Record<string, LLMVariableValue>, Registry, VariableMap>): Promise<LLMAgentRunResult<LLMGenerateResult<Registry[Key]>>>;
-    runAgent<Key extends keyof Registry>(agent: LLMAgent<Registry, VariableMap, Key>, options: LLMAgentRunOptions<Record<VariableMap[Key], LLMVariableValue> & Record<string, LLMVariableValue>>): Promise<LLMAgentRunResult<LLMGenerateResult<Registry[Key]>>>;
-    describePrompt<Key extends keyof Registry>(prompt: Key): Promise<LLMPromptDescription>;
-}
-/**
- * Read-only routing metadata for a prompt — the `{ provider, model,
- * promptVersion }` the runtime would serve right now (same resolve/cache/fallback
- * path `generate` uses). Lets analytics events record the resolved model without
- * coupling to `generate`'s data-only return. `isFallback` flags the snapshot
- * config was used because the live fetch was unreachable or failed the gate.
- */
-export interface LLMPromptDescription {
-    provider: LLMProviders;
-    model: string;
-    promptVersion: number;
-    isFallback: boolean;
-}
+import { type CreateLLMClientConfig, type LLMClient, type LLMPromptVariableMap } from '../client/llmClient.typedefs';
 /**
  * Builds the v2 gateway client once at the composition root. The client is
  * generic over `typeof registry` (and the generated variable map), so call sites