@assistant-ui/eve 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AgentbaseAI Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,20 @@
+# @assistant-ui/eve
+
+Eve runtime adapter for assistant-ui.
+
+```tsx
+"use client";
+
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { useEveAgentRuntime } from "@assistant-ui/eve";
+
+export function RuntimeProvider({ children }: { children: React.ReactNode }) {
+  const runtime = useEveAgentRuntime();
+
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      {children}
+    </AssistantRuntimeProvider>
+  );
+}
+```

package/dist/convertEveMessages.d.ts

@@ -0,0 +1,32 @@
+import { AppendMessage, RespondToToolApprovalOptions, ThreadMessage } from "@assistant-ui/core";
+import { EveMessage, EveMessageData, InputResponse, SendTurnPayload } from "eve/react";
+
+//#region src/convertEveMessages.d.ts
+type ConvertEveMessagesOptions = {
+  /**
+   * Marks the last assistant message as running while Eve is submitting or
+   * streaming.
+   */
+  readonly isRunning?: boolean | undefined;
+  readonly getCreatedAt?: ((message: EveMessage) => Date) | undefined;
+};
+/**
+ * Converts a single Eve message into an assistant-ui thread message.
+ */
+declare const convertEveMessage: (message: EveMessage, index: number, messages: readonly EveMessage[], options?: ConvertEveMessagesOptions) => ThreadMessage;
+/**
+ * Converts the full Eve message data object into assistant-ui thread messages.
+ */
+declare const convertEveMessages: (data: EveMessageData, options?: ConvertEveMessagesOptions) => ThreadMessage[];
+/**
+ * Converts an assistant-ui append message into the message payload accepted by
+ * Eve's `send` API.
+ */
+declare const getEveMessageContent: (message: AppendMessage) => NonNullable<SendTurnPayload["message"]>;
+/**
+ * Converts an assistant-ui tool approval response into an Eve input response.
+ */
+declare const toEveInputResponse: (response: RespondToToolApprovalOptions) => InputResponse;
+//#endregion
+export { ConvertEveMessagesOptions, convertEveMessage, convertEveMessages, getEveMessageContent, toEveInputResponse };
+//# sourceMappingURL=convertEveMessages.d.ts.map

package/dist/convertEveMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertEveMessages.d.ts","names":[],"sources":["../src/convertEveMessages.ts"],"mappings":";;;;KAmCY,yBAAA;;AAAZ;;;WAKW,SAAA;EAAA,SACA,YAAA,KAAiB,OAAA,EAAS,UAAA,KAAe,IAAI;AAAA;;;;cA0K3C,iBAAA,GACX,OAAA,EAAS,UAAA,EACT,KAAA,UACA,QAAA,WAAmB,UAAA,IACnB,OAAA,GAAS,yBAAA,KACR,aAAA;AA/KqD;AA0KxD;;AA1KwD,cAsO3C,kBAAA,GACX,IAAA,EAAM,cAAA,EACN,OAAA,GAAS,yBAAA,KACR,aAAA;;;;;cASU,oBAAA,GACX,OAAA,EAAS,aAAA,KACR,WAAA,CAAY,eAAA;;;;cAqDF,kBAAA,GACX,QAAA,EAAU,4BAAA,KACT,aAID"}

package/dist/convertEveMessages.js

@@ -0,0 +1,191 @@
+//#region src/convertEveMessages.ts
+const ASSISTANT_COMPLETE_STATUS = {
+	type: "complete",
+	reason: "stop"
+};
+const ASSISTANT_RUNNING_STATUS = { type: "running" };
+const USER_FALLBACK_STATUS = {
+	type: "complete",
+	reason: "unknown"
+};
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const toJsonObject = (value) => {
+	if (isRecord(value)) return value;
+	if (value === void 0) return {};
+	return { value };
+};
+const stringifyArgs = (value) => {
+	try {
+		return JSON.stringify(value ?? {});
+	} catch {
+		return "";
+	}
+};
+const toMessageStatus = (message, index, messages, options) => {
+	if (message.role !== "assistant") return USER_FALLBACK_STATUS;
+	if (message.parts.some((part) => part.type === "dynamic-tool" && part.state === "approval-requested")) return {
+		type: "requires-action",
+		reason: "tool-calls"
+	};
+	if (message.metadata?.status === "failed") return {
+		type: "incomplete",
+		reason: "error"
+	};
+	if (message.metadata?.status === "streaming" || options.isRunning === true && index === messages.length - 1) return ASSISTANT_RUNNING_STATUS;
+	return ASSISTANT_COMPLETE_STATUS;
+};
+const toolApprovalOptionsFromInputRequest = (inputRequest) => {
+	const options = inputRequest?.options;
+	if (!options || options.length === 0) return void 0;
+	return options.map((option) => ({
+		id: option.id,
+		kind: option.id === "approve" ? "allow-once" : option.id === "deny" ? "reject-once" : `_${option.id}`,
+		...option.label && { label: option.label },
+		...option.description && { description: option.description }
+	}));
+};
+const toApproval = (part) => {
+	if (part.state !== "approval-requested" && part.state !== "approval-responded" && part.state !== "output-available" && part.state !== "output-error" && part.state !== "output-denied") return;
+	const approval = part.approval;
+	if (!approval) return void 0;
+	const options = toolApprovalOptionsFromInputRequest(part.toolMetadata?.eve?.inputRequest);
+	return {
+		id: approval.id,
+		...approval.approved !== void 0 && { approved: approval.approved },
+		...approval.reason && { reason: approval.reason },
+		...approval.isAutomatic !== void 0 && { isAutomatic: approval.isAutomatic },
+		...options && { options }
+	};
+};
+const convertDynamicToolPart = (part) => {
+	const approval = toApproval(part);
+	const toolCall = {
+		type: "tool-call",
+		toolCallId: part.toolCallId,
+		toolName: part.toolName,
+		args: toJsonObject(part.input),
+		argsText: stringifyArgs(part.input),
+		...approval && { approval }
+	};
+	switch (part.state) {
+		case "output-available": return {
+			...toolCall,
+			result: part.output
+		};
+		case "output-error": return {
+			...toolCall,
+			result: { error: part.errorText },
+			isError: true
+		};
+		case "output-denied": return {
+			...toolCall,
+			result: { error: part.approval?.reason ?? "Tool approval denied" },
+			isError: true
+		};
+		default: return toolCall;
+	}
+};
+const convertAssistantPart = (part) => {
+	switch (part.type) {
+		case "text":
+		case "reasoning": return {
+			type: part.type,
+			text: part.text
+		};
+		case "step-start": return null;
+		case "dynamic-tool": return convertDynamicToolPart(part);
+		default: return null;
+	}
+};
+const convertUserPart = (part) => {
+	switch (part.type) {
+		case "text": return {
+			type: "text",
+			text: part.text
+		};
+		default: return null;
+	}
+};
+/**
+* Converts a single Eve message into an assistant-ui thread message.
+*/
+const convertEveMessage = (message, index, messages, options = {}) => {
+	const createdAt = options.getCreatedAt?.(message) ?? /* @__PURE__ */ new Date();
+	const metadata = {
+		...message.metadata?.optimistic && { isOptimistic: true },
+		custom: { ...message.metadata ?? {} }
+	};
+	const content = message.role === "assistant" ? message.parts.map(convertAssistantPart).filter((part) => part !== null) : message.parts.map(convertUserPart).filter((part) => part !== null);
+	const fallbackTextPart = {
+		type: "text",
+		text: ""
+	};
+	if (message.role === "user") return {
+		id: message.id,
+		createdAt,
+		role: "user",
+		content: content.length > 0 ? content : [fallbackTextPart],
+		attachments: [],
+		metadata
+	};
+	return {
+		id: message.id,
+		createdAt,
+		role: "assistant",
+		content: content.length > 0 ? content : [],
+		status: toMessageStatus(message, index, messages, options),
+		metadata: {
+			unstable_state: null,
+			unstable_annotations: [],
+			unstable_data: [],
+			steps: [],
+			...metadata
+		}
+	};
+};
+/**
+* Converts the full Eve message data object into assistant-ui thread messages.
+*/
+const convertEveMessages = (data, options = {}) => data.messages.map((message, index, messages) => convertEveMessage(message, index, messages, options));
+/**
+* Converts an assistant-ui append message into the message payload accepted by
+* Eve's `send` API.
+*/
+const getEveMessageContent = (message) => {
+	const parts = [...message.content, ...message.attachments?.flatMap((attachment) => attachment.content) ?? []].map((part) => {
+		const type = part.type;
+		switch (type) {
+			case "text": return {
+				type: "text",
+				text: part.text
+			};
+			case "file": return {
+				type: "file",
+				data: part.data,
+				mediaType: part.mimeType,
+				...part.filename && { filename: part.filename }
+			};
+			case "image": return {
+				type: "file",
+				data: part.image,
+				mediaType: "image/*",
+				...part.filename && { filename: part.filename }
+			};
+			default: throw new Error(`Unsupported eve append message part type: ${type}`);
+		}
+	});
+	if (parts.length === 1 && parts[0]?.type === "text") return parts[0].text;
+	return parts;
+};
+/**
+* Converts an assistant-ui tool approval response into an Eve input response.
+*/
+const toEveInputResponse = (response) => ({
+	requestId: response.approvalId,
+	optionId: response.optionId ?? (response.approved ? "approve" : "deny"),
+	...response.reason && { text: response.reason }
+});
+//#endregion
+export { convertEveMessage, convertEveMessages, getEveMessageContent, toEveInputResponse };
+
+//# sourceMappingURL=convertEveMessages.js.map

