Update api spec (#177)

* YOYO NEW API SPEC!

* I have generated the latest API!

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: zoo-github-actions-auth[bot]

examples_test.go

@@ -33,7 +33,7 @@
  },
  {
   "value": {
-   "example": "// CreateTextToCad: Generate a CAD model from text.\n// \n// Because our source of truth for the resulting model is a STEP file, you will always have STEP file contents when you list your generated models. Any other formats you request here will also be returned when you list your generated models.\n// \n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n// \n// One thing to note, if you hit the cache, this endpoint will return right away. So you only have to wait if the status is not `Completed` or `Failed`.\n// \n// \n// Parameters\n// \n// \t- `outputFormat`: The valid types of output file formats.\n// \t- `kcl`\n// \t- `body`: Body for generating models from text.\n// \n// CreateTextToCad: Generate a CAD model from text.\n// Because our source of truth for the resulting model is a STEP file, you will always have STEP file contents when you list your generated models. Any other formats you request here will also be returned when you list your generated models.\n//\n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n//\n// One thing to note, if you hit the cache, this endpoint will return right away. So you only have to wait if the status is not `Completed` or `Failed`.\n//\n// Parameters\n//\n//   - `outputFormat`: The valid types of output file formats.\n//   - `kcl`\n//   - `body`: Body for generating models from text.\nfunc ExampleMlService_CreateTextToCad() {\n\tclient, err := kittycad.NewClientFromEnv(\"your apps user agent\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tresult, err := client.Ml.CreateTextToCad(\"\", true, kittycad.TextToCadCreateBody{Prompt: \"some-string\"})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%#v\", result)\n\n}\n",
+   "example": "// CreateTextToCad: Generate a CAD model from text.\n// \n// Because our source of truth for the resulting model is a STEP file, you will always have STEP file contents when you list your generated models. Any other formats you request here will also be returned when you list your generated models.\n// \n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n// \n// One thing to note, if you hit the cache, this endpoint will return right away. So you only have to wait if the status is not `Completed` or `Failed`.\n// \n// \n// Parameters\n// \n// \t- `outputFormat`: The valid types of output file formats.\n// \t- `kcl`\n// \t- `body`: Body for generating models from text.\n// \n// CreateTextToCad: Generate a CAD model from text.\n// Because our source of truth for the resulting model is a STEP file, you will always have STEP file contents when you list your generated models. Any other formats you request here will also be returned when you list your generated models.\n//\n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n//\n// One thing to note, if you hit the cache, this endpoint will return right away. So you only have to wait if the status is not `Completed` or `Failed`.\n//\n// Parameters\n//\n//   - `outputFormat`: The valid types of output file formats.\n//   - `kcl`\n//   - `body`: Body for generating models from text.\nfunc ExampleMlService_CreateTextToCad() {\n\tclient, err := kittycad.NewClientFromEnv(\"your apps user agent\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tresult, err := client.Ml.CreateTextToCad(\"\", true, kittycad.TextToCadCreateBody{KclVersion: \"some-string\", ProjectName: \"some-string\", Prompt: \"some-string\"})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%#v\", result)\n\n}\n",
    "libDocsLink": "https://pkg.go.dev/github.com/kittycad/kittycad.go/#MlService.CreateTextToCad"
   },
   "op": "add",
@@ -257,7 +257,7 @@
  },
  {
   "value": {
-   "example": "// CreateTextToCadIteration: Iterate on a CAD model with a prompt.\n// \n// Even if you give specific ranges to edit, the model might change more than just those in order to make the changes you requested without breaking the code.\n// \n// You always get the whole code back, even if you only changed a small part of it.\n// \n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n// \n// This endpoint will soon be deprecated in favor of the `/ml/text-to-cad/multi-file/iteration` endpoint. In that the endpoint path will remain but it will have the same behavior as `ml/text-to-cad/multi-file/iteration`.\n// \n// \n// Parameters\n// \n// \t- `body`: Body for generating models from text.\n// \n// CreateTextToCadIteration: Iterate on a CAD model with a prompt.\n// Even if you give specific ranges to edit, the model might change more than just those in order to make the changes you requested without breaking the code.\n//\n// You always get the whole code back, even if you only changed a small part of it.\n//\n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n//\n// This endpoint will soon be deprecated in favor of the `/ml/text-to-cad/multi-file/iteration` endpoint. In that the endpoint path will remain but it will have the same behavior as `ml/text-to-cad/multi-file/iteration`.\n//\n// Parameters\n//\n//   - `body`: Body for generating models from text.\nfunc ExampleMlService_CreateTextToCadIteration() {\n\tclient, err := kittycad.NewClientFromEnv(\"your apps user agent\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tresult, err := client.Ml.CreateTextToCadIteration(kittycad.TextToCadIterationBody{OriginalSourceCode: \"some-string\", Prompt: \"some-string\", SourceRanges: []kittycad.SourceRangePrompt{kittycad.SourceRangePrompt{File: \"some-string\", Prompt: \"some-string\", Range: kittycad.SourceRange{End: kittycad.SourcePosition{Column: 123, Line: 123}, Start: kittycad.SourcePosition{Column: 123, Line: 123}}}}})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%#v\", result)\n\n}\n",
+   "example": "// CreateTextToCadIteration: Iterate on a CAD model with a prompt.\n// \n// Even if you give specific ranges to edit, the model might change more than just those in order to make the changes you requested without breaking the code.\n// \n// You always get the whole code back, even if you only changed a small part of it.\n// \n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n// \n// This endpoint will soon be deprecated in favor of the `/ml/text-to-cad/multi-file/iteration` endpoint. In that the endpoint path will remain but it will have the same behavior as `ml/text-to-cad/multi-file/iteration`.\n// \n// \n// Parameters\n// \n// \t- `body`: Body for generating models from text.\n// \n// CreateTextToCadIteration: Iterate on a CAD model with a prompt.\n// Even if you give specific ranges to edit, the model might change more than just those in order to make the changes you requested without breaking the code.\n//\n// You always get the whole code back, even if you only changed a small part of it.\n//\n// This operation is performed asynchronously, the `id` of the operation will be returned. You can use the `id` returned from the request to get status information about the async operation from the `/async/operations/{id}` endpoint.\n//\n// This endpoint will soon be deprecated in favor of the `/ml/text-to-cad/multi-file/iteration` endpoint. In that the endpoint path will remain but it will have the same behavior as `ml/text-to-cad/multi-file/iteration`.\n//\n// Parameters\n//\n//   - `body`: Body for generating models from text.\nfunc ExampleMlService_CreateTextToCadIteration() {\n\tclient, err := kittycad.NewClientFromEnv(\"your apps user agent\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tresult, err := client.Ml.CreateTextToCadIteration(kittycad.TextToCadIterationBody{KclVersion: \"some-string\", OriginalSourceCode: \"some-string\", ProjectName: \"some-string\", Prompt: \"some-string\", SourceRanges: []kittycad.SourceRangePrompt{kittycad.SourceRangePrompt{File: \"some-string\", Prompt: \"some-string\", Range: kittycad.SourceRange{End: kittycad.SourcePosition{Column: 123, Line: 123}, Start: kittycad.SourcePosition{Column: 123, Line: 123}}}}})\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\n\tfmt.Printf(\"%#v\", result)\n\n}\n",
    "libDocsLink": "https://pkg.go.dev/github.com/kittycad/kittycad.go/#MlService.CreateTextToCadIteration"
   },
   "op": "add",

kittycad.go.patch.json

@@ -21540,6 +21540,11 @@
               }
             ]
           },
