@intelligo-dev/chat 1.0.0-beta.5

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "{}"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Intelligo
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,75 @@
+# @intelligo-dev/chat
+
+The AI-SDK-native chat transport: a Route Handler as a function.
+
+Part of [Intelligo](https://github.com/intelligo-mn/framework), an application
+framework and operational platform for vertical AI SaaS products. This package
+is published from that repository and is not meant to be used on its own.
+
+## Install
+
+```bash
+pnpm add @intelligo-dev/chat ai
+```
+
+`ai` (the Vercel AI SDK) is a peer: the transport takes its tools, its models
+and its stop conditions natively, and never wraps them (ADR-0003).
+
+## Use
+
+```ts
+// app/api/chat/route.ts
+import { createChatHandler } from "@intelligo-dev/chat";
+import { chatServerConfig } from "@/lib/chat-server-config";
+
+export const { POST, DELETE } = createChatHandler(chatServerConfig);
+```
+
+```ts
+// lib/chat-server-config.ts
+import type { ChatServerConfig } from "@intelligo-dev/chat";
+import { composeIntelligo, executions } from "@/lib/intelligo";
+
+export const chatServerConfig: ChatServerConfig = {
+  executions,
+  onRequest: composeIntelligo,
+  model: { defaultId: "google/gemini-2.5-flash", resolve: getChatModel },
+  agent: { id: "assistant", systemPrompt: "You are a helpful assistant." },
+};
+```
+
+That is a working chat. Every turn goes through auth, the plan's rate limit,
+the feature gate, conversation persistence (`@intelligo-dev/core/conversations`)
+and the execution boundary (`executions.begin()` decides entitlement against
+the model that is about to run, and settles exactly once).
+
+## The seams
+
+Each optional field is something a real product needed and used to fork the
+route to get:
+
+| Field                         | What it decides                                                          |
+| ----------------------------- | ------------------------------------------------------------------------ |
+| `resolveAgent(turn)`          | Which agent runs — from the body, the row, a table; prompt, tools, model |
+| `prepareMessages(turn, msgs)` | What the model is shown — windowing, summaries, injected context         |
+| `attachments`                 | Which file parts are accepted                                            |
+| `reasoning`                   | Whether reasoning parts stream to the client                             |
+| `deriveTitle`                 | The conversation's title, sync or model-written                          |
+| `persist`                     | Where the turn's messages go                                             |
+| `onTurn`                      | Telemetry: start, complete, fail, refuse                                 |
+| `messages(request)`           | Refusal copy in the caller's locale                                      |
+| `authenticate`, `rateLimit`   | The defaults are the framework's; a worker or a test can replace them    |
+
+None carry product vocabulary; all close over the caller's tenancy, so the
+model is never told which workspace it is in.
+
+## Subpaths
+
+- `@intelligo-dev/chat/client` — error codes, the quota-state shape and
+  `parseChatError`, for a client bundle. Imports nothing.
+- `@intelligo-dev/chat/testing` — `createStubLanguageModel`, a deterministic
+  model that streams with no API key.
+
+## Licence
+
+Apache-2.0

package/dist/body.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The request body, validated by hand.
+ *
+ * Not zod: a schema library in a package's public surface would have
+ * to be a peer (its `instanceof` fails across copies), and the body
+ * has four fields. The shape is the AI SDK's `DefaultChatTransport`
+ * one — `id`, `messages`, `trigger`, `messageId` — plus whatever the
+ * application's transport added, which is handed back untouched as
+ * `extra` for `resolveAgent` to read (an `agentId`, a model choice).
+ */
+import type { UIMessage } from "ai";
+export type ChatAttachmentPolicy = {
+    /** Media types a file part may carry, e.g. `["image/jpeg", "image/png"]`. */
+    accept: readonly string[];
+    /** Largest data-URL payload accepted, in bytes. Unbounded when omitted. */
+    maxBytes?: number;
+};
+export type ChatBody = {
+    id: string;
+    messages: UIMessage[];
+    trigger: "submit-message" | "regenerate-message" | undefined;
+    messageId: string | undefined;
+    /** Fields the application's transport added beyond the SDK's own. */
+    extra: Record<string, unknown>;
+};
+export type ChatBodyRejection = {
+    key: "invalidBody" | "messageTooLong" | "attachmentRejected";
+    params?: Record<string, string | number>;
+};
+export type ParsedChatBody = {
+    ok: true;
+    body: ChatBody;
+} | {
+    ok: false;
+    rejection: ChatBodyRejection;
+};
+export declare function parseChatBody(json: unknown, options: {
+    maxMessageLength: number;
+    attachments: ChatAttachmentPolicy | false;
+}): ParsedChatBody;
+//# sourceMappingURL=body.d.ts.map

package/dist/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAIpC,MAAM,MAAM,oBAAoB,GAAG;IACjC,6EAA6E;IAC7E,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,OAAO,EAAE,gBAAgB,GAAG,oBAAoB,GAAG,SAAS,CAAC;IAC7D,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,aAAa,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC5B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAoDhD,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE;IACP,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,oBAAoB,GAAG,KAAK,CAAC;CAC3C,GACA,cAAc,CAsDhB"}

package/dist/body.js

@@ -0,0 +1,113 @@
+/**
+ * The request body, validated by hand.
+ *
+ * Not zod: a schema library in a package's public surface would have
+ * to be a peer (its `instanceof` fails across copies), and the body
+ * has four fields. The shape is the AI SDK's `DefaultChatTransport`
+ * one — `id`, `messages`, `trigger`, `messageId` — plus whatever the
+ * application's transport added, which is handed back untouched as
+ * `extra` for `resolveAgent` to read (an `agentId`, a model choice).
+ */
+import { extractText } from "./windowing.js";
+const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const ROLES = new Set(["system", "user", "assistant"]);
+const SDK_FIELDS = new Set(["id", "messages", "trigger", "messageId"]);
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUIMessage(value) {
+    if (!isRecord(value))
+        return false;
+    if (typeof value.id !== "string" || !value.id)
+        return false;
+    if (typeof value.role !== "string" || !ROLES.has(value.role))
+        return false;
+    if (!Array.isArray(value.parts))
+        return false;
+    return value.parts.every((part) => isRecord(part) && typeof part.type === "string");
+}
+function dataUrlBytes(url) {
+    if (!url.startsWith("data:"))
+        return null;
+    const comma = url.indexOf(",");
+    if (comma === -1)
+        return null;
+    const payload = url.slice(comma + 1);
+    return url.slice(0, comma).endsWith(";base64")
+        ? Math.floor((payload.length * 3) / 4)
+        : payload.length;
+}
+function rejectedAttachment(message, policy) {
+    for (const part of message.parts) {
+        if (part.type !== "file")
+            continue;
+        if (policy === false)
+            return true;
+        const file = part;
+        if (typeof file.mediaType !== "string" ||
+            !policy.accept.includes(file.mediaType)) {
+            return true;
+        }
+        if (policy.maxBytes !== undefined && typeof file.url === "string") {
+            const bytes = dataUrlBytes(file.url);
+            if (bytes !== null && bytes > policy.maxBytes)
+                return true;
+        }
+    }
+    return false;
+}
+export function parseChatBody(json, options) {
+    const invalid = {
+        ok: false,
+        rejection: { key: "invalidBody" },
+    };
+    if (!isRecord(json))
+        return invalid;
+    if (typeof json.id !== "string" || !UUID.test(json.id))
+        return invalid;
+    if (!Array.isArray(json.messages) || json.messages.length === 0)
+        return invalid;
+    if (!json.messages.every(isUIMessage))
+        return invalid;
+    if (json.trigger !== undefined &&
+        json.trigger !== "submit-message" &&
+        json.trigger !== "regenerate-message") {
+        return invalid;
+    }
+    if (json.messageId !== undefined && typeof json.messageId !== "string") {
+        return invalid;
+    }
+    const messages = json.messages;
+    const last = messages[messages.length - 1];
+    if (last.role === "user") {
+        const length = extractText(last.parts).length;
+        if (length > options.maxMessageLength) {
+            return {
+                ok: false,
+                rejection: {
+                    key: "messageTooLong",
+                    params: { max: options.maxMessageLength },
+                },
+            };
+        }
+        if (rejectedAttachment(last, options.attachments)) {
+            return { ok: false, rejection: { key: "attachmentRejected" } };
+        }
+    }
+    const extra = {};
+    for (const [key, value] of Object.entries(json)) {
+        if (!SDK_FIELDS.has(key))
+            extra[key] = value;
+    }
+    return {
+        ok: true,
+        body: {
+            id: json.id,
+            messages,
+            trigger: json.trigger,
+            messageId: json.messageId,
+            extra,
+        },
+    };
+}
+//# sourceMappingURL=body.js.map

package/dist/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../src/body.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+/**
+ * What a chat client needs to know about the transport, and nothing a
+ * client bundle must not carry.
+ *
+ * This file imports nothing. A UI item reads the error codes, the
+ * quota-state shape and `parseChatError` from `@intelligo-dev/chat/client`
+ * without pulling the server handler — or Drizzle, Stripe and the auth
+ * server behind it — into the browser.
+ */
+/** Stable codes the transport answers with. The status is fixed per code. */
+export declare const CHAT_ERROR_CODES: readonly ["BAD_REQUEST", "UNAUTHORIZED", "QUOTA_EXCEEDED", "FEATURE_GATED", "NOT_FOUND", "RATE_LIMITED", "INTERNAL", "BILLING_NOT_CONFIGURED"];
+export type ChatErrorCode = (typeof CHAT_ERROR_CODES)[number];
+/** The JSON body of every non-2xx answer from the chat transport. */
+export type ChatErrorBody = {
+    /** Human-readable, in the caller's locale when the app bound a translator. */
+    error: string;
+    code: ChatErrorCode;
+    /**
+     * The entitlement port's own refusal code (`insufficient_credits`,
+     * `allowance_depleted`, …) when `code` is `QUOTA_EXCEEDED` or
+     * `BILLING_NOT_CONFIGURED`.
+     */
+    reasonCode?: string;
+    /** Set on `RATE_LIMITED`. */
+    retryAfterSeconds?: number;
+};
+/**
+ * What the chat page opened with — a server-rendered estimate of the
+ * caller's credit, so the page can say "you are out" before a message
+ * is spent on finding out. Amounts are credits, the unit the balance
+ * and the estimate are both in, not money.
+ */
+export type ChatQuotaState = {
+    /** False when the next turn would be refused. */
+    allowed: boolean;
+    /** Why, when the engine refused. */
+    reason: string | null;
+    /** Typed refusal, for a UI that wants to distinguish them. */
+    code: string | null;
+    /** Credits left across every pool. */
+    remaining: number;
+    /** Worst-case credits one turn could cost. */
+    estimated: number;
+    /** Where "upgrade" and "top up" should go. */
+    upgradeHref: string;
+};
+/**
+ * The transport's error body, from the error `useChat` surfaces.
+ *
+ * The AI SDK's transport throws an `Error` whose message is the
+ * response text, so a JSON refusal arrives as a string. Anything that
+ * is not one of ours — a network failure, a proxy's HTML page — is
+ * null, and belongs in a generic error strip rather than a banner.
+ */
+export declare function parseChatError(error: unknown): ChatErrorBody | null;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,gJASnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG;IAC1B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAIF;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAgCnE"}

package/dist/client.js

@@ -0,0 +1,62 @@
+/**
+ * What a chat client needs to know about the transport, and nothing a
+ * client bundle must not carry.
+ *
+ * This file imports nothing. A UI item reads the error codes, the
+ * quota-state shape and `parseChatError` from `@intelligo-dev/chat/client`
+ * without pulling the server handler — or Drizzle, Stripe and the auth
+ * server behind it — into the browser.
+ */
+/** Stable codes the transport answers with. The status is fixed per code. */
+export const CHAT_ERROR_CODES = [
+    "BAD_REQUEST",
+    "UNAUTHORIZED",
+    "QUOTA_EXCEEDED",
+    "FEATURE_GATED",
+    "NOT_FOUND",
+    "RATE_LIMITED",
+    "INTERNAL",
+    "BILLING_NOT_CONFIGURED",
+];
+const CODES = new Set(CHAT_ERROR_CODES);
+/**
+ * The transport's error body, from the error `useChat` surfaces.
+ *
+ * The AI SDK's transport throws an `Error` whose message is the
+ * response text, so a JSON refusal arrives as a string. Anything that
+ * is not one of ours — a network failure, a proxy's HTML page — is
+ * null, and belongs in a generic error strip rather than a banner.
+ */
+export function parseChatError(error) {
+    const text = error instanceof Error
+        ? error.message
+        : typeof error === "string"
+            ? error
+            : null;
+    if (!text)
+        return null;
+    try {
+        const parsed = JSON.parse(text);
+        if (typeof parsed !== "object" ||
+            parsed === null ||
+            typeof parsed.error !== "string" ||
+            typeof parsed.code !== "string" ||
+            !CODES.has(parsed.code)) {
+            return null;
+        }
+        return {
+            error: parsed.error,
+            code: parsed.code,
+            ...(typeof parsed.reasonCode === "string"
+                ? { reasonCode: parsed.reasonCode }
+                : {}),
+            ...(typeof parsed.retryAfterSeconds === "number"
+                ? { retryAfterSeconds: parsed.retryAfterSeconds }
+                : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,eAAe;IACf,WAAW;IACX,cAAc;IACd,UAAU;IACV,wBAAwB;CAChB,CAAC;AAwCX,MAAM,KAAK,GAAwB,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAE7D;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,IAAI,GACR,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,IAAI,CAAC;IACb,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;QAC1D,IACE,OAAO,MAAM,KAAK,QAAQ;YAC1B,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAChC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;YAC/B,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EACvB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,IAAqB;YAClC,GAAG,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBACvC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE;gBACnC,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,MAAM,CAAC,iBAAiB,KAAK,QAAQ;gBAC9C,CAAC,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE;gBACjD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}