Capability DSL
The capability DSL is the canonical authoring format. A capability declares its goal, examples, resources, and executable behavior graph.
Supported behavior types
| Type | Purpose |
|---|---|
collect | Gather and validate datapoints |
action | Invoke a configured integration action |
choice | Present options and route from the selection |
confirm | Require an explicit checkpoint before continuing |
guide | Provide goal-oriented guided instructions |
investigate | Run read actions and route from findings |
generate | Generate conversational, artifact, or file content |
say | Emit exact template-capable text without a model call |
if | Route using an explicit condition |
goto | Jump to another stable behavior slug |
done | Complete the journey |
escalate | Hand the conversation to a human queue |
Routing
Routes may continue, complete, escalate, or target another stable step slug. Missing targets are invalid and should remain visible during authoring rather than silently routing elsewhere.
Step names are user-facing. Slugs are internal route identifiers and should be stable when explicitly authored or referenced.
Round-tripping
Visual authoring must preserve advanced fields such as conditions, constraints, retries, error handling, change handling, fallbacks, templates, outputs, review, presentation, and notifications even when a visual control is not available.
Use the editor's schema validation and autocomplete for the exact field-level contract supported by the deployed version.