@xopcai/xopc 0.0.116 → 0.0.118

package/dist/src/extensions/activation-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation-context.js","names":["root"],"sources":["../../../src/extensions/activation-context.ts"],"sourcesContent":["/**\n * Build ActivationContext from app config + optional overrides.\n */\n\nimport type { Config } from '../config/config-surface.js';\nimport { mergeSttConfigFromAppConfig } from '../channels/attachments/voice-stt-webchat.js';\nimport { collectSttProviderConfigEntries } from '../voice/stt/config-slice.js';\nimport { isSttProviderConfigured } from '../voice/stt/list-providers.js';\nimport { collectTtsProviderConfigEntries } from '../voice/tts/config-slice.js';\nimport { isProviderConfigured } from '../voice/tts/factory.js';\nimport { mergeTtsConfigFromAppConfig } from '../voice/tts/merge-config.js';\nimport { isProviderConfiguredSync } from '../providers/index.js';\nimport { PROVIDER_ENV_MAP } from '../providers/env-keys.js';\nimport type { ActivationContext } from './activation-planner.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction telegramConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts)) {\n    for (const acc of Object.values(accounts)) {\n      if (!isRecord(acc)) continue;\n      if (acc.enabled === false) continue;\n      if (typeof acc.botToken === 'string' && acc.botToken.trim().length > 0) return true;\n    }\n  }\n  return false;\n}\n\nfunction weixinConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts) && Object.keys(accounts).length > 0) {\n    for (const acc of Object.values(accounts)) {\n      if (isRecord(acc) && acc.enabled === false) continue;\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Derive configured channel plugin ids from `channels.*` config.\n */\nexport function collectConfiguredChannelIds(config: unknown): string[] | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const channels = root?.channels;\n  if (!isRecord(channels)) return undefined;\n\n  const ids: string[] = [];\n\n  if (telegramConfigured(channels.telegram as Record<string, unknown> | undefined)) {\n    ids.push('telegram');\n  }\n  if (weixinConfigured(channels.weixin as Record<string, unknown> | undefined)) {\n    ids.push('weixin');\n  }\n\n  for (const [key, value] of Object.entries(channels)) {\n    if (key === 'telegram' || key === 'weixin') continue;\n    if (isRecord(value) && value.enabled === true && !ids.includes(key)) {\n      ids.push(key);\n    }\n  }\n\n  return ids.length ? ids : undefined;\n}\n\nfunction collectConfiguredLlmProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const candidateIds = new Set<string>(Object.keys(PROVIDER_ENV_MAP));\n  const providers = root?.providers;\n  if (isRecord(providers)) {\n    for (const key of Object.keys(providers)) {\n      candidateIds.add(key);\n    }\n  }\n  const ids: string[] = [];\n  for (const key of candidateIds) {\n    if (isProviderConfiguredSync(key)) {\n      ids.push(key);\n    }\n  }\n  return ids;\n}\n\nfunction collectConfiguredSpeechProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const messages = root?.messages;\n  if (!isRecord(messages) || !isRecord(messages.tts)) {\n    return [];\n  }\n\n  const ttsConfig = mergeTtsConfigFromAppConfig(messages.tts);\n  const ids = new Set<string>();\n  const primary = ttsConfig.provider?.trim();\n  if (primary && isProviderConfigured(primary, ttsConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectTtsProviderConfigEntries(ttsConfig))) {\n    if (isProviderConfigured(providerId, ttsConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\nfunction collectConfiguredMediaUnderstandingProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const tools = root?.tools;\n  if (!isRecord(tools) || !isRecord(tools.media)) {\n    return [];\n  }\n\n  const sttConfig = mergeSttConfigFromAppConfig(\n    tools.media.audio as Parameters<typeof mergeSttConfigFromAppConfig>[0],\n    tools.media as Parameters<typeof mergeSttConfigFromAppConfig>[1],\n  );\n  const ids = new Set<string>();\n  const primary = sttConfig.provider?.trim();\n  if (primary && isSttProviderConfigured(primary, sttConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectSttProviderConfigEntries(sttConfig))) {\n    if (isSttProviderConfigured(providerId, sttConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\n/**\n * Derive configured provider ids for extension activation (LLM + speech + STT).\n */\nexport function collectConfiguredProviderIds(config: unknown): string[] | undefined {\n  const ids = new Set<string>([\n    ...collectConfiguredLlmProviderIds(config),\n    ...collectConfiguredSpeechProviderIds(config),\n    ...collectConfiguredMediaUnderstandingProviderIds(config),\n  ]);\n  return ids.size > 0 ? [...ids] : undefined;\n}\n\nfunction defaultModelId(config: unknown): string | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const agents = root?.agents;\n  if (!isRecord(agents)) return undefined;\n  const defaults = agents.defaults;\n  if (!isRecord(defaults)) return undefined;\n  const models = defaults.models;\n  if (!isRecord(models)) return undefined;\n  const model = models.chat;\n  if (isRecord(model)) {\n    const primary = model.primary;\n    if (typeof primary === 'string' && primary.trim().length > 0) return primary;\n  }\n  return undefined;\n}\n\n/**\n * Merge partial activation context over values inferred from loaded app config.\n */\nexport function mergeActivationContext(\n  appConfig: Config | Record<string, unknown> | undefined,\n  partial?: Partial<ActivationContext>,\n): ActivationContext {\n  const ext = appConfig && isRecord((appConfig as Record<string, unknown>).extensions)\n    ? ((appConfig as Record<string, unknown>).extensions as Record<string, unknown>)\n    : undefined;\n\n  const base: ActivationContext = {\n    enabledIds: Array.isArray(ext?.enabled)\n      ? ext!.enabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    disabledIds: Array.isArray(ext?.disabled)\n      ? ext!.disabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    requestedModelId: defaultModelId(appConfig),\n    configuredProviderIds: collectConfiguredProviderIds(appConfig),\n    configuredChannelIds: collectConfiguredChannelIds(appConfig),\n    env: process.env,\n  };\n\n  return {\n    env: partial?.env ?? base.env,\n    enabledIds: partial?.enabledIds !== undefined ? partial.enabledIds : base.enabledIds,\n    disabledIds: partial?.disabledIds !== undefined ? partial.disabledIds : base.disabledIds,\n    requestedModelId:\n      partial?.requestedModelId !== undefined ? partial.requestedModelId : base.requestedModelId,\n    configuredProviderIds:\n      partial?.configuredProviderIds !== undefined\n        ? partial.configuredProviderIds\n        : base.configuredProviderIds,\n    configuredChannelIds:\n      partial?.configuredChannelIds !== undefined\n        ? partial.configuredChannelIds\n        : base.configuredChannelIds,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"activation-context.js","names":["root"],"sources":["../../../src/extensions/activation-context.ts"],"sourcesContent":["/**\n * Build ActivationContext from app config + optional overrides.\n */\n\nimport type { Config } from '../config/config-surface.js';\nimport { mergeSttConfigFromAppConfig } from '../channels/attachments/voice-stt-webchat.js';\nimport { collectSttProviderConfigEntries } from '../voice/stt/config-slice.js';\nimport { isSttProviderConfigured } from '../voice/stt/list-providers.js';\nimport { collectTtsProviderConfigEntries } from '../voice/tts/config-slice.js';\nimport { isProviderConfigured } from '../voice/tts/factory.js';\nimport { mergeTtsConfigFromAppConfig } from '../voice/tts/merge-config.js';\nimport { isProviderConfiguredSync } from '../providers/index.js';\nimport { PROVIDER_ENV_MAP } from '../providers/env-keys.js';\nimport type { ActivationContext } from './activation-planner.js';\n\nfunction isRecord(x: unknown): x is Record<string, unknown> {\n  return typeof x === 'object' && x !== null && !Array.isArray(x);\n}\n\nfunction telegramConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts)) {\n    for (const acc of Object.values(accounts)) {\n      if (!isRecord(acc)) continue;\n      if (acc.enabled === false) continue;\n      if (typeof acc.botToken === 'string' && acc.botToken.trim().length > 0) return true;\n    }\n  }\n  return false;\n}\n\nfunction weixinConfigured(ch: Record<string, unknown> | undefined): boolean {\n  if (!ch) return false;\n  if (ch.enabled === true) return true;\n  const accounts = ch.accounts;\n  if (isRecord(accounts) && Object.keys(accounts).length > 0) {\n    for (const acc of Object.values(accounts)) {\n      if (isRecord(acc) && acc.enabled === false) continue;\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Derive configured channel plugin ids from `channels.*` config.\n */\nexport function collectConfiguredChannelIds(config: unknown): string[] | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const channels = root?.channels;\n  if (!isRecord(channels)) return undefined;\n\n  const ids: string[] = [];\n\n  if (telegramConfigured(channels.telegram as Record<string, unknown> | undefined)) {\n    ids.push('telegram');\n  }\n  if (weixinConfigured(channels.weixin as Record<string, unknown> | undefined)) {\n    ids.push('weixin');\n  }\n\n  for (const [key, value] of Object.entries(channels)) {\n    if (key === 'telegram' || key === 'weixin') continue;\n    if (isRecord(value) && value.enabled === true && !ids.includes(key)) {\n      ids.push(key);\n    }\n  }\n\n  return ids.length ? ids : undefined;\n}\n\nfunction collectConfiguredLlmProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const candidateIds = new Set<string>(Object.keys(PROVIDER_ENV_MAP));\n  const providers = root?.providers;\n  if (isRecord(providers)) {\n    for (const key of Object.keys(providers)) {\n      candidateIds.add(key);\n    }\n  }\n  const ids: string[] = [];\n  for (const key of candidateIds) {\n    if (isProviderConfiguredSync(key)) {\n      ids.push(key);\n    }\n  }\n  return ids;\n}\n\nfunction collectConfiguredSpeechProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const messages = root?.messages;\n  if (!isRecord(messages) || !isRecord(messages.tts)) {\n    return [];\n  }\n\n  const ttsConfig = mergeTtsConfigFromAppConfig(messages.tts);\n  const ids = new Set<string>();\n  const primary = ttsConfig.provider?.trim();\n  if (primary && isProviderConfigured(primary, ttsConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectTtsProviderConfigEntries(ttsConfig))) {\n    if (isProviderConfigured(providerId, ttsConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\nfunction collectConfiguredMediaUnderstandingProviderIds(config: unknown): string[] {\n  const root = config as Record<string, unknown> | undefined;\n  const tools = root?.tools;\n  if (!isRecord(tools) || !isRecord(tools.media)) {\n    return [];\n  }\n\n  const sttConfig = mergeSttConfigFromAppConfig(\n    tools.media.audio as Parameters<typeof mergeSttConfigFromAppConfig>[0],\n    tools.media as Parameters<typeof mergeSttConfigFromAppConfig>[1],\n  );\n  const ids = new Set<string>();\n  const primary = sttConfig.provider?.trim();\n  if (primary && isSttProviderConfigured(primary, sttConfig)) {\n    ids.add(primary);\n  }\n  for (const providerId of Object.keys(collectSttProviderConfigEntries(sttConfig))) {\n    if (isSttProviderConfigured(providerId, sttConfig)) {\n      ids.add(providerId);\n    }\n  }\n  return [...ids];\n}\n\n/**\n * Derive configured provider ids for extension activation (LLM + speech + STT).\n */\nexport function collectConfiguredProviderIds(config: unknown): string[] | undefined {\n  const ids = new Set<string>([\n    ...collectConfiguredLlmProviderIds(config),\n    ...collectConfiguredSpeechProviderIds(config),\n    ...collectConfiguredMediaUnderstandingProviderIds(config),\n  ]);\n  return ids.size > 0 ? [...ids] : undefined;\n}\n\nfunction defaultModelId(config: unknown): string | undefined {\n  const root = config as Record<string, unknown> | undefined;\n  const agents = root?.agents;\n  if (!isRecord(agents)) return undefined;\n  const list = agents.list;\n  if (!Array.isArray(list)) return undefined;\n  const defaultId = typeof agents.default === 'string' ? agents.default : undefined;\n  const entry =\n    list.find((candidate) => isRecord(candidate) && candidate.id === defaultId) ??\n    list.find((candidate) => isRecord(candidate) && candidate.enabled !== false);\n  if (!isRecord(entry)) return undefined;\n  const models = entry.models;\n  if (!isRecord(models)) return undefined;\n  const defaultRole = typeof models.defaultRole === 'string' ? models.defaultRole : undefined;\n  const roles = models.roles;\n  if (!defaultRole || !isRecord(roles)) return undefined;\n  const role = roles[defaultRole];\n  if (isRecord(role)) {\n    const model = role.model;\n    if (typeof model === 'string' && model.trim().length > 0) return model;\n  }\n  return undefined;\n}\n\n/**\n * Merge partial activation context over values inferred from loaded app config.\n */\nexport function mergeActivationContext(\n  appConfig: Config | Record<string, unknown> | undefined,\n  partial?: Partial<ActivationContext>,\n): ActivationContext {\n  const ext = appConfig && isRecord((appConfig as Record<string, unknown>).extensions)\n    ? ((appConfig as Record<string, unknown>).extensions as Record<string, unknown>)\n    : undefined;\n\n  const base: ActivationContext = {\n    enabledIds: Array.isArray(ext?.enabled)\n      ? ext!.enabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    disabledIds: Array.isArray(ext?.disabled)\n      ? ext!.disabled.filter((x): x is string => typeof x === 'string')\n      : undefined,\n    requestedModelId: defaultModelId(appConfig),\n    configuredProviderIds: collectConfiguredProviderIds(appConfig),\n    configuredChannelIds: collectConfiguredChannelIds(appConfig),\n    env: process.env,\n  };\n\n  return {\n    env: partial?.env ?? base.env,\n    enabledIds: partial?.enabledIds !== undefined ? partial.enabledIds : base.enabledIds,\n    disabledIds: partial?.disabledIds !== undefined ? partial.disabledIds : base.disabledIds,\n    requestedModelId:\n      partial?.requestedModelId !== undefined ? partial.requestedModelId : base.requestedModelId,\n    configuredProviderIds:\n      partial?.configuredProviderIds !== undefined\n        ? partial.configuredProviderIds\n        : base.configuredProviderIds,\n    configuredChannelIds:\n      partial?.configuredChannelIds !== undefined\n        ? partial.configuredChannelIds\n        : base.configuredChannelIds,\n  };\n}\n"],"mappings":"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"}

