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

package/dist/clients/index.d.mts

@@ -4,9 +4,9 @@ import * as _$_makaio_core0 from "@makaio/framework/core";
 import { EventMessagePayload, RequestMessagePayload, SchemaRecord, SubjectDefinition, SubjectRecord } from "@makaio/framework/core";
 import { IMakaioBus } from "@makaio/framework/bus";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
-import { ClientDefinition, ExtensionServiceLifecycle, LatestVersionSourceStatus, MakaioNodeExtension } from "@makaio/framework/contracts";
+import { ClientDefinition, ExtensionServiceLifecycle, MakaioNodeExtension } from "@makaio/framework/contracts";
 import { BaseService } from "@makaio/framework/service-base";
-import { ClientAccountIdentifier, ClientDefinition as ClientDefinition$1, ClientExecutionContext, ClientInstallCompleted, ClientInstallProgress, ClientRuntimeObserveRequest, ClientSessionObservedBase, ClientSubjects, ClientUsageSnapshot, ClientWiringEntry, ClientWiringEntrySchema, LatestVersionSourceStatus as LatestVersionSourceStatus$1, ManagedInstallDescriptor, ManagedInstallStrategy, PostInstallDescriptor } from "@makaio/framework/contracts/client";
+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
@@ -152,67 +152,6 @@ declare class ClientAccountRegistry {
   private mergeInto;
 }
 //#endregion
-//#region packages/clients-core/src/client-binary-feed-cache.d.ts
-/**
- * In-memory cache of latest-available-version metadata per managed client.
- *
- * **Lifecycle:**
- * 1. Call {@link ClientBinaryFeedCache.hydrate} at boot to populate the cache
- *    from persisted state rows.
- * 2. Call {@link ClientBinaryFeedCache.update} after every feed refresh to
- *    update the in-memory entry and persist the new metadata to the database.
- *
- * The cache is write-only from the outside: the manager reads feed metadata
- * exclusively via {@link ClientBinaryVersionResolver.getLatestVersionMeta}.
- * The in-memory `cache` Map is retained internally so that
- * {@link ClientBinaryFeedCache.update} can preserve the last-successful
- * `lastCheckedAt` timestamp on error without an extra storage round-trip.
- */
-declare class ClientBinaryFeedCache {
-  private readonly cache;
-  private readonly bus;
-  /**
-   * @param bus - Bus instance used to persist feed-cache updates to storage
-   */
-  constructor(bus: IMakaioBus);
-  /**
-   * Hydrates the in-memory cache from all persisted state rows.
-   *
-   * Must be called once at boot, before any calls to {@link update}. Rows that
-   * have `latestVersionLastCheckedAt` set are
-   * classified as `'cached'`; rows without it are classified as `'error'`
-   * (the feed has never been successfully checked).
-   *
-   * Returns the raw state rows so the caller can reuse them (e.g. to seed
-   * the version resolver) without a second `loadAllState` bus round-trip.
-   * @returns All persisted state rows fetched during hydration
-   */
-  hydrate(): Promise<ReadonlyArray<{
-    clientId: string;
-    latestAvailableVersion: string | null;
-    latestVersionLastCheckedAt: number | null;
-    latestVersionSourceStatus: LatestVersionSourceStatus;
-  }>>;
-  /**
-   * Persist the feed-cache entry for a client to storage and then update the
-   * in-memory cache.
-   *
-   * Storage is written first so that a bus failure leaves the in-memory cache
-   * unchanged, keeping the resolver and storage in sync. The in-memory entry is
-   * only updated after the bus request succeeds.
-   *
-   * Call this after every feed refresh attempt, including failures (using
-   * `'error'` as the `sourceStatus`). On error the caller should pass the
-   * last-known version from the version resolver — not `null` — so that the
-   * cached value remains useful for subsequent list operations.
-   * @param clientId - Stable client identifier to update
-   * @param latestAvailableVersion - Latest version from the upstream feed,
-   *   or the previously cached version when the refresh failed
-   * @param sourceStatus - Freshness classification for this update
-   */
-  update(clientId: string, latestAvailableVersion: string | null, sourceStatus: LatestVersionSourceStatus): Promise<void>;
-}
-//#endregion
 //#region packages/clients-core/src/binary-strategies/types.d.ts
 /**
  * Injected I/O dependencies for install strategy implementations.
@@ -246,11 +185,14 @@ interface StrategyDependencies {
    * Execute a shell command and return its stdout.
    * @param command - The executable to run (no shell expansion).
    * @param args - Positional arguments passed to the executable.
-   * @param options - Optional execution options.
+   * @param options - Optional execution options. `cwd` sets the working
+   *   directory; `env` is merged on top of the parent environment when present
+   *   (when absent the parent environment is inherited unchanged).
    * @returns Trimmed stdout string.
    */
   exec(command: string, args: string[], options?: {
     cwd?: string;
+    env?: Record<string, string>;
   }): Promise<string>;
   /**
    * Extract an archive file into `destDir`.
@@ -291,17 +233,26 @@ interface StrategyDependencies {
  *
  * The manager derives per-client, per-version install directories from
  * `basePath` using the pattern `{basePath}/{clientId}/{version}/`.
- *
- * TODO: ClientBinaryJobRunner only consumes basePath — introduce a narrowed
- * runner-specific config (e.g. `Pick<ClientBinaryManagerConfig, 'basePath'>`) to
- * decouple the runner from manager-only config such as configBasePath.
  */
