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

package/dist/clients/index.d.mts

@@ -9,7 +9,7 @@ import { BaseService } from "@makaio/framework/service-base";
 import { ClientAccountIdentifier, ClientDefinition as ClientDefinition$1, ClientExecutionContext, ClientInstallCompleted, ClientInstallProgress, ClientRuntimeObserveRequest, ClientSessionObservedBase, ClientSubjects, ClientUsageSnapshot, ClientWiringEntry, ClientWiringEntrySchema, ManagedInstallDescriptor, ManagedInstallStrategy, PostInstallDescriptor } from "@makaio/framework/contracts/client";
 import * as _$zod_v4_core0 from "zod/v4/core";
 
-//#region packages/clients-core/src/atomic-modify-file.d.ts
+//#region subsystems/client/src/atomic-modify-file.d.ts
 /**
  * Atomic file read-modify-write utility with per-path mutex serialization.
  *
@@ -87,7 +87,7 @@ type AtomicContentParser<TContent> = (raw: unknown) => TContent;
  */
 declare function atomicModifyFile<TContent, TResult>(filePath: string, defaultContent: unknown, mutex: Map<string, Promise<void>>, parseContent: AtomicContentParser<TContent>, modifier: AtomicModifier<TContent, TResult>): Promise<TResult>;
 //#endregion
-//#region packages/clients-core/src/client-binary-errors.d.ts
+//#region subsystems/client/src/client-binary-errors.d.ts
 /**
  * Typed error classes for the client binary management subsystem.
  * @packageDocumentation
@@ -109,7 +109,7 @@ declare class BinaryNotFoundError extends Error {
   constructor(clientId: string);
 }
 //#endregion
-//#region packages/clients-core/src/client-account-registry.d.ts
+//#region subsystems/client/src/client-account-registry.d.ts
 /**
  * Result returned when account identifiers are observed or ingested.
  */
@@ -152,7 +152,7 @@ declare class ClientAccountRegistry {
   private mergeInto;
 }
 //#endregion
-//#region packages/clients-core/src/binary-strategies/types.d.ts
+//#region subsystems/client/src/binary-strategies/types.d.ts
 /**
  * Injected I/O dependencies for install strategy implementations.
  *
@@ -227,7 +227,7 @@ interface StrategyDependencies {
   removeDirectory(dirPath: string): Promise<void>;
 }
 //#endregion
-//#region packages/clients-core/src/client-binary-manager-types.d.ts
+//#region subsystems/client/src/client-binary-manager-types.d.ts
 /**
  * Configuration for the managed binary base directory.
  *
@@ -419,7 +419,7 @@ declare function isPathWithinBase(base: string, candidate: string): boolean;
  */
 declare function resolveAndValidateBasePath(basePath: string, caller: string): string;
 //#endregion
-//#region packages/clients-core/src/client-binary-manager.d.ts
+//#region subsystems/client/src/client-binary-manager.d.ts
 /**
  * In-memory manager for the global `client.*` binary-management contracts.
  *
@@ -608,7 +608,7 @@ declare class ClientBinaryManager extends BaseService {
   private resolveManagedConfigDir;
 }
 //#endregion
-//#region packages/clients-core/src/client-binary-job-runner.d.ts
+//#region subsystems/client/src/client-binary-job-runner.d.ts
 /**
  * Executes install jobs asynchronously and delivers progress and completed
  * notifications via caller-provided typed callbacks.
@@ -796,7 +796,7 @@ declare class ClientBinaryJobRunner {
   private resolveTargetDir;
 }
 //#endregion
-//#region packages/clients-core/src/client-definition-registry.d.ts
+//#region subsystems/client/src/client-definition-registry.d.ts
 /**
  * Concrete {@link ClientDefinitionLookup} implementation seeded with a fixed
  * set of definitions at construction time.
@@ -862,7 +862,7 @@ declare class ClientDefinitionRegistry implements ClientDefinitionLookup {
   private registerUnique;
 }
 //#endregion
-//#region packages/clients-core/src/client-binary-version-resolver.d.ts
+//#region subsystems/client/src/client-binary-version-resolver.d.ts
 /**
  * Resolution result returned by {@link ClientBinaryVersionResolver.resolveInstallVersion}.
  */
