@agentic-fullstack/engine

The execution engine for agentic-fullstack. It is a long-running server-side process that watches the database for pending timeline events and runs your LangGraph graphs to process them.

The engine handles claiming work, running graphs, streaming real-time chunks back to the database, and advancing or completing agents — so your application code only needs to define the graphs themselves.

Installation

npm install @agentic-fullstack/engine

Usage

import { createEngine } from "@agentic-fullstack/engine";

const engine = createEngine({
  adapter, // DBAdapter — e.g. from @agentic-fullstack/postgres
  checkpointer, // LangGraph checkpoint saver
  bridge, // EntityBridge — read/write your entity records
  resolveGraph: (agentId, type) => {
    // Return a GraphConfig for the given agent type, or null to reject it
  },
});

await engine.start();

The engine registers SIGTERM and SIGINT handlers and drains in-flight work before exiting. Call engine.stop() to shut it down manually.

See the TypeScript types in src/types.ts for the full configuration reference.

Related Packages

• @agentic-fullstack/core — shared types
• @agentic-fullstack/postgres — PostgreSQL adapter and checkpointer
• @agentic-fullstack/server — HTTP server for dispatching events

License

MIT