Skip to content

docs(orchestration): grammar README section + SDK examples (Workflow Phase 5e)#58

Merged
ZhiXiao-Lin merged 1 commit into
mainfrom
docs/orchestration-grammar
May 29, 2026
Merged

docs(orchestration): grammar README section + SDK examples (Workflow Phase 5e)#58
ZhiXiao-Lin merged 1 commit into
mainfrom
docs/orchestration-grammar

Conversation

@ZhiXiao-Lin
Copy link
Copy Markdown
Contributor

Final slice of Phase 5 — docs + examples, completing "full grammar, both SDKs".

  • README: a "Programmable Orchestration" section with side-by-side Python/Node snippets for parallel / pipeline / parallelResumable, the step-spec shape, schema'd steps, the no-inter-stage-barrier pipeline semantics, and the pipeline-stage no-throw constraint.
  • Examples (load .a3s/config.acl at runtime; syntax-checked via py_compile / node --check):
    • sdk/python/examples/orchestration_workflow.py
    • sdk/node/examples/orchestration/parallel-pipeline.mjs
      These double as the SDK-level validation reference for the callback bridges (running them needs the built native addon).

Closes the Workflow integration: core Phases 1–4 (#51#54) + SDK Phases 5a/5b/5c/5d (#55#57) + this.

Documents the programmable orchestration grammar (parallel / pipeline /
resumable) for both SDKs with side-by-side Python/Node snippets, including the
step-spec shape, schema'd steps, the no-inter-stage-barrier pipeline semantics,
and the pipeline-stage no-throw constraint.

Adds runnable examples:
- sdk/python/examples/orchestration_workflow.py
- sdk/node/examples/orchestration/parallel-pipeline.mjs
Both load .a3s/config.acl at runtime and demonstrate parallel + pipeline;
syntax-checked (py_compile / node --check). Running them requires the built
native addon (maturin / napi) — they double as the SDK-level validation
reference for the callback bridges.

Completes Workflow Phase 5 (full grammar, both SDKs).
@ZhiXiao-Lin ZhiXiao-Lin merged commit 9af8a3b into main May 29, 2026
1 check passed
@ZhiXiao-Lin ZhiXiao-Lin deleted the docs/orchestration-grammar branch May 29, 2026 09:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants