exempclaw 0.4.0

package/dist/memory/file-store.d.ts

@@ -0,0 +1,28 @@
+import type Anthropic from "@anthropic-ai/sdk";
+import type { MemoryEntry, MemoryStore } from "./store.js";
+/**
+ * Default MemoryStore backed by JSON files on disk. Simple, dependency-free,
+ * and good enough to run real agents; swap for SQLite + a vector index when
+ * retrieval needs to scale. One directory per agent under <dataDir>/agents/<id>.
+ *
+ * Writes go through a temp file + rename so a crash mid-write can't corrupt
+ * the store. Mutations are serialized behind a per-store queue so concurrent
+ * tool calls can't interleave read-modify-write cycles.
+ */
+export declare class FileMemoryStore implements MemoryStore {
+    private readonly memoryPath;
+    private readonly historyPath;
+    private writeQueue;
+    constructor(dataDir: string, agentId: string);
+    private readJson;
+    private writeJsonAtomic;
+    /** Serializes a mutation behind the store's write queue. */
+    private enqueue;
+    addMemory(entry: Omit<MemoryEntry, "id" | "createdAt">): Promise<MemoryEntry>;
+    removeMemory(id: string): Promise<boolean>;
+    searchMemory(query: string, limit?: number): Promise<MemoryEntry[]>;
+    allMemories(): Promise<MemoryEntry[]>;
+    loadHistory(): Promise<Anthropic.MessageParam[]>;
+    saveHistory(messages: Anthropic.MessageParam[]): Promise<void>;
+    clearHistory(): Promise<void>;
+}

package/dist/memory/file-store.js

@@ -0,0 +1,110 @@
+import { randomUUID } from "node:crypto";
+import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+/**
+ * Default MemoryStore backed by JSON files on disk. Simple, dependency-free,
+ * and good enough to run real agents; swap for SQLite + a vector index when
+ * retrieval needs to scale. One directory per agent under <dataDir>/agents/<id>.
+ *
+ * Writes go through a temp file + rename so a crash mid-write can't corrupt
+ * the store. Mutations are serialized behind a per-store queue so concurrent
+ * tool calls can't interleave read-modify-write cycles.
+ */
+export class FileMemoryStore {
+    memoryPath;
+    historyPath;
+    writeQueue = Promise.resolve();
+    constructor(dataDir, agentId) {
+        const base = join(dataDir, "agents", agentId);
+        this.memoryPath = join(base, "memory.json");
+        this.historyPath = join(base, "history.json");
+    }
+    async readJson(path, fallback) {
+        try {
+            return JSON.parse(await readFile(path, "utf8"));
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return fallback;
+            throw err;
+        }
+    }
+    async writeJsonAtomic(path, value) {
+        await mkdir(dirname(path), { recursive: true });
+        const tmp = `${path}.${randomUUID().slice(0, 8)}.tmp`;
+        await writeFile(tmp, JSON.stringify(value, null, 2), "utf8");
+        await rename(tmp, path);
+    }
+    /** Serializes a mutation behind the store's write queue. */
+    enqueue(op) {
+        const next = this.writeQueue.catch(() => undefined).then(op);
+        this.writeQueue = next;
+        return next;
+    }
+    addMemory(entry) {
+        return this.enqueue(async () => {
+            const memories = await this.allMemories();
+            const full = { ...entry, id: randomUUID(), createdAt: new Date().toISOString() };
+            memories.push(full);
+            await this.writeJsonAtomic(this.memoryPath, memories);
+            return full;
+        });
+    }
+    removeMemory(id) {
+        return this.enqueue(async () => {
+            const memories = await this.allMemories();
+            const remaining = memories.filter((m) => m.id !== id && !m.id.startsWith(id));
+            if (remaining.length === memories.length)
+                return false;
+            await this.writeJsonAtomic(this.memoryPath, remaining);
+            return true;
+        });
+    }
+    async searchMemory(query, limit = 10) {
+        const memories = await this.allMemories();
+        const terms = [...new Set(query.toLowerCase().split(/[^\p{L}\p{N}]+/u).filter((t) => t.length > 1))];
+        if (terms.length === 0)
+            return memories.slice(-limit).reverse();
+        // Term-frequency scoring with a tag/source boost and recency tiebreak.
+        const scored = memories.map((m) => {
+            const text = m.text.toLowerCase();
+            const meta = `${m.tags.join(" ")} ${m.source}`.toLowerCase();
+            let score = 0;
+            for (const term of terms) {
+                score += countOccurrences(text, term);
+                if (meta.includes(term))
+                    score += 2;
+            }
+            return { m, score };
+        });
+        return scored
+            .filter((s) => s.score > 0)
+            .sort((a, b) => b.score - a.score || b.m.createdAt.localeCompare(a.m.createdAt))
+            .slice(0, limit)
+            .map((s) => s.m);
+    }
+    allMemories() {
+        return this.readJson(this.memoryPath, []);
+    }
+    loadHistory() {
+        return this.readJson(this.historyPath, []);
+    }
+    saveHistory(messages) {
+        return this.enqueue(() => this.writeJsonAtomic(this.historyPath, messages));
+    }
+    clearHistory() {
+        return this.enqueue(async () => {
+            await rm(this.historyPath, { force: true });
+        });
+    }
+}
+function countOccurrences(haystack, needle) {
+    let count = 0;
+    let idx = haystack.indexOf(needle);
+    while (idx !== -1) {
+        count++;
+        idx = haystack.indexOf(needle, idx + needle.length);
+    }
+    return count;
+}
+//# sourceMappingURL=file-store.js.map

