@naturali/cli 0.65.0 → 0.66.0

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.65.0";
+var version = "0.66.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -1453,7 +1453,7 @@ var Knowledge = class {
 	/**
 	* Query a collection (retrieval preview)
 	*
-	* Retrieval preview (API.md §4, K5): returns the chunks the collection would surface for a question — debuggable standalone, before any agent is bound to it. This is the `…:query` action; the path segment is `{collection_id}:query`.
+	* Retrieval preview: returns the chunks the collection would surface for a question — debuggable standalone, before any agent is bound to it. This is the `…:query` action; the path segment is `{collection_id}:query`.
 	*
 	*/
 	static queryKnowledgeCollection(options) {
@@ -1520,7 +1520,7 @@ var Knowledge = class {
 	/**
 	* Re-ingest a document
 	*
-	* Re-run ingestion for a document against its stored source, resetting it to `pending` before re-processing — the recovery path for a `failed` ingest (API.md §4, K1). This is the `…:reingest` action; the path segment is `{document_id}:reingest`.
+	* Re-run ingestion for a document against its stored source, resetting it to `pending` before re-processing — the recovery path for a `failed` ingest. This is the `…:reingest` action; the path segment is `{document_id}:reingest`.
 	*
 	*/
 	static reingestKnowledgeDocument(options) {
@@ -1610,6 +1610,71 @@ var Knowledge = class {
 		});
 	}
 };
