@chatcops/core 0.4.0 → 0.5.0

package/dist/index.js

@@ -1,9 +1,21 @@
-export { createProvider, normalizeHistory, ClaudeProvider, OpenAIProvider, GeminiProvider } from './providers/index.js';
+export { partsOf, messageText } from './parts.js';
+// Wire protocol
+export { PROTOCOL_VERSION, encodeSSE, SSE_PING, SSE_DONE, SSE_HEADERS, statusForError, errorBody, describeInvalidRequest, toLegacyChunk, aiSdkEncoder, fromAiSdkRequest, AI_SDK_STREAM_HEADER } from './protocol/index.js';
+export { createProvider, isAIProvider, normalizeHistory, normalizeTurns, trimHistory, estimateTokens } from './providers/index.js';
+export { registerProvider } from './providers/registry.js';
+export { toolInputSchema, legacyParametersToSchema, validateTools, ToolDefinitionError } from './providers/index.js';
+// Turn engine
+export { runTurn, DEFAULT_MAX_STEPS, toolRegistry, executorRegistry, toolOutput, MAX_TOOL_OUTPUT_CHARS, RefusalError, ContentFilterError, MaxStepsError, } from './agent/index.js';
 export { toolToDefinition, LeadCaptureTool } from './tools/index.js';
 export { TextKnowledgeSource, FAQKnowledgeSource } from './knowledge/index.js';
 export { ConversationManager, MemoryStore } from './conversation/index.js';
+export { ConflictError, isConflictError, CONFLICT_ERROR_CODE, memoryStorage, withAppend, isLegacyConversationStore, } from './storage/index.js';
+// Budgets
+export { createBudgetGuard, BudgetExceededError, DEFAULT_BUDGETS, withDefaultBudgets } from './limits/budget.js';
+// Rate limiting
+export { createRateLimiter } from './limits/rate-limit.js';
 // Analytics
-export { AnalyticsCollector } from './analytics/index.js';
+export { AnalyticsCollector, BufferedEventSink, statsFromSink } from './analytics/index.js';
 // i18n
 export { getLocale, getAvailableLocales } from './i18n/index.js';
 export { en, es, hi, fr, de, ja, zh, ar } from './i18n/index.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAIxH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIrE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/E,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3E,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,OAAO;AACP,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmCA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAElD,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,SAAS,EAAE,sBAAsB,EAAE,aAAa,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAwB3N,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACnI,OAAO,EAAE,gBAAgB,EAAwB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAErH,cAAc;AACd,OAAO,EACL,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAK1B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIrE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAI/E,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAkB3E,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGjH,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,YAAY;AACZ,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG5F,OAAO;AACP,OAAO,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/limits/budget.d.ts

