@ixo/common 1.1.0

package/dist/ai/nodes/find-docs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/nodes/find-docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,WAAW,CAAC"}

package/dist/ai/nodes/find-docs/node.d.ts

@@ -0,0 +1,17 @@
+import { type VectorDBDataStore } from '@ixo/data-store';
+import { type Document } from '@langchain/core/documents';
+import { type BaseMessage } from '@langchain/core/messages';
+import { type RunnableConfig } from '@langchain/core/runnables';
+import 'dotenv/config';
+interface IFindDocsNodeRequiredState {
+    question: string;
+    docs: Document[];
+    messages?: BaseMessage[];
+    config?: {
+        isInternal: boolean;
+    };
+    status?: 'completed' | 'inProgress';
+}
+export declare const findDocsNode: (store: VectorDBDataStore) => (state: IFindDocsNodeRequiredState, config?: RunnableConfig) => Promise<Partial<IFindDocsNodeRequiredState>>;
+export {};
+//# sourceMappingURL=node.d.ts.map

package/dist/ai/nodes/find-docs/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../src/ai/nodes/find-docs/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,eAAe,CAAC;AAQvB,UAAU,0BAA0B;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE;QACP,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,GAAG,YAAY,CAAC;CACrC;AAOD,eAAO,MAAM,YAAY,GACtB,OAAO,iBAAiB,MAEvB,OAAO,0BAA0B,EACjC,SAAS,cAAc,KACtB,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAgD7C,CAAC"}

package/dist/ai/nodes/find-docs/node.js

@@ -0,0 +1,46 @@
+import { Logger } from '@ixo/logger';
+import { ChatPromptTemplate } from '@langchain/core/prompts';
+import 'dotenv/config';
+import z from 'zod';
+import { getChatOpenAiModel, retrieverToolFactory, SELF_QUERY_RAG_PROMPT, } from '../../index.js';
+export const findDocsNode = (store) => async (state, config) => {
+    try {
+        const model = getChatOpenAiModel();
+        const modelWithTools = model.withStructuredOutput(z.object({
+            questions: z.array(z.string('Generated Queries')),
+        }));
+        const chain = ChatPromptTemplate.fromMessages([
+            ['system', SELF_QUERY_RAG_PROMPT],
+            [
+                'user',
+                state.messages
+                    ? `this is the last three messages from the user's conversation ${state.messages
+                        .map((message) => message.content)
+                        .slice(-3)
+                        .join(',')}`
+                    : state.question,
+            ],
+        ]).pipe(modelWithTools);
+        const response = await chain.invoke({}, config);
+        const retrieval = retrieverToolFactory({
+            filters: state.config?.isInternal
+                ? undefined
+                : { approved: true, visibility: 'public' },
+            store,
+        });
+        const docs = await Promise.all(response.questions.map((question) => retrieval.invoke({ query: question })));
+        return {
+            docs: docs.flat().map((value) => ({
+                metadata: value.metadata,
+                pageContent: value.pageContent.toString(),
+                id: value.id,
+            })),
+            status: undefined,
+        };
+    }
+    catch (error) {
+        Logger.error('Error finding docs', error);
+        throw error;
+    }
+};
+//# sourceMappingURL=node.js.map

package/dist/ai/nodes/find-docs/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../src/ai/nodes/find-docs/node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,eAAe,CAAC;AACvB,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAiBxB,MAAM,CAAC,MAAM,YAAY,GACvB,CAAC,KAAwB,EAAE,EAAE,CAC7B,KAAK,EACH,KAAiC,EACjC,MAAuB,EACuB,EAAE;IAChD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,KAAK,CAAC,oBAAoB,CAC/C,CAAC,CAAC,MAAM,CAAC;YACP,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;SAClD,CAAC,CACH,CAAC;QAEF,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,CAAC;YAC5C,CAAC,QAAQ,EAAE,qBAAqB,CAAC;YACjC;gBACE,MAAM;gBACN,KAAK,CAAC,QAAQ;oBACZ,CAAC,CAAC,gEAAgE,KAAK,CAAC,QAAQ;yBAC3E,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;yBACjC,KAAK,CAAC,CAAC,CAAC,CAAC;yBACT,IAAI,CAAC,GAAG,CAAC,EAAE;oBAChB,CAAC,CAAC,KAAK,CAAC,QAAQ;aACnB;SACF,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAExB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,oBAAoB,CAAC;YACrC,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,UAAU;gBAC/B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE;YAC5C,KAAK;SACN,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAC5B,QAAQ,CAAC,SAAS,CAAC,GAAG,CACpB,CAAC,QAAQ,EAAE,EAAE,CACX,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAwB,CAC/D,CACF,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,EAAE;gBACzC,EAAE,EAAE,KAAK,CAAC,EAAE;aACb,CAAC,CAAC;YACH,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/ai/nodes/generic-chat/generic-chat.node.d.ts

