@xopcai/xopc 0.0.190 → 0.0.192

package/dist/src/agent/skills/skills-marketplace.js

@@ -5,8 +5,8 @@ function marketplaceAdapter(config, provider) {
 	if (provider && isRegisteredProvider(provider)) return getMarketplaceAdapterForProvider(provider);
 	return getMarketplaceAdapter(config);
 }
-async function listMarketplaceCategories(config, provider) {
-	return { items: await marketplaceAdapter(config, provider).listCategories(config) };
+async function listMarketplaceCategories(config, provider, locale) {
+	return { items: await marketplaceAdapter(config, provider).listCategories(config, { locale }) };
 }
 async function listMarketplacePackages(config, params, provider) {
 	return marketplaceAdapter(config, provider).listPackages(config, params);

package/dist/src/agent/skills/types.d.ts

@@ -106,12 +106,6 @@ export interface SkillSourceDescriptor {
     writable: boolean;
 }
 export type SkillOrigin = SkillSourceDescriptor;
-export interface SkillsInstallConfig {
-    /** Prefer brew for package installation */
-    preferBrew?: boolean;
-    /** Node package manager preference */
-    nodeManager?: 'pnpm' | 'npm' | 'yarn' | 'bun';
-}
 export interface SkillsLimitsConfig {
     /** Max number of immediate child directories to consider */
     maxCandidatesPerRoot?: number;
@@ -129,8 +123,6 @@ export interface SkillsConfig {
     allowBundled?: string[];
     /** Load configuration */
     load?: SkillsLoadConfig;
-    /** Install configuration */
-    install?: SkillsInstallConfig;
     /** Limits configuration */
     limits?: SkillsLimitsConfig;
     /** Per-skill configuration */

package/dist/src/agent/tools/exec-command.d.ts

@@ -24,5 +24,6 @@ export interface ExecCommandUpdateDetails {
 export interface CreateExecCommandToolOptions {
     /** Env var names allowed through prepareSafeToolEnv even if they match secret heuristics. */
     getSkillPassthroughEnvVarNames?: () => string[];
+    prepareEnv?: (baseEnv: Record<string, string>, cwd: string) => Promise<Record<string, string>>;
 }
 export declare function createExecCommandTool(workspaceCwd: string, options?: CreateExecCommandToolOptions): AgentTool;

package/dist/src/agent/tools/exec-command.js

@@ -116,6 +116,7 @@ function createExecCommandTool(workspaceCwd, options) {
 			const timeoutMs = Math.min(clampTimeoutMs(params.timeoutMs), policy.timeoutMs);
 			const maxOutputChars = clampMaxOutputChars(params.maxOutputChars);
 			const startTime = Date.now();
+			const runtimeEnv = options?.prepareEnv ? await options.prepareEnv(policy.sanitizedEnv, policy.effectiveCwd) : policy.sanitizedEnv;
 			let stdout = "";
 			let stderr = "";
 			let aggregatedOutput = "";
@@ -126,7 +127,7 @@ function createExecCommandTool(workspaceCwd, options) {
 					shell: true,
 					cwd: policy.effectiveCwd,
 					env: {
-						...policy.sanitizedEnv,
+						...runtimeEnv,
 						COLUMNS: "200"
 					}
 				});

package/dist/src/agent/tools/factory.d.ts

@@ -99,6 +99,7 @@ export declare class AgentToolsFactory {
     /** Cached readiness probe — keyed by backend mode + extension host:port. */
     private browserReadinessCache;
     constructor(deps: ToolFactoryDeps);
+    private prepareRuntimeEnv;
     private browserReadinessKey;
     private checkBrowserReadinessCached;
     /** Invalidate the readiness cache (config hot-reload, settings-page save, etc.). */

package/dist/src/agent/tools/factory.js

@@ -1,3 +1,4 @@
+import { init_paths_state, resolveStateDir } from "../../config/paths-state.js";
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { isXopcDatabaseOpen } from "../../storage/sqlite/connection.js";
@@ -5,6 +6,7 @@ import { getSessionTaskPlan, setSessionTaskPlan } from "../../storage/sqlite/ses
 import "../../storage/sqlite/index.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent-scope.js";
 import { wrapToolsWithProtection } from "./executor.js";
+import { buildRuntimeEnvironment } from "../../runtime-tools/environment.js";
 import { createDefaultExternalToolGatewayTools } from "../external-tools/index.js";
 import { createReadFileTool } from "./read.js";
 import { createWriteFileTool } from "./write.js";
@@ -56,6 +58,7 @@ import "../capabilities/index.js";
 //#region src/agent/tools/factory.ts
 init_agent_scope();
 init_logger();
+init_paths_state();
 const log = createLogger("AgentToolsFactory");
 /** Channels where `clarify` can block for a user answer (web UI, Telegram, CLI readline). */
 const CLARIFY_SUPPORTED_CHANNELS = new Set([
@@ -72,6 +75,15 @@ var AgentToolsFactory = class {
 	constructor(deps) {
 		this.deps = deps;
 	}
+	prepareRuntimeEnv = async (baseEnv) => {
+		const config = this.deps.getConfig?.();
+		if (!config) return baseEnv;
+		return (await buildRuntimeEnvironment({
+			stateDir: resolveStateDir(),
+			config: config.runtimeTools,
+			baseEnv
+		})).env;
+	};
 	browserReadinessKey() {
 		const cfg = this.deps.getConfig?.();
 		const backend = resolveBrowserBackendFromConfig(cfg);
@@ -251,8 +263,11 @@ var AgentToolsFactory = class {
 			listDir,
 			grep,
 			find,
-			createExecCommandTool(workspace, { getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames }),
-			createManagedJobTool(workspace, () => this.deps.getCurrentContext()?.sessionKey, this.deps.getSkillPassthroughEnvVarNames),
+			createExecCommandTool(workspace, {
+				getSkillPassthroughEnvVarNames: this.deps.getSkillPassthroughEnvVarNames,
+				prepareEnv: this.prepareRuntimeEnv
+			}),
+			createManagedJobTool(workspace, () => this.deps.getCurrentContext()?.sessionKey, this.deps.getSkillPassthroughEnvVarNames, this.prepareRuntimeEnv),
 			createWebSearchTool(() => this.deps.getConfig?.()),
 			createWebFetchTool(() => this.deps.getConfig?.()),
 			createWebExtractTool({ getConfig: () => this.deps.getConfig?.() }),

package/dist/src/agent/tools/managed-job-tool.d.ts

@@ -1,2 +1,2 @@
 import type { AgentTool } from '@earendil-works/pi-agent-core';
-export declare function createManagedJobTool(workspace: string, getSessionKey: () => string | undefined, getSkillPassthroughEnvVarNames?: () => string[]): AgentTool;
+export declare function createManagedJobTool(workspace: string, getSessionKey: () => string | undefined, getSkillPassthroughEnvVarNames?: () => string[], prepareEnv?: (baseEnv: Record<string, string>, cwd: string) => Promise<Record<string, string>>): AgentTool;

package/dist/src/agent/tools/managed-job-tool.js

@@ -126,7 +126,7 @@ function result(value) {
 		details: {}
 	};
 }
-function createManagedJobTool(workspace, getSessionKey, getSkillPassthroughEnvVarNames) {
+function createManagedJobTool(workspace, getSessionKey, getSkillPassthroughEnvVarNames, prepareEnv) {
 	return {
 		name: "managed_job",
 		label: "Managed Job",
@@ -149,8 +149,9 @@ function createManagedJobTool(workspace, getSessionKey, getSkillPassthroughEnvVa
 			if (!policy.allowed) return result({ error: `Sandbox blocked command: ${policy.reason}` });
 			const rawMax = Number(input.maxRuntimeMs ?? DEFAULT_MAX_RUNTIME_MS);
 			const maxRuntimeMs = Math.min(MAX_RUNTIME_MS, Math.max(1e3, Number.isFinite(rawMax) ? rawMax : DEFAULT_MAX_RUNTIME_MS));
+			const runtimeEnv = prepareEnv ? await prepareEnv(policy.sanitizedEnv, policy.effectiveCwd) : policy.sanitizedEnv;
 			return result(registry().start(owner, command, policy.effectiveCwd, {
-				...policy.sanitizedEnv,
+				...runtimeEnv,
 				COLUMNS: "200"
 			}, maxRuntimeMs));
 		}

package/dist/src/agent/tools/skill-install-tool.d.ts

@@ -22,7 +22,7 @@ export interface SkillInstallToolResult {
     target?: SkillInstallTarget;
 }
 export interface MarketplaceSkillInstallToolOptions {
-    provider: 'store' | 'clawhub';
+    provider: 'store' | 'skillhub' | 'clawhub';
     name: string;
     version?: string;
     target?: SkillInstallTarget;
@@ -32,7 +32,7 @@ export interface MarketplaceSkillInstallToolOptions {
 export interface MarketplaceSkillInstallToolResult {
     skillId: string;
     path: string;
-    provider: 'store' | 'clawhub';
+    provider: 'store' | 'skillhub' | 'clawhub';
     name: string;
     version?: string;
     target?: SkillInstallTarget;

package/dist/src/agent/tools/skill-install-tool.js

@@ -3,7 +3,11 @@ import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/skill-install-tool.ts
 const SkillInstallSchema = Type.Object({
 	source: Type.Optional(Type.String({ description: "Explicit source install: Git URL, GitHub repository URL, https .zip/.tar.gz URL, file:// URL, or local archive/path." })),
-	provider: Type.Optional(Type.Union([Type.Literal("store"), Type.Literal("clawhub")], { description: "Marketplace provider. Use with name; copy it from skills_marketplace_search." })),
+	provider: Type.Optional(Type.Union([
+		Type.Literal("store"),
+		Type.Literal("skillhub"),
+		Type.Literal("clawhub")
+	], { description: "Marketplace provider. Use with name; copy it from skills_marketplace_search." })),
 	name: Type.Optional(Type.String({ description: "Marketplace package name or install.reference. For ClawHub prefer owner/slug to disambiguate publishers." })),
 	version: Type.Optional(Type.String({ description: "Optional marketplace package version." })),
 	ref: Type.Optional(Type.String({ description: "Optional Git branch/tag/ref." })),
@@ -20,7 +24,7 @@ function createSkillInstallTool(deps) {
 	return {
 		name: "skill_install",
 		label: "Install skill",
-		description: "Install an xopc skill from a Store/ClawHub marketplace result or an explicit source. Use only when the user clearly asks to install or update a skill; never treat search or a pasted URL as installation consent.",
+		description: "Install an xopc skill from a Store/SkillHub/ClawHub marketplace result or an explicit source. Use only when the user clearly asks to install or update a skill; never treat search or a pasted URL as installation consent.",
 		parameters: SkillInstallSchema,
 		async execute(_toolCallId, params) {
 			const provider = clean(params.provider);
@@ -28,10 +32,10 @@ function createSkillInstallTool(deps) {
 			const target = isSkillInstallTarget(params.target) ? params.target : "global";
 			const sessionKey = deps.getSessionKey?.();
 			if (provider || name) {
-				if (provider !== "store" && provider !== "clawhub") return {
+				if (provider !== "store" && provider !== "skillhub" && provider !== "clawhub") return {
 					content: [{
 						type: "text",
-						text: "Marketplace installs require provider: store or clawhub."
+						text: "Marketplace installs require provider: store, skillhub, or clawhub."
 					}],
 					details: { errorCode: "missing_provider" }
 				};

package/dist/src/agent/tools/skills-marketplace-search-tool.js

@@ -8,11 +8,12 @@ const SkillsMarketplaceSearchSchema = Type.Object({
 	}),
 	sources: Type.Optional(Type.Array(Type.Union([
 		Type.Literal("store"),
+		Type.Literal("skillhub"),
 		Type.Literal("clawhub"),
 		Type.Literal("skills-sh")
 	]), {
 		minItems: 1,
-		maxItems: 3,
+		maxItems: 4,
 		uniqueItems: true
 	})),
 	limit: Type.Optional(Type.Integer({
@@ -34,7 +35,7 @@ function createSkillsMarketplaceSearchTool(deps) {
 	return {
 		name: "skills_marketplace_search",
 		label: "🔎 Find skills",
-		description: "Search the XOPC Store, native ClawHub catalog, and skills.sh results federated by ClawHub. Returns normalized provenance, install references, adoption metrics, partial-source errors, and a heuristic value score. Read-only; never installs a skill.",
+		description: "Search the XOPC Store, SkillHub, native ClawHub catalog, and skills.sh results federated by ClawHub. Returns normalized provenance, install references, adoption metrics, partial-source errors, and a heuristic value score. Read-only; never installs a skill.",
 		parameters: SkillsMarketplaceSearchSchema,
 		mutatesWorkspace: false,
 		mutationScope: "none",

package/dist/src/agent/tools/workflow-tool.d.ts

@@ -8,6 +8,7 @@ export type WorkflowToolInput = {
     name?: string;
     args?: unknown;
     goal?: string;
+    intent?: string;
     taskRunId?: string;
 };
 export interface WorkflowToolDeps {

package/dist/src/agent/tools/workflow-tool.js

@@ -1,6 +1,6 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
-import { extractProfileAgentId } from "../../config/agent-profile.js";
+import { extractProfileAgentId, resolveEffectiveAgentProfileForSession } from "../../config/agent-profile.js";
 import { appendProductDeliveryText } from "../../../packages/gateway-contract/src/product-delivery.js";
 import { Type } from "@sinclair/typebox";
 //#region src/agent/tools/workflow-tool.ts
@@ -13,6 +13,7 @@ const WorkflowToolSchema = Type.Object({
 	name: Type.Optional(Type.String({ description: "Name of a saved visual workflow to run." })),
 	args: Type.Optional(Type.Any({ description: "Optional JSON value passed as workflow input payload." })),
 	goal: Type.Optional(Type.String({ description: "Optional goal or task description for this workflow run (defaults to user intent in chat)." })),
+	intent: Type.Optional(Type.String({ description: "Optional short intent used to select a suggested workflow." })),
 	taskRunId: Type.Optional(Type.String({ description: "Optional TaskRun id. When set, the workflow executes and finalizes that run." }))
 });
 function createWorkflowTool(deps) {
@@ -35,7 +36,7 @@ function createWorkflowTool(deps) {
 			};
 			let definitionId;
 			try {
-				definitionId = resolveDefinitionId(params, deps.catalog);
+				definitionId = resolveDefinitionId(params, deps.catalog, deps.getConfig(), deps.getCurrentSessionKey?.());
 			} catch (e) {
 				const message = e instanceof Error ? e.message : String(e);
 				return {
@@ -136,13 +137,22 @@ function createWorkflowTool(deps) {
 		}
 	};
 }
-function resolveDefinitionId(params, catalog) {
+function resolveDefinitionId(params, catalog, config, sessionKey) {
 	const name = params.name?.trim();
 	if (name) {
 		catalog.load(name);
 		return name;
 	}
-	throw new Error("`name` is required. Create workflows in the visual workflow studio.");
+	const configuredDefault = config ? (() => {
+		const policy = resolveEffectiveAgentProfileForSession(config, sessionKey).manifest.workflows;
+		const intent = params.intent?.trim().toLowerCase();
+		return (intent ? policy.suggested?.find((entry) => entry.intent.toLowerCase() === intent)?.workflow : void 0) ?? policy.default;
+	})() : void 0;
+	if (configuredDefault) {
+		catalog.load(configuredDefault);
+		return configuredDefault;
+	}
+	throw new Error("`name` is required because this agent has no default workflow.");
 }
 //#endregion
 export { createWorkflowTool };

package/dist/src/agent-manifest/schema.d.ts

@@ -250,6 +250,11 @@ export declare const RuntimePolicySchema: z.ZodOptional<z.ZodObject<{
     maxTurns: z.ZodOptional<z.ZodNumber>;
     timeoutMs: z.ZodOptional<z.ZodNumber>;
     maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
+    promptCacheRetention: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        short: "short";
+        long: "long";
+    }>>;
 }, z.core.$strict>>;
 export declare const PromptPolicySchema: z.ZodOptional<z.ZodObject<{
     customInstructions: z.ZodOptional<z.ZodString>;
@@ -394,6 +399,11 @@ export declare const AgentManifestSchema: z.ZodObject<{
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
+        promptCacheRetention: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            short: "short";
+            long: "long";
+        }>>;
     }, z.core.$strict>>;
     prompt: z.ZodOptional<z.ZodObject<{
         customInstructions: z.ZodOptional<z.ZodString>;
@@ -526,6 +536,11 @@ export declare const AgentConfigEntrySchema: z.ZodObject<{
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
+        promptCacheRetention: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            short: "short";
+            long: "long";
+        }>>;
     }, z.core.$strict>>;
     prompt: z.ZodOptional<z.ZodObject<{
         customInstructions: z.ZodOptional<z.ZodString>;
@@ -644,6 +659,11 @@ export declare const CapabilityPresetSchema: z.ZodObject<{
         maxTurns: z.ZodOptional<z.ZodNumber>;
         timeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolFailuresPerTurn: z.ZodOptional<z.ZodNumber>;
+        promptCacheRetention: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            short: "short";
+            long: "long";
+        }>>;
     }, z.core.$strict>>;
     locks: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;

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

@@ -156,7 +156,12 @@ var init_schema = __esmMin((() => {
 	RuntimePolicySchema = z.object({
 		maxTurns: z.number().int().positive().optional(),
 		timeoutMs: z.number().int().positive().optional(),
-		maxToolFailuresPerTurn: z.number().int().positive().optional()
+		maxToolFailuresPerTurn: z.number().int().positive().optional(),
+		promptCacheRetention: z.enum([
+			"none",
+			"short",
+			"long"
+		]).optional()
 	}).strict().optional();
 	PromptPolicySchema = z.object({ customInstructions: z.string().optional() }).strict().optional();
 	AgentIdentitySchema = z.object({

package/dist/src/browser/providers/cloakbrowser.js

@@ -11,9 +11,9 @@ import { createReadStream, createWriteStream } from "node:fs";
 import { spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { mkdir, mkdtemp, rm, stat } from "node:fs/promises";
-import { Readable, Transform } from "node:stream";
 import AdmZip from "adm-zip";
 import { pipeline } from "node:stream/promises";
+import { Readable, Transform } from "node:stream";
 //#region src/browser/providers/cloakbrowser.ts
 /**
 * CloakBrowser provider — anti-fingerprint Chromium with stealth capabilities.

package/dist/src/cli/command-loaders.js

@@ -15,6 +15,7 @@ const REGISTRY_COMMAND_MODULES = {
 	project: () => import("./commands/project.js"),
 	config: () => import("./commands/config.js"),
 	doctor: () => import("./commands/doctor/index.js"),
+	runtime: () => import("./commands/runtime.js"),
 	image: () => import("./commands/image.js"),
 	channels: () => import("./commands/channels.js"),
 	models: () => import("./commands/models.js"),

package/dist/src/cli/command-manifest.js

@@ -79,6 +79,10 @@ const ROOT_HELP_COMMANDS = [
 		name: "doctor [options]",
 		description: "Check xopc installation health and diagnose common issues"
 	},
+	{
+		name: "runtime",
+		description: "Manage Node.js and Python tool runtimes used by agents"
+	},
 	{
 		name: "update [options]",
 		description: "Check for and install xopc updates"

package/dist/src/cli/commands/doctor/checks/node-version.js

@@ -7,21 +7,21 @@ async function checkNodeVersion(_ctx) {
 	const major = parseNodeMajorVersion();
 	if (major === 0) return {
 		id: "node-version",
-		label: "Node.js",
+		label: "Host Node.js",
 		status: "warn",
 		message: "Could not parse Node.js version.",
 		hints: [`process.version=${process.version}`]
 	};
 	if (major < 22) return {
 		id: "node-version",
-		label: "Node.js",
+		label: "Host Node.js",
 		status: "fail",
 		message: `Node ${major} is below the required minimum (22).`,
 		hints: ["Install Node.js 22+ from https://nodejs.org/"]
 	};
 	return {
 		id: "node-version",
-		label: "Node.js",
+		label: "Host Node.js",
 		status: "pass",
 		message: `Node.js ${process.version} meets the project requirement (>= 22).`,
 		hints: []

package/dist/src/cli/commands/doctor/checks/tool-runtimes.d.ts

@@ -0,0 +1,2 @@
+import type { CheckResult, DoctorContext } from '../types.js';
+export declare function checkToolRuntimes(ctx: DoctorContext): Promise<CheckResult>;

package/dist/src/cli/commands/doctor/checks/tool-runtimes.js

@@ -0,0 +1,36 @@
+import { init_loader, loadConfig } from "../../../../config/loader.js";
+import { ManagedRuntimeManager } from "../../../../runtime-tools/manager.js";
+//#region src/cli/commands/doctor/checks/tool-runtimes.ts
+init_loader();
+async function checkToolRuntimes(ctx) {
+	const config = loadConfig(ctx.configPath);
+	const statuses = await new ManagedRuntimeManager({
+		stateDir: ctx.stateDir,
+		config: config.runtimeTools
+	}).statusAll();
+	const invalid = statuses.filter((status) => status.state === "corrupted" || status.state === "failed");
+	const absent = statuses.filter((status) => status.state === "absent");
+	if (invalid.length > 0) return {
+		id: "tool-runtimes",
+		label: "Agent tool runtimes",
+		status: "fail",
+		message: `${invalid.map((status) => status.runtime).join(", ")} runtime installation is invalid.`,
+		hints: invalid.map((status) => `Run xopc runtime repair ${status.runtime}`)
+	};
+	if (absent.length > 0) return {
+		id: "tool-runtimes",
+		label: "Agent tool runtimes",
+		status: "warn",
+		message: `${absent.map((status) => status.runtime).join(", ")} runtime is not installed.`,
+		hints: absent.map((status) => `Run xopc runtime install ${status.runtime}`)
+	};
+	return {
+		id: "tool-runtimes",
+		label: "Agent tool runtimes",
+		status: "pass",
+		message: statuses.map((status) => status.message).join("; "),
+		hints: []
+	};
+}
+//#endregion
+export { checkToolRuntimes };

package/dist/src/cli/commands/doctor/flow.js

@@ -15,10 +15,12 @@ import { checkVersionUpdate } from "./checks/version-check.js";
 import { checkChannelPlugins } from "./checks/channel-plugins.js";
 import { checkMigrations } from "./checks/migrations.js";
 import { checkImageProviders } from "./checks/image-providers.js";
+import { checkToolRuntimes } from "./checks/tool-runtimes.js";
 //#region src/cli/commands/doctor/flow.ts
 const DOCTOR_CHECKS = [
 	checkVersionUpdate,
 	checkNodeVersion,
+	checkToolRuntimes,
 	checkMigrations,
 	checkConfigHealth,
 	checkStateIntegrity,

package/dist/src/cli/commands/extension-marketplace.js

@@ -12,9 +12,9 @@ import { join, resolve } from "node:path";
 import { existsSync, readFileSync, rmSync, statSync } from "node:fs";
 import { execSync } from "node:child_process";
 import { createHash } from "node:crypto";
+import semver from "semver";
 import { confirm } from "@inquirer/prompts";
 import { Command } from "commander";
-import semver from "semver";
 //#region src/cli/commands/extension-marketplace.ts
 init_loader();
 init_paths();

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

@@ -16,7 +16,6 @@ init_schema();
 init_providers();
 const IMAGE_GENERATION_IDS = new Set([
 	"gpt-image-2",
-	"gpt-image-1.5",
 	"wan2.6-t2i",
 	"wan2.7-image-pro",
 	"wan2.7-image",

package/dist/src/cli/commands/onboard/model.d.ts

@@ -2,7 +2,25 @@
  * Catalog-driven model configuration for onboarding.
  */
 import type { Config } from '../../../config/schema.js';
+import { type ModelCatalogStore } from '../../../providers/model-catalog-store.js';
 import { XopcCloudModelSource } from '../../../providers/xopc-cloud-model-source.js';
 import type { CLIContext } from '../../registry.js';
+export declare function defaultXopcCloudImageModel(catalogStore?: ModelCatalogStore): string | undefined;
+export declare function defaultXopcCloudAudioModels(catalogStore?: ModelCatalogStore): {
+    stt?: string;
+    tts?: {
+        model: string;
+        voice: string;
+        maxCharacters: number;
+    };
+};
+export declare function setPrimaryModel(config: Config, workspacePath: string, modelRef: string, defaultImageGenerationModel?: string, defaultAudioModels?: {
+    stt?: string;
+    tts?: {
+        model: string;
+        voice: string;
+        maxCharacters: number;
+    };
+}): Config;
 export declare function refreshOnboardModelCatalogIfNeeded(provider: string, hasCatalogModels: boolean, source?: Pick<XopcCloudModelSource, 'refresh'>): Promise<void>;
 export declare function setupModel(existingConfig: Config | null, ctx: CLIContext): Promise<Config>;

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

@@ -2,6 +2,7 @@ import { getAgentDefaultModelRef, init_schema } from "../../../config/schema.js"
 import { resolveModelsJsonPath } from "../../../config/paths.js";
 import { init_models_json, loadModelsJson, saveModelsJson } from "../../../config/models-json.js";
 import { getApiKeyFromEnv } from "../../../providers/env-keys.js";
+import { getModelCatalogStore, init_model_catalog_store } from "../../../providers/model-catalog-store.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";
@@ -23,7 +24,25 @@ init_credentials();
 init_models_json();
 init_schema();
 init_providers();
-function setPrimaryModel(config, workspacePath, modelRef) {
+init_model_catalog_store();
+function defaultXopcCloudImageModel(catalogStore = getModelCatalogStore()) {
+	const model = catalogStore.getSource("xopc-cloud")?.models.find((entry) => entry.availability === "available" && entry.kind === "image" && entry.operations.includes("images.generate"));
+	return model ? `xopc-cloud/${model.id}` : void 0;
+}
+function defaultXopcCloudAudioModels(catalogStore = getModelCatalogStore()) {
+	const models = catalogStore.getSource("xopc-cloud")?.models.filter((entry) => entry.availability === "available") ?? [];
+	const stt = models.find((entry) => entry.kind === "stt");
+	const tts = models.find((entry) => entry.kind === "tts" && entry.tts?.defaultVoice);
+	return {
+		...stt ? { stt: stt.id } : {},
+		...tts?.tts?.defaultVoice ? { tts: {
+			model: tts.id,
+			voice: tts.tts.defaultVoice,
+			maxCharacters: tts.tts.maxCharacters
+		} } : {}
+	};
+}
+function setPrimaryModel(config, workspacePath, modelRef, defaultImageGenerationModel, defaultAudioModels) {
 	const id = config.agents.default ?? config.agents.list[0]?.id ?? "main";
 	const index = config.agents.list.findIndex((entry) => entry.id === id);
 	let nextConfig = config;
@@ -42,12 +61,64 @@ 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: { deep: { model: modelRef } }
+		roles: {
+			...currentModels?.roles,
+			deep: { model: modelRef }
+		},
+		...!currentModels?.imageGenerationModel && defaultImageGenerationModel ? { imageGenerationModel: { primary: defaultImageGenerationModel } } : {}
 	} });
 	if (prep.ok === false) throw new Error(prep.error);
-	return prep.data.nextConfig;
+	let configured = prep.data.nextConfig;
+	if (defaultAudioModels?.stt && !configured.tools.media?.audio) configured = {
+		...configured,
+		tools: {
+			...configured.tools,
+			media: {
+				...configured.tools.media,
+				audio: {
+					enabled: true,
+					provider: "xopc-cloud",
+					models: [{
+						provider: "xopc-cloud",
+						model: defaultAudioModels.stt,
+						capabilities: ["audio"]
+					}],
+					providers: { "xopc-cloud": { model: defaultAudioModels.stt } },
+					fallback: {
+						enabled: false,
+						order: []
+					}
+				}
+			}
+		}
+	};
+	if (defaultAudioModels?.tts && !configured.messages?.tts) configured = {
+		...configured,
+		messages: {
+			...configured.messages,
+			tts: {
+				enabled: true,
+				provider: "xopc-cloud",
+				trigger: "off",
+				fallback: {
+					enabled: false,
+					order: []
+				},
+				maxTextLength: defaultAudioModels.tts.maxCharacters,
+				timeoutMs: 6e4,
+				providers: { "xopc-cloud": {
+					model: defaultAudioModels.tts.model,
+					voice: defaultAudioModels.tts.voice
+				} }
+			}
+		}
+	};
+	return configured;
 }
 function formatRecommended(provider) {
 	const labels = getRecommendedModelsForProvider(provider, 3).map((m) => m.name || m.id);
@@ -469,7 +540,12 @@ async function setupModel(existingConfig, ctx) {
 		}))
 	});
 	console.log("\n✅ Model configured:", model);
-	return setPrimaryModel(config, ctx.workspacePath, model);
+	const imageModel = provider === "xopc-cloud" ? defaultXopcCloudImageModel() : void 0;
+	const audioModels = provider === "xopc-cloud" ? defaultXopcCloudAudioModels() : void 0;
+	if (imageModel) console.log("✅ Image generation configured:", imageModel);
+	if (audioModels?.stt) console.log("✅ Speech recognition configured:", audioModels.stt);
+	if (audioModels?.tts) console.log("✅ Speech synthesis configured:", audioModels.tts.model);
+	return setPrimaryModel(config, ctx.workspacePath, model, imageModel, audioModels);
 }
 //#endregion
-export { refreshOnboardModelCatalogIfNeeded, setupModel };
+export { defaultXopcCloudAudioModels, defaultXopcCloudImageModel, refreshOnboardModelCatalogIfNeeded, setPrimaryModel, setupModel };