Args:
    name: Document name. FreeCAD may sanitize or deduplicate it, so read the actual name from the result.

obj_name is the BASE object, except for loft/sketch/variables/datum_plane/hull (the NEW object); params go in obj_properties. Committed mutations are rollback-able session steps.

Args:
    obj_type: Object type for create_object, e.g. "Part::Box".
    ops: Operation dicts for batch.
    stop_on_error: Stop a batch at the first failure.
    description: One-line purpose of the step; the Steps panel's row label.

Reference: operation_help("<operation>").

The code must not touch the GUI: no FreeCADGui, views or selection, document objects, recompute or save; use execute_code for those. Output goes through task_print(...); print() is not captured.

Args:
    code: Background-safe Python code.

Args:
    task_id: Task ID returned by execute_code_async.

Returns: JSON {status: running | done | error, output, traceback}.

The run is transactional: a mutating snippet commits as one undoable step, a read-only run is not recorded.

Args:
    code: Code to run; start with a # comment naming the step, which becomes the step's row label and description.
    doc_name: Bind the transaction, step journal and App.ActiveDocument to this document; defaults to the session's document, else the process's home document.

Costly in context: reserve it for visual checks; prefer get_objects or measure_geometry for numbers. Without width/height the long edge is capped at 384 px.

Args:
    view_name: Camera view, one of the nine names.
    width/height: Pixel size; a smaller image saves context.
    focus_object: Fit this object; the default frames everything.
    doc_name: Frame this document; another agent may have switched the foreground tab.

Args:
    obj_name: Omit to list the objects; pass a name to read that object instead.
    limit/offset: Page size and start index for the object list.

Args:
    limit/offset: Page size and start index.

Actions: start (doc_name, create_document?) | status | get_steps (limit/offset) | rollback (to_step, force?) | redo (n?) | add_note (note, note_type?) | pause | resume (session_id) | list | complete (save?, save_path?, description?, tags?).

Reference: operation_help("session").

Each step is a cad() argument dict and waits for release in the CADPilot Steps panel or via step_control.

Reference: operation_help("step_plan").

Actions: run_next | run_all | run_to | rollback_to | reexecute | accept | reject | update | insert | replay | snapshot | clear_plan | reset (needs confirm=true) | status.

Reference: operation_help("step_control").

Args:
    level: Minimum level: DEBUG, INFO, WARNING or ERROR.
    grep: Substring filter over message and detail.
    since_seq: Only records after this sequence number.
    limit: Max records (default 100).

Reference: operation_help("get_addon_log").

Probes the RPC port, the process, the addon install and its logs.

Args:
    host: FreeCAD host to probe; defaults to this server's --host.
    dismiss: Also close the modal dialog blocking every call (Cancel, nothing confirmed).

Reference: operation_help("diagnose").

Args:
    name: Short name, e.g. "flanged pipe via loft".
    description: What it does and when to use it.
    code: Optional Python snippet that implements it.
    tags: Retrieval tags.

Returns: The stored pattern_id.

Args:
    query: Keywords describing the task, e.g. "boolean cut holes cylinder".
    limit: Max results (default 3).

Returns: JSON list of matching patterns with code/steps.

With doc_name and obj_name you get an object's TypeId, settable properties, methods and docstring. With dotted_name (e.g. "Part.makeLoft") you get a docstring or a member list.

Returns: JSON volume_mm3, area_mm2, bbox, center_of_mass, element counts, is_valid, shape_type. Numbers carry 6 significant digits; the bbox is OCC's bound box, exact for planar shapes and within about 0.1 mm on curved ones.

Args:
    element: Which kind to list: faces, edges or vertices.
    limit: Max entries (1 to 200, default 50).
    offset: How many entries to skip.

Returns: total, returned, and a '{element}' list of {index, name, type, area or length, center, planar-face normal}.

Returns: JSON distance_mm, intersects, common_volume_mm3.

Args:
    element: Which kind: face, edge or vertex.
    element_index: 0-based index; call get_topology to find the indices.

Args:
    element / element_index: Element on the object to move.
    target_element / target_element_index: Element on the target.
    mode: touch (face to face, normals opposing), center (centers coincide) or axis (cylindrical axes aligned).
    offset: Extra distance along the target normal; positive moves away.

Returns: JSON with anchors as {name: {pos, dir, source: "auto" | "explicit"}}.

Args:
    anchors: {name: {"pos": [x, y, z], "dir": [x, y, z] | null}}.
    replace: Replace all existing anchors instead of merging.
    coord_frame: local stores values as given; global converts them first, for global source coordinates.

Args:
    mates: Non-empty list of mate dicts.
    tolerance: Maximum allowed post-move residual in mm (default 0.1).
    stop_on_error: Stop at the first failed mate (mates already applied stay; nothing moves only if the FIRST mate fails).

Reference: operation_help("assemble").

Args:
    checks: Optional anchor-pair distance checks.
    float_threshold: Gap in mm above which a part counts as floating (default 1.0).
    interference_min_volume: Smallest common volume in mm3 worth reporting.

Returns: JSON floating/interferences/checks lists and a summary.

Workflow: start(ground=part), add_component(part), mate(a, b, joint_type, trim?), solve, verify, complete. Moving a parent part and re-solving moves the children. rollback(to_step) restores placements atomically. A mate ref is {"part": <name>} plus exactly one of face="FaceN", anchor=<name> or point=[x,y,z].

Reference: operation_help("assembly_session").