[{"data":1,"prerenderedAt":771},["ShallowReactive",2],{"navigation":3,"\u002Freference\u002Fdefinition":194,"\u002Freference\u002Fdefinition-surround":766},[4,18,31,64,81,102,111,132,149],{"title":5,"path":6,"stem":7,"children":8,"page":17},"Getting started","\u002Fgetting-started","1.getting-started",[9,13],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Run your first workflow","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart",false,{"title":19,"path":20,"stem":21,"children":22,"page":17},"Core concepts","\u002Fconcepts","2.concepts",[23,27],{"title":24,"path":25,"stem":26},"The platform model","\u002Fconcepts\u002Fplatform","2.concepts\u002F1.platform",{"title":28,"path":29,"stem":30},"Architecture and boundaries","\u002Fconcepts\u002Farchitecture","2.concepts\u002F2.architecture",{"title":32,"path":33,"stem":34,"children":35,"page":17},"Installation","\u002Finstallation","3.installation",[36,40,44,48,52,56,60],{"title":37,"path":38,"stem":39},"Overview and requirements","\u002Finstallation\u002Foverview","3.installation\u002F1.overview",{"title":41,"path":42,"stem":43},"Local evaluation","\u002Finstallation\u002Flocal-evaluation","3.installation\u002F2.local-evaluation",{"title":45,"path":46,"stem":47},"Install the server","\u002Finstallation\u002Fserver","3.installation\u002F3.server",{"title":49,"path":50,"stem":51},"Install a runner","\u002Finstallation\u002Frunner","3.installation\u002F4.runner",{"title":53,"path":54,"stem":55},"Verify the installation","\u002Finstallation\u002Fverification","3.installation\u002F5.verification",{"title":57,"path":58,"stem":59},"Upgrade the platform","\u002Finstallation\u002Fupgrades","3.installation\u002F6.upgrades",{"title":61,"path":62,"stem":63},"Guided installer","\u002Finstallation\u002Finstaller","3.installation\u002F7.installer",{"title":65,"path":66,"stem":67,"children":68,"page":17},"Build workflows","\u002Fworkflows","4.workflows",[69,73,77],{"title":70,"path":71,"stem":72},"Build a Definition","\u002Fworkflows\u002Fdefinitions","4.workflows\u002F0.definitions",{"title":74,"path":75,"stem":76},"Deploy and run workflows","\u002Fworkflows\u002Fruns","4.workflows\u002F1.runs",{"title":78,"path":79,"stem":80},"Inputs, context, and secrets","\u002Fworkflows\u002Finputs-and-secrets","4.workflows\u002F2.inputs-and-secrets",{"title":82,"path":83,"stem":84,"children":85,"page":17},"Run and recover","\u002Foperations","5.operations",[86,90,94,98],{"title":87,"path":88,"stem":89},"Monitor Runs","\u002Foperations\u002Fmonitoring","5.operations\u002F1.monitoring",{"title":91,"path":92,"stem":93},"Approve prepared steps","\u002Foperations\u002Fapprovals","5.operations\u002F2.approvals",{"title":95,"path":96,"stem":97},"Recover or cancel execution","\u002Foperations\u002Frecovery","5.operations\u002F3.recovery",{"title":99,"path":100,"stem":101},"Troubleshooting","\u002Foperations\u002Ftroubleshooting","5.operations\u002F4.troubleshooting",{"title":103,"path":104,"stem":105,"children":106,"page":17},"Action catalog","\u002Fcatalog","6.catalog",[107],{"title":108,"path":109,"stem":110},"Find and use Actions","\u002Fcatalog\u002Foverview","6.catalog\u002F1.overview",{"title":112,"path":113,"stem":114,"children":115,"page":17},"Administration","\u002Fadministration","7.administration",[116,120,124,128],{"title":117,"path":118,"stem":119},"Registries and Environments","\u002Fadministration\u002Fenvironments","7.administration\u002F2.environments",{"title":121,"path":122,"stem":123},"Manage runners","\u002Fadministration\u002Frunners","7.administration\u002F3.runners",{"title":125,"path":126,"stem":127},"Access and approval policies","\u002Fadministration\u002Faccess","7.administration\u002F4.access",{"title":129,"path":130,"stem":131},"Backups and upgrades","\u002Fadministration\u002Fmaintenance","7.administration\u002F5.maintenance",{"title":133,"path":134,"stem":135,"children":136,"page":17},"Develop Actions","\u002Factions","8.actions",[137,141,145],{"title":138,"path":139,"stem":140},"Build your first Action","\u002Factions\u002Fquickstart","8.actions\u002F1.quickstart",{"title":142,"path":143,"stem":144},"Local development","\u002Factions\u002Flocal-development","8.actions\u002F2.local-development",{"title":146,"path":147,"stem":148},"Publish an Action","\u002Factions\u002Fpublishing","8.actions\u002F3.publishing",{"title":150,"path":151,"stem":152,"children":153,"page":17},"Reference","\u002Freference","9.reference",[154,158,162,166,170,174,178,182,186,190],{"title":155,"path":156,"stem":157},"Operator CLI","\u002Freference\u002Foperator-cli","9.reference\u002F1.operator-cli",{"title":159,"path":160,"stem":161},"Installer CLI","\u002Freference\u002Finstaller-cli","9.reference\u002F10.installer-cli",{"title":163,"path":164,"stem":165},"Definition syntax","\u002Freference\u002Fdefinition","9.reference\u002F2.definition",{"title":167,"path":168,"stem":169},"CLI configuration","\u002Freference\u002Fconfiguration","9.reference\u002F3.configuration",{"title":171,"path":172,"stem":173},"API integration","\u002Freference\u002Fapi","9.reference\u002F4.api",{"title":175,"path":176,"stem":177},"Action CLI","\u002Freference\u002Faction-cli","9.reference\u002F5.action-cli",{"title":179,"path":180,"stem":181},"Action SDK","\u002Freference\u002Fsdk","9.reference\u002F6.sdk",{"title":183,"path":184,"stem":185},"Contracts and compatibility","\u002Freference\u002Fcontracts","9.reference\u002F7.contracts",{"title":187,"path":188,"stem":189},"Server configuration","\u002Freference\u002Fserver-configuration","9.reference\u002F8.server-configuration",{"title":191,"path":192,"stem":193},"Runner configuration","\u002Freference\u002Frunner-configuration","9.reference\u002F9.runner-configuration",{"id":195,"title":163,"body":196,"description":760,"extension":761,"meta":762,"navigation":763,"path":164,"seo":764,"stem":165,"__hash__":765},"docs\u002F9.reference\u002F2.definition.md",{"type":197,"value":198,"toc":753},"minimark",[199,207,212,298,301,305,345,462,469,473,536,544,588,604,608,678,685,695,698,702,743,749],[200,201,202,203,206],"p",{},"A Definition is one YAML object describing ordered Action steps. For a walkthrough, see ",[204,205,70],"a",{"href":71},".",[208,209,211],"h2",{"id":210},"top-level-fields","Top-level fields",[213,214,215,228],"table",{},[216,217,218],"thead",{},[219,220,221,225],"tr",{},[222,223,224],"th",{},"Field",[222,226,227],{},"Requirement",[229,230,231,246,258,268,278,288],"tbody",{},[219,232,233,240],{},[234,235,236],"td",{},[237,238,239],"code",{},"apiVersion",[234,241,242,243],{},"Required; ",[237,244,245],{},"pyplines\u002Fv1",[219,247,248,253],{},[234,249,250],{},[237,251,252],{},"kind",[234,254,242,255],{},[237,256,257],{},"Definition",[219,259,260,265],{},[234,261,262],{},[237,263,264],{},"name",[234,266,267],{},"Required lowercase alphanumeric name with hyphen-separated segments; maximum 64 characters",[219,269,270,275],{},[234,271,272],{},[237,273,274],{},"description",[234,276,277],{},"Optional descriptive string",[219,279,280,285],{},[234,281,282],{},[237,283,284],{},"inputs",[234,286,287],{},"Optional map of named input declarations",[219,289,290,295],{},[234,291,292],{},[237,293,294],{},"steps",[234,296,297],{},"Required list of 1–256 ordered steps",[200,299,300],{},"Names are not silently normalized. Unknown fields, YAML anchors\u002Faliases, multiple documents, and documents larger than 1 MiB are rejected. Definitions do not contain approval state, runtime identities, execution status, or server database IDs.",[208,302,304],{"id":303},"input-declarations","Input declarations",[200,306,307,308,311,312,315,316,315,319,315,322,315,325,328,329,332,333,315,336,315,339,342,343,206],{},"Each input declares ",[237,309,310],{},"type",": ",[237,313,314],{},"string",", ",[237,317,318],{},"boolean",[237,320,321],{},"integer",[237,323,324],{},"number",[237,326,327],{},"object",", or ",[237,330,331],{},"array",". Optional fields are ",[237,334,335],{},"required",[237,337,338],{},"default",[237,340,341],{},"enum",", and ",[237,344,274],{},[346,347,353],"pre",{"className":348,"code":349,"filename":350,"language":351,"meta":352,"style":352},"language-yaml shiki shiki-themes pyplines-light pyplines-light pyplines-dark","inputs:\n  service:\n    type: string\n    required: true\n    description: Service to inspect\n  mode:\n    type: string\n    default: inspect\n    enum: [inspect, repair]\n","Input declaration fragment","yaml","",[237,354,355,367,375,388,400,411,419,428,439],{"__ignoreMap":352},[356,357,360,363],"span",{"class":358,"line":359},"line",1,[356,361,284],{"class":362},"smnRP",[356,364,366],{"class":365},"sgMYo",":\n",[356,368,370,373],{"class":358,"line":369},2,[356,371,372],{"class":362},"  service",[356,374,366],{"class":365},[356,376,378,381,384],{"class":358,"line":377},3,[356,379,380],{"class":362},"    type",[356,382,383],{"class":365},":",[356,385,387],{"class":386},"sfDcV"," string\n",[356,389,391,394,396],{"class":358,"line":390},4,[356,392,393],{"class":362},"    required",[356,395,383],{"class":365},[356,397,399],{"class":398},"sFGQw"," true\n",[356,401,403,406,408],{"class":358,"line":402},5,[356,404,405],{"class":362},"    description",[356,407,383],{"class":365},[356,409,410],{"class":386}," Service to inspect\n",[356,412,414,417],{"class":358,"line":413},6,[356,415,416],{"class":362},"  mode",[356,418,366],{"class":365},[356,420,422,424,426],{"class":358,"line":421},7,[356,423,380],{"class":362},[356,425,383],{"class":365},[356,427,387],{"class":386},[356,429,431,434,436],{"class":358,"line":430},8,[356,432,433],{"class":362},"    default",[356,435,383],{"class":365},[356,437,438],{"class":386}," inspect\n",[356,440,442,445,447,450,453,456,459],{"class":358,"line":441},9,[356,443,444],{"class":362},"    enum",[356,446,383],{"class":365},[356,448,449],{"class":365}," [",[356,451,452],{"class":386},"inspect",[356,454,455],{"class":365},",",[356,457,458],{"class":386}," repair",[356,460,461],{"class":365},"]\n",[200,463,464,465,468],{},"Input and secret identifiers match ",[237,466,467],{},"[A-Za-z_][A-Za-z0-9_-]{0,63}",". The declaration above is a fragment; include it in a complete Definition before validation.",[208,470,472],{"id":471},"step-fields","Step fields",[213,474,475,483],{},[216,476,477],{},[219,478,479,481],{},[222,480,224],{},[222,482,227],{},[229,484,485,494,502,516,526],{},[219,486,487,491],{},[234,488,489],{},[237,490,264],{},[234,492,493],{},"Required unique lowercase hyphenated name, maximum 64 characters",[219,495,496,500],{},[234,497,498],{},[237,499,274],{},[234,501,277],{},[219,503,504,509],{},[234,505,506],{},[237,507,508],{},"uses",[234,510,511,512,515],{},"Required ",[237,513,514],{},"action-name@version","; registry and prefix come from the Environment",[219,517,518,523],{},[234,519,520],{},[237,521,522],{},"when",[234,524,525],{},"Optional whole expression producing a boolean",[219,527,528,533],{},[234,529,530],{},[237,531,532],{},"with",[234,534,535],{},"Input values matching the Action's captured contract",[200,537,538,539,541,542,383],{},"The step's ",[237,540,264],{}," is its stable reference in expressions, Run responses, logs, and approval decisions. Put human-readable explanatory text in ",[237,543,274],{},[346,545,548],{"className":348,"code":546,"filename":547,"language":351,"meta":352,"style":352},"steps:\n  - name: inspect-service\n    description: Check the service before deciding whether to restart it\n    uses: inspect-service@2026.10.1\n","Step fragment",[237,549,550,556,569,578],{"__ignoreMap":352},[356,551,552,554],{"class":358,"line":359},[356,553,294],{"class":362},[356,555,366],{"class":365},[356,557,558,561,564,566],{"class":358,"line":369},[356,559,560],{"class":365},"  -",[356,562,563],{"class":362}," name",[356,565,383],{"class":365},[356,567,568],{"class":386}," inspect-service\n",[356,570,571,573,575],{"class":358,"line":377},[356,572,405],{"class":362},[356,574,383],{"class":365},[356,576,577],{"class":386}," Check the service before deciding whether to restart it\n",[356,579,580,583,585],{"class":358,"line":390},[356,581,582],{"class":362},"    uses",[356,584,383],{"class":365},[356,586,587],{"class":386}," inspect-service@2026.10.1\n",[200,589,590,591,593,594,596,597,600,601,603],{},"The ",[237,592,245],{}," contract requires ",[237,595,264],{},"; the former ",[237,598,599],{},"id"," field is rejected, including when supplied alongside ",[237,602,264],{},". Update existing Definitions and use matching platform and tooling releases. Previously persisted Definitions and Runs are not migrated by this contract update.",[208,605,607],{"id":606},"references-and-expressions","References and expressions",[213,609,610,619],{},[216,611,612],{},[219,613,614,616],{},[222,615,150],{},[222,617,618],{},"Resolves to",[229,620,621,631,641,651,661],{},[219,622,623,628],{},[234,624,625],{},[237,626,627],{},"inputs.NAME",[234,629,630],{},"A supplied or defaulted Run input",[219,632,633,638],{},[234,634,635],{},[237,636,637],{},"context.NAME",[234,639,640],{},"Public Environment context",[219,642,643,648],{},[234,644,645],{},[237,646,647],{},"secrets.NAME",[234,649,650],{},"A versioned Environment secret",[219,652,653,658],{},[234,654,655],{},[237,656,657],{},"steps.NAME.outputs.NAME",[234,659,660],{},"A named output from an earlier step",[219,662,663,668],{},[234,664,665],{},[237,666,667],{},"steps.NAME.status",[234,669,670,671,674,675],{},"An earlier step's state, including ",[237,672,673],{},"succeeded"," or ",[237,676,677],{},"skipped",[200,679,680,681,684],{},"Wrap expressions in ",[237,682,683],{},"${{ ... }}",". A whole expression preserves JSON types. Embedded interpolation accepts only scalar values. Conditions support comparisons and boolean operators, not functions, loops, or splats.",[200,686,687,688,691,692,694],{},"Only earlier steps may be referenced. A skipped step has no outputs; missing outputs block preparation rather than resolving to ",[237,689,690],{},"null",". A false ",[237,693,522],{}," is evaluated before resolving the skipped step's inputs.",[200,696,697],{},"Secret references must occupy an entire input value. They cannot appear in conditions or embedded interpolation. Sensitive schemas and secret-tainted output bindings make the receiving step private.",[208,699,701],{"id":700},"validation-stages","Validation stages",[213,703,704,714],{},[216,705,706],{},[219,707,708,711],{},[222,709,710],{},"Stage",[222,712,713],{},"What is checked",[229,715,716,727,735],{},[219,717,718,724],{},[234,719,720,721],{},"Local ",[237,722,723],{},"pyplines validate",[234,725,726],{},"Document structure",[219,728,729,732],{},[234,730,731],{},"Deployment",[234,733,734],{},"Authoritative expressions, Action availability, contracts, and pinned images",[219,736,737,740],{},[234,738,739],{},"Step preparation",[234,741,742],{},"Resolved runtime values, context, secrets, and policy requirements",[200,744,745,746,206],{},"An accepted Definition cannot guarantee that an external service will accept credentials or that an Action's side effects are reversible. Those behaviors belong in the ",[204,747,748],{"href":109},"Action's operational contract",[750,751,752],"style",{},"html pre.shiki code .smnRP, html code.shiki .smnRP{--shiki-light:#243247;--shiki-default:#243247;--shiki-dark:#DCE6F0}html pre.shiki code .sgMYo, html code.shiki .sgMYo{--shiki-light:#54657A;--shiki-default:#54657A;--shiki-dark:#A9B8CA}html pre.shiki code .sfDcV, html code.shiki .sfDcV{--shiki-light:#34694B;--shiki-default:#34694B;--shiki-dark:#9BC9AD}html pre.shiki code .sFGQw, html code.shiki .sFGQw{--shiki-light:#765093;--shiki-default:#765093;--shiki-dark:#CFB1E8}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);}",{"title":352,"searchDepth":369,"depth":369,"links":754},[755,756,757,758,759],{"id":210,"depth":369,"text":211},{"id":303,"depth":369,"text":304},{"id":471,"depth":369,"text":472},{"id":606,"depth":369,"text":607},{"id":700,"depth":369,"text":701},"Fields, expressions, and limits for the pyplines\u002Fv1 contract.","md",{},true,{"title":163,"description":760},"TUzJ76pXygNibxaIyByIXlsrLFO5kyMTSBr4SKAI7Ac",[767,769],{"title":159,"path":160,"stem":161,"description":768,"children":-1},"YAML-driven installation, inspection, diagnosis, and cleanup of named Pyplines targets.",{"title":167,"path":168,"stem":169,"description":770,"children":-1},"Server selection, TLS trust, sessions, and noninteractive clients.",1792213697746]