feat(coding-agent): expose dynamic provider refresh

packages/ai/src/models-store.ts

@@ -1,35 +1,38 @@
 import type { Api, Model } from "./types.ts";
 
+export interface ModelsStoreEntry {
+	models: readonly Model<Api>[];
+	/** Unix timestamp of the last completed remote check. */
+	checkedAt?: number;
+}
+
 /** Persistent model catalogs keyed by provider ID. */
 export interface ModelsStore {
-	read(providerId: string): Promise<readonly Model<Api>[] | undefined>;
-	write(providerId: string, models: readonly Model<Api>[]): Promise<void>;
+	read(providerId: string): Promise<ModelsStoreEntry | undefined>;
+	write(providerId: string, entry: ModelsStoreEntry): Promise<void>;
 	delete(providerId: string): Promise<void>;
 }
 
 /** ModelsStore scoped to one provider. Providers cannot access other providers' catalogs. */
 export interface ProviderModelsStore {
-	read(): Promise<readonly Model<Api>[] | undefined>;
-	write(models: readonly Model<Api>[]): Promise<void>;
+	read(): Promise<ModelsStoreEntry | undefined>;
+	write(entry: ModelsStoreEntry): Promise<void>;
 	delete(): Promise<void>;
 }
 
 export class InMemoryModelsStore implements ModelsStore {
-	private readonly models = new Map<string, readonly Model<Api>[]>();
+	private readonly entries = new Map<string, ModelsStoreEntry>();
 
-	async read(providerId: string): Promise<readonly Model<Api>[] | undefined> {
-		const models = this.models.get(providerId);
-		return models?.map((model) => structuredClone(model));
+	async read(providerId: string): Promise<ModelsStoreEntry | undefined> {
+		const entry = this.entries.get(providerId);
+		return entry ? structuredClone(entry) : undefined;
 	}
 
-	async write(providerId: string, models: readonly Model<Api>[]): Promise<void> {
-		this.models.set(
-			providerId,
-			models.map((model) => structuredClone(model)),
-		);
+	async write(providerId: string, entry: ModelsStoreEntry): Promise<void> {
+		this.entries.set(providerId, structuredClone(entry));
 	}
 
 	async delete(providerId: string): Promise<void> {
-		this.models.delete(providerId);
+		this.entries.delete(providerId);
 	}
 }