package/dist/src/extensions/bundle-mcp.js

@@ -1,8 +1,8 @@
 import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from "../config/paths.js";
 import { isRecord } from "../utils/is-record.js";
 import { normalizeConfiguredMcpServers } from "../config/mcp-config-normalize.js";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
 //#region src/extensions/bundle-mcp.ts
 init_paths();
 function extractMcpServerMap(raw) {

package/dist/src/extensions/discover-extensions.js

@@ -1,11 +1,11 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
 import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { init_normalize_manifest, normalizeExtensionManifest } from "./normalize-manifest.js";
-import { existsSync, readFileSync, readdirSync } from "fs";
 import { join } from "path";
+import { existsSync, readFileSync, readdirSync } from "fs";
 //#region src/extensions/discover-extensions.ts
 /**
 * Filesystem-only extension discovery (manifest parse, no module load).

package/dist/src/extensions/health.js

@@ -1,7 +1,7 @@
 import { init_paths, resolveExtensionsDir } from "../config/paths.js";
 import { getExtensionLockfileManager } from "./lockfile.js";
-import { existsSync } from "fs";
 import { join } from "path";
+import { existsSync } from "fs";
 import { readFile, readdir } from "fs/promises";
 //#region src/extensions/health.ts
 init_paths();

package/dist/src/extensions/install.js

@@ -1,13 +1,13 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
-import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir as resolveExtensionsDir$1 } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir as resolveExtensionsDir$1 } from "../config/paths.js";
 import { checkEngineCompatibility } from "./engine-check.js";
 import { collectExtensionPackageDependencyIssues } from "./package-contract.js";
 import { MAX_EXTENSION_STORE_ZIP_BYTES } from "./store-zip-limits.js";
+import { dirname, isAbsolute, join, resolve, sep } from "path";
 import { cpSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, writeFileSync } from "fs";
 import { execSync } from "child_process";
-import { dirname, isAbsolute, join, resolve, sep } from "path";
 import { tmpdir } from "os";
 import AdmZip from "adm-zip";
 //#region src/extensions/install.ts

package/dist/src/extensions/loader.js

@@ -1,8 +1,8 @@
 import { PACKAGE_VERSION, init_package_version } from "../package-version.js";
 import { init_agent_scope, resolveAgentWorkspaceDir, resolveDefaultAgentId } from "../agent/agent-scope.js";
-import { init_paths, resolveBundledExtensionsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { createLogger, createServiceLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
+import { init_paths, resolveBundledExtensionsDir, resolveExtensionSdkPath, resolveExtensionsDir, resolveWorkspaceExtensionsDir } from "../config/paths.js";
 import { init_normalize_manifest, normalizeExtensionManifest } from "./normalize-manifest.js";
 import { areExtensionsGloballyDisabled, discoverExtensionsFromDisk, init_discover_extensions } from "./discover-extensions.js";
 import { ManifestRegistry, init_manifest_registry } from "./manifest-registry.js";
@@ -18,8 +18,8 @@ import { validateMediaUnderstandingProviderContracts } from "./media-provider-co
 import { DEFAULT_SECURITY_CONFIG, checkExtensionPathSafety, isExtensionAllowed, logSecurityIssue, provenanceTracker } from "./security.js";
 import { getSlotRegistry } from "./slots.js";
 import { getExtensionCache, getExtensionDiagnostics } from "./diagnostics.js";
-import { existsSync, readFileSync } from "fs";
 import { dirname, isAbsolute, join } from "path";
+import { existsSync, readFileSync } from "fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { createJiti } from "jiti";
 //#region src/extensions/loader.ts

package/dist/src/extensions/lockfile.js

@@ -1,9 +1,9 @@
-import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
-import { init_paths, resolveExtensionsDir, resolveExtensionsLockPath } from "../config/paths.js";
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import { existsSync } from "fs";
+import { init_paths, resolveExtensionsDir, resolveExtensionsLockPath } from "../config/paths.js";
+import { init_write_file_atomic, writeTextAtomic } from "../infra/write-file-atomic.js";
 import { dirname, join } from "path";
+import { existsSync } from "fs";
 import { mkdir, readFile } from "fs/promises";
 import { createHash } from "crypto";
 //#region src/extensions/lockfile.ts

package/dist/src/extensions/security.js

@@ -1,7 +1,7 @@
 import { createLogger } from "../utils/logger/index.js";
 import { init_logger } from "../utils/logger.js";
-import * as fs from "fs";
 import * as path$1 from "path";
+import * as fs from "fs";
 //#region src/extensions/security.ts
 /**
 * Extension Security Module

package/dist/src/extensions/update.js

@@ -1,13 +1,13 @@
-import { init_paths, resolveBundledExtensionsDir, resolveExtensionsDir } from "../config/paths.js";
 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 { existsSync, readFileSync, readdirSync, rmSync } from "node:fs";
 import semver from "semver";
 //#region src/extensions/update.ts
 /**

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

@@ -1,10 +1,12 @@
 /**
  * Gateway REST helpers for multi-agent management.
  */
+import { type ResolveManifestResult } from '../agent-manifest/resolver.js';
 import type { AgentModelsConfig, Config } from '../config/schema.js';
 import type { AgentTypedModel } from '../config/schema.js';
 export type GatewayAgentTypedModelsInfo = {
-    defaults: AgentTypedModel[];
+    defaultRole: string;
+    preset: AgentTypedModel[];
     entry?: AgentTypedModel[];
     effective: AgentTypedModel[];
 };
@@ -23,14 +25,15 @@ export type GatewayAgentRow = {
         fallbacks?: string[];
     };
     typedModels: GatewayAgentTypedModelsInfo;
+    extends: string[];
     isDefault: boolean;
     skills: {
-        defaults: string[];
+        preset: string[];
         entry?: string[];
         effectiveAllowlist?: string[];
     };
     tools: {
-        defaultsDisable: string[];
+        presetDenied: string[];
         entryDisable: string[];
         effectiveDisable: string[];
     };
@@ -40,6 +43,7 @@ export type GatewayAgentsListResponse = {
     agents: GatewayAgentRow[];
     builtinToolIds: string[];
 };
+export type GatewayAgentEffectiveManifestResponse = ResolveManifestResult;
 /** 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 parseIdentityMarkdown(content: string): {
@@ -51,18 +55,16 @@ export declare function parseIdentityMarkdown(content: string): {
 export declare function listGatewayAgents(cfg: Config, _options?: {
     locale?: string;
 }): Promise<GatewayAgentsListResponse>;
+export declare function getGatewayAgentEffectiveManifest(cfg: Config, agentIdRaw: string): AgentAdminResult<GatewayAgentEffectiveManifestResponse>;
 export type CreateAgentBody = {
     /** Optional id seed; normalized agent id defaults from `profileFiles["IDENTITY.md"]` name when omitted. */
     id?: string;
     workspace: string;
     models?: AgentModelsConfig;
-    agentDir?: string;
     /** Initial `agents.list[].skills` for the new entry. */
     skills?: string[];
     /** Initial `agents.list[].tools` for the new entry. */
-    tools?: {
-        disable?: string[];
-    };
+    tools?: NonNullable<Config['agents']['list']>[number]['tools'];
     /** 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. */
@@ -88,24 +90,21 @@ export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string, op
 }): Promise<AgentAdminResult<void>>;
 export type UpdateAgentBody = {
     workspace?: string;
+    extends?: string[];
     models?: {
-        chat?: {
-            primary: string;
-            fallbacks?: string[];
-        } | null;
+        defaultRole?: 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). */
+    /** Replace `agents.list[].skills`; `null` resets to all skills. */
     skills?: string[] | null;
-    /** Replace `agents.list[].tools`; `null` removes the key (inherit defaults). */
-    tools?: {
-        disable?: string[] | null;
-    } | null;
+    /** Replace `agents.list[].tools`; `null` resets to no explicit policies. */
+    tools?: NonNullable<Config['agents']['list']>[number]['tools'] | null;
+    /** Replace `agents.list[].memory`; every agent manifest owns its memory policy. */
+    memory?: NonNullable<Config['agents']['list']>[number]['memory'];
 };
 export declare function prepareUpdateAgent(cfg: Config, agentIdRaw: string, body: UpdateAgentBody): AgentAdminResult<{
     nextConfig: Config;
@@ -135,6 +134,13 @@ export declare function writeAgentProfileFile(cfg: Config, agentId: string, name
     agentId: string;
     path: string;
 }>>;
+export declare function readUserProfileFile(): Promise<AgentAdminResult<{
+    content: string;
+    path: string;
+}>>;
+export declare function writeUserProfileFile(content: string): Promise<AgentAdminResult<{
+    path: string;
+}>>;
 export declare function readAgentAvatarFile(cfg: Config, agentId: string): Promise<AgentAdminResult<{
     agentId: string;
     buffer: Buffer;

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

@@ -1,14 +1,15 @@
 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 { resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
-import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES } from "../agent/context/workspace.js";
+import { WORKSPACE_FILES, init_paths, resolveUserProfilePath } from "../config/paths.js";
+import { AGENT_PROFILE_MARKDOWN_SYSTEM_FILES, REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET } 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 { dirname, join, resolve } from "node:path";
 import { cp, mkdir, readFile, readdir, realpath, stat, unlink, writeFile } from "node:fs/promises";
-import { join, resolve } from "node:path";
 //#region src/gateway/agents-admin.ts
 /**
 * Gateway REST helpers for multi-agent management.
@@ -54,9 +55,8 @@ function parseIdentityMarkdown(content) {
 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 = rolesToTypedModels(cfg.agents?.defaults?.models?.roles);
+	const presetDenied = [];
+	const presetTypedModels = [];
 	for (const id of collectAgentIdsForList(cfg)) {
 		const profile = resolveEffectiveAgentProfile(cfg, id);
 		const entry = listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);
@@ -64,8 +64,8 @@ async function listGatewayAgents(cfg, _options = {}) {
 			...profile.primaryModelRef ? { primary: profile.primaryModelRef } : {},
 			...profile.fallbacks.length > 0 ? { fallbacks: profile.fallbacks } : {}
 		} : void 0;
-		const entrySkills = entry?.skills;
-		const entryDisable = entry?.tools?.disable ?? [];
+		const entrySkills = entry?.skills.mode === "allowlist" ? entry.skills.allow ?? [] : void 0;
+		const entryDisable = Object.entries(entry?.tools.builtin ?? {}).filter(([, policy]) => policy.mode === "deny").map(([name]) => name);
 		const entryTypedModels = rolesToTypedModels(entry?.models?.roles);
 		const effectiveTypedModels = [...resolveEffectiveTypedModels(cfg, id).values()].sort((a, b) => a.id.localeCompare(b.id));
 		let identity = {};
@@ -82,20 +82,22 @@ async function listGatewayAgents(cfg, _options = {}) {
 			profileDir: resolveAgentProfileDir(cfg, id),
 			...model ? { model } : {},
 			typedModels: {
-				defaults: [...defaultsTypedModels],
+				defaultRole: profile.manifest.models.defaultRole,
+				preset: [...presetTypedModels],
 				...entryTypedModels.length > 0 ? { entry: entryTypedModels } : {},
 				effective: effectiveTypedModels
 			},
+			extends: [...entry?.extends ?? []],
 			isDefault: id === defaultId,
 			skills: {
-				defaults: defaultsSkills ? [...defaultsSkills] : [],
+				preset: [],
 				...entrySkills !== void 0 ? { entry: [...entrySkills] } : {},
 				...profile.skillsAllowlist !== void 0 ? { effectiveAllowlist: [...profile.skillsAllowlist] } : {}
 			},
 			tools: {
-				defaultsDisable: [...defaultsDisable],
+				presetDenied: [...presetDenied],
 				entryDisable: [...entryDisable],
-				effectiveDisable: [...profile.tools.disable].sort((a, b) => a.localeCompare(b))
+				effectiveDisable: [...profile.tools.denied].sort((a, b) => a.localeCompare(b))
 			}
 		});
 	}
@@ -106,6 +108,31 @@ async function listGatewayAgents(cfg, _options = {}) {
 		builtinToolIds: [...GATEWAY_BUILTIN_TOOL_IDS]
 	};
 }
+function getGatewayAgentEffectiveManifest(cfg, agentIdRaw) {
+	const agentId = normalizeAgentId(agentIdRaw);
+	const entry = listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === agentId);
+	if (!entry) return {
+		ok: false,
+		error: `agent "${agentId}" not found`,
+		status: 404
+	};
+	try {
+		return {
+			ok: true,
+			data: resolveEffectiveAgentManifest({
+				agent: entry,
+				presets: cfg.agents.capabilityPresets,
+				defaultPresetId: cfg.agents.defaultPreset
+			})
+		};
+	} catch (err) {
+		return {
+			ok: false,
+			error: err instanceof Error ? err.message : String(err),
+			status: 400
+		};
+	}
+}
 function requireNonMain(id) {
 	if (normalizeAgentId(id) === "main") return {
 		ok: false,
@@ -166,39 +193,26 @@ function prepareCreateAgent(cfg, body) {
 		};
 	}
 	const wsAbs = resolveUserPath(workspace);
-	const effectiveModels = body.models ?? cloneSourceEntry?.models;
-	let next = applyAgentConfig(cfg, {
-		agentId,
-		workspace: wsAbs,
-		...effectiveModels ? { models: effectiveModels } : {},
-		...body.agentDir?.trim() ? { agentDir: body.agentDir.trim() } : {},
-		...body.skills !== void 0 ? { skills: body.skills.map((s) => String(s).trim()).filter(Boolean) } : cloneSourceEntry?.skills !== void 0 && body.cloneFrom ? { skills: [...cloneSourceEntry.skills] } : {}
-	});
-	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 = tools.disable?.map((s) => String(s).trim()).filter(Boolean) ?? [];
-			entry.tools = {
-				...entry.tools,
-				...disable.length > 0 ? { disable } : {}
-			};
-			list[idx] = entry;
-			next = {
-				...next,
-				agents: {
-					...next.agents,
-					list
-				}
-			};
-		}
-	}
+	const rawModels = body.models ?? cloneSourceEntry?.models;
+	const effectiveModels = rawModels?.roles ? {
+		defaultRole: rawModels.defaultRole ?? Object.keys(rawModels.roles)[0] ?? "deep",
+		roles: rawModels.roles
+	} : void 0;
+	if (effectiveModels && !effectiveModels.roles[effectiveModels.defaultRole]) return {
+		ok: false,
+		error: "models.defaultRole must reference models.roles",
+		status: 400
+	};
 	return {
 		ok: true,
 		data: {
-			nextConfig: next,
+			nextConfig: applyAgentConfig(cfg, {
+				agentId,
+				workspace: wsAbs,
+				...effectiveModels ? { models: effectiveModels } : {},
+				...body.skills !== void 0 ? { skills: body.skills.map((s) => String(s).trim()).filter(Boolean) } : cloneSourceEntry?.skills.mode === "allowlist" && body.cloneFrom ? { skills: [...cloneSourceEntry.skills.allow ?? []] } : {},
+				...body.tools !== void 0 ? { tools: body.tools } : cloneSourceEntry?.tools && body.cloneFrom ? { tools: cloneSourceEntry.tools } : {}
+			}),
 			agentId,
 			workspace: wsAbs
 		}
@@ -247,7 +261,28 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 	if (idx < 0 && agentId === resolveDefaultAgentId(cfg)) {
 		list = [...list, {
 			id: agentId,
-			enabled: true
+			enabled: true,
+			identity: {
+				name: agentId,
+				role: "Agent",
+				language: "en",
+				tone: "direct"
+			},
+			responsibilities: { primary: ["Help the user complete tasks"] },
+			workspace: { root: `~/.xopc/workspace/${agentId}` },
+			tools: { builtin: {} },
+			skills: { mode: "all" },
+			memory: {
+				mode: "confirmWrite",
+				sources: ["session", "curated"],
+				writePolicy: { curated: "confirm" }
+			},
+			workflows: {},
+			boundaries: {
+				requiresConfirmation: [],
+				forbidden: [],
+				escalation: []
+			}
 		}];
 		idx = list.length - 1;
 	}
@@ -259,34 +294,34 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 	const entry = { ...list[idx] };
 	if (body.workspace !== void 0) {
 		const w = body.workspace.trim();
-		if (w) entry.workspace = resolveUserPath(w);
+		if (w) entry.workspace = { root: resolveUserPath(w) };
+	}
+	if (body.extends !== void 0) {
+		const nextExtends = Array.from(new Set(body.extends.map((id) => normalizeAgentId(id)).filter(Boolean)));
+		for (const presetId of nextExtends) if (!cfg.agents.capabilityPresets[presetId]) return {
+			ok: false,
+			error: `capability preset "${presetId}" not found`,
+			status: 400
+		};
+		if (nextExtends.length > 0) entry.extends = nextExtends;
+		else delete entry.extends;
 	}
 	if (body.models !== void 0) if (body.models === null) delete entry.models;
 	else {
-		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 (body.models.defaultRole !== void 0) {
+			if (body.models.defaultRole === null || !body.models.defaultRole.trim()) return {
+				ok: false,
+				error: "models.defaultRole must be a non-empty string",
+				status: 400
+			};
+			entry.models = {
+				defaultRole: body.models.defaultRole.trim(),
+				roles: entry.models?.roles ?? {},
+				...entry.models?.policy ? { policy: entry.models.policy } : {}
+			};
 		}
 		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) {
+			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(),
@@ -296,38 +331,39 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 					description: row.description
 				} : { model: row.model }]));
 				entry.models = {
-					...entry.models,
-					roles
+					defaultRole: entry.models?.defaultRole ?? Object.keys(roles)[0] ?? "deep",
+					roles,
+					...entry.models?.policy ? { policy: entry.models.policy } : {}
 				};
 			}
 		}
-		if (entry.models && Object.keys(entry.models).length === 0) delete entry.models;
+		const roles = entry.models?.roles ?? {};
+		const defaultRole = entry.models?.defaultRole ?? Object.keys(roles)[0];
+		if (!defaultRole || !roles[defaultRole]) return {
+			ok: false,
+			error: "models.defaultRole must reference models.roles",
+			status: 400
+		};
+		entry.models = {
+			...entry.models,
+			defaultRole
+		};
 	}
-	if (body.agentDir !== void 0) if (body.agentDir === null || String(body.agentDir).trim() === "") delete entry.agentDir;
-	else entry.agentDir = String(body.agentDir).trim();
-	if (body.skills !== void 0) if (body.skills === null) delete entry.skills;
+	if (body.skills !== void 0) if (body.skills === null) entry.skills = { mode: "all" };
 	else {
 		const next = body.skills.map((s) => String(s).trim()).filter(Boolean);
-		if (next.length === 0) entry.skills = [];
-		else entry.skills = next;
-	}
-	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
-				};
-			}
-		}
+		if (next.length === 0) entry.skills = {
+			mode: "allowlist",
+			allow: []
+		};
+		else entry.skills = {
+			mode: "allowlist",
+			allow: next
+		};
 	}
+	if (body.tools !== void 0) if (body.tools === null) entry.tools = { builtin: {} };
+	else entry.tools = body.tools;
+	if (body.memory !== void 0) entry.memory = body.memory;
 	list[idx] = entry;
 	let next = {
 		...cfg,
@@ -409,6 +445,7 @@ async function listAgentProfileFiles(cfg, agentId) {
 				updatedAtMs: st.mtimeMs
 			});
 		} catch {
+			if (!REQUIRED_AGENT_PROFILE_MARKDOWN_FILE_SET.has(name)) continue;
 			files.push({
 				name,
 				missing: true
@@ -486,6 +523,35 @@ async function writeAgentProfileFile(cfg, agentId, name, content) {
 		}
 	};
 }
+async function readUserProfileFile() {
+	const path = resolveUserProfilePath();
+	try {
+		return {
+			ok: true,
+			data: {
+				content: await readFile(path, "utf-8"),
+				path
+			}
+		};
+	} catch {
+		return {
+			ok: true,
+			data: {
+				content: "",
+				path
+			}
+		};
+	}
+}
+async function writeUserProfileFile(content) {
+	const path = resolveUserProfilePath();
+	await mkdir(dirname(path), { recursive: true });
+	await writeFile(path, content, "utf-8");
+	return {
+		ok: true,
+		data: { path }
+	};
+}
 const AGENT_AVATAR_MAX_BYTES = 512 * 1024;
 const AGENT_AVATAR_BASENAME = "agent-avatar";
 const AGENT_AVATAR_EXTENSIONS = [
@@ -633,6 +699,6 @@ async function deleteAgentAvatarFile(cfg, agentId) {
 	};
 }
 //#endregion
-export { deleteAgentAvatarFile, extractAvatarFromIdentityMarkdown, finalizeCreateAgentDirs, listAgentProfileFiles, listGatewayAgents, parseIdentityMarkdown, prepareCreateAgent, prepareDeleteAgent, prepareUpdateAgent, readAgentAvatarFile, readAgentProfileFile, runAfterDeletePurge, writeAgentAvatarFromBase64, writeAgentProfileFile };
+export { deleteAgentAvatarFile, extractAvatarFromIdentityMarkdown, finalizeCreateAgentDirs, getGatewayAgentEffectiveManifest, listAgentProfileFiles, listGatewayAgents, parseIdentityMarkdown, prepareCreateAgent, prepareDeleteAgent, prepareUpdateAgent, readAgentAvatarFile, readAgentProfileFile, readUserProfileFile, runAfterDeletePurge, writeAgentAvatarFromBase64, writeAgentProfileFile, writeUserProfileFile };
 
 //# sourceMappingURL=agents-admin.js.map