@@ -0,0 +1,12 @@
+import { BaseMessage } from '@langchain/core/messages';
+import { RunnableConfig } from '@langchain/core/runnables';
+import { StructuredTool, Tool } from '@langchain/core/tools';
+import { InputVariables } from './generic-chat.prompt.js';
+type StateWithMessages<S extends object> = {
+    messages: BaseMessage[];
+} & S;
+export declare const createGenericChatNode: (inputVariables: InputVariables, tools: (Tool | StructuredTool)[], llm?: import("@langchain/openai").ChatOpenAI<import("@langchain/openai").ChatOpenAICallOptions>) => <S extends object>(state: StateWithMessages<S>, config?: RunnableConfig) => Promise<{
+    messages: import("@langchain/core/messages").AIMessageChunk<import("@langchain/core/messages").MessageStructure>[];
+}>;
+export {};
+//# sourceMappingURL=generic-chat.node.d.ts.map

package/dist/ai/nodes/generic-chat/generic-chat.node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-chat.node.d.ts","sourceRoot":"","sources":["../../../../src/ai/nodes/generic-chat/generic-chat.node.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAKvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAuB,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/E,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,IAAI;IACzC,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB,GAAG,CAAC,CAAC;AAEN,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,cAAc,EAC9B,OAAO,CAAC,IAAI,GAAG,cAAc,CAAC,EAAE,EAChC,+FAA0B,MAEZ,CAAC,SAAS,MAAM,EAC5B,OAAO,iBAAiB,CAAC,CAAC,CAAC,EAC3B,SAAS,cAAc;;EAmC1B,CAAC"}

package/dist/ai/nodes/generic-chat/generic-chat.node.js

@@ -0,0 +1,34 @@
+import { Logger } from '@ixo/logger';
+import { ChatPromptTemplate, MessagesPlaceholder, } from '@langchain/core/prompts';
+import { getChatOpenAiModel } from '../../../ai/models/openai.js';
+import { GENERIC_CHAT_PROMPT } from './generic-chat.prompt.js';
+export const createGenericChatNode = (inputVariables, tools, llm = getChatOpenAiModel()) => {
+    return async (state, config) => {
+        Logger.debug('Generic chat node called', {
+            state,
+            config,
+        });
+        let systemPrompt = '';
+        try {
+            systemPrompt = await GENERIC_CHAT_PROMPT.format(inputVariables);
+        }
+        catch (error) {
+            Logger.error('Error formatting system prompt', error);
+            throw error;
+        }
+        const chain = ChatPromptTemplate.fromMessages([
+            ['system', systemPrompt],
+            new MessagesPlaceholder('msgs'),
+        ]).pipe(llm.bindTools(tools));
+        const result = await chain.invoke({
+            msgs: state.messages,
+        }, config);
+        Logger.debug('Generic chat node result', {
+            result,
+        });
+        return {
+            messages: [result],
+        };
+    };
+};
+//# sourceMappingURL=generic-chat.node.js.map

package/dist/ai/nodes/generic-chat/generic-chat.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-chat.node.js","sourceRoot":"","sources":["../../../../src/ai/nodes/generic-chat/generic-chat.node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAkB,MAAM,0BAA0B,CAAC;AAM/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,cAA8B,EAC9B,KAAgC,EAChC,GAAG,GAAG,kBAAkB,EAAE,EAC1B,EAAE;IACF,OAAO,KAAK,EACV,KAA2B,EAC3B,MAAuB,EACvB,EAAE;QACF,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;YACvC,KAAK;YACL,MAAM;SACP,CAAC,CAAC;QAEH,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,YAAY,CAAC;YAC5C,CAAC,QAAQ,EAAE,YAAY,CAAC;YACxB,IAAI,mBAAmB,CAAC,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAC/B;YACE,IAAI,EAAE,KAAK,CAAC,QAAQ;SACrB,EACD,MAAM,CACP,CAAC;QAEF,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE;YACvC,MAAM;SACP,CAAC,CAAC;QAEH,OAAO;YACL,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC"}

package/dist/ai/nodes/generic-chat/generic-chat.prompt.d.ts

@@ -0,0 +1,10 @@
+import { PromptTemplate } from '@langchain/core/prompts';
+export type InputVariables = {
+    APP_NAME: string;
+    APP_PURPOSE: string;
+    APP_MAIN_FEATURES: string;
+    APP_TARGET_USERS: string;
+    APP_UNIQUE_SELLING_POINTS: string;
+};
+export declare const GENERIC_CHAT_PROMPT: PromptTemplate<InputVariables, never>;
+//# sourceMappingURL=generic-chat.prompt.d.ts.map

