@xopcai/xopc 0.0.231 → 0.0.233

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

@@ -1,54 +1,32 @@
 /**
  * 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 = {
-    defaultRole: string;
-    preset: AgentTypedModel[];
-    entry?: AgentTypedModel[];
-    effective: AgentTypedModel[];
-};
+import type { AgentModelsOverride, EffectiveAgentConfig, SkillOverride } from '../agent-config/index.js';
+import type { Config } from '../config/schema.js';
 export type GatewayAgentRow = {
     id: string;
     name?: string;
     description?: string;
     language?: string;
-    role?: string;
-    responsibilities?: {
-        primary: string[];
-        secondary?: string[];
-    };
     /** Value from `IDENTITY.md` **Avatar:** line when present (may be URL, `xopc:…`, etc.). */
     avatar?: string;
     workspace: string;
     /** Absolute directory for profile Markdown (`SOUL.md`, …) and gateway avatars: `agents/<id>/profile/`. */
     profileDir: string;
-    model?: {
-        primary?: string;
-        fallbacks?: string[];
-    };
-    typedModels: GatewayAgentTypedModelsInfo;
-    extends: string[];
+    override: Config['agents']['list'][number];
+    effective: EffectiveAgentConfig;
+    sources: Record<string, 'system' | 'global' | 'agent'>;
     isDefault: boolean;
-    skills: {
-        preset: string[];
-        entry?: string[];
-        effectiveAllowlist?: string[];
-    };
-    tools: {
-        presetDenied: string[];
-        entryDisable: string[];
-        effectiveDisable: string[];
-    };
 };
 export type GatewayAgentsListResponse = {
     defaultId: string;
     agents: GatewayAgentRow[];
     builtinToolIds: string[];
 };
-export type GatewayAgentEffectiveManifestResponse = ResolveManifestResult;
+export type GatewayAgentEffectiveConfigResponse = {
+    config: EffectiveAgentConfig;
+    sources: Record<string, 'system' | 'global' | 'agent'>;
+};
 /** 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): {
@@ -60,22 +38,12 @@ 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 declare function getGatewayAgentEffectiveConfig(cfg: Config, agentIdRaw: string): AgentAdminResult<GatewayAgentEffectiveConfigResponse>;
 export type CreateAgentBody = {
-    /** Optional id seed; normalized agent id defaults from `profileFiles["IDENTITY.md"]` name when omitted. */
+    /** Optional id seed; normalized agent id defaults from the profile name when omitted. */
     id?: string;
-    workspace: string;
-    models?: AgentModelsConfig;
-    /** Reusable capability plans applied after the global baseline. */
-    extends?: string[];
-    /** Initial `agents.list[].skills` for the new entry. */
-    skills?: string[];
-    /** Initial `agents.list[].tools` for the new entry. */
-    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. */
-    cloneFrom?: string;
+    workspace?: string;
+    profile: NonNullable<Config['agents']['list'][number]['profile']>;
 };
 export type AgentAdminHttpStatus = 400 | 404 | 409;
 export type AgentAdminResult<T> = {
@@ -91,26 +59,16 @@ export declare function prepareCreateAgent(cfg: Config, body: CreateAgentBody):
     agentId: string;
     workspace: string;
 }>;
