Skip to content

Commit d7d5c8e

Browse files
Audit pass: wire new orchestration-launch pages into sidebar; tidy stale terminology (#97)
Audit pass over the three PRs merged into hyc/orchestration-launch (#83 Platform Credits, #87 Harnesses, #88 Agent identities) to catch wiring and cross-reference issues before rollout. Sidebar wiring (src/sidebar.ts): - Under 'Oz Cloud Agents & Orchestration', add 'Agent identities' (slug agent-platform/cloud-agents/agents) after Managing cloud agents, and a new collapsed 'Harnesses' subsection (Overview, Warp Agent, Claude Code, Codex, Authentication) after Secrets and before MCP servers. - Under 'Plans and billing', add 'Platform credits' after Add-on Credits. Terminology / cross-reference (one-line tweaks): - external-authentication-required.mdx:104: replace the inline '(service account)' parenthetical with 'bound to an [agent identity](...)'. Matches the alias formalized in agents.mdx and the existing phrasing in federate.mdx and cli/index.mdx. - cloud-agents/overview.mdx Learn more: add two bullets so the new Harnesses overview and Agent identities pages are discoverable from the parent overview. Validation: - check_links --internal-only: 0 broken across 2,495 internal links (up 3 from the 2,492 baseline, matching the 3 new links added). - style_lint --changed: 14 warnings, identical to baseline (all pre-existing proper-name false positives in pricing-faqs.mdx, bring-your-own-api-key.mdx, etc.). - npm run build: succeeds; 326 HTML files generated. Co-authored-by: Oz <oz-agent@warp.dev>
1 parent 2143f36 commit d7d5c8e

3 files changed

Lines changed: 16 additions & 1 deletion

File tree

src/content/docs/agent-platform/cloud-agents/overview.mdx

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,8 @@ If your credit balance reaches zero, cloud agent runs will not be able to execut
144144

145145
* [Cloud agents quickstart](/agent-platform/cloud-agents/quickstart/) — run your first cloud agent with an environment in ~10 minutes.
146146
* [Oz Platform](/agent-platform/cloud-agents/platform/) — CLI, Oz API/SDK, orchestration, tasks, environments, hosts, integrations, and more.
147+
* [Harnesses](/agent-platform/cloud-agents/harnesses/) — pick between Warp Agent, Claude Code, and Codex for any cloud agent run.
148+
* [Agent identities](/agent-platform/cloud-agents/agents/) — team-scoped bot accounts that own and execute cloud agent runs.
147149
* [Skills as Agents](/agent-platform/cloud-agents/skills-as-agents/) — run agents based on reusable skill definitions from the CLI, web app, API, or on a schedule.
148150
* [Oz CLI](/reference/cli/) — shows how to run Oz agents in non-interactive mode from CI, scripts, or remote machines, including auth and common commands.
149151
* [Environments](/agent-platform/cloud-agents/environments/) — explains how environments provide the runtime context (repo, image, startup commands) for agent tasks.

src/content/docs/reference/api-and-sdk/troubleshooting/errors/external-authentication-required.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -101,7 +101,7 @@ This error includes extra fields beyond the standard response format:
101101
2. Ensure the app has access to all repositories listed in `inaccessible_repos`.
102102
3. Retry the task.
103103

104-
If you are using a **team API key** (service account), ensure the Warp GitHub App is installed on the organization that owns the repositories.
104+
If you are using a **team API key** bound to an [agent identity](/agent-platform/cloud-agents/agents/), ensure the Warp GitHub App is installed on the organization that owns the repositories.
105105

106106
### Account matching failed
107107

src/sidebar.ts

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -351,10 +351,22 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
351351
},
352352
'agent-platform/cloud-agents/environments',
353353
{ slug: 'agent-platform/cloud-agents/managing-cloud-agents', label: 'Managing cloud agents' },
354+
{ slug: 'agent-platform/cloud-agents/agents', label: 'Agent identities' },
354355
{ slug: 'agent-platform/cloud-agents/oz-web-app', label: 'Oz web app' },
355356
{ slug: 'agent-platform/cloud-agents/skills-as-agents', label: 'Skills as agents' },
356357
{ slug: 'agent-platform/cloud-agents/viewing-cloud-agent-runs', label: 'Viewing cloud agent runs' },
357358
'agent-platform/cloud-agents/secrets',
359+
{
360+
label: 'Harnesses',
361+
collapsed: true,
362+
items: [
363+
{ slug: 'agent-platform/cloud-agents/harnesses', label: 'Overview' },
364+
{ slug: 'agent-platform/cloud-agents/harnesses/warp-agent', label: 'Warp Agent' },
365+
{ slug: 'agent-platform/cloud-agents/harnesses/claude-code', label: 'Claude Code' },
366+
{ slug: 'agent-platform/cloud-agents/harnesses/codex', label: 'Codex' },
367+
{ slug: 'agent-platform/cloud-agents/harnesses/authentication', label: 'Authentication' },
368+
],
369+
},
358370
{ slug: 'agent-platform/cloud-agents/mcp', label: 'MCP servers' },
359371
{ slug: 'agent-platform/cloud-agents/deployment-patterns', label: 'Deployment patterns' },
360372
{ slug: 'agent-platform/cloud-agents/warp-hosting', label: 'Warp-hosted agents' },
@@ -502,6 +514,7 @@ export const sidebarTopics: StarlightSidebarTopicsUserConfig = [
502514
{ slug: 'support-and-community/plans-and-billing/plans-pricing-refunds', label: 'Plans, Pricing, & Refunds' },
503515
'support-and-community/plans-and-billing/credits',
504516
'support-and-community/plans-and-billing/add-on-credits',
517+
{ slug: 'support-and-community/plans-and-billing/platform-credits', label: 'Platform credits' },
505518
'support-and-community/plans-and-billing/bring-your-own-api-key',
506519
'support-and-community/plans-and-billing/overages-legacy',
507520
'support-and-community/plans-and-billing/pricing-faqs',

0 commit comments

Comments
 (0)