@mate-academy/llm-gateway 8.0.0 → 8.2.0

package/dist/client/createLLMClient.js

@@ -1,13 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createLLMClient = createLLMClient;
-const LLMService_typedefs_1 = require("../LLMService.typedefs");
-const LLMAgent_1 = require("../client/LLMAgent");
-const agentRunner_1 = require("../client/agentRunner");
-const plainMessages_1 = require("../client/plainMessages");
-const createLLMClient_typedefs_1 = require("../client/createLLMClient.typedefs");
+const LLMClientEngine_1 = require("../client/LLMClientEngine");
 const promptRegistry_runtime_1 = require("../client/promptRegistry.runtime");
-const errors_1 = require("../client/errors");
+const llmClient_typedefs_1 = require("../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
@@ -17,7 +13,7 @@ const errors_1 = require("../client/errors");
  */
 function createLLMClient(config) {
     const mode = config.mode ?? 'production';
-    const reporter = config.reporting === createLLMClient_typedefs_1.ReportingDisabled
+    const reporter = config.reporting === llmClient_typedefs_1.ReportingDisabled
         ? undefined
         : config.reporting.reporter;
     const runtime = new promptRegistry_runtime_1.PromptRegistryRuntime({
@@ -28,7 +24,7 @@ function createLLMClient(config) {
         cacheTtlSeconds: config.cacheTtlSeconds,
         logger: config.logger,
     });
-    const engine = new LLMClientEngine({
+    const engine = new LLMClientEngine_1.LLMClientEngine({
         gateway: config.gateway,
         registry: config.registry,
         runtime,
@@ -37,6 +33,7 @@ function createLLMClient(config) {
         logger: config.logger,
         staticContext: config.context ?? {},
         mode,
+        normalizeToolResult: config.normalizeToolResult,
     });
     return {
         generate: (prompt, options) => engine.generate(prompt, options),
@@ -46,325 +43,4 @@ function createLLMClient(config) {
         describePrompt: (prompt) => engine.describePrompt(prompt),
     };
 }
-class LLMClientEngine {
-    gateway;
-    registry;
-    runtime;
-    credentials;
-    reporter;
-    logger;
-    staticContext;
-    mode;
-    agentRunner;
-    constructor(config) {
-        this.gateway = config.gateway;
-        this.registry = config.registry;
-        this.runtime = config.runtime;
-        this.credentials = config.credentials;
-        this.reporter = config.reporter;
-        this.logger = config.logger;
-        this.staticContext = config.staticContext;
-        this.mode = config.mode;
-        this.agentRunner = new agentRunner_1.LLMAgentRunner(this, config.logger);
-    }
-    async generate(prompt, options) {
-        const promptName = String(prompt);
-        const binding = this.registry[prompt];
-        const schema = options.schema ?? binding.schema;
-        this.assertOverridesAllowed(promptName, options.overrides);
-        const resolved = await this.resolvePrompt(promptName, binding, options.variables, {
-            purpose: LLMService_typedefs_1.LLMPurposes.Completion,
-            overrides: options.overrides,
-        });
-        return this.runCompletion(resolved, schema, options);
-    }
-    defineAgent(definition) {
-        return new LLMAgent_1.LLMAgent(definition);
-    }
-    async runAgent(promptOrAgent, options) {
-        const agent = promptOrAgent instanceof LLMAgent_1.LLMAgent ? promptOrAgent : undefined;
-        const promptKey = (agent ? agent.prompt : promptOrAgent);
-        const promptName = String(promptKey);
-        const binding = this.registry[promptKey];
-        this.assertOverridesAllowed(promptName, options.overrides);
-        const runResult = await this.agentRunner.run({
-            agentName: agent?.name ?? promptName,
-            promptName,
-            binding,
-            variables: { ...agent?.variables, ...options.variables },
-            input: options.input,
-            history: options.history,
-            tools: agent ? agent.tools : options.tools,
-            subagents: (agent ? agent.subagents : options.subagents),
-            maxToolIterations: agent
-                ? agent.maxToolIterations
-                : options.maxToolIterations,
-            context: options.context,
-            abortSignal: options.abortSignal,
-            overrides: options.overrides,
-            onEvent: options.onEvent,
-        });
-        return runResult;
-    }
-    async countTokens(prompt, options) {
-        const promptName = String(prompt);
-        const binding = this.registry[prompt];
-        const resolved = await this.resolvePrompt(promptName, binding, options.variables, { purpose: LLMService_typedefs_1.LLMPurposes.Completion });
-        const service = await this.buildCompletionService(resolved, promptName);
-        const envelope = this.buildMessageEnvelope(resolved, options.history);
-        return service.countTokens([...envelope.history, envelope.message], resolved.model);
-    }
-    async describePrompt(prompt) {
-        const promptName = String(prompt);
-        const binding = this.registry[prompt];
-        const metadata = await this.runtime.describe({
-            name: promptName,
-            kind: binding.kind === 'chat' ? 'chat' : 'text',
-            requires: binding.requires ?? [],
-            purpose: LLMService_typedefs_1.LLMPurposes.Completion,
-        });
-        if (!metadata) {
-            throw new errors_1.LLMConfigError(`unable to resolve routing metadata for "${promptName}" (live and `
-                + 'fallback both unusable)', { promptName });
-        }
-        return {
-            provider: metadata.provider,
-            model: metadata.model,
-            promptVersion: metadata.promptVersion,
-            isFallback: metadata.isFallback,
-        };
-    }
-    async resolvePrompt(promptName, binding, variables, call) {
-        const resolved = await this.runtime.resolve({
-            name: promptName,
-            kind: binding.kind === 'chat' ? 'chat' : 'text',
-            variables: this.stringifyVariables(variables),
-            requires: [
-                ...(binding.requires ?? []),
-                ...(call.additionalRequires ?? []),
-            ],
-            purpose: call.purpose,
-            versionOverride: call.overrides?.promptVersion,
-            labelOverride: call.overrides?.promptLabel,
-        });
-        if (!resolved) {
-            throw new errors_1.LLMConfigError(`unable to resolve a valid prompt for "${promptName}" (live and fallback unusable)`, { promptName });
-        }
-        return resolved;
-    }
-    async runCompletion(resolved, schema, options) {
-        const service = await this.buildCompletionService(resolved, resolved.name);
-        const envelope = this.buildMessageEnvelope(resolved, options.history);
-        const reporterContext = this.buildReporterContext(resolved, options.context);
-        const traceContext = this.buildTraceContext(resolved, options.context);
-        const sendResult = await this.callProvider(() => (schema
-            ? service.sendMessage({
-                message: envelope.message,
-                model: resolved.model,
-                history: envelope.history,
-                instructions: envelope.instructions,
-                schema,
-                abortSignal: options.abortSignal,
-                reporterContext,
-                traceContext,
-            })
-            : service.sendMessage({
-                message: envelope.message,
-                model: resolved.model,
-                history: envelope.history,
-                instructions: envelope.instructions,
-                abortSignal: options.abortSignal,
-                reporterContext,
-                traceContext,
-            })), resolved, options.abortSignal);
-        return this.unwrapResult(resolved, schema, sendResult);
-    }
-    /**
-     * Builds the provider message envelope from the resolved prompt. A `text`
-     * prompt is one user message. A `chat` prompt preserves the structure the
-     * prompt declares: a leading `system` message maps to `instructions`, the final
-     * `user` message is the request, and any messages between them join the
-     * call-supplied history in order.
-     */
-    buildMessageEnvelope(resolved, callHistory) {
-        if (resolved.kind !== 'chat') {
-            return {
-                message: this.buildUserMessage(resolved.text),
-                history: this.buildHistory(callHistory),
-                instructions: undefined,
-            };
-        }
-        const systemMessage = resolved.messages.find((message) => message.role === 'system');
-        const conversation = resolved.messages.filter((message) => message.role !== 'system');
-        const lastUserIndex = this.findLastUserIndex(conversation);
-        const promptHistory = conversation
-            .filter((_, index) => index !== lastUserIndex)
-            .map((message) => this.toCompletionMessage(message.role, message.content));
-        const requestText = lastUserIndex >= 0
-            ? conversation[lastUserIndex].content
-            : resolved.text;
-        return {
-            message: this.buildUserMessage(requestText),
-            history: [...promptHistory, ...this.buildHistory(callHistory)],
-            instructions: systemMessage?.content,
-        };
-    }
-    findLastUserIndex(messages) {
-        for (let index = messages.length - 1; index >= 0; index -= 1) {
-            if (messages[index].role === 'user') {
-                return index;
-            }
-        }
-        return -1;
-    }
-    async callProvider(send, resolved, abortSignal) {
-        try {
-            const result = await send();
-            if (result && typeof result === 'object' && 'error' in result) {
-                throw result.error;
-            }
-            return result;
-        }
-        catch (error) {
-            throw this.toTaxonomyError(error, resolved, abortSignal);
-        }
-    }
-    unwrapResult(resolved, schema, sendResult) {
-        if (!schema) {
-            return sendResult.text ?? '';
-        }
-        if (sendResult.parseError || sendResult.data === undefined) {
-            throw new errors_1.LLMSchemaValidationError(`structured output for "${resolved.name}" failed schema validation`, {
-                promptName: resolved.name,
-                provider: resolved.config.provider,
-                model: resolved.config.model,
-                rawText: sendResult.text ?? '',
-                parseDetails: sendResult.parseError ?? 'no data returned',
-            });
-        }
-        return sendResult.data;
-    }
-    toTaxonomyError(error, resolved, abortSignal) {
-        const context = {
-            promptName: resolved.name,
-            provider: resolved.config.provider,
-            model: resolved.config.model,
-            cause: error,
-        };
-        if (abortSignal?.aborted) {
-            return new errors_1.LLMAbortedError('LLM call aborted', context);
-        }
-        const status = this.extractStatus(error);
-        return new errors_1.LLMProviderError(error instanceof Error ? error.message : String(error), { ...context, retryable: this.isRetryableStatus(status), status });
-    }
-    async buildAssistanceService(resolved, promptName) {
-        const providerOptions = await this.resolveProviderOptions(resolved, promptName);
-        return this.gateway.getAssistanceService({
-            provider: resolved.config.provider,
-            options: providerOptions,
-            logger: this.logger,
-            reporter: this.reporter,
-        });
-    }
-    getBinding(promptName) {
-        return this.registry[promptName];
-    }
-    async buildCompletionService(resolved, promptName) {
-        const providerOptions = await this.resolveProviderOptions(resolved, promptName);
-        return this.gateway.getCompletionService({
-            provider: resolved.config.provider,
-            options: providerOptions,
-            logger: this.logger,
-            reporter: this.reporter,
-        });
-    }
-    async resolveProviderOptions(resolved, promptName) {
-        return this.credentials({
-            provider: resolved.config.provider,
-            promptName,
-            product: this.staticContext.product,
-        });
-    }
-    buildUserMessage(text) {
-        return this.toCompletionMessage('user', text);
-    }
-    buildHistory(history) {
-        return (0, plainMessages_1.plainMessagesToContentMessages)(history);
-    }
-    toCompletionMessage(role, text) {
-        return {
-            role: role === 'assistant' ? LLMService_typedefs_1.LLMRoles.Assistant : LLMService_typedefs_1.LLMRoles.User,
-            content: [{ type: LLMService_typedefs_1.LLMMessageContentType.TEXT, text }],
-        };
-    }
-    buildReporterContext(resolved, callContext) {
-        if (!this.reporter) {
-            return undefined;
-        }
-        return {
-            ...this.staticContext,
-            ...this.serializeCallContext(callContext),
-            promptName: resolved.name,
-            promptVersion: resolved.version,
-        };
-    }
-    /**
-     * Builds the per-call trace context every client path threads into the gateway
-     * service. The structural `prompt` names the observation and carries the
-     * managed prompt version, so the generation the service records on success and
-     * on error is the single one Langfuse links to that prompt — the client never
-     * records a second observation of its own.
-     */
-    buildTraceContext(resolved, callContext) {
-        const metadata = {
-            promptVersion: resolved.version,
-            isFallback: resolved.isFallback,
-        };
-        const userId = callContext?.userId;
-        if (userId !== undefined && userId !== null) {
-            metadata.userId = userId;
-        }
-        return {
-            prompt: {
-                name: resolved.name,
-                version: resolved.version,
-                isFallback: resolved.isFallback,
-            },
-            metadata,
-        };
-    }
-    assertOverridesAllowed(promptName, overrides) {
-        if (this.mode === 'experiment' || !overrides) {
-            return;
-        }
-        const hasOverride = Object.values(overrides).some((value) => value !== undefined);
-        if (hasOverride) {
-            throw new errors_1.LLMConfigError(`per-call overrides are rejected by a production-mode client for "${promptName}"`, { promptName });
-        }
-    }
-    stringifyVariables(variables) {
-        return Object.fromEntries(Object.entries(variables).map(([key, value]) => [key, String(value)]));
-    }
-    serializeCallContext(callContext) {
-        if (!callContext) {
-            return {};
-        }
-        return Object.fromEntries(Object.entries(callContext).filter((entry) => (entry[1] !== undefined && entry[1] !== null)));
-    }
-    extractStatus(error) {
-        if (error
-            && typeof error === 'object'
-            && 'status' in error
-            && typeof error.status === 'number') {
-            return error.status;
-        }
-        return null;
-    }
-    isRetryableStatus(status) {
-        if (status === null) {
-            return true;
-        }
-        return status === 429 || status >= 500;
-    }
-}
 //# sourceMappingURL=createLLMClient.js.map

package/dist/client/createLLMClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"createLLMClient.js","sourceRoot":"","sources":["../../src/client/createLLMClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"createLLMClient.js","sourceRoot":"","sources":["../../src/client/createLLMClient.ts"],"names":[],"mappings":";;AAkBA,0CAyCC;AA1DD,8DAA2D;AAC3D,4EAAwE;AACxE,oEAMqC;AAErC;;;;;;GAMG;AACH,SAAgB,eAAe,CAI7B,MAAuC;IAEvC,MAAM,IAAI,GAAkB,MAAM,CAAC,IAAI,IAAI,YAAY,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,KAAK,sCAAiB;QACrD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC;IAE9B,MAAM,OAAO,GAAG,IAAI,8CAAqB,CAAC;QACxC,qBAAqB,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,CACrC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAC9C;QACD,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,YAAY;QACjD,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,iCAAe,CAAC;QACjC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO;QACP,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QACnC,IAAI;QACJ,mBAAmB,EAAE,MAAM,CAAC,mBAAmB;KAChD,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAC/D,WAAW,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;QACrE,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC;QAC3D,QAAQ,EAAE,CAAC,aAAa,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAC7E,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;KACtB,CAAC;AACxC,CAAC"}

package/dist/client/index.d.ts

@@ -1,11 +1,13 @@
 export * from './errors';
 export * from './llmConfig.schema';
 export * from './promptSnapshot.typedefs';
+export * from './snapshotRuntime.typedefs';
+export * from './snapshotRuntime';
 export * from './promptClientPort.typedefs';
 export * from './defineLLMPrompts';
 export * from './validationGate';
 export * from './promptRegistry.runtime';
-export * from './createLLMClient.typedefs';
+export * from './llmClient.typedefs';
 export * from './createLLMClient';
 export * from './agentRun.typedefs';
 export * from './LLMAgent';

package/dist/client/index.js

@@ -17,11 +17,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./errors"), exports);
 __exportStar(require("./llmConfig.schema"), exports);
 __exportStar(require("./promptSnapshot.typedefs"), exports);
+__exportStar(require("./snapshotRuntime.typedefs"), exports);
+__exportStar(require("./snapshotRuntime"), exports);
 __exportStar(require("./promptClientPort.typedefs"), exports);
 __exportStar(require("./defineLLMPrompts"), exports);
 __exportStar(require("./validationGate"), exports);
 __exportStar(require("./promptRegistry.runtime"), exports);
-__exportStar(require("./createLLMClient.typedefs"), exports);
+__exportStar(require("./llmClient.typedefs"), exports);
 __exportStar(require("./createLLMClient"), exports);
 __exportStar(require("./agentRun.typedefs"), exports);
 __exportStar(require("./LLMAgent"), exports);

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,qDAAmC;AACnC,4DAA0C;AAC1C,8DAA4C;AAC5C,qDAAmC;AACnC,mDAAiC;AACjC,2DAAyC;AACzC,6DAA2C;AAC3C,oDAAkC;AAClC,sDAAoC;AACpC,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,qDAAmC;AACnC,4DAA0C;AAC1C,6DAA2C;AAC3C,oDAAkC;AAClC,8DAA4C;AAC5C,qDAAmC;AACnC,mDAAiC;AACjC,2DAAyC;AACzC,uDAAqC;AACrC,oDAAkC;AAClC,sDAAoC;AACpC,6CAA2B"}

package/dist/client/llmClient.typedefs.d.ts

@@ -0,0 +1,180 @@
+import { type LLMInstanceOptions, type LLMProviders, type LLMToolGateResult, type LLMToolResult } from '../LLMService.typedefs';
+import { type LLMGateway } from '../LLMGateway';
+import { type LLMLoggerInterface } from '../utilities/logger';
+import { type LLMReporterInterface } from '../utilities/reporter';
+import { type InferSchema, type LLMSchemaInterface } from '../utilities/schema';
+import { type LLMGatewayPromptClient } from '../client/promptClientPort.typedefs';
+import { type LLMPromptBinding, type LLMPromptRegistry } from '../client/defineLLMPrompts';
+import { type LLMPromptSnapshot, type LLMVariableValue } from '../client/promptSnapshot.typedefs';
+import { type PromptRegistryRuntime } from '../client/promptRegistry.runtime';
+import { type LLMAgent, type LLMAgentDefinition } from '../client/LLMAgent';
+import { type LLMAgentInlineRunOptions, type LLMAgentRunOptions, type LLMAgentRunResult } from '../client/agentRun.typedefs';
+export type LLMClientMode = 'production' | 'experiment';
+/**
+ * The explicit opt-out for the reporter pipeline; unlike tracing/prompts,
+ * reporting has no safe silent default, so tests must opt out loudly. Passed
+ * where `reporting` is expected to disable the Reporter/DWHSync wiring (tests,
+ * scripts).
+ */
+export declare const ReportingDisabled: unique symbol;
+export type ReportingDisabledToken = typeof ReportingDisabled;
+/**
+ * Resolves provider credentials for one call, scoped by provider + prompt +
+ * product, preserving the existing per-feature Secrets Manager layout.
+ */
+export type LLMCredentialsResolver = <Provider extends LLMProviders>(scope: {
+    provider: Provider;
+    promptName: string;
+    product?: string;
+}) => Promise<LLMInstanceOptions[Provider]>;
+export interface LLMClientStaticContext {
+    product?: string;
+    appEnvironment?: string;
+    [key: string]: string | undefined;
+}
+export interface LLMClientCallContext {
+    userId?: string | number | null;
+    [key: string]: string | number | boolean | null | undefined;
+}
+export interface LLMReportingConfig {
+    reporter: LLMReporterInterface<any>;
+}
+/**
+ * One tool call's outcome, as it stands before the client hands it to the
+ * model. `tool` is the tool (or subagent delegation) name, `agent` the run that
+ * called it, `input` the arguments the model supplied, and `result` the value
+ * the tool returned after the package's own coercion.
+ */
+export interface LLMToolResultContext {
+    tool: string;
+    agent: string;
+    input: unknown;
+    result: LLMToolResult;
+}
+/**
+ * A client-wide hook that rewrites every tool result before it reaches the
+ * model. It runs after the package coerces the raw return value, so it always
+ * receives a well-formed result; its own return is coerced again. Use it to
+ * apply one truncation, redaction, or envelope policy across every tool
+ * instead of repeating it in each `execute`.
+ */
+export type LLMToolResultNormalizer = (context: LLMToolResultContext) => LLMToolResult;
+/**
+ * The precondition a delegation tool may declare, checked before the subagent
+ * starts. The `subagents` list erases the input schema's generic, so the
+ * arguments arrive untyped here: they are the subagent's `inputSchema` shape
+ * when it declares one, and `{ prompt }` otherwise.
+ */
+export type LLMDelegationGate = (args: Record<string, unknown>) => Promise<LLMToolGateResult> | LLMToolGateResult;
+export interface CreateLLMClientConfig<Registry extends LLMPromptRegistry> {
+    gateway: LLMGateway;
+    registry: Registry;
+    snapshot: LLMPromptSnapshot;
+    credentials: LLMCredentialsResolver;
+    reporting: LLMReportingConfig | ReportingDisabledToken;
+    logger?: LLMLoggerInterface;
+    context?: LLMClientStaticContext;
+    mode?: LLMClientMode;
+    promptClient?: LLMGatewayPromptClient;
+    defaultLabel?: string;
+    cacheTtlSeconds?: number;
+    normalizeToolResult?: LLMToolResultNormalizer;
+}
+export interface LLMClientEngineConfig<Registry extends LLMPromptRegistry> {
+    gateway: LLMGateway;
+    registry: Registry;
+    runtime: PromptRegistryRuntime;
+    credentials: LLMCredentialsResolver;
+    reporter: LLMReporterInterface<any> | undefined;
+    logger: LLMLoggerInterface | undefined;
+    staticContext: Record<string, string | undefined>;
+    mode: LLMClientMode;
+    normalizeToolResult: LLMToolResultNormalizer | undefined;
+}
+/**
+ * The variables a prompt requires. Strict on required keys, tolerant of extras
+ * (`& Record<string, LLMVariableValue>`) so a Langfuse edit that drops a variable
+ * can never break a build — the stale extra is accepted, never rejected.
+ */
+export type LLMPromptVariables<RequiredKeys extends string> = Record<RequiredKeys, LLMVariableValue> & Record<string, LLMVariableValue>;
+/**
+ * Where a subagent's prompt variables come from. Without an `inputSchema` the
+ * parent model supplies only a task string, so the definition must carry every
+ * variable the prompt requires. With one, the model fills the rest at call
+ * time — the definition's own variables become a partial base and the runtime
+ * validation gate is what proves the set complete.
+ */
+export type LLMSubagentVariableSource<RequiredKeys extends string> = {
+    inputSchema?: undefined;
+    variables: LLMPromptVariables<RequiredKeys>;
+} | {
+    inputSchema: LLMSchemaInterface;
+    variables?: Partial<LLMPromptVariables<RequiredKeys>>;
+};
+/**
+ * The return type of `generate` for one prompt: the bound schema's inferred type
+ * when a schema is present, else the raw completion string.
+ */
+export type LLMGenerateResult<Binding extends LLMPromptBinding> = Binding extends {
+    schema: infer Schema;
+} ? Schema extends LLMSchemaInterface ? InferSchema<Schema> : string : string;
+export interface LLMGenerateOptions<Variables extends Record<string, LLMVariableValue>, Schema extends LLMSchemaInterface = never> {
+    variables: Variables;
+    context?: LLMClientCallContext;
+    history?: LLMPlainMessage[];
+    abortSignal?: AbortSignal;
+    overrides?: LLMCallOverrides;
+    /**
+     * Per-call structured-output schema. Overrides the registry binding's `schema`
+     * for this call and drives the return type (`InferSchema<Schema>`). Use it when
+     * the output contract is dynamic per call (e.g. a schema whose shape depends on
+     * runtime input). The schema is the code-owned output contract, not a routing
+     * control, so it is honored in every mode.
+     */
+    schema?: Schema;
+}
+export interface LLMCallOverrides {
+    model?: string;
+    provider?: LLMProviders;
+    promptVersion?: number;
+    promptLabel?: string;
+}
+export type LLMPlainMessageRole = 'user' | 'assistant';
+export interface LLMPlainMessage {
+    role: LLMPlainMessageRole;
+    text: string;
+}
+/**
+ * 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;
+}

package/dist/client/{createLLMClient.typedefs.js → llmClient.typedefs.js}

@@ -8,4 +8,4 @@ exports.ReportingDisabled = void 0;
  * scripts).
  */
 exports.ReportingDisabled = Symbol('ReportingDisabled');
-//# sourceMappingURL=createLLMClient.typedefs.js.map
+//# sourceMappingURL=llmClient.typedefs.js.map

package/dist/client/llmClient.typedefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llmClient.typedefs.js","sourceRoot":"","sources":["../../src/client/llmClient.typedefs.ts"],"names":[],"mappings":";;;AA6BA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/client/plainMessages.d.ts

@@ -1,5 +1,5 @@
 import { LLMRoles, type LLMMessageTextContent } from '../LLMService.typedefs';
-import { type LLMPlainMessage } from '../client/createLLMClient.typedefs';
+import { type LLMPlainMessage } from '../client/llmClient.typedefs';
 export interface LLMPlainTextContentMessage {
     role: LLMRoles;
     content: LLMMessageTextContent[];

package/dist/client/promptRegistry.runtime.d.ts

@@ -1,6 +1,6 @@
 import { LLMPurposes, type LLMModel, type LLMProviders } from '../LLMService.typedefs';
 import { type LLMLoggerInterface } from '../utilities/logger';
-import { type LangfuseFallbackMetricEmitter } from '../utilities/llmTracing';
+import { type LLMFallbackMetricEmitter } from '../utilities/llmTracing';
 import { type LLMGatewayPromptClient } from '../client/promptClientPort.typedefs';
 import { type LLMPromptKind, type LLMPromptMessage, type LLMPromptSnapshot } from '../client/promptSnapshot.typedefs';
 import { type LLMPromptConfig } from '../client/llmConfig.schema';
@@ -60,7 +60,7 @@ export interface PromptRegistryRuntimeConfig {
     defaultLabel: string;
     cacheTtlSeconds?: number;
     logger?: LLMLoggerInterface;
-    fallbackMetricEmitter?: LangfuseFallbackMetricEmitter;
+    fallbackMetricEmitter?: LLMFallbackMetricEmitter;
 }
 /**
  * Owns prompt resolution at runtime: a live SDK fetch (cached 60s,