GNL
Docs menu
Docs

Welcome to the GNL docs.

Durable-agent infrastructure that wraps the Vercel AI SDK's agent loop without changing it, guaranteeing exactly-once and deterministic replay. Below: a 60-second quickstart, an overview of the three tiers (Core/Studio/Enterprise), and a list of every feature.

60-second quickstart

Scaffold an agent skeleton with npm create gnl.

terminal
npm create gnl@latest
cd my-agent
npm install

runDurable uses the same arguments and the same return type as the AI SDK's generateText — the only addition: runId + journal.

agent.ts
import { runDurable } from '@gnldev/durable';
import { SqliteStorage } from '@gnldev/durable/sqlite';
import { anthropic } from '@ai-sdk/anthropic';

const res = await runDurable({
  runId: 'order-123',                        // idempotency key
  journal: new SqliteStorage('runs.db').runs, // state lives here (.runs = RunJournal)
  model: anthropic('claude-opus-5'),
  tools: { chargeCard },
  prompt: 'Process the order',
});

// Even if the process crashes, call again with the same runId: it resumes where it
// left off, and tools that already completed NEVER run again.

Three tiers

Three progressively-unlocked tiers built on the same journal — which plan/package each comes with is also shown on each card's badge below.

Core · Free

Core — free core

@gnldev/durable, @gnldev/server, @gnldev/auth, @gnldev/evals, and satellite packages. Exactly-once, deterministic replay, time-travel/fork; all open source, and your journal always stays in your own database.

Studio

Studio — management & inspection

@gnldev/studio: a web UI that observes runs/the journal, offers time-travel replay, and hosts an approval queue + audit log + retention/GDPR purge + policy editor. Runs locally on self-host.

Enterprise

Enterprise — paid tier

@gnldev/auth-ee plus server's ee-routes: Ed25519-signed offline license, fine-grained RBAC/SSO, user/seat management, and runtime budget enforcement (402).

All features

33 features, grouped by tier. Click any one to go to its deep-dive page.

Core

Core · Free