Summary
Add support for a top-level frontmatter field for the AWF max cache miss guardrail.
Problem
gh-aw already tracks the upstream AWF apiProxy.maxCacheMisses field in the embedded AWF schema, but workflow authors do not appear to have a first-class top-level frontmatter field for configuring it, and there is no environment-manager-controlled default override similar to other compiler-managed guardrails.
Requested behavior
- Add a top-level frontmatter field named
max-cache-misses.
- Map that field to the AWF guardrail
apiProxy.maxCacheMisses in the generated AWF config.
- Use a built-in default of
5 when the field is not explicitly set.
- Add an environment variable managed by the environment manager that can override that default with another value.
Expected precedence
max-cache-misses in workflow frontmatter
- Environment-manager-controlled default override
- Built-in default of
5
Notes
- This should follow the existing pattern used for other top-level guardrails/defaults such as max AI credits / max turns where applicable.
- The new default override should be surfaced through the environment manager and related docs so repo/org admins can manage it centrally.
- The frontmatter field should be documented as mapping to the AWF max cache miss guardrail.
Acceptance criteria
Summary
Add support for a top-level frontmatter field for the AWF max cache miss guardrail.
Problem
gh-awalready tracks the upstream AWFapiProxy.maxCacheMissesfield in the embedded AWF schema, but workflow authors do not appear to have a first-class top-level frontmatter field for configuring it, and there is no environment-manager-controlled default override similar to other compiler-managed guardrails.Requested behavior
max-cache-misses.apiProxy.maxCacheMissesin the generated AWF config.5when the field is not explicitly set.Expected precedence
max-cache-missesin workflow frontmatter5Notes
Acceptance criteria
max-cache-missesis accepted by workflow frontmatter/schema.apiProxy.maxCacheMissesin AWF config from that top-level field.5.