@xopcai/xopc 0.0.87 → 0.0.89

package/dist/src/config/agent-typed-models.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Named model roles (`agents.defaults.models` / `agents.list[].models`).
+ * Merged per agent id for workflow and other callers.
+ */
+import type { AgentTypedModel, Config } from './schema.js';
+export type { AgentTypedModel };
+/**
+ * Merge defaults + per-agent typed models. Agent entry wins on same `id`.
+ */
+export declare function mergeTypedModels(defaults?: AgentTypedModel[], entry?: AgentTypedModel[]): Map<string, AgentTypedModel>;
+export declare function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel>;
+/** Resolve a typed model id to `provider/model`, or undefined when not configured. */
+export declare function resolveTypedModelRef(config: Config, agentId: string, typeId: string): string | undefined;
+/**
+ * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.
+ * Throws when the ref is invalid or the typed id is unknown.
+ */
+export declare function resolveModelRef(config: Config, agentId: string, ref: string): string;

package/dist/src/config/agent-typed-models.js

@@ -0,0 +1,53 @@
+import { init_schema, parseModelRef } from "./schema.js";
+import { init_agent_scope, listAgentEntries } from "../agent/agent-scope.js";
+//#region src/config/agent-typed-models.ts
+init_agent_scope();
+init_schema();
+/**
+* Merge defaults + per-agent typed models. Agent entry wins on same `id`.
+*/
+function mergeTypedModels(defaults, entry) {
+	const out = /* @__PURE__ */ new Map();
+	for (const m of defaults ?? []) out.set(m.id, m);
+	for (const m of entry ?? []) out.set(m.id, m);
+	return out;
+}
+function resolveEffectiveTypedModels(config, agentId) {
+	const defaults = config.agents?.defaults?.models;
+	const entry = listAgentEntries(config).find((a) => a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase())?.models;
+	return mergeTypedModels(defaults, entry);
+}
+/** Resolve a typed model id to `provider/model`, or undefined when not configured. */
+function resolveTypedModelRef(config, agentId, typeId) {
+	return resolveEffectiveTypedModels(config, agentId).get(typeId)?.model?.trim() || void 0;
+}
+function parseModelRefInput(ref) {
+	const trimmed = ref.trim();
+	if (!trimmed) return {};
+	if (trimmed.includes("/")) return { directRef: trimmed };
+	const typeId = trimmed.startsWith("@") ? trimmed.slice(1).trim() : trimmed;
+	return typeId ? { typeId } : {};
+}
+/**
+* Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.
+* Throws when the ref is invalid or the typed id is unknown.
+*/
+function resolveModelRef(config, agentId, ref) {
+	const { directRef, typeId } = parseModelRefInput(ref);
+	if (directRef) {
+		if (!parseModelRef(directRef)) throw new Error(`model ref must be provider/model format (got '${directRef}')`);
+		return directRef;
+	}
+	if (typeId) {
+		const resolved = resolveTypedModelRef(config, agentId, typeId);
+		if (resolved) return resolved;
+		const available = [...resolveEffectiveTypedModels(config, agentId).keys()];
+		const hint = available.length > 0 ? ` (available: ${available.join(", ")})` : " (none configured)";
+		throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);
+	}
+	throw new Error("model ref must not be empty");
+}
+//#endregion
+export { mergeTypedModels, resolveEffectiveTypedModels, resolveModelRef, resolveTypedModelRef };
+
+//# sourceMappingURL=agent-typed-models.js.map

