@makaio/framework 1.0.0-dev-1784154668798 → 1.0.0-dev-1784706768858

package/dist/clients/index.d.mts

@@ -1,4 +1,4 @@
-import { a as StrategyDependencies, i as InstallStrategy, n as createStrategy, r as InstallArtifact, t as verifyInstalledVersion } from "../client-binary-version-verifier-WsNRplFB.mjs";
+import { a as StrategyDependencies, i as InstallStrategy, n as createStrategy, r as InstallArtifact, t as verifyInstalledVersion } from "../client-binary-version-verifier-C12PvQmz.mjs";
 import * as _$zod from "zod";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
@@ -12,7 +12,8 @@ import * as _$drizzle_orm_pg_core0 from "drizzle-orm/pg-core";
 import * as _$_makaio_storage_drizzle0 from "@makaio/framework/storage/drizzle";
 import { MakaioDatabase } from "@makaio/framework/storage/drizzle";
 import * as _$drizzle_orm0 from "drizzle-orm";
-import { ClientAccountIdentifier, ClientDefinition as ClientDefinition$1, ClientExecutionContext, ClientInstallCompleted, ClientInstallProgress, ClientRuntimeObserveRequest, ClientSessionObservedBase, ClientSubjects, ClientUsageSnapshot, ClientWiringEntry, ClientWiringEntrySchema, ManagedInstallDescriptor, ManagedInstallStrategy, PostInstallDescriptor } from "@makaio/framework/contracts/client";
+import { ActivationValidationError, CanonicalEffect, ClientAccountIdentifier, ClientDefinition as ClientDefinition$1, ClientExecutionContext, ClientInstallCompleted, ClientInstallProgress, ClientRuntimeObserveRequest, ClientSessionObservedBase, ClientSubjects, ClientUsageSnapshot, ClientWiringEntry, ClientWiringEntrySchema, ContributorDefinition, ManagedInstallDescriptor, ManagedInstallStrategy, PostInstallDescriptor, ProviderContractCatalogEntry, ProviderContributionEnvelope, RuntimeOutcomeCode } from "@makaio/framework/contracts/client";
+import { ContributionProcessor } from "@makaio/framework/kernel";
 import * as _$zod_v4_core0 from "zod/v4/core";
 
 //#region subsystems/client/src/atomic-modify-file.d.ts
