@better-agent/core 0.1.0-beta.1

package/dist/providers/types/conversation.d.mts

@@ -0,0 +1,32 @@
+import { Capabilities } from "./capabilities.mjs";
+import { AudioContentBase, EmbeddingContentBase, FileContentBase, ImageContentBase, ReasoningContentBase, TextContentBase, TranscriptContentBase, VideoContentBase } from "./content.mjs";
+import { GenerativeModelProviderToolResult, GenerativeModelToolCallRequest, GenerativeModelToolCallResult } from "./tool-calls.mjs";
+import { GenerativeModelMessageRole } from "./input.mjs";
+
+//#region src/providers/types/conversation.d.ts
+/**
+ * Durable conversation message part.
+ *
+ * Unlike provider input/output parts, this is intentionally not capability-gated.
+ * It represents canonical stored state across turns.
+ */
+type ConversationMessagePart = TextContentBase | ImageContentBase | FileContentBase | VideoContentBase | AudioContentBase | EmbeddingContentBase | TranscriptContentBase | ReasoningContentBase;
+/**
+ * Durable conversation message content.
+ */
+type ConversationMessageContent = string | ConversationMessagePart[];
+/**
+ * Canonical stored message in a conversation timeline.
+ */
+interface ConversationMessage {
+  type: "message";
+  role: GenerativeModelMessageRole<Capabilities>;
+  content: ConversationMessageContent;
+}
+/**
+ * Canonical durable conversation item.
+ */
+type ConversationItem = ConversationMessage | GenerativeModelToolCallRequest | GenerativeModelToolCallResult | GenerativeModelProviderToolResult;
+//#endregion
+export { ConversationItem, ConversationMessage, ConversationMessageContent, ConversationMessagePart };
+//# sourceMappingURL=conversation.d.mts.map

package/dist/providers/types/conversation.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.mts","names":[],"sources":["../../../src/providers/types/conversation.ts"],"mappings":";;;;;;;;AAwBA;;;;KAAY,uBAAA,GACN,eAAA,GACA,gBAAA,GACA,eAAA,GACA,gBAAA,GACA,gBAAA,GACA,oBAAA,GACA,qBAAA,GACA,oBAAA;;;;KAKM,0BAAA,YAAsC,uBAAA;;;;UAKjC,mBAAA;EACb,IAAA;EACA,IAAA,EAAM,0BAAA,CAA2B,YAAA;EACjC,OAAA,EAAS,0BAAA;AAAA;;;;KAMD,gBAAA,GACN,mBAAA,GACA,8BAAA,GACA,6BAAA,GACA,iCAAA"}

package/dist/providers/types/index.d.mts

@@ -0,0 +1,8 @@
+import { CapEnabled, Capabilities, IfCap, InferOutputSchema, InputEnabled, InputModalitySpec, InputShape, InstructionEnabled, ModalitiesField, ModalitiesParam, Modality, ModalityOptionsFor, OutputEnabled, OutputModalitySpec, OutputSchemaDefinition, OutputSchemaForCaps, OutputSchemaSource, ReplayMode, StructuredOutput } from "./capabilities.mjs";
+import { AudioContentBase, EmbeddingContentBase, FileContentBase, GenerativeModelAudioSource, GenerativeModelFileSource, GenerativeModelImageSource, GenerativeModelVideoSource, ImageContentBase, ReasoningContentBase, TextContentBase, TranscriptContentBase, VideoContentBase } from "./content.mjs";
+import { GenerativeModelProviderToolResult, GenerativeModelToolCallRequest, GenerativeModelToolCallResult, ToolChoice } from "./tool-calls.mjs";
+import { ChatInputMessage, GenerativeModelCallOptions, GenerativeModelInput, GenerativeModelInputItem, GenerativeModelInputMessage, GenerativeModelInputMessageContent, GenerativeModelInputMessagePart, GenerativeModelMessageRole, ModelOptions, PromptInputMessage } from "./input.mjs";
+import { ConversationItem, ConversationMessage, ConversationMessageContent, ConversationMessagePart } from "./conversation.mjs";
+import { GenerativeModelOutputItem, GenerativeModelOutputMessage, GenerativeModelOutputMessageContent, GenerativeModelOutputMessagePart } from "./output.mjs";
+import { GenerativeModelFinishReason, GenerativeModelResponse, GenerativeModelUsage } from "./response.mjs";
+import { GenerativeModel, GenerativeModelGenerateResult, ModelDescriptor } from "./model.mjs";

package/dist/providers/types/input.d.mts

