sologate-gate

Human-in-the-loop approval gates for autonomous AI agents.

Drop one function into your agent. It pauses execution, surfaces an approval request in the Sologate dashboard, and resumes (or throws) when a human decides.

Install

npm install sologate-gate

Usage

import { gate, GateRejectedError } from 'sologate-gate'

try {
  await gate('send_bulk_email', {
    sologateUrl: process.env.SOLOGATE_URL,
    apiKey: process.env.SOLOGATE_KEY,
    unitId: process.env.SOLOGATE_UNIT_ID,
    context: 'Outbound campaign to EU segment — 847 contacts',
    payload: { recipients: 847, subject: 'Q2 Outreach' },
  })
  // human approved — continue
  await sendBulkEmail()
} catch (err) {
  if (err instanceof GateRejectedError) {
    console.log('Rejected by approver — aborting')
  }
}

Options

| Option | Type | Required | Description | |---|---|---|---| | sologateUrl | string | yes | Base URL of your Sologate backend | | apiKey | string | yes | Your Sologate API key | | unitId | string | yes | Existing unit ID that should be gated | | action | string | yes | Short name for the action (first arg to gate()) | | context | string | no | Human-readable description shown in the dashboard | | payload | object | no | Extra context shown in the dashboard | | timeoutMs | number | no | Max wait time in ms (default: 48h) |

Errors

• GateRejectedError — thrown when the approver clicks Reject
• GateTimeoutError — thrown when no decision is received before timeoutMs