@opentrons/shared-data 0.1.6-alpha.7 → 0.1.6-alpha.9

package/lib/command/types/gantry.d.ts

@@ -1,5 +1,6 @@
 import type { CommonCommandRunTimeInfo, CommonCommandCreateInfo } from '.';
 import type { AddressableAreaName } from '../../deck';
+import type { WellLocation } from './support';
 import type { Coordinates, MotorAxes, MotorAxis, GantryMount } from '../../js/types';
 export interface MoveToSlotCreateCommand extends CommonCommandCreateInfo {
     commandType: 'moveToSlot';
@@ -79,14 +80,7 @@ export interface MoveToWellParams {
     pipetteId: string;
     labwareId: string;
     wellName: string;
-    wellLocation?: {
-        origin?: 'top' | 'bottom';
-        offset?: {
-            x?: number;
-            y?: number;
-            z?: number;
-        };
-    };
+    wellLocation?: WellLocation;
     minimumZHeight?: number;
     forceDirect?: boolean;
 }

package/lib/command/types/incidental.d.ts

@@ -1,7 +1,7 @@
 import type { CommonCommandRunTimeInfo, CommonCommandCreateInfo } from '.';
 import type { StatusBarAnimation } from '../../js/types';
-export type IncidentalCreateCommand = SetStatusBarCreateCommand;
-export type IncidentalRunTimeCommand = SetStatusBarRunTimeCommand;
+export type IncidentalCreateCommand = SetStatusBarCreateCommand | SetRailLightsCreateCommand;
+export type IncidentalRunTimeCommand = SetStatusBarRunTimeCommand | SetRailLightsRunTimeCommand;
 export interface SetStatusBarCreateCommand extends CommonCommandCreateInfo {
     commandType: 'setStatusBar';
     params: SetStatusBarParams;
@@ -12,4 +12,14 @@ export interface SetStatusBarRunTimeCommand extends CommonCommandRunTimeInfo, Se
 interface SetStatusBarParams {
     animation: StatusBarAnimation;
 }
+export interface SetRailLightsCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'setRailLights';
+    params: SetRailLightsParams;
+}
+export interface SetRailLightsRunTimeCommand extends CommonCommandRunTimeInfo, SetRailLightsCreateCommand {
+    result?: any;
+}
+interface SetRailLightsParams {
+    on: boolean;
+}
 export {};

package/lib/command/types/index.d.ts

@@ -1,3 +1,4 @@
+import type { ErrorCodes } from '../../errors';
 import type { PipettingRunTimeCommand, PipettingCreateCommand } from './pipetting';
 import type { GantryRunTimeCommand, GantryCreateCommand } from './gantry';
 import type { ModuleRunTimeCommand, ModuleCreateCommand } from './module';
@@ -6,6 +7,7 @@ import type { TimingRunTimeCommand, TimingCreateCommand } from './timing';
 import type { IncidentalCreateCommand, IncidentalRunTimeCommand } from './incidental';
 import type { AnnotationRunTimeCommand, AnnotationCreateCommand } from './annotation';
 import type { CalibrationRunTimeCommand, CalibrationCreateCommand } from './calibration';
+import type { UnsafeRunTimeCommand, UnsafeCreateCommand } from './unsafe';
 export * from './annotation';
 export * from './calibration';
 export * from './gantry';
@@ -14,6 +16,7 @@ export * from './module';
 export * from './pipetting';
 export * from './setup';
 export * from './timing';
+export * from './unsafe';
 export interface CommandNote {
     noteKind: 'warning' | 'information' | string;
     shortMessage: string;
@@ -21,6 +24,7 @@ export interface CommandNote {
     source: string;
 }
 export type CommandStatus = 'queued' | 'running' | 'succeeded' | 'failed';
+export type CommandIntent = 'protocol' | 'setup' | 'fixit';
 export interface CommonCommandRunTimeInfo {
     key?: string;
     id: string;
@@ -29,20 +33,37 @@ export interface CommonCommandRunTimeInfo {
     createdAt: string;
     startedAt: string | null;
     completedAt: string | null;
-    intent?: 'protocol' | 'setup';
+    intent?: CommandIntent;
     notes?: CommandNote[] | null;
+    failedCommandId?: string;
 }
 export interface CommonCommandCreateInfo {
+    intent?: CommandIntent;
     key?: string;
     meta?: {
         [key: string]: any;
     };
 }
-export type CreateCommand = PipettingCreateCommand | GantryCreateCommand | ModuleCreateCommand | SetupCreateCommand | TimingCreateCommand | CalibrationCreateCommand | AnnotationCreateCommand | IncidentalCreateCommand;
-export type RunTimeCommand = PipettingRunTimeCommand | GantryRunTimeCommand | ModuleRunTimeCommand | SetupRunTimeCommand | TimingRunTimeCommand | CalibrationRunTimeCommand | AnnotationRunTimeCommand | IncidentalRunTimeCommand;
-interface RunCommandError {
-    id: string;
-    errorType: string;
+export type CreateCommand = PipettingCreateCommand | GantryCreateCommand | ModuleCreateCommand | SetupCreateCommand | TimingCreateCommand | CalibrationCreateCommand | AnnotationCreateCommand | IncidentalCreateCommand | UnsafeCreateCommand;
+export type RunTimeCommand = PipettingRunTimeCommand | GantryRunTimeCommand | ModuleRunTimeCommand | SetupRunTimeCommand | TimingRunTimeCommand | CalibrationRunTimeCommand | AnnotationRunTimeCommand | IncidentalRunTimeCommand | UnsafeRunTimeCommand;
+export type RunCommandError = RunCommandErrorUndefined | RunCommandErrorOverpressure;
+export interface RunCommandErrorBase {
     createdAt: string;
     detail: string;
+    id: string;
+    wrappedErrors?: RunCommandError[];
+}
+export interface RunCommandErrorUndefined extends RunCommandErrorBase {
+    errorCode: ErrorCodes;
+    errorType: string;
+    isDefined: false;
+    errorInfo?: Record<string, unknown>;
+}
+export interface RunCommandErrorOverpressure extends RunCommandErrorBase {
+    errorCode: '3006';
+    errorType: 'overpressure';
+    isDefined: true;
+    errorInfo: {
+        retryLocation: [number, number, number];
+    };
 }

package/lib/command/types/module.d.ts

@@ -1,6 +1,6 @@
 import type { CommonCommandRunTimeInfo, CommonCommandCreateInfo } from '.';
-export type ModuleRunTimeCommand = MagneticModuleEngageMagnetRunTimeCommand | MagneticModuleDisengageRunTimeCommand | TemperatureModuleSetTargetTemperatureRunTimeCommand | TemperatureModuleDeactivateRunTimeCommand | TemperatureModuleAwaitTemperatureRunTimeCommand | TCSetTargetBlockTemperatureRunTimeCommand | TCSetTargetLidTemperatureRunTimeCommand | TCWaitForBlockTemperatureRunTimeCommand | TCWaitForLidTemperatureRunTimeCommand | TCOpenLidRunTimeCommand | TCCloseLidRunTimeCommand | TCDeactivateBlockRunTimeCommand | TCDeactivateLidRunTimeCommand | TCRunProfileRunTimeCommand | TCAwaitProfileCompleteRunTimeCommand | HeaterShakerSetTargetTemperatureRunTimeCommand | HeaterShakerWaitForTemperatureRunTimeCommand | HeaterShakerSetAndWaitForShakeSpeedRunTimeCommand | HeaterShakerOpenLatchRunTimeCommand | HeaterShakerCloseLatchRunTimeCommand | HeaterShakerDeactivateHeaterRunTimeCommand | HeaterShakerDeactivateShakerRunTimeCommand;
-export type ModuleCreateCommand = MagneticModuleEngageMagnetCreateCommand | MagneticModuleDisengageCreateCommand | TemperatureModuleSetTargetTemperatureCreateCommand | TemperatureModuleDeactivateCreateCommand | TemperatureModuleAwaitTemperatureCreateCommand | TCSetTargetBlockTemperatureCreateCommand | TCSetTargetLidTemperatureCreateCommand | TCWaitForBlockTemperatureCreateCommand | TCWaitForLidTemperatureCreateCommand | TCOpenLidCreateCommand | TCCloseLidCreateCommand | TCDeactivateBlockCreateCommand | TCDeactivateLidCreateCommand | TCRunProfileCreateCommand | TCAwaitProfileCompleteCreateCommand | HeaterShakerWaitForTemperatureCreateCommand | HeaterShakerSetAndWaitForShakeSpeedCreateCommand | HeaterShakerOpenLatchCreateCommand | HeaterShakerCloseLatchCreateCommand | HeaterShakerDeactivateHeaterCreateCommand | HeaterShakerDeactivateShakerCreateCommand | HeaterShakerSetTargetTemperatureCreateCommand;
+export type ModuleRunTimeCommand = MagneticModuleEngageMagnetRunTimeCommand | MagneticModuleDisengageRunTimeCommand | TemperatureModuleSetTargetTemperatureRunTimeCommand | TemperatureModuleDeactivateRunTimeCommand | TemperatureModuleAwaitTemperatureRunTimeCommand | TCSetTargetBlockTemperatureRunTimeCommand | TCSetTargetLidTemperatureRunTimeCommand | TCWaitForBlockTemperatureRunTimeCommand | TCWaitForLidTemperatureRunTimeCommand | TCOpenLidRunTimeCommand | TCCloseLidRunTimeCommand | TCDeactivateBlockRunTimeCommand | TCDeactivateLidRunTimeCommand | TCRunProfileRunTimeCommand | TCRunExtendedProfileRunTimeCommand | TCAwaitProfileCompleteRunTimeCommand | HeaterShakerSetTargetTemperatureRunTimeCommand | HeaterShakerWaitForTemperatureRunTimeCommand | HeaterShakerSetAndWaitForShakeSpeedRunTimeCommand | HeaterShakerOpenLatchRunTimeCommand | HeaterShakerCloseLatchRunTimeCommand | HeaterShakerDeactivateHeaterRunTimeCommand | HeaterShakerDeactivateShakerRunTimeCommand | AbsorbanceReaderOpenLidRunTimeCommand | AbsorbanceReaderCloseLidRunTimeCommand | AbsorbanceReaderInitializeRunTimeCommand | AbsorbanceReaderReadRunTimeCommand;
+export type ModuleCreateCommand = MagneticModuleEngageMagnetCreateCommand | MagneticModuleDisengageCreateCommand | TemperatureModuleSetTargetTemperatureCreateCommand | TemperatureModuleDeactivateCreateCommand | TemperatureModuleAwaitTemperatureCreateCommand | TCSetTargetBlockTemperatureCreateCommand | TCSetTargetLidTemperatureCreateCommand | TCWaitForBlockTemperatureCreateCommand | TCWaitForLidTemperatureCreateCommand | TCOpenLidCreateCommand | TCCloseLidCreateCommand | TCDeactivateBlockCreateCommand | TCDeactivateLidCreateCommand | TCRunProfileCreateCommand | TCRunExtendedProfileCreateCommand | TCAwaitProfileCompleteCreateCommand | HeaterShakerWaitForTemperatureCreateCommand | HeaterShakerSetAndWaitForShakeSpeedCreateCommand | HeaterShakerOpenLatchCreateCommand | HeaterShakerCloseLatchCreateCommand | HeaterShakerDeactivateHeaterCreateCommand | HeaterShakerDeactivateShakerCreateCommand | HeaterShakerSetTargetTemperatureCreateCommand | AbsorbanceReaderOpenLidCreateCommand | AbsorbanceReaderCloseLidCreateCommand | AbsorbanceReaderInitializeCreateCommand | AbsorbanceReaderReadCreateCommand;
 export interface MagneticModuleEngageMagnetCreateCommand extends CommonCommandCreateInfo {
     commandType: 'magneticModule/engage';
     params: EngageMagnetParams;
@@ -103,6 +103,13 @@ export interface TCRunProfileCreateCommand extends CommonCommandCreateInfo {
 export interface TCRunProfileRunTimeCommand extends CommonCommandRunTimeInfo, TCRunProfileCreateCommand {
     result?: any;
 }
+export interface TCRunExtendedProfileCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'thermocycler/runExtendedProfile';
+    params: TCExtendedProfileParams;
+}
+export interface TCRunExtendedProfileRunTimeCommand extends CommonCommandRunTimeInfo, TCRunExtendedProfileCreateCommand {
+    result?: any;
+}
 export interface TCAwaitProfileCompleteCreateCommand extends CommonCommandCreateInfo {
     commandType: 'thermocycler/awaitProfileComplete';
     params: ModuleOnlyParams;
@@ -159,10 +166,44 @@ export interface HeaterShakerDeactivateShakerCreateCommand extends CommonCommand
 export interface HeaterShakerDeactivateShakerRunTimeCommand extends CommonCommandRunTimeInfo, HeaterShakerDeactivateShakerCreateCommand {
     result?: any;
 }
+export interface AbsorbanceReaderOpenLidRunTimeCommand extends CommonCommandRunTimeInfo, AbsorbanceReaderOpenLidCreateCommand {
+    result?: any;
+}
+export interface AbsorbanceReaderCloseLidRunTimeCommand extends CommonCommandRunTimeInfo, AbsorbanceReaderCloseLidCreateCommand {
+    result?: any;
+}
+export interface AbsorbanceReaderInitializeRunTimeCommand extends CommonCommandRunTimeInfo, AbsorbanceReaderInitializeCreateCommand {
+    result?: any;
+}
+export interface AbsorbanceReaderReadRunTimeCommand extends CommonCommandRunTimeInfo, AbsorbanceReaderReadCreateCommand {
+    result?: any;
+}
+export interface AbsorbanceReaderOpenLidCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'absorbanceReader/openLid';
+    params: ModuleOnlyParams;
+}
+export interface AbsorbanceReaderCloseLidCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'absorbanceReader/closeLid';
+    params: ModuleOnlyParams;
+}
+export interface AbsorbanceReaderInitializeCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'absorbanceReader/initialize';
+    params: AbsorbanceReaderInitializeParams;
+}
+export interface AbsorbanceReaderReadCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'absorbanceReader/read';
+    params: ModuleOnlyParams;
+}
 export interface EngageMagnetParams {
     moduleId: string;
     height: number;
 }
+export interface AbsorbanceReaderInitializeParams {
+    moduleId: string;
+    measureMode: 'single' | 'multi';
+    sampleWavelengths: number[];
+    referenceWavelength?: number;
+}
 export interface TemperatureParams {
     moduleId: string;
     celsius: number;
@@ -189,3 +230,12 @@ export interface ThermocyclerSetTargetBlockTemperatureParams {
     volume?: number;
     holdTimeSeconds?: number;
 }
+export interface TCProfileCycle {
+    steps: AtomicProfileStep[];
+    repetitions: number;
+}
+export interface TCExtendedProfileParams {
+    moduleId: string;
+    profileElements: Array<TCProfileCycle | AtomicProfileStep>;
+    blockMaxVolumeUl?: number;
+}

package/lib/command/types/pipetting.d.ts

@@ -1,7 +1,8 @@
 import type { AddressableAreaName } from '../../deck';
 import type { CommonCommandRunTimeInfo, CommonCommandCreateInfo } from '.';
-export type PipettingRunTimeCommand = AspirateInPlaceRunTimeCommand | AspirateInPlaceRunTimeCommand | AspirateRunTimeCommand | BlowoutInPlaceRunTimeCommand | BlowoutRunTimeCommand | ConfigureForVolumeRunTimeCommand | DispenseInPlaceRunTimeCommand | DispenseRunTimeCommand | DropTipInPlaceRunTimeCommand | DropTipRunTimeCommand | GetTipPresenceRunTimeCommand | MoveToAddressableAreaForDropTipRunTimeCommand | PickUpTipRunTimeCommand | PrepareToAspirateRunTimeCommand | TouchTipRunTimeCommand | VerifyTipPresenceRunTimeCommand;
-export type PipettingCreateCommand = AspirateCreateCommand | AspirateInPlaceCreateCommand | BlowoutCreateCommand | BlowoutInPlaceCreateCommand | ConfigureForVolumeCreateCommand | DispenseCreateCommand | DispenseInPlaceCreateCommand | DropTipCreateCommand | DropTipInPlaceCreateCommand | GetTipPresenceCreateCommand | MoveToAddressableAreaForDropTipCreateCommand | PickUpTipCreateCommand | PrepareToAspirateCreateCommand | TouchTipCreateCommand | VerifyTipPresenceCreateCommand;
+import type { DropTipWellLocation, WellLocation } from './support';
+export type PipettingRunTimeCommand = AspirateInPlaceRunTimeCommand | AspirateInPlaceRunTimeCommand | AspirateRunTimeCommand | BlowoutInPlaceRunTimeCommand | BlowoutRunTimeCommand | ConfigureForVolumeRunTimeCommand | DispenseInPlaceRunTimeCommand | DispenseRunTimeCommand | DropTipInPlaceRunTimeCommand | DropTipRunTimeCommand | GetTipPresenceRunTimeCommand | MoveToAddressableAreaForDropTipRunTimeCommand | PickUpTipRunTimeCommand | PrepareToAspirateRunTimeCommand | TouchTipRunTimeCommand | VerifyTipPresenceRunTimeCommand | LiquidProbeRunTimeCommand | TryLiquidProbeRunTimeCommand | AirGapInPlaceRunTimeCommand;
+export type PipettingCreateCommand = AspirateCreateCommand | AspirateInPlaceCreateCommand | BlowoutCreateCommand | BlowoutInPlaceCreateCommand | ConfigureForVolumeCreateCommand | DispenseCreateCommand | DispenseInPlaceCreateCommand | DropTipCreateCommand | DropTipInPlaceCreateCommand | GetTipPresenceCreateCommand | MoveToAddressableAreaForDropTipCreateCommand | PickUpTipCreateCommand | PrepareToAspirateCreateCommand | TouchTipCreateCommand | VerifyTipPresenceCreateCommand | LiquidProbeCreateCommand | TryLiquidProbeCreateCommand | AirGapInPlaceCreateCommand;
 export interface ConfigureForVolumeCreateCommand extends CommonCommandCreateInfo {
     commandType: 'configureForVolume';
     params: ConfigureForVolumeParams;
@@ -13,6 +14,14 @@ export interface ConfigureForVolumeParams {
 export interface ConfigureForVolumeRunTimeCommand extends CommonCommandRunTimeInfo, ConfigureForVolumeCreateCommand {
     result?: BasicLiquidHandlingResult;
 }
+export type AirGapInPlaceParams = FlowRateParams & PipetteIdentityParams & VolumeParams;
+export interface AirGapInPlaceCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'airGapInPlace';
+    params: AirGapInPlaceParams;
+}
+export interface AirGapInPlaceRunTimeCommand extends CommonCommandRunTimeInfo, AirGapInPlaceCreateCommand {
+    result?: BasicLiquidHandlingResult;
+}
 export interface AspirateCreateCommand extends CommonCommandCreateInfo {
     commandType: 'aspirate';
     params: AspDispAirgapParams;
@@ -114,19 +123,24 @@ export interface VerifyTipPresenceCreateCommand extends CommonCommandCreateInfo
 export interface VerifyTipPresenceRunTimeCommand extends CommonCommandRunTimeInfo, VerifyTipPresenceCreateCommand {
     result?: any;
 }
+export interface LiquidProbeCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'liquidProbe';
+    params: WellLocationParam & PipetteAccessParams;
+}
+export interface LiquidProbeRunTimeCommand extends CommonCommandRunTimeInfo, LiquidProbeCreateCommand {
+    result?: Record<string, unknown>;
+}
+export interface TryLiquidProbeCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'tryLiquidProbe';
+    params: WellLocationParam & PipetteAccessParams;
+}
+export interface TryLiquidProbeRunTimeCommand extends CommonCommandRunTimeInfo, TryLiquidProbeCreateCommand {
+    result?: Record<string, unknown>;
+}
 export type AspDispAirgapParams = FlowRateParams & PipetteAccessParams & VolumeParams & WellLocationParam;
 export type BlowoutParams = FlowRateParams & PipetteAccessParams & WellLocationParam;
 export type TouchTipParams = PipetteAccessParams & WellLocationParam;
-export type DropTipParams = PipetteAccessParams & {
-    wellLocation?: {
-        origin?: 'default' | 'top' | 'center' | 'bottom';
-        offset?: {
-            x?: number;
-            y?: number;
-            z?: number;
-        };
-    };
-};
+export type DropTipParams = PipetteAccessParams & DropTipWellLocationParam;
 export type PickUpTipParams = TouchTipParams;
 interface AddressableOffsetVector {
     x: number;
@@ -174,14 +188,10 @@ interface VolumeParams {
     volume: number;
 }
 interface WellLocationParam {
-    wellLocation?: {
-        origin?: 'top' | 'center' | 'bottom';
-        offset?: {
-            x?: number;
-            y?: number;
-            z?: number;
-        };
-    };
+    wellLocation?: WellLocation;
+}
+interface DropTipWellLocationParam {
+    wellLocation?: DropTipWellLocation;
 }
 interface VerifyTipPresenceParams extends PipetteIdentityParams {
     expectedState?: 'present' | 'absent';

package/lib/command/types/setup.d.ts

@@ -16,6 +16,15 @@ export interface LoadLabwareCreateCommand extends CommonCommandCreateInfo {
 export interface LoadLabwareRunTimeCommand extends CommonCommandRunTimeInfo, LoadLabwareCreateCommand {
     result?: LoadLabwareResult;
 }
+export interface ReloadLabwareCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'reloadLabware';
+    params: {
+        labwareId: string;
+    };
+}
+export interface ReloadLabwareRunTimeCommand extends CommonCommandRunTimeInfo, ReloadLabwareCreateCommand {
+    result?: ReloadLabwareResult;
+}
 export interface MoveLabwareCreateCommand extends CommonCommandCreateInfo {
     commandType: 'moveLabware';
     params: MoveLabwareParams;
@@ -47,8 +56,8 @@ export interface ConfigureNozzleLayoutCreateCommand extends CommonCommandCreateI
 export interface ConfigureNozzleLayoutRunTimeCommand extends CommonCommandRunTimeInfo, ConfigureNozzleLayoutCreateCommand {
     result?: {};
 }
-export type SetupRunTimeCommand = ConfigureNozzleLayoutRunTimeCommand | LoadPipetteRunTimeCommand | LoadLabwareRunTimeCommand | LoadModuleRunTimeCommand | LoadLiquidRunTimeCommand | MoveLabwareRunTimeCommand;
-export type SetupCreateCommand = ConfigureNozzleLayoutCreateCommand | LoadPipetteCreateCommand | LoadLabwareCreateCommand | LoadModuleCreateCommand | LoadLiquidCreateCommand | MoveLabwareCreateCommand;
+export type SetupRunTimeCommand = ConfigureNozzleLayoutRunTimeCommand | LoadPipetteRunTimeCommand | LoadLabwareRunTimeCommand | ReloadLabwareRunTimeCommand | LoadModuleRunTimeCommand | LoadLiquidRunTimeCommand | MoveLabwareRunTimeCommand;
+export type SetupCreateCommand = ConfigureNozzleLayoutCreateCommand | LoadPipetteCreateCommand | LoadLabwareCreateCommand | ReloadLabwareCreateCommand | LoadModuleCreateCommand | LoadLiquidCreateCommand | MoveLabwareCreateCommand;
 export type LabwareLocation = 'offDeck' | {
     slotName: string;
 } | {
@@ -58,6 +67,15 @@ export type LabwareLocation = 'offDeck' | {
 } | {
     addressableAreaName: AddressableAreaName;
 };
+export type OnDeckLabwareLocation = {
+    slotName: string;
+} | {
+    moduleId: string;
+} | {
+    labwareId: string;
+} | {
+    addressableAreaName: AddressableAreaName;
+};
 export type NonStackedLocation = 'offDeck' | {
     slotName: string;
 } | {
@@ -89,6 +107,10 @@ interface LoadLabwareResult {
     definition: LabwareDefinition2;
     offset: LabwareOffset;
 }
+interface ReloadLabwareResult {
+    labwareId: string;
+    offsetId?: string | null;
+}
 export type LabwareMovementStrategy = 'usingGripper' | 'manualMoveWithPause' | 'manualMoveWithoutPause';
 export interface MoveLabwareParams {
     labwareId: string;
@@ -117,9 +139,9 @@ interface LoadLiquidResult {
     liquidId: string;
 }
 export declare const COLUMN = "COLUMN";
-declare const SINGLE = "SINGLE";
-declare const ROW = "ROW";
-declare const QUADRANT = "QUADRANT";
+export declare const SINGLE = "SINGLE";
+export declare const ROW = "ROW";
+export declare const QUADRANT = "QUADRANT";
 export declare const ALL = "ALL";
 export type NozzleConfigurationStyle = typeof COLUMN | typeof SINGLE | typeof ROW | typeof QUADRANT | typeof ALL;
 interface NozzleConfigurationParams {

package/lib/command/types/support.d.ts

@@ -0,0 +1,17 @@
+type BaseWellOrigin = 'top' | 'bottom' | 'center';
+export type WellOrigin = BaseWellOrigin | 'meniscus';
+export interface WellOffset {
+    x?: number;
+    y?: number;
+    z?: number;
+}
+export interface WellLocation {
+    origin?: WellOrigin;
+    offset?: WellOffset;
+}
+export type DropTipWellOrigin = BaseWellOrigin | 'default';
+export interface DropTipWellLocation {
+    origin?: DropTipWellOrigin;
+    offset?: WellOffset;
+}
+export {};

package/lib/command/types/unsafe.d.ts

@@ -0,0 +1,63 @@
+import type { CommonCommandRunTimeInfo, CommonCommandCreateInfo, OnDeckLabwareLocation } from '.';
+import type { MotorAxes } from '../../js/types';
+export type UnsafeRunTimeCommand = UnsafeBlowoutInPlaceRunTimeCommand | UnsafeDropTipInPlaceRunTimeCommand | UnsafeUpdatePositionEstimatorsRunTimeCommand | UnsafeEngageAxesRunTimeCommand | UnsafeUngripLabwareRunTimeCommand | UnsafePlaceLabwareRunTimeCommand;
+export type UnsafeCreateCommand = UnsafeBlowoutInPlaceCreateCommand | UnsafeDropTipInPlaceCreateCommand | UnsafeUpdatePositionEstimatorsCreateCommand | UnsafeEngageAxesCreateCommand | UnsafeUngripLabwareCreateCommand | UnsafePlaceLabwareCreateCommand;
+export interface UnsafeBlowoutInPlaceParams {
+    pipetteId: string;
+    flowRate: number;
+}
+export interface UnsafeBlowoutInPlaceCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'unsafe/blowOutInPlace';
+    params: UnsafeBlowoutInPlaceParams;
+}
+export interface UnsafeBlowoutInPlaceRunTimeCommand extends CommonCommandRunTimeInfo, UnsafeBlowoutInPlaceCreateCommand {
+    result?: {};
+}
+export interface UnsafeDropTipInPlaceParams {
+    pipetteId: string;
+}
+export interface UnsafeDropTipInPlaceCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'unsafe/dropTipInPlace';
+    params: UnsafeDropTipInPlaceParams;
+}
+export interface UnsafeDropTipInPlaceRunTimeCommand extends CommonCommandRunTimeInfo, UnsafeDropTipInPlaceCreateCommand {
+    result?: any;
+}
+export interface UnsafeUpdatePositionEstimatorsParams {
+    axes: MotorAxes;
+}
+export interface UnsafeUpdatePositionEstimatorsCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'unsafe/updatePositionEstimators';
+    params: UnsafeUpdatePositionEstimatorsParams;
+}
+export interface UnsafeUpdatePositionEstimatorsRunTimeCommand extends CommonCommandRunTimeInfo, UnsafeUpdatePositionEstimatorsCreateCommand {
+    result?: any;
+}
+export interface UnsafeEngageAxesParams {
+    axes: MotorAxes;
+}
+export interface UnsafeEngageAxesCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'unsafe/engageAxes';
+    params: UnsafeUpdatePositionEstimatorsParams;
+}
+export interface UnsafeEngageAxesRunTimeCommand extends CommonCommandRunTimeInfo, UnsafeEngageAxesCreateCommand {
+    result?: any;
+}
+export interface UnsafeUngripLabwareCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'unsafe/ungripLabware';
+    params: {};
+}
+export interface UnsafeUngripLabwareRunTimeCommand extends CommonCommandRunTimeInfo, UnsafeUngripLabwareCreateCommand {
+    result?: any;
+}
+export interface UnsafePlaceLabwareParams {
+    labwareId: string;
+    location: OnDeckLabwareLocation;
+}
+export interface UnsafePlaceLabwareCreateCommand extends CommonCommandCreateInfo {
+    commandType: 'unsafe/placeLabware';
+    params: UnsafePlaceLabwareParams;
+}
+export interface UnsafePlaceLabwareRunTimeCommand extends CommonCommandRunTimeInfo, UnsafePlaceLabwareCreateCommand {
+    result?: any;
+}

package/lib/deck/definitions/4/ot2_standard.json

@@ -8,7 +8,12 @@
         "tags": ["ot2", "12 slots", "standard"]
     },
     "robot": {
-        "model": "OT-2 Standard"
+        "model": "OT-2 Standard",
+        "extents": [446.75, 347.5, 0.0],
+        "mountOffsets": {
+            "left": [-34, 0.0, 0.0],
+            "right": [0.0, 0.0, 0.0]
+        }
     },
     "locations": {
         "addressableAreas": [

package/lib/deck/definitions/5/ot3_standard.json

@@ -672,6 +672,94 @@
                     "zDimension": 0
                 },
                 "displayName": "Magnetic Block in A3"
+            },
+            {
+                "id": "absorbanceReaderV1D3",
+                "areaType": "absorbanceReader",
+                "offsetFromCutoutFixture": [2.0, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader in D3"
+            },
+            {
+                "id": "absorbanceReaderV1C3",
+                "areaType": "absorbanceReader",
+                "offsetFromCutoutFixture": [2.0, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader in C3"
+            },
+            {
+                "id": "absorbanceReaderV1B3",
+                "areaType": "absorbanceReader",
+                "offsetFromCutoutFixture": [2.0, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader in B3"
+            },
+            {
+                "id": "absorbanceReaderV1A3",
+                "areaType": "absorbanceReader",
+                "offsetFromCutoutFixture": [2.0, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader in A3"
+            },
+            {
+                "id": "absorbanceReaderV1LidDockD4",
+                "areaType": "lidDock",
+                "offsetFromCutoutFixture": [163.075, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader Lid Dock in D4"
+            },
+            {
+                "id": "absorbanceReaderV1LidDockC4",
+                "areaType": "lidDock",
+                "offsetFromCutoutFixture": [163.075, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader Lid Dock in C4"
+            },
+            {
+                "id": "absorbanceReaderV1LidDockB4",
+                "areaType": "lidDock",
+                "offsetFromCutoutFixture": [163.075, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader Lid Dock in B4"
+            },
+            {
+                "id": "absorbanceReaderV1LidDockA4",
+                "areaType": "lidDock",
+                "offsetFromCutoutFixture": [163.075, 0.0, 0.65],
+                "boundingBox": {
+                    "xDimension": 127.8,
+                    "yDimension": 85.5,
+                    "zDimension": 0
+                },
+                "displayName": "Absorbance Reader Lid Dock in A4"
             }
         ],
         "cutouts": [
@@ -743,6 +831,30 @@
                 "slot": "A3",
                 "labware": "opentrons_1_trash_3200ml_fixed",
                 "displayName": "Fixed Trash"
+            },
+            {
+                "id": "absorbanceReaderV1LidA3",
+                "slot": "absorbanceReaderV1A3",
+                "labware": "opentrons_flex_lid_absorbance_plate_reader_module",
+                "displayName": "Plate Reader Lid"
+            },
+            {
+                "id": "absorbanceReaderV1LidB3",
+                "slot": "absorbanceReaderV1B3",
+                "labware": "opentrons_flex_lid_absorbance_plate_reader_module",
+                "displayName": "Plate Reader Lid"
+            },
+            {
+                "id": "absorbanceReaderV1LidC3",
+                "slot": "absorbanceReaderV1C3",
+                "labware": "opentrons_flex_lid_absorbance_plate_reader_module",
+                "displayName": "Plate Reader Lid"
+            },
+            {
+                "id": "absorbanceReaderV1LidD3",
+                "slot": "absorbanceReaderV1D3",
+                "labware": "opentrons_flex_lid_absorbance_plate_reader_module",
+                "displayName": "Plate Reader Lid"
             }
         ]
     },
@@ -1023,6 +1135,20 @@
             },
             "fixtureGroup": {},
             "height": 38.0
+        },
+        {
+            "id": "absorbanceReaderV1",
+            "expectOpentronsModuleSerialNumber": true,
+            "mayMountTo": ["cutoutD3", "cutoutC3", "cutoutB3", "cutoutA3"],
+            "displayName": "Slot With an Absorbance Reader and a Lid Dock",
+            "providesAddressableAreas": {
+                "cutoutD3": ["absorbanceReaderV1D3", "absorbanceReaderV1LidDockD4"],
+                "cutoutC3": ["absorbanceReaderV1C3", "absorbanceReaderV1LidDockC4"],
+                "cutoutB3": ["absorbanceReaderV1B3", "absorbanceReaderV1LidDockB4"],
+                "cutoutA3": ["absorbanceReaderV1A3", "absorbanceReaderV1LidDockA4"]
+            },
+            "fixtureGroup": {},
+            "height": 10.65
         }
     ],
     "gripperOffsets": {

package/lib/deck/schemas/5.json

@@ -141,7 +141,8 @@
                                     "stagingSlot",
                                     "movableTrash",
                                     "fixedTrash",
-                                    "wasteChute"
+                                    "wasteChute",
+                                    "lidDock"
                                 ]
                             },
                             "offsetFromCutoutFixture": {
@@ -223,7 +224,7 @@
                 },
                 "legacyFixtures": {
                     "type": "array",
-                    "description": "Fixed position objects on the deck.",
+                    "description": "Fixed position objects on the deck and fixture-dependant Module labware Eg Plate Reader Lid.",
                     "items": {
                         "type": "object",
                         "required": ["id", "displayName"],

package/lib/deck/types/schemaV5.d.ts

@@ -1,4 +1,4 @@
-export type FlexAddressableAreaName = 'A1' | 'B1' | 'C1' | 'D1' | 'A2' | 'B2' | 'C2' | 'D2' | 'A3' | 'B3' | 'C3' | 'D3' | 'A4' | 'B4' | 'C4' | 'D4' | 'movableTrashA1' | 'movableTrashB1' | 'movableTrashC1' | 'movableTrashD1' | 'movableTrashA3' | 'movableTrashB3' | 'movableTrashC3' | 'movableTrashD3' | '1ChannelWasteChute' | '8ChannelWasteChute' | '96ChannelWasteChute' | 'gripperWasteChute' | 'thermocyclerModuleV2' | 'heaterShakerV1A1' | 'heaterShakerV1B1' | 'heaterShakerV1C1' | 'heaterShakerV1D1' | 'heaterShakerV1A3' | 'heaterShakerV1B3' | 'heaterShakerV1C3' | 'heaterShakerV1D3' | 'temperatureModuleV2A1' | 'temperatureModuleV2B1' | 'temperatureModuleV2C1' | 'temperatureModuleV2D1' | 'temperatureModuleV2A3' | 'temperatureModuleV2B3' | 'temperatureModuleV2C3' | 'temperatureModuleV2D3' | 'magneticBlockV1A1' | 'magneticBlockV1B1' | 'magneticBlockV1C1' | 'magneticBlockV1D1' | 'magneticBlockV1A2' | 'magneticBlockV1B2' | 'magneticBlockV1C2' | 'magneticBlockV1D2' | 'magneticBlockV1A3' | 'magneticBlockV1B3' | 'magneticBlockV1C3' | 'magneticBlockV1D3';
+export type FlexAddressableAreaName = 'A1' | 'B1' | 'C1' | 'D1' | 'A2' | 'B2' | 'C2' | 'D2' | 'A3' | 'B3' | 'C3' | 'D3' | 'A4' | 'B4' | 'C4' | 'D4' | 'movableTrashA1' | 'movableTrashB1' | 'movableTrashC1' | 'movableTrashD1' | 'movableTrashA3' | 'movableTrashB3' | 'movableTrashC3' | 'movableTrashD3' | '1ChannelWasteChute' | '8ChannelWasteChute' | '96ChannelWasteChute' | 'gripperWasteChute' | 'thermocyclerModuleV2' | 'heaterShakerV1A1' | 'heaterShakerV1B1' | 'heaterShakerV1C1' | 'heaterShakerV1D1' | 'heaterShakerV1A3' | 'heaterShakerV1B3' | 'heaterShakerV1C3' | 'heaterShakerV1D3' | 'temperatureModuleV2A1' | 'temperatureModuleV2B1' | 'temperatureModuleV2C1' | 'temperatureModuleV2D1' | 'temperatureModuleV2A3' | 'temperatureModuleV2B3' | 'temperatureModuleV2C3' | 'temperatureModuleV2D3' | 'magneticBlockV1A1' | 'magneticBlockV1B1' | 'magneticBlockV1C1' | 'magneticBlockV1D1' | 'magneticBlockV1A2' | 'magneticBlockV1B2' | 'magneticBlockV1C2' | 'magneticBlockV1D2' | 'magneticBlockV1A3' | 'magneticBlockV1B3' | 'magneticBlockV1C3' | 'magneticBlockV1D3' | 'absorbanceReaderV1A3' | 'absorbanceReaderV1B3' | 'absorbanceReaderV1C3' | 'absorbanceReaderV1D3' | 'absorbanceReaderV1LidDockA4' | 'absorbanceReaderV1LidDockB4' | 'absorbanceReaderV1LidDockC4' | 'absorbanceReaderV1LidDockD4';
 export type OT2AddressableAreaName = '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | 'fixedTrash';
 export type AddressableAreaName = FlexAddressableAreaName | OT2AddressableAreaName;
 export type CutoutId = 'cutoutD1' | 'cutoutD2' | 'cutoutD3' | 'cutoutC1' | 'cutoutC2' | 'cutoutC3' | 'cutoutB1' | 'cutoutB2' | 'cutoutB3' | 'cutoutA1' | 'cutoutA2' | 'cutoutA3';
@@ -7,7 +7,7 @@ export type SingleSlotCutoutFixtureId = 'singleLeftSlot' | 'singleCenterSlot' |
 export type StagingAreaRightSlotFixtureId = 'stagingAreaRightSlot';
 export type TrashBinAdapterCutoutFixtureId = 'trashBinAdapter';
 export type WasteChuteCutoutFixtureId = 'wasteChuteRightAdapterCovered' | 'wasteChuteRightAdapterNoCover' | 'stagingAreaSlotWithWasteChuteRightAdapterCovered' | 'stagingAreaSlotWithWasteChuteRightAdapterNoCover';
-export type FlexModuleCutoutFixtureId = 'heaterShakerModuleV1' | 'temperatureModuleV2' | 'magneticBlockV1' | 'stagingAreaSlotWithMagneticBlockV1' | 'thermocyclerModuleV2Rear' | 'thermocyclerModuleV2Front';
+export type FlexModuleCutoutFixtureId = 'heaterShakerModuleV1' | 'temperatureModuleV2' | 'magneticBlockV1' | 'stagingAreaSlotWithMagneticBlockV1' | 'thermocyclerModuleV2Rear' | 'thermocyclerModuleV2Front' | 'absorbanceReaderV1';
 export type OT2SingleStandardSlot = 'singleStandardSlot';
 export type OT2FixedTrashSlot = 'fixedTrashSlot';
 export type CutoutFixtureId = SingleSlotCutoutFixtureId | StagingAreaRightSlotFixtureId | TrashBinAdapterCutoutFixtureId | WasteChuteCutoutFixtureId | FlexModuleCutoutFixtureId | OT2SingleStandardSlot | OT2FixedTrashSlot;