Skip to content

armgit / rea

Public Imported from GitHub
0

Reverse engineer anything with agents, from app behavior down to native binaries.

1.9 KB
Raw Blame
import type { AnalysisCleanupLease } from "../artifacts/AnalysisCleanupLease.js";
import type { BrowserScenario } from "../domain/browserScenario.js";
import type { BrowserScenarioAction } from "../domain/browserScenarioValues.js";
import type {
  BrowserScenarioEvent,
  BrowserScenarioEventOmissions,
  BrowserStepArtifacts,
} from "../domain/browserScenarioCaptureValues.js";
import type { SanitizedBrowserUrl } from "../domain/browserObservation.js";

type SnapshotKind = BrowserScenario["capture"]["after_each_step"][number];

export interface BrowserScenarioSessionPort {
  readonly mode: "launch" | "connect";
  readonly processOwnership: "provider-owned" | "external";
  readonly product: string;
  readonly version: string;
  readonly initialUrl: string;
  currentUrl(): string;
  sanitizeUrl(value: string): SanitizedBrowserUrl;
  setStep(index: number): void;
  nextEventSequence(): number;
  lastEventSequence(): number;
  events(): {
    readonly retained: number;
    readonly dropped: number;
    readonly items: readonly BrowserScenarioEvent[];
    readonly omissions: BrowserScenarioEventOmissions;
  };
  /** Gaps in selected event families that prevent complete capture claims. */
  eventLimitations?(): readonly string[];
  perform(action: BrowserScenarioAction, signal?: AbortSignal): Promise<void>;
  capture(
    requested: ReadonlySet<SnapshotKind>,
    signal?: AbortSignal,
  ): Promise<BrowserStepArtifacts>;
  readonly cleanupLease: AnalysisCleanupLease;
  close(): Promise<"terminated-owned-process" | "disconnected-external">;
  redactError(error: unknown): string;
}

/** Acquire one scenario session whose lifecycle the caller owns. */
export type BrowserScenarioSessionOpener = (
  scenario: BrowserScenario,
  options: {
    readonly signal?: AbortSignal;
    readonly retainCleanup?: (lease: AnalysisCleanupLease) => void;
  },
) => Promise<BrowserScenarioSessionPort>;