@better-agent/core 0.1.0-beta.1

package/dist/events/types.d.mts

@@ -0,0 +1,289 @@
+import { EventName, Events } from "./constants.mjs";
+import { ToolApprovalState, ToolErrorPayload, ToolTarget } from "../tools/types.mjs";
+import { RunResult } from "../run/types.mjs";
+//#region src/events/types.d.ts
+/**
+ * Minimal serializable error shape used in runtime events.
+ */
+interface BetterAgentErrorLike {
+  name: string;
+  message: string;
+  code?: string;
+  cause?: unknown;
+}
+/**
+ * Message role used in streamed events.
+ */
+type Role = "system" | "assistant" | "user" | (string & {});
+/** Visibility level for reasoning output. */
+type ReasoningVisibility = "summary" | "full";
+/** Reason a loop step stopped the run. */
+type StepTerminationReason = "no_tool_calls" | "stop_when" | "max_steps";
+/**
+ * Base shape shared by all runtime events.
+ */
+interface BaseEvent {
+  type: EventName;
+  timestamp: number;
+}
+interface RunStartedEvent extends BaseEvent {
+  type: typeof Events.RUN_STARTED;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+  runInput: Record<string, unknown>;
+}
+interface RunFinishedEvent extends BaseEvent {
+  type: typeof Events.RUN_FINISHED;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+  result: RunResult;
+}
+interface RunErrorEvent extends BaseEvent {
+  type: typeof Events.RUN_ERROR;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+  error: BetterAgentErrorLike;
+}
+interface RunAbortedEvent extends BaseEvent {
+  type: typeof Events.RUN_ABORTED;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+}
+interface DataPartEvent extends BaseEvent {
+  type: typeof Events.DATA_PART;
+  id?: string;
+  data: unknown;
+}
+interface StepStartEvent extends BaseEvent {
+  type: typeof Events.STEP_START;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+  stepIndex: number;
+  maxSteps: number | undefined;
+}
+interface StepFinishEvent extends BaseEvent {
+  type: typeof Events.STEP_FINISH;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+  stepIndex: number;
+  maxSteps: number | undefined;
+  toolCallCount: number;
+  /** Present only when this finished step also ended the loop. */
+  terminationReason?: StepTerminationReason;
+}
+interface StepErrorEvent extends BaseEvent {
+  type: typeof Events.STEP_ERROR;
+  runId: string;
+  agentName: string;
+  conversationId?: string;
+  stepIndex: number;
+  maxSteps: number | undefined;
+  error: BetterAgentErrorLike;
+}
+interface ToolCallStartEvent extends BaseEvent {
+  type: typeof Events.TOOL_CALL_START;
+  runId: string;
+  agentName: string;
+  parentMessageId: string;
+  toolCallId: string;
+  toolCallName: string;
+  toolTarget: ToolTarget;
+}
+interface ToolCallArgsEvent extends BaseEvent {
+  type: typeof Events.TOOL_CALL_ARGS;
+  runId: string;
+  agentName: string;
+  parentMessageId: string;
+  toolCallId: string;
+  toolCallName: string;
+  delta: string;
+  toolTarget: ToolTarget;
+}
+interface ToolCallEndEvent extends BaseEvent {
+  type: typeof Events.TOOL_CALL_END;
+  runId: string;
+  agentName: string;
+  parentMessageId: string;
+  toolCallId: string;
+  toolCallName: string;
+  toolTarget: ToolTarget;
+}
+interface ToolCallResultEvent extends BaseEvent {
+  type: typeof Events.TOOL_CALL_RESULT;
+  runId: string;
+  agentName: string;
+  parentMessageId: string;
+  toolCallId: string;
+  toolCallName: string;
+  result: unknown;
+  isError?: boolean;
+  errorKind?: ToolErrorPayload["errorKind"];
+  toolTarget: ToolTarget;
+}
+interface ToolApprovalRequiredEvent extends BaseEvent {
+  type: typeof Events.TOOL_APPROVAL_REQUIRED;
+  runId: string;
+  agentName: string;
+  parentMessageId: string;
+  toolCallId: string;
+  toolCallName: string;
+  toolTarget: ToolTarget;
+  toolInput: unknown;
+  state: "requested";
+  meta?: Record<string, unknown>;
+}
+interface ToolApprovalUpdatedEvent extends BaseEvent {
+  type: typeof Events.TOOL_APPROVAL_UPDATED;
+  runId: string;
+  agentName: string;
+  parentMessageId: string;
+  toolCallId: string;
+  toolCallName: string;
+  toolTarget: ToolTarget;
+  state: ToolApprovalState;
+  toolInput: unknown;
+  meta?: Record<string, unknown>;
+  note?: string;
+  actorId?: string;
+}
+interface TextMessageStartEvent extends BaseEvent {
+  type: typeof Events.TEXT_MESSAGE_START;
+  messageId: string;
+  role: Role;
+}
+interface TextMessageContentEvent extends BaseEvent {
+  type: typeof Events.TEXT_MESSAGE_CONTENT;
+  messageId: string;
+  delta: string;
+}
+interface TextMessageEndEvent extends BaseEvent {
+  type: typeof Events.TEXT_MESSAGE_END;
+  messageId: string;
+}
+interface ImageMessageStartEvent extends BaseEvent {
+  type: typeof Events.IMAGE_MESSAGE_START;
+  messageId: string;
+  role: Role;
+}
+interface ImageMessageContentEvent extends BaseEvent {
+  type: typeof Events.IMAGE_MESSAGE_CONTENT;
+  messageId: string;
+  delta: {
+    kind: "url";
+    url: string;
+  } | {
+    kind: "base64";
+    data: string;
+    mimeType: string;
+  };
+}
+interface ImageMessageEndEvent extends BaseEvent {
+  type: typeof Events.IMAGE_MESSAGE_END;
+  messageId: string;
+}
+interface VideoMessageStartEvent extends BaseEvent {
+  type: typeof Events.VIDEO_MESSAGE_START;
+  messageId: string;
+  role: Role;
+}
+interface VideoMessageContentEvent extends BaseEvent {
+  type: typeof Events.VIDEO_MESSAGE_CONTENT;
+  messageId: string;
+  delta: {
+    kind: "url";
+    url: string;
+  } | {
+    kind: "base64";
+    data: string;
+    mimeType: string;
+  };
+}
+interface VideoMessageEndEvent extends BaseEvent {
+  type: typeof Events.VIDEO_MESSAGE_END;
+  messageId: string;
+}
+interface AudioMessageStartEvent extends BaseEvent {
+  type: typeof Events.AUDIO_MESSAGE_START;
+  messageId: string;
+  role: Role;
+}
+interface AudioMessageContentEvent extends BaseEvent {
+  type: typeof Events.AUDIO_MESSAGE_CONTENT;
+  messageId: string;
+  delta: {
+    kind: "base64";
+    data: string;
+    mimeType: string;
+  };
+}
+interface AudioMessageEndEvent extends BaseEvent {
+  type: typeof Events.AUDIO_MESSAGE_END;
+  messageId: string;
+}
+interface TranscriptMessageStartEvent extends BaseEvent {
+  type: typeof Events.TRANSCRIPT_MESSAGE_START;
+  messageId: string;
+  role: Role;
+}
+interface TranscriptMessageContentEvent extends BaseEvent {
+  type: typeof Events.TRANSCRIPT_MESSAGE_CONTENT;
+  messageId: string;
+  delta: string;
+}
+interface TranscriptMessageSegmentEvent extends BaseEvent {
+  type: typeof Events.TRANSCRIPT_MESSAGE_SEGMENT;
+  messageId: string;
+  segment: {
+    id: string;
+    start: number;
+    end: number;
+    text: string;
+    speaker?: string;
+  };
+}
+interface TranscriptMessageEndEvent extends BaseEvent {
+  type: typeof Events.TRANSCRIPT_MESSAGE_END;
+  messageId: string;
+}
+interface ReasoningMessageStartEvent extends BaseEvent {
+  type: typeof Events.REASONING_MESSAGE_START;
+  messageId: string;
+  role: Role;
+  visibility: ReasoningVisibility;
+}
+interface ReasoningMessageContentEvent extends BaseEvent {
+  type: typeof Events.REASONING_MESSAGE_CONTENT;
+  messageId: string;
+  visibility: ReasoningVisibility;
+  delta: string;
+}
+interface ReasoningMessageEndEvent extends BaseEvent {
+  type: typeof Events.REASONING_MESSAGE_END;
+  messageId: string;
+  visibility: ReasoningVisibility;
+}
+interface EmbeddingMessageStartEvent extends BaseEvent {
+  type: typeof Events.EMBEDDING_MESSAGE_START;
+  messageId: string;
+  role: Role;
+}
+interface EmbeddingMessageContentEvent extends BaseEvent {
+  type: typeof Events.EMBEDDING_MESSAGE_CONTENT;
+  messageId: string;
+  delta: number[];
+}
+interface EmbeddingMessageEndEvent extends BaseEvent {
+  type: typeof Events.EMBEDDING_MESSAGE_END;
+  messageId: string;
+}
+type ModelEvent = TextMessageStartEvent | TextMessageContentEvent | TextMessageEndEvent | ImageMessageStartEvent | ImageMessageContentEvent | ImageMessageEndEvent | VideoMessageStartEvent | VideoMessageContentEvent | VideoMessageEndEvent | AudioMessageStartEvent | AudioMessageContentEvent | AudioMessageEndEvent | TranscriptMessageStartEvent | TranscriptMessageContentEvent | TranscriptMessageSegmentEvent | TranscriptMessageEndEvent | ReasoningMessageStartEvent | ReasoningMessageContentEvent | ReasoningMessageEndEvent | EmbeddingMessageStartEvent | EmbeddingMessageContentEvent | EmbeddingMessageEndEvent | ToolCallStartEvent | ToolCallArgsEvent | ToolCallEndEvent | ToolCallResultEvent;
+type Event = RunStartedEvent | RunFinishedEvent | RunErrorEvent | RunAbortedEvent | DataPartEvent | StepStartEvent | StepFinishEvent | StepErrorEvent | ToolApprovalRequiredEvent | ToolApprovalUpdatedEvent | ModelEvent;
+//#endregion
+export { AudioMessageContentEvent, AudioMessageEndEvent, AudioMessageStartEvent, BaseEvent, BetterAgentErrorLike, DataPartEvent, EmbeddingMessageContentEvent, EmbeddingMessageEndEvent, EmbeddingMessageStartEvent, Event, ImageMessageContentEvent, ImageMessageEndEvent, ImageMessageStartEvent, ModelEvent, ReasoningMessageContentEvent, ReasoningMessageEndEvent, ReasoningMessageStartEvent, ReasoningVisibility, Role, RunAbortedEvent, RunErrorEvent, RunFinishedEvent, RunStartedEvent, StepErrorEvent, StepFinishEvent, StepStartEvent, StepTerminationReason, TextMessageContentEvent, TextMessageEndEvent, TextMessageStartEvent, ToolApprovalRequiredEvent, ToolApprovalUpdatedEvent, ToolCallArgsEvent, ToolCallEndEvent, ToolCallResultEvent, ToolCallStartEvent, TranscriptMessageContentEvent, TranscriptMessageEndEvent, TranscriptMessageSegmentEvent, TranscriptMessageStartEvent, VideoMessageContentEvent, VideoMessageEndEvent, VideoMessageStartEvent };
+//# sourceMappingURL=types.d.mts.map

