libretto 0.1.5 → 0.2.1

package/dist/shared/visualization/index.cjs

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var visualization_exports = {};
+__export(visualization_exports, {
+  clearHighlights: () => import_highlight.clearHighlights,
+  ensureGhostCursor: () => import_ghost_cursor.ensureGhostCursor,
+  ensureHighlightLayer: () => import_highlight.ensureHighlightLayer,
+  getGhostCursorPosition: () => import_ghost_cursor.getGhostCursorPosition,
+  ghostClick: () => import_ghost_cursor.ghostClick,
+  hideGhostCursor: () => import_ghost_cursor.hideGhostCursor,
+  moveGhostCursor: () => import_ghost_cursor.moveGhostCursor,
+  moveGhostCursorWithDistance: () => import_ghost_cursor.moveGhostCursorWithDistance,
+  showHighlight: () => import_highlight.showHighlight
+});
+module.exports = __toCommonJS(visualization_exports);
+var import_ghost_cursor = require("./ghost-cursor.js");
+var import_highlight = require("./highlight.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  clearHighlights,
+  ensureGhostCursor,
+  ensureHighlightLayer,
+  getGhostCursorPosition,
+  ghostClick,
+  hideGhostCursor,
+  moveGhostCursor,
+  moveGhostCursorWithDistance,
+  showHighlight
+});

package/dist/shared/visualization/index.d.cts

@@ -0,0 +1,3 @@
+export { GhostCursorOptions, GhostCursorStyle, ensureGhostCursor, getGhostCursorPosition, ghostClick, hideGhostCursor, moveGhostCursor, moveGhostCursorWithDistance } from './ghost-cursor.cjs';
+export { HighlightOptions, ShowHighlightParams, clearHighlights, ensureHighlightLayer, showHighlight } from './highlight.cjs';
+import 'playwright';

package/dist/shared/visualization/index.d.ts

@@ -0,0 +1,3 @@
+export { GhostCursorOptions, GhostCursorStyle, ensureGhostCursor, getGhostCursorPosition, ghostClick, hideGhostCursor, moveGhostCursor, moveGhostCursorWithDistance } from './ghost-cursor.js';
+export { HighlightOptions, ShowHighlightParams, clearHighlights, ensureHighlightLayer, showHighlight } from './highlight.js';
+import 'playwright';

package/dist/shared/visualization/index.js

@@ -0,0 +1,24 @@
+import {
+  ensureGhostCursor,
+  moveGhostCursor,
+  moveGhostCursorWithDistance,
+  ghostClick,
+  hideGhostCursor,
+  getGhostCursorPosition
+} from "./ghost-cursor.js";
+import {
+  ensureHighlightLayer,
+  showHighlight,
+  clearHighlights
+} from "./highlight.js";
+export {
+  clearHighlights,
+  ensureGhostCursor,
+  ensureHighlightLayer,
+  getGhostCursorPosition,
+  ghostClick,
+  hideGhostCursor,
+  moveGhostCursor,
+  moveGhostCursorWithDistance,
+  showHighlight
+};

package/dist/shared/workflow/workflow.cjs

@@ -0,0 +1,47 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var workflow_exports = {};
+__export(workflow_exports, {
+  LIBRETTO_WORKFLOW_BRAND: () => LIBRETTO_WORKFLOW_BRAND,
+  LibrettoWorkflow: () => LibrettoWorkflow,
+  workflow: () => workflow
+});
+module.exports = __toCommonJS(workflow_exports);
+const LIBRETTO_WORKFLOW_BRAND = /* @__PURE__ */ Symbol.for("libretto.workflow");
+class LibrettoWorkflow {
+  [LIBRETTO_WORKFLOW_BRAND] = true;
+  metadata;
+  handler;
+  constructor(metadata, handler) {
+    this.metadata = metadata;
+    this.handler = handler;
+  }
+  async run(ctx, input) {
+    return this.handler(ctx, input);
+  }
+}
+function workflow(metadata, handler) {
+  return new LibrettoWorkflow(metadata, handler);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LIBRETTO_WORKFLOW_BRAND,
+  LibrettoWorkflow,
+  workflow
+});

package/dist/shared/workflow/workflow.d.cts

