Skip to content

[chore] Remove the pi_agenta harness experiment - #6367

Open
mmabrouk wants to merge 2 commits into
fix/lifecycle-harness-kindfrom
chore/remove-pi-agenta
Open

[chore] Remove the pi_agenta harness experiment#6367
mmabrouk wants to merge 2 commits into
fix/lifecycle-harness-kindfrom
chore/remove-pi-agenta

Conversation

@mmabrouk

Copy link
Copy Markdown
Member

Context

pi_agenta was an experiment: Pi plus a forced Agenta overlay (a fixed AGENTS.md preamble, a persona append-system, force-unioned platform skills). We never shipped it to users; the picker already hid it. It kept costing attention anyway: every harness table, capability map, test matrix, and doc had to carry a fourth value, and the lifecycle-router bug fixed underneath this PR (#6364) shows the kind of drift a half-dead enum value invites.

Changes

The value is removed everywhere it was declared or taught: the SDK harness enum and adapter, the overlay constants (AGENTA_PREAMBLE, the persona, the forced-skills union), the capability and model-catalog tables, the runner's advertised harness list and subscription probes, the UI harness metadata and stories, the platform skill bodies that listed it as a valid harness.kind, and the reference docs.

One thing is deliberately kept: reading the old value stays legal. Revisions saved while the experiment existed may carry "pi_agenta", so every read boundary maps it to pi_core instead of refusing the config:

Before: HarnessKind.coerce("pi_agenta") -> the Agenta harness with the forced overlay.

After: HarnessKind.coerce("pi_agenta") -> plain pi_core. Same in the runner (buildRunPlan, isPiHarness, harnessKind) and the web picker filter.

The runner replay fixtures that carry the old spelling pass unchanged, which pins the alias.

Not in this PR: the generated Fern client (web/packages/agenta-api-client) still lists the value in its HarnessKind union. It regenerates from the API schema on the normal codegen step; the stale member is types-only until then.

Tests

  • SDK: oss/tests/pytest/unit fully green (2486 passed). Agenta-harness-only tests removed; the coerce alias and make_harness("pi_agenta") -> PiHarness are pinned.
  • services: agent unit suite green (160 passed), including the pi_agenta-parametrized select-backend case, which now exercises the alias end to end.
  • runner: 156 files / 2564 tests green, typecheck clean.
  • web: agenta-entities (105), agenta-entity-ui (598), agenta-ui (148) green.

What to QA

  • Open an old agent revision that was saved with the Pi (Agenta) harness, if one exists in your workspace. It loads and runs as Pi; the picker shows Pi.
  • Regression: the harness picker still offers Pi, Claude Code, and Codex, and each runs.

Stacked on #6364 (the diff here shows only this change).

https://claude.ai/code/session_014s6jqKCsVKsNMmnrJVJkZt

pi_agenta (Pi plus a forced Agenta overlay: an AGENTS.md preamble, a
persona append-system, force-unioned platform skills) was an experiment
we never shipped to users. Remove it from the harness enum, the SDK
adapter and its overlay constants, the capability and catalog tables,
the runner's advertised harness list and subscription probes, the UI
harness metadata, the platform skill bodies that taught it, and the
reference docs.

Compatibility, deliberately kept: revisions saved while the value
existed may still carry it, so every read boundary maps 'pi_agenta' to
'pi_core' instead of refusing the config — HarnessKind.coerce in the
SDK, buildRunPlan / isPiHarness / harnessKind in the runner, and the
web picker filter. The runner replay fixtures that carry the old
spelling still pass unchanged, which pins the alias.

Not touched here: the generated Fern client's HarnessKind union
(web/packages/agenta-api-client) regenerates from the API schema on its
own codegen step; the stale extra member is types-only and harmless
until then.

Claude-Session: https://claude.ai/code/session_014s6jqKCsVKsNMmnrJVJkZt
@dosubot dosubot Bot added the size:L This PR changes 100-499 lines, ignoring generated files. label Aug 29, 2026
@vercel

vercel Bot commented Aug 29, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agenta-documentation Ready Ready Preview Aug 31, 2026 11:04am

Request Review

@dosubot dosubot Bot added the refactoring A code change that neither fixes a bug nor adds a feature label Aug 29, 2026
@github-actions

github-actions Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

📘 Docs preview

Status ✅ Ready
Preview https://pr-6367-agenta-docs-preview.mahmoud-637.workers.dev/docs
Inspect Actions run
Commit fa9b10396581995989525fba5b484be8852a2ee9

Pages changed in this pull request

This comment updates in place on every push.

@coderabbitai

coderabbitai Bot commented Aug 29, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (1)
  • release/.*

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro Plus

Run ID: c90ab1b4-7797-4617-a54d-427c60dc9f0c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@mmabrouk mmabrouk left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

lgtm

@mmabrouk mmabrouk added the lgtm This PR has been approved by a maintainer label Aug 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lgtm This PR has been approved by a maintainer refactoring A code change that neither fixes a bug nor adds a feature size:L This PR changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant