larkin 0.2.70

package/dist/agent/host-reminder-orchestrator.mjs

@@ -0,0 +1,252 @@
+import * as fs from "node:fs";
+import { countWakeEnvelopes } from "../feishu/host-business-state.mjs";
+import * as defaultReminderStore from "./reminder-store.mjs";
+export class HostReminderOrchestrator {
+    options;
+    lastSnapshot = new Map();
+    redelivered = new Set();
+    redeliveryInFlight = new Map();
+    started = false;
+    store;
+    log;
+    now;
+    fireTimers = new Map();
+    watchers = [];
+    syncInterval = null;
+    constructor(options) {
+        this.options = options;
+        this.store = options.reminderStore ?? defaultReminderStore;
+        this.log = options.log ?? (() => { });
+        this.now = options.now ?? Date.now;
+    }
+    pushSnapshot(agent, why, force = false) {
+        let jobs = [];
+        try {
+            jobs = this.store.load(this.options.stateStore(agent).paths.reminders).reminders
+                .filter((record) => record.status === "scheduled")
+                .map((record) => ({
+                reminderId: record.reminderId,
+                version: Number(record.version),
+                ownerAgentId: record.ownerAgentId,
+                fireAt: record.fireAt,
+            }));
+        }
+        catch (error) {
+            this.log(`reminder 快照读取失败 agent=${agent.name}: ${error.message}`);
+            return;
+        }
+        const key = JSON.stringify(jobs);
+        if (!force && this.lastSnapshot.get(agent.agentId) === key)
+            return;
+        this.lastSnapshot.set(agent.agentId, key);
+        const wanted = new Set(jobs.map((job) => `${agent.agentId}:${job.reminderId}`));
+        for (const [timerKey, timer] of this.fireTimers) {
+            if (timerKey.startsWith(`${agent.agentId}:`) && !wanted.has(timerKey)) {
+                (this.options.clearTimer ?? clearTimeout)(timer);
+                this.fireTimers.delete(timerKey);
+            }
+        }
+        for (const job of jobs) {
+            const timerKey = `${agent.agentId}:${job.reminderId}`;
+            const previous = this.fireTimers.get(timerKey);
+            if (previous)
+                (this.options.clearTimer ?? clearTimeout)(previous);
+            const delay = Math.max(0, Math.min(2_147_000_000, Date.parse(job.fireAt) - this.now()));
+            const timer = (this.options.setTimer ?? setTimeout)(() => {
+                this.fireTimers.delete(timerKey);
+                this.handleFire({ agentId: agent.agentId, reminderId: job.reminderId });
+            }, delay);
+            timer.unref?.();
+            this.fireTimers.set(timerKey, timer);
+        }
+        this.log(`reminder 本地排程 agent=${agent.name} n=${jobs.length}${why ? ` (${why})` : ""}`);
+    }
+    deliver(agent, reminder, overdueMs) {
+        const recurrence = reminder.repeat ? this.store.parseRepeat(reminder.repeat, reminder.tz) : null;
+        const envelope = this.options.envelopeProjector.createReminderEnvelope(agent.agentId, {
+            reminderId: reminder.reminderId,
+            title: reminder.title,
+            repeat: reminder.repeat ? String(reminder.repeat) : null,
+            fireAt: reminder.fireAt,
+            msgRef: reminder.msgRef,
+            channel: reminder.channel ? String(reminder.channel) : null,
+        }, overdueMs, reminder.repeat && recurrence && !("error" in recurrence) ? (recurrence.description || null) : null);
+        try {
+            this.options.stateStore(agent).appendNdjson("inbox", envelope);
+        }
+        catch (error) {
+            this.log("reminder inbox 写失败", error.message);
+            return;
+        }
+        if (this.options.deliveryTarget)
+            void this.options.deliveryTarget.deliver(agent.agentId, envelope);
+        else
+            this.log(`reminder 触发但 Runtime Host 未就绪 id=#${reminder.reminderId.slice(0, 8)}（仅入 inbox）`);
+    }
+    handleFire(message) {
+        const agent = this.options.agents.find((candidate) => candidate.agentId === message.agentId);
+        if (!agent) {
+            this.log(`reminder fire_attempt 未知 agent=${message.agentId}`);
+            return;
+        }
+        const file = this.options.stateStore(agent).paths.reminders;
+        const now = this.now();
+        let action = null;
+        let fired = null;
+        let overdueMs = 0;
+        try {
+            this.store.mutate(file, (store) => {
+                const reminder = store.reminders.find((candidate) => candidate.reminderId === message.reminderId);
+                if (!reminder || reminder.status !== "scheduled") {
+                    this.log(`reminder fire 忽略（不存在或非 scheduled）id=${String(message.reminderId).slice(0, 8)}`);
+                    return;
+                }
+                const due = Date.parse(reminder.fireAt);
+                if (Number.isFinite(due) && due - now > 60_000) {
+                    action = "rearm";
+                    return;
+                }
+                overdueMs = Math.max(0, now - due);
+                const recurrence = reminder.repeat ? this.store.parseRepeat(reminder.repeat, reminder.tz) : null;
+                if (recurrence && !("error" in recurrence)) {
+                    const next = recurrence.next(now, due);
+                    reminder.firedAt = this.store.nowIso(now);
+                    if (next)
+                        reminder.fireAt = this.store.nowIso(next);
+                    else
+                        reminder.status = "fired";
+                }
+                else {
+                    reminder.status = "fired";
+                    reminder.firedAt = this.store.nowIso(now);
+                }
+                reminder.version = Number(reminder.version) + 1;
+                this.store.appendEvent(reminder, "fired", "system", null, reminder.status === "scheduled" ? reminder.fireAt : null, now);
+                store.reminders = store.reminders.filter((candidate) => candidate.status === "scheduled" || now - Date.parse(candidate.firedAt || candidate.createdAt || "") < 30 * 86_400_000);
+                action = "deliver";
+                fired = { ...reminder };
+            });
+        }
+        catch (error) {
+            this.log(`reminder fire 处理失败 agent=${agent.name}: ${error.message}`);
+            return;
+        }
+        if (action === "deliver" && fired) {
+            const record = fired;
+            this.log(`reminder 触发 agent=${agent.name} id=#${record.reminderId.slice(0, 8)} "${record.title.slice(0, 40)}"${overdueMs > 120_000 ? ` 逾期${Math.round(overdueMs / 60_000)}min` : ""}`);
+            this.deliver(agent, record, overdueMs);
+        }
+        else if (action === "rearm") {
+            this.log(`reminder 未到期（daemon 24h 截断），续排 id=${String(message.reminderId).slice(0, 8)}`);
+        }
+        this.pushSnapshot(agent, action === "rearm" ? "续排" : "fire 后同步", true);
+    }
+    startSync() {
+        if (this.started)
+            return;
+        this.started = true;
+        const setTimer = this.options.setTimer ?? setTimeout;
+        const clearTimer = this.options.clearTimer ?? clearTimeout;
+        for (const agent of this.options.agents) {
+            this.pushSnapshot(agent, "启动");
+            if (!agent.stateDir)
+                continue;
+            const timers = new Map();
+            try {
+                const watcher = (this.options.watch ?? fs.watch)(agent.stateDir, (_event, filename) => {
+                    if (filename !== "reminders.json")
+                        return;
+                    const timer = timers.get(agent.agentId);
+                    if (timer)
+                        clearTimer(timer);
+                    timers.set(agent.agentId, setTimer(() => this.pushSnapshot(agent, "文件变更"), 300));
+                });
+                this.watchers.push(watcher);
+            }
+            catch (error) {
+                this.log(`reminder watch 失败 agent=${agent.name}: ${error.message}`);
+            }
+        }
+        const interval = (this.options.setInterval ?? setInterval)(() => {
+            for (const agent of this.options.agents)
+                this.pushSnapshot(agent, "定期兜底");
+        }, 60_000);
+        interval.unref();
+        this.syncInterval = interval;
+    }
+    stopSync() {
+        for (const timer of this.fireTimers.values())
+            (this.options.clearTimer ?? clearTimeout)(timer);
+        this.fireTimers.clear();
+        if (this.syncInterval)
+            clearInterval(this.syncInterval);
+        this.syncInterval = null;
+        for (const watcher of this.watchers.splice(0))
+            watcher.close();
+        this.started = false;
+    }
+    async redeliverUnread(agent) {
+        if (this.redelivered.has(agent.agentId))
+            return;
+        const existingAttempt = this.redeliveryInFlight.get(agent.agentId);
+        if (existingAttempt)
+            return existingAttempt;
+        const attempt = this.performRedelivery(agent);
+        this.redeliveryInFlight.set(agent.agentId, attempt);
+        try {
+            await attempt;
+        }
+        finally {
+            if (this.redeliveryInFlight.get(agent.agentId) === attempt)
+                this.redeliveryInFlight.delete(agent.agentId);
+        }
+    }
+    async performRedelivery(agent) {
+        let lines = [];
+        try {
+            lines = String((this.options.readFile ?? fs.readFileSync)(this.options.stateStore(agent).paths.inbox, "utf8"))
+                .split("\n").filter(Boolean);
+        }
+        catch (error) {
+            if (error.code === "ENOENT" && this.options.deliveryTarget) {
+                this.redelivered.add(agent.agentId);
+            }
+            return;
+        }
+        const parsed = lines.map((line) => {
+            try {
+                return { line, value: JSON.parse(line) };
+            }
+            catch {
+                return { line, value: null };
+            }
+        });
+        if (parsed.some(({ value }) => value === null))
+            return;
+        const existing = parsed.find(({ value }) => typeof value?.message_id === "string" && value.message_id.startsWith("redeliver_"))?.value;
+        const wakeCount = countWakeEnvelopes(parsed
+            .filter(({ value }) => !(typeof value?.message_id === "string" && value.message_id.startsWith("redeliver_")))
+            .map(({ line }) => line));
+        if (!wakeCount && !existing) {
+            if (this.options.deliveryTarget)
+                this.redelivered.add(agent.agentId);
+            return;
+        }
+        const envelope = existing ?? this.options.envelopeProjector.createRedeliveryEnvelope(agent.agentId, wakeCount);
+        if (!existing) {
+            try {
+                this.options.stateStore(agent).appendNdjson("inbox", envelope);
+            }
+            catch (error) {
+                this.log("启动补投 inbox 写失败", error.message);
+                return;
+            }
+        }
+        this.log(`启动补投 agent=${agent.name} 滞留 wake 消息 ${wakeCount} 条`);
+        if (this.options.deliveryTarget)
+            await this.options.deliveryTarget.deliver(agent.agentId, envelope);
+        else
+            return;
+        this.redelivered.add(agent.agentId);
+    }
+}

