@naturali/cli 0.164.1 → 0.165.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.165.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
@@ -5524,7 +5723,9 @@ var NaturaliClient = class {
 	generations;
 	guardrails;
 	ingestionRules;
+	installs;
 	knowledge;
+	listings;
 	memories;
 	memoryRules;
 	memoryStores;
@@ -5577,7 +5778,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 +5828,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 +7413,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,6 +14861,122 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"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: ["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-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",
@@ -14698,6 +15081,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",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.164.1",
+  "version": "0.165.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.165.0",
     "@ttoss/openapi-codegen": "^0.5.0",
     "@types/node": "^26.5.1",
     "tsdown": "^0.23.0",