rushchatbot 1.6.7

package/package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "rushchatbot",
+  "version": "1.6.7",
+  "description": "Embeddable hybrid chatbot with n8n fallback, license key protection, and configurable FAQ tree",
+  "keywords": [
+    "chatbot",
+    "n8n",
+    "react",
+    "express",
+    "faq",
+    "widget"
+  ],
+  "license": "UNLICENSED",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.es.js",
+      "require": "./dist/client.cjs.js"
+    },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.es.js",
+      "require": "./dist/vue.cjs.js"
+    },
+    "./vue2": {
+      "types": "./dist/vue2.d.ts",
+      "import": "./dist/vue2.es.js",
+      "require": "./dist/vue2.cjs.js"
+    },
+    "./vanilla": {
+      "types": "./dist/vanilla.d.ts",
+      "import": "./dist/vanilla.es.js"
+    }
+  },
+  "bin": {
+    "rushchatbot": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "INTEGRATION.md"
+  ],
+  "scripts": {
+    "build": "npm run build:server && npm run build:react && npm run build:vue && npm run build:vue2 && npm run build:vanilla",
+    "build:server": "./node_modules/.bin/tsc -p tsconfig.json",
+    "build:react": "./node_modules/.bin/vite build",
+    "build:vue": "./node_modules/.bin/vite build --mode vue",
+    "build:vue2": "./node_modules/.bin/vite build --mode vue2",
+    "build:vanilla": "./node_modules/.bin/vite build --mode vanilla",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "axios": "^1.7.2",
+    "bad-words": "^4.1.5",
+    "cors": "^2.8.5",
+    "express": "^4.19.2",
+    "fuse.js": "^7.0.0",
+    "marked": "^18.0.13"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/bad-words": "^3.0.3",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.1.6",
+    "@types/react-dom": "^19.1.6",
+    "@vitejs/plugin-react": "^4.3.4",
+    "@vitejs/plugin-vue": "^5.0.0",
+    "vue": "^3.4.0",
+    "typescript": "^5.5.3",
+    "vite": "^6.3.5"
+  }
+}

package/package/src/cli/index.ts

@@ -0,0 +1,94 @@
+#!/usr/bin/env node
+import fs from 'fs'
+import path from 'path'
+
+const args = process.argv.slice(2)
+const command = args[0]
+
+const DEFAULT_CONFIG = {
+  branding: {
+    title: 'My ChatBot',
+    subtitle: 'How can we help you today?',
+    theme: {
+      primaryColor: '#4F46E5',
+      backgroundColor: '#FFFFFF',
+      userBubbleColor: '#4F46E5',
+      botBubbleColor: '#F3F4F6',
+      textColor: '#111827',
+      fontFamily: 'Inter, sans-serif',
+    },
+  },
+  n8n: {
+    webhookUrl: 'https://your-n8n.com/webhook/your-id',
+    timeoutMs: 55000,
+  },
+  chat: {
+    welcomeMessage: 'Hi! Choose a question below or type your own.',
+    fallbackMessage: "I'm looking into that for you...",
+    matchThreshold: 0.4,
+    showPreQuestionsOnStart: true,
+    language: 'en',
+  },
+}
+
+const DEFAULT_QUESTIONS = [
+  {
+    id: 'q1',
+    question: 'What services do you offer?',
+    answer: 'We offer a wide range of services. Please contact us for more details.',
+    subquestions: [],
+  },
+  {
+    id: 'q2',
+    question: 'How do I get in touch?',
+    answer: 'You can reach us via email or phone. Visit our Contact page for details.',
+    subquestions: [],
+  },
+]
+
+function writeIfNotExists(filePath: string, content: unknown) {
+  if (fs.existsSync(filePath)) {
+    console.log(`  [skip] ${filePath} already exists`)
+    return
+  }
+  fs.writeFileSync(filePath, JSON.stringify(content, null, 2))
+  console.log(`  [created] ${filePath}`)
+}
+
+if (command === 'init') {
+  const targetDir = args[1] ? path.resolve(args[1]) : process.cwd()
+  fs.mkdirSync(targetDir, { recursive: true })
+
+  console.log(`\nInitializing RushChatbot config in: ${targetDir}\n`)
+  writeIfNotExists(path.join(targetDir, 'chatbot.config.json'), DEFAULT_CONFIG)
+  writeIfNotExists(path.join(targetDir, 'questions.json'), DEFAULT_QUESTIONS)
+  writeIfNotExists(path.join(targetDir, 'questions.tl.json'), DEFAULT_QUESTIONS)
+
+  console.log(`
+Done! Next steps:
+  1. Edit chatbot.config.json — set your n8n webhookUrl and branding
+  2. Edit questions.json — add your FAQ tree
+  3. In your server entry file:
+
+     import { createServer } from 'rushchatbot/server'
+     import path from 'path'
+
+     createServer({
+       configPath: path.resolve('./chatbot.config.json'),
+       questionsPath: path.resolve('./questions.json'),
+       questionsTagalogPath: path.resolve('./questions.tl.json'),
+     }).listen()
+
+  4. In your React app:
+
+     import { ChatWidget } from 'rushchatbot/client'
+     <ChatWidget apiBase="http://localhost:3001/api/chat" />
+`)
+} else {
+  console.log(`
+RushChatbot CLI
+
+Commands:
+  rushchatbot init [dir]    Scaffold config and questions files
+`)
+}