@@ -0,0 +1,84 @@
+import type { CounterStore } from '../storage/types.js';
+import type { TokenUsage } from '../types.js';
+/** How much a scope may use. Unset limits don't apply. */
+export interface BudgetLimit {
+    /** Input plus output tokens, counted at face value (cached input included). */
+    tokens?: number;
+    /** Replies. */
+    messages?: number;
+}
+/** `false` turns a scope off, including its default. */
+export interface Budgets {
+    /** Over a conversation's lifetime (counters kept 30 days). */
+    perConversation?: BudgetLimit | false;
+    /** Per visitor IP, per UTC day. Skipped for requests without a known IP. */
+    perIpPerDay?: BudgetLimit | false;
+    /** Everything together, per UTC day: the backstop for a bill you didn't expect. */
+    globalPerDay?: (BudgetLimit & {
+        /** Dollars, priced with `price`. */
+        usd?: number;
+    }) | false;
+    /**
+     * What a step cost in dollars, for `globalPerDay.usd`. Price cached input
+     * at its discount here; token budgets count it in full.
+     */
+    price?: (usage: TokenUsage) => number;
+}
+/** Who a reply is for. */
+export interface BudgetContext {
+    conversationId: string;
+    ip?: string;
+}
+export type BudgetScope = 'conversation' | 'ip' | 'global';
+/** A budget is used up. The reply ends with `budget_exceeded`. */
+export declare class BudgetExceededError extends Error {
+    readonly scope: BudgetScope;
+    readonly code = "budget_exceeded";
+    constructor(scope: BudgetScope);
+}
+export interface BudgetGuard {
+    /**
+     * Checks the budgets before a model request. Throws `BudgetExceededError`
+     * when one is used up. Resolves the most tokens left in any token budget,
+     * so the caller can cap the reply length.
+     */
+    before(context: BudgetContext, step: number): Promise<{
+        tokensLeft?: number;
+    }>;
+    /** Charges a model request's usage. */
+    after(context: BudgetContext, usage: TokenUsage): Promise<void>;
+}
+/**
+ * What applies when a scope isn't set. Replies, not tokens, per conversation:
+ * the widget keeps a conversation across visits, and a token count there
+ * would grow with the size of your system prompt. Tokens per IP per day are
+ * the cost backstop, since a script can start new conversations at will.
+ * There's no global default, because no number fits every site.
+ */
+export declare const DEFAULT_BUDGETS: {
+    readonly perConversation: {
+        readonly messages: 200;
+    };
+    readonly perIpPerDay: {
+        readonly tokens: 2000000;
+    };
+};
+/**
+ * Fills the scopes you didn't set with `DEFAULT_BUDGETS`. A scope you set
+ * replaces its default whole; `false` turns it off. `false` for the whole
+ * option turns budgets off and resolves `undefined`.
+ */
+export declare function withDefaultBudgets(budgets?: Budgets | false): {
+    budgets: Budgets;
+    defaulted: BudgetScope[];
+} | undefined;
+/**
+ * Token, reply and dollar budgets on a `CounterStore`, so they hold across
+ * server instances. Checked before each model request and charged after it,
+ * so a reply can go over by at most one request.
+ */
+export declare function createBudgetGuard(counters: CounterStore, budgets: Budgets, options?: {
+    prefix?: string;
+    now?: () => number;
+}): BudgetGuard;
+//# sourceMappingURL=budget.d.ts.map

package/dist/limits/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/limits/budget.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wDAAwD;AACxD,MAAM,WAAW,OAAO;IACtB,8DAA8D;IAC9D,eAAe,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IACtC,4EAA4E;IAC5E,WAAW,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC;IAClC,mFAAmF;IACnF,YAAY,CAAC,EACT,CAAC,WAAW,GAAG;QACb,oCAAoC;QACpC,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,GACF,KAAK,CAAC;IACV;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC;CACvC;AAED,0BAA0B;AAC1B,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,IAAI,GAAG,QAAQ,CAAC;AAE3D,kEAAkE;AAClE,qBAAa,mBAAoB,SAAQ,KAAK;IAGhC,QAAQ,CAAC,KAAK,EAAE,WAAW;IAFvC,QAAQ,CAAC,IAAI,qBAAqB;gBAEb,KAAK,EAAE,WAAW;CAIxC;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,uCAAuC;IACvC,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;;;;CAGA,CAAC;AAI7B;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,WAAW,EAAE,CAAA;CAAE,GAAG,SAAS,CAaxH;AAYD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GACpD,WAAW,CAgEb"}

package/dist/limits/budget.js

