@dawn-ai/langgraph

Use this when

Use this integration package when a Dawn runtime or framework extension must normalize graph and workflow route modules or execute those entries through Dawn's backend-adapter contract. Application route authors normally use the SDK route contracts and let the CLI choose these adapters.

Install and import

pnpm add @dawn-ai/langgraph

import { defineEntry, graphAdapter, normalizeRouteModule } from "@dawn-ai/langgraph"
import type { RouteModule } from "@dawn-ai/langgraph/route-module"

Use @dawn-ai/langgraph/define-entry for the smallest entry-validation import and @dawn-ai/langgraph/route-module for normalization contracts without the adapters.

Compatibility and audience

All three runtime surfaces bundle without third-party runtime dependencies or Node globals. This classification covers importing and executing these Dawn adapters; it does not classify a graph, workflow, or tool supplied by an application.

Public exports

@dawn-ai/langgraph

ToolRegistry exists in a private implementation module but is not exported from this package surface.

@dawn-ai/langgraph/define-entry

@dawn-ai/langgraph/route-module

The route-module subpath exposes only its published normalization and route-module contracts. The source-derived inventory pins these eight names independently from the root and /define-entry surfaces.

Key contracts

export declare function defineEntry<TEntry, TModule extends RouteModule<TEntry>>(
  module: TModule,
): TModule

export interface GraphRouteModule<TEntry = unknown> {
  readonly graph: TEntry
  readonly workflow?: never
  readonly config?: RouteConfig
}

Fields: @dawn-ai/langgraph#./route-module:GraphRouteModule

export interface WorkflowRouteModule<TEntry = unknown> {
  readonly workflow: TEntry
  readonly graph?: never
  readonly config?: RouteConfig
}

Fields: @dawn-ai/langgraph#./route-module:WorkflowRouteModule

export type RouteModule<TEntry = unknown> = GraphRouteModule<TEntry>
  | WorkflowRouteModule<TEntry>

export interface NormalizedRouteModule<TEntry = unknown> {
  readonly kind: RouteKind
  readonly entry: TEntry
  readonly config: RouteConfig
}

Fields: @dawn-ai/langgraph#./route-module:NormalizedRouteModule

export declare function normalizeRouteModule<TEntry>(
  module: RouteModule<TEntry> | (GraphRouteModule<TEntry> & WorkflowRouteModule<TEntry>),
): NormalizedRouteModule<TEntry>

export declare function assertExactlyOneEntry<TEntry>(
  module: RouteModule<TEntry> | (GraphRouteModule<TEntry> & WorkflowRouteModule<TEntry>),
): asserts module is RouteModule<TEntry>

Behavior contract langgraph.entry.exclusive

A route module must provide exactly one of graph or workflow.

Entry validation caveats

An explicitly undefined key counts as absent. defineEntry() returns the original object, while normalizeRouteModule() fills an omitted config with a new empty object. Invalid modules throw synchronously before an entry executes.

Behavior contract langgraph.route-module.surface

The route-module subpath exposes only its published normalization and route-module contracts.

Adapter lifecycle and failure boundaries

The manifest assertion establishes the published declaration target; the source-derived ownership inventory above establishes the exact eight-symbol surface.

graphAdapter calls a function directly or calls an object's invoke; workflowAdapter accepts only a function. Both pass { signal }, await the result, and implement stream() as a single yielded execute result. They do not provide native multi-chunk graph streaming. The runtime, streaming, and tags route-config fields are reserved contracts but these adapters do not branch on them today.

Examples and related guides

import { defineEntry, normalizeRouteModule } from "@dawn-ai/langgraph"
 
const route = defineEntry({
  workflow: async (input: { name: string }, { signal }: { signal: AbortSignal }) => {
    signal.throwIfAborted()
    return { greeting: `Hello, ${input.name}` }
  },
  config: { runtime: "node", streaming: false }, // reserved; no adapter runtime effect
})
 
const normalized = normalizeRouteModule(route)
console.log(normalized.kind) // workflow

Continue with Routes, SDK API, and CLI API.