@better-agent/client 0.1.0-canary.6 → 0.2.0-beta.2

package/dist/vue/index.mjs

@@ -1,152 +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 { computed, onMounted, onUnmounted, ref, toValue, watchEffect } from "vue";
+import { n as createAgentController } from "../controller-xMlzSCc7.mjs";
+import { computed, onMounted, onUnmounted, ref, toValue } from "vue";
 
 //#region src/vue/useAgent.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>
-* ```
-*/
-function useAgent(client, options) {
-	const controller = new AgentChatController(toValue(client), cloneControllerOptions(toValue(options)));
+function useAgent(agent, options) {
+	const readOptions = () => toValue(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 version = ref(0);
-	/** Pushes the latest client and options into the controller. */
-	const syncController = () => {
-		controller.updateClient(toValue(client));
-		controller.updateOptions(cloneControllerOptions(toValue(options)));
+	const snapshot = () => {
+		version.value;
+		return controller.getSnapshot();
 	};
 	const unsubscribe = controller.subscribe(() => {
 		version.value++;
 	});
-	watchEffect(() => {
-		syncController();
-	});
 	onMounted(() => {
-		syncController();
-		controller.init();
+		controller.start();
 	});
 	onUnmounted(() => {
 		unsubscribe();
-		controller.destroy();
-	});
-	const messages = computed(() => {
-		version.value;
-		return controller.getMessages();
-	});
-	const id = computed(() => {
-		version.value;
-		return controller.getSnapshot().id;
-	});
-	const status = computed(() => {
-		version.value;
-		return controller.getStatus();
-	});
-	const error = computed(() => {
-		version.value;
-		return controller.getError();
-	});
-	const streamId = computed(() => {
-		version.value;
-		return controller.getStreamId();
-	});
-	const runId = computed(() => {
-		version.value;
-		return controller.getRunId();
-	});
-	const isLoading = computed(() => {
-		version.value;
-		return controller.isLoading;
-	});
-	const isStreaming = computed(() => {
-		version.value;
-		return controller.isStreaming;
+		controller.stop();
 	});
 	return {
-		id,
-		messages,
-		status,
-		error,
-		streamId,
-		runId,
-		conversationId: computed(() => {
-			version.value;
-			return controller.getSnapshot().conversationId;
-		}),
-		isLoading,
-		isStreaming,
-		pendingToolApprovals: computed(() => {
-			version.value;
-			return controller.getPendingToolApprovals();
-		}),
-		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: computed(() => snapshot().messages),
+		state: computed(() => snapshot().state),
+		status: computed(() => snapshot().status),
+		error: computed(() => snapshot().error),
+		runId: computed(() => snapshot().runId),
+		threadId: computed(() => snapshot().threadId),
+		isRunning: computed(() => snapshot().isRunning),
+		pendingClientTools: computed(() => snapshot().pendingClientTools),
+		pendingToolApprovals: computed(() => 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/vue/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/vue/useAgent.ts"],"sourcesContent":["import { computed, onMounted, onUnmounted, ref, toValue, watchEffect } from \"vue\";\nimport type { MaybeRefOrGetter } from \"vue\";\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 { UseAgentOptions, UseAgentResult } from \"./types\";\n\n/**\n * Vue composable 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.value);\n * console.log(agent.status.value);\n * agent.stop();\n * ```\n *\n * @example\n * ```vue\n * <script setup lang=\"ts\">\n * const agent = useAgent(client, { agent: \"assistant\" });\n * </script>\n *\n * <template>\n *   <div v-for=\"message in agent.messages.value\" :key=\"message.localId\">\n *     {{ message.role }}\n *   </div>\n *   <button @click=\"agent.sendMessage('Hello')\">Send</button>\n * </template>\n * ```\n */\nexport function useAgent<\n    TApp = unknown,\n    TAgentName extends AgentNameFromApp<TApp> = AgentNameFromApp<TApp>,\n>(\n    client: MaybeRefOrGetter<BetterAgentClient<TApp>>,\n    options: MaybeRefOrGetter<UseAgentOptions<TApp, TAgentName>>,\n): UseAgentResult<TApp, TAgentName> {\n    const controller = new AgentChatController<TApp, TAgentName>(\n        toValue(client),\n        cloneControllerOptions(toValue(options)),\n    );\n    const version = ref(0);\n\n    /** Pushes the latest client and options into the controller. */\n    const syncController = () => {\n        controller.updateClient(toValue(client));\n        controller.updateOptions(\n            cloneControllerOptions(toValue(options)) as UseAgentOptions<TApp, TAgentName>,\n        );\n    };\n\n    const unsubscribe = controller.subscribe(() => {\n        version.value++;\n    });\n\n    watchEffect(() => {\n        syncController();\n    });\n\n    onMounted(() => {\n        syncController();\n        controller.init();\n    });\n\n    onUnmounted(() => {\n        unsubscribe();\n        controller.destroy();\n    });\n\n    const messages = computed(() => {\n        void version.value;\n        return controller.getMessages();\n    });\n    const id = computed(() => {\n        void version.value;\n        return controller.getSnapshot().id;\n    });\n    const status = computed(() => {\n        void version.value;\n        return controller.getStatus();\n    });\n    const error = computed(() => {\n        void version.value;\n        return controller.getError();\n    });\n    const streamId = computed(() => {\n        void version.value;\n        return controller.getStreamId();\n    });\n    const runId = computed(() => {\n        void version.value;\n        return controller.getRunId();\n    });\n    const isLoading = computed(() => {\n        void version.value;\n        return controller.isLoading;\n    });\n    const isStreaming = computed(() => {\n        void version.value;\n        return controller.isStreaming;\n    });\n    const conversationId = computed(() => {\n        void version.value;\n        return controller.getSnapshot().conversationId;\n    });\n    const pendingToolApprovals = computed(() => {\n        void version.value;\n        return controller.getPendingToolApprovals();\n    });\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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,SAAgB,SAIZ,QACA,SACgC;CAChC,MAAM,aAAa,IAAI,oBACnB,QAAQ,OAAO,EACf,uBAAuB,QAAQ,QAAQ,CAAC,CAC3C;CACD,MAAM,UAAU,IAAI,EAAE;;CAGtB,MAAM,uBAAuB;AACzB,aAAW,aAAa,QAAQ,OAAO,CAAC;AACxC,aAAW,cACP,uBAAuB,QAAQ,QAAQ,CAAC,CAC3C;;CAGL,MAAM,cAAc,WAAW,gBAAgB;AAC3C,UAAQ;GACV;AAEF,mBAAkB;AACd,kBAAgB;GAClB;AAEF,iBAAgB;AACZ,kBAAgB;AAChB,aAAW,MAAM;GACnB;AAEF,mBAAkB;AACd,eAAa;AACb,aAAW,SAAS;GACtB;CAEF,MAAM,WAAW,eAAe;AAC5B,EAAK,QAAQ;AACb,SAAO,WAAW,aAAa;GACjC;CACF,MAAM,KAAK,eAAe;AACtB,EAAK,QAAQ;AACb,SAAO,WAAW,aAAa,CAAC;GAClC;CACF,MAAM,SAAS,eAAe;AAC1B,EAAK,QAAQ;AACb,SAAO,WAAW,WAAW;GAC/B;CACF,MAAM,QAAQ,eAAe;AACzB,EAAK,QAAQ;AACb,SAAO,WAAW,UAAU;GAC9B;CACF,MAAM,WAAW,eAAe;AAC5B,EAAK,QAAQ;AACb,SAAO,WAAW,aAAa;GACjC;CACF,MAAM,QAAQ,eAAe;AACzB,EAAK,QAAQ;AACb,SAAO,WAAW,UAAU;GAC9B;CACF,MAAM,YAAY,eAAe;AAC7B,EAAK,QAAQ;AACb,SAAO,WAAW;GACpB;CACF,MAAM,cAAc,eAAe;AAC/B,EAAK,QAAQ;AACb,SAAO,WAAW;GACpB;AAUF,QAAO;EACH;EACA;EACA;EACA;EACA;EACA;EACA,gBAhBmB,eAAe;AAClC,GAAK,QAAQ;AACb,UAAO,WAAW,aAAa,CAAC;IAClC;EAcE;EACA;EACA,sBAfyB,eAAe;AACxC,GAAK,QAAQ;AACb,UAAO,WAAW,yBAAyB;IAC7C;EAaE,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/vue/useAgent.ts"],"sourcesContent":["import { computed, onMounted, onUnmounted, ref, toValue } from \"vue\";\nimport type { MaybeRefOrGetter } from \"vue\";\nimport { createAgentController } from \"../core/controller\";\nimport type { AgentNameOf } from \"../core/inference\";\nimport type {\n    AgentControllerOptions,\n    BetterAgentClientAgentHandle,\n    BetterAgentClientAgentMemoryHandle,\n} from \"../types\";\nimport type { UseAgentOptions, UseAgentResult } from \"./types\";\n\nexport function useAgent<TApp = unknown, TName extends AgentNameOf<TApp> = AgentNameOf<TApp>>(\n    agent: BetterAgentClientAgentMemoryHandle<TApp, TName>,\n    options?: MaybeRefOrGetter<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?: MaybeRefOrGetter<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?: MaybeRefOrGetter<UseAgentOptions<TApp, TName> | undefined>,\n): UseAgentResult<TApp, TName> {\n    const readOptions = () => toValue(options) ?? {};\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 version = ref(0);\n    const snapshot = () => {\n        void version.value;\n        return controller.getSnapshot();\n    };\n\n    const unsubscribe = controller.subscribe(() => {\n        version.value++;\n    });\n\n    onMounted(() => {\n        controller.start();\n    });\n\n    onUnmounted(() => {\n        unsubscribe();\n        controller.stop();\n    });\n\n    return {\n        messages: computed(() => snapshot().messages),\n        state: computed(() => snapshot().state),\n        status: computed(() => snapshot().status),\n        error: computed(() => snapshot().error),\n        runId: computed(() => snapshot().runId),\n        threadId: computed(() => snapshot().threadId),\n        isRunning: computed(() => snapshot().isRunning),\n        pendingClientTools: computed(() => snapshot().pendingClientTools),\n        pendingToolApprovals: computed(() => 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":";;;;AAmBA,SAAgB,SACZ,OACA,SAC2B;CAC3B,MAAM,oBAAoB,QAAQ,QAAQ,IAAI,EAAE;CAChD,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,UAAU,IAAI,EAAE;CACtB,MAAM,iBAAiB;AACnB,EAAK,QAAQ;AACb,SAAO,WAAW,aAAa;;CAGnC,MAAM,cAAc,WAAW,gBAAgB;AAC3C,UAAQ;GACV;AAEF,iBAAgB;AACZ,aAAW,OAAO;GACpB;AAEF,mBAAkB;AACd,eAAa;AACb,aAAW,MAAM;GACnB;AAEF,QAAO;EACH,UAAU,eAAe,UAAU,CAAC,SAAS;EAC7C,OAAO,eAAe,UAAU,CAAC,MAAM;EACvC,QAAQ,eAAe,UAAU,CAAC,OAAO;EACzC,OAAO,eAAe,UAAU,CAAC,MAAM;EACvC,OAAO,eAAe,UAAU,CAAC,MAAM;EACvC,UAAU,eAAe,UAAU,CAAC,SAAS;EAC7C,WAAW,eAAe,UAAU,CAAC,UAAU;EAC/C,oBAAoB,eAAe,UAAU,CAAC,mBAAmB;EACjE,sBAAsB,eAAe,UAAU,CAAC,qBAAqB;EACrE,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/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@better-agent/client",
-    "version": "0.1.0-canary.6",
+    "version": "0.2.0-beta.2",
     "description": "Better Agent client TypeScript library",
     "license": "MIT",
     "repository": {
@@ -97,19 +97,15 @@
         }
     },
     "dependencies": {
-        "@better-agent/core": "0.1.0-canary.6",
-        "@better-agent/shared": "0.1.0-canary.6"
+        "@better-agent/core": "0.2.0-beta.2"
     },
     "devDependencies": {
-        "@types/bun": "^1.2.18",
-        "@types/node": "^22.15.30",
-        "@types/jsdom": "^28.0.0",
+        "@types/bun": "^1.3.12",
+        "@types/node": "^22.19.17",
         "@types/react": "^19.2.9",
-        "@types/react-dom": "19.2.2",
-        "jsdom": "^28.1.0",
+        "jsdom": "^29.1.1",
         "preact": "^10.27.2",
         "react": "19.2.3",
-        "react-dom": "19.2.3",
         "solid-js": "^1.9.11",
         "svelte": "^5.39.6",
         "vue": "^3.5.28"

package/README.md

@@ -1,3 +0,0 @@
-# @better-agent/client
-
-Framework client bindings for Better Agent.