What is bots-node-sdk?

The Oracle Bots Node.js SDK helps developers extend Oracle's Digital Assistant chatbot platform with custom logic and integrations. If you're building a chatbot with Oracle Digital Assistant and need it to do something the platform doesn't handle out of the box, like calling a proprietary API, running a specific database query, or customizing how a language model responds, this toolkit gives you a structured way to build and deploy those pieces. At its core, the SDK provides a command-line tool that scaffolds projects for you. You run a command to generate a new service, and it creates a starter project with a sample component. From there, you can add different types of handlers: custom components for arbitrary logic, entity event handlers for processing user inputs, SQL query handlers for database lookups, and LLM-related handlers for transforming or validating AI model responses. Once your code is written, you package it with a single command and deploy it either as an external service running on a Node.js server or inside a Docker container. The people who'd use this are developers building chatbots on Oracle's platform who need custom backend behavior. For example, a pizza chain might use it to connect their chatbot to an internal ordering system, or a bank might build a handler that validates loan-related questions before they reach an AI model. It's specifically for teams already committed to Oracle Digital Assistant, it's not a general-purpose chatbot framework. One notable aspect is the TypeScript support. When you create a project, you can choose TypeScript instead of plain JavaScript, which gives you autocomplete and type checking in editors like VS Code. The SDK handles the conversion to runnable JavaScript automatically when you build or start the service. This is a meaningful quality-of-life feature for developers who want fewer runtime errors and better tooling, though it does add a compilation step to the workflow.