-export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string, opts?: {
-    profileFiles?: Record<string, string>;
-    cloneFrom?: string;
-}): Promise<AgentAdminResult<void>>;
+export declare function finalizeCreateAgentDirs(cfg: Config, agentId: string): Promise<AgentAdminResult<void>>;
 export type UpdateAgentBody = {
-    workspace?: string;
-    extends?: string[];
-    models?: {
-        defaultRole?: string | null;
-        roles?: Record<string, {
-            model: string;
-            fallbacks?: string[];
-            description?: string;
-        }>;
-    } | null;
+    workspace?: string | null;
+    profile?: Config['agents']['list'][number]['profile'] | null;
+    models?: AgentModelsOverride | null;
     setDefault?: boolean;
-    /** Replace `agents.list[].skills`; `null` resets to all skills. */
-    skills?: string[] | null;
-    /** Replace `agents.list[].tools`; `null` resets to no explicit policies. */
+    skills?: SkillOverride | null;
     tools?: NonNullable<Config['agents']['list']>[number]['tools'] | null;
+    workflows?: NonNullable<Config['agents']['list']>[number]['workflows'] | null;
+    runtime?: NonNullable<Config['agents']['list']>[number]['runtime'] | null;
 };
 export declare function prepareUpdateAgent(cfg: Config, agentIdRaw: string, body: UpdateAgentBody): AgentAdminResult<{
     nextConfig: Config;

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

@@ -1,15 +1,13 @@
 import { init_agent_scope, listAgentEntries, normalizeAgentId, resolveAgentDir, resolveAgentProfileDir, resolveAgentWorkspaceDir, resolveDefaultAgentId, resolveUserPath, validateAgentIdForNewAgent } from "../agent/agent-scope.js";
-import { resolveCapabilityPresetLayer, resolveEffectiveAgentManifest } from "../agent-manifest/resolver.js";
 import { resolveEffectiveAgentProfile } from "../config/agent-profile.js";
 import { WORKSPACE_FILES, init_paths } 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 { seedAgentProfileMarkdownFiles } from "../agent/context/workspace-seed.js";
 import { applyAgentConfig, findAgentEntryIndex, getAgentDeleteBlocker, 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 { join, resolve } from "node:path";
-import { cp, mkdir, readFile, readdir, realpath, stat, unlink, writeFile } from "node:fs/promises";
+import { mkdir, readFile, realpath, stat, unlink, writeFile } from "node:fs/promises";
 //#region src/gateway/agents-admin.ts
 /**
 * Gateway REST helpers for multi-agent management.
@@ -26,12 +24,6 @@ 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;
@@ -58,58 +50,23 @@ async function listGatewayAgents(cfg, _options = {}) {
 	for (const id of collectAgentIdsForList(cfg)) {
 		const profile = resolveEffectiveAgentProfile(cfg, id);
 		const entry = listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === id);
-		const presetLayer = resolveCapabilityPresetLayer({
-			presetIds: entry?.extends,
-			presets: cfg.agents.capabilityPresets,
-			defaultPresetId: cfg.agents.defaultPreset
-		});
-		const presetSkills = presetLayer.patch.skills?.mode === "allowlist" ? presetLayer.patch.skills.allow ?? [] : void 0;
-		const presetDenied = Object.entries(presetLayer.patch.tools?.builtin ?? {}).filter(([, policy]) => policy.mode === "deny").map(([name]) => name);
-		const presetTypedModels = rolesToTypedModels(presetLayer.patch.models?.roles);
-		const model = profile.primaryModelRef || profile.fallbacks.length > 0 ? {
-			...profile.primaryModelRef ? { primary: profile.primaryModelRef } : {},
-			...profile.fallbacks.length > 0 ? { fallbacks: profile.fallbacks } : {}
-		} : void 0;
-		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));
+		if (!entry) continue;
 		let identity = {};
 		try {
 			identity = parseIdentityMarkdown(await readFile(join(resolveAgentProfileDir(cfg, id), WORKSPACE_FILES.IDENTITY), "utf-8"));
 		} catch {}
 		agents.push({
 			id,
-			...identity.name ? { name: identity.name } : {},
+			name: entry.profile?.name ?? identity.name ?? id,
 			...identity.description ? { description: identity.description } : {},
 			...identity.language ? { language: identity.language } : {},
-			...profile.manifest.identity.role ? { role: profile.manifest.identity.role } : {},
-			responsibilities: {
-				primary: [...profile.manifest.responsibilities.primary],
-				...profile.manifest.responsibilities.secondary ? { secondary: [...profile.manifest.responsibilities.secondary] } : {}
-			},
 			...identity.avatar ? { avatar: identity.avatar } : {},
 			workspace: profile.resolvedWorkspacePath,
 			profileDir: resolveAgentProfileDir(cfg, id),
-			...model ? { model } : {},
-			typedModels: {
-				defaultRole: profile.manifest.models.defaultRole,
-				preset: [...presetTypedModels],
-				...entryTypedModels.length > 0 ? { entry: entryTypedModels } : {},
-				effective: effectiveTypedModels
-			},
-			extends: [...entry?.extends ?? []],
-			isDefault: id === defaultId,
-			skills: {
-				preset: presetSkills ? [...presetSkills] : [],
-				...entrySkills !== void 0 ? { entry: [...entrySkills] } : {},
-				...profile.skillsAllowlist !== void 0 ? { effectiveAllowlist: [...profile.skillsAllowlist] } : {}
-			},
-			tools: {
-				presetDenied: [...presetDenied],
-				entryDisable: [...entryDisable],
-				effectiveDisable: [...profile.tools.denied].sort((a, b) => a.localeCompare(b))
-			}
+			override: structuredClone(entry),
+			effective: structuredClone(profile.config),
+			sources: { ...profile.sources },
+			isDefault: id === defaultId
 		});
 	}
 	agents.sort((a, b) => a.id.localeCompare(b.id));
@@ -119,10 +76,9 @@ async function listGatewayAgents(cfg, _options = {}) {
 		builtinToolIds: [...GATEWAY_BUILTIN_TOOL_IDS]
 	};
 }
-function getGatewayAgentEffectiveManifest(cfg, agentIdRaw) {
+function getGatewayAgentEffectiveConfig(cfg, agentIdRaw) {
 	const agentId = normalizeAgentId(agentIdRaw);
-	const entry = listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === agentId);
-	if (!entry) return {
+	if (!listAgentEntries(cfg).find((e) => normalizeAgentId(e.id) === agentId)) return {
 		ok: false,
 		error: `agent "${agentId}" not found`,
 		status: 404
@@ -130,11 +86,13 @@ function getGatewayAgentEffectiveManifest(cfg, agentIdRaw) {
 	try {
 		return {
 			ok: true,
-			data: resolveEffectiveAgentManifest({
-				agent: entry,
-				presets: cfg.agents.capabilityPresets,
-				defaultPresetId: cfg.agents.defaultPreset
-			})
+			data: (() => {
+				const profile = resolveEffectiveAgentProfile(cfg, agentId);
+				return {
+					config: profile.config,
+					sources: profile.sources
+				};
+			})()
 		};
 	} catch (err) {
 		return {
@@ -145,35 +103,7 @@ function getGatewayAgentEffectiveManifest(cfg, agentIdRaw) {
 	}
 }
 function prepareCreateAgent(cfg, body) {
-	const workspace = body.workspace?.trim() ?? "";
-	if (!workspace) return {
-		ok: false,
-		error: "workspace is required",
-		status: 400
-	};
-	if (body.profileFiles !== void 0) {
-		if (typeof body.profileFiles !== "object" || body.profileFiles === null || Array.isArray(body.profileFiles)) return {
-			ok: false,
-			error: "profileFiles must be an object",
-			status: 400
-		};
-		for (const [name, content] of Object.entries(body.profileFiles)) {
-			const bad = assertAllowedFile(name);
-			if (bad) return bad;
-			if (typeof content !== "string") return {
-				ok: false,
-				error: `profileFiles["${name}"] must be a string`,
-				status: 400
-			};
-		}
-	}
-	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);
+	const idRes = validateAgentIdForNewAgent(body.id, body.profile.name);
 	if (idRes.ok === false) return {
 		ok: false,
 		error: idRes.error,
@@ -185,50 +115,21 @@ function prepareCreateAgent(cfg, body) {
 		error: `agent "${agentId}" already exists`,
 		status: 409
 	};
-	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 rawModels = body.models ?? cloneSourceEntry?.models;
-	const inheritedPresetIds = body.extends ?? cloneSourceEntry?.extends ?? [];
-	for (const presetId of inheritedPresetIds) if (!cfg.agents.capabilityPresets[presetId]) return {
-		ok: false,
-		error: `capability preset "${presetId}" not found`,
-		status: 400
-	};
-	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
-	};
+	const wsAbs = resolveUserPath(body.workspace?.trim() || `~/.xopc/workspace/${agentId}`);
 	return {
 		ok: true,
 		data: {
 			nextConfig: applyAgentConfig(cfg, {
 				agentId,
-				workspace: wsAbs,
-				extends: [...inheritedPresetIds],
-				...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 } : {}
+				...body.workspace?.trim() ? { workspace: wsAbs } : {},
+				profile: structuredClone(body.profile)
 			}),
 			agentId,
 			workspace: wsAbs
 		}
 	};
 }
-async function finalizeCreateAgentDirs(cfg, agentId, opts) {
+async function finalizeCreateAgentDirs(cfg, agentId) {
 	const wsPath = resolveAgentWorkspaceDir(cfg, agentId);
 	const profilePath = resolveAgentProfileDir(cfg, agentId);
 	const adPath = resolveAgentDir(cfg, agentId);
@@ -236,29 +137,7 @@ async function finalizeCreateAgentDirs(cfg, agentId, opts) {
 	await mkdir(profilePath, { recursive: true });
 	await mkdir(adPath, { recursive: true });
 	const id = normalizeAgentId(agentId);
-	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 {
-			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);
-		if (written.ok === false) return written;
-	}
+	seedAgentProfileMarkdownFiles(profilePath, wsPath, { displayName: listAgentEntries(cfg).find((candidate) => normalizeAgentId(candidate.id) === id)?.profile?.name ?? id });
 	return {
 		ok: true,
 		data: void 0
@@ -266,23 +145,8 @@ async function finalizeCreateAgentDirs(cfg, agentId, opts) {
 }
 function prepareUpdateAgent(cfg, agentIdRaw, body) {
 	const agentId = normalizeAgentId(agentIdRaw);
-	let list = [...listAgentEntries(cfg)];
-	let idx = findAgentEntryIndex(list, agentId);
-	if (idx < 0 && agentId === resolveDefaultAgentId(cfg)) {
-		list = [...list, {
-			id: agentId,
-			enabled: true,
-			identity: {
-				name: agentId,
-				role: "Agent",
-				language: "en",
-				tone: "direct"
-			},
-			responsibilities: { primary: ["Help the user complete tasks"] },
-			workspace: { root: `~/.xopc/workspace/${agentId}` }
-		}];
-		idx = list.length - 1;
-	}
+	const list = [...listAgentEntries(cfg)];
+	const idx = findAgentEntryIndex(list, agentId);
 	if (idx < 0) return {
 		ok: false,
 		error: `agent "${agentId}" not found`,
@@ -290,78 +154,22 @@ function prepareUpdateAgent(cfg, agentIdRaw, body) {
 	};
 	const entry = { ...list[idx] };
 	if (body.workspace !== void 0) {
-		const w = body.workspace.trim();
-		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;
+		const workspace = body.workspace?.trim();
+		if (workspace) entry.workspace = resolveUserPath(workspace);
+		else delete entry.workspace;
 	}
+	if (body.profile !== void 0) if (body.profile === null) delete entry.profile;
+	else entry.profile = structuredClone(body.profile);
 	if (body.models !== void 0) if (body.models === null) delete entry.models;
-	else {
-		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 !== void 0) {
-				const roles = Object.fromEntries(Object.entries(body.models.roles).map(([id, row]) => ({
-					id: id.trim(),
-					model: row.model.trim(),
-					fallbacks: (row.fallbacks ?? []).map((ref) => ref.trim()).filter(Boolean),
-					description: row.description?.trim()
-				})).filter((row) => row.id && row.model).map((row) => [row.id, {
-					model: row.model,
-					...row.fallbacks.length > 0 ? { fallbacks: row.fallbacks } : {},
-					...row.description ? { description: row.description } : {}
-				}]));
-				entry.models = {
-					defaultRole: entry.models?.defaultRole ?? Object.keys(roles)[0] ?? "deep",
-					roles,
-					...entry.models?.policy ? { policy: entry.models.policy } : {}
-				};
-			}
-		}
-		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
-		};
-	}
+	else entry.models = structuredClone(body.models);
 	if (body.skills !== void 0) if (body.skills === null) delete entry.skills;
-	else {
-		const next = body.skills.map((s) => String(s).trim()).filter(Boolean);
-		if (next.length === 0) entry.skills = {
-			mode: "allowlist",
-			allow: []
-		};
-		else entry.skills = {
-			mode: "allowlist",
-			allow: next
-		};
-	}
+	else entry.skills = structuredClone(body.skills);
 	if (body.tools !== void 0) if (body.tools === null) delete entry.tools;
 	else entry.tools = body.tools;
+	if (body.workflows !== void 0) if (body.workflows === null) delete entry.workflows;
+	else entry.workflows = structuredClone(body.workflows);
+	if (body.runtime !== void 0) if (body.runtime === null) delete entry.runtime;
+	else entry.runtime = structuredClone(body.runtime);
 	list[idx] = entry;
 	let next = {
 		...cfg,
@@ -672,4 +480,4 @@ async function deleteAgentAvatarFile(cfg, agentId) {
 	};
 }
 //#endregion
-export { deleteAgentAvatarFile, extractAvatarFromIdentityMarkdown, finalizeCreateAgentDirs, getGatewayAgentEffectiveManifest, listAgentProfileFiles, listGatewayAgents, parseIdentityMarkdown, prepareCreateAgent, prepareDeleteAgent, prepareUpdateAgent, readAgentAvatarFile, readAgentProfileFile, runAfterDeletePurge, writeAgentAvatarFromBase64, writeAgentProfileFile };
+export { deleteAgentAvatarFile, extractAvatarFromIdentityMarkdown, finalizeCreateAgentDirs, getGatewayAgentEffectiveConfig, listAgentProfileFiles, listGatewayAgents, parseIdentityMarkdown, prepareCreateAgent, prepareDeleteAgent, prepareUpdateAgent, readAgentAvatarFile, readAgentProfileFile, runAfterDeletePurge, writeAgentAvatarFromBase64, writeAgentProfileFile };

package/dist/src/gateway/chat-stream/turn-outcome-collector.js

@@ -1,4 +1,6 @@
-import { TurnOutcomeDeliverableSchema } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { TurnOutcomeDeliverableSchema, fileResourceArtifactUri, turnOutcomeKindFromFileName, turnOutcomeMimeTypeFromFileName } from "../../../packages/gateway-contract/src/turn-outcome.js";
+import { parseProductDeliveryEnvelope } from "../../../packages/gateway-contract/src/product-delivery.js";
+import { parseFileResourceId } from "../../files/file-service.js";
 //#region src/gateway/chat-stream/turn-outcome-collector.ts
 const VERIFICATION_COMMAND = /(^|[\s:/_-])(test|vitest|jest|pytest|lint|typecheck|type-check|build)([\s:/_-]|$)/i;
 const MAX_OUTCOME_DIFF_CHARS = 2e5;
@@ -27,13 +29,46 @@ function changedFiles(changes) {
 		}];
 	});
 }
-function structuredDeliverables(details) {
+function explicitArtifacts(details) {
 	if (!Array.isArray(details.artifacts)) return [];
 	return details.artifacts.flatMap((value) => {
 		const parsed = TurnOutcomeDeliverableSchema.safeParse(value);
 		return parsed.success ? [parsed.data] : [];
 	});
 }
+function fileReferenceDeliverable(reference, operation, environment) {
+	if (reference.kind !== "file") return null;
+	let workspaceRelativePath;
+	try {
+		workspaceRelativePath = parseFileResourceId(reference.id).relativePath;
+	} catch {}
+	const mimeType = turnOutcomeMimeTypeFromFileName(reference.title);
+	const available = operation !== "failed";
+	const capabilities = available ? [
+		...reference.capabilities.includes("preview") ? ["preview"] : [],
+		"download",
+		...reference.capabilities.includes("share") ? ["share"] : []
+	] : ["regenerate"];
+	return {
+		artifactId: reference.id,
+		title: reference.title,
+		kind: turnOutcomeKindFromFileName(reference.title),
+		...mimeType ? { mimeType } : {},
+		availability: available ? "available" : "failed",
+		location: environment,
+		capabilities,
+		...available && environment === "workspace" ? { uri: fileResourceArtifactUri(reference.id) } : {},
+		...workspaceRelativePath ? { workspaceRelativePath } : {}
+	};
+}
+function productDeliveryArtifacts(delivery, environment) {
+	if (!delivery) return [];
+	return [delivery.primary, ...delivery.related ?? []].flatMap((reference) => {
+		if (!reference) return [];
+		const artifact = fileReferenceDeliverable(reference, delivery.operation, environment);
+		return artifact ? [artifact] : [];
+	});
+}
 var TurnOutcomeCollector = class {
 	deliverables = /* @__PURE__ */ new Map();
 	evidence = /* @__PURE__ */ new Map();
@@ -52,9 +87,9 @@ var TurnOutcomeCollector = class {
 				this.failedToolCount += 1;
 				return;
 			}
-			const details = asRecord(event.payload.result?.details);
-			if (!details) return;
-			for (const artifact of structuredDeliverables(details)) this.deliverables.set(artifact.artifactId, artifact);
+			const details = asRecord(event.payload.result?.details) ?? {};
+			const artifacts = [...explicitArtifacts(details), ...productDeliveryArtifacts(parseProductDeliveryEnvelope(details.delivery), this.environment)];
+			for (const artifact of artifacts) this.deliverables.set(artifact.artifactId, artifact);
 			return;
 		}
 		if (event.type === "patch_applied") {
@@ -82,7 +117,7 @@ var TurnOutcomeCollector = class {
 	}
 	finalize(status, summary) {
 		const evidence = [...this.evidence.values()];
-		const partial = this.failedToolCount > 0 || evidence.some((item) => item.status === "failed");
+		const partial = this.failedToolCount > 0 || evidence.some((item) => item.status === "failed") || [...this.deliverables.values()].some((item) => item.availability === "failed");
 		const fullDiff = this.diffs.join("\n");
 		const diffTruncated = fullDiff.length > MAX_OUTCOME_DIFF_CHARS;
 		return {

package/dist/src/gateway/device-routes.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '../config/schema.js';
+import type { DeviceRoute } from '../storage/sqlite/device-pairing-repository.js';
+export declare function resolveSecureDeviceRoutes(config: Config): DeviceRoute[];

package/dist/src/gateway/device-routes.js

@@ -0,0 +1,47 @@
+import { resolveReverseProxyPublicUrl } from "./public-url.js";
+import { getTailscaleExposureState } from "./tailscale-lifecycle.js";
+import { getTunnelService } from "../tunnel/tunnel-service.js";
+import crypto from "node:crypto";
+//#region src/gateway/device-routes.ts
+function secureUrl(value) {
+	if (!value) return null;
+	try {
+		const parsed = new URL(value);
+		if (parsed.protocol !== "https:" || parsed.username || parsed.password) return null;
+		return parsed.origin;
+	} catch {
+		return null;
+	}
+}
+function routeId(kind, url) {
+	return `${kind}-${crypto.createHash("sha256").update(url).digest("hex").slice(0, 12)}`;
+}
+function resolveSecureDeviceRoutes(config) {
+	const tunnelStatus = getTunnelService().getStatus();
+	const candidates = [{
+		kind: "custom-https",
+		url: secureUrl(resolveReverseProxyPublicUrl(config))
+	}, {
+		kind: "xopc-secure-link",
+		url: tunnelStatus.state === "connected" ? secureUrl(tunnelStatus.publicUrl) : null
+	}];
+	const tailscale = getTailscaleExposureState();
+	if (tailscale.active && tailscale.hostname) candidates.push({
+		kind: "tailscale",
+		url: secureUrl(`https://${tailscale.hostname}`)
+	});
+	const seen = /* @__PURE__ */ new Set();
+	const routes = [];
+	for (const candidate of candidates) {
+		if (!candidate.url || seen.has(candidate.url)) continue;
+		seen.add(candidate.url);
+		routes.push({
+			id: routeId(candidate.kind, candidate.url),
+			kind: candidate.kind,
+			url: candidate.url
+		});
+	}
+	return routes;
+}
+//#endregion
+export { resolveSecureDeviceRoutes };

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

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