Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
65 commits
Select commit Hold shift + click to select a range
75d3c9a
feat(sim): default Newton rigid simulation to MJVBD V2
Sep 17, 2026
731a20d
fix(sim): tune MJVBD V2 manipulation examples and record limitations
Sep 18, 2026
51af322
fix(tutorial): align drawer damping across physics backends
Sep 20, 2026
bc5369b
docs(sim): clarify MJVBD V2 coupling and control limitations
Sep 20, 2026
5f19889
fix(sim): adapt examples to DexUni solver config
yuecideng Sep 29, 2026
1e9d5f9
Merge remote-tracking branch 'origin/main' into codex/dexuni-interfac…
yuecideng Sep 29, 2026
347ce76
fix(sim): unify Newton solver adaptation on DexUni
yuecideng Sep 29, 2026
aa9f0b6
feat(sim): expose DexUni contact sensor data
yuecideng Sep 29, 2026
1832e56
test(sim): cross-check DexUni contact impulses
yuecideng Sep 29, 2026
c763aad
test(sim): assert DexUni contact invariants
yuecideng Sep 29, 2026
32e08fc
Merge remote-tracking branch 'origin/main' into codex/dexuni-interfac…
yuecideng Oct 3, 2026
7049fcf
fix(sim): update DexUni migration validation
yuecideng Oct 3, 2026
a09bd7e
docs(sim): use DexUni terminology consistently
yuecideng Oct 3, 2026
ad9ba87
wip
yuecideng Oct 4, 2026
b589354
Merge latest main into DexUni interface adaptation
yuecideng Oct 10, 2026
9428020
feat(physics): support current DexUni two-way coupling contracts
yuecideng Oct 10, 2026
6e60b8e
fix(dexsim): adapt latest 0.5.1 runtime contracts
yuecideng Oct 20, 2026
794bbb9
feat(dexsim): consolidate two-way coupling adaptation from PR #720
yuecideng Oct 21, 2026
e8a6419
fix(dexsim): reconcile current particle material and task contracts
yuecideng Oct 21, 2026
b8922a0
Merge latest main into DexSim adaptation
yuecideng Oct 27, 2026
57d0262
fix(dexsim): follow current DexUni dispatch and device defaults
yuecideng Oct 27, 2026
1eef398
feat(sim): expose DexSim controls and deformable initialization
Oct 27, 2026
9a2d016
fix(sim): preserve continuous URDF joint limits for DexUni
yuecideng Oct 27, 2026
a48f07c
fix(examples): complete DexUni workflows and physical placement checks
yuecideng Oct 27, 2026
f9f128d
Merge main be57e1b97 into DexUni adaptation
yuecideng Oct 27, 2026
4d72509
fix(examples): preserve placement asset frames across renderers
yuecideng Oct 27, 2026
da67a3e
Merge main into codex/adapt-latest-dexsim
yuecideng Nov 2, 2026
37085da
Merge main and adapt DexSim 0.6 contact reports
yuecideng Nov 7, 2026
731427f
refactor(sim): narrow Newton articulation root options
yuecideng Nov 7, 2026
834f88d
refactor(sim): remove legacy AutoSolver compatibility
yuecideng Nov 7, 2026
a6c3693
docs(sim): standardize native DexUni automatic dispatch
yuecideng Nov 7, 2026
f249fbe
update dexsim version
yuecideng Nov 7, 2026
8f792d0
Merge branch 'main' into codex/adapt-latest-dexsim
yuecideng Nov 7, 2026
28f8b6a
fix(sensors): honor native contact sampling boundaries
yuecideng Nov 7, 2026
0e304ee
feat(cable): adapt foundation and episode defaults to DexSim 0.6
KeqiYe Nov 9, 2026
6ca6566
feat(cable): integrate unified observations replay and visualization
KeqiYe Nov 9, 2026
da1dabd
feat(cable): adapt grasping and YAM routing to DexSim 0.6
KeqiYe Nov 9, 2026
edf83b9
fix(gym): preserve inline cable mesh geometry in config loading
KeqiYe Nov 11, 2026
5d8f201
Merge main into codex/cable-framework
yuecideng Nov 12, 2026
6a7a29d
fix(cable): preserve replay origins and select visible poses before e…
yuecideng Nov 12, 2026
114e8be
Merge updated cable framework into cable routing
yuecideng Nov 12, 2026
df8e304
docs(cable): record synchronized routing checks and source attribution
yuecideng Nov 12, 2026
694ddda
feat(pickup): support contact grasps and unify the cable expert
yuecideng Nov 12, 2026
1a8bc30
feat(tasks): route cables through configured Task Program
yuecideng Nov 12, 2026
0a2b25f
fix(sim): register CableObject facades for USD cables
KeqiYe Nov 13, 2026
dbe47e8
Merge main into cable task program branch
KeqiYe Nov 13, 2026
479da4f
Merge latest main Gaussian visuals into cable task program branch
KeqiYe Nov 13, 2026
2e502cf
fix(task): stabilize contact cable routing and release
KeqiYe Nov 13, 2026
8536d99
feat(task): execute the Franka rope wrap as a configured Task Program
KeqiYe Nov 16, 2026
48d803c
fix(task): honor wrap phase durations and diagnostic step limits
KeqiYe Nov 16, 2026
40a8f52
Merge main and preserve cable registration during USD preflight
KeqiYe Nov 16, 2026
99d4ef1
Merge USD cable support and adopt main's equivalent Z-cylinder dimens…
KeqiYe Nov 16, 2026
b6ab656
Bind task cables from USD scene inventory and ship their assets
KeqiYe Nov 16, 2026
f2be8ea
feat(sim): support sparse physics overrides on USD cables
KeqiYe Nov 16, 2026
855ce37
Merge branch 'integrate/usd-cable-rc2' into integrate/route-cable-rc2
KeqiYe Nov 16, 2026
764e368
Merge branch 'integrate/route-cable-rc2' into integrate/franka-cable-rc2
KeqiYe Nov 16, 2026
1beeba0
feat(task): import the Franka wrapping cable from USD
KeqiYe Nov 16, 2026
cfc184e
fix(task): preserve the Franka rope material in scene-linear USD
KeqiYe Nov 16, 2026
d05a790
Load the routing task cable from a packaged USD curve
KeqiYe Nov 16, 2026
85f25b4
test(gym): exercise USD cable overrides through scene preflight and r…
KeqiYe Nov 16, 2026
1cf85c0
Merge branch 'integrate/route-cable-rc2' into integrate/franka-cable-rc2
KeqiYe Nov 16, 2026
ac38b4d
Merge branch 'integrate/usd-cable-rc2' into integrate/route-cable-rc2
KeqiYe Nov 16, 2026
27652ab
fix(task): retain the ground plane and use the authored default cente…
KeqiYe Nov 16, 2026
367fc03
Document the paired rc2 route acceptance results
KeqiYe Nov 16, 2026
4a3aa8d
Merge branch 'integrate/route-cable-rc2' into integrate/franka-cable-rc2
KeqiYe Nov 16, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions NOTICE
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
EmbodiChain
Copyright (c) 2021-2026 DexForce Technology Co., Ltd.

