@better-agent/client 0.1.0-canary.5 → 0.2.0-beta.1

package/dist/solid/index.mjs

@@ -1,127 +1,59 @@
-import { t as AgentChatController } from "../controller-BrBUfjhZ.mjs";
-import { n as getLatestUserMessageId, r as normalizeSendInput, t as cloneControllerOptions } from "../utils-CiHUj_BW.mjs";
+import { n as createAgentController } from "../controller-xMlzSCc7.mjs";
 import { createRenderEffect, createSignal, onCleanup, onMount } from "solid-js";
 
 //#region src/solid/useAgent.ts
 const resolve = (value) => typeof value === "function" ? value() : value;
-/**
-* Solid primitive for talking to one Better Agent conversation.
-*
-* Returns reactive chat state and chat actions.
-*
-* @example
-* ```ts
-* const agent = useAgent(client, {
-*   agent: "assistant",
-*   conversationId: "conv_123",
-* });
-*
-* await agent.sendMessage("Hello");
-*
-* console.log(agent.messages());
-* console.log(agent.status());
-* agent.stop();
-* ```
-*
-* @example
-* ```tsx
-* function Chat() {
-*   const agent = useAgent(client, { agent: "assistant" });
-*
-*   return (
-*     <div>
-*       <For each={agent.messages()}>
-*         {(message) => <div>{message.role}</div>}
-*       </For>
-*       <button onClick={() => agent.sendMessage("Hello")}>Send</button>
-*     </div>
-*   );
-* }
-* ```
-*/
-function useAgent(client, options) {
-	const controller = new AgentChatController(resolve(client), cloneControllerOptions(resolve(options)));
+function useAgent(agent, options) {
+	const readOptions = () => options === void 0 ? {} : resolve(options) ?? {};
+	const toolHandlers = new Proxy({}, { get(_target, key) {
+		return readOptions().toolHandlers?.[key];
+	} });
+	const initialOptions = readOptions();
+	const controller = createAgentController(agent, {
+		initialMessages: initialOptions.initialMessages,
+		initialState: initialOptions.initialState,
+		initialInterruptState: initialOptions.initialInterruptState,
+		resume: initialOptions.resume,
+		context: initialOptions.context,
+		threadId: initialOptions.threadId,
+		toolHandlers,
+		onEvent: (event) => readOptions().onEvent?.(event),
+		onFinish: (finish) => readOptions().onFinish?.(finish),
+		onError: (error) => readOptions().onError?.(error)
+	});
 	const [snapshot, setSnapshot] = createSignal(controller.getSnapshot());
-	/** Pushes the latest client and options into the controller. */
-	const syncController = () => {
-		controller.updateClient(resolve(client));
-		controller.updateOptions(cloneControllerOptions(resolve(options)));
-	};
 	const unsubscribe = controller.subscribe(() => {
 		setSnapshot(controller.getSnapshot());
 	});
 	createRenderEffect(() => {
-		syncController();
+		readOptions();
 	});
 	onMount(() => {
-		syncController();
-		controller.init();
+		controller.start();
 	});
 	onCleanup(() => {
 		unsubscribe();
-		controller.destroy();
+		controller.stop();
 	});
-	const messages = () => snapshot().messages;
-	const id = () => snapshot().id;
-	const status = () => snapshot().status;
-	const error = () => snapshot().error;
-	const streamId = () => snapshot().streamId;
-	const runId = () => snapshot().runId;
-	const isLoading = () => snapshot().isLoading;
-	const isStreaming = () => snapshot().isStreaming;
-	const conversationId = () => snapshot().conversationId;
-	const pendingToolApprovals = () => snapshot().pendingToolApprovals;
 	return {
-		id,
-		messages,
-		status,
-		error,
-		streamId,
-		runId,
-		conversationId,
-		isLoading,
-		isStreaming,
-		pendingToolApprovals,
-		sendMessage: (input, requestOptions) => {
-			syncController();
-			return controller.sendMessage(normalizeSendInput(input), requestOptions);
-		},
-		regenerate: async () => {
-			syncController();
-			await controller.retryMessage(getLatestUserMessageId(controller));
-		},
-		retryMessage: (localId) => {
-			syncController();
-			return controller.retryMessage(localId);
-		},
-		stop: () => {
-			syncController();
-			controller.stop();
-		},
-		resumeStream: (resumeOptions) => {
-			syncController();
-			return controller.resumeStream(resumeOptions);
-		},
-		resumeConversation: (resumeOptions) => {
-			syncController();
-			return controller.resumeConversation(resumeOptions);
-		},
-		approveToolCall: (params) => {
-			syncController();
-			return controller.approveToolCall(params);
-		},
-		clearError: () => {
-			syncController();
-			controller.clearError();
-		},
-		reset: () => {
-			syncController();
-			controller.reset();
-		},
-		setMessages: (input) => {
-			syncController();
-			controller.setMessages(input);
-		}
+		messages: () => snapshot().messages,
+		state: () => snapshot().state,
+		status: () => snapshot().status,
+		error: () => snapshot().error,
+		runId: () => snapshot().runId,
+		threadId: () => snapshot().threadId,
+		isRunning: () => snapshot().isRunning,
+		pendingClientTools: () => snapshot().pendingClientTools,
+		pendingToolApprovals: () => snapshot().pendingToolApprovals,
+		sendMessage: (input, sendOptions) => controller.sendMessage(input, sendOptions),
+		stop: () => controller.stop(),
+		resume: (resume) => controller.resume(resume),
+		selectThread: (threadId) => controller.selectThread(threadId),
+		clearThread: () => controller.clearThread(),
+		loadMessages: (threadId) => controller.loadMessages(threadId),
+		approveToolCall: (interruptId, metadata) => controller.approveToolCall(interruptId, metadata),
+		rejectToolCall: (interruptId, metadata) => controller.rejectToolCall(interruptId, metadata),
+		setMessages: (messages) => controller.setMessages(messages)
 	};
 }
 

package/dist/solid/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/solid/useAgent.ts"],"sourcesContent":["import { createRenderEffect, createSignal, onCleanup, onMount } from \"solid-js\";\nimport { AgentChatController } from \"../core/controller\";\nimport {\n    cloneControllerOptions,\n    getLatestUserMessageId,\n    normalizeSendInput,\n} from \"../framework-internals/utils\";\nimport type { BetterAgentClient } from \"../types/client\";\nimport type { AgentNameFromApp } from \"../types/client-type-helpers\";\nimport type { MaybeAccessor, UseAgentOptions, UseAgentResult } from \"./types\";\n\nconst resolve = <T>(value: MaybeAccessor<T>): T =>\n    typeof value === \"function\" ? (value as () => T)() : value;\n\n/**\n * Solid primitive for talking to one Better Agent conversation.\n *\n * Returns reactive chat state and chat actions.\n *\n * @example\n * ```ts\n * const agent = useAgent(client, {\n *   agent: \"assistant\",\n *   conversationId: \"conv_123\",\n * });\n *\n * await agent.sendMessage(\"Hello\");\n *\n * console.log(agent.messages());\n * console.log(agent.status());\n * agent.stop();\n * ```\n *\n * @example\n * ```tsx\n * function Chat() {\n *   const agent = useAgent(client, { agent: \"assistant\" });\n *\n *   return (\n *     <div>\n *       <For each={agent.messages()}>\n *         {(message) => <div>{message.role}</div>}\n *       </For>\n *       <button onClick={() => agent.sendMessage(\"Hello\")}>Send</button>\n *     </div>\n *   );\n * }\n * ```\n */\nexport function useAgent<\n    TApp = unknown,\n    TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>,\n>(\n    client: MaybeAccessor<BetterAgentClient<TApp>>,\n    options: MaybeAccessor<UseAgentOptions<TApp, TAgentName>>,\n): UseAgentResult<TApp, TAgentName> {\n    const controller = new AgentChatController<TApp, TAgentName>(\n        resolve(client),\n        cloneControllerOptions(resolve(options)),\n    );\n    const [snapshot, setSnapshot] = createSignal(controller.getSnapshot());\n\n    /** Pushes the latest client and options into the controller. */\n    const syncController = () => {\n        controller.updateClient(resolve(client));\n        controller.updateOptions(\n            cloneControllerOptions(resolve(options)) as UseAgentOptions<TApp, TAgentName>,\n        );\n    };\n\n    const unsubscribe = controller.subscribe(() => {\n        setSnapshot(controller.getSnapshot());\n    });\n\n    createRenderEffect(() => {\n        syncController();\n    });\n\n    onMount(() => {\n        syncController();\n        controller.init();\n    });\n\n    onCleanup(() => {\n        unsubscribe();\n        controller.destroy();\n    });\n\n    const messages = () => snapshot().messages;\n    const id = () => snapshot().id;\n    const status = () => snapshot().status;\n    const error = () => snapshot().error;\n    const streamId = () => snapshot().streamId;\n    const runId = () => snapshot().runId;\n    const isLoading = () => snapshot().isLoading;\n    const isStreaming = () => snapshot().isStreaming;\n    const conversationId = () => snapshot().conversationId;\n    const pendingToolApprovals = () => snapshot().pendingToolApprovals;\n\n    return {\n        id,\n        messages,\n        status,\n        error,\n        streamId,\n        runId,\n        conversationId,\n        isLoading,\n        isStreaming,\n        pendingToolApprovals,\n        sendMessage: (input, requestOptions) => {\n            syncController();\n            return controller.sendMessage(normalizeSendInput(input), requestOptions);\n        },\n        regenerate: async () => {\n            syncController();\n            await controller.retryMessage(getLatestUserMessageId(controller));\n        },\n        retryMessage: (localId) => {\n            syncController();\n            return controller.retryMessage(localId);\n        },\n        stop: () => {\n            syncController();\n            controller.stop();\n        },\n        resumeStream: (resumeOptions) => {\n            syncController();\n            return controller.resumeStream(resumeOptions);\n        },\n        resumeConversation: (resumeOptions) => {\n            syncController();\n            return controller.resumeConversation(resumeOptions);\n        },\n        approveToolCall: (params) => {\n            syncController();\n            return controller.approveToolCall(params);\n        },\n        clearError: () => {\n            syncController();\n            controller.clearError();\n        },\n        reset: () => {\n            syncController();\n            controller.reset();\n        },\n        setMessages: (input) => {\n            syncController();\n            controller.setMessages(input);\n        },\n    };\n}\n"],"mappings":";;;;;AAWA,MAAM,WAAc,UAChB,OAAO,UAAU,aAAc,OAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCzD,SAAgB,SAIZ,QACA,SACgC;CAChC,MAAM,aAAa,IAAI,oBACnB,QAAQ,OAAO,EACf,uBAAuB,QAAQ,QAAQ,CAAC,CAC3C;CACD,MAAM,CAAC,UAAU,eAAe,aAAa,WAAW,aAAa,CAAC;;CAGtE,MAAM,uBAAuB;AACzB,aAAW,aAAa,QAAQ,OAAO,CAAC;AACxC,aAAW,cACP,uBAAuB,QAAQ,QAAQ,CAAC,CAC3C;;CAGL,MAAM,cAAc,WAAW,gBAAgB;AAC3C,cAAY,WAAW,aAAa,CAAC;GACvC;AAEF,0BAAyB;AACrB,kBAAgB;GAClB;AAEF,eAAc;AACV,kBAAgB;AAChB,aAAW,MAAM;GACnB;AAEF,iBAAgB;AACZ,eAAa;AACb,aAAW,SAAS;GACtB;CAEF,MAAM,iBAAiB,UAAU,CAAC;CAClC,MAAM,WAAW,UAAU,CAAC;CAC5B,MAAM,eAAe,UAAU,CAAC;CAChC,MAAM,cAAc,UAAU,CAAC;CAC/B,MAAM,iBAAiB,UAAU,CAAC;CAClC,MAAM,cAAc,UAAU,CAAC;CAC/B,MAAM,kBAAkB,UAAU,CAAC;CACnC,MAAM,oBAAoB,UAAU,CAAC;CACrC,MAAM,uBAAuB,UAAU,CAAC;CACxC,MAAM,6BAA6B,UAAU,CAAC;AAE9C,QAAO;EACH;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,cAAc,OAAO,mBAAmB;AACpC,mBAAgB;AAChB,UAAO,WAAW,YAAY,mBAAmB,MAAM,EAAE,eAAe;;EAE5E,YAAY,YAAY;AACpB,mBAAgB;AAChB,SAAM,WAAW,aAAa,uBAAuB,WAAW,CAAC;;EAErE,eAAe,YAAY;AACvB,mBAAgB;AAChB,UAAO,WAAW,aAAa,QAAQ;;EAE3C,YAAY;AACR,mBAAgB;AAChB,cAAW,MAAM;;EAErB,eAAe,kBAAkB;AAC7B,mBAAgB;AAChB,UAAO,WAAW,aAAa,cAAc;;EAEjD,qBAAqB,kBAAkB;AACnC,mBAAgB;AAChB,UAAO,WAAW,mBAAmB,cAAc;;EAEvD,kBAAkB,WAAW;AACzB,mBAAgB;AAChB,UAAO,WAAW,gBAAgB,OAAO;;EAE7C,kBAAkB;AACd,mBAAgB;AAChB,cAAW,YAAY;;EAE3B,aAAa;AACT,mBAAgB;AAChB,cAAW,OAAO;;EAEtB,cAAc,UAAU;AACpB,mBAAgB;AAChB,cAAW,YAAY,MAAM;;EAEpC"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/solid/useAgent.ts"],"sourcesContent":["import { createRenderEffect, createSignal, onCleanup, onMount } from \"solid-js\";\nimport { createAgentController } from \"../core/controller\";\nimport type { AgentNameOf } from \"../core/inference\";\nimport type {\n    AgentControllerOptions,\n    BetterAgentClientAgentHandle,\n    BetterAgentClientAgentMemoryHandle,\n} from \"../types\";\nimport type { MaybeAccessor, UseAgentOptions, UseAgentResult } from \"./types\";\n\nconst resolve = <T>(value: MaybeAccessor<T>): T =>\n    typeof value === \"function\" ? (value as () => T)() : value;\n\nexport function useAgent<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(\n    agent: BetterAgentClientAgentMemoryHandle<TApp, TName>,\n    options?: MaybeAccessor<UseAgentOptions<TApp, TName> | undefined>,\n): UseAgentResult<TApp, TName>;\nexport function useAgent<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(\n    agent: BetterAgentClientAgentHandle<TApp, TName>,\n    options?: MaybeAccessor<UseAgentOptions<TApp, TName> | undefined>,\n): UseAgentResult<TApp, TName>;\nexport function useAgent<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(\n    agent: BetterAgentClientAgentHandle<TApp, TName>,\n    options?: MaybeAccessor<UseAgentOptions<TApp, TName> | undefined>,\n): UseAgentResult<TApp, TName> {\n    const readOptions = (): UseAgentOptions<TApp, TName> =>\n        (options === undefined ? {} : (resolve(options) ?? {})) as UseAgentOptions<TApp, TName>;\n    const toolHandlers = new Proxy(\n        {},\n        {\n            get(_target, key) {\n                const handlers = readOptions().toolHandlers as\n                    | Record<PropertyKey, unknown>\n                    | undefined;\n                return handlers?.[key];\n            },\n        },\n    ) as AgentControllerOptions<TApp, TName>[\"toolHandlers\"];\n\n    const initialOptions = readOptions();\n    const controller = createAgentController<TApp, TName>(agent, {\n        initialMessages: initialOptions.initialMessages,\n        initialState: initialOptions.initialState,\n        initialInterruptState: initialOptions.initialInterruptState,\n        resume: initialOptions.resume,\n        context: initialOptions.context,\n        threadId: initialOptions.threadId,\n        toolHandlers,\n        onEvent: (event) => readOptions().onEvent?.(event),\n        onFinish: (finish) => readOptions().onFinish?.(finish),\n        onError: (error) => readOptions().onError?.(error),\n    });\n    const [snapshot, setSnapshot] = createSignal(controller.getSnapshot());\n\n    const unsubscribe = controller.subscribe(() => {\n        setSnapshot(controller.getSnapshot());\n    });\n\n    createRenderEffect(() => {\n        readOptions();\n    });\n\n    onMount(() => {\n        controller.start();\n    });\n\n    onCleanup(() => {\n        unsubscribe();\n        controller.stop();\n    });\n\n    return {\n        messages: () => snapshot().messages,\n        state: () => snapshot().state,\n        status: () => snapshot().status,\n        error: () => snapshot().error,\n        runId: () => snapshot().runId,\n        threadId: () => snapshot().threadId,\n        isRunning: () => snapshot().isRunning,\n        pendingClientTools: () => snapshot().pendingClientTools,\n        pendingToolApprovals: () => snapshot().pendingToolApprovals,\n        sendMessage: (input, sendOptions) => controller.sendMessage(input, sendOptions),\n        stop: () => controller.stop(),\n        resume: (resume) => controller.resume(resume),\n        selectThread: (threadId) => controller.selectThread(threadId),\n        clearThread: () => controller.clearThread(),\n        loadMessages: (threadId) => controller.loadMessages(threadId),\n        approveToolCall: (interruptId, metadata) =>\n            controller.approveToolCall(interruptId, metadata),\n        rejectToolCall: (interruptId, metadata) => controller.rejectToolCall(interruptId, metadata),\n        setMessages: (messages) => controller.setMessages(messages),\n    };\n}\n"],"mappings":";;;;AAUA,MAAM,WAAc,UAChB,OAAO,UAAU,aAAc,OAAmB,GAAG;AAUzD,SAAgB,SACZ,OACA,SAC2B;CAC3B,MAAM,oBACD,YAAY,SAAY,EAAE,GAAI,QAAQ,QAAQ,IAAI,EAAE;CACzD,MAAM,eAAe,IAAI,MACrB,EAAE,EACF,EACI,IAAI,SAAS,KAAK;AAId,SAHiB,aAAa,CAAC,eAGb;IAEzB,CACJ;CAED,MAAM,iBAAiB,aAAa;CACpC,MAAM,aAAa,sBAAmC,OAAO;EACzD,iBAAiB,eAAe;EAChC,cAAc,eAAe;EAC7B,uBAAuB,eAAe;EACtC,QAAQ,eAAe;EACvB,SAAS,eAAe;EACxB,UAAU,eAAe;EACzB;EACA,UAAU,UAAU,aAAa,CAAC,UAAU,MAAM;EAClD,WAAW,WAAW,aAAa,CAAC,WAAW,OAAO;EACtD,UAAU,UAAU,aAAa,CAAC,UAAU,MAAM;EACrD,CAAC;CACF,MAAM,CAAC,UAAU,eAAe,aAAa,WAAW,aAAa,CAAC;CAEtE,MAAM,cAAc,WAAW,gBAAgB;AAC3C,cAAY,WAAW,aAAa,CAAC;GACvC;AAEF,0BAAyB;AACrB,eAAa;GACf;AAEF,eAAc;AACV,aAAW,OAAO;GACpB;AAEF,iBAAgB;AACZ,eAAa;AACb,aAAW,MAAM;GACnB;AAEF,QAAO;EACH,gBAAgB,UAAU,CAAC;EAC3B,aAAa,UAAU,CAAC;EACxB,cAAc,UAAU,CAAC;EACzB,aAAa,UAAU,CAAC;EACxB,aAAa,UAAU,CAAC;EACxB,gBAAgB,UAAU,CAAC;EAC3B,iBAAiB,UAAU,CAAC;EAC5B,0BAA0B,UAAU,CAAC;EACrC,4BAA4B,UAAU,CAAC;EACvC,cAAc,OAAO,gBAAgB,WAAW,YAAY,OAAO,YAAY;EAC/E,YAAY,WAAW,MAAM;EAC7B,SAAS,WAAW,WAAW,OAAO,OAAO;EAC7C,eAAe,aAAa,WAAW,aAAa,SAAS;EAC7D,mBAAmB,WAAW,aAAa;EAC3C,eAAe,aAAa,WAAW,aAAa,SAAS;EAC7D,kBAAkB,aAAa,aAC3B,WAAW,gBAAgB,aAAa,SAAS;EACrD,iBAAiB,aAAa,aAAa,WAAW,eAAe,aAAa,SAAS;EAC3F,cAAc,aAAa,WAAW,YAAY,SAAS;EAC9D"}

