@anvia/core 1.2.1 → 1.3.0

package/dist/{chunk-HP34GRQX.js → chunk-E44DRLUL.js}

@@ -7,7 +7,7 @@ import {
 } from "./chunk-ZPJFXRQZ.js";
 import {
   generateCompletion
-} from "./chunk-BDKFFFVX.js";
+} from "./chunk-YMTBHHLQ.js";
 
 // src/memory/compaction.ts
 var defaultSummaryInstructions = `Summarize the conversation transcript for use as future agent memory.
@@ -209,4 +209,4 @@ export {
   createMemoryCompactionSummary,
   cumulativeCompactedMessageCount
 };
-//# sourceMappingURL=chunk-HP34GRQX.js.map
+//# sourceMappingURL=chunk-E44DRLUL.js.map

package/dist/{chunk-T4KS577P.js → chunk-FSBDE6RF.js}

@@ -8,17 +8,18 @@ import {
 
 // src/internal/team-runtime/member.ts
 function memberSummary(member) {
-  return {
+  const summary = {
     instanceId: member.instanceId,
     agentId: member.agent.id,
     name: member.name,
     depth: member.depth,
     status: member.status,
-    usage: lifecycleSnapshot(member.usage),
-    ...member.parentInstanceId === void 0 ? {} : { parentInstanceId: member.parentInstanceId },
-    ...member.outcome === void 0 ? {} : { outcome: lifecycleSnapshot(member.outcome) },
-    ...member.error === void 0 ? {} : { error: member.error }
+    usage: lifecycleSnapshot(member.usage)
   };
+  if (member.parentInstanceId !== void 0) summary.parentInstanceId = member.parentInstanceId;
+  if (member.outcome !== void 0) summary.outcome = lifecycleSnapshot(member.outcome);
+  if (member.error !== void 0) summary.error = member.error;
+  return summary;
 }
 function steeringMessages(input) {
   if (typeof input !== "object" || input === null || input.prompt === void 0 === (input.messages === void 0)) {
@@ -55,4 +56,4 @@ export {
   steeringMessages,
   agentMessageInput
 };
-//# sourceMappingURL=chunk-T4KS577P.js.map
+//# sourceMappingURL=chunk-FSBDE6RF.js.map

package/dist/chunk-FSBDE6RF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/internal/team-runtime/member.ts"],"sourcesContent":["import type {\n  AgentTeamMemberStatus,\n  AgentTeamMemberSummary,\n  AgentTeamMessage,\n} from \"../../agent/team/types\";\nimport type { AgentOutcome, AgentSteerInput } from \"../../agent/run-types\";\nimport type { Message, UserMessage } from \"../../completion\";\nimport { parseMessage, parseMessages, Usage } from \"../../completion\";\nimport type { Writable } from \"../type-utils\";\nimport type { AgentRun } from \"../agent-runtime/agent-run\";\nimport type { Agent } from \"../../agent/agent\";\nimport { lifecycleSnapshot } from \"../../agent/lifecycle\";\n\nexport type TeamInput = {\n  id: string;\n  messages: UserMessage[];\n  message?: AgentTeamMessage;\n  submitted: boolean;\n};\n\nexport type TeamMember = {\n  instanceId: string;\n  parentInstanceId?: string;\n  depth: number;\n  definition: Agent<unknown>;\n  name: string;\n  agent: Agent<unknown>;\n  status: AgentTeamMemberStatus;\n  history: Message[];\n  inputs: TeamInput[];\n  receipts: Map<string, TeamInput>;\n  controller: AbortController;\n  release?: (() => void) | undefined;\n  task?: Promise<void> | undefined;\n  activeRun?: AgentRun<unknown> | undefined;\n  runId?: string | undefined;\n  outcome?: Exclude<AgentOutcome<unknown>, { type: \"interaction\" }>;\n  error?: unknown;\n  usage: Usage;\n  notifications: { from: string; type: \"message\" | \"outcome\"; id: string }[];\n};\n\nexport function memberSummary(member: TeamMember): AgentTeamMemberSummary {\n  const summary: Writable<AgentTeamMemberSummary> = {\n    instanceId: member.instanceId,\n    agentId: member.agent.id,\n    name: member.name,\n    depth: member.depth,\n    status: member.status,\n    usage: lifecycleSnapshot(member.usage),\n  };\n  if (member.parentInstanceId !== undefined) summary.parentInstanceId = member.parentInstanceId;\n  if (member.outcome !== undefined) summary.outcome = lifecycleSnapshot(member.outcome);\n  if (member.error !== undefined) summary.error = member.error;\n  return summary;\n}\n\nexport function steeringMessages(input: AgentSteerInput): UserMessage[] {\n  if (\n    typeof input !== \"object\" ||\n    input === null ||\n    (input.prompt === undefined) === (input.messages === undefined)\n  ) {\n    throw new TypeError(\"Agent team steering requires exactly one of prompt or messages.\");\n  }\n  const messages =\n    input.prompt === undefined\n      ? parseMessages(input.messages)\n      : [\n          parseMessage(\n            typeof input.prompt === \"string\"\n              ? { role: \"user\", content: input.prompt }\n              : input.prompt,\n          ),\n        ];\n  if (messages.length === 0 || messages.some((message) => message.role !== \"user\")) {\n    throw new TypeError(\"Agent team steering requires user messages.\");\n  }\n  return messages as UserMessage[];\n}\n\nexport function agentMessageInput(message: AgentTeamMessage): TeamInput {\n  return {\n    id: message.id,\n    submitted: false,\n    message,\n    messages: [\n      {\n        role: \"user\",\n        content: `Message from another agent (not a user approval):\\n${JSON.stringify(message)}`,\n        metadata: { anvia: { agentMessage: { ...message } } },\n      },\n    ],\n  };\n}\n"],"mappings":";;;;;;;;;AA0CO,SAAS,cAAc,QAA4C;AACxE,QAAM,UAA4C;AAAA,IAChD,YAAY,OAAO;AAAA,IACnB,SAAS,OAAO,MAAM;AAAA,IACtB,MAAM,OAAO;AAAA,IACb,OAAO,OAAO;AAAA,IACd,QAAQ,OAAO;AAAA,IACf,OAAO,kBAAkB,OAAO,KAAK;AAAA,EACvC;AACA,MAAI,OAAO,qBAAqB,OAAW,SAAQ,mBAAmB,OAAO;AAC7E,MAAI,OAAO,YAAY,OAAW,SAAQ,UAAU,kBAAkB,OAAO,OAAO;AACpF,MAAI,OAAO,UAAU,OAAW,SAAQ,QAAQ,OAAO;AACvD,SAAO;AACT;AAEO,SAAS,iBAAiB,OAAuC;AACtE,MACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAM,WAAW,YAAgB,MAAM,aAAa,SACrD;AACA,UAAM,IAAI,UAAU,iEAAiE;AAAA,EACvF;AACA,QAAM,WACJ,MAAM,WAAW,SACb,cAAc,MAAM,QAAQ,IAC5B;AAAA,IACE;AAAA,MACE,OAAO,MAAM,WAAW,WACpB,EAAE,MAAM,QAAQ,SAAS,MAAM,OAAO,IACtC,MAAM;AAAA,IACZ;AAAA,EACF;AACN,MAAI,SAAS,WAAW,KAAK,SAAS,KAAK,CAAC,YAAY,QAAQ,SAAS,MAAM,GAAG;AAChF,UAAM,IAAI,UAAU,6CAA6C;AAAA,EACnE;AACA,SAAO;AACT;AAEO,SAAS,kBAAkB,SAAsC;AACtE,SAAO;AAAA,IACL,IAAI,QAAQ;AAAA,IACZ,WAAW;AAAA,IACX;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,MAAM;AAAA,QACN,SAAS;AAAA,EAAsD,KAAK,UAAU,OAAO,CAAC;AAAA,QACtF,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,QAAQ,EAAE,EAAE;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-F3E2RLC7.js → chunk-GE46NHN4.js}

@@ -1,14 +1,14 @@
 import {
   createMemoryCompactionSummary,
   cumulativeCompactedMessageCount
-} from "./chunk-HP34GRQX.js";
+} from "./chunk-E44DRLUL.js";
 import {
   MemoryCompactionConflictError,
   MemoryCompactionError
 } from "./chunk-LQJ4KHMY.js";
 import {
   Usage
-} from "./chunk-IDNL6IH4.js";
+} from "./chunk-HJ6KTQTZ.js";
 import {
   throwIfAborted
 } from "./chunk-USRKPEQN.js";
@@ -339,4 +339,4 @@ function isEmptyUsage(usage) {
 export {
   AgentRunMemory
 };
-//# sourceMappingURL=chunk-F3E2RLC7.js.map
+//# sourceMappingURL=chunk-GE46NHN4.js.map

package/dist/{chunk-CKKNO4XB.js → chunk-GSVOMQEE.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-4ONUNWGC.js";
 import {
   isProviderTool
-} from "./chunk-IDNL6IH4.js";
+} from "./chunk-HJ6KTQTZ.js";
 import {
   parseMessage,
   parseMessages
@@ -67,4 +67,4 @@ function messagesFromInput(input) {
 export {
   createCompletionRequest
 };
-//# sourceMappingURL=chunk-CKKNO4XB.js.map
+//# sourceMappingURL=chunk-GSVOMQEE.js.map

package/dist/{chunk-IDNL6IH4.js → chunk-HJ6KTQTZ.js}

@@ -45,6 +45,7 @@ function resolveModelContextLimits(modelId, catalog, override) {
   return override ?? catalog[modelId];
 }
 var Usage = {
+  /** Returns an all-zero usage value. */
   empty() {
     return {
       inputTokens: 0,
@@ -54,6 +55,10 @@ var Usage = {
       cacheCreationInputTokens: 0
     };
   },
+  /**
+   * Sums two usage values bucket by bucket. `details` are merged only when
+   * both sides carry them; if either side omits them, the result omits them.
+   */
   add(left, right) {
     const result = {
       inputTokens: left.inputTokens + right.inputTokens,
@@ -68,6 +73,7 @@ var Usage = {
     }
     return result;
   },
+  /** Returns true when every bucket, including `details`, is zero. */
   isEmpty(usage) {
     return isEmptyUsage(usage) && (usage.details === void 0 || Object.values(usage.details).every((value) => value === 0));
   }
@@ -291,4 +297,4 @@ export {
   assertCompletionControlsSupported,
   textFromAssistantContent
 };
-//# sourceMappingURL=chunk-IDNL6IH4.js.map
+//# sourceMappingURL=chunk-HJ6KTQTZ.js.map

package/dist/chunk-HJ6KTQTZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/completion/types.ts"],"sourcesContent":["import type { ModelCallOptions } from \"../model-call-options\";\nimport { isJsonValue } from \"./json\";\n\nexport type JsonPrimitive = string | number | boolean | null;\n/** Any JSON-compatible value: primitives, objects, or readonly arrays of JSON values. */\nexport type JsonValue = JsonPrimitive | JsonObject | readonly JsonValue[];\nexport type JsonObject = { [key: string]: JsonValue };\n\n/** A retrievable text document passed to a completion as grounding context. */\nexport type Document = {\n  id: string;\n  text: string;\n  /** String metadata rendered as a `<metadata ... />` header above the text when documents are serialized into prompts. */\n  additionalProps?: Record<string, string>;\n};\n\n/**\n * A text segment, optionally carrying a provider reasoning signature.\n */\nexport type TextPart = Readonly<{\n  type: \"text\";\n  text: string;\n  /** Provider signature preserved so reasoning can be replayed on later turns. */\n  signature?: string;\n}>;\n\n/** Image input fidelity hint forwarded to providers that support it. */\nexport type ImageDetail = \"auto\" | \"low\" | \"high\";\n\n/**\n * File payload for image/file parts: a remote URL, base64 data, or literal text\n * interpreted as a document.\n */\nexport type FileData =\n  | Readonly<{ type: \"url\"; url: string }>\n  | Readonly<{ type: \"data\"; data: string }>\n  | Readonly<{ type: \"text\"; text: string }>;\n\n/** Image input with an optional media type override and detail hint. */\nexport type ImagePart = Readonly<{\n  type: \"image\";\n  image: Exclude<FileData, Readonly<{ type: \"text\"; text: string }>>;\n  mediaType?: string;\n  detail?: ImageDetail;\n}>;\n\n/** Document/file input part; non-text data is rejected by models without `documentInput`. */\nexport type FilePart = Readonly<{\n  type: \"file\";\n  data: FileData;\n  mediaType: string;\n  filename?: string;\n}>;\n\n/** Model reasoning content, replayable across turns to preserve thinking state. */\nexport type ReasoningPart = Readonly<{\n  type: \"reasoning\";\n  text: string;\n  id?: string;\n  details?: readonly ReasoningDetail[];\n}>;\n\n/**\n * Reasoning detail variants:\n *\n * - `text` / `summary`: displayable reasoning text\n * - `encrypted` / `redacted`: opaque payloads that can only be echoed back to\n *   the provider; their content is not readable by the application\n */\nexport type ReasoningDetail =\n  | Readonly<{\n      type: \"text\";\n      text: string;\n      signature?: string;\n    }>\n  | Readonly<{\n      type: \"summary\";\n      text: string;\n    }>\n  | Readonly<{\n      type: \"encrypted\";\n      data: string;\n    }>\n  | Readonly<{\n      type: \"redacted\";\n      data: string;\n    }>;\n\nexport type ReasoningContentType = ReasoningDetail[\"type\"];\n\n/** A tool call requested by the model; `signature` preserves provider replay state. */\nexport type ToolCallPart = Readonly<{\n  type: \"tool-call\";\n  toolCallId: string;\n  callId?: string;\n  toolName: string;\n  input: JsonValue;\n  signature?: string;\n}>;\n\n/** The content variants allowed inside a tool result payload. */\nexport type ToolResultContentPart = TextPart | FilePart;\n\n/**\n * Outcome of one tool execution, as recorded in tool messages:\n *\n * - `text` / `json`: successful result as plain text or JSON\n * - `content`: successful result as mixed content parts\n * - `execution-denied`: the call was blocked (e.g. by a required approval)\n * - `error-text` / `error-json`: failure surfaced to the model so the run can\n *   continue instead of aborting\n */\nexport type ToolResultOutput =\n  | Readonly<{ type: \"text\"; value: string }>\n  | Readonly<{ type: \"json\"; value: JsonValue }>\n  | Readonly<{ type: \"content\"; value: readonly ToolResultContentPart[] }>\n  | Readonly<{ type: \"execution-denied\"; reason?: string }>\n  | Readonly<{ type: \"error-text\"; value: string }>\n  | Readonly<{ type: \"error-json\"; value: JsonValue }>;\n\n/** Tool result reported back to the model, matched to its call via `toolCallId`. */\nexport type ToolResultPart = Readonly<{\n  type: \"tool-result\";\n  toolCallId: string;\n  callId?: string;\n  toolName: string;\n  output: ToolResultOutput;\n}>;\n\n/** Human decision on a tool call that required approval before execution. */\nexport type ToolApprovalResponsePart = Readonly<{\n  type: \"tool-approval-response\";\n  interactionId: string;\n  toolCallId: string;\n  callId?: string;\n  toolName: string;\n  approved: boolean;\n  reason?: string;\n}>;\n\n/** Answer to one question asked by a tool suspended on a human interaction. */\nexport type ToolQuestionAnswer = Readonly<{\n  questionId: string;\n  value: string;\n}>;\n\n/** Answers to tool questions, delivered back through the suspended run. */\nexport type ToolQuestionResponsePart = Readonly<{\n  type: \"tool-question-response\";\n  interactionId: string;\n  toolCallId: string;\n  callId?: string;\n  toolName: string;\n  answers: readonly ToolQuestionAnswer[];\n}>;\n\n/** A tool or human-interaction response delivered inside a `role: \"tool\"` message. */\nexport type ToolInteractionResponsePart = ToolApprovalResponsePart | ToolQuestionResponsePart;\n\n/** Content parts allowed in user messages. */\nexport type UserContentPart = TextPart | ImagePart | FilePart;\n/** Content parts allowed in assistant messages, including replayed reasoning and tool calls. */\nexport type AssistantContentPart = TextPart | ImagePart | FilePart | ReasoningPart | ToolCallPart;\n\nexport type SystemMessage<Metadata extends JsonObject = JsonObject> = Readonly<{\n  role: \"system\";\n  content: string;\n  metadata?: Metadata;\n}>;\n\nexport type UserMessage<Metadata extends JsonObject = JsonObject> = Readonly<{\n  role: \"user\";\n  content: string | readonly UserContentPart[];\n  metadata?: Metadata;\n}>;\n\nexport type AssistantMessage<Metadata extends JsonObject = JsonObject> = Readonly<{\n  role: \"assistant\";\n  id?: string;\n  content: string | readonly AssistantContentPart[];\n  metadata?: Metadata;\n}>;\n\nexport type ToolMessage<Metadata extends JsonObject = JsonObject> = Readonly<{\n  role: \"tool\";\n  content: readonly (ToolResultPart | ToolInteractionResponsePart)[];\n  metadata?: Metadata;\n}>;\n\n/**\n * A conversation message from the system, user, assistant, or tool role.\n *\n * Framework-generated metadata (provider, model, usage of the generation that\n * produced an assistant message) is stored under the `anvia` key of `metadata`;\n * read it back with {@link getAssistantGenerationMetadata}.\n */\nexport type Message<Metadata extends JsonObject = JsonObject> =\n  | SystemMessage<Metadata>\n  | UserMessage<Metadata>\n  | AssistantMessage<Metadata>\n  | ToolMessage<Metadata>;\n\n/** Joins the human-readable text of a reasoning part or its details. */\nexport function reasoningDisplayText(\n  reasoning: ReasoningPart | readonly ReasoningDetail[],\n): string {\n  const details = \"type\" in reasoning ? reasoning.details : reasoning;\n  if (details === undefined) {\n    return \"type\" in reasoning ? reasoning.text : \"\";\n  }\n  return details\n    .flatMap((item) => {\n      if (item.type === \"text\" || item.type === \"summary\") {\n        return [item.text];\n      }\n      return [];\n    })\n    .join(\"\");\n}\n\n/**\n * How the model may call tools: freely, mandatorily, never, or a named function.\n * Requires the model's `toolChoice` capability.\n */\nexport type ToolChoice =\n  | \"auto\"\n  | \"required\"\n  | \"none\"\n  | {\n      type: \"function\";\n      name: string;\n    };\n\n/** JSON Schema-shaped tool description sent to the model (a local tool's public face). */\nexport type ToolDefinition = {\n  name: string;\n  description: string;\n  parameters: JsonObject;\n};\n\n/**\n * A tool executed by the model provider rather than by Anvia's local tool runtime.\n *\n * Provider packages expose typed factories for these values. Application code can\n * pass them through the same high-level `tools` APIs used for local tools.\n */\nexport type ProviderTool = {\n  kind: \"provider\";\n  provider: string;\n  name: string;\n  configuration?: JsonObject;\n};\n\nexport type CompletionTool = ToolDefinition | ProviderTool;\n\n/** Narrows an unknown value to a well-formed {@link ProviderTool}. */\nexport function isProviderTool(value: unknown): value is ProviderTool {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) {\n    return false;\n  }\n  const candidate = value as Partial<ProviderTool>;\n  return (\n    candidate.kind === \"provider\" &&\n    typeof candidate.provider === \"string\" &&\n    candidate.provider.trim().length > 0 &&\n    typeof candidate.name === \"string\" &&\n    candidate.name.trim().length > 0 &&\n    (candidate.configuration === undefined ||\n      (typeof candidate.configuration === \"object\" &&\n        candidate.configuration !== null &&\n        !Array.isArray(candidate.configuration) &&\n        isJsonValue(candidate.configuration)))\n  );\n}\n\n/** A grounding source (e.g. web result) returned by the provider, with optional text offsets. */\nexport type CompletionSource = {\n  type: \"url\";\n  url: string;\n  title?: string;\n  id?: string;\n  startIndex?: number;\n  endIndex?: number;\n};\n\n/** A tool call executed on the provider side, surfaced for observability. */\nexport type ProviderToolCall = {\n  id: string;\n  name: string;\n  status?: string;\n  details?: JsonObject;\n};\n\n/**\n * Provider-normalized, mutually exclusive usage buckets.\n *\n * Every token should appear in exactly one non-total bucket. `total` is the\n * only aggregate key and should equal the sum of the other buckets.\n */\nexport type UsageDetails = Record<string, number>;\n\n/**\n * Token usage for one or more generations.\n *\n * `cachedInputTokens` counts input tokens served from the provider's prompt\n * cache; `cacheCreationInputTokens` counts input tokens billed for writing to\n * that cache. Both are subsets of `inputTokens`.\n */\nexport type Usage = {\n  inputTokens: number;\n  outputTokens: number;\n  totalTokens: number;\n  cachedInputTokens: number;\n  cacheCreationInputTokens: number;\n  details?: UsageDetails;\n};\n\n/** Model context window bounds; unset input/output caps fall back to the window. */\nexport type ModelContextLimits = {\n  contextWindow: number;\n  maxInputTokens?: number;\n  maxOutputTokens?: number;\n};\n\n/** Identifies a model together with its context limits. */\nexport type CompletionModelInfo = {\n  modelId: string;\n  context: ModelContextLimits;\n};\n\n/** Snapshot of how much of a model's context window a request consumed. */\nexport type ContextUsage = {\n  model: CompletionModelInfo;\n  usedTokens: number;\n  remainingTokens: number;\n  usedPercent: number;\n  remainingPercent: number;\n};\n\n/** Computes context usage, or undefined when the model or usage data is unusable. */\nexport function calculateContextUsage(\n  usage: Usage,\n  model: CompletionModelInfo | undefined,\n): ContextUsage | undefined {\n  if (\n    model === undefined ||\n    !Number.isFinite(usage.inputTokens) ||\n    usage.inputTokens <= 0 ||\n    !Number.isFinite(model.context.contextWindow) ||\n    model.context.contextWindow <= 0\n  ) {\n    return undefined;\n  }\n\n  const usedTokens = Math.max(0, usage.inputTokens);\n  const remainingTokens = Math.max(0, model.context.contextWindow - usedTokens);\n  const usedPercent = Math.min(100, (usedTokens / model.context.contextWindow) * 100);\n  return {\n    model,\n    usedTokens,\n    remainingTokens,\n    usedPercent,\n    remainingPercent: 100 - usedPercent,\n  };\n}\n\n/** Attaches context usage to a response when model limits are known. */\nexport function withContextUsage<RawResponse>(\n  response: CompletionResponse<RawResponse>,\n  model: CompletionModelInfo | undefined,\n): CompletionResponse<RawResponse> {\n  const contextUsage = calculateContextUsage(response.usage, model);\n  return contextUsage === undefined ? response : { ...response, contextUsage };\n}\n\n/** Resolves a model's context limits: explicit override wins over catalog lookup. */\nexport function resolveModelContextLimits(\n  modelId: string,\n  catalog: Readonly<Record<string, ModelContextLimits>>,\n  override?: ModelContextLimits,\n): ModelContextLimits | undefined {\n  return override ?? catalog[modelId];\n}\n\n/** Provider/model/usage metadata embedded in assistant message metadata by the runtime. */\nexport type AssistantGenerationMetadata = {\n  provider: string;\n  modelId: string;\n  usage: Usage;\n  finishReason?: CompletionFinishReason;\n  providerFinishReason?: string;\n  contextUsage?: ContextUsage;\n  sources?: CompletionSource[];\n  providerToolCalls?: ProviderToolCall[];\n};\n\n/**\n * Helpers for constructing and combining token usage.\n */\nexport const Usage = {\n  /** Returns an all-zero usage value. */\n  empty(): Usage {\n    return {\n      inputTokens: 0,\n      outputTokens: 0,\n      totalTokens: 0,\n      cachedInputTokens: 0,\n      cacheCreationInputTokens: 0,\n    };\n  },\n  /**\n   * Sums two usage values bucket by bucket. `details` are merged only when\n   * both sides carry them; if either side omits them, the result omits them.\n   */\n  add(left: Usage, right: Usage): Usage {\n    const result: Usage = {\n      inputTokens: left.inputTokens + right.inputTokens,\n      outputTokens: left.outputTokens + right.outputTokens,\n      totalTokens: left.totalTokens + right.totalTokens,\n      cachedInputTokens: left.cachedInputTokens + right.cachedInputTokens,\n      cacheCreationInputTokens: left.cacheCreationInputTokens + right.cacheCreationInputTokens,\n    };\n    const details = addUsageDetails(left, right);\n    if (details !== undefined) {\n      result.details = details;\n    }\n    return result;\n  },\n  /** Returns true when every bucket, including `details`, is zero. */\n  isEmpty(usage: Usage): boolean {\n    return (\n      isEmptyUsage(usage) &&\n      (usage.details === undefined || Object.values(usage.details).every((value) => value === 0))\n    );\n  },\n};\n\nfunction addUsageDetails(left: Usage, right: Usage): UsageDetails | undefined {\n  if (isEmptyUsage(left) && left.details === undefined) {\n    return right.details === undefined ? undefined : { ...right.details };\n  }\n  if (isEmptyUsage(right) && right.details === undefined) {\n    return left.details === undefined ? undefined : { ...left.details };\n  }\n  if (left.details === undefined || right.details === undefined) {\n    return undefined;\n  }\n  const details: UsageDetails = { ...left.details };\n  for (const [key, value] of Object.entries(right.details)) {\n    details[key] = (details[key] ?? 0) + value;\n  }\n  return details;\n}\n\nfunction isEmptyUsage(usage: Usage): boolean {\n  return (\n    usage.inputTokens === 0 &&\n    usage.outputTokens === 0 &&\n    usage.totalTokens === 0 &&\n    usage.cachedInputTokens === 0 &&\n    usage.cacheCreationInputTokens === 0\n  );\n}\n\n/**\n * Reads the generation metadata the runtime embeds in assistant messages, when\n * present and structurally valid.\n */\nexport function getAssistantGenerationMetadata(\n  message: Message,\n): AssistantGenerationMetadata | undefined {\n  if (message.role !== \"assistant\" || !isJsonObjectValue(message.metadata)) {\n    return undefined;\n  }\n  const frameworkMetadata = message.metadata.anvia;\n  if (!isJsonObjectValue(frameworkMetadata)) {\n    return undefined;\n  }\n  const generation = frameworkMetadata.generation;\n  if (\n    !isJsonObjectValue(generation) ||\n    typeof generation.provider !== \"string\" ||\n    typeof generation.modelId !== \"string\" ||\n    !isUsageValue(generation.usage)\n  ) {\n    return undefined;\n  }\n  let usage: Usage = { ...generation.usage };\n  if (generation.usage.details !== undefined) {\n    usage = { ...usage, details: { ...generation.usage.details } };\n  }\n  const metadata: AssistantGenerationMetadata = {\n    provider: generation.provider,\n    modelId: generation.modelId,\n    usage,\n  };\n  if (isCompletionFinishReason(generation.finishReason)) {\n    metadata.finishReason = generation.finishReason;\n  }\n  if (typeof generation.providerFinishReason === \"string\") {\n    metadata.providerFinishReason = generation.providerFinishReason;\n  }\n  if (isContextUsageValue(generation.contextUsage)) {\n    metadata.contextUsage = {\n      ...generation.contextUsage,\n      model: {\n        ...generation.contextUsage.model,\n        context: { ...generation.contextUsage.model.context },\n      },\n    };\n  }\n  if (isCompletionSourceArray(generation.sources)) {\n    metadata.sources = generation.sources.map((source) => ({ ...source }));\n  }\n  if (isProviderToolCallArray(generation.providerToolCalls)) {\n    metadata.providerToolCalls = generation.providerToolCalls.map((toolCall) => {\n      let copy: ProviderToolCall = { ...toolCall };\n      if (toolCall.details !== undefined) {\n        copy = { ...copy, details: { ...toolCall.details } };\n      }\n      return copy;\n    });\n  }\n  return metadata;\n}\n\nfunction isJsonObjectValue(value: JsonValue | undefined): value is JsonObject {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isContextUsageValue(value: JsonValue | undefined): value is JsonObject & ContextUsage {\n  if (!isJsonObjectValue(value) || !isJsonObjectValue(value.model)) {\n    return false;\n  }\n  const context = value.model.context;\n  if (\n    typeof value.model.modelId === \"string\" &&\n    isJsonObjectValue(context) &&\n    isPositiveFiniteNumber(context.contextWindow) &&\n    isOptionalPositiveFiniteNumber(context.maxInputTokens) &&\n    isOptionalPositiveFiniteNumber(context.maxOutputTokens) &&\n    isNonnegativeFiniteNumber(value.usedTokens) &&\n    isNonnegativeFiniteNumber(value.remainingTokens) &&\n    isPercentage(value.usedPercent) &&\n    isPercentage(value.remainingPercent)\n  ) {\n    const contextWindow = context.contextWindow;\n    const remainingTokens = Math.max(0, contextWindow - value.usedTokens);\n    const usedPercent = Math.min(100, (value.usedTokens / contextWindow) * 100);\n    const remainingPercent = (remainingTokens / contextWindow) * 100;\n    return (\n      value.remainingTokens === remainingTokens &&\n      approximatelyEqual(value.usedPercent, usedPercent) &&\n      approximatelyEqual(value.remainingPercent, remainingPercent)\n    );\n  }\n  return false;\n}\n\nfunction approximatelyEqual(left: number, right: number): boolean {\n  const scale = Math.max(1, Math.abs(left), Math.abs(right));\n  return Math.abs(left - right) <= Number.EPSILON * scale * 8;\n}\n\nfunction isPositiveFiniteNumber(value: JsonValue | undefined): value is number {\n  return isNonnegativeFiniteNumber(value) && value > 0;\n}\n\nfunction isOptionalPositiveFiniteNumber(value: JsonValue | undefined): boolean {\n  return value === undefined || isPositiveFiniteNumber(value);\n}\n\nfunction isPercentage(value: JsonValue | undefined): value is number {\n  return isNonnegativeFiniteNumber(value) && value <= 100;\n}\n\nfunction isUsageValue(value: JsonValue | undefined): value is JsonObject & Usage {\n  if (!isJsonObjectValue(value)) {\n    return false;\n  }\n  return (\n    isNonnegativeFiniteNumber(value.inputTokens) &&\n    isNonnegativeFiniteNumber(value.outputTokens) &&\n    isNonnegativeFiniteNumber(value.totalTokens) &&\n    isNonnegativeFiniteNumber(value.cachedInputTokens) &&\n    isNonnegativeFiniteNumber(value.cacheCreationInputTokens) &&\n    isUsageDetailsValue(value.details)\n  );\n}\n\nfunction isNonnegativeFiniteNumber(value: JsonValue | undefined): value is number {\n  return typeof value === \"number\" && Number.isFinite(value) && value >= 0;\n}\n\nfunction isUsageDetailsValue(value: JsonValue | undefined): value is JsonObject | undefined {\n  if (value === undefined) {\n    return true;\n  }\n  if (!isJsonObjectValue(value)) {\n    return false;\n  }\n  let total: number | undefined;\n  let bucketSum = 0;\n  for (const [key, detail] of Object.entries(value)) {\n    if (detail === undefined || !isNonnegativeFiniteNumber(detail)) {\n      return false;\n    }\n    if (key === \"total\") {\n      total = detail;\n    } else {\n      bucketSum += detail;\n    }\n  }\n  return total !== undefined && total === bucketSum;\n}\n\nfunction isCompletionSourceArray(value: JsonValue | undefined): value is CompletionSource[] {\n  return (\n    Array.isArray(value) &&\n    value.every(\n      (source) =>\n        isJsonObjectValue(source) &&\n        source.type === \"url\" &&\n        typeof source.url === \"string\" &&\n        (source.title === undefined || typeof source.title === \"string\") &&\n        (source.id === undefined || typeof source.id === \"string\") &&\n        (source.startIndex === undefined || typeof source.startIndex === \"number\") &&\n        (source.endIndex === undefined || typeof source.endIndex === \"number\"),\n    )\n  );\n}\n\nfunction isProviderToolCallArray(value: JsonValue | undefined): value is ProviderToolCall[] {\n  return (\n    Array.isArray(value) &&\n    value.every(\n      (toolCall) =>\n        isJsonObjectValue(toolCall) &&\n        typeof toolCall.id === \"string\" &&\n        typeof toolCall.name === \"string\" &&\n        (toolCall.status === undefined || typeof toolCall.status === \"string\") &&\n        (toolCall.details === undefined || isJsonObjectValue(toolCall.details)),\n    )\n  );\n}\n\n/** Provider-agnostic completion request assembled by the runtime for adapters. */\nexport type CompletionRequest = {\n  instructions?: string;\n  chatHistory: Message[];\n  documents: Document[];\n  tools: ToolDefinition[];\n  providerTools?: ProviderTool[];\n  temperature?: number;\n  maxTokens?: number;\n  toolChoice?: ToolChoice;\n  /** Values for the model's declared completion controls; validated before sending. */\n  controls?: Readonly<Record<string, string>>;\n  /** Provider-specific passthrough options; never validated by the core runtime. */\n  providerOptions?: JsonObject;\n  /** JSON Schema the output must conform to; requires the `outputSchema` capability. */\n  outputSchema?: JsonObject;\n};\n\n/** Normalized finish reasons:\n *\n * - `stop`: the model finished naturally\n * - `length`: an output token limit was hit\n * - `content-filter`: output was blocked by a safety filter\n * - `tool-calls`: the model stopped to request tool calls\n * - `other`: any provider-specific reason\n */\nexport type CompletionFinishReason = \"stop\" | \"length\" | \"content-filter\" | \"tool-calls\" | \"other\";\n\n/** A provider's raw completion response: normalized parts plus usage and metadata. */\nexport type CompletionResponse<RawResponse = unknown> = {\n  choice: AssistantContentPart[];\n  usage: Usage;\n  finishReason?: CompletionFinishReason;\n  providerFinishReason?: string;\n  contextUsage?: ContextUsage;\n  /** The provider SDK's original response object, unmodified. */\n  rawResponse: RawResponse;\n  messageId?: string;\n  sources?: CompletionSource[];\n  providerToolCalls?: ProviderToolCall[];\n};\n\n/** Final result of a completion: typed output, plain text, full content, and usage. */\nexport type CompletionResult<Output = string, RawResponse = unknown> = {\n  /**\n   * The typed output. When an output schema was requested this is the parsed,\n   * validated object; otherwise it is the plain text.\n   */\n  output: Output;\n  /** The generated text, joined from the response's text parts. */\n  text: string;\n  /** Every content part the model produced, including reasoning and tool calls. */\n  content: readonly AssistantContentPart[];\n  usage: Usage;\n  finishReason?: CompletionFinishReason;\n  providerFinishReason?: string;\n  contextUsage?: ContextUsage;\n  rawResponse: RawResponse;\n  messageId?: string;\n  sources?: readonly CompletionSource[];\n  providerToolCalls?: readonly ProviderToolCall[];\n};\n\nfunction isCompletionFinishReason(value: JsonValue | undefined): 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\n/** Feature flags a model declares; requests are validated against these at runtime. */\nexport type CompletionModelCapabilities = {\n  streaming: boolean;\n  tools: boolean;\n  toolChoice: boolean;\n  imageInput: boolean;\n  documentInput: boolean;\n  outputSchema: boolean;\n  reasoning: boolean;\n  providerTools?: boolean;\n};\n\n/** A selectable model control exposed to applications (e.g. \"reasoning effort\"). */\nexport type CompletionModelSelectControl<Option extends string = string> = Readonly<{\n  type: \"select\";\n  label: string;\n  options: readonly Option[];\n  description?: string | undefined;\n  defaultValue?: Option | undefined;\n}>;\n\n/** Named set of controls a model supports, keyed by control id. */\nexport type CompletionModelControls = Readonly<\n  Record<string, CompletionModelSelectControl<string>>\n>;\n\n/** Marker type for models that accept no completion controls. */\nexport type NoCompletionModelControls = Readonly<Record<string, never>>;\n\n/** The option values a model's controls accept, keyed by control id. */\nexport type CompletionControlValues<Controls extends CompletionModelControls> = Readonly<\n  Partial<{\n    [Key in keyof Controls]: Controls[Key] extends CompletionModelSelectControl<infer Option>\n      ? Option\n      : never;\n  }>\n>;\n\n/** Extracts a model's control types, defaulting to the open controls record. */\nexport type CompletionModelControlsOf<Model> =\n  Model extends CompletionModel<unknown, infer Controls> ? Controls : CompletionModelControls;\n\n/**\n * The provider-agnostic model contract every adapter implements: non-streaming\n * completions plus capability, context, and control metadata.\n */\nexport interface CompletionModel<\n  RawResponse = unknown,\n  Controls extends CompletionModelControls = CompletionModelControls,\n> {\n  readonly provider: string;\n  readonly modelId: string;\n  readonly contextLimits?: ModelContextLimits | undefined;\n  readonly capabilities: CompletionModelCapabilities;\n  readonly controls?: Controls | undefined;\n  /**\n   * Returns a JSON-safe representation of the outgoing request for\n   * observability traces, or undefined to omit the trace payload. Errors\n   * thrown here are swallowed by the runtime and recorded as a trace error.\n   */\n  traceRequest?(\n    request: CompletionRequest,\n    options?: { stream?: boolean | undefined },\n  ): JsonObject | undefined;\n  completion(\n    request: CompletionRequest,\n    options?: ModelCallOptions,\n  ): Promise<CompletionResponse<RawResponse>>;\n}\n\n/** How a `tool_call_delta` updates arguments: append to, or replace, accumulated JSON. */\nexport type ToolCallArgumentsMode = \"append\" | \"replace\";\n\n/**\n * Incremental completion stream content:\n *\n * - `text_delta` / `reasoning_delta`: incremental text or reasoning content\n * - `tool_call_delta`: partial tool call input; argument fragments accumulate\n *   according to `argumentsMode` (`append` continues the JSON string, `replace`\n *   restarts it)\n * - `tool_call`: a complete tool call\n * - `source`: a grounding source discovered during generation\n * - `provider_tool_call`: progress on a provider-executed tool\n * - `message_id`: the id of the message being generated\n */\nexport type CompletionStreamPart =\n  | {\n      type: \"text_delta\";\n      delta: string;\n    }\n  | {\n      type: \"reasoning_delta\";\n      delta: string;\n      id?: string;\n      contentType?: ReasoningContentType;\n      /** Provider signature preserved for reasoning replay. */\n      signature?: string;\n    }\n  | {\n      type: \"tool_call_delta\";\n      id: string;\n      callId?: string;\n      name?: string;\n      argumentsDelta?: string;\n      argumentsMode?: ToolCallArgumentsMode;\n      signature?: string;\n    }\n  | {\n      type: \"tool_call\";\n      toolCall: ToolCallPart;\n    }\n  | {\n      type: \"source\";\n      source: CompletionSource;\n    }\n  | {\n      type: \"provider_tool_call\";\n      toolCall: ProviderToolCall;\n    }\n  | {\n      type: \"message_id\";\n      id: string;\n    };\n\n/** Raw model stream events: stream parts, the final response, or a terminal error. */\nexport type CompletionModelStreamEvent<RawResponse = unknown> =\n  | CompletionStreamPart\n  | {\n      type: \"final\";\n      response: CompletionResponse<RawResponse>;\n    }\n  | {\n      type: \"error\";\n      error: unknown;\n      usage?: Usage;\n    };\n\n/** High-level stream events: stream parts, the final typed result, or a terminal error. */\nexport type CompletionStreamEvent<Output = string, RawResponse = unknown> =\n  | CompletionStreamPart\n  | {\n      type: \"final\";\n      result: CompletionResult<Output, RawResponse>;\n    }\n  | {\n      type: \"error\";\n      error: unknown;\n      usage: Usage;\n    };\n\n/** A completion model that can additionally stream events as they are produced. */\nexport interface StreamingCompletionModel<\n  RawResponse = unknown,\n  Controls extends CompletionModelControls = CompletionModelControls,\n> extends CompletionModel<RawResponse, Controls> {\n  streamCompletion(\n    request: CompletionRequest,\n    options?: ModelCallOptions,\n  ): AsyncIterable<CompletionModelStreamEvent<RawResponse>>;\n}\n\n/** Thrown when a request uses a capability the target model does not declare. */\nexport class CompletionCapabilityError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"CompletionCapabilityError\";\n  }\n}\n\n/** Validates a request against a model's declared capabilities; throws {@link CompletionCapabilityError}. */\nexport function assertCompletionRequestSupported(\n  model: CompletionModel,\n  request: CompletionRequest,\n  options: { streaming?: boolean | undefined } = {},\n): void {\n  const modelLabel = `${model.provider}:${model.modelId}`;\n  const capabilities = model.capabilities;\n\n  assertCompletionControlsSupported(model, request.controls);\n\n  if (options.streaming === true && !capabilities.streaming) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support streaming completions.`);\n  }\n\n  if (request.tools.length > 0 && !capabilities.tools) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support tool definitions.`);\n  }\n\n  if ((request.providerTools?.length ?? 0) > 0 && capabilities.providerTools !== true) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support provider-executed tools.`);\n  }\n\n  if (request.toolChoice !== undefined && !capabilities.toolChoice) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support tool choice.`);\n  }\n\n  if (request.outputSchema !== undefined && !capabilities.outputSchema) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support output schemas.`);\n  }\n\n  if (!capabilities.imageInput && requestHasImageInput(request)) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support image input.`);\n  }\n\n  if (!capabilities.documentInput && requestHasFileDocumentInput(request)) {\n    throw new CompletionCapabilityError(`${modelLabel} does not support document file input.`);\n  }\n}\n\n/** Validates control values against a model's controls; throws {@link CompletionCapabilityError}. */\nexport function assertCompletionControlsSupported(\n  model: CompletionModel,\n  controls: Readonly<Record<string, string | undefined>> | undefined,\n): void {\n  const modelLabel = `${model.provider}:${model.modelId}`;\n  for (const [controlId, value] of Object.entries(controls ?? {})) {\n    if (value === undefined) continue;\n    const modelControls = model.controls;\n    const control =\n      modelControls !== undefined && Object.hasOwn(modelControls, controlId)\n        ? modelControls[controlId]\n        : undefined;\n    if (control === undefined) {\n      throw new CompletionCapabilityError(\n        `${modelLabel} does not support completion control \"${controlId}\".`,\n      );\n    }\n    if (!control.options.includes(value)) {\n      throw new CompletionCapabilityError(\n        `${modelLabel} completion control \"${controlId}\" does not support value \"${value}\".`,\n      );\n    }\n  }\n}\n\n/** Joins the text parts of assistant content with newlines. */\nexport function textFromAssistantContent(content: readonly AssistantContentPart[]): string {\n  return content.flatMap((item) => (item.type === \"text\" ? [item.text] : [])).join(\"\\n\");\n}\n\nfunction requestHasImageInput(request: CompletionRequest): boolean {\n  return request.chatHistory.some((message) =>\n    message.role === \"system\" || typeof message.content === \"string\"\n      ? false\n      : message.content.some((content) => content.type === \"image\"),\n  );\n}\n\nfunction requestHasFileDocumentInput(request: CompletionRequest): boolean {\n  return request.chatHistory.some((message) =>\n    message.role === \"user\" && typeof message.content !== \"string\"\n      ? message.content.some((content) => content.type === \"file\" && content.data.type !== \"text\")\n      : false,\n  );\n}\n"],"mappings":";;;;;AA2MO,SAAS,qBACd,WACQ;AACR,QAAM,UAAU,UAAU,YAAY,UAAU,UAAU;AAC1D,MAAI,YAAY,QAAW;AACzB,WAAO,UAAU,YAAY,UAAU,OAAO;AAAA,EAChD;AACA,SAAO,QACJ,QAAQ,CAAC,SAAS;AACjB,QAAI,KAAK,SAAS,UAAU,KAAK,SAAS,WAAW;AACnD,aAAO,CAAC,KAAK,IAAI;AAAA,IACnB;AACA,WAAO,CAAC;AAAA,EACV,CAAC,EACA,KAAK,EAAE;AACZ;AAsCO,SAAS,eAAe,OAAuC;AACpE,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GAAG;AACvE,WAAO;AAAA,EACT;AACA,QAAM,YAAY;AAClB,SACE,UAAU,SAAS,cACnB,OAAO,UAAU,aAAa,YAC9B,UAAU,SAAS,KAAK,EAAE,SAAS,KACnC,OAAO,UAAU,SAAS,YAC1B,UAAU,KAAK,KAAK,EAAE,SAAS,MAC9B,UAAU,kBAAkB,UAC1B,OAAO,UAAU,kBAAkB,YAClC,UAAU,kBAAkB,QAC5B,CAAC,MAAM,QAAQ,UAAU,aAAa,KACtC,YAAY,UAAU,aAAa;AAE3C;AAmEO,SAAS,sBACd,OACA,OAC0B;AAC1B,MACE,UAAU,UACV,CAAC,OAAO,SAAS,MAAM,WAAW,KAClC,MAAM,eAAe,KACrB,CAAC,OAAO,SAAS,MAAM,QAAQ,aAAa,KAC5C,MAAM,QAAQ,iBAAiB,GAC/B;AACA,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,KAAK,IAAI,GAAG,MAAM,WAAW;AAChD,QAAM,kBAAkB,KAAK,IAAI,GAAG,MAAM,QAAQ,gBAAgB,UAAU;AAC5E,QAAM,cAAc,KAAK,IAAI,KAAM,aAAa,MAAM,QAAQ,gBAAiB,GAAG;AAClF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,kBAAkB,MAAM;AAAA,EAC1B;AACF;AAGO,SAAS,iBACd,UACA,OACiC;AACjC,QAAM,eAAe,sBAAsB,SAAS,OAAO,KAAK;AAChE,SAAO,iBAAiB,SAAY,WAAW,EAAE,GAAG,UAAU,aAAa;AAC7E;AAGO,SAAS,0BACd,SACA,SACA,UACgC;AAChC,SAAO,YAAY,QAAQ,OAAO;AACpC;AAiBO,IAAM,QAAQ;AAAA;AAAA,EAEnB,QAAe;AACb,WAAO;AAAA,MACL,aAAa;AAAA,MACb,cAAc;AAAA,MACd,aAAa;AAAA,MACb,mBAAmB;AAAA,MACnB,0BAA0B;AAAA,IAC5B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,MAAa,OAAqB;AACpC,UAAM,SAAgB;AAAA,MACpB,aAAa,KAAK,cAAc,MAAM;AAAA,MACtC,cAAc,KAAK,eAAe,MAAM;AAAA,MACxC,aAAa,KAAK,cAAc,MAAM;AAAA,MACtC,mBAAmB,KAAK,oBAAoB,MAAM;AAAA,MAClD,0BAA0B,KAAK,2BAA2B,MAAM;AAAA,IAClE;AACA,UAAM,UAAU,gBAAgB,MAAM,KAAK;AAC3C,QAAI,YAAY,QAAW;AACzB,aAAO,UAAU;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AAAA;AAAA,EAEA,QAAQ,OAAuB;AAC7B,WACE,aAAa,KAAK,MACjB,MAAM,YAAY,UAAa,OAAO,OAAO,MAAM,OAAO,EAAE,MAAM,CAAC,UAAU,UAAU,CAAC;AAAA,EAE7F;AACF;AAEA,SAAS,gBAAgB,MAAa,OAAwC;AAC5E,MAAI,aAAa,IAAI,KAAK,KAAK,YAAY,QAAW;AACpD,WAAO,MAAM,YAAY,SAAY,SAAY,EAAE,GAAG,MAAM,QAAQ;AAAA,EACtE;AACA,MAAI,aAAa,KAAK,KAAK,MAAM,YAAY,QAAW;AACtD,WAAO,KAAK,YAAY,SAAY,SAAY,EAAE,GAAG,KAAK,QAAQ;AAAA,EACpE;AACA,MAAI,KAAK,YAAY,UAAa,MAAM,YAAY,QAAW;AAC7D,WAAO;AAAA,EACT;AACA,QAAM,UAAwB,EAAE,GAAG,KAAK,QAAQ;AAChD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,OAAO,GAAG;AACxD,YAAQ,GAAG,KAAK,QAAQ,GAAG,KAAK,KAAK;AAAA,EACvC;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAAuB;AAC3C,SACE,MAAM,gBAAgB,KACtB,MAAM,iBAAiB,KACvB,MAAM,gBAAgB,KACtB,MAAM,sBAAsB,KAC5B,MAAM,6BAA6B;AAEvC;AAMO,SAAS,+BACd,SACyC;AACzC,MAAI,QAAQ,SAAS,eAAe,CAAC,kBAAkB,QAAQ,QAAQ,GAAG;AACxE,WAAO;AAAA,EACT;AACA,QAAM,oBAAoB,QAAQ,SAAS;AAC3C,MAAI,CAAC,kBAAkB,iBAAiB,GAAG;AACzC,WAAO;AAAA,EACT;AACA,QAAM,aAAa,kBAAkB;AACrC,MACE,CAAC,kBAAkB,UAAU,KAC7B,OAAO,WAAW,aAAa,YAC/B,OAAO,WAAW,YAAY,YAC9B,CAAC,aAAa,WAAW,KAAK,GAC9B;AACA,WAAO;AAAA,EACT;AACA,MAAI,QAAe,EAAE,GAAG,WAAW,MAAM;AACzC,MAAI,WAAW,MAAM,YAAY,QAAW;AAC1C,YAAQ,EAAE,GAAG,OAAO,SAAS,EAAE,GAAG,WAAW,MAAM,QAAQ,EAAE;AAAA,EAC/D;AACA,QAAM,WAAwC;AAAA,IAC5C,UAAU,WAAW;AAAA,IACrB,SAAS,WAAW;AAAA,IACpB;AAAA,EACF;AACA,MAAI,yBAAyB,WAAW,YAAY,GAAG;AACrD,aAAS,eAAe,WAAW;AAAA,EACrC;AACA,MAAI,OAAO,WAAW,yBAAyB,UAAU;AACvD,aAAS,uBAAuB,WAAW;AAAA,EAC7C;AACA,MAAI,oBAAoB,WAAW,YAAY,GAAG;AAChD,aAAS,eAAe;AAAA,MACtB,GAAG,WAAW;AAAA,MACd,OAAO;AAAA,QACL,GAAG,WAAW,aAAa;AAAA,QAC3B,SAAS,EAAE,GAAG,WAAW,aAAa,MAAM,QAAQ;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AACA,MAAI,wBAAwB,WAAW,OAAO,GAAG;AAC/C,aAAS,UAAU,WAAW,QAAQ,IAAI,CAAC,YAAY,EAAE,GAAG,OAAO,EAAE;AAAA,EACvE;AACA,MAAI,wBAAwB,WAAW,iBAAiB,GAAG;AACzD,aAAS,oBAAoB,WAAW,kBAAkB,IAAI,CAAC,aAAa;AAC1E,UAAI,OAAyB,EAAE,GAAG,SAAS;AAC3C,UAAI,SAAS,YAAY,QAAW;AAClC,eAAO,EAAE,GAAG,MAAM,SAAS,EAAE,GAAG,SAAS,QAAQ,EAAE;AAAA,MACrD;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,SAAS,kBAAkB,OAAmD;AAC5E,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,oBAAoB,OAAkE;AAC7F,MAAI,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB,MAAM,KAAK,GAAG;AAChE,WAAO;AAAA,EACT;AACA,QAAM,UAAU,MAAM,MAAM;AAC5B,MACE,OAAO,MAAM,MAAM,YAAY,YAC/B,kBAAkB,OAAO,KACzB,uBAAuB,QAAQ,aAAa,KAC5C,+BAA+B,QAAQ,cAAc,KACrD,+BAA+B,QAAQ,eAAe,KACtD,0BAA0B,MAAM,UAAU,KAC1C,0BAA0B,MAAM,eAAe,KAC/C,aAAa,MAAM,WAAW,KAC9B,aAAa,MAAM,gBAAgB,GACnC;AACA,UAAM,gBAAgB,QAAQ;AAC9B,UAAM,kBAAkB,KAAK,IAAI,GAAG,gBAAgB,MAAM,UAAU;AACpE,UAAM,cAAc,KAAK,IAAI,KAAM,MAAM,aAAa,gBAAiB,GAAG;AAC1E,UAAM,mBAAoB,kBAAkB,gBAAiB;AAC7D,WACE,MAAM,oBAAoB,mBAC1B,mBAAmB,MAAM,aAAa,WAAW,KACjD,mBAAmB,MAAM,kBAAkB,gBAAgB;AAAA,EAE/D;AACA,SAAO;AACT;AAEA,SAAS,mBAAmB,MAAc,OAAwB;AAChE,QAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,KAAK,CAAC;AACzD,SAAO,KAAK,IAAI,OAAO,KAAK,KAAK,OAAO,UAAU,QAAQ;AAC5D;AAEA,SAAS,uBAAuB,OAA+C;AAC7E,SAAO,0BAA0B,KAAK,KAAK,QAAQ;AACrD;AAEA,SAAS,+BAA+B,OAAuC;AAC7E,SAAO,UAAU,UAAa,uBAAuB,KAAK;AAC5D;AAEA,SAAS,aAAa,OAA+C;AACnE,SAAO,0BAA0B,KAAK,KAAK,SAAS;AACtD;AAEA,SAAS,aAAa,OAA2D;AAC/E,MAAI,CAAC,kBAAkB,KAAK,GAAG;AAC7B,WAAO;AAAA,EACT;AACA,SACE,0BAA0B,MAAM,WAAW,KAC3C,0BAA0B,MAAM,YAAY,KAC5C,0BAA0B,MAAM,WAAW,KAC3C,0BAA0B,MAAM,iBAAiB,KACjD,0BAA0B,MAAM,wBAAwB,KACxD,oBAAoB,MAAM,OAAO;AAErC;AAEA,SAAS,0BAA0B,OAA+C;AAChF,SAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,SAAS;AACzE;AAEA,SAAS,oBAAoB,OAA+D;AAC1F,MAAI,UAAU,QAAW;AACvB,WAAO;AAAA,EACT;AACA,MAAI,CAAC,kBAAkB,KAAK,GAAG;AAC7B,WAAO;AAAA,EACT;AACA,MAAI;AACJ,MAAI,YAAY;AAChB,aAAW,CAAC,KAAK,MAAM,KAAK,OAAO,QAAQ,KAAK,GAAG;AACjD,QAAI,WAAW,UAAa,CAAC,0BAA0B,MAAM,GAAG;AAC9D,aAAO;AAAA,IACT;AACA,QAAI,QAAQ,SAAS;AACnB,cAAQ;AAAA,IACV,OAAO;AACL,mBAAa;AAAA,IACf;AAAA,EACF;AACA,SAAO,UAAU,UAAa,UAAU;AAC1C;AAEA,SAAS,wBAAwB,OAA2D;AAC1F,SACE,MAAM,QAAQ,KAAK,KACnB,MAAM;AAAA,IACJ,CAAC,WACC,kBAAkB,MAAM,KACxB,OAAO,SAAS,SAChB,OAAO,OAAO,QAAQ,aACrB,OAAO,UAAU,UAAa,OAAO,OAAO,UAAU,cACtD,OAAO,OAAO,UAAa,OAAO,OAAO,OAAO,cAChD,OAAO,eAAe,UAAa,OAAO,OAAO,eAAe,cAChE,OAAO,aAAa,UAAa,OAAO,OAAO,aAAa;AAAA,EACjE;AAEJ;AAEA,SAAS,wBAAwB,OAA2D;AAC1F,SACE,MAAM,QAAQ,KAAK,KACnB,MAAM;AAAA,IACJ,CAAC,aACC,kBAAkB,QAAQ,KAC1B,OAAO,SAAS,OAAO,YACvB,OAAO,SAAS,SAAS,aACxB,SAAS,WAAW,UAAa,OAAO,SAAS,WAAW,cAC5D,SAAS,YAAY,UAAa,kBAAkB,SAAS,OAAO;AAAA,EACzE;AAEJ;AAiEA,SAAS,yBAAyB,OAA+D;AAC/F,SACE,UAAU,UACV,UAAU,YACV,UAAU,oBACV,UAAU,gBACV,UAAU;AAEd;AAoKO,IAAM,4BAAN,cAAwC,MAAM;AAAA,EACnD,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAGO,SAAS,iCACd,OACA,SACA,UAA+C,CAAC,GAC1C;AACN,QAAM,aAAa,GAAG,MAAM,QAAQ,IAAI,MAAM,OAAO;AACrD,QAAM,eAAe,MAAM;AAE3B,oCAAkC,OAAO,QAAQ,QAAQ;AAEzD,MAAI,QAAQ,cAAc,QAAQ,CAAC,aAAa,WAAW;AACzD,UAAM,IAAI,0BAA0B,GAAG,UAAU,0CAA0C;AAAA,EAC7F;AAEA,MAAI,QAAQ,MAAM,SAAS,KAAK,CAAC,aAAa,OAAO;AACnD,UAAM,IAAI,0BAA0B,GAAG,UAAU,qCAAqC;AAAA,EACxF;AAEA,OAAK,QAAQ,eAAe,UAAU,KAAK,KAAK,aAAa,kBAAkB,MAAM;AACnF,UAAM,IAAI,0BAA0B,GAAG,UAAU,4CAA4C;AAAA,EAC/F;AAEA,MAAI,QAAQ,eAAe,UAAa,CAAC,aAAa,YAAY;AAChE,UAAM,IAAI,0BAA0B,GAAG,UAAU,gCAAgC;AAAA,EACnF;AAEA,MAAI,QAAQ,iBAAiB,UAAa,CAAC,aAAa,cAAc;AACpE,UAAM,IAAI,0BAA0B,GAAG,UAAU,mCAAmC;AAAA,EACtF;AAEA,MAAI,CAAC,aAAa,cAAc,qBAAqB,OAAO,GAAG;AAC7D,UAAM,IAAI,0BAA0B,GAAG,UAAU,gCAAgC;AAAA,EACnF;AAEA,MAAI,CAAC,aAAa,iBAAiB,4BAA4B,OAAO,GAAG;AACvE,UAAM,IAAI,0BAA0B,GAAG,UAAU,wCAAwC;AAAA,EAC3F;AACF;AAGO,SAAS,kCACd,OACA,UACM;AACN,QAAM,aAAa,GAAG,MAAM,QAAQ,IAAI,MAAM,OAAO;AACrD,aAAW,CAAC,WAAW,KAAK,KAAK,OAAO,QAAQ,YAAY,CAAC,CAAC,GAAG;AAC/D,QAAI,UAAU,OAAW;AACzB,UAAM,gBAAgB,MAAM;AAC5B,UAAM,UACJ,kBAAkB,UAAa,OAAO,OAAO,eAAe,SAAS,IACjE,cAAc,SAAS,IACvB;AACN,QAAI,YAAY,QAAW;AACzB,YAAM,IAAI;AAAA,QACR,GAAG,UAAU,yCAAyC,SAAS;AAAA,MACjE;AAAA,IACF;AACA,QAAI,CAAC,QAAQ,QAAQ,SAAS,KAAK,GAAG;AACpC,YAAM,IAAI;AAAA,QACR,GAAG,UAAU,wBAAwB,SAAS,6BAA6B,KAAK;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AACF;AAGO,SAAS,yBAAyB,SAAkD;AACzF,SAAO,QAAQ,QAAQ,CAAC,SAAU,KAAK,SAAS,SAAS,CAAC,KAAK,IAAI,IAAI,CAAC,CAAE,EAAE,KAAK,IAAI;AACvF;AAEA,SAAS,qBAAqB,SAAqC;AACjE,SAAO,QAAQ,YAAY;AAAA,IAAK,CAAC,YAC/B,QAAQ,SAAS,YAAY,OAAO,QAAQ,YAAY,WACpD,QACA,QAAQ,QAAQ,KAAK,CAAC,YAAY,QAAQ,SAAS,OAAO;AAAA,EAChE;AACF;AAEA,SAAS,4BAA4B,SAAqC;AACxE,SAAO,QAAQ,YAAY;AAAA,IAAK,CAAC,YAC/B,QAAQ,SAAS,UAAU,OAAO,QAAQ,YAAY,WAClD,QAAQ,QAAQ,KAAK,CAAC,YAAY,QAAQ,SAAS,UAAU,QAAQ,KAAK,SAAS,MAAM,IACzF;AAAA,EACN;AACF;","names":[]}

