@blokjs/runner 0.2.1 → 0.4.0

package/dist/index.d.ts

@@ -13,6 +13,13 @@ import { HttpRuntimeAdapter } from "./adapters/HttpRuntimeAdapter";
 import { NodeJsRuntimeAdapter } from "./adapters/NodeJsRuntimeAdapter";
 import type { ExecutionResult, RuntimeAdapter, RuntimeKind } from "./adapters/RuntimeAdapter";
 import { WasmRuntimeAdapter } from "./adapters/WasmRuntimeAdapter";
+import { DEFAULT_HEALTH_SERVICE_CONFIG, buildChannelOptions } from "./adapters/grpc/GrpcChannelOptions";
+import { GrpcClientPool, buildCredentials } from "./adapters/grpc/GrpcClientPool";
+import { NodeRuntimeService, bufferToJson, decodeExecuteResponse, encodeExecuteRequest, jsonToBuffer } from "./adapters/grpc/GrpcCodec";
+import { GRPC_STATUS_MAP, categoryToGrpcStatus, toBlokError as grpcToBlokError, isServiceError } from "./adapters/grpc/GrpcErrors";
+import { GrpcRuntimeAdapter } from "./adapters/grpc/GrpcRuntimeAdapter";
+import { DEFAULT_GRPC_PORTS, GRPC_DEFAULTS } from "./adapters/grpc/types";
+import { resolveTransportForKind } from "./adapters/transport";
 import { type FnNodeDefinition, FunctionNode, defineNode } from "./defineNode";
 import { CircuitBreaker, CircuitOpenError } from "./monitoring/CircuitBreaker";
 import { HealthCheck } from "./monitoring/HealthCheck";
@@ -39,10 +46,28 @@ import { GraphQLSchemaGenerator } from "./graphql/GraphQLSchemaGenerator";
 import { NodeDependencyGraph } from "./visualization/NodeDependencyGraph";
 import { WorkflowVisualizer } from "./visualization/WorkflowVisualizer";
 import { PerformanceProfiler } from "./monitoring/PerformanceProfiler";
+import { Janitor } from "./tracing/Janitor";
 import { RunTracker } from "./tracing/RunTracker";
 import { registerTraceRoutes } from "./tracing/TraceRouter";
 import { TracingLogger } from "./tracing/TracingLogger";
-import { sanitize as traceSanitize } from "./tracing/sanitize";
+import { redactSensitive as traceRedactSensitive, sanitize as traceSanitize } from "./tracing/sanitize";
+import { type RegisteredWorkflow, WorkflowRegistry } from "./workflow/WorkflowRegistry";
+import { ConcurrencyLimitError, type ConcurrencyLimitInfo, isConcurrencyLimitError } from "./concurrency/ConcurrencyLimitError";
+import { QueueExpiredError, type QueueExpiredInfo, isQueueExpiredError } from "./concurrency/QueueExpiredError";
+import type { ConcurrencyBackend } from "./concurrency/ConcurrencyBackend";
+import { NatsKvConcurrencyBackend, type NatsKvConcurrencyConfig, readNatsKvConfigFromEnv } from "./concurrency/NatsKvConcurrencyBackend";
+import { createConcurrencyBackend } from "./concurrency/createConcurrencyBackend";
+import { CONCURRENCY_DEFAULTS, type NormalizedConcurrencyConfig, readConcurrencyConfig } from "./concurrency/readConcurrencyConfig";
+import { StepTimeoutError, isStepTimeoutError } from "./timeouts/StepTimeoutError";
+import { RunCancelledError, isRunCancelledError } from "./RunCancelledError";
+import { PayloadTooLargeError, isPayloadTooLargeError } from "./PayloadTooLargeError";
+import { WaitDispatchRequest, isWaitDispatchRequest } from "./WaitDispatchRequest";
+import { ConcurrencyMetrics } from "./monitoring/ConcurrencyMetrics";
+import { JanitorMetrics } from "./monitoring/JanitorMetrics";
+import { DebounceCoordinator } from "./scheduling/DebounceCoordinator";
+import { type DeferredDispatchInfo, DeferredDispatchSignal, isDeferredDispatchSignal } from "./scheduling/DeferredDispatchSignal";
+import { DeferredRunScheduler, type DeferredScheduleOptions } from "./scheduling/DeferredRunScheduler";
+import { type NormalizedDebounceConfig, type NormalizedSchedulingConfig, SCHEDULING_DEFAULTS, readSchedulingConfig } from "./scheduling/readSchedulingConfig";
 import { CostEstimator } from "./cost/CostEstimator";
 import { DEFAULT_DURATIONS, DEFAULT_MEMORY, PRICING, getRuntimeCategory } from "./cost/pricing";
 import { SentryIntegration } from "./integrations/SentryIntegration";
@@ -70,9 +95,13 @@ import Trigger from "./types/Trigger";
 import TriggerHttp from "./types/TriggerHttp";
 import TriggerResponse from "./types/TriggerResponse";
 import Triggers from "./types/Triggers";
