@recombine-ai/platform 0.2.6-test.7 → 0.2.6-test.9

package/build/analytics.d.ts

@@ -1,30 +1,40 @@
 import { z } from 'zod';
-export type AnalyticsJsonValue = boolean | number | string | null | AnalyticsJsonValue[] | {
-    [key: string]: AnalyticsJsonValue;
-};
-export interface AnalyticsKey<T> {
-    readonly key: string;
+export type AnalyticsScalar = boolean | number | string;
+export type AnalyticsFieldType = 'boolean' | 'number' | 'string';
+export interface AnalyticsFieldDefinition<T> {
+    readonly type: AnalyticsFieldType;
     readonly schema: z.ZodType<T>;
 }
-export type AnalyticsValue<TKey extends AnalyticsKey<unknown>> = TKey extends AnalyticsKey<infer TValue> ? TValue : never;
+export type AnalyticsFieldDefinitions = Readonly<Record<string, AnalyticsFieldDefinition<unknown>>>;
+export type AnalyticsValue<TField extends AnalyticsFieldDefinition<unknown>> = TField extends AnalyticsFieldDefinition<infer TValue> ? TValue : never;
+type AnalyticsFieldName<TFields extends AnalyticsFieldDefinitions> = Extract<keyof TFields, string>;
 export interface ConversationAnalyticsSummary {
     conversationId: string;
+    agentId: string;
     channel: string;
     startedAt: Date;
 }
-export interface Analytics {
-    set<TKey extends AnalyticsKey<unknown>>(conversationId: string, key: TKey, value: AnalyticsValue<TKey>): Promise<void>;
-    clear(conversationId: string, key: AnalyticsKey<unknown>): Promise<void>;
-    get<TKey extends AnalyticsKey<unknown>>(conversationId: string, key: TKey): Promise<AnalyticsValue<TKey> | undefined>;
+export interface AnalyticsStore {
+    set(conversationId: string, agentId: string, fieldName: string, value: AnalyticsScalar): Promise<void>;
+    clear(conversationId: string, agentId: string, fieldName: string): Promise<void>;
+    get(conversationId: string, agentId: string, fieldName: string): Promise<unknown | undefined>;
+    getSummary(conversationId: string, agentId: string): Promise<ConversationAnalyticsSummary | undefined>;
+}
+export interface AgentAnalytics<TFields extends AnalyticsFieldDefinitions> {
+    set<TName extends AnalyticsFieldName<TFields>>(conversationId: string, fieldName: TName, value: AnalyticsValue<TFields[TName]>): Promise<void>;
+    clear<TName extends AnalyticsFieldName<TFields>>(conversationId: string, fieldName: TName): Promise<void>;
+    get<TName extends AnalyticsFieldName<TFields>>(conversationId: string, fieldName: TName): Promise<AnalyticsValue<TFields[TName]> | undefined>;
     getSummary(conversationId: string): Promise<ConversationAnalyticsSummary | undefined>;
 }
-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 const analyticsField: {
+    boolean(): AnalyticsFieldDefinition<boolean>;
+    number(): AnalyticsFieldDefinition<number>;
+    string(): AnalyticsFieldDefinition<string>;
+    enum<const TValues extends readonly [string, ...string[]]>(values: TValues): AnalyticsFieldDefinition<TValues[number]>;
 };
-export declare function createInMemoryAnalytics(summaries?: ConversationAnalyticsSummary[]): Analytics;
-export declare function assertAnalyticsJsonValue(value: unknown): asserts value is AnalyticsJsonValue;
+export declare function validateAgentAnalytics(agentId: string, fields: AnalyticsFieldDefinitions): void;
+export declare function createAgentAnalytics<TFields extends AnalyticsFieldDefinitions>(store: AnalyticsStore, agentId: string, fields: TFields): AgentAnalytics<TFields>;
+export declare function createInMemoryAnalytics(summaries?: ConversationAnalyticsSummary[]): AnalyticsStore;
+export declare function assertAnalyticsScalar(value: unknown): asserts value is AnalyticsScalar;
+export {};
 //# sourceMappingURL=analytics.d.ts.map

package/build/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,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;AAI3C,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;CAChC;AAID,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,IACzD,IAAI,SAAS,YAAY,CAAC,MAAM,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAA;AAI5D,MAAM,WAAW,4BAA4B;IACzC,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAClB;AAID,MAAM,WAAW,SAAS;IAGtB,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAClC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EAClC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,IAAI,GACV,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;IAC5C,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAAA;CACxF;AAgBD,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;SAK3B,CAAC,SAAS,kBAAkB,OAAO,MAAM,UAAU,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CAKzF,CAAA;AAID,wBAAgB,uBAAuB,CAAC,SAAS,GAAE,4BAA4B,EAAO,GAAG,SAAS,CA8CjG;AAID,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CA0B5F"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../src/analytics.ts"],"names":[],"mappings":"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"}