package/dist/memory/file-store.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,32 @@
+import type Anthropic from "@anthropic-ai/sdk";
+/**
+ * A single durable memory: a fact, lesson, or piece of context the agent
+ * accumulated. Kept deliberately small and atomic so retrieval can be selective.
+ */
+export interface MemoryEntry {
+    id: string;
+    /** Where it came from: "email", "slack", "onboarding", "self", … */
+    source: string;
+    /** Free-text content of the memory. */
+    text: string;
+    /** Optional tags for retrieval/filtering. */
+    tags: string[];
+    createdAt: string;
+}
+/**
+ * Persistence boundary for a single agent's state. The agent runtime depends on
+ * this interface only — back it with files (default), SQLite, Postgres, or a
+ * vector DB without touching the runtime.
+ */
+export interface MemoryStore {
+    /** Durable knowledge / context. */
+    addMemory(entry: Omit<MemoryEntry, "id" | "createdAt">): Promise<MemoryEntry>;
+    /** Keyword retrieval for the default store; replace with embeddings later. */
+    searchMemory(query: string, limit?: number): Promise<MemoryEntry[]>;
+    allMemories(): Promise<MemoryEntry[]>;
+    removeMemory(id: string): Promise<boolean>;
+    /** Conversation/episodic history — the running message transcript. */
+    loadHistory(): Promise<Anthropic.MessageParam[]>;
+    saveHistory(messages: Anthropic.MessageParam[]): Promise<void>;
+    clearHistory(): Promise<void>;
+}