The cable routing application includes geometry and routines adapted from
RoboSimStudio, Copyright 2026 Kaiyuan Chen, licensed under Apache-2.0.
Source: https://github.com/robosimstudio/robosimstudio
Revision: 73739abe212f963e8a9f5862b27bca370df091a7

The external YAM i2rt model contains the YAM arm and linear_4310 gripper,
Copyright (c) I2RT Robotics, under the MIT license. The source model directory
and RoboSimStudio NOTICE identify this attribution and license.
Expand Down
2 changes: 1 addition & 1 deletion agent_context/MAP.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -438,7 +438,7 @@ topics:
- id: atomic-actions
title: Atomic Skills
aliases: [atomic skill, atomic skills, atomic action, 原子技能, 原子动作]
keywords: [PlanningBudget, PlanningRecovery, ExecutionPlanLifecycle, AtomicSkillEngine, run-atomic-skill, PlanningContext, ExecutionSession, ExecutionRunner, SkillInvocation,
keywords: [PlanningBudget, PlanningRecovery, ExecutionPlanLifecycle, PickUp, GraspGoal, ContactGraspGoal, AtomicSkillEngine, run-atomic-skill, PlanningContext, ExecutionSession, ExecutionRunner, SkillInvocation,
hand_geometry_cfgs, GraspOpeningTarget, prepare_grasp_query, scoped grasp preparation,
RecoveryPolicy, HeldObjectGuardRequest, PhaseEffectGateRequest, articulation_geometry, control-grid retiming,
AffordanceSamplingContext, AffordancePoseCandidates, AffordanceSample, affordance sampling]
Expand Down
12 changes: 12 additions & 0 deletions agent_context/topics/atomic-actions/atomic-actions.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,18 @@ Hosts acquire versioned measurements; verification is the boundary that commits
or invalidates observed effects. Preserve required stop/hold boundaries on the
executed control grid instead of relying only on native planner timing.

`PickUp` accepts a rigid `GraspGoal` or an explicit `ContactGraspGoal`.
The rigid path projects its existing held-object relation. Contact pickup
requires a free task-state resource, shares the approach/close/lift command
assembly and declares `EffectVerificationRequirement(kind="contact_grasp")`
without a rigid held-object update. Hosts supply physical evidence such as
material-point lift and tool-frame retention before accepting that boundary.
The routing host samples its material reference at the end of the `close`
phase, including `grasp_settle_steps`, before lifting. Native contact IK paths
use `MotionPolicy.interpolate_position_step` for lift sampling on the control
grid; joint limits can lengthen them. Numerical material-coordinate geometry
belongs to `compute/geometry/cable.py`.

## Package map

| Concern | Source of truth |
Expand Down
8 changes: 5 additions & 3 deletions agent_context/topics/atomic-actions/execution.md
Original file line number Diff line number Diff line change
Expand Up @@ -192,9 +192,11 @@ physically qualified task needs a lower speed than the selected robot's limits.
default) or `zero` (explicit position-only control).
Configured execution policies decode the same field under `motion`.
`AtomicSkill.build_plan` derives missing velocities after composite skills
have assembled their final full-robot positions and timing. The first command,
both ends of every stationary joint interval, and terminal settling commands
use zero velocity; failed rows remain held.
have assembled their final full-robot positions and timing. By default the first
command, both ends of a stationary joint interval and terminal settling commands
use zero velocity. For consecutive explicitly timed trajectories,
`MoveJointsOptions.preserve_velocity_samples` preserves the supplied arrival
velocities across phase boundaries. Failed rows remain held.

`SimulationExecutionAdapter` always clears absent velocity references to zero;
it never substitutes observed velocities or depends on peer active masks.
Expand Down
10 changes: 8 additions & 2 deletions agent_context/topics/simulation-system/deformables.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,8 +108,14 @@ Focused coverage: `tests/sim/test_deformable_cfg.py`,
`CableObjectCfg` and `CableObject(BatchEntity)` are independent of particle-set
deformables. `SimulationManager.add_cable_object()` lowers through
`spawn/descriptors.py` into `CableDesc`, declares in the existing `SpawnScene`,
and binds the same facade in place during `prepare()`. Backend capabilities
reject Default, CPU, other Newton solvers and gradient mode; use DexUni on CUDA.
and binds the same facade in place during `prepare()`. `add_usd(UsdImportCfg)`
also returns a `CableObject` per imported cable under its source resource key,
with the same UID lookup, segment state and reset as a procedural declaration.
Cable geometry, placement and visuals come from the parsed `CableDesc`.
A sparse `asset_cfgs` entry keyed by the simulation curve prim can override
the UID, `fixed_segments`, `collision_filter_span` and individual `attrs` physics and
contact fields before declaration. Omitted fields retain the parsed values.
Cable declarations require DexUni on CUDA with gradient mode disabled.
With this backend, an arena containing a cable cannot also contain fluid,
cloth or soft-body particles: cable episode reset does not support those
particles. Spawn checks the native cable and particle descriptors for direct
Expand Down
26 changes: 26 additions & 0 deletions agent_context/topics/task-programs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -203,6 +203,13 @@ the closed-field decoder. Omitting `velocity_limit` preserves the Robot's
ordered per-joint speed caps; an explicit scalar request is intersected with
those caps rather than replacing them.

