@zenalexa/unicli 0.224.1 → 0.225.0

package/dist/engine/cookies.js

@@ -1,39 +1,29 @@
 /**
- * Cookie file reader for authenticated adapters.
- *
- * Cookies are stored as JSON in ~/.unicli/cookies/<site>.json
- * Each file contains { "cookie_name": "value", ... }
+ * @owner       src::engine::cookies
+ * @does        Cookie front door for adapters — thin projections over the
+ *              structured acquisition core in cookie-source.ts (disk read,
+ *              header formatting, multi-source load, refresh).
+ * @needs       ./cookie-source, ./cookie-extractor (saveCookies)
+ * @feeds       adapters (loadCookiesWithCDP/formatCookieHeader), executor,
+ *              dispatch/social (refreshCookiesFromBrowser), commands/auth
+ * @breaks      loadCookies/loadCookiesWithCDP return null on miss (back-compat);
+ *              acquireCookies returns a typed CookieLoadOutcome that names the
+ *              real cause — callers that need the cause use acquireCookies
+ * @invariants  loadCookiesWithCDP cookies === acquireCookies(...).cookies on load
+ * @side-effects acquireCookies persists browser/CDP cookies to disk (best-effort)
+ * @test        tests/unit/engine/cookie-source.test.ts, cookie-refresh-format.test.ts
+ * @stability   stable
+ * @since       2026-05-30
  */
