@cadenza.io/service 2.20.1 → 2.21.1

package/README.md

@@ -103,6 +103,23 @@ await browserRuntime.waitUntilReady();
 
 Use `createCadenzaService(..., { isFrontend: true })` directly when you only need the lower-level frontend transport/bootstrap behavior. Use `createBrowserRuntimeActor(...)` when the frontend also needs actor-owned readiness and projected browser runtime state.
 
+### Layer-scoped tools in distributed manifests
+
+`@cadenza.io/service` treats helpers and globals as structural sync material.
+
+- `service_manifest` now includes `helpers`, `globals`, `taskToHelperMaps`, `helperToHelperMaps`, `taskToGlobalMaps`, and `helperToGlobalMaps`
+- helper/global rows are structural catalog data, not live remote execution membership
+- local `GraphMetadataController` fans out direct helper/global events as:
+  - `global.meta.graph_metadata.helper_created`
+  - `global.meta.graph_metadata.helper_updated`
+  - `global.meta.graph_metadata.global_created`
+  - `global.meta.graph_metadata.global_updated`
+  - `global.meta.graph_metadata.task_helper_associated`
+  - `global.meta.graph_metadata.helper_helper_associated`
+  - `global.meta.graph_metadata.task_global_associated`
+  - `global.meta.graph_metadata.helper_global_associated`
+- bootstrap full sync carries these rows so authority can rebuild persistence, but remote helper/global definitions are not exposed as executable local `tools`
+
 ### Creating a Nuxt runtime wrapper
 If your frontend is Nuxt, use `@cadenza.io/service/nuxt` on top of the shared browser actor. The Nuxt layer keeps the core runtime framework agnostic while hiding `useState`, plugin injection, and subscription wiring.
 

package/dist/{Cadenza-Duj65Skt.d.mts → Cadenza-gGtFW_Y-.d.mts}