package/dist/ai/nodes/generic-chat/generic-chat.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-chat.prompt.d.ts","sourceRoot":"","sources":["../../../../src/ai/nodes/generic-chat/generic-chat.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;CACnC,CAAC;AAEF,eAAO,MAAM,mBAAmB,uCAuD9B,CAAC"}

package/dist/ai/nodes/generic-chat/generic-chat.prompt.js

@@ -0,0 +1,58 @@
+import { PromptTemplate } from '@langchain/core/prompts';
+export const GENERIC_CHAT_PROMPT = new PromptTemplate({
+    template: `# IXO AI Assistant: Expert Guide and Conversational Partner
+
+## Your Identity
+You are an AI assistant for the IXO Organization. Your primary role is to engage users in friendly, natural conversations, offering casual and informative chitchat. You can discuss various topics to keep conversations engaging and approachable.
+
+Additionally, you have detailed knowledge about the app hosting you. Below is essential information about the hosting app that you can refer to when responding to user inquiries about it:
+
+## App Information
+### App Details
+- **App Name**: {{APP_NAME}}
+- **App Purpose**: {{APP_PURPOSE}}
+- **Main Features**: {{APP_MAIN_FEATURES}}
+- **Target Users**: {{APP_TARGET_USERS}}
+- **Unique Selling Points**: {{APP_UNIQUE_SELLING_POINTS}}
+
+
+## Your Capabilities
+- Provide detailed information about the IXO app and ecosystem
+- Engage in natural, friendly conversation on various topics
+- Explain complex concepts in accessible language
+- Guide users through app features when they express interest
+- Offer relevant suggestions based on user inquiries
+
+## Communication Style
+- **Tone**: Professional yet warm, conversational, and engaging
+- **Language**: Clear, concise, and jargon-free unless requested
+- **Personality**: Helpful, patient, and slightly enthusiastic
+- **Responses**: Informative but concise, typically 2-4 sentences
+
+## Interaction Guidelines
+- Begin responses with direct answers to user questions
+- When discussing app features, provide concrete examples of how they benefit users
+- For complex topics, use analogies or step-by-step explanations
+- If uncertain about a specific app detail, acknowledge this transparently
+- Balance informative content with conversational elements
+- Proactively suggest relevant app features when appropriate
+- Personalize responses based on user's demonstrated knowledge level
+
+## What to Avoid
+- Making claims about app capabilities not listed in your knowledge base
+- Using overly technical language with non-technical users
+- Providing lengthy, overwhelming responses
+- Making definitive statements about future IXO developments unless explicitly mentioned
+- Sharing sensitive information about IXO's internal operations
+
+Remember that your primary goal is to create a positive, informative experience that builds trust in the IXO platform while making users feel valued and understood.`,
+    inputVariables: [
+        'APP_NAME',
+        'APP_PURPOSE',
+        'APP_MAIN_FEATURES',
+        'APP_TARGET_USERS',
+        'APP_UNIQUE_SELLING_POINTS',
+    ],
+    templateFormat: 'mustache',
+});
+//# sourceMappingURL=generic-chat.prompt.js.map

package/dist/ai/nodes/generic-chat/generic-chat.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-chat.prompt.js","sourceRoot":"","sources":["../../../../src/ai/nodes/generic-chat/generic-chat.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAUzD,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,cAAc,CAAwB;IAC3E,QAAQ,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qKA6CyJ;IACnK,cAAc,EAAE;QACd,UAAU;QACV,aAAa;QACb,mBAAmB;QACnB,kBAAkB;QAClB,2BAA2B;KAC5B;IACD,cAAc,EAAE,UAAU;CAC3B,CAAC,CAAC"}

package/dist/ai/nodes/generic-chat/index.d.ts

@@ -0,0 +1,2 @@
+export * from './generic-chat.node.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/nodes/generic-chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ai/nodes/generic-chat/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/ai/nodes/generic-chat/index.js

@@ -0,0 +1,2 @@
+export * from './generic-chat.node.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/nodes/generic-chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ai/nodes/generic-chat/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/ai/nodes/index.d.ts

@@ -0,0 +1,4 @@
+export * from './create-fake-node.js';
+export * from './find-docs/index.js';
+export * from './generic-chat/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/nodes/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/nodes/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/ai/nodes/index.js

@@ -0,0 +1,4 @@
+export * from './create-fake-node.js';
+export * from './find-docs/index.js';
+export * from './generic-chat/index.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/nodes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/nodes/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC"}

package/dist/ai/semantic-router-factory/create-semantic-router.d.ts