package/dist/memory/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":""}

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,63 @@
+import type { RuntimeConfig } from "../config/index.js";
+import type { Logger } from "../core/logger.js";
+import { type ClaudeLike } from "../llm/claude.js";
+import { RunLog } from "../core/run-log.js";
+import { Agent, type RunHooks, type RunResult } from "../agent/agent.js";
+import type { AgentConfig } from "../agent/config.js";
+import type { MemoryStore } from "../memory/store.js";
+import { type ApprovalRequest, type Tool } from "../tools/tool.js";
+import { type InboundEvent } from "../connectors/index.js";
+import type { TriggerKind } from "../core/run-log.js";
+export interface DispatchOptions {
+    hooks?: RunHooks;
+    trigger?: {
+        kind: TriggerKind;
+        detail?: string;
+    };
+    /** Per-run cancellation (combined with the orchestrator's shutdown signal). */
+    signal?: AbortSignal;
+}
+/**
+ * Runs and supervises many agents at once. Responsibilities:
+ *  - build each agent's Claude client, tool registry (builtins + connector tools),
+ *    memory store, run log, and dedup state;
+ *  - initialize the agent's connectors;
+ *  - route inbound connector events to the owning agent's run loop (with
+ *    at-least-once dedup persisted across restarts);
+ *  - fire the agent's schedules;
+ *  - serialize each agent's runs so a single agent never overlaps itself.
+ */
+export declare class Orchestrator {
+    private readonly config;
+    private readonly log;
+    private readonly approve;
+    private readonly claude;
+    private readonly managed;
+    private readonly queues;
+    private readonly abort;
+    private readonly extraTools;
+    /** Optional observer for inbound events that pass dedup (CLI flash lines). */
+    onInboundEvent?: (agentId: string, event: InboundEvent) => void;
+    constructor(config: RuntimeConfig, log: Logger, approve: (req: ApprovalRequest) => Promise<boolean>, opts?: {
+        claude?: ClaudeLike;
+        extraTools?: Tool[];
+    });
+    /** Builds an agent from its config and registers it (does not start listening). */
+    addAgent(cfg: AgentConfig): Promise<Agent>;
+    /** Feeds one input to an agent, serialized behind that agent's queue. */
+    dispatch(agentId: string, input: string, options?: DispatchOptions): Promise<RunResult>;
+    /** Direct access to an agent's stores, for the memory/history/costs CLI. */
+    resources(agentId: string): {
+        memory: MemoryStore;
+        runLog: RunLog;
+    };
+    /**
+     * Starts every agent's connectors listening, arms schedules, and routes
+     * inbound events to the owning agent. Resolves after shutdown() aborts and
+     * listeners have settled.
+     */
+    start(): Promise<void>;
+    private handleEvent;
+    shutdown(): Promise<void>;
+    agentIds(): string[];
+}

package/dist/orchestrator/orchestrator.js

