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.
/**
* ProviderRegistry - Provider snapshot service.
*
* Owns provider install/auth/version/model snapshots and exposes the latest
* provider state to transport layers.
*
* @module ProviderRegistry
*/
import type {
ProviderInstanceId,
ProviderDriverKind,
ServerProvider,
ServerProviderUpdateState,
} from "@akeru/contracts";
import * as Context from "effect/Context";
import type * as Effect from "effect/Effect";
import type * as Stream from "effect/Stream";
import type { ProviderMaintenanceCapabilities } from "../providerMaintenance.ts";
export type ProviderMaintenanceActionKind = "update";
export interface ProviderRegistryShape {
/**
* Read the latest provider snapshots for every configured instance.
* Multiple snapshots may share the same `provider` kind (multiple
* instances of the same driver) and disambiguate via `instanceId`.
*/
readonly getProviders: Effect.Effect<ReadonlyArray<ServerProvider>>;
/**
* Refresh all providers, or the default instance of the specified
* kind when supplied.
*
* Retained for back-compat with legacy call sites (WS refresh RPC,
* orchestration metrics). New code should prefer `refreshInstance`.
*
* @deprecated prefer `refreshInstance` for new call sites.
*/
readonly refresh: (provider?: ProviderDriverKind) => Effect.Effect<ReadonlyArray<ServerProvider>>;
/**
* Refresh the specific configured instance. Returns the updated snapshot
* list. When the instance id is unknown the call resolves with the
* currently cached list (no error) — matching the legacy `refresh` shim
* behaviour so transport layers don't have to special-case unknowns.
*/
readonly refreshInstance: (
instanceId: ProviderInstanceId,
) => Effect.Effect<ReadonlyArray<ServerProvider>>;
/**
* Resolve the maintenance capabilities owned by one live provider instance.
* Falls back to manual-only capabilities when the instance is not live.
*/
readonly getProviderMaintenanceCapabilitiesForInstance: (
instanceId: ProviderInstanceId,
provider: ProviderDriverKind,
) => Effect.Effect<ProviderMaintenanceCapabilities>;
/**
* Apply volatile maintenance-action state to one configured instance.
* This state is never persisted to disk. Today only update actions are
* projected onto `ServerProvider.updateState`; install/auth actions can
* extend this action map without adding driver-scoped APIs.
*/
readonly setProviderMaintenanceActionState: (input: {
readonly instanceId: ProviderInstanceId;
readonly action: ProviderMaintenanceActionKind;
readonly state: ServerProviderUpdateState | null;
}) => Effect.Effect<ReadonlyArray<ServerProvider>>;
/**
* Stream of provider snapshot updates — one emission per aggregated
* change. The array contains the full current state.
*/
readonly streamChanges: Stream.Stream<ReadonlyArray<ServerProvider>>;
}
export class ProviderRegistry extends Context.Service<ProviderRegistry, ProviderRegistryShape>()(
"akeru-bot/provider/Services/ProviderRegistry",
) {}