package/dist/convertEveMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertEveMessages.js","names":["_exhaustiveCheck"],"sources":["../src/convertEveMessages.ts"],"sourcesContent":["import type {\n  AppendMessage,\n  MessageStatus,\n  RespondToToolApprovalOptions,\n  TextMessagePart,\n  ThreadAssistantMessagePart,\n  ThreadMessage,\n  ThreadUserMessagePart,\n  ToolApprovalOption,\n  ToolCallMessagePart,\n} from \"@assistant-ui/core\";\nimport type {\n  EveDynamicToolPart,\n  EveMessage,\n  EveMessageData,\n  EveMessageInputRequest,\n  EveMessagePart,\n  InputResponse,\n  SendTurnPayload,\n} from \"eve/react\";\n\nconst ASSISTANT_COMPLETE_STATUS = {\n  type: \"complete\",\n  reason: \"stop\",\n} satisfies MessageStatus;\n\nconst ASSISTANT_RUNNING_STATUS = {\n  type: \"running\",\n} satisfies MessageStatus;\n\nconst USER_FALLBACK_STATUS = {\n  type: \"complete\",\n  reason: \"unknown\",\n} satisfies MessageStatus;\n\nexport type ConvertEveMessagesOptions = {\n  /**\n   * Marks the last assistant message as running while Eve is submitting or\n   * streaming.\n   */\n  readonly isRunning?: boolean | undefined;\n  readonly getCreatedAt?: ((message: EveMessage) => Date) | undefined;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst toJsonObject = (value: unknown): Record<string, unknown> => {\n  if (isRecord(value)) return value;\n  if (value === undefined) return {};\n  return { value };\n};\n\nconst stringifyArgs = (value: unknown): string => {\n  try {\n    return JSON.stringify(value ?? {});\n  } catch {\n    return \"\";\n  }\n};\n\nconst toMessageStatus = (\n  message: EveMessage,\n  index: number,\n  messages: readonly EveMessage[],\n  options: ConvertEveMessagesOptions,\n): MessageStatus => {\n  if (message.role !== \"assistant\") return USER_FALLBACK_STATUS;\n\n  const hasPendingApproval = message.parts.some(\n    (part) =>\n      part.type === \"dynamic-tool\" && part.state === \"approval-requested\",\n  );\n\n  if (hasPendingApproval) {\n    return { type: \"requires-action\", reason: \"tool-calls\" };\n  }\n\n  if (message.metadata?.status === \"failed\") {\n    return { type: \"incomplete\", reason: \"error\" };\n  }\n\n  if (\n    message.metadata?.status === \"streaming\" ||\n    (options.isRunning === true && index === messages.length - 1)\n  ) {\n    return ASSISTANT_RUNNING_STATUS;\n  }\n\n  return ASSISTANT_COMPLETE_STATUS;\n};\n\nconst toolApprovalOptionsFromInputRequest = (\n  inputRequest: EveMessageInputRequest | undefined,\n): readonly ToolApprovalOption[] | undefined => {\n  const options = inputRequest?.options;\n  if (!options || options.length === 0) return undefined;\n\n  return options.map((option) => ({\n    id: option.id,\n    kind:\n      option.id === \"approve\"\n        ? \"allow-once\"\n        : option.id === \"deny\"\n          ? \"reject-once\"\n          : `_${option.id}`,\n    ...(option.label && { label: option.label }),\n    ...(option.description && { description: option.description }),\n  }));\n};\n\nconst toApproval = (\n  part: EveDynamicToolPart,\n): ToolCallMessagePart[\"approval\"] | undefined => {\n  if (\n    part.state !== \"approval-requested\" &&\n    part.state !== \"approval-responded\" &&\n    part.state !== \"output-available\" &&\n    part.state !== \"output-error\" &&\n    part.state !== \"output-denied\"\n  ) {\n    return undefined;\n  }\n\n  const approval = part.approval;\n  if (!approval) return undefined;\n  const options = toolApprovalOptionsFromInputRequest(\n    part.toolMetadata?.eve?.inputRequest,\n  );\n\n  return {\n    id: approval.id,\n    ...(approval.approved !== undefined && { approved: approval.approved }),\n    ...(approval.reason && { reason: approval.reason }),\n    ...(approval.isAutomatic !== undefined && {\n      isAutomatic: approval.isAutomatic,\n    }),\n    ...(options && { options }),\n  };\n};\n\nconst convertDynamicToolPart = (\n  part: EveDynamicToolPart,\n): ToolCallMessagePart => {\n  const approval = toApproval(part);\n  const toolCall: ToolCallMessagePart = {\n    type: \"tool-call\",\n    toolCallId: part.toolCallId,\n    toolName: part.toolName,\n    args: toJsonObject(part.input),\n    argsText: stringifyArgs(part.input),\n    ...(approval && { approval }),\n  };\n\n  switch (part.state) {\n    case \"output-available\":\n      return { ...toolCall, result: part.output };\n\n    case \"output-error\":\n      return {\n        ...toolCall,\n        result: { error: part.errorText },\n        isError: true,\n      };\n\n    case \"output-denied\":\n      return {\n        ...toolCall,\n        result: { error: part.approval?.reason ?? \"Tool approval denied\" },\n        isError: true,\n      };\n\n    default:\n      return toolCall;\n  }\n};\n\nconst convertAssistantPart = (\n  part: EveMessagePart,\n): ThreadAssistantMessagePart | null => {\n  switch (part.type) {\n    case \"text\":\n    case \"reasoning\":\n      return { type: part.type, text: part.text };\n\n    case \"step-start\":\n      return null;\n\n    case \"dynamic-tool\":\n      return convertDynamicToolPart(part);\n\n    default:\n      return null;\n  }\n};\n\nconst convertUserPart = (\n  part: EveMessagePart,\n): ThreadUserMessagePart | null => {\n  switch (part.type) {\n    case \"text\":\n      return { type: \"text\", text: part.text };\n\n    default:\n      return null;\n  }\n};\n\n/**\n * Converts a single Eve message into an assistant-ui thread message.\n */\nexport const convertEveMessage = (\n  message: EveMessage,\n  index: number,\n  messages: readonly EveMessage[],\n  options: ConvertEveMessagesOptions = {},\n): ThreadMessage => {\n  const createdAt = options.getCreatedAt?.(message) ?? new Date();\n  const metadata = {\n    ...(message.metadata?.optimistic && { isOptimistic: true }),\n    custom: {\n      ...(message.metadata ?? {}),\n    },\n  };\n\n  const content =\n    message.role === \"assistant\"\n      ? message.parts.map(convertAssistantPart).filter((part) => part !== null)\n      : message.parts.map(convertUserPart).filter((part) => part !== null);\n\n  const fallbackTextPart: TextMessagePart = {\n    type: \"text\",\n    text: \"\",\n  };\n\n  if (message.role === \"user\") {\n    return {\n      id: message.id,\n      createdAt,\n      role: \"user\",\n      content:\n        content.length > 0\n          ? (content as readonly ThreadUserMessagePart[])\n          : [fallbackTextPart],\n      attachments: [],\n      metadata,\n    };\n  }\n\n  return {\n    id: message.id,\n    createdAt,\n    role: \"assistant\",\n    content:\n      content.length > 0\n        ? (content as readonly ThreadAssistantMessagePart[])\n        : [],\n    status: toMessageStatus(message, index, messages, options),\n    metadata: {\n      unstable_state: null,\n      unstable_annotations: [],\n      unstable_data: [],\n      steps: [],\n      ...metadata,\n    },\n  };\n};\n\n/**\n * Converts the full Eve message data object into assistant-ui thread messages.\n */\nexport const convertEveMessages = (\n  data: EveMessageData,\n  options: ConvertEveMessagesOptions = {},\n): ThreadMessage[] =>\n  data.messages.map((message, index, messages) =>\n    convertEveMessage(message, index, messages, options),\n  );\n\n/**\n * Converts an assistant-ui append message into the message payload accepted by\n * Eve's `send` API.\n */\nexport const getEveMessageContent = (\n  message: AppendMessage,\n): NonNullable<SendTurnPayload[\"message\"]> => {\n  const content = [\n    ...message.content,\n    ...(message.attachments?.flatMap((attachment) => attachment.content) ?? []),\n  ];\n\n  const parts = content.map((part) => {\n    const type = part.type;\n    switch (type) {\n      case \"text\":\n        return { type: \"text\" as const, text: part.text };\n\n      case \"file\":\n        return {\n          type: \"file\" as const,\n          data: part.data,\n          mediaType: part.mimeType,\n          ...(part.filename && { filename: part.filename }),\n        };\n\n      case \"image\":\n        return {\n          type: \"file\" as const,\n          data: part.image,\n          mediaType: \"image/*\",\n          ...(part.filename && { filename: part.filename }),\n        };\n\n      default: {\n        const _exhaustiveCheck:\n          | \"audio\"\n          | \"data\"\n          | \"generative-ui\"\n          | \"reasoning\"\n          | \"source\"\n          | \"tool-call\" = type;\n        throw new Error(\n          `Unsupported eve append message part type: ${_exhaustiveCheck}`,\n        );\n      }\n    }\n  });\n\n  if (parts.length === 1 && parts[0]?.type === \"text\") {\n    return parts[0].text;\n  }\n\n  return parts;\n};\n\n/**\n * Converts an assistant-ui tool approval response into an Eve input response.\n */\nexport const toEveInputResponse = (\n  response: RespondToToolApprovalOptions,\n): InputResponse => ({\n  requestId: response.approvalId,\n  optionId: response.optionId ?? (response.approved ? \"approve\" : \"deny\"),\n  ...(response.reason && { text: response.reason }),\n});\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="@assistant-ui/core/react" />
+import { ConvertEveMessagesOptions, convertEveMessage, convertEveMessages, getEveMessageContent } from "./convertEveMessages.js";
+import { UseEveAgentRuntimeOptions, useEveAgentRuntime } from "./useEveAgentRuntime.js";
+export { type ConvertEveMessagesOptions, type UseEveAgentRuntimeOptions, convertEveMessage, convertEveMessages, getEveMessageContent, useEveAgentRuntime };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { convertEveMessage, convertEveMessages, getEveMessageContent } from "./convertEveMessages.js";
+import { useEveAgentRuntime } from "./useEveAgentRuntime.js";
+export { convertEveMessage, convertEveMessages, getEveMessageContent, useEveAgentRuntime };

