@intelligo-dev/chat 1.0.0-beta.5

package/dist/config.d.ts

@@ -0,0 +1,195 @@
+/**
+ * What an application tells the chat transport, and what it is told back.
+ *
+ * Two things are required — the execution boundary and a way to turn a
+ * model id into a model — because those are the two things a framework
+ * must never guess (ADR-0003, ADR-0007). Everything else has a default
+ * that gives a clean install a working chat with no API keys: one
+ * agent, one prompt, no tools, a window of forty messages, a truncated
+ * first line as the title.
+ *
+ * Each optional field is a seam a real product needed and used to
+ * fork the route to get: an agent resolved per conversation from a
+ * table, a history pruned and summarised before the model sees it,
+ * image attachments, reasoning streamed to the client, a model-written
+ * title, telemetry on every turn. None of them carry product
+ * vocabulary; all of them close over the caller's tenancy so the model
+ * never has to be told which workspace it is in.
+ */
+import type { LanguageModel, StopCondition, ToolSet, UIMessage } from "ai";
+import type { Conversation } from "@intelligo-dev/core/conversations";
+import type { Executions } from "@intelligo-dev/executions";
+import type { ChatAttachmentPolicy } from "./body.js";
+import type { ChatErrorCode } from "./client.js";
+import type { ChatMessages } from "./errors.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";
+/** 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 model choice. Opaque to the transport; `resolveAgent`
+     * reads them.
+     */
+    body: Record<string, unknown>;
+    /** The existing row, or null on a conversation's first turn. */
+    conversation: Conversation | null;
+    trigger: "submit-message" | "regenerate-message" | undefined;
+}
+/** 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")`. */
+    stopWhen?: StopCondition<ToolSet> | StopCondition<ToolSet>[];
+    /** Overrides `model.defaultId`. 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;
+}
+/** 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;
+}
+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>;
+}
+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;
+        resolve: (modelId: string, turn: ChatTurnContext) => LanguageModel | Promise<LanguageModel>;
+    };
+    /** 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?: {
+        /** Default `"assistant"`. */
+        id?: string;
+        systemPrompt?: string;
+        tools?: ToolSet | ((turn: ChatTurnContext) => ToolSet | Promise<ToolSet>);
+    };
+    /**
+     * 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>;
+    /**
+     * 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;
+    /**
+     * 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,20 @@
+/**
+ * What an application tells the chat transport, and what it is told back.
+ *
+ * Two things are required — the execution boundary and a way to turn a
+ * model id into a model — because those are the two things a framework
+ * must never guess (ADR-0003, ADR-0007). Everything else has a default
+ * that gives a clean install a working chat with no API keys: one
+ * agent, one prompt, no tools, a window of forty messages, a truncated
+ * first line as the title.
+ *
+ * Each optional field is a seam a real product needed and used to
+ * fork the route to get: an agent resolved per conversation from a
+ * table, a history pruned and summarised before the model sees it,
+ * image attachments, reasoning streamed to the client, a model-written
+ * title, telemetry on every turn. None of them carry product
+ * vocabulary; all of them close over the caller's tenancy so the model
+ * never has to be told which workspace it is in.
+ */
+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;;;;;;;;;;;;;;;;;GAiBG"}

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" | "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,CASrE,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,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;AAgBZ,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,39 @@
+/**
+ * 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,
+};
+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.",
+    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;CAC5B,CAAC;AA2BF,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,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/handler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The chat transport: one turn, from request to settled execution.
+ *
+ *   onRequest → parse → authenticate → rate limit → load the row →
+ *   resolveAgent → feature gate → create the row → prepareMessages →
+ *   executions.begin() → streamText → settle → persist.
+ *
+ * Framework-agnostic on the request side: Web `Request` in, `Response`
+ * out. A Next.js route file is two lines
+ * (`export const { POST, DELETE } = createChatHandler(config)`), and a
+ * Hono app or a test calls the same functions. The request's headers
+ * reach `requireWorkspace()` through `core/request-context`, bound
+ * once by the composition root — never through `next/*` here.
+ *
+ * Entitlement is decided at `executions.begin()`, after the agent and
+ * model are resolved, so the hold matches what will actually run
+ * (ADR-0003, ADR-0007). Everything before it is cheaper and answers
+ * without opening an execution.
+ *
+ * Every terminal path settles exactly once: `complete()` is
+ * compare-and-swap in the boundary, so whichever of finish, abort or
+ * error gets there first wins and the others are no-ops.
+ */
+import type { ChatServerConfig } from "./config.js";
+export type ChatHandler = {
+    POST: (request: Request) => Promise<Response>;
+    DELETE: (request: Request) => Promise<Response>;
+};
+export declare function createChatHandler(config: ChatServerConfig): ChatHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAiCH,OAAO,KAAK,EAEV,gBAAgB,EAMjB,MAAM,UAAU,CAAC;AA6DlB,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9C,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACjD,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CA2iBvE"}