dsh-mishu 0.7.3 → 0.7.4

package/lib/types/dsh/schedule.d.ts

@@ -0,0 +1,113 @@
+/**
+ * The bridge to DSH's own Schedule service (`@deepseek-ai/dsh-schedule`, the
+ * "自动化任务" page).
+ *
+ * Two directions, both kept small on purpose:
+ *
+ * - The daily brief can be handed to Schedule: the same text the desktop
+ *   notification carries, delivered as a turn in a conversation instead. That
+ *   is the one task the secretary creates on its own, and it is marked in its
+ *   prompt so a later visit recognises it even after you edited the title.
+ * - Every task on the Host is listed for the settings page, so what the
+ *   secretary scheduled and what you scheduled yourself sit in one place.
+ *
+ * Schedule is optional: a Host without the service simply has no bridge, and
+ * the page says so instead of offering a button that cannot work.
+ */
+import { type ScheduleEntry, type ScheduleTaskView } from '../core/index.ts';
+import type { Lang } from '../core/i18n.ts';
+import type { MishuStore } from '../core/store.ts';
+/** The slice of `ScheduleService` this plugin uses. */
+export interface ScheduleLike {
+    list(request?: {
+        active?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: ScheduleEntry[];
+        shown: number;
+        total: number;
+    }>;
+    view(request: {
+        id: string;
+    }): Promise<ScheduleEntry | {
+        id: string;
+        code: string;
+    }>;
+    create(request: {
+        title: string;
+        prompt: string;
+        timing: Record<string, unknown>;
+        target?: Record<string, unknown>;
+    }): Promise<ScheduleEntry | {
+        id: string;
+        code: string;
+    }>;
+    edit(request: {
+        id: string;
+        action: 'update' | 'delete';
+        patch?: Record<string, unknown>;
+        expectedUpdatedAt?: string;
+    }): Promise<ScheduleEntry | {
+        id: string;
+        code: string;
+        deleted?: boolean;
+    }>;
+    run(request: {
+        id: string;
+    }): Promise<ScheduleEntry | {
+        id: string;
+        code: string;
+    }>;
+}
+export interface ScheduleView {
+    /** False when this Host has no Schedule service: the page then explains instead of offering buttons. */
+    available: boolean;
+    tasks: ScheduleTaskView[];
+    brief: {
+        /** The task id this notebook created, if it is still on the Host. */
+        id: string | null;
+        /** The brief's time, as the reminder settings have it. */
+        time: string;
+        timeZone: string;
+        /** Whether the brief is currently armed as a task. */
+        armed: boolean;
+        /** Last thing the service said when it was asked to arm it, if it failed. */
+        error: string | null;
+    };
+}
+export declare class ScheduleBridge {
+    private service;
+    private readonly store;
+    private readonly lang;
+    /** The brief's time and zone, as the reminder settings hold them. */
+    private readonly briefClock;
+    constructor(service: ScheduleLike, store: () => MishuStore | undefined, lang: () => Lang, briefClock: () => {
+        time: string;
+        timeZone: string;
+    });
+    /** A restarted service: same bridge, new handle. */
+    replace(service: ScheduleLike): void;
+    /** The page's language when it asked, else the notebook's. A task's wording is read by a person, not logged. */
+    private useLang;
+    private savedId;
+    /** Every task on the Host, newest rules first, plus whether the brief is armed. */
+    view(asked?: Lang): Promise<ScheduleView>;
+    /**
+     * Arm the brief as a daily task, or move it when the time changed. Reuses
+     * the task it made before — editing it in the automation page keeps it.
+     */
+    armBrief(asked?: Lang): Promise<ScheduleView>;
+    /**
+     * Move the brief when its time changed on the settings page, and say
+     * nothing when it was never armed. Errors are kept, not thrown: this runs
+     * behind a save that has already succeeded.
+     */
+    followBrief(asked?: Lang): Promise<void>;
+    /** Take the brief task off the Host; the desktop notification is unaffected. */
+    disarmBrief(asked?: Lang): Promise<ScheduleView>;
+    /** Delete any task on the Host — the secretary only ever deletes its own, but the page lists all. */
+    delete(id: string, asked?: Lang): Promise<ScheduleView>;
+    /** Run a task now, without waiting for its time. */
+    run(id: string, asked?: Lang): Promise<ScheduleView>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mishu",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "DSH secretary (小秘书) for DeepSeek Harness (dsh): watches GitHub notifications and the dated things you tell it (bills, renewals, documents, birthdays), closes what is already resolved, and keeps a short list of what actually needs you. Bilingual (中文 / English), macOS / Windows / Linux. · DSH 小秘书：提醒、通知、待办、消息、收件箱、秘书。GitHub 通知按当前状态分诊，交代一句就记下到期和周期事项。",
   "type": "module",
   "main": "lib/index.js",