@intelligo-dev/chat 1.0.0-beta.5

package/dist/messages.js

@@ -0,0 +1,34 @@
+/**
+ * Between the rows core stores and the transcript the AI SDK renders.
+ */
+function isChatRole(role) {
+    return role === "system" || role === "user" || role === "assistant";
+}
+/**
+ * Stored `messages.parts` is a JSON string (ADR-0009's schema note); a
+ * row that fails to parse is dropped rather than failing the whole
+ * conversation. Tool-role rows are not part of the UI transcript.
+ */
+export function toUIMessages(rows) {
+    const out = [];
+    for (const row of rows) {
+        if (!isChatRole(row.role))
+            continue;
+        try {
+            const parts = JSON.parse(row.parts);
+            if (!Array.isArray(parts))
+                continue;
+            out.push({ id: row.id, role: row.role, parts });
+        }
+        catch {
+            // A corrupt row costs one message, not the conversation.
+        }
+    }
+    return out;
+}
+/** The last message when it is the user's turn, else null. */
+export function lastUserMessage(messages) {
+    const last = messages[messages.length - 1];
+    return last?.role === "user" ? last : null;
+}
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAA+B;IAC1D,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACpC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAY,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,SAAS;YACpC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,yDAAyD;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAC7B,QAAkC;IAElC,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO,IAAI,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC"}

package/dist/quota.d.ts

@@ -0,0 +1,24 @@
+/**
+ * What the chat page knows about the caller's credit before they type.
+ *
+ * The transport already refuses a turn it cannot fund — admission runs
+ * inside `executions.begin()` and answers 402. That is the correct
+ * enforcement point and the wrong place to *tell someone*: by then
+ * they have written a message and watched it fail. This is the read
+ * that lets the page say so first. An estimate, never a reservation:
+ * rendering a page cannot consume credit.
+ */
+import type { ChatQuotaState } from "./client.js";
+/**
+ * Never throws: the page renders with or without this. A quota read
+ * that fails should cost the reader a banner, not the conversation.
+ */
+export declare function getChatQuotaState(options: {
+    /** The model a turn would run on — what the estimate is priced against. */
+    modelId: string;
+    /** Where "upgrade" and "top up" should go. */
+    upgradeHref: string;
+    /** Defaults to the request's workspace. */
+    workspaceId?: string;
+}): Promise<ChatQuotaState | null>;
+//# sourceMappingURL=quota.d.ts.map

package/dist/quota.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.d.ts","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAqBjC"}

package/dist/quota.js

