@makaio/framework 1.0.0-dev-1779051654000 → 1.0.0-dev-1781023871421

package/dist/bus/index.d.mts

@@ -3,7 +3,7 @@ import { ZodType, z } from "zod";
 import { Paths, Simplify, UnknownRecord } from "type-fest";
 import * as _$zod_v4_core0 from "zod/v4/core";
 
-//#region packages/makaio-core/src/types/message.d.ts
+//#region core/makaio-core/src/types/message.d.ts
 /**
  * Host-agnostic principal attached by a trusted local transport.
  *
@@ -49,6 +49,18 @@ interface TransportReceiveContext {
   /** Optional host-agnostic principal resolved for this connection. */
   readonly principal?: PrincipalContext;
 }
+/**
+ * Describes the call origin of a bus message.
+ *
+ * Set on every context before handlers run; never serialized to wire.
+ * Derivation: `local` is `true` when no transport received the message
+ * (the call originated in this process), `false` when it arrived over
+ * a transport from a remote peer.
+ */
+interface MessageOrigin {
+  /** Whether the message originated locally (not from a remote transport). */
+  readonly local: boolean;
+}
 /**
  * Base message context interface for both events and requests.
  *
@@ -100,6 +112,16 @@ interface BaseMessageContext {
    * context. Never trust similarly named fields in payloads or wire messages.
    */
   transport?: TransportReceiveContext;
+  /**
+   * Where this message originated.
+   *
+   * `local: true` — emitted in this process.
+   * `local: false` — arrived via a transport from a remote caller.
+   *
+   * Always present; never serialized to the wire. Location-sensitive handlers
+   * check this before executing local side-effects.
+   */
+  origin: MessageOrigin;
   isRequest: boolean;
 }
 type EventMessagePayload<Payload extends UnknownRecord = UnknownRecord> = Payload & {
@@ -112,7 +134,7 @@ type RequestMessagePayload<Request extends UnknownRecord = UnknownRecord, Respon
 };
 type MessagePayload = RequestMessagePayload | EventMessagePayload;
 //#endregion
