phoenix-oss/llama-stack-mirror
0
0
Fork 1
mirror of https://github.com/meta-llama/llama-stack.git synced 2025-10-24 00:47:00 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Revert "docs: API docstrings cleanup for better documentation rendering (#3661)"

Browse source 
This reverts commit a8da6ba3a7.
This commit is contained in:
Francisco Arceo 2025-10-07 10:18:47 -04:00 • committed by GitHub
parent 6389bf5ffb
commit 1b7e893cb5
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
17 changed files with 414 additions and 614 deletions
Download patch file Download diff file Expand all files Collapse all files

205
docs/static/stainless-llama-stack-spec.yaml vendored
View file

@ -36,8 +36,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inference
summary: List chat completions.
description: List chat completions.
summary: List all chat completions.
description: List all chat completions.
parameters:
- name: after
in: query
@ -90,10 +90,10 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inference
summary: Create chat completions.
summary: >-
Generate an OpenAI-compatible chat completion for the given messages using
the specified model.
description: >-
Create chat completions.
Generate an OpenAI-compatible chat completion for the given messages using
the specified model.
parameters: []
@ -125,11 +125,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inference
summary: Get chat completion.
description: >-
Get chat completion.
Describe a chat completion by its ID.
summary: Describe a chat completion by its ID.
description: Describe a chat completion by its ID.
parameters:
- name: completion_id
in: path
@ -159,10 +156,10 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inference
summary: Create completion.
summary: >-
Generate an OpenAI-compatible completion for the given prompt using the specified
model.
description: >-
Create completion.
Generate an OpenAI-compatible completion for the given prompt using the specified
model.
parameters: []
@ -609,10 +606,10 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inference
summary: Create embeddings.
summary: >-
Generate OpenAI-compatible embeddings for the given input using the specified
model.
description: >-
Create embeddings.
Generate OpenAI-compatible embeddings for the given input using the specified
model.
parameters: []
@ -645,10 +642,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Files
summary: List files.
summary: >-
Returns a list of files that belong to the user's organization.
description: >-
List files.
Returns a list of files that belong to the user's organization.
parameters:
- name: after
@ -706,12 +702,10 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Files
summary: Upload file.
description: >-
Upload file.
summary: >-
Upload a file that can be used across various endpoints.
description: >-
Upload a file that can be used across various endpoints.
The file upload should be a multipart form request with:
@ -761,10 +755,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Files
summary: Retrieve file.
summary: >-
Returns information about a specific file.
description: >-
Retrieve file.
Returns information about a specific file.
parameters:
- name: file_id
@ -796,8 +789,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Files
summary: Delete file.
description: Delete file.
summary: Delete a file.
description: Delete a file.
parameters:
- name: file_id
in: path
@ -829,10 +822,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Files
summary: Retrieve file content.
summary: >-
Returns the contents of the specified file.
description: >-
Retrieve file content.
Returns the contents of the specified file.
parameters:
- name: file_id
@ -865,10 +857,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inspect
summary: Get health status.
summary: >-
Get the current health status of the service.
description: >-
Get health status.
Get the current health status of the service.
parameters: []
deprecated: false
@ -894,10 +885,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inspect
summary: List routes.
summary: >-
List all available API routes with their methods and implementing providers.
description: >-
List routes.
List all available API routes with their methods and implementing providers.
parameters: []
deprecated: false
@ -946,11 +936,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Models
summary: Register model.
description: >-
Register model.
Register a model.
summary: Register a model.
description: Register a model.
parameters: []
requestBody:
content:
@ -980,11 +967,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Models
summary: Get model.
description: >-
Get model.
Get a model by its identifier.
summary: Get a model by its identifier.
description: Get a model by its identifier.
parameters:
- name: model_id
in: path
@ -1009,11 +993,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Models
summary: Unregister model.
description: >-
Unregister model.
Unregister a model.
summary: Unregister a model.
description: Unregister a model.
parameters:
- name: model_id
in: path
@ -1044,10 +1025,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Safety
summary: Create moderation.
summary: >-
Classifies if text and/or image inputs are potentially harmful.
description: >-
Create moderation.
Classifies if text and/or image inputs are potentially harmful.
parameters: []
requestBody:
@ -1103,11 +1083,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Prompts
summary: Create prompt.
description: >-
Create prompt.
Create a new prompt.
summary: Create a new prompt.
description: Create a new prompt.
parameters: []
requestBody:
content:
@ -1137,10 +1114,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Prompts
summary: Get prompt.
summary: >-
Get a prompt by its identifier and optional version.
description: >-
Get prompt.
Get a prompt by its identifier and optional version.
parameters:
- name: prompt_id
@ -1178,10 +1154,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Prompts
summary: Update prompt.
summary: >-
Update an existing prompt (increments version).
description: >-
Update prompt.
Update an existing prompt (increments version).
parameters:
- name: prompt_id
@ -1213,11 +1188,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Prompts
summary: Delete prompt.
description: >-
Delete prompt.
Delete a prompt.
summary: Delete a prompt.
description: Delete a prompt.
parameters:
- name: prompt_id
in: path
@ -1248,10 +1220,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Prompts
summary: Set prompt version.
summary: >-
Set which version of a prompt should be the default in get_prompt (latest).
description: >-
Set prompt version.
Set which version of a prompt should be the default in get_prompt (latest).
parameters:
- name: prompt_id
@ -1289,11 +1260,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Prompts
summary: List prompt versions.
description: >-
List prompt versions.
List all versions of a specific prompt.
summary: List all versions of a specific prompt.
description: List all versions of a specific prompt.
parameters:
- name: prompt_id
in: path
@ -1325,11 +1293,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Providers
summary: List providers.
description: >-
List providers.
List all available providers.
summary: List all available providers.
description: List all available providers.
parameters: []
deprecated: false
/v1/providers/{provider_id}:
@ -1354,10 +1319,9 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Providers
summary: Get provider.
summary: >-
Get detailed information about a specific provider.
description: >-
Get provider.
Get detailed information about a specific provider.
parameters:
- name: provider_id
@ -1388,8 +1352,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Agents
summary: List all responses.
description: List all responses.
summary: List all OpenAI responses.
description: List all OpenAI responses.
parameters:
- name: after
in: query
@ -1440,8 +1404,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Agents
summary: Create a model response.
description: Create a model response.
summary: Create a new OpenAI response.
description: Create a new OpenAI response.
parameters: []
requestBody:
content:
@ -1483,8 +1447,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Agents
summary: Get a model response.
description: Get a model response.
summary: Retrieve an OpenAI response by its ID.
description: Retrieve an OpenAI response by its ID.
parameters:
- name: response_id
in: path
@ -1514,8 +1478,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Agents
summary: Delete a response.
description: Delete a response.
summary: Delete an OpenAI response by its ID.
description: Delete an OpenAI response by its ID.
parameters:
- name: response_id
in: path
@ -1545,8 +1509,10 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Agents
summary: List input items.
description: List input items.
summary: >-
List input items for a given OpenAI response.
description: >-
List input items for a given OpenAI response.
parameters:
- name: response_id
in: path
@ -1615,11 +1581,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Safety
summary: Run shield.
description: >-
Run shield.
Run a shield.
summary: Run a shield.
description: Run a shield.
parameters: []
requestBody:
content:
@ -3175,11 +3138,8 @@ paths:
$ref: '#/components/responses/DefaultError'
tags:
- Inspect
summary: Get version.
description: >-
Get version.
Get the version of the service.
summary: Get the version of the service.
description: Get the version of the service.
parameters: []
deprecated: false
/v1beta/datasetio/append-rows/{dataset_id}:
@ -13835,16 +13795,9 @@ tags:
x-displayName: >-
Llama Stack Evaluation API for running evaluations on model and agent candidates.
- name: Files
description: >-
This API is used to upload documents that can be used with other Llama Stack
APIs.
x-displayName: Files
description: ''
- name: Inference
description: >-
Llama Stack Inference API for generating completions, chat completions, and
embeddings.
This API provides the raw interface to the underlying models. Two kinds of models
are supported:
@ -13852,27 +13805,25 @@ tags:
- Embedding models: these models generate embeddings to be used for semantic
search.
x-displayName: Inference
x-displayName: >-
Llama Stack Inference API for generating completions, chat completions, and
embeddings.
- name: Inspect
description: >-
APIs for inspecting the Llama Stack service, including health status, available
API routes with methods and implementing providers.
x-displayName: Inspect
description: ''
- name: Models
description: ''
- name: PostTraining (Coming Soon)
description: ''
- name: Prompts
description: >-
description: ''
x-displayName: >-
Protocol for prompt management operations.
x-displayName: Prompts
- name: Providers
description: >-
description: ''
x-displayName: >-
Providers API for inspecting, listing, and modifying providers and their configurations.
x-displayName: Providers
- name: Safety
description: OpenAI-compatible Moderations API.
x-displayName: Safety
description: ''
- name: Scoring
description: ''
- name: ScoringFunctions