@bubblegum-ai/node 0.0.6-alpha.0 → 0.0.6-alpha.10

package/dist/session.d.ts

@@ -1,85 +0,0 @@
-import { BridgeClient, BridgeClientOptions } from "./client.js";
-import { SessionSummary, StepOptions, StepResult } from "./types.js";
-export type Channel = "web" | "mobile";
-export interface LaunchOptions extends BridgeClientOptions {
-    /** "web" (default) or "mobile". */
-    channel?: Channel;
-    /** Web: start URL to open. */
-    url?: string;
-    /** Web: run headless (default true). */
-    headless?: boolean;
-    /** Resolve-only — never execute. */
-    dryRun?: boolean;
-    /** Mobile: Appium server URL (required for the mobile channel). */
-    appiumUrl?: string;
-    /** Mobile: Appium capabilities. */
-    capabilities?: Record<string, unknown>;
-    /**
-     * Web client-owned mode: attach the engine to an existing Chromium over CDP
-     * (e.g. `http://localhost:9222`) instead of launching one, so the engine
-     * drives the same browser your test already controls. Requires the engine to
-     * advertise the `channel.web.cdp` capability.
-     */
-    cdpEndpoint?: string;
-    /** Which existing page to attach to when using `cdpEndpoint` (default 0). */
-    pageIndex?: number;
-}
-/** Options for {@link Bubblegum.attach} — `cdpEndpoint` is required. */
-export interface AttachOptions extends Omit<LaunchOptions, "channel"> {
-    cdpEndpoint: string;
-}
-export interface RecoverArgs {
-    failedSelector: string;
-    intent: string;
-    options?: StepOptions;
-}
-/**
- * The ergonomic, engine-owned session. `launch()` spawns the bridge, negotiates
- * the protocol, and opens a session whose Playwright/Appium handle lives inside
- * the Python engine; every call here is a thin proxy to the same four primitives
- * the Python SDK exposes, returning the identical `StepResult` shape.
- *
- * ```ts
- * const bg = await Bubblegum.launch({ url: "https://example.com/login" });
- * try {
- *   await bg.act('Enter "tom" into Username');
- *   await bg.act("Click Login");
- *   await bg.verify("Dashboard is visible");
- * } finally {
- *   await bg.close();
- * }
- * ```
- */
-export declare class Bubblegum {
-    private readonly client;
-    private readonly sessionId;
-    private constructor();
-    /** Spawn the bridge, handshake, and open a session (engine-owned by default). */
-    static launch(opts?: LaunchOptions): Promise<Bubblegum>;
-    /**
-     * Attach the engine to a browser your test already controls, over CDP
-     * (client-owned mode). Launch your Chromium with a remote-debugging port and
-     * pass its endpoint:
-     *
-     * ```ts
-     * const browser = await chromium.launch({ args: ["--remote-debugging-port=9222"] });
-     * const bg = await Bubblegum.attach({ cdpEndpoint: "http://localhost:9222" });
-     * await bg.act("Click Login"); // drives the page your test opened
-     * ```
-     */
-    static attach(opts: AttachOptions): Promise<Bubblegum>;
-    /** The bridge client (for advanced use / capability checks). */
-    get bridge(): BridgeClient;
-    act(instruction: string, options?: StepOptions): Promise<StepResult>;
-    verify(instruction: string, options?: StepOptions): Promise<StepResult>;
-    extract(instruction: string, options?: StepOptions): Promise<StepResult>;
-    recover(args: RecoverArgs): Promise<StepResult>;
-    isVisible(target: string): Promise<boolean>;
-    isChecked(target: string): Promise<boolean>;
-    selectedValue(target: string): Promise<string>;
-    explain(instruction: string): Promise<string>;
-    summary(): Promise<SessionSummary>;
-    /** Close the engine session and tear down the bridge process. */
-    close(): Promise<void>;
-}
-//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEvC,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACxD,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wEAAwE;AACxE,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAF5B,OAAO;IAKP,iFAAiF;WACpE,MAAM,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BjE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IAItD,gEAAgE;IAChE,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQpE,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQvE,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAQxE,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IASzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ3C,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnD,OAAO,IAAI,OAAO,CAAC,cAAc,CAAC;IAIlC,iEAAiE;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/session.js

