@intuned/runtime-dev 1.3.18-interface.8 → 1.3.19-new-cli.0

package/dist/commands/ts-check.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/commands/ts-check.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+"use strict";
+
+var ts = _interopRequireWildcard(require("typescript"));
+var _commander = require("commander");
+var fs = _interopRequireWildcard(require("fs-extra"));
+var path = _interopRequireWildcard(require("path"));
+var _template = require("./common/utils/template");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+_commander.program.description("Check TypeScript types in the project").option("-t, --template <type>", "template to use", "InterfaceTemplate").allowUnknownOption().action(async ({
+  template
+}) => {
+  await (0, _template.moveTemplateFiles)(template);
+  const templateTsConfig = path.resolve(__dirname, "..", "..", "template.tsconfig.json");
+  await fs.copy(templateTsConfig, `./intuned/${template}/tsconfig.json`);
+  checkTypes(template);
+});
+function checkTypes(template) {
+  const configPath = ts.findConfigFile(`./intuned/${template}`, ts.sys.fileExists, "tsconfig.json");
+  if (!configPath) {
+    console.error("Could not find a valid 'tsconfig.json'.");
+    process.exit(1);
+  }
+  const readConfigResult = ts.readConfigFile(configPath, ts.sys.readFile);
+  const config = readConfigResult.config;
+  const parseConfigHost = {
+    useCaseSensitiveFileNames: ts.sys.useCaseSensitiveFileNames,
+    readDirectory: ts.sys.readDirectory,
+    fileExists: ts.sys.fileExists,
+    readFile: ts.sys.readFile
+  };
+  const parsed = ts.parseJsonConfigFileContent(config, parseConfigHost, "./intuned");
+  const program = ts.createProgram(parsed.fileNames, parsed.options);
+  const emitResult = program.emit();
+  const allDiagnostics = ts.getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
+  allDiagnostics.forEach(diagnostic => {
+    if (diagnostic.file) {
+      const {
+        line,
+        character
+      } = ts.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start);
+      const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n");
+      console.log(`${diagnostic.file.fileName} (${line + 1},${character + 1}): ${message}`);
+    } else {
+      console.log(ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n"));
+    }
+  });
+  if (allDiagnostics.length === 0) {
+    console.log("✨ TypeScript type checking passed without errors.");
+  } else {
+    console.error("Errors found during TypeScript type checking.");
+    process.exit(1);
+  }
+}
+_commander.program.parse(process.argv);

package/dist/common/Logger/Logger/index.d.ts

@@ -0,0 +1,12 @@
+import { LogEntry, LogMetadata } from "./types";
+declare class Logger {
+    logFunction(entry: LogEntry): void;
+    private log;
+    trace(message: string, meta?: LogMetadata): void;
+    debug(message: string, meta?: LogMetadata): void;
+    info(message: string, meta?: LogMetadata): void;
+    warn(message: string, meta?: LogMetadata): void;
+    error(message: string, meta?: LogMetadata): void;
+}
+export declare const logger: Logger;
+export {};