@@ -0,0 +1,41 @@
+/**
+ * What the chat page knows about the caller's credit before they type.
+ *
+ * The transport already refuses a turn it cannot fund — admission runs
+ * inside `executions.begin()` and answers 402. That is the correct
+ * enforcement point and the wrong place to *tell someone*: by then
+ * they have written a message and watched it fail. This is the read
+ * that lets the page say so first. An estimate, never a reservation:
+ * rendering a page cannot consume credit.
+ */
+import { requireWorkspace } from "@intelligo-dev/auth";
+import { estimateQuota } from "@intelligo-dev/billing";
+import { createLogger } from "@intelligo-dev/core/logger";
+const log = createLogger("ChatQuota");
+/**
+ * Never throws: the page renders with or without this. A quota read
+ * that fails should cost the reader a banner, not the conversation.
+ */
+export async function getChatQuotaState(options) {
+    try {
+        const workspaceId = options.workspaceId ?? (await requireWorkspace()).workspace.id;
+        const quota = await estimateQuota(workspaceId, {
+            modelId: options.modelId,
+        });
+        return {
+            allowed: quota.allowed,
+            reason: quota.reason ?? null,
+            code: quota.code ?? null,
+            remaining: quota.remainingMnt ?? 0,
+            estimated: quota.estimatedMnt ?? 0,
+            upgradeHref: options.upgradeHref,
+        };
+    }
+    catch (error) {
+        log.warn("quota state unavailable", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return null;
+    }
+}
+//# sourceMappingURL=quota.js.map

package/dist/quota.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota.js","sourceRoot":"","sources":["../src/quota.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAOvC;IACC,IAAI,CAAC;QACH,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,IAAI,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,WAAW,EAAE;YAC7C,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI;YACxB,SAAS,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;YAClC,SAAS,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;YAClC,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,yBAAyB,EAAE;YAClC,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/testing.d.ts

@@ -0,0 +1,43 @@
+/**
+ * A deterministic language model, for a chat that has no API key yet.
+ *
+ * A fresh install streams end to end — a real `createUIMessageStream`
+ * response, token by token — before any provider is configured, and the
+ * transport's own tests run against the same thing. Built on the AI
+ * SDK's own testing surface (`ai/test`), so it is a real
+ * `LanguageModel` as far as `streamText` is concerned.
+ *
+ * `modelId` is a parameter, never a literal: the execution boundary
+ * bills whatever id the transport settles with, and the id has to be
+ * one `@intelligo-dev/executions/pricing` knows.
+ */
+import type { LanguageModel } from "ai";
+/** A model prompt as the stub sees it: the AI SDK's provider-level shape. */
+export type StubPrompt = ReadonlyArray<{
+    role: string;
+    content: unknown;
+}>;
+export type StubToolCall = {
+    toolName: string;
+    /** Must satisfy the tool's input schema. */
+    input: Record<string, unknown>;
+};
+export type StubLanguageModelOptions = {
+    /** Reported to the boundary; must be a registered model id. */
+    modelId: string;
+    /** The reply, from the last user message's text. */
+    reply: (lastUserText: string, prompt: StubPrompt) => string | Promise<string>;
+    /**
+     * A tool call to emit alongside the reply, or null for none. Lets a
+     * stub exercise the whole tool path — call, execute, render — with
+     * no provider. Called once per step; return null on the follow-up
+     * step (the prompt then carries the earlier call) to end the turn.
+     */
+    toolCall?: (lastUserText: string, prompt: StubPrompt) => StubToolCall | null | Promise<StubToolCall | null>;
+    /** Delay between tokens, in ms. Default 15; 0 in tests. */
+    chunkDelayInMs?: number;
+};
+/** The last user message's text, from a provider-level prompt. */
+export declare function lastUserTextOf(prompt: StubPrompt): string;
+export declare function createStubLanguageModel(options: StubLanguageModelOptions): LanguageModel;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxC,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,KAAK,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9E;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CACT,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,UAAU,KACf,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACxD,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAiCF,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAgBzD;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,wBAAwB,GAChC,aAAa,CA2Df"}

package/dist/testing.js

@@ -0,0 +1,89 @@
+/**
+ * A deterministic language model, for a chat that has no API key yet.
+ *
+ * A fresh install streams end to end — a real `createUIMessageStream`
+ * response, token by token — before any provider is configured, and the
+ * transport's own tests run against the same thing. Built on the AI
+ * SDK's own testing surface (`ai/test`), so it is a real
+ * `LanguageModel` as far as `streamText` is concerned.
+ *
+ * `modelId` is a parameter, never a literal: the execution boundary
+ * bills whatever id the transport settles with, and the id has to be
+ * one `@intelligo-dev/executions/pricing` knows.
+ */
+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,19 @@
+/**
+ * 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;
+//# 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"}

package/dist/usage.js

@@ -0,0 +1,26 @@
+/**
+ * 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 };
+}
+//# 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"}

package/dist/windowing.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Conversation windowing: what the model is shown of a long history.
+ *
+ * `UIMessage`-shaped on purpose — this is the AI SDK's transcript, not
+ * persistence (ADR-0009 keeps windowing out of core for that reason).
+ * 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;;;;;;;;GAQG;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,CASvD;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,CAqBpB"}

package/dist/windowing.js

@@ -0,0 +1,80 @@
+/**
+ * Conversation windowing: what the model is shown of a long history.
+ *
+ * `UIMessage`-shaped on purpose — this is the AI SDK's transcript, not
+ * persistence (ADR-0009 keeps windowing out of core for that reason).
+ * 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) {
+    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);
+    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.
+    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":"AAAA;;;;;;;;GAQG;AAMH,SAAS,UAAU,CAAC,IAAa;IAC/B,OAAO,CACL,OAAO,IAAI,KAAK,QAAQ;QACxB,IAAI,KAAK,IAAI;QACZ,IAA2B,CAAC,IAAI,KAAK,MAAM;QAC5C,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,CACtD,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,KAA6B;IACvD,OAAO,KAAK;SACT,MAAM,CAAC,UAAU,CAAC;SAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,GAAG,MAAM;YAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAkC;IAElC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,gEAAgE;QAChE,qCAAqC;QACrC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC;gBACvB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAcD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,OAAkC;IAElC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAEtE,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACpC,OACE,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC;YACxB,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,EAClE,CAAC;YACD,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,iEAAiE;IACjE,+DAA+D;IAC/D,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,MAAM;QAAE,KAAK,EAAE,CAAC;IAE1E,OAAO;QACL,QAAQ,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@intelligo-dev/chat",
+  "version": "1.0.0-beta.5",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intelligo-mn/framework.git",
+    "directory": "packages/chat"
+  },
+  "homepage": "https://github.com/intelligo-mn/framework#readme",
+  "bugs": {
+    "url": "https://github.com/intelligo-mn/framework/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.5",
+    "@intelligo-dev/core": "1.0.0-beta.5",
+    "@intelligo-dev/executions": "1.0.0-beta.5",
+    "@intelligo-dev/billing": "1.0.0-beta.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "ai": "^6.0.77",
+    "typescript": "^5.7.2",
+    "zod": "^3.24.1"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "ai": "^6.0.0",
+    "zod": "^3.24.1"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "type-check": "tsc --noEmit",
+    "lint": "eslint .",
+    "build": "tsc -p tsconfig.build.json && node ../../scripts/fix-esm-extensions.mjs dist"
+  }
+}