package/dist/src/config/agent-typed-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-typed-models.js","names":[],"sources":["../../../src/config/agent-typed-models.ts"],"sourcesContent":["/**\n * Named model roles (`agents.defaults.models` / `agents.list[].models`).\n * Merged per agent id for workflow and other callers.\n */\n\nimport { listAgentEntries } from '../agent/agent-scope.js';\nimport type { AgentTypedModel, Config } from './schema.js';\nimport { parseModelRef } from './schema.js';\n\nexport type { AgentTypedModel };\n\n/**\n * Merge defaults + per-agent typed models. Agent entry wins on same `id`.\n */\nexport function mergeTypedModels(\n  defaults?: AgentTypedModel[],\n  entry?: AgentTypedModel[],\n): Map<string, AgentTypedModel> {\n  const out = new Map<string, AgentTypedModel>();\n  for (const m of defaults ?? []) {\n    out.set(m.id, m);\n  }\n  for (const m of entry ?? []) {\n    out.set(m.id, m);\n  }\n  return out;\n}\n\nexport function resolveEffectiveTypedModels(config: Config, agentId: string): Map<string, AgentTypedModel> {\n  const defaults = config.agents?.defaults?.models;\n  const entry = listAgentEntries(config).find(\n    (a) => a.enabled !== false && a.id.toLowerCase() === agentId.toLowerCase(),\n  )?.models;\n  return mergeTypedModels(defaults, entry);\n}\n\n/** Resolve a typed model id to `provider/model`, or undefined when not configured. */\nexport function resolveTypedModelRef(\n  config: Config,\n  agentId: string,\n  typeId: string,\n): string | undefined {\n  const entry = resolveEffectiveTypedModels(config, agentId).get(typeId);\n  const ref = entry?.model?.trim();\n  return ref || undefined;\n}\n\nfunction parseModelRefInput(ref: string): { directRef?: string; typeId?: string } {\n  const trimmed = ref.trim();\n  if (!trimmed) {\n    return {};\n  }\n  if (trimmed.includes('/')) {\n    return { directRef: trimmed };\n  }\n  const typeId = trimmed.startsWith('@') ? trimmed.slice(1).trim() : trimmed;\n  return typeId ? { typeId } : {};\n}\n\n/**\n * Resolve a model reference: `provider/model`, typed id (`small`), or `@small`.\n * Throws when the ref is invalid or the typed id is unknown.\n */\nexport function resolveModelRef(config: Config, agentId: string, ref: string): string {\n  const { directRef, typeId } = parseModelRefInput(ref);\n  if (directRef) {\n    if (!parseModelRef(directRef)) {\n      throw new Error(`model ref must be provider/model format (got '${directRef}')`);\n    }\n    return directRef;\n  }\n  if (typeId) {\n    const resolved = resolveTypedModelRef(config, agentId, typeId);\n    if (resolved) {\n      return resolved;\n    }\n    const available = [...resolveEffectiveTypedModels(config, agentId).keys()];\n    const hint =\n      available.length > 0 ? ` (available: ${available.join(', ')})` : ' (none configured)';\n    throw new Error(`Unknown typed model id '${typeId}' for agent '${agentId}'${hint}`);\n  }\n  throw new Error('model ref must not be empty');\n}\n"],"mappings":";;;kBAK2D;aAEf;;;;AAO5C,SAAgB,iBACd,UACA,OAC8B;CAC9B,MAAM,sBAAM,IAAI,KAA8B;AAC9C,MAAK,MAAM,KAAK,YAAY,EAAE,CAC5B,KAAI,IAAI,EAAE,IAAI,EAAE;AAElB,MAAK,MAAM,KAAK,SAAS,EAAE,CACzB,KAAI,IAAI,EAAE,IAAI,EAAE;AAElB,QAAO;;AAGT,SAAgB,4BAA4B,QAAgB,SAA+C;CACzG,MAAM,WAAW,OAAO,QAAQ,UAAU;CAC1C,MAAM,QAAQ,iBAAiB,OAAO,CAAC,MACpC,MAAM,EAAE,YAAY,SAAS,EAAE,GAAG,aAAa,KAAK,QAAQ,aAAa,CAC3E,EAAE;AACH,QAAO,iBAAiB,UAAU,MAAM;;;AAI1C,SAAgB,qBACd,QACA,SACA,QACoB;AAGpB,QAFc,4BAA4B,QAAQ,QAAQ,CAAC,IAAI,OAC9C,EAAE,OAAO,MAAM,IAClB,KAAA;;AAGhB,SAAS,mBAAmB,KAAsD;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;AAEX,KAAI,QAAQ,SAAS,IAAI,CACvB,QAAO,EAAE,WAAW,SAAS;CAE/B,MAAM,SAAS,QAAQ,WAAW,IAAI,GAAG,QAAQ,MAAM,EAAE,CAAC,MAAM,GAAG;AACnE,QAAO,SAAS,EAAE,QAAQ,GAAG,EAAE;;;;;;AAOjC,SAAgB,gBAAgB,QAAgB,SAAiB,KAAqB;CACpF,MAAM,EAAE,WAAW,WAAW,mBAAmB,IAAI;AACrD,KAAI,WAAW;AACb,MAAI,CAAC,cAAc,UAAU,CAC3B,OAAM,IAAI,MAAM,iDAAiD,UAAU,IAAI;AAEjF,SAAO;;AAET,KAAI,QAAQ;EACV,MAAM,WAAW,qBAAqB,QAAQ,SAAS,OAAO;AAC9D,MAAI,SACF,QAAO;EAET,MAAM,YAAY,CAAC,GAAG,4BAA4B,QAAQ,QAAQ,CAAC,MAAM,CAAC;EAC1E,MAAM,OACJ,UAAU,SAAS,IAAI,gBAAgB,UAAU,KAAK,KAAK,CAAC,KAAK;AACnE,QAAM,IAAI,MAAM,2BAA2B,OAAO,eAAe,QAAQ,GAAG,OAAO;;AAErF,OAAM,IAAI,MAAM,8BAA8B"}

