@anvia/core 1.1.1 → 1.2.0

package/dist/chunk-XQV3XNVT.js

@@ -0,0 +1,225 @@
+import {
+  isJsonValue
+} from "./chunk-4C7AXYOM.js";
+
+// src/completion/provider-output-error.ts
+var COMPLETION_PROVIDER_OUTPUT_ERROR_CODE = "ANVIA_COMPLETION_PROVIDER_OUTPUT";
+var PROVIDER_OUTPUT_ERROR_KINDS = /* @__PURE__ */ new Set([
+  "malformed-tool-arguments",
+  "invalid-tool-arguments",
+  "invalid-stream-event",
+  "invalid-response",
+  "incomplete-stream",
+  "incomplete-tool-call",
+  "invalid-tool-call",
+  "truncated-tool-call",
+  "filtered-tool-call"
+]);
+var CompletionProviderOutputError = class extends Error {
+  code = COMPLETION_PROVIDER_OUTPUT_ERROR_CODE;
+  kind;
+  toolCallId;
+  finishReason;
+  usage;
+  constructor(options) {
+    assertProviderOutputErrorOptions(options);
+    super(providerOutputErrorMessage(options.kind, options.toolCallId));
+    this.name = "CompletionProviderOutputError";
+    this.kind = options.kind;
+    this.toolCallId = options.toolCallId;
+    this.finishReason = options.finishReason;
+    this.usage = options.usage === void 0 ? void 0 : copyUsage(options.usage);
+  }
+};
+function assertCompletionResponseIntegrity(options) {
+  const { response } = options;
+  const toolCalls = response.choice.filter(
+    (content) => content.type === "tool-call"
+  );
+  if (toolCalls.length > 0) {
+    if (response.finishReason !== void 0 && !isCompletionFinishReason(response.finishReason)) {
+      throw new CompletionProviderOutputError({
+        kind: "invalid-tool-call",
+        usage: response.usage
+      });
+    }
+    if (response.finishReason === "length") {
+      throw new CompletionProviderOutputError({
+        kind: "truncated-tool-call",
+        finishReason: response.finishReason,
+        usage: response.usage
+      });
+    }
+    if (response.finishReason === "content-filter") {
+      throw new CompletionProviderOutputError({
+        kind: "filtered-tool-call",
+        finishReason: response.finishReason,
+        usage: response.usage
+      });
+    }
+    if (response.finishReason === "other") {
+      throw new CompletionProviderOutputError({
+        kind: "invalid-tool-call",
+        finishReason: response.finishReason,
+        usage: response.usage
+      });
+    }
+  } else if (response.finishReason === "tool-calls") {
+    throw new CompletionProviderOutputError({
+      kind: "invalid-tool-call",
+      finishReason: response.finishReason,
+      usage: response.usage
+    });
+  }
+  const toolCallIds = /* @__PURE__ */ new Set();
+  const callIds = /* @__PURE__ */ new Set();
+  for (const toolCall of toolCalls) {
+    if (!isNonblankString(toolCall.toolCallId) || !isNonblankString(toolCall.toolName)) {
+      throw invalidToolCall(toolCall.toolCallId, response.usage);
+    }
+    if (toolCall.callId !== void 0 && !isNonblankString(toolCall.callId)) {
+      throw invalidToolCall(toolCall.toolCallId, response.usage);
+    }
+    if (toolCallIds.has(toolCall.toolCallId)) {
+      throw invalidToolCall(toolCall.toolCallId, response.usage);
+    }
+    toolCallIds.add(toolCall.toolCallId);
+    if (toolCall.callId !== void 0) {
+      if (callIds.has(toolCall.callId)) {
+        throw invalidToolCall(toolCall.toolCallId, response.usage);
+      }
+      callIds.add(toolCall.callId);
+    }
+    if (!isJsonValue(toolCall.input)) {
+      throw new CompletionProviderOutputError({
+        kind: "invalid-tool-arguments",
+        toolCallId: toolCall.toolCallId,
+        usage: response.usage
+      });
+    }
+  }
+}
+function invalidToolCall(toolCallId, usage) {
+  return new CompletionProviderOutputError({
+    kind: "invalid-tool-call",
+    toolCallId: isNonblankString(toolCallId) ? toolCallId : void 0,
+    usage
+  });
+}
+function assertProviderOutputErrorOptions(options) {
+  if (typeof options !== "object" || options === null) {
+    throw new TypeError("CompletionProviderOutputError options must be an object.");
+  }
+  if (!PROVIDER_OUTPUT_ERROR_KINDS.has(options.kind)) {
+    throw new TypeError("CompletionProviderOutputError kind is invalid.");
+  }
+  if (options.toolCallId !== void 0 && !isNonblankString(options.toolCallId)) {
+    throw new TypeError("CompletionProviderOutputError toolCallId must be a non-empty string.");
+  }
+  if (options.finishReason !== void 0 && !isCompletionFinishReason(options.finishReason)) {
+    throw new TypeError("CompletionProviderOutputError finishReason is invalid.");
+  }
+  if (options.kind === "truncated-tool-call" && options.finishReason !== "length") {
+    throw new TypeError('CompletionProviderOutputError truncated-tool-call requires "length".');
+  }
+  if (options.kind === "filtered-tool-call" && options.finishReason !== "content-filter") {
+    throw new TypeError(
+      'CompletionProviderOutputError filtered-tool-call requires "content-filter".'
+    );
+  }
+  if (options.finishReason === "length" && options.kind !== "truncated-tool-call") {
+    throw new TypeError(
+      'CompletionProviderOutputError finishReason "length" requires truncated-tool-call.'
+    );
+  }
+  if (options.finishReason === "content-filter" && options.kind !== "filtered-tool-call") {
+    throw new TypeError(
+      'CompletionProviderOutputError finishReason "content-filter" requires filtered-tool-call.'
+    );
+  }
+  if (options.usage !== void 0) {
+    assertUsage(options.usage);
+  }
+}
+function providerOutputErrorMessage(kind, toolCallId) {
+  const toolCall = toolCallId === void 0 ? "tool call" : `tool call ${JSON.stringify(displayId(toolCallId))}`;
+  if (kind === "malformed-tool-arguments") {
+    return `Completion provider returned ${toolCall} with malformed JSON arguments.`;
+  }
+  if (kind === "invalid-tool-arguments") {
+    return `Completion provider returned ${toolCall} with arguments that are not a JSON value.`;
+  }
+  if (kind === "invalid-stream-event") {
+    return "Completion provider returned an invalid stream event.";
+  }
+  if (kind === "invalid-response") {
+    return "Completion provider returned a response that cannot be consumed safely.";
+  }
+  if (kind === "incomplete-tool-call") {
+    return "Completion provider stream ended before its tool call was complete.";
+  }
+  if (kind === "incomplete-stream") {
+    return "Completion provider stream ended without a terminal response.";
+  }
+  if (kind === "truncated-tool-call") {
+    return "Completion provider stopped at its output limit before a tool call could be consumed safely.";
+  }
+  if (kind === "filtered-tool-call") {
+    return "Completion provider content filtering prevented a tool call from being consumed safely.";
+  }
+  return `Completion provider returned an invalid ${toolCall}.`;
+}
+function displayId(value) {
+  let sanitized = "";
+  for (const character of value) {
+    const code = character.charCodeAt(0);
+    sanitized += code <= 31 || code === 127 ? "\uFFFD" : character;
+  }
+  return sanitized.length <= 128 ? sanitized : `${sanitized.slice(0, 127)}\u2026`;
+}
+function isNonblankString(value) {
+  return typeof value === "string" && value.trim().length > 0;
+}
+function isCompletionFinishReason(value) {
+  return value === "stop" || value === "length" || value === "content-filter" || value === "tool-calls" || value === "other";
+}
+function assertUsage(usage) {
+  for (const value of [
+    usage.inputTokens,
+    usage.outputTokens,
+    usage.totalTokens,
+    usage.cachedInputTokens,
+    usage.cacheCreationInputTokens
+  ]) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+      throw new TypeError("CompletionProviderOutputError usage must contain finite token counts.");
+    }
+  }
+  if (usage.details !== void 0) {
+    for (const value of Object.values(usage.details)) {
+      if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+        throw new TypeError(
+          "CompletionProviderOutputError usage details must contain finite token counts."
+        );
+      }
+    }
+  }
+}
+function copyUsage(usage) {
+  const copied = {
+    inputTokens: usage.inputTokens,
+    outputTokens: usage.outputTokens,
+    totalTokens: usage.totalTokens,
+    cachedInputTokens: usage.cachedInputTokens,
+    cacheCreationInputTokens: usage.cacheCreationInputTokens
+  };
+  if (usage.details !== void 0) copied.details = { ...usage.details };
+  return copied;
+}
+
+export {
+  COMPLETION_PROVIDER_OUTPUT_ERROR_CODE,
+  CompletionProviderOutputError,
+  assertCompletionResponseIntegrity
+};
+//# sourceMappingURL=chunk-XQV3XNVT.js.map

