@temporalio/core-bridge 1.13.0 → 1.13.2

package/Cargo.toml

@@ -25,28 +25,28 @@ async-trait = "0.1.83"
 bridge-macros = { path = "bridge-macros" }
 futures = { version = "0.3", features = ["executor"] }
 neon = { version = "1.0.0", default-features = false, features = [
-    "napi-6",
-    "futures",
+  "napi-6",
+  "futures",
 ] }
-opentelemetry = "0.29"
+opentelemetry = "0.31"
 os_pipe = "1.2.1"
 parking_lot = "0.12"
-prost = "0.13"
-prost-types = "0.13"
+prost = "0.14"
+prost-types = "0.14"
 serde = { version = "1.0", features = ["derive"] }
 serde_json = "1.0"
 temporal-sdk-core = { version = "*", path = "./sdk-core/core", features = [
-    "ephemeral-server",
+  "ephemeral-server",
 ] }
 temporal-client = { version = "*", path = "./sdk-core/client" }
 thiserror = "2"
 tokio = "1.13"
 tokio-stream = "0.1"
-tonic = "0.13"
+tonic = "0.14"
 tracing = "0.1"
 tracing-subscriber = { version = "0.3", default-features = false, features = [
-    "parking_lot",
-    "env-filter",
-    "registry",
-    "ansi",
+  "parking_lot",
+  "env-filter",
+  "registry",
+  "ansi",
 ] }

package/lib/native.d.ts

@@ -78,7 +78,7 @@ export interface OtelMetricsExporterOptions {
     protocol: 'http' | 'grpc';
 }
 export declare function newClient(runtime: Runtime, clientOptions: ClientOptions): Promise<Client>;
-export declare function clientUpdateHeaders(client: Client, headers: Record<string, string>): void;
+export declare function clientUpdateHeaders(client: Client, headers: Record<string, MetadataValue>): void;
 export declare function clientUpdateApiKey(client: Client, apiKey: string): void;
 export declare function clientSendWorkflowServiceRequest(client: Client, call: RpcCall): Promise<Buffer>;
 export declare function clientSendOperatorServiceRequest(client: Client, call: RpcCall): Promise<Buffer>;
@@ -94,7 +94,7 @@ export interface ClientOptions {
     clientVersion: string;
     tls: Option<TLSConfig>;
     httpConnectProxy: Option<HttpConnectProxy>;
-    headers: Option<Record<string, string>>;
+    headers: Option<Record<string, MetadataValue>>;
     apiKey: Option<string>;
     disableErrorCodeMetricTags: boolean;
 }
@@ -122,7 +122,7 @@ export interface RpcCall {
     rpc: string;
     req: Buffer;
     retry: boolean;
-    metadata: Record<string, string>;
+    metadata: Record<string, MetadataValue>;
     timeout: Option<number>;
 }
 export declare function newWorker(client: Client, workerOptions: WorkerOptions): Worker;
@@ -139,6 +139,13 @@ export declare function workerFinalizeShutdown(worker: Worker): Promise<void>;
 export interface Worker {
     type: 'worker';
 }
