Expose resource based autotuning (#293)

.github/workflows/ci.yml

@@ -60,15 +60,23 @@ jobs:
 
       - name: Regen confirm unchanged
         if: ${{ matrix.checkTarget }}
-        # Needs to be 16.0.0 until https://github.com/dotnet/ClangSharp/pull/506 released
         run: |
-          dotnet tool install --global --version 16.0.0 ClangSharpPInvokeGenerator
+          dotnet tool install --global --version 18.1.0 ClangSharpPInvokeGenerator
           ClangSharpPInvokeGenerator @src/Temporalio/Bridge/GenerateInterop.rsp
           dotnet run --project src/Temporalio.Api.Generator
           npx doctoc README.md
           git config --global core.safecrlf false
+          git diff > generator.diff
           git diff --exit-code
 
+      - name: Upload generator diff
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: generator-diff
+          path: generator.diff
+          if-no-files-found: ignore
+
       - name: Check format
         if: ${{ matrix.checkTarget }}
         run: dotnet format --verify-no-changes

README.md

@@ -1208,6 +1208,9 @@ Then, run:
 The Rust DLL is built automatically when the project is built. `protoc` may need to be on the `PATH` to build the Rust
 DLL.
 
+This can be annoying to install on linux - so alternatively, publish your PR and you can download the
+patch from the windows build when it fails because of a mismatch. It uploads the patch as an artifact.
+
 ### Regenerating protos
 
 Must have `protoc` on the `PATH`. Note, for now users should use `protoc` 23.x until

src/Temporalio/Api/Enums/V1/FailedCause.cs

@@ -95,21 +95,23 @@ static FailedCauseReflection() {
             "RUNVVElPTl9OT1RfRk9VTkQQARJHCkNTSUdOQUxfRVhURVJOQUxfV09SS0ZM",
             "T1dfRVhFQ1VUSU9OX0ZBSUxFRF9DQVVTRV9OQU1FU1BBQ0VfTk9UX0ZPVU5E",
             "EAISTwpLU0lHTkFMX0VYVEVSTkFMX1dPUktGTE9XX0VYRUNVVElPTl9GQUlM",
-            "RURfQ0FVU0VfU0lHTkFMX0NPVU5UX0xJTUlUX0VYQ0VFREVEEAMqzQIKFlJl",
+            "RURfQ0FVU0VfU0lHTkFMX0NPVU5UX0xJTUlUX0VYQ0VFREVEEAMqhQMKFlJl",
             "c291cmNlRXhoYXVzdGVkQ2F1c2USKAokUkVTT1VSQ0VfRVhIQVVTVEVEX0NB",
             "VVNFX1VOU1BFQ0lGSUVEEAASJgoiUkVTT1VSQ0VfRVhIQVVTVEVEX0NBVVNF",
             "X1JQU19MSU1JVBABEi0KKVJFU09VUkNFX0VYSEFVU1RFRF9DQVVTRV9DT05D",
             "VVJSRU5UX0xJTUlUEAISLgoqUkVTT1VSQ0VfRVhIQVVTVEVEX0NBVVNFX1NZ",
             "U1RFTV9PVkVSTE9BREVEEAMSLgoqUkVTT1VSQ0VfRVhIQVVTVEVEX0NBVVNF",
             "X1BFUlNJU1RFTkNFX0xJTUlUEAQSKgomUkVTT1VSQ0VfRVhIQVVTVEVEX0NB",
             "VVNFX0JVU1lfV09SS0ZMT1cQBRImCiJSRVNPVVJDRV9FWEhBVVNURURfQ0FV",
-            "U0VfQVBTX0xJTUlUEAYqjwEKFlJlc291cmNlRXhoYXVzdGVkU2NvcGUSKAok",
-            "UkVTT1VSQ0VfRVhIQVVTVEVEX1NDT1BFX1VOU1BFQ0lGSUVEEAASJgoiUkVT",
-            "T1VSQ0VfRVhIQVVTVEVEX1NDT1BFX05BTUVTUEFDRRABEiMKH1JFU09VUkNF",
-            "X0VYSEFVU1RFRF9TQ09QRV9TWVNURU0QAkKIAQoYaW8udGVtcG9yYWwuYXBp",
-            "LmVudW1zLnYxQhBGYWlsZWRDYXVzZVByb3RvUAFaIWdvLnRlbXBvcmFsLmlv",
-            "L2FwaS9lbnVtcy92MTtlbnVtc6oCF1RlbXBvcmFsaW8uQXBpLkVudW1zLlYx",
-            "6gIaVGVtcG9yYWxpbzo6QXBpOjpFbnVtczo6VjFiBnByb3RvMw=="));
+            "U0VfQVBTX0xJTUlUEAYSNgoyUkVTT1VSQ0VfRVhIQVVTVEVEX0NBVVNFX1BF",
+            "UlNJU1RFTkNFX1NUT1JBR0VfTElNSVQQByqPAQoWUmVzb3VyY2VFeGhhdXN0",
+            "ZWRTY29wZRIoCiRSRVNPVVJDRV9FWEhBVVNURURfU0NPUEVfVU5TUEVDSUZJ",
+            "RUQQABImCiJSRVNPVVJDRV9FWEhBVVNURURfU0NPUEVfTkFNRVNQQUNFEAES",
+            "IwofUkVTT1VSQ0VfRVhIQVVTVEVEX1NDT1BFX1NZU1RFTRACQogBChhpby50",
+            "ZW1wb3JhbC5hcGkuZW51bXMudjFCEEZhaWxlZENhdXNlUHJvdG9QAVohZ28u",
+            "dGVtcG9yYWwuaW8vYXBpL2VudW1zL3YxO2VudW1zqgIXVGVtcG9yYWxpby5B",
+            "cGkuRW51bXMuVjHqAhpUZW1wb3JhbGlvOjpBcGk6OkVudW1zOjpWMWIGcHJv",
+            "dG8z"));
       descriptor = pbr::FileDescriptor.FromGeneratedCode(descriptorData,
           new pbr::FileDescriptor[] { },
           new pbr::GeneratedClrTypeInfo(new[] {typeof(global::Temporalio.Api.Enums.V1.WorkflowTaskFailedCause), typeof(global::Temporalio.Api.Enums.V1.StartChildWorkflowExecutionFailedCause), typeof(global::Temporalio.Api.Enums.V1.CancelExternalWorkflowExecutionFailedCause), typeof(global::Temporalio.Api.Enums.V1.SignalExternalWorkflowExecutionFailedCause), typeof(global::Temporalio.Api.Enums.V1.ResourceExhaustedCause), typeof(global::Temporalio.Api.Enums.V1.ResourceExhaustedScope), }, null, null));
