neuron-inspector 0.8.0 → 0.8.1

package/dist/__tests__/scheduler.test.js

@@ -0,0 +1,316 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import YAML from "yaml";
+let testDir;
+let originalHome;
+beforeEach(() => {
+    testDir = fs.mkdtempSync(path.join(os.tmpdir(), "neuron-scheduler-test-"));
+    originalHome = process.env.HOME || "";
+    process.env.HOME = testDir;
+});
+afterEach(() => {
+    process.env.HOME = originalHome;
+    fs.rmSync(testDir, { recursive: true, force: true });
+});
+function schedulesPath() {
+    return path.join(testDir, ".neuron", "schedules.yaml");
+}
+function loadSchedules() {
+    if (!fs.existsSync(schedulesPath())) {
+        return { schedules: [] };
+    }
+    const content = fs.readFileSync(schedulesPath(), "utf-8");
+    return YAML.parse(content);
+}
+function saveSchedule(schedule) {
+    const neuronDir = path.join(testDir, ".neuron");
+    if (!fs.existsSync(neuronDir)) {
+        fs.mkdirSync(neuronDir, { recursive: true });
+    }
+    const data = loadSchedules();
+    data.schedules.push(schedule);
+    fs.writeFileSync(schedulesPath(), YAML.stringify(data), "utf-8");
+}
+describe("Schedule storage", () => {
+    it("creates schedules file when saving first schedule", () => {
+        const schedule = {
+            id: "test_123",
+            slug: "web-researcher",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: "2026-01-01T00:00:00Z",
+            run_count: 0,
+        };
+        saveSchedule(schedule);
+        expect(fs.existsSync(schedulesPath())).toBe(true);
+        const data = loadSchedules();
+        expect(data.schedules).toHaveLength(1);
+        expect(data.schedules[0].id).toBe("test_123");
+    });
+    it("loads existing schedules correctly", () => {
+        saveSchedule({
+            id: "sched_1",
+            slug: "recipe-a",
+            interval_minutes: 30,
+            enabled: true,
+            created_at: "2026-01-01T00:00:00Z",
+            run_count: 0,
+        });
+        saveSchedule({
+            id: "sched_2",
+            slug: "recipe-b",
+            cron_hour: 9,
+            enabled: false,
+            created_at: "2026-01-01T01:00:00Z",
+            run_count: 0,
+        });
+        const data = loadSchedules();
+        expect(data.schedules).toHaveLength(2);
+        expect(data.schedules[0].slug).toBe("recipe-a");
+        expect(data.schedules[1].slug).toBe("recipe-b");
+    });
+});
+describe("Schedule creation", () => {
+    it("generates unique IDs", () => {
+        const schedule1 = {
+            id: `sched_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
+            slug: "test",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        };
+        const schedule2 = {
+            id: `sched_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`,
+            slug: "test",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        };
+        expect(schedule1.id).toMatch(/^sched_\d+_[a-z0-9]+$/);
+        expect(schedule2.id).toMatch(/^sched_\d+_[a-z0-9]+$/);
+        expect(schedule1.id).not.toBe(schedule2.id);
+    });
+    it("validates interval vs cron exclusivity", () => {
+        const invalidSchedule = {
+            id: "test_invalid",
+            slug: "test",
+            interval_minutes: 60,
+            cron_hour: 9,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        };
+        expect(() => {
+            if (invalidSchedule.interval_minutes !== undefined && invalidSchedule.cron_hour !== undefined) {
+                throw new Error("Cannot specify both interval_minutes and cron_hour");
+            }
+        }).toThrow(/both interval_minutes and cron_hour/);
+    });
+    it("requires at least one timing parameter", () => {
+        const invalidSchedule = {
+            id: "test_invalid",
+            slug: "test",
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        };
+        expect(() => {
+            if (invalidSchedule.interval_minutes === undefined && invalidSchedule.cron_hour === undefined) {
+                throw new Error("Must specify either interval_minutes or cron_hour");
+            }
+        }).toThrow(/Must specify either/);
+    });
+});
+describe("Cron schedule calculation", () => {
+    function computeNextCronRun(hour, days) {
+        const now = new Date();
+        let next = new Date(now);
+        next.setHours(hour, 0, 0, 0);
+        if (next <= now) {
+            next.setDate(next.getDate() + 1);
+        }
+        if (days && days.length > 0) {
+            const maxIterations = 7;
+            let iterations = 0;
+            while (!days.includes(next.getDay()) && iterations < maxIterations) {
+                next.setDate(next.getDate() + 1);
+                iterations++;
+            }
+        }
+        return next;
+    }
+    it("schedules for today if time hasn't passed", () => {
+        const now = new Date();
+        const futureHour = (now.getHours() + 2) % 24;
+        const next = computeNextCronRun(futureHour);
+        if (futureHour > now.getHours()) {
+            expect(next.getDate()).toBe(now.getDate());
+        }
+        expect(next.getHours()).toBe(futureHour);
+        expect(next.getMinutes()).toBe(0);
+        expect(next.getSeconds()).toBe(0);
+    });
+    it("schedules for tomorrow if time has passed", () => {
+        const now = new Date();
+        const pastHour = (now.getHours() - 1 + 24) % 24;
+        const next = computeNextCronRun(pastHour);
+        if (pastHour < now.getHours()) {
+            const tomorrow = new Date(now);
+            tomorrow.setDate(tomorrow.getDate() + 1);
+            expect(next.getDate()).toBe(tomorrow.getDate());
+        }
+        expect(next.getHours()).toBe(pastHour);
+    });
+    it("respects day-of-week constraints", () => {
+        const next = computeNextCronRun(9, [1, 3, 5]); // Monday, Wednesday, Friday
+        expect([1, 3, 5]).toContain(next.getDay());
+        expect(next.getHours()).toBe(9);
+    });
+    it("finds next valid day within a week", () => {
+        const next = computeNextCronRun(9, [0]); // Only Sunday
+        expect(next.getDay()).toBe(0);
+        expect(next.getHours()).toBe(9);
+        const now = new Date();
+        const daysDiff = Math.floor((next.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+        expect(daysDiff).toBeLessThanOrEqual(7);
+    });
+});
+describe("Schedule toggle", () => {
+    it("enables and disables schedules", () => {
+        saveSchedule({
+            id: "toggle_test",
+            slug: "test",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        });
+        let data = loadSchedules();
+        expect(data.schedules[0].enabled).toBe(true);
+        data.schedules[0].enabled = false;
+        fs.writeFileSync(schedulesPath(), YAML.stringify(data), "utf-8");
+        data = loadSchedules();
+        expect(data.schedules[0].enabled).toBe(false);
+    });
+});
+describe("Schedule removal", () => {
+    it("removes schedule by ID", () => {
+        saveSchedule({
+            id: "remove_1",
+            slug: "keep-me",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        });
+        saveSchedule({
+            id: "remove_2",
+            slug: "delete-me",
+            interval_minutes: 30,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        });
+        let data = loadSchedules();
+        expect(data.schedules).toHaveLength(2);
+        data.schedules = data.schedules.filter((s) => s.id !== "remove_2");
+        fs.writeFileSync(schedulesPath(), YAML.stringify(data), "utf-8");
+        data = loadSchedules();
+        expect(data.schedules).toHaveLength(1);
+        expect(data.schedules[0].id).toBe("remove_1");
+    });
+    it("throws error for nonexistent schedule", () => {
+        const data = loadSchedules();
+        const idx = data.schedules.findIndex((s) => s.id === "nonexistent");
+        expect(() => {
+            if (idx === -1) {
+                throw new Error("Schedule nonexistent not found");
+            }
+        }).toThrow(/not found/);
+    });
+});
+describe("Schedule metadata", () => {
+    it("tracks run count", () => {
+        saveSchedule({
+            id: "count_test",
+            slug: "test",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: "2026-01-01T00:00:00Z",
+            run_count: 0,
+        });
+        let data = loadSchedules();
+        expect(data.schedules[0].run_count).toBe(0);
+        data.schedules[0].run_count += 1;
+        data.schedules[0].last_run_at = new Date().toISOString();
+        fs.writeFileSync(schedulesPath(), YAML.stringify(data), "utf-8");
+        data = loadSchedules();
+        expect(data.schedules[0].run_count).toBe(1);
+        expect(data.schedules[0].last_run_at).toBeDefined();
+    });
+    it("stores variables and rules", () => {
+        saveSchedule({
+            id: "vars_test",
+            slug: "test",
+            interval_minutes: 60,
+            variables: {
+                username: "testuser",
+                count: 10,
+            },
+            rules: ["Be polite", "Rate limit: 100/hour"],
+            enabled: true,
+            created_at: new Date().toISOString(),
+            run_count: 0,
+        });
+        const data = loadSchedules();
+        expect(data.schedules[0].variables).toEqual({
+            username: "testuser",
+            count: 10,
+        });
+        expect(data.schedules[0].rules).toEqual(["Be polite", "Rate limit: 100/hour"]);
+    });
+    it("updates next_run_at timestamp", () => {
+        const nextRun = new Date();
+        nextRun.setHours(nextRun.getHours() + 1);
+        saveSchedule({
+            id: "next_run_test",
+            slug: "test",
+            interval_minutes: 60,
+            enabled: true,
+            created_at: new Date().toISOString(),
+            next_run_at: nextRun.toISOString(),
+            run_count: 0,
+        });
+        const data = loadSchedules();
+        expect(data.schedules[0].next_run_at).toBeDefined();
+        expect(new Date(data.schedules[0].next_run_at).getTime()).toBeGreaterThan(Date.now());
+    });
+});
+describe("Pending runs", () => {
+    it("creates pending run entries", () => {
+        const neuronDir = path.join(testDir, ".neuron");
+        fs.mkdirSync(neuronDir, { recursive: true });
+        const pendingRunsPath = path.join(neuronDir, "pending-runs.yaml");
+        const pending = {
+            pending: [
+                {
+                    slug: "web-researcher",
+                    variables: { url: "https://example.com" },
+                    rules: ["Be thorough"],
+                    scheduled_at: new Date().toISOString(),
+                    schedule_id: "sched_123",
+                },
+            ],
+        };
+        fs.writeFileSync(pendingRunsPath, YAML.stringify(pending), "utf-8");
+        const loaded = YAML.parse(fs.readFileSync(pendingRunsPath, "utf-8"));
+        expect(loaded.pending).toHaveLength(1);
+        expect(loaded.pending[0].slug).toBe("web-researcher");
+        expect(loaded.pending[0].schedule_id).toBe("sched_123");
+    });
+});
+//# sourceMappingURL=scheduler.test.js.map

package/dist/__tests__/scheduler.test.js.map

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

package/dist/__tests__/session-state.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/session-state.test.js

@@ -0,0 +1,335 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+import { handleSessionTool as _handleSessionTool } from "../session-state.js";
+// Typed wrapper — all session tool results are plain objects
+const handleSessionTool = (name, args) => _handleSessionTool(name, args);
+let testDir;
+let originalHome;
+beforeEach(() => {
+    testDir = fs.mkdtempSync(path.join(os.tmpdir(), "neuron-session-test-"));
+    originalHome = process.env.HOME || "";
+    process.env.HOME = testDir;
+    // Pre-create sessions directory to avoid async mkdir issues in module
+    const sessionsDir = path.join(testDir, ".neuron", "sessions");
+    fs.mkdirSync(sessionsDir, { recursive: true });
+});
+afterEach(() => {
+    process.env.HOME = originalHome;
+    fs.rmSync(testDir, { recursive: true, force: true });
+});
+function sessionPath(sessionId) {
+    return path.join(testDir, ".neuron", "sessions", `${sessionId}.yaml`);
+}
+describe("neuron_session_save", () => {
+    it("creates new session with initial state", async () => {
+        const result = await handleSessionTool("neuron_session_save", {
+            session_id: "instagram-scrape",
+            cursor: 0,
+            working_set: ["user1", "user2", "user3"],
+            completed: [],
+            progress: { total: 3, done: 0 },
+            metadata: { target: "@testuser" },
+        });
+        expect(result).toMatchObject({
+            status: "saved",
+            session_id: "instagram-scrape",
+        });
+        expect(fs.existsSync(sessionPath("instagram-scrape"))).toBe(true);
+    });
+    it("merges with existing session state", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "merge-test",
+            cursor: 0,
+            working_set: ["a", "b", "c"],
+            completed: [],
+            progress: { total: 3 },
+        });
+        await handleSessionTool("neuron_session_save", {
+            session_id: "merge-test",
+            cursor: 1,
+            completed: ["a"],
+            progress: { done: 1 },
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "merge-test",
+        });
+        expect(loaded).toMatchObject({
+            cursor: 1,
+            working_set: ["a", "b", "c"],
+            completed: ["a"],
+            progress: { total: 3, done: 1 },
+        });
+    });
+    it("extracts recipe slug from session_id", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "instagram-scrape-batch1",
+            cursor: 0,
+            working_set: [],
+            completed: [],
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "instagram-scrape-batch1",
+        });
+        expect(loaded).toHaveProperty("recipe_slug", "instagram-scrape");
+    });
+    it("creates sessions directory if missing", async () => {
+        // Remove the pre-created sessions dir for this test
+        const sessionsDir = path.join(testDir, ".neuron", "sessions");
+        fs.rmSync(sessionsDir, { recursive: true, force: true });
+        expect(fs.existsSync(sessionsDir)).toBe(false);
+        await handleSessionTool("neuron_session_save", {
+            session_id: "test",
+            cursor: 0,
+            working_set: [],
+            completed: [],
+        });
+        // Session file should exist now (directory will be created)
+        expect(fs.existsSync(sessionPath("test"))).toBe(true);
+    });
+});
+describe("neuron_session_load", () => {
+    it("returns null for nonexistent session", async () => {
+        const result = await handleSessionTool("neuron_session_load", {
+            session_id: "nonexistent",
+        });
+        expect(result).toBeNull();
+    });
+    it("loads existing session state", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "load-test",
+            cursor: 5,
+            working_set: ["a", "b", "c"],
+            completed: ["x", "y"],
+            progress: { done: 2, total: 5 },
+            metadata: { source: "api" },
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "load-test",
+        });
+        expect(loaded).toMatchObject({
+            session_id: "load-test",
+            cursor: 5,
+            working_set: ["a", "b", "c"],
+            completed: ["x", "y"],
+            progress: { done: 2, total: 5 },
+            metadata: { source: "api" },
+        });
+    });
+    it("includes timestamps", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "timestamp-test",
+            cursor: 0,
+            working_set: [],
+            completed: [],
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "timestamp-test",
+        });
+        expect(loaded).toHaveProperty("created_at");
+        expect(loaded).toHaveProperty("updated_at");
+        expect(new Date(loaded.created_at).getTime()).toBeGreaterThan(0);
+    });
+});
+describe("neuron_session_list", () => {
+    it("returns empty array when no sessions exist", async () => {
+        const result = await handleSessionTool("neuron_session_list", {});
+        expect(result).toEqual({ sessions: [] });
+    });
+    it("lists all active sessions with summaries", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "session-1",
+            cursor: 0,
+            working_set: ["a", "b", "c"],
+            completed: [],
+            progress: { total: 3 },
+        });
+        await handleSessionTool("neuron_session_save", {
+            session_id: "session-2",
+            cursor: 2,
+            working_set: ["x", "y"],
+            completed: ["p", "q"],
+            progress: { total: 4 },
+        });
+        const result = await handleSessionTool("neuron_session_list", {});
+        expect(result.sessions).toHaveLength(2);
+        expect(result.sessions[0]).toMatchObject({
+            session_id: "session-1",
+            working_set_size: 3,
+            completed_size: 0,
+            checkpoints: 0,
+        });
+        expect(result.sessions[1]).toMatchObject({
+            session_id: "session-2",
+            working_set_size: 2,
+            completed_size: 2,
+            checkpoints: 0,
+        });
+    });
+    it("includes recipe slug in listings", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "instagram-batch1",
+            cursor: 0,
+            working_set: [],
+            completed: [],
+        });
+        const result = await handleSessionTool("neuron_session_list", {});
+        expect(result.sessions[0]).toHaveProperty("recipe_slug", "instagram");
+    });
+});
+describe("neuron_session_delete", () => {
+    it("deletes session file", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "delete-me",
+            cursor: 0,
+            working_set: [],
+            completed: [],
+        });
+        expect(fs.existsSync(sessionPath("delete-me"))).toBe(true);
+        const result = await handleSessionTool("neuron_session_delete", {
+            session_id: "delete-me",
+        });
+        expect(result).toEqual({
+            status: "deleted",
+            session_id: "delete-me",
+        });
+        expect(fs.existsSync(sessionPath("delete-me"))).toBe(false);
+    });
+    it("returns not_found for nonexistent session", async () => {
+        const result = await handleSessionTool("neuron_session_delete", {
+            session_id: "nonexistent",
+        });
+        expect(result).toEqual({
+            status: "not_found",
+            session_id: "nonexistent",
+        });
+    });
+});
+describe("neuron_session_checkpoint", () => {
+    it("increments cursor and moves item to completed", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "checkpoint-test",
+            cursor: 0,
+            working_set: ["a", "b", "c"],
+            completed: [],
+        });
+        const result = await handleSessionTool("neuron_session_checkpoint", {
+            session_id: "checkpoint-test",
+            completed_item: { user: "a", status: "done" },
+        });
+        expect(result).toMatchObject({
+            status: "checkpoint_saved",
+            session_id: "checkpoint-test",
+            cursor: 1,
+            completed_count: 1,
+            checkpoints: 1,
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "checkpoint-test",
+        });
+        expect(loaded.cursor).toBe(1);
+        expect(loaded.completed).toHaveLength(1);
+        expect(loaded.completed[0]).toEqual({ user: "a", status: "done" });
+        expect(loaded.checkpoints).toBe(1);
+    });
+    it("tracks multiple checkpoints", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "multi-checkpoint",
+            cursor: 0,
+            working_set: ["a", "b", "c"],
+            completed: [],
+        });
+        await handleSessionTool("neuron_session_checkpoint", {
+            session_id: "multi-checkpoint",
+            completed_item: "a",
+        });
+        await handleSessionTool("neuron_session_checkpoint", {
+            session_id: "multi-checkpoint",
+            completed_item: "b",
+        });
+        await handleSessionTool("neuron_session_checkpoint", {
+            session_id: "multi-checkpoint",
+            completed_item: "c",
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "multi-checkpoint",
+        });
+        expect(loaded.cursor).toBe(3);
+        expect(loaded.completed).toEqual(["a", "b", "c"]);
+        expect(loaded.checkpoints).toBe(3);
+    });
+    it("throws error for nonexistent session", async () => {
+        await expect(handleSessionTool("neuron_session_checkpoint", {
+            session_id: "nonexistent",
+            completed_item: "test",
+        })).rejects.toThrow(/not found/);
+    });
+    it("updates timestamp on checkpoint", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "timestamp-checkpoint",
+            cursor: 0,
+            working_set: ["a"],
+            completed: [],
+        });
+        const before = await handleSessionTool("neuron_session_load", {
+            session_id: "timestamp-checkpoint",
+        });
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        await handleSessionTool("neuron_session_checkpoint", {
+            session_id: "timestamp-checkpoint",
+            completed_item: "a",
+        });
+        const after = await handleSessionTool("neuron_session_load", {
+            session_id: "timestamp-checkpoint",
+        });
+        expect(new Date(after.updated_at).getTime()).toBeGreaterThan(new Date(before.updated_at).getTime());
+    });
+    it("handles non-numeric cursors gracefully", async () => {
+        await handleSessionTool("neuron_session_save", {
+            session_id: "string-cursor",
+            cursor: "page-1",
+            working_set: ["a", "b"],
+            completed: [],
+        });
+        await handleSessionTool("neuron_session_checkpoint", {
+            session_id: "string-cursor",
+            completed_item: "a",
+        });
+        const loaded = await handleSessionTool("neuron_session_load", {
+            session_id: "string-cursor",
+        });
+        expect(loaded.cursor).toBe("page-1");
+        expect(loaded.completed).toEqual(["a"]);
+    });
+});
+describe("Session resumption flow", () => {
+    it("supports typical scraping workflow", async () => {
+        const sessionId = "instagram-scrape-test";
+        const users = ["user1", "user2", "user3", "user4", "user5"];
+        await handleSessionTool("neuron_session_save", {
+            session_id: sessionId,
+            cursor: 0,
+            working_set: users,
+            completed: [],
+            progress: { total: users.length, done: 0 },
+            metadata: { target: "@testaccount" },
+        });
+        for (let i = 0; i < 3; i++) {
+            await handleSessionTool("neuron_session_checkpoint", {
+                session_id: sessionId,
+                completed_item: { username: users[i], scraped_at: new Date().toISOString() },
+            });
+        }
+        const state = await handleSessionTool("neuron_session_load", {
+            session_id: sessionId,
+        });
+        expect(state.cursor).toBe(3);
+        expect(state.completed).toHaveLength(3);
+        expect(state.working_set).toHaveLength(5);
+        expect(state.checkpoints).toBe(3);
+        const remaining = state.working_set.slice(state.cursor);
+        expect(remaining).toEqual(["user4", "user5"]);
+    });
+});
+//# sourceMappingURL=session-state.test.js.map