@opensteer/engine-abp 0.8.1 → 0.8.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/index.cjs +347 -249
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +19 -3
  4. package/dist/index.d.ts +19 -3
  5. package/dist/index.js +347 -249
  6. package/dist/index.js.map +1 -1
  7. package/package.json +3 -3
package/dist/index.d.cts CHANGED
@@ -753,6 +753,19 @@ interface BrowserInstrumentation {
753
753
  interface BrowserCoreEngine extends BrowserExecutor, BrowserInspector, SessionTransportExecutor, BrowserInstrumentation {
754
754
  }
755
755
 
756
+ interface ActionBoundarySnapshot {
757
+ readonly pageRef: PageRef;
758
+ readonly documentRef: DocumentRef;
759
+ }
760
+ type ActionBoundarySettleTrigger = "dom-action" | "navigation";
761
+ type ActionBoundaryTimedOutPhase = "bootstrap";
762
+ interface ActionBoundaryOutcome {
763
+ readonly trigger: ActionBoundarySettleTrigger;
764
+ readonly crossDocument: boolean;
765
+ readonly bootstrapSettled: boolean;
766
+ readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
767
+ }
768
+
756
769
  declare const opensteerComputerAnnotationNames: readonly ["clickable", "typeable", "scrollable", "grid", "selected"];
757
770
  type OpensteerComputerAnnotation = (typeof opensteerComputerAnnotationNames)[number];
758
771
  type OpensteerComputerMouseButton = "left" | "middle" | "right";
@@ -814,11 +827,12 @@ interface NormalizedComputerScreenshotOptions {
814
827
  }
815
828
  interface ComputerUseBridgeInput {
816
829
  readonly pageRef: PageRef;
830
+ readonly snapshot?: ActionBoundarySnapshot;
817
831
  readonly action: OpensteerComputerAction;
818
832
  readonly screenshot: NormalizedComputerScreenshotOptions;
819
833
  readonly signal: AbortSignal;
820
834
  remainingMs(): number | undefined;
821
- policySettle(pageRef: PageRef): Promise<void>;
835
+ policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger): Promise<void>;
822
836
  }