@@ -0,0 +1,74 @@
+import { StripIndex } from "../../internal/types.mjs";
+import { Capabilities, IfCap, InputEnabled, ModalitiesField, ModalitiesParam, ModalityOptionsFor, StructuredOutput } from "./capabilities.mjs";
+import { AudioContentBase, EmbeddingContentBase, FileContentBase, ImageContentBase, ReasoningContentBase, TextContentBase, TranscriptContentBase, VideoContentBase } from "./content.mjs";
+import { AgentToolDefinition } from "../../tools/types.mjs";
+import { GenerativeModelProviderToolResult, GenerativeModelToolCallResult, ToolChoice } from "./tool-calls.mjs";
+
+//#region src/providers/types/input.d.ts
+/**
+ * Message roles supported by a model.
+ */
+type GenerativeModelMessageRole<TModelCaps extends Capabilities> = "system" | "user" | "assistant" | (TModelCaps["additionalSupportedRoles"] extends readonly (infer R)[] ? R : never) | (string & {});
+/**
+ * One input message part.
+ */
+type GenerativeModelInputMessagePart<TModelCaps extends Capabilities = Capabilities> = (InputEnabled<TModelCaps, "text"> extends true ? TextContentBase : never) | (InputEnabled<TModelCaps, "image"> extends true ? ImageContentBase : never) | (InputEnabled<TModelCaps, "file"> extends true ? FileContentBase : never) | (InputEnabled<TModelCaps, "video"> extends true ? VideoContentBase : never) | (InputEnabled<TModelCaps, "audio"> extends true ? AudioContentBase : never) | EmbeddingContentBase | TranscriptContentBase | ReasoningContentBase;
+/**
+ * Input message content.
+ */
+type GenerativeModelInputMessageContent<TModelCaps extends Capabilities = Capabilities> = (InputEnabled<TModelCaps, "text"> extends true ? string : never) | Array<GenerativeModelInputMessagePart<TModelCaps>>;
+/**
+ * Prompt-style input message with no explicit role.
+ */
+type PromptInputMessage<TModelCaps extends Capabilities> = {
+  type: "message";
+  content: GenerativeModelInputMessageContent<TModelCaps>;
+  role?: never;
+};
+/**
+ * Chat-style input message with an explicit role.
+ */
+type ChatInputMessage<TModelCaps extends Capabilities> = {
+  type: "message";
+  role: GenerativeModelMessageRole<TModelCaps>;
+  content: GenerativeModelInputMessageContent<TModelCaps>;
+};
+/**
+ * Input message type selected by {@link Capabilities.inputShape | inputShape}.
+ */
+type GenerativeModelInputMessage<TModelCaps extends Capabilities = Capabilities> = TModelCaps["inputShape"] extends "prompt" ? PromptInputMessage<TModelCaps> : ChatInputMessage<TModelCaps>;
+/**
+ * Input item sent to a model.
+ */
+type GenerativeModelInputItem<TModelCaps extends Capabilities = Capabilities> = GenerativeModelInputMessage<TModelCaps> | GenerativeModelToolCallResult | GenerativeModelProviderToolResult;
+/**
+ * Complete input for a model call.
+ */
+type GenerativeModelInput<TModelCaps extends Capabilities = Capabilities> = (InputEnabled<TModelCaps, "text"> extends true ? string : never) | Array<GenerativeModelInputItem<TModelCaps>>;
+/**
+ * Provider options excluding reserved runtime fields.
+ *
+ * Strips keys that the framework manages internally (`tools`, `toolChoice`, `input`,
+ * `modalities`, `structured_output`) as well as fields that have framework-level
+ * equivalents (`instructions` → `agent.instruction`, `text` → use `textVerbosity`
+ * shorthand + `outputSchema`).
+ */
+type ModelOptions<TOptions> = StripIndex<Omit<TOptions, "tools" | "toolChoice" | "input" | "modalities" | "structured_output" | "instructions" | "text">>;
+/**
+ * Options for invoking a model call.
+ *
+ * @typeParam TModelCaps Capability flags for the model.
+ * @typeParam TOptions Provider-specific model options.
+ * @typeParam TModalities Selected output modalities, if any.
+ */
+type GenerativeModelCallOptions<TModelCaps extends Capabilities = Capabilities, TOptions extends Record<string, unknown> = Record<string, unknown>, TModalities extends ModalitiesParam<TModelCaps> = undefined> = {
+  input: GenerativeModelInput<TModelCaps>;
+} & ModalitiesField<TModalities> & IfCap<TModelCaps["tools"], {
+  tools?: readonly AgentToolDefinition[];
+  toolChoice?: ToolChoice;
+}> & IfCap<TModelCaps["structured_output"], {
+  structured_output?: StructuredOutput;
+}> & ModelOptions<TOptions> & ModalityOptionsFor<TModelCaps, TModalities>;
+//#endregion
+export { ChatInputMessage, GenerativeModelCallOptions, GenerativeModelInput, GenerativeModelInputItem, GenerativeModelInputMessage, GenerativeModelInputMessageContent, GenerativeModelInputMessagePart, GenerativeModelMessageRole, ModelOptions, PromptInputMessage };
+//# sourceMappingURL=input.d.mts.map

package/dist/providers/types/input.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.mts","names":[],"sources":["../../../src/providers/types/input.ts"],"mappings":";;;;;;;;;;KA8BY,0BAAA,oBAA8C,YAAA,uCAInD,UAAA,4DAAsE,CAAA;;;;KAMjE,+BAAA,oBAAmD,YAAA,GAAe,YAAA,KACvE,YAAA,CAAa,UAAA,yBAAmC,eAAA,aAChD,YAAA,CAAa,UAAA,0BAAoC,gBAAA,aACjD,YAAA,CAAa,UAAA,yBAAmC,eAAA,aAChD,YAAA,CAAa,UAAA,0BAAoC,gBAAA,aACjD,YAAA,CAAa,UAAA,0BAAoC,gBAAA,YAClD,oBAAA,GACA,qBAAA,GACA,oBAAA;;;;KAKM,kCAAA,oBAAsD,YAAA,GAAe,YAAA,KAC1E,YAAA,CAAa,UAAA,2CACd,KAAA,CAAM,+BAAA,CAAgC,UAAA;;;AAf5C;KAoBY,kBAAA,oBAAsC,YAAA;EAC9C,IAAA;EACA,OAAA,EAAS,kCAAA,CAAmC,UAAA;EAC5C,IAAA;AAAA;;;;KAMQ,gBAAA,oBAAoC,YAAA;EAC5C,IAAA;EACA,IAAA,EAAM,0BAAA,CAA2B,UAAA;EACjC,OAAA,EAAS,kCAAA,CAAmC,UAAA;AAAA;;;;KAMpC,2BAAA,oBAA+C,YAAA,GAAe,YAAA,IACtE,UAAA,kCACM,kBAAA,CAAmB,UAAA,IACnB,gBAAA,CAAiB,UAAA;;;;KAKf,wBAAA,oBAA4C,YAAA,GAAe,YAAA,IACjE,2BAAA,CAA4B,UAAA,IAC5B,6BAAA,GACA,iCAAA;;;;KAKM,oBAAA,oBAAwC,YAAA,GAAe,YAAA,KAC5D,YAAA,CAAa,UAAA,2CACd,KAAA,CAAM,wBAAA,CAAyB,UAAA;;;;;;;;;KAUzB,YAAA,aAAyB,UAAA,CACjC,IAAA,CACI,QAAA;;;;;;;;KAkBI,0BAAA,oBACW,YAAA,GAAe,YAAA,mBACjB,MAAA,oBAA0B,MAAA,uCACvB,eAAA,CAAgB,UAAA;EAEpC,KAAA,EAAO,oBAAA,CAAqB,UAAA;AAAA,IAC5B,eAAA,CAAgB,WAAA,IAChB,KAAA,CACI,UAAA;EAEI,KAAA,YAAiB,mBAAA;EACjB,UAAA,GAAa,UAAA;AAAA,KAGrB,KAAA,CACI,UAAA;EAEI,iBAAA,GAAoB,gBAAA;AAAA,KAG5B,YAAA,CAAa,QAAA,IACb,kBAAA,CAAmB,UAAA,EAAY,WAAA"}