@@ -0,0 +1,33 @@
+import { Page, BrowserContext, Browser } from 'playwright';
+
+declare const LIBRETTO_WORKFLOW_BRAND: unique symbol;
+type LibrettoAuthProfile = {
+    type: "local";
+    domain: string;
+};
+type LibrettoWorkflowMetadata = {
+    authProfile?: LibrettoAuthProfile;
+};
+type LibrettoWorkflowContext = {
+    logger: unknown;
+    page: Page;
+    context: BrowserContext;
+    browser: Browser;
+    session: string;
+    integrationPath: string;
+    exportName: string;
+    headless: boolean;
+    debug: boolean;
+    pause: () => Promise<void>;
+};
+type LibrettoWorkflowHandler<Input = unknown, Output = unknown> = (ctx: LibrettoWorkflowContext, input: Input) => Promise<Output>;
+declare class LibrettoWorkflow<Input = unknown, Output = unknown> {
+    readonly [LIBRETTO_WORKFLOW_BRAND] = true;
+    readonly metadata: LibrettoWorkflowMetadata;
+    private readonly handler;
+    constructor(metadata: LibrettoWorkflowMetadata, handler: LibrettoWorkflowHandler<Input, Output>);
+    run(ctx: LibrettoWorkflowContext, input: Input): Promise<Output>;
+}
+declare function workflow<Input = unknown, Output = unknown>(metadata: LibrettoWorkflowMetadata, handler: LibrettoWorkflowHandler<Input, Output>): LibrettoWorkflow<Input, Output>;
+
+export { LIBRETTO_WORKFLOW_BRAND, type LibrettoAuthProfile, LibrettoWorkflow, type LibrettoWorkflowContext, type LibrettoWorkflowHandler, type LibrettoWorkflowMetadata, workflow };

package/dist/shared/workflow/workflow.d.ts

@@ -0,0 +1,33 @@
+import { Page, BrowserContext, Browser } from 'playwright';
+
+declare const LIBRETTO_WORKFLOW_BRAND: unique symbol;
+type LibrettoAuthProfile = {
+    type: "local";
+    domain: string;
+};
+type LibrettoWorkflowMetadata = {
+    authProfile?: LibrettoAuthProfile;
+};
+type LibrettoWorkflowContext = {
+    logger: unknown;
+    page: Page;
+    context: BrowserContext;
+    browser: Browser;
+    session: string;
+    integrationPath: string;
+    exportName: string;
+    headless: boolean;
+    debug: boolean;
+    pause: () => Promise<void>;
+};
+type LibrettoWorkflowHandler<Input = unknown, Output = unknown> = (ctx: LibrettoWorkflowContext, input: Input) => Promise<Output>;
+declare class LibrettoWorkflow<Input = unknown, Output = unknown> {
+    readonly [LIBRETTO_WORKFLOW_BRAND] = true;
+    readonly metadata: LibrettoWorkflowMetadata;
+    private readonly handler;
+    constructor(metadata: LibrettoWorkflowMetadata, handler: LibrettoWorkflowHandler<Input, Output>);
+    run(ctx: LibrettoWorkflowContext, input: Input): Promise<Output>;
+}
+declare function workflow<Input = unknown, Output = unknown>(metadata: LibrettoWorkflowMetadata, handler: LibrettoWorkflowHandler<Input, Output>): LibrettoWorkflow<Input, Output>;
+
+export { LIBRETTO_WORKFLOW_BRAND, type LibrettoAuthProfile, LibrettoWorkflow, type LibrettoWorkflowContext, type LibrettoWorkflowHandler, type LibrettoWorkflowMetadata, workflow };

package/dist/shared/workflow/workflow.js

@@ -0,0 +1,21 @@
+const LIBRETTO_WORKFLOW_BRAND = /* @__PURE__ */ Symbol.for("libretto.workflow");
+class LibrettoWorkflow {
+  [LIBRETTO_WORKFLOW_BRAND] = true;
+  metadata;
+  handler;
+  constructor(metadata, handler) {
+    this.metadata = metadata;
+    this.handler = handler;
+  }
+  async run(ctx, input) {
+    return this.handler(ctx, input);
+  }
+}
+function workflow(metadata, handler) {
+  return new LibrettoWorkflow(metadata, handler);
+}
+export {
+  LIBRETTO_WORKFLOW_BRAND,
+  LibrettoWorkflow,
+  workflow
+};

