@chatcops/core 0.4.0 → 0.6.0

package/dist/retrieval/workers-ai-embedder.js

@@ -0,0 +1,42 @@
+import { batchSizeFor, checkedVectors, inBatches } from './http.js';
+const DEFAULT_MODEL = '@cf/baai/bge-m3';
+const DEFAULT_DIMENSIONS = 1024;
+const DEFAULT_BATCH_SIZE = 100;
+/**
+ * Embeddings from Cloudflare Workers AI via binding (`env.AI`).
+ * Calls `ai.run` in batches (default up to 100 texts), validating
+ * response shape, vector count and dimensions.
+ */
+export function workersAiEmbedder(options) {
+    if (!options?.ai || typeof options.ai.run !== 'function') {
+        throw new Error('workersAiEmbedder requires an ai binding with a run() method.');
+    }
+    const model = options.model ?? DEFAULT_MODEL;
+    const dimensions = options.dimensions ?? DEFAULT_DIMENSIONS;
+    const batchSize = batchSizeFor(options.batchSize, DEFAULT_BATCH_SIZE, DEFAULT_BATCH_SIZE);
+    const ai = options.ai;
+    return {
+        id: `workers-ai:${model}@${dimensions}`,
+        dimensions,
+        async embed(texts, _kind, embedOptions = {}) {
+            if (embedOptions.signal?.aborted) {
+                throw embedOptions.signal.reason;
+            }
+            return inBatches(texts, batchSize, async (batch) => {
+                if (embedOptions.signal?.aborted) {
+                    throw embedOptions.signal.reason;
+                }
+                const response = await ai.run(model, { text: batch });
+                if (!response || typeof response !== 'object' || !('data' in response) || !Array.isArray(response.data)) {
+                    throw new Error(`Workers AI returned an invalid response for ${model}.`);
+                }
+                const data = response.data;
+                if (data.some((embedding) => !Array.isArray(embedding) && !(embedding instanceof Float32Array))) {
+                    throw new Error(`Workers AI returned an invalid embedding for ${model}.`);
+                }
+                return checkedVectors('Workers AI', model, data, batch.length, dimensions);
+            });
+        },
+    };
+}
+//# sourceMappingURL=workers-ai-embedder.js.map

package/dist/retrieval/workers-ai-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-ai-embedder.js","sourceRoot":"","sources":["../../src/retrieval/workers-ai-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAkBpE,MAAM,aAAa,GAAG,iBAAiB,CAAC;AACxC,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,OAAO,OAAO,CAAC,EAAE,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAC;IAC5D,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;IAC1F,MAAM,EAAE,GAAG,OAAO,CAAC,EAAE,CAAC;IAEtB,OAAO;QACL,EAAE,EAAE,cAAc,KAAK,IAAI,UAAU,EAAE;QACvC,UAAU;QACV,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,EAAE;YACzC,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACjC,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;YACnC,CAAC;YACD,OAAO,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACjD,IAAI,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;oBACjC,MAAM,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;gBACnC,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACtD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,QAA+B,CAAC,IAAI,CAAC,EAAE,CAAC;oBAChI,MAAM,IAAI,KAAK,CAAC,+CAA+C,KAAK,GAAG,CAAC,CAAC;gBAC3E,CAAC;gBACD,MAAM,IAAI,GAAI,QAAgC,CAAC,IAAI,CAAC;gBACpD,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,YAAY,YAAY,CAAC,CAAC,EAAE,CAAC;oBAChG,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,GAAG,CAAC,CAAC;gBAC5E,CAAC;gBACD,OAAO,cAAc,CAAC,YAAY,EAAE,KAAK,EAAE,IAA6B,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACtG,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/retrieval/workers-ai-reranker.d.ts

@@ -0,0 +1,11 @@
+import type { Reranker } from './types.js';
+import type { WorkersAiBinding } from './workers-ai-embedder.js';
+export interface WorkersAiRerankerOptions {
+    /** The Cloudflare Workers AI binding (`env.AI`). */
+    ai: WorkersAiBinding;
+    /** Default `@cf/baai/bge-reranker-base`. */
+    model?: string;
+}
+/** Reranks retrieved chunks with Cloudflare Workers AI via the native binding. */
+export declare function workersAiReranker(options: WorkersAiRerankerOptions): Reranker;
+//# sourceMappingURL=workers-ai-reranker.d.ts.map

package/dist/retrieval/workers-ai-reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workers-ai-reranker.d.ts","sourceRoot":"","sources":["../../src/retrieval/workers-ai-reranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC,oDAAoD;IACpD,EAAE,EAAE,gBAAgB,CAAC;IACrB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,QAAQ,CAuD7E"}

package/dist/retrieval/workers-ai-reranker.js

@@ -0,0 +1,54 @@
+const DEFAULT_MODEL = '@cf/baai/bge-reranker-base';
+/** Reranks retrieved chunks with Cloudflare Workers AI via the native binding. */
+export function workersAiReranker(options) {
+    if (!options?.ai || typeof options.ai.run !== 'function') {
+        throw new Error('workersAiReranker requires an ai binding with a run() method.');
+    }
+    const model = options.model ?? DEFAULT_MODEL;
+    const ai = options.ai;
+    return {
+        async rerank(query, chunks, topN, rerankOptions = {}) {
+            if (rerankOptions.signal?.aborted)
+                throw rerankOptions.signal.reason;
+            const requestedLimit = Number.isFinite(topN) && topN > 0 ? Math.floor(topN) : 0;
+            if (!requestedLimit || !chunks.length)
+                return [];
+            const limit = Math.min(requestedLimit, chunks.length);
+            const response = await ai.run(model, {
+                query,
+                contexts: chunks.map(({ text }) => ({ text })),
+                top_k: limit,
+            });
+            if (rerankOptions.signal?.aborted)
+                throw rerankOptions.signal.reason;
+            if (!response || typeof response !== 'object' || !('response' in response) || !Array.isArray(response.response)) {
+                throw new Error(`Workers AI returned an invalid reranking response for ${model}.`);
+            }
+            const ranked = response.response.map((item) => {
+                if (!item ||
+                    typeof item !== 'object' ||
+                    !('id' in item) ||
+                    !Number.isInteger(item.id) ||
+                    !('score' in item) ||
+                    typeof item.score !== 'number' ||
+                    !Number.isFinite(item.score) ||
+                    item.id < 0 ||
+                    item.id >= chunks.length) {
+                    throw new Error(`Workers AI returned an invalid reranking result for ${model}.`);
+                }
+                return { id: item.id, score: item.score };
+            });
+            const seen = new Set();
+            for (const result of ranked) {
+                if (seen.has(result.id))
+                    throw new Error(`Workers AI returned a duplicate reranking result for ${model}.`);
+                seen.add(result.id);
+            }
+            return ranked
+                .sort((a, b) => b.score - a.score)
+                .slice(0, limit)
+                .map(({ id, score }) => ({ ...chunks[id], score }));
+        },
+    };
+}
+//# sourceMappingURL=workers-ai-reranker.js.map

package/dist/retrieval/workers-ai-reranker.js.map

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

package/dist/storage/adapt.d.ts

@@ -0,0 +1,15 @@
+import type { ConversationStore } from './types.js';
+/** A store with the message-level writes the server uses. */
+export type ConversationStoreWithAppend = ConversationStore & Required<Pick<ConversationStore, 'append' | 'updateMessage' | 'removeMessage'>>;
+/** True when the store only has the 0.4 methods (`get`, `save`, `delete`). */
+export declare function isLegacyConversationStore(store: ConversationStore): boolean;
+/**
+ * Gives any store `append`, `updateMessage` and `removeMessage`. Methods the
+ * store has are used as they are. The missing ones read the conversation,
+ * change it and save it back, one write at a time per conversation within
+ * this process. That's safe for a single server, but two instances writing
+ * the same conversation can still overwrite each other, which is why stores
+ * should implement `append` themselves.
+ */
+export declare function withAppend(store: ConversationStore): ConversationStoreWithAppend;
+//# sourceMappingURL=adapt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapt.d.ts","sourceRoot":"","sources":["../../src/storage/adapt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEnE,6DAA6D;AAC7D,MAAM,MAAM,2BAA2B,GAAG,iBAAiB,GACzD,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,eAAe,GAAG,eAAe,CAAC,CAAC,CAAC;AAElF,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,iBAAiB,GAAG,2BAA2B,CAsFhF"}

