@vanadium-23/dsh-ping 0.1.0

package/lib/types/index.js

@@ -0,0 +1,330 @@
+/**
+ * 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 z from '@deepseek-ai/schemastery';
+import { buildNotice, shouldNotify } from "./decide.js";
+import { DEFAULTS, resolveConfig } from "./defaults.js";
+import { sendConsole, sendToast, sendWebhook } from "./channels.js";
+import { agentKey, cwdOf, errorText, isRootAgent, sessionKey, textOfMessage, } from "./protocol.js";
+/** Stable Cordis plugin name. */
+export const name = 'dsh-ping';
+/** No service is required: every host fact is read optionally. */
+export const inject = [];
+/**
+ * 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 const Config = z.object({
+    enabled: z.boolean().default(DEFAULTS.enabled),
+    notifyOn: z.object({
+        done: z.boolean().default(DEFAULTS.notifyOn.done),
+        error: z.boolean().default(DEFAULTS.notifyOn.error),
+        approval: z.boolean().default(DEFAULTS.notifyOn.approval),
+        question: z.boolean().default(DEFAULTS.notifyOn.question),
+    }).default(DEFAULTS.notifyOn),
+    rootsOnly: z.boolean().default(DEFAULTS.rootsOnly),
+    cooldownMs: z.natural().default(DEFAULTS.cooldownMs),
+    minTurnDurationMs: z.natural().default(DEFAULTS.minTurnDurationMs),
+    channels: z.object({
+        toast: z.boolean().default(DEFAULTS.channels.toast),
+        console: z.boolean().default(DEFAULTS.channels.console),
+        webhook: z.boolean().default(DEFAULTS.channels.webhook),
+    }).default(DEFAULTS.channels),
+    webhookUrl: z.string().default(DEFAULTS.webhookUrl),
+    webhookTimeoutMs: z.natural().default(DEFAULTS.webhookTimeoutMs),
+    url: z.string().default(DEFAULTS.url),
+    maxBodyChars: z.natural().default(DEFAULTS.maxBodyChars),
+    toastAppId: z.string().default(DEFAULTS.toastAppId),
+    toastSoundDone: z.string().default(DEFAULTS.toastSoundDone),
+    toastSoundAttention: z.string().default(DEFAULTS.toastSoundAttention),
+    powershellPath: z.string().default(DEFAULTS.powershellPath),
+    titles: z.object({
+        done: z.string().default(DEFAULTS.titles.done),
+        error: z.string().default(DEFAULTS.titles.error),
+        approval: z.string().default(DEFAULTS.titles.approval),
+        question: z.string().default(DEFAULTS.titles.question),
+    }).default(DEFAULTS.titles),
+    debug: z.boolean().default(DEFAULTS.debug),
+});
+export { DEFAULTS, resolveConfig } from "./defaults.js";
+/** Most recently rendered assistant text, keyed by session. */
+const ASSISTANT_CACHE_LIMIT = 64;
+/**
+ * Register the notification plugin.
+ * @param ctx - the plugin context.
+ * @param config - resolved plugin configuration.
+ */
+export function apply(ctx, config) {
+    const cfg = resolveConfig(config);
+    const host = ctx;
+    const log = (line) => { process.stderr.write(`[dsh-ping] ${line}\n`); };
+    if (!cfg.enabled) {
+        log('disabled by configuration');
+        return;
+    }
+    const limits = {
+        enabled: cfg.enabled,
+        kinds: { ...cfg.notifyOn },
+        rootsOnly: cfg.rootsOnly,
+        cooldownMs: cfg.cooldownMs,
+        minTurnDurationMs: cfg.minTurnDurationMs,
+        maxBodyChars: cfg.maxBodyChars,
+    };
+    const turns = new Map();
+    const lastNotified = new Map();
+    const lastAssistant = new Map();
+    /** The URL a toast click opens. */
+    const clickUrl = () => {
+        if (cfg.url !== '')
+            return cfg.url;
+        const server = host.get('webServer');
+        const port = server?.port;
+        if (typeof port !== 'number' || port <= 0)
+            return '';
+        const bound = typeof server?.host === 'string' ? server.host : '';
+        const address = bound === '0.0.0.0' || bound === '' ? '127.0.0.1' : bound;
+        return `http://${address}:${String(port)}/`;
+    };
+    /** The host's title for a session, when a title service is mounted. */
+    const titleOf = (session) => {
+        // Guarded on its own: a title projection that throws (an unknown session
+        // shape, a provider mid-rebuild) must cost the title, not the notice.
+        try {
+            const service = host.get('sessionTitle');
+            const title = service?.get(session)?.title;
+            return typeof title === 'string' ? title : '';
+        }
+        catch {
+            return '';
+        }
+    };
+    const toastDelivery = (attention) => ({
+        appId: cfg.toastAppId,
+        url: clickUrl(),
+        sound: attention ? cfg.toastSoundAttention : cfg.toastSoundDone,
+        long: attention,
+        ...(cfg.powershellPath === '' ? {} : { powershellPath: cfg.powershellPath }),
+    });
+    /**
+     * Apply the rate limits, render the notice, and hand it to the channels.
+     * @param fact - what happened.
+     * @param isRoot - whether the agent owns its session.
+     */
+    const deliver = (fact, isRoot) => {
+        const now = Date.now();
+        const key = `${fact.sessionId}:${fact.kind}`;
+        const lastNotifiedAt = lastNotified.get(key);
+        const verdict = shouldNotify({
+            fact,
+            limits,
+            isRoot,
+            ...(lastNotifiedAt === undefined ? {} : { lastNotifiedAt }),
+            now,
+        });
+        if (!verdict.notify) {
+            if (cfg.debug)
+                log(`suppressed ${fact.kind} (${verdict.reason})`);
+            return;
+        }
+        lastNotified.set(key, now);
+        const notice = buildNotice(fact, cfg.titles, cfg.maxBodyChars);
+        if (cfg.channels.console)
+            sendConsole(notice, log);
+        if (cfg.channels.toast) {
+            const attention = fact.kind === 'approval' || fact.kind === 'question';
+            sendToast(notice, toastDelivery(attention), log);
+        }
+        if (cfg.channels.webhook && cfg.webhookUrl !== '') {
+            void sendWebhook({ kind: fact.kind, title: notice.title, lines: notice.lines, sessionId: fact.sessionId, at: new Date(now).toISOString() }, cfg.webhookUrl, cfg.webhookTimeoutMs, log);
+        }
+    };
+    /** Identity used for bookkeeping and rate limiting. */
+    const identityOf = (agent) => {
+        const key = agentKey(agent);
+        const sessionId = sessionKey(agent?.session) || key;
+        return { key, sessionId };
+    };
+    const onStatus = (payload) => {
+        const agent = payload.agent;
+        const { key, sessionId } = identityOf(agent);
+        if (key === '')
+            return;
+        if (payload.status === 'running') {
+            turns.set(key, { startedAt: Date.now(), sawError: false, reported: false });
+            return;
+        }
+        if (payload.status !== 'idle')
+            return;
+        const turn = turns.get(key);
+        turns.delete(key);
+        if (turn === undefined)
+            return;
+        // An error already raised its own notice for this turn.
+        if (turn.sawError && turn.reported)
+            return;
+        const cwd = cwdOf(agent?.session);
+        deliver({
+            kind: 'done',
+            sessionId,
+            sessionTitle: titleOf(agent?.session),
+            cwd,
+            ...(lastAssistant.has(sessionId) ? { detail: lastAssistant.get(sessionId) } : {}),
+            durationMs: Date.now() - turn.startedAt,
+        }, isRootAgent(agent));
+    };
+    const onError = (payload) => {
+        const agent = payload.agent;
+        const { key, sessionId } = identityOf(agent);
+        const turn = turns.get(key);
+        if (turn !== undefined) {
+            turn.sawError = true;
+            turn.reported = true;
+        }
+        deliver({
+            kind: 'error',
+            sessionId,
+            sessionTitle: titleOf(agent?.session),
+            cwd: cwdOf(agent?.session),
+            detail: errorText(payload.error),
+        }, isRootAgent(agent));
+    };
+    const onApproval = (payload) => {
+        const agent = payload.agent;
+        const { sessionId } = identityOf(agent);
+        const toolName = typeof payload.toolName === 'string' ? payload.toolName : '';
+        const reason = typeof payload.reason === 'string' ? payload.reason : '';
+        deliver({
+            kind: 'approval',
+            sessionId,
+            sessionTitle: titleOf(agent?.session),
+            cwd: cwdOf(agent?.session),
+            detail: [toolName, reason].filter(part => part !== '').join(' — '),
+        }, isRootAgent(agent));
+    };
+    const onQuestion = (payload) => {
+        const agent = payload.agent;
+        const { sessionId } = identityOf(agent);
+        const items = Array.isArray(payload.questions) ? payload.questions : [];
+        const first = items[0];
+        const text = typeof first?.question === 'string' ? first.question : '';
+        deliver({
+            kind: 'question',
+            sessionId,
+            sessionTitle: titleOf(agent?.session),
+            cwd: cwdOf(agent?.session),
+            detail: items.length > 1 ? `${text}（共 ${String(items.length)} 个问题）` : text,
+        }, isRootAgent(agent));
+    };
+    /** Keep the last assistant text so a completion notice can quote it. */
+    const rememberAssistant = (session, event) => {
+        if (event.type !== 'assistant/message')
+            return;
+        const id = sessionKey(session);
+        if (id === '')
+            return;
+        const text = textOfMessage(event.data?.message);
+        if (text.trim() === '')
+            return;
+        lastAssistant.delete(id);
+        lastAssistant.set(id, text);
+        while (lastAssistant.size > ASSISTANT_CACHE_LIMIT) {
+            const oldest = lastAssistant.keys().next().value;
+            if (oldest === undefined)
+                break;
+            lastAssistant.delete(oldest);
+        }
+    };
+    /** Run a handler without ever letting it reach the caller. */
+    const guard = (label, run) => {
+        try {
+            run();
+        }
+        catch (error) {
+            log(`${label} handler failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    };
+    host.on('agent/status', (payload) => { guard('agent/status', () => { onStatus(payload); }); });
+    host.on('agent/error', (payload) => { guard('agent/error', () => { onError(payload); }); });
+    host.on('session/event', (session, event) => {
+        guard('session/event', () => { rememberAssistant(session, event); });
+    });
+    // Both are waterfalls: notifying must not change who answers them, so the
+    // listener always delegates — and prepends, because an answerer registered
+    // earlier would otherwise claim the request before this plugin ever saw it.
+    host.on('approval/request', (payload, next) => {
+        guard('approval/request', () => { onApproval(payload); });
+        return next();
+    }, { prepend: true });
+    host.on('user-questions/request', (payload, next) => {
+        guard('user-questions/request', () => { onQuestion(payload); });
+        return next();
+    }, { prepend: true });
+    /**
+     * Register a self-test tool so the channel can be verified from inside a
+     * session, without a terminal and without waiting for a real turn to end.
+     */
+    const registerTestTool = (scope) => {
+        const tools = scope.get('tools');
+        if (tools === undefined || typeof tools.register !== 'function')
+            return;
+        tools.register({
+            name: 'dsh_ping_test',
+            description: 'Send a test desktop notification through dsh-ping and report which channels accepted it. Use this to '
+                + 'verify that turn-completion and attention notifications will actually reach the user, or when the user '
+                + 'asks whether notifications work.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    text: { type: 'string', description: 'Optional body text for the test notification.' },
+                },
+                required: [],
+            },
+            output: {
+                schema: { type: 'string' },
+                render: (_args, value) => [{ type: 'text', text: String(value) }],
+            },
+            async execute(args) {
+                const text = typeof args?.text === 'string' && args.text.trim() !== ''
+                    ? args.text
+                    : '这是一条 dsh-ping 自检通知，看到它就说明通知链路是通的。';
+                const notice = buildNotice({ kind: 'done', sessionId: 'self-test', sessionTitle: 'dsh-ping 自检', detail: text }, cfg.titles, cfg.maxBodyChars);
+                const accepted = [];
+                if (cfg.channels.console) {
+                    sendConsole(notice, log);
+                    accepted.push('console');
+                }
+                if (cfg.channels.toast) {
+                    accepted.push(sendToast(notice, toastDelivery(false), log) ? 'toast' : 'toast（不可用）');
+                }
+                if (cfg.channels.webhook && cfg.webhookUrl !== '') {
+                    accepted.push('webhook');
+                    await sendWebhook({ kind: 'test', title: notice.title, lines: notice.lines, sessionId: 'self-test', at: new Date().toISOString() }, cfg.webhookUrl, cfg.webhookTimeoutMs, log);
+                }
+                return `dsh-ping 自检：已通过 ${accepted.join(' + ') || '（无可用通道）'} 发送「${notice.title}」`;
+            },
+        });
+    };
+    if (typeof host.inject === 'function')
+        host.inject(['tools'], registerTestTool);
+    else
+        registerTestTool(host);
+    const enabled = Object.entries(cfg.channels)
+        .filter(([, on]) => on)
+        .map(([channel]) => channel)
+        .join('+');
+    log(`ready — channels=${enabled} rootsOnly=${String(cfg.rootsOnly)} cooldown=${String(cfg.cooldownMs)}ms`);
+}
+//# sourceMappingURL=index.js.map

package/lib/types/index.js.map

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

package/lib/types/protocol.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Local, structural views of the host facts this plugin consumes.
+ *
+ * Nothing here imports a `@deepseek-ai/dsh-*` package. That is deliberate and
+ * is the whole compatibility story: an out-of-tree plugin that named an
+ * internal package broke on this machine when `@deepseek-ai/dsh-client-runtime`
+ * was renamed, so this one only ever reaches the host through shapes it
+ * declares itself, and treats every field as optional.
+ * @module dsh-ping/protocol
+ */
+/** The subset of a cordis `Context` this plugin uses. */
+export interface LooseContext {
+    on(name: string, listener: (...args: any[]) => any, options?: {
+        prepend?: boolean;
+    }): unknown;
+    get<T = unknown>(name: string): T | undefined;
+    inject?(names: string[], callback: (scope: LooseContext) => void): unknown;
+}
+/** A session as far as notifications are concerned. */
+export interface SessionLike {
+    id?: unknown;
+    cwd?: unknown;
+}
+/** An agent as far as notifications are concerned. */
+export interface AgentLike {
+    id?: unknown;
+    session?: SessionLike;
+    /** Present on subagents; absent on the root agent that owns a session. */
+    parentAgent?: unknown;
+    options?: {
+        origin?: unknown;
+    };
+}
+/** `agent/status` payload. */
+export interface AgentStatusPayload {
+    agent?: AgentLike;
+    status?: unknown;
+}
+/** `agent/error` payload. */
+export interface AgentErrorPayload {
+    agent?: AgentLike;
+    error?: unknown;
+}
+/** `approval/request` payload. */
+export interface ApprovalRequestPayload {
+    agent?: AgentLike;
+    toolName?: unknown;
+    reason?: unknown;
+}
+/** One question inside a `user-questions/request` payload. */
+export interface QuestionItem {
+    id?: unknown;
+    question?: unknown;
+    header?: unknown;
+}
+/** `user-questions/request` payload. */
+export interface UserQuestionPayload {
+    agent?: AgentLike;
+    questions?: unknown;
+}
+/** One durable session event, narrowed to the fields used here. */
+export interface SessionEventLike {
+    type?: unknown;
+    data?: {
+        message?: unknown;
+    };
+}
+/** `ctx.sessionTitle` service. */
+export interface SessionTitleLike {
+    get(session: unknown): {
+        title?: unknown;
+    } | undefined;
+}
+/** `ctx.webServer` service. */
+export interface WebServerLike {
+    port?: unknown;
+    host?: unknown;
+}
+/** `ctx.tools` service. */
+export interface ToolsLike {
+    register(tool: unknown): unknown;
+}
+/**
+ * Narrow an unknown thrown value to a one-line message.
+ * @param error - the thrown value.
+ * @returns a single-line description.
+ */
+export declare function errorText(error: unknown): string;
+/**
+ * Extract the visible text of an assistant message.
+ * @param message - an unknown message value.
+ * @returns concatenated text blocks, or an empty string.
+ */
+export declare function textOfMessage(message: unknown): string;
+/**
+ * Whether an agent owns its session outright (the root agent) rather than
+ * being a delegated subagent.
+ * @param agent - the agent to classify.
+ * @returns true for the root agent.
+ */
+export declare function isRootAgent(agent: AgentLike | undefined): boolean;
+/**
+ * Stable identity for one agent, used as the bookkeeping key.
+ * @param agent - the agent to identify.
+ * @returns the agent id, its session id, or an empty string.
+ */
+export declare function agentKey(agent: AgentLike | undefined): string;
+/**
+ * Stable identity for one session.
+ * @param session - the session to identify.
+ * @returns the session id, or an empty string.
+ */
+export declare function sessionKey(session: unknown): string;
+/**
+ * Read the working directory recorded on a session or agent.
+ * @param value - a session-like value.
+ * @returns the cwd, or an empty string.
+ */
+export declare function cwdOf(value: {
+    cwd?: unknown;
+} | undefined): string;
+//# sourceMappingURL=protocol.d.ts.map

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

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

package/lib/types/protocol.js

@@ -0,0 +1,107 @@
+/**
+ * Local, structural views of the host facts this plugin consumes.
+ *
+ * Nothing here imports a `@deepseek-ai/dsh-*` package. That is deliberate and
+ * is the whole compatibility story: an out-of-tree plugin that named an
+ * internal package broke on this machine when `@deepseek-ai/dsh-client-runtime`
+ * was renamed, so this one only ever reaches the host through shapes it
+ * declares itself, and treats every field as optional.
+ * @module dsh-ping/protocol
+ */
+/**
+ * Narrow an unknown thrown value to a one-line message.
+ * @param error - the thrown value.
+ * @returns a single-line description.
+ */
+export function errorText(error) {
+    if (error === undefined || error === null)
+        return '';
+    if (typeof error === 'string')
+        return error;
+    if (error instanceof Error)
+        return error.message;
+    const message = error.message;
+    if (typeof message === 'string')
+        return message;
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}
+/**
+ * Extract the visible text of an assistant message.
+ * @param message - an unknown message value.
+ * @returns concatenated text blocks, or an empty string.
+ */
+export function textOfMessage(message) {
+    if (typeof message !== 'object' || message === null)
+        return '';
+    const content = message.content;
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    const parts = [];
+    for (const block of content) {
+        if (typeof block !== 'object' || block === null)
+            continue;
+        const candidate = block;
+        if (candidate.type === 'text' && typeof candidate.text === 'string')
+            parts.push(candidate.text);
+    }
+    return parts.join('\n');
+}
+/**
+ * Whether an agent owns its session outright (the root agent) rather than
+ * being a delegated subagent.
+ * @param agent - the agent to classify.
+ * @returns true for the root agent.
+ */
+export function isRootAgent(agent) {
+    if (agent === undefined)
+        return true;
+    if (agent.parentAgent !== undefined && agent.parentAgent !== null)
+        return false;
+    return agent.options?.origin !== 'subagent';
+}
+/**
+ * Stable identity for one agent, used as the bookkeeping key.
+ * @param agent - the agent to identify.
+ * @returns the agent id, its session id, or an empty string.
+ */
+export function agentKey(agent) {
+    const id = agent?.id;
+    if (typeof id === 'string' && id.length > 0)
+        return id;
+    if (typeof id === 'number')
+        return String(id);
+    const sessionId = agent?.session?.id;
+    if (typeof sessionId === 'string' && sessionId.length > 0)
+        return sessionId;
+    return '';
+}
+/**
+ * Stable identity for one session.
+ * @param session - the session to identify.
+ * @returns the session id, or an empty string.
+ */
+export function sessionKey(session) {
+    const id = session?.id;
+    if (typeof id === 'string' && id.length > 0)
+        return id;
+    if (typeof id === 'number')
+        return String(id);
+    return '';
+}
+/**
+ * Read the working directory recorded on a session or agent.
+ * @param value - a session-like value.
+ * @returns the cwd, or an empty string.
+ */
+export function cwdOf(value) {
+    const cwd = value?.cwd;
+    return typeof cwd === 'string' ? cwd : '';
+}
+//# sourceMappingURL=protocol.js.map

package/lib/types/protocol.js.map

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

package/lib/types/smoke.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Standalone toast smoke test — no harness required.
+ *
+ * `node lib/smoke.js [text]` raises one real Windows toast with the exact code
+ * path the plugin uses, which is how the notification channel gets verified on
+ * a machine without starting a session.
+ * @module dsh-ping/smoke
+ */
+/**
+ * Raise one test toast.
+ * @param argv - words appended to the default body text.
+ * @returns the process exit code.
+ */
+export declare function runSmoke(argv: readonly string[]): number;
+/** The configured default headings, exported for the CLI banner. */
+export declare const SMOKE_TITLES: import("./decide.ts").NotifyTitles;
+//# sourceMappingURL=smoke.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"smoke.d.ts","sourceRoot":"","sources":["../../src/smoke.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CA2BxD;AAED,oEAAoE;AACpE,eAAO,MAAM,YAAY,oCAAkB,CAAA"}