dsh-maestro-notifier

Plugins in the DeepSeek Harness ecosystem often need to push a short message to the user — a job finished, a config migration failed, a scheduled task fired — yet doing the HTTP call, timeout, and error fallback by hand every time is repetitive and error-prone. dsh-maestro-notifier turns that into a one-line send() call backed by a tiny in-memory provider registry.

The defining design choice is never-throw. An unknown provider, a missing target, or a 10-second network timeout all resolve to a structured { sent: false, reason } result instead of an exception, so callers write notify calls the way they write log lines — no try/catch in sight. The built-in Telegram transport uses protect_content, disables link previews, enforces a 10 s timeout, and guarantees credentials never appear in logs. Message wording is entirely the consumer's job; this package is a pure transport and never authors domain text.

If you are building a dsh-maestro-* plugin or any Harness runtime feature that needs to push a brief notification, this removes the provider plumbing, default-target resolution from ~/.dsh/maestro/settings.json, and degradation logic from your checklist. Just register, send, and move on.