From a3a622d15fb8b92d1d6d74d3407cfe9f199efc57 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 13 Jun 2026 09:41:59 +0000 Subject: [PATCH] [instructions] Sync instruction files with release v0.79.8 Mark max-runs as deprecated alias of max-turns, replace stale effective_tokens example with ai_credits, and document the new models frontmatter field for custom AI Credits pricing. Co-Authored-By: Claude Opus 4.8 (1M context) --- .github/aw/experiments.md | 4 ++-- .github/aw/syntax-agentic.md | 4 +--- .github/aw/token-optimization.md | 2 ++ 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/.github/aw/experiments.md b/.github/aw/experiments.md index 2646ce24c6d..2f5ccb19ffd 100644 --- a/.github/aw/experiments.md +++ b/.github/aw/experiments.md @@ -64,8 +64,8 @@ experiments: variants: [concise, detailed, step_by_step] weight: [2, 1, 1] # 50% concise, 25% detailed, 25% step_by_step description: "Verbosity A/B test" - metric: "effective_tokens" - hypothesis: "H0: no change in effective_tokens. H1: concise reduces by >=15%" + metric: "ai_credits" + hypothesis: "H0: no change in ai_credits. H1: concise reduces by >=15%" guardrail_metrics: - name: success_rate threshold: ">=0.95" diff --git a/.github/aw/syntax-agentic.md b/.github/aw/syntax-agentic.md index 5b947ab648a..123503a8620 100644 --- a/.github/aw/syntax-agentic.md +++ b/.github/aw/syntax-agentic.md @@ -25,10 +25,8 @@ description: Agentic workflow specific frontmatter fields for GitHub Agentic Wor - Bot must be active (installed) on repository to trigger workflow - **`strict:`** - Enable enhanced validation for production workflows (boolean, defaults to `true`) - Must be `true` -- **`max-runs:`** - Maximum number of LLM invocations allowed per workflow run (integer or numeric string, minimum: 1) - - Top-level field mapped to `apiProxy.maxRuns` - - Supported by all engines - **`max-turns:`** - AWF turn cap applied consistently across all agentic engines (integer or expression, e.g. `${{ inputs.max-turns }}`). The engine-level `engine.max-turns` is a deprecated alias kept for backward compatibility — prefer this top-level field. Not supported by the `gemini` engine. +- **`max-runs:`** - Deprecated legacy alias for the AWF invocation cap (`apiProxy.maxRuns`, defaults to `500` when omitted). Use `max-turns` instead; run `gh aw fix` to migrate. - **`max-ai-credits:`** - Per-run AI Credits (AIC) budget enforced by the AWF firewall (integer or `K`/`M` short-form string like `100M`; default `1000`). Set a negative value to disable enforcement and token steering. See [token-optimization.md](token-optimization.md). - **`max-daily-ai-credits:`** - Per-user 24-hour AI Credits (AIC) guardrail: activation blocks execution once the triggering user's aggregated AI Credits for this workflow over the last 24h exceed the threshold (integer or `K`/`M` short-form string, or `-1`). Enabled by default with a system default threshold; set `-1` to disable or an explicit value to override. See [token-optimization.md](token-optimization.md). - **`user-rate-limit:`** - Rate limiting configuration to prevent users from triggering the workflow too frequently (object) diff --git a/.github/aw/token-optimization.md b/.github/aw/token-optimization.md index b29e9dfba03..a796056538c 100644 --- a/.github/aw/token-optimization.md +++ b/.github/aw/token-optimization.md @@ -409,6 +409,8 @@ max-ai-credits: 100M # per-run cap (short-form string) max-daily-ai-credits: 500M # per-user 24h cap; -1 disables ``` +For custom or private models, the top-level **`models:`** frontmatter field supplies pricing in the same structure as `models.json` (keyed `providers..models..cost` with `input`/`output`/`cache_read`/`cache_write` per-token costs). Entries are merged with the built-in `models.json` at runtime — they override matching models and fill gaps for unknown ones — so AI Credit accounting stays accurate for models gh-aw does not price by default. + --- ## Additional Resources