psagents

LCLS beamline copilot agent. Use for any experiment operation at an LCLS or LCLS-II hutch: starting/monitoring data runs (/take-run), beam readiness checks (/are-we-ready), beam alignment optimization (/align-beam), and SmallData/LUTE configuration (/smd-config). Triggers on: take a run, take data, collect data, start a run, run the DAQ, are we ready, awr, beam blocked, beam path, align beam, optimize beam, smd config, smalldata setup, lute setup, mfx-opr, beamline operator, hutch operator, hutch copilot. Use whenever the user mentions an LCLS experiment name (e.g. mfxl1013621), a hutch (MFX, TMO, RIX, CXI, XPP, MEC, TXI), or any live beamline operation.

Access LCLS /cds filesystem from S3DF. Use when reading hutch-python configs, happi DB, IOC files, presets, or any file that lives on the CDS/PCDS filesystem and is not mounted on S3DF. Also covers when EPICS CA access requires a controls machine.

Persistent ambient experiment context manager for LCLS beamtime. Always active once hutch-copilot is triggered. Silently observes every user interaction, extracts experiment-relevant information, maintains a timestamped log and a persistent JSON state file, posts condition changes to the eLog as human-readable notes, and recovers full context from the state file on session restart. Triggers on: coordinate experiment, update conditions, new sample, we changed to, context, current conditions, experiment state, beamtime log, end of shift, shift summary, handoff.

LCLS data analysis setup and refinement sub-skill for hutch-copilot. Use for configuring and running LUTE analysis workflows after data collection: SFX pipeline setup (/setup) and parameter refinement after first output (/refine). Calibration runs (GEOM, DARK) are handled by /take-run with a run_type tag — no separate calibrate command. Wizard logic lives here; consults ask-lute as a reference brain and ask-cctbx-xfel for SFX parameters. No bridge required — works entirely offline from S3DF. Triggers on: set up analysis, configure lute, sfx pipeline, refine parameters, check output, analyze data, lute setup, lute wizard.

Expert assistant for cctbx.xfel programs, parameters, and the cctbx.xfel GUI workflow. Use when users ask about any cctbx.xfel.* executable — what it does, what parameters it takes, how to configure it for an LCLS SFX experiment, or how to run the full cctbx.xfel SFX pipeline (process → ensemble refinement → merge) — or about the cctbx.xfel GUI itself (Trial/Dataset/Task setup, settings.phil, remote access, photon energy calibration). Covers cctbx.xfel.merge (full phil), cctbx.xfel.xtc_process, cctbx.xfel.process, cctbx.xfel.submit_job, cctbx.xfel.time_varying_refinement, cctbx.xfel.detector_residuals, cctbx.xfel.mpi_integrate, xfel.fee_calibration, and all other cctbx.xfel.* tools. Trigger on: cctbx.xfel, xfel.merge, xtc_process, time_varying_refinement, TDER, ensemble refinement, mpi_integrate, xfel submit_job, detector_residuals, cctbx SFX pipeline, merging.d_min, scaling.model, postrefinement, filter_experiments_by_rmsd, cctbx.xfel weather drift trumpet_plots, cctbx.xfel GUI, Trial Dataset Task, settings.

LUTE (LCLS Unified Task Executor) reference brain. Consult for LUTE internals: task catalog, YAML configuration syntax, workflow/DAG structure, result passing, SLURM submission, executor/IPC details, hutch capabilities, and task creation. This skill is a reference resource — it answers questions about LUTE and provides the knowledge base that analyze-data uses to drive experiment setup. Triggers on: lute task, lute yaml, lute configuration, managed task, executor, IPC, DAG syntax, workflow, result passing, in_file out_file, lute database, task creation, lute slurm, lute internals.

Query the PCDS happi device database for LCLS beamline components. Use when asked about device names, PV prefixes, z-positions, beamline maps, mirrors, YAGs, slits, attenuators, or any hardware device registered in the PCDS happi database.

Real-time beamtime note-taking assistant for LCLS experiments. Use when logging beam delivery, alignment steps, faults, or tooling work during MFX (or other hutch) shifts. Maintains beam_notes.md with consistent formatting, timestamps, and section structure.