@anvia/core 0.21.0 → 0.23.0

package/dist/{chunk-N3YV3WCO.js → chunk-DALYP4PX.js}

@@ -1,18 +1,21 @@
 import {
   PromptRequest
-} from "./chunk-3IYTCGHS.js";
+} from "./chunk-BALBBVI3.js";
 import {
   isSkillTool
 } from "./chunk-YK4WAAS4.js";
 import {
   ToolSet
-} from "./chunk-6X2UTX3L.js";
+} from "./chunk-HYUYZEAJ.js";
 import {
   createTool
 } from "./chunk-MELYDKWQ.js";
 import {
   isStreamingCompletionModel
-} from "./chunk-F56AMXMQ.js";
+} from "./chunk-MC3CCKEB.js";
+import {
+  getAssistantGenerationMetadata
+} from "./chunk-ADH7NNCS.js";
 
 // src/agent/agent.ts
 import { z } from "zod";
@@ -186,6 +189,20 @@ var AgentSession = class {
     }
     return memory.store.load(this.context);
   }
+  async contextUsage() {
+    const messages = await this.messages();
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+      const message = messages[index];
+      if (message === void 0) {
+        continue;
+      }
+      const generation = getAssistantGenerationMetadata(message);
+      if (generation !== void 0) {
+        return generation.contextUsage;
+      }
+    }
+    return void 0;
+  }
   async clear() {
     const memory = this.agent.memory;
     if (memory === void 0) {
@@ -205,4 +222,4 @@ export {
   Agent,
   AgentSession
 };
-//# sourceMappingURL=chunk-N3YV3WCO.js.map
+//# sourceMappingURL=chunk-DALYP4PX.js.map

package/dist/chunk-DALYP4PX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/agent.ts","../src/agent/ids.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isStreamingCompletionModel } from \"../completion/create-completion\";\nimport type {\n  CompletionModel,\n  ContextUsage,\n  Document,\n  JsonObject,\n  JsonValue,\n  Message as MessageType,\n  ProviderTool,\n  ToolChoice,\n} from \"../completion/index\";\nimport { getAssistantGenerationMetadata } from \"../completion/types\";\nimport type { GuardrailPolicy } from \"../guardrails\";\nimport type { PromptHook } from \"../hooks\";\nimport type { MemoryContext, MemoryRegistration, SessionOptions } from \"../memory/types\";\nimport type { AgentObserverRegistration } from \"../observability\";\nimport { PromptRequest } from \"../request\";\nimport { createTool } from \"../tool/create-tool\";\nimport type { ToolSearchDocument } from \"../tool/dynamic-tools\";\nimport type { AgentMiddleware } from \"../tool/middleware\";\nimport { isSkillTool } from \"../tool/skill-tool-marker\";\nimport type {\n  AnyTool,\n  NormalizedToolOutput,\n  Tool,\n  ToolApprovalsOptions,\n  ToolCallContext,\n  ToolCallStreamEvent,\n} from \"../tool/tool\";\nimport { ToolSet } from \"../tool/tool-set\";\nimport type { VectorSearchIndex } from \"../vector-store\";\nimport { normalizeAgentId } from \"./ids\";\nimport type {\n  AgentEventStoreRegistration,\n  AgentOptions,\n  AgentToolOptions,\n  DynamicContextRegistration,\n  DynamicToolRegistration,\n} from \"./types\";\n\nexport const DEFAULT_MAX_TURNS = 20;\n\nexport class Agent<M extends CompletionModel = CompletionModel> {\n  readonly id: string;\n  readonly name: string | undefined;\n  readonly description: string | undefined;\n  readonly model: M;\n  readonly instructions: string | undefined;\n  readonly staticContext: Document[];\n  readonly temperature: number | undefined;\n  readonly maxTokens: number | undefined;\n  readonly additionalParams: JsonValue | undefined;\n  readonly toolSet: ToolSet;\n  readonly providerTools: ProviderTool[];\n  readonly toolChoice: ToolChoice | undefined;\n  readonly defaultMaxTurns: number | undefined;\n  readonly hook: PromptHook | undefined;\n  readonly outputSchema: JsonObject | undefined;\n  readonly observers: AgentObserverRegistration[];\n  readonly approvals: ToolApprovalsOptions | undefined;\n  readonly guardrails: GuardrailPolicy[];\n  readonly dynamicContexts: DynamicContextRegistration[];\n  readonly dynamicTools: DynamicToolRegistration[];\n  readonly middlewares: AgentMiddleware[];\n  readonly memory: MemoryRegistration | undefined;\n  readonly eventStore: AgentEventStoreRegistration | undefined;\n\n  constructor(options: AgentOptions<M>) {\n    this.id = normalizeAgentId(options.id);\n    this.name = options.name;\n    this.description = options.description;\n    this.model = options.model;\n    this.instructions = options.instructions;\n    this.staticContext = [...(options.staticContext ?? [])];\n    this.temperature = options.temperature;\n    this.maxTokens = options.maxTokens;\n    this.additionalParams = options.additionalParams;\n    this.toolSet = options.toolSet ?? new ToolSet();\n    this.providerTools = [...(options.providerTools ?? [])];\n    this.toolChoice = options.toolChoice;\n    this.defaultMaxTurns = options.defaultMaxTurns ?? DEFAULT_MAX_TURNS;\n    this.hook = options.hook;\n    this.outputSchema = options.outputSchema;\n    this.observers = [...(options.observers ?? [])];\n    this.approvals = options.approvals;\n    this.guardrails = [...(options.guardrails ?? [])];\n    this.dynamicContexts = [...(options.dynamicContexts ?? [])];\n    this.dynamicTools = [...(options.dynamicTools ?? [])];\n    this.middlewares = [...(options.middlewares ?? [])];\n    this.memory = options.memory;\n    this.eventStore = options.eventStore;\n  }\n\n  prompt(prompt: string | MessageType | MessageType[]): PromptRequest<M> {\n    return PromptRequest.fromAgent(this, prompt);\n  }\n\n  session(sessionId: string, options: SessionOptions = {}): AgentSession<M> {\n    if (this.memory === undefined) {\n      throw new Error(`Agent \"${this.id}\" has no memory store configured.`);\n    }\n    const normalized = sessionId.trim();\n    if (normalized.length === 0) {\n      throw new TypeError(\"Session id must be a non-empty string.\");\n    }\n    const context: MemoryContext = {\n      sessionId: normalized,\n    };\n    if (options.userId !== undefined) {\n      context.userId = options.userId;\n    }\n    if (options.metadata !== undefined) {\n      context.metadata = options.metadata;\n    }\n    return new AgentSession(this, context);\n  }\n\n  asTool(options: AgentToolOptions): Tool<{ prompt: string }, string> {\n    const description =\n      options.description ?? this.description ?? `Prompt the ${options.name} agent.`;\n\n    return createTool({\n      name: options.name,\n      description,\n      input: z.object({\n        prompt: z.string().describe(\"The prompt to send to the agent.\"),\n      }),\n      output: z.string(),\n      execute: async ({ prompt }, context: ToolCallContext) => {\n        const request = this.prompt(prompt);\n        const childRequest =\n          options.maxTurns === undefined ? request : request.maxTurns(options.maxTurns);\n        if (\n          options.stream === true &&\n          context.emitStreamEvent !== undefined &&\n          this.model.capabilities.streaming &&\n          isStreamingCompletionModel(this.model)\n        ) {\n          let output = \"\";\n          const childStream =\n            context.includeToolCallDeltas === false\n              ? childRequest.stream({ includeToolCallDeltas: false })\n              : childRequest.stream();\n          for await (const event of childStream) {\n            const streamEvent: ToolCallStreamEvent = {\n              agentId: this.id,\n              event,\n            };\n            if (this.name !== undefined) {\n              streamEvent.agentName = this.name;\n            }\n            await context.emitStreamEvent(streamEvent);\n            if (event.type === \"final\") {\n              output = event.output;\n            }\n          }\n          return output;\n        }\n        const response = await childRequest.send();\n        return response.output;\n      },\n    });\n  }\n\n  getTool(toolName: string): AnyTool | undefined {\n    const staticTool = this.toolSet.get(toolName);\n    if (staticTool !== undefined) {\n      return staticTool;\n    }\n\n    for (const registration of this.dynamicTools) {\n      const dynamicTool = dynamicToolSetFromIndex(registration.index)?.get(toolName);\n      if (dynamicTool !== undefined) {\n        return dynamicTool;\n      }\n    }\n\n    return undefined;\n  }\n\n  async callTool(\n    toolName: string,\n    args: string,\n    context?: ToolCallContext,\n  ): Promise<NormalizedToolOutput> {\n    if (this.toolSet.contains(toolName)) {\n      return this.toolSet.call(toolName, args, context);\n    }\n\n    for (const registration of this.dynamicTools) {\n      const toolSet = dynamicToolSetFromIndex(registration.index);\n      if (toolSet?.contains(toolName)) {\n        return toolSet.call(toolName, args, context);\n      }\n    }\n\n    return this.toolSet.call(toolName, args, context);\n  }\n\n  shouldApplyToolMiddleware(toolName: string): boolean {\n    return !isSkillTool(this.getTool(toolName));\n  }\n}\n\nexport class AgentSession<M extends CompletionModel = CompletionModel> {\n  constructor(\n    private readonly agent: Agent<M>,\n    private readonly context: {\n      sessionId: string;\n      userId?: string | undefined;\n      metadata?: JsonObject | undefined;\n    },\n  ) {}\n\n  prompt(prompt: string | MessageType): PromptRequest<M> {\n    if (Array.isArray(prompt)) {\n      throw new TypeError(\"AgentSession.prompt does not accept Message[] transcripts.\");\n    }\n    return PromptRequest.fromAgent(this.agent, prompt, { memoryContext: this.context });\n  }\n\n  async messages(): Promise<MessageType[]> {\n    const memory = this.agent.memory;\n    if (memory === undefined) {\n      throw new Error(`Agent \"${this.agent.id}\" has no memory store configured.`);\n    }\n    return memory.store.load(this.context);\n  }\n\n  async contextUsage(): Promise<ContextUsage | undefined> {\n    const messages = await this.messages();\n    for (let index = messages.length - 1; index >= 0; index -= 1) {\n      const message = messages[index];\n      if (message === undefined) {\n        continue;\n      }\n      const generation = getAssistantGenerationMetadata(message);\n      if (generation !== undefined) {\n        return generation.contextUsage;\n      }\n    }\n    return undefined;\n  }\n\n  async clear(): Promise<void> {\n    const memory = this.agent.memory;\n    if (memory === undefined) {\n      throw new Error(`Agent \"${this.agent.id}\" has no memory store configured.`);\n    }\n    await memory.store.clear(this.context);\n  }\n}\n\nfunction dynamicToolSetFromIndex(\n  index: VectorSearchIndex<ToolSearchDocument>,\n): ToolSet | undefined {\n  const maybeIndex = index as { toolSet?: unknown };\n  return maybeIndex.toolSet instanceof ToolSet ? maybeIndex.toolSet : undefined;\n}\n","export function normalizeAgentId(id: string): string {\n  if (typeof id !== \"string\") {\n    throw new TypeError(\"Agent id must be a string.\");\n  }\n\n  const normalized = id.trim();\n  if (normalized.length === 0) {\n    throw new TypeError(\"Agent id must be a non-empty string.\");\n  }\n\n  return normalized;\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-6X2UTX3L.js → chunk-HYUYZEAJ.js}

@@ -8,7 +8,7 @@ import {
 import {
   isToolResultContentArray,
   serializeToolResultOutput
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 
 // src/tool/errors.ts
 var ToolCallError = class extends Error {
@@ -220,4 +220,4 @@ export {
   createMiddleware,
   createThinkTool
 };
-//# sourceMappingURL=chunk-6X2UTX3L.js.map
+//# sourceMappingURL=chunk-HYUYZEAJ.js.map

package/dist/{chunk-SWUH4G2I.js → chunk-I6XOQ4LK.js}

@@ -6,7 +6,7 @@ import {
   isJsonValue,
   reasoningDisplayText,
   serializeToolResultOutput
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 
 // src/ui/messages.ts
 function uiMessagesToCoreMessages(messages) {
@@ -463,4 +463,4 @@ export {
   uiMessagesToCoreMessages,
   coreMessagesToUIMessages
 };
-//# sourceMappingURL=chunk-SWUH4G2I.js.map
+//# sourceMappingURL=chunk-I6XOQ4LK.js.map

package/dist/{chunk-WHAPIIEZ.js → chunk-JI5YZWNT.js}

@@ -1,16 +1,16 @@
 import {
   Agent,
   normalizeAgentId
-} from "./chunk-N3YV3WCO.js";
+} from "./chunk-DALYP4PX.js";
 import {
   ToolSet
-} from "./chunk-6X2UTX3L.js";
+} from "./chunk-HYUYZEAJ.js";
 import {
   resolveMemoryOptions
-} from "./chunk-ZNTIUOKL.js";
+} from "./chunk-UQX6EXWG.js";
 import {
   isProviderTool
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 import {
   toProviderJsonSchema
 } from "./chunk-WQKHFADH.js";
@@ -217,4 +217,4 @@ var AgentBuilder = class {
 export {
   AgentBuilder
 };
-//# sourceMappingURL=chunk-WHAPIIEZ.js.map
+//# sourceMappingURL=chunk-JI5YZWNT.js.map

package/dist/{chunk-F56AMXMQ.js → chunk-MC3CCKEB.js}

@@ -3,7 +3,7 @@ import {
   assertCompletionRequestSupported,
   isProviderTool,
   textFromAssistantContent
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 import {
   toProviderJsonSchema
 } from "./chunk-WQKHFADH.js";
@@ -218,4 +218,4 @@ export {
   createParsedCompletion,
   isStreamingCompletionModel
 };
-//# sourceMappingURL=chunk-F56AMXMQ.js.map
+//# sourceMappingURL=chunk-MC3CCKEB.js.map

package/dist/{chunk-TGLNXVII.js → chunk-MRQLEK2B.js}

@@ -1,9 +1,9 @@
 import {
   createCompletion
-} from "./chunk-F56AMXMQ.js";
+} from "./chunk-MC3CCKEB.js";
 import {
   Message
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 
 // src/memory/errors.ts
 var MemoryCompactionError = class extends Error {
@@ -217,4 +217,4 @@ export {
   createMemoryCompactionSummary,
   cumulativeCompactedMessageCount
 };
-//# sourceMappingURL=chunk-TGLNXVII.js.map
+//# sourceMappingURL=chunk-MRQLEK2B.js.map

package/dist/{chunk-MTGNA4OS.js → chunk-Q25IWLBT.js}

@@ -2,7 +2,7 @@ import {
   Message,
   assertCompletionRequestSupported,
   isProviderTool
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 
 // src/completion/documents.ts
 function normalizeDocuments(documents) {
@@ -135,4 +135,4 @@ export {
   formatDocument,
   CompletionRequestBuilder
 };
-//# sourceMappingURL=chunk-MTGNA4OS.js.map
+//# sourceMappingURL=chunk-Q25IWLBT.js.map

package/dist/{chunk-ZNTIUOKL.js → chunk-UQX6EXWG.js}

@@ -1,7 +1,7 @@
 import {
   assertNonnegativeInteger,
   assertPositiveInteger
-} from "./chunk-TGLNXVII.js";
+} from "./chunk-MRQLEK2B.js";
 
 // src/memory/options.ts
 function resolveMemoryOptions(options = {}) {
@@ -30,4 +30,4 @@ function resolveMemoryOptions(options = {}) {
 export {
   resolveMemoryOptions
 };
-//# sourceMappingURL=chunk-ZNTIUOKL.js.map
+//# sourceMappingURL=chunk-UQX6EXWG.js.map

package/dist/{chunk-ZSTUMG7G.js → chunk-YLMDBQO4.js}

@@ -1,20 +1,20 @@
 import {
   AgentBuilder
-} from "./chunk-WHAPIIEZ.js";
+} from "./chunk-JI5YZWNT.js";
 import {
   extractRagText
-} from "./chunk-3IYTCGHS.js";
+} from "./chunk-BALBBVI3.js";
 import {
   createTool
 } from "./chunk-MELYDKWQ.js";
 import {
   CompletionRequestBuilder
-} from "./chunk-MTGNA4OS.js";
+} from "./chunk-Q25IWLBT.js";
 import {
   CompletionCapabilityError,
   Message,
   Usage
-} from "./chunk-PJDL5UT2.js";
+} from "./chunk-ADH7NNCS.js";
 
 // src/extractor/extractor.ts
 var SUBMIT_TOOL_NAME = "submit";
@@ -138,4 +138,4 @@ export {
   Extractor,
   ExtractorBuilder
 };
-//# sourceMappingURL=chunk-ZSTUMG7G.js.map
+//# sourceMappingURL=chunk-YLMDBQO4.js.map

package/dist/completion/index.d.ts

@@ -1,6 +1,6 @@
-export { C as CreateCompletionBaseOptions, a as CreateCompletionInput, b as CreateCompletionOptions, c as CreateCompletionResult, d as CreateCompletionStreamOptions, e as CreateParsedCompletionOptions, f as CreateParsedCompletionResult, g as createCompletion, h as createCompletionStream, i as createParsedCompletion, j as isJsonValue, k as isStreamingCompletionModel } from '../json-D9IvOgx_.js';
-import { D as Document, M as Message, C as CompletionModel, g as CompletionTool, z as ToolChoice, i as JsonValue, J as JsonObject, d as CompletionRequest, e as CompletionResponse } from '../types-XjIh933x.js';
-export { A as AssistantContent, a as AssistantGenerationMetadata, b as AssistantMessage, c as AssistantMessageOptions, B as CompletionCapabilityError, E as CompletionModelCapabilities, f as CompletionSource, F as CompletionStreamEvent, G as DocumentContent, I as ImageContent, H as ImageDetail, h as JsonPrimitive, j as MessageOptions, P as ProviderTool, k as ProviderToolCall, R as Reasoning, K as ReasoningContent, L as ReasoningContentType, N as StreamingCompletionModel, S as SystemMessage, T as Text, l as ToolCall, O as ToolCallArgumentsMode, m as ToolContent, n as ToolDefinition, Q as ToolFunction, o as ToolMessage, p as ToolResult, q as ToolResultContent, r as ToolResultMessageOptions, s as ToolResultOptions, U as Usage, V as UsageDetails, t as UserContent, u as UserMessage, W as assertCompletionRequestSupported, v as getAssistantGenerationMetadata, w as isProviderTool, x as isToolResultContentArray, X as reasoningDisplayText, y as serializeToolResultOutput, Y as textFromAssistantContent } from '../types-XjIh933x.js';
+export { C as CreateCompletionBaseOptions, a as CreateCompletionInput, b as CreateCompletionOptions, c as CreateCompletionResult, d as CreateCompletionStreamOptions, e as CreateParsedCompletionOptions, f as CreateParsedCompletionResult, g as createCompletion, h as createCompletionStream, i as createParsedCompletion, j as isJsonValue, k as isStreamingCompletionModel } from '../json-BVPssigK.js';
+import { D as Document, M as Message, C as CompletionModel, i as CompletionTool, L as ToolChoice, l as JsonValue, J as JsonObject, f as CompletionRequest, g as CompletionResponse } from '../types-G12i56s2.js';
+export { A as AssistantContent, a as AssistantGenerationMetadata, b as AssistantMessage, c as AssistantMessageOptions, N as CompletionCapabilityError, O as CompletionModelCapabilities, d as CompletionModelInfo, e as CompletionModelMetadataOptions, h as CompletionSource, Q as CompletionStreamEvent, j as ContextUsage, R as DocumentContent, I as ImageContent, V as ImageDetail, k as JsonPrimitive, m as MessageOptions, n as ModelContextLimits, P as ProviderTool, o as ProviderToolCall, W as Reasoning, X as ReasoningContent, Y as ReasoningContentType, Z as StreamingCompletionModel, S as SystemMessage, T as Text, p as ToolCall, _ as ToolCallArgumentsMode, q as ToolContent, r as ToolDefinition, $ as ToolFunction, s as ToolMessage, t as ToolResult, u as ToolResultContent, v as ToolResultMessageOptions, w as ToolResultOptions, U as Usage, a0 as UsageDetails, x as UserContent, y as UserMessage, a1 as assertCompletionRequestSupported, z as calculateContextUsage, B as getAssistantGenerationMetadata, E as isProviderTool, H as isToolResultContentArray, a2 as reasoningDisplayText, F as resolveCompletionModelInfo, K as serializeToolResultOutput, a3 as textFromAssistantContent, G as withContextUsage } from '../types-G12i56s2.js';
 import '../zod-schema-C7F4clpm.js';
 import 'zod';
 

package/dist/completion/index.js

@@ -2,13 +2,13 @@ import {
   CompletionRequestBuilder,
   formatDocument,
   normalizeDocuments
-} from "../chunk-MTGNA4OS.js";
+} from "../chunk-Q25IWLBT.js";
 import {
   createCompletion,
   createCompletionStream,
   createParsedCompletion,
   isStreamingCompletionModel
-} from "../chunk-F56AMXMQ.js";
+} from "../chunk-MC3CCKEB.js";
 import {
   AssistantContent,
   CompletionCapabilityError,
@@ -17,14 +17,17 @@ import {
   Usage,
   UserContent,
   assertCompletionRequestSupported,
+  calculateContextUsage,
   getAssistantGenerationMetadata,
   isJsonValue,
   isProviderTool,
   isToolResultContentArray,
   reasoningDisplayText,
+  resolveCompletionModelInfo,
   serializeToolResultOutput,
-  textFromAssistantContent
-} from "../chunk-PJDL5UT2.js";
+  textFromAssistantContent,
+  withContextUsage
+} from "../chunk-ADH7NNCS.js";
 import "../chunk-WQKHFADH.js";
 export {
   AssistantContent,
@@ -35,6 +38,7 @@ export {
   Usage,
   UserContent,
   assertCompletionRequestSupported,
+  calculateContextUsage,
   createCompletion,
   createCompletionStream,
   createParsedCompletion,
@@ -46,7 +50,9 @@ export {
   isToolResultContentArray,
   normalizeDocuments,
   reasoningDisplayText,
+  resolveCompletionModelInfo,
   serializeToolResultOutput,
-  textFromAssistantContent
+  textFromAssistantContent,
+  withContextUsage
 };
 //# sourceMappingURL=index.js.map

package/dist/{errors-Bf661V89.d.ts → errors-2moLDuuN.d.ts}

@@ -1,5 +1,5 @@
-import { C as CompletionModel, M as Message, U as Usage } from './types-XjIh933x.js';
-import { S as SummaryMemoryCompactorOptions, e as MemoryCompactor } from './types-DBHzPsbx.js';
+import { C as CompletionModel, M as Message, U as Usage } from './types-G12i56s2.js';
+import { S as SummaryMemoryCompactorOptions, e as MemoryCompactor } from './types-BrLbKnEz.js';
 
 declare function createSummaryMemoryCompactor(model: CompletionModel, options?: SummaryMemoryCompactorOptions): MemoryCompactor;
 declare function isMemoryCompactionSummary(message: Message): boolean;

package/dist/evals/index.d.ts

@@ -1,15 +1,15 @@
-import { A as Agent } from '../agent-Q7FT1xmG.js';
-import { i as JsonValue, M as Message, C as CompletionModel } from '../types-XjIh933x.js';
-import { P as PromptResponse } from '../index-XTUEMWhU.js';
 import { Z as ZodSchema } from '../zod-schema-C7F4clpm.js';
+import { l as JsonValue, C as CompletionModel, M as Message } from '../types-G12i56s2.js';
+import { A as Agent } from '../agent-x3YTyv5i.js';
+import { P as PromptResponse } from '../index-BxSbmOMr.js';
 import { E as EmbeddingModel } from '../types-BCTRUGex.js';
-import '../guardrails/index.js';
-import '../types-BCA8p0sb.js';
-import '../types-DBHzPsbx.js';
-import '../tool-Dhwg__1L.js';
-import '../middleware-DfMc30in.js';
-import '../types-BrxxAtcJ.js';
 import 'zod';
+import '../guardrails/index.js';
+import '../types-D9JpeAPF.js';
+import '../types-BrLbKnEz.js';
+import '../tool-Cohdv5GC.js';
+import '../middleware-Dp3d_pxi.js';
+import '../types-O-abTIin.js';
 
 type EvalOutcome<Score = unknown> = {
     outcome: "pass";
@@ -49,10 +49,30 @@ type EvalCase<Input, Expected = unknown> = {
     id: string;
     input: Input;
     expected?: Expected | undefined;
+    context?: string[] | undefined;
+    retrievalContext?: string[] | undefined;
     metadata?: EvalMetadata | undefined;
 };
+type EvalTurn = {
+    role: "user" | "assistant";
+    content: string;
+    metadata?: EvalMetadata | undefined;
+};
+type EvalTraceRef = {
+    traceId: string;
+    observationId?: string | undefined;
+    responseId?: string | undefined;
+};
 type EvalTarget<Input, Output, Expected = unknown> = (input: Input, testCase: EvalCase<Input, Expected>) => Output | Promise<Output>;
 type EvalOutcomeStatus = "pass" | "fail" | "invalid";
+type EvalScoreProjection = {
+    outcome: EvalOutcomeStatus;
+    value: number | string;
+    numericValue?: number | undefined;
+    categoricalValue?: string | undefined;
+    label: string;
+    explanation?: string | undefined;
+};
 type EvalMetricArgs<Input, Output, Expected = unknown> = {
     suiteName: string;
     case: EvalCase<Input, Expected>;
@@ -90,9 +110,17 @@ type EvalReportArgs<Input, Output, Score = unknown, Expected = unknown> = {
     case: EvalCase<Input, Expected>;
     output?: Output | undefined;
     targetError?: unknown;
+    trace?: EvalTraceRef | undefined;
     metric: EvalMetric<Input, Output, Score, Expected>;
     outcome: EvalOutcome<Score>;
 };
+type EvalTraceSelectorArgs<Input, Output, Expected = unknown> = {
+    suiteName: string;
+    case: EvalCase<Input, Expected>;
+    output?: Output | undefined;
+    targetError?: unknown;
+};
+type EvalTraceSelector<Input, Output, Expected = unknown> = (args: EvalTraceSelectorArgs<Input, Output, Expected>) => EvalTraceRef | undefined | Promise<EvalTraceRef | undefined>;
 type EvalReporter<Input = unknown, Output = unknown, Expected = unknown> = {
     report(args: EvalReportArgs<Input, Output, unknown, Expected>): void | Promise<void>;
 };
@@ -102,12 +130,90 @@ type RunEvalSuiteOptions<Input, Output, Expected = unknown> = {
     target: EvalTarget<Input, Output, Expected>;
     metrics: Array<EvalMetric<NoInfer<Input>, NoInfer<Output>, unknown, NoInfer<Expected>>>;
     concurrency?: number | undefined;
+    trace?: EvalTraceSelector<NoInfer<Input>, NoInfer<Output>, NoInfer<Expected>> | undefined;
     reporters?: Array<EvalReporter<NoInfer<Input>, NoInfer<Output>, NoInfer<Expected>>> | undefined;
     failOnReporterError?: boolean | undefined;
 };
 type ValueSelector<Input, Output, Expected, Value> = (args: EvalMetricArgs<Input, Output, Expected>) => Value | Promise<Value>;
 type SelectorOrValue<Input, Output, Expected, Value> = Value | ValueSelector<Input, Output, Expected, Value>;
 
+type LlmEvalOptions<Input, Output, Expected = unknown> = {
+    name?: string | undefined;
+    model: CompletionModel;
+    threshold?: number | undefined;
+    strictMode?: boolean | undefined;
+    includeReason?: boolean | undefined;
+    retries?: number | undefined;
+    input?: ValueSelector<Input, Output, Expected, string> | undefined;
+    actual?: ValueSelector<Input, Output, Expected, string> | undefined;
+};
+type AnswerRelevancyOptions<Input, Output, Expected = unknown> = LlmEvalOptions<Input, Output, Expected>;
+declare function answerRelevancy<Input, Output, Expected = unknown>(options: AnswerRelevancyOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type PromptAlignmentOptions<Input, Output, Expected = unknown> = LlmEvalOptions<Input, Output, Expected> & {
+    promptInstructions: string[];
+};
+declare function promptAlignment<Input, Output, Expected = unknown>(options: PromptAlignmentOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type JsonCorrectnessOptions<Input, Output, SchemaOutput, Expected = unknown> = {
+    name?: string | undefined;
+    schema: ZodSchema<SchemaOutput>;
+    model?: CompletionModel | undefined;
+    threshold?: number | undefined;
+    strictMode?: boolean | undefined;
+    includeReason?: boolean | undefined;
+    retries?: number | undefined;
+    actual?: ValueSelector<Input, Output, Expected, string> | undefined;
+};
+declare function jsonCorrectness<Input, Output, SchemaOutput, Expected = unknown>(options: JsonCorrectnessOptions<Input, Output, SchemaOutput, Expected>): EvalMetric<Input, Output, number, Expected>;
+type HallucinationOptions<Input, Output, Expected = unknown> = LlmEvalOptions<Input, Output, Expected> & {
+    context?: SelectorOrValue<Input, Output, Expected, string[]> | undefined;
+};
+declare function hallucination<Input, Output, Expected = unknown>(options: HallucinationOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type FaithfulnessOptions<Input, Output, Expected = unknown> = LlmEvalOptions<Input, Output, Expected> & {
+    retrievalContext?: SelectorOrValue<Input, Output, Expected, string[]> | undefined;
+    truthsExtractionLimit?: number | undefined;
+    penalizeAmbiguousClaims?: boolean | undefined;
+};
+declare function faithfulness<Input, Output, Expected = unknown>(options: FaithfulnessOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type SummarizationOptions<Input, Output, Expected = unknown> = LlmEvalOptions<Input, Output, Expected> & {
+    assessmentQuestions?: string[] | undefined;
+    questionCount?: number | undefined;
+    truthsExtractionLimit?: number | undefined;
+};
+declare function summarization<Input, Output, Expected = unknown>(options: SummarizationOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type GEvalParameter = "input" | "actualOutput" | "expectedOutput" | "context" | "retrievalContext" | "metadata";
+type GEvalRubric = {
+    scoreRange: readonly [number, number];
+    expectedOutcome: string;
+};
+type GEvalOptions<Input, Output, Expected = unknown> = Omit<LlmEvalOptions<Input, Output, Expected>, "name"> & {
+    name: string;
+    evaluationParams: GEvalParameter[];
+    criteria?: string | undefined;
+    evaluationSteps?: string[] | undefined;
+    rubric?: GEvalRubric[] | undefined;
+    expected?: ValueSelector<Input, Output, Expected, unknown> | undefined;
+    context?: SelectorOrValue<Input, Output, Expected, string[]> | undefined;
+    retrievalContext?: SelectorOrValue<Input, Output, Expected, string[]> | undefined;
+};
+declare function gEval<Input, Output, Expected = unknown>(options: GEvalOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type ConversationEvalOptions<Input, Output, Expected = unknown> = {
+    name?: string | undefined;
+    model: CompletionModel;
+    threshold?: number | undefined;
+    strictMode?: boolean | undefined;
+    includeReason?: boolean | undefined;
+    retries?: number | undefined;
+    concurrency?: number | undefined;
+    turns?: ValueSelector<Input, Output, Expected, ConversationSource> | undefined;
+};
+type TurnRelevancyOptions<Input, Output, Expected = unknown> = ConversationEvalOptions<Input, Output, Expected> & {
+    windowSize?: number | undefined;
+};
+declare function turnRelevancy<Input, Output, Expected = unknown>(options: TurnRelevancyOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type KnowledgeRetentionOptions<Input, Output, Expected = unknown> = ConversationEvalOptions<Input, Output, Expected>;
+declare function knowledgeRetention<Input, Output, Expected = unknown>(options: KnowledgeRetentionOptions<Input, Output, Expected>): EvalMetric<Input, Output, number, Expected>;
+type ConversationSource = EvalTurn[] | Message[];
+
 type AgentEvalTargetOptions<Input, Output = PromptResponse> = {
     prompt?: ((input: Input, testCase: EvalCase<Input>) => string | Message) | undefined;
     output?: ((response: PromptResponse, testCase: EvalCase<Input>) => Output) | undefined;
@@ -162,6 +268,14 @@ type LlmScoreOptions<Input, Output, Expected = unknown> = {
 };
 declare function llmScore<Input, Output, Expected = unknown>(options: LlmScoreOptions<Input, Output, Expected>): EvalMetric<Input, Output, LlmScoreMetricScore, Expected>;
 
+declare function projectEvalOutcome(outcome: EvalOutcome, dataType: EvalMetric<unknown, unknown>["dataType"]): EvalScoreProjection;
+declare function resolveEvalTraceRef(args: {
+    output?: unknown;
+    input?: unknown;
+    metadata?: EvalMetadata | undefined;
+}): EvalTraceRef | undefined;
+declare function defaultEvalTraceSelector<Input, Output, Expected>(args: EvalTraceSelectorArgs<Input, Output, Expected>): EvalTraceRef | undefined;
+
 declare function runEvalSuite<Input, Output, Expected = unknown>(options: RunEvalSuiteOptions<Input, Output, Expected>): Promise<EvalSuiteResult<Input, Output, Expected>>;
 
-export { type AgentEvalTargetOptions, type ContainsOptions, type EvalCase, type EvalCaseResult, type EvalMetadata, type EvalMetric, type EvalMetricArgs, type EvalMetricResult, EvalOutcome, type EvalOutcomeStatus, type EvalReportArgs, type EvalReporter, type EvalSuiteResult, type EvalTarget, type ExactMatchOptions, type LlmJudgeOptions, type LlmScoreMetricScore, type LlmScoreOptions, type RunEvalSuiteOptions, type SelectorOrValue, type SemanticSimilarityOptions, type ValueSelector, agentEvalTarget, contains, defineMetric, exactMatch, llmJudge, llmScore, runEvalSuite, semanticSimilarity };
+export { type AgentEvalTargetOptions, type AnswerRelevancyOptions, type ContainsOptions, type EvalCase, type EvalCaseResult, type EvalMetadata, type EvalMetric, type EvalMetricArgs, type EvalMetricResult, EvalOutcome, type EvalOutcomeStatus, type EvalReportArgs, type EvalReporter, type EvalScoreProjection, type EvalSuiteResult, type EvalTarget, type EvalTraceRef, type EvalTraceSelector, type EvalTraceSelectorArgs, type EvalTurn, type ExactMatchOptions, type FaithfulnessOptions, type GEvalOptions, type GEvalParameter, type GEvalRubric, type HallucinationOptions, type JsonCorrectnessOptions, type KnowledgeRetentionOptions, type LlmJudgeOptions, type LlmScoreMetricScore, type LlmScoreOptions, type PromptAlignmentOptions, type RunEvalSuiteOptions, type SelectorOrValue, type SemanticSimilarityOptions, type SummarizationOptions, type TurnRelevancyOptions, type ValueSelector, agentEvalTarget, answerRelevancy, contains, defaultEvalTraceSelector, defineMetric, exactMatch, faithfulness, gEval, hallucination, jsonCorrectness, knowledgeRetention, llmJudge, llmScore, projectEvalOutcome, promptAlignment, resolveEvalTraceRef, runEvalSuite, semanticSimilarity, summarization, turnRelevancy };