package/package.json

@@ -1,35 +1,134 @@
 {
   "name": "libretto",
-  "version": "0.1.5",
-  "description": "libretto ========",
-  "main": "./lib/index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+  "version": "0.2.1",
+  "description": "AI-powered browser automation library and CLI built on Playwright",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/saffron-health/libretto"
   },
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
   "bin": {
-    "libretto": "./bin/libretto"
+    "libretto": "./bin/libretto.mjs",
+    "libretto-cli": "./bin/libretto.mjs"
   },
-  "repository": {
-    "type": "git",
-    "url": "git://github.com/crcn/libretto.git"
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./logger": {
+      "types": "./dist/shared/logger/index.d.ts",
+      "import": "./dist/shared/logger/index.js",
+      "require": "./dist/shared/logger/index.cjs"
+    },
+    "./recovery": {
+      "types": "./dist/runtime/recovery/index.d.ts",
+      "import": "./dist/runtime/recovery/index.js",
+      "require": "./dist/runtime/recovery/index.cjs"
+    },
+    "./extract": {
+      "types": "./dist/runtime/extract/index.d.ts",
+      "import": "./dist/runtime/extract/index.js",
+      "require": "./dist/runtime/extract/index.cjs"
+    },
+    "./network": {
+      "types": "./dist/runtime/network/index.d.ts",
+      "import": "./dist/runtime/network/index.js",
+      "require": "./dist/runtime/network/index.cjs"
+    },
+    "./download": {
+      "types": "./dist/runtime/download/index.d.ts",
+      "import": "./dist/runtime/download/index.js",
+      "require": "./dist/runtime/download/index.cjs"
+    },
+    "./debug": {
+      "types": "./dist/shared/debug/index.d.ts",
+      "import": "./dist/shared/debug/index.js",
+      "require": "./dist/shared/debug/index.cjs"
+    },
+    "./config": {
+      "types": "./dist/shared/config/index.d.ts",
+      "import": "./dist/shared/config/index.js",
+      "require": "./dist/shared/config/index.cjs"
+    },
+    "./instrumentation": {
+      "types": "./dist/shared/instrumentation/index.d.ts",
+      "import": "./dist/shared/instrumentation/index.js",
+      "require": "./dist/shared/instrumentation/index.cjs"
+    },
+    "./visualization": {
+      "types": "./dist/shared/visualization/index.d.ts",
+      "import": "./dist/shared/visualization/index.js",
+      "require": "./dist/shared/visualization/index.cjs"
+    },
+    "./llm": {
+      "types": "./dist/shared/llm/index.d.ts",
+      "import": "./dist/shared/llm/index.js",
+      "require": "./dist/shared/llm/index.cjs"
+    },
+    "./state": {
+      "types": "./dist/shared/state/index.d.ts",
+      "import": "./dist/shared/state/index.js",
+      "require": "./dist/shared/state/index.cjs"
+    },
+    "./run": {
+      "types": "./dist/shared/run/api.d.ts",
+      "import": "./dist/shared/run/api.js",
+      "require": "./dist/shared/run/api.cjs"
+    }
+  },
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.mjs; npx playwright install chromium",
+    "build": "pnpm run build:runtime && pnpm run build:cli",
+    "build:runtime": "tsup --config tsup.config.ts",
+    "build:cli": "tsup --config tsup.cli.config.ts",
+    "type-check": "tsc --noEmit",
+    "dev": "tsx src/cli/index.ts",
+    "test": "pnpm run build && vitest run",
+    "test:watch": "vitest"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": "^3.0.0",
+    "@ai-sdk/google-vertex": "^4.0.0",
+    "@ai-sdk/openai": "^3.0.0",
+    "zod": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google-vertex": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.53",
+    "@ai-sdk/google-vertex": "^4.0.72",
+    "@ai-sdk/openai": "^3.0.39",
+    "@types/node": "^25.3.3",
+    "@types/yargs": "^17.0.33",
+    "openai": "^6.27.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18",
+    "zod": "^3.25.0"
   },