package/build/analytics.js

@@ -1,78 +1,114 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyticsKey = void 0;
+exports.analyticsField = void 0;
+exports.validateAgentAnalytics = validateAgentAnalytics;
+exports.createAgentAnalytics = createAgentAnalytics;
 exports.createInMemoryAnalytics = createInMemoryAnalytics;
-exports.assertAnalyticsJsonValue = assertAnalyticsJsonValue;
+exports.assertAnalyticsScalar = assertAnalyticsScalar;
 const zod_1 = require("zod");
-function defineKey(key, schema) {
-    if (!/^[A-Za-z0-9_.:-]{1,128}$/.test(key)) {
-        throw new Error('Analytics key contains unsupported characters');
-    }
-    return Object.freeze({ key, schema });
+function defineField(type, schema) {
+    return Object.freeze({ type, schema });
 }
-exports.analyticsKey = {
-    boolean(key) {
-        return defineKey(key, zod_1.z.boolean());
-    },
-    number(key) {
-        return defineKey(key, zod_1.z.number().finite());
+exports.analyticsField = {
+    boolean() {
+        return defineField('boolean', zod_1.z.boolean());
     },
-    string(key) {
-        return defineKey(key, zod_1.z.string());
+    number() {
+        return defineField('number', zod_1.z.number().finite());
     },
-    enum(key, values) {
-        return defineKey(key, zod_1.z.enum(values));
+    string() {
+        return defineField('string', zod_1.z.string());
     },
-    json(key, schema) {
-        return defineKey(key, schema);
+    enum(values) {
+        return defineField('string', zod_1.z.enum(values));
     },
 };
+function validateAgentAnalytics(agentId, fields) {
+    if (agentId.trim() === '') {
+        throw new Error('Analytics agent ID must not be empty');
+    }
+    for (const [fieldName, definition] of Object.entries(fields)) {
+        if (!/^[A-Za-z0-9_.:-]{1,128}$/.test(fieldName)) {
+            throw new Error('Analytics field name contains unsupported characters');
+        }
+        if (!['boolean', 'number', 'string'].includes(definition.type)) {
+            throw new Error(`Analytics field '${fieldName}' has an unsupported type`);
+        }
+    }
+}
+function createAgentAnalytics(store, agentId, fields) {
+    validateAgentAnalytics(agentId, fields);
+    const getDefinition = (fieldName) => {
+        const definition = fields[fieldName];
+        if (!definition) {
+            throw new Error(`Analytics field '${fieldName}' is not declared for agent '${agentId}'`);
+        }
+        return definition;
+    };
+    const parseValue = (fieldName, value) => getDefinition(fieldName).schema.parse(value);
+    return {
+        async set(conversationId, fieldName, value) {
+            const parsed = parseValue(fieldName, value);
+            assertAnalyticsScalar(parsed);
+            await store.set(conversationId, agentId, fieldName, parsed);
+        },
+        async clear(conversationId, fieldName) {
+            getDefinition(fieldName);
+            await store.clear(conversationId, agentId, fieldName);
+        },
+        async get(conversationId, fieldName) {
+            getDefinition(fieldName);
+            const value = await store.get(conversationId, agentId, fieldName);
+            return value === undefined ? undefined : parseValue(fieldName, value);
+        },
+        getSummary(conversationId) {
+            return store.getSummary(conversationId, agentId);
+        },
+    };
+}
 function createInMemoryAnalytics(summaries = []) {
     const conversations = new Map();
+    const conversationAgents = new Map(summaries.map((summary) => [summary.conversationId, summary.agentId]));
     const summariesById = new Map(summaries.map((summary) => [summary.conversationId, structuredClone(summary)]));
     return {
-        async set(conversationId, key, value) {
-            const parsed = key.schema.parse(value);
-            assertAnalyticsJsonValue(parsed);
+        async set(conversationId, agentId, fieldName, value) {
+            const existingAgentId = conversationAgents.get(conversationId);
+            if (existingAgentId !== undefined && existingAgentId !== agentId) {
+                throw new Error(`Conversation '${conversationId}' belongs to another agent`);
+            }
+            assertAnalyticsScalar(value);
             const values = conversations.get(conversationId) ?? new Map();
-            values.set(key.key, structuredClone(parsed));
+            values.set(fieldName, value);
             conversations.set(conversationId, values);
+            conversationAgents.set(conversationId, agentId);
         },
-        async clear(conversationId, key) {
+        async clear(conversationId, agentId, fieldName) {
+            if (conversationAgents.get(conversationId) !== agentId) {
+                return;
+            }
             const values = conversations.get(conversationId);
-            values?.delete(key.key);
+            values?.delete(fieldName);
             if (values?.size === 0) {
                 conversations.delete(conversationId);
             }
         },
-        async get(conversationId, key) {
-            const values = conversations.get(conversationId);
-            if (!values?.has(key.key)) {
+        async get(conversationId, agentId, fieldName) {
+            if (conversationAgents.get(conversationId) !== agentId) {
                 return undefined;
             }
-            const value = values.get(key.key);
-            return key.schema.parse(structuredClone(value));
+            return conversations.get(conversationId)?.get(fieldName);
         },
-        async getSummary(conversationId) {
+        async getSummary(conversationId, agentId) {
             const summary = summariesById.get(conversationId);
-            return summary ? structuredClone(summary) : undefined;
+            return summary?.agentId === agentId ? structuredClone(summary) : undefined;
         },
     };
 }
-function assertAnalyticsJsonValue(value) {
-    if (value === null ||
-        typeof value === 'boolean' ||
+function assertAnalyticsScalar(value) {
+    if (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');
+    throw new Error('Analytics value must be a boolean, finite number, or string');
 }

package/build/interfaces/platform.d.ts

@@ -1,6 +1,6 @@
 import { ReadableStream } from 'node:stream/web';
 import { AIEngine, AIStreamEngine, LlmAdapter, LlmStreamAdapter, Logger, Message, PromptFS, ResponseChunk } from '@recombine-ai/engine';
-import { Analytics } from '../analytics';
+import { AgentAnalytics, AnalyticsFieldDefinitions, AnalyticsStore } from '../analytics';
 import { ContextCache } from '../context-cache';
 import { TimeoutManager } from '../timeouts-manager';
 import { IRcVoice } from './rc-voice';
@@ -18,24 +18,43 @@ export interface Platform<TContext extends {}, TModels extends IModels, TRcVoice
     models: TModels['models'];
     streamingModels: TModels['streamingModels'];
     contextCache: TContextCache;
-    analytics: Analytics;
+    analytics: AnalyticsStore;
 }
 export interface CallInfo {
     callId: string;
     phoneNumber?: string;
     headers: Record<string, unknown>;
 }
+export type VoiceSettings = Record<string, string | number | boolean | number[]>;
 export interface VoiceAgent {
     onCallStart: (call: CallInfo) => Promise<{
         initialMessage: string;
-        initialSettings?: Record<string, string | number>;
+        initialSettings?: VoiceSettings;
     }>;
     onCallReady: (call: CallInfo) => Promise<void>;
     streamResponse: (messages: Message[], call: CallInfo) => Promise<ReadableStream<ResponseChunk>>;
-    onCallEnd: (call: CallInfo) => Promise<void>;
+    onCallEnd: (call: CallInfo, completedConversation?: Message[]) => Promise<void>;
     onAgentSpeechDone: (messages: Message[], call: CallInfo) => Promise<void>;
     onServiceStartup: () => Promise<void>;
     onFatalError: (callId: string, err: any) => Promise<void>;
 }
-export declare function createAgent<TContext extends {}, TServices, TModels extends IModels>(creator: (platform: Platform<TContext, TModels>, services: TServices) => VoiceAgent): (platform: Platform<TContext, TModels>, services: TServices) => VoiceAgent;
+export type AgentPlatform<TPlatform extends {
+    analytics: AnalyticsStore;
+}, TFields extends AnalyticsFieldDefinitions> = Omit<TPlatform, 'analytics'> & {
+    analytics: AgentAnalytics<TFields>;
+};
+type ComposedPlatform<TContext extends object, TModels extends IModels> = Platform<TContext, TModels, unknown, unknown, unknown>;
+export interface AgentDefinition<TFields extends AnalyticsFieldDefinitions> {
+    readonly agentId: string;
+    readonly analytics: Readonly<TFields>;
+}
+export interface AgentDeclaration<TContext extends object, TServices, TModels extends IModels, TFields extends AnalyticsFieldDefinitions, TPlatform extends ComposedPlatform<TContext, TModels> = Platform<TContext, TModels>> extends AgentDefinition<TFields> {
+    create: (platform: AgentPlatform<TPlatform, TFields>, services: TServices) => VoiceAgent;
+}
+export interface AgentCreator<TContext extends object, TServices, TModels extends IModels, TFields extends AnalyticsFieldDefinitions, TPlatform extends ComposedPlatform<TContext, TModels> = Platform<TContext, TModels>> {
+    (platform: TPlatform, services: TServices): VoiceAgent;
+    readonly definition: AgentDefinition<TFields>;
+}
+export declare function createAgent<TContext extends object, TServices, TModels extends IModels, const TFields extends AnalyticsFieldDefinitions, TPlatform extends ComposedPlatform<TContext, TModels> = Platform<TContext, TModels>>(declaration: AgentDeclaration<TContext, TServices, TModels, TFields, TPlatform>): AgentCreator<TContext, TServices, TModels, TFields, TPlatform>;
+export {};
 //# sourceMappingURL=platform.d.ts.map

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;AAI7B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,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;AAID,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;IAK3B,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"}
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"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"}

package/build/interfaces/platform.js

@@ -1,6 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createAgent = createAgent;
-function createAgent(creator) {
-    return creator;
+const analytics_1 = require("../analytics");
+function createAgent(declaration) {
+    const { agentId, create } = declaration;
+    const analytics = Object.freeze({ ...declaration.analytics });
+    (0, analytics_1.validateAgentAnalytics)(agentId, analytics);
+    const creator = (platform, services) => {
+        const agentPlatform = {
+            ...platform,
+            analytics: (0, analytics_1.createAgentAnalytics)(platform.analytics, agentId, analytics),
+        };
+        return create(agentPlatform, services);
+    };
+    const definition = Object.freeze({ agentId, analytics });
+    return Object.defineProperty(creator, 'definition', {
+        enumerable: true,
+        value: definition,
+    });
 }

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

@@ -1,5 +1,5 @@
 import { PoolConfig, QueryResult } from 'pg';
-import { AnalyticsJsonValue } from './analytics';
+import { AnalyticsScalar } from './analytics';
 export type AnalyticsFilterScalar = boolean | number | string;
 export type AnalyticsFilterValueType = 'boolean' | 'number' | 'string';
 export type AnalyticsFilterOperator = 'eq' | 'exists' | 'gt' | 'gte' | 'in' | 'lt' | 'lte';
@@ -24,14 +24,14 @@ export type AnalyticsQueryParameters = Readonly<Record<string, unknown>>;
 export interface TelescopeConversation {
     conversationId: string;
     medium: string;
-    agentId?: string;
+    agentId: string;
     region?: string;
     phoneNumber?: string;
     duration?: number;
     audioUrl?: string;
     createdAt: number;
     endedAt?: number;
-    analytics: Record<string, AnalyticsJsonValue>;
+    analytics: Record<string, AnalyticsScalar>;
 }
 export interface TelescopeConversationPage {
     limit: number;
@@ -42,14 +42,14 @@ export interface AnalyticsFieldValue {
     value: AnalyticsFilterScalar;
     count: number;
 }
-export interface AnalyticsField {
+export interface AnalyticsFieldMetadata {
     key: string;
     type: AnalyticsFilterValueType;
     variantCount: number;
     values: AnalyticsFieldValue[];
 }
 export interface AnalyticsFields {
-    items: AnalyticsField[];
+    items: AnalyticsFieldMetadata[];
 }
 export interface AnalyticsTimeSeriesItem {
     startAt: string;

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

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

package/build/postgres-analytics-query.js

@@ -20,7 +20,7 @@ class PostgresAnalyticsQueryService {
              LEFT JOIN phone_calls p ON p.conversation_id = c.conversation_id
              WHERE c.conversation_id = $1`, [conversationId]);
         const row = result.rows[0];
-        return row ? conversationRowToJson(row) : undefined;
+        return row?.agent_id ? conversationRowToJson(row) : undefined;
     }
     async getConversations(query) {
         const parsedLimit = Number.parseInt(optionalString(query.limit, 'limit') ?? '10', 10);
@@ -51,13 +51,10 @@ class PostgresAnalyticsQueryService {
         };
     }
     async getAnalyticsFields(query) {
-        const values = [];
-        let where = "WHERE jsonb_typeof(entry.value) IN ('boolean', 'number', 'string')";
-        const agentId = optionalString(query.agentId, 'agentId');
-        if (agentId) {
-            values.push(agentId);
-            where += ` AND c.agent_id = $${values.length}`;
-        }
+        const agentId = requiredString(query.agentId, 'agentId');
+        const values = [agentId];
+        const where = "WHERE jsonb_typeof(entry.value) IN ('boolean', 'number', 'string')" +
+            ' AND c.agent_id = $1';
         const result = await this.database.query(`WITH value_counts AS (
                  SELECT entry.key,
                         jsonb_typeof(entry.value) AS type,
@@ -297,16 +294,24 @@ function conversationRowToJson(row) {
     return {
         conversationId: row.conversation_id,
         medium: row.channel,
-        agentId: row.agent_id || undefined,
+        agentId: row.agent_id,
         region: row.region || undefined,
         phoneNumber: row.phone_number || undefined,
         duration: row.duration_seconds ?? undefined,
         audioUrl: row.recording_url || undefined,
         createdAt: new Date(row.started_at).getTime(),
         endedAt: row.ended_at ? new Date(row.ended_at).getTime() : undefined,
-        analytics: row.analytics ?? {},
+        analytics: analyticsScalars(row.analytics),
     };
 }
+function analyticsScalars(values) {
+    return Object.fromEntries(Object.entries(values ?? {}).filter((entry) => {
+        const value = entry[1];
+        return (typeof value === 'boolean' ||
+            typeof value === 'string' ||
+            (typeof value === 'number' && Number.isFinite(value)));
+    }));
+}
 function analyticsFieldRowsToJson(rows) {
     const fields = new Map();
     for (const row of rows) {
@@ -339,12 +344,11 @@ function buildConversationConditions(query) {
     if (from && to && from >= to) {
         throw new AnalyticsQueryError('from must be earlier than to');
     }
-    const agentId = optionalString(query.agentId, 'agentId');
+    const agentId = requiredString(query.agentId, 'agentId');
     const region = optionalString(query.region, 'region');
     const channel = optionalString(query.channel, 'channel');
     const phoneNumber = optionalString(query.phoneNumber, 'phoneNumber');
-    if (agentId)
-        conditions.push(`c.agent_id = ${bind(agentId)}`);
+    conditions.push(`c.agent_id = ${bind(agentId)}`);
     if (region)
         conditions.push(`c.region = ${bind(region)}`);
     if (channel)

package/build/postgres-analytics.d.ts

@@ -1,9 +1,9 @@
 import { Pool, PoolConfig, QueryResult } from 'pg';
-import { Analytics, AnalyticsKey, AnalyticsValue, ConversationAnalyticsSummary } from './analytics';
+import { AnalyticsScalar, AnalyticsStore, ConversationAnalyticsSummary } from './analytics';
 import { PostgresAnalyticsQueryService } from './postgres-analytics-query';
 export interface ConversationRecord {
     conversationId: string;
-    agentId?: string;
+    agentId: string;
     channel: string;
     region?: string;
     startedAt: Date;
@@ -18,13 +18,13 @@ export interface PhoneCallRecord {
 interface Queryable {
     query<TResult extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<QueryResult<TResult>>;
 }
-export declare class PostgresAnalytics implements Analytics {
+export declare class PostgresAnalytics implements AnalyticsStore {
     private readonly database;
     constructor(database: Queryable);
-    set<TKey extends AnalyticsKey<unknown>>(conversationId: string, key: TKey, value: AnalyticsValue<TKey>): Promise<void>;
-    clear(conversationId: string, key: AnalyticsKey<unknown>): Promise<void>;
-    get<TKey extends AnalyticsKey<unknown>>(conversationId: string, key: TKey): Promise<AnalyticsValue<TKey> | undefined>;
-    getSummary(conversationId: string): Promise<ConversationAnalyticsSummary | undefined>;
+    set(conversationId: string, agentId: string, fieldName: string, value: AnalyticsScalar): Promise<void>;
+    clear(conversationId: string, agentId: string, fieldName: string): Promise<void>;
+    get(conversationId: string, agentId: string, fieldName: string): Promise<unknown | undefined>;
+    getSummary(conversationId: string, agentId: string): Promise<ConversationAnalyticsSummary | undefined>;
 }
 export declare class PostgresConversationRepository {
     private readonly pool;

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

@@ -1 +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,EACT,YAAY,EACZ,cAAc,EACd,4BAA4B,EAE/B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAI1E,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;AAID,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAID,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;IAE1C,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EACxC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,IAAI,EACT,KAAK,EAAE,cAAc,CAAC,IAAI,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC;IAoBV,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxE,GAAG,CAAC,IAAI,SAAS,YAAY,CAAC,OAAO,CAAC,EACxC,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,IAAI,GACV,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;IAgBtC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC;CAmB9F;AAYD,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;YAmBF,kBAAkB;YAqClB,eAAe;CA0BhC;AA4DD,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDxE;AA6BD,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,aAAa,EAAE,8BAA8B,CAAA;IAC7C,OAAO,EAAE,6BAA6B,CAAA;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAID,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAgBpC"}
+{"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,eAAe,EACf,cAAc,EACd,4BAA4B,EAE/B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAA;AAI1E,MAAM,WAAW,kBAAkB;IAC/B,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,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;AAID,MAAM,WAAW,eAAe;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAID,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;AAaD,qBAAa,iBAAkB,YAAW,cAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS;IAE1C,GAAG,CACL,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC;IAeV,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAchF,GAAG,CACL,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IAezB,UAAU,CACZ,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,GAChB,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC;CAqBvD;AAgBD,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;YAmBF,kBAAkB;YA4ClB,eAAe;CA0BhC;AAsED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDxE;AA6BD,MAAM,WAAW,yBAAyB;IACtC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,aAAa,EAAE,8BAA8B,CAAA;IAC7C,OAAO,EAAE,6BAA6B,CAAA;IACtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAID,wBAAsB,+BAA+B,CACjD,MAAM,EAAE,UAAU,GACnB,OAAO,CAAC,yBAAyB,CAAC,CAgBpC"}

package/build/postgres-analytics.js

@@ -11,55 +11,56 @@ class PostgresAnalytics {
     constructor(database) {
         this.database = database;
     }
-    async set(conversationId, key, value) {
-        const parsed = key.schema.parse(value);
-        (0, analytics_1.assertAnalyticsJsonValue)(parsed);
-        const serialized = JSON.stringify(parsed);
-        if (serialized === undefined) {
-            throw new Error(`Analytics value for '${key.key}' is not valid JSON`);
-        }
+    async set(conversationId, agentId, fieldName, value) {
+        (0, analytics_1.assertAnalyticsScalar)(value);
+        const serialized = JSON.stringify(value);
         const result = await this.database.query(`UPDATE conversations
-             SET analytics = jsonb_set(analytics, ARRAY[$2::text], $3::jsonb, true),
+             SET analytics = jsonb_set(analytics, ARRAY[$3::text], $4::jsonb, true),
                  updated_at = now()
-             WHERE conversation_id = $1`, [conversationId, key.key, serialized]);
-        assertConversationExists(result.rowCount, conversationId);
+             WHERE conversation_id = $1
+               AND agent_id = $2`, [conversationId, agentId, fieldName, serialized]);
+        assertConversationBelongsToAgent(result.rowCount, conversationId, agentId);
     }
-    async clear(conversationId, key) {
+    async clear(conversationId, agentId, fieldName) {
         const result = await this.database.query(`UPDATE conversations
-             SET analytics = analytics - $2::text,
+             SET analytics = analytics - $3::text,
                  updated_at = now()
-             WHERE conversation_id = $1`, [conversationId, key.key]);
-        assertConversationExists(result.rowCount, conversationId);
+             WHERE conversation_id = $1
+               AND agent_id = $2`, [conversationId, agentId, fieldName]);
+        assertConversationBelongsToAgent(result.rowCount, conversationId, agentId);
     }
-    async get(conversationId, key) {
-        const result = await this.database.query(`SELECT analytics ? $2::text AS present,
-                    analytics -> $2::text AS value
+    async get(conversationId, agentId, fieldName) {
+        const result = await this.database.query(`SELECT analytics ? $3::text AS present,
+                    analytics -> $3::text AS value
              FROM conversations
-             WHERE conversation_id = $1`, [conversationId, key.key]);
+             WHERE conversation_id = $1
+               AND agent_id = $2`, [conversationId, agentId, fieldName]);
         if (result.rows.length === 0 || !result.rows[0].present) {
             return undefined;
         }
-        return key.schema.parse(result.rows[0].value);
+        return result.rows[0].value;
     }
-    async getSummary(conversationId) {
-        const result = await this.database.query(`SELECT conversation_id, channel, started_at
+    async getSummary(conversationId, agentId) {
+        const result = await this.database.query(`SELECT conversation_id, agent_id, channel, started_at
              FROM conversations
-             WHERE conversation_id = $1`, [conversationId]);
+             WHERE conversation_id = $1
+               AND agent_id = $2`, [conversationId, agentId]);
         const row = result.rows[0];
         if (!row) {
             return undefined;
         }
         return {
             conversationId: row.conversation_id,
+            agentId: row.agent_id,
             channel: row.channel,
             startedAt: row.started_at,
         };
     }
 }
 exports.PostgresAnalytics = PostgresAnalytics;
-function assertConversationExists(rowCount, conversationId) {
+function assertConversationBelongsToAgent(rowCount, conversationId, agentId) {
     if (rowCount !== 1) {
-        throw new Error(`Conversation '${conversationId}' does not exist`);
+        throw new Error(`Conversation '${conversationId}' does not belong to agent '${agentId}'`);
     }
 }
 class PostgresConversationRepository {
@@ -86,7 +87,7 @@ class PostgresConversationRepository {
         }
     }
     async upsertConversation(client, conversation) {
-        await client.query(`INSERT INTO conversations (
+        const result = await client.query(`INSERT INTO conversations (
                  conversation_id,
                  agent_id,
                  channel,
@@ -103,15 +104,18 @@ class PostgresConversationRepository {
                      conversations.duration_seconds,
                      EXCLUDED.duration_seconds
                  ),
-                 updated_at = now()`, [
+                 updated_at = now()
+             WHERE conversations.agent_id IS NULL
+                OR conversations.agent_id = EXCLUDED.agent_id`, [
             conversation.conversationId,
-            conversation.agentId ?? null,
+            conversation.agentId,
             conversation.channel,
             conversation.region ?? null,
             conversation.startedAt,
             conversation.endedAt ?? null,
             conversation.durationSeconds ?? null,
         ]);
+        assertConversationBelongsToAgent(result.rowCount, conversation.conversationId, conversation.agentId);
     }
     async upsertPhoneCall(client, conversationId, phoneCall) {
         await client.query(`INSERT INTO phone_calls (
@@ -184,6 +188,16 @@ const migrations = [
                 ON phone_calls (phone_number, conversation_id);
         `,
     },
+    {
+        version: 2,
+        sql: `
+            -- Analytics rationale: Enforce mandatory agent ownership for new and updated rows
+            -- without making deployment fail on historical conversations that have no agent ID.
+            ALTER TABLE conversations
+                ADD CONSTRAINT conversations_agent_id_required
+                CHECK (agent_id IS NOT NULL AND btrim(agent_id) <> '') NOT VALID;
+        `,
+    },
 ];
 async function migrateAnalyticsDatabase(pool) {
     const client = await pool.connect();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@recombine-ai/platform",
-  "version": "0.2.6-test.7",
+  "version": "0.2.6-test.9",
   "description": "Recombine AI: voice agent platform",
   "license": "EULA",
   "author": "recombine.ai",