@axiom_ai/api 1.0.0 → 1.0.2

package/AGENTS.md

@@ -0,0 +1,3 @@
+# AGENTS.md
+
+This package documents its agent conventions, public API surface, common patterns, and error semantics in [`CLAUDE.md`](./CLAUDE.md) — read that file first, regardless of which agent you're running. Runnable examples live in [`examples/`](./examples/).

package/CLAUDE.md

@@ -0,0 +1,154 @@
+# CLAUDE.md — `@axiom_ai/api` agent instructions
+
+Reference doc Claude (and other agents following the AGENTS.md convention) read when working with this package — both inside this repo and after `npm install @axiom_ai/api` puts a copy at `node_modules/@axiom_ai/api/CLAUDE.md` in a consumer project. Keep this terse and code-truth-aligned; the actual source-of-truth is [`src/axiom-api.js`](./src/axiom-api.js).
+
+## What this package is
+
+A small Node library that drives Axiom.ai's cloud browser pool over a REST API (`/api/v5/*`). It is **not** a Puppeteer/Playwright wrapper and **does not** speak CDP — it calls named step functions on a Laravel backend (`https://lar.axiom.ai`) that run inside the cloud browser. If you want raw CDP, that's the separate Chrome API surface — see [the website's API overview](https://axiom.ai/docs/developer-hub/api).
+
+Bundled in the npm tarball alongside source-built `dist/`:
+- This file (`CLAUDE.md`) — surface + patterns.
+- `AGENTS.md` — redirect to here for non-Claude agents.
+- `examples/` — three runnable Node scripts: `simple-scrape.js`, `login-then-extract.js`, `parallel-sessions.js`.
+
+## Public method surface
+
+Every method below is on the `AxiomApi` class. Construct with `new AxiomApi(apiKey)`; the key comes from the user's account (see "Auth + signup" below).
+
+### Lifecycle (always pair these)
+
+| Method | Notes |
+|---|---|
+| `browserOpen()` | Opens a cloud browser session. Returns the CDP endpoint and caches it on the instance as `axiom.cdpLink`. |
+| `browserClose(cdpLink?)` | Closes the session. Pass `cdpLink` only if closing a session from a different instance (rare). |
+
+**Wrap every script in `try { … } finally { await axiom.browserClose() }`** so a thrown step doesn't leak a cloud session.
+
+### Navigation
+
+| Method | Notes |
+|---|---|
+| `goto(url, doNotShareLocalstorage?, openInNewTab?)` | Navigate the current tab (or a new one if third arg is `true`). |
+| `switchBrowserTab(selectTab)` | Switch focus to a tab by name/URL substring. |
+
+### Interaction
+
+| Method | Notes |
+|---|---|
+| `click(select, leftClickRightClick?, optionalClick?)` | Single click. `optionalClick: true` no-ops when the selector doesn't match. |
+| `clickMultiple(select, leftClickRightClick?, maxClicks?)` | Click every match up to `maxClicks`. |
+| `clickEngagementButton(select, setValueToCheck)` | Idempotent like/follow/subscribe toggle. |
+| `hover(select)` | Mouse-over an element. |
+| `clickAndDrag(startCoordinates, endCoordinates)` | Mouse-down at one point, release at another. Coordinates are `{scrollX, scrollY, clientX, clientY}` objects. |
+| `enterText(selectTextField, text, delay?, appendExisting?, customLineBreak?, optionalText?)` | Type into an input field. |
+| `pressKeys(key, delimiter?, delay?)` | Fire keyboard events (Enter, Tab, arrow keys, modifier combos). |
+| `selectList(select, text)` | Pick an option from a `<select>` by visible text. |
+| `datePicker(selectMonth, selectMonthChangeButton, changeMonthTo, changeDayOfMonthTo)` | Step through a calendar widget. |
+
+### Data
+
+| Method | Notes |
+|---|---|
+| `scrape(url, selector, pager, max_results, settings)` | Smart-scrape rows. Pass `null` for `url` to scrape the current page. Returns an array of objects. |
+| `scrapeMetadata(metadata)` | Extract structured page-level fields (title, OG tags, schema.org blocks). |
+| `getClipboardContents()` | Read the cloud browser's clipboard (after a copy step). |
+
+### AI and utility
+
+| Method | Notes |
+|---|---|
+| `integrateAI(aiOptions)` | Inline LLM call (extract or generate). `aiOptions: {aiFunction, key?, model?, prompt?, extractData?, promptExtract?}`. |
+| `solveCaptcha(apiKey?)` | Hand the current page's captcha to a third-party solver. Omit `apiKey` to use the one stored on the account. |
+| `wait(time)` | Pause **on the cloud pod** (keeps the session alive) for `time` ms. Use this rather than client-side `setTimeout`. |
+| `restartBrowser()` | Restart Chrome within the same session — useful between unrelated flows. |
+
+## Methods NOT to call
+
+These exist on the class but are not part of the public surface — don't emit them in generated code:
+
+- `step(mode, method, params, cdpLink)` — the internal dispatcher every public method routes through. If you ever feel like calling `step()` directly, that means a named wrapper is missing; file an issue, don't paper over it.
+- `_sleep(ms)` — client-side sleep helper. Internal; use `wait(time)` (cloud-side) for browser pacing.
+- `_pollStepResult(...)` / `_shouldFallBackToPolling(...)` — error-recovery internals.
+
+## Common patterns
+
+### Simplest scrape — open, navigate, scrape, close
+
+```javascript
+import { AxiomApi } from '@axiom_ai/api'
+
+const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+await axiom.browserOpen()
+try {
+    await axiom.goto('https://example.com/products')
+    const rows = await axiom.scrape(null, '.product-card', null, 50, {})
+    console.log(`Found ${rows.length} products`)
+} finally {
+    await axiom.browserClose()
+}
+```
+
+### Login then extract
+
+```javascript
+await axiom.goto('https://example.com/login')
+await axiom.enterText('input[name=email]', process.env.LOGIN_EMAIL)
+await axiom.enterText('input[name=password]', process.env.LOGIN_PASSWORD)
+await axiom.click('button[type=submit]')
+await axiom.wait(2000)                              // settle on the dashboard
+const rows = await axiom.scrape(null, '.row', null, 100, {})
+```
+
+### Parallel sessions
+
+Create independent `AxiomApi` instances — each calls `browserOpen()` and `browserClose()` independently. Don't share `cdpLink` between them.
+
+```javascript
+const a = new AxiomApi(KEY); const b = new AxiomApi(KEY)
+await Promise.all([a.browserOpen(), b.browserOpen()])
+try {
+    const [rowsA, rowsB] = await Promise.all([
+        a.goto('https://a.test').then(() => a.scrape(null, '.row', null, 50, {})),
+        b.goto('https://b.test').then(() => b.scrape(null, '.row', null, 50, {})),
+    ])
+} finally {
+    await Promise.all([a.browserClose(), b.browserClose()])
+}
+```
+
+See [`examples/`](./examples/) for runnable versions of these.
+
+## Error semantics
+
+The library throws `AxiomHttpError` on non-2xx responses. Common shapes:
+
+| Status | Meaning | What to do |
+|---|---|---|
+| 401 | API key invalid / expired | Re-mint the key — don't retry. |
+| 403 | Account-level block (quota, abuse, plan) | Don't retry; surface to the user. |
+| 409 | A step is already in flight on this `cdpLink` | Library auto-polls `/api/v5/step/result` and returns the result transparently. You shouldn't normally see 409 propagate. |
+| 502 / 503 / 504 | Pod transient | Library auto-falls-back to polling. If still failing after polling, retry the whole `browserOpen → … → browserClose` flow. |
+| Other 4xx | Bad params (wrong selector type, missing required arg) | Inspect the error body and fix the call. |
+
+## Auth + signup
+
+The `AXIOM_API_KEY` env var holds the long-lived key. Two ways to get one:
+
+1. **Interactive** — sign up at [axiom.ai](https://axiom.ai), open the dashboard, copy the key.
+2. **Programmatic** — three-call flow documented at [`/docs/developer-hub/api/programmatic-signup`](https://axiom.ai/docs/developer-hub/api/programmatic-signup): `POST /api/user/create` → `POST /api/user/login` → `GET /api/user/key/create`. Suitable for headless onboarding.
+
+## Relationship to `@axiom_ai/claude-skill`
+
+If the user is asking Claude to **build an axiom from a prompt** (e.g. "scrape this site daily and email me", "build me a bot that…"), the explicit marketplace plugin [`@axiom_ai/claude-skill`](https://github.com/axiom-browser-automation/claude-skill) gives Claude a richer guided experience — it covers both the *coded* path (this package) and the *no-code* path (saving to the user's dashboard). Use it when the user wants Claude to *invent* an axiom; this CLAUDE.md is enough when the user is *writing their own code* and asking Claude for help with the API surface.
+
+## Build + test (for maintainers working in this repo)
+
+```bash
+npm ci          # install deps
+npm test        # jest, 26 tests, runs against nock mocks (no live calls)
+npm run build   # vite produces dist/{es,cjs}/index.js; tsc emits .d.ts only
+```
+
+**Watch-out from v1.0.1**: `tsconfig.json` is set to `emitDeclarationOnly: true`. If you change that, `tsc` will start emitting multi-file `.js` into `dist/es/` and clobber vite's single-bundle build — the result imports fine under CJS but fails under modern Node ESM with `ERR_MODULE_NOT_FOUND` on extensionless internal imports. Leave the flag alone unless you also wire up vite/tsc differently.
+
+Publishing is via the Jenkins job `Publishing/axiom-api-publish` on the team's Jenkins; manual trigger only.

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Axiom.ai
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -13,20 +13,31 @@ To use the library, you'll first need to import the `AxiomApi` class and then wr
 Here is a basic example of how to structure your code:
 
 ```javascript
-import { AxiomApi } from 'axiom-api';
+import { AxiomApi } from '@axiom_ai/api';
 
 async function run() {
     // 1. Initialize the AxiomApi class
     const axiom = new AxiomApi('[API_KEY]');
-    
+
     // 2. Open the browser connection
     await axiom.browserOpen();
 
-    // 3. Add your automation steps here (e.g., axiom.click(), axiom.type(), etc.)
+    // 3. Add your automation steps here (e.g., axiom.goto(), axiom.click(), axiom.enterText(), axiom.scrape(), etc.)
     // ... add steps ...
 
     // 4. Close the browser connection when done
     await axiom.browserClose();
 }
 
-run();
+run();
+```
+
+## Working with Claude Code (or other agents)
+
+This package bundles agent-targeted documentation alongside the runtime:
+
+- [`CLAUDE.md`](./CLAUDE.md) — full method surface, error semantics, common patterns, auth + signup, and the methods *not* to call. Read by Claude automatically when this package is installed in a project.
+- [`AGENTS.md`](./AGENTS.md) — same content, surfaced for non-Claude agents that follow the `AGENTS.md` convention.
+- [`examples/`](./examples/) — three runnable scripts (`simple-scrape.js`, `login-then-extract.js`, `parallel-sessions.js`).
+
+If you want Claude to *invent* an axiom from a prompt rather than help you write API calls yourself, also see [`@axiom_ai/claude-skill`](https://github.com/axiom-browser-automation/claude-skill) — the marketplace plugin covers both this library and the no-code dashboard path.

package/dist/cjs/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k="https://lar.axiom.ai";class c extends Error{constructor(t,e,n){super(t),this.name="AxiomHttpError",this.status=e,this.body=n}}class m{async post(t,e,n,i={}){const s=new AbortController;let o=null;i.timeoutMs&&i.timeoutMs>0&&(o=setTimeout(()=>s.abort(),i.timeoutMs));let r;try{r=await fetch(k+t,{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json","X-API-KEY":e},body:JSON.stringify(n),signal:s.signal})}finally{o&&clearTimeout(o)}if(!r.ok){const h=await r.text();let a=null;try{a=JSON.parse(h)}catch{}if(r.status===401)throw new c("Failed to authenticate - please check your token.",401,a);const w=a&&a.message?a.message:`HTTP ${r.status} error: ${h}`;throw new c(w,r.status,a)}return r.json()}}const y=12e4,u=36e5,f=3e3,l=3e4,d=1.5;class g{constructor(t){this.cdpLink="",this.token=t,this.http=new m}async browserOpen(){const t=await this.http.post("/api/v5/browser/open",this.token);return this.cdpLink=t.endpoint,t.endpoint}async browserClose(t=""){t||(t=this.cdpLink);const e=await this.http.post("/api/v5/browser/close",this.token,{cdpLink:t});return this.cdpLink="",e.message}async step(t,e,n,i=""){try{const s=await this.http.post("/api/v5/step",this.token,{mode:t,method:e,params:n,cdpLink:i},{timeoutMs:y});return s&&s.message!==void 0?s.message:s}catch(s){if(!i||!this._shouldFallBackToPolling(s))throw s;return this._pollStepResult(i,s)}}_shouldFallBackToPolling(t){return!!(t&&t.name==="AbortError"||t&&t.name==="TypeError"||t instanceof c&&(t.status===502||t.status===503||t.status===504||t.status===409&&typeof t.message=="string"&&t.message.indexOf("Step already in progress")!==-1))}async _pollStepResult(t,e){const n=Date.now()+u;let i=f;for(;Date.now()<n;){await this._sleep(i);try{const s=await this.http.post("/api/v5/step/result",this.token,{cdpLink:t});if(s&&s.status==="complete")return s.result;if(s&&s.status==="running"){i=Math.min(i*d,l);continue}throw s&&s.status==="none"?new Error("Step did not start on the pod. Original error: "+(e&&e.message?e.message:"unknown")):new Error("Unexpected /step/result response: "+JSON.stringify(s))}catch(s){if(s instanceof c&&s.status===409)throw new Error("Step failed on the pod — check the task report. "+(s.message||""));if(s instanceof c&&s.status>=400&&s.status<500&&s.status!==502&&s.status!==503&&s.status!==504)throw s;i=Math.min(i*d,l)}}throw new Error("Step polling exceeded "+u/1e3+"s. Original error: "+(e&&e.message?e.message:"unknown"))}async scrape(t,e,n,i,s){return this.step("browser","AxiomApiSmartScrapeV440",[t,e,n,i,s],this.cdpLink)}async integrateAI(t){return this.step("browser","AxiomApiAiGeneric",[t],this.cdpLink)}async datePicker(t,e,n,i){return this.step("driver","datePicker",[t,e,n,i],this.cdpLink)}async click(t,e,n){return this.step("driver","clickV3130",[t,e,n],this.cdpLink)}async clickEngagementButton(t,e){return this.step("driver","clickEngagementButton",[t,e],this.cdpLink)}async clickMultiple(t,e,n){return this.step("driver","multiClickV3170",[t,e,n],this.cdpLink)}async getClipboardContents(){return this.step("driver","readClipboardContents",[],this.cdpLink)}async enterText(t,e,n=0,i=!1,s=null,o=!1){return this.step("driver","enterTextV4500",[t,e,n,i,s,o],this.cdpLink)}async goto(t,e=!1,n=!1){return this.step("driver","gotoV4070",[t,null,e,n],this.cdpLink)}async pressKeys(t,e,n){return this.step("driver","keydownV3120",[t,null,e,n],this.cdpLink)}async clickAndDrag(t,e){return this.step("driver","mouseClickDragV0300",[t,e],this.cdpLink)}async scrapeMetadata(t){return this.step("driver","scrapeMetadata",[t],this.cdpLink)}async selectList(t,e){return this.step("driver","selectList",[t,e],this.cdpLink)}async solveCaptcha(t){return this.step("driver","solveCaptchaV450",[null,null,t],this.cdpLink)}async switchBrowserTab(t){return this.step("driver","switchBrowserTab",[t],this.cdpLink)}async wait(t){return this.cdpLink?this.step("driver","wait",[t],this.cdpLink):this._sleep(t)}_sleep(t){return new Promise(e=>setTimeout(e,t))}async hover(t){return this.step("driver","hover",[t],this.cdpLink)}async restartBrowser(){return this.step("browser","AxiomApiRestartBrowser",[],this.cdpLink)}}exports.AxiomApi=g;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k="https://lar.axiom.ai";class c extends Error{constructor(t,e,n){super(t),this.name="AxiomHttpError",this.status=e,this.body=n}}class m{async post(t,e,n,i={}){const s=new AbortController;let o=null;i.timeoutMs&&i.timeoutMs>0&&(o=setTimeout(()=>s.abort(),i.timeoutMs));let r;try{r=await fetch(k+t,{method:"POST",headers:{Accept:"application/json","Content-Type":"application/json","X-API-KEY":e},body:JSON.stringify(n),signal:s.signal})}finally{o&&clearTimeout(o)}if(!r.ok){const h=await r.text();let a=null;try{a=JSON.parse(h)}catch{}if(r.status===401)throw new c("Failed to authenticate - please check your token.",401,a);const w=a&&a.message?a.message:`HTTP ${r.status} error: ${h}`;throw new c(w,r.status,a)}return r.json()}}const y=12e4,u=36e5,f=3e3,l=3e4,d=1.5;class g{constructor(t){this.cdpLink="",this.token=t,this.http=new m}async browserOpen(){const t=await this.http.post("/api/v5/browser/open",this.token);return this.cdpLink=t.endpoint,t.endpoint}async browserClose(t=""){t||(t=this.cdpLink);const e=await this.http.post("/api/v5/browser/close",this.token,{cdpLink:t});return this.cdpLink="",e.message}async step(t,e,n,i=""){try{const s=await this.http.post("/api/v5/step",this.token,{mode:t,method:e,params:n,cdpLink:i},{timeoutMs:y});return s&&s.message!==void 0?s.message:s}catch(s){if(!i||!this._shouldFallBackToPolling(s))throw s;return this._pollStepResult(i,s)}}_shouldFallBackToPolling(t){return!!(t&&t.name==="AbortError"||t&&t.name==="TypeError"||t instanceof c&&(t.status===502||t.status===503||t.status===504||t.status===409&&typeof t.message=="string"&&t.message.indexOf("Step already in progress")!==-1))}async _pollStepResult(t,e){const n=Date.now()+u;let i=f;for(;Date.now()<n;){await this._sleep(i);try{const s=await this.http.post("/api/v5/step/result",this.token,{cdpLink:t});if(s&&s.status==="complete")return s.result;if(s&&s.status==="running"){i=Math.min(i*d,l);continue}throw s&&s.status==="none"?new Error("Step did not start on the pod. Original error: "+(e&&e.message?e.message:"unknown")):new Error("Unexpected /step/result response: "+JSON.stringify(s))}catch(s){if(s instanceof c&&s.status===409)throw new Error("Step failed on the pod — check the task report. "+(s.message||""));if(s instanceof c&&s.status>=400&&s.status<500&&s.status!==502&&s.status!==503&&s.status!==504)throw s;i=Math.min(i*d,l)}}throw new Error("Step polling exceeded "+u/1e3+"s. Original error: "+(e&&e.message?e.message:"unknown"))}async scrape(t,e,n,i,s){return this.step("browser","AxiomApiSmartScrapeV4400",[t,e,n,i,s],this.cdpLink)}async integrateAI(t){return this.step("browser","AxiomApiAiGeneric",[t],this.cdpLink)}async datePicker(t,e,n,i){return this.step("driver","datePicker",[t,e,n,i],this.cdpLink)}async click(t,e,n){return this.step("driver","clickV3130",[t,e,n],this.cdpLink)}async clickEngagementButton(t,e){return this.step("driver","clickEngagementButton",[t,e],this.cdpLink)}async clickMultiple(t,e,n){return this.step("driver","multiClickV3170",[t,e,n],this.cdpLink)}async getClipboardContents(){return this.step("driver","readClipboardContents",[],this.cdpLink)}async enterText(t,e,n=0,i=!1,s=null,o=!1){return this.step("driver","enterTextV4500",[t,e,n,i,s,o],this.cdpLink)}async goto(t,e=!1,n=!1){return this.step("driver","gotoV4070",[t,null,e,n],this.cdpLink)}async pressKeys(t,e,n){return this.step("driver","keydownV3120",[t,null,e,n],this.cdpLink)}async clickAndDrag(t,e){return this.step("driver","mouseClickDragV0300",[t,e],this.cdpLink)}async scrapeMetadata(t){return this.step("driver","scrapeMetadata",[t],this.cdpLink)}async selectList(t,e){return this.step("driver","selectList",[t,e],this.cdpLink)}async solveCaptcha(t){return this.step("driver","solveCaptchaV450",[null,null,t],this.cdpLink)}async switchBrowserTab(t){return this.step("driver","switchBrowserTab",[t],this.cdpLink)}async wait(t){return this.cdpLink?this.step("driver","wait",[t],this.cdpLink):this._sleep(t)}_sleep(t){return new Promise(e=>setTimeout(e,t))}async hover(t){return this.step("driver","hover",[t],this.cdpLink)}async restartBrowser(){return this.step("browser","AxiomApiRestartBrowser",[],this.cdpLink)}}exports.AxiomApi=g;

package/dist/es/index.d.ts

@@ -1 +1 @@
-export { AxiomApi } from "./axiom-api";
+export { AxiomApi } from "./axiom-api.js";

package/dist/es/index.js

@@ -1 +1,252 @@
-export { AxiomApi } from "./axiom-api";
+const k = "https://lar.axiom.ai";
+class c extends Error {
+  constructor(t, e, n) {
+    super(t), this.name = "AxiomHttpError", this.status = e, this.body = n;
+  }
+}
+class m {
+  async post(t, e, n, i = {}) {
+    const s = new AbortController();
+    let o = null;
+    i.timeoutMs && i.timeoutMs > 0 && (o = setTimeout(() => s.abort(), i.timeoutMs));
+    let r;
+    try {
+      r = await fetch(k + t, {
+        method: "POST",
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json",
+          "X-API-KEY": e
+        },
+        body: JSON.stringify(n),
+        signal: s.signal
+      });
+    } finally {
+      o && clearTimeout(o);
+    }
+    if (!r.ok) {
+      const h = await r.text();
+      let a = null;
+      try {
+        a = JSON.parse(h);
+      } catch {
+      }
+      if (r.status === 401)
+        throw new c("Failed to authenticate - please check your token.", 401, a);
+      const w = a && a.message ? a.message : `HTTP ${r.status} error: ${h}`;
+      throw new c(w, r.status, a);
+    }
+    return r.json();
+  }
+}
+const y = 12e4, u = 36e5, f = 3e3, l = 3e4, d = 1.5;
+class _ {
+  /**
+   * @param {string} token API access token.
+   */
+  constructor(t) {
+    this.cdpLink = "", this.token = t, this.http = new m();
+  }
+  async browserOpen() {
+    const t = await this.http.post("/api/v5/browser/open", this.token);
+    return this.cdpLink = t.endpoint, t.endpoint;
+  }
+  async browserClose(t = "") {
+    t || (t = this.cdpLink);
+    const e = await this.http.post("/api/v5/browser/close", this.token, { cdpLink: t });
+    return this.cdpLink = "", e.message;
+  }
+  // TODO: Probably should be mvoed to a non-user facing component
+  async step(t, e, n, i = "") {
+    try {
+      const s = await this.http.post("/api/v5/step", this.token, {
+        mode: t,
+        method: e,
+        params: n,
+        cdpLink: i
+      }, { timeoutMs: y });
+      return s && s.message !== void 0 ? s.message : s;
+    } catch (s) {
+      if (!i || !this._shouldFallBackToPolling(s)) throw s;
+      return this._pollStepResult(i, s);
+    }
+  }
+  _shouldFallBackToPolling(t) {
+    return !!(t && t.name === "AbortError" || t && t.name === "TypeError" || t instanceof c && (t.status === 502 || t.status === 503 || t.status === 504 || t.status === 409 && typeof t.message == "string" && t.message.indexOf("Step already in progress") !== -1));
+  }
+  async _pollStepResult(t, e) {
+    const n = Date.now() + u;
+    let i = f;
+    for (; Date.now() < n; ) {
+      await this._sleep(i);
+      try {
+        const s = await this.http.post("/api/v5/step/result", this.token, { cdpLink: t });
+        if (s && s.status === "complete") return s.result;
+        if (s && s.status === "running") {
+          i = Math.min(i * d, l);
+          continue;
+        }
+        throw s && s.status === "none" ? new Error("Step did not start on the pod. Original error: " + (e && e.message ? e.message : "unknown")) : new Error("Unexpected /step/result response: " + JSON.stringify(s));
+      } catch (s) {
+        if (s instanceof c && s.status === 409)
+          throw new Error("Step failed on the pod — check the task report. " + (s.message || ""));
+        if (s instanceof c && s.status >= 400 && s.status < 500 && s.status !== 502 && s.status !== 503 && s.status !== 504)
+          throw s;
+        i = Math.min(i * d, l);
+      }
+    }
+    throw new Error("Step polling exceeded " + u / 1e3 + "s. Original error: " + (e && e.message ? e.message : "unknown"));
+  }
+  async scrape(t, e, n, i, s) {
+    return this.step(
+      "browser",
+      "AxiomApiSmartScrapeV4400",
+      [t, e, n, i, s],
+      this.cdpLink
+    );
+  }
+  async integrateAI(t) {
+    return this.step(
+      "browser",
+      "AxiomApiAiGeneric",
+      [t],
+      this.cdpLink
+    );
+  }
+  async datePicker(t, e, n, i) {
+    return this.step(
+      "driver",
+      "datePicker",
+      [t, e, n, i],
+      this.cdpLink
+    );
+  }
+  async click(t, e, n) {
+    return this.step(
+      "driver",
+      "clickV3130",
+      [t, e, n],
+      this.cdpLink
+    );
+  }
+  async clickEngagementButton(t, e) {
+    return this.step(
+      "driver",
+      "clickEngagementButton",
+      [t, e],
+      this.cdpLink
+    );
+  }
+  async clickMultiple(t, e, n) {
+    return this.step(
+      "driver",
+      "multiClickV3170",
+      [t, e, n],
+      this.cdpLink
+    );
+  }
+  async getClipboardContents() {
+    return this.step(
+      "driver",
+      "readClipboardContents",
+      [],
+      this.cdpLink
+    );
+  }
+  async enterText(t, e, n = 0, i = !1, s = null, o = !1) {
+    return this.step(
+      "driver",
+      "enterTextV4500",
+      [t, e, n, i, s, o],
+      this.cdpLink
+    );
+  }
+  async goto(t, e = !1, n = !1) {
+    return this.step(
+      "driver",
+      "gotoV4070",
+      [t, null, e, n],
+      this.cdpLink
+    );
+  }
+  async pressKeys(t, e, n) {
+    return this.step(
+      "driver",
+      "keydownV3120",
+      [t, null, e, n],
+      this.cdpLink
+    );
+  }
+  async clickAndDrag(t, e) {
+    return this.step(
+      "driver",
+      "mouseClickDragV0300",
+      [t, e],
+      this.cdpLink
+    );
+  }
+  async scrapeMetadata(t) {
+    return this.step(
+      "driver",
+      "scrapeMetadata",
+      [t],
+      this.cdpLink
+    );
+  }
+  async selectList(t, e) {
+    return this.step(
+      "driver",
+      "selectList",
+      [t, e],
+      this.cdpLink
+    );
+  }
+  async solveCaptcha(t) {
+    return this.step(
+      "driver",
+      "solveCaptchaV450",
+      [null, null, t],
+      this.cdpLink
+    );
+  }
+  async switchBrowserTab(t) {
+    return this.step(
+      "driver",
+      "switchBrowserTab",
+      [t],
+      this.cdpLink
+    );
+  }
+  // Pause on the pod, not in the client process, so the pod's session inactivity
+  // timer is reset by the step. A purely local sleep would let the session idle
+  // out and auto-close while the client was still happily waiting. Falls back to
+  // a local sleep when there is no session — nothing to keep alive.
+  async wait(t) {
+    return this.cdpLink ? this.step("driver", "wait", [t], this.cdpLink) : this._sleep(t);
+  }
+  // Local-only sleep, used by the polling loop's backoff. Never routes to the
+  // pod — that would be circular (the polling loop's whole purpose is to wait
+  // out a pod-side step that has lost its HTTP connection).
+  _sleep(t) {
+    return new Promise((e) => setTimeout(e, t));
+  }
+  async hover(t) {
+    return this.step(
+      "driver",
+      "hover",
+      [t],
+      this.cdpLink
+    );
+  }
+  async restartBrowser() {
+    return this.step(
+      "browser",
+      "AxiomApiRestartBrowser",
+      [],
+      this.cdpLink
+    );
+  }
+}
+export {
+  _ as AxiomApi
+};

package/examples/README.md

@@ -0,0 +1,17 @@
+# Examples
+
+Runnable Node scripts demonstrating common `@axiom_ai/api` patterns. Each is small (20-30 lines), ES-module syntax, and reads its API key from `AXIOM_API_KEY` in the environment.
+
+| File | Demonstrates |
+|---|---|
+| [`simple-scrape.js`](./simple-scrape.js) | Smallest valid axiom — `browserOpen → goto → scrape → browserClose` with `try/finally`. |
+| [`login-then-extract.js`](./login-then-extract.js) | `enterText` + `click` + `wait` for an auth flow, then scrape behind the login. |
+| [`parallel-sessions.js`](./parallel-sessions.js) | Two `AxiomApi` instances side by side — each has its own lifecycle. |
+
+Run any of them with:
+
+```bash
+AXIOM_API_KEY=your-key node simple-scrape.js
+```
+
+The full method surface, error semantics, and patterns reference is in [`../CLAUDE.md`](../CLAUDE.md).

package/examples/login-then-extract.js

@@ -0,0 +1,25 @@
+// Log into a site, then scrape behind auth. Demonstrates: enterText, click, wait.
+
+import { AxiomApi } from '@axiom_ai/api'
+
+async function main() {
+  const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+
+  await axiom.browserOpen()
+  try {
+    await axiom.goto('https://example.com/login')
+    await axiom.enterText('#email', process.env.SITE_EMAIL)
+    await axiom.enterText('#password', process.env.SITE_PASSWORD)
+    await axiom.click('button[type=submit]')
+    // Wait on the pod (keeps the session alive) rather than a local setTimeout.
+    await axiom.wait(2000)
+
+    await axiom.goto('https://example.com/dashboard')
+    const rows = await axiom.scrape(null, '.report-row', null, 100, {})
+    return rows
+  } finally {
+    await axiom.browserClose()
+  }
+}
+
+await main()

package/examples/parallel-sessions.js

@@ -0,0 +1,26 @@
+// Drive two sessions in parallel. Each gets its own AxiomApi instance + lifecycle.
+// Demonstrates that browserClose() is per-instance, not global.
+
+import { AxiomApi } from '@axiom_ai/api'
+
+async function scrapeOne(url) {
+  const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+  await axiom.browserOpen()
+  try {
+    await axiom.goto(url)
+    return await axiom.scrape(null, '.item', null, 20, {})
+  } finally {
+    await axiom.browserClose()
+  }
+}
+
+async function main() {
+  const urls = [
+    'https://example.com/category/a',
+    'https://example.com/category/b'
+  ]
+  const results = await Promise.all(urls.map(scrapeOne))
+  console.log('Total rows:', results.flat().length)
+}
+
+await main()

package/examples/simple-scrape.js

@@ -0,0 +1,20 @@
+// Smallest valid axiom: open browser, navigate, scrape, close.
+// Validator checks: methods on allowlist, try/finally lifecycle, no hardcoded token.
+
+import { AxiomApi } from '@axiom_ai/api'
+
+async function main() {
+  const axiom = new AxiomApi(process.env.AXIOM_API_KEY)
+
+  await axiom.browserOpen()
+  try {
+    await axiom.goto('https://example.com/products')
+    const rows = await axiom.scrape(null, '.product-card', null, 50, {})
+    console.log(`Found ${rows.length} products`)
+    return rows
+  } finally {
+    await axiom.browserClose()
+  }
+}
+
+await main()

package/package.json

@@ -2,13 +2,16 @@
   "name": "@axiom_ai/api",
   "author": "Axiom.ai",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Library for interacting with Axiom.ai browser infrastructure",
   "main": "dist/cjs/index.js",
   "module": "dist/es/index.js",
   "types": "dist/es/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "examples"
   ],
   "scripts": {
     "build:js": "vite build --mode production",
@@ -56,7 +59,11 @@
     "axiom.ai",
     "sdk",
     "browser",
-    "automation"
+    "automation",
+    "claude",
+    "claude-code",
+    "agents-md",
+    "llm-friendly"
   ],
   "license": "ISC",
   "bugs": {

package/dist/es/axiom-api.js

@@ -1,348 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-import { AxiomHttp, AxiomHttpError } from './axiom-http.js';
-// Tuning for the transparent long-running-step polling fallback. The library POSTs
-// /step with STEP_HTTP_TIMEOUT_MS as the abort deadline; if the POST times out, hits
-// a gateway error, or the backend says a previous step is still in flight, the
-// library polls /step/result with exponential backoff until the result lands or
-// STEP_MAX_POLL_DURATION_MS elapses.
-var STEP_HTTP_TIMEOUT_MS = 120000;
-var STEP_MAX_POLL_DURATION_MS = 3600000;
-var STEP_POLL_INITIAL_INTERVAL_MS = 3000;
-var STEP_POLL_MAX_INTERVAL_MS = 30000;
-var STEP_POLL_BACKOFF_FACTOR = 1.5;
-/**
- * @class
- * @public
- * A class for interacting with the Axiom API.
- */
-var AxiomApi = /** @class */ (function () {
-    /**
-     * @param {string} token API access token.
-     */
-    function AxiomApi(token) {
-        this.cdpLink = '';
-        this.token = token;
-        this.http = new AxiomHttp();
-    }
-    AxiomApi.prototype.browserOpen = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var content;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.http.post('/api/v5/browser/open', this.token)];
-                    case 1:
-                        content = _a.sent();
-                        this.cdpLink = content.endpoint;
-                        return [2 /*return*/, content.endpoint];
-                }
-            });
-        });
-    };
-    AxiomApi.prototype.browserClose = function () {
-        return __awaiter(this, arguments, void 0, function (cdpLink) {
-            var content;
-            if (cdpLink === void 0) { cdpLink = ''; }
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!cdpLink) {
-                            cdpLink = this.cdpLink;
-                        }
-                        return [4 /*yield*/, this.http.post('/api/v5/browser/close', this.token, { cdpLink: cdpLink })
-                            // Reset CDPLink to avoid staleness
-                        ];
-                    case 1:
-                        content = _a.sent();
-                        // Reset CDPLink to avoid staleness
-                        this.cdpLink = '';
-                        return [2 /*return*/, content.message];
-                }
-            });
-        });
-    };
-    // TODO: Probably should be mvoed to a non-user facing component
-    AxiomApi.prototype.step = function (mode_1, method_1, params_1) {
-        return __awaiter(this, arguments, void 0, function (mode, method, params, cdpLink) {
-            var content, e_1;
-            if (cdpLink === void 0) { cdpLink = ''; }
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        _a.trys.push([0, 2, , 3]);
-                        return [4 /*yield*/, this.http.post('/api/v5/step', this.token, {
-                                mode: mode,
-                                method: method,
-                                params: params,
-                                cdpLink: cdpLink
-                            }, { timeoutMs: STEP_HTTP_TIMEOUT_MS })];
-                    case 1:
-                        content = _a.sent();
-                        if (content && content.message !== undefined) {
-                            return [2 /*return*/, content.message];
-                        }
-                        return [2 /*return*/, content];
-                    case 2:
-                        e_1 = _a.sent();
-                        // Can only fall back to polling when there is a session to address.
-                        // One-shot /step calls have no cdpLink and surface the original error.
-                        if (!cdpLink || !this._shouldFallBackToPolling(e_1))
-                            throw e_1;
-                        return [2 /*return*/, this._pollStepResult(cdpLink, e_1)];
-                    case 3: return [2 /*return*/];
-                }
-            });
-        });
-    };
-    AxiomApi.prototype._shouldFallBackToPolling = function (error) {
-        // Direct POST never reached or never returned — step may still be running on the pod.
-        if (error && error.name === 'AbortError')
-            return true;
-        // Native fetch network failure (DNS, connection reset, etc.) surfaces as TypeError.
-        if (error && error.name === 'TypeError')
-            return true;
-        if (error instanceof AxiomHttpError) {
-            if (error.status === 502 || error.status === 503 || error.status === 504)
-                return true;
-            if (error.status === 409 && typeof error.message === 'string'
-                && error.message.indexOf('Step already in progress') !== -1)
-                return true;
-        }
-        return false;
-    };
-    AxiomApi.prototype._pollStepResult = function (cdpLink, originalError) {
-        return __awaiter(this, void 0, void 0, function () {
-            var deadline, intervalMs, content, e_2;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        deadline = Date.now() + STEP_MAX_POLL_DURATION_MS;
-                        intervalMs = STEP_POLL_INITIAL_INTERVAL_MS;
-                        _a.label = 1;
-                    case 1:
-                        if (!(Date.now() < deadline)) return [3 /*break*/, 7];
-                        return [4 /*yield*/, this._sleep(intervalMs)];
-                    case 2:
-                        _a.sent();
-                        _a.label = 3;
-                    case 3:
-                        _a.trys.push([3, 5, , 6]);
-                        return [4 /*yield*/, this.http.post('/api/v5/step/result', this.token, { cdpLink: cdpLink })];
-                    case 4:
-                        content = _a.sent();
-                        if (content && content.status === 'complete')
-                            return [2 /*return*/, content.result];
-                        if (content && content.status === 'running') {
-                            intervalMs = Math.min(intervalMs * STEP_POLL_BACKOFF_FACTOR, STEP_POLL_MAX_INTERVAL_MS);
-                            return [3 /*break*/, 1];
-                        }
-                        if (content && content.status === 'none') {
-                            throw new Error('Step did not start on the pod. Original error: '
-                                + (originalError && originalError.message ? originalError.message : 'unknown'));
-                        }
-                        throw new Error('Unexpected /step/result response: ' + JSON.stringify(content));
-                    case 5:
-                        e_2 = _a.sent();
-                        // Executor is gone (step error → finish('Failure') removed it).
-                        // Surface as a hard failure — the task report has the detail.
-                        if (e_2 instanceof AxiomHttpError && e_2.status === 409) {
-                            throw new Error('Step failed on the pod — check the task report. ' + (e_2.message || ''));
-                        }
-                        // Auth or other definite 4xx — don't keep polling.
-                        if (e_2 instanceof AxiomHttpError && e_2.status >= 400 && e_2.status < 500
-                            && e_2.status !== 502 && e_2.status !== 503 && e_2.status !== 504) {
-                            throw e_2;
-                        }
-                        // Transient network issue mid-poll — back off and retry.
-                        intervalMs = Math.min(intervalMs * STEP_POLL_BACKOFF_FACTOR, STEP_POLL_MAX_INTERVAL_MS);
-                        return [3 /*break*/, 6];
-                    case 6: return [3 /*break*/, 1];
-                    case 7: throw new Error('Step polling exceeded ' + (STEP_MAX_POLL_DURATION_MS / 1000)
-                        + 's. Original error: '
-                        + (originalError && originalError.message ? originalError.message : 'unknown'));
-                }
-            });
-        });
-    };
-    AxiomApi.prototype.scrape = function (url, selector, pager, max_results, settings) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('browser', 'AxiomApiSmartScrapeV440', [url, selector, pager, max_results, settings], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.integrateAI = function (aiOptions) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('browser', 'AxiomApiAiGeneric', [aiOptions], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.datePicker = function (selectMonth, selectMonthChangeButton, changeMonthTo, changeDayOfMonthTo) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'datePicker', [selectMonth, selectMonthChangeButton, changeMonthTo, changeDayOfMonthTo], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.click = function (select, leftClickRightClick, optionalClick) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'clickV3130', [select, leftClickRightClick, optionalClick], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.clickEngagementButton = function (select, setValueToCheck) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'clickEngagementButton', [select, setValueToCheck], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.clickMultiple = function (select, leftClickRightClick, maxClicks) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'multiClickV3170', [select, leftClickRightClick, maxClicks], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.getClipboardContents = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'readClipboardContents', [], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.enterText = function (selectTextField_1, text_1) {
-        return __awaiter(this, arguments, void 0, function (selectTextField, text, delay, appendExisting, customLineBreak, optionalText) {
-            if (delay === void 0) { delay = 0; }
-            if (appendExisting === void 0) { appendExisting = false; }
-            if (customLineBreak === void 0) { customLineBreak = null; }
-            if (optionalText === void 0) { optionalText = false; }
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'enterTextV4500', [selectTextField, text, delay, appendExisting, customLineBreak, optionalText], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.goto = function (url_1) {
-        return __awaiter(this, arguments, void 0, function (url, doNotShareLocalstorage, openInNewTab) {
-            if (doNotShareLocalstorage === void 0) { doNotShareLocalstorage = false; }
-            if (openInNewTab === void 0) { openInNewTab = false; }
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'gotoV4070', [url, null, doNotShareLocalstorage, openInNewTab], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.pressKeys = function (key, delimiter, delay) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'keydownV3120', [key, null, delimiter, delay], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.clickAndDrag = function (startCoordinates, endCoordinates) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'mouseClickDragV0300', [startCoordinates, endCoordinates], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.scrapeMetadata = function (metadata) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'scrapeMetadata', [metadata], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.selectList = function (select, text) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'selectList', [select, text], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.solveCaptcha = function (apiKey) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'solveCaptchaV450', [null, null, apiKey], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.switchBrowserTab = function (selectTab) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'switchBrowserTab', [selectTab], this.cdpLink)];
-            });
-        });
-    };
-    // Pause on the pod, not in the client process, so the pod's session inactivity
-    // timer is reset by the step. A purely local sleep would let the session idle
-    // out and auto-close while the client was still happily waiting. Falls back to
-    // a local sleep when there is no session — nothing to keep alive.
-    AxiomApi.prototype.wait = function (time) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                if (this.cdpLink) {
-                    return [2 /*return*/, this.step('driver', 'wait', [time], this.cdpLink)];
-                }
-                return [2 /*return*/, this._sleep(time)];
-            });
-        });
-    };
-    // Local-only sleep, used by the polling loop's backoff. Never routes to the
-    // pod — that would be circular (the polling loop's whole purpose is to wait
-    // out a pod-side step that has lost its HTTP connection).
-    AxiomApi.prototype._sleep = function (ms) {
-        return new Promise(function (resolve) { return setTimeout(resolve, ms); });
-    };
-    AxiomApi.prototype.hover = function (select) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('driver', 'hover', [select], this.cdpLink)];
-            });
-        });
-    };
-    AxiomApi.prototype.restartBrowser = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.step('browser', 'AxiomApiRestartBrowser', [], this.cdpLink)];
-            });
-        });
-    };
-    return AxiomApi;
-}());
-export { AxiomApi };