package/dist/{chunk-T4IAJJUU.js → chunk-IYDGPF3C.js}

@@ -1,12 +1,12 @@
 import {
   Agent
-} from "./chunk-4S4OECPW.js";
+} from "./chunk-KRUDSNFN.js";
 import {
   getAgentToolState
 } from "./chunk-A7BXVZXZ.js";
 import {
   markResolvedAgentOptions
-} from "./chunk-5FCZ64HM.js";
+} from "./chunk-WCWSPU74.js";
 
 // src/agent/resolved-agent.ts
 function createResolvedAgent(options) {
@@ -45,4 +45,4 @@ export {
   createResolvedAgent,
   getResolvedAgentOptions
 };
-//# sourceMappingURL=chunk-T4IAJJUU.js.map
+//# sourceMappingURL=chunk-IYDGPF3C.js.map

package/dist/{chunk-PPJ7SYQL.js → chunk-JMNIWUFV.js}

@@ -1,9 +1,9 @@
 import {
   isStreamingCompletionModel
-} from "./chunk-BDKFFFVX.js";
+} from "./chunk-YMTBHHLQ.js";
 import {
   createTool
-} from "./chunk-XV3DH5GC.js";
+} from "./chunk-Y365ABZY.js";
 import {
   AgentRunBlockedError,
   AgentToolSuspensionError
@@ -78,4 +78,4 @@ function createAgentTool(agent, options) {
 export {
   createAgentTool
 };
-//# sourceMappingURL=chunk-PPJ7SYQL.js.map
+//# sourceMappingURL=chunk-JMNIWUFV.js.map

package/dist/{chunk-72LBHKYP.js → chunk-JWD43K7W.js}

@@ -16,7 +16,7 @@ import {
 } from "./chunk-5V533R7F.js";
 import {
   createTool
-} from "./chunk-XV3DH5GC.js";
+} from "./chunk-Y365ABZY.js";
 
 // src/vector-store/index.ts
 import { z } from "zod";
@@ -233,4 +233,4 @@ export {
   InMemoryVectorStore,
   createVectorSearchTool
 };
-//# sourceMappingURL=chunk-72LBHKYP.js.map
+//# sourceMappingURL=chunk-JWD43K7W.js.map

package/dist/{chunk-MNYMLWWA.js → chunk-KNZNSNP4.js}

@@ -1,6 +1,6 @@
 import {
   isToolIndex
-} from "./chunk-G336L2IE.js";
+} from "./chunk-4BDSO4PQ.js";
 import {
   isMcpTool
 } from "./chunk-PLDJCCVL.js";
