From ae218952052e1d7618a7d8bf7fb8eba089aeede6 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 3 May 2026 04:35:59 +0000 Subject: [PATCH] docs(compliance): document task_completion. prefix for context_outputs.path Adds missing runner-behavior bullet to storyboard-schema.yaml explaining the task_completion. path prefix introduced in adcp-client v6.7 (adcp-client#1426). Documents: polling trigger conditions (submitted/working only), result-payload resolution on completed, and capture_path_not_resolvable grading on all other statuses (failed, canceled, rejected, auth-required, input-required, unknown). YAML comments only; no wire-format change. Refs #3950 https://claude.ai/code/session_01FM9345KAdknRskpf1cMCFn --- .../docs-task-completion-prefix-context-outputs.md | 10 ++++++++++ .../compliance/source/universal/storyboard-schema.yaml | 10 ++++++++++ 2 files changed, 20 insertions(+) create mode 100644 .changeset/docs-task-completion-prefix-context-outputs.md diff --git a/.changeset/docs-task-completion-prefix-context-outputs.md b/.changeset/docs-task-completion-prefix-context-outputs.md new file mode 100644 index 0000000000..462fb4ae94 --- /dev/null +++ b/.changeset/docs-task-completion-prefix-context-outputs.md @@ -0,0 +1,10 @@ +--- +--- + +docs(compliance): document task_completion. prefix for context_outputs.path + +Adds a missing bullet to the storyboard-schema.yaml context_outputs runner-behavior +block explaining the task_completion. path prefix introduced in adcp-client v6.7 +(adcp-client#1426). Documents the polling behavior, the result payload field, and +grading on non-success terminal statuses (failed/canceled/rejected → +capture_path_not_resolvable). No wire format changes; YAML comments only. diff --git a/static/compliance/source/universal/storyboard-schema.yaml b/static/compliance/source/universal/storyboard-schema.yaml index 9880936f6a..ad0198f32f 100644 --- a/static/compliance/source/universal/storyboard-schema.yaml +++ b/static/compliance/source/universal/storyboard-schema.yaml @@ -416,6 +416,16 @@ # grade as skipped with reason: prerequisite_failed citing this step. # See runner-output-contract.yaml > validation_result for the output shape. # - The accumulator is storyboard-run-scoped; values do not leak across runs. +# - Special path prefix `task_completion.`: when the immediate +# response is a non-terminal task envelope (status submitted/working, +# with a task_id), the runner polls `tasks/get` until the task exits +# {submitted, working}. On `completed`: resolves against the +# `result` payload; a missing path grades this step as +# capture_path_not_resolvable. On any other status (failed, canceled, +# rejected, auth-required, input-required, unknown): `result` is absent; +# the capture grades as capture_path_not_resolvable on this step; +# downstream $context. references grade as prerequisite_failed +# citing this step. See adcp-client#1426 for the implementation. # # context_inputs: array of ContextInput objects (optional — inject captured # context values into the request at a specific path AFTER the per-task