@naturali/cli 0.49.3 → 0.50.1

package/dist/index.mjs

@@ -14,7 +14,7 @@ var __exportAll = (all, no_symbols) => {
 };
 //#endregion
 //#region package.json
-var version = "0.49.3";
+var version = "0.50.1";
 //#endregion
 //#region ../sdk/src/generated/core/bodySerializer.gen.ts
 const jsonBodySerializer = { bodySerializer: (body) => JSON.stringify(body, (_key, value) => typeof value === "bigint" ? value.toString() : value) };
@@ -2056,6 +2056,108 @@ var Traces = class {
 		});
 	}
 };
+var Triggers = class {
+	/**
+	* List triggers
+	*
+	* The project's schedule triggers.
+	*/
+	static listTriggers(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers",
+			...options
+		});
+	}
+	/**
+	* Create a trigger
+	*
+	* Schedules `target_id` (an agent in this project) to run on `cron`, a 5-field cron expression evaluated in UTC.
+	*
+	*/
+	static createTrigger(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/triggers",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Delete a trigger
+	*
+	* Removes the trigger. Its firing history is kept.
+	*/
+	static deleteTrigger(options) {
+		return (options.client ?? client).delete({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}",
+			...options
+		});
+	}
+	/**
+	* Get a trigger
+	*/
+	static getTrigger(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}",
+			...options
+		});
+	}
+	/**
+	* Update a trigger
+	*
+	* Retune the schedule, its target, or whether it fires at all. At least one field is required. `type` and `target_type` are immutable.
+	*
+	*/
+	static updateTrigger(options) {
+		return (options.client ?? client).patch({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* Fire a trigger manually
+	*
+	* Runs the trigger's target right now, outside its schedule, and waits for the run to finish. This is the `…:fire` action; the path segment is `{trigger_id}:fire`.
+	* `input` is shallow-merged over the trigger's own stored `input` for this run only — the trigger's configuration is unchanged.
+	*
+	*/
+	static fireTrigger(options) {
+		return (options.client ?? client).post({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}:fire",
+			...options,
+			headers: {
+				"Content-Type": "application/json",
+				...options.headers
+			}
+		});
+	}
+	/**
+	* List a trigger's firings
+	*
+	* Every time this trigger ran, newest first — scheduled and manual alike.
+	*/
+	static listTriggerFirings(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}/firings",
+			...options
+		});
+	}
+	/**
+	* Get a trigger firing
+	*/
+	static getTriggerFiring(options) {
+		return (options.client ?? client).get({
+			url: "/v1/projects/{project_id}/triggers/{trigger_id}/firings/{firing_id}",
+			...options
+		});
+	}
+};
 var Webhooks = class {
 	/**
 	* List webhooks
@@ -2289,6 +2391,7 @@ var src_exports = /* @__PURE__ */ __exportAll({
 	Tasks: () => Tasks,
 	Tools: () => Tools,
 	Traces: () => Traces,
+	Triggers: () => Triggers,
 	Webhooks: () => Webhooks,
 	createClient: () => createClient,
 	createConfig: () => createConfig
@@ -6738,6 +6841,316 @@ const routes = {
 			"in": "path"
 		}]
 	},
+	"list-triggers": {
+		serviceClass: "Triggers",
+		operationId: "listTriggers",
+		description: "The project's schedule triggers.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		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 items to return (1–100).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Items to skip. These lists page by offset rather than by naturali's usual opaque cursor because the upstream ordering is offset-based; a cursor here would only imitate a keyset.\n",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"create-trigger": {
+		serviceClass: "Triggers",
+		operationId: "createTrigger",
+		description: "Schedules `target_id` (an agent in this project) to run on `cron`, a 5-field cron expression evaluated in UTC.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		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": "",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "target_id",
+				"description": "The agent this trigger runs. Must belong to this project.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "input",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "cron",
+				"description": "5-field cron expression, evaluated in UTC.",
+				"required": true,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "active",
+				"description": "",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"get-trigger": {
+		serviceClass: "Triggers",
+		operationId: "getTrigger",
+		description: "Get a trigger",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "trigger_id",
+			"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"update-trigger": {
+		serviceClass: "Triggers",
+		operationId: "updateTrigger",
+		description: "Retune the schedule, its target, or whether it fires at all. At least one field is required. `type` and `target_type` are immutable.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "patch",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "name",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "description",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "target_id",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "input",
+				"description": "",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			},
+			{
+				"name": "cron",
+				"description": "",
+				"required": false,
+				"type": "string",
+				"in": "body"
+			},
+			{
+				"name": "active",
+				"description": "",
+				"required": false,
+				"type": "boolean",
+				"in": "body"
+			}
+		]
+	},
+	"delete-trigger": {
+		serviceClass: "Triggers",
+		operationId: "deleteTrigger",
+		description: "Removes the trigger. Its firing history is kept.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "delete",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [{
+			"name": "project_id",
+			"description": "Project public ID (proj_ prefix).",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}, {
+			"name": "trigger_id",
+			"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+			"required": true,
+			"type": "string",
+			"in": "path"
+		}]
+	},
+	"fire-trigger": {
+		serviceClass: "Triggers",
+		operationId: "fireTrigger",
+		description: "Runs the trigger's target right now, outside its schedule, and waits for the run to finish. This is the `…:fire` action; the path segment is `{trigger_id}:fire`. `input` is shallow-merged over the trigger's own stored `input` for this run only — the trigger's configuration is unchanged.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "post",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "input",
+				"description": "Fire-time input, shallow-merged over the trigger's stored `input`.",
+				"required": false,
+				"type": "object",
+				"in": "body"
+			}
+		]
+	},
+	"list-trigger-firings": {
+		serviceClass: "Triggers",
+		operationId: "listTriggerFirings",
+		description: "Every time this trigger ran, newest first — scheduled and manual alike.",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: ["project_id", "trigger_id"],
+		queryParams: ["limit", "offset"],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "limit",
+				"description": "Maximum items to return (1–100).",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			},
+			{
+				"name": "offset",
+				"description": "Items to skip. These lists page by offset rather than by naturali's usual opaque cursor because the upstream ordering is offset-based; a cursor here would only imitate a keyset.\n",
+				"required": false,
+				"type": "integer",
+				"in": "query"
+			}
+		]
+	},
+	"get-trigger-firing": {
+		serviceClass: "Triggers",
+		operationId: "getTriggerFiring",
+		description: "Get a trigger firing",
+		moduleDocsUrl: "https://docs.naturali.ai/docs/modules/triggers",
+		httpMethod: "get",
+		pathParams: [
+			"project_id",
+			"trigger_id",
+			"firing_id"
+		],
+		queryParams: [],
+		flags: [
+			{
+				"name": "project_id",
+				"description": "Project public ID (proj_ prefix).",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "trigger_id",
+				"description": "Trigger public ID (trg_ prefix) — the runtime trigger id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			},
+			{
+				"name": "firing_id",
+				"description": "Firing public ID — the runtime firing id.",
+				"required": true,
+				"type": "string",
+				"in": "path"
+			}
+		]
+	},
 	"list-webhooks": {
 		serviceClass: "Webhooks",
 		operationId: "listWebhooks",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturali/cli",
-  "version": "0.49.3",
+  "version": "0.50.1",
   "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.49.3"
+    "@naturali/sdk": "0.50.1"
   },
   "scripts": {
     "generate": "tsx scripts/generate.ts",