@naturali/cli 0.164.1 → 0.166.0

package/dist/index.mjs

@@ -17,7 +17,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.164.1";
+var version = "0.166.0";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const serializeFormDataPair = (data, key, value) => {
@@ -1187,6 +1187,34 @@ var Admin = class {
 			...options
 		});
 	}
+	/**
+	* List listings for review
+	*
+	* Every listing in one state, newest first — `in_review` by default, the queue an operator works through.
+	*
+	*/
+	static listAdminListings(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/admin/listings",
+			...options
+		});
+	}
+	/**
+	* Review a listing
+	*
+	* List a listing in review or one that is suspended, send one in review back to `draft`, or suspend any listing. A listing an operator suspends cannot be resumed by its publisher. An invalid move answers `409 invalid_listing_state`.
+	*
+	*/
+	static setAdminListingState(options) {
+		return (options.client ?? client).put({
+			url: "/v1/admin/listings/{listing_id}/state",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var Agents = class {
 	/**
@@ -3348,6 +3376,60 @@ var IngestionRules = class {
 		});
 	}
 };
+var Installs = class {
+	/**
+	* List installs
+	*
+	* The listings the project installed, newest first.
+	*/
+	static listInstalls(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/installs",
+			...options
+		});
+	}
+	/**
+	* Install a listing
+	*
+	* Install a listing by its id. A listed entry, a draft and a listing in review all install; a suspended one answers `409 listing_suspended`. Installing again answers the existing install.
+	* After the publisher removed this project's access, installing answers `403 install_blocked`.
+	*
+	*/
+	static createInstall(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/installs",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Uninstall a listing
+	*
+	* Remove the install. While the project's agents, ingestion rules or other resources still name the installed resource, this answers `409 install_in_use` with them in `details.references`; `force=true` uninstalls anyway and those resources stop reaching it.
+	* A `blocked` install, and the install managed conversion uses, answer `403`.
+	*
+	*/
+	static deleteInstall(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/installs/{install_id}",
+			...options
+		});
+	}
+	/**
+	* Get an install
+	*
+	* One of the project's installs.
+	*/
+	static getInstall(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/installs/{install_id}",
+			...options
+		});
+	}
+};
 var Knowledge = class {
 	/**
 	* Search knowledge
@@ -3365,6 +3447,123 @@ var Knowledge = class {
 		});
 	}
 };
+var Listings = class {
+	/**
+	* Browse the marketplace
+	*
+	* Every listed entry, newest first. `interface` is what an installing project sees of the resource, read live from the publisher.
+	*
+	*/
+	static listPublicListings(options) {
+		return (options?.client ?? client).get({
+			url: "/v1/listings",
+			...options
+		});
+	}
+	/**
+	* Get a public listing
+	*
+	* One listed entry. A listing that is not listed answers `404`.
+	*/
+	static getPublicListing(options) {
+		return (options.client ?? client).get({
+			url: "/v1/listings/{listing_id}",
+			...options
+		});
+	}
+	/**
+	* List a project's listings
+	*
+	* The listings the project publishes, newest first.
+	*/
+	static listListings(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/listings",
+			...options
+		});
+	}
+	/**
+	* Create a listing
+	*
+	* Publish one of the project's tools or agents as a `draft`. Any project member may publish.
+	* An agent on a naturali model whose model has no price answers `503 model_not_priced`. A resource that does not exist in the project answers `400 resource_not_found`, and one that already has a listing `409 listing_exists`.
+	*
+	*/
+	static createListing(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/listings",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Get a listing
+	*
+	* One of the project's listings.
+	*/
+	static getListing(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/listings/{listing_id}",
+			...options
+		});
+	}
+	/**
+	* Update a listing
+	*
+	* Change the title or description, or pause and resume the listing.
+	* `state: suspended` stops the listing for every installing project at once; their installs are kept. `state: listed` resumes a listing you suspended, provided naturali had listed it; nobody reinstalls. A listing naturali suspended cannot be resumed here, and an invalid move answers `409 invalid_listing_state`.
+	*
+	*/
+	static updateListing(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/listings/{listing_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Submit a listing for review
+	*
+	* Move a `draft` listing to `in_review`. naturali lists it in the marketplace or sends it back to `draft`. Any other state answers `409 invalid_listing_state`.
+	*
+	*/
+	static submitListing(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/listings/{listing_id}:submit",
+			...options
+		});
+	}
+	/**
+	* List a listing's installs
+	*
+	* Each project that installed the listing, with its usage this billing cycle as last sampled. Never the content of a call.
+	*
+	*/
+	static listListingInstalls(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/listings/{listing_id}/installs",
+			...options
+		});
+	}
+	/**
+	* Remove a project's install
+	*
+	* Cut one installing project off. An `active` or `suspended` install becomes `blocked`, and that project cannot install the listing again. Deleting a `blocked` install removes it, which lets that project install again.
+	*
+	*/
+	static deleteListingInstall(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/listings/{listing_id}/installs/{install_id}",
+			...options
+		});
+	}
+};
 var Memories = class {
 	/**
 	* List memories
@@ -5220,6 +5419,24 @@ var Users = class {
 			...options
 		});
 	}
+	/**
+	* Start a credit top-up
+	*
+	* A hosted card checkout that buys model credit for the caller's account. Send the caller to `checkout_url`; once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted.
+	*
+	* Charged in US dollars. Creating a top-up charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.
+	*
+	*/
+	static createCurrentUserTopUp(options) {
+		return (options.client ?? client).post({
+			url: "/v1/users/me/top-ups",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
 };
 var Webhooks = class {
 	/**
@@ -5524,7 +5741,9 @@ var NaturaliClient = class {
 	generations;
 	guardrails;
 	ingestionRules;
+	installs;
 	knowledge;
+	listings;
 	memories;
 	memoryRules;
 	memoryStores;
@@ -5577,7 +5796,9 @@ var NaturaliClient = class {
 		this.generations = bindResource(Generations, this.http);
 		this.guardrails = bindResource(Guardrails, this.http);
 		this.ingestionRules = bindResource(IngestionRules, this.http);
+		this.installs = bindResource(Installs, this.http);
 		this.knowledge = bindResource(Knowledge, this.http);
+		this.listings = bindResource(Listings, this.http);
 		this.memories = bindResource(Memories, this.http);
 		this.memoryRules = bindResource(MemoryRules, this.http);
 		this.memoryStores = bindResource(MemoryStores, this.http);
@@ -5625,7 +5846,9 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Generations: () => Generations,
 	Guardrails: () => Guardrails,
 	IngestionRules: () => IngestionRules,
+	Installs: () => Installs,
 	Knowledge: () => Knowledge,
+	Listings: () => Listings,
 	Memories: () => Memories,
 	MemoryRules: () => MemoryRules,
 	MemoryStores: () => MemoryStores,
@@ -7208,6 +7431,68 @@ const routes = {
 			}
 		]
 	},
+	"list-admin-listings": {
+		serviceClass: "Admin",
+		operationId: "listAdminListings",
+		description: "Every listing in one state, newest first — `in_review` by default, the queue an operator works through.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/admin",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: [
+			"state",
+			"limit",
+			"cursor"
+		],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "state",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "The `next_cursor` of the previous page.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"set-admin-listing-state": {
+		serviceClass: "Admin",
+		operationId: "setAdminListingState",
+		description: "List a listing in review or one that is suspended, send one in review back to `draft`, or suspend any listing. A listing an operator suspends cannot be resumed by its publisher. An invalid move answers `409 invalid_listing_state`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/admin",
+		httpMethod: "put",
+		pathParams: ["listing_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "listing_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "state",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "body"
+		}]
+	},
 	"list-agents": {
 		serviceClass: "Agents",
 		operationId: "listAgents",
@@ -14594,14 +14879,14 @@ const routes = {
 			"in": "path"
 		}]
 	},
-	"search-knowledge": {
-		serviceClass: "Knowledge",
-		operationId: "searchKnowledge",
-		description: "Searches across documents and memories using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory store IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_store_ids` must be provided.",
-		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
-		httpMethod: "post",
+	"list-installs": {
+		serviceClass: "Installs",
+		operationId: "listInstalls",
+		description: "The listings the project installed, newest first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/installs",
+		httpMethod: "get",
 		pathParams: ["project_id"],
-		queryParams: [],
+		queryParams: ["limit", "cursor"],
 		headerParams: [],
 		cookieParams: [],
 		flags: [
@@ -14612,57 +14897,173 @@ const routes = {
 				"type": "string",
 				"in": "path"
 			},
-			{
-				"name": "query",
-				"description": "Search query text. Runs a vector query and a full-text query over each store and fuses the rankings; the full-text channel matches exact tokens and phrases, the vector channel everything else.",
-				"required": false,
-				"type": "string",
-				"in": "body"
-			},
-			{
-				"name": "min_similarity",
-				"description": "Minimum raw cosine `similarity_score` a **vector** candidate must reach to take part in ranking, applied before fusion. Only applies when `query` is provided. Lexical candidates are deliberately exempt: a result that literally contains the searched token is the evidence, and dropping it for a low cosine is the failure hybrid search exists to prevent. Not a floor on `score`, whose fused value encodes rank position rather than similarity.",
-				"required": false,
-				"type": "number",
-				"in": "body"
-			},
-			{
-				"name": "rrf_k",
-				"description": "The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to the deployment's `KNOWLEDGE_RRF_K`, itself 60 by default. Only applies when `query` is provided.",
-				"required": false,
-				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "recency_half_life_days",
-				"description": "Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided. **No value is known to be safe in general**: every half-life measured against the reference corpus that lifted recency-sensitive queries also cost relevance-sensitive ones, which is why this ships disabled. Measure against your own corpus before setting it — see the Retrieval Quality guide.",
-				"required": false,
-				"type": "number",
-				"in": "body"
-			},
 			{
 				"name": "limit",
-				"description": "Maximum number of results to return (default 10). A value above 100 is clamped to 100 — the ceiling bounds the vector scan this one request performs, so a larger `limit` returns everything there is up to that many rows rather than being refused.",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
 				"required": false,
 				"type": "integer",
-				"in": "body"
-			},
-			{
-				"name": "include_documents",
-				"description": "Set `false` to leave the document store out of this search. A `query` names no store, so it reaches both; the store-specific filters narrow *within* a store rather than choosing between them. This is the switch, and a filter naming the other store never overrides it. `false` for both stores is `400`.",
-				"required": false,
-				"type": "boolean",
-				"in": "body"
+				"in": "query"
 			},
 			{
-				"name": "include_memories",
-				"description": "Set `false` to leave the memory store out of this search. The mirror of `include_documents`, for a caller that wants documents alone.",
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
 				"required": false,
-				"type": "boolean",
-				"in": "body"
-			},
-			{
-				"name": "memory_store_ids",
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"create-install": {
+		serviceClass: "Installs",
+		operationId: "createInstall",
+		description: "Install a listing by its id. A listed entry, a draft and a listing in review all install; a suspended one answers `409 listing_suspended`. Installing again answers the existing install. After the publisher removed this project's access, installing answers `403 install_blocked`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/installs",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "listing_id",
+			"description": "",
+			"required": true,
+			"type": "string",
+			"in": "body"
+		}]
+	},
+	"get-install": {
+		serviceClass: "Installs",
+		operationId: "getInstall",
+		description: "One of the project's installs.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/installs",
+		httpMethod: "get",
+		pathParams: ["project_id", "install_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "install_id",
+			"description": "Install public ID (ins_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"delete-install": {
+		serviceClass: "Installs",
+		operationId: "deleteInstall",
+		description: "Remove the install. While the project's agents, ingestion rules or other resources still name the installed resource, this answers `409 install_in_use` with them in `details.references`; `force=true` uninstalls anyway and those resources stop reaching it. A `blocked` install, and the install managed conversion uses, answer `403`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/installs",
+		httpMethod: "delete",
+		pathParams: ["project_id", "install_id"],
+		queryParams: ["force"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "install_id",
+				"description": "Install public ID (ins_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "force",
+				"description": "Uninstall even while resources still use it.",
+				"required": false,
+				"type": "boolean",
+				"in": "query"
+			}
+		]
+	},
+	"search-knowledge": {
+		serviceClass: "Knowledge",
+		operationId: "searchKnowledge",
+		description: "Searches across documents and memories using hybrid retrieval — a vector query and a full-text query per source, fused by reciprocal rank — or by file paths, document IDs, memory store IDs, or tags. At least one of `query`, `tags`, `document_paths`, `document_ids`, or `memory_store_ids` must be provided.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/knowledge",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "query",
+				"description": "Search query text. Runs a vector query and a full-text query over each store and fuses the rankings; the full-text channel matches exact tokens and phrases, the vector channel everything else.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "min_similarity",
+				"description": "Minimum raw cosine `similarity_score` a **vector** candidate must reach to take part in ranking, applied before fusion. Only applies when `query` is provided. Lexical candidates are deliberately exempt: a result that literally contains the searched token is the evidence, and dropping it for a low cosine is the failure hybrid search exists to prevent. Not a floor on `score`, whose fused value encodes rank position rather than similarity.",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			},
+			{
+				"name": "rrf_k",
+				"description": "The `k` in the reciprocal rank fusion term `1 / (k + rank)`, which sets how steeply a result's contribution decays with its position in each ranked list. A smaller value weights the very top of each list more heavily. Defaults to the deployment's `KNOWLEDGE_RRF_K`, itself 60 by default. Only applies when `query` is provided.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "recency_half_life_days",
+				"description": "Half-life, in days, of a recency decay applied to **memory store** results after fusion: a result's `score` is multiplied by `2 ^ (-age_in_days / recency_half_life_days)`, where age is measured from its `updated_at`. Document results are never decayed. `0` — the default, and the default of the deployment's `KNOWLEDGE_RECENCY_HALF_LIFE_DAYS` — disables the blend entirely; it is a switch, not a lower bound, and sending `0` turns off a deployment-wide decay for this one request. Accepts fractions (`0.5` is twelve hours). How many ranks a given half-life costs depends on `rrf_k`. Only applies when `query` is provided. **No value is known to be safe in general**: every half-life measured against the reference corpus that lifted recency-sensitive queries also cost relevance-sensitive ones, which is why this ships disabled. Measure against your own corpus before setting it — see the Retrieval Quality guide.",
+				"required": false,
+				"type": "number",
+				"in": "body"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum number of results to return (default 10). A value above 100 is clamped to 100 — the ceiling bounds the vector scan this one request performs, so a larger `limit` returns everything there is up to that many rows rather than being refused.",
+				"required": false,
+				"type": "integer",
+				"in": "body"
+			},
+			{
+				"name": "include_documents",
+				"description": "Set `false` to leave the document store out of this search. A `query` names no store, so it reaches both; the store-specific filters narrow *within* a store rather than choosing between them. This is the switch, and a filter naming the other store never overrides it. `false` for both stores is `400`.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			},
+			{
+				"name": "include_memories",
+				"description": "Set `false` to leave the memory store out of this search. The mirror of `include_documents`, for a caller that wants documents alone.",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			},
+			{
+				"name": "memory_store_ids",
 				"description": "Search memories within these specific memory stores",
 				"required": false,
 				"type": "array",
@@ -14698,6 +15099,305 @@ const routes = {
 			}
 		]
 	},
+	"list-public-listings": {
+		serviceClass: "Listings",
+		operationId: "listPublicListings",
+		description: "Every listed entry, newest first. `interface` is what an installing project sees of the resource, read live from the publisher.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "get",
+		pathParams: [],
+		queryParams: ["limit", "cursor"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "limit",
+			"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+			"required": false,
+			"type": "integer",
+			"in": "query"
+		}, {
+			"name": "cursor",
+			"description": "Opaque pagination cursor from a previous response's next_cursor.",
+			"required": false,
+			"type": "string",
+			"in": "query"
+		}]
+	},
+	"get-public-listing": {
+		serviceClass: "Listings",
+		operationId: "getPublicListing",
+		description: "One listed entry. A listing that is not listed answers `404`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "get",
+		pathParams: ["listing_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "listing_id",
+			"description": "Listing public ID (lst_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-listings": {
+		serviceClass: "Listings",
+		operationId: "listListings",
+		description: "The listings the project publishes, newest first.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "get",
+		pathParams: ["project_id"],
+		queryParams: ["limit", "cursor"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"create-listing": {
+		serviceClass: "Listings",
+		operationId: "createListing",
+		description: "Publish one of the project's tools or agents as a `draft`. Any project member may publish. An agent on a naturali model whose model has no price answers `503 model_not_priced`. A resource that does not exist in the project answers `400 resource_not_found`, and one that already has a listing `409 listing_exists`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "post",
+		pathParams: ["project_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "resource_type",
+				"description": "What the listing publishes.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "resource_id",
+				"description": "A tool or agent in this project.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "title",
+				"description": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"get-listing": {
+		serviceClass: "Listings",
+		operationId: "getListing",
+		description: "One of the project's listings.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "get",
+		pathParams: ["project_id", "listing_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "listing_id",
+			"description": "Listing public ID (lst_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-listing": {
+		serviceClass: "Listings",
+		operationId: "updateListing",
+		description: "Change the title or description, or pause and resume the listing. `state: suspended` stops the listing for every installing project at once; their installs are kept. `state: listed` resumes a listing you suspended, provided naturali had listed it; nobody reinstalls. A listing naturali suspended cannot be resumed here, and an invalid move answers `409 invalid_listing_state`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "patch",
+		pathParams: ["project_id", "listing_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "listing_id",
+				"description": "Listing public ID (lst_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "title",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "state",
+				"description": "Pause the listing, or resume one you paused.",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			}
+		]
+	},
+	"submit-listing": {
+		serviceClass: "Listings",
+		operationId: "submitListing",
+		description: "Move a `draft` listing to `in_review`. naturali lists it in the marketplace or sends it back to `draft`. Any other state answers `409 invalid_listing_state`.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "post",
+		pathParams: ["project_id", "listing_id"],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "listing_id",
+			"description": "Listing public ID (lst_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"list-listing-installs": {
+		serviceClass: "Listings",
+		operationId: "listListingInstalls",
+		description: "Each project that installed the listing, with its usage this billing cycle as last sampled. Never the content of a call.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "get",
+		pathParams: ["project_id", "listing_id"],
+		queryParams: ["limit", "cursor"],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "listing_id",
+				"description": "Listing public ID (lst_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items per page — an integer from 1 to 100 (default 20).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "cursor",
+				"description": "Opaque pagination cursor from a previous response's next_cursor.",
+				"required": false,
+				"type": "string",
+				"in": "query"
+			}
+		]
+	},
+	"delete-listing-install": {
+		serviceClass: "Listings",
+		operationId: "deleteListingInstall",
+		description: "Cut one installing project off. An `active` or `suspended` install becomes `blocked`, and that project cannot install the listing again. Deleting a `blocked` install removes it, which lets that project install again.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/listings",
+		httpMethod: "delete",
+		pathParams: [
+			"project_id",
+			"listing_id",
+			"install_id"
+		],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "listing_id",
+				"description": "Listing public ID (lst_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "install_id",
+				"description": "Install public ID (ins_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
 	"list-memories": {
 		serviceClass: "Memories",
 		operationId: "listMemories",
@@ -20244,6 +20944,24 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"create-current-user-top-up": {
+		serviceClass: "Users",
+		operationId: "createCurrentUserTopUp",
+		description: "A hosted card checkout that buys model credit for the caller's account. Send the caller to `checkout_url`; once the card is charged the full amount is added to `credit_balance_usd` as purchased credit, which never expires. The card fee is not deducted. Charged in US dollars. Creating a top-up charges nothing, and one left unpaid lapses at `expires_at`. After paying, the browser returns to the console's billing page.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/users",
+		httpMethod: "post",
+		pathParams: [],
+		queryParams: [],
+		headerParams: [],
+		cookieParams: [],
+		flags: [{
+			"name": "amount_usd",
+			"description": "US dollars to buy, in whole cents.",
+			"required": true,
+			"type": "number",
+			"in": "body"
+		}]
+	},
 	"list-webhooks": {
 		serviceClass: "Webhooks",
 		operationId: "listWebhooks",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.164.1",
+  "version": "0.166.0",
   "description": "Command-line interface for the naturali.ai API, generated from its OpenAPI specs",
   "type": "module",
   "bin": {
@@ -25,7 +25,7 @@
     "yaml": "^2.9.1"
   },
   "devDependencies": {
-    "@naturali/sdk": "0.164.1",
+    "@naturali/sdk": "0.166.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",