agim-cli 1.0.1

package/dist/core/reminder-rpc.js

@@ -0,0 +1,169 @@
+// reminder-rpc.ts — RPC handlers for agent-initiated reminder operations.
+//
+// Lives one layer below the MCP sidecar: the sidecar parses tool calls
+// from the agent, sends them as `type:'reminder'` messages on the bus,
+// and the bus delegates to handleReminderOp() here. Keeps approval-bus.ts
+// focused on transport and lets reminder logic stay testable on its own.
+//
+// Why not just import this from sidecar directly?
+// The sidecar runs as a separate Node process (spawned by claude-code via
+// --mcp-config) and shouldn't touch reminders.db / sessionManager / the
+// messenger registry — those are main-process state. The bus already has
+// the runId → RunContext mapping (from approvalBus.registerRun), so it's
+// the natural mediator.
+import { logger as rootLogger } from './logger.js';
+import { createReminder, listReminders, cancelReminder, snoozeReminder, parseDuration, isValidRecurrence, ReminderError, MIN_FUTURE_MS, } from './reminders.js';
+import { setPending } from './pending-reminder.js';
+const log = rootLogger.child({ component: 'reminder-rpc' });
+let confirmNotifier = null;
+export function setReminderConfirmNotifier(n) {
+    confirmNotifier = n;
+}
+const HIGH_FREQ_THRESHOLD_MS = 60 * 60_000;
+export async function handleReminderOp(op, payload, ctx) {
+    try {
+        switch (op) {
+            case 'create': return await handleCreate(payload, ctx);
+            case 'list': return handleList(ctx);
+            case 'cancel': return handleCancel(payload, ctx);
+            case 'snooze': return handleSnooze(payload, ctx);
+            default: return { ok: false, error: `unknown op: ${op}` };
+        }
+    }
+    catch (err) {
+        if (err instanceof ReminderError)
+            return { ok: false, error: err.message };
+        log.warn({ event: 'rpc.unhandled', err: err instanceof Error ? err.message : String(err) });
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// ─── create ─────────────────────────────────────────────────────────
+async function handleCreate(payload, ctx) {
+    const fireAtRaw = typeof payload.fireAt === 'string' ? payload.fireAt : null;
+    const text = typeof payload.text === 'string' ? payload.text.trim() : '';
+    const recurrenceRaw = typeof payload.recurrence === 'string' ? payload.recurrence : null;
+    const promptModeRaw = typeof payload.promptMode === 'string' ? payload.promptMode : 'llm';
+    const promptMode = promptModeRaw === 'literal' ? 'literal' : 'llm';
+    if (!fireAtRaw)
+        return { ok: false, error: 'fireAt is required (ISO 8601 local time)' };
+    if (!text)
+        return { ok: false, error: 'text is required' };
+    const fireAt = new Date(fireAtRaw);
+    if (Number.isNaN(fireAt.getTime())) {
+        return { ok: false, error: `bad fireAt: "${fireAtRaw}"` };
+    }
+    if (recurrenceRaw && !isValidRecurrence(recurrenceRaw)) {
+        return { ok: false, error: `bad recurrence: "${recurrenceRaw}"` };
+    }
+    const recurrence = recurrenceRaw ?? undefined;
+    // High-freq + LLM polish: stash a pending entry + send a confirmation
+    // card to the user. Agent gets back a 'pending_confirmation' status and
+    // should keep its reply terse — the card is the user-facing prompt.
+    const isHighFreqLlm = promptMode === 'llm'
+        && recurrence?.startsWith('every:')
+        && (parseDuration(recurrence.slice(6)) ?? Number.POSITIVE_INFINITY) < HIGH_FREQ_THRESHOLD_MS;
+    if (isHighFreqLlm) {
+        const tk = `${ctx.platform}:${ctx.channelId}:${ctx.threadId}`;
+        setPending(tk, {
+            fireAt, text, recurrence,
+        });
+        const card = [
+            '🔔 这是一条**高频循环 + LLM 润色**的提醒，需要你确认',
+            `   内容：${text}`,
+            `   循环：${recurrence}`,
+            `   首次：${fireAt.toLocaleString()}`,
+            '',
+            '高频循环每次都会调一次 LLM 来润色，可能不是你想要的。',
+            '回复 `y` 创建（含润色） / `n` 取消（或在创建时加 `literal` 关闭润色）',
+        ].join('\n');
+        if (confirmNotifier) {
+            try {
+                await confirmNotifier(ctx, card);
+            }
+            catch (err) {
+                log.warn({ event: 'rpc.notifier_failed', err: err instanceof Error ? err.message : String(err) });
+            }
+        }
+        return {
+            ok: true,
+            result: {
+                status: 'pending_confirmation',
+                message: 'High-frequency + LLM polish requires user confirmation. A card has been sent to the user — wait for them to reply y/n. You should keep your own reply brief.',
+            },
+        };
+    }
+    // Normal create
+    const id = createReminder({
+        fireAt, text,
+        platform: ctx.platform, channelId: ctx.channelId, threadId: ctx.threadId,
+        userId: ctx.userId,
+        source: 'mcp',
+        recurrence,
+        promptMode,
+    });
+    log.info({ event: 'rpc.create.ok', id, recurrence, promptMode, threadId: ctx.threadId });
+    return {
+        ok: true,
+        result: {
+            id,
+            fireAt: fireAt.toISOString(),
+            text,
+            recurrence: recurrence ?? null,
+            promptMode,
+            message: `Reminder #${id} created. It will fire at ${fireAt.toLocaleString()}${recurrence ? ` and recur (${recurrence})` : ''}.`,
+        },
+    };
+}
+// ─── list ───────────────────────────────────────────────────────────
+function handleList(ctx) {
+    const owner = ctx.userId ? { creatorId: ctx.userId } : {};
+    const all = listReminders({ ...owner, status: 'pending', limit: 50 });
+    const slim = all.map((r) => ({
+        id: r.id,
+        fire_at: r.fire_at,
+        text: r.text,
+        recurrence: r.recurrence,
+        prompt_mode: r.prompt_mode,
+    }));
+    return { ok: true, result: { reminders: slim } };
+}
+// ─── cancel ─────────────────────────────────────────────────────────
+function handleCancel(payload, ctx) {
+    const id = typeof payload.id === 'number' ? payload.id : Number.parseInt(String(payload.id), 10);
+    if (!Number.isFinite(id) || id <= 0)
+        return { ok: false, error: 'id must be a positive integer' };
+    const owner = ctx.userId ? { creatorId: ctx.userId } : {};
+    const ok = cancelReminder(id, owner);
+    return ok
+        ? { ok: true, result: { id, cancelled: true, message: `Reminder #${id} cancelled.` } }
+        : { ok: false, error: `Reminder #${id} not found, not owned by you, or already terminal.` };
+}
+// ─── snooze ─────────────────────────────────────────────────────────
+function handleSnooze(payload, ctx) {
+    const id = typeof payload.id === 'number' ? payload.id : Number.parseInt(String(payload.id), 10);
+    const duration = typeof payload.duration === 'string' ? payload.duration : '';
+    if (!Number.isFinite(id) || id <= 0)
+        return { ok: false, error: 'id must be a positive integer' };
+    if (!duration)
+        return { ok: false, error: 'duration is required (e.g. "5m", "30m", "2h")' };
+    const deltaMs = parseDuration(duration);
+    if (deltaMs === null)
+        return { ok: false, error: `bad duration: "${duration}". Use s/m/h/d (e.g. 5m).` };
+    if (deltaMs < MIN_FUTURE_MS) {
+        return { ok: false, error: `duration too short (min ${MIN_FUTURE_MS / 1000}s)` };
+    }
+    const owner = ctx.userId ? { creatorId: ctx.userId } : {};
+    try {
+        const newId = snoozeReminder(id, deltaMs, owner);
+        return {
+            ok: true,
+            result: { newId, originalId: id, duration, message: `Reminder #${id} snoozed by ${duration} → new #${newId}.` },
+        };
+    }
+    catch (err) {
+        if (err instanceof ReminderError)
+            return { ok: false, error: err.message };
+        throw err;
+    }
+}
+//# sourceMappingURL=reminder-rpc.js.map

package/dist/core/reminder-rpc.js.map

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

package/dist/core/reminders.d.ts

@@ -0,0 +1,159 @@
+export declare const MAX_PENDING_PER_USER = 50;
+export declare const MIN_FUTURE_MS: number;
+export declare const MAX_FUTURE_MS: number;
+export declare const MAX_TEXT_LEN = 1000;
+export type ReminderStatus = 'pending' | 'firing' | 'fired' | 'cancelled' | 'failed';
+export type PromptMode = 'literal' | 'llm';
+export interface Reminder {
+    id: number;
+    fire_at: string;
+    text: string;
+    platform: string;
+    channel_id: string;
+    thread_id: string;
+    user_id: string;
+    status: ReminderStatus;
+    created_at: string;
+    fired_at: string | null;
+    error: string | null;
+    source: string;
+    parent_id: number | null;
+    recurrence: string | null;
+    last_fired_at: string | null;
+    /** 'llm' = at fire time, treat `text` as a prompt and ask the active
+     *  agent to compose the actual delivery. 'literal' = deliver `text` as-is. */
+    prompt_mode: PromptMode;
+}
+export interface CreateReminderInput {
+    fireAt: Date;
+    text: string;
+    platform: string;
+    channelId: string;
+    threadId: string;
+    userId: string;
+    source?: 'slash' | 'mcp' | 'api';
+    parentId?: number;
+    /** Recurrence spec: `every:5m` / `daily:HH:MM` / `weekly:1,3,5:HH:MM`.
+     *  When set, the row stays `pending` after each fire and `fire_at` is rolled
+     *  forward to the next occurrence. Cancel via /remind cancel <id>. */
+    recurrence?: string;
+    /** Default 'llm'. Set 'literal' to bypass LLM polish and deliver text as-is. */
+    promptMode?: PromptMode;
+}
+export interface OwnerOpts {
+    /** When set, list/get/cancel/snooze only see rows where user_id matches
+     *  OR is empty (legacy/system rows). Same model as schedule.ts. */
+    creatorId?: string;
+}
+export declare class ReminderError extends Error {
+    code: string;
+    constructor(code: string, msg: string);
+}
+/** "2m" / "90s" / "3h" / "1d" → milliseconds. Rejects 0/negative/non-int. */
+export declare function parseDuration(s: string): number | null;
+/** "18:30" → today's 18:30 if still in the future, else tomorrow's 18:30.
+ *  Uses server TZ (override at process level via TZ=… env). */
+export declare function parseClock(s: string, now?: Date): Date | null;
+/** ISO-ish absolute datetime "2026-05-09T20:00" / "2026-05-09T20:00:00Z" etc.
+ *  Trailing seconds and timezone suffix are optional. */
+export declare function parseISO(s: string): Date | null;
+/** Unified parser tried in order: duration → clock → ISO. */
+export declare function parseWhen(s: string, now?: Date): {
+    ok: true;
+    fireAt: Date;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Consume a time-expression prefix from the head of `s`, supporting Chinese
+ * (no-separator allowed: "40秒喝水" / "下午6点下班") and English/ISO formats.
+ * Returns { fireAt, rest } on success, null when nothing matches.
+ *
+ * This is the main entry point used by the /remind slash handler so users
+ * don't need to remember strict syntax.
+ */
+export declare function parseWhenPrefix(s: string, now?: Date): {
+    fireAt: Date;
+    rest: string;
+} | null;
+export declare const MIN_RECURRENCE_INTERVAL_MS: number;
+/** Validate a recurrence spec string. Returns true if parseable. */
+export declare function isValidRecurrence(spec: string): boolean;
+/**
+ * Compute the next fire time for a recurring reminder.
+ *
+ * `anchor` is the previous fire_at (for `every:` we step forward from there;
+ * if we missed cycles while offline, we fast-forward past `now`). For clock-
+ * based recurrences (daily/weekly) anchor is ignored — we always pick the
+ * next future slot from `now`.
+ *
+ * Returns null if the spec is malformed or has no satisfiable next slot.
+ */
+export declare function computeNext(spec: string, anchor: Date, now: Date): Date | null;
+/** Human-readable recurrence label for /remind list. */
+export declare function describeRecurrence(spec: string): string;
+/**
+ * Consume a recurrence prefix from the head of `s`. Supports:
+ *
+ *   每5分钟 / 每隔5分钟 / 每2小时 / 每30秒（拒绝, 不做亚分钟级）
+ *   每天早上8点 / 每日下午6点半 / 每天8:30
+ *   每周一8点 / 每周一三五9点 / 每周末10点 / 每个工作日9点
+ *   every 5m / every 1h
+ *
+ * Returns `{ recurrence, fireAt, rest }` where `fireAt` is the FIRST occurrence
+ * (≥ now). `null` when no recurrence pattern matched.
+ */
+export declare function parseRecurrencePrefix(s: string, now?: Date): {
+    recurrence: string;
+    fireAt: Date;
+    rest: string;
+} | null;
+export declare function createReminder(input: CreateReminderInput): number;
+export declare function listReminders(opts?: OwnerOpts & {
+    status?: ReminderStatus;
+    limit?: number;
+}): Reminder[];
+export declare function getReminder(id: number, opts?: OwnerOpts): Reminder | null;
+export declare function cancelReminder(id: number, opts?: OwnerOpts): boolean;
+export declare function clearReminders(opts: {
+    creatorId: string;
+}): number;
+/** Snooze an existing reminder by `deltaMs`: clones the row's text and target
+ *  thread to a new pending row, then marks the original 'cancelled' (if still
+ *  pending) or just chains parent_id (if already fired). Returns new id. */
+export declare function snoozeReminder(id: number, deltaMs: number, opts?: OwnerOpts): number;
+/** Bind (or rebind) an email address to an IM user. Returns the bound email. */
+export declare function bindEmail(platform: string, userId: string, email: string): string;
+/** Look up the bound email for an IM user, or null. */
+export declare function getBoundEmail(platform: string, userId: string): string | null;
+/** Remove the binding for an IM user. Returns true if a row was deleted. */
+export declare function unbindEmail(platform: string, userId: string): boolean;
+/**
+ * Render a compact "background context" block listing the user's pending
+ * reminders for the current platform. Used by router.ts to prepend to the
+ * agent prompt so the agent has live visibility into the user's queue —
+ * lets it answer "what reminders do I have?" without an extra
+ * list_reminders tool call, and avoids creating duplicates.
+ *
+ * Empty string when nothing pending — caller should noop.
+ *
+ * Cost: ~80-200 tokens per message when populated. Bounded to 5 reminders.
+ */
+export declare function buildContextSnippet(platform: string, userId: string): string;
+/** Whether the LLM intent detector should run for this user's non-slash
+ *  messages. Default on (no row = enabled). DB-unavailable also returns
+ *  true so users on bun/fail-soft don't lose the feature silently. */
+export declare function isAiwatchEnabled(platform: string, userId: string): boolean;
+/** Set the aiwatch enabled flag. UPSERT semantics. Returns the new value. */
+export declare function setAiwatchEnabled(platform: string, userId: string, enabled: boolean): boolean;
+/** Move a failed/cancelled reminder back to pending with a fresh fireAt
+ *  (now + MIN_FUTURE_MS). Owner-scoped. Returns true on success. */
+export declare function retryReminder(id: number, opts?: OwnerOpts): boolean;
+/** Run a single tick. Exposed for tests so they can advance the clock manually. */
+export declare function tick(now?: Date): Promise<number>;
+/** Start the periodic ticker. Idempotent. */
+export declare function startReminderEngine(): void;
+export declare function stopReminderEngine(): void;
+export declare function closeReminderDb(): void;
+//# sourceMappingURL=reminders.d.ts.map

package/dist/core/reminders.d.ts.map

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