Skip to content

Commit 2f2eb0f

Browse files
committed
feat: manage provider headers via PATCH and ocx provider edit --headers
PATCH /api/providers now accepts a headers field, shallow-merged onto the existing block (null or {} clears it), and ocx provider edit gains --headers <json>. Custom providers such as Agent Router can restore required fingerprint headers through the management plane instead of hand-editing config.json. POST /api/providers already round-trips headers; validation reuses providerHeadersConfigError.
1 parent 25c2477 commit 2f2eb0f

14 files changed

Lines changed: 137 additions & 11 deletions

File tree

‎docs-site/src/content/docs/ja/reference/cli/providers-accounts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ description: プロバイダー構成、資格情報、クォータ、および
1515
| --- | --- | --- |
1616
| `list` | `--json` |構成されたプロバイダーと残りのレジストリ エントリを一覧表示します。 |
1717
| `add <name>` | `--adapter <adapter>`、`--base-url <url>`、`--api-key <key>`、`--default-model <model>`、`--set-default`、`--force`、`--json`、`--sync` |レジストリ/カスタムプロバイダーを追加します。 `--force` は上書きします。 `--sync` は、実行中のプロキシを人間出力モードで更新します。 |
18-
| `edit <name>` |プロバイダーフィールドフラグ、`--json` |キー プールを置き換えずに、検証済みのライブ プロバイダー フィールドを編集します。 |
18+
| `edit <name>` |プロバイダーフィールドフラグ、`--headers <json>`、`--json` |キー プールを置き換えずに、検証済みのライブ プロバイダー フィールドを編集します。`--headers` はカスタム要求ヘッダーをマージします。`{}` または `-` を渡すとクリアします。 |
1919
| `test <name>` | `--json` |実際の上流モデルのエンドポイントを調査します。 |
2020
| `show <name>` | `--json` | API キーをマスクして設定を表示します。 |
2121
| `remove <name>` | `--json` |デフォルト以外のプロバイダーを削除します。最後のプロバイダーは削除できません。 |

‎docs-site/src/content/docs/ja/reference/management-api.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ Authorization: Bearer <admin-token>
166166
| --- | --- | --- |
167167
| `GET /api/providers` |編集されたプロバイダー設定と検出状態をリストする | — |
168168
| `POST /api/providers` |検証済みプロバイダーを 1 つ追加または置換し、必要に応じてそれをデフォルトにします。 400 無効または危険な宛先または構成。 409 名前空間の衝突 |
169-
| `PATCH /api/providers?name=...` |許可されたプロバイダー フィールド、有効/デフォルト状態、または OpenAI アカウント モードを更新します。 400 無効なフィールドまたは遷移。 404 不明なプロバイダ |
169+
| `PATCH /api/providers?name=...` |許可されたプロバイダー フィールド(マージされる `headers` ブロックを含む)、有効/デフォルト状態、または OpenAI アカウント モードを更新します。 400 無効なフィールドまたは遷移。 404 不明なプロバイダ |
170170
| `DELETE /api/providers?name=...` |プロバイダーを削除し、可能な場合はデフォルトを再割り当てします。 404 不明なプロバイダー。 409 `last_provider`; 409 `provider_has_dependent_combos` |
171171
| `POST /api/providers/test?name=...` |制限されたライブプロバイダー接続/モデル検出プローブを実行する | 404 不明なプロバイダー。障害は通常、`ok: false` の証拠として返されます。
172172
| `GET /api/provider-quotas` |プロバイダー クォータ レポートを読む。 `refresh=1` 強制更新 | — |

‎docs-site/src/content/docs/ko/reference/cli/providers-accounts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ description: 제공자 설정, 자격 증명, 할당량, 모델 카탈로그 명
1515
| --- | --- | --- |
1616
| `list` | `--json` | 설정된 제공자와 남아 있는 레지스트리 항목을 나열합니다. |
1717
| `add <name>` | `--adapter <adapter>`, `--base-url <url>`, `--api-key <key>`, `--default-model <model>`, `--set-default`, `--force`, `--json`, `--sync` | 레지스트리/사용자 지정 제공자를 추가합니다. `--force`는 덮어쓰고, `--sync`는 사람이 읽는 출력 모드에서 실행 중인 프록시를 새로 고칩니다. |
18-
| `edit <name>` | 제공자 필드 플래그, `--json` | 키 풀을 바꾸지 않고 검증된 실시간 제공자 필드를 수정합니다. |
18+
| `edit <name>` | 제공자 필드 플래그, `--headers <json>`, `--json` | 키 풀을 바꾸지 않고 검증된 실시간 제공자 필드를 수정합니다. `--headers`는 사용자 지정 요청 헤더를 병합하며, `{}` 또는 `-`로 지울 수 있습니다. |
1919
| `test <name>` | `--json` | 실제 상위 모델 엔드포인트를 확인합니다. |
2020
| `show <name>` | `--json` | API 키를 마스킹한 설정을 보여줍니다. |
2121
| `remove <name>` | `--json` | 기본값이 아닌 제공자를 제거합니다. 마지막 제공자는 제거할 수 없습니다. |

