@recombine-ai/platform 0.2.5 → 0.2.6-test.2

package/build/analytics.d.ts

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+export type AnalyticsValueType = 'boolean' | 'number' | 'string' | 'json';
+export type AnalyticsJsonValue = boolean | number | string | null | AnalyticsJsonValue[] | {
+    [key: string]: AnalyticsJsonValue;
+};
+export interface AnalyticsKey<T> {
+    readonly key: string;
+    readonly valueType: AnalyticsValueType;
+    readonly schema: z.ZodType<T>;
+}
+export type AnalyticsValue<TKey extends AnalyticsKey<unknown>> = TKey extends AnalyticsKey<infer TValue> ? TValue : never;
+export interface ConversationAnalyticsSummary {
+    conversationId: string;
+    agentId?: string;
+    channel: string;
+    region?: string;
+    startedAt: Date;
+    endedAt?: Date;
+    durationSeconds?: number;
+}
+export interface ConversationAnalytics {
+    set<TKey extends AnalyticsKey<unknown>>(key: TKey, value: AnalyticsValue<TKey>): Promise<void>;
+    clear(key: AnalyticsKey<unknown>): Promise<void>;
+    get<TKey extends AnalyticsKey<unknown>>(key: TKey): Promise<AnalyticsValue<TKey> | undefined>;
+    getSummary(): Promise<ConversationAnalyticsSummary | undefined>;
+}
+export interface Analytics {
+    getConversationAnalytics(conversationId: string): ConversationAnalytics;
+}
+export declare const analyticsKey: {
+    boolean(key: string): AnalyticsKey<boolean>;
+    number(key: string): AnalyticsKey<number>;
+    string(key: string): AnalyticsKey<string>;
+    enum<const TValues extends readonly [string, ...string[]]>(key: string, values: TValues): AnalyticsKey<TValues[number]>;
+    json<T extends AnalyticsJsonValue>(key: string, schema: z.ZodType<T>): AnalyticsKey<T>;
+};
+export declare function createInMemoryAnalytics(summaries?: ConversationAnalyticsSummary[]): Analytics;
+export declare function assertAnalyticsJsonValue(value: unknown): asserts value is AnalyticsJsonValue;
+//# sourceMappingURL=analytics.d.ts.map

package/build/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAA;AACzE,MAAM,MAAM,kBAAkB,GACxB,OAAO,GACP,MAAM,GACN,MAAM,GACN,IAAI,GACJ,kBAAkB,EAAE,GACpB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAA;CAAE,CAAA;AAE3C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CAChC;AAED,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,IACzD,IAAI,SAAS,YAAY,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAE5D,MAAM,WAAW,4BAA4B;IACzC,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9F,KAAK,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC7F,UAAU,IAAI,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAAA;CAClE;AAED,MAAM,WAAW,SAAS;IACtB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB,CAAA;CAC1E;AAcD,eAAO,MAAM,YAAY;iBACR,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;gBAG/B,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;gBAG7B,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;eAG9B,OAAO,SAAS,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,OAChD,MAAM,UACH,OAAO,GAChB,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SAG3B,CAAC,SAAS,kBAAkB,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAGzF,CAAA;AAED,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,4BAA4B,EAAO,GAAG,SAAS,CAsCjG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAkB5F"}