package/dist/providers/types/model.d.mts

@@ -0,0 +1,68 @@
+import { Capabilities, ModalitiesParam } from "./capabilities.mjs";
+import { GenerativeModelCallOptions } from "./input.mjs";
+import { GenerativeModelResponse } from "./response.mjs";
+import { RunContext } from "../../run/types.mjs";
+import { Event } from "../../events/types.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { Result } from "@better-agent/shared/neverthrow";
+
+//#region src/providers/types/model.d.ts
+/**
+ * Model registry entry describing model options and capabilities.
+ */
+type ModelDescriptor<TOptions extends Record<string, unknown> = Record<string, unknown>, TCaps extends Capabilities = Capabilities> = {
+  options: TOptions;
+  caps: TCaps;
+};
+/**
+ * Model definition used by the runtime.
+ *
+ * A model can implement non-streaming generation, streaming generation, or both.
+ */
+type GenerativeModel<TOptions extends Record<string, unknown> = Record<string, unknown>, TProviderId extends string = string, TModelId extends string = string, TModelCaps extends Capabilities = Capabilities> = GenerativeModelBase<TProviderId, TModelId, TModelCaps> & (GenerativeModelWithGenerate<TModelCaps, TOptions> | GenerativeModelWithStream<TModelCaps, TOptions> | GenerativeModelWithGenerateAndStream<TModelCaps, TOptions>);
+interface GenerativeModelBase<TProviderId extends string, TModelId extends string, TModelCaps extends Capabilities> {
+  /** Provider identifier for this model. */
+  readonly providerId: TProviderId;
+  /** Model identifier within the provider. */
+  readonly modelId: TModelId;
+  /** Runtime capability flags. */
+  readonly caps: TModelCaps;
+}
+/**
+ * Result returned by `doGenerate`.
+ */
+interface GenerativeModelGenerateResult<TModelCaps extends Capabilities> {
+  response: GenerativeModelResponse<TModelCaps>;
+  events?: Event[];
+}
+interface GenerativeModelWithGenerate<TModelCaps extends Capabilities, TOptions extends Record<string, unknown>> {
+  /**
+   * Performs a non-streaming generation.
+   *
+   * @returns A {@link Result} containing the model response and optional emitted events.
+   */
+  doGenerate<const TModalities extends ModalitiesParam<TModelCaps> = undefined>(options: GenerativeModelCallOptions<TModelCaps, TOptions, TModalities>, ctx: RunContext): Promise<Result<GenerativeModelGenerateResult<TModelCaps>, BetterAgentError>>;
+  doGenerateStream?: undefined;
+}
+interface GenerativeModelWithStream<TModelCaps extends Capabilities, TOptions extends Record<string, unknown>> {
+  /**
+   * Performs a streaming generation.
+   *
+   * @returns A {@link Result} containing streamed events and a final response.
+   */
+  doGenerateStream<const TModalities extends ModalitiesParam<TModelCaps> = undefined>(options: GenerativeModelCallOptions<TModelCaps, TOptions, TModalities>, ctx: RunContext): Promise<Result<{
+    events: AsyncGenerator<Result<Event, BetterAgentError>>;
+    final: Promise<GenerativeModelResponse<TModelCaps>>;
+  }, BetterAgentError>>;
+  doGenerate?: undefined;
+}
+interface GenerativeModelWithGenerateAndStream<TModelCaps extends Capabilities, TOptions extends Record<string, unknown>> {
+  doGenerate<const TModalities extends ModalitiesParam<TModelCaps> = undefined>(options: GenerativeModelCallOptions<TModelCaps, TOptions, TModalities>, ctx: RunContext): Promise<Result<GenerativeModelGenerateResult<TModelCaps>, BetterAgentError>>;
+  doGenerateStream<const TModalities extends ModalitiesParam<TModelCaps> = undefined>(options: GenerativeModelCallOptions<TModelCaps, TOptions, TModalities>, ctx: RunContext): Promise<Result<{
+    events: AsyncGenerator<Result<Event, BetterAgentError>>;
+    final: Promise<GenerativeModelResponse<TModelCaps>>;
+  }, BetterAgentError>>;
+}
+//#endregion
+export { GenerativeModel, GenerativeModelGenerateResult, ModelDescriptor };
+//# sourceMappingURL=model.d.mts.map

package/dist/providers/types/model.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.mts","names":[],"sources":["../../../src/providers/types/model.ts"],"mappings":";;;;;;;;;;;;KAWY,eAAA,kBACS,MAAA,oBAA0B,MAAA,iCAC7B,YAAA,GAAe,YAAA;EAE7B,OAAA,EAAS,QAAA;EACT,IAAA,EAAM,KAAA;AAAA;;;;;;KAQE,eAAA,kBACS,MAAA,oBAA0B,MAAA,6GAGxB,YAAA,GAAe,YAAA,IAClC,mBAAA,CAAoB,WAAA,EAAa,QAAA,EAAU,UAAA,KAErC,2BAAA,CAA4B,UAAA,EAAY,QAAA,IACxC,yBAAA,CAA0B,UAAA,EAAY,QAAA,IACtC,oCAAA,CAAqC,UAAA,EAAY,QAAA;AAAA,UAGjD,mBAAA,yEAGa,YAAA;EAvBR;EAAA,SA0BF,UAAA,EAAY,WAAA;EA9BJ;EAAA,SAgCR,OAAA,EAAS,QAAA;EA/BlB;EAAA,SAiCS,IAAA,EAAM,UAAA;AAAA;;;;UAMF,6BAAA,oBAAiD,YAAA;EAC9D,QAAA,EAAU,uBAAA,CAAwB,UAAA;EAClC,MAAA,GAAS,KAAA;AAAA;AAAA,UAGH,2BAAA,oBACa,YAAA,mBACF,MAAA;EAnCM;;;;;EA0CvB,UAAA,2BAAqC,eAAA,CAAgB,UAAA,eACjD,OAAA,EAAS,0BAAA,CAA2B,UAAA,EAAY,QAAA,EAAU,WAAA,GAC1D,GAAA,EAAK,UAAA,GACN,OAAA,CAAQ,MAAA,CAAO,6BAAA,CAA8B,UAAA,GAAa,gBAAA;EAC7D,gBAAA;AAAA;AAAA,UAGM,yBAAA,oBACa,YAAA,mBACF,MAAA;EA5CiB;;;;;EAmDlC,gBAAA,2BAA2C,eAAA,CAAgB,UAAA,eACvD,OAAA,EAAS,0BAAA,CAA2B,UAAA,EAAY,QAAA,EAAU,WAAA,GAC1D,GAAA,EAAK,UAAA,GACN,OAAA,CACC,MAAA;IAEQ,MAAA,EAAQ,cAAA,CAAe,MAAA,CAAO,KAAA,EAAO,gBAAA;IACrC,KAAA,EAAO,OAAA,CAAQ,uBAAA,CAAwB,UAAA;EAAA,GAE3C,gBAAA;EAGR,UAAA;AAAA;AAAA,UAGM,oCAAA,oBACa,YAAA,mBACF,MAAA;EAEjB,UAAA,2BAAqC,eAAA,CAAgB,UAAA,eACjD,OAAA,EAAS,0BAAA,CAA2B,UAAA,EAAY,QAAA,EAAU,WAAA,GAC1D,GAAA,EAAK,UAAA,GACN,OAAA,CAAQ,MAAA,CAAO,6BAAA,CAA8B,UAAA,GAAa,gBAAA;EAC7D,gBAAA,2BAA2C,eAAA,CAAgB,UAAA,eACvD,OAAA,EAAS,0BAAA,CAA2B,UAAA,EAAY,QAAA,EAAU,WAAA,GAC1D,GAAA,EAAK,UAAA,GACN,OAAA,CACC,MAAA;IAEQ,MAAA,EAAQ,cAAA,CAAe,MAAA,CAAO,KAAA,EAAO,gBAAA;IACrC,KAAA,EAAO,OAAA,CAAQ,uBAAA,CAAwB,UAAA;EAAA,GAE3C,gBAAA;AAAA"}