‎docs-site/src/content/docs/ko/reference/management-api.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ Authorization: Bearer <admin-token>
166166
| --- | --- | --- |
167167
| `GET /api/providers` | redacted된 provider 구성과 discovery 상태를 나열합니다 | — |
168168
| `POST /api/providers` | 검증된 provider 하나를 추가하거나 교체하고, 선택적으로 기본 provider로 설정합니다 | 400 잘못되었거나 위험한 대상 또는 구성; 409 namespace 충돌 |
169-
| `PATCH /api/providers?name=...` | 허용된 provider 필드, enabled/default 상태, 또는 OpenAI account mode를 업데이트합니다 | 400 잘못된 필드 또는 전환; 404 알 수 없는 provider |
169+
| `PATCH /api/providers?name=...` | 허용된 provider 필드(병합되는 `headers` 블록 포함), enabled/default 상태, 또는 OpenAI account mode를 업데이트합니다 | 400 잘못된 필드 또는 전환; 404 알 수 없는 provider |
170170
| `DELETE /api/providers?name=...` | provider를 삭제하고, 가능하면 기본 provider를 재지정합니다 | 404 알 수 없는 provider; 409 `last_provider`; 409 `provider_has_dependent_combos` |
171171
| `POST /api/providers/test?name=...` | 제한된 live provider connectivity/model-discovery 탐색을 수행합니다 | 404 알 수 없는 provider; 실패는 보통 `ok: false` 증거로 반환됩니다 |
172172
| `GET /api/provider-quotas` | provider quota 보고서를 읽습니다. `refresh=1`은 새로 고침을 강제합니다 | — |

‎docs-site/src/content/docs/reference/cli/providers-accounts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ both `--adapter` and `--base-url`.
1616
| --- | --- | --- |
1717
| `list` | `--json` | List configured providers and the remaining registry entries. |
1818
| `add <name>` | `--adapter <adapter>`, `--base-url <url>`, `--api-key <key>`, `--default-model <model>`, `--set-default`, `--force`, `--json`, `--sync` | Add a registry/custom provider. `--force` overwrites; `--sync` refreshes a running proxy in human-output mode. |
19-
| `edit <name>` | provider field flags, `--json` | Edit validated live provider fields without replacing key pools. |
19+
| `edit <name>` | provider field flags, `--headers <json>`, `--json` | Edit validated live provider fields without replacing key pools. `--headers` merges custom request headers; pass `{}` or `-` to clear them. |
2020
| `test <name>` | `--json` | Probe the real upstream model endpoint. |
2121
| `show <name>` | `--json` | Show config with API keys masked. |
2222
| `remove <name>` | `--json` | Remove a non-default provider; the last provider cannot be removed. |

‎docs-site/src/content/docs/reference/management-api.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -183,7 +183,7 @@ keys are not returned to dashboard clients.
183183
| --- | --- | --- |
184184
| `GET /api/providers` | List redacted provider configuration and discovery state | — |
185185
| `POST /api/providers` | Add or replace one validated provider and optionally make it default | 400 invalid/dangerous destination or config; 409 namespace collision |
186-
| `PATCH /api/providers?name=...` | Update allowed provider fields, enabled/default state, or OpenAI account mode | 400 invalid field or transition; 404 unknown provider |
186+
| `PATCH /api/providers?name=...` | Update allowed provider fields (including a merged `headers` block), enabled/default state, or OpenAI account mode | 400 invalid field or transition; 404 unknown provider |
187187
| `DELETE /api/providers?name=...` | Delete a provider, reassigning the default when possible | 404 unknown provider; 409 `last_provider`; 409 `provider_has_dependent_combos` |
188188
| `POST /api/providers/test?name=...` | Perform a bounded live provider connectivity/model-discovery probe | 404 unknown provider; failures are normally returned as `ok: false` evidence |
189189
| `GET /api/provider-quotas` | Read provider quota reports; `refresh=1` forces refresh | — |