package/dist/chunk-XQV3XNVT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/completion/provider-output-error.ts"],"sourcesContent":["import { isJsonValue } from \"./json\";\nimport type { CompletionFinishReason, CompletionResponse, ToolCallPart, Usage } from \"./types\";\n\nexport const COMPLETION_PROVIDER_OUTPUT_ERROR_CODE = \"ANVIA_COMPLETION_PROVIDER_OUTPUT\" as const;\n\nexport type CompletionProviderOutputErrorKind =\n  | \"malformed-tool-arguments\"\n  | \"invalid-tool-arguments\"\n  | \"invalid-stream-event\"\n  | \"invalid-response\"\n  | \"incomplete-stream\"\n  | \"incomplete-tool-call\"\n  | \"invalid-tool-call\"\n  | \"truncated-tool-call\"\n  | \"filtered-tool-call\";\n\ntype CompletionProviderOutputErrorBaseOptions = Readonly<{\n  toolCallId?: string | undefined;\n  usage?: Usage | undefined;\n}>;\n\nexport type CompletionProviderOutputErrorOptions =\n  | Readonly<\n      CompletionProviderOutputErrorBaseOptions & {\n        kind: \"truncated-tool-call\";\n        finishReason: \"length\";\n      }\n    >\n  | Readonly<\n      CompletionProviderOutputErrorBaseOptions & {\n        kind: \"filtered-tool-call\";\n        finishReason: \"content-filter\";\n      }\n    >\n  | Readonly<\n      CompletionProviderOutputErrorBaseOptions & {\n        kind: Exclude<\n          CompletionProviderOutputErrorKind,\n          \"truncated-tool-call\" | \"filtered-tool-call\"\n        >;\n        finishReason?: Exclude<CompletionFinishReason, \"length\" | \"content-filter\"> | undefined;\n      }\n    >;\n\nconst PROVIDER_OUTPUT_ERROR_KINDS = new Set<CompletionProviderOutputErrorKind>([\n  \"malformed-tool-arguments\",\n  \"invalid-tool-arguments\",\n  \"invalid-stream-event\",\n  \"invalid-response\",\n  \"incomplete-stream\",\n  \"incomplete-tool-call\",\n  \"invalid-tool-call\",\n  \"truncated-tool-call\",\n  \"filtered-tool-call\",\n]);\n\n/**\n * A provider returned incomplete output or a tool call that cannot be consumed safely.\n *\n * The error intentionally excludes raw model arguments. Provider output can contain\n * credentials or other sensitive values and must not become log metadata by default.\n */\nexport class CompletionProviderOutputError extends Error {\n  readonly code = COMPLETION_PROVIDER_OUTPUT_ERROR_CODE;\n  readonly kind: CompletionProviderOutputErrorKind;\n  readonly toolCallId: string | undefined;\n  readonly finishReason: CompletionFinishReason | undefined;\n  readonly usage: Usage | undefined;\n\n  constructor(options: CompletionProviderOutputErrorOptions) {\n    assertProviderOutputErrorOptions(options);\n    super(providerOutputErrorMessage(options.kind, options.toolCallId));\n    this.name = \"CompletionProviderOutputError\";\n    this.kind = options.kind;\n    this.toolCallId = options.toolCallId;\n    this.finishReason = options.finishReason;\n    this.usage = options.usage === undefined ? undefined : copyUsage(options.usage);\n  }\n}\n\nexport function assertCompletionResponseIntegrity(\n  options: Readonly<{ response: CompletionResponse }>,\n): void {\n  const { response } = options;\n  const toolCalls = response.choice.filter(\n    (content): content is ToolCallPart => content.type === \"tool-call\",\n  );\n\n  if (toolCalls.length > 0) {\n    if (response.finishReason !== undefined && !isCompletionFinishReason(response.finishReason)) {\n      throw new CompletionProviderOutputError({\n        kind: \"invalid-tool-call\",\n        usage: response.usage,\n      });\n    }\n    if (response.finishReason === \"length\") {\n      throw new CompletionProviderOutputError({\n        kind: \"truncated-tool-call\",\n        finishReason: response.finishReason,\n        usage: response.usage,\n      });\n    }\n    if (response.finishReason === \"content-filter\") {\n      throw new CompletionProviderOutputError({\n        kind: \"filtered-tool-call\",\n        finishReason: response.finishReason,\n        usage: response.usage,\n      });\n    }\n    if (response.finishReason === \"other\") {\n      throw new CompletionProviderOutputError({\n        kind: \"invalid-tool-call\",\n        finishReason: response.finishReason,\n        usage: response.usage,\n      });\n    }\n  } else if (response.finishReason === \"tool-calls\") {\n    throw new CompletionProviderOutputError({\n      kind: \"invalid-tool-call\",\n      finishReason: response.finishReason,\n      usage: response.usage,\n    });\n  }\n\n  const toolCallIds = new Set<string>();\n  const callIds = new Set<string>();\n  for (const toolCall of toolCalls) {\n    if (!isNonblankString(toolCall.toolCallId) || !isNonblankString(toolCall.toolName)) {\n      throw invalidToolCall(toolCall.toolCallId, response.usage);\n    }\n    if (toolCall.callId !== undefined && !isNonblankString(toolCall.callId)) {\n      throw invalidToolCall(toolCall.toolCallId, response.usage);\n    }\n    if (toolCallIds.has(toolCall.toolCallId)) {\n      throw invalidToolCall(toolCall.toolCallId, response.usage);\n    }\n    toolCallIds.add(toolCall.toolCallId);\n    if (toolCall.callId !== undefined) {\n      if (callIds.has(toolCall.callId)) {\n        throw invalidToolCall(toolCall.toolCallId, response.usage);\n      }\n      callIds.add(toolCall.callId);\n    }\n    if (!isJsonValue(toolCall.input)) {\n      throw new CompletionProviderOutputError({\n        kind: \"invalid-tool-arguments\",\n        toolCallId: toolCall.toolCallId,\n        usage: response.usage,\n      });\n    }\n  }\n}\n\nfunction invalidToolCall(toolCallId: unknown, usage: Usage): CompletionProviderOutputError {\n  return new CompletionProviderOutputError({\n    kind: \"invalid-tool-call\",\n    toolCallId: isNonblankString(toolCallId) ? toolCallId : undefined,\n    usage,\n  });\n}\n\nfunction assertProviderOutputErrorOptions(options: CompletionProviderOutputErrorOptions): void {\n  if (typeof options !== \"object\" || options === null) {\n    throw new TypeError(\"CompletionProviderOutputError options must be an object.\");\n  }\n  if (!PROVIDER_OUTPUT_ERROR_KINDS.has(options.kind)) {\n    throw new TypeError(\"CompletionProviderOutputError kind is invalid.\");\n  }\n  if (options.toolCallId !== undefined && !isNonblankString(options.toolCallId)) {\n    throw new TypeError(\"CompletionProviderOutputError toolCallId must be a non-empty string.\");\n  }\n  if (options.finishReason !== undefined && !isCompletionFinishReason(options.finishReason)) {\n    throw new TypeError(\"CompletionProviderOutputError finishReason is invalid.\");\n  }\n  if (options.kind === \"truncated-tool-call\" && options.finishReason !== \"length\") {\n    throw new TypeError('CompletionProviderOutputError truncated-tool-call requires \"length\".');\n  }\n  if (options.kind === \"filtered-tool-call\" && options.finishReason !== \"content-filter\") {\n    throw new TypeError(\n      'CompletionProviderOutputError filtered-tool-call requires \"content-filter\".',\n    );\n  }\n  if (options.finishReason === \"length\" && options.kind !== \"truncated-tool-call\") {\n    throw new TypeError(\n      'CompletionProviderOutputError finishReason \"length\" requires truncated-tool-call.',\n    );\n  }\n  if (options.finishReason === \"content-filter\" && options.kind !== \"filtered-tool-call\") {\n    throw new TypeError(\n      'CompletionProviderOutputError finishReason \"content-filter\" requires filtered-tool-call.',\n    );\n  }\n  if (options.usage !== undefined) {\n    assertUsage(options.usage);\n  }\n}\n\nfunction providerOutputErrorMessage(\n  kind: CompletionProviderOutputErrorKind,\n  toolCallId: string | undefined,\n): string {\n  const toolCall =\n    toolCallId === undefined ? \"tool call\" : `tool call ${JSON.stringify(displayId(toolCallId))}`;\n  if (kind === \"malformed-tool-arguments\") {\n    return `Completion provider returned ${toolCall} with malformed JSON arguments.`;\n  }\n  if (kind === \"invalid-tool-arguments\") {\n    return `Completion provider returned ${toolCall} with arguments that are not a JSON value.`;\n  }\n  if (kind === \"invalid-stream-event\") {\n    return \"Completion provider returned an invalid stream event.\";\n  }\n  if (kind === \"invalid-response\") {\n    return \"Completion provider returned a response that cannot be consumed safely.\";\n  }\n  if (kind === \"incomplete-tool-call\") {\n    return \"Completion provider stream ended before its tool call was complete.\";\n  }\n  if (kind === \"incomplete-stream\") {\n    return \"Completion provider stream ended without a terminal response.\";\n  }\n  if (kind === \"truncated-tool-call\") {\n    return \"Completion provider stopped at its output limit before a tool call could be consumed safely.\";\n  }\n  if (kind === \"filtered-tool-call\") {\n    return \"Completion provider content filtering prevented a tool call from being consumed safely.\";\n  }\n  return `Completion provider returned an invalid ${toolCall}.`;\n}\n\nfunction displayId(value: string): string {\n  let sanitized = \"\";\n  for (const character of value) {\n    const code = character.charCodeAt(0);\n    sanitized += code <= 31 || code === 127 ? \"�\" : character;\n  }\n  return sanitized.length <= 128 ? sanitized : `${sanitized.slice(0, 127)}…`;\n}\n\nfunction isNonblankString(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim().length > 0;\n}\n\nfunction isCompletionFinishReason(value: unknown): value is CompletionFinishReason {\n  return (\n    value === \"stop\" ||\n    value === \"length\" ||\n    value === \"content-filter\" ||\n    value === \"tool-calls\" ||\n    value === \"other\"\n  );\n}\n\nfunction assertUsage(usage: Usage): void {\n  for (const value of [\n    usage.inputTokens,\n    usage.outputTokens,\n    usage.totalTokens,\n    usage.cachedInputTokens,\n    usage.cacheCreationInputTokens,\n  ]) {\n    if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n      throw new TypeError(\"CompletionProviderOutputError usage must contain finite token counts.\");\n    }\n  }\n  if (usage.details !== undefined) {\n    for (const value of Object.values(usage.details)) {\n      if (typeof value !== \"number\" || !Number.isFinite(value) || value < 0) {\n        throw new TypeError(\n          \"CompletionProviderOutputError usage details must contain finite token counts.\",\n        );\n      }\n    }\n  }\n}\n\nfunction copyUsage(usage: Usage): Usage {\n  const copied: Usage = {\n    inputTokens: usage.inputTokens,\n    outputTokens: usage.outputTokens,\n    totalTokens: usage.totalTokens,\n    cachedInputTokens: usage.cachedInputTokens,\n    cacheCreationInputTokens: usage.cacheCreationInputTokens,\n  };\n  if (usage.details !== undefined) copied.details = { ...usage.details };\n  return copied;\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-XV3DH5GC.js

