@xopcai/xopc 0.0.103 → 0.0.105

package/dist/src/gateway/agent-builtin-tools.js

@@ -11,14 +11,30 @@ const GATEWAY_BUILTIN_TOOL_IDS = [
 	"grep",
 	"find",
 	"shell",
+	"session_status",
+	"dreaming",
+	"tool_manual",
+	"clarify",
+	"todo",
+	"skills_list",
+	"skill_view",
+	"skill_manage",
 	"web_search",
 	"web_fetch",
+	"web_extract",
 	"send_message",
 	"send_media",
+	"read_media",
+	"create_share",
+	"text_to_speech",
 	"memory_search",
 	"memory_get",
 	"curated_memory",
 	"session_search",
+	"cronjob",
+	"workflow",
+	"delegate_task",
+	"execute_code",
 	"image",
 	"image_generate",
 	"browser_use",

package/dist/src/gateway/agent-builtin-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-builtin-tools.js","names":[],"sources":["../../../src/gateway/agent-builtin-tools.ts"],"sourcesContent":["/**\n * Built-in agent tool `name` values for gateway admin UI (disable toggles).\n * Extension tools are not listed; users can still add arbitrary strings in config.\n */\nexport const GATEWAY_BUILTIN_TOOL_IDS = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'list_dir',\n  'grep',\n  'find',\n  'shell',\n  'web_search',\n  'web_fetch',\n  'send_message',\n  'send_media',\n  'memory_search',\n  'memory_get',\n  'curated_memory',\n  'session_search',\n  'image',\n  'image_generate',\n  'browser_use',\n  'extensions',\n  'bundle-mcp',\n] as const;\n\nexport type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];\n"],"mappings":";;;;;AAIA,MAAa,2BAA2B;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}
+{"version":3,"file":"agent-builtin-tools.js","names":[],"sources":["../../../src/gateway/agent-builtin-tools.ts"],"sourcesContent":["/**\n * Built-in agent tool `name` values for gateway admin UI (disable toggles).\n * Extension tools are not listed; users can still add arbitrary strings in config.\n */\nexport const GATEWAY_BUILTIN_TOOL_IDS = [\n  'read_file',\n  'write_file',\n  'edit_file',\n  'list_dir',\n  'grep',\n  'find',\n  'shell',\n  'session_status',\n  'dreaming',\n  'tool_manual',\n  'clarify',\n  'todo',\n  'skills_list',\n  'skill_view',\n  'skill_manage',\n  'web_search',\n  'web_fetch',\n  'web_extract',\n  'send_message',\n  'send_media',\n  'read_media',\n  'create_share',\n  'text_to_speech',\n  'memory_search',\n  'memory_get',\n  'curated_memory',\n  'session_search',\n  'cronjob',\n  'workflow',\n  'delegate_task',\n  'execute_code',\n  'image',\n  'image_generate',\n  'browser_use',\n  'extensions',\n  'bundle-mcp',\n] as const;\n\nexport type GatewayBuiltinToolId = (typeof GATEWAY_BUILTIN_TOOL_IDS)[number];\n"],"mappings":";;;;;AAIA,MAAa,2BAA2B;CACtC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD"}

package/dist/src/gateway/agent-run-relay.d.ts

@@ -5,14 +5,13 @@
  */
 export type RelayEvent = {
     type: string;
-    [key: string]: unknown;
-};
+} & Record<string, unknown>;
 export declare class AgentRunRelay {
     private runs;
     ensureRun(runId: string, sessionKey: string): void;
     getSessionKey(runId: string): string | undefined;
     hasRun(runId: string): boolean;
-    publish(runId: string, event: RelayEvent): void;
+    publish(runId: string, event: RelayEvent): RelayEvent | undefined;
     complete(runId: string): void;
     subscribe(runId: string): AsyncGenerator<RelayEvent>;
 }

package/dist/src/gateway/agent-run-relay.js

