Preview: Semantic Hypermedia Agent Runtime integration

[koriym]

Purpose

This is a draft integration preview for the Semantic Hypermedia Agent Runtime stack.

It merges the currently stacked PRs in order so reviewers can inspect the final combined diff and CI behavior before the stack is landed into 1.x:

1. Add P0 agent extension APIs #18 — P0 agent extension APIs
2. Add ALPS context processor #19 — ALPS context processor
3. Add ALPS tool policy processor #20 — ALPS tool policy processor
4. Preserve assistant responses in agent history #21 — Preserve assistant responses in agent history
5. Harden agent extension review findings #22 — Review hardening

Conductor issue: #24

Important

This PR is primarily for reviewing the completed image. It does not replace the planned top-down merge procedure unless we explicitly decide to land the stack through this integration branch.

The individual PRs should still be retargeted and rechecked as described in #24 if we choose the staged landing path.

Local validation

• zsh -ic 'sphp85; composer validate --strict --no-check-publish'
• zsh -ic 'sphp85; composer tests'

Note: PHP 8.5 still prints deprecation notices from PHPMD/PDepend dependencies, but the commands exit successfully.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. 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: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: befd1d25-5a5d-43e4-a4fe-7e2409303adc

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/semantic-hypermedia-runtime-preview

---

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

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[koriym]

Integration preview checks are green. All GitHub Actions checks for the combined #18 → #22 branch passed. Local validation also passed with PHP 8.5: composer validate and composer tests.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (4eb9408) to head (b9966e7).

Additional details and impacted files

@@             Coverage Diff              @@
##                 1.x       #25    +/-   ##
============================================
  Coverage     100.00%   100.00%            
- Complexity       267       405   +138     
============================================
  Files             25        35    +10     
  Lines            729      1078   +349     
============================================
+ Hits             729      1078   +349     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[koriym]

Closing this draft preview PR. Per direction, this is only an experimental integration branch now: .