Configured motion accepts `interpolate_position_step` for native Cartesian
sampling. `MoveEndEffectorOptions.preserve_cartesian_samples` retains authored
Cartesian samples; `MoveJointsOptions.preserve_samples` consumes explicitly
sampled joint commands at the host cadence using `ik_interp`. These declarations
retain normal Atomic velocity qualification and do not certify collision-free
motion. Inactive sampling additions preserve existing integration fingerprints.

Configured motion also accepts explicit `interpolation_mode` and `ik_seed_mode`.
`fixed_grid` requires `acceleration_limit: null` and no scalar speed override;
omission retains the existing adaptive policy and acceleration default.
Expand All @@ -217,6 +224,25 @@ declarations in the integration and timing in the execution policy, rather
than placing a precomputed bottle world pose in the program. Omitting `target`
retains the original internal-axis pouring behavior.

`scene_binding.cables` declares material-state native identities without rigid
object semantics or root-pose providers. The allowlisted
`runtime_services.cable_material` binds those identities to measured material
coordinates and closed target declarations. Its calls lower to existing
`PickUp(ContactGraspGoal)`, `MoveEndEffector`, and `MoveJoints` skills; the program
owns stage ordering. The bridge captures contact references only after an
acknowledged close frame and checks material slip after every consumed action.
References are fresh per bridge, guarded by its episode scope, and mapped from
selected robot rows to native cable arenas. Evaluation consumes qualified
`cables/<uid>/<measurement>` channels, including strict endpoint geometry and
episode slip. Keep routing acceptance in the deployment's named evaluation rules.

`FrankaRopeWrap-v1` uses the registered `simulation.cable_wrap_phase` call.
Each phase lowers its checked portion of the full Franka arm and finger trajectory
to `MoveJoints`. Scene reset owns pre-roll. The monitor latches its slip reference
after closure and a simultaneous two-finger contact sample. The final
`wrap_success` condition reads all 19 measured checks. Task components live
under `configs/tasks/manipulation/cable/franka_rope_wrap/` in the task extension.

The configured lowerer allowlist also exposes profile-owned Park, AxisAlign,
relative Place and coordinated transport. Their declarations in
`integrations/_configured_services.py` select exact Atomic Skill descriptors;
Expand Down
112 changes: 112 additions & 0 deletions docs/source/api_reference/public_api.rst
Original file line number Diff line number Diff line change
Expand Up @@ -33,6 +33,20 @@ Offline job preflight, run, resume and verified inspection commands.

main

embodichain.compute.geometry.cable
----------------------------------

Pure tensor geometry for ordered cable endpoints, material-coordinate sampling
and slip of the same material point in a moving tool frame.

.. currentmodule:: embodichain.compute.geometry.cable

.. autosummary::

sample_cable_material
cable_endpoints
cable_grasp_slip

embodichain.compute.geometry.particles
--------------------------------------

Expand Down Expand Up @@ -3156,6 +3170,22 @@ embodichain.lab.sim.atomic_skills.primitives

BUILTIN_SKILL_TYPES

embodichain.lab.sim.atomic_skills.primitives.pick_up
--------------------------------------------------

PickUp shares motion assembly between rigid-object pickup and contact-only
pickup. Contact goals require explicit physical verification and retain no
fixed object-to-tool relation.

.. currentmodule:: embodichain.lab.sim.atomic_skills.primitives.pick_up

.. autosummary::

GraspGoal
ContactGraspGoal
PickUp
PickUpOptions

embodichain.lab.sim.atomic_skills.requirements
-----------------------------------------------

Expand Down Expand Up @@ -4763,6 +4793,88 @@ reference-state resets and terminal snapshots before automatic row resets.
.. automodule:: embodichain_tasks.locomotion.tracking.g1_motion
:members:

embodichain_tasks.manipulation.cable.franka_rope_wrap
-----------------------------------------------------

Build the Franka floor-pickup scene. The configuration defines the cable centerline,
fixed first segment, post and jaw geometry. The reset functor settles the cable
before the motion clock starts.

.. currentmodule:: embodichain_tasks.manipulation.cable.franka_rope_wrap

.. autosummary::

cable_points
load_config
materialize_deployment
prepare_models
settle_franka_rope
task_directory

embodichain_tasks.manipulation.cable.route_the_cable
----------------------------------------------------

Two-spool routing with observed material geometry and measured grasp-slip,
penetration and end-insertion acceptance.

.. currentmodule:: embodichain_tasks.manipulation.cable.route_the_cable

.. autosummary::

RouteTheCableEnv
measure_route

embodichain_tasks.manipulation.cable.wrap_evaluation
----------------------------------------------------

Attach episode-scoped contact sampling after the scene settles. The monitor records
both fingers at the same physical sample and tracks slip of the grasped material point.

.. currentmodule:: embodichain_tasks.manipulation.cable.wrap_evaluation

.. autosummary::

attach_wrap_monitor

embodichain_tasks.manipulation.cable.wrap_integration
-----------------------------------------------------

Bind a named wrap phase to the full-robot joint position and velocity commands
executed by the standard Task Program bridge.

.. currentmodule:: embodichain_tasks.manipulation.cable.wrap_integration

.. autosummary::

CableWrapPhaseFactory

embodichain_tasks.manipulation.cable.wrap_measurements
------------------------------------------------------

Evaluate recorded control frames against all 19 physical acceptance checks,
including bilateral grasp, line winding, post contact and the final hold.

.. currentmodule:: embodichain_tasks.manipulation.cable.wrap_measurements

.. autosummary::

evaluate_wrap

embodichain_tasks.manipulation.cable.wrap_motion
------------------------------------------------

Plan the continuous tool path and solve its joint targets in time order.
The phase boundaries partition the trajectory on the configured control grid.
The first sample describes the settled start at zero seconds.

.. currentmodule:: embodichain_tasks.manipulation.cable.wrap_motion

.. autosummary::

PHASE_END_S
WrapMotion
plan_wrap_motion

embodichain_tasks.manipulation.push_cube
----------------------------------------

Expand Down
7 changes: 7 additions & 0 deletions docs/source/api_reference/robot_catalogs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -629,6 +629,13 @@ and cache prefixes while using the shared core download and locking services.

.. autoclass:: embodichain_robots.franka.assets.FrankaPandaArm

.. autoclass:: embodichain_robots.franka.assets.FrankaRopePads

The cable-wrap embodiment resolves the flat-pad model through
``FrankaRopePads/Panda/Fr3RopePadsV1.urdf``.

.. autofunction:: embodichain_robots.franka.rope_pads.apply_rope_pads

.. autofunction:: embodichain_robots.robotiq.two_finger.robotiq85_joint_positions


