@intelligo-dev/chat 1.0.0-beta.13

package/dist/config.d.ts

@@ -0,0 +1,322 @@
+/**
+ * What an application tells the chat transport. Two things are required,
+ * the execution boundary and a way to run the model; everything else has a
+ * default that gives a clean install a working chat with no API keys.
+ * Optional seams close over the caller's tenancy, so the model is never told
+ * which workspace it is in. `streamTurn` replaces the model call and nothing
+ * else: auth, rate limit, gate, admission, persistence and settlement stay
+ * the transport's.
+ */
+import type { LanguageModel, StopCondition, ToolSet, UIMessage, UIMessageChunk, UIMessageStreamWriter } from "ai";
+import type { streamText } from "ai";
+/** The provider-specific options `streamText` accepts (`ai` does not export the type). */
+export type ProviderOptions = NonNullable<Parameters<typeof streamText>[0]["providerOptions"]>;
+import type { Conversation } from "@intelligo-dev/core/conversations";
+import type { Executions } from "@intelligo-dev/executions";
+import type { ChatAttachmentPolicy } from "./body.js";
+import type { ChatErrorCode, ChatModelOption } from "./client.js";
+import type { ChatMessages } from "./errors.js";
+import type { ChatGenerationOptions } from "./generation.js";
+import type { ChatDataChunk, ChatUIMessage } from "./parts.js";
+import type { TokenUsage } from "./usage.js";
+import type { ConversationWindowOptions } from "./windowing.js";
+export type { ChatAttachmentPolicy } from "./body.js";
+export type { ChatMessages, ChatMessageKey, ChatMessageParams } from "./errors.js";
+export type { ChatGenerationOptions } from "./generation.js";
+/** The resolved caller. Every read and write is scoped to this pair. */
+export interface ChatActor {
+    workspaceId: string;
+    userId: string;
+}
+/** What is known about a turn before the agent is resolved. */
+export interface ChatTurnContext extends ChatActor {
+    request: Request;
+    conversationId: string;
+    /**
+     * Fields the client transport sent beyond the AI SDK's own — an
+     * `agentId`, a `modelId`. Opaque to the transport; `resolveAgent`
+     * reads them. `modelId` is also read by the default resolution when
+     * `models` is configured.
+     */
+    body: Record<string, unknown>;
+    /** The existing row, or null on a conversation's first turn. */
+    conversation: Conversation | null;
+    trigger: "submit-message" | "regenerate-message" | undefined;
+    /**
+     * Write a part to the client mid-turn — a status line, a task plan,
+     * a document streaming into the canvas (`createArtifactWriter`). A
+     * no-op before the stream opens and after it closes, so a tool bound
+     * through `agent.tools` may hold on to it.
+     */
+    write: (chunk: ChatDataChunk) => void;
+    /**
+     * Merge a patch into the conversation's `metadata` — a runtime's
+     * session id, a summary of pruned history. Shallow: top-level keys
+     * are replaced, other keys kept. Rejects before the row exists.
+     */
+    updateMetadata: (patch: Record<string, unknown>) => Promise<void>;
+    /**
+     * Add the tokens a tool spent on its own model call — a search that
+     * asks a model, a sub-agent — to what this turn settles. They are
+     * priced as the turn's model, so a call on another model is its own
+     * execution rather than usage added here. Usage added after the run
+     * settles is not charged.
+     */
+    addUsage: (usage: TokenUsage) => void;
+}
+/** The agent this turn runs as. */
+export interface ResolvedAgent {
+    /** Stored on the conversation row when the transport creates it. */
+    id: string;
+    systemPrompt: string;
+    tools?: ToolSet;
+    /** Names the model may call this turn; every tool when omitted. */
+    activeTools?: string[];
+    /**
+     * Added after `stepCountIs(maxSteps)`, e.g. `hasToolCall("askUser")`.
+     *
+     * Consulted only on a turn that has tools: the SDK stops a run on
+     * this condition "when there are tool results in the last step", and
+     * a turn with no tools never has any, so it is a single step either
+     * way. The step cap itself is not removable — an uncapped step count
+     * is an uncapped bill.
+     */
+    stopWhen?: StopCondition<ToolSet> | StopCondition<ToolSet>[];
+    /** Overrides the request's and the config's model. Must be a registered model id. */
+    modelId?: string;
+    maxSteps?: number;
+    /** Overrides the config's; `null` disables the gate for this agent. */
+    featureKey?: string | null;
+    capability?: string;
+    /**
+     * Passed to `streamText` as-is — the provider's own knobs, e.g. a
+     * thinking budget (`{ google: { thinkingConfig: { includeThoughts: true } } }`,
+     * `{ anthropic: { thinking: { type: "enabled", budgetTokens: 2048 } } }`).
+     * With `reasoning: true` this is what makes a model's thoughts reach
+     * the transcript at all; the transport never names a provider.
+     */
+    providerOptions?: ProviderOptions;
+    /**
+     * How the model samples this turn — temperature, a token ceiling, a
+     * tool choice, a seed. An allowlist of the `streamText` options that
+     * do not touch settlement; see `ChatGenerationOptions` for what the
+     * transport keeps and why.
+     */
+    generation?: ChatGenerationOptions;
+}
+/**
+ * The one-agent shorthand, derived from `ResolvedAgent` so the two
+ * cannot drift: everything a `resolveAgent` function can return is
+ * settable here too, and the three fields below are the only ones that
+ * differ — an id and a prompt because the transport has defaults for
+ * them, and tools because the shorthand may close over the turn.
+ */
+export interface ChatAgentConfig extends Omit<ResolvedAgent, "id" | "systemPrompt" | "tools"> {
+    /** Default `"assistant"`. */
+    id?: string;
+    systemPrompt?: string;
+    tools?: ToolSet | ((turn: ChatTurnContext) => ToolSet | Promise<ToolSet>);
+}
+/** A turn with its agent resolved — what the hooks below receive. */
+export interface ChatTurn extends ChatTurnContext {
+    agent: ResolvedAgent;
+    /** The persisted history, read lazily: not every `prepareMessages` needs it. */
+    history: () => Promise<UIMessage[]>;
+}
+/** What the model is shown. */
+export interface PreparedTurn {
+    messages: UIMessage[];
+    /** Replaces the agent's system prompt when set — a summary prefix, injected context. */
+    system?: string;
+}
+/**
+ * A turn produced by something other than `streamText`.
+ *
+ * `stream` carries the AI SDK's UI message chunks. The transport writes
+ * `start` and `finish` itself and drops any the stream emits, so a
+ * runtime whose adapter already frames the message needs no stripping.
+ * `usage` settles the execution: it resolves once the run is over,
+ * with the whole run's tokens. On a client abort the transport settles
+ * with whatever `usage` resolves to; reject it and the turn is failed.
+ */
+export interface TurnStream {
+    stream: ReadableStream<UIMessageChunk>;
+    usage: Promise<TokenUsage & {
+        modelId?: string;
+        finishReason?: string;
+    }>;
+}
+export type StreamTurn = (turn: ChatTurn, prepared: PreparedTurn, context: {
+    modelId: string;
+    abortSignal: AbortSignal;
+    writer: UIMessageStreamWriter<ChatUIMessage>;
+}) => TurnStream | Promise<TurnStream>;
+export interface RateLimitDecision {
+    allowed: boolean;
+    retryAfterSeconds?: number;
+    limit?: number;
+    remaining?: number;
+    resetAt?: Date;
+}
+export interface ChatTurnEvents {
+    /** The execution is open and the model is about to run. */
+    start?: (event: {
+        turn: ChatTurn;
+        executionId: string;
+        requestId: string;
+        modelId: string;
+    }) => void | Promise<void>;
+    /** The run settled — after a normal finish, or after the client aborted. */
+    complete?: (event: {
+        turn: ChatTurn;
+        executionId: string;
+        modelId: string;
+        usage: TokenUsage;
+        aborted: boolean;
+        finishReason?: string;
+        rawFinishReason?: string;
+        providerMetadata?: unknown;
+        warnings?: unknown[];
+    }) => void | Promise<void>;
+    /** Something threw. `phase` says where; the turn may or may not have an agent yet. */
+    fail?: (event: {
+        turn: ChatTurnContext;
+        error: unknown;
+        phase: "stream" | "settlement" | "persistence" | "title" | "unhandled";
+    }) => void | Promise<void>;
+    /** The transport answered with a refusal rather than a stream. */
+    refuse?: (event: {
+        actor: ChatActor | null;
+        conversationId: string | null;
+        code: ChatErrorCode;
+        status: number;
+        reasonCode?: string;
+    }) => void | Promise<void>;
+    /**
+     * The user answered a tool's approval request. Fired once per
+     * response, from the continuation turn that carries it — the audit
+     * trail a product needs for a gated action.
+     */
+    approval?: (event: {
+        turn: ChatTurnContext;
+        toolName: string;
+        toolCallId: string;
+        approvalId: string;
+        approved: boolean;
+        reason?: string;
+    }) => void | Promise<void>;
+    /** The reader voted on a reply, or cleared a vote. */
+    feedback?: (event: {
+        actor: ChatActor;
+        conversationId: string;
+        messageId: string;
+        vote: "up" | "down" | null;
+    }) => void | Promise<void>;
+}
+export interface ChatModelsConfig {
+    /**
+     * Models the request may ask for by `modelId`. A list, or a function
+     * of the caller for a list that depends on the plan. A request naming
+     * a model outside it, or one whose `featureKey` the workspace lacks,
+     * is refused as `FEATURE_GATED` with reason `model_not_allowed`.
+     */
+    options: ChatModelOption[] | ((actor: ChatActor) => ChatModelOption[] | Promise<ChatModelOption[]>);
+}
+export interface ChatServerConfig {
+    /** The execution boundary, with its ports bound by the composition root. */
+    executions: Executions;
+    model: {
+        /** Must be registered in `@intelligo-dev/executions/pricing`. */
+        defaultId: string;
+        /**
+         * Turns a model id into a model for `streamText`. Required unless
+         * `streamTurn` is set, and unused when it is.
+         */
+        resolve?: (modelId: string, turn: ChatTurnContext) => LanguageModel | Promise<LanguageModel>;
+    };
+    /**
+     * Runs the turn instead of `streamText` — a Mastra agent, an eve
+     * session, a workflow. Everything around the model call stays the
+     * transport's. See `TurnStream`.
+     */
+    streamTurn?: StreamTurn;
+    /** Runs first on every request — the place to call `composeIntelligo()`. */
+    onRequest?: () => void | Promise<void>;
+    /** Plan feature key gating the surface. `null` disables the gate. Default `"chat"`. */
+    featureKey?: string | null;
+    /** Capability recorded on each execution. Default `"chat.message"`. */
+    capability?: string;
+    /** Longest user message accepted, in characters. Default 8000. */
+    maxMessageLength?: number;
+    /** Model steps one turn may take (a tool call and the reply using it are two). Default 5. */
+    maxSteps?: number;
+    /**
+     * The one-agent shorthand. Ignored when `resolveAgent` is set.
+     * `tools` may close over the turn's tenancy.
+     */
+    agent?: ChatAgentConfig;
+    /**
+     * Which agent runs this turn — from the body, the row, a table. The
+     * default resolves `agent`, keeping the id the conversation was
+     * created with.
+     */
+    resolveAgent?: (turn: ChatTurnContext) => ResolvedAgent | Promise<ResolvedAgent>;
+    /** The models a request may pick from. Unset: every request runs the default. */
+    models?: ChatModelsConfig;
+    /**
+     * What the model is shown. The default windows the incoming
+     * transcript by `windowing`. An application that prunes, summarises
+     * or injects context binds its own; `turn.history()` reads the
+     * persisted messages when the client's copy is not to be trusted.
+     */
+    prepareMessages?: (turn: ChatTurn, incoming: UIMessage[]) => PreparedTurn | Promise<PreparedTurn>;
+    /** Default `{ maxMessages: 40 }`; `false` shows the model everything. */
+    windowing?: ConversationWindowOptions | false;
+    /** File parts the transport accepts. Default `false`: any file part is a 400. */
+    attachments?: ChatAttachmentPolicy | false;
+    /** Stream the model's reasoning parts to the client. Default false. */
+    reasoning?: boolean;
+    /** Stream the model's source parts (citations) to the client. Default false. */
+    sources?: boolean;
+    /**
+     * Attach `{ modelId, usage, finishedAt }` to the assistant message as
+     * its metadata when the turn finishes. Default true.
+     */
+    messageMetadata?: boolean;
+    /**
+     * Answer cross-origin requests from these origins — an embedded
+     * widget on another site. Unset: no CORS headers, same-origin only.
+     */
+    cors?: {
+        origins: readonly string[];
+    };
+    /**
+     * Titles a conversation from its first user message when the row is
+     * created. Sync: stored on create. Async: the row is created untitled,
+     * renamed when the promise resolves, and the client is sent a
+     * transient `data-chat-title` part. Default: first line, truncated.
+     */
+    deriveTitle?: (firstUserText: string, turn: ChatTurnContext) => string | null | Promise<string | null>;
+    /**
+     * Where the turn's messages go. Default: the user message that
+     * opened the turn and the assistant reply, upserted through core.
+     * `false` persists nothing.
+     */
+    persist?: false | ((turn: ChatTurn, result: {
+        userMessage: UIMessage | null;
+        responseMessage: UIMessage;
+        isContinuation: boolean;
+    }) => Promise<void>);
+    /** Adjusts what settlement records — a floor for providers that report nothing. */
+    normalizeUsage?: (usage: TokenUsage) => TokenUsage;
+    /** Merged into the execution's metadata on begin and complete. */
+    metadata?: (turn: ChatTurn) => Record<string, unknown>;
+    onTurn?: ChatTurnEvents;
+    /** Localised refusal copy. Default: English. */
+    messages?: (request: Request) => ChatMessages | Promise<ChatMessages>;
+    /** Default: `requireWorkspace()`. Throw to answer 401. */
+    authenticate?: (request: Request) => Promise<ChatActor>;
+    /** Default: the workspace plan's per-minute limit. `false` disables. */
+    rateLimit?: false | ((actor: ChatActor) => Promise<RateLimitDecision>);
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,11 @@
+/**
+ * What an application tells the chat transport. Two things are required,
+ * the execution boundary and a way to run the model; everything else has a
+ * default that gives a clean install a working chat with no API keys.
+ * Optional seams close over the caller's tenancy, so the model is never told
+ * which workspace it is in. `streamTurn` replaces the model call and nothing
+ * else: auth, rate limit, gate, admission, persistence and settlement stay
+ * the transport's.
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Refusals: one status per code, one message key per situation.
+ *
+ * The transport never invents copy. It asks a translator for a key,
+ * and the application binds that translator to its own message files
+ * (`messages(request)` in the config). The English table below is the
+ * default a deployment gets when it binds nothing.
+ */
+import type { ChatErrorBody, ChatErrorCode } from "./client.js";
+export declare const CHAT_ERROR_STATUS: Readonly<Record<ChatErrorCode, number>>;
+/**
+ * Every message the transport can answer with. One key per situation,
+ * not per code: `BAD_REQUEST` has three.
+ */
+export type ChatMessageKey = "invalidBody" | "messageTooLong" | "attachmentRejected" | "unauthorized" | "rateLimited" | "featureGated" | "notFound" | "quotaExceeded" | "billingNotConfigured" | "modelUnavailable" | "internalError" | "streamError";
+export type ChatMessageParams = Record<string, string | number>;
+/** Resolves a message key in the caller's locale. */
+export type ChatMessages = (key: ChatMessageKey, params?: ChatMessageParams) => string;
+/** The default translator: English, with `{param}` interpolation. */
+export declare const DEFAULT_CHAT_MESSAGES: ChatMessages;
+/** A JSON refusal with the status its code fixes. */
+export declare function refuse(code: ChatErrorCode, error: string, extra?: Partial<Omit<ChatErrorBody, "error" | "code">>, headers?: Record<string, string>): Response;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7D,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAUrE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,aAAa,GACb,gBAAgB,GAChB,oBAAoB,GACpB,cAAc,GACd,aAAa,GACb,cAAc,GACd,UAAU,GACV,eAAe,GACf,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,aAAa,CAAC;AAElB,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAEhE,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,cAAc,EACnB,MAAM,CAAC,EAAE,iBAAiB,KACvB,MAAM,CAAC;AAiBZ,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,EAAE,YAGjC,CAAC;AAEJ,qDAAqD;AACrD,wBAAgB,MAAM,CACpB,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC,CAAM,EAC1D,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,QAAQ,CAGV"}

package/dist/errors.js

@@ -0,0 +1,41 @@
+/**
+ * Refusals: one status per code, one message key per situation.
+ *
+ * The transport never invents copy. It asks a translator for a key,
+ * and the application binds that translator to its own message files
+ * (`messages(request)` in the config). The English table below is the
+ * default a deployment gets when it binds nothing.
+ */
+export const CHAT_ERROR_STATUS = {
+    BAD_REQUEST: 400,
+    UNAUTHORIZED: 401,
+    QUOTA_EXCEEDED: 402,
+    FEATURE_GATED: 403,
+    NOT_FOUND: 404,
+    RATE_LIMITED: 429,
+    INTERNAL: 500,
+    BILLING_NOT_CONFIGURED: 503,
+    MODEL_UNAVAILABLE: 503,
+};
+const ENGLISH = {
+    invalidBody: "Invalid request body.",
+    messageTooLong: "Message is too long (max {max} characters).",
+    attachmentRejected: "That attachment type isn't accepted.",
+    unauthorized: "Unauthorized.",
+    rateLimited: "Rate limit exceeded. Try again in {seconds}s.",
+    featureGated: "Chat isn't included in your current plan.",
+    notFound: "That conversation no longer exists.",
+    quotaExceeded: "Usage quota exceeded. Upgrade your plan or purchase credits.",
+    billingNotConfigured: "Billing is not configured for this deployment.",
+    modelUnavailable: "Chat is temporarily unavailable. Please try again later.",
+    internalError: "Something went wrong.",
+    streamError: "Something went wrong while generating a response.",
+};
+/** The default translator: English, with `{param}` interpolation. */
+export const DEFAULT_CHAT_MESSAGES = (key, params = {}) => ENGLISH[key].replace(/\{(\w+)\}/g, (match, name) => name in params ? String(params[name]) : match);
+/** A JSON refusal with the status its code fixes. */
+export function refuse(code, error, extra = {}, headers = {}) {
+    const body = { error, code, ...extra };
+    return Response.json(body, { status: CHAT_ERROR_STATUS[code], headers });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAA4C;IACxE,WAAW,EAAE,GAAG;IAChB,YAAY,EAAE,GAAG;IACjB,cAAc,EAAE,GAAG;IACnB,aAAa,EAAE,GAAG;IAClB,SAAS,EAAE,GAAG;IACd,YAAY,EAAE,GAAG;IACjB,QAAQ,EAAE,GAAG;IACb,sBAAsB,EAAE,GAAG;IAC3B,iBAAiB,EAAE,GAAG;CACvB,CAAC;AA4BF,MAAM,OAAO,GAA6C;IACxD,WAAW,EAAE,uBAAuB;IACpC,cAAc,EAAE,6CAA6C;IAC7D,kBAAkB,EAAE,sCAAsC;IAC1D,YAAY,EAAE,eAAe;IAC7B,WAAW,EAAE,+CAA+C;IAC5D,YAAY,EAAE,2CAA2C;IACzD,QAAQ,EAAE,qCAAqC;IAC/C,aAAa,EAAE,8DAA8D;IAC7E,oBAAoB,EAAE,gDAAgD;IACtE,gBAAgB,EAAE,0DAA0D;IAC5E,aAAa,EAAE,uBAAuB;IACtC,WAAW,EAAE,mDAAmD;CACjE,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,EAAE,EAAE,CACtE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CACzD,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAC9C,CAAC;AAEJ,qDAAqD;AACrD,MAAM,UAAU,MAAM,CACpB,IAAmB,EACnB,KAAa,EACb,QAAwD,EAAE,EAC1D,UAAkC,EAAE;IAEpC,MAAM,IAAI,GAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;IACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,iBAAiB,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/feedback.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A reader's verdict on a reply, recorded once and reported once.
+ *
+ * The registry's `voteMessage` action is two lines over this: the
+ * write goes through core's votes table, and the `feedback` hook is
+ * the one place telemetry learns about it — the same hook whether the
+ * vote came from the page, a panel or a widget.
+ */
+import type { ChatActor, ChatServerConfig } from "./config.js";
+export type ChatFeedback = "up" | "down" | null;
+export type RecordChatFeedbackResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: "not_found" | "database_error";
+};
+export declare function recordChatFeedback(config: Pick<ChatServerConfig, "onTurn">, actor: ChatActor, params: {
+    conversationId: string;
+    messageId: string;
+    vote: ChatFeedback;
+}): Promise<RecordChatFeedbackResult>;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5D,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;AAEhD,MAAM,MAAM,wBAAwB,GAClC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAErE,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,EACxC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,GACxE,OAAO,CAAC,wBAAwB,CAAC,CAmCnC"}

package/dist/feedback.js

@@ -0,0 +1,46 @@
+/**
+ * A reader's verdict on a reply, recorded once and reported once.
+ *
+ * The registry's `voteMessage` action is two lines over this: the
+ * write goes through core's votes table, and the `feedback` hook is
+ * the one place telemetry learns about it — the same hook whether the
+ * vote came from the page, a panel or a widget.
+ */
+import { clearVote, isConversationServiceError, voteMessage, } from "@intelligo-dev/core/conversations";
+export async function recordChatFeedback(config, actor, params) {
+    try {
+        if (params.vote === null) {
+            await clearVote(actor, {
+                chatId: params.conversationId,
+                messageId: params.messageId,
+            });
+        }
+        else {
+            await voteMessage(actor, {
+                chatId: params.conversationId,
+                messageId: params.messageId,
+                type: params.vote,
+            });
+        }
+    }
+    catch (error) {
+        if (isConversationServiceError(error) &&
+            (error.code === "not_found" || error.code === "forbidden")) {
+            return { ok: false, code: "not_found" };
+        }
+        return { ok: false, code: "database_error" };
+    }
+    try {
+        await config.onTurn?.feedback?.({
+            actor,
+            conversationId: params.conversationId,
+            messageId: params.messageId,
+            vote: params.vote,
+        });
+    }
+    catch {
+        // Telemetry must never fail a vote.
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,SAAS,EACT,0BAA0B,EAC1B,WAAW,GACZ,MAAM,mCAAmC,CAAC;AAS3C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAwC,EACxC,KAAgB,EAChB,MAAyE;IAEzE,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACzB,MAAM,SAAS,CAAC,KAAK,EAAE;gBACrB,MAAM,EAAE,MAAM,CAAC,cAAc;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;aAC5B,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,CAAC,KAAK,EAAE;gBACvB,MAAM,EAAE,MAAM,CAAC,cAAc;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IACE,0BAA0B,CAAC,KAAK,CAAC;YACjC,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,EAC1D,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YAC9B,KAAK;YACL,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/generation.d.ts

@@ -0,0 +1,104 @@
+/**
+ * The `streamText` options a product may set per turn: how the model
+ * samples (temperature, a token ceiling, a tool choice, a seed), none of
+ * which changes what settlement reads back. Written out as an allowlist
+ * rather than an `Omit<>` over the SDK's type, so an option a later SDK adds
+ * is not admitted silently.
+ *
+ * What the transport keeps, and why each one is not negotiable:
+ *
+ *   `abortSignal`   without `request.signal` an abandoned run bills in
+ *                   full and `onAbort` never fires.
+ *   `timeout`       a timeout lands on the error path, which releases
+ *                   the hold without charging tokens the provider has
+ *                   already produced. The route's deadline is
+ *                   `maxDuration`.
+ *   `onFinish`,     the transport captures `totalUsage` there; replacing
+ *   `onEnd`         it means every turn ends "stream ended without
+ *                   usage".
+ *   `onAbort`       settles from `sumStepUsage(steps)`.
+ *   `onError`       the failure path is `run.fail()` plus localised copy.
+ *   `model`         admission already priced the resolved `modelId`;
+ *                   another model bills one admission never saw.
+ *   `system`,       `prepareMessages` owns what the model is shown.
+ *   `messages`,
+ *   `prompt`,
+ *   `instructions`
+ *   `tools`,        already seams on the agent, and the same object
+ *   `activeTools`   feeds `convertToModelMessages`; a second source
+ *                   desynchronises the two.
+ *   `stopWhen`      `stepCountIs(maxSteps)` must stay first and
+ *                   unremovable — an uncapped step count is an uncapped
+ *                   bill. `ResolvedAgent.stopWhen` appends to it.
+ *   `_internal`     the SDK's own test seam, not a product knob.
+ *
+ * Enforced three ways, because a cast defeats the type: the type itself,
+ * `pickGenerationOptions` copying only `GENERATION_KEYS` at runtime, and the
+ * handler spreading the result *first* so the transport's own keys win.
+ */
+import type { LanguageModelCallOptions, PrepareStepFunction, RequestOptions, StreamTextTransform, TelemetryOptions, ToolChoice, ToolSet } from "ai";
+import type { streamText } from "ai";
+/**
+ * Settlement-neutral `streamText` options, sourced from the SDK's own
+ * types by indexed access so that a signature change upstream is a
+ * compile error here rather than a silently dropped field.
+ *
+ * Nested under `generation` rather than flattened onto `ResolvedAgent`
+ * for a concrete reason: `ai` has its own `reasoning` (an effort level
+ * for the model) and `ChatServerConfig.reasoning` already means "stream
+ * reasoning parts to the client". Flattening would put two different
+ * `reasoning` in one namespace, and every future SDK option would be
+ * one name collision away from a framework field.
+ */
+export interface ChatGenerationOptions {
+    /**
+     * Ceiling on the tokens one step may produce. Unset, the transport
+     * uses the registered model's `maxOutputTokens` — the figure admission
+     * sized its hold with. A larger value here lets a step cost more than
+     * was held.
+     */
+    maxOutputTokens?: LanguageModelCallOptions["maxOutputTokens"];
+    temperature?: LanguageModelCallOptions["temperature"];
+    topP?: LanguageModelCallOptions["topP"];
+    topK?: LanguageModelCallOptions["topK"];
+    presencePenalty?: LanguageModelCallOptions["presencePenalty"];
+    frequencyPenalty?: LanguageModelCallOptions["frequencyPenalty"];
+    stopSequences?: LanguageModelCallOptions["stopSequences"];
+    seed?: LanguageModelCallOptions["seed"];
+    /**
+     * The model's reasoning effort — not `ChatServerConfig.reasoning`,
+     * which decides whether reasoning parts reach the client.
+     */
+    reasoning?: LanguageModelCallOptions["reasoning"];
+    /** Retries on a failed provider call. A retried call still reports one `totalUsage`. */
+    maxRetries?: RequestOptions["maxRetries"];
+    headers?: RequestOptions["headers"];
+    /** Picks among the tools the agent already declared; cannot introduce one. */
+    toolChoice?: ToolChoice<ToolSet>;
+    /** Per-step adjustment inside a loop the transport still caps with `maxSteps`. */
+    prepareStep?: PrepareStepFunction<ToolSet>;
+    /** Observation only. The current name; `experimental_telemetry` is the SDK's deprecated alias. */
+    telemetry?: TelemetryOptions;
+    /** Transforms the text stream. Usage is computed from steps, not from the transformed text. */
+    experimental_transform?: StreamTextTransform<ToolSet>;
+    /** Per-step observation `onTurn` has no equivalent for. */
+    onStepEnd?: Parameters<typeof streamText>[0]["onStepEnd"];
+}
+/**
+ * Every key of `ChatGenerationOptions`, as values.
+ *
+ * `satisfies` proves the array holds only real keys; `Exhaustive` below
+ * proves it holds all of them, so a field added to the interface
+ * without a line here is a compile error rather than an option that
+ * silently never reaches the model.
+ */
+export declare const GENERATION_KEYS: readonly ["maxOutputTokens", "temperature", "topP", "topK", "presencePenalty", "frequencyPenalty", "stopSequences", "seed", "reasoning", "maxRetries", "headers", "toolChoice", "prepareStep", "telemetry", "experimental_transform", "onStepEnd"];
+/**
+ * The allowlisted options, copied by name.
+ *
+ * Absent keys produce no own property rather than an explicit
+ * `undefined`: the handler spreads the result into a call where a
+ * present-but-undefined key would override the SDK's own default.
+ */
+export declare function pickGenerationOptions(options: ChatGenerationOptions | undefined): Partial<ChatGenerationOptions>;
+//# sourceMappingURL=generation.d.ts.map

package/dist/generation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.d.ts","sourceRoot":"","sources":["../src/generation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,OAAO,EACR,MAAM,IAAI,CAAC;AACZ,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IAC9D,WAAW,CAAC,EAAE,wBAAwB,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;IAC9D,gBAAgB,CAAC,EAAE,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;IAChE,aAAa,CAAC,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAC1D,IAAI,CAAC,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACxC;;;OAGG;IACH,SAAS,CAAC,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAClD,wFAAwF;IACxF,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACpC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,kFAAkF;IAClF,WAAW,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC3C,kGAAkG;IAClG,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,+FAA+F;IAC/F,sBAAsB,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC;IACtD,2DAA2D;IAC3D,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;CAC3D;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,oPAiBmC,CAAC;AAWhE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,qBAAqB,GAAG,SAAS,GACzC,OAAO,CAAC,qBAAqB,CAAC,CAOhC"}