@@ -0,0 +1,58 @@
+import {
+  assertToolApprovalRequirement
+} from "./chunk-YZVFIW5D.js";
+import {
+  attachPreparedToolOwner,
+  preparedToolInput,
+  withoutPreparedToolInput
+} from "./chunk-MHOJJYDK.js";
+import {
+  toProviderJsonSchema
+} from "./chunk-SQAAVYJG.js";
+
+// src/tool/create-tool.ts
+function createTool(options) {
+  const { name, description, inputSchema, outputSchema, execute } = options;
+  const requiresApproval = snapshotApprovalRequirement(options.requiresApproval);
+  if (requiresApproval !== void 0) {
+    assertToolApprovalRequirement(requiresApproval, { allowFunction: true });
+  }
+  const parameters = toProviderJsonSchema(inputSchema);
+  const preparedInputOwner = {};
+  const definition = () => ({
+    name,
+    description,
+    parameters: globalThis.structuredClone(parameters)
+  });
+  const call = async (args, context = {}) => {
+    const prepared = preparedToolInput(context, preparedInputOwner);
+    const parsedArgs = prepared === void 0 ? inputSchema.parse(args) : prepared.input;
+    const executionContext = prepared === void 0 ? context : withoutPreparedToolInput(context);
+    const result = await execute(parsedArgs, executionContext);
+    return outputSchema === void 0 ? result : outputSchema.parse(result);
+  };
+  const parseInput = (args) => inputSchema.parse(args);
+  const tool = {
+    name,
+    definition,
+    call,
+    parseInput
+  };
+  if (requiresApproval !== void 0) {
+    Object.defineProperty(tool, "requiresApproval", {
+      configurable: false,
+      enumerable: true,
+      value: requiresApproval,
+      writable: false
+    });
+  }
+  return attachPreparedToolOwner(tool, preparedInputOwner);
+}
+function snapshotApprovalRequirement(requirement) {
+  return typeof requirement === "object" && requirement !== null ? Object.freeze({ ...requirement }) : requirement;
+}
+
+export {
+  createTool
+};
+//# sourceMappingURL=chunk-XV3DH5GC.js.map

