@chatcops/core 0.4.0 → 0.6.0

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/logger.d.ts

@@ -0,0 +1,36 @@
+/** Extra details for a log line. An `error` field is printed in full. */
+export type LogFields = Record<string, unknown>;
+/**
+ * Where ChatCops writes what it notices: startup notes, refused requests and
+ * every error it catches instead of throwing. `event` is a stable name to
+ * filter or alert on (`provider_error`, `tool_error`, `webhook_failed`, …),
+ * and `message` is for people.
+ */
+export interface Logger {
+    debug(event: string, message: string, fields?: LogFields): void;
+    info(event: string, message: string, fields?: LogFields): void;
+    warn(event: string, message: string, fields?: LogFields): void;
+    error(event: string, message: string, fields?: LogFields): void;
+}
+type Level = keyof Logger;
+/**
+ * The default: `[chatcops] message` on the console, with an `error` field
+ * printed after it so its stack shows. Other fields are left out, to keep
+ * the lines short.
+ */
+export declare function consoleLogger(): Logger;
+export interface JsonLoggerOptions {
+    /** Where each line goes. Default `console.error`, which is stderr on Node and the log on Workers. */
+    write?: (line: string) => void;
+    /** Lines below this level are dropped. Default `info`. */
+    level?: Level;
+}
+/**
+ * One JSON object per line (`{ time, level, event, message, ...fields }`), for
+ * log tools that parse them. Errors become `{ name, message, stack }`.
+ */
+export declare function jsonLogger(options?: JsonLoggerOptions): Logger;
+/** A logger that writes nothing, for tests. */
+export declare function silentLogger(): Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;CACjE;AAED,KAAK,KAAK,GAAG,MAAM,MAAM,CAAC;AAG1B;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAOtC;AAED,MAAM,WAAW,iBAAiB;IAChC,qGAAqG;IACrG,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,0DAA0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,MAAM,CASlE;AAMD,+CAA+C;AAC/C,wBAAgB,YAAY,IAAI,MAAM,CAGrC"}

package/dist/logger.js