@@ -0,0 +1,114 @@
+/** A budget is used up. The reply ends with `budget_exceeded`. */
+export class BudgetExceededError extends Error {
+    scope;
+    code = 'budget_exceeded';
+    constructor(scope) {
+        super(`The ${scope} budget is used up.`);
+        this.scope = scope;
+        this.name = 'BudgetExceededError';
+    }
+}
+/**
+ * What applies when a scope isn't set. Replies, not tokens, per conversation:
+ * the widget keeps a conversation across visits, and a token count there
+ * would grow with the size of your system prompt. Tokens per IP per day are
+ * the cost backstop, since a script can start new conversations at will.
+ * There's no global default, because no number fits every site.
+ */
+export const DEFAULT_BUDGETS = {
+    perConversation: { messages: 200 },
+    perIpPerDay: { tokens: 2_000_000 },
+};
+const SCOPE_KEYS = ['perConversation', 'perIpPerDay', 'globalPerDay'];
+/**
+ * Fills the scopes you didn't set with `DEFAULT_BUDGETS`. A scope you set
+ * replaces its default whole; `false` turns it off. `false` for the whole
+ * option turns budgets off and resolves `undefined`.
+ */
+export function withDefaultBudgets(budgets) {
+    if (budgets === false)
+        return undefined;
+    const out = { ...budgets };
+    const defaulted = [];
+    if (out.perConversation === undefined) {
+        out.perConversation = DEFAULT_BUDGETS.perConversation;
+        defaulted.push('conversation');
+    }
+    if (out.perIpPerDay === undefined) {
+        out.perIpPerDay = DEFAULT_BUDGETS.perIpPerDay;
+        defaulted.push('ip');
+    }
+    return SCOPE_KEYS.some((key) => out[key]) ? { budgets: out, defaulted } : undefined;
+}
+const DAY_MS = 24 * 60 * 60 * 1000;
+const CONVERSATION_TTL_MS = 30 * DAY_MS;
+/**
+ * Token, reply and dollar budgets on a `CounterStore`, so they hold across
+ * server instances. Checked before each model request and charged after it,
+ * so a reply can go over by at most one request.
+ */
+export function createBudgetGuard(counters, budgets, options = {}) {
+    const prefix = options.prefix ?? 'budget';
+    const now = options.now ?? Date.now;
+    if (budgets.globalPerDay && budgets.globalPerDay.usd !== undefined && !budgets.price) {
+        throw new Error('budgets.globalPerDay.usd needs budgets.price to know what a request costs.');
+    }
+    for (const name of SCOPE_KEYS) {
+        const limit = budgets[name];
+        if (limit === undefined || limit === false)
+            continue;
+        if (typeof limit !== 'object' || limit === null)
+            throw new Error(`budgets.${name} must be an object or false.`);
+        for (const [field, value] of Object.entries(limit)) {
+            if (typeof value !== 'number' || !(value > 0))
+                throw new Error(`budgets.${name}.${field} must be a positive number.`);
+        }
+    }
+    function scopes(context) {
+        const day = Math.floor(now() / DAY_MS);
+        const out = [];
+        if (budgets.perConversation) {
+            out.push({ scope: 'conversation', limit: budgets.perConversation, key: `${prefix}:c:${context.conversationId}`, ttlMs: CONVERSATION_TTL_MS });
+        }
+        if (budgets.perIpPerDay && context.ip) {
+            out.push({ scope: 'ip', limit: budgets.perIpPerDay, key: `${prefix}:ip:${context.ip}:${day}`, ttlMs: 2 * DAY_MS });
+        }
+        if (budgets.globalPerDay) {
+            out.push({ scope: 'global', limit: budgets.globalPerDay, key: `${prefix}:g:${day}`, ttlMs: 2 * DAY_MS });
+        }
+        return out;
+    }
+    const used = async (key) => (await counters.get(key))?.value ?? 0;
+    return {
+        async before(context, step) {
+            let tokensLeft;
+            for (const { scope, limit, key, ttlMs } of scopes(context)) {
+                if (limit.messages !== undefined && step === 1) {
+                    // Counted when the reply starts, atomically, so a burst can't all pass.
+                    const { value } = await counters.increment(`${key}:messages`, 1, ttlMs);
+                    if (value > limit.messages)
+                        throw new BudgetExceededError(scope);
+                }
+                if (limit.tokens !== undefined) {
+                    const left = limit.tokens - (await used(`${key}:tokens`));
+                    if (left <= 0)
+                        throw new BudgetExceededError(scope);
+                    tokensLeft = Math.min(tokensLeft ?? left, left);
+                }
+                if (limit.usd !== undefined && (await used(`${key}:usd`)) >= limit.usd) {
+                    throw new BudgetExceededError(scope);
+                }
+            }
+            return tokensLeft === undefined ? {} : { tokensLeft };
+        },
+        async after(context, usage) {
+            const tokens = usage.inputTokens + usage.outputTokens;
+            const usd = budgets.price ? budgets.price(usage) : 0;
+            await Promise.all(scopes(context).flatMap(({ limit, key, ttlMs }) => [
+                ...(limit.tokens !== undefined && tokens > 0 ? [counters.increment(`${key}:tokens`, tokens, ttlMs)] : []),
+                ...(limit.usd !== undefined && usd > 0 ? [counters.increment(`${key}:usd`, usd, ttlMs)] : []),
+            ]));
+        },
+    };
+}
+//# sourceMappingURL=budget.js.map

package/dist/limits/budget.js.map

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

package/dist/limits/rate-limit.d.ts

