AbsoluteJS

@absolutejs/agent-inbox

@absolutejs/agent-inboxv0.3.5betaAI

Durable verified webhooks, event subscriptions, schedules, leases, retries, and dead letters for AI agent triggers.

#Installation

BASH
bun add @absolutejs/agent-inbox

#Capabilities

Overview

Durable inbound work for agents. Verified webhooks and event subscriptions are deduplicated by source event, encrypted through an injected codec, leased to one worker, retried with backoff, and dead-lettered after a bounded attempt count. Interval schedules materialize deterministic occurrences without Redis. Occurrences are inserted before a compare-and-swap advances the schedule, so a crash cannot lose a tick and retries collapse on the deterministic source ID.

Every subscription and schedule carries a complete runtime budget, bounded delivery attempts, and a message TTL. Tenant-scoped inventories and explicit subscription, schedule, and pending-message controls let owner and operator interfaces manage retained triggers without querying the package schema.

Every message pins the target agent's signed discovery identity and preserves verification provenance. The runtime adapter starts a durable @absolutejs/agent-runtime run with the inbox message ID as its idempotency key. Webhook bodies are byte-limited and are rejected unless a source-specific signature/claim verifier succeeds. The Postgres store uses SKIP LOCKED; the memory store is intended for tests.

Outcomes

What you can build

Build on the supported package contract

Use @absolutejs/agent-inbox through its supported public entry points.

Hardening checklist

Production guidance

Make every external boundary explicitPin the deployed @absolutejs/agent-inbox version, replace example or memory-backed dependencies with durable implementations, bound external calls, protect credentials, and emit enough evidence to retry or recover safely.

Follow in order

Troubleshooting path

1
Trace from the first failed boundary
Reproduce the smallest canonical @absolutejs/agent-inbox example, confirm the supported entry point and version in the API explorer, then inspect the first boundary that did not produce its documented result.

#Public entry points

Supported entry points declared by this package manifest.

Package entry point declared in package.json.

@absolutejs/agent-inbox@absolutejs/agent-inbox/manifest@absolutejs/agent-inbox/manifest.json

#Package commands

Scripts declared by this package manifest.

bun run buildrm -rf dist && bun build src/index.ts src/manifest.ts --outdir dist --target=bun --external @absolutejs/manifest --external @sinclair/typebox --external drizzle-orm --external 'drizzle-orm/*' && tsc -p tsconfig.build.json && absolute-manifest emit
bun run check:packagebun run typecheck && bun run test && bun run build
bun run formatprettier --write "./**/*.{ts,json,md,yml}"
bun run testbun test
bun run typechecktsc --noEmit

#API reference

Search the declarations exported by the current package type files. Expand a symbol to inspect its source-backed signature.

22 symbols
AgentIdentityPintypePermalinkSource
TS
type AgentIdentityPin = {
    descriptorId: string;
    descriptorVersion: string;
    descriptorDigest: string;
};
Exported from @absolutejs/agent-inbox