@zhin.js/plugin-reminder 1.0.2 → 1.0.4

package/README.md

@@ -23,22 +23,28 @@ zhin install @zhin.js/plugin-reminder
 根应用从 `zhin.js` 继承 Stable Command Feature；上面的直接 Command 依赖确保子插件解析到同一物理 provider。安装命令会添加插件挂载；手动维护时同样使用上述清单。启用支持持久状态原子更新的 Database Host。缺少持久数据库或精确目标投递 Host 时启动明确失败，不会降级为内存保存。SQLite、PostgreSQL、MySQL 的状态能力由框架 Database Host 提供；本插件回归使用真实 SQLite 文件。
 
 ```yaml
+configVersion: 2
 plugins:
-  reminder:
-    timezone: UTC
-    maxTasks: 20
-    maxTasksPerSender: 10
-    batchSize: 5
-    missedGraceSeconds: 15
+  reminder: "@zhin.js/plugin-reminder"
+reminder:
+  timezone: UTC
+  maxTasks: 20
+  adminMaxTasks: 20
+  maxTasksPerSender: 10
+  batchSize: 5
+  missedGraceSeconds: 15
 ```
 
-配置统一由 Schema 校验；修改仅重载插件。timezone 是有效的 IANA 时区，只影响显示，默认 UTC。绝对时间必须显式包含 `Z` 或 `±hh:mm`，没有隐式本地时间转换。多个实例应显式配置不同的 `commandNamespace`，例如 `personal` 和 `work`；使用时在指令前添加对应命名空间。Endpoint 的 `commandPrefix` 决定指令前缀。
+配置统一由 Schema 校验；修改仅重载插件。timezone 是有效的 IANA 时区，默认 UTC，用于 `create` 指令的本地日期解析和时间显示；不猜服务器或发送者时区。原有 `at`、Agent 工具和 Console 的绝对时间仍必须显式包含 `Z` 或 `±hh:mm`。多个实例应显式配置不同的 `commandNamespace`，例如 `personal` 和 `work`；使用时在指令前添加对应命名空间。Endpoint 的 `commandPrefix` 决定指令前缀。
 
 ## 指令
 
 以下示例省略 Endpoint 前缀与插件显式命名空间。各指令的 `--help` 提供参数说明。
 
 ```text
+remind create 十分钟后 喝水
+remind create "明天下午三点半" 提交周报
+remind create
 remind after 600 十分钟后休息
 remind at 2027-01-01T09:00:00+08:00 新年会议
 remind every 3600 喝水
@@ -48,6 +54,10 @@ remind cancel <任务 ID>
 
 延迟是 1 秒至一年；周期是 60 秒至一年；内容是 1–500 字符。时间必须在未来一年内。指令权限经过框架 PermissionHost；插件没有额外权限旁路或取消其他发送者任务的管理员接口。
 
+`create` 创建一次性个人提醒，不依赖 AI。缺少时间或正文时逐项补问，随后用纯文字显示绝对日期、IANA 时区、正文和完整原会话；只有明确回复 `确认` 才保存。后续回答不加命令前缀；输入 `取消` 或 `cancel` 退出后再发新命令。每步有时限且整个流程最多三分钟，输错不会无限续期。超时、取消或热重载结束旧流程，均不创建任务。确认时已过期的时间不会自动顺延。
+
+自然时间仅支持有限中文语法：如 `10分钟后`、`一天后`（固定 24 小时）、`今天18:30`、`明天九点`、`后天九点半`、`明天下午三点半`；也支持带 offset 的 ISO 时间。裸写 `九点`、日历周期和夏令时重复／不存在时刻不会猜测。按钮、Markdown 和图片均非必需；非聊天 CLI 没有真实发送者和交互能力时不能创建。完整操作与边界见[无需 AI 的提醒指南](https://zhin.js.org/solutions/reminders)。
+
 ## 执行与恢复
 
 `schedules/poll/index.ts` 每 5 秒通过当前 owner 的 ScheduleContext 解析服务，没有队列积压时通常在目标时间后 5 秒内扫描；平台投递耗时不计入此保证。服务不保存 Message、客户端或旧 snapshot。周期是固定秒数的间隔，不是墙上时钟的 cron，不受夏令时跳变影响。
@@ -60,7 +70,21 @@ remind cancel <任务 ID>
 
 这是保守的至多一次尝试策略，不是 outbox 或 exactly-once 投递。claim 后、实际发送前崩溃可能丢失一次提醒；周期任务遇未知投递也会暂停，需要用户处理。
 
-`maxTasks` 限制新建时每实例的活跃任务（待触发或未确认），不是降低配置后立即裁剪的记录总数；状态硬上限为 32 条记录，每发送者在会话内最多 10 条活跃任务；总编码大小限制为 60 KiB。完成或取消记录在新建任务时优先淘汰，未知任务持续占用限额，直到显式取消。减少配置上限不删除既有活跃任务，只限制继续创建。
+`maxTasks` 限制每实例**聊天个人提醒池**的活跃任务（待触发或未确认）；`adminMaxTasks` 单独限制**管理员提醒池**的活跃任务（待执行、暂停或未确认）。两池配额独立，默认各 20 条，活跃任务总量可以达到两项之和，不能把 `maxTasks` 当作两池合计上限。每池状态硬上限分别为 32 条、60 KiB，管理员池大小包含有界操作确认记录；个人池仍有每发送者在同一会话内最多 10 条的独立限制。完成或取消历史在新建时优先淘汰，未知任务持续占用配额。降低配置不删除既有活跃任务，只限制继续创建。
+
+## Console 管理员任务
+
+插件通过正式 `pluginTaskProviderToken` 提供独立的管理员提醒。管理员经已鉴权的 Console Host 新建时选择精确 Endpoint、会话、父容器及线程；插件不伪造聊天发送者。管理员任务不会进入 `remind list` 或个人工具列表，聊天用户即使知道管理员任务 ID 也不能用 `remind cancel` 取消；管理员任务入口同样不列出或管理聊天个人任务。
+
+创建和编辑参数为 `{ text, at, intervalSeconds? }`：内容 1–500 字，首次执行时间须为未来一年内、包含 `Z` 或 `±hh:mm` 的 ISO 时间；可选周期是 60 秒至一年的整数。`timezone` 按当前实例配置明确显示，固定秒数周期不按夏令时调整。更换目标必须取消旧任务并新建，不把在途或已投递消息迁移到其他会话。
+
+- 待执行任务可暂停或取消；编辑须先暂停，编辑后仍暂停，确认后再恢复。
+- 已过期的一次性暂停任务不能直接恢复，须先编辑未来时间；周期恢复会跳过错过轮次。
+- 投递前持久记录为 `unknown`，仅平台确认消息 ID 后记为完成或进入下一周期。未确认任务不能恢复、编辑或重试，核对目标会话后可取消并另建。
+- 取消不能撤回已经开始的外部投递，完成回写也不会覆盖在途取消。状态仅描述调度事实，不证明当前目标存在、平台已连接或消息可送达；暂停、取消不需要探测外部目标。
+- 两池共用现有扫描 worker、`batchSize` 和统一 `sendTarget` 链路，不启动第二个定时调度；扫描轮转优先池，跨 tick 保留轮转位置，`batchSize: 1` 时也不会因另一池持续有待投递任务而饥饿。任务和操作确认持久化，HMR 与进程重启不会重试未确认投递。
+
+管理员操作带客户端 UUID `requestId` 与最近读取的 `expectedRevision`。创建时 `requestId` 即任务 ID；状态与操作确认在同一次持久 CAS 中写入。相同 ID、相同规范化请求可读取当前快照核对，ID 被用于其他请求则冲突；新操作使用旧 revision 也会冲突，需要刷新并重新确认。快照 `receipts` 只包含最近至多 128 次操作的 ID、任务 ID 和操作类型，**不是平台投递回执**，不包含请求摘要。历史任务淘汰不重置 revision；确认记录已淘汰时不能自动用旧 revision 重放。初次空列表的 revision 稳定，读取不会产生新的任务版本。
 
 ## 显式本地检查
 

package/commands/remind/create/index.js

@@ -0,0 +1,12 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from 'zhin.js/command';
+import { createPersonalReminder } from "../../../lib/create-reminder.js";
+const params = {
+    when: { type: 'string', optional: true, max: 200, description: '提醒时间，例如 10分钟后、明天上午九点；含空格须加引号' },
+    text: { type: 'text', optional: true, max: 500, description: '个人提醒正文；缺省时会逐步补问' },
+};
+export default defineCommand({
+    description: '逐步补全时间和正文，明确确认后创建一次性个人提醒',
+    params,
+    execute: context => createPersonalReminder(context, context.params),
+});

package/commands/remind/create/index.ts

@@ -0,0 +1,14 @@
+import { defineCommand, type CommandMessage } from 'zhin.js/command';
+import type { ReminderConfig } from '../../../src/config.js';
+import { createPersonalReminder } from '../../../src/create-reminder.js';
+
+const params = {
+  when: { type: 'string', optional: true, max: 200, description: '提醒时间，例如 10分钟后、明天上午九点；含空格须加引号' },
+  text: { type: 'text', optional: true, max: 500, description: '个人提醒正文；缺省时会逐步补问' },
+} as const;
+
+export default defineCommand<ReminderConfig, string | undefined, CommandMessage, typeof params>({
+  description: '逐步补全时间和正文，明确确认后创建一次性个人提醒',
+  params,
+  execute: context => createPersonalReminder(context, context.params),
+});

package/lib/admin-tasks.d.ts

@@ -0,0 +1,82 @@
+import { type DeliveryTarget, type OutboundHost, type PluginStateStore } from 'zhin.js';
+import { generationAdmissionSource, type JsonValue, type PluginTask, type PluginTaskAction, type PluginTaskMutation, type PluginTaskProvider, type PluginTaskSnapshot } from 'zhin.js/plugin-runtime';
+import type { ReminderConfig } from './config.js';
+export declare const ADMIN_REMINDER_STATE_KEY = "admin-reminders/v1";
+type AdminTask = {
+    readonly id: string;
+    readonly creation: string;
+    readonly target: DeliveryTarget;
+    readonly text: string;
+    readonly createdAt: number;
+    readonly nextRunAt: number;
+    readonly intervalMs: number | null;
+    readonly state: Exclude<PluginTask['state'], 'running'>;
+    readonly claimId: string | null;
+    readonly lastRunAt: number | null;
+    readonly detail: string;
+};
+type MutationReceipt = {
+    readonly id: string;
+    readonly fingerprint: string;
+    readonly taskId: string;
+    readonly operation: 'create' | PluginTaskAction;
+};
+export type AdminReminderBook = {
+    readonly version: 1;
+    readonly revision: string;
+    readonly tasks: readonly AdminTask[];
+    readonly receipts: readonly MutationReceipt[];
+};
+/** A separate administrator state pool; no sender identity and no access to chat reminders. */
+export declare class AdministratorReminderTasks implements PluginTaskProvider {
+    #private;
+    private readonly state;
+    private readonly outbound;
+    private readonly config;
+    readonly title = "\u7BA1\u7406\u5458\u63D0\u9192";
+    readonly description = "\u72EC\u7ACB\u4E8E\u804A\u5929\u4E2A\u4EBA\u63D0\u9192\uFF0C\u5411\u6307\u5B9A\u8D26\u53F7\u3001\u4F1A\u8BDD\u53CA\u7EBF\u7A0B\u53D1\u9001\u4E00\u6B21\u6027\u6216\u56FA\u5B9A\u5468\u671F\u63D0\u9192";
+    readonly effects: string[];
+    readonly schema: {
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["text", "at"];
+        readonly properties: {
+            readonly text: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 500;
+                readonly title: "提醒内容";
+            };
+            readonly at: {
+                readonly type: "string";
+                readonly format: "date-time";
+                readonly title: "首次执行时间";
+                readonly description: "未来一年内、显式包含 Z 或 ±hh:mm 的 ISO 时间";
+            };
+            readonly intervalSeconds: {
+                readonly type: "integer";
+                readonly minimum: 60;
+                readonly maximum: number;
+                readonly title: "周期秒数（可选）";
+            };
+        };
+    };
+    get [generationAdmissionSource](): import("zhin.js").GenerationAdmissionGate[];
+    constructor(state: PluginStateStore, outbound: OutboundHost, config: ReminderConfig);
+    stop(): void;
+    read(): Promise<PluginTaskSnapshot>;
+    create(input: PluginTaskMutation & Readonly<{
+        target: DeliveryTarget;
+        parameters: Readonly<Record<string, JsonValue>>;
+    }>): Promise<PluginTaskSnapshot>;
+    change(input: PluginTaskMutation & Readonly<{
+        id: string;
+        action: PluginTaskAction;
+        parameters?: Readonly<Record<string, JsonValue>>;
+    }>): Promise<PluginTaskSnapshot>;
+    /** Called only by the existing ReminderService worker, within its shared batch limit. */
+    claim(now: number, claimId: string): Promise<AdminTask | undefined>;
+    deliver(task: AdminTask): Promise<void>;
+}
+export {};
+//# sourceMappingURL=admin-tasks.d.ts.map

package/lib/admin-tasks.d.ts.map

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

package/lib/admin-tasks.js

@@ -0,0 +1,294 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { createDeliveryTarget } from 'zhin.js';
+import { PluginTaskError, createGenerationAdmissionGate, generationAdmissionSource } from 'zhin.js/plugin-runtime';
+import { EndpointDeliveryError } from '@zhin.js/im-contract';
+import { MAX_DELAY_SECONDS, nextPeriodicTime, parseReminderInstant } from './timing.js';
+export const ADMIN_REMINDER_STATE_KEY = 'admin-reminders/v1';
+const activeStates = new Set(['scheduled', 'paused', 'unknown']);
+const uuidPattern = /^[\da-f]{8}-(?:[\da-f]{4}-){3}[\da-f]{12}$/iu;
+/** A separate administrator state pool; no sender identity and no access to chat reminders. */
+export class AdministratorReminderTasks {
+    state;
+    outbound;
+    config;
+    title = '管理员提醒';
+    description = '独立于聊天个人提醒，向指定账号、会话及线程发送一次性或固定周期提醒';
+    effects = ['创建后将在指定时间通过当前插件实例向目标会话发送提醒；暂停或取消不能撤回已开始的投递', '未确认的投递不会自动重试或恢复，需核实目标会话后取消并另建任务'];
+    schema = { type: 'object', additionalProperties: false, required: ['text', 'at'], properties: {
+            text: { type: 'string', minLength: 1, maxLength: 500, title: '提醒内容' },
+            at: { type: 'string', format: 'date-time', title: '首次执行时间', description: '未来一年内、显式包含 Z 或 ±hh:mm 的 ISO 时间' },
+            intervalSeconds: { type: 'integer', minimum: 60, maximum: MAX_DELAY_SECONDS, title: '周期秒数（可选）' },
+        } };
+    #stopped = false;
+    #admission = createGenerationAdmissionGate();
+    get [generationAdmissionSource]() { return [this.#admission]; }
+    constructor(state, outbound, config) {
+        this.state = state;
+        this.outbound = outbound;
+        this.config = config;
+    }
+    stop() { this.#stopped = true; }
+    async read() {
+        return this.#admit(async () => this.#snapshot(readBook(await this.state.get(ADMIN_REMINDER_STATE_KEY))));
+    }
+    async create(input) {
+        return this.#admit(() => this.#create(input));
+    }
+    async #create(input) {
+        this.#assertLive();
+        assertMutation(input);
+        let target;
+        try {
+            target = createDeliveryTarget({ conversation: input.target });
+        }
+        catch {
+            throw invalid('请提供完整有效的目标账号、会话、父容器和线程');
+        }
+        const parameters = parseParameters(input.parameters);
+        const fingerprint = digest({ operation: 'create', target, parameters });
+        const revision = randomUUID();
+        const now = Date.now();
+        const task = { id: input.requestId, creation: fingerprint, target, text: parameters.text, createdAt: now,
+            nextRunAt: Date.parse(parameters.at), intervalMs: parameters.intervalSeconds === undefined ? null : parameters.intervalSeconds * 1000,
+            state: 'scheduled', claimId: null, lastRunAt: null, detail: '等待执行' };
+        const result = await this.state.update(ADMIN_REMINDER_STATE_KEY, current => {
+            this.#assertLive();
+            const book = readBook(current);
+            if (reconcile(book, input.requestId, fingerprint))
+                return book;
+            assertRevision(book, input.expectedRevision);
+            const existing = book.tasks.find(item => item.id === input.requestId);
+            if (existing) {
+                if (existing.creation !== fingerprint)
+                    throw conflict('同一请求 ID 已用于其他内容');
+                return book;
+            }
+            assertFuture(task.nextRunAt, now);
+            const active = book.tasks.filter(item => activeStates.has(item.state));
+            if (active.length >= this.config.adminMaxTasks)
+                throw invalid('管理员提醒池已达上限，请先取消任务；聊天个人提醒使用独立配额');
+            const historyLimit = Math.max(0, this.config.adminMaxTasks - active.length - 1);
+            const history = historyLimit ? book.tasks.filter(item => !activeStates.has(item.state)).slice(-historyLimit) : [];
+            return bounded({ ...book, revision, tasks: [...active, ...history, task], receipts: receipt(book, input.requestId, fingerprint, task.id, 'create') });
+        });
+        return this.#snapshot(readBook(result));
+    }
+    async change(input) {
+        return this.#admit(() => this.#change(input));
+    }
+    async #change(input) {
+        this.#assertLive();
+        assertMutation(input);
+        if (typeof input.id !== 'string' || !uuidPattern.test(input.id) || !['pause', 'resume', 'cancel', 'update'].includes(input.action))
+            throw invalid('任务 ID 或操作无效');
+        if (input.action !== 'update' && input.parameters !== undefined)
+            throw invalid('仅编辑操作接受参数');
+        const parameters = input.action === 'update' ? parseParameters(input.parameters) : undefined;
+        const fingerprint = digest({ operation: 'change', id: input.id, action: input.action, parameters: parameters ?? null });
+        const revision = randomUUID();
+        const now = Date.now();
+        const result = await this.state.update(ADMIN_REMINDER_STATE_KEY, current => {
+            this.#assertLive();
+            const book = readBook(current);
+            if (reconcile(book, input.requestId, fingerprint))
+                return book;
+            assertRevision(book, input.expectedRevision);
+            const task = book.tasks.find(item => item.id === input.id);
+            if (!task)
+                throw new PluginTaskError('not_found', '未找到当前实例的管理员任务；聊天任务不在此入口管理');
+            let changed;
+            switch (input.action) {
+                case 'pause':
+                    if (task.state !== 'scheduled')
+                        throw invalid('仅待执行任务可以暂停；未确认投递不能暂停或恢复');
+                    changed = { ...task, state: 'paused', detail: '管理员暂停' };
+                    break;
+                case 'resume': {
+                    if (task.state !== 'paused')
+                        throw invalid('仅已暂停任务可以恢复；未确认投递不能恢复或重试');
+                    if (task.intervalMs === null && task.nextRunAt <= now)
+                        throw invalid('一次性任务时间已过，请先编辑为未来时间再恢复');
+                    const nextRunAt = task.nextRunAt <= now && task.intervalMs !== null ? nextPeriodicTime(task.nextRunAt, task.intervalMs, now) : task.nextRunAt;
+                    changed = { ...task, state: 'scheduled', nextRunAt, detail: nextRunAt !== task.nextRunAt ? '已恢复，并跳过错过的周期轮次' : '管理员恢复' };
+                    break;
+                }
+                case 'update':
+                    if (task.state !== 'paused')
+                        throw invalid('编辑前请先暂停任务；未确认投递不能编辑');
+                    assertFuture(Date.parse(parameters.at), now);
+                    changed = { ...task, text: parameters.text, nextRunAt: Date.parse(parameters.at),
+                        intervalMs: parameters.intervalSeconds === undefined ? null : parameters.intervalSeconds * 1000, detail: '已编辑，保持暂停；请确认后恢复' };
+                    break;
+                case 'cancel':
+                    if (!activeStates.has(task.state))
+                        throw invalid('任务已结束，不能再次取消');
+                    changed = { ...task, state: 'cancelled', detail: '管理员取消；已经开始的投递无法撤回' };
+                    break;
+            }
+            return bounded({ ...book, revision, tasks: book.tasks.map(item => item.id === task.id ? changed : item), receipts: receipt(book, input.requestId, fingerprint, task.id, input.action) });
+        });
+        return this.#snapshot(readBook(result));
+    }
+    /** Called only by the existing ReminderService worker, within its shared batch limit. */
+    async claim(now, claimId) {
+        this.#assertLive();
+        const revision = randomUUID();
+        const book = await this.state.update(ADMIN_REMINDER_STATE_KEY, current => {
+            const book = readBook(current);
+            let claimed = false;
+            let changed = false;
+            const tasks = book.tasks.map(task => {
+                if (task.state !== 'scheduled' || task.nextRunAt > now)
+                    return task;
+                if (task.intervalMs !== null && now - task.nextRunAt > this.config.missedGraceSeconds * 1000) {
+                    changed = true;
+                    return { ...task, nextRunAt: nextPeriodicTime(task.nextRunAt, task.intervalMs, now), detail: '已跳过错过的周期轮次' };
+                }
+                if (claimed)
+                    return task;
+                changed = claimed = true;
+                return { ...task, state: 'unknown', claimId, lastRunAt: now, detail: '投递中或未确认；不会自动重试' };
+            });
+            return changed ? bounded({ ...book, revision, tasks }) : current;
+        });
+        return book?.tasks.find(task => task.claimId === claimId);
+    }
+    async deliver(task) {
+        if (this.#stopped)
+            return;
+        let state = 'unknown';
+        let detail = '平台未确认投递，请核实目标会话后取消并另建任务；不会自动重试';
+        try {
+            const id = await this.outbound.sendTarget(task.target, `⏰ 提醒：${task.text}`);
+            if (id) {
+                state = task.intervalMs === null ? 'succeeded' : 'scheduled';
+                detail = '已确认投递';
+            }
+        }
+        catch (error) {
+            if (error instanceof EndpointDeliveryError && error.disposition !== 'unknown') {
+                state = 'failed';
+                detail = '平台明确未投递或拒绝；任务已停止';
+            }
+        }
+        const revision = randomUUID();
+        await this.state.update(ADMIN_REMINDER_STATE_KEY, current => {
+            const book = readBook(current);
+            let changed = false;
+            const tasks = book.tasks.map(item => {
+                if (item.id !== task.id || item.claimId !== task.claimId || item.state !== 'unknown')
+                    return item;
+                changed = true;
+                return { ...item, state, detail, ...(state === 'scheduled' && task.intervalMs !== null
+                        ? { nextRunAt: nextPeriodicTime(task.nextRunAt, task.intervalMs, Date.now()) } : {}) };
+            });
+            return changed ? bounded({ ...book, revision, tasks }) : current;
+        });
+    }
+    #assertLive() { if (this.#stopped)
+        throw new PluginTaskError('unavailable', '管理员提醒服务属于已停止的插件实例'); }
+    async #admit(operation) {
+        this.#assertLive();
+        const release = this.#admission.acquire();
+        if (!release)
+            throw new PluginTaskError('unavailable', '管理员提醒服务属于未发布或已退役的 generation');
+        try {
+            return await operation();
+        }
+        finally {
+            release();
+        }
+    }
+    #snapshot(book) {
+        return { revision: book.revision, receipts: book.receipts.map(item => ({ requestId: item.id, taskId: item.taskId, operation: item.operation })), tasks: book.tasks.map(task => ({
+                id: task.id, ownership: 'administrator', title: taskTitle(task.text), target: task.target, state: task.state, createdAt: task.createdAt,
+                ...(task.state === 'scheduled' || task.state === 'paused' ? { nextRunAt: task.nextRunAt } : {}), ...(task.lastRunAt === null ? {} : { lastRunAt: task.lastRunAt }),
+                timezone: this.config.timezone, detail: `${task.detail}；状态仅表示调度事实，不代表平台连接或投递健康`,
+                parameters: { text: task.text, at: new Date(task.nextRunAt).toISOString(), ...(task.intervalMs === null ? {} : { intervalSeconds: task.intervalMs / 1000 }) },
+                actions: task.state === 'scheduled' ? ['pause', 'cancel'] : task.state === 'paused' ? ['update', 'resume', 'cancel'] : task.state === 'unknown' ? ['cancel'] : [],
+            })) };
+    }
+}
+function assertMutation(input) {
+    if (typeof input.requestId !== 'string' || !uuidPattern.test(input.requestId) || typeof input.expectedRevision !== 'string' || !input.expectedRevision || input.expectedRevision.length > 128)
+        throw invalid('操作须包含 UUID requestId 和读取到的 expectedRevision');
+}
+function parseParameters(value) {
+    if (!value || Array.isArray(value) || Object.keys(value).some(key => !['text', 'at', 'intervalSeconds'].includes(key))
+        || typeof value.text !== 'string' || !value.text.trim() || value.text.length > 500 || typeof value.at !== 'string'
+        || (value.intervalSeconds !== undefined && (typeof value.intervalSeconds !== 'number' || !Number.isSafeInteger(value.intervalSeconds) || value.intervalSeconds < 60 || value.intervalSeconds > MAX_DELAY_SECONDS)))
+        throw invalid('参数须包含 1–500 字提醒内容、带 offset 的 ISO 时间及可选的 60 秒至一年整数周期');
+    let at;
+    try {
+        at = parseReminderInstant(value.at);
+    }
+    catch {
+        throw invalid('提醒时间须为有效且带 Z 或 ±hh:mm 的 ISO 时间');
+    }
+    return { text: value.text, at: new Date(at).toISOString(), ...(value.intervalSeconds === undefined ? {} : { intervalSeconds: value.intervalSeconds }) };
+}
+function assertFuture(at, now) {
+    if (!Number.isSafeInteger(at) || at <= now || at - now > MAX_DELAY_SECONDS * 1000)
+        throw invalid('提醒时间须在未来一年内');
+}
+function digest(value) { return createHash('sha256').update(JSON.stringify(value)).digest('hex'); }
+function taskTitle(text) {
+    if (text.length <= 200)
+        return text;
+    let title = '';
+    for (const character of text) {
+        if (title.length + character.length > 199)
+            break;
+        title += character;
+    }
+    return `${title}…`;
+}
+function reconcile(book, id, fingerprint) {
+    const previous = book.receipts.find(item => item.id === id);
+    if (!previous)
+        return false;
+    if (previous.fingerprint !== fingerprint)
+        throw conflict('同一操作请求 ID 已用于其他内容，禁止重放');
+    return true;
+}
+function assertRevision(book, revision) { if (book.revision !== revision)
+    throw conflict('任务列表已变化，请刷新后重新确认操作'); }
+function receipt(book, id, fingerprint, taskId, operation) {
+    return [...book.receipts, { id, fingerprint, taskId, operation }].slice(-128);
+}
+function invalid(message) { return new PluginTaskError('invalid_input', message); }
+function conflict(message) { return new PluginTaskError('conflict', message); }
+function bounded(book) {
+    if (book.tasks.length > 32 || new TextEncoder().encode(JSON.stringify(book)).byteLength > 60 * 1024)
+        throw invalid('管理员提醒池状态达到 32 条或 60 KiB 上限，请先取消并整理任务');
+    return book;
+}
+function readBook(value) {
+    if (value === undefined)
+        return { version: 1, revision: '0', tasks: [], receipts: [] };
+    try {
+        if (value.version !== 1 || typeof value.revision !== 'string' || !value.revision || !Array.isArray(value.tasks) || !Array.isArray(value.receipts) || value.receipts.length > 128)
+            throw new Error('invalid book');
+        for (const item of value.receipts)
+            if (!item || !uuidPattern.test(item.id) || !uuidPattern.test(item.taskId)
+                || !['create', 'pause', 'resume', 'cancel', 'update'].includes(item.operation) || !/^[\da-f]{64}$/u.test(item.fingerprint))
+                throw new Error('invalid receipt');
+        const ids = new Set();
+        for (const task of value.tasks) {
+            if (!task || !uuidPattern.test(task.id) || ids.has(task.id) || typeof task.creation !== 'string' || !/^[\da-f]{64}$/u.test(task.creation)
+                || typeof task.text !== 'string' || !task.text.trim() || task.text.length > 500 || !Number.isSafeInteger(task.createdAt) || !Number.isSafeInteger(task.nextRunAt)
+                || (task.intervalMs !== null && (!Number.isSafeInteger(task.intervalMs) || task.intervalMs < 60_000 || task.intervalMs > MAX_DELAY_SECONDS * 1000))
+                || !['scheduled', 'paused', 'unknown', 'succeeded', 'failed', 'cancelled'].includes(task.state)
+                || (task.claimId !== null && (typeof task.claimId !== 'string' || !task.claimId)) || (task.lastRunAt !== null && !Number.isSafeInteger(task.lastRunAt))
+                || typeof task.detail !== 'string' || !Number.isFinite(new Date(task.nextRunAt).getTime()))
+                throw new Error('invalid task');
+            createDeliveryTarget({ conversation: task.target });
+            ids.add(task.id);
+        }
+        return bounded(value);
+    }
+    catch {
+        throw new PluginTaskError('unavailable', '管理员提醒持久状态格式无效，已停止投递');
+    }
+}
+//# sourceMappingURL=admin-tasks.js.map

package/lib/admin-tasks.js.map

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

package/lib/config.d.ts

@@ -2,12 +2,14 @@ import { Schema } from 'zhin.js';
 export declare const reminderConfig: Schema<Schema.InputRecord<{
     timezone: Schema<string, string> & Schema.Present;
     maxTasks: Schema<number, number> & Schema.Present;
+    adminMaxTasks: Schema<number, number> & Schema.Present;
     maxTasksPerSender: Schema<number, number> & Schema.Present;
     batchSize: Schema<number, number> & Schema.Present;
     missedGraceSeconds: Schema<number, number> & Schema.Present;
 }>, {
     timezone: string;
     maxTasks: number;
+    adminMaxTasks: number;
     maxTasksPerSender: number;
     batchSize: number;
     missedGraceSeconds: number;

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,cAAc;;;;;;;;;;;;OAMzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAElE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAG7D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,eAAO,MAAM,cAAc;;;;;;;;;;;;;;OAOzB,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,cAAc,CAAC,CAAC;AAElE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM7D"}

package/lib/config.js

@@ -1,13 +1,16 @@
 import { Schema } from 'zhin.js';
 export const reminderConfig = Schema.object({
-    timezone: Schema.string().default('UTC').description('显示提醒时间的 IANA 时区；绝对时间仍必须提供 ISO offset').effect('reload'),
-    maxTasks: Schema.number().min(1).max(32).step(1).default(20).description('每个插件实例新建时允许的活跃任务上限（待触发或未确认）；降低上限不删除既有任务').effect('reload'),
+    timezone: Schema.string().default('UTC').description('解释 create 自然时间并显示提醒的 IANA 时区；ISO 绝对时间仍须显式 offset').effect('reload'),
+    maxTasks: Schema.number().min(1).max(32).step(1).default(20).description('每实例聊天个人提醒池的活跃任务上限；与管理员池独立，降低上限不删除既有任务').effect('reload'),
+    adminMaxTasks: Schema.number().min(1).max(32).step(1).default(20).description('每实例管理员提醒池的活跃任务上限（待执行、暂停或未确认）；与聊天池独立，两池总量可达上限之和').effect('reload'),
     maxTasksPerSender: Schema.number().min(1).max(10).step(1).default(10).description('同一发送者在同一会话的任务上限').effect('reload'),
     batchSize: Schema.number().min(1).max(5).step(1).default(5).description('每次扫描最多投递的任务数').effect('reload'),
     missedGraceSeconds: Schema.number().min(5).max(60).step(1).default(15).description('周期轮次超过此延迟后跳过；停机期间不补历史轮次').effect('reload'),
 });
 export function assertReminderTimezone(timezone) {
     try {
+        if (!timezone || timezone.length > 100 || timezone !== timezone.trim() || /^[+-]/u.test(timezone))
+            throw new RangeError('Invalid IANA timezone');
         new Intl.DateTimeFormat('zh-CN', { timeZone: timezone }).format(0);
     }
     catch {

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC7G,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,yCAAyC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACpI,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxG,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC/H,CAAC,CAAC;AAIH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,CAAC;QAAC,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAC3E,MAAM,CAAC;QAAC,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,kDAAkD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACzH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,uCAAuC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAClI,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,gDAAgD,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChJ,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACrH,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;IACxG,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;CAC/H,CAAC,CAAC;AAIH,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,IAAI,CAAC;QACH,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,KAAK,QAAQ,CAAC,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,uBAAuB,CAAC,CAAC;QACjJ,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,CAAC;QAAC,MAAM,IAAI,SAAS,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;IAAC,CAAC;AAC1E,CAAC"}

package/lib/create-reminder.d.ts

@@ -0,0 +1,8 @@
+import type { CommandContext } from 'zhin.js/command';
+import type { ReminderConfig } from './config.js';
+/** Personal reminder entry: no persistence is touched before explicit confirmation. */
+export declare function createPersonalReminder(context: CommandContext<ReminderConfig>, parameters: Readonly<{
+    when?: string;
+    text?: string;
+}>): Promise<string | undefined>;
+//# sourceMappingURL=create-reminder.d.ts.map

package/lib/create-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-reminder.d.ts","sourceRoot":"","sources":["../src/create-reminder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAalD,uFAAuF;AACvF,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,cAAc,CAAC,cAAc,CAAC,EACvC,UAAU,EAAE,QAAQ,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACrD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAuF7B"}