@@ -1351,6 +1352,14 @@ declare const ClientHookHandleResponseSchema: z.ZodObject<{
   stderr: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 type ClientHookHandleResponse = z.infer<typeof ClientHookHandleResponseSchema>;
+/**
+ * Frozen no-op hook handle response shared across all client composers.
+ *
+ * exitCode 0 with empty stdout/stderr is the provider-valid passthrough
+ * that permits the tool invocation to proceed unchanged.  A single frozen
+ * instance avoids per-client duplication and per-call object allocation.
+ */
+declare const NOOP_HOOK_HANDLE_RESPONSE: ClientHookHandleResponse;
 type RawClientHookHandleSubjectRecord = SubjectRecord<'hook.handle', RequestMessagePayload<RawClientHookPayload, ClientHookHandleResponse>>;
 /**
  * Subject definition for the raw hook handle request/response subject in a
@@ -1365,11 +1374,16 @@ type RawClientHookHandleSubject = SubjectDefinition<RawClientHookHandleSubjectRe
  * Build a non-owning subject definition for `client:<id>.hook.handle`.
  *
  * The returned definition uses `isRequest: true` so the bus dispatches it
- * through the request/response pipeline.  Concrete client packages own their
- * full `client:<id>` namespace via {@link createClientNamespace}; this helper
- * is intentionally non-owning for the same reasons as
- * {@link createRawClientHookReceivedSubject} — see that function's doc for
- * the full rationale.
+ * through the request/response pipeline, and `hostLocalRequest: true` so the
+ * bus accepts direct remote ingress but never relays the request onward to
+ * other transports.  This matches the owning namespace registration in
+ * {@link createClientNamespace}, which wraps the schema with
+ * `hostLocalRequest()`.
+ *
+ * Concrete client packages own their full `client:<id>` namespace via
+ * {@link createClientNamespace}; this helper is intentionally non-owning for
+ * the same reasons as {@link createRawClientHookReceivedSubject} — see that
+ * function's doc for the full rationale.
  * @param rawClientId - Stable client identifier, optionally prefixed with `client:`
  * @returns Non-owning subject definition for the client's raw hook handle ingress
  */
@@ -1468,7 +1482,7 @@ declare function buildClientSubjects<AdditionalSchemas extends SchemaRecord>(cli
     payload: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
     metadata: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
   }, _$zod_v4_core0.$strip>;
-  'hook.handle': {
+  'hook.handle': _$_makaio_core0.HostLocalRequestSubjectSchema<{
     request: _$zod.ZodObject<{
       eventName: _$zod.ZodString;
       receivedAt: _$zod.ZodNumber;
@@ -1480,7 +1494,7 @@ declare function buildClientSubjects<AdditionalSchemas extends SchemaRecord>(cli
       stdout: _$zod.ZodDefault<_$zod.ZodString>;
       stderr: _$zod.ZodDefault<_$zod.ZodString>;
     }, _$zod_v4_core0.$strip>;
-  };
+  }>;
 } & AdditionalSchemas>, `client:${string}`>;
 /**
  * Create (or retrieve) the per-client bus namespace for `client:<clientId>`.
@@ -1654,6 +1668,214 @@ type ClientWiringListSubjectDef = SubjectDefinition<ClientWiringListSubjectRecor
  */
 declare function createClientWiringListSubjectDef(clientId: string): ClientWiringListSubjectDef;
 //#endregion
+//#region subsystems/client/src/client-hook-provider-contract-registry.d.ts
+/**
+ * Registry of provider contract catalog entries keyed by
+ * `(clientId, contractId)` with extension ownership.
+ *
+ * Rejects registration collisions when a different extension attempts to
+ * register a contract for the same `(clientId, contractId)` pair. Supports
+ * targeted unregistration by extension and cleanup of all contracts owned by
+ * a single extension (for shutdown/disable paths).
+ * @example
+ * ```ts
+ * const registry = new ClientHookProviderContractRegistry();
+ * registry.registerProviderContract('ext-anthropic', catalog);
+ * const entry = registry.getProviderContract('claude-code', 'anthropic.tool-response');
+ * ```
+ */
+declare class ClientHookProviderContractRegistry {
+  private readonly entries;
+  /**
+   * Register a provider contract catalog entry with extension ownership.
+   *
+   * The contract is keyed by `(catalog.clientId, catalog.contractId)`. If an
+   * entry already exists for the same key, the call throws. An extension must
+   * unregister before replacing its catalog so active contributors cannot be
+   * silently invalidated.
+   * @param extensionId - Extension that owns this contract registration.
+   * @param catalog - Provider contract catalog entry to register.
+   * @throws When a different extension already owns the same
+   *   `(clientId, contractId)` pair.
+   */
+  registerProviderContract(extensionId: string, catalog: ProviderContractCatalogEntry): void;
+  /**
+   * Remove a specific provider contract registration.
+   *
+   * Only the owning extension may remove its own contract. If the contract
+   * does not exist or belongs to a different extension, the call is a no-op.
+   * @param extensionId - Extension requesting removal.
+   * @param clientId - Client identifier of the contract to remove.
+   * @param contractId - Contract identifier to remove.
+   */
+  unregisterProviderContract(extensionId: string, clientId: string, contractId: string): void;
+  /**
+   * Remove all provider contracts owned by the given extension.
+   *
+   * Used during extension shutdown or disable to clean up all contracts
+   * registered by a single extension in one operation.
+   * @param extensionId - Extension whose contracts should be removed.
+   */
+  unregisterAllByExtension(extensionId: string): void;
+  /**
+   * Look up a provider contract catalog entry by client and contract
+   * identifiers.
+   * @param clientId - Client identifier (e.g. `'claude-code'`).
+   * @param contractId - Stable contract identifier.
+   * @returns The registered catalog entry, or `undefined` when no matching
+   *   contract is registered.
+   */
+  getProviderContract(clientId: string, contractId: string): ProviderContractCatalogEntry | undefined;
+  /**
+   * Return all provider contracts registered for a given client.
+   * @param clientId - Client identifier to filter by.
+   * @returns Array of catalog entries registered for the client.
+   */
+  getProviderContractsByClient(clientId: string): readonly ProviderContractCatalogEntry[];
+  /**
+   * Return every active provider contract.
+   *
+   * Used to validate portable canonical contributors, whose omitted client
+   * filter makes them eligible for every active client.
+   * @returns Active provider contract catalog entries.
+   */
+  getAllProviderContracts(): readonly ProviderContractCatalogEntry[];
+  /**
+   * Remove all registered provider contracts.
+   */
+  clear(): void;
+}
+//#endregion
+//#region subsystems/client/src/client-hook-response-registry.d.ts
+/**
+ * Registered contributor with runtime metadata assigned during installation.
+ *
+ * Extends the original {@link ContributorDefinition} with a namespaced
+ * identifier and a stable insertion ordinal used for deterministic ordering.
+ */
+interface RegisteredContributor$1 {
+  /**
+   * Globally unique contributor identifier, namespaced by extension.
+   *
+   * Formed as `${extensionId}/${definition.id}`.
+   */
+  readonly namespacedId: string;
+  /** Extension that owns this contributor. */
+  readonly extensionId: string;
+  /** Stable insertion ordinal assigned during atomic batch installation. */
+  readonly ordinal: number;
+  /** The original contributor definition. */
+  readonly definition: ContributorDefinition;
+}
+/**
+ * Result of an atomic contributor batch installation attempt.
+ *
+ * When validation succeeds, `errors` is empty and contributors are installed.
+ * When validation fails, `errors` is non-empty and no mutation occurs.
+ */
+interface ContributorInstallResult {
+  /** Validation errors encountered during activation. Empty on success. */
+  readonly errors: readonly ActivationValidationError[];
+}
+/**
+ * Registry of contributor definitions for client hook responses.
+ *
+ * Validates contributor batches against active provider contracts during
+ * activation, installs them atomically by extension, and provides immutable
+ * priority-ordered snapshots filtered by event name.
+ * @example
+ * ```ts
+ * const registry = new ClientHookResponseRegistry(contractRegistry);
+ *
+ * const result = registry.installContributors('ext-my-extension', [
+ *   {
+ *     lane: 'canonical',
+ *     id: 'append-context',
+ *     priority: 100,
+ *     timeoutMs: 5000,
+ *     selectors: [{ kind: 'event-name', name: 'PreToolUse' }],
+ *     respond: (ctx) => ({
+ *       canonicalEffects: [createAppendEffect('hello')],
+ *     }),
+ *   },
+ * ]);
+ *
+ * if (result.errors.length > 0) {
+ *   // Handle validation errors — no mutation occurred.
+ * }
+ *
+ * const snapshot = registry.snapshot('claude-code', 'anthropic.tool-response', 'PreToolUse');
+ * // snapshot is an immutable, priority-ordered array of RegisteredContributor.
+ * ```
+ */
+declare class ClientHookResponseRegistry {
+  private readonly contractRegistry;
+  /**
+   * All registered contributors, keyed by namespaced ID.
+   */
+  private readonly contributors;
+  /**
+   * Index from extension ID to the set of namespaced contributor IDs it
+   * owns. Used for atomic removal.
+   */
+  private readonly extensionIndex;
+  /**
+   * Monotonically increasing ordinal counter for stable insertion order.
+   */
+  private nextOrdinal;
+  /**
+   * Create a response registry backed by a provider contract registry.
+   * @param contractRegistry - Provider contract registry used during
+   *   activation validation.
+   */
+  constructor(contractRegistry: ClientHookProviderContractRegistry);
+  /**
+   * Validate and atomically install a batch of contributor definitions for
+   * a single extension.
+   *
+   * The entire batch is validated before any mutation occurs. If validation
+   * fails, no contributors are installed and the errors are returned. On
+   * success, each contributor is assigned a stable insertion ordinal and
+   * registered under the extension's ownership.
+   *
+   * An extension that already has contributors registered must call
+   * {@link removeContributors} before re-installing to avoid ID collisions.
+   * @param extensionId - Extension that owns these contributors.
+   * @param contributors - The batch of contributor definitions to install.
+   * @returns Installation result with any validation errors.
+   */
+  installContributors(extensionId: string, contributors: readonly ContributorDefinition[]): ContributorInstallResult;
+  /**
+   * Remove all contributors owned by the given extension.
+   *
+   * Only removes contributors registered under the specified extension ID.
+   * Contributors from other extensions are never affected.
+   * @param extensionId - Extension whose contributors should be removed.
+   */
+  removeContributors(extensionId: string): void;
+  /**
+   * Return an immutable snapshot of registered contributors matching a
+   * given event name and its declared response capabilities.
+   *
+   * The snapshot is a frozen copy ordered by priority descending, then by
+   * insertion ordinal ascending (stable insertion order within the same
+   * priority). Subsequent register/remove operations do not affect
+   * previously returned snapshots.
+   * @param clientId - Client receiving the hook event.
+   * @param contractId - Active provider contract handling the hook event.
+   * @param eventName - Hook event name to filter contributors by.
+   * @param eventCapabilities - The event's declared response capabilities.
+   *   Capability selectors match against this array. Defaults to an empty
+   *   array for backward compatibility.
+   * @returns Frozen array of matching registered contributors.
+   */
+  snapshot(clientId: string, contractId: string, eventName: string, eventCapabilities?: readonly string[]): ReadonlyArray<RegisteredContributor$1>;
+  /**
+   * Remove all registered contributors and reset the ordinal counter.
+   */
+  clear(): void;
+}
+//#endregion
 //#region subsystems/client/src/package.d.ts
 /**
  * Composite service that initialises and destroys the
@@ -1662,6 +1884,10 @@ declare function createClientWiringListSubjectDef(clientId: string): ClientWirin
  * {@link ClientSessionConfigService}
  * under a single {@link ExtensionServiceLifecycle} handle.
  *
+ * Also exposes the client hook response pipeline registries so other
+ * subsystems (provider runtimes, contribution processors) can register
+ * and unregister provider contracts and query contributor snapshots.
+ *
  * The host coordinator calls `init()` once and `destroy()` once; this class
  * ensures all five services participate in the same lifecycle without any
  * requiring knowledge of the others.
@@ -1672,14 +1898,20 @@ declare class ClientsCoreService implements ExtensionServiceLifecycle {
   private readonly configPrimeService;
   private readonly profileService;
   private readonly sessionConfigService;
+  /** Provider contract catalog registry for the hook response pipeline. */
+  readonly providerContractRegistry: ClientHookProviderContractRegistry;
+  /** Contributor definition registry for the hook response pipeline. */
+  readonly hookResponseRegistry: ClientHookResponseRegistry;
   /**
    * @param runtimeService - Handles `client.*` runtime observation subjects
    * @param binaryManager - Handles `client.*` binary-management subjects
    * @param configPrimeService - Handles generic `client.config.prime` delegation
    * @param profileService - Handles `client.profile.*` CRUD subjects
    * @param sessionConfigService - Handles `client.sessionConfig.*` isolation subjects
+   * @param providerContractRegistry - Provider contract catalog for activation-time validation
+   * @param hookResponseRegistry - Contributor definition registry for the hook response pipeline
    */
-  constructor(runtimeService: ClientRuntimeService, binaryManager: ClientBinaryManager, configPrimeService: ClientConfigPrimeService, profileService: ClientProfileService, sessionConfigService: ClientSessionConfigService);
+  constructor(runtimeService: ClientRuntimeService, binaryManager: ClientBinaryManager, configPrimeService: ClientConfigPrimeService, profileService: ClientProfileService, sessionConfigService: ClientSessionConfigService, providerContractRegistry: ClientHookProviderContractRegistry, hookResponseRegistry: ClientHookResponseRegistry);
   /**
    * Initialize all five sub-services in parallel.
    *
@@ -2742,12 +2974,150 @@ declare function buildHookCommand(makaioCommand: string, sentinel: string, event
  * Derive the ordered list of session-event wiring descriptors from a client
  * definition.
  *
- * Only hook events that carry a `frameworkSubject` are included — events
- * without one are client-internal and do not need framework wiring.
+ * Every declared hook event is returned — the `frameworkSubject` field controls
+ * only whether additional normalized observation happens, not whether a managed
+ * hook command is installed.  Events without a `frameworkSubject` still need
+ * hook wiring so they arrive through raw ingress for observer-only processing.
  * @param clientDefinition - The parsed static client definition whose
  *   `runtimeCapabilities.hookEvents` array is the source of truth.
  * @returns Read-only array of `{ eventName, mode }` descriptors in declaration order.
  */
 declare function deriveSessionEventDescriptors(clientDefinition: ClientDefinition$1): ReadonlyArray<SessionEventDescriptor>;
 //#endregion
-export { AbsolutePathSchema, type AtomicContentParser, type AtomicModifier, type AtomicModifyOutcome, BinaryNotFoundError, type BuildClientSessionBaseOpts, CLIENT_RUNTIME_STATUSES, ClientAccountRegistry, type ClientAccountUpsertResult, ClientBinaryJobRunner, ClientBinaryManager, type ClientBinaryManagerConfig, type ClientBinaryResolutionPolicy, type ClientBinaryStateRecord, ClientBinaryStateRecordSchema, ClientBinaryStorageNamespace, ClientBinaryStorageSubjects, type ClientBinaryVersionRecord, ClientBinaryVersionRecordSchema, ClientBinaryVersionResolver, ClientConfigPrimeService, type ClientDefinitionLookup, ClientDefinitionRegistry, type ClientHookHandleResponse, ClientHookHandleResponseSchema, type ClientNamespaceResult, type ClientProfileRecord, ClientProfileRecordSchema, ClientProfileService, ClientProfileStorageNamespace, ClientProfileStorageSubjects, type ClientRuntimeRecord, ClientRuntimeRegistry, ClientRuntimeService, type ClientRuntimeStatus, ClientRuntimeStorageNamespace, ClientRuntimeStorageSubjects, ClientSessionConfigService, ClientSubjects, type ClientWiringAggregatedResult, ClientWiringAggregatedResultSchema, type ClientWiringApplyResponse, ClientWiringApplyResponseSchema, type ClientWiringEntry, ClientWiringEntrySchema, type ClientWiringListResponse, ClientWiringListResponseSchema, type ClientWiringListSubjectDef, type ClientWiringRemoveResponse, ClientWiringRemoveResponseSchema, type ClientWiringSubjectDefBase, type ClientsCorePackageOptions, ClientsCoreService, ClientsCoreToken, DEFAULT_HOOK_HANDLE_TIMEOUT_MS, type InstallArtifact, type InstallJob, type InstallStrategy, type JobCompletedCallback, type JobCompletionCallback, type JobCompletionResult, type JobProgressCallback, type PostInstallContext, type PostInstallHandler, type RawClientHookHandleSubject, type RawClientHookPayload, RawClientHookPayloadSchema, type RawClientHookReceivedSubject, type ResolvedInstallVersion, RuntimeRecordSchema, type RuntimeUpsertResult, type SessionEventDescriptor, type StrategyDependencies, assertAbsoluteProjectDir, atomicModifyFile, buildClientCommand, buildClientSessionBase, buildHookCommand, canonicalizeClientId, clientRuntimesDual, createClientNamespace, createClientWiringListSubjectDef, createClientWiringSubjectDef, createClientsCorePackage, createRawClientHookHandleSubject, createRawClientHookReceivedSubject, createStrategy, deriveSessionEventDescriptors, emitBestEffort, isPathWithinBase, pickNonEmptyString, pickNonEmptyStringValue, registerDrizzleClientBinaryStorage, registerDrizzleProfileStorage, registerDrizzleRuntimeStorage, registerStorageHandlersWithRollback, resolveAndValidateBasePath, resolveClientBinary, verifyInstalledVersion };
+//#region subsystems/client/src/client-hook-response-contribution-processor.d.ts
+/**
+ * Create a {@link ContributionProcessor} that wires
+ * {@link ExtensionClientHookResponsesContribution} into the
+ * {@link ClientHookResponseRegistry} during extension lifecycle events.
+ *
+ * The returned processor:
+ * - **Filters** to extensions that declare `clientHookResponses`.
+ * - **Activation:** calls `createContributors(ctx)`, validates the batch
+ *   against the provider contract registry, and installs atomically. On
+ *   validation failure, throws a descriptive error so the coordinator
+ *   transitions the extension to `failed`.
+ * - **Deactivation (stopped):** removes the extension's contributors from
+ *   the registry. Errors propagate to the coordinator.
+ * - **Shutdown:** call `processStopped` per extension; the coordinator
+ *   handles this via reverse-order teardown.
+ *
+ * The processor performs its own rollback before throwing: if
+ * `createContributors` succeeds but `installContributors` fails, no
+ * partial state leaks into the registry.
+ * @param responseRegistry - Registry that stores contributor definitions.
+ * @param contractRegistry - Provider contract registry for activation-time
+ *   validation and activation context lookups.
+ * @returns A `ContributionProcessor` ready for registration with the
+ *   extension coordinator.
+ */
+declare function createClientHookResponseContributionProcessor(responseRegistry: ClientHookResponseRegistry, contractRegistry: ClientHookProviderContractRegistry): ContributionProcessor;
+//#endregion
+//#region subsystems/client/src/client-hook-response-collector.d.ts
+/**
+ * Severity level for a collection diagnostic.
+ */
+type DiagnosticSeverity = 'warning' | 'error';
+/**
+ * Diagnostic recorded during contribution collection.
+ *
+ * Captures per-contributor failure details (timeouts, rejections,
+ * validation failures) without blocking the collection pipeline.
+ */
+interface CollectionDiagnostic {
+  /** Contributor that produced this diagnostic. */
+  readonly contributorId: string;
+  /** Severity level. */
+  readonly severity: DiagnosticSeverity;
+  /** Human-readable diagnostic message. */
+  readonly message: string;
+  /** Root cause error, when available. */
+  readonly cause?: unknown;
+}
+/**
+ * Outcome record for a single contributor within a collection run.
+ */
+interface ContributorOutcome {
+  /** Contributor that produced this outcome. */
+  readonly contributorId: string;
+  /** Runtime outcome code. */
+  readonly outcome: RuntimeOutcomeCode;
+  /** Duration of the callback execution in milliseconds. */
+  readonly durationMs: number;
+  /**
+   * Effects produced by the contributor, present only on `'success'`
+   * outcomes.
+   */
+  readonly effects?: ReadonlyArray<CanonicalEffect | ProviderContributionEnvelope>;
+}
+/**
+ * Result returned when the first `closed` failure (by snapshot order) is
+ * detected.
+ */
+interface ClosedFailureResult {
+  /** Contributor ID of the first closed-failure contributor. */
+  readonly contributorId: string;
+  /** Human-readable detail. */
+  readonly detail: string;
+}
+/**
+ * Aggregate result of a contribution collection run.
+ */
+interface CollectionResult {
+  /** Per-contributor outcomes in snapshot order. */
+  readonly outcomes: ReadonlyArray<ContributorOutcome>;
+  /** Diagnostics recorded during collection. */
+  readonly diagnostics: ReadonlyArray<CollectionDiagnostic>;
+  /**
+   * Present when at least one `closed`-policy contributor failed; contains
+   * the deterministic first closed failure (by snapshot order).
+   */
+  readonly closedFailure?: ClosedFailureResult;
+}
+/**
+ * Minimal registered contributor shape consumed by the collector.
+ *
+ * This is intentionally decoupled from the registry implementation so the
+ * collector can be developed and tested independently.
+ */
+interface RegisteredContributor {
+  /** The contributor definition as declared by the extension. */
+  readonly definition: ContributorDefinition;
+  /**
+   * Globally unique contributor identifier, namespaced by extension.
+   *
+   * When present, used in outcome and diagnostic records instead of
+   * the local `definition.id`. Optional for backward compatibility
+   * with tests that construct minimal registered contributors.
+   */
+  readonly namespacedId?: string;
+}
+/**
+ * Collect contributions from a snapshot of registered contributors
+ * concurrently and deterministically.
+ *
+ * Every eligible callback is started before any result is awaited
+ * (Promise.all-style concurrency). Each callback receives a per-contributor
+ * abort signal derived from the minimum of the request deadline and the
+ * callback's own timeout. Late results are ignored even when the callback
+ * code ignores cancellation.
+ *
+ * Failure handling follows the contributor's declared failure policy:
+ * - **open** — the contributor's result is omitted but siblings are
+ *   retained.
+ * - **closed** — all partial effects are discarded and the deterministic
+ *   first closed failure (by snapshot order) is returned.
+ * @param snapshot - Ordered array of registered contributors (priority-
+ *   then-ordinal). The collector does not re-sort.
+ * @param clientId - Client receiving the hook event.
+ * @param requestDeadline - Absolute epoch-ms deadline for the overall
+ *   request, or `undefined` for no request-level deadline.
+ * @param requestSignal - The originating request's abort signal, or
+ *   `undefined` when not available. Composed with per-contributor signals.
+ * @param eventName - The hook event name that triggered collection.
+ * @param eventPayload - The hook event payload, opaque at this layer.
+ * @param providerContract - Exact active provider contract for this request.
+ * @returns A promise resolving to the {@link CollectionResult}.
+ */
+declare function collectContributions(snapshot: ReadonlyArray<RegisteredContributor>, clientId: string, requestDeadline: number | undefined, requestSignal: AbortSignal | undefined, eventName: string, eventPayload: unknown, providerContract?: ProviderContractCatalogEntry): Promise<CollectionResult>;
+//#endregion
+export { AbsolutePathSchema, type AtomicContentParser, type AtomicModifier, type AtomicModifyOutcome, BinaryNotFoundError, type BuildClientSessionBaseOpts, CLIENT_RUNTIME_STATUSES, ClientAccountRegistry, type ClientAccountUpsertResult, ClientBinaryJobRunner, ClientBinaryManager, type ClientBinaryManagerConfig, type ClientBinaryResolutionPolicy, type ClientBinaryStateRecord, ClientBinaryStateRecordSchema, ClientBinaryStorageNamespace, ClientBinaryStorageSubjects, type ClientBinaryVersionRecord, ClientBinaryVersionRecordSchema, ClientBinaryVersionResolver, ClientConfigPrimeService, type ClientDefinitionLookup, ClientDefinitionRegistry, type ClientHookHandleResponse, ClientHookHandleResponseSchema, ClientHookProviderContractRegistry, ClientHookResponseRegistry, type ClientNamespaceResult, type ClientProfileRecord, ClientProfileRecordSchema, ClientProfileService, ClientProfileStorageNamespace, ClientProfileStorageSubjects, type ClientRuntimeRecord, ClientRuntimeRegistry, ClientRuntimeService, type ClientRuntimeStatus, ClientRuntimeStorageNamespace, ClientRuntimeStorageSubjects, ClientSessionConfigService, ClientSubjects, type ClientWiringAggregatedResult, ClientWiringAggregatedResultSchema, type ClientWiringApplyResponse, ClientWiringApplyResponseSchema, type ClientWiringEntry, ClientWiringEntrySchema, type ClientWiringListResponse, ClientWiringListResponseSchema, type ClientWiringListSubjectDef, type ClientWiringRemoveResponse, ClientWiringRemoveResponseSchema, type ClientWiringSubjectDefBase, type ClientsCorePackageOptions, ClientsCoreService, ClientsCoreToken, type ClosedFailureResult, type CollectionDiagnostic, type CollectionResult, type ContributorInstallResult, type ContributorOutcome, DEFAULT_HOOK_HANDLE_TIMEOUT_MS, type DiagnosticSeverity, type InstallArtifact, type InstallJob, type InstallStrategy, type JobCompletedCallback, type JobCompletionCallback, type JobCompletionResult, type JobProgressCallback, NOOP_HOOK_HANDLE_RESPONSE, type PostInstallContext, type PostInstallHandler, type RawClientHookHandleSubject, type RawClientHookPayload, RawClientHookPayloadSchema, type RawClientHookReceivedSubject, type RegisteredContributor, type RegisteredContributor$1 as RegistryContributor, type ResolvedInstallVersion, RuntimeRecordSchema, type RuntimeUpsertResult, type SessionEventDescriptor, type StrategyDependencies, assertAbsoluteProjectDir, atomicModifyFile, buildClientCommand, buildClientSessionBase, buildHookCommand, canonicalizeClientId, clientRuntimesDual, collectContributions, createClientHookResponseContributionProcessor, createClientNamespace, createClientWiringListSubjectDef, createClientWiringSubjectDef, createClientsCorePackage, createRawClientHookHandleSubject, createRawClientHookReceivedSubject, createStrategy, deriveSessionEventDescriptors, emitBestEffort, isPathWithinBase, pickNonEmptyString, pickNonEmptyStringValue, registerDrizzleClientBinaryStorage, registerDrizzleProfileStorage, registerDrizzleRuntimeStorage, registerStorageHandlersWithRollback, resolveAndValidateBasePath, resolveClientBinary, verifyInstalledVersion };