@recombine-ai/platform 0.8.0 → 0.9.0

package/build/text-agent-handlers/ports.d.ts

@@ -4,7 +4,6 @@ import type { JobInput } from './jobs.js';
 export interface AgentRecord {
     conversationId: string;
     agentId: string;
-    variantId?: string;
 }
 export interface AgentRegistry {
     getAgent(conversationId: string): Promise<AgentRecord | null>;
@@ -26,7 +25,7 @@ export interface ChatLockStore {
 export interface JobRunner extends Scheduler {
     runJob(input: JobInput): Promise<unknown>;
 }
-export type GetTextAgent<TMeta> = (agentId: string, variantId?: string) => Promise<TextAgent<TMeta>>;
+export type GetTextAgent<TMeta> = (agentId: string) => Promise<TextAgent<TMeta>>;
 export declare function cacheTextAgents<TMeta>(getTextAgent: GetTextAgent<TMeta>): GetTextAgent<TMeta>;
 export type HandlerResponse = {
     statusCode: number;

package/build/text-agent-handlers/ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGzC,MAAM,WAAW,WAAW;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IAEf,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAGD,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC7D,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtE;AAGD,MAAM,WAAW,QAAQ;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAE7D,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1C,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/E,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACxD;AAGD,MAAM,WAAW,SAAU,SAAQ,SAAS;IACxC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5C;AAGD,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAGpG,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAY7F;AAGD,MAAM,MAAM,eAAe,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,wBAAgB,eAAe,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,eAAe,CAEjB"}
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGzC,MAAM,WAAW,WAAW;IACxB,cAAc,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;CAClB;AAGD,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IAC7D,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtE;AAGD,MAAM,WAAW,QAAQ;IACrB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC1B,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAE7D,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE1C,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC/E,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACxD;AAGD,MAAM,WAAW,SAAU,SAAQ,SAAS;IACxC,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5C;AAGD,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAGhF,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAW7F;AAGD,MAAM,MAAM,eAAe,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,wBAAgB,eAAe,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,eAAe,CAEjB"}

package/build/text-agent-handlers/ports.js

@@ -1,12 +1,11 @@
 export function cacheTextAgents(getTextAgent) {
     const agents = new Map();
-    return (agentId, variantId) => {
-        const key = variantId ? `${agentId}#${variantId}` : agentId;
-        let agent = agents.get(key);
+    return (agentId) => {
+        let agent = agents.get(agentId);
         if (!agent) {
-            agent = getTextAgent(agentId, variantId);
-            agents.set(key, agent);
-            agent.catch(() => agents.delete(key));
+            agent = getTextAgent(agentId);
+            agents.set(agentId, agent);
+            agent.catch(() => agents.delete(agentId));
         }
         return agent;
     };

package/build/voice-agent-api/index.d.ts

@@ -2,7 +2,7 @@ export { extractMessageContent, fail, isRecoverableError, mapFromOpenAiMessages,
 export type { ErrorCodes } from './http-helpers.js';
 export { llmCompletionHandler } from './llm-completion-handler.js';
 export { voiceHttpConnect } from './voice-http.js';
-export type { VoiceHttpBindings } from './voice-http.js';
-export { createVoiceRouteResolver } from './route-resolver.js';
-export type { ResolvedVoiceAgent, VoiceRouteResolverOptions } from './route-resolver.js';
+export type { ConversationMeta, VoiceHttpBindings } from './voice-http.js';
+export { createVoiceRouter } from './voice-router.js';
+export type { VoiceRouter, VoiceRouterOptions } from './voice-router.js';
 //# sourceMappingURL=index.d.ts.map

package/build/voice-agent-api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice-agent-api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,qBAAqB,EACrB,IAAI,EACJ,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,GACf,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAA;AAC9D,YAAY,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voice-agent-api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,qBAAqB,EACrB,IAAI,EACJ,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,GACf,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AAClD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA"}

package/build/voice-agent-api/index.js

@@ -1,4 +1,4 @@
 export { extractMessageContent, fail, isRecoverableError, mapFromOpenAiMessages, roleToSender, } from './http-helpers.js';
 export { llmCompletionHandler } from './llm-completion-handler.js';
 export { voiceHttpConnect } from './voice-http.js';
-export { createVoiceRouteResolver } from './route-resolver.js';
+export { createVoiceRouter } from './voice-router.js';

package/build/voice-agent-api/voice-http.d.ts

@@ -1,9 +1,8 @@
 import { FastifyRequest } from 'fastify';
-import { VoiceRoute } from '../agent/index.js';
 import type CallControl from '../call-control/index.js';
-import type { ContextCache } from '../context-cache/index.js';
 import type { NotificationRouter } from '../notifications/index.js';
 import type { ITelescope } from '../telescope/index.js';
+import { type VoiceRouter } from './voice-router.js';
 declare module 'fastify' {
     interface FastifyRequest {
         callId: string;
@@ -13,25 +12,23 @@ declare module 'fastify' {
         phoneNumber?: string;
     }
 }
+export interface ConversationMeta<TMeta> {
+    meta: TMeta;
+    region?: string;
+    phoneNumber?: string;
+    externalConversationId?: string;
+}
 export interface VoiceHttpBindings<TMeta> {
-    getVoiceAgent: (agentName: string) => Promise<VoiceRoute<TMeta>>;
-    allocations?: ContextCache<{
-        variantId: string | null;
-    }>;
+    router: VoiceRouter<TMeta>;
     telescope: ITelescope;
+    callControl: CallControl;
     onStart: () => Promise<void>;
     hostsToPrewarm: string[];
-    headersToMeta: (headers: FastifyRequest['headers']) => TMeta;
-    getConversationMeta: (headers: FastifyRequest['headers']) => {
-        region?: string;
-        phoneNumber?: string;
-    };
-    callControl: CallControl;
+    getConversationMeta: (headers: FastifyRequest['headers']) => ConversationMeta<TMeta>;
     notificationRouter?: NotificationRouter;
-    getExternalConversationId?: (headers: FastifyRequest['headers']) => string | undefined;
     stickyCookieName?: string;
 }
-export declare function voiceHttpConnect<TMeta>({ getVoiceAgent, allocations, telescope, onStart, hostsToPrewarm, headersToMeta, getConversationMeta, callControl, notificationRouter, getExternalConversationId, stickyCookieName, }: VoiceHttpBindings<TMeta>): {
+export declare function voiceHttpConnect<TMeta>({ router, telescope, callControl, onStart, hostsToPrewarm, getConversationMeta, notificationRouter, stickyCookieName, }: VoiceHttpBindings<TMeta>): {
     start: () => Promise<void>;
 };
 //# sourceMappingURL=voice-http.d.ts.map

package/build/voice-agent-api/voice-http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-http.d.ts","sourceRoot":"","sources":["../../src/voice-agent-api/voice-http.ts"],"names":[],"mappings":"AAGA,OAAgB,EAAgB,cAAc,EAAE,MAAM,SAAS,CAAA;AAG/D,OAAO,EAAY,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,uBAAuB,CAAA;AAY9E,OAAO,QAAQ,SAAS,CAAC;IACrB,UAAU,cAAc;QACpB,MAAM,EAAE,MAAM,CAAA;QACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC3B,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,CAAC,EAAE,MAAM,CAAA;KACvB;CACJ;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK;IAEpC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IAKhE,WAAW,CAAC,EAAE,YAAY,CAAC;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IACxD,SAAS,EAAE,UAAU,CAAA;IAErB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,aAAa,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,KAAK,KAAK,CAAA;IAE5D,mBAAmB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,KAAK;QACzD,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,WAAW,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;IAED,WAAW,EAAE,WAAW,CAAA;IACxB,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IACvC,yBAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,KAAK,MAAM,GAAG,SAAS,CAAA;IAEtF,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,EACpC,aAAa,EACb,WAAW,EACX,SAAS,EACT,OAAO,EACP,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,GACnB,EAAE,iBAAiB,CAAC,KAAK,CAAC;;EA+b1B"}
+{"version":3,"file":"voice-http.d.ts","sourceRoot":"","sources":["../../src/voice-agent-api/voice-http.ts"],"names":[],"mappings":"AAGA,OAAgB,EAAgB,cAAc,EAAE,MAAM,SAAS,CAAA;AAK/D,OAAO,KAAK,WAAW,MAAM,0BAA0B,CAAA;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,uBAAuB,CAAA;AAS9E,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG5E,OAAO,QAAQ,SAAS,CAAC;IACrB,UAAU,cAAc;QACpB,MAAM,EAAE,MAAM,CAAA;QACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC3B,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,CAAC,EAAE,MAAM,CAAA;KACvB;CACJ;AAED,MAAM,WAAW,gBAAgB,CAAC,KAAK;IAEnC,IAAI,EAAE,KAAK,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,iBAAiB,CAAC,KAAK;IAEpC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAA;IAC1B,SAAS,EAAE,UAAU,CAAA;IAErB,WAAW,EAAE,WAAW,CAAA;IAExB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,cAAc,EAAE,MAAM,EAAE,CAAA;IAExB,mBAAmB,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACpF,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;IAEvC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,EACpC,MAAM,EACN,SAAS,EACT,WAAW,EACX,OAAO,EACP,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACnB,EAAE,iBAAiB,CAAC,KAAK,CAAC;;EAuc1B"}

package/build/voice-agent-api/voice-http.js

@@ -1,13 +1,14 @@
 import * as dns from 'node:dns';
 import { promisify } from 'node:util';
 import Fastify from 'fastify';
+import { isRandomizedVoiceRoute } from '../agent/index.js';
 import { loggerContext } from '../dockyard/index.js';
 import { LATENCY_EVENT_SCHEMA, LATENCY_EVENT_TYPES, } from '../telescope/index.js';
 import { fail, isRecoverableError, mapFromOpenAiMessages } from './http-helpers.js';
 import { llmCompletionHandler } from './llm-completion-handler.js';
 import { logger } from './logger.js';
-import { createVoiceRouteResolver } from './route-resolver.js';
-export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStart, hostsToPrewarm, headersToMeta, getConversationMeta, callControl, notificationRouter, getExternalConversationId, stickyCookieName, }) {
+import { UnknownVoiceRouteError } from './voice-router.js';
+export function voiceHttpConnect({ router, telescope, callControl, onStart, hostsToPrewarm, getConversationMeta, notificationRouter, stickyCookieName, }) {
     const activeRequests = new Set();
     let started = false;
     const app = Fastify({
@@ -41,11 +42,11 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
         if (!(error instanceof Error)) {
             throw new Error(String(error));
         }
-        const { agent, variantId } = await getAgent(request);
+        const agent = await getAgent(request);
         if (!isRecoverableError(error)) {
             await agent.onFatalError(reqToCallInfo(request), error.message);
         }
-        await createTelescopeConversation(request, variantId);
+        await createTelescopeConversation(request, agent.name);
         fail(reply, 500, error.message, error);
     });
     app.addHook('onRequest', async (req, res) => {
@@ -86,19 +87,25 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
         if (!req.agentName) {
             return fail(res, 400, 'Cannot start call without agent name');
         }
-        const { agent, variantId } = await getAgent(req);
+        let agent;
+        try {
+            agent = await getAgent(req);
+        }
+        catch (err) {
+            return failToResolve(res, err);
+        }
         await telescope.runObservation(async () => {
             const response = await agent.onCallStart(reqToCallInfo(req));
             res.status(200);
             res.send(response);
-        }, { conversationId: req.callId, agentId: agent.name, variantId });
+        }, { conversationId: req.callId, agentId: agent.name });
     });
     app.all('/on-call-ready', async (req, res) => {
         logger.setGlobalId(req.callId);
-        const { agent, variantId } = await getAgent(req);
+        const agent = await getAgent(req);
         notificationRouter?.register({
             conversationId: req.callId,
-            externalConversationId: getExternalConversationId?.(req.headers),
+            externalConversationId: getConversationMeta(req.headers).externalConversationId,
         }, agent);
         const { region, phoneNumber } = getConversationMeta(req.headers);
         telescope.getEventTracer().emit({
@@ -106,76 +113,70 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
             attributes: {
                 callId: req.callId,
                 agentId: agent.name,
-                variantId,
                 phoneNumber: phoneNumber ?? req.phoneNumber,
                 region,
             },
         });
         await telescope.runObservation(async () => {
             await agent.onCallReady(reqToCallInfo(req));
-        }, { conversationId: req.callId, agentId: agent.name, variantId });
+        }, { conversationId: req.callId, agentId: agent.name });
     });
     app.all('/on-call-end', async (req, res) => {
         logger.setGlobalId(req.callId);
         logger.debug('agent-service, on-call-end');
-        let resolved;
+        let agent;
         try {
-            resolved = await getAgent(req);
+            agent = await getAgent(req);
         }
-        catch (e) {
-            return fail(res, 400, String(e), e);
+        catch (err) {
+            return failToResolve(res, err);
         }
-        const { agent, variantId } = resolved;
         notificationRouter?.unregister(req.callId);
         await telescope.runObservation(async () => {
             await agent.onCallEnd(reqToCallInfo(req));
-            await createTelescopeConversation(req, variantId);
-            await resolver.release(req.callId);
+            await createTelescopeConversation(req, agent.name);
+            await router.release(req.callId);
             res.status(200);
-        }, { conversationId: req.callId, agentId: agent.name, variantId });
+        }, { conversationId: req.callId, agentId: agent.name });
     });
     app.post('/on-fatal-error', async (req, res) => {
         logger.setGlobalId(req.callId);
         logger.debug('agent-service, on-fatal-error');
-        let resolved;
+        let agent;
         try {
-            resolved = await getAgent(req);
+            agent = await getAgent(req);
         }
-        catch (e) {
-            return fail(res, 400, String(e), e);
+        catch (err) {
+            return failToResolve(res, err);
         }
-        const { agent, variantId } = resolved;
         await telescope.runObservation(async () => {
             await agent.onFatalError(reqToCallInfo(req), req.body?.error ?? 'Fatal error');
             res.status(200);
-        }, { conversationId: req.callId, agentId: agent.name, variantId });
+        }, { conversationId: req.callId, agentId: agent.name });
     });
     app.all('/chat/completions', async (req, res) => {
         logger.setGlobalId(req.callId);
         logger.debug('agent-service, /chat/completions');
-        let resolved;
+        let agent;
         try {
-            resolved = await getAgent(req);
+            agent = await getAgent(req);
         }
         catch (err) {
-            return fail(res, 400, String(err), err);
+            return failToResolve(res, err);
         }
-        const { agent, variantId } = resolved;
-        return telescope.runObservation(async () => llmCompletionHandler(agent, telescope.getConversationalTracer(), headersToMeta, req, res), {
+        return telescope.runObservation(async () => llmCompletionHandler(agent, telescope.getConversationalTracer(), (headers) => getConversationMeta(headers).meta, req, res), {
             conversationId: req.callId,
             agentId: agent.name,
-            variantId,
         });
     });
     app.post('/on-agent-speech-done', async (req, res) => {
         logger.setGlobalId(req.callId);
-        const { agent, variantId } = await getAgent(req);
+        const agent = await getAgent(req);
         return telescope.runObservation(async () => {
             await agent.onAgentSpeechDone(mapFromOpenAiMessages(req.body.messages), reqToCallInfo(req));
         }, {
             conversationId: req.callId,
             agentId: agent.name,
-            variantId,
         });
     });
     app.post('/latency-event', async (req, res) => {
@@ -250,7 +251,7 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
         const requests = [...activeRequests];
         activeRequests.clear();
         const notify = Promise.allSettled(requests.map(async (res) => {
-            const { agent } = await getAgent(res.request);
+            const agent = await getAgent(res.request);
             await agent.onFatalError(reqToCallInfo(res.request), message);
             fail(res, 500, `${label}: ${message}`);
         }));
@@ -286,12 +287,22 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
             }
         }
         await onStart();
+        const routes = await router.start();
+        for (const route of routes) {
+            await callControl.setUpInboundSip(route.name, route.inbound);
+        }
+        for (const agent of agentsOf(routes)) {
+            await agent.onServiceStartup();
+        }
         started = true;
         await prewarmDNS();
     }
-    const resolver = createVoiceRouteResolver({ getVoiceAgent, allocations, logger });
     function getAgent(req) {
-        return resolver.resolve(req.agentName, req.callId);
+        return router.resolve(req.agentName, req.callId);
+    }
+    function failToResolve(res, err) {
+        const status = err instanceof UnknownVoiceRouteError ? 404 : 400;
+        return fail(res, status, String(err), err);
     }
     async function prewarmDNS() {
         const dnsLookup = promisify(dns.lookup);
@@ -305,7 +316,7 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
             }
         }
     }
-    async function createTelescopeConversation(req, variantId) {
+    async function createTelescopeConversation(req, agentId) {
         const conversationId = req.callId;
         if (!conversationId) {
             logger.error('No call ID provided, cannot create Telescope conversation');
@@ -316,8 +327,7 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
         const conversation = {
             conversationId,
             medium: 'phone',
-            agentId: req.agentName || undefined,
-            variantId,
+            agentId,
             region,
             phoneNumber: phoneNumber ?? req.phoneNumber,
             createdAt: Date.now(),
@@ -337,7 +347,7 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
         return {
             callId: req.callId,
             phoneNumber: req.phoneNumber,
-            meta: headersToMeta(req.headers),
+            meta: getConversationMeta(req.headers).meta,
         };
     }
     return {
@@ -345,6 +355,18 @@ export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStar
     };
 }
 const LATENCY_EVENT_TYPES_SET = new Set(LATENCY_EVENT_TYPES);
+function agentsOf(routes) {
+    const agents = new Set();
+    for (const route of routes) {
+        if (isRandomizedVoiceRoute(route)) {
+            route.agents.forEach(({ agent }) => agents.add(agent));
+        }
+        else {
+            agents.add(route.agent);
+        }
+    }
+    return [...agents];
+}
 function isObject(value) {
     return !!value && typeof value === 'object' && !Array.isArray(value);
 }

package/build/voice-agent-api/voice-router.d.ts

@@ -0,0 +1,21 @@
+import type { VoiceAgent, VoiceRoute } from '../agent/index.js';
+import type { ContextCache } from '../context-cache/index.js';
+import type { Logger } from '../dockyard/index.js';
+export interface VoiceRouterOptions<TMeta> {
+    getRoutes: () => Promise<readonly VoiceRoute<TMeta>[]>;
+    calls?: ContextCache<{
+        agentName: string;
+    }>;
+    logger: Logger;
+    random?: () => number;
+}
+export interface VoiceRouter<TMeta> {
+    start(): Promise<readonly VoiceRoute<TMeta>[]>;
+    resolve(routeName: string, callId: string): Promise<VoiceAgent<TMeta>>;
+    release(callId: string): Promise<void>;
+}
+export declare class UnknownVoiceRouteError extends Error {
+    constructor(routeName: string);
+}
+export declare function createVoiceRouter<TMeta>({ getRoutes, calls, logger, random, }: VoiceRouterOptions<TMeta>): VoiceRouter<TMeta>;
+//# sourceMappingURL=voice-router.d.ts.map

package/build/voice-agent-api/voice-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-router.d.ts","sourceRoot":"","sources":["../../src/voice-agent-api/voice-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAErF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAElD,MAAM,WAAW,kBAAkB,CAAC,KAAK;IAErC,SAAS,EAAE,MAAM,OAAO,CAAC,SAAS,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAKtD,KAAK,CAAC,EAAE,YAAY,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3C,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,WAAW,CAAC,KAAK;IAE9B,KAAK,IAAI,OAAO,CAAC,SAAS,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAE9C,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IAEtE,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACjC,SAAS,EAAE,MAAM;CAIhC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,EACrC,SAAS,EACT,KAA6B,EAC7B,MAAM,EACN,MAAoB,GACvB,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAwFhD"}

package/build/voice-agent-api/voice-router.js

@@ -0,0 +1,100 @@
+import { isRandomizedVoiceRoute } from '../agent/index.js';
+import { createInMemoryCache } from '../context-cache/index.js';
+export class UnknownVoiceRouteError extends Error {
+    constructor(routeName) {
+        super(`Unknown voice route: ${routeName}`);
+        this.name = 'UnknownVoiceRouteError';
+    }
+}
+export function createVoiceRouter({ getRoutes, calls = createInMemoryCache(), logger, random = Math.random, }) {
+    let byName;
+    let starting;
+    const picking = new Map();
+    function start() {
+        if (!starting) {
+            starting = build();
+            starting.catch(() => (starting = undefined));
+        }
+        return starting;
+    }
+    async function build() {
+        const routes = await getRoutes();
+        const index = new Map();
+        for (const route of routes) {
+            if (index.has(route.name)) {
+                throw new Error(`Duplicate voice route: ${route.name}`);
+            }
+            if (isRandomizedVoiceRoute(route)) {
+                validateRandomizedRoute(route);
+            }
+            index.set(route.name, route);
+        }
+        byName = index;
+        return routes;
+    }
+    async function resolve(routeName, callId) {
+        if (!byName) {
+            throw new Error('The voice router is not started');
+        }
+        const route = byName.get(routeName);
+        if (!route) {
+            throw new UnknownVoiceRouteError(routeName);
+        }
+        if (!isRandomizedVoiceRoute(route)) {
+            return route.agent;
+        }
+        let pending = picking.get(callId);
+        if (!pending) {
+            pending = keepOrPick(route, callId);
+            picking.set(callId, pending);
+            const done = () => picking.delete(callId);
+            pending.then(done, done);
+        }
+        return pending;
+    }
+    async function keepOrPick(route, callId) {
+        const kept = await calls.getContext(callId);
+        const keptAgent = kept && route.agents.find(({ agent }) => agent.name === kept.agentName);
+        if (keptAgent) {
+            return keptAgent.agent;
+        }
+        const agent = pick(route);
+        await calls.setContext(callId, { agentName: agent.name });
+        logger.log('Picked the agent of the call', {
+            routeName: route.name,
+            callId,
+            agentName: agent.name,
+        });
+        return agent;
+    }
+    function pick(route) {
+        const total = route.agents.reduce((sum, { weight }) => sum + weight, 0);
+        let selected = random() * total;
+        for (const { agent, weight } of route.agents) {
+            if (weight > 0 && selected < weight) {
+                return agent;
+            }
+            selected -= weight;
+        }
+        return route.agents.filter(({ weight }) => weight > 0).at(-1).agent;
+    }
+    function release(callId) {
+        return calls.clearContext(callId);
+    }
+    return { start, resolve, release };
+}
+function validateRandomizedRoute(route) {
+    const names = new Set();
+    for (const { agent, weight } of route.agents) {
+        if (!(weight >= 0)) {
+            throw new Error(`Route ${route.name}: the weight of ${agent.name} must be 0 or more`);
+        }
+        if (names.has(agent.name)) {
+            throw new Error(`Route ${route.name}: two agents are named ${agent.name}`);
+        }
+        names.add(agent.name);
+    }
+    if (!route.agents.some(({ weight }) => weight > 0)) {
+        throw new Error(`Route ${route.name}: no agent has a weight above 0`);
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@recombine-ai/platform",
   "type": "module",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "The Recombine platform: engine, telescope, dockyard, call control, the voice agent API, and the Bosun bindings in one package",
   "license": "EULA",
   "author": "recombine.ai",

package/build/agent/experiment.d.ts

@@ -1,21 +0,0 @@
-import type { VoiceAgent } from './voice-agent.js';
-export interface Experiment<TArm extends {
-    weight: number;
-}> {
-    default?: TArm;
-    variants: Readonly<Record<string, TArm>>;
-}
-export declare function allocateVariant<TArm extends {
-    weight: number;
-}>(experiment: Experiment<TArm>, random?: () => number): string | null;
-export interface VoiceAgentArm<TMeta> {
-    agent: VoiceAgent<TMeta>;
-    weight: number;
-}
-export interface VoiceAgentExperiment<TMeta> extends Experiment<VoiceAgentArm<TMeta>> {
-    name: string;
-    onServiceStartup: () => Promise<void>;
-}
-export type VoiceRoute<TMeta> = VoiceAgent<TMeta> | VoiceAgentExperiment<TMeta>;
-export declare function isVoiceAgentExperiment<TMeta>(route: VoiceRoute<TMeta>): route is VoiceAgentExperiment<TMeta>;
-//# sourceMappingURL=experiment.d.ts.map

package/build/agent/experiment.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"experiment.d.ts","sourceRoot":"","sources":["../../src/agent/experiment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;IAEvD,OAAO,CAAC,EAAE,IAAI,CAAA;IAEd,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;CAC3C;AAMD,wBAAgB,eAAe,CAAC,IAAI,SAAS;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3D,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,EAC5B,MAAM,GAAE,MAAM,MAAoB,GACnC,MAAM,GAAG,IAAI,CA0Bf;AAED,MAAM,WAAW,aAAa,CAAC,KAAK;IAChC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;CACjB;AAGD,MAAM,WAAW,oBAAoB,CAAC,KAAK,CAAE,SAAQ,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACjF,IAAI,EAAE,MAAM,CAAA;IAEZ,gBAAgB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AAED,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;AAE/E,wBAAgB,sBAAsB,CAAC,KAAK,EACxC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GACzB,KAAK,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAEtC"}

package/build/agent/experiment.js

@@ -1,29 +0,0 @@
-export function allocateVariant(experiment, random = Math.random) {
-    const arms = Object.entries(experiment.variants).map(([id, arm]) => [
-        id,
-        arm.weight,
-    ]);
-    if (experiment.default) {
-        arms.unshift([null, experiment.default.weight]);
-    }
-    for (const [id, weight] of arms) {
-        if (!(weight >= 0)) {
-            throw new Error(`The weight of the arm ${id ?? 'default'} must be 0 or more`);
-        }
-    }
-    const total = arms.reduce((sum, [, weight]) => sum + weight, 0);
-    if (total <= 0) {
-        throw new Error('No experiment arm can win: the weights add up to 0');
-    }
-    let selected = random() * total;
-    for (const [id, weight] of arms) {
-        if (weight > 0 && selected < weight) {
-            return id;
-        }
-        selected -= weight;
-    }
-    throw new Error('No experiment arm can win');
-}
-export function isVoiceAgentExperiment(route) {
-    return 'variants' in route;
-}

package/build/bosun-app/frontend/client/_app/immutable/chunks/DK7_9Rr4.js.br

@@ -1,3 +0,0 @@
-1
@�ٹ�L5�B;�e��I�ᙂq|"�Av7�Z�	�L�1吒�َ!�2��/vQ���A�B�]5V�|Zȓp
-���!Q]�]w�;Ntkc���G��̓p����6��7BIԨ��@�7�2��D Z�
-�cBfB��7ثFN���J���*k