@intelligo-dev/chat 1.0.0-beta.13

package/dist/testing.js

@@ -0,0 +1,82 @@
+/**
+ * A deterministic language model (from `ai/test`) that streams end to end
+ * before any provider is configured; the transport's own tests use it too.
+ * `modelId` is a parameter, never a literal: the boundary bills whatever id
+ * the transport settles with, so it must be registered in the pricing table.
+ */
+import { MockLanguageModelV3, simulateReadableStream } from "ai/test";
+/** The last user message's text, from a provider-level prompt. */
+export function lastUserTextOf(prompt) {
+    for (let i = prompt.length - 1; i >= 0; i--) {
+        const message = prompt[i];
+        if (message?.role !== "user")
+            continue;
+        const parts = Array.isArray(message.content) ? message.content : [];
+        return parts
+            .filter((part) => typeof part === "object" &&
+            part !== null &&
+            part.type === "text")
+            .map((part) => part.text)
+            .join(" ");
+    }
+    return "";
+}
+export function createStubLanguageModel(options) {
+    const delay = options.chunkDelayInMs ?? 15;
+    return new MockLanguageModelV3({
+        provider: "stub",
+        modelId: options.modelId,
+        doStream: async ({ prompt }) => {
+            const userText = lastUserTextOf(prompt);
+            const reply = await options.reply(userText, prompt);
+            const call = options.toolCall
+                ? await options.toolCall(userText, prompt)
+                : null;
+            const words = reply.split(" ");
+            const chunks = [
+                { type: "stream-start", warnings: [] },
+                { type: "text-start", id: "1" },
+                ...words.map((word, index) => ({
+                    type: "text-delta",
+                    id: "1",
+                    delta: index === 0 ? word : ` ${word}`,
+                })),
+                { type: "text-end", id: "1" },
+                ...(call
+                    ? [
+                        {
+                            type: "tool-call",
+                            toolCallId: `stub-${Date.now()}`,
+                            toolName: call.toolName,
+                            input: JSON.stringify(call.input),
+                        },
+                    ]
+                    : []),
+                {
+                    type: "finish",
+                    finishReason: {
+                        unified: call ? "tool-calls" : "stop",
+                        raw: undefined,
+                    },
+                    usage: {
+                        inputTokens: {
+                            total: Math.max(1, Math.ceil(JSON.stringify(prompt).length / 4)),
+                            noCache: undefined,
+                            cacheRead: undefined,
+                            cacheWrite: undefined,
+                        },
+                        outputTokens: {
+                            total: words.length,
+                            text: words.length,
+                            reasoning: undefined,
+                        },
+                    },
+                },
+            ];
+            return {
+                stream: simulateReadableStream({ chunkDelayInMs: delay, chunks }),
+            };
+        },
+    });
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

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

package/dist/title.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The default conversation title: the first line of the opening
+ * message, truncated to something a sidebar can list.
+ */
+/** First line, trimmed, truncated — enough to tell history rows apart. */
+export declare function truncateTitle(firstUserText: string): string | null;
+//# sourceMappingURL=title.d.ts.map

package/dist/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../src/title.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMlE"}

package/dist/title.js

@@ -0,0 +1,15 @@
+/**
+ * The default conversation title: the first line of the opening
+ * message, truncated to something a sidebar can list.
+ */
+const MAX_TITLE_LENGTH = 60;
+/** First line, trimmed, truncated — enough to tell history rows apart. */
+export function truncateTitle(firstUserText) {
+    const line = firstUserText.trim().split("\n")[0]?.trim();
+    if (!line)
+        return null;
+    return line.length <= MAX_TITLE_LENGTH
+        ? line
+        : `${line.slice(0, MAX_TITLE_LENGTH - 1).trimEnd()}…`;
+}
+//# sourceMappingURL=title.js.map

package/dist/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../src/title.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,aAAqB;IACjD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAI,CAAC,MAAM,IAAI,gBAAgB;QACpC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC;AAC1D,CAAC"}

package/dist/usage.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Token usage, in the one shape the execution boundary settles.
+ */
+export type TokenUsage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+};
+/** The three fields settlement reads, and nothing else a provider adds. */
+export declare function pickUsage(usage: TokenUsage | undefined): TokenUsage;
+/**
+ * Whole-run usage from the steps that completed before an abort. A
+ * step still in flight is missed — under-counting by at most one step
+ * beats charging nothing and leaving the hold to expire.
+ */
+export declare function sumStepUsage(steps: ReadonlyArray<{
+    usage?: TokenUsage;
+}>): TokenUsage;
+/** The sum of two usages; a total a provider omitted is input plus output. */
+export declare function sumUsage(a: TokenUsage, b: TokenUsage): TokenUsage;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAMnE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,CAAC;IAAE,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,GAC3C,UAAU,CAQZ;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,UAAU,CAQjE"}