@@ -0,0 +1,7 @@
+import { LangfuseConfig } from 'langfuse';
+import { zodResponseFormat } from 'openai/helpers/zod';
+import { type EnsureKeys } from '../types.js';
+import { ParsedChatCompletion } from 'openai/resources/chat/completions.mjs';
+export declare const createSemanticRouter: <K extends string[], R extends Record<string, string> = Record<string, string>>(routes: R, basedOn: K, model?: "gpt-4o-mini" | "gpt-4o" | "gpt-4.1-nano" | "gpt-4.1-mini", isComplex?: boolean) => ((state: EnsureKeys<Record<string, unknown>, K>, traceConfig?: LangfuseConfig) => Promise<keyof R>);
+export { zodResponseFormat, type ParsedChatCompletion };
+//# sourceMappingURL=create-semantic-router.d.ts.map

package/dist/ai/semantic-router-factory/create-semantic-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-semantic-router.d.ts","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/create-semantic-router.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAiB,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAK9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAkB7E,eAAO,MAAM,oBAAoB,GAC/B,CAAC,SAAS,MAAM,EAAE,EAClB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAEzD,QAAQ,CAAC,EACT,SAAS,CAAC,EACV,QACI,aAAa,GACb,QAAQ,GACR,cAAc,GACd,cAA+B,EACnC,mBAAiB,KAChB,CAAC,CACF,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,EAC7C,WAAW,CAAC,EAAE,cAAc,KACzB,OAAO,CAAC,MAAM,CAAC,CAAC,CAyFpB,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,CAAC"}

package/dist/ai/semantic-router-factory/create-semantic-router.js

@@ -0,0 +1,71 @@
+import { Logger } from '@ixo/logger';
+import { PromptTemplate } from '@langchain/core/prompts';
+import { observeOpenAI } from 'langfuse';
+import { OpenAI } from 'openai';
+import { zodResponseFormat } from 'openai/helpers/zod';
+import z from 'zod';
+import { jsonToYaml } from '../utils/index.js';
+import { semanticRouterPrompt } from './semantic-router-prompt.js';
+import { validateRoutes } from './validate-routes.js';
+export const createSemanticRouter = (routes, basedOn, model = 'gpt-4.1-mini', isComplex = false) => {
+    const keys = validateRoutes(routes, basedOn);
+    const schema = z.object({
+        nextRoute: z.enum(keys, 'The routes that will be used to resolve the path'),
+    });
+    return async (state, traceConfig) => {
+        const selectedValues = {};
+        for (const key of basedOn) {
+            const stateValue = state[key];
+            if (!stateValue) {
+                throw new Error(`The state must have a value for the key ${key}`);
+            }
+            selectedValues[key] = stateValue;
+        }
+        if (Object.values(selectedValues).length === 0) {
+            throw new Error(`The state must have a value for the key ${basedOn.toString()}`);
+        }
+        const prompt = PromptTemplate.fromTemplate(semanticRouterPrompt);
+        const client = observeOpenAI(new OpenAI(), traceConfig);
+        const promptWithState = await prompt.format({
+            routes: jsonToYaml(routes),
+            state: jsonToYaml(selectedValues),
+        });
+        const getRoute = async (messages) => {
+            if (model === 'gpt-4.1-nano' && isComplex) {
+                const { choices } = await client.chat.completions.create({
+                    messages,
+                    model,
+                });
+                const route = choices[0]?.message?.content?.toString();
+                Logger.debug('🚀 ~ route:', route);
+                return client.chat.completions.parse({
+                    model,
+                    messages,
+                    response_format: zodResponseFormat(schema, 'routesResponse'),
+                });
+            }
+            return client.chat.completions.parse({
+                model,
+                messages,
+                response_format: zodResponseFormat(schema, 'routesResponse'),
+            });
+        };
+        const completion = await getRoute([
+            { role: 'system', content: promptWithState },
+            {
+                role: 'user',
+                content: 'Think and analyze the routes and messages then select the next route',
+            },
+        ]);
+        const message = completion.choices[0]?.message;
+        if (message?.parsed) {
+            const nextRoute = message.parsed.nextRoute;
+            Logger.debug(`🚀 ~ nextRoute: ${message.parsed.nextRoute.toString()}`, message.parsed);
+            return nextRoute;
+        }
+        Logger.error('Error parsing the response from the semantic router');
+        throw new Error('Error parsing the response from the semantic router');
+    };
+};
+export { zodResponseFormat };
+//# sourceMappingURL=create-semantic-router.js.map

