@deepseek-ai/dsh-client-ui-schedule 0.1.7-alpha.2 → 0.1.7-rc.2

package/lib/types/client/task-tab-bindings.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Durable recovery for a restored task tab.
+ *
+ * The Sidebar persists a tab's layout record — its own id, kind, contentId, and
+ * title — but not the opener's navigation parameters, so a task tab restored by
+ * a reload carries no task identity and its body can only report feedback. This
+ * page type therefore keeps what it last showed, keyed by the Session and the
+ * layout record's id: the persisted layout restores both, and its minted counter
+ * never reuses an id for as long as that layout lives, so the association
+ * outlives the reload that dropped the parameters. The contentId cannot serve as
+ * this key because every tab of one page kind records the same one.
+ *
+ * One storage key per Session holds one entry per tab id. A write keeps only
+ * entries whose tab a non-empty list of committed ids contains; a read reports a
+ * target only when the entry's kind and contentId match the record reading it,
+ * and leaves the document untouched, so the drop of a mismatched entry is a
+ * separate call a render effect makes. A body removes an entry a read that
+ * succeeded after the tab appeared cannot resolve. Only the task's Session and id are stored; its name, instruction, and
+ * deliveries are not.
+ */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ScheduleId } from '@deepseek-ai/dsh-schedule/client';
+/** The Sidebar fields that identify one task tab page across a reload. */
+export interface TaskTabPage {
+    /** The persisted layout record's own id. */
+    readonly id: string;
+    /** That record's registered page kind. */
+    readonly kind: string;
+    /** That record's content identity, shared by every tab of this page kind. */
+    readonly contentId: string;
+}
+/** The task one tab page last showed. */
+export interface TaskTabTarget {
+    /** The Session that owns the task. */
+    readonly sessionId: SessionId;
+    /** The task's own identity. */
+    readonly id: ScheduleId;
+}
+/**
+ * The committed tab ids of one Session, read when an entry is stored so a closed
+ * tab leaves none behind. `undefined` and an empty list both skip that removal:
+ * `ctx.sidebarRight.tabsIn` returns the empty list for a Session whose layout is
+ * not adopted as well as for one whose adopted layout holds no tabs, and pruning
+ * against that answer would drop entries a restored tab still resolves through.
+ */
+export type TaskTabLiveIds = (sessionId: SessionId) => readonly string[] | undefined;
+/**
+ * Last shown task per task tab page, kept in this window and in browser storage.
+ *
+ * The window copy is authoritative for this window's reads: it keeps the value
+ * usable when storage is absent or rejects writes, and it avoids reparsing the
+ * stored document on every render.
+ */
+export declare class TaskTabBindings {
+    private readonly liveTabIds?;
+    private readonly memory;
+    /**
+     * @param liveTabIds - the committed layout's tab ids for one Session, read when an entry is stored.
+     */
+    constructor(liveTabIds?: TaskTabLiveIds | undefined);
+    /**
+     * Read the task one page last showed.
+     *
+     * An entry whose kind or contentId differs from the page reading it belongs to
+     * a layout id that has since been reused; the read reports no task and leaves
+     * the document untouched, and `dropMismatched` removes it after the render.
+     * @param sessionId - the Session holding the tab.
+     * @param page - the restored layout record.
+     * @returns the task to show, or undefined when the page has no applicable entry.
+     */
+    read(sessionId: SessionId, page: TaskTabPage): TaskTabTarget | undefined;
+    /**
+     * Drop one page's entry when it recorded another kind or contentId.
+     *
+     * A read reports the mismatch without writing, so the page resolves its target
+     * in a render and drops the entry from an effect; a render React discards must
+     * not rewrite what it read.
+     * @param sessionId - the Session holding the tab.
+     * @param page - the layout record the stored entry has to match.
+     */
+    dropMismatched(sessionId: SessionId, page: TaskTabPage): void;
+    /**
+     * Record the task one page now shows.
+     * @param sessionId - the Session holding the tab.
+     * @param page - the navigated layout record.
+     * @param target - the task the navigation named.
+     */
+    write(sessionId: SessionId, page: TaskTabPage, target: TaskTabTarget): void;
+    /**
+     * Drop one page's entry once a read that succeeded after the tab appeared shows
+     * its task is gone.
+     * @param sessionId - the Session holding the tab.
+     * @param page - the layout record whose entry is removed.
+     */
+    forget(sessionId: SessionId, page: TaskTabPage): void;
+    /** Release this window's cached documents. */
+    clear(): void;
+    /**
+     * One Session's entries, from this window or from storage.
+     * @param sessionId - the Session holding the tabs.
+     * @returns its entries, empty when nothing is saved or storage is unreachable.
+     */
+    private document;
+    /**
+     * Replace one Session's entries, dropping those of tabs a non-empty list of
+     * committed ids does not hold, and publish them to this window and to storage.
+     * An empty result removes the Session's key rather than storing an empty
+     * document.
+     * @param sessionId - the Session holding the tabs.
+     * @param entries - the complete replacement set.
+     */
+    private store;
+}
+//# sourceMappingURL=task-tab-bindings.d.ts.map