package/dist/events/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/events/types.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -0,0 +1,23 @@
+import { AnyStandardSchemaV1, InferSchemaInput, InferStandardInput, ResolvableSchema, StandardSchema, ValidatableSchema } from "./schema/types.mjs";
+import { resolveToJsonSchema, validateInput } from "./schema/resolve-json-schema.mjs";
+import { TOOL_CLEANUP, TOOL_JSON_SCHEMA } from "./tools/constants.mjs";
+import { AgentToolDefinition, ClientToolDefinition, ExecutionToolError, ExecutionToolErrorResult, HostedToolDefinition, LazyToolLoader, LazyToolSource, LazyToolSourceResult, OnToolError, OpenString, ParseToolError, ParseToolErrorResult, RepairAction, ResultAction, RetryAction, SendToModelAction, ServerToolDefinition, SkipAction, ThrowAction, ToolApprovalConfig, ToolApprovalDecision, ToolApprovalState, ToolContract, ToolContractConfig, ToolDefinitionTarget, ToolErrorBase, ToolErrorContext, ToolErrorMode, ToolErrorPayload, ToolHandler, ToolListFactory, ToolNameOf, ToolNamesOf, ToolRunContext, ToolSource, ToolSourceResult, ToolTarget, ValidationToolError, ValidationToolErrorResult } from "./tools/types.mjs";
+import { defineTool } from "./tools/define-tool.mjs";
+import { lazyTools } from "./tools/lazy-tools.mjs";
+import { isCallableToolDefinition } from "./tools/resolve-tools.mjs";
+import { GenerativeModel } from "./providers/types/model.mjs";
+import { AgentContext, AgentContextFromSchema, AgentDefinition, AgentInstruction, AgentKnownToolName, AgentModelCaps, AgentModelOptions, AgentOnStep, AgentOnStepFinish, AgentOutputSchema, AgentStructuredOutput, AgentTools, AnyAgentDefinition } from "./agent/types.mjs";
+import { defineAgent } from "./agent/define-agent.mjs";
+import { ConversationCursor, ConversationRunStatus, ConversationRuntimeState, ConversationRuntimeStateStore, ConversationStore, InMemoryStreamStoreOptions, LoadConversationParams, LoadedConversation, SaveConversationParams, SaveConversationResult, StreamEvent, StreamStore } from "./persistence/types.mjs";
+import { createMemoryConversationRuntimeStateStore, createMemoryConversationStore, createMemoryStreamStore } from "./persistence/memory.mjs";
+import { Plugin, PluginBaseContext, PluginEndpoint, PluginEndpointHandler, PluginEventContext, PluginEventMiddleware, PluginGuard, PluginGuardMode, PluginModelCallContext, PluginModelResponseContext, PluginOnStepContext, PluginRunContext, PluginRuntime, PluginRuntimeEndpoint, PluginSaveContext, PluginToolCallContext, PluginToolCallDecision, PluginToolResultContext } from "./plugins/types.mjs";
+import { definePlugin } from "./plugins/runtime.mjs";
+import { BetterAgentRuntime, ConversationReplayOptions, OnStepContext, OnStepFinishContext, PreviousStepResult, ResumeConversationOptions, ResumeStreamOptions, RunAdvancedOptions, RunContext, RunOptions, RunOptionsForAgent, RunOutputOverrideForAgent, RunPersistenceOptions, RunResult, RunResultForAgent, StopWhen, StopWhenContext, StreamResult, StreamResultForAgent, SubmitToolApprovalParams, SubmitToolResultParams } from "./run/types.mjs";
+import { createRuntime } from "./run/runtime.mjs";
+import { pruneInputByCapabilities } from "./run/messages.mjs";
+import { MissingTextOutputError, OnOutputError, OutputErrorBase, OutputErrorContext, OutputErrorMode, OutputErrorResult, ParseOutputError, RepairTextOutputAction, RepairValueOutputAction, SkipOutputAction, ThrowOutputAction, ValidationOutputError } from "./run/output-errors.mjs";
+import { AppRunInput, AppRunOptions, AppStreamOptions, BetterAgentAdvancedConfig, BetterAgentApp, BetterAgentConfig, BetterAgentHandler } from "./app/types.mjs";
+import { betterAgent } from "./app/create-app.mjs";
+import { BetterAgentServer, CreateServerConfig } from "./server/types.mjs";
+import { createServer } from "./server/create-server.mjs";
+export { type AgentContext, type AgentContextFromSchema, type AgentDefinition, type AgentInstruction, type AgentKnownToolName, type AgentModelCaps, type AgentModelOptions, type AgentOnStep, type AgentOnStepFinish, type AgentOutputSchema, type AgentStructuredOutput, type AgentToolDefinition, type AgentTools, type AnyAgentDefinition, type AnyStandardSchemaV1, type AppRunInput, type AppRunOptions, type AppStreamOptions, type BetterAgentAdvancedConfig, type BetterAgentApp, type BetterAgentConfig, type BetterAgentHandler, type BetterAgentRuntime, type BetterAgentServer, type ClientToolDefinition, type ConversationCursor, type ConversationReplayOptions, type ConversationRunStatus, type ConversationRuntimeState, type ConversationRuntimeStateStore, type ConversationStore, type CreateServerConfig, type ExecutionToolError, type ExecutionToolErrorResult, type GenerativeModel, type HostedToolDefinition, InMemoryStreamStoreOptions, type InferSchemaInput, type InferStandardInput, type LazyToolLoader, type LazyToolSource, type LazyToolSourceResult, LoadConversationParams, type LoadedConversation, type MissingTextOutputError, type OnOutputError, type OnStepContext, type OnStepFinishContext, type OnToolError, type OpenString, type OutputErrorBase, type OutputErrorContext, type OutputErrorMode, type OutputErrorResult, type ParseOutputError, type ParseToolError, type ParseToolErrorResult, type Plugin, type PluginBaseContext, type PluginEndpoint, type PluginEndpointHandler, type PluginEventContext, type PluginEventMiddleware, type PluginGuard, type PluginGuardMode, type PluginModelCallContext, type PluginModelResponseContext, type PluginOnStepContext, type PluginRunContext, type PluginRuntime, type PluginRuntimeEndpoint, type PluginSaveContext, type PluginToolCallContext, type PluginToolCallDecision, type PluginToolResultContext, type PreviousStepResult, type RepairAction, type RepairTextOutputAction, type RepairValueOutputAction, type ResolvableSchema, type ResultAction, type ResumeConversationOptions, type ResumeStreamOptions, type RetryAction, type RunAdvancedOptions, type RunContext, type RunOptions, type RunOptionsForAgent, type RunOutputOverrideForAgent, type RunPersistenceOptions, type RunResult, type RunResultForAgent, type SaveConversationParams, type SaveConversationResult, type SendToModelAction, type ServerToolDefinition, type SkipAction, type SkipOutputAction, type StandardSchema, type StopWhen, type StopWhenContext, type StreamEvent, type StreamResult, type StreamResultForAgent, type StreamStore, type SubmitToolApprovalParams, type SubmitToolResultParams, TOOL_CLEANUP, TOOL_JSON_SCHEMA, type ThrowAction, type ThrowOutputAction, type ToolApprovalConfig, type ToolApprovalDecision, type ToolApprovalState, type ToolContract, type ToolContractConfig, type ToolDefinitionTarget, type ToolErrorBase, type ToolErrorContext, type ToolErrorMode, type ToolErrorPayload, type ToolHandler, type ToolListFactory, type ToolNameOf, type ToolNamesOf, type ToolRunContext, type ToolSource, type ToolSourceResult, type ToolTarget, type ValidatableSchema, type ValidationOutputError, type ValidationToolError, type ValidationToolErrorResult, betterAgent, createMemoryConversationRuntimeStateStore, createMemoryConversationStore, createMemoryStreamStore, createRuntime, createServer, defineAgent, definePlugin, defineTool, isCallableToolDefinition, lazyTools, pruneInputByCapabilities, resolveToJsonSchema, validateInput };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+import { resolveToJsonSchema, validateInput } from "./schema/resolve-json-schema.mjs";
+import { defineAgent } from "./agent/define-agent.mjs";
+import { TOOL_CLEANUP, TOOL_JSON_SCHEMA } from "./tools/constants.mjs";
+import { defineTool } from "./tools/define-tool.mjs";
+import { lazyTools } from "./tools/lazy-tools.mjs";
+import { isCallableToolDefinition } from "./tools/resolve-tools.mjs";
+import { definePlugin } from "./plugins/runtime.mjs";
+import { pruneInputByCapabilities } from "./run/messages.mjs";
+import { createRuntime } from "./run/runtime.mjs";
+import { createServer } from "./server/create-server.mjs";
+import { betterAgent } from "./app/create-app.mjs";
+import { createMemoryConversationRuntimeStateStore, createMemoryConversationStore, createMemoryStreamStore } from "./persistence/memory.mjs";
+
+export { TOOL_CLEANUP, TOOL_JSON_SCHEMA, betterAgent, createMemoryConversationRuntimeStateStore, createMemoryConversationStore, createMemoryStreamStore, createRuntime, createServer, defineAgent, definePlugin, defineTool, isCallableToolDefinition, lazyTools, pruneInputByCapabilities, resolveToJsonSchema, validateInput };

