vue-ai-hooks 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 hexinmiao96
+
+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 EVENT 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,205 @@
+# vue-ai-hooks
+
+[English](./README.md) | [简体中文](./README.zh-CN.md)
+
+> Vue 3 Composable library for building AI-powered applications.
+> Streaming-first, multi-provider, fully typed.
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Vue 3](https://img.shields.io/badge/vue-3.4+-42b883.svg)](https://vuejs.org)
+[![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6.svg)](https://www.typescriptlang.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+`vue-ai-hooks` brings the same DX you'd expect from [VueUse](https://vueuse.org) or
+[Axios](https://axios-http.com) to the LLM world. Three composables, pluggable
+providers, Server-Sent Events streaming handled for you. Works with OpenAI and any
+OpenAI-compatible service (DeepSeek, Moonshot, Zhipu, Ollama via its OpenAI shim,
+vLLM, etc.).
+
+```ts
+import { useChat, openai } from 'vue-ai-hooks'
+
+const { messages, input, append, isLoading, stop } = useChat({
+  provider: openai({ apiKey: import.meta.env.VITE_OPENAI_KEY })
+})
+```
+
+## Why
+
+The AI-in-Vue story is currently fragmented. Options today:
+
+| Library | Tradeoff |
+|---|---|
+| **Vercel AI SDK** | React-first; Vue support is unofficial and lags behind |
+| **LangChain.js** | Powerful but heavy; opinionated chains, lots of magic |
+| **Direct fetch + manual SSE** | Works, but you re-implement aborts, retries, and state for every project |
+| **vue-ai-hooks** | A focused, framework-native SDK with the boring parts done |
+
+## Features
+
+- 🎯 **Three composables, one mental model** — `useChat`, `useCompletion`, `useEmbedding`
+- 🌊 **Streaming by default** — SSE parsing, AbortController, and reactivity handled for you
+- 🔌 **Multi-provider** — OpenAI, Azure OpenAI, DeepSeek, Moonshot, Zhipu, Ollama, vLLM, any OpenAI-compatible API
+- 🧰 **Tool calling helpers** — register local handlers and let `useChat` continue the model round-trip
+- 🛠 **TypeScript first** — strict mode, no `any` leaks, full IDE autocomplete
+- ⚡ **Tiny** — zero runtime deps beyond Vue itself
+- 🧪 **Tested** — Vitest + happy-dom, with fake providers you can copy
+- 📦 **Tree-shakable** — ESM and CJS, named exports, no side effects
+
+## Installation
+
+```bash
+pnpm add vue-ai-hooks
+# or
+npm install vue-ai-hooks
+# or
+yarn add vue-ai-hooks
+```
+
+Peer dependency: `vue@^3.4.0`.
+
+## Quick start
+
+### Streaming chat
+
+```vue
+<script setup lang="ts">
+import { useChat, openai } from 'vue-ai-hooks'
+
+const { messages, input, append, isLoading, stop, error } = useChat({
+  provider: openai({ apiKey: import.meta.env.VITE_OPENAI_KEY })
+})
+</script>
+
+<template>
+  <div v-for="m in messages" :key="m.id" :class="m.role">
+    {{ m.content }}
+  </div>
+  <textarea v-model="input" />
+  <button :disabled="isLoading" @click="append(input); input = ''">Send</button>
+  <button :disabled="!isLoading" @click="stop">Stop</button>
+</template>
+```
+
+### Single-shot completion
+
+```ts
+import { useCompletion, openai } from 'vue-ai-hooks'
+
+const { completion, complete } = useCompletion({
+  provider: openai({ apiKey: '...' })
+})
+
+await complete('Write a haiku about TypeScript:')
+```
+
+### Embeddings
+
+```ts
+import { useEmbedding, openai } from 'vue-ai-hooks'
+
+const { embed, embeddings } = useEmbedding({
+  provider: openai({ apiKey: '...' })
+})
+
+const result = await embed(['hello world', 'goodbye world'])
+console.log(result.embeddings) // number[][]
+```
+
+## Using a non-OpenAI provider
+
+Every provider implements the same `ChatProvider` interface, so the hooks
+don't care which model is on the other end:
+
+```ts
+import { useChat, openaiCompatible } from 'vue-ai-hooks'
+
+useChat({
+  provider: openaiCompatible({
+    apiKey: 'sk-...',
+    baseURL: 'https://api.deepseek.com/v1'
+  })
+})
+```
+
+Add a new provider in one file by implementing `ChatProvider`:
+
+```ts
+// src/providers/anthropic.ts
+import type { ChatProvider } from 'vue-ai-hooks'
+// ... implement chat / completion / embedding
+```
+
+Then open a PR — the hook layer stays untouched.
+
+## API reference
+
+### `useChat(options)`
+
+Returns a reactive bundle for managing a streaming chat conversation.
+
+| Return | Type | Description |
+|---|---|---|
+| `messages` | `Ref<Message[]>` | Full message history (user, assistant, system, tool) |
+| `input` | `Ref<string>` | Bound to your composer; not auto-cleared |
+| `isLoading` | `Ref<boolean>` | True while a stream is in flight |
+| `error` | `Ref<Error \| null>` | Last error, cleared on next `append` |
+| `append(content, opts?)` | `(string \| Message, Partial<ChatRequest>) => Promise<void>` | Send a message and stream the reply |
+| `reload()` | `() => Promise<void>` | Re-run the last assistant turn |
+| `stop()` | `() => void` | Abort the in-flight stream |
+| `setMessages(messages)` | `(Message[]) => void` | Replace history (e.g. on restore) |
+| `clear()` | `() => void` | Reset to empty state |
+| `abortController` | `Ref<AbortController \| null>` | Exposed for advanced use cases |
+
+### `useCompletion(options)` / `useEmbedding(options)`
+
+Same shape, scoped to single-shot completions and embedding vectors respectively.
+See [the source](./src/composables/) for full type definitions.
+
+## Examples
+
+Three runnable examples live in [`examples/`](./examples):
+
+- `examples/chat` — minimal streaming chat UI
+- `examples/completion` — single-shot completion form
+- `examples/embedding` — pairwise cosine similarity heatmap
+
+To run them:
+
+```bash
+pnpm install
+echo "VITE_OPENAI_KEY=sk-..." > .env
+pnpm example:chat
+```
+
+## Project status
+
+This is **v0.2.0** — a working foundation, not feature-complete. What's in:
+
+- ✅ Chat with streaming, abort, message history
+- ✅ Single-shot completion
+- ✅ Embedding
+- ✅ OpenAI + OpenAI-compatible provider
+- ✅ Anthropic Claude provider
+- ✅ Multimodal image input
+- ✅ localStorage persistence
+- ✅ Tool-calling helpers
+- ✅ Tests, CI, examples
+
+What we're planning next:
+
+- 🔜 Vue DevTools tab for inspecting streams
+- 🔜 More providers and production hardening
+
+## Contributing
+
+Contributions are very welcome. See [`CONTRIBUTING.md`](./CONTRIBUTING.md) for
+the workflow, and the [open issues](../../issues) for things that need hands.
+
+Adding a new provider is the single best first contribution — it's one file,
+a small interface, and high-value. See [`src/providers/openai.ts`](./src/providers/openai.ts)
+for the reference implementation.
+
+## License
+
+[MIT](./LICENSE)

package/README.zh-CN.md

@@ -0,0 +1,178 @@
+# vue-ai-hooks
+
+[English](./README.md) | 简体中文
+
+> 用于构建 AI 应用的 Vue 3 组合式函数库。
+> 流式优先、多 Provider、完整类型支持。
+
+[![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Vue 3](https://img.shields.io/badge/vue-3.4+-42b883.svg)](https://vuejs.org)
+[![TypeScript](https://img.shields.io/badge/typescript-strict-3178c6.svg)](https://www.typescriptlang.org)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
+
+`vue-ai-hooks` 把你在 [VueUse](https://vueuse.org) 或 [Axios](https://axios-http.com) 中熟悉的开发体验带到 LLM 应用里。它提供三个组合式函数、可插拔 Provider，并帮你处理 Server-Sent Events 流式响应。支持 OpenAI 以及任何 OpenAI-compatible 服务，例如 DeepSeek、Moonshot、智谱、Ollama 的 OpenAI shim、vLLM 等。
+
+```ts
+import { useChat, openai } from 'vue-ai-hooks'
+
+const { messages, input, append, isLoading, stop } = useChat({
+  provider: openai({ apiKey: import.meta.env.VITE_OPENAI_KEY })
+})
+```
+
+## 为什么需要它
+
+当前 Vue 中的 AI 开发体验仍然比较分散：
+
+| 库 | 取舍 |
+|---|---|
+| **Vercel AI SDK** | React 优先；Vue 支持非官方且通常滞后 |
+| **LangChain.js** | 功能强大但偏重；链式抽象较多，魔法也多 |
+| **直接 fetch + 手写 SSE** | 可行，但每个项目都要重复实现中止、重试和状态管理 |
+| **vue-ai-hooks** | 专注、框架原生，并把繁琐部分处理好 |
+
+## 特性
+
+- **三个组合式函数，一套心智模型**：`useChat`、`useCompletion`、`useEmbedding`
+- **默认支持流式响应**：SSE 解析、AbortController 和响应式状态都已处理好
+- **多 Provider**：OpenAI、Azure OpenAI、DeepSeek、Moonshot、智谱、Ollama、vLLM，以及任何 OpenAI-compatible API
+- **Tool calling helper**：注册本地 handler 后，`useChat` 会自动执行工具并继续模型轮次
+- **TypeScript 优先**：严格模式、无 `any` 泄漏、完整 IDE 自动补全
+- **小而轻**：除 Vue 本身外没有运行时依赖
+- **已测试**：Vitest + happy-dom，并提供可复制的 fake provider
+- **可 tree-shaking**：ESM 和 CJS、命名导出、无副作用
+
+## 安装
+
+```bash
+pnpm add vue-ai-hooks
+# 或
+npm install vue-ai-hooks
+# 或
+yarn add vue-ai-hooks
+```
+
+Peer dependency：`vue@^3.4.0`。
+
+## 快速开始
+
+### 流式聊天
+
+```vue
+<script setup lang="ts">
+import { useChat, openai } from 'vue-ai-hooks'
+
+const { messages, input, append, isLoading, stop, error } = useChat({
+  provider: openai({ apiKey: import.meta.env.VITE_OPENAI_KEY })
+})
+</script>
+
+<template>
+  <div v-for="m in messages" :key="m.id" :class="m.role">
+    {{ m.content }}
+  </div>
+  <textarea v-model="input" />
+  <button :disabled="isLoading" @click="append(input); input = ''">Send</button>
+  <button :disabled="!isLoading" @click="stop">Stop</button>
+</template>
+```
+
+### 单次补全
+
+```ts
+import { useCompletion, openai } from 'vue-ai-hooks'
+
+const { completion, complete } = useCompletion({
+  provider: openai({ apiKey: '...' })
+})
+
+await complete('Write a haiku about TypeScript:')
+```
+
+### Embeddings
+
+```ts
+import { useEmbedding, openai } from 'vue-ai-hooks'
+
+const { embed, embeddings } = useEmbedding({
+  provider: openai({ apiKey: '...' })
+})
+
+const result = await embed(['hello world', 'goodbye world'])
+console.log(result.embeddings) // number[][]
+```
+
+## 使用非 OpenAI Provider
+
+每个 Provider 都实现同一个 `ChatProvider` 接口，所以组合式函数不关心另一端具体使用哪个模型：
+
+```ts
+import { useChat, openaiCompatible } from 'vue-ai-hooks'
+
+useChat({
+  provider: openaiCompatible({
+    apiKey: 'sk-...',
+    baseURL: 'https://api.deepseek.com/v1'
+  })
+})
+```
+
+新增 Provider 只需要实现 `ChatProvider`：
+
+```ts
+// src/providers/anthropic.ts
+import type { ChatProvider } from 'vue-ai-hooks'
+// ... implement chat / completion / embedding
+```
+
+然后提交 PR，组合式函数层不需要改动。
+
+## 文档
+
+- [English docs](./docs/index.md)
+- [中文文档](./docs/zh/index.md)
+
+## 示例
+
+三个可运行示例位于 [`examples/`](./examples)：
+
+- `examples/chat`：最小流式聊天 UI
+- `examples/completion`：单次补全表单
+- `examples/embedding`：成对余弦相似度热力图
+
+运行方式：
+
+```bash
+pnpm install
+echo "VITE_OPENAI_KEY=sk-..." > .env
+pnpm example:chat
+```
+
+## 项目状态
+
+这是 **v0.2.0**，是一个可工作的基础版本，但还不是功能完备版本。目前已包含：
+
+- Chat 流式响应、中止、消息历史
+- 单次补全
+- Embedding
+- OpenAI + OpenAI-compatible Provider
+- Anthropic Claude Provider
+- 多模态图片输入
+- localStorage 持久化
+- Tool-calling helper
+- 测试、CI、示例
+
+下一步计划：
+
+- 用于检查流的 Vue DevTools tab
+- 更多 Provider 和生产级增强
+
+## 贡献
+
+欢迎贡献。请查看 [`CONTRIBUTING.md`](./CONTRIBUTING.md) 了解工作流，也可以查看 [open issues](../../issues) 中待处理的事项。
+
+新增 Provider 是最适合作为第一次贡献的方向：只需要一个文件、一个小接口，而且价值很高。参考实现见 [`src/providers/openai.ts`](./src/providers/openai.ts)。
+
+## License
+
+[MIT](./LICENSE)

package/dist/composables/_tc_merge.d.ts

@@ -0,0 +1,13 @@
+import type { ToolCall } from '../types';
+export interface ToolCallDelta {
+    index?: number;
+    id?: string;
+    type?: 'function';
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+/** Merge streaming tool_call deltas (OpenAI format) into a stable array. */
+export declare function mergeDeltas(existing: ToolCall[] | undefined, delta: ToolCallDelta[] | undefined): ToolCall[];
+//# sourceMappingURL=_tc_merge.d.ts.map

package/dist/composables/_tc_merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_tc_merge.d.ts","sourceRoot":"","sources":["../../src/composables/_tc_merge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAkB5G"}

package/dist/composables/useChat.d.ts

@@ -0,0 +1,39 @@
+import { type Ref } from 'vue';
+import type { ChatProvider } from '../providers/types';
+import type { ChatRequest, Message, Tool, ToolCall } from '../types';
+export interface ToolCallHandlerContext {
+    toolCall: ToolCall;
+    messages: Message[];
+}
+export type ToolCallHandler = (args: unknown, context: ToolCallHandlerContext) => unknown | Promise<unknown>;
+export interface UseChatOptions {
+    provider?: ChatProvider;
+    initialMessages?: Message[];
+    defaultRequest?: Partial<ChatRequest>;
+    id?: string;
+    persist?: {
+        key: string;
+        version?: number;
+    };
+    tools?: Tool[];
+    toolChoice?: ChatRequest['toolChoice'];
+    toolHandlers?: Record<string, ToolCallHandler>;
+    maxToolRoundtrips?: number;
+    onUpdate?: (m: Message) => void;
+    onFinish?: (m: Message) => void;
+    onError?: (e: Error) => void;
+}
+export interface UseChatReturn {
+    messages: Ref<Message[]>;
+    input: Ref<string>;
+    isLoading: Ref<boolean>;
+    error: Ref<Error | null>;
+    append: (c: string | Message, o?: Partial<ChatRequest>) => Promise<void>;
+    reload: () => Promise<void>;
+    stop: () => void;
+    setMessages: (m: Message[]) => void;
+    clear: () => void;
+    abortController: Ref<AbortController | null>;
+}
+export declare function useChat(options: UseChatOptions): UseChatReturn;
+//# sourceMappingURL=useChat.d.ts.map

package/dist/composables/useChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useChat.d.ts","sourceRoot":"","sources":["../../src/composables/useChat.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAe,IAAI,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAIjF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,CAC5B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,sBAAsB,KAC5B,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,eAAe,CAAC,EAAE,OAAO,EAAE,CAAA;IAC3B,cAAc,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;IACrC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC9C,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACvB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACxB,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,WAAW,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;IACnC,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,eAAe,EAAE,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;CAC7C;AAID,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CA+O9D"}

package/dist/composables/useCompletion.d.ts

@@ -0,0 +1,31 @@
+import { type Ref } from 'vue';
+import type { ChatProvider } from '../providers/types';
+import type { CompletionRequest } from '../types';
+export interface UseCompletionOptions {
+    provider: ChatProvider;
+    initialCompletion?: string;
+    defaultRequest?: Partial<CompletionRequest>;
+    onFinish?: (completion: string) => void;
+    onError?: (err: Error) => void;
+}
+export interface UseCompletionReturn {
+    completion: Ref<string>;
+    input: Ref<string>;
+    isLoading: Ref<boolean>;
+    error: Ref<Error | null>;
+    complete: (prompt?: string, options?: Partial<CompletionRequest>) => Promise<string>;
+    stop: () => void;
+    setCompletion: (value: string) => void;
+    abortController: Ref<AbortController | null>;
+}
+/**
+ * Vue 3 composable for single-shot streaming completions.
+ *
+ * ```ts
+ * const { completion, input, complete } = useCompletion({
+ *   provider: openai({ apiKey: import.meta.env.VITE_OPENAI_KEY })
+ * })
+ * ```
+ */
+export declare function useCompletion(options: UseCompletionOptions): UseCompletionReturn;
+//# sourceMappingURL=useCompletion.d.ts.map

package/dist/composables/useCompletion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompletion.d.ts","sourceRoot":"","sources":["../../src/composables/useCompletion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,YAAY,CAAA;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3C,QAAQ,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACvB,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IAClB,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACvB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACxB,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACpF,IAAI,EAAE,MAAM,IAAI,CAAA;IAChB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,eAAe,EAAE,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;CAC7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAqEhF"}

package/dist/composables/useEmbedding.d.ts

@@ -0,0 +1,29 @@
+import { type Ref } from 'vue';
+import type { ChatProvider } from '../providers/types';
+import type { EmbeddingRequest, EmbeddingResult } from '../types';
+export interface UseEmbeddingOptions {
+    provider: ChatProvider;
+    defaultRequest?: Partial<EmbeddingRequest>;
+    onSuccess?: (result: EmbeddingResult) => void;
+    onError?: (err: Error) => void;
+}
+export interface UseEmbeddingReturn {
+    embeddings: Ref<number[][]>;
+    isLoading: Ref<boolean>;
+    error: Ref<Error | null>;
+    result: Ref<EmbeddingResult | null>;
+    embed: (input: string | string[], options?: Partial<EmbeddingRequest>) => Promise<EmbeddingResult>;
+    abortController: Ref<AbortController | null>;
+}
+/**
+ * Vue 3 composable for generating text embeddings.
+ *
+ * ```ts
+ * const { embed, embeddings, isLoading } = useEmbedding({
+ *   provider: openai({ apiKey: import.meta.env.VITE_OPENAI_KEY })
+ * })
+ * const { embeddings: vecs } = await embed('hello world')
+ * ```
+ */
+export declare function useEmbedding(options: UseEmbeddingOptions): UseEmbeddingReturn;
+//# sourceMappingURL=useEmbedding.d.ts.map

package/dist/composables/useEmbedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEmbedding.d.ts","sourceRoot":"","sources":["../../src/composables/useEmbedding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAEjE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,YAAY,CAAA;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAC1C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;IAC7C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC3B,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAA;IACvB,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAA;IACxB,MAAM,EAAE,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IACnC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;IAClG,eAAe,EAAE,GAAG,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;CAC7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CA6C7E"}

package/dist/composables/usePersist.d.ts

@@ -0,0 +1,48 @@
+import { type Ref } from 'vue';
+/**
+ * Options for `usePersist` — drop-in localStorage persistence for a single
+ * reactive ref.
+ */
+export interface UsePersistOptions<T> {
+    /** localStorage key. Required. */
+    key: string;
+    /**
+     * Bump this when the shape of `T` changes incompatibly. The persisted
+     * payload is stored under `${key}:v${version}` so old data is naturally
+     * ignored. Omit to skip versioning.
+     */
+    version?: number;
+    /**
+     * Custom serializer. Receives the current value, returns the JSON-safe
+     * representation. Default: identity.
+     */
+    serialize?: (value: T) => unknown;
+    /**
+     * Custom deserializer. Receives the parsed JSON, returns the value (or null
+     * to discard it). Default: identity.
+     */
+    deserialize?: (raw: unknown) => T | null;
+    /**
+     * Override the storage. Default: `window.localStorage` when available.
+     * Pass an in-memory shim in tests.
+     */
+    storage?: Storage | null;
+    /**
+     * Ref to write errors to. Errors during load are silently skipped (the
+     * caller can decide to surface them); errors during save are written here.
+     */
+    onError?: (err: Error) => void;
+}
+/**
+ * Wire a ref up to localStorage. Hydrates on creation, writes on every
+ * mutation. Returns a `clear()` function that removes the storage entry.
+ *
+ * ```ts
+ * const messages = ref<Message[]>([])
+ * const { clear } = usePersist(messages, { key: 'my-chat' })
+ * ```
+ */
+export declare function usePersist<T>(source: Ref<T>, options: UsePersistOptions<T>): {
+    clear: () => void;
+};
+//# sourceMappingURL=usePersist.d.ts.map

package/dist/composables/usePersist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePersist.d.ts","sourceRoot":"","sources":["../../src/composables/usePersist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAErC;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAA;IACX;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAA;IACjC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,GAAG,IAAI,CAAA;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAA;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG;IAC5E,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAiDA"}

package/dist/index.cjs

@@ -0,0 +1,8 @@
+"use strict";var Z=Object.defineProperty;var q=(u,m,s)=>m in u?Z(u,m,{enumerable:!0,configurable:!0,writable:!0,value:s}):u[m]=s;var B=(u,m,s)=>q(u,typeof m!="symbol"?m+"":m,s);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("vue");function F(u,m){var g,i,b,l;const s=u?[...u]:[];for(const a of m??[]){const f=a.index;f!==void 0&&(s[f]?(a.id&&(s[f].id=a.id),(b=a.function)!=null&&b.name&&(s[f].function.name+=a.function.name),(l=a.function)!=null&&l.arguments&&(s[f].function.arguments+=a.function.arguments)):s[f]={id:a.id??"",type:"function",function:{name:((g=a.function)==null?void 0:g.name)??"",arguments:((i=a.function)==null?void 0:i.arguments)??""}})}return s}function X(u,m){const{key:s,version:g,serialize:i,deserialize:b,storage:l,onError:a}=m,f=g!==void 0?`${s}:v${g}`:s,p=l!==void 0?l:typeof window<"u"?window.localStorage:null;if(p)try{const k=p.getItem(f);if(k!==null){const x=JSON.parse(k),t=b?b(x):x;t!=null&&(u.value=t)}}catch{}p&&P.watch(u,k=>{try{const x=i?i(k):k;p.setItem(f,JSON.stringify(x))}catch(x){a==null||a(x instanceof Error?x:new Error(String(x)))}},{deep:!0});function n(){if(p)try{p.removeItem(f)}catch{}}return{clear:n}}let G=0;function W(u="msg"){return G+=1,`${u}_${Date.now().toString(36)}_${G.toString(36)}`}class M extends Error{constructor(s,g={}){super(s);B(this,"cause");B(this,"status");this.name="AiHooksError",this.cause=g.cause,this.status=g.status}}const ee=[];function te(u){const{provider:m,initialMessages:s=ee,defaultRequest:g={},onUpdate:i,onFinish:b,onError:l,persist:a,tools:f,toolChoice:p,toolHandlers:n,maxToolRoundtrips:k=1}=u;if(!m)throw new Error("useChat requires a provider option");const x=m,t=P.ref([...s]),d=P.ref(""),h=P.ref(!1),T=P.ref(null),_=P.shallowRef(null),e=a?X(t,{key:a.key,version:a.version,onError:o=>{T.value=o}}):null;function c(o){t.value=[...o]}function v(){_.value&&_.value.abort(),_.value=null,t.value=[],T.value=null,h.value=!1,d.value="",e==null||e.clear()}function r(){_.value&&_.value.abort(),_.value=null,h.value=!1}function A(){return{id:W("assistant"),role:"assistant",content:"",createdAt:new Date}}function $(o){return o instanceof Error?o:new Error(String(o))}function y(o){const w=$(o);return T.value=w,l==null||l(w),w}function D(o){const w=o.function.arguments.trim();if(!w)return{};try{return JSON.parse(w)}catch(C){throw new M(`Invalid JSON arguments for tool "${o.function.name}"`,{cause:C})}}function L(o){return typeof o=="string"?o:o===void 0?"":JSON.stringify(o)}async function S(o){const w=[];for(const C of o){const R=n==null?void 0:n[C.function.name];if(!R)throw new M(`No tool handler registered for "${C.function.name}"`);const E=await R(D(C),{toolCall:C,messages:[...t.value]});w.push({id:W("tool"),role:"tool",content:L(E),toolCallId:C.id,createdAt:new Date})}return w}async function O(o,w){var R;const C=new AbortController;_.value=C,h.value=!0,T.value=null;try{const E={...g,...f&&!w.tools?{tools:f}:{},...p&&!w.toolChoice?{toolChoice:p}:{},...w,signal:C.signal},I=await x.chat(E);for await(const J of I){if(J.content){o.content+=J.content;const N=t.value.findIndex(U=>U.id===o.id);N>=0&&(t.value=[...t.value.slice(0,N),{...o},...t.value.slice(N+1)]),i==null||i({...o})}if((R=J.toolCalls)!=null&&R.length){o.toolCalls=F(o.toolCalls,J.toolCalls);const N=t.value.findIndex(U=>U.id===o.id);N>=0&&(t.value=[...t.value.slice(0,N),{...o},...t.value.slice(N+1)])}if(J.finishReason){o.metadata={...o.metadata??{},finishReason:J.finishReason};const N=t.value.findIndex(U=>U.id===o.id);N>=0&&(t.value=[...t.value.slice(0,N),{...o},...t.value.slice(N+1)])}}b==null||b({...o})}catch(E){const I=$(E);if(I.name==="AbortError"||C.signal.aborted){b==null||b({...o});return}throw T.value=I,l==null||l(I),I}finally{_.value=null,h.value=!1}}async function j(o,w,C){await O(o,w);const R=o.toolCalls;if(!n||!(R!=null&&R.length))return;if(C<=0)throw y(new M("Maximum tool roundtrips exceeded"));h.value=!0;let E;try{E=await S(R)}catch(J){throw h.value=!1,y(J)}const I=A();t.value=[...t.value,...E,I],await j(I,{messages:t.value.filter(J=>J.id!==I.id)},C-1)}async function z(o,w={}){const C=typeof o=="string"?{id:W("user"),role:"user",content:o,createdAt:new Date}:{...o,id:o.id||W(o.role)},R=A();t.value=[...t.value,C,R],await j(R,{messages:t.value.filter(E=>E.id!==R.id),...w},k)}async function H(){var R;const o=(R=[...t.value].map((E,I)=>({m:E,i:I})).reverse().find(({m:E})=>E.role==="assistant"))==null?void 0:R.i;if(o===void 0)throw new M("reload() called with no assistant message to re-run");const w=t.value.slice(0,o),C=A();t.value=[...w,C],await j(C,{messages:w},k)}return{messages:t,input:d,isLoading:h,error:T,append:z,reload:H,stop:r,setMessages:c,clear:v,abortController:_}}function oe(u){const{provider:m,initialCompletion:s="",defaultRequest:g={},onFinish:i,onError:b}=u,l=P.ref(s),a=P.ref(""),f=P.ref(!1),p=P.ref(null),n=P.shallowRef(null);function k(){n.value&&n.value.abort(),n.value=null,f.value=!1}function x(d){l.value=d}async function t(d,h={}){const T=d??a.value;if(!T)throw new Error("complete() requires a prompt (either as argument or via input.value)");const _=new AbortController;n.value=_,f.value=!0,p.value=null,l.value="";try{const e=await m.completion({...g,...h,prompt:T,signal:_.signal,stream:!0});for await(const c of e)l.value+=c;return i==null||i(l.value),l.value}catch(e){const c=e instanceof Error?e:new Error(String(e));if(c.name==="AbortError"||_.signal.aborted)return i==null||i(l.value),l.value;throw p.value=c,b==null||b(c),c}finally{n.value=null,f.value=!1}}return{completion:l,input:a,isLoading:f,error:p,complete:t,stop:k,setCompletion:x,abortController:n}}function ne(u){const{provider:m,defaultRequest:s={},onSuccess:g,onError:i}=u,b=P.ref([]),l=P.ref(!1),a=P.ref(null),f=P.shallowRef(null),p=P.shallowRef(null);async function n(k,x={}){const t=new AbortController;p.value=t,l.value=!0,a.value=null;try{const d=await m.embedding({...s,...x,input:k,signal:t.signal});return b.value=d.embeddings,f.value=d,g==null||g(d),d}catch(d){const h=d instanceof Error?d:new Error(String(d));throw a.value=h,i==null||i(h),h}finally{p.value=null,l.value=!1}}return{embeddings:b,isLoading:l,error:a,result:f,embed:n,abortController:p}}async function*V(u,m){if(!u.body)throw new Error("Response has no body");const s=u.body.getReader(),g=new TextDecoder("utf-8");let i="";try{for(;;){if(m!=null&&m.aborted){await s.cancel();return}const{done:b,value:l}=await s.read();if(b)break;i+=g.decode(l,{stream:!0}).replace(/\r\n/g,`
+`).replace(/\r/g,`
+`);let a;for(;(a=i.indexOf(`
+
+`))!==-1;){const f=i.slice(0,a);i=i.slice(a+2);for(const p of f.split(`
+`)){if(!p.startsWith("data:"))continue;const n=p.slice(5).trim();if(n==="[DONE]")return;if(n)try{yield JSON.parse(n)}catch{}}}}}finally{s.releaseLock()}}async function K(u,m={}){const{timeoutMs:s,signal:g,fetcher:i,...b}=m,l=i??(typeof globalThis.fetch=="function"?globalThis.fetch.bind(globalThis):void 0);if(!l)throw new M("No fetch implementation available");const a=new AbortController,f=()=>a.abort();g&&(g.aborted?a.abort():g.addEventListener("abort",f,{once:!0}));let p;s&&s>0&&(p=setTimeout(()=>a.abort(),s));try{const n=await l(u,{...b,signal:a.signal});if(!n.ok){let k;try{k=await n.json()}catch{k=await n.text().catch(()=>{})}throw new M(`Request failed with status ${n.status} ${n.statusText}`,{status:n.status,cause:k})}return n}catch(n){throw n instanceof M?n:(n==null?void 0:n.name)==="AbortError"?new M("Request aborted",{cause:n}):new M("Network error",{cause:n})}finally{p&&clearTimeout(p),g&&g.removeEventListener("abort",f)}}function Y(u){const{apiKey:m,baseURL:s,headers:g={},defaultModel:i,chatPath:b="/chat/completions",completionPath:l="/completions",embeddingPath:a="/embeddings",fetch:f}=u,p={"Content-Type":"application/json",Authorization:`Bearer ${m}`,...g},n=(x,t)=>{const d=x.replace(/\/+$/,""),h=t.startsWith("/")?t:`/${t}`;return`${d}${h}`};function k(x){return x.map(t=>{var h;const d={role:t.role,content:t.content};return t.name&&(d.name=t.name),t.toolCallId&&(d.tool_call_id=t.toolCallId),(h=t.toolCalls)!=null&&h.length&&(d.tool_calls=t.toolCalls),d})}return{id:"openai-compatible",async chat(x){const{messages:t,model:d=i,temperature:h,maxTokens:T,topP:_,frequencyPenalty:e,presencePenalty:c,stop:v,tools:r,toolChoice:A,user:$,stream:y=!0,signal:D,headers:L}=x,S={model:d,messages:k(t),stream:y};h!==void 0&&(S.temperature=h),T!==void 0&&(S.max_tokens=T),_!==void 0&&(S.top_p=_),e!==void 0&&(S.frequency_penalty=e),c!==void 0&&(S.presence_penalty=c),v!==void 0&&(S.stop=v),r&&(S.tools=r),A&&(S.tool_choice=A),$&&(S.user=$);const O=await K(n(s,b),{method:"POST",headers:{...p,...L},body:JSON.stringify(S),signal:D,fetcher:f});if(!y){const j=await O.json();return async function*(){var z,H,o,w,C;yield{content:((o=(H=(z=j.choices)==null?void 0:z[0])==null?void 0:H.message)==null?void 0:o.content)??"",finishReason:((C=(w=j.choices)==null?void 0:w[0])==null?void 0:C.finish_reason)??"stop",usage:j.usage}}()}return async function*(){var j,z,H;for await(const o of V(O,D)){const w=(j=o.choices)==null?void 0:j[0];if(!w)continue;const C=o.usage;yield{content:(z=w.delta)==null?void 0:z.content,toolCalls:(H=w.delta)==null?void 0:H.tool_calls,finishReason:w.finish_reason??void 0,usage:C}}}()},async completion(x){const{prompt:t,model:d=i,temperature:h,maxTokens:T,topP:_,frequencyPenalty:e,presencePenalty:c,stop:v,stream:r=!0,signal:A,headers:$}=x,y={model:d,prompt:t,stream:r};h!==void 0&&(y.temperature=h),T!==void 0&&(y.max_tokens=T),_!==void 0&&(y.top_p=_),e!==void 0&&(y.frequency_penalty=e),c!==void 0&&(y.presence_penalty=c),v!==void 0&&(y.stop=v);const D=await K(n(s,l),{method:"POST",headers:{...p,...$},body:JSON.stringify(y),signal:A,fetcher:f});if(!r){const L=await D.json();return async function*(){var S,O;yield((O=(S=L.choices)==null?void 0:S[0])==null?void 0:O.text)??""}()}return async function*(){var L;for await(const S of V(D,A)){const O=(L=S.choices)==null?void 0:L[0];O!=null&&O.text&&(yield O.text)}}()},async embedding(x){const{input:t,model:d=i,user:h,signal:T,headers:_}=x,e={input:t};d&&(e.model=d),h&&(e.user=h);const v=await(await K(n(s,a),{method:"POST",headers:{...p,..._},body:JSON.stringify(e),signal:T,fetcher:f})).json();return{embeddings:v.data.map(r=>r.embedding),model:v.model,usage:{promptTokens:v.usage.prompt_tokens,totalTokens:v.usage.total_tokens}}}}}function ae(u){return Y({baseURL:"https://api.openai.com/v1",defaultModel:"gpt-4o-mini",...u})}function Q(u){switch(u){case"end_turn":case"stop_sequence":return"stop";case"max_tokens":return"length";case"tool_use":return"tool_calls";default:return"stop"}}function se(u){const{apiKey:m,baseURL:s="https://api.anthropic.com",defaultModel:g="claude-3-5-sonnet-20241022",maxTokens:i=1024,anthropicVersion:b="2023-06-01",headers:l={},fetch:a}=u,f={"Content-Type":"application/json","x-api-key":m,"anthropic-version":b,...l},p=e=>{const c=s.replace(/\/+$/,""),v=e.startsWith("/")?e:`/${e}`;return`${c}${v}`};function n(e){return typeof e=="string"?e:e.map(c=>k(c))}function k(e){if(e.type==="text")return{type:"text",text:e.text};const c=e.image_url.url;if(c.startsWith("data:")){const v=c.match(/^data:([^;]+);base64,(.*)$/s);if(v)return{type:"image",source:{type:"base64",media_type:v[1],data:v[2]}}}return{type:"image",source:{type:"url",url:c}}}function x(e){const c=[],v=[];for(const r of e)r.role==="system"?typeof r.content=="string"&&r.content&&c.push(r.content):(r.role==="user"||r.role==="assistant")&&v.push({role:r.role,content:n(r.content)});return{system:c.length?c.join(`
+
+`):void 0,messages:v}}function t(e){const{system:c,messages:v}=x(e.messages),r={model:e.model??g,messages:v,max_tokens:e.maxTokens??i,stream:e.stream??!0};return c&&(r.system=c),e.temperature!==void 0&&(r.temperature=e.temperature),e.topP!==void 0&&(r.top_p=e.topP),e.stop!==void 0&&(r.stop_sequences=Array.isArray(e.stop)?e.stop:[e.stop]),e.user&&(r.metadata={user_id:e.user}),r}async function d(e){const c=t({...e,stream:e.stream??!0}),v=await K(p("/v1/messages"),{method:"POST",headers:{...f,...e.headers},body:JSON.stringify(c),signal:e.signal,fetcher:a});if(e.stream===!1){const r=await v.json();return async function*(){const A=r.content.find($=>$.type==="text");yield{content:(A==null?void 0:A.text)??"",finishReason:Q(r.stop_reason),usage:r.usage?{promptTokens:r.usage.input_tokens,completionTokens:r.usage.output_tokens,totalTokens:r.usage.input_tokens+r.usage.output_tokens}:void 0}}()}return async function*(){var r;for await(const A of V(v,e.signal)){const $=A.type;if($==="content_block_delta"){const y=A.delta;(y==null?void 0:y.type)==="text_delta"&&typeof y.text=="string"&&(yield{content:y.text})}else if($==="message_delta"){const y=(r=A.delta)==null?void 0:r.stop_reason;y&&(yield{finishReason:Q(y)})}else if($==="error"){const y=A.error;throw new M(`Anthropic API error: ${(y==null?void 0:y.type)??"unknown"}: ${(y==null?void 0:y.message)??"unknown"}`,{cause:A})}}}()}async function h(e){return(async function*(){const c=await this.chat({...e,messages:[{id:"prompt",role:"user",content:e.prompt}]});for await(const v of c)v.content&&(yield v.content)}).call(_)}async function T(){throw new M("Anthropic has no embedding API",{status:501})}const _={id:"anthropic",chat:d,completion:h,embedding:T};return _}exports.AiHooksError=M;exports.anthropic=se;exports.openai=ae;exports.openaiCompatible=Y;exports.useChat=te;exports.useCompletion=oe;exports.useEmbedding=ne;exports.usePersist=X;

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * vue-ai-hooks — Vue 3 Composable library for AI applications.
+ *
+ * @packageDocumentation
+ */
+export { useChat, type ToolCallHandler, type ToolCallHandlerContext, type UseChatOptions, type UseChatReturn } from './composables/useChat';
+export { useCompletion, type UseCompletionOptions, type UseCompletionReturn } from './composables/useCompletion';
+export { useEmbedding, type UseEmbeddingOptions, type UseEmbeddingReturn } from './composables/useEmbedding';
+export { openai, openaiCompatible, type OpenAiLikeConfig } from './providers/openai';
+export { anthropic, type AnthropicConfig } from './providers/anthropic';
+export { type ChatProvider } from './providers/types';
+export { usePersist, type UsePersistOptions } from './composables/usePersist';
+export type { Message, MessageRole, MessageContent, ContentPart, TextPart, ImageUrlPart, Tool, ToolCall, ChatRequest, ChatChunk, CompletionRequest, EmbeddingRequest, EmbeddingResult } from './types';
+export { AiHooksError } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,OAAO,EACP,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,4BAA4B,CAAA;AAGnC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACpF,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAG7E,YAAY,EACV,OAAO,EACP,WAAW,EACX,cAAc,EACd,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA"}