Skip to content
CCinder
Cinder.run

API Reference

Cinder.run

The main high-level runtime method resolves input, dispatches the action, and produces feedback.

Core API

Cinder.run() is the easiest way to use the full runtime without manually calling each lower-level step.

Purpose

Use run() when you want the complete pipeline:

  • inject runtime context if configured
  • resolve intent locally first
  • optionally attempt bounded fallback
  • dispatch the final intent
  • produce reflex output

Example

ts
4 lines
const result = await Cinder.run('show weather', document);
console.log(result.intent);
console.log(result.dispatch);
console.log(result.reflex);

Local-first behavior

Primary path

run() still resolves locally first. If AI is disabled, unknown requests remain local unknowns and should degrade clearly.

run() still resolves locally first. If AI is disabled, unknown requests stay local unknowns and should degrade clearly.

Fallback note

If AI is enabled and local confidence is too low, fallback can occur inside run() without changing the rest of your application-side dispatch handling.

Runtime events like fallback:start and fallback:end are the best observability hooks for understanding whether fallback was attempted, timed out, normalized successfully, or produced a usable intent.

Continue reading