loop-sdk 0.1.0

package/dist/loop.js

@@ -0,0 +1,403 @@
+import { Context } from './context.js';
+import { Logger } from './logger.js';
+import { readCheckpoint, writeCheckpoint, deleteCheckpoint, checkpointExists, } from './checkpoint.js';
+import { Emitter } from './events.js';
+export class Loop {
+    name;
+    _steps;
+    _plugins;
+    _emitter;
+    constructor(name) {
+        this.name = name;
+        this._steps = [];
+        this._plugins = [];
+        this._emitter = new Emitter();
+    }
+    step(name, fn, opts = {}) {
+        this._steps.push({ name, fn, opts });
+        return this;
+    }
+    /**
+     * Add a parallel step — all named functions run concurrently.
+     * The step only completes when every sub-step resolves.
+     * Each sub-step's return value is stored in ctx under its name.
+     *
+     * @example
+     * loop.parallel('gather', {
+     *   'fetch-prices':  async (ctx) => { ctx.set('fetch-prices', await getPrice()) },
+     *   'fetch-reviews': async (ctx) => { ctx.set('fetch-reviews', await getReviews()) },
+     * })
+     *
+     * loop.step('summarize', async (ctx) => {
+     *   const prices  = ctx.get('fetch-prices')
+     *   const reviews = ctx.get('fetch-reviews')
+     * })
+     */
+    parallel(name, fns, opts = {}) {
+        const parallelFn = async (ctx) => {
+            await Promise.all(Object.entries(fns).map(async ([subName, fn]) => {
+                const result = await fn(ctx);
+                if (result !== undefined)
+                    ctx.set(subName, result);
+            }));
+        };
+        this._steps.push({ name, fn: parallelFn, opts });
+        return this;
+    }
+    /**
+     * Run multiple loops concurrently and return all results.
+     *
+     * @example
+     * const logs = await Loop.runAll([
+     *   { loop: researchLoop, session: sessionA },
+     *   { loop: reportLoop,   session: sessionB },
+     * ])
+     */
+    static async runAll(jobs) {
+        const handles = jobs.map(({ loop, ...opts }) => loop.runBackground(opts));
+        return Promise.all(handles.map(h => h.wait()));
+    }
+    use(plugin) {
+        this._plugins.push(plugin);
+        return this;
+    }
+    on(event, listener) {
+        this._emitter.on(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this._emitter.off(event, listener);
+        return this;
+    }
+    /** Run steps against an existing Context — used by sub() and each(). */
+    async runWith(ctx) {
+        const loopStartMs = Date.now();
+        let stepsCompleted = 0;
+        let loopStatus = 'completed';
+        await this._emitter.emit('loop:start', {
+            loop: this.name, session: ctx.session.id, totalSteps: this._steps.length,
+        });
+        try {
+            for (let i = 0; i < this._steps.length; i++) {
+                const { name, fn, opts } = this._steps[i];
+                const startMs = Date.now();
+                process.stdout.write(`  [${i + 1}/${this._steps.length}] ${name} ... `);
+                await this._emitter.emit('step:start', { loop: this.name, step: name, index: i, total: this._steps.length });
+                try {
+                    await fn(ctx);
+                    console.log('ok');
+                    stepsCompleted++;
+                    await this._emitter.emit('step:complete', { loop: this.name, step: name, index: i, durationMs: Date.now() - startMs });
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    console.log(`ERROR: ${error.message}`);
+                    await this._emitter.emit('step:error', { loop: this.name, step: name, index: i, error, durationMs: Date.now() - startMs });
+                    const recovered = await this._runErrorHooks(error, { name, index: i }, ctx);
+                    if (recovered) {
+                        i--;
+                        continue;
+                    }
+                    loopStatus = 'failed';
+                    throw error;
+                }
+            }
+        }
+        finally {
+            await this._emitter.emit('loop:complete', {
+                loop: this.name, session: ctx.session.id,
+                status: loopStatus, durationMs: Date.now() - loopStartMs, stepsCompleted,
+            });
+        }
+    }
+    /** Full run: create a fresh Context, execute all steps, return a run log. */
+    async run({ session, vars = {}, logDir = null, startAt = null, stopAt = null, checkpointFile = null, resumeFrom = null, keepCheckpointOnSuccess = false, onError, signal = null, }) {
+        const logger = new Logger(logDir, this.name, session.id);
+        const ctx = new Context({ session, vars, logger, checkpointFile, emitter: this._emitter, signal });
+        ctx._loopName = this.name;
+        ctx._checkpointFile = checkpointFile;
+        // ── resume from checkpoint ───────────────────────────────────────────────
+        let resumeIndex = -1;
+        let checkpoint = null;
+        if (resumeFrom && checkpointExists(resumeFrom)) {
+            checkpoint = readCheckpoint(resumeFrom);
+            resumeIndex = checkpoint.lastCompletedIndex;
+            for (const [k, v] of Object.entries(checkpoint.state))
+                ctx.set(k, v);
+            ctx._completedSteps = [...checkpoint.completedSteps];
+            ctx._lastCompletedIndex = checkpoint.lastCompletedIndex;
+            console.log(`\nResuming: ${this.name} (from step ${resumeIndex + 2} of ${this._steps.length})`);
+            console.log(`Restored: ${Object.keys(checkpoint.state).length} state keys from ${resumeFrom}`);
+        }
+        else {
+            console.log(`\nLoop:    ${this.name}`);
+        }
+        console.log(`Session: ${session.id}`);
+        console.log(`Steps:   ${this._steps.length}`);
+        console.log('---');
+        const loopStartMs = Date.now();
+        const runLog = {
+            loop: this.name,
+            session: session.id,
+            startedAt: new Date().toISOString(),
+            finishedAt: '',
+            status: 'running',
+            steps: [],
+            ...(resumeFrom ? { resumedFrom: resumeFrom } : {}),
+        };
+        await this._emitter.emit('loop:start', {
+            loop: this.name,
+            session: session.id,
+            totalSteps: this._steps.length,
+            ...(resumeFrom ? { resumedFrom: resumeFrom } : {}),
+        });
+        for (let i = 0; i < this._steps.length; i++) {
+            const { name, fn, opts } = this._steps[i];
+            // Skip steps already completed in a prior run
+            if (i <= resumeIndex) {
+                console.log(`[${i + 1}/${this._steps.length}] ${name} ... skipped (completed in prior run)`);
+                await this._emitter.emit('step:skip', { loop: this.name, step: name, index: i, reason: 'checkpoint' });
+                runLog.steps.push({ name, status: 'skipped' });
+                continue;
+            }
+            // Check for cancellation before starting each step
+            if (signal?.aborted) {
+                console.log(`[${i + 1}/${this._steps.length}] ${name} ... cancelled`);
+                runLog.status = 'cancelled';
+                break;
+            }
+            if (startAt != null && i + 1 < startAt) {
+                console.log(`[${i + 1}/${this._steps.length}] ${name} ... skipped`);
+                await this._emitter.emit('step:skip', { loop: this.name, step: name, index: i, reason: 'range' });
+                continue;
+            }
+            if (stopAt != null && i + 1 > stopAt)
+                break;
+            const stepStartMs = Date.now();
+            process.stdout.write(`[${i + 1}/${this._steps.length}] ${name} ... `);
+            logger.stepStart(name);
+            await this._emitter.emit('step:start', { loop: this.name, step: name, index: i, total: this._steps.length });
+            // ── attempt the step ─────────────────────────────────────────────────
+            let stepSucceeded = false;
+            let lastErr = null;
+            try {
+                await fn(ctx);
+                stepSucceeded = true;
+            }
+            catch (err) {
+                lastErr = err instanceof Error ? err : new Error(String(err));
+            }
+            // ── step-level retries ───────────────────────────────────────────────
+            if (!stepSucceeded && (opts.retries ?? 0) > 0) {
+                for (let attempt = 0; attempt < (opts.retries ?? 0); attempt++) {
+                    const wait = computeDelay(attempt, opts.retryDelay ?? 0, opts.retryBackoff ?? 'flat');
+                    const label = `attempt ${attempt + 2}/${(opts.retries ?? 0) + 1}`;
+                    process.stdout.write(wait > 0 ? `\n  retrying in ${wait}ms (${label}) ... ` : `\n  retrying (${label}) ... `);
+                    if (wait > 0)
+                        await sleep(wait);
+                    await this._emitter.emit('step:retry', { loop: this.name, step: name, index: i, plugin: 'step.retries' });
+                    try {
+                        await fn(ctx);
+                        stepSucceeded = true;
+                        break;
+                    }
+                    catch (retryErr) {
+                        lastErr = retryErr instanceof Error ? retryErr : new Error(String(retryErr));
+                    }
+                }
+            }
+            // ── plugin onStepError hooks ─────────────────────────────────────────
+            if (!stepSucceeded) {
+                const pluginRetry = await this._runErrorHooks(lastErr, { name, index: i }, ctx);
+                if (pluginRetry) {
+                    i--;
+                    continue;
+                }
+            }
+            // ── step-level onError fallback ──────────────────────────────────────
+            if (!stepSucceeded && opts.onError) {
+                try {
+                    process.stdout.write(`\n  running fallback for "${name}" ... `);
+                    await opts.onError(lastErr, ctx);
+                    stepSucceeded = true;
+                    console.log('ok (fallback)');
+                    const durationMs = Date.now() - stepStartMs;
+                    logger.stepDone('fallback');
+                    runLog.steps.push({ name, status: 'recovered', error: lastErr.message });
+                    await this._emitter.emit('step:complete', { loop: this.name, step: name, index: i, durationMs });
+                }
+                catch (fallbackErr) {
+                    lastErr = fallbackErr instanceof Error ? fallbackErr : new Error(String(fallbackErr));
+                    console.log(`ERROR in fallback: ${lastErr.message}`);
+                }
+            }
+            // ── skipOnError ──────────────────────────────────────────────────────
+            if (!stepSucceeded && opts.skipOnError) {
+                console.log(`skipped (${lastErr.message})`);
+                await this._emitter.emit('step:skip', { loop: this.name, step: name, index: i, reason: 'error' });
+                runLog.steps.push({ name, status: 'skipped', error: lastErr.message });
+                continue;
+            }
+            // ── success path ─────────────────────────────────────────────────────
+            if (stepSucceeded && !runLog.steps.find(s => s.name === name)) {
+                const durationMs = Date.now() - stepStartMs;
+                console.log('ok');
+                logger.stepDone();
+                runLog.steps.push({ name, status: 'ok' });
+                await this._emitter.emit('step:complete', { loop: this.name, step: name, index: i, durationMs });
+                if (checkpointFile) {
+                    ctx._completedSteps.push(name);
+                    ctx._lastCompletedIndex = i;
+                    writeCheckpoint(checkpointFile, {
+                        loop: this.name,
+                        session: session.id,
+                        savedAt: new Date().toISOString(),
+                        completedSteps: [...ctx._completedSteps],
+                        lastCompletedIndex: i,
+                        state: ctx.snapshot(),
+                    });
+                    const count = ctx._completedSteps.length;
+                    console.log(`  ✓ checkpoint saved (${count}/${this._steps.length} steps) → ${checkpointFile}`);
+                    await this._emitter.emit('checkpoint:saved', {
+                        loop: this.name,
+                        file: checkpointFile,
+                        step: name,
+                        completedCount: count,
+                        totalSteps: this._steps.length,
+                    });
+                }
+            }
+            // ── unrecoverable failure ────────────────────────────────────────────
+            if (!stepSucceeded) {
+                const durationMs = Date.now() - stepStartMs;
+                console.log(`ERROR: ${lastErr.message}`);
+                await this._emitter.emit('step:error', { loop: this.name, step: name, index: i, error: lastErr, durationMs });
+                logger.stepError(lastErr);
+                runLog.steps.push({ name, status: 'error', error: lastErr.message });
+                runLog.status = 'failed';
+                // Loop-level onError handler
+                if (onError) {
+                    try {
+                        await onError(lastErr, ctx, name);
+                    }
+                    catch { }
+                }
+                break;
+            }
+        }
+        if (runLog.status === 'running') {
+            runLog.status = signal?.aborted ? 'cancelled' : 'completed';
+        }
+        runLog.finishedAt = new Date().toISOString();
+        logger.finish(runLog.status);
+        if (checkpointFile && runLog.status === 'completed' && !keepCheckpointOnSuccess) {
+            deleteCheckpoint(checkpointFile);
+        }
+        await this._emitter.emit('loop:complete', {
+            loop: this.name,
+            session: session.id,
+            status: runLog.status,
+            durationMs: Date.now() - loopStartMs,
+            stepsCompleted: runLog.steps.filter(s => s.status === 'ok' || s.status === 'recovered').length,
+        });
+        console.log('---');
+        console.log(`Loop ${runLog.status}.`);
+        if (logger.logFile)
+            console.log(`Log: ${logger.logFile}`);
+        return runLog;
+    }
+    /**
+     * Start the loop in the background and return a RunHandle immediately.
+     * Auto-generates a checkpoint file so pause/resume works without any configuration.
+     *
+     * @example
+     * const handle = loop.runBackground({ session })
+     *
+     * // Pause after the current step, resume later
+     * handle.pause()
+     * const handle2 = handle.resume()
+     * await handle2.wait()
+     *
+     * // Parallel loops
+     * const [log1, log2] = await Promise.all([h1.wait(), h2.wait()])
+     */
+    runBackground(opts) {
+        const id = `${this.name}-${Date.now()}`;
+        // Auto-generate a checkpoint path so pause/resume works out of the box.
+        // Respects a user-provided checkpointFile if one was passed.
+        const checkpointFile = opts.checkpointFile ?? `.loop/${id}.checkpoint.json`;
+        const controller = new AbortController();
+        let currentStatus = 'running';
+        const promise = this.run({ ...opts, checkpointFile, signal: controller.signal })
+            .then(log => {
+            // Don't overwrite 'paused' — the loop reports 'cancelled' internally when aborted,
+            // but we distinguish pause vs cancel at the handle level.
+            if (currentStatus !== 'paused')
+                currentStatus = log.status;
+            return log;
+        })
+            .catch(err => {
+            if (currentStatus !== 'paused') {
+                currentStatus = controller.signal.aborted ? 'cancelled' : 'failed';
+            }
+            throw err;
+        });
+        const loop = this;
+        const resumeOpts = { ...opts, checkpointFile };
+        return {
+            id,
+            get status() { return currentStatus; },
+            wait: () => promise,
+            cancel: () => {
+                if (currentStatus !== 'running')
+                    return;
+                currentStatus = 'cancelled';
+                controller.abort();
+            },
+            pause: () => {
+                if (currentStatus !== 'running')
+                    return;
+                currentStatus = 'paused';
+                controller.abort();
+                // The checkpoint was written after the last completed step automatically —
+                // nothing extra to do here. It will exist at checkpointFile when resume() is called.
+            },
+            resume: () => {
+                if (currentStatus !== 'paused') {
+                    throw new Error(`Cannot resume: loop is "${currentStatus}" (must be "paused")`);
+                }
+                return loop.runBackground({ ...resumeOpts, resumeFrom: checkpointFile });
+            },
+        };
+    }
+    async _runErrorHooks(err, step, ctx) {
+        for (const plugin of this._plugins) {
+            if (!plugin.hooks?.onStepError)
+                continue;
+            const recovered = await plugin.hooks.onStepError(err, step, ctx).catch(() => false);
+            if (recovered)
+                return true;
+        }
+        return false;
+    }
+}
+/** Functional API — define and run a loop in one call. */
+export async function run(name, session, fn, opts = {}) {
+    const loop = new Loop(name);
+    loop.step(name, fn);
+    return loop.run({ session, ...opts });
+}
+// ── helpers ──────────────────────────────────────────────────────────────────
+function computeDelay(attempt, base, backoff) {
+    if (base === 0)
+        return 0;
+    if (backoff === 'linear')
+        return base * (attempt + 1);
+    if (backoff === 'exponential')
+        return base * Math.pow(2, attempt);
+    return base;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=loop.js.map

package/dist/loop.js.map

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

package/dist/loopfile.d.ts

@@ -0,0 +1,82 @@
+import { Loop } from './loop.js';
+import type { Context } from './context.js';
+import type { Session } from './session.js';
+import type { RunOptions, RunLog, RunHandle } from './loop.js';
+export interface LoopFileMeta {
+    name: string;
+    /** Informational — tells the runner what session type to expect. */
+    session?: string;
+    /** Default model for claudeCli/agent steps. */
+    model?: string;
+}
+export interface LoopFileStep {
+    name: string;
+    /**
+     * Built-in actions: claudeCli | navigate | screenshot | log | sub | each
+     * Custom: any string key registered in the actions map passed to loadLoop()
+     */
+    action: string;
+    /** Prompt text. Supports {{step-name}} interpolation. */
+    prompt?: string;
+    /** Model override for this step. */
+    model?: string;
+    /** URL for navigate steps. Supports {{step-name}} interpolation. */
+    url?: string;
+    /** Message for log steps. Supports {{step-name}} interpolation. */
+    message?: string;
+    /** Path to another .loop file to run as a nested sub-loop. */
+    loop?: string;
+    /** Extra vars to pass into the sub-loop context. */
+    vars?: Record<string, unknown>;
+    /**
+     * Items to iterate over. Either a {{step-name}} reference (resolves from ctx)
+     * or a literal YAML array.
+     */
+    items?: string | unknown[];
+    /** Variable name for the current item inside each iteration. Default: 'item'. */
+    as?: string;
+    /** Inline step definitions for each iteration (alternative to referencing a loop file). */
+    steps?: LoopFileStep[];
+    /** Which step's output to collect per iteration. Defaults to the last step. */
+    output?: string;
+    /** If true, each continues past failed items instead of aborting. */
+    continueOnError?: boolean;
+    retries?: number;
+    retryDelay?: number;
+    retryBackoff?: 'flat' | 'linear' | 'exponential';
+    skipOnError?: boolean;
+    /** 'skip' is shorthand for skipOnError: true */
+    onError?: 'skip' | string;
+}
+export interface LoopFileSchema {
+    meta: LoopFileMeta;
+    steps: LoopFileStep[];
+}
+export declare function parseLoopFile(content: string): LoopFileSchema;
+export declare function loadLoopFile(filePath: string): LoopFileSchema;
+export type ActionRegistry = Record<string, (ctx: Context, step: LoopFileStep) => Promise<unknown>>;
+/**
+ * Load a .loop file and return a configured Loop instance ready to run.
+ *
+ * Built-in actions: claudeCli, navigate, screenshot, log, sub, each
+ * Pass `actions` to register custom action handlers.
+ */
+export declare function loadLoop(filePath: string, actions?: ActionRegistry): Loop;
+/**
+ * Load and run a .loop file in one call.
+ *
+ * @example
+ * await runFile('./research.loop', new PlaywrightSession('run-1'))
+ */
+export declare function runFile(filePath: string, session: Session, opts?: Omit<RunOptions, 'session'>, actions?: ActionRegistry): Promise<RunLog>;
+/**
+ * Load and run a .loop file in the background, returning a RunHandle immediately.
+ *
+ * @example
+ * const handle = runFileBackground('./research.loop', session)
+ * const handle2 = runFileBackground('./report.loop', session2)
+ *
+ * const [log1, log2] = await Promise.all([handle.wait(), handle2.wait()])
+ */
+export declare function runFileBackground(filePath: string, session: Session, opts?: Omit<RunOptions, 'session'>, actions?: ActionRegistry): RunHandle;
+//# sourceMappingURL=loopfile.d.ts.map

package/dist/loopfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopfile.d.ts","sourceRoot":"","sources":["../src/loopfile.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAI9D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAA;IAGd,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAA;IAGd,oEAAoE;IACpE,GAAG,CAAC,EAAE,MAAM,CAAA;IAGZ,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAGhB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAG9B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IAC1B,iFAAiF;IACjF,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,2FAA2F;IAC3F,KAAK,CAAC,EAAE,YAAY,EAAE,CAAA;IACtB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,eAAe,CAAC,EAAE,OAAO,CAAA;IAGzB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAA;IAChD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,EAAE,CAAA;CACtB;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,CAyB7D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAG7D;AAID,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AAEnG;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI,CAmB7E;AAED;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAM,EACtC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,IAAI,GAAE,IAAI,CAAC,UAAU,EAAE,SAAS,CAAM,EACtC,OAAO,GAAE,cAAmB,GAC3B,SAAS,CAGX"}