diff --git a/labs/22-yield/distribution/release-notes/2026-08-07-public-developer-preview.md b/labs/22-yield/distribution/release-notes/2026-08-07-public-developer-preview.md new file mode 100644 index 00000000..d84a5403 --- /dev/null +++ b/labs/22-yield/distribution/release-notes/2026-08-07-public-developer-preview.md @@ -0,0 +1,7 @@ +# Public developer preview documentation + +- Define Yield as an open-source execution runtime for programmable Agent Skill + workflows. +- Document the boundary between Agent Plugins packaging and Yield workflow + execution without claiming unverified conformance. +- Point every public installation path at the release produced by this change. diff --git a/labs/22-yield/public-readme/README.md b/labs/22-yield/public-readme/README.md index 6332cc1c..27249a79 100644 --- a/labs/22-yield/public-readme/README.md +++ b/labs/22-yield/public-readme/README.md @@ -1,5 +1,7 @@ # Yield +Yield is an open-source execution runtime for programmable Agent Skill workflows. + **Write one skill workflow. Run it from your coding agents.** Skill workflows are portable, executable processes that combine agent skills @@ -30,21 +32,21 @@ repository. Generated adapters never use a global `yskill` from `PATH`. ```bash # TypeScript -npm install --save-exact @operatorstack/yield@0.1.26 --registry=https://get.operatorstack.systems/npm/ +npm install --save-exact @operatorstack/yield@0.1.29 --registry=https://get.operatorstack.systems/npm/ npm exec -- yskill --version # Python, after creating and activating .venv -python -m pip install yieldskill==0.1.26 --index-url https://get.operatorstack.systems/pip/simple/ +python -m pip install yieldskill==0.1.29 --index-url https://get.operatorstack.systems/pip/simple/ python -m yieldskill --version # Go, from the repository root mkdir -p .yield/bin GOBIN="$PWD/.yield/bin" GOPROXY=https://get.operatorstack.systems/go,direct \ - go install github.com/operatorstack/yield/cmd/yskill@v0.1.26 + go install github.com/operatorstack/yield/cmd/yskill@v0.1.29 .yield/bin/yskill --version # Rust, from the repository root -cargo install yieldskill@0.1.26 --root .yield \ +cargo install yieldskill@0.1.29 --root .yield \ --index sparse+https://get.operatorstack.systems/cargo/index/ --locked .yield/bin/yskill --version ``` @@ -145,6 +147,8 @@ the documentation for your job: - [examples](docs/examples.md) — working programs in all four languages; - [coding-agent setup](docs/agent-setup.md) — register one skill workflow with the agents used by the project; +- [Agent Plugins and Yield](docs/agent-plugins.md) — where portable packaging ends + and workflow execution begins; - [test workflow effects](docs/testing-fixtures.md) — deterministic fixture setup, response effects, standard-input JSON, and cleanup; - [evaluations](evals/README.md) — first-party workflow conformance and runtime diff --git a/labs/22-yield/yield/docs/README.md b/labs/22-yield/yield/docs/README.md index 31b54bce..5cc75eb4 100644 --- a/labs/22-yield/yield/docs/README.md +++ b/labs/22-yield/yield/docs/README.md @@ -42,16 +42,17 @@ and start it. | approval points | writing explanations | | evidence required to finish | interpreting evidence | -This is not a new agent runtime. A thin `SKILL.md` starts the program, the -program emits one typed operation, and the coding agent performs that operation -through its normal interface. Yield records the response and resumes from the -next unanswered operation. +This is not a new agent loop or a hosted agent runtime. A thin `SKILL.md` starts +the program, the program emits one typed operation, and the coding agent +performs that operation through its normal interface. Yield records the +response and resumes from the next unanswered operation. ## Reference - [Skill workflow concepts](skill-workflows.md) - [CLI commands](reference/cli.md) - [Coding-agent registration](agent-setup.md) +- [Agent Plugins and Yield](agent-plugins.md) - [Run, pause, resume, and replay](reference/execution-model.md) - [The four SDKs](reference/sdk-parity.md) - [Guarantees and limits](reference/guarantees.md) diff --git a/labs/22-yield/yield/docs/agent-plugins.md b/labs/22-yield/yield/docs/agent-plugins.md new file mode 100644 index 00000000..71f4cc8b --- /dev/null +++ b/labs/22-yield/yield/docs/agent-plugins.md @@ -0,0 +1,38 @@ +# Agent Plugins and Yield + +Agent Plugins and Yield solve different parts of the same delivery path: + +- **Agent Plugins packages a capability.** Its manifest and fixed directories let + compatible clients discover Agent Skills and MCP servers. +- **Yield governs execution.** A Yield program owns repeatable order, branches, + checks, human decisions, saved state, and terminal outcomes. + +In short: **Agent Plugins packages the capability. Yield governs the execution.** + +## Current support boundary + +Yield does not currently emit an Agent Plugins `plugin.json`, install plugins, or +load MCP servers. `yskill register` writes a small `SKILL.md` adapter into a coding +agent's project skill directory and keeps the canonical workflow beside the +project dependencies it uses. + +That adapter alone is not proof that a package conforms to Agent Plugins. A +conformant plugin must satisfy the complete Agent Plugins manifest, containment, +component-discovery, and Agent Skills requirements. Yield does not claim Agent +Plugins v1 conformance in this release. + +## Using the projects together + +You can package skills however you like and use Yield for the repeatable workflow +behind them. Keep these boundaries explicit: + +1. the plugin package owns discovery and portable package structure; +2. the Yield program owns workflow execution and verification; +3. the host owns installation, permissions, and the agent interaction surface. + +A future plugin export should be treated as a separate, tested distribution +feature. It should not change Yield's execution contract. + +See the [Agent Plugins specification](https://agent-plugins.org/specification) and +the [Agent Skills specification](https://agentskills.io/specification) for their +normative requirements. diff --git a/labs/22-yield/yield/docs/quickstart.md b/labs/22-yield/yield/docs/quickstart.md index 697d896d..6d5bc86d 100644 --- a/labs/22-yield/yield/docs/quickstart.md +++ b/labs/22-yield/yield/docs/quickstart.md @@ -12,7 +12,7 @@ You need Node.js 24 or newer. mkdir yield-example cd yield-example npm init -y -npm install --save-exact @operatorstack/yield@0.1.26 \ +npm install --save-exact @operatorstack/yield@0.1.29 \ --registry=https://get.operatorstack.systems/npm/ npm exec -- yskill --version ``` diff --git a/labs/22-yield/yield/evals/results/latest.json b/labs/22-yield/yield/evals/results/latest.json index 45b828e6..769b95d1 100644 --- a/labs/22-yield/yield/evals/results/latest.json +++ b/labs/22-yield/yield/evals/results/latest.json @@ -1,8 +1,8 @@ { "schema_version": 2, "methodology_version": "1.1", - "generated_at": "2026-08-02T19:51:34.931Z", - "source_digest": "e5b21f13b239b762064fa3a4bd3d2354fba3dc46feb324f9bddbccad72827c24", + "generated_at": "2026-08-07T06:48:04.494Z", + "source_digest": "b84acf911139d392a12774d10b255d9ff396e91f6356d349920560e75b90d4f3", "status": "passed", "workflow_conformance": { "passed": 40, diff --git a/labs/22-yield/yield/sdk/python/README.md b/labs/22-yield/yield/sdk/python/README.md index 60d89acc..bef31009 100644 --- a/labs/22-yield/yield/sdk/python/README.md +++ b/labs/22-yield/yield/sdk/python/README.md @@ -10,7 +10,7 @@ Create a virtual environment before installation: # macOS and Linux python3 -m venv .venv source .venv/bin/activate -python -m pip install yieldskill==0.1.26 \ +python -m pip install yieldskill==0.1.29 \ --index-url https://get.operatorstack.systems/pip/simple/ ``` @@ -18,7 +18,7 @@ python -m pip install yieldskill==0.1.26 \ # Windows PowerShell py -m venv .venv .\.venv\Scripts\Activate.ps1 -python -m pip install yieldskill==0.1.26 ` +python -m pip install yieldskill==0.1.29 ` --index-url https://get.operatorstack.systems/pip/simple/ ```