package/dist/storage/adapt.js

@@ -0,0 +1,83 @@
+import { ConflictError } from './errors.js';
+/** True when the store only has the 0.4 methods (`get`, `save`, `delete`). */
+export function isLegacyConversationStore(store) {
+    return !store.append;
+}
+/**
+ * Gives any store `append`, `updateMessage` and `removeMessage`. Methods the
+ * store has are used as they are. The missing ones read the conversation,
+ * change it and save it back, one write at a time per conversation within
+ * this process. That's safe for a single server, but two instances writing
+ * the same conversation can still overwrite each other, which is why stores
+ * should implement `append` themselves.
+ */
+export function withAppend(store) {
+    if (store.append && store.updateMessage && store.removeMessage) {
+        return store;
+    }
+    const queues = new Map();
+    function serialized(id, fn) {
+        const previous = queues.get(id) ?? Promise.resolve();
+        const run = previous.then(fn, fn);
+        const settled = run.then(() => undefined, () => undefined);
+        queues.set(id, settled);
+        void settled.then(() => {
+            if (queues.get(id) === settled)
+                queues.delete(id);
+        });
+        return run;
+    }
+    async function rewrite(id, change) {
+        const current = await store.get(id);
+        if (!current)
+            return false;
+        const next = change(current);
+        if (!next)
+            return false;
+        await store.save({ ...next, version: (current.version ?? 0) + 1, updatedAt: Date.now() });
+        return true;
+    }
+    return {
+        get: (id) => store.get(id),
+        save: (conversation) => store.save(conversation),
+        delete: (id) => store.delete(id),
+        ...(store.list ? { list: store.list.bind(store) } : {}),
+        ...(store.purge ? { purge: store.purge.bind(store) } : {}),
+        append: store.append
+            ? store.append.bind(store)
+            : (id, messages, options = {}) => serialized(id, async () => {
+                const current = await store.get(id);
+                const version = current?.version ?? 0;
+                if (options.expectedVersion !== undefined && options.expectedVersion !== version) {
+                    throw new ConflictError(id, options.expectedVersion, version);
+                }
+                const time = Date.now();
+                const metadata = options.metadata || current?.metadata ? { ...current?.metadata, ...options.metadata } : undefined;
+                await store.save({
+                    id,
+                    messages: [...(current?.messages ?? []), ...messages],
+                    ...(metadata ? { metadata } : {}),
+                    version: version + 1,
+                    createdAt: current?.createdAt ?? time,
+                    updatedAt: time,
+                });
+                return { version: version + 1 };
+            }),
+        updateMessage: store.updateMessage
+            ? store.updateMessage.bind(store)
+            : (id, message) => serialized(id, () => rewrite(id, (current) => {
+                const index = current.messages.findIndex((m) => m.id === message.id);
+                if (index === -1)
+                    return null;
+                const messages = [...current.messages];
+                messages[index] = message;
+                return { ...current, messages };
+            })),
+        removeMessage: store.removeMessage
+            ? store.removeMessage.bind(store)
+            : (id, messageId) => serialized(id, () => rewrite(id, (current) => current.messages.some((m) => m.id === messageId)
+                ? { ...current, messages: current.messages.filter((m) => m.id !== messageId) }
+                : null)),
+    };
+}
+//# sourceMappingURL=adapt.js.map

package/dist/storage/adapt.js.map

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

package/dist/storage/errors.d.ts