package/dist/ai/semantic-router-factory/create-semantic-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-semantic-router.js","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/create-semantic-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAkB,aAAa,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAQ,CAAC,MAAM,KAAK,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoBtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAIlC,MAAS,EACT,OAAU,EACV,QAIqB,cAAc,EACnC,SAAS,GAAG,KAAK,EAII,EAAE;IACvB,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACtB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,IAA6B,EAAE,kDAAkD,CAAC;KACrG,CAAC,CAAC;IACH,OAAO,KAAK,EACV,KAAuB,EACvB,WAA4B,EACV,EAAE;QACpB,MAAM,cAAc,GAAG,EAAqC,CAAC;QAC7D,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,2CAA2C,GAAG,EAAE,CAAC,CAAC;YACpE,CAAC;YAED,cAAc,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QACnC,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CACb,2CAA2C,OAAO,CAAC,QAAQ,EAAE,EAAE,CAChE,CAAC;QACJ,CAAC;QAGD,MAAM,MAAM,GAAG,cAAc,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,MAAM,EAAE,EAAE,WAAW,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YAC1C,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC;YAC1B,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC;SAClC,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,KAAK,EACpB,QAGG,EAOH,EAAE;YACF,IAAI,KAAK,KAAK,cAAc,IAAI,SAAS,EAAE,CAAC;gBAC1C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;oBACvD,QAAQ;oBACR,KAAK;iBACN,CAAC,CAAC;gBAEH,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACvD,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;gBACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;oBACnC,KAAK;oBACL,QAAQ;oBACR,eAAe,EAAE,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;gBACnC,KAAK;gBACL,QAAQ;gBACR,eAAe,EAAE,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,CAAC;aAC7D,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC;YAChC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE;YAC5C;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EACL,sEAAsE;aACzE;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC;QAE/C,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3C,MAAM,CAAC,KAAK,CACV,mBAAmB,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,EACxD,OAAO,CAAC,MAAM,CACf,CAAC;YAEF,OAAO,SAAoB,CAAC;QAC9B,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAA6B,CAAC"}

package/dist/ai/semantic-router-factory/create-semantic-router.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-semantic-router.test.d.ts.map

package/dist/ai/semantic-router-factory/create-semantic-router.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-semantic-router.test.d.ts","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/create-semantic-router.test.ts"],"names":[],"mappings":""}

package/dist/ai/semantic-router-factory/create-semantic-router.test.js

@@ -0,0 +1,68 @@
+import { createSemanticRouter } from './create-semantic-router.js';
+const parse = jest.fn();
+const create = jest.fn();
+jest.mock('openai', () => ({
+    OpenAI: jest.fn().mockImplementation(() => {
+        function fn() {
+            return {};
+        }
+        fn.beta = {
+            chat: {
+                completions: { parse },
+            },
+        };
+        fn.chat = {
+            completions: { create },
+        };
+        return fn;
+    }),
+}));
+describe('createSemanticRouter', () => {
+    it('should create a semantic router with valid routes', () => {
+        expect(() => createSemanticRouter({
+            generateBlog: 'if the intent is blog',
+            generateSocialMediaPost: 'if the intent is post',
+        }, ['intent'])).not.toThrow();
+    });
+    it('should fail to create a semantic router with invalid routes', () => {
+        expect(() => createSemanticRouter({}, ['intent'])).toThrow();
+    });
+    it('should fail to get route with invalid state', async () => {
+        const router = createSemanticRouter({
+            generateBlog: 'if the intent is blog',
+            generateSocialMediaPost: 'if the intent is post',
+        }, ['intent']);
+        await expect(router({
+            foo: 'boo',
+        })).rejects.toThrow();
+    });
+    it('should get route with valid state', async () => {
+        const router = createSemanticRouter({
+            generateBlog: 'if the intent is blog',
+            generateSocialMediaPost: 'if the intent is post',
+        }, ['intent'], 'gpt-4o-mini', false);
+        parse.mockResolvedValue({
+            choices: [
+                {
+                    message: {
+                        parsed: {
+                            nextRoute: 'generateBlog',
+                        },
+                        content: 'generateBlog',
+                        role: 'assistant',
+                        refusal: null,
+                        tool_calls: [],
+                    },
+                    finish_reason: 'stop',
+                    index: 0,
+                    logprobs: null,
+                },
+            ],
+        });
+        const route = await router({
+            intent: 'blog',
+        });
+        expect(route).toBe('generateBlog');
+    });
+});
+//# sourceMappingURL=create-semantic-router.test.js.map

