@michengai/dsh-automation 0.1.19 → 0.1.21

package/lib/types/client/ScheduleRail.d.ts

@@ -1,21 +1,14 @@
 import { type ComponentType, type ReactNode } from 'react';
-import type { Translate } from './contracts.js';
+import type { SessionSelector, Translate, WorkspaceSelector } from './contracts.js';
 import type { AutomationRuntime } from './runtime.js';
-import { type NativeSessionLike, type NativeWorkspaceLike } from './schedule-rail-model.js';
+import { type ScheduleView } from './schedule-overview.js';
 import type { NativeTabRegistry } from './native-tabs.js';
-type SessionSelector = <S>(select: (state: {
-    ids?: string[];
-    byId?: Record<string, NativeSessionLike>;
-    current?: string | null;
-}) => S, eq?: (a: S, b: S) => boolean) => S;
-type WorkspaceSelector = <S>(select: (state: {
-    items?: NativeWorkspaceLike[];
-    archivedSessionIds?: string[];
-}) => S, eq?: (a: S, b: S) => boolean) => S;
-export declare function ScheduleRail({ t, runtime, openSession, }: {
+export declare function ScheduleRail({ t, runtime, openSession, view: controlledView, showViewSwitch, }: {
     readonly t: Translate;
     readonly runtime: AutomationRuntime;
     readonly openSession?: (sessionId: string) => void;
+    readonly view?: ScheduleView;
+    readonly showViewSwitch?: boolean;
 }): JSX.Element;
 export declare function NativeScheduleShell({ t, runtime, officialTree, hostProps, openSession, useSessions, useWorkspaces, renderSlot, hasChannels, subscribeChannels, tabRegistry, wide, }: {
     readonly t: Translate;
@@ -31,4 +24,3 @@ export declare function NativeScheduleShell({ t, runtime, officialTree, hostProp
     readonly tabRegistry?: NativeTabRegistry;
     readonly wide?: boolean;
 }): JSX.Element | null;
-export {};

package/lib/types/client/contracts.d.ts

@@ -2,8 +2,11 @@ import type { ComponentType, ReactNode } from 'react';
 import type { AutomationLocaleKey } from './locales.js';
 import type { AutomationRuntime } from './runtime.js';
 import type { PermissionTranslate } from './permissions.js';
+import type { SessionListState, WorkspaceListState } from './schedule-rail-model.js';
 export type Translate = (key: AutomationLocaleKey, params?: Record<string, unknown>) => string;
 export type ModelTranslate = (key: string, params?: Record<string, unknown>) => string;
+export type SessionSelector = <Selected>(select: (state: SessionListState) => Selected, equals?: (left: Selected, right: Selected) => boolean) => Selected;
+export type WorkspaceSelector = <Selected>(select: (state: WorkspaceListState) => Selected, equals?: (left: Selected, right: Selected) => boolean) => Selected;
 export interface AutomationViewProps {
     readonly t: Translate;
     readonly permissionT: PermissionTranslate;
@@ -63,7 +66,7 @@ export interface NativeSwitcherProps {
     readonly wide?: boolean;
     readonly openSession?: (sessionId: string) => void;
     readonly open?: (sessionId: string) => void;
-    readonly useSessions?: (select: (state: any) => any) => any;
-    readonly useWorkspaces?: (select: (state: any) => any) => any;
+    readonly useSessions?: SessionSelector;
+    readonly useWorkspaces?: WorkspaceSelector;
     readonly renderSlot?: (name: string, props?: Record<string, unknown>) => ReactNode;
 }

package/lib/types/client/dropdown-menu.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react';
+export interface DropdownMenuOption {
+    readonly key: string;
+    readonly label: string;
+    readonly selected: boolean;
+    readonly onSelect: () => void;
+    readonly keepOpen?: boolean;
+    readonly trailing?: {
+        readonly label: string;
+        readonly active: boolean;
+        readonly onSelect: () => void;
+    };
+}
+/** 设置页与侧栏共用的紧凑下拉菜单：显示当前选中项，支持点击外部与 Escape 关闭。 */
+export declare function DropdownMenu({ ariaLabel, className, buttonClassName, menuClassName, options, trigger, }: {
+    readonly ariaLabel: string;
+    readonly className?: string;
+    readonly buttonClassName?: string;
+    readonly menuClassName?: string;
+    readonly options: readonly DropdownMenuOption[];
+    readonly trigger?: ReactNode;
+}): JSX.Element;

package/lib/types/client/helpers.d.ts

@@ -68,6 +68,18 @@ export interface HistoryGroup {
 }
 /** 设置页任务列表排序：计划时间 = nextRunAt，无计划的任务固定排最后。 */
 export declare function sortAutomations(items: readonly AutomationViewModel[], key: AutomationSortKey, direction: AutomationSortDirection): AutomationViewModel[];
+export interface SortPreferenceStorage {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export declare const SETTINGS_SORT_DEFAULT_KEY = "dsh-automation.sort-default.settings";
+export declare const OVERVIEW_SORT_DEFAULT_KEY = "dsh-automation.sort-default.overview";
+/** 读取已保存的默认排序；缺失、损坏或无存储时返回 undefined，由调用方用自身默认值。 */
+export declare function readSortDefault(storage: SortPreferenceStorage | undefined, storageKey: string): {
+    readonly key: AutomationSortKey;
+    readonly direction: AutomationSortDirection;
+} | undefined;
+export declare function writeSortDefault(storage: SortPreferenceStorage, storageKey: string, key: AutomationSortKey, direction: AutomationSortDirection): void;
 export declare function groupHistory(runs: readonly import('./protocol.js').AutomationRunViewModel[], range: HistoryRange, now: Date, t: Translate): HistoryGroup[];
 export declare function formFromAutomation(item: import('./protocol.js').AutomationViewModel, workspaces?: readonly WorkspaceOption[], defaultModel?: ModelOption | null, defaultPermission?: string): AutomationFormState;
 export declare function prettyModelName(model: string): string;

package/lib/types/client/locales.d.ts

@@ -5,6 +5,8 @@ export declare const en: {
     readonly 'sidebar.tabs': "Workspace views";
     readonly 'sidebar.tasksTab': "Tasks";
     readonly 'sidebar.channelsTab': "Channels";
+    readonly 'sidebar.views': "Scheduled views";
+    readonly 'sidebar.viewOverview': "Task overview";
     readonly 'sidebar.empty': "No scheduled runs yet.";
     readonly 'sidebar.tasksEmpty': "No web tasks yet.";
     readonly 'sidebar.ungrouped': "Ungrouped";
@@ -39,6 +41,16 @@ export declare const en: {
     readonly 'session.rename': "Rename";
     readonly 'session.fork': "Fork session";
     readonly 'session.archive': "Archive session";
+    readonly 'session.moreActions': "More actions for {title}";
+    readonly 'session.groupActions': "Actions for {name}";
+    readonly 'session.taskSettings': "Task settings";
+    readonly 'session.archiveGroup': "Archive all conversations";
+    readonly 'session.archiveGroupConfirm': "Archive all";
+    readonly 'session.archiveGroupDescription': "Archive all {count} conversations for “{name}”. You can restore them later in Settings → Archived.";
+    readonly 'session.archiveGroupPending': "Archiving conversations…";
+    readonly 'session.archiveGroupFailed': "Some conversations could not be archived: {message}";
+    readonly 'session.archiveGroupClose': "Close";
+    readonly 'session.archiveGroupCancel': "Cancel";
     readonly 'session.idle': "Idle";
     readonly 'session.runningStatus': "Running";
     readonly 'session.delete': "Remove from Scheduled";
@@ -72,6 +84,7 @@ export declare const en: {
     readonly 'sort.created.desc': "Created time descending";
     readonly 'sort.planned.asc': "Planned time ascending";
     readonly 'sort.planned.desc': "Planned time descending";
+    readonly 'sort.default.saved': "Default";
     readonly 'form.workspace': "Workspace";
     readonly 'form.workspacePath': "Folder path";
     readonly 'form.workspacePathPlaceholder': "D:\\work\\project";
@@ -108,6 +121,7 @@ export declare const en: {
     readonly 'empty.body': "Save a self-contained task, a schedule, and a permission boundary. Every run starts in a new Session.";
     readonly 'empty.action': "Create the first automation";
     readonly 'runs.empty': "No runs yet. Run one now, or wait for the next scheduled occurrence.";
+    readonly 'overview.empty': "No scheduled tasks yet. Create one in Settings.";
     readonly 'form.title': "Create automation";
     readonly 'form.subtitle': "Write a complete, standalone task. Scheduled runs do not inherit this conversation.";
     readonly 'form.name': "Name";
@@ -190,6 +204,7 @@ export declare const en: {
     readonly 'error.title': "Automations could not be loaded";
     readonly 'error.retry': "Try again";
     readonly 'error.action': "The action failed. Please try again.";
+    readonly 'error.taskMissing': "This scheduled task no longer exists.";
     readonly 'error.offline': "Could not reach the local automation service. Check that DSH is still running and try again.";
     readonly 'time.now': "now";
     readonly 'time.minuteAgo': "{count}m ago";

package/lib/types/client/native-group-actions.d.ts

@@ -0,0 +1,7 @@
+export declare const ARCHIVE_MANAGER_PLUGIN = "@michengai/dsh-archive-manager";
+export declare function hasArchiveManagerPlugin(root: {
+    querySelector(selector: string): unknown;
+} | undefined): boolean;
+export declare function scheduledGroupShowsActiveFolder(expanded: boolean, sessionIds: readonly string[], selectedId: string | null): boolean;
+/** 串行归档，避免多个 workspace 状态写入相互覆盖。 */
+export declare function archiveScheduledGroup(sessionIds: readonly string[], archiveSession: (sessionId: string) => void | Promise<void>): Promise<void>;

package/lib/types/client/native-session-list.d.ts

@@ -1,14 +1,16 @@
-import type { Translate } from './contracts.js';
+import type { SessionSelector, Translate, WorkspaceSelector } from './contracts.js';
 import type { AutomationRuntime } from './runtime.js';
+import type { AutomationTaskSettingsRequest } from './task-settings-request.js';
 export { nativeSessionMenuStyle, nextOpenSessionMenu, nextOpenSessionMenuId, pointerPoint, relativeTime, resolveEventElement, shouldCloseNativeSessionMenu, } from './native-session-menu.js';
 export declare function NativeScheduleSessionList(props: {
     readonly t: Translate;
     readonly runtime: AutomationRuntime;
     readonly openSession?: (sessionId: string) => void;
-    readonly useSessions?: (select: (state: any) => any) => any;
-    readonly useWorkspaces?: (select: (state: any) => any) => any;
+    readonly useSessions?: SessionSelector;
+    readonly useWorkspaces?: WorkspaceSelector;
     readonly renameSession?: (sessionId: string, title: string) => void | Promise<void>;
     readonly archiveSession?: (sessionId: string) => void | Promise<void>;
     readonly deleteSession?: (sessionId: string) => void | Promise<void>;
     readonly forkSession?: (sessionId: string) => void | Promise<void>;
+    readonly openTaskSettings?: (request: AutomationTaskSettingsRequest) => void;
 }): JSX.Element;

package/lib/types/client/schedule-overview.d.ts

@@ -0,0 +1,19 @@
+import type { Translate } from './contracts.js';
+import type { AutomationViewModel } from './protocol.js';
+import { type ScheduleRunLike } from './schedule-rail-model.js';
+export type ScheduleView = 'runs' | 'overview';
+export declare function ScheduleViewSwitch({ t, view, onChange, }: {
+    readonly t: Translate;
+    readonly view: ScheduleView;
+    readonly onChange: (view: ScheduleView) => void;
+}): JSX.Element;
+/** 侧栏任务总览：只读列表，有上次会话的任务可点开，其余仅展示。 */
+export declare function ScheduleOverview({ t, automations, runs, openSession, serverNow, archived, presentIds, }: {
+    readonly t: Translate;
+    readonly automations: readonly AutomationViewModel[];
+    readonly runs: readonly ScheduleRunLike[];
+    readonly openSession?: (sessionId: string) => void;
+    readonly serverNow?: string;
+    readonly archived?: ReadonlySet<string>;
+    readonly presentIds?: ReadonlySet<string>;
+}): JSX.Element;

package/lib/types/client/schedule-rail-model.d.ts

@@ -44,6 +44,21 @@ export declare function groupScheduledSessions(automations: readonly {
     readonly id: string;
     readonly name: string;
 }[], runs: readonly ScheduleRunLike[]): ScheduleRailGroup[];
+export interface OverviewAutomationLike {
+    readonly id: string;
+    readonly name: string;
+    readonly status: string;
+    readonly nextRunAt?: string;
+}
+export interface TaskOverviewRow {
+    readonly id: string;
+    readonly name: string;
+    readonly status: string;
+    readonly nextRunAt?: string;
+    readonly lastSessionId?: string;
+}
+/** 任务总览：每个定义一行；最近一次留有会话的运行决定该行是否可点开。 */
+export declare function deriveTaskOverviewRows(automations: readonly OverviewAutomationLike[], runs: readonly ScheduleRunLike[]): TaskOverviewRow[];
 /** 归档中的、以及宿主已经不认识的 Session，都不应再出现在定时页。 */
 export declare function keepScheduledSessionLink(sessionId: string | undefined, archived: ReadonlySet<string>, presentIds?: ReadonlySet<string>): boolean;
 export declare function collectScheduledSessionIds(runs: readonly {

package/lib/types/client/settings-navigation.d.ts

@@ -0,0 +1,10 @@
+type SettingsButton = {
+    readonly textContent: string | null;
+    readonly getAttribute: (name: string) => string | null;
+    click(): void;
+};
+export declare function pickSettingsSectionButton<T extends Pick<SettingsButton, 'textContent'>>(buttons: readonly T[], labels: readonly string[]): T | undefined;
+export declare function pickSettingsLauncher<T extends Pick<SettingsButton, 'textContent' | 'getAttribute'>>(buttons: readonly T[]): T | undefined;
+/** 打开宿主设置弹窗并选择定时任务分区；宿主提供公开 section API 后可集中替换。 */
+export declare function openSettingsSection(labels: readonly string[], onSelected?: () => void, onMissing?: () => void): void;
+export {};

package/lib/types/client/sort-menu.d.ts

@@ -0,0 +1,14 @@
+import type { Translate } from './contracts.js';
+import { type AutomationSortDirection, type AutomationSortKey, type SortPreferenceStorage } from './helpers.js';
+/** 设置页与侧栏总览共用的排序菜单；当前选中行可一键保存为各自的默认排序。 */
+export declare function SortMenu({ t, storage, storageKey, sortKey, sortDirection, onSelect, compact, iconOnly, className, }: {
+    readonly t: Translate;
+    readonly storage?: SortPreferenceStorage;
+    readonly storageKey: string;
+    readonly sortKey: AutomationSortKey;
+    readonly sortDirection: AutomationSortDirection;
+    readonly onSelect: (key: AutomationSortKey, direction: AutomationSortDirection) => void;
+    readonly compact?: boolean;
+    readonly iconOnly?: boolean;
+    readonly className?: string;
+}): JSX.Element;

package/lib/types/client/task-settings-request.d.ts

@@ -0,0 +1,14 @@
+import type { AutomationRunViewModel, AutomationViewModel } from './protocol.js';
+export declare const AUTOMATION_TASK_SETTINGS_EVENT = "dsh-automation:open-task-settings";
+export declare const AUTOMATION_TASK_SETTINGS_STORAGE_KEY = "dsh-automation:pending-task-settings";
+export type AutomationTaskSettingsRequest = {
+    automationId?: string;
+    name: string;
+    sessionIds: string[];
+};
+export declare function parseAutomationTaskSettingsRequest(value: unknown): AutomationTaskSettingsRequest | undefined;
+export declare function writeAutomationTaskSettingsRequest(storage: Storage | undefined, request: AutomationTaskSettingsRequest): void;
+export declare function requestAutomationTaskSettings(request: AutomationTaskSettingsRequest): void;
+export declare function readAutomationTaskSettingsRequest(storage: Storage | undefined): AutomationTaskSettingsRequest | undefined;
+export declare function clearAutomationTaskSettingsRequest(storage: Storage | undefined): void;
+export declare function resolveAutomationTaskSettings(request: AutomationTaskSettingsRequest, automations: readonly AutomationViewModel[], runs: readonly AutomationRunViewModel[]): AutomationViewModel | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-automation",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "在独立 DSH Session 中按计划执行编码任务，支持 Web 设置页与 Agent 双入口管理。",
   "type": "module",
   "main": "./lib/index.js",