package/dist/providers/types/output.d.mts

@@ -0,0 +1,29 @@
+import { Capabilities, OutputEnabled } from "./capabilities.mjs";
+import { AudioContentBase, EmbeddingContentBase, ImageContentBase, ReasoningContentBase, TextContentBase, TranscriptContentBase, VideoContentBase } from "./content.mjs";
+import { GenerativeModelProviderToolResult, GenerativeModelToolCallRequest } from "./tool-calls.mjs";
+import { GenerativeModelMessageRole } from "./input.mjs";
+
+//#region src/providers/types/output.d.ts
+/**
+ * One output message part.
+ */
+type GenerativeModelOutputMessagePart<TModelCaps extends Capabilities = Capabilities> = (OutputEnabled<TModelCaps, "text"> extends true ? TextContentBase : never) | (OutputEnabled<TModelCaps, "image"> extends true ? ImageContentBase : never) | (OutputEnabled<TModelCaps, "video"> extends true ? VideoContentBase : never) | (OutputEnabled<TModelCaps, "audio"> extends true ? AudioContentBase : never) | (OutputEnabled<TModelCaps, "embedding"> extends true ? EmbeddingContentBase : never) | TranscriptContentBase | ReasoningContentBase;
+/**
+ * Output message content.
+ */
+type GenerativeModelOutputMessageContent<TModelCaps extends Capabilities = Capabilities> = (OutputEnabled<TModelCaps, "text"> extends true ? string : never) | Array<GenerativeModelOutputMessagePart<TModelCaps>>;
+/**
+ * Output message emitted by the model.
+ */
+type GenerativeModelOutputMessage<TModelCaps extends Capabilities = Capabilities> = {
+  type: "message";
+  role: GenerativeModelMessageRole<TModelCaps>;
+  content: GenerativeModelOutputMessageContent<TModelCaps>;
+};
+/**
+ * Output item returned by a model.
+ */
+type GenerativeModelOutputItem<TModelCaps extends Capabilities = Capabilities> = GenerativeModelOutputMessage<TModelCaps> | GenerativeModelToolCallRequest | GenerativeModelProviderToolResult;
+//#endregion
+export { GenerativeModelOutputItem, GenerativeModelOutputMessage, GenerativeModelOutputMessageContent, GenerativeModelOutputMessagePart };
+//# sourceMappingURL=output.d.mts.map

package/dist/providers/types/output.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.mts","names":[],"sources":["../../../src/providers/types/output.ts"],"mappings":";;;;;;;;AAmBA;KAAY,gCAAA,oBAAoD,YAAA,GAAe,YAAA,KACxE,aAAA,CAAc,UAAA,yBAAmC,eAAA,aACjD,aAAA,CAAc,UAAA,0BAAoC,gBAAA,aAClD,aAAA,CAAc,UAAA,0BAAoC,gBAAA,aAClD,aAAA,CAAc,UAAA,0BAAoC,gBAAA,aAClD,aAAA,CAAc,UAAA,8BAAwC,oBAAA,YACvD,qBAAA,GACA,oBAAA;;;;KAKM,mCAAA,oBAAuD,YAAA,GAAe,YAAA,KAC3E,aAAA,CAAc,UAAA,2CACf,KAAA,CAAM,gCAAA,CAAiC,UAAA;;;;KAKjC,4BAAA,oBAAgD,YAAA,GAAe,YAAA;EACvE,IAAA;EACA,IAAA,EAAM,0BAAA,CAA2B,UAAA;EACjC,OAAA,EAAS,mCAAA,CAAoC,UAAA;AAAA;;;;KAMrC,yBAAA,oBAA6C,YAAA,GAAe,YAAA,IAClE,4BAAA,CAA6B,UAAA,IAC7B,8BAAA,GACA,iCAAA"}

package/dist/providers/types/response.d.mts

@@ -0,0 +1,35 @@
+import { Capabilities } from "./capabilities.mjs";
+import { GenerativeModelOutputItem } from "./output.mjs";
+
+//#region src/providers/types/response.d.ts
+/**
+ * Token usage statistics for a model call.
+ */
+interface GenerativeModelUsage {
+  inputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+  reasoningTokens?: number;
+  cachedInputTokens?: number;
+}
+/**
+ * Finish reason reported by a model.
+ */
+type GenerativeModelFinishReason = /** Model completed normally. */"stop" /** Model stopped because token/output limits were reached. */ | "length" /** Model output was blocked or truncated by safety/content filters. */ | "content-filter" /** Model stopped to request one or more tool calls. */ | "tool-calls" /** Generation was interrupted by an explicit abort action. */ | "abort" /** Any provider-specific reason that does not map to a normalized value. */ | "other";
+/**
+ * Model response payload.
+ */
+interface GenerativeModelResponse<TModelCaps extends Capabilities = Capabilities> {
+  output: Array<GenerativeModelOutputItem<TModelCaps>>;
+  finishReason: GenerativeModelFinishReason;
+  usage: GenerativeModelUsage;
+  request?: {
+    body: unknown;
+  };
+  response?: {
+    body: unknown;
+  };
+}
+//#endregion
+export { GenerativeModelFinishReason, GenerativeModelResponse, GenerativeModelUsage };
+//# sourceMappingURL=response.d.mts.map

