Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/src/content/docs/agent-factory-status.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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) | - | - |
Expand Down Expand Up @@ -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) | - | - |
Expand Down
34 changes: 34 additions & 0 deletions docs/src/content/docs/reference/glossary.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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/).
Expand Down
41 changes: 39 additions & 2 deletions docs/src/content/docs/reference/model-tables.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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` |
Expand Down Expand Up @@ -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 |
Expand All @@ -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 |
Expand Down
Loading