package/dist/src/config/index.js

@@ -1,6 +1,6 @@
 import { TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema } from "../../extensions/telegram/src/config-schema.js";
 import { WeixinAccountConfigSchema, WeixinConfigSchema } from "../../extensions/weixin/src/config-schema.js";
-import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, 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, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
+import { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, 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, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef } from "./schema.js";
 import { applyConfigOverrides, getConfigOverrides, resetConfigOverrides, setConfigOverride, unsetConfigOverride } from "./runtime-overrides.js";
 import { ENV_VARS, resolveHomeDir, resolveStateDir } from "./paths-state.js";
 import { expandWorkspacePathString, init_workspace_path, normalizeWorkspaceDir, resolveWorkspaceRoot } from "./workspace-path.js";
@@ -29,6 +29,6 @@ init_workspace_path();
 init_models_json();
 init_resolve_config_value();
 //#endregion
-export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, 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, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listConfiguredMcpServers, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, registerChannelConfigValidator, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentMetadataPath, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveCronLogPath, resolveCronLogsDir, resolveCronRunsDir, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMemoryDir, resolveMemoryPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSessionFilePath, resolveSessionTranscriptPath, resolveSessionTranscriptPathInDir, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsDir$1 as resolveSessionsDirFromConfig, resolveSessionsMapPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, setConfiguredMcpServer, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, unsetConfiguredMcpServer, validateModelsConfig };
+export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BASE_RELOAD_RULES, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigHotReloader, ConfigSchema, CronConfigSchema, CustomModelSchema, ENV_VARS, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, FILENAMES, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, 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, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, VercelGatewayRoutingSchema, WORKSPACE_FILES, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, applyConfigOverrides, buildReloadPlan, canonicalizeConfiguredMcpServer, clearConfigValueCache, createProfile, deleteProfile, diffConfigPaths, existsSync, expandWorkspacePathString, extractProfileAgentId, formatThinkingLevels, getAgentDefaultModelRef, getAllowedCommands, getCacheStats, getConfigOverrides, getCurrentProfile, getDefaultModelValues, resolveModelsJsonPath as getModelsJsonPath, getProfileManager, getProfileNameFromDir, getSwitchCommand, getWorkspacePath, isKnownCliMcpTypeAlias, listAgentProfileMarkdownDirs, listAgentWorkspaceDirs, listConfiguredMcpServers, listProfiles, listThinkingLevels, loadConfig, loadModelsJson, matchReloadRule, modelsJsonExists, normalizeConfiguredMcpServers, normalizeElevatedMode, normalizeReasoningLevel, normalizeThinkLevel, normalizeVerboseLevel, normalizeWorkspaceDir, parseModelRef, registerChannelConfigValidator, resetConfigOverrides, resolveAgentAuthProfilesPath, resolveAgentDir, resolveAgentDir$1 as resolveAgentDirFromConfig, resolveAgentHomeDir, resolveAgentHomeDir$1 as resolveAgentHomeDirFromConfig, resolveAgentMetadataPath, resolveAgentProfileDir, resolveAgentProfileMarkdownPath, resolveAgentWorkspaceDir, resolveAuthProfilesPath, resolveBinDir, resolveBundledExtensionsDir, resolveBundledSkillsDir, resolveConfigPath, resolveConfigValue, resolveCredentialsDir, resolveCronDir, resolveCronJobsPath, resolveCronLogPath, resolveCronLogsDir, resolveCronRunsDir, resolveDefaultAgentWorkspaceDir, resolveEffectiveAgentProfile, resolveEffectiveAgentProfileForSession, resolveExtensionSdkPath, resolveExtensionsDir, resolveExtensionsLockPath, resolveHeaders, resolveHomeDir, resolveInboxDir, resolveInboxMessagePath, resolveInboxPendingDir, resolveInboxProcessedDir, resolveLogPath, resolveLogsDir, resolveMemoryDir, resolveMemoryPath, resolveModelsJsonPath, resolveNodeBinDir, resolveNodeBinPath, resolveNodeToolsDir, resolveNpmBinPath, resolveOAuthPath, resolvePidPath, resolveProfileStateDir, resolveSessionFilePath, resolveSessionTranscriptPath, resolveSessionTranscriptPathInDir, resolveSessionsArchiveDir, resolveSessionsDir, resolveSessionsDir$1 as resolveSessionsDirFromConfig, resolveSessionsMapPath, resolveSkillPath, resolveSkillsCachePath, resolveSkillsDir, resolveSkillsLockPath, resolveSocketPath, resolveStateDir, resolveStatusPath, resolveToolsDir, resolveWorkspaceExtensionsDir, resolveWorkspaceFile, resolveWorkspaceRoot, resolveWorkspaceStateDir, resolveWorkspaceStatePath, resolveXopcBinPath, resolveXopcMcpTransportAlias, saveConfig, saveModelsJson, setConfigOverride, setConfiguredMcpServer, testApiKeyResolution, thinkLevelToNumber, unsetConfigOverride, unsetConfiguredMcpServer, validateModelsConfig };
 
 //# sourceMappingURL=index.js.map

