asteroid-odyssey 1.7.269 → 1.7.271

package/dist/index.d.mts

@@ -609,6 +609,10 @@ type AgentsGraphModelsExternalSettings = {
      * Whether to use the new agent loop for execution (beta)
      */
     new_agent_loop?: boolean;
+    /**
+     * Whether this agent has variants — one workflow driving many per-variant script trees, selected at execution time by `variantKey`. Required for a node's `script_filepath` to use the `{{variant_key}}` placeholder, and required for an execution to carry a `variantKey`.
+     */
+    variant_mode?: boolean;
 };
 /**
  * Browser provider type
@@ -780,11 +784,12 @@ type AgentsGraphModelsNodesPropertiesIrisProperties = {
      * prefix.
      * - Must end in `.js`.
      * - Must not contain `..` segments or duplicate slashes.
-     * - May contain a single `{{shared_storage_key}}` placeholder, which
-     * the runtime substitutes with the execution's `shared_storage_key`
-     * so a single workflow can target per-tenant script trees (e.g.
-     * `{{shared_storage_key}}/scripts/main.js` →
-     * `shared/<node-key>/<storage-key>/scripts/main.js`).
+     * - May contain a single `{{variant_key}}` placeholder, which the
+     * runtime substitutes with the execution's `variant_key` so a single
+     * workflow can target per-tenant script trees (e.g.
+     * `{{variant_key}}/scripts/main.js` →
+     * `shared/<node-key>/<variant-key>/scripts/main.js`). Requires the
+     * agent to have `variant_mode` enabled.
      */
     script_filepath?: string;
     /**
@@ -916,9 +921,9 @@ type AgentsWorkflowExecuteWorkflowRequest = {
  */
 type AgentsAgentExecutionOptions = {
     /**
-     * Scopes shared-file storage to a per-entity subdirectory under each node's shared folder. The value is normalised to a filesystem-safe slug by the server.
+     * Identifies which variant this execution is for, scoping its shared files and scripts to a per-variant subdirectory under each node's shared folder. It does not change which agent or workflow runs. Normalised to a filesystem-safe slug by the server. Requires the agent to have `variant_mode` enabled, and a variant-mode agent requires it on every execution.
      */
-    sharedStorageKey?: string;
+    variantKey?: string;
     /**
      * Soft timeout in minutes. When the execution has been running longer than this value, a message is injected on every subsequent step urging the agent to wrap up and produce output. Must be greater than 0 and less than the agent's hard timeout (max_timeout_mins).
      */
@@ -2201,7 +2206,7 @@ type AgentsExecutionListItem = {
      */
     triggerContext?: AgentsExecutionTriggerContext;
     /**
-     * Per-execution runtime options (e.g. shared storage key)
+     * Per-execution runtime options (e.g. variant key)
      */
     executionOptions?: AgentsAgentExecutionOptions;
     /**

package/dist/index.d.ts

@@ -609,6 +609,10 @@ type AgentsGraphModelsExternalSettings = {
      * Whether to use the new agent loop for execution (beta)
      */
     new_agent_loop?: boolean;
+    /**
+     * Whether this agent has variants — one workflow driving many per-variant script trees, selected at execution time by `variantKey`. Required for a node's `script_filepath` to use the `{{variant_key}}` placeholder, and required for an execution to carry a `variantKey`.
+     */
+    variant_mode?: boolean;
 };
 /**
  * Browser provider type
@@ -780,11 +784,12 @@ type AgentsGraphModelsNodesPropertiesIrisProperties = {
      * prefix.
      * - Must end in `.js`.
      * - Must not contain `..` segments or duplicate slashes.
-     * - May contain a single `{{shared_storage_key}}` placeholder, which
-     * the runtime substitutes with the execution's `shared_storage_key`
-     * so a single workflow can target per-tenant script trees (e.g.
-     * `{{shared_storage_key}}/scripts/main.js` →
-     * `shared/<node-key>/<storage-key>/scripts/main.js`).
+     * - May contain a single `{{variant_key}}` placeholder, which the
+     * runtime substitutes with the execution's `variant_key` so a single
+     * workflow can target per-tenant script trees (e.g.
+     * `{{variant_key}}/scripts/main.js` →
+     * `shared/<node-key>/<variant-key>/scripts/main.js`). Requires the
+     * agent to have `variant_mode` enabled.
      */
     script_filepath?: string;
     /**
@@ -916,9 +921,9 @@ type AgentsWorkflowExecuteWorkflowRequest = {
  */
 type AgentsAgentExecutionOptions = {
     /**
-     * Scopes shared-file storage to a per-entity subdirectory under each node's shared folder. The value is normalised to a filesystem-safe slug by the server.
+     * Identifies which variant this execution is for, scoping its shared files and scripts to a per-variant subdirectory under each node's shared folder. It does not change which agent or workflow runs. Normalised to a filesystem-safe slug by the server. Requires the agent to have `variant_mode` enabled, and a variant-mode agent requires it on every execution.
      */
-    sharedStorageKey?: string;
+    variantKey?: string;
     /**
      * Soft timeout in minutes. When the execution has been running longer than this value, a message is injected on every subsequent step urging the agent to wrap up and produce output. Must be greater than 0 and less than the agent's hard timeout (max_timeout_mins).
      */
@@ -2201,7 +2206,7 @@ type AgentsExecutionListItem = {
      */
     triggerContext?: AgentsExecutionTriggerContext;
     /**
-     * Per-execution runtime options (e.g. shared storage key)
+     * Per-execution runtime options (e.g. variant key)
      */
     executionOptions?: AgentsAgentExecutionOptions;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asteroid-odyssey",
-  "version": "1.7.269",
+  "version": "1.7.271",
   "description": "SDK for interacting with Asteroid Agents API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",