package/dist/chunk-XV3DH5GC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool/create-tool.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport { assertToolApprovalRequirement } from \"../internal/agent-runtime/approval-requirement\";\nimport {\n  attachPreparedToolOwner,\n  preparedToolInput,\n  withoutPreparedToolInput,\n} from \"../internal/agent-runtime/prepared-tool-call\";\nimport { toProviderJsonSchema, type ZodSchema } from \"../schema/zod-schema\";\nimport type { Tool, ToolCallContext, ToolRequiresApproval } from \"./tool\";\n\nexport type CreateToolOptions<\n  InputSchema extends ZodSchema,\n  OutputSchema extends ZodSchema | undefined = undefined,\n  Output = unknown,\n> = {\n  name: string;\n  description: string;\n  inputSchema: InputSchema;\n  outputSchema?: OutputSchema;\n  requiresApproval?: ToolRequiresApproval<z.output<InputSchema>>;\n  execute(\n    args: z.output<InputSchema>,\n    context: ToolCallContext,\n  ): OutputSchema extends ZodSchema\n    ? z.input<OutputSchema> | Promise<z.input<OutputSchema>>\n    : Output | Promise<Output>;\n};\n\ntype CreateToolOutput<\n  OutputSchema extends ZodSchema | undefined,\n  Output,\n> = OutputSchema extends ZodSchema ? z.output<OutputSchema> : Output;\n\nexport function createTool<InputSchema extends ZodSchema, Output = unknown>(\n  options: CreateToolOptions<InputSchema, undefined, Output> & { outputSchema?: undefined },\n): Tool<z.output<InputSchema>, Output>;\n\nexport function createTool<InputSchema extends ZodSchema, OutputSchema extends ZodSchema>(\n  options: CreateToolOptions<InputSchema, OutputSchema>,\n): Tool<z.output<InputSchema>, z.output<OutputSchema>>;\n\nexport function createTool<\n  InputSchema extends ZodSchema,\n  OutputSchema extends ZodSchema | undefined = undefined,\n  Output = unknown,\n>(\n  options: CreateToolOptions<InputSchema, OutputSchema, Output>,\n): Tool<z.output<InputSchema>, CreateToolOutput<OutputSchema, Output>> {\n  const { name, description, inputSchema, outputSchema, execute } = options;\n  const requiresApproval = snapshotApprovalRequirement(options.requiresApproval);\n  if (requiresApproval !== undefined) {\n    assertToolApprovalRequirement(requiresApproval, { allowFunction: true });\n  }\n  const parameters = toProviderJsonSchema(inputSchema);\n  const preparedInputOwner = {};\n  const definition = () => ({\n    name,\n    description,\n    parameters: globalThis.structuredClone(parameters),\n  });\n  const call = async (\n    args: z.output<InputSchema>,\n    context: ToolCallContext = {},\n  ): Promise<CreateToolOutput<OutputSchema, Output>> => {\n    const prepared = preparedToolInput(context, preparedInputOwner);\n    const parsedArgs =\n      prepared === undefined ? inputSchema.parse(args) : (prepared.input as z.output<InputSchema>);\n    const executionContext = prepared === undefined ? context : withoutPreparedToolInput(context);\n    const result = await execute(parsedArgs, executionContext);\n    return (outputSchema === undefined ? result : outputSchema.parse(result)) as CreateToolOutput<\n      OutputSchema,\n      Output\n    >;\n  };\n  const parseInput = (args: unknown): z.output<InputSchema> => inputSchema.parse(args);\n\n  const tool: Tool<z.output<InputSchema>, CreateToolOutput<OutputSchema, Output>> = {\n    name,\n    definition,\n    call,\n    parseInput,\n  };\n  if (requiresApproval !== undefined) {\n    Object.defineProperty(tool, \"requiresApproval\", {\n      configurable: false,\n      enumerable: true,\n      value: requiresApproval,\n      writable: false,\n    });\n  }\n  return attachPreparedToolOwner(tool, preparedInputOwner);\n}\n\nfunction snapshotApprovalRequirement<Args>(\n  requirement: ToolRequiresApproval<Args> | undefined,\n): ToolRequiresApproval<Args> | undefined {\n  return typeof requirement === \"object\" && requirement !== null\n    ? Object.freeze({ ...requirement })\n    : requirement;\n}\n"],"mappings":";;;;;;;;;;;;;AAyCO,SAAS,WAKd,SACqE;AACrE,QAAM,EAAE,MAAM,aAAa,aAAa,cAAc,QAAQ,IAAI;AAClE,QAAM,mBAAmB,4BAA4B,QAAQ,gBAAgB;AAC7E,MAAI,qBAAqB,QAAW;AAClC,kCAA8B,kBAAkB,EAAE,eAAe,KAAK,CAAC;AAAA,EACzE;AACA,QAAM,aAAa,qBAAqB,WAAW;AACnD,QAAM,qBAAqB,CAAC;AAC5B,QAAM,aAAa,OAAO;AAAA,IACxB;AAAA,IACA;AAAA,IACA,YAAY,WAAW,gBAAgB,UAAU;AAAA,EACnD;AACA,QAAM,OAAO,OACX,MACA,UAA2B,CAAC,MACwB;AACpD,UAAM,WAAW,kBAAkB,SAAS,kBAAkB;AAC9D,UAAM,aACJ,aAAa,SAAY,YAAY,MAAM,IAAI,IAAK,SAAS;AAC/D,UAAM,mBAAmB,aAAa,SAAY,UAAU,yBAAyB,OAAO;AAC5F,UAAM,SAAS,MAAM,QAAQ,YAAY,gBAAgB;AACzD,WAAQ,iBAAiB,SAAY,SAAS,aAAa,MAAM,MAAM;AAAA,EAIzE;AACA,QAAM,aAAa,CAAC,SAAyC,YAAY,MAAM,IAAI;AAEnF,QAAM,OAA4E;AAAA,IAChF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,MAAI,qBAAqB,QAAW;AAClC,WAAO,eAAe,MAAM,oBAAoB;AAAA,MAC9C,cAAc;AAAA,MACd,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AACA,SAAO,wBAAwB,MAAM,kBAAkB;AACzD;AAEA,SAAS,4BACP,aACwC;AACxC,SAAO,OAAO,gBAAgB,YAAY,gBAAgB,OACtD,OAAO,OAAO,EAAE,GAAG,YAAY,CAAC,IAChC;AACN;","names":[]}

