@asteroidai/cli 1.9.30 → 1.9.33

package/dist/asteroid.js

@@ -140,6 +140,96 @@ var COMMANDS = [
     readOnly: true,
     destructive: false
   },
+  {
+    command: "custom-environment create",
+    tool: "custom_environments_create",
+    title: "Create custom environment",
+    description: "Create a custom environment: a saved machine a workflow boots on. Set a unique `name` and a `base`: a browser, or a Linux or Windows OS environment. Optionally whitelist `profiles`, override boot `settings`, and keep copies ready with `warmPool` or fresh logins with `warmCache` (not both). Bind it to a workflow with the version's `settings.custom_environment_id`.",
+    method: "POST",
+    path: "/agents/v2/custom-environments",
+    args: [],
+    query: [],
+    binary: false,
+    readOnly: false,
+    destructive: false,
+    body: {
+      required: true,
+      contentType: "application/json",
+      fields: [
+        {
+          name: "name",
+          flag: "name",
+          type: "string",
+          required: true,
+          description: "Name, unique within the organisation"
+        },
+        {
+          name: "base",
+          flag: "base",
+          type: "json",
+          required: true,
+          description: "The base machine: a browser, or a Linux / Windows OS environment. For non-admins, an OS base's `snapshotName` must be one of the organisation's snapshots or a public one; admins may name any snapshot. Omit it for the default image."
+        },
+        {
+          name: "profiles",
+          flag: "profiles",
+          type: "json",
+          required: true,
+          description: "Ordered whitelist of the profile sources an execution bound to this environment may run as. Each row gets its own warm copies. With one row, a trigger that names neither a profile nor a pool defaults to that row; with several rows, the trigger must name an allowed profile, a member of an allowed pool, or an allowed pool. Empty means any profile or pool may be named, or none."
+        },
+        {
+          name: "settings",
+          flag: "settings",
+          type: "json",
+          required: false,
+          description: "Settings the environment boots with. Must match the base type. Absent inherits from the agent profile. A change applies to environments booted afterwards; warm members already booted keep the settings they booted with."
+        },
+        {
+          name: "warmPool",
+          flag: "warm-pool",
+          type: "json",
+          required: false,
+          description: "Warm pool configuration. Absent means the environment is not kept warm. Exclusive with warmCache and dedicated."
+        },
+        {
+          name: "warmCache",
+          flag: "warm-cache",
+          type: "json",
+          required: false,
+          description: "Warm cache configuration. Absent means no login agent keeps the profiles' cookies fresh. Exclusive with warmPool and dedicated."
+        },
+        {
+          name: "dedicated",
+          flag: "dedicated",
+          type: "json",
+          required: false,
+          description: "Admin only, and returned to admins only. Dedicated worker configuration. Absent means no workers are kept. Exclusive with warmPool and warmCache."
+        }
+      ],
+      files: [],
+      credentialOrganization: true
+    }
+  },
+  {
+    command: "custom-environment delete",
+    tool: "custom_environment_delete",
+    title: "Delete custom environment",
+    description: "Delete a custom environment. Workflows bound to it through `settings.custom_environment_id` can no longer boot. Refused while warm members exist: set `warmPool.targetSize` to 0 first and wait for them to retire.",
+    method: "DELETE",
+    path: "/agents/v2/custom-environments/{customEnvironmentId}",
+    args: [
+      {
+        name: "customEnvironmentId",
+        flag: "custom-environment-id",
+        type: "string",
+        required: true
+      }
+    ],
+    query: [],
+    binary: false,
+    readOnly: false,
+    destructive: true
+  },
   {
     command: "custom-environment get",
     tool: "custom_environment_get",
@@ -164,7 +254,7 @@ var COMMANDS = [
     command: "custom-environment list",
     tool: "custom_environments_list",
     title: "List custom environments",
-    description: "List an organization's custom environments: the saved machines a workflow boots on, each with its environment type, snapshot, networking, allowed profiles and warm pool. Use an environment's `id` as a workflow version's `settings.custom_environment_id`. Users create and edit custom environments on the platform's Environments page; no tool changes them.",
+    description: "List an organization's custom environments: the saved machines a workflow boots on, each with its environment type, snapshot, networking, allowed profiles and warm pool. Use an environment's `id` as a workflow version's `settings.custom_environment_id`.",
     method: "GET",
     path: "/agents/v2/custom-environments",
     args: [],
@@ -173,6 +263,103 @@ var COMMANDS = [
     readOnly: true,
     destructive: false
   },
+  {
+    command: "custom-environment member list",
+    tool: "custom_environment_members_list",
+    title: "List custom environment members",
+    description: "List a custom environment's warm pool members: each pre-warmed environment's ID, state (warming, available, retiring), profile, attached executions and keep-alive health. Empty when the environment is not kept warm.",
+    method: "GET",
+    path: "/agents/v2/custom-environments/{customEnvironmentId}/members",
+    args: [
+      {
+        name: "customEnvironmentId",
+        flag: "custom-environment-id",
+        type: "string",
+        required: true
+      }
+    ],
+    query: [],
+    binary: false,
+    readOnly: true,
+    destructive: false
+  },
+  {
+    command: "custom-environment update",
+    tool: "custom_environment_update",
+    title: "Update custom environment",
+    description: "Replace a custom environment's configuration. Send the full config, as `custom_environment_get` returns it: a field left out is cleared, except proxy passwords and a managed proxy's provider, which keep their stored values. Changes apply to environments booted afterwards. Turning keep-warm off is refused while members exist: set `warmPool.targetSize` to 0 first and wait for them to retire.",
+    method: "PATCH",
+    path: "/agents/v2/custom-environments/{customEnvironmentId}",
+    args: [
+      {
+        name: "customEnvironmentId",
+        flag: "custom-environment-id",
+        type: "string",
+        required: true
+      }
+    ],
+    query: [],
+    binary: false,
+    readOnly: false,
+    destructive: false,
+    body: {
+      required: true,
+      contentType: "application/json",
+      fields: [
+        {
+          name: "name",
+          flag: "name",
+          type: "string",
+          required: true,
+          description: "Name, unique within the organisation"
+        },
+        {
+          name: "base",
+          flag: "base",
+          type: "json",
+          required: true,
+          description: "The base machine: a browser, or a Linux / Windows OS environment. For non-admins, an OS base's `snapshotName` must be one of the organisation's snapshots or a public one; admins may name any snapshot. Omit it for the default image."
+        },
+        {
+          name: "profiles",
+          flag: "profiles",
+          type: "json",
+          required: true,
+          description: "Ordered whitelist of the profile sources an execution bound to this environment may run as. Each row gets its own warm copies. With one row, a trigger that names neither a profile nor a pool defaults to that row; with several rows, the trigger must name an allowed profile, a member of an allowed pool, or an allowed pool. Empty means any profile or pool may be named, or none."
+        },
+        {
+          name: "settings",
+          flag: "settings",
+          type: "json",
+          required: false,
+          description: "Settings the environment boots with. Must match the base type. Absent inherits from the agent profile. A change applies to environments booted afterwards; warm members already booted keep the settings they booted with."
+        },
+        {
+          name: "warmPool",
+          flag: "warm-pool",
+          type: "json",
+          required: false,
+          description: "Warm pool configuration. Absent means the environment is not kept warm. Exclusive with warmCache and dedicated."
+        },
+        {
+          name: "warmCache",
+          flag: "warm-cache",
+          type: "json",
+          required: false,
+          description: "Warm cache configuration. Absent means no login agent keeps the profiles' cookies fresh. Exclusive with warmPool and dedicated."
+        },
+        {
+          name: "dedicated",
+          flag: "dedicated",
+          type: "json",
+          required: false,
+          description: "Admin only, and returned to admins only. Dedicated worker configuration. Absent means no workers are kept. Exclusive with warmPool and warmCache."
+        }
+      ],
+      files: [],
+      credentialOrganization: false
+    }
+  },
   {
     command: "docs search",
     tool: "search_docs",
@@ -5550,7 +5737,7 @@ var ApiError = class extends Error {
   status;
   body;
 };
-var VERSION = "1.9.30";
+var VERSION = "1.9.33";
 function problem(status, body, fallback) {
   if (body && typeof body === "object") {
     const record2 = body;

package/dist/core.js

@@ -161,6 +161,96 @@ var COMMANDS = [
     readOnly: true,
     destructive: false
   },
+  {
+    command: "custom-environment create",
+    tool: "custom_environments_create",
+    title: "Create custom environment",
+    description: "Create a custom environment: a saved machine a workflow boots on. Set a unique `name` and a `base`: a browser, or a Linux or Windows OS environment. Optionally whitelist `profiles`, override boot `settings`, and keep copies ready with `warmPool` or fresh logins with `warmCache` (not both). Bind it to a workflow with the version's `settings.custom_environment_id`.",
+    method: "POST",
+    path: "/agents/v2/custom-environments",
+    args: [],
+    query: [],
+    binary: false,
+    readOnly: false,
+    destructive: false,
+    body: {
+      required: true,
+      contentType: "application/json",
+      fields: [
+        {
+          name: "name",
+          flag: "name",
+          type: "string",
+          required: true,
+          description: "Name, unique within the organisation"
+        },
+        {
+          name: "base",
+          flag: "base",
+          type: "json",
+          required: true,
+          description: "The base machine: a browser, or a Linux / Windows OS environment. For non-admins, an OS base's `snapshotName` must be one of the organisation's snapshots or a public one; admins may name any snapshot. Omit it for the default image."
+        },
+        {
+          name: "profiles",
+          flag: "profiles",
+          type: "json",
+          required: true,
+          description: "Ordered whitelist of the profile sources an execution bound to this environment may run as. Each row gets its own warm copies. With one row, a trigger that names neither a profile nor a pool defaults to that row; with several rows, the trigger must name an allowed profile, a member of an allowed pool, or an allowed pool. Empty means any profile or pool may be named, or none."
+        },
+        {
+          name: "settings",
+          flag: "settings",
+          type: "json",
+          required: false,
+          description: "Settings the environment boots with. Must match the base type. Absent inherits from the agent profile. A change applies to environments booted afterwards; warm members already booted keep the settings they booted with."
+        },
+        {
+          name: "warmPool",
+          flag: "warm-pool",
+          type: "json",
+          required: false,
+          description: "Warm pool configuration. Absent means the environment is not kept warm. Exclusive with warmCache and dedicated."
+        },
+        {
+          name: "warmCache",
+          flag: "warm-cache",
+          type: "json",
+          required: false,
+          description: "Warm cache configuration. Absent means no login agent keeps the profiles' cookies fresh. Exclusive with warmPool and dedicated."
+        },
+        {
+          name: "dedicated",
+          flag: "dedicated",
+          type: "json",
+          required: false,
+          description: "Admin only, and returned to admins only. Dedicated worker configuration. Absent means no workers are kept. Exclusive with warmPool and warmCache."
+        }
+      ],
+      files: [],
+      credentialOrganization: true
+    }
+  },
+  {
+    command: "custom-environment delete",
+    tool: "custom_environment_delete",
+    title: "Delete custom environment",
+    description: "Delete a custom environment. Workflows bound to it through `settings.custom_environment_id` can no longer boot. Refused while warm members exist: set `warmPool.targetSize` to 0 first and wait for them to retire.",
+    method: "DELETE",
+    path: "/agents/v2/custom-environments/{customEnvironmentId}",
+    args: [
+      {
+        name: "customEnvironmentId",
+        flag: "custom-environment-id",
+        type: "string",
+        required: true
+      }
+    ],
+    query: [],
+    binary: false,
+    readOnly: false,
+    destructive: true
+  },
   {
     command: "custom-environment get",
     tool: "custom_environment_get",
@@ -185,7 +275,7 @@ var COMMANDS = [
     command: "custom-environment list",
     tool: "custom_environments_list",
     title: "List custom environments",
-    description: "List an organization's custom environments: the saved machines a workflow boots on, each with its environment type, snapshot, networking, allowed profiles and warm pool. Use an environment's `id` as a workflow version's `settings.custom_environment_id`. Users create and edit custom environments on the platform's Environments page; no tool changes them.",
+    description: "List an organization's custom environments: the saved machines a workflow boots on, each with its environment type, snapshot, networking, allowed profiles and warm pool. Use an environment's `id` as a workflow version's `settings.custom_environment_id`.",
     method: "GET",
     path: "/agents/v2/custom-environments",
     args: [],
@@ -194,6 +284,103 @@ var COMMANDS = [
     readOnly: true,
     destructive: false
   },
+  {
+    command: "custom-environment member list",
+    tool: "custom_environment_members_list",
+    title: "List custom environment members",
+    description: "List a custom environment's warm pool members: each pre-warmed environment's ID, state (warming, available, retiring), profile, attached executions and keep-alive health. Empty when the environment is not kept warm.",
+    method: "GET",
+    path: "/agents/v2/custom-environments/{customEnvironmentId}/members",
+    args: [
+      {
+        name: "customEnvironmentId",
+        flag: "custom-environment-id",
+        type: "string",
+        required: true
+      }
+    ],
+    query: [],
+    binary: false,
+    readOnly: true,
+    destructive: false
+  },
+  {
+    command: "custom-environment update",
+    tool: "custom_environment_update",
+    title: "Update custom environment",
+    description: "Replace a custom environment's configuration. Send the full config, as `custom_environment_get` returns it: a field left out is cleared, except proxy passwords and a managed proxy's provider, which keep their stored values. Changes apply to environments booted afterwards. Turning keep-warm off is refused while members exist: set `warmPool.targetSize` to 0 first and wait for them to retire.",
+    method: "PATCH",
+    path: "/agents/v2/custom-environments/{customEnvironmentId}",
+    args: [
+      {
+        name: "customEnvironmentId",
+        flag: "custom-environment-id",
+        type: "string",
+        required: true
+      }
+    ],
+    query: [],
+    binary: false,
+    readOnly: false,
+    destructive: false,
+    body: {
+      required: true,
+      contentType: "application/json",
+      fields: [
+        {
+          name: "name",
+          flag: "name",
+          type: "string",
+          required: true,
+          description: "Name, unique within the organisation"
+        },
+        {
+          name: "base",
+          flag: "base",
+          type: "json",
+          required: true,
+          description: "The base machine: a browser, or a Linux / Windows OS environment. For non-admins, an OS base's `snapshotName` must be one of the organisation's snapshots or a public one; admins may name any snapshot. Omit it for the default image."
+        },
+        {
+          name: "profiles",
+          flag: "profiles",
+          type: "json",
+          required: true,
+          description: "Ordered whitelist of the profile sources an execution bound to this environment may run as. Each row gets its own warm copies. With one row, a trigger that names neither a profile nor a pool defaults to that row; with several rows, the trigger must name an allowed profile, a member of an allowed pool, or an allowed pool. Empty means any profile or pool may be named, or none."
+        },
+        {
+          name: "settings",
+          flag: "settings",
+          type: "json",
+          required: false,
+          description: "Settings the environment boots with. Must match the base type. Absent inherits from the agent profile. A change applies to environments booted afterwards; warm members already booted keep the settings they booted with."
+        },
+        {
+          name: "warmPool",
+          flag: "warm-pool",
+          type: "json",
+          required: false,
+          description: "Warm pool configuration. Absent means the environment is not kept warm. Exclusive with warmCache and dedicated."
+        },
+        {
+          name: "warmCache",
+          flag: "warm-cache",
+          type: "json",
+          required: false,
+          description: "Warm cache configuration. Absent means no login agent keeps the profiles' cookies fresh. Exclusive with warmPool and dedicated."
+        },
+        {
+          name: "dedicated",
+          flag: "dedicated",
+          type: "json",
+          required: false,
+          description: "Admin only, and returned to admins only. Dedicated worker configuration. Absent means no workers are kept. Exclusive with warmPool and warmCache."
+        }
+      ],
+      files: [],
+      credentialOrganization: false
+    }
+  },
   {
     command: "docs search",
     tool: "search_docs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteroidai/cli",
-  "version": "1.9.30",
+  "version": "1.9.33",
   "description": "The asteroid command-line interface for the Asteroid platform.",
   "type": "module",
   "license": "MIT",