@xopcai/xopc 0.0.190 → 0.0.192

package/dist/src/gateway/capability-presets-admin.js

@@ -1,7 +1,9 @@
 import { CapabilityPresetSchema, init_schema } from "../agent-manifest/schema.js";
 import { init_preset_chain, linearizePresetIds } from "../agent-manifest/preset-chain.js";
-import { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
+import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
+import { normalizeConfiguredMcpServers } from "../config/mcp-config-normalize.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
+import { createWorkflowCatalog } from "../agent/workflow/catalog.js";
 //#region src/gateway/capability-presets-admin.ts
 init_schema();
 init_preset_chain();
@@ -129,20 +131,36 @@ function nextConfigWithPresets(cfg, presets) {
 	};
 }
 function listCapabilityPresets(cfg) {
-	const presets = Object.values(presetMap(cfg)).map((preset) => ({
-		...preset,
-		usage: agentUsage(cfg, preset.id)
-	})).sort((a, b) => a.id.localeCompare(b.id));
+	const presets = Object.values(presetMap(cfg)).map((preset) => {
+		const inherited = resolveCapabilityPresetLayer({
+			presetIds: preset.extends,
+			presets: cfg.agents.capabilityPresets,
+			defaultPresetId: preset.id === cfg.agents.defaultPreset ? "__none__" : cfg.agents.defaultPreset
+		});
+		return {
+			...preset,
+			usage: agentUsage(cfg, preset.id),
+			inherited: inherited.patch,
+			inheritedSources: inherited.sources
+		};
+	}).sort((a, b) => a.id.localeCompare(b.id));
 	const agents = cfg.agents.list.map((agent) => ({
 		id: agent.id,
 		...agent.identity.name ? { name: agent.identity.name } : {},
 		extends: [...agent.extends ?? []]
 	})).sort((a, b) => a.id.localeCompare(b.id));
+	const workflows = createWorkflowCatalog().list().map((entry) => ({
+		id: entry.name,
+		title: entry.title,
+		description: entry.description
+	}));
 	return {
 		defaultPresetId: cfg.agents.defaultPreset,
 		presets,
 		agents,
-		builtinToolIds: [...GATEWAY_BUILTIN_TOOL_IDS]
+		builtinToolIds: [...GATEWAY_BUILTIN_TOOL_IDS],
+		mcpServerIds: Object.keys(normalizeConfiguredMcpServers(cfg.mcp?.servers)).sort(),
+		workflows
 	};
 }
 function prepareCreateCapabilityPreset(cfg, body) {

package/dist/src/gateway/chat-stream/mapper.js

@@ -109,7 +109,8 @@ var ChatStreamMapper = class {
 					purpose
 				}] : [];
 			}) : [] })];