package/dist/svelte/index.d.mts

@@ -1,83 +1,30 @@
-import { K as AgentNameFromApp, M as BetterAgentClient, Y as ModalitiesForAgent, f as SendResult, i as ApproveToolCallParams, l as RetryResult, m as SubmitInput, n as AgentChatSnapshot, p as SetMessagesInput, t as AgentChatControllerOptions, u as SendMessageInputForAgent } from "../controller-CJ79_cSR.mjs";
+import { M as BetterAgentClientAgentMemoryHandle, U as AgentHasMemory, W as AgentNameOf, a as AgentControllerOptions, c as AgentInterruptState, j as BetterAgentClientAgentHandle, l as AgentMessageInput, o as AgentControllerSnapshot, p as SendOptions, t as AgentController, u as AgentStreamResume } from "../controller-B7G0xSYW.mjs";
 import { Readable } from "svelte/store";
 
 //#region src/svelte/types.d.ts
-/** Options for `createAgentChat`. */
-type AgentChatOptions<TApp = unknown, TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>> = AgentChatControllerOptions<TApp, TAgentName>;
-/** Snapshot shape exposed by the store. */
-type AgentChatState = AgentChatSnapshot;
-/** Return type of `createAgentChat`. */
-interface AgentChatStore<TApp = unknown, TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>> extends Readable<AgentChatSnapshot> {
-  /** Sends a message. */
-  sendMessage<const TModalities extends ModalitiesForAgent<TApp, TAgentName> | undefined = undefined>(input: SendMessageInputForAgent<TApp, TAgentName, TModalities>, options?: {
-    signal?: AbortSignal;
-  }): Promise<SendResult>;
-  /** Retries the most recent user message. */
-  regenerate(): Promise<void>;
-  /** Retries one user message. */
-  retryMessage(localId: string): Promise<RetryResult>;
-  /** Stops the active run or stream. */
-  stop(): void;
-  /** Resumes one stream. */
-  resumeStream(options: {
-    streamId: string;
-    afterSeq?: number;
-  }): Promise<void>;
-  /** Resumes the active conversation stream. */
-  resumeConversation(options?: {
-    afterSeq?: number;
-  }): Promise<void>;
-  /** Approves or denies a tool call. */
-  approveToolCall(params: ApproveToolCallParams): Promise<void>;
-  /** Clears the latest error. */
-  clearError(): void;
-  /** Resets local state. */
-  reset(): void;
-  /** Replaces the local messages. */
-  setMessages(input: SetMessagesInput): void;
-  /** Updates controller options for future actions. */
-  updateOptions(input: Partial<AgentChatControllerOptions<TApp, TAgentName>>): void;
-  /** Replaces the transport client for future actions. */
-  updateClient(client: BetterAgentClient<TApp>): void;
+interface AgentChatOptions<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>> extends Pick<AgentControllerOptions<TApp, TName>, "context" | "threadId" | "toolHandlers" | "onEvent" | "onFinish" | "onError"> {
+  initialMessages?: AgentControllerOptions<TApp, TName>["initialMessages"];
+  initialState?: unknown;
+  resume?: AgentStreamResume;
+  initialInterruptState?: AgentInterruptState;
 }
+type AgentChatState = AgentControllerSnapshot;
+type AgentChatStore<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>> = Readable<AgentControllerSnapshot> & {
+  sendMessage(input: AgentMessageInput, options?: SendOptions<TApp, TName>): Promise<void>;
+  stop(): void;
+  resume(input?: AgentStreamResume): Promise<void>;
+  approveToolCall(interruptId: string, metadata?: Record<string, unknown>): Promise<void>;
+  rejectToolCall(interruptId: string, metadata?: Record<string, unknown> | string): Promise<void>;
+  setMessages: AgentController<TApp, TName>["setMessages"];
+} & (AgentHasMemory<TApp, TName> extends true ? {
+  loadMessages(threadId?: string): Promise<void>;
+  selectThread(threadId: string): Promise<void>;
+  clearThread(): void;
+} : Record<never, never>);
 //#endregion
 //#region src/svelte/createAgentChat.d.ts
-/**
- * Creates a Svelte store for one Better Agent conversation.
- *
- * Returns a readable store plus chat actions.
- *
- * @example
- * ```ts
- * const agent = createAgentChat(client, {
- *   agent: "assistant",
- *   conversationId: "conv_123",
- * });
- *
- * await agent.sendMessage("Hello");
- *
- * const unsubscribe = agent.subscribe((snapshot) => {
- *   console.log(snapshot.messages);
- *   console.log(snapshot.status);
- * });
- *
- * unsubscribe();
- * ```
- *
- * @example
- * ```svelte
- * <script lang="ts">
- *   const agent = createAgentChat(client, { agent: "assistant" });
- * </script>
- *
- * {#each $agent.messages as message}
- *   <div>{message.role}</div>
- * {/each}
- *
- * <button on:click={() => agent.sendMessage("Hello")}>Send</button>
- * ```
- */
-declare function createAgentChat<TApp = unknown, TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>>(client: BetterAgentClient<TApp>, options: AgentChatOptions<TApp, TAgentName>): AgentChatStore<TApp, TAgentName>;
+declare function createAgentChat<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(agent: BetterAgentClientAgentMemoryHandle<TApp, TName>, options?: AgentChatOptions<TApp, TName>): AgentChatStore<TApp, TName>;
+declare function createAgentChat<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(agent: BetterAgentClientAgentHandle<TApp, TName>, options?: AgentChatOptions<TApp, TName>): AgentChatStore<TApp, TName>;
 //#endregion
-export { type AgentChatOptions, type AgentChatState, type AgentChatStore, type SetMessagesInput, type SubmitInput, createAgentChat };
+export { type AgentChatOptions, type AgentChatState, type AgentChatStore, createAgentChat };
 //# sourceMappingURL=index.d.mts.map

package/dist/svelte/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/svelte/types.ts","../../src/svelte/createAgentChat.ts"],"mappings":";;;;;KAgBY,gBAAA,oCAEW,gBAAA,CAAiB,IAAA,IAAQ,gBAAA,CAAiB,IAAA,KAC7D,0BAAA,CAA2B,IAAA,EAAM,UAAA;;KAGzB,cAAA,GAAiB,iBAAA;;UAGZ,cAAA,oCAEM,gBAAA,CAAiB,IAAA,IAAQ,gBAAA,CAAiB,IAAA,WACvD,QAAA,CAAS,iBAAA;EATY;EAW3B,WAAA,2BAC8B,kBAAA,CAAmB,IAAA,EAAM,UAAA,2BAEnD,KAAA,EAAO,wBAAA,CAAyB,IAAA,EAAM,UAAA,EAAY,WAAA,GAClD,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACtB,OAAA,CAAQ,UAAA;EAhBe;EAkB1B,UAAA,IAAc,OAAA;EAnBd;EAqBA,YAAA,CAAa,OAAA,WAAkB,OAAA,CAAQ,WAAA;EArBH;EAuBpC,IAAA;EAvB6D;EAyB7D,YAAA,CAAa,OAAA;IAAW,QAAA;IAAkB,QAAA;EAAA,IAAsB,OAAA;EAxBrB;EA0B3C,kBAAA,CAAmB,OAAA;IAAY,QAAA;EAAA,IAAsB,OAAA;EAvB5B;EAyBzB,eAAA,CAAgB,MAAA,EAAQ,qBAAA,GAAwB,OAAA;EAtBnC;EAwBb,UAAA;EAxB2B;EA0B3B,KAAA;EAxBmB;EA0BnB,WAAA,CAAY,KAAA,EAAO,gBAAA;EA1ByB;EA4B5C,aAAA,CAAc,KAAA,EAAO,OAAA,CAAQ,0BAAA,CAA2B,IAAA,EAAM,UAAA;EAxBb;EA0BjD,YAAA,CAAa,MAAA,EAAQ,iBAAA,CAAkB,IAAA;AAAA;;;;AAzC3C;;;;;;;;;;;;;;;;;;;;;;;AAMA;;;;;AAGA;;;;;;iBCqBgB,eAAA,oCAEO,gBAAA,CAAiB,IAAA,IAAQ,gBAAA,CAAiB,IAAA,EAAA,CAE7D,MAAA,EAAQ,iBAAA,CAAkB,IAAA,GAC1B,OAAA,EAAS,gBAAA,CAAiB,IAAA,EAAM,UAAA,IACjC,cAAA,CAAe,IAAA,EAAM,UAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/svelte/types.ts","../../src/svelte/createAgentChat.ts"],"mappings":";;;;UAYiB,gBAAA,+BAEC,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,WACxC,IAAA,CACF,sBAAA,CAAuB,IAAA,EAAM,KAAA;EAGjC,eAAA,GAAkB,sBAAA,CAAuB,IAAA,EAAM,KAAA;EAC/C,YAAA;EACA,MAAA,GAAS,iBAAA;EACT,qBAAA,GAAwB,mBAAA;AAAA;AAAA,KAGhB,cAAA,GAAiB,uBAAA;AAAA,KAEjB,cAAA,+BAEM,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,KAC9C,QAAA,CAAS,uBAAA;EACT,WAAA,CAAY,KAAA,EAAO,iBAAA,EAAmB,OAAA,GAAU,WAAA,CAAY,IAAA,EAAM,KAAA,IAAS,OAAA;EAC3E,IAAA;EACA,MAAA,CAAO,KAAA,GAAQ,iBAAA,GAAoB,OAAA;EACnC,eAAA,CAAgB,WAAA,UAAqB,QAAA,GAAW,MAAA,oBAA0B,OAAA;EAC1E,cAAA,CAAe,WAAA,UAAqB,QAAA,GAAW,MAAA,6BAAmC,OAAA;EAClF,WAAA,EAAa,eAAA,CAAgB,IAAA,EAAM,KAAA;AAAA,KAClC,cAAA,CAAe,IAAA,EAAM,KAAA;EAEZ,YAAA,CAAa,QAAA,YAAoB,OAAA;EACjC,YAAA,CAAa,QAAA,WAAmB,OAAA;EAChC,WAAA;AAAA,IAEJ,MAAA;;;iBCrCM,eAAA,+BAEE,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,EAAA,CAE9C,KAAA,EAAO,kCAAA,CAAmC,IAAA,EAAM,KAAA,GAChD,OAAA,GAAU,gBAAA,CAAiB,IAAA,EAAM,KAAA,IAClC,cAAA,CAAe,IAAA,EAAM,KAAA;AAAA,iBACR,eAAA,+BAEE,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,EAAA,CAE9C,KAAA,EAAO,4BAAA,CAA6B,IAAA,EAAM,KAAA,GAC1C,OAAA,GAAU,gBAAA,CAAiB,IAAA,EAAM,KAAA,IAClC,cAAA,CAAe,IAAA,EAAM,KAAA"}

package/dist/svelte/index.mjs

@@ -1,104 +1,30 @@
-import { t as AgentChatController } from "../controller-BrBUfjhZ.mjs";
-import { n as getLatestUserMessageId, r as normalizeSendInput, t as cloneControllerOptions } from "../utils-CiHUj_BW.mjs";
+import { n as createAgentController } from "../controller-xMlzSCc7.mjs";
 import { writable } from "svelte/store";
 
 //#region src/svelte/createAgentChat.ts
-/**
-* Creates a Svelte store for one Better Agent conversation.
-*
-* Returns a readable store plus chat actions.
-*
-* @example
-* ```ts
-* const agent = createAgentChat(client, {
-*   agent: "assistant",
-*   conversationId: "conv_123",
-* });
-*
-* await agent.sendMessage("Hello");
-*
-* const unsubscribe = agent.subscribe((snapshot) => {
-*   console.log(snapshot.messages);
-*   console.log(snapshot.status);
-* });
-*
-* unsubscribe();
-* ```
-*
-* @example
-* ```svelte
-* <script lang="ts">
-*   const agent = createAgentChat(client, { agent: "assistant" });
-* <\/script>
-*
-* {#each $agent.messages as message}
-*   <div>{message.role}</div>
-* {/each}
-*
-* <button on:click={() => agent.sendMessage("Hello")}>Send</button>
-* ```
-*/
-function createAgentChat(client, options) {
-	let currentClient = client;
-	let currentOptions = options;
-	let controller = null;
-	const getController = () => {
-		if (!controller) controller = new AgentChatController(currentClient, cloneControllerOptions(currentOptions));
-		return controller;
-	};
-	/** Pushes the latest client and options into the controller. */
-	const syncController = () => {
-		const activeController = getController();
-		activeController.updateClient(currentClient);
-		activeController.updateOptions(cloneControllerOptions(currentOptions));
-		return activeController;
-	};
+function createAgentChat(agent, options = {}) {
+	const controller = createAgentController(agent, options);
 	return {
-		subscribe: writable(getController().getSnapshot(), (set) => {
-			const activeController = syncController();
-			const unsubscribe = activeController.subscribe(() => {
-				set(activeController.getSnapshot());
+		subscribe: writable(controller.getSnapshot(), (set) => {
+			const unsubscribe = controller.subscribe(() => {
+				set(controller.getSnapshot());
 			});
-			set(activeController.getSnapshot());
-			if (typeof window !== "undefined") activeController.init();
+			set(controller.getSnapshot());
+			controller.start();
 			return () => {
 				unsubscribe();
-				activeController.destroy();
-				if (controller === activeController) controller = null;
+				controller.stop();
 			};
 		}).subscribe,
-		sendMessage: (input, requestOptions) => syncController().sendMessage(normalizeSendInput(input), requestOptions),
-		regenerate: async () => {
-			const activeController = syncController();
-			await activeController.retryMessage(getLatestUserMessageId(activeController));
-		},
-		retryMessage: (localId) => syncController().retryMessage(localId),
-		stop: () => {
-			syncController().stop();
-		},
-		resumeStream: (resumeOptions) => syncController().resumeStream(resumeOptions),
-		resumeConversation: (resumeOptions) => syncController().resumeConversation(resumeOptions),
-		approveToolCall: (params) => syncController().approveToolCall(params),
-		clearError: () => {
-			syncController().clearError();
-		},
-		reset: () => {
-			syncController().reset();
-		},
-		setMessages: (input) => {
-			syncController().setMessages(input);
-		},
-		updateOptions: (input) => {
-			currentOptions = {
-				...currentOptions,
-				...input
-			};
-			syncController();
-		},
-		updateClient: (nextClient) => {
-			currentClient = nextClient;
-			syncController();
-		}
+		sendMessage: (input, sendOptions) => controller.sendMessage(input, sendOptions),
+		stop: () => controller.stop(),
+		resume: (resume) => controller.resume(resume),
+		selectThread: (threadId) => controller.selectThread(threadId),
+		clearThread: () => controller.clearThread(),
+		loadMessages: (threadId) => controller.loadMessages(threadId),
+		approveToolCall: (interruptId, metadata) => controller.approveToolCall(interruptId, metadata),
+		rejectToolCall: (interruptId, metadata) => controller.rejectToolCall(interruptId, metadata),
+		setMessages: (messages) => controller.setMessages(messages)
 	};
 }
 

package/dist/svelte/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/svelte/createAgentChat.ts"],"sourcesContent":["import { writable } from \"svelte/store\";\nimport { AgentChatController } from \"../core/controller\";\nimport {\n    cloneControllerOptions,\n    getLatestUserMessageId,\n    normalizeSendInput,\n} from \"../framework-internals/utils\";\nimport type { BetterAgentClient } from \"../types/client\";\nimport type { AgentNameFromApp } from \"../types/client-type-helpers\";\nimport type { AgentChatOptions, AgentChatSnapshot, AgentChatStore } from \"./types\";\n\n/**\n * Creates a Svelte store for one Better Agent conversation.\n *\n * Returns a readable store plus chat actions.\n *\n * @example\n * ```ts\n * const agent = createAgentChat(client, {\n *   agent: \"assistant\",\n *   conversationId: \"conv_123\",\n * });\n *\n * await agent.sendMessage(\"Hello\");\n *\n * const unsubscribe = agent.subscribe((snapshot) => {\n *   console.log(snapshot.messages);\n *   console.log(snapshot.status);\n * });\n *\n * unsubscribe();\n * ```\n *\n * @example\n * ```svelte\n * <script lang=\"ts\">\n *   const agent = createAgentChat(client, { agent: \"assistant\" });\n * </script>\n *\n * {#each $agent.messages as message}\n *   <div>{message.role}</div>\n * {/each}\n *\n * <button on:click={() => agent.sendMessage(\"Hello\")}>Send</button>\n * ```\n */\nexport function createAgentChat<\n    TApp = unknown,\n    TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>,\n>(\n    client: BetterAgentClient<TApp>,\n    options: AgentChatOptions<TApp, TAgentName>,\n): AgentChatStore<TApp, TAgentName> {\n    let currentClient = client;\n    let currentOptions = options;\n    let controller: AgentChatController<TApp, TAgentName> | null = null;\n\n    const getController = () => {\n        if (!controller) {\n            controller = new AgentChatController<TApp, TAgentName>(\n                currentClient,\n                cloneControllerOptions(currentOptions),\n            );\n        }\n        return controller;\n    };\n\n    /** Pushes the latest client and options into the controller. */\n    const syncController = () => {\n        const activeController = getController();\n        activeController.updateClient(currentClient);\n        activeController.updateOptions(\n            cloneControllerOptions(currentOptions) as AgentChatOptions<TApp, TAgentName>,\n        );\n        return activeController;\n    };\n\n    const store = writable(\n        getController().getSnapshot(),\n        (set: (value: AgentChatSnapshot) => void) => {\n            const activeController = syncController();\n            const unsubscribe = activeController.subscribe(() => {\n                set(activeController.getSnapshot());\n            });\n\n            set(activeController.getSnapshot());\n            if (typeof window !== \"undefined\") {\n                activeController.init();\n            }\n\n            return () => {\n                unsubscribe();\n                activeController.destroy();\n                if (controller === activeController) {\n                    controller = null;\n                }\n            };\n        },\n    );\n\n    return {\n        subscribe: store.subscribe,\n        sendMessage: (input, requestOptions) =>\n            syncController().sendMessage(normalizeSendInput(input), requestOptions),\n        regenerate: async () => {\n            const activeController = syncController();\n            await activeController.retryMessage(getLatestUserMessageId(activeController));\n        },\n        retryMessage: (localId) => syncController().retryMessage(localId),\n        stop: () => {\n            syncController().stop();\n        },\n        resumeStream: (resumeOptions) => syncController().resumeStream(resumeOptions),\n        resumeConversation: (resumeOptions) => syncController().resumeConversation(resumeOptions),\n        approveToolCall: (params) => syncController().approveToolCall(params),\n        clearError: () => {\n            syncController().clearError();\n        },\n        reset: () => {\n            syncController().reset();\n        },\n        setMessages: (input) => {\n            syncController().setMessages(input);\n        },\n        updateOptions: (input) => {\n            currentOptions = {\n                ...currentOptions,\n                ...input,\n            };\n            syncController();\n        },\n        updateClient: (nextClient) => {\n            currentClient = nextClient;\n            syncController();\n        },\n    };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8CA,SAAgB,gBAIZ,QACA,SACgC;CAChC,IAAI,gBAAgB;CACpB,IAAI,iBAAiB;CACrB,IAAI,aAA2D;CAE/D,MAAM,sBAAsB;AACxB,MAAI,CAAC,WACD,cAAa,IAAI,oBACb,eACA,uBAAuB,eAAe,CACzC;AAEL,SAAO;;;CAIX,MAAM,uBAAuB;EACzB,MAAM,mBAAmB,eAAe;AACxC,mBAAiB,aAAa,cAAc;AAC5C,mBAAiB,cACb,uBAAuB,eAAe,CACzC;AACD,SAAO;;AA0BX,QAAO;EACH,WAxBU,SACV,eAAe,CAAC,aAAa,GAC5B,QAA4C;GACzC,MAAM,mBAAmB,gBAAgB;GACzC,MAAM,cAAc,iBAAiB,gBAAgB;AACjD,QAAI,iBAAiB,aAAa,CAAC;KACrC;AAEF,OAAI,iBAAiB,aAAa,CAAC;AACnC,OAAI,OAAO,WAAW,YAClB,kBAAiB,MAAM;AAG3B,gBAAa;AACT,iBAAa;AACb,qBAAiB,SAAS;AAC1B,QAAI,eAAe,iBACf,cAAa;;IAI5B,CAGoB;EACjB,cAAc,OAAO,mBACjB,gBAAgB,CAAC,YAAY,mBAAmB,MAAM,EAAE,eAAe;EAC3E,YAAY,YAAY;GACpB,MAAM,mBAAmB,gBAAgB;AACzC,SAAM,iBAAiB,aAAa,uBAAuB,iBAAiB,CAAC;;EAEjF,eAAe,YAAY,gBAAgB,CAAC,aAAa,QAAQ;EACjE,YAAY;AACR,mBAAgB,CAAC,MAAM;;EAE3B,eAAe,kBAAkB,gBAAgB,CAAC,aAAa,cAAc;EAC7E,qBAAqB,kBAAkB,gBAAgB,CAAC,mBAAmB,cAAc;EACzF,kBAAkB,WAAW,gBAAgB,CAAC,gBAAgB,OAAO;EACrE,kBAAkB;AACd,mBAAgB,CAAC,YAAY;;EAEjC,aAAa;AACT,mBAAgB,CAAC,OAAO;;EAE5B,cAAc,UAAU;AACpB,mBAAgB,CAAC,YAAY,MAAM;;EAEvC,gBAAgB,UAAU;AACtB,oBAAiB;IACb,GAAG;IACH,GAAG;IACN;AACD,mBAAgB;;EAEpB,eAAe,eAAe;AAC1B,mBAAgB;AAChB,mBAAgB;;EAEvB"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/svelte/createAgentChat.ts"],"sourcesContent":["import { writable } from \"svelte/store\";\nimport { createAgentController } from \"../core/controller\";\nimport type { AgentNameOf } from \"../core/inference\";\nimport type { BetterAgentClientAgentHandle, BetterAgentClientAgentMemoryHandle } from \"../types\";\nimport type { AgentChatOptions, AgentChatState, AgentChatStore } from \"./types\";\n\nexport function createAgentChat<\n    TApp = unknown,\n    TName extends AgentNameOf<TApp> = AgentNameOf<TApp>,\n>(\n    agent: BetterAgentClientAgentMemoryHandle<TApp, TName>,\n    options?: AgentChatOptions<TApp, TName>,\n): AgentChatStore<TApp, TName>;\nexport function createAgentChat<\n    TApp = unknown,\n    TName extends AgentNameOf<TApp> = AgentNameOf<TApp>,\n>(\n    agent: BetterAgentClientAgentHandle<TApp, TName>,\n    options?: AgentChatOptions<TApp, TName>,\n): AgentChatStore<TApp, TName>;\nexport function createAgentChat<\n    TApp = unknown,\n    TName extends AgentNameOf<TApp> = AgentNameOf<TApp>,\n>(\n    agent: BetterAgentClientAgentHandle<TApp, TName>,\n    options: AgentChatOptions<TApp, TName> = {},\n): AgentChatStore<TApp, TName> {\n    const controller = createAgentController<TApp, TName>(agent, options);\n    const store = writable<AgentChatState>(controller.getSnapshot(), (set) => {\n        const unsubscribe = controller.subscribe(() => {\n            set(controller.getSnapshot());\n        });\n\n        set(controller.getSnapshot());\n        controller.start();\n\n        return () => {\n            unsubscribe();\n            controller.stop();\n        };\n    });\n\n    return {\n        subscribe: store.subscribe,\n        sendMessage: (input, sendOptions) => controller.sendMessage(input, sendOptions),\n        stop: () => controller.stop(),\n        resume: (resume) => controller.resume(resume),\n        selectThread: (threadId) => controller.selectThread(threadId),\n        clearThread: () => controller.clearThread(),\n        loadMessages: (threadId) => controller.loadMessages(threadId),\n        approveToolCall: (interruptId, metadata) =>\n            controller.approveToolCall(interruptId, metadata),\n        rejectToolCall: (interruptId, metadata) => controller.rejectToolCall(interruptId, metadata),\n        setMessages: (messages) => controller.setMessages(messages),\n    };\n}\n"],"mappings":";;;;AAoBA,SAAgB,gBAIZ,OACA,UAAyC,EAAE,EAChB;CAC3B,MAAM,aAAa,sBAAmC,OAAO,QAAQ;AAerE,QAAO;EACH,WAfU,SAAyB,WAAW,aAAa,GAAG,QAAQ;GACtE,MAAM,cAAc,WAAW,gBAAgB;AAC3C,QAAI,WAAW,aAAa,CAAC;KAC/B;AAEF,OAAI,WAAW,aAAa,CAAC;AAC7B,cAAW,OAAO;AAElB,gBAAa;AACT,iBAAa;AACb,eAAW,MAAM;;IAEvB,CAGmB;EACjB,cAAc,OAAO,gBAAgB,WAAW,YAAY,OAAO,YAAY;EAC/E,YAAY,WAAW,MAAM;EAC7B,SAAS,WAAW,WAAW,OAAO,OAAO;EAC7C,eAAe,aAAa,WAAW,aAAa,SAAS;EAC7D,mBAAmB,WAAW,aAAa;EAC3C,eAAe,aAAa,WAAW,aAAa,SAAS;EAC7D,kBAAkB,aAAa,aAC3B,WAAW,gBAAgB,aAAa,SAAS;EACrD,iBAAiB,aAAa,aAAa,WAAW,eAAe,aAAa,SAAS;EAC3F,cAAc,aAAa,WAAW,YAAY,SAAS;EAC9D"}

package/dist/vue/index.d.mts

@@ -1,95 +1,38 @@
-import { E as UIMessage, K as AgentNameFromApp, M as BetterAgentClient, Y as ModalitiesForAgent, b as PendingToolApproval, f as SendResult, i as ApproveToolCallParams, k as AgentClientError, l as RetryResult, p as SetMessagesInput, r as AgentStatus, t as AgentChatControllerOptions, u as SendMessageInputForAgent } from "../controller-CJ79_cSR.mjs";
+import { M as BetterAgentClientAgentMemoryHandle, O as BetterAgentClientError, U as AgentHasMemory, W as AgentNameOf, a as AgentControllerOptions, c as AgentInterruptState, d as PendingClientTool, f as PendingToolApproval, j as BetterAgentClientAgentHandle, l as AgentMessageInput, p as SendOptions, s as AgentControllerStatus, t as AgentController, u as AgentStreamResume, w as UIMessage } from "../controller-B7G0xSYW.mjs";
 import { ComputedRef, MaybeRefOrGetter } from "vue";
 
 //#region src/vue/types.d.ts
-/** Options for `useAgent`. */
-type UseAgentOptions<TApp = unknown, TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>> = AgentChatControllerOptions<TApp, TAgentName>;
-/** Return type of `useAgent`. */
-interface UseAgentResult<TApp = unknown, TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>> {
-  /** Stable local chat id. */
-  id: ComputedRef<string>;
-  /** Conversation messages. */
+interface UseAgentOptions<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>> extends Pick<AgentControllerOptions<TApp, TName>, "context" | "threadId" | "toolHandlers" | "onEvent" | "onFinish" | "onError"> {
+  initialMessages?: AgentControllerOptions<TApp, TName>["initialMessages"];
+  initialState?: unknown;
+  resume?: AgentStreamResume;
+  initialInterruptState?: AgentInterruptState;
+}
+type UseAgentResult<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>> = {
   messages: ComputedRef<UIMessage[]>;
-  /** Current request status. */
-  status: ComputedRef<AgentStatus>;
-  /** Latest client error. */
-  error: ComputedRef<AgentClientError | undefined>;
-  /** Latest stream id. */
-  streamId: ComputedRef<string | undefined>;
-  /** Latest run id. */
+  state: ComputedRef<unknown>;
+  status: ComputedRef<AgentControllerStatus>;
+  error: ComputedRef<BetterAgentClientError | undefined>;
   runId: ComputedRef<string | undefined>;
-  /** Conversation id, when configured. */
-  conversationId: ComputedRef<string | undefined>;
-  /** True while a request is active. */
-  isLoading: ComputedRef<boolean>;
-  /** True while streaming events are being consumed. */
-  isStreaming: ComputedRef<boolean>;
-  /** Pending tool approvals. */
+  threadId: ComputedRef<string | undefined>;
+  isRunning: ComputedRef<boolean>;
+  pendingClientTools: ComputedRef<PendingClientTool[]>;
   pendingToolApprovals: ComputedRef<PendingToolApproval[]>;
-  /** Sends a message. */
-  sendMessage<const TModalities extends ModalitiesForAgent<TApp, TAgentName> | undefined = undefined>(input: SendMessageInputForAgent<TApp, TAgentName, TModalities>, options?: {
-    signal?: AbortSignal;
-  }): Promise<SendResult>;
-  /** Retries the most recent user message. */
-  regenerate(): Promise<void>;
-  /** Retries one user message. */
-  retryMessage(localId: string): Promise<RetryResult>;
-  /** Stops the active run or stream. */
+  sendMessage(input: AgentMessageInput, options?: SendOptions<TApp, TName>): Promise<void>;
   stop(): void;
-  /** Resumes one stream. */
-  resumeStream(options: {
-    streamId: string;
-    afterSeq?: number;
-  }): Promise<void>;
-  /** Resumes the active conversation stream. */
-  resumeConversation(options?: {
-    afterSeq?: number;
-  }): Promise<void>;
-  /** Approves or denies a tool call. */
-  approveToolCall(params: ApproveToolCallParams): Promise<void>;
-  /** Clears the latest error. */
-  clearError(): void;
-  /** Resets local state. */
-  reset(): void;
-  /** Replaces the local messages. */
-  setMessages(input: SetMessagesInput): void;
-}
+  resume(input?: AgentStreamResume): Promise<void>;
+  approveToolCall(interruptId: string, metadata?: Record<string, unknown>): Promise<void>;
+  rejectToolCall(interruptId: string, metadata?: Record<string, unknown> | string): Promise<void>;
+  setMessages: AgentController<TApp, TName>["setMessages"];
+} & (AgentHasMemory<TApp, TName> extends true ? {
+  loadMessages(threadId?: string): Promise<void>;
+  selectThread(threadId: string): Promise<void>;
+  clearThread(): void;
+} : Record<never, never>);
 //#endregion
 //#region src/vue/useAgent.d.ts
-/**
- * Vue composable for talking to one Better Agent conversation.
- *
- * Returns reactive chat state and chat actions.
- *
- * @example
- * ```ts
- * const agent = useAgent(client, {
- *   agent: "assistant",
- *   conversationId: "conv_123",
- * });
- *
- * await agent.sendMessage("Hello");
- *
- * console.log(agent.messages.value);
- * console.log(agent.status.value);
- * agent.stop();
- * ```
- *
- * @example
- * ```vue
- * <script setup lang="ts">
- * const agent = useAgent(client, { agent: "assistant" });
- * </script>
- *
- * <template>
- *   <div v-for="message in agent.messages.value" :key="message.localId">
- *     {{ message.role }}
- *   </div>
- *   <button @click="agent.sendMessage('Hello')">Send</button>
- * </template>
- * ```
- */
-declare function useAgent<TApp = unknown, TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>>(client: MaybeRefOrGetter<BetterAgentClient<TApp>>, options: MaybeRefOrGetter<UseAgentOptions<TApp, TAgentName>>): UseAgentResult<TApp, TAgentName>;
+declare function useAgent<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(agent: BetterAgentClientAgentMemoryHandle<TApp, TName>, options?: MaybeRefOrGetter<UseAgentOptions<TApp, TName> | undefined>): UseAgentResult<TApp, TName>;
+declare function useAgent<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(agent: BetterAgentClientAgentHandle<TApp, TName>, options?: MaybeRefOrGetter<UseAgentOptions<TApp, TName> | undefined>): UseAgentResult<TApp, TName>;
 //#endregion
-export { type SetMessagesInput, type UseAgentOptions, type UseAgentResult, useAgent };
+export { type UseAgentOptions, type UseAgentResult, useAgent };
 //# sourceMappingURL=index.d.mts.map

package/dist/vue/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/vue/types.ts","../../src/vue/useAgent.ts"],"mappings":";;;;;KAiBY,eAAA,oCAEW,gBAAA,CAAiB,IAAA,IAAQ,gBAAA,CAAiB,IAAA,KAC7D,0BAAA,CAA2B,IAAA,EAAM,UAAA;;UAGpB,cAAA,oCAEM,gBAAA,CAAiB,IAAA,IAAQ,gBAAA,CAAiB,IAAA;EANjB;EAS5C,EAAA,EAAI,WAAA;EAR6B;EAUjC,QAAA,EAAU,WAAA,CAAY,SAAA;EAVI;EAY1B,MAAA,EAAQ,WAAA,CAAY,WAAA;EAdpB;EAgBA,KAAA,EAAO,WAAA,CAAY,gBAAA;EAfA;EAiBnB,QAAA,EAAU,WAAA;EAjBkC;EAmB5C,KAAA,EAAO,WAAA;EAlBP;EAoBA,cAAA,EAAgB,WAAA;EApBiB;EAsBjC,SAAA,EAAW,WAAA;EAtBgC;EAwB3C,WAAA,EAAa,WAAA;EArBc;EAuB3B,oBAAA,EAAsB,WAAA,CAAY,mBAAA;EArBE;EAuBpC,WAAA,2BAC8B,kBAAA,CAAmB,IAAA,EAAM,UAAA,2BAEnD,KAAA,EAAO,wBAAA,CAAyB,IAAA,EAAM,UAAA,EAAY,WAAA,GAClD,OAAA;IAAY,MAAA,GAAS,WAAA;EAAA,IACtB,OAAA,CAAQ,UAAA;EAzBP;EA2BJ,UAAA,IAAc,OAAA;EAzBJ;EA2BV,YAAA,CAAa,OAAA,WAAkB,OAAA,CAAQ,WAAA;EAzB/B;EA2BR,IAAA;EAzBO;EA2BP,YAAA,CAAa,OAAA;IAAW,QAAA;IAAkB,QAAA;EAAA,IAAsB,OAAA;EAjBnD;EAmBb,kBAAA,CAAmB,OAAA;IAAY,QAAA;EAAA,IAAsB,OAAA;EAdE;EAgBvD,eAAA,CAAgB,MAAA,EAAQ,qBAAA,GAAwB,OAAA;EAdZ;EAgBpC,UAAA;EAhBsD;EAkBtD,KAAA;EAjByB;EAmBzB,WAAA,CAAY,KAAA,EAAO,gBAAA;AAAA;;;AAtDvB;;;;;;;;;;;;;;;;;;;;;;;AAMA;;;;;;;;;;AANA,iBC4BgB,QAAA,oCAEO,gBAAA,CAAiB,IAAA,IAAQ,gBAAA,CAAiB,IAAA,EAAA,CAE7D,MAAA,EAAQ,gBAAA,CAAiB,iBAAA,CAAkB,IAAA,IAC3C,OAAA,EAAS,gBAAA,CAAiB,eAAA,CAAgB,IAAA,EAAM,UAAA,KACjD,cAAA,CAAe,IAAA,EAAM,UAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/vue/types.ts","../../src/vue/useAgent.ts"],"mappings":";;;;UAgBiB,eAAA,+BAEC,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,WACxC,IAAA,CACF,sBAAA,CAAuB,IAAA,EAAM,KAAA;EAGjC,eAAA,GAAkB,sBAAA,CAAuB,IAAA,EAAM,KAAA;EAC/C,YAAA;EACA,MAAA,GAAS,iBAAA;EACT,qBAAA,GAAwB,mBAAA;AAAA;AAAA,KAGhB,cAAA,+BAA6C,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA;EACrF,QAAA,EAAU,WAAA,CAAY,SAAA;EACtB,KAAA,EAAO,WAAA;EACP,MAAA,EAAQ,WAAA,CAAY,qBAAA;EACpB,KAAA,EAAO,WAAA,CAAY,sBAAA;EACnB,KAAA,EAAO,WAAA;EACP,QAAA,EAAU,WAAA;EACV,SAAA,EAAW,WAAA;EACX,kBAAA,EAAoB,WAAA,CAAY,iBAAA;EAChC,oBAAA,EAAsB,WAAA,CAAY,mBAAA;EAClC,WAAA,CAAY,KAAA,EAAO,iBAAA,EAAmB,OAAA,GAAU,WAAA,CAAY,IAAA,EAAM,KAAA,IAAS,OAAA;EAC3E,IAAA;EACA,MAAA,CAAO,KAAA,GAAQ,iBAAA,GAAoB,OAAA;EACnC,eAAA,CAAgB,WAAA,UAAqB,QAAA,GAAW,MAAA,oBAA0B,OAAA;EAC1E,cAAA,CAAe,WAAA,UAAqB,QAAA,GAAW,MAAA,6BAAmC,OAAA;EAClF,WAAA,EAAa,eAAA,CAAgB,IAAA,EAAM,KAAA;AAAA,KAClC,cAAA,CAAe,IAAA,EAAM,KAAA;EAEhB,YAAA,CAAa,QAAA,YAAoB,OAAA;EACjC,YAAA,CAAa,QAAA,WAAmB,OAAA;EAChC,WAAA;AAAA,IAEJ,MAAA;;;iBCxCU,QAAA,+BAAuC,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,EAAA,CACnF,KAAA,EAAO,kCAAA,CAAmC,IAAA,EAAM,KAAA,GAChD,OAAA,GAAU,gBAAA,CAAiB,eAAA,CAAgB,IAAA,EAAM,KAAA,iBAClD,cAAA,CAAe,IAAA,EAAM,KAAA;AAAA,iBACR,QAAA,+BAAuC,WAAA,CAAY,IAAA,IAAQ,WAAA,CAAY,IAAA,EAAA,CACnF,KAAA,EAAO,4BAAA,CAA6B,IAAA,EAAM,KAAA,GAC1C,OAAA,GAAU,gBAAA,CAAiB,eAAA,CAAgB,IAAA,EAAM,KAAA,iBAClD,cAAA,CAAe,IAAA,EAAM,KAAA"}