@xopcai/xopc 0.0.231 → 0.0.232

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

@@ -0,0 +1,172 @@
+import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
+import { z } from "zod";
+//#region src/agent-config/schema.ts
+var DEFAULT_AGENT_MODEL_REF, AgentIdSchema, ModelRefSchema, ModelRouteSchema, ImageGenerationRouteSchema, ModelIntentSchema, ModelIntentRoutesSchema, ModelIntentOverridesSchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, ToolModeSchema, ToolPolicySchema, ToolPoliciesSchema, SkillDefaultsSchema, SkillOverrideSchema, WorkflowPolicySchema, RuntimePolicySchema, AgentDefaultsSchema, AgentProfileSchema, AgentEntrySchema, AgentsConfigSchema, EffectiveAgentConfigSchema;
+var init_schema = __esmMin((() => {
+	DEFAULT_AGENT_MODEL_REF = "deepseek/deepseek-v4-flash";
+	AgentIdSchema = z.string().regex(/^[a-z][a-z0-9_-]{0,63}$/);
+	ModelRefSchema = z.string().trim().min(1).refine((value) => {
+		const separator = value.indexOf("/");
+		return separator > 0 && separator < value.length - 1;
+	}, "model must use provider/model format");
+	ModelRouteSchema = z.object({
+		primary: ModelRefSchema,
+		fallbacks: z.array(ModelRefSchema).default([])
+	}).strict();
+	ImageGenerationRouteSchema = ModelRouteSchema.extend({
+		timeoutMs: z.number().int().positive().optional(),
+		autoProviderFallback: z.boolean().default(false)
+	}).strict();
+	ModelIntentSchema = z.enum([
+		"fast",
+		"reasoning",
+		"coding",
+		"review",
+		"vision",
+		"understanding"
+	]);
+	ModelIntentRoutesSchema = z.partialRecord(ModelIntentSchema, ModelRouteSchema);
+	ModelIntentOverridesSchema = z.partialRecord(ModelIntentSchema, ModelRouteSchema.nullable());
+	AgentModelsDefaultsSchema = z.object({
+		chat: ModelRouteSchema,
+		intents: ModelIntentRoutesSchema.default({}),
+		imageUnderstanding: ModelRouteSchema.optional(),
+		imageGeneration: ImageGenerationRouteSchema.optional()
+	}).strict();
+	AgentModelsOverrideSchema = z.object({
+		chat: ModelRouteSchema.optional(),
+		intents: ModelIntentOverridesSchema.optional(),
+		imageUnderstanding: ModelRouteSchema.nullable().optional(),
+		imageGeneration: ImageGenerationRouteSchema.nullable().optional()
+	}).strict();
+	ToolModeSchema = z.enum([
+		"allow",
+		"ask",
+		"deny"
+	]);
+	ToolPolicySchema = z.object({
+		mode: ToolModeSchema,
+		maxCallsPerTurn: z.number().int().positive().optional(),
+		timeoutMs: z.number().int().positive().optional()
+	}).strict();
+	ToolPoliciesSchema = z.record(z.string().min(1), ToolPolicySchema);
+	SkillDefaultsSchema = z.discriminatedUnion("mode", [z.object({
+		mode: z.literal("all-enabled"),
+		exclude: z.array(z.string().min(1)).default([])
+	}).strict(), z.object({
+		mode: z.literal("selected"),
+		include: z.array(z.string().min(1)).default([])
+	}).strict()]);
+	SkillOverrideSchema = z.discriminatedUnion("mode", [z.object({
+		mode: z.literal("merge"),
+		add: z.array(z.string().min(1)).default([]),
+		remove: z.array(z.string().min(1)).default([])
+	}).strict().superRefine((value, context) => {
+		const additions = new Set(value.add);
+		for (const skill of value.remove) if (additions.has(skill)) context.addIssue({
+			code: "custom",
+			path: ["remove"],
+			message: `skill "${skill}" cannot be both added and removed`
+		});
+	}), z.object({
+		mode: z.literal("replace"),
+		include: z.array(z.string().min(1)).default([])
+	}).strict()]);
+	WorkflowPolicySchema = z.object({
+		default: z.string().min(1).optional(),
+		allowed: z.array(z.string().min(1)).optional()
+	}).strict();
+	RuntimePolicySchema = z.object({
+		maxTurns: z.number().int().positive().optional(),
+		timeoutMs: z.number().int().positive().optional(),
+		maxToolFailuresPerTurn: z.number().int().positive().optional(),
+		promptCache: z.object({
+			mode: z.enum(["off", "auto"]).default("auto"),
+			lifetime: z.enum(["short", "long"]).default("short")
+		}).strict().optional()
+	}).strict();
+	AgentDefaultsSchema = z.object({
+		models: AgentModelsDefaultsSchema,
+		skills: SkillDefaultsSchema.default({
+			mode: "all-enabled",
+			exclude: []
+		}),
+		tools: ToolPoliciesSchema.default({}),
+		workflows: WorkflowPolicySchema.default({}),
+		runtime: RuntimePolicySchema.default({})
+	}).strict();
+	AgentProfileSchema = z.object({
+		name: z.string().trim().min(1),
+		instructions: z.string().trim().min(1).optional()
+	}).strict();
+	AgentEntrySchema = z.object({
+		id: AgentIdSchema,
+		enabled: z.boolean().default(true),
+		workspace: z.string().trim().min(1).optional(),
+		profile: AgentProfileSchema.optional(),
+		models: AgentModelsOverrideSchema.optional(),
+		skills: SkillOverrideSchema.optional(),
+		tools: ToolPoliciesSchema.optional(),
+		workflows: WorkflowPolicySchema.optional(),
+		runtime: RuntimePolicySchema.optional()
+	}).strict();
+	AgentsConfigSchema = z.object({
+		default: AgentIdSchema.default("main"),
+		defaults: AgentDefaultsSchema.default({
+			models: {
+				chat: {
+					primary: DEFAULT_AGENT_MODEL_REF,
+					fallbacks: []
+				},
+				intents: {}
+			},
+			skills: {
+				mode: "all-enabled",
+				exclude: []
+			},
+			tools: {},
+			workflows: {},
+			runtime: {}
+		}),
+		list: z.array(AgentEntrySchema).default([{
+			id: "main",
+			enabled: true
+		}])
+	}).strict().superRefine((value, context) => {
+		const seen = /* @__PURE__ */ new Set();
+		value.list.forEach((agent, index) => {
+			if (seen.has(agent.id)) context.addIssue({
+				code: "custom",
+				path: [
+					"list",
+					index,
+					"id"
+				],
+				message: `duplicate agent id "${agent.id}"`
+			});
+			seen.add(agent.id);
+		});
+		if (!value.list.some((agent) => agent.id === value.default && agent.enabled)) context.addIssue({
+			code: "custom",
+			path: ["default"],
+			message: `default agent "${value.default}" must reference an enabled entry`
+		});
+	});
+	EffectiveAgentConfigSchema = z.object({
+		id: AgentIdSchema,
+		enabled: z.boolean(),
+		workspace: z.string().min(1),
+		profile: z.object({
+			name: z.string().min(1),
+			instructions: z.string().optional()
+		}).strict().optional(),
+		models: AgentModelsDefaultsSchema,
+		skills: SkillDefaultsSchema,
+		tools: ToolPoliciesSchema,
+		workflows: WorkflowPolicySchema,
+		runtime: RuntimePolicySchema
+	}).strict();
+}));
+//#endregion
+init_schema();
+export { AgentDefaultsSchema, AgentEntrySchema, AgentModelsDefaultsSchema, AgentModelsOverrideSchema, AgentProfileSchema, AgentsConfigSchema, DEFAULT_AGENT_MODEL_REF, EffectiveAgentConfigSchema, ImageGenerationRouteSchema, ModelIntentSchema, ModelRefSchema, ModelRouteSchema, RuntimePolicySchema, SkillDefaultsSchema, SkillOverrideSchema, ToolModeSchema, ToolPoliciesSchema, ToolPolicySchema, WorkflowPolicySchema, init_schema };