@@ -911,7 +911,7 @@ declare class ClientBinaryVersionResolver {
   resolveInstallVersion(clientId: string, descriptor: ManagedInstallDescriptor, explicitVersion?: string): ResolvedInstallVersion;
 }
 //#endregion
-//#region packages/clients-core/src/client-runtime-registry-types.d.ts
+//#region subsystems/client/src/client-runtime-registry-types.d.ts
 /**
  * Shared types for the client runtime registry.
  *
@@ -984,7 +984,7 @@ interface RuntimeUpsertResult {
   readonly record: ClientRuntimeRecord;
 }
 //#endregion
-//#region packages/clients-core/src/client-runtime-registry.d.ts
+//#region subsystems/client/src/client-runtime-registry.d.ts
 /**
  * In-memory registry that canonicalizes client runtime instances across
  * evidence fields and optionally persists them via a bus-backed handler.
@@ -1049,7 +1049,7 @@ declare class ClientRuntimeRegistry {
   private persistRecord;
 }
 //#endregion
-//#region packages/clients-core/src/client-runtime-service.d.ts
+//#region subsystems/client/src/client-runtime-service.d.ts
 /**
  * In-memory runtime service for the global `client.*` contracts.
  *
@@ -1119,7 +1119,7 @@ declare class ClientRuntimeService extends BaseService {
   private consolidateMergedSnapshots;
 }
 //#endregion
-//#region packages/clients-core/src/client-config-prime-service.d.ts
+//#region subsystems/client/src/client-config-prime-service.d.ts
 /**
  * Handles the generic `client.config.prime` request subject.
  */
@@ -1134,7 +1134,7 @@ declare class ClientConfigPrimeService extends BaseService {
   protected onInit(): void;
 }
 //#endregion
-//#region packages/clients-core/src/client-profile-service.d.ts
+//#region subsystems/client/src/client-profile-service.d.ts
 /**
  * Handles the `client.profile.*` bus subjects, providing full CRUD for named
  * client configuration profiles plus filesystem directory management.
@@ -1182,7 +1182,7 @@ declare class ClientProfileService extends BaseService {
   private registerSetDefaultHandler;
 }
 //#endregion
-//#region packages/clients-core/src/client-session-config-service.d.ts
+//#region subsystems/client/src/client-session-config-service.d.ts
 /**
  * Handles `client.sessionConfig.*` bus subjects, providing per-session config
  * directory isolation for client processes.
@@ -1259,7 +1259,7 @@ declare class ClientSessionConfigService extends BaseService {
   private listClientIds;
 }
 //#endregion
-//#region packages/clients-core/src/client-session-observed-semantics.d.ts
+//#region subsystems/client/src/client-session-observed-semantics.d.ts
 /**
  * Canonical schema for the raw catch-all hook payload delivered on
  * `client:<id>.hook.received`.
@@ -1313,6 +1313,57 @@ type RawClientHookReceivedSubject = SubjectDefinition<RawClientHookSubjectRecord
  * @returns Non-owning subject definition for the client's raw hook ingress
  */
 declare function createRawClientHookReceivedSubject(clientId: string): RawClientHookReceivedSubject;
