@xopcai/xopc 0.0.161 → 0.0.163

package/dist/src/browser/recipes/repository.js

@@ -0,0 +1,81 @@
+import { getSqliteDatabase, runSqliteWriteTransaction } from "../../storage/sqlite/transaction.js";
+//#region src/browser/recipes/repository.ts
+const RECIPE_SELECT = `SELECT recipe_id, revision, name, description, status, yaml_source, risk_level, domains_json, created_at_ms, updated_at_ms FROM browser_recipes`;
+const RUN_SELECT = `SELECT run_id, recipe_id, recipe_revision, recipe_yaml, status, args_json, result_json, error, created_at_ms, started_at_ms, ended_at_ms, duration_ms FROM browser_recipe_runs`;
+function recipeFromRow(row) {
+	return {
+		id: row.recipe_id,
+		revision: row.revision,
+		name: row.name,
+		description: row.description ?? void 0,
+		status: row.status,
+		yaml: row.yaml_source,
+		risk: row.risk_level,
+		domains: JSON.parse(row.domains_json),
+		createdAtMs: row.created_at_ms,
+		updatedAtMs: row.updated_at_ms
+	};
+}
+function runFromRow(row) {
+	return {
+		id: row.run_id,
+		recipeId: row.recipe_id,
+		recipeRevision: row.recipe_revision,
+		recipeYaml: row.recipe_yaml,
+		status: row.status,
+		args: JSON.parse(row.args_json),
+		result: row.result_json ? JSON.parse(row.result_json) : void 0,
+		error: row.error ?? void 0,
+		createdAtMs: row.created_at_ms,
+		startedAtMs: row.started_at_ms ?? void 0,
+		endedAtMs: row.ended_at_ms ?? void 0,
+		durationMs: row.duration_ms ?? void 0
+	};
+}
+function listBrowserRecipes() {
+	return getSqliteDatabase().prepare(`${RECIPE_SELECT} ORDER BY updated_at_ms DESC`).all().map(recipeFromRow);
+}
+function getBrowserRecipe(id) {
+	const row = getSqliteDatabase().prepare(`${RECIPE_SELECT} WHERE recipe_id = ?`).get(id);
+	return row ? recipeFromRow(row) : null;
+}
+function saveBrowserRecipe(recipe) {
+	runSqliteWriteTransaction((db) => db.prepare(`INSERT INTO browser_recipes (recipe_id, revision, name, description, status, yaml_source, risk_level, domains_json, created_at_ms, updated_at_ms) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT(recipe_id) DO UPDATE SET revision=excluded.revision, name=excluded.name, description=excluded.description, status=excluded.status, yaml_source=excluded.yaml_source, risk_level=excluded.risk_level, domains_json=excluded.domains_json, updated_at_ms=excluded.updated_at_ms`).run(recipe.id, recipe.revision, recipe.name, recipe.description ?? null, recipe.status, recipe.yaml, recipe.risk, JSON.stringify(recipe.domains), recipe.createdAtMs, recipe.updatedAtMs));
+}
+function deleteBrowserRecipe(id) {
+	return runSqliteWriteTransaction((db) => db.prepare("DELETE FROM browser_recipes WHERE recipe_id = ?").run(id).changes > 0);
+}
+function saveBrowserRecipeRun(run) {
+	runSqliteWriteTransaction((db) => db.prepare(`INSERT INTO browser_recipe_runs (run_id, recipe_id, recipe_revision, recipe_yaml, status, args_json, result_json, error, created_at_ms, started_at_ms, ended_at_ms, duration_ms) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) ON CONFLICT(run_id) DO UPDATE SET status=excluded.status, result_json=excluded.result_json, error=excluded.error, started_at_ms=excluded.started_at_ms, ended_at_ms=excluded.ended_at_ms, duration_ms=excluded.duration_ms`).run(run.id, run.recipeId, run.recipeRevision, run.recipeYaml, run.status, JSON.stringify(run.args), run.result === void 0 ? null : JSON.stringify(run.result), run.error ?? null, run.createdAtMs, run.startedAtMs ?? null, run.endedAtMs ?? null, run.durationMs ?? null));
+}
+function getBrowserRecipeRun(id) {
+	const row = getSqliteDatabase().prepare(`${RUN_SELECT} WHERE run_id = ?`).get(id);
+	return row ? runFromRow(row) : null;
+}
+function listBrowserRecipeRuns(recipeId) {
+	return (recipeId ? getSqliteDatabase().prepare(`${RUN_SELECT} WHERE recipe_id = ? ORDER BY created_at_ms DESC LIMIT 100`).all(recipeId) : getSqliteDatabase().prepare(`${RUN_SELECT} ORDER BY created_at_ms DESC LIMIT 100`).all()).map(runFromRow);
+}
+function hasActiveBrowserRecipeRuns(recipeId) {
+	return Boolean(getSqliteDatabase().prepare(`SELECT 1 FROM browser_recipe_runs WHERE recipe_id = ? AND status IN ('queued', 'running') LIMIT 1`).get(recipeId));
+}
+function listActiveBrowserRecipeRuns() {
+	return getSqliteDatabase().prepare(`${RUN_SELECT} WHERE status IN ('queued', 'running') ORDER BY created_at_ms ASC`).all().map(runFromRow);
+}
+function nextBrowserRecipeRunEventSeq(runId) {
+	return getSqliteDatabase().prepare("SELECT COALESCE(MAX(seq), 0) + 1 AS seq FROM browser_recipe_run_events WHERE run_id = ?").get(runId).seq;
+}
+function appendBrowserRecipeRunEvent(event) {
+	runSqliteWriteTransaction((db) => db.prepare("INSERT INTO browser_recipe_run_events (event_id, run_id, seq, type, data_json, created_at_ms) VALUES (?, ?, ?, ?, ?, ?)").run(event.id, event.runId, event.seq, event.type, event.data === void 0 ? null : JSON.stringify(event.data), event.createdAtMs));
+}
+function listBrowserRecipeRunEvents(runId) {
+	return getSqliteDatabase().prepare("SELECT event_id, run_id, seq, type, data_json, created_at_ms FROM browser_recipe_run_events WHERE run_id = ? ORDER BY seq ASC").all(runId).map((row) => ({
+		id: row.event_id,
+		runId: row.run_id,
+		seq: row.seq,
+		type: row.type,
+		data: row.data_json ? JSON.parse(row.data_json) : void 0,
+		createdAtMs: row.created_at_ms
+	}));
+}
+//#endregion
+export { appendBrowserRecipeRunEvent, deleteBrowserRecipe, getBrowserRecipe, getBrowserRecipeRun, hasActiveBrowserRecipeRuns, listActiveBrowserRecipeRuns, listBrowserRecipeRunEvents, listBrowserRecipeRuns, listBrowserRecipes, nextBrowserRecipeRunEventSeq, saveBrowserRecipe, saveBrowserRecipeRun };

