@pi-agents/loop 0.1.0

package/dist/parse-args.js

@@ -0,0 +1,51 @@
+/**
+ * /loop argument parser.
+ *
+ * Priority:
+ * 1. Leading interval token: "5m check the deploy"
+ * 2. Trailing "every" clause: "check the deploy every 20m"
+ * 3. Default 10m
+ */
+const INTERVAL_RE = /^\d+[smhd]$/;
+const TRAILING_EVERY_RE = /\s+every\s+(\d+)\s*([smhd]|seconds?|minutes?|hours?|days?)\s*$/i;
+const UNIT_MAP = {
+    s: "s", second: "s", seconds: "s",
+    m: "m", minute: "m", minutes: "m",
+    h: "h", hour: "h", hours: "h",
+    d: "d", day: "d", days: "d",
+};
+export function parseLoopArgs(args) {
+    const trimmed = args.trim();
+    if (!trimmed)
+        return null;
+    const tokens = trimmed.split(/\s+/);
+    // Rule 1: Leading interval token
+    if (tokens.length >= 2 && INTERVAL_RE.test(tokens[0])) {
+        return {
+            interval: tokens[0],
+            prompt: tokens.slice(1).join(" "),
+        };
+    }
+    // Rule 2: Trailing "every" clause
+    const everyMatch = trimmed.match(TRAILING_EVERY_RE);
+    if (everyMatch) {
+        const n = everyMatch[1];
+        const unitRaw = everyMatch[2].toLowerCase();
+        const unit = UNIT_MAP[unitRaw];
+        if (unit) {
+            const prompt = trimmed.slice(0, everyMatch.index).trim();
+            if (prompt) {
+                return {
+                    interval: `${n}${unit}`,
+                    prompt,
+                };
+            }
+        }
+    }
+    // Rule 3: Default 10m
+    return {
+        interval: "10m",
+        prompt: trimmed,
+    };
+}
+//# sourceMappingURL=parse-args.js.map

package/dist/parse-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../src/parse-args.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,iBAAiB,GAAG,iEAAiE,CAAC;AAE5F,MAAM,QAAQ,GAA2B;IACvC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IACjC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG;IACjC,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG;IAC7B,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG;CAC5B,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE1B,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpC,iCAAiC;IACjC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,OAAO;YACL,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;SAClC,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACpD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YACzD,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO;oBACL,QAAQ,EAAE,GAAG,CAAC,GAAG,IAAI,EAAE;oBACvB,MAAM;iBACP,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,OAAO;QACL,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,OAAO;KAChB,CAAC;AACJ,CAAC"}

package/dist/scheduler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Core scheduler engine.
+ *
+ * 1-second tick loop that checks all tasks, gates on agent idle state,
+ * fires prompts via pi.sendUserMessage(), and handles auto-expiry.
+ */
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import type { LoopConfig } from "./types.js";
+export declare class LoopScheduler {
+    private interval;
+    private isAgentBusy;
+    private pendingFires;
+    private pi;
+    private config;
+    private cwd;
+    private ctx;
+    constructor(pi: ExtensionAPI, config: LoopConfig, cwd: string);
+    setContext(ctx: ExtensionContext): void;
+    start(): void;
+    stop(): void;
+    setBusy(): void;
+    setIdle(): void;
+    private check;
+    private shouldFire;
+    private fire;
+    private drainPendingFires;
+    private isAgedOut;
+    private updateStatus;
+    /** Refresh status bar (called externally after task changes) */
+    refreshStatus(): void;
+}

package/dist/scheduler.js

