mirror of
https://github.com/meta-llama/llama-stack.git
synced 2025-12-03 09:53:45 +00:00
840ad75fe9
# What does this PR do? Extract API definitions and provider specifications into a standalone llama-stack-api package that can be published to PyPI independently of the main llama-stack server. see: https://github.com/llamastack/llama-stack/pull/2978 and https://github.com/llamastack/llama-stack/pull/2978#issuecomment-3145115942 Motivation External providers currently import from llama-stack, which overrides the installed version and causes dependency conflicts. This separation allows external providers to: - Install only the type definitions they need without server dependencies - Avoid version conflicts with the installed llama-stack package - Be versioned and released independently This enables us to re-enable external provider module tests that were previously blocked by these import conflicts. Changes - Created llama-stack-api package with minimal dependencies (pydantic, jsonschema) - Moved APIs, providers datatypes, strong_typing, and schema_utils - Updated all imports from llama_stack.* to llama_stack_api.* - Configured local editable install for development workflow - Updated linting and type-checking configuration for both packages Next Steps - Publish llama-stack-api to PyPI - Update external provider dependencies - Re-enable external provider module tests Pre-cursor PRs to this one: - #4093 - #3954 - #4064 These PRs moved key pieces _out_ of the Api pkg, limiting the scope of change here. relates to #3237 ## Test Plan Package builds successfully and can be imported independently. All pre-commit hooks pass with expected exclusions maintained. --------- Signed-off-by: Charlie Doern <cdoern@redhat.com>
98 lines
3.6 KiB
Python
98 lines
3.6 KiB
Python
# Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
# All rights reserved.
|
|
#
|
|
# This source code is licensed under the terms described in the LICENSE file in
|
|
# the root directory of this source tree.
|
|
|
|
from importlib.metadata import version
|
|
|
|
from llama_stack_api import (
|
|
HealthInfo,
|
|
HealthStatus,
|
|
Inspect,
|
|
ListRoutesResponse,
|
|
RouteInfo,
|
|
VersionInfo,
|
|
)
|
|
from pydantic import BaseModel
|
|
|
|
from llama_stack.core.datatypes import StackRunConfig
|
|
from llama_stack.core.external import load_external_apis
|
|
from llama_stack.core.server.routes import get_all_api_routes
|
|
|
|
|
|
class DistributionInspectConfig(BaseModel):
|
|
run_config: StackRunConfig
|
|
|
|
|
|
async def get_provider_impl(config, deps):
|
|
impl = DistributionInspectImpl(config, deps)
|
|
await impl.initialize()
|
|
return impl
|
|
|
|
|
|
class DistributionInspectImpl(Inspect):
|
|
def __init__(self, config: DistributionInspectConfig, deps):
|
|
self.config = config
|
|
self.deps = deps
|
|
|
|
async def initialize(self) -> None:
|
|
pass
|
|
|
|
async def list_routes(self, api_filter: str | None = None) -> ListRoutesResponse:
|
|
run_config: StackRunConfig = self.config.run_config
|
|
|
|
# Helper function to determine if a route should be included based on api_filter
|
|
def should_include_route(webmethod) -> bool:
|
|
if api_filter is None:
|
|
# Default: only non-deprecated APIs
|
|
return not webmethod.deprecated
|
|
elif api_filter == "deprecated":
|
|
# Special filter: show deprecated routes regardless of their actual level
|
|
return bool(webmethod.deprecated)
|
|
else:
|
|
# Filter by API level (non-deprecated routes only)
|
|
return not webmethod.deprecated and webmethod.level == api_filter
|
|
|
|
ret = []
|
|
external_apis = load_external_apis(run_config)
|
|
all_endpoints = get_all_api_routes(external_apis)
|
|
for api, endpoints in all_endpoints.items():
|
|
# Always include provider and inspect APIs, filter others based on run config
|
|
if api.value in ["providers", "inspect"]:
|
|
ret.extend(
|
|
[
|
|
RouteInfo(
|
|
route=e.path,
|
|
method=next(iter([m for m in e.methods if m != "HEAD"])),
|
|
provider_types=[], # These APIs don't have "real" providers - they're internal to the stack
|
|
)
|
|
for e, webmethod in endpoints
|
|
if e.methods is not None and should_include_route(webmethod)
|
|
]
|
|
)
|
|
else:
|
|
providers = run_config.providers.get(api.value, [])
|
|
if providers: # Only process if there are providers for this API
|
|
ret.extend(
|
|
[
|
|
RouteInfo(
|
|
route=e.path,
|
|
method=next(iter([m for m in e.methods if m != "HEAD"])),
|
|
provider_types=[p.provider_type for p in providers],
|
|
)
|
|
for e, webmethod in endpoints
|
|
if e.methods is not None and should_include_route(webmethod)
|
|
]
|
|
)
|
|
|
|
return ListRoutesResponse(data=ret)
|
|
|
|
async def health(self) -> HealthInfo:
|
|
return HealthInfo(status=HealthStatus.OK)
|
|
|
|
async def version(self) -> VersionInfo:
|
|
return VersionInfo(version=version("llama-stack"))
|
|
|
|
async def shutdown(self) -> None:
|
|
pass
|