-export { Configuration, Runner, ConfigurationResolver, DefaultLogger, LocalStorage, ResolverBase, TriggerBase, RuntimeRegistry, RuntimeAdapterNode, NodeJsRuntimeAdapter, DockerRuntimeAdapter, HttpRuntimeAdapter, BunRuntimeAdapter, WasmRuntimeAdapter, defineNode, FunctionNode, HealthCheck, RateLimiter, CircuitBreaker, CircuitOpenError, TriggerMetricsCollector, PrometheusMetricsBridge, bootstrapPrometheus, resetPrometheusBootstrap, RuntimeCatalog, RuntimeDiscovery, RuntimeHealthMonitor, RuntimeMetricsDashboard, RuntimeAutoScaler, FileWatcher, HotReloadManager, HmrDevConsole, AuthMiddleware, JWTAuthProvider, APIKeyAuthProvider, RBAC, createDefaultRBAC, ABACEngine, createDefaultABAC, AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink, OAuthOIDCProvider, TokenCache, SecretManager, EnvironmentSecretProvider, InMemorySecretProvider, VaultSecretProvider, AWSSecretsProvider, GCPSecretProvider, OpenAPIGenerator, GraphQLSchemaGenerator, WorkflowVisualizer, NodeDependencyGraph, PerformanceProfiler, RunTracker, registerTraceRoutes, TracingLogger, traceSanitize, CostEstimator, PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory, SentryIntegration, InMemoryCache, NodeResultCache, NodeTestHarness, WorkflowTestRunner, TestLogger, Condition, Conditions, Config, Flow, Inputs, Node, Properties, Targets, Trigger, TriggerHttp, Triggers, ParamsDictionary, GlobalOptions, NodeMap, JsonLikeObject, BlokService, BlokResponse, IBlokResponse, RunnerSteps, Average, TriggerResponse, };
+export { Configuration, Runner, ConfigurationResolver, DefaultLogger, LocalStorage, ResolverBase, TriggerBase, RuntimeRegistry, RuntimeAdapterNode, NodeJsRuntimeAdapter, DockerRuntimeAdapter, HttpRuntimeAdapter, BunRuntimeAdapter, WasmRuntimeAdapter, GrpcRuntimeAdapter, GrpcClientPool, buildCredentials, buildChannelOptions, NodeRuntimeService, encodeExecuteRequest, decodeExecuteResponse, jsonToBuffer, bufferToJson, GRPC_STATUS_MAP, GRPC_DEFAULTS, DEFAULT_GRPC_PORTS, DEFAULT_HEALTH_SERVICE_CONFIG, categoryToGrpcStatus, isServiceError, grpcToBlokError, resolveTransportForKind, defineNode, FunctionNode, HealthCheck, RateLimiter, CircuitBreaker, CircuitOpenError, TriggerMetricsCollector, PrometheusMetricsBridge, bootstrapPrometheus, resetPrometheusBootstrap, RuntimeCatalog, RuntimeDiscovery, RuntimeHealthMonitor, RuntimeMetricsDashboard, RuntimeAutoScaler, FileWatcher, HotReloadManager, HmrDevConsole, AuthMiddleware, JWTAuthProvider, APIKeyAuthProvider, RBAC, createDefaultRBAC, ABACEngine, createDefaultABAC, AuditLogger, ConsoleAuditSink, FileAuditSink, InMemoryAuditSink, OAuthOIDCProvider, TokenCache, SecretManager, EnvironmentSecretProvider, InMemorySecretProvider, VaultSecretProvider, AWSSecretsProvider, GCPSecretProvider, OpenAPIGenerator, GraphQLSchemaGenerator, WorkflowVisualizer, NodeDependencyGraph, PerformanceProfiler, RunTracker, Janitor, registerTraceRoutes, WorkflowRegistry, type RegisteredWorkflow, ConcurrencyLimitError, type ConcurrencyLimitInfo, isConcurrencyLimitError, QueueExpiredError, type QueueExpiredInfo, isQueueExpiredError, readConcurrencyConfig, type NormalizedConcurrencyConfig, CONCURRENCY_DEFAULTS, type ConcurrencyBackend, createConcurrencyBackend, NatsKvConcurrencyBackend, type NatsKvConcurrencyConfig, readNatsKvConfigFromEnv, StepTimeoutError, isStepTimeoutError, RunCancelledError, isRunCancelledError, PayloadTooLargeError, isPayloadTooLargeError, WaitDispatchRequest, isWaitDispatchRequest, ConcurrencyMetrics, JanitorMetrics, DeferredDispatchSignal, type DeferredDispatchInfo, isDeferredDispatchSignal, DeferredRunScheduler, type DeferredScheduleOptions, DebounceCoordinator, readSchedulingConfig, type NormalizedDebounceConfig, type NormalizedSchedulingConfig, SCHEDULING_DEFAULTS, TracingLogger, traceSanitize, traceRedactSensitive, CostEstimator, PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory, SentryIntegration, InMemoryCache, NodeResultCache, NodeTestHarness, WorkflowTestRunner, TestLogger, Condition, Conditions, Config, Flow, Inputs, Node, Properties, Targets, Trigger, TriggerHttp, Triggers, ParamsDictionary, GlobalOptions, NodeMap, JsonLikeObject, BlokService, BlokResponse, IBlokResponse, RunnerSteps, Average, TriggerResponse, };
 export type { RuntimeAdapter, RuntimeKind, ExecutionResult, FnNodeDefinition };
 export type { HttpRuntimeAdapterOptions } from "./adapters/HttpRuntimeAdapter";