package/dist/ai/semantic-router-factory/create-semantic-router.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-semantic-router.test.js","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/create-semantic-router.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AACxB,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;AACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;QACxC,SAAS,EAAE;YACT,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,EAAE,CAAC,IAAI,GAAG;YACR,IAAI,EAAE;gBACJ,WAAW,EAAE,EAAE,KAAK,EAAE;aACvB;SACF,CAAC;QAEF,EAAE,CAAC,IAAI,GAAG;YACR,WAAW,EAAE,EAAE,MAAM,EAAE;SACxB,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAQ3D,MAAM,CAAC,GAAG,EAAE,CACV,oBAAoB,CAClB;YACE,YAAY,EAAE,uBAAuB;YACrC,uBAAuB,EAAE,uBAAuB;SACjD,EACD,CAAC,QAAQ,CAAC,CACX,CACF,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,MAAM,GAAG,oBAAoB,CACjC;YACE,YAAY,EAAE,uBAAuB;YACrC,uBAAuB,EAAE,uBAAuB;SACjD,EACD,CAAC,QAAQ,CAAC,CACX,CAAC;QACF,MAAM,MAAM,CACV,MAAM,CAAC;YACL,GAAG,EAAE,KAAK;SACX,CAAC,CACH,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,MAAM,GAAG,oBAAoB,CACjC;YACE,YAAY,EAAE,uBAAuB;YACrC,uBAAuB,EAAE,uBAAuB;SACjD,EACD,CAAC,QAAQ,CAAC,EACV,aAAa,EACb,KAAK,CACN,CAAC;QAEF,KAAK,CAAC,iBAAiB,CAAC;YACtB,OAAO,EAAE;gBACP;oBACE,OAAO,EAAE;wBACP,MAAM,EAAE;4BACN,SAAS,EAAE,cAAc;yBAC1B;wBACD,OAAO,EAAE,cAAc;wBACvB,IAAI,EAAE,WAAW;wBACjB,OAAO,EAAE,IAAI;wBACb,UAAU,EAAE,EAAE;qBACf;oBACD,aAAa,EAAE,MAAM;oBACrB,KAAK,EAAE,CAAC;oBACR,QAAQ,EAAE,IAAI;iBACf;aACF;SACF,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;YACzB,MAAM,EAAE,MAAM;SACf,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/ai/semantic-router-factory/index.d.ts

@@ -0,0 +1,4 @@
+export * from './create-semantic-router.js';
+export * from './semantic-router-prompt.js';
+export * from './validate-routes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/semantic-router-factory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC"}

package/dist/ai/semantic-router-factory/index.js

@@ -0,0 +1,4 @@
+export * from './create-semantic-router.js';
+export * from './semantic-router-prompt.js';
+export * from './validate-routes.js';
+//# sourceMappingURL=index.js.map

package/dist/ai/semantic-router-factory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC"}

package/dist/ai/semantic-router-factory/semantic-router-prompt.d.ts