+export type MetadataValue = {
+    type: 'ascii';
+    value: string;
+} | {
+    type: 'binary';
+    value: Buffer;
+};
 export interface WorkerOptions {
     identity: string;
     buildId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temporalio/core-bridge",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "description": "Temporal.io SDK Core<>Node bridge",
   "main": "index.js",
   "types": "lib/index.d.ts",
@@ -23,7 +23,7 @@
   "license": "MIT",
   "dependencies": {
     "@grpc/grpc-js": "^1.12.4",
-    "@temporalio/common": "1.13.0",
+    "@temporalio/common": "1.13.2",
     "arg": "^5.0.2",
     "cargo-cp-artifact": "^0.1.8",
     "which": "^4.0.0"
@@ -56,5 +56,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "cf7c1e7d70f0c775f1382fd335b8bd721495f8cc"
+  "gitHead": "cccc54c72f85377ac520b5d6cdd9a9a847027c27"
 }

package/sdk-core/.cargo/config.toml

@@ -3,14 +3,74 @@
 CLI_VERSION_OVERRIDE = "v1.4.1-cloud-v1-29-0-139-2.0"
 
 [alias]
-integ-test = ["test", "--features", "temporal-sdk-core-protos/serde_serialize", "--package", "temporal-sdk-core", "--test", "integ_runner", "--"]
-lint = ["clippy", "--workspace", "--examples", "--all-features",
-    "--test", "integ_tests", "--test", "heavy_tests", "--test", "manual_tests",
-    "--", "--D", "warnings"]
-lint-fix = ["clippy", "--workspace", "--examples", "--all-features",
-    "--test", "integ_tests", "--test", "heavy_tests", "--test", "manual_tests",
-    "--fix", "--allow-dirty"]
-test-lint = ["clippy", "--all", "--all-features", "--examples", "--workspace",
-    "--tests", "--", "--D", "warnings"]
-test-lint-fix = ["clippy", "--all", "--all-features", "--examples", "--workspace",
-    "--tests", "--fix", "--allow-dirty"]
+# Not sure why --all-features doesn't work
+integ-test = [
+    "test",
+    "--features",
+    "temporal-sdk-core-protos/serde_serialize",
+    "--features",
+    "test-utilities",
+    "--features",
+    "ephemeral-server",
+    "--package",
+    "temporal-sdk-core",
+    "--test",
+    "integ_runner",
+    "--",
+]
+lint = [
+    "clippy",
+    "--workspace",
+    "--examples",
+    "--all-features",
+    "--test",
+    "integ_tests",
+    "--test",
+    "heavy_tests",
+    "--test",
+    "manual_tests",
+    "--test",
+    "cloud_tests",
+    "--test",
+    "integ_runner",
+    "--test",
+    "global_metric_tests",
+    "--",
+    "--D",
+    "warnings",
+]
+lint-fix = [
+    "clippy",
+    "--workspace",
+    "--examples",
+    "--all-features",
+    "--test",
+    "integ_tests",
+    "--test",
+    "heavy_tests",
+    "--test",
+    "manual_tests",
+    "--fix",
+    "--allow-dirty",
+]
+test-lint = [
+    "clippy",
+    "--all",
+    "--all-features",
+    "--examples",
+    "--workspace",
+    "--tests",
+    "--",
+    "--D",
+    "warnings",
+]
+test-lint-fix = [
+    "clippy",
+    "--all",
+    "--all-features",
+    "--examples",
+    "--workspace",
+    "--tests",
+    "--fix",
+    "--allow-dirty",
+]

package/sdk-core/.clippy.toml

@@ -0,0 +1 @@
+allow-dbg-in-tests = true

package/sdk-core/.github/workflows/heavy.yml

@@ -19,6 +19,8 @@ jobs:
         with:
           submodules: recursive
       - uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.90.0
       - name: Install protoc
         uses: arduino/setup-protoc@v3
         with:

package/sdk-core/.github/workflows/per-pr.yml

@@ -21,12 +21,12 @@ jobs:
           submodules: recursive
       - uses: dtolnay/rust-toolchain@stable
         with:
-          toolchain: 1.88.0
+          toolchain: 1.90.0
       - name: Install protoc
         uses: arduino/setup-protoc@v3
         with:
           # TODO: Upgrade proto once https://github.com/arduino/setup-protoc/issues/99 is fixed
-          version: '23.x'
+          version: "23.x"
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       - run: rustup component add rustfmt clippy
       - uses: Swatinem/rust-cache@v2
@@ -43,27 +43,27 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ ubuntu-latest, ubuntu-arm, macos-intel, macos-arm, windows-latest ]
+        os: [ubuntu-latest, ubuntu-arm, macos-intel, macos-arm, windows-latest]
         include:
           - os: windows-latest
           - os: ubuntu-latest
           - os: ubuntu-arm
             runsOn: ubuntu-24.04-arm64-2-core
-          - os: macos-intel
-            runsOn: macos-13
           - os: macos-arm
             runsOn: macos-14
+          - os: macos-intel
+            runsOn: macos-15-intel
     runs-on: ${{ matrix.runsOn || matrix.os }}
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
         with:
-          toolchain: 1.88.0
+          toolchain: 1.90.0
       - name: Install protoc
         uses: arduino/setup-protoc@v3
         with:
           # TODO: Upgrade proto once https://github.com/arduino/setup-protoc/issues/99 is fixed
-          version: '23.x'
+          version: "23.x"
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       # Workaround for https://github.com/actions/runner-images/issues/12432
       # from https://github.com/rust-lang/rust/issues/141626#issuecomment-2919419236