package/build/analytics.js

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+function defineKey(key, valueType, schema) {
+    if (!/^[A-Za-z0-9_.:-]{1,128}$/.test(key)) {
+        throw new Error('Analytics key contains unsupported characters');
+    }
+    return Object.freeze({ key, valueType, schema });
+}
+export const analyticsKey = {
+    boolean(key) {
+        return defineKey(key, 'boolean', z.boolean());
+    },
+    number(key) {
+        return defineKey(key, 'number', z.number().finite());
+    },
+    string(key) {
+        return defineKey(key, 'string', z.string());
+    },
+    enum(key, values) {
+        return defineKey(key, 'string', z.enum(values));
+    },
+    json(key, schema) {
+        return defineKey(key, 'json', schema);
+    },
+};
+export function createInMemoryAnalytics(summaries = []) {
+    const conversations = new Map();
+    const summariesById = new Map(summaries.map((summary) => [summary.conversationId, structuredClone(summary)]));
+    return {
+        getConversationAnalytics(conversationId) {
+            return {
+                async set(key, value) {
+                    const parsed = key.schema.parse(value);
+                    assertAnalyticsJsonValue(parsed);
+                    const values = conversations.get(conversationId) ?? new Map();
+                    values.set(key.key, structuredClone(parsed));
+                    conversations.set(conversationId, values);
+                },
+                async clear(key) {
+                    const values = conversations.get(conversationId);
+                    values?.delete(key.key);
+                    if (values?.size === 0) {
+                        conversations.delete(conversationId);
+                    }
+                },
+                async get(key) {
+                    const values = conversations.get(conversationId);
+                    if (!values?.has(key.key)) {
+                        return undefined;
+                    }
+                    const value = values.get(key.key);
+                    return key.schema.parse(structuredClone(value));
+                },
+                async getSummary() {
+                    const summary = summariesById.get(conversationId);
+                    return summary ? structuredClone(summary) : undefined;
+                },
+            };
+        },
+    };
+}
+export function assertAnalyticsJsonValue(value) {
+    if (value === null ||
+        typeof value === 'boolean' ||
+        typeof value === 'string' ||
+        (typeof value === 'number' && Number.isFinite(value))) {
+        return;
+    }
+    if (Array.isArray(value)) {
+        value.forEach(assertAnalyticsJsonValue);
+        return;
+    }
+    if (typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype) {
+        Object.values(value).forEach(assertAnalyticsJsonValue);
+        return;
+    }
+    throw new Error('Analytics value must be valid JSON');
+}

package/build/analytics.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analytics.spec.d.ts.map

package/build/analytics.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.spec.d.ts","sourceRoot":"","sources":["../src/analytics.spec.ts"],"names":[],"mappings":""}

package/build/analytics.spec.js

@@ -0,0 +1,57 @@
+import { describe, expect, expectTypeOf, it } from 'vitest';
+import { z } from 'zod';
+import { analyticsKey, createInMemoryAnalytics } from './analytics.js';
+describe('Analytics', () => {
+    it('rejects unsupported key characters', () => {
+        expect(() => analyticsKey.string('not allowed')).toThrow('Analytics key contains unsupported characters');
+    });
+    it('keeps key and value types paired', async () => {
+        const analytics = createInMemoryAnalytics();
+        const escalated = analyticsKey.boolean('common.escalated');
+        const conversation = analytics.getConversationAnalytics('conversation-1');
+        await conversation.set(escalated, true);
+        const value = await conversation.get(escalated);
+        expectTypeOf(value).toEqualTypeOf();
+        expect(value).toBe(true);
+    });
+    it('clears a value idempotently', async () => {
+        const analytics = createInMemoryAnalytics();
+        const score = analyticsKey.number('project.score');
+        const conversation = analytics.getConversationAnalytics('conversation-1');
+        await conversation.set(score, 3);
+        await conversation.clear(score);
+        await conversation.clear(score);
+        await expect(conversation.get(score)).resolves.toBeUndefined();
+    });
+    it('validates JSON values at runtime', async () => {
+        const analytics = createInMemoryAnalytics();
+        const result = analyticsKey.json('project.result', z.object({ reason: z.string(), accepted: z.boolean() }));
+        const conversation = analytics.getConversationAnalytics('conversation-1');
+        await expect(conversation.set(result, {
+            reason: 'done',
+            accepted: true,
+        })).resolves.toBeUndefined();
+        await expect(conversation.set(result, {
+            reason: 'done',
+            accepted: 'yes',
+        })).rejects.toThrow();
+    });
+    it('distinguishes JSON null from a missing key', async () => {
+        const analytics = createInMemoryAnalytics();
+        const result = analyticsKey.json('project.result', z.null());
+        await analytics.getConversationAnalytics('conversation-1').set(result, null);
+        await expect(analytics.getConversationAnalytics('conversation-1').get(result)).resolves.toBeNull();
+        await expect(analytics.getConversationAnalytics('conversation-2').get(result)).resolves.toBeUndefined();
+    });
+    it('returns common conversation data from getSummary', async () => {
+        const summary = {
+            conversationId: 'conversation-1',
+            agentId: 'support',
+            channel: 'phone',
+            startedAt: new Date('2026-08-22T10:00:00Z'),
+            durationSeconds: 60,
+        };
+        const analytics = createInMemoryAnalytics([summary]);
+        await expect(analytics.getConversationAnalytics('conversation-1').getSummary()).resolves.toEqual(summary);
+    });
+});

package/build/context-cache.js