package/lib/types/client/task-tab-target.d.ts

@@ -0,0 +1,31 @@
+import type { SidebarRightNavigationParams } from '@deepseek-ai/dsh-client-ui-sidebar-right/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { TaskTabBindings, TaskTabPage, TaskTabTarget } from './task-tab-bindings.ts';
+/** The layout and navigation fields one task tab carries. */
+export interface TaskTabSource extends TaskTabPage {
+    /** Navigation the tab's last open carried; a restored record carries no parameters. */
+    readonly navigation: {
+        readonly params: SidebarRightNavigationParams;
+        readonly revision: number;
+    };
+}
+/** The task one task tab resolves, and where it came from. */
+export interface TaskTabTargetResolution {
+    /** Whether the current layout still carries the opener's navigation parameters. */
+    readonly navigated: boolean;
+    /** Task the navigation named, or undefined when it carried another type's parameters. */
+    readonly navigation: TaskTabTarget | undefined;
+    /** Binding this page kind wrote for this layout id, read only for a restored record. */
+    readonly recovered: TaskTabTarget | undefined;
+    /** Task to show: the navigation's, or the restored binding's. */
+    readonly params: TaskTabTarget | undefined;
+}
+/**
+ * Resolve the task one task tab shows from its navigation or its stored binding.
+ * @param sessionId - the Session holding the tab.
+ * @param tab - the tab's layout fields and its last navigation.
+ * @param taskBindings - provider-owned binding store for restored task tabs.
+ * @returns the navigation, the recovered binding, and the task to show.
+ */
+export declare function useTaskTabTarget(sessionId: SessionId, tab: TaskTabSource, taskBindings: TaskTabBindings): TaskTabTargetResolution;
+//# sourceMappingURL=task-tab-target.d.ts.map