823
837
  interface ComputerUseBridgeOutput {
824
838
  readonly pageRef: PageRef;
@@ -826,6 +840,7 @@ interface ComputerUseBridgeOutput {
826
840
  readonly viewport: ViewportMetrics;
827
841
  readonly events: readonly StepEvent[];
828
842
  readonly timing: OpensteerComputerExecuteTiming;
843
+ readonly boundary?: ActionBoundaryOutcome;
829
844
  }
830
845
  interface ComputerUseBridge {
831
846
  execute(input: ComputerUseBridgeInput): Promise<ComputerUseBridgeOutput>;
@@ -886,9 +901,10 @@ interface DomActionKeyPressInput {
886
901
  }
887
902
  interface DomActionSettleOptions {
888
903
  readonly operation: "dom.click" | "dom.hover" | "dom.input" | "dom.scroll";
904
+ readonly snapshot?: ActionBoundarySnapshot;
889
905
  readonly signal: AbortSignal;
890
906
  remainingMs(): number | undefined;
891
- policySettle(pageRef: PageRef): Promise<void>;
907
+ policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger): Promise<void>;
892
908
  }
893
909
  type DomPointerHitRelation = "self" | "descendant" | "ancestor" | "same-owner" | "outside" | "unknown";
894
910
  interface DomPointerHitAssessment {
@@ -910,7 +926,7 @@ interface DomActionBridge {
910
926
  scrollNodeIntoView(locator: NodeLocator, options?: DomActionScrollOptions): Promise<void>;
911
927
  focusNode(locator: NodeLocator): Promise<void>;
912
928
  pressKey(locator: NodeLocator, input: DomActionKeyPressInput): Promise<void>;
913
- finalizeDomAction(pageRef: PageRef, options: DomActionSettleOptions): Promise<void>;
929
+ finalizeDomAction(pageRef: PageRef, options: DomActionSettleOptions): Promise<ActionBoundaryOutcome>;
914
930
  }
915
931
 
916
932
  interface AbpLaunchOptions {
package/dist/index.d.ts CHANGED
@@ -753,6 +753,19 @@ interface BrowserInstrumentation {
753
753
  interface BrowserCoreEngine extends BrowserExecutor, BrowserInspector, SessionTransportExecutor, BrowserInstrumentation {
754
754
  }
755
755
 
756
+ interface ActionBoundarySnapshot {
757
+ readonly pageRef: PageRef;
758
+ readonly documentRef: DocumentRef;
759
+ }
760
+ type ActionBoundarySettleTrigger = "dom-action" | "navigation";
761
+ type ActionBoundaryTimedOutPhase = "bootstrap";
762
+ interface ActionBoundaryOutcome {
763
+ readonly trigger: ActionBoundarySettleTrigger;
764
+ readonly crossDocument: boolean;
765
+ readonly bootstrapSettled: boolean;
766
+ readonly timedOutPhase?: ActionBoundaryTimedOutPhase;
767
+ }
768
+
756
769
  declare const opensteerComputerAnnotationNames: readonly ["clickable", "typeable", "scrollable", "grid", "selected"];
757
770
  type OpensteerComputerAnnotation = (typeof opensteerComputerAnnotationNames)[number];
758
771
  type OpensteerComputerMouseButton = "left" | "middle" | "right";
@@ -814,11 +827,12 @@ interface NormalizedComputerScreenshotOptions {
814
827
  }
815
828
  interface ComputerUseBridgeInput {
816
829
  readonly pageRef: PageRef;
830
+ readonly snapshot?: ActionBoundarySnapshot;
817
831
  readonly action: OpensteerComputerAction;
818
832
  readonly screenshot: NormalizedComputerScreenshotOptions;
819
833
  readonly signal: AbortSignal;
820
834
  remainingMs(): number | undefined;
821
- policySettle(pageRef: PageRef): Promise<void>;
835
+ policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger): Promise<void>;
822
836
  }
823
837
  interface ComputerUseBridgeOutput {
824
838
  readonly pageRef: PageRef;
@@ -826,6 +840,7 @@ interface ComputerUseBridgeOutput {
826
840
  readonly viewport: ViewportMetrics;
827
841
  readonly events: readonly StepEvent[];
828
842
  readonly timing: OpensteerComputerExecuteTiming;
843
+ readonly boundary?: ActionBoundaryOutcome;
829
844
  }
830
845
  interface ComputerUseBridge {
831
846
  execute(input: ComputerUseBridgeInput): Promise<ComputerUseBridgeOutput>;
@@ -886,9 +901,10 @@ interface DomActionKeyPressInput {
886
901
  }
887
902
  interface DomActionSettleOptions {
888
903
  readonly operation: "dom.click" | "dom.hover" | "dom.input" | "dom.scroll";
904
+ readonly snapshot?: ActionBoundarySnapshot;
889
905
  readonly signal: AbortSignal;
890
906
  remainingMs(): number | undefined;
891
- policySettle(pageRef: PageRef): Promise<void>;
907
+ policySettle(pageRef: PageRef, trigger: ActionBoundarySettleTrigger): Promise<void>;
892
908
  }
893
909
  type DomPointerHitRelation = "self" | "descendant" | "ancestor" | "same-owner" | "outside" | "unknown";
894
910
  interface DomPointerHitAssessment {
@@ -910,7 +926,7 @@ interface DomActionBridge {
910
926
  scrollNodeIntoView(locator: NodeLocator, options?: DomActionScrollOptions): Promise<void>;
911
927
  focusNode(locator: NodeLocator): Promise<void>;
912
928
  pressKey(locator: NodeLocator, input: DomActionKeyPressInput): Promise<void>;
913
- finalizeDomAction(pageRef: PageRef, options: DomActionSettleOptions): Promise<void>;
929
+ finalizeDomAction(pageRef: PageRef, options: DomActionSettleOptions): Promise<ActionBoundaryOutcome>;
914
930
  }
915
931
 
916
932
  interface AbpLaunchOptions {