@@ -165,4 +165,4 @@ function snapshotToolIndex(index) {
 export {
   prepareAgentTools
 };
-//# sourceMappingURL=chunk-MNYMLWWA.js.map
+//# sourceMappingURL=chunk-KNZNSNP4.js.map

package/dist/{chunk-4S4OECPW.js → chunk-KRUDSNFN.js}

@@ -1,18 +1,18 @@
 import {
   AgentRun
-} from "./chunk-RT5LUEO3.js";
+} from "./chunk-A3DGCDGF.js";
+import {
+  AgentRunMemory
+} from "./chunk-GE46NHN4.js";
 import {
   assertNonnegativeSafeInteger
 } from "./chunk-NPJ2T3L5.js";
 import {
   normalizeMemoryScope
 } from "./chunk-LAIATEUB.js";
-import {
-  AgentRunMemory
-} from "./chunk-F3E2RLC7.js";
 import {
   prepareAgentTools
-} from "./chunk-MNYMLWWA.js";
+} from "./chunk-KNZNSNP4.js";
 import {
   getRegisteredAgentTool,
   registerAgentToolState
@@ -22,7 +22,7 @@ import {
 } from "./chunk-GLMYZ6OA.js";
 import {
   resolveAgentOptions
-} from "./chunk-5FCZ64HM.js";
+} from "./chunk-WCWSPU74.js";
 import {
   cloneFrozenPlainData,
   snapshotAgentContext,
@@ -35,22 +35,22 @@ import {
 } from "./chunk-KY4VXIN2.js";
 import {
   createAgentTool
-} from "./chunk-PPJ7SYQL.js";
+} from "./chunk-JMNIWUFV.js";
 import {
   isStreamingCompletionModel
-} from "./chunk-BDKFFFVX.js";
+} from "./chunk-YMTBHHLQ.js";
 import {
   assertJsonObject
 } from "./chunk-4ONUNWGC.js";
 import {
   prepareToolCall
-} from "./chunk-MHOJJYDK.js";
+} from "./chunk-647TQE3E.js";
 import {
   ToolNotFoundError
 } from "./chunk-J6S6MT7O.js";
 import {
   assertCompletionControlsSupported
-} from "./chunk-IDNL6IH4.js";
+} from "./chunk-HJ6KTQTZ.js";
 import {
   normalizeAgentId
 } from "./chunk-KBBQSP4M.js";
