pi-harness-runtime 0.10.12 → 0.10.13

package/packages/scheduler-adapter/dist/interface.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Scheduler Adapter — Common Interface
+ * RFC-0101 §6
+ *
+ * All scheduler adapters implement this interface.
+ * The runtime selects an adapter at install time and uses it for all scheduled tasks.
+ */
+export type ScheduledTask = {
+    id: string;
+    taskTemplate: Record<string, unknown>;
+    schedule: {
+        kind: "cron";
+        expression: string;
+    } | {
+        kind: "interval";
+        intervalMs: number;
+    } | {
+        kind: "once";
+        at: string;
+    };
+    enabled: boolean;
+    lastFiredAt?: string;
+    nextFireAt?: string;
+};
+/**
+ * Supported scheduler adapter backends.
+ * Set at install time; can be changed via config.
+ */
+export type SchedulerAdapterKind = "systemd" | "cron" | "launchd" | "internal";
+export interface SchedulerAdapter {
+    /** Human-readable name. */
+    readonly name: SchedulerAdapterKind;
+    /**
+     * Install the scheduler adapter.
+     * Idempotent — re-running does not duplicate units.
+     * @throws if installation fails (e.g. no systemd on this system)
+     */
+    install(): Promise<void>;
+    /**
+     * Schedule a task. Installs the timer/unit if not yet installed.
+     * @param task The scheduled task to materialise
+     */
+    schedule(task: ScheduledTask): Promise<void>;
+    /**
+     * Remove a scheduled task.
+     * @param taskId The id of the task to unschedule
+     */
+    unschedule(taskId: string): Promise<void>;
+    /**
+     * List all scheduled tasks currently installed by this adapter.
+     */
+    listScheduled(): Promise<ScheduledTask[]>;
+    /**
+     * Check if the adapter is healthy (e.g. systemd is running).
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/packages/scheduler-adapter/dist/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../src/interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,aAAa,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,EACL;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GACxC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,gBAAgB;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IAEpC;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;OAEG;IACH,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE1C;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D"}

package/packages/scheduler-adapter/dist/interface.js

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

package/packages/scheduler-adapter/dist/interface.js.map

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

package/packages/scheduler-adapter/dist/internal.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Scheduler Adapter — Internal (In-Process) Backend
+ * RFC-0101 §6
+ *
+ * Uses in-process setTimeout / setInterval for scheduling.
+ * Useful for testing, local development, and environments where
+ * systemd/cron are not available.
+ */
+import type { SchedulerAdapter, ScheduledTask } from "./interface.js";
+export declare class InternalAdapter implements SchedulerAdapter {
+    readonly name: "internal";
+    private tasks;
+    private handlers;
+    install(): Promise<void>;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        error?: string;
+    }>;
+    /**
+     * Register a task handler before scheduling.
+     * The adapter calls `handler(task)` when the task fires.
+     */
+    setHandler(handler: (task: ScheduledTask) => unknown): void;
+    schedule(task: ScheduledTask): Promise<void>;
+    unschedule(taskId: string): Promise<void>;
+    listScheduled(): Promise<ScheduledTask[]>;
+    /** Fire a task immediately (useful for testing). */
+    fireNow(taskId: string): void;
+}
+//# sourceMappingURL=internal.d.ts.map

package/packages/scheduler-adapter/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQtE,qBAAa,eAAgB,YAAW,gBAAgB;IACvD,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAEpC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,QAAQ,CAAuD;IAEjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAE7B;IAEK,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAEjE;IAED;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,GAAG,IAAI,CAE1D;IAEK,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAsCjD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9C;IAEK,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAE9C;IAED,oDAAoD;IACpD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAK5B;CACD"}

package/packages/scheduler-adapter/dist/internal.js