package/dist/src/config/schema.d.ts

@@ -20,12 +20,24 @@ export declare const AgentImageGenerationModelSchema: z.ZodObject<{
     autoProviderFallback: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strict>;
 export type AgentImageGenerationModelConfig = z.infer<typeof AgentImageGenerationModelSchema>;
+/** Named model role for workflows (e.g. `small`, `large`). Maps to a concrete `provider/model` ref. */
+export declare const AgentTypedModelSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    model: z.ZodString;
+}, z.core.$strict>;
+export type AgentTypedModel = z.infer<typeof AgentTypedModelSchema>;
 export declare const AgentDefaultsSchema: z.ZodObject<{
     workspace: z.ZodDefault<z.ZodString>;
     model: z.ZodOptional<z.ZodObject<{
         primary: z.ZodString;
         fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        model: z.ZodString;
+    }, z.core.$strict>>>;
     imageModel: z.ZodOptional<z.ZodObject<{
         primary: z.ZodString;
         fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -228,6 +240,11 @@ export declare const AgentDefaultsSchema: z.ZodObject<{
         maxConcurrency: z.ZodDefault<z.ZodNumber>;
         maxSubagents: z.ZodDefault<z.ZodNumber>;
         defaultTimeoutSec: z.ZodDefault<z.ZodNumber>;
+        subagentStream: z.ZodDefault<z.ZodEnum<{
+            off: "off";
+            full: "full";
+            steps: "steps";
+        }>>;
     }, z.core.$strip>>;
     systemPromptOverride: z.ZodOptional<z.ZodString>;
     skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -248,6 +265,11 @@ export declare const AgentConfigSchema: z.ZodObject<{
         primary: z.ZodString;
         fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strict>>;
+    models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        model: z.ZodString;
+    }, z.core.$strict>>>;
     thinkingDefault: z.ZodOptional<z.ZodEnum<{
         off: "off";
         minimal: "minimal";
@@ -282,6 +304,11 @@ export declare const AgentsConfigSchema: z.ZodDefault<z.ZodObject<{
             primary: z.ZodString;
             fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
+        models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+        }, z.core.$strict>>>;
         imageModel: z.ZodOptional<z.ZodObject<{
             primary: z.ZodString;
             fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -484,6 +511,11 @@ export declare const AgentsConfigSchema: z.ZodDefault<z.ZodObject<{
             maxConcurrency: z.ZodDefault<z.ZodNumber>;
             maxSubagents: z.ZodDefault<z.ZodNumber>;
             defaultTimeoutSec: z.ZodDefault<z.ZodNumber>;
+            subagentStream: z.ZodDefault<z.ZodEnum<{
+                off: "off";
+                full: "full";
+                steps: "steps";
+            }>>;
         }, z.core.$strip>>;
         systemPromptOverride: z.ZodOptional<z.ZodString>;
         skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -504,6 +536,11 @@ export declare const AgentsConfigSchema: z.ZodDefault<z.ZodObject<{
             primary: z.ZodString;
             fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strict>>;
+        models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            model: z.ZodString;
+        }, z.core.$strict>>>;
         thinkingDefault: z.ZodOptional<z.ZodEnum<{
             off: "off";
             minimal: "minimal";
@@ -1534,6 +1571,11 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                 primary: z.ZodString;
                 fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                model: z.ZodString;
+            }, z.core.$strict>>>;
             imageModel: z.ZodOptional<z.ZodObject<{
                 primary: z.ZodString;
                 fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1736,6 +1778,11 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                 maxConcurrency: z.ZodDefault<z.ZodNumber>;
                 maxSubagents: z.ZodDefault<z.ZodNumber>;
                 defaultTimeoutSec: z.ZodDefault<z.ZodNumber>;
+                subagentStream: z.ZodDefault<z.ZodEnum<{
+                    off: "off";
+                    full: "full";
+                    steps: "steps";
+                }>>;
             }, z.core.$strip>>;
             systemPromptOverride: z.ZodOptional<z.ZodString>;
             skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1756,6 +1803,11 @@ export declare const ConfigSchema: z.ZodDefault<z.ZodObject<{
                 primary: z.ZodString;
                 fallbacks: z.ZodOptional<z.ZodArray<z.ZodString>>;
             }, z.core.$strict>>;
+            models: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                model: z.ZodString;
+            }, z.core.$strict>>>;
             thinkingDefault: z.ZodOptional<z.ZodEnum<{
                 off: "off";
                 minimal: "minimal";

package/dist/src/config/schema.js

@@ -21,7 +21,7 @@ function parseModelRef(ref) {
 		model: trimmed.slice(idx + 1).trim()
 	};
 }
-var AgentModelRefSchema, AgentImageGenerationModelSchema, AgentDefaultsSchema, AgentConfigSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, SessionResetModeSchema, SessionResetConfigSchema, SessionResetByTypeSchema, SessionScopeSchema, SessionConfigSchema, ChannelsConfigSchema, SearchProviderEntrySchema, WebSearchConfigSchema, WebsiteBlocklistSchema, WebToolsConfigSchema, ToolsConfigSchema, GatewayAuthRateLimitSchema, GatewaySecuritySchema, GatewayTrustedProxySchema, GatewayAuthSchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayRemoteSchema, GatewayTlsSchema, GatewayModeSchema, HeartbeatConfigSchema, GatewayChannelConnectDeferModeSchema, TunnelConsentSchema, TunnelConfigSchema, WorkspaceImportConfigSchema, WorkspaceConfigSchema, GatewayBindModeSchema, GatewayConfigSchema, CronConfigSchema, ModelsDevConfigSchema, SttProviderConfigCatchallSchema, STTProviderConfigSchema, STTFallbackConfigSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, STTConfigSchema, TtsProviderConfigCatchallSchema, TTSProviderConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSEdgeConfigSchema, TTSSummarizationConfigSchema, TTSConfigSchema, MessagesConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProviderAuthConfigSchema, ProvidersConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, UpdateAutoConfigSchema, GoalsConfigSchema, UpdateConfigSchema, CommandsConfigSchema, McpHttpUrlSchema, McpServerSchema, McpConfigSchema, ConfigSchema;
+var AgentModelRefSchema, AgentImageGenerationModelSchema, AgentTypedModelSchema, AgentTypedModelsArraySchema, AgentDefaultsSchema, AgentConfigSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, SessionDmScopeSchema, SessionStorageConfigSchema, SessionResetModeSchema, SessionResetConfigSchema, SessionResetByTypeSchema, SessionScopeSchema, SessionConfigSchema, ChannelsConfigSchema, SearchProviderEntrySchema, WebSearchConfigSchema, WebsiteBlocklistSchema, WebToolsConfigSchema, ToolsConfigSchema, GatewayAuthRateLimitSchema, GatewaySecuritySchema, GatewayTrustedProxySchema, GatewayAuthSchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayRemoteSchema, GatewayTlsSchema, GatewayModeSchema, HeartbeatConfigSchema, GatewayChannelConnectDeferModeSchema, TunnelConsentSchema, TunnelConfigSchema, WorkspaceImportConfigSchema, WorkspaceConfigSchema, GatewayBindModeSchema, GatewayConfigSchema, CronConfigSchema, ModelsDevConfigSchema, SttProviderConfigCatchallSchema, STTProviderConfigSchema, STTFallbackConfigSchema, MediaUnderstandingCapabilitiesSchema, MediaUnderstandingModelSchema, STTConfigSchema, TtsProviderConfigCatchallSchema, TTSProviderConfigSchema, TTSFallbackConfigSchema, TTSModelOverridesConfigSchema, TTSEdgeConfigSchema, TTSSummarizationConfigSchema, TTSConfigSchema, MessagesConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, ProviderAzureConfigSchema, ProviderRequestOverridesSchema, ProviderAuthConfigSchema, ProvidersConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, UpdateAutoConfigSchema, GoalsConfigSchema, UpdateConfigSchema, CommandsConfigSchema, McpHttpUrlSchema, McpServerSchema, McpConfigSchema, ConfigSchema;
 var init_schema = __esmMin((() => {
 	init_cache_dir_policy();
 	init_public_url();
@@ -42,11 +42,39 @@ var init_schema = __esmMin((() => {
 		*/
 		autoProviderFallback: z.boolean().optional()
 	}).strict();
+	AgentTypedModelSchema = z.object({
+		id: z.string().min(1).regex(/^[a-z][a-z0-9_-]{0,63}$/),
+		description: z.string().max(500).optional(),
+		model: z.string().min(1)
+	}).strict().superRefine((entry, ctx) => {
+		const trimmed = entry.model.trim();
+		const idx = trimmed.indexOf("/");
+		if (idx <= 0 || idx === trimmed.length - 1) ctx.addIssue({
+			code: "custom",
+			message: `model must be provider/model format (got '${entry.model}')`,
+			path: ["model"]
+		});
+	});
+	AgentTypedModelsArraySchema = z.array(AgentTypedModelSchema).optional().superRefine((arr, ctx) => {
+		if (!arr) return;
+		const seen = /* @__PURE__ */ new Set();
+		for (let i = 0; i < arr.length; i++) {
+			const id = arr[i].id;
+			if (seen.has(id)) ctx.addIssue({
+				code: "custom",
+				message: `duplicate typed model id '${id}'`,
+				path: [i, "id"]
+			});
+			seen.add(id);
+		}
+	});
 	AgentDefaultsSchema = z.object({
 		/** Parent directory: each agent’s Markdown root is `<expanded>/<agentId>/` (e.g. `.../workspace/main`). */
 		workspace: z.string().default("~/.xopc/workspace"),
 		/** Default model for new sessions. Optional — runtime resolves a fallback when unset. */
 		model: AgentModelRefSchema.optional(),
+		/** Named model roles (e.g. `small`, `large`) for workflows and other callers. */
+		models: AgentTypedModelsArraySchema,
 		/** Vision / image understanding model (provider/model). Falls back to heuristics when unset. */
 		imageModel: AgentModelRefSchema.optional(),
 		/** Image generation model (provider/model), e.g. openai/gpt-image-1. Supports plugin-based providers (OpenAI / DashScope / MiniMax / Google / Fal). */
@@ -301,7 +329,13 @@ summaryModel: z.string().optional() }).optional(),
 			enabled: z.boolean().default(true),
 			maxConcurrency: z.number().int().min(1).max(64).default(16),
 			maxSubagents: z.number().int().min(1).max(1e4).default(1e3),
-			defaultTimeoutSec: z.number().int().min(60).max(14400).default(1800)
+			defaultTimeoutSec: z.number().int().min(60).max(14400).default(1800),
+			/** Subagent live progress in workflow snapshots: tool steps only, or full text stream. */
+			subagentStream: z.enum([
+				"off",
+				"steps",
+				"full"
+			]).default("steps")
 		}).optional(),
 		/** Optional full system prompt replacement (merged with per-agent entry; entry wins). */
 		systemPromptOverride: z.string().optional(),
@@ -328,6 +362,8 @@ summaryModel: z.string().optional() }).optional(),
 		*/
 		agentDir: z.string().optional(),
 		model: AgentModelRefSchema.optional(),
+		/** Per-agent typed model overrides; same `id` replaces the defaults entry. */
+		models: AgentTypedModelsArraySchema,
 		thinkingDefault: z.enum([
 			"off",
 			"minimal",
@@ -1225,6 +1261,6 @@ tts: TTSConfigSchema.optional() }).optional();
 }));
 //#endregion
 init_schema();