+export type { TraceAuthorizeFn, TraceRouterOptions } from "./tracing/TraceRouter";
+export type { GrpcAdapterConfig, KeepaliveConfig, TlsConfig, Transport, } from "./adapters/grpc/types";
+export type { DecodedExecuteResponse, DecodedLogLine, DecodedMetrics, DecodedNodeError, ExecuteRequestProto, ExecuteResponseProto, LogLineProto, MetricsProto, NodeErrorProto, NodeRefProto, RuntimeStateProto, StepInfoProto, TriggerInfoProto, WorkflowInfoProto, ExecuteOptionsProto, } from "./adapters/grpc/GrpcCodec";
+export type { GrpcErrorContext } from "./adapters/grpc/GrpcErrors";
 export type { HealthStatus, HealthCheckResult, DependencyHealth, DependencyCheckFn, } from "./monitoring/HealthCheck";
 export type { RateLimitConfig, RateLimitResult } from "./monitoring/RateLimiter";
 export type { CircuitState, CircuitBreakerConfig, CircuitBreakerStats, CircuitBreakerEvent, CircuitBreakerEventType, CircuitBreakerListener, } from "./monitoring/CircuitBreaker";
@@ -104,4 +133,7 @@ export type { CacheProvider, CacheEntry, CacheSetOptions, CacheStats, InMemoryCa
 export type { LogEntry } from "./testing/TestLogger";
 export type { TestContextOverrides, TestResult, TestMetrics } from "./testing/TestHarness";
 export type { WorkflowTestConfig, WorkflowTestResult, ExecutionTrace, WorkflowExecuteOptions, } from "./testing/WorkflowTestRunner";
-export type { WorkflowRun, WorkflowRunStatus, NodeRun, NodeRunStatus, RunEvent, RunEventType, TraceLogEntry, WorkflowSummary as TraceWorkflowSummary, WorkflowDetail as TraceWorkflowDetail, PaginatedResult, StartRunOptions, StartNodeOptions, } from "./tracing/types";
+export type { WorkflowRun, WorkflowRunStatus, NodeRun, NodeRunStatus, RunEvent, RunEventType, TraceLogEntry, WorkflowSummary as TraceWorkflowSummary, WorkflowDetail as TraceWorkflowDetail, PaginatedResult, StartRunOptions, StartNodeOptions, ScheduledDispatchRow, } from "./tracing/types";
+export type { JanitorStats } from "./tracing/Janitor";
+export { createStore, InMemoryRunStore, SqliteRunStore } from "./tracing";
+export type { CreateStoreOptions, StoreType } from "./tracing";

package/dist/index.js

@@ -13,6 +13,13 @@ import { DockerRuntimeAdapter } from "./adapters/DockerRuntimeAdapter";
 import { HttpRuntimeAdapter } from "./adapters/HttpRuntimeAdapter";
 import { NodeJsRuntimeAdapter } from "./adapters/NodeJsRuntimeAdapter";
 import { WasmRuntimeAdapter } from "./adapters/WasmRuntimeAdapter";
+import { DEFAULT_HEALTH_SERVICE_CONFIG, buildChannelOptions } from "./adapters/grpc/GrpcChannelOptions";
+import { GrpcClientPool, buildCredentials } from "./adapters/grpc/GrpcClientPool";
+import { NodeRuntimeService, bufferToJson, decodeExecuteResponse, encodeExecuteRequest, jsonToBuffer, } from "./adapters/grpc/GrpcCodec";
+import { GRPC_STATUS_MAP, categoryToGrpcStatus, toBlokError as grpcToBlokError, isServiceError, } from "./adapters/grpc/GrpcErrors";
+import { GrpcRuntimeAdapter } from "./adapters/grpc/GrpcRuntimeAdapter";
+import { DEFAULT_GRPC_PORTS, GRPC_DEFAULTS } from "./adapters/grpc/types";
+import { resolveTransportForKind } from "./adapters/transport";
 // Function-first node API
 import { FunctionNode, defineNode } from "./defineNode";
 import { CircuitBreaker, CircuitOpenError } from "./monitoring/CircuitBreaker";
@@ -49,10 +56,37 @@ import { WorkflowVisualizer } from "./visualization/WorkflowVisualizer";
 // Performance Profiling
 import { PerformanceProfiler } from "./monitoring/PerformanceProfiler";
 // Tracing (Blok Studio)
+import { Janitor } from "./tracing/Janitor";
 import { RunTracker } from "./tracing/RunTracker";
 import { registerTraceRoutes } from "./tracing/TraceRouter";
 import { TracingLogger } from "./tracing/TracingLogger";
-import { sanitize as traceSanitize } from "./tracing/sanitize";
+import { redactSensitive as traceRedactSensitive, sanitize as traceSanitize } from "./tracing/sanitize";
+// Workflow registry (Tier 2 sub-workflow primitive)
+import { WorkflowRegistry } from "./workflow/WorkflowRegistry";
+// Concurrency gate (Tier 2 #6)
+import { ConcurrencyLimitError, isConcurrencyLimitError, } from "./concurrency/ConcurrencyLimitError";
+// Queue-mode TTL expiry (PR 1-5 polish · 410 Gone vs 429)
+import { QueueExpiredError, isQueueExpiredError } from "./concurrency/QueueExpiredError";
+import { NatsKvConcurrencyBackend, readNatsKvConfigFromEnv, } from "./concurrency/NatsKvConcurrencyBackend";
+import { createConcurrencyBackend } from "./concurrency/createConcurrencyBackend";
+import { CONCURRENCY_DEFAULTS, readConcurrencyConfig, } from "./concurrency/readConcurrencyConfig";
+// Per-step timeout (Tier 2 quick-wins)
+import { StepTimeoutError, isStepTimeoutError } from "./timeouts/StepTimeoutError";
+// Cooperative cancellation (Tier 2 follow-up)
+import { RunCancelledError, isRunCancelledError } from "./RunCancelledError";
+// Durable-scheduler payload size cap (PR 2 A4)
+import { PayloadTooLargeError, isPayloadTooLargeError } from "./PayloadTooLargeError";
+// Wait step primitive (PR 4)
+import { WaitDispatchRequest, isWaitDispatchRequest } from "./WaitDispatchRequest";
+// Concurrency / scheduling OTel metrics (Tier 2 follow-up)
+import { ConcurrencyMetrics } from "./monitoring/ConcurrencyMetrics";
+// Janitor sweep OTel metrics (PR 3 D3)
+import { JanitorMetrics } from "./monitoring/JanitorMetrics";
+// Scheduling — delay / TTL / debounce (Tier 2 #5 + #7)
+import { DebounceCoordinator } from "./scheduling/DebounceCoordinator";
+import { DeferredDispatchSignal, isDeferredDispatchSignal, } from "./scheduling/DeferredDispatchSignal";
+import { DeferredRunScheduler } from "./scheduling/DeferredRunScheduler";
+import { SCHEDULING_DEFAULTS, readSchedulingConfig, } from "./scheduling/readSchedulingConfig";
 // Cost Estimation
 import { CostEstimator } from "./cost/CostEstimator";
 import { DEFAULT_DURATIONS, DEFAULT_MEMORY, PRICING, getRuntimeCategory } from "./cost/pricing";
@@ -72,6 +106,8 @@ import RunnerSteps from "./RunnerSteps";
 export { Configuration, Runner, ConfigurationResolver, DefaultLogger, LocalStorage, ResolverBase, TriggerBase, 
 // Runtime adapters
 RuntimeRegistry, RuntimeAdapterNode, NodeJsRuntimeAdapter, DockerRuntimeAdapter, HttpRuntimeAdapter, BunRuntimeAdapter, WasmRuntimeAdapter, 
+// gRPC runtime adapter
+GrpcRuntimeAdapter, GrpcClientPool, buildCredentials, buildChannelOptions, NodeRuntimeService, encodeExecuteRequest, decodeExecuteResponse, jsonToBuffer, bufferToJson, GRPC_STATUS_MAP, GRPC_DEFAULTS, DEFAULT_GRPC_PORTS, DEFAULT_HEALTH_SERVICE_CONFIG, categoryToGrpcStatus, isServiceError, grpcToBlokError, resolveTransportForKind, 
 // Function-first API
 defineNode, FunctionNode, 
 // Monitoring
@@ -95,7 +131,25 @@ WorkflowVisualizer, NodeDependencyGraph,
 // Performance Profiling
 PerformanceProfiler, 
 // Tracing (Blok Studio)
-RunTracker, registerTraceRoutes, TracingLogger, traceSanitize, 
+RunTracker, Janitor, registerTraceRoutes, WorkflowRegistry, 
+// Concurrency gate (Tier 2 #6)
+ConcurrencyLimitError, isConcurrencyLimitError, 
+// Queue-mode TTL expiry (PR 1-5 polish)
+QueueExpiredError, isQueueExpiredError, readConcurrencyConfig, CONCURRENCY_DEFAULTS, createConcurrencyBackend, NatsKvConcurrencyBackend, readNatsKvConfigFromEnv, 
+// Per-step timeout (Tier 2 quick-wins)
+StepTimeoutError, isStepTimeoutError, 
+// Cooperative cancellation (Tier 2 follow-up)
+RunCancelledError, isRunCancelledError, 
+// Durable-scheduler payload size cap (PR 2 A4)
+PayloadTooLargeError, isPayloadTooLargeError, 
+// Wait step primitive (PR 4)
+WaitDispatchRequest, isWaitDispatchRequest, 
+// Concurrency / scheduling OTel metrics (Tier 2 follow-up)
+ConcurrencyMetrics, 
+// Janitor sweep OTel metrics (PR 3 D3)
+JanitorMetrics, 
+// Scheduling — delay / TTL / debounce (Tier 2 #5 + #7)
+DeferredDispatchSignal, isDeferredDispatchSignal, DeferredRunScheduler, DebounceCoordinator, readSchedulingConfig, SCHEDULING_DEFAULTS, TracingLogger, traceSanitize, traceRedactSensitive, 
 // Cost Estimation
 CostEstimator, PRICING, DEFAULT_DURATIONS, DEFAULT_MEMORY, getRuntimeCategory, 
 // Integrations
@@ -104,4 +158,9 @@ SentryIntegration,
 InMemoryCache, NodeResultCache, 
 // Testing
 NodeTestHarness, WorkflowTestRunner, TestLogger, NodeMap, BlokService, BlokResponse, RunnerSteps, };
+// Tracing store factory + concrete stores — exposed so the CLI's
+// standalone `blokctl studio` mode can spin up its own SQLite-backed
+// tracker without proxying to a live trigger. See
+// `packages/cli/src/commands/trace/startStudio.ts` for the call site.
+export { createStore, InMemoryRunStore, SqliteRunStore } from "./tracing";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,qBAAqB,MAAM,yBAAyB,CAAC;AAC5D,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAC1C,OAAO,MAAM,MAAM,UAAU,CAAC;AAC9B,OAAO,WAAW,MAAM,eAAe,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,mBAAmB;AACnB,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACxG,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EACN,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,GACZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACN,eAAe,EACf,oBAAoB,EACpB,WAAW,IAAI,eAAe,EAC9B,cAAc,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,0BAA0B;AAC1B,OAAO,EAAyB,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/E,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/E,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjG,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,6BAA6B;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAEhF,+BAA+B;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACzG,WAAW;AACX,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,GACnB,MAAM,0BAA0B,CAAC;AAElC,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,UAAU;AACV,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC1E,gBAAgB;AAChB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAExE,wBAAwB;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,wBAAwB;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,eAAe,IAAI,oBAAoB,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExG,oDAAoD;AACpD,OAAO,EAA2B,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAExF,+BAA+B;AAC/B,OAAO,EACN,qBAAqB,EAErB,uBAAuB,GACvB,MAAM,qCAAqC,CAAC;AAC7C,0DAA0D;AAC1D,OAAO,EAAE,iBAAiB,EAAyB,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAIhH,OAAO,EACN,wBAAwB,EAExB,uBAAuB,GACvB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,EACN,oBAAoB,EAEpB,qBAAqB,GACrB,MAAM,qCAAqC,CAAC;AAC7C,uCAAuC;AACvC,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEnF,8CAA8C;AAC9C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE7E,+CAA+C;AAC/C,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEtF,6BAA6B;AAC7B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,2DAA2D;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACrE,uCAAuC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,uDAAuD;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAEN,sBAAsB,EACtB,wBAAwB,GACxB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAgC,MAAM,mCAAmC,CAAC;AACvG,OAAO,EAGN,mBAAmB,EACnB,oBAAoB,GACpB,MAAM,mCAAmC,CAAC;AAE3C,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEhG,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,QAAQ;AACR,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEzE,oBAAoB;AACpB,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,QAAQ;AAER,OAAO,WAAW,MAAM,QAAQ,CAAC;AACjC,OAAO,YAA+B,MAAM,gBAAgB,CAAC;AAC7D,OAAO,OAAO,MAAM,WAAW,CAAC;AAChC,OAAO,WAAW,MAAM,eAAe,CAAC;AAkBxC,OAAO,EACN,aAAa,EACb,MAAM,EACN,qBAAqB,EACrB,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW;AACX,mBAAmB;AACnB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB;AAClB,uBAAuB;AACvB,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,6BAA6B,EAC7B,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,uBAAuB;AACvB,qBAAqB;AACrB,UAAU,EACV,YAAY;AACZ,aAAa;AACb,WAAW,EACX,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB;AACxB,cAAc;AACd,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,iBAAiB;AACjB,MAAM;AACN,WAAW,EACX,gBAAgB,EAChB,aAAa;AACb,WAAW;AACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,IAAI,EACJ,iBAAiB,EACjB,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,iBAAiB;AACjB,mBAAmB;AACnB,iBAAiB,EACjB,UAAU;AACV,oBAAoB;AACpB,aAAa,EACb,yBAAyB,EACzB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB;AACjB,UAAU;AACV,gBAAgB;AAChB,UAAU;AACV,sBAAsB;AACtB,gBAAgB;AAChB,kBAAkB,EAClB,mBAAmB;AACnB,wBAAwB;AACxB,mBAAmB;AACnB,wBAAwB;AACxB,UAAU,EACV,OAAO,EACP,mBAAmB,EACnB,gBAAgB;AAEhB,+BAA+B;AAC/B,qBAAqB,EAErB,uBAAuB;AACvB,wCAAwC;AACxC,iBAAiB,EAEjB,mBAAmB,EACnB,qBAAqB,EAErB,oBAAoB,EAGpB,wBAAwB,EACxB,wBAAwB,EAExB,uBAAuB;AACvB,uCAAuC;AACvC,gBAAgB,EAChB,kBAAkB;AAClB,8CAA8C;AAC9C,iBAAiB,EACjB,mBAAmB;AACnB,+CAA+C;AAC/C,oBAAoB,EACpB,sBAAsB;AACtB,6BAA6B;AAC7B,mBAAmB,EACnB,qBAAqB;AACrB,2DAA2D;AAC3D,kBAAkB;AAClB,uCAAuC;AACvC,cAAc;AACd,uDAAuD;AACvD,sBAAsB,EAEtB,wBAAwB,EACxB,oBAAoB,EAEpB,mBAAmB,EACnB,oBAAoB,EAGpB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,oBAAoB;AACpB,kBAAkB;AAClB,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,cAAc,EACd,kBAAkB;AAClB,eAAe;AACf,iBAAiB;AACjB,QAAQ;AACR,aAAa,EACb,eAAe;AACf,UAAU;AACV,eAAe,EACf,kBAAkB,EAClB,UAAU,EAeV,OAAO,EAEP,WAAW,EACX,YAAY,EAEZ,WAAW,GAGX,CAAC;AAsRF,iEAAiE;AACjE,qEAAqE;AACrE,kDAAkD;AAClD,sEAAsE;AACtE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/monitoring/ConcurrencyMetrics.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Tier 2 follow-up · OpenTelemetry counters for concurrency + scheduling
+ * resource lifecycle events.
+ *
+ * Wired into:
+ * - `TriggerBase.run`'s concurrency gate — `recordAcquired` /
+ *   `recordDenied` / `recordReleased` per slot operation.
+ * - `HttpTrigger.recoverDispatches` — `recordDispatchRecovered` /
+ *   `recordDispatchExpired` for boot-recovery observability.
+ * - The scheduler / debounce coordinator — `recordDispatchFired`
+ *   when a deferred timer fires successfully.
+ *
+ * Singleton; lazy-instantiated. No-ops cleanly when OTel isn't
+ * configured (the meter API silently swallows recordings without
+ * an exporter).
+ */
+interface ConcurrencyAttributes {
+    workflow_name: string;
+    concurrency_key?: string;
+}
+interface SchedulingAttributes {
+    workflow_name: string;
+    trigger_type: string;
+    dispatch_status?: string;
+}
+export declare class ConcurrencyMetrics {
+    private static instance;
+    private readonly acquiredCounter;
+    private readonly deniedCounter;
+    private readonly releasedCounter;
+    private readonly dispatchRecoveredCounter;
+    private readonly dispatchExpiredCounter;
+    private readonly dispatchFiredCounter;
+    private readonly backendInstallCounter;
+    private readonly occRetriesHistogram;
+    private constructor();
+    static getInstance(): ConcurrencyMetrics;
+    /** Test-only — drop the singleton so re-import gets fresh meters. */
+    static resetInstance(): void;
+    recordAcquired(attrs: ConcurrencyAttributes): void;
+    recordDenied(attrs: ConcurrencyAttributes & {
+        mode: "throw" | "queue";
+    }): void;
+    recordReleased(attrs: ConcurrencyAttributes): void;
+    recordDispatchRecovered(attrs: SchedulingAttributes): void;
+    recordDispatchExpired(attrs: SchedulingAttributes): void;
+    recordDispatchFired(attrs: SchedulingAttributes): void;
+    recordBackendInstall(attrs: {
+        backend: string;
+        status: "success" | "failure";
+    }): void;
+    recordOccRetries(attrs: ConcurrencyAttributes & {
+        outcome: "success" | "denied" | "fail-closed";
+    }, attempts: number): void;
+}
+export {};

package/dist/monitoring/ConcurrencyMetrics.js

@@ -0,0 +1,107 @@
+/**
+ * Tier 2 follow-up · OpenTelemetry counters for concurrency + scheduling
+ * resource lifecycle events.
+ *
+ * Wired into:
+ * - `TriggerBase.run`'s concurrency gate — `recordAcquired` /
+ *   `recordDenied` / `recordReleased` per slot operation.
+ * - `HttpTrigger.recoverDispatches` — `recordDispatchRecovered` /
+ *   `recordDispatchExpired` for boot-recovery observability.
+ * - The scheduler / debounce coordinator — `recordDispatchFired`
+ *   when a deferred timer fires successfully.
+ *
+ * Singleton; lazy-instantiated. No-ops cleanly when OTel isn't
+ * configured (the meter API silently swallows recordings without
+ * an exporter).
+ */
+import { metrics } from "@opentelemetry/api";
+export class ConcurrencyMetrics {
+    static instance = null;
+    acquiredCounter = metrics.getMeter("blok").createCounter("blok_concurrency_acquired_total", {
+        description: "Total concurrency slots acquired (per workflow + key).",
+        unit: "1",
+    });
+    deniedCounter = metrics.getMeter("blok").createCounter("blok_concurrency_denied_total", {
+        description: "Total concurrency slot denials (limit hit; throttled or queued).",
+        unit: "1",
+    });
+    releasedCounter = metrics.getMeter("blok").createCounter("blok_concurrency_released_total", {
+        description: "Total concurrency slots released (run reached terminal state).",
+        unit: "1",
+    });
+    dispatchRecoveredCounter = metrics
+        .getMeter("blok")
+        .createCounter("blok_scheduling_dispatch_recovered_total", {
+        description: "Scheduled dispatches re-registered on boot recovery (HttpTrigger).",
+        unit: "1",
+    });
+    dispatchExpiredCounter = metrics
+        .getMeter("blok")
+        .createCounter("blok_scheduling_dispatch_expired_total", {
+        description: "Scheduled dispatches marked expired on boot recovery (TTL elapsed).",
+        unit: "1",
+    });
+    dispatchFiredCounter = metrics
+        .getMeter("blok")
+        .createCounter("blok_scheduling_dispatch_fired_total", {
+        description: "Scheduled dispatches fired by the in-process scheduler.",
+        unit: "1",
+    });
+    // PR 3 D1 — backend install observability. Operators who misconfigure
+    // the cross-process backend (NATS KV unreachable / auth failure) get a
+    // silent fallback to the in-process backend. This counter surfaces
+    // install attempts so misconfiguration is visible in metrics.
+    backendInstallCounter = metrics
+        .getMeter("blok")
+        .createCounter("blok_concurrency_backend_install_total", {
+        description: "Concurrency backend install attempts (success / failure).",
+        unit: "1",
+    });
+    // PR 3 D2 — OCC retry depth histogram. The 95% fail-close rate at
+    // 200-way contention seen in LOAD-TESTS.md is invisible without a
+    // histogram. Recorded per acquireSlot exit point with bucket
+    // boundaries [0, 1, 2, 3, 5, 10] — OCC retry budget caps at 10.
+    occRetriesHistogram = metrics.getMeter("blok").createHistogram("blok_concurrency_occ_retries", {
+        description: "OCC retry attempts on cross-process concurrency backends.",
+        unit: "{retries}",
+        advice: { explicitBucketBoundaries: [0, 1, 2, 3, 5, 10] },
+    });
+    constructor() { }
+    static getInstance() {
+        if (!ConcurrencyMetrics.instance) {
+            ConcurrencyMetrics.instance = new ConcurrencyMetrics();
+        }
+        return ConcurrencyMetrics.instance;
+    }
+    /** Test-only — drop the singleton so re-import gets fresh meters. */
+    static resetInstance() {
+        ConcurrencyMetrics.instance = null;
+    }
+    recordAcquired(attrs) {
+        this.acquiredCounter.add(1, attrs);
+    }
+    recordDenied(attrs) {
+        this.deniedCounter.add(1, attrs);
+    }
+    recordReleased(attrs) {
+        this.releasedCounter.add(1, attrs);
+    }
+    recordDispatchRecovered(attrs) {
+        this.dispatchRecoveredCounter.add(1, attrs);
+    }
+    recordDispatchExpired(attrs) {
+        this.dispatchExpiredCounter.add(1, attrs);
+    }
+    recordDispatchFired(attrs) {
+        this.dispatchFiredCounter.add(1, attrs);
+    }
+    // PR 3 D1 — backend install attempt outcome.
+    recordBackendInstall(attrs) {
+        this.backendInstallCounter.add(1, attrs);
+    }
+    // PR 3 D2 — OCC retry depth + outcome (success | denied | fail-closed).
+    recordOccRetries(attrs, attempts) {
+        this.occRetriesHistogram.record(attempts, attrs);
+    }
+}
+//# sourceMappingURL=ConcurrencyMetrics.js.map

package/dist/monitoring/ConcurrencyMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConcurrencyMetrics.js","sourceRoot":"","sources":["../../src/monitoring/ConcurrencyMetrics.ts"],"names":[],"mappings":"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"}

package/dist/monitoring/JanitorMetrics.d.ts

@@ -0,0 +1,27 @@
+/**
+ * PR 3 D3 — OpenTelemetry metrics for the Janitor sweep.
+ *
+ * Operators tuning `BLOK_JANITOR_INTERVAL_MS` need real numbers per
+ * sweep: how long does each table's purge take, how many rows did it
+ * remove? This singleton exposes a histogram for sweep duration and a
+ * counter for purged rows, both labeled by the table being swept.
+ *
+ * Wired into `Janitor.runOnce` per-table after each purge call.
+ *
+ * No-op cleanly when OTel isn't configured (the meter API silently
+ * swallows recordings without an exporter).
+ */
+interface JanitorAttributes {
+    table: "idempotency_cache" | "concurrency_locks" | "scheduled_dispatches";
+}
+export declare class JanitorMetrics {
+    private static instance;
+    private readonly sweepDurationHistogram;
+    private readonly purgedCounter;
+    private constructor();
+    static getInstance(): JanitorMetrics;
+    /** Test-only — drop the singleton so re-import gets fresh meters. */
+    static resetInstance(): void;
+    recordSweep(attrs: JanitorAttributes, durationMs: number, rowsPurged: number): void;
+}
+export {};

package/dist/monitoring/JanitorMetrics.js

@@ -0,0 +1,48 @@
+/**
+ * PR 3 D3 — OpenTelemetry metrics for the Janitor sweep.
+ *
+ * Operators tuning `BLOK_JANITOR_INTERVAL_MS` need real numbers per
+ * sweep: how long does each table's purge take, how many rows did it
+ * remove? This singleton exposes a histogram for sweep duration and a
+ * counter for purged rows, both labeled by the table being swept.
+ *
+ * Wired into `Janitor.runOnce` per-table after each purge call.
+ *
+ * No-op cleanly when OTel isn't configured (the meter API silently
+ * swallows recordings without an exporter).
+ */
+import { metrics } from "@opentelemetry/api";
+export class JanitorMetrics {
+    static instance = null;
+    sweepDurationHistogram = metrics.getMeter("blok").createHistogram("blok_janitor_sweep_duration_ms", {
+        description: "Janitor sweep duration per table.",
+        unit: "ms",
+        advice: { explicitBucketBoundaries: [1, 5, 10, 50, 100, 500, 1000, 5000, 30000] },
+    });
+    purgedCounter = metrics.getMeter("blok").createCounter("blok_janitor_purged_total", {
+        description: "Total rows purged by the Janitor per table.",
+        unit: "1",
+    });
+    constructor() { }
+    static getInstance() {
+        if (!JanitorMetrics.instance) {
+            JanitorMetrics.instance = new JanitorMetrics();
+        }
+        return JanitorMetrics.instance;
+    }
+    /** Test-only — drop the singleton so re-import gets fresh meters. */
+    static resetInstance() {
+        JanitorMetrics.instance = null;
+    }
+    recordSweep(attrs, durationMs, rowsPurged) {
+        this.sweepDurationHistogram.record(durationMs, attrs);
+        // Review fix-up · GAP-2. Always record the counter, even when zero.
+        // Without zero-row recordings, operators can't distinguish
+        // "Janitor running, table clean" from "Janitor not running" by
+        // looking at the counter alone. The duration histogram captures
+        // liveness too, but pairing them under the same emit cadence
+        // keeps dashboards consistent.
+        this.purgedCounter.add(rowsPurged, attrs);
+    }
+}
+//# sourceMappingURL=JanitorMetrics.js.map

package/dist/monitoring/JanitorMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JanitorMetrics.js","sourceRoot":"","sources":["../../src/monitoring/JanitorMetrics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAM7C,MAAM,OAAO,cAAc;IAClB,MAAM,CAAC,QAAQ,GAA0B,IAAI,CAAC;IAErC,sBAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,gCAAgC,EAAE;QACpH,WAAW,EAAE,mCAAmC;QAChD,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,EAAE,wBAAwB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE;KACjF,CAAC,CAAC;IAEc,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,2BAA2B,EAAE;QACpG,WAAW,EAAE,6CAA6C;QAC1D,IAAI,EAAE,GAAG;KACT,CAAC,CAAC;IAEH,gBAAuB,CAAC;IAExB,MAAM,CAAC,WAAW;QACjB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC9B,cAAc,CAAC,QAAQ,GAAG,IAAI,cAAc,EAAE,CAAC;QAChD,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED,qEAAqE;IACrE,MAAM,CAAC,aAAa;QACnB,cAAc,CAAC,QAAQ,GAAG,IAAI,CAAC;IAChC,CAAC;IAED,WAAW,CAAC,KAAwB,EAAE,UAAkB,EAAE,UAAkB;QAC3E,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,UAAU,EAAE,KAA0C,CAAC,CAAC;QAC3F,oEAAoE;QACpE,2DAA2D;QAC3D,+DAA+D;QAC/D,gEAAgE;QAChE,6DAA6D;QAC7D,+BAA+B;QAC/B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,KAA0C,CAAC,CAAC;IAChF,CAAC"}

package/dist/scheduling/DebounceCoordinator.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Tier 2 #7 — in-memory debounce coordinator.
+ *
+ * Coalesces rapid same-key triggers into a single delayed run. Modes:
+ *
+ * - `"trailing"` (default): each ping resets a timer; the run fires
+ *   after `delayMs` of silence. Latest payload wins. `maxDelayMs`
+ *   bounds tail latency — even with continuous pings, the run fires
+ *   after `maxDelayMs` from the FIRST ping.
+ * - `"leading"`: the first ping fires immediately. Subsequent pings
+ *   within `delayMs` are dropped. Window resets after `delayMs` of
+ *   silence.
+ *
+ * Process-wide singleton. In-memory only for v1 — cross-process
+ * debounce keys are a deferred follow-up.
+ */
+export type DebounceDispatchFn = () => Promise<void>;
+export type DebounceMode = "leading" | "trailing";
+export interface DebounceRegisterOpts {
+    workflowName: string;
+    debounceKey: string;
+    mode: DebounceMode;
+    delayMs: number;
+    maxDelayMs?: number;
+    /**
+     * Run id allocated by the caller for THIS ping. On a fresh window
+     * this becomes the active run id; on a coalesce it's a "loser" and
+     * the caller marks it `debounced` terminal.
+     */
+    runId: string;
+    /**
+     * Callback the coordinator invokes when the trailing-mode window
+     * closes. Captures ctx + runId via closure. NOT called for leading
+     * mode (the caller runs the first ping synchronously) or for
+     * coalesce pings (those are dropped by definition).
+     */
+    onFire: DebounceDispatchFn;
+    /**
+     * Test-only override of "now" for deterministic tests. Production
+     * code does not pass this.
+     */
+    __now?: number;
+}
+/**
+ * The outcome of `register`. Branches the caller's behavior.
+ *
+ * - `"fire-immediate"` (leading + fresh window) — caller runs the
+ *   workflow synchronously. The window is now open; subsequent pings
+ *   in `delayMs` are suppressed.
+ * - `"schedule-trailing"` (trailing + fresh window) — caller marks the
+ *   run `debounced` (transient) and throws `DeferredDispatchSignal`.
+ *   The coordinator's timer will invoke `onFire` after the window.
+ * - `"coalesce"` (leading or trailing + existing window) — caller marks
+ *   the run `debounced` (terminal, with `intoRunId = activeRunId`) and
+ *   throws `DeferredDispatchSignal`. The active run absorbs the ping.
+ */
+export interface DebounceRegisterResult {
+    outcome: "fire-immediate" | "schedule-trailing" | "coalesce";
+    /**
+     * The runId of the run that owns the active window. Equal to
+     * `opts.runId` on `fire-immediate` and `schedule-trailing`; equal to
+     * the EXISTING window's runId on `coalesce` (so the caller knows
+     * which run absorbed the ping).
+     */
+    activeRunId: string;
+    /** Dispatch time for trailing windows; undefined on `fire-immediate`. */
+    scheduledAt?: number;
+    /** Pings absorbed by the active window so far (including this one). */
+    pingCount: number;
+}
+export declare class DebounceCoordinator {
+    private static instance;
+    private states;
+    static getInstance(): DebounceCoordinator;
+    /** Test-only — reset the singleton + clear all state. */
+    static resetInstance(): void;
+    private bucket;
+    register(opts: DebounceRegisterOpts): DebounceRegisterResult;
+    private fireTrailing;
+    /** Cancel an active window without firing. Returns true if cancelled. */
+    cancel(workflowName: string, debounceKey: string): boolean;
+    /** Number of active debounce windows. Tests + observability. */
+    size(): number;
+    /** True if a window is open for `(workflow, key)`. */
+    has(workflowName: string, debounceKey: string): boolean;
+    /** Cancel everything without firing. */
+    clear(): void;
+}