package/dist/chunk-YWRXOPHC.js

@@ -0,0 +1,43 @@
+// src/internal/agent-runtime/stream-events.ts
+function addTurn(turn, event) {
+  if (event.type === "text_delta") {
+    return { type: "text_delta", turn, delta: event.delta };
+  }
+  if (event.type === "reasoning_delta") {
+    const mapped = { type: "reasoning_delta", turn, delta: event.delta };
+    if (event.id !== void 0) mapped.id = event.id;
+    if (event.contentType !== void 0) mapped.contentType = event.contentType;
+    if (event.signature !== void 0) mapped.signature = event.signature;
+    return mapped;
+  }
+  if (event.type === "source") {
+    return { type: "source", turn, source: event.source };
+  }
+  if (event.type === "provider_tool_call") {
+    return { type: "provider_tool_call", turn, toolCall: event.toolCall };
+  }
+  return { type: "tool_call", turn, toolCall: event.toolCall };
+}
+function addTurnToToolCallDelta(turn, event) {
+  const mapped = {
+    type: "tool_call_delta",
+    turn,
+    id: event.id
+  };
+  if (event.callId !== void 0) mapped.callId = event.callId;
+  if (event.name !== void 0) mapped.name = event.name;
+  if (event.argumentsDelta !== void 0) mapped.argumentsDelta = event.argumentsDelta;
+  if (event.argumentsMode !== void 0) mapped.argumentsMode = event.argumentsMode;
+  if (event.signature !== void 0) mapped.signature = event.signature;
+  return mapped;
+}
+function isGenerationDeltaEvent(type) {
+  return type === "text_delta" || type === "reasoning_delta" || type === "tool_call_delta" || type === "tool_call" || type === "source" || type === "provider_tool_call";
+}
+
+export {
+  addTurn,
+  addTurnToToolCallDelta,
+  isGenerationDeltaEvent
+};
+//# sourceMappingURL=chunk-YWRXOPHC.js.map

package/dist/chunk-YWRXOPHC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/agent-runtime/stream-events.ts"],"sourcesContent":["import type {\n  AgentDeltaEvent,\n  AgentStreamEvent,\n  AgentToolCallDeltaEvent,\n} from \"../../agent/run-types\";\nimport type { CompletionModelStreamEvent } from \"../../completion/types\";\n\nexport function addTurn(turn: number, event: AgentDeltaEvent): AgentStreamEvent {\n  if (event.type === \"text_delta\") {\n    return { type: \"text_delta\", turn, delta: event.delta };\n  }\n  if (event.type === \"reasoning_delta\") {\n    const mapped: AgentStreamEvent = { type: \"reasoning_delta\", turn, delta: event.delta };\n    if (event.id !== undefined) mapped.id = event.id;\n    if (event.contentType !== undefined) mapped.contentType = event.contentType;\n    if (event.signature !== undefined) mapped.signature = event.signature;\n    return mapped;\n  }\n  if (event.type === \"source\") {\n    return { type: \"source\", turn, source: event.source };\n  }\n  if (event.type === \"provider_tool_call\") {\n    return { type: \"provider_tool_call\", turn, toolCall: event.toolCall };\n  }\n  return { type: \"tool_call\", turn, toolCall: event.toolCall };\n}\n\nexport function addTurnToToolCallDelta(\n  turn: number,\n  event: Extract<CompletionModelStreamEvent, { type: \"tool_call_delta\" }>,\n): AgentToolCallDeltaEvent {\n  const mapped: AgentToolCallDeltaEvent = {\n    type: \"tool_call_delta\",\n    turn,\n    id: event.id,\n  };\n  if (event.callId !== undefined) mapped.callId = event.callId;\n  if (event.name !== undefined) mapped.name = event.name;\n  if (event.argumentsDelta !== undefined) mapped.argumentsDelta = event.argumentsDelta;\n  if (event.argumentsMode !== undefined) mapped.argumentsMode = event.argumentsMode;\n  if (event.signature !== undefined) mapped.signature = event.signature;\n  return mapped;\n}\n\nexport function isGenerationDeltaEvent(type: string): boolean {\n  return (\n    type === \"text_delta\" ||\n    type === \"reasoning_delta\" ||\n    type === \"tool_call_delta\" ||\n    type === \"tool_call\" ||\n    type === \"source\" ||\n    type === \"provider_tool_call\"\n  );\n}\n"],"mappings":";AAOO,SAAS,QAAQ,MAAc,OAA0C;AAC9E,MAAI,MAAM,SAAS,cAAc;AAC/B,WAAO,EAAE,MAAM,cAAc,MAAM,OAAO,MAAM,MAAM;AAAA,EACxD;AACA,MAAI,MAAM,SAAS,mBAAmB;AACpC,UAAM,SAA2B,EAAE,MAAM,mBAAmB,MAAM,OAAO,MAAM,MAAM;AACrF,QAAI,MAAM,OAAO,OAAW,QAAO,KAAK,MAAM;AAC9C,QAAI,MAAM,gBAAgB,OAAW,QAAO,cAAc,MAAM;AAChE,QAAI,MAAM,cAAc,OAAW,QAAO,YAAY,MAAM;AAC5D,WAAO;AAAA,EACT;AACA,MAAI,MAAM,SAAS,UAAU;AAC3B,WAAO,EAAE,MAAM,UAAU,MAAM,QAAQ,MAAM,OAAO;AAAA,EACtD;AACA,MAAI,MAAM,SAAS,sBAAsB;AACvC,WAAO,EAAE,MAAM,sBAAsB,MAAM,UAAU,MAAM,SAAS;AAAA,EACtE;AACA,SAAO,EAAE,MAAM,aAAa,MAAM,UAAU,MAAM,SAAS;AAC7D;AAEO,SAAS,uBACd,MACA,OACyB;AACzB,QAAM,SAAkC;AAAA,IACtC,MAAM;AAAA,IACN;AAAA,IACA,IAAI,MAAM;AAAA,EACZ;AACA,MAAI,MAAM,WAAW,OAAW,QAAO,SAAS,MAAM;AACtD,MAAI,MAAM,SAAS,OAAW,QAAO,OAAO,MAAM;AAClD,MAAI,MAAM,mBAAmB,OAAW,QAAO,iBAAiB,MAAM;AACtE,MAAI,MAAM,kBAAkB,OAAW,QAAO,gBAAgB,MAAM;AACpE,MAAI,MAAM,cAAc,OAAW,QAAO,YAAY,MAAM;AAC5D,SAAO;AACT;AAEO,SAAS,uBAAuB,MAAuB;AAC5D,SACE,SAAS,gBACT,SAAS,qBACT,SAAS,qBACT,SAAS,eACT,SAAS,YACT,SAAS;AAEb;","names":[]}