package/dist/agent/inbox-projection.cjs

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.targetKeyOfInboxEnvelope = targetKeyOfInboxEnvelope;
+exports.projectInboxEnvelope = projectInboxEnvelope;
+exports.targetOfInboxEnvelope = targetOfInboxEnvelope;
+exports.projectInboxEvents = projectInboxEvents;
+exports.projectInboxCheck = projectInboxCheck;
+function targetKeyOfInboxEnvelope(envelope) {
+    if (!envelope)
+        return "runtime:unknown";
+    if (envelope.kind === "document_comment" && typeof envelope.target === "string" && envelope.target) {
+        return envelope.target;
+    }
+    if (typeof envelope.chat_id === "string" && envelope.chat_id) {
+        return typeof envelope.thread_id === "string" && envelope.thread_id
+            ? `thread:${envelope.chat_id}:${envelope.thread_id}`
+            : `chat:${envelope.chat_id}`;
+    }
+    return targetOfInboxEnvelope(envelope) || "runtime:system";
+}
+/** Enrich the durable local Inbox without changing the canonical Runtime envelope. */
+function projectInboxEnvelope(canonical, locators) {
+    return {
+        ...canonical,
+        chat_id: locators.chat_id,
+        thread_id: locators.thread_id !== undefined ? locators.thread_id : (typeof canonical.thread_id === "string" ? canonical.thread_id : null),
+        ...(locators.create_time !== undefined ? { create_time: locators.create_time }
+            : (typeof canonical.create_time === "string" ? { create_time: canonical.create_time } : {})),
+        ...(locators.update_time !== undefined ? { update_time: locators.update_time }
+            : (typeof canonical.update_time === "string" ? { update_time: canonical.update_time } : {})),
+        sender_id: locators.sender_id !== undefined ? locators.sender_id : (typeof canonical.sender_id === "string" ? canonical.sender_id : null),
+        content: locators.content !== undefined ? locators.content : (typeof canonical.content === "string" ? canonical.content : ""),
+    };
+}
+/** Preserve the target/thread format consumed by the existing Agent CLI. */
+function targetOfInboxEnvelope(envelope) {
+    if (!envelope)
+        return null;
+    if (envelope.kind === "document_comment") {
+        return typeof envelope.target === "string" && envelope.target ? envelope.target : null;
+    }
+    if (envelope.channel_type === "thread" && envelope.parent_channel_name) {
+        const base = envelope.parent_channel_type === "dm"
+            ? `dm:@${String(envelope.parent_channel_name)}`
+            : `#${String(envelope.parent_channel_name)}`;
+        return `${base}:${String(envelope.channel_name || "").slice(0, 8)}`;
+    }
+    return envelope.channel_type === "dm"
+        ? `dm:@${String(envelope.channel_name)}`
+        : `#${String(envelope.channel_name)}`;
+}
+/** Project persisted inbox envelopes into the exact agentApi events response data shape. */
+function projectInboxEvents(envelopes) {
+    const last = envelopes[envelopes.length - 1];
+    return {
+        events: envelopes,
+        last_seen_msgId: last ? (last.message_id || null) : null,
+        last_seen_seq: last ? (last.seq ?? null) : null,
+        reply_target: targetOfInboxEnvelope(last),
+        pending_notice_ids: [],
+        wake_reason: null,
+        has_more: false,
+    };
+}
+/** Bounded, content-light and deterministic projection for the read-only check command. */
+function projectInboxCheck(envelopes, onlyTarget) {
+    const byTarget = new Map();
+    for (const envelope of envelopes) {
+        const target = typeof envelope.target === "string" && envelope.target ? envelope.target : targetKeyOfInboxEnvelope(envelope);
+        if (onlyTarget && onlyTarget !== target)
+            continue;
+        const rows = byTarget.get(target) ?? [];
+        rows.push(envelope);
+        byTarget.set(target, rows);
+    }
+    const allTargets = [...byTarget.entries()].map(([target, rows]) => ({
+        target,
+        pending_count: rows.length,
+        latest_received_seq: rows.reduce((latest, row, index) => {
+            const seq = Number(row.target_seq);
+            return Number.isSafeInteger(seq) && seq > 0 ? Math.max(latest, seq) : Math.max(latest, index + 1);
+        }, 0),
+        first_message_id: typeof rows[0]?.message_id === "string" ? rows[0].message_id : null,
+        last_message_id: typeof rows.at(-1)?.message_id === "string" ? rows.at(-1).message_id : null,
+    })).sort((left, right) => left.target.localeCompare(right.target, "en"));
+    return {
+        version: 2,
+        targets: allTargets.slice(0, 50),
+        pending_total: allTargets.reduce((count, row) => count + row.pending_count, 0),
+        has_more: allTargets.length > 50,
+    };
+}