package/package/src/client/ChatWidget.tsx

@@ -0,0 +1,163 @@
+import { useEffect, useRef, useState } from 'react'
+import { RushChatbot, parseMarkdown } from '../core/RushChatbot'
+import type { RushChatbotState } from '../core/RushChatbot'
+import type { Question } from '../shared/types'
+
+export interface ChatWidgetProps {
+  apiBase?: string
+  width?: number
+  height?: number
+}
+
+function MarkdownText({ text }: { text: string }) {
+  return (
+    <div
+      dangerouslySetInnerHTML={{ __html: parseMarkdown(text) }}
+      className='rushchatbot-md'
+      style={{ lineHeight: 1.6 }}
+    />
+  )
+}
+
+function ThinkingDots({ color }: { color: string }) {
+  return (
+    <span style={{ display: 'flex', gap: 4, alignItems: 'center' }}>
+      {[0, 1, 2].map(i => (
+        <span key={i} style={{
+          width: 7, height: 7, borderRadius: '50%', background: color,
+          display: 'inline-block',
+          animation: `rushchatbot-bounce 1.2s ease-in-out ${i * 0.2}s infinite`,
+        }} />
+      ))}
+      <style>{`
+        @keyframes rushchatbot-bounce {
+          0%, 80%, 100% { transform: translateY(0); opacity: 0.4; }
+          40% { transform: translateY(-6px); opacity: 1; }
+        }
+        .rushchatbot-md p { margin: 0 0 6px 0; }
+        .rushchatbot-md p:last-child { margin-bottom: 0; }
+        .rushchatbot-md strong { font-weight: 600; }
+        .rushchatbot-md ul, .rushchatbot-md ol { margin: 4px 0 4px 16px; padding: 0; }
+        .rushchatbot-md li { margin-bottom: 2px; }
+        .rushchatbot-md a { color: inherit; text-decoration: underline; }
+        .rushchatbot-md h1, .rushchatbot-md h2, .rushchatbot-md h3 { margin: 4px 0 6px 0; font-weight: 700; line-height: 1.3; }
+        .rushchatbot-md h1 { font-size: 1.1em; }
+        .rushchatbot-md h2 { font-size: 1em; }
+        .rushchatbot-md h3 { font-size: 0.95em; }
+      `}</style>
+    </span>
+  )
+}
+
+export function ChatWidget({ apiBase, width = 380, height = 580 }: ChatWidgetProps) {
+  const chatRef = useRef<RushChatbot | null>(null)
+  const [state, setState] = useState<RushChatbotState | null>(null)
+  const bottomRef = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    const chat = new RushChatbot({ apiBase })
+    chatRef.current = chat
+    const unsub = chat.subscribe(setState)
+    chat.init()
+    return unsub
+  }, [apiBase])
+
+  useEffect(() => {
+    bottomRef.current?.scrollIntoView({ behavior: 'smooth' })
+  }, [state?.messages, state?.loading])
+
+  if (!state?.config) return null
+
+  const chat = chatRef.current!
+  const { theme, title, subtitle } = state.config.branding
+
+  const bubble = (isUser: boolean) => ({
+    background: isUser ? theme.userBubbleColor : theme.botBubbleColor,
+    color: isUser ? '#fff' : theme.textColor,
+    padding: '10px 14px', borderRadius: 12, maxWidth: '80%', fontSize: 14, lineHeight: 1.5,
+  })
+
+  return (
+    <div style={{
+      fontFamily: theme.fontFamily, color: theme.textColor, background: theme.backgroundColor,
+      width, height, borderRadius: 16, boxShadow: '0 8px 32px rgba(0,0,0,0.15)',
+      display: 'flex', flexDirection: 'column', overflow: 'hidden',
+    }}>
+      <div style={{ background: theme.primaryColor, padding: '16px 20px', color: '#fff' }}>
+        <div style={{ fontWeight: 700, fontSize: 16 }}>{title}</div>
+        <div style={{ fontSize: 12, opacity: 0.85 }}>{subtitle}</div>
+      </div>
+
+      <div style={{ flex: 1, overflowY: 'auto', padding: 16, display: 'flex', flexDirection: 'column', gap: 8 }}>
+        {state.messages.map(msg => (
+          <div key={msg.id} style={{ display: 'flex', flexDirection: 'column', alignItems: msg.role === 'user' ? 'flex-end' : 'flex-start' }}>
+            <div style={bubble(msg.role === 'user')}>
+              {msg.subquestions && msg.subquestions.length > 0 ? (
+                <>
+                  {msg.isFollowUp && <div style={{ marginBottom: 8 }}><MarkdownText text={msg.text} /></div>}
+                  {msg.subquestions.map((sub: Question) => (
+                    <button key={sub.id} onClick={() => chat.clickSub(sub, msg.subquestions!)} style={{
+                      display: 'block', width: '100%', textAlign: 'left',
+                      padding: '7px 10px', margin: '4px 0', borderRadius: 8,
+                      border: `1px solid ${theme.primaryColor}`, background: '#fff',
+                      color: theme.primaryColor, cursor: 'pointer', fontSize: 13,
+                    }}>
+                      {sub.question}
+                    </button>
+                  ))}
+                  <button onClick={() => chat.backToMain()} style={{
+                    display: 'block', width: '100%', textAlign: 'left',
+                    padding: '7px 10px', margin: '4px 0', borderRadius: 8,
+                    border: '1px solid #6B7280', background: '#fff',
+                    color: '#6B7280', cursor: 'pointer', fontSize: 13,
+                  }}>
+                    ← Back to main menu
+                  </button>
+                </>
+              ) : msg.role === 'bot' ? <MarkdownText text={msg.text} /> : msg.text}
+            </div>
+          </div>
+        ))}
+
+        {state.loading && (
+          <div style={{ alignSelf: 'flex-start', background: theme.botBubbleColor, padding: '10px 16px', borderRadius: 12, fontSize: 14 }}>
+            <ThinkingDots color={theme.primaryColor} />
+          </div>
+        )}
+
+        {state.showMain && state.questions.length > 0 && (
+          <div style={{ display: 'flex', flexDirection: 'column', gap: 4, marginTop: 4 }}>
+            {state.questions.map((q: Question) => (
+              <button key={q.id} onClick={() => chat.clickMain(q)} style={{
+                textAlign: 'left', padding: '8px 12px', borderRadius: 8,
+                border: `1px solid ${theme.primaryColor}`, background: 'transparent',
+                color: theme.primaryColor, cursor: 'pointer', fontSize: 14,
+              }}>
+                {q.question}
+              </button>
+            ))}
+          </div>
+        )}
+
+        <div ref={bottomRef} />
+      </div>
+
+      <form onSubmit={e => { e.preventDefault(); chat.submitQuery() }} style={{ display: 'flex', borderTop: '1px solid #e5e7eb', padding: 12, gap: 8 }}>
+        <input
+          value={state.input}
+          onChange={e => chat.setInput(e.target.value)}
+          placeholder="Type a message..."
+          disabled={state.loading}
+          style={{ flex: 1, padding: '8px 12px', borderRadius: 8, border: '1px solid #e5e7eb', fontSize: 14, outline: 'none' }}
+        />
+        <button type="submit" disabled={state.loading} style={{
+          background: theme.primaryColor, color: '#fff', border: 'none',
+          borderRadius: 8, padding: '8px 16px',
+          cursor: state.loading ? 'not-allowed' : 'pointer', fontSize: 14,
+        }}>
+          Send
+        </button>
+      </form>
+    </div>
+  )
+}