@@ -0,0 +1,2 @@
+export declare const semanticRouterPrompt = "You are semantic router responsible for determining the next route based on the given routes and state.\n\n**Instructions:**\n\n1. **Read the Input:**\n   - You will receive two pieces of input:\n     - **Routes**: A set of named routes with specific conditions that need to be evaluated.\n     - **State**: A set of properties that will be used to determine the next route. from the conditions provided in the routes.\n\n2. **Understand the Conditions Format:**\n   - Conditions will be provided in a human-readable format. They may involve:\n     - Checking the value of specific properties (e.g., \"if the user type is 'admin'\").\n     - Evaluating multiple conditions with logical connectors like \"AND\" or \"OR\" (e.g., \"if the user type is 'guest' AND the access level is 'restricted'\").\n   - Your task is to convert these human-readable conditions into logical expressions that can be evaluated programmatically.\n\n3. **Special Handling for Message Arrays:**\n   - If the state contains a 'messages' array, respect their chronological order.\n   - The most recent messages (at the end of the array) should have higher significance for determining intent.\n   - Pay special attention to the last user message as it often contains the most current intent.\n\n4. **Evaluate Each Route:**\n   - For each route, check if the current state satisfies the condition:\n     - Example:\n       - Condition: \"if the user type is 'admin' AND the access level is 'full'\"\n       - State: \n         ```yaml\n         userType: admin\n         accessLevel: limited\n         ```\n       - Evaluation: This condition does NOT match because `accessLevel` is 'limited', not 'full'.\n\n5. **Return the Matching Route:**\n   - Identify and return the name of the first route where all conditions are met.\n   - If no route matches, return 'undefined'.\n\n**Example 1:**\n\n- **Routes:**\n  ```yaml\n  adminDashboard: \"if the user type is 'admin' AND the access level is 'full'\"\n  guestAccess: \"if the user type is 'guest' AND the access level is 'restricted'\"\n  viewOnlyMode: \"if the access level is 'view-only'\"\n  ```\n  \n- **State:**\n  ```yaml\n  userType: guest\n  accessLevel: restricted\n  ```\n\n**Evaluation:**\n- **adminDashboard**: Does not match (user type is 'guest', not 'admin').\n- **guestAccess**: Matches (user type is 'guest' and access level is 'restricted').\n- **viewOnlyMode**: Does not match (access level is 'restricted', not 'view-only').\n\n**Result:**\n- Output: \"guestAccess\"\n\n---\n\n**Example 2:**\n\n- **Routes:**\n  ```yaml\n  escalateTicket: \"if the ticket priority is 'high' AND the status is 'open'\"\n  autoClose: \"if the ticket status is 'resolved' AND the resolution time is less than 2 days\"\n  notifySupervisor: \"if the ticket priority is 'high' OR the customer rating is less than 3\"\n  ```\n\n- **State:**\n  ```yaml\n  ticketPriority: high\n  status: open\n  customerRating: 4\n  ```\n\n**Evaluation:**\n- **escalateTicket**: Matches (priority is 'high' and status is 'open').\n- **autoClose**: Does not match (status is 'open', not 'resolved').\n- **notifySupervisor**: Also matches (priority is 'high').\n\n**Result:**\n- Output: \"escalateTicket\" (First match found based on input order)\n\n---\n\n**Example 3 (with Messages):**\n\n- **Routes:**\n  ```yaml\n  chatMode: \"if the messages contain casual conversation or greetings\"\n  taskExecution: \"if the messages indicate a specific task to be performed\"\n  informationRequest: \"if the messages contain questions about how to use the system\"\n  ```\n\n- **State:**\n  ```yaml\n  messages:\n    - sender: user\n      content: \"Hello there!\"\n    - sender: assistant\n      content: \"Hi! How can I help you today?\"\n    - sender: user\n      content: \"I need to create a new domain for my project.\"\n  ```\n\n**Evaluation:**\n- **chatMode**: Does not match fully (initial messages were greetings, but the final message indicates a task).\n- **taskExecution**: Matches (the last message clearly indicates a specific task - domain creation).\n- **informationRequest**: Does not match (no questions about system usage).\n\n**Result:**\n- Output: \"taskExecution\" (Based on the latest user intent in the message array)\n\n---\n\n**Example 4:**\n\n- **Routes:**\n  ```yaml\n  initiateRefund: \"if the order status is 'cancelled' AND the payment method is 'credit card'\"\n  followUp: \"if the order status is 'shipped' AND the delivery status is 'delayed'\"\n  quickResolve: \"if the order status is 'delivered' AND the customer feedback is 'positive'\"\n  ```\n\n- **State:**\n  ```yaml\n  orderStatus: shipped\n  deliveryStatus: delayed\n  paymentMethod: credit card\n  ```\n\n**Evaluation:**\n- **initiateRefund**: Does not match (order status is 'shipped', not 'cancelled').\n- **followUp**: Matches (order status is 'shipped' and delivery status is 'delayed').\n- **quickResolve**: Does not match (order status is 'shipped', not 'delivered').\n\n**Result:**\n- Output: \"followUp\"\n\n**Goal:**\n- Analyze the routes and state provided.\n- Explain each evaluation step clearly.\n- Return the correct route name or \"undefined\" if no match is found.\n\n**Output Format:**\n- Provide a single line output with the name of the matched route or \"undefined\".\n\n**Additional Notes:**\n- Be precise and ensure the evaluation logic follows the conditions specified.\n- If multiple conditions are specified, all must be met for a route to be valid.\n- The decision should be based on clear, logical reasoning derived from the state values.\n- When messages are included, prioritize the most recent message for determining intent.\n- Message ordering represents the chronological flow of conversation - later messages reflect the most current intent.\n\n----\nYOUR MISSION IS TO RESOLVE THE ROUTE BASED ON THE STATE PROVIDED. GOOD LUCK!\n\n- **Routes:**\n```yaml\n{routes}\n```\n\n- **State:**\n```yaml\n{state}\n```\n";
+//# sourceMappingURL=semantic-router-prompt.d.ts.map

package/dist/ai/semantic-router-factory/semantic-router-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-router-prompt.d.ts","sourceRoot":"","sources":["../../../src/ai/semantic-router-factory/semantic-router-prompt.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,ozLAuKhC,CAAC"}

package/dist/ai/semantic-router-factory/semantic-router-prompt.js