package/dist/chunk-YZVFIW5D.js

@@ -0,0 +1,27 @@
+// src/internal/agent-runtime/approval-requirement.ts
+function toolMayRequireApproval(requirement) {
+  return requirement !== void 0 && requirement !== false;
+}
+function assertToolApprovalRequirement(requirement, options) {
+  if (typeof requirement === "boolean") {
+    return;
+  }
+  if (options.allowFunction && typeof requirement === "function") {
+    return;
+  }
+  if (typeof requirement !== "object" || requirement === null || Array.isArray(requirement)) {
+    throw new TypeError(
+      'Tool "requiresApproval" must be a boolean, a function, or an object with an optional string reason.'
+    );
+  }
+  const reason = requirement.reason;
+  if (reason !== void 0 && typeof reason !== "string") {
+    throw new TypeError('Tool "requiresApproval.reason" must be a string.');
+  }
+}
+
+export {
+  toolMayRequireApproval,
+  assertToolApprovalRequirement
+};
+//# sourceMappingURL=chunk-YZVFIW5D.js.map

package/dist/chunk-YZVFIW5D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/agent-runtime/approval-requirement.ts"],"sourcesContent":["import type { ToolApprovalRequirement } from \"../../tool/tool\";\n\nexport function toolMayRequireApproval(requirement: unknown): boolean {\n  return requirement !== undefined && requirement !== false;\n}\n\nexport function assertToolApprovalRequirement(\n  requirement: unknown,\n  options: { allowFunction: boolean },\n): asserts requirement is boolean | ToolApprovalRequirement | ((...args: never[]) => unknown) {\n  if (typeof requirement === \"boolean\") {\n    return;\n  }\n  if (options.allowFunction && typeof requirement === \"function\") {\n    return;\n  }\n  if (typeof requirement !== \"object\" || requirement === null || Array.isArray(requirement)) {\n    throw new TypeError(\n      'Tool \"requiresApproval\" must be a boolean, a function, or an object with an optional string reason.',\n    );\n  }\n  const reason = (requirement as { reason?: unknown }).reason;\n  if (reason !== undefined && typeof reason !== \"string\") {\n    throw new TypeError('Tool \"requiresApproval.reason\" must be a string.');\n  }\n}\n"],"mappings":";AAEO,SAAS,uBAAuB,aAA+B;AACpE,SAAO,gBAAgB,UAAa,gBAAgB;AACtD;AAEO,SAAS,8BACd,aACA,SAC4F;AAC5F,MAAI,OAAO,gBAAgB,WAAW;AACpC;AAAA,EACF;AACA,MAAI,QAAQ,iBAAiB,OAAO,gBAAgB,YAAY;AAC9D;AAAA,EACF;AACA,MAAI,OAAO,gBAAgB,YAAY,gBAAgB,QAAQ,MAAM,QAAQ,WAAW,GAAG;AACzF,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,QAAM,SAAU,YAAqC;AACrD,MAAI,WAAW,UAAa,OAAO,WAAW,UAAU;AACtD,UAAM,IAAI,UAAU,kDAAkD;AAAA,EACxE;AACF;","names":[]}

package/dist/chunk-ZHC5CD6J.js

@@ -0,0 +1,33 @@
+import {
+  assertFiniteMinScore,
+  assertPositiveSearchLimit
+} from "./chunk-5V533R7F.js";
+
+// src/agent/vector-context.ts
+function createVectorContext(options) {
+  const topK = assertPositiveSearchLimit(options.topK);
+  const minScore = assertFiniteMinScore(options.minScore);
+  let context = {
+    ...options,
+    topK,
+    kind: "vector-context"
+  };
+  if (minScore !== void 0) {
+    context = { ...context, minScore };
+  }
+  return Object.freeze(context);
+}
+function isVectorContext(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const candidate = value;
+  if (candidate.kind !== "vector-context" || typeof candidate.store?.search !== "function") {
+    return false;
+  }
+  return candidate.model !== void 0 || candidate.models?.dense !== void 0 && candidate.models.sparse !== void 0;
+}
+
+export {
+  createVectorContext,
+  isVectorContext
+};
+//# sourceMappingURL=chunk-ZHC5CD6J.js.map