package/package/src/client.ts

@@ -0,0 +1,2 @@
+export { ChatWidget } from './client/ChatWidget'
+export type { ChatWidgetProps } from './client/ChatWidget'

package/package/src/core/RushChatbot.ts

@@ -0,0 +1,192 @@
+import { marked } from 'marked'
+import type { Message, Question, WidgetSettings } from '../shared/types'
+
+marked.setOptions({ breaks: true })
+
+export interface RushChatbotConfig {
+  apiBase?: string
+  settings?: WidgetSettings
+}
+
+export interface RushChatbotState {
+  messages: Message[]
+  questions: Question[]
+  input: string
+  loading: boolean
+  showMain: boolean
+  config: { branding: any; chat: any } | null
+  settings: WidgetSettings
+}
+
+type Listener = (state: RushChatbotState) => void
+
+function generateSessionId(): string {
+  return 'sess_' + Date.now().toString(36) + '_' + Math.random().toString(36).slice(2, 8)
+}
+
+function getSessionId(): string {
+  let id = sessionStorage.getItem('rushchatbot_session')
+  if (!id) { id = generateSessionId(); sessionStorage.setItem('rushchatbot_session', id) }
+  return id
+}
+
+export function parseMarkdown(text: string): string {
+  return marked.parse(text) as string
+}
+
+export type { WidgetSettings } from '../shared/types'
+
+export class RushChatbot {
+  private base: string
+  private listeners: Listener[] = []
+  private state: RushChatbotState = {
+    messages: [],
+    questions: [],
+    input: '',
+    loading: false,
+    showMain: true,
+    config: null,
+    settings: {},
+  }
+
+  constructor(options: RushChatbotConfig = {}) {
+    this.base = options.apiBase ?? 'http://localhost:3001/api/chat'
+    if (options.settings) this.state.settings = options.settings
+  }
+
+  getState(): RushChatbotState {
+    return { ...this.state }
+  }
+
+  subscribe(listener: Listener): () => void {
+    this.listeners.push(listener)
+    return () => { this.listeners = this.listeners.filter(l => l !== listener) }
+  }
+
+  private setState(patch: Partial<RushChatbotState>) {
+    this.state = { ...this.state, ...patch }
+    this.listeners.forEach(l => l(this.getState()))
+  }
+
+  private addMessage(msg: Omit<Message, 'id'>) {
+    const messages = [...this.state.messages, { ...msg, id: Date.now().toString() + Math.random() }]
+    this.setState({ messages })
+  }
+
+  private async think(ms = 1000) {
+    this.setState({ loading: true })
+    await new Promise(r => setTimeout(r, ms))
+    this.setState({ loading: false })
+  }
+
+  private followUp(): string {
+    const phrases = [
+      'Is there anything else I can help you with today? 😊',
+      'Happy to help further! What else would you like to know?',
+      'I hope that was helpful! Feel free to ask anything else.',
+      "You're in good hands! Is there something else on your mind?",
+      "I'm here for you — what else can I assist you with?",
+    ]
+    return phrases[Math.floor(Math.random() * phrases.length)]
+  }
+
+  async init() {
+    const [cfg, qs] = await Promise.all([
+      fetch(`${this.base}/config`).then(r => r.json()),
+      fetch(`${this.base}/questions`).then(r => r.json()),
+    ])
+    this.setState({
+      config: cfg,
+      questions: qs,
+      messages: [{ id: '0', role: 'bot', text: cfg.chat.welcomeMessage }],
+      showMain: cfg.chat.showPreQuestionsOnStart ?? true,
+    })
+  }
+
+  setInput(value: string) {
+    this.setState({ input: value })
+  }
+
+  async clickMain(q: Question) {
+    this.setState({ showMain: false })
+    this.addMessage({ role: 'user', text: q.question })
+    await fetch(`${this.base}/click`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'x-session-id': getSessionId() },
+      body: JSON.stringify({ questionId: q.id, sessionId: getSessionId() }),
+    })
+    await this.think()
+    if (q.subquestions?.length > 0) {
+      this.addMessage({ role: 'bot', text: `Here are some topics under **${q.question}**:`, source: 'config', subquestions: q.subquestions })
+    } else {
+      this.addMessage({ role: 'bot', text: q.answer, source: 'config' })
+    }
+  }
+
+  async clickSub(q: Question, siblings: Question[]) {
+    this.addMessage({ role: 'user', text: q.question })
+    await fetch(`${this.base}/click`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', 'x-session-id': getSessionId() },
+      body: JSON.stringify({ questionId: q.id, sessionId: getSessionId() }),
+    })
+    await this.think()
+    this.addMessage({ role: 'bot', text: q.answer, source: 'config' })
+    await this.think(800)
+    this.addMessage({ role: 'bot', text: 'Would you have another inquiry?', subquestions: siblings, isFollowUp: true })
+  }
+
+  async backToMain() {
+    this.setState({ showMain: false })
+    this.addMessage({ role: 'bot', text: "Here's what I can help you with — feel free to pick a topic or type your own question! 😊" })
+    await this.think(800)
+    this.setState({ showMain: true })
+  }
+
+  endChat() {
+    this.setState({ showMain: false })
+    this.addMessage({ role: 'bot', text: 'Thank you for chatting with us! Have a wonderful day. Feel free to come back anytime you need help. 👋😊', isEndChat: true })
+  }
+
+  async startNewChat() {
+    const welcome = this.state.config?.chat.welcomeMessage ?? ''
+    this.setState({ messages: [{ id: '0', role: 'bot', text: welcome }], showMain: false })
+    await this.think(400)
+    this.setState({ showMain: true })
+  }
+
+  async submitQuery() {
+    const query = this.state.input.trim()
+    if (!query) return
+    this.setState({ input: '', showMain: false })
+    this.addMessage({ role: 'user', text: query })
+    this.setState({ loading: true })
+
+    try {
+      const sid = getSessionId()
+      const res = await fetch(`${this.base}/query?query=${encodeURIComponent(query)}&sessionId=${sid}`, {
+        headers: { 'x-session-id': sid },
+      }).then(r => r.json())
+
+      this.setState({ loading: false })
+
+      if (res.paragraphs?.length > 0) {
+        for (const p of res.paragraphs) {
+          this.addMessage({ role: 'bot', text: p, source: res.source })
+          await this.think(400)
+        }
+      } else {
+        this.addMessage({ role: 'bot', text: res.answer, source: res.source })
+      }
+    } catch {
+      this.setState({ loading: false })
+      this.addMessage({ role: 'bot', text: "Oops! It seems like I ran into a little hiccup. 😅 Please try again in a moment, or feel free to explore the topics below — I'm happy to help!", isFollowUp: true, subquestions: [] })
+      this.setState({ showMain: true })
+      return
+    }
+
+    await this.think(800)
+    this.addMessage({ role: 'bot', text: this.followUp(), isFollowUp: true, subquestions: [] })
+    this.setState({ showMain: true })
+  }
+}