@@ -0,0 +1,53 @@
+import type { CounterStore } from '../storage/types.js';
+export interface RateLimitRule {
+    /** Maximum requests allowed per window. */
+    limit: number;
+    windowMs: number;
+}
+export interface RateLimitResult {
+    allowed: boolean;
+    /** Requests left in the current window, never below 0. */
+    remaining: number;
+    /** When denied: how long until a request would be allowed again. */
+    retryAfterMs?: number;
+}
+export interface RateLimiterOptions {
+    /** Key namespace; defaults to 'rl'. */
+    prefix?: string;
+    /** Seam for tests; defaults to Date.now. */
+    now?: () => number;
+}
+/**
+ * Sliding-window rate limiter built on two fixed-window counters.
+ *
+ * Two fixed windows — the current one and the previous one — give a smooth
+ * sliding estimate without needing per-request timestamps:
+ *
+ *   estimate = prev × (1 − elapsed/windowMs) + current
+ *
+ * where `elapsed` is how far we are into the current window. At the boundary
+ * the previous window fades out linearly, so the effective limit never exceeds
+ * `limit` over any rolling window.
+ *
+ * retryAfterMs formula
+ * --------------------
+ * We want the smallest t (in ms from now) such that the estimate drops to
+ * `limit`. All denied requests have already been counted, so `current` won't
+ * change. As time advances by t, `elapsed` increases by t and `prev`'s weight
+ * shrinks:
+ *
+ *   prev × (1 − (elapsed + t)/windowMs) + current ≤ limit
+ *   prev × (1 − (elapsed + t)/windowMs) ≤ limit − current
+ *
+ * Rearranging (prev > 0 required, otherwise we'd already be under the limit):
+ *
+ *   1 − (elapsed + t)/windowMs ≤ (limit − current) / prev
+ *   t ≥ windowMs × (1 − (limit − current) / prev) − elapsed
+ *   t ≥ windowMs − elapsed − windowMs × (limit − current) / prev
+ *
+ * Clamped to [1, windowMs] to keep the estimate positive and bounded.
+ */
+export declare function createRateLimiter(counters: CounterStore, rule: RateLimitRule, options?: RateLimiterOptions): {
+    check(key: string): Promise<RateLimitResult>;
+};
+//# sourceMappingURL=rate-limit.d.ts.map

package/dist/limits/rate-limit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../src/limits/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,SAAS,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,kBAAuB,GAC/B;IAAE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAAE,CA0ClD"}

package/dist/limits/rate-limit.js

