@radzor/chatbot-flow

Build conversational chatbot flows with nodes, conditions, and actions. Supports branching dialogues, context variables, fallback handling, and flow completion tracking.

Chat & Messagingv0.1.0typescriptpythonServerchatbotconversationaldialogueflowbotnlpby Radzor

Install

View source on GitHub →

$npx radzor@latest add chatbot-flow

⚠ Constraints: Sessions are in-memory; persist externally for production. Flow definitions are immutable after construction. Condition matchers are case-insensitive by default.

Inputs

Name	Type	Default	Description
flow*	FlowDefinition	—	Chat flow definition with nodes, edges, and conditions.
fallbackMessage	string	I didn't understand that. Could you rephrase?	Default message when no matching transition is found.
maxHistory	number	50	Maximum number of messages to keep in conversation history.

flow*FlowDefinition

Chat flow definition with nodes, edges, and conditions.

fallbackMessagestring

Default message when no matching transition is found.

default: I didn't understand that. Could you rephrase?

maxHistory

{ "llm": { "constraints": "Sessions are in-memory; persist externally for production. Flow definitions are immutable after construction. Condition matchers are case-insensitive by default.", "usageExamples": "llm/examples.md", "integrationPrompt": "llm/integration.md" }, "name": "@radzor/chatbot-flow", "tags": [ "chatbot", "conversational", "dialogue", "flow", "bot", "nlp" ], "events": [ { "name": "onNodeReached", "payload": { "nodeId": "string", "nodeName": "string", "sessionId": "string" }, "description": "Fired when the conversation enters a new node." }, { "name": "onFlowComplete", "payload": { "context": "Record<string, unknown>", "sessionId": "string", "messageCount": "number" }, "description": "Fired when the conversation reaches an end node." }, { "name": "onFallback", "payload": { "sessionId": "string", "currentNode": "string", "userMessage": "string" }, "description": "Fired when no transition matches the user's input." } ], "inputs": [ { "name": "flow", "type": "FlowDefinition", "required": true, "description": "Chat flow definition with nodes, edges, and conditions." }, { "name": "fallbackMessage", "type": "string", "default": "I didn't understand that. Could you rephrase?", "required": false, "description": "Default message when no matching transition is found." }, { "name": "maxHistory", "type": "number", "default": 50, "required": false, "description": "Maximum number of messages to keep in conversation history." } ], "radzor": "1.0.0", "actions": [ { "name": "start", "params": [ { "name": "sessionId", "type": "string", "description": "Unique session identifier for the conversation." }, { "name": "initialContext", "type": "Record<string, unknown>", "required": false, "description": "Optional initial context variables." } ], "returns": "BotResponse", "description": "Start a new conversation session from the root node." }, { "name": "processMessage", "params": [ { "name": "sessionId", "type": "string", "description": "Session identifier." }, { "name": "message", "type": "string", "description": "User's text message." } ], "returns": "BotResponse", "description": "Process a user message and return the bot's response." }, { "name": "setContext", "params": [ { "name": "sessionId", "type": "string", "description": "Session identifier." }, { "name": "key", "type": "string", "description": "Context key to set." }, { "name": "value", "type": "unknown", "description": "Context value." } ], "returns": "void", "description": "Set a context variable in an active session." }, { "name": "getHistory", "params": [ { "name": "sessionId", "type": "string", "description": "Session identifier." } ], "returns": "Message[]", "description": "Get the conversation history for a session." }, { "name": "reset", "params": [ { "name": "sessionId", "type": "string", "description": "Session identifier." } ], "returns": "BotResponse", "description": "Reset a session to the root node with fresh context." } ], "outputs": [ { "name": "botResponse", "type": "BotResponse", "fields": [ { "name": "message", "type": "string", "description": "The bot's text response." }, { "name": "options", "type": "string[] | null", "description": "Quick-reply options for the user, if any." }, { "name": "context", "type": "Record<string, unknown>", "description": "Current conversation context." }, { "name": "nodeId", "type": "string", "description": "ID of the current flow node." }, { "name": "isComplete", "type": "boolean", "description": "Whether the flow has reached an end node." } ], "description": "Response generated by the chatbot flow." } ], "runtime": "server", "version": "0.1.0", "category": "chat", "languages": [ "typescript", "python" ], "description": "Build conversational chatbot flows with nodes, conditions, and actions. Supports branching dialogues, context variables, fallback handling, and flow completion tracking.", "dependencies": { "radzor": [], "packages": {} }, "composability": { "connectsTo": [ { "output": "botResponse", "mapField": "message", "compatibleWith": [ "@radzor/llm-completion.action.complete.prompt", "@radzor/realtime-chat.action.sendMessage.content" ] }, { "event": "onFlowComplete", "description": "Notify support team when chatbot flow completes", "compatibleWith": [ "@radzor/email-send.action.send.message", "@radzor/slack-bot.action.sendMessage.text" ] }, { "event": "onFallback", "description": "Escalate to LLM when no flow transition matches", "compatibleWith": [ "@radzor/llm-completion.action.complete.prompt" ] } ] } }

@radzor/chatbot-flow

Install

Inputs

Outputs

Actions

Events

Composability

radzor.manifest.json