-  "author": "",
-  "license": "BSD",
-  "readmeFilename": "README.md",
-  "gitHead": "e4c500dd1e07a33eb4ca80731c085967c2d4add3",
   "dependencies": {
-    "commander": "~2.0.0",
-    "mongodb": "~1.3.19",
-    "comerr": "0.0.6",
-    "verify": "0.0.7",
-    "mkdirp": "~0.3.5",
-    "outcome": "0.0.18",
-    "stepc": "0.0.3",
-    "async": "~0.2.9",
-    "traverse": "~0.6.3",
-    "step": "0.0.x",
-    "type-component": "0.0.1",
-    "memoizee": "~0.2.6",
-    "glob": "~3.2.8"
+    "ai": "^6.0.110",
+    "playwright": "^1.52.0",
+    "yargs": "^17.7.2"
   }
 }

package/.npmignore

@@ -1,2 +0,0 @@
-node_modules
-

package/bin/libretto

@@ -1,31 +0,0 @@
-#!/usr/bin/env node
-
-var commander = require("commander"),
-libretto      = require("..");
-
-commander.
-option("-y, --yes", "yes to any prompt that shows up").
-option("-v, --verbose", "verbose mode").
-option("-d, --database <host>", "database to use");
-
-
-function complete(err) {
-  if(err) console.error("Error: %s", err.stack);
-  process.exit();
-}
-
-commander.
-command("import [path]").
-description("import fixtures").
-action(function(path) {
-  libretto.import({ path: path, db: commander.database, verbose: true }, complete);
-});
-
-commander.
-command("export [path]").
-description("export fixtures").
-action(function(path) {
-  libretto.export({ path: path, db: commander.database, verbose: true  }, complete);
-});
-
-commander.parse(process.argv);

package/lib/connect.js

@@ -1,34 +0,0 @@
-// Generated by CoffeeScript 1.7.0
-(function() {
-  var client, connect, memoize, mongodb, step, _log;
-
-  mongodb = require("mongodb");
-
-  client = mongodb.MongoClient;
-
-  step = require("step");
-
-  memoize = require("memoizee");
-
-  _log = require("./log");
-
-
-  /*
-   connects to the database
-   */
-
-  connect = memoize((function(db, next) {
-    if (!~db.indexOf("mongodb://")) {
-      db = "mongodb://127.0.0.1:27017/" + db;
-    }
-    _log("connecting to %s", db);
-    return client.connect(db, next);
-  }), {
-    async: true
-  });
-
-  module.exports = function(options, next) {
-    return connect(options.db, next);
-  };
-
-}).call(this);

package/lib/export.js