@@ -0,0 +1,40 @@
+const LEVELS = ['debug', 'info', 'warn', 'error'];
+/**
+ * The default: `[chatcops] message` on the console, with an `error` field
+ * printed after it so its stack shows. Other fields are left out, to keep
+ * the lines short.
+ */
+export function consoleLogger() {
+    const write = (level) => (_event, message, fields) => {
+        const line = `[chatcops] ${message}`;
+        if (fields?.error !== undefined)
+            console[level](line, fields.error);
+        else
+            console[level](line);
+    };
+    return Object.fromEntries(LEVELS.map((level) => [level, write(level)]));
+}
+/**
+ * One JSON object per line (`{ time, level, event, message, ...fields }`), for
+ * log tools that parse them. Errors become `{ name, message, stack }`.
+ */
+export function jsonLogger(options = {}) {
+    const write = options.write ?? ((line) => console.error(line));
+    const min = LEVELS.indexOf(options.level ?? 'info');
+    const log = (level) => (event, message, fields = {}) => {
+        if (LEVELS.indexOf(level) < min)
+            return;
+        const entries = Object.entries(fields).map(([key, value]) => [key, value instanceof Error ? describeError(value) : value]);
+        write(JSON.stringify({ time: new Date().toISOString(), level, event, message, ...Object.fromEntries(entries) }));
+    };
+    return Object.fromEntries(LEVELS.map((level) => [level, log(level)]));
+}
+function describeError(error) {
+    return { name: error.name, message: error.message, ...(error.stack ? { stack: error.stack } : {}) };
+}
+/** A logger that writes nothing, for tests. */
+export function silentLogger() {
+    const nothing = () => { };
+    return { debug: nothing, info: nothing, warn: nothing, error: nothing };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,GAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,KAAK,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC,MAAc,EAAE,OAAe,EAAE,MAAkB,EAAE,EAAE;QACtF,MAAM,IAAI,GAAG,cAAc,OAAO,EAAE,CAAC;QACrC,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;;YAC/D,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAsB,CAAC;AAC/F,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAA6B,EAAE;IACxD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,CAAC,KAAa,EAAE,OAAe,EAAE,SAAoB,EAAE,EAAE,EAAE;QACvF,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG;YAAE,OAAO;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3H,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACnH,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAsB,CAAC;AAC7F,CAAC;AAED,SAAS,aAAa,CAAC,KAAY;IACjC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AACtG,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;IACzB,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC1E,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

package/dist/protocol/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/protocol/errors.ts"],"names":[],"mappings":"AAGA,MAAM,cAAc,GAAkC;IACpD,eAAe,EAAE,GAAG;IACpB,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,GAAG;IACrB,aAAa,EAAE,GAAG;IAClB,qBAAqB,EAAE,GAAG;IAC1B,gBAAgB,EAAE,GAAG;IACrB,kBAAkB,EAAE,GAAG;IACvB,iBAAiB,EAAE,GAAG;IACtB,iBAAiB,EAAE,GAAG;IACtB,YAAY,EAAE,GAAG;IACjB,eAAe,EAAE,GAAG;IACpB,UAAU,EAAE,GAAG;IACf,cAAc,EAAE,GAAG;IACnB,cAAc,EAAE,GAAG;IACnB,oBAAoB,EAAE,GAAG;IACzB,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAmB;IAChD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAmB,EACnB,OAAqD;IAErD,MAAM,KAAK,GAA2B,EAAE,IAAI,EAAE,CAAC;IAC/C,IAAI,OAAO,EAAE,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,IAAI,OAAO,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACxC,KAAK,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,sBAAsB,CAAC,KAAiB;IACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC;QACnB,CAAC,CAAC,oBAAoB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACpD,CAAC,CAAC,iBAAiB,CAAC;AACxB,CAAC"}

package/dist/protocol/index.d.ts

@@ -0,0 +1,9 @@
+export { PROTOCOL_VERSION } from './v1.js';
+export { encodeSSE, SSE_PING, SSE_DONE, SSE_HEADERS } from './sse.js';
+export { statusForError, errorBody, describeInvalidRequest } from './errors.js';
+export { toLegacyChunk } from './legacy.js';
+export { aiSdkEncoder, fromAiSdkRequest, AI_SDK_STREAM_HEADER } from './ai-sdk.js';
+export type { AiSdkChunk } from './ai-sdk.js';
+export type { LegacyChunk } from './legacy.js';
+export type { WirePart, WirePartType, WireErrorCode, WireFinishReason, WireAgent, WireErrorBody, ChatRequestV1, ClientToolManifest, } from './v1.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,aAAa,EACb,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/protocol/index.js

@@ -0,0 +1,6 @@
+export { PROTOCOL_VERSION } from './v1.js';
+export { encodeSSE, SSE_PING, SSE_DONE, SSE_HEADERS } from './sse.js';
+export { statusForError, errorBody, describeInvalidRequest } from './errors.js';
+export { toLegacyChunk } from './legacy.js';
+export { aiSdkEncoder, fromAiSdkRequest, AI_SDK_STREAM_HEADER } from './ai-sdk.js';
+//# sourceMappingURL=index.js.map

package/dist/protocol/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/protocol/legacy.d.ts

@@ -0,0 +1,18 @@
+import type { WirePart } from './v1.js';
+/**
+ * One chunk of the stream servers before 0.6 send, and widgets before 0.6
+ * read: `data: {"content":"Hi"}`, `data: {"done":true}` and so on.
+ */
+export interface LegacyChunk {
+    content?: string;
+    done?: boolean;
+    error?: string;
+    /** Seconds. */
+    retryAfter?: number;
+    leadCaptured?: boolean;
+    leadData?: Record<string, unknown>;
+    suggestedActions?: string[];
+}
+/** The chunk an old widget expects for this part, or null for parts it has no use for. */
+export declare function toLegacyChunk(part: WirePart): LegacyChunk | null;
+//# sourceMappingURL=legacy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.d.ts","sourceRoot":"","sources":["../../src/protocol/legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI,CAkBhE"}

package/dist/protocol/legacy.js

@@ -0,0 +1,41 @@
+/** The chunk an old widget expects for this part, or null for parts it has no use for. */
+export function toLegacyChunk(part) {
+    switch (part.type) {
+        case 'text-delta':
+            return { content: part.delta };
+        case 'lead-captured':
+            return { leadCaptured: true, leadData: part.lead };
+        case 'suggestions':
+            return { suggestedActions: part.items };
+        case 'error':
+            return legacyError(part);
+        case 'finish':
+            // After an error the error chunk already went out, and after an abort
+            // nobody is listening.
+            return part.reason === 'error' || part.reason === 'aborted' ? null : { done: true };
+        default:
+            // Parts old widgets have no use for, and parts added after this was written.
+            return null;
+    }
+}
+function legacyError(part) {
+    switch (part.code) {
+        case 'rate_limited': {
+            const { retryAfterMs } = part;
+            if (retryAfterMs === undefined || !Number.isFinite(retryAfterMs) || retryAfterMs <= 0) {
+                return { error: 'rate_limit' };
+            }
+            return { error: 'rate_limit', retryAfter: Math.ceil(retryAfterMs / 1000) };
+        }
+        case 'timeout':
+            return { error: 'timeout' };
+        case 'internal_error':
+            return { error: 'internal_error' };
+        case 'invalid_request':
+            // What 0.5 servers send for a request they can't read.
+            return { error: 'Invalid request' };
+        default:
+            return { error: 'provider_error' };
+    }
+}
+//# sourceMappingURL=legacy.js.map

package/dist/protocol/legacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy.js","sourceRoot":"","sources":["../../src/protocol/legacy.ts"],"names":[],"mappings":"AAiBA,0FAA0F;AAC1F,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,YAAY;YACf,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACjC,KAAK,eAAe;YAClB,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QACrD,KAAK,aAAa;YAChB,OAAO,EAAE,gBAAgB,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAC1C,KAAK,OAAO;YACV,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,QAAQ;YACX,sEAAsE;YACtE,uBAAuB;YACvB,OAAO,IAAI,CAAC,MAAM,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACtF;YACE,6EAA6E;YAC7E,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAA0C;IAC7D,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;YAC9B,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;gBACtF,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;YACjC,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,EAAE,CAAC;QAC7E,CAAC;QACD,KAAK,SAAS;YACZ,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9B,KAAK,gBAAgB;YACnB,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QACrC,KAAK,iBAAiB;YACpB,uDAAuD;YACvD,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;QACtC;YACE,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/dist/protocol/sse.d.ts

@@ -0,0 +1,10 @@
+import type { WirePart } from './v1.js';
+/** One event: `data: <json>` and a blank line. */
+export declare function encodeSSE(part: WirePart | Record<string, unknown>): string;
+/** A comment line that keeps the connection busy while nothing else is sent. */
+export declare const SSE_PING = ": ping\n\n";
+/** Ends the stream. */
+export declare const SSE_DONE = "data: [DONE]\n\n";
+/** Standard HTTP headers for an SSE response. */
+export declare const SSE_HEADERS: Readonly<Record<string, string>>;
+//# sourceMappingURL=sse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE1E;AAED,gFAAgF;AAChF,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,uBAAuB;AACvB,eAAO,MAAM,QAAQ,qBAAqB,CAAC;AAE3C,iDAAiD;AACjD,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIvD,CAAC"}

package/dist/protocol/sse.js

@@ -0,0 +1,15 @@
+/** One event: `data: <json>` and a blank line. */
+export function encodeSSE(part) {
+    return `data: ${JSON.stringify(part)}\n\n`;
+}
+/** A comment line that keeps the connection busy while nothing else is sent. */
+export const SSE_PING = ': ping\n\n';
+/** Ends the stream. */
+export const SSE_DONE = 'data: [DONE]\n\n';
+/** Standard HTTP headers for an SSE response. */
+export const SSE_HEADERS = Object.freeze({
+    'Content-Type': 'text/event-stream; charset=utf-8',
+    'Cache-Control': 'no-cache, no-transform',
+    'X-Accel-Buffering': 'no',
+});
+//# sourceMappingURL=sse.js.map

package/dist/protocol/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/protocol/sse.ts"],"names":[],"mappings":"AAEA,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,IAAwC;IAChE,OAAO,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAErC,uBAAuB;AACvB,MAAM,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAE3C,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAqC,MAAM,CAAC,MAAM,CAAC;IACzE,cAAc,EAAE,kCAAkC;IAClD,eAAe,EAAE,wBAAwB;IACzC,mBAAmB,EAAE,IAAI;CAC1B,CAAC,CAAC"}