@chatcops/core 0.4.0 → 0.6.0

package/dist/storage/memory.js

@@ -0,0 +1,265 @@
+import { ConflictError } from './errors.js';
+const DAY_MS = 24 * 60 * 60 * 1000;
+const HOUR_MS = 60 * 60 * 1000;
+/**
+ * Keeps everything in this process. Fine for local development and a single
+ * long-running server; on serverless each instance has its own copy, so
+ * conversations and limits don't carry over between requests.
+ *
+ * Every capability is bounded, and nothing runs on a timer: expired entries
+ * are dropped when they're next read or when a map reaches its cap. Objects
+ * are copied in and out, so callers can't change stored data by accident.
+ */
+export function memoryStorage(options = {}) {
+    const now = options.now ?? Date.now;
+    return {
+        conversations: new MemoryConversationStore(options.maxConversations ?? 1000, options.conversationTtlMs ?? 7 * DAY_MS, now),
+        counters: new MemoryCounterStore(options.maxKeys ?? 10_000, now),
+        kv: new MemoryKeyValueStore(options.maxKeys ?? 10_000, now),
+        events: new MemoryEventSink(options.maxEvents ?? 10_000),
+    };
+}
+class MemoryConversationStore {
+    maxConversations;
+    ttlMs;
+    now;
+    records = new Map();
+    constructor(maxConversations, ttlMs, now) {
+        this.maxConversations = maxConversations;
+        this.ttlMs = ttlMs;
+        this.now = now;
+    }
+    async get(id) {
+        const record = this.read(id);
+        return record ? structuredClone(record) : null;
+    }
+    async save(conversation) {
+        const current = this.read(conversation.id);
+        this.write({
+            ...structuredClone(conversation),
+            version: (current?.version ?? 0) + 1,
+            updatedAt: this.now(),
+        });
+    }
+    async delete(id) {
+        this.records.delete(id);
+    }
+    async append(id, messages, options = {}) {
+        const current = this.read(id);
+        const version = current?.version ?? 0;
+        if (options.expectedVersion !== undefined && options.expectedVersion !== version) {
+            throw new ConflictError(id, options.expectedVersion, version);
+        }
+        const time = this.now();
+        const metadata = options.metadata || current?.metadata ? { ...current?.metadata, ...structuredClone(options.metadata) } : undefined;
+        this.write({
+            id,
+            messages: [...(current?.messages ?? []), ...structuredClone(messages)],
+            ...(metadata ? { metadata } : {}),
+            version: version + 1,
+            createdAt: current?.createdAt ?? time,
+            updatedAt: time,
+        });
+        return { version: version + 1 };
+    }
+    async updateMessage(id, message) {
+        const current = this.read(id);
+        const index = current?.messages.findIndex((m) => m.id === message.id) ?? -1;
+        if (!current || index === -1)
+            return false;
+        const messages = [...current.messages];
+        messages[index] = structuredClone(message);
+        this.write({ ...current, messages, version: (current.version ?? 0) + 1, updatedAt: this.now() });
+        return true;
+    }
+    async removeMessage(id, messageId) {
+        const current = this.read(id);
+        if (!current?.messages.some((m) => m.id === messageId))
+            return false;
+        this.write({
+            ...current,
+            messages: current.messages.filter((m) => m.id !== messageId),
+            version: (current.version ?? 0) + 1,
+            updatedAt: this.now(),
+        });
+        return true;
+    }
+    async list(query) {
+        const all = [...this.records.values()]
+            .filter((c) => !this.expired(c))
+            .filter((c) => query.updatedAfter === undefined || c.updatedAt > query.updatedAfter)
+            .sort((a, b) => b.updatedAt - a.updatedAt || (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+        let start = 0;
+        if (query.cursor) {
+            const index = all.findIndex((c) => cursorOf(c) === query.cursor);
+            start = index === -1 ? all.length : index + 1;
+        }
+        const page = all.slice(start, start + query.limit);
+        const items = page.map((c) => ({
+            id: c.id,
+            createdAt: c.createdAt,
+            updatedAt: c.updatedAt,
+            messageCount: c.messages.length,
+            ...(c.metadata ? { metadata: structuredClone(c.metadata) } : {}),
+        }));
+        const last = page.at(-1);
+        return start + page.length < all.length && last ? { items, cursor: cursorOf(last) } : { items };
+    }
+    async purge(before) {
+        let removed = 0;
+        for (const [id, conversation] of this.records) {
+            if (conversation.updatedAt < before) {
+                this.records.delete(id);
+                removed++;
+            }
+        }
+        return removed;
+    }
+    /** Returns the live record (not a copy) and marks it as recently used. */
+    read(id) {
+        const record = this.records.get(id);
+        if (!record)
+            return undefined;
+        if (this.expired(record)) {
+            this.records.delete(id);
+            return undefined;
+        }
+        this.records.delete(id);
+        this.records.set(id, record);
+        return record;
+    }
+    write(conversation) {
+        this.records.delete(conversation.id);
+        this.records.set(conversation.id, conversation);
+        while (this.records.size > this.maxConversations) {
+            const oldest = this.records.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.records.delete(oldest);
+        }
+    }
+    expired(conversation) {
+        return this.now() - conversation.updatedAt > this.ttlMs;
+    }
+}
+function cursorOf(conversation) {
+    return `${conversation.updatedAt}:${conversation.id}`;
+}
+/** A map whose entries expire, swept when it reaches its cap. */
+class ExpiringMap {
+    maxKeys;
+    now;
+    entries = new Map();
+    constructor(maxKeys, now) {
+        this.maxKeys = maxKeys;
+        this.now = now;
+    }
+    get(key) {
+        const entry = this.entries.get(key);
+        if (entry && entry.expiresAt <= this.now()) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        return entry;
+    }
+    set(key, entry) {
+        this.entries.delete(key);
+        this.entries.set(key, entry);
+        if (this.entries.size <= this.maxKeys)
+            return;
+        const time = this.now();
+        for (const [k, e] of this.entries) {
+            if (e.expiresAt <= time)
+                this.entries.delete(k);
+        }
+        while (this.entries.size > this.maxKeys) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.entries.delete(oldest);
+        }
+    }
+    delete(key) {
+        this.entries.delete(key);
+    }
+}
+class MemoryCounterStore {
+    now;
+    counters;
+    constructor(maxKeys, now) {
+        this.now = now;
+        this.counters = new ExpiringMap(maxKeys, now);
+    }
+    async increment(key, by, ttlMs) {
+        const current = this.counters.get(key);
+        const entry = current
+            ? { value: current.value + by, expiresAt: current.expiresAt }
+            : { value: by, expiresAt: this.now() + ttlMs };
+        this.counters.set(key, entry);
+        return { ...entry };
+    }
+    async get(key) {
+        const entry = this.counters.get(key);
+        return entry ? { ...entry } : null;
+    }
+}
+const NO_EXPIRY = Number.POSITIVE_INFINITY;
+class MemoryKeyValueStore {
+    now;
+    values;
+    constructor(maxKeys, now) {
+        this.now = now;
+        this.values = new ExpiringMap(maxKeys, now);
+    }
+    async get(key) {
+        const entry = this.values.get(key);
+        return entry ? structuredClone(entry.value) : null;
+    }
+    async set(key, value, options = {}) {
+        this.values.set(key, { value: structuredClone(value), expiresAt: this.expiry(options.ttlMs) });
+    }
+    async setIfAbsent(key, value, options = {}) {
+        if (this.values.get(key))
+            return false;
+        this.values.set(key, { value: structuredClone(value), expiresAt: this.expiry(options.ttlMs) });
+        return true;
+    }
+    async delete(key) {
+        this.values.delete(key);
+    }
+    expiry(ttlMs) {
+        return ttlMs === undefined ? NO_EXPIRY : this.now() + ttlMs;
+    }
+}
+class MemoryEventSink {
+    maxEvents;
+    events = [];
+    constructor(maxEvents) {
+        this.maxEvents = maxEvents;
+    }
+    async write(events) {
+        this.events.push(...structuredClone(events));
+        if (this.events.length > this.maxEvents) {
+            this.events = this.events.slice(-this.maxEvents);
+        }
+    }
+    async query(query) {
+        const size = query.groupBy === 'hour' ? HOUR_MS : DAY_MS;
+        const counts = new Map();
+        for (const event of this.events) {
+            if (event.timestamp < query.from || event.timestamp >= query.to)
+                continue;
+            if (query.type && event.type !== query.type)
+                continue;
+            const bucket = Math.floor(event.timestamp / size) * size;
+            const key = `${bucket}:${event.type}`;
+            const count = counts.get(key);
+            if (count)
+                count.count++;
+            else
+                counts.set(key, { bucket, type: event.type, count: 1 });
+        }
+        return [...counts.values()].sort((a, b) => a.bucket - b.bucket || (a.type < b.type ? -1 : 1));
+    }
+}
+//# sourceMappingURL=memory.js.map

package/dist/storage/memory.js.map

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

package/dist/storage/types.d.ts

@@ -0,0 +1,188 @@
+import type { AnalyticsEvent, ChatMessage, Conversation } from '../types.js';
+export interface AppendOptions {
+    /**
+     * The version the caller last read. When the stored conversation has moved
+     * on, the append fails with a `ConflictError` and writes nothing. A
+     * conversation that doesn't exist yet is at version 0.
+     */
+    expectedVersion?: number;
+    /** Merged into the conversation's metadata (shallow, new keys win). */
+    metadata?: Record<string, unknown>;
+}
+export interface ConversationSummary {
+    id: string;
+    createdAt: number;
+    updatedAt: number;
+    messageCount: number;
+    metadata?: Record<string, unknown>;
+}
+export interface ListQuery {
+    limit: number;
+    /** From the previous page's `cursor`. */
+    cursor?: string;
+    /** Only conversations updated after this time (ms). */
+    updatedAfter?: number;
+}
+/**
+ * Where conversations live.
+ *
+ * `get`, `save` and `delete` are the 0.4 interface and still all a store
+ * needs. A store that also has `append` lets two server instances write to the
+ * same conversation without losing messages; without it the server reads,
+ * changes and writes back the whole conversation, and warns once.
+ */
+export interface ConversationStore {
+    get(id: string): Promise<Conversation | null>;
+    /** Replaces the whole conversation. */
+    save(conversation: Conversation): Promise<void>;
+    delete(id: string): Promise<void>;
+    /**
+     * Adds messages at the end, creating the conversation when it doesn't
+     * exist, and returns the new version. Atomic: concurrent appends never
+     * lose a message.
+     */
+    append?(id: string, messages: ChatMessage[], options?: AppendOptions): Promise<{
+        version: number;
+    }>;
+    /** Replaces the message with the same id. Resolves `false` when there is none. */
+    updateMessage?(id: string, message: ChatMessage): Promise<boolean>;
+    /** Resolves `false` when there is no such message. */
+    removeMessage?(id: string, messageId: string): Promise<boolean>;
+    /** Most recently updated first. */
+    list?(query: ListQuery): Promise<{
+        items: ConversationSummary[];
+        cursor?: string;
+    }>;
+    /** Deletes conversations last updated before `before` (ms) and returns how many. */
+    purge?(before: number): Promise<number>;
+}
+export interface CounterValue {
+    value: number;
+    /** When the counter resets (ms). */
+    expiresAt: number;
+}
+/**
+ * Atomic counters that reset after a while. Rate limits and token budgets
+ * are built on this, so it has to be exact under concurrent requests.
+ */
+export interface CounterStore {
+    /**
+     * Adds `by` and returns the new value. A missing or expired counter starts
+     * from zero and expires `ttlMs` from now; later increments keep that expiry.
+     */
+    increment(key: string, by: number, ttlMs: number): Promise<CounterValue>;
+    get(key: string): Promise<CounterValue | null>;
+}
+export interface KeyValueStore {
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, options?: {
+        ttlMs?: number;
+    }): Promise<void>;
+    /** Sets the value only when the key is missing or expired. Resolves whether it did. */
+    setIfAbsent?(key: string, value: unknown, options?: {
+        ttlMs?: number;
+    }): Promise<boolean>;
+    delete(key: string): Promise<void>;
+}
+export interface EventQuery {
+    type?: string;
+    /** Start time (ms), inclusive. */
+    from: number;
+    /** End time (ms), exclusive. */
+    to: number;
+    groupBy?: 'day' | 'hour';
+}
+export interface EventCount {
+    /** Start of the bucket (ms, UTC). */
+    bucket: number;
+    type: string;
+    count: number;
+}
+export interface EventSink {
+    write(events: AnalyticsEvent[]): Promise<void>;
+    query?(query: EventQuery): Promise<EventCount[]>;
+}
+export type MetadataValue = string | number | boolean;
+/**
+ * Which records a search may return. Every key has to match: a value matches
+ * a record whose metadata has exactly that value (same type), and an array
+ * matches any of its values. A record without the key never matches.
+ *
+ * ```ts
+ * { locale: 'de', collection: ['docs', 'pricing'] }
+ * ```
+ */
+export type MetadataFilter = Record<string, MetadataValue | MetadataValue[]>;
+/** The page or document a chunk came from. */
+export interface VectorSource {
+    /** Groups a page's chunks, so they can be replaced or removed together. */
+    id: string;
+    url: string;
+    title?: string;
+    /** The heading path inside the page, such as `Pricing > Enterprise`. */
+    section?: string;
+    /** When the page last changed (ms). */
+    updatedAt?: number;
+}
+/** One chunk of text and its embedding. */
+export interface VectorRecord {
+    id: string;
+    vector: Float32Array;
+    text: string;
+    source: VectorSource;
+    metadata?: Record<string, MetadataValue>;
+}
+/** A search result: the record without its vector, and how well it matched. */
+export interface ScoredRecord {
+    id: string;
+    text: string;
+    source: VectorSource;
+    metadata?: Record<string, MetadataValue>;
+    /**
+     * Higher is better. `query` scores are cosine similarity (-1 to 1);
+     * `keywordQuery` scores depend on the store (BM25 in memory). The two
+     * aren't on the same scale, so hybrid search combines them by rank.
+     */
+    score: number;
+}
+export interface VectorQuery {
+    vector: Float32Array;
+    topK: number;
+    filter?: MetadataFilter;
+}
+export interface KeywordQuery {
+    text: string;
+    topK: number;
+    filter?: MetadataFilter;
+}
+/**
+ * Embedded chunks for retrieval. Every vector has `dimensions` numbers; a
+ * vector of another length is an error, both stored and searched.
+ */
+export interface VectorStore {
+    readonly dimensions: number;
+    /** Adds records, replacing any with the same id. */
+    upsert(records: VectorRecord[]): Promise<void>;
+    /** The `topK` nearest records by cosine similarity, best first. */
+    query(query: VectorQuery): Promise<ScoredRecord[]>;
+    /** Full-text search, for hybrid retrieval. Best first. */
+    keywordQuery?(query: KeywordQuery): Promise<ScoredRecord[]>;
+    /** Removes every record from that source. */
+    deleteBySource(sourceId: string): Promise<void>;
+}
+/**
+ * Everything the server stores. Only `conversations` is required. Without
+ * `counters`, rate limits are kept per process; without `kv`, per-conversation
+ * locks are too.
+ */
+export interface ChatCopsStorage {
+    conversations: ConversationStore;
+    counters?: CounterStore;
+    kv?: KeyValueStore;
+    events?: EventSink;
+    /** Embedded chunks, for answering from the site's own pages. */
+    vectors?: VectorStore;
+    /** Closes connections, for scripts and tests. */
+    close?(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

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

package/dist/storage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

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

package/dist/testing/conformance.d.ts

@@ -0,0 +1,30 @@
+import type { ChatCopsStorage } from '../storage/types.js';
+export interface StorageConformanceOptions {
+    /**
+     * TTL used by the expiry checks, in ms. The checks wait about twice this.
+     * Default 150. Raise it for stores that round expiry to seconds.
+     */
+    ttlMs?: number;
+    /**
+     * Checks to leave out, for backends that can't meet them in a test run. For
+     * example Workers KV has a 60 second minimum TTL, so `'kv-ttl'`.
+     */
+    skip?: Array<'kv-ttl' | 'counter-ttl' | 'conversation-concurrency' | 'counter-concurrency' | 'vector-keyword-cjk'>;
+}
+/**
+ * The behavior every ChatCops store must have. Call it from a test file with a
+ * factory for your storage:
+ *
+ * ```ts
+ * import { runStorageConformance } from '@chatcops/core/testing';
+ * runStorageConformance('redis', () => redisStorage({ redis }));
+ * ```
+ *
+ * Optional capabilities (`counters`, `kv`, `events`, `vectors`, `list`,
+ * `purge`, `setIfAbsent`, `query`, `keywordQuery`) are checked only when the
+ * storage has them. The vector checks need at least 4 dimensions.
+ * `conversations.append`, `updateMessage` and `removeMessage` are required
+ * here: a store without them only gets the 0.4 behavior.
+ */
+export declare function runStorageConformance(name: string, factory: () => ChatCopsStorage | Promise<ChatCopsStorage>, options?: StorageConformanceOptions): void;
+//# sourceMappingURL=conformance.d.ts.map

package/dist/testing/conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAA6B,MAAM,qBAAqB,CAAC;AAGtF,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,CACV,QAAQ,GAAG,aAAa,GAAG,0BAA0B,GAAG,qBAAqB,GAAG,oBAAoB,CACrG,CAAC;CACH;AAsCD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,EACzD,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAyeN"}