package/dist/internal/id.mjs

@@ -0,0 +1,21 @@
+//#region src/internal/id.ts
+/**
+* Creates an ID generator.
+*
+* IDs look like `<prefix>_<ts>_<counter>_<random>`, for example:
+* `agent_m8x2k1f9_0001_a1b2c3d4`.
+*/
+const createIdGenerator = (config) => {
+	let counter = 0;
+	const counterMax = config.counterMax ?? 1e6;
+	const prefixes = config.prefixes ?? {};
+	return (kind) => {
+		const prefix = prefixes[kind] ?? kind;
+		counter = (counter + 1) % counterMax;
+		return `${prefix}_${Date.now().toString(36)}_${counter.toString(36).padStart(4, "0")}_${Math.random().toString(36).slice(2, 10)}`;
+	};
+};
+
+//#endregion
+export { createIdGenerator };
+//# sourceMappingURL=id.mjs.map

package/dist/internal/id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.mjs","names":[],"sources":["../../src/internal/id.ts"],"sourcesContent":["/**\n * Creates an ID generator.\n *\n * IDs look like `<prefix>_<ts>_<counter>_<random>`, for example:\n * `agent_m8x2k1f9_0001_a1b2c3d4`.\n */\nexport const createIdGenerator = (config: {\n    prefixes?: Record<string, string>;\n    counterMax?: number;\n}): ((kind: string) => string) => {\n    let counter = 0;\n    const counterMax = config.counterMax ?? 1_000_000;\n    const prefixes = config.prefixes ?? {};\n\n    return (kind: string) => {\n        const prefix = prefixes[kind] ?? kind;\n        counter = (counter + 1) % counterMax;\n\n        const ts = Date.now().toString(36);\n        const cnt = counter.toString(36).padStart(4, \"0\");\n        const rand = Math.random().toString(36).slice(2, 10);\n\n        return `${prefix}_${ts}_${cnt}_${rand}`;\n    };\n};\n"],"mappings":";;;;;;;AAMA,MAAa,qBAAqB,WAGA;CAC9B,IAAI,UAAU;CACd,MAAM,aAAa,OAAO,cAAc;CACxC,MAAM,WAAW,OAAO,YAAY,EAAE;AAEtC,SAAQ,SAAiB;EACrB,MAAM,SAAS,SAAS,SAAS;AACjC,aAAW,UAAU,KAAK;AAM1B,SAAO,GAAG,OAAO,GAJN,KAAK,KAAK,CAAC,SAAS,GAAG,CAIX,GAHX,QAAQ,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI,CAGnB,GAFjB,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,GAAG"}

package/dist/internal/types.d.mts

@@ -0,0 +1,11 @@
+//#region src/internal/types.d.ts
+type Awaitable<T> = T | Promise<T>;
+type BivariantFn<TArgs extends readonly unknown[], TReturn> = {
+  bivarianceHack(...args: TArgs): TReturn;
+}["bivarianceHack"];
+type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends ((k: infer I) => void) ? I : never;
+type IsAny<T> = 0 extends 1 & T ? true : false;
+type StripIndex<T> = { [K in keyof T as string extends K ? never : number extends K ? never : symbol extends K ? never : K]: T[K] };
+//#endregion
+export { Awaitable, BivariantFn, IsAny, StripIndex, UnionToIntersection };
+//# sourceMappingURL=types.d.mts.map

package/dist/internal/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/internal/types.ts"],"mappings":";KAAY,SAAA,MAAe,CAAA,GAAI,OAAA,CAAQ,CAAA;AAAA,KAE3B,WAAA;EACR,cAAA,IAAkB,IAAA,EAAM,KAAA,GAAQ,OAAA;AAAA;AAAA,KAGxB,mBAAA,OAA0B,CAAA,oBAAqB,CAAA,EAAG,CAAA,6BAC1D,CAAA,sBAEE,CAAA;AAAA,KAGM,KAAA,oBAAyB,CAAA;AAAA,KAEzB,UAAA,oBACI,CAAA,mBAAoB,CAAA,0BAEX,CAAA,0BAEE,CAAA,WAEb,CAAA,GAAI,CAAA,CAAE,CAAA"}

package/dist/mcp/error/mcp-client-error.d.mts

@@ -0,0 +1,36 @@
+import { BetterAgentError, BetterAgentErrorContext } from "@better-agent/shared/errors";
+
+//#region src/mcp/error/mcp-client-error.d.ts
+/**
+ * MCP client error.
+ */
+declare class MCPClientError extends BetterAgentError {
+  /** Additional error data from the MCP server. */
+  readonly data?: unknown;
+  /** JSON-RPC error code, when present. */
+  readonly jsonRpcCode: number | undefined;
+  constructor({
+    message,
+    cause,
+    data,
+    jsonRpcCode,
+    context,
+    trace
+  }: {
+    message: string;
+    cause?: unknown;
+    data?: unknown;
+    jsonRpcCode?: number;
+    context?: BetterAgentErrorContext;
+    trace?: Array<{
+      at: string;
+    }>;
+  });
+  /**
+   * Type guard for `MCPClientError`.
+   */
+  static isInstance(error: unknown): error is MCPClientError;
+}
+//#endregion
+export { MCPClientError };
+//# sourceMappingURL=mcp-client-error.d.mts.map

package/dist/mcp/error/mcp-client-error.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-error.d.mts","names":[],"sources":["../../../src/mcp/error/mcp-client-error.ts"],"mappings":";;;;;AAKA;cAAa,cAAA,SAAuB,gBAAA;;WAEvB,IAAA;EAOL;EAAA,SAJK,WAAA;;IAGL,OAAA;IACA,KAAA;IACA,IAAA;IACA,WAAA;IACA,OAAA;IACA;EAAA;IAEA,OAAA;IACA,KAAA;IACA,IAAA;IACA,WAAA;IACA,OAAA,GAAU,uBAAA;IACV,KAAA,GAAQ,KAAA;MAAQ,EAAA;IAAA;EAAA;EAlBX;;;EAAA,OAmCF,UAAA,CAAW,KAAA,YAAiB,KAAA,IAAS,cAAA;AAAA"}

package/dist/mcp/error/mcp-client-error.mjs

@@ -0,0 +1,33 @@
+import { BetterAgentError } from "@better-agent/shared/errors";
+
+//#region src/mcp/error/mcp-client-error.ts
+/**
+* MCP client error.
+*/
+var MCPClientError = class MCPClientError extends BetterAgentError {
+	/** Additional error data from the MCP server. */
+	data;
+	/** JSON-RPC error code, when present. */
+	jsonRpcCode;
+	constructor({ message, cause, data, jsonRpcCode, context, trace }) {
+		super(message, {
+			code: "INTERNAL",
+			context,
+			trace,
+			cause: cause instanceof Error ? cause : void 0
+		});
+		this.data = data;
+		this.jsonRpcCode = jsonRpcCode;
+		this.name = "MCPClientError";
+	}
+	/**
+	* Type guard for `MCPClientError`.
+	*/
+	static isInstance(error) {
+		return error instanceof MCPClientError;
+	}
+};
+
+//#endregion
+export { MCPClientError };
+//# sourceMappingURL=mcp-client-error.mjs.map

package/dist/mcp/error/mcp-client-error.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client-error.mjs","names":[],"sources":["../../../src/mcp/error/mcp-client-error.ts"],"sourcesContent":["import { BetterAgentError, type BetterAgentErrorContext } from \"@better-agent/shared/errors\";\n\n/**\n * MCP client error.\n */\nexport class MCPClientError extends BetterAgentError {\n    /** Additional error data from the MCP server. */\n    readonly data?: unknown;\n\n    /** JSON-RPC error code, when present. */\n    readonly jsonRpcCode: number | undefined;\n\n    constructor({\n        message,\n        cause,\n        data,\n        jsonRpcCode,\n        context,\n        trace,\n    }: {\n        message: string;\n        cause?: unknown;\n        data?: unknown;\n        jsonRpcCode?: number;\n        context?: BetterAgentErrorContext;\n        trace?: Array<{ at: string }>;\n    }) {\n        super(message, {\n            code: \"INTERNAL\",\n            context,\n            trace,\n            cause: cause instanceof Error ? cause : undefined,\n        });\n\n        this.data = data;\n        this.jsonRpcCode = jsonRpcCode;\n        this.name = \"MCPClientError\";\n    }\n\n    /**\n     * Type guard for `MCPClientError`.\n     */\n    static isInstance(error: unknown): error is MCPClientError {\n        return error instanceof MCPClientError;\n    }\n}\n"],"mappings":";;;;;;AAKA,IAAa,iBAAb,MAAa,uBAAuB,iBAAiB;;CAEjD,AAAS;;CAGT,AAAS;CAET,YAAY,EACR,SACA,OACA,MACA,aACA,SACA,SAQD;AACC,QAAM,SAAS;GACX,MAAM;GACN;GACA;GACA,OAAO,iBAAiB,QAAQ,QAAQ;GAC3C,CAAC;AAEF,OAAK,OAAO;AACZ,OAAK,cAAc;AACnB,OAAK,OAAO;;;;;CAMhB,OAAO,WAAW,OAAyC;AACvD,SAAO,iBAAiB"}