package/dist/usage.js

@@ -0,0 +1,35 @@
+/**
+ * Token usage, in the one shape the execution boundary settles.
+ */
+/** The three fields settlement reads, and nothing else a provider adds. */
+export function pickUsage(usage) {
+    return {
+        inputTokens: usage?.inputTokens,
+        outputTokens: usage?.outputTokens,
+        totalTokens: usage?.totalTokens,
+    };
+}
+/**
+ * Whole-run usage from the steps that completed before an abort. A
+ * step still in flight is missed — under-counting by at most one step
+ * beats charging nothing and leaving the hold to expire.
+ */
+export function sumStepUsage(steps) {
+    let inputTokens = 0;
+    let outputTokens = 0;
+    for (const step of steps) {
+        inputTokens += step.usage?.inputTokens ?? 0;
+        outputTokens += step.usage?.outputTokens ?? 0;
+    }
+    return { inputTokens, outputTokens, totalTokens: inputTokens + outputTokens };
+}
+/** The sum of two usages; a total a provider omitted is input plus output. */
+export function sumUsage(a, b) {
+    const total = (u) => u.totalTokens ?? (u.inputTokens ?? 0) + (u.outputTokens ?? 0);
+    return {
+        inputTokens: (a.inputTokens ?? 0) + (b.inputTokens ?? 0),
+        outputTokens: (a.outputTokens ?? 0) + (b.outputTokens ?? 0),
+        totalTokens: total(a) + total(b),
+    };
+}
+//# sourceMappingURL=usage.js.map

package/dist/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,KAA6B;IACrD,OAAO;QACL,WAAW,EAAE,KAAK,EAAE,WAAW;QAC/B,YAAY,EAAE,KAAK,EAAE,YAAY;QACjC,WAAW,EAAE,KAAK,EAAE,WAAW;KAChC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAC1B,KAA4C;IAE5C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,WAAW,IAAI,IAAI,CAAC,KAAK,EAAE,WAAW,IAAI,CAAC,CAAC;QAC5C,YAAY,IAAI,IAAI,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,GAAG,YAAY,EAAE,CAAC;AAChF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,QAAQ,CAAC,CAAa,EAAE,CAAa;IACnD,MAAM,KAAK,GAAG,CAAC,CAAa,EAAE,EAAE,CAC9B,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;IAChE,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC;QACxD,YAAY,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;QAC3D,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/windowing.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Conversation windowing: what the model is shown of a long history.
+ *
+ * Works on `UIMessage`s, the AI SDK's transcript, not stored rows.
+ * The default `prepareMessages` applies it; an application that wants
+ * to summarise what was pruned does so in its own `prepareMessages`,
+ * with its own model, and hands the summary back as `system`.
+ */
+import type { UIMessage } from "ai";
+/** The text parts of a message, joined. Tool and file parts contribute nothing. */
+export declare function extractText(parts: ReadonlyArray<unknown>): string;
+/**
+ * A cheap token estimate that does not need a tokenizer.
+ *
+ * Latin text runs about four characters per token; Cyrillic — and
+ * most non-Latin scripts — closer to two, because their byte-pair
+ * vocabularies are smaller. A single divisor would under-count a
+ * Cyrillic transcript by half and window it far too late.
+ */
+export declare function estimateTokenCount(text: string): number;
+export declare function estimateConversationTokens(messages: ReadonlyArray<UIMessage>): number;
+export type ConversationWindowOptions = {
+    /** Keep at most this many non-system messages. */
+    maxMessages: number;
+    /** Also drop from the front until the estimate fits, when set. */
+    maxTokens?: number;
+};
+export type ConversationWindow = {
+    windowed: UIMessage[];
+    pruned: UIMessage[];
+};
+/**
+ * Keep the most recent messages, always starting the window on a user
+ * turn so the model never sees an assistant reply without the message
+ * it answered. System messages are never pruned.
+ */
+export declare function applyConversationWindow(messages: ReadonlyArray<UIMessage>, options: ConversationWindowOptions): ConversationWindow;
+//# sourceMappingURL=windowing.d.ts.map

