@chatcops/core 0.4.0 → 0.6.0

package/dist/agent/tool-registry.d.ts

@@ -0,0 +1,30 @@
+import type { Logger } from '../logger.js';
+import { type ChatTool } from '../tools/base.js';
+import type { MessagePart, ProviderToolCall, ProviderToolExecutor, ToolDefinition, ToolResult } from '../types.js';
+export interface ToolRunContext {
+    conversationId: string;
+    signal: AbortSignal;
+    timeoutMs?: number;
+    logger?: Logger;
+}
+/** The tools a turn can call, and how to run them. */
+export interface ToolRegistry {
+    /** What the model is told about. */
+    definitions: ToolDefinition[];
+    /** Runs a call. Never throws: failures come back as `{ success: false }`. */
+    run(call: ProviderToolCall, context: ToolRunContext): Promise<ToolResult>;
+    /** Parts to add after a call, like a captured lead. */
+    emits(call: ProviderToolCall, result: ToolResult): MessagePart[];
+}
+/** A registry over `ChatTool` objects, as the server configures them. */
+export declare function toolRegistry(tools?: ChatTool[]): ToolRegistry;
+/**
+ * A registry over tool definitions and one executor function, the 0.4
+ * `toolExecutor` shape. The executor gets the call and nothing else.
+ */
+export declare function executorRegistry(definitions?: ToolDefinition[], executor?: ProviderToolExecutor): ToolRegistry;
+/** Tool output is stored with the conversation, so it's kept to JSON and a size. */
+export declare const MAX_TOOL_OUTPUT_CHARS = 64000;
+/** The stored output of a call: what the model saw, as plain JSON. */
+export declare function toolOutput(result: ToolResult): unknown;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/agent/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../../src/agent/tool-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAoB,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,6EAA6E;IAC7E,GAAG,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1E,uDAAuD;IACvD,KAAK,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,GAAG,WAAW,EAAE,CAAC;CAClE;AAYD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,KAAK,GAAE,QAAQ,EAAO,GAAG,YAAY,CAiBjE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,GAAE,cAAc,EAAO,EAAE,QAAQ,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAWlH;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CActD"}

package/dist/agent/tool-registry.js

