@better-agent/client 0.1.0-canary.0

package/dist/vue/index.mjs

@@ -0,0 +1,155 @@
+import { t as AgentChatController } from "../controller-Cf_JhTdJ.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";
+
+//#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)));
+	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 unsubscribe = controller.subscribe(() => {
+		version.value++;
+	});
+	watchEffect(() => {
+		syncController();
+	});
+	onMounted(() => {
+		syncController();
+		controller.init();
+	});
+	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;
+	});
+	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);
+		}
+	};
+}
+
+//#endregion
+export { useAgent };
+//# sourceMappingURL=index.mjs.map

package/dist/vue/index.mjs.map

@@ -0,0 +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"}

package/package.json

@@ -0,0 +1,117 @@
+{
+    "name": "@better-agent/client",
+    "version": "0.1.0-canary.0",
+    "description": "Better Agent client TypeScript library",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/better-agent/better-agent.git",
+        "directory": "packages/client"
+    },
+    "homepage": "https://github.com/better-agent/better-agent/tree/main/packages/client",
+    "bugs": {
+        "url": "https://github.com/better-agent/better-agent/issues"
+    },
+    "engines": {
+        "bun": ">=1.3.3",
+        "node": ">=20"
+    },
+    "type": "module",
+    "types": "./dist/index.d.mts",
+    "sideEffects": false,
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.mts",
+            "import": "./dist/index.mjs"
+        },
+        "./react": {
+            "types": "./dist/react/index.d.mts",
+            "import": "./dist/react/index.mjs"
+        },
+        "./preact": {
+            "types": "./dist/preact/index.d.mts",
+            "import": "./dist/preact/index.mjs"
+        },
+        "./svelte": {
+            "types": "./dist/svelte/index.d.mts",
+            "import": "./dist/svelte/index.mjs"
+        },
+        "./vue": {
+            "types": "./dist/vue/index.d.mts",
+            "import": "./dist/vue/index.mjs"
+        },
+        "./solid": {
+            "types": "./dist/solid/index.d.mts",
+            "import": "./dist/solid/index.mjs"
+        }
+    },
+    "typesVersions": {
+        "*": {
+            ".": ["dist/index.d.mts"],
+            "react": ["dist/react/index.d.mts"],
+            "preact": ["dist/preact/index.d.mts"],
+            "svelte": ["dist/svelte/index.d.mts"],
+            "vue": ["dist/vue/index.d.mts"],
+            "solid": ["dist/solid/index.d.mts"]
+        }
+    },
+    "scripts": {
+        "build": "bunx tsdown",
+        "dev": "bunx tsdown --watch --no-clean",
+        "test": "bun test",
+        "test:watch": "bun test --watch",
+        "test:coverage": "bun test --coverage",
+        "lint:package": "bunx publint run --strict",
+        "lint:types": "npm_config_cache=../../.npm-cache bunx attw --profile esm-only --pack .",
+        "lint": "bunx biome check .",
+        "typecheck": "bunx tsc -p tsconfig.json --noEmit",
+        "format": "bunx biome format --write .",
+        "clean": "bunx rimraf dist"
+    },
+    "files": ["dist"],
+    "publishConfig": {
+        "access": "public"
+    },
+    "peerDependencies": {
+        "preact": "^10.0.0",
+        "react": "^18.0.0 || ^19.0.0",
+        "solid-js": "^1.9.0",
+        "svelte": "^4.0.0 || ^5.0.0",
+        "vue": "^3.3.0"
+    },
+    "peerDependenciesMeta": {
+        "preact": {
+            "optional": true
+        },
+        "react": {
+            "optional": true
+        },
+        "solid-js": {
+            "optional": true
+        },
+        "svelte": {
+            "optional": true
+        },
+        "vue": {
+            "optional": true
+        }
+    },
+    "dependencies": {
+        "@better-agent/core": "0.0.1",
+        "@better-agent/shared": "0.0.1"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.2.18",
+        "@types/node": "^22.15.30",
+        "@types/jsdom": "^28.0.0",
+        "@types/react": "^19.2.9",
+        "@types/react-dom": "19.2.2",
+        "jsdom": "^28.1.0",
+        "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"
+    }
+}