fix: preserve logical mutation intent

src/bootstrap/runtime-adapters.ts

@@ -15,11 +15,13 @@ import { createQueryClient } from "../adapters/query-cache/tanstack-query-cache.
 import { createServerStateScopeRuntime } from "../adapters/query-cache/server-state-scope-runtime.ts";
 import { createConditionalValidatorStore } from "../adapters/query-cache/conditional-validator-store.ts";
 import { createBrowserStorageAdapter } from "../adapters/storage/browser-storage-adapter.ts";
+import { createBrowserMutationIntentFactory } from "../adapters/platform/browser-mutation-intent-factory.ts";
 import { createTelemetryAdapter } from "../adapters/telemetry/best-effort-telemetry.ts";
 import type { AuthSessionPort } from "../application/ports/auth-session-port.ts";
 import type { ReleaseInfo } from "../application/ports/release-info-port.ts";
 import { createRestProviderProfile } from "../contracts/rest-profiles.ts";
 import type { ClockPort } from "../application/ports/clock-port.ts";
+import type { MutationIntent } from "../contracts/mutation-intent.ts";
 import { createInstalledFeatureInputs } from "../features/installed-feature-adapters.ts";
 import {
   INVALIDATION_REGISTRY,
@@ -166,6 +168,7 @@ export async function createRuntimeAdapters(
   const host =
     context.host ?? (globalThis as unknown as Record<string, unknown>);
   const config = context.runtime.config;
+  const mutationIntentFactory = createBrowserMutationIntentFactory();
   const externalOwner = externalOwnerFrom(host);
   const authSession =
     config.AUTH_MODE === "demo"
@@ -343,12 +346,14 @@ export async function createRuntimeAdapters(
       }
     },
   });
-  let contractExecutionSequence = 0;
   const contractOperations = Object.freeze({
     async execute(
       operationId: string,
       input: unknown,
-      executionContext: Readonly<{ signal?: AbortSignal }> = {},
+      executionContext: Readonly<{
+        signal?: AbortSignal;
+        intent?: MutationIntent;
+      }> = {},
     ) {
       const operation =
         COMPOSED_CONTRACT_CONTRIBUTIONS.httpByOperationId.get(operationId);
@@ -362,26 +367,14 @@ export async function createRuntimeAdapters(
           }),
         });
       }
-      contractExecutionSequence += 1;
-      const intentId = `http-intent-${contractExecutionSequence}`;
-      const isCommand = operation.contract.commandEffect !== null;
-      const requiresKey = operation.contract.retrySemantics === "KEYED";
       const outcome = await contractHttp.execute(operation, input, {
         scope: serverStateScope.getSnapshot(),
         ...(executionContext.signal === undefined
           ? {}
           : { signal: executionContext.signal }),
-        ...(isCommand
-          ? {
-              intent: Object.freeze({
-                intentId,
-                startedBy: "USER" as const,
-                ...(requiresKey
-                  ? { idempotencyKey: `http-key-${contractExecutionSequence}` }
-                  : {}),
-              }),
-            }
-          : {}),
+        ...(executionContext.intent === undefined
+          ? {}
+          : { intent: executionContext.intent }),
       });
       if (outcome.kind === "UNAUTHENTICATED") {
         authSession.onUnauthenticated();
@@ -412,6 +405,7 @@ export async function createRuntimeAdapters(
       },
       serverStateGeneration,
       serverStateScope,
+      mutationIntentFactory,
       conditionalValidators,
       crossContextInvalidationStatus: () =>
         serverStateGeneration.getSnapshot().crossContextStatus(),