Open-source Grok Bot alternative for named AI teammates. Local-first desktop, web, and mobile clients with per-bot tools, instructions, and memory. Independent fork of T3 Code.
/**
* ProviderInstanceRegistryMutator — internal handle used by the hydration
* layer to reconcile the live registry with a fresh
* `ProviderInstanceConfigMap`.
*
* Kept separate from the public `ProviderInstanceRegistry` service tag so
* downstream consumers (drivers, reactors, `ProviderService`) can only read
* from the registry. Only the hydration layer — which watches
* `ServerSettingsService.streamChanges` and applies diffs — imports this
* tag.
*
* The mutator exposes a single entry point, `reconcile(configMap)`, which:
*
* 1. Diffs the incoming map against the live one keyed by instance id.
* 2. Closes the per-instance `Scope` of every removed or replaced entry
* (tearing down adapter processes, refresh fibres, temp files) BEFORE
* creating the replacement — `reconcile` guarantees "at most one live
* instance per id" at all times.
* 3. Opens a fresh child `Scope` for every added or replaced entry, runs
* the driver's `create`, and stores the resulting `ProviderInstance`
* plus its scope.
* 4. Publishes one `void` tick on the registry's `streamChanges` PubSub at
* the end of the batch — consumers re-pull `listInstances` /
* `listUnavailable`.
*
* `reconcile` is idempotent: calling it with an unchanged config map is a
* no-op (no scope churn, no pubsub emission).
*
* @module provider/Services/ProviderInstanceRegistryMutator
*/
import type { ProviderInstanceConfigMap } from "@akeru/contracts";
import * as Context from "effect/Context";
import type * as Effect from "effect/Effect";
export interface ProviderInstanceRegistryMutatorShape {
/**
* Bring the live registry in line with the supplied config map. See
* module docs for the add / remove / replace semantics.
*
* The effect never fails: individual driver `create` failures are
* captured as "unavailable" shadow snapshots inside the registry, the
* same way boot-time failures are handled by
* `makeProviderInstanceRegistry`. This keeps settings-watcher loops from
* erroring out on a single bad entry.
*/
readonly reconcile: (configMap: ProviderInstanceConfigMap) => Effect.Effect<void>;
}
export class ProviderInstanceRegistryMutator extends Context.Service<
ProviderInstanceRegistryMutator,
ProviderInstanceRegistryMutatorShape
>()("akeru-bot/provider/Services/ProviderInstanceRegistryMutator") {}