package/dist/common/Logger/Logger/index.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.logger = void 0;
+var _nodeUtil = require("node:util");
+var _chalk = _interopRequireDefault(require("chalk"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const format = _nodeUtil.formatWithOptions.bind(undefined, {
+  colors: true
+});
+const LOG_LEVEL_COLORS = {
+  TRACE: _chalk.default.gray,
+  DEBUG: _chalk.default.blue,
+  INFO: _chalk.default.green,
+  WARN: _chalk.default.yellow,
+  ERROR: _chalk.default.red
+};
+class Logger {
+  logFunction(entry) {
+    const {
+      level,
+      timestamp,
+      message,
+      meta
+    } = entry;
+    const date = new Date(timestamp);
+    const levelColor = LOG_LEVEL_COLORS[level];
+    if (meta === undefined) {
+      process.stderr.write(`${format(date)} [@intuned/sdk][${levelColor(level)}] ${message}\n`);
+    } else {
+      process.stderr.write(`${format(date)} [@intuned/sdk][${levelColor(level)}] ${message} ${format(meta)}\n`);
+    }
+  }
+  log(level, message, meta) {
+    this.logFunction({
+      level,
+      message,
+      meta: meta && Object.keys(meta).length === 0 ? undefined : meta,
+      timestamp: Date.now()
+    });
+  }
+  trace(message, meta) {
+    this.log("TRACE", message, meta);
+  }
+  debug(message, meta) {
+    this.log("DEBUG", message, meta);
+  }
+  info(message, meta) {
+    this.log("INFO", message, meta);
+  }
+  warn(message, meta) {
+    this.log("WARN", message, meta);
+  }
+  error(message, meta) {
+    this.log("ERROR", message, meta);
+  }
+}
+const logger = exports.logger = new Logger();

package/dist/common/Logger/Logger/types.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
+export type LogMetadata = Record<string | symbol, any>;
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: number;
+    meta?: LogMetadata;
+}

package/dist/common/Logger/Logger/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/common/Logger/index.d.ts

@@ -0,0 +1,12 @@
+import { LogEntry, LogMetadata } from "./types";
+declare class Logger {
+    logFunction(entry: LogEntry): void;
+    private log;
+    trace(message: string, meta?: LogMetadata): void;
+    debug(message: string, meta?: LogMetadata): void;
+    info(message: string, meta?: LogMetadata): void;
+    warn(message: string, meta?: LogMetadata): void;
+    error(message: string, meta?: LogMetadata): void;
+}
+export declare const logger: Logger;
+export {};

package/dist/common/Logger/index.js

@@ -0,0 +1,60 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.logger = void 0;
+var _nodeUtil = require("node:util");
+var _chalk = _interopRequireDefault(require("chalk"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const format = _nodeUtil.formatWithOptions.bind(undefined, {
+  colors: true
+});
+const LOG_LEVEL_COLORS = {
+  TRACE: _chalk.default.gray,
+  DEBUG: _chalk.default.blue,
+  INFO: _chalk.default.green,
+  WARN: _chalk.default.yellow,
+  ERROR: _chalk.default.red
+};
+class Logger {
+  logFunction(entry) {
+    const {
+      level,
+      timestamp,
+      message,
+      meta
+    } = entry;
+    const date = new Date(timestamp);
+    const levelColor = LOG_LEVEL_COLORS[level];
+    if (meta === undefined) {
+      process.stderr.write(`${format(date)} [@intuned/sdk][${levelColor(level)}] ${message}\n`);
+    } else {
+      process.stderr.write(`${format(date)} [@intuned/sdk][${levelColor(level)}] ${message} ${format(meta)}\n`);
+    }
+  }
+  log(level, message, meta) {
+    this.logFunction({
+      level,
+      message,
+      meta: meta && Object.keys(meta).length === 0 ? undefined : meta,
+      timestamp: Date.now()
+    });
+  }
+  trace(message, meta) {
+    this.log("TRACE", message, meta);
+  }
+  debug(message, meta) {
+    this.log("DEBUG", message, meta);
+  }
+  info(message, meta) {
+    this.log("INFO", message, meta);
+  }
+  warn(message, meta) {
+    this.log("WARN", message, meta);
+  }
+  error(message, meta) {
+    this.log("ERROR", message, meta);
+  }
+}
+const logger = exports.logger = new Logger();

package/dist/common/Logger/types.d.ts

@@ -0,0 +1,8 @@
+export type LogLevel = "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
+export type LogMetadata = Record<string | symbol, any>;
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    timestamp: number;
+    meta?: LogMetadata;
+}

package/dist/common/Logger/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/dist/common/asyncLocalStorage/index.d.ts

@@ -1,17 +1,16 @@
-import { AsyncLocalStorage } from 'node:async_hooks';
-import { R as RunInfo, P as Payload } from '../../export.d-BAUMB-lG.js';
-
-declare const asyncLocalStorage: AsyncLocalStorage<InternalRunInfo>;
-declare function runWithContext<R, TArgs extends any[]>(contextData: InternalRunInfo, callback: (...args: TArgs) => R, ...args: TArgs): R;
+/// <reference types="node" />
+import { AsyncLocalStorage } from "node:async_hooks";
+import { Payload, RunInfo } from "../../runtime/export";
+export declare const asyncLocalStorage: AsyncLocalStorage<InternalRunInfo>;
+export declare function runWithContext<R, TArgs extends any[]>(contextData: InternalRunInfo, callback: (...args: TArgs) => R, ...args: TArgs): R;
 interface TimeoutInfo {
     extendTimeoutCallback?: () => Promise<void>;
 }
-interface InternalRunInfo extends RunInfo {
+export interface InternalRunInfo extends RunInfo {
     extendedPayloads: Payload[];
     timeoutInfo?: TimeoutInfo;
     store?: Record<string, any>;
     getAuthSessionParameters?: () => Promise<any>;
 }
-declare function getExecutionContext(): InternalRunInfo | undefined;
-
-export { type InternalRunInfo, asyncLocalStorage, getExecutionContext, runWithContext };
+export declare function getExecutionContext(): InternalRunInfo | undefined;
+export {};

package/dist/common/asyncLocalStorage/index.js

@@ -1,42 +1,17 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/common/asyncLocalStorage/index.ts
-var asyncLocalStorage_exports = {};
-__export(asyncLocalStorage_exports, {
-  asyncLocalStorage: () => asyncLocalStorage,
-  getExecutionContext: () => getExecutionContext,
-  runWithContext: () => runWithContext
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
-module.exports = __toCommonJS(asyncLocalStorage_exports);
-var import_node_async_hooks = require("async_hooks");
-var asyncLocalStorage = new import_node_async_hooks.AsyncLocalStorage();
+exports.asyncLocalStorage = void 0;
+exports.getExecutionContext = getExecutionContext;
+exports.runWithContext = runWithContext;
+var _nodeAsync_hooks = require("node:async_hooks");
+const asyncLocalStorage = exports.asyncLocalStorage = new _nodeAsync_hooks.AsyncLocalStorage();
 function runWithContext(contextData, callback, ...args) {
   return asyncLocalStorage.run(contextData, callback, ...args);
 }
 function getExecutionContext() {
   const contextData = asyncLocalStorage.getStore();
   return contextData;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  asyncLocalStorage,
-  getExecutionContext,
-  runWithContext
-});
-//# sourceMappingURL=index.js.map
+}

package/dist/common/backendFunctions/getAuthSessionParameters.d.ts

@@ -0,0 +1 @@
+export declare function getAuthSessionParameters(): Promise<any>;

package/dist/common/backendFunctions/getAuthSessionParameters.js

@@ -0,0 +1,38 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAuthSessionParameters = getAuthSessionParameters;
+var _isNil = _interopRequireDefault(require("lodash/isNil"));
+var _asyncLocalStorage = require("../asyncLocalStorage");
+var _zod = require("zod");
+var _jwtTokenManager = require("../jwtTokenManager");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const authSessionParametersResponseSchema = _zod.z.object({
+  parameters: _zod.z.any().refine(v => v !== undefined)
+});
+async function getAuthSessionParameters() {
+  const context = (0, _asyncLocalStorage.getExecutionContext)();
+  if (!context) {
+    throw new Error("getAuthSessionParameters failed due to an internal error (context was not found).");
+  }
+  const authSessionId = context.authSessionId;
+  if ((0, _isNil.default)(authSessionId)) {
+    throw new Error("AuthSessions are not enabled");
+  }
+  const response = await (0, _jwtTokenManager.callBackendFunctionWithToken)(`auth-session/${authSessionId}/parameters`, {
+    method: "GET"
+  });
+  const body = await response.text();
+  if (!response.ok) {
+    throw new Error(`getAuthSessionParameters failed with status ${response.status}: ${body}`);
+  }
+  let json;
+  try {
+    json = JSON.parse(body);
+  } catch (e) {
+    throw new Error(`Expected JSON response, but got ${body}`);
+  }
+  return authSessionParametersResponseSchema.parse(json).parameters;
+}

package/dist/common/binStartupScript.d.ts

@@ -1,2 +1 @@
-
-export {  }
+export {};

package/dist/common/binStartupScript.js

@@ -1,146 +1,40 @@
-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 __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
-));
-
-// src/common/binStartupScript.ts
-var import_dotenv = __toESM(require("dotenv"));
-var path2 = __toESM(require("path"));
-
-// src/common/intunedJson.ts
-var import_path = __toESM(require("path"));
-var fs = __toESM(require("fs-extra"));
-var import_zod = require("zod");
-var JSONC = __toESM(require("jsonc-parser"));
-var YAML = __toESM(require("yaml"));
-var TOML = __toESM(require("smol-toml"));
-var import_neverthrow = require("neverthrow");
-var intunedJsonSchema = import_zod.z.object({
-  projectName: import_zod.z.string().optional(),
-  workspaceId: import_zod.z.string().optional(),
-  metadata: import_zod.z.object({
-    defaultJobInput: import_zod.z.record(import_zod.z.any()).optional().catch(void 0),
-    defaultRunPlaygroundInput: import_zod.z.record(import_zod.z.any()).optional().catch(void 0),
-    testAuthSessionInput: import_zod.z.record(import_zod.z.any()).optional().catch(void 0)
-  }).optional().catch(void 0),
-  stealthMode: import_zod.z.object({
-    enabled: import_zod.z.boolean()
-  }).optional().catch(void 0)
-}).passthrough().and(
-  import_zod.z.union([
-    import_zod.z.object({
-      authSessions: import_zod.z.object({ enabled: import_zod.z.literal(false) }),
-      apiAccess: import_zod.z.object({
-        enabled: import_zod.z.literal(false)
-      })
-    }),
-    import_zod.z.object({
-      authSessions: import_zod.z.union([
-        import_zod.z.object({ enabled: import_zod.z.literal(false) }),
-        import_zod.z.object({
-          enabled: import_zod.z.literal(true),
-          type: import_zod.z.enum(["MANUAL", "API"]),
-          startUrl: import_zod.z.string().optional(),
-          finishUrl: import_zod.z.string().optional()
-        })
-      ]),
-      apiAccess: import_zod.z.object({
-        enabled: import_zod.z.literal(true)
-      })
-    })
-  ])
-);
-var intunedSettingsFileNames = [
-  "Intuned.json",
-  "Intuned.jsonc",
-  "Intuned.yaml",
-  "Intuned.yml",
-  "Intuned.toml"
-];
-var intunedSettingsParsers = {
-  "Intuned.json": JSON.parse,
-  "Intuned.jsonc": JSONC.parse,
-  "Intuned.yaml": YAML.parse,
-  "Intuned.yml": YAML.parse,
-  "Intuned.toml": TOML.parse
-};
-function loadIntunedJsonSync() {
-  const settingsFileResult = getIntunedSettingsFileSync();
-  if (!settingsFileResult.isOk()) {
-    return settingsFileResult;
-  }
-  const settingsFile = settingsFileResult.value;
-  const intunedJsonContent = fs.readFileSync(settingsFile.path, "utf-8");
-  let intunedJson;
-  try {
-    intunedJson = settingsFile.parse(intunedJsonContent);
-  } catch (e) {
-    return (0, import_neverthrow.err)(`Failed to parse ${settingsFile.name}: ${e.message}`);
-  }
-  const parseResult = intunedJsonSchema.safeParse(intunedJson);
-  if (!parseResult.success) {
-    const formattedError = parseResult.error.errors.map((e) => `- ${e.path.join(".")}: ${e.message}`).join("\n");
-    return (0, import_neverthrow.err)(
-      `${settingsFile.name} is not valid:
-${formattedError}
-Please fix the errors and try again.`
-    );
-  }
-  return (0, import_neverthrow.ok)(parseResult.data);
-}
-function getIntunedSettingsFileSync() {
-  for (const fileName of intunedSettingsFileNames) {
-    const filePath = import_path.default.join(process.cwd(), fileName);
-    if (fs.existsSync(filePath)) {
-      return (0, import_neverthrow.ok)({
-        name: fileName,
-        path: filePath,
-        parse: intunedSettingsParsers[fileName]
-      });
-    }
-  }
-  return (0, import_neverthrow.err)("No Intuned settings file found.");
-}
+"use strict";
 
-// src/common/binStartupScript.ts
-import_dotenv.default.config({
+var _dotenv = _interopRequireDefault(require("dotenv"));
+var path = _interopRequireWildcard(require("path"));
+var _intunedJson = require("./intunedJson");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+_dotenv.default.config({
   path: `.env`
 });
-function isStealthModeEnabled() {
+function getStealthModeConfig() {
   try {
-    const settingsResult = loadIntunedJsonSync();
+    const settingsResult = (0, _intunedJson.loadIntunedJsonSync)();
     if (settingsResult.isErr()) {
       console.error(`Warning: Failed to load Intuned settings: ${settingsResult.error}
 Stealth mode will not be enabled.`);
-      return false;
+      return {
+        enabled: false,
+        type: "patchright"
+      };
     }
-    return settingsResult.value.stealthMode?.enabled === true;
+    return {
+      enabled: settingsResult.value.stealthMode?.enabled === true,
+      type: settingsResult.value.stealthMode?.type || "patchright"
+    };
   } catch (error) {
     console.error("Error reading Intuned.json:", error.message);
-    return false;
+    return {
+      enabled: false,
+      type: "patchright"
+    };
   }
 }
 try {
-  if (isStealthModeEnabled()) {
-    const currentNodeModules = path2.resolve(process.cwd(), "node_modules");
+  const stealthConfig = getStealthModeConfig();
+  if (stealthConfig.enabled && stealthConfig.type === "patchright") {
+    const currentNodeModules = path.resolve(process.cwd(), "node_modules");
     process.env.NODE_PATH = process.env.NODE_PATH ? `${process.env.NODE_PATH}:${currentNodeModules}` : currentNodeModules;
     require("module").Module._initPaths();
     if (process.env.PLAYWRIGHT_PATCH_SCRIPT_PATH) {
@@ -149,5 +43,4 @@ try {
   }
 } catch (e) {
   console.error("Failed to apply stealth mode");
-}
-//# sourceMappingURL=binStartupScript.js.map
+}

package/dist/common/browserTabs.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Tab management utilities using CDP HTTP API.
+ *
+ * Provides functions to interact with browser tabs via Chrome DevTools Protocol HTTP endpoints.
+ * Refer to https://chromedevtools.github.io/devtools-protocol/ for the endpoints documentation.
+ * This approach is simpler than using the playwright API because it doesn't require us to create a playwright context.
+ */
+export interface CDPTabInfo {
+    id: string;
+    type: string;
+    title: string;
+    url: string;
+    webSocketDebuggerUrl?: string;
+    devtoolsFrontendUrl?: string;
+    faviconUrl?: string;
+    description?: string;
+}
+/**
+ * Fetch current tabs from CDP /json endpoint.
+ *
+ * @param cdpAddress - CDP address (e.g., "http://localhost:9222")
+ * @returns List of tab info dictionaries from CDP (filtered to only "page" type)
+ *
+ * @example
+ * const tabs = await getCDPTabs("http://localhost:9222");
+ * // Returns:
+ * // [
+ * //   {
+ * //     "id": "1234",
+ * //     "type": "page",
+ * //     "title": "Google",
+ * //     "url": "https://google.com",
+ * //     ...
+ * //   }
+ * // ]
+ */
+export declare function getCDPTabs(cdpAddress: string): Promise<CDPTabInfo[]>;
+/**
+ * Create new tab via CDP /json/new endpoint with optional URL.
+ *
+ * @param cdpAddress - CDP address (e.g., "http://localhost:9222")
+ * @param url - Initial URL for the tab (default: "about:blank")
+ * @returns Tab info dictionary from CDP
+ *
+ * @example
+ * const tab = await createCDPTab("http://localhost:9222", "https://google.com");
+ * // Returns:
+ * // {
+ * //   "id": "1234",
+ * //   "type": "page",
+ * //   "title": "New Tab",
+ * //   "url": "about:blank",
+ * //   ...
+ * // }
+ */
+export declare function createCDPTab(cdpAddress: string, url?: string): Promise<CDPTabInfo>;
+/**
+ * Close tab via CDP /json/close/{id} endpoint.
+ *
+ * @param cdpAddress - CDP address (e.g., "http://localhost:9222")
+ * @param cdpTargetId - Full CDP target ID to close
+ * @returns True if successful, False otherwise
+ */
+export declare function closeCDPTab(cdpAddress: string, cdpTargetId: string): Promise<boolean>;
+/**
+ * Activate/bring to front a tab via CDP /json/activate/{id} endpoint.
+ *
+ * @param cdpAddress - CDP address (e.g., "http://localhost:9222")
+ * @param cdpTargetId - Full CDP target ID to activate
+ * @returns True if successful, False otherwise
+ */
+export declare function activateCDPTab(cdpAddress: string, cdpTargetId: string): Promise<boolean>;