@@ -91,29 +91,37 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ ubuntu-latest, ubuntu-arm, macos-intel, macos-arm, windows-latest ]
+        os: [ubuntu-latest, ubuntu-arm, macos-intel, macos-arm, windows-latest]
         include:
           - os: windows-latest
           - os: ubuntu-latest
           - os: ubuntu-arm
             runsOn: ubuntu-24.04-arm64-2-core
-          - os: macos-intel
-            runsOn: macos-13
           - os: macos-arm
             runsOn: macos-14
+          - os: macos-intel
+            runsOn: macos-15-intel
     runs-on: ${{ matrix.runsOn || matrix.os }}
     steps:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
         with:
-          toolchain: 1.88.0
+          toolchain: 1.90.0
       - name: Install protoc
         uses: arduino/setup-protoc@v3
         with:
           # TODO: Upgrade proto once https://github.com/arduino/setup-protoc/issues/99 is fixed
-          version: '23.x'
+          version: "23.x"
           repo-token: ${{ secrets.GITHUB_TOKEN }}
-
+      # Workaround for https://github.com/actions/runner-images/issues/12432
+      # from https://github.com/rust-lang/rust/issues/141626#issuecomment-2919419236
+      # Visual Studio bug tracker https://developercommunity.visualstudio.com/t/Regression-from-1943:-linkexe-crashes/10912960
+      - name: Setup RUSTFLAGS (Windows)
+        if: runner.os == 'Windows'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            core.exportVariable('RUSTFLAGS', '-Csymbol-mangling-version=v0');
       - uses: Swatinem/rust-cache@v2
       - run: cargo integ-test
 
@@ -131,16 +139,16 @@ jobs:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
         with:
-          toolchain: 1.88.0
+          toolchain: 1.90.0
       - name: Install protoc
         uses: arduino/setup-protoc@v3
         with:
           # TODO: Upgrade proto once https://github.com/arduino/setup-protoc/issues/99 is fixed
-          version: '23.x'
+          version: "23.x"
           repo-token: ${{ secrets.GITHUB_TOKEN }}
 
       - uses: Swatinem/rust-cache@v2
-      - run: cargo test --test cloud_tests
+      - run: cargo test --features=test-utilities --test cloud_tests
 
   docker-integ-tests:
     name: Docker integ tests
@@ -156,12 +164,12 @@ jobs:
       - uses: actions/checkout@v4
       - uses: dtolnay/rust-toolchain@stable
         with:
-          toolchain: 1.88.0
+          toolchain: 1.90.0
       - name: Install protoc
         uses: arduino/setup-protoc@v3
         with:
           # TODO: Upgrade proto once https://github.com/arduino/setup-protoc/issues/99 is fixed
-          version: '23.x'
+          version: "23.x"
           repo-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Start container for otel-collector and prometheus
         uses: hoverkraft-tech/compose-action@v2.0.1
@@ -169,3 +177,27 @@ jobs:
           compose-file: ./docker/docker-compose-ci.yaml
       - uses: Swatinem/rust-cache@v2
       - run: cargo integ-test docker_
+
+  c-bridge-static-link-test:
+    name: "C bridge static link test"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          toolchain: 1.90.0
+      - name: Install protoc
+        uses: arduino/setup-protoc@v3
+        with:
+          # TODO: Upgrade proto once https://github.com/arduino/setup-protoc/issues/99 is fixed
+          version: "23.x"
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build crate as static library
+        run: cargo rustc --package temporal-sdk-core-c-bridge --features xz2-static -- --crate-type=staticlib
+
+      - name: Build C test program
+        run: gcc -I./core-c-bridge/include tests/c_bridge_smoke_test.c target/debug/deps/libtemporal_sdk_core_c_bridge.a -lpthread -ldl -lm -o test
+
+      - name: Run C test program
+        run: ./test

package/sdk-core/ARCHITECTURE.md

@@ -1,32 +1,31 @@
 Core SDK Architecture
 ===
 
-## High level description
+If you're newer to SDKs in general, first check out the [SDKs Intro](./arch_docs/sdks_intro.md)!
 