@@ -12,6 +12,7 @@ var AgentRunRelay = class {
 		this.runs.set(runId, {
 			sessionKey,
 			events: [],
+			nextSeq: 1,
 			done: false,
 			waiters: []
 		});
@@ -24,15 +25,21 @@ var AgentRunRelay = class {
 	}
 	publish(runId, event) {
 		const state = this.runs.get(runId);
-		if (!state) return;
+		if (!state) return void 0;
+		const relayed = {
+			...event,
+			runId,
+			seq: state.nextSeq++
+		};
 		if (state.events.length >= MAX_EVENTS) log.warn({
 			runId,
 			max: MAX_EVENTS,
-			droppedType: event.type
+			droppedType: relayed.type
 		}, "Relay buffer full; dropping event (resume may miss tool_end/tokens)");
-		else state.events.push(event);
+		else state.events.push(relayed);
 		const waiters = state.waiters.splice(0);
 		for (const w of waiters) w();
+		return relayed;
 	}
 	complete(runId) {
 		const state = this.runs.get(runId);

package/dist/src/gateway/agent-run-relay.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-run-relay.js","names":[],"sources":["../../../src/gateway/agent-run-relay.ts"],"sourcesContent":["/**\n * Multicast buffer for a single web agent run so multiple HTTP SSE consumers can\n * attach (initial POST /api/agent and later POST /api/agent/resume) while one\n * background pump drains processDirectStreaming.\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('Gateway:AgentRunRelay');\n\nexport type RelayEvent = { type: string; [key: string]: unknown };\n\ntype RunState = {\n  sessionKey: string;\n  events: RelayEvent[];\n  done: boolean;\n  waiters: Array<() => void>;\n  cleanupTimer?: ReturnType<typeof setTimeout>;\n};\n\nconst COMPLETE_TTL_MS = 5 * 60_000;\nconst MAX_EVENTS = 8000;\n\nexport class AgentRunRelay {\n  private runs = new Map<string, RunState>();\n\n  ensureRun(runId: string, sessionKey: string): void {\n    if (this.runs.has(runId)) return;\n    this.runs.set(runId, { sessionKey, events: [], done: false, waiters: [] });\n  }\n\n  getSessionKey(runId: string): string | undefined {\n    return this.runs.get(runId)?.sessionKey;\n  }\n\n  hasRun(runId: string): boolean {\n    return this.runs.has(runId);\n  }\n\n  publish(runId: string, event: RelayEvent): void {\n    const state = this.runs.get(runId);\n    if (!state) return;\n    if (state.events.length >= MAX_EVENTS) {\n      log.warn(\n        { runId, max: MAX_EVENTS, droppedType: event.type },\n        'Relay buffer full; dropping event (resume may miss tool_end/tokens)',\n      );\n    } else {\n      state.events.push(event);\n    }\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n  }\n\n  complete(runId: string): void {\n    const state = this.runs.get(runId);\n    if (!state) return;\n    state.done = true;\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n    if (state.cleanupTimer) clearTimeout(state.cleanupTimer);\n    state.cleanupTimer = setTimeout(() => {\n      this.runs.delete(runId);\n    }, COMPLETE_TTL_MS);\n  }\n\n  async *subscribe(runId: string): AsyncGenerator<RelayEvent> {\n    const state = this.runs.get(runId);\n    if (!state) {\n      throw new Error('UNKNOWN_RUN');\n    }\n    let cursor = 0;\n    while (true) {\n      while (cursor < state.events.length) {\n        yield state.events[cursor++];\n      }\n      if (state.done) break;\n      await new Promise<void>((resolve) => {\n        state.waiters.push(resolve);\n      });\n    }\n  }\n}\n"],"mappings":";;;aAMkD;AAElD,MAAM,MAAM,aAAa,wBAAwB;AAYjD,MAAM,kBAAkB,IAAI;AAC5B,MAAM,aAAa;AAEnB,IAAa,gBAAb,MAA2B;CACzB,uBAAe,IAAI,KAAuB;CAE1C,UAAU,OAAe,YAA0B;AACjD,MAAI,KAAK,KAAK,IAAI,MAAM,CAAE;AAC1B,OAAK,KAAK,IAAI,OAAO;GAAE;GAAY,QAAQ,EAAE;GAAE,MAAM;GAAO,SAAS,EAAE;GAAE,CAAC;;CAG5E,cAAc,OAAmC;AAC/C,SAAO,KAAK,KAAK,IAAI,MAAM,EAAE;;CAG/B,OAAO,OAAwB;AAC7B,SAAO,KAAK,KAAK,IAAI,MAAM;;CAG7B,QAAQ,OAAe,OAAyB;EAC9C,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO;AACZ,MAAI,MAAM,OAAO,UAAU,WACzB,KAAI,KACF;GAAE;GAAO,KAAK;GAAY,aAAa,MAAM;GAAM,EACnD,sEACD;MAED,OAAM,OAAO,KAAK,MAAM;EAE1B,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;;CAG9B,SAAS,OAAqB;EAC5B,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO;AACZ,QAAM,OAAO;EACb,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;AAC5B,MAAI,MAAM,aAAc,cAAa,MAAM,aAAa;AACxD,QAAM,eAAe,iBAAiB;AACpC,QAAK,KAAK,OAAO,MAAM;KACtB,gBAAgB;;CAGrB,OAAO,UAAU,OAA2C;EAC1D,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,cAAc;EAEhC,IAAI,SAAS;AACb,SAAO,MAAM;AACX,UAAO,SAAS,MAAM,OAAO,OAC3B,OAAM,MAAM,OAAO;AAErB,OAAI,MAAM,KAAM;AAChB,SAAM,IAAI,SAAe,YAAY;AACnC,UAAM,QAAQ,KAAK,QAAQ;KAC3B"}
+{"version":3,"file":"agent-run-relay.js","names":[],"sources":["../../../src/gateway/agent-run-relay.ts"],"sourcesContent":["/**\n * Multicast buffer for a single web agent run so multiple HTTP SSE consumers can\n * attach (initial POST /api/agent and later POST /api/agent/resume) while one\n * background pump drains processDirectStreaming.\n */\n\nimport { createLogger } from '../utils/logger.js';\n\nconst log = createLogger('Gateway:AgentRunRelay');\n\nexport type RelayEvent = { type: string } & Record<string, unknown>;\n\ntype RunState = {\n  sessionKey: string;\n  events: RelayEvent[];\n  nextSeq: number;\n  done: boolean;\n  waiters: Array<() => void>;\n  cleanupTimer?: ReturnType<typeof setTimeout>;\n};\n\nconst COMPLETE_TTL_MS = 5 * 60_000;\nconst MAX_EVENTS = 8000;\n\nexport class AgentRunRelay {\n  private runs = new Map<string, RunState>();\n\n  ensureRun(runId: string, sessionKey: string): void {\n    if (this.runs.has(runId)) return;\n    this.runs.set(runId, { sessionKey, events: [], nextSeq: 1, done: false, waiters: [] });\n  }\n\n  getSessionKey(runId: string): string | undefined {\n    return this.runs.get(runId)?.sessionKey;\n  }\n\n  hasRun(runId: string): boolean {\n    return this.runs.has(runId);\n  }\n\n  publish(runId: string, event: RelayEvent): RelayEvent | undefined {\n    const state = this.runs.get(runId);\n    if (!state) return undefined;\n    const relayed = {\n      ...event,\n      runId,\n      seq: state.nextSeq++,\n    };\n    if (state.events.length >= MAX_EVENTS) {\n      log.warn(\n        { runId, max: MAX_EVENTS, droppedType: relayed.type },\n        'Relay buffer full; dropping event (resume may miss tool_end/tokens)',\n      );\n    } else {\n      state.events.push(relayed);\n    }\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n    return relayed;\n  }\n\n  complete(runId: string): void {\n    const state = this.runs.get(runId);\n    if (!state) return;\n    state.done = true;\n    const waiters = state.waiters.splice(0);\n    for (const w of waiters) w();\n    if (state.cleanupTimer) clearTimeout(state.cleanupTimer);\n    state.cleanupTimer = setTimeout(() => {\n      this.runs.delete(runId);\n    }, COMPLETE_TTL_MS);\n  }\n\n  async *subscribe(runId: string): AsyncGenerator<RelayEvent> {\n    const state = this.runs.get(runId);\n    if (!state) {\n      throw new Error('UNKNOWN_RUN');\n    }\n    let cursor = 0;\n    while (true) {\n      while (cursor < state.events.length) {\n        yield state.events[cursor++];\n      }\n      if (state.done) break;\n      await new Promise<void>((resolve) => {\n        state.waiters.push(resolve);\n      });\n    }\n  }\n}\n"],"mappings":";;;aAMkD;AAElD,MAAM,MAAM,aAAa,wBAAwB;AAajD,MAAM,kBAAkB,IAAI;AAC5B,MAAM,aAAa;AAEnB,IAAa,gBAAb,MAA2B;CACzB,uBAAe,IAAI,KAAuB;CAE1C,UAAU,OAAe,YAA0B;AACjD,MAAI,KAAK,KAAK,IAAI,MAAM,CAAE;AAC1B,OAAK,KAAK,IAAI,OAAO;GAAE;GAAY,QAAQ,EAAE;GAAE,SAAS;GAAG,MAAM;GAAO,SAAS,EAAE;GAAE,CAAC;;CAGxF,cAAc,OAAmC;AAC/C,SAAO,KAAK,KAAK,IAAI,MAAM,EAAE;;CAG/B,OAAO,OAAwB;AAC7B,SAAO,KAAK,KAAK,IAAI,MAAM;;CAG7B,QAAQ,OAAe,OAA2C;EAChE,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO,QAAO,KAAA;EACnB,MAAM,UAAU;GACd,GAAG;GACH;GACA,KAAK,MAAM;GACZ;AACD,MAAI,MAAM,OAAO,UAAU,WACzB,KAAI,KACF;GAAE;GAAO,KAAK;GAAY,aAAa,QAAQ;GAAM,EACrD,sEACD;MAED,OAAM,OAAO,KAAK,QAAQ;EAE5B,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;AAC5B,SAAO;;CAGT,SAAS,OAAqB;EAC5B,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MAAO;AACZ,QAAM,OAAO;EACb,MAAM,UAAU,MAAM,QAAQ,OAAO,EAAE;AACvC,OAAK,MAAM,KAAK,QAAS,IAAG;AAC5B,MAAI,MAAM,aAAc,cAAa,MAAM,aAAa;AACxD,QAAM,eAAe,iBAAiB;AACpC,QAAK,KAAK,OAAO,MAAM;KACtB,gBAAgB;;CAGrB,OAAO,UAAU,OAA2C;EAC1D,MAAM,QAAQ,KAAK,KAAK,IAAI,MAAM;AAClC,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,cAAc;EAEhC,IAAI,SAAS;AACb,SAAO,MAAM;AACX,UAAO,SAAS,MAAM,OAAO,OAC3B,OAAM,MAAM,OAAO;AAErB,OAAI,MAAM,KAAM;AAChB,SAAM,IAAI,SAAe,YAAY;AACnC,UAAM,QAAQ,KAAK,QAAQ;KAC3B"}

package/dist/src/gateway/agents-admin.d.ts

@@ -1,21 +1,18 @@
 /**
  * Gateway REST helpers for multi-agent management.
  */
-import type { Config } from '../config/schema.js';
-import type { LocalizedText } from '../config/localized-text.js';
+import type { AgentModelsConfig, Config } from '../config/schema.js';
 import type { AgentTypedModel } from '../config/schema.js';
 export type GatewayAgentTypedModelsInfo = {
     defaults: AgentTypedModel[];
+    entry?: AgentTypedModel[];
     effective: AgentTypedModel[];
 };
 export type GatewayAgentRow = {
     id: string;
     name?: string;
     description?: string;
-    localized?: {
-        name?: LocalizedText;
-        description?: LocalizedText;
-    };
+    language?: string;
     /** Value from `IDENTITY.md` **Avatar:** line when present (may be URL, `xopc:…`, etc.). */
     avatar?: string;
     workspace: string;
@@ -45,20 +42,27 @@ export type GatewayAgentsListResponse = {
 };
 /** Extract `**Avatar:**` value from profile IDENTITY.md (same line shape as the gateway console parser). */
 export declare function extractAvatarFromIdentityMarkdown(content: string): string | undefined;
-export declare function listGatewayAgents(cfg: Config, options?: {
+export declare function parseIdentityMarkdown(content: string): {
+    name?: string;
+    description?: string;
+    language?: string;
+    avatar?: string;
+};
+export declare function listGatewayAgents(cfg: Config, _options?: {
     locale?: string;
 }): Promise<GatewayAgentsListResponse>;
 export type CreateAgentBody = {
-    /** Display name stored on the agent entry. */
-    name: LocalizedText;
-    /** Optional id seed; normalized agent id defaults from `name` when omitted. */
+    /** Optional id seed; normalized agent id defaults from `profileFiles["IDENTITY.md"]` name when omitted. */
     id?: string;
     workspace: string;
-    model?: string;
+    models?: AgentModelsConfig;
     agentDir?: string;
-    description?: LocalizedText;
-    /** Initial `agents.list[].tools.disable` for the new entry. */
-    toolsDisable?: string[];
+    /** Initial `agents.list[].skills` for the new entry. */
+    skills?: string[];
+    /** Initial `agents.list[].tools` for the new entry. */
+    tools?: {
+        disable?: string[];
+    };
     /** Profile markdown files to write after seeding (e.g. `IDENTITY.md`, `SOUL.md`). */
     profileFiles?: Record<string, string>;
     /** Clone from an existing agent id — copies config entry fields and profile directory. */
@@ -91,16 +95,25 @@ export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string, op
     cloneFrom?: string;
 }): Promise<AgentAdminResult<void>>;
 export type UpdateAgentBody = {
-    name?: LocalizedText;
-    description?: LocalizedText | null;
     workspace?: string;
-    model?: string | null;
+    models?: {
+        chat?: {
+            primary: string;
+            fallbacks?: string[];
+        } | null;
+        roles?: Record<string, {
+            model: string;
+            description?: string;
+        }> | null;
+    } | null;
     agentDir?: string | null;
     setDefault?: boolean;
     /** Replace `agents.list[].skills`; `null` removes the key (inherit defaults). */
     skills?: string[] | null;
-    /** Replace `agents.list[].tools.disable`; `null` clears entry-level disables. */
-    toolsDisable?: string[] | null;
+    /** Replace `agents.list[].tools`; `null` removes the key (inherit defaults). */
+    tools?: {
+        disable?: string[] | null;
+    } | null;
 };
 export declare function prepareUpdateAgent(cfg: Config, agentIdRaw: string, body: UpdateAgentBody): AgentAdminResult<{
     nextConfig: Config;

package/dist/src/gateway/agents-admin.js

@@ -1,10 +1,10 @@
 import { DEFAULT_AGENT_ID, init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
 import { WORKSPACE_FILES, init_paths } from "../config/paths.js";
-import { init_localized_text, normalizeLocalizedText, resolveLocalizedText } from "../config/localized-text.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "../agent/context/workspace.js";
 import { isPathUnderWorkspace, resolveWorkspaceSafePath } from "./workspace-editor-path.js";
 import { applyAgentConfig, findAgentEntryIndex, pruneAgentConfig, removeAgentDirsFromDisk } from "../commands/agents.config.js";
+import { resolveEffectiveTypedModels } from "../config/agent-typed-models.js";
 import { GATEWAY_BUILTIN_TOOL_IDS } from "./agent-builtin-tools.js";
 import { seedAgentProfileMarkdownFiles } from "../agent/context/workspace-seed.js";
 import { cp, mkdir, readFile, readdir, realpath, stat, unlink, writeFile } from "node:fs/promises";
@@ -14,7 +14,6 @@ import { join, resolve } from "node:path";
 * Gateway REST helpers for multi-agent management.
 */
 init_agent_scope();
-init_localized_text();
 init_paths();
 const EDITABLE_PROFILE_MARKDOWN_NAMES = new Set([...AGENT_PROFILE_MARKDOWN_SYSTEM_FILES]);
 function collectAgentIdsForList(cfg) {
@@ -26,22 +25,38 @@ function collectAgentIdsForList(cfg) {
 	ids.add(defaultId);
 	return [...ids];
 }
+function rolesToTypedModels(roles) {
+	return Object.entries(roles ?? {}).map(([id, role]) => ({
+		id,
+		...role
+	})).sort((a, b) => a.id.localeCompare(b.id));
+}
 /** Extract `**Avatar:**` value from profile IDENTITY.md (same line shape as the gateway console parser). */
 function extractAvatarFromIdentityMarkdown(content) {
+	return parseIdentityMarkdown(content).avatar || void 0;
+}
+function parseIdentityMarkdown(content) {
+	const out = {};
 	for (const line of content.split("\n")) {
-		const match = line.match(/^[-*]\s+\*\*Avatar:\*\*\s*(.*)/i);
+		const match = line.match(/^[-*]\s+\*\*(Name|Description|Language|Avatar):\*\*\s*(.*)/i);
 		if (match) {
-			const v = match[1]?.trim() ?? "";
-			return v.length > 0 ? v : void 0;
+			const key = match[1]?.toLowerCase();
+			const v = match[2]?.trim() ?? "";
+			if (!v || /^_\(.*\)_$/.test(v)) continue;
+			if (key === "name") out.name = v;
+			if (key === "description") out.description = v;
+			if (key === "language") out.language = v;
+			if (key === "avatar") out.avatar = v;
 		}
 	}
+	return out;
 }
-async function listGatewayAgents(cfg, options = {}) {
+async function listGatewayAgents(cfg, _options = {}) {
 	const defaultId = resolveDefaultAgentId(cfg);
 	const agents = [];
 	const defaultsSkills = cfg.agents?.defaults?.skills;
 	const defaultsDisable = cfg.agents?.defaults?.tools?.disable ?? [];
-	const defaultsTypedModels = cfg.agents?.defaults?.models ?? [];
+	const defaultsTypedModels = rolesToTypedModels(cfg.agents?.defaults?.models?.roles);
 	for (const id of collectAgentIdsForList(cfg)) {
 		const profile = resolveEffectiveAgentProfile(cfg, id);
 		const entry = listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);
@@ -51,29 +66,24 @@ async function listGatewayAgents(cfg, options = {}) {
 		} : void 0;
 		const entrySkills = entry?.skills;
 		const entryDisable = entry?.tools?.disable ?? [];
-		const effectiveTypedModels = [...defaultsTypedModels];
-		let avatar;
+		const entryTypedModels = rolesToTypedModels(entry?.models?.roles);
+		const effectiveTypedModels = [...resolveEffectiveTypedModels(cfg, id).values()].sort((a, b) => a.id.localeCompare(b.id));
+		let identity = {};
 		try {
-			avatar = extractAvatarFromIdentityMarkdown(await readFile(join(resolveAgentProfileDir(cfg, id), WORKSPACE_FILES.IDENTITY), "utf-8"));
+			identity = parseIdentityMarkdown(await readFile(join(resolveAgentProfileDir(cfg, id), WORKSPACE_FILES.IDENTITY), "utf-8"));
 		} catch {}
-		const localizedName = normalizeLocalizedText(entry?.name);
-		const localizedDescription = normalizeLocalizedText(entry?.description);
-		const displayName = resolveLocalizedText(localizedName, options.locale);
-		const displayDescription = resolveLocalizedText(localizedDescription, options.locale);
 		agents.push({
 			id,
-			...displayName ? { name: displayName } : {},
-			...displayDescription ? { description: displayDescription } : {},
-			...localizedName || localizedDescription ? { localized: {
-				...localizedName ? { name: localizedName } : {},
-				...localizedDescription ? { description: localizedDescription } : {}
-			} } : {},
-			...avatar ? { avatar } : {},
+			...identity.name ? { name: identity.name } : {},
+			...identity.description ? { description: identity.description } : {},
+			...identity.language ? { language: identity.language } : {},
+			...identity.avatar ? { avatar: identity.avatar } : {},
 			workspace: profile.resolvedWorkspacePath,
 			profileDir: resolveAgentProfileDir(cfg, id),
 			...model ? { model } : {},
 			typedModels: {
 				defaults: [...defaultsTypedModels],
+				...entryTypedModels.length > 0 ? { entry: entryTypedModels } : {},
 				effective: effectiveTypedModels
 			},
 			isDefault: id === defaultId,
@@ -105,31 +115,12 @@ function requireNonMain(id) {
 	return null;
 }
 function prepareCreateAgent(cfg, body) {
-	const normalizedName = normalizeLocalizedText(body.name);
-	const nameSeed = resolveLocalizedText(normalizedName, "en") ?? "";
-	if (!nameSeed) return {
-		ok: false,
-		error: "name is required",
-		status: 400
-	};
 	const workspace = body.workspace?.trim() ?? "";
 	if (!workspace) return {
 		ok: false,
 		error: "workspace is required",
 		status: 400
 	};
-	const idRes = validateAgentIdForNewAgent(body.id, nameSeed);
-	if (idRes.ok === false) return {
-		ok: false,
-		error: idRes.error,
-		status: 400
-	};
-	const agentId = idRes.agentId;
-	if (findAgentEntryIndex(listAgentEntries(cfg), agentId) >= 0) return {
-		ok: false,
-		error: `agent "${agentId}" already exists`,
-		status: 409
-	};
 	if (body.profileFiles !== void 0) {
 		if (typeof body.profileFiles !== "object" || body.profileFiles === null || Array.isArray(body.profileFiles)) return {
 			ok: false,
@@ -146,6 +137,24 @@ function prepareCreateAgent(cfg, body) {
 			};
 		}
 	}
+	if (!body.cloneFrom && typeof body.profileFiles?.[WORKSPACE_FILES.IDENTITY] !== "string") return {
+		ok: false,
+		error: `profileFiles["${WORKSPACE_FILES.IDENTITY}"] is required`,
+		status: 400
+	};
+	const nameSeed = (body.profileFiles?.[WORKSPACE_FILES.IDENTITY] ? parseIdentityMarkdown(body.profileFiles[WORKSPACE_FILES.IDENTITY]) : {}).name ?? body.id ?? "";
+	const idRes = validateAgentIdForNewAgent(body.id, nameSeed);
+	if (idRes.ok === false) return {
+		ok: false,
+		error: idRes.error,
+		status: 400
+	};
+	const agentId = idRes.agentId;
+	if (findAgentEntryIndex(listAgentEntries(cfg), agentId) >= 0) return {
+		ok: false,
+		error: `agent "${agentId}" already exists`,
+		status: 409
+	};
 	let cloneSourceEntry;
 	if (body.cloneFrom) {
 		const srcId = normalizeAgentId(body.cloneFrom);
@@ -157,42 +166,25 @@ function prepareCreateAgent(cfg, body) {
 		};
 	}
 	const wsAbs = resolveUserPath(workspace);
-	const effectiveModel = body.model?.trim() ? body.model.trim() : cloneSourceEntry?.model?.primary;
+	const effectiveModels = body.models ?? cloneSourceEntry?.models;
 	let next = applyAgentConfig(cfg, {
 		agentId,
-		name: normalizedName,
 		workspace: wsAbs,
-		...effectiveModel ? { model: effectiveModel } : {},
+		...effectiveModels ? { models: effectiveModels } : {},
 		...body.agentDir?.trim() ? { agentDir: body.agentDir.trim() } : {},
-		...normalizeLocalizedText(body.description) ? { description: normalizeLocalizedText(body.description) } : {}
+		...body.skills !== void 0 ? { skills: body.skills.map((s) => String(s).trim()).filter(Boolean) } : cloneSourceEntry?.skills !== void 0 && body.cloneFrom ? { skills: [...cloneSourceEntry.skills] } : {}
 	});
-	const toolsDisable = body.toolsDisable ?? cloneSourceEntry?.tools?.disable;
-	if (toolsDisable !== void 0) {
+	const tools = body.tools ?? cloneSourceEntry?.tools;
+	if (tools !== void 0) {
 		const list = [...listAgentEntries(next)];
 		const idx = findAgentEntryIndex(list, agentId);
 		if (idx >= 0) {
 			const entry = { ...list[idx] };
-			const disable = toolsDisable.map((s) => String(s).trim()).filter(Boolean);
+			const disable = tools.disable?.map((s) => String(s).trim()).filter(Boolean) ?? [];
 			entry.tools = {
 				...entry.tools,
-				disable
-			};
-			if (cloneSourceEntry?.skills !== void 0 && body.cloneFrom) entry.skills = [...cloneSourceEntry.skills];
-			list[idx] = entry;
-			next = {
-				...next,
-				agents: {
-					...next.agents,
-					list
-				}
+				...disable.length > 0 ? { disable } : {}
 			};
-		}
-	} else if (cloneSourceEntry && body.cloneFrom) {
-		const list = [...listAgentEntries(next)];
-		const idx = findAgentEntryIndex(list, agentId);
-		if (idx >= 0) {
-			const entry = { ...list[idx] };
-			if (cloneSourceEntry.skills !== void 0) entry.skills = [...cloneSourceEntry.skills];
 			list[idx] = entry;
 			next = {
 				...next,
@@ -245,7 +237,7 @@ async function finalizeCreateAgentDirs(cfg, agentId, opts) {
 	await mkdir(profilePath, { recursive: true });
 	await mkdir(adPath, { recursive: true });
 	const id = normalizeAgentId(agentId);
-	const displayName = resolveLocalizedText(normalizeLocalizedText(listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id)?.name), "en") || id;
+	const displayName = opts?.profileFiles?.[WORKSPACE_FILES.IDENTITY] ? parseIdentityMarkdown(opts.profileFiles[WORKSPACE_FILES.IDENTITY]).name ?? id : id;
 	if (opts?.cloneFrom) {
 		const srcProfilePath = resolveAgentProfileDir(cfg, normalizeAgentId(opts.cloneFrom));
 		try {
@@ -290,28 +282,51 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 		status: 404
 	};
 	const entry = { ...list[idx] };
-	if (body.name !== void 0) {
-		const nextName = normalizeLocalizedText(body.name);
-		if (nextName) entry.name = nextName;
-	}
-	if (body.description !== void 0) {
-		const nextDescription = body.description === null ? void 0 : normalizeLocalizedText(body.description);
-		if (nextDescription) entry.description = nextDescription;
-		else delete entry.description;
-	}
 	if (body.workspace !== void 0) {
 		const w = body.workspace.trim();
 		if (w) entry.workspace = resolveUserPath(w);
 	}
-	if (body.model !== void 0) if (body.model === null) delete entry.model;
+	if (body.models !== void 0) if (body.models === null) delete entry.models;
 	else {
-		const trimmed = String(body.model).trim();
-		if (!trimmed) return {
-			ok: false,
-			error: "model must be a non-empty string or null",
-			status: 400
-		};
-		entry.model = { primary: trimmed };
+		if (Object.hasOwn(body.models, "chat")) {
+			if (body.models.chat === null) {
+				if (entry.models) delete entry.models.chat;
+			} else if (body.models.chat !== void 0) {
+				const primary = body.models.chat.primary.trim();
+				if (!primary) return {
+					ok: false,
+					error: "models.chat.primary must be a non-empty string",
+					status: 400
+				};
+				const fallbacks = body.models.chat.fallbacks?.map((s) => s.trim()).filter(Boolean);
+				entry.models = {
+					...entry.models,
+					chat: {
+						primary,
+						...fallbacks && fallbacks.length > 0 ? { fallbacks } : {}
+					}
+				};
+			}
+		}
+		if (Object.hasOwn(body.models, "roles")) {
+			if (body.models.roles === null) {
+				if (entry.models) delete entry.models.roles;
+			} else if (body.models.roles !== void 0) {
+				const roles = Object.fromEntries(Object.entries(body.models.roles).map(([id, row]) => ({
+					id: id.trim(),
+					model: row.model.trim(),
+					description: row.description?.trim()
+				})).filter((row) => row.id && row.model).map((row) => [row.id, row.description ? {
+					model: row.model,
+					description: row.description
+				} : { model: row.model }]));
+				entry.models = {
+					...entry.models,
+					roles
+				};
+			}
+		}
+		if (entry.models && Object.keys(entry.models).length === 0) delete entry.models;
 	}
 	if (body.agentDir !== void 0) if (body.agentDir === null || String(body.agentDir).trim() === "") delete entry.agentDir;
 	else entry.agentDir = String(body.agentDir).trim();
@@ -321,17 +336,22 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 		if (next.length === 0) entry.skills = [];
 		else entry.skills = next;
 	}
-	if (body.toolsDisable !== void 0) if (body.toolsDisable === null) {
-		if (entry.tools) {
-			delete entry.tools.disable;
-			if (Object.keys(entry.tools).length === 0) delete entry.tools;
+	if (body.tools !== void 0) {
+		if (body.tools === null) delete entry.tools;
+		else if (Object.hasOwn(body.tools, "disable")) {
+			if (body.tools.disable === null) {
+				if (entry.tools) {
+					delete entry.tools.disable;
+					if (Object.keys(entry.tools).length === 0) delete entry.tools;
+				}
+			} else if (body.tools.disable !== void 0) {
+				const next = body.tools.disable.map((s) => String(s).trim()).filter(Boolean);
+				entry.tools = {
+					...entry.tools,
+					disable: next
+				};
+			}
 		}
-	} else {
-		const next = body.toolsDisable.map((s) => String(s).trim()).filter(Boolean);
-		entry.tools = {
-			...entry.tools,
-			disable: next
-		};
 	}
 	list[idx] = entry;
 	let next = {
@@ -638,6 +658,6 @@ async function deleteAgentAvatarFile(cfg, agentId) {
 	};
 }
 //#endregion
-export { deleteAgentAvatarFile, extractAvatarFromIdentityMarkdown, finalizeCreateAgentDirs, listAgentProfileFiles, listGatewayAgents, prepareCreateAgent, prepareCreateAgentsBatch, prepareDeleteAgent, prepareUpdateAgent, readAgentAvatarFile, readAgentProfileFile, runAfterDeletePurge, writeAgentAvatarFromBase64, writeAgentProfileFile };
+export { deleteAgentAvatarFile, extractAvatarFromIdentityMarkdown, finalizeCreateAgentDirs, listAgentProfileFiles, listGatewayAgents, parseIdentityMarkdown, prepareCreateAgent, prepareCreateAgentsBatch, prepareDeleteAgent, prepareUpdateAgent, readAgentAvatarFile, readAgentProfileFile, runAfterDeletePurge, writeAgentAvatarFromBase64, writeAgentProfileFile };
 
 //# sourceMappingURL=agents-admin.js.map