package/dist/agent/inbox-projection.mjs

@@ -0,0 +1,85 @@
+export function targetKeyOfInboxEnvelope(envelope) {
+    if (!envelope)
+        return "runtime:unknown";
+    if (envelope.kind === "document_comment" && typeof envelope.target === "string" && envelope.target) {
+        return envelope.target;
+    }
+    if (typeof envelope.chat_id === "string" && envelope.chat_id) {
+        return typeof envelope.thread_id === "string" && envelope.thread_id
+            ? `thread:${envelope.chat_id}:${envelope.thread_id}`
+            : `chat:${envelope.chat_id}`;
+    }
+    return targetOfInboxEnvelope(envelope) || "runtime:system";
+}
+/** Enrich the durable local Inbox without changing the canonical Runtime envelope. */
+export function projectInboxEnvelope(canonical, locators) {
+    return {
+        ...canonical,
+        chat_id: locators.chat_id,
+        thread_id: locators.thread_id !== undefined ? locators.thread_id : (typeof canonical.thread_id === "string" ? canonical.thread_id : null),
+        ...(locators.create_time !== undefined ? { create_time: locators.create_time }
+            : (typeof canonical.create_time === "string" ? { create_time: canonical.create_time } : {})),
+        ...(locators.update_time !== undefined ? { update_time: locators.update_time }
+            : (typeof canonical.update_time === "string" ? { update_time: canonical.update_time } : {})),
+        sender_id: locators.sender_id !== undefined ? locators.sender_id : (typeof canonical.sender_id === "string" ? canonical.sender_id : null),
+        content: locators.content !== undefined ? locators.content : (typeof canonical.content === "string" ? canonical.content : ""),
+    };
+}
+/** Preserve the target/thread format consumed by the existing Agent CLI. */
+export function targetOfInboxEnvelope(envelope) {
+    if (!envelope)
+        return null;
+    if (envelope.kind === "document_comment") {
+        return typeof envelope.target === "string" && envelope.target ? envelope.target : null;
+    }
+    if (envelope.channel_type === "thread" && envelope.parent_channel_name) {
+        const base = envelope.parent_channel_type === "dm"
+            ? `dm:@${String(envelope.parent_channel_name)}`
+            : `#${String(envelope.parent_channel_name)}`;
+        return `${base}:${String(envelope.channel_name || "").slice(0, 8)}`;
+    }
+    return envelope.channel_type === "dm"
+        ? `dm:@${String(envelope.channel_name)}`
+        : `#${String(envelope.channel_name)}`;
+}
+/** Project persisted inbox envelopes into the exact agentApi events response data shape. */
+export function projectInboxEvents(envelopes) {
+    const last = envelopes[envelopes.length - 1];
+    return {
+        events: envelopes,
+        last_seen_msgId: last ? (last.message_id || null) : null,
+        last_seen_seq: last ? (last.seq ?? null) : null,
+        reply_target: targetOfInboxEnvelope(last),
+        pending_notice_ids: [],
+        wake_reason: null,
+        has_more: false,
+    };
+}
+/** Bounded, content-light and deterministic projection for the read-only check command. */
+export function projectInboxCheck(envelopes, onlyTarget) {
+    const byTarget = new Map();
+    for (const envelope of envelopes) {
+        const target = typeof envelope.target === "string" && envelope.target ? envelope.target : targetKeyOfInboxEnvelope(envelope);
+        if (onlyTarget && onlyTarget !== target)
+            continue;
+        const rows = byTarget.get(target) ?? [];
+        rows.push(envelope);
+        byTarget.set(target, rows);
+    }
+    const allTargets = [...byTarget.entries()].map(([target, rows]) => ({
+        target,
+        pending_count: rows.length,
+        latest_received_seq: rows.reduce((latest, row, index) => {
+            const seq = Number(row.target_seq);
+            return Number.isSafeInteger(seq) && seq > 0 ? Math.max(latest, seq) : Math.max(latest, index + 1);
+        }, 0),
+        first_message_id: typeof rows[0]?.message_id === "string" ? rows[0].message_id : null,
+        last_message_id: typeof rows.at(-1)?.message_id === "string" ? rows.at(-1).message_id : null,
+    })).sort((left, right) => left.target.localeCompare(right.target, "en"));
+    return {
+        version: 2,
+        targets: allTargets.slice(0, 50),
+        pending_total: allTargets.reduce((count, row) => count + row.pending_count, 0),
+        has_more: allTargets.length > 50,
+    };
+}