@@ -0,0 +1,169 @@
+export const semanticRouterPrompt = `You are semantic router responsible for determining the next route based on the given routes and state.
+
+**Instructions:**
+
+1. **Read the Input:**
+   - You will receive two pieces of input:
+     - **Routes**: A set of named routes with specific conditions that need to be evaluated.
+     - **State**: A set of properties that will be used to determine the next route. from the conditions provided in the routes.
+
+2. **Understand the Conditions Format:**
+   - Conditions will be provided in a human-readable format. They may involve:
+     - Checking the value of specific properties (e.g., "if the user type is 'admin'").
+     - Evaluating multiple conditions with logical connectors like "AND" or "OR" (e.g., "if the user type is 'guest' AND the access level is 'restricted'").
+   - Your task is to convert these human-readable conditions into logical expressions that can be evaluated programmatically.
+
+3. **Special Handling for Message Arrays:**
+   - If the state contains a 'messages' array, respect their chronological order.
+   - The most recent messages (at the end of the array) should have higher significance for determining intent.
+   - Pay special attention to the last user message as it often contains the most current intent.
+
+4. **Evaluate Each Route:**
+   - For each route, check if the current state satisfies the condition:
+     - Example:
+       - Condition: "if the user type is 'admin' AND the access level is 'full'"
+       - State: 
+         \`\`\`yaml
+         userType: admin
+         accessLevel: limited
+         \`\`\`
+       - Evaluation: This condition does NOT match because \`accessLevel\` is 'limited', not 'full'.
+
+5. **Return the Matching Route:**
+   - Identify and return the name of the first route where all conditions are met.
+   - If no route matches, return 'undefined'.
+
+**Example 1:**
+
+- **Routes:**
+  \`\`\`yaml
+  adminDashboard: "if the user type is 'admin' AND the access level is 'full'"
+  guestAccess: "if the user type is 'guest' AND the access level is 'restricted'"
+  viewOnlyMode: "if the access level is 'view-only'"
+  \`\`\`
+  
+- **State:**
+  \`\`\`yaml
+  userType: guest
+  accessLevel: restricted
+  \`\`\`
+
+**Evaluation:**
+- **adminDashboard**: Does not match (user type is 'guest', not 'admin').
+- **guestAccess**: Matches (user type is 'guest' and access level is 'restricted').
+- **viewOnlyMode**: Does not match (access level is 'restricted', not 'view-only').
+
+**Result:**
+- Output: "guestAccess"
+
+---
+
+**Example 2:**
+
+- **Routes:**
+  \`\`\`yaml
+  escalateTicket: "if the ticket priority is 'high' AND the status is 'open'"
+  autoClose: "if the ticket status is 'resolved' AND the resolution time is less than 2 days"
+  notifySupervisor: "if the ticket priority is 'high' OR the customer rating is less than 3"
+  \`\`\`
+
+- **State:**
+  \`\`\`yaml
+  ticketPriority: high
+  status: open
+  customerRating: 4
+  \`\`\`
+
+**Evaluation:**
+- **escalateTicket**: Matches (priority is 'high' and status is 'open').
+- **autoClose**: Does not match (status is 'open', not 'resolved').
+- **notifySupervisor**: Also matches (priority is 'high').
+
+**Result:**
+- Output: "escalateTicket" (First match found based on input order)
+
+---
+
+**Example 3 (with Messages):**
+
+- **Routes:**
+  \`\`\`yaml
+  chatMode: "if the messages contain casual conversation or greetings"
+  taskExecution: "if the messages indicate a specific task to be performed"
+  informationRequest: "if the messages contain questions about how to use the system"
+  \`\`\`
+
+- **State:**
+  \`\`\`yaml
+  messages:
+    - sender: user
+      content: "Hello there!"
+    - sender: assistant
+      content: "Hi! How can I help you today?"
+    - sender: user
+      content: "I need to create a new domain for my project."
+  \`\`\`
+
+**Evaluation:**
+- **chatMode**: Does not match fully (initial messages were greetings, but the final message indicates a task).
+- **taskExecution**: Matches (the last message clearly indicates a specific task - domain creation).
+- **informationRequest**: Does not match (no questions about system usage).
+
+**Result:**
+- Output: "taskExecution" (Based on the latest user intent in the message array)
+
+---
+
+**Example 4:**
+
+- **Routes:**
+  \`\`\`yaml
+  initiateRefund: "if the order status is 'cancelled' AND the payment method is 'credit card'"
+  followUp: "if the order status is 'shipped' AND the delivery status is 'delayed'"
+  quickResolve: "if the order status is 'delivered' AND the customer feedback is 'positive'"
+  \`\`\`
+
+- **State:**
+  \`\`\`yaml
+  orderStatus: shipped
+  deliveryStatus: delayed
+  paymentMethod: credit card
+  \`\`\`
+
+**Evaluation:**
+- **initiateRefund**: Does not match (order status is 'shipped', not 'cancelled').
+- **followUp**: Matches (order status is 'shipped' and delivery status is 'delayed').
+- **quickResolve**: Does not match (order status is 'shipped', not 'delivered').
+
+**Result:**
+- Output: "followUp"
+
+**Goal:**
+- Analyze the routes and state provided.
+- Explain each evaluation step clearly.
+- Return the correct route name or "undefined" if no match is found.
+
+**Output Format:**
+- Provide a single line output with the name of the matched route or "undefined".
+
+**Additional Notes:**
+- Be precise and ensure the evaluation logic follows the conditions specified.
+- If multiple conditions are specified, all must be met for a route to be valid.
+- The decision should be based on clear, logical reasoning derived from the state values.
+- When messages are included, prioritize the most recent message for determining intent.
+- Message ordering represents the chronological flow of conversation - later messages reflect the most current intent.
+
+----
+YOUR MISSION IS TO RESOLVE THE ROUTE BASED ON THE STATE PROVIDED. GOOD LUCK!
+
+- **Routes:**
+\`\`\`yaml
+{routes}
+\`\`\`
+
+- **State:**
+\`\`\`yaml
+{state}
+\`\`\`
+`;
+//# sourceMappingURL=semantic-router-prompt.js.map