Skip to content

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.

feat: allow disabling provider update checks (#3130)

Ulises Britos5d4e2fae012b
diff --git a/apps/server/src/provider/Drivers/ClaudeDriver.ts b/apps/server/src/provider/Drivers/ClaudeDriver.ts
index b126028f8..f2b04b3a2 100644
--- a/apps/server/src/provider/Drivers/ClaudeDriver.ts
+++ b/apps/server/src/provider/Drivers/ClaudeDriver.ts
@@ -20,12 +20,12 @@ import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
import { HttpClient } from "effect/unstable/http";
import { ChildProcessSpawner } from "effect/unstable/process";
import { makeClaudeTextGeneration } from "../../textGeneration/ClaudeTextGeneration.ts";
import { ServerConfig } from "../../config.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
import { ProviderDriverError } from "../Errors.ts";
import { makeClaudeAdapter } from "../Layers/ClaudeAdapter.ts";
import {
@@ -48,6 +48,11 @@ import {
normalizeCommandPath,
resolveProviderMaintenanceCapabilitiesEffect,
} from "../providerMaintenance.ts";
+import {
+ haveProviderSnapshotSettingsChanged,
+ makeProviderSnapshotSettingsSource,
+ type ProviderSnapshotSettings,
+} from "../providerUpdateSettings.ts";
import { makeClaudeCapabilitiesCacheKey, makeClaudeContinuationGroupKey } from "./ClaudeHome.ts";
const decodeClaudeSettings = Schema.decodeSync(ClaudeSettings);
@@ -83,7 +88,8 @@ export type ClaudeDriverEnv =
| HttpClient.HttpClient
| Path.Path
| ProviderEventLoggers
- | ServerConfig;
+ | ServerConfig
+ | ServerSettingsService;
const withInstanceIdentity =
(input: {
@@ -114,6 +120,7 @@ export const ClaudeDriver: ProviderDriver<ClaudeSettings, ClaudeDriverEnv> = {
const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
const path = yield* Path.Path;
const httpClient = yield* HttpClient.HttpClient;
+ const serverSettings = yield* ServerSettingsService;
const eventLoggers = yield* ProviderEventLoggers;
const processEnv = mergeProviderInstanceEnvironment(environment);
const fallbackContinuationIdentity = defaultProviderContinuationIdentity({
@@ -163,16 +170,19 @@ export const ClaudeDriver: ProviderDriver<ClaudeSettings, ClaudeDriverEnv> = {
Effect.provideService(Path.Path, path),
);
- const snapshot = yield* makeManagedServerProvider<ClaudeSettings>({
+ const snapshotSettings = makeProviderSnapshotSettingsSource(effectiveConfig, serverSettings);
+ const snapshot = yield* makeManagedServerProvider<ProviderSnapshotSettings<ClaudeSettings>>({
maintenanceCapabilities,
- getSettings: Effect.succeed(effectiveConfig),
- streamSettings: Stream.never,
- haveSettingsChanged: () => false,
+ getSettings: snapshotSettings.getSettings,
+ streamSettings: snapshotSettings.streamSettings,
+ haveSettingsChanged: haveProviderSnapshotSettingsChanged,
initialSnapshot: (settings) =>
- makePendingClaudeProvider(settings).pipe(Effect.map(stampIdentity)),
+ makePendingClaudeProvider(settings.provider).pipe(Effect.map(stampIdentity)),
checkProvider,
- enrichSnapshot: ({ snapshot, publishSnapshot }) =>
- enrichProviderSnapshotWithVersionAdvisory(snapshot, maintenanceCapabilities).pipe(
+ enrichSnapshot: ({ settings, snapshot, publishSnapshot }) =>
+ enrichProviderSnapshotWithVersionAdvisory(snapshot, maintenanceCapabilities, {
+ enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
+ }).pipe(
Effect.provideService(HttpClient.HttpClient, httpClient),
Effect.flatMap((enrichedSnapshot) => publishSnapshot(enrichedSnapshot)),
),
diff --git a/apps/server/src/provider/Drivers/CodexDriver.ts b/apps/server/src/provider/Drivers/CodexDriver.ts
index 441edda47..ffcc94ca7 100644
--- a/apps/server/src/provider/Drivers/CodexDriver.ts
+++ b/apps/server/src/provider/Drivers/CodexDriver.ts
@@ -28,12 +28,12 @@ import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
import { HttpClient } from "effect/unstable/http";
import { ChildProcessSpawner } from "effect/unstable/process";
import { makeCodexTextGeneration } from "../../textGeneration/CodexTextGeneration.ts";
import { ServerConfig } from "../../config.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
import { ProviderDriverError } from "../Errors.ts";
import { makeCodexAdapter } from "../Layers/CodexAdapter.ts";
import { checkCodexProviderStatus, makePendingCodexProvider } from "../Layers/CodexProvider.ts";
@@ -47,6 +47,11 @@ import {
makePackageManagedProviderMaintenanceResolver,
resolveProviderMaintenanceCapabilitiesEffect,
} from "../providerMaintenance.ts";
+import {
+ haveProviderSnapshotSettingsChanged,
+ makeProviderSnapshotSettingsSource,
+ type ProviderSnapshotSettings,
+} from "../providerUpdateSettings.ts";
import {
codexContinuationIdentity,
materializeCodexShadowHome,
@@ -75,7 +80,8 @@ export type CodexDriverEnv =
| HttpClient.HttpClient
| Path.Path
| ProviderEventLoggers
- | ServerConfig;
+ | ServerConfig
+ | ServerSettingsService;
/**
* Stamp instance identity onto a `ServerProvider` snapshot produced by the
@@ -111,6 +117,7 @@ export const CodexDriver: ProviderDriver<CodexSettings, CodexDriverEnv> = {
Effect.gen(function* () {
const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
const httpClient = yield* HttpClient.HttpClient;
+ const serverSettings = yield* ServerSettingsService;
const eventLoggers = yield* ProviderEventLoggers;
const processEnv = mergeProviderInstanceEnvironment(environment);
const homeLayout = yield* resolveCodexHomeLayout(config);
@@ -163,16 +170,19 @@ export const CodexDriver: ProviderDriver<CodexSettings, CodexDriverEnv> = {
Effect.map(stampIdentity),
Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner),
);
- const snapshot = yield* makeManagedServerProvider<CodexSettings>({
+ const snapshotSettings = makeProviderSnapshotSettingsSource(effectiveConfig, serverSettings);
+ const snapshot = yield* makeManagedServerProvider<ProviderSnapshotSettings<CodexSettings>>({
maintenanceCapabilities,
- getSettings: Effect.succeed(effectiveConfig),
- streamSettings: Stream.never,
- haveSettingsChanged: () => false,
+ getSettings: snapshotSettings.getSettings,
+ streamSettings: snapshotSettings.streamSettings,
+ haveSettingsChanged: haveProviderSnapshotSettingsChanged,
initialSnapshot: (settings) =>
- makePendingCodexProvider(settings).pipe(Effect.map(stampIdentity)),
+ makePendingCodexProvider(settings.provider).pipe(Effect.map(stampIdentity)),
checkProvider,
- enrichSnapshot: ({ snapshot, publishSnapshot }) =>
- enrichProviderSnapshotWithVersionAdvisory(snapshot, maintenanceCapabilities).pipe(
+ enrichSnapshot: ({ settings, snapshot, publishSnapshot }) =>
+ enrichProviderSnapshotWithVersionAdvisory(snapshot, maintenanceCapabilities, {
+ enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
+ }).pipe(
Effect.provideService(HttpClient.HttpClient, httpClient),
Effect.flatMap((enrichedSnapshot) => publishSnapshot(enrichedSnapshot)),
),
diff --git a/apps/server/src/provider/Drivers/CursorDriver.ts b/apps/server/src/provider/Drivers/CursorDriver.ts
index ba532864c..c394a7d1b 100644
--- a/apps/server/src/provider/Drivers/CursorDriver.ts
+++ b/apps/server/src/provider/Drivers/CursorDriver.ts
@@ -18,11 +18,11 @@ import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
import { HttpClient } from "effect/unstable/http";
import { ChildProcessSpawner } from "effect/unstable/process";
import { ServerConfig } from "../../config.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
import { makeCursorTextGeneration } from "../../textGeneration/CursorTextGeneration.ts";
import { ProviderDriverError } from "../Errors.ts";
import { makeCursorAdapter } from "../Layers/CursorAdapter.ts";
@@ -45,6 +45,11 @@ import {
makeStaticProviderMaintenanceResolver,
resolveProviderMaintenanceCapabilitiesEffect,
} from "../providerMaintenance.ts";
+import {
+ haveProviderSnapshotSettingsChanged,
+ makeProviderSnapshotSettingsSource,
+ type ProviderSnapshotSettings,
+} from "../providerUpdateSettings.ts";
const decodeCursorSettings = Schema.decodeSync(CursorSettings);
const DRIVER_KIND = ProviderDriverKind.make("cursor");
@@ -66,7 +71,8 @@ export type CursorDriverEnv =
| HttpClient.HttpClient
| Path.Path
| ProviderEventLoggers
- | ServerConfig;
+ | ServerConfig
+ | ServerSettingsService;
const withInstanceIdentity =
(input: {
@@ -98,6 +104,7 @@ export const CursorDriver: ProviderDriver<CursorSettings, CursorDriverEnv> = {
const fileSystem = yield* FileSystem.FileSystem;
const path = yield* Path.Path;
const httpClient = yield* HttpClient.HttpClient;
+ const serverSettings = yield* ServerSettingsService;
const eventLoggers = yield* ProviderEventLoggers;
const processEnv = mergeProviderInstanceEnvironment(environment);
const continuationIdentity = defaultProviderContinuationIdentity({
@@ -130,21 +137,23 @@ export const CursorDriver: ProviderDriver<CursorSettings, CursorDriverEnv> = {
Effect.provideService(Path.Path, path),
);
- const snapshot = yield* makeManagedServerProvider<CursorSettings>({
+ const snapshotSettings = makeProviderSnapshotSettingsSource(effectiveConfig, serverSettings);
+ const snapshot = yield* makeManagedServerProvider<ProviderSnapshotSettings<CursorSettings>>({
maintenanceCapabilities,
- getSettings: Effect.succeed(effectiveConfig),
- streamSettings: Stream.never,
- haveSettingsChanged: () => false,
+ getSettings: snapshotSettings.getSettings,
+ streamSettings: snapshotSettings.streamSettings,
+ haveSettingsChanged: haveProviderSnapshotSettingsChanged,
initialSnapshot: (settings) =>
- buildInitialCursorProviderSnapshot(settings).pipe(Effect.map(stampIdentity)),
+ buildInitialCursorProviderSnapshot(settings.provider).pipe(Effect.map(stampIdentity)),
checkProvider,
// Model catalog and capabilities come exclusively from Cursor's
// list_available_models extension method during provider checks.
enrichSnapshot: ({ settings, snapshot: currentSnapshot, publishSnapshot }) =>
enrichCursorSnapshot({
- settings,
+ settings: settings.provider,
snapshot: currentSnapshot,
maintenanceCapabilities,
+ enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
publishSnapshot,
stampIdentity,
httpClient,
diff --git a/apps/server/src/provider/Drivers/GrokDriver.ts b/apps/server/src/provider/Drivers/GrokDriver.ts
index ab01439ff..d855d1a45 100644
--- a/apps/server/src/provider/Drivers/GrokDriver.ts
+++ b/apps/server/src/provider/Drivers/GrokDriver.ts
@@ -5,11 +5,11 @@ import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
import { HttpClient } from "effect/unstable/http";
import { ChildProcessSpawner } from "effect/unstable/process";
import { ServerConfig } from "../../config.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
import { makeGrokTextGeneration } from "../../textGeneration/GrokTextGeneration.ts";
import { ProviderDriverError } from "../Errors.ts";
import { makeGrokAdapter } from "../Layers/GrokAdapter.ts";
@@ -32,6 +32,11 @@ import {
makeStaticProviderMaintenanceResolver,
resolveProviderMaintenanceCapabilitiesEffect,
} from "../providerMaintenance.ts";
+import {
+ haveProviderSnapshotSettingsChanged,
+ makeProviderSnapshotSettingsSource,
+ type ProviderSnapshotSettings,
+} from "../providerUpdateSettings.ts";
const decodeGrokSettings = Schema.decodeSync(GrokSettings);
const DRIVER_KIND = ProviderDriverKind.make("grok");
@@ -50,7 +55,8 @@ export type GrokDriverEnv =
| HttpClient.HttpClient
| Path.Path
| ProviderEventLoggers
- | ServerConfig;
+ | ServerConfig
+ | ServerSettingsService;
const withInstanceIdentity =
(input: {
@@ -80,6 +86,7 @@ export const GrokDriver: ProviderDriver<GrokSettings, GrokDriverEnv> = {
Effect.gen(function* () {
const spawner = yield* ChildProcessSpawner.ChildProcessSpawner;
const httpClient = yield* HttpClient.HttpClient;
+ const serverSettings = yield* ServerSettingsService;
const eventLoggers = yield* ProviderEventLoggers;
const processEnv = mergeProviderInstanceEnvironment(environment);
const continuationIdentity = defaultProviderContinuationIdentity({
@@ -110,18 +117,20 @@ export const GrokDriver: ProviderDriver<GrokSettings, GrokDriverEnv> = {
Effect.provideService(ChildProcessSpawner.ChildProcessSpawner, spawner),
);
- const snapshot = yield* makeManagedServerProvider<GrokSettings>({
+ const snapshotSettings = makeProviderSnapshotSettingsSource(effectiveConfig, serverSettings);
+ const snapshot = yield* makeManagedServerProvider<ProviderSnapshotSettings<GrokSettings>>({
maintenanceCapabilities,
- getSettings: Effect.succeed(effectiveConfig),
- streamSettings: Stream.never,
- haveSettingsChanged: () => false,
+ getSettings: snapshotSettings.getSettings,
+ streamSettings: snapshotSettings.streamSettings,
+ haveSettingsChanged: haveProviderSnapshotSettingsChanged,
initialSnapshot: (settings) =>
- buildInitialGrokProviderSnapshot(settings).pipe(Effect.map(stampIdentity)),
+ buildInitialGrokProviderSnapshot(settings.provider).pipe(Effect.map(stampIdentity)),
checkProvider,
- enrichSnapshot: ({ snapshot: currentSnapshot, publishSnapshot }) =>
+ enrichSnapshot: ({ settings, snapshot: currentSnapshot, publishSnapshot }) =>
enrichGrokSnapshot({
snapshot: currentSnapshot,
maintenanceCapabilities,
+ enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
publishSnapshot,
httpClient,
}),
diff --git a/apps/server/src/provider/Drivers/OpenCodeDriver.ts b/apps/server/src/provider/Drivers/OpenCodeDriver.ts
index e7216f833..6342d1765 100644
--- a/apps/server/src/provider/Drivers/OpenCodeDriver.ts
+++ b/apps/server/src/provider/Drivers/OpenCodeDriver.ts
@@ -19,12 +19,12 @@ import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Path from "effect/Path";
import * as Schema from "effect/Schema";
-import * as Stream from "effect/Stream";
import { HttpClient } from "effect/unstable/http";
import { ChildProcessSpawner } from "effect/unstable/process";
import { makeOpenCodeTextGeneration } from "../../textGeneration/OpenCodeTextGeneration.ts";
import { ServerConfig } from "../../config.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
import { ProviderDriverError } from "../Errors.ts";
import { makeOpenCodeAdapter } from "../Layers/OpenCodeAdapter.ts";
import {
@@ -47,6 +47,11 @@ import {
normalizeCommandPath,
resolveProviderMaintenanceCapabilitiesEffect,
} from "../providerMaintenance.ts";
+import {
+ haveProviderSnapshotSettingsChanged,
+ makeProviderSnapshotSettingsSource,
+ type ProviderSnapshotSettings,
+} from "../providerUpdateSettings.ts";
const decodeOpenCodeSettings = Schema.decodeSync(OpenCodeSettings);
const DRIVER_KIND = ProviderDriverKind.make("opencode");
@@ -80,7 +85,8 @@ export type OpenCodeDriverEnv =
| OpenCodeRuntime
| Path.Path
| ProviderEventLoggers
- | ServerConfig;
+ | ServerConfig
+ | ServerSettingsService;
const withInstanceIdentity =
(input: {
@@ -111,6 +117,7 @@ export const OpenCodeDriver: ProviderDriver<OpenCodeSettings, OpenCodeDriverEnv>
const openCodeRuntime = yield* OpenCodeRuntime;
const serverConfig = yield* ServerConfig;
const httpClient = yield* HttpClient.HttpClient;
+ const serverSettings = yield* ServerSettingsService;
const eventLoggers = yield* ProviderEventLoggers;
const processEnv = mergeProviderInstanceEnvironment(environment);
const continuationIdentity = defaultProviderContinuationIdentity({
@@ -142,21 +149,26 @@ export const OpenCodeDriver: ProviderDriver<OpenCodeSettings, OpenCodeDriverEnv>
processEnv,
).pipe(Effect.map(stampIdentity), Effect.provideService(OpenCodeRuntime, openCodeRuntime));
- const snapshot = yield* makeManagedServerProvider<OpenCodeSettings>({
- maintenanceCapabilities,
- getSettings: Effect.succeed(effectiveConfig),
- streamSettings: Stream.never,
- haveSettingsChanged: () => false,
- initialSnapshot: (settings) =>
- makePendingOpenCodeProvider(settings).pipe(Effect.map(stampIdentity)),
- checkProvider,
- enrichSnapshot: ({ snapshot, publishSnapshot }) =>
- enrichProviderSnapshotWithVersionAdvisory(snapshot, maintenanceCapabilities).pipe(
- Effect.provideService(HttpClient.HttpClient, httpClient),
- Effect.flatMap((enrichedSnapshot) => publishSnapshot(enrichedSnapshot)),
- ),
- refreshInterval: SNAPSHOT_REFRESH_INTERVAL,
- }).pipe(
+ const snapshotSettings = makeProviderSnapshotSettingsSource(effectiveConfig, serverSettings);
+ const snapshot = yield* makeManagedServerProvider<ProviderSnapshotSettings<OpenCodeSettings>>(
+ {
+ maintenanceCapabilities,
+ getSettings: snapshotSettings.getSettings,
+ streamSettings: snapshotSettings.streamSettings,
+ haveSettingsChanged: haveProviderSnapshotSettingsChanged,
+ initialSnapshot: (settings) =>
+ makePendingOpenCodeProvider(settings.provider).pipe(Effect.map(stampIdentity)),
+ checkProvider,
+ enrichSnapshot: ({ settings, snapshot, publishSnapshot }) =>
+ enrichProviderSnapshotWithVersionAdvisory(snapshot, maintenanceCapabilities, {
+ enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
+ }).pipe(
+ Effect.provideService(HttpClient.HttpClient, httpClient),
+ Effect.flatMap((enrichedSnapshot) => publishSnapshot(enrichedSnapshot)),
+ ),
+ refreshInterval: SNAPSHOT_REFRESH_INTERVAL,
+ },
+ ).pipe(
Effect.mapError(
(cause) =>
new ProviderDriverError({
diff --git a/apps/server/src/provider/Layers/CursorProvider.ts b/apps/server/src/provider/Layers/CursorProvider.ts
index 35d541371..12eb60541 100644
--- a/apps/server/src/provider/Layers/CursorProvider.ts
+++ b/apps/server/src/provider/Layers/CursorProvider.ts
@@ -1106,6 +1106,7 @@ export const enrichCursorSnapshot = (input: {
readonly settings: CursorSettings;
readonly snapshot: ServerProvider;
readonly maintenanceCapabilities: ProviderMaintenanceCapabilities;
+ readonly enableProviderUpdateChecks?: boolean;
readonly publishSnapshot: (snapshot: ServerProvider) => Effect.Effect<void>;
readonly stampIdentity?: (snapshot: ServerProvider) => ServerProvider;
readonly httpClient: HttpClient.HttpClient;
@@ -1117,7 +1118,9 @@ export const enrichCursorSnapshot = (input: {
return Effect.void;
}
- return enrichProviderSnapshotWithVersionAdvisory(snapshot, input.maintenanceCapabilities).pipe(
+ return enrichProviderSnapshotWithVersionAdvisory(snapshot, input.maintenanceCapabilities, {
+ enableProviderUpdateChecks: input.enableProviderUpdateChecks,
+ }).pipe(
Effect.provideService(HttpClient.HttpClient, input.httpClient),
Effect.flatMap((enrichedSnapshot) =>
publishSnapshot(stampIdentity(enrichedSnapshot)).pipe(Effect.as(enrichedSnapshot)),
diff --git a/apps/server/src/provider/Layers/GrokProvider.ts b/apps/server/src/provider/Layers/GrokProvider.ts
index 35611398b..b1c84fb3a 100644
--- a/apps/server/src/provider/Layers/GrokProvider.ts
+++ b/apps/server/src/provider/Layers/GrokProvider.ts
@@ -311,12 +311,15 @@ export const checkGrokProviderStatus = Effect.fn("checkGrokProviderStatus")(func
export const enrichGrokSnapshot = (input: {
readonly snapshot: ServerProvider;
readonly maintenanceCapabilities: ProviderMaintenanceCapabilities;
+ readonly enableProviderUpdateChecks?: boolean;
readonly publishSnapshot: (snapshot: ServerProvider) => Effect.Effect<void>;
readonly httpClient: HttpClient.HttpClient;
}): Effect.Effect<void> => {
const { snapshot, publishSnapshot } = input;
- return enrichProviderSnapshotWithVersionAdvisory(snapshot, input.maintenanceCapabilities).pipe(
+ return enrichProviderSnapshotWithVersionAdvisory(snapshot, input.maintenanceCapabilities, {
+ enableProviderUpdateChecks: input.enableProviderUpdateChecks,
+ }).pipe(
Effect.provideService(HttpClient.HttpClient, input.httpClient),
Effect.flatMap((enrichedSnapshot) => publishSnapshot(enrichedSnapshot)),
Effect.catchCause((cause) =>
diff --git a/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts b/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts
index f2c5892a2..dbfa7faff 100644
--- a/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts
+++ b/apps/server/src/provider/Layers/ProviderInstanceRegistryLive.test.ts
@@ -39,6 +39,7 @@ import * as Layer from "effect/Layer";
import { HttpClient, HttpClientResponse } from "effect/unstable/http";
import { ServerConfig } from "../../config.ts";
+import { ServerSettingsService } from "../../serverSettings.ts";
import { ClaudeDriver } from "../Drivers/ClaudeDriver.ts";
import { CodexDriver } from "../Drivers/CodexDriver.ts";
import { CursorDriver } from "../Drivers/CursorDriver.ts";
@@ -107,6 +108,7 @@ describe("ProviderInstanceRegistryLive — multi-instance codex slice", () => {
prefix: "provider-instance-registry-test",
}).pipe(
Layer.provideMerge(NodeServices.layer),
+ Layer.provideMerge(ServerSettingsService.layerTest()),
Layer.provideMerge(TestHttpClientLive),
Layer.provideMerge(Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers)),
);
@@ -244,6 +246,7 @@ describe("ProviderInstanceRegistryLive — all drivers slice", () => {
prefix: "provider-instance-registry-all-drivers-test",
}).pipe(
Layer.provideMerge(infraLayer),
+ Layer.provideMerge(ServerSettingsService.layerTest()),
Layer.provideMerge(TestHttpClientLive),
Layer.provideMerge(Layer.succeed(ProviderEventLoggers, NoOpProviderEventLoggers)),
);
diff --git a/apps/server/src/provider/makeManagedServerProvider.ts b/apps/server/src/provider/makeManagedServerProvider.ts
index 88547fb3a..bbf301fa4 100644
--- a/apps/server/src/provider/makeManagedServerProvider.ts
+++ b/apps/server/src/provider/makeManagedServerProvider.ts
@@ -21,7 +21,7 @@ export const makeManagedServerProvider = Effect.fn("makeManagedServerProvider")(
Settings,
>(input: {
readonly maintenanceCapabilities: ServerProviderShape["maintenanceCapabilities"];
- readonly getSettings: Effect.Effect<Settings>;
+ readonly getSettings: Effect.Effect<Settings, ServerSettingsError>;
readonly streamSettings: Stream.Stream<Settings>;
readonly haveSettingsChanged: (previous: Settings, next: Settings) => boolean;
readonly initialSnapshot: (settings: Settings) => Effect.Effect<ServerProvider>;
diff --git a/apps/server/src/provider/providerMaintenance.test.ts b/apps/server/src/provider/providerMaintenance.test.ts
index c4ad2fa75..1018d123b 100644
--- a/apps/server/src/provider/providerMaintenance.test.ts
+++ b/apps/server/src/provider/providerMaintenance.test.ts
@@ -4,13 +4,14 @@ import { chmodSync, mkdirSync, symlinkSync, writeFileSync } from "node:fs";
import * as NodeServices from "@effect/platform-node/NodeServices";
import * as NodeOS from "node:os";
import path from "node:path";
-import { ProviderDriverKind } from "@t3tools/contracts";
+import { ProviderDriverKind, ProviderInstanceId, type ServerProvider } from "@t3tools/contracts";
import { HostProcessPlatform } from "@t3tools/shared/hostProcess";
import * as Crypto from "effect/Crypto";
import * as Effect from "effect/Effect";
import { HttpClient } from "effect/unstable/http";
import {
createProviderVersionAdvisory,
+ enrichProviderSnapshotWithVersionAdvisory,
makePackageManagedProviderMaintenanceResolver,
makeProviderMaintenanceCapabilities,
makeStaticProviderMaintenanceResolver,
@@ -67,6 +68,19 @@ const staticToolUpdate = makeStaticProviderMaintenanceResolver(
updateLockKey: "static-tool",
}),
);
+const installedPackageToolProvider: ServerProvider = {
+ instanceId: ProviderInstanceId.make("packageTool"),
+ driver: driver("packageTool"),
+ enabled: true,
+ installed: true,
+ version: "1.0.0",
+ status: "ready",
+ auth: { status: "authenticated" },
+ checkedAt: "2026-04-10T00:00:00.000Z",
+ models: [],
+ slashCommands: [],
+ skills: [],
+};
it.layer(NodeServices.layer)("providerMaintenance", (it) => {
it.effect("reads cached versions through the injectable cache reference", () =>
@@ -95,6 +109,32 @@ it.layer(NodeServices.layer)("providerMaintenance", (it) => {
),
);
+ it.effect("does not fetch latest provider versions when update checks are disabled", () =>
+ enrichProviderSnapshotWithVersionAdvisory(
+ installedPackageToolProvider,
+ packageToolUpdate.resolve(),
+ {
+ enableProviderUpdateChecks: false,
+ },
+ ).pipe(
+ Effect.provideService(ProviderVersionCache, new Map()),
+ Effect.provideService(
+ HttpClient.HttpClient,
+ HttpClient.make(() =>
+ Effect.die("disabled provider update checks should not make an HTTP request"),
+ ),
+ ),
+ Effect.map((provider) => {
+ expect(provider.versionAdvisory).toMatchObject({
+ status: "unknown",
+ currentVersion: "1.0.0",
+ latestVersion: null,
+ checkedAt: "2026-04-10T00:00:00.000Z",
+ });
+ }),
+ ),
+ );
+
it("marks providers with unknown current versions as unknown", () => {
expect(
createProviderVersionAdvisory({
diff --git a/apps/server/src/provider/providerMaintenance.ts b/apps/server/src/provider/providerMaintenance.ts
index d1c4a7d6a..8645f9f94 100644
--- a/apps/server/src/provider/providerMaintenance.ts
+++ b/apps/server/src/provider/providerMaintenance.ts
@@ -468,10 +468,21 @@ export const resolveLatestProviderVersion = Effect.fn("resolveLatestProviderVers
export const enrichProviderSnapshotWithVersionAdvisory = Effect.fn(
"enrichProviderSnapshotWithVersionAdvisory",
-)(function* (snapshot: ServerProvider, maintenanceCapabilities?: ProviderMaintenanceCapabilities) {
+)(function* (
+ snapshot: ServerProvider,
+ maintenanceCapabilities?: ProviderMaintenanceCapabilities,
+ options?: {
+ readonly enableProviderUpdateChecks: boolean | undefined;
+ },
+) {
const capabilities =
maintenanceCapabilities ?? makeManualProviderMaintenanceCapabilities(snapshot.driver);
- if (!snapshot.enabled || !snapshot.installed || !snapshot.version) {
+ const shouldResolveLatestVersion =
+ options?.enableProviderUpdateChecks !== false &&
+ snapshot.enabled &&
+ snapshot.installed &&
+ Boolean(snapshot.version);
+ if (!shouldResolveLatestVersion) {
return {
...snapshot,
versionAdvisory: createProviderVersionAdvisory({
diff --git a/apps/server/src/provider/providerUpdateSettings.ts b/apps/server/src/provider/providerUpdateSettings.ts
new file mode 100644
index 000000000..564af26c7
--- /dev/null
+++ b/apps/server/src/provider/providerUpdateSettings.ts
@@ -0,0 +1,43 @@
+import type { ServerSettings, ServerSettingsError } from "@t3tools/contracts";
+import * as Effect from "effect/Effect";
+import * as Equal from "effect/Equal";
+import * as Stream from "effect/Stream";
+
+import type { ServerSettingsShape } from "../serverSettings.ts";
+
+export interface ProviderSnapshotSettings<Settings> {
+ readonly provider: Settings;
+ readonly enableProviderUpdateChecks: boolean;
+}
+
+export function makeProviderSnapshotSettings<Settings>(
+ provider: Settings,
+ settings: ServerSettings,
+): ProviderSnapshotSettings<Settings> {
+ return {
+ provider,
+ enableProviderUpdateChecks: settings.enableProviderUpdateChecks,
+ };
+}
+
+export function haveProviderSnapshotSettingsChanged<Settings>(
+ previous: ProviderSnapshotSettings<Settings>,
+ next: ProviderSnapshotSettings<Settings>,
+): boolean {
+ return !Equal.equals(previous, next);
+}
+
+export function makeProviderSnapshotSettingsSource<Settings>(
+ provider: Settings,
+ serverSettings: ServerSettingsShape,
+): {
+ readonly getSettings: Effect.Effect<ProviderSnapshotSettings<Settings>, ServerSettingsError>;
+ readonly streamSettings: Stream.Stream<ProviderSnapshotSettings<Settings>>;
+} {
+ const mapSettings = (settings: ServerSettings) =>
+ makeProviderSnapshotSettings(provider, settings);
+ return {
+ getSettings: serverSettings.getSettings.pipe(Effect.map(mapSettings)),
+ streamSettings: serverSettings.streamChanges.pipe(Stream.map(mapSettings)),
+ };
+}
diff --git a/apps/web/src/components/settings/SettingsPanels.tsx b/apps/web/src/components/settings/SettingsPanels.tsx
index 71311c10d..5ecf009a0 100644
--- a/apps/web/src/components/settings/SettingsPanels.tsx
+++ b/apps/web/src/components/settings/SettingsPanels.tsx
@@ -668,6 +668,33 @@ export function GeneralSettingsPanel() {
}
/>
+ <SettingsRow
+ title="Provider update checks"
+ description="Check installed provider CLIs for newer available versions."
+ resetAction={
+ settings.enableProviderUpdateChecks !==
+ DEFAULT_UNIFIED_SETTINGS.enableProviderUpdateChecks ? (
+ <SettingResetButton
+ label="provider update checks"
+ onClick={() =>
+ updateSettings({
+ enableProviderUpdateChecks: DEFAULT_UNIFIED_SETTINGS.enableProviderUpdateChecks,
+ })
+ }
+ />
+ ) : null
+ }
+ control={
+ <Switch
+ checked={settings.enableProviderUpdateChecks}
+ onCheckedChange={(checked) =>
+ updateSettings({ enableProviderUpdateChecks: Boolean(checked) })
+ }
+ aria-label="Check provider versions"
+ />
+ }
+ />
+
<SettingsRow
title="Auto-open task panel"
description="Open the right-side plan and task panel automatically when steps appear."
diff --git a/packages/contracts/src/settings.ts b/packages/contracts/src/settings.ts
index 0463a4417..1cb57a982 100644
--- a/packages/contracts/src/settings.ts
+++ b/packages/contracts/src/settings.ts
@@ -365,6 +365,7 @@ export const DEFAULT_AUTOMATIC_GIT_FETCH_INTERVAL = Duration.seconds(30);
export const ServerSettings = Schema.Struct({
enableAssistantStreaming: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(false))),
+ enableProviderUpdateChecks: Schema.Boolean.pipe(Schema.withDecodingDefault(Effect.succeed(true))),
automaticGitFetchInterval: Schema.DurationFromMillis.pipe(
Schema.withDecodingDefault(
Effect.succeed(Duration.toMillis(DEFAULT_AUTOMATIC_GIT_FETCH_INTERVAL)),
@@ -482,6 +483,7 @@ const OpenCodeSettingsPatch = Schema.Struct({
export const ServerSettingsPatch = Schema.Struct({
// Server settings
enableAssistantStreaming: Schema.optionalKey(Schema.Boolean),
+ enableProviderUpdateChecks: Schema.optionalKey(Schema.Boolean),
automaticGitFetchInterval: Schema.optionalKey(Schema.DurationFromMillis),
defaultThreadEnvMode: Schema.optionalKey(ThreadEnvMode),
newWorktreesStartFromOrigin: Schema.optionalKey(Schema.Boolean),