@recombine-ai/platform 0.1.0 → 0.1.1

package/build/context-cache.d.ts

@@ -0,0 +1,17 @@
+import { RedisClientType } from 'redis';
+export declare function createInMemoryCache<TContext extends object>(): {
+    getContext: {
+        (callId: string): Promise<TContext>;
+        (callId: string, defaultContext: TContext): Promise<TContext>;
+    };
+    setContext(callId: string, context: TContext): Promise<void>;
+    clearContext(callId: string): Promise<void>;
+};
+export declare function createRedisCache<TContext extends object>(client: RedisClientType, options?: RedisCacheOptions): ContextCache<TContext>;
+export type ContextCache<TContext extends object> = ReturnType<typeof createInMemoryCache<TContext>>;
+export type RedisCacheOptions = {
+    keyPrefix?: string;
+    ttlSeconds?: number;
+    prolongOnGet?: boolean;
+};
+//# sourceMappingURL=context-cache.d.ts.map

package/build/context-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-cache.d.ts","sourceRoot":"","sources":["../src/context-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAc,MAAM,OAAO,CAAA;AAEnD,wBAAgB,mBAAmB,CAAC,QAAQ,SAAS,MAAM;;iBAGrB,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;iBAC1B,MAAM,kBAAkB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;;uBAazD,MAAM,WAAW,QAAQ;yBAGvB,MAAM;EAIxC;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,MAAM,EACpD,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,iBAA+C,GACzD,YAAY,CAAC,QAAQ,CAAC,CAsExB;AAED,MAAM,MAAM,YAAY,CAAC,QAAQ,SAAS,MAAM,IAAI,UAAU,CAAC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAA;AAMpG,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA"}

package/build/context-cache.js

@@ -0,0 +1,68 @@
+export function createInMemoryCache() {
+    const cache = new Map();
+    async function getContext(callId, defaultContext) {
+        if (cache.has(callId)) {
+            return cache.get(callId);
+        }
+        else if (defaultContext) {
+            const context = clone(defaultContext);
+            cache.set(callId, context);
+            return context;
+        }
+        throw new Error(`Cannot find context for ${callId}`);
+    }
+    return {
+        getContext,
+        async setContext(callId, context) {
+            cache.set(callId, context);
+        },
+        async clearContext(callId) {
+            cache.delete(callId);
+        },
+    };
+}
+export function createRedisCache(client, options = DEFAULT_REDIS_CACHE_OPTIONS) {
+    function createKey(callId) {
+        return options.keyPrefix + callId;
+    }
+    async function getContext(callId, defaultContext) {
+        const data = await client.get(createKey(callId));
+        if (data) {
+            if (options.prolongOnGet && options.ttlSeconds) {
+                await client.expire(createKey(callId), options.ttlSeconds);
+            }
+            return JSON.parse(data);
+        }
+        if (defaultContext) {
+            await setContext(callId, defaultContext);
+            return clone(defaultContext);
+        }
+        throw new Error(`Cannot find context for ${callId}`);
+    }
+    async function setContext(callId, context) {
+        const key = createKey(callId);
+        const value = JSON.stringify(context);
+        const setOptions = {};
+        if (options.ttlSeconds) {
+            setOptions.expiration = { type: 'EX', value: options.ttlSeconds };
+        }
+        await client.set(key, value, setOptions);
+    }
+    async function clearContext(callId) {
+        const key = createKey(callId);
+        await client.del(key);
+    }
+    return {
+        getContext,
+        setContext,
+        clearContext,
+    };
+}
+function clone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+const DEFAULT_REDIS_CACHE_OPTIONS = {
+    keyPrefix: 'agent:context:',
+    ttlSeconds: 900,
+    prolongOnGet: true,
+};

package/build/index.d.ts

@@ -1,6 +1,5 @@
-export * from './interfaces/agent';
-export * from './interfaces/step-registry';
-export * from './context';
-export * from './mock';
-export * from './stubs';
+export * from './interfaces/platform';
+export * from './interfaces/rc-voice';
+export * from './context-cache';
+export * from './timeouts-manager';
 //# 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,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,WAAW,CAAA;AACzB,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA"}
+{"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"}

package/build/index.js

@@ -0,0 +1,4 @@
+export * from './interfaces/platform';
+export * from './interfaces/rc-voice';
+export * from './context-cache';
+export * from './timeouts-manager';

package/build/interfaces/platform.d.ts