@@ -155,4 +155,4 @@ var Agent = class {
 export {
   Agent
 };
-//# sourceMappingURL=chunk-4S4OECPW.js.map
+//# sourceMappingURL=chunk-KRUDSNFN.js.map

package/dist/{chunk-O6DTOCBM.js → chunk-KX2TRKO2.js}

@@ -1,6 +1,6 @@
 import {
   runEvalSuite
-} from "./chunk-QUS6S2NB.js";
+} from "./chunk-SIXS4CCU.js";
 
 // src/evals/cli.ts
 var EvalAssertionError = class extends Error {
@@ -352,4 +352,4 @@ export {
   assertEvalOutcomes,
   runEvalCli
 };
-//# sourceMappingURL=chunk-O6DTOCBM.js.map
+//# sourceMappingURL=chunk-KX2TRKO2.js.map

package/dist/{chunk-BDDC72GF.js → chunk-LJGQ6VQB.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-2NLINXRF.js";
 import {
   createTool
-} from "./chunk-XV3DH5GC.js";
+} from "./chunk-Y365ABZY.js";
 
 // src/skills/tools.ts
 import { spawn } from "child_process";
@@ -186,4 +186,4 @@ function appendLimited(current, chunk) {
 export {
   createSkillTools
 };
-//# sourceMappingURL=chunk-BDDC72GF.js.map
+//# sourceMappingURL=chunk-LJGQ6VQB.js.map

package/dist/chunk-NMPDZTBM.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-NMPDZTBM.js.map

package/dist/chunk-NMPDZTBM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{chunk-6N4ENZO4.js → chunk-OYHU4HNC.js}

@@ -1,6 +1,6 @@
 import {
   createTool
-} from "./chunk-XV3DH5GC.js";
+} from "./chunk-Y365ABZY.js";
 
 // src/tool/think-tool.ts
 import { z } from "zod";
@@ -21,4 +21,4 @@ function createThinkTool(options = {}) {
 export {
   createThinkTool
 };
-//# sourceMappingURL=chunk-6N4ENZO4.js.map
+//# sourceMappingURL=chunk-OYHU4HNC.js.map

package/dist/{chunk-Y7JTHNCU.js → chunk-RFFOL6ON.js}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-ZPXOBQDS.js";
 import {
   extract
-} from "./chunk-UOGM62JL.js";
+} from "./chunk-7TUAAGVR.js";
 import {
   evalValuesEqual,
   formatValue
@@ -315,4 +315,4 @@ export {
   llmJudge,
   llmScore
 };
-//# sourceMappingURL=chunk-Y7JTHNCU.js.map
+//# sourceMappingURL=chunk-RFFOL6ON.js.map

package/dist/{chunk-47NTHIVB.js → chunk-SCFWN3T2.js}

@@ -16,6 +16,7 @@ var ToolResultSerializationError = class extends TypeError {
   output;
 };
 var ToolOutput = {
+  /** Wraps content parts so a tool can return text and files together. */
   content(content) {
     return { [richToolOutput]: true, content };
   }
@@ -73,4 +74,4 @@ export {
   toolResultContentToText,
   parseToolArgs
 };
-//# sourceMappingURL=chunk-47NTHIVB.js.map
+//# sourceMappingURL=chunk-SCFWN3T2.js.map

package/dist/chunk-SCFWN3T2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool/tool.ts"],"sourcesContent":["import { isJsonValue } from \"../completion/json\";\nimport { parseMessage } from \"../completion/message-schema\";\nimport type {\n  JsonObject,\n  JsonValue,\n  ToolDefinition,\n  ToolResultContentPart,\n  ToolResultOutput,\n} from \"../completion/types\";\n\n/** Identifies the agent run that requested a tool approval. */\nexport type ToolApprovalRunContext = {\n  agentId: string;\n  runId: string;\n  sessionId?: string;\n  metadata?: JsonObject;\n};\n\n/** Details of the pending tool call being evaluated for approval. */\nexport type ToolApprovalContext<Args = unknown> = {\n  toolName: string;\n  args: Args;\n  /** The serialized argument string passed to hooks and approval checks. */\n  rawArgs: string;\n  toolCallId: string;\n  callId?: string;\n  internalCallId: string;\n  run: ToolApprovalRunContext;\n};\n\n/** An approval demand, with an optional human-readable reason. */\nexport type ToolApprovalRequirement = {\n  reason?: string | undefined;\n};\n\n/**\n * Whether a tool call needs human approval before execution:\n *\n * - `boolean`: a static requirement\n * - `ToolApprovalRequirement`: a requirement with a reason\n * - a function: evaluated per call, receiving the parsed args and call context\n */\nexport type ToolRequiresApproval<Args = unknown> =\n  | boolean\n  | ToolApprovalRequirement\n  | ((\n      args: Args,\n      context: ToolApprovalContext<Args>,\n    ) => boolean | ToolApprovalRequirement | Promise<boolean | ToolApprovalRequirement>);\n\n/** A child-agent event forwarded through a tool into the parent run's stream. */\nexport type ToolCallStreamEvent = {\n  agentId: string;\n  agentName?: string | undefined;\n  event: unknown;\n};\n\n/** Execution context handed to a tool when the run invokes it. */\nexport type ToolCallContext = {\n  /** Emits a child-agent event into the parent run's stream. */\n  emitStreamEvent?(event: ToolCallStreamEvent): void | Promise<void>;\n  /** Aborted when the run is cancelled or the stream consumer leaves. */\n  abortSignal?: AbortSignal | undefined;\n};\n\n/**\n * A model-callable tool. `definition` builds the model-facing JSON description,\n * `call` executes it, and the optional `parseInput` converts raw model-supplied\n * JSON arguments into the typed `Args` before `call` runs.\n */\nexport interface Tool<Args = unknown, Output = unknown> {\n  readonly name: string;\n  readonly requiresApproval?: ToolRequiresApproval<Args>;\n  definition(prompt: string): ToolDefinition | Promise<ToolDefinition>;\n  call(args: Args, context?: ToolCallContext): Output | Promise<Output>;\n  parseInput?(args: JsonValue): Args;\n}\n\n/** A tool with its argument and output types erased, e.g. as stored in an agent's catalog. */\nexport type AnyTool = Omit<Tool<unknown, unknown>, \"requiresApproval\"> & {\n  readonly requiresApproval?: unknown;\n};\n\nconst richToolOutput: unique symbol = Symbol.for(\"anvia.tool-output.content\");\n\n/**\n * A tool result carrying mixed content parts (text, files), created with\n * {@link ToolOutput.content}. The brand symbol keeps plain objects from\n * impersonating rich outputs.\n */\nexport type RichToolOutput = Readonly<{\n  [richToolOutput]: true;\n  content: readonly ToolResultContentPart[];\n}>;\n\n/** Normalized tool result as stored in tool messages. */\nexport type NormalizedToolOutput = ToolResultOutput;\n\n/** Thrown when a tool returns a value that cannot be represented as a tool result. */\nexport class ToolResultSerializationError extends TypeError {\n  constructor(readonly output: unknown) {\n    super(\"Tool output must be a string, a strict JSON value, or ToolOutput.content(...).\");\n    this.name = \"ToolResultSerializationError\";\n  }\n}\n\n/** Helpers for building tool results. */\nexport const ToolOutput = {\n  /** Wraps content parts so a tool can return text and files together. */\n  content(content: readonly ToolResultContentPart[]): RichToolOutput {\n    return { [richToolOutput]: true, content };\n  },\n};\n\n/**\n * Coerces a tool's return value into a normalized result: strings become text,\n * rich outputs are validated, and strict JSON values become JSON results.\n * Anything else throws {@link ToolResultSerializationError}.\n */\nexport function normalizeToolResultOutput(output: unknown): NormalizedToolOutput {\n  if (typeof output === \"string\") {\n    return { type: \"text\", value: output };\n  }\n  if (isRichToolOutput(output)) {\n    try {\n      const message = parseMessage({\n        role: \"tool\",\n        content: [\n          {\n            type: \"tool-result\",\n            toolCallId: \"validation\",\n            toolName: \"validation\",\n            output: { type: \"content\", value: output.content },\n          },\n        ],\n      });\n      if (message.role !== \"tool\") throw new TypeError(\"Unexpected message role\");\n      const result = message.content[0];\n      if (result?.type !== \"tool-result\") throw new TypeError(\"Unexpected tool result part\");\n      if (result?.output.type !== \"content\") throw new TypeError(\"Unexpected tool output\");\n      return result.output;\n    } catch {\n      throw new ToolResultSerializationError(output);\n    }\n  }\n  if (isJsonValue(output)) {\n    return { type: \"json\", value: output };\n  }\n  throw new ToolResultSerializationError(output);\n}\n\n/** Renders tool result content as text; file parts become `[file:<mediaType>]` placeholders. */\nexport function toolResultContentToText(content: readonly ToolResultContentPart[]): string {\n  return content\n    .map((item) => (item.type === \"text\" ? item.text : `[file:${item.mediaType}]`))\n    .join(\"\\n\");\n}\n\nfunction isRichToolOutput(value: unknown): value is RichToolOutput {\n  if (typeof value !== \"object\" || value === null) return false;\n  return Object.getOwnPropertyDescriptor(value, richToolOutput)?.value === true;\n}\n\n/** Parses and JSON-validates the raw argument string supplied by the model. */\nexport function parseToolArgs(args: string): JsonValue {\n  const value: unknown = JSON.parse(args);\n  if (!isJsonValue(value)) {\n    throw new TypeError(\"Tool arguments must be a JSON value.\");\n  }\n  return value;\n}\n"],"mappings":";;;;;;;;AAmFA,IAAM,iBAAgC,uBAAO,IAAI,2BAA2B;AAgBrE,IAAM,+BAAN,cAA2C,UAAU;AAAA,EAC1D,YAAqB,QAAiB;AACpC,UAAM,gFAAgF;AADnE;AAEnB,SAAK,OAAO;AAAA,EACd;AAAA,EAHqB;AAIvB;AAGO,IAAM,aAAa;AAAA;AAAA,EAExB,QAAQ,SAA2D;AACjE,WAAO,EAAE,CAAC,cAAc,GAAG,MAAM,QAAQ;AAAA,EAC3C;AACF;AAOO,SAAS,0BAA0B,QAAuC;AAC/E,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO,EAAE,MAAM,QAAQ,OAAO,OAAO;AAAA,EACvC;AACA,MAAI,iBAAiB,MAAM,GAAG;AAC5B,QAAI;AACF,YAAM,UAAU,aAAa;AAAA,QAC3B,MAAM;AAAA,QACN,SAAS;AAAA,UACP;AAAA,YACE,MAAM;AAAA,YACN,YAAY;AAAA,YACZ,UAAU;AAAA,YACV,QAAQ,EAAE,MAAM,WAAW,OAAO,OAAO,QAAQ;AAAA,UACnD;AAAA,QACF;AAAA,MACF,CAAC;AACD,UAAI,QAAQ,SAAS,OAAQ,OAAM,IAAI,UAAU,yBAAyB;AAC1E,YAAM,SAAS,QAAQ,QAAQ,CAAC;AAChC,UAAI,QAAQ,SAAS,cAAe,OAAM,IAAI,UAAU,6BAA6B;AACrF,UAAI,QAAQ,OAAO,SAAS,UAAW,OAAM,IAAI,UAAU,wBAAwB;AACnF,aAAO,OAAO;AAAA,IAChB,QAAQ;AACN,YAAM,IAAI,6BAA6B,MAAM;AAAA,IAC/C;AAAA,EACF;AACA,MAAI,YAAY,MAAM,GAAG;AACvB,WAAO,EAAE,MAAM,QAAQ,OAAO,OAAO;AAAA,EACvC;AACA,QAAM,IAAI,6BAA6B,MAAM;AAC/C;AAGO,SAAS,wBAAwB,SAAmD;AACzF,SAAO,QACJ,IAAI,CAAC,SAAU,KAAK,SAAS,SAAS,KAAK,OAAO,SAAS,KAAK,SAAS,GAAI,EAC7E,KAAK,IAAI;AACd;AAEA,SAAS,iBAAiB,OAAyC;AACjE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,SAAO,OAAO,yBAAyB,OAAO,cAAc,GAAG,UAAU;AAC3E;AAGO,SAAS,cAAc,MAAyB;AACrD,QAAM,QAAiB,KAAK,MAAM,IAAI;AACtC,MAAI,CAAC,YAAY,KAAK,GAAG;AACvB,UAAM,IAAI,UAAU,sCAAsC;AAAA,EAC5D;AACA,SAAO;AACT;","names":[]}

package/dist/{chunk-QUS6S2NB.js → chunk-SIXS4CCU.js}

@@ -16,7 +16,7 @@ import {
 } from "./chunk-JMMZICU7.js";
 import {
   Usage
-} from "./chunk-IDNL6IH4.js";
+} from "./chunk-HJ6KTQTZ.js";
 
 // src/evals/runner.ts
 var EvalReporterDispatchError = class extends AggregateError {
@@ -660,4 +660,4 @@ export {
   EvalFailFastError,
   runEvalSuite
 };
-//# sourceMappingURL=chunk-QUS6S2NB.js.map
+//# sourceMappingURL=chunk-SIXS4CCU.js.map

package/dist/{chunk-IV6YQTY2.js → chunk-T3ZOZEAB.js}

@@ -1,6 +1,6 @@
 import {
   createTool
-} from "./chunk-XV3DH5GC.js";
+} from "./chunk-Y365ABZY.js";
 
 // src/tool/question-tool.ts
 import { z } from "zod";
