notte-sdk 0.0.1

package/dist/index.js

@@ -0,0 +1,2866 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Agent: () => Agent,
+  NotteClient: () => NotteClient,
+  NotteFunction: () => NotteFunction,
+  NottePersona: () => NottePersona,
+  NotteProxyAuthError: () => NotteProxyAuthError,
+  NotteVault: () => NotteVault,
+  Session: () => Session,
+  agentStart: () => agentStart,
+  agentStatus: () => agentStatus,
+  agentStop: () => agentStop,
+  anythingStart: () => anythingStart,
+  client: () => client,
+  createClient: () => createClient2,
+  default: () => NotteClient,
+  fileDownload: () => fileDownload,
+  fileListDownloads: () => fileListDownloads,
+  fileListUploads: () => fileListUploads,
+  fileUpload: () => fileUpload,
+  fileUploadDownloadedFile: () => fileUploadDownloadedFile,
+  functionCreate: () => functionCreate,
+  functionDelete: () => functionDelete,
+  functionDownloadUrl: () => functionDownloadUrl,
+  functionFork: () => functionFork,
+  functionRunGetMetadata: () => functionRunGetMetadata,
+  functionRunStart: () => functionRunStart,
+  functionRunStop: () => functionRunStop,
+  functionRunUpdateMetadata: () => functionRunUpdateMetadata,
+  functionScheduleDelete: () => functionScheduleDelete,
+  functionScheduleSet: () => functionScheduleSet,
+  functionUpdate: () => functionUpdate,
+  getScript: () => getScript,
+  getSessionScript: () => getSessionScript,
+  getUsage: () => getUsage,
+  getUsageLogs: () => getUsageLogs,
+  healthCheck: () => healthCheck,
+  improvePrompt: () => improvePrompt,
+  listAgents: () => listAgents,
+  listFunctionRunsByFunctionId: () => listFunctionRunsByFunctionId,
+  listFunctions: () => listFunctions,
+  listPersonas: () => listPersonas,
+  listSessions: () => listSessions,
+  listVaults: () => listVaults,
+  nudgePrompt: () => nudgePrompt,
+  pageExecute: () => pageExecute,
+  pageObserve: () => pageObserve,
+  pageScrape: () => pageScrape,
+  pageScreenshot: () => pageScreenshot,
+  personaCreate: () => personaCreate,
+  personaDelete: () => personaDelete,
+  personaEmailsList: () => personaEmailsList,
+  personaGet: () => personaGet,
+  personaSmsList: () => personaSmsList,
+  profileCreate: () => profileCreate,
+  profileDelete: () => profileDelete,
+  profileGet: () => profileGet,
+  profileList: () => profileList,
+  scrapeFromHtml: () => scrapeFromHtml,
+  scrapeWebpage: () => scrapeWebpage,
+  sessionCookiesGet: () => sessionCookiesGet,
+  sessionCookiesSet: () => sessionCookiesSet,
+  sessionDebugInfo: () => sessionDebugInfo,
+  sessionNetworkLogs: () => sessionNetworkLogs,
+  sessionOffset: () => sessionOffset,
+  sessionReplay: () => sessionReplay,
+  sessionStart: () => sessionStart,
+  sessionStatus: () => sessionStatus,
+  sessionStop: () => sessionStop,
+  vaultCreate: () => vaultCreate,
+  vaultCredentialsAdd: () => vaultCredentialsAdd,
+  vaultCredentialsDelete: () => vaultCredentialsDelete,
+  vaultCredentialsGet: () => vaultCredentialsGet,
+  vaultCredentialsList: () => vaultCredentialsList,
+  vaultCreditCardDelete: () => vaultCreditCardDelete,
+  vaultCreditCardGet: () => vaultCreditCardGet,
+  vaultCreditCardSet: () => vaultCreditCardSet,
+  vaultDelete: () => vaultDelete,
+  vaultUpdate: () => vaultUpdate
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/client/core/bodySerializer.gen.ts
+var serializeFormDataPair = (data, key, value) => {
+  if (typeof value === "string" || value instanceof Blob) {
+    data.append(key, value);
+  } else if (value instanceof Date) {
+    data.append(key, value.toISOString());
+  } else {
+    data.append(key, JSON.stringify(value));
+  }
+};
+var formDataBodySerializer = {
+  bodySerializer: (body) => {
+    const data = new FormData();
+    Object.entries(body).forEach(([key, value]) => {
+      if (value === void 0 || value === null) {
+        return;
+      }
+      if (Array.isArray(value)) {
+        value.forEach((v) => serializeFormDataPair(data, key, v));
+      } else {
+        serializeFormDataPair(data, key, value);
+      }
+    });
+    return data;
+  }
+};
+var jsonBodySerializer = {
+  bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value)
+};
+
+// src/lib/client/core/params.gen.ts
+var extraPrefixesMap = {
+  $body_: "body",
+  $headers_: "headers",
+  $path_: "path",
+  $query_: "query"
+};
+var extraPrefixes = Object.entries(extraPrefixesMap);
+
+// src/lib/client/core/serverSentEvents.gen.ts
+var createSseClient = ({
+  onRequest,
+  onSseError,
+  onSseEvent,
+  responseTransformer,
+  responseValidator,
+  sseDefaultRetryDelay,
+  sseMaxRetryAttempts,
+  sseMaxRetryDelay,
+  sseSleepFn,
+  url,
+  ...options
+}) => {
+  let lastEventId;
+  const sleep = sseSleepFn ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+  const createStream = async function* () {
+    let retryDelay = sseDefaultRetryDelay ?? 3e3;
+    let attempt = 0;
+    const signal = options.signal ?? new AbortController().signal;
+    while (true) {
+      if (signal.aborted) break;
+      attempt++;
+      const headers = options.headers instanceof Headers ? options.headers : new Headers(options.headers);
+      if (lastEventId !== void 0) {
+        headers.set("Last-Event-ID", lastEventId);
+      }
+      try {
+        const requestInit = {
+          redirect: "follow",
+          ...options,
+          body: options.serializedBody,
+          headers,
+          signal
+        };
+        let request = new Request(url, requestInit);
+        if (onRequest) {
+          request = await onRequest(url, requestInit);
+        }
+        const _fetch = options.fetch ?? globalThis.fetch;
+        const response = await _fetch(request);
+        if (!response.ok) throw new Error(`SSE failed: ${response.status} ${response.statusText}`);
+        if (!response.body) throw new Error("No body in SSE response");
+        const reader = response.body.pipeThrough(new TextDecoderStream()).getReader();
+        let buffer = "";
+        const abortHandler = () => {
+          try {
+            reader.cancel();
+          } catch {
+          }
+        };
+        signal.addEventListener("abort", abortHandler);
+        try {
+          while (true) {
+            const { done, value } = await reader.read();
+            if (done) break;
+            buffer += value;
+            buffer = buffer.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+            const chunks = buffer.split("\n\n");
+            buffer = chunks.pop() ?? "";
+            for (const chunk of chunks) {
+              const lines = chunk.split("\n");
+              const dataLines = [];
+              let eventName;
+              for (const line of lines) {
+                if (line.startsWith("data:")) {
+                  dataLines.push(line.replace(/^data:\s*/, ""));
+                } else if (line.startsWith("event:")) {
+                  eventName = line.replace(/^event:\s*/, "");
+                } else if (line.startsWith("id:")) {
+                  lastEventId = line.replace(/^id:\s*/, "");
+                } else if (line.startsWith("retry:")) {
+                  const parsed = Number.parseInt(line.replace(/^retry:\s*/, ""), 10);
+                  if (!Number.isNaN(parsed)) {
+                    retryDelay = parsed;
+                  }
+                }
+              }
+              let data;
+              let parsedJson = false;
+              if (dataLines.length) {
+                const rawData = dataLines.join("\n");
+                try {
+                  data = JSON.parse(rawData);
+                  parsedJson = true;
+                } catch {
+                  data = rawData;
+                }
+              }
+              if (parsedJson) {
+                if (responseValidator) {
+                  await responseValidator(data);
+                }
+                if (responseTransformer) {
+                  data = await responseTransformer(data);
+                }
+              }
+              onSseEvent?.({
+                data,
+                event: eventName,
+                id: lastEventId,
+                retry: retryDelay
+              });
+              if (dataLines.length) {
+                yield data;
+              }
+            }
+          }
+        } finally {
+          signal.removeEventListener("abort", abortHandler);
+          reader.releaseLock();
+        }
+        break;
+      } catch (error) {
+        onSseError?.(error);
+        if (sseMaxRetryAttempts !== void 0 && attempt >= sseMaxRetryAttempts) {
+          break;
+        }
+        const backoff = Math.min(retryDelay * 2 ** (attempt - 1), sseMaxRetryDelay ?? 3e4);
+        await sleep(backoff);
+      }
+    }
+  };
+  const stream = createStream();
+  return { stream };
+};
+
+// src/lib/client/core/pathSerializer.gen.ts
+var separatorArrayExplode = (style) => {
+  switch (style) {
+    case "label":
+      return ".";
+    case "matrix":
+      return ";";
+    case "simple":
+      return ",";
+    default:
+      return "&";
+  }
+};
+var separatorArrayNoExplode = (style) => {
+  switch (style) {
+    case "form":
+      return ",";
+    case "pipeDelimited":
+      return "|";
+    case "spaceDelimited":
+      return "%20";
+    default:
+      return ",";
+  }
+};
+var separatorObjectExplode = (style) => {
+  switch (style) {
+    case "label":
+      return ".";
+    case "matrix":
+      return ";";
+    case "simple":
+      return ",";
+    default:
+      return "&";
+  }
+};
+var serializeArrayParam = ({
+  allowReserved,
+  explode,
+  name,
+  style,
+  value
+}) => {
+  if (!explode) {
+    const joinedValues2 = (allowReserved ? value : value.map((v) => encodeURIComponent(v))).join(separatorArrayNoExplode(style));
+    switch (style) {
+      case "label":
+        return `.${joinedValues2}`;
+      case "matrix":
+        return `;${name}=${joinedValues2}`;
+      case "simple":
+        return joinedValues2;
+      default:
+        return `${name}=${joinedValues2}`;
+    }
+  }
+  const separator = separatorArrayExplode(style);
+  const joinedValues = value.map((v) => {
+    if (style === "label" || style === "simple") {
+      return allowReserved ? v : encodeURIComponent(v);
+    }
+    return serializePrimitiveParam({
+      allowReserved,
+      name,
+      value: v
+    });
+  }).join(separator);
+  return style === "label" || style === "matrix" ? separator + joinedValues : joinedValues;
+};
+var serializePrimitiveParam = ({
+  allowReserved,
+  name,
+  value
+}) => {
+  if (value === void 0 || value === null) {
+    return "";
+  }
+  if (typeof value === "object") {
+    throw new Error(
+      "Deeply-nested arrays/objects aren\u2019t supported. Provide your own `querySerializer()` to handle these."
+    );
+  }
+  return `${name}=${allowReserved ? value : encodeURIComponent(value)}`;
+};
+var serializeObjectParam = ({
+  allowReserved,
+  explode,
+  name,
+  style,
+  value,
+  valueOnly
+}) => {
+  if (value instanceof Date) {
+    return valueOnly ? value.toISOString() : `${name}=${value.toISOString()}`;
+  }
+  if (style !== "deepObject" && !explode) {
+    let values = [];
+    Object.entries(value).forEach(([key, v]) => {
+      values = [...values, key, allowReserved ? v : encodeURIComponent(v)];
+    });
+    const joinedValues2 = values.join(",");
+    switch (style) {
+      case "form":
+        return `${name}=${joinedValues2}`;
+      case "label":
+        return `.${joinedValues2}`;
+      case "matrix":
+        return `;${name}=${joinedValues2}`;
+      default:
+        return joinedValues2;
+    }
+  }
+  const separator = separatorObjectExplode(style);
+  const joinedValues = Object.entries(value).map(
+    ([key, v]) => serializePrimitiveParam({
+      allowReserved,
+      name: style === "deepObject" ? `${name}[${key}]` : key,
+      value: v
+    })
+  ).join(separator);
+  return style === "label" || style === "matrix" ? separator + joinedValues : joinedValues;
+};
+
+// src/lib/client/core/utils.gen.ts
+var PATH_PARAM_RE = /\{[^{}]+\}/g;
+var defaultPathSerializer = ({ path, url: _url }) => {
+  let url = _url;
+  const matches = _url.match(PATH_PARAM_RE);
+  if (matches) {
+    for (const match of matches) {
+      let explode = false;
+      let name = match.substring(1, match.length - 1);
+      let style = "simple";
+      if (name.endsWith("*")) {
+        explode = true;
+        name = name.substring(0, name.length - 1);
+      }
+      if (name.startsWith(".")) {
+        name = name.substring(1);
+        style = "label";
+      } else if (name.startsWith(";")) {
+        name = name.substring(1);
+        style = "matrix";
+      }
+      const value = path[name];
+      if (value === void 0 || value === null) {
+        continue;
+      }
+      if (Array.isArray(value)) {
+        url = url.replace(match, serializeArrayParam({ explode, name, style, value }));
+        continue;
+      }
+      if (typeof value === "object") {
+        url = url.replace(
+          match,
+          serializeObjectParam({
+            explode,
+            name,
+            style,
+            value,
+            valueOnly: true
+          })
+        );
+        continue;
+      }
+      if (style === "matrix") {
+        url = url.replace(
+          match,
+          `;${serializePrimitiveParam({
+            name,
+            value
+          })}`
+        );
+        continue;
+      }
+      const replaceValue = encodeURIComponent(
+        style === "label" ? `.${value}` : value
+      );
+      url = url.replace(match, replaceValue);
+    }
+  }
+  return url;
+};
+var getUrl = ({
+  baseUrl,
+  path,
+  query,
+  querySerializer,
+  url: _url
+}) => {
+  const pathUrl = _url.startsWith("/") ? _url : `/${_url}`;
+  let url = (baseUrl ?? "") + pathUrl;
+  if (path) {
+    url = defaultPathSerializer({ path, url });
+  }
+  let search = query ? querySerializer(query) : "";
+  if (search.startsWith("?")) {
+    search = search.substring(1);
+  }
+  if (search) {
+    url += `?${search}`;
+  }
+  return url;
+};
+function getValidRequestBody(options) {
+  const hasBody = options.body !== void 0;
+  const isSerializedBody = hasBody && options.bodySerializer;
+  if (isSerializedBody) {
+    if ("serializedBody" in options) {
+      const hasSerializedBody = options.serializedBody !== void 0 && options.serializedBody !== "";
+      return hasSerializedBody ? options.serializedBody : null;
+    }
+    return options.body !== "" ? options.body : null;
+  }
+  if (hasBody) {
+    return options.body;
+  }
+  return void 0;
+}
+
+// src/lib/client/core/auth.gen.ts
+var getAuthToken = async (auth, callback) => {
+  const token = typeof callback === "function" ? await callback(auth) : callback;
+  if (!token) {
+    return;
+  }
+  if (auth.scheme === "bearer") {
+    return `Bearer ${token}`;
+  }
+  if (auth.scheme === "basic") {
+    return `Basic ${btoa(token)}`;
+  }
+  return token;
+};
+
+// src/lib/client/client/utils.gen.ts
+var createQuerySerializer = ({
+  parameters = {},
+  ...args
+} = {}) => {
+  const querySerializer = (queryParams) => {
+    const search = [];
+    if (queryParams && typeof queryParams === "object") {
+      for (const name in queryParams) {
+        const value = queryParams[name];
+        if (value === void 0 || value === null) {
+          continue;
+        }
+        const options = parameters[name] || args;
+        if (Array.isArray(value)) {
+          const serializedArray = serializeArrayParam({
+            allowReserved: options.allowReserved,
+            explode: true,
+            name,
+            style: "form",
+            value,
+            ...options.array
+          });
+          if (serializedArray) search.push(serializedArray);
+        } else if (typeof value === "object") {
+          const serializedObject = serializeObjectParam({
+            allowReserved: options.allowReserved,
+            explode: true,
+            name,
+            style: "deepObject",
+            value,
+            ...options.object
+          });
+          if (serializedObject) search.push(serializedObject);
+        } else {
+          const serializedPrimitive = serializePrimitiveParam({
+            allowReserved: options.allowReserved,
+            name,
+            value
+          });
+          if (serializedPrimitive) search.push(serializedPrimitive);
+        }
+      }
+    }
+    return search.join("&");
+  };
+  return querySerializer;
+};
+var getParseAs = (contentType) => {
+  if (!contentType) {
+    return "stream";
+  }
+  const cleanContent = contentType.split(";")[0]?.trim();
+  if (!cleanContent) {
+    return;
+  }
+  if (cleanContent.startsWith("application/json") || cleanContent.endsWith("+json")) {
+    return "json";
+  }
+  if (cleanContent === "multipart/form-data") {
+    return "formData";
+  }
+  if (["application/", "audio/", "image/", "video/"].some((type) => cleanContent.startsWith(type))) {
+    return "blob";
+  }
+  if (cleanContent.startsWith("text/")) {
+    return "text";
+  }
+  return;
+};
+var checkForExistence = (options, name) => {
+  if (!name) {
+    return false;
+  }
+  if (options.headers.has(name) || options.query?.[name] || options.headers.get("Cookie")?.includes(`${name}=`)) {
+    return true;
+  }
+  return false;
+};
+var setAuthParams = async ({
+  security,
+  ...options
+}) => {
+  for (const auth of security) {
+    if (checkForExistence(options, auth.name)) {
+      continue;
+    }
+    const token = await getAuthToken(auth, options.auth);
+    if (!token) {
+      continue;
+    }
+    const name = auth.name ?? "Authorization";
+    switch (auth.in) {
+      case "query":
+        if (!options.query) {
+          options.query = {};
+        }
+        options.query[name] = token;
+        break;
+      case "cookie":
+        options.headers.append("Cookie", `${name}=${token}`);
+        break;
+      case "header":
+      default:
+        options.headers.set(name, token);
+        break;
+    }
+  }
+};
+var buildUrl = (options) => getUrl({
+  baseUrl: options.baseUrl,
+  path: options.path,
+  query: options.query,
+  querySerializer: typeof options.querySerializer === "function" ? options.querySerializer : createQuerySerializer(options.querySerializer),
+  url: options.url
+});
+var mergeConfigs = (a, b) => {
+  const config = { ...a, ...b };
+  if (config.baseUrl?.endsWith("/")) {
+    config.baseUrl = config.baseUrl.substring(0, config.baseUrl.length - 1);
+  }
+  config.headers = mergeHeaders(a.headers, b.headers);
+  return config;
+};
+var headersEntries = (headers) => {
+  const entries = [];
+  headers.forEach((value, key) => {
+    entries.push([key, value]);
+  });
+  return entries;
+};
+var mergeHeaders = (...headers) => {
+  const mergedHeaders = new Headers();
+  for (const header of headers) {
+    if (!header) {
+      continue;
+    }
+    const iterator = header instanceof Headers ? headersEntries(header) : Object.entries(header);
+    for (const [key, value] of iterator) {
+      if (value === null) {
+        mergedHeaders.delete(key);
+      } else if (Array.isArray(value)) {
+        for (const v of value) {
+          mergedHeaders.append(key, v);
+        }
+      } else if (value !== void 0) {
+        mergedHeaders.set(
+          key,
+          typeof value === "object" ? JSON.stringify(value) : value
+        );
+      }
+    }
+  }
+  return mergedHeaders;
+};
+var Interceptors = class {
+  constructor() {
+    this.fns = [];
+  }
+  clear() {
+    this.fns = [];
+  }
+  eject(id) {
+    const index = this.getInterceptorIndex(id);
+    if (this.fns[index]) {
+      this.fns[index] = null;
+    }
+  }
+  exists(id) {
+    const index = this.getInterceptorIndex(id);
+    return Boolean(this.fns[index]);
+  }
+  getInterceptorIndex(id) {
+    if (typeof id === "number") {
+      return this.fns[id] ? id : -1;
+    }
+    return this.fns.indexOf(id);
+  }
+  update(id, fn) {
+    const index = this.getInterceptorIndex(id);
+    if (this.fns[index]) {
+      this.fns[index] = fn;
+      return id;
+    }
+    return false;
+  }
+  use(fn) {
+    this.fns.push(fn);
+    return this.fns.length - 1;
+  }
+};
+var createInterceptors = () => ({
+  error: new Interceptors(),
+  request: new Interceptors(),
+  response: new Interceptors()
+});
+var defaultQuerySerializer = createQuerySerializer({
+  allowReserved: false,
+  array: {
+    explode: true,
+    style: "form"
+  },
+  object: {
+    explode: true,
+    style: "deepObject"
+  }
+});
+var defaultHeaders = {
+  "Content-Type": "application/json"
+};
+var createConfig = (override = {}) => ({
+  ...jsonBodySerializer,
+  headers: defaultHeaders,
+  parseAs: "auto",
+  querySerializer: defaultQuerySerializer,
+  ...override
+});
+
+// src/lib/client/client/client.gen.ts
+var createClient = (config = {}) => {
+  let _config = mergeConfigs(createConfig(), config);
+  const getConfig = () => ({ ..._config });
+  const setConfig = (config2) => {
+    _config = mergeConfigs(_config, config2);
+    return getConfig();
+  };
+  const interceptors = createInterceptors();
+  const beforeRequest = async (options) => {
+    const opts = {
+      ..._config,
+      ...options,
+      fetch: options.fetch ?? _config.fetch ?? globalThis.fetch,
+      headers: mergeHeaders(_config.headers, options.headers),
+      serializedBody: void 0
+    };
+    if (opts.security) {
+      await setAuthParams({
+        ...opts,
+        security: opts.security
+      });
+    }
+    if (opts.requestValidator) {
+      await opts.requestValidator(opts);
+    }
+    if (opts.body !== void 0 && opts.bodySerializer) {
+      opts.serializedBody = opts.bodySerializer(opts.body);
+    }
+    if (opts.body === void 0 || opts.serializedBody === "") {
+      opts.headers.delete("Content-Type");
+    }
+    const resolvedOpts = opts;
+    const url = buildUrl(resolvedOpts);
+    return { opts: resolvedOpts, url };
+  };
+  const request = async (options) => {
+    const { opts, url } = await beforeRequest(options);
+    const requestInit = {
+      redirect: "follow",
+      ...opts,
+      body: getValidRequestBody(opts)
+    };
+    let request2 = new Request(url, requestInit);
+    for (const fn of interceptors.request.fns) {
+      if (fn) {
+        request2 = await fn(request2, opts);
+      }
+    }
+    const _fetch = opts.fetch;
+    let response;
+    try {
+      response = await _fetch(request2);
+    } catch (error2) {
+      let finalError2 = error2;
+      for (const fn of interceptors.error.fns) {
+        if (fn) {
+          finalError2 = await fn(error2, void 0, request2, opts);
+        }
+      }
+      finalError2 = finalError2 || {};
+      if (opts.throwOnError) {
+        throw finalError2;
+      }
+      return opts.responseStyle === "data" ? void 0 : {
+        error: finalError2,
+        request: request2,
+        response: void 0
+      };
+    }
+    for (const fn of interceptors.response.fns) {
+      if (fn) {
+        response = await fn(response, request2, opts);
+      }
+    }
+    const result = {
+      request: request2,
+      response
+    };
+    if (response.ok) {
+      const parseAs = (opts.parseAs === "auto" ? getParseAs(response.headers.get("Content-Type")) : opts.parseAs) ?? "json";
+      if (response.status === 204 || response.headers.get("Content-Length") === "0") {
+        let emptyData;
+        switch (parseAs) {
+          case "arrayBuffer":
+          case "blob":
+          case "text":
+            emptyData = await response[parseAs]();
+            break;
+          case "formData":
+            emptyData = new FormData();
+            break;
+          case "stream":
+            emptyData = response.body;
+            break;
+          case "json":
+          default:
+            emptyData = {};
+            break;
+        }
+        return opts.responseStyle === "data" ? emptyData : {
+          data: emptyData,
+          ...result
+        };
+      }
+      let data;
+      switch (parseAs) {
+        case "arrayBuffer":
+        case "blob":
+        case "formData":
+        case "text":
+          data = await response[parseAs]();
+          break;
+        case "json": {
+          const text = await response.text();
+          data = text ? JSON.parse(text) : {};
+          break;
+        }
+        case "stream":
+          return opts.responseStyle === "data" ? response.body : {
+            data: response.body,
+            ...result
+          };
+      }
+      if (parseAs === "json") {
+        if (opts.responseValidator) {
+          await opts.responseValidator(data);
+        }
+        if (opts.responseTransformer) {
+          data = await opts.responseTransformer(data);
+        }
+      }
+      return opts.responseStyle === "data" ? data : {
+        data,
+        ...result
+      };
+    }
+    const textError = await response.text();
+    let jsonError;
+    try {
+      jsonError = JSON.parse(textError);
+    } catch {
+    }
+    const error = jsonError ?? textError;
+    let finalError = error;
+    for (const fn of interceptors.error.fns) {
+      if (fn) {
+        finalError = await fn(error, response, request2, opts);
+      }
+    }
+    finalError = finalError || {};
+    if (opts.throwOnError) {
+      throw finalError;
+    }
+    return opts.responseStyle === "data" ? void 0 : {
+      error: finalError,
+      ...result
+    };
+  };
+  const makeMethodFn = (method) => (options) => request({ ...options, method });
+  const makeSseFn = (method) => async (options) => {
+    const { opts, url } = await beforeRequest(options);
+    return createSseClient({
+      ...opts,
+      body: opts.body,
+      headers: opts.headers,
+      method,
+      onRequest: async (url2, init) => {
+        let request2 = new Request(url2, init);
+        for (const fn of interceptors.request.fns) {
+          if (fn) {
+            request2 = await fn(request2, opts);
+          }
+        }
+        return request2;
+      },
+      serializedBody: getValidRequestBody(opts),
+      url
+    });
+  };
+  const _buildUrl = (options) => buildUrl({ ..._config, ...options });
+  return {
+    buildUrl: _buildUrl,
+    connect: makeMethodFn("CONNECT"),
+    delete: makeMethodFn("DELETE"),
+    get: makeMethodFn("GET"),
+    getConfig,
+    head: makeMethodFn("HEAD"),
+    interceptors,
+    options: makeMethodFn("OPTIONS"),
+    patch: makeMethodFn("PATCH"),
+    post: makeMethodFn("POST"),
+    put: makeMethodFn("PUT"),
+    request,
+    setConfig,
+    sse: {
+      connect: makeSseFn("CONNECT"),
+      delete: makeSseFn("DELETE"),
+      get: makeSseFn("GET"),
+      head: makeSseFn("HEAD"),
+      options: makeSseFn("OPTIONS"),
+      patch: makeSseFn("PATCH"),
+      post: makeSseFn("POST"),
+      put: makeSseFn("PUT"),
+      trace: makeSseFn("TRACE")
+    },
+    trace: makeMethodFn("TRACE")
+  };
+};
+
+// src/lib/client/client.gen.ts
+var client = createClient(createConfig({ baseUrl: "https://us-staging.notte.cc" }));
+
+// src/lib/client/sdk.gen.ts
+var listSessions = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions",
+  ...options
+});
+var sessionStart = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/start",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var sessionStatus = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}",
+  ...options
+});
+var getSessionScript = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/workflow/code",
+  ...options
+});
+var sessionStop = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/stop",
+  ...options
+});
+var sessionCookiesGet = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/cookies",
+  ...options
+});
+var sessionCookiesSet = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/cookies",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var sessionDebugInfo = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/debug",
+  ...options
+});
+var sessionOffset = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/offset",
+  ...options
+});
+var pageObserve = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/page/observe",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var pageScreenshot = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/page/screenshot",
+  ...options
+});
+var pageExecute = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/page/execute",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var pageScrape = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/page/scrape",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var sessionNetworkLogs = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/network/logs",
+  ...options
+});
+var sessionReplay = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/sessions/{session_id}/replay",
+  ...options
+});
+var agentStart = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/agents/start",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var agentStatus = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/agents/{agent_id}",
+  ...options
+});
+var getScript = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/agents/{agent_id}/workflow/code",
+  ...options
+});
+var agentStop = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/agents/{agent_id}/stop",
+  ...options
+});
+var listAgents = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/agents",
+  ...options
+});
+var listFunctions = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions",
+  ...options
+});
+var functionCreate = (options) => (options.client ?? client).post({
+  ...formDataBodySerializer,
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions",
+  ...options,
+  headers: {
+    "Content-Type": null,
+    ...options.headers
+  }
+});
+var functionDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}",
+  ...options
+});
+var functionDownloadUrl = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}",
+  ...options
+});
+var functionUpdate = (options) => (options.client ?? client).post({
+  ...formDataBodySerializer,
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}",
+  ...options,
+  headers: {
+    "Content-Type": null,
+    ...options.headers
+  }
+});
+var functionFork = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/fork",
+  ...options
+});
+var functionScheduleDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedule",
+  ...options
+});
+var functionScheduleSet = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/schedule",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var functionRunStart = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/runs/start",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var functionRunStop = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/runs/{run_id}",
+  ...options
+});
+var functionRunGetMetadata = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/runs/{run_id}",
+  ...options
+});
+var functionRunUpdateMetadata = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/runs/{run_id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var listFunctionRunsByFunctionId = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/functions/{function_id}/runs",
+  ...options
+});
+var vaultCreate = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/create",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var vaultCredentialsDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}/credentials",
+  ...options
+});
+var vaultCredentialsGet = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}/credentials",
+  ...options
+});
+var vaultCredentialsAdd = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}/credentials",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var vaultDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}",
+  ...options
+});
+var vaultCredentialsList = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}",
+  ...options
+});
+var vaultUpdate = (options) => (options.client ?? client).patch({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var vaultCreditCardDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}/card",
+  ...options
+});
+var vaultCreditCardGet = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}/card",
+  ...options
+});
+var vaultCreditCardSet = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults/{vault_id}/card",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var listVaults = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/vaults",
+  ...options
+});
+var profileCreate = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/profiles/create",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var profileDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/profiles/{profile_id}",
+  ...options
+});
+var profileGet = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/profiles/{profile_id}",
+  ...options
+});
+var profileList = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/profiles",
+  ...options
+});
+var personaCreate = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/personas/create",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var personaDelete = (options) => (options.client ?? client).delete({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/personas/{persona_id}",
+  ...options
+});
+var personaGet = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/personas/{persona_id}",
+  ...options
+});
+var personaEmailsList = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/personas/{persona_id}/emails",
+  ...options
+});
+var listPersonas = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/personas",
+  ...options
+});
+var personaSmsList = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/personas/{persona_id}/sms",
+  ...options
+});
+var improvePrompt = (options) => (options.client ?? client).post({
+  url: "/prompts/improve",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var nudgePrompt = (options) => (options.client ?? client).post({
+  url: "/prompts/nudge",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var getUsage = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/usage",
+  ...options
+});
+var getUsageLogs = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/usage/logs",
+  ...options
+});
+var fileDownload = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/storage/{session_id}/downloads/{filename}",
+  ...options
+});
+var fileUploadDownloadedFile = (options) => (options.client ?? client).post({
+  ...formDataBodySerializer,
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/storage/{session_id}/downloads/{filename}",
+  ...options,
+  headers: {
+    "Content-Type": null,
+    ...options.headers
+  }
+});
+var fileListDownloads = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/storage/{session_id}/downloads",
+  ...options
+});
+var fileUpload = (options) => (options.client ?? client).post({
+  ...formDataBodySerializer,
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/storage/uploads/{filename}",
+  ...options,
+  headers: {
+    "Content-Type": null,
+    ...options.headers
+  }
+});
+var fileListUploads = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/storage/uploads",
+  ...options
+});
+var anythingStart = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/anything/start",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var healthCheck = (options) => (options?.client ?? client).get({ url: "/health", ...options });
+var scrapeWebpage = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/scrape",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+var scrapeFromHtml = (options) => (options.client ?? client).post({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/scrape_from_html",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
+
+// src/utils.ts
+function formatError(error) {
+  if (typeof error === "object" && error !== null) {
+    if ("message" in error && typeof error.message === "string") {
+      return error.message;
+    }
+    try {
+      return JSON.stringify(error, null, 2);
+    } catch {
+      return String(error);
+    }
+  }
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return String(error);
+}
+
+// src/session.ts
+var import_zod = require("zod");
+function processScrapeResponse(scrapeResponse, options) {
+  if (options.only_images && scrapeResponse.images) {
+    return scrapeResponse.images;
+  }
+  if (requiresSchema(options)) {
+    const structured = scrapeResponse.structured;
+    if (!structured) {
+      throw new Error("Failed to scrape structured data. This should not happen. Please report this issue.");
+    }
+    if (options.response_format && typeof options.response_format.parse === "function") {
+      if (structured.data) {
+        try {
+          const validatedData = options.response_format.parse(structured.data);
+          return validatedData;
+        } catch (error) {
+          throw new Error(`Schema validation failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      }
+      return structured;
+    }
+    return structured;
+  }
+  if (options.response_format && typeof options.response_format.parse === "function") {
+    try {
+      const validatedData = options.response_format.parse(scrapeResponse);
+      return validatedData;
+    } catch (error) {
+      throw new Error(`Schema validation failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  return scrapeResponse.markdown;
+}
+function requiresSchema(options) {
+  return !!(options.response_format || options.instructions);
+}
+var Session = class {
+  constructor(client2, options = {}) {
+    this.sessionId = null;
+    this.isActive = false;
+    this.response = null;
+    this.client = client2;
+    this.options = options;
+  }
+  /**
+   * Start the session - creates a new session on the server
+   */
+  async start() {
+    if (this.isActive) {
+      throw new Error("Session is already active");
+    }
+    try {
+      const response = await sessionStart({
+        client: this.client.getClient(),
+        body: this.options
+      });
+      if (response?.error) {
+        throw new Error(`Failed to create session: ${formatError(response.error)}`);
+      }
+      const sessionData = response.data;
+      this.sessionId = sessionData.session_id;
+      this.isActive = true;
+      this.response = sessionData;
+    } catch (error) {
+      throw new Error(`Failed to start session: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  /**
+   * Stop the session - terminates the session on the server
+   */
+  async stop() {
+    if (!this.isActive || !this.sessionId) {
+      return;
+    }
+    const response = await sessionStop({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to stop session: ${formatError(response.error)}`);
+    }
+    this.response = response.data;
+    this.isActive = false;
+    this.sessionId = null;
+  }
+  /**
+   * Get session status
+   */
+  async status() {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const response = await sessionStatus({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to get session status: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Get session ID
+   */
+  getId() {
+    return this.sessionId;
+  }
+  /**
+   * Check if session is active
+   */
+  isSessionActive() {
+    return this.isActive;
+  }
+  /**
+   * Get the last response from session operations
+   */
+  getResponse() {
+    return this.response;
+  }
+  /**
+   * Set cookies for the session
+   */
+  async setCookies(cookies) {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const response = await sessionCookiesSet({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      },
+      body: {
+        cookies
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to set cookies: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Set cookies from a file
+   */
+  async setCookiesFromFile(cookieFile) {
+    const fs = await import("fs/promises");
+    const cookieData = await fs.readFile(cookieFile, "utf-8");
+    const cookies = JSON.parse(cookieData);
+    return this.setCookies(cookies);
+  }
+  /**
+   * Get cookies from the session
+   */
+  async getCookies() {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const response = await sessionCookiesGet({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to get cookies: ${formatError(response.error)}`);
+    }
+    return response.data.cookies;
+  }
+  /**
+   * Execute an action on the page
+   */
+  async execute(action, raiseOnFailure = true) {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const response = await pageExecute({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      },
+      body: action
+    });
+    if (response?.error) {
+      throw new Error(`Failed to execute action: ${formatError(response.error)}`);
+    }
+    const result = response.data;
+    if (raiseOnFailure && !result.success) {
+      throw new Error(`Action execution failed: ${result.message}`);
+    }
+    return result;
+  }
+  /**
+   * Observe the current page state
+   */
+  async observe(perceptionType = "fast") {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const response = await pageObserve({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      },
+      body: {
+        perception_type: perceptionType
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to observe page: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Get session replay data
+   */
+  async replay() {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const response = await sessionReplay({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to get session replay: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  async scrape(options = {}) {
+    if (!this.sessionId) {
+      throw new Error("Session not started");
+    }
+    const apiOptions = { ...options };
+    if (options.response_format && typeof options.response_format.parse === "function") {
+      if (options.json_schema) {
+        apiOptions.response_format = options.json_schema;
+      } else {
+        apiOptions.response_format = import_zod.z.toJSONSchema(options.response_format);
+      }
+      if (!apiOptions.instructions) {
+        const schemaStr = JSON.stringify(apiOptions.response_format);
+        if (schemaStr.includes("plans") || schemaStr.includes("plan")) {
+          apiOptions.instructions = "Extract pricing plans from the page";
+        } else if (schemaStr.includes("products") || schemaStr.includes("product")) {
+          apiOptions.instructions = "Extract product information from the page";
+        } else if (schemaStr.includes("articles") || schemaStr.includes("article")) {
+          apiOptions.instructions = "Extract article information from the page";
+        } else {
+          apiOptions.instructions = "Extract structured data from the page based on the provided schema";
+        }
+      }
+    }
+    const response = await pageScrape({
+      client: this.client.getClient(),
+      path: {
+        session_id: this.sessionId
+      },
+      body: apiOptions
+    });
+    if (response?.error) {
+      throw new Error(`Failed to scrape page: ${JSON.stringify(response.error)}`);
+    }
+    return processScrapeResponse(response.data, options);
+  }
+  /**
+   * Context manager pattern - automatically start and stop session
+   * Usage: await session.use(async (session) => { ... })
+   */
+  async use(callback) {
+    await this.start();
+    try {
+      return await callback(this);
+    } finally {
+      await this.stop();
+    }
+  }
+  /**
+   * Async iterator pattern for session lifecycle management
+   * Usage: for await (const session of sessionInstance) { ... }
+   */
+  async *[Symbol.asyncIterator]() {
+    await this.start();
+    try {
+      yield this;
+    } finally {
+      await this.stop();
+    }
+  }
+};
+
+// src/agent.ts
+var import_ws = __toESM(require("ws"));
+function validatePersonaOption(persona, persona_id) {
+  if (persona) {
+    try {
+      const personaId = persona.personaId;
+      if (!personaId || personaId.length === 0) {
+        throw new Error("Persona ID cannot be empty");
+      }
+      return personaId;
+    } catch (error) {
+      throw new Error(`Invalid persona object: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  } else if (persona_id) {
+    if (persona_id.length === 0) {
+      throw new Error("Persona ID cannot be empty");
+    }
+    return persona_id;
+  }
+  return void 0;
+}
+function validateVaultOption(vault, vault_id) {
+  if (vault) {
+    try {
+      const vaultId = vault.vaultId;
+      if (!vaultId || vaultId.length === 0) {
+        throw new Error("Vault ID cannot be empty");
+      }
+      return vaultId;
+    } catch (error) {
+      throw new Error(`Invalid vault object: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  } else if (vault_id) {
+    if (vault_id.length === 0) {
+      throw new Error("Vault ID cannot be empty");
+    }
+    return vault_id;
+  }
+  return void 0;
+}
+function validateSessionOption(session) {
+  const sessionId = session.getId();
+  if (!sessionId || sessionId.length === 0) {
+    throw new Error("Session ID cannot be empty");
+  }
+  return sessionId;
+}
+function validateAgentIdOption(agent_id) {
+  if (agent_id.length === 0) {
+    throw new Error("Agent ID cannot be empty");
+  }
+}
+var defaultStepLogger = (stepData, stepCounter, agentId) => {
+  console.log(`\u2728 Step ${stepCounter} (agent: ${agentId})`);
+  if (stepData && typeof stepData === "object") {
+    if (stepData.state) {
+      const state = stepData.state;
+      if (state.page_summary) {
+        console.log(`\u{1F4DD} Current page: ${state.page_summary}`);
+      }
+      if (state.previous_goal_eval) {
+        const statusEmoji = state.previous_goal_status === "success" ? "\u2705" : state.previous_goal_status === "failure" ? "\u274C" : "\u2753";
+        console.log(`\u{1F52C} Previous goal: ${statusEmoji} ${state.previous_goal_eval}`);
+      }
+      if (state.memory) {
+        console.log(`\u{1F9E0} Memory: ${state.memory}`);
+      }
+      if (state.next_goal) {
+        console.log(`\u{1F3AF} Next goal: ${state.next_goal}`);
+      }
+      if (state.relevant_interactions && state.relevant_interactions.length > 0) {
+        console.log(`\u{1F194} Relevant ids:`);
+        state.relevant_interactions.forEach((interaction) => {
+          console.log(`   \u25B6 ${interaction.id}: ${interaction.reason}`);
+        });
+      }
+    }
+    if (stepData.action) {
+      const action = stepData.action;
+      let actionStr = `\u26A1 Taking action:
+   \u25B6 ${action.name || action.type || "Unknown action"}`;
+      if (action.id) {
+        actionStr += ` with id ${action.id}`;
+      } else if (action.param && action.param.name && action[action.param.name]) {
+        actionStr += ` with ${action.param.name}=${action[action.param.name]}`;
+      }
+      console.log(actionStr);
+    }
+  } else {
+    console.log(stepData);
+  }
+  console.log("");
+};
+var Agent = class {
+  constructor(client2, options) {
+    this.response = null;
+    this.websocket = null;
+    this.client = client2;
+    if ("agent_id" in options && options.agent_id) {
+      if (options.session) {
+        throw new Error("Either session (for running a new agent) or agent_id (for accessing an existing agent) have to be provided, not both");
+      }
+      validateAgentIdOption(options.agent_id);
+      this.existingAgent = true;
+      this.response = { agent_id: options.agent_id };
+    } else if ("session" in options && options.session) {
+      if (options.agent_id) {
+        throw new Error("Either session (for running a new agent) or agent_id (for accessing an existing agent) have to be provided, not both");
+      }
+      this.existingAgent = false;
+      const { session, vault, persona, ...requestData } = options;
+      const sessionId = validateSessionOption(session);
+      const vaultId = validateVaultOption(vault, options.vault_id);
+      const personaId = validatePersonaOption(persona, options.persona_id);
+      this.request = {
+        session_id: sessionId,
+        vault_id: vaultId,
+        persona_id: personaId,
+        ...requestData
+      };
+    } else {
+      throw new Error("Either session (for running a new agent) or agent_id (for accessing an existing agent) have to be provided");
+    }
+  }
+  /**
+   * Start an agent task (non-blocking) - mirrors Python start method
+   */
+  async start(data) {
+    if (this.existingAgent) {
+      throw new Error("You cannot call start() on an agent instantiated from agent id");
+    }
+    if (!this.request) {
+      throw new Error("Agent not properly initialized with session");
+    }
+    try {
+      const requestBody = {
+        ...this.request,
+        ...data
+      };
+      const response = await agentStart({
+        client: this.client.getClient(),
+        body: requestBody
+      });
+      if (response?.error) {
+        throw new Error(`Failed to start agent: ${formatError(response.error)}`);
+      }
+      this.response = response.data;
+      return this.response;
+    } catch (error) {
+      throw new Error(`Failed to start agent: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  /**
+   * Run agent task (blocking) - mirrors Python run method behavior
+   * This is the main method that mirrors the Python SDK's run method
+   */
+  async run(data) {
+    if (this.existingAgent) {
+      throw new Error("You cannot call run() on an agent instantiated from agent id");
+    }
+    this.response = await this.start(data);
+    console.log(`[Agent] ${this.agentId} started`);
+    return await this.watchLogsAndWait(true, data.updateHandler || null);
+  }
+  /**
+   * Watch logs and wait for completion - mirrors Python watch_logs_and_wait
+   */
+  async watchLogsAndWait(log = true, updateHandler = null) {
+    if (this.existingAgent) {
+      throw new Error("You cannot call watchLogsAndWait() on an agent instantiated from agent id");
+    }
+    if (!this.response) {
+      throw new Error("Agent not started");
+    }
+    try {
+      const result = await this.watchLogs(log, updateHandler);
+      if (result) {
+        return result;
+      }
+      await new Promise((resolve) => setTimeout(resolve, 3e3));
+      return await this.status();
+    } catch (error) {
+      console.error(`[Agent] ${this.agentId} failed to complete in time. Try running agent.status() after a few seconds.`);
+      return await this.status();
+    }
+  }
+  /**
+   * Watch logs via WebSocket - mirrors Python watch_logs method
+   */
+  async watchLogs(log = true, updateHandler = null) {
+    if (this.existingAgent) {
+      throw new Error("You cannot call watchLogs() on an agent instantiated from agent id");
+    }
+    if (!this.response) {
+      throw new Error("Agent not started");
+    }
+    const config = this.client.getConfig();
+    const token = config.apiKey;
+    const agentId = this.response.agent_id;
+    const sessionId = this.response.session_id;
+    const wsUrl = config.baseUrl?.replace("https://", "wss://").replace("http://", "ws://") + `/agents/${agentId}/debug/logs?token=${token}&session_id=${sessionId}`;
+    return new Promise((resolve, reject) => {
+      this.websocket = new import_ws.default(wsUrl);
+      let counter = 0;
+      this.websocket.on("open", () => {
+      });
+      this.websocket.on("error", (error) => {
+        console.error(`Connection error: ${agentId} ${error.message}`);
+        resolve(null);
+      });
+      this.websocket.on("message", (data) => {
+        try {
+          const message = data.toString();
+          let parsed;
+          try {
+            parsed = JSON.parse(message);
+          } catch {
+            return;
+          }
+          if (parsed.agent_id === agentId && parsed.task !== void 0 && parsed.status !== void 0) {
+            const response = parsed;
+            if (updateHandler) {
+              updateHandler({
+                type: "completion",
+                data: response,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString()
+              });
+            } else if (!response.success) {
+              console.error(response.answer);
+            }
+            this.disconnectWebSocket();
+            resolve(response);
+            return;
+          }
+          if (log) {
+            counter++;
+            if (updateHandler) {
+              updateHandler({
+                type: "step",
+                data: parsed,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString()
+              });
+            } else {
+              defaultStepLogger(parsed, counter, agentId);
+            }
+          }
+        } catch (error) {
+          console.error(`Error processing WebSocket message: ${error}`);
+        }
+      });
+      this.websocket.on("close", () => {
+        this.websocket = null;
+        resolve(null);
+      });
+      setTimeout(() => {
+        if (this.websocket && this.websocket.readyState === import_ws.default.OPEN) {
+          this.disconnectWebSocket();
+          resolve(null);
+        }
+      }, 3e5);
+    });
+  }
+  /**
+   * Get agent status - mirrors Python status method
+   */
+  async status() {
+    if (!this.response) {
+      throw new Error("Agent not started or not accessible");
+    }
+    const response = await agentStatus({
+      client: this.client.getClient(),
+      path: {
+        agent_id: this.response.agent_id
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to get agent status: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Stop the agent - mirrors Python stop method
+   */
+  async stop() {
+    if (this.existingAgent) {
+      throw new Error("You cannot call stop() on an agent instantiated from agent id");
+    }
+    if (!this.response) {
+      throw new Error("Agent not started");
+    }
+    try {
+      console.log(`[Agent] ${this.response.agent_id} is stopping`);
+      const response = await agentStop({
+        client: this.client.getClient(),
+        path: {
+          agent_id: this.response.agent_id
+        },
+        query: { session_id: this.response.session_id }
+      });
+      if (response?.error) {
+        throw new Error(`Failed to stop agent: ${formatError(response.error)}`);
+      }
+      console.log(`[Agent] ${this.response.agent_id} stopped`);
+      return response.data;
+    } catch (error) {
+      console.warn(`Failed to stop agent: ${error instanceof Error ? error.message : String(error)}`);
+      throw error;
+    } finally {
+      this.disconnectWebSocket();
+    }
+  }
+  /**
+   * Disconnect WebSocket
+   */
+  disconnectWebSocket() {
+    if (this.websocket) {
+      this.websocket.close();
+      this.websocket = null;
+    }
+  }
+  /**
+   * Get agent ID - mirrors Python agent_id property
+   */
+  get agentId() {
+    if (!this.response) {
+      throw new Error("You need to run the agent first to get the agent id");
+    }
+    return this.response.agent_id;
+  }
+  /**
+   * Get session ID - mirrors Python session_id property
+   */
+  get sessionId() {
+    if (!this.response) {
+      throw new Error("You need to run the agent first to get the session id");
+    }
+    return this.response.session_id;
+  }
+  /**
+   * Check if agent is running - convenience method
+   */
+  isRunning() {
+    return this.response !== null;
+  }
+};
+
+// src/vaults.ts
+var NotteVault = class {
+  constructor(client2, options = {}) {
+    this._vaultId = null;
+    this.initPromise = null;
+    this.client = client2;
+    if (options && "vault_id" in options && options.vault_id) {
+      this.initPromise = this.initExistingVault(options.vault_id);
+    } else {
+      this.initPromise = this.initNewVault(options || {});
+    }
+  }
+  async initExistingVault(vaultId) {
+    await this.verifyVaultExists(vaultId);
+    this._vaultId = vaultId;
+    return this._vaultId;
+  }
+  async initNewVault(createData) {
+    const response = await vaultCreate({
+      client: this.client.getClient(),
+      body: createData
+    });
+    if (response?.error) {
+      throw new Error(`Failed to create vault: ${formatError(response.error)}`);
+    }
+    const vault = response.data;
+    console.warn(`[Vault] ${vault.vault_id} created since no vault id was provided. Please store this to retrieve it later.`);
+    this._vaultId = vault.vault_id;
+    return this._vaultId;
+  }
+  async verifyVaultExists(vaultId) {
+    if (vaultId.length === 0) {
+      throw new Error("Vault ID cannot be empty");
+    }
+    const response = await vaultCredentialsList({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to verify vault exists: ${formatError(response.error)}`);
+    }
+  }
+  async ensureInitialized() {
+    if (this._vaultId) {
+      return this._vaultId;
+    }
+    if (this.initPromise) {
+      return await this.initPromise;
+    }
+    throw new Error("Vault not initialized");
+  }
+  get vaultId() {
+    if (!this._vaultId) {
+      throw new Error("Vault not initialized. Use await on vault operations first.");
+    }
+    return this._vaultId;
+  }
+  /**
+   * Start the vault - no-op for compatibility with Python interface
+   */
+  start() {
+  }
+  /**
+   * Stop the vault - deletes it and all credentials
+   */
+  async stop() {
+    const vaultId = await this.ensureInitialized();
+    console.log(`[Vault] ${vaultId} deleted. All credentials have been deleted.`);
+    await this.delete();
+  }
+  /**
+   * Add or update credentials for a URL
+   */
+  async addCredentials(url, credentials) {
+    if (credentials.mfa_secret) {
+      this.validateMfaSecret(credentials.mfa_secret);
+    }
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultCredentialsAdd({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      },
+      body: { url, credentials }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to add credentials: ${formatError(response.error)}`);
+    }
+  }
+  /**
+   * Get credentials for a URL
+   */
+  async getCredentials(url) {
+    try {
+      const vaultId = await this.ensureInitialized();
+      const response = await vaultCredentialsGet({
+        client: this.client.getClient(),
+        path: {
+          vault_id: vaultId
+        },
+        query: { url }
+      });
+      if (response?.error) {
+        return null;
+      }
+      const credentialsResponse = response.data;
+      return credentialsResponse.credentials;
+    } catch (error) {
+      return null;
+    }
+  }
+  /**
+   * Delete credentials for a URL
+   */
+  async deleteCredentials(url) {
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultCredentialsDelete({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      },
+      query: { url }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to delete credentials: ${formatError(response.error)}`);
+    }
+  }
+  /**
+   * Set credit card information
+   */
+  async setCreditCard(creditCard) {
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultCreditCardSet({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      },
+      body: { credit_card: creditCard }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to set credit card: ${formatError(response.error)}`);
+    }
+  }
+  /**
+   * Get credit card information
+   */
+  async getCreditCard() {
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultCreditCardGet({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to get credit card: ${formatError(response.error)}`);
+    }
+    const creditCardResponse = response.data;
+    return creditCardResponse.credit_card;
+  }
+  /**
+   * List all credentials in the vault
+   */
+  async listCredentials() {
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultCredentialsList({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to list credentials: ${formatError(response.error)}`);
+    }
+    const credentialsResponse = response.data;
+    return credentialsResponse.credentials;
+  }
+  /**
+   * Delete credit card information
+   */
+  async deleteCreditCard() {
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultCreditCardDelete({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to delete credit card: ${formatError(response.error)}`);
+    }
+  }
+  /**
+   * Delete the entire vault
+   */
+  async delete() {
+    const vaultId = await this.ensureInitialized();
+    const response = await vaultDelete({
+      client: this.client.getClient(),
+      path: {
+        vault_id: vaultId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to delete vault: ${formatError(response.error)}`);
+    }
+  }
+  /**
+   * Add credentials from environment variables
+   * Mirrors Python's add_credentials_from_env method
+   */
+  async addCredentialsFromEnv(url) {
+    const domain = this.extractDomainFromUrl(url);
+    const envPrefix = domain.replace(/[^a-zA-Z0-9]/g, "_").toUpperCase();
+    const email = process.env[`${envPrefix}_EMAIL`] || process.env[`${envPrefix}_USERNAME`];
+    const password = process.env[`${envPrefix}_PASSWORD`];
+    if (!email || !password) {
+      throw new Error(`Environment variables ${envPrefix}_EMAIL/USERNAME and ${envPrefix}_PASSWORD are required`);
+    }
+    const credentials = { email, password };
+    const mfaSecret = process.env[`${envPrefix}_MFA_SECRET`];
+    if (mfaSecret) {
+      this.validateMfaSecret(mfaSecret);
+      credentials.mfa_secret = mfaSecret;
+    }
+    await this.addCredentials(url, credentials);
+  }
+  /**
+   * Extract domain from URL for environment variable naming
+   */
+  extractDomainFromUrl(url) {
+    try {
+      const urlObj = new URL(url);
+      return urlObj.hostname.replace(/^www\./, "");
+    } catch {
+      const match = url.match(/(?:https?:\/\/)?(?:www\.)?([^\/]+)/);
+      return match ? match[1] : url;
+    }
+  }
+  /**
+   * Validate MFA secret format
+   * Mirrors Python's MFA secret validation
+   */
+  validateMfaSecret(mfaSecret) {
+    if (/^\d+$/.test(mfaSecret)) {
+      throw new Error("MFA secret cannot be all numbers. Please provide a valid base32 secret.");
+    }
+    if (mfaSecret.length < 16) {
+      throw new Error("MFA secret must be at least 16 characters long");
+    }
+  }
+  /**
+   * Generate a secure random password
+   * Mirrors Python's generate_password method
+   */
+  generatePassword(length = 20, includeSpecialChars = true) {
+    const minRequiredLength = includeSpecialChars ? 4 : 3;
+    if (length < minRequiredLength) {
+      throw new Error(`Password length must be at least ${minRequiredLength} characters`);
+    }
+    const lowercase = "abcdefghijklmnopqrstuvwxyz";
+    const uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+    const digits = "0123456789";
+    const specialChars = "!@#$%^&*()_+-=[]|;:,.<>?";
+    const crypto = globalThis.crypto || require("crypto");
+    const array = new Uint8Array(length);
+    crypto.getRandomValues(array);
+    const allowedChars = includeSpecialChars ? "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_" : "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+    let password = Array.from(array, (byte) => allowedChars[byte % allowedChars.length]).join("").slice(0, length);
+    const passwordArray = password.split("");
+    if (!includeSpecialChars) {
+      for (let i = 0; i < passwordArray.length; i++) {
+        if (specialChars.includes(passwordArray[i])) {
+          const alphanumeric = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+          passwordArray[i] = alphanumeric[Math.floor(Math.random() * alphanumeric.length)];
+        }
+      }
+    }
+    let maxIterations = 10;
+    while (maxIterations-- > 0) {
+      let allRequirementsMet = true;
+      if (!passwordArray.some((c) => lowercase.includes(c))) {
+        const index = Math.floor(Math.random() * passwordArray.length);
+        passwordArray[index] = lowercase[Math.floor(Math.random() * lowercase.length)];
+        allRequirementsMet = false;
+      }
+      if (!passwordArray.some((c) => uppercase.includes(c))) {
+        const index = Math.floor(Math.random() * passwordArray.length);
+        passwordArray[index] = uppercase[Math.floor(Math.random() * uppercase.length)];
+        allRequirementsMet = false;
+      }
+      if (!passwordArray.some((c) => digits.includes(c))) {
+        const index = Math.floor(Math.random() * passwordArray.length);
+        passwordArray[index] = digits[Math.floor(Math.random() * digits.length)];
+        allRequirementsMet = false;
+      }
+      if (includeSpecialChars && !passwordArray.some((c) => specialChars.includes(c))) {
+        const index = Math.floor(Math.random() * passwordArray.length);
+        passwordArray[index] = specialChars[Math.floor(Math.random() * specialChars.length)];
+        allRequirementsMet = false;
+      }
+      if (allRequirementsMet) {
+        break;
+      }
+    }
+    return passwordArray.join("");
+  }
+};
+
+// src/personas.ts
+var NottePersona = class {
+  constructor(client2, options = {}) {
+    this.response = null;
+    this.initPromise = null;
+    this.client = client2;
+    if (options && "persona_id" in options && options.persona_id) {
+      this.initPromise = this.initExistingPersona(options.persona_id);
+      this._initRequest = {};
+    } else {
+      const createData = options || {};
+      this._initRequest = createData;
+      this.initPromise = this.initNewPersona(createData);
+    }
+  }
+  /**
+   * Get persona info
+   */
+  get info() {
+    if (this.response === null) {
+      throw new Error("Persona not initialized");
+    }
+    return this.response;
+  }
+  /**
+   * Get vault (cached property equivalent)
+   */
+  get vault() {
+    if (this._vault === void 0) {
+      const vault = this._getVault();
+      if (vault === null) {
+        throw new Error(
+          "Persona has no vault. Please create a new persona using `create_vault=true` to use this feature."
+        );
+      }
+      this._vault = vault;
+    }
+    return this._vault;
+  }
+  /**
+   * Check if persona has a vault
+   */
+  get hasVault() {
+    return this.info.vault_id !== null;
+  }
+  async initExistingPersona(personaId) {
+    const response = await personaGet({
+      client: this.client.getClient(),
+      path: {
+        persona_id: personaId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to get persona: ${formatError(response.error)}`);
+    }
+    this.response = response.data;
+    return this.response;
+  }
+  async initNewPersona(createData) {
+    const response = await personaCreate({
+      client: this.client.getClient(),
+      body: createData
+    });
+    if (response?.error) {
+      throw new Error(`Failed to create persona: ${formatError(response.error)}`);
+    }
+    this.response = response.data;
+    console.warn(
+      `[Persona] ${this.response.persona_id} created since no persona id was provided. Please store this to retrieve it later.`
+    );
+    return this.response;
+  }
+  async ensureInitialized() {
+    if (this.response) {
+      return this.response;
+    }
+    if (this.initPromise) {
+      return await this.initPromise;
+    }
+    throw new Error("Persona not initialized");
+  }
+  /**
+   * Get persona ID
+   */
+  get personaId() {
+    if (!this.response) {
+      throw new Error("Persona not initialized. Use await on persona operations first.");
+    }
+    return this.response.persona_id;
+  }
+  /**
+   * Start the persona - ensures initialization
+   */
+  async start() {
+    if (this.response === null) {
+      await this.create();
+    }
+  }
+  /**
+   * Stop the persona - deletes it
+   */
+  async stop() {
+    await this.ensureInitialized();
+    console.log(`[Persona] ${this.personaId} deleted.`);
+    await this.delete();
+  }
+  /**
+   * Get vault - private helper method
+   */
+  _getVault() {
+    if (this.info.vault_id === null) {
+      return null;
+    }
+    return new NotteVault(this.client, { vault_id: this.info.vault_id });
+  }
+  /**
+   * Create the persona
+   */
+  async create() {
+    if (this.response !== null) {
+      throw new Error(`Persona ${this.personaId} already initialized`);
+    }
+    const response = await personaCreate({
+      client: this.client.getClient(),
+      body: this._initRequest
+    });
+    if (response?.error) {
+      throw new Error(`Failed to create persona: ${formatError(response.error)}`);
+    }
+    this.response = response.data;
+  }
+  /**
+   * Delete the persona from the notte console
+   */
+  async delete() {
+    await this.ensureInitialized();
+    const response = await personaDelete({
+      client: this.client.getClient(),
+      path: {
+        persona_id: this.personaId
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to delete persona: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Add credentials to the persona (generates a password and stores it in the vault)
+   */
+  async addCredentials(url) {
+    const vault = this._getVault();
+    if (vault === null) {
+      throw new Error(
+        "Cannot add credentials to a persona without a vault. Please create a new persona using `create_vault=true` to use this feature."
+      );
+    }
+    const password = vault.generatePassword();
+    await vault.addCredentials(url, {
+      email: this.info.email,
+      password
+    });
+  }
+  /**
+   * Read recent emails sent to the persona
+   */
+  async emails(options) {
+    await this.ensureInitialized();
+    const response = await personaEmailsList({
+      client: this.client.getClient(),
+      path: {
+        persona_id: this.personaId
+      },
+      query: options || {}
+    });
+    if (response?.error) {
+      throw new Error(`Failed to list emails: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Read recent SMS messages sent to the persona
+   */
+  async sms(options) {
+    await this.ensureInitialized();
+    const response = await personaSmsList({
+      client: this.client.getClient(),
+      path: {
+        persona_id: this.personaId
+      },
+      query: options || {}
+    });
+    if (response?.error) {
+      throw new Error(`Failed to list SMS messages: ${formatError(response.error)}`);
+    }
+    return response.data;
+  }
+  /**
+   * Get persona information (alias for ensureInitialized)
+   */
+  async get() {
+    await this.ensureInitialized();
+    return this.response;
+  }
+  /**
+   * Context manager for automatic cleanup
+   */
+  async use(callback) {
+    try {
+      return await callback(this);
+    } finally {
+      if (this._initRequest && !("persona_id" in this._initRequest)) {
+        try {
+          await this.delete();
+        } catch (error) {
+          console.warn(`Failed to delete persona during cleanup: ${error}`);
+        }
+      }
+    }
+  }
+};
+
+// src/version.ts
+var SDK_VERSION = true ? "0.0.1" : "dev";
+
+// src/functions.ts
+var NotteFunction = class {
+  constructor(client2, options) {
+    this.client = client2;
+    this.functionId = options.function_id;
+    this.decryptionKey = options.decryption_key;
+  }
+  /**
+   * Get metadata for a specific function run
+   */
+  async retrieve(functionRunId) {
+    try {
+      const response = await functionRunGetMetadata({
+        client: this.client.getClient(),
+        path: {
+          function_id: this.functionId,
+          run_id: functionRunId
+        }
+      });
+      if (response?.error) {
+        throw new Error(`Failed to get function run metadata: ${formatError(response.error)}`);
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof Error && error.message.startsWith("Failed to get function run metadata:")) {
+        throw error;
+      }
+      throw new Error(`Failed to get function run metadata: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  /**
+   * Start a function run
+   */
+  async run(variables = {}) {
+    const apiKey = this.client.getConfig().apiKey || "";
+    if (!apiKey) {
+      throw new Error("API key is required. Provide it via config.apiKey or set the NOTTE_API_KEY environment variable.");
+    }
+    try {
+      const response = await functionRunStart({
+        client: this.client.getClient(),
+        path: {
+          function_id: this.functionId
+        },
+        headers: {
+          "x-notte-api-key": apiKey,
+          "x-notte-request-origin": "sdk-node",
+          "x-notte-sdk-version": SDK_VERSION
+        },
+        body: {
+          workflow_id: this.functionId,
+          variables,
+          stream: false
+        }
+      });
+      if (response?.error) {
+        throw new Error(`Failed to start function run: ${formatError(response.error)}`);
+      }
+      return response.data;
+    } catch (error) {
+      if (error instanceof Error && error.message.startsWith("Failed to start function run:")) {
+        throw error;
+      }
+      throw new Error(`Failed to run function: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  /**
+   * Get the function ID
+   */
+  getFunctionId() {
+    return this.functionId;
+  }
+};
+
+// src/client.ts
+var import_zod2 = require("zod");
+var NotteClient = class {
+  constructor(config = {}) {
+    const apiKey = config.apiKey || process.env.NOTTE_API_KEY;
+    const isProxyMode = config.baseUrl && !config.baseUrl.startsWith("https://");
+    if (!apiKey && !isProxyMode) {
+      throw new Error("API key is required. Provide it via config.apiKey or set the NOTTE_API_KEY environment variable.");
+    }
+    this.config = {
+      baseUrl: config.baseUrl || "https://api.notte.cc",
+      apiKey,
+      ...config
+    };
+    client.setConfig({
+      baseUrl: this.config.baseUrl
+    });
+    client.interceptors.request.use((request) => {
+      request.headers.set("Authorization", `Bearer ${this.config.apiKey}`);
+      request.headers.set("x-notte-request-origin", "sdk-node");
+      request.headers.set("x-notte-sdk-version", SDK_VERSION);
+      return request;
+    });
+  }
+  /**
+   * Create a new session
+   */
+  Session(options = {}) {
+    return new Session(this, options);
+  }
+  /**
+   * Create a new agent
+   */
+  Agent(options) {
+    return new Agent(this, options);
+  }
+  /**
+   * Create or access a vault
+   */
+  Vault(options) {
+    return new NotteVault(this, options);
+  }
+  /**
+   * Create or access a persona
+   */
+  Persona(options) {
+    return new NottePersona(this, options);
+  }
+  /**
+   * Create or access a function
+   */
+  NotteFunction(options) {
+    return new NotteFunction(this, options);
+  }
+  /**
+   * Personas client for listing and managing personas
+   */
+  get personas() {
+    return {
+      list: async (options) => {
+        const response = await listPersonas({
+          client: this.getClient(),
+          query: options || {}
+        });
+        if (response?.error) {
+          throw new Error(`Failed to list personas: ${JSON.stringify(response.error)}`);
+        }
+        return response.data?.items || [];
+      }
+    };
+  }
+  /**
+   * Get the configured client instance
+   */
+  getClient() {
+    return client;
+  }
+  async scrape(url, options = {}) {
+    const apiOptions = { ...options };
+    if (options.response_format && typeof options.response_format.parse === "function") {
+      if (options.json_schema) {
+        apiOptions.response_format = options.json_schema;
+      } else {
+        apiOptions.response_format = import_zod2.z.toJSONSchema(options.response_format);
+      }
+      if (!apiOptions.instructions) {
+        const schemaStr = JSON.stringify(apiOptions.response_format);
+        if (schemaStr.includes("plans") || schemaStr.includes("plan")) {
+          apiOptions.instructions = "Extract pricing plans from the page";
+        } else if (schemaStr.includes("products") || schemaStr.includes("product")) {
+          apiOptions.instructions = "Extract product information from the page";
+        } else if (schemaStr.includes("articles") || schemaStr.includes("article")) {
+          apiOptions.instructions = "Extract article information from the page";
+        } else {
+          apiOptions.instructions = "Extract structured data from the page based on the provided schema";
+        }
+      }
+    }
+    const response = await scrapeWebpage({
+      client: this.getClient(),
+      body: {
+        url,
+        ...apiOptions
+      }
+    });
+    if (response?.error) {
+      throw new Error(`Failed to scrape webpage: ${JSON.stringify(response.error)}`);
+    }
+    const scrapeResponse = response.data;
+    return processScrapeResponse(scrapeResponse, options);
+  }
+  /**
+   * Get the client configuration
+   */
+  getConfig() {
+    return this.config;
+  }
+};
+
+// src/proxy/types.ts
+var NotteProxyAuthError = class extends Error {
+  constructor(message = "Unauthorized") {
+    super(message);
+    this.name = "NotteProxyAuthError";
+  }
+};
+
+// src/index.ts
+var createClient2 = (config) => {
+  if (config?.baseUrl) {
+    client.setConfig({ baseUrl: config.baseUrl });
+  }
+  if (config?.token) {
+    client.interceptors.request.use((request) => {
+      request.headers.set("Authorization", `Bearer ${config.token}`);
+      return request;
+    });
+  }
+  return client;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Agent,
+  NotteClient,
+  NotteFunction,
+  NottePersona,
+  NotteProxyAuthError,
+  NotteVault,
+  Session,
+  agentStart,
+  agentStatus,
+  agentStop,
+  anythingStart,
+  client,
+  createClient,
+  fileDownload,
+  fileListDownloads,
+  fileListUploads,
+  fileUpload,
+  fileUploadDownloadedFile,
+  functionCreate,
+  functionDelete,
+  functionDownloadUrl,
+  functionFork,
+  functionRunGetMetadata,
+  functionRunStart,
+  functionRunStop,
+  functionRunUpdateMetadata,
+  functionScheduleDelete,
+  functionScheduleSet,
+  functionUpdate,
+  getScript,
+  getSessionScript,
+  getUsage,
+  getUsageLogs,
+  healthCheck,
+  improvePrompt,
+  listAgents,
+  listFunctionRunsByFunctionId,
+  listFunctions,
+  listPersonas,
+  listSessions,
+  listVaults,
+  nudgePrompt,
+  pageExecute,
+  pageObserve,
+  pageScrape,
+  pageScreenshot,
+  personaCreate,
+  personaDelete,
+  personaEmailsList,
+  personaGet,
+  personaSmsList,
+  profileCreate,
+  profileDelete,
+  profileGet,
+  profileList,
+  scrapeFromHtml,
+  scrapeWebpage,
+  sessionCookiesGet,
+  sessionCookiesSet,
+  sessionDebugInfo,
+  sessionNetworkLogs,
+  sessionOffset,
+  sessionReplay,
+  sessionStart,
+  sessionStatus,
+  sessionStop,
+  vaultCreate,
+  vaultCredentialsAdd,
+  vaultCredentialsDelete,
+  vaultCredentialsGet,
+  vaultCredentialsList,
+  vaultCreditCardDelete,
+  vaultCreditCardGet,
+  vaultCreditCardSet,
+  vaultDelete,
+  vaultUpdate
+});
+//# sourceMappingURL=index.js.map