@xopcai/xopc 0.0.89 → 0.0.90

package/dist/src/extensions/update.js

@@ -0,0 +1,260 @@
+import { createLogger } from "../utils/logger/index.js";
+import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from "../config/paths.js";
+import { init_loader, loadConfig } from "../config/loader.js";
+import { getExtensionLockfileManager } from "./lockfile.js";
+import { installExtensionFromStoreZip, installFromNpm } from "./install.js";
+import { findExtension } from "./marketplace.js";
+import { downloadExtensionStoreZipBuffer, resolveExtensionZipDownloadUrl, resolveExtensionsStoreBaseUrl } from "../agent/skills/marketplace/adapters/store/store-api-client.js";
+import { existsSync, readFileSync, readdirSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import semver from "semver";
+//#region src/extensions/update.ts
+/**
+* Post-update extension sync — refresh lockfile-managed npm / store extensions.
+*/
+init_paths();
+init_loader();
+init_logger();
+const log = createLogger("ExtensionUpdate");
+const MANIFEST = "xopc.extension.json";
+function readInstalledExtensionVersion(targetDir, extensionId) {
+	const manifestPath = join(targetDir, extensionId, MANIFEST);
+	if (!existsSync(manifestPath)) return;
+	try {
+		const raw = JSON.parse(readFileSync(manifestPath, "utf-8"));
+		return (typeof raw.version === "string" ? semver.valid(raw.version) : null) ?? void 0;
+	} catch {
+		return;
+	}
+}
+async function resolveNpmPackageForId(extensionId) {
+	return (await findExtension(extensionId))?.npmPackage;
+}
+async function upsertNpmExtensionLock(lock, targetDir, result, spec) {
+	if (!result.extensionId) return;
+	const reg = await findExtension(result.extensionId);
+	const resolved = reg?.npmPackage ?? spec;
+	let ver = reg?.version ?? "0.0.0";
+	try {
+		const raw = readFileSync(join(targetDir, result.extensionId, MANIFEST), "utf-8");
+		const m = JSON.parse(raw);
+		const mv = typeof m.version === "string" ? semver.valid(m.version) : null;
+		if (mv) ver = mv;
+	} catch {}
+	await lock.upsert(result.extensionId, {
+		name: result.extensionId,
+		version: ver,
+		resolved,
+		source: "npm"
+	});
+}
+async function installExtensionFromStoreWithLock(params) {
+	try {
+		const { downloadUrl, version } = await resolveExtensionZipDownloadUrl(params.storeBase, params.packageName, params.version);
+		const result = await installExtensionFromStoreZip(await downloadExtensionStoreZipBuffer(params.storeBase, downloadUrl), params.targetDir);
+		if (!result.ok || !result.extensionId) return {
+			ok: false,
+			error: result.error ?? "install failed"
+		};
+		await params.lock.upsert(result.extensionId, {
+			name: result.extensionId,
+			version,
+			resolved: params.packageName,
+			source: "store"
+		});
+		return {
+			ok: true,
+			extensionId: result.extensionId,
+			version
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
+function listBundledExtensionIds() {
+	const ids = /* @__PURE__ */ new Set();
+	const bundledDir = resolveBundledExtensionsDir();
+	if (!bundledDir || !existsSync(bundledDir)) return ids;
+	for (const entry of readdirSync(bundledDir, { withFileTypes: true })) if (entry.isDirectory()) ids.add(entry.name);
+	return ids;
+}
+async function syncExtensionsForUpdateChannel(params) {
+	const logger = params.logger ?? {};
+	const summary = {
+		skippedBundled: [],
+		warnings: []
+	};
+	const skipIds = /* @__PURE__ */ new Set();
+	if (params.channel !== "dev") return {
+		skipIds,
+		summary
+	};
+	const data = await getExtensionLockfileManager().load();
+	const bundledIds = listBundledExtensionIds();
+	for (const extensionId of Object.keys(data.extensions)) {
+		if (!bundledIds.has(extensionId)) continue;
+		skipIds.add(extensionId);
+		summary.skippedBundled.push(extensionId);
+		logger.info?.(`Skipping "${extensionId}" on dev channel (bundled copy preferred).`);
+	}
+	return {
+		skipIds,
+		summary
+	};
+}
+async function updateSingleExtension(params) {
+	const { extensionId, entry, targetDir, storeBase, lock, timeoutMs, logger } = params;
+	const currentVersion = readInstalledExtensionVersion(targetDir, extensionId);
+	if (entry.source === "store") {
+		const pkgName = entry.resolved?.trim() || extensionId;
+		if (existsSync(join(targetDir, extensionId))) rmSync(join(targetDir, extensionId), {
+			recursive: true,
+			force: true
+		});
+		const result = await installExtensionFromStoreWithLock({
+			storeBase,
+			packageName: pkgName,
+			targetDir,
+			lock
+		});
+		if (result.ok === false) {
+			logger.error?.(`Failed to update ${extensionId}: ${result.error}`);
+			return {
+				extensionId,
+				status: "error",
+				message: result.error,
+				currentVersion
+			};
+		}
+		const nextVersion = result.version;
+		const status = currentVersion && nextVersion && currentVersion === nextVersion ? "unchanged" : "updated";
+		return {
+			extensionId,
+			status,
+			currentVersion,
+			nextVersion,
+			message: status === "unchanged" ? `${extensionId} is up to date (${currentVersion}).` : `Updated ${extensionId}: ${currentVersion ?? "unknown"} -> ${nextVersion}.`
+		};
+	}
+	if (entry.source !== "npm") return {
+		extensionId,
+		status: "skipped",
+		message: `Skipping "${extensionId}" (source: ${entry.source}).`
+	};
+	const spec = entry.resolved?.trim() || await resolveNpmPackageForId(extensionId);
+	if (!spec) return {
+		extensionId,
+		status: "skipped",
+		message: `Skipping "${extensionId}" (could not resolve npm package).`
+	};
+	if (existsSync(join(targetDir, extensionId))) rmSync(join(targetDir, extensionId), {
+		recursive: true,
+		force: true
+	});
+	const installResult = await installFromNpm(spec, targetDir, timeoutMs);
+	if (!installResult.ok) {
+		const message = installResult.error ?? "npm install failed";
+		logger.error?.(`Failed to update ${extensionId}: ${message}`);
+		return {
+			extensionId,
+			status: "error",
+			message,
+			currentVersion
+		};
+	}
+	await upsertNpmExtensionLock(lock, targetDir, installResult, spec);
+	const nextVersion = (installResult.extensionId ? readInstalledExtensionVersion(targetDir, installResult.extensionId) : void 0) ?? entry.version;
+	const resolvedId = installResult.extensionId ?? extensionId;
+	const status = currentVersion && nextVersion && currentVersion === nextVersion ? "unchanged" : "updated";
+	return {
+		extensionId: resolvedId,
+		status,
+		currentVersion,
+		nextVersion,
+		message: status === "unchanged" ? `${resolvedId} is up to date (${currentVersion}).` : `Updated ${resolvedId}: ${currentVersion ?? "unknown"} -> ${nextVersion}.`
+	};
+}
+async function updateNpmInstalledExtensions(params) {
+	const logger = params.logger ?? {};
+	const config = params.config ?? loadConfig();
+	const targetDir = resolveExtensionsDir();
+	const storeBase = resolveExtensionsStoreBaseUrl(config);
+	const lock = getExtensionLockfileManager();
+	const data = await lock.load();
+	const ids = params.extensionIds?.length ? params.extensionIds : Object.keys(data.extensions);
+	if (ids.length === 0) return {
+		outcomes: [],
+		status: "skipped"
+	};
+	const outcomes = [];
+	let hasError = false;
+	for (const extensionId of ids) {
+		if (params.skipIds?.has(extensionId)) {
+			outcomes.push({
+				extensionId,
+				status: "skipped",
+				message: `Skipping "${extensionId}" (channel sync).`
+			});
+			continue;
+		}
+		const entry = data.extensions[extensionId];
+		if (!entry) {
+			outcomes.push({
+				extensionId,
+				status: "skipped",
+				message: `No lockfile entry for "${extensionId}".`
+			});
+			continue;
+		}
+		const outcome = await updateSingleExtension({
+			extensionId,
+			entry,
+			targetDir,
+			storeBase,
+			lock,
+			timeoutMs: params.timeoutMs,
+			logger
+		});
+		outcomes.push(outcome);
+		if (outcome.status === "error") hasError = true;
+		else if (outcome.status === "updated") log.info({
+			extensionId: outcome.extensionId,
+			nextVersion: outcome.nextVersion
+		}, outcome.message);
+	}
+	return {
+		outcomes,
+		status: hasError ? "error" : "ok"
+	};
+}
+async function runPostUpdateExtensionSync(params) {
+	const logger = params.logger ?? {
+		info: (message) => log.info(message),
+		warn: (message) => log.warn(message),
+		error: (message) => log.error(message)
+	};
+	const channelSyncResult = await syncExtensionsForUpdateChannel({
+		channel: params.channel,
+		config: params.config,
+		logger
+	});
+	const updateResult = await updateNpmInstalledExtensions({
+		skipIds: channelSyncResult.skipIds,
+		config: params.config,
+		timeoutMs: params.timeoutMs,
+		logger
+	});
+	return {
+		status: updateResult.status,
+		outcomes: updateResult.outcomes,
+		channelSync: channelSyncResult.summary
+	};
+}
+//#endregion
+export { runPostUpdateExtensionSync, syncExtensionsForUpdateChannel, updateNpmInstalledExtensions };
+
+//# sourceMappingURL=update.js.map

package/dist/src/extensions/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","names":["marketplace.findExtension"],"sources":["../../../src/extensions/update.ts"],"sourcesContent":["/**\n * Post-update extension sync — refresh lockfile-managed npm / store extensions.\n */\n\nimport { existsSync, readFileSync, readdirSync, rmSync } from 'node:fs';\nimport { join } from 'node:path';\nimport semver from 'semver';\n\nimport {\n  downloadExtensionStoreZipBuffer,\n  resolveExtensionZipDownloadUrl,\n  resolveExtensionsStoreBaseUrl,\n} from '../agent/skills/marketplace/adapters/store/store-api-client.js';\nimport type { Config } from '../config/schema.js';\nimport { resolveBundledExtensionsDir, resolveExtensionsDir } from '../config/paths.js';\nimport { loadConfig } from '../config/loader.js';\nimport type { UpdateChannel } from '../infra/update-channels.js';\nimport { createLogger } from '../utils/logger.js';\nimport {\n  installExtensionFromStoreZip,\n  installFromNpm,\n  type InstallResult,\n} from './install.js';\nimport {\n  getExtensionLockfileManager,\n  type ExtensionLockEntry,\n} from './lockfile.js';\nimport * as marketplace from './marketplace.js';\n\nconst log = createLogger('ExtensionUpdate');\n\nconst MANIFEST = 'xopc.extension.json';\n\nexport type ExtensionUpdateLogger = {\n  info?: (message: string) => void;\n  warn?: (message: string) => void;\n  error?: (message: string) => void;\n};\n\nexport type ExtensionUpdateStatus = 'updated' | 'unchanged' | 'skipped' | 'error';\n\nexport type ExtensionUpdateOutcome = {\n  extensionId: string;\n  status: ExtensionUpdateStatus;\n  message: string;\n  currentVersion?: string;\n  nextVersion?: string;\n};\n\nexport type ExtensionChannelSyncSummary = {\n  skippedBundled: string[];\n  warnings: string[];\n};\n\nexport type ExtensionPostUpdateResult = {\n  status: 'ok' | 'error' | 'skipped';\n  outcomes: ExtensionUpdateOutcome[];\n  channelSync?: ExtensionChannelSyncSummary;\n};\n\nfunction readInstalledExtensionVersion(targetDir: string, extensionId: string): string | undefined {\n  const manifestPath = join(targetDir, extensionId, MANIFEST);\n  if (!existsSync(manifestPath)) {\n    return undefined;\n  }\n  try {\n    const raw = JSON.parse(readFileSync(manifestPath, 'utf-8')) as { version?: string };\n    const version = typeof raw.version === 'string' ? semver.valid(raw.version) : null;\n    return version ?? undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function resolveNpmPackageForId(extensionId: string): Promise<string | undefined> {\n  const found = await marketplace.findExtension(extensionId);\n  return found?.npmPackage;\n}\n\nasync function upsertNpmExtensionLock(\n  lock: ReturnType<typeof getExtensionLockfileManager>,\n  targetDir: string,\n  result: InstallResult,\n  spec: string,\n): Promise<void> {\n  if (!result.extensionId) return;\n  const reg = await marketplace.findExtension(result.extensionId);\n  const resolved = reg?.npmPackage ?? spec;\n  let ver = reg?.version ?? '0.0.0';\n  try {\n    const raw = readFileSync(join(targetDir, result.extensionId, MANIFEST), 'utf-8');\n    const m = JSON.parse(raw) as { version?: string };\n    const mv = typeof m.version === 'string' ? semver.valid(m.version) : null;\n    if (mv) ver = mv;\n  } catch {\n    // keep registry / fallback version\n  }\n  await lock.upsert(result.extensionId, {\n    name: result.extensionId,\n    version: ver,\n    resolved,\n    source: 'npm',\n  });\n}\n\nasync function installExtensionFromStoreWithLock(params: {\n  storeBase: string;\n  packageName: string;\n  version?: string;\n  targetDir: string;\n  lock: ReturnType<typeof getExtensionLockfileManager>;\n}): Promise<{ ok: true; extensionId: string; version: string } | { ok: false; error: string }> {\n  try {\n    const { downloadUrl, version } = await resolveExtensionZipDownloadUrl(\n      params.storeBase,\n      params.packageName,\n      params.version,\n    );\n    const buf = await downloadExtensionStoreZipBuffer(params.storeBase, downloadUrl);\n    const result = await installExtensionFromStoreZip(buf, params.targetDir);\n    if (!result.ok || !result.extensionId) {\n      return { ok: false, error: result.error ?? 'install failed' };\n    }\n    await params.lock.upsert(result.extensionId, {\n      name: result.extensionId,\n      version,\n      resolved: params.packageName,\n      source: 'store',\n    });\n    return { ok: true, extensionId: result.extensionId, version };\n  } catch (err) {\n    return { ok: false, error: err instanceof Error ? err.message : String(err) };\n  }\n}\n\nfunction listBundledExtensionIds(): Set<string> {\n  const ids = new Set<string>();\n  const bundledDir = resolveBundledExtensionsDir();\n  if (!bundledDir || !existsSync(bundledDir)) {\n    return ids;\n  }\n  for (const entry of readdirSync(bundledDir, { withFileTypes: true })) {\n    if (entry.isDirectory()) {\n      ids.add(entry.name);\n    }\n  }\n  return ids;\n}\n\nexport async function syncExtensionsForUpdateChannel(params: {\n  channel: UpdateChannel;\n  config?: Config;\n  logger?: ExtensionUpdateLogger;\n}): Promise<{ skipIds: Set<string>; summary: ExtensionChannelSyncSummary }> {\n  const logger = params.logger ?? {};\n  const summary: ExtensionChannelSyncSummary = {\n    skippedBundled: [],\n    warnings: [],\n  };\n  const skipIds = new Set<string>();\n\n  if (params.channel !== 'dev') {\n    return { skipIds, summary };\n  }\n\n  const lock = getExtensionLockfileManager();\n  const data = await lock.load();\n  const bundledIds = listBundledExtensionIds();\n\n  for (const extensionId of Object.keys(data.extensions)) {\n    if (!bundledIds.has(extensionId)) {\n      continue;\n    }\n    skipIds.add(extensionId);\n    summary.skippedBundled.push(extensionId);\n    logger.info?.(`Skipping \"${extensionId}\" on dev channel (bundled copy preferred).`);\n  }\n\n  return { skipIds, summary };\n}\n\nasync function updateSingleExtension(params: {\n  extensionId: string;\n  entry: ExtensionLockEntry;\n  targetDir: string;\n  storeBase: string;\n  lock: ReturnType<typeof getExtensionLockfileManager>;\n  timeoutMs?: number;\n  logger?: ExtensionUpdateLogger;\n}): Promise<ExtensionUpdateOutcome> {\n  const { extensionId, entry, targetDir, storeBase, lock, timeoutMs, logger } = params;\n  const currentVersion = readInstalledExtensionVersion(targetDir, extensionId);\n\n  if (entry.source === 'store') {\n    const pkgName = entry.resolved?.trim() || extensionId;\n    if (existsSync(join(targetDir, extensionId))) {\n      rmSync(join(targetDir, extensionId), { recursive: true, force: true });\n    }\n    const result = await installExtensionFromStoreWithLock({\n      storeBase,\n      packageName: pkgName,\n      targetDir,\n      lock,\n    });\n    if (result.ok === false) {\n      logger.error?.(`Failed to update ${extensionId}: ${result.error}`);\n      return {\n        extensionId,\n        status: 'error',\n        message: result.error,\n        currentVersion,\n      };\n    }\n    const nextVersion = result.version;\n    const status =\n      currentVersion && nextVersion && currentVersion === nextVersion ? 'unchanged' : 'updated';\n    return {\n      extensionId,\n      status,\n      currentVersion,\n      nextVersion,\n      message:\n        status === 'unchanged'\n          ? `${extensionId} is up to date (${currentVersion}).`\n          : `Updated ${extensionId}: ${currentVersion ?? 'unknown'} -> ${nextVersion}.`,\n    };\n  }\n\n  if (entry.source !== 'npm') {\n    return {\n      extensionId,\n      status: 'skipped',\n      message: `Skipping \"${extensionId}\" (source: ${entry.source}).`,\n    };\n  }\n\n  const spec = entry.resolved?.trim() || (await resolveNpmPackageForId(extensionId));\n  if (!spec) {\n    return {\n      extensionId,\n      status: 'skipped',\n      message: `Skipping \"${extensionId}\" (could not resolve npm package).`,\n    };\n  }\n\n  if (existsSync(join(targetDir, extensionId))) {\n    rmSync(join(targetDir, extensionId), { recursive: true, force: true });\n  }\n\n  const installResult = await installFromNpm(spec, targetDir, timeoutMs);\n  if (!installResult.ok) {\n    const message = installResult.error ?? 'npm install failed';\n    logger.error?.(`Failed to update ${extensionId}: ${message}`);\n    return {\n      extensionId,\n      status: 'error',\n      message,\n      currentVersion,\n    };\n  }\n\n  await upsertNpmExtensionLock(lock, targetDir, installResult, spec);\n  const nextVersion =\n    (installResult.extensionId\n      ? readInstalledExtensionVersion(targetDir, installResult.extensionId)\n      : undefined) ?? entry.version;\n  const resolvedId = installResult.extensionId ?? extensionId;\n  const status =\n    currentVersion && nextVersion && currentVersion === nextVersion ? 'unchanged' : 'updated';\n  return {\n    extensionId: resolvedId,\n    status,\n    currentVersion,\n    nextVersion,\n    message:\n      status === 'unchanged'\n        ? `${resolvedId} is up to date (${currentVersion}).`\n        : `Updated ${resolvedId}: ${currentVersion ?? 'unknown'} -> ${nextVersion}.`,\n  };\n}\n\nexport async function updateNpmInstalledExtensions(params: {\n  extensionIds?: string[];\n  skipIds?: Set<string>;\n  config?: Config;\n  timeoutMs?: number;\n  logger?: ExtensionUpdateLogger;\n}): Promise<{ outcomes: ExtensionUpdateOutcome[]; status: 'ok' | 'error' | 'skipped' }> {\n  const logger = params.logger ?? {};\n  const config = params.config ?? loadConfig();\n  const targetDir = resolveExtensionsDir();\n  const storeBase = resolveExtensionsStoreBaseUrl(config);\n  const lock = getExtensionLockfileManager();\n  const data = await lock.load();\n\n  const ids = params.extensionIds?.length\n    ? params.extensionIds\n    : Object.keys(data.extensions);\n\n  if (ids.length === 0) {\n    return { outcomes: [], status: 'skipped' };\n  }\n\n  const outcomes: ExtensionUpdateOutcome[] = [];\n  let hasError = false;\n\n  for (const extensionId of ids) {\n    if (params.skipIds?.has(extensionId)) {\n      outcomes.push({\n        extensionId,\n        status: 'skipped',\n        message: `Skipping \"${extensionId}\" (channel sync).`,\n      });\n      continue;\n    }\n\n    const entry = data.extensions[extensionId];\n    if (!entry) {\n      outcomes.push({\n        extensionId,\n        status: 'skipped',\n        message: `No lockfile entry for \"${extensionId}\".`,\n      });\n      continue;\n    }\n\n    const outcome = await updateSingleExtension({\n      extensionId,\n      entry,\n      targetDir,\n      storeBase,\n      lock,\n      timeoutMs: params.timeoutMs,\n      logger,\n    });\n    outcomes.push(outcome);\n    if (outcome.status === 'error') {\n      hasError = true;\n    } else if (outcome.status === 'updated') {\n      log.info(\n        { extensionId: outcome.extensionId, nextVersion: outcome.nextVersion },\n        outcome.message,\n      );\n    }\n  }\n\n  return { outcomes, status: hasError ? 'error' : 'ok' };\n}\n\nexport async function runPostUpdateExtensionSync(params: {\n  channel: UpdateChannel;\n  config?: Config;\n  timeoutMs?: number;\n  logger?: ExtensionUpdateLogger;\n}): Promise<ExtensionPostUpdateResult> {\n  const logger = params.logger ?? {\n    info: (message) => log.info(message),\n    warn: (message) => log.warn(message),\n    error: (message) => log.error(message),\n  };\n\n  const channelSyncResult = await syncExtensionsForUpdateChannel({\n    channel: params.channel,\n    config: params.config,\n    logger,\n  });\n\n  const updateResult = await updateNpmInstalledExtensions({\n    skipIds: channelSyncResult.skipIds,\n    config: params.config,\n    timeoutMs: params.timeoutMs,\n    logger,\n  });\n\n  return {\n    status: updateResult.status,\n    outcomes: updateResult.outcomes,\n    channelSync: channelSyncResult.summary,\n  };\n}\n"],"mappings":"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"}

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

@@ -2,16 +2,20 @@
  * Gateway REST helpers for multi-agent management.
  */
 import type { Config } from '../config/schema.js';
+import type { LocalizedText } from '../config/localized-text.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;
+    };
     /** Value from `IDENTITY.md` **Avatar:** line when present (may be URL, `xopc:…`, etc.). */
     avatar?: string;
     workspace: string;
@@ -41,20 +45,24 @@ 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): Promise<GatewayAgentsListResponse>;
+export declare function listGatewayAgents(cfg: Config, options?: {
+    locale?: string;
+}): Promise<GatewayAgentsListResponse>;
 export type CreateAgentBody = {
     /** Display name stored on the agent entry. */
-    name: string;
+    name: LocalizedText;
     /** Optional id seed; normalized agent id defaults from `name` when omitted. */
     id?: string;
     workspace: string;
     model?: string;
     agentDir?: string;
-    description?: string;
+    description?: LocalizedText;
     /** Initial `agents.list[].tools.disable` for the new entry. */
     toolsDisable?: 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. */
+    cloneFrom?: string;
 };
 export type AgentAdminHttpStatus = 400 | 404 | 409;
 export type AgentAdminResult<T> = {
@@ -80,10 +88,11 @@ export declare function prepareCreateAgentsBatch(cfg: Config, bodies: CreateAgen
 }>;
 export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string, opts?: {
     profileFiles?: Record<string, string>;
+    cloneFrom?: string;
 }): Promise<AgentAdminResult<void>>;
 export type UpdateAgentBody = {
-    name?: string;
-    description?: string | null;
+    name?: LocalizedText;
+    description?: LocalizedText | null;
     workspace?: string;
     model?: string | null;
     agentDir?: string | null;
@@ -92,8 +101,6 @@ export type UpdateAgentBody = {
     skills?: string[] | null;
     /** Replace `agents.list[].tools.disable`; `null` clears entry-level disables. */
     toolsDisable?: string[] | null;
-    /** Replace `agents.list[].models`; `null` removes entry overrides (inherit defaults). */
-    models?: AgentTypedModel[] | null;
 };
 export declare function prepareUpdateAgent(cfg: Config, agentIdRaw: string, body: UpdateAgentBody): AgentAdminResult<{
     nextConfig: Config;

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

@@ -1,20 +1,20 @@
 import { DEFAULT_AGENT_ID, init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
-import { resolveEffectiveAgentProfile } from "../config/agent-profile.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 { normalizePatchTypedModels } from "./hono/lib/agent-model.js";
+import { cp, mkdir, readFile, readdir, realpath, stat, unlink, writeFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
-import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";
 //#region src/gateway/agents-admin.ts
 /**
 * 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, WORKSPACE_FILES.BOOTSTRAP]);
 function collectAgentIdsForList(cfg) {
@@ -36,7 +36,7 @@ function extractAvatarFromIdentityMarkdown(content) {
 		}
 	}
 }
-async function listGatewayAgents(cfg) {
+async function listGatewayAgents(cfg, options = {}) {
 	const defaultId = resolveDefaultAgentId(cfg);
 	const agents = [];
 	const defaultsSkills = cfg.agents?.defaults?.skills;
@@ -51,23 +51,29 @@ async function listGatewayAgents(cfg) {
 		} : void 0;
 		const entrySkills = entry?.skills;
 		const entryDisable = entry?.tools?.disable ?? [];
-		const entryTypedModels = entry?.models;
-		const effectiveTypedModels = [...resolveEffectiveTypedModels(cfg, id).values()];
+		const effectiveTypedModels = [...defaultsTypedModels];
 		let avatar;
 		try {
 			avatar = extractAvatarFromIdentityMarkdown(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,
-			...entry?.name?.trim() ? { name: entry.name.trim() } : {},
-			...entry?.description?.trim() ? { description: entry.description.trim() } : {},
+			...displayName ? { name: displayName } : {},
+			...displayDescription ? { description: displayDescription } : {},
+			...localizedName || localizedDescription ? { localized: {
+				...localizedName ? { name: localizedName } : {},
+				...localizedDescription ? { description: localizedDescription } : {}
+			} } : {},
 			...avatar ? { avatar } : {},
 			workspace: profile.resolvedWorkspacePath,
 			profileDir: resolveAgentProfileDir(cfg, id),
 			...model ? { model } : {},
 			typedModels: {
 				defaults: [...defaultsTypedModels],
-				...entryTypedModels !== void 0 ? { entry: [...entryTypedModels] } : {},
 				effective: effectiveTypedModels
 			},
 			isDefault: id === defaultId,
@@ -99,8 +105,9 @@ function requireNonMain(id) {
 	return null;
 }
 function prepareCreateAgent(cfg, body) {
-	const name = body.name?.trim() ?? "";
-	if (!name) return {
+	const normalizedName = normalizeLocalizedText(body.name);
+	const nameSeed = resolveLocalizedText(normalizedName, "en") ?? "";
+	if (!nameSeed) return {
 		ok: false,
 		error: "name is required",
 		status: 400
@@ -111,7 +118,7 @@ function prepareCreateAgent(cfg, body) {
 		error: "workspace is required",
 		status: 400
 	};
-	const idRes = validateAgentIdForNewAgent(body.id, name);
+	const idRes = validateAgentIdForNewAgent(body.id, nameSeed);
 	if (idRes.ok === false) return {
 		ok: false,
 		error: idRes.error,
@@ -139,25 +146,53 @@ function prepareCreateAgent(cfg, body) {
 			};
 		}
 	}
+	let cloneSourceEntry;
+	if (body.cloneFrom) {
+		const srcId = normalizeAgentId(body.cloneFrom);
+		cloneSourceEntry = listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === srcId);
+		if (!cloneSourceEntry && srcId !== resolveDefaultAgentId(cfg)) return {
+			ok: false,
+			error: `source agent "${srcId}" not found`,
+			status: 404
+		};
+	}
 	const wsAbs = resolveUserPath(workspace);
+	const effectiveModel = body.model?.trim() ? body.model.trim() : cloneSourceEntry?.model?.primary;
 	let next = applyAgentConfig(cfg, {
 		agentId,
-		name,
+		name: normalizedName,
 		workspace: wsAbs,
-		...body.model?.trim() ? { model: body.model.trim() } : {},
+		...effectiveModel ? { model: effectiveModel } : {},
 		...body.agentDir?.trim() ? { agentDir: body.agentDir.trim() } : {},
-		...body.description?.trim() ? { description: body.description.trim() } : {}
+		...normalizeLocalizedText(body.description) ? { description: normalizeLocalizedText(body.description) } : {}
 	});
-	if (body.toolsDisable !== void 0) {
+	const toolsDisable = body.toolsDisable ?? cloneSourceEntry?.tools?.disable;
+	if (toolsDisable !== void 0) {
 		const list = [...listAgentEntries(next)];
 		const idx = findAgentEntryIndex(list, agentId);
 		if (idx >= 0) {
 			const entry = { ...list[idx] };
-			const disable = body.toolsDisable.map((s) => String(s).trim()).filter(Boolean);
+			const disable = toolsDisable.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
+				}
+			};
+		}
+	} 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,
@@ -210,7 +245,24 @@ async function finalizeCreateAgentDirs(cfg, agentId, opts) {
 	await mkdir(profilePath, { recursive: true });
 	await mkdir(adPath, { recursive: true });
 	const id = normalizeAgentId(agentId);
-	seedAgentProfileMarkdownFiles(profilePath, wsPath, { displayName: listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id)?.name?.trim() || id });
+	const displayName = resolveLocalizedText(normalizeLocalizedText(listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id)?.name), "en") || id;
+	if (opts?.cloneFrom) {
+		const srcProfilePath = resolveAgentProfileDir(cfg, normalizeAgentId(opts.cloneFrom));
+		try {
+			if ((await stat(srcProfilePath)).isDirectory()) {
+				const srcFiles = await readdir(srcProfilePath);
+				for (const fileName of srcFiles) {
+					const srcFile = join(srcProfilePath, fileName);
+					const dstFile = join(profilePath, fileName);
+					try {
+						if ((await stat(srcFile)).isFile()) await cp(srcFile, dstFile);
+					} catch {}
+				}
+			}
+		} catch {
+			seedAgentProfileMarkdownFiles(profilePath, wsPath, { displayName });
+		}
+	} else seedAgentProfileMarkdownFiles(profilePath, wsPath, { displayName });
 	const profileFiles = opts?.profileFiles;
 	if (profileFiles && Object.keys(profileFiles).length > 0) for (const [name, content] of Object.entries(profileFiles)) {
 		const written = await writeAgentProfileFile(cfg, agentId, name, content);
@@ -239,11 +291,14 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 	};
 	const entry = { ...list[idx] };
 	if (body.name !== void 0) {
-		const n = body.name.trim();
-		if (n) entry.name = n;
+		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.description !== void 0) if (body.description === null || String(body.description).trim() === "") delete entry.description;
-	else entry.description = String(body.description).trim();
 	if (body.workspace !== void 0) {
 		const w = body.workspace.trim();
 		if (w) entry.workspace = resolveUserPath(w);
@@ -278,12 +333,6 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 			disable: next
 		};
 	}
-	if (body.models !== void 0) if (body.models === null) delete entry.models;
-	else {
-		const normalized = normalizePatchTypedModels(body.models);
-		if (normalized === null || normalized === void 0) delete entry.models;
-		else entry.models = normalized;
-	}
 	list[idx] = entry;
 	let next = {
 		...cfg,