@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/gateway/file-path-classifier.js

@@ -1,11 +1,11 @@
 import { init_paths_state, resolveStateDir } from "../config/paths-state.js";
 import { init_agent_scope, resolveAgentProfileDir } from "../agent/agent-scope.js";
-import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
 import { extractProfileAgentId } from "../config/agent-profile.js";
+import { init_paths, resolveConfigPath, resolveSkillsDir } from "../config/paths.js";
 import { isBareProfileMarkdownFileName, resolveProfileMarkdownPathIfBareName } from "../agent/tools/tool-paths.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
-import { stat } from "node:fs/promises";
 import { basename, isAbsolute, resolve } from "node:path";
+import { stat } from "node:fs/promises";
 //#region src/gateway/file-path-classifier.ts
 init_agent_scope();
 init_paths();

package/dist/src/gateway/global-defaults-admin.d.ts

@@ -0,0 +1,36 @@
+import { type CapabilityPreset } from '../agent-manifest/schema.js';
+import type { Config } from '../config/schema.js';
+export type GlobalDefaultsProviderSource = 'config' | 'env' | 'oauth' | 'extension' | 'models_json' | 'agent' | null;
+export type GlobalDefaultsProviderRow = {
+    id: string;
+    name: string;
+    configured: boolean;
+    source: GlobalDefaultsProviderSource;
+};
+export type GlobalDefaultsRecommendation = {
+    provider: string;
+    model: string;
+    reason: 'configured-provider' | 'recommended';
+};
+export type GlobalDefaultsPayload = {
+    presetId: string;
+    models: NonNullable<CapabilityPreset['models']>;
+    providers: GlobalDefaultsProviderRow[];
+    recommendations: GlobalDefaultsRecommendation[];
+};
+export type UpdateGlobalDefaultsBody = {
+    models?: CapabilityPreset['models'];
+};
+export type GlobalDefaultsAdminResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+    status?: 400 | 404 | 500;
+};
+export declare function ensureGlobalDefaultsConfig(cfg: Config): Config;
+export declare function listGlobalDefaults(cfg: Config): Promise<GlobalDefaultsPayload>;
+export declare function prepareUpdateGlobalDefaults(cfg: Config, body: UpdateGlobalDefaultsBody): GlobalDefaultsAdminResult<{
+    nextConfig: Config;
+}>;

package/dist/src/gateway/global-defaults-admin.js