package/dist/useEveAgentRuntime.d.ts

@@ -0,0 +1,24 @@
+import { AttachmentAdapter, DictationAdapter, ExternalStoreSharedOptions, FeedbackAdapter, RealtimeVoiceAdapter, SpeechSynthesisAdapter } from "@assistant-ui/core";
+import { EveMessageData, UseEveAgentOptions } from "eve/react";
+
+//#region src/useEveAgentRuntime.d.ts
+type UseEveAgentRuntimeOptions = Omit<UseEveAgentOptions<EveMessageData>, "reducer"> & ExternalStoreSharedOptions & {
+  readonly adapters?: {
+    readonly attachments?: AttachmentAdapter | undefined;
+    readonly speech?: SpeechSynthesisAdapter | undefined;
+    readonly dictation?: DictationAdapter | undefined;
+    readonly voice?: RealtimeVoiceAdapter | undefined;
+    readonly feedback?: FeedbackAdapter | undefined;
+  } | undefined;
+};
+/**
+ * Connects Eve's `useEveAgent` hook to assistant-ui's runtime contract.
+ *
+ * The runtime renders Eve messages, forwards new user messages to the Eve
+ * session, supports cancellation, and maps Eve input requests to assistant-ui
+ * tool approval UI.
+ */
+declare const useEveAgentRuntime: (options?: UseEveAgentRuntimeOptions) => import("@assistant-ui/core").AssistantRuntime;
+//#endregion
+export { UseEveAgentRuntimeOptions, useEveAgentRuntime };
+//# sourceMappingURL=useEveAgentRuntime.d.ts.map