@@ -0,0 +1,82 @@
+/**
+ * Scheduler Adapter — Internal (In-Process) Backend
+ * RFC-0101 §6
+ *
+ * Uses in-process setTimeout / setInterval for scheduling.
+ * Useful for testing, local development, and environments where
+ * systemd/cron are not available.
+ */
+export class InternalAdapter {
+    name = "internal";
+    tasks = new Map();
+    handlers = new Map();
+    async install() {
+        // Nothing to install for in-process scheduling
+    }
+    async healthCheck() {
+        return { healthy: true };
+    }
+    /**
+     * Register a task handler before scheduling.
+     * The adapter calls `handler(task)` when the task fires.
+     */
+    setHandler(handler) {
+        this.handlers.set("default", handler);
+    }
+    async schedule(task) {
+        if (this.tasks.has(task.id)) {
+            await this.unschedule(task.id);
+        }
+        const handler = this.handlers.get("default");
+        if (!handler) {
+            throw new Error("[InternalAdapter] No task handler registered. Call setHandler() first.");
+        }
+        if (!task.enabled)
+            return; // skip disabled tasks
+        let delayMs;
+        if (task.schedule.kind === "once") {
+            delayMs = new Date(task.schedule.at).getTime() - Date.now();
+        }
+        else if (task.schedule.kind === "interval") {
+            delayMs = task.schedule.intervalMs;
+        }
+        else {
+            // cron — resolve to next occurrence (simplified: 1h from now)
+            delayMs = 3_600_000;
+        }
+        if (delayMs <= 0)
+            delayMs = 1000;
+        const tick = () => {
+            const t = this.tasks.get(task.id);
+            if (!t)
+                return;
+            handler(task);
+            // Re-schedule if interval
+            if (task.schedule.kind === "interval") {
+                t.timerId = setTimeout(tick, task.schedule.intervalMs);
+            }
+        };
+        const timerId = setTimeout(tick, delayMs);
+        this.tasks.set(task.id, { task, timerId, createdAt: new Date() });
+    }
+    async unschedule(taskId) {
+        const t = this.tasks.get(taskId);
+        if (t) {
+            clearTimeout(t.timerId);
+            this.tasks.delete(taskId);
+        }
+    }
+    async listScheduled() {
+        return Array.from(this.tasks.values()).map((t) => t.task);
+    }
+    /** Fire a task immediately (useful for testing). */
+    fireNow(taskId) {
+        const t = this.tasks.get(taskId);
+        if (!t)
+            return;
+        const handler = this.handlers.get("default");
+        if (handler)
+            handler(t.task);
+    }
+}
+//# sourceMappingURL=internal.js.map

package/packages/scheduler-adapter/dist/internal.js.map

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

