@chatcops/core 0.4.0 → 0.6.0

package/dist/conversation/manager.js

@@ -1,56 +1,132 @@
-import { MemoryStore } from './store.js';
+import { consoleLogger } from '../logger.js';
+import { warnOnce } from '../providers/base.js';
+import { DEFAULT_MAX_HISTORY_TOKENS, trimHistory } from '../providers/history.js';
+import { isLegacyConversationStore, withAppend } from '../storage/adapt.js';
+import { memoryStorage } from '../storage/memory.js';
+/**
+ * Reads and writes conversations through a store. Writes are appends, so two
+ * server instances answering the same conversation don't overwrite each
+ * other's messages, as long as the store implements `append`.
+ */
 export class ConversationManager {
     store;
+    kv;
     maxMessages;
-    constructor(options) {
-        this.store = options?.store ?? new MemoryStore();
-        this.maxMessages = options?.maxMessages ?? 100;
+    maxHistoryTokens;
+    localTurns = new Set();
+    constructor(options = {}) {
+        const store = options.storage?.conversations ?? options.store ?? memoryStorage().conversations;
+        if (isLegacyConversationStore(store)) {
+            warnOnce(options.logger ?? consoleLogger(), 'legacy-conversation-store', "The conversation store has no append(), so each write saves the whole conversation. That's fine on one server, but two instances writing the same conversation can lose a message. The store packages (@chatcops/store-*) have append().");
+        }
+        this.store = withAppend(store);
+        this.kv = options.storage?.kv;
+        this.maxMessages = options.maxMessages ?? 100;
+        this.maxHistoryTokens = options.maxHistoryTokens ?? DEFAULT_MAX_HISTORY_TOKENS;
     }
+    /**
+     * The stored conversation, or a new empty one. A new conversation isn't
+     * saved until its first message is added.
+     */
     async getOrCreate(id) {
         const existing = await this.store.get(id);
         if (existing)
             return existing;
-        const conversation = {
-            id,
-            messages: [],
-            createdAt: Date.now(),
-            updatedAt: Date.now(),
-        };
-        await this.store.save(conversation);
-        return conversation;
+        const time = Date.now();
+        return { id, messages: [], version: 0, createdAt: time, updatedAt: time };
     }
+    /** Adds one message and returns the conversation as stored afterwards. */
     async addMessage(conversationId, message) {
-        const conversation = await this.getOrCreate(conversationId);
-        conversation.messages.push(message);
-        conversation.updatedAt = Date.now();
-        if (conversation.messages.length > this.maxMessages) {
-            const systemMessages = conversation.messages.filter((m) => m.role === 'system');
-            let recentMessages = conversation.messages
-                .filter((m) => m.role !== 'system')
-                .slice(-(this.maxMessages - systemMessages.length));
-            // Never start the kept history with an assistant turn; some providers
-            // (Gemini) reject a conversation that doesn't open with the user.
-            const firstUser = recentMessages.findIndex((m) => m.role === 'user');
-            recentMessages = firstUser === -1 ? [] : recentMessages.slice(firstUser);
-            conversation.messages = [...systemMessages, ...recentMessages];
-        }
-        await this.store.save(conversation);
-        return conversation;
+        await this.appendMessages(conversationId, [message]);
+        return this.getOrCreate(conversationId);
+    }
+    /**
+     * Adds messages atomically and returns the new version. Pass
+     * `expectedVersion` to fail with a `ConflictError` when another request
+     * wrote first.
+     */
+    async appendMessages(conversationId, messages, options) {
+        const result = await this.store.append(conversationId, messages, options);
+        await this.enforceMaxMessages(conversationId);
+        return result;
+    }
+    /** Replaces a stored message with the same id. Resolves `false` when there's none. */
+    updateMessage(conversationId, message) {
+        return this.store.updateMessage(conversationId, message);
     }
     async getMessages(conversationId) {
         const conversation = await this.store.get(conversationId);
         return conversation?.messages ?? [];
     }
+    /**
+     * The messages to send to the model: user and assistant turns within the
+     * token budget, keeping the first user message and the newest ones.
+     */
+    async getHistory(conversationId) {
+        return trimHistory(await this.getMessages(conversationId), this.maxHistoryTokens);
+    }
     async removeMessage(conversationId, messageId) {
-        const conversation = await this.store.get(conversationId);
-        if (!conversation)
-            return;
-        conversation.messages = conversation.messages.filter((message) => message.id !== messageId);
-        conversation.updatedAt = Date.now();
-        await this.store.save(conversation);
+        await this.store.removeMessage(conversationId, messageId);
     }
     async deleteConversation(id) {
         await this.store.delete(id);
     }
+    /**
+     * Makes sure only one reply is generated for a conversation at a time.
+     * Resolves a release function, or `null` when another turn holds the lock.
+     * The lock expires after `ttlMs` in case a server dies mid-turn.
+     *
+     * With `storage.kv` (and `setIfAbsent`) the lock holds across instances;
+     * otherwise only within this process.
+     */
+    async acquireTurn(conversationId, ttlMs = 120_000) {
+        const key = `turn:${conversationId}`;
+        const kv = this.kv;
+        if (kv?.setIfAbsent) {
+            const token = crypto.randomUUID();
+            if (!(await kv.setIfAbsent(key, token, { ttlMs })))
+                return null;
+            let released = false;
+            return async () => {
+                if (released)
+                    return;
+                released = true;
+                // Only delete the lock if it's still ours; it may have expired and
+                // been taken by another turn.
+                if ((await kv.get(key)) === token)
+                    await kv.delete(key);
+            };
+        }
+        if (this.localTurns.has(key))
+            return null;
+        this.localTurns.add(key);
+        const timer = setTimeout(() => this.localTurns.delete(key), ttlMs);
+        timer.unref?.();
+        let released = false;
+        return async () => {
+            if (released)
+                return;
+            released = true;
+            clearTimeout(timer);
+            this.localTurns.delete(key);
+        };
+    }
+    /**
+     * Removes the oldest non-system messages past `maxMessages`, one atomic
+     * remove each, then any assistant turns left at the front, so the stored
+     * history still opens with the visitor (Gemini rejects one that doesn't).
+     */
+    async enforceMaxMessages(conversationId) {
+        const messages = await this.getMessages(conversationId);
+        if (messages.length <= this.maxMessages)
+            return;
+        const turns = messages.filter((m) => m.role !== 'system');
+        let cut = messages.length - this.maxMessages;
+        while (cut < turns.length && turns[cut].role === 'assistant')
+            cut++;
+        for (const message of turns.slice(0, cut)) {
+            await this.store.removeMessage(conversationId, message.id);
+        }
+    }
 }
 //# sourceMappingURL=manager.js.map

package/dist/conversation/manager.js.map

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

package/dist/conversation/store.d.ts

@@ -1,9 +1,10 @@
 import type { Conversation } from '../types.js';
-export interface ConversationStore {
-    get(id: string): Promise<Conversation | null>;
-    save(conversation: Conversation): Promise<void>;
-    delete(id: string): Promise<void>;
-}
+import type { ConversationStore } from '../storage/types.js';
+export type { ConversationStore } from '../storage/types.js';
+/**
+ * The 0.4 in-memory store. Unbounded and without `append`; `memoryStorage()`
+ * replaces it.
+ */
 export declare class MemoryStore implements ConversationStore {
     private store;
     get(id: string): Promise<Conversation | null>;

package/dist/conversation/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/conversation/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,qBAAa,WAAY,YAAW,iBAAiB;IACnD,OAAO,CAAC,KAAK,CAAmC;IAE1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI7C,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/conversation/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;GAGG;AACH,qBAAa,WAAY,YAAW,iBAAiB;IACnD,OAAO,CAAC,KAAK,CAAmC;IAE1C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAI7C,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/conversation/store.js

@@ -1,3 +1,7 @@
+/**
+ * The 0.4 in-memory store. Unbounded and without `append`; `memoryStorage()`
+ * replaces it.
+ */
 export class MemoryStore {
     store = new Map();
     async get(id) {

package/dist/conversation/store.js.map

@@ -1 +1 @@
-{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/conversation/store.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,WAAW;IACd,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAA0B;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/conversation/store.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEhD,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAA0B;QACnC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/index.d.ts

@@ -1,13 +1,30 @@
-export type { ChatMessage, Conversation, ChatRequest, ChatResponse, PageContext, LeadData, ToolParameter, ToolDefinition, ToolResult, ProviderToolCall, ProviderToolExecutor, WebhookConfig, ProviderConfig, ProviderEffort, ProviderChatParams, AnalyticsEvent, LocaleStrings, } from './types.js';
-export type { AIProvider, NormalizedMessage } from './providers/index.js';
-export { createProvider, normalizeHistory, ClaudeProvider, OpenAIProvider, GeminiProvider } from './providers/index.js';
+export type { ChatMessage, Conversation, ChatRequest, ChatResponse, PageContext, LeadData, ToolParameter, ToolDefinition, ToolAnnotations, ToolContext, ToolResult, ProviderToolCall, ProviderToolExecutor, WebhookConfig, ProviderConfig, ProviderEffort, ProviderChatParams, AnalyticsEvent, LocaleStrings, TokenUsage, ProviderMetadata, JSONSchema, ToolExecutor, ToolCallState, MessagePart, TextPart, ReasoningPart, SourcePart, ToolCallPart, ToolResultPart, LeadCapturedPart, HandoffPart, } from './types.js';
+export { partsOf, messageText } from './parts.js';
+export { consoleLogger, jsonLogger, silentLogger, type Logger, type LogFields, type JsonLoggerOptions } from './logger.js';
+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 type { AiSdkChunk, LegacyChunk, WirePart, WirePartType, WireErrorCode, WireFinishReason, WireAgent, WireErrorBody, ChatRequestV1, ClientToolManifest, } from './protocol/index.js';
+export type { AIProvider, NormalizedMessage, NormalizedTurn, TurnPart, FinishReason, ProviderEvent, ProviderStepParams, } from './providers/index.js';
+export { createProvider, isAIProvider, normalizeHistory, normalizeTurns, trimHistory, estimateTokens } from './providers/index.js';
+export { registerProvider, type ProviderFactory } from './providers/registry.js';
+export { toolInputSchema, legacyParametersToSchema, validateTools, ToolDefinitionError } from './providers/index.js';
+export { runTurn, DEFAULT_MAX_STEPS, toolRegistry, executorRegistry, toolOutput, MAX_TOOL_OUTPUT_CHARS, RefusalError, ContentFilterError, MaxStepsError, } from './agent/index.js';
+export type { RunTurnOptions, TurnResult, ToolRegistry, ToolRunContext } from './agent/index.js';
 export type { ChatTool, LeadCaptureCallback } from './tools/index.js';
 export { toolToDefinition, LeadCaptureTool } from './tools/index.js';
 export type { KnowledgeSource, FAQPair } from './knowledge/index.js';
 export { TextKnowledgeSource, FAQKnowledgeSource } from './knowledge/index.js';
+export type { Embedder, RetrievedChunk, RetrievalQuery, Retriever, Reranker, OpenAIEmbedderOptions, GeminiEmbedderOptions, VoyageEmbedderOptions, VoyageRerankerOptions, CohereRerankerOptions, WorkersAiBinding, WorkersAiEmbedderOptions, WorkersAiRerankerOptions, RetrieverKnowledgeOptions, VectorRetrieverOptions, HybridRetrieverOptions, } from './retrieval/index.js';
+export { openaiEmbedder, geminiEmbedder, voyageEmbedder, voyageReranker, cohereReranker, workersAiEmbedder, workersAiReranker, retrieverKnowledge, formatSources, uniqueChunks, SOURCES_INSTRUCTION, vectorRetriever, hybridRetriever, reciprocalRankFusion, retrievalQueryText, CitationParser, parseCitations, sourcePart, sourcesContext, CITE_INSTRUCTION, NATIVE_SOURCES_INSTRUCTION, } from './retrieval/index.js';
 export type { ConversationStore } from './conversation/index.js';
 export { ConversationManager, MemoryStore } from './conversation/index.js';
-export { AnalyticsCollector } from './analytics/index.js';
+export type { ConversationManagerOptions, ReleaseTurn } from './conversation/index.js';
+export type { AppendOptions, ChatCopsStorage, ConversationSummary, CounterStore, CounterValue, EventCount, EventQuery, EventSink, KeyValueStore, ListQuery, MemoryStorageOptions, ConversationStoreWithAppend, KeywordQuery, MetadataFilter, MetadataValue, ScoredRecord, VectorQuery, VectorRecord, VectorSource, VectorStore, MemoryVectorsOptions, } from './storage/index.js';
+export { ConflictError, isConflictError, CONFLICT_ERROR_CODE, memoryStorage, memoryVectors, matchesFilter, segmentWords, withAppend, isLegacyConversationStore, } from './storage/index.js';
+export { createBudgetGuard, BudgetExceededError, DEFAULT_BUDGETS, withDefaultBudgets } from './limits/budget.js';
+export type { Budgets, BudgetLimit, BudgetContext, BudgetGuard, BudgetScope } from './limits/budget.js';
+export { createRateLimiter } from './limits/rate-limit.js';
+export type { RateLimitRule, RateLimitResult, RateLimiterOptions } from './limits/rate-limit.js';
+export { AnalyticsCollector, BufferedEventSink, statsFromSink, ANALYTICS_EVENTS } from './analytics/index.js';
 export type { AnalyticsStats } from './analytics/index.js';
 export { getLocale, getAvailableLocales } from './i18n/index.js';
 export { en, es, hi, fr, de, ja, zh, ar } from './i18n/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,aAAa,EACb,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGxH,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGrE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG/E,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,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.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,9 +1,23 @@
-export { createProvider, normalizeHistory, ClaudeProvider, OpenAIProvider, GeminiProvider } from './providers/index.js';
+export { partsOf, messageText } from './parts.js';
+export { consoleLogger, jsonLogger, silentLogger } from './logger.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 { openaiEmbedder, geminiEmbedder, voyageEmbedder, voyageReranker, cohereReranker, workersAiEmbedder, workersAiReranker, retrieverKnowledge, formatSources, uniqueChunks, SOURCES_INSTRUCTION, vectorRetriever, hybridRetriever, reciprocalRankFusion, retrievalQueryText, CitationParser, parseCitations, sourcePart, sourcesContext, CITE_INSTRUCTION, NATIVE_SOURCES_INSTRUCTION, } from './retrieval/index.js';
 export { ConversationManager, MemoryStore } from './conversation/index.js';
+export { ConflictError, isConflictError, CONFLICT_ERROR_CODE, memoryStorage, memoryVectors, matchesFilter, segmentWords, 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, ANALYTICS_EVENTS } 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;AAClD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAuD,MAAM,aAAa,CAAC;AAE3H,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;AAqB/E,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAI9B,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AA2B3E,OAAO,EACL,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,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,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG9G,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/knowledge/base.d.ts

@@ -1,5 +1,13 @@
+import type { RetrievalQuery, RetrievedChunk } from '../retrieval/types.js';
 export interface KnowledgeSource {
     type: string;
+    /** Text added to the model's context for a message. */
     getContext(query: string): Promise<string>;
+    /**
+     * The matching chunks themselves, with the conversation so far for
+     * follow-up questions. When a source has this, the server uses it instead
+     * of `getContext`, so answers can say which page they came from.
+     */
+    retrieve?(query: RetrievalQuery): Promise<RetrievedChunk[]>;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/knowledge/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/knowledge/base.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/knowledge/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC7D"}

package/dist/knowledge/tokenize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/knowledge/tokenize.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKhD"}
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/knowledge/tokenize.ts"],"names":[],"mappings":"AAKA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD"}

package/dist/knowledge/tokenize.js

@@ -1,7 +1,7 @@
+import { segmentWords } from '../storage/memory-vectors.js';
+const CJK_SCRIPTS = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u;
+const PARTICLE = /^\p{Script=Hiragana}$/u;
 export function tokenize(query) {
-    return query
-        .toLowerCase()
-        .split(/[^\p{L}\p{N}]+/u)
-        .filter((w) => w.length > 2);
+    return segmentWords(query).filter((w) => !PARTICLE.test(w) && (w.length > 2 || CJK_SCRIPTS.test(w)));
 }
 //# sourceMappingURL=tokenize.js.map

package/dist/knowledge/tokenize.js.map

@@ -1 +1 @@
-{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../src/knowledge/tokenize.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,KAAK,CAAC,iBAAiB,CAAC;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../src/knowledge/tokenize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,WAAW,GAAG,0EAA0E,CAAC;AAC/F,MAAM,QAAQ,GAAG,wBAAwB,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACvG,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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"}