feat: introduce /admin API for stack administration and operations #4327
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
meta-cla
bot
added
the
CLA Signed
cdoern
force-pushed
the
admin
branch
5 times, most recently
from
fcad6ec to
453a7f1
Compare
Collaborator
Author
|
ideally we should be able to write tests in this PR once #4360 merges |
cdoern
force-pushed
the
admin
branch
5 times, most recently
from
272d963 to
51babfb
Compare
Contributor
✱ Stainless preview buildsThis PR will update the Edit this comment to update it. It will appear in the SDK's changelogs.
|
⚠️ llama-stack-client-kotlin studio · code · diff
There was a regression in your SDK.
generate ⚠️→lint ✅→test ❗New diagnostics (1 warning)
⚠️ Method/PaginatedWithoutMatchingScheme: `(resource) alpha.admin > (method) list_routes` is paginated, but does not match any [pagination scheme](https://www.stainless.com/docs/guides/configure#pagination), so it will not be interpreted as paginated.
⚠️ llama-stack-client-go studio · code · diff
There was a regression in your SDK.
generate ❗→lint ❗→test ❗go get github.com/stainless-sdks/llama-stack-client-go@00014ef0e0f2042d641b54412d4d354cc8a8091cNew diagnostics (1 warning)
⚠️ Method/PaginatedWithoutMatchingScheme: `(resource) alpha.admin > (method) list_routes` is paginated, but does not match any [pagination scheme](https://www.stainless.com/docs/guides/configure#pagination), so it will not be interpreted as paginated.
⚠️ llama-stack-client-python studio · code · diff
There was a regression in your SDK.
generate ⚠️→build ✅→lint ✅→test ✅pip install https://pkg.stainless.com/s/llama-stack-client-python/fe4725fe920b5ab8a189c91357338fe81c9432a9/llama_stack_client-0.4.0a13-py3-none-any.whlNew diagnostics (1 warning)
⚠️ Method/PaginatedWithoutMatchingScheme: `(resource) alpha.admin > (method) list_routes` is paginated, but does not match any [pagination scheme](https://www.stainless.com/docs/guides/configure#pagination), so it will not be interpreted as paginated.
This comment is auto-generated by GitHub Actions and is automatically kept up to date as you push.
Last updated: 2025-12-17 00:39:25 UTC
- Add new /admin API (v1alpha) for administrative operations including provider management, health checks, version info, and route listing
- Implement using FastAPI routers following batches pattern with proper request/response models
- Endpoints: /admin/providers, /admin/providers/{id}, /admin/inspect/routes, /admin/health, /admin/version
- Create admin module structure: models.py, api.py, fastapi_routes.py, __init__.py
- Add AdminImpl in llama_stack/core combining provider and inspect functionality
- Deprecate standalone /providers and /inspect APIs (remain functional for backward compatibility)
- Consolidate duplicate types: ProviderInfo, HealthInfo, RouteInfo, etc. now defined once in admin.models
- Test new API using Stainless SDK in integration tests
Signed-off-by: Charlie Doern <[email protected]>
Collaborator
Author
we will always need to record the missing json for net new APIs like this one. use record-if-missing Signed-off-by: Charlie Doern <[email protected]>
Collaborator
Author
|
closing, opening on upstream branch so I can make workflow changes. sorry for the churn. |
Collaborator
Author
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What does this PR do?
resolves #4303
Test Plan
WIP