@recombine-ai/platform 0.2.6-test.1 → 0.2.6-test.10

package/build/postgres-analytics.js

@@ -0,0 +1,295 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PostgresConversationRepository = exports.PostgresAnalytics = void 0;
+exports.migrateAnalyticsDatabase = migrateAnalyticsDatabase;
+exports.createPostgresAnalyticsServices = createPostgresAnalyticsServices;
+const pg_1 = require("pg");
+const analytics_1 = require("./analytics");
+const postgres_analytics_query_1 = require("./postgres-analytics-query");
+class PostgresAnalytics {
+    database;
+    constructor(database) {
+        this.database = database;
+    }
+    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[$3::text], $4::jsonb, true),
+                 updated_at = now()
+             WHERE conversation_id = $1
+               AND agent_id = $2`, [conversationId, agentId, fieldName, serialized]);
+        assertConversationBelongsToAgent(result.rowCount, conversationId, agentId);
+    }
+    async clear(conversationId, agentId, fieldName) {
+        const result = await this.database.query(`UPDATE conversations
+             SET analytics = analytics - $3::text,
+                 updated_at = now()
+             WHERE conversation_id = $1
+               AND agent_id = $2`, [conversationId, agentId, fieldName]);
+        assertConversationBelongsToAgent(result.rowCount, conversationId, agentId);
+    }
+    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
+               AND agent_id = $2`, [conversationId, agentId, fieldName]);
+        if (result.rows.length === 0 || !result.rows[0].present) {
+            return undefined;
+        }
+        return result.rows[0].value;
+    }
+    async getSummary(conversationId, agentId) {
+        const result = await this.database.query(`SELECT conversation_id, agent_id, channel, started_at
+             FROM conversations
+             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 assertConversationBelongsToAgent(rowCount, conversationId, agentId) {
+    if (rowCount !== 1) {
+        throw new Error(`Conversation '${conversationId}' does not belong to agent '${agentId}'`);
+    }
+}
+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, conversation.conversationId, phoneCall);
+            }
+            await client.query('COMMIT');
+        }
+        catch (error) {
+            await client.query('ROLLBACK');
+            throw error;
+        }
+        finally {
+            client.release();
+        }
+    }
+    async upsertConversation(client, conversation) {
+        const result = await client.query(`INSERT INTO conversations (
+                 conversation_id,
+                 agent_id,
+                 channel,
+                 region,
+                 started_at,
+                 ended_at
+             ) VALUES ($1, $2, $3, $4, $5, $6)
+             ON CONFLICT (conversation_id) DO UPDATE SET
+                 agent_id = COALESCE(conversations.agent_id, EXCLUDED.agent_id),
+                 region = COALESCE(conversations.region, EXCLUDED.region),
+                 ended_at = COALESCE(conversations.ended_at, EXCLUDED.ended_at),
+                 updated_at = now()
+             WHERE conversations.agent_id IS NULL
+                OR conversations.agent_id = EXCLUDED.agent_id`, [
+            conversation.conversationId,
+            conversation.agentId,
+            conversation.channel,
+            conversation.region ?? null,
+            conversation.startedAt,
+            conversation.endedAt ?? null,
+        ]);
+        assertConversationBelongsToAgent(result.rowCount, conversation.conversationId, conversation.agentId);
+    }
+    async upsertPhoneCall(client, conversationId, phoneCall) {
+        await client.query(`INSERT INTO phone_calls (
+                 conversation_id,
+                 phone_number,
+                 recording_url,
+                 ended_reason,
+                 duration_seconds
+             ) VALUES ($1, $2, $3, $4, $5)
+             ON CONFLICT (conversation_id) DO UPDATE SET
+                 phone_number = COALESCE(phone_calls.phone_number, EXCLUDED.phone_number),
+                 recording_url = COALESCE(phone_calls.recording_url, EXCLUDED.recording_url),
+                 ended_reason = COALESCE(phone_calls.ended_reason, EXCLUDED.ended_reason),
+                 duration_seconds = COALESCE(
+                     phone_calls.duration_seconds,
+                     EXCLUDED.duration_seconds
+                 )`, [
+            conversationId,
+            phoneCall.phoneNumber ?? null,
+            phoneCall.recordingUrl ?? null,
+            phoneCall.endedReason ?? null,
+            phoneCall.durationSeconds ?? null,
+        ]);
+    }
+}
+exports.PostgresConversationRepository = PostgresConversationRepository;
+const migrations = [
+    {
+        version: 1,
+        sql: `
+            -- Analytics rationale: This is the channel-neutral parent row and top-level JSONB map.
+            -- Removing it leaves typed values with no lifecycle or common dimensions to attach to.
+            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()
+            );
+
+            -- Analytics rationale: Phone-only data stays in a one-to-one child so text conversations
+            -- do not acquire call-specific columns or assumptions.
+            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
+            );
+
+            -- Analytics rationale: These indexes cover time-ordered listing and its common equality
+            -- filters; without them dashboards and Telescope lists degrade to full table scans.
+            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);
+
+            -- Analytics rationale: GIN accelerates JSONB containment filters while the phone index
+            -- supports exact caller lookups joined through the conversation ID.
+            CREATE INDEX conversations_analytics_idx
+                ON conversations USING gin (analytics);
+            CREATE INDEX phone_calls_phone_number_idx
+                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;
+        `,
+    },
+    {
+        version: 3,
+        sql: `
+            -- Analytics rationale: Duration describes a phone call, not every conversation. Move
+            -- existing call durations before removing the phone-specific column from the parent.
+            ALTER TABLE phone_calls
+                ADD COLUMN duration_seconds double precision CHECK (
+                    duration_seconds IS NULL OR duration_seconds >= 0
+                );
+
+            UPDATE phone_calls AS p
+            SET duration_seconds = c.duration_seconds
+            FROM conversations AS c
+            WHERE p.conversation_id = c.conversation_id
+              AND p.duration_seconds IS NULL
+              AND c.duration_seconds IS NOT NULL;
+
+            ALTER TABLE conversations
+                DROP COLUMN duration_seconds;
+        `,
+    },
+];
+async function migrateAnalyticsDatabase(pool) {
+    const client = await pool.connect();
+    let lockAcquired = false;
+    let migrationFailed = false;
+    try {
+        await client.query("SELECT pg_advisory_lock(hashtext('recombine_analytics_migrations'))");
+        lockAcquired = true;
+        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;
+            }
+        }
+    }
+    catch (error) {
+        migrationFailed = true;
+        throw error;
+    }
+    finally {
+        await releaseAnalyticsMigrationClient(client, lockAcquired, migrationFailed);
+    }
+}
+async function releaseAnalyticsMigrationClient(client, lockAcquired, migrationFailed) {
+    let discardClient = false;
+    try {
+        if (lockAcquired) {
+            await client.query("SELECT pg_advisory_unlock(hashtext('recombine_analytics_migrations'))");
+        }
+    }
+    catch (error) {
+        discardClient = true;
+        if (!migrationFailed) {
+            throw error;
+        }
+    }
+    finally {
+        client.release(discardClient);
+    }
+}
+async function createPostgresAnalyticsServices(config) {
+    const pool = new pg_1.Pool(config);
+    try {
+        await migrateAnalyticsDatabase(pool);
+    }
+    catch (error) {
+        await pool.end();
+        throw error;
+    }
+    return {
+        analytics: new PostgresAnalytics(pool),
+        conversations: new PostgresConversationRepository(pool),
+        queries: new postgres_analytics_query_1.PostgresAnalyticsQueryService(pool),
+        close: () => pool.end(),
+    };
+}

package/build/timeouts-manager.d.ts

@@ -1,5 +1,5 @@
 import { Logger } from '@recombine-ai/engine';
-import { ContextCache } from './context-cache.js';
+import { ContextCache } from './context-cache';
 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,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"}
+{"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"}

package/build/timeouts-manager.js

@@ -1,4 +1,7 @@
-export class TimeoutManager {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutManager = void 0;
+class TimeoutManager {
     timeoutsCache;
     logger;
     shallSkip;
@@ -97,3 +100,4 @@ export 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.6-test.1",
+  "version": "0.2.6-test.10",
   "description": "Recombine AI: voice agent platform",
   "license": "EULA",
   "author": "recombine.ai",
@@ -12,21 +12,16 @@
   "files": [
     "build"
   ],
-  "type": "module",
+  "main": "./build/index.js",
   "types": "./build/index.d.ts",
   "dependencies": {
     "@recombine-ai/engine": "1.0.0",
-    "@recombine-ai/telescope": "0.2.0",
+    "@recombine-ai/telescope": "^0.3.0",
+    "@types/pg": "8.15.5",
+    "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"
   },

package/build/analytics.spec.d.ts

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

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

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

package/build/analytics.spec.js

@@ -1,57 +0,0 @@
-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);
-    });
-});