+/**
+ * Default timeout in milliseconds for hook handle requests.
+ *
+ * Shared between the CLI schema default (client-hooks extension) and the
+ * wiring descriptor trailing flags (claude-code client) so both always agree
+ * on the configured wait budget without independent magic numbers.
+ */
+declare const DEFAULT_HOOK_HANDLE_TIMEOUT_MS = 5000;
+/**
+ * Schema for the response payload returned by a `makaio hook handle` command.
+ *
+ * The client binary reads this from the command's stdout after the process
+ * exits.  All fields default to safe zero-values so partial responses are
+ * still valid.
+ *
+ * Fields:
+ * - `exitCode` — process exit code the binary should use (0–255). Defaults to `0`.
+ * - `stdout`   — text written to stdout, forwarded verbatim to the client.
+ *   Defaults to `''`.
+ * - `stderr`   — text written to stderr, forwarded verbatim to the client.
+ *   Defaults to `''`.
+ */
+declare const ClientHookHandleResponseSchema: z.ZodObject<{
+  exitCode: z.ZodDefault<z.ZodNumber>;
+  stdout: z.ZodDefault<z.ZodString>;
+  stderr: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+type ClientHookHandleResponse = z.infer<typeof ClientHookHandleResponseSchema>;
+type RawClientHookHandleSubjectRecord = SubjectRecord<'hook.handle', RequestMessagePayload<RawClientHookPayload, ClientHookHandleResponse>>;
+/**
+ * Subject definition for the raw hook handle request/response subject in a
+ * concrete `client:<id>` namespace.
+ *
+ * Carries `RequestMessagePayload<RawClientHookPayload, ClientHookHandleResponse>`
+ * as a phantom type so `bus.requestOptional` infers the correct generics without
+ * additional type annotations at the call site.
+ */
+type RawClientHookHandleSubject = SubjectDefinition<RawClientHookHandleSubjectRecord, 'hook.handle', `client:${string}`>;
+/**
+ * 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.
+ * @param rawClientId - Stable client identifier, optionally prefixed with `client:`
+ * @returns Non-owning subject definition for the client's raw hook handle ingress
+ */
+declare function createRawClientHookHandleSubject(rawClientId: string): RawClientHookHandleSubject;
 /**
  * Trim and return a string value when non-empty, otherwise `undefined`.
  *
@@ -1367,11 +1418,11 @@ declare function buildClientSessionBase(opts: BuildClientSessionBaseOpts): Clien
  */
 declare function emitBestEffort(fn: () => Promise<void>): void;
 //#endregion
-//#region packages/clients-core/src/create-client-namespace.d.ts
+//#region subsystems/client/src/create-client-namespace.d.ts
 /**
  * Result returned by {@link createClientNamespace}.
  * @typeParam AdditionalSchemas - Extra subject schemas registered alongside the
- *   shared `hook.received` subject.  Defaults to an empty record (no extras).
+ *   shared hook subjects.  Defaults to an empty record (no extras).
  */
 interface ClientNamespaceResult<AdditionalSchemas extends SchemaRecord = Record<never, never>> {
   /**
@@ -1381,7 +1432,8 @@ interface ClientNamespaceResult<AdditionalSchemas extends SchemaRecord = Record<
   /**
    * Typed bus subjects for the per-client namespace.
    *
-   * Always includes `hook.received` for the raw catch-all hook ingress.
+   * Always includes `hook.received` for raw hook ingress and `hook.handle` for
+   * hook request handling.
    * When `additionalSchemas` were provided at construction time the extra
    * subjects are also present here, fully typed.
    */
@@ -1394,8 +1446,10 @@ interface ClientNamespaceResult<AdditionalSchemas extends SchemaRecord = Record<
  * and can be referenced by {@link ClientNamespaceResult} via instantiation
  * expressions.
  * @param clientId - Stable client identifier (e.g. `'codex'`)
- * @param additionalSchemas - Extra subjects to register alongside `hook.received`
- * @returns Namespace subjects with `hook.received` plus any additional subjects
+ * @param additionalSchemas - Extra subjects to register alongside the shared
+ *   hook subjects.
+ * @returns Namespace subjects with shared hook subjects plus any additional
+ *   subjects.
  */
 declare function buildClientSubjects<AdditionalSchemas extends SchemaRecord>(clientId: string, additionalSchemas: AdditionalSchemas): _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<`client:${string}`, {
   'hook.received': _$zod.ZodObject<{
@@ -1404,6 +1458,19 @@ 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': {
+    request: _$zod.ZodObject<{
+      eventName: _$zod.ZodString;
+      receivedAt: _$zod.ZodNumber;
+      payload: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
+      metadata: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      exitCode: _$zod.ZodDefault<_$zod.ZodNumber>;
+      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>`.
@@ -1411,13 +1478,15 @@ declare function buildClientSubjects<AdditionalSchemas extends SchemaRecord>(cli
  * The namespace is registered idempotently — calling this function multiple
  * times with the same `clientId` returns equivalent subjects.
  *
- * The resulting namespace pre-registers the `hook.received` subject so client
- * ingress bridges have a consistent raw-event ingress point:
+ * The resulting namespace pre-registers the `hook.received` and `hook.handle`
+ * subjects so client bridges have consistent hook ingress and request handling
+ * points:
  *
  * ```ts
  * // In @makaio/client-codex
  * export const { subjects: CodexClientSubjects } = createClientNamespace('codex');
  * // CodexClientSubjects.hook.received → 'client:codex.hook.received'
+ * // CodexClientSubjects.hook.handle → 'client:codex.hook.handle'
  * ```
  *
  * Clients that need extra subjects pass them as the second argument:
@@ -1433,12 +1502,12 @@ declare function buildClientSubjects<AdditionalSchemas extends SchemaRecord>(cli
  *   `'claude-code'`), optionally prefixed with `client:`.  Canonicalized to
  *   lowercase and restricted to letters, numbers, and hyphens.
  * @param additionalSchemas - Optional extra subject schemas to register alongside
- *   the shared `hook.received` subject.
+ *   the shared hook subjects.  Must not include `hook.received` or `hook.handle`.
  * @returns Namespace domain string and typed bus subjects.
  */
 declare function createClientNamespace<AdditionalSchemas extends SchemaRecord = Record<never, never>>(clientId: string, additionalSchemas?: AdditionalSchemas): ClientNamespaceResult<AdditionalSchemas>;
 //#endregion
-//#region packages/clients-core/src/wiring-schemas.d.ts
+//#region subsystems/client/src/wiring-schemas.d.ts
 /**
  * Non-empty absolute filesystem path.
  *
@@ -1512,7 +1581,7 @@ type ClientWiringAggregatedResult = z.infer<typeof ClientWiringAggregatedResultS
  */
 declare function assertAbsoluteProjectDir(projectDir: string | undefined): void;
 //#endregion
-//#region packages/clients-core/src/create-client-wiring-list-subject.d.ts
+//#region subsystems/client/src/create-client-wiring-list-subject.d.ts
 /** Untyped wiring subject definition returned by {@link createClientWiringSubjectDef}. */
 interface ClientWiringSubjectDefBase {
   /** Subject key within the client namespace (e.g. `'wiring.list'`). */
@@ -1575,7 +1644,7 @@ type ClientWiringListSubjectDef = SubjectDefinition<ClientWiringListSubjectRecor
  */
 declare function createClientWiringListSubjectDef(clientId: string): ClientWiringListSubjectDef;
 //#endregion
-//#region packages/clients-core/src/package.d.ts
+//#region subsystems/client/src/package.d.ts
 /**
  * Composite service that initialises and destroys the
  * {@link ClientRuntimeService}, the {@link ClientBinaryManager}, the
@@ -1693,7 +1762,7 @@ declare function registerStorageHandlersWithRollback(registrations: ReadonlyArra
  */
 declare function createClientsCorePackage(options?: ClientsCorePackageOptions): MakaioNodeExtension<IMakaioBus>;
 //#endregion
-//#region packages/clients-core/src/storage/client-binary-storage-namespace.d.ts
+//#region subsystems/client/src/storage/client-binary-storage-namespace.d.ts
 /**
  * Zod schema for a persisted installed-version record transported over the bus.
  */
@@ -2075,7 +2144,7 @@ type ClientBinaryVersionRecord = z.infer<typeof ClientBinaryVersionRecordSchema>
 /** Per-client binary state record as exchanged over the bus. */
 type ClientBinaryStateRecord = z.infer<typeof ClientBinaryStateRecordSchema>;
 //#endregion
-//#region packages/clients-core/src/storage/runtime-storage-namespace.d.ts
+//#region subsystems/client/src/storage/runtime-storage-namespace.d.ts
 /**
  * Zod schema for a fully-populated runtime record transported over the bus.
  *
@@ -2209,7 +2278,7 @@ declare const ClientRuntimeStorageSubjects: _$_makaio_core0.BusSubjects<_$_makai
   };
 }>, "client-runtime:storage">;
 //#endregion
-//#region packages/clients-core/src/storage/profile-storage-namespace.d.ts
+//#region subsystems/client/src/storage/profile-storage-namespace.d.ts
 /**
  * Zod schema for a persisted client profile record transported over the bus.
  *
@@ -2488,7 +2557,7 @@ declare const ClientProfileStorageSubjects: _$_makaio_core0.BusSubjects<_$_makai
 /** Persisted client profile record as exchanged over the bus. */
 type ClientProfileRecord = z.infer<typeof ClientProfileRecordSchema>;
 //#endregion
-//#region packages/clients-core/src/resolve-client-binary.d.ts
+//#region subsystems/client/src/resolve-client-binary.d.ts
 /**
  * Resolve the execution context for a client binary via the bus.
  *
@@ -2502,7 +2571,7 @@ type ClientProfileRecord = z.infer<typeof ClientProfileRecordSchema>;
  */
 declare function resolveClientBinary(clientId: string): Promise<ClientExecutionContext | undefined>;
 //#endregion
-//#region packages/clients-core/src/wiring-helpers.d.ts
+//#region subsystems/client/src/wiring-helpers.d.ts
 /**
  * Minimal descriptor for a single session-event wiring entry.
  *
@@ -2513,6 +2582,13 @@ declare function resolveClientBinary(clientId: string): Promise<ClientExecutionC
 interface SessionEventDescriptor {
   /** Native event name as declared in the client definition (e.g. `'SessionStart'`). */
   readonly eventName: string;
+  /**
+   * Hook interaction mode for this event.
+   *
+   * - `'event'` — fire-and-forget: install `makaio hook received ...`
+   * - `'request'` — request/response: install `makaio hook handle ...`
+   */
+  readonly mode: 'event' | 'request';
 }
 /**
  * Build a shell-safe client command string from an executable and argv tokens.
@@ -2543,9 +2619,11 @@ declare function buildClientCommand(makaioCommand: string, args: readonly string
  *   hook command (e.g. `'hook received claude-code'`).
  * @param eventName - Native hook event name (e.g. `'SessionStart'`).
  * @param envPairs - Optional `KEY=value` pairs prepended before the executable.
+ * @param rootFlags - Optional root-level CLI flags inserted between the
+ *   executable and the sentinel (e.g. `['--debounce-failure']`).
  * @returns Full hook command string to write into the client's native config.
  */
-declare function buildHookCommand(makaioCommand: string, sentinel: string, eventName: string, envPairs?: readonly string[]): string;
+declare function buildHookCommand(makaioCommand: string, sentinel: string, eventName: string, envPairs?: readonly string[], rootFlags?: readonly string[]): string;
 /**
  * Derive the ordered list of session-event wiring descriptors from a client
  * definition.
@@ -2554,8 +2632,8 @@ declare function buildHookCommand(makaioCommand: string, sentinel: string, event
  * without one are client-internal and do not need framework wiring.
  * @param clientDefinition - The parsed static client definition whose
  *   `runtimeCapabilities.hookEvents` array is the source of truth.
- * @returns Read-only array of `{ eventName }` descriptors in declaration order.
+ * @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 ClientBinaryStateRecord, ClientBinaryStateRecordSchema, ClientBinaryStorageNamespace, ClientBinaryStorageSubjects, type ClientBinaryVersionRecord, ClientBinaryVersionRecordSchema, ClientBinaryVersionResolver, ClientConfigPrimeService, type ClientDefinitionLookup, ClientDefinitionRegistry, 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 InstallJob, type JobCompletedCallback, type JobCompletionCallback, type JobCompletionResult, type JobProgressCallback, type PostInstallContext, type PostInstallHandler, type RawClientHookPayload, RawClientHookPayloadSchema, type RawClientHookReceivedSubject, type ResolvedInstallVersion, RuntimeRecordSchema, type RuntimeUpsertResult, type SessionEventDescriptor, type StrategyDependencies, assertAbsoluteProjectDir, atomicModifyFile, buildClientCommand, buildClientSessionBase, buildHookCommand, canonicalizeClientId, createClientNamespace, createClientWiringListSubjectDef, createClientWiringSubjectDef, createClientsCorePackage, createRawClientHookReceivedSubject, deriveSessionEventDescriptors, emitBestEffort, isPathWithinBase, pickNonEmptyString, pickNonEmptyStringValue, registerStorageHandlersWithRollback, resolveAndValidateBasePath, resolveClientBinary };
+export { AbsolutePathSchema, type AtomicContentParser, type AtomicModifier, type AtomicModifyOutcome, BinaryNotFoundError, type BuildClientSessionBaseOpts, CLIENT_RUNTIME_STATUSES, ClientAccountRegistry, type ClientAccountUpsertResult, ClientBinaryJobRunner, ClientBinaryManager, type ClientBinaryManagerConfig, 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 InstallJob, 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, createClientNamespace, createClientWiringListSubjectDef, createClientWiringSubjectDef, createClientsCorePackage, createRawClientHookHandleSubject, createRawClientHookReceivedSubject, deriveSessionEventDescriptors, emitBestEffort, isPathWithinBase, pickNonEmptyString, pickNonEmptyStringValue, registerStorageHandlersWithRollback, resolveAndValidateBasePath, resolveClientBinary };