package/dist/providers/types/response.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.d.mts","names":[],"sources":["../../../src/providers/types/response.ts"],"mappings":";;;;;;AAMA;UAAiB,oBAAA;EACb,WAAA;EACA,YAAA;EACA,WAAA;EACA,eAAA;EACA,iBAAA;AAAA;;;;KAMQ,2BAAA,oHAiBZ;;;;UAAiB,uBAAA,oBAA2C,YAAA,GAAe,YAAA;EACvE,MAAA,EAAQ,KAAA,CAAM,yBAAA,CAA0B,UAAA;EACxC,YAAA,EAAc,2BAAA;EACd,KAAA,EAAO,oBAAA;EACP,OAAA;IACI,IAAA;EAAA;EAEJ,QAAA;IACI,IAAA;EAAA;AAAA"}

package/dist/providers/types/tool-calls.d.mts

@@ -0,0 +1,51 @@
+//#region src/providers/types/tool-calls.d.ts
+/**
+ * Tool selection strategy for a model call.
+ */
+type ToolChoice<TName extends string = string> = {
+  type: "auto";
+} | {
+  type: "none";
+} | {
+  type: "required";
+} | {
+  type: "tool";
+  name: TName;
+};
+/**
+ * Tool call request emitted by a model.
+ */
+interface GenerativeModelToolCallRequest {
+  type: "tool-call";
+  name: string;
+  arguments: string;
+  callId: string;
+  result?: never;
+}
+/**
+ * Tool call result returned to the model.
+ */
+interface GenerativeModelToolCallResult {
+  type: "tool-call";
+  name: string;
+  callId: string;
+  result: unknown;
+  isError?: boolean;
+  arguments?: string;
+}
+/**
+ * Provider-originated tool result surfaced in model output.
+ *
+ * This is used for provider-native tool artifacts that appear in provider
+ * responses, but are not model-emitted tool-call requests.
+ */
+interface GenerativeModelProviderToolResult {
+  type: "provider-tool-result";
+  name: string;
+  callId: string;
+  result: unknown;
+  isError?: boolean;
+}
+//#endregion
+export { GenerativeModelProviderToolResult, GenerativeModelToolCallRequest, GenerativeModelToolCallResult, ToolChoice };
+//# sourceMappingURL=tool-calls.d.mts.map

package/dist/providers/types/tool-calls.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-calls.d.mts","names":[],"sources":["../../../src/providers/types/tool-calls.ts"],"mappings":";;AAGA;;KAAY,UAAA;EAEF,IAAA;AAAA;EAGA,IAAA;AAAA;EAGA,IAAA;AAAA;EAGA,IAAA;EACA,IAAA,EAAM,KAAA;AAAA;;AAMhB;;UAAiB,8BAAA;EACb,IAAA;EACA,IAAA;EACA,SAAA;EACA,MAAA;EACA,MAAA;AAAA;;;AAMJ;UAAiB,6BAAA;EACb,IAAA;EACA,IAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;EACA,SAAA;AAAA;;;;AASJ;;;UAAiB,iCAAA;EACb,IAAA;EACA,IAAA;EACA,MAAA;EACA,MAAA;EACA,OAAA;AAAA"}

package/dist/run/agent-loop.mjs