-			case "memory_captured": return [this.make("memory_captured", { records: Array.isArray(event.records) ? event.records.flatMap((raw) => {
+			case "memory_captured":
+			case "memory_candidate": return [this.make(event.type, { records: Array.isArray(event.records) ? event.records.flatMap((raw) => {
 				if (!raw || typeof raw !== "object") return [];
 				const record = raw;
 				const id = typeof record.id === "string" ? record.id : "";
@@ -480,11 +481,14 @@ function extractUsage(message) {
 	const usage = message.usage;
 	if (!usage || typeof usage !== "object") return void 0;
 	const rec = usage;
+	const cost = asRecord(rec.cost);
 	return {
-		inputTokens: typeof rec.inputTokens === "number" ? rec.inputTokens : void 0,
-		outputTokens: typeof rec.outputTokens === "number" ? rec.outputTokens : void 0,
+		inputTokens: typeof rec.input === "number" ? rec.input : typeof rec.inputTokens === "number" ? rec.inputTokens : void 0,
+		outputTokens: typeof rec.output === "number" ? rec.output : typeof rec.outputTokens === "number" ? rec.outputTokens : void 0,
+		cacheReadTokens: typeof rec.cacheRead === "number" ? rec.cacheRead : typeof rec.cacheReadTokens === "number" ? rec.cacheReadTokens : void 0,
+		cacheWriteTokens: typeof rec.cacheWrite === "number" ? rec.cacheWrite : typeof rec.cacheWriteTokens === "number" ? rec.cacheWriteTokens : void 0,
 		totalTokens: typeof rec.totalTokens === "number" ? rec.totalTokens : void 0,
-		cost: typeof rec.cost === "number" ? rec.cost : void 0
+		cost: typeof rec.cost === "number" ? rec.cost : typeof cost?.total === "number" ? cost.total : void 0
 	};
 }
 function extractDetails(value) {

package/dist/src/gateway/chat-stream/protocol.d.ts

@@ -169,6 +169,8 @@ export type AssistantMessageEndEvent = ChatStreamEnvelope<'assistant_message_end
     usage?: {
         inputTokens?: number;
         outputTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
         totalTokens?: number;
         cost?: number;
     };
@@ -217,6 +219,13 @@ export type MemoryCapturedEvent = ChatStreamEnvelope<'memory_captured', {
         kind: string;
     }>;
 }>;
+export type MemoryCandidateEvent = ChatStreamEnvelope<'memory_candidate', {
+    records: Array<{
+        id: string;
+        content: string;
+        kind: string;
+    }>;
+}>;
 export type RunEndEvent = ChatStreamEnvelope<'run_end', {
     status: ChatStreamStatus;
     summary?: string;
@@ -228,4 +237,4 @@ export type StreamErrorEvent = ChatStreamEnvelope<'error', {
     recoverable?: boolean;
     petFeedback: PetFeedback;
 }>;
-export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | CommandStartedEvent | CommandOutputDeltaEvent | CommandCompletedEvent | PatchAppliedEvent | TurnPlanUpdatedEvent | TaskPlanUpdatedEvent | TurnDiffEvent | ReviewStartEvent | ReviewDeltaEvent | ReviewEndEvent | ReviewEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | MemoryConsentRequiredEvent | MemoryCapturedEvent | RunEndEvent | StreamErrorEvent;
+export type ChatStreamEvent = RunStartEvent | UserMessageEvent | UserTranscriptEvent | AssistantMessageStartEvent | AssistantDeltaEvent | ThinkingDeltaEvent | ThinkingEndEvent | ToolStartEvent | ToolUpdateEvent | ToolEndEvent | CommandStartedEvent | CommandOutputDeltaEvent | CommandCompletedEvent | PatchAppliedEvent | TurnPlanUpdatedEvent | TaskPlanUpdatedEvent | TurnDiffEvent | ReviewStartEvent | ReviewDeltaEvent | ReviewEndEvent | ReviewEvent | AssistantMessageEndEvent | ProgressEvent | CompactionEvent | TtsAudioEvent | ClarifyRequestEvent | MemoryConsentRequiredEvent | MemoryCapturedEvent | MemoryCandidateEvent | RunEndEvent | StreamErrorEvent;

package/dist/src/gateway/heartbeat/service.js

@@ -1,9 +1,9 @@
 import { createLogger } from "../../utils/logger/index.js";
 import { init_logger } from "../../utils/logger.js";
 import { shouldSilence, stripHeartbeatToken } from "../../heartbeat/tokens.js";
+import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { isWithinActiveHours } from "../../heartbeat/active-hours.js";
 import { isHeartbeatContentEmpty } from "../../heartbeat/content-check.js";
-import { appendCronEventLines } from "../../heartbeat/event-prompt.js";
 import { createHeartbeatWake } from "../../heartbeat/wake.js";
 import { resolveHeartbeatMdPath } from "../workspace-heartbeat-path.js";
 import { readFile } from "fs/promises";

package/dist/src/gateway/hono/lib/config-payload.d.ts

@@ -191,6 +191,7 @@ export declare function buildSafeWebConfigPayload(service: GatewayService, optio
                 maxTurns?: number;
                 timeoutMs?: number;
                 maxToolFailuresPerTurn?: number;
+                promptCacheRetention?: "none" | "short" | "long";
             };
             locks?: string[];
         }>;

package/dist/src/gateway/hono/routes/commands-skills.js

@@ -207,8 +207,9 @@ function registerCommandsSkillsRoutes(authenticated, deps) {
 	});
 	authenticated.get("/api/skills/marketplace/categories", async (c) => {
 		const provider = parseMarketplaceProviderQuery(c.req.query("provider"));
+		const locale = c.req.query("locale") ?? c.req.header("X-XOPC-Locale") ?? c.req.header("Accept-Language")?.split(",")[0];
 		try {
-			const payload = await service.marketplace.fetchSkillsCategories(provider);
+			const payload = await service.marketplace.fetchSkillsCategories(provider, locale);
 			return c.json({
 				ok: true,
 				payload

package/dist/src/gateway/hono/routes/lazy-bundles.js

@@ -3,6 +3,14 @@ function startsWithAny(path, prefixes) {
 	return prefixes.some((prefix) => path === prefix || path.startsWith(`${prefix}/`));
 }
 const AUTHENTICATED_LAZY_ROUTE_BUNDLES = [
+	{
+		id: "runtime-tools",
+		match: (path) => startsWithAny(path, ["/api/runtime-tools"]),
+		load: async () => {
+			const { registerRuntimeToolsRoutes } = await import("./runtime-tools.js");
+			return { register: registerRuntimeToolsRoutes };
+		}
+	},
 	{
 		id: "media",
 		match: (path) => startsWithAny(path, ["/api/media"]),

package/dist/src/gateway/hono/routes/models.js

@@ -7,7 +7,7 @@ import { CredentialResolver, init_credentials } from "../../../auth/credentials.
 import "../../../providers/constants.js";
 import { getProviderRegistry, init_plugin_registry } from "../../../providers/plugin-registry.js";
 import { PROVIDER_META, getAllModels, getAllProviders, getAvailableModels, getProviderAuthState, init_providers, isProviderConfigured } from "../../../providers/index.js";
-import { getImageGenerationProvider, reloadImageGenerationProviders } from "../../../agent/image/generation/provider-registry.js";
+import { getImageGenerationProvider, reloadImageGenerationProviders, resolveImageGenerationCredentialMode } from "../../../agent/image/generation/provider-registry.js";
 import { SessionConfigStore } from "../../../session/config-store.js";
 import { deleteCustomImageProvider, listCustomImageProviders, upsertCustomImageProvider } from "../../custom-image-providers.js";
 import { getDomesticProviderPreset, getDomesticProviderPresetIds } from "../../../providers/domestic-presets.js";
@@ -346,7 +346,7 @@ function registerModelsRoutes(authenticated, deps) {
 			ok: false,
 			error: { message: `Unknown image provider: ${providerId}` }
 		}, 404);
-		if (provider.credentialMode === "none") return c.json({
+		if (resolveImageGenerationCredentialMode(provider) !== "api-key") return c.json({
 			ok: false,
 			error: { message: "This provider does not use an API key" }
 		}, 400);
@@ -465,25 +465,25 @@ function registerModelsRoutes(authenticated, deps) {
 		const prepared = prepareImageGenerationSetup(service.currentConfig, c.req.param("agentId"), {
 			providerId: body.providerId,
 			...typeof body.modelId === "string" ? { modelId: body.modelId } : {},
-			...body.region === "cn" || body.region === "intl" ? { region: body.region } : {},
-			...typeof body.baseUrl === "string" ? { baseUrl: body.baseUrl } : {}
+			...body.providerConfig && typeof body.providerConfig === "object" && !Array.isArray(body.providerConfig) ? { providerConfig: body.providerConfig } : {}
 		});
 		if (prepared.ok === false) return c.json({
 			ok: false,
 			error: { message: prepared.error }
 		}, 400);
 		const resolver = new CredentialResolver();
-		const previousKey = await resolver.revealGatewayStoredApiKey(prepared.providerId);
+		const usesApiKey = resolveImageGenerationCredentialMode(getImageGenerationProvider(prepared.providerId)) === "api-key";
+		const previousKey = usesApiKey ? await resolver.revealGatewayStoredApiKey(prepared.providerId) : void 0;
 		const suppliedKey = typeof body.apiKey === "string" ? body.apiKey.trim() : "";
-		const effectiveKey = suppliedKey || await resolver.resolveApiKey(prepared.providerId);
-		if (getImageGenerationProvider(prepared.providerId).credentialMode !== "none" && !effectiveKey) return c.json({
+		const effectiveKey = usesApiKey ? suppliedKey || await resolver.resolveApiKey(prepared.providerId) : void 0;
+		if (usesApiKey && !effectiveKey) return c.json({
 			ok: false,
 			error: { message: "API key is required" }
 		}, 400);
-		const verification = suppliedKey ? await verifyImageGenerationCredential({
+		const verification = usesApiKey && suppliedKey ? await verifyImageGenerationCredential({
 			providerId: prepared.providerId,
 			apiKey: suppliedKey,
-			baseUrl: typeof body.baseUrl === "string" ? body.baseUrl : void 0
+			baseUrl: typeof body.providerConfig?.baseUrl === "string" ? body.providerConfig.baseUrl : void 0
 		}) : {
 			verified: false,
 			supported: false
@@ -492,10 +492,10 @@ function registerModelsRoutes(authenticated, deps) {
 			ok: false,
 			error: { message: verification.message ?? "Credential verification failed" }
 		}, 400);
-		if (suppliedKey) await resolver.saveApiKey(prepared.providerId, suppliedKey, { profileName: "default" });
+		if (usesApiKey && suppliedKey) await resolver.saveApiKey(prepared.providerId, suppliedKey, { profileName: "default" });
 		const saved = await service.saveConfig(prepared.config);
 		if (!saved.saved) {
-			if (suppliedKey) if (previousKey) await resolver.saveApiKey(prepared.providerId, previousKey, { profileName: "default" });
+			if (usesApiKey && suppliedKey) if (previousKey) await resolver.saveApiKey(prepared.providerId, previousKey, { profileName: "default" });
 			else await resolver.deleteProfile(`${prepared.providerId}:default`);
 			return c.json({
 				ok: false,

package/dist/src/gateway/hono/routes/runtime-tools.d.ts

@@ -0,0 +1,3 @@
+import type { Hono } from 'hono';
+import type { AuthenticatedRouteDeps } from './deps.js';
+export declare function registerRuntimeToolsRoutes(authenticated: Hono, deps: AuthenticatedRouteDeps): void;

package/dist/src/gateway/hono/routes/runtime-tools.js

@@ -0,0 +1,142 @@
+import { init_paths_state, resolveStateDir } from "../../../config/paths-state.js";
+import { RuntimeToolsConfigSchema, init_schema } from "../../../config/schema.js";
+import { ManagedRuntimeManager } from "../../../runtime-tools/manager.js";
+import { createGatewayRouteLogger } from "../lib/route-logger.js";
+import { pruneRuntimeTools } from "../../../runtime-tools/prune.js";
+import { streamSSE } from "hono/streaming";
+//#region src/gateway/hono/routes/runtime-tools.ts
+init_paths_state();
+init_schema();
+const log = createGatewayRouteLogger("RuntimeTools");
+const RUNTIMES = new Set([
+	"node",
+	"uv",
+	"python"
+]);
+function parseRuntime(value) {
+	return RUNTIMES.has(value) ? value : null;
+}
+function runtimeManager(config) {
+	return new ManagedRuntimeManager({
+		stateDir: resolveStateDir(),
+		config: config.runtimeTools
+	});
+}
+async function readJson(c) {
+	try {
+		return await c.req.json();
+	} catch {
+		return {};
+	}
+}
+function registerRuntimeToolsRoutes(authenticated, deps) {
+	const { service, strictRateLimitMiddleware } = deps;
+	authenticated.get("/api/runtime-tools", async (c) => {
+		const statuses = await runtimeManager(service.currentConfig).statusAll();
+		return c.json({
+			ok: true,
+			payload: {
+				config: service.currentConfig.runtimeTools,
+				statuses
+			}
+		});
+	});
+	authenticated.patch("/api/runtime-tools/config", strictRateLimitMiddleware, async (c) => {
+		const body = await readJson(c);
+		const parsed = RuntimeToolsConfigSchema.safeParse(body);
+		if (!parsed.success) return c.json({
+			ok: false,
+			error: "invalid-config",
+			message: parsed.error.issues[0]?.message ?? "Invalid runtime tools config"
+		}, 400);
+		const config = structuredClone(service.currentConfig);
+		config.runtimeTools = parsed.data;
+		const result = await service.saveConfig(config);
+		if (!result.saved) return c.json({
+			ok: false,
+			error: "save-failed",
+			message: result.error
+		}, 500);
+		service.emit("runtime-tools.updated", { config: parsed.data });
+		return c.json({
+			ok: true,
+			payload: { config: parsed.data }
+		});
+	});
+	authenticated.post("/api/runtime-tools/prune", strictRateLimitMiddleware, async (c) => {
+		const payload = await pruneRuntimeTools({
+			stateDir: resolveStateDir(),
+			config: service.currentConfig.runtimeTools
+		});
+		return c.json({
+			ok: true,
+			payload
+		});
+	});
+	const registerOperation = (action) => {
+		authenticated.post(`/api/runtime-tools/:runtime/${action}/stream`, strictRateLimitMiddleware, async (c) => {
+			const runtime = parseRuntime(c.req.param("runtime"));
+			if (!runtime) return c.json({
+				ok: false,
+				error: "invalid-runtime"
+			}, 400);
+			const body = await readJson(c);
+			const version = typeof body.version === "string" && body.version.trim() ? body.version.trim() : void 0;
+			return streamSSE(c, async (stream) => {
+				const manager = runtimeManager(service.currentConfig);
+				let writes = Promise.resolve();
+				const onProgress = (event) => {
+					writes = writes.then(async () => {
+						try {
+							await stream.writeSSE({
+								event: "progress",
+								data: JSON.stringify(event)
+							});
+						} catch {}
+					});
+				};
+				manager.on("progress", onProgress);
+				try {
+					const resolved = action === "repair" ? await manager.repair(runtime) : await manager.install(runtime, version);
+					await writes;
+					await stream.writeSSE({
+						event: "result",
+						data: JSON.stringify({
+							ok: true,
+							payload: resolved
+						})
+					});
+					service.emit("runtime-tools.updated", {
+						runtime,
+						action,
+						resolved
+					});
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					log.warn({
+						err: error,
+						runtime,
+						action
+					}, `Runtime ${action} failed: ${message}`);
+					await writes;
+					try {
+						await stream.writeSSE({
+							event: "result",
+							data: JSON.stringify({
+								ok: false,
+								error: `${action}-failed`,
+								message
+							})
+						});
+					} catch {}
+				} finally {
+					manager.off("progress", onProgress);
+				}
+			});
+		});
+	};
+	registerOperation("install");
+	registerOperation("repair");
+}
+//#endregion
+export { registerRuntimeToolsRoutes };

package/dist/src/gateway/hono/routes/understanding-sources.js

@@ -150,7 +150,8 @@ function registerUnderstandingSourceRoutes(authenticated, deps) {
 			error: "No understanding source items were provided"
 		}, 400);
 		try {
-			const result = await service.importUnderstandingSources(items, c.req.raw.signal, stringField(body, "workDiscoveryRunId") || void 0);
+			const checkpoints = body && typeof body === "object" && body.sourceCheckpoints && typeof body.sourceCheckpoints === "object" ? body.sourceCheckpoints : void 0;
+			const result = await service.importUnderstandingSources(items, c.req.raw.signal, stringField(body, "workDiscoveryRunId") || void 0, checkpoints);
 			return c.json({
 				ok: true,
 				...result

package/dist/src/gateway/hono/routes/voice.js

@@ -1,7 +1,7 @@
 import { getDefaultModelSync, init_providers, resolveModel } from "../../../providers/index.js";
 import { completeWithResolvedCredentials } from "../../../providers/model-call.js";
 import { resolveTtsProviderConfigSlice } from "../../../voice/tts/config-slice.js";
-import { isTTSAvailable } from "../../../voice/tts/factory.js";
+import { isTTSAvailable, resolveSpeechProvider } from "../../../voice/tts/factory.js";
 import { speak } from "../../../voice/tts/speak-core.js";
 import { mergeTtsConfigFromAppConfig } from "../../../voice/tts/merge-config.js";
 import { getLocalVoiceRuntimeClient } from "../../../voice/local/runtime-client.js";
@@ -144,6 +144,47 @@ function registerVoiceRoutes(authenticated, deps) {
 			payload
 		});
 	});
+	authenticated.get("/api/voice/tts-voices", async (c) => {
+		const provider = c.req.query("provider")?.trim() ?? "";
+		const model = c.req.query("model")?.trim() ?? "";
+		if (!provider || !model || provider.length > 100 || model.length > 200) return c.json({
+			ok: false,
+			error: { message: "provider and model are required" }
+		}, 400);
+		const config = service.currentConfig;
+		const baseConfig = mergeTtsConfigFromAppConfig(config.messages?.tts);
+		const resolved = resolveSpeechProvider(provider, {
+			...baseConfig,
+			provider,
+			providers: {
+				...baseConfig.providers ?? {},
+				[provider]: {
+					...baseConfig.providers?.[provider] ?? {},
+					model
+				}
+			}
+		});
+		if (!resolved?.plugin.listVoices) return c.json({
+			ok: true,
+			payload: { voices: [] }
+		});
+		try {
+			const voices = await resolved.plugin.listVoices({
+				cfg: config,
+				providerConfig: resolved.providerConfig
+			});
+			return c.json({
+				ok: true,
+				payload: { voices }
+			});
+		} catch (error) {
+			const message = error instanceof Error ? error.message : String(error);
+			return c.json({
+				ok: false,
+				error: { message: `Voice discovery failed: ${message}` }
+			}, 502);
+		}
+	});
 	/**
 	* GET /api/voice/stt-providers
 	*
@@ -440,7 +481,7 @@ function registerVoiceRoutes(authenticated, deps) {
 		const startedAt = Date.now();
 		try {
 			const result = await transcribe(input.audioBuffer, sttConfig, {
-				language: input.language || (sttConfig.provider === "alibaba" ? "zh" : void 0),
+				language: input.language,
 				mime: input.mimeType,
 				fileName: input.fileName,
 				signal: c.req.raw.signal

package/dist/src/gateway/hono/routes/workflows.js

@@ -7,9 +7,9 @@ import { messagesToClientHistory } from "../../../session/client-history.js";
 import "../../../workflows/domain/index.js";
 import { resolveWorkflowRunArtifactsDir } from "../../../workflows/store/paths.js";
 import { WorkflowDraftService } from "../../../workflows/draft/workflow-draft-service.js";
+import "../../../workflows/draft/index.js";
 import { WorkflowDraftConflictError, WorkflowDraftStore } from "../../../workflows/authoring/workflow-draft-store.js";
 import "../../../workflows/authoring/index.js";
-import "../../../workflows/draft/index.js";
 import { basename, join } from "node:path";
 import { readFile, stat } from "node:fs/promises";
 //#region src/gateway/hono/routes/workflows.ts

package/dist/src/gateway/hono/routes/you.js

@@ -1,20 +1,12 @@
 import { listContextConsolidationRuns } from "../../../storage/sqlite/context-consolidation-repository.js";
+import { UNDERSTANDING_KINDS } from "../../../user-context/domain.js";
+import { summarizeUserUnderstandingQuality } from "../../../storage/sqlite/user-context-quality-repository.js";
 import { createCollaborationRule, createUnderstanding, decideContextConsent, deleteCollaborationRule, deleteUnderstanding, getCollaborationRule, getTurnPersonalization, getUnderstanding, getUserProfile, listCollaborationRules, listUnderstandingEvidence, listUnderstandings, recordContextFeedback, rejectUnderstanding, reviseCollaborationRule, reviseUnderstanding, setCollaborationRuleStatus, setUnderstandingStatus, updateUserProfile } from "../../../storage/sqlite/user-context-repository.js";
 import "../../../storage/sqlite/index.js";
+import { canonicalUnderstandingKey, findDuplicateUnderstanding } from "../../../user-context/understanding.js";
 import { userInfo } from "node:os";
-import { createHash } from "node:crypto";
 //#region src/gateway/hono/routes/you.ts
-const UNDERSTANDING_KINDS = new Set([
-	"preference",
-	"boundary",
-	"relationship",
-	"routine",
-	"current_state",
-	"long_term_goal",
-	"project_context",
-	"task_lesson",
-	"derived_insight"
-]);
+const UNDERSTANDING_KIND_SET = new Set(UNDERSTANDING_KINDS);
 const UNDERSTANDING_STATUSES = new Set([
 	"candidate",
 	"active",
@@ -68,13 +60,6 @@ function scopeFrom(value) {
 		id
 	} : void 0;
 }
-function canonicalKey(kind, statement) {
-	const normalized = statement.toLocaleLowerCase().replace(/[^\p{L}\p{N}]+/gu, " ").trim();
-	return `${kind}:${createHash("sha256").update(normalized).digest("hex").slice(0, 20)}`;
-}
-function sameScope(left, right) {
-	return left.type === right.type && left.id === right.id;
-}
 function validTimezone(value) {
 	if (!value) return true;
 	try {
@@ -103,7 +88,8 @@ function registerYouRoutes(authenticated, deps) {
 		profile: getUserProfile(),
 		understandings: listUnderstandings(),
 		rules: listCollaborationRules(),
-		consolidation: { lastRun: listContextConsolidationRuns(1)[0] ?? null }
+		consolidation: { lastRun: listContextConsolidationRuns(1)[0] ?? null },
+		quality: summarizeUserUnderstandingQuality()
 	}));
 	authenticated.get("/api/you/profile", (c) => {
 		const profile = getUserProfile();
@@ -143,10 +129,15 @@ function registerYouRoutes(authenticated, deps) {
 		const statement = nonEmptyString(body?.statement);
 		const kind = body?.kind;
 		const scope = scopeFrom(body?.scope ?? { type: "global" });
-		if (!statement || !UNDERSTANDING_KINDS.has(kind) || !scope) return c.json({ error: "Valid statement, kind, and scope are required" }, 400);
+		if (!statement || !UNDERSTANDING_KIND_SET.has(kind) || !scope) return c.json({ error: "Valid statement, kind, and scope are required" }, 400);
 		const typedKind = kind;
-		const key = canonicalKey(typedKind, statement);
-		if (listUnderstandings().some((item) => item.canonicalKey === key && sameScope(item.scope, scope) && item.status !== "archived" && item.status !== "rejected")) return c.json({ error: "This understanding already exists" }, 409);
+		const key = canonicalUnderstandingKey(typedKind, statement);
+		if (findDuplicateUnderstanding(listUnderstandings(), {
+			kind: typedKind,
+			statement,
+			canonicalKey: key,
+			scope
+		})) return c.json({ error: "This understanding already exists" }, 409);
 		const understanding = createUnderstanding({
 			kind: typedKind,
 			canonicalKey: key,
@@ -177,8 +168,14 @@ function registerYouRoutes(authenticated, deps) {
 		if (body.statement !== void 0) {
 			const statement = nonEmptyString(body.statement);
 			if (!statement) return c.json({ error: "statement must be 1-2000 characters" }, 400);
-			const key = canonicalKey(understanding.kind, statement);
-			if (listUnderstandings().some((item) => item.id !== id && item.canonicalKey === key && sameScope(item.scope, understanding.scope) && item.status !== "archived" && item.status !== "rejected")) return c.json({ error: "This understanding already exists" }, 409);
+			const key = canonicalUnderstandingKey(understanding.kind, statement);
+			if (findDuplicateUnderstanding(listUnderstandings(), {
+				kind: understanding.kind,
+				statement,
+				canonicalKey: key,
+				scope: understanding.scope,
+				excludeId: id
+			})) return c.json({ error: "This understanding already exists" }, 409);
 			understanding = reviseUnderstanding(id, statement, {
 				canonicalKey: key,
 				explicitness: "explicit",

package/dist/src/gateway/image-generation-setup.d.ts

@@ -3,12 +3,11 @@ import { type Config } from '../config/schema.js';
 export type ImageGenerationSetupInput = {
     providerId: string;
     modelId?: string;
-    region?: 'cn' | 'intl';
-    baseUrl?: string;
+    providerConfig?: Record<string, unknown>;
 };
 export type ImageGenerationCatalogItem = ReturnType<typeof listImageGenerationProvidersSummary>[number] & {
     configured: boolean;
-    requiresRegion: boolean;
+    config: Record<string, string>;
 };
 export declare function getImageGenerationCatalog(config: Config): ImageGenerationCatalogItem[];
 export declare function getAgentImageGenerationConfig(config: Config, agentIdRaw: string): {

package/dist/src/gateway/image-generation-setup.js

@@ -13,10 +13,44 @@ function getImageGenerationCatalog(config) {
 		return {
 			...summary,
 			configured: provider.isConfigured({ cfg: config }),
-			requiresRegion: summary.id === "dashscope" || summary.id === "minimax"
+			config: Object.fromEntries(summary.configFields.flatMap((field) => {
+				const value = config.providers?.[summary.id]?.[field.key];
+				return typeof value === "string" ? [[field.key, value]] : [];
+			}))
 		};
 	});
 }
+function parseProviderConfig(provider, input) {
+	const source = input ?? {};
+	const allowedKeys = new Set(provider.configFields?.map((field) => field.key) ?? []);
+	const unknownKey = Object.keys(source).find((key) => !allowedKeys.has(key));
+	if (unknownKey) return {
+		ok: false,
+		error: `Unknown ${provider.id} config field: ${unknownKey}`
+	};
+	const value = {};
+	for (const field of provider.configFields ?? []) {
+		const raw = source[field.key];
+		const resolved = typeof raw === "string" ? raw.trim() : "";
+		if (!resolved) {
+			if (field.required) return {
+				ok: false,
+				error: `${provider.id} requires ${field.key}`
+			};
+			continue;
+		}
+		if (field.type === "select" && !field.options?.some((option) => option.value === resolved)) return {
+			ok: false,
+			error: `Invalid ${provider.id} ${field.key}: ${resolved}`
+		};
+		if (field.key === "region") value.region = resolved;
+		else value.baseUrl = resolved;
+	}
+	return {
+		ok: true,
+		value
+	};
+}
 function getAgentImageGenerationConfig(config, agentIdRaw) {
 	const agentId = normalizeAgentId(agentIdRaw);
 	if (!config.agents.list.some((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === agentId)) throw new Error(`Agent not found: ${agentId}`);
@@ -42,9 +76,10 @@ function prepareImageGenerationSetup(config, agentIdRaw, input) {
 		ok: false,
 		error: `Unknown ${providerId} image model: ${modelId}`
 	};
-	if ((providerId === "dashscope" || providerId === "minimax") && input.region !== "cn" && input.region !== "intl") return {
+	const parsedProviderConfig = parseProviderConfig(provider, input.providerConfig);
+	if (parsedProviderConfig.ok === false) return {
 		ok: false,
-		error: `${providerId} requires region "cn" or "intl"`
+		error: parsedProviderConfig.error
 	};
 	const next = structuredClone(config);
 	const index = next.agents.list.findIndex((entry) => entry.enabled !== false && normalizeAgentId(entry.id) === agentId);
@@ -52,15 +87,11 @@ function prepareImageGenerationSetup(config, agentIdRaw, input) {
 		ok: false,
 		error: `Agent not found: ${agentId}`
 	};
-	const connection = {
-		...input.region ? { region: input.region } : {},
-		...input.baseUrl?.trim() ? { baseUrl: input.baseUrl.trim() } : {}
-	};
 	next.providers = {
 		...next.providers ?? {},
 		[providerId]: {
 			...next.providers?.[providerId] ?? {},
-			...connection
+			...parsedProviderConfig.value
 		}
 	};
 	const entry = next.agents.list[index];

package/dist/src/gateway/service/marketplace-service.d.ts

@@ -83,7 +83,7 @@ export declare class GatewayMarketplaceService {
     reloadSkills(): void;
     patchSkillEnabled(skillName: string, enabled: boolean): void;
     fetchSkillsCatalog(params: SkillsStoreListParams, provider?: string): Promise<UnifiedMarketplaceListResponse>;
-    fetchSkillsCategories(provider?: string): Promise<{
+    fetchSkillsCategories(provider?: string, locale?: string): Promise<{
         items: MarketplaceCategoryOption[];
     }>;
     fetchSkillsPackageDetail(packageName: string, provider?: string): Promise<UnifiedMarketplacePackageDetail>;