-The below diagram depicts how future SDKs are split into two parts. The `sdk-core` common code,
+## High-level description
+
+The below diagram depicts how Core-based SDKs are split into two parts. The `sdk-core` common code,
 which is written in Rust, and a `sdk-lang` package specific to the language the user is writing
 their workflow/activity in. For example a user writing workflows in Rust would be pulling in (at
 least) two crates - `temporal-sdk-core` and `temporal-sdk-rust`.
 
 ![Arch Diagram](https://lucid.app/publicSegments/view/7872bb33-d2b9-4b90-8aa1-bac111136aa5/image.png)
 
-The `core` communicates with the Temporal service in the same way that existing SDKs today do, via
-gRPC. It's responsible for polling for tasks, processing those tasks according to our state machine
-logic, and then driving the language-specific code and shuttling events to it and commands back.
+Core communicates with the Temporal service in the same way that existing SDKs today do, via
+gRPC. It's responsible for polling for tasks (Workflow, Activity, and Nexus), processing those tasks
+and updating internal state as necessary, and then delivering them to the lang-layer which is
+polling for them (and handling the responses).
 
-The `sdk-lang` side communicates with `sdk-core` via either C bindings, IPC, or (later) bindings to
-a WASM interface. Many languages already have nice support for calling into Rust code - generally
-speaking these implementations are using C bindings under the hood. For example, we
-use [neon](https://neon-bindings.com/) to support the TS/JS sdk, and we will likely
-use [PyO3](https://github.com/PyO3/pyo3) for Python. It is expected that such usages will layer
-another crate on top of `core` which brings in these language specific libraries to expose `core` to
-that language in an ergonomic manner. IPC will exist as a thin layer on top of the C bindings. Care
-should be taken here to avoid unnecessary copying and [de]serialization. Then `sdk-lang` is
-responsible for dispatching tasks to the appropriate user code (to whatever extent parts of this can
-be reasonably put in the core code, we desire that to make lang-specific SDKs as small as possible).
+The `sdk-lang` side communicates with `sdk-core` via C bindings. Many languages already have nice
+support for calling into Rust code - generally speaking these implementations are using C bindings
+under the hood. For example, we use [neon](https://neon-bindings.com/) to support the TS/JS SDK, and
+we use [PyO3](https://github.com/PyO3/pyo3) for Python. Languages using libraries like that layer
+another crate on top of `core` which brings in these language-specific helpers to expose `core` to
+that language in an ergonomic manner.
 
-As a general note, the more we can push from `sdk-lang` into `sdk-core`, the easier our ecosystem is
-to maintain in the long run as we will have less semantically identical code.
+Other SDKs (ex: .NET) directly use C bindings available in this repo
+at [core-c-bridge](./core-c-bridge).
 
 ### Glossary of terms
 
@@ -38,9 +37,9 @@ the code. This list should help to disambiguate:
   represent the history of the workflow. They are defined in the protobuf definitions for the
   Temporal service itself.
 * `Command`: These are the commands defined in the temporal service protobufs that are returned by
-  clients upon completing a `WorkflowTask`. For example, starting a timer or an activity.
-* `WorkflowTask`: These are how the server represents the need to run user workflow code (or the
-  result of it executing). See the `HistoryEvent` proto definition for more.
+  workers upon completing a `WorkflowTask`. For example, starting a timer or an activity.
+* `WorkflowTask`: These are how the server represents the need to run user workflow code, and the
+  results of that execution. See the `HistoryEvent` proto definition for more.
 * `WorkflowActivation`: These are produced by the Core SDK when the lang sdk needs to "activate" the
   user's workflow code, either running it from the beginning or resuming a cached workflow.
 * `WorkflowActivationJob` (shorthand: `Job`s): These are included in `WorkflowActivation`s and
@@ -57,9 +56,9 @@ Additional clarifications that are internal to Core:
 * `StateMachine`s also handle events and produce commands, which often map directly to the above
   `HistoryEvent`s and `Command`s, but are distinct types. The state machine library is Temporal
   agnostic - but all interactions with the machines pass through a `TemporalStateMachine` trait,
-  which accepts `HistoryEvent`s, and produces `WorkflowTrigger`s.
-* `WorkflowTrigger`: These allow the state machines to trigger things to happen to the workflow.
-  Including pushing new `WfActivationJob`s, or otherwise advancing workflow state.
+  which accepts `HistoryEvent`s, and produces `MachineResponse`s.
+* `MachineResponse`: These allow the state machines to trigger things to happen to the workflow.
+  Including pushing new Activation Jobs, or otherwise advancing workflow state.
 
 ### Core SDK Responsibilities
 
@@ -67,18 +66,19 @@ Additional clarifications that are internal to Core:
   more ergonomic traits.
 - Provide interface for language-specific SDK to drive event loop and handle returned commands. The
   lang sdk will continuously call/poll the core SDK to receive new tasks, which either represent
-  workflows being started or awoken (`WorkflowActivation`) or activities to execute (
-  `ActivityTask`). It will then call its workflow/activity functions with the provided information
-  as appropriate, and will then push completed tasks back into the core SDK.
+  workflows being started or awoken (`WorkflowActivation`), activities to execute (`ActivityTask`),
+  or Nexus Operations to invoke (`NexusTask`). It will then call its workflow/activity/nexus
+  functions with the provided information as appropriate, and will then push completed tasks back
+  into the core SDK.
 - Advance state machines and report back to the temporal server as appropriate when handling events
   and commands
 
 ### Language Specific SDK Responsibilities
 
 - Periodically poll Core SDK for tasks
-- Call workflow and activity functions as appropriate, using information in events it received from
-  Core SDK
-- Return results of workflows/activities to Core SDK
+- Call workflow, activity, and nexus functions as appropriate, using information in events it
+  received from Core SDK
+- Return results of workflows/activities/nexus ops to Core SDK
 - Manage concurrency using language appropriate primitives. For example, it is up to the language
   side to decide how frequently to poll, and whether or not to execute worklows and activities in
   separate threads or coroutines, etc.
@@ -86,21 +86,21 @@ Additional clarifications that are internal to Core:
 ### Example Sequence Diagrams
 
 Here we consider what the sequence of API calls would look like for a simple workflow executing a
-happy path. The hello-world workflow & activity in imaginary Rust (don't pay too much attention to
-the specifics, just an example) is below. It is meant to be like our most basic hello world samples.
-
-```rust
-#[workflow]
-async fn hello_world_workflow(name: &str) -> Result<String, Error> {
-    info!("Hello world workflow started! Name: {}", name);
-    // Very much TBD how this would actually work in rust sdk. Many options here.
-    activity!(hello_activity(name), timeout: 2s).await
-}
-
-#[activity]
-async fn hello_activity(name: &str) -> String {
-    format!("Hello {}!", name)
-}
+happy path. The hello-world workflow & activity in Python is below.
+
+```python
+@workflow.defn
+class SayHello:
+  @workflow.run
+  async def run(self, name: str) -> str:
+    return await workflow.execute_activity(
+      say_hello, name, schedule_to_close_timeout=timedelta(seconds=5)
+    )
+
+
+@activity.defn
+async def say_hello(name: str) -> str:
+    return f"Hello, {name}!"
 ```
 
 [![](https://mermaid.ink/img/pako:eNptk81O6zAQhV9l5AWr8gIRqoQCC0QXQJDuJpvBnrZWbY-vf9rbi3h3bJqE0JKVlfP5zMyx_S4kKxKNiPQ3k5N0p3ET0PYOyucxJC21R5egA4zwStZzQAMdhb2WdIm1FWs5EHR3j5fyqsordJuTfAJWcL1cQtvAg9NJo9H_CQ4cdhTmetfAJnjZQJeK4Z-irw0f7v-RzEmzG80Ms__aXVVIGHfgA0uKUbvNCWl_-j2xMaPda-GfM-Vhsg6uh9aqEOEKtjomDseizb0KcOu9OU5yYogJE4FFudWO4ometUh7KnnU5VkItR1YcwCUSe-xzhanWpVZNTC2ezshc5MCvGQ3hbCoAahcIgDJ1qJTcaKHmpd-LVtvqK5u3sJSskuoXUnwzOJ7fLXHcn1-nZqcGk_nLPoXip6dmqc_FCZ1sXdKqNvmpPhQfouFsBQsalWu8HvFepG2ZKkXTVkqDLte9O6jcNmr0tm90uV8RLNGE2khMCfujk6KJoVMIzS8gYH6-ASOZQf0)](https://mermaid-js.github.io/mermaid-live-editor/edit#pako:eNptk81O6zAQhV9l5AWr8gIRqoQCC0QXQJDuJpvBnrZWbY-vf9rbi3h3bJqE0JKVlfP5zMyx_S4kKxKNiPQ3k5N0p3ET0PYOyucxJC21R5egA4zwStZzQAMdhb2WdIm1FWs5EHR3j5fyqsordJuTfAJWcL1cQtvAg9NJo9H_CQ4cdhTmetfAJnjZQJeK4Z-irw0f7v-RzEmzG80Ms__aXVVIGHfgA0uKUbvNCWl_-j2xMaPda-GfM-Vhsg6uh9aqEOEKtjomDseizb0KcOu9OU5yYogJE4FFudWO4ometUh7KnnU5VkItR1YcwCUSe-xzhanWpVZNTC2ezshc5MCvGQ3hbCoAahcIgDJ1qJTcaKHmpd-LVtvqK5u3sJSskuoXUnwzOJ7fLXHcn1-nZqcGk_nLPoXip6dmqc_FCZ1sXdKqNvmpPhQfouFsBQsalWu8HvFepG2ZKkXTVkqDLte9O6jcNmr0tm90uV8RLNGE2khMCfujk6KJoVMIzS8gYH6-ASOZQf0)
@@ -118,7 +118,3 @@ definition [here](https://github.com/temporalio/sdk-core/tree/master/sdk-core-pr
 
 - [Sticky task queues](arch_docs/sticky_queues.md)
 - [Workflow task chunking](arch_docs/workflow_task_chunking.md)
-
-## Workflow Processing Internals
-
-![Workflow Internals](arch_docs/diagrams/workflow_internals.svg)

package/sdk-core/Cargo.toml

@@ -1,5 +1,13 @@
 [workspace]
-members = ["core", "client", "core-api", "fsm", "test-utils", "sdk-core-protos", "sdk", "core-c-bridge"]
+members = [
+    "core",
+    "client",
+    "core-api",
+    "fsm",
+    "sdk-core-protos",
+    "sdk",
+    "core-c-bridge",
+]
 resolver = "2"
 
 [workspace.package]
@@ -8,17 +16,28 @@ license-file = "LICENSE.txt"
 
 [workspace.dependencies]
 derive_builder = "0.20"
-derive_more = { version = "2.0", features = ["constructor", "display", "from", "into", "debug", "try_into"] }
+derive_more = { version = "2.0", features = [
+    "constructor",
+    "display",
+    "from",
+    "into",
+    "debug",
+    "try_into",
+] }
 thiserror = "2"
-tonic = "0.13"
-tonic-build = "0.13"
-opentelemetry = { version = "0.30", features = ["metrics"] }
-prost = "0.13"
-prost-types = "0.13"
+tonic = "0.14"
+tonic-prost = "0.14"
+tonic-prost-build = "0.14"
+opentelemetry = { version = "0.31", features = ["metrics"] }
+prost = "0.14"
+prost-types = { version = "0.7", package = "prost-wkt-types" }
 
 [workspace.lints.rust]
 unreachable_pub = "warn"
 
+[workspace.lints.clippy]
+dbg_macro = "warn"
+
 [profile.release-lto]
 inherits = "release"
 lto = true

package/sdk-core/README.md

@@ -52,6 +52,10 @@ use an already-running server by passing `-s external`.
 
 Run load tests with `cargo test --test heavy_tests`.
 
+NOTE: Integration tests should pass locally, if running on MacOS and you see integration tests consistently failing
+with an error that mentions `Too many open files`, this is likely due to `ulimit -n` being too low. You can raise
+it temporarily (current shell) with `ulimit -n 65535`, or add it to your `~/.zshrc` file to apply to all shells.
+
 ## Formatting
 
 To format all code run:

package/sdk-core/arch_docs/diagrams/TimerMachine_Coverage.puml

@@ -0,0 +1,14 @@
+@startuml
+[*] --> Created
+Created -[#blue]-> StartCommandCreated: Schedule
+StartCommandCreated -[#blue]-> StartCommandCreated: CommandStartTimer
+StartCommandCreated -[#blue]-> StartCommandRecorded: TimerStarted
+StartCommandCreated -[#blue]-> Canceled: Cancel
+StartCommandRecorded -[#blue]-> Fired: TimerFired
+StartCommandRecorded -[#blue]-> CancelTimerCommandCreated: Cancel
+CancelTimerCommandCreated --> CancelTimerCommandCreated: Cancel
+CancelTimerCommandCreated -[#blue]-> CancelTimerCommandSent: CommandCancelTimer
+CancelTimerCommandSent --> Canceled: TimerCanceled
+Canceled -[#blue]-> Canceled: Cancel
+Fired -[#blue]-> Fired: Cancel
+@enduml