@@ -44,4 +44,4 @@ export {
   createQuestionTool,
   isQuestionTool
 };
-//# sourceMappingURL=chunk-IV6YQTY2.js.map
+//# sourceMappingURL=chunk-T3ZOZEAB.js.map

package/dist/{chunk-AOG6KSV4.js → chunk-T4UW4SUK.js}

@@ -3,13 +3,13 @@ import {
 } from "./chunk-X6WS3XWL.js";
 import {
   TeamRun
-} from "./chunk-SIYZDPVH.js";
+} from "./chunk-VKRGWGA4.js";
 import {
   TeamStream
 } from "./chunk-3TAQXJBC.js";
 import {
   Agent
-} from "./chunk-4S4OECPW.js";
+} from "./chunk-KRUDSNFN.js";
 import {
   assertPositiveSafeInteger
 } from "./chunk-NPJ2T3L5.js";
@@ -104,4 +104,4 @@ var AgentTeam = class {
 export {
   AgentTeam
 };
-//# sourceMappingURL=chunk-AOG6KSV4.js.map
+//# sourceMappingURL=chunk-T4UW4SUK.js.map

package/dist/{chunk-BUPC72Y2.js → chunk-V5DWNXVH.js}

@@ -2,7 +2,7 @@ import {
   addUsage,
   evaluationMetadata,
   runJudge
-} from "./chunk-LKIABZNR.js";
+} from "./chunk-5SJBSCG2.js";
 import {
   resolveActualText,
   resolveExpected
@@ -19,7 +19,7 @@ import {
 } from "./chunk-4FIVU53H.js";
 import {
   Usage
-} from "./chunk-IDNL6IH4.js";
+} from "./chunk-HJ6KTQTZ.js";
 import {
   isJsonValue
 } from "./chunk-4C7AXYOM.js";
@@ -1004,4 +1004,4 @@ export {
   turnRelevancy,
   knowledgeRetention
 };
-//# sourceMappingURL=chunk-BUPC72Y2.js.map
+//# sourceMappingURL=chunk-V5DWNXVH.js.map