package/package/src/index.ts

@@ -0,0 +1,5 @@
+export { createServer } from './server/index'
+export type { RushChatbotServerOptions } from './server/index'
+export type { ChatbotConfig, Question, Message } from './shared/types'
+export { RushChatbot, parseMarkdown } from './core/RushChatbot'
+export type { RushChatbotConfig, RushChatbotState } from './core/RushChatbot'

package/package/src/server/guardrails.ts

@@ -0,0 +1,107 @@
+import { Filter } from 'bad-words'
+
+const filter = new Filter()
+
+// Additional rude/aggressive phrases beyond profanity
+const RUDE_PATTERNS = [
+  /\bstupid\b/i,
+  /\bidiot\b/i,
+  /\bmoron\b/i,
+  /\bdumb\b/i,
+  /\buseless\b/i,
+  /\bworthless\b/i,
+  /\bterrible\b/i,
+  /\bawful\b/i,
+  /\bhate\s+you\b/i,
+  /\bshut\s+up\b/i,
+  /\bgo\s+away\b/i,
+  /\byou\s+suck\b/i,
+  /\bwaste\s+of\s+time\b/i,
+  /\bscam\b/i,
+  /\bfraud\b/i,
+]
+
+const GUARDRAIL_RESPONSES = [
+  "We truly value your time and want to make sure we're helping you in the best way possible. Let's keep our conversation respectful so we can assist you better. 😊 How can we help you today?",
+  "We understand that things can be frustrating sometimes, and we're here to help! Let's work together to find the answers you need. What can we assist you with?",
+  "Your experience matters to us, and we want to make sure you get the best support possible. Let's start fresh — what would you like to know?",
+  "We're committed to providing you with a positive and helpful experience. Let's keep things friendly so we can serve you better! What can we help you with today?",
+  "We're here to help and we want to make this a great experience for you! Let's take a step back and see how we can best assist you. 😊",
+]
+
+const INVALID_INPUT_RESPONSES = [
+  "Hmm, it seems like that message didn't quite come through. Could you rephrase your question? We'd love to help! 😊",
+  "We want to make sure we understand you correctly! Could you try asking your question in a different way?",
+  "It looks like we didn't catch that. Could you provide a bit more detail so we can assist you better?",
+  "We're here to help, but we need a little more to go on! Could you try rephrasing that for us?",
+]
+
+// Minimum valid word length and count
+const MIN_WORD_LENGTH = 2
+const MIN_VALID_WORDS = 1
+const MAX_INPUT_LENGTH = 500
+
+// Detect if input is gibberish — too many consecutive consonants or random chars
+function isGibberish(word: string): boolean {
+  if (word.length < 2) return false
+  const consonantRun = /[bcdfghjklmnpqrstvwxyz]{5,}/i
+  const randomChars = /[^a-z0-9\s]{3,}/i
+  const repeatingChars = /(.)\1{4,}/i
+  return consonantRun.test(word) || randomChars.test(word) || repeatingChars.test(word)
+}
+
+export interface ValidationResult {
+  valid: boolean
+  response?: string
+}
+
+export function validateInput(text: string): ValidationResult {
+  const trimmed = text.trim()
+
+  // Empty or too short
+  if (!trimmed || trimmed.length < MIN_WORD_LENGTH) {
+    return { valid: false, response: "Please type a message so we can assist you! 😊" }
+  }
+
+  // Too long
+  if (trimmed.length > MAX_INPUT_LENGTH) {
+    return { valid: false, response: "Your message is a bit too long. Could you summarize your question so we can help you better?" }
+  }
+
+  // Only numbers or special characters
+  if (/^[^a-zA-Z]+$/.test(trimmed)) {
+    return { valid: false, response: INVALID_INPUT_RESPONSES[Math.floor(Math.random() * INVALID_INPUT_RESPONSES.length)] }
+  }
+
+  // Check for gibberish words
+  const words = trimmed.split(/\s+/).filter(w => w.length >= MIN_WORD_LENGTH)
+  const gibberishWords = words.filter(isGibberish)
+  if (words.length > 0 && gibberishWords.length / words.length > 0.6) {
+    return { valid: false, response: INVALID_INPUT_RESPONSES[Math.floor(Math.random() * INVALID_INPUT_RESPONSES.length)] }
+  }
+
+  // Not enough valid words
+  const validWords = words.filter(w => /[a-zA-Z]/.test(w))
+  if (validWords.length < MIN_VALID_WORDS) {
+    return { valid: false, response: INVALID_INPUT_RESPONSES[Math.floor(Math.random() * INVALID_INPUT_RESPONSES.length)] }
+  }
+
+  return { valid: true }
+}
+
+export interface GuardrailResult {
+  flagged: boolean
+  response?: string
+}
+
+export function checkGuardrails(text: string): GuardrailResult {
+  const hasProfanity = filter.isProfane(text)
+  const hasRudeness = RUDE_PATTERNS.some(pattern => pattern.test(text))
+
+  if (hasProfanity || hasRudeness) {
+    const response = GUARDRAIL_RESPONSES[Math.floor(Math.random() * GUARDRAIL_RESPONSES.length)]
+    return { flagged: true, response }
+  }
+
+  return { flagged: false }
+}