Scenarios

A Scenario is a graphical AI workflow: a sequence of nodes (steps) connected together that Runeya executes automatically, calling an AI model at each step. Scenarios let you automate repetitive or complex processes without writing code.

Core Concepts

Nodes

Each node represents a step in the workflow. There are two types of nodes:

Type	Description
prompt	The AI generates a response based on text you have prepared.
ask_user	The workflow pauses and waits for a manual input from you before continuing.

Edges (links)

Edges connect nodes together and define the execution order. By default, an edge connects the output of one node to the input of the next.

Conditional Branching

When a node has multiple outgoing edges, you can assign a description to each edge. At runtime, the AI chooses which branch to follow by responding PASS1, PASS2, etc.

Example:

• Branch 1: "Tests passed — continue deployment"
• Branch 2: "Error detected — notify the team"

Groups

Groups are visual areas that let you cluster related nodes to make the workflow easier to read. They have no effect on execution.

Limits

Element	Maximum
Nodes	50
Edges	100
Groups	20

Creating a Scenario

1. Go to Settings → Scenarios.
2. Click New Scenario.
3. Give your Scenario a name.
4. In the graphical editor, click + Add node to create your first node.
5. Choose the type (prompt or ask_user) and write the node content.
6. Connect nodes with edges by dragging from the output of one node to the input of another.
7. Click Save.

Configuring Conditional Branching

1. In the editor, click the source node to open its edit panel.
2. Create multiple outgoing edges from that node.
3. The Branches section appears in the edit panel.
4. Enter a description for each branch (e.g. "Tests passed", "Error detected").
5. Save the node.

Deleting an Element

Select the node, group, or edge in the editor, then:

• Click the Delete button in the side panel, or
• Press the Delete or Backspace key.

Generate a Scenario with AI

Runeya can automatically generate a Scenario from a text description:

1. In Settings → Scenarios, click Generate with AI.
2. Describe the workflow you want to create in plain language.
3. Runeya creates the corresponding node graph — you can then adjust it manually.

Running a Scenario

From the AI Tab

1. Go to the AI tab.
2. Click Launch a Scenario.
3. Select the Scenario from the list.
4. Enter a run name (or click Generate name with AI to get one automatically).
5. Click Launch.

A conversation associated with the run is created and visible in the conversation list.

Tracking Execution

During execution:

• Each step appears in the conversation as it progresses.
• If an ask_user node is reached, the workflow pauses and you receive a notification (if notifications are enabled). You must enter a response for execution to resume.

Stopping a Scenario

To interrupt a running Scenario, open the associated conversation and click Stop.

Common Use Cases

• Automated code review: send a diff to the AI, analyze feedback, create a ticket if needed.
• Debugging pipeline: describe a bug → analyze logs → suggest a fix → ask for confirmation before applying.
• Documentation generation: read source code → generate documentation → submit a PR.
• Team onboarding: guided series of questions and answers to configure a new project.

FAQ

Can I resume an interrupted Scenario? A manually stopped Scenario cannot be resumed. An ask_user node pauses the workflow while waiting for your response — that is not a permanent stop.

Can the Scenario access my Runeya services?prompt nodes send only the text you configured to the AI. They have no direct access to services or logs — you must manually include any relevant information in the prompt.

How does the AI choose which branch to follow? The AI must end its response with PASS1, PASS2, etc. (on its own line) to indicate the chosen branch. If no valid branch is selected, execution fails at that node.