package/dist/useEveAgentRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEveAgentRuntime.d.ts","names":[],"sources":["../src/useEveAgentRuntime.ts"],"mappings":";;;;KA4BY,yBAAA,GAA4B,IAAA,CACtC,kBAAA,CAAmB,cAAA,gBAGnB,0BAAA;EAAA,SACW,QAAA;IAAA,SAEM,WAAA,GAAc,iBAAA;IAAA,SACd,MAAA,GAAS,sBAAA;IAAA,SACT,SAAA,GAAY,gBAAA;IAAA,SACZ,KAAA,GAAQ,oBAAA;IAAA,SACR,QAAA,GAAW,eAAA;EAAA;AAAA;;;;;;;;cAYjB,kBAAA,GAAsB,OAAA,GAAS,yBAA8B,kCAAA,gBAAA"}

package/dist/useEveAgentRuntime.js

@@ -0,0 +1,66 @@
+"use client";
+import { convertEveMessages, getEveMessageContent, toEveInputResponse } from "./convertEveMessages.js";
+import { useMemo, useRef, useState } from "react";
+import { pickExternalStoreSharedOptions } from "@assistant-ui/core";
+import { useExternalStoreRuntime, useRuntimeAdapters } from "@assistant-ui/core/react";
+import { useEveAgent } from "eve/react";
+//#region src/useEveAgentRuntime.ts
+/**
+* Connects Eve's `useEveAgent` hook to assistant-ui's runtime contract.
+*
+* The runtime renders Eve messages, forwards new user messages to the Eve
+* session, supports cancellation, and maps Eve input requests to assistant-ui
+* tool approval UI.
+*/
+const useEveAgentRuntime = (options = {}) => {
+	const { adapters, isDisabled: _isDisabled, isSendDisabled: _isSendDisabled, suggestions: _suggestions, unstable_capabilities: _unstable_capabilities, ...agentOptions } = options;
+	const agent = useEveAgent(agentOptions);
+	const runtimeAdapters = useRuntimeAdapters();
+	const [toolStatuses, setToolStatuses] = useState({});
+	const createdAtByMessageIdRef = useRef(/* @__PURE__ */ new Map());
+	const hasExecutingTools = Object.values(toolStatuses).some((status) => status?.type === "executing");
+	const isRunning = agent.status === "submitted" || agent.status === "streaming" || hasExecutingTools;
+	const messages = useMemo(() => {
+		const createdAtByMessageId = createdAtByMessageIdRef.current;
+		const messageIds = new Set(agent.data.messages.map((message) => message.id));
+		for (const messageId of createdAtByMessageId.keys()) if (!messageIds.has(messageId)) createdAtByMessageId.delete(messageId);
+		return convertEveMessages(agent.data, {
+			isRunning,
+			getCreatedAt: (message) => {
+				const existing = createdAtByMessageId.get(message.id);
+				if (existing) return existing;
+				const createdAt = /* @__PURE__ */ new Date();
+				createdAtByMessageId.set(message.id, createdAt);
+				return createdAt;
+			}
+		});
+	}, [agent.data, isRunning]);
+	return useExternalStoreRuntime({
+		...pickExternalStoreSharedOptions(options),
+		messages,
+		isRunning,
+		unstable_enableToolInvocations: true,
+		setToolStatuses,
+		adapters: {
+			attachments: adapters?.attachments ?? runtimeAdapters?.attachments,
+			speech: adapters?.speech,
+			dictation: adapters?.dictation,
+			voice: adapters?.voice,
+			feedback: adapters?.feedback
+		},
+		onNew: async (message) => {
+			await agent.send({ message: getEveMessageContent(message) });
+		},
+		onCancel: () => {
+			agent.stop();
+			return Promise.resolve();
+		},
+		onRespondToToolApproval: async (response) => {
+			await agent.send({ inputResponses: [toEveInputResponse(response)] });
+		}
+	});
+};
+//#endregion
+export { useEveAgentRuntime };
+
+//# sourceMappingURL=useEveAgentRuntime.js.map