@@ -0,0 +1,181 @@
+import { ClaudeClient } from "../llm/claude.js";
+import { RunLog } from "../core/run-log.js";
+import { Agent } from "../agent/agent.js";
+import { FileMemoryStore } from "../memory/file-store.js";
+import { ToolRegistry } from "../tools/tool.js";
+import { builtinTools } from "../tools/builtin.js";
+import { createConnector, renderEventInput, } from "../connectors/index.js";
+import { abortedPromise } from "../connectors/connector.js";
+import { Scheduler } from "./scheduler.js";
+import { SeenEvents } from "./seen-events.js";
+/**
+ * Runs and supervises many agents at once. Responsibilities:
+ *  - build each agent's Claude client, tool registry (builtins + connector tools),
+ *    memory store, run log, and dedup state;
+ *  - initialize the agent's connectors;
+ *  - route inbound connector events to the owning agent's run loop (with
+ *    at-least-once dedup persisted across restarts);
+ *  - fire the agent's schedules;
+ *  - serialize each agent's runs so a single agent never overlaps itself.
+ */
+export class Orchestrator {
+    config;
+    log;
+    approve;
+    claude;
+    managed = new Map();
+    queues = new Map();
+    abort = new AbortController();
+    extraTools;
+    /** Optional observer for inbound events that pass dedup (CLI flash lines). */
+    onInboundEvent;
+    constructor(config, log, approve, opts = {}) {
+        this.config = config;
+        this.log = log;
+        this.approve = approve;
+        // Demo mode injects a scripted brain; everything else is identical.
+        this.claude = opts.claude ?? new ClaudeClient(config.anthropicApiKey, config.defaultModel, log);
+        this.extraTools = opts.extraTools ?? [];
+    }
+    /** Builds an agent from its config and registers it (does not start listening). */
+    async addAgent(cfg) {
+        if (this.managed.has(cfg.id)) {
+            throw new Error(`agent "${cfg.id}" already added`);
+        }
+        const log = this.log.child({ scope: "orchestrator", agentId: cfg.id });
+        const memory = new FileMemoryStore(this.config.dataDir, cfg.id);
+        const runLog = new RunLog(this.config.dataDir, cfg.id);
+        const seen = new SeenEvents(this.config.dataDir, cfg.id);
+        const tools = new ToolRegistry();
+        for (const t of builtinTools(memory))
+            tools.register(t);
+        for (const t of this.extraTools)
+            tools.register(t);
+        const connectors = [];
+        for (const connectorId of cfg.connectors) {
+            const { connector, config } = createConnector(connectorId);
+            await connector.init({ log, config });
+            for (const t of connector.tools())
+                tools.register(t);
+            connectors.push(connector);
+        }
+        const agent = new Agent({
+            id: cfg.id,
+            persona: cfg.persona,
+            model: cfg.model ?? this.config.defaultModel,
+            effort: cfg.effort,
+            maxIterations: cfg.maxIterations,
+            toolPolicies: cfg.toolPolicies,
+            contextBudgetTokens: this.config.contextBudgetTokens,
+        }, {
+            claude: this.claude,
+            tools,
+            memory,
+            log,
+            actionPolicy: this.config.actionPolicy,
+            approve: this.approve,
+            runLog,
+        });
+        this.managed.set(cfg.id, { agent, config: cfg, connectors, memory, runLog, seen });
+        log.info("agent ready", {
+            persona: cfg.persona.name,
+            tools: tools.size,
+            connectors: cfg.connectors.join(",") || "none",
+            schedules: cfg.schedules.length,
+        });
+        return agent;
+    }
+    /** Feeds one input to an agent, serialized behind that agent's queue. */
+    async dispatch(agentId, input, options = {}) {
+        const managed = this.managed.get(agentId);
+        if (!managed)
+            throw new Error(`no such agent: ${agentId}`);
+        const signal = options.signal ? AbortSignal.any([this.abort.signal, options.signal]) : this.abort.signal;
+        const prior = this.queues.get(agentId) ?? Promise.resolve();
+        const next = prior
+            .catch(() => undefined) // a failed prior run must not poison the queue
+            .then(() => managed.agent.run(input, {
+            signal,
+            hooks: options.hooks,
+            trigger: options.trigger,
+        }));
+        this.queues.set(agentId, next);
+        return next;
+    }
+    /** Direct access to an agent's stores, for the memory/history/costs CLI. */
+    resources(agentId) {
+        const managed = this.managed.get(agentId);
+        if (!managed)
+            throw new Error(`no such agent: ${agentId}`);
+        return { memory: managed.memory, runLog: managed.runLog };
+    }
+    /**
+     * Starts every agent's connectors listening, arms schedules, and routes
+     * inbound events to the owning agent. Resolves after shutdown() aborts and
+     * listeners have settled.
+     */
+    async start() {
+        const listeners = [];
+        let listenerCount = 0;
+        for (const [agentId, managed] of this.managed) {
+            // Connector listeners → dedup → agent queue.
+            for (const connector of managed.connectors) {
+                if (!connector.listen)
+                    continue;
+                listenerCount++;
+                const onEvent = (event) => void this.handleEvent(agentId, managed, event);
+                listeners.push(connector.listen(onEvent, this.abort.signal).catch((err) => {
+                    this.log.error("connector listener crashed", {
+                        agentId,
+                        connector: connector.id,
+                        error: err.message,
+                    });
+                }));
+            }
+            // Schedules → agent queue.
+            if (managed.config.schedules.length > 0) {
+                managed.scheduler = new Scheduler(managed.config.schedules, (schedule) => {
+                    const detail = schedule.every ? `every ${schedule.every}` : `daily at ${schedule.dailyAt}`;
+                    this.log.info("schedule fired", { agentId, detail });
+                    void this.dispatch(agentId, schedule.input, { trigger: { kind: "schedule", detail } }).catch((err) => this.log.error("scheduled run failed", { agentId, error: err.message }));
+                });
+                managed.scheduler.start();
+            }
+        }
+        this.log.info("orchestrator started", { agents: this.managed.size, listeners: listenerCount });
+        await abortedPromise(this.abort.signal);
+        await Promise.allSettled(listeners);
+    }
+    async handleEvent(agentId, managed, event) {
+        try {
+            const fresh = await managed.seen.markSeen(`${event.connector}:${event.eventId}`);
+            if (!fresh) {
+                this.log.debug("duplicate event dropped", { agentId, eventId: event.eventId });
+                return;
+            }
+            this.log.info("inbound event", { agentId, connector: event.connector, type: event.type });
+            this.onInboundEvent?.(agentId, event);
+            await this.dispatch(agentId, renderEventInput(event), {
+                trigger: { kind: "event", detail: `${event.type} ${event.threadId}` },
+            });
+        }
+        catch (err) {
+            this.log.error("event dispatch failed", { agentId, error: err.message });
+        }
+    }
+    async shutdown() {
+        this.abort.abort();
+        for (const managed of this.managed.values()) {
+            managed.scheduler?.stop();
+            for (const connector of managed.connectors) {
+                await connector.shutdown?.().catch(() => undefined);
+            }
+            await managed.seen.persist().catch(() => undefined);
+        }
+        this.log.info("orchestrator stopped");
+    }
+    agentIds() {
+        return [...this.managed.keys()];
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator/orchestrator.js.map

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

package/dist/orchestrator/scheduler.d.ts

@@ -0,0 +1,33 @@
+import type { Schedule } from "../agent/config.js";
+/**
+ * Fires an agent's scheduled inputs. Two forms:
+ *  - { every: "15m" }  — fixed interval from start
+ *  - { dailyAt: "09:00" } — local wall-clock time, once a day
+ *
+ * The clock is injectable so tests can drive it deterministically.
+ */
+export interface SchedulerClock {
+    now(): number;
+    setTimeout(fn: () => void, ms: number): NodeJS.Timeout | number;
+    clearTimeout(handle: NodeJS.Timeout | number): void;
+}
+export declare function parseDuration(spec: string): number;
+/** Milliseconds from `now` until the next local occurrence of HH:MM. */
+export declare function msUntilDailyAt(timeSpec: string, now: number): number;
+export declare function msUntilNext(schedule: Schedule, now: number): number;
+/**
+ * Runs one agent's schedules until stopped. Fires are delivered through
+ * `onFire`; overlapping work is the dispatcher's problem (the orchestrator
+ * serializes per-agent runs).
+ */
+export declare class Scheduler {
+    private readonly schedules;
+    private readonly onFire;
+    private readonly clock;
+    private readonly handles;
+    private stopped;
+    constructor(schedules: Schedule[], onFire: (schedule: Schedule) => void, clock?: SchedulerClock);
+    start(): void;
+    private arm;
+    stop(): void;
+}

package/dist/orchestrator/scheduler.js

@@ -0,0 +1,67 @@
+const realClock = {
+    now: () => Date.now(),
+    setTimeout: (fn, ms) => setTimeout(fn, ms),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+export function parseDuration(spec) {
+    const match = /^(\d+)(s|m|h|d)$/.exec(spec);
+    if (!match)
+        throw new Error(`invalid duration "${spec}" (use e.g. "30s", "15m", "2h", "1d")`);
+    const value = Number(match[1]);
+    const unit = match[2];
+    return value * { s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000 }[unit];
+}
+/** Milliseconds from `now` until the next local occurrence of HH:MM. */
+export function msUntilDailyAt(timeSpec, now) {
+    const [hours, minutes] = timeSpec.split(":").map(Number);
+    const next = new Date(now);
+    next.setHours(hours, minutes, 0, 0);
+    if (next.getTime() <= now)
+        next.setDate(next.getDate() + 1);
+    return next.getTime() - now;
+}
+export function msUntilNext(schedule, now) {
+    if (schedule.every)
+        return parseDuration(schedule.every);
+    return msUntilDailyAt(schedule.dailyAt, now);
+}
+/**
+ * Runs one agent's schedules until stopped. Fires are delivered through
+ * `onFire`; overlapping work is the dispatcher's problem (the orchestrator
+ * serializes per-agent runs).
+ */
+export class Scheduler {
+    schedules;
+    onFire;
+    clock;
+    handles = [];
+    stopped = false;
+    constructor(schedules, onFire, clock = realClock) {
+        this.schedules = schedules;
+        this.onFire = onFire;
+        this.clock = clock;
+    }
+    start() {
+        for (const schedule of this.schedules)
+            this.arm(schedule);
+    }
+    arm(schedule) {
+        if (this.stopped)
+            return;
+        const delay = msUntilNext(schedule, this.clock.now());
+        const handle = this.clock.setTimeout(() => {
+            if (this.stopped)
+                return;
+            this.onFire(schedule);
+            this.arm(schedule); // chain the next occurrence
+        }, delay);
+        this.handles.push(handle);
+    }
+    stop() {
+        this.stopped = true;
+        for (const handle of this.handles)
+            this.clock.clearTimeout(handle);
+        this.handles.length = 0;
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/orchestrator/scheduler.js.map

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

package/dist/orchestrator/seen-events.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Persisted at-least-once dedup for inbound events. Connectors may redeliver
+ * (Slack retries unacked envelopes, polls overlap, processes restart); the
+ * orchestrator drops anything whose event id it has already dispatched.
+ * Keeps a bounded FIFO of recent keys per agent, persisted to disk.
+ */
+export declare class SeenEvents {
+    private readonly capacity;
+    private readonly path;
+    private keys;
+    private readonly index;
+    private loaded;
+    private persistTimer?;
+    constructor(dataDir: string, agentId: string, capacity?: number);
+    private load;
+    /** Returns true the first time a key is seen; false on duplicates. */
+    markSeen(key: string): Promise<boolean>;
+    /** Debounced write so event bursts don't thrash the disk. */
+    private schedulePersist;
+    persist(): Promise<void>;
+}

package/dist/orchestrator/seen-events.js

@@ -0,0 +1,71 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+/**
+ * Persisted at-least-once dedup for inbound events. Connectors may redeliver
+ * (Slack retries unacked envelopes, polls overlap, processes restart); the
+ * orchestrator drops anything whose event id it has already dispatched.
+ * Keeps a bounded FIFO of recent keys per agent, persisted to disk.
+ */
+export class SeenEvents {
+    capacity;
+    path;
+    keys = [];
+    index = new Set();
+    loaded = false;
+    persistTimer;
+    constructor(dataDir, agentId, capacity = 500) {
+        this.capacity = capacity;
+        this.path = join(dataDir, "agents", agentId, "seen-events.json");
+    }
+    async load() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        try {
+            const stored = JSON.parse(await readFile(this.path, "utf8"));
+            this.keys = stored.slice(-this.capacity);
+            for (const key of this.keys)
+                this.index.add(key);
+        }
+        catch {
+            // missing or corrupt file — start fresh
+        }
+    }
+    /** Returns true the first time a key is seen; false on duplicates. */
+    async markSeen(key) {
+        await this.load();
+        if (this.index.has(key))
+            return false;
+        this.keys.push(key);
+        this.index.add(key);
+        while (this.keys.length > this.capacity) {
+            const evicted = this.keys.shift();
+            if (evicted)
+                this.index.delete(evicted);
+        }
+        this.schedulePersist();
+        return true;
+    }
+    /** Debounced write so event bursts don't thrash the disk. */
+    schedulePersist() {
+        if (this.persistTimer)
+            return;
+        this.persistTimer = setTimeout(() => {
+            this.persistTimer = undefined;
+            void this.persist();
+        }, 250);
+        this.persistTimer.unref?.();
+    }
+    async persist() {
+        if (this.persistTimer) {
+            clearTimeout(this.persistTimer);
+            this.persistTimer = undefined;
+        }
+        await mkdir(dirname(this.path), { recursive: true });
+        const tmp = `${this.path}.${randomUUID().slice(0, 8)}.tmp`;
+        await writeFile(tmp, JSON.stringify(this.keys), "utf8");
+        await rename(tmp, this.path);
+    }
+}
+//# sourceMappingURL=seen-events.js.map

package/dist/orchestrator/seen-events.js.map

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