composabl-cli 0.9.1__cp310-cp310-macosx_10_9_universal2.whl → 0.9.2__cp310-cp310-macosx_10_9_universal2.whl

composabl_cli/template/agent_composabl/agent.py

@@ -0,0 +1,90 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential
+
+import os
+from typing import Dict
+
+from composabl import Agent, MaintainGoal, Sensor, Skill, Trainer
+
+# Accept the EULA
+os.environ["COMPOSABL_EULA_AGREED"] = "1"
+
+# Set the license
+# os.environ["COMPOSABL_LICENSE"] = "YOUR_LICENSE_KEY"
+
+
+class BalanceTeacher(MaintainGoal):
+    def __init__(self, *args, **kwargs):
+        super().__init__(
+            "pole_theta", "Maintain pole to upright", target=0, stop_distance=0.418
+        )
+
+        # defaults the BL and BR
+
+    async def compute_action_mask(self, transformed_sensors: Dict, action):
+        # Cartpole might not use an action mask, so this can return None
+        return None
+
+    async def transform_sensors(self, sensors, action):
+        # For Cartpole, might just return sensors directly
+        return sensors
+
+    async def transform_action(self, transformed_sensors: Dict, action):
+        # No transformation needed for discrete action space
+        return action
+
+    async def filtered_sensor_space(self):
+        # Return relevant sensors
+        return ["cart_pos", "cart_vel", "pole_theta", "pole_alpha"]
+
+
+def main():
+    # Create the agent
+    a = Agent()
+
+    # https://gymnasium.farama.org/environments/classic_control/cart_pole/#observation-space
+    a.add_sensors(
+        [
+            Sensor(
+                "cart_pos",
+                "The Cart Position between [-4.8, 4.8]",
+                lambda sensors: sensors[0],
+            ),
+            Sensor(
+                "cart_vel",
+                "The Cart Position between  [-inf, inf]",
+                lambda sensors: sensors[1],
+            ),
+            Sensor(
+                "pole_theta",
+                "The Pole Angle [-0.418 rad, 0.418 rad]",
+                lambda sensors: sensors[2],
+            ),
+            Sensor(
+                "pole_alpha",
+                "The Pole Angular Velocity [-inf, inf]",
+                lambda sensors: sensors[3],
+            ),
+        ]
+    )
+
+    skill = Skill("pole-balance", BalanceTeacher)
+    a.add_skill(skill)
+
+    # Create trainer and train the agent
+    r = Trainer(
+        {
+            "target": {"composabl"},
+            "resources": {
+                "sim_count": 2,
+            },
+        }
+    )
+
+    r.train(a, train_cycles=5)
+    r.close()
+
+
+if __name__ == "__main__":
+    main()

composabl_cli/template/agent_docker/agent.py

@@ -0,0 +1,99 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential
+
+import os
+from typing import Dict
+
+from composabl import Agent, MaintainGoal, Sensor, Skill, Trainer
+
+# Accept the EULA
+os.environ["COMPOSABL_EULA_AGREED"] = "1"
+
+# Set the license
+# os.environ["COMPOSABL_LICENSE"] = "YOUR_LICENSE_KEY"
+
+
+class BalanceTeacher(MaintainGoal):
+    def __init__(self, *args, **kwargs):
+        super().__init__(
+            "pole_theta", "Maintain pole to upright", target=0, stop_distance=0.418
+        )
+
+        # defaults the BL and BR
+
+    async def compute_action_mask(self, transformed_sensors: Dict, action):
+        # Cartpole might not use an action mask, so this can return None
+        return None
+
+    async def transform_sensors(self, sensors, action):
+        # For Cartpole, might just return sensors directly
+        return sensors
+
+    async def transform_action(self, transformed_sensors: Dict, action):
+        # No transformation needed for discrete action space
+        return action
+
+    async def filtered_sensor_space(self):
+        # Return relevant sensors
+        return ["cart_pos", "cart_vel", "pole_theta", "pole_alpha"]
+
+
+def main():
+    # Create the agent
+    a = Agent()
+
+    # https://gymnasium.farama.org/environments/classic_control/cart_pole/#observation-space
+    a.add_sensors(
+        [
+            Sensor(
+                "cart_pos",
+                "The Cart Position between [-4.8, 4.8]",
+                lambda sensors: sensors[0],
+            ),
+            Sensor(
+                "cart_vel",
+                "The Cart Position between  [-inf, inf]",
+                lambda sensors: sensors[1],
+            ),
+            Sensor(
+                "pole_theta",
+                "The Pole Angle [-0.418 rad, 0.418 rad]",
+                lambda sensors: sensors[2],
+            ),
+            Sensor(
+                "pole_alpha",
+                "The Pole Angular Velocity [-inf, inf]",
+                lambda sensors: sensors[3],
+            ),
+        ]
+    )
+
+    skill = Skill("pole-balance", BalanceTeacher)
+    a.add_skill(skill)
+
+    # Create trainer and train the agent
+    r = Trainer(
+        {
+            "target": {"docker": {"image": "composabl/sim-cartpole-dev:latest"}},
+            "resources": {
+                "sim_count": 2,
+            },
+            "post_processing": {
+                "record": {
+                    "is_enabled": True,
+                    "file_path": "/tmp/composabl/recordings",
+                    "avi_file_name": "output.avi",
+                    "gif_file_name": "output.gif",
+                    "gif_max_frames": 24 * 5,
+                },
+            },
+        }
+    )
+
+    r.train(a, train_cycles=5)
+    r.close()
+
+
+if __name__ == "__main__":
+    main()

composabl_cli/template/agent_local/agent.py

