@recombine-ai/platform 0.8.0-test.2 → 0.8.0

package/build/text-agent-handlers/incoming-message.js

@@ -19,7 +19,7 @@ export function createIncomingMessageHandler(options) {
         if (!agentRecord) {
             throw new Error(`incoming-message, agent not found for ${conversationId}`);
         }
-        const agent = await getTextAgent(agentRecord.agentId);
+        const agent = await getTextAgent(agentRecord.agentId, agentRecord.variantId);
         return { agent, agentRecord };
     }
     async function handleChatMessage(event) {

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

@@ -11,5 +11,6 @@ export type { MessageAcceptorOptions } from './message-acceptor.js';
 export { createNotificationHookHandler } from './notification-hook.js';
 export type { NotificationHookOptions, NotificationHookRequest } from './notification-hook.js';
 export { instrumentTextAgent } from './instrument.js';
+export { scopeSchedulerToVariant } from './variant-scheduler.js';
 export type { InstrumentTextAgentOptions } from './instrument.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACpD,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC/D,YAAY,EACR,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,GACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1C,YAAY,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACpD,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAC/D,YAAY,EACR,WAAW,EACX,aAAa,EACb,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,eAAe,EACf,SAAS,GACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AACpE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AACrD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AACnE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AACtE,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAA"}

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

@@ -4,3 +4,4 @@ export { createJobsHandler } from './jobs-handler.js';
 export { createMessageAcceptor } from './message-acceptor.js';
 export { createNotificationHookHandler } from './notification-hook.js';
 export { instrumentTextAgent } from './instrument.js';
+export { scopeSchedulerToVariant } from './variant-scheduler.js';

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

@@ -6,6 +6,7 @@ export interface InstrumentTextAgentOptions<TMeta> {
     agent: TextAgent<TMeta>;
     messagingProvider?: MonitoringProvider;
     onEvent?: (event: Event<TMeta>) => Promise<void>;
+    variantId?: string;
 }
 export declare function instrumentTextAgent<TMeta>(options: InstrumentTextAgentOptions<TMeta>): TextAgent<TMeta>;
 //# sourceMappingURL=instrument.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,WAAW,0BAA0B,CAAC,KAAK;IAC7C,SAAS,EAAE,UAAU,CAAA;IACrB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAA;IAEvB,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;IAEtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnD;AAaD,wBAAgB,mBAAmB,CAAC,KAAK,EACrC,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAC3C,SAAS,CAAC,KAAK,CAAC,CAoClB"}
+{"version":3,"file":"instrument.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/instrument.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,WAAW,0BAA0B,CAAC,KAAK;IAC7C,SAAS,EAAE,UAAU,CAAA;IACrB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAA;IAEvB,iBAAiB,CAAC,EAAE,kBAAkB,CAAA;IAEtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhD,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAaD,wBAAgB,mBAAmB,CAAC,KAAK,EACrC,OAAO,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAC3C,SAAS,CAAC,KAAK,CAAC,CAwClB"}

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

@@ -1,7 +1,11 @@
 import { emitConversationalTrace, textEventTrace } from '../telescope/index.js';
 export function instrumentTextAgent(options) {
-    const { telescope, agent, messagingProvider, onEvent } = options;
-    const observation = (conversationId) => ({ conversationId, messagingProvider });
+    const { telescope, agent, messagingProvider, onEvent, variantId } = options;
+    const observation = (conversationId) => ({
+        conversationId,
+        messagingProvider,
+        variantId,
+    });
     async function traceReceivedMessage(event) {
         if (event.kind !== 'message')
             return;

package/build/text-agent-handlers/jobs-handler.js

@@ -5,7 +5,7 @@ export function createJobsHandler(options) {
     return async function handleJob(input) {
         let agent;
         try {
-            agent = await getTextAgent(input.agentId);
+            agent = await getTextAgent(input.agentId, input.variantId);
         }
         catch (err) {
             logger.error('jobs, unknown agentId', { agentId: input.agentId, err });

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

@@ -6,6 +6,7 @@ export interface Job {
 export interface JobInput {
     jobId: string;
     agentId: string;
+    variantId?: string;
     conversationId: string;
     handlerId: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/jobs.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAG;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACtB;AAKD,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,uBAAuB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;CACtE"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/jobs.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,GAAG;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;CACtB;AAKD,MAAM,WAAW,QAAQ;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IAEf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IAC5B,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IACvC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,uBAAuB,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;CACtE"}

package/build/text-agent-handlers/message-acceptor.d.ts

@@ -1,3 +1,4 @@
+import { type Experiment } from '../agent/experiment.js';
 import type { Logger } from '../dockyard/index.js';
 import type { EventTracer } from '../telescope/index.js';
 import type { Event } from './event.js';
@@ -5,6 +6,9 @@ import type { AgentRegistry, HandlerResponse } from './ports.js';
 export interface MessageAcceptorOptions {
     registry: AgentRegistry;
     resolveAgentId: (event: Event) => string;
+    experiments?: Readonly<Record<string, Experiment<{
+        weight: number;
+    }>>>;
     eventTracer: EventTracer;
     invokeIncomingMessage: (event: Event) => Promise<void>;
     logger: Logger;

package/build/text-agent-handlers/message-acceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-acceptor.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/message-acceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGhE,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,aAAa,CAAA;IAEvB,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAA;IACxC,WAAW,EAAE,WAAW,CAAA;IAExB,qBAAqB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,IAG7B,OAAO,KAAK,KAAG,OAAO,CAAC,eAAe,CAAC,CAqC9E"}
+{"version":3,"file":"message-acceptor.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/message-acceptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAmB,MAAM,wBAAwB,CAAA;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAGhE,MAAM,WAAW,sBAAsB;IACnC,QAAQ,EAAE,aAAa,CAAA;IAEvB,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAA;IAExC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC,CAAA;IACtE,WAAW,EAAE,WAAW,CAAA;IAExB,qBAAqB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,MAAM,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,IAI7B,OAAO,KAAK,KAAG,OAAO,CAAC,eAAe,CAAC,CA0C9E"}

package/build/text-agent-handlers/message-acceptor.js

@@ -1,6 +1,7 @@
+import { allocateVariant } from '../agent/experiment.js';
 import { handlerResponse } from './ports.js';
 export function createMessageAcceptor(options) {
-    const { registry, resolveAgentId, eventTracer, invokeIncomingMessage, logger } = options;
+    const { registry, resolveAgentId, experiments, eventTracer, invokeIncomingMessage, logger } = options;
     return async function acceptMessage(event) {
         logger.debug('acceptMessage from conversation', {
             conversationId: event.conversationId,
@@ -8,9 +9,13 @@ export function createMessageAcceptor(options) {
         });
         let record = await registry.getAgent(event.conversationId);
         if (!record) {
+            const agentId = resolveAgentId(event);
+            const experiment = experiments?.[agentId];
+            const variantId = experiment ? allocateVariant(experiment) : null;
             record = {
                 conversationId: event.conversationId,
-                agentId: resolveAgentId(event),
+                agentId,
+                ...(variantId ? { variantId } : {}),
             };
             await registry.saveAgent(record);
             eventTracer.emit({
@@ -18,6 +23,7 @@ export function createMessageAcceptor(options) {
                 attributes: {
                     conversationId: event.conversationId,
                     agentId: record.agentId,
+                    variantId: record.variantId,
                     channel: event.channel,
                     region: typeof event.metadata.region === 'string'
                         ? event.metadata.region

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

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

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

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

package/build/text-agent-handlers/variant-scheduler.d.ts

@@ -0,0 +1,3 @@
+import type { Scheduler } from '../engine/index.js';
+export declare function scopeSchedulerToVariant(scheduler: Scheduler, variantId: string | undefined): Scheduler;
+//# sourceMappingURL=variant-scheduler.d.ts.map

package/build/text-agent-handlers/variant-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-scheduler.d.ts","sourceRoot":"","sources":["../../src/text-agent-handlers/variant-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAMnD,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC9B,SAAS,CAUX"}

package/build/text-agent-handlers/variant-scheduler.js

@@ -0,0 +1,9 @@
+export function scopeSchedulerToVariant(scheduler, variantId) {
+    if (!variantId) {
+        return scheduler;
+    }
+    return {
+        registerAction: (agentId, actionName, action) => scheduler.registerAction(agentId, actionName, action, variantId),
+        clearAllPendingActions: (conversationId) => scheduler.clearAllPendingActions(conversationId),
+    };
+}

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

@@ -3,4 +3,6 @@ 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';
 //# 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"}
+{"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"}

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

@@ -1,3 +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';

package/build/voice-agent-api/route-resolver.d.ts

@@ -0,0 +1,19 @@
+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 ResolvedVoiceAgent<TMeta> {
+    agent: VoiceAgent<TMeta>;
+    variantId?: string;
+}
+export interface VoiceRouteResolverOptions<TMeta> {
+    getVoiceAgent: (agentName: string) => Promise<VoiceRoute<TMeta>>;
+    allocations?: ContextCache<{
+        variantId: string | null;
+    }>;
+    logger: Logger;
+}
+export declare function createVoiceRouteResolver<TMeta>({ getVoiceAgent, allocations, logger, }: VoiceRouteResolverOptions<TMeta>): {
+    resolve: (agentName: string, callId: string) => Promise<ResolvedVoiceAgent<TMeta>>;
+    release: (callId: string) => Promise<void>;
+};
+//# sourceMappingURL=route-resolver.d.ts.map

package/build/voice-agent-api/route-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-resolver.d.ts","sourceRoot":"","sources":["../../src/voice-agent-api/route-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAwB,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;IACrC,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IAExB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,yBAAyB,CAAC,KAAK;IAC5C,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IAEhE,WAAW,CAAC,EAAE,YAAY,CAAC;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;IACxD,MAAM,EAAE,MAAM,CAAA;CACjB;AAMD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,EAC5C,aAAa,EACb,WAAmC,EACnC,MAAM,GACT,EAAE,yBAAyB,CAAC,KAAK,CAAC;yBAiBG,MAAM,UAAU,MAAM,KAAG,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;sBAuCpE,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;EAKlD"}

package/build/voice-agent-api/route-resolver.js

@@ -0,0 +1,57 @@
+import { allocateVariant, isVoiceAgentExperiment } from '../agent/index.js';
+import { createInMemoryCache } from '../context-cache/index.js';
+export function createVoiceRouteResolver({ getVoiceAgent, allocations = createInMemoryCache(), logger, }) {
+    const routes = new Map();
+    const allocating = new Map();
+    function getRoute(agentName) {
+        let route = routes.get(agentName);
+        if (!route) {
+            logger.debug('Loading agent', { agentName });
+            route = getVoiceAgent(agentName);
+            routes.set(agentName, route);
+            route.catch(() => routes.delete(agentName));
+        }
+        return route;
+    }
+    async function resolve(agentName, callId) {
+        const route = await getRoute(agentName);
+        if (!isVoiceAgentExperiment(route)) {
+            return { agent: route };
+        }
+        const variantId = await allocate(route, callId);
+        const arm = variantId === null ? route.default : route.variants[variantId];
+        if (!arm) {
+            throw new Error(`Route ${agentName} has no arm ${variantId ?? 'default'}`);
+        }
+        return { agent: arm.agent, variantId: variantId ?? undefined };
+    }
+    function allocate(route, callId) {
+        let pending = allocating.get(callId);
+        if (!pending) {
+            pending = keepOrAllocate(route, callId);
+            allocating.set(callId, pending);
+            const done = () => allocating.delete(callId);
+            pending.then(done, done);
+        }
+        return pending;
+    }
+    async function keepOrAllocate(route, callId) {
+        const kept = await allocations.getContext(callId);
+        if (kept && hasArm(route, kept.variantId)) {
+            return kept.variantId;
+        }
+        const variantId = allocateVariant(route);
+        await allocations.setContext(callId, { variantId });
+        logger.log('Allocated experiment arm', { agentName: route.name, callId, variantId });
+        return variantId;
+    }
+    function release(callId) {
+        return allocations.clearContext(callId);
+    }
+    return { resolve, release };
+}
+function hasArm(route, variantId) {
+    return variantId === null
+        ? route.default !== undefined
+        : Object.prototype.hasOwnProperty.call(route.variants, variantId);
+}

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

@@ -1,6 +1,7 @@
 import { FastifyRequest } from 'fastify';
-import { VoiceAgent } from '../agent/index.js';
-import CallControl from '../call-control/index.js';
+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';
 declare module 'fastify' {
@@ -13,7 +14,10 @@ declare module 'fastify' {
     }
 }
 export interface VoiceHttpBindings<TMeta> {
-    getVoiceAgent: (agentName: string) => Promise<VoiceAgent<TMeta>>;
+    getVoiceAgent: (agentName: string) => Promise<VoiceRoute<TMeta>>;
+    allocations?: ContextCache<{
+        variantId: string | null;
+    }>;
     telescope: ITelescope;
     onStart: () => Promise<void>;
     hostsToPrewarm: string[];
@@ -27,7 +31,7 @@ export interface VoiceHttpBindings<TMeta> {
     getExternalConversationId?: (headers: FastifyRequest['headers']) => string | undefined;
     stickyCookieName?: string;
 }
-export declare function voiceHttpConnect<TMeta>({ getVoiceAgent, telescope, onStart, hostsToPrewarm, headersToMeta, getConversationMeta, callControl, notificationRouter, getExternalConversationId, stickyCookieName, }: VoiceHttpBindings<TMeta>): {
+export declare function voiceHttpConnect<TMeta>({ getVoiceAgent, allocations, telescope, onStart, hostsToPrewarm, headersToMeta, getConversationMeta, callControl, notificationRouter, getExternalConversationId, 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,WAAwD,MAAM,0BAA0B,CAAA;AAE/F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,KAAK,EAAE,UAAU,EAAyB,MAAM,uBAAuB,CAAA;AAW9E,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;IACpC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IAChE,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,SAAS,EACT,OAAO,EACP,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,GACnB,EAAE,iBAAiB,CAAC,KAAK,CAAC;;EAic1B"}
+{"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"}

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

@@ -1,13 +1,13 @@
 import * as dns from 'node:dns';
 import { promisify } from 'node:util';
 import Fastify from 'fastify';
-import { validateVoiceAgentTurnDetectionSettings } from '../call-control/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';
-export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPrewarm, headersToMeta, getConversationMeta, callControl, notificationRouter, getExternalConversationId, stickyCookieName, }) {
+import { createVoiceRouteResolver } from './route-resolver.js';
+export function voiceHttpConnect({ getVoiceAgent, allocations, telescope, onStart, hostsToPrewarm, headersToMeta, getConversationMeta, callControl, notificationRouter, getExternalConversationId, stickyCookieName, }) {
     const activeRequests = new Set();
     let started = false;
     const app = Fastify({
@@ -41,10 +41,11 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
         if (!(error instanceof Error)) {
             throw new Error(String(error));
         }
+        const { agent, variantId } = await getAgent(request);
         if (!isRecoverableError(error)) {
-            await (await getAgent(request)).onFatalError(reqToCallInfo(request), error.message);
+            await agent.onFatalError(reqToCallInfo(request), error.message);
         }
-        await createTelescopeConversation(request);
+        await createTelescopeConversation(request, variantId);
         fail(reply, 500, error.message, error);
     });
     app.addHook('onRequest', async (req, res) => {
@@ -85,19 +86,16 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
         if (!req.agentName) {
             return fail(res, 400, 'Cannot start call without agent name');
         }
-        const agent = await getAgent(req);
+        const { agent, variantId } = await getAgent(req);
         await telescope.runObservation(async () => {
             const response = await agent.onCallStart(reqToCallInfo(req));
-            if (response.initialSettings) {
-                validateVoiceAgentTurnDetectionSettings(response.initialSettings);
-            }
             res.status(200);
             res.send(response);
-        }, { conversationId: req.callId, agentId: agent.name });
+        }, { conversationId: req.callId, agentId: agent.name, variantId });
     });
     app.all('/on-call-ready', async (req, res) => {
         logger.setGlobalId(req.callId);
-        const agent = await getAgent(req);
+        const { agent, variantId } = await getAgent(req);
         notificationRouter?.register({
             conversationId: req.callId,
             externalConversationId: getExternalConversationId?.(req.headers),
@@ -108,69 +106,76 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
             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 });
+        }, { conversationId: req.callId, agentId: agent.name, variantId });
     });
     app.all('/on-call-end', async (req, res) => {
         logger.setGlobalId(req.callId);
         logger.debug('agent-service, on-call-end');
-        let agent;
+        let resolved;
         try {
-            agent = await getAgent(req);
+            resolved = await getAgent(req);
         }
         catch (e) {
             return fail(res, 400, String(e), e);
         }
+        const { agent, variantId } = resolved;
         notificationRouter?.unregister(req.callId);
         await telescope.runObservation(async () => {
             await agent.onCallEnd(reqToCallInfo(req));
-            await createTelescopeConversation(req);
+            await createTelescopeConversation(req, variantId);
+            await resolver.release(req.callId);
             res.status(200);
-        }, { conversationId: req.callId, agentId: agent.name });
+        }, { conversationId: req.callId, agentId: agent.name, variantId });
     });
     app.post('/on-fatal-error', async (req, res) => {
         logger.setGlobalId(req.callId);
         logger.debug('agent-service, on-fatal-error');
-        let agent;
+        let resolved;
         try {
-            agent = await getAgent(req);
+            resolved = await getAgent(req);
         }
         catch (e) {
             return fail(res, 400, String(e), e);
         }
+        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 });
+        }, { conversationId: req.callId, agentId: agent.name, variantId });
     });
     app.all('/chat/completions', async (req, res) => {
         logger.setGlobalId(req.callId);
         logger.debug('agent-service, /chat/completions');
-        let agent;
+        let resolved;
         try {
-            agent = await getAgent(req);
+            resolved = await getAgent(req);
         }
         catch (err) {
             return fail(res, 400, String(err), err);
         }
+        const { agent, variantId } = resolved;
         return telescope.runObservation(async () => llmCompletionHandler(agent, telescope.getConversationalTracer(), headersToMeta, req, res), {
             conversationId: req.callId,
             agentId: agent.name,
+            variantId,
         });
     });
     app.post('/on-agent-speech-done', async (req, res) => {
         logger.setGlobalId(req.callId);
-        const agent = await getAgent(req);
+        const { agent, variantId } = 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) => {
@@ -245,7 +250,7 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
         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}`);
         }));
@@ -284,16 +289,9 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
         started = true;
         await prewarmDNS();
     }
-    const agents = new Map();
+    const resolver = createVoiceRouteResolver({ getVoiceAgent, allocations, logger });
     function getAgent(req) {
-        let agent = agents.get(req.agentName);
-        if (!agent) {
-            logger.debug('Loading agent', { agentName: req.agentName });
-            agent = getVoiceAgent(req.agentName);
-            agents.set(req.agentName, agent);
-            agent.catch(() => agents.delete(req.agentName));
-        }
-        return agent;
+        return resolver.resolve(req.agentName, req.callId);
     }
     async function prewarmDNS() {
         const dnsLookup = promisify(dns.lookup);
@@ -307,7 +305,7 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
             }
         }
     }
-    async function createTelescopeConversation(req) {
+    async function createTelescopeConversation(req, variantId) {
         const conversationId = req.callId;
         if (!conversationId) {
             logger.error('No call ID provided, cannot create Telescope conversation');
@@ -319,6 +317,7 @@ export function voiceHttpConnect({ getVoiceAgent, telescope, onStart, hostsToPre
             conversationId,
             medium: 'phone',
             agentId: req.agentName || undefined,
+            variantId,
             region,
             phoneNumber: phoneNumber ?? req.phoneNumber,
             createdAt: Date.now(),

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@recombine-ai/platform",
   "type": "module",
-  "version": "0.8.0-test.2",
+  "version": "0.8.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",