@usearazzo/runner 1.0.1-alpha.21 → 1.0.1-alpha.22

package/types/runner.d.ts

@@ -369,11 +369,12 @@ export declare interface ArazzoWorkflowLocator {
  * The `type` declared on a source description is not trusted (it may be
  * absent or wrong); a source is classified by what it actually parses to,
  * the same convention the OpenAPI operation locator follows. Source
- * documents are acquired from the registry on demand. Whether the resolved
- * document *defines* the workflow is deliberately left to the caller, which
- * owns the timing of that check (eager for a `dependsOn` list validated
- * before any prerequisite runs, lazy for a sub-workflow step resolved per
- * attempt).
+ * documents are acquired from the registry on demand. A reference to a
+ * workflow the resolved document does not define is rejected here, so every
+ * returned locator names an existing workflow; a caller controls when that
+ * check happens by when it normalizes (eagerly for a `dependsOn` list
+ * validated before any prerequisite runs, lazily for a sub-workflow step
+ * resolved on its first attempt).
  * @public
  */
 export declare class ArazzoWorkflowLocatorNormalizer extends SourceDescriptionsLocatorNormalizer {
@@ -382,7 +383,9 @@ export declare class ArazzoWorkflowLocatorNormalizer extends SourceDescriptionsL
      * Resolves a reference — a plain workflowId or a
      * `$sourceDescriptions.{name}.{workflowId}` expression, as written — to the
      * canonical locator: the Arazzo document that owns the target workflow,
-     * and the bare id within it.
+     * and the bare id within it. Rejects a workflow that document does not
+     * define as `workflow-not-found`, attributed to the referencing context
+     * like every other error raised here.
      */
     normalize(reference: string, document: ArazzoDocument, context: WorkflowReferenceContext): Promise<ArazzoWorkflowLocator>;
 }