package/dist/src/chat-commands/builtins/config.js

@@ -76,7 +76,7 @@ const configCommand = {
 		"/config show",
 		"/config show agents.list",
 		"/config set agents.default=main",
-		"/config show agents.capabilityPresets",
+		"/config show agents.defaults",
 		"/config unset tts"
 	],
 	handler: async (ctx, args) => {
@@ -176,7 +176,7 @@ const configCommand = {
 			log.info({ path: rest }, "Config key removed via /config unset");
 			return { content: `⚙️ Config updated: \`${rest}\` removed.` };
 		}
-		return { content: "⚙️ *Config Command*\n\n`/config show [path]` — view config (or a specific path)\n`/config set path=value` — update a config value\n`/config unset path` — remove a config key\n\nExamples:\n`/config show agents.list`\n`/config set agents.default=main`\n`/config show agents.capabilityPresets`\n`/config unset tts`" };
+		return { content: "⚙️ *Config Command*\n\n`/config show [path]` — view config (or a specific path)\n`/config set path=value` — update a config value\n`/config unset path` — remove a config key\n\nExamples:\n`/config show agents.list`\n`/config set agents.default=main`\n`/config show agents.defaults`\n`/config unset tts`" };
 	}
 };
 function registerConfigCommand() {

package/dist/src/chat-commands/builtins/review.js

@@ -136,7 +136,7 @@ async function reviewModelRef(ctx) {
 	if (sessionOverride) return sessionOverride;
 	try {
 		const profile = resolveEffectiveAgentProfileForSession(ctx.config, ctx.sessionKey);
-		return profile.manifest.models.roles.review?.model?.trim() || profile.primaryModelRef;
+		return profile.config.models.intents.review?.primary || profile.primaryModelRef;
 	} catch {
 		return;
 	}

package/dist/src/chat-commands/config-paths.js

@@ -3,7 +3,7 @@ function parseConfigPath(raw) {
 	const parts = raw.trim().split(".").map((p) => p.trim());
 	if (parts.some((p) => !p)) return {
 		ok: false,
-		error: "Invalid path. Use dot notation (e.g. agents.list.0.models.defaultRole)."
+		error: "Invalid path. Use dot notation (e.g. agents.defaults.models.chat.primary)."
 	};
 	return {
 		ok: true,

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

@@ -20,7 +20,7 @@ function registerAgentsCli(program) {
 			id: normalizeAgentId(a.id),
 			enabled: a.enabled !== false,
 			workspace: a.workspace,
-			model: a.models.roles[a.models.defaultRole]?.model
+			model: a.models?.chat?.primary ?? cfg.agents.defaults.models.chat.primary
 		}));
 		const def = resolveDefaultAgentId(cfg);
 		if (opts.json) {
@@ -51,6 +51,7 @@ function registerAgentsCli(program) {
 		const next = applyAgentConfig(cfg, {
 			agentId,
 			workspace: opts.workspace.trim(),
+			profile: { name: name.trim() },
 			...opts.model?.trim() ? { model: opts.model.trim() } : {}
 		});
 		await saveConfig(next, resolveConfigPath());

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

@@ -76,7 +76,7 @@ function setNestedValue(obj, path, value) {
 function createConfigCommand(ctx) {
 	const cmd = new Command("config").description("View and edit configuration").option("--show", "Show full configuration (alias for `config show`)").option("--validate", "Validate configuration file (alias for `config validate`)").addHelpText("after", formatExamples([
 		"xopc config get agents.list",
-		"xopc config get agents.capabilityPresets",
+		"xopc config get agents.defaults",
 		"xopc config set agents.default main",
 		"xopc config show",
 		"xopc config validate",

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 v137).`,
+		message: `SQLite schema v${status.dbVersion} (current release v138).`,
 		hints: []
 	};
 }

package/dist/src/cli/commands/doctor/checks/provider-auth.js

@@ -14,12 +14,20 @@ function collectProviderIdsFromConfig(cfg) {
 		if (parsed) ids.add(parsed.provider.toLowerCase());
 	};
 	addRef(getAgentDefaultModelRef(cfg));
-	const addRoles = (roles) => {
-		for (const role of Object.values(roles ?? {})) addRef(role.model);
+	const addRoutes = (routes) => {
+		for (const route of Object.values(routes ?? {})) addRef(route?.primary);
 	};
-	for (const preset of Object.values(cfg.agents.capabilityPresets ?? {})) addRoles(preset.models?.roles);
+	addRef(cfg.agents.defaults.models.chat.primary);
+	addRoutes(cfg.agents.defaults.models.intents);
+	addRef(cfg.agents.defaults.models.imageUnderstanding?.primary);
+	addRef(cfg.agents.defaults.models.imageGeneration?.primary);
 	const list = cfg.agents?.list;
-	if (Array.isArray(list)) for (const e of list) addRoles(e?.models?.roles);
+	if (Array.isArray(list)) for (const e of list) {
+		addRef(e?.models?.chat?.primary);
+		addRoutes(e?.models?.intents);
+		addRef(e?.models?.imageUnderstanding?.primary);
+		addRef(e?.models?.imageGeneration?.primary);
+	}
 	return ids;
 }
 function anyProviderEnvPresent() {

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

@@ -4,11 +4,10 @@ import "../../agent/image/index.js";
 import { Command } from "commander";
 //#region src/cli/commands/image.ts
 function createImageCommand(_ctx) {
-	const cmd = new Command("image").description("Inspect image provider availability").addHelpText("after", formatExamples(["xopc image providers   # List available image generation providers", "xopc image status      # Explain current manifest-era image behavior"]));
+	const cmd = new Command("image").description("Inspect image provider availability").addHelpText("after", formatExamples(["xopc image providers   # List available image generation providers", "xopc image status      # Explain current image behavior"]));
 	cmd.command("status").description("Show image runtime status").action(() => {
-		console.log("Image model defaults were removed.");
-		console.log("Image generation now uses configured providers discovered at runtime.");
-		console.log("Agent-specific capability policy belongs in agent manifests or capability presets.");
+		console.log("Image understanding and generation inherit from agents.defaults.models.");
+		console.log("An agent may override either route in agents.list[].models.");
 	});
 	cmd.command("providers").description("List image generation providers").option("--json", "Output as JSON").action((opts) => {
 		const providers = listImageGenerationProvidersSummary();

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

@@ -47,9 +47,15 @@ function currentModelRef(config) {
 	return getAgentDefaultModelRef(config);
 }
 function setDefaultModel(config, modelRef) {
-	const prep = prepareUpdateGlobalDefaults(config, { models: {
-		defaultRole: "deep",
-		roles: { deep: { model: modelRef } }
+	const prep = prepareUpdateGlobalDefaults(config, { defaults: {
+		...config.agents.defaults,
+		models: {
+			...config.agents.defaults.models,
+			chat: {
+				primary: modelRef,
+				fallbacks: []
+			}
+		}
 	} });
 	if (prep.ok === false) throw new Error(prep.error);
 	return prep.data.nextConfig;

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

@@ -5,11 +5,11 @@ import { getApiKeyFromEnv } from "../../../providers/env-keys.js";
 import { getModelRegistry } from "../../../providers/model-registry.js";
 import { CredentialResolver, init_credentials } from "../../../auth/credentials.js";
 import { getAllProviders, getModelsByProvider, getProviderDisplayName, init_providers, providerSupportsApiKey, providerSupportsOAuth } from "../../../providers/index.js";
-import { getDomesticProviderBaseUrl, getDomesticProviderPreset, getDomesticProviderPresetIds, providerConfigFromDomesticPreset } from "../../../providers/domestic-presets.js";
-import { getProviderHint, getRecommendedModelsForProvider, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
 import { prepareUpdateGlobalDefaults } from "../../../gateway/global-defaults-admin.js";
 import { discoverProviderModels, isProviderApiDiscoverable } from "../../../providers/model-discovery.js";
 import { getXopcCloudCatalogCoordinator } from "../../../providers/xopc-cloud-catalog-coordinator.js";
+import { getDomesticProviderBaseUrl, getDomesticProviderPreset, getDomesticProviderPresetIds, providerConfigFromDomesticPreset } from "../../../providers/domestic-presets.js";
+import { getProviderHint, getRecommendedModelsForProvider, sortModelsForPicker, sortProvidersForPicker } from "../../../providers/presentation.js";
 import { listProfilesForProvider } from "../../../auth/profiles/profiles.js";
 import { getOAuthProvider } from "../../utils/oauth-providers.js";
 import { colors } from "../../utils/colors.js";
@@ -32,7 +32,7 @@ function setPrimaryModel(config, workspacePath, modelRef) {
 		const nextList = [...config.agents.list];
 		nextList[index] = {
 			...agent,
-			workspace: { root: workspacePath }
+			workspace: workspacePath
 		};
 		nextConfig = {
 			...config,
@@ -42,14 +42,15 @@ function setPrimaryModel(config, workspacePath, modelRef) {
 			}
 		};
 	}
-	const presetId = nextConfig.agents.defaultPreset ?? "default";
-	const currentModels = nextConfig.agents.capabilityPresets[presetId]?.models;
-	const prep = prepareUpdateGlobalDefaults(nextConfig, { models: {
-		...currentModels,
-		defaultRole: "deep",
-		roles: {
-			...currentModels?.roles,
-			deep: { model: modelRef }
+	const currentModels = nextConfig.agents.defaults.models;
+	const prep = prepareUpdateGlobalDefaults(nextConfig, { defaults: {
+		...nextConfig.agents.defaults,
+		models: {
+			...currentModels,
+			chat: {
+				primary: modelRef,
+				fallbacks: []
+			}
 		}
 	} });
 	if (prep.ok === false) throw new Error(prep.error);

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

@@ -24,7 +24,7 @@ function printGitHubStarHint() {
 }
 async function setupNonInteractive(_configPath, existingConfig) {
 	console.log("\n🤖 AI Model Configuration (Non-Interactive Mode)\n");
-	console.log("Current agent manifests:", JSON.stringify(existingConfig.agents?.list ?? [], null, 2));
+	console.log("Current agent overrides:", JSON.stringify(existingConfig.agents?.list ?? [], null, 2));
 	console.log("\n💡 To configure in interactive mode, run: xopc onboard");
 	console.log("💡 Or set up manually in:", _configPath);
 	return existingConfig;

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

@@ -5,10 +5,10 @@ import { resolveGatewayEffectiveHost } from "../../config/gateway-bind.js";
 import { loadTunnelState } from "../../tunnel/tunnel-state.js";
 import { formatExamples, register } from "../registry.js";
 import "../../config/index.js";
-import { TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, hasValidTunnelConsent } from "../../tunnel/consent.js";
-import { resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "../../tunnel/env.js";
 import { ensureFrpcBinary } from "../../tunnel/frpc-binary.js";
+import { resolveTunnelBrokerUrl, resolveTunnelRegistrationSecret } from "../../tunnel/env.js";
 import { getTunnelService } from "../../tunnel/tunnel-service.js";
+import { TUNNEL_RISK_SUMMARY_LINES, TunnelConsentError, assertTunnelMayStart, hasValidTunnelConsent } from "../../tunnel/consent.js";
 import { resolveFrpSubdomainHost } from "../../tunnel/frp-subdomain-host.js";
 import { applyTunnelConsentToConfig, mergeTunnelConfigPatch, setTunnelEnabledInConfig } from "../../tunnel/tunnel-config.js";
 import "../../tunnel/index.js";
@@ -99,7 +99,6 @@ function createTunnelCommand(ctx) {
 		"xopc tunnel start --accept-risk",
 		"xopc tunnel stop",
 		"xopc tunnel status",
-		"xopc tunnel qr",
 		"xopc tunnel consent",
 		"xopc tunnel prefetch",
 		"xopc tunnel secret set",
@@ -161,17 +160,13 @@ function createTunnelCommand(ctx) {
 		const tunnel = getTunnelService();
 		console.log("🚀 Starting tunnel...");
 		try {
-			const qr = await tunnel.start(port, token);
+			await tunnel.start(port, token);
 			setTunnelEnabledInConfig(config, true);
 			await saveConfig(config, ctx.configPath);
 			const status = tunnel.getStatus();
 			console.log("");
 			console.log("✅ Tunnel is active");
 			if (status.publicUrl) console.log(`   URL: ${status.publicUrl}`);
-			if (qr.lanUrl) console.log(`   LAN: ${qr.lanUrl}`);
-			console.log("");
-			console.log("📱 Mobile connect QR payload:");
-			console.log(qr.qrPayload);
 			console.log("");
 			console.log(`💡 Gateway must be running at ${host}:${port}. Keep frpc alive or use gateway / Web console.`);
 		} catch (err) {
@@ -211,16 +206,6 @@ function createTunnelCommand(ctx) {
 			consentValid: hasValidTunnelConsent(config)
 		}, null, 2));
 	});
-	cmd.command("qr").description("Print mobile connect QR payload (tunnel must be active)").action(async () => {
-		configureTunnel(ctx);
-		const { port, host } = resolveGatewayPortHost(loadConfig(ctx.configPath));
-		const qr = await getTunnelService().buildQr(port, host);
-		if (!qr.qrPayload) {
-			console.error("No active tunnel. Run: xopc tunnel start");
-			process.exit(1);
-		}
-		console.log(qr.qrPayload);
-	});
 	cmd.command("broker").description("Self-hosted FRP broker helpers").addCommand(new Command("init").description("Print a starter frps + broker configuration template").option("--domain <domain>", "Public domain for frps", "tunnel.example.com").action((opts) => {
 		const domain = String(opts.domain ?? "tunnel.example.com");
 		console.log(`# Self-hosted FRP broker sketch for ${domain}`);

package/dist/src/cli/utils/init-workspace-core.d.ts

@@ -4,7 +4,7 @@ export interface InitWorkspaceCoreOptions {
     workspacePath: string;
     /** When set with a new config file, overrides schema default port (e.g. Electron). */
     gatewayPort?: number;
-    /** When true, sets the default agent manifest workspace root to `workspacePath`. */
+    /** When true, sets the default agent workspace to `workspacePath`. */
     persistWorkspacePath?: boolean;
     /** Optional channel plugin validator (CLI/gateway only; Electron omits). */
     assertChannelPlugins?: (cfg: Config) => void | Promise<void>;

package/dist/src/cli/utils/init-workspace-core.js

@@ -53,7 +53,7 @@ async function initWorkspaceCore(options) {
 	const defaultAgentId = config.agents.default ?? config.agents.list[0]?.id ?? "main";
 	const agentsList = persistedWorkspaceRoot === void 0 ? config.agents.list : config.agents.list.map((agent) => agent.id === defaultAgentId ? {
 		...agent,
-		workspace: { root: persistedWorkspaceRoot }
+		workspace: persistedWorkspaceRoot
 	} : agent);
 	const nextConfig = {
 		...config,

package/dist/src/commands/agents.config.d.ts

@@ -8,12 +8,10 @@ export { listAgentEntries };
 export declare function findAgentEntryIndex(list: AgentEntry[], agentId: string): number;
 export declare function applyAgentConfig(cfg: Config, params: {
     agentId: string;
-    /** Used only when creating a previously absent agent entry. */
-    identity?: AgentEntry['identity'];
     workspace?: string;
+    profile?: AgentEntry['profile'];
     model?: string;
     models?: AgentEntry['models'];
-    extends?: AgentEntry['extends'];
     skills?: string[];
     tools?: AgentEntry['tools'];
 }): Config;

package/dist/src/commands/agents.config.js

@@ -17,33 +17,24 @@ function applyAgentConfig(cfg, params) {
 	const nextTools = params.tools;
 	const base = index >= 0 ? list[index] : {
 		id: agentId,
-		enabled: true,
-		identity: params.identity ?? {
-			name: agentId,
-			role: "Agent",
-			language: "en",
-			tone: "direct"
-		},
-		responsibilities: { primary: ["Help the user complete tasks"] },
-		workspace: { root: `~/.xopc/workspace/${agentId}` }
+		enabled: true
 	};
 	const nextEntry = {
 		...base,
 		enabled: base.enabled ?? true,
-		...params.extends !== void 0 ? { extends: params.extends } : {},
-		...params.workspace ? { workspace: { root: params.workspace } } : {},
+		...params.workspace ? { workspace: params.workspace } : {},
+		...params.profile ? { profile: params.profile } : {},
 		...params.models ? { models: params.models } : {},
 		...params.model ? { models: {
 			...base.models ?? {},
-			defaultRole: "deep",
-			roles: {
-				...base.models?.roles ?? {},
-				deep: { model: params.model }
+			chat: {
+				primary: params.model,
+				fallbacks: []
 			}
 		} } : {},
 		...params.skills ? { skills: {
-			mode: "allowlist",
-			allow: params.skills
+			mode: "replace",
+			include: params.skills
 		} } : {},
 		...nextTools ? { tools: nextTools } : {}
 	};
@@ -52,15 +43,7 @@ function applyAgentConfig(cfg, params) {
 	else {
 		if (nextList.length === 0 && agentId !== normalizeAgentId(resolveDefaultAgentId(cfg))) nextList.push({
 			id: resolveDefaultAgentId(cfg),
-			enabled: true,
-			identity: {
-				name: resolveDefaultAgentId(cfg),
-				role: "Agent",
-				language: "en",
-				tone: "direct"
-			},
-			responsibilities: { primary: ["Help the user complete tasks"] },
-			workspace: { root: `~/.xopc/workspace/${resolveDefaultAgentId(cfg)}` }
+			enabled: true
 		});
 		nextList.push(nextEntry);
 	}

package/dist/src/config/agent-model-intents.d.ts

@@ -0,0 +1,10 @@
+import { type ModelIntent } from '../agent-config/index.js';
+import { type Config } from './schema.js';
+export interface ResolvedModelIntent {
+    intent: ModelIntent;
+    model: string;
+    fallbacks: string[];
+}
+export declare function resolveEffectiveModelIntents(config: Config, agentId: string): Map<ModelIntent, ResolvedModelIntent>;
+export declare function resolveModelIntentRef(config: Config, agentId: string, intent: ModelIntent): string | undefined;
+export declare function resolveModelSelector(config: Config, agentId: string, selector: string): string;

package/dist/src/config/agent-model-intents.js

@@ -0,0 +1,39 @@
+import { ModelIntentSchema } from "../agent-config/schema.js";
+import { init_agent_config } from "../agent-config/index.js";
+import { init_schema, parseModelRef } from "./schema.js";
+import { resolveEffectiveAgentConfigForAgent } from "./agent-profile.js";
+//#region src/config/agent-model-intents.ts
+init_agent_config();
+init_schema();
+function resolveEffectiveModelIntents(config, agentId) {
+	const intents = /* @__PURE__ */ new Map();
+	const effective = resolveEffectiveAgentConfigForAgent(config, agentId).config;
+	for (const [intent, route] of Object.entries(effective.models.intents)) {
+		const parsedIntent = ModelIntentSchema.safeParse(intent);
+		if (parsedIntent.success && route) intents.set(parsedIntent.data, {
+			intent: parsedIntent.data,
+			model: route.primary,
+			fallbacks: [...route.fallbacks]
+		});
+	}
+	return intents;
+}
+function resolveModelIntentRef(config, agentId, intent) {
+	return resolveEffectiveModelIntents(config, agentId).get(intent)?.model;
+}
+function resolveModelSelector(config, agentId, selector) {
+	const trimmed = selector.trim();
+	if (!trimmed) throw new Error("model selector must not be empty");
+	if (trimmed.includes("/")) {
+		if (!parseModelRef(trimmed)) throw new Error(`model ref must be provider/model format (got '${trimmed}')`);
+		return trimmed;
+	}
+	const intentText = trimmed.startsWith("@") ? trimmed.slice(1).trim() : trimmed;
+	const intent = ModelIntentSchema.safeParse(intentText);
+	if (!intent.success) throw new Error(`Unknown model intent '${intentText}'`);
+	const resolved = resolveModelIntentRef(config, agentId, intent.data);
+	if (resolved) return resolved;
+	return resolveEffectiveAgentConfigForAgent(config, agentId).config.models.chat.primary;
+}
+//#endregion
+export { resolveEffectiveModelIntents, resolveModelIntentRef, resolveModelSelector };

package/dist/src/config/agent-profile.d.ts

@@ -1,5 +1,4 @@
-import { type EffectiveAgentManifest } from '../agent-manifest/index.js';
-import type { ThinkLevel, ReasoningLevel, VerboseLevel } from '../agent/transcript/thinking-types.js';
+import { type EffectiveAgentConfig, type ResolveEffectiveAgentConfigResult } from '../agent-config/index.js';
 import type { Config } from './schema.js';
 export { resolveAgentWorkspaceDir } from '../agent/agent-scope.js';
 export interface EffectiveAgentTools {
@@ -7,20 +6,19 @@ export interface EffectiveAgentTools {
 }
 export interface EffectiveAgentProfile {
     agentId: string;
-    manifest: EffectiveAgentManifest;
+    config: EffectiveAgentConfig;
+    sources: ResolveEffectiveAgentConfigResult['sources'];
     resolvedWorkspacePath: string;
-    primaryModelRef: string | undefined;
+    primaryModelRef: string;
     fallbacks: string[];
-    thinkingDefault?: ThinkLevel;
-    reasoningDefault?: ReasoningLevel;
-    verboseDefault?: VerboseLevel;
     customInstructions?: string;
     skillsAllowlist?: string[];
+    skillsDenylist: string[];
     tools: EffectiveAgentTools;
     params: Record<string, unknown>;
 }
 export declare function extractProfileAgentId(sessionKey: string | undefined | null, config: Config): string;
-export declare function resolveEffectiveAgentManifestForAgent(config: Config, agentId: string): EffectiveAgentManifest;
-export declare function resolveEffectiveAgentManifestForSession(config: Config, sessionKey: string | undefined | null): EffectiveAgentManifest;
+export declare function resolveEffectiveAgentConfigForAgent(config: Config, agentId: string): ResolveEffectiveAgentConfigResult;
+export declare function resolveEffectiveAgentConfigForSession(config: Config, sessionKey: string | undefined | null): ResolveEffectiveAgentConfigResult;
 export declare function resolveEffectiveAgentProfile(config: Config, agentId: string): EffectiveAgentProfile;
 export declare function resolveEffectiveAgentProfileForSession(config: Config, sessionKey: string | undefined | null): EffectiveAgentProfile;