asteroid-odyssey 1.8.140 → 1.8.142

package/dist/index.d.mts

@@ -400,9 +400,13 @@ type AgentsAgentExecuteAgentRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -465,9 +469,13 @@ type AgentsAgentExecuteAgentSyncRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -4226,11 +4234,13 @@ type AgentsVaultVaultTemplate = {
  */
 type AgentsWorkflowBrowserProvider = "anchor";
 /**
- * Browser environment template configuration
+ * Customer-facing browser environment template configuration
  */
 type AgentsWorkflowBrowserTemplateConfig = {
     /**
-     * Browser provider type
+     * Ignored, and always anchor. Kept so SDKs released before it was dropped still parse.
+     *
+     * @deprecated
      */
     provider: AgentsWorkflowBrowserProvider;
 };
@@ -5070,9 +5080,9 @@ type WorkflowsWorkflowCreateRequest = {
      */
     name: string;
     /**
-     * The first version of the workflow
+     * The first version of the workflow. Omit it to start from a blank workflow with a single start node.
      */
-    version: WorkflowsVersionCreateRequest;
+    version?: WorkflowsVersionCreateRequest;
 };
 /**
  * Response after creating a workflow
@@ -5160,9 +5170,13 @@ type WorkflowsWorkflowExecuteRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -5228,9 +5242,13 @@ type WorkflowsWorkflowExecuteSyncRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -11866,7 +11884,7 @@ declare const workflowList: <ThrowOnError extends boolean = false>(options?: Opt
 /**
  * Create workflow
  *
- * Create a workflow and its first version.
+ * Create a workflow and its first version. Without a version, the workflow starts blank with a single start node.
  */
 declare const workflowCreate: <ThrowOnError extends boolean = false>(options: Options<WorkflowCreateData, ThrowOnError>) => RequestResult<WorkflowCreateResponses, WorkflowCreateErrors, ThrowOnError>;
 /**
@@ -11896,7 +11914,7 @@ declare const workflowByIdUpdate: <ThrowOnError extends boolean = false>(options
 /**
  * Execute workflow
  *
- * Start an execution of the workflow's published version, or of the version given in the request.
+ * Start an execution of the workflow's published version, of the version given in the request, or of the editable head when head is true.
  */
 declare const workflowExecutePost: <ThrowOnError extends boolean = false>(options: Options<WorkflowExecutePostData, ThrowOnError>) => RequestResult<WorkflowExecutePostResponses, WorkflowExecutePostErrors, ThrowOnError>;
 /**

package/dist/index.d.ts

@@ -400,9 +400,13 @@ type AgentsAgentExecuteAgentRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -465,9 +469,13 @@ type AgentsAgentExecuteAgentSyncRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -4226,11 +4234,13 @@ type AgentsVaultVaultTemplate = {
  */
 type AgentsWorkflowBrowserProvider = "anchor";
 /**
- * Browser environment template configuration
+ * Customer-facing browser environment template configuration
  */
 type AgentsWorkflowBrowserTemplateConfig = {
     /**
-     * Browser provider type
+     * Ignored, and always anchor. Kept so SDKs released before it was dropped still parse.
+     *
+     * @deprecated
      */
     provider: AgentsWorkflowBrowserProvider;
 };
@@ -5070,9 +5080,9 @@ type WorkflowsWorkflowCreateRequest = {
      */
     name: string;
     /**
-     * The first version of the workflow
+     * The first version of the workflow. Omit it to start from a blank workflow with a single start node.
      */
-    version: WorkflowsVersionCreateRequest;
+    version?: WorkflowsVersionCreateRequest;
 };
 /**
  * Response after creating a workflow
@@ -5160,9 +5170,13 @@ type WorkflowsWorkflowExecuteRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -5228,9 +5242,13 @@ type WorkflowsWorkflowExecuteSyncRequest = {
         [key: string]: unknown;
     };
     /**
-     * The version of the workflow to execute. If not provided, the published version is used.
+     * The version of the workflow to execute. If neither version nor head is provided, the published version is used.
      */
     version?: number;
+    /**
+     * Run the editable head instead of the published version. Cannot be combined with version.
+     */
+    head?: boolean;
     /**
      * Per-execution runtime options that override or extend the workflow's default settings.
      */
@@ -11866,7 +11884,7 @@ declare const workflowList: <ThrowOnError extends boolean = false>(options?: Opt
 /**
  * Create workflow
  *
- * Create a workflow and its first version.
+ * Create a workflow and its first version. Without a version, the workflow starts blank with a single start node.
  */
 declare const workflowCreate: <ThrowOnError extends boolean = false>(options: Options<WorkflowCreateData, ThrowOnError>) => RequestResult<WorkflowCreateResponses, WorkflowCreateErrors, ThrowOnError>;
 /**
@@ -11896,7 +11914,7 @@ declare const workflowByIdUpdate: <ThrowOnError extends boolean = false>(options
 /**
  * Execute workflow
  *
- * Start an execution of the workflow's published version, or of the version given in the request.
+ * Start an execution of the workflow's published version, of the version given in the request, or of the editable head when head is true.
  */
 declare const workflowExecutePost: <ThrowOnError extends boolean = false>(options: Options<WorkflowExecutePostData, ThrowOnError>) => RequestResult<WorkflowExecutePostResponses, WorkflowExecutePostErrors, ThrowOnError>;
 /**

package/package.json

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