@@ -0,0 +1,18 @@
+export declare const CONFLICT_ERROR_CODE = "chatcops_conversation_conflict";
+/**
+ * Thrown by `ConversationStore.append` when `expectedVersion` doesn't match.
+ * Another request wrote to the conversation since it was read.
+ */
+export declare class ConflictError extends Error {
+    readonly conversationId: string;
+    readonly expectedVersion: number;
+    readonly actualVersion: number;
+    readonly code = "chatcops_conversation_conflict";
+    constructor(conversationId: string, expectedVersion: number, actualVersion: number);
+}
+/**
+ * Checks by `code` rather than `instanceof`, so it also works when a store
+ * package ends up with its own copy of `@chatcops/core`.
+ */
+export declare function isConflictError(error: unknown): error is ConflictError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,mCAAmC,CAAC;AAEpE;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAIpC,QAAQ,CAAC,cAAc,EAAE,MAAM;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM;IALhC,QAAQ,CAAC,IAAI,oCAAuB;gBAGzB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM;CAOjC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAMtE"}

package/dist/storage/errors.js

@@ -0,0 +1,28 @@
+export const CONFLICT_ERROR_CODE = 'chatcops_conversation_conflict';
+/**
+ * Thrown by `ConversationStore.append` when `expectedVersion` doesn't match.
+ * Another request wrote to the conversation since it was read.
+ */
+export class ConflictError extends Error {
+    conversationId;
+    expectedVersion;
+    actualVersion;
+    code = CONFLICT_ERROR_CODE;
+    constructor(conversationId, expectedVersion, actualVersion) {
+        super(`Conversation ${conversationId} is at version ${actualVersion}, expected ${expectedVersion}. Another request wrote to it first.`);
+        this.conversationId = conversationId;
+        this.expectedVersion = expectedVersion;
+        this.actualVersion = actualVersion;
+        this.name = 'ConflictError';
+    }
+}
+/**
+ * Checks by `code` rather than `instanceof`, so it also works when a store
+ * package ends up with its own copy of `@chatcops/core`.
+ */
+export function isConflictError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        error.code === CONFLICT_ERROR_CODE);
+}
+//# sourceMappingURL=errors.js.map

package/dist/storage/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,gCAAgC,CAAC;AAEpE;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAI3B;IACA;IACA;IALF,IAAI,GAAG,mBAAmB,CAAC;IAEpC,YACW,cAAsB,EACtB,eAAuB,EACvB,aAAqB;QAE9B,KAAK,CACH,gBAAgB,cAAc,kBAAkB,aAAa,cAAc,eAAe,sCAAsC,CACjI,CAAC;QANO,mBAAc,GAAd,cAAc,CAAQ;QACtB,oBAAe,GAAf,eAAe,CAAQ;QACvB,kBAAa,GAAb,aAAa,CAAQ;QAK9B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACb,KAA4B,CAAC,IAAI,KAAK,mBAAmB,CAC3D,CAAC;AACJ,CAAC"}

package/dist/storage/index.d.ts

@@ -0,0 +1,6 @@
+export type { AppendOptions, ChatCopsStorage, ConversationStore, ConversationSummary, CounterStore, CounterValue, EventCount, EventQuery, EventSink, KeyValueStore, ListQuery, KeywordQuery, MetadataFilter, MetadataValue, ScoredRecord, VectorQuery, VectorRecord, VectorSource, VectorStore, } from './types.js';
+export { ConflictError, isConflictError, CONFLICT_ERROR_CODE } from './errors.js';
+export { memoryStorage, type MemoryStorageOptions } from './memory.js';
+export { memoryVectors, matchesFilter, segmentWords, type MemoryVectorsOptions } from './memory-vectors.js';
+export { withAppend, isLegacyConversationStore, type ConversationStoreWithAppend } from './adapt.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAE,yBAAyB,EAAE,KAAK,2BAA2B,EAAE,MAAM,YAAY,CAAC"}

package/dist/storage/index.js

@@ -0,0 +1,5 @@
+export { ConflictError, isConflictError, CONFLICT_ERROR_CODE } from './errors.js';
+export { memoryStorage } from './memory.js';
+export { memoryVectors, matchesFilter, segmentWords } from './memory-vectors.js';
+export { withAppend, isLegacyConversationStore } from './adapt.js';
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,aAAa,EAA6B,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAA6B,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,UAAU,EAAE,yBAAyB,EAAoC,MAAM,YAAY,CAAC"}

package/dist/storage/memory-vectors.d.ts

@@ -0,0 +1,22 @@
+import type { MetadataFilter, MetadataValue, VectorStore } from './types.js';
+export interface MemoryVectorsOptions {
+    /** The length of every vector, set by the embedder (1024 for the default). */
+    dimensions: number;
+    /** Upserts that would go past this many records fail. Default 50,000. */
+    maxRecords?: number;
+}
+/**
+ * The words in a text, lowercased. `Intl.Segmenter` finds word boundaries in
+ * languages written without spaces (Japanese, Chinese, Thai), where splitting
+ * on whitespace would make a whole sentence one word.
+ */
+export declare function segmentWords(text: string): string[];
+/**
+ * Vectors kept in this process, searched by comparing against every record.
+ * Fine for tests, local development and a few thousand chunks; use a store
+ * package with a vector index for more.
+ */
+export declare function memoryVectors(options: MemoryVectorsOptions): VectorStore;
+/** Whether metadata passes a filter, by the rules on `MetadataFilter`. */
+export declare function matchesFilter(metadata: Record<string, MetadataValue> | undefined, filter: MetadataFilter): boolean;
+//# sourceMappingURL=memory-vectors.d.ts.map

package/dist/storage/memory-vectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-vectors.d.ts","sourceRoot":"","sources":["../../src/storage/memory-vectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EAIb,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAMnD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,WAAW,CAMxE;AA+FD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAMlH"}

package/dist/storage/memory-vectors.js

