loop-sdk 0.1.0

package/dist/plugins/retry.js

@@ -0,0 +1,53 @@
+/**
+ * Global retry plugin — retries every failing step up to `attempts` times.
+ *
+ * For per-step retry control, use the `retries` / `retryDelay` / `retryBackoff`
+ * options on `loop.step()` instead. Both can coexist: step-level retries run
+ * first, then the plugin gets a chance if the step is still failing.
+ *
+ * @example
+ * import { RetryPlugin } from 'loop-sdk/plugins'
+ *
+ * loop.use(RetryPlugin({ attempts: 3, delay: 1000, backoff: 'exponential' }))
+ *
+ * // Only retry network errors:
+ * loop.use(RetryPlugin({
+ *   attempts: 5,
+ *   delay: 2000,
+ *   retryIf: (err) => err.message.includes('fetch failed'),
+ * }))
+ */
+export function RetryPlugin(opts = {}) {
+    const maxAttempts = opts.attempts ?? 3;
+    const delay = opts.delay ?? 1000;
+    const backoff = opts.backoff ?? 'flat';
+    const retryIf = opts.retryIf ?? (() => true);
+    // Track per-step attempt counts across retries
+    const counts = new Map();
+    return {
+        name: 'retry',
+        hooks: {
+            onStepError: async (err, step, ctx) => {
+                if (!retryIf(err))
+                    return false;
+                const attempt = counts.get(step.name) ?? 0;
+                if (attempt >= maxAttempts - 1) {
+                    counts.delete(step.name);
+                    return false;
+                }
+                counts.set(step.name, attempt + 1);
+                const wait = backoff === 'exponential' ? delay * Math.pow(2, attempt) :
+                    backoff === 'linear' ? delay * (attempt + 1) :
+                        delay;
+                const label = `attempt ${attempt + 2}/${maxAttempts}`;
+                ctx.log(wait > 0
+                    ? `[retry] "${step.name}" — retrying in ${wait}ms (${label})`
+                    : `[retry] "${step.name}" — retrying (${label})`);
+                if (wait > 0)
+                    await new Promise(r => setTimeout(r, wait));
+                return true;
+            },
+        },
+    };
+}
+//# sourceMappingURL=retry.js.map

package/dist/plugins/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/plugins/retry.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B,EAAE;IACvD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAA;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAA;IAChC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,MAAM,CAAA;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;IAE5C,+CAA+C;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IAExC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE;YACL,WAAW,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;gBACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAA;gBAE/B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBAC1C,IAAI,OAAO,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;oBACxB,OAAO,KAAK,CAAA;gBACd,CAAC;gBAED,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAA;gBAElC,MAAM,IAAI,GACR,OAAO,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;oBAC1D,OAAO,KAAK,QAAQ,CAAM,CAAC,CAAC,KAAK,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;wBACvB,KAAK,CAAA;gBAEnC,MAAM,KAAK,GAAG,WAAW,OAAO,GAAG,CAAC,IAAI,WAAW,EAAE,CAAA;gBACrD,GAAG,CAAC,GAAG,CACL,IAAI,GAAG,CAAC;oBACN,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,mBAAmB,IAAI,OAAO,KAAK,GAAG;oBAC7D,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,iBAAiB,KAAK,GAAG,CACnD,CAAA;gBACD,IAAI,IAAI,GAAG,CAAC;oBAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;gBAEzD,OAAO,IAAI,CAAA;YACb,CAAC;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/providers/playwright.d.ts

@@ -0,0 +1,38 @@
+import { Session, type ClickOptions, type ScrollOptions } from '../session.js';
+/**
+ * PlaywrightSession — Session adapter for the aria-playwright daemon.
+ *
+ * Wraps the daemon's HTTP API (http://localhost:4848 by default).
+ * Exposes mcpUrl so agent() can give AI models live browser tool access.
+ *
+ * @example
+ * import { PlaywrightSession } from 'loop-sdk/playwright'
+ *
+ * const session = new PlaywrightSession('my-session')
+ * await session.ensure()
+ * await loop.run({ session })
+ * await session.destroy()
+ */
+export declare class PlaywrightSession extends Session {
+    readonly daemon: string;
+    constructor(id: string, { daemon }?: {
+        daemon?: string;
+    });
+    ensure(): Promise<boolean>;
+    destroy(): Promise<void>;
+    recreate(): Promise<void>;
+    navigate(url: string): Promise<void>;
+    click({ x, y, selector, text, button }: ClickOptions): Promise<void>;
+    type(text: string): Promise<void>;
+    key(key: string): Promise<void>;
+    scroll({ x, y, deltaX, deltaY }?: ScrollOptions): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    get mcpUrl(): string;
+    mcp(toolName: string, args?: Record<string, unknown>): Promise<unknown>;
+    evaluate(fn: string | (() => unknown)): Promise<string | null>;
+    currentUrl(): Promise<string | null>;
+    private _mcpRunCode;
+    private _fetch;
+    private _post;
+}
+//# sourceMappingURL=playwright.d.ts.map