package/packages/scheduler-adapter/dist/systemd.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Scheduler Adapter — systemd Backend
+ * RFC-0101 §6
+ *
+ * Uses systemd user timers as the scheduling backend.
+ * Each scheduled task becomes a .timer + .service unit pair.
+ * Works on any Linux system with systemd (no root required for user units).
+ */
+import type { SchedulerAdapter, ScheduledTask } from "./interface.js";
+/**
+ * Install systemd user units (runs `systemctl --user`).
+ * Must call this once before scheduling.
+ */
+export declare class SystemdAdapter implements SchedulerAdapter {
+    readonly name: "systemd";
+    /** Per-task unit files live in ~/.config/systemd/user/ */
+    private readonly unitDir;
+    private installed;
+    constructor(unitDir?: string);
+    install(): Promise<void>;
+    schedule(task: ScheduledTask): Promise<void>;
+    unschedule(taskId: string): Promise<void>;
+    listScheduled(): Promise<ScheduledTask[]>;
+    /** Convert a schedule to a systemd.timer OnCalendar or OnUnitActiveSec line. */
+    private _toTimerLine;
+    healthCheck(): Promise<{
+        healthy: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=systemd.d.ts.map

package/packages/scheduler-adapter/dist/systemd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemd.d.ts","sourceRoot":"","sources":["../src/systemd.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAItE;;;GAGG;AACH,qBAAa,cAAe,YAAW,gBAAgB;IACtD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,OAAO,CAAC,EAAE,MAAM,EAE3B;IAEK,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA0B7B;IAEK,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA8DjD;IAEK,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B9C;IAEK,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CA8B9C;IAED,gFAAgF;IAChF,OAAO,CAAC,YAAY;IAuBd,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CASjE;CACD"}

package/packages/scheduler-adapter/dist/systemd.js

@@ -0,0 +1,203 @@
+/**
+ * Scheduler Adapter — systemd Backend
+ * RFC-0101 §6
+ *
+ * Uses systemd user timers as the scheduling backend.
+ * Each scheduled task becomes a .timer + .service unit pair.
+ * Works on any Linux system with systemd (no root required for user units).
+ */
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+// ScheduledTask duplicated here — see interface.ts for details.
+/**
+ * Install systemd user units (runs `systemctl --user`).
+ * Must call this once before scheduling.
+ */
+export class SystemdAdapter {
+    name = "systemd";
+    /** Per-task unit files live in ~/.config/systemd/user/ */
+    unitDir;
+    installed = false;
+    constructor(unitDir) {
+        this.unitDir = unitDir ?? join(homedir(), ".config", "systemd", "user");
+    }
+    async install() {
+        // Verify systemd user mode is available
+        try {
+            execSync("systemctl --user show-environment >/dev/null 2>&1", {
+                stdio: "pipe",
+            });
+        }
+        catch {
+            throw new Error("[SystemdAdapter] systemd user mode is not available. " +
+                "Ensure systemd is running and $SYSTEMD_RUNTIME_DIRECTORY is set.");
+        }
+        // Ensure unit directory exists
+        if (!existsSync(this.unitDir)) {
+            mkdirSync(this.unitDir, { recursive: true });
+        }
+        // Reload systemd to pick up new units
+        try {
+            execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+        }
+        catch {
+            throw new Error("[SystemdAdapter] Failed to reload systemd daemon");
+        }
+        this.installed = true;
+    }
+    async schedule(task) {
+        if (!this.installed)
+            await this.install();
+        const id = task.id.replace(/[^a-zA-Z0-9_-]/g, "-");
+        const base = `pi-runtime-${id}`;
+        const servicePath = join(this.unitDir, `${base}.service`);
+        const timerPath = join(this.unitDir, `${base}.timer`);
+        const scriptPath = join(this.unitDir, `${base}.sh`);
+        // Build the run script
+        const runScript = [
+            "#!/usr/bin/env bash",
+            `# Generated by pi-harness-runtime — ${new Date().toISOString()}`,
+            "",
+            `PI_HARNESS_TASK_ID="${task.id}" \\`,
+            `PI_HARNESS_WORKER_ID="$(hostname)-$(id -u)" \\`,
+            `PI_HARNESS_RUNTIME_ROOT="${process.env.PI_HARNESS_RUNTIME_ROOT ?? join(homedir(), ".pi", "harness")}" \\`,
+            `exec "${process.env.PI_HARNESS_RUNTIME_ROOT}/bin/run-task.sh" \\`,
+            `  --task-id "${task.id}" \\`,
+            `  --worker-id "$PI_HARNESS_WORKER_ID"`,
+        ].join("\n");
+        // Write script
+        writeFileSync(scriptPath, runScript, { mode: 0o755 });
+        // Service unit: runs the script
+        const service = [
+            "[Unit]",
+            "Description=pi-harness-runtime task: ${task.id}",
+            "[Service]",
+            `ExecStart=${scriptPath}`,
+            "Type=oneshot",
+            "Environment=SYSTEMD_EXEC_PID=$$",
+            "[Install]",
+            "WantedBy=default.target",
+        ].join("\n");
+        // Timer unit: schedules the service
+        const timerContent = [
+            "[Unit]",
+            `Description=pi-harness-runtime schedule: ${task.id}`,
+            "[Timer]",
+            this._toTimerLine(task.schedule),
+            "Persistent=true",
+            "[Install]",
+            "WantedBy=timers.target",
+        ].join("\n");
+        writeFileSync(servicePath, service);
+        writeFileSync(timerPath, timerContent);
+        // Reload and enable
+        try {
+            execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+            execSync(`systemctl --user enable ${base}.timer`, { stdio: "pipe" });
+            execSync(`systemctl --user start ${base}.timer`, { stdio: "pipe" });
+        }
+        catch (e) {
+            const err = e;
+            throw new Error(`[SystemdAdapter] Failed to enable/start ${base}.timer: ${err?.message ?? String(e)}`);
+        }
+    }
+    async unschedule(taskId) {
+        const id = taskId.replace(/[^a-zA-Z0-9_-]/g, "-");
+        const base = `pi-runtime-${id}`;
+        const servicePath = join(this.unitDir, `${base}.service`);
+        const timerPath = join(this.unitDir, `${base}.timer`);
+        const scriptPath = join(this.unitDir, `${base}.sh`);
+        // Stop and disable
+        try {
+            execSync(`systemctl --user stop ${base}.timer`, { stdio: "pipe" });
+            execSync(`systemctl --user disable ${base}.timer`, { stdio: "pipe" });
+        }
+        catch {
+            // Ignore if not running
+        }
+        // Remove files
+        for (const p of [servicePath, timerPath, scriptPath]) {
+            try {
+                if (existsSync(p))
+                    unlinkSync(p);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        try {
+            execSync("systemctl --user daemon-reload", { stdio: "pipe" });
+        }
+        catch {
+            // Ignore
+        }
+    }
+    async listScheduled() {
+        try {
+            const out = execSync("systemctl --user list-timers --all --no-legend --output json 2>/dev/null | grep pi-runtime- || true", { encoding: "utf8" });
+            if (!out.trim())
+                return [];
+            let timers = [];
+            try {
+                timers = JSON.parse(out.trim());
+            }
+            catch {
+                return [];
+            }
+            return timers
+                .filter((t) => t.Unit?.startsWith("pi-runtime-"))
+                .map((t) => {
+                const id = (t.Unit ?? "").replace(/^pi-runtime-(.+)\.timer$/, "$1");
+                return {
+                    id,
+                    taskTemplate: {},
+                    schedule: { kind: "interval", intervalMs: 0 },
+                    enabled: true,
+                };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Convert a schedule to a systemd.timer OnCalendar or OnUnitActiveSec line. */
+    _toTimerLine(schedule) {
+        if (schedule.kind === "cron") {
+            // Convert cron to systemd calendar format
+            const parts = schedule.expression.trim().split(/\s+/);
+            if (parts.length >= 5) {
+                const [min, hour, dom, month] = parts;
+                return `OnCalendar=${dom}.${month}.* ${hour}:${min.padStart(2, "0")}`;
+            }
+            return `OnCalendar=${schedule.expression}`;
+        }
+        if (schedule.kind === "interval") {
+            const sec = Math.round(schedule.intervalMs / 1000);
+            if (sec >= 86400)
+                return `OnUnitActiveSec=${Math.round(sec / 86400)}d`;
+            if (sec >= 3600)
+                return `OnUnitActiveSec=${Math.round(sec / 3600)}h`;
+            if (sec >= 60)
+                return `OnUnitActiveSec=${Math.round(sec / 60)}min`;
+            return `OnUnitActiveSec=${sec}s`;
+        }
+        if (schedule.kind === "once") {
+            return `OnCalendar=${new Date(schedule.at).toISOString().split("T").join(" ")}`;
+        }
+        return "OnUnitActiveSec=1h"; // fallback
+    }
+    async healthCheck() {
+        try {
+            execSync("systemctl --user show-environment >/dev/null 2>&1", {
+                stdio: "pipe",
+            });
+            return { healthy: true };
+        }
+        catch {
+            return { healthy: false, error: "systemd user mode not available" };
+        }
+    }
+}
+//# sourceMappingURL=systemd.js.map

package/packages/scheduler-adapter/dist/systemd.js.map

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

package/packages/session/dist/history.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Session Manager - History
+ *
+ * Message history management and search.
+ */
+import type { Message, MessageSearchFilter, MessageSearchResult } from "./types.js";
+export declare class MessageHistory {
+    private messages;
+    private readonly maxMessages;
+    constructor(maxMessages?: number);
+    /**
+     * Initialize from existing messages
+     */
+    initialize(messages: Message[]): void;
+    /**
+     * Get all messages
+     */
+    getAll(): Message[];
+    /**
+     * Get messages by role
+     */
+    getByRole(role: Message["role"]): Message[];
+    /**
+     * Get recent messages
+     */
+    getRecent(count: number): Message[];
+    /**
+     * Get messages in a range
+     */
+    getRange(start: number, end: number): Message[];
+    /**
+     * Add a message
+     */
+    add(message: Omit<Message, "id">): Message;
+    /**
+     * Update a message
+     */
+    update(messageId: string, updates: Partial<Message>): Message | null;
+    /**
+     * Delete a message
+     */
+    delete(messageId: string): boolean;
+    /**
+     * Clear all messages
+     */
+    clear(): void;
+    /**
+     * Get message count
+     */
+    count(): number;
+    /**
+     * Trim oldest messages
+     */
+    private trimOldest;
+    /**
+     * Generate unique message ID
+     */
+    private generateId;
+    /**
+     * Export messages as array
+     */
+    toArray(): Message[];
+    /**
+     * Get token count estimate
+     */
+    getEstimatedTokenCount(): number;
+}
+export declare class MessageSearch {
+    private index;
+    /**
+     * Build index from session
+     */
+    buildIndex(sessionId: string, messages: Message[]): void;
+    /**
+     * Search messages
+     */
+    search(filter: MessageSearchFilter): MessageSearchResult[];
+    /**
+     * Calculate relevance score
+     */
+    private calculateScore;
+    /**
+     * Clear index
+     */
+    clear(): void;
+    /**
+     * Remove session from index
+     */
+    removeSession(sessionId: string): void;
+}
+export declare class ContextWindowManager {
+    private readonly maxTokens;
+    private history;
+    constructor(maxTokens?: number);
+    /**
+     * Initialize with messages
+     */
+    initialize(messages: Message[]): void;
+    /**
+     * Get messages that fit within token budget
+     */
+    getMessagesForContext(targetTokens: number): Message[];
+    /**
+     * Estimate tokens for a message
+     */
+    private estimateTokens;
+    /**
+     * Check if context would exceed window
+     */
+    wouldExceed(newMessageTokens: number): boolean;
+    /**
+     * Get remaining tokens
+     */
+    getRemainingTokens(): number;
+    /**
+     * Get all messages
+     */
+    getAll(): Message[];
+    /**
+     * Add message
+     */
+    add(message: Omit<Message, "id">): Message;
+}
+//# sourceMappingURL=history.d.ts.map

package/packages/session/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACX,OAAO,EACP,mBAAmB,EACnB,mBAAmB,EAEnB,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC,YAAY,WAAW,GAAE,MAAa,EAErC;IAED;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEpC;IAED;;OAEG;IACH,MAAM,IAAI,OAAO,EAAE,CAElB;IAED;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,EAAE,CAE1C;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,CAElC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,EAAE,CAE9C;IAED;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO,CAczC;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAWnE;IAED;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMjC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,KAAK,IAAI,MAAM,CAEd;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,IAAI,OAAO,EAAE,CAEnB;IAED;;OAEG;IACH,sBAAsB,IAAI,MAAM,CAK/B;CACD;AAID,qBAAa,aAAa;IACzB,OAAO,CAAC,KAAK,CAAqC;IAElD;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEvD;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CA4DzD;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAErC;CACD;AAID,qBAAa,oBAAoB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,OAAO,CAAiB;IAEhC,YAAY,SAAS,GAAE,MAAe,EAGrC;IAED;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEpC;IAED;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,EAAE,CAmBrD;IAED;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAG7C;IAED;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAG3B;IAED;;OAEG;IACH,MAAM,IAAI,OAAO,EAAE,CAElB;IAED;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,OAAO,CAEzC;CACD"}