Governance-compliant Notion Workers for agent automation

TypeScript SDK providing three specialized workers that enforce governance rules, reduce agent overhead, and enable reliable machine-to-machine coordination across an 11-agent automation system.

Get started Explore workers

Quick start

Get up and running with jre-notion-workers in minutes

Clone and install

Clone the repository and install dependencies:

git clone https://github.com/jreakin/jre-notion-workers
cd jre-notion-workers
npm install

Configure credentials

Set up your Notion integration credentials:

export NOTION_TOKEN=your_notion_token
export DOCS_DATABASE_ID=your_docs_database_id
export HOME_DOCS_DATABASE_ID=your_home_docs_database_id
export TASKS_DATABASE_ID=your_tasks_database_id

Import and register a worker in your application:

import { Worker } from "@notionhq/workers";
import { executeWriteAgentDigest } from "./workers/write-agent-digest.js";

const worker = new Worker();

worker.tool("write-agent-digest", {
  title: "Write Agent Digest",
  description: "Creates a governance-compliant agent digest page",
  schema: writeDigestSchema,
  execute: executeWriteAgentDigest
});

Three specialized workers

Each worker handles a specific governance function for agent coordination

write-agent-digest

Creates schema-compliant digest pages with automatic formatting, status lines, and governance validation

check-upstream-status

Finds and parses the most recent digest for any agent, with staleness detection and structured status

create-handoff-marker

Manages agent escalations with circuit breakers, escalation caps, and optional task creation

Explore by topic

Deep dive into architecture, concepts, and API reference

Architecture

Learn about the layered structure and data flow patterns

Agent system

Understand the 11-agent automation system and coordination model

Type reference

Explore all TypeScript types and interfaces

Testing guide

Run unit, integration, and evaluation tests

Ready to enforce governance in your agent system?

Start using jre-notion-workers to reduce agent overhead and make machine-to-machine coordination reliable.

Get started →

Get Started

Core Concepts

Workers

Guides