package/dist/providers/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/providers/playwright.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAA;AAE9E;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;gBAEX,EAAE,EAAE,MAAM,EAAE,EAAE,MAAgC,EAAE,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IAOhF,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAY1B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQzB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAYpE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,MAAM,CAAC,EAAE,CAAO,EAAE,CAAO,EAAE,MAAU,EAAE,MAAY,EAAE,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzF,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAQnC,IAAa,MAAM,IAAI,MAAM,CAE5B;IAEK,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3E,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,CAAC,MAAM,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAU9D,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAM5B,WAAW;YAIX,MAAM;YAYN,KAAK;CASpB"}

package/dist/providers/playwright.js

@@ -0,0 +1,155 @@
+import { Session } from '../session.js';
+/**
+ * PlaywrightSession — Session adapter for the aria-playwright daemon.
+ *
+ * Wraps the daemon's HTTP API (http://localhost:4848 by default).
+ * Exposes mcpUrl so agent() can give AI models live browser tool access.
+ *
+ * @example
+ * import { PlaywrightSession } from 'loop-sdk/playwright'
+ *
+ * const session = new PlaywrightSession('my-session')
+ * await session.ensure()
+ * await loop.run({ session })
+ * await session.destroy()
+ */
+export class PlaywrightSession extends Session {
+    daemon;
+    constructor(id, { daemon = 'http://localhost:4848' } = {}) {
+        super(id);
+        this.daemon = daemon;
+    }
+    // ── lifecycle ────────────────────────────────────────────────────────────────
+    async ensure() {
+        const list = await this._fetch('/sessions').then(r => r.json());
+        if (list.some(s => s.id === this.id))
+            return false;
+        await this._fetch('/sessions', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ id: this.id }),
+        });
+        await sleep(3000);
+        return true;
+    }
+    async destroy() {
+        await this._fetch(`/sessions/${this.id}`, { method: 'DELETE' }).catch(() => { });
+    }
+    async recreate() {
+        await this.destroy();
+        await sleep(1000);
+        await this.ensure();
+    }
+    // ── Session interface ────────────────────────────────────────────────────────
+    async navigate(url) {
+        await this._post('/navigate', { url });
+    }
+    async click({ x, y, selector, text, button }) {
+        if (x != null && y != null) {
+            await this._post('/click', { x, y, button });
+        }
+        else if (selector) {
+            await this._mcpRunCode(selectorClickCode(selector));
+        }
+        else if (text) {
+            await this._mcpRunCode(textClickCode(text));
+        }
+        else {
+            throw new Error('click() requires x+y, selector, or text');
+        }
+    }
+    async type(text) {
+        await this._post('/type', { text });
+    }
+    async key(key) {
+        await this._post('/key', { key });
+    }
+    async scroll({ x = 760, y = 400, deltaX = 0, deltaY = 300 } = {}) {
+        await this._post('/scroll', { x, y, deltaX, deltaY });
+    }
+    async screenshot() {
+        const res = await this._fetch(`/sessions/${this.id}/screenshot`);
+        if (!res.ok)
+            throw new Error(`screenshot failed: HTTP ${res.status}`);
+        return Buffer.from(await res.arrayBuffer());
+    }
+    // ── MCP integration ──────────────────────────────────────────────────────────
+    get mcpUrl() {
+        return `${this.daemon}/sessions/${this.id}/mcp`;
+    }
+    async mcp(toolName, args = {}) {
+        return this._post('/mcp', {
+            jsonrpc: '2.0',
+            id: Date.now(),
+            method: 'tools/call',
+            params: { name: toolName, arguments: args },
+        });
+    }
+    async evaluate(fn) {
+        const fnStr = typeof fn === 'function' ? fn.toString() : fn;
+        const r = await this.mcp('browser_evaluate', { function: fnStr });
+        const text = r?.result?.content?.[0]?.text ?? '';
+        const m = text.match(/### Result\s*\n"([^"]+)"/);
+        return m?.[1] ?? null;
+    }
+    async currentUrl() {
+        return this.evaluate('() => window.location.href');
+    }
+    // ── internal ─────────────────────────────────────────────────────────────────
+    async _mcpRunCode(code) {
+        return this.mcp('browser_run_code_unsafe', { code });
+    }
+    async _fetch(path, opts = {}) {
+        const url = `${this.daemon}${path}`;
+        let last = new Error('fetch failed');
+        for (let i = 0; i < 4; i++) {
+            try {
+                return await fetch(url, opts);
+            }
+            catch (e) {
+                last = e instanceof Error ? e : new Error(String(e));
+                await sleep(800 * (i + 1));
+            }
+        }
+        throw last;
+    }
+    async _post(endpoint, body) {
+        const res = await this._fetch(`/sessions/${this.id}${endpoint}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok)
+            throw new Error(`${endpoint} failed: HTTP ${res.status}: ${await res.text()}`);
+        return res.json();
+    }
+}
+// ── click helpers ─────────────────────────────────────────────────────────────
+function selectorClickCode(selector) {
+    const sel = selector.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `async (page) => {
+    for (const f of page.frames()) {
+      try {
+        const loc = f.locator('${sel}')
+        if (await loc.count() > 0) { await loc.first().click(); return 'ok' }
+      } catch(e) {}
+    }
+    throw new Error('No element matching: ${sel}')
+  }`;
+}
+function textClickCode(text) {
+    const txt = text.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+    return `async (page) => {
+    for (const f of page.frames()) {
+      try {
+        const loc = f.locator('button,a,[role=button],input[type=submit]').filter({ hasText: '${txt}' })
+        if (await loc.count() > 0) { await loc.first().click(); return 'ok' }
+      } catch(e) {}
+    }
+    throw new Error('No element with text: ${txt}')
+  }`;
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
+//# sourceMappingURL=playwright.js.map

package/dist/providers/playwright.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Session — abstract base class every provider must extend.
+ *
+ * Extend this class to add support for any browser automation tool:
+ *
+ *   import { Session } from 'loop-sdk'
+ *   export class MySession extends Session {
+ *     async navigate(url: string) { ... }
+ *     // etc.
+ *   }
+ */
+export interface ClickOptions {
+    x?: number;
+    y?: number;
+    selector?: string;
+    text?: string;
+    button?: 'left' | 'right' | 'middle';
+}
+export interface ScrollOptions {
+    x?: number;
+    y?: number;
+    deltaX?: number;
+    deltaY?: number;
+}
+export declare abstract class Session {
+    readonly id: string;
+    constructor(id: string);
+    abstract navigate(url: string): Promise<void>;
+    abstract click(opts: ClickOptions): Promise<void>;
+    abstract type(text: string): Promise<void>;
+    abstract key(key: string): Promise<void>;
+    abstract scroll(opts: ScrollOptions): Promise<void>;
+    /** Capture a screenshot. Returns JPEG bytes. */
+    abstract screenshot(): Promise<Buffer>;
+    /** Release all resources held by this session. */
+    abstract destroy(): Promise<void>;
+    /**
+     * MCP server URL for AI agent tool access, or null if not supported.
+     * When set, agent() wires up an MCP client so the AI can call browser tools.
+     */
+    get mcpUrl(): string | null;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,8BAAsB,OAAO;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;gBAEP,EAAE,EAAE,MAAM;IAMtB,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IACjD,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1C,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAEnD,gDAAgD;IAChD,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAEtC,kDAAkD;IAClD,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC;;;OAGG;IACH,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;CACF"}

package/dist/session.js

@@ -0,0 +1,26 @@
+/**
+ * Session — abstract base class every provider must extend.
+ *
+ * Extend this class to add support for any browser automation tool:
+ *
+ *   import { Session } from 'loop-sdk'
+ *   export class MySession extends Session {
+ *     async navigate(url: string) { ... }
+ *     // etc.
+ *   }
+ */
+export class Session {
+    id;
+    constructor(id) {
+        this.id = id;
+    }
+    // ── Optional — providers implement for AI agent tool access ──────────────────
+    /**
+     * MCP server URL for AI agent tool access, or null if not supported.
+     * When set, agent() wires up an MCP client so the AI can call browser tools.
+     */
+    get mcpUrl() {
+        return null;
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,OAAgB,OAAO;IAClB,EAAE,CAAQ;IAEnB,YAAY,EAAU;QACpB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAgBD,gFAAgF;IAEhF;;;OAGG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "loop-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Framework for building long-running agentic loops — browser, AI, or both",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./playwright": {
+      "types": "./dist/providers/playwright.d.ts",
+      "default": "./dist/providers/playwright.js"
+    },
+    "./flow": {
+      "types": "./dist/flow.d.ts",
+      "default": "./dist/flow.js"
+    },
+    "./agent": {
+      "types": "./dist/agent.d.ts",
+      "default": "./dist/agent.js"
+    },
+    "./claude-cli": {
+      "types": "./dist/claude-cli.d.ts",
+      "default": "./dist/claude-cli.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/retry.d.ts",
+      "default": "./dist/plugins/retry.js"
+    },
+    "./mcp": {
+      "default": "./dist/mcp/server.js"
+    },
+    "./notify": {
+      "types": "./dist/notify.d.ts",
+      "default": "./dist/notify.js"
+    }
+  },
+  "bin": {
+    "loop-mcp": "dist/mcp/server.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "dev": "tsc --watch",
+    "demo": "node examples/demo.js",
+    "demo:loopfile": "node examples/run-loopfile.js",
+    "mcp": "node dist/mcp/server.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/js-yaml": "^4.0.9",
+    "ai": "^4.0.0",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": ">=1.0.0",
+    "@ai-sdk/openai": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
+  }
+}