package/dist/src/browser/recipes/runtime-service.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from '../../config/schema.js';
+import { BrowserRecipeService } from './service.js';
+export declare function createRuntimeBrowserRecipeService(deps: {
+    getConfig: () => Config;
+    emit?: (type: string, payload: unknown) => void;
+}): BrowserRecipeService;

package/dist/src/browser/recipes/runtime-service.js

@@ -0,0 +1,30 @@
+import { BrowserManager } from "../manager.js";
+import { resolveBrowserBackendFromConfig } from "../backend-from-config.js";
+import { createBrowserActionRegistry } from "../actions/registry.js";
+import { runBrowserPipeline } from "../pipeline/runner.js";
+import { BrowserRecipeService } from "./service.js";
+//#region src/browser/recipes/runtime-service.ts
+function createRuntimeBrowserRecipeService(deps) {
+	const registry = createBrowserActionRegistry();
+	return new BrowserRecipeService(registry, async ({ yaml, args, signal, onStep }) => {
+		const manager = new BrowserManager({
+			getHeadless: () => false,
+			getBackend: () => resolveBrowserBackendFromConfig(deps.getConfig())
+		});
+		const taskId = `recipe-${Date.now()}`;
+		try {
+			await manager.ensureConnected();
+			return await runBrowserPipeline(yaml, args, {
+				page: manager.getExtensionProvider() ? null : await manager.getPage(taskId),
+				manager,
+				config: deps.getConfig(),
+				taskId,
+				signal
+			}, registry, { onStep });
+		} finally {
+			await manager.shutdown().catch(() => void 0);
+		}
+	}, deps.emit);
+}
+//#endregion
+export { createRuntimeBrowserRecipeService };