@@ -1,141 +0,0 @@
-import { BridgeClient } from "./client.js";
-import { BridgeError } from "./errors.js";
-import { ErrorCodes } from "./protocol.js";
-/**
- * The ergonomic, engine-owned session. `launch()` spawns the bridge, negotiates
- * the protocol, and opens a session whose Playwright/Appium handle lives inside
- * the Python engine; every call here is a thin proxy to the same four primitives
- * the Python SDK exposes, returning the identical `StepResult` shape.
- *
- * ```ts
- * const bg = await Bubblegum.launch({ url: "https://example.com/login" });
- * try {
- *   await bg.act('Enter "tom" into Username');
- *   await bg.act("Click Login");
- *   await bg.verify("Dashboard is visible");
- * } finally {
- *   await bg.close();
- * }
- * ```
- */
-export class Bubblegum {
-    client;
-    sessionId;
-    constructor(client, sessionId) {
-        this.client = client;
-        this.sessionId = sessionId;
-    }
-    /** Spawn the bridge, handshake, and open a session (engine-owned by default). */
-    static async launch(opts = {}) {
-        const client = new BridgeClient(opts);
-        try {
-            await client.handshake();
-            if (opts.cdpEndpoint && !client.hasCapability("channel.web.cdp")) {
-                throw new BridgeError(ErrorCodes.Unsupported, "this engine does not support CDP attach (channel.web.cdp); upgrade bubblegum-ai");
-            }
-            const { session_id } = await client.request("session.open", {
-                channel: opts.channel ?? "web",
-                url: opts.url,
-                headless: opts.headless ?? true,
-                dry_run: opts.dryRun ?? false,
-                appium_url: opts.appiumUrl,
-                capabilities: opts.capabilities,
-                cdp_endpoint: opts.cdpEndpoint,
-                page_index: opts.pageIndex,
-            });
-            return new Bubblegum(client, session_id);
-        }
-        catch (err) {
-            await client.close();
-            throw err;
-        }
-    }
-    /**
-     * Attach the engine to a browser your test already controls, over CDP
-     * (client-owned mode). Launch your Chromium with a remote-debugging port and
-     * pass its endpoint:
-     *
-     * ```ts
-     * const browser = await chromium.launch({ args: ["--remote-debugging-port=9222"] });
-     * const bg = await Bubblegum.attach({ cdpEndpoint: "http://localhost:9222" });
-     * await bg.act("Click Login"); // drives the page your test opened
-     * ```
-     */
-    static attach(opts) {
-        return Bubblegum.launch({ ...opts, channel: "web" });
-    }
-    /** The bridge client (for advanced use / capability checks). */
-    get bridge() {
-        return this.client;
-    }
-    act(instruction, options) {
-        return this.client.request("act", {
-            session_id: this.sessionId,
-            instruction,
-            options,
-        });
-    }
-    verify(instruction, options) {
-        return this.client.request("verify", {
-            session_id: this.sessionId,
-            instruction,
-            options,
-        });
-    }
-    extract(instruction, options) {
-        return this.client.request("extract", {
-            session_id: this.sessionId,
-            instruction,
-            options,
-        });
-    }
-    recover(args) {
-        return this.client.request("recover", {
-            session_id: this.sessionId,
-            failed_selector: args.failedSelector,
-            intent: args.intent,
-            options: args.options,
-        });
-    }
-    async isVisible(target) {
-        const r = await this.client.request("is_visible", {
-            session_id: this.sessionId,
-            target,
-        });
-        return r.value;
-    }
-    async isChecked(target) {
-        const r = await this.client.request("is_checked", {
-            session_id: this.sessionId,
-            target,
-        });
-        return r.value;
-    }
-    async selectedValue(target) {
-        const r = await this.client.request("selected_value", {
-            session_id: this.sessionId,
-            target,
-        });
-        return r.value;
-    }
-    async explain(instruction) {
-        const r = await this.client.request("explain", {
-            session_id: this.sessionId,
-            instruction,
-        });
-        return r.explanation;
-    }
-    summary() {
-        return this.client.request("summary", { session_id: this.sessionId });
-    }
-    /** Close the engine session and tear down the bridge process. */
-    async close() {
-        try {
-            await this.client.request("session.close", { session_id: this.sessionId });
-        }
-        finally {
-            await this.client.close();
-        }
-    }
-}
-//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -1,40 +0,0 @@
-/**
- * TypeScript mirror of the engine's result schemas (`bubblegum/core/schemas.py`).
- *
- * Kept intentionally close to the Pydantic models. `[key: string]: unknown`
- * index signatures let newer engine fields flow through without breaking the
- * client (additive-first), while the named fields stay strongly typed.
- */
-export type StepStatus = "passed" | "failed" | "recovered" | "dry_run" | "skipped";
-export interface ResolvedTarget {
-    ref: string;
-    confidence: number;
-    resolver_name: string;
-    metadata?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-export interface ErrorInfo {
-    error_type: string;
-    message: string;
-    resolver_name?: string | null;
-    [key: string]: unknown;
-}
-export interface StepResult {
-    status: StepStatus;
-    action: string;
-    target: ResolvedTarget | null;
-    confidence: number;
-    duration_ms: number;
-    error?: ErrorInfo | null;
-    traces?: unknown[];
-    [key: string]: unknown;
-}
-export interface SessionSummary {
-    total: number;
-    passed: number;
-    failed: number;
-    [key: string]: unknown;
-}
-/** Per-call options forwarded verbatim to the engine SDK (timeout_ms, selector, …). */
-export type StepOptions = Record<string, unknown>;
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}