
Runtime
The host that runs the agent graph.
Author the graph on the canvas or in TypeScript. Start an execution from your app, a webhook, or a schedule. The host writes a checkpoint after every node.
How it works
From trigger to a finished execution
The agent is what you ship. The workflow is the versioned graph behind it. Linea executes that graph and keeps the record of every step.
01.
One graph, two surfaces
The builder and the TypeScript SDK emit the same workflow definition. An agent may use several graphs. Those are still one product.
02.
Start an execution
A conversation is one user thread. An execution is one run of the graph — from a schedule, a webhook, or your own code.
03.
Recover from the checkpoint
Each completed node writes a checkpoint. If the process dies, the next worker resumes from the last successful step.
04.
Sandbox the code node
Last-mile logic drops into a boxed function. It can fail without taking the host down, and it can be replayed like any other node.
Example
Define the graph in your codebase
The SDK writes the same workflow the builder draws. Keep the file next to the agent you ship. Open the canvas when a visual view helps.
import { graph, http, model } from "@linea/sdk";
export const recovery = graph({
name: "invoice-recovery",
nodes: {
fetch: http.get("/invoices/:id"),
reason: model.complete("Explain the failure."),
notify: http.post("/hooks/slack"),
},
});Compare
Ship the agent. Do not operate the host.
Keep the prompts, tools, and business logic. Linea executes the graph and holds the control plane around the run.
| Self-managed stack | Linea Runtime | |
|---|---|---|
| Where the process lives | Workers and queues you operate | The host that runs the graph |
| A crash mid-run | Custom retry and recovery logic | Resume from the latest checkpoint |
| A code node | Infrastructure you isolate | Sandboxed execution |
| Builder vs file in git | Definitions can drift | One shared workflow definition |
You build
- The prompts, models, tools, and business logic
- The nodes and transitions unique to your product
- The events that should start each execution
Linea manages
- Workers, retries, and recovery
- Sandboxed execution for custom code
- Checkpoints and execution history for every node