package/dist/mcp/index.d.mts

@@ -0,0 +1,8 @@
+import { MCPClientError } from "./error/mcp-client-error.mjs";
+import { JSONRPCError, JSONRPCMessage, JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, JSONRPC_VERSION, isJSONRPCError, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse } from "./tool/json-rpc-message.mjs";
+import { MCPHttpTransportConfig, MCPSseTransportConfig, MCPTransport, MCPTransportAdvancedConfig, MCPTransportConfig, isCustomMCPTransport } from "./tool/mcp-transport.mjs";
+import { ClientCapabilities, InitializeParams, InitializeResult, LATEST_PROTOCOL_VERSION, ListPromptsResult, ListResourceTemplatesResult, ListResourcesResult, ListToolsResult, MCPCallToolParams, MCPCallToolResult, MCPGetPromptParams, MCPGetPromptResult, MCPImplementationInfo, MCPPrompt, MCPReadResourceParams, MCPReadResourceResult, MCPResource, MCPResourceTemplate, MCPTool, PaginatedRequest, PaginatedResult, PromptMessage, RequestOptions, SUPPORTED_PROTOCOL_VERSIONS, ServerCapabilities, ToolResultContent } from "./tool/types.mjs";
+import { MCPClient, MCPClientConfig, createMCPClient } from "./tool/mcp-client.mjs";
+import { HttpMCPTransport } from "./tool/mcp-http-transport.mjs";
+import { convertMCPTools } from "./tool/mcp-tools.mjs";
+export { type ClientCapabilities, HttpMCPTransport, type InitializeParams, type InitializeResult, type JSONRPCError, type JSONRPCMessage, type JSONRPCNotification, type JSONRPCRequest, type JSONRPCResponse, JSONRPC_VERSION, LATEST_PROTOCOL_VERSION, type ListPromptsResult, type ListResourceTemplatesResult, type ListResourcesResult, type ListToolsResult, type MCPCallToolParams, type MCPCallToolResult, type MCPClient, type MCPClientConfig, MCPClientError, type MCPGetPromptParams, type MCPGetPromptResult, type MCPHttpTransportConfig, type MCPImplementationInfo, type MCPPrompt, type MCPReadResourceParams, type MCPReadResourceResult, type MCPResource, type MCPResourceTemplate, type MCPSseTransportConfig, type MCPTool, type MCPTransport, type MCPTransportAdvancedConfig, type MCPTransportConfig, type PaginatedRequest, type PaginatedResult, type PromptMessage, type RequestOptions, SUPPORTED_PROTOCOL_VERSIONS, type ServerCapabilities, type ToolResultContent, convertMCPTools, createMCPClient, isCustomMCPTransport, isJSONRPCError, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse };

package/dist/mcp/index.mjs

@@ -0,0 +1,9 @@
+import { MCPClientError } from "./error/mcp-client-error.mjs";
+import { JSONRPC_VERSION, isJSONRPCError, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse } from "./tool/json-rpc-message.mjs";
+import { LATEST_PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS } from "./tool/types.mjs";
+import { HttpMCPTransport } from "./tool/mcp-http-transport.mjs";
+import { isCustomMCPTransport } from "./tool/mcp-transport.mjs";
+import { createMCPClient } from "./tool/mcp-client.mjs";
+import { convertMCPTools } from "./tool/mcp-tools.mjs";
+
+export { HttpMCPTransport, JSONRPC_VERSION, LATEST_PROTOCOL_VERSION, MCPClientError, SUPPORTED_PROTOCOL_VERSIONS, convertMCPTools, createMCPClient, isCustomMCPTransport, isJSONRPCError, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse };

package/dist/mcp/tool/json-rpc-message.d.mts

@@ -0,0 +1,50 @@
+//#region src/mcp/tool/json-rpc-message.d.ts
+/**
+ * JSON-RPC 2.0 message types for MCP communication.
+ *
+ * Follows the Model Context Protocol's JSON-RPC usage.
+ */
+/** JSON-RPC version. */
+declare const JSONRPC_VERSION = "2.0";
+/** JSON-RPC request. */
+interface JSONRPCRequest {
+  jsonrpc: "2.0";
+  id: string | number;
+  method: string;
+  params: Record<string, unknown> | undefined;
+}
+/** JSON-RPC response with a result. */
+interface JSONRPCResponse {
+  jsonrpc: "2.0";
+  id: string | number;
+  result: unknown;
+}
+/** JSON-RPC error response. */
+interface JSONRPCError {
+  jsonrpc: "2.0";
+  id: string | number;
+  error: {
+    code: number;
+    message: string;
+    data: unknown | undefined;
+  };
+}
+/** JSON-RPC notification with no `id`. */
+interface JSONRPCNotification {
+  jsonrpc: "2.0";
+  method: string;
+  params: Record<string, unknown> | undefined;
+}
+/** Any JSON-RPC message. */
+type JSONRPCMessage = JSONRPCRequest | JSONRPCResponse | JSONRPCError | JSONRPCNotification;
+/** Checks whether a message is a JSON-RPC request. */
+declare function isJSONRPCRequest(message: JSONRPCMessage): message is JSONRPCRequest;
+/** Checks whether a message is a JSON-RPC response. */
+declare function isJSONRPCResponse(message: JSONRPCMessage): message is JSONRPCResponse;
+/** Checks whether a message is a JSON-RPC error. */
+declare function isJSONRPCError(message: JSONRPCMessage): message is JSONRPCError;
+/** Checks whether a message is a JSON-RPC notification. */
+declare function isJSONRPCNotification(message: JSONRPCMessage): message is JSONRPCNotification;
+//#endregion
+export { JSONRPCError, JSONRPCMessage, JSONRPCNotification, JSONRPCRequest, JSONRPCResponse, JSONRPC_VERSION, isJSONRPCError, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse };
+//# sourceMappingURL=json-rpc-message.d.mts.map

package/dist/mcp/tool/json-rpc-message.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc-message.d.mts","names":[],"sources":["../../../src/mcp/tool/json-rpc-message.ts"],"mappings":";;AAUA;;;;;cAAa,eAAA;;UAGI,cAAA;EACb,OAAA;EACA,EAAA;EACA,MAAA;EACA,MAAA,EAAQ,MAAA;AAAA;;UAIK,eAAA;EACb,OAAA;EACA,EAAA;EACA,MAAA;AAAA;;UAIa,YAAA;EACb,OAAA;EACA,EAAA;EACA,KAAA;IACI,IAAA;IACA,OAAA;IACA,IAAA;EAAA;AAAA;;UAKS,mBAAA;EACb,OAAA;EACA,MAAA;EACA,MAAA,EAAQ,MAAA;AAAA;;KAIA,cAAA,GAAiB,cAAA,GAAiB,eAAA,GAAkB,YAAA,GAAe,mBAAA;AAP/E;AAAA,iBAUgB,gBAAA,CAAiB,OAAA,EAAS,cAAA,GAAiB,OAAA,IAAW,cAAA;;iBAKtD,iBAAA,CAAkB,OAAA,EAAS,cAAA,GAAiB,OAAA,IAAW,eAAA;;iBAKvD,cAAA,CAAe,OAAA,EAAS,cAAA,GAAiB,OAAA,IAAW,YAAA;;iBAKpD,qBAAA,CAAsB,OAAA,EAAS,cAAA,GAAiB,OAAA,IAAW,mBAAA"}

package/dist/mcp/tool/json-rpc-message.mjs