package/dist/windowing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowing.d.ts","sourceRoot":"","sources":["../src/windowing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAapC,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,MAAM,CAKjE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUvD;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,GACjC,MAAM,CAYR;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,aAAa,CAAC,SAAS,CAAC,EAClC,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAuBpB"}

package/dist/windowing.js

@@ -0,0 +1,82 @@
+/**
+ * Conversation windowing: what the model is shown of a long history.
+ *
+ * Works on `UIMessage`s, the AI SDK's transcript, not stored rows.
+ * The default `prepareMessages` applies it; an application that wants
+ * to summarise what was pruned does so in its own `prepareMessages`,
+ * with its own model, and hands the summary back as `system`.
+ */
+function isTextPart(part) {
+    return (typeof part === "object" &&
+        part !== null &&
+        part.type === "text" &&
+        typeof part.text === "string");
+}
+/** The text parts of a message, joined. Tool and file parts contribute nothing. */
+export function extractText(parts) {
+    return parts
+        .filter(isTextPart)
+        .map((part) => part.text)
+        .join(" ");
+}
+/**
+ * A cheap token estimate that does not need a tokenizer.
+ *
+ * Latin text runs about four characters per token; Cyrillic — and
+ * most non-Latin scripts — closer to two, because their byte-pair
+ * vocabularies are smaller. A single divisor would under-count a
+ * Cyrillic transcript by half and window it far too late.
+ */
+export function estimateTokenCount(text) {
+    // Stryker disable next-line ConditionalExpression: equivalent — the loop below counts nothing in an empty string and returns 0 either way.
+    if (!text)
+        return 0;
+    let nonLatin = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0) ?? 0;
+        if (code > 0x024f)
+            nonLatin++;
+    }
+    const latin = text.length - nonLatin;
+    return Math.ceil(latin / 4 + nonLatin / 2);
+}
+export function estimateConversationTokens(messages) {
+    let total = 0;
+    for (const message of messages) {
+        // Tool payloads are not text but still cost tokens; count their
+        // serialised size at the Latin rate.
+        for (const part of message.parts) {
+            total += isTextPart(part)
+                ? estimateTokenCount(part.text)
+                : Math.ceil(JSON.stringify(part).length / 4);
+        }
+    }
+    return total;
+}
+/**
+ * Keep the most recent messages, always starting the window on a user
+ * turn so the model never sees an assistant reply without the message
+ * it answered. System messages are never pruned.
+ */
+export function applyConversationWindow(messages, options) {
+    const system = messages.filter((message) => message.role === "system");
+    const turns = messages.filter((message) => message.role !== "system");
+    let start = Math.max(0, turns.length - options.maxMessages);
+    // Stryker disable next-line ConditionalExpression: equivalent — with no budget the comparison against undefined is false, so the loop exits on its first test.
+    if (options.maxTokens !== undefined) {
+        while (start < turns.length - 1 &&
+            estimateConversationTokens(turns.slice(start)) > options.maxTokens) {
+            start++;
+        }
+    }
+    // Open on a user message. If none follows, keep the last turn: a
+    // window of nothing is worse than one that opens mid-exchange.
+    // Stryker disable next-line OptionalChaining: equivalent — the condition to its left has already proved the index is in range.
+    while (start < turns.length - 1 && turns[start]?.role !== "user")
+        start++;
+    return {
+        windowed: [...system, ...turns.slice(start)],
+        pruned: turns.slice(0, start),
+    };
+}
+//# sourceMappingURL=windowing.js.map