‎docs-site/src/content/docs/ru/reference/cli/providers-accounts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ pool'ами и контролируют каталог моделей, кото
1717
| --- | --- | --- |
1818
| `list` | `--json` | Показать настроенных провайдеров и оставшиеся записи registry. |
1919
| `add <name>` | `--adapter <adapter>`, `--base-url <url>`, `--api-key <key>`, `--default-model <model>`, `--set-default`, `--force`, `--json`, `--sync` | Добавить registry/custom-провайдера. `--force` перезаписывает; `--sync` обновляет живой прокси в human-output mode. |
20-
| `edit <name>` | provider field flags, `--json` | Изменить валидированные live-поля провайдера, не заменяя key-pool'ы. |
20+
| `edit <name>` | provider field flags, `--headers <json>`, `--json` | Изменить валидированные live-поля провайдера, не заменяя key-pool'ы. `--headers` объединяет пользовательские request-header'ы; передайте `{}` или `-`, чтобы очистить их. |
2121
| `test <name>` | `--json` | Пробный запрос к реальному upstream model-endpoint'у. |
2222
| `show <name>` | `--json` | Показать конфиг с замаскированными API-key'ами. |
2323
| `remove <name>` | `--json` | Удалить не-default-провайдера; последний провайдер удалить нельзя. |

‎docs-site/src/content/docs/ru/reference/management-api.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,7 @@ Endpoint'ы storage cleanup могут перемещать или навсег
185185
| --- | --- | --- |
186186
| `GET /api/providers` | Список redacted provider config'ов и состояния discovery | — |
187187
| `POST /api/providers` | Добавить или заменить одного валидированного провайдера и при желании сделать его default | 400 invalid/dangerous destination or config; 409 namespace collision |
188-
| `PATCH /api/providers?name=...` | Обновить допустимые поля провайдера, enabled/default state или OpenAI account mode | 400 invalid field or transition; 404 unknown provider |
188+
| `PATCH /api/providers?name=...` | Обновить допустимые поля провайдера (включая объединяемый блок `headers`), enabled/default state или OpenAI account mode | 400 invalid field or transition; 404 unknown provider |
189189
| `DELETE /api/providers?name=...` | Удалить провайдера, при возможности переназначив default | 404 unknown provider; 409 `last_provider`; 409 `provider_has_dependent_combos` |
190190
| `POST /api/providers/test?name=...` | Выполнить ограниченный live-probe connectivity/model-discovery для провайдера | 404 unknown provider; сбои обычно возвращаются как evidence с `ok: false` |
191191
| `GET /api/provider-quotas` | Прочитать отчёты по provider quota; `refresh=1` форсирует refresh | — |

‎docs-site/src/content/docs/zh-cn/reference/cli/providers-accounts.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ description: 提供方配置、凭据、配额,以及模型目录命令。
1616
| --- | --- | --- |
1717
| `list` | `--json` | 列出已配置的提供方以及剩余的注册表条目。 |
1818
| `add <name>` | `--adapter <adapter>`, `--base-url <url>`, `--api-key <key>`, `--default-model <model>`, `--set-default`, `--force`, `--json`, `--sync` | 添加一个注册表/自定义提供方。`--force` 会覆盖;`--sync` 会在有人类输出模式运行的代理上刷新配置。 |
19-
| `edit <name>` | 提供方字段标志,`--json` | 在不替换密钥池的情况下,编辑经过校验的在线提供方字段。 |
19+
| `edit <name>` | 提供方字段标志,`--headers <json>`,`--json` | 在不替换密钥池的情况下,编辑经过校验的在线提供方字段。`--headers` 会合并自定义请求头;传入 `{}` 或 `-` 可清空。 |
2020
| `test <name>` | `--json` | 探测真实的上游模型端点。 |
2121
| `show <name>` | `--json` | 显示已屏蔽 API 密钥的配置。 |
2222
| `remove <name>` | `--json` | 移除一个非默认提供方;最后一个提供方不能被移除。 |

‎docs-site/src/content/docs/zh-cn/reference/management-api.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,7 +166,7 @@ Authorization: Bearer <admin-token>
166166
| --- | --- | --- |
167167
| `GET /api/providers` | 列出已脱敏的 provider 配置和发现状态 | — |
168168
| `POST /api/providers` | 添加或替换一个已验证的 provider,并可选地将其设为默认 | 400 目标或配置无效/危险;409 命名空间冲突 |
169-
| `PATCH /api/providers?name=...` | 更新允许的 provider 字段、启用/默认状态,或 OpenAI 账户模式 | 400 字段或转换无效;404 未知 provider |
169+
| `PATCH /api/providers?name=...` | 更新允许的 provider 字段(包括合并的 `headers` 块)、启用/默认状态,或 OpenAI 账户模式 | 400 字段或转换无效;404 未知 provider |
170170
| `DELETE /api/providers?name=...` | 删除一个 provider,并在可能时重新分配默认值 | 404 未知 provider;409 `last_provider`;409 `provider_has_dependent_combos` |
171171
| `POST /api/providers/test?name=...` | 执行一个有上限的在线 provider 连通性/模型发现探测 | 404 未知 provider;失败通常以 `ok: false` 证据返回 |
172172
| `GET /api/provider-quotas` | 读取 provider 配额报告;`refresh=1` 会强制刷新 | — |

0 commit comments

Comments
 (0)