@@ -0,0 +1,140 @@
+// BM25's usual constants.
+const K1 = 1.2;
+const B = 0.75;
+const segmenter = new Intl.Segmenter(undefined, { granularity: 'word' });
+/**
+ * The words in a text, lowercased. `Intl.Segmenter` finds word boundaries in
+ * languages written without spaces (Japanese, Chinese, Thai), where splitting
+ * on whitespace would make a whole sentence one word.
+ */
+export function segmentWords(text) {
+    const words = [];
+    for (const part of segmenter.segment(text.normalize('NFKC').toLowerCase())) {
+        if (part.isWordLike)
+            words.push(part.segment);
+    }
+    return words;
+}
+/**
+ * Vectors kept in this process, searched by comparing against every record.
+ * Fine for tests, local development and a few thousand chunks; use a store
+ * package with a vector index for more.
+ */
+export function memoryVectors(options) {
+    const { dimensions } = options;
+    if (!Number.isInteger(dimensions) || dimensions < 1) {
+        throw new Error(`memoryVectors needs dimensions as a positive whole number, got ${dimensions}.`);
+    }
+    return new MemoryVectorStore(dimensions, options.maxRecords ?? 50_000);
+}
+class MemoryVectorStore {
+    dimensions;
+    maxRecords;
+    records = new Map();
+    constructor(dimensions, maxRecords) {
+        this.dimensions = dimensions;
+        this.maxRecords = maxRecords;
+    }
+    async upsert(records) {
+        for (const record of records)
+            this.checkVector(record.vector, `record ${record.id}`);
+        const added = new Set(records.map((record) => record.id).filter((id) => !this.records.has(id))).size;
+        if (this.records.size + added > this.maxRecords) {
+            throw new Error(`memoryVectors holds at most ${this.maxRecords} records, and this upsert would make ${this.records.size + added}. Use a store package for an index this size.`);
+        }
+        for (const { vector, ...rest } of records) {
+            const copy = Float32Array.from(vector);
+            const words = segmentWords(rest.text);
+            const terms = new Map();
+            for (const word of words)
+                terms.set(word, (terms.get(word) ?? 0) + 1);
+            this.records.set(rest.id, {
+                record: structuredClone(rest),
+                vector: copy,
+                norm: length(copy),
+                terms,
+                length: words.length,
+            });
+        }
+    }
+    async query({ vector, topK, filter }) {
+        this.checkVector(vector, 'the query');
+        const norm = length(vector);
+        const scored = [];
+        for (const stored of this.matching(filter)) {
+            let dot = 0;
+            for (let i = 0; i < vector.length; i++)
+                dot += vector[i] * stored.vector[i];
+            scored.push([stored, norm === 0 || stored.norm === 0 ? 0 : dot / (norm * stored.norm)]);
+        }
+        return best(scored, topK);
+    }
+    async keywordQuery({ text, topK, filter }) {
+        const words = [...new Set(segmentWords(text))];
+        const candidates = [...this.matching(filter)];
+        if (words.length === 0 || candidates.length === 0)
+            return [];
+        const averageLength = candidates.reduce((sum, stored) => sum + stored.length, 0) / candidates.length || 1;
+        const scored = [];
+        const idf = new Map(words.map((word) => {
+            const withWord = candidates.filter((stored) => stored.terms.has(word)).length;
+            return [word, Math.log(1 + (candidates.length - withWord + 0.5) / (withWord + 0.5))];
+        }));
+        for (const stored of candidates) {
+            let score = 0;
+            for (const word of words) {
+                const count = stored.terms.get(word);
+                if (!count)
+                    continue;
+                score += (idf.get(word) ?? 0) * ((count * (K1 + 1)) / (count + K1 * (1 - B + (B * stored.length) / averageLength)));
+            }
+            if (score > 0)
+                scored.push([stored, score]);
+        }
+        return best(scored, topK);
+    }
+    async deleteBySource(sourceId) {
+        for (const [id, stored] of this.records) {
+            if (stored.record.source.id === sourceId)
+                this.records.delete(id);
+        }
+    }
+    *matching(filter) {
+        for (const stored of this.records.values()) {
+            if (!filter || matchesFilter(stored.record.metadata, filter))
+                yield stored;
+        }
+    }
+    checkVector(vector, what) {
+        if (vector.length !== this.dimensions) {
+            throw new Error(`The vector for ${what} has ${vector.length} dimensions, but this store holds ${this.dimensions}.`);
+        }
+        if (!vector.every(Number.isFinite))
+            throw new Error(`The vector for ${what} has a value that isn't a finite number.`);
+    }
+}
+function length(vector) {
+    let sum = 0;
+    for (const value of vector)
+        sum += value * value;
+    return Math.sqrt(sum);
+}
+/** Whether metadata passes a filter, by the rules on `MetadataFilter`. */
+export function matchesFilter(metadata, filter) {
+    return Object.entries(filter).every(([key, wanted]) => {
+        if (!metadata || !Object.hasOwn(metadata, key))
+            return false;
+        const value = metadata[key];
+        return Array.isArray(wanted) ? wanted.includes(value) : wanted === value;
+    });
+}
+/** The `topK` highest scores, best first, ties broken by id so results are stable. */
+function best(scored, topK) {
+    if (!(topK >= 1))
+        return [];
+    return scored
+        .sort(([a, x], [b, y]) => y - x || (a.record.id < b.record.id ? -1 : 1))
+        .slice(0, Math.floor(topK))
+        .map(([stored, score]) => ({ ...structuredClone(stored.record), score }));
+}
+//# sourceMappingURL=memory-vectors.js.map

package/dist/storage/memory-vectors.js.map

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

package/dist/storage/memory.d.ts

@@ -0,0 +1,24 @@
+import type { ChatCopsStorage } from './types.js';
+export interface MemoryStorageOptions {
+    /** Least recently used conversations go first past this. Default 1000. */
+    maxConversations?: number;
+    /** Conversations not touched for this long are dropped. Default 7 days. */
+    conversationTtlMs?: number;
+    /** Counters and keys each, past which expired ones are swept and then the oldest dropped. Default 10,000. */
+    maxKeys?: number;
+    /** Oldest events go first past this. Default 10,000. */
+    maxEvents?: number;
+    /** Clock, for tests. */
+    now?: () => number;
+}
+/**
+ * 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 declare function memoryStorage(options?: MemoryStorageOptions): ChatCopsStorage;
+//# sourceMappingURL=memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/storage/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,eAAe,EAUhB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6GAA6G;IAC7G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAKD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,eAAe,CAYjF"}