@recombine-ai/platform 0.2.6-test.9 → 0.3.0

package/build/notifications/transport.d.ts

@@ -0,0 +1,11 @@
+import { NotificationTransport } from './types';
+export declare const DEFAULT_NOTIFICATION_CHANNEL = "agent:notifications";
+export type RedisNotificationTransportOptions = {
+    url: string;
+    channel?: string;
+};
+export declare function createRedisNotificationTransport({ url, channel, }: RedisNotificationTransportOptions): NotificationTransport;
+export declare function createInMemoryNotificationTransport(): NotificationTransport & {
+    publish: (raw: string) => void;
+};
+//# sourceMappingURL=transport.d.ts.map

package/build/notifications/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/notifications/transport.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAE/C,eAAO,MAAM,4BAA4B,wBAAwB,CAAA;AAEjE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAYD,wBAAgB,gCAAgC,CAAC,EAC7C,GAAG,EACH,OAAsC,GACzC,EAAE,iCAAiC,GAAG,qBAAqB,CAe3D;AAGD,wBAAgB,mCAAmC,IAAI,qBAAqB,GAAG;IAC3E,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC,CAcA"}

package/build/notifications/transport.js

@@ -0,0 +1,31 @@
+import { createClient } from 'redis';
+import { logger } from './logger';
+export const DEFAULT_NOTIFICATION_CHANNEL = 'agent:notifications';
+export function createRedisNotificationTransport({ url, channel = DEFAULT_NOTIFICATION_CHANNEL, }) {
+    const client = createClient({ url });
+    client.on('error', (err) => logger.error('notification-transport: redis error', { err }));
+    return {
+        async subscribe(onMessage) {
+            await client.connect();
+            await client.subscribe(channel, onMessage);
+            logger.debug('notification-transport: subscribed', { channel });
+        },
+        async close() {
+            await client.close();
+        },
+    };
+}
+export function createInMemoryNotificationTransport() {
+    let listener;
+    return {
+        async subscribe(onMessage) {
+            listener = onMessage;
+        },
+        async close() {
+            listener = undefined;
+        },
+        publish(raw) {
+            listener?.(raw);
+        },
+    };
+}

package/build/notifications/types.d.ts