-export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, 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, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef };
+export { AgentConfigSchema, AgentDefaultsSchema, AgentImageGenerationModelSchema, AgentModelRefSchema, AgentTypedModelSchema, AgentsConfigSchema, BindingMatchSchema, BindingRuleSchema, BindingsConfigSchema, ChannelsConfigSchema, CommandsConfigSchema, ConfigSchema, CronConfigSchema, ExtensionSecurityConfigSchema, ExtensionSlotsConfigSchema, ExtensionsConfigSchema, GatewayAuthRateLimitSchema, GatewayAuthSchema, GatewayBindModeSchema, GatewayChannelConnectDeferModeSchema, GatewayConfigSchema, GatewayModeSchema, GatewayRemoteSchema, GatewaySecuritySchema, GatewayTailscaleConsentSchema, GatewayTailscaleSchema, GatewayTlsSchema, GatewayTrustedProxySchema, 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, TelegramAccountConfigSchema, TelegramConfigSchema, TelegramGroupConfigSchema, TelegramTopicConfigSchema, ToolsConfigSchema, ToolsMediaAudioConfigSchema, ToolsMediaConfigSchema, TunnelConfigSchema, TunnelConsentSchema, UpdateAutoConfigSchema, UpdateConfigSchema, WebSearchConfigSchema, WebToolsConfigSchema, WebsiteBlocklistSchema, WeixinAccountConfigSchema, WeixinConfigSchema, WorkspaceConfigSchema, WorkspaceImportConfigSchema, getAgentDefaultModelRef, init_schema, parseModelRef };
 
 //# sourceMappingURL=schema.js.map