@@ -1,224 +0,0 @@
-// Generated by CoffeeScript 1.7.0
-(function() {
-  var async, attachRefs, attachRefs2, connect, exportCollection, exportCollections, fs, loadCollections, mapItemRelationships, mkdirp, mongodb, outcome, stepc, traverse, type, validate, _log;
-
-  stepc = require("stepc");
-
-  outcome = require("outcome");
-
-  async = require("async");
-
-  mkdirp = require("mkdirp");
-
-  fs = require("fs");
-
-  type = require("type-component");
-
-  traverse = require("traverse");
-
-  validate = require("./validate");
-
-  connect = require("./connect");
-
-  mongodb = require("mongodb");
-
-  _log = require("./log");
-
-
-  /*
-   */
-
-  module.exports = function(options, next) {
-    var o;
-    o = outcome.e(next);
-    return stepc.async(o.s(function() {
-      var e;
-      try {
-        mkdirp.sync(options.path);
-      } catch (_error) {
-        e = _error;
-      }
-      return this();
-    }), o.s(function() {
-      return connect({
-        db: options.db
-      }, this);
-    }), o.s(function(db) {
-      this.db = db;
-      return db.collectionNames(this);
-    }), o.s(function(names) {
-      var collections;
-      collections = names.map((function(_this) {
-        return function(data) {
-          return _this.db.collection(data.name.split(".").slice(1).join("."));
-        };
-      })(this));
-      return exportCollections(options, collections, this);
-    }), next);
-  };
-
-
-  /*
-   */
-
-  exportCollections = function(options, collections, next) {
-    return loadCollections(collections, function(err, collections) {
-      mapItemRelationships(collections);
-      return async.eachSeries(collections, exportCollection(options), next);
-    });
-  };
-
-
-  /*
-   */
-
-  mapItemRelationships = function(collections) {
-    var all, collection, item, key, _i, _j, _len, _len1, _ref, _results;
-    _log("mapping item relationships");
-    all = {};
-    for (_i = 0, _len = collections.length; _i < _len; _i++) {
-      collection = collections[_i];
-      _ref = collection.items;
-      for (_j = 0, _len1 = _ref.length; _j < _len1; _j++) {
-        item = _ref[_j];
-        all[item.data._id] = item;
-      }
-    }
-    _results = [];
-    for (key in all) {
-      item = all[key];
-      _results.push(attachRefs(item, all, collections));
-    }
-    return _results;
-  };
-
-  attachRefs = function(item, all) {
-    var keys;
-    keys = [];
-    return traverse(item.data).forEach(function(x) {
-      var key, p, r, ref, refs;
-      keys = [];
-      p = this;
-      while (p) {
-        if (isNaN(p.key) && p.key) {
-          keys.unshift(p.key);
-        }
-        p = p.parent;
-      }
-      key = keys.join(".");
-      if (ref = all[x]) {
-        refs = ref.refs;
-        if (!(r = refs[item.collection])) {
-          r = refs[item.collection] = [];
-        }
-        if (!~r.indexOf(key)) {
-          r.push(key);
-        }
-      }
-      if (x && typeof x === "object" && !/^(Array|Object)$/.test(x.constructor.name)) {
-        this.update({
-          __type: x.constructor.name,
-          value: x
-        });
-        return this.block();
-      }
-    });
-  };
-
-
-  /*
-   */
-
-  attachRefs2 = function(item, all, current, keys) {
-    var key, kp, r, ref, refs, sub, t, value, _i, _len;
-    if (keys == null) {
-      keys = [];
-    }
-    if (!current) {
-      current = item;
-    }
-    for (key in current) {
-      value = current[key];
-      if ((ref = all[value])) {
-        kp = keys.concat(key).join(".");
-        refs = ref.__refs;
-        if (!(r = refs[item.__collection])) {
-          r = refs[item.__collection] = [];
-        }
-        if (!~r.indexOf(kp)) {
-          r.push(kp);
-        }
-      } else if ((t = type(value)) === "array") {
-        for (_i = 0, _len = value.length; _i < _len; _i++) {
-          sub = value[_i];
-          if (sub) {
-            attachRefs(item, all, sub, keys.concat(key));
-          }
-        }
-      } else if (t === "object" && value) {
-        attachRefs(item, all, value, keys.concat());
-      }
-      if (value && (typeof value === "object") && !/^Array|Object$/.test(value.constructor.name)) {
-        current[key] = {
-          __type: value.constructor.name,
-          value: value
-        };
-      }
-    }
-    return refs;
-  };
-
-
-  /*
-   */
-
-  loadCollections = function(collections, next) {
-    var data;
-    data = [];
-    return async.eachSeries(collections, (function(collection, next) {
-      return collection.find().toArray(function(err, result) {
-        if (err != null) {
-          return next(err);
-        }
-        _log("loaded %s (%d)", collection.collectionName, result.length);
-        data.push({
-          name: collection.collectionName,
-          items: result.map(function(item) {
-            return {
-              data: item,
-              collection: collection.collectionName,
-              refs: {},
-              method: "insert"
-            };
-          })
-        });
-        return next();
-      });
-    }), function(err) {
-      if (err != null) {
-        return next(err);
-      }
-      return next(null, data);
-    });
-  };
-
-
-  /*
-   */
-
-  exportCollection = function(options) {
-    return function(collection, next) {
-      var o, path;
-      path = options.path + "/" + collection.name + ".json";
-      _log("exporting %s", collection.name);
-      o = outcome.e(next);
-      if (collection.items.length === 0) {
-        return next();
-      }
-      return stepc.async(o.s(function(results) {
-        return fs.writeFile(path, JSON.stringify(collection.items, null, 2), this);
-      }), next);
-    };
-  };
-
-}).call(this);