+          "kcl_version": {
+            "nullable": true,
+            "description": "The KCL version being used.",
+            "type": "string"
+          },
           "metadata": {
             "nullable": true,
             "description": "The metadata for the prompt.",
@@ -21558,6 +21563,11 @@
             "description": "The output file. In the case of TextToCad this is a link to a file in a GCP bucket.",
             "type": "string"
           },
+          "project_name": {
+            "nullable": true,
+            "description": "The name of the project, if any. This allows us to group prompts together that come from the same project and user.",
+            "type": "string"
+          },
           "prompt": {
             "description": "The prompt.",
             "type": "string"
@@ -30806,6 +30816,16 @@
         "description": "Body for generating models from text.",
         "type": "object",
         "properties": {
+          "kcl_version": {
+            "nullable": true,
+            "description": "The version of kcl to use. If empty, the latest version will be used.",
+            "type": "string"
+          },
+          "project_name": {
+            "nullable": true,
+            "description": "The project name. This is used to tie the prompt to a project. Which helps us make our models better over time.",
+            "type": "string"
+          },
           "prompt": {
             "description": "The prompt for the model.",
             "type": "string"
@@ -30933,10 +30953,20 @@
         "description": "Body for generating models from text.",
         "type": "object",
         "properties": {
+          "kcl_version": {
+            "nullable": true,
+            "description": "The version of kcl to use. If empty, the latest version will be used.",
+            "type": "string"
+          },
           "original_source_code": {
             "description": "The source code for the model (in kcl) that is to be edited.",
             "type": "string"
           },
+          "project_name": {
+            "nullable": true,
+            "description": "The project name. This is used to tie the prompt to a project. Which helps us make our models better over time.",
+            "type": "string"
+          },
           "prompt": {
             "nullable": true,
             "description": "The prompt for the model, if not using source ranges.",
@@ -31091,6 +31121,16 @@
         "description": "Body for generating models from text.",
         "type": "object",
         "properties": {
+          "kcl_version": {
+            "nullable": true,
+            "description": "The version of kcl to use. If empty, the latest version will be used.",
+            "type": "string"
+          },
+          "project_name": {
+            "nullable": true,
+            "description": "The project name. This is used to tie the prompt to a project. Which helps us make our models better over time.",
+            "type": "string"
+          },
           "source_ranges": {
             "description": "The source ranges the user suggested to change. If empty, the prompt will be used and is required.",
             "type": "array",