package/dist/es/axiom-http.js

@@ -1,122 +0,0 @@
-var __extends = (this && this.__extends) || (function () {
-    var extendStatics = function (d, b) {
-        extendStatics = Object.setPrototypeOf ||
-            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
-            function (d, b) { for (var p in b) if (Object.prototype.hasOwnProperty.call(b, p)) d[p] = b[p]; };
-        return extendStatics(d, b);
-    };
-    return function (d, b) {
-        if (typeof b !== "function" && b !== null)
-            throw new TypeError("Class extends value " + String(b) + " is not a constructor or null");
-        extendStatics(d, b);
-        function __() { this.constructor = d; }
-        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
-    };
-})();
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-};
-import { ENDPOINT } from "./config";
-var AxiomHttpError = /** @class */ (function (_super) {
-    __extends(AxiomHttpError, _super);
-    function AxiomHttpError(message, status, body) {
-        var _this = _super.call(this, message) || this;
-        _this.name = 'AxiomHttpError';
-        _this.status = status;
-        _this.body = body;
-        return _this;
-    }
-    return AxiomHttpError;
-}(Error));
-export { AxiomHttpError };
-var AxiomHttp = /** @class */ (function () {
-    function AxiomHttp() {
-    }
-    AxiomHttp.prototype.post = function (uri_1, token_1, body_1) {
-        return __awaiter(this, arguments, void 0, function (uri, token, body, options) {
-            var controller, timeoutId, rawResponse, errorText, parsed, msg;
-            if (options === void 0) { options = {}; }
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        controller = new AbortController();
-                        timeoutId = null;
-                        if (options.timeoutMs && options.timeoutMs > 0) {
-                            timeoutId = setTimeout(function () { return controller.abort(); }, options.timeoutMs);
-                        }
-                        _a.label = 1;
-                    case 1:
-                        _a.trys.push([1, , 3, 4]);
-                        return [4 /*yield*/, fetch(ENDPOINT + uri, {
-                                method: 'POST',
-                                headers: {
-                                    'Accept': 'application/json',
-                                    'Content-Type': 'application/json',
-                                    'X-API-KEY': token
-                                },
-                                body: JSON.stringify(body),
-                                signal: controller.signal
-                            })];
-                    case 2:
-                        rawResponse = _a.sent();
-                        return [3 /*break*/, 4];
-                    case 3:
-                        if (timeoutId)
-                            clearTimeout(timeoutId);
-                        return [7 /*endfinally*/];
-                    case 4:
-                        if (!!rawResponse.ok) return [3 /*break*/, 6];
-                        return [4 /*yield*/, rawResponse.text()];
-                    case 5:
-                        errorText = _a.sent();
-                        parsed = null;
-                        try {
-                            parsed = JSON.parse(errorText);
-                        }
-                        catch (_) { /* non-JSON body */ }
-                        if (rawResponse.status === 401) {
-                            throw new AxiomHttpError("Failed to authenticate - please check your token.", 401, parsed);
-                        }
-                        msg = (parsed && parsed.message) ? parsed.message : "HTTP ".concat(rawResponse.status, " error: ").concat(errorText);
-                        throw new AxiomHttpError(msg, rawResponse.status, parsed);
-                    case 6: return [2 /*return*/, rawResponse.json()];
-                }
-            });
-        });
-    };
-    return AxiomHttp;
-}());
-export { AxiomHttp };

package/dist/es/config.js

@@ -1 +0,0 @@
-export var ENDPOINT = "https://lar.axiom.ai";