-interface ClientBinaryManagerConfig {
+interface ClientBinaryJobRunnerConfig {
   /**
    * Absolute base directory under which all managed binary versions are
    * installed (e.g. `~/.makaio/binaries/`).
    */
   basePath: string;
+  /**
+   * Framework-owned handlers for declarative post-install descriptors.
+   *
+   * Client packages declare `postInstall.kind`; the host supplies the handler
+   * implementation here. Missing handlers fail the install job rather than
+   * silently skipping a declared lifecycle step.
+   */
+  postInstallHandlers?: ReadonlyMap<string, PostInstallHandler>;
+}
+/**
+ * Configuration for the managed binary manager.
+ */
+interface ClientBinaryManagerConfig extends ClientBinaryJobRunnerConfig {
   /**
    * Base directory for per-client config isolation directories.
    *
@@ -312,14 +263,6 @@ interface ClientBinaryManagerConfig {
    * the definition declares `configIsolation`.
    */
   configBasePath: string;
-  /**
-   * Framework-owned handlers for declarative post-install descriptors.
-   *
-   * Client packages declare `postInstall.kind`; the host supplies the handler
-   * implementation here. Missing handlers fail the install job rather than
-   * silently skipping a declared lifecycle step.
-   */
-  postInstallHandlers?: ReadonlyMap<string, PostInstallHandler>;
 }
 /**
  * Context passed to a framework-owned post-install handler.
@@ -481,7 +424,6 @@ declare function resolveAndValidateBasePath(basePath: string, caller: string): s
  * In-memory manager for the global `client.*` binary-management contracts.
  *
  * **Responsibilities:**
- * - Hydrate the feed cache and version resolver from storage on boot.
  * - Handle `client.list`, `client.install`, `client.update`,
  *   `client.setActive`, and `client.uninstall` bus subjects.
  * - Delegate async install/update execution to {@link ClientBinaryJobRunner}.
@@ -493,15 +435,19 @@ declare function resolveAndValidateBasePath(basePath: string, caller: string): s
  * **One job per client invariant:** only one install or update job is allowed
  * to run for a given client at a time. Concurrent requests are rejected with
  * an error until the in-flight job completes.
+ *
+ * **Pin-only installs:** version resolution is always derived from the
+ * descriptor pin. No upstream feed fetches are performed at runtime; the
+ * version is determined statically from the client package.
  */
 declare class ClientBinaryManager extends BaseService {
   private readonly config;
   private readonly definitionLookup;
-  private readonly feedCache;
   private readonly versionResolver;
   private readonly jobRunner;
   private readonly strategyDeps;
   private readonly resolvedBasePath;
+  private readonly resolvedConfigBasePath;
   private readonly resolver;
   /**
    * Set of client IDs with an operation (install, update, or uninstall) in
@@ -526,7 +472,7 @@ declare class ClientBinaryManager extends BaseService {
    */
   constructor(bus: IMakaioBus | undefined, config: ClientBinaryManagerConfig, definitionLookup?: ClientDefinitionLookup, strategyDeps?: StrategyDependencies);
   /**
-   * Hydrate state from storage and register bus handlers.
+   * Register bus handlers.
    */
   protected onInit(): Promise<void>;
   /**
@@ -537,24 +483,27 @@ declare class ClientBinaryManager extends BaseService {
    * Assemble the installation inventory for all managed clients.
    *
    * Delegates to {@link assembleBinaryList} for the read-model assembly logic.
-   * @param forceRefresh - When `true`, force a live upstream feed refresh
    * @returns Assembled list of client binary entries
    */
   private handleList;
   /**
    * Enqueue a background install job for a managed client binary.
    *
-   * Resolves the target version (explicit or latest-from-feed) and returns
-   * a `jobId` immediately. The job runs asynchronously; callers track progress
-   * via `client.installJob.progress` and `client.installJob.completed` events.
+   * Resolves the target version from the descriptor pin (or validates the
+   * explicit version against it) and returns a `jobId` immediately. The job
+   * runs asynchronously; callers track progress via
+   * `client.installJob.progress` and `client.installJob.completed` events.
    * @param clientId - Stable client identifier to install
-   * @param requestedVersion - Explicit version to install, or `undefined` for latest
+   * @param requestedVersion - Explicit version to install (must match the
+   *   descriptor pin), or `undefined` to use the pin directly
    * @returns Job acknowledgement with resolved version
    */
   private handleInstall;
   /**
-   * Refresh the feed, resolve the latest version, and enqueue an update job
-   * that installs and activates the result.
+   * Install the descriptor pin and activate it.
+   *
+   * Resolves the version from the descriptor pin and enqueues a job with
+   * `makeActive: true`. No upstream feed fetch is performed.
    * @param clientId - Stable client identifier to update
    * @returns Job acknowledgement with resolved version
    */
@@ -590,23 +539,13 @@ declare class ClientBinaryManager extends BaseService {
    * `client.version.changed`.
    *
    * Centralizes the storage-side active-version mutation used by
-   * `handleSetActive` and the job completion callback. Feed-cache fields are
-   * preserved by `client-binary:storage.setActiveVersion`.
+   * `handleSetActive` and the job completion callback.
    * @param clientId - Stable client identifier
    * @param newActiveVersion - Version to set active, or `null` to clear
    * @param reason - Operation that triggered the change
    * @returns The previous active version before the mutation
    */
   private patchActiveVersion;
-  /**
-   * Hydrate feed cache and version resolver from persisted storage.
-   *
-   * Called once during `onInit()`. Populates the in-memory caches so that
-   * `client.list` and `client.install` requests do not need a live feed fetch
-   * on the first call after a process restart. Both caches are seeded from
-   * a single `loadAllState` bus round-trip.
-   */
-  private hydrateFromStorage;
   /**
    * Look up and validate a managed client definition.
    *
@@ -642,8 +581,14 @@ declare class ClientBinaryManager extends BaseService {
   /**
    * Create the completion callback passed to the job runner.
    *
-   * Persists the installed version to storage and optionally sets it as active,
-   * then emits `client.version.changed` with the originating operation reason.
+   * Primes the managed config directory for the installed client, then persists
+   * the installed version to storage and optionally sets it as active, then
+   * emits `client.version.changed` with the originating operation reason.
+   *
+   * **Order of operations:**
+   * 1. Prime the managed config directory (blocking, no-op if no handler).
+   * 2. Record the installed version and optional activation atomically.
+   * 3. Emit `client.version.changed` on activation (best-effort).
    *
    * **Consistency guarantee:** version persistence and optional activation
    * are committed through one storage transaction, so a failed activation
@@ -651,6 +596,16 @@ declare class ClientBinaryManager extends BaseService {
    * @returns Bound completion callback for the job runner
    */
   private makeCompletionCallback;
+  /**
+   * Resolve the managed config directory for a client.
+   *
+   * The managed config directory follows the convention established by
+   * {@link ClientBinaryManagerConfig.configBasePath}:
+   * `{configBasePath}/{clientId}/config/`.
+   * @param clientId - Stable client identifier.
+   * @returns Absolute path to the client's managed config directory.
+   */
+  private resolveManagedConfigDir;
 }
 //#endregion
 //#region packages/clients-core/src/client-binary-job-runner.d.ts
@@ -682,9 +637,9 @@ declare class ClientBinaryJobRunner {
   private readonly resolvedBasePath;
   /**
    * @param strategyDeps - I/O dependency implementations forwarded to each strategy
-   * @param config - Manager configuration (provides `basePath`)
+   * @param config - Job-runner configuration
    */
-  constructor(strategyDeps: StrategyDependencies, config: ClientBinaryManagerConfig);
+  constructor(strategyDeps: StrategyDependencies, config: ClientBinaryJobRunnerConfig);
   /**
    * Start a background install job and return immediately.
    *
@@ -777,6 +732,16 @@ declare class ClientBinaryJobRunner {
    * @param installPath - Absolute staged install directory to remove
    */
   private cleanupStagedArtifact;
+  /**
+   * Execute the install strategy and clean the target directory if the strategy
+   * fails after staging files.
+   * @param job - Running job descriptor.
+   * @param strategy - Concrete install strategy.
+   * @param targetDir - Versioned install directory.
+   * @param onProgress - Progress notification callback.
+   * @returns Normalized install artifact from the strategy.
+   */
+  private executeStrategy;
   /**
    * Run the optional declarative post-install hook through a framework-owned
    * handler registered on the manager config.
@@ -899,132 +864,51 @@ declare class ClientDefinitionRegistry implements ClientDefinitionLookup {
 //#endregion
 //#region packages/clients-core/src/client-binary-version-resolver.d.ts
 /**
- * Upstream feed fetcher abstraction.
- *
- * Implementors are responsible for the strategy-specific network calls needed
- * to discover the latest published version of a managed client binary. The
- * resolver treats this as a pure dependency so callers can substitute a mock
- * in tests.
+ * Resolution result returned by {@link ClientBinaryVersionResolver.resolveInstallVersion}.
  */
-interface FeedFetcher {
+interface ResolvedInstallVersion {
   /**
-   * Fetch the latest available version string for the given install descriptor.
+   * Concrete version string to install.
    *
-   * The returned string must be a non-empty version identifier (semver or
-   * opaque tag). The implementor should throw on any network or parse error so
-   * the resolver can apply its fallback logic.
-   * @param descriptor - Managed install descriptor for the client
-   * @returns Resolved latest version string
+   * Always equals the pinned version from the descriptor. When an explicit
+   * version was supplied by the caller it has been validated to match the pin.
    */
-  fetchLatestVersion(descriptor: ManagedInstallDescriptor): Promise<string>;
-}
-/**
- * Resolution result returned by {@link ClientBinaryVersionResolver.resolveInstallVersion}.
- */
-interface ResolvedInstallVersion {
-  /** Concrete version string to install. */
-  version: string;
+  readonly version: string;
   /**
-   * `true` when the version was supplied explicitly by the caller;
-   * `false` when the resolver fell back to the cached latest.
+   * `true` when the version was supplied explicitly by the caller and matches
+   * the descriptor pin; `false` when the pin was used directly.
    */
-  explicit: boolean;
+  readonly explicit: boolean;
 }
 /**
- * Latest-version metadata for a single client, suitable for inclusion in a
- * `client.list` response.
- */
-interface LatestVersionMeta {
-  /** Latest version string known to the resolver, or `null` when unknown. */
-  latestAvailableVersion: string | null;
-  /** Epoch timestamp when the latest-version index was last checked, or `null`. */
-  latestVersionLastCheckedAt: number | null;
-  /** Freshness classification of the cache entry. */
-  latestVersionSourceStatus: LatestVersionSourceStatus$1;
-}
-/**
- * In-memory version resolver for managed client binaries.
+ * Synchronous, stateless version resolver for managed client binaries.
  *
- * Responsibilities:
- * - Resolving a concrete version for `client.install` requests, falling back
- *   to the last known latest when no explicit version is given.
- * - Refreshing the latest-version cache on demand (for `client.list` with
- *   `forceRefresh: true`), with a graceful fallback to the cached value on
- *   network failure.
- * - Exposing the cache state for `client.list` response assembly.
+ * The resolver enforces the pin-only install contract:
+ * - When no explicit version is supplied, it returns the descriptor pin.
+ * - When an explicit version is supplied, it is accepted only when it equals
+ *   the descriptor pin; any mismatch throws immediately so the caller can
+ *   reject the request with a clear message.
  *
- * This class is intentionally bus-free. The `ClientBinaryManager` owns bus
- * registration and calls into this resolver.
+ * No network calls, no cache, no async I/O. The concrete version is always
+ * known at construction time from the descriptor.
  */
 declare class ClientBinaryVersionResolver {
-  #private;
-  private readonly feedFetcher;
-  private readonly cache;
-  /**
-   * Creates a new resolver instance.
-   * @param feedFetcher - Strategy-agnostic upstream feed fetcher
-   */
-  constructor(feedFetcher: FeedFetcher);
   /**
    * Resolve the version to install for a `client.install` request.
    *
-   * When `explicitVersion` is supplied it is returned unchanged. When it is
-   * absent the resolver returns the last cached latest version. If no cache
-   * entry exists for the client, the resolver attempts a live feed refresh; if
-   * that also fails, an error is thrown so the caller can reject the request
-   * with a clear message rather than installing a phantom version.
+   * When `explicitVersion` is `undefined`, the descriptor pin is returned
+   * directly. When `explicitVersion` is provided, it must exactly match the
+   * pin or an error is thrown. Whitespace-only explicit versions are also
+   * rejected.
    * @param clientId - Stable client identifier (e.g. `'claude-code'`)
-   * @param descriptor - Managed install descriptor for the client
-   * @param explicitVersion - Version string supplied by the caller, or `undefined`
+   * @param descriptor - Managed install descriptor carrying the pinned version
+   * @param explicitVersion - Version string supplied by the caller, or
+   *   `undefined` to use the descriptor pin
    * @returns Resolved version and whether it was explicitly requested
+   * @throws When `explicitVersion` is an empty/whitespace-only string
+   * @throws When `explicitVersion` does not match the descriptor pin
    */
-  resolveInstallVersion(clientId: string, descriptor: ManagedInstallDescriptor, explicitVersion: string | undefined): Promise<ResolvedInstallVersion>;
-  /**
-   * Attempt a live feed refresh and update the in-memory cache.
-   *
-   * On success the cache entry is updated to `'fresh'`. On failure the
-   * existing entry (if any) is retained but its status is set to `'error'` so
-   * that callers can surface degraded-mode metadata without losing the last
-   * known version.
-   * @param clientId - Stable client identifier (e.g. `'claude-code'`)
-   * @param descriptor - Managed install descriptor for the client
-   * @returns `true` when the refresh succeeded, `false` when it failed
-   */
-  refresh(clientId: string, descriptor: ManagedInstallDescriptor): Promise<boolean>;
-  /**
-   * Return the current latest-version metadata for a client, suitable for
-   * embedding in a `client.list` response.
-   *
-   * When no cache entry exists, the returned object has `null` fields and
-   * status `'error'` — the absence of a cached value is itself an error state
-   * from the perspective of the list consumer.
-   * @param clientId - Stable client identifier (e.g. `'claude-code'`)
-   * @returns Latest-version metadata object
-   */
-  getLatestVersionMeta(clientId: string): LatestVersionMeta;
-  /**
-   * Seed the cache with a previously persisted latest-version entry.
-   *
-   * This is called by the `ClientBinaryManager` at startup to restore the
-   * feed-cache state from durable storage so that `resolveInstallVersion` does
-   * not need a live fetch on the first call after a restart.
-   *
-   * The seeded entry defaults to `'cached'` because it survived a process
-   * restart and has not been confirmed live in this session. Callers may pass
-   * `'error'` when the persisted row records a failed refresh attempt that
-   * should remain visible after hydration.
-   * @param clientId - Stable client identifier (e.g. `'claude-code'`)
-   * @param version - Version string from storage
-   * @param checkedAt - Epoch timestamp when the version was last fetched
-   * @param status - Persisted source status to seed
-   */
-  seedFromStorage(clientId: string, version: string, checkedAt: number, status?: LatestVersionSourceStatus$1): void;
-  /**
-   * Clear all in-memory cache entries.
-   *
-   * Intended for use in tests and on service destroy.
-   */
-  clear(): void;
+  resolveInstallVersion(clientId: string, descriptor: ManagedInstallDescriptor, explicitVersion?: string): ResolvedInstallVersion;
 }
 //#endregion
 //#region packages/clients-core/src/client-runtime-registry-types.d.ts
@@ -1235,6 +1119,21 @@ declare class ClientRuntimeService extends BaseService {
   private consolidateMergedSnapshots;
 }
 //#endregion
+//#region packages/clients-core/src/client-config-prime-service.d.ts
+/**
+ * Handles the generic `client.config.prime` request subject.
+ */
+declare class ClientConfigPrimeService extends BaseService {
+  /**
+   * @param bus - Bus instance used for handler registration and delegation.
+   */
+  constructor(bus?: IMakaioBus);
+  /**
+   * Register the generic config-prime handler.
+   */
+  protected onInit(): void;
+}
+//#endregion
 //#region packages/clients-core/src/client-profile-service.d.ts
 /**
  * Handles the `client.profile.*` bus subjects, providing full CRUD for named
@@ -1680,27 +1579,30 @@ declare function createClientWiringListSubjectDef(clientId: string): ClientWirin
 /**
  * Composite service that initialises and destroys the
  * {@link ClientRuntimeService}, the {@link ClientBinaryManager}, the
- * {@link ClientProfileService}, and the {@link ClientSessionConfigService}
+ * {@link ClientConfigPrimeService}, the {@link ClientProfileService}, and the
+ * {@link ClientSessionConfigService}
  * under a single {@link ExtensionServiceLifecycle} handle.
  *
  * The host coordinator calls `init()` once and `destroy()` once; this class
- * ensures all four services participate in the same lifecycle without any
+ * ensures all five services participate in the same lifecycle without any
  * requiring knowledge of the others.
  */
 declare class ClientsCoreService implements ExtensionServiceLifecycle {
   private readonly runtimeService;
   private readonly binaryManager;
+  private readonly configPrimeService;
   private readonly profileService;
   private readonly sessionConfigService;
   /**
    * @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
    */
-  constructor(runtimeService: ClientRuntimeService, binaryManager: ClientBinaryManager, profileService: ClientProfileService, sessionConfigService: ClientSessionConfigService);
+  constructor(runtimeService: ClientRuntimeService, binaryManager: ClientBinaryManager, configPrimeService: ClientConfigPrimeService, profileService: ClientProfileService, sessionConfigService: ClientSessionConfigService);
   /**
-   * Initialize all four sub-services in parallel.
+   * Initialize all five sub-services in parallel.
    *
    * Uses {@link Promise.allSettled} so every service always attempts
    * initialisation — matching the resilience pattern used by {@link destroy}.
@@ -1709,7 +1611,7 @@ declare class ClientsCoreService implements ExtensionServiceLifecycle {
    */
   init(): Promise<void>;
   /**
-   * Destroy all four sub-services in parallel.
+   * Destroy all five sub-services in parallel.
    *
    * Uses {@link Promise.allSettled} to guarantee every cleanup runs even when
    * one rejects. Any rejections are logged for observability — matching the
@@ -1809,13 +1711,6 @@ declare const ClientBinaryVersionRecordSchema: z.ZodObject<{
 declare const ClientBinaryStateRecordSchema: z.ZodObject<{
   clientId: z.ZodString;
   activeVersion: z.ZodNullable<z.ZodString>;
-  latestAvailableVersion: z.ZodNullable<z.ZodString>;
-  latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-  latestVersionSourceStatus: z.ZodEnum<{
-    error: "error";
-    fresh: "fresh";
-    cached: "cached";
-  }>;
   updatedAt: z.ZodNumber;
 }, z.core.$strip>;
 /**
@@ -1889,13 +1784,6 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
       state: z.ZodNullable<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
       versions: z.ZodArray<z.ZodObject<{
@@ -1920,18 +1808,11 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
         createdAt: z.ZodNumber;
       }, z.core.$strip>>;
     }, z.core.$strip>;
-  }; /** Upsert the per-client binary state row (active version + feed cache). */
+  }; /** Upsert the per-client binary state row. */
   upsertState: {
     request: z.ZodObject<{
       clientId: z.ZodString;
       activeVersion: z.ZodNullable<z.ZodString>;
-      latestAvailableVersion: z.ZodNullable<z.ZodString>;
-      latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-      latestVersionSourceStatus: z.ZodEnum<{
-        error: "error";
-        fresh: "fresh";
-        cached: "cached";
-      }>;
       updatedAt: z.ZodNumber;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -1939,9 +1820,7 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
     }, z.core.$strip>;
   };
   /**
-   * Set the active version without touching feed-cache fields.
-   *
-   * Creates a minimal state row when one does not exist yet.
+   * Set the active version, creating a state row when one does not exist yet.
    */
   setActiveVersion: {
     request: z.ZodObject<{
@@ -1962,13 +1841,6 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
       state: z.ZodNullable<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -1979,13 +1851,6 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
       states: z.ZodArray<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -1996,13 +1861,6 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
       states: z.ZodArray<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
       versions: z.ZodArray<z.ZodObject<{
@@ -2015,29 +1873,6 @@ declare const ClientBinaryStorageNamespace: _$_makaio_core0.BusNamespaceDefiniti
       }, z.core.$strip>>;
     }, z.core.$strip>;
   };
-  /**
-   * Persist an updated feed-cache entry for a client.
-   *
-   * This is a subset of `upsertState` — the handler merges the feed fields
-   * into the existing row (or creates a minimal row) without touching
-   * `activeVersion`.
-   */
-  updateFeedCache: {
-    request: z.ZodObject<{
-      clientId: z.ZodString;
-      latestAvailableVersion: z.ZodNullable<z.ZodString>;
-      latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-      latestVersionSourceStatus: z.ZodEnum<{
-        error: "error";
-        fresh: "fresh";
-        cached: "cached";
-      }>;
-      updatedAt: z.ZodNumber;
-    }, z.core.$strip>;
-    response: z.ZodObject<{
-      success: z.ZodBoolean;
-    }, z.core.$strip>;
-  };
   /**
    * Atomically remove an installed-version row and clear the active-version
    * pointer when it currently points to the deleted version.
@@ -2125,13 +1960,6 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
       state: z.ZodNullable<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
       versions: z.ZodArray<z.ZodObject<{
@@ -2156,18 +1984,11 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
         createdAt: z.ZodNumber;
       }, z.core.$strip>>;
     }, z.core.$strip>;
-  }; /** Upsert the per-client binary state row (active version + feed cache). */
+  }; /** Upsert the per-client binary state row. */
   upsertState: {
     request: z.ZodObject<{
       clientId: z.ZodString;
       activeVersion: z.ZodNullable<z.ZodString>;
-      latestAvailableVersion: z.ZodNullable<z.ZodString>;
-      latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-      latestVersionSourceStatus: z.ZodEnum<{
-        error: "error";
-        fresh: "fresh";
-        cached: "cached";
-      }>;
       updatedAt: z.ZodNumber;
     }, z.core.$strip>;
     response: z.ZodObject<{
@@ -2175,9 +1996,7 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
     }, z.core.$strip>;
   };
   /**
-   * Set the active version without touching feed-cache fields.
-   *
-   * Creates a minimal state row when one does not exist yet.
+   * Set the active version, creating a state row when one does not exist yet.
    */
   setActiveVersion: {
     request: z.ZodObject<{
@@ -2198,13 +2017,6 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
       state: z.ZodNullable<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -2215,13 +2027,6 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
       states: z.ZodArray<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
     }, z.core.$strip>;
@@ -2232,13 +2037,6 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
       states: z.ZodArray<z.ZodObject<{
         clientId: z.ZodString;
         activeVersion: z.ZodNullable<z.ZodString>;
-        latestAvailableVersion: z.ZodNullable<z.ZodString>;
-        latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-        latestVersionSourceStatus: z.ZodEnum<{
-          error: "error";
-          fresh: "fresh";
-          cached: "cached";
-        }>;
         updatedAt: z.ZodNumber;
       }, z.core.$strip>>;
       versions: z.ZodArray<z.ZodObject<{
@@ -2251,29 +2049,6 @@ declare const ClientBinaryStorageSubjects: _$_makaio_core0.BusSubjects<_$_makaio
       }, z.core.$strip>>;
     }, z.core.$strip>;
   };
-  /**
-   * Persist an updated feed-cache entry for a client.
-   *
-   * This is a subset of `upsertState` — the handler merges the feed fields
-   * into the existing row (or creates a minimal row) without touching
-   * `activeVersion`.
-   */
-  updateFeedCache: {
-    request: z.ZodObject<{
-      clientId: z.ZodString;
-      latestAvailableVersion: z.ZodNullable<z.ZodString>;
-      latestVersionLastCheckedAt: z.ZodNullable<z.ZodNumber>;
-      latestVersionSourceStatus: z.ZodEnum<{
-        error: "error";
-        fresh: "fresh";
-        cached: "cached";
-      }>;
-      updatedAt: z.ZodNumber;
-    }, z.core.$strip>;
-    response: z.ZodObject<{
-      success: z.ZodBoolean;
-    }, z.core.$strip>;
-  };
   /**
    * Atomically remove an installed-version row and clear the active-version
    * pointer when it currently points to the deleted version.
@@ -2783,4 +2558,4 @@ declare function buildHookCommand(makaioCommand: string, sentinel: string, event
  */
 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, ClientBinaryFeedCache, ClientBinaryJobRunner, ClientBinaryManager, type ClientBinaryManagerConfig, type ClientBinaryStateRecord, ClientBinaryStateRecordSchema, ClientBinaryStorageNamespace, ClientBinaryStorageSubjects, type ClientBinaryVersionRecord, ClientBinaryVersionRecordSchema, ClientBinaryVersionResolver, 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 FeedFetcher, type InstallJob, type JobCompletedCallback, type JobCompletionCallback, type JobCompletionResult, type JobProgressCallback, type LatestVersionMeta, 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 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 };