release: 0.5.0-alpha.2 (#52)

Automated Release PR
---


## 0.5.0-alpha.2 (2026-02-05)

Full Changelog:
[v0.4.0-alpha.7...v0.5.0-alpha.2](v0.4.0-alpha.7...v0.5.0-alpha.2)

### Features

* add support for tool_choice to repsponses api
([8170d7f](8170d7f))
* Adds support for the `safety_identifier` parameter
([db2ebc6](db2ebc6))
* **api:** add readonly connectors API
([c810c19](c810c19))
* convert Benchmarks API to use FastAPI router
([bcc19bb](bcc19bb))
* convert Datasets API to use FastAPI router
([a52b7ee](a52b7ee))
* Implement include parameter specifically for adding logprobs in the
output message
([01f0ba8](01f0ba8))
* introduce /admin API for stack administration and operations
([2c9e2ab](2c9e2ab))
* migrate Inspect API to FastAPI router
([79f8d87](79f8d87))
* migrate Providers API to FastAPI router pattern
([22f7cf6](22f7cf6))


### Bug Fixes

* **mcp:** correct code tool API endpoint
([6006307](6006307))
* **mcp:** return correct lines on typescript errors
([368f4b5](368f4b5))


### Chores

* break long lines in snippets into multiline
([a3f9a49](a3f9a49))
* **ci:** upgrade `actions/github-script`
([8d32768](8d32768))
* clarify use of yarn for development and npm/yarn/pnpm for users
([#51](#51))
([b413eed](b413eed))
* **internal:** codegen related update
([c12b19b](c12b19b))
* **internal:** codegen related update
([db8b76f](db8b76f))
* **internal:** codegen related update
([9d4ee0f](9d4ee0f))
* **internal:** codegen related update
([b5ea21d](b5ea21d))
* **internal:** codegen related update
([d199aff](d199aff))
* **internal:** update `actions/checkout` version
([fe86770](fe86770))
* **internal:** upgrade babel, qs, js-yaml
([d318482](d318482))


### Documentation

* add more examples
([cc58d0d](cc58d0d))

---
This pull request is managed by Stainless's [GitHub
App](https://github.com/apps/stainless-app).

The [semver version
number](https://semver.org/#semantic-versioning-specification-semver) is
based on included [commit
messages](https://www.conventionalcommits.org/en/v1.0.0/).
Alternatively, you can manually set the version number in the title of
this pull request.

For a better experience, it is recommended to use either rebase-merge or
squash-merge when merging this pull request.

🔗 Stainless [website](https://www.stainlessapi.com)
📚 Read the [docs](https://app.stainlessapi.com/docs)
🙋 [Reach out](mailto:support@stainlessapi.com) for help or questions

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

Author: stainless-app[bot]

.github/workflows/ci.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/llama-stack-client-node' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -41,7 +41,7 @@ jobs:
       contents: read
       id-token: write
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4
@@ -57,7 +57,7 @@ jobs:
       - name: Get GitHub OIDC Token
         if: github.repository == 'stainless-sdks/llama-stack-client-node'
         id: github-oidc
-        uses: actions/github-script@v6
+        uses: actions/github-script@v8
         with:
           script: core.setOutput('github_token', await core.getIDToken());
 
@@ -74,7 +74,7 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/llama-stack-client-node' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Set up Node
         uses: actions/setup-node@v4

.github/workflows/release-doctor.yml

@@ -12,7 +12,7 @@ jobs:
     if: github.repository == 'llamastack/llama-stack-client-typescript' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch' || startsWith(github.head_ref, 'release-please') || github.head_ref == 'next')
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Check release environment
         run: |

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.4.0-alpha.7"
+  ".": "0.5.0-alpha.2"
 }

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 103
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-418ccf3126ab086a66c822c60204b95ef3192ffa64340bd3a1537ae46b830892.yml
-openapi_spec_hash: 885b75e847506a930b709eb630535912
-config_hash: 96aa17ff0395152d8d548b1d1e58b613
+configured_endpoints: 108
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/llamastack%2Fllama-stack-client-958e990011d6b4c27513743a151ec4c80c3103650a80027380d15f1d6b108e32.yml
+openapi_spec_hash: 5b49d825dbc2a26726ca752914a65114
+config_hash: 19b84a0a93d566334ae134dafc71991f

CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 0.5.0-alpha.2 (2026-02-05)
+
+Full Changelog: [v0.4.0-alpha.7...v0.5.0-alpha.2](https://github.com/llamastack/llama-stack-client-typescript/compare/v0.4.0-alpha.7...v0.5.0-alpha.2)
+
+### Features
+
+* add support for tool_choice to repsponses api ([8170d7f](https://github.com/llamastack/llama-stack-client-typescript/commit/8170d7f453cdc6263fe19ddf8e6cddc097b61780))
+* Adds support for the `safety_identifier` parameter ([db2ebc6](https://github.com/llamastack/llama-stack-client-typescript/commit/db2ebc6f214bebe06e329bbfa6509f93dbc47b69))
+* **api:** add readonly connectors API ([c810c19](https://github.com/llamastack/llama-stack-client-typescript/commit/c810c19d824604b34dab48d453bf1f19ac1ff66d))
+* convert Benchmarks API to use FastAPI router ([bcc19bb](https://github.com/llamastack/llama-stack-client-typescript/commit/bcc19bb3640fffce18a128c042f11b695c8f7a6d))
+* convert Datasets API to use FastAPI router ([a52b7ee](https://github.com/llamastack/llama-stack-client-typescript/commit/a52b7ee0bd64a843134b2354e95502da2fe55f66))
+* Implement include parameter specifically for adding logprobs in the output message ([01f0ba8](https://github.com/llamastack/llama-stack-client-typescript/commit/01f0ba8970e6c1a729dd872cf228376fddd5f3fe))
+* introduce /admin API for stack administration and operations ([2c9e2ab](https://github.com/llamastack/llama-stack-client-typescript/commit/2c9e2ab11a42bb2192370880781e2faee633c17c))
+* migrate Inspect API to FastAPI router ([79f8d87](https://github.com/llamastack/llama-stack-client-typescript/commit/79f8d87b64a243c782c5a9eb5b62d31378781f36))
+* migrate Providers API to FastAPI router pattern ([22f7cf6](https://github.com/llamastack/llama-stack-client-typescript/commit/22f7cf60f463db6091bf213a630ac48bb1f12e49))
+
+
+### Bug Fixes
+
+* **mcp:** correct code tool API endpoint ([6006307](https://github.com/llamastack/llama-stack-client-typescript/commit/60063077b65f31a31dabf254dbcfae50909cd692))
+* **mcp:** return correct lines on typescript errors ([368f4b5](https://github.com/llamastack/llama-stack-client-typescript/commit/368f4b50eb87213ab27f43a161df688d3cba4f62))
+
+
+### Chores
+
+* break long lines in snippets into multiline ([a3f9a49](https://github.com/llamastack/llama-stack-client-typescript/commit/a3f9a49ec9ae6ce575a355888d0332643b314fff))
+* **ci:** upgrade `actions/github-script` ([8d32768](https://github.com/llamastack/llama-stack-client-typescript/commit/8d327684ea36362d0b06b297d8a7355353800298))
+* clarify use of yarn for development and npm/yarn/pnpm for users ([#51](https://github.com/llamastack/llama-stack-client-typescript/issues/51)) ([b413eed](https://github.com/llamastack/llama-stack-client-typescript/commit/b413eedc57a6666df5aa98af4c8726a468cb77ec))
+* **internal:** codegen related update ([c12b19b](https://github.com/llamastack/llama-stack-client-typescript/commit/c12b19b37e47e9982a99ea1f4ba7d0a92ff61f1f))
+* **internal:** codegen related update ([db8b76f](https://github.com/llamastack/llama-stack-client-typescript/commit/db8b76f2ca7761bf0b71fcf548d24e93b83014e0))
+* **internal:** codegen related update ([9d4ee0f](https://github.com/llamastack/llama-stack-client-typescript/commit/9d4ee0f21db979f28ac2008f37b02a70e72094ff))
+* **internal:** codegen related update ([b5ea21d](https://github.com/llamastack/llama-stack-client-typescript/commit/b5ea21d0dcf0a71a49420efdf721f21254b9a0ce))
+* **internal:** codegen related update ([d199aff](https://github.com/llamastack/llama-stack-client-typescript/commit/d199aff3d638854e58ae5575979d2c7f57eebc10))
+* **internal:** update `actions/checkout` version ([fe86770](https://github.com/llamastack/llama-stack-client-typescript/commit/fe867703d0446b015c6c59a62ae9e9b29161aca3))
+* **internal:** upgrade babel, qs, js-yaml ([d318482](https://github.com/llamastack/llama-stack-client-typescript/commit/d318482504fd85a956d3a382ba8113fedfb8416c))
+
+
+### Documentation
+
+* add more examples ([cc58d0d](https://github.com/llamastack/llama-stack-client-typescript/commit/cc58d0d59eda97e5fbad6b6daea0272dcbb189cb))
+
 ## 0.4.0-alpha.7 (2025-12-03)
 
 Full Changelog: [v0.4.0-alpha.6...v0.4.0-alpha.7](https://github.com/llamastack/llama-stack-client-typescript/compare/v0.4.0-alpha.6...v0.4.0-alpha.7)

LICENSE

@@ -1,4 +1,4 @@
-Copyright 2025 llama-stack-client
+Copyright 2026 llama-stack-client
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

README.md

@@ -30,28 +30,6 @@ const client = new LlamaStackClient();
 const models = await client.models.list();
 ```
 
-## Streaming responses
-
-We provide support for streaming responses using Server Sent Events (SSE).
-
-```ts
-import LlamaStackClient from 'llama-stack-client';
-
-const client = new LlamaStackClient();
-
-const stream = await client.chat.completions.create({
-  messages: [{ content: 'string', role: 'user' }],
-  model: 'model',
-  stream: true,
-});
-for await (const chatCompletionChunk of stream) {
-  console.log(chatCompletionChunk.id);
-}
-```
-
-If you need to cancel a stream, you can `break` from the loop
-or call `stream.controller.abort()`.
-
 ### Request & Response types
 
 This library includes TypeScript definitions for all request params and response fields. You may import and use them like so:
@@ -66,9 +44,8 @@ const params: LlamaStackClient.Chat.CompletionCreateParams = {
   messages: [{ content: 'string', role: 'user' }],
   model: 'model',
 };
-const completion: LlamaStackClient.Chat.CompletionCreateResponse = await client.chat.completions.create(
-  params,
-);
+const completion: LlamaStackClient.Chat.CompletionCreateResponse =
+  await client.chat.completions.create(params);
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -99,8 +76,14 @@ await client.files.create({ file: new File(['my bytes'], 'file'), purpose: 'assi
 await client.files.create({ file: await fetch('https://somesite/file'), purpose: 'assistants' });
 
 // Finally, if none of the above are convenient, you can use our `toFile` helper:
-await client.files.create({ file: await toFile(Buffer.from('my bytes'), 'file'), purpose: 'assistants' });
-await client.files.create({ file: await toFile(new Uint8Array([0, 1, 2]), 'file'), purpose: 'assistants' });
+await client.files.create({
+  file: await toFile(Buffer.from('my bytes'), 'file'),
+  purpose: 'assistants',
+});
+await client.files.create({
+  file: await toFile(new Uint8Array([0, 1, 2]), 'file'),
+  purpose: 'assistants',
+});
 ```
 
 ## Handling errors
@@ -179,6 +162,37 @@ On timeout, an `APIConnectionTimeoutError` is thrown.
 
 Note that requests which time out will be [retried twice by default](#retries).
 
+## Auto-pagination
+
+List methods in the LlamaStackClient API are paginated.
+You can use the `for await … of` syntax to iterate through items across all pages:
+
+```ts
+async function fetchAllResponseListResponses(params) {
+  const allResponseListResponses = [];
+  // Automatically fetches more pages as needed.
+  for await (const responseListResponse of client.responses.list()) {
+    allResponseListResponses.push(responseListResponse);
+  }
+  return allResponseListResponses;
+}
+```
+
+Alternatively, you can request a single page at a time:
+
+```ts
+let page = await client.responses.list();
+for (const responseListResponse of page.data) {
+  console.log(responseListResponse);
+}
+
+// Convenience methods are provided for manually paginating:
+while (page.hasNextPage()) {
+  page = await page.getNextPage();
+  // ...
+}
+```
+
 ## Advanced Usage
 
 ### Accessing raw Response data (e.g., headers)

api.md

@@ -2,13 +2,19 @@
 
 Types:
 
+- <code><a href="./src/resources/shared.ts">HealthInfo</a></code>
 - <code><a href="./src/resources/shared.ts">InterleavedContent</a></code>
 - <code><a href="./src/resources/shared.ts">InterleavedContentItem</a></code>
+- <code><a href="./src/resources/shared.ts">ListProvidersResponse</a></code>
+- <code><a href="./src/resources/shared.ts">ListRoutesResponse</a></code>
 - <code><a href="./src/resources/shared.ts">ParamType</a></code>
+- <code><a href="./src/resources/shared.ts">ProviderInfo</a></code>
+- <code><a href="./src/resources/shared.ts">RouteInfo</a></code>
 - <code><a href="./src/resources/shared.ts">SafetyViolation</a></code>
 - <code><a href="./src/resources/shared.ts">SamplingParams</a></code>
 - <code><a href="./src/resources/shared.ts">ScoringResult</a></code>
 - <code><a href="./src/resources/shared.ts">SystemMessage</a></code>
+- <code><a href="./src/resources/shared.ts">VersionInfo</a></code>
 
 # Toolgroups
 
@@ -87,10 +93,10 @@ Methods:
 
 - <code title="post /v1/prompts">client.prompts.<a href="./src/resources/prompts/prompts.ts">create</a>({ ...params }) -> Prompt</code>
 - <code title="get /v1/prompts/{prompt_id}">client.prompts.<a href="./src/resources/prompts/prompts.ts">retrieve</a>(promptId, { ...params }) -> Prompt</code>
-- <code title="post /v1/prompts/{prompt_id}">client.prompts.<a href="./src/resources/prompts/prompts.ts">update</a>(promptId, { ...params }) -> Prompt</code>
+- <code title="put /v1/prompts/{prompt_id}">client.prompts.<a href="./src/resources/prompts/prompts.ts">update</a>(promptId, { ...params }) -> Prompt</code>
 - <code title="get /v1/prompts">client.prompts.<a href="./src/resources/prompts/prompts.ts">list</a>() -> PromptListResponse</code>
 - <code title="delete /v1/prompts/{prompt_id}">client.prompts.<a href="./src/resources/prompts/prompts.ts">delete</a>(promptId) -> void</code>
-- <code title="post /v1/prompts/{prompt_id}/set-default-version">client.prompts.<a href="./src/resources/prompts/prompts.ts">setDefaultVersion</a>(promptId, { ...params }) -> Prompt</code>
+- <code title="put /v1/prompts/{prompt_id}/set-default-version">client.prompts.<a href="./src/resources/prompts/prompts.ts">setDefaultVersion</a>(promptId, { ...params }) -> Prompt</code>
 
 ## Versions
 
@@ -130,13 +136,6 @@ Methods:
 
 # Inspect
 
-Types:
-
-- <code><a href="./src/resources/inspect.ts">HealthInfo</a></code>
-- <code><a href="./src/resources/inspect.ts">ProviderInfo</a></code>
-- <code><a href="./src/resources/inspect.ts">RouteInfo</a></code>
-- <code><a href="./src/resources/inspect.ts">VersionInfo</a></code>
-
 Methods:
 
 - <code title="get /v1/health">client.inspect.<a href="./src/resources/inspect.ts">health</a>() -> HealthInfo</code>
@@ -269,7 +268,6 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/providers.ts">ListProvidersResponse</a></code>
 - <code><a href="./src/resources/providers.ts">ProviderListResponse</a></code>
 
 Methods:
@@ -281,7 +279,6 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/routes.ts">ListRoutesResponse</a></code>
 - <code><a href="./src/resources/routes.ts">RouteListResponse</a></code>
 
 Methods:
@@ -386,21 +383,12 @@ Methods:
 
 # Alpha
 
-## Inference
-
-Types:
-
-- <code><a href="./src/resources/alpha/inference.ts">InferenceRerankResponse</a></code>
-
-Methods:
-
-- <code title="post /v1alpha/inference/rerank">client.alpha.inference.<a href="./src/resources/alpha/inference.ts">rerank</a>({ ...params }) -> InferenceRerankResponse</code>
-
 ## PostTraining
 
 Types:
 
 - <code><a href="./src/resources/alpha/post-training/post-training.ts">AlgorithmConfig</a></code>
+- <code><a href="./src/resources/alpha/post-training/post-training.ts">ListPostTrainingJobsResponse</a></code>
 - <code><a href="./src/resources/alpha/post-training/post-training.ts">PostTrainingJob</a></code>
 
 Methods:
@@ -412,17 +400,16 @@ Methods:
 
 Types:
 
-- <code><a href="./src/resources/alpha/post-training/job.ts">ListPostTrainingJobsResponse</a></code>
 - <code><a href="./src/resources/alpha/post-training/job.ts">JobListResponse</a></code>
 - <code><a href="./src/resources/alpha/post-training/job.ts">JobArtifactsResponse</a></code>
 - <code><a href="./src/resources/alpha/post-training/job.ts">JobStatusResponse</a></code>
 
 Methods:
 
 - <code title="get /v1alpha/post-training/jobs">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">list</a>() -> JobListResponse</code>
-- <code title="get /v1alpha/post-training/job/artifacts">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">artifacts</a>({ ...params }) -> JobArtifactsResponse</code>
-- <code title="post /v1alpha/post-training/job/cancel">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">cancel</a>({ ...params }) -> void</code>
-- <code title="get /v1alpha/post-training/job/status">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">status</a>({ ...params }) -> JobStatusResponse</code>
+- <code title="get /v1alpha/post-training/job/artifacts">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">artifacts</a>() -> JobArtifactsResponse</code>
+- <code title="post /v1alpha/post-training/job/cancel">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">cancel</a>() -> void</code>
+- <code title="get /v1alpha/post-training/job/status">client.alpha.postTraining.job.<a href="./src/resources/alpha/post-training/job.ts">status</a>() -> JobStatusResponse</code>
 
 ## Benchmarks
 
@@ -462,6 +449,26 @@ Methods:
 - <code title="delete /v1alpha/eval/benchmarks/{benchmark_id}/jobs/{job_id}">client.alpha.eval.jobs.<a href="./src/resources/alpha/eval/jobs.ts">cancel</a>(benchmarkId, jobId) -> void</code>
 - <code title="get /v1alpha/eval/benchmarks/{benchmark_id}/jobs/{job_id}">client.alpha.eval.jobs.<a href="./src/resources/alpha/eval/jobs.ts">status</a>(benchmarkId, jobId) -> Job</code>
 
+## Admin
+
+Methods:
+
+- <code title="get /v1alpha/admin/health">client.alpha.admin.<a href="./src/resources/alpha/admin.ts">health</a>() -> HealthInfo</code>
+- <code title="get /v1alpha/admin/providers/{provider_id}">client.alpha.admin.<a href="./src/resources/alpha/admin.ts">inspectProvider</a>(providerId) -> ProviderInfo</code>
+- <code title="get /v1alpha/admin/providers">client.alpha.admin.<a href="./src/resources/alpha/admin.ts">listProviders</a>() -> ProviderListResponse</code>
+- <code title="get /v1alpha/admin/inspect/routes">client.alpha.admin.<a href="./src/resources/alpha/admin.ts">listRoutes</a>({ ...params }) -> RouteListResponse</code>
+- <code title="get /v1alpha/admin/version">client.alpha.admin.<a href="./src/resources/alpha/admin.ts">version</a>() -> VersionInfo</code>
+
+## Inference
+
+Types:
+
+- <code><a href="./src/resources/alpha/inference.ts">InferenceRerankResponse</a></code>
+
+Methods:
+
+- <code title="post /v1alpha/inference/rerank">client.alpha.inference.<a href="./src/resources/alpha/inference.ts">rerank</a>({ ...params }) -> InferenceRerankResponse</code>
+
 # Beta
 
 ## Datasets

package.json

@@ -1,6 +1,6 @@
 {
   "name": "llama-stack-client",
-  "version": "0.4.0-alpha.7",
+  "version": "0.5.0-alpha.2",
   "description": "The official TypeScript library for the Llama Stack Client API",
   "author": "Llama Stack Client <llamastack@meta.com>",
   "types": "dist/index.d.ts",

src/core.ts

@@ -90,6 +90,12 @@ async function defaultParseResponse<T>(props: APIResponseProps): Promise<T> {
   const mediaType = contentType?.split(';')[0]?.trim();
   const isJSON = mediaType?.includes('application/json') || mediaType?.endsWith('+json');
   if (isJSON) {
+    const contentLength = response.headers.get('content-length');
+    if (contentLength === '0') {
+      // if there is no content we can't do anything
+      return undefined as T;
+    }
+
     const json = await response.json();
 
     debug('response', response.status, response.url, response.headers, json);