@@ -0,0 +1,84 @@
+import { MCPClientError } from "../error/mcp-client-error.mjs";
+import { isPlainRecord } from "@better-agent/shared/utils";
+
+//#region src/mcp/tool/json-rpc-message.ts
+/**
+* JSON-RPC 2.0 message types for MCP communication.
+*
+* Follows the Model Context Protocol's JSON-RPC usage.
+*/
+/** JSON-RPC version. */
+const JSONRPC_VERSION = "2.0";
+/** Checks whether a message is a JSON-RPC request. */
+function isJSONRPCRequest(message) {
+	return "id" in message && "method" in message && !("error" in message);
+}
+/** Checks whether a message is a JSON-RPC response. */
+function isJSONRPCResponse(message) {
+	return "id" in message && "result" in message && !("error" in message);
+}
+/** Checks whether a message is a JSON-RPC error. */
+function isJSONRPCError(message) {
+	return "id" in message && "error" in message;
+}
+/** Checks whether a message is a JSON-RPC notification. */
+function isJSONRPCNotification(message) {
+	return !("id" in message) && "method" in message;
+}
+const isJsonRpcId = (value) => typeof value === "string" || typeof value === "number";
+const isJsonRpcParams = (value) => value === void 0 || isPlainRecord(value);
+/**
+* Parses one JSON-RPC message.
+*/
+const parseJSONRPCMessage = (value) => {
+	if (!isPlainRecord(value)) throw new MCPClientError({ message: "Invalid JSON-RPC message: expected an object." });
+	if (value.jsonrpc !== JSONRPC_VERSION) throw new MCPClientError({ message: `Invalid JSON-RPC message: expected jsonrpc="${JSONRPC_VERSION}".` });
+	if ("method" in value) {
+		if (typeof value.method !== "string") throw new MCPClientError({ message: "Invalid JSON-RPC message: method must be a string." });
+		if (!isJsonRpcParams(value.params)) throw new MCPClientError({ message: "Invalid JSON-RPC message: params must be an object when present." });
+		if ("id" in value) {
+			if (!isJsonRpcId(value.id)) throw new MCPClientError({ message: "Invalid JSON-RPC request: id must be a string or number." });
+			return {
+				jsonrpc: JSONRPC_VERSION,
+				id: value.id,
+				method: value.method,
+				params: value.params
+			};
+		}
+		return {
+			jsonrpc: JSONRPC_VERSION,
+			method: value.method,
+			params: value.params
+		};
+	}
+	if ("result" in value) {
+		if (!("id" in value) || !isJsonRpcId(value.id)) throw new MCPClientError({ message: "Invalid JSON-RPC response: id must be a string or number." });
+		return {
+			jsonrpc: JSONRPC_VERSION,
+			id: value.id,
+			result: value.result
+		};
+	}
+	if ("error" in value) {
+		if (!("id" in value) || !isJsonRpcId(value.id)) throw new MCPClientError({ message: "Invalid JSON-RPC error: id must be a string or number." });
+		if (!isPlainRecord(value.error) || typeof value.error.code !== "number" || typeof value.error.message !== "string") throw new MCPClientError({ message: "Invalid JSON-RPC error: error must include numeric code and string message." });
+		return {
+			jsonrpc: JSONRPC_VERSION,
+			id: value.id,
+			error: {
+				code: value.error.code,
+				message: value.error.message,
+				data: value.error.data
+			}
+		};
+	}
+	throw new MCPClientError({ message: "Invalid JSON-RPC message: unrecognized shape." });
+};
+/**
+* Parses either one JSON-RPC message or an array of messages.
+*/
+const parseJSONRPCMessageArray = (value) => Array.isArray(value) ? value.map(parseJSONRPCMessage) : [parseJSONRPCMessage(value)];
+
+//#endregion
+export { JSONRPC_VERSION, isJSONRPCError, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse, parseJSONRPCMessage, parseJSONRPCMessageArray };
+//# sourceMappingURL=json-rpc-message.mjs.map