@@ -0,0 +1,146 @@
+import { CapabilityPresetSchema, init_schema } from "../agent-manifest/schema.js";
+import { getAllProviders, getModelsByProvider, getProviderAuthState, getProviderDisplayName, init_providers } from "../providers/index.js";
+import { getRecommendedModelsForProvider } from "../providers/presentation.js";
+//#region src/gateway/global-defaults-admin.ts
+init_schema();
+init_providers();
+function defaultPresetId(cfg) {
+	return cfg.agents.defaultPreset || "default";
+}
+function emptyGlobalDefaultsPreset(id) {
+	return {
+		id,
+		name: "Global defaults",
+		description: "Default capabilities inherited by every agent.",
+		version: 1,
+		models: {
+			defaultRole: "deep",
+			roles: {}
+		}
+	};
+}
+function ensureGlobalDefaultsConfig(cfg) {
+	const presetId = defaultPresetId(cfg);
+	const current = cfg.agents.capabilityPresets[presetId];
+	const preset = current ? {
+		...current,
+		id: presetId,
+		name: current.name || "Global defaults",
+		version: current.version || 1,
+		models: current.models ?? {
+			defaultRole: "deep",
+			roles: {}
+		}
+	} : emptyGlobalDefaultsPreset(presetId);
+	return {
+		...cfg,
+		agents: {
+			...cfg.agents,
+			defaultPreset: presetId,
+			capabilityPresets: {
+				...cfg.agents.capabilityPresets,
+				[presetId]: preset
+			}
+		}
+	};
+}
+function sourceFromAuthMode(authMode) {
+	if (authMode === "gateway") return "config";
+	if (authMode === "env") return "env";
+	if (authMode === "oauth") return "oauth";
+	if (authMode === "extension") return "extension";
+	if (authMode === "models_json") return "models_json";
+	if (authMode === "agent") return "agent";
+	return null;
+}
+function recommendedModelForProvider(provider) {
+	const recommended = getRecommendedModelsForProvider(provider, 1)[0];
+	if (recommended) return recommended.ref;
+	const model = getModelsByProvider(provider)[0];
+	return model ? `${provider}/${model.id}` : null;
+}
+async function listGlobalDefaults(cfg) {
+	const normalized = ensureGlobalDefaultsConfig(cfg);
+	const presetId = defaultPresetId(normalized);
+	const preset = normalized.agents.capabilityPresets[presetId] ?? emptyGlobalDefaultsPreset(presetId);
+	const providers = [];
+	const recommendations = [];
+	for (const provider of getAllProviders()) {
+		const auth = await getProviderAuthState(provider);
+		const configured = auth.authStatus === "connected";
+		const source = configured ? sourceFromAuthMode(auth.authMode) : null;
+		providers.push({
+			id: provider,
+			name: getProviderDisplayName(provider),
+			configured,
+			source
+		});
+		if (configured) {
+			const model = recommendedModelForProvider(provider);
+			if (model) recommendations.push({
+				provider,
+				model,
+				reason: "configured-provider"
+			});
+		}
+	}
+	providers.sort((a, b) => Number(b.configured) - Number(a.configured) || a.name.localeCompare(b.name));
+	return {
+		presetId,
+		models: preset.models ?? {
+			defaultRole: "deep",
+			roles: {}
+		},
+		providers,
+		recommendations
+	};
+}
+function prepareUpdateGlobalDefaults(cfg, body) {
+	const normalized = ensureGlobalDefaultsConfig(cfg);
+	const presetId = defaultPresetId(normalized);
+	let nextPreset = normalized.agents.capabilityPresets[presetId] ?? emptyGlobalDefaultsPreset(presetId);
+	if (body.models !== void 0) {
+		const parsed = CapabilityPresetSchema.pick({ models: true }).safeParse({ models: body.models });
+		if (!parsed.success) return {
+			ok: false,
+			error: `models ${parsed.error.issues[0]?.message ?? "is invalid"}`,
+			status: 400
+		};
+		const models = parsed.data.models ?? {
+			defaultRole: "deep",
+			roles: {}
+		};
+		const roles = models.roles ?? {};
+		const defaultRole = models.defaultRole ?? Object.keys(roles)[0] ?? "deep";
+		if (Object.keys(roles).length > 0 && !roles[defaultRole]) return {
+			ok: false,
+			error: "models.defaultRole must reference models.roles",
+			status: 400
+		};
+		nextPreset = {
+			...nextPreset,
+			models: {
+				...models,
+				defaultRole,
+				roles
+			}
+		};
+	}
+	return {
+		ok: true,
+		data: { nextConfig: {
+			...normalized,
+			agents: {
+				...normalized.agents,
+				capabilityPresets: {
+					...normalized.agents.capabilityPresets,
+					[presetId]: nextPreset
+				}
+			}
+		} }
+	};
+}
+//#endregion
+export { ensureGlobalDefaultsConfig, listGlobalDefaults, prepareUpdateGlobalDefaults };
+
+//# sourceMappingURL=global-defaults-admin.js.map