@@ -0,0 +1,20 @@
+export declare const NOTIFICATION_EVENT_SCHEMA = "notification.event.v1";
+export type NotificationEvent = {
+    schema: typeof NOTIFICATION_EVENT_SCHEMA;
+    payload: unknown;
+} & ({
+    conversationId: string;
+    externalConversationId?: never;
+} | {
+    externalConversationId: string;
+    conversationId?: never;
+});
+export type NotificationTransport = {
+    subscribe: (onMessage: (raw: string) => void) => Promise<void>;
+    close: () => Promise<void>;
+};
+export type ConversationIds = {
+    conversationId: string;
+    externalConversationId?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/build/notifications/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/notifications/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,0BAA0B,CAAA;AAQhE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,MAAM,EAAE,OAAO,yBAAyB,CAAA;IACxC,OAAO,EAAE,OAAO,CAAA;CACnB,GAAG,CACE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,KAAK,CAAA;CAAE,GAC1D;IAAE,sBAAsB,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,KAAK,CAAA;CAAE,CAC/D,CAAA;AAOD,MAAM,MAAM,qBAAqB,GAAG;IAChC,SAAS,EAAE,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC1B,cAAc,EAAE,MAAM,CAAA;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAClC,CAAA"}

package/build/notifications/types.js

@@ -0,0 +1 @@
+export const NOTIFICATION_EVENT_SCHEMA = 'notification.event.v1';

package/build/steps/helpers.d.ts

@@ -0,0 +1,11 @@
+import { IModels, OmnichannelPlatform } from '../core';
+import { AIEngine, Conversation, Message, ResponseChunk } from '../engine';
+export declare function emptyResponseStream(): ReadableStream<ResponseChunk>;
+export declare function createConversationWithProposedReply<TContext extends object>(ai: AIEngine<TContext>, messages: Message[]): Conversation;
+export declare function getLastAgentMessage(conversation: Conversation): string | undefined;
+export declare function checkForTagsAndFreeze<TContext extends {
+    state: {
+        callId: string;
+    };
+}, TModels extends IModels>(tags: string | string[], platform: OmnichannelPlatform<TContext, TModels>): (conversation: Conversation, ctx: TContext) => Promise<boolean>;
+//# sourceMappingURL=helpers.d.ts.map

package/build/steps/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/steps/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AACtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAM1E,wBAAgB,mBAAmB,IAAI,cAAc,CAAC,aAAa,CAAC,CAMnE;AAMD,wBAAgB,mCAAmC,CAAC,QAAQ,SAAS,MAAM,EACvE,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,EACtB,QAAQ,EAAE,OAAO,EAAE,gBAYtB;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,YAAY,sBAG7D;AAMD,wBAAgB,qBAAqB,CACjC,QAAQ,SAAS;IAAE,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAC9C,OAAO,SAAS,OAAO,EACzB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC,IACzD,cAAc,YAAY,EAAE,KAAK,QAAQ,sBAW1D"}

package/build/steps/helpers.js

@@ -0,0 +1,36 @@
+export function emptyResponseStream() {
+    return new ReadableStream({
+        start(controller) {
+            controller.close();
+        },
+    });
+}
+export function createConversationWithProposedReply(ai, messages) {
+    const lastMessage = messages.at(-1);
+    const proposedReply = lastMessage?.sender === 'agent' ? lastMessage.text : undefined;
+    let conversation;
+    if (proposedReply) {
+        conversation = ai.createConversation(messages.slice(0, -1));
+        conversation.setProposedReply(proposedReply);
+    }
+    else {
+        conversation = ai.createConversation(messages);
+    }
+    return conversation;
+}
+export function getLastAgentMessage(conversation) {
+    const lastMessage = conversation.getHistory().at(-1);
+    return lastMessage?.sender === 'agent' ? lastMessage.text : undefined;
+}
+export function checkForTagsAndFreeze(tags, platform) {
+    return async (conversation, ctx) => {
+        const hasTags = Array.isArray(tags)
+            ? tags.some((tag) => conversation.getProposedReply()?.includes(tag))
+            : conversation.getProposedReply()?.includes(tags);
+        if (!hasTags) {
+            return false;
+        }
+        await platform.callControl?.freeze(ctx.state.callId);
+        return true;
+    };
+}

package/build/steps/index.d.ts

@@ -0,0 +1,10 @@
+export { createSlotBooker } from './slot-booker/slot-booker';
+export type { SlotBooker } from './slot-booker/slot-booker';
+export type { SlotBookerContext, SlotBookerData } from './slot-booker/context';
+export type { SlotBookerOpts, SlotBookerStepOpts } from './slot-booker/interfaces';
+export { getTriggerMessageProvider } from './slot-booker/util';
+export type { TriggerMessage } from './slot-booker/util';
+export { makeAllRequired } from './make-all-required';
+export { instructionsOrQuery } from './instructions-or-query';
+export { checkForTagsAndFreeze, createConversationWithProposedReply, emptyResponseStream, getLastAgentMessage, } from './helpers';
+//# sourceMappingURL=index.d.ts.map

package/build/steps/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/steps/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAC5D,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAC3D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC9E,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EACH,qBAAqB,EACrB,mCAAmC,EACnC,mBAAmB,EACnB,mBAAmB,GACtB,MAAM,WAAW,CAAA"}

package/build/steps/index.js

@@ -0,0 +1,5 @@
+export { createSlotBooker } from './slot-booker/slot-booker';
+export { getTriggerMessageProvider } from './slot-booker/util';
+export { makeAllRequired } from './make-all-required';
+export { instructionsOrQuery } from './instructions-or-query';
+export { checkForTagsAndFreeze, createConversationWithProposedReply, emptyResponseStream, getLastAgentMessage, } from './helpers';

package/build/steps/instructions-or-query.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+export declare const instructionsOrQuery: <T extends z.ZodType>(query: T) => z.ZodObject<{
+    result: z.ZodUnion<readonly [z.ZodObject<{
+        instructionsForAgent: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        query: T;
+    }, z.core.$strip>]>;
+}, z.core.$strip>;
+//# sourceMappingURL=instructions-or-query.d.ts.map

package/build/steps/instructions-or-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions-or-query.d.ts","sourceRoot":"","sources":["../../src/steps/instructions-or-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,mBAAmB,GAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC;;;;;;iBAgB3D,CAAA"}

package/build/steps/instructions-or-query.js

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+export const instructionsOrQuery = (query) => z.object({
+    result: z
+        .union([
+        z.object({
+            instructionsForAgent: z
+                .string()
+                .describe('If the agent needs to ask the user for more information, provide instructions for the agent here. Put null if no additional information is needed.'),
+        }),
+        z.object({
+            query: query,
+        }),
+    ])
+        .describe('Either instructions or a query must be provided, but not both.'),
+});

package/build/steps/make-all-required.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare function makeAllRequired<T extends z.ZodType>(schema: T): T;
+//# sourceMappingURL=make-all-required.d.ts.map

package/build/steps/make-all-required.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-all-required.d.ts","sourceRoot":"","sources":["../../src/steps/make-all-required.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAqDvB,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEjE"}

package/build/steps/make-all-required.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+function deepRequire(schema) {
+    if (schema instanceof z.ZodOptional) {
+        return deepRequire(schema.unwrap());
+    }
+    if (schema instanceof z.ZodDefault) {
+        return deepRequire(schema.unwrap());
+    }
+    if (schema instanceof z.ZodNullable) {
+        return z.nullable(deepRequire(schema.unwrap()));
+    }
+    if (schema instanceof z.ZodObject) {
+        const next = {};
+        for (const [k, v] of Object.entries(schema.shape)) {
+            next[k] = deepRequire(v);
+        }
+        return schema.clone({ ...schema._zod.def, shape: next });
+    }
+    if (schema instanceof z.ZodArray) {
+        return schema.clone({
+            ...schema._zod.def,
+            element: deepRequire(schema.element),
+        });
+    }
+    if (schema instanceof z.ZodTuple) {
+        return schema.clone({
+            ...schema._zod.def,
+            items: schema._zod.def.items.map(deepRequire),
+        });
+    }
+    if (schema instanceof z.ZodUnion) {
+        return schema.clone({
+            ...schema._zod.def,
+            options: schema.options.map(deepRequire),
+        });
+    }
+    return schema;
+}
+export function makeAllRequired(schema) {
+    return deepRequire(schema);
+}

package/build/steps/slot-booker/book-slot/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const prompt = "\nYou'll be given a conversation between an agent and a user.\n\nThe agent has requested slots from the system.\n\nThis is the system's response:\n{{ slotBooker.foundSlots }}\n\nIf the user has confirmed that they want to book one of the slots EXPLICITLY (i.e. agent has suggested a slot and asked to confirm and then the user confirmed), AND the slot is available based on the system's response, return the slot.\n\nIf no slots are found or user hasn't confirmed their intention to book an explicit slot, add instructions explaining to the agent what they need to do. Do not fill in instructions if you return the slot.\n\nCurrent date: {{ slotBooker.currentDate }}\n\n{% if slotBooker.bookSlotQueryDefaults %}\nThese are already known values:\n{{ slotBooker.bookSlotQueryDefaults }}\n{% endif %}\n\n{% if slotBooker.specificInstructionsPath %}\n# Important slot booking instructions\n{% include slotBooker.specificInstructionsPath %}\n{% endif %}\n";
+//# sourceMappingURL=prompt.d.ts.map

package/build/steps/slot-booker/book-slot/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/book-slot/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,27BAuBlB,CAAA"}

package/build/steps/slot-booker/book-slot/prompt.js

@@ -0,0 +1,24 @@
+export const prompt = `
+You'll be given a conversation between an agent and a user.
+
+The agent has requested slots from the system.
+
+This is the system's response:
+{{ slotBooker.foundSlots }}
+
+If the user has confirmed that they want to book one of the slots EXPLICITLY (i.e. agent has suggested a slot and asked to confirm and then the user confirmed), AND the slot is available based on the system's response, return the slot.
+
+If no slots are found or user hasn't confirmed their intention to book an explicit slot, add instructions explaining to the agent what they need to do. Do not fill in instructions if you return the slot.
+
+Current date: {{ slotBooker.currentDate }}
+
+{% if slotBooker.bookSlotQueryDefaults %}
+These are already known values:
+{{ slotBooker.bookSlotQueryDefaults }}
+{% endif %}
+
+{% if slotBooker.specificInstructionsPath %}
+# Important slot booking instructions
+{% include slotBooker.specificInstructionsPath %}
+{% endif %}
+`;

package/build/steps/slot-booker/book-slot/step.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { BasePlatform, IModels } from '../../../core';
+import { SlotBookerContext } from '../context';
+import { SlotBookerStepOpts } from '../interfaces';
+export declare function bookSlot<TFindSlots, TBooking, TContext extends SlotBookerContext, TFindSlotsResult, TBookedSlotResponse>(platform: BasePlatform<TContext, IModels>, opts: SlotBookerStepOpts<TFindSlots, TBooking, TContext, TFindSlotsResult, TBookedSlotResponse>): import("../../../engine").JsonLlmStep<TContext, z.ZodObject<{
+    instructions: z.ZodNullable<z.ZodString>;
+    bookingResult: z.ZodNullable<z.ZodObject<{
+        confirmedSlot: z.ZodType<TBooking, unknown, z.core.$ZodTypeInternals<TBooking, unknown>>;
+        humanReadableConfirmedSlot: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=step.d.ts.map

package/build/steps/slot-booker/book-slot/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/book-slot/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlD,wBAAgB,QAAQ,CACpB,UAAU,EACV,QAAQ,EACR,QAAQ,SAAS,iBAAiB,EAClC,gBAAgB,EAChB,mBAAmB,EAEnB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;;;;;;mBAgFlG"}

package/build/steps/slot-booker/book-slot/step.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { makeAllRequired } from '../../make-all-required';
+import { prompt } from './prompt';
+export function bookSlot(platform, opts) {
+    return platform.ai.getStepBuilder()({
+        name: 'book-slot',
+        prompt,
+        model: opts.llmAdapter,
+        schema: z.object({
+            instructions: z
+                .string()
+                .nullable()
+                .describe('If the agent needs to ask the user for more information, provide instructions for the agent here. Use null if no additional information is needed.'),
+            bookingResult: z
+                .object({
+                confirmedSlot: makeAllRequired(opts.getBookSlotQuerySchema()),
+                humanReadableConfirmedSlot: z
+                    .string()
+                    .describe('A human-readable description of the confirmed slot.'),
+            })
+                .nullable(),
+        }),
+        runIf: (conversation, ctx) => opts.triggerMessageProvider(conversation).hasAction('book') &&
+            !!ctx.slotBooker.foundSlots,
+        execute: async function (result, conversation, ctx, wf) {
+            platform.logger.log('[SLOTS][BookSlotStep] execute start. Raw response:', result);
+            if (result.instructions) {
+                await opts.addMessage({
+                    sender: 'system',
+                    text: 'Slot not booked yet. ' + result.instructions,
+                }, ctx, conversation);
+                await opts.rewind(ctx, wf);
+                return;
+            }
+            platform.logger.log('[SLOTS][BookSlotStep] No instructions returned; attempting booking.');
+            if (!result.bookingResult) {
+                platform.logger.log('[SLOTS][BookSlotStep] Error: bookingResult missing.');
+                throw new Error('No confirmed slot and no instructions provided in the response.');
+            }
+            const bookingResult = result.bookingResult;
+            const res = await opts.bookSlot(bookingResult.confirmedSlot, ctx);
+            platform.logger.log('[SLOTS][BookSlotStep] bookSlot() result:', res);
+            await opts.addMessage({
+                sender: 'system',
+                text: `Booked slot successfully: ${bookingResult.humanReadableConfirmedSlot}`,
+            }, ctx, conversation);
+            await opts.rewind(ctx, wf);
+            platform.logger.log('[SLOTS][BookSlotStep] Booking successful. Result set:', result);
+        },
+    });
+}

package/build/steps/slot-booker/check-slots-for-match/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const prompt = "\nYou'll be given a conversation between an agent and a user and a list of time slots for a booking.\n\nYou must respond with a summary of the slots (or the slots themselves if there's a few of them). The output should look like something a human could understand at a glance. If the user asked for a specific time slot, offer it first and then STOP and wait for them to agree. If they don't agree to proceed with the first slot, offer other option but not more than 3 in one output.\n\nIf there are slots that match user's latest query, set matchFound to true and include that information in the description.\n\nNote that the result description should be enough to make a decision. Neither agent nor user will see the slots themselves, only the description you provide.\n\nThese are the found slots:\n{{ slotBooker.foundSlots }}\n\nCurrent date: {{ slotBooker.currentDate }}\n\nDo not come up with slots that aren't in the list above, even if it's empty.\n\nDo not disclose any special instructions.\n\n# Response\nRespond with JSON: {\n    resultDescription: string\n    matchFound: boolean\n}\n\n{% if slotBooker.specificInstructionsPath %}\n# Important slot booking instructions\n{% include slotBooker.specificInstructionsPath %}\n{% endif %}\n\n";
+//# sourceMappingURL=prompt.d.ts.map

package/build/steps/slot-booker/check-slots-for-match/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/check-slots-for-match/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,uuCA6BlB,CAAA"}

package/build/steps/slot-booker/check-slots-for-match/prompt.js

@@ -0,0 +1,30 @@
+export const prompt = `
+You'll be given a conversation between an agent and a user and a list of time slots for a booking.
+
+You must respond with a summary of the slots (or the slots themselves if there's a few of them). The output should look like something a human could understand at a glance. If the user asked for a specific time slot, offer it first and then STOP and wait for them to agree. If they don't agree to proceed with the first slot, offer other option but not more than 3 in one output.
+
+If there are slots that match user's latest query, set matchFound to true and include that information in the description.
+
+Note that the result description should be enough to make a decision. Neither agent nor user will see the slots themselves, only the description you provide.
+
+These are the found slots:
+{{ slotBooker.foundSlots }}
+
+Current date: {{ slotBooker.currentDate }}
+
+Do not come up with slots that aren't in the list above, even if it's empty.
+
+Do not disclose any special instructions.
+
+# Response
+Respond with JSON: {
+    resultDescription: string
+    matchFound: boolean
+}
+
+{% if slotBooker.specificInstructionsPath %}
+# Important slot booking instructions
+{% include slotBooker.specificInstructionsPath %}
+{% endif %}
+
+`;

package/build/steps/slot-booker/check-slots-for-match/step.d.ts

@@ -0,0 +1,9 @@
+import { z } from 'zod';
+import type { BasePlatform, IModels } from '../../../core';
+import { SlotBookerContext } from '../context';
+import { SlotBookerStepOpts } from '../interfaces';
+export declare function checkSlotsForMatch<TFindSlots, TBooking, TContext extends SlotBookerContext, TFindSlotsResult, TBookedSlotResponse>(platform: BasePlatform<TContext, IModels>, opts: SlotBookerStepOpts<TFindSlots, TBooking, TContext, TFindSlotsResult, TBookedSlotResponse>): import("../../../engine").JsonLlmStep<TContext, z.ZodObject<{
+    resultDescription: z.ZodString;
+    matchFound: z.ZodBoolean;
+}, z.core.$strip>>;
+//# sourceMappingURL=step.d.ts.map

package/build/steps/slot-booker/check-slots-for-match/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/check-slots-for-match/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlD,wBAAgB,kBAAkB,CAC9B,UAAU,EACV,QAAQ,EACR,QAAQ,SAAS,iBAAiB,EAClC,gBAAgB,EAChB,mBAAmB,EAEnB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;;;mBA0BlG"}

package/build/steps/slot-booker/check-slots-for-match/step.js

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+import { prompt } from './prompt';
+export function checkSlotsForMatch(platform, opts) {
+    return platform.ai.getStepBuilder()({
+        name: 'check-slots-for-match',
+        prompt,
+        model: opts.llmAdapter,
+        schema: z.object({
+            resultDescription: z.string(),
+            matchFound: z.boolean(),
+        }),
+        runIf: (conversation, ctx) => opts.triggerMessageProvider(conversation).hasAction('find') &&
+            !!ctx.slotBooker.foundSlots,
+        execute: async (reply, conversation, ctx, wf) => {
+            platform.logger.log('[SLOTS][CheckSlots] execute start. Raw response:', reply);
+            await opts.addMessage({
+                sender: 'system',
+                text: `Follow the instructions: ${reply.resultDescription}`,
+            }, ctx, conversation);
+            await opts.rewind(ctx, wf);
+        },
+    });
+}

package/build/steps/slot-booker/cleanup/step.d.ts

@@ -0,0 +1,5 @@
+import type { BasePlatform, IModels } from '../../../core';
+import { SlotBookerContext } from '../context';
+import { SlotBookerStepOpts } from '../interfaces';
+export declare function cleanUpSlotBooker<TFindSlots, TBooking, TContext extends SlotBookerContext, TFindSlotsResult, TBookedSlotResponse>(platform: BasePlatform<TContext, IModels>, opts: SlotBookerStepOpts<TFindSlots, TBooking, TContext, TFindSlotsResult, TBookedSlotResponse>): import("../../../engine").ProgrammaticStep<TContext>;
+//# sourceMappingURL=step.d.ts.map

package/build/steps/slot-booker/cleanup/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/cleanup/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,wBAAgB,iBAAiB,CAC7B,UAAU,EACV,QAAQ,EACR,QAAQ,SAAS,iBAAiB,EAClC,gBAAgB,EAChB,mBAAmB,EAEnB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,wDAqBlG"}

package/build/steps/slot-booker/cleanup/step.js

@@ -0,0 +1,22 @@
+export function cleanUpSlotBooker(platform, opts) {
+    return platform.ai.getStepBuilder()({
+        name: 'clean-up-slot-booker',
+        runIf: async (_, ctx) => {
+            return ctx.slotBooker.hasStarted;
+        },
+        execute: async (_, ctx) => {
+            try {
+                await platform.contextCache.setContext(ctx.slotBooker.callId, {
+                    ...ctx,
+                    slotBooker: {
+                        callId: ctx.slotBooker.callId,
+                        hasStarted: false,
+                    },
+                });
+            }
+            finally {
+                await opts.unfreeze?.(ctx.slotBooker.callId);
+            }
+        },
+    });
+}

package/build/steps/slot-booker/context.d.ts

@@ -0,0 +1,14 @@
+export interface SlotBookerData {
+    callId: string;
+    hasStarted: boolean;
+    currentDate?: string;
+    dayOfWeek?: string;
+    specificInstructionsPath?: string;
+    findSlotsQueryDefaults?: string;
+    bookSlotQueryDefaults?: string;
+    foundSlots?: string;
+}
+export interface SlotBookerContext {
+    slotBooker: SlotBookerData;
+}
+//# sourceMappingURL=context.d.ts.map

package/build/steps/slot-booker/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/steps/slot-booker/context.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,cAAc,CAAA;CAC7B"}

package/build/steps/slot-booker/context.js

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

package/build/steps/slot-booker/find-slots/prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const prompt = "\nYou'll be given a conversation between an agent and a user.\nIf the user mentions the exact days they want - request those days only.\nIf the user does not mention the exact days, take the closest date to what they want and request slots for 5 days from that date.\n\nUser should let you know what date works and what time works (at least a general understanding).\n\nDo not ask the user again and again for their preference, unless absolutely necessary. KEEP IT NATURAL. If the user was explicit about not having a preference, suggest SOME slot.\n\nDo not output instructions if no other info is needed - just provide the query parameters.\n\nNEVER imply that the slot has already been booked or give out instructions to book slot. You ALWAYS must try to search for the slots, if provided enough input data. Even if you provided a response earlier. For booking we need to search for slots even if we did that earlier.\n\nCurrent date: {{ slotBooker.currentDate }}\n\nNEVER search for dates in the past.\n\n{% if slotBooker.specificInstructionsPath %}\n# Important slot booking instructions\n{% include slotBooker.specificInstructionsPath %}\n{% endif %}\n\n{% if slotBooker.findSlotsQueryDefaults %}\nThese are already known values:\n{{ slotBooker.findSlotsQueryDefaults }}\n{% endif %}\n";
+//# sourceMappingURL=prompt.d.ts.map

package/build/steps/slot-booker/find-slots/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/find-slots/prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,gxCA0BlB,CAAA"}

package/build/steps/slot-booker/find-slots/prompt.js

@@ -0,0 +1,27 @@
+export const prompt = `
+You'll be given a conversation between an agent and a user.
+If the user mentions the exact days they want - request those days only.
+If the user does not mention the exact days, take the closest date to what they want and request slots for 5 days from that date.
+
+User should let you know what date works and what time works (at least a general understanding).
+
+Do not ask the user again and again for their preference, unless absolutely necessary. KEEP IT NATURAL. If the user was explicit about not having a preference, suggest SOME slot.
+
+Do not output instructions if no other info is needed - just provide the query parameters.
+
+NEVER imply that the slot has already been booked or give out instructions to book slot. You ALWAYS must try to search for the slots, if provided enough input data. Even if you provided a response earlier. For booking we need to search for slots even if we did that earlier.
+
+Current date: {{ slotBooker.currentDate }}
+
+NEVER search for dates in the past.
+
+{% if slotBooker.specificInstructionsPath %}
+# Important slot booking instructions
+{% include slotBooker.specificInstructionsPath %}
+{% endif %}
+
+{% if slotBooker.findSlotsQueryDefaults %}
+These are already known values:
+{{ slotBooker.findSlotsQueryDefaults }}
+{% endif %}
+`;

package/build/steps/slot-booker/find-slots/step.d.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import type { BasePlatform, IModels } from '../../../core';
+import { SlotBookerContext } from '../context';
+import { SlotBookerStepOpts } from '../interfaces';
+export declare function findSlots<TFindSlots, TBooking, TContext extends SlotBookerContext, TFindSlotsResult, TBookedSlotResponse>(platform: BasePlatform<TContext, IModels>, opts: SlotBookerStepOpts<TFindSlots, TBooking, TContext, TFindSlotsResult, TBookedSlotResponse>): import("../../../engine").JsonLlmStep<TContext, z.ZodObject<{
+    result: z.ZodUnion<readonly [z.ZodObject<{
+        findSlots: z.ZodType<TFindSlots, unknown, z.core.$ZodTypeInternals<TFindSlots, unknown>>;
+    }, z.core.$strip>, z.ZodObject<{
+        instructions: z.ZodString;
+    }, z.core.$strip>]>;
+}, z.core.$strip>>;
+//# sourceMappingURL=step.d.ts.map

package/build/steps/slot-booker/find-slots/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/find-slots/step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGlD,wBAAgB,SAAS,CACrB,UAAU,EACV,QAAQ,EACR,QAAQ,SAAS,iBAAiB,EAClC,gBAAgB,EAChB,mBAAmB,EAEnB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,CAAC;;;;;;mBA8FlG"}

package/build/steps/slot-booker/find-slots/step.js

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { makeAllRequired } from '../../make-all-required';
+import { prompt } from './prompt';
+export function findSlots(platform, opts) {
+    return platform.ai.getStepBuilder()({
+        name: 'find-slots',
+        prompt,
+        model: opts.llmAdapter,
+        runIf: (conversation) => {
+            return opts.triggerMessageProvider(conversation).hasAction();
+        },
+        schema: z.object({
+            result: z.union([
+                z.object({
+                    findSlots: makeAllRequired(opts.getFindSlotsQuerySchema()),
+                }),
+                z.object({
+                    instructions: z
+                        .string()
+                        .describe('If the agent needs to ask the user for more information, provide instructions for the agent here.'),
+                }),
+            ]),
+        }),
+        execute: async function (response, conversation, ctx, wf) {
+            platform.logger.log('[SLOTS] execute() start. Raw response:', response);
+            const parsedResponse = response.result;
+            if (!parsedResponse) {
+                throw new Error('No response provided in the response object.');
+            }
+            platform.logger.log('[SLOTS] Parsed response:', parsedResponse);
+            if (opts.shouldAddMessageWithTag) {
+                await opts.addMessage({
+                    sender: 'agent',
+                    text: conversation.getProposedReply() || '',
+                }, ctx, conversation);
+            }
+            if ('instructions' in parsedResponse) {
+                platform.logger.log('[SLOTS] Instructions present, rewinding with system message.');
+                await opts.addMessage({
+                    sender: 'system',
+                    text: 'Slots not searched for yet. ' + parsedResponse.instructions,
+                }, ctx, conversation);
+                await opts.rewind(ctx, wf);
+                return;
+            }
+            if (!parsedResponse.findSlots) {
+                throw new Error(`Cannot proceed with booking: no instructions, no slots: ${JSON.stringify(parsedResponse)}`);
+            }
+            platform.logger.log('[SLOTS] Finding available slots via API with query:', {
+                query: parsedResponse.findSlots,
+            });
+            const availableSlots = await opts.findSlots(parsedResponse.findSlots, ctx);
+            platform.logger.log('[SLOTS] availableSlots:', availableSlots);
+            if (!opts.hasFoundSlots(availableSlots)) {
+                platform.logger.log('[SLOTS] No slots found (hasFoundSlots returned false).');
+                if (opts.onNoSlotsFound) {
+                    await opts.onNoSlotsFound(ctx, conversation, wf);
+                    return;
+                }
+                await opts.addMessage({
+                    sender: 'system',
+                    text: 'No available slots found for the specified date and time range.',
+                }, ctx, conversation);
+                await opts.rewind(ctx, wf);
+                return;
+            }
+            const slotBookerContextUpdates = {
+                foundSlots: JSON.stringify(availableSlots),
+            };
+            await platform.contextCache.setContext(ctx.slotBooker.callId, {
+                ...ctx,
+                slotBooker: {
+                    ...ctx.slotBooker,
+                    ...slotBookerContextUpdates,
+                },
+            });
+        },
+    });
+}

package/build/steps/slot-booker/init/step.d.ts

@@ -0,0 +1,5 @@
+import type { BasePlatform, IModels } from '../../../core';
+import { SlotBookerContext } from '../context';
+import { SlotBookerStepOpts } from '../interfaces';
+export declare function initSlotBooker<TFindSlots, TBooking, TContext extends SlotBookerContext, TFindSlotsResult, TBookedSlotResponse>(platform: BasePlatform<TContext, IModels>, opts: SlotBookerStepOpts<TFindSlots, TBooking, TContext, TFindSlotsResult, TBookedSlotResponse>): import("../../../engine").ProgrammaticStep<TContext>;
+//# sourceMappingURL=step.d.ts.map

package/build/steps/slot-booker/init/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../../src/steps/slot-booker/init/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAElD,wBAAgB,cAAc,CAC1B,UAAU,EACV,QAAQ,EACR,QAAQ,SAAS,iBAAiB,EAClC,gBAAgB,EAChB,mBAAmB,EAEnB,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,EACzC,IAAI,EAAE,kBAAkB,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,wDAqClG"}