package/dist/chunk-ZHC5CD6J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/vector-context.ts"],"sourcesContent":["import type { Document } from \"../completion\";\nimport type { EmbeddingModel, SparseEmbeddingModel } from \"../embeddings\";\nimport { assertFiniteMinScore, assertPositiveSearchLimit } from \"../internal/vector-search-options\";\nimport type { RetrySetting } from \"../retry\";\nimport type {\n  HybridVectorStore,\n  VectorFilter,\n  VectorFusion,\n  VectorSearchResult,\n  VectorStore,\n} from \"../vector-store\";\n\nexport type VectorContextBaseOptions<T = unknown> = {\n  topK: number;\n  minScore?: number | undefined;\n  filter?: VectorFilter | undefined;\n  retries?: RetrySetting | undefined;\n  format?(result: VectorSearchResult<T>): Document;\n};\n\nexport type CreateVectorContextOptions<T = unknown> = VectorContextBaseOptions<T> & {\n  store: VectorStore<T>;\n  model: EmbeddingModel;\n  models?: never;\n};\n\nexport type CreateHybridVectorContextOptions<T = unknown> = VectorContextBaseOptions<T> & {\n  store: HybridVectorStore<T>;\n  model?: never;\n  models: { dense: EmbeddingModel; sparse: SparseEmbeddingModel };\n  fusion?: VectorFusion | undefined;\n};\n\nexport type VectorContext<T = unknown> = (\n  | CreateVectorContextOptions<T>\n  | CreateHybridVectorContextOptions<T>\n) & {\n  readonly kind: \"vector-context\";\n};\n\nexport function createVectorContext<T>(options: CreateVectorContextOptions<T>): VectorContext<T>;\nexport function createVectorContext<T>(\n  options: CreateHybridVectorContextOptions<T>,\n): VectorContext<T>;\nexport function createVectorContext<T>(\n  options: CreateVectorContextOptions<T> | CreateHybridVectorContextOptions<T>,\n): VectorContext<T> {\n  const topK = assertPositiveSearchLimit(options.topK);\n  const minScore = assertFiniteMinScore(options.minScore);\n  let context: VectorContext<T> = {\n    ...options,\n    topK,\n    kind: \"vector-context\" as const,\n  };\n  if (minScore !== undefined) {\n    context = { ...context, minScore };\n  }\n  return Object.freeze(context);\n}\n\nexport function isVectorContext(value: unknown): value is VectorContext {\n  if (typeof value !== \"object\" || value === null) return false;\n  const candidate = value as {\n    kind?: unknown;\n    store?: { search?: unknown };\n    model?: unknown;\n    models?: { dense?: unknown; sparse?: unknown };\n  };\n  if (candidate.kind !== \"vector-context\" || typeof candidate.store?.search !== \"function\") {\n    return false;\n  }\n  return (\n    candidate.model !== undefined ||\n    (candidate.models?.dense !== undefined && candidate.models.sparse !== undefined)\n  );\n}\n"],"mappings":";;;;;;AA4CO,SAAS,oBACd,SACkB;AAClB,QAAM,OAAO,0BAA0B,QAAQ,IAAI;AACnD,QAAM,WAAW,qBAAqB,QAAQ,QAAQ;AACtD,MAAI,UAA4B;AAAA,IAC9B,GAAG;AAAA,IACH;AAAA,IACA,MAAM;AAAA,EACR;AACA,MAAI,aAAa,QAAW;AAC1B,cAAU,EAAE,GAAG,SAAS,SAAS;AAAA,EACnC;AACA,SAAO,OAAO,OAAO,OAAO;AAC9B;AAEO,SAAS,gBAAgB,OAAwC;AACtE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,YAAY;AAMlB,MAAI,UAAU,SAAS,oBAAoB,OAAO,UAAU,OAAO,WAAW,YAAY;AACxF,WAAO;AAAA,EACT;AACA,SACE,UAAU,UAAU,UACnB,UAAU,QAAQ,UAAU,UAAa,UAAU,OAAO,WAAW;AAE1E;","names":[]}

package/dist/chunk-ZPJFXRQZ.js

@@ -0,0 +1,23 @@
+// src/memory/assert.ts
+function assertPositiveInteger(value, name) {
+  if (!Number.isSafeInteger(value) || value < 1) {
+    throw new RangeError(`${name} must be a positive integer.`);
+  }
+}
+function assertNonnegativeInteger(value, name) {
+  if (!Number.isSafeInteger(value) || value < 0) {
+    throw new RangeError(`${name} must be a nonnegative integer.`);
+  }
+}
+function assertFiniteNumber(value, name) {
+  if (!Number.isFinite(value)) {
+    throw new RangeError(`${name} must be finite.`);
+  }
+}
+
+export {
+  assertPositiveInteger,
+  assertNonnegativeInteger,
+  assertFiniteNumber
+};
+//# sourceMappingURL=chunk-ZPJFXRQZ.js.map

package/dist/chunk-ZPJFXRQZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/memory/assert.ts"],"sourcesContent":["export function assertPositiveInteger(value: number, name: string): void {\n  if (!Number.isSafeInteger(value) || value < 1) {\n    throw new RangeError(`${name} must be a positive integer.`);\n  }\n}\n\nexport function assertNonnegativeInteger(value: number, name: string): void {\n  if (!Number.isSafeInteger(value) || value < 0) {\n    throw new RangeError(`${name} must be a nonnegative integer.`);\n  }\n}\n\nexport function assertFiniteNumber(value: number, name: string): void {\n  if (!Number.isFinite(value)) {\n    throw new RangeError(`${name} must be finite.`);\n  }\n}\n"],"mappings":";AAAO,SAAS,sBAAsB,OAAe,MAAoB;AACvE,MAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,GAAG;AAC7C,UAAM,IAAI,WAAW,GAAG,IAAI,8BAA8B;AAAA,EAC5D;AACF;AAEO,SAAS,yBAAyB,OAAe,MAAoB;AAC1E,MAAI,CAAC,OAAO,cAAc,KAAK,KAAK,QAAQ,GAAG;AAC7C,UAAM,IAAI,WAAW,GAAG,IAAI,iCAAiC;AAAA,EAC/D;AACF;AAEO,SAAS,mBAAmB,OAAe,MAAoB;AACpE,MAAI,CAAC,OAAO,SAAS,KAAK,GAAG;AAC3B,UAAM,IAAI,WAAW,GAAG,IAAI,kBAAkB;AAAA,EAChD;AACF;","names":[]}

package/dist/chunk-ZPXOBQDS.js

@@ -0,0 +1,57 @@
+import {
+  defaultOutputValue,
+  formatValue
+} from "./chunk-ZYXMWEL4.js";
+
+// src/evals/selectors.ts
+function selectPromptOutput(args) {
+  if (typeof args.output !== "object" || args.output === null || !("output" in args.output) || typeof args.output.output !== "string") {
+    throw new TypeError("selectPromptOutput requires an output object with a string output field.");
+  }
+  return args.output.output;
+}
+function selectEvalCaseIds(result, outcomes = ["fail", "invalid"]) {
+  const selected = new Set(outcomes);
+  return result.results.filter((caseResult) => selected.has(caseResult.outcome)).map((caseResult) => caseResult.case.id);
+}
+async function resolveActual(selector, args) {
+  return selector === void 0 ? defaultOutputValue(args.output) : selector(args);
+}
+async function resolveActualText(selector, args) {
+  const value = selector === void 0 ? defaultOutputValue(args.output) : await selector(args);
+  if (typeof value === "string") return value;
+  try {
+    const serialized = JSON.stringify(value);
+    if (serialized !== void 0) return serialized;
+  } catch {
+  }
+  throw new TypeError("Text metric actual value must be a string or JSON-serializable value.");
+}
+async function resolveExpected(selectorOrValue, args) {
+  if (selectorOrValue === void 0) {
+    return args.case.expected;
+  }
+  return typeof selectorOrValue === "function" ? selectorOrValue(args) : selectorOrValue;
+}
+async function resolveJudgePrompt(selector, args) {
+  if (selector !== void 0) {
+    return selector(args);
+  }
+  return [
+    `Suite: ${args.suiteName}`,
+    `Case: ${args.case.id}`,
+    `Input: ${formatValue(args.case.input)}`,
+    `Expected: ${formatValue(args.case.expected)}`,
+    `Output: ${formatValue(defaultOutputValue(args.output))}`
+  ].join("\n\n");
+}
+
+export {
+  selectPromptOutput,
+  selectEvalCaseIds,
+  resolveActual,
+  resolveActualText,
+  resolveExpected,
+  resolveJudgePrompt
+};
+//# sourceMappingURL=chunk-ZPXOBQDS.js.map