-import { readFileSync, existsSync } from "node:fs";
-import { join } from "node:path";
-import { extractCookiesViaCDP, saveCookies as saveCookiesToDisk, } from "./cookie-extractor.js";
-function cookieDir() {
-    return (process.env.UNICLI_COOKIE_DIR ??
-        join(process.env.HOME ?? "~", ".unicli", "cookies"));
-}
+import { cookieDir, describeCookieFailure, loadCookiesWithDiagnostics, readDiskCookies, resolveCookieDomain, } from "./cookie-source.js";
+import { saveCookies as saveCookiesToDisk } from "./cookie-extractor.js";
 /**
- * Load cookies for a site from disk.
- * Returns null if file doesn't exist or is malformed.
+ * Load cookies for a site from disk. Returns null when the file is absent OR
+ * unreadable; callers needing to tell those apart use `acquireCookies`.
  */
 export function loadCookies(site) {
-    if (!/^[a-zA-Z0-9._-]+$/.test(site))
-        return null;
-    const path = join(cookieDir(), `${site}.json`);
-    if (!existsSync(path))
-        return null;
-    try {
-        const raw = readFileSync(path, "utf-8");
-        const parsed = JSON.parse(raw);
-        if (typeof parsed !== "object" ||
-            parsed === null ||
-            Array.isArray(parsed)) {
-            return null;
-        }
-        return parsed;
-    }
-    catch {
-        return null;
-    }
+    const read = readDiskCookies(site);
+    return read.kind === "ok" ? read.cookies : null;
 }
 /**
  * Format cookies as an HTTP Cookie header value.
@@ -44,9 +34,7 @@ export function formatCookieHeader(cookies) {
         .map(([k, v]) => `${k}=${v}`)
         .join("; ");
 }
-/**
- * Validate that a cookie file has all required keys.
- */
+/** Validate that a cookie file has all required keys. */
 export function validateCookies(site, requiredKeys) {
     const cookies = loadCookies(site);
     if (!cookies)
@@ -54,77 +42,44 @@ export function validateCookies(site, requiredKeys) {
     const missing = requiredKeys.filter((k) => !(k in cookies));
     return { valid: missing.length === 0, missing };
 }
-/**
- * Get the cookie directory path (for display in auth commands).
- */
+/** Get the cookie directory path (for display in auth commands). */
 export function getCookieDir() {
     return cookieDir();
 }
 /**
- * Load cookies with multi-source fallback.
- *
- * Precedence (each falls through silently to the next on miss):
- *   1. ~/.unicli/cookies/<site>.json       — explicit user import
- *   2. browser local DB (Chrome/Arc/Dia/…) — direct SQLite read, no browser launch
- *   3. CDP                                  — connects to Chrome debug port (legacy)
- *
- * The browser disk source is the new default for `strategy: cookie` adapters:
- * it works whether the browser is open or closed, never opens a new tab, and
- * needs neither extension nor daemon. Successful reads are persisted to
- * ~/.unicli/cookies for offline reuse.
- *
- * Set `UNICLI_COOKIE_NO_BROWSER=1` to skip the browser-disk step (e.g., in CI
- * where the macOS Keychain prompt would block).
+ * Acquire cookies across disk → browser → CDP, returning the structured outcome
+ * (loaded / absent / error+reasons). On a non-disk load, persists to
+ * ~/.unicli/cookies for offline reuse. This is the front door for callers that
+ * need to surface WHY acquisition failed (Keychain denial, v20 encryption,
+ * corrupt file) instead of a bare null.
  */
-export async function loadCookiesWithCDP(site, domain) {
-    // 1. ~/.unicli/cookies first
-    const diskCookies = loadCookies(site);
-    if (diskCookies)
-        return diskCookies;
-    // Resolve the cookie domain once for both browser and CDP paths.
-    let cookieDomain = domain ?? site.replace(/_/g, ".");
-    if (!cookieDomain.includes(".")) {
-        cookieDomain = `${cookieDomain}.com`;
-    }
-    // 2. Direct browser disk read (no launch, no CDP, no extension).
-    if (process.env.UNICLI_COOKIE_NO_BROWSER !== "1") {
-        const browserCookies = await loadFromInstalledBrowser(cookieDomain);
-        if (browserCookies && Object.keys(browserCookies).length > 0) {
-            try {
-                saveCookiesToDisk(site, browserCookies);
-            }
-            catch {
-                // Non-fatal — caller still gets the cookies.
-            }
-            return browserCookies;
+export async function acquireCookies(site, domain, opts = {}) {
+    const outcome = await loadCookiesWithDiagnostics(site, domain, undefined, opts);
+    if (outcome.status === "loaded" && outcome.source !== "disk") {
+        try {
+            saveCookiesToDisk(site, outcome.cookies);
         }
-    }
-    // 3. CDP fallback for users running Chrome with --remote-debugging-port.
-    try {
-        const cdpCookies = await extractCookiesViaCDP(cookieDomain);
-        if (Object.keys(cdpCookies).length > 0) {
-            try {
-                saveCookiesToDisk(site, cdpCookies);
-            }
-            catch {
-                // Non-fatal: disk write failed but we still have the cookies
-            }
-            return cdpCookies;
+        catch {
+            // REASON: persistence is best-effort; the cookies are already usable for
+            // this run, and the next run re-acquires from the same live source.
         }
     }
-    catch {
-        // CDP not available — fall through
-    }
-    return null;
+    return outcome;
 }
-function persistCookies(site, cookies) {
-    try {
-        saveCookiesToDisk(site, cookies);
-    }
-    catch {
-        // Non-fatal: callers can still retry because browser/CDP remains readable.
-    }
+/**
+ * Load cookies with multi-source fallback (disk → browser DB → CDP). Returns
+ * null on any miss. Behavior-compatible with every existing adapter consumer;
+ * the structured cause is available via `acquireCookies`.
+ */
+export async function loadCookiesWithCDP(site, domain) {
+    const outcome = await acquireCookies(site, domain);
+    return outcome.status === "loaded" ? outcome.cookies : null;
 }
+/**
+ * Re-acquire cookies from the live browser / CDP after an auth failure. Skips
+ * the on-disk file (those are the stale cookies that just failed) and reports
+ * the real cause on failure rather than a generic message.
+ */
 export async function refreshCookiesFromBrowser(site, domain) {
     if (!/^[a-zA-Z0-9._-]+$/.test(site)) {
         return {
@@ -134,77 +89,23 @@ export async function refreshCookiesFromBrowser(site, domain) {
             suggestion: "Site names must contain only letters, digits, dot, dash, or underscore.",
         };
     }
-    let cookieDomain = domain ?? site.replace(/_/g, ".");
-    if (!cookieDomain.includes(".")) {
-        cookieDomain = `${cookieDomain}.com`;
-    }
-    if (process.env.UNICLI_COOKIE_NO_BROWSER !== "1") {
-        const browserCookies = await loadFromInstalledBrowser(cookieDomain);
-        if (browserCookies && Object.keys(browserCookies).length > 0) {
-            persistCookies(site, browserCookies);
-            return {
-                ok: true,
-                site,
-                domain: cookieDomain,
-                source: "browser",
-                cookieCount: Object.keys(browserCookies).length,
-                cookies: Object.keys(browserCookies),
-            };
-        }
-    }
-    try {
-        const cdpCookies = await extractCookiesViaCDP(cookieDomain);
-        if (Object.keys(cdpCookies).length > 0) {
-            persistCookies(site, cdpCookies);
-            return {
-                ok: true,
-                site,
-                domain: cookieDomain,
-                source: "cdp",
-                cookieCount: Object.keys(cdpCookies).length,
-                cookies: Object.keys(cdpCookies),
-            };
-        }
-    }
-    catch {
+    const cookieDomain = resolveCookieDomain(site, domain);
+    const outcome = await acquireCookies(site, domain, { skipDisk: true });
+    if (outcome.status === "loaded") {
         return {
-            ok: false,
+            ok: true,
             site,
             domain: cookieDomain,
-            suggestion: `Open https://${cookieDomain} in the browser, complete login or challenge, then run: unicli auth import ${site} --domain ${cookieDomain}`,
+            source: outcome.source === "cdp" ? "cdp" : "browser",
+            cookieCount: Object.keys(outcome.cookies).length,
+            cookies: Object.keys(outcome.cookies),
         };
     }
     return {
         ok: false,
         site,
         domain: cookieDomain,
-        suggestion: `No cookies found for ${cookieDomain}. Sign in to https://${cookieDomain}, then run: unicli auth import ${site} --domain ${cookieDomain}`,
+        suggestion: describeCookieFailure(outcome, site, domain).suggestion,
     };
 }
-/**
- * Try each installed Chromium browser in priority order until one yields
- * cookies for the domain. Failures (browser not installed, Keychain denied,
- * unsupported encryption) fall through silently — the next source handles it.
- */
-async function loadFromInstalledBrowser(domain) {
-    let mod;
-    try {
-        mod = await import("./chromium-cookies.js");
-    }
-    catch {
-        return null;
-    }
-    const installed = mod.detectInstalledBrowsers();
-    for (const browser of installed) {
-        try {
-            const record = mod.readCookiesAsRecord({ browser, domain });
-            if (Object.keys(record).length > 0)
-                return record;
-        }
-        catch {
-            // Move on to the next browser.
-        }
-    }
-    return null;
-}
 //# sourceMappingURL=cookies.js.map

package/dist/engine/cookies.js.map

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

package/dist/engine/delivery/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @owner   src/engine/delivery/index.ts
  * @does    Exposes the internal objective-level delivery kernel.
- * @needs   src/engine/delivery/planner.ts, src/engine/delivery/repair.ts, src/engine/delivery/session.ts, src/engine/delivery/trajectory.ts, src/engine/delivery/types.ts
+ * @needs   src/engine/delivery/planner.ts, src/engine/delivery/repair.ts, src/engine/delivery/session.ts, src/engine/delivery/spec.ts, src/engine/delivery/trajectory.ts, src/engine/delivery/types.ts
  * @feeds   tests and future command surfaces that orchestrate objective delivery.
  * @breaks  Missing exports hide the delivery state machine from integration layers.
  * @invariants exports are side-effect free and preserve the delivery module boundary.
@@ -15,6 +15,7 @@
 export * from "./planner.js";
 export * from "./repair.js";
 export * from "./session.js";
+export * from "./spec.js";
 export * from "./trajectory.js";
 export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/engine/delivery/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/engine/delivery/index.js

@@ -1,7 +1,7 @@
 /**
  * @owner   src/engine/delivery/index.ts
  * @does    Exposes the internal objective-level delivery kernel.
- * @needs   src/engine/delivery/planner.ts, src/engine/delivery/repair.ts, src/engine/delivery/session.ts, src/engine/delivery/trajectory.ts, src/engine/delivery/types.ts
+ * @needs   src/engine/delivery/planner.ts, src/engine/delivery/repair.ts, src/engine/delivery/session.ts, src/engine/delivery/spec.ts, src/engine/delivery/trajectory.ts, src/engine/delivery/types.ts
  * @feeds   tests and future command surfaces that orchestrate objective delivery.
  * @breaks  Missing exports hide the delivery state machine from integration layers.
  * @invariants exports are side-effect free and preserve the delivery module boundary.
@@ -15,6 +15,7 @@
 export * from "./planner.js";
 export * from "./repair.js";
 export * from "./session.js";
+export * from "./spec.js";
 export * from "./trajectory.js";
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/engine/delivery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/delivery/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/dist/engine/delivery/spec.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @owner   src/engine/delivery/spec.ts
+ * @does    Builds explicit delivery operator spec templates from executable command matches.
+ * @needs   src/engine/delivery/types.ts, src/types.ts
+ * @feeds   src/commands/do.ts, src/commands/delivery.ts, tests/unit/delivery-cli.test.ts
+ * @breaks  Bad template IDs or strategy kinds make do-to-delivery handoff ambiguous or non-executable.
+ * @invariants generated specs contain no attempts or runs; execution remains owned by delivery.run.
+ * @side-effects none
+ * @perf    O(command metadata size).
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/commands/do.test.ts, tests/unit/delivery-cli.test.ts
+ * @stability experimental
+ * @since   2026-05-31
+ */
+import type { AdapterType, TargetSurface } from "../../types.js";
+import type { DeliveryAttempt, DeliveryObjective, DeliveryStrategy } from "./types.js";
+import type { RunId } from "../session/types.js";
+export interface DeliveryRunRef {
+    run_id: RunId;
+    strategy_id: string;
+    id?: string;
+    ordinal?: number;
+}
+export interface DeliveryOperatorSpec {
+    objective: DeliveryObjective;
+    strategies: DeliveryStrategy[];
+    attempts: DeliveryAttempt[];
+    runs: DeliveryRunRef[];
+    recorded_at?: string;
+}
+export interface DeliverySpecCommandMatch {
+    intent: string;
+    site: string;
+    command: string;
+    description?: string;
+    args?: Record<string, unknown>;
+    adapter_path?: string;
+    verify_command?: string;
+    adapter_type?: AdapterType | string;
+    target_surface?: TargetSurface | string;
+    uses_browser?: boolean;
+}
+export declare function buildDeliveryOperatorSpecTemplate(match: DeliverySpecCommandMatch): DeliveryOperatorSpec;
+//# sourceMappingURL=spec.d.ts.map

package/dist/engine/delivery/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../../src/engine/delivery/spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAOjD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,iBAAiB,CAAC;IAC7B,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC;IACpC,cAAc,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACxC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,wBAAwB,GAC9B,oBAAoB,CA6BtB"}

package/dist/engine/delivery/spec.js

@@ -0,0 +1,82 @@
+/**
+ * @owner   src/engine/delivery/spec.ts
+ * @does    Builds explicit delivery operator spec templates from executable command matches.
+ * @needs   src/engine/delivery/types.ts, src/types.ts
+ * @feeds   src/commands/do.ts, src/commands/delivery.ts, tests/unit/delivery-cli.test.ts
+ * @breaks  Bad template IDs or strategy kinds make do-to-delivery handoff ambiguous or non-executable.
+ * @invariants generated specs contain no attempts or runs; execution remains owned by delivery.run.
+ * @side-effects none
+ * @perf    O(command metadata size).
+ * @concurrency pure and reentrant.
+ * @test    tests/unit/commands/do.test.ts, tests/unit/delivery-cli.test.ts
+ * @stability experimental
+ * @since   2026-05-31
+ */
+const DEFAULT_TEMPLATE_GATES = [
+    { kind: "run_completed" },
+    { kind: "required_evidence_type", evidence_type: "result-envelope" },
+];
+export function buildDeliveryOperatorSpecTemplate(match) {
+    const site = match.site.trim();
+    const command = match.command.trim();
+    const objectiveId = `deliver-${slugPart(site)}-${slugPart(command)}`;
+    const strategyKind = strategyKindForMatch(match);
+    const strategyId = `${strategyKind}-${slugPart(site)}-${slugPart(command)}`;
+    const strategy = {
+        id: strategyId,
+        kind: strategyKind,
+        label: strategyLabel(match, site, command),
+        priority: 10,
+        command: `${site}.${command}`,
+        ...(hasEntries(match.args) ? { args: match.args } : {}),
+        ...(nonEmpty(match.adapter_path)
+            ? { adapter_path: match.adapter_path }
+            : {}),
+        verify_command: match.verify_command ?? `unicli test ${site} ${command}`,
+    };
+    return {
+        objective: {
+            id: objectiveId,
+            goal: nonEmpty(match.intent) ?? `Run ${site}.${command}`,
+            evidence_gates: DEFAULT_TEMPLATE_GATES,
+        },
+        strategies: [strategy],
+        attempts: [],
+        runs: [],
+    };
+}
+function strategyKindForMatch(match) {
+    if (match.uses_browser === true || match.adapter_type === "browser") {
+        return "browser";
+    }
+    if (match.target_surface === "desktop" || match.adapter_type === "desktop") {
+        return "desktop";
+    }
+    if (match.target_surface === "system" ||
+        match.adapter_type === "bridge" ||
+        match.adapter_type === "service") {
+        return "local";
+    }
+    return "adapter";
+}
+function strategyLabel(match, site, command) {
+    const description = nonEmpty(match.description);
+    return description
+        ? `Run ${site}.${command}: ${description}`
+        : `Run ${site}.${command}`;
+}
+function hasEntries(value) {
+    return value !== undefined && Object.keys(value).length > 0;
+}
+function nonEmpty(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function slugPart(value) {
+    return (value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "") || "command");
+}
+//# sourceMappingURL=spec.js.map

package/dist/engine/delivery/spec.js.map

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

package/dist/engine/executor.d.ts

@@ -4,17 +4,21 @@
  * Dispatches pipeline steps through `step-registry`. Per-step bodies live
  * in `steps/*.ts` and self-register on import. This file owns:
  *   - PipelineError shape
- *   - `executeStep` dispatch (registry → visual/ax bus → plugin registry)
+ *   - `executeStep` dispatch (registry → visual/ax bus → plugin registry);
+ *     an unrecognized action raises a typed `unknown_action` PipelineError
+ *   - `buildPipelineError` — single shaping point for step-failure envelopes
  *   - `runPipeline` orchestration (cookies, retry, fallback, auto-fix,
- *     diagnostic, cookie refresh, temp-dir cleanup)
+ *     diagnostic, cookie refresh, temp-dir cleanup, per-step observation)
  *
- * Per-step recovery helpers live in `runtime.ts`.
+ * Per-step recovery helpers live in `runtime.ts`. The per-step observation
+ * record + sink contract live in `step-observer.ts`.
  */
 import type { PipelineStep } from "../types.js";
 import type { BrowserSessionPreference } from "../types.js";
 import type { BrowserPage } from "../browser/page.js";
 import { getBus, buildTransportCtx, _resetTransportBusForTests } from "../transport/bus.js";
 import type { ArgSource, ResolvedArgs } from "./args.js";
+import { type StepObserver } from "./step-observer.js";
 import "./steps/index.js";
 export { assertSafeRequestUrl } from "./ssrf.js";
 export { getBus, buildTransportCtx, _resetTransportBusForTests };
@@ -44,6 +48,13 @@ export interface PipelineOptions {
     trace_id?: string;
     /** Browser transport preference declared by a browser command. */
     browserSession?: BrowserSessionPreference;
+    /**
+     * Optional sink for per-step observations. When provided, runPipeline emits
+     * one observation per executed step (timing + output shape on success,
+     * errorType + message on failure). Additive side channel — never alters the
+     * result/error envelope. Undefined = zero overhead (the default).
+     */
+    observer?: StepObserver;
 }
 export type PipelineContext = {
     data: unknown;
@@ -74,7 +85,7 @@ export declare class PipelineError extends Error {
         step: number;
         action: string;
         config: unknown;
-        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "permission_denied" | "stale_ref" | "ambiguous" | "ref_not_found";
+        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "permission_denied" | "stale_ref" | "ambiguous" | "ref_not_found" | "unknown_action";
         url?: string;
         statusCode?: number;
         responsePreview?: string;
@@ -86,7 +97,7 @@ export declare class PipelineError extends Error {
         step: number;
         action: string;
         config: unknown;
-        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "permission_denied" | "stale_ref" | "ambiguous" | "ref_not_found";
+        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "permission_denied" | "stale_ref" | "ambiguous" | "ref_not_found" | "unknown_action";
         url?: string;
         statusCode?: number;
         responsePreview?: string;
@@ -100,7 +111,7 @@ export declare class PipelineError extends Error {
         step: number;
         action: string;
         config: unknown;
-        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "permission_denied" | "stale_ref" | "ambiguous" | "ref_not_found";
+        errorType: "http_error" | "selector_miss" | "empty_result" | "parse_error" | "network_error" | "timeout" | "expression_error" | "assertion_failed" | "permission_denied" | "stale_ref" | "ambiguous" | "ref_not_found" | "unknown_action";
         url?: string;
         statusCode?: number;
         responsePreview?: string;

package/dist/engine/executor.d.ts.map

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