@@ -0,0 +1,39 @@
+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';
+export interface IModels {
+    models: Record<string, LlmAdapter>;
+    streamingModels: Record<string, LlmStreamAdapter>;
+}
+export interface Platform<TContext extends {}, TModels extends IModels> {
+    streamAi: AIStreamEngine<TContext>;
+    ai: AIEngine<TContext>;
+    fs: PromptFS;
+    rcVoice: IRcVoice;
+    logger: Logger;
+    timeoutManager: TimeoutManager;
+    models: TModels['models'];
+    streamingModels: TModels['streamingModels'];
+    contextCache: ContextCache<TContext>;
+}
+export interface CallInfo {
+    callId: string;
+    phoneNumber?: string;
+    headers: Record<string, unknown>;
+}
+export interface VoiceAgent {
+    onCallStart: (call: CallInfo) => Promise<{
+        initialMessage: string;
+        initialSettings?: Record<string, string | number>;
+    }>;
+    onCallReady: (call: CallInfo) => Promise<void>;
+    streamResponse: (messages: Message[], call: CallInfo) => Promise<ReadableStream<ResponseChunk>>;
+    onCallEnd: (call: CallInfo) => 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;
+//# sourceMappingURL=platform.d.ts.map

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

@@ -0,0 +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"}

package/build/interfaces/platform.js

@@ -0,0 +1,3 @@
+export function createAgent(creator) {
+    return creator;
+}

package/build/interfaces/rc-voice.d.ts

@@ -0,0 +1,53 @@
+import { Message } from '@recombine-ai/engine';
+export interface IRcVoice {
+    setVoiceSetting(voiceSettings: Record<string, string | number>): Promise<void>;
+    setUpSip(agentName: string, trunks: TrunksCredentials): Promise<void>;
+    steer(callId: string, payload: SteerPayload): Promise<void>;
+    freeze(callId: string): Promise<void>;
+    unfreeze(callId: string): Promise<void>;
+    addMessage(callId: string, message: Message): Promise<void>;
+    reload(callId: string): Promise<void>;
+    transfer(agentName: string, destination: string, callId: string, disclaimer?: string, headers?: Record<string, string>): Promise<void>;
+    hangup(callId: string): Promise<void>;
+    getCallDetails(callId: string): Promise<CallDetails>;
+}
+export type TrunksCredentials = any;
+export interface SteerPayload {
+    respond?: boolean;
+    switchToAgent?: string;
+    addMessages?: {
+        sender: 'user' | 'agent' | 'system';
+        text: string;
+    }[];
+    ignoreWhen?: 'agentSpeaks' | 'userSpeaks' | 'anyoneSpeaks';
+}
+export interface VoiceAgentConnector {
+    setUpSip(): Promise<void>;
+    freeze(callId: string): Promise<void>;
+    unfreeze(callId: string): Promise<void>;
+    addMessage(callId: string, message: Message): Promise<void>;
+    setVoiceSettings(settings: Record<string, string | number>): Promise<void>;
+    reload(callId: string): Promise<void>;
+    transfer(destination: string, callId: string, headers?: Record<string, string>, reason?: TransferReason, disclaimer?: string, waitBefore?: number): Promise<void>;
+    hangup(callId: string, waitBefore?: number): Promise<void>;
+    getCallDetails(callId: string): Promise<CallDetails | null>;
+}
+export type TransferReason = 'escalation' | 'error';
+export interface CallDetails {
+    callId: string;
+    callStart: string;
+    callEnd: string;
+    error: null | string;
+    recording: null | string;
+    callDuration: number;
+    endedReason: string;
+    transcript: TranscriptItem[];
+    messages: Message[];
+}
+export interface TranscriptItem {
+    text: string;
+    role: 'User' | 'Agent';
+    time: string;
+    duration: number;
+}
+//# sourceMappingURL=rc-voice.d.ts.map

package/build/interfaces/rc-voice.d.ts.map

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

package/build/interfaces/rc-voice.js

@@ -0,0 +1 @@
+export {};

package/build/timeouts-manager.d.ts

@@ -0,0 +1,23 @@
+import { Logger } from '@recombine-ai/engine';
+import { ContextCache } from './context-cache';
+export type TimeoutsState = {
+    timeouts: Record<string, number>;
+};
+type CallTimeoutsRecord = {
+    id: number;
+    timer: NodeJS.Timeout;
+};
+export declare class TimeoutManager {
+    readonly timeoutsCache: ContextCache<TimeoutsState>;
+    readonly logger: Logger;
+    private shallSkip;
+    readonly activeLocalTimeouts: Map<string, Record<string, CallTimeoutsRecord>>;
+    constructor(timeoutsCache: ContextCache<TimeoutsState>, logger: Logger, shallSkip?: boolean);
+    getLocalTimeouts(callId: string): Record<string, CallTimeoutsRecord>;
+    getActiveTimeouts(callId: string): Promise<Record<string, number>>;
+    deleteTimeout(callId: string, key: string, timeoutId?: number): Promise<void>;
+    setTimeout(callId: string, key: string, cb: () => Promise<void> | void, timeout: number): Promise<void>;
+    clearAllTimeouts(callId: string): Promise<void>;
+}
+export {};
+//# sourceMappingURL=timeouts-manager.d.ts.map

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

@@ -0,0 +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"}

package/build/timeouts-manager.js

@@ -0,0 +1,99 @@
+export class TimeoutManager {
+    timeoutsCache;
+    logger;
+    shallSkip;
+    activeLocalTimeouts = new Map();
+    constructor(timeoutsCache, logger, shallSkip = false) {
+        this.timeoutsCache = timeoutsCache;
+        this.logger = logger;
+        this.shallSkip = shallSkip;
+    }
+    getLocalTimeouts(callId) {
+        if (!this.activeLocalTimeouts.has(callId)) {
+            this.activeLocalTimeouts.set(callId, {});
+        }
+        return this.activeLocalTimeouts.get(callId);
+    }
+    async getActiveTimeouts(callId) {
+        const state = await this.timeoutsCache.getContext(callId, { timeouts: {} });
+        return state.timeouts;
+    }
+    async deleteTimeout(callId, key, timeoutId) {
+        const state = await this.timeoutsCache.getContext(callId);
+        if (state?.timeouts[key] && (!timeoutId || state.timeouts[key] === timeoutId)) {
+            delete state.timeouts[key];
+            await this.timeoutsCache.setContext(callId, state);
+            this.logger.debug(`TimeoutManager: removed timeout '${key}' from state`, {
+                callId,
+                key,
+                timeoutId,
+            });
+        }
+        const localTimeouts = this.getLocalTimeouts(callId);
+        if (localTimeouts[key] && (!timeoutId || localTimeouts[key].id === timeoutId)) {
+            clearTimeout(localTimeouts[key].timer);
+            delete localTimeouts[key];
+        }
+    }
+    async setTimeout(callId, key, cb, timeout) {
+        if (this.shallSkip) {
+            return;
+        }
+        const localTimeouts = this.getLocalTimeouts(callId);
+        if (localTimeouts[key]) {
+            clearTimeout(localTimeouts[key].timer);
+        }
+        const timeoutId = Date.now();
+        const state = await this.timeoutsCache.getContext(callId, { timeouts: {} });
+        state.timeouts[key] = timeoutId;
+        await this.timeoutsCache.setContext(callId, state);
+        const createdTimeout = setTimeout(() => {
+            void (async () => {
+                const currentState = await this.timeoutsCache.getContext(callId);
+                if (!currentState)
+                    return;
+                if (currentState.timeouts[key] !== timeoutId) {
+                    this.logger.debug('TimeoutManager: skipping timeout (cancelled or superseded)', {
+                        callId,
+                        key,
+                        timeoutId,
+                        currentTimeoutId: currentState.timeouts[key] || null,
+                    });
+                    return;
+                }
+                try {
+                    await cb();
+                    this.logger.debug('TimeoutManager: executed timeout', {
+                        callId,
+                        timeoutId,
+                        key,
+                    });
+                }
+                catch (error) {
+                    this.logger.error('TimeoutManager: error processing timeout', {
+                        callId,
+                        key,
+                        error,
+                    });
+                }
+                finally {
+                    await this.deleteTimeout(callId, key, timeoutId);
+                }
+            })();
+        }, timeout);
+        localTimeouts[key] = { id: timeoutId, timer: createdTimeout };
+        this.logger.debug(`TimeoutManager: set timeout '${key}' in ${timeout} ms`, {
+            callId,
+            timeoutId,
+        });
+    }
+    async clearAllTimeouts(callId) {
+        const localTimeouts = this.getLocalTimeouts(callId);
+        for (const key in localTimeouts) {
+            clearTimeout(localTimeouts[key].timer);
+        }
+        this.activeLocalTimeouts.delete(callId);
+        await this.timeoutsCache.clearContext(callId);
+        this.logger.debug(`TimeoutManager: cleared all timeouts`, { callId });
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@recombine-ai/platform",
-    "version": "0.1.0",
+    "version": "0.1.1",
     "description": "Recombine AI: voice agent platform",
     "license": "EULA",
     "author": "recombine.ai",
@@ -13,14 +13,19 @@
         "build"
     ],
     "type": "module",
+    "types": "./build/index.d.ts",
     "dependencies": {
         "@recombine-ai/engine": "1.0.0",
-        "@recombine-ai/telescope": "0.1.0",
+        "@recombine-ai/telescope": "0.1.1",
         "redis": "5.11.0",
         "zod": "^4.4.3"
     },
     "exports": {
-        ".": "./src/index.ts"
+        ".": {
+            "types": "./build/index.d.ts",
+            "import": "./build/index.js",
+            "default": "./build/index.js"
+        }
     },
     "publishConfig": {
         "registry": "https://registry.npmjs.org"