@@ -0,0 +1,142 @@
+/**
+ * Core scheduler engine.
+ *
+ * 1-second tick loop that checks all tasks, gates on agent idle state,
+ * fires prompts via pi.sendUserMessage(), and handles auto-expiry.
+ */
+import { nextCronRunMs, cronGapMs } from "./cron.js";
+import { recurringJitterMs, oneShotJitterMs } from "./jitter.js";
+import { getAllTasks, getTask, updateTask, removeTask, writeDurableTasks, } from "./store.js";
+export class LoopScheduler {
+    interval = null;
+    isAgentBusy = false;
+    pendingFires = [];
+    pi;
+    config;
+    cwd;
+    ctx = null;
+    constructor(pi, config, cwd) {
+        this.pi = pi;
+        this.config = config;
+        this.cwd = cwd;
+    }
+    setContext(ctx) {
+        this.ctx = ctx;
+    }
+    start() {
+        if (this.interval)
+            return;
+        this.interval = setInterval(() => this.check(), this.config.checkIntervalMs);
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+    }
+    setBusy() {
+        this.isAgentBusy = true;
+    }
+    setIdle() {
+        this.isAgentBusy = false;
+        this.drainPendingFires();
+    }
+    check() {
+        const now = Date.now();
+        for (const task of getAllTasks()) {
+            if (this.shouldFire(task, now)) {
+                if (this.isAgentBusy) {
+                    // Queue for later, but only if not already queued
+                    if (!this.pendingFires.includes(task.id)) {
+                        this.pendingFires.push(task.id);
+                    }
+                }
+                else {
+                    this.fire(task);
+                }
+            }
+        }
+    }
+    shouldFire(task, now) {
+        // Compute the base next fire time
+        const anchor = task.lastFiredAt ?? task.createdAt;
+        const baseNext = nextCronRunMs(task.cron, anchor);
+        if (baseNext === null)
+            return false;
+        let fireTime;
+        if (task.recurring) {
+            // Forward jitter for recurring tasks
+            const gap = cronGapMs(task.cron, anchor);
+            const jitter = gap ? recurringJitterMs(task, gap, this.config) : 0;
+            fireTime = baseNext + jitter;
+        }
+        else {
+            // Backward jitter for one-shots
+            const jitter = oneShotJitterMs(task, baseNext, this.config);
+            fireTime = baseNext - jitter;
+        }
+        return now >= fireTime;
+    }
+    fire(task) {
+        // Notify UI
+        if (this.ctx?.hasUI) {
+            const label = task.label || task.prompt.slice(0, 40);
+            this.ctx.ui.notify(`Loop firing: ${label}`, "info");
+        }
+        // Inject prompt as user message
+        this.pi.sendUserMessage(task.prompt);
+        // Update fire time
+        task.lastFiredAt = Date.now();
+        if (task.recurring) {
+            if (this.isAgedOut(task)) {
+                // Final fire — remove the task
+                removeTask(task.id);
+                if (this.ctx?.hasUI) {
+                    this.ctx.ui.notify(`Loop ${task.id} expired after 7 days`, "warning");
+                }
+            }
+            else {
+                updateTask(task);
+            }
+        }
+        else {
+            // One-shot: remove after firing
+            removeTask(task.id);
+        }
+        // Persist durable tasks
+        if (task.durable) {
+            writeDurableTasks(this.cwd, this.config).catch(() => { });
+        }
+        this.updateStatus();
+    }
+    drainPendingFires() {
+        const ids = this.pendingFires.splice(0);
+        for (const id of ids) {
+            const task = getTask(id);
+            if (task) {
+                this.fire(task);
+            }
+        }
+    }
+    isAgedOut(task) {
+        if (this.config.recurringMaxAgeMs <= 0)
+            return false;
+        return Date.now() - task.createdAt >= this.config.recurringMaxAgeMs;
+    }
+    updateStatus() {
+        if (!this.ctx?.hasUI)
+            return;
+        const count = getAllTasks().length;
+        if (count > 0) {
+            this.ctx.ui.setStatus("pi-loop", `${count} loop${count === 1 ? "" : "s"} active`);
+        }
+        else {
+            this.ctx.ui.setStatus("pi-loop", undefined);
+        }
+    }
+    /** Refresh status bar (called externally after task changes) */
+    refreshStatus() {
+        this.updateStatus();
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/scheduler.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,17 @@
+/**
+ * LoopTask CRUD — in-memory Map + durable .pi-loop.json persistence.
+ * Includes file-based O_EXCL locking for multi-instance safety.
+ */
+import type { LoopConfig, LoopTask } from "./types.js";
+export declare function generateTaskId(): string;
+export declare function addTask(task: LoopTask): void;
+export declare function removeTask(id: string): boolean;
+export declare function getTask(id: string): LoopTask | undefined;
+export declare function getAllTasks(): LoopTask[];
+export declare function getTaskCount(): number;
+export declare function updateTask(task: LoopTask): void;
+export declare function clearAllTasks(): void;
+export declare function loadDurableTasks(cwd: string, config: LoopConfig): Promise<LoopTask[]>;
+export declare function writeDurableTasks(cwd: string, config: LoopConfig): Promise<void>;
+export declare function acquireLock(cwd: string, config: LoopConfig): Promise<boolean>;
+export declare function releaseLock(cwd: string, config: LoopConfig): Promise<void>;

package/dist/store.js

@@ -0,0 +1,104 @@
+/**
+ * LoopTask CRUD — in-memory Map + durable .pi-loop.json persistence.
+ * Includes file-based O_EXCL locking for multi-instance safety.
+ */
+import { readFile, writeFile, open, unlink } from "node:fs/promises";
+import { join } from "node:path";
+import { randomUUID } from "node:crypto";
+// --- In-memory store ---
+const tasks = new Map();
+export function generateTaskId() {
+    return randomUUID().replace(/-/g, "").slice(0, 8);
+}
+export function addTask(task) {
+    tasks.set(task.id, task);
+}
+export function removeTask(id) {
+    return tasks.delete(id);
+}
+export function getTask(id) {
+    return tasks.get(id);
+}
+export function getAllTasks() {
+    return Array.from(tasks.values());
+}
+export function getTaskCount() {
+    return tasks.size;
+}
+export function updateTask(task) {
+    tasks.set(task.id, task);
+}
+export function clearAllTasks() {
+    tasks.clear();
+}
+// --- Durable file persistence ---
+function durablePath(cwd, config) {
+    return join(cwd, config.durableFilePath);
+}
+function lockPath(cwd, config) {
+    return durablePath(cwd, config) + ".lock";
+}
+export async function loadDurableTasks(cwd, config) {
+    try {
+        const raw = await readFile(durablePath(cwd, config), "utf-8");
+        const data = JSON.parse(raw);
+        if (!Array.isArray(data.tasks))
+            return [];
+        return data.tasks;
+    }
+    catch {
+        return [];
+    }
+}
+export async function writeDurableTasks(cwd, config) {
+    const durableTasks = getAllTasks().filter((t) => t.durable);
+    const data = { tasks: durableTasks };
+    await writeFile(durablePath(cwd, config), JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+const STALE_LOCK_MS = 30_000;
+export async function acquireLock(cwd, config) {
+    const path = lockPath(cwd, config);
+    const content = {
+        pid: process.pid,
+        acquiredAt: Date.now(),
+    };
+    try {
+        const fd = await open(path, "wx");
+        await fd.writeFile(JSON.stringify(content));
+        await fd.close();
+        return true;
+    }
+    catch (err) {
+        if (err.code !== "EEXIST")
+            return false;
+        // Check for stale lock
+        try {
+            const raw = await readFile(path, "utf-8");
+            const lock = JSON.parse(raw);
+            if (Date.now() - lock.acquiredAt > STALE_LOCK_MS) {
+                // Stale lock — remove and retry
+                await unlink(path);
+                return acquireLock(cwd, config);
+            }
+        }
+        catch {
+            // Can't read lock file — someone else has it
+        }
+        return false;
+    }
+}
+export async function releaseLock(cwd, config) {
+    try {
+        const path = lockPath(cwd, config);
+        const raw = await readFile(path, "utf-8");
+        const lock = JSON.parse(raw);
+        // Only release if we own it
+        if (lock.pid === process.pid) {
+            await unlink(path);
+        }
+    }
+    catch {
+        // Lock file gone or can't read — fine
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/tools/cron-tools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * LLM-callable tools: cron_create, cron_delete, cron_list.
+ */
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { LoopConfig } from "../types.js";
+import type { LoopScheduler } from "../scheduler.js";
+export declare function registerCronTools(pi: ExtensionAPI, scheduler: LoopScheduler, config: LoopConfig, getCwd: () => string): void;

package/dist/tools/cron-tools.js

@@ -0,0 +1,129 @@
+/**
+ * LLM-callable tools: cron_create, cron_delete, cron_list.
+ */
+import { Type } from "@sinclair/typebox";
+import { parseCronExpression, nextCronRunMs, cronToHuman } from "../cron.js";
+import { addTask, removeTask, getAllTasks, getTaskCount, generateTaskId, writeDurableTasks, } from "../store.js";
+function result(text) {
+    return { content: [{ type: "text", text }], details: undefined };
+}
+export function registerCronTools(pi, scheduler, config, getCwd) {
+    // --- CronCreate ---
+    pi.registerTool({
+        name: "cron_create",
+        label: "Create Scheduled Task",
+        description: "Schedule a prompt to run at a future time, either recurring on a cron schedule or once at a specific time. " +
+            "The cron field uses standard 5-field format (minute hour day-of-month month day-of-week) in local time. " +
+            "Examples: '*/5 * * * *' = every 5 minutes, '0 */2 * * *' = every 2 hours, '30 14 * * *' = daily at 2:30 PM.",
+        parameters: Type.Object({
+            cron: Type.String({
+                description: "5-field cron expression in local time (minute hour dom month dow)",
+            }),
+            prompt: Type.String({
+                description: "Prompt to enqueue at fire time",
+            }),
+            recurring: Type.Boolean({
+                default: true,
+                description: "true = fire on every match; false = one-shot then delete",
+            }),
+            durable: Type.Boolean({
+                default: false,
+                description: "true = persist to .pi-loop.json across sessions; false = session-only",
+            }),
+        }),
+        promptSnippet: "cron_create — schedule a prompt to run on a cron schedule (recurring or one-shot)",
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const parsed = parseCronExpression(params.cron);
+            if (!parsed) {
+                return result(`Invalid cron expression: "${params.cron}". Use 5-field format: minute hour day-of-month month day-of-week`);
+            }
+            const nextRun = nextCronRunMs(params.cron, Date.now());
+            if (nextRun === null) {
+                return result(`Cron expression "${params.cron}" does not match any date in the next year.`);
+            }
+            if (getTaskCount() >= config.maxJobs) {
+                return result(`Maximum of ${config.maxJobs} scheduled tasks reached. Delete some tasks first.`);
+            }
+            const task = {
+                id: generateTaskId(),
+                cron: params.cron,
+                prompt: params.prompt,
+                createdAt: Date.now(),
+                recurring: params.recurring,
+                durable: params.durable,
+            };
+            addTask(task);
+            if (task.durable) {
+                await writeDurableTasks(getCwd(), config);
+            }
+            scheduler.refreshStatus();
+            const human = cronToHuman(params.cron);
+            const nextDate = new Date(nextRun).toLocaleString();
+            const expiryNote = params.recurring
+                ? ` Auto-expires after ${Math.round(config.recurringMaxAgeMs / (24 * 60 * 60 * 1000))} days.`
+                : " One-shot: will be deleted after firing.";
+            return result([
+                `Scheduled task created.`,
+                `  ID: ${task.id}`,
+                `  Schedule: ${human} (${params.cron})`,
+                `  Next fire: ${nextDate}`,
+                `  Prompt: ${task.prompt}`,
+                `  Recurring: ${params.recurring}`,
+                `  Durable: ${params.durable}`,
+                expiryNote,
+                `Cancel with: cron_delete { id: "${task.id}" } or /loop-kill ${task.id}`,
+            ].join("\n"));
+        },
+    });
+    // --- CronDelete ---
+    pi.registerTool({
+        name: "cron_delete",
+        label: "Cancel Scheduled Task",
+        description: "Cancel a scheduled cron task by ID. Use cron_list to see active tasks.",
+        parameters: Type.Object({
+            id: Type.String({ description: "Task ID to cancel" }),
+        }),
+        promptSnippet: "cron_delete — cancel a scheduled task by ID",
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            const removed = removeTask(params.id);
+            if (!removed) {
+                return result(`No task found with ID "${params.id}".`);
+            }
+            await writeDurableTasks(getCwd(), config).catch(() => { });
+            scheduler.refreshStatus();
+            return result(`Task ${params.id} cancelled.`);
+        },
+    });
+    // --- CronList ---
+    pi.registerTool({
+        name: "cron_list",
+        label: "List Scheduled Tasks",
+        description: "List all active scheduled cron tasks with their IDs, schedules, and next fire times.",
+        parameters: Type.Object({}),
+        promptSnippet: "cron_list — list all active scheduled tasks",
+        async execute(_toolCallId, _params, _signal, _onUpdate, _ctx) {
+            const tasks = getAllTasks();
+            if (tasks.length === 0) {
+                return result("No scheduled tasks.");
+            }
+            const now = Date.now();
+            const lines = tasks.map((t) => {
+                const human = cronToHuman(t.cron);
+                const next = nextCronRunMs(t.cron, t.lastFiredAt ?? t.createdAt);
+                const nextStr = next ? new Date(next).toLocaleString() : "unknown";
+                const age = Math.round((now - t.createdAt) / (60 * 1000));
+                const flags = [
+                    t.recurring ? "recurring" : "one-shot",
+                    t.durable ? "durable" : "session-only",
+                ].join(", ");
+                return [
+                    `[${t.id}] ${human} (${t.cron})`,
+                    `  Prompt: ${t.prompt}`,
+                    `  Next: ${nextStr} | Created: ${age}m ago | ${flags}`,
+                ].join("\n");
+            });
+            return result(`${tasks.length} scheduled task${tasks.length === 1 ? "" : "s"}:\n\n${lines.join("\n\n")}`);
+        },
+    });
+}
+//# sourceMappingURL=cron-tools.js.map

package/dist/tools/cron-tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+import { type Static } from "@sinclair/typebox";
+export declare const LoopTaskSchema: import("@sinclair/typebox").TObject<{
+    id: import("@sinclair/typebox").TString;
+    cron: import("@sinclair/typebox").TString;
+    prompt: import("@sinclair/typebox").TString;
+    createdAt: import("@sinclair/typebox").TNumber;
+    lastFiredAt: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TNumber>;
+    recurring: import("@sinclair/typebox").TBoolean;
+    durable: import("@sinclair/typebox").TBoolean;
+    label: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type LoopTask = Static<typeof LoopTaskSchema>;
+export interface LoopConfig {
+    maxJobs: number;
+    recurringMaxAgeMs: number;
+    recurringJitterFrac: number;
+    recurringJitterCapMs: number;
+    oneShotJitterMaxMs: number;
+    oneShotJitterFloorMs: number;
+    oneShotJitterMinuteMod: number;
+    checkIntervalMs: number;
+    durableFilePath: string;
+}
+export declare const DEFAULT_CONFIG: LoopConfig;
+export interface DurableFile {
+    tasks: LoopTask[];
+}

package/dist/types.js

@@ -0,0 +1,24 @@
+import { Type } from "@sinclair/typebox";
+// --- LoopTask schema (TypeBox for tool parameters) ---
+export const LoopTaskSchema = Type.Object({
+    id: Type.String(),
+    cron: Type.String(),
+    prompt: Type.String(),
+    createdAt: Type.Number(),
+    lastFiredAt: Type.Optional(Type.Number()),
+    recurring: Type.Boolean(),
+    durable: Type.Boolean(),
+    label: Type.Optional(Type.String()),
+});
+export const DEFAULT_CONFIG = {
+    maxJobs: 50,
+    recurringMaxAgeMs: 7 * 24 * 60 * 60 * 1000,
+    recurringJitterFrac: 0.1,
+    recurringJitterCapMs: 15 * 60 * 1000,
+    oneShotJitterMaxMs: 90 * 1000,
+    oneShotJitterFloorMs: 0,
+    oneShotJitterMinuteMod: 30,
+    checkIntervalMs: 1000,
+    durableFilePath: ".pi-loop.json",
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,wDAAwD;AAExD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;IACxB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACzC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;IACzB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;IACvB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CACpC,CAAC,CAAC;AAkBH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,OAAO,EAAE,EAAE;IACX,iBAAiB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IAC1C,mBAAmB,EAAE,GAAG;IACxB,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACpC,kBAAkB,EAAE,EAAE,GAAG,IAAI;IAC7B,oBAAoB,EAAE,CAAC;IACvB,sBAAsB,EAAE,EAAE;IAC1B,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,eAAe;CACjC,CAAC"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@pi-agents/loop",
+  "version": "0.1.0",
+  "description": "Recurring prompt execution and cron scheduling for pi-agent — /loop, cron_create, cron_delete, cron_list",
+  "author": "ArtemisAI",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/**",
+    "skills",
+    "config/default.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "skills": [
+      "./skills"
+    ]
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-agent-core": "*",
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@sinclair/typebox": "*"
+  },
+  "devDependencies": {
+    "@mariozechner/pi-agent-core": "*",
+    "@mariozechner/pi-ai": "*",
+    "@mariozechner/pi-coding-agent": "*",
+    "@sinclair/typebox": "^0.34.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "pi",
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "pi-agent",
+    "loop",
+    "cron",
+    "scheduler",
+    "recurring",
+    "automation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ArtemisAI/pi-loop.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ArtemisAI/pi-loop/issues"
+  },
+  "homepage": "https://github.com/ArtemisAI/pi-loop#readme",
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "dev": "pi -e ./src/index.ts -s ./skills",
+    "prepublishOnly": "npm run build"
+  }
+}