@@ -0,0 +1,96 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential
+
+import os
+from typing import Dict
+
+from composabl import Agent, MaintainGoal, Sensor, Skill, Trainer
+
+# Accept the EULA
+os.environ["COMPOSABL_EULA_AGREED"] = "1"
+
+# Set the license
+# os.environ["COMPOSABL_LICENSE"] = "YOUR_LICENSE_KEY"
+
+
+class BalanceTeacher(MaintainGoal):
+    def __init__(self, *args, **kwargs):
+        super().__init__(
+            "pole_theta", "Maintain pole to upright", target=0, stop_distance=0.418
+        )
+
+        # defaults the BL and BR
+
+    async def compute_action_mask(self, transformed_sensors: Dict, action):
+        # Cartpole might not use an action mask, so this can return None
+        return None
+
+    async def transform_sensors(self, sensors, action):
+        # For Cartpole, might just return sensors directly
+        return sensors
+
+    async def transform_action(self, transformed_sensors: Dict, action):
+        # No transformation needed for discrete action space
+        return action
+
+    async def filtered_sensor_space(self):
+        # Return relevant sensors
+        return ["cart_pos", "cart_vel", "pole_theta", "pole_alpha"]
+
+
+def main():
+    # Create the agent
+    a = Agent()
+
+    # https://gymnasium.farama.org/environments/classic_control/cart_pole/#observation-space
+    a.add_sensors(
+        [
+            Sensor(
+                "cart_pos",
+                "The Cart Position between [-4.8, 4.8]",
+                lambda sensors: sensors[0],
+            ),
+            Sensor(
+                "cart_vel",
+                "The Cart Position between  [-inf, inf]",
+                lambda sensors: sensors[1],
+            ),
+            Sensor(
+                "pole_theta",
+                "The Pole Angle [-0.418 rad, 0.418 rad]",
+                lambda sensors: sensors[2],
+            ),
+            Sensor(
+                "pole_alpha",
+                "The Pole Angular Velocity [-inf, inf]",
+                lambda sensors: sensors[3],
+            ),
+        ]
+    )
+
+    skill = Skill("pole-balance", BalanceTeacher)
+    a.add_skill(skill)
+
+    # Create trainer and train the agent
+    r = Trainer(
+        {
+            "target": {"local": {"address": "localhost:1337"}},
+            "post_processing": {
+                "record": {
+                    "is_enabled": True,
+                    "file_path": "/tmp/composabl/recordings",
+                    "avi_file_name": "output.avi",
+                    "gif_file_name": "output.gif",
+                    "gif_max_frames": 24 * 5,
+                },
+            },
+        }
+    )
+
+    r.train(a, train_cycles=5)
+    r.close()
+
+
+if __name__ == "__main__":
+    main()

composabl_cli/template/sim_docker/Dockerfile

@@ -0,0 +1,45 @@
+######################################################
+# Composabl Image
+######################################################
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /opt/composabl
+
+# ######################################################
+# Install Dependencies
+# ######################################################
+RUN apt update; apt install -y unzip tree
+
+# ######################################################
+# Make `python3` available as `python`
+# ######################################################
+RUN ln -s /usr/bin/python3 /usr/bin/python
+
+# ######################################################
+# Install Composabl
+# ######################################################
+RUN pip install composabl-core
+
+# ######################################################
+# Install Python Module
+# ######################################################
+COPY module/ /opt/composabl/sim/
+RUN pip install /opt/composabl/sim/
+
+# ######################################################
+# Install Composabl Code and Docker scripts
+# ######################################################
+# Copy over the scripts
+COPY docker /docker
+RUN chmod +x /docker/*.sh
+
+# Copy over the main startup file
+# this file takes care of starting the Composabl server
+COPY *.py /opt/composabl/
+
+# ######################################################
+# Define run
+# ######################################################
+EXPOSE 1337
+CMD ["/docker/sim-start.sh", "/opt/composabl/sim"]

composabl_cli/template/sim_docker/README.md

@@ -0,0 +1,17 @@
+# README
+
+This is an example of how to build a composabl suitable container yourself for full control.
+
+### Build the Sim
+
+To build the sim wrapper, run the following command:
+
+```bash
+docker build -t composabl/sim-demo .
+```
+
+### Run the Sim
+
+```bash
+docker run --rm -it -p 1337:1337 composabl/sim-demo
+```

composabl_cli/template/sim_docker/docker/sim-start.sh

@@ -0,0 +1,14 @@
+#!/bin/bash -e
+################################################################################
+##  File:  sim-start.sh
+##  Desc:  Start the Composabl Sim Wrapper
+################################################################################
+PATH_SIM=${1:-/composabl/sim}
+SIM_CONFIG_JSON=${2:-"{}"}
+
+HOST=${HOST:-"0.0.0.0"}
+PORT=${PORT:-"1337"}
+
+# Start the Sim Client Wrapper
+echo "$0: Starting the Sim Wrapper"
+python3 /opt/composabl/main.py --path $PATH_SIM --config $SIM_CONFIG_JSON --port $PORT --host $HOST

composabl_cli/template/sim_docker/main.py

@@ -0,0 +1,55 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential
+
+import argparse
+import os
+from typing import Optional
+
+from composabl_core.networking.server import make_from_sim_path
+
+
+async def _run(
+    path: Optional[str] = "./",
+    host: Optional[str] = "0.0.0.0",
+    port: Optional[int] = 1337,
+    protocol: Optional[str] = "grpc",
+    config: Optional[dict] = {},
+):
+    """
+    Try to run the sim situated in the given location
+    """
+    path_abs = os.path.abspath(path)
+
+    print(f"Running sim from path: {path_abs}")
+    print(f"Params: {path}, {host}, {port}, {protocol}, {config}")
+
+    server = make_from_sim_path(path, host, port, config=config, protocol=protocol)
+    print(f"Running on {host}:{port}")
+
+    try:
+        await server.start()
+    except KeyboardInterrupt:
+        print("KeyboardInterrupt, Gracefully stopping the server")
+    except Exception as e:
+        print(f"Unknown error: {e}, Gracefully stopping the server")
+    finally:
+        print("Stopping the server")
+        if server is not None:
+            await server.stop()
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--path", type=str, default="./")
+    parser.add_argument("--host", type=str, default="0.0.0.0")
+    parser.add_argument("--port", type=int, default=1337)
+    parser.add_argument("--protocol", type=str, default="grpc")
+    parser.add_argument("--config", type=str, default="{}")
+    args = parser.parse_args()
+
+    config_parsed = eval(args.config)
+
+    import asyncio
+
+    asyncio.run(_run(args.path, args.host, args.port, args.protocol, config_parsed))

composabl_cli/template/sim_docker/module/README.md

@@ -0,0 +1,39 @@
+# README
+
+## Tree Structure
+
+The template is structured as follows:
+
+```bash
+my-sim/                 # Root folder
+├── my_sim/             # Main package folder
+│   ├── __init__.py     # Package init file
+│   ├── sim_impl.py     # Sim Implementation
+│   └── sim.py          # Sim Itself
+├── pyproject.toml      # Project configuration, containing [composabl]
+```
+
+## PyProject [composabl] Section
+
+We add the `[composabl]` section to the `pyproject.toml` file to specify the sim we are creating as well as its entrypoint. This is used by the Composabl Sim Container to determine how to start the sim.
+
+Example:
+
+```toml
+[composabl]
+type = "sim"
+entrypoint = "my_sim.sim_impl:MySimImpl"
+```
+
+## Development
+
+To work on the Sim, you can simply run `composabl sim run <folder>`. This will do the same but locally.
+
+## Preparing for Upload
+
+Once we are ready for uploading, we can create a `.zip` file that contains the version and is prefixed with `composabl-sim-`. This can be done with the following command:
+
+```bash
+# Zip the Sim
+zip -r composabl-sim-demo-0.0.1.zip sim-demo/
+```

composabl_cli/template/sim_docker/module/pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "{{NAME}}"
+version = "0.1.0"
+description = "{{DESCRIPTION}}"
+authors = [{ name = "John Doe", email = "john.doe@composabl.com" }]
+dependencies = [
+    "composabl-core"
+]
+
+[composabl]
+type = "sim"
+entrypoint = "{{NAME_MODULE}}.sim_impl:SimImpl"
+dependencies_system = [] # include additional apt-get packages to be installed
+
+# Include additional data files
+[tool.setuptools.packages.find]
+where = ["{{NAME_MODULE}}"]
+
+[tool.setuptools.package-data]
+"*" = ["*.json", "*.pkl"]

composabl_cli/template/sim_docker/module/{{NAME_MODULE}}/sim.py

@@ -0,0 +1,255 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential
+
+import math
+import random
+from typing import Optional
+
+import gymnasium as gym
+import numpy as np
+from composabl_core.agent.scenario import Scenario
+
+
+class Env(gym.Env):
+    def __init__(self):
+        self.obs_space_constraints = {
+            "x": {"low": -400, "high": 400},
+            "x_speed": {"low": -100, "high": 100},
+            "y": {"low": 0, "high": 1000},
+            "y_speed": {"low": -1000, "high": 1000},
+            "angle": {"low": -3.15 * 2, "high": 3.15 * 2},
+            "angle_speed": {"low": -3, "high": 3},
+        }
+
+        deg_to_rad = 0.01745329
+        self.max_gimble = 20 * deg_to_rad
+        self.min_gimble = -self.max_gimble
+
+        self.action_constraints = {
+            "angle": {"low": self.min_gimble, "high": self.max_gimble},
+            "thrust": {"low": 0.4, "high": 1},
+        }
+
+        low_list = [x["low"] for x in self.obs_space_constraints.values()]
+        high_list = [x["high"] for x in self.obs_space_constraints.values()]
+
+        self.sensor_space = gym.spaces.Box(
+            low=np.array(low_list), high=np.array(high_list)
+        )
+
+        low_act_list = [x["low"] for x in self.action_constraints.values()]
+        high_act_list = [x["high"] for x in self.action_constraints.values()]
+
+        self.action_space = gym.spaces.Box(
+            low=np.array(low_act_list), high=np.array(high_act_list)
+        )
+
+        self.state_models = {}
+        self.reward_models = {}
+        self.scenario: Scenario = None
+
+        self.x_obs0 = 0
+        self.x_speed0 = 0
+        self.y_obs0 = 1000
+        self.y_speed0 = -80
+        self.angle0 = -np.pi / 2
+        self.ang_speed0 = 0
+
+    def starship_simulation(self, x, u):
+        g = 9.8
+        m = 100000  # kg
+        min_thrust = 880 * 1000  # N
+        max_thrust = 1 * 2210 * 1000  # kN
+
+        length = 50  # m
+        width = 10
+
+        # Inertia for a uniform density rod
+        I = (1 / 12) * m * length**2
+
+        deg_to_rad = 0.01745329
+
+        max_gimble = 20 * deg_to_rad
+        min_gimble = -max_gimble
+
+        theta = x[4]
+
+        thrust = u[0]
+        thrust_angle = u[1]
+
+        # Horizontal force
+        F_x = max_thrust * thrust * math.sin(thrust_angle + theta)
+        x_dot = x[1]
+        x_dotdot = (F_x) / m
+
+        # Vertical force
+        F_y = max_thrust * thrust * math.cos(thrust_angle + theta)
+        y_dot = x[3]
+        y_dotdot = (F_y) / m - g
+
+        # Torque
+        T = -length / 2 * max_thrust * thrust * math.sin(thrust_angle)
+        theta_dot = x[5]
+        theta_dotdot = T / I
+
+        return [x_dot, x_dotdot, y_dot, y_dotdot, theta_dot, theta_dotdot]
+
+    def reset(
+        self,
+        *,
+        seed: Optional[int] = None,
+        options: Optional[dict] = None,
+        x_obs0: float = 0,
+        x_speed0: float = 0,
+        y_obs0: float = 1000,
+        y_speed0: float = -80,
+        angle0: float = -np.pi / 2,
+        ang_speed0: float = 0
+    ):
+        """
+        # x[0] = x position (m)
+        # x[1] = x velocity (m/)
+        # x[2] = y position (m)
+        # x[3] = y velocity (m/s)
+        # x[4] = angle (rad)
+        # x[5] = angular velocity (rad/s)
+
+        # u[0] = thrust (percent)
+        # u[1] = thrust angle (rad)
+
+        """
+        super().reset(seed=seed)
+        self.cnt = 0
+        self.min_thrust = 880 * 1000  # N
+        self.max_thrust = 1 * 2210 * 1000  # kN
+
+        # Define scenario in the simulation ******
+        if isinstance(self.scenario, Scenario):
+            sample = self.scenario.sample()
+
+            for key in list(sample.keys()):
+                setattr(self, key, sample[key])
+
+        # Set the number of steps and the timestep (dt)
+        steps = 400
+        self.t_step = 0.04
+        self.cnt = 0
+
+        self.x = np.zeros((steps + 1, 6))
+        self.u = np.zeros((steps + 1, 2))
+
+        self.x[0, :] = [
+            self.x_obs0,
+            self.x_speed0,
+            self.y_obs0,
+            self.y_speed0,
+            self.angle0,
+            self.ang_speed0,
+        ]
+        self.x[steps - 1, :] = [0, 0, 0, 0, 0, 0]
+
+        self.x_obs = self.x[self.cnt, 0]
+        self.x_speed = self.x[self.cnt, 1]
+        self.y_obs = self.x[self.cnt, 2]
+        self.y_speed = self.x[self.cnt, 3]
+        self.angle = self.x[self.cnt, 4]
+        self.ang_speed = self.x[self.cnt, 5]
+
+        self.t = 0.4
+        self.a = 0
+        self.reward_value = 0
+
+        self.obs = {
+            "x": self.x_obs,
+            "x_speed": self.x_speed,
+            "y": self.y_obs,
+            "y_speed": self.y_speed,
+            "angle": self.angle,
+            "angle_speed": self.ang_speed,
+        }
+
+        self.obs = np.array(list(self.obs.values()))
+        info = {}
+        return self.obs, info
+
+    def set_scenario(self, scenario):
+        self.scenario = scenario
+
+    def step(self, action):
+        terminated = False
+        discount = 0
+        reward = 0
+
+        def sumsqr(lt):
+            v = sum([x**2 for x in lt])
+            return v
+
+        angle = action[0]
+        thrust = action[1]
+
+        actuator_noise = 0
+        self.t = thrust + random.uniform(
+            -actuator_noise * thrust, actuator_noise * thrust
+        )
+        self.a = angle + random.uniform(
+            -actuator_noise * angle, actuator_noise * angle
+        )
+
+        self.t = np.clip(self.t, 0.4, 1)
+        self.a = np.clip(self.a, self.min_gimble, self.max_gimble)
+
+        # update u
+        self.u[self.cnt, 0] = self.t
+        self.u[self.cnt, 1] = self.a
+
+        res = self.starship_simulation(self.x[self.cnt, :], self.u[self.cnt, :])
+        res = [v * self.t_step for v in res]
+
+        self.x[self.cnt + 1, :] = [
+            sum(value) for value in zip(self.x[self.cnt, :], res)
+        ]
+
+        # Increase time
+        self.cnt += 1
+        # update values
+        self.x_obs = self.x[self.cnt, 0]
+        self.x_speed = self.x[self.cnt, 1]
+        self.y_obs = self.x[self.cnt, 2]
+        self.y_speed = self.x[self.cnt, 3]
+        self.angle = self.x[self.cnt, 4]
+        self.ang_speed = self.x[self.cnt, 5]
+
+        # update obs with new state values
+        self.obs = {
+            "x": self.x_obs,
+            "x_speed": self.x_speed,
+            "y": self.y_obs,
+            "y_speed": self.y_speed,
+            "angle": self.angle,
+            "angle_speed": self.ang_speed,
+        }
+        # add noise
+        for key in list(self.obs.keys()):
+            val = float(self.obs[key])
+            sensor_noise = 0.0
+            self.obs[key] = val + random.uniform(
+                -val * sensor_noise, val * sensor_noise
+            )
+
+        # end the simulation
+        if self.y_obs < 0:
+            terminated = True
+        elif (
+            not self.obs_space_constraints["x"]["low"]
+            <= self.x_obs
+            <= self.obs_space_constraints["x"]["high"]
+        ):
+            terminated = True
+
+        self.obs = np.array(list(self.obs.values()))
+        info = {}
+        return self.obs, reward, terminated, False, info
+
+    def render(self, mode="auto"):
+        pass

composabl_cli/template/sim_docker/module/{{NAME_MODULE}}/sim_impl.py

@@ -0,0 +1,115 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential
+
+from typing import Any, Dict, SupportsFloat, Tuple
+
+import composabl_core.utils.logger as logger_util
+import gymnasium as gym
+from composabl_core.agent.scenario import Scenario
+from composabl_core.networking.server_composabl import ServerComposabl
+from gymnasium.envs.registration import EnvSpec
+
+from {{NAME_MODULE}}.sim import Env
+
+logger = logger_util.get_logger(__name__)
+
+
+class SimImpl(ServerComposabl):
+    def __init__(self):
+        self.env = Env()
+
+    async def make(self, env_id: str, env_init: dict) -> EnvSpec:
+        """
+        Make the environment
+
+        Args:
+        - env_id (str): Environment ID
+        - env_init (dict): Environment Initialization
+
+        Returns:
+        - EnvSpec: Environment Specification
+        """
+        spec = {"id": "starship", "max_episode_steps": 400}
+        return spec
+
+    async def sensor_space_info(self) -> gym.Space:
+        """
+        Get the sensor space information
+
+        Returns:
+        - Space: Sensor Space in Gymnasium Specification
+        """
+        return self.env.sensor_space
+
+    async def action_space_info(self) -> gym.Space:
+        """
+        Get the action space information
+
+        Returns:
+        - Space: Action Space in Gymnasium Specification
+        """
+        return self.env.action_space
+
+    async def action_space_sample(self) -> Any:
+        """
+        Get the action space sample
+
+        Returns:
+        - List[Any]: A list of samples
+        """
+        return self.env.action_space.sample()
+
+    async def reset(self) -> Tuple[Any, Dict[str, Any]]:
+        """
+        Reset the environment
+
+        Returns:
+        - Tuple[Any, Dict[str, Any]]: The observation and the info
+        """
+        sensors, info = self.env.reset()
+        return sensors, info
+
+    async def step(
+        self, action
+    ) -> Tuple[Any, SupportsFloat, bool, bool, Dict[str, Any]]:
+        """
+        Step the environment
+
+        Args:
+        - action: The action to take
+
+        Returns:
+        - Tuple[Any, SupportsFloat, bool, bool, Dict[str, Any]]: The observation, reward, is_truncated, is_done, info
+        """
+        return self.env.step(action)
+
+    async def close(self):
+        """
+        Close the environment
+        """
+        self.env.close()
+
+    async def set_scenario(self, scenario):
+        """
+        Set the scenario
+        """
+        self.env.scenario = scenario
+
+    async def get_scenario(self):
+        """
+        Get the scenario
+        """
+        if self.env.scenario is None:
+            return Scenario({"dummy": 0})
+
+        return self.env.scenario
+
+    async def get_render(self):
+        """
+        Get the render
+
+        Args:
+        - render_mode: The render mode
+        """
+        return self.env.get_render_frame()

composabl_cli/template/skill_teacher/{{NAME_MODULE}}/__init__.py

@@ -0,0 +1,3 @@
+# Copyright (C) Composabl, Inc - All Rights Reserved
+# Unauthorized copying of this file, via any medium is strictly prohibited
+# Proprietary and confidential

{composabl_cli-0.9.1.dist-info → composabl_cli-0.9.2.dist-info}/METADATA

@@ -1,20 +1,23 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: composabl-cli
-Version: 0.9.1
+Version: 0.9.2
 Summary: the Composabl CLI
 Author-email: Composabl <info@composabl.com>
 Requires-Python: >=3.10, <3.12
 Description-Content-Type: text/markdown
-Requires-Dist: typer[all] ==0.11.0
+Requires-Dist: typer[all]==0.11.0
 Requires-Dist: cython
 Requires-Dist: docker
 Requires-Dist: kubernetes
 Requires-Dist: jinja2
-Requires-Dist: composabl-core >=0.9.1
-Requires-Dist: composabl-train >=0.9.1
-Requires-Dist: composabl-api >=0.9.1
+Requires-Dist: composabl-core>=0.9.2
+Requires-Dist: composabl-train>=0.9.2
+Requires-Dist: composabl-api>=0.9.2
 Requires-Dist: ruff
 Requires-Dist: simple-term-menu
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: requires-python
 
 # Composabl
 

composabl_cli-0.9.2.dist-info/RECORD

@@ -0,0 +1,67 @@
+composabl_cli/__init__.py,sha256=S2R_1v6FRZ7Pb0vVWYZXFLcUFuRuHXYd0ZoWxYpquM8,316
+composabl_cli/k8s/k8s_train.cpython-310-darwin.so,sha256=XzZOF1WJPYfth0IC12QaqfG-6s4vNE6q5beHEEtr7qI,292592
+composabl_cli/k8s/util.cpython-310-darwin.so,sha256=TPlh1yCqDEHQDDBihuFTwm1zhGFetrw9uZpUM6zKlMM,129504
+composabl_cli/template/agent_composabl/agent.py,sha256=bgLhCZ7hHVen-8WcPgFRTw-HBIQdU2KAUNfXLySmnu4,2451
+composabl_cli/template/agent_docker/agent.py,sha256=8z__Fpola2jmmKR7QeoP-EHW0KzXzHNlyX48Ik714JA,2841
+composabl_cli/template/skill_teacher/pyproject.toml,sha256=pShZXJHFw5-6cJYzw3jsbu_hbPjPQ_YXaOQhyOYUP84,269
+composabl_cli/template/skill_teacher/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
+composabl_cli/template/skill_teacher/{{NAME_MODULE}}/teacher.py,sha256=2MZKUN7gUkfUb-pQD7hh7BlPGRcy66YRq13eqVQvWNw,2585
+composabl_cli/template/skill_teacher/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/selector_controller/pyproject.toml,sha256=WKB_pY17udJqOpYRhFOrQNqJcfHLjrvrVndCcnk9Ndg,281
+composabl_cli/template/selector_controller/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
+composabl_cli/template/selector_controller/{{NAME_MODULE}}/controller.py,sha256=ScK28F5cMb0Ek4ERBUAmrWbcPWDlmpA1zsxNBJgo2Rk,1744
+composabl_cli/template/selector_controller/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/sim_docker/Dockerfile,sha256=4EDDU8maYY6SzoLGjwfJ9Vzx_KYruMueVQwmbsOsdsM,1486
+composabl_cli/template/sim_docker/README.md,sha256=buW49KLG-j7-A_8qZehEvG3TafeaK5_F92Z5ZfMMgAU,308
+composabl_cli/template/sim_docker/main.py,sha256=Z5PBWiYPeqdpTdAYksVoZCKqA_3GBz8HORzzS0wkFgs,1711
+composabl_cli/template/sim_docker/docker/sim-start.sh,sha256=aGd_9HayqKClNgFr80MAn7JGPiMiZTKJmzUV0PaLiHw,515
+composabl_cli/template/sim_docker/module/pyproject.toml,sha256=XCnRtO15K0sW5P521lZbjzZ2ScS4cSwnAQuC1-QGITA,490
+composabl_cli/template/sim_docker/module/README.md,sha256=XjNdgOyS9RPMkgK2pGLVmYGHIuq9zNFv1HTCaqELmyw,1117
+composabl_cli/template/sim_docker/module/{{NAME_MODULE}}/sim.py,sha256=mbwpUQCN3kXxTvtZBNP3teMm7b__cKcfkww8j-J514k,7215
+composabl_cli/template/sim_docker/module/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/sim_docker/module/{{NAME_MODULE}}/sim_impl.py,sha256=f7DzBBmD9cKmauWskoSmUpnSVHkubmqGtJQ5d-9Kf-M,2926
+composabl_cli/template/selector_teacher/pyproject.toml,sha256=abFMd5916s3nbYsG60IdNAvkjcC0JNbIJxny67HIQvE,272
+composabl_cli/template/selector_teacher/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
+composabl_cli/template/selector_teacher/{{NAME_MODULE}}/teacher.py,sha256=2MZKUN7gUkfUb-pQD7hh7BlPGRcy66YRq13eqVQvWNw,2585
+composabl_cli/template/selector_teacher/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/perceptor/pyproject.toml,sha256=5C4jS4v-5Ai6NaSAcSYUwHDfC93fe5a0oGm1mkeTG0I,273
+composabl_cli/template/perceptor/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
+composabl_cli/template/perceptor/{{NAME_MODULE}}/perceptor.py,sha256=OADD3zG17GxIGtO_my1yMq3Sw3KcV9ARJcCFXcIvMEc,1165
+composabl_cli/template/perceptor/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/skill_coach/pyproject.toml,sha256=NJ4XaFkRjzocUwbBjGX6SxkpfPLE9Q-dUEvdPrCp7HY,263
+composabl_cli/template/skill_coach/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
+composabl_cli/template/skill_coach/{{NAME_MODULE}}/coach.py,sha256=xC_4_cFI2uXcl-8mVVaS_ADsWL9M8UI3-bcd_kc1WB4,2603
+composabl_cli/template/skill_coach/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/sim/pyproject.toml,sha256=XCnRtO15K0sW5P521lZbjzZ2ScS4cSwnAQuC1-QGITA,490
+composabl_cli/template/sim/README.md,sha256=XjNdgOyS9RPMkgK2pGLVmYGHIuq9zNFv1HTCaqELmyw,1117
+composabl_cli/template/sim/{{NAME_MODULE}}/sim.py,sha256=mbwpUQCN3kXxTvtZBNP3teMm7b__cKcfkww8j-J514k,7215
+composabl_cli/template/sim/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/template/sim/{{NAME_MODULE}}/sim_impl.py,sha256=f7DzBBmD9cKmauWskoSmUpnSVHkubmqGtJQ5d-9Kf-M,2926
+composabl_cli/template/agent_local/agent.py,sha256=rIi0OpCQvHjsXrI6KOOwHsGcSj1jYXbUsAruYW6hgCc,2749
+composabl_cli/template/skill_controller/pyproject.toml,sha256=cxs9x2geQxCIzWQ6j4J8F8BmE3sMREPfWuWtwSbUGjE,278
+composabl_cli/template/skill_controller/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
+composabl_cli/template/skill_controller/{{NAME_MODULE}}/controller.py,sha256=h-K6MLRwJuMKva5H8pp5ZLJ9WH4Z6_IIsKxnfVacASY,1372
+composabl_cli/template/skill_controller/{{NAME_MODULE}}/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
+composabl_cli/cli/cli.cpython-310-darwin.so,sha256=4prajQdHZYWen02GdEGAQC2Y8BOTlg6mMMHi7xTEzH4,163824
+composabl_cli/cli/cli_sim.cpython-310-darwin.so,sha256=EbiuxXNrs_X3zeSDObaHKCwnqSEW3DYkH_1QhtpysKQ,608432
+composabl_cli/cli/cli_perceptor.cpython-310-darwin.so,sha256=IOIj08mAbrJ39P05HQPZXtcwQqNfTp6et545EjoQiRw,295496
+composabl_cli/cli/cli_version.cpython-310-darwin.so,sha256=eCYUMVRZ2kWaesCcjhT90OgoxJVo56Zw7OqIlPCq4ZA,164232
+composabl_cli/cli/cli_main.cpython-310-darwin.so,sha256=ciTfmQvWJgRiZdw1Ua0jRz8Vd8jpmhQDrkAtdsmrwEM,275680
+composabl_cli/cli/cli_historian.cpython-310-darwin.so,sha256=f1gyrVh0MLk-zIk-AacwTacPo5Fu3yRnt_Ez4ASk9vY,217288
+composabl_cli/cli/__init__.cpython-310-darwin.so,sha256=rSYvq9CBuW6K_kV66SmKqIy_I8JxzMpLMF9Ab0t2EAo,88592
+composabl_cli/cli/cli_skill.cpython-310-darwin.so,sha256=12fXOx5ZhKeCWTfQqCP3muAJqRjF6GjlswBdQtFOU-Y,329744
+composabl_cli/cli/cli_benchmark.cpython-310-darwin.so,sha256=adsN4giptwuHg3M8g835tKIuVAQLC_e_H32XvtEC04U,183416
+composabl_cli/cli/cli_selector.cpython-310-darwin.so,sha256=oKcjHwU2w8Eh-HDeZ1UEdx7HsOtVPmxqfL5IZIocDho,329880
+composabl_cli/cli/cli_debug.cpython-310-darwin.so,sha256=LajhsoSr4T5peotY9VQQcm59yFOYv89o2GmZH-9KEu8,147824
+composabl_cli/cli/cli_agent.cpython-310-darwin.so,sha256=zNd9xY4Id1C1RaNZG8DeWSVqaUTgRTuOKHoq8dZaU2w,222736
+composabl_cli/cli/cli_job.cpython-310-darwin.so,sha256=_DXFs5mu-GOY58dvtZQFRgpHQE7LkyZVw93_hljprFI,329040
+composabl_cli/main/selector.cpython-310-darwin.so,sha256=Hoq9P4gsJAvnEzPTmrBRsHYGO83RwRhQpTdr5DEQBBA,240256
+composabl_cli/main/perceptor.cpython-310-darwin.so,sha256=48YEK1X_-hfA1Y7ovxFe9VqbdWFBizFNy_9pvoPbw4A,223120
+composabl_cli/main/sim.cpython-310-darwin.so,sha256=WMxwfw6oaIlEGHDGa9h-8VDW-mhtTJu8gjKk-MR8Q-8,223216
+composabl_cli/main/agent.cpython-310-darwin.so,sha256=PPDwC2E_zynzWK8iEfo3uw5cmDnOFcb-vQrGJSQGz8g,146704
+composabl_cli/main/skill.cpython-310-darwin.so,sha256=yRECArIpL6eqW44OS8tb83JoEnCZqdbCPu2xkmbNM2Q,240304
+composabl_cli-0.9.2.dist-info/RECORD,,
+composabl_cli-0.9.2.dist-info/WHEEL,sha256=Yd3eJSBM2hj8W-ouaiMfFUwQYAS-D6P73Ob9yN5MZd0,114
+composabl_cli-0.9.2.dist-info/entry_points.txt,sha256=WrLVbw0dPbDvkgFcNa275XoyuBvDoP-453FEPMn_cG8,56
+composabl_cli-0.9.2.dist-info/top_level.txt,sha256=EGQnCayGP2E4xx8Z-rUeCIw8n3qRhuqDYQREYU08lwY,14
+composabl_cli-0.9.2.dist-info/METADATA,sha256=AH8LKtx68uI6z5ceEk1vhayUhJYl-nRlu4nk55tez-w,1953

{composabl_cli-0.9.1.dist-info → composabl_cli-0.9.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.1.0)
+Generator: setuptools (75.8.0)
 Root-Is-Purelib: false
 Tag: cp310-cp310-macosx_10_9_universal2
 

composabl_cli-0.9.1.dist-info/RECORD

@@ -1,54 +0,0 @@
-composabl_cli/__init__.py,sha256=S2R_1v6FRZ7Pb0vVWYZXFLcUFuRuHXYd0ZoWxYpquM8,316
-composabl_cli/k8s/k8s_train.cpython-310-darwin.so,sha256=iFcLV31VjIfdQUIjtbjMJDvEz2FwOAJbE_5LtV2m97E,292816
-composabl_cli/k8s/util.cpython-310-darwin.so,sha256=_-gBP85s5XiLgssCAdFLdNgFbsiR-qYeSLmbCghhPRo,129504
-composabl_cli/template/skill_teacher/pyproject.toml,sha256=pShZXJHFw5-6cJYzw3jsbu_hbPjPQ_YXaOQhyOYUP84,269
-composabl_cli/template/skill_teacher/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
-composabl_cli/template/skill_teacher/my_skill/teacher.py,sha256=2MZKUN7gUkfUb-pQD7hh7BlPGRcy66YRq13eqVQvWNw,2585
-composabl_cli/template/skill_teacher/my_skill/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/template/selector_controller/pyproject.toml,sha256=WKB_pY17udJqOpYRhFOrQNqJcfHLjrvrVndCcnk9Ndg,281
-composabl_cli/template/selector_controller/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
-composabl_cli/template/selector_controller/my_selector/controller.py,sha256=ScK28F5cMb0Ek4ERBUAmrWbcPWDlmpA1zsxNBJgo2Rk,1744
-composabl_cli/template/selector_controller/my_selector/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/template/selector_teacher/pyproject.toml,sha256=abFMd5916s3nbYsG60IdNAvkjcC0JNbIJxny67HIQvE,272
-composabl_cli/template/selector_teacher/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
-composabl_cli/template/selector_teacher/my_selector/teacher.py,sha256=2MZKUN7gUkfUb-pQD7hh7BlPGRcy66YRq13eqVQvWNw,2585
-composabl_cli/template/selector_teacher/my_selector/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/template/perceptor/pyproject.toml,sha256=5C4jS4v-5Ai6NaSAcSYUwHDfC93fe5a0oGm1mkeTG0I,273
-composabl_cli/template/perceptor/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
-composabl_cli/template/perceptor/my_perceptor/perceptor.py,sha256=OADD3zG17GxIGtO_my1yMq3Sw3KcV9ARJcCFXcIvMEc,1165
-composabl_cli/template/perceptor/my_perceptor/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/template/skill_coach/pyproject.toml,sha256=NJ4XaFkRjzocUwbBjGX6SxkpfPLE9Q-dUEvdPrCp7HY,263
-composabl_cli/template/skill_coach/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
-composabl_cli/template/skill_coach/my_skill/coach.py,sha256=xC_4_cFI2uXcl-8mVVaS_ADsWL9M8UI3-bcd_kc1WB4,2603
-composabl_cli/template/skill_coach/my_skill/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/template/sim/pyproject.toml,sha256=XCnRtO15K0sW5P521lZbjzZ2ScS4cSwnAQuC1-QGITA,490
-composabl_cli/template/sim/README.md,sha256=XjNdgOyS9RPMkgK2pGLVmYGHIuq9zNFv1HTCaqELmyw,1117
-composabl_cli/template/sim/my_sim/sim.py,sha256=mbwpUQCN3kXxTvtZBNP3teMm7b__cKcfkww8j-J514k,7215
-composabl_cli/template/sim/my_sim/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/template/sim/my_sim/sim_impl.py,sha256=f7DzBBmD9cKmauWskoSmUpnSVHkubmqGtJQ5d-9Kf-M,2926
-composabl_cli/template/skill_controller/pyproject.toml,sha256=cxs9x2geQxCIzWQ6j4J8F8BmE3sMREPfWuWtwSbUGjE,278
-composabl_cli/template/skill_controller/README.md,sha256=6xT3EUAvnNT0zVaVzwVPdBFyp9tOBuQvcEYDYAbeml8,1859
-composabl_cli/template/skill_controller/my_skill/controller.py,sha256=h-K6MLRwJuMKva5H8pp5ZLJ9WH4Z6_IIsKxnfVacASY,1372
-composabl_cli/template/skill_controller/my_skill/__init__.py,sha256=XAEQrdYyHgWwuZZQOoG2r0RnTegCpEhZUPY63WptO7Y,159
-composabl_cli/cli/cli.cpython-310-darwin.so,sha256=4aSLmRoPsf38oIvOw_HfXyqzjy45T7RISEmL0T7zGmg,163824
-composabl_cli/cli/cli_sim.cpython-310-darwin.so,sha256=1mFL1VF-exkRkejKHkA300SR6Wqy2iN8-dfoq4ApSfg,624576
-composabl_cli/cli/cli_perceptor.cpython-310-darwin.so,sha256=aIYnQ3AJrPbBwmclwrPfQ-UkElCQv5AhVIHo4M9D92g,295496
-composabl_cli/cli/cli_version.cpython-310-darwin.so,sha256=i2bl5V9MD1kLWNg_Zj83k-AX2nJgj7GoKmUMXofNgl8,164232
-composabl_cli/cli/cli_main.cpython-310-darwin.so,sha256=8W-XWnPZ-WC-Fdi0eXlf1bpNrfEAIQFammU2rIAPwb4,275504
-composabl_cli/cli/cli_historian.cpython-310-darwin.so,sha256=DX0scRAl54kCroxJJ0AmGnDhN_P3J_UxIkayFXXmsXs,217288
-composabl_cli/cli/__init__.cpython-310-darwin.so,sha256=eHynm0Sq30s6leARRMI6zRnR12xkEp3Kz9V9nJedQwE,88592
-composabl_cli/cli/cli_skill.cpython-310-darwin.so,sha256=Yk5fecQKZoNlYuaAWbNIM4TJOQi0J5jBB7qHNRFgXPg,329792
-composabl_cli/cli/cli_benchmark.cpython-310-darwin.so,sha256=1hd_u4fRUi5Qhb7lSZRn-KssuOShPJd1EQKcq1q8xA4,183416
-composabl_cli/cli/cli_selector.cpython-310-darwin.so,sha256=VLQH-JiLy-PbxkGpqa2uiU-qgezohamVU6NFgKoT7DE,329880
-composabl_cli/cli/cli_debug.cpython-310-darwin.so,sha256=gJNn2MK27-n7pksOcWakNpnLbyLipw_7ovk7DGo9bcA,147824
-composabl_cli/cli/cli_agent.cpython-310-darwin.so,sha256=SlKjNz85e4dnTCdnwmUBCKcF9VIUYDYJOh5gdkZKmbo,186880
-composabl_cli/cli/cli_job.cpython-310-darwin.so,sha256=s6UL6kpRWlg2uKzVsFBCKugvMGi7nGsW1UxLc7gGF4s,329040
-composabl_cli/main/selector.cpython-310-darwin.so,sha256=2rdkMTjGAHRNPwovbRdEz7andRcDCxlszqb6460MxV4,274272
-composabl_cli/main/perceptor.cpython-310-darwin.so,sha256=RZpBIN7DcJ5VoIs46MHkoyCRSEG9PeQnx8QC5orDGXA,239920
-composabl_cli/main/sim.cpython-310-darwin.so,sha256=tUkIm9Q8f7WvqHGp40tNhSYISTPt5XU9cTb_xkNYRII,239936
-composabl_cli/main/skill.cpython-310-darwin.so,sha256=gzFR3eBqISdb5rk6hDvVm8nnRxuvAOQRp1Ay8ZLiPIo,274608
-composabl_cli-0.9.1.dist-info/RECORD,,
-composabl_cli-0.9.1.dist-info/WHEEL,sha256=xMWneRdVaIuwgc6dCErJM4en0_6cDdQiv1uvmL-p7qI,114
-composabl_cli-0.9.1.dist-info/entry_points.txt,sha256=WrLVbw0dPbDvkgFcNa275XoyuBvDoP-453FEPMn_cG8,56
-composabl_cli-0.9.1.dist-info/top_level.txt,sha256=EGQnCayGP2E4xx8Z-rUeCIw8n3qRhuqDYQREYU08lwY,14
-composabl_cli-0.9.1.dist-info/METADATA,sha256=6yfftu64EUI-_3XAbtF-ZjE507ccg0Rf5DfxkDAO7C0,1877