@mate-academy/llm-gateway 8.7.0 → 8.8.0

package/dist/services/agentRounds/agentRounds.typedefs.d.ts

@@ -7,14 +7,8 @@ import { type LLMModelUsage } from '../../LLMService.typedefs';
  * provider actually assembled — system instructions included — rather than a
  * shared message shape none of them speaks.
  */
-export interface LLMAgentRound {
+interface LLMAgentRoundBase {
     input: unknown;
-    /**
-     * The round's assistant output, in the provider's own shape, so a round that
-     * only requested tools still shows the calls it made. Absent on a round whose
-     * provider call threw; `error` then describes the failure instead.
-     */
-    output?: unknown;
     /**
      * The round's own token usage. Providers that report usage per call fill it
      * on every round; one that only totals a run leaves it unset until the last
@@ -23,10 +17,18 @@ export interface LLMAgentRound {
     usage?: LLMModelUsage;
     /** Epoch milliseconds stamped immediately before the provider call. */
     startedAt: number;
-    error?: unknown;
-    /** Marks a round whose provider call threw, traced at `level: ERROR`. */
-    isError?: boolean;
 }
+interface LLMSuccessfulAgentRound extends LLMAgentRoundBase {
+    output: unknown;
+    error?: never;
+    isError?: false;
+}
+interface LLMFailedAgentRound extends LLMAgentRoundBase {
+    output?: never;
+    error: unknown;
+    isError: true;
+}
+export type LLMAgentRound = LLMSuccessfulAgentRound | LLMFailedAgentRound;
 /**
  * What one round's response contributes to its generation. Produced by the
  * provider because only the provider knows which part of its response is the
@@ -36,5 +38,11 @@ export interface LLMAgentRoundOutcome {
     output: unknown;
     usage?: LLMModelUsage;
 }
+export interface LLMAgentRoundSpec<ProviderResponse> {
+    input: unknown;
+    call: () => Promise<ProviderResponse>;
+    describeOutcome: (response: ProviderResponse) => LLMAgentRoundOutcome;
+}
 /** Emits the generation observation of a single agent round. */
 export type LLMAgentRoundWriter = (round: LLMAgentRound) => void;
+export {};

package/dist/utilities/llmTracing/llmTracing.typedefs.d.ts

@@ -92,6 +92,7 @@ export interface LLMGatewayTracer {
     withTrace<Result>(name: string, context: LLMTraceContext, fn: () => Promise<Result>): Promise<Result>;
     recordGeneration(generation: LLMGenerationTraceRecord): void;
     withToolObservation<Result>(name: string, input: unknown, fn: () => Promise<Result>): Promise<Result>;
+    withAgentObservation<Result>(name: string, input: unknown, fn: () => Promise<Result>): Promise<Result>;
     /**
      * Updates the active trace of this tracer only (name/input replace, metadata
      * merges). A no-op outside an active scope. Isolated per tracer so it can

package/dist/utilities/llmTracing/noopLLMTracing.js

@@ -12,6 +12,9 @@ class NoopLLMGatewayTracer {
     async withToolObservation(_name, _input, fn) {
         return fn();
     }
+    async withAgentObservation(_name, _input, fn) {
+        return fn();
+    }
     updateActiveTrace() {
         // no-op when disabled
     }

package/dist/utilities/llmTracing/noopLLMTracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"noopLLMTracing.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/noopLLMTracing.ts"],"names":[],"mappings":";;;AAMA,MAAM,oBAAoB;IACf,SAAS,GAAG,KAAK,CAAC;IAE3B,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAyB,EACzB,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,gBAAgB;QACd,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,KAAa,EACb,MAAe,EACf,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,iBAAiB;QACf,sBAAsB;IACxB,CAAC;IAED,qBAAqB;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,sBAAsB;IACxB,CAAC;CACF;AAEY,QAAA,oBAAoB,GAAqB,IAAI,oBAAoB,EAAE,CAAC;AAE1E,MAAM,yBAAyB,GAA6B,GAAG,EAAE;IACtE,oCAAoC;AACtC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}
+{"version":3,"file":"noopLLMTracing.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/noopLLMTracing.ts"],"names":[],"mappings":";;;AAMA,MAAM,oBAAoB;IACf,SAAS,GAAG,KAAK,CAAC;IAE3B,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAyB,EACzB,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,gBAAgB;QACd,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,KAAa,EACb,MAAe,EACf,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,oBAAoB,CACxB,KAAa,EACb,MAAe,EACf,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,iBAAiB;QACf,sBAAsB;IACxB,CAAC;IAED,qBAAqB;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,sBAAsB;IACxB,CAAC;CACF;AAEY,QAAA,oBAAoB,GAAqB,IAAI,oBAAoB,EAAE,CAAC;AAE1E,MAAM,yBAAyB,GAA6B,GAAG,EAAE;IACtE,oCAAoC;AACtC,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mate-academy/llm-gateway",
-  "version": "8.7.0",
+  "version": "8.8.0",
   "description": "A gateway package for LLM services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/client/codegen/extractVariables.d.ts

@@ -1,7 +0,0 @@
-/**
- * Extracts the plain variable names a prompt references, matching the runtime
- * compile path (only `{{var}}` survives the conditional drop, see plan §1.3).
- * Section/closer tokens (`{{#cond}}`, `{{/cond}}`) are excluded so the generated
- * required-variable set agrees with what the validation gate counts as provided.
- */
-export declare function extractRequiredVariables(promptText: string): string[];

package/dist/client/codegen/extractVariables.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractRequiredVariables = extractRequiredVariables;
-const VARIABLE_PATTERN = /{{\s*([\w.]+)\s*}}/g;
-/**
- * Extracts the plain variable names a prompt references, matching the runtime
- * compile path (only `{{var}}` survives the conditional drop, see plan §1.3).
- * Section/closer tokens (`{{#cond}}`, `{{/cond}}`) are excluded so the generated
- * required-variable set agrees with what the validation gate counts as provided.
- */
-function extractRequiredVariables(promptText) {
-    const names = new Set();
-    for (const match of promptText.matchAll(VARIABLE_PATTERN)) {
-        const token = match[1];
-        if (!token.startsWith('#') && !token.startsWith('/')) {
-            names.add(token);
-        }
-    }
-    return [...names].sort();
-}
-//# sourceMappingURL=extractVariables.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"extractVariables.js","sourceRoot":"","sources":["../../../src/client/codegen/extractVariables.ts"],"names":[],"mappings":";;AAQA,4DAYC;AApBD,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAC,UAAkB;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAEvB,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3B,CAAC"}