@@ -264,6 +266,10 @@ public enum ResourceExhaustedCause {
     /// Caller exceeds action per second limit.
     /// </summary>
     [pbr::OriginalName("RESOURCE_EXHAUSTED_CAUSE_APS_LIMIT")] ApsLimit = 6,
+    /// <summary>
+    /// Persistence storage limit exceeded.
+    /// </summary>
+    [pbr::OriginalName("RESOURCE_EXHAUSTED_CAUSE_PERSISTENCE_STORAGE_LIMIT")] PersistenceStorageLimit = 7,
   }
 
   public enum ResourceExhaustedScope {

src/Temporalio/Api/Enums/V1/TaskQueue.cs

@@ -124,8 +124,13 @@ public enum TaskReachability {
 
   /// <summary>
   /// Specifies which category of tasks may reach a versioned worker of a certain Build ID.
+  ///
+  /// Task Reachability is eventually consistent; there may be a delay until it converges to the most
+  /// accurate value but it is designed in a way to take the more conservative side until it converges.
+  /// For example REACHABLE is more conservative than CLOSED_WORKFLOWS_ONLY.
+  ///
   /// Note: future activities who inherit their workflow's Build ID but not its Task Queue will not be
-  /// accounted for reachability as server cannot not know if they'll happen as they do not use
+  /// accounted for reachability as server cannot know if they'll happen as they do not use
   /// assignment rules of their Task Queue. Same goes for Child Workflows or Continue-As-New Workflows
   /// who inherit the parent/previous workflow's Build ID but not its Task Queue. In those cases, make
   /// sure to query reachability for the parent/previous workflow's Task Queue as well.
@@ -136,8 +141,8 @@ public enum BuildIdTaskReachability {
     /// </summary>
     [pbr::OriginalName("BUILD_ID_TASK_REACHABILITY_UNSPECIFIED")] Unspecified = 0,
     /// <summary>
-    /// Build ID may be used by new workflows or activities (base on versioning rules), or there are
-    /// open workflows or backlogged activities assigned to it.
+    /// Build ID may be used by new workflows or activities (base on versioning rules), or there MAY
+    /// be open workflows or backlogged activities assigned to it.
     /// </summary>
     [pbr::OriginalName("BUILD_ID_TASK_REACHABILITY_REACHABLE")] Reachable = 1,
     /// <summary>