@loadstrike/loadstrike-sdk 1.0.31601 → 1.0.33601

package/dist/esm/local.js

@@ -15,10 +15,9 @@ import * as fs from "node:fs";
 import * as childProcess from "node:child_process";
 import { createHash, createVerify, randomUUID } from "node:crypto";
 import { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, RedisCorrelationStoreOptions, RedisCorrelationStore, TrackingFieldSelector } from "./correlation.js";
-import { EndpointAdapterFactory, LOADSTRIKE_TRACE_ID_TRACKING_FIELD } from "./transports.js";
-import { BLACKBOX_LICENSING_API_BASE_URL_TOKEN } from "./internal-build.js";
+import { EndpointAdapterFactory, LOADSTRIKE_TRACE_ID_TRACKING_FIELD, validateNativeEndpointExecutionSupport } from "./transports.js";
+import { assertNoUnsupportedReportingInfraConfig, assertNoUnsupportedReportingSinkGraph } from "./reporting-containment.js";
 const DEFAULT_LICENSING_API_BASE_URL = "https://licensing.loadstrike.com";
-let developmentLicensingApiBaseUrlOverride;
 const BUILT_IN_WORKER_PLUGIN_NAMES = new Set([
     "loadstrike failed responses",
     "loadstrike correlation"
@@ -72,7 +71,7 @@ export class LoadStrikeLocalClient {
         _LoadStrikeLocalClient_signingKeyCache.set(this, new Map());
         _LoadStrikeLocalClient_heartbeatDrains.set(this, new WeakMap());
         assertNoDisableLicenseEnforcementOption(options, "LoadStrikeLocalClient");
-        __classPrivateFieldSet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, resolveLicensingApiBaseUrl(), "f");
+        __classPrivateFieldSet(this, _LoadStrikeLocalClient_licensingApiBaseUrl, DEFAULT_LICENSING_API_BASE_URL, "f");
         this.licenseValidationTimeoutMs = normalizeTimeoutMs(options.licenseValidationTimeoutMs);
     }
     portalReportingIngestUrl() {
@@ -80,6 +79,7 @@ export class LoadStrikeLocalClient {
     }
     async run(request) {
         const sanitized = sanitizeRequest(request);
+        validateContainmentRequest(sanitized);
         const licenseSession = await this.acquireLicenseLease(sanitized);
         try {
             const createdUtc = new Date();
@@ -534,66 +534,27 @@ function sanitizeRequest(request) {
         RunArgs: runArgs
     };
 }
-function normalizeLicensingApiBaseUrl(value) {
-    const normalized = (value ?? "").trim();
-    return normalized || DEFAULT_LICENSING_API_BASE_URL;
-}
-function resolveLicensingApiBaseUrl() {
-    return normalizeLicensingApiBaseUrl(developmentLicensingApiBaseUrlOverride ?? resolveInternalBlackBoxLicensingApiBaseUrl());
-}
-function setDevelopmentLicensingApiBaseUrlOverride(value) {
-    if (value != null && value.trim()) {
-        assertInternalTestHarnessLicensingOverride();
-        const normalized = normalizeLicensingApiBaseUrl(value);
-        if (!isLoopbackHttpBaseUrl(normalized)) {
-            throw new TypeError("Internal development licensing API overrides must use a loopback http URL.");
+function validateContainmentRequest(request) {
+    const scenarios = Array.isArray(request.Scenarios) ? request.Scenarios : [];
+    for (const scenarioValue of scenarios) {
+        const scenario = asRecord(scenarioValue);
+        const tracking = asRecord(pickValue(scenario, "Tracking", "tracking"));
+        for (const field of ["Source", "Destination"]) {
+            const endpoint = asRecord(pickValue(tracking, field, field.toLowerCase()));
+            if (Object.keys(endpoint).length > 0) {
+                validateNativeEndpointExecutionSupport(endpoint);
+            }
         }
-        developmentLicensingApiBaseUrlOverride = normalized;
-        return;
-    }
-    if (value != null) {
-        assertInternalTestHarnessLicensingOverride();
-    }
-    developmentLicensingApiBaseUrlOverride = undefined;
-}
-function assertInternalTestHarnessLicensingOverride() {
-    if (isInternalTestHarnessCall()) {
-        return;
-    }
-    throw new TypeError("Internal development licensing API override is available only to LoadStrike SDK tests.");
-}
-function isInternalTestHarnessCall() {
-    const stack = String(new Error().stack ?? "").replace(/\\/g, "/").toLowerCase();
-    return stack.includes("/sdk/ts/tests/");
-}
-function isLoopbackHttpBaseUrl(value) {
-    let parsed;
-    try {
-        parsed = new URL(value);
-    }
-    catch {
-        return false;
-    }
-    if (parsed.protocol !== "http:") {
-        return false;
     }
-    const host = parsed.hostname.trim().toLowerCase();
-    return host === "localhost" || host === "127.0.0.1" || host === "[::1]" || host === "::1" || host.endsWith(".localhost");
-}
-function resolveInternalBlackBoxLicensingApiBaseUrl() {
-    const compiledToken = String(BLACKBOX_LICENSING_API_BASE_URL_TOKEN ?? "").trim();
-    if (!compiledToken) {
-        return undefined;
-    }
-    const envToken = String(process.env.LOADSTRIKE_INTERNAL_BLACKBOX_API_BASE_URL_TOKEN ?? "").trim();
-    if (!envToken || envToken !== compiledToken) {
-        return undefined;
-    }
-    const candidate = normalizeLicensingApiBaseUrl(process.env.LOADSTRIKE_INTERNAL_BLACKBOX_API_BASE_URL);
-    if (!isLoopbackHttpBaseUrl(candidate)) {
-        return undefined;
+    const context = asRecord(request.Context);
+    const reportingSinks = asList(pickValue(context, "ReportingSinks", "reportingSinks"));
+    for (const [key, value] of Object.entries(context)) {
+        const normalizedKey = key.trim().toLowerCase().replace(/[^a-z0-9]+/g, "");
+        if (normalizedKey === "infraconfig") {
+            assertNoUnsupportedReportingInfraConfig(value, reportingSinks);
+        }
     }
-    return candidate;
+    assertNoUnsupportedReportingSinkGraph(reportingSinks);
 }
 function normalizeTimeoutMs(value) {
     if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
@@ -1301,6 +1262,20 @@ function mapEndpointSpec(spec, useLoadStrikeTraceIdHeader = false) {
         redisStreams: asRecord(pickValue(spec, "RedisStreams", "redisStreams")),
         azureEventHubs: asRecord(pickValue(spec, "AzureEventHubs", "azureEventHubs")),
         pushDiffusion: asRecord(pickValue(spec, "PushDiffusion", "pushDiffusion")),
+        grpc: mapEndpointProtocolOptions(spec, ["Grpc", "grpc"], [
+            "Target", "target", "ServiceName", "serviceName", "MethodName", "methodName",
+            "MethodType", "methodType", "Deadline", "deadline", "DeadlineSeconds", "deadlineSeconds",
+            "DeadlineMs", "deadlineMs", "Metadata", "metadata", "Produce", "produce", "Consume", "consume",
+            "ProduceAsync", "produceAsync", "ConsumeAsync", "consumeAsync", "ConnectionMetadata", "connectionMetadata",
+            "NativeClient", "nativeClient"
+        ]),
+        webSocket: mapEndpointProtocolOptions(spec, ["WebSocket", "webSocket"], [
+            "Url", "url", "Subprotocols", "subprotocols", "ConnectTimeout", "connectTimeout",
+            "ConnectTimeoutSeconds", "connectTimeoutSeconds", "ConnectTimeoutMs", "connectTimeoutMs",
+            "CloseTimeout", "closeTimeout", "CloseTimeoutSeconds", "closeTimeoutSeconds", "CloseTimeoutMs", "closeTimeoutMs",
+            "Produce", "produce", "Consume", "consume", "ProduceAsync", "produceAsync", "ConsumeAsync", "consumeAsync",
+            "ConnectionMetadata", "connectionMetadata", "NativeClient", "nativeClient"
+        ]),
         delegate: (typeof delegateProduce === "function"
             || typeof delegateConsume === "function"
             || typeof delegateProduceAsync === "function"
@@ -1323,6 +1298,19 @@ function mapEndpointSpec(spec, useLoadStrikeTraceIdHeader = false) {
             : undefined
     };
 }
+function mapEndpointProtocolOptions(spec, nestedKeys, flatKeys) {
+    const nested = asRecord(pickValue(spec, ...nestedKeys));
+    if (Object.keys(nested).length > 0) {
+        return nested;
+    }
+    const options = {};
+    for (const key of flatKeys) {
+        if (Object.prototype.hasOwnProperty.call(spec, key)) {
+            options[key] = spec[key];
+        }
+    }
+    return options;
+}
 function normalizePayload(payload, endpoint, index) {
     const resolvedBody = payload?.body ?? endpoint.messagePayload;
     const normalized = {
@@ -2279,8 +2267,6 @@ export const __loadstrikeTestExports = {
     mapEnvironmentClassification,
     mapEndpointSpec,
     normalizeEndpointPayloadValue,
-    normalizeLicensingApiBaseUrl,
-    resolveLicensingApiBaseUrl,
     normalizeNodeType,
     normalizePayload,
     normalizeStringArray,
@@ -2299,7 +2285,6 @@ export const __loadstrikeTestExports = {
     sanitizeLooseJson,
     sanitizeRequest,
     setJsonPathValue,
-    setDevelopmentLicensingApiBaseUrlOverride,
     sleep,
     stringOrDefault,
     toBoolean,

package/dist/esm/reporting-containment.js

@@ -0,0 +1,238 @@
+const UNBOUND_EXPANDED_SECTIONS = [
+    ["PrometheusRemoteWrite", "PrometheusRemoteWriteReportingSink"],
+    ["CloudWatch", "CloudWatchReportingSink"],
+    ["Dynatrace", "DynatraceReportingSink"],
+    ["NewRelic", "NewRelicReportingSink"],
+    ["Elasticsearch", "ElasticsearchReportingSink"],
+    ["OpenSearch", "OpenSearchReportingSink"],
+    ["Kafka", "KafkaReportingSink"],
+    ["StatsD", "StatsDReportingSink"],
+    ["DogStatsD", "DogStatsDReportingSink"],
+    ["Netdata", "NetdataStatsDReportingSink"],
+    ["Jsonl", "JsonlFileReportingSink"],
+    ["Webhook", "GenericWebhookReportingSink"]
+];
+export function assertNoUnsupportedReportingInfraConfig(infraConfig, sinks = []) {
+    if (!isRecord(infraConfig)) {
+        return;
+    }
+    const selectedSections = selectedExpandedReportingSections(sinks);
+    for (const [sectionName, sinkType] of UNBOUND_EXPANDED_SECTIONS) {
+        if (selectedSections.has(sectionName)
+            && hasNonEmptyReportingSectionAlias(infraConfig, sectionName)) {
+            throw new Error(`Configuration section 'LoadStrike:ReportingSinks:${sectionName}' is not bound automatically by the TypeScript SDK. `
+                + `Construct ${sinkType} explicitly and pass its options directly.`);
+        }
+    }
+}
+function selectedExpandedReportingSections(sinks) {
+    const selected = new Set();
+    const visited = new Set();
+    const inspect = (sink) => {
+        if (!isRecord(sink) || visited.has(sink)) {
+            return;
+        }
+        visited.add(sink);
+        const identities = [
+            sink.licenseFeature,
+            sink.LicenseFeature,
+            sink.feature,
+            sink.Feature
+        ];
+        if (!hasReportingSinkLifecycle(sink)) {
+            identities.push(sink.kind, sink.Kind);
+        }
+        const normalizedIdentities = identities
+            .map(normalizeExpandedSinkIdentity)
+            .filter(Boolean);
+        for (const identity of normalizedIdentities) {
+            const sectionName = EXPANDED_SECTION_BY_IDENTITY.get(identity);
+            if (sectionName) {
+                selected.add(sectionName);
+            }
+        }
+        const children = Array.isArray(sink.sinks)
+            ? sink.sinks
+            : Array.isArray(sink.Sinks)
+                ? sink.Sinks
+                : [];
+        for (const child of children) {
+            inspect(child);
+        }
+    };
+    for (const sink of sinks) {
+        inspect(sink);
+    }
+    return selected;
+}
+const EXPANDED_SECTION_BY_IDENTITY = new Map([
+    ["prometheusremotewrite", "PrometheusRemoteWrite"],
+    ["cloudwatch", "CloudWatch"],
+    ["dynatrace", "Dynatrace"],
+    ["elasticsearch", "Elasticsearch"],
+    ["opensearch", "OpenSearch"],
+    ["newrelic", "NewRelic"],
+    ["webhook", "Webhook"],
+    ["genericwebhook", "Webhook"],
+    ["kafka", "Kafka"],
+    ["statsd", "StatsD"],
+    ["dogstatsd", "DogStatsD"],
+    ["netdata", "Netdata"],
+    ["netdatastatsd", "Netdata"],
+    ["jsonl", "Jsonl"],
+    ["jsonlfile", "Jsonl"]
+]);
+function normalizeExpandedSinkIdentity(value) {
+    let normalized = normalizeIdentityToken(value);
+    const featurePrefix = "extensionsreportingsinks";
+    if (normalized.startsWith(featurePrefix)) {
+        normalized = normalized.slice(featurePrefix.length);
+    }
+    const classSuffix = "reportingsink";
+    if (normalized.endsWith(classSuffix)) {
+        normalized = normalized.slice(0, -classSuffix.length);
+    }
+    return normalized;
+}
+export function assertNoUnsupportedReportingSinkGraph(sinks) {
+    const visited = new Set();
+    const active = new Set();
+    const inspect = (sink) => {
+        if (!isRecord(sink)) {
+            return;
+        }
+        if (active.has(sink)) {
+            throw new Error("Composite reporting sink graph cannot contain a cycle.");
+        }
+        if (visited.has(sink)) {
+            return;
+        }
+        active.add(sink);
+        const identityTokens = [sink.sinkName, sink.SinkName, sink.kind, sink.Kind]
+            .map(normalizeIdentityToken)
+            .filter(Boolean);
+        const featureTokens = [sink.licenseFeature, sink.LicenseFeature, sink.feature, sink.Feature]
+            .map((value) => String(value ?? "").trim().toLowerCase())
+            .filter(Boolean);
+        const hasLifecycle = hasReportingSinkLifecycle(sink);
+        const displayName = directVendorDisplayName(hasLifecycle ? [] : identityTokens, hasLifecycle ? [] : featureTokens);
+        if (displayName) {
+            throw unsupportedDirectVendorReportingError(displayName);
+        }
+        if (identityTokens.includes("composite") || identityTokens.includes("compositereportingsink")) {
+            const children = Array.isArray(sink.sinks)
+                ? sink.sinks
+                : Array.isArray(sink.Sinks)
+                    ? sink.Sinks
+                    : [];
+            for (const child of children) {
+                inspect(child);
+            }
+        }
+        active.delete(sink);
+        visited.add(sink);
+    };
+    for (const sink of sinks) {
+        inspect(sink);
+    }
+}
+function hasNonEmptyReportingSectionAlias(infraConfig, sectionName) {
+    const segments = ["LoadStrike", "ReportingSinks", sectionName];
+    const values = [
+        ...readDirectValuesCaseInsensitive(infraConfig, segments.join(":")),
+        ...readDirectValuesCaseInsensitive(infraConfig, segments.join(".")),
+        ...readNestedValuesCaseInsensitive(infraConfig, segments)
+    ];
+    return values.some(isNonEmptySection);
+}
+function readDirectValuesCaseInsensitive(record, key) {
+    const expected = key.toLowerCase();
+    return Object.entries(record)
+        .filter(([candidate]) => candidate.toLowerCase() === expected)
+        .map(([, value]) => value);
+}
+function readNestedValuesCaseInsensitive(record, segments) {
+    let current = [record];
+    for (const segment of segments) {
+        const next = [];
+        for (const candidate of current) {
+            if (isRecord(candidate)) {
+                next.push(...readDirectValuesCaseInsensitive(candidate, segment));
+            }
+        }
+        if (next.length === 0) {
+            return [];
+        }
+        current = next;
+    }
+    return current;
+}
+function isNonEmptySection(value) {
+    if (value == null) {
+        return false;
+    }
+    if (typeof value === "string") {
+        return value.trim().length > 0;
+    }
+    if (Array.isArray(value)) {
+        return value.length > 0;
+    }
+    if (isRecord(value)) {
+        return Object.keys(value).length > 0;
+    }
+    return true;
+}
+function directVendorDisplayName(identityTokens, featureTokens) {
+    if (identityTokens.includes("prometheusremotewrite")
+        || identityTokens.includes("prometheusremotewritereportingsink")
+        || featureTokens.includes("extensions.reporting_sinks.prometheus_remote_write")) {
+        return "Prometheus Remote Write";
+    }
+    if (identityTokens.includes("cloudwatch")
+        || identityTokens.includes("cloudwatchreportingsink")
+        || featureTokens.includes("extensions.reporting_sinks.cloudwatch")) {
+        return "CloudWatch";
+    }
+    if (identityTokens.includes("dynatrace")
+        || identityTokens.includes("dynatracereportingsink")
+        || featureTokens.includes("extensions.reporting_sinks.dynatrace")) {
+        return "Dynatrace";
+    }
+    if (identityTokens.includes("newrelic")
+        || identityTokens.includes("newrelicreportingsink")
+        || featureTokens.includes("extensions.reporting_sinks.new_relic")) {
+        return "New Relic";
+    }
+    return undefined;
+}
+function unsupportedDirectVendorReportingError(displayName) {
+    return new Error(`Direct ${displayName} reporting is not supported by the TypeScript SDK. `
+        + "Use GenericWebhookReportingSink through a converting gateway or a custom LoadStrikeReportingSink.");
+}
+function normalizeIdentityToken(value) {
+    return String(value ?? "")
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "");
+}
+function hasReportingSinkLifecycle(sink) {
+    return [
+        "init",
+        "Init",
+        "start",
+        "Start",
+        "saveRealtimeStats",
+        "SaveRealtimeStats",
+        "saveRealtimeMetrics",
+        "SaveRealtimeMetrics",
+        "saveRunResult",
+        "SaveRunResult",
+        "saveIterationBatch",
+        "SaveIterationBatch",
+        "stop",
+        "Stop"
+    ].some((member) => typeof sink[member] === "function");
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}

package/dist/esm/runtime.js

@@ -5,17 +5,20 @@ import { resolve } from "node:path";
 import { LoadStrikeLocalClient } from "./local.js";
 import { DistributedClusterAgent, DistributedClusterCoordinator, buildLoadEngineV2ReservedStepOtherIdentityKey, buildLoadEngineV2GlobalInvocationId, buildLoadEngineV2ScenarioIdentityKey, buildLoadEngineV2SchedulerIdentityKey, buildLoadEngineV2StatusIdentityKey, buildLoadEngineV2StepIdentityKey, resolveLoadEngineV2StepIdentityKey, buildLoadEngineV2Plan } from "./cluster.js";
 import { CorrelationStoreConfiguration, CrossPlatformTrackingRuntime, RedisCorrelationStore, RedisCorrelationStoreOptions, TrackingFieldSelector } from "./correlation.js";
-import { EndpointAdapterFactory, LOADSTRIKE_TRACE_ID_TRACKING_FIELD } from "./transports.js";
+import { EndpointAdapterFactory, LOADSTRIKE_TRACE_ID_TRACKING_FIELD, validateNativeEndpointExecutionSupport } from "./transports.js";
 import { buildDotnetCsvReport, buildDotnetHtmlReport, buildDotnetMarkdownReport, buildDotnetTxtReport } from "./reporting.js";
 import { ReportHistoryCollector, ReportHistoryLifecycleCoordinator, ReportHistoryWorker, sanitizedExceptionClassChain } from "./report-history.js";
 import { distributedLocalReportInput, emptyLocalReportInput } from "./local-report-input.js";
-import { PortalReportingSink, cloneReportingSinkForRun } from "./sinks.js";
+import { PortalReportingSink, PrometheusRemoteWriteReportingSink, cloneReportingSinkForRun } from "./sinks.js";
+import { ReportingSinkHttpError } from "./internal/reporting-sink-http-error.js";
+import { assertNoUnsupportedReportingSinkGraph } from "./reporting-containment.js";
 import { LoadEngineV2ExecutionBudget, buildLoadEngineV2TrafficMixSeedId, LoadStrikeHistogramV1, parseLoadEngineV2HistogramArtifact, serializeLoadEngineV2HistogramArtifact, classifyLoadEngineV2Arrival, loadEngineV2FixedArrivalCount, loadEngineV2FixedDeadlineNs, loadEngineV2LatenessToleranceNs, loadEngineV2TrafficMixLaneUnitCount, loadEngineV2TrafficMixOwnedUnits, planRampingInjectionDeadlines, planRampingConstantDeadlines, planRandomInjectionDeadlines, fnv1a32 } from "./load-engine-v2.js";
 import { DEFAULT_ITERATION_OBSERVATION_SETTINGS, IterationObservationReporter, createIterationObservation, createIterationStepObservation, utcNowNs, validateIterationObservationSettings } from "./iteration-observations.js";
 import { logIterationObservationFailure, logIterationObservationRecovery } from "./iteration-observation-diagnostics.js";
 import { normalizeSinkRetryBackoffMs, normalizeSinkRetryCount, sinkRetryDelayMs, waitForSinkRetryDelay } from "./sink-retry-policy.js";
 const LOAD_ENGINE_V2_SCHEDULER_DISTRIBUTIONS = Symbol("loadstrike.load-engine-v2.scheduler-distributions");
 const PORTAL_RUN_TOKEN_PROVIDER = Symbol.for("loadstrike.internal.portal-run-token-provider");
+const REPORTING_INTERVAL_SECONDS = Symbol.for("loadstrike.internal.reporting-interval-seconds");
 export const LoadStrikeNodeType = {
     SingleNode: "SingleNode",
     Coordinator: "Coordinator",
@@ -739,6 +742,15 @@ class ScenarioStatsAccumulator {
         return attachScenarioStatsAliases(scenario);
     }
 }
+function isRetryableReportingSinkError(sink, error) {
+    if (!(sink instanceof PrometheusRemoteWriteReportingSink)) {
+        return true;
+    }
+    if (!(error instanceof ReportingSinkHttpError)) {
+        return true;
+    }
+    return error.status === 429 || error.status < 400 || error.status >= 500;
+}
 export class LoadStrikeResponse {
     /**
      * Creates a successful reply.
@@ -3467,6 +3479,8 @@ export class LoadStrikeRunner {
         return this.buildContext();
     }
     async run(args = []) {
+        assertNoUnsupportedReportingSinkGraph(this.options.reportingSinks ?? []);
+        assertNoUnsupportedNativeTrackingScenarios(this.scenarios);
         if (this.contextConfigurators.length) {
             return new LoadStrikeRunner(this.scenarios, this.buildContext().toRunnerOptions(), [], this.internalOptions).run(args);
         }
@@ -3478,7 +3492,7 @@ export class LoadStrikeRunner {
         const scenarioAccumulators = new Map();
         const scenarioDurationsMs = new Map();
         const stepStats = new Map();
-        const sinks = (this.options.reportingSinks ?? []).map((sink) => cloneReportingSinkForRun(sink));
+        const sinks = (this.options.reportingSinks ?? []).map((sink) => cloneReportingSinkForRun(sink, this.options.infraConfig ?? {}));
         const sinkStates = sinks.map((sink, index) => ({
             sink,
             disabled: false,
@@ -3603,6 +3617,12 @@ export class LoadStrikeRunner {
             testInfo,
             getNodeInfo: () => attachNodeInfoAliases({ ...nodeInfo })
         };
+        Object.defineProperty(baseContext, REPORTING_INTERVAL_SECONDS, {
+            value: this.options.reportingIntervalSeconds ?? 5,
+            enumerable: false,
+            configurable: false,
+            writable: false
+        });
         attachBaseContextAliases(baseContext);
         const sinkSession = {
             startedUtc: createdUtc,
@@ -3657,6 +3677,7 @@ export class LoadStrikeRunner {
             name: state.name,
             iterationObservationPortalSink: Boolean(state.sink.iterationObservationPortalSink),
             iterationObservationShapeLimited: Boolean(state.sink.iterationObservationShapeLimited),
+            retryableErrorClassifier: (error) => isRetryableReportingSinkError(state.sink, error),
             saveIterationBatch: resolveSinkSaveIterationBatch(state.sink),
             completeIterationObservationStream: resolveSinkCompleteIterationObservationStream(state.sink)
         }));
@@ -4291,7 +4312,9 @@ export class LoadStrikeRunner {
                 return;
             }
             catch (error) {
-                const exhausted = attempts >= maximumAttempts;
+                const retryable = isRetryableReportingSinkError(state.sink, error);
+                const exhausted = attempts >= maximumAttempts || !retryable;
+                const reportedMaximumAttempts = retryable ? maximumAttempts : attempts;
                 const nextDelayMs = exhausted ? 0 : sinkRetryDelayMs(backoffMs, attempts);
                 logIterationObservationFailure(logger, exhausted ? "error" : "warn", {
                     sinkName: state.name,
@@ -4301,7 +4324,7 @@ export class LoadStrikeRunner {
                     resultOwnerId: "",
                     observationCount: 0,
                     attempt: attempts,
-                    maximumAttempts,
+                    maximumAttempts: reportedMaximumAttempts,
                     nextDelayMs
                 }, error);
                 if (exhausted) {
@@ -8867,6 +8890,7 @@ class ManagedScenarioTrackingRuntime {
     }
     async dispose() {
         this.shutdown = true;
+        this.interruptEndpointAdapters();
         this.rejectOutstandingWaiters();
         await Promise.all([
             this.sourceLoop,
@@ -8932,6 +8956,7 @@ class ManagedScenarioTrackingRuntime {
             failureSeen = failureSeen || this.isFailedObservationOutcome(outcome);
         }
         this.shutdown = true;
+        this.interruptEndpointAdapters();
         await Promise.all([
             this.sourceLoop,
             this.destinationLoop,
@@ -8948,6 +8973,20 @@ class ManagedScenarioTrackingRuntime {
             ? LoadStrikeResponse.fail("tracking_failures", "One or more observed source or destination events did not correlate successfully.", 0)
             : LoadStrikeResponse.ok("observed");
     }
+    interruptEndpointAdapters() {
+        try {
+            this.sourceAdapter.interrupt?.();
+        }
+        catch {
+            // Shutdown remains best-effort and still disposes every adapter below.
+        }
+        try {
+            this.destinationAdapter?.interrupt?.();
+        }
+        catch {
+            // Shutdown remains best-effort and still disposes every adapter below.
+        }
+    }
     async consumeSourceLoop() {
         while (!this.shutdown) {
             try {
@@ -9539,6 +9578,20 @@ function mapRuntimeTrackingEndpointSpec(spec, useLoadStrikeTraceIdHeader = false
         azureEventHubs: asTrackingRecord(pickTrackingValue(spec, "AzureEventHubs", "azureEventHubs")),
         sqs: asTrackingRecord(pickTrackingValue(spec, "Sqs", "sqs")),
         pushDiffusion: asTrackingRecord(pickTrackingValue(spec, "PushDiffusion", "pushDiffusion")),
+        grpc: mapRuntimeEndpointProtocolOptions(spec, ["Grpc", "grpc"], [
+            "Target", "target", "ServiceName", "serviceName", "MethodName", "methodName",
+            "MethodType", "methodType", "Deadline", "deadline", "DeadlineSeconds", "deadlineSeconds",
+            "DeadlineMs", "deadlineMs", "Metadata", "metadata", "Produce", "produce", "Consume", "consume",
+            "ProduceAsync", "produceAsync", "ConsumeAsync", "consumeAsync", "ConnectionMetadata", "connectionMetadata",
+            "NativeClient", "nativeClient"
+        ]),
+        webSocket: mapRuntimeEndpointProtocolOptions(spec, ["WebSocket", "webSocket"], [
+            "Url", "url", "Subprotocols", "subprotocols", "ConnectTimeout", "connectTimeout",
+            "ConnectTimeoutSeconds", "connectTimeoutSeconds", "ConnectTimeoutMs", "connectTimeoutMs",
+            "CloseTimeout", "closeTimeout", "CloseTimeoutSeconds", "closeTimeoutSeconds", "CloseTimeoutMs", "closeTimeoutMs",
+            "Produce", "produce", "Consume", "consume", "ProduceAsync", "produceAsync", "ConsumeAsync", "consumeAsync",
+            "ConnectionMetadata", "connectionMetadata", "NativeClient", "nativeClient"
+        ]),
         delegate: typeof delegateProduce === "function"
             || typeof delegateConsume === "function"
             || typeof delegateProduceAsync === "function"
@@ -9561,6 +9614,19 @@ function mapRuntimeTrackingEndpointSpec(spec, useLoadStrikeTraceIdHeader = false
             : undefined
     };
 }
+function mapRuntimeEndpointProtocolOptions(spec, nestedKeys, flatKeys) {
+    const nested = asTrackingRecord(pickTrackingValue(spec, ...nestedKeys));
+    if (Object.keys(nested).length > 0) {
+        return nested;
+    }
+    const options = {};
+    for (const key of flatKeys) {
+        if (Object.prototype.hasOwnProperty.call(spec, key)) {
+            options[key] = pickTrackingValue(spec, key);
+        }
+    }
+    return options;
+}
 function normalizeRuntimeTrackingPayload(payload, endpoint, index) {
     const normalized = {
         headers: {
@@ -10324,6 +10390,20 @@ function assertNoDisableLicenseEnforcementOption(value, source) {
         }
     }
 }
+function assertNoUnsupportedNativeTrackingScenarios(scenarios) {
+    for (const scenario of scenarios) {
+        const tracking = scenario.getTrackingConfiguration();
+        if (!tracking) {
+            continue;
+        }
+        for (const field of ["Source", "Destination"]) {
+            const endpoint = asTrackingRecord(pickTrackingValue(tracking, field, field.toLowerCase()));
+            if (Object.keys(endpoint).length > 0) {
+                validateNativeEndpointExecutionSupport(endpoint);
+            }
+        }
+    }
+}
 function normalizeRunContextCollectionShapes(values) {
     assertNoDisableLicenseEnforcementOption(values, "LoadStrikeContext");
     const normalized = {