diff --git a/docs/src/content/docs/agent-factory-status.mdx b/docs/src/content/docs/agent-factory-status.mdx index db078aecff3..e1e488d099b 100644 --- a/docs/src/content/docs/agent-factory-status.mdx +++ b/docs/src/content/docs/agent-factory-status.mdx @@ -86,6 +86,7 @@ These are experimental agentic workflows used by the GitHub Next team to learn, | [Daily OTel Instrumentation Advisor](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-otel-instrumentation-advisor.md) | claude | [![Daily OTel Instrumentation Advisor](https://github.com/github/gh-aw/actions/workflows/daily-otel-instrumentation-advisor.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-otel-instrumentation-advisor.lock.yml) | - | - | | [Daily Project Performance Summary Generator (Using MCP Scripts)](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-performance-summary.md) | copilot | [![Daily Project Performance Summary Generator (Using MCP Scripts)](https://github.com/github/gh-aw/actions/workflows/daily-performance-summary.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-performance-summary.lock.yml) | - | - | | [Daily Regulatory Report Generator](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-regulatory.md) | copilot | [![Daily Regulatory Report Generator](https://github.com/github/gh-aw/actions/workflows/daily-regulatory.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-regulatory.lock.yml) | - | - | +| [Daily Reliability Review](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-reliability-review.md) | claude | [![Daily Reliability Review](https://github.com/github/gh-aw/actions/workflows/daily-reliability-review.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-reliability-review.lock.yml) | - | - | | [Daily Rendering Scripts Verifier](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-rendering-scripts-verifier.md) | claude | [![Daily Rendering Scripts Verifier](https://github.com/github/gh-aw/actions/workflows/daily-rendering-scripts-verifier.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-rendering-scripts-verifier.lock.yml) | - | - | | [Daily Safe Output Integrator](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-safe-output-integrator.md) | copilot | [![Daily Safe Output Integrator](https://github.com/github/gh-aw/actions/workflows/daily-safe-output-integrator.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-safe-output-integrator.lock.yml) | - | - | | [Daily Safe Output Tool Optimizer](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-safe-output-optimizer.md) | claude | [![Daily Safe Output Tool Optimizer](https://github.com/github/gh-aw/actions/workflows/daily-safe-output-optimizer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/daily-safe-output-optimizer.lock.yml) | - | - | @@ -163,6 +164,7 @@ These are experimental agentic workflows used by the GitHub Next team to learn, | [Plan Command](https://github.com/github/gh-aw/blob/main/.github/workflows/plan.md) | copilot | [![Plan Command](https://github.com/github/gh-aw/actions/workflows/plan.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/plan.lock.yml) | - | - | | [Poem Bot - A Creative Agentic Workflow](https://github.com/github/gh-aw/blob/main/.github/workflows/poem-bot.md) | copilot | [![Poem Bot - A Creative Agentic Workflow](https://github.com/github/gh-aw/actions/workflows/poem-bot.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/poem-bot.lock.yml) | - | - | | [PR Code Quality Reviewer](https://github.com/github/gh-aw/blob/main/.github/workflows/pr-code-quality-reviewer.md) | copilot | [![PR Code Quality Reviewer](https://github.com/github/gh-aw/actions/workflows/pr-code-quality-reviewer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/pr-code-quality-reviewer.lock.yml) | - | - | +| [PR Description Updater](https://github.com/github/gh-aw/blob/main/.github/workflows/pr-description-caveman.md) | copilot | [![PR Description Updater](https://github.com/github/gh-aw/actions/workflows/pr-description-caveman.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/pr-description-caveman.lock.yml) | - | - | | [PR Nitpick Reviewer 🔍](https://github.com/github/gh-aw/blob/main/.github/workflows/pr-nitpick-reviewer.md) | copilot | [![PR Nitpick Reviewer 🔍](https://github.com/github/gh-aw/actions/workflows/pr-nitpick-reviewer.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/pr-nitpick-reviewer.lock.yml) | - | - | | [PR Sous Chef](https://github.com/github/gh-aw/blob/main/.github/workflows/pr-sous-chef.md) | copilot | [![PR Sous Chef](https://github.com/github/gh-aw/actions/workflows/pr-sous-chef.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/pr-sous-chef.lock.yml) | - | - | | [PR Triage Agent](https://github.com/github/gh-aw/blob/main/.github/workflows/pr-triage-agent.md) | copilot | [![PR Triage Agent](https://github.com/github/gh-aw/actions/workflows/pr-triage-agent.lock.yml/badge.svg)](https://github.com/github/gh-aw/actions/workflows/pr-triage-agent.lock.yml) | - | - | diff --git a/docs/src/content/docs/reference/glossary.md b/docs/src/content/docs/reference/glossary.md index 1d8942156cc..6052f0fdb9d 100644 --- a/docs/src/content/docs/reference/glossary.md +++ b/docs/src/content/docs/reference/glossary.md @@ -75,6 +75,31 @@ Capabilities that an AI agent can use during workflow execution. Tools are confi A `tools.github` field that controls how the agent accesses GitHub APIs. Three values are supported: `gh-proxy` (recommended — provides pre-authenticated `gh` CLI prompt guidance without mounting a GitHub MCP server, replacing the deprecated `features.cli-proxy: true`), `local` (Docker-based GitHub MCP server, the legacy default), and `remote` (hosted GitHub MCP server at `api.githubcopilot.com`). Use `gh-proxy` for better performance; use `local` or `remote` when MCP-based GitHub toolsets are required. See [GitHub Tools Reference](/gh-aw/reference/github-tools/). +### Allowed Repos (`tools.github.allowed-repos`) + +A GitHub Tools configuration field that restricts which repositories the agent can access through GitHub tools during workflow execution. Accepts `"all"` (default — all repositories accessible by the token), `"public"` (public repositories only), `"current"` (the repository where the workflow is running, normalized to `${{ github.repository }}`), or an array of repository patterns (`"owner/repo"`, `"owner/*"`, `"owner/prefix*"`). Wildcards are only permitted at the end of the repository name component. Use `current` in reusable workflows to express "this repository only" without hard-coding owner/repo values. Patterns must be lowercase. See [GitHub Tools Reference](/gh-aw/reference/github-tools/). + +```aw wrap +tools: + github: + toolsets: [issues, pull_requests] + allowed-repos: current + min-integrity: approved +``` + +### Ignore If Missing (`ignore-if-missing`) + +A GitHub App authentication field that gracefully skips token minting when `client-id` or `private-key` resolve to empty strings at runtime (e.g., on fork pull requests where App secrets are unavailable). When set to `true` under `github-app.ignore-if-missing`, the workflow falls back to the standard token chain (`secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN`) instead of failing. Applies consistently to all token mint paths: safe outputs, activation, pre-activation, and checkout. Default behavior (fail when keys are empty) remains unchanged when omitted or set to `false`. See [Authentication Reference](/gh-aw/reference/auth/). + +```aw wrap +safe-outputs: + github-app: + client-id: ${{ vars.APP_ID }} + private-key: ${{ secrets.APP_PRIVATE_KEY }} + ignore-if-missing: true + create-issue: +``` + ## Security and Outputs ### MCP Scripts @@ -469,6 +494,15 @@ Steps injected at a specific lifecycle position within a custom or built-in job' A frontmatter field that declares custom jobs that both the `pre_activation` and `activation` built-in jobs depend on. Use this when credentials or secrets must be fetched by a custom job before activation runs — for example, when `on.github-app` tokens come from a secrets-manager job. Values must reference custom jobs defined in the top-level `jobs:` section; built-in job names are rejected at compile time. See [Triggers Reference](/gh-aw/reference/triggers/). +### Pull Request Reviewer Trigger (`on.pull_request_reviewer`) + +A synthetic frontmatter trigger for workflows that act as PR reviewers. Configured with `on.pull_request_reviewer: slash_command`, it compiles to centralized routing through the `agentic_commands.yml` dispatcher and automatically subscribes to PR reviewer lifecycle events (`pull_request.ready_for_review` and `pull_request_review` actions). The compiler applies PR-scoped concurrency with queue-max defaults and injects early cancellation when the PR is already closed at workflow start. Review events are resolved to the target workflow via XML markers in the review body using the existing `extractWorkflowId` mechanism. Introduced in [ADR-33273](https://github.com/github/gh-aw/blob/main/docs/adr/33273-synthetic-pull-request-reviewer-trigger.md). See [Triggers Reference](/gh-aw/reference/triggers/). + +```aw wrap +on: + pull_request_reviewer: slash_command +``` + ### Stop After A workflow configuration field (`stop-after:`) that automatically prevents new runs after a specified time limit. Accepts absolute dates (`YYYY-MM-DD`, ISO 8601) or relative time deltas (`+48h`, `+7d`). Minimum granularity is hours. Useful for trial periods, experimental features, and cost-controlled schedules. Recompile with `gh aw compile --refresh-stop-time` to reset the deadline. See [Ephemerals](/gh-aw/reference/ephemerals/). diff --git a/docs/src/content/docs/reference/model-tables.md b/docs/src/content/docs/reference/model-tables.md index 66c7eff87d8..be00c87fbb0 100644 --- a/docs/src/content/docs/reference/model-tables.md +++ b/docs/src/content/docs/reference/model-tables.md @@ -40,6 +40,8 @@ Vendor aliases map a short name to one or more provider-scoped glob patterns. Th | `vision` | `copilot/gemini-*image*`, `gemini/gemini-*image*`, `copilot/gemini-*flash*`, `gemini/gemini-*flash*` | | `gemma` | `copilot/gemma*`, `google/gemma*`, `gemini/gemma*` | | `deep-research` | `copilot/deep-research*`, `copilot/o3-deep-research*`, `copilot/o4-mini-deep-research*`, `google/deep-research*`, `gemini/deep-research*`, `openai/o3-deep-research*`, `openai/o4-mini-deep-research*` | +| `mini` | `haiku`, `gpt-5-mini`, `gpt-5-nano`, `gemini-flash-lite`, `copilot/raptor*mini*` | +| `any` | `copilot/*`, `anthropic/*`, `openai/*`, `google/*`, `gemini/*` | ### Meta-Aliases @@ -48,10 +50,8 @@ Meta-aliases reference other aliases by name. They are resolved recursively unti | Meta-alias | Expands to | |------------|------------| | `small` | `mini` | -| `mini` | `haiku` → `gpt-5-mini` → `gpt-5-nano` → `gemini-flash-lite` | | `large` | `sonnet` → `gpt-5-pro` → `gpt-5` → `gemini-pro` | | `auto` | `large` | -| `any` | `copilot/*` → `anthropic/*` → `openai/*` → `google/*` → `gemini/*` | | `agent` | `sonnet-6x` → `gpt-5.4` → `gpt-5` → `gemini-pro` → `haiku` → `any` | | `copilot` | `agent` → `gpt-5.4` → `sonnet` → `gpt-5` → `any` | | `claude` | `agent` → `sonnet-6x` → `haiku` → `any` | @@ -124,49 +124,85 @@ Before per-model multipliers are applied, raw token counts are weighted by token | `gpt-4-turbo` | 1 | | `gpt-4` | 1 | | `gpt-5` | 1 | +| `gpt-5-2025-08-07` | 1 | +| `gpt-5-search-api` | 1 | +| `gpt-5-search-api-2025-10-14` | 1 | +| `gpt-5-chat-latest` | 1 | | `gpt-5-mini` | 0.33 | +| `gpt-5-mini-2025-08-07` | 0.33 | | `gpt-5-nano` | 0.05 | +| `gpt-5-nano-2025-08-07` | 0.05 | | `gpt-5-pro` | 2 | +| `gpt-5-pro-2025-10-06` | 2 | | `gpt-5.1` | 3 | +| `gpt-5.1-2025-11-13` | 3 | +| `gpt-5.1-chat-latest` | 3 | | `gpt-5-codex` | 1 | | `gpt-5.1-codex` | 3 | | `gpt-5.1-codex-mini` | 0.33 | | `gpt-5.1-codex-max` | 3 | +| `gpt-5.1-codex-max-customsummarizer` | 3 | | `gpt-5.2` | 3 | +| `gpt-5.2-2025-12-11` | 3 | +| `gpt-5.2-chat-latest` | 3 | | `gpt-5.2-codex` | 3 | | `gpt-5.2-pro` | 2 | +| `gpt-5.2-pro-2025-12-11` | 2 | +| `gpt-5.3-chat-latest` | 3 | | `gpt-5.3-codex` | 6 | +| `gpt-5.3-codex-api-preview` | 6 | | `gpt-5.4` | 6 | +| `gpt-5.4-2026-03-05` | 6 | | `gpt-5.4-mini` | 6 | +| `gpt-5.4-mini-2026-03-17` | 6 | | `gpt-5.4-nano` | 0.05 | +| `gpt-5.4-nano-2026-03-17` | 0.05 | | `gpt-5.4-pro` | 2 | +| `gpt-5.4-pro-2026-03-05` | 2 | | `gpt-5.5` | 7.5 | +| `gpt-5.5-2026-04-23` | 7.5 | | `gpt-5.5-pro` | 2 | +| `gpt-5.5-pro-2026-04-23` | 2 | ### OpenAI Reasoning | Model | Multiplier | |-------|-----------| | `o1` | 3 | +| `o1-2024-12-17` | 3 | | `o1-mini` | 0.5 | | `o1-pro` | 10 | +| `o1-pro-2025-03-19` | 10 | | `o3` | 3 | +| `o3-2025-04-16` | 3 | | `o3-mini` | 0.5 | +| `o3-mini-2025-01-31` | 0.5 | | `o3-pro` | 10 | +| `o3-pro-2025-06-10` | 10 | | `o3-deep-research` | 3 | +| `o3-deep-research-2025-06-26` | 3 | | `o4-mini` | 0.5 | +| `o4-mini-2025-04-16` | 0.5 | | `o4-mini-deep-research` | 0.5 | +| `o4-mini-deep-research-2025-06-26` | 0.5 | ### Google | Model | Multiplier | |-------|-----------| | `gemini-2.5-pro` | 1 | +| `gemini-2.5-pro-preview-tts` | 1 | | `gemini-2.5-flash` | 0.2 | +| `gemini-2.5-flash-native-audio-latest` | 0.2 | +| `gemini-2.5-flash-native-audio-preview-09-2025` | 0.2 | +| `gemini-2.5-flash-native-audio-preview-12-2025` | 0.2 | +| `gemini-2.5-flash-preview-tts` | 0.2 | | `gemini-2.5-flash-image` | 0.2 | | `gemini-2.5-flash-lite` | 0.1 | | `gemini-2.0-flash` | 0.1 | +| `gemini-2.0-flash-001` | 0.1 | | `gemini-2.0-flash-lite` | 0.1 | +| `gemini-2.0-flash-lite-001` | 0.1 | | `gemini-1.5-pro` | 1 | | `gemini-1.5-flash` | 0.1 | | `gemini-flash-latest` | 0.2 | @@ -182,6 +218,7 @@ Before per-model multipliers are applied, raw token counts are weighted by token | `gemini-3.1-flash-lite-preview` | 0.1 | | `gemini-3.1-flash-image-preview` | 0.33 | | `gemini-3.1-flash-tts-preview` | 0.1 | +| `gemini-3.5-flash` | 14 | | `gemini-2.5-computer-use-preview` | 0.2 | | `gemini-2.5-computer-use-preview-10-2025` | 0.2 | | `gemini-robotics-er-1.5-preview` | 0.2 |