Expand Down
28 changes: 21 additions & 7 deletions docs/source/overview/sim/atomic_skills/builtin_skills.md
Original file line number Diff line number Diff line change
Expand Up @@ -195,7 +195,7 @@ The animations below are the runnable simulator demonstrations under
|---|---|---|---|---|---|
| `move_end_effector` | `EndEffectorPoseGoal` | `primary.motion` | none | none | none |
| `move_joints` | `JointPositionGoal` | `primary.motion` | named target only: command matching `target` on `primary.motion` | none | none |
| `pick_up` | `GraspGoal` | `primary.motion`, `primary.grasp` | `primary.grasp`: `open`, `grasp` | semantic object/entity | attach object to the `primary.motion` target |
| `pick_up` | `GraspGoal` or `ContactGraspGoal` | `primary.motion`, `primary.grasp` | `primary.grasp`: `open`, `grasp` | semantic object or explicit contact pose | rigid held relation or terminal contact verification |
| `axis_align` | `AxisAlignGoal` | `primary.motion`, `primary.grasp` | `primary.grasp`: `open`, `grasp` | unheld object with `AxisAlignAffordance` | open-loop pick and align while retaining the grasp |
| `move_held_object` | `HeldObjectPoseGoal` | `primary.motion`, `primary.grasp` | `primary.grasp`: `grasp` | object held exclusively by the `primary.motion` target | preserve attachment |
| `pour` | `PourGoal` | `primary.motion`, `primary.grasp` | `primary.grasp`: `grasp` | exclusively held object with `AxisAlignAffordance` | preserve attachment; open-loop rotate and return |
Expand Down Expand Up @@ -410,17 +410,31 @@ named_goal = JointPositionGoal(target="home")

## `PickUp`

Plans **approach -> close hand -> lift** and declares the object attached to the
bound motion target.
Plans **approach -> close hand -> lift**. A rigid `GraspGoal` declares a held-object
relation for the bound motion target. `ContactGraspGoal(grasp_xpos=...)` uses an
observed TCP pose and requires physical contact verification, with no fixed
object-to-tool relation.

| Contract | Value |
|---|---|
| Skill ID | `pick_up` |
| Goal | `GraspGoal(semantics=..., grasp_xpos=None, object_pose=None)` |
| Goal | `GraspGoal(semantics=..., grasp_xpos=None, object_pose=None)` or `ContactGraspGoal(grasp_xpos=...)` |
| Binding contract | `primary.motion` plus disjoint `primary.grasp` |
| Precondition | When `object_pose` is omitted, `ObjectSemantics.entity_id` must resolve in the planning snapshot (the deprecated live `entity` fallback remains temporarily); an explicit `SceneEntityPose` must reference a snapshot entity; an `AntipodalAffordance` is required when neither an explicit grasp pose nor `fixed_object_to_eef` is supplied |
| Effect | write `HeldObjectState` for the bound motion target |
| Verification | the attachment effect must be verified during closed-loop execution |
| Precondition | Rigid goals resolve their object pose and require an affordance when no grasp is supplied; contact goals require a free task-state resource; late-bound poses resolve in the planning snapshot |
| Effect | Rigid goals write `HeldObjectState`; contact goals declare a physical verification requirement |
| Verification | Rigid held effects and contact-only grasp effects require physical verification during closed-loop execution |

Contact goals require an unoccupied single/coordinated task-state resource.
Their plan declares `EffectVerificationRequirement(kind="contact_grasp")`,
which the host must resolve with physical evidence. The cable routing host
measures material-point lift and retention in the tool frame. Rigid-object
calibrations and downstream object targets belong to `GraspGoal` pickup.

Contact pickup uses the existing `hand_interp_steps`, `grasp_settle_steps` and
`lift_height` options. Its native IK lift is sampled using
`MotionPolicy.interpolate_position_step` and the control period, then qualified
against joint limits. The motion-generator and external-nominal paths retain
their backend timing. Both goal types use the same effect assembly boundary.

`grasp_xpos` may be `(4, 4)`, `(B, 4, 4)`, or a `SceneEntityPose`. A scene
reference resolves the latest grasp pose and registers its entity as a recovery
Expand Down
Loading