Skip to content

[codex] docs: add pipeline extension recipe#1758

Draft
ketpatil77 wants to merge 1 commit into
headroomlabs-ai:mainfrom
ketpatil77:codex/headroom-pipeline-extension-docs
Draft

[codex] docs: add pipeline extension recipe#1758
ketpatil77 wants to merge 1 commit into
headroomlabs-ai:mainfrom
ketpatil77:codex/headroom-pipeline-extension-docs

Conversation

@ketpatil77

@ketpatil77 ketpatil77 commented Jul 3, 2026

Copy link
Copy Markdown

Description

Headroom already supports headroom.pipeline_extension, but the request-normalization pattern was not documented. That leaves users guessing how to fix upstream quirks such as content: null tool-call payloads.

Changes Made

  • Added a Pipeline Extensions section to configuration.mdx.
  • Documented the PRE_SEND hook as the right place for request cleanup.
  • Included a minimal NormalizeNullContent example and entry-point registration.
  • Mentioned x-headroom-base-url as the per-request routing override.

Testing

  • Reviewed the docs diff for API names and placement.
  • Confirmed the example uses the public headroom.pipeline contract.

Impact

Users can implement provider-specific request cleanup without forking Headroom, and can pair it with per-request upstream routing when needed.

@github-actions

github-actions Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

PR governance

This PR does not yet satisfy the required template fields:

  • Missing required section Type of Change.
  • Missing required section Real Behavior Proof.
  • Missing required section Review Readiness.
  • Paste real command output or artifact links in TestingTest Output.

Please update the PR body, or move the PR back to draft while it is still in progress.

@github-actions github-actions Bot added the status: needs author action Pull request body or readiness checklist still needs author updates label Jul 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status: needs author action Pull request body or readiness checklist still needs author updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant