API Reference
Cinder.run
The main high-level runtime method resolves input, dispatches the action, and produces feedback.
Need the shortest path?
Use Quick Start when you want the smallest working route → scan → graph → run flow first.
Something feels off?
Inspect scan output, graph state, active route/context, and dispatch in a practical order.
Need the full surface?
Browse all runtime methods, hooks, extension points, and lifecycle APIs.
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
const result = await Cinder.run('show weather', document);
console.log(result.intent);
console.log(result.dispatch);
console.log(result.reflex);Local-first behavior
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