@@ -0,0 +1,231 @@
+import { resolveToolsForRun } from "../tools/resolve-tools.mjs";
+import { Events } from "../events/constants.mjs";
+import { executeToolCalls } from "./execute-tool-calls.mjs";
+import { projectConversationItemsToInput } from "./messages.mjs";
+import { prepareConversationReplayInput } from "./helpers.mjs";
+import { applyAfterModelCall, applyBeforeModelCall, applyOnStep, applyOnStepFinish } from "./hooks.mjs";
+import { evaluateStopConditions, extractToolCallRequests } from "./stop-conditions.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+
+//#region src/run/agent-loop.ts
+const runAgentLoop = async (options, strategy) => {
+	const traceBase = strategy.mode === "stream" ? "core.run.runStreamLoop" : "core.run.runLoop";
+	const pluginToolsResult = options.pluginRuntime?.hasTools === true ? await options.pluginRuntime.resolveTools(options.context) : {
+		tools: [],
+		runCleanup: async () => {}
+	};
+	const { tools, runCleanup } = await resolveToolsForRun({
+		appTools: options.appTools,
+		agentTools: options.agent.tools,
+		context: options.context
+	});
+	const resolvedTools = [...tools, ...pluginToolsResult.tools];
+	if (strategy.mode === "run") {
+		const blockingTool = resolvedTools.find((tool) => tool.kind === "client" || tool.kind !== "hosted" && tool.approval !== void 0);
+		if (blockingTool) {
+			const reason = blockingTool.kind === "client" ? `client tool '${blockingTool.name}'` : `approval-gated tool '${blockingTool.name}'`;
+			throw BetterAgentError.fromCode("BAD_REQUEST", `Non-stream runs do not support interactive tools. Use stream() for ${reason}.`, {
+				context: {
+					agentName: options.agent.name,
+					toolName: blockingTool.name,
+					toolTarget: blockingTool.kind
+				},
+				trace: [{ at: `${traceBase}.validateNonInteractiveRun` }]
+			});
+		}
+	}
+	const state = {
+		runId: options.runId,
+		agentName: options.agent.name,
+		items: [...options.items],
+		replayStartIndex: options.replayStartIndex ?? 0,
+		steps: [],
+		stepIndex: 0,
+		maxSteps: options.maxSteps,
+		conversationId: options.conversationId,
+		context: options.context
+	};
+	const instructionField = "instruction" in options.agent ? options.agent.instruction : void 0;
+	const instructionResolver = instructionField;
+	const instruction = typeof instructionResolver === "function" ? instructionResolver(options.context) : instructionField ?? "";
+	const modelCaps = options.agent.model.caps;
+	const assertInstructionSupported = (currentInstruction, traceAt) => {
+		if (currentInstruction === void 0 || currentInstruction === "") return;
+		if (modelCaps.inputShape === "prompt" || modelCaps.supportsInstruction !== true) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Agent '${options.agent.name}' model does not support instructions.`, {
+			context: {
+				agentName: options.agent.name,
+				modelId: options.agent.model.modelId,
+				inputShape: modelCaps.inputShape ?? "chat",
+				replayMode: modelCaps.replayMode ?? (modelCaps.inputShape === "prompt" ? "single_turn_persistent" : "multi_turn")
+			},
+			trace: [{ at: traceAt }]
+		});
+	};
+	assertInstructionSupported(instruction, `${traceBase}.validateInstruction`);
+	const stepErrorMessage = strategy.mode === "stream" ? "Run stream step failed" : "Run loop step failed";
+	try {
+		while (true) {
+			const previousStep = state.steps.at(-1);
+			const replayItems = state.items.slice(state.replayStartIndex);
+			const projectedMessages = state.conversationId !== void 0 && options.conversationReplayActive ? await prepareConversationReplayInput({
+				items: replayItems,
+				caps: modelCaps,
+				agentName: state.agentName,
+				conversationId: state.conversationId,
+				conversationReplay: options.conversationReplay
+			}) : projectConversationItemsToInput(replayItems, modelCaps);
+			const prepared = await applyOnStep({
+				runId: state.runId,
+				agentName: state.agentName,
+				stepIndex: state.stepIndex,
+				maxSteps: state.maxSteps,
+				messages: projectedMessages,
+				modelCaps,
+				conversationId: state.conversationId,
+				context: options.context,
+				previousStep,
+				onStep: options.agent.onStep,
+				pluginRuntime: options.pluginRuntime
+			});
+			await options.emit({
+				type: Events.STEP_START,
+				runId: state.runId,
+				agentName: state.agentName,
+				stepIndex: state.stepIndex,
+				maxSteps: state.maxSteps,
+				timestamp: Date.now(),
+				conversationId: state.conversationId
+			});
+			try {
+				const activeToolNames = prepared.activeTools;
+				const activeTools = activeToolNames === void 0 ? resolvedTools : resolvedTools.filter((tool) => activeToolNames.includes(tool.kind === "hosted" ? typeof tool.name === "string" && tool.name.length > 0 ? tool.name : tool.type : tool.name));
+				const effectiveInstruction = prepared.systemInstruction ?? instruction;
+				assertInstructionSupported(effectiveInstruction, `${traceBase}.prepareModelInput.validateInstruction`);
+				const modelInput = effectiveInstruction === void 0 || effectiveInstruction === "" ? [...prepared.messages] : [{
+					type: "message",
+					role: "system",
+					content: effectiveInstruction
+				}, ...prepared.messages];
+				const modelPrepared = await applyBeforeModelCall({
+					runId: state.runId,
+					agentName: state.agentName,
+					stepIndex: state.stepIndex,
+					modelCaps,
+					input: modelInput,
+					tools: activeTools,
+					conversationId: state.conversationId,
+					toolChoice: prepared.toolChoice ?? options.toolChoice,
+					pluginRuntime: options.pluginRuntime
+				});
+				const { response, assistantMessageId } = await strategy.call({
+					options,
+					modelInput: modelPrepared.input,
+					tools: modelPrepared.tools,
+					toolChoice: modelPrepared.toolChoice,
+					stepIndex: state.stepIndex,
+					runId: state.runId,
+					agentName: state.agentName,
+					conversationId: state.conversationId
+				});
+				await applyAfterModelCall({
+					runId: state.runId,
+					agentName: state.agentName,
+					stepIndex: state.stepIndex,
+					response,
+					conversationId: state.conversationId,
+					pluginRuntime: options.pluginRuntime
+				});
+				const toolCalls = extractToolCallRequests(response);
+				const toolBatch = toolCalls.length > 0 ? await executeToolCalls({
+					runId: state.runId,
+					agentName: state.agentName,
+					conversationId: state.conversationId,
+					parentMessageId: assistantMessageId,
+					toolCalls,
+					tools: modelPrepared.tools,
+					toolErrorMode: options.agent.toolErrorMode,
+					onToolError: options.agent.onToolError,
+					signal: options.signal,
+					emit: options.emit,
+					advanced: options.advanced,
+					pendingToolRuntime: options.pendingToolRuntime,
+					context: options.context,
+					pluginRuntime: options.pluginRuntime
+				}) : { results: [] };
+				state.items = [...state.items, ...response.output];
+				if (toolBatch.results.length > 0) state.items = [...state.items, ...toolBatch.results];
+				const stepResult = { response };
+				state.steps.push(stepResult);
+				const stopMessages = state.conversationId !== void 0 && options.conversationReplayActive ? await prepareConversationReplayInput({
+					items: state.items.slice(state.replayStartIndex),
+					caps: modelCaps,
+					agentName: state.agentName,
+					conversationId: state.conversationId,
+					conversationReplay: options.conversationReplay
+				}) : projectConversationItemsToInput(state.items.slice(state.replayStartIndex), modelCaps);
+				const stopDecision = evaluateStopConditions({
+					maxSteps: state.maxSteps,
+					stepIndex: state.stepIndex,
+					steps: state.steps,
+					messages: stopMessages,
+					lastStep: stepResult,
+					stopWhen: options.agent.stopWhen,
+					context: options.context
+				});
+				await options.emit({
+					type: Events.STEP_FINISH,
+					runId: state.runId,
+					agentName: state.agentName,
+					stepIndex: state.stepIndex,
+					maxSteps: state.maxSteps,
+					toolCallCount: toolCalls.length,
+					terminationReason: stopDecision.stop ? stopDecision.reason : void 0,
+					timestamp: Date.now(),
+					conversationId: state.conversationId
+				});
+				await applyOnStepFinish({
+					runId: state.runId,
+					agentName: state.agentName,
+					stepIndex: state.stepIndex,
+					maxSteps: state.maxSteps,
+					result: stepResult,
+					conversationId: state.conversationId,
+					context: options.context,
+					onStepFinish: options.agent.onStepFinish
+				});
+				if (stopDecision.stop) return {
+					response,
+					items: state.items
+				};
+				state.stepIndex += 1;
+			} catch (error) {
+				const wrapped = error instanceof BetterAgentError ? error.at({ at: traceBase }) : BetterAgentError.wrap({
+					err: error,
+					message: stepErrorMessage,
+					opts: {
+						code: "INTERNAL",
+						trace: [{ at: traceBase }]
+					}
+				});
+				await options.emit({
+					type: Events.STEP_ERROR,
+					runId: state.runId,
+					agentName: state.agentName,
+					stepIndex: state.stepIndex,
+					maxSteps: state.maxSteps,
+					error: wrapped,
+					timestamp: Date.now(),
+					conversationId: state.conversationId
+				});
+				throw wrapped;
+			}
+		}
+	} finally {
+		await runCleanup();
+		await pluginToolsResult.runCleanup();
+	}
+};
+
+//#endregion
+export { runAgentLoop };
+//# sourceMappingURL=agent-loop.mjs.map

package/dist/run/agent-loop.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.mjs","names":[],"sources":["../../src/run/agent-loop.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { Events } from \"../events\";\nimport type { GenerativeModelInputMessage, GenerativeModelInputMessageContent } from \"../providers\";\nimport type { ConversationItem } from \"../providers\";\nimport { resolveToolsForRun } from \"../tools\";\nimport { executeToolCalls } from \"./execute-tool-calls\";\nimport { prepareConversationReplayInput } from \"./helpers\";\nimport { applyAfterModelCall, applyBeforeModelCall, applyOnStep, applyOnStepFinish } from \"./hooks\";\nimport { projectConversationItemsToInput } from \"./messages\";\nimport {\n    type LoopStopDecision,\n    evaluateStopConditions,\n    extractToolCallRequests,\n} from \"./stop-conditions\";\nimport type {\n    LoopState,\n    ModelCallStrategy,\n    PreviousStepResult,\n    RunResult,\n    SharedRunLoopOptions,\n} from \"./types\";\n\nexport const runAgentLoop = async <TContext>(\n    options: SharedRunLoopOptions<TContext>,\n    strategy: ModelCallStrategy<TContext>,\n): Promise<RunResult & { items: ConversationItem[] }> => {\n    const traceBase = strategy.mode === \"stream\" ? \"core.run.runStreamLoop\" : \"core.run.runLoop\";\n\n    // Resolve plugin tools.\n    const pluginToolsResult =\n        options.pluginRuntime?.hasTools === true\n            ? await options.pluginRuntime.resolveTools(options.context)\n            : {\n                  tools: [],\n                  runCleanup: async () => {},\n              };\n\n    // Resolve agent tools.\n    const { tools, runCleanup } = await resolveToolsForRun({\n        appTools: options.appTools,\n        agentTools: options.agent.tools,\n        context: options.context,\n    });\n\n    const resolvedTools = [...tools, ...pluginToolsResult.tools];\n\n    if (strategy.mode === \"run\") {\n        const blockingTool = resolvedTools.find(\n            (tool) =>\n                tool.kind === \"client\" || (tool.kind !== \"hosted\" && tool.approval !== undefined),\n        );\n\n        if (blockingTool) {\n            const reason =\n                blockingTool.kind === \"client\"\n                    ? `client tool '${blockingTool.name}'`\n                    : `approval-gated tool '${blockingTool.name}'`;\n\n            throw BetterAgentError.fromCode(\n                \"BAD_REQUEST\",\n                `Non-stream runs do not support interactive tools. Use stream() for ${reason}.`,\n                {\n                    context: {\n                        agentName: options.agent.name,\n                        toolName: blockingTool.name,\n                        toolTarget: blockingTool.kind,\n                    },\n                    trace: [{ at: `${traceBase}.validateNonInteractiveRun` }],\n                },\n            );\n        }\n    }\n\n    const state: LoopState<TContext> = {\n        runId: options.runId,\n        agentName: options.agent.name,\n        items: [...options.items],\n        replayStartIndex: options.replayStartIndex ?? 0,\n        steps: [],\n        stepIndex: 0,\n        maxSteps: options.maxSteps,\n        conversationId: options.conversationId,\n        context: options.context,\n    };\n\n    const instructionField = \"instruction\" in options.agent ? options.agent.instruction : undefined;\n    const instructionResolver = instructionField as ((context: TContext) => string) | undefined;\n    const instruction =\n        typeof instructionResolver === \"function\"\n            ? instructionResolver(options.context as TContext)\n            : (instructionField ?? \"\");\n\n    const modelCaps = options.agent.model.caps;\n\n    const assertInstructionSupported = (\n        currentInstruction: GenerativeModelInputMessageContent<typeof modelCaps> | undefined,\n        traceAt: string,\n    ): void => {\n        if (currentInstruction === undefined || currentInstruction === \"\") {\n            return;\n        }\n\n        if (modelCaps.inputShape === \"prompt\" || modelCaps.supportsInstruction !== true) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                `Agent '${options.agent.name}' model does not support instructions.`,\n                {\n                    context: {\n                        agentName: options.agent.name,\n                        modelId: options.agent.model.modelId,\n                        inputShape: modelCaps.inputShape ?? \"chat\",\n                        replayMode:\n                            modelCaps.replayMode ??\n                            (modelCaps.inputShape === \"prompt\"\n                                ? \"single_turn_persistent\"\n                                : \"multi_turn\"),\n                    },\n                    trace: [{ at: traceAt }],\n                },\n            );\n        }\n    };\n\n    assertInstructionSupported(instruction, `${traceBase}.validateInstruction`);\n\n    const stepErrorMessage =\n        strategy.mode === \"stream\" ? \"Run stream step failed\" : \"Run loop step failed\";\n\n    try {\n        while (true) {\n            const previousStep = state.steps.at(-1);\n            const replayItems = state.items.slice(state.replayStartIndex);\n            const projectedMessages =\n                state.conversationId !== undefined && options.conversationReplayActive\n                    ? await prepareConversationReplayInput({\n                          items: replayItems,\n                          caps: modelCaps,\n                          agentName: state.agentName,\n                          conversationId: state.conversationId,\n                          conversationReplay: options.conversationReplay,\n                      })\n                    : projectConversationItemsToInput(replayItems, modelCaps);\n            const prepared = await applyOnStep({\n                runId: state.runId,\n                agentName: state.agentName,\n                stepIndex: state.stepIndex,\n                maxSteps: state.maxSteps,\n                messages: projectedMessages,\n                modelCaps,\n                conversationId: state.conversationId,\n                context: options.context,\n                previousStep,\n                onStep: options.agent.onStep,\n                pluginRuntime: options.pluginRuntime,\n            });\n\n            await options.emit({\n                type: Events.STEP_START,\n                runId: state.runId,\n                agentName: state.agentName,\n                stepIndex: state.stepIndex,\n                maxSteps: state.maxSteps,\n                timestamp: Date.now(),\n                conversationId: state.conversationId,\n            });\n\n            try {\n                const activeToolNames = prepared.activeTools;\n                const activeTools =\n                    activeToolNames === undefined\n                        ? resolvedTools\n                        : resolvedTools.filter((tool) =>\n                              activeToolNames.includes(\n                                  tool.kind === \"hosted\"\n                                      ? typeof tool.name === \"string\" && tool.name.length > 0\n                                          ? tool.name\n                                          : tool.type\n                                      : tool.name,\n                              ),\n                          );\n\n                const effectiveInstruction = (prepared.systemInstruction ?? instruction) as\n                    | GenerativeModelInputMessageContent<typeof modelCaps>\n                    | undefined;\n                assertInstructionSupported(\n                    effectiveInstruction,\n                    `${traceBase}.prepareModelInput.validateInstruction`,\n                );\n                const modelInput =\n                    effectiveInstruction === undefined || effectiveInstruction === \"\"\n                        ? [...prepared.messages]\n                        : [\n                              {\n                                  type: \"message\",\n                                  role: \"system\",\n                                  content: effectiveInstruction,\n                              } as GenerativeModelInputMessage<typeof modelCaps>,\n                              ...prepared.messages,\n                          ];\n\n                const modelPrepared = await applyBeforeModelCall({\n                    runId: state.runId,\n                    agentName: state.agentName,\n                    stepIndex: state.stepIndex,\n                    modelCaps,\n                    input: modelInput,\n                    tools: activeTools,\n                    conversationId: state.conversationId,\n                    toolChoice: prepared.toolChoice ?? options.toolChoice,\n                    pluginRuntime: options.pluginRuntime,\n                });\n\n                const { response, assistantMessageId } = await strategy.call({\n                    options,\n                    modelInput: modelPrepared.input,\n                    tools: modelPrepared.tools,\n                    toolChoice: modelPrepared.toolChoice,\n                    stepIndex: state.stepIndex,\n                    runId: state.runId,\n                    agentName: state.agentName,\n                    conversationId: state.conversationId,\n                });\n\n                await applyAfterModelCall({\n                    runId: state.runId,\n                    agentName: state.agentName,\n                    stepIndex: state.stepIndex,\n                    response,\n                    conversationId: state.conversationId,\n                    pluginRuntime: options.pluginRuntime,\n                });\n\n                const toolCalls = extractToolCallRequests(response);\n                const toolBatch =\n                    toolCalls.length > 0\n                        ? await executeToolCalls({\n                              runId: state.runId,\n                              agentName: state.agentName,\n                              conversationId: state.conversationId,\n                              parentMessageId: assistantMessageId,\n                              toolCalls,\n                              tools: modelPrepared.tools,\n                              toolErrorMode: options.agent.toolErrorMode,\n                              onToolError: options.agent.onToolError,\n                              signal: options.signal,\n                              emit: options.emit,\n                              advanced: options.advanced,\n                              pendingToolRuntime: options.pendingToolRuntime,\n                              context: options.context,\n                              pluginRuntime: options.pluginRuntime,\n                          })\n                        : { results: [] };\n\n                state.items = [...state.items, ...response.output];\n                if (toolBatch.results.length > 0) {\n                    state.items = [...state.items, ...toolBatch.results];\n                }\n\n                const stepResult: PreviousStepResult = { response };\n                state.steps.push(stepResult);\n\n                const stopMessages =\n                    state.conversationId !== undefined && options.conversationReplayActive\n                        ? await prepareConversationReplayInput({\n                              items: state.items.slice(state.replayStartIndex),\n                              caps: modelCaps,\n                              agentName: state.agentName,\n                              conversationId: state.conversationId,\n                              conversationReplay: options.conversationReplay,\n                          })\n                        : projectConversationItemsToInput(\n                              state.items.slice(state.replayStartIndex),\n                              modelCaps,\n                          );\n\n                const stopDecision: LoopStopDecision = evaluateStopConditions({\n                    maxSteps: state.maxSteps,\n                    stepIndex: state.stepIndex,\n                    steps: state.steps,\n                    messages: stopMessages,\n                    lastStep: stepResult,\n                    stopWhen: options.agent.stopWhen,\n                    context: options.context,\n                });\n\n                await options.emit({\n                    type: Events.STEP_FINISH,\n                    runId: state.runId,\n                    agentName: state.agentName,\n                    stepIndex: state.stepIndex,\n                    maxSteps: state.maxSteps,\n                    toolCallCount: toolCalls.length,\n                    terminationReason: stopDecision.stop ? stopDecision.reason : undefined,\n                    timestamp: Date.now(),\n                    conversationId: state.conversationId,\n                });\n\n                await applyOnStepFinish({\n                    runId: state.runId,\n                    agentName: state.agentName,\n                    stepIndex: state.stepIndex,\n                    maxSteps: state.maxSteps,\n                    result: stepResult,\n                    conversationId: state.conversationId,\n                    context: options.context,\n                    onStepFinish: options.agent.onStepFinish,\n                });\n\n                if (stopDecision.stop) {\n                    return {\n                        response,\n                        items: state.items,\n                    };\n                }\n\n                state.stepIndex += 1;\n            } catch (error) {\n                const wrapped =\n                    error instanceof BetterAgentError\n                        ? error.at({ at: traceBase })\n                        : BetterAgentError.wrap({\n                              err: error,\n                              message: stepErrorMessage,\n                              opts: {\n                                  code: \"INTERNAL\",\n                                  trace: [{ at: traceBase }],\n                              },\n                          });\n                await options.emit({\n                    type: Events.STEP_ERROR,\n                    runId: state.runId,\n                    agentName: state.agentName,\n                    stepIndex: state.stepIndex,\n                    maxSteps: state.maxSteps,\n                    error: wrapped,\n                    timestamp: Date.now(),\n                    conversationId: state.conversationId,\n                });\n                throw wrapped;\n            }\n        }\n    } finally {\n        await runCleanup();\n        await pluginToolsResult.runCleanup();\n    }\n};\n"],"mappings":"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"}