@ddtcorex/dsh-maestro-notifier

Pluggable notifier service for the DeepSeek Harness: a tiny in-memory provider registry with Telegram as the first transport. Delivery is never-throw — callers can notify without error handling; unknown providers and missing targets resolve to { sent: false, reason }.

Part of the Maestro Harness suite (dsh-maestro-*). Cordis patch row id: dsh-maestro-notifier (short alias maestro-notifier in the meta bundle).

What it provides

• maestroNotifier service: register(provider), ids(), send(providerId, target?, message) dispatching to the registered provider.
• Telegram provider (one-way bot messages; protect_content, no link preview, 10 s timeout; credentials never logged).
• Transport only — message copy belongs to the consuming plugin; this package never authors domain text. Consumers depend on it structurally (augment.d.ts), never at compile time.
• Default-target resolution: when a caller omits the target, an optional resolveTarget hook reads notify.telegram from the shared settings store (~/.dsh/maestro/settings.json, via @ddtcorex/dsh-maestro-config-lib). Explicit targets win; any resolver failure degrades to { sent: false, reason: 'not-configured' }.

const notifier = ctx.get('maestroNotifier')
await notifier.send('telegram', undefined, { text: 'review finished' }) // target resolved from the store

Install

dsh plugin --profile web add @ddtcorex/dsh-maestro-notifier
# or everything at once:
dsh plugin --profile web add @ddtcorex/dsh-maestro-meta

Development

pnpm install
pnpm verify   # tsc --noEmit
pnpm test     # vitest run
pnpm build    # tsc -> lib/

License

MIT