digitalocean · stainless-app · Nov 3, 2025 · Nov 20, 2025 · Dec 1, 2025 · Dec 2, 2025
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.1.0-alpha.2"
+  ".": "0.1.0-alpha.3"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 175
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/digitalocean%2Fgradient-cb3bf9b21459cad24410206c27a32fd31ef6cf86711700597549dbbd0d634002.yml
-openapi_spec_hash: 6a9149a81ba15e7c5c5c1f4d77daad92
-config_hash: bad49c3bf949d5168ec3896bedff253a
+configured_endpoints: 188
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/digitalocean%2Fgradient-f07d74847e620dfa26d8df40ea4680814af9bba381b3a57a7b6ed76ad49d85f8.yml
+openapi_spec_hash: e3553dc2abf2afd4368b736bcc32a289
+config_hash: b28984dd49d4baf1d68572efe83ac103
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,37 @@
 # Changelog
 
+## 0.1.0-alpha.3 (2025-12-05)
+
+Full Changelog: [v0.1.0-alpha.2...v0.1.0-alpha.3](https://github.com/digitalocean/gradient-typescript/compare/v0.1.0-alpha.2...v0.1.0-alpha.3)
+
+### Features
+
+* add waitForAgentReady helper for agent deployment polling ([#9](https://github.com/digitalocean/gradient-typescript/issues/9)) ([48a9366](https://github.com/digitalocean/gradient-typescript/commit/48a9366dbb8879bb6a4be7b59a6bba26840d50d9))
+* **api:** include indexing jobs ([b283f6f](https://github.com/digitalocean/gradient-typescript/commit/b283f6f123067b864841df1eb21e5f1d6da51c93))
+* **api:** manual updates ([8438034](https://github.com/digitalocean/gradient-typescript/commit/84380346540b47a0ca718615203a977cce8a4fd5))
+* knowledge base indexing poller ([#14](https://github.com/digitalocean/gradient-typescript/issues/14)) ([04e35f0](https://github.com/digitalocean/gradient-typescript/commit/04e35f0553c622fe33b422f611bb7f1592346510))
+* **knowledge-bases:** add waitForDatabase polling helper ([#8](https://github.com/digitalocean/gradient-typescript/issues/8)) ([12d1af3](https://github.com/digitalocean/gradient-typescript/commit/12d1af3c82962f420eef7160b8ac043aa96087f7))
+
+
+### Bug Fixes
+
+* **mcp:** correct code tool API endpoint ([5f8590e](https://github.com/digitalocean/gradient-typescript/commit/5f8590e624c7ccb2f6828716da50348854c60df5))
+* **mcp:** return correct lines on typescript errors ([8319037](https://github.com/digitalocean/gradient-typescript/commit/8319037b19e6053a35eb81458d031db739e83e19))
+
+
+### Chores
+
+* **client:** fix logger property type ([8fd08d8](https://github.com/digitalocean/gradient-typescript/commit/8fd08d8830ec5a7443751eaf33eb11b6bf12114e))
+* formatting fixes ([b2388ec](https://github.com/digitalocean/gradient-typescript/commit/b2388ec757d21bdb00365969af5b083ae1e574b0))
+* **internal:** codegen related update ([7f7aade](https://github.com/digitalocean/gradient-typescript/commit/7f7aade29a94a1ea9284b1f63967c94b33c6d6b4))
+* **internal:** codegen related update ([7e9ea70](https://github.com/digitalocean/gradient-typescript/commit/7e9ea70cca7d7cc04be9e3981461972c51bfc89f))
+* **internal:** upgrade eslint ([e5f9760](https://github.com/digitalocean/gradient-typescript/commit/e5f976075b297f41de5b8280aefa231c5eecf750))
+
+
+### Refactors
+
+* normalize wait-for implementations ([#20](https://github.com/digitalocean/gradient-typescript/issues/20)) ([30419d1](https://github.com/digitalocean/gradient-typescript/commit/30419d1f1b238a5d2fcb4720c9599c66daa78ce9))
+
 ## 0.1.0-alpha.2 (2025-10-16)
 
 Full Changelog: [v0.1.0-alpha.1...v0.1.0-alpha.2](https://github.com/digitalocean/gradient-typescript/compare/v0.1.0-alpha.1...v0.1.0-alpha.2)

diff --git a/api.md b/api.md
@@ -137,16 +137,6 @@ Methods:
 - <code title="get /v2/gen-ai/workspaces/{workspace_uuid}/agents">client.agents.evaluationMetrics.workspaces.agents.<a href="./src/resources/agents/evaluation-metrics/workspaces/agents.ts">list</a>(workspaceUuid, { ...params }) -> AgentListResponse</code>
 - <code title="put /v2/gen-ai/workspaces/{workspace_uuid}/agents">client.agents.evaluationMetrics.workspaces.agents.<a href="./src/resources/agents/evaluation-metrics/workspaces/agents.ts">move</a>(workspaceUuid, { ...params }) -> AgentMoveResponse</code>
 
-### Models
-
-Types:
-
-- <code><a href="./src/resources/agents/evaluation-metrics/models.ts">ModelListResponse</a></code>
-
-Methods:
-
-- <code title="get /v2/gen-ai/models">client.agents.evaluationMetrics.models.<a href="./src/resources/agents/evaluation-metrics/models.ts">list</a>({ ...params }) -> ModelListResponse</code>
-
 ### Anthropic
 
 #### Keys
@@ -211,6 +201,20 @@ Methods:
 
 - <code title="post /v2/gen-ai/oauth2/dropbox/tokens">client.agents.evaluationMetrics.oauth2.dropbox.<a href="./src/resources/agents/evaluation-metrics/oauth2/dropbox.ts">createTokens</a>({ ...params }) -> DropboxCreateTokensResponse</code>
 
+### ScheduledIndexing
+
+Types:
+
+- <code><a href="./src/resources/agents/evaluation-metrics/scheduled-indexing.ts">ScheduledIndexingCreateResponse</a></code>
+- <code><a href="./src/resources/agents/evaluation-metrics/scheduled-indexing.ts">ScheduledIndexingRetrieveResponse</a></code>
+- <code><a href="./src/resources/agents/evaluation-metrics/scheduled-indexing.ts">ScheduledIndexingDeleteResponse</a></code>
+
+Methods:
+
+- <code title="post /v2/gen-ai/scheduled-indexing">client.agents.evaluationMetrics.scheduledIndexing.<a href="./src/resources/agents/evaluation-metrics/scheduled-indexing.ts">create</a>({ ...params }) -> ScheduledIndexingCreateResponse</code>
+- <code title="get /v2/gen-ai/scheduled-indexing/knowledge-base/{knowledge_base_uuid}">client.agents.evaluationMetrics.scheduledIndexing.<a href="./src/resources/agents/evaluation-metrics/scheduled-indexing.ts">retrieve</a>(knowledgeBaseUuid) -> ScheduledIndexingRetrieveResponse</code>
+- <code title="delete /v2/gen-ai/scheduled-indexing/{uuid}">client.agents.evaluationMetrics.scheduledIndexing.<a href="./src/resources/agents/evaluation-metrics/scheduled-indexing.ts">delete</a>(uuid) -> ScheduledIndexingDeleteResponse</code>
+
 ## EvaluationRuns
 
 Types:
@@ -700,6 +704,7 @@ Types:
 - <code><a href="./src/resources/knowledge-bases/knowledge-bases.ts">KnowledgeBaseUpdateResponse</a></code>
 - <code><a href="./src/resources/knowledge-bases/knowledge-bases.ts">KnowledgeBaseListResponse</a></code>
 - <code><a href="./src/resources/knowledge-bases/knowledge-bases.ts">KnowledgeBaseDeleteResponse</a></code>
+- <code><a href="./src/resources/knowledge-bases/knowledge-bases.ts">KnowledgeBaseListIndexingJobsResponse</a></code>
 
 Methods:
 
@@ -708,6 +713,7 @@ Methods:
 - <code title="put /v2/gen-ai/knowledge_bases/{uuid}">client.knowledgeBases.<a href="./src/resources/knowledge-bases/knowledge-bases.ts">update</a>(pathUuid, { ...params }) -> KnowledgeBaseUpdateResponse</code>
 - <code title="get /v2/gen-ai/knowledge_bases">client.knowledgeBases.<a href="./src/resources/knowledge-bases/knowledge-bases.ts">list</a>({ ...params }) -> KnowledgeBaseListResponse</code>
 - <code title="delete /v2/gen-ai/knowledge_bases/{uuid}">client.knowledgeBases.<a href="./src/resources/knowledge-bases/knowledge-bases.ts">delete</a>(uuid) -> KnowledgeBaseDeleteResponse</code>
+- <code title="get /v2/gen-ai/knowledge_bases/{knowledge_base_uuid}/indexing_jobs">client.knowledgeBases.<a href="./src/resources/knowledge-bases/knowledge-bases.ts">listIndexingJobs</a>(knowledgeBaseUuid) -> KnowledgeBaseListIndexingJobsResponse</code>
 
 ## DataSources
 
@@ -740,6 +746,7 @@ Types:
 - <code><a href="./src/resources/knowledge-bases/indexing-jobs.ts">IndexingJobRetrieveResponse</a></code>
 - <code><a href="./src/resources/knowledge-bases/indexing-jobs.ts">IndexingJobListResponse</a></code>
 - <code><a href="./src/resources/knowledge-bases/indexing-jobs.ts">IndexingJobRetrieveDataSourcesResponse</a></code>
+- <code><a href="./src/resources/knowledge-bases/indexing-jobs.ts">IndexingJobRetrieveSignedURLResponse</a></code>
 - <code><a href="./src/resources/knowledge-bases/indexing-jobs.ts">IndexingJobUpdateCancelResponse</a></code>
 
 Methods:
@@ -748,6 +755,7 @@ Methods:
 - <code title="get /v2/gen-ai/indexing_jobs/{uuid}">client.knowledgeBases.indexingJobs.<a href="./src/resources/knowledge-bases/indexing-jobs.ts">retrieve</a>(uuid) -> IndexingJobRetrieveResponse</code>
 - <code title="get /v2/gen-ai/indexing_jobs">client.knowledgeBases.indexingJobs.<a href="./src/resources/knowledge-bases/indexing-jobs.ts">list</a>({ ...params }) -> IndexingJobListResponse</code>
 - <code title="get /v2/gen-ai/indexing_jobs/{indexing_job_uuid}/data_sources">client.knowledgeBases.indexingJobs.<a href="./src/resources/knowledge-bases/indexing-jobs.ts">retrieveDataSources</a>(indexingJobUuid) -> IndexingJobRetrieveDataSourcesResponse</code>
+- <code title="get /v2/gen-ai/indexing_jobs/{indexing_job_uuid}/details_signed_url">client.knowledgeBases.indexingJobs.<a href="./src/resources/knowledge-bases/indexing-jobs.ts">retrieveSignedURL</a>(indexingJobUuid) -> IndexingJobRetrieveSignedURLResponse</code>
 - <code title="put /v2/gen-ai/indexing_jobs/{uuid}/cancel">client.knowledgeBases.indexingJobs.<a href="./src/resources/knowledge-bases/indexing-jobs.ts">updateCancel</a>(pathUuid, { ...params }) -> IndexingJobUpdateCancelResponse</code>
 - <code title="polling helper">client.knowledgeBases.indexingJobs.<a href="./src/resources/knowledge-bases/indexing-jobs.ts">waitForCompletion</a>(uuid, { ...options }) -> IndexingJobRetrieveResponse</code>
 
@@ -835,3 +843,33 @@ Methods:
 - <code title="put /v2/databases/{database_cluster_uuid}/schema-registry/config">client.databases.schemaRegistry.config.<a href="./src/resources/databases/schema-registry/config.ts">update</a>(databaseClusterUuid, { ...params }) -> ConfigUpdateResponse</code>
 - <code title="get /v2/databases/{database_cluster_uuid}/schema-registry/config/{subject_name}">client.databases.schemaRegistry.config.<a href="./src/resources/databases/schema-registry/config.ts">retrieveSubject</a>(subjectName, { ...params }) -> ConfigRetrieveSubjectResponse</code>
 - <code title="put /v2/databases/{database_cluster_uuid}/schema-registry/config/{subject_name}">client.databases.schemaRegistry.config.<a href="./src/resources/databases/schema-registry/config.ts">updateSubject</a>(subjectName, { ...params }) -> ConfigUpdateSubjectResponse</code>
+
+# Nfs
+
+Types:
+
+- <code><a href="./src/resources/nfs/nfs.ts">NfCreateResponse</a></code>
+- <code><a href="./src/resources/nfs/nfs.ts">NfRetrieveResponse</a></code>
+- <code><a href="./src/resources/nfs/nfs.ts">NfListResponse</a></code>
+- <code><a href="./src/resources/nfs/nfs.ts">NfInitiateActionResponse</a></code>
+
+Methods:
+
+- <code title="post /v2/nfs">client.nfs.<a href="./src/resources/nfs/nfs.ts">create</a>({ ...params }) -> NfCreateResponse</code>
+- <code title="get /v2/nfs/{nfs_id}">client.nfs.<a href="./src/resources/nfs/nfs.ts">retrieve</a>(nfsID, { ...params }) -> NfRetrieveResponse</code>
+- <code title="get /v2/nfs">client.nfs.<a href="./src/resources/nfs/nfs.ts">list</a>({ ...params }) -> NfListResponse</code>
+- <code title="delete /v2/nfs/{nfs_id}">client.nfs.<a href="./src/resources/nfs/nfs.ts">delete</a>(nfsID, { ...params }) -> void</code>
+- <code title="post /v2/nfs/{nfs_id}/actions">client.nfs.<a href="./src/resources/nfs/nfs.ts">initiateAction</a>(nfsID, { ...params }) -> NfInitiateActionResponse</code>
+
+## Snapshots
+
+Types:
+
+- <code><a href="./src/resources/nfs/snapshots.ts">SnapshotRetrieveResponse</a></code>
+- <code><a href="./src/resources/nfs/snapshots.ts">SnapshotListResponse</a></code>
+
+Methods:
+
+- <code title="get /v2/nfs/snapshots/{nfs_snapshot_id}">client.nfs.snapshots.<a href="./src/resources/nfs/snapshots.ts">retrieve</a>(nfsSnapshotID, { ...params }) -> SnapshotRetrieveResponse</code>
+- <code title="get /v2/nfs/snapshots">client.nfs.snapshots.<a href="./src/resources/nfs/snapshots.ts">list</a>({ ...params }) -> SnapshotListResponse</code>
+- <code title="delete /v2/nfs/snapshots/{nfs_snapshot_id}">client.nfs.snapshots.<a href="./src/resources/nfs/snapshots.ts">delete</a>(nfsSnapshotID, { ...params }) -> void</code>
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@digitalocean/gradient",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "The official TypeScript library for the Gradient API",
   "author": "DigitalOcean, LLC <dev@digitalocean.com>",
   "types": "dist/index.d.ts",
@@ -35,7 +35,7 @@
     "@types/node": "^20.17.6",
     "@typescript-eslint/eslint-plugin": "8.31.1",
     "@typescript-eslint/parser": "8.31.1",
-    "eslint": "^9.20.1",
+    "eslint": "^9.39.1",
     "eslint-plugin-prettier": "^5.4.1",
     "eslint-plugin-unused-imports": "^4.1.4",
     "iconv-lite": "^0.6.3",

diff --git a/src/client.ts b/src/client.ts
@@ -73,6 +73,7 @@ import {
   KnowledgeBaseCreateParams,
   KnowledgeBaseCreateResponse,
   KnowledgeBaseDeleteResponse,
+  KnowledgeBaseListIndexingJobsResponse,
   KnowledgeBaseListParams,
   KnowledgeBaseListResponse,
   KnowledgeBaseRetrieveResponse,
@@ -88,6 +89,18 @@ import {
   ModelListResponse,
   Models,
 } from './resources/models/models';
+import {
+  NfCreateParams,
+  NfCreateResponse,
+  NfDeleteParams,
+  NfInitiateActionParams,
+  NfInitiateActionResponse,
+  NfListParams,
+  NfListResponse,
+  NfRetrieveParams,
+  NfRetrieveResponse,
+  Nfs,
+} from './resources/nfs/nfs';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -209,7 +222,7 @@ export class Gradient {
   baseURL: string;
   maxRetries: number;
   timeout: number;
-  logger: Logger | undefined;
+  logger: Logger;
   logLevel: LogLevel | undefined;
   fetchOptions: MergedRequestInit | undefined;
 
@@ -871,6 +884,7 @@ export class Gradient {
   models: API.Models = new API.Models(this);
   regions: API.Regions = new API.Regions(this);
   databases: API.Databases = new API.Databases(this);
+  nfs: API.Nfs = new API.Nfs(this);
 }
 
 Gradient.Agents = Agents;
@@ -882,6 +896,7 @@ Gradient.KnowledgeBases = KnowledgeBases;
 Gradient.Models = Models;
 Gradient.Regions = Regions;
 Gradient.Databases = Databases;
+Gradient.Nfs = Nfs;
 
 export declare namespace Gradient {
   export type RequestOptions = Opts.RequestOptions;
@@ -948,6 +963,7 @@ export declare namespace Gradient {
     type KnowledgeBaseUpdateResponse as KnowledgeBaseUpdateResponse,
     type KnowledgeBaseListResponse as KnowledgeBaseListResponse,
     type KnowledgeBaseDeleteResponse as KnowledgeBaseDeleteResponse,
+    type KnowledgeBaseListIndexingJobsResponse as KnowledgeBaseListIndexingJobsResponse,
     type KnowledgeBaseCreateParams as KnowledgeBaseCreateParams,
     type KnowledgeBaseUpdateParams as KnowledgeBaseUpdateParams,
     type KnowledgeBaseListParams as KnowledgeBaseListParams,
@@ -970,6 +986,19 @@ export declare namespace Gradient {
 
   export { Databases as Databases };
 
+  export {
+    Nfs as Nfs,
+    type NfCreateResponse as NfCreateResponse,
+    type NfRetrieveResponse as NfRetrieveResponse,
+    type NfListResponse as NfListResponse,
+    type NfInitiateActionResponse as NfInitiateActionResponse,
+    type NfCreateParams as NfCreateParams,
+    type NfRetrieveParams as NfRetrieveParams,
+    type NfListParams as NfListParams,
+    type NfDeleteParams as NfDeleteParams,
+    type NfInitiateActionParams as NfInitiateActionParams,
+  };
+
   export type Action = API.Action;
   export type ActionLink = API.ActionLink;
   export type APILinks = API.APILinks;