npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@botlake/extension-mail-agents

v0.7.0

Published

Automatic live mail delivery and grace-period agent resumption.

Readme

Mail–Agents

Configured live-agent delivery for Mail. Callers use bl mail and Batteries bl await; there are no separate wake-up operations.

Compose the exact selected Mail and Agents bindings:

import { mailAgents } from "@botlake/extension-mail-agents";

import agents from "./agents.ts";
import mail from "./mail.ts";

export default mailAgents({ agents, mail, graceSecs: 300 });

Explicitly select this descriptor, those Mail/Agents descriptors, and Agents' prerequisites. Imports activate nothing. Native reporting or verified provider output must establish the recipient's session identity. Notification plugins remain responsible for announcing mail inside running sessions.

Delivery policy

Mail arrives
  |
  v
Recipient running? -- yes --> Store for its inbox/notification plugin
  |
  no
  v
Normally settled within grace? -- yes --> Admit one session continuation
  |
  no
  v
Undeliverable; sender must decide whether to resend

graceSecs defaults to 300; zero permits live delivery only. Agents records agent/stopped-at when custody settles. Every normally completed continuation gets its own grace window; retry clears the previous invocation's stop time. Failed/cancelled runs are not restarted by Mail. An idle external turn still owns its session; only a recorded session end permits a managed continuation. External-only sessions cannot be launched by this composition.

Mail reconciles unannounced messages at startup and every second, covering mail arriving before or after settlement. Pending messages coalesce into one continuation. Each message can cause at most one wake; previously announced or acknowledged messages do not wake agents. New arrivals can cause a later continuation without enrollment. Admission and the message's mail/wake-run marker commit together; Agents owns session custody and continuation exclusion. Resume admission is not notification delivery or execution success.

Mail uses Agents' automatic-continuation admission seam. When Work Auto Bot owns the target lineage, its atomic readiness/assignment/pause checks and shared continuation budget also apply to Mail. Exhausted workers and the one-shot Oracle debugger cannot self-resume through mail. Other lineages retain this grace policy; explicit manual Agents resume is unchanged.

Inactive recipients produce status: "undeliverable", reason: "recipient_inactive" in send/reply results. Admission refusals produce reason: "resume_rejected" and diagnostic detail. A removed resume worktree is a typed admission refusal, including during startup reconciliation; the lake remains available, with no cwd fallback or fresh-session retry. Undeliverable messages leave the live inbox and are never retried automatically; a terminal record remains available to the sender through ordinary Mail reads/lists. Mail accepted while running can become undeliverable later, so use mail read ID or mail-undeliverable to observe that outcome. No expiry wake, fallback session or retry queue is created.

Bodies never enter the resume prompt. The resumed agent retrieves and acknowledges mail through the ordinary Mail operations. Use Batteries await to remain in the current turn; it does not control automatic wake permission.