@bubblegum-ai/node 0.0.6-alpha.15 → 0.0.6-alpha.16

package/dist/cjs/console.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Modern, dependency-free console output for Bubblegum runs.
+ *
+ * The engine returns a {@link StepResult} for every act/verify; this module
+ * turns that into a clean, colorized one-line status you can print from your
+ * test helper, plus a {@link RunConsole} that tracks a run and prints an
+ * enterprise-style header/summary. No external libraries — ANSI only, and it
+ * auto-disables color for non-TTY / `NO_COLOR` so CI logs stay clean.
+ *
+ * ```ts
+ * import { RunConsole } from "@bubblegum-ai/node";
+ * const out = new RunConsole("Workout Creation");
+ * out.step(await bg.act("Click Save"));
+ * out.step(await bg.verify('status is "In Draft"'));
+ * out.summary();
+ * ```
+ */
+import { StepResult } from "./types.js";
+export interface ConsoleOptions {
+    /** Force color on/off. Default: auto (TTY and not NO_COLOR). */
+    color?: boolean;
+    /** Width the action text is padded to. Default 48. */
+    width?: number;
+    /** Include the resolver name + confidence. Default true. */
+    detail?: boolean;
+}
+/** Render a single step as a formatted, optionally-colorized line. */
+export declare function formatStepLine(result: StepResult, opts?: ConsoleOptions): string;
+/** Print a single step line (convenience over {@link formatStepLine}). */
+export declare function logStep(result: StepResult, opts?: ConsoleOptions): void;
+/**
+ * A small run tracker: prints a header, one line per step, and an
+ * enterprise-style summary with counts, pass rate and elapsed time.
+ */
+export declare class RunConsole {
+    private title;
+    private opts;
+    private counts;
+    private fallbacks;
+    private started;
+    private on;
+    constructor(title?: string, opts?: ConsoleOptions);
+    private write;
+    private banner;
+    /** A labelled section divider between logical groups of steps. */
+    section(name: string): void;
+    /** Record and print one step. Returns the same result for chaining. */
+    step(result: StepResult): StepResult;
+    /** Print the run summary footer. */
+    summary(): void;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/cjs/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAyBpD,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CA0BpF;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,qBAAa,UAAU;IAQT,OAAO,CAAC,KAAK;IAAoB,OAAO,CAAC,IAAI;IAPzD,OAAO,CAAC,MAAM,CAEZ;IACF,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,EAAE,CAAU;gBAEA,KAAK,SAAkB,EAAU,IAAI,GAAE,cAAmB;IAK9E,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,MAAM;IAQd,kEAAkE;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM;IAKpB,uEAAuE;IACvE,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAOpC,oCAAoC;IACpC,OAAO;CA2BR"}

package/dist/cjs/console.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunConsole = void 0;
+exports.formatStepLine = formatStepLine;
+exports.logStep = logStep;
+const ANSI = {
+    reset: "\x1b[0m", bold: "\x1b[1m", dim: "\x1b[2m",
+    green: "\x1b[32m", red: "\x1b[31m", amber: "\x1b[33m",
+    gray: "\x1b[90m", blue: "\x1b[34m", magenta: "\x1b[35m", cyan: "\x1b[36m",
+};
+function colorEnabled(opt) {
+    if (typeof opt === "boolean")
+        return opt;
+    const env = typeof process !== "undefined" ? process.env : {};
+    if (env.NO_COLOR)
+        return false;
+    if (env.FORCE_COLOR)
+        return true;
+    return !!(typeof process !== "undefined" && process.stdout && process.stdout.isTTY);
+}
+/** Per-status glyph + label + color. */
+const STATUS_STYLE = {
+    passed: { icon: "✔", label: "PASS", color: "green" },
+    recovered: { icon: "✚", label: "HEAL", color: "amber" },
+    failed: { icon: "✖", label: "FAIL", color: "red" },
+    skipped: { icon: "○", label: "SKIP", color: "gray" },
+    dry_run: { icon: "◇", label: "PLAN", color: "blue" },
+};
+function paint(s, color, on) {
+    return on ? `${ANSI[color]}${s}${ANSI.reset}` : s;
+}
+function fallbackUsed(r) {
+    const m = (r.target && r.target.metadata) || {};
+    return r.target?.resolver_name === "fallback_selector" || m.fallback_selector_used === true;
+}
+/** Render a single step as a formatted, optionally-colorized line. */
+function formatStepLine(result, opts = {}) {
+    const on = colorEnabled(opts.color);
+    const width = opts.width ?? 48;
+    const detail = opts.detail ?? true;
+    const st = STATUS_STYLE[result.status] ?? STATUS_STYLE.skipped;
+    const badge = paint(`${st.icon} ${st.label}`, st.color, on);
+    const action = (result.action || "").replace(/\s+/g, " ").trim();
+    const actionCol = action.length > width ? action.slice(0, width - 1) + "…" : action.padEnd(width);
+    const parts = [badge, "  ", actionCol];
+    if (detail) {
+        const resolver = result.target?.resolver_name ?? "—";
+        const conf = typeof result.confidence === "number" ? result.confidence.toFixed(2) : "—";
+        const ms = `${Math.round(result.duration_ms || 0)}ms`;
+        parts.push(paint(`  ${resolver} · ${conf} · ${ms}`, "gray", on));
+    }
+    if (result.status === "recovered")
+        parts.push(paint("  (self-healed)", "amber", on));
+    if (fallbackUsed(result))
+        parts.push(paint("  ⚠ fallback selector", "magenta", on));
+    let line = parts.join("");
+    if (result.status === "failed" && result.error) {
+        const err = `${result.error.error_type}: ${result.error.message}`;
+        line += "\n" + paint(`         ↳ ${err}`, "red", on);
+    }
+    return line;
+}
+/** Print a single step line (convenience over {@link formatStepLine}). */
+function logStep(result, opts = {}) {
+    // eslint-disable-next-line no-console
+    console.log(formatStepLine(result, opts));
+}
+/**
+ * A small run tracker: prints a header, one line per step, and an
+ * enterprise-style summary with counts, pass rate and elapsed time.
+ */
+class RunConsole {
+    title;
+    opts;
+    counts = {
+        passed: 0, failed: 0, recovered: 0, skipped: 0, dry_run: 0,
+    };
+    fallbacks = 0;
+    started = Date.now();
+    on;
+    constructor(title = "Bubblegum Run", opts = {}) {
+        this.title = title;
+        this.opts = opts;
+        this.on = colorEnabled(opts.color);
+        this.banner();
+    }
+    write(s) {
+        // eslint-disable-next-line no-console
+        console.log(s);
+    }
+    banner() {
+        const bar = "─".repeat(Math.max(8, this.title.length + 4));
+        this.write("");
+        this.write(paint(`┌${bar}┐`, "cyan", this.on));
+        this.write(paint(`│  ${this.title}  │`, "cyan", this.on) + paint("  bubblegum", "gray", this.on));
+        this.write(paint(`└${bar}┘`, "cyan", this.on));
+    }
+    /** A labelled section divider between logical groups of steps. */
+    section(name) {
+        this.write("");
+        this.write(paint(`▸ ${name}`, "bold", this.on));
+    }
+    /** Record and print one step. Returns the same result for chaining. */
+    step(result) {
+        this.counts[result.status] = (this.counts[result.status] ?? 0) + 1;
+        if (fallbackUsed(result))
+            this.fallbacks += 1;
+        this.write("  " + formatStepLine(result, this.opts));
+        return result;
+    }
+    /** Print the run summary footer. */
+    summary() {
+        const total = Object.values(this.counts).reduce((a, b) => a + b, 0);
+        const done = total - this.counts.skipped;
+        const rate = done ? Math.round((this.counts.passed + this.counts.recovered) / done * 100) : 0;
+        const secs = ((Date.now() - this.started) / 1000).toFixed(1);
+        const ok = this.counts.failed === 0;
+        const chip = (label, n, color) => n > 0 ? paint(`${label} ${n}`, color, this.on) : paint(`${label} ${n}`, "gray", this.on);
+        this.write("");
+        this.write(paint("─".repeat(56), "gray", this.on));
+        this.write([
+            chip("✔", this.counts.passed, "green"),
+            chip("✚", this.counts.recovered, "amber"),
+            this.fallbacks ? paint(`⚠ ${this.fallbacks}`, "magenta", this.on) : "",
+            chip("✖", this.counts.failed, "red"),
+            chip("○", this.counts.skipped, "gray"),
+            paint(`· ${rate}% pass · ${secs}s`, "gray", this.on),
+        ].filter(Boolean).join("   "));
+        this.write(ok
+            ? paint(`  ${this.title}: ALL PASSED`, "green", this.on)
+            : paint(`  ${this.title}: ${this.counts.failed} FAILED`, "red", this.on));
+        this.write("");
+    }
+}
+exports.RunConsole = RunConsole;
+//# sourceMappingURL=console.js.map

package/dist/cjs/console.js.map

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

package/dist/cjs/index.d.ts

@@ -11,6 +11,8 @@ export type { Channel, LaunchOptions, AttachOptions, MobileAttachOptions, Recove
 export { BridgeClient, spawnBridgeTransport, resolveBridgeCommand } from "./client.js";
 export type { Transport, SpawnOptions, BridgeClientOptions } from "./client.js";
 export { BridgeError } from "./errors.js";
+export { formatStepLine, logStep, RunConsole } from "./console.js";
+export type { ConsoleOptions } from "./console.js";
 export { PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS, ErrorCodes, } from "./protocol.js";
 export type { Handshake, JsonRpcResponse } from "./protocol.js";
 export type { StepResult, StepStatus, ResolvedTarget, ErrorInfo, SessionSummary, StepOptions, ReportOptions, ReportResult, } from "./types.js";

package/dist/cjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhE,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhE,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -8,7 +8,7 @@
  * a thin, typed proxy. See ../../docs/distribution-npm-and-pypi.md.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ErrorCodes = exports.SUPPORTED_PROTOCOL_VERSIONS = exports.PROTOCOL_VERSION = exports.BridgeError = exports.resolveBridgeCommand = exports.spawnBridgeTransport = exports.BridgeClient = exports.Bubblegum = void 0;
+exports.ErrorCodes = exports.SUPPORTED_PROTOCOL_VERSIONS = exports.PROTOCOL_VERSION = exports.RunConsole = exports.logStep = exports.formatStepLine = exports.BridgeError = exports.resolveBridgeCommand = exports.spawnBridgeTransport = exports.BridgeClient = exports.Bubblegum = void 0;
 var session_js_1 = require("./session.js");
 Object.defineProperty(exports, "Bubblegum", { enumerable: true, get: function () { return session_js_1.Bubblegum; } });
 var client_js_1 = require("./client.js");
@@ -17,6 +17,10 @@ Object.defineProperty(exports, "spawnBridgeTransport", { enumerable: true, get:
 Object.defineProperty(exports, "resolveBridgeCommand", { enumerable: true, get: function () { return client_js_1.resolveBridgeCommand; } });
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "BridgeError", { enumerable: true, get: function () { return errors_js_1.BridgeError; } });
+var console_js_1 = require("./console.js");
+Object.defineProperty(exports, "formatStepLine", { enumerable: true, get: function () { return console_js_1.formatStepLine; } });
+Object.defineProperty(exports, "logStep", { enumerable: true, get: function () { return console_js_1.logStep; } });
+Object.defineProperty(exports, "RunConsole", { enumerable: true, get: function () { return console_js_1.RunConsole; } });
 var protocol_js_1 = require("./protocol.js");
 Object.defineProperty(exports, "PROTOCOL_VERSION", { enumerable: true, get: function () { return protocol_js_1.PROTOCOL_VERSION; } });
 Object.defineProperty(exports, "SUPPORTED_PROTOCOL_VERSIONS", { enumerable: true, get: function () { return protocol_js_1.SUPPORTED_PROTOCOL_VERSIONS; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAGlB,yCAAuF;AAA9E,yGAAA,YAAY,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAGjE,yCAA0C;AAAjC,wGAAA,WAAW,OAAA;AAEpB,6CAIuB;AAHrB,+GAAA,gBAAgB,OAAA;AAChB,0HAAA,2BAA2B,OAAA;AAC3B,yGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAGlB,yCAAuF;AAA9E,yGAAA,YAAY,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAGjE,yCAA0C;AAAjC,wGAAA,WAAW,OAAA;AAEpB,2CAAmE;AAA1D,4GAAA,cAAc,OAAA;AAAE,qGAAA,OAAO,OAAA;AAAE,wGAAA,UAAU,OAAA;AAG5C,6CAIuB;AAHrB,+GAAA,gBAAgB,OAAA;AAChB,0HAAA,2BAA2B,OAAA;AAC3B,yGAAA,UAAU,OAAA"}

package/dist/esm/console.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Modern, dependency-free console output for Bubblegum runs.
+ *
+ * The engine returns a {@link StepResult} for every act/verify; this module
+ * turns that into a clean, colorized one-line status you can print from your
+ * test helper, plus a {@link RunConsole} that tracks a run and prints an
+ * enterprise-style header/summary. No external libraries — ANSI only, and it
+ * auto-disables color for non-TTY / `NO_COLOR` so CI logs stay clean.
+ *
+ * ```ts
+ * import { RunConsole } from "@bubblegum-ai/node";
+ * const out = new RunConsole("Workout Creation");
+ * out.step(await bg.act("Click Save"));
+ * out.step(await bg.verify('status is "In Draft"'));
+ * out.summary();
+ * ```
+ */
+import { StepResult } from "./types.js";
+export interface ConsoleOptions {
+    /** Force color on/off. Default: auto (TTY and not NO_COLOR). */
+    color?: boolean;
+    /** Width the action text is padded to. Default 48. */
+    width?: number;
+    /** Include the resolver name + confidence. Default true. */
+    detail?: boolean;
+}
+/** Render a single step as a formatted, optionally-colorized line. */
+export declare function formatStepLine(result: StepResult, opts?: ConsoleOptions): string;
+/** Print a single step line (convenience over {@link formatStepLine}). */
+export declare function logStep(result: StepResult, opts?: ConsoleOptions): void;
+/**
+ * A small run tracker: prints a header, one line per step, and an
+ * enterprise-style summary with counts, pass rate and elapsed time.
+ */
+export declare class RunConsole {
+    private title;
+    private opts;
+    private counts;
+    private fallbacks;
+    private started;
+    private on;
+    constructor(title?: string, opts?: ConsoleOptions);
+    private write;
+    private banner;
+    /** A labelled section divider between logical groups of steps. */
+    section(name: string): void;
+    /** Record and print one step. Returns the same result for chaining. */
+    step(result: StepResult): StepResult;
+    /** Print the run summary footer. */
+    summary(): void;
+}
+//# sourceMappingURL=console.d.ts.map

package/dist/esm/console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../src/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAyBpD,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,CA0BpF;AAED,0EAA0E;AAC1E,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,IAAI,CAG3E;AAED;;;GAGG;AACH,qBAAa,UAAU;IAQT,OAAO,CAAC,KAAK;IAAoB,OAAO,CAAC,IAAI;IAPzD,OAAO,CAAC,MAAM,CAEZ;IACF,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,EAAE,CAAU;gBAEA,KAAK,SAAkB,EAAU,IAAI,GAAE,cAAmB;IAK9E,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,MAAM;IAQd,kEAAkE;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM;IAKpB,uEAAuE;IACvE,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU;IAOpC,oCAAoC;IACpC,OAAO;CA2BR"}

package/dist/esm/console.js

@@ -0,0 +1,130 @@
+const ANSI = {
+    reset: "\x1b[0m", bold: "\x1b[1m", dim: "\x1b[2m",
+    green: "\x1b[32m", red: "\x1b[31m", amber: "\x1b[33m",
+    gray: "\x1b[90m", blue: "\x1b[34m", magenta: "\x1b[35m", cyan: "\x1b[36m",
+};
+function colorEnabled(opt) {
+    if (typeof opt === "boolean")
+        return opt;
+    const env = typeof process !== "undefined" ? process.env : {};
+    if (env.NO_COLOR)
+        return false;
+    if (env.FORCE_COLOR)
+        return true;
+    return !!(typeof process !== "undefined" && process.stdout && process.stdout.isTTY);
+}
+/** Per-status glyph + label + color. */
+const STATUS_STYLE = {
+    passed: { icon: "✔", label: "PASS", color: "green" },
+    recovered: { icon: "✚", label: "HEAL", color: "amber" },
+    failed: { icon: "✖", label: "FAIL", color: "red" },
+    skipped: { icon: "○", label: "SKIP", color: "gray" },
+    dry_run: { icon: "◇", label: "PLAN", color: "blue" },
+};
+function paint(s, color, on) {
+    return on ? `${ANSI[color]}${s}${ANSI.reset}` : s;
+}
+function fallbackUsed(r) {
+    const m = (r.target && r.target.metadata) || {};
+    return r.target?.resolver_name === "fallback_selector" || m.fallback_selector_used === true;
+}
+/** Render a single step as a formatted, optionally-colorized line. */
+export function formatStepLine(result, opts = {}) {
+    const on = colorEnabled(opts.color);
+    const width = opts.width ?? 48;
+    const detail = opts.detail ?? true;
+    const st = STATUS_STYLE[result.status] ?? STATUS_STYLE.skipped;
+    const badge = paint(`${st.icon} ${st.label}`, st.color, on);
+    const action = (result.action || "").replace(/\s+/g, " ").trim();
+    const actionCol = action.length > width ? action.slice(0, width - 1) + "…" : action.padEnd(width);
+    const parts = [badge, "  ", actionCol];
+    if (detail) {
+        const resolver = result.target?.resolver_name ?? "—";
+        const conf = typeof result.confidence === "number" ? result.confidence.toFixed(2) : "—";
+        const ms = `${Math.round(result.duration_ms || 0)}ms`;
+        parts.push(paint(`  ${resolver} · ${conf} · ${ms}`, "gray", on));
+    }
+    if (result.status === "recovered")
+        parts.push(paint("  (self-healed)", "amber", on));
+    if (fallbackUsed(result))
+        parts.push(paint("  ⚠ fallback selector", "magenta", on));
+    let line = parts.join("");
+    if (result.status === "failed" && result.error) {
+        const err = `${result.error.error_type}: ${result.error.message}`;
+        line += "\n" + paint(`         ↳ ${err}`, "red", on);
+    }
+    return line;
+}
+/** Print a single step line (convenience over {@link formatStepLine}). */
+export function logStep(result, opts = {}) {
+    // eslint-disable-next-line no-console
+    console.log(formatStepLine(result, opts));
+}
+/**
+ * A small run tracker: prints a header, one line per step, and an
+ * enterprise-style summary with counts, pass rate and elapsed time.
+ */
+export class RunConsole {
+    title;
+    opts;
+    counts = {
+        passed: 0, failed: 0, recovered: 0, skipped: 0, dry_run: 0,
+    };
+    fallbacks = 0;
+    started = Date.now();
+    on;
+    constructor(title = "Bubblegum Run", opts = {}) {
+        this.title = title;
+        this.opts = opts;
+        this.on = colorEnabled(opts.color);
+        this.banner();
+    }
+    write(s) {
+        // eslint-disable-next-line no-console
+        console.log(s);
+    }
+    banner() {
+        const bar = "─".repeat(Math.max(8, this.title.length + 4));
+        this.write("");
+        this.write(paint(`┌${bar}┐`, "cyan", this.on));
+        this.write(paint(`│  ${this.title}  │`, "cyan", this.on) + paint("  bubblegum", "gray", this.on));
+        this.write(paint(`└${bar}┘`, "cyan", this.on));
+    }
+    /** A labelled section divider between logical groups of steps. */
+    section(name) {
+        this.write("");
+        this.write(paint(`▸ ${name}`, "bold", this.on));
+    }
+    /** Record and print one step. Returns the same result for chaining. */
+    step(result) {
+        this.counts[result.status] = (this.counts[result.status] ?? 0) + 1;
+        if (fallbackUsed(result))
+            this.fallbacks += 1;
+        this.write("  " + formatStepLine(result, this.opts));
+        return result;
+    }
+    /** Print the run summary footer. */
+    summary() {
+        const total = Object.values(this.counts).reduce((a, b) => a + b, 0);
+        const done = total - this.counts.skipped;
+        const rate = done ? Math.round((this.counts.passed + this.counts.recovered) / done * 100) : 0;
+        const secs = ((Date.now() - this.started) / 1000).toFixed(1);
+        const ok = this.counts.failed === 0;
+        const chip = (label, n, color) => n > 0 ? paint(`${label} ${n}`, color, this.on) : paint(`${label} ${n}`, "gray", this.on);
+        this.write("");
+        this.write(paint("─".repeat(56), "gray", this.on));
+        this.write([
+            chip("✔", this.counts.passed, "green"),
+            chip("✚", this.counts.recovered, "amber"),
+            this.fallbacks ? paint(`⚠ ${this.fallbacks}`, "magenta", this.on) : "",
+            chip("✖", this.counts.failed, "red"),
+            chip("○", this.counts.skipped, "gray"),
+            paint(`· ${rate}% pass · ${secs}s`, "gray", this.on),
+        ].filter(Boolean).join("   "));
+        this.write(ok
+            ? paint(`  ${this.title}: ALL PASSED`, "green", this.on)
+            : paint(`  ${this.title}: ${this.counts.failed} FAILED`, "red", this.on));
+        this.write("");
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/esm/console.js.map

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

package/dist/esm/index.d.ts

@@ -11,6 +11,8 @@ export type { Channel, LaunchOptions, AttachOptions, MobileAttachOptions, Recove
 export { BridgeClient, spawnBridgeTransport, resolveBridgeCommand } from "./client.js";
 export type { Transport, SpawnOptions, BridgeClientOptions } from "./client.js";
 export { BridgeError } from "./errors.js";
+export { formatStepLine, logStep, RunConsole } from "./console.js";
+export type { ConsoleOptions } from "./console.js";
 export { PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS, ErrorCodes, } from "./protocol.js";
 export type { Handshake, JsonRpcResponse } from "./protocol.js";
 export type { StepResult, StepStatus, ResolvedTarget, ErrorInfo, SessionSummary, StepOptions, ReportOptions, ReportResult, } from "./types.js";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhE,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5G,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhE,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,SAAS,EACT,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -9,5 +9,6 @@
 export { Bubblegum } from "./session.js";
 export { BridgeClient, spawnBridgeTransport, resolveBridgeCommand } from "./client.js";
 export { BridgeError } from "./errors.js";
+export { formatStepLine, logStep, RunConsole } from "./console.js";
 export { PROTOCOL_VERSION, SUPPORTED_PROTOCOL_VERSIONS, ErrorCodes, } from "./protocol.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGvF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EACL,gBAAgB,EAChB,2BAA2B,EAC3B,UAAU,GACX,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblegum-ai/node",
-  "version": "0.0.6-alpha.15",
+  "version": "0.0.6-alpha.16",
   "description": "Node/TypeScript client for the Bubblegum engine — drive AI-powered, natural-language Playwright/Appium test steps from JS/TS via the Bubblegum JSON-RPC bridge.",
   "type": "module",
   "exports": {