assistant-ui-onetag 0.0.0-stage → 0.1.0

package/LICENSE

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

package/README.md

@@ -1,3 +1,116 @@
-# Temporary Holding Version
+# assistant-ui-onetag
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A [OneTag AI](https://onetagai.com) chat model adapter for [assistant-ui](https://www.assistant-ui.com)'s `LocalRuntime`. The model call runs in the browser, so your chat needs no API route, no proxy and no server: a `vite build`, a Next.js static export or a GitHub Pages site is enough.
+
+That only works because a OneTag key is designed to be public. It can sit in your page's JavaScript in production. Every key has a hard token cap, and on the paid plan it can be locked to your domain, so a copied key cannot run up a bill or be used from someone else's site.
+
+```bash
+npm install assistant-ui-onetag @assistant-ui/react
+```
+
+```tsx
+"use client";
+import { AssistantRuntimeProvider } from "@assistant-ui/react";
+import { useOneTagRuntime } from "assistant-ui-onetag";
+import { Thread } from "@/components/assistant-ui/elements/thread.aui"; // npx shadcn add https://r.assistant-ui.com/thread.json
+
+export function Chat() {
+  const runtime = useOneTagRuntime({
+    apiKey: "ot_...", // public by design
+    system: "You are a helpful assistant.",
+    maxTokens: 800,
+  });
+  return (
+    <AssistantRuntimeProvider runtime={runtime}>
+      <Thread />
+    </AssistantRuntimeProvider>
+  );
+}
+```
+
+Or keep your own `useLocalRuntime` call and pass the adapter:
+
+```tsx
+import { useLocalRuntime } from "@assistant-ui/react";
+import { createOneTagAdapter } from "assistant-ui-onetag";
+
+const OneTag = createOneTagAdapter({ apiKey: "ot_..." });
+const runtime = useLocalRuntime(OneTag, { adapters: { /* history, suggestions, ... */ } });
+```
+
+## Getting a key
+
+Enter your email at [onetagai.com/#get-key](https://onetagai.com/#get-key) and the key arrives by mail. No card. There is no way to use OneTag on a live site without that signup.
+
+- Free: 1,000,000 free tokens, one time, no monthly reset.
+- Pro: $9.9/month, 100M tokens, and the key can be locked to your domains.
+
+The example in [`examples/vite`](examples/vite) uses a shared demo key when it runs on localhost, so `npm run dev` works before you sign up. That key has a small daily budget shared by everyone; for a real site, use your own key.
+
+## Options
+
+| Option | Default | Notes |
+| --- | --- | --- |
+| `apiKey` | (required) | Your OneTag key. |
+| `system` | none | System prompt. A system prompt from the model context (`useAssistantInstructions`) is appended after it. |
+| `maxTokens` | OneTag's 2000 | Reply length cap, up to 10000. `callSettings.maxTokens` in the model context wins. |
+| `temperature` | model default | `callSettings.temperature` in the model context wins. |
+| `ignoreTools` | `false` | See "Tools" below. |
+| `baseUrl` | `https://onetagai.com/v1` | |
+| `runtime` | none | `useOneTagRuntime` only: options passed to `useLocalRuntime` (`adapters`, `initialMessages`, ...). |
+
+## What works and what does not
+
+Works:
+
+- Streaming text replies, Stop, edit, reload and branching (all handled by `LocalRuntime`).
+- Multi-turn history; system messages in the thread and `useAssistantInstructions` become the system prompt.
+- Any static host. The only network call is a `POST` from the browser to `https://onetagai.com/v1/chat/completions`.
+- A reply cut by `maxTokens` ends as `incomplete` with reason `length`, so the UI can show it was cut.
+
+Does not work, and fails with a clear message instead of silently:
+
+- **Text only.** A message with an attachment, an image, file, audio or data part, or a tool call in its history throws a `OneTagError` with code `unsupported` that names the part. Reasoning and source parts are left out of the request, since they are display data.
+- **Tools.** OneTag cannot call tools. If tools are registered in the model context (`makeAssistantTool`, `useAssistantTool`), the run fails and says which ones, so a tool UI does not just never fire. Pass `ignoreTools: true` to send text without them.
+- **Browser only.** OneTag rejects requests that carry no `Origin` header (`origin_required`). Server-side code, SSR, route handlers, Node scripts and desktop apps without an Origin cannot use the key. That is deliberate: it keeps the public key from working as a backend key. Browser extensions work. In Next.js, use the hook in a client component; `LocalRuntime` already runs the adapter on the client.
+- No OpenAI Responses API, no JSON schema output, one model (`onetag`).
+
+## Errors
+
+Errors reach the thread as the message's error status, so the default `Thread` shows them in its error box. Each is a `OneTagError` with `code`, `statusCode` and a readable `message` that ends with OneTag's own text.
+
+| `code` | When | Message starts with |
+| --- | --- | --- |
+| `missing_key` | `apiKey` is empty | No OneTag key set. Get a free key by email at ... |
+| `bad_key` | 401 | This OneTag key is not valid. ... |
+| `domain_not_allowed` | 403, key locked to other domains | This OneTag key is not allowed on this domain. ... |
+| `origin_required` | 403, called without a browser Origin | OneTag answers only from a browser page or browser extension. ... |
+| `quota_exceeded` | 429, token cap reached | This OneTag key has used all of its tokens. ... |
+| `rate_limited` | 429 | Too many requests to OneTag right now. ... |
+| `too_large` | 413 | The conversation is too long for one OneTag request. ... |
+| `paused` | 503 | This OneTag key is paused. ... |
+| `upstream` | 502, or a failure mid-stream | The model failed to answer. Try again. |
+| `unsupported` | attachments, non-text parts, tools | OneTag is text only ... |
+| `network` | fetch failed | Could not reach OneTag. ... |
+
+Aborts (the Stop button) are passed through untouched, so the message ends as cancelled, not as an error.
+
+## Example
+
+[`examples/vite`](examples/vite) is a Vite app with assistant-ui's shadcn `Thread` component and nothing else:
+
+```bash
+cd examples/vite
+npm install
+npm run dev        # answers on localhost with the demo key
+VITE_ONETAG_KEY=ot_... npm run build   # static files in dist/, deploy anywhere
+```
+
+## Tests
+
+- `npm test`: unit tests with mocked `fetch` (request shape, SSE parsing, errors, message mapping) and a test that mounts a real `LocalRuntime` through `useOneTagRuntime`.
+- `npm run test:browser`: builds the example, serves the static build on localhost and drives the `Thread` in Chrome against the live endpoint (three real calls). Needs `playwright-core` and Chrome; see the top of `test/browser/run.mjs`.
+
+## About
+
+I wrote OneTag AI and this adapter. OneTag is a paid service with a free tier. The adapter is MIT licensed. Service docs: [onetagai.com/docs](https://onetagai.com/docs#openai).

package/dist/adapter.d.ts

@@ -0,0 +1,31 @@
+import type { ChatModelAdapter } from "@assistant-ui/react";
+export declare const ONETAG_BASE_URL = "https://onetagai.com/v1";
+export type OneTagAdapterOptions = {
+    /** Your OneTag key. It is public by design: it can sit in the page's HTML or JS bundle. */
+    apiKey: string;
+    /** System prompt, sent before any system prompt from the model context (useAssistantInstructions). */
+    system?: string;
+    /** Reply length cap. OneTag defaults to 2000 and caps at 10000. A model context callSettings.maxTokens wins. */
+    maxTokens?: number;
+    /** Sampling temperature. A model context callSettings.temperature wins. */
+    temperature?: number;
+    /**
+     * OneTag cannot call tools. By default the adapter fails when tools are
+     * registered in the model context, so a tool UI does not silently never fire.
+     * Set this to send text only and leave the tools out.
+     */
+    ignoreTools?: boolean;
+    /** Override the endpoint base URL. Defaults to https://onetagai.com/v1. */
+    baseUrl?: string;
+    /** Model name. OneTag accepts any value and always answers as "onetag". */
+    model?: string;
+    /** Custom fetch, for tests. */
+    fetch?: typeof globalThis.fetch;
+};
+/**
+ * A ChatModelAdapter for assistant-ui's LocalRuntime that streams from OneTag's
+ * OpenAI-compatible endpoint, straight from the browser. Text only.
+ *
+ *   const runtime = useLocalRuntime(createOneTagAdapter({ apiKey: "ot_..." }));
+ */
+export declare function createOneTagAdapter(options: OneTagAdapterOptions): ChatModelAdapter;

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Error thrown by the OneTag adapter. `code` is OneTag's error code
+ * (bad_key, domain_not_allowed, origin_required, quota_exceeded, rate_limited,
+ * too_large, paused, upstream, unsupported) or one of missing_key, network,
+ * http_<status>. assistant-ui keeps `code`, `message` and `statusCode` on the
+ * failed message's status, so the thread's error UI shows the readable text.
+ */
+export declare class OneTagError extends Error {
+    readonly name = "OneTagError";
+    readonly code: string;
+    readonly statusCode?: number;
+    constructor(code: string, message: string, statusCode?: number);
+}
+export declare function readableError(code: string, serverMessage: string | undefined, status?: number): OneTagError;
+export declare function errorFromResponse(res: Response): Promise<OneTagError>;
+export declare const missingKeyError: () => OneTagError;
+export declare const networkError: (cause: unknown) => OneTagError;

package/dist/index.cjs

@@ -0,0 +1,246 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ONETAG_BASE_URL: () => ONETAG_BASE_URL,
+  OneTagError: () => OneTagError,
+  createOneTagAdapter: () => createOneTagAdapter,
+  toOneTagMessages: () => toOneTagMessages,
+  useOneTagRuntime: () => useOneTagRuntime
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors.ts
+var SIGNUP = "https://onetagai.com/#get-key";
+var OneTagError = class extends Error {
+  constructor(code, message, statusCode) {
+    super(message);
+    __publicField(this, "name", "OneTagError");
+    __publicField(this, "code");
+    __publicField(this, "statusCode");
+    this.code = code;
+    if (statusCode !== void 0) this.statusCode = statusCode;
+  }
+};
+var READABLE = {
+  bad_key: `This OneTag key is not valid. Check the key from your signup email, or get one at ${SIGNUP}.`,
+  domain_not_allowed: "This OneTag key is not allowed on this domain. Add this site's domain to the key in your OneTag account.",
+  origin_required: "OneTag answers only from a browser page or browser extension. Run this adapter in the browser (LocalRuntime), not in server-side code, SSR or a route handler.",
+  quota_exceeded: "This OneTag key has used all of its tokens. The free tier is 1,000,000 tokens, one time, no monthly reset; upgrade the key or use another one.",
+  rate_limited: "Too many requests to OneTag right now. Wait a moment and try again.",
+  too_large: "The conversation is too long for one OneTag request. Start a new thread or send a shorter message.",
+  paused: "This OneTag key is paused. Check your OneTag account.",
+  upstream: "The model failed to answer. Try again.",
+  unsupported: "OneTag is text only: it does not take tools, images, audio or files."
+};
+function readableError(code, serverMessage, status) {
+  const base = READABLE[code] ?? `OneTag answered ${status ?? "with an error"}.`;
+  const detail = serverMessage && serverMessage.trim() ? ` (OneTag: ${serverMessage.trim()})` : "";
+  return new OneTagError(code, base + detail, status);
+}
+async function errorFromResponse(res) {
+  let code = `http_${res.status}`;
+  let message;
+  try {
+    const data = await res.json();
+    if (data?.error) {
+      if (typeof data.error.code === "string") code = data.error.code;
+      if (typeof data.error.message === "string") message = data.error.message;
+    }
+  } catch {
+  }
+  return readableError(code, message, res.status);
+}
+var missingKeyError = () => new OneTagError(
+  "missing_key",
+  `No OneTag key set. Get a free key by email at ${SIGNUP} (no card), then pass it as apiKey.`
+);
+var networkError = (cause) => {
+  const e = new OneTagError("network", "Could not reach OneTag. Check your connection and try again.");
+  e.cause = cause;
+  return e;
+};
+
+// src/messages.ts
+var SKIPPED = /* @__PURE__ */ new Set(["reasoning", "source"]);
+var unsupported = (what) => new OneTagError(
+  "unsupported",
+  `OneTag is text only, so this message cannot be sent: it contains ${what}. Remove it, or use a runtime with a multimodal or tool-calling model for this thread.`
+);
+function toOneTagMessages(messages, system) {
+  const systems = [];
+  if (system && system.trim()) systems.push(system);
+  const out = [];
+  for (const message of messages) {
+    const attachments = message.role === "user" ? message.attachments ?? [] : [];
+    if (attachments.length > 0) {
+      const names = attachments.map((a) => `"${a.name}"`).join(", ");
+      throw unsupported(`an attachment (${names})`);
+    }
+    const texts = [];
+    for (const part of message.content) {
+      if (part.type === "text") {
+        if (part.text) texts.push(part.text);
+      } else if (part.type === "tool-call") {
+        throw unsupported(`a tool call "${part.toolName ?? "unknown"}"`);
+      } else if (!SKIPPED.has(part.type)) {
+        throw unsupported(`a ${part.type} part`);
+      }
+    }
+    const content = texts.join("\n\n");
+    if (message.role === "system") {
+      if (content) systems.push(content);
+    } else if (content) {
+      out.push({ role: message.role, content });
+    }
+  }
+  return systems.length ? [{ role: "system", content: systems.join("\n\n") }, ...out] : out;
+}
+
+// src/sse.ts
+async function* sseData(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });
+      buffer = buffer.replace(/\r\n?/g, "\n");
+      let end;
+      while ((end = buffer.indexOf("\n\n")) !== -1) {
+        const event = buffer.slice(0, end);
+        buffer = buffer.slice(end + 2);
+        const data = event.split("\n").filter((line) => line.startsWith("data:")).map((line) => line.slice(5).replace(/^ /, "")).join("\n");
+        if (data) yield data;
+      }
+      if (done) {
+        const rest = buffer.trim();
+        if (rest.startsWith("data:")) yield rest.slice(5).trim();
+        return;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
+// src/adapter.ts
+var ONETAG_BASE_URL = "https://onetagai.com/v1";
+var isAbort = (e) => typeof e === "object" && e !== null && e.name === "AbortError";
+function createOneTagAdapter(options) {
+  return {
+    async *run({ messages, abortSignal, context }) {
+      if (!options.apiKey) throw missingKeyError();
+      const toolNames = Object.keys(context?.tools ?? {});
+      if (toolNames.length && !options.ignoreTools) {
+        throw new OneTagError(
+          "unsupported",
+          `OneTag is text only and cannot call tools, but tools are registered (${toolNames.join(", ")}). Remove them, or pass ignoreTools: true to send text without them.`
+        );
+      }
+      const system = [options.system, context?.system].filter((s) => s && s.trim()).join("\n\n");
+      const body = {
+        model: options.model ?? "onetag",
+        stream: true,
+        messages: toOneTagMessages(messages, system)
+      };
+      const maxTokens = context?.callSettings?.maxTokens ?? options.maxTokens;
+      if (maxTokens !== void 0) body.max_tokens = maxTokens;
+      const temperature = context?.callSettings?.temperature ?? options.temperature;
+      if (temperature !== void 0) body.temperature = temperature;
+      const doFetch = options.fetch ?? globalThis.fetch;
+      let res;
+      try {
+        res = await doFetch(`${(options.baseUrl ?? ONETAG_BASE_URL).replace(/\/+$/, "")}/chat/completions`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${options.apiKey}`
+          },
+          body: JSON.stringify(body),
+          signal: abortSignal
+        });
+      } catch (e) {
+        if (isAbort(e)) throw e;
+        throw networkError(e);
+      }
+      if (!res.ok) throw await errorFromResponse(res);
+      if (!res.body) throw new OneTagError("network", "OneTag sent an empty response. Try again.");
+      let text = "";
+      let finish = null;
+      try {
+        for await (const data of sseData(res.body)) {
+          if (data === "[DONE]") break;
+          let parsed;
+          try {
+            parsed = JSON.parse(data);
+          } catch {
+            continue;
+          }
+          if (parsed.error) {
+            throw readableError(parsed.error.code ?? "upstream", parsed.error.message);
+          }
+          const choice = parsed.choices?.[0];
+          if (!choice) continue;
+          const delta = choice.delta?.content;
+          if (delta) {
+            text += delta;
+            yield { content: [{ type: "text", text }] };
+          }
+          if (choice.finish_reason) finish = choice.finish_reason;
+        }
+      } catch (e) {
+        if (e instanceof OneTagError || isAbort(e)) throw e;
+        throw networkError(e);
+      }
+      const content = text ? [{ type: "text", text }] : [];
+      if (finish === "length") {
+        yield { content, status: { type: "incomplete", reason: "length" } };
+      } else {
+        yield { content, status: { type: "complete", reason: finish === "stop" ? "stop" : "unknown" } };
+      }
+    }
+  };
+}
+
+// src/runtime.ts
+var import_react = require("react");
+var import_react2 = require("@assistant-ui/react");
+function useOneTagRuntime({ runtime, ...options }) {
+  const { apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch } = options;
+  const adapter = (0, import_react.useMemo)(
+    () => createOneTagAdapter({ apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch }),
+    [apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch]
+  );
+  return (0, import_react2.useLocalRuntime)(adapter, runtime);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ONETAG_BASE_URL,
+  OneTagError,
+  createOneTagAdapter,
+  toOneTagMessages,
+  useOneTagRuntime
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/messages.ts","../src/sse.ts","../src/adapter.ts","../src/runtime.ts"],"sourcesContent":["export { createOneTagAdapter, ONETAG_BASE_URL, type OneTagAdapterOptions } from \"./adapter.js\";\nexport { OneTagError } from \"./errors.js\";\nexport { toOneTagMessages, type OneTagChatMessage } from \"./messages.js\";\nexport { useOneTagRuntime, type UseOneTagRuntimeOptions } from \"./runtime.js\";\n","const SIGNUP = \"https://onetagai.com/#get-key\";\n\n/**\n * Error thrown by the OneTag adapter. `code` is OneTag's error code\n * (bad_key, domain_not_allowed, origin_required, quota_exceeded, rate_limited,\n * too_large, paused, upstream, unsupported) or one of missing_key, network,\n * http_<status>. assistant-ui keeps `code`, `message` and `statusCode` on the\n * failed message's status, so the thread's error UI shows the readable text.\n */\nexport class OneTagError extends Error {\n  override readonly name = \"OneTagError\";\n  readonly code: string;\n  readonly statusCode?: number;\n\n  constructor(code: string, message: string, statusCode?: number) {\n    super(message);\n    this.code = code;\n    if (statusCode !== undefined) this.statusCode = statusCode;\n  }\n}\n\nconst READABLE: Record<string, string> = {\n  bad_key: `This OneTag key is not valid. Check the key from your signup email, or get one at ${SIGNUP}.`,\n  domain_not_allowed:\n    \"This OneTag key is not allowed on this domain. Add this site's domain to the key in your OneTag account.\",\n  origin_required:\n    \"OneTag answers only from a browser page or browser extension. Run this adapter in the browser (LocalRuntime), not in server-side code, SSR or a route handler.\",\n  quota_exceeded:\n    \"This OneTag key has used all of its tokens. The free tier is 1,000,000 tokens, one time, no monthly reset; upgrade the key or use another one.\",\n  rate_limited: \"Too many requests to OneTag right now. Wait a moment and try again.\",\n  too_large: \"The conversation is too long for one OneTag request. Start a new thread or send a shorter message.\",\n  paused: \"This OneTag key is paused. Check your OneTag account.\",\n  upstream: \"The model failed to answer. Try again.\",\n  unsupported: \"OneTag is text only: it does not take tools, images, audio or files.\",\n};\n\nexport function readableError(code: string, serverMessage: string | undefined, status?: number): OneTagError {\n  const base = READABLE[code] ?? `OneTag answered ${status ?? \"with an error\"}.`;\n  const detail = serverMessage && serverMessage.trim() ? ` (OneTag: ${serverMessage.trim()})` : \"\";\n  return new OneTagError(code, base + detail, status);\n}\n\nexport async function errorFromResponse(res: Response): Promise<OneTagError> {\n  let code = `http_${res.status}`;\n  let message: string | undefined;\n  try {\n    const data = (await res.json()) as { error?: { code?: unknown; message?: unknown } };\n    if (data?.error) {\n      if (typeof data.error.code === \"string\") code = data.error.code;\n      if (typeof data.error.message === \"string\") message = data.error.message;\n    }\n  } catch {\n    // not JSON; keep the status code\n  }\n  return readableError(code, message, res.status);\n}\n\nexport const missingKeyError = () =>\n  new OneTagError(\n    \"missing_key\",\n    `No OneTag key set. Get a free key by email at ${SIGNUP} (no card), then pass it as apiKey.`,\n  );\n\nexport const networkError = (cause: unknown) => {\n  const e = new OneTagError(\"network\", \"Could not reach OneTag. Check your connection and try again.\");\n  (e as { cause?: unknown }).cause = cause;\n  return e;\n};\n","import type { ThreadMessage } from \"@assistant-ui/react\";\nimport { OneTagError } from \"./errors.js\";\n\nexport type OneTagChatMessage = {\n  role: \"system\" | \"user\" | \"assistant\";\n  content: string;\n};\n\n/** Parts that are display metadata, not model input. They are left out of the request. */\nconst SKIPPED = new Set([\"reasoning\", \"source\"]);\n\nconst unsupported = (what: string) =>\n  new OneTagError(\n    \"unsupported\",\n    `OneTag is text only, so this message cannot be sent: it contains ${what}. Remove it, or use a runtime with a multimodal or tool-calling model for this thread.`,\n  );\n\n/**\n * Convert assistant-ui thread messages to OpenAI chat messages with plain text\n * content. Throws a OneTagError (code \"unsupported\") on attachments, images,\n * files, audio, data parts and tool calls instead of dropping them silently.\n */\nexport function toOneTagMessages(\n  messages: readonly ThreadMessage[],\n  system?: string,\n): OneTagChatMessage[] {\n  const systems: string[] = [];\n  if (system && system.trim()) systems.push(system);\n  const out: OneTagChatMessage[] = [];\n\n  for (const message of messages) {\n    const attachments = message.role === \"user\" ? message.attachments ?? [] : [];\n    if (attachments.length > 0) {\n      const names = attachments.map((a) => `\"${a.name}\"`).join(\", \");\n      throw unsupported(`an attachment (${names})`);\n    }\n\n    const texts: string[] = [];\n    for (const part of message.content as readonly { type: string; text?: string; toolName?: string }[]) {\n      if (part.type === \"text\") {\n        if (part.text) texts.push(part.text);\n      } else if (part.type === \"tool-call\") {\n        throw unsupported(`a tool call \"${part.toolName ?? \"unknown\"}\"`);\n      } else if (!SKIPPED.has(part.type)) {\n        throw unsupported(`a ${part.type} part`);\n      }\n    }\n    const content = texts.join(\"\\n\\n\");\n\n    if (message.role === \"system\") {\n      if (content) systems.push(content);\n    } else if (content) {\n      out.push({ role: message.role, content });\n    }\n  }\n\n  return systems.length ? [{ role: \"system\", content: systems.join(\"\\n\\n\") }, ...out] : out;\n}\n","/** Yield the data payload of each server-sent event in a fetch body. */\nexport async function* sseData(body: ReadableStream<Uint8Array>): AsyncGenerator<string> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });\n      buffer = buffer.replace(/\\r\\n?/g, \"\\n\");\n      let end: number;\n      while ((end = buffer.indexOf(\"\\n\\n\")) !== -1) {\n        const event = buffer.slice(0, end);\n        buffer = buffer.slice(end + 2);\n        const data = event\n          .split(\"\\n\")\n          .filter((line) => line.startsWith(\"data:\"))\n          .map((line) => line.slice(5).replace(/^ /, \"\"))\n          .join(\"\\n\");\n        if (data) yield data;\n      }\n      if (done) {\n        const rest = buffer.trim();\n        if (rest.startsWith(\"data:\")) yield rest.slice(5).trim();\n        return;\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n","import type { ChatModelAdapter, ChatModelRunResult } from \"@assistant-ui/react\";\nimport { errorFromResponse, missingKeyError, networkError, OneTagError, readableError } from \"./errors.js\";\nimport { toOneTagMessages } from \"./messages.js\";\nimport { sseData } from \"./sse.js\";\n\nexport const ONETAG_BASE_URL = \"https://onetagai.com/v1\";\n\nexport type OneTagAdapterOptions = {\n  /** Your OneTag key. It is public by design: it can sit in the page's HTML or JS bundle. */\n  apiKey: string;\n  /** System prompt, sent before any system prompt from the model context (useAssistantInstructions). */\n  system?: string;\n  /** Reply length cap. OneTag defaults to 2000 and caps at 10000. A model context callSettings.maxTokens wins. */\n  maxTokens?: number;\n  /** Sampling temperature. A model context callSettings.temperature wins. */\n  temperature?: number;\n  /**\n   * OneTag cannot call tools. By default the adapter fails when tools are\n   * registered in the model context, so a tool UI does not silently never fire.\n   * Set this to send text only and leave the tools out.\n   */\n  ignoreTools?: boolean;\n  /** Override the endpoint base URL. Defaults to https://onetagai.com/v1. */\n  baseUrl?: string;\n  /** Model name. OneTag accepts any value and always answers as \"onetag\". */\n  model?: string;\n  /** Custom fetch, for tests. */\n  fetch?: typeof globalThis.fetch;\n};\n\ntype Chunk = {\n  error?: { code?: string; message?: string };\n  choices?: { delta?: { content?: string | null }; finish_reason?: string | null }[];\n};\n\nconst isAbort = (e: unknown) =>\n  typeof e === \"object\" && e !== null && (e as { name?: string }).name === \"AbortError\";\n\n/**\n * A ChatModelAdapter for assistant-ui's LocalRuntime that streams from OneTag's\n * OpenAI-compatible endpoint, straight from the browser. Text only.\n *\n *   const runtime = useLocalRuntime(createOneTagAdapter({ apiKey: \"ot_...\" }));\n */\nexport function createOneTagAdapter(options: OneTagAdapterOptions): ChatModelAdapter {\n  return {\n    async *run({ messages, abortSignal, context }) {\n      if (!options.apiKey) throw missingKeyError();\n\n      const toolNames = Object.keys(context?.tools ?? {});\n      if (toolNames.length && !options.ignoreTools) {\n        throw new OneTagError(\n          \"unsupported\",\n          `OneTag is text only and cannot call tools, but tools are registered (${toolNames.join(\", \")}). Remove them, or pass ignoreTools: true to send text without them.`,\n        );\n      }\n\n      const system = [options.system, context?.system].filter((s) => s && s.trim()).join(\"\\n\\n\");\n      const body: Record<string, unknown> = {\n        model: options.model ?? \"onetag\",\n        stream: true,\n        messages: toOneTagMessages(messages, system),\n      };\n      const maxTokens = context?.callSettings?.maxTokens ?? options.maxTokens;\n      if (maxTokens !== undefined) body.max_tokens = maxTokens;\n      const temperature = context?.callSettings?.temperature ?? options.temperature;\n      if (temperature !== undefined) body.temperature = temperature;\n\n      const doFetch = options.fetch ?? globalThis.fetch;\n      let res: Response;\n      try {\n        res = await doFetch(`${(options.baseUrl ?? ONETAG_BASE_URL).replace(/\\/+$/, \"\")}/chat/completions`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            Authorization: `Bearer ${options.apiKey}`,\n          },\n          body: JSON.stringify(body),\n          signal: abortSignal,\n        });\n      } catch (e) {\n        if (isAbort(e)) throw e;\n        throw networkError(e);\n      }\n      if (!res.ok) throw await errorFromResponse(res);\n      if (!res.body) throw new OneTagError(\"network\", \"OneTag sent an empty response. Try again.\");\n\n      let text = \"\";\n      let finish: string | null = null;\n      try {\n        for await (const data of sseData(res.body)) {\n          if (data === \"[DONE]\") break;\n          let parsed: Chunk;\n          try {\n            parsed = JSON.parse(data) as Chunk;\n          } catch {\n            continue;\n          }\n          if (parsed.error) {\n            throw readableError(parsed.error.code ?? \"upstream\", parsed.error.message);\n          }\n          const choice = parsed.choices?.[0];\n          if (!choice) continue;\n          const delta = choice.delta?.content;\n          if (delta) {\n            text += delta;\n            yield { content: [{ type: \"text\", text }] };\n          }\n          if (choice.finish_reason) finish = choice.finish_reason;\n        }\n      } catch (e) {\n        if (e instanceof OneTagError || isAbort(e)) throw e;\n        throw networkError(e);\n      }\n\n      const content: ChatModelRunResult[\"content\"] = text ? [{ type: \"text\", text }] : [];\n      if (finish === \"length\") {\n        yield { content, status: { type: \"incomplete\", reason: \"length\" } };\n      } else {\n        yield { content, status: { type: \"complete\", reason: finish === \"stop\" ? \"stop\" : \"unknown\" } };\n      }\n    },\n  };\n}\n","import { useMemo } from \"react\";\nimport { useLocalRuntime, type AssistantRuntime } from \"@assistant-ui/react\";\nimport { createOneTagAdapter, type OneTagAdapterOptions } from \"./adapter.js\";\n\nexport type UseOneTagRuntimeOptions = OneTagAdapterOptions & {\n  /** Passed through to useLocalRuntime (adapters, initialMessages, cloud, ...). */\n  runtime?: Parameters<typeof useLocalRuntime>[1];\n};\n\n/**\n * LocalRuntime answered by OneTag, from the browser. No API route.\n *\n *   const runtime = useOneTagRuntime({ apiKey: \"ot_...\" });\n *   <AssistantRuntimeProvider runtime={runtime}><Thread /></AssistantRuntimeProvider>\n */\nexport function useOneTagRuntime({ runtime, ...options }: UseOneTagRuntimeOptions): AssistantRuntime {\n  const { apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch } = options;\n  const adapter = useMemo(\n    () => createOneTagAdapter({ apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch }),\n    [apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch],\n  );\n  return useLocalRuntime(adapter, runtime);\n}\n"],"mappings":"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","names":["import_react"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createOneTagAdapter, ONETAG_BASE_URL, type OneTagAdapterOptions } from "./adapter.js";
+export { OneTagError } from "./errors.js";
+export { toOneTagMessages, type OneTagChatMessage } from "./messages.js";
+export { useOneTagRuntime, type UseOneTagRuntimeOptions } from "./runtime.js";

package/dist/index.js

@@ -0,0 +1,217 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/errors.ts
+var SIGNUP = "https://onetagai.com/#get-key";
+var OneTagError = class extends Error {
+  constructor(code, message, statusCode) {
+    super(message);
+    __publicField(this, "name", "OneTagError");
+    __publicField(this, "code");
+    __publicField(this, "statusCode");
+    this.code = code;
+    if (statusCode !== void 0) this.statusCode = statusCode;
+  }
+};
+var READABLE = {
+  bad_key: `This OneTag key is not valid. Check the key from your signup email, or get one at ${SIGNUP}.`,
+  domain_not_allowed: "This OneTag key is not allowed on this domain. Add this site's domain to the key in your OneTag account.",
+  origin_required: "OneTag answers only from a browser page or browser extension. Run this adapter in the browser (LocalRuntime), not in server-side code, SSR or a route handler.",
+  quota_exceeded: "This OneTag key has used all of its tokens. The free tier is 1,000,000 tokens, one time, no monthly reset; upgrade the key or use another one.",
+  rate_limited: "Too many requests to OneTag right now. Wait a moment and try again.",
+  too_large: "The conversation is too long for one OneTag request. Start a new thread or send a shorter message.",
+  paused: "This OneTag key is paused. Check your OneTag account.",
+  upstream: "The model failed to answer. Try again.",
+  unsupported: "OneTag is text only: it does not take tools, images, audio or files."
+};
+function readableError(code, serverMessage, status) {
+  const base = READABLE[code] ?? `OneTag answered ${status ?? "with an error"}.`;
+  const detail = serverMessage && serverMessage.trim() ? ` (OneTag: ${serverMessage.trim()})` : "";
+  return new OneTagError(code, base + detail, status);
+}
+async function errorFromResponse(res) {
+  let code = `http_${res.status}`;
+  let message;
+  try {
+    const data = await res.json();
+    if (data?.error) {
+      if (typeof data.error.code === "string") code = data.error.code;
+      if (typeof data.error.message === "string") message = data.error.message;
+    }
+  } catch {
+  }
+  return readableError(code, message, res.status);
+}
+var missingKeyError = () => new OneTagError(
+  "missing_key",
+  `No OneTag key set. Get a free key by email at ${SIGNUP} (no card), then pass it as apiKey.`
+);
+var networkError = (cause) => {
+  const e = new OneTagError("network", "Could not reach OneTag. Check your connection and try again.");
+  e.cause = cause;
+  return e;
+};
+
+// src/messages.ts
+var SKIPPED = /* @__PURE__ */ new Set(["reasoning", "source"]);
+var unsupported = (what) => new OneTagError(
+  "unsupported",
+  `OneTag is text only, so this message cannot be sent: it contains ${what}. Remove it, or use a runtime with a multimodal or tool-calling model for this thread.`
+);
+function toOneTagMessages(messages, system) {
+  const systems = [];
+  if (system && system.trim()) systems.push(system);
+  const out = [];
+  for (const message of messages) {
+    const attachments = message.role === "user" ? message.attachments ?? [] : [];
+    if (attachments.length > 0) {
+      const names = attachments.map((a) => `"${a.name}"`).join(", ");
+      throw unsupported(`an attachment (${names})`);
+    }
+    const texts = [];
+    for (const part of message.content) {
+      if (part.type === "text") {
+        if (part.text) texts.push(part.text);
+      } else if (part.type === "tool-call") {
+        throw unsupported(`a tool call "${part.toolName ?? "unknown"}"`);
+      } else if (!SKIPPED.has(part.type)) {
+        throw unsupported(`a ${part.type} part`);
+      }
+    }
+    const content = texts.join("\n\n");
+    if (message.role === "system") {
+      if (content) systems.push(content);
+    } else if (content) {
+      out.push({ role: message.role, content });
+    }
+  }
+  return systems.length ? [{ role: "system", content: systems.join("\n\n") }, ...out] : out;
+}
+
+// src/sse.ts
+async function* sseData(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  try {
+    for (; ; ) {
+      const { done, value } = await reader.read();
+      buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });
+      buffer = buffer.replace(/\r\n?/g, "\n");
+      let end;
+      while ((end = buffer.indexOf("\n\n")) !== -1) {
+        const event = buffer.slice(0, end);
+        buffer = buffer.slice(end + 2);
+        const data = event.split("\n").filter((line) => line.startsWith("data:")).map((line) => line.slice(5).replace(/^ /, "")).join("\n");
+        if (data) yield data;
+      }
+      if (done) {
+        const rest = buffer.trim();
+        if (rest.startsWith("data:")) yield rest.slice(5).trim();
+        return;
+      }
+    }
+  } finally {
+    reader.releaseLock();
+  }
+}
+
+// src/adapter.ts
+var ONETAG_BASE_URL = "https://onetagai.com/v1";
+var isAbort = (e) => typeof e === "object" && e !== null && e.name === "AbortError";
+function createOneTagAdapter(options) {
+  return {
+    async *run({ messages, abortSignal, context }) {
+      if (!options.apiKey) throw missingKeyError();
+      const toolNames = Object.keys(context?.tools ?? {});
+      if (toolNames.length && !options.ignoreTools) {
+        throw new OneTagError(
+          "unsupported",
+          `OneTag is text only and cannot call tools, but tools are registered (${toolNames.join(", ")}). Remove them, or pass ignoreTools: true to send text without them.`
+        );
+      }
+      const system = [options.system, context?.system].filter((s) => s && s.trim()).join("\n\n");
+      const body = {
+        model: options.model ?? "onetag",
+        stream: true,
+        messages: toOneTagMessages(messages, system)
+      };
+      const maxTokens = context?.callSettings?.maxTokens ?? options.maxTokens;
+      if (maxTokens !== void 0) body.max_tokens = maxTokens;
+      const temperature = context?.callSettings?.temperature ?? options.temperature;
+      if (temperature !== void 0) body.temperature = temperature;
+      const doFetch = options.fetch ?? globalThis.fetch;
+      let res;
+      try {
+        res = await doFetch(`${(options.baseUrl ?? ONETAG_BASE_URL).replace(/\/+$/, "")}/chat/completions`, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${options.apiKey}`
+          },
+          body: JSON.stringify(body),
+          signal: abortSignal
+        });
+      } catch (e) {
+        if (isAbort(e)) throw e;
+        throw networkError(e);
+      }
+      if (!res.ok) throw await errorFromResponse(res);
+      if (!res.body) throw new OneTagError("network", "OneTag sent an empty response. Try again.");
+      let text = "";
+      let finish = null;
+      try {
+        for await (const data of sseData(res.body)) {
+          if (data === "[DONE]") break;
+          let parsed;
+          try {
+            parsed = JSON.parse(data);
+          } catch {
+            continue;
+          }
+          if (parsed.error) {
+            throw readableError(parsed.error.code ?? "upstream", parsed.error.message);
+          }
+          const choice = parsed.choices?.[0];
+          if (!choice) continue;
+          const delta = choice.delta?.content;
+          if (delta) {
+            text += delta;
+            yield { content: [{ type: "text", text }] };
+          }
+          if (choice.finish_reason) finish = choice.finish_reason;
+        }
+      } catch (e) {
+        if (e instanceof OneTagError || isAbort(e)) throw e;
+        throw networkError(e);
+      }
+      const content = text ? [{ type: "text", text }] : [];
+      if (finish === "length") {
+        yield { content, status: { type: "incomplete", reason: "length" } };
+      } else {
+        yield { content, status: { type: "complete", reason: finish === "stop" ? "stop" : "unknown" } };
+      }
+    }
+  };
+}
+
+// src/runtime.ts
+import { useMemo } from "react";
+import { useLocalRuntime } from "@assistant-ui/react";
+function useOneTagRuntime({ runtime, ...options }) {
+  const { apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch } = options;
+  const adapter = useMemo(
+    () => createOneTagAdapter({ apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch }),
+    [apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch]
+  );
+  return useLocalRuntime(adapter, runtime);
+}
+export {
+  ONETAG_BASE_URL,
+  OneTagError,
+  createOneTagAdapter,
+  toOneTagMessages,
+  useOneTagRuntime
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/messages.ts","../src/sse.ts","../src/adapter.ts","../src/runtime.ts"],"sourcesContent":["const SIGNUP = \"https://onetagai.com/#get-key\";\n\n/**\n * Error thrown by the OneTag adapter. `code` is OneTag's error code\n * (bad_key, domain_not_allowed, origin_required, quota_exceeded, rate_limited,\n * too_large, paused, upstream, unsupported) or one of missing_key, network,\n * http_<status>. assistant-ui keeps `code`, `message` and `statusCode` on the\n * failed message's status, so the thread's error UI shows the readable text.\n */\nexport class OneTagError extends Error {\n  override readonly name = \"OneTagError\";\n  readonly code: string;\n  readonly statusCode?: number;\n\n  constructor(code: string, message: string, statusCode?: number) {\n    super(message);\n    this.code = code;\n    if (statusCode !== undefined) this.statusCode = statusCode;\n  }\n}\n\nconst READABLE: Record<string, string> = {\n  bad_key: `This OneTag key is not valid. Check the key from your signup email, or get one at ${SIGNUP}.`,\n  domain_not_allowed:\n    \"This OneTag key is not allowed on this domain. Add this site's domain to the key in your OneTag account.\",\n  origin_required:\n    \"OneTag answers only from a browser page or browser extension. Run this adapter in the browser (LocalRuntime), not in server-side code, SSR or a route handler.\",\n  quota_exceeded:\n    \"This OneTag key has used all of its tokens. The free tier is 1,000,000 tokens, one time, no monthly reset; upgrade the key or use another one.\",\n  rate_limited: \"Too many requests to OneTag right now. Wait a moment and try again.\",\n  too_large: \"The conversation is too long for one OneTag request. Start a new thread or send a shorter message.\",\n  paused: \"This OneTag key is paused. Check your OneTag account.\",\n  upstream: \"The model failed to answer. Try again.\",\n  unsupported: \"OneTag is text only: it does not take tools, images, audio or files.\",\n};\n\nexport function readableError(code: string, serverMessage: string | undefined, status?: number): OneTagError {\n  const base = READABLE[code] ?? `OneTag answered ${status ?? \"with an error\"}.`;\n  const detail = serverMessage && serverMessage.trim() ? ` (OneTag: ${serverMessage.trim()})` : \"\";\n  return new OneTagError(code, base + detail, status);\n}\n\nexport async function errorFromResponse(res: Response): Promise<OneTagError> {\n  let code = `http_${res.status}`;\n  let message: string | undefined;\n  try {\n    const data = (await res.json()) as { error?: { code?: unknown; message?: unknown } };\n    if (data?.error) {\n      if (typeof data.error.code === \"string\") code = data.error.code;\n      if (typeof data.error.message === \"string\") message = data.error.message;\n    }\n  } catch {\n    // not JSON; keep the status code\n  }\n  return readableError(code, message, res.status);\n}\n\nexport const missingKeyError = () =>\n  new OneTagError(\n    \"missing_key\",\n    `No OneTag key set. Get a free key by email at ${SIGNUP} (no card), then pass it as apiKey.`,\n  );\n\nexport const networkError = (cause: unknown) => {\n  const e = new OneTagError(\"network\", \"Could not reach OneTag. Check your connection and try again.\");\n  (e as { cause?: unknown }).cause = cause;\n  return e;\n};\n","import type { ThreadMessage } from \"@assistant-ui/react\";\nimport { OneTagError } from \"./errors.js\";\n\nexport type OneTagChatMessage = {\n  role: \"system\" | \"user\" | \"assistant\";\n  content: string;\n};\n\n/** Parts that are display metadata, not model input. They are left out of the request. */\nconst SKIPPED = new Set([\"reasoning\", \"source\"]);\n\nconst unsupported = (what: string) =>\n  new OneTagError(\n    \"unsupported\",\n    `OneTag is text only, so this message cannot be sent: it contains ${what}. Remove it, or use a runtime with a multimodal or tool-calling model for this thread.`,\n  );\n\n/**\n * Convert assistant-ui thread messages to OpenAI chat messages with plain text\n * content. Throws a OneTagError (code \"unsupported\") on attachments, images,\n * files, audio, data parts and tool calls instead of dropping them silently.\n */\nexport function toOneTagMessages(\n  messages: readonly ThreadMessage[],\n  system?: string,\n): OneTagChatMessage[] {\n  const systems: string[] = [];\n  if (system && system.trim()) systems.push(system);\n  const out: OneTagChatMessage[] = [];\n\n  for (const message of messages) {\n    const attachments = message.role === \"user\" ? message.attachments ?? [] : [];\n    if (attachments.length > 0) {\n      const names = attachments.map((a) => `\"${a.name}\"`).join(\", \");\n      throw unsupported(`an attachment (${names})`);\n    }\n\n    const texts: string[] = [];\n    for (const part of message.content as readonly { type: string; text?: string; toolName?: string }[]) {\n      if (part.type === \"text\") {\n        if (part.text) texts.push(part.text);\n      } else if (part.type === \"tool-call\") {\n        throw unsupported(`a tool call \"${part.toolName ?? \"unknown\"}\"`);\n      } else if (!SKIPPED.has(part.type)) {\n        throw unsupported(`a ${part.type} part`);\n      }\n    }\n    const content = texts.join(\"\\n\\n\");\n\n    if (message.role === \"system\") {\n      if (content) systems.push(content);\n    } else if (content) {\n      out.push({ role: message.role, content });\n    }\n  }\n\n  return systems.length ? [{ role: \"system\", content: systems.join(\"\\n\\n\") }, ...out] : out;\n}\n","/** Yield the data payload of each server-sent event in a fetch body. */\nexport async function* sseData(body: ReadableStream<Uint8Array>): AsyncGenerator<string> {\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = \"\";\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      buffer += done ? decoder.decode() : decoder.decode(value, { stream: true });\n      buffer = buffer.replace(/\\r\\n?/g, \"\\n\");\n      let end: number;\n      while ((end = buffer.indexOf(\"\\n\\n\")) !== -1) {\n        const event = buffer.slice(0, end);\n        buffer = buffer.slice(end + 2);\n        const data = event\n          .split(\"\\n\")\n          .filter((line) => line.startsWith(\"data:\"))\n          .map((line) => line.slice(5).replace(/^ /, \"\"))\n          .join(\"\\n\");\n        if (data) yield data;\n      }\n      if (done) {\n        const rest = buffer.trim();\n        if (rest.startsWith(\"data:\")) yield rest.slice(5).trim();\n        return;\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n","import type { ChatModelAdapter, ChatModelRunResult } from \"@assistant-ui/react\";\nimport { errorFromResponse, missingKeyError, networkError, OneTagError, readableError } from \"./errors.js\";\nimport { toOneTagMessages } from \"./messages.js\";\nimport { sseData } from \"./sse.js\";\n\nexport const ONETAG_BASE_URL = \"https://onetagai.com/v1\";\n\nexport type OneTagAdapterOptions = {\n  /** Your OneTag key. It is public by design: it can sit in the page's HTML or JS bundle. */\n  apiKey: string;\n  /** System prompt, sent before any system prompt from the model context (useAssistantInstructions). */\n  system?: string;\n  /** Reply length cap. OneTag defaults to 2000 and caps at 10000. A model context callSettings.maxTokens wins. */\n  maxTokens?: number;\n  /** Sampling temperature. A model context callSettings.temperature wins. */\n  temperature?: number;\n  /**\n   * OneTag cannot call tools. By default the adapter fails when tools are\n   * registered in the model context, so a tool UI does not silently never fire.\n   * Set this to send text only and leave the tools out.\n   */\n  ignoreTools?: boolean;\n  /** Override the endpoint base URL. Defaults to https://onetagai.com/v1. */\n  baseUrl?: string;\n  /** Model name. OneTag accepts any value and always answers as \"onetag\". */\n  model?: string;\n  /** Custom fetch, for tests. */\n  fetch?: typeof globalThis.fetch;\n};\n\ntype Chunk = {\n  error?: { code?: string; message?: string };\n  choices?: { delta?: { content?: string | null }; finish_reason?: string | null }[];\n};\n\nconst isAbort = (e: unknown) =>\n  typeof e === \"object\" && e !== null && (e as { name?: string }).name === \"AbortError\";\n\n/**\n * A ChatModelAdapter for assistant-ui's LocalRuntime that streams from OneTag's\n * OpenAI-compatible endpoint, straight from the browser. Text only.\n *\n *   const runtime = useLocalRuntime(createOneTagAdapter({ apiKey: \"ot_...\" }));\n */\nexport function createOneTagAdapter(options: OneTagAdapterOptions): ChatModelAdapter {\n  return {\n    async *run({ messages, abortSignal, context }) {\n      if (!options.apiKey) throw missingKeyError();\n\n      const toolNames = Object.keys(context?.tools ?? {});\n      if (toolNames.length && !options.ignoreTools) {\n        throw new OneTagError(\n          \"unsupported\",\n          `OneTag is text only and cannot call tools, but tools are registered (${toolNames.join(\", \")}). Remove them, or pass ignoreTools: true to send text without them.`,\n        );\n      }\n\n      const system = [options.system, context?.system].filter((s) => s && s.trim()).join(\"\\n\\n\");\n      const body: Record<string, unknown> = {\n        model: options.model ?? \"onetag\",\n        stream: true,\n        messages: toOneTagMessages(messages, system),\n      };\n      const maxTokens = context?.callSettings?.maxTokens ?? options.maxTokens;\n      if (maxTokens !== undefined) body.max_tokens = maxTokens;\n      const temperature = context?.callSettings?.temperature ?? options.temperature;\n      if (temperature !== undefined) body.temperature = temperature;\n\n      const doFetch = options.fetch ?? globalThis.fetch;\n      let res: Response;\n      try {\n        res = await doFetch(`${(options.baseUrl ?? ONETAG_BASE_URL).replace(/\\/+$/, \"\")}/chat/completions`, {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n            Authorization: `Bearer ${options.apiKey}`,\n          },\n          body: JSON.stringify(body),\n          signal: abortSignal,\n        });\n      } catch (e) {\n        if (isAbort(e)) throw e;\n        throw networkError(e);\n      }\n      if (!res.ok) throw await errorFromResponse(res);\n      if (!res.body) throw new OneTagError(\"network\", \"OneTag sent an empty response. Try again.\");\n\n      let text = \"\";\n      let finish: string | null = null;\n      try {\n        for await (const data of sseData(res.body)) {\n          if (data === \"[DONE]\") break;\n          let parsed: Chunk;\n          try {\n            parsed = JSON.parse(data) as Chunk;\n          } catch {\n            continue;\n          }\n          if (parsed.error) {\n            throw readableError(parsed.error.code ?? \"upstream\", parsed.error.message);\n          }\n          const choice = parsed.choices?.[0];\n          if (!choice) continue;\n          const delta = choice.delta?.content;\n          if (delta) {\n            text += delta;\n            yield { content: [{ type: \"text\", text }] };\n          }\n          if (choice.finish_reason) finish = choice.finish_reason;\n        }\n      } catch (e) {\n        if (e instanceof OneTagError || isAbort(e)) throw e;\n        throw networkError(e);\n      }\n\n      const content: ChatModelRunResult[\"content\"] = text ? [{ type: \"text\", text }] : [];\n      if (finish === \"length\") {\n        yield { content, status: { type: \"incomplete\", reason: \"length\" } };\n      } else {\n        yield { content, status: { type: \"complete\", reason: finish === \"stop\" ? \"stop\" : \"unknown\" } };\n      }\n    },\n  };\n}\n","import { useMemo } from \"react\";\nimport { useLocalRuntime, type AssistantRuntime } from \"@assistant-ui/react\";\nimport { createOneTagAdapter, type OneTagAdapterOptions } from \"./adapter.js\";\n\nexport type UseOneTagRuntimeOptions = OneTagAdapterOptions & {\n  /** Passed through to useLocalRuntime (adapters, initialMessages, cloud, ...). */\n  runtime?: Parameters<typeof useLocalRuntime>[1];\n};\n\n/**\n * LocalRuntime answered by OneTag, from the browser. No API route.\n *\n *   const runtime = useOneTagRuntime({ apiKey: \"ot_...\" });\n *   <AssistantRuntimeProvider runtime={runtime}><Thread /></AssistantRuntimeProvider>\n */\nexport function useOneTagRuntime({ runtime, ...options }: UseOneTagRuntimeOptions): AssistantRuntime {\n  const { apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch } = options;\n  const adapter = useMemo(\n    () => createOneTagAdapter({ apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch }),\n    [apiKey, system, maxTokens, temperature, ignoreTools, baseUrl, model, fetch],\n  );\n  return useLocalRuntime(adapter, runtime);\n}\n"],"mappings":"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","names":[]}

package/dist/messages.d.ts

@@ -0,0 +1,11 @@
+import type { ThreadMessage } from "@assistant-ui/react";
+export type OneTagChatMessage = {
+    role: "system" | "user" | "assistant";
+    content: string;
+};
+/**
+ * Convert assistant-ui thread messages to OpenAI chat messages with plain text
+ * content. Throws a OneTagError (code "unsupported") on attachments, images,
+ * files, audio, data parts and tool calls instead of dropping them silently.
+ */
+export declare function toOneTagMessages(messages: readonly ThreadMessage[], system?: string): OneTagChatMessage[];

package/dist/runtime.d.ts

@@ -0,0 +1,13 @@
+import { useLocalRuntime, type AssistantRuntime } from "@assistant-ui/react";
+import { type OneTagAdapterOptions } from "./adapter.js";
+export type UseOneTagRuntimeOptions = OneTagAdapterOptions & {
+    /** Passed through to useLocalRuntime (adapters, initialMessages, cloud, ...). */
+    runtime?: Parameters<typeof useLocalRuntime>[1];
+};
+/**
+ * LocalRuntime answered by OneTag, from the browser. No API route.
+ *
+ *   const runtime = useOneTagRuntime({ apiKey: "ot_..." });
+ *   <AssistantRuntimeProvider runtime={runtime}><Thread /></AssistantRuntimeProvider>
+ */
+export declare function useOneTagRuntime({ runtime, ...options }: UseOneTagRuntimeOptions): AssistantRuntime;

package/dist/sse.d.ts

@@ -0,0 +1,2 @@
+/** Yield the data payload of each server-sent event in a fetch body. */
+export declare function sseData(body: ReadableStream<Uint8Array>): AsyncGenerator<string>;

package/package.json

@@ -1,6 +1,74 @@
 {
   "name": "assistant-ui-onetag",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "OneTag AI chat model adapter for assistant-ui's LocalRuntime: a public, capped key for static pages and browser code, no API route or proxy.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:browser": "node test/browser/run.mjs",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "assistant-ui",
+    "runtime",
+    "chat-model-adapter",
+    "local-runtime",
+    "onetag",
+    "llm",
+    "chat",
+    "browser",
+    "static-site",
+    "public-api-key"
+  ],
+  "homepage": "https://onetagai.com/docs#openai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fengyiqicoder/assistant-ui-onetag.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fengyiqicoder/assistant-ui-onetag/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "@assistant-ui/react": ">=0.10.0",
+    "react": "^18 || ^19"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@assistant-ui/react": "^0.15.36",
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "jsdom": "^29.1.1",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "tsup": "^9.0.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
+  }
+}