package/dist/useEveAgentRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEveAgentRuntime.js","names":[],"sources":["../src/useEveAgentRuntime.ts"],"sourcesContent":["\"use client\";\n\nimport { useMemo, useRef, useState } from \"react\";\nimport {\n  pickExternalStoreSharedOptions,\n  type AttachmentAdapter,\n  type DictationAdapter,\n  type ExternalStoreSharedOptions,\n  type FeedbackAdapter,\n  type RealtimeVoiceAdapter,\n  type SpeechSynthesisAdapter,\n  type ToolExecutionStatus,\n} from \"@assistant-ui/core\";\nimport {\n  useExternalStoreRuntime,\n  useRuntimeAdapters,\n} from \"@assistant-ui/core/react\";\nimport {\n  useEveAgent,\n  type EveMessageData,\n  type UseEveAgentOptions,\n} from \"eve/react\";\nimport {\n  convertEveMessages,\n  getEveMessageContent,\n  toEveInputResponse,\n} from \"./convertEveMessages\";\n\nexport type UseEveAgentRuntimeOptions = Omit<\n  UseEveAgentOptions<EveMessageData>,\n  \"reducer\"\n> &\n  ExternalStoreSharedOptions & {\n    readonly adapters?:\n      | {\n          readonly attachments?: AttachmentAdapter | undefined;\n          readonly speech?: SpeechSynthesisAdapter | undefined;\n          readonly dictation?: DictationAdapter | undefined;\n          readonly voice?: RealtimeVoiceAdapter | undefined;\n          readonly feedback?: FeedbackAdapter | undefined;\n        }\n      | undefined;\n  };\n\n/**\n * Connects Eve's `useEveAgent` hook to assistant-ui's runtime contract.\n *\n * The runtime renders Eve messages, forwards new user messages to the Eve\n * session, supports cancellation, and maps Eve input requests to assistant-ui\n * tool approval UI.\n */\nexport const useEveAgentRuntime = (options: UseEveAgentRuntimeOptions = {}) => {\n  const {\n    adapters,\n    isDisabled: _isDisabled,\n    isSendDisabled: _isSendDisabled,\n    suggestions: _suggestions,\n    unstable_capabilities: _unstable_capabilities,\n    ...agentOptions\n  } = options;\n  true satisfies keyof typeof agentOptions &\n    keyof ExternalStoreSharedOptions extends never\n    ? true\n    : never;\n\n  const agent = useEveAgent(agentOptions);\n  const runtimeAdapters = useRuntimeAdapters();\n  const [toolStatuses, setToolStatuses] = useState<\n    Record<string, ToolExecutionStatus>\n  >({});\n  const createdAtByMessageIdRef = useRef(new Map<string, Date>());\n\n  const hasExecutingTools = Object.values(toolStatuses).some(\n    (status) => status?.type === \"executing\",\n  );\n  const isRunning =\n    agent.status === \"submitted\" ||\n    agent.status === \"streaming\" ||\n    hasExecutingTools;\n\n  const messages = useMemo(() => {\n    const createdAtByMessageId = createdAtByMessageIdRef.current;\n    const messageIds = new Set(\n      agent.data.messages.map((message) => message.id),\n    );\n    for (const messageId of createdAtByMessageId.keys()) {\n      if (!messageIds.has(messageId)) createdAtByMessageId.delete(messageId);\n    }\n\n    return convertEveMessages(agent.data, {\n      isRunning,\n      getCreatedAt: (message) => {\n        const existing = createdAtByMessageId.get(message.id);\n        if (existing) return existing;\n\n        const createdAt = new Date();\n        createdAtByMessageId.set(message.id, createdAt);\n        return createdAt;\n      },\n    });\n  }, [agent.data, isRunning]);\n\n  return useExternalStoreRuntime({\n    ...pickExternalStoreSharedOptions(options),\n    messages,\n    isRunning,\n    unstable_enableToolInvocations: true,\n    setToolStatuses,\n    adapters: {\n      attachments: adapters?.attachments ?? runtimeAdapters?.attachments,\n      speech: adapters?.speech,\n      dictation: adapters?.dictation,\n      voice: adapters?.voice,\n      feedback: adapters?.feedback,\n    },\n    onNew: async (message) => {\n      await agent.send({ message: getEveMessageContent(message) });\n    },\n    onCancel: () => {\n      agent.stop();\n      return Promise.resolve();\n    },\n    onRespondToToolApproval: async (response) => {\n      await agent.send({ inputResponses: [toEveInputResponse(response)] });\n    },\n  });\n};\n"],"mappings":";;;;;;;;;;;;;;AAmDA,MAAa,sBAAsB,UAAqC,CAAC,MAAM;CAC7E,MAAM,EACJ,UACA,YAAY,aACZ,gBAAgB,iBAChB,aAAa,cACb,uBAAuB,wBACvB,GAAG,iBACD;CAMJ,MAAM,QAAQ,YAAY,YAAY;CACtC,MAAM,kBAAkB,mBAAmB;CAC3C,MAAM,CAAC,cAAc,mBAAmB,SAEtC,CAAC,CAAC;CACJ,MAAM,0BAA0B,uBAAO,IAAI,IAAkB,CAAC;CAE9D,MAAM,oBAAoB,OAAO,OAAO,YAAY,CAAC,CAAC,MACnD,WAAW,QAAQ,SAAS,WAC/B;CACA,MAAM,YACJ,MAAM,WAAW,eACjB,MAAM,WAAW,eACjB;CAEF,MAAM,WAAW,cAAc;EAC7B,MAAM,uBAAuB,wBAAwB;EACrD,MAAM,aAAa,IAAI,IACrB,MAAM,KAAK,SAAS,KAAK,YAAY,QAAQ,EAAE,CACjD;EACA,KAAK,MAAM,aAAa,qBAAqB,KAAK,GAChD,IAAI,CAAC,WAAW,IAAI,SAAS,GAAG,qBAAqB,OAAO,SAAS;EAGvE,OAAO,mBAAmB,MAAM,MAAM;GACpC;GACA,eAAe,YAAY;IACzB,MAAM,WAAW,qBAAqB,IAAI,QAAQ,EAAE;IACpD,IAAI,UAAU,OAAO;IAErB,MAAM,4BAAY,IAAI,KAAK;IAC3B,qBAAqB,IAAI,QAAQ,IAAI,SAAS;IAC9C,OAAO;GACT;EACF,CAAC;CACH,GAAG,CAAC,MAAM,MAAM,SAAS,CAAC;CAE1B,OAAO,wBAAwB;EAC7B,GAAG,+BAA+B,OAAO;EACzC;EACA;EACA,gCAAgC;EAChC;EACA,UAAU;GACR,aAAa,UAAU,eAAe,iBAAiB;GACvD,QAAQ,UAAU;GAClB,WAAW,UAAU;GACrB,OAAO,UAAU;GACjB,UAAU,UAAU;EACtB;EACA,OAAO,OAAO,YAAY;GACxB,MAAM,MAAM,KAAK,EAAE,SAAS,qBAAqB,OAAO,EAAE,CAAC;EAC7D;EACA,gBAAgB;GACd,MAAM,KAAK;GACX,OAAO,QAAQ,QAAQ;EACzB;EACA,yBAAyB,OAAO,aAAa;GAC3C,MAAM,MAAM,KAAK,EAAE,gBAAgB,CAAC,mBAAmB,QAAQ,CAAC,EAAE,CAAC;EACrE;CACF,CAAC;AACH"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@assistant-ui/eve",
+  "version": "0.0.0",
+  "description": "Eve runtime adapter for assistant-ui",
+  "keywords": [
+    "eve",
+    "assistant-ui",
+    "react",
+    "ai",
+    "chat",
+    "agents"
+  ],
+  "author": "AgentbaseAI Inc.",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "dependencies": {
+    "@assistant-ui/core": "^0.2.18"
+  },
+  "peerDependencies": {
+    "@types/react": "*",
+    "eve": "^0.11.4",
+    "react": "^18 || ^19"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.17",
+    "eve": "^0.11.4",
+    "react": "^19.2.7",
+    "vitest": "^4.1.8",
+    "@assistant-ui/x-buildutils": "0.0.15"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "homepage": "https://www.assistant-ui.com/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/assistant-ui/assistant-ui.git",
+    "directory": "packages/eve"
+  },
+  "bugs": {
+    "url": "https://github.com/assistant-ui/assistant-ui/issues"
+  },
+  "scripts": {
+    "build": "aui-build",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/convertEveMessages.test.ts

@@ -0,0 +1,193 @@
+import { describe, expect, it } from "vitest";
+import type { EveMessageData } from "eve/react";
+import {
+  convertEveMessages,
+  getEveMessageContent,
+  toEveInputResponse,
+} from "./convertEveMessages";
+import type { AppendMessage } from "@assistant-ui/core";
+
+describe("convertEveMessages", () => {
+  it("converts text and reasoning parts", () => {
+    const data = {
+      messages: [
+        {
+          id: "u1",
+          role: "user",
+          parts: [{ type: "text", text: "Hello" }],
+        },
+        {
+          id: "a1",
+          role: "assistant",
+          metadata: { status: "streaming" },
+          parts: [
+            { type: "reasoning", text: "Thinking" },
+            { type: "text", text: "Hi there" },
+          ],
+        },
+      ],
+    } satisfies EveMessageData;
+
+    const messages = convertEveMessages(data, { isRunning: true });
+
+    expect(messages).toHaveLength(2);
+    expect(messages[0]).toMatchObject({
+      id: "u1",
+      role: "user",
+      content: [{ type: "text", text: "Hello" }],
+    });
+    expect(messages[1]).toMatchObject({
+      id: "a1",
+      role: "assistant",
+      status: { type: "running" },
+      content: [
+        { type: "reasoning", text: "Thinking" },
+        { type: "text", text: "Hi there" },
+      ],
+    });
+  });
+
+  it("converts dynamic tool parts with approval options", () => {
+    const data = {
+      messages: [
+        {
+          id: "a1",
+          role: "assistant",
+          parts: [
+            {
+              type: "dynamic-tool",
+              state: "approval-requested",
+              toolCallId: "call_1",
+              toolName: "send_email",
+              input: { to: "dev@example.com" },
+              approval: { id: "req_1" },
+              toolMetadata: {
+                eve: {
+                  kind: "tool-call",
+                  name: "send_email",
+                  inputRequest: {
+                    requestId: "req_1",
+                    prompt: "Send the email?",
+                    display: "confirmation",
+                    options: [
+                      { id: "approve", label: "Approve" },
+                      { id: "deny", label: "Deny", style: "danger" },
+                      { id: "escalate", label: "Escalate" },
+                    ],
+                  },
+                },
+              },
+            },
+          ],
+        },
+      ],
+    } satisfies EveMessageData;
+
+    const [message] = convertEveMessages(data);
+
+    expect(message).toMatchObject({
+      status: { type: "requires-action", reason: "tool-calls" },
+      content: [
+        {
+          type: "tool-call",
+          toolCallId: "call_1",
+          toolName: "send_email",
+          args: { to: "dev@example.com" },
+          approval: {
+            id: "req_1",
+            options: [
+              { id: "approve", kind: "allow-once", label: "Approve" },
+              { id: "deny", kind: "reject-once", label: "Deny" },
+              { id: "escalate", kind: "_escalate", label: "Escalate" },
+            ],
+          },
+        },
+      ],
+    });
+  });
+
+  it("handles denied tool parts without approval metadata", () => {
+    const data = {
+      messages: [
+        {
+          id: "a1",
+          role: "assistant",
+          parts: [
+            {
+              type: "dynamic-tool",
+              state: "output-denied",
+              toolCallId: "call_1",
+              toolName: "send_email",
+              input: { to: "dev@example.com" },
+            },
+          ],
+        },
+      ],
+    } satisfies EveMessageData;
+
+    const [message] = convertEveMessages(data);
+
+    expect(message).toMatchObject({
+      content: [
+        {
+          type: "tool-call",
+          toolCallId: "call_1",
+          toolName: "send_email",
+          result: { error: "Tool approval denied" },
+          isError: true,
+        },
+      ],
+    });
+  });
+
+  it("uses the supplied message creation time", () => {
+    const createdAt = new Date("2026-06-17T00:00:00.000Z");
+    const data = {
+      messages: [
+        {
+          id: "u1",
+          role: "user",
+          parts: [{ type: "text", text: "Hello" }],
+        },
+      ],
+    } satisfies EveMessageData;
+
+    const [message] = convertEveMessages(data, {
+      getCreatedAt: () => createdAt,
+    });
+
+    expect(message?.createdAt).toBe(createdAt);
+  });
+});
+
+describe("getEveMessageContent", () => {
+  it("returns plain text for text-only messages", () => {
+    const message = {
+      role: "user",
+      parentId: null,
+      sourceId: null,
+      runConfig: undefined,
+      content: [{ type: "text", text: "Hello" }],
+      metadata: { custom: {} },
+      attachments: [],
+    } satisfies AppendMessage;
+
+    expect(getEveMessageContent(message)).toBe("Hello");
+  });
+});
+
+describe("toEveInputResponse", () => {
+  it("maps assistant-ui approval responses to eve input responses", () => {
+    expect(
+      toEveInputResponse({
+        approvalId: "req_1",
+        approved: false,
+        reason: "Not yet",
+      }),
+    ).toEqual({
+      requestId: "req_1",
+      optionId: "deny",
+      text: "Not yet",
+    });
+  });
+});

package/src/convertEveMessages.ts

@@ -0,0 +1,345 @@
+import type {
+  AppendMessage,
+  MessageStatus,
+  RespondToToolApprovalOptions,
+  TextMessagePart,
+  ThreadAssistantMessagePart,
+  ThreadMessage,
+  ThreadUserMessagePart,
+  ToolApprovalOption,
+  ToolCallMessagePart,
+} from "@assistant-ui/core";
+import type {
+  EveDynamicToolPart,
+  EveMessage,
+  EveMessageData,
+  EveMessageInputRequest,
+  EveMessagePart,
+  InputResponse,
+  SendTurnPayload,
+} from "eve/react";
+
+const ASSISTANT_COMPLETE_STATUS = {
+  type: "complete",
+  reason: "stop",
+} satisfies MessageStatus;
+
+const ASSISTANT_RUNNING_STATUS = {
+  type: "running",
+} satisfies MessageStatus;
+
+const USER_FALLBACK_STATUS = {
+  type: "complete",
+  reason: "unknown",
+} satisfies MessageStatus;
+
+export type ConvertEveMessagesOptions = {
+  /**
+   * Marks the last assistant message as running while Eve is submitting or
+   * streaming.
+   */
+  readonly isRunning?: boolean | undefined;
+  readonly getCreatedAt?: ((message: EveMessage) => Date) | undefined;
+};
+
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null && !Array.isArray(value);
+
+const toJsonObject = (value: unknown): Record<string, unknown> => {
+  if (isRecord(value)) return value;
+  if (value === undefined) return {};
+  return { value };
+};
+
+const stringifyArgs = (value: unknown): string => {
+  try {
+    return JSON.stringify(value ?? {});
+  } catch {
+    return "";
+  }
+};
+
+const toMessageStatus = (
+  message: EveMessage,
+  index: number,
+  messages: readonly EveMessage[],
+  options: ConvertEveMessagesOptions,
+): MessageStatus => {
+  if (message.role !== "assistant") return USER_FALLBACK_STATUS;
+
+  const hasPendingApproval = message.parts.some(
+    (part) =>
+      part.type === "dynamic-tool" && part.state === "approval-requested",
+  );
+
+  if (hasPendingApproval) {
+    return { type: "requires-action", reason: "tool-calls" };
+  }
+
+  if (message.metadata?.status === "failed") {
+    return { type: "incomplete", reason: "error" };
+  }
+
+  if (
+    message.metadata?.status === "streaming" ||
+    (options.isRunning === true && index === messages.length - 1)
+  ) {
+    return ASSISTANT_RUNNING_STATUS;
+  }
+
+  return ASSISTANT_COMPLETE_STATUS;
+};
+
+const toolApprovalOptionsFromInputRequest = (
+  inputRequest: EveMessageInputRequest | undefined,
+): readonly ToolApprovalOption[] | undefined => {
+  const options = inputRequest?.options;
+  if (!options || options.length === 0) return undefined;
+
+  return options.map((option) => ({
+    id: option.id,
+    kind:
+      option.id === "approve"
+        ? "allow-once"
+        : option.id === "deny"
+          ? "reject-once"
+          : `_${option.id}`,
+    ...(option.label && { label: option.label }),
+    ...(option.description && { description: option.description }),
+  }));
+};
+
+const toApproval = (
+  part: EveDynamicToolPart,
+): ToolCallMessagePart["approval"] | undefined => {
+  if (
+    part.state !== "approval-requested" &&
+    part.state !== "approval-responded" &&
+    part.state !== "output-available" &&
+    part.state !== "output-error" &&
+    part.state !== "output-denied"
+  ) {
+    return undefined;
+  }
+
+  const approval = part.approval;
+  if (!approval) return undefined;
+  const options = toolApprovalOptionsFromInputRequest(
+    part.toolMetadata?.eve?.inputRequest,
+  );
+
+  return {
+    id: approval.id,
+    ...(approval.approved !== undefined && { approved: approval.approved }),
+    ...(approval.reason && { reason: approval.reason }),
+    ...(approval.isAutomatic !== undefined && {
+      isAutomatic: approval.isAutomatic,
+    }),
+    ...(options && { options }),
+  };
+};
+
+const convertDynamicToolPart = (
+  part: EveDynamicToolPart,
+): ToolCallMessagePart => {
+  const approval = toApproval(part);
+  const toolCall: ToolCallMessagePart = {
+    type: "tool-call",
+    toolCallId: part.toolCallId,
+    toolName: part.toolName,
+    args: toJsonObject(part.input),
+    argsText: stringifyArgs(part.input),
+    ...(approval && { approval }),
+  };
+
+  switch (part.state) {
+    case "output-available":
+      return { ...toolCall, result: part.output };
+
+    case "output-error":
+      return {
+        ...toolCall,
+        result: { error: part.errorText },
+        isError: true,
+      };
+
+    case "output-denied":
+      return {
+        ...toolCall,
+        result: { error: part.approval?.reason ?? "Tool approval denied" },
+        isError: true,
+      };
+
+    default:
+      return toolCall;
+  }
+};
+
+const convertAssistantPart = (
+  part: EveMessagePart,
+): ThreadAssistantMessagePart | null => {
+  switch (part.type) {
+    case "text":
+    case "reasoning":
+      return { type: part.type, text: part.text };
+
+    case "step-start":
+      return null;
+
+    case "dynamic-tool":
+      return convertDynamicToolPart(part);
+
+    default:
+      return null;
+  }
+};
+
+const convertUserPart = (
+  part: EveMessagePart,
+): ThreadUserMessagePart | null => {
+  switch (part.type) {
+    case "text":
+      return { type: "text", text: part.text };
+
+    default:
+      return null;
+  }
+};
+
+/**
+ * Converts a single Eve message into an assistant-ui thread message.
+ */
+export const convertEveMessage = (
+  message: EveMessage,
+  index: number,
+  messages: readonly EveMessage[],
+  options: ConvertEveMessagesOptions = {},
+): ThreadMessage => {
+  const createdAt = options.getCreatedAt?.(message) ?? new Date();
+  const metadata = {
+    ...(message.metadata?.optimistic && { isOptimistic: true }),
+    custom: {
+      ...(message.metadata ?? {}),
+    },
+  };
+
+  const content =
+    message.role === "assistant"
+      ? message.parts.map(convertAssistantPart).filter((part) => part !== null)
+      : message.parts.map(convertUserPart).filter((part) => part !== null);
+
+  const fallbackTextPart: TextMessagePart = {
+    type: "text",
+    text: "",
+  };
+
+  if (message.role === "user") {
+    return {
+      id: message.id,
+      createdAt,
+      role: "user",
+      content:
+        content.length > 0
+          ? (content as readonly ThreadUserMessagePart[])
+          : [fallbackTextPart],
+      attachments: [],
+      metadata,
+    };
+  }
+
+  return {
+    id: message.id,
+    createdAt,
+    role: "assistant",
+    content:
+      content.length > 0
+        ? (content as readonly ThreadAssistantMessagePart[])
+        : [],
+    status: toMessageStatus(message, index, messages, options),
+    metadata: {
+      unstable_state: null,
+      unstable_annotations: [],
+      unstable_data: [],
+      steps: [],
+      ...metadata,
+    },
+  };
+};
+
+/**
+ * Converts the full Eve message data object into assistant-ui thread messages.
+ */
+export const convertEveMessages = (
+  data: EveMessageData,
+  options: ConvertEveMessagesOptions = {},
+): ThreadMessage[] =>
+  data.messages.map((message, index, messages) =>
+    convertEveMessage(message, index, messages, options),
+  );
+
+/**
+ * Converts an assistant-ui append message into the message payload accepted by
+ * Eve's `send` API.
+ */
+export const getEveMessageContent = (
+  message: AppendMessage,
+): NonNullable<SendTurnPayload["message"]> => {
+  const content = [
+    ...message.content,
+    ...(message.attachments?.flatMap((attachment) => attachment.content) ?? []),
+  ];
+
+  const parts = content.map((part) => {
+    const type = part.type;
+    switch (type) {
+      case "text":
+        return { type: "text" as const, text: part.text };
+
+      case "file":
+        return {
+          type: "file" as const,
+          data: part.data,
+          mediaType: part.mimeType,
+          ...(part.filename && { filename: part.filename }),
+        };
+
+      case "image":
+        return {
+          type: "file" as const,
+          data: part.image,
+          mediaType: "image/*",
+          ...(part.filename && { filename: part.filename }),
+        };
+
+      default: {
+        const _exhaustiveCheck:
+          | "audio"
+          | "data"
+          | "generative-ui"
+          | "reasoning"
+          | "source"
+          | "tool-call" = type;
+        throw new Error(
+          `Unsupported eve append message part type: ${_exhaustiveCheck}`,
+        );
+      }
+    }
+  });
+
+  if (parts.length === 1 && parts[0]?.type === "text") {
+    return parts[0].text;
+  }
+
+  return parts;
+};
+
+/**
+ * Converts an assistant-ui tool approval response into an Eve input response.
+ */
+export const toEveInputResponse = (
+  response: RespondToToolApprovalOptions,
+): InputResponse => ({
+  requestId: response.approvalId,
+  optionId: response.optionId ?? (response.approved ? "approve" : "deny"),
+  ...(response.reason && { text: response.reason }),
+});

package/src/index.ts

@@ -0,0 +1,10 @@
+/// <reference types="@assistant-ui/core/react" />
+
+export {
+  convertEveMessage,
+  convertEveMessages,
+  getEveMessageContent,
+} from "./convertEveMessages";
+export type { ConvertEveMessagesOptions } from "./convertEveMessages";
+export { useEveAgentRuntime } from "./useEveAgentRuntime";
+export type { UseEveAgentRuntimeOptions } from "./useEveAgentRuntime";

package/src/useEveAgentRuntime.ts

@@ -0,0 +1,127 @@
+"use client";
+
+import { useMemo, useRef, useState } from "react";
+import {
+  pickExternalStoreSharedOptions,
+  type AttachmentAdapter,
+  type DictationAdapter,
+  type ExternalStoreSharedOptions,
+  type FeedbackAdapter,
+  type RealtimeVoiceAdapter,
+  type SpeechSynthesisAdapter,
+  type ToolExecutionStatus,
+} from "@assistant-ui/core";
+import {
+  useExternalStoreRuntime,
+  useRuntimeAdapters,
+} from "@assistant-ui/core/react";
+import {
+  useEveAgent,
+  type EveMessageData,
+  type UseEveAgentOptions,
+} from "eve/react";
+import {
+  convertEveMessages,
+  getEveMessageContent,
+  toEveInputResponse,
+} from "./convertEveMessages";
+
+export type UseEveAgentRuntimeOptions = Omit<
+  UseEveAgentOptions<EveMessageData>,
+  "reducer"
+> &
+  ExternalStoreSharedOptions & {
+    readonly adapters?:
+      | {
+          readonly attachments?: AttachmentAdapter | undefined;
+          readonly speech?: SpeechSynthesisAdapter | undefined;
+          readonly dictation?: DictationAdapter | undefined;
+          readonly voice?: RealtimeVoiceAdapter | undefined;
+          readonly feedback?: FeedbackAdapter | undefined;
+        }
+      | undefined;
+  };
+
+/**
+ * Connects Eve's `useEveAgent` hook to assistant-ui's runtime contract.
+ *
+ * The runtime renders Eve messages, forwards new user messages to the Eve
+ * session, supports cancellation, and maps Eve input requests to assistant-ui
+ * tool approval UI.
+ */
+export const useEveAgentRuntime = (options: UseEveAgentRuntimeOptions = {}) => {
+  const {
+    adapters,
+    isDisabled: _isDisabled,
+    isSendDisabled: _isSendDisabled,
+    suggestions: _suggestions,
+    unstable_capabilities: _unstable_capabilities,
+    ...agentOptions
+  } = options;
+  true satisfies keyof typeof agentOptions &
+    keyof ExternalStoreSharedOptions extends never
+    ? true
+    : never;
+
+  const agent = useEveAgent(agentOptions);
+  const runtimeAdapters = useRuntimeAdapters();
+  const [toolStatuses, setToolStatuses] = useState<
+    Record<string, ToolExecutionStatus>
+  >({});
+  const createdAtByMessageIdRef = useRef(new Map<string, Date>());
+
+  const hasExecutingTools = Object.values(toolStatuses).some(
+    (status) => status?.type === "executing",
+  );
+  const isRunning =
+    agent.status === "submitted" ||
+    agent.status === "streaming" ||
+    hasExecutingTools;
+
+  const messages = useMemo(() => {
+    const createdAtByMessageId = createdAtByMessageIdRef.current;
+    const messageIds = new Set(
+      agent.data.messages.map((message) => message.id),
+    );
+    for (const messageId of createdAtByMessageId.keys()) {
+      if (!messageIds.has(messageId)) createdAtByMessageId.delete(messageId);
+    }
+
+    return convertEveMessages(agent.data, {
+      isRunning,
+      getCreatedAt: (message) => {
+        const existing = createdAtByMessageId.get(message.id);
+        if (existing) return existing;
+
+        const createdAt = new Date();
+        createdAtByMessageId.set(message.id, createdAt);
+        return createdAt;
+      },
+    });
+  }, [agent.data, isRunning]);
+
+  return useExternalStoreRuntime({
+    ...pickExternalStoreSharedOptions(options),
+    messages,
+    isRunning,
+    unstable_enableToolInvocations: true,
+    setToolStatuses,
+    adapters: {
+      attachments: adapters?.attachments ?? runtimeAdapters?.attachments,
+      speech: adapters?.speech,
+      dictation: adapters?.dictation,
+      voice: adapters?.voice,
+      feedback: adapters?.feedback,
+    },
+    onNew: async (message) => {
+      await agent.send({ message: getEveMessageContent(message) });
+    },
+    onCancel: () => {
+      agent.stop();
+      return Promise.resolve();
+    },
+    onRespondToToolApproval: async (response) => {
+      await agent.send({ inputResponses: [toEveInputResponse(response)] });
+    },
+  });
+};