neuron-mcp-server 1.0.0 → 1.1.0

package/scripts/setup-delivahere-bot.ts

@@ -0,0 +1,804 @@
+#!/usr/bin/env tsx
+/**
+ * Demo script: Sets up a complete DelivaHere delivery bot using the Neuron API.
+ *
+ * This script demonstrates how the MCP server's tools would be used to:
+ * 1. Login to the Neuron platform
+ * 2. Create a delivery-focused bot
+ * 3. Create a knowledge base with comprehensive delivery platform docs
+ * 4. Attach the knowledge base to the bot
+ * 5. Create an HTTP tool for the DelivaHere application server
+ * 6. Generate an API key for programmatic access
+ *
+ * Usage:
+ *   NEURON_EMAIL=admin@example.com NEURON_PASSWORD=secret tsx scripts/setup-delivahere-bot.ts
+ */
+
+import axios from "axios";
+
+const API = process.env.NEURON_API_URL || "http://localhost:4000/api/v1";
+const EMAIL = process.env.NEURON_EMAIL || "a.rasheedalabi@gmail.com";
+const PASSWORD = process.env.NEURON_PASSWORD || "12345678";
+
+let token = "";
+
+async function api(method: string, path: string, data?: unknown) {
+  const res = await axios({
+    method,
+    url: `${API}/${path}`,
+    data,
+    headers: {
+      "Content-Type": "application/json",
+      ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    },
+  });
+  return res.data;
+}
+
+async function main() {
+  console.log("=== DelivaHere Bot Setup ===\n");
+
+  // --- Step 1: Login ---
+  console.log("1. Logging in...");
+  const auth = await api("POST", "auth/login", {
+    email: EMAIL,
+    password: PASSWORD,
+  });
+  token = auth.data.accessToken;
+  console.log(`   Logged in as ${EMAIL}\n`);
+
+  // --- Step 2: Create the bot ---
+  console.log("2. Creating DelivaHere bot...");
+  const bot = await api("POST", "bots", {
+    name: "DelivaHere Assistant",
+    systemPrompt: SYSTEM_PROMPT,
+    model: "anthropic/claude-sonnet-4.5",
+    temperature: 0.4,
+    maxTokens: 2048,
+  });
+  const botId = bot.data.id;
+  console.log(`   Bot created: ${botId}\n`);
+
+  // --- Step 3: Create knowledge base ---
+  console.log("3. Creating knowledge base...");
+  const kb = await api("POST", "knowledge-bases", {
+    name: "DelivaHere Platform Knowledge",
+    description:
+      "Comprehensive knowledge base for the DelivaHere peer-to-peer delivery platform",
+    rootInstruction:
+      "You are the DelivaHere delivery assistant. Use this knowledge base to answer questions about the platform, process delivery requests, provide tracking updates, and help customers with their deliveries. Always be helpful, concise, and proactive about gathering delivery details.",
+  });
+  const kbId = kb.data.id;
+  console.log(`   Knowledge base created: ${kbId}\n`);
+
+  // --- Step 4: Add knowledge base entries ---
+  console.log("4. Adding knowledge base entries...");
+  for (const entry of KNOWLEDGE_ENTRIES) {
+    await api("POST", `knowledge-bases/${kbId}/entries`, entry);
+    console.log(`   Added: ${entry.title}`);
+  }
+  console.log();
+
+  // --- Step 5: Attach KB to bot ---
+  console.log("5. Attaching knowledge base to bot...");
+  await api("POST", `bots/${botId}/knowledge-bases`, {
+    knowledgeBaseId: kbId,
+    priority: 10,
+  });
+  console.log("   Attached.\n");
+
+  // --- Step 6: Create delivery request tool ---
+  console.log("6. Creating DelivaHere API tool...");
+  const tool = await api("POST", `tools/bot/${botId}`, {
+    name: "create_delivery_request",
+    description:
+      "Creates a new delivery request on the DelivaHere platform. Call this when a customer wants to send a package. Returns a request ID, estimated pricing, and status.",
+    type: "http",
+    config: {
+      url: "https://api.delivahere.com/v1/delivery-requests",
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: "Bearer {{DELIVAHERE_API_KEY}}",
+      },
+      bodyTemplate: JSON.stringify({
+        sender_phone: "{{senderPhone}}",
+        sender_name: "{{senderName}}",
+        pickup_address: "{{pickupAddress}}",
+        dropoff_address: "{{dropoffAddress}}",
+        package_description: "{{packageDescription}}",
+        package_weight_kg: "{{packageWeight}}",
+        package_size: "{{packageSize}}",
+        delivery_type: "{{deliveryType}}",
+        preferred_pickup_time: "{{preferredPickupTime}}",
+        preferred_delivery_time: "{{preferredDeliveryTime}}",
+        special_instructions: "{{specialInstructions}}",
+      }),
+      responseMapping: {
+        requestId: "$.data.id",
+        status: "$.data.status",
+        estimatedPrice: "$.data.estimated_price",
+        estimatedDelivery: "$.data.estimated_delivery",
+      },
+    },
+    authType: "bearer",
+    rateLimit: 30,
+    timeoutMs: 15000,
+  });
+  console.log(`   Tool created: ${tool.data.id}\n`);
+
+  // Create tracking tool
+  console.log("   Creating tracking tool...");
+  await api("POST", `tools/bot/${botId}`, {
+    name: "track_delivery",
+    description:
+      "Tracks the status of an existing delivery request. Returns current status, location, and ETA.",
+    type: "http",
+    config: {
+      url: "https://api.delivahere.com/v1/delivery-requests/{{requestId}}/track",
+      method: "GET",
+      headers: {
+        Authorization: "Bearer {{DELIVAHERE_API_KEY}}",
+      },
+      responseMapping: {
+        status: "$.data.status",
+        currentLocation: "$.data.current_location",
+        eta: "$.data.eta",
+        partnerName: "$.data.partner_agent.name",
+        partnerPhone: "$.data.partner_agent.phone",
+      },
+    },
+    authType: "bearer",
+    rateLimit: 60,
+    timeoutMs: 10000,
+  });
+  console.log("   Tracking tool created.\n");
+
+  // Create bid listing tool
+  console.log("   Creating bid listing tool...");
+  await api("POST", `tools/bot/${botId}`, {
+    name: "list_delivery_bids",
+    description:
+      "Lists all bids from delivery partner agents for a given delivery request. Returns bid amounts, estimated delivery times, and partner ratings.",
+    type: "http",
+    config: {
+      url: "https://api.delivahere.com/v1/delivery-requests/{{requestId}}/bids",
+      method: "GET",
+      headers: {
+        Authorization: "Bearer {{DELIVAHERE_API_KEY}}",
+      },
+      responseMapping: {
+        bids: "$.data.bids",
+        bidCount: "$.data.total",
+      },
+    },
+    authType: "bearer",
+    rateLimit: 60,
+    timeoutMs: 10000,
+  });
+  console.log("   Bid listing tool created.\n");
+
+  // Create bid acceptance tool
+  console.log("   Creating bid acceptance tool...");
+  await api("POST", `tools/bot/${botId}`, {
+    name: "accept_delivery_bid",
+    description:
+      "Accepts a specific bid from a delivery partner agent. This confirms the delivery and initiates the pickup process.",
+    type: "http",
+    config: {
+      url: "https://api.delivahere.com/v1/delivery-requests/{{requestId}}/bids/{{bidId}}/accept",
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: "Bearer {{DELIVAHERE_API_KEY}}",
+      },
+      responseMapping: {
+        status: "$.data.status",
+        partnerAgent: "$.data.partner_agent",
+        pickupTime: "$.data.pickup_time",
+        estimatedDelivery: "$.data.estimated_delivery",
+      },
+    },
+    authType: "bearer",
+    rateLimit: 10,
+    timeoutMs: 15000,
+  });
+  console.log("   Bid acceptance tool created.\n");
+
+  // --- Step 7: Create API key ---
+  console.log("7. Creating API key for programmatic access...");
+  const apiKey = await api("POST", `bots/${botId}/api-keys`, {
+    name: "DelivaHere WhatsApp Integration",
+  });
+  console.log(`   API Key: ${apiKey.data.plaintext}`);
+  console.log(`   (Save this key — it won't be shown again)\n`);
+
+  // --- Summary ---
+  console.log("=== Setup Complete ===");
+  console.log(`Bot ID:           ${botId}`);
+  console.log(`Knowledge Base ID: ${kbId}`);
+  console.log(`API Key:          ${apiKey.data.plaintext}`);
+  console.log(`\nTest with:`);
+  console.log(`  curl -X POST ${API}/bot-api/chat \\`);
+  console.log(`    -H "Authorization: Bearer ${apiKey.data.plaintext}" \\`);
+  console.log(`    -H "Content-Type: application/json" \\`);
+  console.log(
+    `    -d '{"message":"I want to send a package from Lagos to Abuja","contactPhone":"+2348012345678"}'`,
+  );
+}
+
+// ---------------------------------------------------------------------------
+// System Prompt
+// ---------------------------------------------------------------------------
+
+const SYSTEM_PROMPT = `You are the DelivaHere Delivery Assistant — a friendly, efficient AI that helps customers send packages through the DelivaHere peer-to-peer delivery platform.
+
+## Your Role
+- Help customers create delivery requests by gathering required information
+- Provide tracking updates on existing deliveries
+- Present delivery bids from partner agents and help customers choose
+- Answer questions about the platform, pricing, and policies
+- Escalate complex issues to human support when needed
+
+## Conversation Flow for New Deliveries
+1. Greet the customer warmly
+2. Ask what they need (send a package, track, get help)
+3. For new deliveries, gather ALL required fields before creating the request:
+   - Pickup address (full address)
+   - Drop-off address (full address)
+   - Package description (what's being sent)
+   - Package weight (in kg, approximate is fine)
+   - Package size (small/medium/large/extra-large)
+   - Delivery type (local/inter-state/international)
+   - Preferred pickup time
+   - Preferred delivery time
+   - Any special instructions
+4. Confirm the details with the customer
+5. Create the delivery request using the create_delivery_request tool
+6. Share the request ID and estimated pricing
+7. When bids come in, present them clearly and help the customer choose
+
+## Communication Style
+- Be warm, professional, and concise
+- Use simple language — avoid jargon
+- Confirm details before taking action
+- If unsure, ask rather than assume
+- For pricing questions, always say "estimated" — final price depends on partner bids
+- Use the customer's name if available
+
+## Package Size Guide
+- Small: Fits in a shoebox (< 5kg)
+- Medium: Fits in a carry-on bag (5-15kg)
+- Large: Needs both arms to carry (15-30kg)
+- Extra-large: May need two people or a vehicle (30kg+)
+
+## Delivery Types
+- Local: Same city, usually same-day or next-day
+- Inter-state: Different states, 1-3 days
+- International: Different countries, 3-14 days depending on destination
+
+## Important Rules
+- NEVER share another customer's information
+- NEVER make up tracking numbers or delivery statuses — always use the tools
+- If a tool call fails, apologize and suggest the customer try again or contact support
+- For complaints or refund requests, collect details and escalate to human support
+- Always provide the delivery request ID after creating one`;
+
+// ---------------------------------------------------------------------------
+// Knowledge Base Entries
+// ---------------------------------------------------------------------------
+
+const KNOWLEDGE_ENTRIES = [
+  {
+    title: "DelivaHere Platform Overview",
+    content: `DelivaHere is a peer-to-peer delivery platform that connects senders with delivery partner agents. Unlike traditional courier services, DelivaHere uses a bidding system where multiple delivery partners can bid on a delivery request, and the sender chooses the best offer.
+
+The platform serves three user types:
+1. **Senders** — People or businesses that need packages delivered
+2. **Delivery Partner Agents** — Individuals who earn money by delivering packages during their commutes and travels
+3. **Package Processing Centers** — Physical locations that serve as intermediary drop-off/pick-up points for inter-state and international deliveries
+
+DelivaHere supports local, inter-state, and international deliveries across Africa and beyond.`,
+    folder: "general",
+  },
+  {
+    title: "How Delivery Requests Work",
+    content: `## Creating a Delivery Request
+
+When a sender wants to send a package, the following information is required:
+- **Pickup address**: Full address where the package will be collected
+- **Drop-off address**: Full address where the package should be delivered
+- **Package description**: What is being sent (for safety and customs if international)
+- **Package weight**: Approximate weight in kilograms
+- **Package size**: small (< 5kg, shoebox), medium (5-15kg, carry-on), large (15-30kg), extra-large (30kg+)
+- **Delivery type**: local (same city), inter-state (different states), international
+- **Preferred pickup time**: When the sender wants the package picked up
+- **Preferred delivery time**: When the package should arrive
+- **Special instructions**: Fragile handling, temperature sensitivity, etc.
+
+## The Bidding Process
+
+After a delivery request is created:
+1. Partner agents in the area are notified
+2. Interested agents submit bids with their price and estimated delivery time
+3. The sender receives all bids and can compare price, delivery time, and agent ratings
+4. The sender accepts a bid, confirming the delivery
+5. The partner agent picks up the package at the agreed time
+
+## Delivery Statuses
+- **pending** — Request created, waiting for bids
+- **bidding** — Bids are being received from partner agents
+- **accepted** — A bid has been accepted, partner assigned
+- **pickup_scheduled** — Partner is en route to pick up
+- **picked_up** — Package has been collected
+- **in_transit** — Package is on its way
+- **at_processing_center** — Package is at an intermediary center (inter-state/international)
+- **out_for_delivery** — Final leg, partner heading to drop-off
+- **delivered** — Successfully delivered
+- **cancelled** — Request was cancelled
+- **failed** — Delivery attempt failed`,
+    folder: "general",
+  },
+  {
+    title: "Pricing and Payment",
+    content: `## How Pricing Works
+
+DelivaHere uses a market-driven bidding system:
+- There is NO fixed price list — prices are determined by partner agent bids
+- Factors that influence bid amounts:
+  - Distance between pickup and drop-off
+  - Package weight and size
+  - Delivery urgency (same-day costs more)
+  - Route popularity (common routes may be cheaper)
+  - Time of day and demand
+
+## Estimated Pricing Ranges (for reference only)
+
+Local deliveries (same city):
+- Small package: NGN 1,000 - 3,000
+- Medium package: NGN 2,000 - 5,000
+- Large package: NGN 3,500 - 8,000
+
+Inter-state deliveries:
+- Small package: NGN 3,000 - 8,000
+- Medium package: NGN 5,000 - 15,000
+- Large package: NGN 8,000 - 25,000
+
+International deliveries: Varies significantly by destination. Typically NGN 15,000+
+
+## Payment
+- Payment is held in escrow when a bid is accepted
+- The partner agent is paid after successful delivery
+- If delivery fails, the sender receives a full refund
+- Accepted payment methods: Bank transfer, card, mobile money, USSD`,
+    folder: "general",
+  },
+  {
+    title: "Delivery Partner Agents",
+    content: `## Who Are Delivery Partner Agents?
+
+Delivery partner agents are individuals who earn extra income by delivering packages during their daily commutes and travels. They are NOT traditional couriers — they are everyday people going about their day who can carry a package along the way.
+
+## How Partners Earn
+- Partners browse available delivery requests in their area or along their route
+- They submit bids with their price and estimated delivery time
+- If a sender accepts their bid, they pick up and deliver the package
+- Payment is released to their wallet after confirmed delivery
+
+## Partner Ratings
+- Partners are rated 1-5 stars by senders after each delivery
+- Rating factors: timeliness, package condition, communication, professionalism
+- Higher-rated partners tend to get more accepted bids
+
+## Partner Requirements
+- Valid government-issued ID
+- Smartphone with the DelivaHere app
+- Bank account for receiving payments
+- Clean record (background check required)
+
+## Important for the Bot
+When presenting bids to senders, always show:
+- Partner name and rating (stars)
+- Number of completed deliveries
+- Bid amount
+- Estimated pickup and delivery time
+- Any special notes from the partner`,
+    folder: "general",
+  },
+  {
+    title: "Package Processing Centers",
+    content: `## What Are Processing Centers?
+
+Package Processing Centers (PPCs) are authorized physical locations that serve as intermediary points for inter-state and international deliveries. They are typically existing businesses (shops, offices, logistics hubs) that have partnered with DelivaHere.
+
+## How PPCs Work
+
+For inter-state and international deliveries:
+1. Sender's local partner agent picks up the package
+2. Partner delivers it to the nearest PPC
+3. PPC inspects and logs the package
+4. A long-haul partner picks it up for the inter-state/international leg
+5. Package arrives at the destination PPC
+6. A local partner in the destination city delivers to the final address
+
+## Benefits
+- Pre-inspection of packages for safety
+- Flexible pickup/drop-off hours for senders and partners
+- Neutral handover locations
+- Proper documentation for customs (international)
+- Package insurance options
+
+## PPC Services
+- Package receiving and temporary storage
+- Package inspection and documentation
+- Customs paperwork (international shipments)
+- Insurance options
+- Real-time status updates to sender`,
+    folder: "general",
+  },
+  {
+    title: "API Integration — Creating Delivery Requests",
+    content: `## DelivaHere API — Create Delivery Request
+
+Endpoint: POST https://api.delivahere.com/v1/delivery-requests
+Auth: Bearer token (DELIVAHERE_API_KEY)
+
+### Request Body
+{
+  "sender_phone": "+2348012345678",
+  "sender_name": "John Doe",
+  "pickup_address": "15 Allen Avenue, Ikeja, Lagos",
+  "dropoff_address": "23 Wuse Zone 5, Abuja",
+  "package_description": "Electronics - Laptop computer",
+  "package_weight_kg": 3.5,
+  "package_size": "small",
+  "delivery_type": "inter-state",
+  "preferred_pickup_time": "2025-03-15T10:00:00Z",
+  "preferred_delivery_time": "2025-03-17T18:00:00Z",
+  "special_instructions": "Fragile - handle with care. Keep upright."
+}
+
+### Response (Success)
+{
+  "success": true,
+  "data": {
+    "id": "del_abc123",
+    "status": "pending",
+    "estimated_price": { "min": 4500, "max": 8000, "currency": "NGN" },
+    "estimated_delivery": "2025-03-17T15:00:00Z",
+    "created_at": "2025-03-14T12:00:00Z"
+  }
+}
+
+### After Creation
+The bot should:
+1. Tell the customer their request ID (e.g., del_abc123)
+2. Share the estimated price range
+3. Explain that partner agents will now submit bids
+4. Let them know they'll be notified when bids come in
+5. Ask if they have any questions`,
+    folder: "skills",
+  },
+  {
+    title: "API Integration — Tracking and Bids",
+    content: `## Track Delivery
+
+Endpoint: GET https://api.delivahere.com/v1/delivery-requests/{requestId}/track
+Auth: Bearer token
+
+### Response
+{
+  "success": true,
+  "data": {
+    "status": "in_transit",
+    "current_location": "Along Lagos-Ibadan Expressway",
+    "eta": "2025-03-17T14:30:00Z",
+    "partner_agent": {
+      "name": "Adebayo O.",
+      "phone": "+234801XXXXXXX",
+      "rating": 4.8,
+      "completed_deliveries": 156
+    },
+    "timeline": [
+      { "event": "created", "timestamp": "2025-03-14T12:00:00Z" },
+      { "event": "bid_accepted", "timestamp": "2025-03-14T14:00:00Z" },
+      { "event": "picked_up", "timestamp": "2025-03-15T10:30:00Z" },
+      { "event": "in_transit", "timestamp": "2025-03-15T11:00:00Z" }
+    ]
+  }
+}
+
+## List Bids
+
+Endpoint: GET https://api.delivahere.com/v1/delivery-requests/{requestId}/bids
+
+### Response
+{
+  "success": true,
+  "data": {
+    "total": 3,
+    "bids": [
+      {
+        "id": "bid_001",
+        "partner_name": "Adebayo O.",
+        "partner_rating": 4.8,
+        "completed_deliveries": 156,
+        "amount": 5500,
+        "currency": "NGN",
+        "estimated_pickup": "2025-03-15T10:00:00Z",
+        "estimated_delivery": "2025-03-17T14:00:00Z",
+        "note": "I travel this route weekly. Will handle with care."
+      },
+      {
+        "id": "bid_002",
+        "partner_name": "Chioma E.",
+        "partner_rating": 4.5,
+        "completed_deliveries": 89,
+        "amount": 4800,
+        "currency": "NGN",
+        "estimated_pickup": "2025-03-15T09:00:00Z",
+        "estimated_delivery": "2025-03-17T16:00:00Z",
+        "note": "Heading to Abuja tomorrow morning."
+      }
+    ]
+  }
+}
+
+## Accept Bid
+
+Endpoint: POST https://api.delivahere.com/v1/delivery-requests/{requestId}/bids/{bidId}/accept
+
+### Response
+{
+  "success": true,
+  "data": {
+    "status": "accepted",
+    "partner_agent": { "name": "Adebayo O.", "phone": "+234801XXXXXXX" },
+    "pickup_time": "2025-03-15T10:00:00Z",
+    "estimated_delivery": "2025-03-17T14:00:00Z",
+    "payment_held": 5500
+  }
+}
+
+## How the Bot Presents Bids
+When bids come in, present them like this:
+"You have 3 bids for your delivery (del_abc123):
+
+1. Adebayo O. (4.8 stars, 156 deliveries) — NGN 5,500
+   Pickup: Mar 15 at 10am | Delivery: Mar 17 by 2pm
+   Note: 'I travel this route weekly. Will handle with care.'
+
+2. Chioma E. (4.5 stars, 89 deliveries) — NGN 4,800
+   Pickup: Mar 15 at 9am | Delivery: Mar 17 by 4pm
+   Note: 'Heading to Abuja tomorrow morning.'
+
+Which bid would you like to accept?"`,
+    folder: "skills",
+  },
+  {
+    title: "Customer Communication Templates",
+    content: `## Welcome Message
+"Hello! Welcome to DelivaHere. I'm your delivery assistant. I can help you:
+- Send a package anywhere in Nigeria or internationally
+- Track an existing delivery
+- View and accept bids from delivery partners
+
+What would you like to do today?"
+
+## Gathering Delivery Details
+"Great, let's get your package on its way! I'll need a few details:
+
+1. Where should we pick up the package? (Full address)
+2. Where is it going? (Full address)
+3. What are you sending? (Brief description)
+4. About how heavy is it? (kg)
+5. Is it small (shoebox), medium (carry-on bag), large (needs two arms), or extra-large?
+
+Feel free to share all details at once, or I'll ask one at a time."
+
+## Confirming Details
+"Here's a summary of your delivery request:
+- From: {pickup_address}
+- To: {dropoff_address}
+- Package: {description} ({weight}kg, {size})
+- Type: {delivery_type}
+- Pickup: {pickup_time}
+- Delivery by: {delivery_time}
+- Instructions: {special_instructions}
+
+Shall I go ahead and create this request?"
+
+## Request Created
+"Your delivery request has been created!
+- Request ID: {requestId}
+- Estimated price range: NGN {min} - {max}
+- Delivery partners in the area will now submit their bids.
+
+I'll let you know as soon as bids come in. Is there anything else you need?"
+
+## Tracking Update
+"Here's the latest on your delivery ({requestId}):
+- Status: {status}
+- Location: {current_location}
+- ETA: {eta}
+- Partner: {partner_name} ({partner_rating} stars)
+
+Need anything else?"
+
+## Error / Fallback
+"I'm sorry, I wasn't able to {action} at the moment. This could be a temporary issue. You can:
+- Try again in a few minutes
+- Contact our support team at support@delivahere.com
+- Call us at +234-800-DELIVA
+
+I apologize for the inconvenience."`,
+    folder: "contexts",
+  },
+  {
+    title: "Prohibited Items and Safety Policies",
+    content: `## Prohibited Items
+The following items CANNOT be sent via DelivaHere:
+- Illegal drugs or controlled substances
+- Weapons, firearms, or ammunition
+- Explosives or flammable materials
+- Hazardous chemicals or biological materials
+- Live animals
+- Human remains
+- Counterfeit goods
+- Stolen property
+- Cash or currency exceeding NGN 500,000 equivalent
+
+## Restricted Items (Require Special Handling)
+These items CAN be sent but require declaration:
+- Electronics (must be described accurately)
+- Fragile items (must be marked, special packaging recommended)
+- Perishable food (only for local/same-day delivery)
+- Medication (must be legal and properly labeled)
+- Documents (legal/official documents should use insured delivery)
+- Jewelry or valuables (insurance recommended)
+
+## Insurance
+- Basic insurance (up to NGN 50,000) is included with every delivery
+- Extended insurance is available at 2% of declared value
+- International deliveries include customs documentation support
+
+## If a Customer Asks About Prohibited Items
+Politely decline: "I'm sorry, but {item} cannot be sent through DelivaHere for safety and legal reasons. Is there anything else I can help you with?"
+
+## Package Inspection
+Processing centers inspect packages for:
+- Prohibited items
+- Accurate description matching
+- Proper packaging
+- Weight verification`,
+    folder: "contexts",
+  },
+  {
+    title: "Frequently Asked Questions",
+    content: `## General Questions
+
+**Q: How long does delivery take?**
+A: Local (same city): Usually same-day or next-day. Inter-state: 1-3 days. International: 3-14 days depending on destination.
+
+**Q: How much does delivery cost?**
+A: Prices are set by delivery partner bids, not fixed rates. After you create a request, partners submit their bids and you choose the best one. Estimated ranges are shown when the request is created.
+
+**Q: Is my package insured?**
+A: Yes, basic insurance up to NGN 50,000 is included free. You can opt for extended insurance at 2% of the declared value.
+
+**Q: Can I cancel a delivery?**
+A: Yes, you can cancel before a bid is accepted for free. After acceptance, cancellation may incur a small fee depending on the partner's progress.
+
+**Q: How do I track my package?**
+A: Share your request ID (e.g., del_abc123) and I'll give you a real-time update. You can also track in the DelivaHere app.
+
+**Q: What if my package is damaged?**
+A: Report it within 24 hours of delivery. We'll investigate and process a claim through the insurance coverage. Take photos of the damage.
+
+**Q: Can I schedule a pickup for a specific time?**
+A: Yes! When creating your request, specify your preferred pickup time. Partners who can meet that time will bid accordingly.
+
+**Q: Do you deliver internationally?**
+A: Yes, we support international deliveries. These go through Package Processing Centers for customs documentation.
+
+## Partner-Related Questions
+
+**Q: How are delivery partners verified?**
+A: All partners undergo ID verification and background checks before activation. They're also rated by senders after each delivery.
+
+**Q: Can I choose a specific partner?**
+A: You choose from the bids submitted. You can see each partner's rating, number of deliveries, and their bid notes.
+
+**Q: What if the partner doesn't show up?**
+A: Contact us immediately. We'll reassign your delivery and the partner's account will be reviewed.
+
+## Payment Questions
+
+**Q: When am I charged?**
+A: Payment is held in escrow when you accept a bid. It's released to the partner only after you confirm delivery.
+
+**Q: What payment methods do you accept?**
+A: Bank transfer, debit/credit cards, mobile money (Opay, PalmPay, etc.), and USSD banking.
+
+**Q: Can I get a refund?**
+A: Yes, full refund if the delivery fails or is cancelled before pickup. Partial refunds may apply for late deliveries.`,
+    folder: "faqs",
+  },
+  {
+    title: "Escalation and Human Support",
+    content: `## When to Escalate to Human Support
+
+The bot should escalate when:
+1. Customer reports a lost or stolen package
+2. Customer reports significant damage (> NGN 10,000)
+3. Customer requests a refund exceeding NGN 20,000
+4. Customer reports a safety concern with a partner
+5. Customer has a complaint that isn't resolved after 2 attempts
+6. Legal or compliance questions
+7. Account suspension or verification issues
+8. Customer explicitly asks for a human agent
+
+## How to Escalate
+Say: "I understand this needs personal attention. Let me connect you with our support team. A human agent will be with you shortly. Your reference number is {conversationId}."
+
+## Support Contact Info
+- Email: support@delivahere.com
+- Phone: +234-800-DELIVA (334482)
+- In-app: Settings > Help & Support > Chat with Agent
+- Hours: Mon-Sat 7am-10pm WAT, Sun 9am-6pm WAT
+
+## Common Issues and First Responses
+
+**Late delivery**: Check tracking first. If partner is unresponsive for 2+ hours, escalate.
+**Wrong address**: If not yet picked up, update the request. If in transit, contact partner directly.
+**Price dispute**: Show the accepted bid details. If customer claims overcharge, escalate.
+**App issues**: Suggest: clear cache, update app, reinstall. If persists, escalate.`,
+    folder: "contexts",
+  },
+  {
+    title: "Service Coverage Areas",
+    content: `## Local Delivery Coverage
+
+DelivaHere operates in major cities across Nigeria:
+- Lagos (all areas including Island, Mainland, Lekki, Ikorodu, Badagry)
+- Abuja (FCT and satellite towns)
+- Port Harcourt
+- Ibadan
+- Kano
+- Kaduna
+- Enugu
+- Benin City
+- Calabar
+- Warri/Asaba
+
+Coverage is expanding — if a customer's city isn't listed, they can still create a request. If partners are available in the area, they'll receive bids.
+
+## Inter-State Delivery
+All 36 states + FCT are supported for inter-state delivery via the Processing Center network.
+
+## International Delivery
+Currently supported corridors:
+- Nigeria to/from Ghana
+- Nigeria to/from UK
+- Nigeria to/from USA
+- Nigeria to/from South Africa
+- Nigeria to/from UAE (Dubai)
+- More corridors being added regularly
+
+For unlisted international destinations, customers should contact support for availability.
+
+## Delivery Time Estimates
+- Local (same city): 2-8 hours (same-day) or next business day
+- Inter-state: 1-3 business days
+- International (Africa): 3-7 business days
+- International (Europe/Americas): 7-14 business days
+
+Note: These are estimates. Actual times depend on partner availability and route.`,
+    folder: "general",
+  },
+];
+
+main().catch((err) => {
+  console.error("Setup failed:", err.response?.data || err.message);
+  process.exit(1);
+});