@vanadium-23/dsh-ping 0.1.0

package/lib/types/channels.js

@@ -0,0 +1,204 @@
+/**
+ * Delivery channels: Windows toast, console line, optional webhook.
+ *
+ * All three are best-effort by contract — a notification that cannot be shown
+ * must never affect the harness, so every failure is logged and swallowed.
+ * @module dsh-ping/channels
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { escapeXml } from "./decide.js";
+/**
+ * The toast script, sent as one `-EncodedCommand` payload.
+ *
+ * It is a constant. No session text is ever concatenated into PowerShell
+ * source, so no amount of text in a session title, an error message, or a tool
+ * name can reach the PowerShell parser: the text arrives as an XML document in
+ * an environment variable and is handed straight to the WinRT XML parser.
+ */
+export const TOAST_SCRIPT = `$ErrorActionPreference = 'Stop'
+[void][Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType=WindowsRuntime]
+[void][Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom.XmlDocument, ContentType=WindowsRuntime]
+$xml = New-Object Windows.Data.Xml.Dom.XmlDocument
+$xml.LoadXml([Text.Encoding]::Unicode.GetString([Convert]::FromBase64String($env:DSH_PING_XML)))
+$toast = New-Object Windows.UI.Notifications.ToastNotification $xml
+$appId = $env:DSH_PING_APPID
+if ([string]::IsNullOrEmpty($appId)) { $appId = '{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\\WindowsPowerShell\\v1.0\\powershell.exe' }
+[Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId).Show($toast)
+`;
+/**
+ * Render the toast XML payload.
+ * @param notice - the heading and body lines.
+ * @param delivery - presentation options.
+ * @returns a complete `<toast>` document.
+ */
+export function buildToastXml(notice, delivery) {
+    const attributes = [
+        delivery.url === undefined || delivery.url === '' ? '' : `activationType="protocol" launch="${escapeXml(delivery.url)}"`,
+        delivery.long === true ? 'duration="long"' : '',
+    ].filter(part => part !== '').join(' ');
+    const texts = [notice.title, ...notice.lines]
+        .map(line => `      <text>${escapeXml(line)}</text>`)
+        .join('\n');
+    const audio = delivery.sound === undefined || delivery.sound === ''
+        ? '  <audio silent="true"/>'
+        : `  <audio src="${escapeXml(delivery.sound)}" loop="false" silent="false"/>`;
+    return [
+        `<toast ${attributes}>`.replace(' >', '>'),
+        '  <visual>',
+        '    <binding template="ToastGeneric">',
+        texts,
+        '    </binding>',
+        '  </visual>',
+        audio,
+        '</toast>',
+    ].join('\n');
+}
+/**
+ * Encode a script for `powershell.exe -EncodedCommand`.
+ * @param script - PowerShell source.
+ * @returns base64 of the UTF-16LE script.
+ */
+export function encodeCommand(script) {
+    return Buffer.from(script, 'utf16le').toString('base64');
+}
+/**
+ * Resolve the Windows PowerShell 5.1 executable.
+ *
+ * WinRT type projection is a 5.1 feature; `pwsh` is not a substitute, so the
+ * in-box path is used rather than a PATH lookup that could find PowerShell 7.
+ * @param configured - an explicit path from configuration.
+ * @returns the executable path, or `undefined` when unavailable.
+ */
+export function resolvePowershell(configured) {
+    if (configured !== undefined && configured !== '' && existsSync(configured))
+        return configured;
+    if (process.platform !== 'win32')
+        return undefined;
+    const path = join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+    return existsSync(path) ? path : undefined;
+}
+/** Environment names Windows PowerShell needs to start cleanly. */
+const KEEP_ENV = [
+    'SystemRoot', 'windir', 'SystemDrive', 'PATH', 'Path', 'PATHEXT', 'COMSPEC', 'TEMP', 'TMP',
+    'USERPROFILE', 'USERNAME', 'COMPUTERNAME', 'NUMBER_OF_PROCESSORS', 'PSModulePath', 'LANG', 'LC_ALL',
+];
+/**
+ * Build a minimal child environment.
+ *
+ * A notification process has no business inheriting API keys, so the
+ * environment is rebuilt from an allowlist instead of copied.
+ * @returns the environment for the toast helper.
+ */
+export function minimalEnv() {
+    const env = {};
+    for (const name of KEEP_ENV) {
+        const value = process.env[name];
+        if (value !== undefined)
+            env[name] = value;
+    }
+    return env;
+}
+/**
+ * Show a Windows toast. Fire-and-forget by design.
+ * @param notice - the heading and body lines.
+ * @param delivery - presentation options.
+ * @param log - diagnostic sink.
+ * @returns true when the helper was started.
+ */
+export function sendToast(notice, delivery, log) {
+    const powershell = resolvePowershell(delivery.powershellPath);
+    if (powershell === undefined) {
+        log('toast channel unavailable: Windows PowerShell 5.1 not found');
+        return false;
+    }
+    const xml = buildToastXml(notice, delivery);
+    try {
+        const child = spawn(powershell, ['-NoProfile', '-NonInteractive', '-STA', '-WindowStyle', 'Hidden', '-EncodedCommand', encodeCommand(TOAST_SCRIPT)], {
+            windowsHide: true,
+            // NOT detached. A detached Windows process has no console, and in that
+            // state Windows PowerShell 5.1 loads the WinRT toast types, runs
+            // Show(), and exits 0 while no notification is ever raised — a silent
+            // failure that cost three lost notifications before it was caught.
+            // `unref()` below is what keeps the call non-blocking.
+            detached: false,
+            stdio: 'ignore',
+            env: {
+                ...minimalEnv(),
+                DSH_PING_XML: Buffer.from(xml, 'utf16le').toString('base64'),
+                DSH_PING_APPID: delivery.appId,
+            },
+        });
+        child.on('error', (error) => { log(`toast helper failed: ${error.message}`); });
+        child.unref();
+        return true;
+    }
+    catch (error) {
+        log(`toast helper could not start: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+/**
+ * Show a Windows toast and wait for the helper to finish.
+ *
+ * The plugin never uses this — a live notification must not block a session
+ * event — but a diagnostic run has to see the helper's exit code to tell
+ * "shown" apart from "silently refused".
+ * @param notice - the heading and body lines.
+ * @param delivery - presentation options.
+ * @returns the helper's exit code and captured error output.
+ */
+export function sendToastSync(notice, delivery) {
+    const powershell = resolvePowershell(delivery.powershellPath);
+    if (powershell === undefined)
+        return { started: false, code: null, output: 'Windows PowerShell 5.1 not found' };
+    const xml = buildToastXml(notice, delivery);
+    const result = spawnSync(powershell, ['-NoProfile', '-NonInteractive', '-STA', '-WindowStyle', 'Hidden', '-EncodedCommand', encodeCommand(TOAST_SCRIPT)], {
+        windowsHide: true,
+        encoding: 'utf8',
+        timeout: 20_000,
+        env: {
+            ...minimalEnv(),
+            DSH_PING_XML: Buffer.from(xml, 'utf16le').toString('base64'),
+            DSH_PING_APPID: delivery.appId,
+        },
+    });
+    const output = `${result.stderr ?? ''}${result.stdout ?? ''}`.trim();
+    return { started: true, code: result.status, output };
+}
+/**
+ * Write the notice to stderr, where the launching terminal shows it.
+ * @param notice - the heading and body lines.
+ * @param log - diagnostic sink.
+ */
+export function sendConsole(notice, log) {
+    log(`${notice.title}${notice.lines.length === 0 ? '' : ` — ${notice.lines.join(' · ')}`}`);
+}
+/**
+ * POST the notice to a webhook.
+ * @param payload - the JSON body.
+ * @param url - destination URL.
+ * @param timeoutMs - request budget.
+ * @param log - diagnostic sink.
+ * @returns a promise that settles when the attempt finishes.
+ */
+export async function sendWebhook(payload, url, timeoutMs, log) {
+    if (url === '')
+        return;
+    try {
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        await response.body?.cancel();
+        if (!response.ok)
+            log(`webhook answered ${String(response.status)}`);
+    }
+    catch (error) {
+        log(`webhook failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=channels.js.map

package/lib/types/channels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.js","sourceRoot":"","sources":["../../src/channels.ts"],"names":[],"mappings":"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"}

package/lib/types/decide.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The decision core: whether to notify, and what the notification says.
+ *
+ * Everything here is a pure function so the interesting behaviour — the
+ * "don't be annoying" rules and the text assembly — is testable without a
+ * live harness, a desktop, or a PowerShell.
+ * @module dsh-ping/decide
+ */
+/** The four moments worth interrupting a human for. */
+export type NotifyKind = 'done' | 'error' | 'approval' | 'question';
+/** One observable fact about the harness, ready to be turned into a notice. */
+export interface NotifyFact {
+    kind: NotifyKind;
+    sessionId: string;
+    /** Human title of the session, when the host has one. */
+    sessionTitle?: string;
+    /** Working directory the session runs in. */
+    cwd?: string;
+    /** Kind-specific payload: answer excerpt, error text, tool name, question. */
+    detail?: string;
+    /** Wall-clock duration of the turn that just ended. */
+    durationMs?: number;
+}
+/** The user's "don't be annoying" settings, already resolved. */
+export interface NotifyLimits {
+    enabled: boolean;
+    kinds: Record<NotifyKind, boolean>;
+    /** Only the root agent notifies; delegated subagents stay silent. */
+    rootsOnly: boolean;
+    /** Minimum gap between two notices for the same session and kind. */
+    cooldownMs: number;
+    /** Turns shorter than this are considered interactive and stay silent. */
+    minTurnDurationMs: number;
+    /** Maximum characters of `detail` kept in the notice. */
+    maxBodyChars: number;
+}
+/** Why a notice was or was not emitted. */
+export interface NotifyVerdict {
+    notify: boolean;
+    reason: string;
+}
+/** Inputs to the notification decision. */
+export interface ShouldNotifyInput {
+    fact: NotifyFact;
+    limits: NotifyLimits;
+    isRoot: boolean;
+    /** When this session and kind last produced a notice. */
+    lastNotifiedAt?: number;
+    now: number;
+}
+/**
+ * Decide whether one fact should reach the user.
+ *
+ * Order matters: a disabled kind is a configuration statement, a subagent is a
+ * structural statement, and both outrank the rate limits, so the reported
+ * reason always names the real cause.
+ * @param input - the fact plus the limits and bookkeeping it is judged against.
+ * @returns the verdict and a short reason.
+ */
+export declare function shouldNotify(input: ShouldNotifyInput): NotifyVerdict;
+/** A rendered notice: one heading plus up to two body lines. */
+export interface Notice {
+    title: string;
+    lines: string[];
+}
+/** Per-kind headings, so a deployment can localize or reword them. */
+export type NotifyTitles = Record<NotifyKind, string>;
+/**
+ * Collapse a value into one printable line.
+ *
+ * Newlines are removed rather than kept: the Windows toast path carries text
+ * through an environment variable and a here-string, and a single line cannot
+ * terminate either of them.
+ * @param value - raw text.
+ * @param maxChars - maximum kept characters (0 keeps everything).
+ * @returns the flattened, truncated text.
+ */
+export declare function flatten(value: string, maxChars?: number): string;
+/**
+ * Last path segment, used as a short workspace label.
+ * @param cwd - an absolute working directory.
+ * @returns the final segment, or an empty string.
+ */
+export declare function workspaceOf(cwd: string | undefined): string;
+/**
+ * Human duration, Chinese units to match the default headings.
+ * @param ms - duration in milliseconds.
+ * @returns a compact label such as `2 分 13 秒`.
+ */
+export declare function formatDuration(ms: number | undefined): string;
+/**
+ * Render the notice for one fact.
+ *
+ * Shape: the heading states what happened, the first line carries the payload
+ * (or the session identity when there is none), and the last line always says
+ * which workspace and how long — that is what makes several concurrent
+ * sessions distinguishable at a glance.
+ * @param fact - the fact to render.
+ * @param titles - per-kind headings.
+ * @param maxBodyChars - maximum characters of the payload line.
+ * @returns the notice.
+ */
+export declare function buildNotice(fact: NotifyFact, titles: NotifyTitles, maxBodyChars: number): Notice;
+/**
+ * Escape text for inclusion in the toast XML.
+ * @param value - raw text.
+ * @returns XML-safe text.
+ */
+export declare function escapeXml(value: string): string;
+//# sourceMappingURL=decide.d.ts.map

package/lib/types/decide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/decide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,CAAA;AAEnE,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IAClC,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAA;IAClB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAA;IAClB,0EAA0E;IAC1E,iBAAiB,EAAE,MAAM,CAAA;IACzB,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;IACf,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,aAAa,CAmBpE;AAED,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAED,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAA;AAErD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAQ3D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAM3D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAsBhG;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/C"}

package/lib/types/decide.js

@@ -0,0 +1,145 @@
+/**
+ * The decision core: whether to notify, and what the notification says.
+ *
+ * Everything here is a pure function so the interesting behaviour — the
+ * "don't be annoying" rules and the text assembly — is testable without a
+ * live harness, a desktop, or a PowerShell.
+ * @module dsh-ping/decide
+ */
+/**
+ * Decide whether one fact should reach the user.
+ *
+ * Order matters: a disabled kind is a configuration statement, a subagent is a
+ * structural statement, and both outrank the rate limits, so the reported
+ * reason always names the real cause.
+ * @param input - the fact plus the limits and bookkeeping it is judged against.
+ * @returns the verdict and a short reason.
+ */
+export function shouldNotify(input) {
+    const { fact, limits } = input;
+    if (!limits.enabled)
+        return { notify: false, reason: 'plugin-disabled' };
+    if (!limits.kinds[fact.kind])
+        return { notify: false, reason: `kind-disabled:${fact.kind}` };
+    if (limits.rootsOnly && !input.isRoot)
+        return { notify: false, reason: 'subagent' };
+    if (limits.cooldownMs > 0 && input.lastNotifiedAt !== undefined
+        && input.now - input.lastNotifiedAt < limits.cooldownMs) {
+        return { notify: false, reason: 'cooldown' };
+    }
+    // The duration gate answers one question only: "could the user have walked
+    // away?" A short turn means they were still at the keyboard, so a completion
+    // toast would interrupt someone who is already reading the answer. Errors
+    // and pending decisions are exempt — those are the moments the user asked to
+    // be told about regardless of how long the turn took.
+    if (fact.kind === 'done') {
+        const duration = fact.durationMs ?? 0;
+        if (duration < limits.minTurnDurationMs)
+            return { notify: false, reason: 'too-short' };
+    }
+    return { notify: true, reason: 'ok' };
+}
+/**
+ * Collapse a value into one printable line.
+ *
+ * Newlines are removed rather than kept: the Windows toast path carries text
+ * through an environment variable and a here-string, and a single line cannot
+ * terminate either of them.
+ * @param value - raw text.
+ * @param maxChars - maximum kept characters (0 keeps everything).
+ * @returns the flattened, truncated text.
+ */
+export function flatten(value, maxChars = 0) {
+    const cleaned = value
+        // eslint-disable-next-line no-control-regex -- control characters break the toast carrier.
+        .replace(/[\u0000-\u001f\u007f]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+    if (maxChars <= 0 || cleaned.length <= maxChars)
+        return cleaned;
+    return `${cleaned.slice(0, Math.max(1, maxChars - 1)).trimEnd()}…`;
+}
+/**
+ * Last path segment, used as a short workspace label.
+ * @param cwd - an absolute working directory.
+ * @returns the final segment, or an empty string.
+ */
+export function workspaceOf(cwd) {
+    if (cwd === undefined)
+        return '';
+    const trimmed = cwd.replace(/[\\/]+$/, '');
+    if (trimmed === '')
+        return '';
+    const parts = trimmed.split(/[\\/]/);
+    return parts[parts.length - 1] ?? '';
+}
+/**
+ * Human duration, Chinese units to match the default headings.
+ * @param ms - duration in milliseconds.
+ * @returns a compact label such as `2 分 13 秒`.
+ */
+export function formatDuration(ms) {
+    if (ms === undefined || !Number.isFinite(ms) || ms < 0)
+        return '';
+    const totalSeconds = Math.round(ms / 1000);
+    if (totalSeconds < 60)
+        return `${String(totalSeconds)} 秒`;
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    if (minutes < 60)
+        return seconds === 0 ? `${String(minutes)} 分` : `${String(minutes)} 分 ${String(seconds)} 秒`;
+    const hours = Math.floor(minutes / 60);
+    const rest = minutes % 60;
+    return rest === 0 ? `${String(hours)} 小时` : `${String(hours)} 小时 ${String(rest)} 分`;
+}
+/**
+ * Render the notice for one fact.
+ *
+ * Shape: the heading states what happened, the first line carries the payload
+ * (or the session identity when there is none), and the last line always says
+ * which workspace and how long — that is what makes several concurrent
+ * sessions distinguishable at a glance.
+ * @param fact - the fact to render.
+ * @param titles - per-kind headings.
+ * @param maxBodyChars - maximum characters of the payload line.
+ * @returns the notice.
+ */
+export function buildNotice(fact, titles, maxBodyChars) {
+    const title = titles[fact.kind];
+    const workspace = workspaceOf(fact.cwd);
+    const subject = flatten(fact.sessionTitle ?? '', 80) || workspace || 'DSH 会话';
+    const detail = fact.detail === undefined ? '' : flatten(fact.detail, maxBodyChars);
+    // The workspace is already the subject when the session has no title;
+    // repeating it in the attribution line reads as a bug to the user.
+    const meta = [
+        workspace === subject ? '' : workspace,
+        formatDuration(fact.durationMs),
+    ].filter(part => part !== '').join(' · ');
+    const lines = [];
+    if (detail !== '') {
+        lines.push(detail);
+        const attribution = [subject, meta].filter(part => part !== '').join(' · ');
+        if (attribution !== '')
+            lines.push(attribution);
+    }
+    else {
+        lines.push(subject);
+        if (meta !== '' && meta !== subject)
+            lines.push(meta);
+    }
+    return { title, lines: lines.slice(0, 2) };
+}
+/**
+ * Escape text for inclusion in the toast XML.
+ * @param value - raw text.
+ * @returns XML-safe text.
+ */
+export function escapeXml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+//# sourceMappingURL=decide.js.map

package/lib/types/decide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decide.js","sourceRoot":"","sources":["../../src/decide.ts"],"names":[],"mappings":"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"}

package/lib/types/defaults.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Configuration shape and defaults.
+ *
+ * Kept free of every runtime import — including the schema library — so the
+ * standalone smoke test can reuse the defaults without pulling a
+ * `@deepseek-ai/*` module into a CLI that has to run outside the harness.
+ * @module dsh-ping/defaults
+ */
+import type { NotifyKind, NotifyTitles } from './decide.ts';
+/** Plugin configuration. */
+export interface Config {
+    /** Master switch. */
+    enabled: boolean;
+    /** Which moments notify. */
+    notifyOn: Record<NotifyKind, boolean>;
+    /** Only the root agent notifies; delegated subagents stay silent. */
+    rootsOnly: boolean;
+    /** Minimum gap between two notices for the same session and kind. */
+    cooldownMs: number;
+    /**
+     * Completed turns shorter than this stay silent, because the user was still
+     * at the keyboard. Applies to `done` only: errors and pending decisions
+     * always notify. Set to 0 to be told about every turn.
+     */
+    minTurnDurationMs: number;
+    /** Enabled delivery channels. */
+    channels: {
+        toast: boolean;
+        console: boolean;
+        webhook: boolean;
+    };
+    /** Webhook destination; empty disables the channel even when enabled. */
+    webhookUrl: string;
+    /** Webhook request budget. */
+    webhookTimeoutMs: number;
+    /** Click-through URL; empty derives the loopback Web URL when one exists. */
+    url: string;
+    /** Maximum characters of the payload line. */
+    maxBodyChars: number;
+    /** AUMID the toast is attributed to; empty uses the Windows PowerShell identity. */
+    toastAppId: string;
+    /** Sound for completed turns and errors. */
+    toastSoundDone: string;
+    /** Sound for pending approvals and questions. */
+    toastSoundAttention: string;
+    /** Explicit Windows PowerShell 5.1 path; empty resolves the in-box one. */
+    powershellPath: string;
+    /** Per-moment headings. */
+    titles: NotifyTitles;
+    /** Log every suppressed notice and its reason. */
+    debug: boolean;
+}
+/** The defaults, restated by the schema in `index.ts` so the loader applies them too. */
+export declare const DEFAULTS: Config;
+/**
+ * Merge a partially applied configuration over the defaults.
+ *
+ * The loader normally hands over a fully defaulted object, but a deployment
+ * that instantiates the plugin directly should not have to.
+ * @param config - raw configuration.
+ * @returns a complete configuration.
+ */
+export declare function resolveConfig(config: Partial<Config> | undefined): Config;
+//# sourceMappingURL=defaults.d.ts.map

package/lib/types/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE3D,4BAA4B;AAC5B,MAAM,WAAW,MAAM;IACrB,qBAAqB;IACrB,OAAO,EAAE,OAAO,CAAA;IAChB,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IACrC,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAA;IAClB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,iCAAiC;IACjC,QAAQ,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAA;IAChE,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAA;IAClB,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAA;IACxB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAA;IACpB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAA;IAClB,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAA;IACtB,iDAAiD;IACjD,mBAAmB,EAAE,MAAM,CAAA;IAC3B,2EAA2E;IAC3E,cAAc,EAAE,MAAM,CAAA;IACtB,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAA;IACpB,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAA;CACf;AAED,yFAAyF;AACzF,eAAO,MAAM,QAAQ,EAAE,MAsBtB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CASzE"}

package/lib/types/defaults.js

@@ -0,0 +1,51 @@
+/**
+ * Configuration shape and defaults.
+ *
+ * Kept free of every runtime import — including the schema library — so the
+ * standalone smoke test can reuse the defaults without pulling a
+ * `@deepseek-ai/*` module into a CLI that has to run outside the harness.
+ * @module dsh-ping/defaults
+ */
+/** The defaults, restated by the schema in `index.ts` so the loader applies them too. */
+export const DEFAULTS = {
+    enabled: true,
+    notifyOn: { done: true, error: true, approval: true, question: true },
+    rootsOnly: true,
+    cooldownMs: 30_000,
+    minTurnDurationMs: 20_000,
+    channels: { toast: true, console: true, webhook: false },
+    webhookUrl: '',
+    webhookTimeoutMs: 5_000,
+    url: '',
+    maxBodyChars: 180,
+    toastAppId: '',
+    toastSoundDone: 'ms-winsoundevent:Notification.Default',
+    toastSoundAttention: 'ms-winsoundevent:Notification.Reminder',
+    powershellPath: '',
+    titles: {
+        done: 'DSH · 任务完成',
+        error: 'DSH · 出错了',
+        approval: 'DSH · 等你批准',
+        question: 'DSH · 等你回答',
+    },
+    debug: false,
+};
+/**
+ * Merge a partially applied configuration over the defaults.
+ *
+ * The loader normally hands over a fully defaulted object, but a deployment
+ * that instantiates the plugin directly should not have to.
+ * @param config - raw configuration.
+ * @returns a complete configuration.
+ */
+export function resolveConfig(config) {
+    const source = config ?? {};
+    return {
+        ...DEFAULTS,
+        ...source,
+        notifyOn: { ...DEFAULTS.notifyOn, ...source.notifyOn },
+        channels: { ...DEFAULTS.channels, ...source.channels },
+        titles: { ...DEFAULTS.titles, ...source.titles },
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/lib/types/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/defaults.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA4CH,yFAAyF;AACzF,MAAM,CAAC,MAAM,QAAQ,GAAW;IAC9B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE;IACrE,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,MAAM;IAClB,iBAAiB,EAAE,MAAM;IACzB,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE;IACxD,UAAU,EAAE,EAAE;IACd,gBAAgB,EAAE,KAAK;IACvB,GAAG,EAAE,EAAE;IACP,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE,EAAE;IACd,cAAc,EAAE,uCAAuC;IACvD,mBAAmB,EAAE,wCAAwC;IAC7D,cAAc,EAAE,EAAE;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,WAAW;QAClB,QAAQ,EAAE,YAAY;QACtB,QAAQ,EAAE,YAAY;KACvB;IACD,KAAK,EAAE,KAAK;CACb,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,MAAmC;IAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAA;IAC3B,OAAO;QACL,GAAG,QAAQ;QACX,GAAG,MAAM;QACT,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;QACtD,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE;QACtD,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE;KACjD,CAAA;AACH,CAAC"}

package/lib/types/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * dsh-ping — desktop notifications for DeepSeek Harness.
+ *
+ * Watches four host moments and tells a human about them: a turn finished, an
+ * agent errored, an approval is pending, or the agent asked a question. The
+ * delivery is a Windows toast (plus a console line and an optional webhook).
+ *
+ * The plugin is host-only and imports exactly one `@deepseek-ai/*` module —
+ * `schemastery`, the configuration schema library — at runtime. It has no
+ * browser half, so it cannot affect what the Web client loads, and no
+ * `dsh-*` internals, so renaming one cannot break it.
+ * @module dsh-ping
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import z from '@deepseek-ai/schemastery';
+import { type Config as PingConfig } from './defaults.ts';
+/** Stable Cordis plugin name. */
+export declare const name = "dsh-ping";
+/** No service is required: every host fact is read optionally. */
+export declare const inject: string[];
+/**
+ * The configuration schema.
+ *
+ * Every default is written twice on purpose — once here so the loader can
+ * validate and fill a partial user config, and once in `defaults.ts` so the
+ * dependency-free smoke test shares the same values.
+ */
+export declare const Config: z<PingConfig>;
+export { DEFAULTS, resolveConfig } from './defaults.ts';
+/**
+ * Register the notification plugin.
+ * @param ctx - the plugin context.
+ * @param config - resolved plugin configuration.
+ */
+export declare function apply(ctx: Context, config: PingConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC,OAAO,EAA2B,KAAK,MAAM,IAAI,UAAU,EAAE,MAAM,eAAe,CAAA;AASlF,iCAAiC;AACjC,eAAO,MAAM,IAAI,aAAa,CAAA;AAE9B,kEAAkE;AAClE,eAAO,MAAM,MAAM,EAAE,MAAM,EAAO,CAAA;AAElC;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,UAAU,CA+B/B,CAAA;AAEF,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAYvD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAiR5D"}