package/dist/chunk-ZPXOBQDS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/evals/selectors.ts"],"sourcesContent":["import { defaultOutputValue, formatValue } from \"./format\";\nimport type {\n  EvalMetricArgs,\n  EvalOutcomeStatus,\n  EvalSuiteResult,\n  SelectorOrValue,\n  ValueSelector,\n} from \"./types\";\n\nexport function selectPromptOutput(args: EvalMetricArgs<unknown, unknown, unknown>): string {\n  if (\n    typeof args.output !== \"object\" ||\n    args.output === null ||\n    !(\"output\" in args.output) ||\n    typeof args.output.output !== \"string\"\n  ) {\n    throw new TypeError(\"selectPromptOutput requires an output object with a string output field.\");\n  }\n  return args.output.output;\n}\n\nexport function selectEvalCaseIds(\n  result: EvalSuiteResult<unknown, unknown, unknown>,\n  outcomes: readonly EvalOutcomeStatus[] = [\"fail\", \"invalid\"],\n): string[] {\n  const selected = new Set(outcomes);\n  return result.results\n    .filter((caseResult) => selected.has(caseResult.outcome))\n    .map((caseResult) => caseResult.case.id);\n}\n\nexport async function resolveActual<Input, Output, Expected>(\n  selector: ValueSelector<Input, Output, Expected, unknown> | undefined,\n  args: EvalMetricArgs<Input, Output, Expected>,\n): Promise<unknown> {\n  return selector === undefined ? defaultOutputValue(args.output) : selector(args);\n}\n\nexport async function resolveActualText<Input, Output, Expected>(\n  selector: ValueSelector<Input, Output, Expected, string> | undefined,\n  args: EvalMetricArgs<Input, Output, Expected>,\n): Promise<string> {\n  const value = selector === undefined ? defaultOutputValue(args.output) : await selector(args);\n  if (typeof value === \"string\") return value;\n  try {\n    const serialized = JSON.stringify(value);\n    if (serialized !== undefined) return serialized;\n  } catch {\n    // The caller receives one consistent boundary error below.\n  }\n  throw new TypeError(\"Text metric actual value must be a string or JSON-serializable value.\");\n}\n\nexport async function resolveExpected<Input, Output, Expected, Value>(\n  selectorOrValue: SelectorOrValue<Input, Output, Expected, Value> | undefined,\n  args: EvalMetricArgs<Input, Output, Expected>,\n): Promise<Value | Expected | undefined> {\n  if (selectorOrValue === undefined) {\n    return args.case.expected;\n  }\n  return typeof selectorOrValue === \"function\"\n    ? (selectorOrValue as ValueSelector<Input, Output, Expected, Value>)(args)\n    : selectorOrValue;\n}\n\nexport async function resolveJudgePrompt<Input, Output, Expected>(\n  selector: ValueSelector<Input, Output, Expected, string> | undefined,\n  args: EvalMetricArgs<Input, Output, Expected>,\n): Promise<string> {\n  if (selector !== undefined) {\n    return selector(args);\n  }\n  return [\n    `Suite: ${args.suiteName}`,\n    `Case: ${args.case.id}`,\n    `Input: ${formatValue(args.case.input)}`,\n    `Expected: ${formatValue(args.case.expected)}`,\n    `Output: ${formatValue(defaultOutputValue(args.output))}`,\n  ].join(\"\\n\\n\");\n}\n"],"mappings":";;;;;;AASO,SAAS,mBAAmB,MAAyD;AAC1F,MACE,OAAO,KAAK,WAAW,YACvB,KAAK,WAAW,QAChB,EAAE,YAAY,KAAK,WACnB,OAAO,KAAK,OAAO,WAAW,UAC9B;AACA,UAAM,IAAI,UAAU,0EAA0E;AAAA,EAChG;AACA,SAAO,KAAK,OAAO;AACrB;AAEO,SAAS,kBACd,QACA,WAAyC,CAAC,QAAQ,SAAS,GACjD;AACV,QAAM,WAAW,IAAI,IAAI,QAAQ;AACjC,SAAO,OAAO,QACX,OAAO,CAAC,eAAe,SAAS,IAAI,WAAW,OAAO,CAAC,EACvD,IAAI,CAAC,eAAe,WAAW,KAAK,EAAE;AAC3C;AAEA,eAAsB,cACpB,UACA,MACkB;AAClB,SAAO,aAAa,SAAY,mBAAmB,KAAK,MAAM,IAAI,SAAS,IAAI;AACjF;AAEA,eAAsB,kBACpB,UACA,MACiB;AACjB,QAAM,QAAQ,aAAa,SAAY,mBAAmB,KAAK,MAAM,IAAI,MAAM,SAAS,IAAI;AAC5F,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,MAAI;AACF,UAAM,aAAa,KAAK,UAAU,KAAK;AACvC,QAAI,eAAe,OAAW,QAAO;AAAA,EACvC,QAAQ;AAAA,EAER;AACA,QAAM,IAAI,UAAU,uEAAuE;AAC7F;AAEA,eAAsB,gBACpB,iBACA,MACuC;AACvC,MAAI,oBAAoB,QAAW;AACjC,WAAO,KAAK,KAAK;AAAA,EACnB;AACA,SAAO,OAAO,oBAAoB,aAC7B,gBAAkE,IAAI,IACvE;AACN;AAEA,eAAsB,mBACpB,UACA,MACiB;AACjB,MAAI,aAAa,QAAW;AAC1B,WAAO,SAAS,IAAI;AAAA,EACtB;AACA,SAAO;AAAA,IACL,UAAU,KAAK,SAAS;AAAA,IACxB,SAAS,KAAK,KAAK,EAAE;AAAA,IACrB,UAAU,YAAY,KAAK,KAAK,KAAK,CAAC;AAAA,IACtC,aAAa,YAAY,KAAK,KAAK,QAAQ,CAAC;AAAA,IAC5C,WAAW,YAAY,mBAAmB,KAAK,MAAM,CAAC,CAAC;AAAA,EACzD,EAAE,KAAK,MAAM;AACf;","names":[]}