@@ -0,0 +1,66 @@
+import { runToolWithTimeout, serializeToolResult } from '../providers/tool-execution.js';
+import { toolToDefinition } from '../tools/base.js';
+/**
+ * Lead capture before tools could emit parts: a successful `capture_lead`
+ * call adds a `lead-captured` part with the result's data. Kept for custom
+ * lead tools written for 0.4.
+ */
+function legacyLeadPart(name, result) {
+    if (name !== 'capture_lead' || !result.success || !result.data)
+        return [];
+    return [{ type: 'lead-captured', lead: result.data }];
+}
+/** A registry over `ChatTool` objects, as the server configures them. */
+export function toolRegistry(tools = []) {
+    const byName = new Map(tools.map((tool) => [tool.name, tool]));
+    return {
+        definitions: tools.map(toolToDefinition),
+        run(call, { conversationId, signal, timeoutMs, logger }) {
+            const tool = byName.get(call.name);
+            if (!tool)
+                return Promise.resolve({ success: false, message: `Unknown tool: ${call.name}` });
+            return runToolWithTimeout((toolSignal) => tool.execute(call.input, { conversationId, signal: toolSignal, ...(logger ? { logger } : {}) }), { timeoutMs, signal, name: call.name, ...(logger ? { logger } : {}) });
+        },
+        emits(call, result) {
+            const tool = byName.get(call.name);
+            return tool?.emits ? tool.emits(result) : legacyLeadPart(call.name, result);
+        },
+    };
+}
+/**
+ * A registry over tool definitions and one executor function, the 0.4
+ * `toolExecutor` shape. The executor gets the call and nothing else.
+ */
+export function executorRegistry(definitions = [], executor) {
+    return {
+        definitions,
+        run(call, { signal, timeoutMs, logger }) {
+            if (!executor) {
+                return Promise.resolve({ success: false, message: `No tool executor is configured for "${call.name}".` });
+            }
+            return runToolWithTimeout(() => executor(call), { timeoutMs, signal, name: call.name, ...(logger ? { logger } : {}) });
+        },
+        emits: (call, result) => legacyLeadPart(call.name, result),
+    };
+}
+/** Tool output is stored with the conversation, so it's kept to JSON and a size. */
+export const MAX_TOOL_OUTPUT_CHARS = 64_000;
+/** The stored output of a call: what the model saw, as plain JSON. */
+export function toolOutput(result) {
+    const output = serializeToolResult(result);
+    let json;
+    try {
+        json = JSON.stringify(output);
+    }
+    catch {
+        return { success: false, message: "The tool returned something that isn't JSON." };
+    }
+    if (json.length <= MAX_TOOL_OUTPUT_CHARS)
+        return JSON.parse(json);
+    return {
+        success: result.success,
+        data: `${JSON.stringify(output.data).slice(0, MAX_TOOL_OUTPUT_CHARS)}... (cut off: the tool returned more than ${MAX_TOOL_OUTPUT_CHARS} characters)`,
+        ...(result.message ? { message: result.message } : {}),
+    };
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/agent/tool-registry.js.map

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

package/dist/analytics/collector.d.ts

@@ -2,6 +2,8 @@ import type { AnalyticsEvent } from '../types.js';
 export interface AnalyticsStats {
     totalConversations: number;
     totalMessages: number;
+    leadsCaptured: number;
+    /** @deprecated Use `leadsCaptured`, the same number. Removed in 1.0. */
     leadsCapture: number;
     averageMessagesPerConversation: number;
     eventCounts: Record<string, number>;

package/dist/analytics/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/analytics/collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B,EAAE,MAAM,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,eAAe,CAAqB;IAE5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAazD,QAAQ,IAAI,cAAc;IAkB1B,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAK1C,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../src/analytics/collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,MAAM,WAAW,cAAc;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B,EAAE,MAAM,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,eAAe,CAAqB;IAE5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAazD,QAAQ,IAAI,cAAc;IAoB1B,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;IAQ1C,KAAK,IAAI,IAAI;CAId"}

package/dist/analytics/collector.js

@@ -1,35 +1,41 @@
+import { ANALYTICS_EVENTS, countsWithAliases, eventName } from './names.js';
 const MAX_EVENTS = 1000;
 export class AnalyticsCollector {
     events = [];
     conversationIds = new Set();
     track(type, data) {
-        const event = { type, data, timestamp: Date.now() };
+        const event = { type: eventName(type), data, timestamp: Date.now() };
         this.events.push(event);
         if (this.events.length > MAX_EVENTS) {
             this.events = this.events.slice(-MAX_EVENTS);
         }
-        if (type === 'conversation:started' && data?.conversationId) {
+        if (event.type === ANALYTICS_EVENTS.conversationStarted && data?.conversationId) {
             this.conversationIds.add(data.conversationId);
         }
     }
     getStats() {
-        const eventCounts = {};
-        for (const event of this.events) {
-            eventCounts[event.type] = (eventCounts[event.type] ?? 0) + 1;
-        }
+        const raw = new Map();
+        for (const event of this.events)
+            raw.set(event.type, (raw.get(event.type) ?? 0) + 1);
+        const counts = countsWithAliases(raw);
+        const eventCounts = Object.fromEntries(counts);
         const totalConversations = this.conversationIds.size;
-        const totalMessages = (eventCounts['message:sent'] ?? 0) + (eventCounts['message:received'] ?? 0);
+        const totalMessages = (counts.get(ANALYTICS_EVENTS.messageSent) ?? 0) + (counts.get(ANALYTICS_EVENTS.messageReceived) ?? 0);
+        const leadsCaptured = counts.get(ANALYTICS_EVENTS.leadCaptured) ?? 0;
         return {
             totalConversations,
             totalMessages,
-            leadsCapture: eventCounts['lead:captured'] ?? 0,
+            leadsCaptured,
+            leadsCapture: leadsCaptured,
             averageMessagesPerConversation: totalConversations > 0 ? totalMessages / totalConversations : 0,
             eventCounts,
         };
     }
     getEvents(type) {
-        if (type)
-            return this.events.filter((e) => e.type === type);
+        if (type) {
+            const name = eventName(type);
+            return this.events.filter((e) => e.type === name);
+        }
         return [...this.events];
     }
     clear() {

package/dist/analytics/collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"collector.js","sourceRoot":"","sources":["../../src/analytics/collector.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,IAAI,CAAC;AAUxB,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAqB,EAAE,CAAC;IAC9B,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C,KAAK,CAAC,IAAY,EAAE,IAA8B;QAChD,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,IAAI,KAAK,sBAAsB,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC;YAC5D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,cAAwB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,QAAQ;QACN,MAAM,WAAW,GAA2B,EAAE,CAAC;QAC/C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QACrD,MAAM,aAAa,GAAG,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;QAElG,OAAO;YACL,kBAAkB;YAClB,aAAa;YACb,YAAY,EAAE,WAAW,CAAC,eAAe,CAAC,IAAI,CAAC;YAC/C,8BAA8B,EAAE,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YAC/F,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,IAAa;QACrB,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"collector.js","sourceRoot":"","sources":["../../src/analytics/collector.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,UAAU,GAAG,IAAI,CAAC;AAYxB,MAAM,OAAO,kBAAkB;IACrB,MAAM,GAAqB,EAAE,CAAC;IAC9B,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C,KAAK,CAAC,IAAY,EAAE,IAA8B;QAChD,MAAM,KAAK,GAAmB,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACrF,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAExB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YACpC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,KAAK,gBAAgB,CAAC,mBAAmB,IAAI,IAAI,EAAE,cAAc,EAAE,CAAC;YAChF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,cAAwB,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,QAAQ;QACN,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACrF,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAE/C,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;QACrD,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5H,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAErE,OAAO;YACL,kBAAkB;YAClB,aAAa;YACb,aAAa;YACb,YAAY,EAAE,aAAa;YAC3B,8BAA8B,EAAE,kBAAkB,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YAC/F,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,IAAa;QACrB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/analytics/index.d.ts

@@ -1,3 +1,5 @@
 export { AnalyticsCollector } from './collector.js';
 export type { AnalyticsStats } from './collector.js';
+export { BufferedEventSink, statsFromSink } from './sink.js';
+export { ANALYTICS_EVENTS } from './names.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/analytics/index.js

@@ -1,2 +1,4 @@
 export { AnalyticsCollector } from './collector.js';
+export { BufferedEventSink, statsFromSink } from './sink.js';
+export { ANALYTICS_EVENTS } from './names.js';
 //# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/analytics/names.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The analytics events ChatCops tracks, named `noun.verb`. Before 0.8 they
+ * were `noun:verb`; those names still work until 1.0: `track()` reads them
+ * as the new ones, stats count events stored under either, and
+ * `eventCounts` has both keys.
+ */
+export declare const ANALYTICS_EVENTS: {
+    readonly conversationStarted: "conversation.started";
+    readonly messageSent: "message.sent";
+    readonly messageReceived: "message.received";
+    readonly leadCaptured: "lead.captured";
+};
+/** The current name for an event type: an old `noun:verb` name becomes its `noun.verb` one. */
+export declare function eventName(type: string): string;
+/**
+ * Counts by type with events under an old name added to the new one, and
+ * the old key kept with the same total, so code that reads
+ * `eventCounts['message:sent']` keeps working until 1.0.
+ */
+export declare function countsWithAliases(counts: Iterable<[string, number]>): Map<string, number>;
+//# sourceMappingURL=names.d.ts.map

package/dist/analytics/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/analytics/names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AASX,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAWzF"}

package/dist/analytics/names.js

@@ -0,0 +1,41 @@
+/**
+ * The analytics events ChatCops tracks, named `noun.verb`. Before 0.8 they
+ * were `noun:verb`; those names still work until 1.0: `track()` reads them
+ * as the new ones, stats count events stored under either, and
+ * `eventCounts` has both keys.
+ */
+export const ANALYTICS_EVENTS = {
+    conversationStarted: 'conversation.started',
+    messageSent: 'message.sent',
+    messageReceived: 'message.received',
+    leadCaptured: 'lead.captured',
+};
+const LEGACY = {
+    'conversation:started': ANALYTICS_EVENTS.conversationStarted,
+    'message:sent': ANALYTICS_EVENTS.messageSent,
+    'message:received': ANALYTICS_EVENTS.messageReceived,
+    'lead:captured': ANALYTICS_EVENTS.leadCaptured,
+};
+/** The current name for an event type: an old `noun:verb` name becomes its `noun.verb` one. */
+export function eventName(type) {
+    return LEGACY[type] ?? type;
+}
+/**
+ * Counts by type with events under an old name added to the new one, and
+ * the old key kept with the same total, so code that reads
+ * `eventCounts['message:sent']` keeps working until 1.0.
+ */
+export function countsWithAliases(counts) {
+    const merged = new Map();
+    for (const [type, count] of counts) {
+        const name = eventName(type);
+        merged.set(name, (merged.get(name) ?? 0) + count);
+    }
+    for (const [old, name] of Object.entries(LEGACY)) {
+        const total = merged.get(name);
+        if (total !== undefined)
+            merged.set(old, total);
+    }
+    return merged;
+}
+//# sourceMappingURL=names.js.map

package/dist/analytics/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/analytics/names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mBAAmB,EAAE,sBAAsB;IAC3C,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,kBAAkB;IACnC,YAAY,EAAE,eAAe;CACrB,CAAC;AAEX,MAAM,MAAM,GAA2B;IACrC,sBAAsB,EAAE,gBAAgB,CAAC,mBAAmB;IAC5D,cAAc,EAAE,gBAAgB,CAAC,WAAW;IAC5C,kBAAkB,EAAE,gBAAgB,CAAC,eAAe;IACpD,eAAe,EAAE,gBAAgB,CAAC,YAAY;CAC/C,CAAC;AAEF,+FAA+F;AAC/F,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAkC;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/analytics/sink.d.ts

@@ -0,0 +1,27 @@
+import { type Logger } from '../logger.js';
+import type { EventSink } from '../storage/types.js';
+import type { AnalyticsStats } from './collector.js';
+export declare class BufferedEventSink {
+    private readonly sink;
+    private readonly events;
+    private readonly maxBatch;
+    private readonly flushMs;
+    private timer;
+    private flushPromise;
+    private readonly logger;
+    constructor(sink: EventSink, options?: {
+        maxBatch?: number;
+        flushMs?: number;
+        logger?: Logger;
+    });
+    track(type: string, data?: Record<string, unknown>): void;
+    flush(): Promise<void>;
+    private scheduleFlush;
+    private clearTimer;
+    private startAutomaticFlush;
+}
+export declare function statsFromSink(sink: EventSink, range: {
+    from: number;
+    to: number;
+}): Promise<AnalyticsStats>;
+//# sourceMappingURL=sink.d.ts.map

package/dist/analytics/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/analytics/sink.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMrD,qBAAa,iBAAiB;IAS1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IARvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,IAAI,EAAE,SAAS,EAChC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAcpE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,mBAAmB;CAK5B;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,SAAS,EACf,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAAC,cAAc,CAAC,CAqBzB"}

package/dist/analytics/sink.js

@@ -0,0 +1,109 @@
+import { consoleLogger } from '../logger.js';
+import { ANALYTICS_EVENTS, countsWithAliases, eventName } from './names.js';
+const DEFAULT_MAX_BATCH = 50;
+const DEFAULT_FLUSH_MS = 2000;
+export class BufferedEventSink {
+    sink;
+    events = [];
+    maxBatch;
+    flushMs;
+    timer;
+    flushPromise;
+    logger;
+    constructor(sink, options) {
+        this.sink = sink;
+        this.logger = options?.logger ?? consoleLogger();
+        this.maxBatch = options?.maxBatch ?? DEFAULT_MAX_BATCH;
+        this.flushMs = options?.flushMs ?? DEFAULT_FLUSH_MS;
+        if (!Number.isInteger(this.maxBatch) || this.maxBatch < 1) {
+            throw new RangeError('maxBatch must be a positive integer.');
+        }
+        if (!Number.isFinite(this.flushMs) || this.flushMs < 0) {
+            throw new RangeError('flushMs must be a non-negative finite number.');
+        }
+    }
+    track(type, data) {
+        const wasEmpty = this.events.length === 0;
+        this.events.push({ type: eventName(type), data, timestamp: Date.now() });
+        if (wasEmpty)
+            this.scheduleFlush();
+        if (this.events.length >= this.maxBatch)
+            this.startAutomaticFlush();
+    }
+    flush() {
+        if (this.flushPromise)
+            return this.flushPromise;
+        this.clearTimer();
+        const drain = Promise.resolve().then(async () => {
+            while (this.events.length > 0) {
+                this.clearTimer();
+                const batch = this.events.splice(0, this.maxBatch);
+                try {
+                    await this.sink.write(batch);
+                }
+                catch (error) {
+                    this.logger.error('analytics_write_failed', `analytics write failed: ${errorMessage(error)}`);
+                }
+            }
+        });
+        const flushPromise = drain.finally(() => {
+            if (this.flushPromise === flushPromise)
+                this.flushPromise = undefined;
+            if (this.events.length > 0)
+                this.startAutomaticFlush();
+        });
+        this.flushPromise = flushPromise;
+        return flushPromise;
+    }
+    scheduleFlush() {
+        try {
+            const timer = setTimeout(() => {
+                this.timer = undefined;
+                this.startAutomaticFlush();
+            }, this.flushMs);
+            this.timer = timer;
+            if (typeof timer === 'object' && timer !== null && 'unref' in timer && typeof timer.unref === 'function') {
+                timer.unref();
+            }
+        }
+        catch (error) {
+            this.clearTimer();
+            this.logger.error('analytics_flush_failed', `analytics timer failed: ${errorMessage(error)}`);
+            this.startAutomaticFlush();
+        }
+    }
+    clearTimer() {
+        if (this.timer === undefined)
+            return;
+        clearTimeout(this.timer);
+        this.timer = undefined;
+    }
+    startAutomaticFlush() {
+        void this.flush().catch((error) => {
+            this.logger.error('analytics_flush_failed', `analytics flush failed: ${errorMessage(error)}`);
+        });
+    }
+}
+export async function statsFromSink(sink, range) {
+    if (!sink.query) {
+        throw new Error('Event sink does not support querying; implement EventSink.query to calculate analytics statistics.');
+    }
+    // Events stored under the old names (before 0.8) still count.
+    const eventCounts = countsWithAliases((await sink.query(range)).map(({ type, count }) => [type, count]));
+    const totalConversations = eventCounts.get(ANALYTICS_EVENTS.conversationStarted) ?? 0;
+    const totalMessages = (eventCounts.get(ANALYTICS_EVENTS.messageSent) ?? 0) + (eventCounts.get(ANALYTICS_EVENTS.messageReceived) ?? 0);
+    const leadsCaptured = eventCounts.get(ANALYTICS_EVENTS.leadCaptured) ?? 0;
+    return {
+        totalConversations,
+        totalMessages,
+        leadsCaptured,
+        leadsCapture: leadsCaptured,
+        averageMessagesPerConversation: totalConversations > 0 ? totalMessages / totalConversations : 0,
+        eventCounts: Object.fromEntries(eventCounts),
+    };
+}
+function errorMessage(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return message.replace(/[\r\n]+/g, ' ');
+}
+//# sourceMappingURL=sink.js.map

package/dist/analytics/sink.js.map

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

package/dist/conversation/index.d.ts

@@ -1,4 +1,5 @@
 export { ConversationManager } from './manager.js';
+export type { ConversationManagerOptions, ReleaseTurn } from './manager.js';
 export type { ConversationStore } from './store.js';
 export { MemoryStore } from './store.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,0BAA0B,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/conversation/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/conversation/manager.d.ts

@@ -1,16 +1,75 @@
+import { type Logger } from '../logger.js';
+import type { AppendOptions, ChatCopsStorage } from '../storage/types.js';
 import type { ChatMessage, Conversation } from '../types.js';
 import type { ConversationStore } from './store.js';
+export interface ConversationManagerOptions {
+    /** Where everything is stored. Takes precedence over `store`. */
+    storage?: ChatCopsStorage;
+    /** A conversation store on its own, as in 0.4. */
+    store?: ConversationStore;
+    /**
+     * Most messages kept per conversation. Older ones are removed after each
+     * write; system messages stay. Default 100.
+     */
+    maxMessages?: number;
+    /** Token budget for the history sent to the model. Default 32,000. */
+    maxHistoryTokens?: number;
+    /** Where warnings go. Default `consoleLogger()`. */
+    logger?: Logger;
+}
+/** Releases a turn lock. Safe to call more than once. */
+export type ReleaseTurn = () => Promise<void>;
+/**
+ * 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 declare class ConversationManager {
-    private store;
-    private maxMessages;
-    constructor(options?: {
-        store?: ConversationStore;
-        maxMessages?: number;
-    });
+    private readonly store;
+    private readonly kv;
+    private readonly maxMessages;
+    private readonly maxHistoryTokens;
+    private readonly localTurns;
+    constructor(options?: ConversationManagerOptions);
+    /**
+     * The stored conversation, or a new empty one. A new conversation isn't
+     * saved until its first message is added.
+     */
     getOrCreate(id: string): Promise<Conversation>;
+    /** Adds one message and returns the conversation as stored afterwards. */
     addMessage(conversationId: string, message: ChatMessage): Promise<Conversation>;
+    /**
+     * Adds messages atomically and returns the new version. Pass
+     * `expectedVersion` to fail with a `ConflictError` when another request
+     * wrote first.
+     */
+    appendMessages(conversationId: string, messages: ChatMessage[], options?: AppendOptions): Promise<{
+        version: number;
+    }>;
+    /** Replaces a stored message with the same id. Resolves `false` when there's none. */
+    updateMessage(conversationId: string, message: ChatMessage): Promise<boolean>;
     getMessages(conversationId: string): Promise<ChatMessage[]>;
+    /**
+     * The messages to send to the model: user and assistant turns within the
+     * token budget, keeping the first user message and the newest ones.
+     */
+    getHistory(conversationId: string): Promise<ChatMessage[]>;
     removeMessage(conversationId: string, messageId: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
+    /**
+     * 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.
+     */
+    acquireTurn(conversationId: string, ttlMs?: number): Promise<ReleaseTurn | null>;
+    /**
+     * 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).
+     */
+    private enforceMaxMessages;
 }
 //# sourceMappingURL=manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/conversation/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAGpD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,iBAAiB,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAKnE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAc9C,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB/E,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK3D,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/conversation/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AAK1D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAiB,MAAM,qBAAqB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,0BAA0B;IACzC,iEAAiE;IACjE,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8B;IACpD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA4B;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;gBAEpC,OAAO,GAAE,0BAA+B;IAepD;;;OAGG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOpD,0EAA0E;IACpE,UAAU,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAKrF;;;;OAIG;IACG,cAAc,CAClB,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,WAAW,EAAE,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/B,sFAAsF;IACtF,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvE,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKjE;;;OAGG;IACG,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAI1D,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;;;;;;OAOG;IACG,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,SAAU,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA8BvF;;;;OAIG;YACW,kBAAkB;CAWjC"}