HelloNext HNScript Debugger

The HelloNext HNScript Debugger is a Visual Studio Code extension designed to help developers debug, test, and publish HNScript scripts locally with a real execution environment.

HNScript is used inside the HelloNext platform to customize behaviors such as:

• Contact handling
• Bots and automations
• Integrations with external systems
• Custom workflows and business logic

🚀 Features

• 🔍 Local Debugging with Breakpoints
  Run HNScript locally and attach the VSCode debugger with full breakpoint support.

• ⚡ Real Runtime Execution
  Scripts are executed using the same runtime as production.

• 📡 Live Log Streaming
  View logs in real-time during execution.

• 🔄 Production Sync & Diff
  Compare local scripts with production and publish changes directly.

• 🧠 Automatic Environment Setup
  The extension automatically installs and updates the Debugger Host and runtime.

🧩 Requirements

• Visual Studio Code
• Valid credentials to authenticate access to the HelloNext tenant with administrator privileges

🔧 First Run

1. Install the extension
2. Open the HelloNext panel
3. Log in with your credentials
4. The extension will automatically install the Debugger Host if needed

▶️ How to Debug

1. Select a webhook from the list
2. Click Start Debug
3. The script will open in the editor
4. Set breakpoints
5. Trigger the webhook using: http://127.0.0.1:48731/api/core/tenant/{tenantName}/webhook/{webhookName}
6. The debugger will pause at breakpoints

📝 Logs

During execution:

• Logs are streamed in the HelloNext Debugger output panel
• Final logs and errors are displayed when the session ends

🔄 Publish Changes

1. Modify the script locally
2. Open Publish Diff
3. Review differences
4. Click Publish

🏗️ Architecture

The debugger is composed of:

• VSCode Extension (UI & control)
• Debugger Host (local process)
• Runtime (downloaded dynamically from cloud)

This ensures:

• High fidelity with production behavior
• Automatic updates without reinstalling the extension

⚠️ Notes

• The Debugger Host runs locally on: http://127.0.0.1:48731/
• Debugging uses the Node Inspector protocol on port: 9229

🛠 Troubleshooting

DebuggerHost not found

Click Install Host when prompted, or ensure it exists in: %LOCALAPPDATA%\HelloNext\Host

Debugger not attaching

• Make sure port 9229 is available
• Restart the Debugger Host

Logs not appearing

• Check the HelloNext Debugger output panel
• Restart the debug session

📦 About Hello Next

HelloNext is a platform for building omnichannel customer experiences with support for:

• Voice (dialers predictive, power, preview, IVR, AI Generative Bots)
• Messaging (WhatsApp, chat, social)
• Automation and journeys
• Custom scripting via HNScript

📄 License

Internal / Proprietary – Hello Next