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

package/build/analytics.d.ts

@@ -2,29 +2,41 @@ import { z } from 'zod';
 export type AnalyticsJsonValue = boolean | number | string | null | AnalyticsJsonValue[] | {
     [key: string]: AnalyticsJsonValue;
 };
-export interface AnalyticsKey<T> {
-    readonly key: string;
+export type AnalyticsFieldType = 'boolean' | 'json' | '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 interface AnalyticsField<T> extends AnalyticsFieldDefinition<T> {
+    readonly agentId: string;
+    readonly key: string;
+}
+export type AnalyticsFieldDefinitions = Readonly<Record<string, AnalyticsFieldDefinition<unknown>>>;
+export type RegisteredAnalyticsFields<TFields extends AnalyticsFieldDefinitions> = {
+    readonly [TKey in keyof TFields]: AnalyticsField<AnalyticsValue<TFields[TKey]>>;
+};
+export type AnalyticsValue<TField extends AnalyticsFieldDefinition<unknown>> = TField extends AnalyticsFieldDefinition<infer TValue> ? TValue : never;
 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>;
+    registerAgent<TFields extends AnalyticsFieldDefinitions>(agentId: string, fields: TFields): RegisteredAnalyticsFields<TFields>;
+    set<TValue>(conversationId: string, field: AnalyticsField<TValue>, value: TValue): Promise<void>;
+    clear(conversationId: string, field: AnalyticsField<unknown>): Promise<void>;
+    get<TValue>(conversationId: string, field: AnalyticsField<TValue>): Promise<TValue | 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]>;
+    json<T extends AnalyticsJsonValue>(schema: z.ZodType<T>): AnalyticsFieldDefinition<T>;
 };
+export declare function registerAnalyticsFields<TFields extends AnalyticsFieldDefinitions>(agentId: string, fields: TFields): RegisteredAnalyticsFields<TFields>;
 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

@@ -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,57 +1,79 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyticsKey = void 0;
+exports.analyticsField = void 0;
+exports.registerAnalyticsFields = registerAnalyticsFields;
 exports.createInMemoryAnalytics = createInMemoryAnalytics;
 exports.assertAnalyticsJsonValue = assertAnalyticsJsonValue;
 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());
