@mate-academy/prompt-client 1.0.0 → 2.0.1

package/dist/LLMTracer.typedefs.d.ts

@@ -1,45 +0,0 @@
-import { type LLMPrompt } from './LLMPromptClient.typedefs';
-export interface LLMTraceOptions {
-    name: string;
-    sessionId?: string;
-    userId?: string;
-    tags?: string[];
-    metadata?: Record<string, unknown>;
-    input?: unknown;
-    output?: unknown;
-}
-export interface LLMTraceUpdateOptions<Input = unknown, Output = unknown> {
-    input?: Input;
-    output?: Output;
-    metadata?: Record<string, unknown>;
-}
-export interface LLMTrace {
-    id: string;
-    getTraceUrl(): string;
-    update<Input = unknown, Output = unknown>(options: LLMTraceUpdateOptions<Input, Output>): void;
-}
-export interface LLMGenerationOptions {
-    name: string;
-    model?: string;
-    modelParameters?: Record<string, string | number | boolean | null>;
-    metadata?: Record<string, unknown>;
-    input?: unknown;
-    output?: unknown;
-    prompt?: LLMPrompt;
-}
-export interface LLMGenerationEndOptions {
-    output?: unknown;
-    metadata?: Record<string, unknown>;
-    usageDetails?: Record<string, number>;
-    costDetails?: Record<string, number>;
-}
-export interface LLMGeneration {
-    id: string;
-    end(options?: LLMGenerationEndOptions): void;
-}
-export interface LLMTracer {
-    createTrace(options: LLMTraceOptions): LLMTrace;
-    createGeneration(trace: LLMTrace, options: LLMGenerationOptions): LLMGeneration;
-    flush(): Promise<void>;
-    shutdown(): Promise<void>;
-}

package/dist/LLMTracer.typedefs.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/dist/providers/InMemory/InMemoryTracer.client.d.ts

@@ -1,15 +0,0 @@
-import { type LLMGeneration, type LLMGenerationOptions, type LLMTrace, type LLMTraceOptions, type LLMTracer } from '../../LLMTracer.typedefs';
-import { type InMemoryRecordedGeneration, type InMemoryRecordedTrace } from '../../providers/InMemory/InMemory.typedefs';
-export declare class InMemoryTracer implements LLMTracer {
-    readonly traces: InMemoryRecordedTrace[];
-    readonly generations: InMemoryRecordedGeneration[];
-    flushCallCount: number;
-    shutdownCallCount: number;
-    private nextEntityNumber;
-    createTrace(options: LLMTraceOptions): LLMTrace;
-    createGeneration(trace: LLMTrace, options: LLMGenerationOptions): LLMGeneration;
-    flush(): Promise<void>;
-    shutdown(): Promise<void>;
-    reset(): void;
-    private takeEntityNumber;
-}

package/dist/providers/InMemory/InMemoryTracer.client.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InMemoryTracer = void 0;
-class InMemoryTracer {
-    constructor() {
-        this.traces = [];
-        this.generations = [];
-        this.flushCallCount = 0;
-        this.shutdownCallCount = 0;
-        this.nextEntityNumber = 1;
-    }
-    createTrace(options) {
-        const recordedTrace = {
-            id: `trace-${this.takeEntityNumber()}`,
-            options,
-            updates: [],
-        };
-        this.traces.push(recordedTrace);
-        return {
-            id: recordedTrace.id,
-            getTraceUrl: () => `in-memory://traces/${recordedTrace.id}`,
-            update: (updateOptions) => {
-                recordedTrace.updates.push(updateOptions);
-            },
-        };
-    }
-    createGeneration(trace, options) {
-        const recordedGeneration = {
-            id: `generation-${this.takeEntityNumber()}`,
-            traceId: trace.id,
-            options,
-            endOptions: null,
-            isEnded: false,
-        };
-        this.generations.push(recordedGeneration);
-        return {
-            id: recordedGeneration.id,
-            end: (endOptions) => {
-                recordedGeneration.endOptions = endOptions ?? null;
-                recordedGeneration.isEnded = true;
-            },
-        };
-    }
-    async flush() {
-        this.flushCallCount += 1;
-    }
-    async shutdown() {
-        this.shutdownCallCount += 1;
-    }
-    reset() {
-        this.traces.splice(0);
-        this.generations.splice(0);
-        this.flushCallCount = 0;
-        this.shutdownCallCount = 0;
-        this.nextEntityNumber = 1;
-    }
-    takeEntityNumber() {
-        const entityNumber = this.nextEntityNumber;
-        this.nextEntityNumber += 1;
-        return entityNumber;
-    }
-}
-exports.InMemoryTracer = InMemoryTracer;