package/dist/src/gateway/global-defaults-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-defaults-admin.js","names":[],"sources":["../../../src/gateway/global-defaults-admin.ts"],"sourcesContent":["import {\n  CapabilityPresetSchema,\n  DEFAULT_CAPABILITY_PRESET_ID,\n  type CapabilityPreset,\n} from '../agent-manifest/schema.js';\nimport type { Config } from '../config/schema.js';\nimport {\n  getAllProviders,\n  getModelsByProvider,\n  getProviderAuthState,\n  getProviderDisplayName,\n} from '../providers/index.js';\nimport { getRecommendedModelsForProvider } from '../providers/presentation.js';\n\nexport type GlobalDefaultsProviderSource = 'config' | 'env' | 'oauth' | 'extension' | 'models_json' | 'agent' | null;\n\nexport type GlobalDefaultsProviderRow = {\n  id: string;\n  name: string;\n  configured: boolean;\n  source: GlobalDefaultsProviderSource;\n};\n\nexport type GlobalDefaultsRecommendation = {\n  provider: string;\n  model: string;\n  reason: 'configured-provider' | 'recommended';\n};\n\nexport type GlobalDefaultsPayload = {\n  presetId: string;\n  models: NonNullable<CapabilityPreset['models']>;\n  providers: GlobalDefaultsProviderRow[];\n  recommendations: GlobalDefaultsRecommendation[];\n};\n\nexport type UpdateGlobalDefaultsBody = {\n  models?: CapabilityPreset['models'];\n};\n\nexport type GlobalDefaultsAdminResult<T> =\n  | { ok: true; data: T }\n  | { ok: false; error: string; status?: 400 | 404 | 500 };\n\nfunction defaultPresetId(cfg: Config): string {\n  return cfg.agents.defaultPreset || DEFAULT_CAPABILITY_PRESET_ID;\n}\n\nfunction emptyGlobalDefaultsPreset(id: string): CapabilityPreset {\n  return {\n    id,\n    name: 'Global defaults',\n    description: 'Default capabilities inherited by every agent.',\n    version: 1,\n    models: {\n      defaultRole: 'deep',\n      roles: {},\n    },\n  };\n}\n\nexport function ensureGlobalDefaultsConfig(cfg: Config): Config {\n  const presetId = defaultPresetId(cfg);\n  const current = cfg.agents.capabilityPresets[presetId];\n  const preset = current\n    ? {\n        ...current,\n        id: presetId,\n        name: current.name || 'Global defaults',\n        version: current.version || 1,\n        models: current.models ?? { defaultRole: 'deep', roles: {} },\n      }\n    : emptyGlobalDefaultsPreset(presetId);\n\n  return {\n    ...cfg,\n    agents: {\n      ...cfg.agents,\n      defaultPreset: presetId,\n      capabilityPresets: {\n        ...cfg.agents.capabilityPresets,\n        [presetId]: preset,\n      },\n    },\n  };\n}\n\nfunction sourceFromAuthMode(authMode: string): GlobalDefaultsProviderSource {\n  if (authMode === 'gateway') return 'config';\n  if (authMode === 'env') return 'env';\n  if (authMode === 'oauth') return 'oauth';\n  if (authMode === 'extension') return 'extension';\n  if (authMode === 'models_json') return 'models_json';\n  if (authMode === 'agent') return 'agent';\n  return null;\n}\n\nfunction recommendedModelForProvider(provider: string): string | null {\n  const recommended = getRecommendedModelsForProvider(provider, 1)[0];\n  if (recommended) return recommended.ref;\n  const model = getModelsByProvider(provider)[0];\n  return model ? `${provider}/${model.id}` : null;\n}\n\nexport async function listGlobalDefaults(cfg: Config): Promise<GlobalDefaultsPayload> {\n  const normalized = ensureGlobalDefaultsConfig(cfg);\n  const presetId = defaultPresetId(normalized);\n  const preset = normalized.agents.capabilityPresets[presetId] ?? emptyGlobalDefaultsPreset(presetId);\n  const providers: GlobalDefaultsProviderRow[] = [];\n  const recommendations: GlobalDefaultsRecommendation[] = [];\n\n  for (const provider of getAllProviders()) {\n    const auth = await getProviderAuthState(provider);\n    const configured = auth.authStatus === 'connected';\n    const source = configured ? sourceFromAuthMode(auth.authMode) : null;\n    providers.push({\n      id: provider,\n      name: getProviderDisplayName(provider),\n      configured,\n      source,\n    });\n    if (configured) {\n      const model = recommendedModelForProvider(provider);\n      if (model) {\n        recommendations.push({ provider, model, reason: 'configured-provider' });\n      }\n    }\n  }\n\n  providers.sort((a, b) => Number(b.configured) - Number(a.configured) || a.name.localeCompare(b.name));\n\n  return {\n    presetId,\n    models: preset.models ?? { defaultRole: 'deep', roles: {} },\n    providers,\n    recommendations,\n  };\n}\n\nexport function prepareUpdateGlobalDefaults(\n  cfg: Config,\n  body: UpdateGlobalDefaultsBody,\n): GlobalDefaultsAdminResult<{ nextConfig: Config }> {\n  const normalized = ensureGlobalDefaultsConfig(cfg);\n  const presetId = defaultPresetId(normalized);\n  const current = normalized.agents.capabilityPresets[presetId] ?? emptyGlobalDefaultsPreset(presetId);\n  let nextPreset: CapabilityPreset = current;\n\n  if (body.models !== undefined) {\n    const parsed = CapabilityPresetSchema.pick({ models: true }).safeParse({ models: body.models });\n    if (!parsed.success) {\n      return { ok: false, error: `models ${parsed.error.issues[0]?.message ?? 'is invalid'}`, status: 400 };\n    }\n    const models = parsed.data.models ?? { defaultRole: 'deep', roles: {} };\n    const roles = models.roles ?? {};\n    const defaultRole = models.defaultRole ?? Object.keys(roles)[0] ?? 'deep';\n    if (Object.keys(roles).length > 0 && !roles[defaultRole]) {\n      return { ok: false, error: 'models.defaultRole must reference models.roles', status: 400 };\n    }\n    nextPreset = {\n      ...nextPreset,\n      models: { ...models, defaultRole, roles },\n    };\n  }\n\n  return {\n    ok: true,\n    data: {\n      nextConfig: {\n        ...normalized,\n        agents: {\n          ...normalized.agents,\n          capabilityPresets: {\n            ...normalized.agents.capabilityPresets,\n            [presetId]: nextPreset,\n          },\n        },\n      },\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/src/gateway/hono/lib/agent-model.d.ts

@@ -22,7 +22,7 @@ export declare function agentImageGenerationModelTimeoutMs(ref: unknown): number
 /** Read `autoProviderFallback` from an image-generation model ref. Defaults to false. */
 export declare function agentImageGenerationModelAutoProviderFallback(ref: unknown): boolean;
 /**
- * PATCH body normalizer for `agents.defaults.imageGenerationModel`. Always
+ * PATCH body normalizer for image-generation model refs. Always
  * emits `{ primary, fallbacks?, timeoutMs?, autoProviderFallback? }`. Returns
  * `undefined` when the input has no usable primary so the caller can skip the
  * assignment.

package/dist/src/gateway/hono/lib/agent-model.js

@@ -76,7 +76,7 @@ function agentImageGenerationModelAutoProviderFallback(ref) {
 	return ref.autoProviderFallback === true;
 }
 /**
-* PATCH body normalizer for `agents.defaults.imageGenerationModel`. Always
+* PATCH body normalizer for image-generation model refs. Always
 * emits `{ primary, fallbacks?, timeoutMs?, autoProviderFallback? }`. Returns
 * `undefined` when the input has no usable primary so the caller can skip the
 * assignment.

package/dist/src/gateway/hono/lib/agent-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-model.js","names":[],"sources":["../../../../../src/gateway/hono/lib/agent-model.ts"],"sourcesContent":["import type { AgentTypedModel } from '../../../config/schema.js';\n\nconst TYPED_MODEL_ID_RE = /^[a-z][a-z0-9_-]{0,63}$/;\n\nfunction isValidProviderModelRef(ref: string): boolean {\n  const trimmed = ref.trim();\n  const idx = trimmed.indexOf('/');\n  return idx > 0 && idx < trimmed.length - 1;\n}\n\n/**\n * Coerce PATCH body `{ roles: Record<id, role> }` into validated typed model roles.\n * Returns `null` to clear, `undefined` when input should be skipped, or cleaned roles.\n * Empty roles after filtering → `null` (same as clear).\n */\nexport function normalizePatchTypedModels(\n  v: unknown,\n): Record<string, Omit<AgentTypedModel, 'id'>> | null | undefined {\n  if (v === undefined) return undefined;\n  if (v === null) return null;\n  if (!v || typeof v !== 'object' || Array.isArray(v) || !('roles' in v)) return undefined;\n  const rawRoles = (v as { roles?: unknown }).roles;\n  if (!rawRoles || typeof rawRoles !== 'object' || Array.isArray(rawRoles)) return undefined;\n  const rows = Object.entries(rawRoles).map(([id, role]) => ({ id, ...(role as object) }));\n\n  const byId = new Map<string, Omit<AgentTypedModel, 'id'>>();\n  for (const raw of rows) {\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) continue;\n    const o = raw as Record<string, unknown>;\n    const id = typeof o.id === 'string' ? o.id.trim() : '';\n    const model = typeof o.model === 'string' ? o.model.trim() : '';\n    if (!id || !TYPED_MODEL_ID_RE.test(id) || !model || !isValidProviderModelRef(model)) continue;\n    const description =\n      typeof o.description === 'string' && o.description.trim()\n        ? o.description.trim().slice(0, 500)\n        : undefined;\n    byId.set(id, description ? { description, model } : { model });\n  }\n\n  if (byId.size === 0) return null;\n  return Object.fromEntries(byId.entries());\n}\n\n/** Read `primary` from an `AgentModelConfig` object. */\nexport function agentModelRefToString(ref: unknown): string | undefined {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return undefined;\n  const p = (ref as { primary?: string }).primary;\n  return typeof p === 'string' && p.trim() ? p : undefined;\n}\n\nexport function agentModelFallbacksToArray(ref: unknown): string[] {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return [];\n  const f = (ref as { fallbacks?: unknown }).fallbacks;\n  if (!Array.isArray(f)) return [];\n  return f.filter((x): x is string => typeof x === 'string' && x.trim().length > 0);\n}\n\n/**\n * Coerce a PATCH body `model` value into the canonical `{ primary, fallbacks? }`\n * object form. Returns `undefined` when the input has no usable primary so the\n * caller can skip the assignment.\n */\nexport function normalizePatchAgentModel(v: unknown): { primary: string; fallbacks?: string[] } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks.filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n    : [];\n  return fallbacks.length > 0 ? { primary, fallbacks } : { primary };\n}\n\n/** Read `timeoutMs` from an image-generation model ref (only set when ref is an object). */\nexport function agentImageGenerationModelTimeoutMs(ref: unknown): number | null {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return null;\n  const v = (ref as { timeoutMs?: unknown }).timeoutMs;\n  return typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : null;\n}\n\n/** Read `autoProviderFallback` from an image-generation model ref. Defaults to false. */\nexport function agentImageGenerationModelAutoProviderFallback(ref: unknown): boolean {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return false;\n  return (ref as { autoProviderFallback?: unknown }).autoProviderFallback === true;\n}\n\n/**\n * PATCH body normalizer for `agents.defaults.imageGenerationModel`. Always\n * emits `{ primary, fallbacks?, timeoutMs?, autoProviderFallback? }`. Returns\n * `undefined` when the input has no usable primary so the caller can skip the\n * assignment.\n */\nexport function normalizePatchAgentImageGenerationModel(\n  v: unknown,\n): { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const out: { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } = { primary };\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks\n        .filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n        .map((x) => x.trim())\n    : [];\n  if (fallbacks.length > 0) out.fallbacks = fallbacks;\n  if (typeof o.timeoutMs === 'number' && Number.isFinite(o.timeoutMs) && o.timeoutMs > 0) {\n    out.timeoutMs = Math.floor(o.timeoutMs);\n  }\n  if (o.autoProviderFallback === true) out.autoProviderFallback = true;\n  return out;\n}\n"],"mappings":"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"}
+{"version":3,"file":"agent-model.js","names":[],"sources":["../../../../../src/gateway/hono/lib/agent-model.ts"],"sourcesContent":["import type { AgentTypedModel } from '../../../config/schema.js';\n\nconst TYPED_MODEL_ID_RE = /^[a-z][a-z0-9_-]{0,63}$/;\n\nfunction isValidProviderModelRef(ref: string): boolean {\n  const trimmed = ref.trim();\n  const idx = trimmed.indexOf('/');\n  return idx > 0 && idx < trimmed.length - 1;\n}\n\n/**\n * Coerce PATCH body `{ roles: Record<id, role> }` into validated typed model roles.\n * Returns `null` to clear, `undefined` when input should be skipped, or cleaned roles.\n * Empty roles after filtering → `null` (same as clear).\n */\nexport function normalizePatchTypedModels(\n  v: unknown,\n): Record<string, Omit<AgentTypedModel, 'id'>> | null | undefined {\n  if (v === undefined) return undefined;\n  if (v === null) return null;\n  if (!v || typeof v !== 'object' || Array.isArray(v) || !('roles' in v)) return undefined;\n  const rawRoles = (v as { roles?: unknown }).roles;\n  if (!rawRoles || typeof rawRoles !== 'object' || Array.isArray(rawRoles)) return undefined;\n  const rows = Object.entries(rawRoles).map(([id, role]) => ({ id, ...(role as object) }));\n\n  const byId = new Map<string, Omit<AgentTypedModel, 'id'>>();\n  for (const raw of rows) {\n    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) continue;\n    const o = raw as Record<string, unknown>;\n    const id = typeof o.id === 'string' ? o.id.trim() : '';\n    const model = typeof o.model === 'string' ? o.model.trim() : '';\n    if (!id || !TYPED_MODEL_ID_RE.test(id) || !model || !isValidProviderModelRef(model)) continue;\n    const description =\n      typeof o.description === 'string' && o.description.trim()\n        ? o.description.trim().slice(0, 500)\n        : undefined;\n    byId.set(id, description ? { description, model } : { model });\n  }\n\n  if (byId.size === 0) return null;\n  return Object.fromEntries(byId.entries());\n}\n\n/** Read `primary` from an `AgentModelConfig` object. */\nexport function agentModelRefToString(ref: unknown): string | undefined {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return undefined;\n  const p = (ref as { primary?: string }).primary;\n  return typeof p === 'string' && p.trim() ? p : undefined;\n}\n\nexport function agentModelFallbacksToArray(ref: unknown): string[] {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return [];\n  const f = (ref as { fallbacks?: unknown }).fallbacks;\n  if (!Array.isArray(f)) return [];\n  return f.filter((x): x is string => typeof x === 'string' && x.trim().length > 0);\n}\n\n/**\n * Coerce a PATCH body `model` value into the canonical `{ primary, fallbacks? }`\n * object form. Returns `undefined` when the input has no usable primary so the\n * caller can skip the assignment.\n */\nexport function normalizePatchAgentModel(v: unknown): { primary: string; fallbacks?: string[] } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks.filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n    : [];\n  return fallbacks.length > 0 ? { primary, fallbacks } : { primary };\n}\n\n/** Read `timeoutMs` from an image-generation model ref (only set when ref is an object). */\nexport function agentImageGenerationModelTimeoutMs(ref: unknown): number | null {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return null;\n  const v = (ref as { timeoutMs?: unknown }).timeoutMs;\n  return typeof v === 'number' && Number.isFinite(v) && v > 0 ? v : null;\n}\n\n/** Read `autoProviderFallback` from an image-generation model ref. Defaults to false. */\nexport function agentImageGenerationModelAutoProviderFallback(ref: unknown): boolean {\n  if (!ref || typeof ref !== 'object' || Array.isArray(ref)) return false;\n  return (ref as { autoProviderFallback?: unknown }).autoProviderFallback === true;\n}\n\n/**\n * PATCH body normalizer for image-generation model refs. Always\n * emits `{ primary, fallbacks?, timeoutMs?, autoProviderFallback? }`. Returns\n * `undefined` when the input has no usable primary so the caller can skip the\n * assignment.\n */\nexport function normalizePatchAgentImageGenerationModel(\n  v: unknown,\n): { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } | undefined {\n  if (!v || typeof v !== 'object' || Array.isArray(v)) return undefined;\n  const o = v as Record<string, unknown>;\n  const primary = typeof o.primary === 'string' ? o.primary.trim() : '';\n  if (!primary) return undefined;\n  const out: { primary: string; fallbacks?: string[]; timeoutMs?: number; autoProviderFallback?: true } = { primary };\n  const fallbacks = Array.isArray(o.fallbacks)\n    ? o.fallbacks\n        .filter((x): x is string => typeof x === 'string' && x.trim().length > 0)\n        .map((x) => x.trim())\n    : [];\n  if (fallbacks.length > 0) out.fallbacks = fallbacks;\n  if (typeof o.timeoutMs === 'number' && Number.isFinite(o.timeoutMs) && o.timeoutMs > 0) {\n    out.timeoutMs = Math.floor(o.timeoutMs);\n  }\n  if (o.autoProviderFallback === true) out.autoProviderFallback = true;\n  return out;\n}\n"],"mappings":"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"}