@@ -1,4 +1,4 @@
-import { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, Actor, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, CadenzaMode, EmitOptions, Intent, RuntimeValidationPolicy, RuntimeValidationScope, TaskOptions, ActorSpec, ActorFactoryOptions, ActorDefinition, TaskFunction, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
+import _cadenza_io_core__default, { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, Actor, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, CadenzaMode, EmitOptions, Intent, RuntimeValidationPolicy, RuntimeValidationScope, TaskOptions, ActorSpec, ActorFactoryOptions, ActorDefinition, TaskFunction, HelperFunction, HelperDefinition, GlobalDefinition, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
 
 /**
  * Represents a task that delegates execution of a routine to a remote system or service.
@@ -38,6 +38,7 @@ declare class DeputyTask extends Task {
      * @return {void} This constructor does not return a value.
      */
     constructor(name: string, remoteRoutineName: string, serviceName?: string | undefined, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema | undefined, validateInputContext?: boolean, outputSchema?: Schema | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    clone(): never;
     /**
      * Executes the specified task function within the provided execution context.
      *
@@ -142,6 +143,7 @@ declare class DatabaseTask extends DeputyTask {
      * @return {void}
      */
     constructor(name: string, taskName: string, serviceName: string | undefined, description: string | undefined, queryData: DbOperationPayload, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema | undefined, validateInputContext?: boolean, outputSchema?: Schema | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    clone(): never;
     /**
      * Executes the specified task within the given context.
      *
@@ -235,6 +237,14 @@ interface ServiceInstanceDescriptor {
     serviceName: string;
     numberOfRunningGraphs?: number;
     isPrimary: boolean;
+    leaseStatus?: "active" | "non_responsive" | "inactive" | "deleted";
+    leaseExpiresAt?: string;
+    lastLeaseRenewedAt?: string;
+    isReady?: boolean;
+    readinessReason?: string | null;
+    lastReadyAt?: string | null;
+    lastObservedTransportAt?: string | null;
+    shutdownRequestedAt?: string | null;
     isActive: boolean;
     isNonResponsive: boolean;
     isBlocked: boolean;
@@ -331,6 +341,7 @@ declare class ServiceRegistry {
     private readonly runtimeStatusHeartbeatIntervalMs;
     private readonly runtimeMetricsSampleIntervalMs;
     private readonly runtimeStatusRestRefreshIntervalMs;
+    private readonly runtimeStatusLoopJitterRatio;
     private readonly runtimeStatusMissThreshold;
     private readonly runtimeStatusFallbackTimeoutMs;
     private readonly runtimeStatusAuthorityReportTimeoutMs;
@@ -343,6 +354,8 @@ declare class ServiceRegistry {
     private readonly routeFailurePenaltyMs;
     private readonly degradedGraphThreshold;
     private readonly overloadedGraphThreshold;
+    private readonly bootstrapFullSyncRetryJitterRatio;
+    private readonly serviceCommunicationRetryJitterRatio;
     serviceName: string | null;
     serviceInstanceId: string | null;
     numberOfRunningGraphs: number;
@@ -358,6 +371,10 @@ declare class ServiceRegistry {
     private knownGlobalSignalMaps;
     private authorityBootstrapRoute;
     private authorityBootstrapHandshakeInFlight;
+    private authorityBootstrapHandshakeRetryTimer;
+    private authorityBootstrapHandshakeRetryIndex;
+    private authorityBootstrapHandshakeRetryGeneration;
+    private authorityBootstrapHandshakeRetryReason;
     handleInstanceUpdateTask: Task;
     handleTransportUpdateTask: Task;
     handleGlobalSignalRegistrationTask: Task;
@@ -400,6 +417,13 @@ declare class ServiceRegistry {
     private getAuthorityBootstrapRestTarget;
     hasAuthorityBootstrapHandshakeEstablished(): boolean;
     private invalidateAuthorityBootstrapHandshake;
+    private clearAuthorityBootstrapHandshakeRetryTimer;
+    private invalidateAuthorityBootstrapHandshakeRetryState;
+    private markAuthorityBootstrapHandshakeSatisfied;
+    private buildJitteredAuthorityBootstrapHandshakeRetryDelayMs;
+    private scheduleAuthorityBootstrapHandshakeRetry;
+    private restartAuthorityBootstrapHandshakeRetryChain;
+    private restartAuthorityBootstrapRecovery;
     private requestAuthorityBootstrapHandshake;
     private invokeAuthorityBootstrapRoutine;
     private registerRemoteIntentDeputy;
@@ -410,6 +434,9 @@ declare class ServiceRegistry {
     ensureBootstrapAuthorityControlPlaneForInquiry(intentName: string, ctx?: AnyObject): boolean;
     private ensureBootstrapAuthorityControlPlane;
     private hasBootstrapFullSyncDeputies;
+    private buildDeterministicInstanceJitterKey;
+    private buildJitteredIntervalStartDate;
+    private buildJitteredBootstrapRetryDelayMs;
     private ensureAuthorityBootstrapSignalTransmissions;
     private clearBootstrapFullSyncRetryTimer;
     private invalidateBootstrapFullSyncRetryState;
@@ -466,6 +493,8 @@ declare class ServiceRegistry {
     private recordRoutingFailure;
     private clearRoutingCooldown;
     private hasRouteableInstanceForRouting;
+    private hasPendingRouteableInstanceForSelection;
+    private maybeSchedulePendingRouteSelectionRetry;
     private refreshRoutingCooldownsForService;
     private buildTransportFailureKey;
     private clearTransportFailureState;
@@ -968,6 +997,23 @@ type ServiceManifestRoutineDefinition = {
     service_name: string;
     is_meta: boolean;
 };
+type ServiceManifestHelperDefinition = {
+    name: string;
+    version: number;
+    description: string;
+    service_name: string;
+    is_meta: boolean;
+    handler_source: string;
+    language: "js" | "ts";
+};
+type ServiceManifestGlobalDefinition = {
+    name: string;
+    version: number;
+    description: string;
+    service_name: string;
+    is_meta: boolean;
+    value: unknown;
+};
 type ServiceManifestDirectionalTaskMap = {
     task_name: string;
     task_version: number;
@@ -1006,6 +1052,38 @@ type ServiceManifestTaskRoutineMap = {
     routine_version: number;
     service_name: string;
 };
+type ServiceManifestTaskHelperMap = {
+    task_name: string;
+    task_version: number;
+    service_name: string;
+    alias: string;
+    helper_name: string;
+    helper_version: number;
+};
+type ServiceManifestHelperHelperMap = {
+    helper_name: string;
+    helper_version: number;
+    service_name: string;
+    alias: string;
+    dependency_helper_name: string;
+    dependency_helper_version: number;
+};
+type ServiceManifestTaskGlobalMap = {
+    task_name: string;
+    task_version: number;
+    service_name: string;
+    alias: string;
+    global_name: string;
+    global_version: number;
+};
+type ServiceManifestHelperGlobalMap = {
+    helper_name: string;
+    helper_version: number;
+    service_name: string;
+    alias: string;
+    global_name: string;
+    global_version: number;
+};
 type ServiceManifestSnapshot = {
     serviceName: string;
     serviceInstanceId: string;
@@ -1018,11 +1096,17 @@ type ServiceManifestSnapshot = {
     intents: ServiceManifestIntentDefinition[];
     actors: ServiceManifestActorDefinition[];
     routines: ServiceManifestRoutineDefinition[];
+    helpers: ServiceManifestHelperDefinition[];
+    globals: ServiceManifestGlobalDefinition[];
     directionalTaskMaps: ServiceManifestDirectionalTaskMap[];
     signalToTaskMaps: ServiceManifestSignalTaskMap[];
     intentToTaskMaps: ServiceManifestIntentTaskMap[];
     actorTaskMaps: ServiceManifestActorTaskMap[];
     taskToRoutineMaps: ServiceManifestTaskRoutineMap[];
+    taskToHelperMaps: ServiceManifestTaskHelperMap[];
+    helperToHelperMaps: ServiceManifestHelperHelperMap[];
+    taskToGlobalMaps: ServiceManifestTaskGlobalMap[];
+    helperToGlobalMaps: ServiceManifestHelperGlobalMap[];
 };
 
 type SecurityProfile = "low" | "medium" | "high";
@@ -1070,6 +1154,7 @@ declare class CadenzaService {
     protected static isBootstrapped: boolean;
     protected static serviceCreated: boolean;
     protected static bootstrapSyncCompleted: boolean;
+    protected static bootstrapSyncCompletedAt: number;
     protected static bootstrapSignalRegistrationsCompleted: boolean;
     protected static bootstrapIntentRegistrationsCompleted: boolean;
     protected static defaultDatabaseServiceName: string | null;
@@ -1078,9 +1163,17 @@ declare class CadenzaService {
     protected static frontendSyncScheduled: boolean;
     protected static serviceManifestRevision: number;
     protected static lastPublishedServiceManifestHashes: Partial<Record<ServiceManifestPublicationLayer, string>>;
+    protected static serviceManifestPublishedAt: Partial<Record<ServiceManifestPublicationLayer, number>>;
     protected static serviceManifestPublicationInFlight: boolean;
     protected static serviceManifestPublicationPendingReason: string | null;
     protected static serviceManifestPublicationPendingLayer: ServiceManifestPublicationLayer | null;
+    protected static serviceManifestPublicationRetryReason: string | null;
+    protected static serviceManifestPublicationRetryLayer: ServiceManifestPublicationLayer | null;
+    protected static serviceManifestPublicationRetryTimer: ReturnType<typeof setTimeout> | null;
+    protected static serviceManifestPublicationRetryCount: number;
+    protected static localServiceManifestDefinitionInserted: boolean;
+    protected static localServiceManifestInstanceInserted: boolean;
+    protected static initialServiceManifestPublicationRequested: boolean;
     private static shutdownHandlersRegistered;
     private static shutdownInFlight;
     private static shutdownHandlerCleanup;
@@ -1090,11 +1183,27 @@ declare class CadenzaService {
     private static replayRegisteredTaskSignalObservations;
     private static replayRegisteredTaskGraphMetadata;
     private static normalizeServiceManifestPublicationLayer;
+    private static clampServiceManifestPublicationLayer;
     private static mergeServiceManifestPublicationRequest;
+    private static getServiceManifestPublicationGate;
     private static requestServiceManifestPublication;
     private static scheduleServiceManifestPublicationRetry;
+    private static shouldPublishBusinessManifestForTaskContext;
+    private static isRoutingCriticalManifestSignalName;
+    private static isRoutingCriticalManifestIntentName;
+    private static isRoutingCriticalManifestTask;
+    private static hasRoutingCriticalManifestBindingInContext;
+    private static shouldPublishBusinessManifestForHelperContext;
+    private static shouldPublishBusinessManifestForGlobalContext;
+    private static shouldPublishBusinessManifestForRoutineContext;
+    private static shouldRequestServiceManifestPublicationForSignal;
+    private static maybeRequestInitialServiceManifestPublication;
+    private static scheduleInitialServiceManifestPublicationFallback;
     private static publishServiceManifestIfNeeded;
     private static ensureServiceManifestPublicationTasks;
+    private static isLocalAuthorityService;
+    private static canPublishServiceManifestToAuthority;
+    private static shouldRequireAuthorityBootstrapHandshakeForManifestPublication;
     private static buildLegacyLocalCadenzaDBTaskName;
     private static buildGeneratedLocalCadenzaDBTaskName;
     /**
@@ -1521,6 +1630,12 @@ declare class CadenzaService {
      * ```
      */
     static createTask(name: string, func: TaskFunction, description?: string, options?: TaskOptions): Task;
+    static createHelper(name: string, func: HelperFunction, description?: string): HelperDefinition;
+    static createMetaHelper(name: string, func: HelperFunction, description?: string): HelperDefinition;
+    static createHelperFromDefinition(definition: Parameters<typeof _cadenza_io_core__default.createHelperFromDefinition>[0]): HelperDefinition;
+    static createGlobal(name: string, value: unknown, description?: string): GlobalDefinition;
+    static createMetaGlobal(name: string, value: unknown, description?: string): GlobalDefinition;
+    static createGlobalFromDefinition(definition: Parameters<typeof _cadenza_io_core__default.createGlobalFromDefinition>[0]): GlobalDefinition;
     /**
      * Creates a meta task with the specified name, functionality, description, and options.
      * This is used for creating tasks that lives on the meta layer.
@@ -1796,4 +1911,4 @@ declare class CadenzaService {
     static reset(): void;
 }
 
-export { type ServiceTransportDescriptor as $, AUTHORITY_RUNTIME_STATUS_REPORT_INTENT as A, type BootstrapOptions as B, CadenzaService as C, type DatabaseSchemaDefinition as D, type DatabaseMigrationDefinition as E, type DatabaseMigrationPolicy as F, type DatabaseMigrationStep as G, type HydrationOptions as H, DatabaseTask as I, type JoinDefinition as J, type DbOperationType$1 as K, type DeputyDescriptor as L, DeputyTask as M, type DistributedInquiryMeta as N, type FieldDefinition as O, type InquiryResponderDescriptor as P, type InquiryResponderStatus as Q, type NetworkMode as R, type ServerOptions as S, type OpEffect as T, type QueryMode as U, RUNTIME_STATUS_AUTHORITY_SYNC_REQUESTED_SIGNAL as V, type ResolvedBootstrapEndpoint as W, type RuntimeMetricsHealthDetail as X, type SecurityProfile as Y, type ServiceInstanceDescriptor as Z, type ServiceTransportConfig as _, type DatabaseOptions as a, type ServiceTransportProtocol as a0, type ServiceTransportRole as a1, type ServiceTransportSecurityProfile as a2, SignalTransmissionTask as a3, type SortDirection as a4, type SubOperationType as a5, type TableDefinition as a6, type ValueOrSubOp as a7, buildAuthorityRuntimeStatusSignature as a8, normalizeAuthorityRuntimeStatusReport as a9, type DbOperationPayload as b, type SubOperation as c, type DistributedInquiryOptions as d, type ServiceManifestSnapshot as e, type ServiceManifestPublicationLayer as f, type ServiceManifestTaskDefinition as g, type ServiceManifestSignalDefinition as h, type ServiceManifestIntentDefinition as i, type ServiceManifestActorDefinition as j, type ServiceManifestRoutineDefinition as k, type ServiceManifestDirectionalTaskMap as l, type ServiceManifestSignalTaskMap as m, type ServiceManifestIntentTaskMap as n, type ServiceManifestActorTaskMap as o, type ServiceManifestTaskRoutineMap as p, ServiceRegistry as q, type AggregateDefinition as r, type AggregateFunction as s, type AuthorityRuntimeStatusReport as t, type BrowserRuntimeActorHandle as u, type BrowserRuntimeActorOptions as v, type BrowserRuntimeActorRuntimeState as w, type BrowserRuntimeProjectionBinding as x, type BrowserRuntimeServiceOptions as y, type DatabaseMigrationConstraintDefinition as z };
+export { RUNTIME_STATUS_AUTHORITY_SYNC_REQUESTED_SIGNAL as $, AUTHORITY_RUNTIME_STATUS_REPORT_INTENT as A, type BootstrapOptions as B, CadenzaService as C, type DatabaseSchemaDefinition as D, type BrowserRuntimeActorHandle as E, type BrowserRuntimeActorOptions as F, type BrowserRuntimeActorRuntimeState as G, type HydrationOptions as H, type BrowserRuntimeProjectionBinding as I, type JoinDefinition as J, type BrowserRuntimeServiceOptions as K, type DatabaseMigrationConstraintDefinition as L, type DatabaseMigrationDefinition as M, type DatabaseMigrationPolicy as N, type DatabaseMigrationStep as O, DatabaseTask as P, type DbOperationType$1 as Q, type DeputyDescriptor as R, type ServerOptions as S, DeputyTask as T, type DistributedInquiryMeta as U, type FieldDefinition as V, type InquiryResponderDescriptor as W, type InquiryResponderStatus as X, type NetworkMode as Y, type OpEffect as Z, type QueryMode as _, type DatabaseOptions as a, type ResolvedBootstrapEndpoint as a0, type RuntimeMetricsHealthDetail as a1, type SecurityProfile as a2, type ServiceInstanceDescriptor as a3, type ServiceTransportConfig as a4, type ServiceTransportDescriptor as a5, type ServiceTransportProtocol as a6, type ServiceTransportRole as a7, type ServiceTransportSecurityProfile as a8, SignalTransmissionTask as a9, type SortDirection as aa, type SubOperationType as ab, type TableDefinition as ac, type ValueOrSubOp as ad, buildAuthorityRuntimeStatusSignature as ae, normalizeAuthorityRuntimeStatusReport as af, type DbOperationPayload as b, type SubOperation as c, type DistributedInquiryOptions as d, type ServiceManifestSnapshot as e, type ServiceManifestPublicationLayer as f, type ServiceManifestTaskDefinition as g, type ServiceManifestSignalDefinition as h, type ServiceManifestIntentDefinition as i, type ServiceManifestActorDefinition as j, type ServiceManifestRoutineDefinition as k, type ServiceManifestHelperDefinition as l, type ServiceManifestGlobalDefinition as m, type ServiceManifestDirectionalTaskMap as n, type ServiceManifestSignalTaskMap as o, type ServiceManifestIntentTaskMap as p, type ServiceManifestActorTaskMap as q, type ServiceManifestTaskRoutineMap as r, type ServiceManifestTaskHelperMap as s, type ServiceManifestHelperHelperMap as t, type ServiceManifestTaskGlobalMap as u, type ServiceManifestHelperGlobalMap as v, ServiceRegistry as w, type AggregateDefinition as x, type AggregateFunction as y, type AuthorityRuntimeStatusReport as z };

package/dist/{Cadenza-Duj65Skt.d.ts → Cadenza-gGtFW_Y-.d.ts}

@@ -1,4 +1,4 @@
-import { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, Actor, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, CadenzaMode, EmitOptions, Intent, RuntimeValidationPolicy, RuntimeValidationScope, TaskOptions, ActorSpec, ActorFactoryOptions, ActorDefinition, TaskFunction, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
+import _cadenza_io_core__default, { Task, ThrottleTagGetter, Schema, GraphContext, AnyObject, InquiryOptions, TaskResult, GraphRoutine, SchemaDefinition, Actor, SignalBroker, InquiryBroker, GraphRunner, GraphRegistry, CadenzaMode, EmitOptions, Intent, RuntimeValidationPolicy, RuntimeValidationScope, TaskOptions, ActorSpec, ActorFactoryOptions, ActorDefinition, TaskFunction, HelperFunction, HelperDefinition, GlobalDefinition, DebounceOptions, DebounceTask, EphemeralTaskOptions, EphemeralTask } from '@cadenza.io/core';
 
 /**
  * Represents a task that delegates execution of a routine to a remote system or service.
@@ -38,6 +38,7 @@ declare class DeputyTask extends Task {
      * @return {void} This constructor does not return a value.
      */
     constructor(name: string, remoteRoutineName: string, serviceName?: string | undefined, description?: string, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema | undefined, validateInputContext?: boolean, outputSchema?: Schema | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    clone(): never;
     /**
      * Executes the specified task function within the provided execution context.
      *
@@ -142,6 +143,7 @@ declare class DatabaseTask extends DeputyTask {
      * @return {void}
      */
     constructor(name: string, taskName: string, serviceName: string | undefined, description: string | undefined, queryData: DbOperationPayload, concurrency?: number, timeout?: number, register?: boolean, isUnique?: boolean, isMeta?: boolean, isSubMeta?: boolean, isHidden?: boolean, getTagCallback?: ThrottleTagGetter | undefined, inputSchema?: Schema | undefined, validateInputContext?: boolean, outputSchema?: Schema | undefined, validateOutputContext?: boolean, retryCount?: number, retryDelay?: number, retryDelayMax?: number, retryDelayFactor?: number);
+    clone(): never;
     /**
      * Executes the specified task within the given context.
      *
@@ -235,6 +237,14 @@ interface ServiceInstanceDescriptor {
     serviceName: string;
     numberOfRunningGraphs?: number;
     isPrimary: boolean;
+    leaseStatus?: "active" | "non_responsive" | "inactive" | "deleted";
+    leaseExpiresAt?: string;
+    lastLeaseRenewedAt?: string;
+    isReady?: boolean;
+    readinessReason?: string | null;
+    lastReadyAt?: string | null;
+    lastObservedTransportAt?: string | null;
+    shutdownRequestedAt?: string | null;
     isActive: boolean;
     isNonResponsive: boolean;
     isBlocked: boolean;
@@ -331,6 +341,7 @@ declare class ServiceRegistry {
     private readonly runtimeStatusHeartbeatIntervalMs;
     private readonly runtimeMetricsSampleIntervalMs;
     private readonly runtimeStatusRestRefreshIntervalMs;
+    private readonly runtimeStatusLoopJitterRatio;
     private readonly runtimeStatusMissThreshold;
     private readonly runtimeStatusFallbackTimeoutMs;
     private readonly runtimeStatusAuthorityReportTimeoutMs;
@@ -343,6 +354,8 @@ declare class ServiceRegistry {
     private readonly routeFailurePenaltyMs;
     private readonly degradedGraphThreshold;
     private readonly overloadedGraphThreshold;
+    private readonly bootstrapFullSyncRetryJitterRatio;
+    private readonly serviceCommunicationRetryJitterRatio;
     serviceName: string | null;
     serviceInstanceId: string | null;
     numberOfRunningGraphs: number;
@@ -358,6 +371,10 @@ declare class ServiceRegistry {
     private knownGlobalSignalMaps;
     private authorityBootstrapRoute;
     private authorityBootstrapHandshakeInFlight;
+    private authorityBootstrapHandshakeRetryTimer;
+    private authorityBootstrapHandshakeRetryIndex;
+    private authorityBootstrapHandshakeRetryGeneration;
+    private authorityBootstrapHandshakeRetryReason;
     handleInstanceUpdateTask: Task;
     handleTransportUpdateTask: Task;
     handleGlobalSignalRegistrationTask: Task;
@@ -400,6 +417,13 @@ declare class ServiceRegistry {
     private getAuthorityBootstrapRestTarget;
     hasAuthorityBootstrapHandshakeEstablished(): boolean;
     private invalidateAuthorityBootstrapHandshake;
+    private clearAuthorityBootstrapHandshakeRetryTimer;
+    private invalidateAuthorityBootstrapHandshakeRetryState;
+    private markAuthorityBootstrapHandshakeSatisfied;
+    private buildJitteredAuthorityBootstrapHandshakeRetryDelayMs;
+    private scheduleAuthorityBootstrapHandshakeRetry;
+    private restartAuthorityBootstrapHandshakeRetryChain;
+    private restartAuthorityBootstrapRecovery;
     private requestAuthorityBootstrapHandshake;
     private invokeAuthorityBootstrapRoutine;
     private registerRemoteIntentDeputy;
@@ -410,6 +434,9 @@ declare class ServiceRegistry {
     ensureBootstrapAuthorityControlPlaneForInquiry(intentName: string, ctx?: AnyObject): boolean;
     private ensureBootstrapAuthorityControlPlane;
     private hasBootstrapFullSyncDeputies;
+    private buildDeterministicInstanceJitterKey;
+    private buildJitteredIntervalStartDate;
+    private buildJitteredBootstrapRetryDelayMs;
     private ensureAuthorityBootstrapSignalTransmissions;
     private clearBootstrapFullSyncRetryTimer;
     private invalidateBootstrapFullSyncRetryState;
@@ -466,6 +493,8 @@ declare class ServiceRegistry {
     private recordRoutingFailure;
     private clearRoutingCooldown;
     private hasRouteableInstanceForRouting;
+    private hasPendingRouteableInstanceForSelection;
+    private maybeSchedulePendingRouteSelectionRetry;
     private refreshRoutingCooldownsForService;
     private buildTransportFailureKey;
     private clearTransportFailureState;
@@ -968,6 +997,23 @@ type ServiceManifestRoutineDefinition = {
     service_name: string;
     is_meta: boolean;
 };
+type ServiceManifestHelperDefinition = {
+    name: string;
+    version: number;
+    description: string;
+    service_name: string;
+    is_meta: boolean;
+    handler_source: string;
+    language: "js" | "ts";
+};
+type ServiceManifestGlobalDefinition = {
+    name: string;
+    version: number;
+    description: string;
+    service_name: string;
+    is_meta: boolean;
+    value: unknown;
+};
 type ServiceManifestDirectionalTaskMap = {
     task_name: string;
     task_version: number;
@@ -1006,6 +1052,38 @@ type ServiceManifestTaskRoutineMap = {
     routine_version: number;
     service_name: string;
 };
+type ServiceManifestTaskHelperMap = {
+    task_name: string;
+    task_version: number;
+    service_name: string;
+    alias: string;
+    helper_name: string;
+    helper_version: number;
+};
+type ServiceManifestHelperHelperMap = {
+    helper_name: string;
+    helper_version: number;
+    service_name: string;
+    alias: string;
+    dependency_helper_name: string;
+    dependency_helper_version: number;
+};
+type ServiceManifestTaskGlobalMap = {
+    task_name: string;
+    task_version: number;
+    service_name: string;
+    alias: string;
+    global_name: string;
+    global_version: number;
+};
+type ServiceManifestHelperGlobalMap = {
+    helper_name: string;
+    helper_version: number;
+    service_name: string;
+    alias: string;
+    global_name: string;
+    global_version: number;
+};
 type ServiceManifestSnapshot = {
     serviceName: string;
     serviceInstanceId: string;
@@ -1018,11 +1096,17 @@ type ServiceManifestSnapshot = {
     intents: ServiceManifestIntentDefinition[];
     actors: ServiceManifestActorDefinition[];
     routines: ServiceManifestRoutineDefinition[];
+    helpers: ServiceManifestHelperDefinition[];
+    globals: ServiceManifestGlobalDefinition[];
     directionalTaskMaps: ServiceManifestDirectionalTaskMap[];
     signalToTaskMaps: ServiceManifestSignalTaskMap[];
     intentToTaskMaps: ServiceManifestIntentTaskMap[];
     actorTaskMaps: ServiceManifestActorTaskMap[];
     taskToRoutineMaps: ServiceManifestTaskRoutineMap[];
+    taskToHelperMaps: ServiceManifestTaskHelperMap[];
+    helperToHelperMaps: ServiceManifestHelperHelperMap[];
+    taskToGlobalMaps: ServiceManifestTaskGlobalMap[];
+    helperToGlobalMaps: ServiceManifestHelperGlobalMap[];
 };
 
 type SecurityProfile = "low" | "medium" | "high";
@@ -1070,6 +1154,7 @@ declare class CadenzaService {
     protected static isBootstrapped: boolean;
     protected static serviceCreated: boolean;
     protected static bootstrapSyncCompleted: boolean;
+    protected static bootstrapSyncCompletedAt: number;
     protected static bootstrapSignalRegistrationsCompleted: boolean;
     protected static bootstrapIntentRegistrationsCompleted: boolean;
     protected static defaultDatabaseServiceName: string | null;
@@ -1078,9 +1163,17 @@ declare class CadenzaService {
     protected static frontendSyncScheduled: boolean;
     protected static serviceManifestRevision: number;
     protected static lastPublishedServiceManifestHashes: Partial<Record<ServiceManifestPublicationLayer, string>>;
+    protected static serviceManifestPublishedAt: Partial<Record<ServiceManifestPublicationLayer, number>>;
     protected static serviceManifestPublicationInFlight: boolean;
     protected static serviceManifestPublicationPendingReason: string | null;
     protected static serviceManifestPublicationPendingLayer: ServiceManifestPublicationLayer | null;
+    protected static serviceManifestPublicationRetryReason: string | null;
+    protected static serviceManifestPublicationRetryLayer: ServiceManifestPublicationLayer | null;
+    protected static serviceManifestPublicationRetryTimer: ReturnType<typeof setTimeout> | null;
+    protected static serviceManifestPublicationRetryCount: number;
+    protected static localServiceManifestDefinitionInserted: boolean;
+    protected static localServiceManifestInstanceInserted: boolean;
+    protected static initialServiceManifestPublicationRequested: boolean;
     private static shutdownHandlersRegistered;
     private static shutdownInFlight;
     private static shutdownHandlerCleanup;
@@ -1090,11 +1183,27 @@ declare class CadenzaService {
     private static replayRegisteredTaskSignalObservations;
     private static replayRegisteredTaskGraphMetadata;
     private static normalizeServiceManifestPublicationLayer;
+    private static clampServiceManifestPublicationLayer;
     private static mergeServiceManifestPublicationRequest;
+    private static getServiceManifestPublicationGate;
     private static requestServiceManifestPublication;
     private static scheduleServiceManifestPublicationRetry;
+    private static shouldPublishBusinessManifestForTaskContext;
+    private static isRoutingCriticalManifestSignalName;
+    private static isRoutingCriticalManifestIntentName;
+    private static isRoutingCriticalManifestTask;
+    private static hasRoutingCriticalManifestBindingInContext;
+    private static shouldPublishBusinessManifestForHelperContext;
+    private static shouldPublishBusinessManifestForGlobalContext;
+    private static shouldPublishBusinessManifestForRoutineContext;
+    private static shouldRequestServiceManifestPublicationForSignal;
+    private static maybeRequestInitialServiceManifestPublication;
+    private static scheduleInitialServiceManifestPublicationFallback;
     private static publishServiceManifestIfNeeded;
     private static ensureServiceManifestPublicationTasks;
+    private static isLocalAuthorityService;
+    private static canPublishServiceManifestToAuthority;
+    private static shouldRequireAuthorityBootstrapHandshakeForManifestPublication;
     private static buildLegacyLocalCadenzaDBTaskName;
     private static buildGeneratedLocalCadenzaDBTaskName;
     /**
@@ -1521,6 +1630,12 @@ declare class CadenzaService {
      * ```
      */
     static createTask(name: string, func: TaskFunction, description?: string, options?: TaskOptions): Task;
+    static createHelper(name: string, func: HelperFunction, description?: string): HelperDefinition;
+    static createMetaHelper(name: string, func: HelperFunction, description?: string): HelperDefinition;
+    static createHelperFromDefinition(definition: Parameters<typeof _cadenza_io_core__default.createHelperFromDefinition>[0]): HelperDefinition;
+    static createGlobal(name: string, value: unknown, description?: string): GlobalDefinition;
+    static createMetaGlobal(name: string, value: unknown, description?: string): GlobalDefinition;
+    static createGlobalFromDefinition(definition: Parameters<typeof _cadenza_io_core__default.createGlobalFromDefinition>[0]): GlobalDefinition;
     /**
      * Creates a meta task with the specified name, functionality, description, and options.
      * This is used for creating tasks that lives on the meta layer.
@@ -1796,4 +1911,4 @@ declare class CadenzaService {
     static reset(): void;
 }
 
-export { type ServiceTransportDescriptor as $, AUTHORITY_RUNTIME_STATUS_REPORT_INTENT as A, type BootstrapOptions as B, CadenzaService as C, type DatabaseSchemaDefinition as D, type DatabaseMigrationDefinition as E, type DatabaseMigrationPolicy as F, type DatabaseMigrationStep as G, type HydrationOptions as H, DatabaseTask as I, type JoinDefinition as J, type DbOperationType$1 as K, type DeputyDescriptor as L, DeputyTask as M, type DistributedInquiryMeta as N, type FieldDefinition as O, type InquiryResponderDescriptor as P, type InquiryResponderStatus as Q, type NetworkMode as R, type ServerOptions as S, type OpEffect as T, type QueryMode as U, RUNTIME_STATUS_AUTHORITY_SYNC_REQUESTED_SIGNAL as V, type ResolvedBootstrapEndpoint as W, type RuntimeMetricsHealthDetail as X, type SecurityProfile as Y, type ServiceInstanceDescriptor as Z, type ServiceTransportConfig as _, type DatabaseOptions as a, type ServiceTransportProtocol as a0, type ServiceTransportRole as a1, type ServiceTransportSecurityProfile as a2, SignalTransmissionTask as a3, type SortDirection as a4, type SubOperationType as a5, type TableDefinition as a6, type ValueOrSubOp as a7, buildAuthorityRuntimeStatusSignature as a8, normalizeAuthorityRuntimeStatusReport as a9, type DbOperationPayload as b, type SubOperation as c, type DistributedInquiryOptions as d, type ServiceManifestSnapshot as e, type ServiceManifestPublicationLayer as f, type ServiceManifestTaskDefinition as g, type ServiceManifestSignalDefinition as h, type ServiceManifestIntentDefinition as i, type ServiceManifestActorDefinition as j, type ServiceManifestRoutineDefinition as k, type ServiceManifestDirectionalTaskMap as l, type ServiceManifestSignalTaskMap as m, type ServiceManifestIntentTaskMap as n, type ServiceManifestActorTaskMap as o, type ServiceManifestTaskRoutineMap as p, ServiceRegistry as q, type AggregateDefinition as r, type AggregateFunction as s, type AuthorityRuntimeStatusReport as t, type BrowserRuntimeActorHandle as u, type BrowserRuntimeActorOptions as v, type BrowserRuntimeActorRuntimeState as w, type BrowserRuntimeProjectionBinding as x, type BrowserRuntimeServiceOptions as y, type DatabaseMigrationConstraintDefinition as z };
+export { RUNTIME_STATUS_AUTHORITY_SYNC_REQUESTED_SIGNAL as $, AUTHORITY_RUNTIME_STATUS_REPORT_INTENT as A, type BootstrapOptions as B, CadenzaService as C, type DatabaseSchemaDefinition as D, type BrowserRuntimeActorHandle as E, type BrowserRuntimeActorOptions as F, type BrowserRuntimeActorRuntimeState as G, type HydrationOptions as H, type BrowserRuntimeProjectionBinding as I, type JoinDefinition as J, type BrowserRuntimeServiceOptions as K, type DatabaseMigrationConstraintDefinition as L, type DatabaseMigrationDefinition as M, type DatabaseMigrationPolicy as N, type DatabaseMigrationStep as O, DatabaseTask as P, type DbOperationType$1 as Q, type DeputyDescriptor as R, type ServerOptions as S, DeputyTask as T, type DistributedInquiryMeta as U, type FieldDefinition as V, type InquiryResponderDescriptor as W, type InquiryResponderStatus as X, type NetworkMode as Y, type OpEffect as Z, type QueryMode as _, type DatabaseOptions as a, type ResolvedBootstrapEndpoint as a0, type RuntimeMetricsHealthDetail as a1, type SecurityProfile as a2, type ServiceInstanceDescriptor as a3, type ServiceTransportConfig as a4, type ServiceTransportDescriptor as a5, type ServiceTransportProtocol as a6, type ServiceTransportRole as a7, type ServiceTransportSecurityProfile as a8, SignalTransmissionTask as a9, type SortDirection as aa, type SubOperationType as ab, type TableDefinition as ac, type ValueOrSubOp as ad, buildAuthorityRuntimeStatusSignature as ae, normalizeAuthorityRuntimeStatusReport as af, type DbOperationPayload as b, type SubOperation as c, type DistributedInquiryOptions as d, type ServiceManifestSnapshot as e, type ServiceManifestPublicationLayer as f, type ServiceManifestTaskDefinition as g, type ServiceManifestSignalDefinition as h, type ServiceManifestIntentDefinition as i, type ServiceManifestActorDefinition as j, type ServiceManifestRoutineDefinition as k, type ServiceManifestHelperDefinition as l, type ServiceManifestGlobalDefinition as m, type ServiceManifestDirectionalTaskMap as n, type ServiceManifestSignalTaskMap as o, type ServiceManifestIntentTaskMap as p, type ServiceManifestActorTaskMap as q, type ServiceManifestTaskRoutineMap as r, type ServiceManifestTaskHelperMap as s, type ServiceManifestHelperHelperMap as t, type ServiceManifestTaskGlobalMap as u, type ServiceManifestHelperGlobalMap as v, ServiceRegistry as w, type AggregateDefinition as x, type AggregateFunction as y, type AuthorityRuntimeStatusReport as z };