package/dist/providers/Langfuse/LangfuseTracer.client.d.ts

@@ -1,13 +0,0 @@
-import { type Langfuse } from 'langfuse';
-import { type LLMGeneration, type LLMGenerationOptions, type LLMTrace, type LLMTraceOptions, type LLMTracer } from '../../LLMTracer.typedefs';
-import { type PromptManagementLogger } from '../../utilities/logger';
-export declare class LangfuseTracer implements LLMTracer {
-    private readonly client;
-    private readonly logger;
-    constructor(client: Langfuse, logger: PromptManagementLogger);
-    createTrace(options: LLMTraceOptions): LLMTrace;
-    createGeneration(trace: LLMTrace, options: LLMGenerationOptions): LLMGeneration;
-    flush(): Promise<void>;
-    shutdown(): Promise<void>;
-    private wrapError;
-}

package/dist/providers/Langfuse/LangfuseTracer.client.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LangfuseTracer = void 0;
-const LLMTracer_errors_1 = require("../../LLMTracer.errors");
-const LangfusePrompt_1 = require("../../providers/Langfuse/LangfusePrompt");
-class LangfuseTracer {
-    constructor(client, logger) {
-        this.client = client;
-        this.logger = logger;
-    }
-    createTrace(options) {
-        try {
-            return this.client.trace(options);
-        }
-        catch (error) {
-            throw this.wrapError('Failed to create Langfuse trace', error, {
-                traceName: options.name,
-            });
-        }
-    }
-    createGeneration(trace, options) {
-        const { prompt, ...generationOptions } = options;
-        try {
-            return this.client.generation({
-                ...generationOptions,
-                traceId: trace.id,
-                ...(prompt instanceof LangfusePrompt_1.LangfusePrompt
-                    ? { prompt: prompt.nativePrompt }
-                    : {}),
-            });
-        }
-        catch (error) {
-            throw this.wrapError('Failed to create Langfuse generation', error, {
-                generationName: options.name,
-            });
-        }
-    }
-    flush() {
-        return this.client.flushAsync();
-    }
-    shutdown() {
-        return this.client.shutdownAsync();
-    }
-    wrapError(message, error, fields) {
-        this.logger.error(message, { error, ...fields });
-        return new LLMTracer_errors_1.LLMTracerError(message, error);
-    }
-}
-exports.LangfuseTracer = LangfuseTracer;

package/dist/utilities/usageDetails/index.d.ts

@@ -1 +0,0 @@
-export * from '../../utilities/usageDetails/usageDetails.helpers';

package/dist/utilities/usageDetails/index.js

@@ -1,17 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("../../utilities/usageDetails/usageDetails.helpers"), exports);

package/dist/utilities/usageDetails/usageDetails.helpers.d.ts

@@ -1,17 +0,0 @@
-export interface LLMUsageInput {
-    inputTextTokens?: number;
-    outputTextTokens?: number;
-    inputAudioTokens?: number;
-    outputAudioTokens?: number;
-    inputCachedTextTokens?: number;
-    inputCachedAudioTokens?: number;
-    outputReasoningTokens?: number;
-}
-export interface LLMCostInput {
-    input: number;
-    output: number;
-    total: number;
-    currency: string;
-}
-export declare const usageToUsageDetails: (usage?: LLMUsageInput) => Record<string, number> | undefined;
-export declare const costToCostDetails: (cost?: LLMCostInput) => Record<string, number> | undefined;

package/dist/utilities/usageDetails/usageDetails.helpers.js

@@ -1,33 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.costToCostDetails = exports.usageToUsageDetails = void 0;
-const toPositiveDetails = (keyedAmounts) => {
-    const populated = keyedAmounts.filter(([, amount]) => amount > 0);
-    if (populated.length === 0) {
-        return undefined;
-    }
-    return Object.fromEntries(populated);
-};
-const usageToUsageDetails = (usage) => {
-    if (!usage) {
-        return undefined;
-    }
-    return toPositiveDetails([
-        ['input', usage.inputTextTokens ?? 0],
-        ['input_cached', usage.inputCachedTextTokens ?? 0],
-        ['output', (usage.outputTextTokens ?? 0) + (usage.outputReasoningTokens ?? 0)],
-        ['input_audio', usage.inputAudioTokens ?? 0],
-        ['output_audio', usage.outputAudioTokens ?? 0],
-    ]);
-};
-exports.usageToUsageDetails = usageToUsageDetails;
-const costToCostDetails = (cost) => {
-    if (!cost) {
-        return undefined;
-    }
-    return toPositiveDetails([
-        ['input', cost.input],
-        ['output', cost.output],
-    ]);
-};
-exports.costToCostDetails = costToCostDetails;