-//#region packages/makaio-core/src/types/context.d.ts
+//#region core/makaio-core/src/types/context.d.ts
 /**
  * Context object passed to event handlers when using wildcard patterns.
  *
@@ -139,6 +161,7 @@ interface EventContext<Payload> extends BaseMessageContext {
  * - `next`: Function to call the next handler in the middleware chain
  * - `replacePayload`: Function to transform the payload for subsequent handlers
  * - `identify`: Optional function to identify the handler for broadcast aggregation
+ * - `signal`: Optional AbortSignal from the originating request
  * - Message tracking fields from BaseMessage (messageId, correlationId)
  */
 interface RequestContext<Payload, Response> extends BaseMessageContext {
@@ -146,6 +169,8 @@ interface RequestContext<Payload, Response> extends BaseMessageContext {
   isRequest: true;
   /** The request payload */
   payload: Payload;
+  /** AbortSignal supplied by the originating request, if any. */
+  signal?: AbortSignal;
   /** Set the response value (ends the handler chain) */
   setResult: (result: Response) => void;
   /**
@@ -201,7 +226,7 @@ interface RequestContext<Payload, Response> extends BaseMessageContext {
  */
 type WildcardContext<Payload = unknown, Response = unknown> = EventContext<Payload> | RequestContext<Payload, Response>;
 //#endregion
-//#region packages/makaio-core/src/types/filter.d.ts
+//#region core/makaio-core/src/types/filter.d.ts
 type Primitive = string | number | boolean | null;
 /**
  * Filter operators for payload field matching.
@@ -261,7 +286,7 @@ type PayloadFilter = Record<string, FilterOperator>;
  */
 type TypedPayloadFilter<T> = { [K in Paths<T> & string]?: FilterOperator };
 //#endregion
-//#region packages/makaio-core/src/types/schema.d.ts
+//#region core/makaio-core/src/types/schema.d.ts
 /**
  * Schema definition for event subjects (fire-and-forget).
  * Events have only a payload schema, no response.
@@ -294,6 +319,17 @@ type LocalSubjectSchema<T extends EventSchema | RequestSchema = EventSchema | Re
   readonly __local: true;
   readonly schema: T;
 };
+/**
+ * Wrapper to mark an event subject as collector-only.
+ *
+ * Collector-only events may be received from a transport and delivered to local
+ * handlers, but the receiving bus must not relay them onward to other
+ * transports. Local emits are also kept local.
+ */
+type CollectorOnlySubjectSchema<T extends EventSchema = EventSchema> = {
+  readonly __collectorOnly: true;
+  readonly schema: T;
+};
 /**
  * Wrapper to mark a subject as channel-only (encrypted point-to-point).
  *
@@ -317,31 +353,46 @@ type ChannelSubjectSchema<T extends EventSchema | RequestSchema = EventSchema |
   readonly __channel: true;
   readonly schema: T;
 };
+/**
+ * Wrapper to set a subject-level default transport routing policy.
+ *
+ * This is weaker than `localSubject()`: the subject remains routable remotely,
+ * but local callers that omit an explicit `transports` option use this default.
+ */
+type DefaultTransportsSubjectSchema<T extends EventSchema | RequestSchema = EventSchema | RequestSchema, Default extends TransportRoutingDefault = TransportRoutingDefault> = {
+  readonly __defaultTransports: Default;
+  readonly schema: T;
+};
 /**
  * Base schema types (unwrapped).
  */
 type BaseSubjectSchema = EventSchema | RequestSchema;
 /**
- * Union of all subject schema types (including local and channel wrappers).
+ * Union of all subject schema types (including metadata wrappers).
  */
-type SubjectSchema = BaseSubjectSchema | LocalSubjectSchema | ChannelSubjectSchema;
+type SubjectSchema = BaseSubjectSchema | LocalSubjectSchema | CollectorOnlySubjectSchema | ChannelSubjectSchema | DefaultTransportsSubjectSchema;
 type SchemaRecord = Record<string, SubjectSchema>;
 //#endregion
-//#region packages/makaio-core/src/types/type-helpers.d.ts
+//#region core/makaio-core/src/types/type-helpers.d.ts
 /**
- * Unwrap LocalSubjectSchema or ChannelSubjectSchema wrappers if present.
- * Returns the inner schema for wrapped subjects, or the schema as-is otherwise.
+ * Unwrap subject schema wrappers if present. Returns the inner schema for
+ * wrapped subjects, or the schema as-is otherwise.
  */
 type UnwrapSchema<S> = S extends {
   readonly __local: true;
   readonly schema: infer Inner;
+} ? Inner : S extends {
+  readonly __collectorOnly: true;
+  readonly schema: infer Inner;
 } ? Inner : S extends {
   readonly __channel: true;
   readonly schema: infer Inner;
+} ? Inner : S extends {
+  readonly __defaultTransports: TransportRoutingDefault;
+  readonly schema: infer Inner;
 } ? Inner : S;
 /**
- * Infer payload type from schema (handles EventSchema, RequestSchema,
- * LocalSubjectSchema, and ChannelSubjectSchema).
+ * Infer payload type from schema, including subject metadata wrappers.
  *
  * For requests:
  * - Uses z.input for request (what callers pass before validation/defaults)
@@ -350,8 +401,7 @@ type UnwrapSchema<S> = S extends {
  * This allows schemas with .default() to have optional fields in the caller API
  * while the response type reflects the validated output.
  *
- * LocalSubjectSchema and ChannelSubjectSchema wrappers are automatically
- * unwrapped before inference.
+ * Subject schema wrappers are automatically unwrapped before inference.
  *
  * Idempotent: Returns already-inferred types as-is.
  */
@@ -367,7 +417,7 @@ type InferSchemaPayloadInner<S> = S extends {
  * Compute all subject meta from the original schema in one place.
  *
  * Resolves payload, locality, channel membership, request/event discriminator,
- * and namespace from a raw SubjectSchema.
+ * default transport routing, and namespace from a raw SubjectSchema.
  * @typeParam S - The subject schema type
  * @typeParam Ns - The namespace string
  */
@@ -380,10 +430,23 @@ type InferSubjectMeta<S extends SubjectSchema, Ns extends string> = {
   channel: S extends ChannelSubjectSchema ? true : false; /** Inferred payload type (request/response pair or event payload). */
   payload: InferSchemaPayload<S>; /** The namespace this subject belongs to. */
   namespace: Ns;
-};
+} & (S extends DefaultTransportsSubjectSchema<EventSchema | RequestSchema, infer Default> ? {
+  defaultTransports: Default;
+} : {
+  defaultTransports?: TransportRoutingDefault;
+});
 //#endregion
-//#region packages/makaio-core/src/types/subjects.d.ts
+//#region core/makaio-core/src/types/subjects.d.ts
 type SubjectRecord<SubjectKeys extends string = string, Payload extends MessagePayload = MessagePayload> = Record<SubjectKeys, Payload>;
+/**
+ * Default transport routing semantics for a subject or namespace.
+ *
+ * - `'all'` — send to all registered transports (the default when omitted).
+ * - `'local-only'` — suppress outbound transport fan-out unless the caller
+ *   explicitly provides a `transports` override. Weaker than `localSubject()`:
+ *   the subject can still be invoked remotely.
+ */
+type TransportRoutingDefault = 'all' | 'local-only';
 type SubjectRecordFromSchemaRecord<SchemaRecord extends Record<string, SubjectSchema>> = { [K in keyof SchemaRecord & string]: Simplify<InferSchemaPayload<SchemaRecord[K]>> };
 type SubjectDefinitionMeta<Subject extends SubjectRecord = SubjectRecord<'default'>, K extends keyof Subject = keyof Subject, Namespace extends string = string> = {
   isRequest: Subject extends SubjectRecord<'default'> ? boolean : Subject[K] extends RequestMessagePayload ? true : false;
@@ -399,6 +462,17 @@ type SubjectDefinitionMeta<Subject extends SubjectRecord = SubjectRecord<'defaul
    * DirectChannel encrypted point-to-point transport.
    */
   channel: boolean;
+  /**
+   * Default transport routing for bus calls on this subject when the caller
+   * does not provide an explicit `transports` option.
+   *
+   * - `'all'` (default) — send to all registered transports as usual.
+   * - `'local-only'` — suppress transport fan-out unless the caller explicitly
+   *   provides a `transports` override. Weaker than `localSubject()`: the
+   *   subject can still be invoked remotely; only the outbound default is
+   *   suppressed.
+   */
+  defaultTransports?: TransportRoutingDefault;
 };
 type SubjectDefinition<Subject extends SubjectRecord = SubjectRecord, SubjectKey extends keyof Subject = keyof Subject, Namespace extends string = string> = {
   $meta: SubjectDefinitionMeta<Subject, SubjectKey, Namespace>;
@@ -454,11 +528,11 @@ type AllPropertiesOfUnion<T> = { [K in KeysOfUnion<T>]: ValueOfKey<T, K> };
  */
 type FilterablePayloadIntersection<Subjects extends SubjectRecord> = Simplify<AllPropertiesOfUnion<FilterablePayloadsUnion<Subjects>>>;
 //#endregion
-//#region packages/makaio-core/src/types/wildcards.d.ts
+//#region core/makaio-core/src/types/wildcards.d.ts
 type WildcardSubject = '*';
 type WildcardSubjectDefinition<Namespace extends string = string> = SubjectDefinition<Record<'*', MessagePayload>, WildcardSubject, Namespace>;
 //#endregion
-//#region packages/makaio-core/src/types/handler-types.d.ts
+//#region core/makaio-core/src/types/handler-types.d.ts
 type EventHandler<T> = (context: EventContext<T>) => void | Promise<void>;
 type RequestHandler<Payload, Response> = (context: RequestContext<Payload, Response>) => void | Promise<void>;
 /**
@@ -526,7 +600,7 @@ type HandlerForSubjectDefinition<T extends SubjectDefinition> = T['subject'] ext
  */
 type ContextForSubjectDefinition<T extends SubjectDefinition> = T['subject'] extends WildcardSubject ? WildcardContext<unknown, unknown> : T['$meta']['payload'] extends RequestMessagePayload<infer Request, infer Response> ? RequestContext<Request, Response> : T['$meta']['payload'] extends EventMessagePayload<infer Payload> ? EventContext<Payload> : never;
 //#endregion
-//#region packages/makaio-core/src/types/result.d.ts
+//#region core/makaio-core/src/types/result.d.ts
 /**
  * Result types for optional request handling.
  *
@@ -555,7 +629,7 @@ type OptionalResult<T> = {
   handled: false;
 };
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/nest-subject-definitions.d.ts
+//#region core/makaio-core/src/subject-helpers/nest-subject-definitions.d.ts
 /**
  * Recursively nests a flat record of dotted keys into a hierarchical object type.
  *
@@ -604,7 +678,7 @@ type BusSubjects<RecordOfSubjectDefinitions extends Record<string, unknown> = Re
  */
 declare function getFullSubjectForSubjectDefinition(subject: SubjectDefinition): string;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/is-request-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/is-request-schema.d.ts
 /**
  * Type guard to check if a schema is a request schema.
  * @param schema - The schema to check
@@ -612,7 +686,7 @@ declare function getFullSubjectForSubjectDefinition(subject: SubjectDefinition):
  */
 declare function isRequestSchema(schema: SubjectSchema): schema is RequestSchema;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/is-local-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/is-local-schema.d.ts
 /**
  * Create a local-only subject schema wrapper.
  *
@@ -639,7 +713,19 @@ declare function isRequestSchema(schema: SubjectSchema): schema is RequestSchema
  */
 declare function localSubject<T extends EventSchema | RequestSchema>(schema: T): LocalSubjectSchema<T>;
 //#endregion
-//#region packages/makaio-core/src/subject-helpers/is-channel-schema.d.ts
+//#region core/makaio-core/src/subject-helpers/is-collector-only-schema.d.ts
+/**
+ * Create a collector-only event schema wrapper.
+ *
+ * Collector-only events are transport-ingestable but not transport-relayable:
+ * a collector bus can receive them from an upstream peer and handle them
+ * locally without pushing them laterally to unrelated peers.
+ * @param schema - The event schema to mark as collector-only.
+ * @returns A CollectorOnlySubjectSchema wrapper.
+ */
+declare function collectorOnlySubject<T extends EventSchema>(schema: T): CollectorOnlySubjectSchema<T>;
+//#endregion
+//#region core/makaio-core/src/subject-helpers/is-channel-schema.d.ts
 /**
  * Create a channel-only subject schema wrapper.
  *
@@ -666,7 +752,28 @@ declare function localSubject<T extends EventSchema | RequestSchema>(schema: T):
  */
 declare function channelSubject<T extends EventSchema | RequestSchema>(schema: T): ChannelSubjectSchema<T>;
 //#endregion
-//#region packages/makaio-core/src/bus-namespace-definition.d.ts
+//#region core/makaio-core/src/subject-helpers/default-transports-schema.d.ts
+/**
+ * Create a subject schema wrapper with a subject-level default transport policy.
+ *
+ * Use this when one subject should override its namespace's default transport
+ * routing while still remaining remotely invokable when a caller explicitly
+ * targets a transport.
+ * @param schema - The event or request schema to wrap
+ * @param value - Default transport routing policy for this subject
+ * @returns A DefaultTransportsSubjectSchema wrapper
+ * @example
+ * ```typescript
+ * import { defaultTransports } from '@makaio/framework/core';
+ *
+ * const Schemas = {
+ *   internalEvent: defaultTransports(z.object({ id: z.string() }), 'local-only'),
+ * };
+ * ```
+ */
+declare function defaultTransports<T extends EventSchema | RequestSchema, Default extends TransportRoutingDefault>(schema: T, value: Default): DefaultTransportsSubjectSchema<T, Default>;
+//#endregion
+//#region core/makaio-core/src/bus-namespace-definition.d.ts
 /**
  * Report passed to the {@link NamespaceRegistrationOptions} `onSchemaViolation` callback
  * when lenient validation detects a schema mismatch.
@@ -723,6 +830,19 @@ interface BusNamespaceDefinition<Domain extends string = string, Schemas extends
   readonly schemas: Schemas;
   /** Registration options (validation mode, violation callback) */
   readonly options?: NamespaceRegistrationOptions;
+  /**
+   * Default transport routing for all subjects in this namespace when the
+   * caller does not provide an explicit `transports` option.
+   *
+   * Subject-level `defaultTransports` (set via `SubjectDefinitionMeta`) takes
+   * precedence over this namespace-level default when both are set.
+   *
+   * - `'all'` (default when omitted) — send to all registered transports.
+   * - `'local-only'` — suppress outbound transport fan-out by default. Callers
+   *   can still force transport delivery by passing an explicit `transports`
+   *   option. Weaker than `localSubject()`: subjects remain reachable remotely.
+   */
+  readonly defaultTransports?: TransportRoutingDefault;
   /**
    * Phantom field for type inference of filterable payload shape.
    *
@@ -747,7 +867,7 @@ type RegistrableBusNamespaceDefinition = Omit<BusNamespaceDefinition, 'subjects'
   /** Runtime subject token tree created by `createBusNamespace`. */readonly subjects: unknown;
 };
 //#endregion
-//#region packages/makaio-core/src/errors/index.d.ts
+//#region core/makaio-core/src/errors/index.d.ts
 /**
  * Base error class for all Makaio-related errors.
  */
@@ -756,7 +876,7 @@ declare class MakaioError extends Error {
   constructor(message: string, subject?: string | undefined);
 }
 //#endregion
-//#region packages/bus-core/src/extend-subject.d.ts
+//#region core/bus-core/src/extend-subject.d.ts
 /**
  * Additional fields to add to a request subject's request and/or response schemas.
  * Omit either key to leave that side unchanged.
@@ -846,7 +966,7 @@ declare function defineSubjectExtension<SD extends SubjectDefinition, Ext extend
  */
 declare function extendSubjectImpl<SD extends SubjectDefinition, Ext extends SubjectExtension<SD>>(context: MakaioBusContext, subject: SD, extensions: Ext): ExtendedSubjectDefinition<SD, Ext>;
 //#endregion
-//#region packages/bus-core/src/types/interceptor.d.ts
+//#region core/bus-core/src/types/interceptor.d.ts
 /**
  * Context provided to interceptor handlers.
  *
@@ -908,7 +1028,7 @@ interface InterceptorEntry<H> {
   priority: number;
 }
 //#endregion
-//#region packages/bus-core/src/methods/once.d.ts
+//#region core/bus-core/src/methods/once.d.ts
 /**
  * Options for the Promise-based once() method.
  */
@@ -942,7 +1062,7 @@ declare class OnceAbortError extends Error {
   constructor();
 }
 //#endregion
-//#region packages/bus-core/src/scoped-bus-base.d.ts
+//#region core/bus-core/src/scoped-bus-base.d.ts
 /**
  * Minimal shared surface common to {@link ScopedBus} and {@link IFilteredBus}.
  * @typeParam Namespace - The namespace domain string (e.g. `'adapter:codex-mcp'`)
@@ -1003,7 +1123,7 @@ interface IScopedBusBase<Namespace extends string> {
   requestOptional<Subject extends ScopedSubjectDefinition<Namespace>>(subject: Subject, payload: Subject['$meta']['payload']['request']): Promise<OptionalResult<Subject['$meta']['payload']['response']>>;
 }
 //#endregion
-//#region packages/bus-core/src/filtered-bus.d.ts
+//#region core/bus-core/src/filtered-bus.d.ts
 /**
  * Filtered bus that applies a base filter to all subscriptions.
  *
@@ -1046,7 +1166,7 @@ interface IFilteredBus<Namespace extends string = string, Subjects = unknown, Fi
  */
 declare function createFilteredBus<Namespace extends string, Subjects = unknown, FilterPayload = unknown>(context: MakaioBusContext, namespace: Namespace, baseFilter?: PayloadFilter): IFilteredBus<Namespace, Subjects, FilterPayload>;
 //#endregion
-//#region packages/bus-core/src/scoped-bus.d.ts
+//#region core/bus-core/src/scoped-bus.d.ts
 /**
  * Scoped bus with namespace isolation and type-safe filtering.
  * @typeParam Namespace - The namespace domain string (e.g., 'adapter:codex-mcp')
@@ -1083,7 +1203,7 @@ type ScopedBus<Namespace extends string, Subjects = SubjectRecord, FilterPayload
   getContext(): MakaioBusContext;
 };
 //#endregion
-//#region packages/bus-core/src/types/namespace.d.ts
+//#region core/bus-core/src/types/namespace.d.ts
 /**
  * A registered bus namespace with domain, subjects, and pre-computed filter payload type.
  * @typeParam Domain - The namespace domain string (e.g., 'adapter:codex-mcp')
@@ -1113,7 +1233,7 @@ type BusNamespace<Domain extends string = string, Subjects extends SubjectRecord
  */
 type ScopedBusFor<T> = T extends BusNamespace<infer D, infer S, infer F, infer _Sc> ? ScopedBus<D, S extends SubjectRecord ? S : SubjectRecord, F> : never;
 //#endregion
-//#region packages/bus-core/src/registries/namespace-registry.d.ts
+//#region core/bus-core/src/registries/namespace-registry.d.ts
 /**
  * Callback invoked when a schema violation is detected in lenient mode.
  * @param report - Violation details including subject, payload, and Zod issues
@@ -1150,6 +1270,8 @@ interface RegisteredSubjectSchema {
   schema: BaseSubjectSchema;
   /** Whether the subject was registered through `localSubject()`. */
   local: boolean;
+  /** Whether the subject was registered through `collectorOnlySubject()`. */
+  collectorOnly: boolean;
   /** Whether the subject was registered through `channelSubject()`. */
   channel: boolean;
 }
@@ -1198,6 +1320,12 @@ declare const createNamespaceRegistry: () => {
    * @returns Registered subjects sorted by fully-qualified subject key
    */
   listRegisteredSubjects(): RegisteredSubjectSchema[];
+  /**
+   * Get the full registration record for a subject.
+   * @param subject - Fully-qualified subject identifier (e.g., "adapter.getCapabilities")
+   * @returns Registration record if found, undefined otherwise
+   */
+  getRegisteredSubject(subject: string): RegisteredSubjectSchema | undefined;
   /**
    * Check if a subject is registered as a request subject.
    * @param subject - Subject identifier
@@ -1214,6 +1342,28 @@ declare const createNamespaceRegistry: () => {
    * @returns True if the subject was wrapped with `localSubject()`
    */
   isLocalSubject(subject: string): boolean;
+  /**
+   * Check if a subject is collector-only.
+   *
+   * Collector-only events may enter from a transport and run local handlers,
+   * but must not be relayed onward to other transports.
+   * @param subject - Full subject identifier (e.g., "subject-telemetry.fact")
+   * @returns True if the subject was wrapped with `collectorOnlySubject()`
+   */
+  isCollectorOnlySubject(subject: string): boolean;
+  /**
+   * Get the default transport visibility for a subject.
+   *
+   * Returns the namespace-level `defaultTransports` value recorded at
+   * registration time. Subject-level overrides in `SubjectDefinitionMeta`
+   * take precedence and are resolved by `emit()` directly from the subject
+   * definition token.
+   *
+   * Returns `'all'` when no namespace-level default was registered.
+   * @param subject - Fully-qualified subject identifier (e.g., `"session.list"`)
+   * @returns Effective namespace-level default transport visibility
+   */
+  getDefaultTransports(subject: string): "all" | "local-only";
   /**
    * Get the validation configuration for a subject.
    *
@@ -1246,7 +1396,7 @@ declare const createNamespaceRegistry: () => {
 };
 type NamespaceRegistry = ReturnType<typeof createNamespaceRegistry>;
 //#endregion
-//#region packages/bus-core/src/registries/transport-registry.d.ts
+//#region core/bus-core/src/registries/transport-registry.d.ts
 interface BusTransportRegistry extends Record<string, BusTransport> {}
 type BusTransportKeys = keyof BusTransportRegistry;
 /**
@@ -1302,7 +1452,7 @@ declare const createTransportRegistry: (context: MakaioBusContext) => {
 };
 type TransportRegistry = ReturnType<typeof createTransportRegistry>;
 //#endregion
-//#region packages/bus-core/src/types/transports.d.ts
+//#region core/bus-core/src/types/transports.d.ts
 /**
  * Subscribe message for client subscription management.
  *
@@ -1323,6 +1473,13 @@ type TransportRegistry = ReturnType<typeof createTransportRegistry>;
  */
 interface BusSubscribeMessage {
   type: 'subscribe';
+  /**
+   * Optional acknowledgement identifier.
+   * Transports that support dynamic subscription acknowledgements send a
+   * `subscription-ack` after applying the subscription update to their local
+   * routing state.
+   */
+  ackId?: string;
   /**
    * Subjects and their handler priorities.
    * Keys are subject patterns (can include wildcards like `'adapter.*'`).
@@ -1355,6 +1512,13 @@ interface BusSubscribeMessage {
  */
 interface BusUnsubscribeMessage {
   type: 'unsubscribe';
+  /**
+   * Optional acknowledgement identifier.
+   * Transports that support dynamic subscription acknowledgements send a
+   * `subscription-ack` after applying the unsubscription update to their local
+   * routing state.
+   */
+  ackId?: string;
   /**
    * Subjects and the handler priorities being removed.
    * Keys are subject patterns.
@@ -1374,10 +1538,21 @@ interface BusUnsubscribeMessage {
 interface BusSubscribeSyncCompleteMessage {
   type: 'subscribe-sync-complete';
 }
+/**
+ * Acknowledges a dynamic subscribe/unsubscribe control message.
+ *
+ * Complements the initial `subscribe-sync-complete` handshake: the handshake
+ * covers connection startup, while this message confirms one later
+ * subscription change has reached the remote routing state.
+ */
+interface BusSubscriptionAckMessage {
+  type: 'subscription-ack';
+  ackId: string;
+}
 /**
  * Message types for transport wire protocol.
  */
-type BusMessage = BusRequestMessage | BusResponseMessage | BusEventMessage | BusBroadcastMessage | BusBroadcastResponseMessage | BusHeartbeatMessage | BusSubscribeMessage | BusUnsubscribeMessage | BusSubscribeSyncCompleteMessage;
+type BusMessage = BusRequestMessage | BusResponseMessage | BusEventMessage | BusBroadcastMessage | BusBroadcastResponseMessage | BusHeartbeatMessage | BusSubscribeMessage | BusUnsubscribeMessage | BusSubscribeSyncCompleteMessage | BusSubscriptionAckMessage;
 /**
  * Handler invoked by transports when a bus message arrives.
  *
@@ -1752,7 +1927,7 @@ interface BusTransport {
   }>, error?: BusTransportError): void;
 }
 //#endregion
-//#region packages/bus-core/src/methods/broadcast.d.ts
+//#region core/bus-core/src/methods/broadcast.d.ts
 /**
  * Result from a single handler in a broadcast.
  * @typeParam T - Response payload type
@@ -1776,7 +1951,7 @@ interface BroadcastContext<Request, Response> extends RequestContext<Request, Re
   identify: (nodeId: string) => void;
 }
 //#endregion
-//#region packages/bus-core/src/types/options.d.ts
+//#region core/bus-core/src/types/options.d.ts
 /**
  * Default request timeout in milliseconds.
  *
@@ -1888,7 +2063,7 @@ interface RequestOptions extends EmitOptions {
   signal?: AbortSignal;
 }
 //#endregion
-//#region packages/bus-core/src/types/handler-entry.d.ts
+//#region core/bus-core/src/types/handler-entry.d.ts
 /**
  * Handler entry with priority for middleware-style ordering.
  * Higher priority values run earlier in the handler chain.
@@ -1898,7 +2073,29 @@ interface HandlerEntry<H> {
   priority: number;
 }
 //#endregion
-//#region packages/bus-core/src/types/bus.d.ts
+//#region core/bus-core/src/types/bus.d.ts
+/**
+ * Production-capable observation record for local bus API entrypoints.
+ *
+ * Unlike `AnyMessageContext`, this is not debug-only and is safe for runtime
+ * services that need to derive sanitized telemetry.
+ */
+interface ObservedBusMessage {
+  readonly type: 'event' | 'request' | 'broadcast';
+  readonly subject: string;
+  readonly namespace: string;
+  readonly payload: unknown;
+  readonly messageId: string;
+  readonly correlationId?: string;
+  readonly transport?: TransportReceiveContext;
+  /** True when the originating bus call was explicitly or inherently local-only. */
+  readonly localOnly?: boolean;
+}
+/**
+ * Observer callback invoked for each local bus API message after validation
+ * has succeeded. Observers must not mutate the payload.
+ */
+type BusMessageObserver = (message: ObservedBusMessage) => void | Promise<void>;
 /**
  * Internal bus context containing handler registries and shared state.
  *
@@ -1913,6 +2110,8 @@ interface MakaioBusContext {
   requestHandlers: Map<string, Array<HandlerEntry<RequestHandler<unknown, unknown>>>>;
   interceptorHandlers: Map<string, Array<InterceptorEntry<InterceptorHandler<unknown>>>>;
   anyHandlers: Set<AnyHandler>;
+  /** Production-capable message observers registered via {@link IMakaioBus.observeMessages}. */
+  messageObservers: Set<BusMessageObserver>;
   transportRegistry: TransportRegistry;
   namespaceRegistry: NamespaceRegistry;
   /** Remote handler priorities from subscribe messages; keyed by subject pattern. */
@@ -2275,6 +2474,22 @@ type IMakaioBus<NamespaceDomain extends string | unknown = unknown, Subjects ext
    * ```
    */
   withFilter: <Payload = unknown>(filter: [unknown] extends [Payload] ? PayloadFilter : TypedPayloadFilter<Payload>) => IFilteredBus<NamespaceDomain extends string ? NamespaceDomain : string>;
+  /**
+   * Register a production-capable local message observer.
+   *
+   * Observers receive local `emit`, `request`, and `broadcast` API calls after
+   * message validation has succeeded. Observers must not mutate the payload.
+   * Unlike `__onAny`, this is not debug-only and is safe for runtime telemetry services.
+   * @param observer - Observer callback.
+   * @returns Cleanup function that unregisters the observer.
+   * @example
+   * ```typescript
+   * const dispose = bus.observeMessages((message) => {
+   *   console.debug(`[${message.type}] ${message.namespace}.${message.subject}`);
+   * });
+   * ```
+   */
+  observeMessages(observer: BusMessageObserver): () => void;
   /**
    * Register a handler that receives ALL messages (events and requests) across all namespaces.
    *
@@ -2389,7 +2604,159 @@ type IMakaioBus<NamespaceDomain extends string | unknown = unknown, Subjects ext
   extendSubject<SD extends Subjects & StrictNamespace, Ext extends SubjectExtension<SD>>(subject: SD, extensions: Ext): ExtendedSubjectDefinition<SD, Ext>;
 };
 //#endregion
-//#region packages/bus-core/src/utils/transport.d.ts
+//#region core/bus-core/src/utils/correlation-tracker.d.ts
+/**
+ * Correlation tracker for request-response matching.
+ *
+ * Manages pending requests with timeout handling and automatic cleanup.
+ */
+/**
+ * Tracks correlation IDs for request-response matching.
+ *
+ * Provides automatic timeout handling and cleanup for pending requests.
+ * @example
+ * ```typescript
+ * const tracker = new CorrelationTracker();
+ *
+ * // Track a request with 5 second timeout
+ * const promise = tracker.track('correlation-123', 5000);
+ *
+ * // Later, resolve when response arrives
+ * tracker.resolve('correlation-123', { data: 'result' });
+ *
+ * // Or reject on error
+ * tracker.reject('correlation-123', new Error('Failed'));
+ * ```
+ */
+declare class CorrelationTracker {
+  private pending;
+  private static readonly DEFAULT_ABORT_MESSAGE;
+  /**
+   * Create a new correlation tracker.
+   */
+  constructor();
+  /**
+   * Track a pending request.
+   *
+   * Returns a promise that resolves when the response arrives or rejects on timeout.
+   * When `timeout` is `0`, no automatic timeout is set — the promise stays open
+   * until `resolve()` or `reject()` is called externally (e.g. by the caller's
+   * own `AbortSignal` or `pTimeout` wrapper).
+   * @param correlationId - Correlation ID for the request
+   * @param timeout - Timeout in milliseconds; `0` means no automatic timeout
+   * @param signal - Optional AbortSignal to cancel and cleanup the pending entry
+   * @returns Promise that resolves with the response result
+   */
+  track(correlationId: string, timeout: number, signal?: AbortSignal): Promise<unknown>;
+  /**
+   * Convert AbortSignal reasons into Error instances while preserving reason detail.
+   * @param signal - Abort signal associated with the pending request.
+   * @returns Normalized abort error preserving the original reason when available.
+   */
+  private getAbortError;
+  /**
+   * Resolve a pending request.
+   *
+   * Clears the timeout and removes the request from tracking.
+   * @param correlationId - Correlation ID for the request
+   * @param result - Response result
+   */
+  resolve(correlationId: string, result: unknown): void;
+  /**
+   * Reject a pending request.
+   *
+   * Clears the timeout and removes the request from tracking.
+   * @param correlationId - Correlation ID for the request
+   * @param error - Error to reject with
+   */
+  reject(correlationId: string, error: Error): void;
+  /**
+   * Cancel a pending request and remove its correlation entry.
+   * @param correlationId - Correlation ID for the request
+   * @param error - Optional cancellation error
+   */
+  cancel(correlationId: string, error?: Error): void;
+  /**
+   * Clean up all pending requests.
+   *
+   * Clears all timeouts and rejects all pending requests with a disconnection error.
+   */
+  cleanup(): void;
+}
+//#endregion
+//#region core/bus-core/src/utils/transport-helpers.d.ts
+/**
+ * Singleton frozen origin for messages emitted within the current process.
+ *
+ * Shared across `emit`, `broadcast`, and `dispatch` to avoid a per-message
+ * allocation on the hot path. Both variants are frozen to prevent accidental
+ * mutation since they are module-level constants.
+ */
+declare const LOCAL_ORIGIN: MessageOrigin;
+/**
+ * Singleton frozen origin for messages that arrived via a transport.
+ *
+ * Used by `emit`, `broadcast`, and `dispatch` when a `TransportReceiveContext`
+ * is present (i.e. the message was forwarded from a remote caller).
+ */
+declare const REMOTE_ORIGIN: MessageOrigin;
+/**
+ * Check if a client/tab wants to receive a message based on subscriptions and filters.
+ *
+ * **Filtering logic:**
+ * - No subscriptions = receive all (default broadcast mode)
+ * - With subscriptions: check if message subject matches any subscription pattern
+ * - Apply payload filters if the client has filters for this subject
+ * @param subject - The message subject (if any)
+ * @param payload - The message payload (if any)
+ * @param subscriptions - Set of subscription patterns
+ * @param filters - Map of payload filters per subject
+ * @returns true if the client should receive the message
+ */
+declare function shouldReceiveMessage(subject: string | undefined, payload: unknown, subscriptions: Set<string>, filters: Map<string, PayloadFilter>): boolean;
+/**
+ * Handle response messages for correlation tracking.
+ *
+ * Processes both regular response and broadcast-response messages,
+ * resolving or rejecting the corresponding correlation promise.
+ * @param message - Decoded bus message
+ * @param correlations - Correlation tracker instance
+ * @returns true if the message was a response and was handled
+ */
+declare function handleCorrelationResponse(message: BusMessage, correlations: CorrelationTracker): boolean;
+/**
+ * Track correlation for request/broadcast messages and return appropriate result type.
+ *
+ * **Behavior by message type:**
+ * - Request: Returns promise tracking correlation (resolves to response payload)
+ * - Broadcast: Returns promise tracking correlation (resolves to array of results)
+ * - Other: Returns true immediately (no correlation tracking needed)
+ *
+ * **Timeout semantics:**
+ * Pass `0` to disable automatic timeout — the correlation entry stays open
+ * until resolved or rejected externally. All callers must supply an explicit
+ * value; there is no default so callers cannot accidentally rely on a hidden timeout.
+ * @param message - Bus message to process
+ * @param correlations - Correlation tracker instance
+ * @param timeout - Timeout in milliseconds; `0` means no automatic timeout
+ * @param signal - Optional AbortSignal forwarded to correlation tracking cleanup
+ * @returns Promise resolving to response data, broadcast results, or boolean
+ */
+declare function trackMessageCorrelation<TMessage extends BusMessage>(message: TMessage, correlations: CorrelationTracker, timeout: number, signal?: AbortSignal): Promise<TMessage extends BusRequestMessage ? unknown : TMessage extends BusBroadcastMessage ? Array<{
+  nodeId: string;
+  payload: unknown;
+}> : boolean>;
+/**
+ * Serialize an error into a transport-safe structure.
+ *
+ * Preserves `subject` alongside `code` so that `isNoHandlerErrorForSubject`
+ * can match deserialized errors without fragile message-string comparisons.
+ * @param error - The error to serialize
+ * @returns Structured error payload
+ */
+declare function serializeTransportError(error: unknown): BusTransportError;
+//#endregion
+//#region core/bus-core/src/utils/transport.d.ts
 /**
  * Detects a "no handler" error for a specific request subject.
  *
@@ -2435,7 +2802,7 @@ declare function getSubjectFromBusMessage(message: BusMessage): string | null;
  */
 declare function deserializeTransportError(transportError: BusTransportError): Error;
 //#endregion
-//#region packages/bus-core/src/utils/payload-filter.d.ts
+//#region core/bus-core/src/utils/payload-filter.d.ts
 /**
  * Get a nested value from an object using dot-notation path.
  * @param obj - Object to traverse
@@ -2491,7 +2858,7 @@ declare function matchesFilter(payload: unknown, filter: PayloadFilter): boolean
  */
 declare function mergeFilters(base: PayloadFilter | undefined, override: PayloadFilter | undefined): PayloadFilter | undefined;
 //#endregion
-//#region packages/bus-core/src/utils/url-config.d.ts
+//#region core/bus-core/src/utils/url-config.d.ts
 /**
  * Bus URL configuration utilities.
  *
@@ -2550,7 +2917,7 @@ interface BusUrlConfig {
  */
 declare function parseBusUrl(envValue: string | undefined): BusUrlConfig;
 //#endregion
-//#region packages/bus-core/src/utils/subscription-matching.d.ts
+//#region core/bus-core/src/utils/subscription-matching.d.ts
 /**
  * Subscription pattern matching utilities.
  *
@@ -2650,7 +3017,7 @@ declare function matchesSubscription(subject: string, pattern: string): boolean;
  */
 declare function matchesAnySubscription(subject: string, patterns: Iterable<string>): boolean;
 //#endregion
-//#region packages/bus-core/src/errors/bus-error.d.ts
+//#region core/bus-core/src/errors/bus-error.d.ts
 /**
  * Base error class for all bus-related errors.
  */
@@ -2663,7 +3030,7 @@ declare class BusError extends MakaioError {
   constructor(message: string, subject?: string | undefined);
 }
 //#endregion
-//#region packages/bus-core/src/errors/channel-auth-error.d.ts
+//#region core/bus-core/src/errors/channel-auth-error.d.ts
 /**
  * Thrown when channel authentication fails during the handshake.
  * Indicates the provided token does not match the endpoint's expected token.
@@ -2675,7 +3042,7 @@ declare class ChannelAuthError extends BusError {
   constructor(endpoint: string);
 }
 //#endregion
-//#region packages/bus-core/src/errors/channel-closed-error.d.ts
+//#region core/bus-core/src/errors/channel-closed-error.d.ts
 /**
  * Thrown when an operation is attempted on a closed DirectChannel.
  * All pending requests are rejected with this error when a channel closes.
@@ -2687,7 +3054,7 @@ declare class ChannelClosedError extends BusError {
   constructor(channelId: string);
 }
 //#endregion
-//#region packages/bus-core/src/errors/channel-only-error.d.ts
+//#region core/bus-core/src/errors/channel-only-error.d.ts
 /**
  * Thrown when a channel-only subject is used directly on the public bus.
  * Channel subjects must be routed through a DirectChannel, not the public bus API.
@@ -2699,7 +3066,7 @@ declare class ChannelOnlyError extends BusError {
   constructor(subject: string);
 }
 //#endregion
-//#region packages/bus-core/src/errors/local-subject-error.d.ts
+//#region core/bus-core/src/errors/local-subject-error.d.ts
 /**
  * Thrown when a remote peer attempts to invoke a local-only subject over a
  * transport. Local subjects are never serializable and must not be routed
@@ -2712,7 +3079,7 @@ declare class LocalSubjectError extends BusError {
   constructor(subject: string);
 }
 //#endregion
-//#region packages/bus-core/src/errors/no-handler-error.d.ts
+//#region core/bus-core/src/errors/no-handler-error.d.ts
 /**
  * Stable error code for "no handler registered" failures.
  */
@@ -2728,7 +3095,7 @@ declare class NoHandlerError extends BusError {
   constructor(subject: string);
 }
 //#endregion
-//#region packages/bus-core/src/errors/request-error.d.ts
+//#region core/bus-core/src/errors/request-error.d.ts
 /**
  * Generic error thrown when a request fails for any other reason.
  */
@@ -2742,7 +3109,7 @@ declare class RequestError extends BusError {
   constructor(subject: string, message: string, cause?: Error | undefined);
 }
 //#endregion
-//#region packages/bus-core/src/errors/timeout-error.d.ts
+//#region core/bus-core/src/errors/timeout-error.d.ts
 /**
  * Error thrown when a request times out.
  */
@@ -2755,7 +3122,7 @@ declare class TimeoutError extends BusError {
   constructor(subject: string, timeoutMs: number);
 }
 //#endregion
-//#region packages/bus-core/src/errors/validation-error.d.ts
+//#region core/bus-core/src/errors/validation-error.d.ts
 /**
  * Error thrown when payload validation fails.
  */
@@ -2768,7 +3135,7 @@ declare class ValidationError extends BusError {
   constructor(subject: string, zodError: z.ZodError);
 }
 //#endregion
-//#region packages/bus-core/src/bus.d.ts
+//#region core/bus-core/src/bus.d.ts
 /**
  * Creates a new bus context containing handler registries and shared state.
  *
@@ -2857,7 +3224,18 @@ declare function createBusInstance<Namespace extends string | undefined = undefi
  */
 declare const MakaioBus: IMakaioBus;
 //#endregion
-//#region packages/bus-core/src/channel/types.d.ts
+//#region core/bus-core/src/methods/on.d.ts
+/**
+ * Wait until a handler registration has propagated to registered transports.
+ *
+ * `on()` still returns a plain cleanup function for public ergonomics, but
+ * remote transports subscribe asynchronously. Callers that publish readiness
+ * based on remote routability can await this helper before proceeding.
+ * @param cleanup - Cleanup function returned by {@link on}.
+ */
+declare function waitForSubscriptionPropagation(cleanup: (() => void) | null | undefined): Promise<void>;
+//#endregion
+//#region core/bus-core/src/channel/types.d.ts
 /**
  * Encrypted point-to-point communication channel over the bus.
  *
@@ -2939,7 +3317,7 @@ interface ChannelEndpoint {
   close(): void;
 }
 //#endregion
-//#region packages/bus-core/src/channel/system-namespace.d.ts
+//#region core/bus-core/src/channel/system-namespace.d.ts
 /**
  * Schema for the system.channel.open handshake request.
  *
@@ -2964,7 +3342,7 @@ declare const SystemChannelSchemas: {
   };
 };
 //#endregion
-//#region packages/bus-core/src/channel/channel-endpoint.d.ts
+//#region core/bus-core/src/channel/channel-endpoint.d.ts
 /**
  * Register a channel endpoint that accepts encrypted point-to-point connections.
  *
@@ -3016,87 +3394,7 @@ declare function openChannel(context: MakaioBusContext, endpointName: string, op
   transports?: ReadonlyArray<BusTransportKeys>;
 }): Promise<IDirectChannel>;
 //#endregion
-//#region packages/bus-core/src/utils/correlation-tracker.d.ts
-/**
- * Correlation tracker for request-response matching.
- *
- * Manages pending requests with timeout handling and automatic cleanup.
- */
-/**
- * Tracks correlation IDs for request-response matching.
- *
- * Provides automatic timeout handling and cleanup for pending requests.
- * @example
- * ```typescript
- * const tracker = new CorrelationTracker();
- *
- * // Track a request with 5 second timeout
- * const promise = tracker.track('correlation-123', 5000);
- *
- * // Later, resolve when response arrives
- * tracker.resolve('correlation-123', { data: 'result' });
- *
- * // Or reject on error
- * tracker.reject('correlation-123', new Error('Failed'));
- * ```
- */
-declare class CorrelationTracker {
-  private pending;
-  private static readonly DEFAULT_ABORT_MESSAGE;
-  /**
-   * Create a new correlation tracker.
-   */
-  constructor();
-  /**
-   * Track a pending request.
-   *
-   * Returns a promise that resolves when the response arrives or rejects on timeout.
-   * When `timeout` is `0`, no automatic timeout is set — the promise stays open
-   * until `resolve()` or `reject()` is called externally (e.g. by the caller's
-   * own `AbortSignal` or `pTimeout` wrapper).
-   * @param correlationId - Correlation ID for the request
-   * @param timeout - Timeout in milliseconds; `0` means no automatic timeout
-   * @param signal - Optional AbortSignal to cancel and cleanup the pending entry
-   * @returns Promise that resolves with the response result
-   */
-  track(correlationId: string, timeout: number, signal?: AbortSignal): Promise<unknown>;
-  /**
-   * Convert AbortSignal reasons into Error instances while preserving reason detail.
-   * @param signal - Abort signal associated with the pending request.
-   * @returns Normalized abort error preserving the original reason when available.
-   */
-  private getAbortError;
-  /**
-   * Resolve a pending request.
-   *
-   * Clears the timeout and removes the request from tracking.
-   * @param correlationId - Correlation ID for the request
-   * @param result - Response result
-   */
-  resolve(correlationId: string, result: unknown): void;
-  /**
-   * Reject a pending request.
-   *
-   * Clears the timeout and removes the request from tracking.
-   * @param correlationId - Correlation ID for the request
-   * @param error - Error to reject with
-   */
-  reject(correlationId: string, error: Error): void;
-  /**
-   * Cancel a pending request and remove its correlation entry.
-   * @param correlationId - Correlation ID for the request
-   * @param error - Optional cancellation error
-   */
-  cancel(correlationId: string, error?: Error): void;
-  /**
-   * Clean up all pending requests.
-   *
-   * Clears all timeouts and rejects all pending requests with a disconnection error.
-   */
-  cleanup(): void;
-}
-//#endregion
-//#region packages/bus-core/src/lifecycle-schemas.d.ts
+//#region core/bus-core/src/lifecycle-schemas.d.ts
 /** Payload emitted when a transport establishes or re-establishes a connection. */
 type ConnectedPayload = {
   transport: string;
@@ -3106,7 +3404,7 @@ type DisconnectedPayload = {
   transport: string;
 };
 //#endregion
-//#region packages/bus-core/src/lifecycle.d.ts
+//#region core/bus-core/src/lifecycle.d.ts
 /**
  * Bus-level lifecycle subjects for subscribing to transport connection state changes.
  *
@@ -3136,7 +3434,7 @@ declare const BusLifecycle: BusSubjects<FlatSubjectDefinitions<"bus:lifecycle",
   }, _$zod_v4_core0.$strip>>;
 }>, "bus:lifecycle">;
 //#endregion
-//#region packages/bus-core/src/extension-namespace-types.d.ts
+//#region core/bus-core/src/extension-namespace-types.d.ts
 /**
  * Extension point for extension namespace extensions.
  *
@@ -3204,64 +3502,7 @@ interface ExtensionNamespaceConfig<Schemas extends SchemaRecord, Ext extends Ext
  */
 type ExtensionNamespaceFromConfig<N extends string, Schemas extends SchemaRecord, Ext extends ExtensionNamespaceExtensions = ExtensionNamespaceExtensions> = ExtensionNamespace<N, SubjectRecordFromSchemaRecord<Schemas>, FilterablePayloadIntersection<SubjectRecordFromSchemaRecord<Schemas>>, Ext, Schemas>;
 //#endregion
-//#region packages/bus-core/src/utils/transport-helpers.d.ts
-/**
- * Check if a client/tab wants to receive a message based on subscriptions and filters.
- *
- * **Filtering logic:**
- * - No subscriptions = receive all (default broadcast mode)
- * - With subscriptions: check if message subject matches any subscription pattern
- * - Apply payload filters if the client has filters for this subject
- * @param subject - The message subject (if any)
- * @param payload - The message payload (if any)
- * @param subscriptions - Set of subscription patterns
- * @param filters - Map of payload filters per subject
- * @returns true if the client should receive the message
- */
-declare function shouldReceiveMessage(subject: string | undefined, payload: unknown, subscriptions: Set<string>, filters: Map<string, PayloadFilter>): boolean;
-/**
- * Handle response messages for correlation tracking.
- *
- * Processes both regular response and broadcast-response messages,
- * resolving or rejecting the corresponding correlation promise.
- * @param message - Decoded bus message
- * @param correlations - Correlation tracker instance
- * @returns true if the message was a response and was handled
- */
-declare function handleCorrelationResponse(message: BusMessage, correlations: CorrelationTracker): boolean;
-/**
- * Track correlation for request/broadcast messages and return appropriate result type.
- *
- * **Behavior by message type:**
- * - Request: Returns promise tracking correlation (resolves to response payload)
- * - Broadcast: Returns promise tracking correlation (resolves to array of results)
- * - Other: Returns true immediately (no correlation tracking needed)
- *
- * **Timeout semantics:**
- * Pass `0` to disable automatic timeout — the correlation entry stays open
- * until resolved or rejected externally. All callers must supply an explicit
- * value; there is no default so callers cannot accidentally rely on a hidden timeout.
- * @param message - Bus message to process
- * @param correlations - Correlation tracker instance
- * @param timeout - Timeout in milliseconds; `0` means no automatic timeout
- * @param signal - Optional AbortSignal forwarded to correlation tracking cleanup
- * @returns Promise resolving to response data, broadcast results, or boolean
- */
-declare function trackMessageCorrelation<TMessage extends BusMessage>(message: TMessage, correlations: CorrelationTracker, timeout: number, signal?: AbortSignal): Promise<TMessage extends BusRequestMessage ? unknown : TMessage extends BusBroadcastMessage ? Array<{
-  nodeId: string;
-  payload: unknown;
-}> : boolean>;
-/**
- * Serialize an error into a transport-safe structure.
- *
- * Preserves `subject` alongside `code` so that `isNoHandlerErrorForSubject`
- * can match deserialized errors without fragile message-string comparisons.
- * @param error - The error to serialize
- * @returns Structured error payload
- */
-declare function serializeTransportError(error: unknown): BusTransportError;
-//#endregion
-//#region packages/bus-core/src/subscribe-message.d.ts
+//#region core/bus-core/src/subscribe-message.d.ts
 /**
  * Per-subject subscription state tracked locally on a client transport.
  */
@@ -3274,17 +3515,19 @@ interface SubscriptionEntry {
 /**
  * Build a BusSubscribeMessage from local subscription state.
  * @param subscriptions - Map of subject patterns to their subscription entries
+ * @param ackId - Optional acknowledgement ID for dynamic subscription propagation
  * @returns Wire-format subscribe message
  */
-declare function buildSubscribeMessage(subscriptions: Map<string, SubscriptionEntry>): BusSubscribeMessage;
+declare function buildSubscribeMessage(subscriptions: Map<string, SubscriptionEntry>, ackId?: string): BusSubscribeMessage;
 /**
  * Build a BusUnsubscribeMessage for specific subjects and priorities.
  * @param subjects - Map of subject patterns to priorities being removed
+ * @param ackId - Optional acknowledgement ID for dynamic unsubscription propagation
  * @returns Wire-format unsubscribe message
  */
-declare function buildUnsubscribeMessage(subjects: Record<string, number[]>): BusUnsubscribeMessage;
+declare function buildUnsubscribeMessage(subjects: Record<string, number[]>, ackId?: string): BusUnsubscribeMessage;
 //#endregion
-//#region packages/bus-core/src/create-extension-namespace.d.ts
+//#region core/bus-core/src/create-extension-namespace.d.ts
 type Whitespace = ' ' | '\n' | '\r' | '\t' | '\v' | '\f' | '\u00A0' | '\u1680' | '\u2000' | '\u2001' | '\u2002' | '\u2003' | '\u2004' | '\u2005' | '\u2006' | '\u2007' | '\u2008' | '\u2009' | '\u200A' | '\u2028' | '\u2029' | '\u202F' | '\u205F' | '\u3000' | '\uFEFF';
 type TrimLeft<T extends string> = T extends `${Whitespace}${infer Rest}` ? TrimLeft<Rest> : T;
 type TrimRight<T extends string> = T extends `${infer Rest}${Whitespace}` ? TrimRight<Rest> : T;
@@ -3320,7 +3563,7 @@ type Trim<T extends string> = string extends T ? string : TrimLeft<TrimRight<T>>
  */
 declare function createExtensionNamespace<N extends string, Schemas extends SchemaRecord, Ext extends ExtensionNamespaceExtensions = ExtensionNamespaceExtensions>(extensionName: N, config: ExtensionNamespaceConfig<Schemas, Ext>): ExtensionNamespace<Trim<N>, SubjectRecordFromSchemaRecord<Schemas>, FilterablePayloadIntersection<SubjectRecordFromSchemaRecord<Schemas>>, Ext, Schemas>;
 //#endregion
-//#region packages/bus-core/src/utils/warn-unregistered.d.ts
+//#region core/bus-core/src/utils/warn-unregistered.d.ts
 /**
  * Reset the warned-subjects set between test runs.
  * @internal
@@ -3328,4 +3571,424 @@ declare function createExtensionNamespace<N extends string, Schemas extends Sche
  */
 declare const __resetWarnedSubjects: (() => void) | undefined;
 //#endregion
-export { type BroadcastContext, type BroadcastResult, type BusBroadcastMessage, type BusBroadcastResponseMessage, BusError, type BusEventMessage, type BusHeartbeatMessage, BusLifecycle, type BusMessage, type BusNamespace, type BusReceiveHandler, type BusRequestMessage, type BusResponseMessage, type BusSubscribeMessage, type BusSubscribeSyncCompleteMessage, type BusTransport, type BusTransportError, type BusTransportKeys, type BusTransportRegistry, type BusUnsubscribeMessage, type BusUrlConfig, type BusValidationMode, ChannelAuthError, ChannelClosedError, type ChannelEndpoint, type ChannelEndpointOptions, ChannelOnlyError, type ConnectOptions, type ConnectedPayload, CorrelationTracker, DEFAULT_REQUEST_TIMEOUT_MS, type DefinedSubjectExtension, type DisconnectedPayload, type EventSubjectExtension, type ExtendedSubjectDefinition, type ExtensionNamespace, type ExtensionNamespaceConfig, type ExtensionNamespaceExtensions, type ExtensionNamespaceFromConfig, type IDirectChannel, type IFilteredBus, type IMakaioBus, type InterceptorContext, LocalSubjectError, MakaioBus, type MakaioBusContext, NO_HANDLER_ERROR_CODE, type NamespaceRegistrationOptions, NoHandlerError, type OnOptions, OnceAbortError, type OptionalResult, RequestError, type RequestSubjectExtension, type SchemaViolationCallback, type SchemaViolationReport, type ScopedBus, type ScopedBusFor, type SubjectExtension, type SubscriptionEntry, SystemChannelSchemas, TimeoutError, type TransportRegistration, ValidationError, __resetWarnedSubjects, buildSubscribeMessage, buildUnsubscribeMessage, channelSubject, createBusContext, createBusInstance, createChannelEndpoint, createExtensionNamespace, createFilteredBus, defineSubjectExtension, deserializeTransportError, extendSubjectImpl as extendSubject, getFullSubjectForSubjectDefinition, getPath, getSubjectFromBusMessage, handleCorrelationResponse, isNoHandlerErrorForSubject, isRequestSchema, localSubject, matchesAnySubscription, matchesFilter, matchesSubscription, mergeFilters, openChannel, parseBusUrl, serializeTransportError, shouldReceiveMessage, trackMessageCorrelation };
+//#region core/contracts/src/canonical-model/selection.d.ts
+/**
+ * Agent selection for `kind: 'canonical-model'`.
+ *
+ * The `model` field carries the canonical model reference string verbatim.
+ * Resolution happens immediately at the `AgentResolutionSubjects.resolve`
+ * chokepoint, so this kind never persists into runtime spawn paths.
+ */
+declare const CanonicalModelSelectionSchema: z.ZodObject<{
+  providerConfigId: z.ZodOptional<z.ZodString>;
+  reasoningEffort: z.ZodOptional<z.ZodEnum<{
+    none: "none";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    "extra-high": "extra-high";
+  }>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    mode: z.ZodLiteral<"append">;
+    content: z.ZodString;
+  }, z.core.$strip>]>>;
+  allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  mcpSessionContext: z.ZodOptional<z.ZodObject<{
+    sessionId: z.ZodString;
+    servers: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          permission_policy: z.ZodEnum<{
+            always_allow: "always_allow";
+            always_ask: "always_ask";
+            always_deny: "always_deny";
+          }>;
+        }, z.core.$strip>>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"sse">;
+      }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          permission_policy: z.ZodEnum<{
+            always_allow: "always_allow";
+            always_ask: "always_ask";
+            always_deny: "always_deny";
+          }>;
+        }, z.core.$strip>>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"http">;
+      }, z.core.$strip>], "type">;
+      exposureMode: z.ZodEnum<{
+        direct: "direct";
+        discovery: "discovery";
+      }>;
+    }, z.core.$strip>>;
+    directTools: z.ZodArray<z.ZodObject<{
+      fullName: z.ZodString;
+      originalName: z.ZodString;
+      serverName: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      exposureMode: z.ZodEnum<{
+        direct: "direct";
+        discovery: "discovery";
+        hidden: "hidden";
+      }>;
+      enabled: z.ZodBoolean;
+      enabledBy: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        toolset: "toolset";
+      }>>;
+      enabledAt: z.ZodOptional<z.ZodNumber>;
+      exposed: z.ZodBoolean;
+    }, z.core.$strip>>;
+    discoverableTools: z.ZodArray<z.ZodObject<{
+      fullName: z.ZodString;
+      originalName: z.ZodString;
+      serverName: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      exposureMode: z.ZodEnum<{
+        direct: "direct";
+        discovery: "discovery";
+        hidden: "hidden";
+      }>;
+      enabled: z.ZodBoolean;
+      enabledBy: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        toolset: "toolset";
+      }>>;
+      enabledAt: z.ZodOptional<z.ZodNumber>;
+      exposed: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  kind: z.ZodLiteral<"canonical-model">;
+  model: z.ZodString;
+}, z.core.$loose>;
+type CanonicalModelSelection = z.infer<typeof CanonicalModelSelectionSchema>;
+declare module '@makaio/framework/contracts' {
+  interface AgentSelectionKindMap {
+    'canonical-model': CanonicalModelSelection;
+  }
+}
+//#endregion
+//#region core/contracts/src/skill/schemas.d.ts
+/** Trigger that activated or reinjected a skill. */
+declare const SkillActivationTriggerSchema: z.ZodEnum<{
+  user: "user";
+  auto: "auto";
+  model: "model";
+  reinjection: "reinjection";
+}>;
+/** Why a previously-active skill was removed from runtime state. */
+declare const SkillDeactivationReasonSchema: z.ZodEnum<{
+  user: "user";
+  cwd_changed: "cwd_changed";
+  session_end: "session_end";
+  replaced: "replaced";
+}>;
+type SkillActivationTrigger = z.infer<typeof SkillActivationTriggerSchema>;
+type SkillDeactivationReason = z.infer<typeof SkillDeactivationReasonSchema>;
+//#endregion
+//#region core/contracts/src/skill/types.d.ts
+declare module '@makaio/framework/contracts' {
+  interface SessionEventTypeMap {
+    /** Skill catalog built for a session agent. */
+    'skill.catalog.built': {
+      agentId: string;
+      cwd: string;
+      adapterId?: string;
+      skillNames: string[];
+    };
+    /** Skill activated for a session agent. */
+    'skill.activated': {
+      agentId: string;
+      skillName: string;
+      trigger: SkillActivationTrigger;
+      turnNumber?: number;
+    };
+    /** Skill deactivated for a session agent. */
+    'skill.deactivated': {
+      agentId: string;
+      skillName: string;
+      reason: SkillDeactivationReason;
+    };
+  }
+}
+//#endregion
+//#region core/contracts/src/telemetry/schemas.d.ts
+/**
+ * Scalar attribute value allowed in a telemetry fact.
+ *
+ * Restricted to primitives and homogeneous primitive arrays so that the
+ * telemetry sink can safely serialize without inspecting arbitrary objects.
+ */
+declare const SubjectTelemetryAttributeValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodNull>]>;
+/** Inferred TypeScript type for a sanitized attribute value. */
+type SubjectTelemetryAttributeValue = z.infer<typeof SubjectTelemetryAttributeValueSchema>;
+/**
+ * Sanitized bus subject telemetry fact schema.
+ *
+ * A fact captures the observable, non-sensitive metadata of a single bus
+ * message. All payload content is excluded; only correlation handles and
+ * namespace-approved scalar attributes are present.
+ */
+declare const SubjectTelemetryFactSchema: z.ZodObject<{
+  factId: z.ZodString;
+  observedAt: z.ZodNumber;
+  machineId: z.ZodOptional<z.ZodString>;
+  namespace: z.ZodString;
+  subject: z.ZodString;
+  messageType: z.ZodEnum<{
+    request: "request";
+    event: "event";
+    broadcast: "broadcast";
+  }>;
+  direction: z.ZodEnum<{
+    local: "local";
+    outbound: "outbound";
+    inbound: "inbound";
+  }>;
+  messageId: z.ZodString;
+  correlationId: z.ZodOptional<z.ZodString>;
+  attributes: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull, z.ZodArray<z.ZodString>, z.ZodArray<z.ZodNumber>, z.ZodArray<z.ZodBoolean>, z.ZodArray<z.ZodNull>]>>;
+}, z.core.$strict>;
+/** Inferred TypeScript type for a sanitized bus subject telemetry fact. */
+type SubjectTelemetryFact = z.infer<typeof SubjectTelemetryFactSchema>;
+//#endregion
+//#region core/bus-core/src/observability/projector-registry.d.ts
+/**
+ * Map of sanitized scalar attribute values approved for telemetry emission.
+ *
+ * Keys are attribute names; values are restricted to primitives and homogeneous
+ * primitive arrays so that telemetry sinks can safely serialize without
+ * inspecting arbitrary objects. `undefined` values are excluded during merge.
+ */
+type SubjectTelemetryAttributes = Record<string, SubjectTelemetryAttributeValue | undefined>;
+/**
+ * Input provided to a {@link SubjectTelemetryProjector} when projecting
+ * attributes from a bus message payload.
+ */
+interface SubjectTelemetryProjectorInput {
+  /** Raw bus message payload (read-only; must not be mutated). */
+  readonly payload: unknown;
+  /** Bus namespace that owns the observed subject. */
+  readonly namespace: string;
+  /** Subject key within the namespace. */
+  readonly subject: string;
+  /** Bus message type for the observed message. */
+  readonly messageType: 'event' | 'request' | 'broadcast';
+}
+/**
+ * Namespace-owned sidecar projector that extracts sanitized telemetry attributes
+ * from a bus message payload.
+ *
+ * The projector is responsible for ensuring that the returned attributes contain
+ * no sensitive data. Only scalar values ({@link SubjectTelemetryAttributeValue})
+ * should appear in the returned map.
+ */
+interface SubjectTelemetryProjector {
+  /** Namespace that owns this projector. */
+  readonly namespace: string;
+  /** Subject within the namespace that this projector handles. */
+  readonly subject: string;
+  /**
+   * Extract sanitized telemetry attributes from the message payload.
+   * @param input - Message context including payload, namespace, subject, and message type.
+   * @returns Map of attribute key to sanitized scalar value. `undefined` values are omitted.
+   */
+  project(input: SubjectTelemetryProjectorInput): SubjectTelemetryAttributes;
+}
+/**
+ * Registry of namespace-owned sidecar projectors, keyed by `namespace.subject`.
+ *
+ * Projectors may be registered by the namespace owner to provide sanitized
+ * telemetry attributes that cannot be inferred purely from schema observability
+ * metadata (e.g., when the payload contains nested structures that require
+ * domain-specific extraction logic).
+ */
+interface SubjectTelemetryProjectorRegistry {
+  /**
+   * Register a projector for a specific namespace and subject.
+   *
+   * If a projector is already registered for the same key, it is replaced.
+   * @param projector - Projector to register.
+   * @returns Cleanup function that unregisters this projector instance.
+   */
+  register(projector: SubjectTelemetryProjector): () => void;
+  /**
+   * Retrieve the registered projector for a namespace and subject, if any.
+   * @param namespace - Namespace that owns the subject.
+   * @param subject - Subject key within the namespace.
+   * @returns The registered projector, or `undefined` if none is registered.
+   */
+  get(namespace: string, subject: string): SubjectTelemetryProjector | undefined;
+}
+/**
+ * Create a new {@link SubjectTelemetryProjectorRegistry}.
+ *
+ * Maintains a map of projectors keyed by `namespace.subject`. At most one
+ * projector is stored per key; later registrations replace earlier ones.
+ * @returns A new projector registry instance.
+ */
+declare function createSubjectTelemetryProjectorRegistry(): SubjectTelemetryProjectorRegistry;
+//#endregion
+//#region core/bus-core/src/observability/subject-telemetry-projector.d.ts
+/**
+ * Union of the three projectable local bus message types.
+ *
+ * Only messages that enter the bus via the local API (`emit`, `request`,
+ * `broadcast`) are candidates for telemetry projection. Transport-relayed
+ * messages are excluded because their projection is the responsibility of
+ * the originating runtime.
+ */
+type ProjectableBusMessage = BusEventMessage | BusRequestMessage | BusBroadcastMessage;
+/**
+ * Input for {@link projectSubjectTelemetryFacts}.
+ *
+ * Carries all data needed to project a sanitized {@link SubjectTelemetryFact}
+ * from a single observed bus message.
+ */
+interface SubjectTelemetryProjectionInput {
+  /** The observed bus message to project. */
+  readonly message: ProjectableBusMessage;
+  /**
+   * Flow direction of the observed message at the source runtime.
+   * Typically `'local'` for messages that originate and are consumed within
+   * the same process.
+   */
+  readonly direction: 'local' | 'outbound' | 'inbound';
+  /** Wall-clock timestamp in Unix milliseconds at the time of observation. */
+  readonly observedAt: number;
+  /** Optional source machine identifier for multi-node telemetry correlation. */
+  readonly machineId?: string;
+  /**
+   * Namespace registry used to look up the schema for the observed subject.
+   * Obtain via `bus.getContext().namespaceRegistry`.
+   */
+  readonly namespaceRegistry: NamespaceRegistry;
+  /**
+   * Optional sidecar projector registry for namespace-owned attribute extraction.
+   *
+   * When a projector is registered for the message's namespace and subject it
+   * takes precedence over schema-driven projection.
+   */
+  readonly projectorRegistry?: SubjectTelemetryProjectorRegistry;
+}
+/**
+ * Project a single bus message into an array of sanitized
+ * {@link SubjectTelemetryFact} objects.
+ *
+ * Attributes are resolved in the following priority order:
+ * 1. **Sidecar projector**: a namespace-owned projector registered in
+ *    `projectorRegistry` for the message's namespace and subject.
+ * 2. **Schema-driven**: scalar fields projected via `traceAll` or explicit
+ *    `observability.attribute()` / `observability.hidden()` metadata on the
+ *    Zod schema stored in the namespace registry.
+ * 3. **Trace-only**: when neither approach yields attributes, an empty
+ *    `attributes` map is produced (the fact still carries correlation handles).
+ *
+ * The function always returns exactly one fact per call. The array shape
+ * is intentional — downstream aggregation layers may extend this to fan-out
+ * multiple facts from a single message (e.g., per-field count metrics).
+ * @param input - Projection input including the message, direction, timestamp,
+ *   namespace registry, and optional sidecar projector registry.
+ * @returns Array containing exactly one {@link SubjectTelemetryFact}.
+ */
+declare function projectSubjectTelemetryFacts(input: SubjectTelemetryProjectionInput): SubjectTelemetryFact[];
+//#endregion
+//#region core/bus-core/src/observability/projected-telemetry-transport.d.ts
+/**
+ * Configuration options for {@link createProjectedTelemetryTransport}.
+ */
+interface ProjectedTelemetryTransportOptions {
+  /**
+   * Unique name for this transport instance.
+   *
+   * Must be unique within a single bus instance (used as the registry key).
+   */
+  readonly name: string;
+  /**
+   * The underlying transport that receives projected telemetry fact events.
+   *
+   * All projected facts are forwarded to this transport as
+   * `subject-telemetry.fact` events. No raw application payloads are forwarded.
+   */
+  readonly inner: BusTransport;
+  /**
+   * Namespace registry used to resolve schemas for attribute projection.
+   *
+   * Obtain via `bus.getContext().namespaceRegistry`.
+   */
+  readonly namespaceRegistry: NamespaceRegistry;
+  /**
+   * Optional sidecar projector registry for namespace-owned attribute extraction.
+   *
+   * When provided, sidecar projectors registered for a message's namespace and
+   * subject take precedence over schema-driven attribute projection.
+   */
+  readonly projectorRegistry?: SubjectTelemetryProjectorRegistry;
+  /**
+   * Optional source machine identifier embedded in each projected fact.
+   *
+   * When omitted, the `machineId` field is absent from emitted facts.
+   */
+  readonly machineId?: string;
+  /**
+   * Optional clock override for deterministic testing.
+   *
+   * When provided, called instead of `Date.now()` to obtain the `observedAt`
+   * timestamp for each projected fact. Defaults to `Date.now`.
+   * @returns Current Unix timestamp in milliseconds.
+   */
+  readonly now?: () => number;
+}
+/**
+ * Create a one-way outbound transport that projects bus messages into sanitized
+ * {@link SubjectTelemetryFact} events and forwards only those facts upstream.
+ *
+ * ## Behavior
+ *
+ * **Outbound (send):**
+ * - Projectable messages (`event`, `request`, `broadcast`) are projected into
+ *   `subject-telemetry.fact` events via {@link projectSubjectTelemetryFacts}
+ *   and forwarded to `inner.send()`. The raw application payload is never
+ *   forwarded.
+ * - Non-projectable messages (`response`, `subscribe`, `heartbeat`, etc.) are
+ *   silently dropped. This transport is strictly outbound; control and response
+ *   messages must not be relayed to the upstream collector.
+ *
+ * **Inbound (onReceive):**
+ * - The transport registers a receive handler on `inner` but silently drops all
+ *   inbound messages. Control messages (`heartbeat`, `subscribe-ack`,
+ *   `subscribe-sync-complete`) are consumed silently. Application messages
+ *   arriving from upstream are dropped to prevent raw remote data from
+ *   propagating into the local bus.
+ *
+ * Connection and readiness operations delegate to `inner`. Subscription
+ * advertisement is deliberately not forwarded: this transport is telemetry-only
+ * and must not make the upstream collector believe it can route application
+ * subjects back to this runtime.
+ * @param options - Configuration including the inner transport, namespace
+ *   registry, optional machine ID, and optional clock override.
+ * @returns A {@link BusTransport} that emits only projected telemetry facts.
+ */
+declare function createProjectedTelemetryTransport(options: ProjectedTelemetryTransportOptions): BusTransport;
+//#endregion
+export { type BroadcastContext, type BroadcastResult, type BusBroadcastMessage, type BusBroadcastResponseMessage, BusError, type BusEventMessage, type BusHeartbeatMessage, BusLifecycle, type BusMessage, type BusMessageObserver, type BusNamespace, type BusReceiveHandler, type BusRequestMessage, type BusResponseMessage, type BusSubscribeMessage, type BusSubscribeSyncCompleteMessage, type BusSubscriptionAckMessage, type BusTransport, type BusTransportError, type BusTransportKeys, type BusTransportRegistry, type BusUnsubscribeMessage, type BusUrlConfig, type BusValidationMode, ChannelAuthError, ChannelClosedError, type ChannelEndpoint, type ChannelEndpointOptions, ChannelOnlyError, type ConnectOptions, type ConnectedPayload, CorrelationTracker, DEFAULT_REQUEST_TIMEOUT_MS, type DefinedSubjectExtension, type DisconnectedPayload, type EventSubjectExtension, type ExtendedSubjectDefinition, type ExtensionNamespace, type ExtensionNamespaceConfig, type ExtensionNamespaceExtensions, type ExtensionNamespaceFromConfig, type IDirectChannel, type IFilteredBus, type IMakaioBus, type InterceptorContext, LOCAL_ORIGIN, LocalSubjectError, MakaioBus, type MakaioBusContext, NO_HANDLER_ERROR_CODE, type NamespaceRegistrationOptions, NoHandlerError, type ObservedBusMessage, type OnOptions, OnceAbortError, type OptionalResult, type ProjectableBusMessage, type ProjectedTelemetryTransportOptions, REMOTE_ORIGIN, RequestError, type RequestSubjectExtension, type SchemaViolationCallback, type SchemaViolationReport, type ScopedBus, type ScopedBusFor, type SubjectExtension, type SubjectTelemetryAttributes, type SubjectTelemetryProjectionInput, type SubjectTelemetryProjector, type SubjectTelemetryProjectorInput, type SubjectTelemetryProjectorRegistry, type SubscriptionEntry, SystemChannelSchemas, TimeoutError, type TransportRegistration, ValidationError, __resetWarnedSubjects, buildSubscribeMessage, buildUnsubscribeMessage, channelSubject, collectorOnlySubject, createBusContext, createBusInstance, createChannelEndpoint, createExtensionNamespace, createFilteredBus, createProjectedTelemetryTransport, createSubjectTelemetryProjectorRegistry, defaultTransports, defineSubjectExtension, deserializeTransportError, extendSubjectImpl as extendSubject, getFullSubjectForSubjectDefinition, getPath, getSubjectFromBusMessage, handleCorrelationResponse, isNoHandlerErrorForSubject, isRequestSchema, localSubject, matchesAnySubscription, matchesFilter, matchesSubscription, mergeFilters, openChannel, parseBusUrl, projectSubjectTelemetryFacts, serializeTransportError, shouldReceiveMessage, trackMessageCorrelation, waitForSubscriptionPropagation };