+exports.analyticsField = {
+    boolean() {
+        return defineField('boolean', zod_1.z.boolean());
     },
-    number(key) {
-        return defineKey(key, zod_1.z.number().finite());
+    number() {
+        return defineField('number', zod_1.z.number().finite());
     },
-    string(key) {
-        return defineKey(key, zod_1.z.string());
+    string() {
+        return defineField('string', zod_1.z.string());
     },
-    enum(key, values) {
-        return defineKey(key, zod_1.z.enum(values));
+    enum(values) {
+        return defineField('string', zod_1.z.enum(values));
     },
-    json(key, schema) {
-        return defineKey(key, schema);
+    json(schema) {
+        return defineField('json', schema);
     },
 };
+function registerAnalyticsFields(agentId, fields) {
+    if (agentId.trim() === '') {
+        throw new Error('Analytics agent ID must not be empty');
+    }
+    const registered = Object.fromEntries(Object.entries(fields).map(([key, definition]) => {
+        if (!/^[A-Za-z0-9_.:-]{1,128}$/.test(key)) {
+            throw new Error('Analytics field name contains unsupported characters');
+        }
+        return [key, Object.freeze({ ...definition, agentId, key })];
+    }));
+    return Object.freeze(registered);
+}
 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);
+        registerAgent: registerAnalyticsFields,
+        async set(conversationId, field, value) {
+            const existingAgentId = conversationAgents.get(conversationId);
+            if (existingAgentId !== undefined && existingAgentId !== field.agentId) {
+                throw new Error(`Conversation '${conversationId}' belongs to another agent`);
+            }
+            const parsed = field.schema.parse(value);
             assertAnalyticsJsonValue(parsed);
             const values = conversations.get(conversationId) ?? new Map();
-            values.set(key.key, structuredClone(parsed));
+            values.set(field.key, structuredClone(parsed));
             conversations.set(conversationId, values);
+            conversationAgents.set(conversationId, field.agentId);
         },
-        async clear(conversationId, key) {
+        async clear(conversationId, field) {
+            if (conversationAgents.get(conversationId) !== field.agentId) {
+                return;
+            }
             const values = conversations.get(conversationId);
-            values?.delete(key.key);
+            values?.delete(field.key);
             if (values?.size === 0) {
                 conversations.delete(conversationId);
             }
         },
-        async get(conversationId, key) {
+        async get(conversationId, field) {
+            if (conversationAgents.get(conversationId) !== field.agentId) {
+                return undefined;
+            }
             const values = conversations.get(conversationId);
-            if (!values?.has(key.key)) {
+            if (!values?.has(field.key)) {
                 return undefined;
             }
-            const value = values.get(key.key);
-            return key.schema.parse(structuredClone(value));
+            return field.schema.parse(structuredClone(values.get(field.key)));
         },
         async getSummary(conversationId) {
             const summary = summariesById.get(conversationId);

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

@@ -24,7 +24,7 @@ export type AnalyticsQueryParameters = Readonly<Record<string, unknown>>;
 export interface TelescopeConversation {
     conversationId: string;
     medium: string;
-    agentId?: string;
+    agentId: string;
     region?: string;
     phoneNumber?: string;
     duration?: 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,7 +294,7 @@ 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,
@@ -339,12 +336,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 { Analytics, AnalyticsField, AnalyticsFieldDefinitions, ConversationAnalyticsSummary, RegisteredAnalyticsFields } from './analytics';
 import { PostgresAnalyticsQueryService } from './postgres-analytics-query';
 export interface ConversationRecord {
     conversationId: string;
-    agentId?: string;
+    agentId: string;
     channel: string;
     region?: string;
     startedAt: Date;
@@ -21,9 +21,10 @@ interface Queryable {
 export declare class PostgresAnalytics implements Analytics {
     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>;
+    registerAgent<TFields extends AnalyticsFieldDefinitions>(agentId: string, fields: TFields): RegisteredAnalyticsFields<TFields>;
+    set<TValue>(conversationId: string, field: AnalyticsField<TValue>, value: TValue): Promise<void>;
+    clear(conversationId: string, field: AnalyticsField<unknown>): Promise<void>;
+    get<TValue>(conversationId: string, field: AnalyticsField<TValue>): Promise<TValue | undefined>;
     getSummary(conversationId: string): Promise<ConversationAnalyticsSummary | undefined>;
 }
 export declare class PostgresConversationRepository {

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,SAAS,EACT,cAAc,EACd,yBAAyB,EACzB,4BAA4B,EAC5B,yBAAyB,EAG5B,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,SAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,SAAS;IAEhD,aAAa,CAAC,OAAO,SAAS,yBAAyB,EACnD,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GAChB,yBAAyB,CAAC,OAAO,CAAC;IAI/B,GAAG,CAAC,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,EAC7B,KAAK,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAqBV,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5E,GAAG,CAAC,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAiBxB,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,GAAG,SAAS,CAAC;CAsB9F;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,64 @@ class PostgresAnalytics {
     constructor(database) {
         this.database = database;
     }
-    async set(conversationId, key, value) {
-        const parsed = key.schema.parse(value);
+    registerAgent(agentId, fields) {
+        return (0, analytics_1.registerAnalyticsFields)(agentId, fields);
+    }
+    async set(conversationId, field, value) {
+        const parsed = field.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`);
+            throw new Error(`Analytics value for '${field.key}' is not valid JSON`);
         }
         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, field.agentId, field.key, serialized]);
+        assertConversationBelongsToAgent(result.rowCount, conversationId, field.agentId);
     }
-    async clear(conversationId, key) {
+    async clear(conversationId, field) {
         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, field.agentId, field.key]);
+        assertConversationBelongsToAgent(result.rowCount, conversationId, field.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, field) {
+        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, field.agentId, field.key]);
         if (result.rows.length === 0 || !result.rows[0].present) {
             return undefined;
         }
-        return key.schema.parse(result.rows[0].value);
+        return field.schema.parse(result.rows[0].value);
     }
     async getSummary(conversationId) {
-        const result = await this.database.query(`SELECT conversation_id, channel, started_at
+        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 IS NOT NULL
+               AND btrim(agent_id) <> ''`, [conversationId]);
         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 +95,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 +112,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 +196,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.8",
   "description": "Recombine AI: voice agent platform",
   "license": "EULA",
   "author": "recombine.ai",