@@ -1,8 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createInMemoryCache = createInMemoryCache;
-exports.createRedisCache = createRedisCache;
-function createInMemoryCache() {
+export function createInMemoryCache() {
     const cache = new Map();
     async function getContext(callId, defaultContext) {
         if (cache.has(callId)) {
@@ -25,7 +21,7 @@ function createInMemoryCache() {
         },
     };
 }
-function createRedisCache(client, options = DEFAULT_REDIS_CACHE_OPTIONS) {
+export function createRedisCache(client, options = DEFAULT_REDIS_CACHE_OPTIONS) {
     function createKey(callId) {
         return options.keyPrefix + callId;
     }

package/build/index.d.ts

@@ -1,5 +1,7 @@
-export * from './interfaces/platform';
-export * from './interfaces/rc-voice';
-export * from './context-cache';
-export * from './timeouts-manager';
+export * from './interfaces/platform.js';
+export * from './interfaces/rc-voice.js';
+export * from './context-cache.js';
+export * from './analytics.js';
+export * from './postgres-analytics.js';
+export * from './timeouts-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,yBAAyB,CAAA;AACvC,cAAc,uBAAuB,CAAA"}

package/build/index.js

@@ -1,20 +1,6 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./interfaces/platform"), exports);
-__exportStar(require("./interfaces/rc-voice"), exports);
-__exportStar(require("./context-cache"), exports);
-__exportStar(require("./timeouts-manager"), exports);
+export * from './interfaces/platform.js';
+export * from './interfaces/rc-voice.js';
+export * from './context-cache.js';
+export * from './analytics.js';
+export * from './postgres-analytics.js';
+export * from './timeouts-manager.js';

package/build/interfaces/platform.d.ts

@@ -1,22 +1,24 @@
 import { ReadableStream } from 'node:stream/web';
 import { AIEngine, AIStreamEngine, LlmAdapter, LlmStreamAdapter, Logger, Message, PromptFS, ResponseChunk } from '@recombine-ai/engine';
-import { ContextCache } from '../context-cache';
-import { TimeoutManager } from '../timeouts-manager';
-import { IRcVoice } from './rc-voice';
+import { Analytics } from '../analytics.js';
+import { ContextCache } from '../context-cache.js';
+import { TimeoutManager } from '../timeouts-manager.js';
+import { IRcVoice } from './rc-voice.js';
 export interface IModels {
     models: Record<string, LlmAdapter>;
     streamingModels: Record<string, LlmStreamAdapter>;
 }
-export interface Platform<TContext extends {}, TModels extends IModels> {
+export interface Platform<TContext extends {}, TModels extends IModels, TRcVoice = IRcVoice, TTimeoutManager = TimeoutManager, TContextCache = ContextCache<TContext>> {
     streamAi: AIStreamEngine<TContext>;
     ai: AIEngine<TContext>;
     fs: PromptFS;
-    rcVoice: IRcVoice;
+    rcVoice: TRcVoice;
     logger: Logger;
-    timeoutManager: TimeoutManager;
+    timeoutManager: TTimeoutManager;
     models: TModels['models'];
     streamingModels: TModels['streamingModels'];
-    contextCache: ContextCache<TContext>;
+    contextCache: TContextCache;
+    analytics: Analytics;
 }
 export interface CallInfo {
     callId: string;

package/build/interfaces/platform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACH,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,aAAa,EAChB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,QAAQ,CAAC,QAAQ,SAAS,EAAE,EAAE,OAAO,SAAS,OAAO;IAElE,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAElC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEtB,EAAE,EAAE,QAAQ,CAAA;IAEZ,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,cAAc,CAAA;IAE9B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE3C,YAAY,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;CACvC;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;QACrC,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KACpD,CAAC,CAAA;IACF,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/F,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,SAAS,OAAO,EAC/E,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,KAAK,UAAU,cAA/D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,SAAS,KAAK,UAAU,CAGtF"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EACH,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,OAAO,EACP,QAAQ,EACR,aAAa,EAChB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,WAAW,OAAO;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAClC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CACpD;AAED,MAAM,WAAW,QAAQ,CACrB,QAAQ,SAAS,EAAE,EACnB,OAAO,SAAS,OAAO,EACvB,QAAQ,GAAG,QAAQ,EACnB,eAAe,GAAG,cAAc,EAChC,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC;IAGtC,QAAQ,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAElC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEtB,EAAE,EAAE,QAAQ,CAAA;IAEZ,OAAO,EAAE,QAAQ,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,eAAe,CAAA;IAE/B,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IACzB,eAAe,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAE3C,YAAY,EAAE,aAAa,CAAA;IAE3B,SAAS,EAAE,SAAS,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC;QACrC,cAAc,EAAE,MAAM,CAAA;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAA;KACpD,CAAC,CAAA;IACF,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/F,SAAS,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,wBAAgB,WAAW,CAAC,QAAQ,SAAS,EAAE,EAAE,SAAS,EAAE,OAAO,SAAS,OAAO,EAC/E,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,KAAK,UAAU,cAA/D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,YAAY,SAAS,KAAK,UAAU,CAGtF"}

package/build/interfaces/platform.js

@@ -1,6 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAgent = createAgent;
-function createAgent(creator) {
+export function createAgent(creator) {
     return creator;
 }

package/build/interfaces/rc-voice.js

@@ -1,2 +1 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};

package/build/postgres-analytics.d.ts

@@ -0,0 +1,41 @@
+import { Pool, PoolConfig, QueryResult } from 'pg';
+import { Analytics, ConversationAnalytics } from './analytics.js';
+export interface ConversationRecord {
+    conversationId: string;
+    agentId?: string;
+    channel: string;
+    region?: string;
+    startedAt: Date;
+    endedAt?: Date;
+    durationSeconds?: number;
+}
+export interface PhoneCallRecord {
+    conversationId: string;
+    phoneNumber?: string;
+    recordingUrl?: string;
+    endedReason?: string;
+}
+interface Queryable {
+    query<TResult extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<QueryResult<TResult>>;
+}
+export declare class PostgresAnalytics implements Analytics {
+    private readonly database;
+    constructor(database: Queryable);
+    getConversationAnalytics(conversationId: string): ConversationAnalytics;
+}
+export declare class PostgresConversationRepository {
+    private readonly pool;
+    constructor(pool: Pool);
+    saveConversation(conversation: ConversationRecord, phoneCall?: PhoneCallRecord): Promise<void>;
+    private upsertConversation;
+    private upsertPhoneCall;
+}
+export declare function migrateAnalyticsDatabase(pool: Pool): Promise<void>;
+export interface PostgresAnalyticsServices {
+    analytics: PostgresAnalytics;
+    conversations: PostgresConversationRepository;
+    close(): Promise<void>;
+}
+export declare function createPostgresAnalyticsServices(config: PoolConfig): Promise<PostgresAnalyticsServices>;
+export {};
+//# sourceMappingURL=postgres-analytics.d.ts.map

package/build/postgres-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-analytics.d.ts","sourceRoot":"","sources":["../src/postgres-analytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAc,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AAE9D,OAAO,EACH,SAAS,EAGT,qBAAqB,EAGxB,MAAM,gBAAgB,CAAA;AAEvB,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,OAAO,CAAC,EAAE,IAAI,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,UAAU,SAAS;IACf,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACnB,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAA;CACnC;AAYD,qBAAa,iBAAkB,YAAW,SAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS;IAEhD,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,qBAAqB;CA6E1E;AAQD,qBAAa,8BAA8B;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,IAAI;IAEjC,gBAAgB,CAClB,YAAY,EAAE,kBAAkB,EAChC,SAAS,CAAC,EAAE,eAAe,GAC5B,OAAO,CAAC,IAAI,CAAC;YAiBF,kBAAkB;YAkClB,eAAe;CAoBhC;AA+CD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAuCxE;AAED,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,aAAa,EAAE,8BAA8B,CAAA;IAC7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAapC"}

package/build/postgres-analytics.js

@@ -0,0 +1,233 @@
+import { Pool } from 'pg';
+import { assertAnalyticsJsonValue, } from './analytics.js';
+export class PostgresAnalytics {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    getConversationAnalytics(conversationId) {
+        const database = this.database;
+        return {
+            async set(key, value) {
+                const parsed = key.schema.parse(value);
+                assertAnalyticsJsonValue(parsed);
+                const serialized = JSON.stringify(parsed);
+                if (serialized === undefined) {
+                    throw new Error(`Analytics value for '${key.key}' is not valid JSON`);
+                }
+                const result = await database.query(`UPDATE conversations
+                     SET analytics = jsonb_set(analytics, ARRAY[$2::text], $3::jsonb, true),
+                         updated_at = now()
+                     WHERE conversation_id = $1`, [conversationId, key.key, serialized]);
+                assertConversationExists(result.rowCount, conversationId);
+            },
+            async clear(key) {
+                const result = await database.query(`UPDATE conversations
+                     SET analytics = analytics - $2::text,
+                         updated_at = now()
+                     WHERE conversation_id = $1`, [conversationId, key.key]);
+                assertConversationExists(result.rowCount, conversationId);
+            },
+            async get(key) {
+                const result = await database.query(`SELECT analytics ? $2::text AS present,
+                            analytics -> $2::text AS value
+                     FROM conversations
+                     WHERE conversation_id = $1`, [conversationId, key.key]);
+                if (result.rows.length === 0 || !result.rows[0].present) {
+                    return undefined;
+                }
+                return key.schema.parse(result.rows[0].value);
+            },
+            async getSummary() {
+                const result = await database.query(`SELECT conversation_id,
+                            agent_id,
+                            channel,
+                            region,
+                            started_at,
+                            ended_at,
+                            duration_seconds
+                     FROM conversations
+                     WHERE conversation_id = $1`, [conversationId]);
+                const row = result.rows[0];
+                if (!row) {
+                    return undefined;
+                }
+                return {
+                    conversationId: row.conversation_id,
+                    agentId: row.agent_id ?? undefined,
+                    channel: row.channel,
+                    region: row.region ?? undefined,
+                    startedAt: row.started_at,
+                    endedAt: row.ended_at ?? undefined,
+                    durationSeconds: row.duration_seconds ?? undefined,
+                };
+            },
+        };
+    }
+}
+function assertConversationExists(rowCount, conversationId) {
+    if (rowCount !== 1) {
+        throw new Error(`Conversation '${conversationId}' does not exist`);
+    }
+}
+export class PostgresConversationRepository {
+    pool;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    async saveConversation(conversation, phoneCall) {
+        const client = await this.pool.connect();
+        try {
+            await client.query('BEGIN');
+            await this.upsertConversation(client, conversation);
+            if (phoneCall) {
+                await this.upsertPhoneCall(client, phoneCall);
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async upsertConversation(client, conversation) {
+        await client.query(`INSERT INTO conversations (
+                 conversation_id,
+                 agent_id,
+                 channel,
+                 region,
+                 started_at,
+                 ended_at,
+                 duration_seconds
+             ) VALUES ($1, $2, $3, $4, $5, $6, $7)
+             ON CONFLICT (conversation_id) DO UPDATE SET
+                 agent_id = EXCLUDED.agent_id,
+                 channel = EXCLUDED.channel,
+                 region = EXCLUDED.region,
+                 started_at = EXCLUDED.started_at,
+                 ended_at = EXCLUDED.ended_at,
+                 duration_seconds = EXCLUDED.duration_seconds,
+                 updated_at = now()`, [
+            conversation.conversationId,
+            conversation.agentId ?? null,
+            conversation.channel,
+            conversation.region ?? null,
+            conversation.startedAt,
+            conversation.endedAt ?? null,
+            conversation.durationSeconds ?? null,
+        ]);
+    }
+    async upsertPhoneCall(client, phoneCall) {
+        await client.query(`INSERT INTO phone_calls (
+                 conversation_id,
+                 phone_number,
+                 recording_url,
+                 ended_reason
+             ) VALUES ($1, $2, $3, $4)
+             ON CONFLICT (conversation_id) DO UPDATE SET
+                 phone_number = EXCLUDED.phone_number,
+                 recording_url = EXCLUDED.recording_url,
+                 ended_reason = EXCLUDED.ended_reason`, [
+            phoneCall.conversationId,
+            phoneCall.phoneNumber ?? null,
+            phoneCall.recordingUrl ?? null,
+            phoneCall.endedReason ?? null,
+        ]);
+    }
+}
+const migrations = [
+    {
+        version: 1,
+        sql: `
+            CREATE TABLE conversations (
+                conversation_id text PRIMARY KEY,
+                agent_id text,
+                channel text NOT NULL,
+                region text,
+                started_at timestamptz NOT NULL,
+                ended_at timestamptz,
+                duration_seconds double precision CHECK (
+                    duration_seconds IS NULL OR duration_seconds >= 0
+                ),
+                analytics jsonb NOT NULL DEFAULT '{}'::jsonb CHECK (
+                    jsonb_typeof(analytics) = 'object'
+                ),
+                created_at timestamptz NOT NULL DEFAULT now(),
+                updated_at timestamptz NOT NULL DEFAULT now()
+            );
+
+            CREATE TABLE phone_calls (
+                conversation_id text PRIMARY KEY REFERENCES conversations(conversation_id)
+                    ON DELETE CASCADE,
+                phone_number text,
+                recording_url text,
+                ended_reason text
+            );
+
+            CREATE INDEX conversations_started_at_idx
+                ON conversations (started_at DESC, conversation_id DESC);
+            CREATE INDEX conversations_agent_started_at_idx
+                ON conversations (agent_id, started_at DESC, conversation_id DESC);
+            CREATE INDEX conversations_region_started_at_idx
+                ON conversations (region, started_at DESC, conversation_id DESC);
+            CREATE INDEX conversations_channel_started_at_idx
+                ON conversations (channel, started_at DESC, conversation_id DESC);
+            CREATE INDEX conversations_analytics_idx
+                ON conversations USING gin (analytics);
+            CREATE INDEX phone_calls_phone_number_idx
+                ON phone_calls (phone_number, conversation_id);
+        `,
+    },
+];
+export async function migrateAnalyticsDatabase(pool) {
+    const client = await pool.connect();
+    try {
+        await client.query("SELECT pg_advisory_lock(hashtext('recombine_analytics_migrations'))");
+        await client.query(`
+            CREATE TABLE IF NOT EXISTS analytics_schema_migrations (
+                version integer PRIMARY KEY,
+                applied_at timestamptz NOT NULL DEFAULT now()
+            )
+        `);
+        for (const migration of migrations) {
+            const applied = await client.query(`SELECT EXISTS (
+                    SELECT 1 FROM analytics_schema_migrations WHERE version = $1
+                ) AS exists`, [migration.version]);
+            if (applied.rows[0].exists) {
+                continue;
+            }
+            await client.query('BEGIN');
+            try {
+                await client.query(migration.sql);
+                await client.query('INSERT INTO analytics_schema_migrations (version) VALUES ($1)', [migration.version]);
+                await client.query('COMMIT');
+            }
+            catch (error) {
+                await client.query('ROLLBACK');
+                throw error;
+            }
+        }
+    }
+    finally {
+        await client.query("SELECT pg_advisory_unlock(hashtext('recombine_analytics_migrations'))");
+        client.release();
+    }
+}
+export async function createPostgresAnalyticsServices(config) {
+    const pool = new Pool(config);
+    try {
+        await migrateAnalyticsDatabase(pool);
+    }
+    catch (error) {
+        await pool.end();
+        throw error;
+    }
+    return {
+        analytics: new PostgresAnalytics(pool),
+        conversations: new PostgresConversationRepository(pool),
+        close: () => pool.end(),
+    };
+}

package/build/postgres-analytics.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=postgres-analytics.spec.d.ts.map

package/build/postgres-analytics.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-analytics.spec.d.ts","sourceRoot":"","sources":["../src/postgres-analytics.spec.ts"],"names":[],"mappings":""}

package/build/postgres-analytics.spec.js

@@ -0,0 +1,61 @@
+import { describe, expect, it, vi } from 'vitest';
+import { z } from 'zod';
+import { analyticsKey } from './analytics.js';
+import { PostgresAnalytics } from './postgres-analytics.js';
+function result(rows = [], rowCount = rows.length) {
+    return { rows, rowCount };
+}
+describe('PostgresAnalytics', () => {
+    it('stores a typed value under one literal JSON key', async () => {
+        const query = vi.fn().mockResolvedValue(result([], 1));
+        const analytics = new PostgresAnalytics({ query });
+        await analytics
+            .getConversationAnalytics('conversation-1')
+            .set(analyticsKey.boolean('common.escalated'), true);
+        expect(query).toHaveBeenCalledWith(expect.stringContaining('jsonb_set'), [
+            'conversation-1',
+            'common.escalated',
+            'true',
+        ]);
+    });
+    it('validates values before writing', async () => {
+        const query = vi.fn();
+        const analytics = new PostgresAnalytics({ query });
+        await expect(analytics
+            .getConversationAnalytics('conversation-1')
+            .set(analyticsKey.number('score'), 'wrong')).rejects.toThrow();
+        expect(query).not.toHaveBeenCalled();
+    });
+    it('reads JSON null as a present value', async () => {
+        const query = vi.fn().mockResolvedValue(result([{ present: true, value: null }]));
+        const analytics = new PostgresAnalytics({ query });
+        await expect(analytics
+            .getConversationAnalytics('conversation-1')
+            .get(analyticsKey.json('result', z.null()))).resolves.toBeNull();
+    });
+    it('returns a common conversation summary', async () => {
+        const startedAt = new Date('2026-08-01T10:00:00Z');
+        const endedAt = new Date('2026-08-01T10:02:00Z');
+        const query = vi.fn().mockResolvedValue(result([
+            {
+                conversation_id: 'conversation-1',
+                agent_id: 'support-agent',
+                channel: 'phone',
+                region: 'GB',
+                started_at: startedAt,
+                ended_at: endedAt,
+                duration_seconds: 120,
+            },
+        ]));
+        const analytics = new PostgresAnalytics({ query });
+        await expect(analytics.getConversationAnalytics('conversation-1').getSummary()).resolves.toEqual({
+            conversationId: 'conversation-1',
+            agentId: 'support-agent',
+            channel: 'phone',
+            region: 'GB',
+            startedAt,
+            endedAt,
+            durationSeconds: 120,
+        });
+    });
+});

package/build/timeouts-manager.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from '@recombine-ai/engine';
-import { ContextCache } from './context-cache';
+import { ContextCache } from './context-cache.js';
 export type TimeoutsState = {
     timeouts: Record<string, number>;
 };

package/build/timeouts-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeouts-manager.d.ts","sourceRoot":"","sources":["../src/timeouts-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAK9C,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAKD,KAAK,kBAAkB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAC,OAAO,CAAA;CACxB,CAAA;AAED,qBAAa,cAAc;IAOnB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM;IAEvB,OAAO,CAAC,SAAS;IANrB,QAAQ,CAAC,mBAAmB,kDAAwD;gBAGvE,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC,EAC1C,MAAM,EAAE,MAAM,EAEf,SAAS,UAAQ;IAQ7B,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAYzB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAWlE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IA4B7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM;IAmEvF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYxD"}
+{"version":3,"file":"timeouts-manager.d.ts","sourceRoot":"","sources":["../src/timeouts-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKjD,MAAM,MAAM,aAAa,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACnC,CAAA;AAKD,KAAK,kBAAkB,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAC,OAAO,CAAA;CACxB,CAAA;AAED,qBAAa,cAAc;IAOnB,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM;IAEvB,OAAO,CAAC,SAAS;IANrB,QAAQ,CAAC,mBAAmB,kDAAwD;gBAGvE,aAAa,EAAE,YAAY,CAAC,aAAa,CAAC,EAC1C,MAAM,EAAE,MAAM,EAEf,SAAS,UAAQ;IAQ7B,gBAAgB,CAAC,MAAM,EAAE,MAAM;IAYzB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAWlE,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IA4B7D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM;IAmEvF,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAYxD"}

package/build/timeouts-manager.js

@@ -1,7 +1,4 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeoutManager = void 0;
-class TimeoutManager {
+export class TimeoutManager {
     timeoutsCache;
     logger;
     shallSkip;
@@ -100,4 +97,3 @@ class TimeoutManager {
         this.logger.debug(`TimeoutManager: cleared all timeouts`, { callId });
     }
 }
-exports.TimeoutManager = TimeoutManager;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recombine-ai/platform",
-  "version": "0.2.5",
+  "version": "0.2.6-test.2",
   "description": "Recombine AI: voice agent platform",
   "license": "EULA",
   "author": "recombine.ai",
@@ -12,18 +12,27 @@
   "files": [
     "build"
   ],
-  "main": "./build/index.js",
+  "type": "module",
   "types": "./build/index.d.ts",
   "dependencies": {
     "@recombine-ai/engine": "1.0.0",
-    "@recombine-ai/telescope": "^0.3.0",
+    "@recombine-ai/telescope": "0.2.0",
+    "pg": "8.16.3",
     "redis": "5.11.0",
     "zod": "^4.4.3"
   },
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "import": "./build/index.js",
+      "default": "./build/index.js"
+    }
+  },
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
   "devDependencies": {
-    "@types/node": "^25.2.3"
+    "@types/node": "^25.2.3",
+    "@types/pg": "8.15.5"
   }
 }