package/dist/src/browser/recipes/service.d.ts

@@ -0,0 +1,36 @@
+import { type BrowserRecipeStepEvent } from '../pipeline/runner.js';
+import type { BrowserActionRegistry, BrowserActionResult } from '../actions/types.js';
+import type { BrowserRecipe, BrowserRecipeRun, BrowserRecipeStatus } from './types.js';
+export type BrowserRecipeExecutor = (input: {
+    yaml: string;
+    args: Record<string, unknown>;
+    signal: AbortSignal;
+    onStep: (event: BrowserRecipeStepEvent) => void;
+}) => Promise<BrowserActionResult>;
+export declare class BrowserRecipeService {
+    private readonly registry;
+    private readonly executeRecipe;
+    private readonly emit?;
+    private activeRuns;
+    private executions;
+    private runWaiters;
+    constructor(registry: BrowserActionRegistry, executeRecipe: BrowserRecipeExecutor, emit?: (type: string, payload: unknown) => void);
+    list(): BrowserRecipe[];
+    get(id: string): BrowserRecipe;
+    listRuns(recipeId?: string): BrowserRecipeRun[];
+    getRun(id: string): BrowserRecipeRun;
+    listRunEvents(id: string): import("./types.js").BrowserRecipeRunEvent[];
+    validate(yaml: string): import("../pipeline/runner.js").ValidateResult;
+    save(input: {
+        yaml: string;
+        status?: BrowserRecipeStatus;
+        expectedId?: string;
+    }): BrowserRecipe;
+    remove(id: string): boolean;
+    startRun(recipeId: string, args: Record<string, unknown>): BrowserRecipeRun;
+    cancel(runId: string): boolean;
+    shutdown(): Promise<void>;
+    runAndWait(recipeId: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<BrowserRecipeRun>;
+    private addEvent;
+    private execute;
+}

package/dist/src/browser/recipes/service.js

@@ -0,0 +1,186 @@
+import { validateBrowserPipeline } from "../pipeline/runner.js";
+import { appendBrowserRecipeRunEvent, deleteBrowserRecipe, getBrowserRecipe, getBrowserRecipeRun, hasActiveBrowserRecipeRuns, listActiveBrowserRecipeRuns, listBrowserRecipeRunEvents, listBrowserRecipeRuns, listBrowserRecipes, nextBrowserRecipeRunEventSeq, saveBrowserRecipe, saveBrowserRecipeRun } from "./repository.js";
+import { randomUUID } from "node:crypto";
+//#region src/browser/recipes/service.ts
+var BrowserRecipeService = class {
+	activeRuns = /* @__PURE__ */ new Map();
+	executions = /* @__PURE__ */ new Map();
+	runWaiters = /* @__PURE__ */ new Map();
+	constructor(registry, executeRecipe, emit) {
+		this.registry = registry;
+		this.executeRecipe = executeRecipe;
+		this.emit = emit;
+		for (const run of listActiveBrowserRecipeRuns()) {
+			const endedAtMs = Date.now();
+			const recovered = {
+				...run,
+				status: "failed",
+				error: "Gateway stopped before the run completed",
+				endedAtMs,
+				durationMs: run.startedAtMs ? endedAtMs - run.startedAtMs : void 0
+			};
+			saveBrowserRecipeRun(recovered);
+			this.addEvent(run.id, "run.completed", {
+				status: recovered.status,
+				error: recovered.error
+			});
+		}
+	}
+	list() {
+		return listBrowserRecipes();
+	}
+	get(id) {
+		return getBrowserRecipe(id);
+	}
+	listRuns(recipeId) {
+		return listBrowserRecipeRuns(recipeId);
+	}
+	getRun(id) {
+		return getBrowserRecipeRun(id);
+	}
+	listRunEvents(id) {
+		return listBrowserRecipeRunEvents(id);
+	}
+	validate(yaml) {
+		return validateBrowserPipeline(yaml, this.registry);
+	}
+	save(input) {
+		const validation = this.validate(input.yaml);
+		if (!validation.ok || !validation.document) throw new Error(validation.errors.map((error) => `${error.path}: ${error.message}`).join("\n"));
+		const document = validation.document;
+		if (input.expectedId && document.id !== input.expectedId) throw new Error("Recipe id cannot change");
+		const existing = getBrowserRecipe(document.id);
+		const now = Date.now();
+		const recipe = {
+			id: document.id,
+			revision: (existing?.revision ?? 0) + 1,
+			name: document.name,
+			description: document.description,
+			status: input.status ?? existing?.status ?? "published",
+			yaml: input.yaml,
+			risk: document.risk,
+			domains: document.domains,
+			createdAtMs: existing?.createdAtMs ?? now,
+			updatedAtMs: now
+		};
+		saveBrowserRecipe(recipe);
+		return recipe;
+	}
+	remove(id) {
+		if (hasActiveBrowserRecipeRuns(id)) throw new Error("Cannot delete a browser automation while it is running");
+		return deleteBrowserRecipe(id);
+	}
+	startRun(recipeId, args) {
+		const recipe = getBrowserRecipe(recipeId);
+		if (!recipe) throw new Error("Browser automation not found");
+		if (recipe.status !== "published") throw new Error("Only enabled browser automations can run");
+		if (!this.validate(recipe.yaml).ok) throw new Error("Browser automation is invalid");
+		const run = {
+			id: randomUUID(),
+			recipeId,
+			recipeRevision: recipe.revision,
+			recipeYaml: recipe.yaml,
+			status: "queued",
+			args,
+			createdAtMs: Date.now()
+		};
+		saveBrowserRecipeRun(run);
+		this.addEvent(run.id, "run.queued", { recipeId });
+		const execution = this.execute(run);
+		this.executions.set(run.id, execution);
+		execution.finally(() => this.executions.delete(run.id)).catch(() => void 0);
+		return run;
+	}
+	cancel(runId) {
+		const controller = this.activeRuns.get(runId);
+		if (!controller) return false;
+		controller.abort();
+		return true;
+	}
+	async shutdown() {
+		for (const controller of this.activeRuns.values()) controller.abort();
+		await Promise.allSettled(this.executions.values());
+	}
+	async runAndWait(recipeId, args, signal) {
+		const run = this.startRun(recipeId, args);
+		return new Promise((resolve) => {
+			const onAbort = () => this.cancel(run.id);
+			const complete = (completed) => {
+				signal?.removeEventListener("abort", onAbort);
+				const active = this.runWaiters.get(run.id);
+				active?.delete(complete);
+				if (active?.size === 0) this.runWaiters.delete(run.id);
+				resolve(completed);
+			};
+			const waiters = this.runWaiters.get(run.id) ?? /* @__PURE__ */ new Set();
+			waiters.add(complete);
+			this.runWaiters.set(run.id, waiters);
+			signal?.addEventListener("abort", onAbort, { once: true });
+			if (signal?.aborted) onAbort();
+			const current = this.getRun(run.id);
+			if (current && current.status !== "queued" && current.status !== "running") complete(current);
+		});
+	}
+	addEvent(runId, type, data) {
+		const seq = nextBrowserRecipeRunEventSeq(runId);
+		const event = {
+			id: randomUUID(),
+			runId,
+			seq,
+			type,
+			data,
+			createdAtMs: Date.now()
+		};
+		appendBrowserRecipeRunEvent(event);
+		this.emit?.(`browser.recipe.${type}`, event);
+	}
+	async execute(run) {
+		const controller = new AbortController();
+		this.activeRuns.set(run.id, controller);
+		const startedAtMs = Date.now();
+		let current = {
+			...run,
+			status: "running",
+			startedAtMs
+		};
+		saveBrowserRecipeRun(current);
+		this.addEvent(run.id, "run.started");
+		try {
+			const result = await this.executeRecipe({
+				yaml: run.recipeYaml,
+				args: run.args,
+				signal: controller.signal,
+				onStep: (event) => this.addEvent(run.id, `step.${event.status}`, event)
+			});
+			const endedAtMs = Date.now();
+			current = {
+				...current,
+				status: controller.signal.aborted ? "cancelled" : result.ok ? "succeeded" : "failed",
+				result: result.data,
+				error: result.error?.message,
+				endedAtMs,
+				durationMs: endedAtMs - startedAtMs
+			};
+		} catch (error) {
+			const endedAtMs = Date.now();
+			current = {
+				...current,
+				status: controller.signal.aborted ? "cancelled" : "failed",
+				error: error instanceof Error ? error.message : String(error),
+				endedAtMs,
+				durationMs: endedAtMs - startedAtMs
+			};
+		} finally {
+			saveBrowserRecipeRun(current);
+			this.addEvent(run.id, "run.completed", {
+				status: current.status,
+				error: current.error
+			});
+			this.activeRuns.delete(run.id);
+			for (const resolve of this.runWaiters.get(run.id) ?? []) resolve(current);
+			this.runWaiters.delete(run.id);
+		}
+	}
+};
+//#endregion
+export { BrowserRecipeService };

package/dist/src/browser/recipes/types.d.ts

@@ -0,0 +1,36 @@
+export type BrowserRecipeStatus = 'published' | 'disabled';
+export type BrowserRecipeRunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export interface BrowserRecipe {
+    id: string;
+    revision: number;
+    name: string;
+    description?: string;
+    status: BrowserRecipeStatus;
+    yaml: string;
+    risk: 'read_only' | 'account_write' | 'sensitive';
+    domains: string[];
+    createdAtMs: number;
+    updatedAtMs: number;
+}
+export interface BrowserRecipeRun {
+    id: string;
+    recipeId: string;
+    recipeRevision: number;
+    recipeYaml: string;
+    status: BrowserRecipeRunStatus;
+    args: Record<string, unknown>;
+    result?: unknown;
+    error?: string;
+    createdAtMs: number;
+    startedAtMs?: number;
+    endedAtMs?: number;
+    durationMs?: number;
+}
+export interface BrowserRecipeRunEvent {
+    id: string;
+    runId: string;
+    seq: number;
+    type: string;
+    data?: unknown;
+    createdAtMs: number;
+}

package/dist/src/cli/commands/browser-cli-helpers.js

@@ -3,9 +3,9 @@ import { loadPlaywrightCoreModule } from "../../browser/providers/playwright-doc
 import { BrowserManager } from "../../browser/manager.js";
 import { resolveBrowserBackendFromConfig } from "../../browser/backend-from-config.js";
 import { createBrowserActionRegistry } from "../../browser/actions/registry.js";
-import { loadBrowserPipelineSource } from "../../browser/pipeline/source.js";
-import { runBrowserPipeline, validateBrowserPipelineSource } from "../../browser/pipeline/runner.js";
+import { runBrowserPipeline, validateBrowserPipeline } from "../../browser/pipeline/runner.js";
 import "../../browser/index.js";
+import { readFile } from "node:fs/promises";
 //#region src/cli/commands/browser-cli-helpers.ts
 init_loader();
 let _manager = null;
@@ -57,11 +57,8 @@ async function executeBrowserCliAction(action, args) {
 }
 async function validatePipelineCli(file) {
 	let yamlSource;
-	let sourceLocation;
 	try {
-		const loaded = await loadBrowserPipelineSource(file);
-		yamlSource = loaded.source;
-		sourceLocation = loaded.location;
+		yamlSource = await readFile(file, "utf8");
 	} catch (e) {
 		const msg = e instanceof Error ? e.message : String(e);
 		console.error(`Failed to read pipeline source: ${msg}`);
@@ -69,7 +66,7 @@ async function validatePipelineCli(file) {
 		return;
 	}
 	const registry = createBrowserActionRegistry();
-	const result = await validateBrowserPipelineSource(yamlSource, registry, sourceLocation);
+	const result = validateBrowserPipeline(yamlSource, registry);
 	if (result.ok) console.log(`✓ Pipeline "${result.document.name}" is valid (${result.document.pipeline.length} steps).`);
 	else {
 		console.error("✗ Pipeline validation failed:");
@@ -79,11 +76,8 @@ async function validatePipelineCli(file) {
 }
 async function runPipelineCli(file, args) {
 	let yamlSource;
-	let sourceLocation;
 	try {
-		const loaded = await loadBrowserPipelineSource(file);
-		yamlSource = loaded.source;
-		sourceLocation = loaded.location;
+		yamlSource = await readFile(file, "utf8");
 	} catch (e) {
 		const msg = e instanceof Error ? e.message : String(e);
 		console.error(`Failed to read pipeline source: ${msg}`);
@@ -92,7 +86,7 @@ async function runPipelineCli(file, args) {
 	}
 	const registry = createBrowserActionRegistry();
 	const ctx = await getActionContext();
-	const result = await runBrowserPipeline(yamlSource, args, ctx, registry, { sourceLocation });
+	const result = await runBrowserPipeline(yamlSource, args, ctx, registry);
 	if (result.ok) {
 		if (result.text) console.log(result.text);
 		if (result.data && !result.text) console.log(JSON.stringify(result.data, null, 2));

package/dist/src/cli/commands/browser.js

@@ -38,16 +38,17 @@ function createBrowserCommand(_ctx) {
 			full_page: opts.fullPage
 		});
 	});
-	cmd.command("validate <file>").description("Validate a browser pipeline YAML file or URL without executing").action(async (file) => {
+	cmd.command("validate <file>").description("Validate a Browser Recipe v1 YAML file without executing").action(async (file) => {
 		const { validatePipelineCli } = await import("./browser-cli-helpers.js");
 		await validatePipelineCli(file);
 	});
-	cmd.command("run <file>").description("Run a browser pipeline YAML file or URL").option("--arg <args...>", "Pipeline args (key=value)").action(async (file, opts) => {
+	cmd.command("run <file>").description("Run a Browser Recipe v1 YAML file").option("--arg <args...>", "Recipe args (key=<JSON value>)").action(async (file, opts) => {
 		const { runPipelineCli } = await import("./browser-cli-helpers.js");
 		const args = {};
 		if (opts.arg) for (const a of opts.arg) {
 			const eq = a.indexOf("=");
-			if (eq > 0) args[a.slice(0, eq)] = a.slice(eq + 1);
+			if (eq <= 0) throw new Error(`Invalid --arg: ${a}`);
+			args[a.slice(0, eq)] = JSON.parse(a.slice(eq + 1));
 		}
 		await runPipelineCli(file, args);
 	});

package/dist/src/cli/commands/doctor/checks/database-schema.js

@@ -52,7 +52,7 @@ async function checkDatabaseSchema(ctx) {
 		id: "database-schema",
 		label: "Database schema",
 		status: "pass",
-		message: `SQLite schema v${status.dbVersion} (current release v52).`,
+		message: `SQLite schema v${status.dbVersion} (current release v58).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/models.js

@@ -15,14 +15,11 @@ init_credentials();
 init_schema();
 init_providers();
 const IMAGE_GENERATION_IDS = new Set([
-	"gpt-image-1",
-	"dall-e-3",
-	"dall-e-2",
+	"gpt-image-2",
+	"gpt-image-1.5",
 	"wan2.6-t2i",
 	"wan2.7-image-pro",
 	"wan2.7-image",
-	"wan2.1-t2i-turbo",
-	"wan2.1-t2i-plus",
 	"image-01",
 	"image-01-live"
 ]);

package/dist/src/cli/commands/onboard/model.js

@@ -301,7 +301,7 @@ function resolvePresetEnvCredential(preset) {
 	}
 }
 async function setupDomesticPreset(config, ctx, preset) {
-	console.log(`\n🇨🇳 ${preset.displayName}\n`);
+	console.log(`\n${preset.onboardingIcon ?? "🇨🇳"} ${preset.displayName}\n`);
 	console.log(preset.description);
 	if (preset.quirks?.length) for (const quirk of preset.quirks) console.log(colors.gray(`Note: ${quirk}`));
 	const baseUrlChoice = await select({
@@ -336,13 +336,14 @@ async function setupDomesticPreset(config, ctx, preset) {
 		headers: preset.headers
 	});
 	const modelChoices = discoveredChoices.length > 0 ? discoveredChoices : getModelsForProvider(preset.id);
+	if (preset.requiresModelDiscovery && modelChoices.length === 0) throw new Error(`No models are available from ${preset.displayName}. Ask an administrator to publish a model, then retry.`);
 	const modelRef = await select({
 		message: "Model:",
 		choices: modelChoices.map((choice) => ({
 			...choice,
 			name: modelChoiceName(choice)
 		})),
-		default: `${preset.id}/${preset.defaultModel}`
+		default: preset.defaultModel ? `${preset.id}/${preset.defaultModel}` : modelChoices[0]?.value
 	});
 	const modelId = modelRef.split("/").slice(1).join("/");
 	if (await confirm({

package/dist/src/cli/commands/setup-shared/types.d.ts

@@ -7,7 +7,7 @@
  */
 export type SetupAction = 'add' | 'set' | 'remove' | 'noop';
 export interface SetupError {
-    /** Dot path of the offending field, when known (e.g. `providers.openai.apiKey`). */
+    /** Dot path of the offending field, when known (e.g. `providers.openai.baseUrl`). */
     path?: string;
     message: string;
 }

package/dist/src/config/agent-profile.js

@@ -1,6 +1,6 @@
+import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import "../agent-manifest/index.js";
-import { init_agent_scope, normalizeAgentId, resolveAgentWorkspaceDir } from "../agent/agent-scope.js";
 import { init_session_key, parseSessionKey } from "../routing/session-key.js";
 import { agentExists, getDefaultAgentId, init_resolve_route } from "../routing/resolve-route.js";
 //#region src/config/agent-profile.ts

package/dist/src/config/index.js

@@ -1,7 +1,7 @@
 import { ENV_VARS, XOPC_DB_FILENAME, resolveHomeDir, resolveStateDir, resolveXopcDatabasePath } from "./paths-state.js";
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
-import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CodeIntelligenceConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
+import { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CodeIntelligenceConfigSchema, CommandsConfigSchema, ConfigSchema, ConnectorsConfigSchema, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelCatalogConfigSchema, ModelsDevConfigSchema, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
 import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 import { expandWorkspacePathString, init_workspace_path, normalizeWorkspaceDir, resolveWorkspaceRoot } from "./workspace-path.js";
 import { resolveDefaultAgentWorkspaceDir } from "./workspace-defaults.js";
@@ -27,4 +27,4 @@ init_workspace_path();
 init_models_json();
 init_resolve_config_value();
 //#endregion
-export { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CodeIntelligenceConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, ConnectorsConfigSchema, CustomModelSchema, ENV_VARS, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, USER_MEMORY_FILENAME, USER_PROFILE_FILENAME, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, XOPC_DB_FILENAME, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, hasBundledExtensionManifest, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveUserDir, resolveUserMemoryPath, resolveUserProfilePath, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };
+export { AgentImageGenerationModelSchema, AgentModelRefSchema, AgentModelsSchema, AgentTypedModelRoleSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, BrowserConfigSchema, ChannelsConfigSchema, CodeIntelligenceConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, ConnectorsConfigSchema, CustomModelSchema, ENV_VARS, ExperimentalConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, GoalNotificationEventSchema, GoalNotificationTargetSchema, GoalNotificationsConfigSchema, GoalsConfigSchema, HeartbeatConfigSchema, McpConfigSchema, McpServerSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, MessagesConfigSchema, ModelCatalogConfigSchema, ModelOverrideSchema, ModelsDevConfigSchema, ModelsJsonSchema, OpenAICompatSchema, OpenAICompletionsCompatSchema, OpenAIResponsesCompatSchema, OpenRouterRoutingSchema, ProfileManager, ProviderAuthConfigSchema, ProviderAzureConfigSchema, ProviderConfigSchema, ProviderRequestOverridesSchema, ProvidersConfigSchema, STTConfigSchema, STTFallbackConfigSchema, STTProviderConfigSchema, SearchProviderEntrySchema, SessionConfigSchema, SessionDmScopeSchema, SessionResetByTypeSchema, SessionResetConfigSchema, SessionResetModeSchema, SessionScopeSchema, SessionStorageConfigSchema, TTSConfigSchema, TTSEdgeConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSProviderConfigSchema, TTSSummarizationConfigSchema, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TuiConfigSchema, TunnelConfigSchema, TunnelConsentSchema, USER_MEMORY_FILENAME, USER_PROFILE_FILENAME, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, VoiceConfigSchema, VoiceRefinementConfigSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, XOPC_DB_FILENAME, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultImageGenerationModelConfig, getAgentDefaultImageModelConfig, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, hasBundledExtensionManifest, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentManifestForAgent, resolveEffectiveAgentManifestForSession, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveUserDir, resolveUserMemoryPath, resolveUserProfilePath, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcDatabasePath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, validateModelsConfig };

package/dist/src/config/models-json.d.ts

@@ -292,6 +292,9 @@ export declare const ProviderConfigSchema: z.ZodObject<{
             supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>>;
     }, z.core.$strip>>>;
+    modelDiscovery: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+    }, z.core.$strict>>;
 }, z.core.$strip>;
 export declare const ModelsJsonSchema: z.ZodObject<{
     providers: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -412,6 +415,9 @@ export declare const ModelsJsonSchema: z.ZodObject<{
                 supportsStrictMode: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>>;
         }, z.core.$strip>>>;
+        modelDiscovery: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodBoolean;
+        }, z.core.$strict>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type OpenRouterRouting = z.infer<typeof OpenRouterRoutingSchema>;

package/dist/src/config/models-json.js

@@ -46,11 +46,6 @@ function validateModelsConfig(config) {
 				message: "baseUrl is required when defining custom models",
 				severity: "error"
 			});
-			if (!providerConfig.apiKey) errors.push({
-				path: `providers.${providerName}.apiKey`,
-				message: "apiKey is required when defining custom models",
-				severity: "error"
-			});
 		}
 		if (!hasModels && !hasBaseUrl && !hasModelOverrides && !providerConfig.apiKey) errors.push({
 			path: `providers.${providerName}`,
@@ -247,7 +242,8 @@ var init_models_json = __esmMin((() => {
 		headers: z.record(z.string(), z.string()).optional(),
 		authHeader: z.boolean().optional(),
 		models: z.array(CustomModelSchema).optional(),
-		modelOverrides: z.record(z.string(), ModelOverrideSchema).optional()
+		modelOverrides: z.record(z.string(), ModelOverrideSchema).optional(),
+		modelDiscovery: z.object({ enabled: z.boolean() }).strict().optional()
 	});
 	ModelsJsonSchema = z.object({ providers: z.record(z.string(), ProviderConfigSchema) });
 	PROVIDER_ID_REGEX = /^[a-z0-9]([a-z0-9-_]*[a-z0-9])?$/;