package/lib/types/client/task-timing.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Exact rule snapshots, editable timing fields, the injected task update callback, and Host
+ * failure mapping; zone interpretation belongs to the Host.
+ */
+import type { RemoteResult } from '@deepseek-ai/dsh-api-remotes/client';
+import type { ScheduleRecord, ScheduleUpdateRequest, ScheduleUpdateResult } from '@deepseek-ai/dsh-schedule/client';
+import type { TaskManagerKey } from './task-manager-locales.ts';
+/** Task mutation callback injected by the task catalog owner. */
+export interface TaskTimingInjected {
+    /**
+     * Compare and update the exact task, then refresh the authoritative catalog on success or a stale rule.
+     * Catalog read failures remain in catalog state and do not change the persistence result.
+     * @param request - Captured task and Session, complete expected record, and the optional
+     * replacement name, instruction, and timing change; an omitted `change` keeps the committed target.
+     * @returns Original Remote mutation result; transport or storage exceptions may reject.
+     */
+    readonly onUpdateTiming: (request: ScheduleUpdateRequest) => Promise<RemoteResult<ScheduleUpdateResult>>;
+}
+/** Native input values retained for one edit session. */
+export interface TimingDraft {
+    date: string;
+    time: string;
+    timeZone: string;
+    seconds: string;
+    expression: string;
+}
+/**
+ * Project only persisted rule fields, excluding catalog metadata and delivery receipts.
+ * @param record - Rule from the current catalog.
+ * @returns Independent complete expected rule for compare-and-update.
+ */
+export declare function timingSnapshot(record: ScheduleRecord): ScheduleRecord;
+/**
+ * The zone a new or switched-to rule starts its clock rows in, and whether that
+ * zone came from the stored rule rather than this device.
+ *
+ * A daily, weekly, or cron record stores the zone its wall clock means, so
+ * editing it keeps that zone. A one-shot `at` target and an `after` interval
+ * store only the committed instant and no creation zone, so they start in this
+ * device's zone.
+ * @param record - rule the draft is seeded from.
+ * @returns the draft's IANA zone and whether it is the no-stored-zone fallback.
+ */
+export declare function draftZone(record: ScheduleRecord): {
+    zone: string;
+    stored: boolean;
+};
+/**
+ * The date and clock one instant names in one zone, keeping millisecond precision.
+ *
+ * The locale is fixed, so the field order never follows the interface language,
+ * and each field is read by name rather than from a formatted string.
+ * @param instant - canonical ISO instant.
+ * @param zone - IANA zone the returned wall clock is expressed in.
+ * @returns `YYYY-MM-DDTHH:MM:SS.mmm` in that zone.
+ */
+export declare function zonedWallClock(instant: string, zone: string): string;
+/**
+ * Initialize one-shot inputs in the zone the rule states, or in this device's
+ * zone for a rule that stores none.
+ *
+ * An `at` target stores an instant and no creation zone, so its rows show that
+ * instant in the draft's zone: the shown pair names the instant the record
+ * already commits rather than restating it in a zone the record does not have.
+ * @param record - Expected rule captured when editing starts.
+ * @returns Native input values without rounding seconds or milliseconds.
+ */
+export declare function timingDraft(record: ScheduleRecord): TimingDraft;
+/**
+ * One date as the rows and pickers expose it.
+ *
+ * The draft, the calendar's own comparisons, and the text submitted to the Host
+ * all stay `YYYY-MM-DD`; only the exposed text takes the slashed form the design
+ * states, so no caller has to parse or re-format a date merely to show it.
+ * @param date - stored or staged ISO date text.
+ * @returns the same date with slashes between its fields.
+ */
+export declare function slashDate(date: string): string;
+/**
+ * One clock time at whole-second precision.
+ *
+ * The rows and the clock picker both show `HH:MM:SS`; an untouched stored value
+ * keeps its milliseconds in the draft so a save can submit them back.
+ * @param time - stored or staged clock text, with or without fractional seconds.
+ * @returns the same clock time at whole-second precision, or the input when it is not a clock time.
+ */
+export declare function secondPrecision(time: string): string;
+/**
+ * Localize controlled Host failures without exposing transport or storage diagnostics.
+ * @param code - Error code returned by the timing update.
+ * @returns Dictionary key describing the recovery action.
+ */
+export declare function timingError(code: Extract<ScheduleUpdateResult, {
+    code: string;
+}>['code']): TaskManagerKey;
+//# sourceMappingURL=task-timing.d.ts.map

package/lib/types/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Read-only Schedule catalog plugin, node half. The empty apply keeps the
+ * Schedule catalog plugin, node half. The empty apply keeps the
  * optional browser feature addressable from the host-owned Loader overlay.
  */
 /** Host plugin body — Schedule catalog behavior exists only in the browser entry. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-schedule",
-  "description": "Read-only active Schedule catalog in the Web Session header",
-  "version": "0.1.7-alpha.2",
+  "description": "Host task management page and Session reminder catalog",
+  "version": "0.1.7-rc.2",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/index.d.ts",
@@ -20,8 +20,17 @@
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-api-workspace-controller",
+        "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-sidebar",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-ui-tool",
+        "@deepseek-ai/dsh-client-ui-workspace",
         "@deepseek-ai/dsh-client-ui-primitives"
       ],
       "platform": "web"
@@ -43,19 +52,29 @@
     "@testing-library/react": "^16.1.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
+    "clsx": "^2.1.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-session-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-schedule": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-schedule": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-util-values": "0.1.7-rc.2"
   },
   "files": [
     "lib/index.js",