package/dist/mcp/tool/json-rpc-message.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-rpc-message.mjs","names":[],"sources":["../../../src/mcp/tool/json-rpc-message.ts"],"sourcesContent":["import { isPlainRecord } from \"@better-agent/shared/utils\";\nimport { MCPClientError } from \"../error/mcp-client-error\";\n\n/**\n * JSON-RPC 2.0 message types for MCP communication.\n *\n * Follows the Model Context Protocol's JSON-RPC usage.\n */\n\n/** JSON-RPC version. */\nexport const JSONRPC_VERSION = \"2.0\";\n\n/** JSON-RPC request. */\nexport interface JSONRPCRequest {\n    jsonrpc: \"2.0\";\n    id: string | number;\n    method: string;\n    params: Record<string, unknown> | undefined;\n}\n\n/** JSON-RPC response with a result. */\nexport interface JSONRPCResponse {\n    jsonrpc: \"2.0\";\n    id: string | number;\n    result: unknown;\n}\n\n/** JSON-RPC error response. */\nexport interface JSONRPCError {\n    jsonrpc: \"2.0\";\n    id: string | number;\n    error: {\n        code: number;\n        message: string;\n        data: unknown | undefined;\n    };\n}\n\n/** JSON-RPC notification with no `id`. */\nexport interface JSONRPCNotification {\n    jsonrpc: \"2.0\";\n    method: string;\n    params: Record<string, unknown> | undefined;\n}\n\n/** Any JSON-RPC message. */\nexport type JSONRPCMessage = JSONRPCRequest | JSONRPCResponse | JSONRPCError | JSONRPCNotification;\n\n/** Checks whether a message is a JSON-RPC request. */\nexport function isJSONRPCRequest(message: JSONRPCMessage): message is JSONRPCRequest {\n    return \"id\" in message && \"method\" in message && !(\"error\" in message);\n}\n\n/** Checks whether a message is a JSON-RPC response. */\nexport function isJSONRPCResponse(message: JSONRPCMessage): message is JSONRPCResponse {\n    return \"id\" in message && \"result\" in message && !(\"error\" in message);\n}\n\n/** Checks whether a message is a JSON-RPC error. */\nexport function isJSONRPCError(message: JSONRPCMessage): message is JSONRPCError {\n    return \"id\" in message && \"error\" in message;\n}\n\n/** Checks whether a message is a JSON-RPC notification. */\nexport function isJSONRPCNotification(message: JSONRPCMessage): message is JSONRPCNotification {\n    return !(\"id\" in message) && \"method\" in message;\n}\n\nconst isJsonRpcId = (value: unknown): value is string | number =>\n    typeof value === \"string\" || typeof value === \"number\";\n\nconst isJsonRpcParams = (value: unknown): value is Record<string, unknown> | undefined =>\n    value === undefined || isPlainRecord(value);\n\n/**\n * Parses one JSON-RPC message.\n */\nexport const parseJSONRPCMessage = (value: unknown): JSONRPCMessage => {\n    if (!isPlainRecord(value)) {\n        throw new MCPClientError({\n            message: \"Invalid JSON-RPC message: expected an object.\",\n        });\n    }\n\n    if (value.jsonrpc !== JSONRPC_VERSION) {\n        throw new MCPClientError({\n            message: `Invalid JSON-RPC message: expected jsonrpc=\"${JSONRPC_VERSION}\".`,\n        });\n    }\n\n    if (\"method\" in value) {\n        if (typeof value.method !== \"string\") {\n            throw new MCPClientError({\n                message: \"Invalid JSON-RPC message: method must be a string.\",\n            });\n        }\n\n        if (!isJsonRpcParams(value.params)) {\n            throw new MCPClientError({\n                message: \"Invalid JSON-RPC message: params must be an object when present.\",\n            });\n        }\n\n        if (\"id\" in value) {\n            if (!isJsonRpcId(value.id)) {\n                throw new MCPClientError({\n                    message: \"Invalid JSON-RPC request: id must be a string or number.\",\n                });\n            }\n\n            return {\n                jsonrpc: JSONRPC_VERSION,\n                id: value.id,\n                method: value.method,\n                params: value.params,\n            };\n        }\n\n        return {\n            jsonrpc: JSONRPC_VERSION,\n            method: value.method,\n            params: value.params,\n        };\n    }\n\n    if (\"result\" in value) {\n        if (!(\"id\" in value) || !isJsonRpcId(value.id)) {\n            throw new MCPClientError({\n                message: \"Invalid JSON-RPC response: id must be a string or number.\",\n            });\n        }\n\n        return {\n            jsonrpc: JSONRPC_VERSION,\n            id: value.id,\n            result: value.result,\n        };\n    }\n\n    if (\"error\" in value) {\n        if (!(\"id\" in value) || !isJsonRpcId(value.id)) {\n            throw new MCPClientError({\n                message: \"Invalid JSON-RPC error: id must be a string or number.\",\n            });\n        }\n\n        if (\n            !isPlainRecord(value.error) ||\n            typeof value.error.code !== \"number\" ||\n            typeof value.error.message !== \"string\"\n        ) {\n            throw new MCPClientError({\n                message:\n                    \"Invalid JSON-RPC error: error must include numeric code and string message.\",\n            });\n        }\n\n        return {\n            jsonrpc: JSONRPC_VERSION,\n            id: value.id,\n            error: {\n                code: value.error.code,\n                message: value.error.message,\n                data: value.error.data,\n            },\n        };\n    }\n\n    throw new MCPClientError({\n        message: \"Invalid JSON-RPC message: unrecognized shape.\",\n    });\n};\n\n/**\n * Parses either one JSON-RPC message or an array of messages.\n */\nexport const parseJSONRPCMessageArray = (value: unknown): JSONRPCMessage[] =>\n    Array.isArray(value) ? value.map(parseJSONRPCMessage) : [parseJSONRPCMessage(value)];\n"],"mappings":";;;;;;;;;;AAUA,MAAa,kBAAkB;;AAuC/B,SAAgB,iBAAiB,SAAoD;AACjF,QAAO,QAAQ,WAAW,YAAY,WAAW,EAAE,WAAW;;;AAIlE,SAAgB,kBAAkB,SAAqD;AACnF,QAAO,QAAQ,WAAW,YAAY,WAAW,EAAE,WAAW;;;AAIlE,SAAgB,eAAe,SAAkD;AAC7E,QAAO,QAAQ,WAAW,WAAW;;;AAIzC,SAAgB,sBAAsB,SAAyD;AAC3F,QAAO,EAAE,QAAQ,YAAY,YAAY;;AAG7C,MAAM,eAAe,UACjB,OAAO,UAAU,YAAY,OAAO,UAAU;AAElD,MAAM,mBAAmB,UACrB,UAAU,UAAa,cAAc,MAAM;;;;AAK/C,MAAa,uBAAuB,UAAmC;AACnE,KAAI,CAAC,cAAc,MAAM,CACrB,OAAM,IAAI,eAAe,EACrB,SAAS,iDACZ,CAAC;AAGN,KAAI,MAAM,YAAY,gBAClB,OAAM,IAAI,eAAe,EACrB,SAAS,+CAA+C,gBAAgB,KAC3E,CAAC;AAGN,KAAI,YAAY,OAAO;AACnB,MAAI,OAAO,MAAM,WAAW,SACxB,OAAM,IAAI,eAAe,EACrB,SAAS,sDACZ,CAAC;AAGN,MAAI,CAAC,gBAAgB,MAAM,OAAO,CAC9B,OAAM,IAAI,eAAe,EACrB,SAAS,oEACZ,CAAC;AAGN,MAAI,QAAQ,OAAO;AACf,OAAI,CAAC,YAAY,MAAM,GAAG,CACtB,OAAM,IAAI,eAAe,EACrB,SAAS,4DACZ,CAAC;AAGN,UAAO;IACH,SAAS;IACT,IAAI,MAAM;IACV,QAAQ,MAAM;IACd,QAAQ,MAAM;IACjB;;AAGL,SAAO;GACH,SAAS;GACT,QAAQ,MAAM;GACd,QAAQ,MAAM;GACjB;;AAGL,KAAI,YAAY,OAAO;AACnB,MAAI,EAAE,QAAQ,UAAU,CAAC,YAAY,MAAM,GAAG,CAC1C,OAAM,IAAI,eAAe,EACrB,SAAS,6DACZ,CAAC;AAGN,SAAO;GACH,SAAS;GACT,IAAI,MAAM;GACV,QAAQ,MAAM;GACjB;;AAGL,KAAI,WAAW,OAAO;AAClB,MAAI,EAAE,QAAQ,UAAU,CAAC,YAAY,MAAM,GAAG,CAC1C,OAAM,IAAI,eAAe,EACrB,SAAS,0DACZ,CAAC;AAGN,MACI,CAAC,cAAc,MAAM,MAAM,IAC3B,OAAO,MAAM,MAAM,SAAS,YAC5B,OAAO,MAAM,MAAM,YAAY,SAE/B,OAAM,IAAI,eAAe,EACrB,SACI,+EACP,CAAC;AAGN,SAAO;GACH,SAAS;GACT,IAAI,MAAM;GACV,OAAO;IACH,MAAM,MAAM,MAAM;IAClB,SAAS,MAAM,MAAM;IACrB,MAAM,MAAM,MAAM;IACrB;GACJ;;AAGL,OAAM,IAAI,eAAe,EACrB,SAAS,iDACZ,CAAC;;;;;AAMN,MAAa,4BAA4B,UACrC,MAAM,QAAQ,MAAM,GAAG,MAAM,IAAI,oBAAoB,GAAG,CAAC,oBAAoB,MAAM,CAAC"}