package/dist/windowing.js.map

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

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@intelligo-dev/chat",
+  "version": "1.0.0-beta.13",
+  "description": "The AI-SDK-native chat transport: one Route Handler with auth, rate limits, feature gates, credits and persistence.",
+  "keywords": [
+    "intelligo",
+    "ai-saas",
+    "saas",
+    "typescript",
+    "ai-sdk",
+    "chat",
+    "streaming",
+    "llm"
+  ],
+  "license": "Apache-2.0",
+  "author": "Turtuvshin Byambaa <toroo.byamba@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligo-dev/intelligo.git",
+    "directory": "packages/chat"
+  },
+  "homepage": "https://intelligo.dev/docs/packages/chat",
+  "bugs": {
+    "url": "https://github.com/intelligo-dev/intelligo/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "default": "./dist/client.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
+    }
+  },
+  "dependencies": {
+    "@intelligo-dev/auth": "1.0.0-beta.13",
+    "@intelligo-dev/billing": "1.0.0-beta.13",
+    "@intelligo-dev/core": "1.0.0-beta.13",
+    "@intelligo-dev/executions": "1.0.0-beta.13"
+  },
+  "peerDependencies": {
+    "ai": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.1",
+    "ai": "^7.0.103",
+    "typescript": "^5.9.3"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/__tests__/**",
+    "LICENSE",
+    "NOTICE",
+    "README.md",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.14"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/fix-esm-extensions.mjs dist"
+  }
+}

package/src/artifact-writer.ts

@@ -0,0 +1,114 @@
+/**
+ * Stream a document into the chat canvas from inside a tool, as three
+ * calls over one `data-chat-artifact` part:
+ *
+ *     const doc = createArtifactWriter(turn, { kind: "text", title });
+ *     for (const chunk of chunks) doc.append(chunk);
+ *     const saved = await saveDocument(actor, { id: doc.id, title, content, kind });
+ *     doc.finish({ documentId: saved.id });
+ *
+ * Deltas are transient parts under the writer's `id` — the client
+ * accumulates them and nothing is persisted mid-stream. The `ready`
+ * part is persisted, so the message's card reopens the document from
+ * `documentId` after a reload; `error` is persisted too, so a failed
+ * document does not reload as a blank card.
+ */
+
+import type { ChatArtifactData, ChatDataChunk } from "./parts";
+
+export type ArtifactWriterOptions = {
+  kind: string;
+  title: string;
+  /** The part id, and the default document id. A fresh UUID when omitted. */
+  id?: string;
+};
+
+export type ArtifactWriter = {
+  readonly id: string;
+  /** Stream one increment. The first call opens the canvas. */
+  append: (delta: string) => void;
+  /**
+   * Mark the document ready. `content` is persisted in the part only
+   * when passed — a document that lives in the documents table is
+   * reopened from `documentId` instead.
+   */
+  finish: (result?: {
+    documentId?: string;
+    version?: number;
+    content?: string;
+    title?: string;
+  }) => void;
+  fail: (error: unknown) => void;
+  /** Everything appended so far. */
+  readonly content: string;
+};
+
+export function createArtifactWriter(
+  turn: { write: (chunk: ChatDataChunk) => void },
+  options: ArtifactWriterOptions
+): ArtifactWriter {
+  const id = options.id ?? crypto.randomUUID();
+  let title = options.title;
+  let content = "";
+  let opened = false;
+  let closed = false;
+
+  const emit = (data: ChatArtifactData, transient: boolean) => {
+    turn.write({
+      type: "data-chat-artifact",
+      id,
+      data,
+      ...(transient ? { transient: true } : {}),
+    });
+  };
+
+  const base = (): ChatArtifactData => ({
+    id,
+    kind: options.kind,
+    title,
+    status: "streaming",
+  });
+
+  return {
+    id,
+    get content() {
+      return content;
+    },
+    append(delta) {
+      if (closed) return;
+      content += delta;
+      if (!opened) {
+        opened = true;
+        emit(base(), true);
+      }
+      emit({ ...base(), delta }, true);
+    },
+    finish(result = {}) {
+      if (closed) return;
+      closed = true;
+      if (result.title) title = result.title;
+      emit(
+        {
+          ...base(),
+          status: "ready",
+          ...(result.documentId ? { documentId: result.documentId } : {}),
+          ...(result.version !== undefined ? { version: result.version } : {}),
+          ...(result.content !== undefined ? { content: result.content } : {}),
+        },
+        false
+      );
+    },
+    fail(error) {
+      if (closed) return;
+      closed = true;
+      emit(
+        {
+          ...base(),
+          status: "error",
+          error: error instanceof Error ? error.message : String(error),
+        },
+        false
+      );
+    },
+  };
+}