[{"data":1,"prerenderedAt":4229},["ShallowReactive",2],{"navigation":3,"\u002Fhow-to\u002Fautomate\u002Fadvanced-error-handling":909,"\u002Fhow-to\u002Fautomate\u002Fadvanced-error-handling-surround":4224},[4,59,188,271,445,591,760,791],{"title":5,"type":6,"device":6,"path":7,"stem":8,"children":9,"page":41},"Get Started",null,"\u002Fget-started\u002F","01.get-started",[10,15,42,47,51,55],{"title":11,"path":12,"stem":13,"type":14,"device":6},"Welcome to UniteLabs","\u002Fget-started\u002Fwelcome\u002F","01.get-started\u002F00.welcome","landing",{"title":16,"type":6,"device":6,"path":17,"stem":18,"children":19,"page":41},"Setup","\u002Fget-started\u002Fsetup\u002F","01.get-started\u002F01.setup",[20,25,29,33,37],{"title":21,"path":22,"stem":23,"type":24,"device":6},"Get access","\u002Fget-started\u002Fsetup\u002Fget-access\u002F","01.get-started\u002F01.setup\u002F00.get-access","howto",{"title":26,"path":27,"stem":28,"type":24,"device":6},"GroundControl","\u002Fget-started\u002Fsetup\u002Fgroundcontrol\u002F","01.get-started\u002F01.setup\u002F10.groundcontrol",{"title":30,"path":31,"stem":32,"type":24,"device":6},"Connect to Platform","\u002Fget-started\u002Fsetup\u002Fconnect-to-platform\u002F","01.get-started\u002F01.setup\u002F20.connect-to-platform",{"title":34,"path":35,"stem":36,"type":24,"device":6},"Set up your development machine","\u002Fget-started\u002Fsetup\u002Fdeveloper-machine\u002F","01.get-started\u002F01.setup\u002F30.developer-machine",{"title":38,"path":39,"stem":40,"type":24,"device":6},"SDK installation","\u002Fget-started\u002Fsetup\u002Fsdk-installation\u002F","01.get-started\u002F01.setup\u002F40.sdk-installation",false,{"title":43,"path":44,"stem":45,"type":46,"device":6},"Control a device","\u002Fget-started\u002Fcontrol-a-device\u002F","01.get-started\u002F02.control-a-device","tutorial",{"title":48,"path":49,"stem":50,"type":46,"device":6},"Liquid handling as code","\u002Fget-started\u002Fliquid-handling-as-code\u002F","01.get-started\u002F03.liquid-handling-as-code",{"title":52,"path":53,"stem":54,"type":46,"device":6},"Automate your workflows","\u002Fget-started\u002Fautomate-your-workflows\u002F","01.get-started\u002F04.automate-your-workflows",{"title":56,"path":57,"stem":58,"type":6,"device":6},"Self-Paced Setup Guide","\u002Fget-started\u002Fself-onboarding\u002F","01.get-started\u002F90.self-onboarding",{"title":60,"type":6,"device":6,"path":61,"stem":62,"children":63,"page":41},"How-to","\u002Fhow-to\u002F","02.how-to",[64,118,163,180],{"title":65,"type":6,"device":6,"path":66,"stem":67,"children":68,"page":41},"Connectors and devices","\u002Fhow-to\u002Fintegrate\u002F","02.how-to\u002F02.integrate",[69,102],{"title":70,"type":6,"device":6,"path":71,"stem":72,"children":73,"page":41},"Connect a device","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device",[74,78,82,86,90,94,98],{"title":75,"path":76,"stem":77,"type":24,"device":6},"Connector Configuration","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fconnector-configuration\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F10.connector-configuration",{"title":79,"path":80,"stem":81,"type":24,"device":6},"With an executable","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fwith-an-executable\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F20.with-an-executable",{"title":83,"path":84,"stem":85,"type":24,"device":6},"From source","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Ffrom-source\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F30.from-source",{"title":87,"path":88,"stem":89,"type":24,"device":6},"Build your own","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fbuild-yourself\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F40.build-yourself",{"title":91,"path":92,"stem":93,"type":24,"device":6},"Headless install","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fheadless-install\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F50.headless-install",{"title":95,"path":96,"stem":97,"type":24,"device":6},"Raspberry Pi","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fraspberry-pi\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F55.raspberry-pi",{"title":99,"path":100,"stem":101,"type":24,"device":6},"Multi-device Networking","\u002Fhow-to\u002Fintegrate\u002Fconnect-a-device\u002Fmultiple-devices\u002F","02.how-to\u002F02.integrate\u002F20.connect-a-device\u002F60.multiple-devices",{"title":103,"type":6,"device":6,"path":104,"stem":105,"children":106,"page":41},"Use a device","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device",[107,110,114],{"title":26,"path":108,"stem":109,"type":24,"device":6},"\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fgroundcontrol\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F10.groundcontrol",{"title":111,"path":112,"stem":113,"type":24,"device":6},"Platform","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fplatform\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F20.platform",{"title":115,"path":116,"stem":117,"type":24,"device":6},"UniteLabs SDK & REST API","\u002Fhow-to\u002Fintegrate\u002Fuse-a-device\u002Fpython\u002F","02.how-to\u002F02.integrate\u002F30.use-a-device\u002F30.python",{"title":119,"type":6,"device":6,"path":120,"stem":121,"children":122,"page":41},"Workflows","\u002Fhow-to\u002Fautomate\u002F","02.how-to\u002F07.automate",[123,127,131,135,139,143,147,151,155,159],{"title":124,"path":125,"stem":126,"type":24,"device":6},"Deploy a workflow","\u002Fhow-to\u002Fautomate\u002Fdeploy-a-workflow\u002F","02.how-to\u002F07.automate\u002F30.deploy-a-workflow",{"title":128,"path":129,"stem":130,"type":24,"device":6},"Run a workflow","\u002Fhow-to\u002Fautomate\u002Frun-a-workflow\u002F","02.how-to\u002F07.automate\u002F35.run-a-workflow",{"title":132,"path":133,"stem":134,"type":24,"device":6},"CI\u002FCD for workflows","\u002Fhow-to\u002Fautomate\u002Fcicd-for-workflows\u002F","02.how-to\u002F07.automate\u002F40.cicd-for-workflows",{"title":136,"path":137,"stem":138,"type":24,"device":6},"HITL basics","\u002Fhow-to\u002Fautomate\u002Fbasic-hitl\u002F","02.how-to\u002F07.automate\u002F50.basic-hitl",{"title":140,"path":141,"stem":142,"type":24,"device":6},"Slack notifications and operator confirmation","\u002Fhow-to\u002Fautomate\u002Fslack-notifications\u002F","02.how-to\u002F07.automate\u002F52.slack-notifications",{"title":144,"path":145,"stem":146,"type":24,"device":6},"Typed operator inputs","\u002Fhow-to\u002Fautomate\u002Ftyped-operator-inputs\u002F","02.how-to\u002F07.automate\u002F55.typed-operator-inputs",{"title":148,"path":149,"stem":150,"type":24,"device":6},"Pause and resume a run","\u002Fhow-to\u002Fautomate\u002Fpause-and-resume\u002F","02.how-to\u002F07.automate\u002F57.pause-and-resume",{"title":152,"path":153,"stem":154,"type":24,"device":6},"Error recovery","\u002Fhow-to\u002Fautomate\u002Fbasic-error-handling\u002F","02.how-to\u002F07.automate\u002F60.basic-error-handling",{"title":156,"path":157,"stem":158,"type":24,"device":6},"Advanced error handling","\u002Fhow-to\u002Fautomate\u002Fadvanced-error-handling\u002F","02.how-to\u002F07.automate\u002F70.advanced-error-handling",{"title":160,"path":161,"stem":162,"type":24,"device":6},"Emit lineage events","\u002Fhow-to\u002Fautomate\u002Femitting-lineage-events\u002F","02.how-to\u002F07.automate\u002F90.emitting-lineage-events",{"title":164,"type":6,"device":6,"path":165,"stem":166,"children":167,"page":41},"Data","\u002Fhow-to\u002Fobserve\u002F","02.how-to\u002F08.observe",[168,172,176],{"title":169,"path":170,"stem":171,"type":24,"device":6},"File System Connector","\u002Fhow-to\u002Fobserve\u002Ffilesystem-connector\u002F","02.how-to\u002F08.observe\u002F10.filesystem-connector",{"title":173,"path":174,"stem":175,"type":24,"device":6},"Building an ETL","\u002Fhow-to\u002Fobserve\u002Fbuilding-an-etl\u002F","02.how-to\u002F08.observe\u002F20.building-an-etl",{"title":177,"path":178,"stem":179,"type":24,"device":6},"Read lineage events","\u002Fhow-to\u002Fobserve\u002Freading-lineage-events\u002F","02.how-to\u002F08.observe\u002F30.reading-lineage-events",{"title":111,"type":6,"device":6,"path":181,"stem":182,"children":183,"page":41},"\u002Fhow-to\u002Fplatform\u002F","02.how-to\u002F09.platform",[184],{"title":185,"path":186,"stem":187,"type":24,"device":6},"UniteLabs Desktop","\u002Fhow-to\u002Fplatform\u002Funitelabs-desktop\u002F","02.how-to\u002F09.platform\u002F10.unitelabs-desktop",{"title":189,"type":6,"device":6,"path":190,"stem":191,"children":192},"Technical Reference","\u002Ftechnical-reference\u002F","03.technical-reference",[193,196,201,213,226,235,244,253,262],{"title":194,"path":190,"stem":195,"type":14,"device":6},"Overview","03.technical-reference\u002Findex",{"title":197,"path":198,"stem":199,"type":200,"device":6},"REST API","\u002Ftechnical-reference\u002Frest-api\u002F","03.technical-reference\u002F01.rest-api","reference",{"title":119,"type":6,"device":6,"path":202,"stem":203,"children":204,"page":41},"\u002Ftechnical-reference\u002Fautomate\u002F","03.technical-reference\u002F07.automate",[205,209],{"title":206,"path":207,"stem":208,"type":200,"device":6},"Workflow template","\u002Ftechnical-reference\u002Fautomate\u002Fworkflow-template\u002F","03.technical-reference\u002F07.automate\u002F05.workflow-template",{"title":210,"path":211,"stem":212,"type":200,"device":6},"Workflows REST API","\u002Ftechnical-reference\u002Fautomate\u002Fworkflows-api\u002F","03.technical-reference\u002F07.automate\u002F80.workflows-api",{"title":26,"type":6,"device":6,"path":214,"stem":215,"children":216},"\u002Ftechnical-reference\u002Fgroundcontrol\u002F","03.technical-reference\u002F10.groundcontrol\u002Findex",[217,218,222],{"title":194,"path":214,"stem":215,"type":14,"device":6},{"title":219,"path":220,"stem":221,"type":200,"device":6},"Network requirements","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fnetwork-requirements\u002F","03.technical-reference\u002F10.groundcontrol\u002F10.network-requirements",{"title":223,"path":224,"stem":225,"type":200,"device":6},"Changelog","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fchangelog\u002F","03.technical-reference\u002F10.groundcontrol\u002F20.changelog",{"title":227,"type":6,"device":6,"path":228,"stem":229,"children":230},"UniteLabs SDK","\u002Ftechnical-reference\u002Fpython-sdk\u002F","03.technical-reference\u002F20.python-sdk\u002Findex",[231,232],{"title":194,"path":228,"stem":229,"type":14,"device":6},{"title":223,"path":233,"stem":234,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-sdk\u002Fchangelog\u002F","03.technical-reference\u002F20.python-sdk\u002F20.changelog",{"title":236,"type":6,"device":6,"path":237,"stem":238,"children":239},"Liquid Handling SDK","\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002F","03.technical-reference\u002F30.python-liquid-handling-sdk\u002Findex",[240,241],{"title":194,"path":237,"stem":238,"type":14,"device":6},{"title":223,"path":242,"stem":243,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Fchangelog\u002F","03.technical-reference\u002F30.python-liquid-handling-sdk\u002F20.changelog",{"title":245,"type":6,"device":6,"path":246,"stem":247,"children":248},"Labware","\u002Ftechnical-reference\u002Flabware\u002F","03.technical-reference\u002F40.labware\u002Findex",[249,250],{"title":194,"path":246,"stem":247,"type":14,"device":6},{"title":223,"path":251,"stem":252,"type":200,"device":6},"\u002Ftechnical-reference\u002Flabware\u002Fchangelog\u002F","03.technical-reference\u002F40.labware\u002F20.changelog",{"title":254,"type":6,"device":6,"path":255,"stem":256,"children":257},"Python Omnibus","\u002Ftechnical-reference\u002Fpython-omnibus\u002F","03.technical-reference\u002F50.python-omnibus\u002Findex",[258,259],{"title":194,"path":255,"stem":256,"type":14,"device":6},{"title":223,"path":260,"stem":261,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Fchangelog\u002F","03.technical-reference\u002F50.python-omnibus\u002F20.changelog",{"title":263,"type":6,"device":6,"path":264,"stem":265,"children":266},"Python CDK","\u002Ftechnical-reference\u002Fpython-cdk\u002F","03.technical-reference\u002F60.python-cdk\u002Findex",[267,268],{"title":194,"path":264,"stem":265,"type":14,"device":6},{"title":223,"path":269,"stem":270,"type":200,"device":6},"\u002Ftechnical-reference\u002Fpython-cdk\u002Fchangelog\u002F","03.technical-reference\u002F60.python-cdk\u002F20.changelog",{"title":272,"type":6,"device":6,"path":273,"stem":274,"children":275,"page":41},"Concepts","\u002Fconcepts\u002F","04.concepts",[276,315,339,383,422],{"title":277,"type":6,"device":6,"path":278,"stem":279,"children":280,"page":41},"Labs as code","\u002Fconcepts\u002Flabs-as-code\u002F","04.concepts\u002F01.labs-as-code",[281,286,290],{"title":282,"path":283,"stem":284,"type":285,"device":6},"Lab as Code","\u002Fconcepts\u002Flabs-as-code\u002Fwhy-code\u002F","04.concepts\u002F01.labs-as-code\u002F00.why-code","explanation",{"title":287,"path":288,"stem":289,"type":285,"device":6},"How it works","\u002Fconcepts\u002Flabs-as-code\u002Fhow-it-works\u002F","04.concepts\u002F01.labs-as-code\u002F01.how-it-works",{"title":291,"type":6,"device":6,"path":292,"stem":293,"children":294,"page":41},"Use Cases","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases",[295,299,303,307,311],{"title":296,"path":297,"stem":298,"type":285,"device":6},"Instrument Control","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Flow-level-instrument-control\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F10.low-level-instrument-control",{"title":300,"path":301,"stem":302,"type":285,"device":6},"Multi-device Control","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fmulti-device-control\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F20.multi-device-control",{"title":304,"path":305,"stem":306,"type":285,"device":6},"Workflow Orchestration","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fworkflow-orchestration\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F30.workflow-orchestration",{"title":308,"path":309,"stem":310,"type":285,"device":6},"Custom Apps and LIMS Integration","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fcustom-apps-lims\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F40.custom-apps-lims",{"title":312,"path":313,"stem":314,"type":285,"device":6},"Scale and Fleet Management","\u002Fconcepts\u002Flabs-as-code\u002Fuse-cases\u002Fscale-and-fleet\u002F","04.concepts\u002F01.labs-as-code\u002F02.use-cases\u002F50.scale-and-fleet",{"title":65,"type":6,"device":6,"path":316,"stem":317,"children":318,"page":41},"\u002Fconcepts\u002Fintegrate\u002F","04.concepts\u002F02.integrate",[319,323,327,331,335],{"title":320,"path":321,"stem":322,"type":285,"device":6},"Device","\u002Fconcepts\u002Fintegrate\u002Fdevice\u002F","04.concepts\u002F02.integrate\u002F05.device",{"title":324,"path":325,"stem":326,"type":285,"device":6},"Connector","\u002Fconcepts\u002Fintegrate\u002Fconnector\u002F","04.concepts\u002F02.integrate\u002F10.connector",{"title":328,"path":329,"stem":330,"type":285,"device":6},"Module","\u002Fconcepts\u002Fintegrate\u002Fmodule\u002F","04.concepts\u002F02.integrate\u002F20.module",{"title":332,"path":333,"stem":334,"type":285,"device":6},"Action","\u002Fconcepts\u002Fintegrate\u002Faction\u002F","04.concepts\u002F02.integrate\u002F30.action",{"title":336,"path":337,"stem":338,"type":285,"device":6},"Subscription","\u002Fconcepts\u002Fintegrate\u002Fsubscription\u002F","04.concepts\u002F02.integrate\u002F40.subscription",{"title":340,"type":6,"device":6,"path":341,"stem":342,"children":343,"page":41},"Liquid handling and robots","\u002Fconcepts\u002Foperate\u002F","04.concepts\u002F03.operate",[344,348,352,356,359,363,367,371,375,379],{"title":345,"path":346,"stem":347,"type":285,"device":6},"Liquid Handling","\u002Fconcepts\u002Foperate\u002Fliquid-handling\u002F","04.concepts\u002F03.operate\u002F10.liquid-handling",{"title":349,"path":350,"stem":351,"type":285,"device":6},"Modules","\u002Fconcepts\u002Foperate\u002Fmodules\u002F","04.concepts\u002F03.operate\u002F20.modules",{"title":353,"path":354,"stem":355,"type":285,"device":6},"Deck","\u002Fconcepts\u002Foperate\u002Fdeck\u002F","04.concepts\u002F03.operate\u002F30.deck",{"title":245,"path":357,"stem":358,"type":285,"device":6},"\u002Fconcepts\u002Foperate\u002Flabware\u002F","04.concepts\u002F03.operate\u002F40.labware",{"title":360,"path":361,"stem":362,"type":285,"device":6},"Liquids","\u002Fconcepts\u002Foperate\u002Fliquids\u002F","04.concepts\u002F03.operate\u002F50.liquids",{"title":364,"path":365,"stem":366,"type":285,"device":6},"Liquid Classes","\u002Fconcepts\u002Foperate\u002Fliquid-classes\u002F","04.concepts\u002F03.operate\u002F60.liquid-classes",{"title":368,"path":369,"stem":370,"type":285,"device":6},"Parameter Sets","\u002Fconcepts\u002Foperate\u002Fparameter-sets\u002F","04.concepts\u002F03.operate\u002F65.parameter-sets",{"title":372,"path":373,"stem":374,"type":285,"device":6},"Tips and Tip Tracking","\u002Fconcepts\u002Foperate\u002Ftips\u002F","04.concepts\u002F03.operate\u002F70.tips",{"title":376,"path":377,"stem":378,"type":285,"device":6},"Simulation","\u002Fconcepts\u002Foperate\u002Fsimulation\u002F","04.concepts\u002F03.operate\u002F80.simulation",{"title":380,"path":381,"stem":382,"type":285,"device":6},"Error Handling","\u002Fconcepts\u002Foperate\u002Ferror-handling\u002F","04.concepts\u002F03.operate\u002F90.error-handling",{"title":119,"type":6,"device":6,"path":384,"stem":385,"children":386,"page":41},"\u002Fconcepts\u002Fautomate\u002F","04.concepts\u002F07.automate",[387,391,395,399,403,407,411,415,419],{"title":388,"path":389,"stem":390,"type":285,"device":6},"Workflow","\u002Fconcepts\u002Fautomate\u002Fworkflow\u002F","04.concepts\u002F07.automate\u002F10.workflow",{"title":392,"path":393,"stem":394,"type":285,"device":6},"Phase","\u002Fconcepts\u002Fautomate\u002Fphase\u002F","04.concepts\u002F07.automate\u002F20.phase",{"title":396,"path":397,"stem":398,"type":285,"device":6},"Step","\u002Fconcepts\u002Fautomate\u002Fstep\u002F","04.concepts\u002F07.automate\u002F30.step",{"title":400,"path":401,"stem":402,"type":285,"device":6},"Runs","\u002Fconcepts\u002Fautomate\u002Fruns\u002F","04.concepts\u002F07.automate\u002F40.runs",{"title":404,"path":405,"stem":406,"type":285,"device":6},"Input","\u002Fconcepts\u002Fautomate\u002Finput\u002F","04.concepts\u002F07.automate\u002F50.input",{"title":408,"path":409,"stem":410,"type":285,"device":6},"Artifacts","\u002Fconcepts\u002Fautomate\u002Fartifacts\u002F","04.concepts\u002F07.automate\u002F60.artifacts",{"title":412,"path":413,"stem":414,"type":285,"device":6},"Logs","\u002Fconcepts\u002Fautomate\u002Flogs\u002F","04.concepts\u002F07.automate\u002F70.logs",{"title":416,"path":417,"stem":418,"type":285,"device":6},"Human in the Loop","\u002Fconcepts\u002Fautomate\u002Fhuman-in-the-loop\u002F","04.concepts\u002F07.automate\u002F80.human-in-the-loop",{"title":380,"path":420,"stem":421,"type":285,"device":6},"\u002Fconcepts\u002Fautomate\u002Ferror-handling\u002F","04.concepts\u002F07.automate\u002F90.error-handling",{"title":164,"type":6,"device":6,"path":423,"stem":424,"children":425,"page":41},"\u002Fconcepts\u002Fobserve\u002F","04.concepts\u002F08.observe",[426,429,433,437,441],{"title":194,"path":427,"stem":428,"type":14,"device":6},"\u002Fconcepts\u002Fobserve\u002Foverview\u002F","04.concepts\u002F08.observe\u002F10.overview",{"title":430,"path":431,"stem":432,"type":285,"device":6},"Object Storage","\u002Fconcepts\u002Fobserve\u002Fstorage\u002F","04.concepts\u002F08.observe\u002F10.storage",{"title":434,"path":435,"stem":436,"type":285,"device":6},"Secrets","\u002Fconcepts\u002Fobserve\u002Fsecrets\u002F","04.concepts\u002F08.observe\u002F20.secrets",{"title":438,"path":439,"stem":440,"type":285,"device":6},"Data sources","\u002Fconcepts\u002Fobserve\u002Fdata-sources\u002F","04.concepts\u002F08.observe\u002F30.data-sources",{"title":442,"path":443,"stem":444,"type":285,"device":6},"Data lineage","\u002Fconcepts\u002Fobserve\u002Fdata-lineage\u002F","04.concepts\u002F08.observe\u002F40.data-lineage",{"title":446,"type":6,"device":6,"path":447,"stem":448,"children":449,"page":41},"Devices","\u002Fdevices\u002F","05.devices",[450,453,501,514,530,567],{"title":194,"path":451,"stem":452,"type":14,"device":6},"\u002Fdevices\u002Foverview\u002F","05.devices\u002F00.overview",{"title":454,"path":455,"page":41,"children":456},"Heater-shakers","\u002Fdevices\u002Fheater-shakers\u002F",[457,478,488],{"title":458,"path":459,"stem":460,"type":200,"device":461},"QInstruments BioShake","\u002Fdevices\u002Fqinstruments-bioshake\u002F","05.devices\u002F10.qinstruments-bioshake",{"slug":462,"vendor":463,"category":464,"connector":462,"package":465,"models":466,"communication":473,"vendor_software":6,"os":474},"qinstruments-bioshake","QInstruments","Plate Shakers & Temperature Control","unitelabs-qinstruments-bioshake",[467,468,469,470,471,472],"BioShake 3000 \u002F 3000 elm \u002F 3000 elm DWP","BioShake 3000-T \u002F 3000-T elm","BioShake 5000 elm","BioShake D30 \u002F D30 elm \u002F D30-T \u002F D30-T elm","BioShake Q1 \u002F Q1 (1.2 mm) \u002F Q1 (3.0 mm) \u002F Q2","HeatPlate","serial (RS-232 over USB)",[475,476,477],"windows","linux","macos",{"title":479,"path":480,"stem":481,"type":200,"device":482},"QInstruments ColdPlate","\u002Fdevices\u002Fqinstruments-coldplate\u002F","05.devices\u002F20.qinstruments-coldplate",{"slug":483,"vendor":463,"category":464,"connector":462,"package":465,"models":484,"communication":473,"vendor_software":6,"os":487},"qinstruments-coldplate",[485,486],"ColdPlate","ColdPlate slim",[475,476,477],{"title":489,"path":490,"stem":491,"type":200,"device":492},"Inheco Thermoshake","\u002Fdevices\u002Finheco-thermoshake\u002F","05.devices\u002F30.inheco-thermoshake",{"slug":493,"vendor":494,"category":464,"connector":495,"models":496},"inheco-thermoshake","Inheco","inheco-tec-controller",[497,498,499,500],"Thermoshake AC","Thermoshake AC LC","Thermoshake Classic","Thermoshake RM",{"title":502,"path":503,"page":41,"children":504},"Incubation","\u002Fdevices\u002Fincubation\u002F",[505],{"title":506,"path":507,"stem":508,"type":200,"device":509},"Inheco SCILA","\u002Fdevices\u002Finheco-scila\u002F","05.devices\u002F40.inheco-scila",{"slug":510,"vendor":494,"category":502,"connector":510,"models":511},"inheco-scila",[512,513],"SCILA","SCILA MIX 2-gas mixing device",{"title":515,"path":516,"page":41,"children":517},"Thermal cyclers","\u002Fdevices\u002Fthermal-cyclers\u002F",[518],{"title":519,"path":520,"stem":521,"type":200,"device":522},"Inheco ODTC","\u002Fdevices\u002Finheco-odtc\u002F","05.devices\u002F50.inheco-odtc",{"slug":523,"vendor":494,"category":524,"connector":523,"models":525},"inheco-odtc","Thermal Cycler",[526,527,528,529],"ODTC 96","ODTC 96XL","ODTC 384","ODTC 384XL",{"title":531,"path":532,"page":41,"children":533},"Readers","\u002Fdevices\u002Freaders\u002F",[534,543,552],{"title":535,"path":536,"stem":537,"type":200,"device":538},"Agilent Biotek Gen5","\u002Fdevices\u002Fbiotek-gen5\u002F","05.devices\u002F60.biotek-gen5",{"slug":539,"vendor":540,"category":541,"connector":542},"biotek-gen5","Agilent","Readers & Imagers","gen5",{"title":544,"path":545,"stem":546,"type":200,"device":547},"Biotek Synergy H1","\u002Fdevices\u002Fbiotek-synergy-h1\u002F","05.devices\u002F70.biotek-synergy-h1",{"slug":548,"vendor":540,"category":541,"connector":549,"models":550},"biotek-synergy-h1","agilent-synergy-h1",[551],"BioTek Synergy H1",{"title":553,"path":554,"stem":555,"type":200,"device":556},"Tecan Infinite 200","\u002Fdevices\u002Ftecan-infinite-200\u002F","05.devices\u002F75.tecan-infinite-200",{"slug":557,"vendor":558,"category":541,"connector":557,"package":559,"models":560,"communication":564,"vendor_software":565,"os":566},"tecan-infinite-200","Tecan","unitelabs-tecan-infinite-200",[561,562,563],"Infinite F200","Infinite M200","Infinite M200 Pro","USB","i-control on Windows only, for its USB driver",[475,476,477],{"title":568,"path":569,"page":41,"children":570},"Tilt & turn","\u002Fdevices\u002Ftilt-and-turn\u002F",[571,581],{"title":572,"path":573,"stem":574,"type":200,"device":575},"QInstruments TiltStation","\u002Fdevices\u002Fqinstruments-tiltstation\u002F","05.devices\u002F80.qinstruments-tiltstation",{"slug":576,"vendor":463,"category":577,"connector":462,"package":465,"models":578,"communication":473,"vendor_software":6,"os":580},"qinstruments-tiltstation","Plate Tilting",[579],"TiltStation",[475,476,477],{"title":582,"path":583,"stem":584,"type":200,"device":585},"QInstruments TurnStation","\u002Fdevices\u002Fqinstruments-turnstation\u002F","05.devices\u002F90.qinstruments-turnstation",{"slug":586,"vendor":463,"category":587,"connector":462,"package":465,"models":588,"communication":473,"vendor_software":6,"os":590},"qinstruments-turnstation","Plate Rotating",[589],"TurnStation",[475,476,477],{"title":592,"type":6,"device":6,"path":593,"stem":594,"children":595,"page":41},"Liquid Handling and Robots","\u002Fliquid-handling-and-robots\u002F","06.liquid-handling-and-robots",[596,599,611,635,638,679,704,721,738],{"title":194,"path":597,"stem":598,"type":14,"device":6},"\u002Fliquid-handling-and-robots\u002Foverview\u002F","06.liquid-handling-and-robots\u002F00.overview",{"title":353,"type":6,"device":6,"path":600,"stem":601,"children":602,"page":41},"\u002Fliquid-handling-and-robots\u002Fdeck\u002F","06.liquid-handling-and-robots\u002F10.deck",[603,607],{"title":604,"path":605,"stem":606,"type":24,"device":6},"Building a Deck","\u002Fliquid-handling-and-robots\u002Fdeck\u002Fbuilding-a-deck\u002F","06.liquid-handling-and-robots\u002F10.deck\u002F10.building-a-deck",{"title":608,"path":609,"stem":610,"type":24,"device":6},"Save\u002FLoad a Deck","\u002Fliquid-handling-and-robots\u002Fdeck\u002Fsave-load-deck\u002F","06.liquid-handling-and-robots\u002F10.deck\u002F20.save-load-deck",{"title":612,"type":6,"device":6,"path":613,"stem":614,"children":615,"page":41},"Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting",[616,620,624,628,631],{"title":617,"path":618,"stem":619,"type":24,"device":6},"Basic Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F10.basic-pipetting",{"title":621,"path":622,"stem":623,"type":24,"device":6},"Advanced Pipetting","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fadvanced-pipetting\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F20.advanced-pipetting",{"title":625,"path":626,"stem":627,"type":24,"device":6},"Tip Handling","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F30.tip-handling",{"title":364,"path":629,"stem":630,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fpipetting\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F40.liquid-classes",{"title":632,"path":633,"stem":634,"type":24,"device":6},"Labware Transport","\u002Fliquid-handling-and-robots\u002Fpipetting\u002Flabware-transport\u002F","06.liquid-handling-and-robots\u002F20.pipetting\u002F50.labware-transport",{"title":376,"path":636,"stem":637,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fsimulation\u002F","06.liquid-handling-and-robots\u002F30.simulation",{"title":639,"type":6,"device":6,"path":640,"stem":641,"children":642,"page":41},"Hamilton STAR","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star",[643,647,651,655,659,663,667,671,675],{"title":644,"path":645,"stem":646,"type":24,"device":6},"Positioning & Movement","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fpositioning\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F10.positioning",{"title":648,"path":649,"stem":650,"type":24,"device":6},"Gripper Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcore-gripper\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F20.core-gripper",{"title":652,"path":653,"stem":654,"type":24,"device":6},"iSWAP Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fiswap\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F30.iswap",{"title":656,"path":657,"stem":658,"type":24,"device":6},"Using TADM","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Ftadm\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F40.tadm",{"title":660,"path":661,"stem":662,"type":24,"device":6},"Autoload Module","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fautoload\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F50.autoload",{"title":664,"path":665,"stem":666,"type":24,"device":6},"Waste Block","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fwaste-block\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F60.waste-block",{"title":668,"path":669,"stem":670,"type":24,"device":6},"Complex Mixing","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcomplex-mixing\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F66.complex-mixing",{"title":672,"path":673,"stem":674,"type":24,"device":6},"Teaching Gripper Paddle Positions","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fgripper-positions\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F70.gripper-positions",{"title":676,"path":677,"stem":678,"type":24,"device":6},"Training a Custom Deck Position With the iSWAP","\u002Fliquid-handling-and-robots\u002Fhamilton-star\u002Fcustom-deck-position\u002F","06.liquid-handling-and-robots\u002F41.hamilton-star\u002F75.custom-deck-position",{"title":680,"type":6,"device":6,"path":681,"stem":682,"children":683,"page":41},"Hamilton Vantage","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage",[684,688,692,696,700],{"title":685,"path":686,"stem":687,"type":24,"device":6},"Waste Configuration","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fwaste-configuration\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F05.waste-configuration",{"title":689,"path":690,"stem":691,"type":24,"device":6},"Covers and Lights","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fcovers-and-lights\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F10.covers-and-lights",{"title":693,"path":694,"stem":695,"type":24,"device":6},"IDL Module","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fidl\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F20.idl",{"title":697,"path":698,"stem":699,"type":24,"device":6},"IPG Module","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fipg\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F30.ipg",{"title":701,"path":702,"stem":703,"type":24,"device":6},"XL Pipettes","\u002Fliquid-handling-and-robots\u002Fhamilton-vantage\u002Fxl-channels\u002F","06.liquid-handling-and-robots\u002F42.hamilton-vantage\u002F40.xl-channels",{"title":705,"type":6,"device":6,"path":706,"stem":707,"children":708,"page":41},"Agilent Bravo","\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo",[709,712,715,718],{"title":625,"path":710,"stem":711,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F10.tip-handling",{"title":617,"path":713,"stem":714,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F20.basic-pipetting",{"title":364,"path":716,"stem":717,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F25.liquid-classes",{"title":648,"path":719,"stem":720,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Fagilent-bravo\u002Fusing-the-gripper\u002F","06.liquid-handling-and-robots\u002F43.agilent-bravo\u002F30.using-the-gripper",{"title":722,"type":6,"device":6,"path":723,"stem":724,"children":725,"page":41},"Tecan FluentControl","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol",[726,730,734],{"title":727,"path":728,"stem":729,"type":24,"device":6},"Connect & Run a Method","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Fconnect-and-run\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F10.connect-and-run",{"title":731,"path":732,"stem":733,"type":24,"device":6},"Sending XML Commands","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Fsending-xml-commands\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F20.sending-xml-commands",{"title":735,"path":736,"stem":737,"type":24,"device":6},"Full Workflow Example","\u002Fliquid-handling-and-robots\u002Ftecan-fluentcontrol\u002Ffull-workflow-example\u002F","06.liquid-handling-and-robots\u002F44.tecan-fluentcontrol\u002F30.full-workflow-example",{"title":739,"type":6,"device":6,"path":740,"stem":741,"children":742,"page":41},"Tecan Freedom EVO","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo",[743,747,750,753,757],{"title":744,"path":745,"stem":746,"type":24,"device":6},"Deck & Carriers","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fdeck-and-carriers\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F10.deck-and-carriers",{"title":625,"path":748,"stem":749,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Ftip-handling\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F20.tip-handling",{"title":617,"path":751,"stem":752,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fbasic-pipetting\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F30.basic-pipetting",{"title":754,"path":755,"stem":756,"type":24,"device":6},"Using the Gripper (RoMa)","\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fusing-the-gripper\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F40.using-the-gripper",{"title":364,"path":758,"stem":759,"type":24,"device":6},"\u002Fliquid-handling-and-robots\u002Ftecan-freedom-evo\u002Fliquid-classes\u002F","06.liquid-handling-and-robots\u002F45.tecan-freedom-evo\u002F50.liquid-classes",{"title":245,"type":6,"device":6,"path":761,"stem":762,"children":763,"page":41},"\u002Flabware\u002F","07.labware",[764,767,771,775,779,783,787],{"title":194,"path":765,"stem":766,"type":14,"device":6},"\u002Flabware\u002Foverview\u002F","07.labware\u002F00.overview",{"title":768,"path":769,"stem":770,"type":200,"device":6},"Standard Labware","\u002Flabware\u002Fstandard-labware\u002F","07.labware\u002F10.standard-labware",{"title":772,"path":773,"stem":774,"type":200,"device":6},"Plates","\u002Flabware\u002Fplates\u002F","07.labware\u002F20.plates",{"title":776,"path":777,"stem":778,"type":200,"device":6},"Tips and Tip Racks","\u002Flabware\u002Ftips-and-racks\u002F","07.labware\u002F30.tips-and-racks",{"title":780,"path":781,"stem":782,"type":200,"device":6},"Tubes and Tube Racks","\u002Flabware\u002Ftubes-and-tube-racks\u002F","07.labware\u002F40.tubes-and-tube-racks",{"title":784,"path":785,"stem":786,"type":200,"device":6},"Troughs","\u002Flabware\u002Ftroughs\u002F","07.labware\u002F50.troughs",{"title":788,"path":789,"stem":790,"type":200,"device":6},"Carriers and Adapters","\u002Flabware\u002Fcarriers-and-adapters\u002F","07.labware\u002F60.carriers-and-adapters",{"title":792,"type":6,"device":6,"path":793,"stem":794,"children":795},"Connector Development (CDK)","\u002Fconnector-development\u002F","20.connector-development",[796,798,822,855,863,903],{"title":194,"path":793,"stem":797,"type":14,"device":6},"20.connector-development\u002Findex",{"title":799,"path":800,"stem":801,"children":802,"page":41},"Getting Started","\u002Fconnector-development\u002Fgetting-started\u002F","20.connector-development\u002F10.getting-started",[803,806,810,814,818],{"title":194,"path":804,"stem":805,"type":285,"device":6},"\u002Fconnector-development\u002Fgetting-started\u002Foverview\u002F","20.connector-development\u002F10.getting-started\u002F10.overview",{"title":807,"path":808,"stem":809,"type":24,"device":6},"What's new","\u002Fconnector-development\u002Fgetting-started\u002Fwhats-new\u002F","20.connector-development\u002F10.getting-started\u002F20.whats-new",{"title":811,"path":812,"stem":813,"type":24,"device":6},"Installation","\u002Fconnector-development\u002Fgetting-started\u002Finstallation\u002F","20.connector-development\u002F10.getting-started\u002F30.installation",{"title":815,"path":816,"stem":817,"type":24,"device":6},"Python Environment and Project Management","\u002Fconnector-development\u002Fgetting-started\u002Fpython-environments\u002F","20.connector-development\u002F10.getting-started\u002F35.python-environments",{"title":819,"path":820,"stem":821,"type":24,"device":6},"Contributing","\u002Fconnector-development\u002Fgetting-started\u002Fcontributing\u002F","20.connector-development\u002F10.getting-started\u002F40.contributing",{"title":823,"path":824,"stem":825,"children":826,"page":41},"Tutorial","\u002Fconnector-development\u002Ftutorial\u002F","20.connector-development\u002F20.tutorial",[827,831,835,839,843,847,851],{"title":828,"path":829,"stem":830,"type":46,"device":6},"Walkthrough","\u002Fconnector-development\u002Ftutorial\u002Fwalkthrough\u002F","20.connector-development\u002F20.tutorial\u002F00.walkthrough",{"title":832,"path":833,"stem":834,"type":46,"device":6},"SiLA Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fsila-endpoints\u002F","20.connector-development\u002F20.tutorial\u002F10.sila-endpoints",{"title":836,"path":837,"stem":838,"type":46,"device":6},"Data Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fdata-endpoints\u002F","20.connector-development\u002F20.tutorial\u002F20.data-endpoints",{"title":840,"path":841,"stem":842,"type":46,"device":6},"Controls","\u002Fconnector-development\u002Ftutorial\u002Fcontrols\u002F","20.connector-development\u002F20.tutorial\u002F30.controls",{"title":844,"path":845,"stem":846,"type":46,"device":6},"SiLA Data Types","\u002Fconnector-development\u002Ftutorial\u002Fdata-types\u002F","20.connector-development\u002F20.tutorial\u002F40.data-types",{"title":848,"path":849,"stem":850,"type":46,"device":6},"Feature","\u002Fconnector-development\u002Ftutorial\u002Fconnector-structure\u002F","20.connector-development\u002F20.tutorial\u002F70.connector-structure",{"title":852,"path":853,"stem":854,"type":46,"device":6},"Hardware Communication","\u002Fconnector-development\u002Ftutorial\u002Fhardware-communication\u002F","20.connector-development\u002F20.tutorial\u002F90.hardware-communication",{"title":272,"type":6,"device":6,"path":856,"stem":857,"children":858,"page":41},"\u002Fconnector-development\u002Fconcepts\u002F","20.connector-development\u002F30.concepts",[859],{"title":860,"path":861,"stem":862,"type":285,"device":6},"SiLA","\u002Fconnector-development\u002Fconcepts\u002Fsila\u002F","20.connector-development\u002F30.concepts\u002Fsila",{"title":864,"path":865,"stem":866,"children":867,"page":41},"Guides","\u002Fconnector-development\u002Fguides\u002F","20.connector-development\u002F40.guides",[868,872,876,880,884,888,892,895,899],{"title":869,"path":870,"stem":871,"type":24,"device":6},"Configuration","\u002Fconnector-development\u002Fguides\u002Fconfiguration\u002F","20.connector-development\u002F40.guides\u002F20.configuration",{"title":873,"path":874,"stem":875,"type":24,"device":6},"Logging","\u002Fconnector-development\u002Fguides\u002Flogging\u002F","20.connector-development\u002F40.guides\u002F21.logging",{"title":877,"path":878,"stem":879,"type":24,"device":6},"Deployment","\u002Fconnector-development\u002Fguides\u002Fdeployment\u002F","20.connector-development\u002F40.guides\u002F30.deployment",{"title":881,"path":882,"stem":883,"type":24,"device":6},"Security","\u002Fconnector-development\u002Fguides\u002Fsecurity\u002F","20.connector-development\u002F40.guides\u002F40.security",{"title":885,"path":886,"stem":887,"type":24,"device":6},"Subscriptions","\u002Fconnector-development\u002Fguides\u002Fsubscriptions\u002F","20.connector-development\u002F40.guides\u002F45.subscriptions",{"title":889,"path":890,"stem":891,"type":24,"device":6},"Execution Modes","\u002Fconnector-development\u002Fguides\u002Fexecution-modes\u002F","20.connector-development\u002F40.guides\u002F46.execution-modes",{"title":380,"path":893,"stem":894,"type":24,"device":6},"\u002Fconnector-development\u002Fguides\u002Ferror-handling\u002F","20.connector-development\u002F40.guides\u002F50.error-handling",{"title":896,"path":897,"stem":898,"type":24,"device":6},"Serial Troubleshooting","\u002Fconnector-development\u002Fguides\u002Fserial-troubleshooting\u002F","20.connector-development\u002F40.guides\u002F70.serial-troubleshooting",{"title":900,"path":901,"stem":902,"type":24,"device":6},"Testing","\u002Fconnector-development\u002Fguides\u002Ftesting\u002F","20.connector-development\u002F40.guides\u002F80.testing",{"title":904,"path":905,"stem":906,"children":907,"type":6,"device":6},"References","\u002Fconnector-development\u002Freference\u002F","20.connector-development\u002F50.reference\u002Findex",[908],{"title":904,"path":905,"stem":906,"type":200,"device":6},{"id":910,"title":156,"body":911,"description":4218,"device":6,"extension":4219,"links":6,"meta":4220,"navigation":1014,"path":4221,"seo":4222,"stem":158,"type":24,"__hash__":4223},"docs\u002F02.how-to\u002F07.automate\u002F70.advanced-error-handling.md",{"type":912,"value":913,"toc":4207},"minimark",[914,918,924,935,940,948,974,978,981,1100,1104,1111,1519,1523,1530,2088,2092,2095,2098,2184,2359,2363,2366,2728,2732,2738,2841,2844,3180,3184,3197,3882,3885,4160,4164,4170,4176,4184,4190,4196,4203],[915,916,917],"p",{},"In this guide you will replace generic exception handling with a typed error system that distinguishes who caused the error, what the user can do about it, and how the system should respond.",[915,919,920],{},[921,922,923],"strong",{},"Prerequisites",[925,926,927],"ul",{},[928,929,930,931],"li",{},"Familiarity with ",[932,933,934],"a",{"href":153},"Basic error handling",[936,937,939],"h2",{"id":938},"why-structured-errors","Why structured errors",[915,941,942,943,947],{},"A raw exception like ",[944,945,946],"code",{},"ValueError(\"plate not found\")"," gives you a string. A structured error gives you:",[925,949,950,956,962,968],{},[928,951,952,955],{},[921,953,954],{},"Who is responsible",": user mistake, system failure, config problem, or application bug",[928,957,958,961],{},[921,959,960],{},"What the user sees",": a clear title, explanation, and actionable steps",[928,963,964,967],{},[921,965,966],{},"What operations can do",": an error code to look up, and whether a retry is safe",[928,969,970,973],{},[921,971,972],{},"What developers see",": full technical details in the logs",[936,975,977],{"id":976},"define-the-error-types","Define the error types",[915,979,980],{},"Start with an enum that classifies every error by who caused it:",[982,983,988],"pre",{"className":984,"code":985,"language":986,"meta":987,"style":987},"language-python shiki shiki-themes github-light-high-contrast github-light-high-contrast github-dark-default","from enum import Enum\n\n\nclass ErrorType(Enum):\n    USER_ERROR = \"user_error\"      # Bad input or invalid selection — user can fix\n    SYSTEM_ERROR = \"system_error\"  # Transient failure — retry might help\n    CONFIG_ERROR = \"config_error\"  # Missing credentials or misconfiguration — admin must fix\n    BUG = \"bug\"                    # Unexpected application error — developer must fix\n","python","",[944,989,990,1009,1016,1021,1041,1058,1072,1086],{"__ignoreMap":987},[991,992,995,999,1003,1006],"span",{"class":993,"line":994},"line",1,[991,996,998],{"class":997},"sxkbv","from",[991,1000,1002],{"class":1001},"sc-9e"," enum ",[991,1004,1005],{"class":997},"import",[991,1007,1008],{"class":1001}," Enum\n",[991,1010,1012],{"class":993,"line":1011},2,[991,1013,1015],{"emptyLinePlaceholder":1014},true,"\n",[991,1017,1019],{"class":993,"line":1018},3,[991,1020,1015],{"emptyLinePlaceholder":1014},[991,1022,1024,1027,1031,1034,1038],{"class":993,"line":1023},4,[991,1025,1026],{"class":997},"class",[991,1028,1030],{"class":1029},"sNqAu"," ErrorType",[991,1032,1033],{"class":1001},"(",[991,1035,1037],{"class":1036},"sOiAX","Enum",[991,1039,1040],{"class":1001},"):\n",[991,1042,1044,1047,1050,1054],{"class":993,"line":1043},5,[991,1045,1046],{"class":1036},"    USER_ERROR",[991,1048,1049],{"class":997}," =",[991,1051,1053],{"class":1052},"sCx38"," \"user_error\"",[991,1055,1057],{"class":1056},"sIsDC","      # Bad input or invalid selection — user can fix\n",[991,1059,1061,1064,1066,1069],{"class":993,"line":1060},6,[991,1062,1063],{"class":1036},"    SYSTEM_ERROR",[991,1065,1049],{"class":997},[991,1067,1068],{"class":1052}," \"system_error\"",[991,1070,1071],{"class":1056},"  # Transient failure — retry might help\n",[991,1073,1075,1078,1080,1083],{"class":993,"line":1074},7,[991,1076,1077],{"class":1036},"    CONFIG_ERROR",[991,1079,1049],{"class":997},[991,1081,1082],{"class":1052}," \"config_error\"",[991,1084,1085],{"class":1056},"  # Missing credentials or misconfiguration — admin must fix\n",[991,1087,1089,1092,1094,1097],{"class":993,"line":1088},8,[991,1090,1091],{"class":1036},"    BUG",[991,1093,1049],{"class":997},[991,1095,1096],{"class":1052}," \"bug\"",[991,1098,1099],{"class":1056},"                    # Unexpected application error — developer must fix\n",[936,1101,1103],{"id":1102},"the-structurederror-dataclass","The StructuredError dataclass",[915,1105,1106,1107,1110],{},"A ",[944,1108,1109],{},"StructuredError"," carries everything needed to handle an error consistently at every layer of the system:",[982,1112,1114],{"className":984,"code":1113,"language":986,"meta":987,"style":987},"from dataclasses import dataclass, field\nfrom typing import Optional\n\n\n@dataclass\nclass StructuredError:\n    error_type: ErrorType\n    title: str                          # Short, human-readable title\n    message: str                        # Explanation of what went wrong\n    actions: list[str] = field(default_factory=list)  # Steps the user can take\n    error_code: Optional[str] = None    # Unique code for lookup (e.g. \"WF_101\")\n    can_retry: bool = False             # Whether re-running the workflow may succeed\n    contact_support: bool = False       # Whether to escalate to support\n    technical_details: Optional[str] = None  # Stack trace \u002F raw exception (omit from UI)\n\n    def to_user_message(self) -> str:\n        \"\"\"Format the error for display to an end user.\"\"\"\n        lines = [f\"**{self.title}**\", \"\", self.message]\n        if self.actions:\n            lines += [\"\", \"**What you can do:**\"]\n            lines += [f\"- {action}\" for action in self.actions]\n        if self.error_code:\n            lines += [\"\", f\"Error code: `{self.error_code}`\"]\n        if self.contact_support:\n            lines += [\"\", \"If the problem persists, contact support.\"]\n        return \"\\n\".join(lines)\n",[944,1115,1116,1128,1140,1144,1148,1154,1164,1169,1180,1191,1222,1240,1257,1272,1289,1294,1310,1316,1361,1373,1394,1432,1442,1474,1484,1502],{"__ignoreMap":987},[991,1117,1118,1120,1123,1125],{"class":993,"line":994},[991,1119,998],{"class":997},[991,1121,1122],{"class":1001}," dataclasses ",[991,1124,1005],{"class":997},[991,1126,1127],{"class":1001}," dataclass, field\n",[991,1129,1130,1132,1135,1137],{"class":993,"line":1011},[991,1131,998],{"class":997},[991,1133,1134],{"class":1001}," typing ",[991,1136,1005],{"class":997},[991,1138,1139],{"class":1001}," Optional\n",[991,1141,1142],{"class":993,"line":1018},[991,1143,1015],{"emptyLinePlaceholder":1014},[991,1145,1146],{"class":993,"line":1023},[991,1147,1015],{"emptyLinePlaceholder":1014},[991,1149,1150],{"class":993,"line":1043},[991,1151,1153],{"class":1152},"s4qFZ","@dataclass\n",[991,1155,1156,1158,1161],{"class":993,"line":1060},[991,1157,1026],{"class":997},[991,1159,1160],{"class":1029}," StructuredError",[991,1162,1163],{"class":1001},":\n",[991,1165,1166],{"class":993,"line":1074},[991,1167,1168],{"class":1001},"    error_type: ErrorType\n",[991,1170,1171,1174,1177],{"class":993,"line":1088},[991,1172,1173],{"class":1001},"    title: ",[991,1175,1176],{"class":1036},"str",[991,1178,1179],{"class":1056},"                          # Short, human-readable title\n",[991,1181,1183,1186,1188],{"class":993,"line":1182},9,[991,1184,1185],{"class":1001},"    message: ",[991,1187,1176],{"class":1036},[991,1189,1190],{"class":1056},"                        # Explanation of what went wrong\n",[991,1192,1194,1197,1199,1202,1205,1208,1211,1213,1216,1219],{"class":993,"line":1193},10,[991,1195,1196],{"class":1001},"    actions: list[",[991,1198,1176],{"class":1036},[991,1200,1201],{"class":1001},"] ",[991,1203,1204],{"class":997},"=",[991,1206,1207],{"class":1001}," field(",[991,1209,1210],{"class":1029},"default_factory",[991,1212,1204],{"class":997},[991,1214,1215],{"class":1036},"list",[991,1217,1218],{"class":1001},")  ",[991,1220,1221],{"class":1056},"# Steps the user can take\n",[991,1223,1225,1228,1230,1232,1234,1237],{"class":993,"line":1224},11,[991,1226,1227],{"class":1001},"    error_code: Optional[",[991,1229,1176],{"class":1036},[991,1231,1201],{"class":1001},[991,1233,1204],{"class":997},[991,1235,1236],{"class":1036}," None",[991,1238,1239],{"class":1056},"    # Unique code for lookup (e.g. \"WF_101\")\n",[991,1241,1243,1246,1249,1251,1254],{"class":993,"line":1242},12,[991,1244,1245],{"class":1001},"    can_retry: ",[991,1247,1248],{"class":1036},"bool",[991,1250,1049],{"class":997},[991,1252,1253],{"class":1036}," False",[991,1255,1256],{"class":1056},"             # Whether re-running the workflow may succeed\n",[991,1258,1260,1263,1265,1267,1269],{"class":993,"line":1259},13,[991,1261,1262],{"class":1001},"    contact_support: ",[991,1264,1248],{"class":1036},[991,1266,1049],{"class":997},[991,1268,1253],{"class":1036},[991,1270,1271],{"class":1056},"       # Whether to escalate to support\n",[991,1273,1275,1278,1280,1282,1284,1286],{"class":993,"line":1274},14,[991,1276,1277],{"class":1001},"    technical_details: Optional[",[991,1279,1176],{"class":1036},[991,1281,1201],{"class":1001},[991,1283,1204],{"class":997},[991,1285,1236],{"class":1036},[991,1287,1288],{"class":1056},"  # Stack trace \u002F raw exception (omit from UI)\n",[991,1290,1292],{"class":993,"line":1291},15,[991,1293,1015],{"emptyLinePlaceholder":1014},[991,1295,1297,1300,1303,1306,1308],{"class":993,"line":1296},16,[991,1298,1299],{"class":997},"    def",[991,1301,1302],{"class":1152}," to_user_message",[991,1304,1305],{"class":1001},"(self) -> ",[991,1307,1176],{"class":1036},[991,1309,1163],{"class":1001},[991,1311,1313],{"class":993,"line":1312},17,[991,1314,1315],{"class":1052},"        \"\"\"Format the error for display to an end user.\"\"\"\n",[991,1317,1319,1322,1324,1327,1330,1333,1336,1339,1342,1345,1348,1351,1354,1356,1358],{"class":993,"line":1318},18,[991,1320,1321],{"class":1001},"        lines ",[991,1323,1204],{"class":997},[991,1325,1326],{"class":1001}," [",[991,1328,1329],{"class":997},"f",[991,1331,1332],{"class":1052},"\"**",[991,1334,1335],{"class":997},"{",[991,1337,1338],{"class":1036},"self",[991,1340,1341],{"class":1001},".title",[991,1343,1344],{"class":997},"}",[991,1346,1347],{"class":1052},"**\"",[991,1349,1350],{"class":1001},", ",[991,1352,1353],{"class":1052},"\"\"",[991,1355,1350],{"class":1001},[991,1357,1338],{"class":1036},[991,1359,1360],{"class":1001},".message]\n",[991,1362,1364,1367,1370],{"class":993,"line":1363},19,[991,1365,1366],{"class":997},"        if",[991,1368,1369],{"class":1036}," self",[991,1371,1372],{"class":1001},".actions:\n",[991,1374,1376,1379,1382,1384,1386,1388,1391],{"class":993,"line":1375},20,[991,1377,1378],{"class":1001},"            lines ",[991,1380,1381],{"class":997},"+=",[991,1383,1326],{"class":1001},[991,1385,1353],{"class":1052},[991,1387,1350],{"class":1001},[991,1389,1390],{"class":1052},"\"**What you can do:**\"",[991,1392,1393],{"class":1001},"]\n",[991,1395,1397,1399,1401,1403,1405,1408,1410,1413,1415,1418,1421,1424,1427,1429],{"class":993,"line":1396},21,[991,1398,1378],{"class":1001},[991,1400,1381],{"class":997},[991,1402,1326],{"class":1001},[991,1404,1329],{"class":997},[991,1406,1407],{"class":1052},"\"- ",[991,1409,1335],{"class":997},[991,1411,1412],{"class":1001},"action",[991,1414,1344],{"class":997},[991,1416,1417],{"class":1052},"\"",[991,1419,1420],{"class":997}," for",[991,1422,1423],{"class":1001}," action ",[991,1425,1426],{"class":997},"in",[991,1428,1369],{"class":1036},[991,1430,1431],{"class":1001},".actions]\n",[991,1433,1435,1437,1439],{"class":993,"line":1434},22,[991,1436,1366],{"class":997},[991,1438,1369],{"class":1036},[991,1440,1441],{"class":1001},".error_code:\n",[991,1443,1445,1447,1449,1451,1453,1455,1457,1460,1462,1464,1467,1469,1472],{"class":993,"line":1444},23,[991,1446,1378],{"class":1001},[991,1448,1381],{"class":997},[991,1450,1326],{"class":1001},[991,1452,1353],{"class":1052},[991,1454,1350],{"class":1001},[991,1456,1329],{"class":997},[991,1458,1459],{"class":1052},"\"Error code: `",[991,1461,1335],{"class":997},[991,1463,1338],{"class":1036},[991,1465,1466],{"class":1001},".error_code",[991,1468,1344],{"class":997},[991,1470,1471],{"class":1052},"`\"",[991,1473,1393],{"class":1001},[991,1475,1477,1479,1481],{"class":993,"line":1476},24,[991,1478,1366],{"class":997},[991,1480,1369],{"class":1036},[991,1482,1483],{"class":1001},".contact_support:\n",[991,1485,1487,1489,1491,1493,1495,1497,1500],{"class":993,"line":1486},25,[991,1488,1378],{"class":1001},[991,1490,1381],{"class":997},[991,1492,1326],{"class":1001},[991,1494,1353],{"class":1052},[991,1496,1350],{"class":1001},[991,1498,1499],{"class":1052},"\"If the problem persists, contact support.\"",[991,1501,1393],{"class":1001},[991,1503,1505,1508,1511,1514,1516],{"class":993,"line":1504},26,[991,1506,1507],{"class":997},"        return",[991,1509,1510],{"class":1052}," \"",[991,1512,1513],{"class":997},"\\n",[991,1515,1417],{"class":1052},[991,1517,1518],{"class":1001},".join(lines)\n",[936,1520,1522],{"id":1521},"factory-functions","Factory functions",[915,1524,1525,1526,1529],{},"Define one factory function per error type so callers never need to import ",[944,1527,1528],{},"ErrorType"," directly:",[982,1531,1533],{"className":984,"code":1532,"language":986,"meta":987,"style":987},"def create_user_error(\n    title: str,\n    message: str,\n    actions: list[str] | None = None,\n    error_code: str | None = None,\n    can_retry: bool = False,\n) -> StructuredError:\n    return StructuredError(\n        error_type=ErrorType.USER_ERROR,\n        title=title,\n        message=message,\n        actions=actions or [],\n        error_code=error_code,\n        can_retry=can_retry,\n    )\n\n\ndef create_system_error(\n    title: str,\n    message: str,\n    actions: list[str] | None = None,\n    error_code: str | None = None,\n    can_retry: bool = True,  # System errors are often transient\n    technical_details: str | None = None,\n) -> StructuredError:\n    return StructuredError(\n        error_type=ErrorType.SYSTEM_ERROR,\n        title=title,\n        message=message,\n        actions=actions or [\"Wait a moment and try again\", \"Contact support if the problem persists\"],\n        error_code=error_code,\n        can_retry=can_retry,\n        contact_support=True,\n        technical_details=technical_details,\n    )\n\n\ndef create_config_error(\n    title: str,\n    message: str,\n    actions: list[str] | None = None,\n    error_code: str | None = None,\n) -> StructuredError:\n    return StructuredError(\n        error_type=ErrorType.CONFIG_ERROR,\n        title=title,\n        message=message,\n        actions=actions or [\"Contact your administrator\"],\n        error_code=error_code,\n        can_retry=False,\n        contact_support=True,\n    )\n",[944,1534,1535,1546,1555,1563,1582,1600,1612,1617,1625,1640,1650,1660,1676,1686,1696,1701,1705,1709,1718,1726,1734,1752,1768,1785,1802,1806,1812,1826,1835,1844,1868,1877,1886,1899,1910,1915,1920,1925,1935,1944,1953,1972,1989,1994,2001,2015,2024,2033,2051,2060,2072,2083],{"__ignoreMap":987},[991,1536,1537,1540,1543],{"class":993,"line":994},[991,1538,1539],{"class":997},"def",[991,1541,1542],{"class":1152}," create_user_error",[991,1544,1545],{"class":1001},"(\n",[991,1547,1548,1550,1552],{"class":993,"line":1011},[991,1549,1173],{"class":1001},[991,1551,1176],{"class":1036},[991,1553,1554],{"class":1001},",\n",[991,1556,1557,1559,1561],{"class":993,"line":1018},[991,1558,1185],{"class":1001},[991,1560,1176],{"class":1036},[991,1562,1554],{"class":1001},[991,1564,1565,1567,1569,1571,1574,1576,1578,1580],{"class":993,"line":1023},[991,1566,1196],{"class":1001},[991,1568,1176],{"class":1036},[991,1570,1201],{"class":1001},[991,1572,1573],{"class":997},"|",[991,1575,1236],{"class":1036},[991,1577,1049],{"class":997},[991,1579,1236],{"class":1036},[991,1581,1554],{"class":1001},[991,1583,1584,1587,1589,1592,1594,1596,1598],{"class":993,"line":1043},[991,1585,1586],{"class":1001},"    error_code: ",[991,1588,1176],{"class":1036},[991,1590,1591],{"class":997}," |",[991,1593,1236],{"class":1036},[991,1595,1049],{"class":997},[991,1597,1236],{"class":1036},[991,1599,1554],{"class":1001},[991,1601,1602,1604,1606,1608,1610],{"class":993,"line":1060},[991,1603,1245],{"class":1001},[991,1605,1248],{"class":1036},[991,1607,1049],{"class":997},[991,1609,1253],{"class":1036},[991,1611,1554],{"class":1001},[991,1613,1614],{"class":993,"line":1074},[991,1615,1616],{"class":1001},") -> StructuredError:\n",[991,1618,1619,1622],{"class":993,"line":1088},[991,1620,1621],{"class":997},"    return",[991,1623,1624],{"class":1001}," StructuredError(\n",[991,1626,1627,1630,1632,1635,1638],{"class":993,"line":1182},[991,1628,1629],{"class":1029},"        error_type",[991,1631,1204],{"class":997},[991,1633,1634],{"class":1001},"ErrorType.",[991,1636,1637],{"class":1036},"USER_ERROR",[991,1639,1554],{"class":1001},[991,1641,1642,1645,1647],{"class":993,"line":1193},[991,1643,1644],{"class":1029},"        title",[991,1646,1204],{"class":997},[991,1648,1649],{"class":1001},"title,\n",[991,1651,1652,1655,1657],{"class":993,"line":1224},[991,1653,1654],{"class":1029},"        message",[991,1656,1204],{"class":997},[991,1658,1659],{"class":1001},"message,\n",[991,1661,1662,1665,1667,1670,1673],{"class":993,"line":1242},[991,1663,1664],{"class":1029},"        actions",[991,1666,1204],{"class":997},[991,1668,1669],{"class":1001},"actions ",[991,1671,1672],{"class":997},"or",[991,1674,1675],{"class":1001}," [],\n",[991,1677,1678,1681,1683],{"class":993,"line":1259},[991,1679,1680],{"class":1029},"        error_code",[991,1682,1204],{"class":997},[991,1684,1685],{"class":1001},"error_code,\n",[991,1687,1688,1691,1693],{"class":993,"line":1274},[991,1689,1690],{"class":1029},"        can_retry",[991,1692,1204],{"class":997},[991,1694,1695],{"class":1001},"can_retry,\n",[991,1697,1698],{"class":993,"line":1291},[991,1699,1700],{"class":1001},"    )\n",[991,1702,1703],{"class":993,"line":1296},[991,1704,1015],{"emptyLinePlaceholder":1014},[991,1706,1707],{"class":993,"line":1312},[991,1708,1015],{"emptyLinePlaceholder":1014},[991,1710,1711,1713,1716],{"class":993,"line":1318},[991,1712,1539],{"class":997},[991,1714,1715],{"class":1152}," create_system_error",[991,1717,1545],{"class":1001},[991,1719,1720,1722,1724],{"class":993,"line":1363},[991,1721,1173],{"class":1001},[991,1723,1176],{"class":1036},[991,1725,1554],{"class":1001},[991,1727,1728,1730,1732],{"class":993,"line":1375},[991,1729,1185],{"class":1001},[991,1731,1176],{"class":1036},[991,1733,1554],{"class":1001},[991,1735,1736,1738,1740,1742,1744,1746,1748,1750],{"class":993,"line":1396},[991,1737,1196],{"class":1001},[991,1739,1176],{"class":1036},[991,1741,1201],{"class":1001},[991,1743,1573],{"class":997},[991,1745,1236],{"class":1036},[991,1747,1049],{"class":997},[991,1749,1236],{"class":1036},[991,1751,1554],{"class":1001},[991,1753,1754,1756,1758,1760,1762,1764,1766],{"class":993,"line":1434},[991,1755,1586],{"class":1001},[991,1757,1176],{"class":1036},[991,1759,1591],{"class":997},[991,1761,1236],{"class":1036},[991,1763,1049],{"class":997},[991,1765,1236],{"class":1036},[991,1767,1554],{"class":1001},[991,1769,1770,1772,1774,1776,1779,1782],{"class":993,"line":1444},[991,1771,1245],{"class":1001},[991,1773,1248],{"class":1036},[991,1775,1049],{"class":997},[991,1777,1778],{"class":1036}," True",[991,1780,1781],{"class":1001},",  ",[991,1783,1784],{"class":1056},"# System errors are often transient\n",[991,1786,1787,1790,1792,1794,1796,1798,1800],{"class":993,"line":1476},[991,1788,1789],{"class":1001},"    technical_details: ",[991,1791,1176],{"class":1036},[991,1793,1591],{"class":997},[991,1795,1236],{"class":1036},[991,1797,1049],{"class":997},[991,1799,1236],{"class":1036},[991,1801,1554],{"class":1001},[991,1803,1804],{"class":993,"line":1486},[991,1805,1616],{"class":1001},[991,1807,1808,1810],{"class":993,"line":1504},[991,1809,1621],{"class":997},[991,1811,1624],{"class":1001},[991,1813,1815,1817,1819,1821,1824],{"class":993,"line":1814},27,[991,1816,1629],{"class":1029},[991,1818,1204],{"class":997},[991,1820,1634],{"class":1001},[991,1822,1823],{"class":1036},"SYSTEM_ERROR",[991,1825,1554],{"class":1001},[991,1827,1829,1831,1833],{"class":993,"line":1828},28,[991,1830,1644],{"class":1029},[991,1832,1204],{"class":997},[991,1834,1649],{"class":1001},[991,1836,1838,1840,1842],{"class":993,"line":1837},29,[991,1839,1654],{"class":1029},[991,1841,1204],{"class":997},[991,1843,1659],{"class":1001},[991,1845,1847,1849,1851,1853,1855,1857,1860,1862,1865],{"class":993,"line":1846},30,[991,1848,1664],{"class":1029},[991,1850,1204],{"class":997},[991,1852,1669],{"class":1001},[991,1854,1672],{"class":997},[991,1856,1326],{"class":1001},[991,1858,1859],{"class":1052},"\"Wait a moment and try again\"",[991,1861,1350],{"class":1001},[991,1863,1864],{"class":1052},"\"Contact support if the problem persists\"",[991,1866,1867],{"class":1001},"],\n",[991,1869,1871,1873,1875],{"class":993,"line":1870},31,[991,1872,1680],{"class":1029},[991,1874,1204],{"class":997},[991,1876,1685],{"class":1001},[991,1878,1880,1882,1884],{"class":993,"line":1879},32,[991,1881,1690],{"class":1029},[991,1883,1204],{"class":997},[991,1885,1695],{"class":1001},[991,1887,1889,1892,1894,1897],{"class":993,"line":1888},33,[991,1890,1891],{"class":1029},"        contact_support",[991,1893,1204],{"class":997},[991,1895,1896],{"class":1036},"True",[991,1898,1554],{"class":1001},[991,1900,1902,1905,1907],{"class":993,"line":1901},34,[991,1903,1904],{"class":1029},"        technical_details",[991,1906,1204],{"class":997},[991,1908,1909],{"class":1001},"technical_details,\n",[991,1911,1913],{"class":993,"line":1912},35,[991,1914,1700],{"class":1001},[991,1916,1918],{"class":993,"line":1917},36,[991,1919,1015],{"emptyLinePlaceholder":1014},[991,1921,1923],{"class":993,"line":1922},37,[991,1924,1015],{"emptyLinePlaceholder":1014},[991,1926,1928,1930,1933],{"class":993,"line":1927},38,[991,1929,1539],{"class":997},[991,1931,1932],{"class":1152}," create_config_error",[991,1934,1545],{"class":1001},[991,1936,1938,1940,1942],{"class":993,"line":1937},39,[991,1939,1173],{"class":1001},[991,1941,1176],{"class":1036},[991,1943,1554],{"class":1001},[991,1945,1947,1949,1951],{"class":993,"line":1946},40,[991,1948,1185],{"class":1001},[991,1950,1176],{"class":1036},[991,1952,1554],{"class":1001},[991,1954,1956,1958,1960,1962,1964,1966,1968,1970],{"class":993,"line":1955},41,[991,1957,1196],{"class":1001},[991,1959,1176],{"class":1036},[991,1961,1201],{"class":1001},[991,1963,1573],{"class":997},[991,1965,1236],{"class":1036},[991,1967,1049],{"class":997},[991,1969,1236],{"class":1036},[991,1971,1554],{"class":1001},[991,1973,1975,1977,1979,1981,1983,1985,1987],{"class":993,"line":1974},42,[991,1976,1586],{"class":1001},[991,1978,1176],{"class":1036},[991,1980,1591],{"class":997},[991,1982,1236],{"class":1036},[991,1984,1049],{"class":997},[991,1986,1236],{"class":1036},[991,1988,1554],{"class":1001},[991,1990,1992],{"class":993,"line":1991},43,[991,1993,1616],{"class":1001},[991,1995,1997,1999],{"class":993,"line":1996},44,[991,1998,1621],{"class":997},[991,2000,1624],{"class":1001},[991,2002,2004,2006,2008,2010,2013],{"class":993,"line":2003},45,[991,2005,1629],{"class":1029},[991,2007,1204],{"class":997},[991,2009,1634],{"class":1001},[991,2011,2012],{"class":1036},"CONFIG_ERROR",[991,2014,1554],{"class":1001},[991,2016,2018,2020,2022],{"class":993,"line":2017},46,[991,2019,1644],{"class":1029},[991,2021,1204],{"class":997},[991,2023,1649],{"class":1001},[991,2025,2027,2029,2031],{"class":993,"line":2026},47,[991,2028,1654],{"class":1029},[991,2030,1204],{"class":997},[991,2032,1659],{"class":1001},[991,2034,2036,2038,2040,2042,2044,2046,2049],{"class":993,"line":2035},48,[991,2037,1664],{"class":1029},[991,2039,1204],{"class":997},[991,2041,1669],{"class":1001},[991,2043,1672],{"class":997},[991,2045,1326],{"class":1001},[991,2047,2048],{"class":1052},"\"Contact your administrator\"",[991,2050,1867],{"class":1001},[991,2052,2054,2056,2058],{"class":993,"line":2053},49,[991,2055,1680],{"class":1029},[991,2057,1204],{"class":997},[991,2059,1685],{"class":1001},[991,2061,2063,2065,2067,2070],{"class":993,"line":2062},50,[991,2064,1690],{"class":1029},[991,2066,1204],{"class":997},[991,2068,2069],{"class":1036},"False",[991,2071,1554],{"class":1001},[991,2073,2075,2077,2079,2081],{"class":993,"line":2074},51,[991,2076,1891],{"class":1029},[991,2078,1204],{"class":997},[991,2080,1896],{"class":1036},[991,2082,1554],{"class":1001},[991,2084,2086],{"class":993,"line":2085},52,[991,2087,1700],{"class":1001},[936,2089,2091],{"id":2090},"error-codes","Error codes",[915,2093,2094],{},"Assign numeric codes to every distinct error so operators can look them up in your runbook without reading a full stack trace.",[915,2096,2097],{},"A simple numbering convention:",[2099,2100,2101,2114],"table",{},[2102,2103,2104],"thead",{},[2105,2106,2107,2111],"tr",{},[2108,2109,2110],"th",{},"Range",[2108,2112,2113],{},"Category",[2115,2116,2117,2132,2145,2158,2171],"tbody",{},[2105,2118,2119,2129],{},[2120,2121,2122,2125,2126],"td",{},[944,2123,2124],{},"WF_100"," – ",[944,2127,2128],{},"WF_199",[2120,2130,2131],{},"User input errors",[2105,2133,2134,2142],{},[2120,2135,2136,2125,2139],{},[944,2137,2138],{},"WF_200",[944,2140,2141],{},"WF_299",[2120,2143,2144],{},"Data validation errors",[2105,2146,2147,2155],{},[2120,2148,2149,2125,2152],{},[944,2150,2151],{},"WF_300",[944,2153,2154],{},"WF_399",[2120,2156,2157],{},"External API errors",[2105,2159,2160,2168],{},[2120,2161,2162,2125,2165],{},[944,2163,2164],{},"WF_400",[944,2166,2167],{},"WF_499",[2120,2169,2170],{},"Configuration errors",[2105,2172,2173,2181],{},[2120,2174,2175,2125,2178],{},[944,2176,2177],{},"WF_500",[944,2179,2180],{},"WF_599",[2120,2182,2183],{},"Instrument \u002F hardware errors",[982,2185,2187],{"className":984,"code":2186,"language":986,"meta":987,"style":987},"class ErrorCode:\n    # User input\n    NO_SAMPLES_SELECTED = \"WF_100\"\n    INVALID_SAMPLE_ID = \"WF_101\"\n    INVALID_PARAMETER_VALUE = \"WF_102\"\n\n    # Data\n    NO_DATA_FOUND = \"WF_200\"\n    MISSING_INSTRUMENT_DATA = \"WF_201\"\n\n    # External APIs\n    API_TIMEOUT = \"WF_300\"\n    API_AUTH_FAILED = \"WF_301\"\n    API_NOT_FOUND = \"WF_302\"\n\n    # Configuration\n    MISSING_CREDENTIALS = \"WF_400\"\n    MISSING_ENV_VAR = \"WF_401\"\n\n    # Instruments\n    INSTRUMENT_UNREACHABLE = \"WF_500\"\n    INSTRUMENT_RUN_FAILED = \"WF_501\"\n",[944,2188,2189,2198,2203,2213,2223,2233,2237,2242,2252,2262,2266,2271,2281,2291,2301,2305,2310,2320,2330,2334,2339,2349],{"__ignoreMap":987},[991,2190,2191,2193,2196],{"class":993,"line":994},[991,2192,1026],{"class":997},[991,2194,2195],{"class":1029}," ErrorCode",[991,2197,1163],{"class":1001},[991,2199,2200],{"class":993,"line":1011},[991,2201,2202],{"class":1056},"    # User input\n",[991,2204,2205,2208,2210],{"class":993,"line":1018},[991,2206,2207],{"class":1036},"    NO_SAMPLES_SELECTED",[991,2209,1049],{"class":997},[991,2211,2212],{"class":1052}," \"WF_100\"\n",[991,2214,2215,2218,2220],{"class":993,"line":1023},[991,2216,2217],{"class":1036},"    INVALID_SAMPLE_ID",[991,2219,1049],{"class":997},[991,2221,2222],{"class":1052}," \"WF_101\"\n",[991,2224,2225,2228,2230],{"class":993,"line":1043},[991,2226,2227],{"class":1036},"    INVALID_PARAMETER_VALUE",[991,2229,1049],{"class":997},[991,2231,2232],{"class":1052}," \"WF_102\"\n",[991,2234,2235],{"class":993,"line":1060},[991,2236,1015],{"emptyLinePlaceholder":1014},[991,2238,2239],{"class":993,"line":1074},[991,2240,2241],{"class":1056},"    # Data\n",[991,2243,2244,2247,2249],{"class":993,"line":1088},[991,2245,2246],{"class":1036},"    NO_DATA_FOUND",[991,2248,1049],{"class":997},[991,2250,2251],{"class":1052}," \"WF_200\"\n",[991,2253,2254,2257,2259],{"class":993,"line":1182},[991,2255,2256],{"class":1036},"    MISSING_INSTRUMENT_DATA",[991,2258,1049],{"class":997},[991,2260,2261],{"class":1052}," \"WF_201\"\n",[991,2263,2264],{"class":993,"line":1193},[991,2265,1015],{"emptyLinePlaceholder":1014},[991,2267,2268],{"class":993,"line":1224},[991,2269,2270],{"class":1056},"    # External APIs\n",[991,2272,2273,2276,2278],{"class":993,"line":1242},[991,2274,2275],{"class":1036},"    API_TIMEOUT",[991,2277,1049],{"class":997},[991,2279,2280],{"class":1052}," \"WF_300\"\n",[991,2282,2283,2286,2288],{"class":993,"line":1259},[991,2284,2285],{"class":1036},"    API_AUTH_FAILED",[991,2287,1049],{"class":997},[991,2289,2290],{"class":1052}," \"WF_301\"\n",[991,2292,2293,2296,2298],{"class":993,"line":1274},[991,2294,2295],{"class":1036},"    API_NOT_FOUND",[991,2297,1049],{"class":997},[991,2299,2300],{"class":1052}," \"WF_302\"\n",[991,2302,2303],{"class":993,"line":1291},[991,2304,1015],{"emptyLinePlaceholder":1014},[991,2306,2307],{"class":993,"line":1296},[991,2308,2309],{"class":1056},"    # Configuration\n",[991,2311,2312,2315,2317],{"class":993,"line":1312},[991,2313,2314],{"class":1036},"    MISSING_CREDENTIALS",[991,2316,1049],{"class":997},[991,2318,2319],{"class":1052}," \"WF_400\"\n",[991,2321,2322,2325,2327],{"class":993,"line":1318},[991,2323,2324],{"class":1036},"    MISSING_ENV_VAR",[991,2326,1049],{"class":997},[991,2328,2329],{"class":1052}," \"WF_401\"\n",[991,2331,2332],{"class":993,"line":1363},[991,2333,1015],{"emptyLinePlaceholder":1014},[991,2335,2336],{"class":993,"line":1375},[991,2337,2338],{"class":1056},"    # Instruments\n",[991,2340,2341,2344,2346],{"class":993,"line":1396},[991,2342,2343],{"class":1036},"    INSTRUMENT_UNREACHABLE",[991,2345,1049],{"class":997},[991,2347,2348],{"class":1052}," \"WF_500\"\n",[991,2350,2351,2354,2356],{"class":993,"line":1434},[991,2352,2353],{"class":1036},"    INSTRUMENT_RUN_FAILED",[991,2355,1049],{"class":997},[991,2357,2358],{"class":1052}," \"WF_501\"\n",[936,2360,2362],{"id":2361},"pre-built-error-constructors","Pre-built error constructors",[915,2364,2365],{},"For each domain-specific error condition, write a named constructor. This keeps error definitions in one place and makes intent obvious at the call site.",[982,2367,2369],{"className":984,"code":2368,"language":986,"meta":987,"style":987},"def no_samples_error() -> StructuredError:\n    return create_user_error(\n        title=\"No Samples Selected\",\n        message=\"At least one sample must be selected to start the workflow.\",\n        actions=[\n            \"Select one or more samples from the list\",\n            \"Verify the samples exist in the system\",\n        ],\n        error_code=ErrorCode.NO_SAMPLES_SELECTED,\n        can_retry=True,\n    )\n\n\ndef instrument_unreachable_error(instrument_name: str) -> StructuredError:\n    return create_system_error(\n        title=f\"{instrument_name} Unreachable\",\n        message=f\"Could not connect to {instrument_name}. The instrument may be offline or the connector may have stopped.\",\n        actions=[\n            f\"Check that {instrument_name} is powered on\",\n            \"Verify the connector service is running\",\n            \"Restart the connector if needed\",\n        ],\n        error_code=ErrorCode.INSTRUMENT_UNREACHABLE,\n        can_retry=True,\n    )\n\n\ndef missing_env_var_error(var_name: str) -> StructuredError:\n    return create_config_error(\n        title=\"Missing Configuration\",\n        message=f\"Required environment variable '{var_name}' is not set.\",\n        actions=[\n            f\"Set {var_name} in your .env file or CI\u002FCD secrets\",\n            \"Contact your administrator if you do not have access\",\n        ],\n        error_code=ErrorCode.MISSING_ENV_VAR,\n    )\n",[944,2370,2371,2381,2388,2399,2410,2419,2426,2433,2438,2452,2462,2466,2470,2474,2488,2495,2517,2539,2547,2566,2573,2580,2584,2597,2607,2611,2615,2619,2633,2640,2651,2674,2682,2700,2707,2711,2724],{"__ignoreMap":987},[991,2372,2373,2375,2378],{"class":993,"line":994},[991,2374,1539],{"class":997},[991,2376,2377],{"class":1152}," no_samples_error",[991,2379,2380],{"class":1001},"() -> StructuredError:\n",[991,2382,2383,2385],{"class":993,"line":1011},[991,2384,1621],{"class":997},[991,2386,2387],{"class":1001}," create_user_error(\n",[991,2389,2390,2392,2394,2397],{"class":993,"line":1018},[991,2391,1644],{"class":1029},[991,2393,1204],{"class":997},[991,2395,2396],{"class":1052},"\"No Samples Selected\"",[991,2398,1554],{"class":1001},[991,2400,2401,2403,2405,2408],{"class":993,"line":1023},[991,2402,1654],{"class":1029},[991,2404,1204],{"class":997},[991,2406,2407],{"class":1052},"\"At least one sample must be selected to start the workflow.\"",[991,2409,1554],{"class":1001},[991,2411,2412,2414,2416],{"class":993,"line":1043},[991,2413,1664],{"class":1029},[991,2415,1204],{"class":997},[991,2417,2418],{"class":1001},"[\n",[991,2420,2421,2424],{"class":993,"line":1060},[991,2422,2423],{"class":1052},"            \"Select one or more samples from the list\"",[991,2425,1554],{"class":1001},[991,2427,2428,2431],{"class":993,"line":1074},[991,2429,2430],{"class":1052},"            \"Verify the samples exist in the system\"",[991,2432,1554],{"class":1001},[991,2434,2435],{"class":993,"line":1088},[991,2436,2437],{"class":1001},"        ],\n",[991,2439,2440,2442,2444,2447,2450],{"class":993,"line":1182},[991,2441,1680],{"class":1029},[991,2443,1204],{"class":997},[991,2445,2446],{"class":1001},"ErrorCode.",[991,2448,2449],{"class":1036},"NO_SAMPLES_SELECTED",[991,2451,1554],{"class":1001},[991,2453,2454,2456,2458,2460],{"class":993,"line":1193},[991,2455,1690],{"class":1029},[991,2457,1204],{"class":997},[991,2459,1896],{"class":1036},[991,2461,1554],{"class":1001},[991,2463,2464],{"class":993,"line":1224},[991,2465,1700],{"class":1001},[991,2467,2468],{"class":993,"line":1242},[991,2469,1015],{"emptyLinePlaceholder":1014},[991,2471,2472],{"class":993,"line":1259},[991,2473,1015],{"emptyLinePlaceholder":1014},[991,2475,2476,2478,2481,2484,2486],{"class":993,"line":1274},[991,2477,1539],{"class":997},[991,2479,2480],{"class":1152}," instrument_unreachable_error",[991,2482,2483],{"class":1001},"(instrument_name: ",[991,2485,1176],{"class":1036},[991,2487,1616],{"class":1001},[991,2489,2490,2492],{"class":993,"line":1291},[991,2491,1621],{"class":997},[991,2493,2494],{"class":1001}," create_system_error(\n",[991,2496,2497,2499,2501,2503,2505,2507,2510,2512,2515],{"class":993,"line":1296},[991,2498,1644],{"class":1029},[991,2500,1204],{"class":997},[991,2502,1329],{"class":997},[991,2504,1417],{"class":1052},[991,2506,1335],{"class":997},[991,2508,2509],{"class":1001},"instrument_name",[991,2511,1344],{"class":997},[991,2513,2514],{"class":1052}," Unreachable\"",[991,2516,1554],{"class":1001},[991,2518,2519,2521,2523,2525,2528,2530,2532,2534,2537],{"class":993,"line":1312},[991,2520,1654],{"class":1029},[991,2522,1204],{"class":997},[991,2524,1329],{"class":997},[991,2526,2527],{"class":1052},"\"Could not connect to ",[991,2529,1335],{"class":997},[991,2531,2509],{"class":1001},[991,2533,1344],{"class":997},[991,2535,2536],{"class":1052},". The instrument may be offline or the connector may have stopped.\"",[991,2538,1554],{"class":1001},[991,2540,2541,2543,2545],{"class":993,"line":1318},[991,2542,1664],{"class":1029},[991,2544,1204],{"class":997},[991,2546,2418],{"class":1001},[991,2548,2549,2552,2555,2557,2559,2561,2564],{"class":993,"line":1363},[991,2550,2551],{"class":997},"            f",[991,2553,2554],{"class":1052},"\"Check that ",[991,2556,1335],{"class":997},[991,2558,2509],{"class":1001},[991,2560,1344],{"class":997},[991,2562,2563],{"class":1052}," is powered on\"",[991,2565,1554],{"class":1001},[991,2567,2568,2571],{"class":993,"line":1375},[991,2569,2570],{"class":1052},"            \"Verify the connector service is running\"",[991,2572,1554],{"class":1001},[991,2574,2575,2578],{"class":993,"line":1396},[991,2576,2577],{"class":1052},"            \"Restart the connector if needed\"",[991,2579,1554],{"class":1001},[991,2581,2582],{"class":993,"line":1434},[991,2583,2437],{"class":1001},[991,2585,2586,2588,2590,2592,2595],{"class":993,"line":1444},[991,2587,1680],{"class":1029},[991,2589,1204],{"class":997},[991,2591,2446],{"class":1001},[991,2593,2594],{"class":1036},"INSTRUMENT_UNREACHABLE",[991,2596,1554],{"class":1001},[991,2598,2599,2601,2603,2605],{"class":993,"line":1476},[991,2600,1690],{"class":1029},[991,2602,1204],{"class":997},[991,2604,1896],{"class":1036},[991,2606,1554],{"class":1001},[991,2608,2609],{"class":993,"line":1486},[991,2610,1700],{"class":1001},[991,2612,2613],{"class":993,"line":1504},[991,2614,1015],{"emptyLinePlaceholder":1014},[991,2616,2617],{"class":993,"line":1814},[991,2618,1015],{"emptyLinePlaceholder":1014},[991,2620,2621,2623,2626,2629,2631],{"class":993,"line":1828},[991,2622,1539],{"class":997},[991,2624,2625],{"class":1152}," missing_env_var_error",[991,2627,2628],{"class":1001},"(var_name: ",[991,2630,1176],{"class":1036},[991,2632,1616],{"class":1001},[991,2634,2635,2637],{"class":993,"line":1837},[991,2636,1621],{"class":997},[991,2638,2639],{"class":1001}," create_config_error(\n",[991,2641,2642,2644,2646,2649],{"class":993,"line":1846},[991,2643,1644],{"class":1029},[991,2645,1204],{"class":997},[991,2647,2648],{"class":1052},"\"Missing Configuration\"",[991,2650,1554],{"class":1001},[991,2652,2653,2655,2657,2659,2662,2664,2667,2669,2672],{"class":993,"line":1870},[991,2654,1654],{"class":1029},[991,2656,1204],{"class":997},[991,2658,1329],{"class":997},[991,2660,2661],{"class":1052},"\"Required environment variable '",[991,2663,1335],{"class":997},[991,2665,2666],{"class":1001},"var_name",[991,2668,1344],{"class":997},[991,2670,2671],{"class":1052},"' is not set.\"",[991,2673,1554],{"class":1001},[991,2675,2676,2678,2680],{"class":993,"line":1879},[991,2677,1664],{"class":1029},[991,2679,1204],{"class":997},[991,2681,2418],{"class":1001},[991,2683,2684,2686,2689,2691,2693,2695,2698],{"class":993,"line":1888},[991,2685,2551],{"class":997},[991,2687,2688],{"class":1052},"\"Set ",[991,2690,1335],{"class":997},[991,2692,2666],{"class":1001},[991,2694,1344],{"class":997},[991,2696,2697],{"class":1052}," in your .env file or CI\u002FCD secrets\"",[991,2699,1554],{"class":1001},[991,2701,2702,2705],{"class":993,"line":1901},[991,2703,2704],{"class":1052},"            \"Contact your administrator if you do not have access\"",[991,2706,1554],{"class":1001},[991,2708,2709],{"class":993,"line":1912},[991,2710,2437],{"class":1001},[991,2712,2713,2715,2717,2719,2722],{"class":993,"line":1917},[991,2714,1680],{"class":1029},[991,2716,1204],{"class":997},[991,2718,2446],{"class":1001},[991,2720,2721],{"class":1036},"MISSING_ENV_VAR",[991,2723,1554],{"class":1001},[991,2725,2726],{"class":993,"line":1922},[991,2727,1700],{"class":1001},[936,2729,2731],{"id":2730},"raise-structured-errors-from-a-workflow","Raise structured errors from a workflow",[915,2733,2734,2735,2737],{},"Wrap ",[944,2736,1109],{}," in an exception class so it can be raised and caught naturally:",[982,2739,2741],{"className":984,"code":2740,"language":986,"meta":987,"style":987},"class WorkflowError(Exception):\n    def __init__(self, structured_error: StructuredError) -> None:\n        super().__init__(structured_error.title)\n        self.structured_error = structured_error\n\n\n# Raising:\nsample_ids = []\nif not sample_ids:\n    raise WorkflowError(no_samples_error())\n",[944,2742,2743,2757,2772,2786,2799,2803,2807,2812,2822,2833],{"__ignoreMap":987},[991,2744,2745,2747,2750,2752,2755],{"class":993,"line":994},[991,2746,1026],{"class":997},[991,2748,2749],{"class":1029}," WorkflowError",[991,2751,1033],{"class":1001},[991,2753,2754],{"class":1036},"Exception",[991,2756,1040],{"class":1001},[991,2758,2759,2761,2764,2767,2770],{"class":993,"line":1011},[991,2760,1299],{"class":997},[991,2762,2763],{"class":1036}," __init__",[991,2765,2766],{"class":1001},"(self, structured_error: StructuredError) -> ",[991,2768,2769],{"class":1036},"None",[991,2771,1163],{"class":1001},[991,2773,2774,2777,2780,2783],{"class":993,"line":1018},[991,2775,2776],{"class":1036},"        super",[991,2778,2779],{"class":1001},"().",[991,2781,2782],{"class":1036},"__init__",[991,2784,2785],{"class":1001},"(structured_error.title)\n",[991,2787,2788,2791,2794,2796],{"class":993,"line":1023},[991,2789,2790],{"class":1036},"        self",[991,2792,2793],{"class":1001},".structured_error ",[991,2795,1204],{"class":997},[991,2797,2798],{"class":1001}," structured_error\n",[991,2800,2801],{"class":993,"line":1043},[991,2802,1015],{"emptyLinePlaceholder":1014},[991,2804,2805],{"class":993,"line":1060},[991,2806,1015],{"emptyLinePlaceholder":1014},[991,2808,2809],{"class":993,"line":1074},[991,2810,2811],{"class":1056},"# Raising:\n",[991,2813,2814,2817,2819],{"class":993,"line":1088},[991,2815,2816],{"class":1001},"sample_ids ",[991,2818,1204],{"class":997},[991,2820,2821],{"class":1001}," []\n",[991,2823,2824,2827,2830],{"class":993,"line":1182},[991,2825,2826],{"class":997},"if",[991,2828,2829],{"class":997}," not",[991,2831,2832],{"class":1001}," sample_ids:\n",[991,2834,2835,2838],{"class":993,"line":1193},[991,2836,2837],{"class":997},"    raise",[991,2839,2840],{"class":1001}," WorkflowError(no_samples_error())\n",[915,2842,2843],{},"Handle it in the workflow:",[982,2845,2847],{"className":984,"code":2846,"language":986,"meta":987,"style":987},"from unitelabs.sdk import get_logger\nfrom unitelabs.sdk.automate import workflow\n\n\n@workflow(log_prints=True, name=\"Structured Error Example\")\nasync def process_flow(sample_ids: list[str]) -> dict:\n    logger = get_logger()\n    try:\n        if not sample_ids:\n            raise WorkflowError(no_samples_error())\n\n        # ... actual processing\n        return {\"status\": \"success\"}\n\n    except WorkflowError as e:\n        err = e.structured_error\n        # Log full details for developers\n        logger.error(\n            f\"[{err.error_code}] {err.error_type.value}: {err.title}\\n\"\n            f\"Message: {err.message}\\n\"\n            f\"Can retry: {err.can_retry}\"\n        )\n        # Return structured info for callers\n        return {\n            \"status\": \"error\",\n            \"error_type\": err.error_type.value,\n            \"error_code\": err.error_code,\n            \"title\": err.title,\n            \"message\": err.message,\n            \"actions\": err.actions,\n            \"can_retry\": err.can_retry,\n        }\n",[944,2848,2849,2861,2873,2877,2881,2908,2932,2942,2949,2957,2964,2968,2973,2992,2996,3010,3020,3025,3030,3066,3082,3098,3103,3108,3115,3127,3135,3143,3151,3159,3167,3175],{"__ignoreMap":987},[991,2850,2851,2853,2856,2858],{"class":993,"line":994},[991,2852,998],{"class":997},[991,2854,2855],{"class":1001}," unitelabs.sdk ",[991,2857,1005],{"class":997},[991,2859,2860],{"class":1001}," get_logger\n",[991,2862,2863,2865,2868,2870],{"class":993,"line":1011},[991,2864,998],{"class":997},[991,2866,2867],{"class":1001}," unitelabs.sdk.automate ",[991,2869,1005],{"class":997},[991,2871,2872],{"class":1001}," workflow\n",[991,2874,2875],{"class":993,"line":1018},[991,2876,1015],{"emptyLinePlaceholder":1014},[991,2878,2879],{"class":993,"line":1023},[991,2880,1015],{"emptyLinePlaceholder":1014},[991,2882,2883,2886,2888,2891,2893,2895,2897,2900,2902,2905],{"class":993,"line":1043},[991,2884,2885],{"class":1152},"@workflow",[991,2887,1033],{"class":1001},[991,2889,2890],{"class":1029},"log_prints",[991,2892,1204],{"class":997},[991,2894,1896],{"class":1036},[991,2896,1350],{"class":1001},[991,2898,2899],{"class":1029},"name",[991,2901,1204],{"class":997},[991,2903,2904],{"class":1052},"\"Structured Error Example\"",[991,2906,2907],{"class":1001},")\n",[991,2909,2910,2913,2916,2919,2922,2924,2927,2930],{"class":993,"line":1060},[991,2911,2912],{"class":997},"async",[991,2914,2915],{"class":997}," def",[991,2917,2918],{"class":1152}," process_flow",[991,2920,2921],{"class":1001},"(sample_ids: list[",[991,2923,1176],{"class":1036},[991,2925,2926],{"class":1001},"]) -> ",[991,2928,2929],{"class":1036},"dict",[991,2931,1163],{"class":1001},[991,2933,2934,2937,2939],{"class":993,"line":1074},[991,2935,2936],{"class":1001},"    logger ",[991,2938,1204],{"class":997},[991,2940,2941],{"class":1001}," get_logger()\n",[991,2943,2944,2947],{"class":993,"line":1088},[991,2945,2946],{"class":997},"    try",[991,2948,1163],{"class":1001},[991,2950,2951,2953,2955],{"class":993,"line":1182},[991,2952,1366],{"class":997},[991,2954,2829],{"class":997},[991,2956,2832],{"class":1001},[991,2958,2959,2962],{"class":993,"line":1193},[991,2960,2961],{"class":997},"            raise",[991,2963,2840],{"class":1001},[991,2965,2966],{"class":993,"line":1224},[991,2967,1015],{"emptyLinePlaceholder":1014},[991,2969,2970],{"class":993,"line":1242},[991,2971,2972],{"class":1056},"        # ... actual processing\n",[991,2974,2975,2977,2980,2983,2986,2989],{"class":993,"line":1259},[991,2976,1507],{"class":997},[991,2978,2979],{"class":1001}," {",[991,2981,2982],{"class":1052},"\"status\"",[991,2984,2985],{"class":1001},": ",[991,2987,2988],{"class":1052},"\"success\"",[991,2990,2991],{"class":1001},"}\n",[991,2993,2994],{"class":993,"line":1274},[991,2995,1015],{"emptyLinePlaceholder":1014},[991,2997,2998,3001,3004,3007],{"class":993,"line":1291},[991,2999,3000],{"class":997},"    except",[991,3002,3003],{"class":1001}," WorkflowError ",[991,3005,3006],{"class":997},"as",[991,3008,3009],{"class":1001}," e:\n",[991,3011,3012,3015,3017],{"class":993,"line":1296},[991,3013,3014],{"class":1001},"        err ",[991,3016,1204],{"class":997},[991,3018,3019],{"class":1001}," e.structured_error\n",[991,3021,3022],{"class":993,"line":1312},[991,3023,3024],{"class":1056},"        # Log full details for developers\n",[991,3026,3027],{"class":993,"line":1318},[991,3028,3029],{"class":1001},"        logger.error(\n",[991,3031,3032,3034,3037,3039,3042,3044,3046,3048,3051,3053,3055,3057,3060,3063],{"class":993,"line":1363},[991,3033,2551],{"class":997},[991,3035,3036],{"class":1052},"\"[",[991,3038,1335],{"class":997},[991,3040,3041],{"class":1001},"err.error_code",[991,3043,1344],{"class":997},[991,3045,1201],{"class":1052},[991,3047,1335],{"class":997},[991,3049,3050],{"class":1001},"err.error_type.value",[991,3052,1344],{"class":997},[991,3054,2985],{"class":1052},[991,3056,1335],{"class":997},[991,3058,3059],{"class":1001},"err.title",[991,3061,3062],{"class":997},"}\\n",[991,3064,3065],{"class":1052},"\"\n",[991,3067,3068,3070,3073,3075,3078,3080],{"class":993,"line":1375},[991,3069,2551],{"class":997},[991,3071,3072],{"class":1052},"\"Message: ",[991,3074,1335],{"class":997},[991,3076,3077],{"class":1001},"err.message",[991,3079,3062],{"class":997},[991,3081,3065],{"class":1052},[991,3083,3084,3086,3089,3091,3094,3096],{"class":993,"line":1396},[991,3085,2551],{"class":997},[991,3087,3088],{"class":1052},"\"Can retry: ",[991,3090,1335],{"class":997},[991,3092,3093],{"class":1001},"err.can_retry",[991,3095,1344],{"class":997},[991,3097,3065],{"class":1052},[991,3099,3100],{"class":993,"line":1434},[991,3101,3102],{"class":1001},"        )\n",[991,3104,3105],{"class":993,"line":1444},[991,3106,3107],{"class":1056},"        # Return structured info for callers\n",[991,3109,3110,3112],{"class":993,"line":1476},[991,3111,1507],{"class":997},[991,3113,3114],{"class":1001}," {\n",[991,3116,3117,3120,3122,3125],{"class":993,"line":1486},[991,3118,3119],{"class":1052},"            \"status\"",[991,3121,2985],{"class":1001},[991,3123,3124],{"class":1052},"\"error\"",[991,3126,1554],{"class":1001},[991,3128,3129,3132],{"class":993,"line":1504},[991,3130,3131],{"class":1052},"            \"error_type\"",[991,3133,3134],{"class":1001},": err.error_type.value,\n",[991,3136,3137,3140],{"class":993,"line":1814},[991,3138,3139],{"class":1052},"            \"error_code\"",[991,3141,3142],{"class":1001},": err.error_code,\n",[991,3144,3145,3148],{"class":993,"line":1828},[991,3146,3147],{"class":1052},"            \"title\"",[991,3149,3150],{"class":1001},": err.title,\n",[991,3152,3153,3156],{"class":993,"line":1837},[991,3154,3155],{"class":1052},"            \"message\"",[991,3157,3158],{"class":1001},": err.message,\n",[991,3160,3161,3164],{"class":993,"line":1846},[991,3162,3163],{"class":1052},"            \"actions\"",[991,3165,3166],{"class":1001},": err.actions,\n",[991,3168,3169,3172],{"class":993,"line":1870},[991,3170,3171],{"class":1052},"            \"can_retry\"",[991,3173,3174],{"class":1001},": err.can_retry,\n",[991,3176,3177],{"class":993,"line":1879},[991,3178,3179],{"class":1001},"        }\n",[936,3181,3183],{"id":3182},"automatic-exception-classification","Automatic exception classification",[915,3185,3186,3187,3190,3191,3193,3194,3196],{},"Add a ",[944,3188,3189],{},"classify_exception"," function to map common Python exceptions to the right ",[944,3192,1109],{}," type. This means you catch and classify ",[944,3195,2754],{}," once in the workflow rather than writing specific handlers for every exception type.",[982,3198,3200],{"className":984,"code":3199,"language":986,"meta":987,"style":987},"import httpx\n\n\ndef classify_exception(exc: Exception, context: str = \"\") -> StructuredError:\n    \"\"\"Map a raw exception to a StructuredError based on its type.\"\"\"\n\n    # HTTP errors from API calls\n    if isinstance(exc, httpx.HTTPStatusError):\n        status = exc.response.status_code\n        if status in (401, 403):\n            return create_config_error(\n                title=\"Authentication Failed\",\n                message=\"API credentials are invalid or expired.\",\n                actions=[\"Contact your administrator to refresh the API credentials\"],\n                error_code=ErrorCode.API_AUTH_FAILED,\n            )\n        if status == 404:\n            return create_user_error(\n                title=\"Resource Not Found\",\n                message=f\"The requested resource does not exist{' while ' + context if context else ''}.\",\n                actions=[\"Verify the ID is correct\", \"Check that the resource has not been deleted\"],\n                error_code=ErrorCode.API_NOT_FOUND,\n            )\n        if status >= 500:\n            return create_system_error(\n                title=\"API Server Error\",\n                message=\"The API returned an unexpected server error.\",\n                error_code=ErrorCode.API_TIMEOUT,\n                technical_details=str(exc),\n            )\n\n    if isinstance(exc, httpx.TimeoutException):\n        return create_system_error(\n            title=\"Request Timed Out\",\n            message=\"The API did not respond in time.\",\n            error_code=ErrorCode.API_TIMEOUT,\n            can_retry=True,\n        )\n\n    # Missing environment variables\n    if isinstance(exc, (KeyError, RuntimeError)) and \"not set\" in str(exc).lower():\n        return create_config_error(\n            title=\"Missing Configuration\",\n            message=str(exc),\n            error_code=ErrorCode.MISSING_ENV_VAR,\n        )\n\n    # Bad user input\n    if isinstance(exc, ValueError):\n        return create_user_error(\n            title=\"Invalid Input\",\n            message=str(exc),\n            actions=[\"Review your input and try again\"],\n        )\n\n    # Fallback — unexpected bug\n    return StructuredError(\n        error_type=ErrorType.BUG,\n        title=\"Unexpected Error\",\n        message=f\"An unexpected error occurred{' while ' + context if context else ''}.\",\n        contact_support=True,\n        can_retry=False,\n        technical_details=str(exc),\n    )\n",[944,3201,3202,3209,3213,3217,3241,3246,3250,3255,3266,3276,3298,3305,3317,3329,3344,3358,3363,3377,3383,3394,3433,3451,3464,3468,3482,3488,3499,3510,3523,3535,3539,3543,3552,3558,3570,3582,3595,3606,3610,3614,3619,3654,3660,3670,3680,3692,3696,3700,3705,3719,3725,3736,3746,3761,3766,3771,3777,3784,3798,3810,3844,3855,3866,3877],{"__ignoreMap":987},[991,3203,3204,3206],{"class":993,"line":994},[991,3205,1005],{"class":997},[991,3207,3208],{"class":1001}," httpx\n",[991,3210,3211],{"class":993,"line":1011},[991,3212,1015],{"emptyLinePlaceholder":1014},[991,3214,3215],{"class":993,"line":1018},[991,3216,1015],{"emptyLinePlaceholder":1014},[991,3218,3219,3221,3224,3227,3229,3232,3234,3236,3239],{"class":993,"line":1023},[991,3220,1539],{"class":997},[991,3222,3223],{"class":1152}," classify_exception",[991,3225,3226],{"class":1001},"(exc: ",[991,3228,2754],{"class":1036},[991,3230,3231],{"class":1001},", context: ",[991,3233,1176],{"class":1036},[991,3235,1049],{"class":997},[991,3237,3238],{"class":1052}," \"\"",[991,3240,1616],{"class":1001},[991,3242,3243],{"class":993,"line":1043},[991,3244,3245],{"class":1052},"    \"\"\"Map a raw exception to a StructuredError based on its type.\"\"\"\n",[991,3247,3248],{"class":993,"line":1060},[991,3249,1015],{"emptyLinePlaceholder":1014},[991,3251,3252],{"class":993,"line":1074},[991,3253,3254],{"class":1056},"    # HTTP errors from API calls\n",[991,3256,3257,3260,3263],{"class":993,"line":1088},[991,3258,3259],{"class":997},"    if",[991,3261,3262],{"class":1036}," isinstance",[991,3264,3265],{"class":1001},"(exc, httpx.HTTPStatusError):\n",[991,3267,3268,3271,3273],{"class":993,"line":1182},[991,3269,3270],{"class":1001},"        status ",[991,3272,1204],{"class":997},[991,3274,3275],{"class":1001}," exc.response.status_code\n",[991,3277,3278,3280,3283,3285,3288,3291,3293,3296],{"class":993,"line":1193},[991,3279,1366],{"class":997},[991,3281,3282],{"class":1001}," status ",[991,3284,1426],{"class":997},[991,3286,3287],{"class":1001}," (",[991,3289,3290],{"class":1036},"401",[991,3292,1350],{"class":1001},[991,3294,3295],{"class":1036},"403",[991,3297,1040],{"class":1001},[991,3299,3300,3303],{"class":993,"line":1224},[991,3301,3302],{"class":997},"            return",[991,3304,2639],{"class":1001},[991,3306,3307,3310,3312,3315],{"class":993,"line":1242},[991,3308,3309],{"class":1029},"                title",[991,3311,1204],{"class":997},[991,3313,3314],{"class":1052},"\"Authentication Failed\"",[991,3316,1554],{"class":1001},[991,3318,3319,3322,3324,3327],{"class":993,"line":1259},[991,3320,3321],{"class":1029},"                message",[991,3323,1204],{"class":997},[991,3325,3326],{"class":1052},"\"API credentials are invalid or expired.\"",[991,3328,1554],{"class":1001},[991,3330,3331,3334,3336,3339,3342],{"class":993,"line":1274},[991,3332,3333],{"class":1029},"                actions",[991,3335,1204],{"class":997},[991,3337,3338],{"class":1001},"[",[991,3340,3341],{"class":1052},"\"Contact your administrator to refresh the API credentials\"",[991,3343,1867],{"class":1001},[991,3345,3346,3349,3351,3353,3356],{"class":993,"line":1291},[991,3347,3348],{"class":1029},"                error_code",[991,3350,1204],{"class":997},[991,3352,2446],{"class":1001},[991,3354,3355],{"class":1036},"API_AUTH_FAILED",[991,3357,1554],{"class":1001},[991,3359,3360],{"class":993,"line":1296},[991,3361,3362],{"class":1001},"            )\n",[991,3364,3365,3367,3369,3372,3375],{"class":993,"line":1312},[991,3366,1366],{"class":997},[991,3368,3282],{"class":1001},[991,3370,3371],{"class":997},"==",[991,3373,3374],{"class":1036}," 404",[991,3376,1163],{"class":1001},[991,3378,3379,3381],{"class":993,"line":1318},[991,3380,3302],{"class":997},[991,3382,2387],{"class":1001},[991,3384,3385,3387,3389,3392],{"class":993,"line":1363},[991,3386,3309],{"class":1029},[991,3388,1204],{"class":997},[991,3390,3391],{"class":1052},"\"Resource Not Found\"",[991,3393,1554],{"class":1001},[991,3395,3396,3398,3400,3402,3405,3407,3410,3413,3416,3418,3420,3423,3426,3428,3431],{"class":993,"line":1375},[991,3397,3321],{"class":1029},[991,3399,1204],{"class":997},[991,3401,1329],{"class":997},[991,3403,3404],{"class":1052},"\"The requested resource does not exist",[991,3406,1335],{"class":997},[991,3408,3409],{"class":1052},"' while '",[991,3411,3412],{"class":997}," +",[991,3414,3415],{"class":1001}," context ",[991,3417,2826],{"class":997},[991,3419,3415],{"class":1001},[991,3421,3422],{"class":997},"else",[991,3424,3425],{"class":1052}," ''",[991,3427,1344],{"class":997},[991,3429,3430],{"class":1052},".\"",[991,3432,1554],{"class":1001},[991,3434,3435,3437,3439,3441,3444,3446,3449],{"class":993,"line":1396},[991,3436,3333],{"class":1029},[991,3438,1204],{"class":997},[991,3440,3338],{"class":1001},[991,3442,3443],{"class":1052},"\"Verify the ID is correct\"",[991,3445,1350],{"class":1001},[991,3447,3448],{"class":1052},"\"Check that the resource has not been deleted\"",[991,3450,1867],{"class":1001},[991,3452,3453,3455,3457,3459,3462],{"class":993,"line":1434},[991,3454,3348],{"class":1029},[991,3456,1204],{"class":997},[991,3458,2446],{"class":1001},[991,3460,3461],{"class":1036},"API_NOT_FOUND",[991,3463,1554],{"class":1001},[991,3465,3466],{"class":993,"line":1444},[991,3467,3362],{"class":1001},[991,3469,3470,3472,3474,3477,3480],{"class":993,"line":1476},[991,3471,1366],{"class":997},[991,3473,3282],{"class":1001},[991,3475,3476],{"class":997},">=",[991,3478,3479],{"class":1036}," 500",[991,3481,1163],{"class":1001},[991,3483,3484,3486],{"class":993,"line":1486},[991,3485,3302],{"class":997},[991,3487,2494],{"class":1001},[991,3489,3490,3492,3494,3497],{"class":993,"line":1504},[991,3491,3309],{"class":1029},[991,3493,1204],{"class":997},[991,3495,3496],{"class":1052},"\"API Server Error\"",[991,3498,1554],{"class":1001},[991,3500,3501,3503,3505,3508],{"class":993,"line":1814},[991,3502,3321],{"class":1029},[991,3504,1204],{"class":997},[991,3506,3507],{"class":1052},"\"The API returned an unexpected server error.\"",[991,3509,1554],{"class":1001},[991,3511,3512,3514,3516,3518,3521],{"class":993,"line":1828},[991,3513,3348],{"class":1029},[991,3515,1204],{"class":997},[991,3517,2446],{"class":1001},[991,3519,3520],{"class":1036},"API_TIMEOUT",[991,3522,1554],{"class":1001},[991,3524,3525,3528,3530,3532],{"class":993,"line":1837},[991,3526,3527],{"class":1029},"                technical_details",[991,3529,1204],{"class":997},[991,3531,1176],{"class":1036},[991,3533,3534],{"class":1001},"(exc),\n",[991,3536,3537],{"class":993,"line":1846},[991,3538,3362],{"class":1001},[991,3540,3541],{"class":993,"line":1870},[991,3542,1015],{"emptyLinePlaceholder":1014},[991,3544,3545,3547,3549],{"class":993,"line":1879},[991,3546,3259],{"class":997},[991,3548,3262],{"class":1036},[991,3550,3551],{"class":1001},"(exc, httpx.TimeoutException):\n",[991,3553,3554,3556],{"class":993,"line":1888},[991,3555,1507],{"class":997},[991,3557,2494],{"class":1001},[991,3559,3560,3563,3565,3568],{"class":993,"line":1901},[991,3561,3562],{"class":1029},"            title",[991,3564,1204],{"class":997},[991,3566,3567],{"class":1052},"\"Request Timed Out\"",[991,3569,1554],{"class":1001},[991,3571,3572,3575,3577,3580],{"class":993,"line":1912},[991,3573,3574],{"class":1029},"            message",[991,3576,1204],{"class":997},[991,3578,3579],{"class":1052},"\"The API did not respond in time.\"",[991,3581,1554],{"class":1001},[991,3583,3584,3587,3589,3591,3593],{"class":993,"line":1917},[991,3585,3586],{"class":1029},"            error_code",[991,3588,1204],{"class":997},[991,3590,2446],{"class":1001},[991,3592,3520],{"class":1036},[991,3594,1554],{"class":1001},[991,3596,3597,3600,3602,3604],{"class":993,"line":1922},[991,3598,3599],{"class":1029},"            can_retry",[991,3601,1204],{"class":997},[991,3603,1896],{"class":1036},[991,3605,1554],{"class":1001},[991,3607,3608],{"class":993,"line":1927},[991,3609,3102],{"class":1001},[991,3611,3612],{"class":993,"line":1937},[991,3613,1015],{"emptyLinePlaceholder":1014},[991,3615,3616],{"class":993,"line":1946},[991,3617,3618],{"class":1056},"    # Missing environment variables\n",[991,3620,3621,3623,3625,3628,3631,3633,3636,3639,3642,3645,3648,3651],{"class":993,"line":1955},[991,3622,3259],{"class":997},[991,3624,3262],{"class":1036},[991,3626,3627],{"class":1001},"(exc, (",[991,3629,3630],{"class":1036},"KeyError",[991,3632,1350],{"class":1001},[991,3634,3635],{"class":1036},"RuntimeError",[991,3637,3638],{"class":1001},")) ",[991,3640,3641],{"class":997},"and",[991,3643,3644],{"class":1052}," \"not set\"",[991,3646,3647],{"class":997}," in",[991,3649,3650],{"class":1036}," str",[991,3652,3653],{"class":1001},"(exc).lower():\n",[991,3655,3656,3658],{"class":993,"line":1974},[991,3657,1507],{"class":997},[991,3659,2639],{"class":1001},[991,3661,3662,3664,3666,3668],{"class":993,"line":1991},[991,3663,3562],{"class":1029},[991,3665,1204],{"class":997},[991,3667,2648],{"class":1052},[991,3669,1554],{"class":1001},[991,3671,3672,3674,3676,3678],{"class":993,"line":1996},[991,3673,3574],{"class":1029},[991,3675,1204],{"class":997},[991,3677,1176],{"class":1036},[991,3679,3534],{"class":1001},[991,3681,3682,3684,3686,3688,3690],{"class":993,"line":2003},[991,3683,3586],{"class":1029},[991,3685,1204],{"class":997},[991,3687,2446],{"class":1001},[991,3689,2721],{"class":1036},[991,3691,1554],{"class":1001},[991,3693,3694],{"class":993,"line":2017},[991,3695,3102],{"class":1001},[991,3697,3698],{"class":993,"line":2026},[991,3699,1015],{"emptyLinePlaceholder":1014},[991,3701,3702],{"class":993,"line":2035},[991,3703,3704],{"class":1056},"    # Bad user input\n",[991,3706,3707,3709,3711,3714,3717],{"class":993,"line":2053},[991,3708,3259],{"class":997},[991,3710,3262],{"class":1036},[991,3712,3713],{"class":1001},"(exc, ",[991,3715,3716],{"class":1036},"ValueError",[991,3718,1040],{"class":1001},[991,3720,3721,3723],{"class":993,"line":2062},[991,3722,1507],{"class":997},[991,3724,2387],{"class":1001},[991,3726,3727,3729,3731,3734],{"class":993,"line":2074},[991,3728,3562],{"class":1029},[991,3730,1204],{"class":997},[991,3732,3733],{"class":1052},"\"Invalid Input\"",[991,3735,1554],{"class":1001},[991,3737,3738,3740,3742,3744],{"class":993,"line":2085},[991,3739,3574],{"class":1029},[991,3741,1204],{"class":997},[991,3743,1176],{"class":1036},[991,3745,3534],{"class":1001},[991,3747,3749,3752,3754,3756,3759],{"class":993,"line":3748},53,[991,3750,3751],{"class":1029},"            actions",[991,3753,1204],{"class":997},[991,3755,3338],{"class":1001},[991,3757,3758],{"class":1052},"\"Review your input and try again\"",[991,3760,1867],{"class":1001},[991,3762,3764],{"class":993,"line":3763},54,[991,3765,3102],{"class":1001},[991,3767,3769],{"class":993,"line":3768},55,[991,3770,1015],{"emptyLinePlaceholder":1014},[991,3772,3774],{"class":993,"line":3773},56,[991,3775,3776],{"class":1056},"    # Fallback — unexpected bug\n",[991,3778,3780,3782],{"class":993,"line":3779},57,[991,3781,1621],{"class":997},[991,3783,1624],{"class":1001},[991,3785,3787,3789,3791,3793,3796],{"class":993,"line":3786},58,[991,3788,1629],{"class":1029},[991,3790,1204],{"class":997},[991,3792,1634],{"class":1001},[991,3794,3795],{"class":1036},"BUG",[991,3797,1554],{"class":1001},[991,3799,3801,3803,3805,3808],{"class":993,"line":3800},59,[991,3802,1644],{"class":1029},[991,3804,1204],{"class":997},[991,3806,3807],{"class":1052},"\"Unexpected Error\"",[991,3809,1554],{"class":1001},[991,3811,3813,3815,3817,3819,3822,3824,3826,3828,3830,3832,3834,3836,3838,3840,3842],{"class":993,"line":3812},60,[991,3814,1654],{"class":1029},[991,3816,1204],{"class":997},[991,3818,1329],{"class":997},[991,3820,3821],{"class":1052},"\"An unexpected error occurred",[991,3823,1335],{"class":997},[991,3825,3409],{"class":1052},[991,3827,3412],{"class":997},[991,3829,3415],{"class":1001},[991,3831,2826],{"class":997},[991,3833,3415],{"class":1001},[991,3835,3422],{"class":997},[991,3837,3425],{"class":1052},[991,3839,1344],{"class":997},[991,3841,3430],{"class":1052},[991,3843,1554],{"class":1001},[991,3845,3847,3849,3851,3853],{"class":993,"line":3846},61,[991,3848,1891],{"class":1029},[991,3850,1204],{"class":997},[991,3852,1896],{"class":1036},[991,3854,1554],{"class":1001},[991,3856,3858,3860,3862,3864],{"class":993,"line":3857},62,[991,3859,1690],{"class":1029},[991,3861,1204],{"class":997},[991,3863,2069],{"class":1036},[991,3865,1554],{"class":1001},[991,3867,3869,3871,3873,3875],{"class":993,"line":3868},63,[991,3870,1904],{"class":1029},[991,3872,1204],{"class":997},[991,3874,1176],{"class":1036},[991,3876,3534],{"class":1001},[991,3878,3880],{"class":993,"line":3879},64,[991,3881,1700],{"class":1001},[915,3883,3884],{},"Use it in the workflow's catch-all:",[982,3886,3888],{"className":984,"code":3887,"language":986,"meta":987,"style":987},"@workflow(log_prints=True, name=\"Classified Error Flow\")\nasync def classified_flow(source: str) -> dict:\n    logger = get_logger()\n    try:\n        data = await fetch_data_task(source=source)\n        return {\"status\": \"success\", \"count\": len(data)}\n\n    except WorkflowError as e:\n        # Already structured — use as-is\n        err = e.structured_error\n    except Exception as e:\n        # Classify automatically\n        err = classify_exception(e, context=\"fetching data\")\n\n    logger.error(f\"[{err.error_code}] {err.title}: {err.message}\")\n    return {\n        \"status\": \"error\",\n        \"error_type\": err.error_type.value,\n        \"error_code\": err.error_code,\n        \"title\": err.title,\n        \"message\": err.message,\n        \"actions\": err.actions,\n        \"can_retry\": err.can_retry,\n    }\n",[944,3889,3890,3913,3934,3942,3948,3969,3994,3998,4008,4013,4021,4033,4038,4057,4061,4096,4102,4113,4120,4127,4134,4141,4148,4155],{"__ignoreMap":987},[991,3891,3892,3894,3896,3898,3900,3902,3904,3906,3908,3911],{"class":993,"line":994},[991,3893,2885],{"class":1152},[991,3895,1033],{"class":1001},[991,3897,2890],{"class":1029},[991,3899,1204],{"class":997},[991,3901,1896],{"class":1036},[991,3903,1350],{"class":1001},[991,3905,2899],{"class":1029},[991,3907,1204],{"class":997},[991,3909,3910],{"class":1052},"\"Classified Error Flow\"",[991,3912,2907],{"class":1001},[991,3914,3915,3917,3919,3922,3925,3927,3930,3932],{"class":993,"line":1011},[991,3916,2912],{"class":997},[991,3918,2915],{"class":997},[991,3920,3921],{"class":1152}," classified_flow",[991,3923,3924],{"class":1001},"(source: ",[991,3926,1176],{"class":1036},[991,3928,3929],{"class":1001},") -> ",[991,3931,2929],{"class":1036},[991,3933,1163],{"class":1001},[991,3935,3936,3938,3940],{"class":993,"line":1018},[991,3937,2936],{"class":1001},[991,3939,1204],{"class":997},[991,3941,2941],{"class":1001},[991,3943,3944,3946],{"class":993,"line":1023},[991,3945,2946],{"class":997},[991,3947,1163],{"class":1001},[991,3949,3950,3953,3955,3958,3961,3964,3966],{"class":993,"line":1043},[991,3951,3952],{"class":1001},"        data ",[991,3954,1204],{"class":997},[991,3956,3957],{"class":997}," await",[991,3959,3960],{"class":1001}," fetch_data_task(",[991,3962,3963],{"class":1029},"source",[991,3965,1204],{"class":997},[991,3967,3968],{"class":1001},"source)\n",[991,3970,3971,3973,3975,3977,3979,3981,3983,3986,3988,3991],{"class":993,"line":1060},[991,3972,1507],{"class":997},[991,3974,2979],{"class":1001},[991,3976,2982],{"class":1052},[991,3978,2985],{"class":1001},[991,3980,2988],{"class":1052},[991,3982,1350],{"class":1001},[991,3984,3985],{"class":1052},"\"count\"",[991,3987,2985],{"class":1001},[991,3989,3990],{"class":1036},"len",[991,3992,3993],{"class":1001},"(data)}\n",[991,3995,3996],{"class":993,"line":1074},[991,3997,1015],{"emptyLinePlaceholder":1014},[991,3999,4000,4002,4004,4006],{"class":993,"line":1088},[991,4001,3000],{"class":997},[991,4003,3003],{"class":1001},[991,4005,3006],{"class":997},[991,4007,3009],{"class":1001},[991,4009,4010],{"class":993,"line":1182},[991,4011,4012],{"class":1056},"        # Already structured — use as-is\n",[991,4014,4015,4017,4019],{"class":993,"line":1193},[991,4016,3014],{"class":1001},[991,4018,1204],{"class":997},[991,4020,3019],{"class":1001},[991,4022,4023,4025,4028,4031],{"class":993,"line":1224},[991,4024,3000],{"class":997},[991,4026,4027],{"class":1036}," Exception",[991,4029,4030],{"class":997}," as",[991,4032,3009],{"class":1001},[991,4034,4035],{"class":993,"line":1242},[991,4036,4037],{"class":1056},"        # Classify automatically\n",[991,4039,4040,4042,4044,4047,4050,4052,4055],{"class":993,"line":1259},[991,4041,3014],{"class":1001},[991,4043,1204],{"class":997},[991,4045,4046],{"class":1001}," classify_exception(e, ",[991,4048,4049],{"class":1029},"context",[991,4051,1204],{"class":997},[991,4053,4054],{"class":1052},"\"fetching data\"",[991,4056,2907],{"class":1001},[991,4058,4059],{"class":993,"line":1274},[991,4060,1015],{"emptyLinePlaceholder":1014},[991,4062,4063,4066,4068,4070,4072,4074,4076,4078,4080,4082,4084,4086,4088,4090,4092,4094],{"class":993,"line":1291},[991,4064,4065],{"class":1001},"    logger.error(",[991,4067,1329],{"class":997},[991,4069,3036],{"class":1052},[991,4071,1335],{"class":997},[991,4073,3041],{"class":1001},[991,4075,1344],{"class":997},[991,4077,1201],{"class":1052},[991,4079,1335],{"class":997},[991,4081,3059],{"class":1001},[991,4083,1344],{"class":997},[991,4085,2985],{"class":1052},[991,4087,1335],{"class":997},[991,4089,3077],{"class":1001},[991,4091,1344],{"class":997},[991,4093,1417],{"class":1052},[991,4095,2907],{"class":1001},[991,4097,4098,4100],{"class":993,"line":1296},[991,4099,1621],{"class":997},[991,4101,3114],{"class":1001},[991,4103,4104,4107,4109,4111],{"class":993,"line":1312},[991,4105,4106],{"class":1052},"        \"status\"",[991,4108,2985],{"class":1001},[991,4110,3124],{"class":1052},[991,4112,1554],{"class":1001},[991,4114,4115,4118],{"class":993,"line":1318},[991,4116,4117],{"class":1052},"        \"error_type\"",[991,4119,3134],{"class":1001},[991,4121,4122,4125],{"class":993,"line":1363},[991,4123,4124],{"class":1052},"        \"error_code\"",[991,4126,3142],{"class":1001},[991,4128,4129,4132],{"class":993,"line":1375},[991,4130,4131],{"class":1052},"        \"title\"",[991,4133,3150],{"class":1001},[991,4135,4136,4139],{"class":993,"line":1396},[991,4137,4138],{"class":1052},"        \"message\"",[991,4140,3158],{"class":1001},[991,4142,4143,4146],{"class":993,"line":1434},[991,4144,4145],{"class":1052},"        \"actions\"",[991,4147,3166],{"class":1001},[991,4149,4150,4153],{"class":993,"line":1444},[991,4151,4152],{"class":1052},"        \"can_retry\"",[991,4154,3174],{"class":1001},[991,4156,4157],{"class":993,"line":1476},[991,4158,4159],{"class":1001},"    }\n",[936,4161,4163],{"id":4162},"what-users-see-vs-what-developers-see","What users see vs. what developers see",[915,4165,4166,4167,4169],{},"The same ",[944,4168,1109],{}," produces different outputs depending on context:",[915,4171,4172,4175],{},[921,4173,4174],{},"User-facing message"," (e.g. displayed in a UI or returned to a caller):",[982,4177,4182],{"className":4178,"code":4180,"language":4181},[4179],"language-text","**No Samples Selected**\n\nAt least one sample must be selected to start the workflow.\n\n**What you can do:**\n- Select one or more samples from the list\n- Verify the samples exist in the system\n\nError code: `WF_100`\n","text",[944,4183,4180],{"__ignoreMap":987},[915,4185,4186,4189],{},[921,4187,4188],{},"Developer log"," (run logs):",[982,4191,4194],{"className":4192,"code":4193,"language":4181},[4179],"[WF_100] user_error: No Samples Selected\nMessage: At least one sample must be selected to start the workflow.\nCan retry: True\n",[944,4195,4193],{"__ignoreMap":987},[915,4197,4198,4199,4202],{},"Keep ",[944,4200,4201],{},"technical_details"," (stack traces, raw API responses) out of user-facing messages. Pass them only to logs or an internal support system.",[4204,4205,4206],"style",{},"html pre.shiki code .sxkbv, html code.shiki .sxkbv{--shiki-light:#A0111F;--shiki-default:#A0111F;--shiki-dark:#FF7B72}html pre.shiki code .sc-9e, html code.shiki .sc-9e{--shiki-light:#0E1116;--shiki-default:#0E1116;--shiki-dark:#E6EDF3}html pre.shiki code .sNqAu, html code.shiki .sNqAu{--shiki-light:#702C00;--shiki-default:#702C00;--shiki-dark:#FFA657}html pre.shiki code .sOiAX, html code.shiki .sOiAX{--shiki-light:#023B95;--shiki-default:#023B95;--shiki-dark:#79C0FF}html pre.shiki code .sCx38, html code.shiki .sCx38{--shiki-light:#032563;--shiki-default:#032563;--shiki-dark:#A5D6FF}html pre.shiki code .sIsDC, html code.shiki .sIsDC{--shiki-light:#66707B;--shiki-default:#66707B;--shiki-dark:#8B949E}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s4qFZ, html code.shiki .s4qFZ{--shiki-light:#622CBC;--shiki-default:#622CBC;--shiki-dark:#D2A8FF}",{"title":987,"searchDepth":994,"depth":1011,"links":4208},[4209,4210,4211,4212,4213,4214,4215,4216,4217],{"id":938,"depth":1011,"text":939},{"id":976,"depth":1011,"text":977},{"id":1102,"depth":1011,"text":1103},{"id":1521,"depth":1011,"text":1522},{"id":2090,"depth":1011,"text":2091},{"id":2361,"depth":1011,"text":2362},{"id":2730,"depth":1011,"text":2731},{"id":3182,"depth":1011,"text":3183},{"id":4162,"depth":1011,"text":4163},"Build a structured error taxonomy with typed error codes, user-facing messages, and automatic exception classification.","md",{},"\u002Fhow-to\u002Fautomate\u002Fadvanced-error-handling",{"title":156,"description":4218},"yfyVcIsK2TiNBPiyK0MFqRAXSONLxrhcTzLrfxQe9GQ",[4225,4227],{"title":152,"description":4226,"path":153},"Clean up hardware state, retry transient failures, and resume after operator intervention.",{"title":160,"description":4228,"path":161},"Record material and labware movement from a Python workflow.",1791294170911]