@@ -0,0 +1,68 @@
+/**
+ * Sliding-window rate limiter built on two fixed-window counters.
+ *
+ * Two fixed windows — the current one and the previous one — give a smooth
+ * sliding estimate without needing per-request timestamps:
+ *
+ *   estimate = prev × (1 − elapsed/windowMs) + current
+ *
+ * where `elapsed` is how far we are into the current window. At the boundary
+ * the previous window fades out linearly, so the effective limit never exceeds
+ * `limit` over any rolling window.
+ *
+ * retryAfterMs formula
+ * --------------------
+ * We want the smallest t (in ms from now) such that the estimate drops to
+ * `limit`. All denied requests have already been counted, so `current` won't
+ * change. As time advances by t, `elapsed` increases by t and `prev`'s weight
+ * shrinks:
+ *
+ *   prev × (1 − (elapsed + t)/windowMs) + current ≤ limit
+ *   prev × (1 − (elapsed + t)/windowMs) ≤ limit − current
+ *
+ * Rearranging (prev > 0 required, otherwise we'd already be under the limit):
+ *
+ *   1 − (elapsed + t)/windowMs ≤ (limit − current) / prev
+ *   t ≥ windowMs × (1 − (limit − current) / prev) − elapsed
+ *   t ≥ windowMs − elapsed − windowMs × (limit − current) / prev
+ *
+ * Clamped to [1, windowMs] to keep the estimate positive and bounded.
+ */
+export function createRateLimiter(counters, rule, options = {}) {
+    if (rule.limit <= 0)
+        throw new Error('limit must be greater than 0');
+    if (rule.windowMs <= 0)
+        throw new Error('windowMs must be greater than 0');
+    const prefix = options.prefix ?? 'rl';
+    const now = options.now ?? Date.now;
+    return {
+        async check(key) {
+            const t = now();
+            const index = Math.floor(t / rule.windowMs);
+            const elapsed = t - index * rule.windowMs;
+            // Increment the current window. TTL is 2× so the previous window
+            // stays readable for the whole next window period.
+            const currentKey = `${prefix}:${key}:${index}`;
+            const [currentEntry, prevEntry] = await Promise.all([
+                counters.increment(currentKey, 1, 2 * rule.windowMs),
+                counters.get(`${prefix}:${key}:${index - 1}`),
+            ]);
+            const current = currentEntry.value;
+            const prev = prevEntry?.value ?? 0;
+            // Sliding-window estimate: blend the previous window's tail.
+            const estimate = prev * (1 - elapsed / rule.windowMs) + current;
+            if (estimate <= rule.limit) {
+                return { allowed: true, remaining: Math.max(0, Math.floor(rule.limit - estimate)) };
+            }
+            // Time (ms) until the estimate would drop back to limit.
+            // Derived above; prev > 0 whenever estimate > limit and decay is possible.
+            // When prev = 0 the counter only resets at the window boundary, so we wait
+            // out the remainder of the current window.
+            const retryAfterMs = prev > 0
+                ? Math.min(rule.windowMs, Math.max(1, Math.ceil(rule.windowMs - elapsed - (rule.windowMs * (rule.limit - current)) / prev)))
+                : Math.max(1, rule.windowMs - elapsed);
+            return { allowed: false, remaining: 0, retryAfterMs };
+        },
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/limits/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../../src/limits/rate-limit.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAsB,EACtB,IAAmB,EACnB,UAA8B,EAAE;IAEhC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACrE,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC;IAEpC,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,GAAW;YACrB,MAAM,CAAC,GAAG,GAAG,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC;YAE1C,iEAAiE;YACjE,mDAAmD;YACnD,MAAM,UAAU,GAAG,GAAG,MAAM,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YAC/C,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAClD,QAAQ,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;gBACpD,QAAQ,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;aAC9C,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,CAAC;YACnC,MAAM,IAAI,GAAG,SAAS,EAAE,KAAK,IAAI,CAAC,CAAC;YAEnC,6DAA6D;YAC7D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;YAEhE,IAAI,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC;YACtF,CAAC;YAED,yDAAyD;YACzD,2EAA2E;YAC3E,2EAA2E;YAC3E,2CAA2C;YAC3C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;gBAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,OAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;gBAC5H,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC;YAEzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;QACxD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/parts.d.ts

@@ -0,0 +1,9 @@
+import type { ChatMessage, MessagePart } from './types.js';
+/**
+ * The parts of a message. Messages saved before parts existed only have
+ * `content`, which counts as a single text part (none when it's empty).
+ */
+export declare function partsOf(message: Pick<ChatMessage, 'content' | 'parts'>): MessagePart[];
+/** The text parts joined, which is what `ChatMessage.content` holds. */
+export declare function messageText(parts: readonly MessagePart[]): string;
+//# sourceMappingURL=parts.d.ts.map

package/dist/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../src/parts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAY,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,WAAW,EAAE,CAGtF;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,GAAG,MAAM,CAKjE"}

package/dist/parts.js

@@ -0,0 +1,17 @@
+/**
+ * The parts of a message. Messages saved before parts existed only have
+ * `content`, which counts as a single text part (none when it's empty).
+ */
+export function partsOf(message) {
+    if (message.parts)
+        return message.parts;
+    return message.content ? [{ type: 'text', text: message.content }] : [];
+}
+/** The text parts joined, which is what `ChatMessage.content` holds. */
+export function messageText(parts) {
+    return parts
+        .filter((part) => part.type === 'text')
+        .map((part) => part.text)
+        .join('');
+}
+//# sourceMappingURL=parts.js.map

package/dist/parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.js","sourceRoot":"","sources":["../src/parts.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,OAA+C;IACrE,IAAI,OAAO,CAAC,KAAK;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC;IACxC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1E,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,KAA6B;IACvD,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACxD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACxB,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/protocol/ai-sdk.d.ts

@@ -0,0 +1,27 @@
+import type { WirePart } from './v1.js';
+/**
+ * The AI SDK's UI message stream (what `useChat` reads), so an app built on
+ * the AI SDK can point at a ChatCops server. Only the mapping lives here, with
+ * no dependency on the `ai` package; `chatcopsAiSdkHandler` in
+ * `@chatcops/server` serves it. A contract test pins it to an `ai` version.
+ */
+/** One UI message stream chunk. See `UIMessageChunk` in the `ai` package. */
+export type AiSdkChunk = {
+    type: string;
+} & Record<string, unknown>;
+/** The stream header `useChat` checks for. */
+export declare const AI_SDK_STREAM_HEADER = "x-vercel-ai-ui-message-stream";
+/**
+ * Turns protocol v1 parts into UI message stream chunks, one reply at a
+ * time: it remembers which tools ran on the server and whether the reply was
+ * filtered.
+ */
+export declare function aiSdkEncoder(): (part: WirePart) => AiSdkChunk[];
+/**
+ * The ChatCops request for a `useChat` request (`{ id, messages, trigger,
+ * messageId }`). Only the last user message is read: the server keeps the
+ * history, so a client can't add turns the model never wrote. `pageContext`,
+ * `locale` and `userData` pass through from the request body.
+ */
+export declare function fromAiSdkRequest(body: unknown): Record<string, unknown>;
+//# sourceMappingURL=ai-sdk.d.ts.map

package/dist/protocol/ai-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-sdk.d.ts","sourceRoot":"","sources":["../../src/protocol/ai-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;GAKG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpE,8CAA8C;AAC9C,eAAO,MAAM,oBAAoB,kCAAkC,CAAC;AAWpE;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,EAAE,CA+D/D;AAQD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBvE"}

package/dist/protocol/ai-sdk.js

@@ -0,0 +1,127 @@
+/** The stream header `useChat` checks for. */
+export const AI_SDK_STREAM_HEADER = 'x-vercel-ai-ui-message-stream';
+const FINISH_REASONS = {
+    stop: 'stop',
+    length: 'length',
+    error: 'error',
+    'client-tool-calls': 'tool-calls',
+    'approval-required': 'tool-calls',
+    handoff: 'other',
+};
+/**
+ * Turns protocol v1 parts into UI message stream chunks, one reply at a
+ * time: it remembers which tools ran on the server and whether the reply was
+ * filtered.
+ */
+export function aiSdkEncoder() {
+    const serverTools = new Set();
+    let filtered = false;
+    return (part) => {
+        switch (part.type) {
+            case 'start':
+                return [
+                    { type: 'start', messageId: part.messageId, messageMetadata: { conversationId: part.conversationId } },
+                    { type: 'start-step' },
+                ];
+            case 'text-start':
+            case 'text-end':
+                return [{ type: part.type, id: part.id }];
+            case 'text-delta':
+                return [{ type: 'text-delta', id: part.id, delta: part.delta }];
+            case 'source':
+                return [{ type: 'source-url', sourceId: part.sourceId, url: part.url, ...(part.title ? { title: part.title } : {}) }];
+            case 'tool-call': {
+                // A tool the server ran: `useChat` must not run it or wait for its output.
+                const server = part.executor === 'server';
+                if (server)
+                    serverTools.add(part.toolCallId);
+                return [
+                    {
+                        type: 'tool-input-available',
+                        toolCallId: part.toolCallId,
+                        toolName: part.toolName,
+                        input: part.input ?? {},
+                        ...(server ? { providerExecuted: true } : {}),
+                        ...(part.title ? { title: part.title } : {}),
+                    },
+                ];
+            }
+            case 'tool-result': {
+                const executed = serverTools.has(part.toolCallId) ? { providerExecuted: true } : {};
+                return part.error !== undefined
+                    ? [{ type: 'tool-output-error', toolCallId: part.toolCallId, errorText: part.error, ...executed }]
+                    : [{ type: 'tool-output-available', toolCallId: part.toolCallId, output: part.output ?? null, ...executed }];
+            }
+            case 'lead-captured':
+                return [{ type: 'data-lead-captured', data: part.lead }];
+            case 'suggestions':
+                return [{ type: 'data-suggestions', data: part.items }];
+            case 'handoff':
+            case 'agent-message': {
+                const { type, ...data } = part;
+                return [{ type: `data-${type}`, data }];
+            }
+            case 'error':
+                if (part.code === 'content_filtered')
+                    filtered = true;
+                return [{ type: 'error', errorText: part.message ?? part.code }];
+            case 'finish': {
+                if (part.reason === 'aborted')
+                    return [{ type: 'abort', reason: 'aborted' }];
+                const finishReason = filtered ? 'content-filter' : FINISH_REASONS[part.reason];
+                return [
+                    { type: 'finish-step' },
+                    { type: 'finish', finishReason, ...(part.usage ? { messageMetadata: { usage: part.usage } } : {}) },
+                ];
+            }
+            default:
+                return [];
+        }
+    };
+}
+/**
+ * The ChatCops request for a `useChat` request (`{ id, messages, trigger,
+ * messageId }`). Only the last user message is read: the server keeps the
+ * history, so a client can't add turns the model never wrote. `pageContext`,
+ * `locale` and `userData` pass through from the request body.
+ */
+export function fromAiSdkRequest(body) {
+    if (body === null || typeof body !== 'object')
+        return {};
+    const { id, messages, trigger, messageId, pageContext, locale, userData } = body;
+    const list = Array.isArray(messages) ? messages : [];
+    const lastUser = [...list].reverse().find((message) => message?.role === 'user');
+    const request = { conversationId: id, message: textOf(lastUser) };
+    if (trigger === 'regenerate-message') {
+        if (typeof messageId !== 'string') {
+            request.regenerate = true;
+        }
+        else if (list.some((message) => message?.id === messageId)) {
+            // `regenerate({ messageId })` on a user message keeps it in `messages`.
+            request.regenerate = true;
+            request.messageId = messageId;
+        }
+        else {
+            request.regenerate = { assistantMessageId: messageId };
+        }
+    }
+    else if (typeof lastUser?.id === 'string') {
+        request.messageId = lastUser.id;
+    }
+    if (pageContext !== undefined)
+        request.pageContext = pageContext;
+    if (locale !== undefined)
+        request.locale = locale;
+    if (userData !== undefined)
+        request.userData = userData;
+    return request;
+}
+function textOf(message) {
+    if (!Array.isArray(message?.parts))
+        return '';
+    return message.parts
+        .filter((part) => part?.type === 'text' && typeof part.text === 'string')
+        .map((part) => part.text)
+        .join('\n\n');
+}
+//# sourceMappingURL=ai-sdk.js.map

package/dist/protocol/ai-sdk.js.map

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

package/dist/protocol/errors.d.ts

@@ -0,0 +1,10 @@
+import type { z } from 'zod';
+import type { WireErrorCode, WireErrorBody } from './v1.js';
+export declare function statusForError(code: WireErrorCode): number;
+export declare function errorBody(code: WireErrorCode, options?: {
+    message?: string;
+    retryAfterMs?: number;
+}): WireErrorBody;
+/** "Invalid request: message, pageContext.url". Field paths only, never values. */
+export declare function describeInvalidRequest(error: z.ZodError): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/protocol/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAqB5D,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAE1D;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD,aAAa,CASf;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAQhE"}

package/dist/protocol/errors.js

@@ -0,0 +1,42 @@
+const STATUS_BY_CODE = {
+    invalid_request: 400,
+    content_filtered: 400,
+    session_required: 401,
+    token_expired: 401,
+    conversation_mismatch: 401,
+    turnstile_failed: 401,
+    origin_not_allowed: 403,
+    conversation_busy: 409,
+    payload_too_large: 413,
+    rate_limited: 429,
+    budget_exceeded: 429,
+    tool_error: 500,
+    internal_error: 500,
+    provider_error: 502,
+    provider_unavailable: 503,
+    timeout: 504,
+};
+export function statusForError(code) {
+    return STATUS_BY_CODE[code];
+}
+export function errorBody(code, options) {
+    const error = { code };
+    if (options?.message !== undefined) {
+        error.message = options.message;
+    }
+    if (options?.retryAfterMs !== undefined) {
+        error.retryAfterMs = options.retryAfterMs;
+    }
+    return { error };
+}
+/** "Invalid request: message, pageContext.url". Field paths only, never values. */
+export function describeInvalidRequest(error) {
+    const paths = new Set();
+    for (const issue of error.issues) {
+        paths.add(issue.path.length > 0 ? issue.path.join('.') : '(root)');
+    }
+    return paths.size > 0
+        ? `Invalid request: ${Array.from(paths).join(', ')}`
+        : 'Invalid request';
+}
+//# sourceMappingURL=errors.js.map