+var ModelRoutes = class {
+	/**
+	* List model routes
+	*
+	* Returns the model routes defined in a project
+	*/
+	static listModelRoutes(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/model-routes",
+			...options
+		});
+	}
+	/**
+	* Create a model route
+	*
+	* Creates a project-scoped model route: a named, ordered list of provider+model targets tried in array order. Every target must reference an AI provider in the same project (400 otherwise), and the total attempt budget — the sum of `1 + max_retries` over all targets — may not exceed 10 (400 naming the computed total). A duplicate `name` in the project is rejected with 409.
+	*/
+	static createModelRoute(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/model-routes",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a model route
+	*
+	* Deletes a model route. Returns 409 when an agent still references it — a routed agent has no pinned provider to fall back on, so the reference must be repointed or the agent deleted first.
+	*/
+	static deleteModelRoute(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			...options
+		});
+	}
+	/**
+	* Get a model route
+	*
+	* Returns a specific model route
+	*/
+	static getModelRoute(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			...options
+		});
+	}
+	/**
+	* Update a model route
+	*
+	* Updates a model route's name, targets, retry classes, or breaker configuration. Omitted fields are left unchanged.
+	*/
+	static updateModelRoute(options) {
+		return (options.client ?? client).put({
+			url: "/v1/projects/{project_id}/model-routes/{route_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+};
 var Models = class {
 	/**
 	* List models
@@ -2543,6 +2608,7 @@ var NaturaliClient = class {
 	channels;
 	generations;
 	knowledge;
+	modelRoutes;
 	models;
 	orchestrations;
 	projects;
@@ -2572,6 +2638,7 @@ var NaturaliClient = class {
 		this.channels = bindResource(Channels, this.http);
 		this.generations = bindResource(Generations, this.http);
 		this.knowledge = bindResource(Knowledge, this.http);
+		this.modelRoutes = bindResource(ModelRoutes, this.http);
 		this.models = bindResource(Models, this.http);
 		this.orchestrations = bindResource(Orchestrations, this.http);
 		this.projects = bindResource(Projects, this.http);
@@ -2596,6 +2663,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Channels: () => Channels,
 	Generations: () => Generations,
 	Knowledge: () => Knowledge,
+	ModelRoutes: () => ModelRoutes,
 	Models: () => Models,
 	NaturaliClient: () => NaturaliClient,
 	Orchestrations: () => Orchestrations,
@@ -5189,7 +5257,7 @@ const routes = {
 	"query-knowledge-collection": {
 		serviceClass: "Knowledge",
 		operationId: "queryKnowledgeCollection",
-		description: "Retrieval preview (API.md §4, K5): returns the chunks the collection would surface for a question — debuggable standalone, before any agent is bound to it. This is the `…:query` action; the path segment is `{collection_id}:query`.",
+		description: "Retrieval preview: returns the chunks the collection would surface for a question — debuggable standalone, before any agent is bound to it. This is the `…:query` action; the path segment is `{collection_id}:query`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
 		httpMethod: "post",
 		pathParams: ["project_id", "collection_id"],
@@ -5427,7 +5495,7 @@ const routes = {
 	"reingest-knowledge-document": {
 		serviceClass: "Knowledge",
 		operationId: "reingestKnowledgeDocument",
-		description: "Re-run ingestion for a document against its stored source, resetting it to `pending` before re-processing — the recovery path for a `failed` ingest (API.md §4, K1). This is the `…:reingest` action; the path segment is `{document_id}:reingest`.",
+		description: "Re-run ingestion for a document against its stored source, resetting it to `pending` before re-processing — the recovery path for a `failed` ingest. This is the `…:reingest` action; the path segment is `{document_id}:reingest`.",
 		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
 		httpMethod: "post",
 		pathParams: [
@@ -5691,6 +5759,195 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-model-routes": {
+		serviceClass: "ModelRoutes",
+		operationId: "listModelRoutes",
+		description: "Returns the model routes defined in a project",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/model-routes",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Number of results to skip",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-model-route": {
+		serviceClass: "ModelRoutes",
+		operationId: "createModelRoute",
+		description: "Creates a project-scoped model route: a named, ordered list of provider+model targets tried in array order. Every target must reference an AI provider in the same project (400 otherwise), and the total attempt budget — the sum of `1 + max_retries` over all targets — may not exceed 10 (400 naming the computed total). A duplicate `name` in the project is rejected with 409.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/model-routes",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "Human-readable name, unique per project",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "targets",
+				"description": "Ordered failover targets. Position is priority: target 0 is tried first, and a retryable failure falls through to the next target.",
+				"required": true,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "retry_on",
+				"description": "Which failure classes are failover-eligible. A failure whose class is not listed (and every deterministic failure — 400-class, auth, content policy) fails the generation immediately instead of spending another target's budget.",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "failure_threshold",
+				"description": "Consecutive retryable failures after which a target is skipped for `cooldown_seconds`. Breaker state is in-process per node and keyed by (provider, model), so it is shared by every route pointing at the same backend.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "cooldown_seconds",
+				"description": "How long a tripped target is skipped before being probed again",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			}
+		]
+	},
+	"get-model-route": {
+		serviceClass: "ModelRoutes",
+		operationId: "getModelRoute",
+		description: "Returns a specific model route",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/model-routes",
+		httpMethod: "get",
+		pathParams: ["project_id", "route_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "route_id",
+			"description": "Model route ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-model-route": {
+		serviceClass: "ModelRoutes",
+		operationId: "updateModelRoute",
+		description: "Updates a model route's name, targets, retry classes, or breaker configuration. Omitted fields are left unchanged.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/model-routes",
+		httpMethod: "put",
+		pathParams: ["project_id", "route_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "route_id",
+				"description": "Model route ID",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "New name (unique per project)",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "targets",
+				"description": "Replacement target list (ordered)",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "retry_on",
+				"description": "",
+				"required": false,
+				"type": "array",
+				"in": "body"
+			},
+			{
+				"name": "failure_threshold",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "cooldown_seconds",
+				"description": "",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			}
+		]
+	},
+	"delete-model-route": {
+		serviceClass: "ModelRoutes",
+		operationId: "deleteModelRoute",
+		description: "Deletes a model route. Returns 409 when an agent still references it — a routed agent has no pinned provider to fall back on, so the reference must be repointed or the agent deleted first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/model-routes",
+		httpMethod: "delete",
+		pathParams: ["project_id", "route_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "route_id",
+			"description": "Model route ID",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
 	"list-models": {
 		serviceClass: "Models",
 		operationId: "listModels",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.65.0",
+  "version": "0.66.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -30,7 +30,7 @@
     "tsx": "^4.23.1",
     "typescript": "~6.0.3",
     "vitest": "^4.1.10",
-    "@naturali/sdk": "0.65.0"
+    "@naturali/sdk": "0.66.0"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",